@bendyline/squisq 2.1.0 → 2.2.0

package/dist/narration/index.js

@@ -23,7 +23,7 @@ import {
   reanchorSession,
   traceWordPosAt,
   vadStep
-} from "../chunk-XNLB57UD.js";
+} from "../chunk-DYPMOPIW.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -33,18 +33,18 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-JI77MGAK.js";
-import "../chunk-TUWMK62B.js";
-import "../chunk-5UYI3RJB.js";
-import "../chunk-JHZWYRSW.js";
-import "../chunk-5J4HKRJF.js";
-import "../chunk-R2YZTCLO.js";
-import "../chunk-AMIR72JP.js";
-import "../chunk-QE7TWGVT.js";
-import "../chunk-4X3JQXNM.js";
-import "../chunk-3E5F2XMR.js";
-import "../chunk-V543AI2F.js";
-import "../chunk-FVTQSNR7.js";
+} from "../chunk-7ARJZYQY.js";
+import "../chunk-PUS54YU6.js";
+import "../chunk-FDYDYL77.js";
+import "../chunk-C33GTPUZ.js";
+import "../chunk-BAOV476U.js";
+import "../chunk-ZQKZSJAX.js";
+import "../chunk-BCCXTMN5.js";
+import "../chunk-4VOD55SX.js";
+import "../chunk-XOFT65EX.js";
+import "../chunk-67L6WRJN.js";
+import "../chunk-QKPXHDLR.js";
+import "../chunk-XRW6P7IF.js";
 export {
   DEFAULT_ALIGN_CONFIG,
   DEFAULT_FEATURE_CONFIG,
@@ -79,4 +79,3 @@ export {
   wordIndexAtTime,
   wordPosAtExpectedSyllables
 };
-//# sourceMappingURL=index.js.map

package/dist/random/index.d.ts

@@ -14,7 +14,16 @@
 declare class SeededRandom {
     private state;
     constructor(seed: number);
-    /** Random float in [0, 1). */
+    /**
+     * Random float in [0, 1).
+     *
+     * The state increment wraps to 32 bits, as Mulberry32 specifies. Leaving it
+     * unwrapped (the shape of the widely-copied reference snippet) keeps the
+     * state as an ever-growing float: the bitwise ops below still coerce it
+     * mod 2^32, so the OUTPUT is identical — until the state passes 2^53 and
+     * `+= 0x6d2b79f5` stops being exact. From that point the low bits rot and
+     * the sequence silently drifts from Mulberry32 (measured: draw 4,917,758).
+     */
     next(): number;
     /** Random integer in [0, max). */
     nextInt(max: number): number;
@@ -37,7 +46,7 @@ declare class SeededRandom {
         item: T;
         weight: number;
     }[]): T | undefined;
-    /** Current internal state (for debugging / serialization). */
+    /** Current internal state as a uint32 (for debugging / serialization). */
     getState(): number;
     /** Create an independent sub-stream keyed by a modifier. */
     derive(modifier: string | number): SeededRandom;

package/dist/random/index.js

@@ -1,10 +1,9 @@
-import "../chunk-V543AI2F.js";
+import "../chunk-QKPXHDLR.js";
 import {
   SeededRandom,
   hashString
-} from "../chunk-FVTQSNR7.js";
+} from "../chunk-XRW6P7IF.js";
 export {
   SeededRandom,
   hashString
 };
-//# sourceMappingURL=index.js.map

package/dist/recommend/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MarkdownBlockNode } from '../types-BwMPl2CB.js';
+import { M as MarkdownBlockNode } from '../types-CUNc9biN.js';
 
 /**
  * Block template recommendations.

package/dist/recommend/index.js

@@ -1,11 +1,10 @@
-import "../chunk-ZLQKNOZQ.js";
+import "../chunk-XWNNA3KE.js";
 import {
   profileBlockContents,
   recommendTemplatesForBlock
-} from "../chunk-5UYI3RJB.js";
-import "../chunk-AMIR72JP.js";
+} from "../chunk-FDYDYL77.js";
+import "../chunk-BCCXTMN5.js";
 export {
   profileBlockContents,
   recommendTemplatesForBlock
 };
-//# sourceMappingURL=index.js.map

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.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-B72m0W1y.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-Ca4Tr9uN.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

package/dist/schemas/index.js

@@ -9,12 +9,12 @@ import {
   getSegmentAtTime,
   parseTheme,
   serializeTheme
-} from "../chunk-QUUPYOSP.js";
+} from "../chunk-CB45YGAM.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
   resolveMediaSchedule
-} from "../chunk-VWCJ2WXC.js";
+} from "../chunk-2ZWIXGAC.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -68,7 +68,7 @@ import {
   resolveTheme,
   validateTheme,
   withAlpha
-} from "../chunk-JHZWYRSW.js";
+} from "../chunk-C33GTPUZ.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -85,7 +85,7 @@ import {
   isTemplateBlock,
   scaledFontSize,
   scaledFontSize2
-} from "../chunk-5J4HKRJF.js";
+} from "../chunk-BAOV476U.js";
 import {
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,
@@ -95,7 +95,7 @@ import {
   normalizeTransitionType,
   resolveBlockTransition,
   resolveTransitionDuration
-} from "../chunk-QE7TWGVT.js";
+} from "../chunk-4VOD55SX.js";
 export {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -186,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-B72m0W1y.d.ts → themeLibrary-DU9mUmVl.d.ts}

@@ -1,4 +1,4 @@
-import { b1 as Theme, b5 as ThemeRegistry } from './Doc-DynJleo-.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,7 +1,7 @@
-import { m as ColorScheme, F as Doc, B as Block } from '../Doc-DynJleo-.js';
-import { i as PageTransformHints } from '../materializePageSection-DDzubQXo.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';
+import '../types-CUNc9biN.js';
 
 /** Identifier for a built-in or caller-registered transform style. */
 type TransformStyleId = string;

package/dist/transform/index.js

@@ -7,12 +7,12 @@ import {
   getTransformStyleIds,
   getTransformStyleSummaries,
   resolveTransformStyle
-} from "../chunk-ILWDXLUK.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.1.0",
+  "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-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":[]}