kawaijs 0.1.11 → 0.1.13

package/README.md

@@ -23,9 +23,10 @@ character yumia "Yumia" #f43f5e
 
 label start:
     scene bg classroom with fade
-    show yumia happy at center
+    vfx sakura
+    show yumia happy at center with bounce
 
-    yumia "Good morning! Are you ready for the festival?"
+    yumia "Good morning! Ready for the festival under the cherry blossoms?"
 
     menu:
         "Yes, absolutely!":
@@ -35,7 +36,7 @@ label start:
             jump not_ready
 
 label ready:
-    show yumia excited
+    show yumia excited with nod
     yumia "Awesome! Let's get to work."
     return
 
@@ -55,6 +56,8 @@ npx kawaijs create my-novel
 cd my-novel
 ```
 
+`create` copies the showcase starter (fade, sakura, sprite transitions, CG routes). Run `npx kawa dev ./examples/hello-world` in the monorepo for the same demo.
+
 ### 2. Validate Your Script
 
 ```bash
@@ -67,9 +70,10 @@ npx kawaijs validate
 
 - **🌐 Web-Native**: Runs directly in modern browsers with zero backend dependencies. Deploy to GitHub Pages, Netlify, Vercel, Cloudflare Pages, or itch.io.
 - **✍️ Writer-Friendly**: Indentation-based Kawa Script designed for narrative designers and story writers.
+- **🌸 Atmosphere**: `vfx sakura` / rain / snow / fog / tint, scene `with fade`, sprite `with bounce|dissolve|nod`.
 - **🎨 Deep CSS Theming**: Customize dialogue boxes, choice overlays, buttons, fonts, and animations using standard CSS and CSS custom properties.
 - **⏱️ Deterministic Rollback**: Step backwards through dialogue and choices with instant snapshot rollbacks (`vm.rollback()`).
-- **💾 Save & Load**: Built-in persistence for game save slots using LocalStorage / IndexedDB.
+- **💾 Save & Load**: Built-in persistence for game save slots using LocalStorage (schema v2 with history).
 - **📦 Modular Architecture**: Decoupled compiler (`@kawaijs/parser`), headless state machine (`@kawaijs/runtime`), and presentation layer (`@kawaijs/renderer-dom`).
 
 ---
@@ -80,6 +84,12 @@ npx kawaijs validate
 # Create a new visual novel project
 kawa create <project-name>
 
+# Dev server (live reload) — optional deep-link + port
+kawa dev [path] [--port 3000] [--at label]
+
+# Static production bundle
+kawa build [path] [--out dist] [--at label]
+
 # Validate syntax, jump labels, and asset links
 kawa validate [path]
 
@@ -87,6 +97,43 @@ kawa validate [path]
 kawa version
 ```
 
+Browser URL flags: `?at=<label>` (deep-link), `?embed=1` (iframe mode), `?continue=<token>` (restore shared save).
+
+### SEO, favicon & social
+
+Configure in `game/kawa.config.json`:
+
+```json
+{
+  "seo": {
+    "favicon": "favicon.svg",
+    "description": "Your game blurb",
+    "keywords": ["visual novel", "web"],
+    "canonicalUrl": "https://you.example/game/",
+    "locale": "it_IT",
+    "twitterSite": "@studio"
+  },
+  "share": {
+    "defaultImage": "backgrounds/cover.png",
+    "twitterCard": "summary_large_image"
+  }
+}
+```
+
+- Drop `game/favicon.svg` (or `.png` / `.ico`) — or set `seo.favicon`
+- `kawa build` copies the favicon into `dist/`, sets `<link rel="icon">` / apple-touch, OG/Twitter/JSON-LD, and uses it as the PWA icon
+- With `seo.canonicalUrl`, also writes `dist/robots.txt`
+
+`kawa build` emits a PWA (`manifest.webmanifest`, `sw.js`, icon) by default.
+
+### Embed kit
+
+```bash
+kawa embed --width 960 --height 540 --at start --src https://you.example/game/
+```
+
+Prints a responsive iframe snippet with `?embed=1` (and optional `?at=`).
+
 ---
 
 ## 📦 Modular Packages

package/dist/commands/build.d.ts

@@ -1,5 +1,6 @@
 export interface BuildOptions {
     outDir?: string;
+    startLabel?: string;
 }
 export declare function buildProject(projectDir?: string, options?: BuildOptions): boolean;
 //# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuFD,wBAAgB,YAAY,CAAC,UAAU,SAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAomClF"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,UAAU,SAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CA4OlF"}