edododraw 0.1.0

package/dist-lib/engine/dsl/tokens.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Token model for the EDodoDraw DSL lexer.
+ *
+ * Design notes (per the language spec §3, §12):
+ *  - Keywords are SOFT: they lex as IDENT and the parser recognizes them by
+ *    text in head position. This keeps the token set small and lets ids like
+ *    `focus` or `label` be used as node ids in non-keyword positions.
+ *  - The lexer is PERMISSIVE: it never throws. Unknown characters become a
+ *    SYMBOL token so shape-sugar innards (captured raw by the parser via source
+ *    offsets) don't crash lexing.
+ *  - Every token keeps byte offsets + line/col for diagnostics and for the
+ *    parser's raw shape-sugar capture.
+ */
+export declare enum T {
+    Newline = "Newline",
+    Semi = "Semi",
+    Ident = "Ident",
+    String = "String",
+    Raw = "Raw",// triple-quoted / mermaid body
+    Number = "Number",// value + optional unit
+    Color = "Color",
+    Bool = "Bool",
+    TokenRef = "TokenRef",// $name
+    TripleColon = "TripleColon",// :::
+    EdgeOp = "EdgeOp",
+    At = "At",// @
+    Amp = "Amp",// &
+    Pipe = "Pipe",// |
+    Colon = "Colon",
+    Comma = "Comma",
+    Dot = "Dot",
+    Slash = "Slash",
+    Eq = "Eq",
+    LBrace = "LBrace",
+    RBrace = "RBrace",
+    LBracket = "LBracket",
+    RBracket = "RBracket",
+    LParen = "LParen",
+    RParen = "RParen",
+    Symbol = "Symbol",// any other single char (permissive)
+    EOF = "EOF"
+}
+export interface Token {
+    kind: T;
+    /** Raw lexeme text (for STRING/RAW: the decoded content). */
+    text: string;
+    /** Numeric value for Number tokens. */
+    num?: number;
+    /** Unit suffix for Number tokens: px % deg rad turn ms s pt em fr x. */
+    unit?: string | null;
+    /** For Bool tokens. */
+    bool?: boolean;
+    /** For TokenRef: the name without `$`. For Raw: an optional tag. */
+    name?: string;
+    start: number;
+    end: number;
+    line: number;
+    col: number;
+}
+/** Edge operator glyphs, longest-first for maximal-munch matching. */
+export declare const EDGE_GLYPHS: string[];
+/** Soft keyword sets used by the parser (not the lexer). */
+export declare const KEYWORDS: Set<string>;
+export declare const SHAPE_KEYWORDS: Set<string>;
+export declare const LAYOUT_KEYWORDS: Set<string>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist-lib/engine/dsl/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/engine/dsl/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oBAAY,CAAC;IACX,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,GAAG,QAAQ,CAAE,+BAA+B;IAC5C,MAAM,WAAW,CAAE,wBAAwB;IAC3C,KAAK,UAAU;IACf,IAAI,SAAS;IACb,QAAQ,aAAa,CAAE,QAAQ;IAC/B,WAAW,gBAAgB,CAAE,MAAM;IACnC,MAAM,WAAW;IACjB,EAAE,OAAO,CAAE,IAAI;IACf,GAAG,QAAQ,CAAE,IAAI;IACjB,IAAI,SAAS,CAAE,IAAI;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,EAAE,OAAO;IACT,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW,CAAE,qCAAqC;IACxD,GAAG,QAAQ;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uBAAuB;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sEAAsE;AACtE,eAAO,MAAM,WAAW,EAAE,MAAM,EAmB/B,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,aAKnB,CAAC;AAEH,eAAO,MAAM,cAAc,aAKzB,CAAC;AAEH,eAAO,MAAM,eAAe,aAE1B,CAAC"}

package/dist-lib/engine/export.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Export helpers: turn the live diagram into a self-contained SVG (with the
+ * hand-drawn font embedded as base64 so it renders anywhere), a PNG raster, the
+ * raw scene JSON, or the source code. All framing uses the scene's content
+ * bbox, independent of the current camera.
+ */
+import type { Scene } from "./scene/types.js";
+import type { SvgRenderer } from "./render/svgRenderer.js";
+export interface ExportOptions {
+    padding?: number;
+    embedFont?: boolean;
+    scale?: number;
+    background?: string | null;
+}
+/** Build a standalone SVG string of the whole scene at content coordinates. */
+export declare function exportSVGString(renderer: SvgRenderer, scene: Scene, opts?: ExportOptions): Promise<string>;
+export declare function exportPNGBlob(renderer: SvgRenderer, scene: Scene, opts?: ExportOptions): Promise<Blob>;
+export declare function download(filename: string, data: Blob | string, type?: string): void;
+export declare function downloadSVG(renderer: SvgRenderer, scene: Scene): Promise<void>;
+export declare function downloadPNG(renderer: SvgRenderer, scene: Scene): Promise<void>;
+export declare function downloadJSON(scene: Scene): void;
+//# sourceMappingURL=export.d.ts.map

package/dist-lib/engine/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/engine/export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAY3D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,+EAA+E;AAC/E,wBAAsB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CpH;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhH;AAWD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,SAAe,GAAG,IAAI,CAUzF;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE/C"}

package/dist-lib/engine/geometry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Geometry primitives shared across the engine.
+ * All engine coordinates are in "world" space (unbounded, y-down) unless a
+ * function name says otherwise. The camera converts world <-> screen.
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Size {
+    w: number;
+    h: number;
+}
+/** Axis-aligned rectangle by top-left corner + size. */
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Axis-aligned bounding box by extents. */
+export interface BBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+export declare const clamp: (v: number, lo: number, hi: number) => number;
+export declare const lerp: (a: number, b: number, t: number) => number;
+export declare const dist: (a: Point, b: Point) => number;
+export declare const rectCenter: (r: Rect) => Point;
+export declare const rectToBBox: (r: Rect) => BBox;
+export declare const bboxToRect: (b: BBox) => Rect;
+export declare const bboxCenter: (b: BBox) => Point;
+export declare const bboxSize: (b: BBox) => Size;
+export declare const emptyBBox: () => BBox;
+export declare const isEmptyBBox: (b: BBox) => boolean;
+export declare const bboxUnion: (a: BBox, b: BBox) => BBox;
+export declare const bboxOfPoints: (points: Point[]) => BBox;
+export declare const expandBBox: (b: BBox, pad: number) => BBox;
+export declare const pointInRect: (p: Point, r: Rect) => boolean;
+/**
+ * Intersection of the segment from the rect center toward `target` with the
+ * rect border. Used to make an edge touch a node's border instead of its
+ * center. Returns the border point (falls back to center if degenerate).
+ */
+export declare const borderPointToward: (r: Rect, target: Point) => Point;
+/**
+ * Border point for an ellipse toward a target (used for ellipse/circle nodes so
+ * edges meet the curve, not the bounding rect).
+ */
+export declare const ellipseBorderToward: (r: Rect, target: Point) => Point;
+/** Deterministic 32-bit hash of a string — used for stable rough.js seeds. */
+export declare const hashString: (s: string) => number;
+//# sourceMappingURL=geometry.d.ts.map

package/dist-lib/engine/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/engine/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wDAAwD;AACxD,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4CAA4C;AAC5C,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,KAAG,MAC3B,CAAC;AAEhC,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAyB,CAAC;AAEjF,eAAO,MAAM,IAAI,GAAI,GAAG,KAAK,EAAE,GAAG,KAAK,KAAG,MAA0C,CAAC;AAErF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,KAAiD,CAAC;AAEvF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAKnC,CAAC;AAEH,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAKnC,CAAC;AAEH,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,KAGnC,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,GAAG,IAAI,KAAG,IAGjC,CAAC;AAEH,eAAO,MAAM,SAAS,QAAO,IAK3B,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,GAAG,IAAI,KAAG,OAC0B,CAAC;AAEjE,eAAO,MAAM,SAAS,GAAI,GAAG,IAAI,EAAE,GAAG,IAAI,KAAG,IAK3C,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,QAAQ,KAAK,EAAE,KAAG,IAS9C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,EAAE,KAAK,MAAM,KAAG,IAKhD,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,GAAG,KAAK,EAAE,GAAG,IAAI,KAAG,OACkB,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,KAAG,KAY1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,KAAG,KAU5D,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,MAOtC,CAAC"}

package/dist-lib/engine/import/mermaid.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Mermaid import — converts a mermaid diagram string into EDodoDraw Scene IR
+ * fragments (nodes + edges) via @excalidraw/mermaid-to-excalidraw. Node ids are
+ * preserved (mermaid ids like `grafana`), so the timeline/annotate layers can
+ * reference imported elements directly.
+ *
+ * Runs in the browser only (mermaid renders to a hidden SVG). The pure DSL
+ * compiler stays synchronous; the app awaits this and injects the result.
+ */
+import type { SceneEdge, SceneNode } from "../scene/types.js";
+export interface MermaidFragment {
+    nodes: SceneNode[];
+    edges: SceneEdge[];
+}
+/** Convert a mermaid definition into Scene IR fragments. */
+export declare function convertMermaid(definition: string, mode?: "light" | "dark"): Promise<MermaidFragment>;
+/**
+ * Merge a mermaid fragment into a scene. If a node id already exists (e.g. a
+ * `grafana:::signal` class-application placeholder), keep its cascaded style but
+ * adopt the mermaid geometry/shape/label.
+ */
+export declare function injectMermaid(scene: import("../scene/types.js").Scene, frag: MermaidFragment): void;
+/** Extract `mermaid """ … """` block bodies from EDodoDraw source. */
+export declare function extractMermaidBlocks(source: string): string[];
+//# sourceMappingURL=mermaid.d.ts.map

package/dist-lib/engine/import/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/engine/import/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAC;AAiCzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAeD,4DAA4D;AAC5D,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,GAAG,MAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsEnH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAkBnG;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D"}

package/dist-lib/engine/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Public engine barrel. The app (and any embedder) imports from here.
+ */
+import "./plugins/builtins.js";
+export * from "./geometry.js";
+export * from "./scene/types.js";
+export * from "./scene/palette.js";
+export * from "./scene/defaults.js";
+export * from "./scene/anchors.js";
+export * from "./scene/query.js";
+export { SvgRenderer } from "./render/svgRenderer.js";
+export type { CameraTransform } from "./render/svgRenderer.js";
+export { ensureEngineStyles, FONT_FAMILY } from "./render/theme.css.js";
+export { cameraForBBox, cameraForCenter } from "./camera/fit.js";
+export { CameraController } from "./camera/controller.js";
+export type { MoveOptions } from "./camera/controller.js";
+export { EASINGS, easingByName } from "./camera/easing.js";
+export { AnnotationLayer } from "./annotate/layer.js";
+export { LiveAnnotationController } from "./annotate/interact.js";
+export type { Tool, LiveState } from "./annotate/interact.js";
+export { hitTestNode } from "./scene/query.js";
+export { TimelinePlayer } from "./timeline/player.js";
+export type { PlayerState } from "./timeline/player.js";
+export { applyLayout } from "./layout/index.js";
+export { compileEdd } from "./dsl/index.js";
+export type { CompileEddResult } from "./dsl/index.js";
+export { DiagnosticBag, formatDiagnostic } from "./dsl/diagnostics.js";
+export type { Diagnostic } from "./dsl/diagnostics.js";
+export { downloadSVG, downloadPNG, downloadJSON, exportSVGString, exportPNGBlob } from "./export.js";
+export { registerShape, getShapePlugin, listShapePlugins } from "./plugins/registry.js";
+export type { ShapePluginFn } from "./plugins/registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist-lib/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,uBAAuB,CAAC;AAE/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist-lib/engine/layout/dag.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Directed-acyclic (layered) layout via dagre.
+ *
+ * dagre works in CENTRE coordinates; the Scene IR stores TOP-LEFT, so read-back
+ * subtracts half the node size. Scene groups become dagre compound clusters so
+ * that grouped members are kept adjacent in the final layering.
+ */
+import type { Scene, SceneNode } from "../scene/types.js";
+export type RankDir = "TB" | "BT" | "LR" | "RL";
+export interface DagOptions {
+    /** dagre rank direction. */
+    rankdir: RankDir;
+    /** Separation between nodes in the same rank (px). */
+    nodesep: number;
+    /** Separation between ranks (px). */
+    ranksep: number;
+    /** Graph margin on both axes (px). */
+    margin: number;
+}
+/**
+ * Lay out the given `movable` nodes with dagre and write their top-left x/y.
+ *
+ * Only nodes in `movable` are fed to the graph (pinned nodes are excluded by
+ * the caller). Edges are included only when both endpoints are real nodes that
+ * are present in the graph. Throws if dagre returns a non-finite position so
+ * the caller can fall back to another layout.
+ */
+export declare function layoutDag(scene: Scene, movable: SceneNode[], opts: DagOptions): void;
+//# sourceMappingURL=dag.d.ts.map

package/dist-lib/engine/layout/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../../src/engine/layout/dag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA+DpF"}

package/dist-lib/engine/layout/grid.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Grid layout — arrange nodes on a uniform square grid, row-major.
+ *
+ * Columns = ceil(sqrt(n)). The cell is a square sized to the largest single
+ * node dimension (width OR height) plus the gap, so neighbouring cells can
+ * never overlap regardless of how the nodes are shaped. Each node is centred
+ * inside its cell, which keeps mixed-size grids visually aligned.
+ */
+import type { SceneNode } from "../scene/types.js";
+/** Lay `nodes` out on a grid, mutating each node's top-left x/y in place. */
+export declare function layoutGrid(nodes: SceneNode[], gap: number): void;
+//# sourceMappingURL=grid.d.ts.map

package/dist-lib/engine/layout/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/engine/layout/grid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAsBhE"}

package/dist-lib/engine/layout/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auto-layout — assigns world positions to a Scene's nodes.
+ *
+ * `applyLayout(scene)` reads `scene.meta.layout` and mutates each non-pinned
+ * node's top-left `x`/`y` in place. Supported modes:
+ *
+ *   - "dag" / "dag-lr" / "dag-rl" / "dag-bt" — layered graph layout via dagre
+ *   - "grid"   — uniform square grid, row-major
+ *   - "radial" — hub node at origin, the rest on a circle
+ *   - "manual" — no-op (author already positioned everything)
+ *
+ * Cross-cutting rules:
+ *   - Any node with `pinned === true` is a fixed obstacle: it is excluded from
+ *     every auto-layout mode and its coordinates are never changed.
+ *   - The function never throws. If dagre fails (or a graph is empty/degenerate)
+ *     it falls back to grid; an empty scene is a no-op.
+ *   - After arranging, the laid-out nodes are shifted so their bounding box
+ *     starts at a small positive margin (~40,40). Pinned nodes anchor an
+ *     absolute frame and are not shifted; when nothing is pinned this is
+ *     exactly "translate the whole diagram".
+ *
+ * The public surface is `applyLayout`; per-mode maths lives in dag/grid/radial.
+ */
+import type { Scene } from "../scene/types.js";
+/**
+ * Assign positions to `scene.nodes` according to `scene.meta.layout`.
+ * Mutates node `x`/`y` (top-left, world space) in place. Never throws.
+ */
+export declare function applyLayout(scene: Scene): void;
+//# sourceMappingURL=index.d.ts.map

package/dist-lib/engine/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAc,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAuBtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAqB9C"}

package/dist-lib/engine/layout/radial.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Radial layout — a hub node at the world origin with the remaining nodes
+ * distributed evenly around a circle.
+ *
+ * The hub is either the node whose id matches the requested `centerId`, or the
+ * first node when no match is found. Ring radius = max(radiusFloor, n * 40),
+ * which grows the circle as the node count rises so labels stay legible.
+ */
+import type { SceneNode } from "../scene/types.js";
+/**
+ * Place `nodes` radially, mutating each node's top-left x/y in place.
+ *
+ * @param nodes       nodes to arrange (hub + ring)
+ * @param centerId    preferred hub node id; falls back to the first node
+ * @param radiusFloor minimum ring radius in world px
+ */
+export declare function layoutRadial(nodes: SceneNode[], centerId: string | undefined, radiusFloor?: number): void;
+//# sourceMappingURL=radial.d.ts.map

package/dist-lib/engine/layout/radial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radial.d.ts","sourceRoot":"","sources":["../../../src/engine/layout/radial.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,SAAM,GAChB,IAAI,CA4BN"}

package/dist-lib/engine/plugins/builtins.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Built-in plugin shapes — also a worked example of how a senior engineer adds
+ * a new shape without touching the renderer's core switch.
+ *
+ * Registration is exposed as an idempotent function AND called from the
+ * renderer on mount, so the built-ins survive a tree-shaking library build
+ * (a bare side-effect import can be dropped by bundlers when nothing "uses" it).
+ */
+export declare function registerBuiltinShapes(): void;
+//# sourceMappingURL=builtins.d.ts.map

package/dist-lib/engine/plugins/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,wBAAgB,qBAAqB,IAAI,IAAI,CAoB5C"}

package/dist-lib/engine/plugins/registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Plugin registries — the extension seams that make EDodoDraw "much more
+ * extendible than Excalidraw". A plugin registers a named renderer for a shape
+ * (or, later, an arrow animation / annotation kind) and it becomes usable from
+ * the DSL immediately (`shape: myshape` or the keyword), with no grammar change.
+ *
+ * The Scene IR types are open unions, so the compiler already accepts unknown
+ * names; the renderer resolves them here.
+ */
+import type rough from "roughjs";
+import type { NodeStyle, ShapeKind } from "../scene/types.js";
+import type { ShapeRect } from "../render/shapes.js";
+type RoughSVG = ReturnType<(typeof rough)["svg"]>;
+export type ShapePluginFn = (rc: RoughSVG, rect: ShapeRect, style: NodeStyle) => SVGGElement;
+export declare function registerShape(name: string, fn: ShapePluginFn): void;
+export declare function getShapePlugin(name: ShapeKind): ShapePluginFn | undefined;
+export declare function listShapePlugins(): string[];
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist-lib/engine/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,KAAK,QAAQ,GAAG,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,WAAW,CAAC;AAI7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAEzE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist-lib/engine/render/edges.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Edge geometry + rendering.
+ *
+ * An edge is drawn as:
+ *   1. a hand-drawn (rough.js) base stroke following the routed centerline,
+ *   2. optional arrowheads at each end (rough, matched to the stroke),
+ *   3. an optional CLEAN overlay <path> that carries the animation
+ *      (flow / dash-march / draw-on / comet / gradient-flow / pulse / electric),
+ *   4. an optional label chip at the midpoint.
+ *
+ * The clean overlay follows the exact same centerline so animations read as
+ * "energy flowing along the drawn line".
+ */
+import type rough from "roughjs";
+import type { Options } from "roughjs/bin/core";
+import type { Point } from "../geometry.js";
+import type { EdgeStyle, Scene, SceneEdge } from "../scene/types.js";
+type RoughSVG = ReturnType<(typeof rough)["svg"]>;
+export declare function edgeRoughOptions(style: EdgeStyle): Options;
+/** Resolve the two endpoints of an edge in world space, border-aware. */
+export declare function resolveEndpoints(scene: Scene, edge: SceneEdge): {
+    a: Point;
+    b: Point;
+};
+/** Build the routed polyline (world points) for an edge. */
+export declare function routePoints(edge: SceneEdge, a: Point, b: Point): Point[];
+/** SVG path `d` for the clean overlay following the same routed points. */
+export declare function centerlinePath(points: Point[], routing: SceneEdge["routing"]): string;
+export interface RenderedEdge {
+    group: SVGGElement;
+    points: Point[];
+    centerline: string;
+    length: number;
+}
+export declare function pathLength(points: Point[]): number;
+/**
+ * Render one edge into a <g>. `animId` uniquely identifies the animation
+ * overlay so we can wire per-edge gradients/keyframes.
+ */
+export declare function renderEdge(rc: RoughSVG, scene: Scene, edge: SceneEdge): RenderedEdge;
+export {};
+//# sourceMappingURL=edges.d.ts.map

package/dist-lib/engine/render/edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../../src/engine/render/edges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErE,KAAK,QAAQ,GAAG,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAGlD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAW1D;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG;IAAE,CAAC,EAAE,KAAK,CAAC;IAAC,CAAC,EAAE,KAAK,CAAA;CAAE,CAetF;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAkCxE;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,CAyBrF;AA6PD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAIlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,YAAY,CAqCpF"}