@kongyo2/kongyoroid 1.0.0 → 2.1.0

package/dist/synth/textstream.js

@@ -0,0 +1,209 @@
+import { KongyoroidError, aborted, checkAbort } from "../errors.js";
+import { LIMITS } from "../limits.js";
+import { isNothingReadable } from "../text/frontend.js";
+import { isSentenceCloser } from "../text/sentences.js";
+import { compileRequest } from "./engine.js";
+import { boundaryPauseSeconds, utteranceFinalPauseSeconds } from "./speech.js";
+import { renderPcmStream } from "./stream.js";
+const TERMINALS = /[。！？!?\n]/u;
+export function takeSentences(buffer, maxChars, complete = true) {
+    const sentences = [];
+    let rest = buffer;
+    while (rest.length > 0) {
+        const match = TERMINALS.exec(rest);
+        if (match === null) {
+            if (Array.from(rest).length >= maxChars) {
+                const chars = Array.from(rest);
+                const cut = lastPauseIndex(chars, maxChars);
+                sentences.push(chars.slice(0, cut).join(""));
+                rest = chars.slice(cut).join("");
+                continue;
+            }
+            break;
+        }
+        let end = match.index + match[0].length;
+        while (end < rest.length && (TERMINALS.test(rest[end] ?? "") || isSentenceCloser(rest[end] ?? "")))
+            end += 1;
+        if (end >= rest.length && !complete)
+            break;
+        const sentence = rest.slice(0, end);
+        rest = rest.slice(end);
+        if (sentence.trim().length > 0)
+            sentences.push(sentence);
+    }
+    return { sentences, rest };
+}
+function nextChunk(pending, waitMs, signal) {
+    if (waitMs === undefined && signal === undefined)
+        return pending;
+    let timer;
+    let onAbort;
+    const interrupt = new Promise((resolve, reject) => {
+        if (signal?.aborted === true) {
+            reject(aborted("Streaming cancelled."));
+            return;
+        }
+        if (waitMs !== undefined)
+            timer = setTimeout(() => resolve(undefined), waitMs);
+        if (signal !== undefined) {
+            onAbort = () => reject(aborted("Streaming cancelled."));
+            signal.addEventListener("abort", onAbort, { once: true });
+        }
+    });
+    return Promise.race([pending, interrupt]).finally(() => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (onAbort !== undefined)
+            signal?.removeEventListener("abort", onAbort);
+    });
+}
+function observed(promise) {
+    promise.catch(() => undefined);
+    return promise;
+}
+function lastPauseIndex(chars, maxChars) {
+    for (let index = Math.min(chars.length, maxChars) - 1; index > maxChars / 2; index--) {
+        const char = chars[index];
+        if (char === "、" || char === "," || char === " " || char === "　")
+            return index + 1;
+    }
+    return Math.min(chars.length, maxChars);
+}
+export async function* synthesizeTextStream(chunks, request, options = {}) {
+    const maxChars = options.maxSentenceChars ?? LIMITS.streamSentenceChars;
+    const sampleRate = options.sampleRate ?? 24_000;
+    const timing = {
+        speed: request.speed,
+        pauseLength: request.pauseLength,
+        pauseScale: request.pauseScale,
+    };
+    let buffer = "";
+    let index = 0;
+    let sequence = 0;
+    let frames = 0;
+    let lastBoundary;
+    let lastParagraphEnd = false;
+    let pendingPlan;
+    let unreadable;
+    const leadPause = () => {
+        if (lastBoundary === undefined)
+            return request.prePause;
+        return Math.max(0, boundaryPauseSeconds(lastBoundary, timing, lastParagraphEnd) - utteranceFinalPauseSeconds(lastBoundary, timing));
+    };
+    const compile = (text) => observed(compileRequest({ ...request, text, prePause: leadPause(), postPause: 0 }, sampleRate, options).then((compiled) => compiled.plan, (error) => {
+        if (!isNothingReadable(error))
+            throw error;
+        unreadable = error;
+        return undefined;
+    }));
+    const emit = async function* (text) {
+        const plan = await (pendingPlan ?? compile(text));
+        pendingPlan = undefined;
+        if (plan === undefined)
+            return;
+        lastBoundary = plan.reading?.phrases.at(-1)?.boundary ?? "sentence";
+        lastParagraphEnd = plan.reading?.sentences.at(-1)?.paragraphEnd ?? false;
+        const startFrame = frames;
+        yield {
+            type: "sentence",
+            index,
+            text,
+            kana: plan.reading?.kana ?? "",
+            durationSeconds: plan.frames / plan.sampleRate,
+            frames: plan.frames,
+            warnings: plan.warnings,
+            startFrame,
+        };
+        const iterator = renderPcmStream(plan, {
+            ...(options.blockFrames === undefined ? {} : { blockFrames: options.blockFrames }),
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        });
+        while (true) {
+            const next = await iterator.next();
+            if (next.done)
+                break;
+            yield { type: "audio", index, block: { ...next.value, start: next.value.start + startFrame }, sequence };
+            sequence += 1;
+        }
+        frames += plan.frames;
+        index += 1;
+    };
+    const queue = [];
+    const flushMs = options.flushMs !== undefined && options.flushMs > 0 ? options.flushMs : undefined;
+    const iterator = chunks[Symbol.asyncIterator]();
+    let arrivedAt = performance.now();
+    const read = () => observed(iterator.next().then((result) => {
+        arrivedAt = performance.now();
+        return result;
+    }));
+    let pending;
+    let exhausted = false;
+    let lastInputAt = arrivedAt;
+    try {
+        while (!exhausted) {
+            checkAbort(options.signal);
+            pending ??= read();
+            const waitMs = flushMs !== undefined && buffer.trim().length > 0
+                ? Math.max(0, flushMs - (performance.now() - lastInputAt))
+                : undefined;
+            const result = await nextChunk(pending, waitMs, options.signal);
+            if (result === undefined) {
+                const text = buffer;
+                buffer = "";
+                pendingPlan = undefined;
+                yield* emit(text);
+                continue;
+            }
+            pending = undefined;
+            if (result.done === true) {
+                exhausted = true;
+                break;
+            }
+            lastInputAt = arrivedAt;
+            buffer += result.value;
+            pending = read();
+            const taken = takeSentences(buffer, maxChars, false);
+            buffer = taken.rest;
+            queue.push(...taken.sentences);
+            while (queue.length > 0) {
+                const text = queue.shift();
+                if (text === undefined)
+                    break;
+                const following = queue[0];
+                yield* emit(text);
+                if (following !== undefined)
+                    pendingPlan = compile(following);
+            }
+        }
+    }
+    finally {
+        if (!exhausted) {
+            const closing = iterator.return?.();
+            if (options.signal?.aborted === true || pending !== undefined)
+                closing?.catch(() => undefined);
+            else
+                await closing;
+        }
+    }
+    const tail = takeSentences(buffer, maxChars);
+    for (const text of tail.rest.trim().length > 0 ? [...tail.sentences, tail.rest] : tail.sentences) {
+        pendingPlan = undefined;
+        yield* emit(text);
+    }
+    if (index === 0 && unreadable !== undefined)
+        throw unreadable;
+    const trailingFrames = index === 0 ? 0 : Math.round(request.postPause * sampleRate);
+    if (trailingFrames > 0) {
+        checkAbort(options.signal);
+        yield {
+            type: "audio",
+            index: index - 1,
+            block: { samples: new Float32Array(trailingFrames), start: frames, sampleRate },
+            sequence,
+        };
+        sequence += 1;
+        frames += trailingFrames;
+    }
+    yield { type: "end", sentences: index, frames, durationSeconds: frames / sampleRate };
+}
+//# sourceMappingURL=textstream.js.map

package/dist/synth/textstream.js.map

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

package/dist/synth/voice.d.ts

@@ -0,0 +1,64 @@
+export interface SingingDefaults {
+    readonly vibratoDepthCents: number;
+    readonly vibratoRateHz: number;
+    readonly vibratoDelaySeconds: number;
+    readonly vibratoFadeSeconds: number;
+    readonly portamentoSeconds: number;
+    readonly jitter: number;
+    readonly shimmerDb: number;
+}
+export interface VoiceProfile {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly profileVersion: number;
+    readonly baseF0: number;
+    readonly f0Min: number;
+    readonly f0Max: number;
+    readonly formantScale: number;
+    readonly bandwidthScale: number;
+    readonly f4: number;
+    readonly f5: number;
+    readonly rd: number;
+    readonly aspirationDb: number;
+    readonly jitter: number;
+    readonly shimmerDb: number;
+    readonly flutter: number;
+    readonly rateScale: number;
+    readonly gainDb: number;
+    readonly intonationScale: number;
+    readonly singing: SingingDefaults;
+}
+export declare const BUILTIN_VOICES: readonly VoiceProfile[];
+export declare const DEFAULT_VOICE_ID: string;
+export declare function normalizeVoiceId(value: string): string;
+export declare function isBuiltinVoiceId(value: string): boolean;
+export declare function resolveVoice(value: string | undefined, path?: string): VoiceProfile;
+export interface VoiceOverrides {
+    readonly baseF0?: number;
+    readonly formantScale?: number;
+    readonly rd?: number;
+    readonly aspirationDb?: number;
+    readonly jitter?: number;
+    readonly shimmerDb?: number;
+    readonly flutter?: number;
+    readonly gainDb?: number;
+}
+export declare function applyVoiceOverrides(profile: VoiceProfile, overrides: VoiceOverrides): VoiceProfile;
+export declare function voiceProfileHash(profile: VoiceProfile): string;
+export declare function describeVoice(profile: VoiceProfile): {
+    readonly id: string;
+    readonly name: string;
+    readonly engine: "formant";
+    readonly description: string;
+    readonly kinds: readonly ["speech", "song"];
+    readonly profileVersion: number;
+    readonly baseF0: number;
+    readonly f0Range: {
+        readonly min: number;
+        readonly max: number;
+    };
+    readonly formantScale: number;
+    readonly hash: string;
+};
+//# sourceMappingURL=voice.d.ts.map

package/dist/synth/voice.d.ts.map

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

package/dist/synth/voice.js

@@ -0,0 +1,208 @@
+import { createHash } from "node:crypto";
+import { invalid } from "../errors.js";
+const BASE_SINGING = {
+    vibratoDepthCents: 30,
+    vibratoRateHz: 5.5,
+    vibratoDelaySeconds: 0.18,
+    vibratoFadeSeconds: 0.25,
+    portamentoSeconds: 0.06,
+    jitter: 0.002,
+    shimmerDb: 0.15,
+};
+function voice(partial) {
+    return {
+        profileVersion: 1,
+        ...partial,
+        singing: { ...BASE_SINGING, ...(partial.singing ?? {}) },
+    };
+}
+const VOICES = [
+    voice({
+        id: "neutral",
+        name: "Neutral",
+        description: "Androgynous mid voice; the default for notifications and verification.",
+        baseF0: 170,
+        f0Min: 70,
+        f0Max: 900,
+        formantScale: 1.09,
+        bandwidthScale: 1,
+        f4: 3400,
+        f5: 4300,
+        rd: 1.05,
+        aspirationDb: -32,
+        jitter: 0.006,
+        shimmerDb: 0.3,
+        flutter: 0.35,
+        rateScale: 1,
+        gainDb: 0,
+        intonationScale: 1,
+    }),
+    voice({
+        id: "female",
+        name: "Female",
+        description: "Higher voice with a shorter vocal tract and slightly breathier phonation.",
+        baseF0: 225,
+        f0Min: 110,
+        f0Max: 1100,
+        formantScale: 1.18,
+        bandwidthScale: 1.1,
+        f4: 3500,
+        f5: 4400,
+        rd: 1.3,
+        aspirationDb: -30,
+        jitter: 0.006,
+        shimmerDb: 0.3,
+        flutter: 0.35,
+        rateScale: 1,
+        gainDb: 0,
+        intonationScale: 1.05,
+        singing: { vibratoRateHz: 5.8 },
+    }),
+    voice({
+        id: "male",
+        name: "Male",
+        description: "Lower voice with a longer vocal tract and a tenser glottal source.",
+        baseF0: 115,
+        f0Min: 55,
+        f0Max: 700,
+        formantScale: 1,
+        bandwidthScale: 1,
+        f4: 3300,
+        f5: 4200,
+        rd: 0.9,
+        aspirationDb: -34,
+        jitter: 0.006,
+        shimmerDb: 0.3,
+        flutter: 0.35,
+        rateScale: 1,
+        gainDb: 0,
+        intonationScale: 0.95,
+        singing: { vibratoRateHz: 5.2 },
+    }),
+    voice({
+        id: "child",
+        name: "Child",
+        description: "Small vocal tract and high pitch.",
+        baseF0: 290,
+        f0Min: 150,
+        f0Max: 1300,
+        formantScale: 1.32,
+        bandwidthScale: 1.2,
+        f4: 3800,
+        f5: 4800,
+        rd: 1.2,
+        aspirationDb: -30,
+        jitter: 0.008,
+        shimmerDb: 0.4,
+        flutter: 0.4,
+        rateScale: 1.05,
+        gainDb: -1,
+        intonationScale: 1.15,
+        singing: { vibratoRateHz: 6 },
+    }),
+    voice({
+        id: "soft",
+        name: "Soft",
+        description: "Breathy, relaxed phonation with gentle intonation; good for quiet notifications.",
+        baseF0: 185,
+        f0Min: 80,
+        f0Max: 900,
+        formantScale: 1.1,
+        bandwidthScale: 1.25,
+        f4: 3400,
+        f5: 4300,
+        rd: 1.9,
+        aspirationDb: -22,
+        jitter: 0.005,
+        shimmerDb: 0.4,
+        flutter: 0.3,
+        rateScale: 0.95,
+        gainDb: -2,
+        intonationScale: 0.8,
+        singing: { vibratoDepthCents: 22, vibratoRateHz: 5.2 },
+    }),
+    voice({
+        id: "bright",
+        name: "Bright",
+        description: "Tense, clear phonation with lively intonation; carries well over noise.",
+        baseF0: 215,
+        f0Min: 100,
+        f0Max: 1100,
+        formantScale: 1.14,
+        bandwidthScale: 0.9,
+        f4: 3600,
+        f5: 4500,
+        rd: 0.65,
+        aspirationDb: -36,
+        jitter: 0.005,
+        shimmerDb: 0.25,
+        flutter: 0.3,
+        rateScale: 1.05,
+        gainDb: 0,
+        intonationScale: 1.2,
+        singing: { vibratoDepthCents: 35, vibratoRateHz: 6 },
+    }),
+    voice({
+        id: "deep",
+        name: "Deep",
+        description: "Very low voice with a long vocal tract; calm and authoritative.",
+        baseF0: 92,
+        f0Min: 45,
+        f0Max: 600,
+        formantScale: 0.95,
+        bandwidthScale: 1,
+        f4: 3200,
+        f5: 4100,
+        rd: 0.95,
+        aspirationDb: -34,
+        jitter: 0.006,
+        shimmerDb: 0.3,
+        flutter: 0.3,
+        rateScale: 0.95,
+        gainDb: 0,
+        intonationScale: 0.85,
+        singing: { vibratoRateHz: 5 },
+    }),
+];
+const VOICE_BY_ID = new Map(VOICES.map((profile) => [profile.id, profile]));
+export const BUILTIN_VOICES = VOICES;
+export const DEFAULT_VOICE_ID = "neutral";
+export function normalizeVoiceId(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/^builtin:/u, "");
+}
+export function isBuiltinVoiceId(value) {
+    return VOICE_BY_ID.has(normalizeVoiceId(value));
+}
+export function resolveVoice(value, path = "$.voice") {
+    const profile = VOICE_BY_ID.get(normalizeVoiceId(value ?? DEFAULT_VOICE_ID));
+    if (profile === undefined) {
+        invalid(path, `Unknown built-in voice ${JSON.stringify(value)}.`, {
+            hint: `Available voices: ${VOICES.map((v) => v.id).join(", ")}. Run: kongyoroid voices`,
+        });
+    }
+    return profile;
+}
+export function applyVoiceOverrides(profile, overrides) {
+    return { ...profile, ...overrides };
+}
+export function voiceProfileHash(profile) {
+    return createHash("sha256").update(JSON.stringify(profile)).digest("hex").slice(0, 16);
+}
+export function describeVoice(profile) {
+    return {
+        id: profile.id,
+        name: profile.name,
+        engine: "formant",
+        description: profile.description,
+        kinds: ["speech", "song"],
+        profileVersion: profile.profileVersion,
+        baseF0: profile.baseF0,
+        f0Range: { min: profile.f0Min, max: profile.f0Max },
+        formantScale: profile.formantScale,
+        hash: voiceProfileHash(profile),
+    };
+}
+//# sourceMappingURL=voice.js.map

package/dist/synth/voice.js.map

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

package/dist/text/dictionary.d.ts

@@ -0,0 +1,50 @@
+import type { JsonObject } from "../validate.ts";
+import type { Substitution } from "./normalize.ts";
+export type DictionaryMatch = "word" | "anywhere";
+export interface DictionaryEntry {
+    readonly id: string;
+    readonly surface: string;
+    readonly reading: string;
+    readonly accent: number | null;
+    readonly match: DictionaryMatch;
+    readonly priority: number;
+    readonly caseSensitive: boolean;
+    readonly note?: string;
+}
+export interface DictionaryEntryInput {
+    readonly id?: string;
+    readonly surface: string;
+    readonly reading: string;
+    readonly accent?: number | null;
+    readonly match?: DictionaryMatch;
+    readonly priority?: number;
+    readonly caseSensitive?: boolean;
+    readonly note?: string;
+}
+export declare const DICTIONARY_ENTRY_KEYS: readonly string[];
+export declare function parseDictionaryEntry(value: unknown, path: string, index?: number): DictionaryEntry;
+export declare function parseDictionaryEntries(value: unknown, path?: string): readonly DictionaryEntry[];
+export declare class LocalDictionary {
+    private readonly entries;
+    constructor(entries?: readonly DictionaryEntry[]);
+    static load(path: string): Promise<LocalDictionary>;
+    get size(): number;
+    list(): readonly DictionaryEntry[];
+    get(id: string): DictionaryEntry | undefined;
+    find(surface: string): readonly DictionaryEntry[];
+    upsert(input: DictionaryEntryInput): {
+        readonly entry: DictionaryEntry;
+        readonly created: boolean;
+    };
+    remove(id: string): boolean;
+    merge(other: LocalDictionary): LocalDictionary;
+    toJSON(): {
+        readonly entries: readonly DictionaryEntry[];
+    };
+    digest(): string;
+    substitutions(): readonly Substitution[];
+    private nextIndex;
+}
+export declare function dictionaryFromJson(value: unknown, path?: string): LocalDictionary;
+export declare function isDictionaryJson(value: unknown): value is JsonObject | readonly unknown[];
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/text/dictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../src/text/dictionary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EASlD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,eAAe,CA6BrG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAuB,GAAG,SAAS,eAAe,EAAE,CAgBhH;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEzB,OAAO,GAAE,SAAS,eAAe,EAAO;WAIvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgChE,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,IAAI,IAAI,SAAS,eAAe,EAAE;IAIlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE;IAKjD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAenG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IAM9C,MAAM,IAAI;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAA;KAAE;IAI1D,MAAM,IAAI,MAAM;IAShB,aAAa,IAAI,SAAS,YAAY,EAAE;IAa/C,OAAO,CAAC,SAAS;CAQlB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAuB,GAAG,eAAe,CAEjG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,GAAG,SAAS,OAAO,EAAE,CAEzF"}

package/dist/text/dictionary.js.map

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

package/dist/text/frontend.d.ts

@@ -0,0 +1,35 @@
+import { KongyoroidError } from "../errors.ts";
+import type { LocalDictionary } from "./dictionary.ts";
+import type { AccentPhrase } from "./notation.ts";
+import type { FrontendKind, ReadingPlan } from "./reading.ts";
+export interface TextFrontend {
+    readonly name: string;
+    readonly version: string;
+    convert(sentence: string): string;
+}
+export type FrontendState = "unloaded" | "loading" | "ready" | "failed";
+export declare function loadFrontend(): Promise<TextFrontend>;
+export declare function frontendState(): {
+    readonly state: FrontendState;
+    readonly error: KongyoroidError | undefined;
+};
+export interface ReadOptions {
+    readonly dictionary?: LocalDictionary;
+    readonly strict?: boolean;
+    readonly lexicon?: boolean;
+    readonly signal?: AbortSignal;
+    readonly frontend?: TextFrontend;
+    readonly path?: string;
+}
+export declare function isNothingReadable(error: unknown): error is KongyoroidError;
+export declare function readJapanese(text: string, options?: ReadOptions): Promise<ReadingPlan>;
+export declare function applyDevoicingRules(phrases: readonly AccentPhrase[]): AccentPhrase[];
+export interface KanaReadOptions {
+    readonly devoicing?: boolean;
+    readonly path?: string;
+    readonly frontend?: FrontendKind;
+}
+export declare function readKanaNotation(kana: string, options?: KanaReadOptions): ReadingPlan;
+export declare function readKanaHeuristically(text: string, path?: string): ReadingPlan;
+export declare function readingPlanLimits(plan: ReadingPlan, path?: string): void;
+//# sourceMappingURL=frontend.d.ts.map

package/dist/text/frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.d.ts","sourceRoot":"","sources":["../../src/text/frontend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAuB,MAAM,cAAc,CAAC;AAIpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAIhE,OAAO,KAAK,EAEV,YAAY,EAGZ,WAAW,EAEZ,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAwBxE,wBAAgB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAqBpD;AAED,wBAAgB,aAAa,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;CAAE,CAE9G;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAsMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4JhG;AAmBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAgCpF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,WAAW,CA+BzF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiB,GAAG,WAAW,CAwExF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,MAAiB,GAAG,IAAI,CAGlF"}