@flatkit/compiler 0.19.10 → 0.19.12

package/README.md

@@ -0,0 +1,34 @@
+# @flatkit/compiler
+
+The [FlatInk](http://flatink.zwyk-studio.com/) language (parser + AST) and compiler: turn readable
+`.flatink` text into a single self-contained `.flatpack`. Ships the **`flatc`** CLI. Lives in build/CLI
+tooling — the [player](https://www.npmjs.com/package/@flatkit/player) stays tiny and never pulls it in.
+
+## Install
+
+```sh
+pnpm add -D @flatkit/compiler
+```
+
+## CLI
+
+```sh
+flatc scene.flatink -o scene.flatpack             # text sources -> one playable file
+flatc scene.flatink --render -o frame.png          # headless PNG preview
+flatc scene.flatink --play --script gestures.json  # headless replay + assertions (CI)
+```
+
+## Programmatic
+
+```ts
+import { compileFlatpack } from '@flatkit/compiler/compile'
+
+const doc = compileFlatpack(programSrc, assetSrcs, media) // -> Doc (the .flatpack)
+```
+
+Static analysis (lint, manifest, LLM context) lives under `@flatkit/compiler/analysis`.
+
+## License
+
+[MIT](https://github.com/flatink/flatkit/blob/main/LICENSE) (c) Zwyk Studio — part of
+[flatkit](https://github.com/flatink/flatkit).

package/dist/{chunk-2NAWPQKH.js → chunk-DETQTCBJ.js}

@@ -5,7 +5,7 @@ import {
 import {
   compileFlatpack,
   packToJSON
-} from "./chunk-TPDP5FDF.js";
+} from "./chunk-KXKX2RMX.js";
 
 // src/cli/flatc.ts
 import { readFileSync, writeFileSync, existsSync, readdirSync, watch, mkdirSync, copyFileSync } from "fs";
@@ -492,4 +492,4 @@ function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=chunk-2NAWPQKH.js.map
+//# sourceMappingURL=chunk-DETQTCBJ.js.map

package/dist/{chunk-TPDP5FDF.js → chunk-KXKX2RMX.js}

@@ -20,7 +20,8 @@ function compileFlatpack(programSrc, assetSrcs = [], media = {}) {
   resolveRefs(prog.layers, byName);
   const assets = (prog.assets ?? []).map((a) => {
     const m = media[a.data];
-    return m ? { ...a, mime: m.mime, data: m.data } : a;
+    const r = m ? { ...a, mime: m.mime, data: m.data } : a;
+    return r.kind === "font" && !r.family ? { ...r, family: r.id } : r;
   });
   return {
     width: prog.width,
@@ -44,4 +45,4 @@ export {
   compileFlatpack,
   packToJSON
 };
-//# sourceMappingURL=chunk-TPDP5FDF.js.map
+//# sourceMappingURL=chunk-KXKX2RMX.js.map

package/dist/chunk-KXKX2RMX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compile.ts"],"sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n//  compile.ts — the \"modern SWF\" compiler (RFC, step P2).\n//\n//  Takes the PROGRAM (`.flatink`) + the ASSETS (`.flat`) and produces a resolved `Doc` —\n//  the \".flatpack\" v1 (= the baked doc the player already plays). Steps:\n//    1. parse the assets → symbols;\n//    2. parse the program → composition + behavior (`@Name` refs);\n//    3. RESOLVE refs by name (instances → symbol id), across ALL libs;\n//    4. assemble the Doc.\n//\n//  v1: no binary optimization nor media embedding (P2b). Pure, no DOM.\n// ─────────────────────────────────────────────────────────────────────────────\nimport type { Doc, Item, Layer } from '@flatkit/types'\nimport { parseFlatLib, parseProgramFull } from '@flatkit/engine/flatFormat'\nimport { isGroup, isInstance } from '@flatkit/engine/layers'\n\n/** Resolves `symbolId: '@Name'` instances into real ids (recursive, across groups). */\nfunction resolveRefs(layers: Layer[], byName: Map<string, string>): void {\n  const walk = (items: Item[]) => {\n    for (const it of items) {\n      if (isInstance(it) && it.symbolId.startsWith('@')) it.symbolId = byName.get(it.symbolId.slice(1)) ?? it.symbolId\n      if (isGroup(it)) it.layers.forEach((l) => walk(l.items))\n    }\n  }\n  layers.forEach((l) => walk(l.items))\n}\n\n/** Source of a media (base64 data-URI) by declared path (`asset … \"path\" …`). */\nexport type MediaMap = Record<string, { mime: string; data: string }>\n\n/**\n * Compile a `.flatink` program + its `.flat` assets → playable `Doc` (the \".flatpack\").\n * `assetSrcs` = the text of each `.flat` lib. `media` = the content of the referenced media files\n * (by path). Symbol refs (by name) are resolved across the whole set of libs; declared media\n * are EMBEDDED (path → data-URI).\n */\nexport function compileFlatpack(programSrc: string, assetSrcs: string[] = [], media: MediaMap = {}): Doc {\n  const libs = assetSrcs.map((src) => parseFlatLib(src))\n  const symbols = libs.flatMap((l) => l.symbols)\n  const folders = libs.flatMap((l) => l.folders) // library folders (organization)\n  const prog = parseProgramFull(programSrc)\n  const byName = new Map(symbols.map((s) => [s.name, s.id]))\n  symbols.forEach((s) => resolveRefs(s.layers, byName)) // cross-lib refs\n  resolveRefs(prog.layers, byName) // program refs\n\n  // Embed declared media (data = path → provided data-URI). Missing = left as is.\n  const assets = (prog.assets ?? []).map((a) => {\n    const m = media[a.data]\n    const r = m ? { ...a, mime: m.mime, data: m.data } : a\n    // A font without an explicit family defaults to its declared id — which is exactly what text targets via\n    // `font \"<id>\"`. Gives consumers an explicit `family` instead of relying on a `family || id` fallback.\n    return r.kind === 'font' && !r.family ? { ...r, family: r.id } : r\n  })\n\n  return {\n    width: prog.width,\n    height: prog.height,\n    ...(prog.background ? { background: prog.background } : {}),\n    symbols,\n    ...(folders.length ? { folders } : {}),\n    layers: prog.layers,\n    ...(prog.variables && Object.keys(prog.variables).length ? { variables: prog.variables } : {}),\n    ...(prog.imports?.length ? { imports: prog.imports } : {}),\n    ...(prog.functions?.length ? { functions: prog.functions } : {}),\n    timeline: prog.timeline ?? { fps: 24, durationFrames: 60, tracks: [] },\n    ...(prog.interactions?.length ? { interactions: prog.interactions } : {}),\n    ...(prog.interactors?.length ? { interactors: prog.interactors } : {}),\n    ...(assets.length ? { assets } : {}),\n  }\n}\n\n/** Serialize the `.flatpack` v1 (JSON of the compiled Doc). */\nexport const packToJSON = (doc: Doc): string => JSON.stringify(doc)\n"],"mappings":";AAaA,SAAS,cAAc,wBAAwB;AAC/C,SAAS,SAAS,kBAAkB;AAGpC,SAAS,YAAY,QAAiB,QAAmC;AACvE,QAAM,OAAO,CAAC,UAAkB;AAC9B,eAAW,MAAM,OAAO;AACtB,UAAI,WAAW,EAAE,KAAK,GAAG,SAAS,WAAW,GAAG,EAAG,IAAG,WAAW,OAAO,IAAI,GAAG,SAAS,MAAM,CAAC,CAAC,KAAK,GAAG;AACxG,UAAI,QAAQ,EAAE,EAAG,IAAG,OAAO,QAAQ,CAAC,MAAM,KAAK,EAAE,KAAK,CAAC;AAAA,IACzD;AAAA,EACF;AACA,SAAO,QAAQ,CAAC,MAAM,KAAK,EAAE,KAAK,CAAC;AACrC;AAWO,SAAS,gBAAgB,YAAoB,YAAsB,CAAC,GAAG,QAAkB,CAAC,GAAQ;AACvG,QAAM,OAAO,UAAU,IAAI,CAAC,QAAQ,aAAa,GAAG,CAAC;AACrD,QAAM,UAAU,KAAK,QAAQ,CAAC,MAAM,EAAE,OAAO;AAC7C,QAAM,UAAU,KAAK,QAAQ,CAAC,MAAM,EAAE,OAAO;AAC7C,QAAM,OAAO,iBAAiB,UAAU;AACxC,QAAM,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AACzD,UAAQ,QAAQ,CAAC,MAAM,YAAY,EAAE,QAAQ,MAAM,CAAC;AACpD,cAAY,KAAK,QAAQ,MAAM;AAG/B,QAAM,UAAU,KAAK,UAAU,CAAC,GAAG,IAAI,CAAC,MAAM;AAC5C,UAAM,IAAI,MAAM,EAAE,IAAI;AACtB,UAAM,IAAI,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,IAAI;AAGrD,WAAO,EAAE,SAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI;AAAA,EACnE,CAAC;AAED,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,QAAQ,KAAK;AAAA,IACb,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,IACzD;AAAA,IACA,GAAI,QAAQ,SAAS,EAAE,QAAQ,IAAI,CAAC;AAAA,IACpC,QAAQ,KAAK;AAAA,IACb,GAAI,KAAK,aAAa,OAAO,KAAK,KAAK,SAAS,EAAE,SAAS,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IAC5F,GAAI,KAAK,SAAS,SAAS,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;AAAA,IACxD,GAAI,KAAK,WAAW,SAAS,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IAC9D,UAAU,KAAK,YAAY,EAAE,KAAK,IAAI,gBAAgB,IAAI,QAAQ,CAAC,EAAE;AAAA,IACrE,GAAI,KAAK,cAAc,SAAS,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;AAAA,IACvE,GAAI,KAAK,aAAa,SAAS,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;AAAA,IACpE,GAAI,OAAO,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,EACpC;AACF;AAGO,IAAM,aAAa,CAAC,QAAqB,KAAK,UAAU,GAAG;","names":[]}

package/dist/cli/flatc.js

@@ -1,8 +1,8 @@
 import {
   run
-} from "../chunk-2NAWPQKH.js";
+} from "../chunk-DETQTCBJ.js";
 import "../chunk-AJKZ7C3H.js";
-import "../chunk-TPDP5FDF.js";
+import "../chunk-KXKX2RMX.js";
 export {
   run
 };

package/dist/compile.js

@@ -1,7 +1,7 @@
 import {
   compileFlatpack,
   packToJSON
-} from "./chunk-TPDP5FDF.js";
+} from "./chunk-KXKX2RMX.js";
 export {
   compileFlatpack,
   packToJSON

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   run
-} from "./chunk-2NAWPQKH.js";
+} from "./chunk-DETQTCBJ.js";
 import {
   allScopeVariables,
   docHasErrors,
@@ -21,7 +21,7 @@ import {
 import {
   compileFlatpack,
   packToJSON
-} from "./chunk-TPDP5FDF.js";
+} from "./chunk-KXKX2RMX.js";
 
 // src/manifest.ts
 import { EXPR_CHANNELS as EXPR_CHANNELS2 } from "@flatkit/engine/timeline";

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@flatkit/compiler",
-  "version": "0.19.10",
+  "version": "0.19.12",
   "description": "The FlatInk language (parser + AST) and compiler (.flatink → .flatpack). Ships the flatc CLI.",
   "license": "MIT",
   "author": "Zwyk Studio",
   "homepage": "http://flatink.zwyk-studio.com/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/zwykstudio/flatkit.git",
+    "url": "git+https://github.com/flatink/flatkit.git",
     "directory": "packages/compiler"
   },
-  "bugs": "https://github.com/zwykstudio/flatkit/issues",
+  "bugs": "https://github.com/flatink/flatkit/issues",
   "keywords": [
     "flatink",
     "flatpack",
@@ -45,9 +45,9 @@
     "bin"
   ],
   "dependencies": {
-    "@flatkit/player": "0.19.10",
-    "@flatkit/types": "0.19.10",
-    "@flatkit/engine": "0.19.10"
+    "@flatkit/player": "0.19.12",
+    "@flatkit/types": "0.19.12",
+    "@flatkit/engine": "0.19.12"
   },
   "peerDependencies": {
     "skia-canvas": "^3.0.8"

package/dist/chunk-TPDP5FDF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/compile.ts"],"sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n//  compile.ts — the \"modern SWF\" compiler (RFC, step P2).\n//\n//  Takes the PROGRAM (`.flatink`) + the ASSETS (`.flat`) and produces a resolved `Doc` —\n//  the \".flatpack\" v1 (= the baked doc the player already plays). Steps:\n//    1. parse the assets → symbols;\n//    2. parse the program → composition + behavior (`@Name` refs);\n//    3. RESOLVE refs by name (instances → symbol id), across ALL libs;\n//    4. assemble the Doc.\n//\n//  v1: no binary optimization nor media embedding (P2b). Pure, no DOM.\n// ─────────────────────────────────────────────────────────────────────────────\nimport type { Doc, Item, Layer } from '@flatkit/types'\nimport { parseFlatLib, parseProgramFull } from '@flatkit/engine/flatFormat'\nimport { isGroup, isInstance } from '@flatkit/engine/layers'\n\n/** Resolves `symbolId: '@Name'` instances into real ids (recursive, across groups). */\nfunction resolveRefs(layers: Layer[], byName: Map<string, string>): void {\n  const walk = (items: Item[]) => {\n    for (const it of items) {\n      if (isInstance(it) && it.symbolId.startsWith('@')) it.symbolId = byName.get(it.symbolId.slice(1)) ?? it.symbolId\n      if (isGroup(it)) it.layers.forEach((l) => walk(l.items))\n    }\n  }\n  layers.forEach((l) => walk(l.items))\n}\n\n/** Source of a media (base64 data-URI) by declared path (`asset … \"path\" …`). */\nexport type MediaMap = Record<string, { mime: string; data: string }>\n\n/**\n * Compile a `.flatink` program + its `.flat` assets → playable `Doc` (the \".flatpack\").\n * `assetSrcs` = the text of each `.flat` lib. `media` = the content of the referenced media files\n * (by path). Symbol refs (by name) are resolved across the whole set of libs; declared media\n * are EMBEDDED (path → data-URI).\n */\nexport function compileFlatpack(programSrc: string, assetSrcs: string[] = [], media: MediaMap = {}): Doc {\n  const libs = assetSrcs.map((src) => parseFlatLib(src))\n  const symbols = libs.flatMap((l) => l.symbols)\n  const folders = libs.flatMap((l) => l.folders) // library folders (organization)\n  const prog = parseProgramFull(programSrc)\n  const byName = new Map(symbols.map((s) => [s.name, s.id]))\n  symbols.forEach((s) => resolveRefs(s.layers, byName)) // cross-lib refs\n  resolveRefs(prog.layers, byName) // program refs\n\n  // Embed declared media (data = path → provided data-URI). Missing = left as is.\n  const assets = (prog.assets ?? []).map((a) => { const m = media[a.data]; return m ? { ...a, mime: m.mime, data: m.data } : a })\n\n  return {\n    width: prog.width,\n    height: prog.height,\n    ...(prog.background ? { background: prog.background } : {}),\n    symbols,\n    ...(folders.length ? { folders } : {}),\n    layers: prog.layers,\n    ...(prog.variables && Object.keys(prog.variables).length ? { variables: prog.variables } : {}),\n    ...(prog.imports?.length ? { imports: prog.imports } : {}),\n    ...(prog.functions?.length ? { functions: prog.functions } : {}),\n    timeline: prog.timeline ?? { fps: 24, durationFrames: 60, tracks: [] },\n    ...(prog.interactions?.length ? { interactions: prog.interactions } : {}),\n    ...(prog.interactors?.length ? { interactors: prog.interactors } : {}),\n    ...(assets.length ? { assets } : {}),\n  }\n}\n\n/** Serialize the `.flatpack` v1 (JSON of the compiled Doc). */\nexport const packToJSON = (doc: Doc): string => JSON.stringify(doc)\n"],"mappings":";AAaA,SAAS,cAAc,wBAAwB;AAC/C,SAAS,SAAS,kBAAkB;AAGpC,SAAS,YAAY,QAAiB,QAAmC;AACvE,QAAM,OAAO,CAAC,UAAkB;AAC9B,eAAW,MAAM,OAAO;AACtB,UAAI,WAAW,EAAE,KAAK,GAAG,SAAS,WAAW,GAAG,EAAG,IAAG,WAAW,OAAO,IAAI,GAAG,SAAS,MAAM,CAAC,CAAC,KAAK,GAAG;AACxG,UAAI,QAAQ,EAAE,EAAG,IAAG,OAAO,QAAQ,CAAC,MAAM,KAAK,EAAE,KAAK,CAAC;AAAA,IACzD;AAAA,EACF;AACA,SAAO,QAAQ,CAAC,MAAM,KAAK,EAAE,KAAK,CAAC;AACrC;AAWO,SAAS,gBAAgB,YAAoB,YAAsB,CAAC,GAAG,QAAkB,CAAC,GAAQ;AACvG,QAAM,OAAO,UAAU,IAAI,CAAC,QAAQ,aAAa,GAAG,CAAC;AACrD,QAAM,UAAU,KAAK,QAAQ,CAAC,MAAM,EAAE,OAAO;AAC7C,QAAM,UAAU,KAAK,QAAQ,CAAC,MAAM,EAAE,OAAO;AAC7C,QAAM,OAAO,iBAAiB,UAAU;AACxC,QAAM,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AACzD,UAAQ,QAAQ,CAAC,MAAM,YAAY,EAAE,QAAQ,MAAM,CAAC;AACpD,cAAY,KAAK,QAAQ,MAAM;AAG/B,QAAM,UAAU,KAAK,UAAU,CAAC,GAAG,IAAI,CAAC,MAAM;AAAE,UAAM,IAAI,MAAM,EAAE,IAAI;AAAG,WAAO,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,IAAI;AAAA,EAAE,CAAC;AAE9H,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,QAAQ,KAAK;AAAA,IACb,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,IACzD;AAAA,IACA,GAAI,QAAQ,SAAS,EAAE,QAAQ,IAAI,CAAC;AAAA,IACpC,QAAQ,KAAK;AAAA,IACb,GAAI,KAAK,aAAa,OAAO,KAAK,KAAK,SAAS,EAAE,SAAS,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IAC5F,GAAI,KAAK,SAAS,SAAS,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;AAAA,IACxD,GAAI,KAAK,WAAW,SAAS,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IAC9D,UAAU,KAAK,YAAY,EAAE,KAAK,IAAI,gBAAgB,IAAI,QAAQ,CAAC,EAAE;AAAA,IACrE,GAAI,KAAK,cAAc,SAAS,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;AAAA,IACvE,GAAI,KAAK,aAAa,SAAS,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;AAAA,IACpE,GAAI,OAAO,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,EACpC;AACF;AAGO,IAAM,aAAa,CAAC,QAAqB,KAAK,UAAU,GAAG;","names":[]}