@bendyline/squisq 2.0.1 → 2.2.0

package/dist/doc/index.d.ts

@@ -1,9 +1,11 @@
-import { aw as TemplateBlock, ax as TemplateContext, V as Layer, p as CustomTemplateDefinition, az as TemplateRegistry, aC as Theme, a_ as ViewportConfig, a8 as PersistentLayerConfig, G as DocBlock, a7 as PersistentLayer, aO as TitleBlockInput, al as SectionHeaderInput, ar as StatHighlightInput, ag as QuoteBlockInput, L as FactCardInput, aV as TwoColumnInput, u as DateEventInput, T as ImageWithCaptionInput, Y as LeftFeatureInput, aj as RightFeatureInput, $ as MapBlockInput, aq as StartBlockConfig, O as FullBleedQuoteInput, _ as ListBlockInput, ac as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, af as PullQuoteInput, aZ as VideoWithCaptionInput, aY as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, aQ as TreeBlockInput, aK as TimelineBlockInput, B as Block, I as DrawingBlockInput, a3 as MarkerStyle, A as AccentImage, S as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, aE as ThemeColorScheme, F as Doc, aF as ThemeRegistry, H as DocDiagnostic, E as DiagramTemplateNode, z as DiagramTemplateEdge, aN as TimelineTemplateTrack, aM as TimelineTemplateLink } from '../Doc-ylqWKDc_.js';
-export { J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, X as LayoutHints, ai as RenderStyle, aD as ThemeColorPalette, aI as ThemeStyle, aJ as ThemeTypography, aW as VIEWPORT_PRESETS, a$ as ViewportOrientation, b0 as ViewportPreset, b5 as createTemplateContext, bc as getLayoutHints, bf as getTwoColumnPositions, bg as getViewport, bh as getViewportOrientation, bj as isTemplateBlock, bm as scaledFontSize } from '../Doc-ylqWKDc_.js';
-import { I as MarkdownNode, $ as TransitionType, _ as TransitionDirection, M as MarkdownBlockNode, q as MarkdownHeading, m as MarkdownDocument, P as MarkdownTable, h as MarkdownCodeBlock, C as MarkdownList } from '../types-BwMPl2CB.js';
-import { C as CoercedBlockMeta } from '../annotationCoercion-Dr_DY9Hx.js';
-import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-RjVgLpUi.js';
+import { aX as TemplateBlock, aY as TemplateContext, V as Layer, p as CustomTemplateDefinition, a_ as TemplateRegistry, b1 as Theme, bq as ViewportConfig, az as PersistentLayerConfig, G as DocBlock, ay as PersistentLayer, be as TitleBlockInput, aM as SectionHeaderInput, aS as StatHighlightInput, aH as QuoteBlockInput, L as FactCardInput, bl as TwoColumnInput, u as DateEventInput, T as ImageWithCaptionInput, Y as LeftFeatureInput, aK as RightFeatureInput, $ as MapBlockInput, aR as StartBlockConfig, O as FullBleedQuoteInput, _ as ListBlockInput, aD as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, aG as PullQuoteInput, bp as VideoWithCaptionInput, bo as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, bg as TreeBlockInput, ba as TimelineBlockInput, B as Block, I as DrawingBlockInput, a3 as MarkerStyle, A as AccentImage, S as ImageTreatment, a as AccentPosition, c as Animation, d as AnimationType, b3 as ThemeColorScheme, F as Doc, b5 as ThemeRegistry, ar as PageEmphasis, b4 as ThemePageStyle, H as DocDiagnostic, E as DiagramTemplateNode, z as DiagramTemplateEdge, bd as TimelineTemplateTrack, bc as TimelineTemplateLink } from '../Doc-BubIpWsp.js';
+export { J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, X as LayoutHints, aJ as RenderStyle, b2 as ThemeColorPalette, b8 as ThemeStyle, b9 as ThemeTypography, bm as VIEWPORT_PRESETS, br as ViewportOrientation, bs as ViewportPreset, bx as createTemplateContext, bE as getLayoutHints, bH as getTwoColumnPositions, bI as getViewport, bJ as getViewportOrientation, bL as isTemplateBlock, bO as scaledFontSize } from '../Doc-BubIpWsp.js';
+import { K as MarkdownNode, a2 as TransitionType, a1 as TransitionDirection, M as MarkdownBlockNode, r as MarkdownHeading, n as MarkdownDocument, S as MarkdownTable, i as MarkdownCodeBlock, F as MarkdownList } from '../types-CUNc9biN.js';
+import { C as CoercedBlockMeta } from '../annotationCoercion-PtRQhk5V.js';
+import { c as PageSection } from '../materializePageSection-wSLA2A1g.js';
+export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from '../materializePageSection-wSLA2A1g.js';
+import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DU9mUmVl.js';
 
 /** Runtime registry composition for built-in and document-scoped templates. */
 
@@ -41,7 +43,7 @@ type LayerMaterializationDiagnostic = {
     cause: unknown;
 };
 /** Identifies which path produced a materialized layer graph. */
-type LayerMaterializationSource = 'authored' | 'template' | 'fallback' | 'empty';
+type LayerMaterializationSource = 'authored' | 'template' | 'rich-content' | 'fallback' | 'empty';
 /**
  * Complete result from {@link materializeBlockLayers}. Failures are data, not
  * console side effects: callers can display, report, or ignore the diagnostic.
@@ -1368,6 +1370,19 @@ declare function getBlockBodyText(block: Block): string;
  * ```
  */
 
+interface DocToMarkdownOptions {
+    /**
+     * The template `markdownToDoc` assigned to un-annotated headings when this
+     * doc was parsed — i.e. the `MarkdownToDocOptions.defaultTemplate` used.
+     * Defaults to `'sectionHeader'`, matching that option's own default.
+     *
+     * Blocks carrying exactly this template are treated as IMPLICIT: no
+     * `{[…]}` annotation is emitted for them, because none was authored.
+     * Passing a value that disagrees with how the doc was parsed makes the
+     * round-trip inject annotations onto headings that never had any.
+     */
+    defaultTemplate?: string;
+}
 /**
  * Convert a Doc with heading-driven blocks back to a MarkdownDocument.
  *
@@ -1375,14 +1390,16 @@ declare function getBlockBodyText(block: Block): string;
  * in document order. Blocks without a `sourceHeading` (preamble blocks)
  * emit only their contents.
  *
- * If a block has a `template` or `templateOverrides` that aren't already
- * reflected in the heading's `templateAnnotation`, the annotation is
- * injected so the round-trip preserves template assignments.
+ * A block's `template` / `templateOverrides` are RECONCILED with its
+ * heading's `templateAnnotation`, so programmatic edits to either round-trip.
+ * Annotations that already agree are reused verbatim (including legacy
+ * template spellings), keeping untouched documents byte-identical.
  *
  * @param doc - A Doc whose blocks may have `sourceHeading`, `contents`, and `children`
+ * @param options - Round-trip options; see {@link DocToMarkdownOptions.defaultTemplate}
  * @returns A MarkdownDocument that can be stringified back to markdown
  */
-declare function docToMarkdown(doc: Doc): MarkdownDocument;
+declare function docToMarkdown(doc: Doc, options?: DocToMarkdownOptions): MarkdownDocument;
 
 /**
  * Frontmatter serialization for user-defined custom templates (layouts).
@@ -1517,6 +1534,143 @@ interface ThemeResolvable {
  */
 declare function resolveThemeForDoc(doc: ThemeResolvable | null | undefined, explicitId?: string, registry?: ThemeRegistry): Theme;
 
+/**
+ * Resolve a doc block into the typed template input the page pipeline
+ * (and the SVG canvas embed) should render.
+ *
+ * This is the block-input merge that previously lived inline in
+ * `LinearDocView` — hoisted into core so the React page view, the string
+ * HTML exporter, and tests share one derivation:
+ *
+ * - Authored blocks with a heading `{[template]}` annotation derive typed
+ *   inputs from the heading/body (`deriveTemplateInputs` with placeholders),
+ *   then overlay `templateData` and coerced annotation params / overrides.
+ * - Auto-templated blocks (`block.autoTemplate`) already carry derived
+ *   `templateData`; same overlay applies.
+ * - Transform-generated blocks (no `sourceHeading`) already ARE typed
+ *   template inputs; overlay `templateData` / overrides like
+ *   `materializeBlockLayers` does.
+ * - Everything else is prose.
+ */
+
+/** The page pipeline's view of one block. */
+interface ResolvedPageBlock {
+    /** True when the block renders as a typed section (not prose). */
+    templated: boolean;
+    /** Canonical template id (post-alias). Only when `templated`. */
+    templateName?: string;
+    /**
+     * Fully merged typed template input, ready for a section extractor or
+     * `materializeBlockLayers`. Only when `templated`.
+     */
+    templateBlock?: TemplateBlock;
+}
+/**
+ * True when the block should render as a typed template section in Page
+ * mode: heading annotation, content-aware auto template, or a template
+ * block without authoring nodes (transform output, standalone annotation).
+ */
+declare function isTemplatedPageBlock(block: Block): boolean;
+/**
+ * Merge a block into its typed template input. Mirrors the merge order
+ * `materializeBlockLayers` applies at execution time:
+ * derived inputs → `templateData` → coerced annotation params/overrides.
+ */
+declare function resolvePageBlock(block: Block): ResolvedPageBlock;
+
+/**
+ * Per-template section extractors — the page analog of the SVG template
+ * registry. Each extractor maps one typed template input onto a
+ * `PageSection` draft: a section kind, a variant, and filled content slots.
+ *
+ * Inherently spatial templates (diagram/tree/timeline/map/drawing/layout)
+ * become `canvas-embed` drafts that carry the merged template block; the
+ * SVG pipeline renders those internally (including their own titles), so
+ * canvas drafts deliberately leave the text slots empty.
+ *
+ * The registry is total over the built-in template registry — a coverage
+ * test asserts every registered template id resolves to an extractor.
+ */
+
+/** Extraction context passed to each extractor. */
+interface PageSectionContext {
+    /** The source block (for canvas embeds and ids). */
+    block: Block;
+    /** Aspect reference for canvas embeds. */
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+/** What an extractor produces before the art-direction pass. */
+interface PageSectionDraft {
+    kind: PageSection['kind'];
+    variant?: string;
+    slots: PageSection['slots'];
+    /** Suggested emphasis (default 'standard'); art direction may override. */
+    emphasis?: PageEmphasis;
+    /** True when the section sits on its own full-bleed media background. */
+    mediaBackground?: boolean;
+    /** Block-authored color-scheme name — wins over theme accent rotation. */
+    colorScheme?: string;
+    hints?: Record<string, string | number | boolean>;
+}
+type SectionExtractor = (input: TemplateBlock, ctx: PageSectionContext) => PageSectionDraft;
+/**
+ * Extractors keyed by canonical template id — 1:1 with the SVG template
+ * registry (`templates/registry.ts`).
+ */
+declare const sectionExtractors: Record<string, SectionExtractor>;
+
+/**
+ * Page CSS — the single source of truth for Page (linear) mode styling.
+ *
+ * `PAGE_BASE_CSS` is structural and theme-independent: every color, font,
+ * and dimension flows through `--squisq-page-*` custom properties
+ * (`buildPageCssVars`) and the token data-attributes the renderer stamps on
+ * the `.squisq-page` wrapper (`pageStyleDataAttributes`). One stylesheet
+ * therefore serves all themes and all design families — a theme changes the
+ * page's look purely through vars + data attributes, never through
+ * generated CSS.
+ *
+ * Consumers:
+ * - React `LinearDocView` injects `<style data-squisq-page>` with
+ *   `PAGE_BASE_CSS` and sets the vars inline (self-contained — no CSS
+ *   import needed, which keeps the standalone bundle and single-file HTML
+ *   exports working).
+ * - A string-HTML exporter can call `buildPageCss(theme)` for the same
+ *   bytes plus a `.squisq-page { … }` var block.
+ *
+ * Responsive behavior uses container queries against the scroll container
+ * (named `squisq-page`), with a media-query fallback for engines without
+ * container support.
+ */
+
+/**
+ * Custom-property values for a theme's page rendition. Set these inline on
+ * the `.squisq-page` wrapper (React) or in a `.squisq-page { … }` rule
+ * (string export). Per-section accent vars (`--squisq-page-accent*`) get
+ * page-level defaults here and are overridden per section by the renderer.
+ */
+declare function buildPageCssVars(theme?: Theme, pageStyle?: ThemePageStyle): Record<string, string>;
+/**
+ * The token data-attributes the renderer stamps on `.squisq-page` so the
+ * structural CSS can branch per design decision. Shared by React and any
+ * string exporter so both emit identical markup.
+ */
+declare function pageStyleDataAttributes(pageStyle: ThemePageStyle): Record<string, string>;
+/**
+ * Structural, theme-independent stylesheet for the page rendition.
+ * Everything is scoped under `.squisq-page`.
+ */
+declare const PAGE_BASE_CSS = "\n/* \u2500\u2500 Base \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page {\n  background: var(--squisq-page-bg);\n  color: var(--squisq-page-text);\n  font-family: var(--squisq-page-body-font);\n  line-height: var(--squisq-page-line-height);\n  --squisq-page-divider-color: color-mix(in srgb, var(--squisq-page-text) 16%, transparent);\n  --squisq-page-section-pad: 3.5rem;\n  --squisq-page-shadow: none;\n}\n.squisq-page *, .squisq-page *::before, .squisq-page *::after { box-sizing: border-box; }\n.squisq-page img { max-width: 100%; height: auto; }\n\n/* Page pattern washes (very low intensity) */\n.squisq-page[data-pattern='dots'] {\n  background-image: radial-gradient(color-mix(in srgb, var(--squisq-page-text) 7%, transparent) 1px, transparent 1px);\n  background-size: 22px 22px;\n}\n.squisq-page[data-pattern='grid'] {\n  background-image:\n    linear-gradient(color-mix(in srgb, var(--squisq-page-primary) 7%, transparent) 1px, transparent 1px),\n    linear-gradient(90deg, color-mix(in srgb, var(--squisq-page-primary) 7%, transparent) 1px, transparent 1px);\n  background-size: 44px 44px;\n}\n.squisq-page[data-pattern='diagonal'] {\n  background-image: repeating-linear-gradient(\n    -45deg,\n    color-mix(in srgb, var(--squisq-page-text) 4%, transparent) 0 1px,\n    transparent 1px 14px\n  );\n}\n.squisq-page[data-pattern='noise'] { background-image: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='120' height='120'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='2'/%3E%3C/filter%3E%3Crect width='120' height='120' filter='url(%23n)' opacity='0.35'/%3E%3C/svg%3E\"); }\n\n/* Spacing scale */\n.squisq-page[data-spacing='compact'] { --squisq-page-section-pad: 2.25rem; }\n.squisq-page[data-spacing='comfortable'] { --squisq-page-section-pad: 3.5rem; }\n.squisq-page[data-spacing='generous'] { --squisq-page-section-pad: 5.25rem; }\n\n/* Shadow language */\n.squisq-page[data-shadow='soft'] { --squisq-page-shadow: 0 14px 36px color-mix(in srgb, var(--squisq-page-text) 14%, transparent); }\n.squisq-page[data-shadow='crisp'] { --squisq-page-shadow: 0 2px 10px color-mix(in srgb, var(--squisq-page-text) 26%, transparent); }\n.squisq-page[data-shadow='heavy'] { --squisq-page-shadow: 10px 10px 0 color-mix(in srgb, var(--squisq-page-text) 82%, transparent); }\n\n/* \u2500\u2500 Sections \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section { position: relative; padding-block: var(--squisq-page-section-pad); }\n.squisq-page-section-inner {\n  max-width: var(--squisq-page-content-max);\n  margin-inline: auto;\n  padding-inline: 24px;\n}\n/* Backdrops anchor to the section; these content roots stack above them. */\n.squisq-page-hero-body,\n.squisq-page-banner-body,\n.squisq-page-quote-figure { position: relative; }\n.squisq-page-section--feature-split .squisq-page-section-inner,\n.squisq-page-section--gallery .squisq-page-section-inner,\n.squisq-page-section--table-section .squisq-page-section-inner,\n.squisq-page-section--canvas-embed .squisq-page-section-inner,\n.squisq-page-section--stat-band .squisq-page-section-inner,\n.squisq-page-section--card-grid .squisq-page-section-inner,\n.squisq-page-section--media-figure .squisq-page-section-inner,\n.squisq-page-section--hero .squisq-page-section-inner {\n  max-width: var(--squisq-page-wide-max);\n}\n\n/* Background rhythm */\n.squisq-page-section--bg-alternate { background: var(--squisq-page-bg-alt); }\n.squisq-page-section--bg-accent {\n  background: var(--squisq-page-accent-bg);\n  color: var(--squisq-page-accent-text);\n}\n.squisq-page-section--bg-media { color: #ffffff; }\n\n/* Dividers between adjacent sections */\n.squisq-page[data-divider='hairline'] .squisq-page-section + .squisq-page-section { border-top: 1px solid var(--squisq-page-divider-color); }\n.squisq-page[data-divider='thick-rule'] .squisq-page-section + .squisq-page-section { border-top: 3px solid var(--squisq-page-primary); }\n.squisq-page[data-divider='double-rule'] .squisq-page-section + .squisq-page-section { border-top: 4px double var(--squisq-page-divider-color); }\n.squisq-page[data-divider='dotted'] .squisq-page-section + .squisq-page-section { border-top: 2px dotted var(--squisq-page-divider-color); }\n/* Banded sections carry their own edges; media sections never need rules. */\n.squisq-page .squisq-page-section--bg-media,\n.squisq-page .squisq-page-section--bg-media + .squisq-page-section,\n.squisq-page .squisq-page-section--timeline-rail + .squisq-page-section--timeline-rail { border-top: none; }\n\n/* \u2500\u2500 Headings, eyebrows \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section-title {\n  font-family: var(--squisq-page-title-font);\n  font-weight: var(--squisq-page-title-weight);\n  line-height: 1.15;\n  margin: 0 0 0.5em;\n}\n.squisq-page[data-heading-case='uppercase'] .squisq-page-section-title { text-transform: uppercase; letter-spacing: 0.03em; }\n.squisq-page[data-underline='accent-bar'] .squisq-page-section-title::after {\n  content: '';\n  display: block;\n  width: 56px;\n  height: 4px;\n  margin-top: 0.4em;\n  border-radius: 2px;\n  background: var(--squisq-page-accent);\n}\n.squisq-page[data-underline='full-rule'] .squisq-page-section-title {\n  border-bottom: 1px solid var(--squisq-page-divider-color);\n  padding-bottom: 0.35em;\n}\n\n.squisq-page-eyebrow {\n  display: block;\n  font-size: 0.8125rem;\n  font-weight: 600;\n  letter-spacing: 0.14em;\n  text-transform: uppercase;\n  color: var(--squisq-page-accent);\n  margin: 0 0 0.9em;\n}\n.squisq-page[data-eyebrow='numbered'] .squisq-page-eyebrow::after { content: ' \u2014'; color: var(--squisq-page-text-muted); }\n.squisq-page[data-eyebrow='mono-tag'] .squisq-page-eyebrow {\n  display: inline-block;\n  font-family: var(--squisq-page-mono-font);\n  text-transform: none;\n  letter-spacing: 0.06em;\n  border: 1px solid color-mix(in srgb, var(--squisq-page-accent) 55%, transparent);\n  border-radius: var(--squisq-page-radius);\n  padding: 0.15em 0.6em;\n  background: color-mix(in srgb, var(--squisq-page-accent) 10%, transparent);\n}\n.squisq-page[data-eyebrow='mono-tag'] .squisq-page-eyebrow::before { content: '['; opacity: 0.6; }\n.squisq-page[data-eyebrow='mono-tag'] .squisq-page-eyebrow::after { content: ']'; opacity: 0.6; }\n\n/* \u2500\u2500 Hero \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section--hero { padding-block: calc(var(--squisq-page-section-pad) * 1.5); }\n.squisq-page-hero-title {\n  font-family: var(--squisq-page-title-font);\n  font-weight: var(--squisq-page-title-weight);\n  line-height: 1.08;\n  margin: 0;\n  font-size: 2.75rem;\n}\n.squisq-page[data-heading-scale='display'] .squisq-page-hero-title { font-size: 3.4rem; }\n.squisq-page[data-heading-scale='oversized'] .squisq-page-hero-title { font-size: 4rem; font-size: clamp(3rem, 9cqw, 6rem); line-height: 1.02; }\n.squisq-page[data-heading-case='uppercase'] .squisq-page-hero-title { text-transform: uppercase; letter-spacing: 0.02em; }\n.squisq-page-hero-subtitle {\n  margin: 1.1em 0 0;\n  font-size: 1.25rem;\n  color: var(--squisq-page-text-muted);\n  max-width: 42em;\n  white-space: pre-line;\n}\n.squisq-page-section--bg-media .squisq-page-hero-subtitle { color: rgba(255, 255, 255, 0.88); }\n\n/* Stacked (default): centered column */\n.squisq-page[data-hero-style='stacked'] .squisq-page-hero-body { text-align: center; }\n.squisq-page[data-hero-style='stacked'] .squisq-page-hero-subtitle { margin-inline: auto; }\n\n/* Oversized type: hard left, no decoration */\n.squisq-page[data-hero-style='oversized-type'] .squisq-page-hero-title { font-size: 4.25rem; font-size: clamp(3.25rem, 10cqw, 6.5rem); line-height: 0.98; }\n\n/* Split: text and media side by side */\n.squisq-page-hero-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 3rem; align-items: center; }\n.squisq-page-hero-grid .squisq-page-hero-media img { width: 100%; object-fit: cover; }\n\n/* Full-bleed & letterbox: media behind text */\n.squisq-page-section--hero-media {\n  padding-block: 0;\n  min-height: min(72svh, 620px);\n  display: flex;\n  align-items: flex-end;\n}\n.squisq-page[data-hero-style='letterbox'] .squisq-page-section--hero-media { min-height: min(52svh, 460px); }\n.squisq-page-hero-backdrop { position: absolute; inset: 0; overflow: hidden; }\n.squisq-page-hero-backdrop img { width: 100%; height: 100%; object-fit: cover; }\n.squisq-page-hero-backdrop::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  background: linear-gradient(180deg, rgba(0, 0, 0, 0.1) 30%, rgba(0, 0, 0, 0.68) 100%);\n}\n.squisq-page[data-hero-style='letterbox'] .squisq-page-hero-backdrop img { filter: saturate(0.9); }\n.squisq-page-section--hero-media .squisq-page-section-inner { padding-block: 3rem; width: 100%; }\n\n/* \u2500\u2500 Banner (sectionHeader) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-banner-title { font-size: 2rem; }\n.squisq-page[data-heading-scale='display'] .squisq-page-banner-title { font-size: 2.5rem; }\n.squisq-page[data-heading-scale='oversized'] .squisq-page-banner-title { font-size: 3rem; font-size: clamp(2.25rem, 6cqw, 3.75rem); }\n.squisq-page-section--banner.squisq-page-section--bg-media { padding-block: 0; min-height: 280px; display: flex; align-items: flex-end; }\n.squisq-page-section--banner.squisq-page-section--bg-media .squisq-page-section-inner { padding-block: 2rem; width: 100%; }\n.squisq-page-section--banner .squisq-page-section-title { margin-bottom: 0; }\n\n/* \u2500\u2500 Stat band \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-stats { display: flex; gap: 3rem; justify-content: center; text-align: center; flex-wrap: wrap; }\n.squisq-page-stat { flex: 1 1 220px; max-width: 420px; }\n.squisq-page-stat-value {\n  display: block;\n  font-family: var(--squisq-page-title-font);\n  font-weight: 700;\n  font-size: 3.25rem;\n  line-height: 1;\n  color: var(--squisq-page-accent);\n}\n.squisq-page[data-numerals='oversized'] .squisq-page-stat-value { font-size: 4.5rem; font-size: clamp(3.5rem, 8cqw, 5.5rem); }\n.squisq-page[data-numerals='mono'] .squisq-page-stat-value { font-family: var(--squisq-page-mono-font); letter-spacing: -0.02em; }\n.squisq-page[data-numerals='boxed'] .squisq-page-stat-value {\n  display: inline-block;\n  border: 2px solid var(--squisq-page-accent);\n  border-radius: var(--squisq-page-radius);\n  padding: 0.18em 0.4em;\n}\n.squisq-page-stat-title { display: block; margin-top: 0.9em; font-size: 1.125rem; font-weight: 600; }\n.squisq-page-stat-body { display: block; margin-top: 0.45em; color: var(--squisq-page-text-muted); font-size: 0.95rem; }\n.squisq-page-stat-meta { text-align: center; margin-top: 1.5rem; color: var(--squisq-page-text-muted); font-size: 0.85rem; }\n.squisq-page-stat-bar { height: 10px; border-radius: 999px; background: var(--squisq-page-accent); margin-top: 0.8em; }\n.squisq-page-stat--bars { text-align: left; }\n\n/* \u2500\u2500 Quote band \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-quote {\n  margin: 0;\n  font-family: var(--squisq-page-title-font);\n  font-size: 1.6rem;\n  line-height: 1.35;\n  white-space: pre-line;\n}\n.squisq-page-section--em-strong .squisq-page-quote { font-size: 2.1rem; }\n.squisq-page-section--em-quiet .squisq-page-quote { font-size: 1.25rem; color: var(--squisq-page-text-muted); }\n.squisq-page-quote-attribution { margin-top: 1.1em; font-family: var(--squisq-page-body-font); font-size: 0.95rem; color: var(--squisq-page-text-muted); }\n.squisq-page-quote-attribution::before { content: '\u2014 '; }\n.squisq-page[data-quote-mark='accent-bar'] .squisq-page-quote-figure { border-left: 4px solid var(--squisq-page-accent); padding-left: 1.5rem; }\n.squisq-page[data-quote-mark='oversized-glyph'] .squisq-page-quote-figure { position: relative; padding-top: 1.25rem; }\n.squisq-page[data-quote-mark='oversized-glyph'] .squisq-page-quote-figure::before {\n  content: '\\201C';\n  position: absolute;\n  top: -0.12em;\n  left: -0.05em;\n  font-family: var(--squisq-page-title-font);\n  font-size: 5.5rem;\n  line-height: 1;\n  color: color-mix(in srgb, var(--squisq-page-accent) 42%, transparent);\n  pointer-events: none;\n}\n.squisq-page-section--v-display .squisq-page-quote-figure { text-align: center; border-left: none; }\n.squisq-page-section--v-display .squisq-page-quote { font-size: 2.4rem; font-size: clamp(1.9rem, 5cqw, 3rem); }\n.squisq-page-section--v-editorial .squisq-page-quote-figure {\n  border-block: 3px solid var(--squisq-page-primary);\n  border-left: none;\n  padding: 2rem 0.5rem;\n}\n/* Full-bleed quote over media */\n.squisq-page-section--quote-band.squisq-page-section--bg-media { padding-block: 0; min-height: 380px; display: flex; align-items: center; }\n.squisq-page-section--quote-band.squisq-page-section--bg-media .squisq-page-section-inner { padding-block: 3.5rem; }\n.squisq-page-quote-backdrop { position: absolute; inset: 0; overflow: hidden; }\n.squisq-page-quote-backdrop img, .squisq-page-quote-backdrop video { width: 100%; height: 100%; object-fit: cover; }\n.squisq-page-quote-backdrop::after { content: ''; position: absolute; inset: 0; background: rgba(0, 0, 0, 0.55); }\n.squisq-page-section--quote-band[data-hint-vignette] .squisq-page-quote-backdrop::after {\n  background: radial-gradient(ellipse at center, rgba(0, 0, 0, 0.35) 0%, rgba(0, 0, 0, 0.75) 100%);\n}\n.squisq-page-section--quote-band.squisq-page-section--bg-media .squisq-page-quote-figure { border: none; text-align: center; }\n\n/* \u2500\u2500 Feature split \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-feature { display: grid; grid-template-columns: 1fr 1fr; gap: 3rem; align-items: center; }\n.squisq-page-feature--media-right .squisq-page-feature-media { order: 2; }\n.squisq-page-feature-media img { width: 100%; object-fit: cover; }\n.squisq-page-feature-title { font-size: 1.75rem; }\n.squisq-page-feature-body { color: var(--squisq-page-text-muted); font-size: 1.05rem; white-space: pre-line; margin: 0; }\n\n/* \u2500\u2500 Media figure \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-figure { margin: 0; }\n.squisq-page-figure img, .squisq-page-figure video { width: 100%; display: block; }\n.squisq-page-figure figcaption { margin-top: 0.9em; font-size: 0.9rem; color: var(--squisq-page-text-muted); text-align: center; }\n.squisq-page-media-credit { font-size: 0.78rem; opacity: 0.75; }\n\n/* Media frame treatment (figures, features, gallery tiles, cards) */\n.squisq-page-media-frame { overflow: hidden; }\n.squisq-page[data-framing='rounded'] .squisq-page-media-frame { border-radius: var(--squisq-page-radius); }\n.squisq-page[data-framing='bordered'] .squisq-page-media-frame { border: 3px solid var(--squisq-page-text); }\n.squisq-page[data-framing='polaroid'] .squisq-page-media-frame {\n  background: #ffffff;\n  padding: 10px 10px 16px;\n  border: 1px solid rgba(0, 0, 0, 0.12);\n  border-radius: 2px;\n}\n.squisq-page[data-framing='letterboxed'] .squisq-page-media-frame img { aspect-ratio: 21 / 9; object-fit: cover; }\n.squisq-page[data-framing='circle-accent'] .squisq-page-media-frame { border-radius: calc(var(--squisq-page-radius) * 2); }\n.squisq-page .squisq-page-media-frame { box-shadow: var(--squisq-page-shadow); }\n\n/* Rich body nodes that the selected template did not consume. This universal\n * supplement keeps diagrams/media visible without making every template\n * duplicate the same preservation logic. */\n.squisq-page-rich-content {\n  margin-top: clamp(1.5rem, 4vw, 3rem);\n  padding-top: clamp(1.25rem, 3vw, 2rem);\n  border-top: 1px solid var(--squisq-page-divider-color);\n}\n.squisq-page-rich-content :is(img, video) { display: block; max-width: 100%; height: auto; margin-inline: auto; }\n.squisq-page-rich-content .squisq-md-mermaid { min-height: min(520px, 62vh); margin-block: 0; }\n\n/* \u2500\u2500 Gallery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-gallery { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 1.25rem; }\n.squisq-page-gallery .squisq-page-media-frame img { width: 100%; height: 100%; aspect-ratio: 4 / 3; object-fit: cover; }\n.squisq-page-gallery-caption { margin-top: 1.1rem; text-align: center; font-size: 0.9rem; color: var(--squisq-page-text-muted); }\n\n/* \u2500\u2500 Callout \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-callout {\n  border-radius: var(--squisq-page-radius);\n  border: 1px solid color-mix(in srgb, var(--squisq-page-accent) 32%, transparent);\n  border-left: 5px solid var(--squisq-page-accent);\n  background: color-mix(in srgb, var(--squisq-page-accent) 7%, var(--squisq-page-bg));\n  padding: 1.75rem 2rem;\n  box-shadow: var(--squisq-page-shadow);\n  display: flex;\n  gap: 1.75rem;\n  align-items: flex-start;\n}\n.squisq-page-callout-title { font-family: var(--squisq-page-title-font); font-size: 1.35rem; font-weight: 700; margin: 0 0 0.5em; }\n.squisq-page-callout-body { margin: 0; white-space: pre-line; }\n.squisq-page-callout-meta { margin-top: 0.9em; font-size: 0.82rem; color: var(--squisq-page-text-muted); }\n.squisq-page-callout .squisq-page-media-frame { flex: 0 0 132px; }\n.squisq-page-callout .squisq-page-media-frame img { width: 132px; height: 132px; object-fit: cover; }\n.squisq-page-callout[data-hint-framing='circle-accent'] .squisq-page-media-frame,\n.squisq-page-callout[data-hint-framing='circle-accent'] .squisq-page-media-frame img { border-radius: 50%; }\n.squisq-page-section--v-definition .squisq-page-callout-title { font-style: italic; }\n.squisq-page-section--v-diagnostic .squisq-page-callout { border-left-color: var(--squisq-page-highlight); }\n\n/* \u2500\u2500 Card grid \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 1.5rem; }\n.squisq-page-card {\n  border-radius: var(--squisq-page-radius);\n  background: var(--squisq-page-bg-alt);\n  border-top: 4px solid var(--squisq-page-card-accent, var(--squisq-page-accent));\n  padding: 1.75rem 1.75rem 1.9rem;\n  box-shadow: var(--squisq-page-shadow);\n}\n.squisq-page-card-title { font-family: var(--squisq-page-title-font); font-size: 1.3rem; margin: 0 0 0.4em; }\n.squisq-page-card-body { margin: 0; color: var(--squisq-page-text-muted); white-space: pre-line; }\n.squisq-page-cards-title { text-align: center; font-size: 1.9rem; margin-bottom: 1.75rem; }\n\n/* \u2500\u2500 Item list \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-items { list-style: none; margin: 0; padding: 0; counter-reset: squisq-item; max-width: 40em; }\n.squisq-page-items li {\n  counter-increment: squisq-item;\n  position: relative;\n  padding: 0.9em 0 0.9em 3.4em;\n  font-size: 1.1rem;\n}\n.squisq-page-items li + li { border-top: 1px solid var(--squisq-page-divider-color); }\n.squisq-page-items li::before {\n  content: counter(squisq-item, decimal-leading-zero);\n  position: absolute;\n  left: 0;\n  top: 0.85em;\n  font-family: var(--squisq-page-title-font);\n  font-weight: 700;\n  color: var(--squisq-page-accent);\n  font-size: 1.15em;\n}\n.squisq-page[data-numerals='mono'] .squisq-page-items li::before { font-family: var(--squisq-page-mono-font); }\n.squisq-page-items-title { font-size: 1.9rem; }\n\n/* \u2500\u2500 Timeline rail (dateEvent) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section--timeline-rail { padding-block: 1.4rem; }\n.squisq-page-section--timeline-rail:first-child { padding-top: var(--squisq-page-section-pad); }\n.squisq-page-milestone { display: grid; grid-template-columns: 150px 1fr; gap: 2rem; align-items: baseline; position: relative; }\n.squisq-page-milestone-date {\n  font-family: var(--squisq-page-title-font);\n  font-weight: 700;\n  color: var(--squisq-page-accent);\n  font-size: 1.05rem;\n  text-align: right;\n}\n.squisq-page-milestone-rail {\n  position: absolute;\n  left: 166px;\n  top: -1.4rem;\n  bottom: -1.4rem;\n  width: 2px;\n  background: color-mix(in srgb, var(--squisq-page-accent) 35%, transparent);\n}\n.squisq-page-milestone-rail::after {\n  content: '';\n  position: absolute;\n  left: 50%;\n  top: 0.55em;\n  width: 12px;\n  height: 12px;\n  border-radius: 50%;\n  transform: translateX(-50%);\n  background: var(--squisq-page-accent);\n  border: 2px solid var(--squisq-page-bg);\n}\n.squisq-page-milestone-body { padding-left: 2.25rem; white-space: pre-line; }\n.squisq-page-milestone-footer { margin-top: 0.5em; font-size: 0.85rem; color: var(--squisq-page-text-muted); }\n\n/* \u2500\u2500 Table section \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-table-title { font-size: 1.9rem; }\n.squisq-page-table-scroll { overflow-x: auto; border-radius: var(--squisq-page-radius); box-shadow: var(--squisq-page-shadow); }\n.squisq-page-table { width: 100%; border-collapse: collapse; font-size: 0.98rem; }\n.squisq-page-table th {\n  background: var(--squisq-page-accent-bg);\n  color: var(--squisq-page-accent-text);\n  font-family: var(--squisq-page-title-font);\n  text-align: left;\n  padding: 0.8em 1em;\n}\n.squisq-page-table td { padding: 0.7em 1em; border-top: 1px solid var(--squisq-page-divider-color); }\n.squisq-page-table tbody tr:nth-child(even) { background: color-mix(in srgb, var(--squisq-page-text) 3.5%, transparent); }\n\n/* \u2500\u2500 Canvas embed (spatial SVG) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-canvas {\n  width: 100%;\n  margin-inline: auto;\n  overflow: hidden;\n  border-radius: var(--squisq-page-radius);\n}\n.squisq-page-canvas svg { display: block; width: 100%; height: 100%; }\n.squisq-page-canvas--framed { border: 1px solid var(--squisq-page-divider-color); box-shadow: var(--squisq-page-shadow); }\n.squisq-page-canvas--terminal { border: 1px solid color-mix(in srgb, var(--squisq-page-accent) 45%, transparent); }\n.squisq-page-canvas--terminal::before {\n  content: '\\25CF \\25CF \\25CF';\n  display: block;\n  font-size: 9px;\n  letter-spacing: 4px;\n  padding: 6px 12px;\n  color: color-mix(in srgb, var(--squisq-page-accent) 70%, transparent);\n  background: color-mix(in srgb, var(--squisq-page-accent) 9%, var(--squisq-page-bg));\n  border-bottom: 1px solid color-mix(in srgb, var(--squisq-page-accent) 30%, transparent);\n}\n\n/* \u2500\u2500 Prose \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section--prose { padding-block: calc(var(--squisq-page-section-pad) * 0.45); }\n.squisq-page[data-divider] .squisq-page-section--prose + .squisq-page-section--prose { border-top: none; }\n.squisq-page-prose { font-size: 1.05rem; }\n.squisq-page-prose p { margin: 0; }\n.squisq-page-prose p + p { margin-top: 1.25em; }\n.squisq-page-prose > * + * { margin-top: 1.1em; }\n.squisq-page-prose a { color: var(--squisq-page-primary); text-decoration-color: color-mix(in srgb, var(--squisq-page-primary) 40%, transparent); }\n.squisq-page-prose code { font-family: var(--squisq-page-mono-font); font-size: 0.9em; background: color-mix(in srgb, var(--squisq-page-text) 8%, transparent); border-radius: 4px; padding: 0.12em 0.35em; }\n.squisq-page-prose pre { background: color-mix(in srgb, var(--squisq-page-text) 6%, transparent); border-radius: var(--squisq-page-radius); padding: 1em 1.25em; overflow-x: auto; }\n.squisq-page-prose pre code { background: none; padding: 0; }\n.squisq-page-prose blockquote { margin: 0; border-left: 4px solid var(--squisq-page-accent); padding-left: 1.25em; color: var(--squisq-page-text-muted); }\n.squisq-page-prose ul, .squisq-page-prose ol { padding-left: 1.5em; margin: 0; }\n.squisq-page-prose li + li { margin-top: 0.4em; }\n.squisq-page-prose hr { border: none; border-top: 1px solid var(--squisq-page-divider-color); }\n.squisq-page-prose table { width: 100%; border-collapse: collapse; }\n.squisq-page-prose th { font-family: var(--squisq-page-title-font); text-align: left; padding: 0.6em 0.8em; border-bottom: 2px solid var(--squisq-page-divider-color); }\n.squisq-page-prose td { padding: 0.55em 0.8em; border-bottom: 1px solid var(--squisq-page-divider-color); }\n.squisq-page-prose img { border-radius: var(--squisq-page-radius); }\n.squisq-page-prose h1, .squisq-page-prose h2, .squisq-page-prose h3,\n.squisq-page-prose h4, .squisq-page-prose h5, .squisq-page-prose h6 {\n  font-family: var(--squisq-page-title-font);\n  font-weight: var(--squisq-page-title-weight);\n  line-height: 1.2;\n  margin: 0 0 0.45em;\n}\n.squisq-page-prose h1 { font-size: 2.1rem; }\n.squisq-page-prose h2 { font-size: 1.65rem; }\n.squisq-page-prose h3 { font-size: 1.35rem; }\n.squisq-page-prose h4, .squisq-page-prose h5, .squisq-page-prose h6 { font-size: 1.15rem; }\n.squisq-page-section--prose[data-hint-drop-cap] .squisq-page-prose > p:first-child::first-letter {\n  font-family: var(--squisq-page-title-font);\n  font-size: 3.4em;\n  font-weight: 700;\n  float: left;\n  line-height: 0.85;\n  padding-right: 0.12em;\n  color: var(--squisq-page-accent);\n}\n\n/* \u2500\u2500 Footer band \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page-section--footer { text-align: center; }\n\n/* \u2500\u2500 Thin-margin embedding (chat bubbles) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n.squisq-page--thin .squisq-page-section-inner { padding-inline: 0; }\n.squisq-page--thin .squisq-page-section { padding-block: 1.5rem; }\n\n/* Thumbnail image mode */\n.squisq-page--thumbnail-images .squisq-page-prose img,\n.squisq-page--thumbnail-images .squisq-page-figure img { max-width: 100px; max-height: 100px; object-fit: cover; }\n\n/* \u2500\u2500 Reveal animation (progressive enhancement) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n@media (prefers-reduced-motion: no-preference) {\n  .squisq-page-reveal { opacity: 0; transform: translateY(14px); transition: opacity 0.55s ease, transform 0.55s ease; }\n  .squisq-page-reveal--in { opacity: 1; transform: none; }\n}\n\n/* \u2500\u2500 Responsive \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n@container squisq-page (max-width: 720px) {\n\n.squisq-page-hero-grid { grid-template-columns: 1fr; gap: 1.5rem; }\n.squisq-page-feature { grid-template-columns: 1fr; }\n.squisq-page-feature--media-right .squisq-page-feature-media { order: 0; }\n.squisq-page-stats { flex-direction: column; gap: 1.75rem; }\n.squisq-page-cards { grid-template-columns: 1fr; }\n.squisq-page-gallery { grid-template-columns: repeat(2, 1fr); }\n.squisq-page-milestone { grid-template-columns: 1fr; gap: 0.5rem; }\n.squisq-page-milestone-rail { display: none; }\n.squisq-page-section-inner { padding-inline: 18px; }\n\n}\n@supports not (container-type: inline-size) {\n  @media (max-width: 720px) {\n\n.squisq-page-hero-grid { grid-template-columns: 1fr; gap: 1.5rem; }\n.squisq-page-feature { grid-template-columns: 1fr; }\n.squisq-page-feature--media-right .squisq-page-feature-media { order: 0; }\n.squisq-page-stats { flex-direction: column; gap: 1.75rem; }\n.squisq-page-cards { grid-template-columns: 1fr; }\n.squisq-page-gallery { grid-template-columns: repeat(2, 1fr); }\n.squisq-page-milestone { grid-template-columns: 1fr; gap: 0.5rem; }\n.squisq-page-milestone-rail { display: none; }\n.squisq-page-section-inner { padding-inline: 18px; }\n\n  }\n}\n";
+/**
+ * Complete stylesheet for a themed page: a `.squisq-page { … }` variable
+ * block followed by the structural CSS. For string-HTML consumers; the
+ * React view sets the vars inline instead.
+ */
+declare function buildPageCss(theme?: Theme): string;
+
 /**
  * Audio Mapping
  *
@@ -2331,4 +2485,4 @@ declare function treeFromMarkdownList(list: MarkdownList): Tree;
 /** Find the first top-level markdown list in a block's body, if any. */
 declare function findFirstList(contents: MarkdownBlockNode[] | undefined): MarkdownList | undefined;
 
-export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, type BlockLayerMaterialization, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, PATH_SHAPE_KINDS, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type RuntimeTemplateRegistry, SHAPE_NAMES, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type ValidateOptions, ViewportConfig, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };
+export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, type AccentLayout, type AsciiDiagram, type AsciiDiagramDetection, type AsciiDiagramEdge, type AsciiDiagramNode, type AsciiTimeline, type AsciiTimelineDetection, type AsciiTimelineEvent, type AsciiTimelineLink, type AsciiTimelineMarker, type AsciiTimelineSide, type AsciiTimelineStats, type AsciiTimelineStyle, type AsciiTimelineTrack, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, type BlockLayerMaterialization, CONTAINER_TEMPLATES, type ClipBox, type ConnectorAnchor, type ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, type CoverBlockInput, DEFAULT_LAYOUT, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DetectAsciiTimelineOptions, type DiagramEdge, type DiagramLabelFit, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayerMaterializationDiagnostic, type LayerMaterializationFailureMode, type LayerMaterializationSource, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, type MaterializeBlockLayersOptions, type NarrationResolution, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSection, type PageSectionContext, type PageSectionDraft, PersistentLayerConfig, type RenderAsciiDiagramOptions, type RenderAsciiTimelineOptions, type RenderTreeOptions, type RepairResult, type ResolvedPageBlock, type RuntimeTemplateRegistry, SHAPE_NAMES, type SectionExtractor, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type Tree, type TreeDetection, type TreeItem, type TreeNode, type ValidateOptions, ViewportConfig, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, buildPageCss, buildPageCssVars, buildRegistry, canvasToAsciiCell, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, definitionCard, deriveTemplateInputs, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, materializeBlockLayers, nearestSnapPoint, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };

package/dist/doc/index.js

@@ -1,5 +1,8 @@
 import {
+  PAGE_BASE_CSS,
   applyNarrationTiming,
+  buildPageCss,
+  buildPageCssVars,
   cssFilterForTreatment,
   docToMarkdown,
   getAnimationProgress,
@@ -7,16 +10,23 @@ import {
   getDefaultAnimationDuration,
   getTransitionClass,
   isRepairableDiagram,
+  isTemplatedPageBlock,
+  materializePageSection,
+  materializePageSections,
+  pageStyleDataAttributes,
   renderAsciiDiagram,
   renderAsciiTimeline,
   renderTree,
   repairAsciiDiagram,
   resolveAudioMapping,
+  resolvePageBlock,
+  resolvePageStyle,
   resolveThemeForDoc,
   scoreTextSimilarity,
+  sectionExtractors,
   validateMarkdownDoc,
   validateMarkdownSource
-} from "../chunk-TFJVXUHH.js";
+} from "../chunk-I2O6W7DX.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -129,7 +139,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "../chunk-X6DUONGT.js";
+} from "../chunk-7ARJZYQY.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -142,7 +152,7 @@ import {
   shapePath,
   snapEndpoints,
   snapPoints
-} from "../chunk-TUWMK62B.js";
+} from "../chunk-PUS54YU6.js";
 import {
   ASCII_DIAGRAM_FENCE_LANGS,
   ASCII_TIMELINE_FENCE_LANGS,
@@ -165,8 +175,8 @@ import {
   parseAsciiTimelineWithStats,
   parseTree,
   parseWrappedFlowTimeline
-} from "../chunk-5UYI3RJB.js";
-import "../chunk-FVJUUTEM.js";
+} from "../chunk-FDYDYL77.js";
+import "../chunk-2ZWIXGAC.js";
 import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
@@ -174,7 +184,7 @@ import {
   getAvailableThemes,
   getThemeSummaries,
   resolveTheme
-} from "../chunk-W4O2TX5I.js";
+} from "../chunk-C33GTPUZ.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -184,16 +194,16 @@ import {
   getViewportOrientation,
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
-} from "../chunk-5J4HKRJF.js";
-import "../chunk-66QO7XFB.js";
-import "../chunk-R2YZTCLO.js";
-import "../chunk-DBS6RIFL.js";
-import "../chunk-AMIR72JP.js";
-import "../chunk-QE7TWGVT.js";
-import "../chunk-4X3JQXNM.js";
-import "../chunk-3E5F2XMR.js";
-import "../chunk-V543AI2F.js";
-import "../chunk-FVTQSNR7.js";
+} from "../chunk-BAOV476U.js";
+import "../chunk-ACZOVWX3.js";
+import "../chunk-ZQKZSJAX.js";
+import "../chunk-7N4G32LG.js";
+import "../chunk-BCCXTMN5.js";
+import "../chunk-4VOD55SX.js";
+import "../chunk-XOFT65EX.js";
+import "../chunk-67L6WRJN.js";
+import "../chunk-QKPXHDLR.js";
+import "../chunk-XRW6P7IF.js";
 export {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -209,6 +219,7 @@ export {
   DIAGRAM_LABEL_VERTICAL_PADDING,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
+  PAGE_BASE_CSS,
   PATH_SHAPE_KINDS,
   SHAPE_NAMES,
   TEMPLATE_INPUT_DESCRIPTORS,
@@ -224,6 +235,8 @@ export {
   asciiDiagramFromTemplateData,
   asciiDiagramToTemplateData,
   asciiTimelineToTemplateData,
+  buildPageCss,
+  buildPageCssVars,
   buildRegistry,
   canvasToAsciiCell,
   clipEndpoints,
@@ -302,6 +315,7 @@ export {
   isRepairableDiagram,
   isShapeName,
   isTemplateBlock,
+  isTemplatedPageBlock,
   isTreeFence,
   isWrappedFlowTimelineSource,
   layoutBlock,
@@ -313,8 +327,11 @@ export {
   markdownToDoc,
   markerPath,
   materializeBlockLayers,
+  materializePageSection,
+  materializePageSections,
   nearestSnapPoint,
   normalizeShapeKind,
+  pageStyleDataAttributes,
   parseAsciiDiagram,
   parseAsciiTimeline,
   parseAsciiTimelineWithStats,
@@ -334,6 +351,8 @@ export {
   replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
+  resolvePageBlock,
+  resolvePageStyle,
   resolvePersistentLayers,
   resolveTemplateName,
   resolveTheme,
@@ -342,6 +361,7 @@ export {
   scaleAnimationDuration,
   scaledFontSize,
   scoreTextSimilarity,
+  sectionExtractors,
   sectionHeader,
   shapePath,
   shouldUseShadow,
@@ -370,4 +390,3 @@ export {
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
 };
-//# sourceMappingURL=index.js.map

package/dist/generate/index.d.ts

@@ -1,7 +1,7 @@
 import { E as ExtractedElement } from '../contentExtractor-BNfVJV2U.js';
 export { C as ComparisonData, D as DateData, a as DefinitionData, b as ExtractionOptions, c as ExtractionResult, d as ExtractionType, F as FactData, I as ImpactLineData, L as ListData, Q as QuoteData, S as StatData, e as extractContent, s as stripMarkdown } from '../contentExtractor-BNfVJV2U.js';
-import { m as ColorScheme, A as AccentImage, aw as TemplateBlock } from '../Doc-ylqWKDc_.js';
-import '../types-BwMPl2CB.js';
+import { m as ColorScheme, A as AccentImage, aX as TemplateBlock } from '../Doc-BubIpWsp.js';
+import '../types-CUNc9biN.js';
 
 /**
  * Template Mapper

package/dist/generate/index.js

@@ -1,12 +1,11 @@
-import "../chunk-ET53IIEP.js";
+import "../chunk-2L55443L.js";
 import {
   extractContent,
   mapElementToBlock,
   stripMarkdown
-} from "../chunk-Q7LROV2H.js";
+} from "../chunk-NKNMGIIN.js";
 export {
   extractContent,
   mapElementToBlock,
   stripMarkdown
 };
-//# sourceMappingURL=index.js.map

package/dist/icons/index.js

@@ -1,11 +1,11 @@
-import "../chunk-PGGGKYWG.js";
+import "../chunk-WV5ARNDA.js";
 import {
   hasIconMarker,
   iconClass,
   iconMarker,
   splitIconMarkers,
   stripIconMarkers
-} from "../chunk-2UQOHYE2.js";
+} from "../chunk-7ZAAICW4.js";
 import {
   ICONS,
   canonicalIconToken,
@@ -13,7 +13,7 @@ import {
   looksLikeIconToken,
   resolveIcon,
   suggestIcons
-} from "../chunk-DBS6RIFL.js";
+} from "../chunk-7N4G32LG.js";
 export {
   ICONS,
   canonicalIconToken,
@@ -27,4 +27,3 @@ export {
   stripIconMarkers,
   suggestIcons
 };
-//# sourceMappingURL=index.js.map

package/dist/icons/inlineIconMarker.js

@@ -4,7 +4,7 @@ import {
   iconMarker,
   splitIconMarkers,
   stripIconMarkers
-} from "../chunk-2UQOHYE2.js";
+} from "../chunk-7ZAAICW4.js";
 export {
   hasIconMarker,
   iconClass,
@@ -12,4 +12,3 @@ export {
   splitIconMarkers,
   stripIconMarkers
 };
-//# sourceMappingURL=inlineIconMarker.js.map

package/dist/imageEdit/index.d.ts

@@ -1,9 +1,9 @@
-import { a as ImageEditDoc, b as ImageEditLayer } from '../ImageEditDoc-D828IXJ1.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-D828IXJ1.js';
-import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
-import { V as Version, C as CoalesceOptions, P as PrunePolicy } from '../types-C4kiRn_k.js';
-import '../Doc-ylqWKDc_.js';
-import '../types-BwMPl2CB.js';
+import { a as ImageEditDoc, b as ImageEditLayer } from '../ImageEditDoc-CGxk5CHc.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-CGxk5CHc.js';
+import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
+import { V as Version, C as CoalesceOptions, P as PrunePolicy } from '../types-8QjefM9J.js';
+import '../Doc-BubIpWsp.js';
+import '../types-CUNc9biN.js';
 
 /**
  * Pure helpers for constructing and mutating {@link ImageEditDoc} values.
@@ -129,12 +129,42 @@ interface RevertImageEditOptions {
     snapshotCurrent?: boolean;
     /** Override the source filename. Defaults to `state.json`. */
     stateFilename?: string;
+    /**
+     * State to capture as the pre-revert snapshot. Hosts holding unsaved
+     * in-memory edits MUST pass it: without it the snapshot reads
+     * `state.json` from the container, which is stale whenever the editor
+     * has not flushed. Ignored when `snapshotCurrent` is `false`.
+     */
+    doc?: ImageEditDoc;
+}
+/**
+ * Why a {@link revertToImageEditVersion} call declined to revert.
+ *
+ * - `'missing-snapshot'` — the requested version could not be read.
+ * - `'snapshot-failed'`  — the pre-revert snapshot could not be written, so
+ *   reverting would have destroyed the current state irrecoverably.
+ */
+type RevertImageEditFailureReason = 'missing-snapshot' | 'snapshot-failed';
+/** Result of a {@link revertToImageEditVersion} call. */
+interface RevertImageEditResult {
+    reverted: boolean;
+    snapshotted: Version | null;
+    /** Present only when `reverted` is false. */
+    reason?: RevertImageEditFailureReason;
 }
 /** List image-edit snapshots in the sidecar, newest-first. */
 declare function listImageEditVersions(container: ContentContainer, basename?: string): Promise<Version[]>;
 /** Read a snapshot's JSON text. Returns `null` if the snapshot is missing. */
 declare function readImageEditVersionText(container: ContentContainer, version: Version | string): Promise<string | null>;
-/** Read and parse a snapshot. Returns `null` if missing. */
+/**
+ * Read and parse a snapshot. Returns `null` if missing.
+ *
+ * A snapshot that EXISTS but is malformed throws rather than returning null:
+ * `null` means "no such version", and conflating the two let
+ * {@link revertToImageEditVersion} write garbage into `state.json` — wedging
+ * the editor on a file that loaded fine before the revert. Throwing here means
+ * the revert aborts and the current state survives.
+ */
 declare function readImageEditVersion(container: ContentContainer, version: Version | string): Promise<ImageEditDoc | null>;
 /**
  * Snapshot the current image-editor state if it differs from the latest
@@ -146,11 +176,15 @@ declare function readImageEditVersion(container: ContentContainer, version: Vers
  * structural compare.
  */
 declare function saveImageEditVersion(container: ContentContainer, options?: SaveImageEditVersionOptions): Promise<SaveImageEditVersionResult>;
-/** Revert `state.json` to a prior snapshot. Snapshots the current state first by default. */
-declare function revertToImageEditVersion(container: ContentContainer, version: Version | string, options?: RevertImageEditOptions): Promise<{
-    reverted: boolean;
-    snapshotted: Version | null;
-}>;
+/**
+ * Revert `state.json` to a prior snapshot. Snapshots the current state first
+ * by default.
+ *
+ * When that snapshot cannot be written, the revert is ABANDONED rather than
+ * performed unrecoverably — losing the current state is a worse outcome than
+ * a revert that didn't happen. Mirrors `revertToVersion` in `versions/`.
+ */
+declare function revertToImageEditVersion(container: ContentContainer, version: Version | string, options?: RevertImageEditOptions): Promise<RevertImageEditResult>;
 /** Delete snapshots that don't satisfy the policy. */
 declare function pruneImageEditVersions(container: ContentContainer, policy: PrunePolicy, basename?: string): Promise<Version[]>;
 /** Collapse adjacent snapshots within `windowMs`, keeping the newer of each pair. */
@@ -176,10 +210,7 @@ declare class ImageEditVersionManager {
     saveVersion(options?: SaveImageEditVersionOptions): Promise<SaveImageEditVersionResult>;
     listVersions(): Promise<Version[]>;
     readVersion(version: Version | string): Promise<ImageEditDoc | null>;
-    revertToVersion(version: Version | string, options?: RevertImageEditOptions): Promise<{
-        reverted: boolean;
-        snapshotted: Version | null;
-    }>;
+    revertToVersion(version: Version | string, options?: RevertImageEditOptions): Promise<RevertImageEditResult>;
     pruneVersions(policy: PrunePolicy): Promise<Version[]>;
     coalesceVersions(options?: CoalesceOptions): Promise<Version[]>;
 }
@@ -222,4 +253,4 @@ declare function exportImageEditDoc(doc: ImageEditDoc, container: ContentContain
  */
 declare function buildSvgString(doc: ImageEditDoc, container: ContentContainer): Promise<string>;
 
-export { IMAGE_EDIT_ASSETS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_VERSIONS_PREFIX, ImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, ImageEditLayer, ImageEditVersionManager, type ImageEditVersionManagerOptions, type RevertImageEditOptions, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, addLayer, buildImageEditVersionPath, buildSvgString, coalesceImageEditVersions, createEmptyImageEditDoc, exportImageEditDoc, listImageEditVersions, parseImageEditVersionPath, pruneImageEditVersions, readImageEditDoc, readImageEditVersion, readImageEditVersionText, removeLayer, reorderLayer, revertToImageEditVersion, saveImageEditVersion, setCanvas, touch, updateLayer, writeImageEditDoc };
+export { IMAGE_EDIT_ASSETS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_VERSIONS_PREFIX, ImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, ImageEditLayer, ImageEditVersionManager, type ImageEditVersionManagerOptions, type RevertImageEditFailureReason, type RevertImageEditOptions, type RevertImageEditResult, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, addLayer, buildImageEditVersionPath, buildSvgString, coalesceImageEditVersions, createEmptyImageEditDoc, exportImageEditDoc, listImageEditVersions, parseImageEditVersionPath, pruneImageEditVersions, readImageEditDoc, readImageEditVersion, readImageEditVersionText, removeLayer, reorderLayer, revertToImageEditVersion, saveImageEditVersion, setCanvas, touch, updateLayer, writeImageEditDoc };