@dxos/diagram 0.11.1 → 0.13.0

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

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/scene.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/scene.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,KAAK,sKAchB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD,2GAA2G;AAC3G,eAAO,MAAM,IAAI,gEAAwD,CAAC;AAC1E,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnD,eAAO,MAAM,MAAM,oEAA4D,CAAC;AAChF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,MAAM,iDAAyC,CAAC;AAC7D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,KAAK;;;EAGhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAcrD,iDAAiD;AACjD,eAAO,MAAM,OAAO,sEAA8D,CAAC;AACnF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC;AAEzD,mCAAmC;AACnC,eAAO,MAAM,OAAO,qDAA6C,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC;AAEzD,sDAAsD;AACtD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;EAad,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAEjD,8CAA8C;AAC9C,eAAO,MAAM,MAAM;;;;;;;;;;;EAQjB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,kEAAkE;AAClE,eAAO,MAAM,QAAQ;;;;;;;;;;;;EAMnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE3D,sDAAsD;AACtD,eAAO,MAAM,KAAK;;;;;;;;;;;EAKhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;EASd,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAEjD,0BAA0B;AAC1B,eAAO,MAAM,IAAI;;;;;;;;;;;EAQf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnD,kFAAkF;AAClF,eAAO,MAAM,SAAS,sEAA8D,CAAC;AACrF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAC7D,eAAO,MAAM,SAAS,8CAAsC,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,uJASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE3D,oDAAoD;AACpD,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEnH,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAahF;;;GAGG;AACH,eAAO,MAAM,SAAS,UAAW,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,KAAG,eASvF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;EAmBhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,UAUtC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,SAAS,8BAA+B,UAAU,KAAG,MAC8B,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,MAAM,YAAY,MAAM,KAAG,MAG1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;EAUjB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyE,CAAC;AAC9F,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAMrD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGwE,CAAC;AAElG,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIyE,CAAC;AAErG,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;EAGvB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;EAIrB,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAyF,CAAC;AAC9G,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC"}

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

@@ -0,0 +1,54 @@
+import * as Effect from 'effect/Effect';
+import type * as Objective from './objective.ts';
+/** What produced a score; open so a host can add its own kinds of judge alongside the built-in ones. */
+export type Kind = 'constraint' | 'cost' | (string & {});
+export type Result = {
+    /** In [0, 1]: 0 is bad, 1 is good. Meaningless when `error` is set. */
+    score: number;
+    /** Why, in a line or two: the violations, or the raw measure behind a cost. */
+    detail?: string;
+    /** The scorer could not judge (e.g. its model was unreachable); left out of {@link overall}. */
+    error?: string;
+};
+export type Entry = {
+    id: string;
+    kind: Kind;
+    description: string;
+};
+/**
+ * One judge of a subject — by default the layout. An effect, so a judge that asks something outside the
+ * process can run late, be interrupted, and name what it needs in `R`.
+ */
+export type Scorer<S = Objective.Layout, R = never> = Entry & {
+    evaluate: (subject: S) => Effect.Effect<Result, never, R>;
+};
+/** Several scores from one evaluation, in `entries` order: for a judge that answers many questions per call. */
+export type Batch<S = Objective.Layout, R = never> = {
+    entries: readonly Entry[];
+    evaluate: (subject: S) => Effect.Effect<readonly Result[], never, R>;
+};
+export type Source<S = Objective.Layout, R = never> = Scorer<S, R> | Batch<S, R>;
+export type Scored = Result & Entry;
+/**
+ * Weighted cost at which a cost term scores 0.5: one crossing's worth (see `Objective.crossings`), so
+ * "half marks" means "as bad as one crossing" on every term.
+ */
+export declare const HALF_COST = 3;
+/** Maps a weighted cost in [0, ∞) onto (0, 1]: 1 at no cost, 0.5 at `half`, falling off hyperbolically. */
+export declare const fromCost: (weighted: number, half?: number) => number;
+/** A hard requirement: 1 when it holds, 0 when anything violates it. */
+export declare const constraintScorer: (constraint: Objective.Constraint) => Scorer;
+/** A soft preference: its weighted cost through {@link fromCost}. */
+export declare const costScorer: (term: Objective.CostTerm, half?: number) => Scorer;
+/** Every constraint and cost term of an objective, constraints first. */
+export declare const fromObjective: (objective: Objective.Objective, half?: number) => Scorer[];
+/** Runs every source against one subject concurrently; results keep the sources' order, batches flattened. */
+export declare const evaluate: <S, R>(sources: readonly Source<S, R>[], subject: S) => Effect.Effect<Scored[], never, R>;
+/**
+ * One number for a set of scores: the worst constraint gates the mean of everything else, so a
+ * layout that breaks a constraint scores 0 however good it otherwise is — the same precedence
+ * `Objective.select` gives violations over cost — while every other kind contributes equally.
+ * `undefined` when nothing could be judged, so a set of failed scorers never reads as a perfect score.
+ */
+export declare const overall: (all: readonly Pick<Scored, 'kind' | 'score' | 'error'>[]) => number | undefined;
+//# sourceMappingURL=score.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../src/score.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAEjD,wGAAwG;AACxG,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,MAAM,MAAM,MAAM,GAAG;IACnB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,GAAG;IAC5D,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,gHAAgH;AAChH,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,IAAI;IACnD,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,2GAA2G;AAC3G,eAAO,MAAM,QAAQ,aAAc,MAAM,SAAQ,MAAM,KAAe,MAAgD,CAAC;AAEvH,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,eAAgB,SAAS,CAAC,UAAU,KAAG,MASlE,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,UAAU,SAAU,SAAS,CAAC,QAAQ,SAAQ,MAAM,KAAe,MAU9E,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,aAAa,cAAe,SAAS,CAAC,SAAS,SAAQ,MAAM,KAAe,MAAM,EAG9F,CAAC;AAIF,8GAA8G;AAC9G,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,WAAW,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAgB/D,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,QAAS,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,EAAE,KAAG,MAAM,GAAG,SAS3F,CAAC"}

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

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

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

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

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

@@ -0,0 +1,41 @@
+import * as Diagnostics from './diagnostics.ts';
+import * as MermaidEngine from './mermaid-engine.ts';
+import * as Objective from './objective.ts';
+import * as Scene from './scene.ts';
+import * as Place from './semantic-place.ts';
+import * as Semantic from './semantic.ts';
+/** One box size for every node, from the longest label wrapped at the widest box. */
+export declare const measureBox: (labels: readonly string[]) => Semantic.Size;
+/** Cell pitch for a box: a box-wide gutter across, and room for two frame borders, a title and a gap down. */
+export declare const pitchFor: (box: Semantic.Size) => Semantic.Size;
+export type SolveOptions = {
+    /** Objective that picks among routed candidates (default: the layout objective plus appeal). */
+    objective?: Objective.Objective;
+    /** Placements to refine besides the search's own. */
+    seeds?: readonly Map<string, Place.Cell>[];
+    /** Complete layouts to compare against, such as the mermaid engine's. */
+    alternatives?: readonly Scene.Command[][];
+    /** Independent placement searches (default 6). */
+    restarts?: number;
+    /** Routes the mermaid engine's candidates off the thread; see `MermaidEngine.CompileOptions`. */
+    emitCandidate?: MermaidEngine.CompileOptions['emitCandidate'];
+};
+export type Solution = {
+    commands: Scene.Command[];
+    issues: Semantic.Issue[];
+    report: Diagnostics.Report;
+};
+/**
+ * Groups whose frame spans a whole column or row with none of their members in it, each blamed on
+ * a relation tying a member to a node outside the group, which is what pulls the members apart.
+ */
+export declare const stretchIssues: (diagram: Semantic.Diagram, cells: Map<string, Place.Cell>) => Semantic.Issue[];
+/** Lays out a semantic diagram synchronously with the grid search alone. */
+export declare const solve: (source: Semantic.Diagram, options?: SolveOptions) => Solution;
+/**
+ * Lays out a semantic diagram, also trying the mermaid engine's search when nothing was hinted:
+ * its placements seed the grid search and its own layout competes as a candidate. Async because
+ * ELK is; an engine failure only removes those candidates.
+ */
+export declare const compile: (source: Semantic.Diagram, options?: SolveOptions) => Promise<Solution>;
+//# sourceMappingURL=semantic-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-engine.d.ts","sourceRoot":"","sources":["../../../src/semantic-engine.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAC;AAE7C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AA2B1C,qFAAqF;AACrF,eAAO,MAAM,UAAU,WAAY,SAAS,MAAM,EAAE,KAAG,QAAQ,CAAC,IAO/D,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,QAAQ,QAAS,QAAQ,CAAC,IAAI,KAAG,QAAQ,CAAC,IAGrD,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,gGAAgG;IAChG,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC;IAChC,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,yEAAyE;IACzE,YAAY,CAAC,EAAE,SAAS,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC1C,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,aAAa,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B,CAAC;AAuoBF;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAa,QAAQ,CAAC,OAAO,SAAS,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,KAAG,QAAQ,CAAC,KAAK,EAgCpG,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,KAAK,WAAY,QAAQ,CAAC,OAAO,YAAW,YAAY,KAAQ,QA0C5E,CAAC;AAsDF;;;;GAIG;AACH,eAAO,MAAM,OAAO,WAAkB,QAAQ,CAAC,OAAO,YAAW,YAAY,KAAQ,OAAO,CAAC,QAAQ,CAmBpG,CAAC"}

package/dist/types/src/semantic-engine.test.d.ts

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

package/dist/types/src/semantic-engine.test.d.ts.map

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

package/dist/types/src/semantic-place.d.ts

@@ -0,0 +1,81 @@
+import type * as Semantic from './semantic.ts';
+export type Cell = {
+    col: number;
+    row: number;
+};
+export type PlaceNode = {
+    id: string;
+    group?: string;
+    pin?: Cell;
+};
+export type PlaceRelation = {
+    from: string;
+    kind: Semantic.RelationKind;
+    target: string;
+    soft: boolean;
+    /** Cost of breaking a soft relation, in place of the default. */
+    weight?: number;
+};
+export type PlaceEdge = {
+    from: string;
+    to: string;
+    sides?: {
+        start?: readonly Semantic.Side[];
+        end?: readonly Semantic.Side[];
+    };
+    /** The target is an abstraction that reads best against the flow, above its subtypes. */
+    upward?: boolean;
+};
+/** How a group may be shaped: at most `maxWidth` columns, and near-square when `compact`. */
+export type GroupShape = {
+    maxWidth?: number;
+    compact?: boolean;
+};
+export type PlaceInput = {
+    nodes: readonly PlaceNode[];
+    /** Group ids in declaration order. */
+    groups: readonly string[];
+    /** Shape limits by group id. */
+    shapes?: ReadonlyMap<string, GroupShape>;
+    /** Preferred columns over rows of the whole placement. */
+    aspect?: number;
+    /** Node relations; `from` and `target` are node ids. */
+    relations: readonly PlaceRelation[];
+    /** Group relations; `from` and `target` are group ids. */
+    groupRelations: readonly PlaceRelation[];
+    edges: readonly PlaceEdge[];
+    flow: Semantic.Flow;
+    /** Box half-extent as a fraction of the cell pitch, for the edge-through-box test. */
+    box?: {
+        x: number;
+        y: number;
+    };
+};
+export type PlaceOptions = {
+    /** Independent searches from different random seeds (default 6). */
+    restarts?: number;
+    /** Starting placements to refine besides the greedy ones (e.g. a layered engine's). */
+    seeds?: readonly Map<string, Cell>[];
+    /** How many distinct placements to return, best first (default 3). */
+    keep?: number;
+};
+export type Placed = {
+    cells: Map<string, Cell>;
+    cost: number;
+};
+/**
+ * Fewest bends an orthogonal route takes from side `start` of a box to side `end` of another box
+ * displaced by (dx, dy) cells, ignoring every other box: the template the router will try first.
+ */
+export declare const templateBends: (dx: number, dy: number, start: Semantic.Side, end: Semantic.Side) => number;
+/** Hard relations the placement could not satisfy, as indices into `input.relations` and `input.groupRelations`. */
+export declare const unmet: (input: PlaceInput, cells: Map<string, Cell>) => {
+    relations: number[];
+    groupRelations: number[];
+};
+/**
+ * Places every node on the grid. Returns up to `keep` distinct placements, best first, so the caller
+ * can route each and let the real measurements choose.
+ */
+export declare const place: (input: PlaceInput, { restarts, seeds, keep }?: PlaceOptions) => Placed[];
+//# sourceMappingURL=semantic-place.d.ts.map

package/dist/types/src/semantic-place.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-place.d.ts","sourceRoot":"","sources":["../../../src/semantic-place.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAA;KAAE,CAAC;IAC7E,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,sCAAsC;IACtC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,0DAA0D;IAC1D,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,sFAAsF;IACtF,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;IACrC,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA4LhE;;;GAGG;AACH,eAAO,MAAM,aAAa,OAAQ,MAAM,MAAM,MAAM,SAAS,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAG,MAchG,CAAC;AA6mCF,oHAAoH;AACpH,eAAO,MAAM,KAAK,UACT,UAAU,SACV,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KACvB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAwBjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,UAAW,UAAU,8BAA0C,YAAY,KAAQ,MAAM,EAmE1G,CAAC"}

package/dist/types/src/semantic-route.d.ts

@@ -0,0 +1,133 @@
+import type * as Scene from './scene.ts';
+import { type Side } from './semantic.ts';
+import { type Rect } from './uml-grid.ts';
+type Point = Scene.Point;
+/** One end of a connector: a box (zero-sized for a bus junction), the sides it may use, and a fixed port. */
+export type End = {
+    rect: Rect;
+    /** Key of the box, for port bookkeeping; undefined for a junction. */
+    node?: string;
+    sides: readonly Side[];
+    /** Sides the author prefers among `sides`; any other costs extra. */
+    preferred?: readonly Side[];
+    /** Fixed coordinate along the side. */
+    port?: number;
+};
+/** A waypoint in scene units: one coordinate pins that axis of the route, both pin a point. */
+export type Waypoint = {
+    x?: number;
+    y?: number;
+};
+export type Piece = {
+    /** Connector id; pieces of one bus share a `bus` key and may touch. */
+    id: string;
+    bus?: string;
+    start: End;
+    end: End;
+    via: readonly Waypoint[];
+    points: Point[];
+    startSide?: Side;
+    endSide?: Side;
+    /** Drawn by the A* fallback, which ignores sides and waypoints. */
+    forced?: boolean;
+    /** Rank of the connector's relation; the highest on a shared side takes its centre. */
+    significance?: number;
+};
+export type Context = {
+    /** Every box a route must not cross. */
+    obstacles: readonly Rect[];
+    /** Text a route should avoid (frame titles). */
+    avoid: readonly Rect[];
+    /** Channel coordinates: x of vertical gutters, y of horizontal ones. */
+    channels: {
+        xs: readonly number[];
+        ys: readonly number[];
+    };
+};
+export declare const portPoint: (rect: Rect, side: Side, coord: number) => Point;
+/** Drops repeated points and collinear midpoints; undefined when the path doubles back on itself. */
+export declare const simplify: (points: readonly Point[]) => Point[] | undefined;
+export declare const bendsOf: (points: readonly Point[]) => number;
+/** A run of a route; `docked` marks an end that sits on a box port, where routes meet by design. */
+type Segment = {
+    owner: string;
+    bus?: string;
+    pair?: string;
+    from: Point;
+    to: Point;
+    docked: [boolean, boolean];
+    /** The piece's ports on boxes. */
+    ports: readonly Point[];
+};
+/** Ports already taken, per box side, by role: an exit beside an entry reads as a crossing. */
+type Terminals = Map<string, {
+    owner: string;
+    role: 'exit' | 'entry';
+}[]>;
+type Best = {
+    points: Point[];
+    startSide: Side;
+    endSide: Side;
+    cost: number;
+};
+/** The cheapest valid route for a piece over its allowed sides; undefined when no shape fits. */
+export declare const bestRoute: (piece: {
+    id: string;
+    bus?: string;
+    start: End;
+    end: End;
+    via: readonly Waypoint[];
+}, others: readonly Segment[], terminals: Terminals, context: Context) => Best | undefined;
+/** A bus to route: a hub, its spokes, and the pieces that will be drawn once a junction is chosen. */
+export type BusRequest = {
+    id: string;
+    hub: End;
+    spokes: {
+        id: string;
+        end: End;
+    }[];
+    direction: 'in' | 'out';
+    significance?: number;
+};
+/**
+ * Routes every piece and bus. Pieces with fewer possible bends go first, so straight neighbours
+ * claim their direct runs before a long edge looks for a channel.
+ */
+export declare const routeAll: (pieces: readonly Piece[], buses: readonly BusRequest[], context: Context) => Piece[];
+/**
+ * Spreads the ports on every side that several pieces share, in the order their routes leave it,
+ * keeping straight pieces straight; returns the pieces with fixed sides and ports to re-route.
+ */
+export declare const spreadPorts: (pieces: readonly Piece[]) => Piece[];
+/** Re-routes pieces whose sides and ports are now fixed; a piece no shape can draw keeps its old route. */
+export declare const reroute: (fixed: readonly Piece[], previous: readonly Piece[], context: Context) => Piece[];
+/** Separates parallel runs; bus pieces stay put, since they meet on purpose. */
+export declare const separate: (pieces: readonly Piece[], context: Context) => Piece[];
+export type LabelRequest = {
+    id: string;
+    text: string;
+    points: readonly Point[];
+    /** A trunk the route shares with others, where its label goes only when its own runs have no room. */
+    shared?: readonly Point[];
+};
+export type LabelOptions = {
+    /** Every drawn route, the label's own among them. */
+    paths: readonly (readonly Point[])[];
+    boxes: readonly Rect[];
+    /** Text already on the drawing (frame titles). */
+    avoid: readonly Rect[];
+    /** Group frames, whose dashed borders a label must not sit on. */
+    frames?: readonly Rect[];
+    bounds: Rect;
+};
+/** Whether a rect straddles a frame's border, rather than lying wholly inside or outside it. */
+export declare const onBorder: (rect: Rect, frame: Rect, clearance?: number) => boolean;
+/**
+ * Each label beside a run of its own route, nearer that route than any other, and clear of boxes,
+ * other labels, other routes, frame borders and frame titles: the longest run first, its middle
+ * first, above a horizontal run or right of a vertical one (where the text starts at the line).
+ * When nothing is clear, the least-cluttered spot wins.
+ */
+export declare const placeLabels: (labels: readonly LabelRequest[], options: LabelOptions) => Scene.Text[];
+export {};
+//# sourceMappingURL=semantic-route.d.ts.map

package/dist/types/src/semantic-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-route.d.ts","sourceRoot":"","sources":["../../../src/semantic-route.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,164 @@
+import type * as Scene from './scene.ts';
+export type Range = {
+    from: number;
+    to: number;
+};
+/** A problem the engine found in the intent, with the source range it belongs to. */
+export type Issue = Range & {
+    severity: 'error' | 'warning';
+    message: string;
+};
+export type Side = 'top' | 'bottom' | 'left' | 'right';
+export declare const SIDES: readonly Side[];
+/** Which way edges should read; the placement prefers targets on this side of their sources. */
+export type Flow = 'down' | 'up' | 'right' | 'left';
+export declare const FLOWS: readonly Flow[];
+export type RelationKind = 'right-of' | 'left-of' | 'above' | 'below' | 'same-row' | 'same-col';
+export declare const RELATION_KINDS: readonly RelationKind[];
+/** `right-of X`: same row as X and to its right; `~` makes it a preference instead of a rule. */
+export type Relation = {
+    kind: RelationKind;
+    target: string;
+    soft: boolean;
+    range: Range;
+};
+/** `@ x,y` pins the box's top-left exactly, in scene units; `@cell(c,r)` pins its grid cell. */
+export type Pin = ({
+    kind: 'point';
+    x: number;
+    y: number;
+} | {
+    kind: 'cell';
+    col: number;
+    row: number;
+}) & {
+    range: Range;
+};
+export type Node = {
+    id: string;
+    label: string;
+    group?: string;
+    ref?: string;
+    pin?: Pin;
+    relations: Relation[];
+    shape?: Scene.BoxKind;
+    color?: Scene.Color;
+    fill?: Scene.Fill;
+    stroke?: Scene.Stroke;
+    range: Range;
+};
+export type Group = {
+    id: string;
+    label: string;
+    relations: Relation[];
+    /** Extra clear space, in scene units, between this group and the groups it is placed relative to. */
+    gap?: number;
+    /** Most columns the group may span. */
+    maxWidth?: number;
+    /** Keep the group near-square rather than a strip. */
+    compact?: boolean;
+    color?: Scene.Color;
+    range: Range;
+};
+/** One coordinate or both; `cell` units are grid cells, where `n.5` is the channel after cell `n`. */
+export type Waypoint = {
+    x?: number;
+    y?: number;
+    unit: 'scene' | 'cell';
+    range: Range;
+};
+/** One end of an edge; `soft` makes its sides a preference the router weighs instead of a rule. */
+export type End = {
+    node: string;
+    sides?: readonly Side[];
+    soft?: boolean;
+    range: Range;
+};
+/**
+ * Relationship words an edge may use in place of `->`, each naming the scene relation it draws.
+ * The left end is the subtype, the whole, the owner, or the one side.
+ */
+export declare const RELATIONSHIPS: Readonly<Record<string, Scene.Relation>>;
+/** The id of the scene object that holds every connector, so no node or group may take it. */
+export declare const CONNECTORS = "edges";
+/** Relations whose target is the abstraction, which reads best above its subtypes. */
+export declare const pointsUp: (relation: Scene.Relation | undefined) => boolean;
+/**
+ * How strongly a connector's relation shapes the reading of a diagram, highest first; on a box face
+ * shared by several connectors the most significant takes the centre.
+ */
+export declare const SIGNIFICANCE: Readonly<Record<Scene.Relation, number>>;
+/** The significance of an edge's relation; an untyped dashed edge reads as a dependency. */
+export declare const significance: (relation: Scene.Relation | undefined, stroke?: Scene.Stroke) => number;
+export type EdgeStyle = {
+    relation?: Scene.Relation;
+    head?: Scene.ArrowHead;
+    tail?: Scene.ArrowTail;
+    stroke?: Scene.Stroke;
+    color?: Scene.Color;
+};
+export type Edge = EdgeStyle & {
+    /** Scene id of the connector, unique in the diagram. */
+    id: string;
+    from: End;
+    to: End;
+    label?: string;
+    via: readonly Waypoint[];
+    /** Edges with the same bus key and hub share one trunk. */
+    bus?: string;
+    range: Range;
+};
+/**
+ * Edges merged into one trunk: the hub end is shared, each spoke ends at its own node. `out` fans
+ * from the hub to the spokes, `in` gathers the spokes into the hub.
+ */
+export type Bus = {
+    id: string;
+    hub: End;
+    direction: 'out' | 'in';
+    edges: readonly Edge[];
+    /** Text on the trunk, from a multi-target statement's label. */
+    label?: string;
+    /** Gathered by relation rather than by a `bus` statement, so the router may still split it. */
+    implicit?: boolean;
+};
+export type Size = {
+    w: number;
+    h: number;
+};
+export type Diagram = {
+    flow: Flow;
+    origin: Scene.Point;
+    /** Cell pitch (box plus gutter), in scene units; measured from the boxes when absent. */
+    grid?: Size;
+    /** Box size; measured from the longest label when absent. */
+    box?: Size;
+    /** Preferred width over height of the whole drawing. */
+    aspect?: number;
+    nodes: Node[];
+    groups: Group[];
+    edges: Edge[];
+    /** Trunk labels by bus key (`<hub>|<name>|<direction>`), from multi-target statements. */
+    busLabels: Map<string, string>;
+    /** Whether any statement said how to place or route — when none did, the mermaid engine's search is also tried. */
+    hinted: boolean;
+};
+export declare const empty: () => Diagram;
+/** The key edges share a trunk under. */
+export declare const busKey: (hub: string, name: string, direction: Bus['direction']) => string;
+/**
+ * The implicit bus key of an inheritance edge: subtypes of one abstraction share a trunk into it,
+ * unless the author routed the edge by hand.
+ */
+export declare const inheritanceKey: (edge: Edge) => string | undefined;
+/** The edges grouped into buses (two or more edges with one key) and the rest. */
+export declare const buses: (diagram: Diagram) => {
+    buses: Bus[];
+    single: Edge[];
+};
+/**
+ * The diagram as a mermaid flowchart, for the engine's own search when nothing was hinted; undefined
+ * when an id or label cannot be written in the mermaid subset.
+ */
+export declare const toMermaid: (diagram: Diagram) => string | undefined;
+//# sourceMappingURL=semantic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/semantic.ts"],"names":[],"mappings":"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"}

package/dist/types/src/uml-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uml-grid.d.ts","sourceRoot":"","sources":["../../../src/uml-grid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uml-grid.d.ts","sourceRoot":"","sources":["../../../src/uml-grid.ts"],"names":[],"mappings":"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"}

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

@@ -25,11 +25,9 @@ export type UmlModel = {
 };
 /** Parse a mermaid class diagram into a neutral model. Unrecognised lines are ignored. */
 export declare const parse: (source: string) => UmlModel;
-/** Arrow styling per relation kind; dependency and realization render dashed, as in UML. */
-export declare const relationStyle: (kind: RelationKind) => {
-    stroke?: Scene.Stroke;
-};
-/** Mid-arrow label: cardinalities and the diamond glyph UML puts at the whole end. */
+/** Arrow styling per relation kind: the scene relation sets the markers; dependency and realization dash, as in UML. */
+export declare const relationStyle: (kind: RelationKind) => Pick<Scene.Arrow, 'relation' | 'stroke'>;
+/** Mid-arrow label: the cardinalities around the label; the diamond at the whole end is a marker now. */
 export declare const relationText: (relation: UmlRelation) => string | undefined;
 /**
  * Rank so arrows read upward where UML convention points at abstractions — inheritance,

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

@@ -1 +1 @@
-{"version":3,"file":"uml.d.ts","sourceRoot":"","sources":["../../../src/uml.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,CAAC;AAExH,oFAAoF;AACpF,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;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAyCF,0FAA0F;AAC1F,eAAO,MAAM,KAAK,WAAY,MAAM,KAAG,QA4FtC,CAAC;AA6CF,4FAA4F;AAC5F,eAAO,MAAM,aAAa,SAAU,YAAY,KAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAA;CACG,CAAC;AAE9E,sFAAsF;AACtF,eAAO,MAAM,YAAY,aAAc,WAAW,KAAG,MAAM,GAAG,SAI7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAW,QAAQ,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAQ/D,CAAC;AAEJ,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,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,YAAW,cAAc,KAAQ,KAAK,CAAC,OAAO,EA0HnF,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,OAAmD,CAAC"}
+{"version":3,"file":"uml.d.ts","sourceRoot":"","sources":["../../../src/uml.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,CAAC;AAExH,oFAAoF;AACpF,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;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAyCF,0FAA0F;AAC1F,eAAO,MAAM,KAAK,WAAY,MAAM,KAAG,QA4FtC,CAAC;AAsDF,wHAAwH;AACxH,eAAO,MAAM,aAAa,SAAU,YAAY,KAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAMzF,CAAC;AAEF,yGAAyG;AACzG,eAAO,MAAM,YAAY,aAAc,WAAW,KAAG,MAAM,GAAG,SAG7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAW,QAAQ,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAQ/D,CAAC;AAEJ,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,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,YAAW,cAAc,KAAQ,KAAK,CAAC,OAAO,EA0HnF,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,OAAmD,CAAC"}

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

@@ -0,0 +1,53 @@
+import type * as Scene from './scene.ts';
+type Point = Scene.Point;
+type Rect = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+export type Box = {
+    ref: string;
+    label?: string;
+    rect: Rect;
+    frame: boolean;
+};
+export type Path = {
+    ref: string;
+    points: Point[];
+    label?: string;
+    from?: Box;
+    to?: Box;
+    /** The arrow's end markers and line style, when not a plain solid arrow. */
+    style?: Pick<Scene.Arrow, 'head' | 'tail' | 'stroke'>;
+};
+export type Drawing = {
+    boxes: Box[];
+    paths: Path[];
+    bounds: Rect;
+};
+/** Boxes, frames and connector paths in absolute coordinates, each path resolved to the boxes at its ends. */
+export declare const extract: (objects: readonly Scene.WorldObject[]) => Drawing;
+/**
+ * Every box, frame and connector with its position in grid cells from the top-left corner (x right,
+ * y down): what a person reads off the picture as "where", in numbers.
+ */
+export declare const coordinates: (objects: readonly Scene.WorldObject[], cell?: number) => string;
+/**
+ * The drawing in words, as a reader scans it: boxes row by row from the top, left to right, then each
+ * arrow with the way it runs across the page and the rows it spans.
+ */
+export declare const rows: (objects: readonly Scene.WorldObject[]) => string;
+export type AsciiOptions = {
+    /** Scene units per column; small enough that a box's label fits inside it. */
+    column?: number;
+    /** Scene units per row. */
+    row?: number;
+};
+/**
+ * The drawing rasterized onto a character grid: boxes with their labels, dashed group frames, routed
+ * connectors with corners and junctions, and an arrowhead where each connector ends.
+ */
+export declare const ascii: (objects: readonly Scene.WorldObject[], { column, row }?: AsciiOptions) => string;
+export {};
+//# sourceMappingURL=view.d.ts.map