@weasel-js/diagram 1.11.1 → 1.12.0

package/dist/layout.d.ts

@@ -1,5 +1,5 @@
-export { t as BodyFloor, u as BodyNodeSpec, B as BodySpec, m as Bounds, v as BuildBodyOptions, y as DEFAULT_HOP_SIZE, z as DEFAULT_NODE_GAP, A as DEFAULT_RANK_GAP, c as DiagramLabel, f as DiagramNode, E as EdgeHop, J as EdgeLabelRoom, G as Graph, K as GraphEdge, N as GraphGroup, Q as GraphNode, U as HOPS_DOC_KEY, V as HopsDocValue, l as LabelSpot, X as LayoutAxes, q as LayoutDirection, d as LayoutFn, e as LayoutOptions, r as LayoutPlan, p as LayoutPlanner, L as LayoutPorts, n as LayoutResult, M as MeasureRowText, O as Outline, Y as PORT_LABEL_GAP, Z as PerimeterPortLabelBox, g as Port, P as PortAnchor, $ as PortSite, b as PortSpec, a as Row, a0 as RowBox, a1 as RowNodeData, a2 as RowPort, a3 as RowPortBox, R as RowTextStyle, a4 as Slot, a5 as anchorOffset, a6 as axesFor, a8 as bodyOutline, aa as boxForContent, ab as buildBody, ad as canvasMeasure, ae as contentBox, aI as extent, al as graphOrder, ap as layoutBody, aq as layoutRowPorts, ar as marginOf, as as measureBody, at as outlinePath, au as packAcross, aw as pinnedSet, ax as planOf, ay as plannerPlan, az as portLabelBox, aC as seededOrder, aD as settle, aE as sizeToBody, aG as translated, aH as untilSettled } from './types-BbHunLXm.js';
-export { e as AVOID_DEFAULTS, f as AvoidEdge, g as AvoidEnd, A as AvoidInput, h as AvoidLabel, i as AvoidObstacle, b as AvoidOptions, j as AvoidPort, a as AvoidRouter, c as AvoidRoutes, k as AvoidUpdateOptions, C as COMPASS, D as DEFAULT_PORTS, l as ForceBody, F as ForceOptions, m as ForceRelaxation, L as LabelPlacements, o as LayeredPlan, p as PlaceLabel, q as PlaceLabelsInput, d as PlaceLabelsOptions, r as PlaceRoute, P as PortsOptions, s as backEdges, t as chain, u as createAvoidRouter, v as edgeHops, w as footprintNode, x as force, y as forceRelaxation, z as forestOf, B as labelCenter, E as layered, G as layeredPlan, H as outlinePolyline, I as placeLabels, J as portOf, K as portSitesOf, M as portsOf, N as portsOnOutline, O as ranksByLength, Q as ranksOf, R as rayHit, S as routeHolds, T as tree } from './layout.entry-CH9gc0CY.js';
+export { t as BodyFloor, B as BodySpec, m as Bounds, w as DEFAULT_HOP_SIZE, x as DEFAULT_NODE_GAP, y as DEFAULT_RANK_GAP, c as DiagramLabel, f as DiagramNode, E as EdgeHop, H as EdgeLabelRoom, G as Graph, I as GraphEdge, J as GraphGroup, K as GraphNode, Q as HOPS_DOC_KEY, T as HopsDocValue, l as LabelSpot, V as LayoutAxes, q as LayoutDirection, d as LayoutFn, e as LayoutOptions, r as LayoutPlan, p as LayoutPlanner, L as LayoutPorts, n as LayoutResult, M as MeasureRowText, O as Outline, g as Port, P as PortAnchor, W as PortSite, b as PortSpec, a as Row, X as RowBox, Y as RowPort, Z as RowPortBox, R as RowTextStyle, _ as Slot, $ as anchorOffset, a0 as axesFor, a2 as bodyOutline, a4 as boxForContent, a6 as canvasMeasure, a7 as contentBox, ay as extent, ae as graphOrder, ai as layoutBody, aj as layoutRowPorts, ak as measureBody, al as outlinePath, am as packAcross, ao as pinnedSet, ap as planOf, aq as plannerPlan, as as seededOrder, at as settle, au as sizeToBody, aw as translated, ax as untilSettled } from './types-M_ccNAlk.js';
+export { e as AVOID_DEFAULTS, f as AvoidEdge, g as AvoidEnd, A as AvoidInput, h as AvoidLabel, i as AvoidObstacle, b as AvoidOptions, j as AvoidPort, a as AvoidRouter, c as AvoidRoutes, k as AvoidUpdateOptions, B as BodyNodeSpec, l as BuildBodyOptions, C as COMPASS, D as DEFAULT_PORTS, m as ForceBody, F as ForceOptions, n as ForceRelaxation, L as LabelPlacements, p as LayeredPlan, q as PORT_LABEL_GAP, r as PerimeterPortLabelBox, s as PlaceLabel, t as PlaceLabelsInput, d as PlaceLabelsOptions, u as PlaceRoute, P as PortsOptions, R as RowNodeData, w as backEdges, x as buildBody, y as chain, z as createAvoidRouter, E as edgeHops, G as footprintNode, H as force, I as forceRelaxation, J as forestOf, K as labelCenter, M as layered, N as layeredPlan, O as marginOf, Q as outlinePolyline, S as placeLabels, T as portLabelBox, V as portOf, W as portSitesOf, X as portsOf, Y as portsOnOutline, Z as ranksByLength, _ as ranksOf, $ as rayHit, a0 as routeHolds, a1 as tree } from './layout.entry-B-jJMc50.js';
 import '@weasel-js/core/math';
 import '@weasel-js/geom';
 import '@weasel-js/simulation';

package/dist/{layout.entry-CH9gc0CY.d.ts → layout.entry-B-jJMc50.d.ts}

@@ -1,6 +1,111 @@
-import { Q as GraphNode, i as DiagramNodeReader, b as PortSpec, h as DiagramNodeLike, g as Port, c as DiagramLabel, m as Bounds, E as EdgeHop, l as LabelSpot, e as LayoutOptions, G as Graph, n as LayoutResult, d as LayoutFn, L as LayoutPorts, O as Outline } from './types-BbHunLXm.js';
+import { m as Bounds, b as PortSpec, g as Port, N as GroupInset, f as DiagramNode, M as MeasureRowText, X as RowBox, Z as RowPortBox, B as BodySpec, K as GraphNode, i as DiagramNodeReader, h as DiagramNodeLike, c as DiagramLabel, E as EdgeHop, l as LabelSpot, e as LayoutOptions, G as Graph, n as LayoutResult, d as LayoutFn, L as LayoutPorts, O as Outline } from './types-M_ccNAlk.js';
+import { Vec2, PoseDescriptor, Path } from '@weasel-js/core/math';
 import { SimulationNode, createSimulation } from '@weasel-js/simulation';
-import { PoseDescriptor, Vec2, Path } from '@weasel-js/core/math';
+
+/**
+ * Perimeter port labels: where the text naming a port is drawn, and how far
+ * past its node that reaches.
+ *
+ * A label sits outside the node, on the port's own face, and to one side of
+ * the line the port's wire leaves along, so the wire does not run through it.
+ * A port inside a row draws its label inside the box instead; that is a
+ * `ports` row's job, not this module's.
+ */
+
+/** Between a port and the near sides of its label, in world units. */
+declare const PORT_LABEL_GAP = 4;
+/**
+ * Where a label `size` big goes for a port at `point` facing `normal`.
+ *
+ * A port on a left or right face gets its label outside that face, above its
+ * wire; one on a top or bottom face, outside that face, right of its wire; a
+ * corner port, off the corner. A port with no direction gets it centered
+ * above.
+ */
+declare function portLabelBox(port: {
+    point: Vec2;
+    normal: Vec2 | null;
+}, size: {
+    width: number;
+    height: number;
+}, gap?: number): Bounds;
+/** Where a built body's perimeter port label sits, as `buildBody`'s
+ *  `portLabel` is handed it. */
+interface PerimeterPortLabelBox extends Bounds {
+    port: PortSpec;
+    side: 'outside';
+}
+/** A labeled port, resolved, and the box its label is drawn in. */
+interface PortLabelPlacement {
+    port: Port & {
+        label: string;
+    };
+    box: Bounds;
+}
+/** Every labeled port of `trait` resolved against `bounds`, with its label's
+ *  box. `size` measures one label. */
+declare function portLabelsOf(trait: DiagramNode, bounds: Bounds, size: (text: string) => {
+    width: number;
+    height: number;
+}): PortLabelPlacement[];
+/** How far `boxes` reach past `bounds` on each side; `undefined` for none. */
+declare function marginOf(bounds: Bounds, boxes: readonly Bounds[]): GroupInset | undefined;
+
+/** What {@link buildBody} emits: the `AddNodeSpec` fields it fills in. Named
+ *  structurally rather than imported so a consumer whose scene is typed
+ *  differently can still spread one. */
+interface BodyNodeSpec<TData, TLayer extends string, TPose> {
+    kind: 'container' | 'leaf';
+    layer: TLayer;
+    pose: TPose;
+    data: TData;
+    id?: string;
+    parent?: string;
+    /** Set on the container to {@link clipNothing}: a perimeter port label sits
+     *  outside the body, and a container clips its children to its outline. */
+    clipFromPose?: () => null;
+    /** Set `false` on every leaf the builder emits: the innermost hit wins, so a
+     *  row that answers a press is a body that cannot be dragged. */
+    pickable?: boolean;
+}
+/** What a built body's rows are handed to, one call per row.
+ *
+ *  `text` is the row's content already formatted — a `label`'s own text, or a
+ *  `field`'s `"label: value"` — so the common case needs no discrimination.
+ *  Return `null` for a row the consumer paints itself; `ports` and `slot` rows
+ *  arrive with `text` empty and are the usual ones to decline. */
+type RowNodeData<TData> = (text: string, box: RowBox) => TData | null;
+/** Options for {@link buildBody}: the layer and data of each node it emits.
+ *  Without `measure`, rows are sized from a fallback line height rather than
+ *  their text. */
+interface BuildBodyOptions<TData, TLayer extends string, TPose extends Bounds> {
+    layer: TLayer;
+    /** The container's id. Edges name it, so pass one for anything an edge or a
+     *  layout `pin` will refer to. */
+    id?: string;
+    measure?: MeasureRowText;
+    /** The container's own data, given the trait the builder computed and the
+     *  pose it was computed against. */
+    body: (trait: DiagramNode, pose: TPose) => TData;
+    /** One row's data, or `null` to leave that row undrawn. */
+    row: RowNodeData<TData>;
+    /** One port's label — a row port's or a perimeter port's — or `null` to
+     *  leave it undrawn. Ports with no label are never offered. Omit to draw none. */
+    portLabel?: (text: string, box: RowPortBox | PerimeterPortLabelBox) => TData | null;
+}
+/**
+ * The scene nodes a built body is: one container carrying the trait, and one
+ * leaf per row that wants drawing.
+ *
+ * Rows are ordinary scene nodes rather than something this package paints, so
+ * the kit's own text painter draws them and text editing, styling, and
+ * selection work on them unchanged. The returned pose is `at` grown to fit the
+ * body, never shrunk.
+ */
+declare function buildBody<TData, TLayer extends string, TPose extends Bounds>(spec: BodySpec, at: TPose, opts: BuildBodyOptions<TData, TLayer, TPose>): {
+    pose: TPose;
+    specs: BodyNodeSpec<TData, TLayer, TPose>[];
+};
 
 /** `node` as layout sees it: bounds grown by its margin, ports where they were. */
 declare function footprintNode(node: GraphNode): GraphNode;
@@ -509,4 +614,4 @@ declare function rayHit(poly: readonly number[], center: {
  */
 declare function portsOnOutline(ports: readonly Port[], outline: Outline, bounds: Bounds): Port[];
 
-export { type AvoidInput as A, labelCenter as B, COMPASS as C, DEFAULT_PORTS as D, layered as E, type ForceOptions as F, layeredPlan as G, outlinePolyline as H, placeLabels as I, portOf as J, portSitesOf as K, type LabelPlacements as L, portsOf as M, portsOnOutline as N, ranksByLength as O, type PortsOptions as P, ranksOf as Q, rayHit as R, routeHolds as S, tree as T, type AvoidRouter as a, type AvoidOptions as b, type AvoidRoutes as c, type PlaceLabelsOptions as d, AVOID_DEFAULTS as e, type AvoidEdge as f, type AvoidEnd as g, type AvoidLabel as h, type AvoidObstacle as i, type AvoidPort as j, type AvoidUpdateOptions as k, type ForceBody as l, type ForceRelaxation as m, type Forest as n, type LayeredPlan as o, type PlaceLabel as p, type PlaceLabelsInput as q, type PlaceRoute as r, backEdges as s, chain as t, createAvoidRouter as u, edgeHops as v, footprintNode as w, force as x, forceRelaxation as y, forestOf as z };
+export { rayHit as $, type AvoidInput as A, type BodyNodeSpec as B, COMPASS as C, DEFAULT_PORTS as D, edgeHops as E, type ForceOptions as F, footprintNode as G, force as H, forceRelaxation as I, forestOf as J, labelCenter as K, type LabelPlacements as L, layered as M, layeredPlan as N, marginOf as O, type PortsOptions as P, outlinePolyline as Q, type RowNodeData as R, placeLabels as S, portLabelBox as T, portLabelsOf as U, portOf as V, portSitesOf as W, portsOf as X, portsOnOutline as Y, ranksByLength as Z, ranksOf as _, type AvoidRouter as a, routeHolds as a0, tree as a1, type AvoidOptions as b, type AvoidRoutes as c, type PlaceLabelsOptions as d, AVOID_DEFAULTS as e, type AvoidEdge as f, type AvoidEnd as g, type AvoidLabel as h, type AvoidObstacle as i, type AvoidPort as j, type AvoidUpdateOptions as k, type BuildBodyOptions as l, type ForceBody as m, type ForceRelaxation as n, type Forest as o, type LayeredPlan as p, PORT_LABEL_GAP as q, type PerimeterPortLabelBox as r, type PlaceLabel as s, type PlaceLabelsInput as t, type PlaceRoute as u, type PortLabelPlacement as v, backEdges as w, buildBody as x, chain as y, createAvoidRouter as z };

package/dist/layout.js

@@ -1,5 +1,5 @@
 import './chunk-WDIE35AK.js';
-export { AVOID_DEFAULTS, DEFAULT_HOP_SIZE, HOPS_DOC_KEY, createAvoidRouter, edgeHops, placeLabels } from './chunk-T6DQT553.js';
-export { COMPASS, DEFAULT_NODE_GAP, DEFAULT_PORTS, DEFAULT_RANK_GAP, PORT_LABEL_GAP, anchorOffset, axesFor, backEdges, bodyOutline, boxForContent, buildBody, canvasMeasure, chain, contentBox, extent, footprintNode, force, forceRelaxation, forestOf, graphOrder, labelCenter, layered, layeredPlan, layoutBody, layoutRowPorts, marginOf, measureBody, outlinePath, outlinePolyline, packAcross, pinnedSet, planOf, plannerPlan, portLabelBox, portOf, portSitesOf, portsOf, portsOnOutline, ranksByLength, ranksOf, rayHit, routeHolds, seededOrder, settle, sizeToBody, translated, tree, untilSettled } from './chunk-IM6DHWZO.js';
+export { AVOID_DEFAULTS, DEFAULT_HOP_SIZE, HOPS_DOC_KEY, createAvoidRouter, edgeHops, placeLabels } from './chunk-GA4BX7SH.js';
+export { COMPASS, DEFAULT_NODE_GAP, DEFAULT_PORTS, DEFAULT_RANK_GAP, PORT_LABEL_GAP, anchorOffset, axesFor, backEdges, bodyOutline, boxForContent, buildBody, canvasMeasure, chain, contentBox, extent, footprintNode, force, forceRelaxation, forestOf, graphOrder, labelCenter, layered, layeredPlan, layoutBody, layoutRowPorts, marginOf, measureBody, outlinePath, outlinePolyline, packAcross, pinnedSet, planOf, plannerPlan, portLabelBox, portOf, portSitesOf, portsOf, portsOnOutline, ranksByLength, ranksOf, rayHit, routeHolds, seededOrder, settle, sizeToBody, translated, tree, untilSettled } from './chunk-R2XB6D32.js';
 //# sourceMappingURL=layout.js.map
 //# sourceMappingURL=layout.js.map

package/dist/{types-BbHunLXm.d.ts → types-M_ccNAlk.d.ts}

@@ -98,167 +98,6 @@ declare function diagramLabelOf(node: {
     data: unknown;
 }): DiagramLabel | null;
 
-/**
- * The container trait: what makes a core `ContainerNode` a diagram container,
- * a pool, or one of a pool's lanes, and where its header is.
- *
- * A container's title is a text child in its header, named
- * `<container id>/title`. The layouts find it by that name, because a layout
- * strategy sees only ids and poses.
- */
-
-/** Which kind of region a container is. */
-type ContainerRole = 'container' | 'pool' | 'lane';
-/** The strip a container's title sits in, along one side. */
-interface ContainerHeader {
-    side: 'top' | 'left';
-    /** Its depth into the container, in world units. */
-    size: number;
-}
-/** The container half of a diagram node's trait, under `data.diagram.container`. */
-interface DiagramContainer {
-    role: ContainerRole;
-    header?: ContainerHeader;
-    /** Its box is fitted to its members each time the diagram is built from data
-     *  (`DataContainer` with no `box`), so a move that carries it along is no edit of its own. */
-    fitted?: true;
-}
-type Box = {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-/** The container trait on a node's data, or `null`. */
-declare function diagramContainerOf(node: {
-    data: unknown;
-}): DiagramContainer | null;
-/** The id of a container's title node. */
-declare const titleIdOf: (containerId: string) => string;
-/** The header strip of a container at `bounds`; null with no header. */
-declare function headerBox(bounds: Box, header: ContainerHeader | undefined): Box | null;
-/** What a container at `bounds` holds members in: everything past its header. */
-declare function bodyBox(bounds: Box, header: ContainerHeader | undefined): Box;
-
-/** A color on a shape or connector that the author can set by hand, and a theme then leaves alone.
- *  On a connector, `text` is its label's color. */
-type StyleField = 'fill' | 'stroke' | 'text';
-/** A part of a shape's or connector's text face the author can set by hand, which a theme then
- *  leaves alone. Kept apart from {@link StyleField}, so choosing a role, which hands back the
- *  colors, keeps it. */
-type FontField = 'size';
-
-/**
- * Where a port sits on its node, in **normalized bounds coordinates**:
- * `(0, 0)` is the top-left corner of the node's AABB and `(1, 1)` the
- * bottom-right. `COMPASS` names the eight positions almost everything wants.
- *
- * Normalized rather than absolute because a node's size is authored data that
- * resize, align and distribute all write — a port fixed at an offset would
- * drift off the shape the first time one of them ran.
- */
-interface PortAnchor {
-    u: number;
-    v: number;
-}
-/** One more place a port may sit, and optionally the direction it faces there. */
-interface PortSite extends PortAnchor {
-    normal?: Vec2 | null;
-}
-/** One attachment point declared on a node. */
-interface PortSpec {
-    /** Unique within the node. Edges name this, so it outlives a re-layout. */
-    id: string;
-    at: PortAnchor;
-    /** Other places the port may sit. An edge meeting the port takes whichever
-     *  of `at` and these faces the edge's next point most directly, so a
-     *  diamond's second exit can leave by its top or its bottom vertex, toward
-     *  wherever its wire goes. Everything else that shows a port where it is —
-     *  the connect affordance, `portsOf` — reads `at`. A site faces away from
-     *  the node's center unless it gives a `normal` of its own. */
-    sites?: readonly PortSite[];
-    /** Consulted by a connect gesture's validity predicate. Uninterpreted here. */
-    type?: string;
-    /** What the port is for, drawn beside it outside the node: beside the
-     *  wire rather than across it. A built body draws it and keeps it in its
-     *  `margin`; any other participant gets it on its resolved `Port`. */
-    label?: string;
-    /** The direction an edge leaves along, overriding the one the anchor
-     *  implies. `null` means "no preferred direction" — a router goes straight
-     *  at it. Applies at `at`; each of `sites` says its own. */
-    normal?: Vec2 | null;
-}
-/**
- * The trait that makes an existing scene node a diagram participant.
- *
- * Attached to a node's `data`, not a node kind the plugin mints: a text block,
- * an image, a path, a group or a plain rect all take part by carrying this,
- * and nothing has to be authored through this package to be connectable.
- */
-interface DiagramNode {
-    /** Defaults to {@link DEFAULT_PORTS} — the four edge midpoints of the
-     *  node's own bounds, which every node has. */
-    ports?: readonly PortSpec[];
-    /** Layout must not move this node. */
-    pinned?: boolean;
-    /** What the node is *drawn* as. Present on a built body; absent on a
-     *  participant that already had a look of its own — a text block, an image,
-     *  a path — which keeps whatever painter it already matched. */
-    outline?: Outline;
-    /** Present on a group's box: a node drawn around the participants it
-     *  depends on, which layout keeps together and leaves room for. The box
-     *  itself is never laid out — it derives its pose from its members — but an
-     *  edge can attach to it like any participant. */
-    group?: DiagramGroup;
-    /** Present on a container, a pool, or a lane: a `ContainerNode` holding
-     *  members (`containers/trait.ts`). */
-    container?: DiagramContainer;
-    /** How far past its bounds something drawn with it reaches, on each side —
-     *  a built body's port labels. Layout keeps neighbors that far off too. */
-    margin?: GroupInset;
-    /** The theme role it is drawn in. Unset, the theme's default role. */
-    style?: string;
-    /** The colors the author set by hand, which a theme leaves as they are. */
-    ownStyle?: readonly StyleField[];
-    /** The parts of its text face the author set by hand, which a theme leaves as they are. */
-    ownFont?: readonly FontField[];
-    /** On a built body whose rows are all text: how it stacks them, so it can be laid out again when
-     *  their text changes size. Each row's text node carries its place as `bodyRow`. */
-    body?: BodyLayout;
-}
-/** How a built body stacks its text rows: the `BodySpec` fields its layout reads, and how many rows. */
-interface BodyLayout {
-    padding: number;
-    gap: number;
-    verticalAlign: 'top' | 'center' | 'bottom';
-    rows: number;
-}
-/** The group half of a {@link DiagramNode}. */
-interface DiagramGroup {
-    /** Room the box keeps around its members, in world units: one number for
-     *  every side, or per side. Default 12 on each. */
-    inset?: number | Partial<GroupInset>;
-    /** The narrowest the box may be, in world units, as room for its label.
-     *  A box its members leave narrower grows evenly on both sides. */
-    minWidth?: number;
-    /** The axis its members can be dragged along to change their order. */
-    reorder?: 'x' | 'y';
-}
-/** A port resolved against a node's current pose: where it is in world
- *  coordinates, and which way an edge leaves it. */
-interface Port {
-    id: string;
-    /** The node this port belongs to. */
-    nodeId: string;
-    /** World point an edge attaches to. */
-    point: Vec2;
-    /** Unit vector pointing away from the node, or `null` when the port
-     *  declared no direction. Rotated with the node. */
-    normal: Vec2 | null;
-    type?: string;
-    label?: string;
-}
-
 /**
  * Reading the `DiagramNode` trait off a scene node.
  *
@@ -655,53 +494,165 @@ declare function packClusters(graph: Graph, rows: readonly (readonly GraphNode[]
 declare function expandGroupEdges(edges: readonly GraphEdge[], groups: readonly GraphGroup[]): GraphEdge[];
 
 /**
- * Perimeter port labels: where the text naming a port is drawn, and how far
- * past its node that reaches.
+ * The container trait: what makes a core `ContainerNode` a diagram container,
+ * a pool, or one of a pool's lanes, and where its header is.
  *
- * A label sits outside the node, on the port's own face, and to one side of
- * the line the port's wire leaves along, so the wire does not run through it.
- * A port inside a row draws its label inside the box instead; that is a
- * `ports` row's job, not this module's.
+ * A container's title is a text child in its header, named
+ * `<container id>/title`. The layouts find it by that name, because a layout
+ * strategy sees only ids and poses.
  */
 
-/** Between a port and the near sides of its label, in world units. */
-declare const PORT_LABEL_GAP = 4;
+/** Which kind of region a container is. */
+type ContainerRole = 'container' | 'pool' | 'lane';
+/** The strip a container's title sits in, along one side. */
+interface ContainerHeader {
+    side: 'top' | 'left';
+    /** Its depth into the container, in world units. */
+    size: number;
+}
+/** The container half of a diagram node's trait, under `data.diagram.container`. */
+interface DiagramContainer {
+    role: ContainerRole;
+    header?: ContainerHeader;
+    /** Its box is fitted to its members each time the diagram is built from data
+     *  (`DataContainer` with no `box`), so a move that carries it along is no edit of its own. */
+    fitted?: true;
+}
+type Box = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** The container trait on a node's data, or `null`. */
+declare function diagramContainerOf(node: {
+    data: unknown;
+}): DiagramContainer | null;
+/** The id of a container's title node. */
+declare const titleIdOf: (containerId: string) => string;
+/** The header strip of a container at `bounds`; null with no header. */
+declare function headerBox(bounds: Box, header: ContainerHeader | undefined): Box | null;
+/** What a container at `bounds` holds members in: everything past its header. */
+declare function bodyBox(bounds: Box, header: ContainerHeader | undefined): Box;
+
+/** A color on a shape or connector that the author can set by hand, and a theme then leaves alone.
+ *  On a connector, `text` is its label's color. */
+type StyleField = 'fill' | 'stroke' | 'text';
+/** A part of a shape's or connector's text face the author can set by hand, which a theme then
+ *  leaves alone. Kept apart from {@link StyleField}, so choosing a role, which hands back the
+ *  colors, keeps it. */
+type FontField = 'size';
+
+/**
+ * Where a port sits on its node, in **normalized bounds coordinates**:
+ * `(0, 0)` is the top-left corner of the node's AABB and `(1, 1)` the
+ * bottom-right. `COMPASS` names the eight positions almost everything wants.
+ *
+ * Normalized rather than absolute because a node's size is authored data that
+ * resize, align and distribute all write — a port fixed at an offset would
+ * drift off the shape the first time one of them ran.
+ */
+interface PortAnchor {
+    u: number;
+    v: number;
+}
+/** One more place a port may sit, and optionally the direction it faces there. */
+interface PortSite extends PortAnchor {
+    normal?: Vec2 | null;
+}
+/** One attachment point declared on a node. */
+interface PortSpec {
+    /** Unique within the node. Edges name this, so it outlives a re-layout. */
+    id: string;
+    at: PortAnchor;
+    /** Other places the port may sit. An edge meeting the port takes whichever
+     *  of `at` and these faces the edge's next point most directly, so a
+     *  diamond's second exit can leave by its top or its bottom vertex, toward
+     *  wherever its wire goes. Everything else that shows a port where it is —
+     *  the connect affordance, `portsOf` — reads `at`. A site faces away from
+     *  the node's center unless it gives a `normal` of its own. */
+    sites?: readonly PortSite[];
+    /** Consulted by a connect gesture's validity predicate. Uninterpreted here. */
+    type?: string;
+    /** What the port is for, drawn beside it outside the node: beside the
+     *  wire rather than across it. A built body draws it and keeps it in its
+     *  `margin`; any other participant gets it on its resolved `Port`. */
+    label?: string;
+    /** The direction an edge leaves along, overriding the one the anchor
+     *  implies. `null` means "no preferred direction" — a router goes straight
+     *  at it. Applies at `at`; each of `sites` says its own. */
+    normal?: Vec2 | null;
+}
 /**
- * Where a label `size` big goes for a port at `point` facing `normal`.
+ * The trait that makes an existing scene node a diagram participant.
  *
- * A port on a left or right face gets its label outside that face, above its
- * wire; one on a top or bottom face, outside that face, right of its wire; a
- * corner port, off the corner. A port with no direction gets it centered
- * above.
+ * Attached to a node's `data`, not a node kind the plugin mints: a text block,
+ * an image, a path, a group or a plain rect all take part by carrying this,
+ * and nothing has to be authored through this package to be connectable.
  */
-declare function portLabelBox(port: {
+interface DiagramNode {
+    /** Defaults to {@link DEFAULT_PORTS} — the four edge midpoints of the
+     *  node's own bounds, which every node has. */
+    ports?: readonly PortSpec[];
+    /** Layout must not move this node. */
+    pinned?: boolean;
+    /** What the node is *drawn* as. Present on a built body; absent on a
+     *  participant that already had a look of its own — a text block, an image,
+     *  a path — which keeps whatever painter it already matched. */
+    outline?: Outline;
+    /** Present on a group's box: a node drawn around the participants it
+     *  depends on, which layout keeps together and leaves room for. The box
+     *  itself is never laid out — it derives its pose from its members — but an
+     *  edge can attach to it like any participant. */
+    group?: DiagramGroup;
+    /** Present on a container, a pool, or a lane: a `ContainerNode` holding
+     *  members (`containers/trait.ts`). */
+    container?: DiagramContainer;
+    /** How far past its bounds something drawn with it reaches, on each side —
+     *  a built body's port labels. Layout keeps neighbors that far off too. */
+    margin?: GroupInset;
+    /** The theme role it is drawn in. Unset, the theme's default role. */
+    style?: string;
+    /** The colors the author set by hand, which a theme leaves as they are. */
+    ownStyle?: readonly StyleField[];
+    /** The parts of its text face the author set by hand, which a theme leaves as they are. */
+    ownFont?: readonly FontField[];
+    /** On a built body whose rows are all text: how it stacks them, so it can be laid out again when
+     *  their text changes size. Each row's text node carries its place as `bodyRow`. */
+    body?: BodyLayout;
+}
+/** How a built body stacks its text rows: the `BodySpec` fields its layout reads, and how many rows. */
+interface BodyLayout {
+    padding: number;
+    gap: number;
+    verticalAlign: 'top' | 'center' | 'bottom';
+    rows: number;
+}
+/** The group half of a {@link DiagramNode}. */
+interface DiagramGroup {
+    /** Room the box keeps around its members, in world units: one number for
+     *  every side, or per side. Default 12 on each. */
+    inset?: number | Partial<GroupInset>;
+    /** The narrowest the box may be, in world units, as room for its label.
+     *  A box its members leave narrower grows evenly on both sides. */
+    minWidth?: number;
+    /** The axis its members can be dragged along to change their order. */
+    reorder?: 'x' | 'y';
+}
+/** A port resolved against a node's current pose: where it is in world
+ *  coordinates, and which way an edge leaves it. */
+interface Port {
+    id: string;
+    /** The node this port belongs to. */
+    nodeId: string;
+    /** World point an edge attaches to. */
     point: Vec2;
+    /** Unit vector pointing away from the node, or `null` when the port
+     *  declared no direction. Rotated with the node. */
     normal: Vec2 | null;
-}, size: {
-    width: number;
-    height: number;
-}, gap?: number): Bounds;
-/** Where a built body's perimeter port label sits, as `buildBody`'s
- *  `portLabel` is handed it. */
-interface PerimeterPortLabelBox extends Bounds {
-    port: PortSpec;
-    side: 'outside';
-}
-/** A labeled port, resolved, and the box its label is drawn in. */
-interface PortLabelPlacement {
-    port: Port & {
-        label: string;
-    };
-    box: Bounds;
+    type?: string;
+    label?: string;
 }
-/** Every labeled port of `trait` resolved against `bounds`, with its label's
- *  box. `size` measures one label. */
-declare function portLabelsOf(trait: DiagramNode, bounds: Bounds, size: (text: string) => {
-    width: number;
-    height: number;
-}): PortLabelPlacement[];
-/** How far `boxes` reach past `bounds` on each side; `undefined` for none. */
-declare function marginOf(bounds: Bounds, boxes: readonly Bounds[]): GroupInset | undefined;
 
 /** One line of body content. */
 type Row = 
@@ -774,20 +725,6 @@ interface BodySpec {
     /** Perimeter port labels by id, drawn outside the box; over a port's own `label`. */
     portLabels?: Readonly<Record<string, string>>;
 }
-/** What {@link buildBody} emits: the `AddNodeSpec` fields it fills in. Named
- *  structurally rather than imported so a consumer whose scene is typed
- *  differently can still spread one. */
-interface BodyNodeSpec<TData, TLayer extends string, TPose> {
-    kind: 'container' | 'leaf';
-    layer: TLayer;
-    pose: TPose;
-    data: TData;
-    id?: string;
-    parent?: string;
-    /** Set `false` on every leaf the builder emits: the innermost hit wins, so a
-     *  row that answers a press is a body that cannot be dragged. */
-    pickable?: boolean;
-}
 /** The floor a body's content puts under its node's size. */
 interface BodyFloor {
     minWidth: number;
@@ -859,44 +796,6 @@ declare function bodyTrait(spec: BodySpec, bounds: Bounds, measure?: MeasureRowT
 /** The outline path for a built body at `bounds` — what paints it, and what a
  *  perimeter-hugging port will eventually be placed on. */
 declare function bodyOutline(spec: BodySpec, bounds: Bounds): _weasel_js_geom.Path;
-/** What a built body's rows are handed to, one call per row.
- *
- *  `text` is the row's content already formatted — a `label`'s own text, or a
- *  `field`'s `"label: value"` — so the common case needs no discrimination.
- *  Return `null` for a row the consumer paints itself; `ports` and `slot` rows
- *  arrive with `text` empty and are the usual ones to decline. */
-type RowNodeData<TData> = (text: string, box: RowBox) => TData | null;
-/** Options for {@link buildBody}: the layer and data of each node it emits.
- *  Without `measure`, rows are sized from a fallback line height rather than
- *  their text. */
-interface BuildBodyOptions<TData, TLayer extends string, TPose extends Bounds> {
-    layer: TLayer;
-    /** The container's id. Edges name it, so pass one for anything an edge or a
-     *  layout `pin` will refer to. */
-    id?: string;
-    measure?: MeasureRowText;
-    /** The container's own data, given the trait the builder computed and the
-     *  pose it was computed against. */
-    body: (trait: DiagramNode, pose: TPose) => TData;
-    /** One row's data, or `null` to leave that row undrawn. */
-    row: RowNodeData<TData>;
-    /** One port's label — a row port's or a perimeter port's — or `null` to
-     *  leave it undrawn. Ports with no label are never offered. Omit to draw none. */
-    portLabel?: (text: string, box: RowPortBox | PerimeterPortLabelBox) => TData | null;
-}
-/**
- * The scene nodes a built body is: one container carrying the trait, and one
- * leaf per row that wants drawing.
- *
- * Rows are ordinary scene nodes rather than something this package paints, so
- * the kit's own text painter draws them and text editing, styling, and
- * selection work on them unchanged. The returned pose is `at` grown to fit the
- * body, never shrunk.
- */
-declare function buildBody<TData, TLayer extends string, TPose extends Bounds>(spec: BodySpec, at: TPose, opts: BuildBodyOptions<TData, TLayer, TPose>): {
-    pose: TPose;
-    specs: BodyNodeSpec<TData, TLayer, TPose>[];
-};
 
 /**
  * Line jumps as data: the document value that turns them on, and the hops a
@@ -923,4 +822,4 @@ interface EdgeHop {
     r: number;
 }
 
-export { type PortSite as $, DEFAULT_RANK_GAP as A, type BodySpec as B, type ContainerRole as C, type DiagramGroup as D, type EdgeHop as E, type FontField as F, type Graph as G, DIAGRAM_TRAIT_KEY as H, type DiagramNodeEntry as I, type EdgeLabelRoom as J, type GraphEdge as K, type LayoutPorts as L, type MeasureRowText as M, type GraphGroup as N, type Outline as O, type PortAnchor as P, type GraphNode as Q, type RowTextStyle as R, type StyleField as S, type GroupInset as T, HOPS_DOC_KEY as U, type HopsDocValue as V, LABEL_PLACEMENT as W, type LayoutAxes as X, PORT_LABEL_GAP as Y, type PerimeterPortLabelBox as Z, type PortLabelPlacement as _, type Row as a, type RowBox as a0, type RowNodeData as a1, type RowPort as a2, type RowPortBox as a3, type Slot as a4, anchorOffset as a5, axesFor as a6, bodyBox as a7, bodyOutline as a8, bodyTrait as a9, portLabelsOf as aA, rankGaps as aB, seededOrder as aC, settle as aD, sizeToBody as aE, titleIdOf as aF, translated as aG, untilSettled as aH, extent as aI, boxForContent as aa, buildBody as ab, buildGraph as ac, canvasMeasure as ad, contentBox as ae, createDiagramNodes as af, dataKeyReader as ag, diagramContainerOf as ah, diagramLabelOf as ai, diagramNodeOf as aj, expandGroupEdges as ak, graphOrder as al, headerBox as am, insetOf as an, isPinned as ao, layoutBody as ap, layoutRowPorts as aq, marginOf as ar, measureBody as as, outlinePath as at, packAcross as au, packClusters as av, pinnedSet as aw, planOf as ax, plannerPlan as ay, portLabelBox as az, type PortSpec as b, type DiagramLabel as c, type LayoutFn as d, type LayoutOptions as e, type DiagramNode as f, type Port as g, type DiagramNodeLike as h, type DiagramNodeReader as i, type DiagramContainer as j, type ContainerHeader as k, type LabelSpot as l, type Bounds as m, type LayoutResult as n, type GraphSource as o, type LayoutPlanner as p, type LayoutDirection as q, type LayoutPlan as r, type GraphNodeLike as s, type BodyFloor as t, type BodyNodeSpec as u, type BuildBodyOptions as v, type BuildGraphOptions as w, DEFAULT_GROUP_INSET as x, DEFAULT_HOP_SIZE as y, DEFAULT_NODE_GAP as z };
+export { anchorOffset as $, type DiagramNodeEntry as A, type BodySpec as B, type ContainerRole as C, type DiagramGroup as D, type EdgeHop as E, type FontField as F, type Graph as G, type EdgeLabelRoom as H, type GraphEdge as I, type GraphGroup as J, type GraphNode as K, type LayoutPorts as L, type MeasureRowText as M, type GroupInset as N, type Outline as O, type PortAnchor as P, HOPS_DOC_KEY as Q, type RowTextStyle as R, type StyleField as S, type HopsDocValue as T, LABEL_PLACEMENT as U, type LayoutAxes as V, type PortSite as W, type RowBox as X, type RowPort as Y, type RowPortBox as Z, type Slot as _, type Row as a, axesFor as a0, bodyBox as a1, bodyOutline as a2, bodyTrait as a3, boxForContent as a4, buildGraph as a5, canvasMeasure as a6, contentBox as a7, createDiagramNodes as a8, dataKeyReader as a9, diagramContainerOf as aa, diagramLabelOf as ab, diagramNodeOf as ac, expandGroupEdges as ad, graphOrder as ae, headerBox as af, insetOf as ag, isPinned as ah, layoutBody as ai, layoutRowPorts as aj, measureBody as ak, outlinePath as al, packAcross as am, packClusters as an, pinnedSet as ao, planOf as ap, plannerPlan as aq, rankGaps as ar, seededOrder as as, settle as at, sizeToBody as au, titleIdOf as av, translated as aw, untilSettled as ax, extent as ay, type PortSpec as b, type DiagramLabel as c, type LayoutFn as d, type LayoutOptions as e, type DiagramNode as f, type Port as g, type DiagramNodeLike as h, type DiagramNodeReader as i, type DiagramContainer as j, type ContainerHeader as k, type LabelSpot as l, type Bounds as m, type LayoutResult as n, type GraphSource as o, type LayoutPlanner as p, type LayoutDirection as q, type LayoutPlan as r, type GraphNodeLike as s, type BodyFloor as t, type BuildGraphOptions as u, DEFAULT_GROUP_INSET as v, DEFAULT_HOP_SIZE as w, DEFAULT_NODE_GAP as x, DEFAULT_RANK_GAP as y, DIAGRAM_TRAIT_KEY as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/diagram",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Node-link diagramming for weasel: any scene node becomes a diagram participant, with ports on its perimeter and an optional body builder for flowchart-shaped boxes.",
   "license": "MIT",
   "type": "module",
@@ -33,13 +33,13 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@weasel-js/animator": "1.11.1",
-    "@weasel-js/audio": "1.11.1",
-    "@weasel-js/core": "1.11.1",
-    "@weasel-js/font": "1.11.1",
-    "@weasel-js/geom": "1.11.1",
-    "@weasel-js/react": "1.11.1",
-    "@weasel-js/simulation": "1.11.1"
+    "@weasel-js/animator": "1.12.0",
+    "@weasel-js/audio": "1.12.0",
+    "@weasel-js/core": "1.12.0",
+    "@weasel-js/font": "1.12.0",
+    "@weasel-js/geom": "1.12.0",
+    "@weasel-js/react": "1.12.0",
+    "@weasel-js/simulation": "1.12.0"
   },
   "peerDependenciesMeta": {
     "@weasel-js/audio": {
@@ -50,7 +50,7 @@
     "table": "./dist/icons.table.json"
   },
   "dependencies": {
-    "@weasel-js/icons": "1.11.1"
+    "@weasel-js/icons": "1.12.0"
   },
   "author": "orochi235",
   "homepage": "https://orochi235.github.io/weasel/",