@bendyline/squisq 1.5.2 → 2.0.0

package/dist/narration/index.js

@@ -0,0 +1,82 @@
+import {
+  DEFAULT_ALIGN_CONFIG,
+  DEFAULT_FEATURE_CONFIG,
+  DEFAULT_NUCLEI_CONFIG,
+  DEFAULT_PACING_CONFIG,
+  DEFAULT_VAD_CONFIG,
+  alignNarration,
+  bandpassRun,
+  createBandpass,
+  createFeatureState,
+  createNarrationSession,
+  createNucleiState,
+  createPacingState,
+  createVadState,
+  detectSyllableOnsets,
+  downsampleTrace,
+  extractFrameFeatures,
+  featureStep,
+  narrationSessionStep,
+  nucleiStep,
+  pacingStep,
+  reanchorPacing,
+  reanchorSession,
+  traceWordPosAt,
+  vadStep
+} from "../chunk-T3TI7GSZ.js";
+import {
+  buildNarrationScript,
+  buildNarrationTimingJson,
+  estimateSyllables,
+  expectedSyllablesAt,
+  parseNarrationTimingJson,
+  wordIndexAtChar,
+  wordIndexAtTime,
+  wordPosAtExpectedSyllables
+} from "../chunk-GF3BVNLU.js";
+import "../chunk-TUWMK62B.js";
+import "../chunk-5UYI3RJB.js";
+import "../chunk-6PJRB2CF.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";
+export {
+  DEFAULT_ALIGN_CONFIG,
+  DEFAULT_FEATURE_CONFIG,
+  DEFAULT_NUCLEI_CONFIG,
+  DEFAULT_PACING_CONFIG,
+  DEFAULT_VAD_CONFIG,
+  alignNarration,
+  bandpassRun,
+  buildNarrationScript,
+  buildNarrationTimingJson,
+  createBandpass,
+  createFeatureState,
+  createNarrationSession,
+  createNucleiState,
+  createPacingState,
+  createVadState,
+  detectSyllableOnsets,
+  downsampleTrace,
+  estimateSyllables,
+  expectedSyllablesAt,
+  extractFrameFeatures,
+  featureStep,
+  narrationSessionStep,
+  nucleiStep,
+  pacingStep,
+  parseNarrationTimingJson,
+  reanchorPacing,
+  reanchorSession,
+  traceWordPosAt,
+  vadStep,
+  wordIndexAtChar,
+  wordIndexAtTime,
+  wordPosAtExpectedSyllables
+};
+//# sourceMappingURL=index.js.map

package/dist/recommend/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MarkdownBlockNode } from '../types-DlAZ7MW4.js';
+import { M as MarkdownBlockNode } from '../types-BwMPl2CB.js';
 
 /**
  * Block template recommendations.
@@ -20,6 +20,20 @@ interface BlockContentProfile {
     hasDate: boolean;
     hasNumberHighlight: boolean;
     wordCount: number;
+    /**
+     * True when the body is dominated by exactly one code fence whose content
+     * is an ASCII box-and-line diagram (see `doc/asciiDiagram/detect.ts`).
+     * Optional so externally-constructed profiles keep compiling.
+     */
+    hasAsciiDiagram?: boolean;
+    /** True when a dominant code fence is an authored marker+axis timeline. */
+    hasTimeline?: boolean;
+    /**
+     * True when the body is dominated by exactly one code fence whose content
+     * is an ASCII file-tree / outline (see `doc/treeview/detect.ts`). Mutually
+     * exclusive with `hasAsciiDiagram`.
+     */
+    hasTree?: boolean;
 }
 interface RecommendationResult {
     recommended: string[];

package/dist/recommend/index.js

@@ -2,8 +2,8 @@ import "../chunk-ZLQKNOZQ.js";
 import {
   profileBlockContents,
   recommendTemplatesForBlock
-} from "../chunk-UY7KGQ5R.js";
-import "../chunk-HWVFJAAH.js";
+} from "../chunk-5UYI3RJB.js";
+import "../chunk-AMIR72JP.js";
 export {
   profileBlockContents,
   recommendTemplatesForBlock

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { az as Theme, v as DeepPartial, aD as ThemeSeedColors, aA as ThemeColorPalette, K as FontFamilyKind, J as FontFamily } from '../Doc-BBVGq1_9.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 Doc, z as DocBlock, E as DocDiagnostic, F as DrawingBlockInput, G as FRONTMATTER_CUSTOM_TEMPLATES_KEY, H as FRONTMATTER_CUSTOM_THEMES_KEY, I as FactCardInput, L as FullBleedQuoteInput, M as GradientBackgroundConfig, N as ImageBackgroundConfig, O as ImageLayer, P as ImageTreatment, Q as ImageWithCaptionInput, R as LIGHT_SURFACE, S as Layer, T as LayerRepeat, U as LayoutHints, V as LeftFeatureInput, W as LinearGradient, X as ListBlockInput, Y as MapBlockInput, Z as MapLayer, _ as MapMarker, $ as MapTileStyle, a0 as MarkerStyle, a1 as MediaClip, a2 as PathLayer, a3 as PatternBackgroundConfig, a4 as PersistentLayer, a5 as PersistentLayerConfig, a6 as PersistentLayerTemplate, a7 as PersistentLayerTemplateConfig, a8 as PersistentLayerTemplateType, a9 as PhotoGridInput, aa as Position, ab as ProgressIndicatorConfig, ac as PullQuoteInput, ad as QuoteBlockInput, ae as RawLayersInput, af as RenderStyle, ag as RightFeatureInput, ah as ScheduledClip, ai as SectionHeaderInput, aj as ShapeFilter, ak as ShapeLayer, al as ShapePattern, am as SolidBackgroundConfig, an as StartBlockConfig, ao as StatHighlightInput, ap as SurfaceScheme, aq as THEME_SCHEMA_VERSION, ar as TableLayer, as as TableLayerStyle, at as TemplateBlock, au as TemplateContext, av as TemplateFunction, aw as TemplateRegistry, ax as TextLayer, ay as TextStyle, aB as ThemeColorScheme, aC as ThemeSchemaVersion, aE as ThemeStyle, aF as ThemeTypography, aG as TitleBlockInput, aH as TitleCaptionConfig, aI as TwoColumnInput, aJ as VIEWPORT_PRESETS, aK as VideoLayer, aL as VideoPullQuoteInput, aM as VideoWithCaptionInput, aN as ViewportConfig, aO as ViewportOrientation, aP as ViewportPreset, aQ as VignetteConfig, aR as applySurface, aS as calculateDuration, aT as calculateFontScale, aU as createTemplateContext, aV as createTheme, aW as getAspectRatioString, aX as getBlockAtTime, aY as getCaptionAtTime, aZ as getDocPlaybackDuration, a_ as getLayoutHints, a$ as getRegisteredThemes, b0 as getSafeTextBounds, b1 as getSegmentAtTime, b2 as getTwoColumnPositions, b3 as getViewport, b4 as getViewportOrientation, b5 as isPersistentLayerTemplate, b6 as isTemplateBlock, b7 as layoutScaledFontSize, b8 as lookupRegisteredTheme, b9 as registerTheme, ba as resolveMediaSchedule, bb as scaledFontSize, bc as unregisterTheme } from '../Doc-BBVGq1_9.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-DlAZ7MW4.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-CehcJhzz.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';
 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-FuyGtt6o.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-D828IXJ1.js';
 
 /**
  * Theme Validator
@@ -55,6 +55,14 @@ declare const STARTER_THEME: Theme;
 declare function deriveColorPalette(seeds: ThemeSeedColors, partialColors?: Partial<ThemeColorPalette>, opts?: {
     contrast?: 'subtle' | 'balanced' | 'high';
 }): ThemeColorPalette;
+/**
+ * Expand one accent color into a full `{bg, text, accent}` color scheme via
+ * the OKLCh scale — dark saturated bg, light readable text, the picked accent.
+ * Falls back to a neutral scheme when the input isn't a valid hex. Shared by
+ * the editor's accent list and file-import theme inference so both derive
+ * identical schemes from the same accent.
+ */
+declare function accentToColorScheme(accent: string): ThemeColorScheme;
 /** Map a contrast preset to numeric spread used by `deriveColorPalette`. */
 type ContrastPreset = 'subtle' | 'balanced' | 'high';
 interface CompileOptions {
@@ -141,6 +149,20 @@ declare function fontStack(id: string): FontFamily;
 declare function buildGoogleFontsUrl(families: Array<FontFamily | undefined>): string | null;
 /** Default fallback families exposed for tools that need them. */
 declare const FONT_FALLBACKS: Record<FontFamilyKind, string>;
+/**
+ * Guess the structured fallback bucket for an arbitrary typeface name.
+ * Deliberately never guesses `system-ui` — a wrong serif/sans guess is
+ * recoverable in the customizer; `system-ui` erases the signal entirely.
+ */
+declare function guessFontFallback(name: string): 'serif' | 'sans-serif' | 'monospace' | 'system-ui';
+/**
+ * Map an arbitrary typeface name (e.g. from an imported office document's
+ * fontScheme) to a `FontFamily`: a curated `{ stackId }` when the name
+ * matches a known stack, else `{ custom }` preserving the original name
+ * (original casing, quotes stripped) with a heuristic fallback bucket.
+ * Empty/blank names resolve to the system sans stack.
+ */
+declare function matchFontFamily(name: string): FontFamily;
 
 /**
  * Color Utilities
@@ -205,4 +227,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, ThemeSeedColors, type ValidationError, type ValidationResult, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, deriveColorPalette, deriveScale, fontStack, getFontStack, hexHueDegrees, isHex, 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, 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 };

package/dist/schemas/index.js

@@ -1,16 +1,19 @@
 import {
   STARTER_THEME,
+  accentToColorScheme,
   calculateDuration,
   compileTheme,
   deriveColorPalette,
   getBlockAtTime,
   getCaptionAtTime,
-  getDocPlaybackDuration,
   getSegmentAtTime,
   parseTheme,
-  resolveMediaSchedule,
   serializeTheme
-} from "../chunk-A4O7GIWE.js";
+} from "../chunk-LYNJEOAC.js";
+import {
+  getDocPlaybackDuration,
+  resolveMediaSchedule
+} from "../chunk-FVJUUTEM.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -27,27 +30,26 @@ import {
   buildGoogleFontsUrl,
   contrastRatio,
   createTheme,
+  createThemeRegistry,
   deriveScale,
   fontStack,
   getAvailableThemes,
   getFontStack,
-  getRegisteredThemes,
   getThemeSummaries,
+  guessFontFallback,
   hexHueDegrees,
   isHex,
-  lookupRegisteredTheme,
+  matchFontFamily,
   oklchDarken,
   oklchLighten,
   oklchSetChroma,
   pickContrastingText,
-  registerTheme,
   relativeLuminance,
   resolveFontFamily,
   resolveTheme,
-  unregisterTheme,
   validateTheme,
   withAlpha
-} from "../chunk-KKNUBQ6Y.js";
+} from "../chunk-6PJRB2CF.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -64,7 +66,7 @@ import {
   isTemplateBlock,
   scaledFontSize,
   scaledFontSize2
-} from "../chunk-DLXZMS5K.js";
+} from "../chunk-5J4HKRJF.js";
 import {
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,
@@ -93,6 +95,7 @@ export {
   TRANSITION_DIRECTIONS,
   TRANSITION_TYPES,
   VIEWPORT_PRESETS,
+  accentToColorScheme,
   applySurface,
   assertTheme,
   buildGoogleFontsUrl,
@@ -102,6 +105,7 @@ export {
   contrastRatio,
   createTemplateContext,
   createTheme,
+  createThemeRegistry,
   deriveColorPalette,
   deriveScale,
   fontStack,
@@ -112,20 +116,20 @@ export {
   getDocPlaybackDuration,
   getFontStack,
   getLayoutHints,
-  getRegisteredThemes,
   getSafeTextBounds,
   getSegmentAtTime,
   getThemeSummaries,
   getTwoColumnPositions,
   getViewport,
   getViewportOrientation,
+  guessFontFallback,
   hexHueDegrees,
   isHex,
   isPersistentLayerTemplate,
   isTemplateBlock,
   isTransitionType,
   scaledFontSize as layoutScaledFontSize,
-  lookupRegisteredTheme,
+  matchFontFamily,
   normalizeTransitionDirection,
   normalizeTransitionType,
   oklchDarken,
@@ -133,7 +137,6 @@ export {
   oklchSetChroma,
   parseTheme,
   pickContrastingText,
-  registerTheme,
   relativeLuminance,
   resolveBlockTransition,
   resolveFontFamily,
@@ -142,7 +145,6 @@ export {
   resolveTransitionDuration,
   scaledFontSize2 as scaledFontSize,
   serializeTheme,
-  unregisterTheme,
   validateTheme,
   withAlpha
 };

package/dist/spatial/index.d.ts

@@ -39,7 +39,6 @@ declare function calculateBearing(from: Coordinates, to: Coordinates): number;
  * - 5 chars: ~5km x 5km
  * - 6 chars: ~1.2km x 0.6km
  */
-
 /**
  * Encode latitude/longitude to a geohash string.
  * Uses the standard ngeohash library.

package/dist/spatial/index.js

@@ -9,7 +9,7 @@ import {
   getGeohashPrefix,
   getNeighbors,
   haversineDistance
-} from "../chunk-Q3ROPT5H.js";
+} from "../chunk-GZY66SDN.js";
 export {
   calculateBearing,
   decodeGeohash,

package/dist/storage/index.js

@@ -7,7 +7,7 @@ import {
   createMediaProviderFromContainer,
   findDocumentPath,
   scopeContainer
-} from "../chunk-IMSCRLLV.js";
+} from "../chunk-VR7UPJ7C.js";
 export {
   LocalForageAdapter,
   LocalStorageAdapter,

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

@@ -1,4 +1,4 @@
-import { az as Theme } from './Doc-BBVGq1_9.js';
+import { aC as Theme, aF as ThemeRegistry } from './Doc-ylqWKDc_.js';
 
 /**
  * Built-in Theme Library
@@ -11,27 +11,26 @@ import { az as Theme } from './Doc-BBVGq1_9.js';
  * ```ts
  * import { THEMES, resolveTheme } from '@bendyline/squisq/schemas';
  *
- * const theme = resolveTheme('minimalist'); // by id, with registry override
+ * const theme = resolveTheme('minimalist'); // built-in lookup by id
  * const theme = THEMES.documentary;         // direct access to a built-in
  * ```
  */
 
 /** All built-in themes, keyed by id. */
-declare const THEMES: Record<string, Theme>;
+declare const THEMES: Readonly<Record<string, Theme>>;
 /** The default theme id. */
 declare const DEFAULT_THEME_ID = "standard";
 /** The default theme (standard — safe system fonts, no external dependencies). */
 declare const DEFAULT_THEME: Theme;
 /**
- * Resolve a theme by id. Custom themes registered via `registerTheme()`
- * take precedence over built-ins; otherwise built-ins are searched and
- * the default theme is returned for unknown ids.
+ * Resolve a theme by id. When a caller-owned registry is supplied its themes
+ * take precedence over built-ins; unknown ids fall back to the default.
  */
-declare function resolveTheme(id: string | undefined): Theme;
-/** Get all built-in theme ids. */
-declare function getAvailableThemes(): string[];
-/** Get a summary of all built-in themes (id + name + description) for theme pickers. */
-declare function getThemeSummaries(): Array<{
+declare function resolveTheme(id: string | undefined, registry?: ThemeRegistry): Theme;
+/** Get built-in ids plus ids from an optional caller-owned registry. */
+declare function getAvailableThemes(registry?: ThemeRegistry): string[];
+/** Get summaries for built-ins plus an optional caller-owned registry. */
+declare function getThemeSummaries(registry?: ThemeRegistry): Array<{
     id: string;
     name: string;
     description?: string;

package/dist/timing/index.js

@@ -1,14 +1,16 @@
 import "../chunk-DNJKBAI7.js";
+import {
+  estimateNarrationTime,
+  estimateReadingTime
+} from "../chunk-4X3JQXNM.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,
-  estimateNarrationTime,
-  estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "../chunk-VWUFZ6ZG.js";
+} from "../chunk-3E5F2XMR.js";
 export {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,

package/dist/transform/index.d.ts

@@ -1,6 +1,6 @@
-import { m as ColorScheme, y as Doc, B as Block } from '../Doc-BBVGq1_9.js';
+import { m as ColorScheme, F as Doc, B as Block } from '../Doc-ylqWKDc_.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
-import '../types-DlAZ7MW4.js';
+import '../types-BwMPl2CB.js';
 
 /**
  * Transform Types
@@ -10,7 +10,7 @@ import '../types-DlAZ7MW4.js';
  * presentation. Transforms are read-only on the input and deterministic.
  */
 
-/** Identifier for a registered transform style. */
+/** Identifier for a built-in or caller-registered transform style. */
 type TransformStyleId = string;
 /** Summary info for UI dropdowns (mirrors getThemeSummaries pattern). */
 interface TransformStyleSummary {
@@ -80,6 +80,15 @@ interface TransformStyleConfig {
         slidesPerMinute?: number;
     };
 }
+/** Built-in id or a call-scoped declarative style definition. */
+type TransformStyleInput = TransformStyleId | TransformStyleConfig;
+/** Explicit caller-owned registry for custom transform styles. */
+interface TransformStyleRegistry {
+    register(style: TransformStyleConfig): void;
+    unregister(id: string): boolean;
+    get(id: string): TransformStyleConfig | undefined;
+    list(): TransformStyleConfig[];
+}
 /** Image metadata for image interleaving. */
 interface TransformImage {
     /** Image source path or URL. */
@@ -101,6 +110,8 @@ interface TransformOptions {
     themeId?: string;
     /** Override specific style config values. */
     overrides?: Partial<TransformStyleConfig>;
+    /** Caller-owned registry used when `style` is an id. */
+    registry?: TransformStyleRegistry;
 }
 /** Result of applying a transform. */
 interface TransformResult {
@@ -129,40 +140,40 @@ interface TransformResult {
  * optimized for visual presentation.
  *
  * @param doc - The source Doc (not mutated).
- * @param styleId - Registered transform style id (e.g. 'documentary', 'magazine').
- * @param options - Optional seed, images, theme override.
+ * @param style - Built-in/registry id or a call-scoped declarative style.
+ * @param options - Optional seed, images, theme override, and explicit registry.
  * @returns TransformResult with the new Doc and stats.
  */
-declare function applyTransform(doc: Doc, styleId: TransformStyleId, options?: TransformOptions): TransformResult;
+declare function applyTransform(doc: Doc, style: TransformStyleInput, options?: TransformOptions): TransformResult;
 
 /**
  * Transform Style Registry
  *
- * Central registry of built-in transform styles plus a dynamic
- * registration API. Follows the same pattern as themeLibrary.ts /
- * `registerTheme` — registered styles take precedence over built-ins,
- * unknown ids fall back to the default.
+ * Immutable built-in lookup plus explicit caller-owned custom registries.
+ * There is deliberately no process-global mutable registry.
  */
 
 /** Default style used when no id is provided. */
 declare const DEFAULT_TRANSFORM_STYLE_ID = "documentary";
 /**
- * Register (or replace) a custom transform style at runtime. Hosts use
- * this the same way they use `registerTheme` — to add product-specific
- * styles without forking the registry.
+ * Create a caller-owned registry. Custom styles are validated, cloned, and
+ * deeply frozen at registration time. Built-in resolution remains in the
+ * top-level helpers, separate from the registry's caller-owned state.
  */
-declare function registerTransformStyle(style: TransformStyleConfig): void;
-/** Remove a previously registered custom style. */
-declare function unregisterTransformStyle(id: string): void;
+declare function createTransformStyleRegistry(initialStyles?: readonly TransformStyleConfig[]): TransformStyleRegistry;
 /**
- * Resolve a transform style by id. Registered styles win over built-ins;
- * aliases are honored; unknown ids fall back to the default style.
+ * Resolve a built-in id, explicit-registry id, or call-scoped style config.
+ * Unknown ids fall back to the default style.
  */
-declare function resolveTransformStyle(id: string): TransformStyleConfig;
-/** Get all known style ids (built-ins plus registered). */
-declare function getTransformStyleIds(): string[];
-/** Get summary info for all styles (for UI dropdowns). */
-declare function getTransformStyleSummaries(): TransformStyleSummary[];
+declare function resolveTransformStyle(style: TransformStyleInput, registry?: TransformStyleRegistry): TransformStyleConfig;
+/** Get built-in ids plus ids from an optional caller-owned registry. */
+declare function getTransformStyleIds(registry?: TransformStyleRegistry): string[];
+/** Get summaries for built-ins plus an optional caller-owned registry. */
+declare function getTransformStyleSummaries(registry?: TransformStyleRegistry): {
+    id: string;
+    name: string;
+    description: string;
+}[];
 
 /**
  * Block Analyzer
@@ -210,4 +221,4 @@ declare function extractDocImages(blocks: Block[]): TransformImage[];
  */
 declare function analyzeBlocks(blocks: Block[], options?: ExtractionOptions): AnalyzedBlock[];
 
-export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleSummary, analyzeBlocks, applyTransform, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, registerTransformStyle, resolveTransformStyle, unregisterTransformStyle };
+export { type AnalyzedBlock, type BlockImage, DEFAULT_TRANSFORM_STYLE_ID, type TransformImage, type TransformOptions, type TransformResult, type TransformStyleConfig, type TransformStyleId, type TransformStyleInput, type TransformStyleRegistry, type TransformStyleSummary, analyzeBlocks, applyTransform, createTransformStyleRegistry, extractDocImages, getTransformStyleIds, getTransformStyleSummaries, resolveTransformStyle };

package/dist/transform/index.js

@@ -2,26 +2,25 @@ import {
   DEFAULT_TRANSFORM_STYLE_ID,
   analyzeBlocks,
   applyTransform,
+  createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  registerTransformStyle,
-  resolveTransformStyle,
-  unregisterTransformStyle
-} from "../chunk-LDQ2HJIX.js";
-import "../chunk-TQWLI6S2.js";
+  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";
-import "../chunk-DLXZMS5K.js";
-import "../chunk-HWVFJAAH.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
   analyzeBlocks,
   applyTransform,
+  createTransformStyleRegistry,
   extractDocImages,
   getTransformStyleIds,
   getTransformStyleSummaries,
-  registerTransformStyle,
-  resolveTransformStyle,
-  unregisterTransformStyle
+  resolveTransformStyle
 };
 //# sourceMappingURL=index.js.map

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

@@ -642,4 +642,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 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 { 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 };

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

@@ -5,7 +5,9 @@
  * the document inside the same {@link ContentContainer}. They live under
  * `.versions/<docBasename>.<sortableTimestamp>.md`. The container is the
  * unit of persistence — when the host serializes the container to a ZIP,
- * a real folder, or anywhere else, the version snapshots ride along.
+ * a real folder, or anywhere else, the version snapshots ride along. When
+ * snapshots are retained, a container-root `.gitignore` rule excludes the
+ * `.versions/` folder from Git.
  */
 /**
  * A single version snapshot record.

package/dist/versions/index.d.ts

@@ -1,4 +1,4 @@
-import { C as CoalesceOptions, V as Version, P as PrunePolicy, R as RevertOptions, S as SaveVersionOptions, a as SaveVersionResult } from '../types-D98li1gV.js';
+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';
 
 /**
@@ -103,6 +103,7 @@ declare const VERSION_TIMESTAMP_PATTERN: RegExp;
  * The optional numeric suffix (`-2`, `-3`, ...) is appended only when two
  * snapshots collide on the same UTC second.
  */
+
 /** Subfolder (inside the ContentContainer) that holds version snapshots. */
 declare const VERSIONS_PREFIX = ".versions/";
 /**

package/dist/versions/index.js

@@ -10,12 +10,12 @@ import {
   readVersion,
   revertToVersion,
   saveVersion
-} from "../chunk-VLJJHDAC.js";
+} from "../chunk-JOQYPRDZ.js";
 import {
   VERSION_TIMESTAMP_PATTERN,
   formatVersionTimestamp,
   parseVersionTimestamp
-} from "../chunk-JELIRVDP.js";
+} from "../chunk-S7A5D7ZJ.js";
 export {
   DocumentVersionManager,
   VERSIONS_PREFIX,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "1.5.2",
+  "version": "2.0.0",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",
@@ -46,11 +46,6 @@
       "import": "./dist/spatial/index.js",
       "default": "./dist/spatial/index.js"
     },
-    "./story": {
-      "types": "./dist/story/index.d.ts",
-      "import": "./dist/story/index.js",
-      "default": "./dist/story/index.js"
-    },
     "./doc": {
       "types": "./dist/doc/index.d.ts",
       "import": "./dist/doc/index.js",
@@ -115,6 +110,11 @@
       "types": "./dist/recommend/index.d.ts",
       "import": "./dist/recommend/index.js",
       "default": "./dist/recommend/index.js"
+    },
+    "./narration": {
+      "types": "./dist/narration/index.d.ts",
+      "import": "./dist/narration/index.js",
+      "default": "./dist/narration/index.js"
     }
   },
   "scripts": {