@markdy/core 1.0.30 → 1.0.31

package/README.md

@@ -46,20 +46,28 @@ import { parse, ParseError } from "@markdy/core";
 import type { DiagramAST } from "@markdy/core";
 
 const source = `
-  scene theme=paper
-  browser Web
-  service API
-  beat main:
-    show $nodes
-    Web -> API "GET /users"
+scene "Cache-Aside Architecture" theme=paper
+layout LR
+
+browser Client "Web Client"
+gateway Gateway "API Gateway"
+service Shortener "URL Service"
+cache Redis "Redis Cluster"
+
+beat hit:
+  show $nodes stagger=60ms
+  Client -> Gateway "GET /x9" -> Shortener "resolve"
+  Shortener -> Redis "GET slug:x9"
+  Shortener <- Redis "200 Target URL"
+  Client <- Gateway "301 Redirect"
 `;
 
 try {
   const ast: DiagramAST = parse(source);
 
-  console.log(ast.meta);   // { width: 1280, height: 720, fps: 60, theme: "paper", direction: "LR", title: "Request" }
-  console.log(ast.nodes);  // { Web: { kind: "browser", ... }, API: { kind: "service", ... } }
-  console.log(ast.beats);  // [{ name: "main", cues: [...] }]
+  console.log(ast.meta);   // { width: 1280, height: 720, fps: 60, theme: "paper", direction: "LR", title: "Cache-Aside Architecture" }
+  console.log(ast.nodes);  // { Client: { kind: "browser", ... }, Gateway: { ... } }
+  console.log(ast.beats);  // [{ name: "hit", cues: [...] }]
 } catch (e) {
   if (e instanceof ParseError) {
     console.error(`Line ${e.line}: ${e.message}`);

package/dist/index.d.ts

@@ -778,4 +778,6 @@ declare function getIntelliCodeCompletions(docText: string, cursorLine: number,
 declare function predictNextLineSuggestion(docText: string, cursorLine: number): GhostTextSuggestion | null;
 declare function getArchitectureSuggestions(docText: string): ArchitectureRecommendation[];
 
-export { ARCH_RULE_PRESETS, type AnnotationDecl, type ArchRuleType, type ArchitecturePreset, type ArchitectureRecommendation, type ArchitectureRule, type ArchitectureViolation, type AutoRepairResult, BEAT_CUE_KEYWORDS, type BeatDecl, type BeatRange, type Box, CUE_ALIASES, type CardinalPort, type Cue, DIAGRAM_TYPES, type Diagnostic, type DiagnosticIssue, type DiagramAST, type DiagramContext, type DiagramDiffResult, type DiagramType, type DiffChangeType, EDGE_OPERATORS, type EdgeDecl, type EdgeDiff, type EdgeKind, type EdgeSelector, type ExtractedBeat, type ExtractedGroup, type ExtractedNode, type FlowSegment, type GhostTextSuggestion, type GroupBoundary, type GroupDecl, type IntelliCodeItem, type IntelliCodeItemKind, type LayoutDirection, type MarkdyConfig, NODE_ALIASES, NODE_KINDS, type NodeDecl, type NodeDiff, type NodeSelector, type NodeShape, OUTPUT_PRESETS, type OutputPreset, PLAYER_FLAT_KEYS, PLAYER_GROUPS, POPULAR_TECHS, ParseError, type ParseOptions, type ParseResult, type PatternDecl, type PlayerChromeConfig, type PlayerConfig, type PlayerControlsConfig, type PlayerInteractionConfig, type PlayerOverrides, type PlayerPlaybackConfig, type PlayerProgress, type PlayerScope, type Point, type PositionedNode, type RenderPlan, type RepairPromptBundle, type ResolvedPlayer, type RoutedEdge, type RoutedPath, type RuleSeverity, SCENE_KEYS, type SceneMeta, type SemanticProfile, type SequenceActivation, type SequenceMessage, type StyleDecl, type SyntaxDiagnosticReport, TECHNICAL_NODE_KINDS, TECHNICAL_NODE_TYPES, THEMES, type TechPreset, type ThemeGeneratorOptions, type ThemeTokens, type TimedCue, type TreeBus, VISUAL_PRIMITIVE_TYPES, analyzeAndBuildRepairPrompt, applyPlayerSetting, canonicalNodeKind, classifyTechnology, compile, compilePlan, compressMarkdyToUrlHash, computeAdaptiveDimensions, damerauLevenshteinDistance, decompressMarkdyFromUrlHash, diagnoseMarkdyCode, diffDiagramASTs, extractDiagramContext, findClosestMatch, generateThemeFromBrand, getArchitectureSuggestions, getBoxPortPosition, getIntelliCodeCompletions, humanizeId, listOutputPresets, nodeRole, parse, parseAndCompile, predictNextLineSuggestion, repairMarkdyCode, resolveArchitectureConfig, resolveOutputPreset, resolvePlayer, resolveTheme, routeOrthogonalEdge, selectOptimalPorts, validateArchitecture };
+declare function formatScene(ast: DiagramAST): string;
+
+export { ARCH_RULE_PRESETS, type AnnotationDecl, type ArchRuleType, type ArchitecturePreset, type ArchitectureRecommendation, type ArchitectureRule, type ArchitectureViolation, type AutoRepairResult, BEAT_CUE_KEYWORDS, type BeatDecl, type BeatRange, type Box, CUE_ALIASES, type CardinalPort, type Cue, DIAGRAM_TYPES, type Diagnostic, type DiagnosticIssue, type DiagramAST, type DiagramContext, type DiagramDiffResult, type DiagramType, type DiffChangeType, EDGE_OPERATORS, type EdgeDecl, type EdgeDiff, type EdgeKind, type EdgeSelector, type ExtractedBeat, type ExtractedGroup, type ExtractedNode, type FlowSegment, type GhostTextSuggestion, type GroupBoundary, type GroupDecl, type IntelliCodeItem, type IntelliCodeItemKind, type LayoutDirection, type MarkdyConfig, NODE_ALIASES, NODE_KINDS, type NodeDecl, type NodeDiff, type NodeSelector, type NodeShape, OUTPUT_PRESETS, type OutputPreset, PLAYER_FLAT_KEYS, PLAYER_GROUPS, POPULAR_TECHS, ParseError, type ParseOptions, type ParseResult, type PatternDecl, type PlayerChromeConfig, type PlayerConfig, type PlayerControlsConfig, type PlayerInteractionConfig, type PlayerOverrides, type PlayerPlaybackConfig, type PlayerProgress, type PlayerScope, type Point, type PositionedNode, type RenderPlan, type RepairPromptBundle, type ResolvedPlayer, type RoutedEdge, type RoutedPath, type RuleSeverity, SCENE_KEYS, type SceneMeta, type SemanticProfile, type SequenceActivation, type SequenceMessage, type StyleDecl, type SyntaxDiagnosticReport, TECHNICAL_NODE_KINDS, TECHNICAL_NODE_TYPES, THEMES, type TechPreset, type ThemeGeneratorOptions, type ThemeTokens, type TimedCue, type TreeBus, VISUAL_PRIMITIVE_TYPES, analyzeAndBuildRepairPrompt, applyPlayerSetting, canonicalNodeKind, classifyTechnology, compile, compilePlan, compressMarkdyToUrlHash, computeAdaptiveDimensions, damerauLevenshteinDistance, decompressMarkdyFromUrlHash, diagnoseMarkdyCode, diffDiagramASTs, extractDiagramContext, findClosestMatch, formatScene, generateThemeFromBrand, getArchitectureSuggestions, getBoxPortPosition, getIntelliCodeCompletions, humanizeId, listOutputPresets, nodeRole, parse, parseAndCompile, predictNextLineSuggestion, repairMarkdyCode, resolveArchitectureConfig, resolveOutputPreset, resolvePlayer, resolveTheme, routeOrthogonalEdge, selectOptimalPorts, validateArchitecture };

package/dist/index.js

@@ -5834,6 +5834,187 @@ function getArchitectureSuggestions(docText) {
   }
   return recommendations;
 }
+
+// src/format.ts
+function formatScene(ast) {
+  const lines = [];
+  const sceneParts = [`scene`];
+  if (ast.meta.title) sceneParts.push(JSON.stringify(ast.meta.title));
+  sceneParts.push(`theme=${ast.meta.theme}`);
+  if (ast.meta.width !== 1280) sceneParts.push(`width=${ast.meta.width}`);
+  if (ast.meta.height !== 720) sceneParts.push(`height=${ast.meta.height}`);
+  if (ast.meta.fps !== 60) sceneParts.push(`fps=${ast.meta.fps}`);
+  if (ast.meta.duration !== void 0) sceneParts.push(`duration=${ast.meta.duration}`);
+  lines.push(sceneParts.join(" "));
+  if (ast.meta.direction !== "LR") {
+    lines.push(`layout ${ast.meta.direction}`);
+  }
+  for (const style of Object.values(ast.styles)) {
+    lines.push(formatStyle(style));
+  }
+  for (const node of Object.values(ast.nodes)) {
+    lines.push(formatNode(node));
+  }
+  for (const edge of ast.edges) {
+    lines.push(formatEdge(edge));
+  }
+  for (const group of Object.values(ast.groups)) {
+    lines.push(formatGroup(group));
+  }
+  for (const pattern of Object.values(ast.patterns)) {
+    lines.push(`pattern ${pattern.name}(${pattern.params.join(", ")}):`);
+    for (const cue of pattern.body) {
+      lines.push(`  ${formatCue(cue)}`);
+    }
+    lines.push("");
+  }
+  for (const beat of ast.beats) {
+    lines.push(formatBeat(beat));
+    lines.push("");
+  }
+  const player = formatPlayer(ast.meta.player);
+  if (player.length > 0) {
+    if (lines.at(-1) !== "") lines.push("");
+    lines.push(...player);
+  }
+  return `${lines.join("\n").trim()}
+`;
+}
+function formatPlayer(player) {
+  if (!player) return [];
+  const groups = [
+    ["playback", [
+      ["autoplay", player.playback?.autoplay],
+      ["loop", player.playback?.loop],
+      ["rate", player.playback?.rate]
+    ]],
+    ["controls", [
+      ["play", player.controls?.play],
+      ["restart", player.controls?.restart],
+      ["prev_beat", player.controls?.prevBeat],
+      ["next_beat", player.controls?.nextBeat],
+      ["seek", player.controls?.seek],
+      ["speed", player.controls?.speed],
+      ["speeds", player.controls?.speeds?.join(" ")],
+      ["fit", player.controls?.fit],
+      ["reset_view", player.controls?.resetView],
+      ["fullscreen", player.controls?.fullscreen],
+      ["svg", player.controls?.svg],
+      ["share", player.controls?.share],
+      ["code", player.controls?.code],
+      ["theme", player.controls?.theme]
+    ]],
+    ["interaction", [
+      ["zoom", player.interaction?.zoom],
+      ["pan", player.interaction?.pan],
+      ["click_to_play", player.interaction?.clickToPlay],
+      ["double_click_to_reset", player.interaction?.doubleClickToReset],
+      ["keyboard", player.interaction?.keyboard]
+    ]],
+    ["chrome", [
+      ["badge", player.chrome?.badge],
+      ["progress", player.chrome?.progress],
+      ["color", player.chrome?.progressColor]
+    ]]
+  ];
+  const lines = ["player:"];
+  for (const [group, settings] of groups) {
+    const configured = settings.filter(([, value]) => value !== void 0);
+    if (configured.length === 0) continue;
+    lines.push(`  ${group}:`);
+    for (const [key, value] of configured) {
+      const formatted = typeof value === "string" && key !== "progress" ? JSON.stringify(value) : String(value);
+      lines.push(`    ${key} ${formatted}`);
+    }
+  }
+  return lines.length > 1 ? lines : [];
+}
+function formatStyle(style) {
+  const props = Object.entries(style.props).map(([k, v]) => `${k}=${formatValue(v)}`).join(" ");
+  return `style ${style.name} = ${props}`;
+}
+function formatNode(node) {
+  let line = `${node.kind} ${node.id}`;
+  if (node.label !== node.id && node.label) line += ` ${JSON.stringify(node.label)}`;
+  if (node.style) line += ` style=${node.style}`;
+  const extraProps = Object.entries(node.props).filter(([key]) => key !== "style");
+  for (const [key, value] of extraProps) {
+    line += ` ${key}=${formatValue(value)}`;
+  }
+  return line;
+}
+function formatEdge(edge) {
+  const op = edge.kind === "request" ? "->" : edge.kind === "response" ? "<-" : edge.kind === "event" ? "~>" : "--";
+  const [left, right] = edge.kind === "response" ? [edge.to, edge.from] : [edge.from, edge.to];
+  let chain = `${left} ${op} ${right}`;
+  if (edge.label) chain += ` ${JSON.stringify(edge.label)}`;
+  return `edge ${edge.id}: ${chain}`;
+}
+function formatGroup(group) {
+  const label = group.label ? ` ${JSON.stringify(group.label)}` : "";
+  return `group ${group.id}${label}: ${group.members.join(" ")}`;
+}
+function formatBeat(beat) {
+  const label = beat.label ? ` ${JSON.stringify(beat.label)}` : "";
+  const lines = [`beat ${beat.name}${label}:`];
+  for (const cue of beat.cues) {
+    lines.push(`  ${formatCue(cue)}`);
+  }
+  return lines.join("\n");
+}
+function formatCue(cue) {
+  if (cue.kind === "parallel") {
+    return cue.cues.map(formatCue).join(" & ");
+  }
+  if (cue.kind === "flow") {
+    let chain = "";
+    for (let i = 0; i < cue.segments.length; i++) {
+      const seg = cue.segments[i];
+      const op = seg.op === "request" ? "->" : seg.op === "response" ? "<-" : seg.op === "event" ? "~>" : "--";
+      const [left, right] = seg.op === "response" ? [seg.to, seg.from] : [seg.from, seg.to];
+      if (i === 0) chain += left;
+      chain += ` ${op} ${right}`;
+      if (seg.label) chain += ` ${JSON.stringify(seg.label)}`;
+    }
+    if (cue.dur !== void 0) chain += ` dur=${cue.dur}s`;
+    return chain;
+  }
+  if (cue.kind === "show" || cue.kind === "hide") {
+    let line = `${cue.kind} ${cue.targets.join(" ")}`;
+    if (cue.kind === "show" && cue.stagger !== void 0) line += ` stagger=${cue.stagger}s`;
+    if (cue.dur !== void 0) line += ` dur=${cue.dur}s`;
+    return line;
+  }
+  if (cue.kind === "glow") {
+    let line = `glow ${cue.targets.join(" ")}`;
+    if (cue.color) line += ` color=${cue.color}`;
+    if (cue.strength !== void 0) line += ` strength=${cue.strength}`;
+    if (cue.dur !== void 0) line += ` dur=${cue.dur}s`;
+    return line;
+  }
+  if (cue.kind === "focus") {
+    let line = `focus ${cue.targets.join(" ")}`;
+    if (cue.zoom !== void 0) line += ` zoom=${cue.zoom}`;
+    if (cue.dur !== void 0) line += ` dur=${cue.dur}s`;
+    return line;
+  }
+  if (cue.kind === "frame") {
+    let line = `frame ${cue.targets.join(" ")}`;
+    if (cue.zoom !== void 0) line += ` zoom=${cue.zoom}`;
+    if (cue.dur !== void 0) line += ` dur=${cue.dur}s`;
+    return line;
+  }
+  if (cue.kind === "use") {
+    const args = Object.entries(cue.args).map(([k, v]) => k.startsWith("__pos_") ? v : `${k}=${v}`).join(", ");
+    return `use ${cue.pattern}(${args})`;
+  }
+  return "";
+}
+function formatValue(value) {
+  if (typeof value === "number") return String(value);
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
 export {
   ARCH_RULE_PRESETS,
   BEAT_CUE_KEYWORDS,
@@ -5866,6 +6047,7 @@ export {
   diffDiagramASTs,
   extractDiagramContext,
   findClosestMatch,
+  formatScene,
   generateThemeFromBrand,
   getArchitectureSuggestions,
   getBoxPortPosition,

package/package.json

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