@flatkit/compiler 0.3.0 → 0.5.0

package/dist/{chunk-F3X2F6QC.js → chunk-EHUP3IKN.js}

@@ -10,11 +10,13 @@ import {
 // src/cli/flatc.ts
 import { readFileSync, writeFileSync, existsSync, readdirSync, watch, mkdirSync, copyFileSync } from "fs";
 import { resolve, dirname, basename, extname, join, relative, isAbsolute } from "path";
-import { parseProgramFull } from "@flatkit/engine/flatFormat";
+import { parseProgramFull, parseFlatLib } from "@flatkit/engine/flatFormat";
 import { hasPackage } from "@flatkit/engine/stdlib";
 import { parseUnits } from "@flatkit/engine/dsl";
 import { sanitizeDoc } from "@flatkit/engine/validateDoc";
 import { unitsToFunctions } from "@flatkit/engine/scriptDoc";
+import { containerBBox } from "@flatkit/engine/groups";
+import { IDENTITY } from "@flatkit/engine/transform";
 import { playHeadless } from "@flatkit/player/debug";
 var MIME = {
   ".png": "image/png",
@@ -48,6 +50,7 @@ Usage:
   flatc <program.flatink> --watch
   flatc --play <program.flatink | scene.flatpack> --script <gestures.json>
   flatc --render <program.flatink | scene.flatpack> -o out.png [--frame N] [--at k=v[,k2=v2]] [--scale S]
+  flatc --preview <library.flat> [--symbol NAME] [-o out.flatpack | --render -o out.png]
 
   program.flatink   the program (composition + logic, text DSL)
   assets.flat       visual asset libs (default: every .flat in the program's folder)
@@ -66,6 +69,11 @@ Usage:
                     "expect" self-verifies: { "type": "expect", "sends": ["done"], "vars": { "score": 3 } } \u2192 exits \u22600 on mismatch
                     (sends = sequence of names emitted SINCE the last expect; vars = current state). Great in CI.
   --render          render a PNG IMAGE (headless skia): see what we draw (positioning)
+  --preview         wrap ONE symbol of a <library.flat> into a playable Doc (a single centered instance on an
+                    auto-sized stage) \u2192 a .flatpack to drop in the browser player, or a PNG with --render.
+                    No wrapper .flatink to author by hand. Output defaults to <library>.<symbol>.flatpack/.png
+  --symbol NAME     (with --preview) which symbol to wrap (default: the first in the lib)
+  --pad N           (with --preview) padding in px around the symbol's bounds (default 24)
   --frame N         (with --render) target frame (default 0)
   --at k=v[,k2=v2]  (with --render) force variables \u2192 capture a given state (e.g. a step of an escape)
   --steps N         (with --render) run N fixed sim steps (60 Hz, every-frame) BEFORE capture \u2192 see a
@@ -227,6 +235,20 @@ function parseVars(spec, into) {
     if (k && Number.isFinite(v)) into[k] = v;
   }
 }
+async function renderDocToFile(doc, outPath, frame, vars, scale, steps) {
+  try {
+    const { renderDocToPng } = await import("./cli/render.js");
+    const png = await renderDocToPng(doc, { frame, vars: Object.keys(vars).length ? vars : void 0, scale, steps: steps || void 0 });
+    writeFileSync(outPath, png);
+  } catch (e) {
+    process.stderr.write(`flatc: render failed: ${e.message}
+`);
+    return 1;
+  }
+  process.stdout.write(`flatc: ${basename(outPath)} \u2713  ${doc.width}\xD7${doc.height} \xD7${scale}${frame ? ` \xB7 frame ${frame}` : ""}${steps ? ` \xB7 ${steps} step(s)` : ""}${Object.keys(vars).length ? ` \xB7 ${Object.entries(vars).map(([k, v]) => `${k}=${v}`).join(" ")}` : ""}
+`);
+  return 0;
+}
 async function renderOnce(filePath, out, frame, vars, scale, steps) {
   let doc;
   try {
@@ -237,24 +259,62 @@ async function renderOnce(filePath, out, frame, vars, scale, steps) {
     return 1;
   }
   const outPath = out ? resolve(out) : join(dirname(filePath), basename(filePath, extname(filePath)) + ".png");
+  return renderDocToFile(doc, outPath, frame, vars, scale, steps);
+}
+function buildPreviewDoc(flatPath, symbolName, pad) {
+  const { symbols } = parseFlatLib(readFileSync(flatPath, "utf8"));
+  if (!symbols.length) throw new Error("no symbols found in this .flat library");
+  let symbol = symbols[0];
+  if (symbolName) {
+    const found = symbols.find((s) => s.name === symbolName);
+    if (!found) throw new Error(`symbol "${symbolName}" not found \u2014 available: ${symbols.map((s) => s.name).join(", ")}`);
+    symbol = found;
+  }
+  const instance = { id: "preview_instance", kind: "instance", name: symbol.name, transform: { ...IDENTITY }, symbolId: symbol.id };
+  const layer = { id: "preview_layer", name: "preview", visible: true, locked: false, opacity: 1, items: [instance] };
+  const tl = symbol.timeline;
+  const timeline = { fps: tl?.fps ?? 24, durationFrames: tl?.durationFrames ?? 1, tracks: [] };
+  let doc = { width: 1, height: 1, layers: [layer], symbols, timeline };
+  const bb = containerBBox(doc, instance, 0);
+  if (bb) {
+    doc = { ...doc, width: Math.max(1, Math.ceil(bb.maxX - bb.minX) + pad * 2), height: Math.max(1, Math.ceil(bb.maxY - bb.minY) + pad * 2) };
+    instance.transform = { ...IDENTITY, e: pad - bb.minX, f: pad - bb.minY };
+  } else {
+    doc = { ...doc, width: 512, height: 512 };
+    instance.transform = { ...IDENTITY, e: 256, f: 256 };
+  }
+  return { doc, symbol, others: symbols.filter((s) => s !== symbol).map((s) => s.name) };
+}
+async function previewOnce(flatPath, symbolName, out, frame, vars, scale, steps, doRender, pad) {
+  let built;
   try {
-    const { renderDocToPng } = await import("./cli/render.js");
-    const png = await renderDocToPng(doc, { frame, vars: Object.keys(vars).length ? vars : void 0, scale, steps: steps || void 0 });
-    writeFileSync(outPath, png);
+    built = buildPreviewDoc(flatPath, symbolName, pad);
   } catch (e) {
-    process.stderr.write(`flatc: render failed: ${e.message}
+    process.stderr.write(`flatc: ${e.message}
 `);
     return 1;
   }
-  process.stdout.write(`flatc: ${basename(outPath)} \u2713  ${doc.width}\xD7${doc.height} \xD7${scale}${frame ? ` \xB7 frame ${frame}` : ""}${steps ? ` \xB7 ${steps} step(s)` : ""}${Object.keys(vars).length ? ` \xB7 ${Object.entries(vars).map(([k, v]) => `${k}=${v}`).join(" ")}` : ""}
+  const { doc, symbol, others } = built;
+  const stem = `${basename(flatPath, extname(flatPath))}.${symbol.name}`;
+  let code;
+  if (doRender) {
+    code = await renderDocToFile(doc, out ? resolve(out) : join(dirname(flatPath), stem + ".png"), frame, vars, scale, steps);
+  } else {
+    const outPath = out ? resolve(out) : join(dirname(flatPath), stem + ".flatpack");
+    writeFileSync(outPath, packToJSON(doc));
+    process.stdout.write(`flatc: ${basename(outPath)} \u2713  preview of "${symbol.name}" \xB7 ${doc.width}\xD7${doc.height} \xB7 play it in the browser player
 `);
-  return 0;
+    code = 0;
+  }
+  if (!symbolName && others.length) process.stderr.write(`flatc: previewed "${symbol.name}"; other symbols in this lib: ${others.join(", ")} (pick with --symbol <name>)
+`);
+  return code;
 }
 function run(argv) {
   const args = argv.slice(2);
-  let out = "", scriptPath = "";
-  let checkOnly = false, doWatch = false, doPlay = false, doRender = false, doTrace = false;
-  let frame = 0, scale = 2, steps = 0;
+  let out = "", scriptPath = "", symbolName = "";
+  let checkOnly = false, doWatch = false, doPlay = false, doRender = false, doTrace = false, doPreview = false;
+  let frame = 0, scale = 2, steps = 0, pad = 24;
   let assetMode = "inline";
   const vars = {};
   const positional = [];
@@ -268,6 +328,9 @@ function run(argv) {
     else if (a === "--play") doPlay = true;
     else if (a === "--trace") doTrace = true;
     else if (a === "--render") doRender = true;
+    else if (a === "--preview") doPreview = true;
+    else if (a === "--symbol") symbolName = args[++i] ?? "";
+    else if (a === "--pad") pad = Math.max(0, Number(args[++i] ?? "24") || 0);
     else if (a === "--frame") frame = Number(args[++i] ?? "0") || 0;
     else if (a === "--steps") steps = Math.max(0, Number(args[++i] ?? "0") || 0);
     else if (a === "--scale") scale = Number(args[++i] ?? "2") || 2;
@@ -288,6 +351,7 @@ function run(argv) {
     return 1;
   }
   const explicitFlats = positional.slice(1);
+  if (doPreview) return previewOnce(filePath, symbolName, out, frame, vars, scale, steps, doRender, pad);
   if (doRender) return renderOnce(filePath, out, frame, vars, scale, steps);
   if (doPlay) return playOnce(filePath, scriptPath, doTrace);
   if (doWatch) {
@@ -309,4 +373,4 @@ function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=chunk-F3X2F6QC.js.map
+//# sourceMappingURL=chunk-EHUP3IKN.js.map

package/dist/chunk-EHUP3IKN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/flatc.ts"],"sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n//  flatc — the \"modern SWF\" command-line compiler.\n//\n//  The VSCode-first flow: you write a `.flatink` program (composition + logic, DSL)\n//  + `.flat` asset libs (visuals, exported by the editor) + media, then:\n//\n//      flatc game.flatink hero.flat decor.flat -o game.flatpack\n//\n//  → a single `.flatpack` (the baked Doc as JSON) that the player runs. Media referenced\n//  by `asset \"id\" \"path\" kind` are EMBEDDED (paths relative to the program).\n// ─────────────────────────────────────────────────────────────────────────────\nimport { readFileSync, writeFileSync, existsSync, readdirSync, watch, mkdirSync, copyFileSync } from 'node:fs'\nimport { resolve, dirname, basename, extname, join, relative, isAbsolute } from 'node:path'\nimport { compileFlatpack, packToJSON, type MediaMap } from '../compile'\nimport { parseProgramFull, parseFlatLib } from '@flatkit/engine/flatFormat'\nimport { hasPackage } from '@flatkit/engine/stdlib'\nimport { parseUnits } from '@flatkit/engine/dsl'\nimport { sanitizeDoc } from '@flatkit/engine/validateDoc'\nimport { unitsToFunctions } from '@flatkit/engine/scriptDoc'\nimport { containerBBox } from '@flatkit/engine/groups'\nimport { IDENTITY } from '@flatkit/engine/transform'\nimport { lintDocReport, docHasErrors } from '../programDoc'\nimport { playHeadless, type Gesture } from '@flatkit/player/debug'\nimport type { FuncDef } from '@flatkit/engine/actions'\nimport type { Doc, Instance, Layer, SymbolDef } from '@flatkit/types'\n\nconst MIME: Record<string, string> = {\n  '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif',\n  '.webp': 'image/webp', '.svg': 'image/svg+xml', '.avif': 'image/avif',\n  '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.ogg': 'audio/ogg', '.m4a': 'audio/mp4',\n  // Fonts (RFC 8081 media types) — matches the editor's import (`font/woff2` default, FontFace API).\n  '.woff2': 'font/woff2', '.woff': 'font/woff', '.ttf': 'font/ttf', '.otf': 'font/otf',\n  // NB: video (.mp4/.webm/…) intentionally omitted — no video runtime in the editor or player yet.\n}\nconst mimeFor = (path: string): string => MIME[extname(path).toLowerCase()] ?? 'application/octet-stream'\n\n/**\n * True if `target` resolves to a file inside `baseDir` (or baseDir itself). Guards against a hostile\n * program escaping its folder via `../` in a media path or a `use` package name — compiling an untrusted\n * `.flatink` must never read (and embed) arbitrary host files.\n */\nfunction isWithin(baseDir: string, target: string): boolean {\n  const rel = relative(baseDir, target)\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel))\n}\n\nfunction printHelp(): void {\n  process.stdout.write(`flatc — compile a FlatInk program into a .flatpack\n\nUsage:\n  flatc <program.flatink> [assets.flat …] [-o output.flatpack]\n  flatc <program.flatink> --watch\n  flatc --play <program.flatink | scene.flatpack> --script <gestures.json>\n  flatc --render <program.flatink | scene.flatpack> -o out.png [--frame N] [--at k=v[,k2=v2]] [--scale S]\n  flatc --preview <library.flat> [--symbol NAME] [-o out.flatpack | --render -o out.png]\n\n  program.flatink   the program (composition + logic, text DSL)\n  assets.flat       visual asset libs (default: every .flat in the program's folder)\n  -o, --out         output file (default: <program>.flatpack — the CANONICAL name, JSON inside)\n  --assets MODE     media baking: 'inline' (default, base64 in the .flatpack) or 'external'\n                    (sidecar <out>.assets/ folder; asset.data = relative key — serve the folder and\n                    play with sameOriginAssetResolver(<flatpackUrl>))\n  --check           semantic lint only (no .flatpack); exits ≠0 on ERROR (warnings do not stop)\n  --watch           recompile on every change in the folder (agent → player loop)\n  --play            run the file WITHOUT a canvas, replay --script and print { sends, vars } (JSON)\n  --trace           (with --play) HUMAN-READABLE log per gesture: emitted sends + variable diff (debug)\n  --script <f>      JSON gesture script: [{ \"type\": \"down|move|up|cancel\", \"x\", \"y\" }, { \"type\": \"set\", \"name\", \"value\" }, { \"type\": \"wait\", \"frames\": N }]\n                    semantic (by NAME, the engine resolves coords): { \"type\": \"drag\", \"source\", \"target\" } · { \"type\": \"tap\", \"target\" }\n                    · { \"type\": \"scratch\", \"target\" } (sweeps a reveal zone) · { \"type\": \"connect\", \"source\", \"target\" } (pulls a link wire)\n                    \"wait\" lets the simulation run N fixed steps (60 Hz): \"every frame\" + playhead advance like in real playback\n                    \"expect\" self-verifies: { \"type\": \"expect\", \"sends\": [\"done\"], \"vars\": { \"score\": 3 } } → exits ≠0 on mismatch\n                    (sends = sequence of names emitted SINCE the last expect; vars = current state). Great in CI.\n  --render          render a PNG IMAGE (headless skia): see what we draw (positioning)\n  --preview         wrap ONE symbol of a <library.flat> into a playable Doc (a single centered instance on an\n                    auto-sized stage) → a .flatpack to drop in the browser player, or a PNG with --render.\n                    No wrapper .flatink to author by hand. Output defaults to <library>.<symbol>.flatpack/.png\n  --symbol NAME     (with --preview) which symbol to wrap (default: the first in the lib)\n  --pad N           (with --preview) padding in px around the symbol's bounds (default 24)\n  --frame N         (with --render) target frame (default 0)\n  --at k=v[,k2=v2]  (with --render) force variables → capture a given state (e.g. a step of an escape)\n  --steps N         (with --render) run N fixed sim steps (60 Hz, every-frame) BEFORE capture → see a\n                    stateful act unfold without forcing every derived variable by hand in --at\n  --scale S         (with --render) resolution factor (default 2)\n  -h, --help        this help\n\nMedia referenced by 'asset \"id\" \"path\" kind' are embedded (paths relative to the program).\n`)\n}\n\n/** How media is baked: `inline` = base64 data-URI in the .flatpack; `external` = relative key + sidecar files. */\ntype AssetMode = 'inline' | 'external'\ntype MediaCopy = { src: string; key: string } // external mode: source file → relative key (forward slashes)\ntype BuildResult = { doc: Doc; flatLibs: number; packages: number; media: number; mediaCopies: MediaCopy[] }\n\n/**\n * Reads a `.flatink`, resolves libs/packages/media, compiles → standalone Doc. Throws on compile error.\n * `assetMode`: `inline` embeds each media as a base64 data-URI (default); `external` keeps `asset.data` as a\n * relative key (`<assetsDir>/<path>`) and returns the files to copy beside the .flatpack (no base64 bloat).\n */\nfunction buildDocFromProgram(programPath: string, explicitFlats: string[] = [], assetMode: AssetMode = 'inline', assetsDir = ''): BuildResult {\n  const baseDir = dirname(programPath)\n  const programSrc = readFileSync(programPath, 'utf8')\n  const prog = parseProgramFull(programSrc)\n\n  // .flat libs: explicit if provided, otherwise auto-discover the .flat files in the program's folder.\n  const flatPaths = new Set<string>(explicitFlats.map((p) => resolve(p)))\n  if (!flatPaths.size) for (const f of readdirSync(baseDir).filter((f) => f.endsWith('.flat'))) flatPaths.add(join(baseDir, f))\n\n  // PACKAGES: non-stdlib `use \"x\"` → local files inlined (x.flatink = functions, x.flat = symbols).\n  const pkgFunctions: FuncDef[] = []\n  const localResolved = new Set<string>()\n  for (const name of prog.imports ?? []) {\n    if (hasPackage(name)) continue // stdlib → left as a reference\n    const fink = join(baseDir, name + '.flatink')\n    const fflat = join(baseDir, name + '.flat')\n    if (!isWithin(baseDir, fink) || !isWithin(baseDir, fflat)) { process.stderr.write(`flatc: package outside the program folder (ignored): \"${name}\"\\n`); continue }\n    let found = false\n    if (existsSync(fink)) { for (const f of unitsToFunctions(parseUnits(readFileSync(fink, 'utf8')).units)) pkgFunctions.push(f, { ...f, name: `${name}.${f.name}` }); found = true }\n    if (existsSync(fflat)) { flatPaths.add(fflat); found = true }\n    if (found) localResolved.add(name)\n    else process.stderr.write(`flatc: package not found: \"${name}\" (neither stdlib, nor ${name}.flatink / ${name}.flat)\\n`)\n  }\n  const assetSrcs = [...flatPaths].map((p) => readFileSync(p, 'utf8'))\n\n  // Media: each `asset … \"path\" …` resolved relative to the program. `inline` → base64 data-URI baked in;\n  // `external` → `asset.data` becomes a relative key and the file is copied next to the .flatpack.\n  const media: MediaMap = {}\n  const mediaCopies: MediaCopy[] = []\n  for (const a of prog.assets ?? []) {\n    const mp = resolve(baseDir, a.data)\n    if (!isWithin(baseDir, mp)) { process.stderr.write(`flatc: media outside the program folder (ignored): ${a.data}\\n`); continue }\n    if (!existsSync(mp)) { process.stderr.write(`flatc: missing media (ignored): ${a.data}\\n`); continue }\n    const mime = mimeFor(mp)\n    if (assetMode === 'external') {\n      const key = `${assetsDir}/${a.data.replace(/\\\\/g, '/')}` // URL-form relative key (resolved by the host)\n      media[a.data] = { mime, data: key }\n      mediaCopies.push({ src: mp, key })\n    } else {\n      media[a.data] = { mime, data: `data:${mime};base64,${readFileSync(mp).toString('base64')}` }\n    }\n  }\n\n  let doc = compileFlatpack(programSrc, assetSrcs, media)\n  if (pkgFunctions.length) doc = { ...doc, functions: [...(doc.functions ?? []), ...pkgFunctions] }\n  const stdImports = (doc.imports ?? []).filter(hasPackage)\n  doc = { ...doc, imports: stdImports.length ? stdImports : undefined }\n  return { doc, flatLibs: flatPaths.size, packages: localResolved.size, media: Object.keys(media).length, mediaCopies }\n}\n\n/** Compile once (write or --check). Returns the exit code. */\nfunction compileOnce(programPath: string, explicitFlats: string[], out: string, checkOnly: boolean, assetMode: AssetMode = 'inline'): number {\n  const outPath = out ? resolve(out) : join(dirname(programPath), basename(programPath, extname(programPath)) + '.flatpack')\n  // External mode: sidecar folder next to the .flatpack, e.g. `game.flatpack` → `game.assets/`.\n  const assetsDir = assetMode === 'external' ? basename(outPath, extname(outPath)) + '.assets' : ''\n  let built: BuildResult\n  try { built = buildDocFromProgram(programPath, explicitFlats, assetMode, assetsDir) }\n  catch (e) { process.stderr.write(`flatc: compile error: ${(e as Error).message}\\n`); return 1 }\n  const { doc } = built\n  const report = lintDocReport(doc)\n  if (checkOnly) {\n    if (report) process.stderr.write(report + '\\n')\n    if (docHasErrors(doc)) return 1\n    process.stdout.write('flatc: no errors ✓\\n')\n    return 0\n  }\n  if (report) process.stderr.write(report + '\\n') // compile anyway: diagnostics as warnings\n  writeFileSync(outPath, packToJSON(doc))\n  const outDir = dirname(outPath)\n  for (const c of built.mediaCopies) {\n    const dest = join(outDir, ...c.key.split('/'))\n    if (!isWithin(outDir, dest)) continue // defensive: never write outside the output folder\n    mkdirSync(dirname(dest), { recursive: true })\n    copyFileSync(c.src, dest)\n  }\n  const where = assetMode === 'external' ? ` (external → ${assetsDir}/)` : ''\n  process.stdout.write(`flatc: ${basename(outPath)} ✓  ${doc.symbols.length} symbol(s) · ${built.flatLibs} lib(s) · ${built.packages} package(s) · ${built.media} media${where}\\n`)\n  return 0\n}\n\n/** Loads a Doc from a `.flatink` (compiled) or a `.flatpack`/`.flatpack.json` (already-baked JSON). */\nfunction loadDoc(filePath: string): Doc {\n  if (filePath.endsWith('.flatink')) return buildDocFromProgram(filePath).doc\n  // .flatpack (canonical) or .flatpack.json (alias): untrusted JSON → normalize before use.\n  return sanitizeDoc(JSON.parse(readFileSync(filePath, 'utf8')))\n}\n\n/** --play: runs the file headless, replays --script, prints { sends, vars }. */\nfunction playOnce(filePath: string, scriptPath: string, trace: boolean): number {\n  if (!scriptPath) { process.stderr.write('flatc: --play requires --script <gestures.json>\\n'); return 1 }\n  if (!existsSync(scriptPath)) { process.stderr.write(`flatc: script not found: ${scriptPath}\\n`); return 1 }\n  let doc: Doc, gestures: Gesture[]\n  try { doc = loadDoc(filePath) } catch (e) { process.stderr.write(`flatc: cannot read: ${(e as Error).message}\\n`); return 1 }\n  try { gestures = JSON.parse(readFileSync(scriptPath, 'utf8')) as Gesture[] } catch (e) { process.stderr.write(`flatc: invalid JSON script: ${(e as Error).message}\\n`); return 1 }\n  if (!Array.isArray(gestures)) { process.stderr.write('flatc: the script must be an array of gestures\\n'); return 1 }\n  const res = playHeadless(doc, gestures, { trace })\n  if (!trace) process.stdout.write(JSON.stringify(res, null, 2) + '\\n')\n  else // --trace: readable log (one gesture per line) → inspection / debug-player.\n    for (const s of res.steps ?? []) {\n      const sends = s.sends.length ? '  sends:[' + s.sends.map((e) => (e.value !== undefined ? `${e.name}=${e.value}` : e.name)).join(', ') + ']' : ''\n      const vars = Object.entries(s.changed).map(([k, [a, b]]) => `${k}:${JSON.stringify(a)}→${JSON.stringify(b)}`)\n      process.stdout.write(`${s.gesture.padEnd(28)}${sends}${vars.length ? '  vars{' + vars.join(' ') + '}' : ''}\\n`)\n    }\n  // `expect`: any detected mismatch → stderr log + exit code ≠0 (CI self-verification).\n  if (res.expectFailures?.length) {\n    for (const f of res.expectFailures) process.stderr.write(`flatc: ✗ ${f}\\n`)\n    return 1\n  }\n  return 0\n}\n\n/** Parses `--at`: \"k=v[,k2=v2]\" → variable table (state override for rendering). */\nfunction parseVars(spec: string, into: Record<string, number>): void {\n  for (const pair of spec.split(',')) {\n    const i = pair.indexOf('=')\n    if (i < 0) continue\n    const k = pair.slice(0, i).trim(); const v = Number(pair.slice(i + 1).trim())\n    if (k && Number.isFinite(v)) into[k] = v\n  }\n}\n\n/** Renders a Doc to a PNG file (headless skia). Async (SVG decode + raster). Shared by --render and --preview. */\nasync function renderDocToFile(doc: Doc, outPath: string, frame: number, vars: Record<string, number>, scale: number, steps: number): Promise<number> {\n  try {\n    const { renderDocToPng } = await import('./render')\n    const png = await renderDocToPng(doc, { frame, vars: Object.keys(vars).length ? vars : undefined, scale, steps: steps || undefined })\n    writeFileSync(outPath, png)\n  } catch (e) { process.stderr.write(`flatc: render failed: ${(e as Error).message}\\n`); return 1 }\n  process.stdout.write(`flatc: ${basename(outPath)} ✓  ${doc.width}×${doc.height} ×${scale}${frame ? ` · frame ${frame}` : ''}${steps ? ` · ${steps} step(s)` : ''}${Object.keys(vars).length ? ` · ${Object.entries(vars).map(([k, v]) => `${k}=${v}`).join(' ')}` : ''}\\n`)\n  return 0\n}\n\n/** --render: renders the file to PNG (headless skia). Async (SVG decode + raster). */\nasync function renderOnce(filePath: string, out: string, frame: number, vars: Record<string, number>, scale: number, steps: number): Promise<number> {\n  let doc: Doc\n  try { doc = loadDoc(filePath) } catch (e) { process.stderr.write(`flatc: cannot read: ${(e as Error).message}\\n`); return 1 }\n  const outPath = out ? resolve(out) : join(dirname(filePath), basename(filePath, extname(filePath)) + '.png')\n  return renderDocToFile(doc, outPath, frame, vars, scale, steps)\n}\n\n/**\n * Wraps ONE symbol from a `.flat` library into a minimal, playable Doc: a single centered instance on a\n * canvas auto-sized to the symbol's frame-0 bounds (+ padding). Lets you preview a library asset without\n * hand-authoring a wrapper `.flatink`. The root timeline borrows the symbol's own fps/duration so a `synced`\n * instance loops at its natural rate. Throws if the lib is empty or the named symbol is missing.\n */\nfunction buildPreviewDoc(flatPath: string, symbolName: string, pad: number): { doc: Doc; symbol: SymbolDef; others: string[] } {\n  const { symbols } = parseFlatLib(readFileSync(flatPath, 'utf8'))\n  if (!symbols.length) throw new Error('no symbols found in this .flat library')\n  let symbol = symbols[0]\n  if (symbolName) {\n    const found = symbols.find((s) => s.name === symbolName)\n    if (!found) throw new Error(`symbol \"${symbolName}\" not found — available: ${symbols.map((s) => s.name).join(', ')}`)\n    symbol = found\n  }\n\n  const instance: Instance = { id: 'preview_instance', kind: 'instance', name: symbol.name, transform: { ...IDENTITY }, symbolId: symbol.id }\n  const layer: Layer = { id: 'preview_layer', name: 'preview', visible: true, locked: false, opacity: 1, items: [instance] }\n  const tl = symbol.timeline\n  const timeline = { fps: tl?.fps ?? 24, durationFrames: tl?.durationFrames ?? 1, tracks: [] }\n  // ALL symbols stay in the library (the chosen one may instance the others) — only `instance` is on stage.\n  let doc: Doc = { width: 1, height: 1, layers: [layer], symbols, timeline }\n\n  // Auto-size & center: measure the instance's frame-0 bounds, pad, recenter at the canvas middle. (bbox\n  // freezes nested timelines at frame 0, so animated motion may exceed it — that's what `pad` absorbs.)\n  const bb = containerBBox(doc, instance, 0)\n  if (bb) {\n    doc = { ...doc, width: Math.max(1, Math.ceil(bb.maxX - bb.minX) + pad * 2), height: Math.max(1, Math.ceil(bb.maxY - bb.minY) + pad * 2) }\n    instance.transform = { ...IDENTITY, e: pad - bb.minX, f: pad - bb.minY }\n  } else {\n    doc = { ...doc, width: 512, height: 512 } // empty/degenerate symbol: fall back to a fixed centered stage\n    instance.transform = { ...IDENTITY, e: 256, f: 256 }\n  }\n  return { doc, symbol, others: symbols.filter((s) => s !== symbol).map((s) => s.name) }\n}\n\n/** --preview: wraps one symbol of a `.flat` into a playable Doc, then writes a .flatpack (default) or a PNG (with --render). */\nasync function previewOnce(flatPath: string, symbolName: string, out: string, frame: number, vars: Record<string, number>, scale: number, steps: number, doRender: boolean, pad: number): Promise<number> {\n  let built: { doc: Doc; symbol: SymbolDef; others: string[] }\n  try { built = buildPreviewDoc(flatPath, symbolName, pad) }\n  catch (e) { process.stderr.write(`flatc: ${(e as Error).message}\\n`); return 1 }\n  const { doc, symbol, others } = built\n  const stem = `${basename(flatPath, extname(flatPath))}.${symbol.name}`\n  let code: number\n  if (doRender) {\n    code = await renderDocToFile(doc, out ? resolve(out) : join(dirname(flatPath), stem + '.png'), frame, vars, scale, steps)\n  } else {\n    const outPath = out ? resolve(out) : join(dirname(flatPath), stem + '.flatpack')\n    writeFileSync(outPath, packToJSON(doc))\n    process.stdout.write(`flatc: ${basename(outPath)} ✓  preview of \"${symbol.name}\" · ${doc.width}×${doc.height} · play it in the browser player\\n`)\n    code = 0\n  }\n  if (!symbolName && others.length) process.stderr.write(`flatc: previewed \"${symbol.name}\"; other symbols in this lib: ${others.join(', ')} (pick with --symbol <name>)\\n`)\n  return code\n}\n\nexport function run(argv: string[]): number | Promise<number> {\n  const args = argv.slice(2)\n  let out = '', scriptPath = '', symbolName = ''\n  let checkOnly = false, doWatch = false, doPlay = false, doRender = false, doTrace = false, doPreview = false\n  let frame = 0, scale = 2, steps = 0, pad = 24\n  let assetMode: AssetMode = 'inline'\n  const vars: Record<string, number> = {}\n  const positional: string[] = []\n  for (let i = 0; i < args.length; i++) {\n    const a = args[i]\n    if (a === '-o' || a === '--out') out = args[++i] ?? ''\n    else if (a === '--script') scriptPath = resolve(args[++i] ?? '')\n    else if (a === '--assets') assetMode = args[++i] === 'external' ? 'external' : 'inline'\n    else if (a === '--check') checkOnly = true\n    else if (a === '--watch') doWatch = true\n    else if (a === '--play') doPlay = true\n    else if (a === '--trace') doTrace = true\n    else if (a === '--render') doRender = true\n    else if (a === '--preview') doPreview = true\n    else if (a === '--symbol') symbolName = args[++i] ?? ''\n    else if (a === '--pad') pad = Math.max(0, Number(args[++i] ?? '24') || 0)\n    else if (a === '--frame') frame = Number(args[++i] ?? '0') || 0\n    else if (a === '--steps') steps = Math.max(0, Number(args[++i] ?? '0') || 0)\n    else if (a === '--scale') scale = Number(args[++i] ?? '2') || 2\n    else if (a === '--at') parseVars(args[++i] ?? '', vars)\n    else if (a === '-h' || a === '--help') { printHelp(); return 0 }\n    else positional.push(a)\n  }\n  if (!positional.length) { printHelp(); return 1 }\n\n  const filePath = resolve(positional[0])\n  if (!existsSync(filePath)) { process.stderr.write(`flatc: not found: ${filePath}\\n`); return 1 }\n\n  const explicitFlats = positional.slice(1)\n  if (doPreview) return previewOnce(filePath, symbolName, out, frame, vars, scale, steps, doRender, pad)\n  if (doRender) return renderOnce(filePath, out, frame, vars, scale, steps)\n  if (doPlay) return playOnce(filePath, scriptPath, doTrace)\n  if (doWatch) {\n    const code = compileOnce(filePath, explicitFlats, out, checkOnly, assetMode)\n    const baseDir = dirname(filePath)\n    let timer: ReturnType<typeof setTimeout> | undefined\n    // We ignore changes to the OUTPUT (.flatpack) — otherwise writing it would re-trigger the compile in a loop.\n    watch(baseDir, { recursive: false }, (_e, filename) => {\n      if (filename && (filename.endsWith('.flatpack') || filename.endsWith('.flatpack.json'))) return\n      clearTimeout(timer); timer = setTimeout(() => compileOnce(filePath, explicitFlats, out, checkOnly, assetMode), 80)\n    })\n    process.stdout.write(`flatc: watching ${baseDir} … (Ctrl+C to stop)\\n`)\n    return code\n  }\n  return compileOnce(filePath, explicitFlats, out, checkOnly, assetMode)\n}\n"],"mappings":"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","names":["f"]}

package/dist/cli/flatc.js

@@ -1,6 +1,6 @@
 import {
   run
-} from "../chunk-F3X2F6QC.js";
+} from "../chunk-EHUP3IKN.js";
 import "../chunk-UADRVB63.js";
 import "../chunk-TPDP5FDF.js";
 export {

package/dist/cli/render.js

@@ -24,7 +24,8 @@ function registerFonts(doc, FontLibrary) {
     const file = join(dir, a.id.replace(/[^\w.-]/g, "_") + ext);
     try {
       writeFileSync(file, Buffer.from(b64, "base64"));
-      for (const f of FontLibrary.use([file])) if (!families.includes(f.family)) families.push(f.family);
+      const used = a.family ? FontLibrary.use(a.family, [file]) : FontLibrary.use([file]);
+      for (const f of used) if (!families.includes(f.family)) families.push(f.family);
     } catch (e) {
       process.stderr.write(`flatc: skipped font asset "${a.id}" (${a.mime}): ${e.message}
 `);

package/dist/cli/render.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/render.ts"],"sourcesContent":["// -----------------------------------------------------------------------------\n//  render.ts -- HEADLESS PNG rendering of a Doc (skia-canvas backend), for `flatc --render`.\n//\n//  Gives agents/CI an IMAGE of what they author (the \"blind positioning\" safeguard). We replay the\n//  real `FlatPlayer` on a skia canvas: same paths, gradients, filters (glow/shadow via `ctx.filter`)\n//  and SVG as the browser. skia-canvas is loaded through a DYNAMIC import with a NON-LITERAL specifier,\n//  so it is never part of the public build graph -- install it on demand only when `--render` is used.\n// -----------------------------------------------------------------------------\nimport { FlatPlayer } from '@flatkit/player'\nimport type { Doc } from '@flatkit/types'\nimport { mkdtempSync, writeFileSync, rmSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type RenderOpts = { frame?: number; vars?: Record<string, number>; scale?: number; steps?: number }\n\n/** Cap on `--steps` (anti-DoS: an untrusted doc must not freeze the render host). One step = 1/60 s of sim. */\nconst MAX_RENDER_STEPS = 10_000\n\n/** Minimal structural view of the `skia-canvas` surface we use. Kept local so the public build needs\n *  no native binary; the real module is resolved at runtime only when `--render` runs. */\ninterface SkiaCanvas {\n  Canvas: new (w: number, h: number) => HTMLCanvasElement & { toBuffer(fmt: string): Promise<Uint8Array> }\n  loadImage: (src: string) => Promise<unknown>\n  Path2D: typeof Path2D\n  /** Global font registry — `use(paths)` reads each file's intrinsic family from its name table. */\n  FontLibrary: { use(fontPaths: readonly string[]): Array<{ family: string }> }\n}\n\n/** Map a font asset's MIME (or its data-URI) to a file extension skia-canvas can parse. */\nconst FONT_EXT: Record<string, string> = {\n  'font/woff2': '.woff2', 'font/woff': '.woff', 'font/ttf': '.ttf', 'font/otf': '.otf',\n  'font/collection': '.ttc', 'application/font-woff': '.woff', 'application/x-font-ttf': '.ttf',\n}\n\n/** Registers every embedded `font` asset with skia's FontLibrary so headless text uses the authored\n *  faces (not host fallbacks). Fonts are baked as base64 data-URIs by flatc; FontLibrary only reads\n *  FILE paths, so we materialize each into a temp dir, register it, and return that dir for cleanup. */\nfunction registerFonts(doc: Doc, FontLibrary: SkiaCanvas['FontLibrary']): { dir: string | null; families: string[] } {\n  const fonts = (doc.assets ?? []).filter((a) => a.kind === 'font' && /^data:/.test(a.data ?? ''))\n  if (fonts.length === 0) return { dir: null, families: [] }\n  const dir = mkdtempSync(join(tmpdir(), 'flatc-fonts-'))\n  const families: string[] = []\n  for (const a of fonts) {\n    const b64 = a.data.slice(a.data.indexOf(',') + 1)\n    const ext = FONT_EXT[a.mime] ?? `.${(a.mime.split('/')[1] || 'ttf').replace(/[^\\w]/g, '')}`\n    const file = join(dir, a.id.replace(/[^\\w.-]/g, '_') + ext)\n    try {\n      writeFileSync(file, Buffer.from(b64, 'base64'))\n      for (const f of FontLibrary.use([file])) if (!families.includes(f.family)) families.push(f.family)\n    } catch (e) {\n      process.stderr.write(`flatc: skipped font asset \"${a.id}\" (${a.mime}): ${(e as Error).message}\\n`)\n    }\n  }\n  return { dir, families }\n}\n\n/** Render `doc` to a PNG (Buffer). `frame` = target image; `vars` = state override (`--at`); `scale` = x-px (default 2). */\nexport async function renderDocToPng(doc: Doc, opts: RenderOpts = {}): Promise<Uint8Array> {\n  // Non-literal specifier: tsc does not resolve it, so skia-canvas is not a build dependency.\n  const skiaPkg: string = 'skia-canvas'\n  let skia: SkiaCanvas\n  try { skia = (await import(skiaPkg)) as unknown as SkiaCanvas }\n  catch {\n    throw new Error(\n      'skia-canvas is required for --render. Install it as a dev dependency: `npm i -D skia-canvas` ' +\n      '(pnpm users: also allow its build script with `pnpm approve-builds` or add \"skia-canvas\" to ' +\n      'pnpm.onlyBuiltDependencies, then reinstall). If the native binary is still missing afterwards, ' +\n      'run `node node_modules/skia-canvas/lib/prebuild.mjs download`.',\n    )\n  }\n  const { Canvas, loadImage, Path2D, FontLibrary } = skia\n  const scale = opts.scale && opts.scale > 0 ? opts.scale : 2\n  const W = doc.width, H = doc.height\n\n  // Register embedded fonts up front so the player's `ctx.font` resolves to the authored faces.\n  const { dir: fontDir, families } = registerFonts(doc, FontLibrary)\n  if (families.length) process.stderr.write(`flatc: registered ${families.length} font famil${families.length > 1 ? 'ies' : 'y'}: ${families.join(', ')}\\n`)\n\n  // Pre-decode the image assets (skia reads SVG/PNG/... from the data-URIs embedded by flatc).\n  const images = new Map<string, CanvasImageSource>()\n  for (const a of doc.assets ?? []) {\n    if (a.kind === 'svg' || a.kind === 'image' || /^data:image\\//.test(a.data ?? '')) {\n      try { images.set(a.id, (await loadImage(a.data)) as unknown as CanvasImageSource) } catch { /* unreadable asset: ignored (placeholder) */ }\n    }\n  }\n\n  // Globals the player/rendering expects under Node (restored on exit).\n  const g = globalThis as Record<string, unknown>\n  const saved: Record<string, unknown> = {}\n  const set = (k: string, v: unknown) => { saved[k] = g[k]; g[k] = v }\n  set('Path2D', Path2D)\n  set('window', { addEventListener() {}, removeEventListener() {}, devicePixelRatio: scale })\n  set('addEventListener', () => {})\n  set('removeEventListener', () => {})\n  set('requestAnimationFrame', () => 0)\n  set('cancelAnimationFrame', () => {})\n  set('document', { createElement: (t: string) => (t === 'canvas' ? new Canvas(1, 1) : {}) }) // off-screen canvas (filters/tint)\n\n  const canvas = new Canvas(Math.max(1, Math.round(W * scale)), Math.max(1, Math.round(H * scale)))\n  const el = canvas as unknown as HTMLCanvasElement & { toBuffer(fmt: string): Promise<Uint8Array> }\n  Object.assign(el, {\n    getBoundingClientRect: () => ({ width: W, height: H, left: 0, top: 0, right: W, bottom: H }),\n    addEventListener: () => {}, removeEventListener: () => {}, style: {},\n  })\n\n  try {\n    const pl = new FlatPlayer(el, doc, { input: false, audio: false, padding: 0, image: (id) => images.get(id) ?? null })\n    if (opts.vars) for (const [k, v] of Object.entries(opts.vars)) pl.setVar(k, v)\n    pl.seek(opts.frame ?? 0) // applies frame + state\n    if (opts.steps && opts.steps > 0) {\n      const n = Math.min(Math.floor(opts.steps), MAX_RENDER_STEPS)\n      if (opts.steps > MAX_RENDER_STEPS) process.stderr.write(`flatc: --steps clamped to ${MAX_RENDER_STEPS} (was ${opts.steps})\\n`)\n      pl.stepSim(n) // run N fixed sim steps (onEnterFrame) so a stateful act unfolds before capture\n    }\n    const png = await el.toBuffer('png')\n    pl.destroy()\n    return png\n  } finally {\n    for (const k in saved) { if (saved[k] === undefined) delete g[k]; else g[k] = saved[k] }\n    // skia keeps the parsed faces in memory after `use()`, so the temp files are safe to drop now.\n    if (fontDir) try { rmSync(fontDir, { recursive: true, force: true }) } catch { /* best-effort cleanup */ }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/cli/render.ts"],"sourcesContent":["// -----------------------------------------------------------------------------\n//  render.ts -- HEADLESS PNG rendering of a Doc (skia-canvas backend), for `flatc --render`.\n//\n//  Gives agents/CI an IMAGE of what they author (the \"blind positioning\" safeguard). We replay the\n//  real `FlatPlayer` on a skia canvas: same paths, gradients, filters (glow/shadow via `ctx.filter`)\n//  and SVG as the browser. skia-canvas is loaded through a DYNAMIC import with a NON-LITERAL specifier,\n//  so it is never part of the public build graph -- install it on demand only when `--render` is used.\n// -----------------------------------------------------------------------------\nimport { FlatPlayer } from '@flatkit/player'\nimport type { Doc } from '@flatkit/types'\nimport { mkdtempSync, writeFileSync, rmSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type RenderOpts = { frame?: number; vars?: Record<string, number>; scale?: number; steps?: number }\n\n/** Cap on `--steps` (anti-DoS: an untrusted doc must not freeze the render host). One step = 1/60 s of sim. */\nconst MAX_RENDER_STEPS = 10_000\n\n/** Minimal structural view of the `skia-canvas` surface we use. Kept local so the public build needs\n *  no native binary; the real module is resolved at runtime only when `--render` runs. */\ninterface SkiaCanvas {\n  Canvas: new (w: number, h: number) => HTMLCanvasElement & { toBuffer(fmt: string): Promise<Uint8Array> }\n  loadImage: (src: string) => Promise<unknown>\n  Path2D: typeof Path2D\n  /** Global font registry. `use(paths)` reads each file's intrinsic name-table family; the 2-arg\n   *  `use(family, paths)` form FORCES that alias (fixes variable-font statics whose name table lies). */\n  FontLibrary: {\n    use(fontPaths: readonly string[]): Array<{ family: string }>\n    use(family: string, fontPaths: readonly string[]): Array<{ family: string }>\n  }\n}\n\n/** Map a font asset's MIME (or its data-URI) to a file extension skia-canvas can parse. */\nconst FONT_EXT: Record<string, string> = {\n  'font/woff2': '.woff2', 'font/woff': '.woff', 'font/ttf': '.ttf', 'font/otf': '.otf',\n  'font/collection': '.ttc', 'application/font-woff': '.woff', 'application/x-font-ttf': '.ttf',\n}\n\n/** Registers every embedded `font` asset with skia's FontLibrary so headless text uses the authored\n *  faces (not host fallbacks). Fonts are baked as base64 data-URIs by flatc; FontLibrary only reads\n *  FILE paths, so we materialize each into a temp dir, register it, and return that dir for cleanup. */\nfunction registerFonts(doc: Doc, FontLibrary: SkiaCanvas['FontLibrary']): { dir: string | null; families: string[] } {\n  const fonts = (doc.assets ?? []).filter((a) => a.kind === 'font' && /^data:/.test(a.data ?? ''))\n  if (fonts.length === 0) return { dir: null, families: [] }\n  const dir = mkdtempSync(join(tmpdir(), 'flatc-fonts-'))\n  const families: string[] = []\n  for (const a of fonts) {\n    const b64 = a.data.slice(a.data.indexOf(',') + 1)\n    const ext = FONT_EXT[a.mime] ?? `.${(a.mime.split('/')[1] || 'ttf').replace(/[^\\w]/g, '')}`\n    const file = join(dir, a.id.replace(/[^\\w.-]/g, '_') + ext)\n    try {\n      writeFileSync(file, Buffer.from(b64, 'base64'))\n      // `family` alias (from `asset … font \"Name\"`) forces the registered name, so the face matches the\n      // text's `font \"Name\"` even when the file's own name table is wrong (variable-font static export).\n      const used = a.family ? FontLibrary.use(a.family, [file]) : FontLibrary.use([file])\n      for (const f of used) if (!families.includes(f.family)) families.push(f.family)\n    } catch (e) {\n      process.stderr.write(`flatc: skipped font asset \"${a.id}\" (${a.mime}): ${(e as Error).message}\\n`)\n    }\n  }\n  return { dir, families }\n}\n\n/** Render `doc` to a PNG (Buffer). `frame` = target image; `vars` = state override (`--at`); `scale` = x-px (default 2). */\nexport async function renderDocToPng(doc: Doc, opts: RenderOpts = {}): Promise<Uint8Array> {\n  // Non-literal specifier: tsc does not resolve it, so skia-canvas is not a build dependency.\n  const skiaPkg: string = 'skia-canvas'\n  let skia: SkiaCanvas\n  try { skia = (await import(skiaPkg)) as unknown as SkiaCanvas }\n  catch {\n    throw new Error(\n      'skia-canvas is required for --render. Install it as a dev dependency: `npm i -D skia-canvas` ' +\n      '(pnpm users: also allow its build script with `pnpm approve-builds` or add \"skia-canvas\" to ' +\n      'pnpm.onlyBuiltDependencies, then reinstall). If the native binary is still missing afterwards, ' +\n      'run `node node_modules/skia-canvas/lib/prebuild.mjs download`.',\n    )\n  }\n  const { Canvas, loadImage, Path2D, FontLibrary } = skia\n  const scale = opts.scale && opts.scale > 0 ? opts.scale : 2\n  const W = doc.width, H = doc.height\n\n  // Register embedded fonts up front so the player's `ctx.font` resolves to the authored faces.\n  const { dir: fontDir, families } = registerFonts(doc, FontLibrary)\n  if (families.length) process.stderr.write(`flatc: registered ${families.length} font famil${families.length > 1 ? 'ies' : 'y'}: ${families.join(', ')}\\n`)\n\n  // Pre-decode the image assets (skia reads SVG/PNG/... from the data-URIs embedded by flatc).\n  const images = new Map<string, CanvasImageSource>()\n  for (const a of doc.assets ?? []) {\n    if (a.kind === 'svg' || a.kind === 'image' || /^data:image\\//.test(a.data ?? '')) {\n      try { images.set(a.id, (await loadImage(a.data)) as unknown as CanvasImageSource) } catch { /* unreadable asset: ignored (placeholder) */ }\n    }\n  }\n\n  // Globals the player/rendering expects under Node (restored on exit).\n  const g = globalThis as Record<string, unknown>\n  const saved: Record<string, unknown> = {}\n  const set = (k: string, v: unknown) => { saved[k] = g[k]; g[k] = v }\n  set('Path2D', Path2D)\n  set('window', { addEventListener() {}, removeEventListener() {}, devicePixelRatio: scale })\n  set('addEventListener', () => {})\n  set('removeEventListener', () => {})\n  set('requestAnimationFrame', () => 0)\n  set('cancelAnimationFrame', () => {})\n  set('document', { createElement: (t: string) => (t === 'canvas' ? new Canvas(1, 1) : {}) }) // off-screen canvas (filters/tint)\n\n  const canvas = new Canvas(Math.max(1, Math.round(W * scale)), Math.max(1, Math.round(H * scale)))\n  const el = canvas as unknown as HTMLCanvasElement & { toBuffer(fmt: string): Promise<Uint8Array> }\n  Object.assign(el, {\n    getBoundingClientRect: () => ({ width: W, height: H, left: 0, top: 0, right: W, bottom: H }),\n    addEventListener: () => {}, removeEventListener: () => {}, style: {},\n  })\n\n  try {\n    const pl = new FlatPlayer(el, doc, { input: false, audio: false, padding: 0, image: (id) => images.get(id) ?? null })\n    if (opts.vars) for (const [k, v] of Object.entries(opts.vars)) pl.setVar(k, v)\n    pl.seek(opts.frame ?? 0) // applies frame + state\n    if (opts.steps && opts.steps > 0) {\n      const n = Math.min(Math.floor(opts.steps), MAX_RENDER_STEPS)\n      if (opts.steps > MAX_RENDER_STEPS) process.stderr.write(`flatc: --steps clamped to ${MAX_RENDER_STEPS} (was ${opts.steps})\\n`)\n      pl.stepSim(n) // run N fixed sim steps (onEnterFrame) so a stateful act unfolds before capture\n    }\n    const png = await el.toBuffer('png')\n    pl.destroy()\n    return png\n  } finally {\n    for (const k in saved) { if (saved[k] === undefined) delete g[k]; else g[k] = saved[k] }\n    // skia keeps the parsed faces in memory after `use()`, so the temp files are safe to drop now.\n    if (fontDir) try { rmSync(fontDir, { recursive: true, force: true }) } catch { /* best-effort cleanup */ }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   run
-} from "./chunk-F3X2F6QC.js";
+} from "./chunk-EHUP3IKN.js";
 import {
   allScopeVariables,
   docHasErrors,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flatkit/compiler",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "The FlatInk language (parser + AST) and compiler (.flatink → .flatpack). Ships the flatc CLI.",
   "license": "MIT",
   "author": "Zwyk Studio",
@@ -45,9 +45,9 @@
     "bin"
   ],
   "dependencies": {
-    "@flatkit/player": "0.3.0",
-    "@flatkit/engine": "0.3.0",
-    "@flatkit/types": "0.3.0"
+    "@flatkit/engine": "0.5.0",
+    "@flatkit/types": "0.5.0",
+    "@flatkit/player": "0.5.0"
   },
   "peerDependencies": {
     "skia-canvas": "^3.0.8"

package/dist/chunk-F3X2F6QC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/flatc.ts"],"sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n//  flatc — the \"modern SWF\" command-line compiler.\n//\n//  The VSCode-first flow: you write a `.flatink` program (composition + logic, DSL)\n//  + `.flat` asset libs (visuals, exported by the editor) + media, then:\n//\n//      flatc game.flatink hero.flat decor.flat -o game.flatpack\n//\n//  → a single `.flatpack` (the baked Doc as JSON) that the player runs. Media referenced\n//  by `asset \"id\" \"path\" kind` are EMBEDDED (paths relative to the program).\n// ─────────────────────────────────────────────────────────────────────────────\nimport { readFileSync, writeFileSync, existsSync, readdirSync, watch, mkdirSync, copyFileSync } from 'node:fs'\nimport { resolve, dirname, basename, extname, join, relative, isAbsolute } from 'node:path'\nimport { compileFlatpack, packToJSON, type MediaMap } from '../compile'\nimport { parseProgramFull } from '@flatkit/engine/flatFormat'\nimport { hasPackage } from '@flatkit/engine/stdlib'\nimport { parseUnits } from '@flatkit/engine/dsl'\nimport { sanitizeDoc } from '@flatkit/engine/validateDoc'\nimport { unitsToFunctions } from '@flatkit/engine/scriptDoc'\nimport { lintDocReport, docHasErrors } from '../programDoc'\nimport { playHeadless, type Gesture } from '@flatkit/player/debug'\nimport type { FuncDef } from '@flatkit/engine/actions'\nimport type { Doc } from '@flatkit/types'\n\nconst MIME: Record<string, string> = {\n  '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif',\n  '.webp': 'image/webp', '.svg': 'image/svg+xml', '.avif': 'image/avif',\n  '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.ogg': 'audio/ogg', '.m4a': 'audio/mp4',\n  // Fonts (RFC 8081 media types) — matches the editor's import (`font/woff2` default, FontFace API).\n  '.woff2': 'font/woff2', '.woff': 'font/woff', '.ttf': 'font/ttf', '.otf': 'font/otf',\n  // NB: video (.mp4/.webm/…) intentionally omitted — no video runtime in the editor or player yet.\n}\nconst mimeFor = (path: string): string => MIME[extname(path).toLowerCase()] ?? 'application/octet-stream'\n\n/**\n * True if `target` resolves to a file inside `baseDir` (or baseDir itself). Guards against a hostile\n * program escaping its folder via `../` in a media path or a `use` package name — compiling an untrusted\n * `.flatink` must never read (and embed) arbitrary host files.\n */\nfunction isWithin(baseDir: string, target: string): boolean {\n  const rel = relative(baseDir, target)\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel))\n}\n\nfunction printHelp(): void {\n  process.stdout.write(`flatc — compile a FlatInk program into a .flatpack\n\nUsage:\n  flatc <program.flatink> [assets.flat …] [-o output.flatpack]\n  flatc <program.flatink> --watch\n  flatc --play <program.flatink | scene.flatpack> --script <gestures.json>\n  flatc --render <program.flatink | scene.flatpack> -o out.png [--frame N] [--at k=v[,k2=v2]] [--scale S]\n\n  program.flatink   the program (composition + logic, text DSL)\n  assets.flat       visual asset libs (default: every .flat in the program's folder)\n  -o, --out         output file (default: <program>.flatpack — the CANONICAL name, JSON inside)\n  --assets MODE     media baking: 'inline' (default, base64 in the .flatpack) or 'external'\n                    (sidecar <out>.assets/ folder; asset.data = relative key — serve the folder and\n                    play with sameOriginAssetResolver(<flatpackUrl>))\n  --check           semantic lint only (no .flatpack); exits ≠0 on ERROR (warnings do not stop)\n  --watch           recompile on every change in the folder (agent → player loop)\n  --play            run the file WITHOUT a canvas, replay --script and print { sends, vars } (JSON)\n  --trace           (with --play) HUMAN-READABLE log per gesture: emitted sends + variable diff (debug)\n  --script <f>      JSON gesture script: [{ \"type\": \"down|move|up|cancel\", \"x\", \"y\" }, { \"type\": \"set\", \"name\", \"value\" }, { \"type\": \"wait\", \"frames\": N }]\n                    semantic (by NAME, the engine resolves coords): { \"type\": \"drag\", \"source\", \"target\" } · { \"type\": \"tap\", \"target\" }\n                    · { \"type\": \"scratch\", \"target\" } (sweeps a reveal zone) · { \"type\": \"connect\", \"source\", \"target\" } (pulls a link wire)\n                    \"wait\" lets the simulation run N fixed steps (60 Hz): \"every frame\" + playhead advance like in real playback\n                    \"expect\" self-verifies: { \"type\": \"expect\", \"sends\": [\"done\"], \"vars\": { \"score\": 3 } } → exits ≠0 on mismatch\n                    (sends = sequence of names emitted SINCE the last expect; vars = current state). Great in CI.\n  --render          render a PNG IMAGE (headless skia): see what we draw (positioning)\n  --frame N         (with --render) target frame (default 0)\n  --at k=v[,k2=v2]  (with --render) force variables → capture a given state (e.g. a step of an escape)\n  --steps N         (with --render) run N fixed sim steps (60 Hz, every-frame) BEFORE capture → see a\n                    stateful act unfold without forcing every derived variable by hand in --at\n  --scale S         (with --render) resolution factor (default 2)\n  -h, --help        this help\n\nMedia referenced by 'asset \"id\" \"path\" kind' are embedded (paths relative to the program).\n`)\n}\n\n/** How media is baked: `inline` = base64 data-URI in the .flatpack; `external` = relative key + sidecar files. */\ntype AssetMode = 'inline' | 'external'\ntype MediaCopy = { src: string; key: string } // external mode: source file → relative key (forward slashes)\ntype BuildResult = { doc: Doc; flatLibs: number; packages: number; media: number; mediaCopies: MediaCopy[] }\n\n/**\n * Reads a `.flatink`, resolves libs/packages/media, compiles → standalone Doc. Throws on compile error.\n * `assetMode`: `inline` embeds each media as a base64 data-URI (default); `external` keeps `asset.data` as a\n * relative key (`<assetsDir>/<path>`) and returns the files to copy beside the .flatpack (no base64 bloat).\n */\nfunction buildDocFromProgram(programPath: string, explicitFlats: string[] = [], assetMode: AssetMode = 'inline', assetsDir = ''): BuildResult {\n  const baseDir = dirname(programPath)\n  const programSrc = readFileSync(programPath, 'utf8')\n  const prog = parseProgramFull(programSrc)\n\n  // .flat libs: explicit if provided, otherwise auto-discover the .flat files in the program's folder.\n  const flatPaths = new Set<string>(explicitFlats.map((p) => resolve(p)))\n  if (!flatPaths.size) for (const f of readdirSync(baseDir).filter((f) => f.endsWith('.flat'))) flatPaths.add(join(baseDir, f))\n\n  // PACKAGES: non-stdlib `use \"x\"` → local files inlined (x.flatink = functions, x.flat = symbols).\n  const pkgFunctions: FuncDef[] = []\n  const localResolved = new Set<string>()\n  for (const name of prog.imports ?? []) {\n    if (hasPackage(name)) continue // stdlib → left as a reference\n    const fink = join(baseDir, name + '.flatink')\n    const fflat = join(baseDir, name + '.flat')\n    if (!isWithin(baseDir, fink) || !isWithin(baseDir, fflat)) { process.stderr.write(`flatc: package outside the program folder (ignored): \"${name}\"\\n`); continue }\n    let found = false\n    if (existsSync(fink)) { for (const f of unitsToFunctions(parseUnits(readFileSync(fink, 'utf8')).units)) pkgFunctions.push(f, { ...f, name: `${name}.${f.name}` }); found = true }\n    if (existsSync(fflat)) { flatPaths.add(fflat); found = true }\n    if (found) localResolved.add(name)\n    else process.stderr.write(`flatc: package not found: \"${name}\" (neither stdlib, nor ${name}.flatink / ${name}.flat)\\n`)\n  }\n  const assetSrcs = [...flatPaths].map((p) => readFileSync(p, 'utf8'))\n\n  // Media: each `asset … \"path\" …` resolved relative to the program. `inline` → base64 data-URI baked in;\n  // `external` → `asset.data` becomes a relative key and the file is copied next to the .flatpack.\n  const media: MediaMap = {}\n  const mediaCopies: MediaCopy[] = []\n  for (const a of prog.assets ?? []) {\n    const mp = resolve(baseDir, a.data)\n    if (!isWithin(baseDir, mp)) { process.stderr.write(`flatc: media outside the program folder (ignored): ${a.data}\\n`); continue }\n    if (!existsSync(mp)) { process.stderr.write(`flatc: missing media (ignored): ${a.data}\\n`); continue }\n    const mime = mimeFor(mp)\n    if (assetMode === 'external') {\n      const key = `${assetsDir}/${a.data.replace(/\\\\/g, '/')}` // URL-form relative key (resolved by the host)\n      media[a.data] = { mime, data: key }\n      mediaCopies.push({ src: mp, key })\n    } else {\n      media[a.data] = { mime, data: `data:${mime};base64,${readFileSync(mp).toString('base64')}` }\n    }\n  }\n\n  let doc = compileFlatpack(programSrc, assetSrcs, media)\n  if (pkgFunctions.length) doc = { ...doc, functions: [...(doc.functions ?? []), ...pkgFunctions] }\n  const stdImports = (doc.imports ?? []).filter(hasPackage)\n  doc = { ...doc, imports: stdImports.length ? stdImports : undefined }\n  return { doc, flatLibs: flatPaths.size, packages: localResolved.size, media: Object.keys(media).length, mediaCopies }\n}\n\n/** Compile once (write or --check). Returns the exit code. */\nfunction compileOnce(programPath: string, explicitFlats: string[], out: string, checkOnly: boolean, assetMode: AssetMode = 'inline'): number {\n  const outPath = out ? resolve(out) : join(dirname(programPath), basename(programPath, extname(programPath)) + '.flatpack')\n  // External mode: sidecar folder next to the .flatpack, e.g. `game.flatpack` → `game.assets/`.\n  const assetsDir = assetMode === 'external' ? basename(outPath, extname(outPath)) + '.assets' : ''\n  let built: BuildResult\n  try { built = buildDocFromProgram(programPath, explicitFlats, assetMode, assetsDir) }\n  catch (e) { process.stderr.write(`flatc: compile error: ${(e as Error).message}\\n`); return 1 }\n  const { doc } = built\n  const report = lintDocReport(doc)\n  if (checkOnly) {\n    if (report) process.stderr.write(report + '\\n')\n    if (docHasErrors(doc)) return 1\n    process.stdout.write('flatc: no errors ✓\\n')\n    return 0\n  }\n  if (report) process.stderr.write(report + '\\n') // compile anyway: diagnostics as warnings\n  writeFileSync(outPath, packToJSON(doc))\n  const outDir = dirname(outPath)\n  for (const c of built.mediaCopies) {\n    const dest = join(outDir, ...c.key.split('/'))\n    if (!isWithin(outDir, dest)) continue // defensive: never write outside the output folder\n    mkdirSync(dirname(dest), { recursive: true })\n    copyFileSync(c.src, dest)\n  }\n  const where = assetMode === 'external' ? ` (external → ${assetsDir}/)` : ''\n  process.stdout.write(`flatc: ${basename(outPath)} ✓  ${doc.symbols.length} symbol(s) · ${built.flatLibs} lib(s) · ${built.packages} package(s) · ${built.media} media${where}\\n`)\n  return 0\n}\n\n/** Loads a Doc from a `.flatink` (compiled) or a `.flatpack`/`.flatpack.json` (already-baked JSON). */\nfunction loadDoc(filePath: string): Doc {\n  if (filePath.endsWith('.flatink')) return buildDocFromProgram(filePath).doc\n  // .flatpack (canonical) or .flatpack.json (alias): untrusted JSON → normalize before use.\n  return sanitizeDoc(JSON.parse(readFileSync(filePath, 'utf8')))\n}\n\n/** --play: runs the file headless, replays --script, prints { sends, vars }. */\nfunction playOnce(filePath: string, scriptPath: string, trace: boolean): number {\n  if (!scriptPath) { process.stderr.write('flatc: --play requires --script <gestures.json>\\n'); return 1 }\n  if (!existsSync(scriptPath)) { process.stderr.write(`flatc: script not found: ${scriptPath}\\n`); return 1 }\n  let doc: Doc, gestures: Gesture[]\n  try { doc = loadDoc(filePath) } catch (e) { process.stderr.write(`flatc: cannot read: ${(e as Error).message}\\n`); return 1 }\n  try { gestures = JSON.parse(readFileSync(scriptPath, 'utf8')) as Gesture[] } catch (e) { process.stderr.write(`flatc: invalid JSON script: ${(e as Error).message}\\n`); return 1 }\n  if (!Array.isArray(gestures)) { process.stderr.write('flatc: the script must be an array of gestures\\n'); return 1 }\n  const res = playHeadless(doc, gestures, { trace })\n  if (!trace) process.stdout.write(JSON.stringify(res, null, 2) + '\\n')\n  else // --trace: readable log (one gesture per line) → inspection / debug-player.\n    for (const s of res.steps ?? []) {\n      const sends = s.sends.length ? '  sends:[' + s.sends.map((e) => (e.value !== undefined ? `${e.name}=${e.value}` : e.name)).join(', ') + ']' : ''\n      const vars = Object.entries(s.changed).map(([k, [a, b]]) => `${k}:${JSON.stringify(a)}→${JSON.stringify(b)}`)\n      process.stdout.write(`${s.gesture.padEnd(28)}${sends}${vars.length ? '  vars{' + vars.join(' ') + '}' : ''}\\n`)\n    }\n  // `expect`: any detected mismatch → stderr log + exit code ≠0 (CI self-verification).\n  if (res.expectFailures?.length) {\n    for (const f of res.expectFailures) process.stderr.write(`flatc: ✗ ${f}\\n`)\n    return 1\n  }\n  return 0\n}\n\n/** Parses `--at`: \"k=v[,k2=v2]\" → variable table (state override for rendering). */\nfunction parseVars(spec: string, into: Record<string, number>): void {\n  for (const pair of spec.split(',')) {\n    const i = pair.indexOf('=')\n    if (i < 0) continue\n    const k = pair.slice(0, i).trim(); const v = Number(pair.slice(i + 1).trim())\n    if (k && Number.isFinite(v)) into[k] = v\n  }\n}\n\n/** --render: renders the file to PNG (headless skia). Async (SVG decode + raster). */\nasync function renderOnce(filePath: string, out: string, frame: number, vars: Record<string, number>, scale: number, steps: number): Promise<number> {\n  let doc: Doc\n  try { doc = loadDoc(filePath) } catch (e) { process.stderr.write(`flatc: cannot read: ${(e as Error).message}\\n`); return 1 }\n  const outPath = out ? resolve(out) : join(dirname(filePath), basename(filePath, extname(filePath)) + '.png')\n  try {\n    const { renderDocToPng } = await import('./render')\n    const png = await renderDocToPng(doc, { frame, vars: Object.keys(vars).length ? vars : undefined, scale, steps: steps || undefined })\n    writeFileSync(outPath, png)\n  } catch (e) { process.stderr.write(`flatc: render failed: ${(e as Error).message}\\n`); return 1 }\n  process.stdout.write(`flatc: ${basename(outPath)} ✓  ${doc.width}×${doc.height} ×${scale}${frame ? ` · frame ${frame}` : ''}${steps ? ` · ${steps} step(s)` : ''}${Object.keys(vars).length ? ` · ${Object.entries(vars).map(([k, v]) => `${k}=${v}`).join(' ')}` : ''}\\n`)\n  return 0\n}\n\nexport function run(argv: string[]): number | Promise<number> {\n  const args = argv.slice(2)\n  let out = '', scriptPath = ''\n  let checkOnly = false, doWatch = false, doPlay = false, doRender = false, doTrace = false\n  let frame = 0, scale = 2, steps = 0\n  let assetMode: AssetMode = 'inline'\n  const vars: Record<string, number> = {}\n  const positional: string[] = []\n  for (let i = 0; i < args.length; i++) {\n    const a = args[i]\n    if (a === '-o' || a === '--out') out = args[++i] ?? ''\n    else if (a === '--script') scriptPath = resolve(args[++i] ?? '')\n    else if (a === '--assets') assetMode = args[++i] === 'external' ? 'external' : 'inline'\n    else if (a === '--check') checkOnly = true\n    else if (a === '--watch') doWatch = true\n    else if (a === '--play') doPlay = true\n    else if (a === '--trace') doTrace = true\n    else if (a === '--render') doRender = true\n    else if (a === '--frame') frame = Number(args[++i] ?? '0') || 0\n    else if (a === '--steps') steps = Math.max(0, Number(args[++i] ?? '0') || 0)\n    else if (a === '--scale') scale = Number(args[++i] ?? '2') || 2\n    else if (a === '--at') parseVars(args[++i] ?? '', vars)\n    else if (a === '-h' || a === '--help') { printHelp(); return 0 }\n    else positional.push(a)\n  }\n  if (!positional.length) { printHelp(); return 1 }\n\n  const filePath = resolve(positional[0])\n  if (!existsSync(filePath)) { process.stderr.write(`flatc: not found: ${filePath}\\n`); return 1 }\n\n  const explicitFlats = positional.slice(1)\n  if (doRender) return renderOnce(filePath, out, frame, vars, scale, steps)\n  if (doPlay) return playOnce(filePath, scriptPath, doTrace)\n  if (doWatch) {\n    const code = compileOnce(filePath, explicitFlats, out, checkOnly, assetMode)\n    const baseDir = dirname(filePath)\n    let timer: ReturnType<typeof setTimeout> | undefined\n    // We ignore changes to the OUTPUT (.flatpack) — otherwise writing it would re-trigger the compile in a loop.\n    watch(baseDir, { recursive: false }, (_e, filename) => {\n      if (filename && (filename.endsWith('.flatpack') || filename.endsWith('.flatpack.json'))) return\n      clearTimeout(timer); timer = setTimeout(() => compileOnce(filePath, explicitFlats, out, checkOnly, assetMode), 80)\n    })\n    process.stdout.write(`flatc: watching ${baseDir} … (Ctrl+C to stop)\\n`)\n    return code\n  }\n  return compileOnce(filePath, explicitFlats, out, checkOnly, assetMode)\n}\n"],"mappings":"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","names":["f"]}