@markdy/core 0.8.5 → 0.8.6

package/dist/index.d.ts

@@ -77,6 +77,12 @@ type Cue = {
     zoom?: number;
     dur?: number;
     line: number;
+} | {
+    kind: "frame";
+    targets: string[];
+    zoom?: number;
+    dur?: number;
+    line: number;
 } | {
     kind: "use";
     pattern: string;
@@ -163,7 +169,7 @@ type RoutedEdge = {
 type TimedCue = {
     start: number;
     duration: number;
-    kind: "show" | "hide" | "flow" | "glow" | "focus";
+    kind: "show" | "hide" | "flow" | "glow" | "focus" | "frame";
     targets: string[];
     edgeId?: string;
     segments?: FlowSegment[];

package/dist/index.js

@@ -349,7 +349,8 @@ var EDGE_OPERATORS = {
   "~>": "event",
   "--": "dependency"
 };
-var BEAT_CUE_KEYWORDS = /* @__PURE__ */ new Set(["show", "hide", "glow", "focus", "use"]);
+var RESERVED_SELECTORS = /* @__PURE__ */ new Set(["$title", "$nodes", "$edges"]);
+var BEAT_CUE_KEYWORDS = /* @__PURE__ */ new Set(["show", "hide", "glow", "focus", "frame", "use"]);
 var SCENE_KEYS = /* @__PURE__ */ new Set(["width", "height", "fps", "theme", "duration", "direction"]);
 function nodeRole(kind) {
   return TECHNICAL_NODE_KINDS[kind] ?? "compute";
@@ -391,6 +392,7 @@ var DEFAULTS = {
   flow: 0.55,
   glow: 0.45,
   focus: 0.6,
+  frame: 0.7,
   beatGap: 0.14,
   cueGap: 0.08,
   stagger: 0.06
@@ -575,7 +577,7 @@ function scheduleBeats(ast, edges) {
         }
         return;
       }
-      if (cue.kind !== "show" && cue.kind !== "hide" && cue.kind !== "glow" && cue.kind !== "focus") return;
+      if (cue.kind !== "show" && cue.kind !== "hide" && cue.kind !== "glow" && cue.kind !== "focus" && cue.kind !== "frame") return;
       const targets = resolveTargets(cue.targets, ast, Object.fromEntries(Object.entries(ast.groups).map(([k, g]) => [k, g.members])));
       scheduled.push({
         start: t,
@@ -586,7 +588,7 @@ function scheduleBeats(ast, edges) {
           stagger: cue.kind === "show" ? cue.stagger ?? DEFAULTS.stagger : void 0,
           color: cue.kind === "glow" ? cue.color : void 0,
           strength: cue.kind === "glow" ? cue.strength : void 0,
-          zoom: cue.kind === "focus" ? cue.zoom : void 0
+          zoom: cue.kind === "focus" || cue.kind === "frame" ? cue.zoom : void 0
         },
         beat: beat.name
       });
@@ -834,8 +836,7 @@ function splitTargetLabel(token, lineNo) {
 }
 function parseCueLine(line, lineNo) {
   const trimmed = line.trim();
-  const propsMatch = trimmed.match(/\s+(?:dur|stagger|color|strength|zoom|after)=\S+/);
-  const props = propsMatch ? parseProps(propsMatch[0]) : {};
+  const props = parseProps(trimmed);
   if (trimmed.includes(" & ")) {
     const parts = trimmed.split(/\s+&\s+/);
     return {
@@ -886,6 +887,18 @@ function parseCueLine(line, lineNo) {
       line: lineNo
     };
   }
+  if (keyword === "frame") {
+    const targetRaw = rest.join(" ").split(/\s+(?:zoom|dur)=/)[0];
+    const targets = splitTargets(targetRaw);
+    if (targets.length === 0) throw new ParseError(`expected frame target`, lineNo);
+    return {
+      kind: "frame",
+      targets,
+      zoom: typeof props.zoom === "number" ? props.zoom : void 0,
+      dur: typeof props.dur === "number" ? props.dur : void 0,
+      line: lineNo
+    };
+  }
   if (keyword === "use") {
     const call = rest.join(" ");
     const m = call.match(/^(\w+)\s*\((.*)\)\s*$/);
@@ -931,10 +944,9 @@ function substitutePatternCue(cue, params, args) {
   params.forEach((p, i) => {
     if (resolvedArgs[p] === void 0 && positional[i]) resolvedArgs[p] = positional[i];
   });
-  delete resolvedArgs.__pos_0;
-  delete resolvedArgs.__pos_1;
-  delete resolvedArgs.__pos_2;
-  delete resolvedArgs.__pos_3;
+  for (const key of Object.keys(resolvedArgs)) {
+    if (key.startsWith("__pos_")) delete resolvedArgs[key];
+  }
   const sub = (s) => {
     for (const p of params) {
       if (resolvedArgs[p]) s = s.replaceAll(`$${p}`, resolvedArgs[p]);
@@ -952,7 +964,7 @@ function substitutePatternCue(cue, params, args) {
       }))
     };
   }
-  if (cue.kind === "show" || cue.kind === "hide" || cue.kind === "glow" || cue.kind === "focus") {
+  if (cue.kind === "show" || cue.kind === "hide" || cue.kind === "glow" || cue.kind === "focus" || cue.kind === "frame") {
     return { ...cue, targets: cue.targets.map(sub) };
   }
   if (cue.kind === "parallel") {
@@ -980,6 +992,67 @@ function readIndentedBody(blocks, startIdx, parentIndent) {
   }
   return { body, nextIdx: i };
 }
+function pushWarning(diagnostics, seen, line, message) {
+  const key = `${line}:${message}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  diagnostics.push({ severity: "warning", message, line });
+}
+function visitCues(cues, visit) {
+  for (const cue of cues) {
+    visit(cue);
+    if (cue.kind === "parallel") visitCues(cue.cues, visit);
+  }
+}
+function validateReferences(ast) {
+  const seen = /* @__PURE__ */ new Set();
+  const hasNode = (id) => Boolean(ast.nodes[id]);
+  const hasGroup = (id) => Boolean(ast.groups[id]);
+  const isKnownTarget = (target) => {
+    if (RESERVED_SELECTORS.has(target)) return true;
+    if (target.startsWith("$")) return hasGroup(target.slice(1));
+    return hasNode(target) || hasGroup(target);
+  };
+  for (const group of Object.values(ast.groups)) {
+    for (const member of group.members) {
+      if (!hasNode(member)) {
+        pushWarning(ast.diagnostics, seen, group.line, `group '${group.id}' references unknown node '${member}'`);
+      }
+    }
+  }
+  for (const node of Object.values(ast.nodes)) {
+    if (node.style && !ast.styles[node.style]) {
+      pushWarning(ast.diagnostics, seen, node.line, `node '${node.id}' references unknown style '${node.style}'`);
+    }
+  }
+  const validateFlowEndpoint = (line, endpoint) => {
+    if (!hasNode(endpoint)) {
+      pushWarning(ast.diagnostics, seen, line, `flow references unknown node '${endpoint}'`);
+    }
+  };
+  for (const edge of ast.edges) {
+    validateFlowEndpoint(edge.line, edge.from);
+    validateFlowEndpoint(edge.line, edge.to);
+  }
+  for (const beat of ast.beats) {
+    visitCues(beat.cues, (cue) => {
+      if (cue.kind === "flow") {
+        for (const segment of cue.segments) {
+          validateFlowEndpoint(cue.line, segment.from);
+          validateFlowEndpoint(cue.line, segment.to);
+        }
+        return;
+      }
+      if (cue.kind === "show" || cue.kind === "hide" || cue.kind === "glow" || cue.kind === "focus" || cue.kind === "frame") {
+        for (const target of cue.targets) {
+          if (!isKnownTarget(target)) {
+            pushWarning(ast.diagnostics, seen, cue.line, `${cue.kind} references unknown target '${target}'`);
+          }
+        }
+      }
+    });
+  }
+}
 function parse(source, opts = {}) {
   const lines = source.replace(/\r\n/g, "\n").split("\n");
   const diagnostics = [];
@@ -1122,10 +1195,6 @@ function parse(source, opts = {}) {
     }
     throw new ParseError(`unexpected statement`, lineNo);
   }
-  const errors = diagnostics.filter((d) => d.severity === "error");
-  if (errors.length) {
-    throw new ParseError(errors[0].message, errors[0].line, errors[0].column);
-  }
   const ast = {
     meta: { ...meta, title: title || void 0 },
     styles,
@@ -1136,6 +1205,11 @@ function parse(source, opts = {}) {
     beats,
     diagnostics
   };
+  validateReferences(ast);
+  const errors = ast.diagnostics.filter((d) => d.severity === "error");
+  if (errors.length) {
+    throw new ParseError(errors[0].message, errors[0].line, errors[0].column);
+  }
   if (!opts.parseOnly && Object.keys(nodes).length === 0 && beats.length === 0) {
   }
   return ast;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/core",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "MarkdyScript parser and diagram compiler (auto-layout, edge routing, cue scheduling) — zero runtime dependencies.",
   "license": "MIT",
   "type": "module",