@doodle-engine/cli 0.0.12 → 0.0.14

package/dist/cli.js

@@ -1,84 +1,84 @@
 #!/usr/bin/env node
 import { Command as G } from "commander";
-import { crayon as c } from "crayon.js";
-import { createServer as j, build as $ } from "vite";
-import S from "@vitejs/plugin-react";
-import { watch as H } from "chokidar";
-import { readdir as y, readFile as p, mkdir as A, writeFile as m } from "fs/promises";
-import { join as s, extname as f, relative as w } from "path";
-import { parse as b } from "yaml";
-import { parseDialogue as v } from "@doodle-engine/core";
-import M from "prompts";
-function T(e, n) {
-  const i = [];
-  for (const a of Object.values(e.dialogues)) {
-    const o = n.get(a.id) || `dialogue:${a.id}`;
-    i.push(...F(a, o));
+import { crayon as i } from "crayon.js";
+import { createServer as $, build as H } from "vite";
+import j from "@vitejs/plugin-react";
+import { watch as M } from "chokidar";
+import { readdir as p, readFile as f, mkdir as D, writeFile as k } from "fs/promises";
+import { join as d, extname as g, relative as b, dirname as F } from "path";
+import { parse as y } from "yaml";
+import { parseDialogue as E } from "@doodle-engine/core";
+import P from "prompts";
+function I(n, o) {
+  const r = [];
+  for (const a of Object.values(n.dialogues)) {
+    const t = o.get(a.id) || `dialogue:${a.id}`;
+    r.push(...B(a, t));
   }
-  for (const a of Object.values(e.characters))
-    if (a.dialogue && !e.dialogues[a.dialogue]) {
-      const o = n.get(a.id) || `character:${a.id}`;
-      i.push({
-        file: o,
+  for (const a of Object.values(n.characters))
+    if (a.dialogue && !n.dialogues[a.dialogue]) {
+      const t = o.get(a.id) || `character:${a.id}`;
+      r.push({
+        file: t,
         message: `Character "${a.id}" references non-existent dialogue "${a.dialogue}"`,
         suggestion: `Create dialogue "${a.dialogue}" or fix the reference`
       });
     }
-  return i.push(...J(e, n)), i;
+  return r.push(...J(n, o)), r;
 }
-function F(e, n) {
-  const i = [], a = /* @__PURE__ */ new Set();
-  for (const o of e.nodes)
-    a.has(o.id) && i.push({
-      file: n,
-      message: `Duplicate node ID "${o.id}"`,
+function B(n, o) {
+  const r = [], a = /* @__PURE__ */ new Set();
+  for (const t of n.nodes)
+    a.has(t.id) && r.push({
+      file: o,
+      message: `Duplicate node ID "${t.id}"`,
       suggestion: "Node IDs must be unique within a dialogue"
-    }), a.add(o.id);
-  a.has(e.startNode) || i.push({
-    file: n,
-    message: `Start node "${e.startNode}" not found`,
-    suggestion: `Add a NODE ${e.startNode} or fix the startNode reference`
+    }), a.add(t.id);
+  a.has(n.startNode) || r.push({
+    file: o,
+    message: `Start node "${n.startNode}" not found`,
+    suggestion: `Add a NODE ${n.startNode} or fix the startNode reference`
   });
-  for (const o of e.nodes)
-    i.push(...B(o, a, n));
-  return i;
+  for (const t of n.nodes)
+    r.push(...L(t, a, o));
+  return r;
 }
-function B(e, n, i) {
+function L(n, o, r) {
   const a = [];
-  if (e.next && !n.has(e.next) && a.push({
-    file: i,
-    message: `Node "${e.id}" GOTO "${e.next}" points to non-existent node`,
-    suggestion: `Add NODE ${e.next} or fix the GOTO target`
-  }), e.conditionalNext)
-    for (const o of e.conditionalNext)
-      n.has(o.next) || a.push({
-        file: i,
-        message: `Node "${e.id}" IF block GOTO "${o.next}" points to non-existent node`,
-        suggestion: `Add NODE ${o.next} or fix the GOTO target`
-      }), a.push(...O(o.condition, e.id, i));
-  for (const o of e.choices) {
-    if (!o.effects?.some(
-      (t) => t.type === "endDialogue" || t.type === "goToLocation"
-    ) && !n.has(o.next) && a.push({
-      file: i,
-      message: `Node "${e.id}" choice "${o.id}" GOTO "${o.next}" points to non-existent node`,
-      suggestion: `Add NODE ${o.next} or fix the GOTO target`
-    }), o.conditions)
-      for (const t of o.conditions)
-        a.push(...O(t, e.id, i));
-    if (o.effects)
-      for (const t of o.effects)
-        a.push(...N(t, e.id, i));
+  if (n.next && !o.has(n.next) && a.push({
+    file: r,
+    message: `Node "${n.id}" GOTO "${n.next}" points to non-existent node`,
+    suggestion: `Add NODE ${n.next} or fix the GOTO target`
+  }), n.conditionalNext)
+    for (const t of n.conditionalNext)
+      o.has(t.next) || a.push({
+        file: r,
+        message: `Node "${n.id}" IF block GOTO "${t.next}" points to non-existent node`,
+        suggestion: `Add NODE ${t.next} or fix the GOTO target`
+      }), a.push(...v(t.condition, n.id, r));
+  for (const t of n.choices) {
+    if (!t.effects?.some(
+      (e) => e.type === "endDialogue" || e.type === "goToLocation"
+    ) && !o.has(t.next) && a.push({
+      file: r,
+      message: `Node "${n.id}" choice "${t.id}" GOTO "${t.next}" points to non-existent node`,
+      suggestion: `Add NODE ${t.next} or fix the GOTO target`
+    }), t.conditions)
+      for (const e of t.conditions)
+        a.push(...v(e, n.id, r));
+    if (t.effects)
+      for (const e of t.effects)
+        a.push(...C(e, n.id, r));
   }
-  if (e.conditions)
-    for (const o of e.conditions)
-      a.push(...O(o, e.id, i));
-  if (e.effects)
-    for (const o of e.effects)
-      a.push(...N(o, e.id, i));
+  if (n.conditions)
+    for (const t of n.conditions)
+      a.push(...v(t, n.id, r));
+  if (n.effects)
+    for (const t of n.effects)
+      a.push(...C(t, n.id, r));
   return a;
 }
-const L = {
+const U = {
   hasFlag: ["flag"],
   notFlag: ["flag"],
   hasItem: ["itemId"],
@@ -94,7 +94,7 @@ const L = {
   relationshipBelow: ["characterId", "value"],
   itemAt: ["itemId", "locationId"],
   roll: ["min", "max", "threshold"]
-}, U = {
+}, W = {
   setFlag: ["flag"],
   clearFlag: ["flag"],
   setVariable: ["variable", "value"],
@@ -123,138 +123,138 @@ const L = {
   showInterlude: ["interludeId"],
   roll: ["variable", "min", "max"]
 };
-function O(e, n, i) {
+function v(n, o, r) {
   const a = [];
-  if (!e.type)
+  if (!n.type)
     return a.push({
-      file: i,
-      message: `Node "${n}" has condition with missing type`
+      file: r,
+      message: `Node "${o}" has condition with missing type`
     }), a;
-  if (e.type === "timeIs")
-    return e.hour === void 0 && e.day === void 0 && a.push({
-      file: i,
-      message: `Node "${n}" condition "timeIs" must have at least one of "hour" or "day" argument`
+  if (n.type === "timeIs")
+    return n.hour === void 0 && n.day === void 0 && a.push({
+      file: r,
+      message: `Node "${o}" condition "timeIs" must have at least one of "hour" or "day" argument`
     }), a;
-  const o = L[e.type];
-  if (!o)
+  const t = U[n.type];
+  if (!t)
     return a;
-  for (const r of o)
-    (e[r] === void 0 || e[r] === null || e[r] === "") && a.push({
-      file: i,
-      message: `Node "${n}" condition "${e.type}" missing required "${r}" argument`
+  for (const s of t)
+    (n[s] === void 0 || n[s] === null || n[s] === "") && a.push({
+      file: r,
+      message: `Node "${o}" condition "${n.type}" missing required "${s}" argument`
     });
   return a;
 }
-function N(e, n, i) {
+function C(n, o, r) {
   const a = [];
-  if (!e.type)
+  if (!n.type)
     return a.push({
-      file: i,
-      message: `Node "${n}" has effect with missing type`
+      file: r,
+      message: `Node "${o}" has effect with missing type`
     }), a;
-  const o = U[e.type];
-  if (!o)
+  const t = W[n.type];
+  if (!t)
     return a;
-  for (const r of o)
-    (e[r] === void 0 || e[r] === null || e[r] === "") && a.push({
-      file: i,
-      message: `Node "${n}" effect "${e.type}" missing required "${r}" argument`
+  for (const s of t)
+    (n[s] === void 0 || n[s] === null || n[s] === "") && a.push({
+      file: r,
+      message: `Node "${o}" effect "${n.type}" missing required "${s}" argument`
     });
   return a;
 }
-function J(e, n) {
-  const i = [], a = /* @__PURE__ */ new Set();
-  for (const t of Object.values(e.locales))
-    for (const l of Object.keys(t))
-      a.add(l);
-  const o = (t) => t.startsWith("@"), r = (t, l, d) => {
-    const h = t.slice(1);
-    if (!a.has(h)) {
-      const u = n.get(l) || `${d}:${l}`;
-      i.push({
-        file: u,
-        message: `Localization key "${t}" not found in any locale file`,
-        suggestion: `Add "${h}: ..." to your locale files`
+function J(n, o) {
+  const r = [], a = /* @__PURE__ */ new Set();
+  for (const e of Object.values(n.locales))
+    for (const c of Object.keys(e))
+      a.add(c);
+  const t = (e) => e.startsWith("@"), s = (e, c, l) => {
+    const u = e.slice(1);
+    if (!a.has(u)) {
+      const h = o.get(c) || `${l}:${c}`;
+      r.push({
+        file: h,
+        message: `Localization key "${e}" not found in any locale file`,
+        suggestion: `Add "${u}: ..." to your locale files`
       });
     }
   };
-  for (const t of Object.values(e.locations))
-    o(t.name) && r(t.name, t.id, "location"), o(t.description) && r(t.description, t.id, "location");
-  for (const t of Object.values(e.characters))
-    o(t.name) && r(t.name, t.id, "character"), o(t.biography) && r(t.biography, t.id, "character");
-  for (const t of Object.values(e.items))
-    o(t.name) && r(t.name, t.id, "item"), o(t.description) && r(t.description, t.id, "item");
-  for (const t of Object.values(e.quests)) {
-    o(t.name) && r(t.name, t.id, "quest"), o(t.description) && r(t.description, t.id, "quest");
-    for (const l of t.stages)
-      o(l.description) && r(l.description, t.id, "quest");
+  for (const e of Object.values(n.locations))
+    t(e.name) && s(e.name, e.id, "location"), t(e.description) && s(e.description, e.id, "location");
+  for (const e of Object.values(n.characters))
+    t(e.name) && s(e.name, e.id, "character"), t(e.biography) && s(e.biography, e.id, "character");
+  for (const e of Object.values(n.items))
+    t(e.name) && s(e.name, e.id, "item"), t(e.description) && s(e.description, e.id, "item");
+  for (const e of Object.values(n.quests)) {
+    t(e.name) && s(e.name, e.id, "quest"), t(e.description) && s(e.description, e.id, "quest");
+    for (const c of e.stages)
+      t(c.description) && s(c.description, e.id, "quest");
   }
-  for (const t of Object.values(e.journalEntries))
-    o(t.title) && r(t.title, t.id, "journal"), o(t.text) && r(t.text, t.id, "journal");
-  for (const t of Object.values(e.dialogues))
-    for (const l of t.nodes) {
-      o(l.text) && r(l.text, t.id, "dialogue");
-      for (const d of l.choices)
-        o(d.text) && r(d.text, t.id, "dialogue");
+  for (const e of Object.values(n.journalEntries))
+    t(e.title) && s(e.title, e.id, "journal"), t(e.text) && s(e.text, e.id, "journal");
+  for (const e of Object.values(n.dialogues))
+    for (const c of e.nodes) {
+      t(c.text) && s(c.text, e.id, "dialogue");
+      for (const l of c.choices)
+        t(l.text) && s(l.text, e.id, "dialogue");
     }
-  for (const t of Object.values(e.interludes))
-    o(t.text) && r(t.text, t.id, "interlude");
-  return i;
+  for (const e of Object.values(n.interludes))
+    t(e.text) && s(e.text, e.id, "interlude");
+  return r;
 }
-function I(e) {
-  if (e.length === 0) {
-    console.log(c.green("✓ No validation errors"));
+function N(n) {
+  if (n.length === 0) {
+    console.log(i.green("✓ No validation errors"));
     return;
   }
-  console.log(c.red(`
-✗ Found ${e.length} validation error${e.length === 1 ? "" : "s"}:
+  console.log(i.red(`
+✗ Found ${n.length} validation error${n.length === 1 ? "" : "s"}:
 `));
-  for (const n of e)
-    console.log(c.bold(n.file) + (n.line ? `:${n.line}` : "")), console.log("  " + c.red(n.message)), n.suggestion && console.log("  " + c.dim(n.suggestion)), console.log();
+  for (const o of n)
+    console.log(i.bold(o.file) + (o.line ? `:${o.line}` : "")), console.log("  " + i.red(o.message)), o.suggestion && console.log("  " + i.dim(o.suggestion)), console.log();
 }
-const C = "🐾", W = "✨", Q = "✏️", Y = "➕";
-async function V() {
-  const e = process.cwd(), n = s(e, "content");
-  console.log(""), console.log(c.bold.magenta(`  ${C} Doodle Engine Dev Server ${C}`)), console.log("");
-  const i = {
+const R = "🐾", Q = "✨", Y = "✏️", V = "➕";
+async function K() {
+  const n = process.cwd(), o = d(n, "content");
+  console.log(""), console.log(i.bold.magenta(`  ${R} Doodle Engine Dev Server ${R}`)), console.log("");
+  const r = {
     name: "doodle-content-loader",
-    configureServer(o) {
-      o.middlewares.use("/api/content", async (t, l) => {
+    configureServer(t) {
+      t.middlewares.use("/api/content", async (e, c) => {
         try {
-          const d = await P(n);
-          l.setHeader("Content-Type", "application/json"), l.end(JSON.stringify(d));
-        } catch (d) {
-          console.error(c.red("  Error loading content:"), d), l.statusCode = 500, l.end(JSON.stringify({ error: "Failed to load content" }));
+          const l = await z(o);
+          c.setHeader("Content-Type", "application/json"), c.end(JSON.stringify(l));
+        } catch (l) {
+          console.error(i.red("  Error loading content:"), l), c.statusCode = 500, c.end(JSON.stringify({ error: "Failed to load content" }));
         }
       });
-      const r = H(n, {
+      const s = M(o, {
         ignored: /(^|[\/\\])\../,
         persistent: !0
       });
-      r.on("change", async (t) => {
-        console.log(c.yellow(`  ${Q} Content changed: ${t}`)), await R(n), o.ws.send({
+      s.on("change", async (e) => {
+        console.log(i.yellow(`  ${Y} Content changed: ${e}`)), await A(o), t.ws.send({
           type: "full-reload",
           path: "*"
         });
-      }), r.on("add", async (t) => {
-        console.log(c.green(`  ${Y} Content added: ${t}`)), await R(n), o.ws.send({
+      }), s.on("add", async (e) => {
+        console.log(i.green(`  ${V} Content added: ${e}`)), await A(o), t.ws.send({
           type: "full-reload",
           path: "*"
         });
       });
     }
-  }, a = await j({
-    root: e,
-    plugins: [S(), i],
+  }, a = await $({
+    root: n,
+    plugins: [j(), r],
     server: {
       port: 3e3,
       open: !0
     }
   });
-  await a.listen(), a.printUrls(), console.log(""), console.log(c.dim(`  ${W} Watching content files for changes...`)), console.log("");
+  await a.listen(), a.printUrls(), console.log(""), console.log(i.dim(`  ${Q} Watching content files for changes...`)), console.log("");
 }
-async function P(e) {
-  const n = {
+async function z(n) {
+  const o = {
     locations: {},
     characters: {},
     items: {},
@@ -265,7 +265,7 @@ async function P(e) {
     interludes: {},
     locales: {}
   };
-  let i = null;
+  let r = null;
   const a = [
     { dir: "locations", key: "locations" },
     { dir: "characters", key: "characters" },
@@ -275,41 +275,41 @@ async function P(e) {
     { dir: "journal", key: "journalEntries" },
     { dir: "interludes", key: "interludes" }
   ];
-  for (const { dir: o, key: r } of a) {
-    const t = s(e, o);
+  for (const { dir: t, key: s } of a) {
+    const e = d(n, t);
     try {
-      const l = await y(t);
-      for (const d of l)
-        if (f(d) === ".yaml" || f(d) === ".yml") {
-          const h = s(t, d), u = await p(h, "utf-8"), g = b(u);
-          g && g.id && (n[r][g.id] = g);
+      const c = await p(e);
+      for (const l of c)
+        if (g(l) === ".yaml" || g(l) === ".yml") {
+          const u = d(e, l), h = await f(u, "utf-8"), m = y(h);
+          m && m.id && (o[s][m.id] = m);
         }
     } catch {
     }
   }
   try {
-    const o = s(e, "locales"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".yaml" || f(t) === ".yml") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = b(d), u = t.replace(/\.(yaml|yml)$/, "");
-        n.locales[u] = h ?? {};
+    const t = d(n, "locales"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".yaml" || g(e) === ".yml") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = y(l), h = e.replace(/\.(yaml|yml)$/, "");
+        o.locales[h] = u ?? {};
       }
   } catch {
   }
   try {
-    const o = s(e, "dialogues"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".dlg") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = t.replace(".dlg", ""), u = v(d, h);
-        n.dialogues[u.id] = u;
+    const t = d(n, "dialogues"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".dlg") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = e.replace(".dlg", ""), h = E(l, u);
+        o.dialogues[h.id] = h;
       }
   } catch {
   }
   try {
-    const o = s(e, "game.yaml"), r = await p(o, "utf-8");
-    i = b(r);
+    const t = d(n, "game.yaml"), s = await f(t, "utf-8");
+    r = y(s);
   } catch {
-    console.warn(c.yellow("  No game.yaml found, using defaults")), i = {
+    console.warn(i.yellow("  No game.yaml found, using defaults")), r = {
       startLocation: "tavern",
       startTime: { day: 1, hour: 8 },
       startFlags: {},
@@ -317,18 +317,18 @@ async function P(e) {
       startInventory: []
     };
   }
-  return { registry: n, config: i };
+  return { registry: o, config: r };
 }
-async function R(e) {
+async function A(n) {
   try {
-    const { registry: n, fileMap: i } = await K(e), a = T(n, i);
-    a.length > 0 && (console.log(""), I(a), console.log(""));
-  } catch (n) {
-    console.error(c.red("  Error running validation:"), n);
+    const { registry: o, fileMap: r } = await X(n), a = I(o, r);
+    a.length > 0 && (console.log(""), N(a), console.log(""));
+  } catch (o) {
+    console.error(i.red("  Error running validation:"), o);
   }
 }
-async function K(e) {
-  const n = {
+async function X(n) {
+  const o = {
     locations: {},
     characters: {},
     items: {},
@@ -338,7 +338,7 @@ async function K(e) {
     journalEntries: {},
     interludes: {},
     locales: {}
-  }, i = /* @__PURE__ */ new Map(), a = [
+  }, r = /* @__PURE__ */ new Map(), a = [
     { dir: "locations", key: "locations" },
     { dir: "characters", key: "characters" },
     { dir: "items", key: "items" },
@@ -347,66 +347,66 @@ async function K(e) {
     { dir: "journal", key: "journalEntries" },
     { dir: "interludes", key: "interludes" }
   ];
-  for (const { dir: o, key: r } of a) {
-    const t = s(e, o);
+  for (const { dir: t, key: s } of a) {
+    const e = d(n, t);
     try {
-      const l = await y(t);
-      for (const d of l)
-        if (f(d) === ".yaml" || f(d) === ".yml") {
-          const h = s(t, d), u = await p(h, "utf-8"), g = b(u);
-          g && g.id && (n[r][g.id] = g, i.set(g.id, w(process.cwd(), h)));
+      const c = await p(e);
+      for (const l of c)
+        if (g(l) === ".yaml" || g(l) === ".yml") {
+          const u = d(e, l), h = await f(u, "utf-8"), m = y(h);
+          m && m.id && (o[s][m.id] = m, r.set(m.id, b(process.cwd(), u)));
         }
     } catch {
     }
   }
   try {
-    const o = s(e, "locales"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".yaml" || f(t) === ".yml") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = b(d), u = t.replace(/\.(yaml|yml)$/, "");
-        n.locales[u] = h ?? {};
+    const t = d(n, "locales"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".yaml" || g(e) === ".yml") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = y(l), h = e.replace(/\.(yaml|yml)$/, "");
+        o.locales[h] = u ?? {};
       }
   } catch {
   }
   try {
-    const o = s(e, "dialogues"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".dlg") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = t.replace(".dlg", ""), u = v(d, h);
-        n.dialogues[u.id] = u, i.set(u.id, w(process.cwd(), l));
+    const t = d(n, "dialogues"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".dlg") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = e.replace(".dlg", ""), h = E(l, u);
+        o.dialogues[h.id] = h, r.set(h.id, b(process.cwd(), c));
       }
   } catch {
   }
-  return { registry: n, fileMap: i };
+  return { registry: o, fileMap: r };
 }
-async function z() {
-  const e = process.cwd(), n = s(e, "content");
-  console.log(""), console.log(c.bold.magenta("🐕 Building Doodle Engine game...")), console.log(""), console.log(c.dim("Validating content..."));
-  let i;
+async function Z() {
+  const n = process.cwd(), o = d(n, "content");
+  console.log(""), console.log(i.bold.magenta("🐕 Building Doodle Engine game...")), console.log(""), console.log(i.dim("Validating content..."));
+  let r;
   try {
-    const { registry: a, fileMap: o, config: r } = await X(n), t = T(a, o);
-    I(t), t.length > 0 && (console.log(c.red("Build failed due to validation errors.")), console.log(""), process.exit(1)), i = { registry: a, config: r };
+    const { registry: a, fileMap: t, config: s } = await ee(o), e = I(a, t);
+    N(e), e.length > 0 && (console.log(i.red("Build failed due to validation errors.")), console.log(""), process.exit(1)), r = { registry: a, config: s };
   } catch (a) {
-    console.error(c.red("Error loading content:"), a), process.exit(1);
+    console.error(i.red("Error loading content:"), a), process.exit(1);
   }
   console.log("");
   try {
-    await $({
-      root: e,
-      plugins: [S()],
+    await H({
+      root: n,
+      plugins: [j()],
       build: {
         outDir: "dist",
         emptyOutDir: !0
       }
     });
-    const a = s(e, "dist", "api");
-    await A(a, { recursive: !0 }), await m(s(a, "content"), JSON.stringify(i)), console.log(""), console.log(c.green("✅ Build complete! Output in dist/")), console.log(""), console.log("To preview the build:"), console.log(c.dim("  yarn preview")), console.log("");
+    const a = d(n, "dist", "api");
+    await D(a, { recursive: !0 }), await k(d(a, "content"), JSON.stringify(r)), console.log(""), console.log(i.green("✅ Build complete! Output in dist/")), console.log(""), console.log("To preview the build:"), console.log(i.dim("  yarn preview")), console.log("");
   } catch (a) {
-    console.error(c.red("Build failed:"), a), process.exit(1);
+    console.error(i.red("Build failed:"), a), process.exit(1);
   }
 }
-async function X(e) {
-  const n = {
+async function ee(n) {
+  const o = {
     locations: {},
     characters: {},
     items: {},
@@ -416,7 +416,7 @@ async function X(e) {
     journalEntries: {},
     interludes: {},
     locales: {}
-  }, i = /* @__PURE__ */ new Map(), a = [
+  }, r = /* @__PURE__ */ new Map(), a = [
     { dir: "locations", key: "locations" },
     { dir: "characters", key: "characters" },
     { dir: "items", key: "items" },
@@ -425,57 +425,57 @@ async function X(e) {
     { dir: "journal", key: "journalEntries" },
     { dir: "interludes", key: "interludes" }
   ];
-  for (const { dir: r, key: t } of a) {
-    const l = s(e, r);
+  for (const { dir: s, key: e } of a) {
+    const c = d(n, s);
     try {
-      const d = await y(l);
-      for (const h of d)
-        if (f(h) === ".yaml" || f(h) === ".yml") {
-          const u = s(l, h), g = await p(u, "utf-8"), E = b(g);
-          E && E.id && (n[t][E.id] = E, i.set(E.id, w(process.cwd(), u)));
+      const l = await p(c);
+      for (const u of l)
+        if (g(u) === ".yaml" || g(u) === ".yml") {
+          const h = d(c, u), m = await f(h, "utf-8"), w = y(m);
+          w && w.id && (o[e][w.id] = w, r.set(w.id, b(process.cwd(), h)));
         }
     } catch {
     }
   }
   try {
-    const r = s(e, "locales"), t = await y(r);
-    for (const l of t)
-      if (f(l) === ".yaml" || f(l) === ".yml") {
-        const d = s(r, l), h = await p(d, "utf-8"), u = b(h), g = l.replace(/\.(yaml|yml)$/, "");
-        n.locales[g] = u ?? {};
+    const s = d(n, "locales"), e = await p(s);
+    for (const c of e)
+      if (g(c) === ".yaml" || g(c) === ".yml") {
+        const l = d(s, c), u = await f(l, "utf-8"), h = y(u), m = c.replace(/\.(yaml|yml)$/, "");
+        o.locales[m] = h ?? {};
       }
   } catch {
   }
   try {
-    const r = s(e, "dialogues"), t = await y(r);
-    for (const l of t)
-      if (f(l) === ".dlg") {
-        const d = s(r, l), h = await p(d, "utf-8"), u = l.replace(".dlg", ""), g = v(h, u);
-        n.dialogues[g.id] = g, i.set(g.id, w(process.cwd(), d));
+    const s = d(n, "dialogues"), e = await p(s);
+    for (const c of e)
+      if (g(c) === ".dlg") {
+        const l = d(s, c), u = await f(l, "utf-8"), h = c.replace(".dlg", ""), m = E(u, h);
+        o.dialogues[m.id] = m, r.set(m.id, b(process.cwd(), l));
       }
   } catch {
   }
-  let o = null;
+  let t = null;
   try {
-    const r = s(e, "game.yaml"), t = await p(r, "utf-8");
-    o = b(t);
+    const s = d(n, "game.yaml"), e = await f(s, "utf-8");
+    t = y(e);
   } catch {
-    o = { id: "game", startLocation: "", startTime: { day: 1, hour: 8 }, startFlags: {}, startVariables: {}, startInventory: [] };
+    t = { id: "game", startLocation: "", startTime: { day: 1, hour: 8 }, startFlags: {}, startVariables: {}, startInventory: [] };
   }
-  return { registry: n, fileMap: i, config: o };
+  return { registry: o, fileMap: r, config: t };
 }
-async function Z() {
-  const e = process.cwd(), n = s(e, "content");
-  console.log(""), console.log(c.bold.magenta("🐾 Validating Doodle Engine content...")), console.log("");
+async function ne() {
+  const n = process.cwd(), o = d(n, "content");
+  console.log(""), console.log(i.bold.magenta("🐾 Validating Doodle Engine content...")), console.log("");
   try {
-    const { registry: i, fileMap: a } = await ee(n), o = T(i, a);
-    I(o), o.length > 0 && process.exit(1);
-  } catch (i) {
-    console.error(c.red("Error loading content:"), i), process.exit(1);
+    const { registry: r, fileMap: a } = await te(o), t = I(r, a);
+    N(t), t.length > 0 && process.exit(1);
+  } catch (r) {
+    console.error(i.red("Error loading content:"), r), process.exit(1);
   }
 }
-async function ee(e) {
-  const n = {
+async function te(n) {
+  const o = {
     locations: {},
     characters: {},
     items: {},
@@ -484,7 +484,7 @@ async function ee(e) {
     quests: {},
     journalEntries: {},
     locales: {}
-  }, i = /* @__PURE__ */ new Map(), a = [
+  }, r = /* @__PURE__ */ new Map(), a = [
     { dir: "locations", key: "locations" },
     { dir: "characters", key: "characters" },
     { dir: "items", key: "items" },
@@ -492,124 +492,43 @@ async function ee(e) {
     { dir: "quests", key: "quests" },
     { dir: "journal", key: "journalEntries" }
   ];
-  for (const { dir: o, key: r } of a) {
-    const t = s(e, o);
+  for (const { dir: t, key: s } of a) {
+    const e = d(n, t);
     try {
-      const l = await y(t);
-      for (const d of l)
-        if (f(d) === ".yaml" || f(d) === ".yml") {
-          const h = s(t, d), u = await p(h, "utf-8"), g = b(u);
-          g && g.id && (n[r][g.id] = g, i.set(g.id, w(process.cwd(), h)));
+      const c = await p(e);
+      for (const l of c)
+        if (g(l) === ".yaml" || g(l) === ".yml") {
+          const u = d(e, l), h = await f(u, "utf-8"), m = y(h);
+          m && m.id && (o[s][m.id] = m, r.set(m.id, b(process.cwd(), u)));
         }
     } catch {
     }
   }
   try {
-    const o = s(e, "locales"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".yaml" || f(t) === ".yml") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = b(d), u = t.replace(/\.(yaml|yml)$/, "");
-        n.locales[u] = h ?? {};
+    const t = d(n, "locales"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".yaml" || g(e) === ".yml") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = y(l), h = e.replace(/\.(yaml|yml)$/, "");
+        o.locales[h] = u ?? {};
       }
   } catch {
   }
   try {
-    const o = s(e, "dialogues"), r = await y(o);
-    for (const t of r)
-      if (f(t) === ".dlg") {
-        const l = s(o, t), d = await p(l, "utf-8"), h = t.replace(".dlg", ""), u = v(d, h);
-        n.dialogues[u.id] = u, i.set(u.id, w(process.cwd(), l));
+    const t = d(n, "dialogues"), s = await p(t);
+    for (const e of s)
+      if (g(e) === ".dlg") {
+        const c = d(t, e), l = await f(c, "utf-8"), u = e.replace(".dlg", ""), h = E(l, u);
+        o.dialogues[h.id] = h, r.set(h.id, b(process.cwd(), c));
       }
   } catch {
   }
-  return { registry: n, fileMap: i };
-}
-const D = "🐾", te = "🐕", x = "🦴", oe = "✨", q = "📁", _ = "✅", ae = "🚀";
-async function ne(e) {
-  const n = s(process.cwd(), e);
-  console.log(""), console.log(c.bold.magenta(`  ${D} Doodle Engine ${D}`)), console.log(c.dim("  Text-based RPG and Adventure Game Scaffolder")), console.log(""), console.log(`  ${te} Creating new game: ${c.bold.cyan(e)}`), console.log("");
-  const { useDefaultRenderer: i } = await M({
-    type: "confirm",
-    name: "useDefaultRenderer",
-    message: "Use default renderer?",
-    initial: !0
-  });
-  i === void 0 && (console.log(c.yellow(`
-  ${x} No worries, maybe next time! Woof!`)), process.exit(0)), console.log(""), await re(n, e, i), console.log(""), console.log(c.bold.green(`  ${_} Project created successfully!`)), console.log(""), console.log(c.dim(`  ${q} ${n}`)), console.log(""), console.log(c.bold("  Next steps:")), console.log(c.cyan(`    cd ${e}`)), console.log(c.cyan("    npm install       ") + c.dim("# or: yarn install / pnpm install")), console.log(c.cyan("    npm run dev        ") + c.dim("# or: yarn dev / pnpm dev")), console.log(""), console.log(c.dim(`  ${ae} Happy game making! ${D}`)), console.log("");
+  return { registry: o, fileMap: r };
 }
-async function re(e, n, i) {
-  const a = [
-    "content/locations",
-    "content/characters",
-    "content/items",
-    "content/dialogues",
-    "content/quests",
-    "content/journal",
-    "content/interludes",
-    "content/locales",
-    "content/maps",
-    "assets/images/banners",
-    "assets/images/portraits",
-    "assets/images/items",
-    "assets/images/maps",
-    "assets/audio/music",
-    "assets/audio/sfx",
-    "assets/audio/voice",
-    "src"
-  ];
-  console.log(`  ${q} ${c.bold("Creating directories...")}`);
-  for (const u of a)
-    await A(s(e, u), { recursive: !0 });
-  console.log(c.green(`  ${_} Directories created`)), console.log("");
-  const o = {
-    name: n,
-    version: "0.1.0",
-    type: "module",
-    scripts: {
-      dev: "doodle dev",
-      build: "doodle build",
-      preview: "vite preview"
-    },
-    dependencies: {
-      "@doodle-engine/core": "latest",
-      "@doodle-engine/react": "latest",
-      react: "^19.0.0",
-      "react-dom": "^19.0.0"
-    },
-    devDependencies: {
-      "@doodle-engine/cli": "latest",
-      "@types/react": "^19.0.0",
-      "@types/react-dom": "^19.0.0",
-      "@vitejs/plugin-react": "^4.3.0",
-      typescript: "^5.7.0",
-      vite: "^6.0.0"
-    }
-  };
-  console.log(`  ${oe} ${c.bold("Writing project files...")}`), await m(
-    s(e, "package.json"),
-    JSON.stringify(o, null, 2)
-  );
-  const r = {
-    compilerOptions: {
-      target: "ES2024",
-      lib: ["ES2024", "DOM", "DOM.Iterable"],
-      module: "ESNext",
-      moduleResolution: "bundler",
-      jsx: "react-jsx",
-      strict: !0,
-      skipLibCheck: !0,
-      esModuleInterop: !0,
-      forceConsistentCasingInFileNames: !0,
-      resolveJsonModule: !0,
-      isolatedModules: !0,
-      noEmit: !0
-    },
-    include: ["src"]
-  };
-  await m(
-    s(e, "tsconfig.json"),
-    JSON.stringify(r, null, 2)
-  ), await m(s(e, "index.html"), `<!doctype html>
+const oe = `node_modules
+dist
+.DS_Store
+*.log
+`, ae = `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
@@ -621,298 +540,40 @@ async function re(e, n, i) {
     <script type="module" src="/src/main.tsx"><\/script>
   </body>
 </html>
-`), await m(s(e, "src/main.tsx"), `import { StrictMode } from 'react'
-import { createRoot } from 'react-dom/client'
-import { App } from './App'
-import './index.css'
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <App />
-  </StrictMode>,
-)
-`);
-  let d;
-  i ? d = `import { useEffect, useState } from 'react'
-import type { ContentRegistry, GameConfig } from '@doodle-engine/core'
-import { GameShell, LoadingScreen } from '@doodle-engine/react'
-
-export function App() {
-  const [content, setContent] = useState<{ registry: ContentRegistry; config: GameConfig } | null>(null)
-
-  useEffect(() => {
-    fetch('/api/content')
-      .then(res => res.json())
-      .then(data => setContent({ registry: data.registry, config: data.config }))
-  }, [])
-
-  if (!content) {
-    return <LoadingScreen />
-  }
-
-  return (
-    <GameShell
-      registry={content.registry}
-      config={content.config}
-      title="My Doodle Game"
-      subtitle="A text-based adventure"
-      splashDuration={2000}
-      availableLocales={[{ code: 'en', label: 'English' }]}
-      devTools={import.meta.env.DEV}
-    />
-  )
-}
-` : d = `import { useEffect, useState } from 'react'
-import { Engine } from '@doodle-engine/core'
-import type { GameState, Snapshot } from '@doodle-engine/core'
-import { GameProvider, LoadingScreen, useGame } from '@doodle-engine/react'
-
-export function App() {
-  const [game, setGame] = useState<{ engine: Engine; snapshot: Snapshot } | null>(null)
-
-  useEffect(() => {
-    fetch('/api/content')
-      .then(res => res.json())
-      .then(data => {
-        const engine = new Engine(data.registry, createEmptyState())
-        const snapshot = engine.newGame(data.config)
-        setGame({ engine, snapshot })
-      })
-  }, [])
-
-  if (!game) {
-    return <LoadingScreen />
-  }
-
-  return (
-    <GameProvider engine={game.engine} initialSnapshot={game.snapshot} devTools={import.meta.env.DEV}>
-      <GameUI />
-    </GameProvider>
-  )
-}
-
-function GameUI() {
-  const { snapshot, actions } = useGame()
-
-  return (
-    <div style={{ padding: '2rem', fontFamily: 'sans-serif', maxWidth: '800px', margin: '0 auto' }}>
-      <h1>{snapshot.location.name}</h1>
-      <p>{snapshot.location.description}</p>
-
-      {snapshot.dialogue && (
-        <div style={{ background: '#f0f0f0', padding: '1rem', borderRadius: '8px', margin: '1rem 0' }}>
-          <strong>{snapshot.dialogue.speakerName}:</strong>
-          <p>{snapshot.dialogue.text}</p>
-          {snapshot.choices.map(choice => (
-            <button
-              key={choice.id}
-              onClick={() => actions.selectChoice(choice.id)}
-              style={{ display: 'block', margin: '0.5rem 0', padding: '0.5rem 1rem', cursor: 'pointer' }}
-            >
-              {choice.text}
-            </button>
-          ))}
-        </div>
-      )}
-
-      {!snapshot.dialogue && snapshot.charactersHere.length > 0 && (
-        <div>
-          <h2>Characters here</h2>
-          {snapshot.charactersHere.map(char => (
-            <button
-              key={char.id}
-              onClick={() => actions.talkTo(char.id)}
-              style={{ display: 'block', margin: '0.5rem 0', padding: '0.5rem 1rem', cursor: 'pointer' }}
-            >
-              Talk to {char.name}
-            </button>
-          ))}
-        </div>
-      )}
-    </div>
-  )
-}
-
-function createEmptyState(): GameState {
-  return {
-    currentLocation: '',
-    currentTime: { day: 1, hour: 0 },
-    flags: {},
-    variables: {},
-    inventory: [],
-    questProgress: {},
-    unlockedJournalEntries: [],
-    playerNotes: [],
-    dialogueState: null,
-    characterState: {},
-    itemLocations: {},
-    mapEnabled: true,
-    notifications: [],
-    pendingSounds: [],
-    pendingVideo: null,
-    currentLocale: 'en',
-  }
-}
-`, await m(s(e, "src/App.tsx"), d), await m(s(e, "src/index.css"), `body {
-  margin: 0;
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
-    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
-    sans-serif;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
+`, re = `{
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["src"]
 }
-`), console.log(c.green(`  ${_} Source files created`)), console.log(""), console.log(`  ${x} ${c.bold("Writing starter content...")}`), await m(s(e, "content/game.yaml"), `# Game Configuration
-startLocation: tavern
-startTime:
-  day: 1
-  hour: 8
-startFlags: {}
-startVariables:
-  gold: 100
-  reputation: 0
-  _drinksBought: 0
-startInventory: []
-`), await m(s(e, "content/locations/tavern.yaml"), `id: tavern
-name: "@location.tavern.name"
-description: "@location.tavern.description"
-banner: ""
-music: ""
-ambient: ""
-`), await m(s(e, "content/locations/market.yaml"), `id: market
-name: "@location.market.name"
-description: "@location.market.description"
-banner: ""
-music: ""
-ambient: ""
-`), await m(s(e, "content/characters/bartender.yaml"), `id: bartender
+`, se = `id: bartender
 name: "@character.bartender.name"
 biography: "@character.bartender.bio"
 portrait: ""
 location: tavern
 dialogue: bartender_greeting
 stats: {}
-`), await m(s(e, "content/characters/merchant.yaml"), `id: merchant
+`, ie = `id: merchant
 name: "@character.merchant.name"
 biography: "@character.merchant.bio"
 portrait: ""
 location: market
 dialogue: merchant_intro
 stats: {}
-`), await m(s(e, "content/items/old_coin.yaml"), `id: old_coin
-name: "@item.old_coin.name"
-description: "@item.old_coin.description"
-icon: ""
-image: ""
-location: tavern
-stats: {}
-`), await m(s(e, "content/maps/town.yaml"), `id: town
-name: "@map.town.name"
-image: ""
-scale: 1
-locations:
-  - id: tavern
-    x: 100
-    y: 200
-  - id: market
-    x: 300
-    y: 150
-`), await m(s(e, "content/quests/odd_jobs.yaml"), `id: odd_jobs
-name: "@quest.odd_jobs.name"
-description: "@quest.odd_jobs.description"
-stages:
-  - id: started
-    description: "@quest.odd_jobs.stage.started"
-  - id: talked_to_merchant
-    description: "@quest.odd_jobs.stage.talked_to_merchant"
-  - id: complete
-    description: "@quest.odd_jobs.stage.complete"
-`), await m(s(e, "content/journal/tavern_discovery.yaml"), `id: tavern_discovery
-title: "@journal.tavern_discovery.title"
-text: "@journal.tavern_discovery.text"
-category: places
-`), await m(s(e, "content/journal/odd_jobs_accepted.yaml"), `id: odd_jobs_accepted
-title: "@journal.odd_jobs_accepted.title"
-text: "@journal.odd_jobs_accepted.text"
-category: quests
-`), await m(s(e, "content/journal/market_square.yaml"), `id: market_square
-title: "@journal.market_square.title"
-text: "@journal.market_square.text"
-category: places
-`), await m(s(e, "content/interludes/chapter_one.yaml"), `id: chapter_one
-# Background image shown fullscreen during the interlude.
-# Replace with your own image in assets/images/.
-background: /assets/images/banners/tavern_banner.jpg
-
-# Optional: decorative border/frame image overlaid on the background.
-# banner: /assets/images/ui/chapter_frame.png
-
-# Optional: music to play during this interlude.
-# music: /assets/audio/music/chapter_theme.ogg
-
-# The narrative text. Supports @localization.key or plain text.
-text: |
-  Chapter One: A New Beginning
-
-  The road behind you stretches long and empty.
-  Ahead, the lights of town flicker through the evening mist.
-
-  You have heard the rumours. Strange things happening.
-  People going missing. Shadows that move wrong.
-
-  Someone has to look into it.
-
-  It might as well be you.
-
-# Auto-trigger when the player enters the tavern for the first time.
-# triggerConditions prevents re-triggering. effects runs when the interlude fires
-# — setFlag here marks it seen so it won't show again on return visits.
-triggerLocation: tavern
-triggerConditions:
-  - type: notFlag
-    flag: seenChapterOne
-effects:
-  - type: setFlag
-    flag: seenChapterOne
-`), await m(s(e, "content/dialogues/tavern_intro.dlg"), `# This dialogue triggers automatically when the player enters the tavern.
-# TRIGGER <locationId> fires on arrival. REQUIRE conditions guard the trigger.
-# Use notFlag to make it a one-time intro.
-
-TRIGGER tavern
-REQUIRE notFlag seenTavernIntro
-
-# Each NODE is a conversation point. The first NODE is always the start.
-NODE start
-  # NARRATOR: has no speaker — used for scene-setting text.
-  # @narrator.tavern_intro is a localization key defined in content/locales/en.yaml.
-  # You can also write text inline: NARRATOR: "The tavern is warm and smells of ale."
-  NARRATOR: @narrator.tavern_intro
-
-  # Effects run immediately when this node is reached, before choices are shown.
-  SET flag seenTavernIntro
-
-  # CHOICE text can use a @key or "inline text".
-  # A choice with END dialogue is a terminal choice — no GOTO needed.
-  CHOICE @narrator.choice.look_around
-    END dialogue
-  END
-`), await m(s(e, "content/dialogues/market_intro.dlg"), `# One-time narrator intro for the market. Same pattern as tavern_intro.dlg.
-
-TRIGGER market
-REQUIRE notFlag seenMarketIntro
-
-NODE start
-  NARRATOR: @narrator.market_intro
-  SET flag seenMarketIntro
-
-  # ADD journalEntry unlocks a journal entry for the player.
-  ADD journalEntry market_square
-
-  CHOICE @narrator.choice.look_around
-    END dialogue
-  END
-`), await m(s(e, "content/dialogues/bartender_greeting.dlg"), `# This dialogue is triggered by clicking the bartender character.
-# SPEAKER: lines set who's talking — matched to character ID (case-insensitive).
-# Nodes can have multiple CHOICE blocks; REQUIRE hides a choice if the condition fails.
+`, ce = `# This dialogue is triggered by clicking the bartender character.
+# SPEAKER: lines set who's talking — matched to character ID (case-insensitive).
+# Nodes can have multiple CHOICE blocks; REQUIRE hides a choice if the condition fails.
 
 NODE start
   BARTENDER: @bartender.greeting
@@ -987,6 +648,11 @@ NODE order_drink
     GOTO after_drink
   END
 
+  # Try to bluff a free drink — launches the skill check dialogue (demonstrates: START dialogue)
+  CHOICE @bartender.choice.try_bluff
+    START dialogue bluff_check
+  END
+
   # Always available as an out
   CHOICE @bartender.choice.too_rich
     GOTO start
@@ -1052,7 +718,65 @@ NODE work_done
 NODE farewell
   BARTENDER: @bartender.farewell
   END dialogue
-`), await m(s(e, "content/dialogues/merchant_intro.dlg"), `# Merchant dialogue. Same speaker-line and CHOICE syntax as bartender_greeting.dlg.
+`, le = `# Skill check example — demonstrates dice rolling and variable interpolation.
+#
+# ROLL <variable> <min> <max>  — rolls a random integer and stores it in a variable.
+# {varName}                    — in dialogue text, replaced with the variable's value.
+# roll <min> <max> <threshold> — condition: rolls and returns true if result >= threshold.
+#
+# This dialogue is NOT auto-triggered — start it from another node with:
+#   START dialogue bluff_check
+
+NODE start
+  # Roll a d20 and store it as "bluffRoll" before the player sees the result
+  ROLL bluffRoll 1 20
+  NARRATOR: @bluff.setup
+
+  CHOICE @bluff.choice.attempt
+    GOTO resolve
+  END
+
+  CHOICE @bluff.choice.back_down
+    NARRATOR: @bluff.backed_down
+    END dialogue
+  END
+
+NODE resolve
+  # Show the roll result using {bluffRoll} interpolation in the locale string
+  NARRATOR: @bluff.rolled
+
+  # Branch on whether the stored variable passes a threshold (15+)
+  IF variableGreaterThan bluffRoll 14
+    GOTO success
+  END
+
+  GOTO failure
+
+NODE success
+  NARRATOR: @bluff.success
+  ADD relationship bartender 2
+  SET flag bluffedMarcus
+  END dialogue
+
+NODE failure
+  NARRATOR: @bluff.failure
+  END dialogue
+`, de = `# One-time narrator intro for the market. Same pattern as tavern_intro.dlg.
+
+TRIGGER market
+REQUIRE notFlag seenMarketIntro
+
+NODE start
+  NARRATOR: @narrator.market_intro
+  SET flag seenMarketIntro
+
+  # ADD journalEntry unlocks a journal entry for the player.
+  ADD journalEntry market_square
+
+  CHOICE @narrator.choice.look_around
+    END dialogue
+  END
+`, ue = `# Merchant dialogue. Same speaker-line and CHOICE syntax as bartender_greeting.dlg.
 # The quest choices here demonstrate multi-stage quest gating with questAtStage.
 
 NODE start
@@ -1155,50 +879,94 @@ NODE about_market
 NODE farewell
   MERCHANT: @merchant.farewell
   END dialogue
-`), await m(s(e, "content/dialogues/bluff_check.dlg"), `# Skill check example — demonstrates dice rolling and variable interpolation.
-#
-# ROLL <variable> <min> <max>  — rolls a random integer and stores it in a variable.
-# {varName}                    — in dialogue text, replaced with the variable's value.
-# roll <min> <max> <threshold> — condition: rolls and returns true if result >= threshold.
-#
-# This dialogue is NOT auto-triggered — start it from another node with:
-#   START dialogue bluff_check
+`, he = `# This dialogue triggers automatically when the player enters the tavern.
+# TRIGGER <locationId> fires on arrival. REQUIRE conditions guard the trigger.
+# Use notFlag to make it a one-time intro.
+
+TRIGGER tavern
+REQUIRE notFlag seenTavernIntro
 
+# Each NODE is a conversation point. The first NODE is always the start.
 NODE start
-  # Roll a d20 and store it as "bluffRoll" before the player sees the result
-  ROLL bluffRoll 1 20
-  NARRATOR: @bluff.setup
+  # NARRATOR: has no speaker — used for scene-setting text.
+  # @narrator.tavern_intro is a localization key defined in content/locales/en.yaml.
+  # You can also write text inline: NARRATOR: "The tavern is warm and smells of ale."
+  NARRATOR: @narrator.tavern_intro
 
-  CHOICE @bluff.choice.attempt
-    GOTO resolve
-  END
+  # Effects run immediately when this node is reached, before choices are shown.
+  SET flag seenTavernIntro
 
-  CHOICE @bluff.choice.back_down
-    NARRATOR: @bluff.backed_down
+  # CHOICE text can use a @key or "inline text".
+  # A choice with END dialogue is a terminal choice — no GOTO needed.
+  CHOICE @narrator.choice.look_around
     END dialogue
   END
+`, me = `# Game Configuration
+startLocation: tavern
+startTime:
+  day: 1
+  hour: 8
+startFlags: {}
+startVariables:
+  gold: 100
+  reputation: 0
+  _drinksBought: 0
+startInventory: []
+`, ge = `id: chapter_one
+# Background image shown fullscreen during the interlude.
+# Replace with your own image in assets/images/.
+background: /assets/images/banners/tavern_banner.jpg
 
-NODE resolve
-  # Show the roll result using {bluffRoll} interpolation in the locale string
-  NARRATOR: @bluff.rolled
+# Optional: decorative border/frame image overlaid on the background.
+# banner: /assets/images/ui/chapter_frame.png
 
-  # Branch on whether the stored variable passes a threshold (15+)
-  IF variableGreaterThan bluffRoll 14
-    GOTO success
-  END
+# Optional: music to play during this interlude.
+# music: /assets/audio/music/chapter_theme.ogg
 
-  GOTO failure
+# The narrative text. Supports @localization.key or plain text.
+text: |
+  Chapter One: A New Beginning
 
-NODE success
-  NARRATOR: @bluff.success
-  ADD relationship bartender 2
-  SET flag bluffedMarcus
-  END dialogue
+  The road behind you stretches long and empty.
+  Ahead, the lights of town flicker through the evening mist.
 
-NODE failure
-  NARRATOR: @bluff.failure
-  END dialogue
-`), await m(s(e, "content/locales/en.yaml"), `# ===================
+  You have heard the rumours. Strange things happening.
+  People going missing. Shadows that move wrong.
+
+  Someone has to look into it.
+
+  It might as well be you.
+
+# Auto-trigger when the player enters the tavern for the first time.
+# triggerConditions prevents re-triggering. effects runs when the interlude fires
+# — setFlag here marks it seen so it won't show again on return visits.
+triggerLocation: tavern
+triggerConditions:
+  - type: notFlag
+    flag: seenChapterOne
+effects:
+  - type: setFlag
+    flag: seenChapterOne
+`, fe = `id: old_coin
+name: "@item.old_coin.name"
+description: "@item.old_coin.description"
+icon: ""
+image: ""
+location: tavern
+stats: {}
+`, pe = `id: market_square
+title: "@journal.market_square.title"
+text: "@journal.market_square.text"
+category: places
+`, ye = `id: odd_jobs_accepted
+title: "@journal.odd_jobs_accepted.title"
+text: "@journal.odd_jobs_accepted.text"
+category: quests
+`, be = `id: tavern_discovery
+title: "@journal.tavern_discovery.title"
+text: "@journal.tavern_discovery.text"
+category: places
+`, _e = `# ===================
 # Narrator Intros
 # ===================
 narrator.tavern_intro: "You push open the heavy oak door and step inside. The warmth hits you first, then the smell — stale ale, wood smoke, and something frying in the kitchen. A few patrons hunch over their mugs. Behind the bar, a broad-shouldered man wipes down glasses, watching you with quiet interest."
@@ -1267,6 +1035,7 @@ bartender.choice.nevermind: "Never mind, just passing through."
 bartender.choice.tell_me_more: "Tell me more about that."
 bartender.choice.interesting: "Interesting. I'll keep that in mind."
 bartender.choice.sure_pay: "Sure, here's five gold."
+bartender.choice.try_bluff: "Try to talk your way to a free drink."
 bartender.choice.too_rich: "On second thought, I'll pass."
 bartender.choice.back_to_chat: "So, what else?"
 bartender.choice.accept_work: "Sure, I could use the coin."
@@ -1335,26 +1104,298 @@ bluff.choice.attempt: "Try to bluff him."
 bluff.choice.back_down: "Actually, never mind."
 bluff.backed_down: "Some fights aren't worth picking."
 bluff.rolled: "You spin the tale with {bluffRoll} on your roll — and Marcus listens carefully."
-bluff.success: "The story lands perfectly. Marcus laughs and slides a free drink across the bar. "That's a good one," he admits."
-bluff.failure: "Marcus raises an eyebrow. "Nice try," he says, entirely unconvinced. "That'll be five gold.""
-`), console.log(c.green(`  ${_} Starter content created`)), console.log(""), console.log(c.dim("  Content includes:")), console.log(c.dim("    2 locations  (tavern, market)")), console.log(c.dim("    2 characters (bartender, merchant)")), console.log(c.dim("    1 item       (old coin)")), console.log(c.dim("    1 map        (town with 2 locations)")), console.log(c.dim("    1 quest      (odd jobs, 3 stages)")), console.log(c.dim("    3 journal entries")), console.log(c.dim("    1 interlude  (chapter one, auto-triggers at tavern)")), console.log(c.dim("    5 dialogues  (2 narrator intros, 2 NPC conversations, 1 skill check)")), console.log(c.dim("    English locale with all strings")), await m(s(e, ".gitignore"), `node_modules
-dist
-.DS_Store
-*.log
-`);
+bluff.success: "The story lands perfectly. Marcus laughs and slides a free drink across the bar. Not bad at all, he admits."
+bluff.failure: "Marcus raises an eyebrow, entirely unconvinced. That will be five gold, he says flatly."
+`, we = `id: market
+name: "@location.market.name"
+description: "@location.market.description"
+banner: ""
+music: ""
+ambient: ""
+`, ke = `id: tavern
+name: "@location.tavern.name"
+description: "@location.tavern.description"
+banner: ""
+music: ""
+ambient: ""
+`, Ee = `id: town
+name: "@map.town.name"
+image: ""
+scale: 1
+locations:
+  - id: tavern
+    x: 100
+    y: 200
+  - id: market
+    x: 300
+    y: 150
+`, ve = `id: odd_jobs
+name: "@quest.odd_jobs.name"
+description: "@quest.odd_jobs.description"
+stages:
+  - id: started
+    description: "@quest.odd_jobs.stage.started"
+  - id: talked_to_merchant
+    description: "@quest.odd_jobs.stage.talked_to_merchant"
+  - id: complete
+    description: "@quest.odd_jobs.stage.complete"
+`, Oe = `import { useEffect, useState } from 'react'
+import { Engine } from '@doodle-engine/core'
+import type { GameState, Snapshot } from '@doodle-engine/core'
+import { GameProvider, LoadingScreen, useGame } from '@doodle-engine/react'
+
+export function App() {
+  const [game, setGame] = useState<{ engine: Engine; snapshot: Snapshot } | null>(null)
+
+  useEffect(() => {
+    fetch('/api/content')
+      .then(res => res.json())
+      .then(data => {
+        const engine = new Engine(data.registry, createEmptyState())
+        const snapshot = engine.newGame(data.config)
+        setGame({ engine, snapshot })
+      })
+  }, [])
+
+  if (!game) {
+    return <LoadingScreen />
+  }
+
+  return (
+    <GameProvider engine={game.engine} initialSnapshot={game.snapshot} devTools={import.meta.env.DEV}>
+      <GameUI />
+    </GameProvider>
+  )
+}
+
+function GameUI() {
+  const { snapshot, actions } = useGame()
+
+  return (
+    <div style={{ padding: '2rem', fontFamily: 'sans-serif', maxWidth: '800px', margin: '0 auto' }}>
+      <h1>{snapshot.location.name}</h1>
+      <p>{snapshot.location.description}</p>
+
+      {snapshot.dialogue && (
+        <div style={{ background: '#f0f0f0', padding: '1rem', borderRadius: '8px', margin: '1rem 0' }}>
+          <strong>{snapshot.dialogue.speakerName}:</strong>
+          <p>{snapshot.dialogue.text}</p>
+          {snapshot.choices.map(choice => (
+            <button
+              key={choice.id}
+              onClick={() => actions.selectChoice(choice.id)}
+              style={{ display: 'block', margin: '0.5rem 0', padding: '0.5rem 1rem', cursor: 'pointer' }}
+            >
+              {choice.text}
+            </button>
+          ))}
+        </div>
+      )}
+
+      {!snapshot.dialogue && snapshot.charactersHere.length > 0 && (
+        <div>
+          <h2>Characters here</h2>
+          {snapshot.charactersHere.map(char => (
+            <button
+              key={char.id}
+              onClick={() => actions.talkTo(char.id)}
+              style={{ display: 'block', margin: '0.5rem 0', padding: '0.5rem 1rem', cursor: 'pointer' }}
+            >
+              Talk to {char.name}
+            </button>
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}
+
+function createEmptyState(): GameState {
+  return {
+    currentLocation: '',
+    currentTime: { day: 1, hour: 0 },
+    flags: {},
+    variables: {},
+    inventory: [],
+    questProgress: {},
+    unlockedJournalEntries: [],
+    playerNotes: [],
+    dialogueState: null,
+    characterState: {},
+    itemLocations: {},
+    mapEnabled: true,
+    notifications: [],
+    pendingSounds: [],
+    pendingVideo: null,
+    pendingInterlude: null,
+    currentLocale: 'en',
+  }
 }
-const k = new G();
-k.name("doodle").description(c.magenta("🐾 Doodle Engine") + c.dim(" — Narrative RPG development tools")).version("0.0.1");
-k.command("create <project-name>").description("Scaffold a new Doodle Engine game project").action(async (e) => {
-  await ne(e);
+`, De = `import { useEffect, useState } from 'react'
+import type { ContentRegistry, GameConfig } from '@doodle-engine/core'
+import { GameShell, LoadingScreen } from '@doodle-engine/react'
+
+export function App() {
+  const [content, setContent] = useState<{ registry: ContentRegistry; config: GameConfig } | null>(null)
+
+  useEffect(() => {
+    fetch('/api/content')
+      .then(res => res.json())
+      .then(data => setContent({ registry: data.registry, config: data.config }))
+  }, [])
+
+  if (!content) {
+    return <LoadingScreen />
+  }
+
+  return (
+    <GameShell
+      registry={content.registry}
+      config={content.config}
+      title="My Doodle Game"
+      subtitle="A text-based adventure"
+      splashDuration={2000}
+      availableLocales={[{ code: 'en', label: 'English' }]}
+      devTools={import.meta.env.DEV}
+    />
+  )
+}
+`, Te = `body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+`, Ie = `import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { App } from './App'
+import './index.css'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
+`, O = "🐾", Ne = "🐕", x = "🦴", Ce = "✨", q = "📁", T = "✅", Re = "🚀", S = /* @__PURE__ */ Object.assign({
+  "./templates/_root/_gitignore": oe,
+  "./templates/_root/index.html": ae,
+  "./templates/_root/tsconfig.json": re,
+  "./templates/content/characters/bartender.yaml": se,
+  "./templates/content/characters/merchant.yaml": ie,
+  "./templates/content/dialogues/bartender_greeting.dlg": ce,
+  "./templates/content/dialogues/bluff_check.dlg": le,
+  "./templates/content/dialogues/market_intro.dlg": de,
+  "./templates/content/dialogues/merchant_intro.dlg": ue,
+  "./templates/content/dialogues/tavern_intro.dlg": he,
+  "./templates/content/game.yaml": me,
+  "./templates/content/interludes/chapter_one.yaml": ge,
+  "./templates/content/items/old_coin.yaml": fe,
+  "./templates/content/journal/market_square.yaml": pe,
+  "./templates/content/journal/odd_jobs_accepted.yaml": ye,
+  "./templates/content/journal/tavern_discovery.yaml": be,
+  "./templates/content/locales/en.yaml": _e,
+  "./templates/content/locations/market.yaml": we,
+  "./templates/content/locations/tavern.yaml": ke,
+  "./templates/content/maps/town.yaml": Ee,
+  "./templates/content/quests/odd_jobs.yaml": ve,
+  "./templates/src/App.custom.tsx": Oe,
+  "./templates/src/App.default.tsx": De,
+  "./templates/src/index.css": Te,
+  "./templates/src/main.tsx": Ie
 });
-k.command("dev").description("Start development server with hot reload").action(async () => {
-  await V();
+function Ae(n) {
+  const o = n.replace("./templates/", "");
+  if (o === "src/App.default.tsx" || o === "src/App.custom.tsx") return null;
+  if (o.startsWith("_root/")) {
+    const r = o.slice(6);
+    return r.startsWith("_") ? "." + r.slice(1) : r;
+  }
+  return o;
+}
+async function Se(n) {
+  const o = d(process.cwd(), n);
+  console.log(""), console.log(i.bold.magenta(`  ${O} Doodle Engine ${O}`)), console.log(i.dim("  Text-based RPG and Adventure Game Scaffolder")), console.log(""), console.log(`  ${Ne} Creating new game: ${i.bold.cyan(n)}`), console.log("");
+  const { useDefaultRenderer: r } = await P({
+    type: "confirm",
+    name: "useDefaultRenderer",
+    message: "Use default renderer?",
+    initial: !0
+  });
+  r === void 0 && (console.log(i.yellow(`
+  ${x} No worries, maybe next time! Woof!`)), process.exit(0)), console.log(""), await je(o, n, r), console.log(""), console.log(i.bold.green(`  ${T} Project created successfully!`)), console.log(""), console.log(i.dim(`  ${q} ${o}`)), console.log(""), console.log(i.bold("  Next steps:")), console.log(i.cyan(`    cd ${n}`)), console.log(i.cyan("    npm install       ") + i.dim("# or: yarn install / pnpm install")), console.log(i.cyan("    npm run dev        ") + i.dim("# or: yarn dev / pnpm dev")), console.log(""), console.log(i.dim(`  ${Re} Happy game making! ${O}`)), console.log("");
+}
+async function je(n, o, r) {
+  const a = [
+    "content/locations",
+    "content/characters",
+    "content/items",
+    "content/dialogues",
+    "content/quests",
+    "content/journal",
+    "content/interludes",
+    "content/locales",
+    "content/maps",
+    "assets/images/banners",
+    "assets/images/portraits",
+    "assets/images/items",
+    "assets/images/maps",
+    "assets/audio/music",
+    "assets/audio/sfx",
+    "assets/audio/voice",
+    "src"
+  ];
+  console.log(`  ${q} ${i.bold("Creating directories...")}`);
+  for (const e of a)
+    await D(d(n, e), { recursive: !0 });
+  console.log(i.green(`  ${T} Directories created`)), console.log("");
+  const t = {
+    name: o,
+    version: "0.1.0",
+    type: "module",
+    scripts: {
+      dev: "doodle dev",
+      build: "doodle build",
+      preview: "vite preview"
+    },
+    dependencies: {
+      "@doodle-engine/core": "latest",
+      "@doodle-engine/react": "latest",
+      react: "^19.0.0",
+      "react-dom": "^19.0.0"
+    },
+    devDependencies: {
+      "@doodle-engine/cli": "latest",
+      "@types/react": "^19.0.0",
+      "@types/react-dom": "^19.0.0",
+      "@vitejs/plugin-react": "^4.3.0",
+      typescript: "^5.7.0",
+      vite: "^6.0.0"
+    }
+  };
+  console.log(`  ${Ce} ${i.bold("Writing project files...")}`), await k(d(n, "package.json"), JSON.stringify(t, null, 2));
+  for (const [e, c] of Object.entries(S)) {
+    const l = Ae(e);
+    if (l === null) continue;
+    const u = d(n, l);
+    await D(F(u), { recursive: !0 }), await k(u, c);
+  }
+  const s = r ? "./templates/src/App.default.tsx" : "./templates/src/App.custom.tsx";
+  await k(d(n, "src/App.tsx"), S[s]), console.log(i.green(`  ${T} Source files created`)), console.log(""), console.log(`  ${x} ${i.bold("Starter content written")}`), console.log(""), console.log(i.dim("  Content includes:")), console.log(i.dim("    2 locations  (tavern, market)")), console.log(i.dim("    2 characters (bartender, merchant)")), console.log(i.dim("    1 item       (old coin)")), console.log(i.dim("    1 map        (town with 2 locations)")), console.log(i.dim("    1 quest      (odd jobs, 3 stages)")), console.log(i.dim("    3 journal entries")), console.log(i.dim("    1 interlude  (chapter one, auto-triggers at tavern)")), console.log(i.dim("    5 dialogues  (2 narrator intros, 2 NPC conversations, 1 skill check)")), console.log(i.dim("    English locale with all strings"));
+}
+const _ = new G();
+_.name("doodle").description(i.magenta("🐾 Doodle Engine") + i.dim(" — Narrative RPG development tools")).version("0.0.1");
+_.command("create <project-name>").description("Scaffold a new Doodle Engine game project").action(async (n) => {
+  await Se(n);
 });
-k.command("build").description("Build game for production").action(async () => {
-  await z();
+_.command("dev").description("Start development server with hot reload").action(async () => {
+  await K();
 });
-k.command("validate").description("Validate game content").action(async () => {
+_.command("build").description("Build game for production").action(async () => {
   await Z();
 });
-k.parse();
+_.command("validate").description("Validate game content").action(async () => {
+  await ne();
+});
+_.parse();