@mcptoolshop/voice-soundboard-core 0.1.0

package/dist/sfx/parser.js

@@ -0,0 +1,100 @@
+/** SFX tag parser — extracts [tag] sound effect directives from text. */
+import { SFX_TAGS } from "./types.js";
+import { SFX_MAX_EVENTS } from "./registry.js";
+const SFX_TAG_SET = new Set(SFX_TAGS);
+/**
+ * Regex to match SFX tags: [ding], [chime], [whoosh], etc.
+ * Also matches unknown bracket tags for warning purposes.
+ */
+const SFX_TAG_RE = /\[(\w+)\]/g;
+/** Check whether text contains any potential SFX tags. */
+export function hasSfxTags(text) {
+    return SFX_TAG_RE.test(text);
+}
+/**
+ * Parse SFX tags from text.
+ *
+ * When `enabled=false` (default), tags are left as literal text and a
+ * `SFX_DISABLED` warning is emitted. When `enabled=true`, known tags
+ * become `SfxEvent` segments interleaved with text segments.
+ *
+ * Unknown tags are always left as literal text with `SFX_UNKNOWN_TAG` warning.
+ * Exceeding `SFX_MAX_EVENTS` emits `SFX_MAX_EVENTS` warning and stops extracting.
+ */
+export function parseSfxTags(text, enabled = false) {
+    // Reset regex lastIndex since we use test() above
+    SFX_TAG_RE.lastIndex = 0;
+    const warnings = [];
+    if (!enabled) {
+        // Feature disabled — check if there are any tags and warn
+        SFX_TAG_RE.lastIndex = 0;
+        if (SFX_TAG_RE.test(text)) {
+            warnings.push({
+                code: "SFX_DISABLED",
+                message: "SFX tags detected but SFX feature is disabled; tags left as literal text",
+            });
+        }
+        return {
+            segments: [{ type: "text", value: text }],
+            warnings,
+            sfxCount: 0,
+        };
+    }
+    const segments = [];
+    let lastIndex = 0;
+    let sfxCount = 0;
+    let maxReached = false;
+    SFX_TAG_RE.lastIndex = 0;
+    for (const match of text.matchAll(SFX_TAG_RE)) {
+        const tagName = match[1].toLowerCase();
+        const matchStart = match.index;
+        // Emit any text before this tag
+        if (matchStart > lastIndex) {
+            const before = text.slice(lastIndex, matchStart);
+            if (before.trim()) {
+                segments.push({ type: "text", value: before.trim() });
+            }
+        }
+        if (!SFX_TAG_SET.has(tagName)) {
+            // Unknown tag — leave as literal
+            warnings.push({
+                code: "SFX_UNKNOWN_TAG",
+                message: `Unknown SFX tag [${tagName}], left as literal text`,
+            });
+            segments.push({ type: "text", value: match[0] });
+        }
+        else if (maxReached) {
+            // Over limit — leave as literal
+            segments.push({ type: "text", value: match[0] });
+        }
+        else {
+            sfxCount++;
+            if (sfxCount > SFX_MAX_EVENTS) {
+                maxReached = true;
+                warnings.push({
+                    code: "SFX_MAX_EVENTS",
+                    message: `Exceeded max SFX events (${SFX_MAX_EVENTS}); remaining tags left as literal text`,
+                });
+                segments.push({ type: "text", value: match[0] });
+                sfxCount--; // Don't count the one that exceeded
+            }
+            else {
+                segments.push({ type: "sfx", tag: tagName });
+            }
+        }
+        lastIndex = matchStart + match[0].length;
+    }
+    // Trailing text
+    if (lastIndex < text.length) {
+        const tail = text.slice(lastIndex);
+        if (tail.trim()) {
+            segments.push({ type: "text", value: tail.trim() });
+        }
+    }
+    // If no segments were created, return original text
+    if (segments.length === 0 && text.trim()) {
+        segments.push({ type: "text", value: text.trim() });
+    }
+    return { segments, warnings, sfxCount };
+}
+//# sourceMappingURL=parser.js.map

package/dist/sfx/parser.js.map

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

package/dist/sfx/registry.d.ts

@@ -0,0 +1,17 @@
+/** SFX registry — known tags and their WAV generation parameters. */
+import type { SfxTag } from "./types.js";
+export interface SfxGenParams {
+    /** Frequency in Hz (for sine-based sounds). */
+    readonly frequency: number;
+    /** Duration in milliseconds. */
+    readonly durationMs: number;
+    /** Waveform type. */
+    readonly waveform: "sine" | "noise" | "impulse" | "arpeggio";
+    /** Envelope type. */
+    readonly envelope: "decay" | "bell" | "sweep" | "burst" | "rising";
+}
+/** Generation parameters for each known SFX tag. */
+export declare const SFX_REGISTRY: Readonly<Record<SfxTag, SfxGenParams>>;
+/** Max SFX events allowed per text. */
+export declare const SFX_MAX_EVENTS = 30;
+//# sourceMappingURL=registry.d.ts.map

package/dist/sfx/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sfx/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7D,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;CACpE;AAED,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAO/D,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,cAAc,KAAK,CAAC"}

package/dist/sfx/registry.js

@@ -0,0 +1,13 @@
+/** SFX registry — known tags and their WAV generation parameters. */
+/** Generation parameters for each known SFX tag. */
+export const SFX_REGISTRY = {
+    ding: { frequency: 880, durationMs: 200, waveform: "sine", envelope: "decay" },
+    chime: { frequency: 1047, durationMs: 300, waveform: "sine", envelope: "bell" },
+    whoosh: { frequency: 0, durationMs: 250, waveform: "noise", envelope: "sweep" },
+    click: { frequency: 0, durationMs: 50, waveform: "impulse", envelope: "decay" },
+    pop: { frequency: 150, durationMs: 80, waveform: "sine", envelope: "burst" },
+    tada: { frequency: 523, durationMs: 400, waveform: "arpeggio", envelope: "rising" },
+};
+/** Max SFX events allowed per text. */
+export const SFX_MAX_EVENTS = 30;
+//# sourceMappingURL=registry.js.map

package/dist/sfx/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/sfx/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAerE,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAA2C;IAClE,IAAI,EAAI,EAAE,SAAS,EAAE,GAAG,EAAG,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAK,QAAQ,EAAE,OAAO,EAAE;IACpF,KAAK,EAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAK,QAAQ,EAAE,MAAM,EAAE;IACnF,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAK,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAI,QAAQ,EAAE,OAAO,EAAE;IACpF,KAAK,EAAG,EAAE,SAAS,EAAE,CAAC,EAAK,UAAU,EAAE,EAAE,EAAG,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IACpF,GAAG,EAAK,EAAE,SAAS,EAAE,GAAG,EAAG,UAAU,EAAE,EAAE,EAAG,QAAQ,EAAE,MAAM,EAAK,QAAQ,EAAE,OAAO,EAAE;IACpF,IAAI,EAAI,EAAE,SAAS,EAAE,GAAG,EAAG,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE;CACvF,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC"}

package/dist/sfx/stitcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SFX stitcher — interleave SFX WAV data with speech chunks.
+ *
+ * Takes parsed SFX segments (text + sfx events) and produces ChunkArtifact[]
+ * with SFX WAV data inserted at the correct positions.
+ */
+import type { SfxSegment } from "./types.js";
+import type { ChunkArtifact } from "../orchestrator/types.js";
+export interface SfxStitchWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export interface SfxStitchResult {
+    readonly chunks: readonly ChunkArtifact[];
+    readonly warnings: readonly SfxStitchWarning[];
+}
+/**
+ * Create ChunkArtifact entries for SFX events in a segment list.
+ *
+ * Text segments are skipped (they are handled by the synthesis pipeline).
+ * SFX segments get inline WAV data as base64 or written to disk.
+ */
+export declare function createSfxChunks(segments: readonly SfxSegment[], mode?: "path" | "base64"): ChunkArtifact[];
+/**
+ * Check if SFX segments are present and concat is disabled.
+ * Returns a warning if so.
+ */
+export declare function checkSfxConcatRequired(segments: readonly SfxSegment[], concat: boolean): SfxStitchWarning | null;
+//# sourceMappingURL=stitcher.d.ts.map

package/dist/sfx/stitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitcher.d.ts","sourceRoot":"","sources":["../../src/sfx/stitcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,IAAI,GAAE,MAAM,GAAG,QAAmB,GACjC,aAAa,EAAE,CAkBjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,MAAM,EAAE,OAAO,GACd,gBAAgB,GAAG,IAAI,CASzB"}

package/dist/sfx/stitcher.js

@@ -0,0 +1,44 @@
+/**
+ * SFX stitcher — interleave SFX WAV data with speech chunks.
+ *
+ * Takes parsed SFX segments (text + sfx events) and produces ChunkArtifact[]
+ * with SFX WAV data inserted at the correct positions.
+ */
+import { generateSfxWav, getSfxDurationMs } from "./generator.js";
+/**
+ * Create ChunkArtifact entries for SFX events in a segment list.
+ *
+ * Text segments are skipped (they are handled by the synthesis pipeline).
+ * SFX segments get inline WAV data as base64 or written to disk.
+ */
+export function createSfxChunks(segments, mode = "base64") {
+    const chunks = [];
+    for (const seg of segments) {
+        if (seg.type !== "sfx")
+            continue;
+        const wav = generateSfxWav(seg.tag);
+        const durationMs = getSfxDurationMs(seg.tag);
+        chunks.push({
+            audioBytesBase64: wav.toString("base64"),
+            durationMs,
+            sampleRate: 24000,
+            format: "wav",
+        });
+    }
+    return chunks;
+}
+/**
+ * Check if SFX segments are present and concat is disabled.
+ * Returns a warning if so.
+ */
+export function checkSfxConcatRequired(segments, concat) {
+    const hasSfx = segments.some((s) => s.type === "sfx");
+    if (hasSfx && !concat) {
+        return {
+            code: "SFX_REQUIRES_CONCAT",
+            message: "SFX tags are present but concat is disabled; SFX audio will be separate chunks",
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=stitcher.js.map

package/dist/sfx/stitcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitcher.js","sourceRoot":"","sources":["../../src/sfx/stitcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYlE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA+B,EAC/B,OAA0B,QAAQ;IAElC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK;YAAE,SAAS;QAEjC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7C,MAAM,CAAC,IAAI,CAAC;YACV,gBAAgB,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACxC,UAAU;YACV,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA+B,EAC/B,MAAe;IAEf,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACtD,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,gFAAgF;SAC1F,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/sfx/types.d.ts

@@ -0,0 +1,22 @@
+/** SFX types — sound effect tag parsing and generation. */
+export declare const SFX_TAGS: readonly ["ding", "chime", "whoosh", "click", "pop", "tada"];
+export type SfxTag = (typeof SFX_TAGS)[number];
+export interface SfxEvent {
+    readonly type: "sfx";
+    readonly tag: SfxTag;
+}
+export interface SfxTextSegment {
+    readonly type: "text";
+    readonly value: string;
+}
+export type SfxSegment = SfxEvent | SfxTextSegment;
+export interface SfxWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export interface SfxParseResult {
+    readonly segments: readonly SfxSegment[];
+    readonly warnings: readonly SfxWarning[];
+    readonly sfxCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sfx/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sfx/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,eAAO,MAAM,QAAQ,8DAOX,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/sfx/types.js

@@ -0,0 +1,10 @@
+/** SFX types — sound effect tag parsing and generation. */
+export const SFX_TAGS = [
+    "ding",
+    "chime",
+    "whoosh",
+    "click",
+    "pop",
+    "tada",
+];
+//# sourceMappingURL=types.js.map

package/dist/sfx/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sfx/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;CACE,CAAC"}

package/dist/ssml/index.d.ts

@@ -0,0 +1,5 @@
+/** SSML-lite module — parse a subset of SSML into a SpeechPlan. */
+export { type BreakEvent, type ProsodyEvent, type ProsodyEndEvent, type EmphasisEvent, type EmphasisEndEvent, type SpeechEvent, type TextSegment, type EventSegment, type PlanSegment, type SsmlWarning, type SpeechPlan, } from "./types.js";
+export { SSML_LIMITS } from "./limits.js";
+export { parseSsmlLite, looksLikeSsml, SsmlParseError } from "./parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssml/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/ssml/index.js

@@ -0,0 +1,4 @@
+/** SSML-lite module — parse a subset of SSML into a SpeechPlan. */
+export { SSML_LIMITS } from "./limits.js";
+export { parseSsmlLite, looksLikeSsml, SsmlParseError } from "./parser.js";
+//# sourceMappingURL=index.js.map

package/dist/ssml/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ssml/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAgBnE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/ssml/limits.d.ts

@@ -0,0 +1,14 @@
+/** SSML-specific limits. */
+export declare const SSML_LIMITS: {
+    /** Maximum number of SSML element nodes (prevents DoS via deep/wide markup). */
+    readonly maxNodes: 400;
+    /** Maximum break duration in ms. */
+    readonly maxBreakMs: 2000;
+    /** Maximum total characters of text content. */
+    readonly maxTotalChars: 12000;
+    /** Minimum prosody rate multiplier. */
+    readonly minProsodyRate: 0.5;
+    /** Maximum prosody rate multiplier. */
+    readonly maxProsodyRate: 2;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/ssml/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/ssml/limits.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,eAAO,MAAM,WAAW;IACtB,gFAAgF;;IAEhF,oCAAoC;;IAEpC,gDAAgD;;IAEhD,uCAAuC;;IAEvC,uCAAuC;;CAE/B,CAAC"}

package/dist/ssml/limits.js

@@ -0,0 +1,14 @@
+/** SSML-specific limits. */
+export const SSML_LIMITS = {
+    /** Maximum number of SSML element nodes (prevents DoS via deep/wide markup). */
+    maxNodes: 400,
+    /** Maximum break duration in ms. */
+    maxBreakMs: 2_000,
+    /** Maximum total characters of text content. */
+    maxTotalChars: 12_000,
+    /** Minimum prosody rate multiplier. */
+    minProsodyRate: 0.5,
+    /** Maximum prosody rate multiplier. */
+    maxProsodyRate: 2.0,
+};
+//# sourceMappingURL=limits.js.map

package/dist/ssml/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/ssml/limits.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gFAAgF;IAChF,QAAQ,EAAE,GAAG;IACb,oCAAoC;IACpC,UAAU,EAAE,KAAK;IACjB,gDAAgD;IAChD,aAAa,EAAE,MAAM;IACrB,uCAAuC;IACvC,cAAc,EAAE,GAAG;IACnB,uCAAuC;IACvC,cAAc,EAAE,GAAG;CACX,CAAC"}

package/dist/ssml/parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SSML-lite parser — converts a subset of SSML into a SpeechPlan.
+ *
+ * Tag allowlist:
+ *   <speak>         — root wrapper (optional)
+ *   <break>         — pause (time="250ms" or strength="medium")
+ *   <prosody>       — rate modifier (rate="slow"|"fast"|"x-slow"|"x-fast"|"1.2")
+ *   <emphasis>      — emphasis level (level="strong"|"moderate"|"reduced"|"none")
+ *   <sub>           — substitution (alias="replacement text")
+ *   <say-as>        — interpret-as hint (stripped; text passed through)
+ *
+ * Everything else is stripped with a warning. The parser produces a flat
+ * list of text/event segments plus a fallback plain-text string.
+ */
+import type { SpeechPlan } from "./types.js";
+export declare class SsmlParseError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Parse SSML-lite input into a SpeechPlan.
+ * If input doesn't look like SSML, wraps it as plain text.
+ * On parse errors, falls back to plain text with an SSML_PARSE_FAILED warning.
+ */
+export declare function parseSsmlLite(input: string): SpeechPlan;
+/** Check if input looks like it might be SSML. */
+export declare function looksLikeSsml(input: string): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/ssml/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ssml/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,YAAY,CAAC;AAKpB,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,MAA4B;CAKrD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAavD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}