@markdy/core 1.0.23 → 1.0.25

package/README.md

@@ -4,10 +4,12 @@ The parser and AST types for [MarkdyScript](../../docs/SYNTAX.md) — a diagram-
 
 ## Features
 
-- **Zero runtime dependencies** — pure TypeScript, no DOM or platform APIs
-- **Single-pass parser** — line-by-line state machine with strict `ParseError` diagnostics
-- **Diagram-native grammar** — scene metadata, architecture nodes, groups, styles, beats, flow chains, annotations, visual primitives, and reusable patterns
-- **Focused modes** — `architecture`, `flowchart`, `tree`, `state`, `sequence`, and `constellation` compile into deterministic render-plan metadata
+- **Zero runtime dependencies** — pure TypeScript, no DOM or platform APIs (~14 KB minzipped)
+- **Single-pass parser** — line-by-line state machine with strict `ParseError` line-number diagnostics
+- **17 Specialized Layout Engines** — `architecture`, `flowchart`, `tree`, `sequence`, `state`, `layers`, `nested`, `swimlane`, `timeline`, `gantt`, `medallion`, `flywheel`, `constellation`, `quadrant`, `pyramid`, `radar`, `venn`
+- **8 Semantic Themes** — `paper`, `editorial`, `midnight`, `blueprint`, `graphite`, `nebula`, `terminal`, `sketchy`
+- **Content-Adaptive Canvas Sizing** — automatically calculates optimal aspect ratio and bounds based on diagram items and topology
+- **Well-Architected Governance & AST Diffing** — layer boundaries, deadlock cycle detection, gateway isolation, and semantic AST evolution
 - **Isomorphic** — runs in Node.js, Deno, Bun, edge runtimes, and the browser
 
 ## Installation
@@ -27,7 +29,14 @@ pnpm add @markdy/core
 ## Output preview
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/HoangYell/markdy-com/main/website/public/images/markdy-split-editor.webp" alt="Markdy AST & DSL Editor Preview" width="900" />
+  <a href="https://markdy.com/playground/">
+    <img src="https://raw.githubusercontent.com/HoangYell/markdy-com/main/website/public/images/scene-url-shortener.webp" alt="Markdy Core Parser Architecture Preview" width="900" />
+  </a>
+</p>
+<p align="center">
+  <a href="https://markdy.com/playground/">
+    <img src="https://raw.githubusercontent.com/HoangYell/markdy-com/main/website/public/images/scene-concurrency-decision-flowchart.webp" alt="Markdy Concurrency Flowchart Preview" width="900" />
+  </a>
 </p>
 
 ## Usage
@@ -72,10 +81,11 @@ try {
 | `RenderPlan` | type | Positioned nodes, routed edges, group zones, sequence messages, timed cues, beat ranges |
 | `SceneMeta` | type | Scene configuration; `meta.player` is authoritative, with deprecated flat mirrors retained for compatibility |
 | `PlayerConfig` / `resolvePlayer` | type / function | Grouped playback, controls, interaction, and chrome configuration with host resolution |
-| `NodeDecl` | type | Node declaration (kind, id, label, style) |
-| `EdgeDecl` | type | Edge declaration (kind, from, to, label) |
-| `BeatDecl` | type | Named beat with cues |
-| `THEMES` / `resolveTheme` | tokens | Semantic theme palettes (`paper`, `editorial`, `nebula`, `midnight`, `blueprint`, `graphite`) |
+| `generateThemeFromBrand` | `(hexColor, name?) => { light, dark }` | Generate WCAG-compliant light and dark theme palettes from any brand hex color |
+| `validateArchitectureRules` | `(ast) => Diagnostic[]` | Run Well-Architected rules: cycle detection, layer boundaries, and gateway checks |
+| `diffAST` | `(astA, astB) => ASTDiffResult` | Compare architecture versions, calculate diff metrics, and generate migration scenes |
+| `compressUrlState` / `decompressUrlState` | `(code, opts?) => string` | Zero-dependency URL hash state encoder for shareable playground links |
+| `THEMES` / `resolveTheme` | tokens / function | 8 Semantic theme palettes (`paper`, `editorial`, `nebula`, `midnight`, `blueprint`, `graphite`, `terminal`, `sketchy`) |
 
 ## Documentation
 

package/dist/index.js

@@ -995,7 +995,7 @@ function layoutRanked(ast, edges, opts) {
     return nodes;
   }
   const maxPossibleStep = rankCount > 1 ? (contentW - NODE_W) / (rankCount - 1) : 0;
-  const colGap = rankCount > 1 ? Math.min(220, Math.max(50, maxPossibleStep)) : 0;
+  const colGap = rankCount > 1 ? Math.min(300, Math.max(50, maxPossibleStep)) : 0;
   const totalW = (rankCount - 1) * colGap + NODE_W;
   const startX = SAFE + Math.max(0, (contentW - totalW) / 2);
   for (const [rank, ids] of [...byRank.entries()].sort((a, b) => a[0] - b[0])) {
@@ -1622,10 +1622,12 @@ function layoutLayers(ast) {
 function layoutNested(ast) {
   const nodeIds = Object.keys(ast.nodes);
   if (nodeIds.length === 0) return [];
+  const topHeadroom = 20;
+  const startY = TITLE_BAND + topHeadroom;
   const contentW = ast.meta.width - SAFE * 2;
-  const contentH = ast.meta.height - SAFE - TITLE_BAND - SAFE;
+  const contentH = ast.meta.height - startY - SAFE;
   const centerX = SAFE + contentW / 2;
-  const centerY = TITLE_BAND + contentH / 2;
+  const centerY = startY + contentH / 2;
   const N = nodeIds.length;
   const padX = Math.min(54, contentW * 0.42 / Math.max(N, 1));
   const padY = Math.min(48, contentH * 0.42 / Math.max(N, 1));
@@ -1641,7 +1643,7 @@ function layoutNested(ast) {
       y = centerY - h / 2 + (N > 1 ? 16 : 0);
     } else {
       x = SAFE + idx * padX;
-      y = TITLE_BAND + idx * padY;
+      y = startY + idx * padY;
       w = contentW - idx * padX * 2;
       h = contentH - idx * padY * 2;
     }

package/package.json

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