@bendyline/squisq 2.0.1 → 2.2.0

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';
-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';
+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-BubIpWsp.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-BubIpWsp.js';
+export { a as DEFAULT_TRANSITION_DURATION_SECONDS, _ as TRANSITION_DIRECTIONS, $ as TRANSITION_TYPES, a0 as Transition, a1 as TransitionDirection, a2 as TransitionType, a5 as isTransitionType, a6 as normalizeTransitionDirection, a7 as normalizeTransitionType, a8 as resolveBlockTransition, aa as resolveTransitionDuration } from '../types-CUNc9biN.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-DU9mUmVl.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-CGxk5CHc.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-MMPBOUK7.js";
+} from "../chunk-CB45YGAM.js";
 import {
+  defaultPageStyle,
   getDocPlaybackDuration,
   resolveMediaSchedule
-} from "../chunk-FVJUUTEM.js";
+} from "../chunk-2ZWIXGAC.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-W4O2TX5I.js";
+} from "../chunk-C33GTPUZ.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -66,7 +85,7 @@ import {
   isTemplateBlock,
   scaledFontSize,
   scaledFontSize2
-} from "../chunk-5J4HKRJF.js";
+} from "../chunk-BAOV476U.js";
 import {
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,
@@ -76,7 +95,7 @@ import {
   normalizeTransitionType,
   resolveBlockTransition,
   resolveTransitionDuration
-} from "../chunk-QE7TWGVT.js";
+} from "../chunk-4VOD55SX.js";
 export {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -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,
@@ -148,4 +186,3 @@ export {
   validateTheme,
   withAlpha
 };
-//# sourceMappingURL=index.js.map

package/dist/spatial/index.d.ts

@@ -62,7 +62,8 @@ declare function decodeGeohash(hash: string): {
 declare function getNeighbors(hash: string): string[];
 /**
  * Get a 3x3 grid of geohash4 cells (center + 8 neighbors).
- * Used for landing bonus expansions in Fly mode.
+ * Useful for expanding a query to the cells adjacent to a center cell, so a
+ * point near a cell boundary still matches its neighbors' contents.
  *
  * @param geohash4 - Center geohash4 cell
  * @returns Array of 9 geohash4 cells (center first, then neighbors)

package/dist/spatial/index.js

@@ -9,7 +9,7 @@ import {
   getGeohashPrefix,
   getNeighbors,
   haversineDistance
-} from "../chunk-GZY66SDN.js";
+} from "../chunk-R3KTTOMS.js";
 export {
   calculateBearing,
   decodeGeohash,
@@ -22,4 +22,3 @@ export {
   getNeighbors,
   haversineDistance
 };
-//# sourceMappingURL=index.js.map

package/dist/storage/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ContentContainer, a as ContentEntry } from '../ContentContainer-BXUlIf18.js';
-export { M as MemoryContentContainer, f as findDocumentPath } from '../ContentContainer-BXUlIf18.js';
+import { C as ContentContainer, a as ContentEntry } from '../ContentContainer-B2w9sUoL.js';
+export { M as MemoryContentContainer, f as findDocumentPath } from '../ContentContainer-B2w9sUoL.js';
 import { a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
 
 /**
@@ -119,6 +119,8 @@ declare class ScopedContentContainer implements ContentContainer {
     readonly prefix: string;
     /** Prefix with trailing slash. */
     private readonly prefixSlash;
+    readonly mutationLock: object;
+    readonly writeFileExclusive?: (path: string, data: ArrayBuffer | Uint8Array, mimeType?: string) => Promise<boolean>;
     constructor(parent: ContentContainer, prefix: string);
     private toParent;
     /** Strip the prefix from a parent-space path. Returns null if the path is outside the scope. */

package/dist/storage/index.js

@@ -7,7 +7,7 @@ import {
   createMediaProviderFromContainer,
   findDocumentPath,
   scopeContainer
-} from "../chunk-VR7UPJ7C.js";
+} from "../chunk-FCG3BIZN.js";
 export {
   LocalForageAdapter,
   LocalStorageAdapter,
@@ -18,4 +18,3 @@ export {
   findDocumentPath,
   scopeContainer
 };
-//# sourceMappingURL=index.js.map

package/dist/{themeLibrary-RjVgLpUi.d.ts → themeLibrary-DU9mUmVl.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-BubIpWsp.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.js

@@ -1,8 +1,8 @@
-import "../chunk-DNJKBAI7.js";
+import "../chunk-YZNGMV3G.js";
 import {
   estimateNarrationTime,
   estimateReadingTime
-} from "../chunk-4X3JQXNM.js";
+} from "../chunk-XOFT65EX.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
@@ -10,7 +10,7 @@ import {
   estimateNarrationDuration,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "../chunk-3E5F2XMR.js";
+} from "../chunk-67L6WRJN.js";
 export {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
@@ -21,4 +21,3 @@ export {
   estimateSpokenWordCount,
   estimateTimeFromText
 };
-//# sourceMappingURL=index.js.map

package/dist/transform/index.d.ts

@@ -1,14 +1,7 @@
-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-BubIpWsp.js';
+import { i as PageTransformHints } from '../materializePageSection-wSLA2A1g.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.
- */
+import '../types-CUNc9biN.js';
 
 /** Identifier for a built-in or caller-registered transform style. */
 type TransformStyleId = string;
@@ -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,12 +7,12 @@ import {
   getTransformStyleIds,
   getTransformStyleSummaries,
   resolveTransformStyle
-} from "../chunk-PXLVXTLW.js";
-import "../chunk-Q7LROV2H.js";
-import "../chunk-5J4HKRJF.js";
-import "../chunk-AMIR72JP.js";
-import "../chunk-3E5F2XMR.js";
-import "../chunk-FVTQSNR7.js";
+} from "../chunk-RS5AP3J4.js";
+import "../chunk-NKNMGIIN.js";
+import "../chunk-BAOV476U.js";
+import "../chunk-BCCXTMN5.js";
+import "../chunk-67L6WRJN.js";
+import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
   analyzeBlocks,
@@ -23,4 +23,3 @@ export {
   getTransformStyleSummaries,
   resolveTransformStyle
 };
-//# sourceMappingURL=index.js.map

package/dist/{types-C4kiRn_k.d.ts → types-8QjefM9J.d.ts}

@@ -41,7 +41,7 @@ interface SaveVersionResult {
      * - `'saved'`        — a new snapshot was written.
      * - `'unchanged'`    — current content matches the latest snapshot byte-for-byte.
      * - `'no-document'`  — the container has no primary markdown document.
-     * - `'empty'`        — the resolved content was empty.
+     * - `'empty'`        — legacy value retained for source compatibility; no longer emitted.
      */
     reason: 'saved' | 'unchanged' | 'no-document' | 'empty';
 }
@@ -80,6 +80,42 @@ interface RevertOptions {
      * Defaults to `true` so a revert is always recoverable.
      */
     snapshotCurrent?: boolean;
+    /**
+     * Content to capture as the pre-revert snapshot. Hosts that keep the
+     * live document outside the container (an editor buffer, say) MUST pass
+     * it: without it the snapshot falls back to reading the container, which
+     * is stale whenever there are unsaved edits and yields `no-document`
+     * when the container holds no markdown at all. In both cases the
+     * pre-revert state would not actually be recoverable.
+     *
+     * Ignored when `snapshotCurrent` is `false`.
+     */
+    content?: string;
+    /**
+     * Override the document basename used to file the pre-revert snapshot.
+     * Defaults to the container's resolved primary document. Ignored when
+     * `snapshotCurrent` is `false`.
+     */
+    basename?: string;
+}
+/**
+ * Why a {@link revertToVersion} 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 RevertFailureReason = 'missing-snapshot' | 'snapshot-failed';
+/**
+ * Result of a {@link revertToVersion} call.
+ */
+interface RevertResult {
+    /** True when the document was replaced with the snapshot's content. */
+    reverted: boolean;
+    /** The pre-revert snapshot, when one was written. */
+    snapshotted: Version | null;
+    /** Present only when `reverted` is false. */
+    reason?: RevertFailureReason;
 }
 /**
  * Options for {@link coalesceVersions}.
@@ -92,4 +128,4 @@ interface CoalesceOptions {
     windowMs?: number;
 }
 
-export type { CoalesceOptions as C, PrunePolicy as P, RevertOptions as R, SaveVersionOptions as S, Version as V, SaveVersionResult as a };
+export type { CoalesceOptions as C, PrunePolicy as P, RevertFailureReason as R, SaveVersionOptions as S, Version as V, RevertOptions as a, RevertResult as b, SaveVersionResult as c };

package/dist/{types-BwMPl2CB.d.ts → types-CUNc9biN.d.ts}

@@ -1,3 +1,18 @@
+interface MarkdownSafetyLimits {
+    maxSourceBytes: number;
+    maxNodes: number;
+    maxDepth: number;
+    maxTableCells: number;
+}
+declare const DEFAULT_MARKDOWN_SAFETY_LIMITS: Readonly<MarkdownSafetyLimits>;
+declare class MarkdownLimitError extends RangeError {
+    readonly code: 'SOURCE_BYTES' | 'NODES' | 'DEPTH' | 'TABLE_CELLS';
+    constructor(code: MarkdownLimitError['code'], message: string);
+}
+declare function assertMarkdownSourceWithinLimits(source: string, limits: Partial<MarkdownSafetyLimits> | false | undefined): void;
+declare function assertMarkdownDocumentWithinLimits(document: MarkdownDocument, limits: Partial<MarkdownSafetyLimits> | false | undefined, signal?: AbortSignal): void;
+declare function resolveMarkdownSafetyLimits(limits?: Partial<MarkdownSafetyLimits>): MarkdownSafetyLimits;
+
 /**
  * Shared transition vocabulary for block-to-block slide changes.
  *
@@ -605,6 +620,10 @@ type MarkdownNode = MarkdownDocument | MarkdownBlockNode | MarkdownInlineNode |
  * Options for parseMarkdown().
  */
 interface ParseOptions {
+    /** Safety limits for untrusted input. Pass false only for trusted documents. */
+    limits?: Partial<MarkdownSafetyLimits> | false;
+    /** Cancel before parse and during post-parse validation. */
+    signal?: AbortSignal;
     /** Enable GFM extensions (tables, strikethrough, task lists, autolinks, footnotes). Default: true */
     gfm?: boolean;
     /** Enable math extensions ($...$ and $$...$$). Default: true */
@@ -620,6 +639,10 @@ interface ParseOptions {
  * Options for stringifyMarkdown().
  */
 interface StringifyOptions {
+    /** Safety limits for untrusted trees. Pass false only for trusted documents. */
+    limits?: Partial<MarkdownSafetyLimits> | false;
+    /** Cancel before serialization and during validation. */
+    signal?: AbortSignal;
     /** Enable GFM extensions in output. Default: true */
     gfm?: boolean;
     /** Enable math extensions in output. Default: true */
@@ -642,4 +665,4 @@ interface StringifyOptions {
     setext?: boolean;
 }
 
-export { type TransitionType as $, type MarkdownLinkDefinition as A, type MarkdownLinkReference as B, type MarkdownList as C, DEFAULT_TRANSITION_DURATION_SECONDS as D, type MarkdownListItem as E, type MarkdownMathBlock as F, type MarkdownMention as G, type HeadingAttributes as H, type MarkdownNode as I, type MarkdownParagraph as J, type MarkdownPoint as K, type MarkdownSourcePosition as L, type MarkdownBlockNode as M, type MarkdownStrikethrough as N, type MarkdownStrong as O, type MarkdownTable as P, type MarkdownTableCell as Q, type MarkdownTableRow as R, type MarkdownText as S, type MarkdownTextDirective as T, type MarkdownThematicBreak as U, type ParseOptions as V, type StringifyOptions as W, TRANSITION_DIRECTIONS as X, TRANSITION_TYPES as Y, type Transition as Z, type TransitionDirection as _, type HeadingTemplateAnnotation as a, isTransitionType as a0, normalizeTransitionDirection as a1, normalizeTransitionType as a2, resolveBlockTransition as a3, resolveTransitionDuration as a4, type BlockConnection as a5, type HtmlComment as b, type HtmlElement as c, type HtmlNode as d, type HtmlText as e, type MarkdownBlockquote as f, type MarkdownBreak as g, type MarkdownCodeBlock as h, type MarkdownContainerDirective as i, type MarkdownDefinitionDescription as j, type MarkdownDefinitionList as k, type MarkdownDefinitionTerm as l, type MarkdownDocument as m, type MarkdownEmphasis as n, type MarkdownFootnoteDefinition as o, type MarkdownFootnoteReference as p, type MarkdownHeading as q, type MarkdownHtmlBlock as r, type MarkdownImage as s, type MarkdownImageReference as t, type MarkdownInlineCode as u, type MarkdownInlineHtml as v, type MarkdownInlineMath as w, type MarkdownInlineNode as x, type MarkdownLeafDirective as y, type MarkdownLink as z };
+export { TRANSITION_TYPES as $, MarkdownLimitError as A, type MarkdownLink as B, type MarkdownLinkDefinition as C, DEFAULT_MARKDOWN_SAFETY_LIMITS as D, type MarkdownLinkReference as E, type MarkdownList as F, type MarkdownListItem as G, type HeadingAttributes as H, type MarkdownMathBlock as I, type MarkdownMention as J, type MarkdownNode as K, type MarkdownParagraph as L, type MarkdownBlockNode as M, type MarkdownPoint as N, type MarkdownSafetyLimits as O, type MarkdownSourcePosition as P, type MarkdownStrikethrough as Q, type MarkdownStrong as R, type MarkdownTable as S, type MarkdownTableCell as T, type MarkdownTableRow as U, type MarkdownText as V, type MarkdownTextDirective as W, type MarkdownThematicBreak as X, type ParseOptions as Y, type StringifyOptions as Z, TRANSITION_DIRECTIONS as _, DEFAULT_TRANSITION_DURATION_SECONDS as a, type Transition as a0, type TransitionDirection as a1, type TransitionType as a2, assertMarkdownDocumentWithinLimits as a3, assertMarkdownSourceWithinLimits as a4, isTransitionType as a5, normalizeTransitionDirection as a6, normalizeTransitionType as a7, resolveBlockTransition as a8, resolveMarkdownSafetyLimits as a9, resolveTransitionDuration as aa, type BlockConnection as ab, type HeadingTemplateAnnotation as b, type HtmlComment as c, type HtmlElement as d, type HtmlNode as e, type HtmlText as f, type MarkdownBlockquote as g, type MarkdownBreak as h, type MarkdownCodeBlock as i, type MarkdownContainerDirective as j, type MarkdownDefinitionDescription as k, type MarkdownDefinitionList as l, type MarkdownDefinitionTerm as m, type MarkdownDocument as n, type MarkdownEmphasis as o, type MarkdownFootnoteDefinition as p, type MarkdownFootnoteReference as q, type MarkdownHeading as r, type MarkdownHtmlBlock as s, type MarkdownImage as t, type MarkdownImageReference as u, type MarkdownInlineCode as v, type MarkdownInlineHtml as w, type MarkdownInlineMath as x, type MarkdownInlineNode as y, type MarkdownLeafDirective as z };

package/dist/versions/index.d.ts

@@ -1,5 +1,6 @@
-import { C as CoalesceOptions, V as Version, P as PrunePolicy, R as RevertOptions, S as SaveVersionOptions, a as SaveVersionResult } from '../types-C4kiRn_k.js';
-import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
+import { C as CoalesceOptions, V as Version, P as PrunePolicy, a as RevertOptions, b as RevertResult, S as SaveVersionOptions, c as SaveVersionResult } from '../types-8QjefM9J.js';
+export { R as RevertFailureReason } from '../types-8QjefM9J.js';
+import { C as ContentContainer } from '../ContentContainer-B2w9sUoL.js';
 
 /**
  * Pure-ish version operations against a {@link ContentContainer}.
@@ -28,11 +29,16 @@ declare function saveVersion(container: ContentContainer, options?: SaveVersionO
 /**
  * Revert the document to a prior snapshot. By default, the *current*
  * document is snapshotted first so the revert is itself recoverable.
+ *
+ * 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. Callers that have already
+ * preserved the current state themselves should pass
+ * `snapshotCurrent: false`; callers whose live document lives outside the
+ * container should pass `content` so the right bytes get snapshotted (see
+ * {@link RevertOptions.content}).
  */
-declare function revertToVersion(container: ContentContainer, version: Version | string, options?: RevertOptions): Promise<{
-    reverted: boolean;
-    snapshotted: Version | null;
-}>;
+declare function revertToVersion(container: ContentContainer, version: Version | string, options?: RevertOptions): Promise<RevertResult>;
 /**
  * Delete snapshots that don't satisfy the policy. Returns the deleted
  * versions in their original (newest-first) order.
@@ -66,10 +72,7 @@ declare class DocumentVersionManager {
     saveVersion(options?: SaveVersionOptions): Promise<SaveVersionResult>;
     listVersions(): Promise<Version[]>;
     readVersion(version: Version | string): Promise<string | null>;
-    revertToVersion(version: Version | string, options?: RevertOptions): Promise<{
-        reverted: boolean;
-        snapshotted: Version | null;
-    }>;
+    revertToVersion(version: Version | string, options?: RevertOptions): Promise<RevertResult>;
     pruneVersions(policy: PrunePolicy): Promise<Version[]>;
     coalesceVersions(options?: CoalesceOptions): Promise<Version[]>;
 }
@@ -126,4 +129,4 @@ declare function parseVersionPath(path: string): {
     collision: number;
 } | null;
 
-export { CoalesceOptions, DocumentVersionManager, type DocumentVersionManagerOptions, PrunePolicy, RevertOptions, SaveVersionOptions, SaveVersionResult, VERSIONS_PREFIX, VERSION_TIMESTAMP_PATTERN, Version, buildVersionPath, coalesceVersions, formatVersionTimestamp, getDocBasename, listVersions, parseVersionPath, parseVersionTimestamp, pruneVersions, readVersion, revertToVersion, saveVersion };
+export { CoalesceOptions, DocumentVersionManager, type DocumentVersionManagerOptions, PrunePolicy, RevertOptions, RevertResult, SaveVersionOptions, SaveVersionResult, VERSIONS_PREFIX, VERSION_TIMESTAMP_PATTERN, Version, buildVersionPath, coalesceVersions, formatVersionTimestamp, getDocBasename, listVersions, parseVersionPath, parseVersionTimestamp, pruneVersions, readVersion, revertToVersion, saveVersion };

package/dist/versions/index.js

@@ -10,12 +10,12 @@ import {
   readVersion,
   revertToVersion,
   saveVersion
-} from "../chunk-JOQYPRDZ.js";
+} from "../chunk-7YEZFHLS.js";
 import {
   VERSION_TIMESTAMP_PATTERN,
   formatVersionTimestamp,
   parseVersionTimestamp
-} from "../chunk-S7A5D7ZJ.js";
+} from "../chunk-OPO5K4DZ.js";
 export {
   DocumentVersionManager,
   VERSIONS_PREFIX,
@@ -32,4 +32,3 @@ export {
   revertToVersion,
   saveVersion
 };
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",
@@ -28,7 +28,9 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "src"
+    "!dist/**/*.map",
+    "LICENSE",
+    "NOTICE.md"
   ],
   "exports": {
     ".": {

package/dist/chunk-2PWOO4ZE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/jsonForm/chooseControl.ts","../src/jsonForm/pointer.ts","../src/jsonForm/evaluateWhen.ts","../src/jsonForm/inferSchema.ts","../src/jsonForm/tokens.ts"],"sourcesContent":["/**\n * Pick a `ControlKind` for a schema node. The single dispatcher used by\n * both `<JsonView>` and `<JsonEditor>` so view and edit modes always\n * agree on what each field _is_, even when their UIs differ.\n *\n * Order of precedence:\n *   1. Explicit `squisq.control` hint\n *   2. `format` keyword (color/date/time/datetime/markdown/textarea)\n *   3. Enum cardinality (segmented vs. combobox)\n *   4. Numeric range (slider when both min and max present)\n *   5. String length (multiline when maxLength > 200)\n *   6. Type-default (object/array/boolean/string/number)\n */\n\nimport type { ControlKind, SquisqAnnotatedSchema } from './types.js';\n\nconst ENUM_SEGMENTED_LIMIT = 4;\nconst MULTILINE_LENGTH_THRESHOLD = 200;\n\nexport function chooseControl(schema: SquisqAnnotatedSchema): ControlKind {\n  const hint = schema.squisq?.control;\n  if (hint) return hint;\n\n  const type = primaryType(schema);\n\n  if (schema.format && type === 'string') {\n    switch (schema.format) {\n      case 'color':\n        return 'color';\n      case 'date':\n        return 'date';\n      case 'time':\n        return 'time';\n      case 'date-time':\n        return 'datetime';\n      case 'markdown':\n        return 'richtext';\n      case 'textarea':\n        return 'multiline';\n    }\n  }\n\n  if (schema.enum && schema.enum.length > 0) {\n    return schema.enum.length <= ENUM_SEGMENTED_LIMIT ? 'segmented' : 'combobox';\n  }\n\n  if (schema.oneOf || schema.anyOf) return 'tabs';\n\n  switch (type) {\n    case 'array':\n      return arrayItemKind(schema) === 'object' ? 'card-stack' : 'chip-bin';\n    case 'object':\n      return 'group';\n    case 'boolean':\n      return 'toggle';\n    case 'integer':\n    case 'number':\n      return hasFiniteRange(schema) ? 'slider' : 'stepper';\n    case 'string':\n      if (typeof schema.maxLength === 'number' && schema.maxLength > MULTILINE_LENGTH_THRESHOLD) {\n        return 'multiline';\n      }\n      return 'text';\n    default:\n      return 'text';\n  }\n}\n\n/** Return the first concrete type of a schema, ignoring `null` for nullable shorthand. */\nexport function primaryType(schema: SquisqAnnotatedSchema): string | undefined {\n  const t = schema.type;\n  if (typeof t === 'string') return t;\n  if (Array.isArray(t)) return t.find((x) => x !== 'null');\n  return undefined;\n}\n\n/** Inspect `items` to decide whether an array holds objects or primitives. */\nexport function arrayItemKind(schema: SquisqAnnotatedSchema): 'object' | 'primitive' {\n  const items = Array.isArray(schema.items) ? schema.items[0] : schema.items;\n  if (!items) return 'primitive';\n  return primaryType(items) === 'object' ? 'object' : 'primitive';\n}\n\nfunction hasFiniteRange(schema: SquisqAnnotatedSchema): boolean {\n  const min = schema.minimum ?? schema.exclusiveMinimum;\n  const max = schema.maximum ?? schema.exclusiveMaximum;\n  return typeof min === 'number' && typeof max === 'number';\n}\n","/**\n * JSON Pointer helpers (RFC 6901) plus immutable get/set, plus a tiny\n * dotted-path normalizer so hosts can write `user.role` instead of\n * `/user/role`. `$ref` resolution is local-only (`#/$defs/Foo`).\n */\n\nimport type { SquisqAnnotatedSchema } from './types.js';\n\n/** Escape one object-member name for use as an RFC 6901 pointer segment. */\nexport function escapePointerSegment(segment: string): string {\n  return segment.replace(/~/g, '~0').replace(/\\//g, '~1');\n}\n\n/** Normalize a path to a JSON Pointer string. Accepts both forms. */\nexport function toPointer(path: string): string {\n  if (path === '') return '';\n  if (path.startsWith('/')) return path;\n  // Dotted form: split on `.` and escape per RFC 6901.\n  return '/' + path.split('.').map(escapePointerSegment).join('/');\n}\n\n/** Append one member name to a dotted path or validated JSON Pointer. */\nexport function appendPointer(base: string, segment: string): string {\n  const pointer = toPointer(base);\n  pointerSegments(pointer); // validate explicit pointer syntax before composing\n  return `${pointer}/${escapePointerSegment(segment)}`;\n}\n\n/** Split a JSON Pointer into decoded segments. Empty string → []. */\nexport function pointerSegments(pointer: string): string[] {\n  if (pointer === '') return [];\n  if (!pointer.startsWith('/')) {\n    throw new TypeError(`Invalid JSON Pointer ${JSON.stringify(pointer)}: expected \"\" or \"/...\"`);\n  }\n  return pointer\n    .slice(1)\n    .split('/')\n    .map((seg) => {\n      if (/~(?:[^01]|$)/.test(seg)) {\n        throw new TypeError(\n          `Invalid JSON Pointer ${JSON.stringify(pointer)}: \"~\" must be escaped as \"~0\"`,\n        );\n      }\n      return seg.replace(/~1/g, '/').replace(/~0/g, '~');\n    });\n}\n\n/** Parse the canonical array-index spelling used by JSON Pointer consumers. */\nfunction arrayIndex(segment: string): number | undefined {\n  if (!/^(?:0|[1-9]\\d*)$/.test(segment)) return undefined;\n  const index = Number(segment);\n  // 2^32 - 1 is the Array length sentinel, not an element index.\n  return Number.isSafeInteger(index) && index <= 0xffff_fffe ? index : undefined;\n}\n\nfunction ownValue(object: object, key: string): unknown {\n  return Object.prototype.hasOwnProperty.call(object, key)\n    ? (object as Record<string, unknown>)[key]\n    : undefined;\n}\n\n/** Define a data member without invoking Object.prototype.__proto__'s setter. */\nfunction setOwn(object: Record<string, unknown>, key: string, value: unknown): void {\n  Object.defineProperty(object, key, {\n    value,\n    enumerable: true,\n    configurable: true,\n    writable: true,\n  });\n}\n\n/** Read a value from data by path (dotted or pointer). Returns undefined if missing. */\nexport function getByPointer(data: unknown, path: string): unknown {\n  const segments = pointerSegments(toPointer(path));\n  let cur: unknown = data;\n  for (const seg of segments) {\n    if (cur === null || cur === undefined) return undefined;\n    if (Array.isArray(cur)) {\n      const idx = arrayIndex(seg);\n      if (idx === undefined || idx >= cur.length) return undefined;\n      cur = cur[idx];\n    } else if (typeof cur === 'object') {\n      cur = ownValue(cur, seg);\n    } else {\n      return undefined;\n    }\n  }\n  return cur;\n}\n\n/**\n * Return a structurally-shared copy of `data` with the value at `path`\n * replaced. Intermediate objects/arrays are cloned along the path; the\n * rest is shared by reference. Creates intermediate objects if missing.\n */\nexport function setByPointer<T>(data: T, path: string, value: unknown): T {\n  const segments = pointerSegments(toPointer(path));\n  if (segments.length === 0) return value as T;\n  return setRec(data, segments, 0, value) as T;\n}\n\nfunction setRec(node: unknown, segments: string[], i: number, value: unknown): unknown {\n  const seg = segments[i];\n  const isLast = i === segments.length - 1;\n\n  // Decide whether the slot we're about to write into is an array index.\n  const nextSeg = isLast ? undefined : segments[i + 1];\n  const writingArrayChild = nextSeg !== undefined && arrayIndex(nextSeg) !== undefined;\n\n  if (Array.isArray(node)) {\n    const idx = arrayIndex(seg);\n    if (idx === undefined) {\n      throw new TypeError(`Invalid array index ${JSON.stringify(seg)} in JSON Pointer`);\n    }\n    const next = node.slice();\n    next[idx] = isLast\n      ? value\n      : setRec(node[idx] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);\n    return next;\n  }\n\n  const obj = (node && typeof node === 'object' ? { ...(node as object) } : {}) as Record<\n    string,\n    unknown\n  >;\n  const previous = ownValue(obj, seg);\n  setOwn(\n    obj,\n    seg,\n    isLast ? value : setRec(previous ?? (writingArrayChild ? [] : {}), segments, i + 1, value),\n  );\n  return obj;\n}\n\n/**\n * Resolve a local `$ref` (e.g. `#/$defs/Foo`) against the root schema.\n * Returns the original schema if no `$ref` is present, or `undefined`\n * if the reference cannot be resolved. Cross-document refs are not\n * supported.\n */\nexport function resolveRef(\n  schema: SquisqAnnotatedSchema,\n  root: SquisqAnnotatedSchema,\n): SquisqAnnotatedSchema | undefined {\n  if (!schema.$ref) return schema;\n  const ref = schema.$ref;\n  if (ref === '#') return root;\n  if (!ref.startsWith('#/')) return undefined;\n  try {\n    return getByPointer(root, ref.slice(1)) as SquisqAnnotatedSchema | undefined;\n  } catch {\n    return undefined;\n  }\n}\n","/**\n * Evaluate a `SquisqWhen` rule against the current root data. Pure;\n * renderers call this on every render with fresh data.\n */\n\nimport type { SquisqWhen } from './types.js';\nimport { getByPointer } from './pointer.js';\n\nexport function evaluateWhen(when: SquisqWhen, rootData: unknown): boolean {\n  const actual = getByPointer(rootData, when.field);\n\n  if (when.equals !== undefined) {\n    return deepEqual(actual, when.equals);\n  }\n  if (when.oneOf !== undefined) {\n    return when.oneOf.some((v) => deepEqual(actual, v));\n  }\n  if (when.matches !== undefined) {\n    if (typeof actual !== 'string') return false;\n    try {\n      return new RegExp(when.matches).test(actual);\n    } catch {\n      return false;\n    }\n  }\n  if (when.truthy !== undefined) {\n    return Boolean(actual) === when.truthy;\n  }\n  // No operator specified — defaults to \"field has any defined value\".\n  return actual !== undefined && actual !== null;\n}\n\n/**\n * Resolve a `boolean | SquisqWhen` flag (used by `hidden`/`disabled`)\n * to a final boolean. Literal booleans pass through.\n */\nexport function resolveFlag(flag: boolean | SquisqWhen | undefined, rootData: unknown): boolean {\n  if (flag === undefined) return false;\n  if (typeof flag === 'boolean') return flag;\n  return evaluateWhen(flag, rootData);\n}\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== typeof b) return false;\n  if (typeof a !== 'object') return false;\n  if (Array.isArray(a)) {\n    if (!Array.isArray(b) || a.length !== b.length) return false;\n    return a.every((v, i) => deepEqual(v, b[i]));\n  }\n  if (Array.isArray(b)) return false;\n  const ao = a as Record<string, unknown>;\n  const bo = b as Record<string, unknown>;\n  const ak = Object.keys(ao);\n  const bk = Object.keys(bo);\n  if (ak.length !== bk.length) return false;\n  return ak.every((k) => deepEqual(ao[k], bo[k]));\n}\n","/**\n * Infer a JSON Schema from an example JSON value. Thin facade over\n * `genson-js` so consumers don't depend on it directly and we can swap\n * the implementation later.\n */\n\nimport { createSchema, mergeSchemas } from 'genson-js';\nimport type { SquisqAnnotatedSchema } from './types.js';\n\nexport interface InferSchemaOptions {\n  /** Additional samples merged into the inferred schema for broader coverage. */\n  additionalSamples?: readonly unknown[];\n}\n\nexport function inferSchema(\n  sample: unknown,\n  options: InferSchemaOptions = {},\n): SquisqAnnotatedSchema {\n  const base = createSchema(sample) as SquisqAnnotatedSchema;\n  if (!options.additionalSamples || options.additionalSamples.length === 0) {\n    return base;\n  }\n  const extras = options.additionalSamples.map((s) => createSchema(s) as SquisqAnnotatedSchema);\n  return mergeSchemas([base, ...extras] as never[]) as SquisqAnnotatedSchema;\n}\n","/**\n * Pure CSS-custom-property builder shared by `<JsonView>` (read-only, in\n * `@bendyline/squisq-react`) and `<JsonEditor>` (editable, in\n * `@bendyline/squisq-editor-react`).\n *\n * Both components derive an identical token bag from a Theme + resolved\n * Surface; they differ only in the CSS-var prefix (`--squisq-json` vs\n * `--squisq-jsonform`) so the viewer and editor can coexist on one page.\n * This function is the single source of that derivation. It is pure and\n * framework-free: it performs no `window` / `matchMedia` access — the\n * surface must already be resolved to a concrete `SurfaceScheme` (or left\n * `undefined` to skip surface application) by the calling React hook.\n */\n\nimport { applySurface, DEFAULT_THEME, resolveFontFamily } from '../schemas/index.js';\nimport type { SurfaceScheme, Theme } from '../schemas/index.js';\n\nexport interface BuildJsonFormTokensOptions {\n  /**\n   * CSS-var prefix WITHOUT the trailing dash, e.g. `--squisq-json` or\n   * `--squisq-jsonform`. Each token key is `${prefix}-${name}`.\n   */\n  prefix: string;\n}\n\n/**\n * Build the CSS custom-property map for a JSON form/view surface.\n *\n * @param theme   The theme to render with (falls back to `DEFAULT_THEME`).\n * @param surface Already-resolved concrete surface, or `undefined` to leave\n *                the theme un-surfaced. (The `'auto'` → concrete resolution\n *                is the React hook's job, so this stays pure.)\n * @param options `{ prefix }` — the CSS-var namespace.\n */\nexport function buildJsonFormTokens(\n  theme: Theme | undefined,\n  surface: SurfaceScheme | undefined,\n  options: BuildJsonFormTokensOptions,\n): Record<string, string> {\n  const { prefix } = options;\n  const baseTheme = theme ?? DEFAULT_THEME;\n  const finalTheme = surface ? applySurface(baseTheme, surface) : baseTheme;\n\n  const titleFont = resolveFontFamily(finalTheme.typography.titleFont, 'system-ui, sans-serif');\n  const bodyFont = resolveFontFamily(finalTheme.typography.bodyFont, 'system-ui, sans-serif');\n  const monoFont = resolveFontFamily(\n    finalTheme.typography.monoFont,\n    'ui-monospace, Consolas, monospace',\n  );\n\n  return {\n    [`${prefix}-bg`]: finalTheme.colors.background,\n    [`${prefix}-text`]: finalTheme.colors.text,\n    [`${prefix}-muted`]: finalTheme.colors.textMuted,\n    [`${prefix}-primary`]: finalTheme.colors.primary,\n    [`${prefix}-accent`]: finalTheme.colors.secondary,\n    [`${prefix}-warning`]: finalTheme.colors.warning,\n    [`${prefix}-border`]: `color-mix(in srgb, ${finalTheme.colors.textMuted} 35%, transparent)`,\n    [`${prefix}-input-bg`]: finalTheme.colors.backgroundLight,\n    [`${prefix}-title-font`]: titleFont,\n    [`${prefix}-body-font`]: bodyFont,\n    [`${prefix}-mono-font`]: monoFont,\n    [`${prefix}-radius`]: `${finalTheme.style.borderRadius ?? 8}px`,\n  };\n}\n\n/**\n * Resolve the effective theme after surface application — the companion to\n * `buildJsonFormTokens` for callers that also need the `Theme` object (both\n * hooks return it alongside the style bag).\n */\nexport function resolveJsonFormTheme(\n  theme: Theme | undefined,\n  surface: SurfaceScheme | undefined,\n): Theme {\n  const baseTheme = theme ?? DEFAULT_THEME;\n  return surface ? applySurface(baseTheme, surface) : baseTheme;\n}\n"],"mappings":";;;;;;;AAgBA,IAAM,uBAAuB;AAC7B,IAAM,6BAA6B;AAE5B,SAAS,cAAc,QAA4C;AACxE,QAAM,OAAO,OAAO,QAAQ;AAC5B,MAAI,KAAM,QAAO;AAEjB,QAAM,OAAO,YAAY,MAAM;AAE/B,MAAI,OAAO,UAAU,SAAS,UAAU;AACtC,YAAQ,OAAO,QAAQ;AAAA,MACrB,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,IACX;AAAA,EACF;AAEA,MAAI,OAAO,QAAQ,OAAO,KAAK,SAAS,GAAG;AACzC,WAAO,OAAO,KAAK,UAAU,uBAAuB,cAAc;AAAA,EACpE;AAEA,MAAI,OAAO,SAAS,OAAO,MAAO,QAAO;AAEzC,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,cAAc,MAAM,MAAM,WAAW,eAAe;AAAA,IAC7D,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO,eAAe,MAAM,IAAI,WAAW;AAAA,IAC7C,KAAK;AACH,UAAI,OAAO,OAAO,cAAc,YAAY,OAAO,YAAY,4BAA4B;AACzF,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAGO,SAAS,YAAY,QAAmD;AAC7E,QAAM,IAAI,OAAO;AACjB,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO,EAAE,KAAK,CAAC,MAAM,MAAM,MAAM;AACvD,SAAO;AACT;AAGO,SAAS,cAAc,QAAuD;AACnF,QAAM,QAAQ,MAAM,QAAQ,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,IAAI,OAAO;AACrE,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,YAAY,KAAK,MAAM,WAAW,WAAW;AACtD;AAEA,SAAS,eAAe,QAAwC;AAC9D,QAAM,MAAM,OAAO,WAAW,OAAO;AACrC,QAAM,MAAM,OAAO,WAAW,OAAO;AACrC,SAAO,OAAO,QAAQ,YAAY,OAAO,QAAQ;AACnD;;;AC9EO,SAAS,qBAAqB,SAAyB;AAC5D,SAAO,QAAQ,QAAQ,MAAM,IAAI,EAAE,QAAQ,OAAO,IAAI;AACxD;AAGO,SAAS,UAAU,MAAsB;AAC9C,MAAI,SAAS,GAAI,QAAO;AACxB,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO;AAEjC,SAAO,MAAM,KAAK,MAAM,GAAG,EAAE,IAAI,oBAAoB,EAAE,KAAK,GAAG;AACjE;AAGO,SAAS,cAAc,MAAc,SAAyB;AACnE,QAAM,UAAU,UAAU,IAAI;AAC9B,kBAAgB,OAAO;AACvB,SAAO,GAAG,OAAO,IAAI,qBAAqB,OAAO,CAAC;AACpD;AAGO,SAAS,gBAAgB,SAA2B;AACzD,MAAI,YAAY,GAAI,QAAO,CAAC;AAC5B,MAAI,CAAC,QAAQ,WAAW,GAAG,GAAG;AAC5B,UAAM,IAAI,UAAU,wBAAwB,KAAK,UAAU,OAAO,CAAC,yBAAyB;AAAA,EAC9F;AACA,SAAO,QACJ,MAAM,CAAC,EACP,MAAM,GAAG,EACT,IAAI,CAAC,QAAQ;AACZ,QAAI,eAAe,KAAK,GAAG,GAAG;AAC5B,YAAM,IAAI;AAAA,QACR,wBAAwB,KAAK,UAAU,OAAO,CAAC;AAAA,MACjD;AAAA,IACF;AACA,WAAO,IAAI,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG;AAAA,EACnD,CAAC;AACL;AAGA,SAAS,WAAW,SAAqC;AACvD,MAAI,CAAC,mBAAmB,KAAK,OAAO,EAAG,QAAO;AAC9C,QAAM,QAAQ,OAAO,OAAO;AAE5B,SAAO,OAAO,cAAc,KAAK,KAAK,SAAS,aAAc,QAAQ;AACvE;AAEA,SAAS,SAAS,QAAgB,KAAsB;AACtD,SAAO,OAAO,UAAU,eAAe,KAAK,QAAQ,GAAG,IAClD,OAAmC,GAAG,IACvC;AACN;AAGA,SAAS,OAAO,QAAiC,KAAa,OAAsB;AAClF,SAAO,eAAe,QAAQ,KAAK;AAAA,IACjC;AAAA,IACA,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,UAAU;AAAA,EACZ,CAAC;AACH;AAGO,SAAS,aAAa,MAAe,MAAuB;AACjE,QAAM,WAAW,gBAAgB,UAAU,IAAI,CAAC;AAChD,MAAI,MAAe;AACnB,aAAW,OAAO,UAAU;AAC1B,QAAI,QAAQ,QAAQ,QAAQ,OAAW,QAAO;AAC9C,QAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,YAAM,MAAM,WAAW,GAAG;AAC1B,UAAI,QAAQ,UAAa,OAAO,IAAI,OAAQ,QAAO;AACnD,YAAM,IAAI,GAAG;AAAA,IACf,WAAW,OAAO,QAAQ,UAAU;AAClC,YAAM,SAAS,KAAK,GAAG;AAAA,IACzB,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,aAAgB,MAAS,MAAc,OAAmB;AACxE,QAAM,WAAW,gBAAgB,UAAU,IAAI,CAAC;AAChD,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,SAAO,OAAO,MAAM,UAAU,GAAG,KAAK;AACxC;AAEA,SAAS,OAAO,MAAe,UAAoB,GAAW,OAAyB;AACrF,QAAM,MAAM,SAAS,CAAC;AACtB,QAAM,SAAS,MAAM,SAAS,SAAS;AAGvC,QAAM,UAAU,SAAS,SAAY,SAAS,IAAI,CAAC;AACnD,QAAM,oBAAoB,YAAY,UAAa,WAAW,OAAO,MAAM;AAE3E,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,UAAM,MAAM,WAAW,GAAG;AAC1B,QAAI,QAAQ,QAAW;AACrB,YAAM,IAAI,UAAU,uBAAuB,KAAK,UAAU,GAAG,CAAC,kBAAkB;AAAA,IAClF;AACA,UAAM,OAAO,KAAK,MAAM;AACxB,SAAK,GAAG,IAAI,SACR,QACA,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,UAAU,IAAI,GAAG,KAAK;AAC7E,WAAO;AAAA,EACT;AAEA,QAAM,MAAO,QAAQ,OAAO,SAAS,WAAW,EAAE,GAAI,KAAgB,IAAI,CAAC;AAI3E,QAAM,WAAW,SAAS,KAAK,GAAG;AAClC;AAAA,IACE;AAAA,IACA;AAAA,IACA,SAAS,QAAQ,OAAO,aAAa,oBAAoB,CAAC,IAAI,CAAC,IAAI,UAAU,IAAI,GAAG,KAAK;AAAA,EAC3F;AACA,SAAO;AACT;AAQO,SAAS,WACd,QACA,MACmC;AACnC,MAAI,CAAC,OAAO,KAAM,QAAO;AACzB,QAAM,MAAM,OAAO;AACnB,MAAI,QAAQ,IAAK,QAAO;AACxB,MAAI,CAAC,IAAI,WAAW,IAAI,EAAG,QAAO;AAClC,MAAI;AACF,WAAO,aAAa,MAAM,IAAI,MAAM,CAAC,CAAC;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ACjJO,SAAS,aAAa,MAAkB,UAA4B;AACzE,QAAM,SAAS,aAAa,UAAU,KAAK,KAAK;AAEhD,MAAI,KAAK,WAAW,QAAW;AAC7B,WAAO,UAAU,QAAQ,KAAK,MAAM;AAAA,EACtC;AACA,MAAI,KAAK,UAAU,QAAW;AAC5B,WAAO,KAAK,MAAM,KAAK,CAAC,MAAM,UAAU,QAAQ,CAAC,CAAC;AAAA,EACpD;AACA,MAAI,KAAK,YAAY,QAAW;AAC9B,QAAI,OAAO,WAAW,SAAU,QAAO;AACvC,QAAI;AACF,aAAO,IAAI,OAAO,KAAK,OAAO,EAAE,KAAK,MAAM;AAAA,IAC7C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,KAAK,WAAW,QAAW;AAC7B,WAAO,QAAQ,MAAM,MAAM,KAAK;AAAA,EAClC;AAEA,SAAO,WAAW,UAAa,WAAW;AAC5C;AAMO,SAAS,YAAY,MAAwC,UAA4B;AAC9F,MAAI,SAAS,OAAW,QAAO;AAC/B,MAAI,OAAO,SAAS,UAAW,QAAO;AACtC,SAAO,aAAa,MAAM,QAAQ;AACpC;AAEA,SAAS,UAAU,GAAY,GAAqB;AAClD,MAAI,MAAM,EAAG,QAAO;AACpB,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,MAAI,OAAO,MAAM,OAAO,EAAG,QAAO;AAClC,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,MAAI,MAAM,QAAQ,CAAC,GAAG;AACpB,QAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAQ,QAAO;AACvD,WAAO,EAAE,MAAM,CAAC,GAAG,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;AAAA,EAC7C;AACA,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO;AAC7B,QAAM,KAAK;AACX,QAAM,KAAK;AACX,QAAM,KAAK,OAAO,KAAK,EAAE;AACzB,QAAM,KAAK,OAAO,KAAK,EAAE;AACzB,MAAI,GAAG,WAAW,GAAG,OAAQ,QAAO;AACpC,SAAO,GAAG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAChD;;;ACpDA,SAAS,cAAc,oBAAoB;AAQpC,SAAS,YACd,QACA,UAA8B,CAAC,GACR;AACvB,QAAM,OAAO,aAAa,MAAM;AAChC,MAAI,CAAC,QAAQ,qBAAqB,QAAQ,kBAAkB,WAAW,GAAG;AACxE,WAAO;AAAA,EACT;AACA,QAAM,SAAS,QAAQ,kBAAkB,IAAI,CAAC,MAAM,aAAa,CAAC,CAA0B;AAC5F,SAAO,aAAa,CAAC,MAAM,GAAG,MAAM,CAAY;AAClD;;;ACUO,SAAS,oBACd,OACA,SACA,SACwB;AACxB,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,YAAY,SAAS;AAC3B,QAAM,aAAa,UAAU,aAAa,WAAW,OAAO,IAAI;AAEhE,QAAM,YAAY,kBAAkB,WAAW,WAAW,WAAW,uBAAuB;AAC5F,QAAM,WAAW,kBAAkB,WAAW,WAAW,UAAU,uBAAuB;AAC1F,QAAM,WAAW;AAAA,IACf,WAAW,WAAW;AAAA,IACtB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,CAAC,GAAG,MAAM,KAAK,GAAG,WAAW,OAAO;AAAA,IACpC,CAAC,GAAG,MAAM,OAAO,GAAG,WAAW,OAAO;AAAA,IACtC,CAAC,GAAG,MAAM,QAAQ,GAAG,WAAW,OAAO;AAAA,IACvC,CAAC,GAAG,MAAM,UAAU,GAAG,WAAW,OAAO;AAAA,IACzC,CAAC,GAAG,MAAM,SAAS,GAAG,WAAW,OAAO;AAAA,IACxC,CAAC,GAAG,MAAM,UAAU,GAAG,WAAW,OAAO;AAAA,IACzC,CAAC,GAAG,MAAM,SAAS,GAAG,sBAAsB,WAAW,OAAO,SAAS;AAAA,IACvE,CAAC,GAAG,MAAM,WAAW,GAAG,WAAW,OAAO;AAAA,IAC1C,CAAC,GAAG,MAAM,aAAa,GAAG;AAAA,IAC1B,CAAC,GAAG,MAAM,YAAY,GAAG;AAAA,IACzB,CAAC,GAAG,MAAM,YAAY,GAAG;AAAA,IACzB,CAAC,GAAG,MAAM,SAAS,GAAG,GAAG,WAAW,MAAM,gBAAgB,CAAC;AAAA,EAC7D;AACF;AAOO,SAAS,qBACd,OACA,SACO;AACP,QAAM,YAAY,SAAS;AAC3B,SAAO,UAAU,aAAa,WAAW,OAAO,IAAI;AACtD;","names":[]}

package/dist/chunk-2UQOHYE2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/icons/inlineIconMarker.ts"],"sourcesContent":["/**\n * Inline-icon markers for template text.\n *\n * Slide templates flatten rich markdown body content into strings before\n * rendering. Inline icons need to survive that flattening step, so we encode\n * them as sentinel-delimited text markers and let `TextLayer` turn them back\n * into FontAwesome glyphs when rendering.\n */\n\nimport type { IconFamily } from './iconData.js';\n\n/**\n * Private-Use-Area sentinel that brackets an encoded icon.\n * Kept as an escape sequence so the source remains valid TypeScript text.\n */\nconst SENTINEL = '\\uE000';\n\n/** Matches one encoded marker: `<sentinel><family>:<name><sentinel>`. */\nconst MARKER_RE = new RegExp(`${SENTINEL}([a-z]+):([a-zA-Z0-9-]+)${SENTINEL}`, 'g');\n\n/** Encode a resolved icon (family + name) as an embeddable text marker. */\nexport function iconMarker(family: IconFamily, name: string): string {\n  return `${SENTINEL}${family}:${name}${SENTINEL}`;\n}\n\n/** True when a string contains at least one encoded icon marker. */\nexport function hasIconMarker(value: string): boolean {\n  return value.includes(SENTINEL);\n}\n\n/** Remove every icon marker, leaving a clean plain-text projection. */\nexport function stripIconMarkers(value: string): string {\n  return value.replace(MARKER_RE, '');\n}\n\n/** A run of a marker-bearing string: literal text or a resolved icon. */\nexport type IconTextRun =\n  | { type: 'text'; text: string }\n  | { type: 'icon'; family: IconFamily; name: string };\n\n/**\n * Split a string into ordered text/icon runs. Text between markers is\n * preserved verbatim, including whitespace; each marker becomes an icon run.\n */\nexport function splitIconMarkers(value: string): IconTextRun[] {\n  const runs: IconTextRun[] = [];\n  let lastIndex = 0;\n  MARKER_RE.lastIndex = 0;\n\n  let match: RegExpExecArray | null;\n  while ((match = MARKER_RE.exec(value)) !== null) {\n    if (match.index > lastIndex) {\n      runs.push({ type: 'text', text: value.slice(lastIndex, match.index) });\n    }\n    runs.push({\n      type: 'icon',\n      family: match[1] as IconFamily,\n      name: match[2],\n    });\n    lastIndex = match.index + match[0].length;\n  }\n\n  if (lastIndex < value.length) {\n    runs.push({ type: 'text', text: value.slice(lastIndex) });\n  }\n\n  return runs;\n}\n\n/** FontAwesome CSS class for a resolved icon, e.g. `fa-solid fa-rocket`. */\nexport function iconClass(family: IconFamily, name: string): string {\n  return `fa-${family} fa-${name}`;\n}\n"],"mappings":";AAeA,IAAM,WAAW;AAGjB,IAAM,YAAY,IAAI,OAAO,GAAG,QAAQ,2BAA2B,QAAQ,IAAI,GAAG;AAG3E,SAAS,WAAW,QAAoB,MAAsB;AACnE,SAAO,GAAG,QAAQ,GAAG,MAAM,IAAI,IAAI,GAAG,QAAQ;AAChD;AAGO,SAAS,cAAc,OAAwB;AACpD,SAAO,MAAM,SAAS,QAAQ;AAChC;AAGO,SAAS,iBAAiB,OAAuB;AACtD,SAAO,MAAM,QAAQ,WAAW,EAAE;AACpC;AAWO,SAAS,iBAAiB,OAA8B;AAC7D,QAAM,OAAsB,CAAC;AAC7B,MAAI,YAAY;AAChB,YAAU,YAAY;AAEtB,MAAI;AACJ,UAAQ,QAAQ,UAAU,KAAK,KAAK,OAAO,MAAM;AAC/C,QAAI,MAAM,QAAQ,WAAW;AAC3B,WAAK,KAAK,EAAE,MAAM,QAAQ,MAAM,MAAM,MAAM,WAAW,MAAM,KAAK,EAAE,CAAC;AAAA,IACvE;AACA,SAAK,KAAK;AAAA,MACR,MAAM;AAAA,MACN,QAAQ,MAAM,CAAC;AAAA,MACf,MAAM,MAAM,CAAC;AAAA,IACf,CAAC;AACD,gBAAY,MAAM,QAAQ,MAAM,CAAC,EAAE;AAAA,EACrC;AAEA,MAAI,YAAY,MAAM,QAAQ;AAC5B,SAAK,KAAK,EAAE,MAAM,QAAQ,MAAM,MAAM,MAAM,SAAS,EAAE,CAAC;AAAA,EAC1D;AAEA,SAAO;AACT;AAGO,SAAS,UAAU,QAAoB,MAAsB;AAClE,SAAO,MAAM,MAAM,OAAO,IAAI;AAChC;","names":[]}

package/dist/chunk-3E5F2XMR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/timing/narrationTiming.ts"],"sourcesContent":["/**\n * Narration timing estimation.\n *\n * Estimates how long text takes to speak aloud, accounting for:\n * - Numbers spoken as multiple words (e.g., \"1910\" → \"nineteen ten\")\n * - Pauses at commas\n * - Year pronunciation conventions (1000–2099)\n *\n * Ported from qualla-internal's AudioTiming.ts (pure functions, no Node.js deps).\n */\n\n/** Numbers are spoken more slowly than regular words (1.3× multiplier). */\nconst NUMBER_SPEAKING_MULTIPLIER = 1.3;\n\n/** Comma pause in \"word equivalents\" — speakers pause ~0.3 words at commas. */\nconst COMMA_PAUSE_PENALTY = 0.3;\n\n/** Default speaking rate in words per second (~150 WPM). */\nexport const DEFAULT_WORDS_PER_SECOND = 2.5;\n\n/**\n * Estimate how many \"spoken word equivalents\" a single token represents.\n * Numbers get expanded (e.g., \"175,000\" → ~5 words × 1.3 multiplier).\n */\nexport function estimateSpokenWordCount(token: string): number {\n  const cleaned = token.replace(/,/g, '');\n  const num = parseFloat(cleaned);\n\n  if (isNaN(num) || !isFinite(num)) {\n    return 1; // Not a number — count as 1 word\n  }\n\n  return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;\n}\n\n/**\n * Raw word count for a number (before the speaking multiplier).\n */\nfunction estimateNumberWordCount(cleaned: string, num: number): number {\n  // Handle decimals: \"3.14\" → words(\"3\") + \"point\" + 2 digits\n  if (cleaned.includes('.')) {\n    const [whole, decimal] = cleaned.split('.');\n    const wholeNum = parseFloat(whole) || 0;\n    return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;\n  }\n\n  const absNum = Math.abs(num);\n  let words = num < 0 ? 1 : 0; // \"negative\" / \"minus\"\n\n  if (absNum === 0) return 1; // \"zero\"\n\n  // Years (1000–2099) are spoken as two two-digit groups:\n  // \"1910\" → \"nineteen ten\", \"2024\" → \"twenty twenty-four\"\n  if (absNum >= 1000 && absNum <= 2099 && Number.isInteger(absNum)) {\n    const yearStr = absNum.toString();\n    if (yearStr.length === 4) {\n      const firstTwo = parseInt(yearStr.slice(0, 2));\n      const lastTwo = parseInt(yearStr.slice(2));\n\n      // First part\n      if (firstTwo >= 10 && firstTwo <= 19) {\n        words += 1;\n      } else if (firstTwo >= 20 && firstTwo <= 99) {\n        words += firstTwo % 10 === 0 ? 1 : 2;\n      } else {\n        words += 2; // \"two thousand\"\n      }\n\n      // Second part\n      if (lastTwo === 0) {\n        if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {\n          words += 1; // \"hundred\"\n        }\n      } else if (lastTwo >= 1 && lastTwo <= 9) {\n        words += 2; // \"oh five\"\n      } else if (lastTwo >= 10 && lastTwo <= 19) {\n        words += 1;\n      } else {\n        words += lastTwo % 10 === 0 ? 1 : 2;\n      }\n\n      return Math.max(words, 2);\n    }\n  }\n\n  // General number handling — each magnitude group adds words\n  let remaining = absNum;\n\n  if (remaining >= 1_000_000_000) {\n    const billions = Math.floor(remaining / 1_000_000_000);\n    words += estimateNumberWordCount(String(billions), billions);\n    words += 1; // \"billion\"\n    remaining %= 1_000_000_000;\n  }\n\n  if (remaining >= 1_000_000) {\n    const millions = Math.floor(remaining / 1_000_000);\n    words += estimateNumberWordCount(String(millions), millions);\n    words += 1; // \"million\"\n    remaining %= 1_000_000;\n  }\n\n  if (remaining >= 1_000) {\n    const thousands = Math.floor(remaining / 1_000);\n    words += estimateNumberWordCount(String(thousands), thousands);\n    words += 1; // \"thousand\"\n    remaining %= 1_000;\n  }\n\n  if (remaining >= 100) {\n    words += 2; // digit + \"hundred\"\n    remaining %= 100;\n  }\n\n  if (remaining >= 1) {\n    if (remaining >= 20) {\n      words += remaining % 10 === 0 ? 1 : 2;\n    } else {\n      words += 1; // 1–19\n    }\n  }\n\n  return Math.max(words, 1);\n}\n\n/**\n * Count \"spoken word equivalents\" in a block of text,\n * expanding numbers and adding comma pauses.\n */\nexport function countSpokenWords(text: string): number {\n  const tokens = text.split(/\\s+/).filter((w) => w.length > 0);\n  let count = 0;\n\n  for (const token of tokens) {\n    // Strip punctuation only at token boundaries so internal punctuation\n    // (e.g., decimals like \"3.14\" or digit-grouping commas \"1,000\") is preserved.\n    const stripped = token.replace(/^[.,!?;:'\"()[\\]{}]+|[.,!?;:'\"()[\\]{}]+$/g, '');\n    count += estimateSpokenWordCount(stripped);\n\n    // Count only punctuation commas for pauses: exclude digit-grouping commas\n    // (i.e., commas with digits on both sides, like in \"1,234\").\n    let punctuationCommaCount = 0;\n    for (let i = 0; i < token.length; i++) {\n      if (token[i] === ',') {\n        const prev = i > 0 ? token[i - 1] : '';\n        const next = i < token.length - 1 ? token[i + 1] : '';\n        const prevIsDigit = prev >= '0' && prev <= '9';\n        const nextIsDigit = next >= '0' && next <= '9';\n        if (!(prevIsDigit && nextIsDigit)) {\n          punctuationCommaCount++;\n        }\n      }\n    }\n    count += punctuationCommaCount * COMMA_PAUSE_PENALTY;\n  }\n\n  return count;\n}\n\n/**\n * Estimate audio time at a character offset using word-proportion mapping.\n *\n * Given the full source text and a character position, returns the\n * estimated time (in seconds) at which that position would be spoken.\n *\n * @param text - Full source text\n * @param charOffset - Character offset to estimate timing for\n * @param totalDuration - Total audio duration in seconds\n * @returns Estimated time in seconds\n */\nexport function estimateTimeFromText(\n  text: string,\n  charOffset: number,\n  totalDuration: number,\n): number {\n  const textBefore = text.slice(0, charOffset);\n  const spokenWordsBefore = countSpokenWords(textBefore);\n  const totalSpokenWords = countSpokenWords(text);\n\n  if (totalSpokenWords === 0) return 0;\n  return (spokenWordsBefore / totalSpokenWords) * totalDuration;\n}\n\n/**\n * Estimate how long a spoken prefix adds to audio duration.\n *\n * When audio includes a spoken title or header before the main content,\n * this calculates the extra duration to offset timing calculations.\n *\n * @param prefix - Prefix text (e.g., an article title spoken before the body)\n * @param wordsPerSecond - Speaking rate (default: 2.5)\n * @returns Estimated duration in seconds\n */\nexport function calculatePrefixDuration(\n  prefix: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  if (!prefix) return 0;\n\n  const words = prefix.split(/\\s+/).filter((w) => w.length > 0);\n  const newlineCount = (prefix.match(/\\n\\n/g) || []).length;\n  const pauseTime = newlineCount * 0.5;\n\n  return words.length / wordsPerSecond + pauseTime;\n}\n\n/**\n * Estimate narration duration for a block of text.\n *\n * @param text - The text to estimate\n * @param wordsPerSecond - Speaking rate (default: 2.5, i.e. ~150 WPM)\n * @returns Duration in seconds\n */\nexport function estimateNarrationDuration(\n  text: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  const spokenWords = countSpokenWords(text);\n  return spokenWords / wordsPerSecond;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-4X3JQXNM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/timing/readingTime.ts"],"sourcesContent":["/**\n * Reading time estimation.\n *\n * Estimates how long it takes to read text silently vs. narrate it aloud.\n * Uses configurable words-per-minute rates.\n */\n\nimport { countSpokenWords, DEFAULT_WORDS_PER_SECOND } from './narrationTiming.js';\n\n/** Default silent reading rate (adults average ~200–250 WPM). */\nconst DEFAULT_READING_WPM = 200;\n\n/** Result of a reading-time estimate. */\nexport interface ReadingTimeEstimate {\n  /** Number of words (plain word count, not spoken equivalents). */\n  words: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for reading-time estimation. */\nexport interface ReadingTimeOptions {\n  /** Words per minute for silent reading (default: 200). */\n  wordsPerMinute?: number;\n}\n\n/**\n * Estimate silent reading time for a block of text.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Word count + time estimate\n */\nexport function estimateReadingTime(\n  text: string,\n  options?: ReadingTimeOptions,\n): ReadingTimeEstimate {\n  const configuredWpm = options?.wordsPerMinute;\n  const wpm =\n    typeof configuredWpm === 'number' && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;\n  const words = text.split(/\\s+/).filter((w) => w.length > 0).length;\n  const minutes = words / wpm;\n\n  return {\n    words,\n    minutes,\n    seconds: Math.round(minutes * 60),\n  };\n}\n\n/** Result of a narration-time estimate. */\nexport interface NarrationTimeEstimate {\n  /** Spoken word equivalents (numbers expanded, comma pauses added). */\n  spokenWords: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for narration-time estimation. */\nexport interface NarrationTimeOptions {\n  /** Words per second for narration (default: 2.5 ≈ 150 WPM). */\n  wordsPerSecond?: number;\n}\n\n/**\n * Estimate narration (spoken) time for a block of text.\n *\n * Unlike silent reading, this accounts for numbers being spoken as\n * multiple words and pauses at commas.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Spoken word equivalents + time estimate\n */\nexport function estimateNarrationTime(\n  text: string,\n  options?: NarrationTimeOptions,\n): NarrationTimeEstimate {\n  const providedWps = options?.wordsPerSecond;\n  const wps =\n    typeof providedWps === 'number' && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;\n  const spokenWords = countSpokenWords(text);\n  const totalSeconds = spokenWords / wps;\n\n  return {\n    spokenWords,\n    minutes: totalSeconds / 60,\n    seconds: Math.round(totalSeconds),\n  };\n}\n"],"mappings":";;;;;;AAUA,IAAM,sBAAsB;AAyBrB,SAAS,oBACd,MACA,SACqB;AACrB,QAAM,gBAAgB,SAAS;AAC/B,QAAM,MACJ,OAAO,kBAAkB,YAAY,gBAAgB,IAAI,gBAAgB;AAC3E,QAAM,QAAQ,KAAK,MAAM,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;AAC5D,QAAM,UAAU,QAAQ;AAExB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,SAAS,KAAK,MAAM,UAAU,EAAE;AAAA,EAClC;AACF;AA4BO,SAAS,sBACd,MACA,SACuB;AACvB,QAAM,cAAc,SAAS;AAC7B,QAAM,MACJ,OAAO,gBAAgB,YAAY,cAAc,IAAI,cAAc;AACrE,QAAM,cAAc,iBAAiB,IAAI;AACzC,QAAM,eAAe,cAAc;AAEnC,SAAO;AAAA,IACL;AAAA,IACA,SAAS,eAAe;AAAA,IACxB,SAAS,KAAK,MAAM,YAAY;AAAA,EAClC;AACF;","names":[]}