@kawaijs/renderer-dom 0.1.11 → 0.1.12

package/README.md

@@ -7,33 +7,55 @@ Part of the [Kawaijs](https://github.com/biagio-scaglia/KawaiJS) visual novel en
 ## Installation
 
 ```bash
-npm install @kawaijs/renderer-dom
+npm install @kawaijs/renderer-dom @kawaijs/runtime @kawaijs/parser
 ```
 
 ## Quick Example
 
 ```typescript
 import { compileScript } from '@kawaijs/parser';
-import { mountKawaApp } from '@kawaijs/renderer-dom';
-import '@kawaijs/renderer-dom/src/theme.css';
+import { StoryVM } from '@kawaijs/runtime';
+import { DOMRenderer } from '@kawaijs/renderer-dom';
+import '@kawaijs/renderer-dom/dist/theme.css';
 
 const story = compileScript(`
-character yumia "Yumia"
+character yumia "Yumia" #f43f5e
 
 label start:
-    scene bg classroom
-    show yumia happy
+    scene bg classroom with fade
+    vfx sakura
+    show yumia happy at center with bounce
     yumia "Hello from Kawaijs DOM renderer!"
 `);
 
-mountKawaApp(story, document.getElementById('app')!);
+const vm = new StoryVM(story);
+
+const renderer = new DOMRenderer(vm, {
+  container: document.getElementById('app')!,
+  mainMenu: {
+    enabled: true,
+    title: "My Visual Novel",
+    subtitle: "A Web Tale"
+  }
+});
 ```
 
 ## Features
-- **Semantic DOM Elements**: `.kawa-root`, `.kawa-stage`, `.kawa-dialogue-box`, `.kawa-choices`.
-- **CSS Custom Properties**: Fully customizable theme tokens (`--kawa-primary-accent`, `--kawa-dialogue-bg`, etc.).
-- **Typewriter Effect**: Smooth animated text with skip on click.
-- **Built-in UI**: Quick menu (Back, History, Save, Load).
+
+- **Ren'Py-Style Start / Main Menu**: Start Game, Continue, Load, CG Gallery, Preferences, About, and Quit. Fully customizable through `MainMenuOptions` or standard CSS.
+- **Atmospheric VFX Layer**: Canvas particles for `sakura` (cherry blossoms), `rain`, `snow`, plus `fog` / `tint` overlays (`tint` layers over weather without stopping petals).
+- **Scene & Sprite Transitions**: Background `with fade`; sprite `with bounce` / `dissolve` / `nod` / `shake` / `slideleft` / `slideright`.
+- **Camera Directives & Shakes**: `shake`, `vpunch`, `hpunch`, and screen `flash`.
+- **Unlockable CG Gallery & Lightbox**: Fullscreen illustration modal with progress tracking and lightbox viewer.
+- **Save & Load Modals**: Multi-slot save system with live state previews, slot deletion, and timestamps.
+- **Preferences Modal**: Interactive sliders for Typewriter speed, Auto-forward delay, Music and SFX volume.
+- **Dialogue History / Backlog**: Formatted log of all past speaker interactions (synced on rollback/load).
+- **Responsive 16:9 Letterboxing**: Automatically scales to any screen aspect ratio.
+- **Rich Text & Interpolation**: Built-in support for dynamic variables `[var]`, `{b}`, `{i}`, `{color=...}`, `{size=...}` tags with XSS sanitization.
+- **Keyboard Navigation**: Space/Enter advance, Backspace rollback, A auto, Ctrl skip, S/L save/load, H history, P preferences, Esc title.
+- **Theme / Style hooks**: `theme "noir|sakura|ocean|dusk"` and `style dialogue|choices|stage …` map to CSS tokens / classes.
+- **Share & embed**: dynamic Open Graph meta per scene; `?embed=1` for iframe-friendly chrome; `?at=` deep-links.
 
 ## License
-MIT © Biagio Scaglia
+
+MIT License © 2026 [Biagio Scaglia](https://github.com/biagio-scaglia)

package/dist/asset-fallbacks.d.ts

@@ -0,0 +1,13 @@
+import type { AssetType } from './types.js';
+/** Raster + vector extensions tried when a character path resolves to `.svg` by default. */
+export declare const IMAGE_EXTENSIONS: readonly [".png", ".jpg", ".jpeg", ".webp", ".svg"];
+/**
+ * Build candidate URLs for a character asset key (`yumia` or `yumia/happy`).
+ * Prefer raster (png/jpg/webp) before the default `.svg` so real art wins.
+ */
+export declare function characterAssetCandidates(pathKey: string, resolve: (path: string, type: AssetType) => string): string[];
+/**
+ * Attach sequential src fallbacks on an image (png/jpg/webp before giving up).
+ */
+export declare function bindImageSrcFallbacks(img: HTMLImageElement, candidates: string[], onAllFailed?: () => void): void;
+//# sourceMappingURL=asset-fallbacks.d.ts.map

package/dist/asset-fallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-fallbacks.d.ts","sourceRoot":"","sources":["../src/asset-fallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,qDAAsD,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,GACjD,MAAM,EAAE,CAoBV;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,CAAC,EAAE,MAAM,IAAI,GACvB,IAAI,CAeN"}

package/dist/asset-fallbacks.js

@@ -0,0 +1,41 @@
+/** Raster + vector extensions tried when a character path resolves to `.svg` by default. */
+export const IMAGE_EXTENSIONS = ['.png', '.jpg', '.jpeg', '.webp', '.svg'];
+/**
+ * Build candidate URLs for a character asset key (`yumia` or `yumia/happy`).
+ * Prefer raster (png/jpg/webp) before the default `.svg` so real art wins.
+ */
+export function characterAssetCandidates(pathKey, resolve) {
+    const primary = resolve(pathKey, 'character');
+    const extMatch = primary.match(/^(.*)\.(svg|png|jpe?g|webp|gif)$/i);
+    if (!extMatch) {
+        return IMAGE_EXTENSIONS.map((ext) => `${primary}${ext}`);
+    }
+    const base = extMatch[1];
+    const primaryExt = `.${extMatch[2].toLowerCase()}`;
+    const normalizedPrimary = primaryExt === '.jpeg' ? '.jpg' : primaryExt === '.jpg' ? '.jpg' : primaryExt;
+    // Explicit non-svg path → that file first, then siblings
+    if (normalizedPrimary !== '.svg') {
+        const rest = IMAGE_EXTENSIONS.filter((ext) => ext !== normalizedPrimary && !(normalizedPrimary === '.jpg' && ext === '.jpeg'));
+        return [primary, ...rest.map((ext) => `${base}${ext}`)];
+    }
+    // Default resolver appended .svg → try real bitmaps first
+    return IMAGE_EXTENSIONS.map((ext) => `${base}${ext}`);
+}
+/**
+ * Attach sequential src fallbacks on an image (png/jpg/webp before giving up).
+ */
+export function bindImageSrcFallbacks(img, candidates, onAllFailed) {
+    let index = 0;
+    const tryNext = () => {
+        if (index >= candidates.length) {
+            onAllFailed?.();
+            return;
+        }
+        img.src = candidates[index++];
+    };
+    img.onerror = () => {
+        tryNext();
+    };
+    tryNext();
+}
+//# sourceMappingURL=asset-fallbacks.js.map

package/dist/asset-fallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-fallbacks.js","sourceRoot":"","sources":["../src/asset-fallbacks.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,OAAkD;IAElD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IACpD,MAAM,iBAAiB,GACrB,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAEhF,yDAAyD;IACzD,IAAI,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,iBAAiB,IAAI,CAAC,CAAC,iBAAiB,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC;QAC/H,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,0DAA0D;IAC1D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAqB,EACrB,UAAoB,EACpB,WAAwB;IAExB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YAC/B,WAAW,EAAE,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,CAAE,CAAC;IACjC,CAAC,CAAC;IAEF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/components/choice-menu.d.ts

@@ -0,0 +1,12 @@
+import type { ChoiceOption } from '@kawaijs/ast';
+export interface ChoiceMenuCallbacks {
+    onSelect: (index: number) => void;
+}
+export declare class ChoiceMenuComponent {
+    readonly el: HTMLDivElement;
+    private readonly callbacks;
+    constructor(callbacks: ChoiceMenuCallbacks);
+    render(choices: readonly ChoiceOption[] | null | undefined): void;
+    hide(): void;
+}
+//# sourceMappingURL=choice-menu.d.ts.map

package/dist/components/choice-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-menu.d.ts","sourceRoot":"","sources":["../../src/components/choice-menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,mBAAmB;IAC9B,SAAgB,EAAE,EAAE,cAAc,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEpC,SAAS,EAAE,mBAAmB;IASnC,MAAM,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAkCjE,IAAI,IAAI,IAAI;CAIpB"}

package/dist/components/choice-menu.js

@@ -0,0 +1,44 @@
+export class ChoiceMenuComponent {
+    el;
+    callbacks;
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+        this.el = document.createElement('div');
+        this.el.className = 'kawa-choice-container kawa-choices';
+        this.el.setAttribute('role', 'group');
+        this.el.setAttribute('aria-label', 'Choices');
+        this.el.style.display = 'none';
+    }
+    render(choices) {
+        this.el.innerHTML = '';
+        if (!choices || choices.length === 0) {
+            this.el.style.display = 'none';
+            return;
+        }
+        this.el.style.display = 'flex';
+        choices.forEach((choice, index) => {
+            const btn = document.createElement('button');
+            btn.type = 'button';
+            btn.className = 'kawa-choice-btn';
+            btn.textContent = choice.text;
+            btn.setAttribute('tabindex', '0');
+            btn.setAttribute('aria-label', `Option ${index + 1}: ${choice.text}`);
+            btn.addEventListener('click', (e) => {
+                e.preventDefault();
+                e.stopPropagation();
+                this.callbacks.onSelect(index);
+            });
+            this.el.appendChild(btn);
+        });
+        // Auto-focus first choice for keyboard navigation
+        const firstBtn = this.el.querySelector('button');
+        if (firstBtn) {
+            firstBtn.focus();
+        }
+    }
+    hide() {
+        this.el.style.display = 'none';
+        this.el.innerHTML = '';
+    }
+}
+//# sourceMappingURL=choice-menu.js.map

package/dist/components/choice-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-menu.js","sourceRoot":"","sources":["../../src/components/choice-menu.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,mBAAmB;IACd,EAAE,CAAiB;IAClB,SAAS,CAAsB;IAEhD,YAAY,SAA8B;QACxC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,oCAAoC,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,OAAmD;QAC/D,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC;QAEvB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAE/B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,GAAG,CAAC,SAAS,GAAG,iBAAiB,CAAC;YAClC,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAC9B,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAClC,GAAG,CAAC,YAAY,CAAC,YAAY,EAAE,UAAU,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAEtE,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClC,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,CAAC,CAAC,eAAe,EAAE,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,kDAAkD;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/components/dialogue-box.d.ts

@@ -0,0 +1,29 @@
+export interface DialogueBoxCallbacks {
+    onAdvance: () => void;
+}
+export declare class DialogueBoxComponent {
+    readonly el: HTMLDivElement;
+    private readonly speakerTagEl;
+    private readonly dialogueTextEl;
+    private readonly announceEl;
+    private readonly indicatorEl;
+    private typewriterSpeed;
+    private typewriterInterval;
+    private isTypewriting;
+    private fullCurrentText;
+    private onTypewriterComplete?;
+    constructor(typewriterSpeed?: number);
+    setTypewriterSpeed(speed: number): void;
+    getIsTypewriting(): boolean;
+    render(dialogue: {
+        speaker?: string;
+        speakerDisplayName?: string;
+        speakerColor?: string;
+        text: string;
+    } | null | undefined, onComplete?: () => void): void;
+    finishTypewriter(): void;
+    private announceFinishedLine;
+    private startTypewriter;
+    destroy(): void;
+}
+//# sourceMappingURL=dialogue-box.d.ts.map

package/dist/components/dialogue-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-box.d.ts","sourceRoot":"","sources":["../../src/components/dialogue-box.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAC/B,SAAgB,EAAE,EAAE,cAAc,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAE7C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAa;gBAE9B,eAAe,SAAK;IA2CzB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC,gBAAgB,IAAI,OAAO;IAI3B,MAAM,CACX,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,EACnH,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,IAAI;IA8CA,gBAAgB,IAAI,IAAI;IAiB/B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,eAAe;IA8BhB,OAAO,IAAI,IAAI;CAMvB"}

package/dist/components/dialogue-box.js

@@ -0,0 +1,155 @@
+import { SVG_ICONS } from '../icons.js';
+import { formatRichText } from '../utils/rich-text.js';
+export class DialogueBoxComponent {
+    el;
+    speakerTagEl;
+    dialogueTextEl;
+    announceEl;
+    indicatorEl;
+    typewriterSpeed;
+    typewriterInterval = null;
+    isTypewriting = false;
+    fullCurrentText = '';
+    onTypewriterComplete;
+    constructor(typewriterSpeed = 20) {
+        this.typewriterSpeed = typewriterSpeed;
+        this.el = document.createElement('div');
+        this.el.className = 'kawa-dialogue-box kawa-dialogue';
+        this.el.setAttribute('role', 'region');
+        this.el.setAttribute('aria-label', 'Dialogue');
+        this.el.setAttribute('tabindex', '0');
+        this.speakerTagEl = document.createElement('div');
+        this.speakerTagEl.className = 'kawa-speaker-tag kawa-speaker';
+        this.dialogueTextEl = document.createElement('div');
+        this.dialogueTextEl.className = 'kawa-dialogue-text kawa-text';
+        // Visible typewriter must NOT be live — per-character updates spam screen readers.
+        this.dialogueTextEl.setAttribute('aria-hidden', 'true');
+        this.announceEl = document.createElement('div');
+        this.announceEl.className = 'kawa-dialogue-announce';
+        this.announceEl.setAttribute('aria-live', 'polite');
+        this.announceEl.setAttribute('aria-atomic', 'true');
+        // Visually hidden but available to AT
+        this.announceEl.style.position = 'absolute';
+        this.announceEl.style.width = '1px';
+        this.announceEl.style.height = '1px';
+        this.announceEl.style.padding = '0';
+        this.announceEl.style.margin = '-1px';
+        this.announceEl.style.overflow = 'hidden';
+        this.announceEl.style.clip = 'rect(0, 0, 0, 0)';
+        this.announceEl.style.whiteSpace = 'nowrap';
+        this.announceEl.style.border = '0';
+        this.indicatorEl = document.createElement('div');
+        this.indicatorEl.className = 'kawa-continue-indicator';
+        this.indicatorEl.setAttribute('aria-hidden', 'true');
+        this.indicatorEl.innerHTML = SVG_ICONS.arrowDown;
+        this.el.appendChild(this.speakerTagEl);
+        this.el.appendChild(this.dialogueTextEl);
+        this.el.appendChild(this.announceEl);
+        this.el.appendChild(this.indicatorEl);
+    }
+    setTypewriterSpeed(speed) {
+        this.typewriterSpeed = speed;
+    }
+    getIsTypewriting() {
+        return this.isTypewriting;
+    }
+    render(dialogue, onComplete) {
+        if (!dialogue) {
+            this.el.style.display = 'none';
+            this.announceEl.textContent = '';
+            return;
+        }
+        this.el.style.display = 'block';
+        // Speaker Tag
+        if (dialogue.speakerDisplayName || dialogue.speaker) {
+            this.speakerTagEl.textContent = dialogue.speakerDisplayName ?? dialogue.speaker ?? '';
+            this.speakerTagEl.style.display = 'inline-block';
+            if (dialogue.speakerColor) {
+                this.speakerTagEl.style.backgroundColor = dialogue.speakerColor;
+            }
+            else {
+                this.speakerTagEl.style.backgroundColor = '';
+            }
+        }
+        else {
+            this.speakerTagEl.style.display = 'none';
+        }
+        // Dialogue Text
+        this.onTypewriterComplete = onComplete;
+        this.fullCurrentText = dialogue.text;
+        if (this.typewriterInterval) {
+            clearInterval(this.typewriterInterval);
+            this.typewriterInterval = null;
+        }
+        // Clear previous announcement while typing so AT only hears the finished line.
+        this.announceEl.textContent = '';
+        this.el.setAttribute('aria-busy', 'true');
+        if (this.typewriterSpeed <= 0) {
+            this.dialogueTextEl.innerHTML = formatRichText(this.fullCurrentText);
+            this.isTypewriting = false;
+            this.indicatorEl.style.opacity = '1';
+            this.announceFinishedLine(dialogue);
+            this.onTypewriterComplete?.();
+        }
+        else {
+            this.startTypewriter(this.fullCurrentText, dialogue);
+        }
+    }
+    finishTypewriter() {
+        if (!this.isTypewriting)
+            return;
+        if (this.typewriterInterval) {
+            clearInterval(this.typewriterInterval);
+            this.typewriterInterval = null;
+        }
+        this.isTypewriting = false;
+        this.dialogueTextEl.innerHTML = formatRichText(this.fullCurrentText);
+        this.indicatorEl.style.opacity = '1';
+        const speaker = this.speakerTagEl.style.display === 'none' ? undefined : this.speakerTagEl.textContent || undefined;
+        this.announceFinishedLine({
+            speakerDisplayName: speaker,
+            text: this.fullCurrentText
+        });
+        this.onTypewriterComplete?.();
+    }
+    announceFinishedLine(dialogue) {
+        this.el.setAttribute('aria-busy', 'false');
+        const who = dialogue.speakerDisplayName || dialogue.speaker;
+        const plain = (() => {
+            const temp = document.createElement('div');
+            temp.innerHTML = formatRichText(dialogue.text);
+            return temp.textContent || dialogue.text;
+        })();
+        this.announceEl.textContent = who ? `${who}: ${plain}` : plain;
+    }
+    startTypewriter(text, dialogue) {
+        this.isTypewriting = true;
+        this.indicatorEl.style.opacity = '0';
+        this.dialogueTextEl.innerHTML = '';
+        const formattedFull = formatRichText(text);
+        // Extract text chunks or plain characters
+        const temp = document.createElement('div');
+        temp.innerHTML = formattedFull;
+        const plainText = temp.textContent || '';
+        const graphemes = Array.from(plainText);
+        let charIdx = 0;
+        this.typewriterInterval = window.setInterval(() => {
+            charIdx++;
+            if (charIdx >= graphemes.length) {
+                this.finishTypewriter();
+            }
+            else {
+                this.dialogueTextEl.textContent = graphemes.slice(0, charIdx).join('');
+            }
+        }, this.typewriterSpeed);
+        // Keep dialogue ref for finish path via fullCurrentText / speakerTag
+        void dialogue;
+    }
+    destroy() {
+        if (this.typewriterInterval) {
+            clearInterval(this.typewriterInterval);
+            this.typewriterInterval = null;
+        }
+    }
+}
+//# sourceMappingURL=dialogue-box.js.map

package/dist/components/dialogue-box.js.map

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

package/dist/components/hotspot-layer.d.ts

@@ -0,0 +1,13 @@
+import type { HotspotOption } from '@kawaijs/ast';
+/**
+ * Absolute-positioned clickable regions over the stage / CG.
+ * Coordinates are normalized 0–1 relative to the stage.
+ */
+export declare class HotspotLayerComponent {
+    private readonly onSelect;
+    readonly el: HTMLDivElement;
+    constructor(onSelect: (id: string) => void);
+    render(hotspots: readonly HotspotOption[] | null | undefined): void;
+    destroy(): void;
+}
+//# sourceMappingURL=hotspot-layer.d.ts.map

package/dist/components/hotspot-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspot-layer.d.ts","sourceRoot":"","sources":["../../src/components/hotspot-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;GAGG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,SAAgB,EAAE,EAAE,cAAc,CAAC;gBAEN,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;IAOpD,MAAM,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IA+BnE,OAAO,IAAI,IAAI;CAIvB"}

package/dist/components/hotspot-layer.js

@@ -0,0 +1,47 @@
+/**
+ * Absolute-positioned clickable regions over the stage / CG.
+ * Coordinates are normalized 0–1 relative to the stage.
+ */
+export class HotspotLayerComponent {
+    onSelect;
+    el;
+    constructor(onSelect) {
+        this.onSelect = onSelect;
+        this.el = document.createElement('div');
+        this.el.className = 'kawa-hotspot-layer';
+        this.el.setAttribute('aria-label', 'Interactive regions');
+        this.el.style.display = 'none';
+    }
+    render(hotspots) {
+        this.el.replaceChildren();
+        if (!hotspots || hotspots.length === 0) {
+            this.el.style.display = 'none';
+            this.el.setAttribute('aria-hidden', 'true');
+            return;
+        }
+        this.el.style.display = 'block';
+        this.el.setAttribute('aria-hidden', 'false');
+        for (const spot of hotspots) {
+            const btn = document.createElement('button');
+            btn.type = 'button';
+            btn.className = 'kawa-hotspot';
+            btn.dataset.hotspotId = spot.id;
+            btn.setAttribute('aria-label', spot.id);
+            btn.title = spot.id;
+            btn.style.left = `${spot.x * 100}%`;
+            btn.style.top = `${spot.y * 100}%`;
+            btn.style.width = `${spot.w * 100}%`;
+            btn.style.height = `${spot.h * 100}%`;
+            btn.addEventListener('click', (e) => {
+                e.stopPropagation();
+                this.onSelect(spot.id);
+            });
+            this.el.appendChild(btn);
+        }
+    }
+    destroy() {
+        this.el.replaceChildren();
+        this.el.remove();
+    }
+}
+//# sourceMappingURL=hotspot-layer.js.map

package/dist/components/hotspot-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspot-layer.js","sourceRoot":"","sources":["../../src/components/hotspot-layer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAGH;IAFb,EAAE,CAAiB;IAEnC,YAA6B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;QACzD,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,oBAAoB,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;QAC1D,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,QAAqD;QACjE,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC;QAE1B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;YAC/B,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,GAAG,CAAC,SAAS,GAAG,cAAc,CAAC;YAC/B,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;YAChC,GAAG,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACxC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;YACpC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;YACnC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;YACrC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClC,CAAC,CAAC,eAAe,EAAE,CAAC;gBACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/components/main-menu.d.ts

@@ -0,0 +1,36 @@
+import type { StoryVM } from '@kawaijs/runtime';
+import type { MainMenuItem, MainMenuOptions, AssetType } from '../types.js';
+export interface MainMenuComponentCallbacks {
+    onStartNewGame: () => void;
+    onContinueGame: () => Promise<boolean>;
+    assetResolver: (path: string, type: AssetType) => string;
+    getSettingsConfig: () => {
+        typewriterSpeed: number;
+        autoDelayMs: number;
+        musicVolume?: number;
+        soundVolume?: number;
+        onSettingsChange: (s: {
+            typewriterSpeed: number;
+            autoDelayMs: number;
+            musicVolume?: number;
+            soundVolume?: number;
+        }) => void;
+    };
+}
+export declare class MainMenuComponent {
+    private readonly vm;
+    private readonly rootEl;
+    private readonly options?;
+    private readonly callbacks;
+    private menuEl?;
+    private isVisible;
+    constructor(rootEl: HTMLElement, vm: StoryVM, options: MainMenuOptions | undefined, callbacks: MainMenuComponentCallbacks);
+    mount(container: HTMLElement): void;
+    show(): void;
+    hide(): void;
+    isActive(): boolean;
+    refresh(): void;
+    getDefaultMenuItems(): MainMenuItem[];
+    private buildDOM;
+}
+//# sourceMappingURL=main-menu.d.ts.map

package/dist/components/main-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-menu.d.ts","sourceRoot":"","sources":["../../src/components/main-menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS5E,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IACzD,iBAAiB,EAAE,MAAM;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,CAAC,CAAC,EAAE;YACpB,eAAe,EAAE,MAAM,CAAC;YACxB,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,KAAK,IAAI,CAAC;KACZ,CAAC;CACH;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,EAAE,SAAS,EAAE,0BAA0B;IAOlH,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IASnC,IAAI,IAAI,IAAI;IAcZ,IAAI,IAAI,IAAI;IAQZ,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,IAAI;IAoBf,mBAAmB,IAAI,YAAY,EAAE;IA8D5C,OAAO,CAAC,QAAQ;CAyIjB"}