@bendyline/squisq 1.4.0 → 1.5.0

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

@@ -1 +0,0 @@
-{"version":3,"file":"ScopedContentContainer.d.ts","sourceRoot":"","sources":["../../src/storage/ScopedContentContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAkB5E;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM;IAMpD,OAAO,CAAC,QAAQ;IAMhB,gGAAgG;IAChG,OAAO,CAAC,UAAU;IAKlB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAInD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAYzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,uCAAuC;IACjC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAMrC;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAE/F"}

package/dist/storage/ScopedContentContainer.js

@@ -1,94 +0,0 @@
-/**
- * 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.
- */
-/** Normalize a prefix: strip leading/trailing slashes, ensure no `..` segments. */
-function normalizePrefix(prefix) {
-    let p = prefix.trim();
-    while (p.startsWith('/'))
-        p = p.slice(1);
-    while (p.endsWith('/'))
-        p = p.slice(0, -1);
-    if (p.length === 0) {
-        throw new Error('ScopedContentContainer: prefix must not be empty');
-    }
-    if (p.split('/').some((seg) => seg === '..' || seg === '.')) {
-        throw new Error(`ScopedContentContainer: prefix must not contain '.' or '..' segments: ${prefix}`);
-    }
-    return p;
-}
-/**
- * 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.
- */
-export class ScopedContentContainer {
-    constructor(parent, prefix) {
-        this.parent = parent;
-        this.prefix = normalizePrefix(prefix);
-        this.prefixSlash = `${this.prefix}/`;
-    }
-    toParent(path) {
-        let p = path;
-        while (p.startsWith('/'))
-            p = p.slice(1);
-        return this.prefixSlash + p;
-    }
-    /** Strip the prefix from a parent-space path. Returns null if the path is outside the scope. */
-    fromParent(parentPath) {
-        if (!parentPath.startsWith(this.prefixSlash))
-            return null;
-        return parentPath.slice(this.prefixSlash.length);
-    }
-    readFile(path) {
-        return this.parent.readFile(this.toParent(path));
-    }
-    writeFile(path, data, mimeType) {
-        return this.parent.writeFile(this.toParent(path), data, mimeType);
-    }
-    removeFile(path) {
-        return this.parent.removeFile(this.toParent(path));
-    }
-    async listFiles(prefix) {
-        const parentPrefix = prefix ? this.toParent(prefix) : this.prefixSlash;
-        const entries = await this.parent.listFiles(parentPrefix);
-        const out = [];
-        for (const e of entries) {
-            const local = this.fromParent(e.path);
-            if (local === null)
-                continue;
-            out.push({ path: local, mimeType: e.mimeType, size: e.size });
-        }
-        return out;
-    }
-    exists(path) {
-        return this.parent.exists(this.toParent(path));
-    }
-    /** Sidecars are not document roots. */
-    async getDocumentPath() {
-        return null;
-    }
-    async readDocument() {
-        return null;
-    }
-    async writeDocument() {
-        throw new Error('ScopedContentContainer is a sidecar view and does not support writeDocument(). ' +
-            'Write to a specific path with writeFile() instead.');
-    }
-}
-/** Factory: convenience wrapper for `new ScopedContentContainer(parent, prefix)`. */
-export function scopeContainer(parent, prefix) {
-    return new ScopedContentContainer(parent, prefix);
-}
-//# sourceMappingURL=ScopedContentContainer.js.map

package/dist/storage/ScopedContentContainer.js.map

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

package/dist/storage/Storage.d.ts

@@ -1,23 +0,0 @@
-/**
- * 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 */
-export 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;
-}
-//# sourceMappingURL=Storage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC,4BAA4B;IAC5B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,qDAAqD;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,0CAA0C;IAC1C,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1B,iDAAiD;IACjD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC"}

package/dist/storage/Storage.js

@@ -1,9 +0,0 @@
-/**
- * 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.
- */
-export {};
-//# sourceMappingURL=Storage.js.map

package/dist/storage/Storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Storage.js","sourceRoot":"","sources":["../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -1 +0,0 @@
-{"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,sBAAsB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -1 +0,0 @@
-{"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/narrationTiming.d.ts

@@ -1,54 +0,0 @@
-/**
- * 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

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

@@ -1,190 +0,0 @@
-/**
- * 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

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

package/dist/timing/readingTime.d.ts

@@ -1,54 +0,0 @@
-/**
- * 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

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

@@ -1,49 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/dist/transform/applyTransform.d.ts

@@ -1,22 +0,0 @@
-/**
- * Apply Transform
- *
- * Main entry point for the transform module. Takes a Doc and a style,
- * analyzes block content, selects extractions to promote, and returns
- * a new Doc with blocks optimized for visual presentation.
- *
- * The input Doc is never mutated — a fresh Doc is always returned.
- */
-import type { Doc } from '../schemas/Doc.js';
-import type { TransformStyleId, TransformOptions, TransformResult } from './types.js';
-/**
- * Apply a transform style to a Doc, producing a new Doc with blocks
- * 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.
- * @returns TransformResult with the new Doc and stats.
- */
-export declare function applyTransform(doc: Doc, styleId: TransformStyleId, options?: TransformOptions): TransformResult;
-//# sourceMappingURL=applyTransform.d.ts.map

package/dist/transform/applyTransform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyTransform.d.ts","sourceRoot":"","sources":["../../src/transform/applyTransform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOtF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAmDjB"}

package/dist/transform/applyTransform.js

@@ -1,68 +0,0 @@
-/**
- * Apply Transform
- *
- * Main entry point for the transform module. Takes a Doc and a style,
- * analyzes block content, selects extractions to promote, and returns
- * a new Doc with blocks optimized for visual presentation.
- *
- * The input Doc is never mutated — a fresh Doc is always returned.
- */
-import { resolveTransformStyle } from './registry.js';
-import { analyzeBlocks, extractDocImages } from './blockAnalyzer.js';
-import { selectAndBuild } from './templateSelector.js';
-import { allocateTiming } from './timingAllocator.js';
-import { hashString } from '../random/SeededRandom.js';
-/**
- * Apply a transform style to a Doc, producing a new Doc with blocks
- * 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.
- * @returns TransformResult with the new Doc and stats.
- */
-export function applyTransform(doc, styleId, options) {
-    const baseConfig = resolveTransformStyle(styleId);
-    const config = options?.overrides
-        ? { ...baseConfig, ...options.overrides, id: baseConfig.id }
-        : baseConfig;
-    const seed = options?.seed ?? hashString(doc.articleId || 'transform');
-    // Use provided images or auto-extract from the doc's markdown content
-    const images = options?.images ?? extractDocImages(doc.blocks);
-    // 1. Analyze blocks
-    const analyzed = analyzeBlocks(doc.blocks, {
-        minConfidence: config.minConfidence,
-        types: config.preferredTypes,
-    });
-    // If no blocks have meaningful content, return the doc unchanged
-    const hasContent = analyzed.some((ab) => ab.bodyWordCount >= 5);
-    if (!hasContent) {
-        return {
-            doc: { ...doc },
-            stats: {
-                totalInputBlocks: doc.blocks.length,
-                transformedBlocks: 0,
-                insertedBlocks: 0,
-            },
-        };
-    }
-    // 2. Select extractions and build template blocks
-    const selection = selectAndBuild(analyzed, config, images, seed);
-    // 3. Allocate timing across the new block sequence
-    const timedBlocks = allocateTiming(selection.blocks, doc.duration);
-    // 4. Assemble the output Doc
-    const transformedDoc = {
-        ...doc,
-        blocks: timedBlocks,
-        themeId: options?.themeId ?? doc.themeId,
-    };
-    return {
-        doc: transformedDoc,
-        stats: {
-            totalInputBlocks: doc.blocks.length,
-            transformedBlocks: selection.transformedCount,
-            insertedBlocks: selection.insertedCount,
-        },
-    };
-}
-//# sourceMappingURL=applyTransform.js.map

package/dist/transform/applyTransform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyTransform.js","sourceRoot":"","sources":["../../src/transform/applyTransform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAQ,EACR,OAAyB,EACzB,OAA0B;IAE1B,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,EAAE,SAAS;QAC/B,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE;QAC5D,CAAC,CAAC,UAAU,CAAC;IAEf,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,IAAI,WAAW,CAAC,CAAC;IAEvE,sEAAsE;IACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/D,oBAAoB;IACpB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;QACzC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,KAAK,EAAE,MAAM,CAAC,cAAc;KAC7B,CAAC,CAAC;IAEH,iEAAiE;IACjE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE;YACf,KAAK,EAAE;gBACL,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;gBACnC,iBAAiB,EAAE,CAAC;gBACpB,cAAc,EAAE,CAAC;aAClB;SACF,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEjE,mDAAmD;IACnD,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEnE,6BAA6B;IAC7B,MAAM,cAAc,GAAQ;QAC1B,GAAG,GAAG;QACN,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG,CAAC,OAAO;KACzC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE;YACL,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;YACnC,iBAAiB,EAAE,SAAS,CAAC,gBAAgB;YAC7C,cAAc,EAAE,SAAS,CAAC,aAAa;SACxC;KACF,CAAC;AACJ,CAAC"}