Skip to content

SpecConfig

Defined in: packages/speculator/src/preprocess/types.ts:212

Normalized spec configuration

Internal representation derived from ReSpec-like config files. All optional fields have sensible defaults applied.

optional abstract: string

Defined in: packages/speculator/src/preprocess/types.ts:271

Abstract text (if not in document body)


optional authors: PersonEntry[]

Defined in: packages/speculator/src/preprocess/types.ts:268

Author list


optional baseUrl: string

Defined in: packages/speculator/src/preprocess/types.ts:250

Base URL for assembling thisVersion (e.g., https://example.org/specs/)


optional copyright: string

Defined in: packages/speculator/src/preprocess/types.ts:274

Copyright notice


optional creationDate: string

Defined in: packages/speculator/src/preprocess/types.ts:238

Original creation date (ISO 8601: YYYY-MM-DD)


optional custom: Record<string, unknown>

Defined in: packages/speculator/src/preprocess/types.ts:306

Custom user-defined properties. Highest priority - overwrites both root and respec values.


deps: string[]

Defined in: packages/speculator/src/preprocess/types.ts:217

Dependencies (empty array if none)


optional editors: PersonEntry[]

Defined in: packages/speculator/src/preprocess/types.ts:265

Editor list


optional group: string | GroupConfig

Defined in: packages/speculator/src/preprocess/types.ts:262

Group/organization information


id: string

Defined in: packages/speculator/src/preprocess/types.ts:214

Document ID (from config.json or auto-generated)


optional jsonLd: object

Defined in: packages/speculator/src/preprocess/types.ts:309

JSON-LD metadata configuration

optional contexts: Record<string, string>

Standard contexts to include

optional vocab: string

Base IRI for the specification vocabulary (default: https://speculator.openuji.org/vocab#)


optional lastUpdateDate: string

Defined in: packages/speculator/src/preprocess/types.ts:241

Last update date (ISO 8601: YYYY-MM-DD)


optional latestVersion: string

Defined in: packages/speculator/src/preprocess/types.ts:253

Latest version URL


optional license: string

Defined in: packages/speculator/src/preprocess/types.ts:277

License URL or identifier


optional localBiblio: Record<string, { authors?: string[]; date?: string; publisher?: string; raw?: string; status?: string; title: string; url?: string; }>

Defined in: packages/speculator/src/preprocess/types.ts:292

Local bibliography entries for citation resolution


optional logos: object[]

Defined in: packages/speculator/src/preprocess/types.ts:280

Header logo configuration

optional alt: string

optional href: string

src: string


optional maturityLevel: MaturityLevel

Defined in: packages/speculator/src/preprocess/types.ts:232

Maturity level (priority: root maturityLevel > respec.specStatus)


optional maxTocLevel: number

Defined in: packages/speculator/src/preprocess/types.ts:286

Maximum ToC depth


optional previousVersion: string

Defined in: packages/speculator/src/preprocess/types.ts:256

Previous version URL


optional publishDate: string

Defined in: packages/speculator/src/preprocess/types.ts:235

Publication date (ISO 8601: YYYY-MM-DD)


optional repository: string | RepositoryConfig

Defined in: packages/speculator/src/preprocess/types.ts:259

Repository information


optional shortName: string

Defined in: packages/speculator/src/preprocess/types.ts:223

Short name for URLs/references (e.g., “html”, “css-grid”)


specIri: string

Defined in: packages/speculator/src/preprocess/types.ts:247

This version URL


optional specProfile: string

Defined in: packages/speculator/src/preprocess/types.ts:289

Custom specification profile/variant


optional status: string

Defined in: packages/speculator/src/preprocess/types.ts:229

Spec status (e.g., “ED”, “WD”, “CR”, “REC”, “NOTE”) - fallback if maturityLevel not set


optional subtitle: string

Defined in: packages/speculator/src/preprocess/types.ts:226

Subtitle or tagline


optional title: string

Defined in: packages/speculator/src/preprocess/types.ts:220

Document title


optional tocEnabled: boolean

Defined in: packages/speculator/src/preprocess/types.ts:283

Enable table of contents generation


optional version: string

Defined in: packages/speculator/src/preprocess/types.ts:244

Version string (e.g., “1.0.0”)


optional xref: string | string[] | Record<string, string>

Defined in: packages/speculator/src/preprocess/types.ts:317

External reference configuration