@stesura/core/types

Stable across checks and edits elsewhere: a hash of the rule, the node’s id (its textblock’s, for a link) and the excerpt. What Ignore stores.

Position of the offending node — the panel selects it on click.

End of the offending content: the node’s end for a block or atom, the run’s end for a link. Carried because a link run can span several text nodes and only the checker knows where it stops.

Node type at pos when the finding was made. Findings are snapshots, so check pos still holds this type before acting on one later.

Short context for the panel row (link text, heading text, …).

The agent’s author id: “accept all” filters on it.

The tool call that made it: the chat chip resolves its own call’s suggestions.

The user the agent worked for, when the comments backend knows them.

The reply, for reply.

Theme sidecar of color (docs/executed/document-theme-plan.md).

Serialize this cell as th scope="col". DERIVED from the table’s headerRowCount by tableHeaderCellsPlugin — never set it directly; the plugin will overwrite it on the next transaction (A11Y-21).

Space between the cell’s edges and its content, in px; null is Word’s default (0 above and below, 7.2px a side).

Undefined when nothing paints the cell; “transparent” for an explicit none.

The sides the style and the table draw, each edge shared with the cell across it.

Syntax-highlighting language. Named apart from the proofingLanguage global attribute because runtime behaviour is gated on attr presence.

Set when an AI agent wrote the comment: the signed-in user it worked for. Kept after the user accepts it, so the card can say whose agent wrote it and an audit knows who asked.

Editor id stamped on clipboard copies (transformCopied) so paste can strip anchors from another document. Always null in the doc — paste clears it.

Editor id stamped on clipboard copies (transformCopied) so paste can strip anchors from another document. Always null in the doc — paste clears it.

Whether a bulk command (Ctrl+A formatting, an attribute change over many blocks) lands in edit mode as one batch step instead of chunks of ordinary steps: much faster on long documents and one step in collab, but a step class ProseMirror plugins don’t know. A host plugin that tests step classes must read steps through standardStepsOf; set false to keep bulk commands on ordinary steps. Default true.

Resolves user ids to names and avatars (comment authors, mentions).

Shows a toast. Must render into an ARIA live region (role="status", or role="alert" for errors): some actions, like a refused nested table or a rejected upload, report their outcome ONLY here. When omitted, the mount warns once and messages go to console.warn.

Render toast.description, or switch on toast.key for your own copy.

Receives every EditorDiagnostic the mount raises: pagination failures, doc-integrity repairs, dropped transactions, node-view crashes and cross-references losing (or regaining) their target. One place to wire telemetry or host reactions; the specific channels (addPaginationFailureHandler, addDocIntegrityHandler) still fire.

Diagnostics raised inside a sub-editor reach the root mount’s callback. A throwing callback is caught and logged.

Hosts (host[:port]) whose PDFs the file node may PREVIEW with @stesura/pdf-viewer-react. Undefined means no previews at all — every PDF is a card (SEC-70) — because the viewer’s browser fetches the file, so the integrator must name hosts trusted to serve only PDFs.

Non-http(s) schemes, loopback, private/link-local ranges and .local/.internal hosts are always refused, so a hostile document cannot make the viewer’s browser fetch their intranet.

Pagination and the PDF export use the same decision, so a print mount MUST get the same list as the editor.

Marks the PDF export’s print mount. Read via isPrintMount , so screen-only chrome (handles, floating menus, table outlines) can skip rendering instead of being hidden by CSS.

Config-time, not a store: a flag flipping mid-export would paginate one way and capture another.

Features whose browser support or spec may still change.

columnSections: lays out sections with columns in columns (Chromium 145+, column-wrap) and shows the column UI (page setup, span columns, column break). Off by default: the attrs, commands’ data and DOCX round-trip are kept, and the section renders in one column. A print mount MUST get the same value as the editor, or the export paginates differently.

skipReactSelectionSave (on unless false): the editor root reports contentEditable as "inherit" to scripts, so react-dom skips its root-to-caret text walk before every commit (~20% of a keystroke on a 350-page doc). The attribute, isContentEditable and editing are unaffected. Not yet checked by hand with an IME (dead keys, composition) or spellcheck underlines; turn it off first if either misbehaves. Mount-time.

stableContexts (on unless false): react-prosemirror keeps its state and doc contexts stable across synchronous dispatches, so a keystroke no longer makes React scan every memoised node view (~30% of a keystroke on a 350-page doc). Main editor only; sub-editors are small. Mount-time.

"page" (default) renders sections as pages. "flow" renders the doc as one full-width block flow sized by its container: no page chrome, and sections, page breaks and column breaks are hidden and can’t be created locally (they stay in the doc). Read via isFlowLayout .

Mount-time only: switching on a live editor is not supported. Never a doc property, so a flow and a page mount can collaborate on one doc.

Placeholders (fill-in prompts): the content a new one gets, and the marks text typed, pasted or filled over one takes. Config-time. A sub-editor answers for the mount that owns it.

See ConfigPluginProps["toastText"].

The owning editor; set only on sub-editors (footnote, header…). Store lookups fall through to it.

The number index 0 renders as, sticky across the level’s increments. Absent: the rendered list’s level start. A list and its forks share one stack (listBases), so an item numbers from the list that opened it.

The list of the block that last counted at this level: deeper levels reset to its starts.

A level opened without being counted (1. → 1.1.1 opens level 2).

Word’s quirk: a filler a fork’s first block skips over displays its reset value but counts on from the fork’s start override.

The reference’s own id, minted like a block’s: its key in the references store.

Applied to the text the reference shows; null leaves it as computed.

A text reference’s content: the bookmark’s text, which may be part of its block (an import), so it isn’t rebuilt from the target.

A page reference’s cached page (Word’s cached PAGEREF result), shown where nothing lays out pages.

The label a derived reference showed when its target went missing, so a reload still shows it. Null while the target exists.

Canvas color behind the pages. Named apart from blockStyling’s bgColor attr.

The colour theme every *Theme sidecar resolves against (Word’s theme1.xml colour scheme).

Lists numbered on another list’s counters, keyed by their listConfigs key.

Per list instance, what it overrides over its level config (Word’s w:lvlOverride).

Default proofing language (BCP 47): the bottom of paragraph.proofingLanguage ?? style.language ?? doc.language, and the only level that always answers.

Default text direction: the bottom of paragraph.dir ?? section.dir ?? doc.dir, so a host can mount RTL-by-default without stamping every node.

Whether text-measured page borders enclose the header / footer. Document level, like Word’s w:bordersDoNotSurroundHeader/Footer settings.

Variables a template declares for its field nodes. Empty for ordinary documents; only template tooling reads it.

The sources the document cites from, and how it formats them.

Title, author, custom properties…: kept for the DOCX round trip (DOCPROPERTY fields).

Format-cleanup suggestion ids the user dismissed (@stesura/format-lint), kept with the document so collaborators and later sessions agree.

Contract-check review state (@stesura/contract-check): finding id to ignored or flagged; open findings are absent. Shared by collaborators, last write wins.

Findings dismissed per checker (e.g. accessibility): checker name to finding ids. Kept with the document so collaborators and later sessions agree; not written to DOCX.

Caption settings (custom labels), shared by collaborators; not written to DOCX (Word ignores w:captions).

What was found and done, as a plain string.

The doc before the repair (or the rejected edit).

A rejected edit’s steps, as JSON.

The a:clrScheme name, which Word’s Design › Colors gallery shows.

#RRGGBB per slot.

settings.xml w:clrSchemeMapping: which slot the text/background names read.

Anchor id of the TOC item the viewport has scrolled to (highlight state). Kept out of toc so scroll tracking never churns the items array.

TOC nodeId → page breaks cutting through it. Written by the pagination engine after each recompute; the TOC nodeview renders row spacers from it.

The citation registry, written by @stesura/bibliography’s plugin.

Block nodeId → DISPLAYED page label (“iv”, “12”), honouring each section’s pageNumbering, so it matches the footers. Written by pagination after each recompute; undefined until then, or when it’s off. Read by the TOC.

Block nodeId → 0-based DOCUMENT page index its first line is laid on, continuous across sections. Written with nodePageNumbers; undefined until then, or when pagination is off. Read by the positioned object cycle.

sectionId → page count, iterated in DOCUMENT order, so a prefix sum is a section’s page offset and the full sum the document total (totalPages, the stats dialog). Written by pagination after each recompute; undefined until then, or when it’s off.

sectionId → pageNumbering, for sections that set one. Published by pagination next to pageCounts, so headers/footers resolve page numbers without subscribing to the document.

0-based physical column (counted from the left) of the caret in a column section; null anywhere else. Written by pagination after each view update (it reads the layout), read by the ruler to draw that column’s edges.

Whether the first pagination pass has produced a layout. null: nobody claims it (unpaginated, or pagination not loaded) and the canvas renders immediately. false: first pass outstanding — the canvas holds, so the unpaginated draft never flashes. true: every section has a layout, or the hold timed out.

Measured width (px) of the content box in a layout: "flow" mount, written by editor-react’s ResizeObserver; undefined until the first measurement and in page layout. Read through getContentWidth.

The RAW doc.attrs.styleSheet, published by the stylesheet plugin. Sub-editor docs store no style definitions, so they read them here via the registry’s parent fall-through — same as listConfigs .

List configs (defaults + doc.attrs.listConfigs), published by the numbering plugin. Definitions are doc-global while counters are per story, so sub-editors read them here via the registry’s parent fall-through.

The root doc’s listBases, published beside listConfigs .

The root doc’s listOverrides, published beside listConfigs .

The root editor’s current doc, published by the numbering plugin’s view. Lets sub-editors answer cross-region questions, e.g. counting a listRef’s instances before deciding whether a config edit must fork (CORE-31).

True when the list came from the paragraph’s style rather than its attrs.

This occurrence’s own id (DS-9); repeated anchors of one note share endnoteRef.

Absolute URL of the file.

Preview height in CSS px, UNPAGINATED only (the resize handle writes it). Under pagination the box is the section’s page height and this is ignored.

Original filename, as uploaded. Null on documents that predate it.

Content type sniffed at upload (never the browser’s file.type). Null on documents that predate it, which could only ever hold PDFs.

Byte size at upload, for the card.

Whole-file rotation, degrees clockwise. ADDED to each page’s own rotation (effectiveRotation) by both preview and export.

Whether a PDF renders as a PREVIEW (its pages) or as a card. Default true: mounting the viewer package is the migration trigger, and what you see is what you export — a card prints as a card with its link.

null: the wrap mode’s default gap.

Stacking order among positioned objects (Word’s relativeHeight); null when unset.

Unique id (the uniqueId plugin fills it: inline nodes declare it themselves).

px, border box.

Word sized it to its content (a frame without w:w): width stands in at the column width and the DOCX export leaves it out. Setting the width clears it.

px; null grows with the content.

Background color; null for none.

Accessible name; null falls back to the UI’s “Text box”.

null: the wrap mode’s default gap.

Stacking order among positioned objects (Word’s relativeHeight); null when unset.

Unique id (the uniqueId plugin fills it: inline nodes declare it themselves).

px, border box.

Word sized it to its content (a frame without w:w): width stands in at the column width and the DOCX export leaves it out. Setting the width clears it.

px; null grows with the content.

Background color; null for none.

Accessible name; null falls back to the UI’s “Text box”.

This occurrence’s own id (DS-9); repeated anchors of one note share footnoteRef.

Anchor id of the TOC item the viewport has scrolled to (highlight state). Kept out of toc so scroll tracking never churns the items array.

TOC nodeId → page breaks cutting through it. Written by the pagination engine after each recompute; the TOC nodeview renders row spacers from it.

The citation registry, written by @stesura/bibliography’s plugin.

Block nodeId → DISPLAYED page label (“iv”, “12”), honouring each section’s pageNumbering, so it matches the footers. Written by pagination after each recompute; undefined until then, or when it’s off. Read by the TOC.

Block nodeId → 0-based DOCUMENT page index its first line is laid on, continuous across sections. Written with nodePageNumbers; undefined until then, or when pagination is off. Read by the positioned object cycle.

sectionId → page count, iterated in DOCUMENT order, so a prefix sum is a section’s page offset and the full sum the document total (totalPages, the stats dialog). Written by pagination after each recompute; undefined until then, or when it’s off.

sectionId → pageNumbering, for sections that set one. Published by pagination next to pageCounts, so headers/footers resolve page numbers without subscribing to the document.

0-based physical column (counted from the left) of the caret in a column section; null anywhere else. Written by pagination after each view update (it reads the layout), read by the ruler to draw that column’s edges.

Whether the first pagination pass has produced a layout. null: nobody claims it (unpaginated, or pagination not loaded) and the canvas renders immediately. false: first pass outstanding — the canvas holds, so the unpaginated draft never flashes. true: every section has a layout, or the hold timed out.

Measured width (px) of the content box in a layout: "flow" mount, written by editor-react’s ResizeObserver; undefined until the first measurement and in page layout. Read through getContentWidth.

The RAW doc.attrs.styleSheet, published by the stylesheet plugin. Sub-editor docs store no style definitions, so they read them here via the registry’s parent fall-through — same as listConfigs .

List configs (defaults + doc.attrs.listConfigs), published by the numbering plugin. Definitions are doc-global while counters are per story, so sub-editors read them here via the registry’s parent fall-through.

The root doc’s listBases, published beside listConfigs .

The root doc’s listOverrides, published beside listConfigs .

The root editor’s current doc, published by the numbering plugin’s view. Lets sub-editors answer cross-region questions, e.g. counting a listRef’s instances before deciding whether a config edit must fork (CORE-31).

Attrs merged into the node spec’s own attrs.

Extra DOM attributes merged into the node’s own toDOM output. class values are combined, style strings concatenated, the rest spread.

Attr values recovered from the DOM, merged into every parseDOM rule of the node.

Attrs merged into the node spec’s own attrs.

Extra DOM attributes merged into the node’s own toDOM output. class values are combined, style strings concatenated, the rest spread.

Attr values recovered from the DOM, merged into every parseDOM rule of the node.

Theme sidecar of color (docs/executed/document-theme-plan.md).

Per-level indentation in px — Word’s w:lvl/w:pPr/w:ind. The LOWEST tier of the indent cascade (see resolveNumberedIndent); a paragraph’s own indent always beats it.

Only start, by and special are meaningful; end is kept so a round trip cannot drop a value an imported file set.

Minimum counter-cell width in px, measured from where the number STARTS (Word measures from the margin; the DOCX layer translates). Only meaningful when followed by a tab. Local extension — strip before docx.js export.

Grammatical gender for the word-based formats (cardinalText, ordinalText, ordinal) — “Parte Prima” vs “Capitolo Primo”. Defaults to masculine; ignored by digit formats and single-gender languages.

Local extension with no w:lvl equivalent: stripped before docx.js export and lost on a DOCX round trip.

Casing for the word-based formats — “FORTY-TWO” vs “forty-two”. Undefined is the converters’ native output (every word capitalised).

Local extension, like gender: stripped before docx.js export and lost on a DOCX round trip.

Visible opacity, 0–100 (a:alphaModFix).

Unique id (assigned by the uniqueId plugin — inline nodes are opted in explicitly).

null: the wrap mode’s default gap.

Stacking order among positioned objects (Word’s relativeHeight); null when unset.

Visible opacity, 0–100 (a:alphaModFix).

Unique id (assigned by the uniqueId plugin — inline nodes are opted in explicitly).

Visible opacity, 0–100 (a:alphaModFix).

Find all decorations in this set which touch the given range (including decorations that start or end directly at the boundaries) and match the given predicate on their spec. When start and end are omitted, all decorations in the set are considered. When predicate isn’t given, all decorations are assumed to match.

Map the set of decorations in response to a change in the document.

Add the given array of decorations to the ones in the set, producing a new set. Consumes the decorations array. Needs access to the current document to create the appropriate tree structure.

Create a new set that contains the decorations in this set, minus the ones in the given array.

Extract a DecorationSource containing decorations for the given child node at the given offset.

Call the given function for each decoration set in the group.

When false and no upload strategy is installed, dropped/pasted images are refused instead of being embedded as base64 data URIs — docs that sync or persist server-side must not carry inline blobs.

Notified when an image is refused because inline fallbacks are disabled.

The image types users may insert (drop, paste, upload, a watermark), sniffed from the bytes or read off a data: src; absent, all of them. DOCX import keeps what the file holds, and so does a move or copy of a picture already in the document. A remote URL’s type is unknown to the client: check those on the server (or in the upload strategy).

Notified whenever an inserted image is refused, with why.

One widget at the content end of every atom-final block, kept whether or not markers are shown: it is also the caret’s text anchor after an atom, without which Chrome sizes the caret by the line box (PIL-1c). The pilcrow glyph is gated in CSS.

Level-config tabStop in px (see ILevelsOptions.tabStop).

Level-config gender (see ILevelsOptions.gender).

Level-config casing (see ILevelsOptions.casing).

Show only every Nth line’s number (Word’s “Count by”). Every line is still counted.

Gap in px between the gutter and the section’s text edge (OOXML stores twips).

Where the counter resets: never, on every page, or at the section’s first line.

The first line’s number, 1-based (Word’s floor is 1).

Whether the format appears in the level-format picker. Most entries exist only so IMPORTED files render faithfully (⑴, - 5 -, Devanagari digits).

Unitless multiplier (1.5 lines) or an exact “Xpt” height.

The list this paragraph numbers against. INHERIT_LIST_REF means “take the list from the resolved style”; null is the off-sentinel (see NumberingAttrValue).

level / instanceId are USER data:

• on a directly-numbered paragraph they are the canonical storage and the numbering plugin keeps them stamped;
• on a style-numbered paragraph (INHERIT_LIST_REF) they are OVERRIDES and stay absent unless the user explicitly set one (level change at an unbound level, restart). The style cascade fills the gaps — stamping derived values here froze the binding (CORE-37).

What follows the number and whether it’s a bullet are the level’s (and the list’s listOverrides): the numbering store derives them.

Per-instance override of the level config’s tabStop (px, see ILevelsOptions.tabStop).

Word’s keepLines: the paragraph is never split across pages. One taller than a page starts on a fresh page and splits there. Ignored in tables.

Node decorations marking engine-detected oversized nodes with data-oversized-id. The actual clamp (max-height + overflow: hidden) comes from a store-driven stylesheet, NOT from decoration styles — see the pagination plugin’s oversizedClamps module.

Signature of the clamp set the decorations were built from, compared by the poke helper to skip redundant dispatches.

Block fill. null resets (cleared here, not inherited), as with numbering/outlineLevel; absent inherits.

Style-linked numbering. Inherits through basedOn as a whole object (no field merge). null resets to unnumbered; absent inherits.

Unitless multiplier (1.5 lines) or an exact “Xpt” height.

Word’s “At least” height lineHeight was derived from (see the paragraph attr).

Tab stops, as a whole list: a paragraph’s own tabStops replaces the style’s rather than adding to it. Inherits through basedOn; null resets to the default stops.

Heading level (1–9; Word’s w:outlineLvl is 0-based). A style with an outline level IS a heading. Inherits through basedOn; null resets to body text, absent inherits.

Pagination props (Word: keepNext / keepLines / widowControl / pageBreakBefore), in the node attr’s PaginationAttrs shape so both levels resolve the same way. One object because Word edits them together in its Paragraph dialog — the right granularity for OT and track changes.

Whole-object override through basedOn: absent inherits, null resets. Unset fields fall back to widowOrphan true and the rest false (see getStylePaginationProps). Not rendered as CSS.

Text content of the code block.

Start position of the code block.

The node’s nodeSize.

pdf.js worker script. The one asset without which nothing renders.

Directory of the CMap files, for CJK documents. Trailing slash.

Directory of the standard 14 font files. Trailing slash.

Directory of the WASM modules (OpenJPEG, qcms colour management). Trailing slash.

Directory of the predefined ICC profiles (e.g. CMYK). Trailing slash.

The config plugin’s allowedFileHosts. Undefined → every PDF is a card.

Pages rendered before the preview stops and says how many are left.

Content-Length above which the preview shows a “too large” notice instead of rendering.

Already normalized and policy-checked by the node view.

The node’s whole-file rotation, ADDED to each page’s own.

Display name, for the preview region’s accessible name.

Box height in CSS px: the page height paginated, the height attr otherwise.

Suggested corrections in LanguageTool’s object shape (PR-2). Capped at five.

Problem positions are relative to the node’s content (doc token accounting: atoms = 1, inline node boundaries = 1 each).

Epoch ms when the node was seen deleted; the entry is kept briefly so an undo needs no new api call. A number, not a Date: entries round-trip through JSON, and a Date would come back as a string that never expires.

Cache format version. Entries whose version doesn’t match the current format are treated as misses.

Whether word is in the dictionary for language (primary subtag) or globally.

Word’s w:style/@w:type; absent means “paragraph”. A "character" entry never applies to a block: it is absent from the style picker, not a valid styleId, carries no paragraphStyle, bases only on character styles, and renders against its MARK’s selector rather than .pm-style-<id>.

Only HTMLCode (code mark) and Hyperlink (link mark) are recognised; every other w:rStyle flattens onto its runs at import.

Proofing language (BCP 47), the middle of paragraph.proofingLanguage ?? style.language ?? doc.language — Word’s w:style/w:rPr/w:lang. Top-level, not in characterStyle, so it never reaches textStyleToCss. Inherits through basedOn; null resets to the document language, absent inherits.

type: "table" entries only (docs/partially-executed/table-styles-plan.md).

Word’s w:trHeight/@w:hRule: exact pins the row, atLeast (or null) lets content grow it. Carried for the DOCX round trip — the editor renders both as a minimum.

The row never splits across pages (Word’s w:cantSplit).

null: continue from the previous section, in decimal.

null: one column.

null: no page borders.

null: no watermark.

null switches back to one column.

ProseMirror JSON (a doc of paragraphs). Undefined once soft-deleted.

Word’s “don’t add space between paragraphs of the same style” (w:contextualSpacing): between two blocks of one style, the before/after of a block that sets it is ignored. Inherits through the style like the other fields; null inherits.

Word’s w:style/@w:type; absent means “paragraph”. A "character" entry never applies to a block: it is absent from the style picker, not a valid styleId, carries no paragraphStyle, bases only on character styles, and renders against its MARK’s selector rather than .pm-style-<id>.

Only HTMLCode (code mark) and Hyperlink (link mark) are recognised; every other w:rStyle flattens onto its runs at import.

type: "table" entries only (docs/partially-executed/table-styles-plan.md).

Proofing language (BCP 47), the middle of paragraph.proofingLanguage ?? style.language ?? doc.language — Word’s w:style/w:rPr/w:lang. Top-level, not in characterStyle, so it never reaches textStyleToCss. Inherits through basedOn; null resets to the document language, absent inherits.

doc.attrs.styleSheet as stored — what sub-editors read off the store.

The edges the table states itself, over its style’s.

A type: "table" stylesheet id; null is no style (Word’s TableNormal).

The table’s own shading (w:tblPr/w:shd), painted under its style’s region fills; “transparent” hides the style’s base fill.

Leading rows that are header rows (th); clamp with getHeaderRowCount.

Paint the header rows again at the top of every page the table continues onto.

Offset from the start margin in px (Word’s w:tblInd), negative to pull the table out; start-aligned tables only.

Word’s floating table placement, exporter-only; null for a table in the text flow.

Word’s noHBand, inverted.

Word’s noVBand, inverted.

The region’s cell fill: absent shows the layer below; “transparent” paints nothing and hides it (Word’s white, auto or nil shading).

w:tblPr/w:tblBorders.

w:tcPr/w:shd: every cell’s base fill, under the regions’.

w:rPr: every cell’s run formatting, under the regions’.

w:tblCellMar in px, per side. Flattened onto cells at import; kept for export.

w:tblInd in px. Flattened onto the table at import; kept for export.

w:pPr: the cells’ paragraph indent, spacing and alignment. Flattened onto the cell paragraphs at import; kept for export only, nothing renders it.

Rows per band (w:tblStyleRowBandSize). Absent, Word bands nothing.

“#RRGGBB”, the AUTO_COLOR sentinel "auto" (Word’s automatic color: flips black/white against the nearest background at render time), or null (the stylesheet decides). “auto” is legal ONLY here and in TextStyle.color; every other color slot treats it as absent.

Word’s character spacing (w:spacing in w:rPr), in px: positive expands, negative condenses. 0 is an explicit normal that beats a style’s spacing; null inherits.

Theme sidecars (docs/executed/document-theme-plan.md): non-null means the colour beside it is what the ref resolves to under doc.attrs.theme.

“#RRGGBB”, the AUTO_COLOR sentinel "auto" (Word’s automatic color: flips black/white against the nearest background at render time), or null (the stylesheet decides). “auto” is legal ONLY here and in TextStyle.color; every other color slot treats it as absent.

Word’s character spacing (w:spacing in w:rPr), in px: positive expands, negative condenses. 0 is an explicit normal that beats a style’s spacing; null inherits.

Theme sidecars (docs/executed/document-theme-plan.md): non-null means the colour beside it is what the ref resolves to under doc.attrs.theme.