@dxos/diagram 0.11.1 → 0.13.0

package/dist/types/src/dsl/vocabulary.d.ts

@@ -0,0 +1,61 @@
+/** Element kinds as the DSL spells them; each is also the scene element's `kind`. */
+export declare const ELEMENT_KINDS: readonly ["rect", "ellipse", "diamond", "triangle", "circle", "line", "curve", "arc", "text", "arrow", "portal"];
+export type ElementKind = (typeof ELEMENT_KINDS)[number];
+/** Statements that state intent and leave layout to the engine. */
+export declare const SEMANTIC_KEYWORDS: readonly ['diagram', 'group', 'node', 'edge'];
+/** Statement keywords. */
+export declare const STATEMENT_KEYWORDS: readonly ["object", "elements", "move", "remove", "diagram", "group", "node", "edge"];
+/** Keywords inside semantic statements: `@cell(c,r)`, `via …`, `bus`, `compact`. */
+export declare const CLAUSE_KEYWORDS: readonly ['cell', 'via', 'bus', 'compact'];
+/**
+ * Words the grammar reserves, so the printer knows to quote an id that collides with one.
+ * `_` is reserved too: it is the unbound arrow end.
+ */
+export declare const RESERVED: ReadonlySet<string>;
+/** Attribute value shapes; `enum` carries the literals the schema allows, `size` is `WxH`, `ratio` is `W:H`. */
+export type AttrType = {
+    type: 'number';
+} | {
+    type: 'string';
+} | {
+    type: 'boolean';
+} | {
+    type: 'size';
+} | {
+    type: 'ratio';
+} | {
+    type: 'enum';
+    values: readonly string[];
+};
+export type AttrSpec = AttrType & {
+    name: string;
+};
+/**
+ * Attributes each element kind accepts, in the order they print. Geometry and the label are
+ * positional, so the schema's `x`/`y`/`w`/`h`/`points`/`text` do not appear here — except
+ * `text`'s wrap width, which the schema also calls `w`.
+ */
+export declare const ELEMENT_ATTRS: Record<ElementKind, readonly AttrSpec[]>;
+/** Object attributes other than `@ <origin>`, in the order they print. */
+export declare const OBJECT_ATTRS: readonly AttrSpec[];
+/** `diagram` attributes. */
+export declare const DIAGRAM_ATTRS: readonly AttrSpec[];
+/** `group` attributes. */
+export declare const GROUP_ATTRS: readonly AttrSpec[];
+/** `node` attributes. */
+export declare const NODE_ATTRS: readonly AttrSpec[];
+/** `edge` attributes. */
+export declare const EDGE_ATTRS: readonly AttrSpec[];
+/** Placement relations a `node` or `group` may state; `~` before one makes it a preference. */
+export declare const RELATION_WORDS: readonly string[];
+/** An id that needs no quoting: a bare word that is not reserved. */
+export declare const BARE_ID: RegExp;
+/** A ref that needs no quoting: every segment is a bare word. */
+export declare const BARE_REF: RegExp;
+/**
+ * A structurally valid ref — `[object/]element[#port]`, as `Scene.parseRef` reads it, whose ids may
+ * not contain `/` or `#`. Separate from {@link BARE_REF} because quoting exists to carry a ref
+ * whose ids cannot lex bare (`1st/box` from a numeric node id), which is well-formed all the same.
+ */
+export declare const REF_SHAPE: RegExp;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/types/src/dsl/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../../src/dsl/vocabulary.ts"],"names":[],"mappings":"AAeA,qFAAqF;AACrF,eAAO,MAAM,aAAa,kHAShB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,YAAI,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAE/E,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,uFAA0E,CAAC;AAE1G,oFAAoF;AACpF,eAAO,MAAM,eAAe,YAAI,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAU,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,MAAM,CAKvC,CAAC;AAEH,gHAAgH;AAChH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAenD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,CAiBlE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EAI3C,CAAC;AAEF,4BAA4B;AAC5B,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAK5C,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,WAAW,EAAE,SAAS,QAAQ,EAI1C,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAMzC,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAKzC,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAA4B,CAAC;AAEzE,qEAAqE;AACrE,eAAO,MAAM,OAAO,QAA8B,CAAC;AAEnD,iEAAiE;AACjE,eAAO,MAAM,QAAQ,QAAqF,CAAC;AAE3G;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAkC,CAAC"}

package/dist/types/src/dx-svg.d.ts

@@ -0,0 +1,12 @@
+/** The container format; versions the slot and encoding, not the payload, which versions itself. */
+export declare const FORMAT = "org.dxos.dx-svg@1";
+/** Embeds a payload in a standalone SVG: a marker on the root and the payload as its first child. */
+export declare const embed: (svg: string, payload: unknown) => string;
+/** Whether an SVG carries a payload, without parsing it. */
+export declare const isDxSvg: (svg: string) => boolean;
+/**
+ * The payload of a `.dx.svg`, or undefined for a plain SVG. Works on the text alone, so it runs in node,
+ * workers and the browser. An encoding this version does not know is an error, not a missing payload.
+ */
+export declare const extract: (svg: string) => unknown;
+//# sourceMappingURL=dx-svg.d.ts.map

package/dist/types/src/dx-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dx-svg.d.ts","sourceRoot":"","sources":["../../../src/dx-svg.ts"],"names":[],"mappings":"AAYA,oGAAoG;AACpG,eAAO,MAAM,MAAM,sBAAsB,CAAC;AA+B1C,qGAAqG;AACrG,eAAO,MAAM,KAAK,QAAS,MAAM,WAAW,OAAO,KAAG,MAWrD,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,OAAwD,CAAC;AAE/F;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,OAWrC,CAAC"}

package/dist/types/src/dx-svg.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dx-svg.test.d.ts.map

package/dist/types/src/dx-svg.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dx-svg.test.d.ts","sourceRoot":"","sources":["../../../src/dx-svg.test.ts"],"names":[],"mappings":""}

package/dist/types/src/extension/complete.d.ts

@@ -0,0 +1,3 @@
+import { type Extension } from '@codemirror/state';
+export declare const diagramComplete: Extension;
+//# sourceMappingURL=complete.d.ts.map

package/dist/types/src/extension/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../src/extension/complete.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAkGnD,eAAO,MAAM,eAAe,EAAE,SAAkD,CAAC"}

package/dist/types/src/extension/extension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension.test.d.ts.map

package/dist/types/src/extension/extension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.test.d.ts","sourceRoot":"","sources":["../../../../src/extension/extension.test.ts"],"names":[],"mappings":""}

package/dist/types/src/extension/highlight.d.ts

@@ -0,0 +1,14 @@
+import { HighlightStyle } from '@codemirror/language';
+/**
+ * Fills the gaps the editor's own highlight style leaves. The grammar emits standard
+ * `@lezer/highlight` tags, so most of a document is coloured by whatever style the theme installs
+ * and inherits its palette — but `vscodeLightStyle`/`vscodeDarkStyle` define neither
+ * `attributeValue` nor `null`, which in this language are the enum values (`grey`, `dashed`,
+ * `triangle`) and the unbound arrow end. Those are the most scannable part of a diagram, so
+ * leaving them uncoloured is the one thing worth overriding.
+ *
+ * Classes are semantic theme tokens rather than hues, as in `mermaidHighlightStyle`, so light and
+ * dark follow the palette.
+ */
+export declare const diagramHighlightStyle: () => HighlightStyle;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/types/src/extension/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../../src/extension/highlight.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,sBAI9B,CAAC"}

package/dist/types/src/extension/index.d.ts

@@ -0,0 +1,6 @@
+export { diagram, diagramBlockDescription } from './language.ts';
+export { type LintOptions, diagramDiagnostics, diagramLint } from './lint.ts';
+export { diagramComplete } from './complete.ts';
+export { diagramHighlightStyle } from './highlight.ts';
+export { diagramLanguage } from './syntax.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extension/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/src/extension/language.d.ts

@@ -0,0 +1,13 @@
+import { LanguageDescription } from '@codemirror/language';
+import { type Extension } from '@codemirror/state';
+import { type LintOptions } from './lint.ts';
+/**
+ * The fence dispatch point. Pass this alongside deus's `mdlBlockDescription` in
+ * `createMarkdownExtensions({ codeLanguages: [...] })` and a ```diagram block inside a `.mdl`
+ * document parses with the diagram grammar — a sibling of MDL's, not a nesting inside it. See
+ * `docs/DSL.md`.
+ */
+export declare const diagramBlockDescription: LanguageDescription;
+/** The whole editing surface for a standalone DSL buffer: mode, highlighting, completion, lint. */
+export declare const diagram: (options?: LintOptions) => Extension;
+//# sourceMappingURL=language.d.ts.map

package/dist/types/src/extension/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../../../src/extension/language.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAuC,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAC;AAG1D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,qBAIlC,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,OAAO,aAAa,WAAW,KAAQ,SAKnD,CAAC"}

package/dist/types/src/extension/lint.d.ts

@@ -0,0 +1,21 @@
+import { type Diagnostic } from '@codemirror/lint';
+import { type Extension } from '@codemirror/state';
+export type LintOptions = {
+    /**
+     * Also report the layout diagnostics — overlaps, a connector through a node, a label that does
+     * not fit. Off by default because a document being typed is briefly nonsense; the bench and the
+     * agent loop both want it on.
+     */
+    layout?: boolean;
+};
+/**
+ * What is wrong with a document: everything `parse` found, and optionally everything
+ * `Diagnostics.analyze` finds in the scene it produced, each carrying the range of the statement
+ * or element that produced it — a layout error is only actionable when it points at the box it is
+ * about. Separate from the CodeMirror wrapper so it needs no editor, which is also how the
+ * agent-facing path reports the same problems.
+ */
+export declare const diagramDiagnostics: (text: string, { layout }?: LintOptions) => Diagnostic[];
+/** The CodeMirror linter over {@link diagramDiagnostics}. */
+export declare const diagramLint: (options?: LintOptions) => Extension;
+//# sourceMappingURL=lint.d.ts.map

package/dist/types/src/extension/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../../src/extension/lint.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,MAAM,MAAM,WAAW,GAAG;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,eAAsB,WAAW,KAAQ,UAAU,EA4BjG,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,aAAa,WAAW,KAAQ,SAC4C,CAAC"}

package/dist/types/src/extension/syntax.d.ts

@@ -0,0 +1,3 @@
+import { LRLanguage } from '@codemirror/language';
+export declare const diagramLanguage: LRLanguage;
+//# sourceMappingURL=syntax.d.ts.map

package/dist/types/src/extension/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../../../../src/extension/syntax.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAYlD,eAAO,MAAM,eAAe,YA6C1B,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,11 +1,24 @@
 export * from './content.ts';
 export * from './dialect.ts';
+export * as Aesthetics from './aesthetics.ts';
+export * as Appeal from './appeal.ts';
+export * as Architecture from './architecture.ts';
 export * as Diagnostics from './diagnostics.ts';
+export * as Dsl from './dsl/index.ts';
+export * as DxSvg from './dx-svg.ts';
 export * as Layout from './layout.ts';
 export * as Mermaid from './mermaid.ts';
 export * as MermaidEngine from './mermaid-engine.ts';
+export * as Nudge from './nudge.ts';
 export * as Objective from './objective.ts';
+export * as Ports from './ports.ts';
+export * as Rules from './rules.ts';
 export * as Scene from './scene.ts';
+export * as Semantic from './semantic.ts';
+export * as SemanticEngine from './semantic-engine.ts';
+export * as SemanticPlace from './semantic-place.ts';
+export * as SemanticRoute from './semantic-route.ts';
+export * as Score from './score.ts';
 export * from './svg-handler.ts';
 export * as Ui from './ui.ts';
 export * as Uml from './uml.ts';
@@ -13,4 +26,5 @@ export * as UmlEngine from './uml-engine.ts';
 export * as UmlGrid from './uml-grid.ts';
 export * as UmlRules from './uml-rules.ts';
 export * as UmlSearch from './uml-search.ts';
+export * as View from './view.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC"}

package/dist/types/src/mermaid-engine.d.ts

@@ -1,6 +1,6 @@
 import * as Objective from './objective.ts';
 import type * as Scene from './scene.ts';
-import { type Router } from './uml-grid.ts';
+import { type Rect, type Router } from './uml-grid.ts';
 /** How ELK orders siblings within a layer. */
 export type Order = 'model' | 'free';
 /**
@@ -48,12 +48,24 @@ export type CompileOptions = {
      * connect through one horizontal bus and a single triangle-headed trunk instead of parallel arrows.
      */
     bus?: readonly boolean[];
+    /**
+     * Compaction candidates (default both): with `true`, packages and boxes slide toward their partners
+     * after placement, closing empty lanes and long detours; see `compact.ts`.
+     */
+    compact?: readonly boolean[];
     /** Objective that picks among candidates (default `Objective.DEFAULT`). */
     objective?: Objective.Objective;
     /** Maximum cell width, in scene units (default GRID × 6); longer labels wrap. */
     maxWidth?: number;
     /** Connector router (default: obstacle-avoiding A* with the Z-router as fallback). */
     route?: Router;
+    /**
+     * Routes one candidate, nearly all of the layout's time (default: on this thread); a caller with
+     * worker threads can run {@link emitJob} there. Each candidate is handed over as soon as it is
+     * placed, so placing the rest overlaps the routing; the candidates are still collected in
+     * generation order. Not used with a custom `route`, which cannot leave the thread.
+     */
+    emitCandidate?: (job: EmitJob) => Promise<Scene.Command[]>;
 };
 /** One generated layout with the objective's verdict on it. */
 export type Candidate = {
@@ -62,6 +74,7 @@ export type Candidate = {
     arrangement: Arrangement;
     layering: Layering;
     alignment: Alignment;
+    compact: boolean;
     bus: boolean;
     commands: Scene.Command[];
     layout: Objective.Layout;
@@ -72,6 +85,31 @@ export type Result = {
     /** Every candidate, best first. */
     ranked: readonly Objective.Ranked<Candidate>[];
 };
+export type Cell = {
+    w: number;
+    h: number;
+};
+export type Placement = {
+    nodes: Map<string, Rect>;
+    frames: Map<string, Rect>;
+};
+type EmitOptions = {
+    origin: Scene.Point;
+    scale: number;
+    bus: boolean;
+    arrangement: Arrangement;
+    route?: Router;
+    /** Run the port local search; costly, so only for the layout already chosen. */
+    search?: boolean;
+};
+/** One candidate's routing, as structured-cloneable data so it can cross to a worker thread. */
+export type EmitJob = Omit<EmitOptions, 'route'> & {
+    source: string;
+    cell: Cell;
+    placement: Placement;
+};
+/** Routes one candidate with the default router; what a worker runs for `CompileOptions.emitCandidate`. */
+export declare const emitJob: ({ source, cell, placement, ...options }: EmitJob) => Scene.Command[];
 /**
  * Lay out a mermaid flowchart: place once per lattice × ordering, emit with and without the
  * inheritance bus, analyze every candidate, and let the objective choose. All candidates come back
@@ -80,4 +118,5 @@ export type Result = {
 export declare const layout: (source: string, options?: CompileOptions) => Promise<Result>;
 /** The chosen layout's scene commands; see {@link layout} for the candidates and verdicts. */
 export declare const compile: (source: string, options?: CompileOptions) => Promise<Scene.Command[]>;
+export {};
 //# sourceMappingURL=mermaid-engine.d.ts.map

package/dist/types/src/mermaid-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-engine.d.ts","sourceRoot":"","sources":["../../../src/mermaid-engine.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AACzC,OAAO,EAAmB,KAAK,MAAM,EAAW,MAAM,eAAe,CAAC;AAsBtE,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAWzC,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACrC,wGAAwG;IACxG,KAAK,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,yFAAyF;IACzF,WAAW,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACjC;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,mCAAmC;IACnC,MAAM,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;CAChD,CAAC;AAmpBF;;;;GAIG;AACH,eAAO,MAAM,MAAM,WAAkB,MAAM,YAAW,cAAc,KAAQ,OAAO,CAAC,MAAM,CAiEzF,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,OAAO,WAAkB,MAAM,YAAW,cAAc,KAAQ,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC"}
+{"version":3,"file":"mermaid-engine.d.ts","sourceRoot":"","sources":["../../../src/mermaid-engine.ts"],"names":[],"mappings":"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"}

package/dist/types/src/mermaid.d.ts

@@ -14,7 +14,7 @@ export type MermaidGroup = {
     children: string[];
 };
 /** Relationship kind, from the edge token; drawn with the UML end markers in `markers`. */
-export type RelationKind = 'reference' | 'inheritance' | 'hasMany' | 'contains';
+export type RelationKind = 'reference' | 'inheritance' | 'implements' | 'hasMany' | 'contains' | 'creates';
 export type MermaidEdge = {
     from: string;
     to: string;
@@ -28,8 +28,8 @@ export type MermaidEdge = {
  * lines are already comments.
  */
 export declare const toStandard: (source: string) => string;
-/** Scene arrow markers for a relationship kind. */
-export declare const markers: (kind: RelationKind) => Pick<Scene.Arrow, 'head' | 'tail'>;
+/** The scene relation a relationship kind draws as, with the dash its line needs; a plain reference stays a plain arrow. */
+export declare const markers: (kind: RelationKind) => Pick<Scene.Arrow, 'relation' | 'stroke'>;
 export type MermaidGraph = {
     direction: Direction;
     nodes: MermaidNode[];

package/dist/types/src/mermaid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/mermaid.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAqBF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,MAO7B,CAAC;AAEhB,mDAAmD;AACnD,eAAO,MAAM,OAAO,SAAU,YAAY,KAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW7E,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAeF,sFAAsF;AACtF,eAAO,MAAM,KAAK,WAAY,MAAM,KAAG,YAwFtC,CAAC;AAgBF,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,YAAW,cAAc,KAAQ,KAAK,CAAC,OAAO,EAiGnF,CAAC"}
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/mermaid.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3G,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA4BF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,MAO7B,CAAC;AAEhB,4HAA4H;AAC5H,eAAO,MAAM,OAAO,SAAU,YAAY,KAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAenF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAgBF,sFAAsF;AACtF,eAAO,MAAM,KAAK,WAAY,MAAM,KAAG,YAwFtC,CAAC;AAgBF,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,YAAW,cAAc,KAAQ,KAAK,CAAC,OAAO,EAiGnF,CAAC"}

package/dist/types/src/nudge.d.ts

@@ -0,0 +1,30 @@
+import type * as Scene from './scene.ts';
+import { type Rect } from './uml-grid.ts';
+type Point = Scene.Point;
+/** A routed connector: its orthogonal polyline and the boxes its ends are attached to. */
+export type NudgePath = {
+    points: readonly Point[];
+    /** Box the first point sits on; without it the start port is never moved. */
+    source?: Rect;
+    /** Box the last point sits on; without it the end port is never moved. */
+    target?: Rect;
+};
+export type NudgeOptions = {
+    /** Gap between separated parallel runs (default 8). */
+    spacing?: number;
+    /** Boxes no run may be pushed through. */
+    obstacles?: readonly Rect[];
+    /** Lines that never move but that paths must not be pushed onto (e.g. an inheritance bus). */
+    fixed?: readonly (readonly Point[])[];
+    /** Minimum distance between a moved port and its box's corner (default `spacing`). */
+    margin?: number;
+};
+/**
+ * Nudging (Wybrow, Marriott & Stuckey 2010): distinct connectors that share a collinear run are
+ * pulled apart across it by `spacing`, ordered so their turn-offs do not cross, with ports sliding
+ * along their box side. Fixed lines (a deliberate bus) never move. Paths that need no change come
+ * back as given.
+ */
+export declare const nudge: (paths: readonly NudgePath[], options?: NudgeOptions) => Point[][];
+export {};
+//# sourceMappingURL=nudge.d.ts.map

package/dist/types/src/nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge.d.ts","sourceRoot":"","sources":["../../../src/nudge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,KAAK,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAMzB,0FAA0F;AAC1F,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAC5B,8FAA8F;IAC9F,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,KAAK,EAAE,CAAC,EAAE,CAAC;IACtC,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAmUF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,UAAW,SAAS,SAAS,EAAE,YAAW,YAAY,KAAQ,KAAK,EAAE,EAwBtF,CAAC"}

package/dist/types/src/nudge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nudge.test.d.ts.map

package/dist/types/src/nudge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge.test.d.ts","sourceRoot":"","sources":["../../../src/nudge.test.ts"],"names":[],"mappings":""}

package/dist/types/src/objective.d.ts

@@ -56,6 +56,10 @@ export declare const noHardDefects: Constraint;
 /** Containers keep at least `gap` between them, so packages read as separate. */
 export declare const framesApart: (gap?: number) => Constraint;
 export declare const crossings: CostTerm;
+/** Labels overlapping other labels or boxes; as costly as a crossing, since either hides what the reader needs. */
+export declare const textOverlaps: CostTerm;
+/** Connector pairs sharing a stretch of line; as costly as a crossing, since the reader cannot pair their ends. */
+export declare const edgeOverlaps: CostTerm;
 export declare const bends: CostTerm;
 /**
  * Uneven gutters between frames, in grid units. Weighted so a whole cell of unevenness costs about

package/dist/types/src/objective.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objective.d.ts","sourceRoot":"","sources":["../../../src/objective.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,WAAW,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAGzC,uDAAuD;AACvD,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,SAAS,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B,CAAC;AAEF,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;CACnD,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,SAAS;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,QAAQ,cAAe,SAAS,UAAU,MAAM,KAAG,UAS/D,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,SAAS,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,aACtC,SAAS,cACR,SAAS,CAAC,EAAE,KACvB;IAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;CAUnD,CAAC;AAOF,uGAAuG;AACvG,eAAO,MAAM,aAAa,EAAE,UAK3B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,WAAW,SAAS,MAAM,KAAU,UAO/C,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,QAKvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,QAKnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAK7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAK7B,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,WAAW,EAAE,QAKzB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,SAGrB,CAAC"}
+{"version":3,"file":"objective.d.ts","sourceRoot":"","sources":["../../../src/objective.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,WAAW,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAGzC,uDAAuD;AACvD,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,SAAS,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B,CAAC;AAEF,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;CACnD,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,SAAS;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,QAAQ,cAAe,SAAS,UAAU,MAAM,KAAG,UAS/D,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,SAAS,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,aACtC,SAAS,cACR,SAAS,CAAC,EAAE,KACvB;IAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;CAUnD,CAAC;AAOF,uGAAuG;AACvG,eAAO,MAAM,aAAa,EAAE,UAK3B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,WAAW,SAAS,MAAM,KAAU,UAO/C,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,QAKvB,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,YAAY,EAAE,QAK1B,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,YAAY,EAAE,QAK1B,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,QAKnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAK7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAK7B,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,WAAW,EAAE,QAKzB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,SAGrB,CAAC"}

package/dist/types/src/ortho-router.d.ts

@@ -1,13 +1,25 @@
+import type * as Scene from './scene.ts';
 import type { Rect, Router } from './uml-grid.ts';
+type Point = Scene.Point;
 export type AvoidingRouterOptions = {
     /** Search-cell size (scene px): a fraction of the layout grid, so routes can hug node borders. */
     step: number;
 };
+/** The avoiding router plus a way to replay an earlier route's footprint without searching again. */
+export type AvoidingRouter = Router & {
+    /**
+     * Marks the cells of a path an avoiding router over the same obstacles returned before as used, as
+     * routing it did; a path that marked nothing (a fallback route) marks nothing, so a replayed prefix
+     * leaves the same state.
+     */
+    reserve: (points: readonly Point[]) => void;
+};
 /**
  * Creates a router that avoids the given node rects. Stateful across edges: earlier routes
  * penalize (not block) the cells they occupy, spreading parallel runs apart. `fallback` handles
  * the (fenced-in) edges the search cannot reach. The step is passed in rather than derived from
  * `uml-grid`'s `GRID`, which keeps this module free of a value import cycle with the dialects.
  */
-export declare const makeAvoidingRouter: (obstacles: Rect[], fallback: Router, { step: STEP }: AvoidingRouterOptions) => Router;
+export declare const makeAvoidingRouter: (obstacles: Rect[], fallback: Router, { step: STEP }: AvoidingRouterOptions) => AvoidingRouter;
+export {};
 //# sourceMappingURL=ortho-router.d.ts.map

package/dist/types/src/ortho-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ortho-router.d.ts","sourceRoot":"","sources":["../../../src/ortho-router.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,EAAE,MAAM,eAAe,CAAC;AAiBlE,MAAM,MAAM,qBAAqB,GAAG;IAClC,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,cAClB,IAAI,EAAE,YACP,MAAM,kBACA,qBAAqB,KACpC,MAuUF,CAAC"}
+{"version":3,"file":"ortho-router.d.ts","sourceRoot":"","sources":["../../../src/ortho-router.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,EAAE,MAAM,eAAe,CAAC;AAWlE,KAAK,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAgFzB,MAAM,MAAM,qBAAqB,GAAG;IAClC,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAKF,qGAAqG;AACrG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IACpC;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,cAClB,IAAI,EAAE,YACP,MAAM,kBACA,qBAAqB,KACpC,cAgZF,CAAC"}

package/dist/types/src/ports.d.ts

@@ -0,0 +1,40 @@
+import type * as Scene from './scene.ts';
+import { type Rect } from './uml-grid.ts';
+type Point = Scene.Point;
+export type Side = 'top' | 'bottom' | 'left' | 'right';
+/** A routed connector with the boxes its ends sit on. */
+export type PortPath = {
+    points: readonly Point[];
+    source: Rect;
+    target: Rect;
+    /** Ends whose coordinate must not move (a straightened edge, or a face the router picked itself). */
+    fixed?: {
+        start?: boolean;
+        end?: boolean;
+    };
+};
+/** New coordinates along the side for the ends that moved; an absent end keeps its place. */
+export type Assigned = {
+    start?: number;
+    end?: number;
+};
+export type AssignOptions = {
+    /** Slot spacing and minimum distance from a box corner. */
+    step: number;
+};
+/** The side of `rect` that `point` sits on, if any. */
+export declare const sideOf: (point: Point, rect: Rect) => Side | undefined;
+/**
+ * Sort key of a terminal along its side, from its route read outward: a route turning toward the
+ * side's high end belongs at the high end, and of two turning the same way the one that runs out
+ * farther before turning sits nearer the low end, so neither turn-off cuts the other's stub.
+ */
+export declare const keyOf: (outward: readonly Point[], side: Side) => number;
+/**
+ * Reorders the ports on every box side so they follow their routes' key order, moving only the
+ * sides whose current order disagrees with it. Fixed terminals stay where they are and the free
+ * ones take slots on the `step` lattice in the gaps between them, at least `step` from a corner.
+ */
+export declare const assign: (paths: readonly PortPath[], { step }: AssignOptions) => Assigned[];
+export {};
+//# sourceMappingURL=ports.d.ts.map

package/dist/types/src/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/ports.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,KAAK,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAEzB,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,uDAAuD;AACvD,eAAO,MAAM,MAAM,UAAW,KAAK,QAAQ,IAAI,KAAG,IAAI,GAAG,SAgBxD,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,KAAK,YAAa,SAAS,KAAK,EAAE,QAAQ,IAAI,KAAG,MAU7D,CAAC;AA8BF;;;;GAIG;AACH,eAAO,MAAM,MAAM,UAAW,SAAS,QAAQ,EAAE,YAAY,aAAa,KAAG,QAAQ,EAyEpF,CAAC"}

package/dist/types/src/ports.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.test.d.ts.map

package/dist/types/src/ports.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.test.d.ts","sourceRoot":"","sources":["../../../src/ports.test.ts"],"names":[],"mappings":""}

package/dist/types/src/relations.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=relations.test.d.ts.map

package/dist/types/src/relations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.test.d.ts","sourceRoot":"","sources":["../../../src/relations.test.ts"],"names":[],"mappings":""}

package/dist/types/src/rules.d.ts

@@ -0,0 +1,30 @@
+export type Evaluator = 'code' | 'vision' | 'both';
+export type Category = 'crossings' | 'flow' | 'alignment' | 'space' | 'groups' | 'labels' | 'edges' | 'hierarchy';
+export type DiagramRule = {
+    /** Kebab-case id; `Appeal`'s evaluators and the image judge's decision keys are derived from it. */
+    readonly id: string;
+    /** What a good diagram does, in one line. */
+    readonly title: string;
+    readonly category: Category;
+    readonly evaluator: Evaluator;
+    /** Relative importance in the overall appeal score; the research ranks crossings far above the rest. */
+    readonly weight: number;
+    /** The yes/no question a vision judge answers; `yes` means the drawing follows the rule. */
+    readonly question?: string;
+    readonly criteria?: {
+        readonly true: string;
+        readonly false: string;
+    };
+    /** Rationale, the evidence behind the rule, and what does not count against it. */
+    readonly prose: string;
+};
+/**
+ * Parses the `diagram-rule` blocks of an `.mdl` document, ignoring every other block. A malformed rule
+ * throws, naming it, since a rule that silently drops out would leave its evaluator unbound.
+ */
+export declare const parse: (document: string) => DiagramRule[];
+/** Every rule in `rules/DIAGRAM.mdl`. */
+export declare const RULES: readonly DiagramRule[];
+/** The camelCase decision key a judge answers a rule under. */
+export declare const keyOf: (id: string) => string;
+//# sourceMappingURL=rules.d.ts.map

package/dist/types/src/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/rules.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAElH,MAAM,MAAM,WAAW,GAAG;IACxB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,wGAAwG;IACxG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAqCF;;;GAGG;AACH,eAAO,MAAM,KAAK,aAAc,MAAM,KAAG,WAAW,EAqChD,CAAC;AAEL,yCAAyC;AACzC,eAAO,MAAM,KAAK,EAAE,SAAS,WAAW,EAAgB,CAAC;AAEzD,+DAA+D;AAC/D,eAAO,MAAM,KAAK,OAAQ,MAAM,KAAG,MAAiF,CAAC"}