@bendyline/squisq 2.0.0 → 2.1.0

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   reanchorSession,
   traceWordPosAt,
   vadStep
-} from "./chunk-T3TI7GSZ.js";
+} from "./chunk-XNLB57UD.js";
 import "./chunk-ET53IIEP.js";
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
@@ -34,7 +34,7 @@ import {
   getTransformStyleIds,
   getTransformStyleSummaries,
   resolveTransformStyle
-} from "./chunk-PXLVXTLW.js";
+} from "./chunk-ILWDXLUK.js";
 import {
   extractContent,
   mapElementToBlock,
@@ -69,7 +69,7 @@ import {
   resolveRef,
   setByPointer,
   toPointer
-} from "./chunk-QTSJOY54.js";
+} from "./chunk-VYFRI7R6.js";
 import {
   IMAGE_EDIT_ASSETS_PREFIX,
   IMAGE_EDIT_DEFAULT_BASENAME,
@@ -122,7 +122,7 @@ import {
   getSegmentAtTime,
   parseTheme,
   serializeTheme
-} from "./chunk-LYNJEOAC.js";
+} from "./chunk-QUUPYOSP.js";
 import {
   calculateBearing,
   decodeGeohash,
@@ -136,7 +136,10 @@ import {
   haversineDistance
 } from "./chunk-GZY66SDN.js";
 import {
+  PAGE_BASE_CSS,
   applyNarrationTiming,
+  buildPageCss,
+  buildPageCssVars,
   cssFilterForTreatment,
   docToMarkdown,
   getAnimationProgress,
@@ -144,16 +147,23 @@ import {
   getDefaultAnimationDuration,
   getTransitionClass,
   isRepairableDiagram,
+  isTemplatedPageBlock,
+  materializePageSection,
+  materializePageSections,
+  pageStyleDataAttributes,
   renderAsciiDiagram,
   renderAsciiTimeline,
   renderTree,
   repairAsciiDiagram,
   resolveAudioMapping,
+  resolvePageBlock,
+  resolvePageStyle,
   resolveThemeForDoc,
   scoreTextSimilarity,
+  sectionExtractors,
   validateMarkdownDoc,
   validateMarkdownSource
-} from "./chunk-QVANWDPH.js";
+} from "./chunk-OTKVFVL6.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -274,7 +284,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-GF3BVNLU.js";
+} from "./chunk-JI77MGAK.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -314,9 +324,10 @@ import {
   recommendTemplatesForBlock
 } from "./chunk-5UYI3RJB.js";
 import {
+  defaultPageStyle,
   getDocPlaybackDuration,
   resolveMediaSchedule
-} from "./chunk-FVJUUTEM.js";
+} from "./chunk-VWCJ2WXC.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -326,6 +337,24 @@ import {
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
   LIGHT_SURFACE,
+  PAGE_ACCENT_STRATEGIES,
+  PAGE_BACKGROUNDS,
+  PAGE_BACKGROUND_RHYTHMS,
+  PAGE_DESIGN_FAMILIES,
+  PAGE_DIVIDERS,
+  PAGE_EMPHASES,
+  PAGE_EYEBROWS,
+  PAGE_HEADING_CASES,
+  PAGE_HEADING_SCALES,
+  PAGE_HEADING_UNDERLINES,
+  PAGE_HERO_STYLES,
+  PAGE_IMAGE_FRAMINGS,
+  PAGE_NUMERAL_STYLES,
+  PAGE_PATTERNS,
+  PAGE_QUOTE_MARKS,
+  PAGE_SECTION_KINDS,
+  PAGE_SECTION_SPACINGS,
+  PAGE_SHADOWS,
   THEMES,
   THEME_SCHEMA_VERSION,
   applySurface,
@@ -352,7 +381,7 @@ import {
   resolveTheme,
   validateTheme,
   withAlpha
-} from "./chunk-6PJRB2CF.js";
+} from "./chunk-JHZWYRSW.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -500,6 +529,25 @@ export {
   LocalStorageAdapter,
   MemoryContentContainer,
   MemoryStorageAdapter,
+  PAGE_ACCENT_STRATEGIES,
+  PAGE_BACKGROUNDS,
+  PAGE_BACKGROUND_RHYTHMS,
+  PAGE_BASE_CSS,
+  PAGE_DESIGN_FAMILIES,
+  PAGE_DIVIDERS,
+  PAGE_EMPHASES,
+  PAGE_EYEBROWS,
+  PAGE_HEADING_CASES,
+  PAGE_HEADING_SCALES,
+  PAGE_HEADING_UNDERLINES,
+  PAGE_HERO_STYLES,
+  PAGE_IMAGE_FRAMINGS,
+  PAGE_NUMERAL_STYLES,
+  PAGE_PATTERNS,
+  PAGE_QUOTE_MARKS,
+  PAGE_SECTION_KINDS,
+  PAGE_SECTION_SPACINGS,
+  PAGE_SHADOWS,
   PATH_SHAPE_KINDS,
   SHAPE_NAMES,
   STARTER_THEME,
@@ -539,6 +587,8 @@ export {
   buildJsonFormTokens,
   buildNarrationScript,
   buildNarrationTimingJson,
+  buildPageCss,
+  buildPageCssVars,
   buildRegistry,
   buildSvgString,
   buildVersionPath,
@@ -583,6 +633,7 @@ export {
   dataTable,
   dateEvent,
   decodeGeohash,
+  defaultPageStyle,
   definitionCard,
   deriveColorPalette,
   deriveScale,
@@ -701,6 +752,7 @@ export {
   isRepairableDiagram,
   isShapeName,
   isTemplateBlock,
+  isTemplatedPageBlock,
   isTransitionType,
   isTreeFence,
   isWrappedFlowTimelineSource,
@@ -721,6 +773,8 @@ export {
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
   materializeBlockLayers,
+  materializePageSection,
+  materializePageSections,
   narrationSessionStep,
   nearestSnapPoint,
   needsQuoting,
@@ -732,6 +786,7 @@ export {
   oklchLighten,
   oklchSetChroma,
   pacingStep,
+  pageStyleDataAttributes,
   parseAsciiDiagram,
   parseAsciiTimeline,
   parseAsciiTimelineWithStats,
@@ -786,6 +841,8 @@ export {
   resolveIcon,
   resolveJsonFormTheme,
   resolveMediaSchedule,
+  resolvePageBlock,
+  resolvePageStyle,
   resolvePersistentLayers,
   resolveRef,
   resolveTemplateName,
@@ -804,6 +861,7 @@ export {
   scaledFontSize2 as scaledFontSize,
   scopeContainer,
   scoreTextSimilarity,
+  sectionExtractors,
   sectionHeader,
   serializePandocAttributes,
   serializeTheme,

package/dist/jsonForm/index.d.ts

@@ -1,4 +1,4 @@
-import { aC as Theme, as as SurfaceScheme } from '../Doc-ylqWKDc_.js';
+import { b1 as Theme, aT as SurfaceScheme } from '../Doc-DynJleo-.js';
 import '../types-BwMPl2CB.js';
 
 /**

package/dist/jsonForm/index.js

@@ -14,10 +14,10 @@ import {
   resolveRef,
   setByPointer,
   toPointer
-} from "../chunk-QTSJOY54.js";
-import "../chunk-LYNJEOAC.js";
-import "../chunk-FVJUUTEM.js";
-import "../chunk-6PJRB2CF.js";
+} from "../chunk-VYFRI7R6.js";
+import "../chunk-QUUPYOSP.js";
+import "../chunk-VWCJ2WXC.js";
+import "../chunk-JHZWYRSW.js";
 import "../chunk-5J4HKRJF.js";
 import "../chunk-QE7TWGVT.js";
 export {

package/dist/materializePageSection-DDzubQXo.d.ts

@@ -0,0 +1,223 @@
+import { B as Block, at as PageSectionKind, ar as PageEmphasis, b3 as ThemeColorScheme, ap as PageBackground, b1 as Theme, bq as ViewportConfig, p as CustomTemplateDefinition, aR as StartBlockConfig, F as Doc, b4 as ThemePageStyle } from './Doc-DynJleo-.js';
+import { M as MarkdownBlockNode } from './types-BwMPl2CB.js';
+
+/**
+ * PageSection — the framework-agnostic block model for Page (linear) mode.
+ *
+ * Where `materializeBlockLayers` turns a block into fixed-viewport SVG
+ * `Layer[]` (slides, video frames, spatial canvases), `materializePageSection`
+ * turns the same block into a `PageSection`: a variable-height, content-slot
+ * description that HTML renderers lay out reflowably. React's page view and
+ * any string-HTML exporter consume this same structure, so neither re-derives
+ * content from blocks.
+ *
+ * Inherently spatial content (diagram/tree/timeline/map/drawing/layout,
+ * authored layers, custom templates) stays SVG: those sections carry the
+ * source block in a `canvas` media slot and consumers embed the result of
+ * `materializeBlockLayers` responsively. Core never emits markup.
+ */
+
+/**
+ * Rich text content for a slot. `text` is always present (plain text);
+ * `markdown` carries the original body nodes when the block has them, so
+ * renderers can show real rich text with the plain string as fallback.
+ */
+interface PageRichText {
+    text: string;
+    markdown?: MarkdownBlockNode[];
+}
+/** Which spatial pipeline a canvas-embed section renders through. */
+type PageSpatialKind = 'diagram' | 'tree' | 'timeline' | 'map' | 'drawing' | 'layout' | 'custom' | 'authored';
+/** Media content for a section slot. */
+type PageMedia = {
+    type: 'image';
+    src: string;
+    alt: string;
+    credit?: string;
+    license?: string;
+    width?: number;
+    height?: number;
+} | {
+    type: 'video';
+    src: string;
+    posterSrc?: string;
+    alt: string;
+    clipStart?: number;
+    clipEnd?: number;
+    credit?: string;
+    license?: string;
+} | {
+    type: 'canvas';
+    spatial: PageSpatialKind;
+    /**
+     * The block to pass to `materializeBlockLayers` (already merged with
+     * derived inputs/params for annotated blocks). Read-only reference.
+     */
+    block: Block;
+    /** Intrinsic aspect for the responsive embed frame. */
+    aspect: {
+        width: number;
+        height: number;
+    };
+};
+/** One entry in a multi-item section (stats, cards, gallery tiles, list rows). */
+interface PageSectionItem {
+    title?: string;
+    body?: string;
+    /** Large numeral / value for stat and comparison items. */
+    value?: string | number;
+    media?: PageMedia;
+    /** Per-item color-scheme name (e.g. twoColumn halves). */
+    accentScheme?: string;
+}
+/** Structured diagnostics for sections that fell back (unknown template …). */
+interface PageSectionDiagnostic {
+    code: 'unknown-template';
+    template: string;
+    message: string;
+}
+/** Where a section's content came from. */
+type PageSectionSource = 'template' | 'prose' | 'authored' | 'custom-template' | 'cover' | 'fallback';
+/**
+ * One variable-height page section. The `kind` selects the layout family;
+ * `slots` carry the content; `emphasis`/`accent`/`background` carry the
+ * theme's art-direction decisions for this position in the sequence.
+ */
+interface PageSection {
+    kind: PageSectionKind;
+    /** Layout variant within the kind (e.g. quote-band: plain|display|full-bleed|editorial). */
+    variant?: string;
+    /** Source block id ('' for the synthesized cover hero). */
+    blockId: string;
+    /** Canonical source template id (post-alias); absent for prose/cover/authored. */
+    template?: string;
+    slots: {
+        /** Kicker text above the title (theme decides visibility/treatment). */
+        eyebrow?: string;
+        title?: string;
+        subtitle?: string;
+        body?: PageRichText;
+        /**
+         * Authored rich body nodes not consumed by the selected template. Page
+         * renderers place this after the template-specific layout so images,
+         * video/audio HTML, and Mermaid fences are never silently discarded.
+         */
+        richContent?: PageRichText;
+        media?: PageMedia;
+        items?: PageSectionItem[];
+        table?: {
+            headers: string[];
+            rows: string[][];
+            align?: (('left' | 'right' | 'center') | null)[];
+        };
+        milestone?: {
+            date: string;
+            description: string;
+            footer?: string;
+            mood?: 'neutral' | 'somber' | 'celebratory';
+        };
+        attribution?: string;
+        caption?: string;
+        /** Small print: source citation, term origin, comparison unit. */
+        meta?: string;
+        /** Heading depth for prose sections (1..6). */
+        headingLevel?: number;
+    };
+    emphasis: PageEmphasis;
+    /** Resolved accent for this section; block-level colorScheme wins over rotation. */
+    accent: {
+        schemeName?: string;
+        scheme?: ThemeColorScheme;
+        role: 'primary' | 'rotation' | 'block' | 'none';
+    };
+    background: PageBackground;
+    /** Pre-order position among this doc's sections. */
+    index: number;
+    totalSections: number;
+    /** Nesting depth of the source block (0 for top-level and the cover). */
+    depth: number;
+    source: PageSectionSource;
+    diagnostic?: PageSectionDiagnostic;
+    /** Freeform theme hints from pageStyle overrides (e.g. dropCap, frame). */
+    hints?: Record<string, string | number | boolean>;
+}
+/** Result wrapper mirroring `BlockLayerMaterialization`'s shape. */
+interface PageSectionMaterialization {
+    section: PageSection;
+    /** The source block; undefined for the synthesized cover hero. */
+    block?: Block;
+    source: PageSectionSource;
+    diagnostic?: PageSectionDiagnostic;
+}
+
+/**
+ * Canonical block-to-page-section materialization — the Page (linear) mode
+ * sibling of `materializeBlockLayers`.
+ *
+ * `materializePageSections(doc, …)` is the primary entry point: it walks the
+ * block tree pre-order, extracts a `PageSection` per block (cover hero,
+ * typed template sections, prose, canvas embeds, visible fallbacks), and
+ * then applies the theme's art direction across the sequence — background
+ * rhythm, accent rotation, and the emphasis curve are sequence-scoped
+ * decisions that per-block calls cannot make.
+ *
+ * Failures are data, not console side effects: an unknown template becomes
+ * a visible `callout` section with a structured diagnostic (mirroring
+ * `materializeBlockLayers`' fallback posture).
+ */
+
+/**
+ * Page-mode hints a transform style may carry (`TransformStyleConfig.page`).
+ * Defined here (not in `transform/`) so the doc pipeline stays independent
+ * of the transform module.
+ */
+interface PageTransformHints {
+    /** Overrides `pageStyle.tokens.sectionSpacing` for this rendition. */
+    spacing?: 'compact' | 'comfortable' | 'generous';
+    /** 'front-loaded' promotes the first sections' emphasis one step. */
+    emphasisCurve?: 'even' | 'front-loaded';
+}
+/** Options shared by the per-block and doc-level entry points. */
+interface MaterializePageSectionOptions {
+    /** Theme whose `pageStyle` art-directs the sections. */
+    theme?: Theme;
+    /** Aspect reference for canvas embeds. Defaults to the landscape preset. */
+    viewport?: ViewportConfig;
+    /** Zero-based position in the section sequence (per-block calls). */
+    blockIndex?: number;
+    /** Total sections in the sequence (per-block calls). */
+    totalBlocks?: number;
+    /** Document-scoped custom templates (render as canvas embeds). */
+    customTemplates?: readonly CustomTemplateDefinition[];
+}
+/** Doc-level options. */
+interface MaterializePageSectionsOptions extends MaterializePageSectionOptions {
+    /**
+     * Cover hero: pass the doc's `startBlock` to synthesize a leading hero
+     * section, `false`/undefined to omit. (The caller decides — the editor's
+     * Cover toggle maps here.)
+     */
+    cover?: StartBlockConfig | false;
+    /** Page hints from the active transform style, if any. */
+    transformPage?: PageTransformHints;
+}
+/**
+ * Resolve the effective page style for a theme: explicit `theme.pageStyle`
+ * wins, else a derived default. Transform hints overlay spacing.
+ * Never returns undefined.
+ */
+declare function resolvePageStyle(theme?: Theme, hints?: PageTransformHints): ThemePageStyle;
+/**
+ * Materialize one block in isolation. Sequence-scoped art direction
+ * (background rhythm, accent rotation, emphasis curve) does not apply —
+ * use `materializePageSections` for whole-document rendering.
+ */
+declare function materializePageSection(block: Block, options?: MaterializePageSectionOptions): PageSectionMaterialization;
+/**
+ * Materialize a whole document into its ordered page sections, applying
+ * the theme's art direction across the sequence. The primary entry point
+ * for Page (linear) mode renderers and exporters.
+ */
+declare function materializePageSections(doc: Doc, options?: MaterializePageSectionsOptions): PageSectionMaterialization[];
+
+export { type MaterializePageSectionOptions as M, type PageMedia as P, type MaterializePageSectionsOptions as a, type PageRichText as b, type PageSection as c, type PageSectionDiagnostic as d, type PageSectionItem as e, type PageSectionMaterialization as f, type PageSectionSource as g, type PageSpatialKind as h, type PageTransformHints as i, materializePageSections as j, materializePageSection as m, resolvePageStyle as r };

package/dist/narration/index.d.ts

@@ -1,4 +1,4 @@
-import { F as Doc, e as AudioBookmark } from '../Doc-ylqWKDc_.js';
+import { F as Doc, e as AudioBookmark } from '../Doc-DynJleo-.js';
 import '../types-BwMPl2CB.js';
 
 /**

package/dist/narration/index.js

@@ -23,7 +23,7 @@ import {
   reanchorSession,
   traceWordPosAt,
   vadStep
-} from "../chunk-T3TI7GSZ.js";
+} from "../chunk-XNLB57UD.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -33,10 +33,10 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-GF3BVNLU.js";
+} from "../chunk-JI77MGAK.js";
 import "../chunk-TUWMK62B.js";
 import "../chunk-5UYI3RJB.js";
-import "../chunk-6PJRB2CF.js";
+import "../chunk-JHZWYRSW.js";
 import "../chunk-5J4HKRJF.js";
 import "../chunk-R2YZTCLO.js";
 import "../chunk-AMIR72JP.js";

package/dist/schemas/index.d.ts

@@ -1,10 +1,35 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { aC as Theme, aE as ThemeColorScheme, v as DeepPartial, aH as ThemeSeedColors, aD as ThemeColorPalette, N as FontFamilyKind, M as FontFamily } from '../Doc-ylqWKDc_.js';
-export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AudioBookmark, f as AudioSegment, g as AudioTimingData, h as AudioTrack, B as Block, i as BlockConnection, j as BorderStyle, C as CaptionPhrase, k as CaptionTrack, l as CaptionWord, m as ColorScheme, n as ComparisonBarInput, o as CornerBrandingConfig, p as CustomTemplateDefinition, q as CustomTemplateLayer, D as DARK_SURFACE, r as DEFAULT_DOC_FONT, s as DEFAULT_TITLE_FONT, t as DataTableInput, u as DateEventInput, w as DefinitionCardInput, x as DiagramBlockInput, y as DiagramEdgeAnchor, z as DiagramTemplateEdge, E as DiagramTemplateNode, F as Doc, G as DocBlock, H as DocDiagnostic, I as DrawingBlockInput, J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, L as FactCardInput, O as FullBleedQuoteInput, P as GradientBackgroundConfig, Q as ImageBackgroundConfig, R as ImageLayer, S as ImageTreatment, T as ImageWithCaptionInput, U as LIGHT_SURFACE, V as Layer, W as LayerRepeat, X as LayoutHints, Y as LeftFeatureInput, Z as LinearGradient, _ as ListBlockInput, $ as MapBlockInput, a0 as MapLayer, a1 as MapMarker, a2 as MapTileStyle, a3 as MarkerStyle, a4 as MediaClip, a5 as PathLayer, a6 as PatternBackgroundConfig, a7 as PersistentLayer, a8 as PersistentLayerConfig, a9 as PersistentLayerTemplate, aa as PersistentLayerTemplateConfig, ab as PersistentLayerTemplateType, ac as PhotoGridInput, ad as Position, ae as ProgressIndicatorConfig, af as PullQuoteInput, ag as QuoteBlockInput, ah as RawLayersInput, ai as RenderStyle, aj as RightFeatureInput, ak as ScheduledClip, al as SectionHeaderInput, am as ShapeFilter, an as ShapeLayer, ao as ShapePattern, ap as SolidBackgroundConfig, aq as StartBlockConfig, ar as StatHighlightInput, as as SurfaceScheme, at as THEME_SCHEMA_VERSION, au as TableLayer, av as TableLayerStyle, aw as TemplateBlock, ax as TemplateContext, ay as TemplateFunction, az as TemplateRegistry, aA as TextLayer, aB as TextStyle, aF as ThemeRegistry, aG as ThemeSchemaVersion, aI as ThemeStyle, aJ as ThemeTypography, aK as TimelineBlockInput, aL as TimelineTemplateEvent, aM as TimelineTemplateLink, aN as TimelineTemplateTrack, aO as TitleBlockInput, aP as TitleCaptionConfig, aQ as TreeBlockInput, aR as TreeLayer, aS as TreeLayerItem, aT as TreeLayerStyle, aU as TreeTemplateItem, aV as TwoColumnInput, aW as VIEWPORT_PRESETS, aX as VideoLayer, aY as VideoPullQuoteInput, aZ as VideoWithCaptionInput, a_ as ViewportConfig, a$ as ViewportOrientation, b0 as ViewportPreset, b1 as VignetteConfig, b2 as applySurface, b3 as calculateDuration, b4 as calculateFontScale, b5 as createTemplateContext, b6 as createTheme, b7 as createThemeRegistry, b8 as getAspectRatioString, b9 as getBlockAtTime, ba as getCaptionAtTime, bb as getDocPlaybackDuration, bc as getLayoutHints, bd as getSafeTextBounds, be as getSegmentAtTime, bf as getTwoColumnPositions, bg as getViewport, bh as getViewportOrientation, bi as isPersistentLayerTemplate, bj as isTemplateBlock, bk as layoutScaledFontSize, bl as resolveMediaSchedule, bm as scaledFontSize } from '../Doc-ylqWKDc_.js';
+import { b1 as Theme, b4 as ThemePageStyle, b3 as ThemeColorScheme, v as DeepPartial, b7 as ThemeSeedColors, b2 as ThemeColorPalette, N as FontFamilyKind, M as FontFamily } from '../Doc-DynJleo-.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AudioBookmark, f as AudioSegment, g as AudioTimingData, h as AudioTrack, B as Block, i as BlockConnection, j as BorderStyle, C as CaptionPhrase, k as CaptionTrack, l as CaptionWord, m as ColorScheme, n as ComparisonBarInput, o as CornerBrandingConfig, p as CustomTemplateDefinition, q as CustomTemplateLayer, D as DARK_SURFACE, r as DEFAULT_DOC_FONT, s as DEFAULT_TITLE_FONT, t as DataTableInput, u as DateEventInput, w as DefinitionCardInput, x as DiagramBlockInput, y as DiagramEdgeAnchor, z as DiagramTemplateEdge, E as DiagramTemplateNode, F as Doc, G as DocBlock, H as DocDiagnostic, I as DrawingBlockInput, J as FRONTMATTER_CUSTOM_TEMPLATES_KEY, K as FRONTMATTER_CUSTOM_THEMES_KEY, L as FactCardInput, O as FullBleedQuoteInput, P as GradientBackgroundConfig, Q as ImageBackgroundConfig, R as ImageLayer, S as ImageTreatment, T as ImageWithCaptionInput, U as LIGHT_SURFACE, V as Layer, W as LayerRepeat, X as LayoutHints, Y as LeftFeatureInput, Z as LinearGradient, _ as ListBlockInput, $ as MapBlockInput, a0 as MapLayer, a1 as MapMarker, a2 as MapTileStyle, a3 as MarkerStyle, a4 as MediaClip, a5 as MermaidLayer, a6 as PAGE_ACCENT_STRATEGIES, a7 as PAGE_BACKGROUNDS, a8 as PAGE_BACKGROUND_RHYTHMS, a9 as PAGE_DESIGN_FAMILIES, aa as PAGE_DIVIDERS, ab as PAGE_EMPHASES, ac as PAGE_EYEBROWS, ad as PAGE_HEADING_CASES, ae as PAGE_HEADING_SCALES, af as PAGE_HEADING_UNDERLINES, ag as PAGE_HERO_STYLES, ah as PAGE_IMAGE_FRAMINGS, ai as PAGE_NUMERAL_STYLES, aj as PAGE_PATTERNS, ak as PAGE_QUOTE_MARKS, al as PAGE_SECTION_KINDS, am as PAGE_SECTION_SPACINGS, an as PAGE_SHADOWS, ao as PageAccentRotation, ap as PageBackground, aq as PageDesignFamily, ar as PageEmphasis, as as PageHeadingTreatment, at as PageSectionKind, au as PageSectionOverride, av as PageTokens, aw as PathLayer, ax as PatternBackgroundConfig, ay as PersistentLayer, az as PersistentLayerConfig, aA as PersistentLayerTemplate, aB as PersistentLayerTemplateConfig, aC as PersistentLayerTemplateType, aD as PhotoGridInput, aE as Position, aF as ProgressIndicatorConfig, aG as PullQuoteInput, aH as QuoteBlockInput, aI as RawLayersInput, aJ as RenderStyle, aK as RightFeatureInput, aL as ScheduledClip, aM as SectionHeaderInput, aN as ShapeFilter, aO as ShapeLayer, aP as ShapePattern, aQ as SolidBackgroundConfig, aR as StartBlockConfig, aS as StatHighlightInput, aT as SurfaceScheme, aU as THEME_SCHEMA_VERSION, aV as TableLayer, aW as TableLayerStyle, aX as TemplateBlock, aY as TemplateContext, aZ as TemplateFunction, a_ as TemplateRegistry, a$ as TextLayer, b0 as TextStyle, b5 as ThemeRegistry, b6 as ThemeSchemaVersion, b8 as ThemeStyle, b9 as ThemeTypography, ba as TimelineBlockInput, bb as TimelineTemplateEvent, bc as TimelineTemplateLink, bd as TimelineTemplateTrack, be as TitleBlockInput, bf as TitleCaptionConfig, bg as TreeBlockInput, bh as TreeLayer, bi as TreeLayerItem, bj as TreeLayerStyle, bk as TreeTemplateItem, bl as TwoColumnInput, bm as VIEWPORT_PRESETS, bn as VideoLayer, bo as VideoPullQuoteInput, bp as VideoWithCaptionInput, bq as ViewportConfig, br as ViewportOrientation, bs as ViewportPreset, bt as VignetteConfig, bu as applySurface, bv as calculateDuration, bw as calculateFontScale, bx as createTemplateContext, by as createTheme, bz as createThemeRegistry, bA as getAspectRatioString, bB as getBlockAtTime, bC as getCaptionAtTime, bD as getDocPlaybackDuration, bE as getLayoutHints, bF as getSafeTextBounds, bG as getSegmentAtTime, bH as getTwoColumnPositions, bI as getViewport, bJ as getViewportOrientation, bK as isPersistentLayerTemplate, bL as isTemplateBlock, bM as layoutScaledFontSize, bN as resolveMediaSchedule, bO as scaledFontSize } from '../Doc-DynJleo-.js';
 export { D as DEFAULT_TRANSITION_DURATION_SECONDS, X as TRANSITION_DIRECTIONS, Y as TRANSITION_TYPES, Z as Transition, _ as TransitionDirection, $ as TransitionType, a0 as isTransitionType, a1 as normalizeTransitionDirection, a2 as normalizeTransitionType, a3 as resolveBlockTransition, a4 as resolveTransitionDuration } from '../types-BwMPl2CB.js';
-export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-RjVgLpUi.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-B72m0W1y.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-D828IXJ1.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-Ca4Tr9uN.js';
+
+/**
+ * Page Style Defaults
+ *
+ * Derives a complete `ThemePageStyle` from a theme's existing fields so
+ * legacy themes, customizer themes, and file-inferred themes get a
+ * coherent page art direction without declaring one. Built-in themes
+ * ship explicit `pageStyle` blocks in their JSON; this derivation is the
+ * fallback used by `compileTheme` and by `resolvePageStyle` at read time.
+ *
+ * Derivation signals:
+ * - `renderStyle.name` → design family (documentary → documentary,
+ *   magazine → editorial, bold → brutalist, tech-dark → terminal, …)
+ * - `style.borderRadius` → cornerRadius + rounded vs flush image framing
+ * - `style.imageTreatment` (mono/duotone) → letterboxed framing
+ * - `style.textShadow` → shadow language
+ * - `persistentLayers` patternBackground → page pattern
+ */
+
+/**
+ * Derive a complete `ThemePageStyle` from a theme's existing fields.
+ * Deterministic and read-only; explicit `theme.pageStyle` always wins
+ * (callers check before deriving — see `resolvePageStyle`).
+ */
+declare function defaultPageStyle(theme: Theme): ThemePageStyle;
 
 /**
  * Theme Validator
@@ -227,4 +252,4 @@ declare function deriveScale(seedHex: string, spread?: number): {
     darker2: string;
 };
 
-export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha };
+export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemePageStyle, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha };

package/dist/schemas/index.js

@@ -9,11 +9,12 @@ import {
   getSegmentAtTime,
   parseTheme,
   serializeTheme
-} from "../chunk-LYNJEOAC.js";
+} from "../chunk-QUUPYOSP.js";
 import {
+  defaultPageStyle,
   getDocPlaybackDuration,
   resolveMediaSchedule
-} from "../chunk-FVJUUTEM.js";
+} from "../chunk-VWCJ2WXC.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -23,6 +24,24 @@ import {
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
   LIGHT_SURFACE,
+  PAGE_ACCENT_STRATEGIES,
+  PAGE_BACKGROUNDS,
+  PAGE_BACKGROUND_RHYTHMS,
+  PAGE_DESIGN_FAMILIES,
+  PAGE_DIVIDERS,
+  PAGE_EMPHASES,
+  PAGE_EYEBROWS,
+  PAGE_HEADING_CASES,
+  PAGE_HEADING_SCALES,
+  PAGE_HEADING_UNDERLINES,
+  PAGE_HERO_STYLES,
+  PAGE_IMAGE_FRAMINGS,
+  PAGE_NUMERAL_STYLES,
+  PAGE_PATTERNS,
+  PAGE_QUOTE_MARKS,
+  PAGE_SECTION_KINDS,
+  PAGE_SECTION_SPACINGS,
+  PAGE_SHADOWS,
   THEMES,
   THEME_SCHEMA_VERSION,
   applySurface,
@@ -49,7 +68,7 @@ import {
   resolveTheme,
   validateTheme,
   withAlpha
-} from "../chunk-6PJRB2CF.js";
+} from "../chunk-JHZWYRSW.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -89,6 +108,24 @@ export {
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
   FRONTMATTER_CUSTOM_THEMES_KEY,
   LIGHT_SURFACE,
+  PAGE_ACCENT_STRATEGIES,
+  PAGE_BACKGROUNDS,
+  PAGE_BACKGROUND_RHYTHMS,
+  PAGE_DESIGN_FAMILIES,
+  PAGE_DIVIDERS,
+  PAGE_EMPHASES,
+  PAGE_EYEBROWS,
+  PAGE_HEADING_CASES,
+  PAGE_HEADING_SCALES,
+  PAGE_HEADING_UNDERLINES,
+  PAGE_HERO_STYLES,
+  PAGE_IMAGE_FRAMINGS,
+  PAGE_NUMERAL_STYLES,
+  PAGE_PATTERNS,
+  PAGE_QUOTE_MARKS,
+  PAGE_SECTION_KINDS,
+  PAGE_SECTION_SPACINGS,
+  PAGE_SHADOWS,
   STARTER_THEME,
   THEMES,
   THEME_SCHEMA_VERSION,
@@ -106,6 +143,7 @@ export {
   createTemplateContext,
   createTheme,
   createThemeRegistry,
+  defaultPageStyle,
   deriveColorPalette,
   deriveScale,
   fontStack,

package/dist/{themeLibrary-RjVgLpUi.d.ts → themeLibrary-B72m0W1y.d.ts}

@@ -1,4 +1,4 @@
-import { aC as Theme, aF as ThemeRegistry } from './Doc-ylqWKDc_.js';
+import { b1 as Theme, b5 as ThemeRegistry } from './Doc-DynJleo-.js';
 
 /**
  * Built-in Theme Library

package/dist/transform/index.d.ts

@@ -1,15 +1,8 @@
-import { m as ColorScheme, F as Doc, B as Block } from '../Doc-ylqWKDc_.js';
+import { m as ColorScheme, F as Doc, B as Block } from '../Doc-DynJleo-.js';
+import { i as PageTransformHints } from '../materializePageSection-DDzubQXo.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-BwMPl2CB.js';
 
-/**
- * Transform Types
- *
- * Defines the type system for doc block transforms — algorithms that take
- * an existing Doc and produce a new Doc with blocks optimized for visual
- * presentation. Transforms are read-only on the input and deterministic.
- */
-
 /** Identifier for a built-in or caller-registered transform style. */
 type TransformStyleId = string;
 /** Summary info for UI dropdowns (mirrors getThemeSummaries pattern). */
@@ -79,6 +72,12 @@ interface TransformStyleConfig {
         /** Target promoted blocks per minute of content (e.g. 5). */
         slidesPerMinute?: number;
     };
+    /**
+     * Page (linear) mode hints for docs produced by this style. Consumers
+     * pass this as `MaterializePageSectionsOptions.transformPage` so the
+     * summarization strategy shapes the page rendition (spacing, emphasis).
+     */
+    page?: PageTransformHints;
 }
 /** Built-in id or a call-scoped declarative style definition. */
 type TransformStyleInput = TransformStyleId | TransformStyleConfig;

package/dist/transform/index.js

@@ -7,7 +7,7 @@ import {
   getTransformStyleIds,
   getTransformStyleSummaries,
   resolveTransformStyle
-} from "../chunk-PXLVXTLW.js";
+} from "../chunk-ILWDXLUK.js";
 import "../chunk-Q7LROV2H.js";
 import "../chunk-5J4HKRJF.js";
 import "../chunk-AMIR72JP.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",