@lumencast/compiler 0.1.0

package/dist/compile.js

@@ -0,0 +1,270 @@
+// LSML 1.0 → flat RenderBundle compiler.
+//
+// LSML lets authors write idiomatic primitives with inline `bind: { value: "path" }`,
+// CSS-style `style.fontSize`, `repeat.template`, `animate` directives. The runtime
+// expects a flat shape: per-node `bindings` map, primitive-specific prop names
+// (Solar lineage: `text.size`, `text.colour`), and `repeat` whose template is its
+// only child.
+//
+// This compiler bridges the two formats. It does NOT execute the bundle — it
+// produces a JSON the runtime then renders.
+export function compileBundle(lsml, options = {}) {
+    if (lsml.lsml !== "1.0") {
+        throw new Error(`compiler: only LSML 1.0 is supported, got ${lsml.lsml}`);
+    }
+    return {
+        scene_version: lsml.scene_version,
+        root: compileNode(lsml.layout, options),
+        ...(lsml.operator_inputs
+            ? {
+                operator_inputs: lsml.operator_inputs.map((oi) => ({
+                    path: oi.path,
+                    label: oi.label,
+                    type: oi.type,
+                    writable_by: oi.writable_by,
+                    ...(oi.group !== undefined ? { group: oi.group } : {}),
+                    ...(oi.constraints ?? {}),
+                })),
+            }
+            : {}),
+        ...(lsml.external_adapters
+            ? {
+                external_adapters: lsml.external_adapters,
+            }
+            : {}),
+    };
+}
+function compileNode(node, opts) {
+    if (node.kind === "repeat") {
+        return compileRepeat(node, opts);
+    }
+    const props = {};
+    const bindings = {};
+    // Common: bind.value/src → bindings
+    if (node.bind?.value !== undefined)
+        bindings["value"] = node.bind.value;
+    if (node.bind?.src !== undefined)
+        bindings["src"] = node.bind.src;
+    if (node.bindStyle) {
+        for (const [k, v] of Object.entries(node.bindStyle))
+            bindings[k] = v;
+    }
+    switch (node.kind) {
+        case "stack":
+            if (node.direction !== undefined)
+                props["direction"] = node.direction;
+            if (node.gap !== undefined)
+                props["gap"] = node.gap;
+            if (node.align !== undefined)
+                props["align"] = mapAlign(node.align);
+            if (node.justify !== undefined)
+                props["justify"] = mapJustify(node.justify);
+            if (node.padding !== undefined)
+                props["padding"] = node.padding;
+            if (node.rtl !== undefined)
+                props["rtl"] = node.rtl;
+            break;
+        case "grid":
+            if (node.columns !== undefined)
+                props["columns"] = node.columns;
+            if (node.rows !== undefined)
+                props["rows"] = node.rows;
+            if (node.gap !== undefined)
+                props["gap"] = node.gap;
+            if (node.padding !== undefined)
+                props["padding"] = node.padding;
+            break;
+        case "frame":
+            if (node.size !== undefined) {
+                props["width"] = node.size.w;
+                props["height"] = node.size.h;
+            }
+            if (node.position !== undefined) {
+                props["x"] = node.position.x;
+                props["y"] = node.position.y;
+            }
+            if (node.background !== undefined)
+                props["background"] = node.background;
+            break;
+        case "text":
+            mapTextStyle(node, props);
+            if (node.format !== undefined)
+                props["format"] = node.format;
+            if (node.maxLines !== undefined)
+                props["maxLines"] = node.maxLines;
+            break;
+        case "image":
+            props["alt"] = node.alt;
+            props["width"] = node.size.w;
+            props["height"] = node.size.h;
+            if (node.fit !== undefined)
+                props["fit"] = node.fit;
+            break;
+        case "shape":
+            props["geometry"] = node.geometry;
+            if (node.size !== undefined) {
+                props["width"] = node.size.w;
+                props["height"] = node.size.h;
+            }
+            if (node.pathData !== undefined)
+                props["pathData"] = node.pathData;
+            if (node.fill !== undefined)
+                props["fill"] = node.fill;
+            if (node.stroke !== undefined)
+                props["stroke"] = node.stroke;
+            if (node.cornerRadius !== undefined)
+                props["cornerRadius"] = node.cornerRadius;
+            if (node.ariaLabel !== undefined)
+                props["ariaLabel"] = node.ariaLabel;
+            break;
+        case "media":
+            props["kind_hint"] = node.kind_hint;
+            if (node.controls !== undefined)
+                props["controls"] = node.controls;
+            if (node.autoplay !== undefined)
+                props["autoplay"] = node.autoplay;
+            if (node.muted !== undefined)
+                props["muted"] = node.muted;
+            if (node.loop !== undefined)
+                props["loop"] = node.loop;
+            if (node.size !== undefined) {
+                props["width"] = node.size.w;
+                props["height"] = node.size.h;
+            }
+            break;
+    }
+    const children = node.children?.map((c) => compileNode(c, opts));
+    const out = { kind: node.kind };
+    if (node.id !== undefined)
+        out.id = node.id;
+    if (Object.keys(props).length > 0)
+        out.props = props;
+    if (Object.keys(bindings).length > 0)
+        out.bindings = bindings;
+    if (children && children.length > 0)
+        out.children = children;
+    // Animate directive → transitions on the listed prop keys.
+    if (node.animate) {
+        const tx = compileAnimate(node.animate);
+        if (tx) {
+            const transitions = {};
+            if (node.animate.opacity !== undefined)
+                transitions["opacity"] = tx;
+            if (node.animate.transform?.scale !== undefined)
+                transitions["scale"] = tx;
+            if (node.animate.transform?.rotate !== undefined)
+                transitions["rotate"] = tx;
+            if (node.animate.transform?.translate !== undefined) {
+                transitions["x"] = tx;
+                transitions["y"] = tx;
+            }
+            // Type assertion: RenderNode.transitions matches Transition shape; the
+            // cast keeps the compiler self-contained without re-importing the runtime
+            // Transition type.
+            if (Object.keys(transitions).length > 0) {
+                out.transitions = transitions;
+            }
+        }
+    }
+    return out;
+}
+function compileRepeat(node, opts) {
+    if (!node.bind?.items) {
+        throw new Error(`compiler: repeat node "${node.id ?? "<anon>"}" missing bind.items`);
+    }
+    const compiledTemplate = compileNode(node.template, opts);
+    const out = {
+        kind: "repeat",
+        bindings: { items: node.bind.items },
+        children: [compiledTemplate],
+    };
+    if (node.id !== undefined)
+        out.id = node.id;
+    return out;
+}
+function mapTextStyle(node, props) {
+    if (!node.style)
+        return;
+    const s = node.style;
+    // Solar's Text primitive consumes size/weight/colour (UK), not CSS-style names.
+    if (s.fontSize !== undefined)
+        props["size"] = s.fontSize;
+    if (s.fontWeight !== undefined)
+        props["weight"] = s.fontWeight;
+    if (s.color !== undefined)
+        props["colour"] = s.color;
+    if (s.textAlign !== undefined)
+        props["align"] = mapTextAlign(s.textAlign);
+    if (s.lineHeight !== undefined)
+        props["lineHeight"] = s.lineHeight;
+}
+function mapAlign(a) {
+    // LSML uses CSS-grid vocabulary; Solar's Stack consumes flexbox vocabulary.
+    switch (a) {
+        case "start":
+            return "flex-start";
+        case "center":
+            return "center";
+        case "end":
+            return "flex-end";
+        case "stretch":
+            return "stretch";
+    }
+}
+function mapJustify(j) {
+    switch (j) {
+        case "start":
+            return "flex-start";
+        case "center":
+            return "center";
+        case "end":
+            return "flex-end";
+        case "space-between":
+            return "space-between";
+        case "space-around":
+            return "space-around";
+    }
+}
+function mapTextAlign(a) {
+    switch (a) {
+        case "start":
+            return "left";
+        case "end":
+            return "right";
+        default:
+            return a;
+    }
+}
+function compileAnimate(a) {
+    const t = a.transition;
+    if (!t)
+        return undefined;
+    if (t.easing === "spring") {
+        const out = { kind: "spring" };
+        if (t.stiffness !== undefined)
+            out.stiffness = t.stiffness;
+        if (t.damping !== undefined)
+            out.damping = t.damping;
+        return out;
+    }
+    return {
+        kind: "tween",
+        duration_ms: t.duration ?? 200,
+        ease: mapEase(t.easing),
+    };
+}
+function mapEase(e) {
+    switch (e) {
+        case "linear":
+            return "linear";
+        case "ease-in":
+            return "cubic-in";
+        case "ease-out":
+            return "cubic-out";
+        case "ease-in-out":
+            return "cubic-in-out";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { compileBundle, type CompileOptions } from "./compile.js";
+export { canonicalize, hashBundle, ZERO_HASH } from "./canonicalize.js";
+export type { LSMLBundle, LSMLNode, LSMLPrimitiveKind, LSMLBindObject, LSMLAnimateDirective, LSMLStack, LSMLGrid, LSMLFrame, LSMLText, LSMLImage, LSMLShape, LSMLMedia, LSMLRepeat, LSMLOperatorInput, } from "./lsml-types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// Public surface of @lumencast/compiler.
+export { compileBundle } from "./compile.js";
+export { canonicalize, hashBundle, ZERO_HASH } from "./canonicalize.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lsml-types.d.ts

@@ -0,0 +1,152 @@
+export type LSMLPrimitiveKind = "stack" | "grid" | "frame" | "text" | "image" | "shape" | "media" | "repeat";
+export interface LSMLBindObject {
+    /** Most primitives bind a `value` to a leaf path. */
+    value?: string;
+    /** image / media bind a `src`. */
+    src?: string;
+    /** repeat binds `items`. */
+    items?: string;
+}
+export interface LSMLAnimateDirective {
+    transition?: {
+        duration?: number;
+        easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out" | "spring";
+        stiffness?: number;
+        damping?: number;
+    };
+    transform?: {
+        translate?: [number, number];
+        scale?: number | [number, number];
+        rotate?: number;
+    };
+    opacity?: number;
+    filter?: {
+        blur?: number;
+        brightness?: number;
+    };
+}
+export interface LSMLBaseNode {
+    kind: LSMLPrimitiveKind;
+    id?: string;
+    bind?: LSMLBindObject;
+    bindStyle?: Record<string, string>;
+    animate?: LSMLAnimateDirective;
+    children?: LSMLNode[];
+}
+export interface LSMLStack extends LSMLBaseNode {
+    kind: "stack";
+    direction?: "horizontal" | "vertical";
+    gap?: number;
+    align?: "start" | "center" | "end" | "stretch";
+    justify?: "start" | "center" | "end" | "space-between" | "space-around";
+    padding?: number | [number, number, number, number];
+    rtl?: "auto" | boolean;
+}
+export interface LSMLGrid extends LSMLBaseNode {
+    kind: "grid";
+    columns: number | unknown[];
+    rows?: number | unknown[];
+    gap?: number | [number, number];
+    padding?: number | unknown[];
+}
+export interface LSMLFrame extends LSMLBaseNode {
+    kind: "frame";
+    size?: {
+        w: number;
+        h: number;
+    };
+    position?: {
+        x: number;
+        y: number;
+    };
+    background?: string;
+}
+export interface LSMLText extends LSMLBaseNode {
+    kind: "text";
+    style?: {
+        fontSize?: number | string;
+        fontWeight?: number;
+        color?: string;
+        textAlign?: "start" | "center" | "end" | "left" | "right";
+        lineHeight?: number;
+    };
+    format?: {
+        kind: string;
+        [extra: string]: unknown;
+    };
+    maxLines?: number;
+}
+export interface LSMLImage extends LSMLBaseNode {
+    kind: "image";
+    alt: string;
+    size: {
+        w: number;
+        h: number;
+    };
+    fit?: "contain" | "cover" | "fill" | "none";
+}
+export interface LSMLShape extends LSMLBaseNode {
+    kind: "shape";
+    geometry: "rect" | "circle" | "path";
+    size?: {
+        w: number;
+        h: number;
+    };
+    pathData?: string;
+    fill?: string;
+    stroke?: {
+        color: string;
+        width: number;
+    };
+    cornerRadius?: number;
+    ariaLabel?: string;
+}
+export interface LSMLMedia extends LSMLBaseNode {
+    kind: "media";
+    kind_hint: "video" | "audio";
+    controls?: boolean;
+    autoplay?: boolean;
+    muted?: boolean;
+    loop?: boolean;
+    size?: {
+        w: number;
+        h: number;
+    };
+}
+export interface LSMLRepeat extends LSMLBaseNode {
+    kind: "repeat";
+    scope: string;
+    key?: string;
+    template: LSMLNode;
+    limit?: number;
+}
+export type LSMLNode = LSMLStack | LSMLGrid | LSMLFrame | LSMLText | LSMLImage | LSMLShape | LSMLMedia | LSMLRepeat;
+export interface LSMLOperatorInput {
+    path: string;
+    label: string;
+    type: string;
+    constraints?: Record<string, unknown>;
+    writable_by: string[];
+    group?: string;
+    [extra: string]: unknown;
+}
+export interface LSMLBundle {
+    lsml: "1.0";
+    scene_id: string;
+    scene_version: string;
+    layout: LSMLNode;
+    operator_inputs?: LSMLOperatorInput[];
+    external_adapters?: unknown[];
+    defaults?: Record<string, unknown>;
+    assets?: {
+        allowedHosts?: string[];
+        fonts?: unknown[];
+        preload?: string[];
+    };
+    i18n?: {
+        default_locale?: string;
+        locales?: Record<string, Record<string, string>>;
+    };
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=lsml-types.d.ts.map

package/dist/lsml-types.d.ts.map

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

package/dist/lsml-types.js

@@ -0,0 +1,4 @@
+// LSML 1.0 input types — what authors write.
+// Reference: lumencast-protocol/spec/LSML-1.md
+export {};
+//# sourceMappingURL=lsml-types.js.map

package/dist/lsml-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsml-types.js","sourceRoot":"","sources":["../src/lsml-types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,+CAA+C"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@lumencast/compiler",
+  "version": "0.1.0",
+  "description": "LSML 1.0 → flat RenderBundle compiler. Lets authors write idiomatic LSML and feed it to @lumencast/runtime.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "homepage": "https://github.com/Lumencast/lumencast-js/tree/main/packages/compiler",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Lumencast/lumencast-js.git",
+    "directory": "packages/compiler"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@lumencast/protocol": "0.1.0",
+    "@lumencast/runtime": "0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty",
+    "test": "vitest run"
+  }
+}

package/src/canonicalize.ts

@@ -0,0 +1,64 @@
+// Canonical JSON form per LSML 1.0 §3 — deterministic stringification used for
+// content-addressing scenes by sha256.
+//
+// Rules:
+//   1. UTF-8 encoding (handled by Node's default)
+//   2. Object keys sorted lexicographically at every nesting level
+//   3. No insignificant whitespace (no newlines/tabs)
+//   4. Numbers in shortest decimal form (JSON.stringify default)
+//   5. The `scene_version` field MUST be set to all-zeros during hashing,
+//      then replaced with `sha256:<hash>`.
+
+export const ZERO_HASH = "sha256:" + "0".repeat(64);
+
+export function canonicalize(value: unknown): string {
+  return stringify(value);
+}
+
+/** Compute the sha256 content hash of a bundle, then return a copy with
+ *  `scene_version` set to that hash. Uses Node's built-in `crypto.subtle`
+ *  (Node ≥ 18) or the browser's `window.crypto.subtle`. */
+export async function hashBundle<T extends { scene_version: string }>(bundle: T): Promise<T> {
+  const stub = { ...bundle, scene_version: ZERO_HASH };
+  const canonical = canonicalize(stub);
+  const bytes = new TextEncoder().encode(canonical);
+  const subtle = getSubtle();
+  const digest = await subtle.digest("SHA-256", bytes);
+  const hex = bytesToHex(new Uint8Array(digest));
+  return { ...bundle, scene_version: `sha256:${hex}` };
+}
+
+function stringify(v: unknown): string {
+  if (v === null) return "null";
+  if (typeof v === "boolean" || typeof v === "number") return JSON.stringify(v);
+  if (typeof v === "string") return JSON.stringify(v);
+  if (Array.isArray(v)) {
+    return "[" + v.map(stringify).join(",") + "]";
+  }
+  if (typeof v === "object") {
+    const obj = v as Record<string, unknown>;
+    const keys = Object.keys(obj).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + stringify(obj[k])).join(",") + "}";
+  }
+  // undefined / function / symbol — JSON has no representation; drop.
+  return "null";
+}
+
+function bytesToHex(bytes: Uint8Array): string {
+  let s = "";
+  for (const b of bytes) s += b.toString(16).padStart(2, "0");
+  return s;
+}
+
+interface SubtleLike {
+  digest(algorithm: "SHA-256", data: Uint8Array): Promise<ArrayBuffer>;
+}
+
+function getSubtle(): SubtleLike {
+  // Node ≥ 18 exposes crypto.subtle on globalThis; browsers via window.crypto.
+  const c = (globalThis as unknown as { crypto?: { subtle?: SubtleLike } }).crypto;
+  if (!c?.subtle) {
+    throw new Error("compiler: crypto.subtle not available — Node >= 18 or browser required");
+  }
+  return c.subtle;
+}