@bendyline/squisq 1.3.0 → 1.4.1

package/dist/storage/index.d.ts

@@ -1,9 +1,159 @@
-export type { StorageAdapter } from './Storage.js';
-export { MemoryStorageAdapter } from './MemoryStorageAdapter.js';
-export { LocalStorageAdapter } from './LocalStorageAdapter.js';
-export { LocalForageAdapter } from './LocalForageAdapter.js';
-export type { LocalForageAdapterOptions } from './LocalForageAdapter.js';
-export type { ContentContainer, ContentEntry } from './ContentContainer.js';
-export { MemoryContentContainer, findDocumentPath } from './ContentContainer.js';
-export { createMediaProviderFromContainer } from './MediaProviderFromContainer.js';
-//# sourceMappingURL=index.d.ts.map
+import { C as ContentContainer, a as ContentEntry } from '../ContentContainer-DNx460y8.js';
+export { M as MemoryContentContainer, f as findDocumentPath } from '../ContentContainer-DNx460y8.js';
+import { a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
+
+/**
+ * Storage - Abstract persistence interface
+ *
+ * Defines the contract for persistent storage across different environments.
+ * All values are JSON-serialized, so any serializable value can be stored.
+ * Keys can be automatically namespaced with a configurable prefix.
+ */
+/** Storage adapter interface - implemented by environment-specific adapters */
+interface StorageAdapter {
+    /** Get a value by key, returns null if not found */
+    get<T>(key: string): Promise<T | null>;
+    /** Set a value for a key */
+    set<T>(key: string, value: T): Promise<void>;
+    /** Remove a value by key */
+    remove(key: string): Promise<void>;
+    /** Clear all stored values (within our namespace) */
+    clear(): Promise<void>;
+    /** Get all keys (within our namespace) */
+    keys(): Promise<string[]>;
+    /** Check if this adapter supports enumeration */
+    readonly supportsEnumeration: boolean;
+}
+
+/**
+ * In-memory storage adapter for testing and SSR environments.
+ * Data does not persist across page reloads.
+ */
+
+declare class MemoryStorageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private store;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+/**
+ * localStorage adapter for web browsers.
+ * Supports a configurable key prefix to namespace stored data.
+ */
+
+declare class LocalStorageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private prefix;
+    constructor(prefix?: string);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+/**
+ * LocalForage adapter - IndexedDB storage with automatic fallbacks.
+ *
+ * Uses localforage which provides IndexedDB storage with automatic
+ * fallbacks to WebSQL and localStorage. This allows storing much more
+ * data than raw localStorage (which is limited to ~5MB).
+ *
+ * Unlike LocalStorageAdapter, this adapter can store binary data
+ * (ArrayBuffer, Blob, Uint8Array) natively without JSON serialization.
+ *
+ * Ported from qualla-internal/shared/services/StorageAdapters.ts with
+ * configurable store name and key prefix.
+ */
+
+interface LocalForageAdapterOptions {
+    /** IndexedDB database name (default: 'squisq') */
+    name?: string;
+    /** IndexedDB object store name (default: 'data') */
+    storeName?: string;
+    /** Key prefix for namespacing (default: '') */
+    prefix?: string;
+    /** Human-readable description (default: 'Squisq storage') */
+    description?: string;
+}
+declare class LocalForageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private store;
+    private prefix;
+    constructor(options?: LocalForageAdapterOptions);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+/**
+ * ScopedContentContainer
+ *
+ * Wraps a parent {@link ContentContainer} and prefixes every path with a
+ * fixed subfolder, presenting that subfolder as the root. Useful for
+ * sidecar folders (e.g. `<imagebasename>_files/`) where a component
+ * should be able to read/write/list files relative to its own root
+ * without knowing where it lives in the parent tree.
+ *
+ * Scopes nest: `scopeContainer(scopeContainer(parent, 'a'), 'b')` is
+ * equivalent to `scopeContainer(parent, 'a/b')`.
+ *
+ * `getDocumentPath()` always returns `null` for scoped sidecars — they
+ * are not document roots.
+ */
+
+/**
+ * A ContentContainer view rooted at a subfolder of a parent container.
+ * All paths passed to / returned from this container are relative to
+ * the subfolder; the parent never sees an unprefixed path.
+ */
+declare class ScopedContentContainer implements ContentContainer {
+    private readonly parent;
+    /** Prefix without trailing slash. */
+    readonly prefix: string;
+    /** Prefix with trailing slash. */
+    private readonly prefixSlash;
+    constructor(parent: ContentContainer, prefix: string);
+    private toParent;
+    /** Strip the prefix from a parent-space path. Returns null if the path is outside the scope. */
+    private fromParent;
+    readFile(path: string): Promise<ArrayBuffer | null>;
+    writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void>;
+    removeFile(path: string): Promise<void>;
+    listFiles(prefix?: string): Promise<ContentEntry[]>;
+    exists(path: string): Promise<boolean>;
+    /** Sidecars are not document roots. */
+    getDocumentPath(): Promise<string | null>;
+    readDocument(): Promise<string | null>;
+    writeDocument(): Promise<void>;
+}
+/** Factory: convenience wrapper for `new ScopedContentContainer(parent, prefix)`. */
+declare function scopeContainer(parent: ContentContainer, prefix: string): ScopedContentContainer;
+
+/**
+ * MediaProviderFromContainer — bridges ContentContainer to MediaProvider.
+ *
+ * Creates a MediaProvider that resolves relative paths by reading binary data
+ * from a ContentContainer and generating blob URLs. Blob URLs are cached and
+ * revoked on dispose().
+ *
+ * This allows any ContentContainer (memory, slot-backed, zip-loaded) to be
+ * used with existing rendering components (DocPlayer, ImageLayer, VideoLayer)
+ * that consume MediaProvider.
+ */
+
+/**
+ * Create a MediaProvider backed by a ContentContainer.
+ *
+ * @param container — The ContentContainer to read/write media from
+ * @returns A MediaProvider that resolves paths to blob URLs
+ */
+declare function createMediaProviderFromContainer(container: ContentContainer): MediaProvider;
+
+export { ContentContainer, ContentEntry, LocalForageAdapter, type LocalForageAdapterOptions, LocalStorageAdapter, MemoryStorageAdapter, ScopedContentContainer, type StorageAdapter, createMediaProviderFromContainer, scopeContainer };

package/dist/storage/index.js

@@ -1,6 +1,21 @@
-export { MemoryStorageAdapter } from './MemoryStorageAdapter.js';
-export { LocalStorageAdapter } from './LocalStorageAdapter.js';
-export { LocalForageAdapter } from './LocalForageAdapter.js';
-export { MemoryContentContainer, findDocumentPath } from './ContentContainer.js';
-export { createMediaProviderFromContainer } from './MediaProviderFromContainer.js';
+import {
+  LocalForageAdapter,
+  LocalStorageAdapter,
+  MemoryContentContainer,
+  MemoryStorageAdapter,
+  ScopedContentContainer,
+  createMediaProviderFromContainer,
+  findDocumentPath,
+  scopeContainer
+} from "../chunk-2TMAWB4Y.js";
+export {
+  LocalForageAdapter,
+  LocalStorageAdapter,
+  MemoryContentContainer,
+  MemoryStorageAdapter,
+  ScopedContentContainer,
+  createMediaProviderFromContainer,
+  findDocumentPath,
+  scopeContainer
+};
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/story/index.d.ts

@@ -1,8 +1,8 @@
-import { K as PersistentLayer, x as Layer, N as PersistentLayerConfig, af as TitleBlockInput, a5 as TemplateContext, Y as SectionHeaderInput, a0 as StatHighlightInput, W as QuoteBlockInput, F as FactCardInput, aj as TwoColumnInput, p as DateEventInput, w as ImageWithCaptionInput, M as MapBlockInput, $ as StartBlockConfig, u as FullBleedQuoteInput, z as ListBlockInput, S as PhotoGridInput, r as DefinitionCardInput, k as ComparisonBarInput, V as PullQuoteInput, an as VideoWithCaptionInput, am as VideoPullQuoteInput, o as DataTableInput, A as AccentImage, a as AccentPosition, aa as Theme, ao as ViewportConfig, t as DocBlock, B as Block, a4 as TemplateBlock, a7 as TemplateRegistry, b as Animation, c as AnimationType, ai as TransitionType, ac as ThemeColorScheme, s as Doc } from '../Doc-Ch4tc3vv.js';
-export { y as LayoutHints, X as RenderStyle, ab as ThemeColorPalette, ad as ThemeStyle, ae as ThemeTypography, ak as VIEWPORT_PRESETS, ap as ViewportOrientation, aq as ViewportPreset, au as createTemplateContext, az as getLayoutHints, aC as getTwoColumnPositions, aD as getViewport, aE as getViewportOrientation, aG as isTemplateBlock, aI as scaledFontSize } from '../Doc-Ch4tc3vv.js';
-import { p as MarkdownHeading, l as MarkdownDocument } from '../types-CkNttVSF.js';
+import { Q as PersistentLayer, z as Layer, R as PersistentLayerConfig, am as TitleBlockInput, aa as TemplateContext, a0 as SectionHeaderInput, a4 as StatHighlightInput, Z as QuoteBlockInput, F as FactCardInput, aq as TwoColumnInput, p as DateEventInput, y as ImageWithCaptionInput, H as LeftFeatureInput, $ as RightFeatureInput, M as MapBlockInput, a3 as StartBlockConfig, w as FullBleedQuoteInput, J as ListBlockInput, V as PhotoGridInput, r as DefinitionCardInput, k as ComparisonBarInput, Y as PullQuoteInput, au as VideoWithCaptionInput, at as VideoPullQuoteInput, o as DataTableInput, A as AccentImage, a as AccentPosition, af as Theme, av as ViewportConfig, t as DocBlock, B as Block, a9 as TemplateBlock, ac as TemplateRegistry, b as Animation, c as AnimationType, ap as TransitionType, ah as ThemeColorScheme, s as Doc } from '../Doc-BeSeH2iX.js';
+export { E as LayoutHints, _ as RenderStyle, ag as ThemeColorPalette, ak as ThemeStyle, al as ThemeTypography, ar as VIEWPORT_PRESETS, aw as ViewportOrientation, ax as ViewportPreset, aB as createTemplateContext, aG as getLayoutHints, aK as getTwoColumnPositions, aL as getViewport, aM as getViewportOrientation, aO as isTemplateBlock, aS as scaledFontSize } from '../Doc-BeSeH2iX.js';
+import { p as MarkdownHeading, l as MarkdownDocument } from '../types-BdZkdJ3z.js';
 import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-CEo2D4b6.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BHjJ0Qx6.js';
 
 /**
  * Persistent Layers Expansion
@@ -139,6 +139,23 @@ declare function dateEvent(input: DateEventInput, context: TemplateContext): Lay
 
 declare function imageWithCaption(input: ImageWithCaptionInput, context: TemplateContext): Layer[];
 
+/**
+ * Feature Block Templates — `leftFeature` and `rightFeature`
+ *
+ * Pairs a "feature" image on one side of the block with a title + body
+ * paragraph on the other. The two templates are mirror images, so the
+ * actual layer-builder lives here once and the per-side template files
+ * just call it with a `side` parameter.
+ *
+ * Used for editorial layouts like product highlights, profile cards,
+ * and section intros where a single image deserves to sit next to a
+ * short text block rather than behind it (which is what
+ * `imageWithCaption` does).
+ */
+
+declare function leftFeature(input: LeftFeatureInput, context: TemplateContext): Layer[];
+declare function rightFeature(input: RightFeatureInput, context: TemplateContext): Layer[];
+
 /**
  * Map Block Template
  *
@@ -392,11 +409,32 @@ declare function adjustY(originalY: string | number, layout: AccentLayout): stri
  */
 
 /**
- * Registry mapping template names to their implementation functions.
- * Note: coverBlock is not in the registry as it's used directly for start blocks,
- * not as a regular template in the block sequence.
+ * Registry mapping template ids (the strings that appear in
+ * `{[name]}` markdown annotations) to their implementation functions.
+ *
+ * Some implementation functions keep historical "Block" suffixes
+ * (`titleBlock`, `quoteBlock`, `mapBlock`, `listBlock`) for source
+ * readability — the registry surfaces them under the cleaner short
+ * ids (`title`, `quote`, `map`, `list`). {@link TEMPLATE_ALIASES} keeps
+ * the legacy long ids resolvable for documents written before the
+ * rename.
+ *
+ * Note: coverBlock is not in the registry as it's used directly for
+ * start blocks, not as a regular template in the block sequence.
  */
 declare const templateRegistry: TemplateRegistry;
+/**
+ * Back-compat: maps legacy template ids (kept around for documents
+ * authored before the "Block" suffix was dropped) to the canonical
+ * short ids. Resolved by {@link resolveTemplateName} so both the
+ * registry lookup and `hasTemplate()` accept either form.
+ */
+declare const TEMPLATE_ALIASES: Readonly<Record<string, string>>;
+/**
+ * Resolve a template id through {@link TEMPLATE_ALIASES}. Returns the
+ * input unchanged when no alias is registered.
+ */
+declare function resolveTemplateName(name: string): string;
 /**
  * Expand a template block into a full Block with layers.
  */
@@ -444,7 +482,9 @@ declare function expandDocBlocks(blocks: DocBlock[], options?: ExpandDocBlocksOp
  */
 declare function getAvailableTemplates(): string[];
 /**
- * Check if a template exists.
+ * Check if a template exists. Accepts both the canonical short id
+ * (`title`, `quote`, `map`, `list`) and legacy aliases
+ * (`titleBlock`, `quoteBlock`, `mapBlock`, `listBlock`).
  */
 declare function hasTemplate(name: string): boolean;
 
@@ -495,12 +535,12 @@ declare function getAnimationProgress(animation: Animation, currentTime: number,
  */
 declare function resolveColorScheme(context: TemplateContext, name: string | undefined): ThemeColorScheme;
 /**
- * Get the theme font family for a given role.
+ * Get the theme font family for a given role, resolved to a CSS string.
  * Templates call this to set `fontFamily` on text layers.
  *
- * @param context Template context (includes theme with typography settings)
- * @param role    'title' for headings, 'body' for descriptions, 'mono' for code
- * @returns A CSS font-family string with the theme's font and safe fallbacks
+ * Theme fields are structured `FontFamily` references (`{ stackId }` or
+ * `{ custom: { name, fallback } }`); this helper resolves them to a
+ * CSS font-family string with safe fallbacks.
  */
 declare function getThemeFont(context: TemplateContext, role: 'title' | 'body' | 'mono'): string;
 /**
@@ -754,4 +794,4 @@ declare function scoreTextSimilarity(a: string, b: string): number;
  */
 declare function resolveAudioMapping(doc: Doc, container: ContentContainer): Promise<Doc>;
 
-export { type AccentLayout, type AudioSegmentTiming, type CoverBlockInput, DEFAULT_LAYOUT, DocBlock, type DocStylePreset, type ExpandDocBlocksOptions, type MarkdownToDocOptions, PersistentLayerConfig, type RenderContext, TemplateBlock, TemplateContext, Theme, ThemeColorScheme, ViewportConfig, adjustY, comparisonBar, countBlocks, coverBlock, createAccentLayers, dataTable, dateEvent, definitionCard, docToMarkdown, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, factCard, flattenBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, listBlock, mapBlock, markdownToDoc, photoGrid, pullQuote, quoteBlock, resolveAudioMapping, resolveColorScheme, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shouldUseShadow, statHighlight, templateRegistry, themedFontSize, titleBlock, twoColumn, videoPullQuote, videoWithCaption };
+export { type AccentLayout, type AudioSegmentTiming, type CoverBlockInput, DEFAULT_LAYOUT, DocBlock, type DocStylePreset, type ExpandDocBlocksOptions, type MarkdownToDocOptions, PersistentLayerConfig, type RenderContext, TEMPLATE_ALIASES, TemplateBlock, TemplateContext, Theme, ThemeColorScheme, ViewportConfig, adjustY, comparisonBar, countBlocks, coverBlock, createAccentLayers, dataTable, dateEvent, definitionCard, docToMarkdown, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, factCard, flattenBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, leftFeature, listBlock, mapBlock, markdownToDoc, photoGrid, pullQuote, quoteBlock, resolveAudioMapping, resolveColorScheme, resolveTemplateName, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shouldUseShadow, statHighlight, templateRegistry, themedFontSize, titleBlock, twoColumn, videoPullQuote, videoWithCaption };

package/dist/story/index.js

@@ -1,5 +1,6 @@
 import {
   DEFAULT_LAYOUT,
+  TEMPLATE_ALIASES,
   adjustY,
   comparisonBar,
   countBlocks,
@@ -31,6 +32,7 @@ import {
   getTransitionClass,
   hasTemplate,
   imageWithCaption,
+  leftFeature,
   listBlock,
   mapBlock,
   markdownToDoc,
@@ -39,6 +41,8 @@ import {
   quoteBlock,
   resolveAudioMapping,
   resolveColorScheme,
+  resolveTemplateName,
+  rightFeature,
   scaleAnimationDuration,
   scoreTextSimilarity,
   sectionHeader,
@@ -50,13 +54,13 @@ import {
   twoColumn,
   videoPullQuote,
   videoWithCaption
-} from "../chunk-6BAVXFYC.js";
+} from "../chunk-KSWJR66U.js";
 import {
   DEFAULT_THEME,
   getAvailableThemes,
   getThemeSummaries,
   resolveTheme
-} from "../chunk-FIQR4AJG.js";
+} from "../chunk-B4EEON3N.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -66,13 +70,14 @@ import {
   getViewportOrientation,
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
-} from "../chunk-QM5PKNPW.js";
-import "../chunk-7GF6RDED.js";
+} from "../chunk-5WFRKURX.js";
+import "../chunk-H3AXU4MJ.js";
 import "../chunk-4X3JQXNM.js";
 import "../chunk-3E5F2XMR.js";
 export {
   DEFAULT_LAYOUT,
   DEFAULT_THEME,
+  TEMPLATE_ALIASES,
   VIEWPORT_PRESETS,
   adjustY,
   comparisonBar,
@@ -113,6 +118,7 @@ export {
   hasTemplate,
   imageWithCaption,
   isTemplateBlock,
+  leftFeature,
   listBlock,
   mapBlock,
   markdownToDoc,
@@ -121,7 +127,9 @@ export {
   quoteBlock,
   resolveAudioMapping,
   resolveColorScheme,
+  resolveTemplateName,
   resolveTheme,
+  rightFeature,
   scaleAnimationDuration,
   scaledFontSize,
   scoreTextSimilarity,

package/dist/themeLibrary-BHjJ0Qx6.d.ts

@@ -0,0 +1,40 @@
+import { af as Theme } from './Doc-BeSeH2iX.js';
+
+/**
+ * Built-in Theme Library
+ *
+ * Public entry point for theme lookup. Built-in themes live as JSON
+ * sidecars in [./themes/](./themes/) — they share the exact same shape
+ * as customizer-authored themes (no two-tier distinction).
+ *
+ * Usage:
+ * ```ts
+ * import { THEMES, resolveTheme } from '@bendyline/squisq/schemas';
+ *
+ * const theme = resolveTheme('minimalist'); // by id, with registry override
+ * const theme = THEMES.documentary;         // direct access to a built-in
+ * ```
+ */
+
+/** All built-in themes, keyed by id. */
+declare const THEMES: 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.
+ */
+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<{
+    id: string;
+    name: string;
+    description?: string;
+}>;
+
+export { DEFAULT_THEME as D, THEMES as T, DEFAULT_THEME_ID as a, getThemeSummaries as b, getAvailableThemes as g, resolveTheme as r };

package/dist/timing/index.d.ts

@@ -1,4 +1,109 @@
-export { DEFAULT_WORDS_PER_SECOND, estimateSpokenWordCount, countSpokenWords, estimateTimeFromText, calculatePrefixDuration, estimateNarrationDuration, } from './narrationTiming.js';
-export { estimateReadingTime, estimateNarrationTime } from './readingTime.js';
-export type { ReadingTimeEstimate, ReadingTimeOptions, NarrationTimeEstimate, NarrationTimeOptions, } from './readingTime.js';
-//# sourceMappingURL=index.d.ts.map
+/**
+ * Narration timing estimation.
+ *
+ * Estimates how long text takes to speak aloud, accounting for:
+ * - Numbers spoken as multiple words (e.g., "1910" → "nineteen ten")
+ * - Pauses at commas
+ * - Year pronunciation conventions (1000–2099)
+ *
+ * Ported from qualla-internal's AudioTiming.ts (pure functions, no Node.js deps).
+ */
+/** Default speaking rate in words per second (~150 WPM). */
+declare const DEFAULT_WORDS_PER_SECOND = 2.5;
+/**
+ * Estimate how many "spoken word equivalents" a single token represents.
+ * Numbers get expanded (e.g., "175,000" → ~5 words × 1.3 multiplier).
+ */
+declare function estimateSpokenWordCount(token: string): number;
+/**
+ * Count "spoken word equivalents" in a block of text,
+ * expanding numbers and adding comma pauses.
+ */
+declare function countSpokenWords(text: string): number;
+/**
+ * Estimate audio time at a character offset using word-proportion mapping.
+ *
+ * Given the full source text and a character position, returns the
+ * estimated time (in seconds) at which that position would be spoken.
+ *
+ * @param text - Full source text
+ * @param charOffset - Character offset to estimate timing for
+ * @param totalDuration - Total audio duration in seconds
+ * @returns Estimated time in seconds
+ */
+declare function estimateTimeFromText(text: string, charOffset: number, totalDuration: number): number;
+/**
+ * Estimate how long a spoken prefix adds to audio duration.
+ *
+ * When audio includes a spoken title or header before the main content,
+ * this calculates the extra duration to offset timing calculations.
+ *
+ * @param prefix - Prefix text (e.g., an article title spoken before the body)
+ * @param wordsPerSecond - Speaking rate (default: 2.5)
+ * @returns Estimated duration in seconds
+ */
+declare function calculatePrefixDuration(prefix: string, wordsPerSecond?: number): number;
+/**
+ * Estimate narration duration for a block of text.
+ *
+ * @param text - The text to estimate
+ * @param wordsPerSecond - Speaking rate (default: 2.5, i.e. ~150 WPM)
+ * @returns Duration in seconds
+ */
+declare function estimateNarrationDuration(text: string, wordsPerSecond?: number): number;
+
+/**
+ * Reading time estimation.
+ *
+ * Estimates how long it takes to read text silently vs. narrate it aloud.
+ * Uses configurable words-per-minute rates.
+ */
+/** Result of a reading-time estimate. */
+interface ReadingTimeEstimate {
+    /** Number of words (plain word count, not spoken equivalents). */
+    words: number;
+    /** Estimated minutes (decimal). */
+    minutes: number;
+    /** Estimated seconds (rounded). */
+    seconds: number;
+}
+/** Options for reading-time estimation. */
+interface ReadingTimeOptions {
+    /** Words per minute for silent reading (default: 200). */
+    wordsPerMinute?: number;
+}
+/**
+ * Estimate silent reading time for a block of text.
+ *
+ * @param text - The text to estimate
+ * @param options - Optional configuration
+ * @returns Word count + time estimate
+ */
+declare function estimateReadingTime(text: string, options?: ReadingTimeOptions): ReadingTimeEstimate;
+/** Result of a narration-time estimate. */
+interface NarrationTimeEstimate {
+    /** Spoken word equivalents (numbers expanded, comma pauses added). */
+    spokenWords: number;
+    /** Estimated minutes (decimal). */
+    minutes: number;
+    /** Estimated seconds (rounded). */
+    seconds: number;
+}
+/** Options for narration-time estimation. */
+interface NarrationTimeOptions {
+    /** Words per second for narration (default: 2.5 ≈ 150 WPM). */
+    wordsPerSecond?: number;
+}
+/**
+ * Estimate narration (spoken) time for a block of text.
+ *
+ * Unlike silent reading, this accounts for numbers being spoken as
+ * multiple words and pauses at commas.
+ *
+ * @param text - The text to estimate
+ * @param options - Optional configuration
+ * @returns Spoken word equivalents + time estimate
+ */
+declare function estimateNarrationTime(text: string, options?: NarrationTimeOptions): NarrationTimeEstimate;
+
+export { DEFAULT_WORDS_PER_SECOND, type NarrationTimeEstimate, type NarrationTimeOptions, type ReadingTimeEstimate, type ReadingTimeOptions, calculatePrefixDuration, countSpokenWords, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText };

package/dist/timing/index.js

@@ -1,3 +1,24 @@
-export { DEFAULT_WORDS_PER_SECOND, estimateSpokenWordCount, countSpokenWords, estimateTimeFromText, calculatePrefixDuration, estimateNarrationDuration, } from './narrationTiming.js';
-export { estimateReadingTime, estimateNarrationTime } from './readingTime.js';
+import "../chunk-DNJKBAI7.js";
+import {
+  estimateNarrationTime,
+  estimateReadingTime
+} from "../chunk-4X3JQXNM.js";
+import {
+  DEFAULT_WORDS_PER_SECOND,
+  calculatePrefixDuration,
+  countSpokenWords,
+  estimateNarrationDuration,
+  estimateSpokenWordCount,
+  estimateTimeFromText
+} from "../chunk-3E5F2XMR.js";
+export {
+  DEFAULT_WORDS_PER_SECOND,
+  calculatePrefixDuration,
+  countSpokenWords,
+  estimateNarrationDuration,
+  estimateNarrationTime,
+  estimateReadingTime,
+  estimateSpokenWordCount,
+  estimateTimeFromText
+};
 //# sourceMappingURL=index.js.map

package/dist/timing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/timing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}