@bendyline/squisq 0.1.2 → 1.1.0

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/storage/index.js

@@ -1,11 +1,6 @@
-import {
-  LocalForageAdapter,
-  LocalStorageAdapter,
-  MemoryStorageAdapter
-} from "../chunk-VJN7UB2Z.js";
-export {
-  LocalForageAdapter,
-  LocalStorageAdapter,
-  MemoryStorageAdapter
-};
+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';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"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"}

package/dist/story/index.d.ts

@@ -1,6 +1,7 @@
-import { z as PersistentLayer, L as Layer, E as PersistentLayerConfig, a9 as TitleBlockInput, $ as TemplateContext, U as SectionHeaderInput, Y as StatHighlightInput, S as QuoteBlockInput, F as FactCardInput, ad as TwoColumnInput, m as DateEventInput, t as ImageWithCaptionInput, M as MapBlockInput, X as StartBlockConfig, r as FullBleedQuoteInput, v as ListBlockInput, N as PhotoGridInput, o as DefinitionCardInput, h as ComparisonBarInput, R as PullQuoteInput, ah as VideoWithCaptionInput, ag as VideoPullQuoteInput, A as AccentImage, a as AccentPosition, a4 as Theme, ai as ViewportConfig, q as DocBlock, B as Block, _ as TemplateBlock, a1 as TemplateRegistry, b as Animation, c as AnimationType, ac as TransitionType, a6 as ThemeColorScheme, p as Doc } from '../themeLibrary-DySHPcgj.js';
-export { j as DEFAULT_THEME, u as LayoutHints, T as RenderStyle, a5 as ThemeColorPalette, a7 as ThemeStyle, a8 as ThemeTypography, ae as VIEWPORT_PRESETS, aj as ViewportOrientation, ak as ViewportPreset, an as createTemplateContext, aq as getAvailableThemes, at as getLayoutHints, aw as getThemeSummaries, ax as getTwoColumnPositions, ay as getViewport, az as getViewportOrientation, aB as isTemplateBlock, aD as resolveTheme, aE as scaledFontSize } from '../themeLibrary-DySHPcgj.js';
+import { x as PersistentLayer, L as Layer, y as PersistentLayerConfig, a6 as TitleBlockInput, Y as TemplateContext, S as SectionHeaderInput, W as StatHighlightInput, Q as QuoteBlockInput, F as FactCardInput, aa as TwoColumnInput, k as DateEventInput, r as ImageWithCaptionInput, M as MapBlockInput, V as StartBlockConfig, p as FullBleedQuoteInput, t as ListBlockInput, J as PhotoGridInput, m as DefinitionCardInput, h as ComparisonBarInput, O as PullQuoteInput, ae as VideoWithCaptionInput, ad as VideoPullQuoteInput, A as AccentImage, a as AccentPosition, a1 as Theme, af as ViewportConfig, o as DocBlock, B as Block, X as TemplateBlock, _ as TemplateRegistry, b as Animation, c as AnimationType, a9 as TransitionType, a3 as ThemeColorScheme, n as Doc } from '../Doc-1hmT1LZl.js';
+export { s as LayoutHints, R as RenderStyle, a2 as ThemeColorPalette, a4 as ThemeStyle, a5 as ThemeTypography, ab as VIEWPORT_PRESETS, ag as ViewportOrientation, ah as ViewportPreset, ak as createTemplateContext, ap as getLayoutHints, as as getTwoColumnPositions, at as getViewport, au as getViewportOrientation, aw as isTemplateBlock, ay as scaledFontSize } from '../Doc-1hmT1LZl.js';
 import { p as MarkdownHeading, l as MarkdownDocument } from '../types-DHiv_Pnm.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DR1VRo-8.js';
 
 /**
  * Persistent Layers Expansion

package/dist/themeLibrary-DR1VRo-8.d.ts

@@ -0,0 +1,44 @@
+import { a1 as Theme } from './Doc-1hmT1LZl.js';
+
+/**
+ * Built-in Theme Library
+ *
+ * Ships 8 curated themes covering documentary, editorial, minimal, and
+ * cinematic styles. Each theme is fully JSON-serializable.
+ *
+ * Usage:
+ * ```ts
+ * import { THEMES, resolveTheme } from '@bendyline/squisq/schemas';
+ *
+ * const theme = resolveTheme('minimalist'); // look up by id
+ * const theme = THEMES.documentary;         // direct access
+ * ```
+ */
+
+/**
+ * All built-in themes, keyed by id.
+ */
+declare const THEMES: Record<string, Theme>;
+/** The default theme id. */
+declare const DEFAULT_THEME_ID = "documentary";
+/** The default theme (documentary — migrated from old DEFAULT_THEME). */
+declare const DEFAULT_THEME: Theme;
+/**
+ * Resolve a theme by id. Returns the default theme when `id` is
+ * undefined or not found in the library.
+ */
+declare function resolveTheme(id: string | undefined): Theme;
+/**
+ * Get all available theme ids.
+ */
+declare function getAvailableThemes(): string[];
+/**
+ * Get a summary of all 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

@@ -0,0 +1,4 @@
+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

package/dist/timing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AAE9E,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/timing/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_WORDS_PER_SECOND, estimateSpokenWordCount, countSpokenWords, estimateTimeFromText, calculatePrefixDuration, estimateNarrationDuration, } from './narrationTiming.js';
+export { estimateReadingTime, estimateNarrationTime } from './readingTime.js';
+//# sourceMappingURL=index.js.map

package/dist/timing/index.js.map

@@ -0,0 +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"}

package/dist/timing/narrationTiming.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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). */
+export 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).
+ */
+export declare function estimateSpokenWordCount(token: string): number;
+/**
+ * Count "spoken word equivalents" in a block of text,
+ * expanding numbers and adding comma pauses.
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function estimateNarrationDuration(text: string, wordsPerSecond?: number): number;
+//# sourceMappingURL=narrationTiming.d.ts.map

package/dist/timing/narrationTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrationTiming.d.ts","sourceRoot":"","sources":["../../src/timing/narrationTiming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7D;AA4FD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4BrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAiC,GAChD,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,cAAc,GAAE,MAAiC,GAChD,MAAM,CAGR"}

package/dist/timing/narrationTiming.js

@@ -0,0 +1,190 @@
+/**
+ * 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).
+ */
+/** Numbers are spoken more slowly than regular words (1.3× multiplier). */
+const NUMBER_SPEAKING_MULTIPLIER = 1.3;
+/** Comma pause in "word equivalents" — speakers pause ~0.3 words at commas. */
+const COMMA_PAUSE_PENALTY = 0.3;
+/** Default speaking rate in words per second (~150 WPM). */
+export 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).
+ */
+export function estimateSpokenWordCount(token) {
+    const cleaned = token.replace(/,/g, '');
+    const num = parseFloat(cleaned);
+    if (isNaN(num) || !isFinite(num)) {
+        return 1; // Not a number — count as 1 word
+    }
+    return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;
+}
+/**
+ * Raw word count for a number (before the speaking multiplier).
+ */
+function estimateNumberWordCount(cleaned, num) {
+    // Handle decimals: "3.14" → words("3") + "point" + 2 digits
+    if (cleaned.includes('.')) {
+        const [whole, decimal] = cleaned.split('.');
+        const wholeNum = parseFloat(whole) || 0;
+        return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;
+    }
+    const absNum = Math.abs(num);
+    let words = num < 0 ? 1 : 0; // "negative" / "minus"
+    if (absNum === 0)
+        return 1; // "zero"
+    // Years (1000–2099) are spoken as two two-digit groups:
+    // "1910" → "nineteen ten", "2024" → "twenty twenty-four"
+    if (absNum >= 1000 && absNum <= 2099 && Number.isInteger(absNum)) {
+        const yearStr = absNum.toString();
+        if (yearStr.length === 4) {
+            const firstTwo = parseInt(yearStr.slice(0, 2));
+            const lastTwo = parseInt(yearStr.slice(2));
+            // First part
+            if (firstTwo >= 10 && firstTwo <= 19) {
+                words += 1;
+            }
+            else if (firstTwo >= 20 && firstTwo <= 99) {
+                words += firstTwo % 10 === 0 ? 1 : 2;
+            }
+            else {
+                words += 2; // "two thousand"
+            }
+            // Second part
+            if (lastTwo === 0) {
+                if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {
+                    words += 1; // "hundred"
+                }
+            }
+            else if (lastTwo >= 1 && lastTwo <= 9) {
+                words += 2; // "oh five"
+            }
+            else if (lastTwo >= 10 && lastTwo <= 19) {
+                words += 1;
+            }
+            else {
+                words += lastTwo % 10 === 0 ? 1 : 2;
+            }
+            return Math.max(words, 2);
+        }
+    }
+    // General number handling — each magnitude group adds words
+    let remaining = absNum;
+    if (remaining >= 1000000000) {
+        const billions = Math.floor(remaining / 1000000000);
+        words += estimateNumberWordCount(String(billions), billions);
+        words += 1; // "billion"
+        remaining %= 1000000000;
+    }
+    if (remaining >= 1000000) {
+        const millions = Math.floor(remaining / 1000000);
+        words += estimateNumberWordCount(String(millions), millions);
+        words += 1; // "million"
+        remaining %= 1000000;
+    }
+    if (remaining >= 1000) {
+        const thousands = Math.floor(remaining / 1000);
+        words += estimateNumberWordCount(String(thousands), thousands);
+        words += 1; // "thousand"
+        remaining %= 1000;
+    }
+    if (remaining >= 100) {
+        words += 2; // digit + "hundred"
+        remaining %= 100;
+    }
+    if (remaining >= 1) {
+        if (remaining >= 20) {
+            words += remaining % 10 === 0 ? 1 : 2;
+        }
+        else {
+            words += 1; // 1–19
+        }
+    }
+    return Math.max(words, 1);
+}
+/**
+ * Count "spoken word equivalents" in a block of text,
+ * expanding numbers and adding comma pauses.
+ */
+export function countSpokenWords(text) {
+    const tokens = text.split(/\s+/).filter((w) => w.length > 0);
+    let count = 0;
+    for (const token of tokens) {
+        // Strip punctuation only at token boundaries so internal punctuation
+        // (e.g., decimals like "3.14" or digit-grouping commas "1,000") is preserved.
+        const stripped = token.replace(/^[.,!?;:'"()[\]{}]+|[.,!?;:'"()[\]{}]+$/g, '');
+        count += estimateSpokenWordCount(stripped);
+        // Count only punctuation commas for pauses: exclude digit-grouping commas
+        // (i.e., commas with digits on both sides, like in "1,234").
+        let punctuationCommaCount = 0;
+        for (let i = 0; i < token.length; i++) {
+            if (token[i] === ',') {
+                const prev = i > 0 ? token[i - 1] : '';
+                const next = i < token.length - 1 ? token[i + 1] : '';
+                const prevIsDigit = prev >= '0' && prev <= '9';
+                const nextIsDigit = next >= '0' && next <= '9';
+                if (!(prevIsDigit && nextIsDigit)) {
+                    punctuationCommaCount++;
+                }
+            }
+        }
+        count += punctuationCommaCount * COMMA_PAUSE_PENALTY;
+    }
+    return count;
+}
+/**
+ * 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
+ */
+export function estimateTimeFromText(text, charOffset, totalDuration) {
+    const textBefore = text.slice(0, charOffset);
+    const spokenWordsBefore = countSpokenWords(textBefore);
+    const totalSpokenWords = countSpokenWords(text);
+    if (totalSpokenWords === 0)
+        return 0;
+    return (spokenWordsBefore / totalSpokenWords) * totalDuration;
+}
+/**
+ * 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
+ */
+export function calculatePrefixDuration(prefix, wordsPerSecond = DEFAULT_WORDS_PER_SECOND) {
+    if (!prefix)
+        return 0;
+    const words = prefix.split(/\s+/).filter((w) => w.length > 0);
+    const newlineCount = (prefix.match(/\n\n/g) || []).length;
+    const pauseTime = newlineCount * 0.5;
+    return words.length / wordsPerSecond + pauseTime;
+}
+/**
+ * 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
+ */
+export function estimateNarrationDuration(text, wordsPerSecond = DEFAULT_WORDS_PER_SECOND) {
+    const spokenWords = countSpokenWords(text);
+    return spokenWords / wordsPerSecond;
+}
+//# sourceMappingURL=narrationTiming.js.map

package/dist/timing/narrationTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrationTiming.js","sourceRoot":"","sources":["../../src/timing/narrationTiming.ts"],"names":[],"mappings":"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"}

package/dist/timing/readingTime.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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. */
+export 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. */
+export 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
+ */
+export declare function estimateReadingTime(text: string, options?: ReadingTimeOptions): ReadingTimeEstimate;
+/** Result of a narration-time estimate. */
+export 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. */
+export 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
+ */
+export declare function estimateNarrationTime(text: string, options?: NarrationTimeOptions): NarrationTimeEstimate;
+//# sourceMappingURL=readingTime.d.ts.map

package/dist/timing/readingTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readingTime.d.ts","sourceRoot":"","sources":["../../src/timing/readingTime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,mBAAmB,CAYrB;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,qBAAqB,CAYvB"}

package/dist/timing/readingTime.js

@@ -0,0 +1,49 @@
+/**
+ * Reading time estimation.
+ *
+ * Estimates how long it takes to read text silently vs. narrate it aloud.
+ * Uses configurable words-per-minute rates.
+ */
+import { countSpokenWords, DEFAULT_WORDS_PER_SECOND } from './narrationTiming.js';
+/** Default silent reading rate (adults average ~200–250 WPM). */
+const DEFAULT_READING_WPM = 200;
+/**
+ * Estimate silent reading time for a block of text.
+ *
+ * @param text - The text to estimate
+ * @param options - Optional configuration
+ * @returns Word count + time estimate
+ */
+export function estimateReadingTime(text, options) {
+    const configuredWpm = options?.wordsPerMinute;
+    const wpm = typeof configuredWpm === 'number' && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;
+    const words = text.split(/\s+/).filter((w) => w.length > 0).length;
+    const minutes = words / wpm;
+    return {
+        words,
+        minutes,
+        seconds: Math.round(minutes * 60),
+    };
+}
+/**
+ * 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
+ */
+export function estimateNarrationTime(text, options) {
+    const providedWps = options?.wordsPerSecond;
+    const wps = typeof providedWps === 'number' && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;
+    const spokenWords = countSpokenWords(text);
+    const totalSeconds = spokenWords / wps;
+    return {
+        spokenWords,
+        minutes: totalSeconds / 60,
+        seconds: Math.round(totalSeconds),
+    };
+}
+//# sourceMappingURL=readingTime.js.map

package/dist/timing/readingTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readingTime.js","sourceRoot":"","sources":["../../src/timing/readingTime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAElF,iEAAiE;AACjE,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAkBhC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAA4B;IAE5B,MAAM,aAAa,GAAG,OAAO,EAAE,cAAc,CAAC;IAC9C,MAAM,GAAG,GACP,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;IAE5B,OAAO;QACL,KAAK;QACL,OAAO;QACP,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAkBD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,OAA8B;IAE9B,MAAM,WAAW,GAAG,OAAO,EAAE,cAAc,CAAC;IAC5C,MAAM,GAAG,GACP,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAC9F,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,WAAW,GAAG,GAAG,CAAC;IAEvC,OAAO;QACL,WAAW;QACX,OAAO,EAAE,YAAY,GAAG,EAAE;QAC1B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "0.1.2",
+  "version": "1.1.0",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",
@@ -65,12 +65,26 @@
       "types": "./dist/markdown/index.d.ts",
       "import": "./dist/markdown/index.js",
       "default": "./dist/markdown/index.js"
+    },
+    "./timing": {
+      "types": "./dist/timing/index.d.ts",
+      "import": "./dist/timing/index.js",
+      "default": "./dist/timing/index.js"
+    },
+    "./random": {
+      "types": "./dist/random/index.d.ts",
+      "import": "./dist/random/index.js",
+      "default": "./dist/random/index.js"
+    },
+    "./generate": {
+      "types": "./dist/generate/index.d.ts",
+      "import": "./dist/generate/index.js",
+      "default": "./dist/generate/index.js"
     }
   },
   "scripts": {
     "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "hast-util-from-html": "^2.0.0",