@lumencast/compiler 0.4.0 → 0.5.0

package/src/index.ts

@@ -1,6 +1,18 @@
 // Public surface of @lumencast/compiler.
 
-export { compileBundle, type CompileOptions } from "./compile.js";
+export {
+  compileBundle,
+  validatePathData,
+  BIND_ANIMATE_SCALAR_KEYS,
+  BIND_ANIMATE_COLOR_KEYS,
+  MAX_FILTER_BLUR_PX,
+  MAX_FILTER_BRIGHTNESS,
+  MAX_PATH_SUBPATH_BYTES,
+  MAX_PATH_SUBPATHS,
+  MAX_PATH_COMMANDS,
+  type CompileOptions,
+  type CompileDiagnostic,
+} from "./compile.js";
 export { canonicalize, hashBundle, ZERO_HASH } from "./canonicalize.js";
 export type {
   LSMLBundle,
@@ -8,6 +20,12 @@ export type {
   LSMLPrimitiveKind,
   LSMLBindObject,
   LSMLAnimateDirective,
+  LSMLFill,
+  LSMLFillStop,
+  LSMLStroke,
+  LSMLPath,
+  LSMLKeyframes,
+  LSMLKeyframeStep,
   LSMLStack,
   LSMLGrid,
   LSMLFrame,

package/src/lsml-types.ts

@@ -30,6 +30,66 @@ export interface LSMLBindObject {
   items?: string;
 }
 
+/** 1.1+ — a gradient stop (LSML §4.12). */
+export interface LSMLFillStop {
+  offset: number;
+  color: string;
+  opacity?: number;
+}
+
+/** 1.1+ — Fill union used by `shape.fills[]` and `frame.backgrounds[]`
+ *  (LSML §4.12). Discriminated on `kind`. */
+export type LSMLFill =
+  | { kind: "solid"; color: string; opacity?: number }
+  | { kind: "linear-gradient"; angle_deg?: number; stops: LSMLFillStop[]; opacity?: number }
+  | {
+      kind: "radial-gradient";
+      center?: { x: number; y: number };
+      radius?: number;
+      stops: LSMLFillStop[];
+      opacity?: number;
+    };
+
+/** 1.1+ — one stacked stroke layer (LSML §4.6). */
+export interface LSMLStroke {
+  color: string;
+  width: number;
+}
+
+/** 1.1+ — one subpath of a `geometry: "path"` shape (LSML §4.6). */
+export interface LSMLPath {
+  /** SVG path `d` attribute syntax. Validated at compile (ADR 001 RC#10). */
+  data: string;
+  /** Winding rule for this subpath. Default `"NONZERO"`. */
+  windingRule?: "NONZERO" | "EVENODD";
+}
+
+/** 1.1+ — one waypoint of a keyframe sequence (LSML §6.6). Same shapes
+ *  as `animate.transform` / `animate.opacity` / `animate.filter`. */
+export interface LSMLKeyframeStep {
+  /** Timeline position 0..1, normalised over `duration_ms`. */
+  at: number;
+  transform?: {
+    translate?: [number, number];
+    scale?: number | [number, number];
+    rotate?: number;
+  };
+  opacity?: number;
+  filter?: {
+    blur?: number;
+    brightness?: number;
+  };
+}
+
+/** 1.1+ — multi-step keyframe sequence (LSML §6.6). */
+export interface LSMLKeyframes {
+  /** LeafPath whose value-change replays the sequence. Omitted = mount-only. */
+  key?: string;
+  steps: LSMLKeyframeStep[];
+  duration_ms: number;
+  easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+}
+
 /** The visual state an `animate` directive can target (and, via `from`,
  *  start from). `from` carries the same fields ; it is the mount-time
  *  initial state that makes an authored `animate` play *on mount* without
@@ -53,6 +113,9 @@ export interface LSMLAnimateDirective extends LSMLAnimateState {
     easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out" | "spring";
     stiffness?: number;
     damping?: number;
+    /** 1.1 §6.2 — spring mass (kg, default 1). Lowered into the
+     *  runtime's `SpringTransition` (ADR 001 phase B, issue #33). */
+    mass?: number;
   };
   /** LSML 1.1 — mount-time initial state. When present, the element
    *  mounts with these values and animates to its declared target
@@ -69,6 +132,14 @@ export interface LSMLBaseNode {
   /** 1.1+ — bind universal props to leaf paths. */
   bindUniversal?: Record<string, string>;
   animate?: LSMLAnimateDirective;
+  /** 1.1+ §6.3 — animation targets bound to leaf paths. Keys MUST
+   *  reference animatable properties (the §6.1 list, plus the node
+   *  kind's colour-typed property per §6.5) ; any other key is a hard
+   *  compile error (ADR 001 §3.3 / RC#13 — throw, not warn). Lowered
+   *  to the RenderNode `animateBindings` map. */
+  bindAnimate?: Record<string, string>;
+  /** 1.1+ §6.6 — keyframe sequence, played on mount or `key` change. */
+  keyframes?: LSMLKeyframes;
   children?: LSMLNode[];
   /** 1.1+ — visibility flag (LSML §5.4). Defaults to true. */
   visible?: boolean;
@@ -106,7 +177,15 @@ export interface LSMLFrame extends LSMLBaseNode {
   kind: "frame";
   size?: { w: number; h: number };
   position?: { x: number; y: number };
+  /** Single solid background. Mutually exclusive with `backgrounds`. */
   background?: string;
+  /** 1.1+ — stacked backgrounds, top-to-bottom (LSML §4.3 + §4.12).
+   *  Mutually exclusive with `background`. */
+  backgrounds?: LSMLFill[];
+  /** 1.1+ — clip children to the frame's `size` (LSML §4.3). Spec
+   *  default is `true` ; the default is runtime-side, the compiler only
+   *  forwards an explicit value. */
+  clipsContent?: boolean;
 }
 
 export interface LSMLText extends LSMLBaseNode {
@@ -118,6 +197,10 @@ export interface LSMLText extends LSMLBaseNode {
     color?: string;
     textAlign?: "start" | "center" | "end" | "left" | "right";
     lineHeight?: number;
+    letterSpacing?: number;
+    textTransform?: "none" | "uppercase" | "lowercase" | "capitalize";
+    textDecoration?: "none" | "underline" | "line-through";
+    fontStyle?: "normal" | "italic" | "oblique";
   };
   format?: { kind: string; [extra: string]: unknown };
   maxLines?: number;
@@ -134,9 +217,20 @@ export interface LSMLShape extends LSMLBaseNode {
   kind: "shape";
   geometry: "rect" | "circle" | "path";
   size?: { w: number; h: number };
+  /** Single-path shorthand (LSML §4.6). Mutually exclusive with `paths`. */
   pathData?: string;
+  /** 1.1+ — multi-subpath geometry with per-subpath winding rules
+   *  (LSML §4.6). Mutually exclusive with `pathData`. */
+  paths?: LSMLPath[];
+  /** Single solid fill. Mutually exclusive with `fills`. */
   fill?: string;
+  /** 1.1+ — stacked fills, top-to-bottom (LSML §4.6 + §4.12).
+   *  Mutually exclusive with `fill`. */
+  fills?: LSMLFill[];
+  /** Single stroke. Mutually exclusive with `strokes`. */
   stroke?: { color: string; width: number };
+  /** 1.1+ — stacked strokes, top-to-bottom (LSML §4.6). */
+  strokes?: LSMLStroke[];
   cornerRadius?: number;
   ariaLabel?: string;
 }
@@ -157,6 +251,9 @@ export interface LSMLRepeat extends LSMLBaseNode {
   key?: string;
   template: LSMLNode;
   limit?: number;
+  /** 1.1+ §6.7 — per-iteration animation stagger in milliseconds.
+   *  Iteration N's animations start `N * stagger_ms` after iteration 0. */
+  stagger_ms?: number;
 }
 
 /** 1.1+ — `instance` primitive (LSML §4.9). Mounts a sub-scene by id with