@meltemi/diagrams-layout 0.0.0-stage → 1.9.0

package/dist/icons.js

@@ -0,0 +1,94 @@
+const round = (value) => Math.round(value * 1000) / 1000;
+/**
+ * Turns resolved icons into scene groups. Each icon instance gets its own gradient ids, so two
+ * icons with gradients of the same name never clash in one SVG.
+ */
+export class IconPainter {
+    gradients = [];
+    count = 0;
+    /**
+     * The icon drawn in a square of `size` whose top-left corner is (x, y): its view box scaled by
+     * the pack's optical scale and centred in the square. Monochrome paints take `color`.
+     */
+    draw(icon, x, y, size, color) {
+        const instance = ++this.count;
+        const { viewBox } = icon.geometry;
+        const drawn = size * icon.scale;
+        const scale = drawn / Math.max(viewBox.width, viewBox.height);
+        const tx = x + (size - viewBox.width * scale) / 2 - viewBox.x * scale;
+        const ty = y + (size - viewBox.height * scale) / 2 - viewBox.y * scale;
+        const ids = new Map();
+        for (const gradient of icon.geometry.gradients) {
+            const id = `icon-${instance}-${gradient.id}`;
+            ids.set(gradient.id, id);
+            this.gradients.push(sceneGradient(gradient, id));
+        }
+        const paint = (value) => {
+            switch (value.kind) {
+                case "none":
+                    return "none";
+                case "current":
+                    return color;
+                case "color":
+                    return value.value;
+                case "gradient":
+                    return `url(#${ids.get(value.id) ?? value.id})`;
+            }
+        };
+        const items = icon.geometry.paths.map((path) => ({
+            kind: "path",
+            d: path.d,
+            fill: paint(path.fill),
+            stroke: paint(path.stroke),
+            strokeWidth: path.stroke.kind === "none" ? 0 : path.strokeWidth,
+            dashed: false,
+            ...(path.lineCap === "round" || path.lineJoin === "round" ? { rounded: true } : {}),
+            ...(path.transform ? { transform: path.transform } : {}),
+            ...(path.opacity < 1 ? { opacity: path.opacity } : {}),
+            ...(path.fillOpacity < 1 ? { fillOpacity: path.fillOpacity } : {}),
+            ...(path.strokeOpacity < 1 ? { strokeOpacity: path.strokeOpacity } : {}),
+            ...(path.fillRule === "evenodd" ? { fillRule: "evenodd" } : {}),
+        }));
+        return {
+            kind: "group",
+            id: icon.reference,
+            role: "icon",
+            transform: `translate(${round(tx)} ${round(ty)}) scale(${round(scale)})`,
+            items,
+        };
+    }
+}
+function sceneGradient(gradient, id) {
+    const common = {
+        id,
+        units: gradient.units,
+        ...(gradient.transform ? { transform: gradient.transform } : {}),
+        ...(gradient.spread !== "pad" ? { spread: gradient.spread } : {}),
+        stops: gradient.stops.map((stop) => ({
+            offset: stop.offset,
+            color: stop.color,
+            ...(stop.opacity < 1 ? { opacity: stop.opacity } : {}),
+        })),
+    };
+    const c = gradient.coordinates;
+    if (gradient.kind === "linear") {
+        return {
+            kind: "linear",
+            ...common,
+            x1: c.x1 ?? "0%",
+            y1: c.y1 ?? "0%",
+            x2: c.x2 ?? "100%",
+            y2: c.y2 ?? "0%",
+        };
+    }
+    return {
+        kind: "radial",
+        ...common,
+        ...(c.cx !== undefined ? { cx: c.cx } : {}),
+        ...(c.cy !== undefined ? { cy: c.cy } : {}),
+        ...(c.r !== undefined ? { r: c.r } : {}),
+        ...(c.fx !== undefined ? { fx: c.fx } : {}),
+        ...(c.fy !== undefined ? { fy: c.fy } : {}),
+    };
+}
+//# sourceMappingURL=icons.js.map

package/dist/icons.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export declare const PACKAGE_NAME = "@meltemi/diagrams-layout";
+export type * from "./scene.js";
+export * from "./theme.js";
+export * from "./geometry.js";
+export * from "./markers.js";
+export { strokeDash } from "./scene.js";
+export { MELTEMI_MARK, MARK_GRADIENT_ID, markGradient, markGroup } from "./mark.js";
+export { estimateTextWidth, splitLines } from "./text.js";
+export { MIN_TEXT_MARGIN, TEXT_PADDING, TextMetrics, estimateMeasurer, type TextMeasurer, } from "./measure.js";
+export { c4TypeLine, c4TypeName, layoutDiagram, typeScale, DEFAULT_SIZES, DOCUMENT_MAX_WIDTH, PATTERN_SIZE, SLIDE_SIZE, type LayoutOptions, type LayoutResult, type ConnectorGeometry, type TypeScale, } from "./layout.js";
+export { StyleResolver, themeColor, type PatternKind, type ResolvedStyle } from "./styles.js";
+export { CORNERED_POLYGONS, CORNERED_SHAPES, SHAPE_SIZES, onOutline, onPolygon, pointInPolygon, pointInShape, segmentCrossesShape, shapeMagnets, shapeOutline, shapeTextArea, shapeTextCenter, turnPoint, turnedOutline, type BoxShape, type ShapeMagnet, type ShapeOptions, type ShapeOutline, type ShapeSize, } from "./shapes.js";
+export { groupHeaderOf, isUntitledGroup, type FrameTheme } from "./free.js";
+export * from "./engine.js";
+export { solveConstraints, type ConstraintConflict, type SolverBox } from "./constraints.js";
+export { checkComposition, stacked, type CheckedConnector } from "./checks.js";
+export { auditLabels, type LabelProblem, type PlacedText } from "./audit.js";
+export { LANE_SPACING, anchorPoints, bezierThrough, orthogonalize, portPoint, type ConnectorEnd, } from "./routing.js";
+export { drawingWords } from "./messages/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,mBAAmB,YAAY,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5E,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export const PACKAGE_NAME = "@meltemi/diagrams-layout";
+export * from "./theme.js";
+export * from "./geometry.js";
+export * from "./markers.js";
+export { strokeDash } from "./scene.js";
+export { MELTEMI_MARK, MARK_GRADIENT_ID, markGradient, markGroup } from "./mark.js";
+export { estimateTextWidth, splitLines } from "./text.js";
+export { MIN_TEXT_MARGIN, TEXT_PADDING, TextMetrics, estimateMeasurer, } from "./measure.js";
+export { c4TypeLine, c4TypeName, layoutDiagram, typeScale, DEFAULT_SIZES, DOCUMENT_MAX_WIDTH, PATTERN_SIZE, SLIDE_SIZE, } from "./layout.js";
+export { StyleResolver, themeColor } from "./styles.js";
+export { CORNERED_POLYGONS, CORNERED_SHAPES, SHAPE_SIZES, onOutline, onPolygon, pointInPolygon, pointInShape, segmentCrossesShape, shapeMagnets, shapeOutline, shapeTextArea, shapeTextCenter, turnPoint, turnedOutline, } from "./shapes.js";
+export { groupHeaderOf, isUntitledGroup } from "./free.js";
+export * from "./engine.js";
+export { solveConstraints } from "./constraints.js";
+export { checkComposition, stacked } from "./checks.js";
+export { auditLabels } from "./audit.js";
+export { LANE_SPACING, anchorPoints, bezierThrough, orthogonalize, portPoint, } from "./routing.js";
+export { drawingWords } from "./messages/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAGvD,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,UAAU,GAKX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAwC,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,GAMd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAmB,MAAM,WAAW,CAAC;AAC5E,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAA2C,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAyB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAsC,MAAM,YAAY,CAAC;AAC7E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,206 @@
+import { type Locale } from "@meltemi/diagrams-i18n";
+import { type IconResolver, type ImageResolver } from "@meltemi/diagrams-assets";
+import type { Diagnostic, LineIndex } from "@meltemi/diagrams-language";
+import type { Compilation, Element, ElementKind, FlowDiagram, LayoutMode, Point, ThemeDefinition } from "@meltemi/diagrams-model";
+import { type LayoutEngine } from "./engine.js";
+import { type Box } from "./geometry.js";
+import { type GroupItem, type Scene } from "./scene.js";
+import { TextMetrics, type TextMeasurer } from "./measure.js";
+import { type BoxShape } from "./shapes.js";
+import { type Theme } from "./theme.js";
+export interface LayoutOptions {
+    /** Theme name that overrides the diagram's `theme` property. */
+    readonly theme?: string | null;
+    /** Theme used when the diagram has no `theme` property, such as the project's default theme. */
+    readonly defaultTheme?: string | null;
+    /**
+     * Theme definitions to resolve names against instead of the file's own themes; projects pass the
+     * scope from `themeDefinitionsFor(file)` so imported themes resolve.
+     */
+    readonly themes?: readonly ThemeDefinition[];
+    /** Measures text; defaults to estimates. Hosts with fonts pass `@meltemi/diagrams-fonts`. */
+    readonly measurer?: TextMeasurer;
+    /** Resolves `icon` references; without it icons are not drawn. Projects pass their registry. */
+    readonly icons?: IconResolver;
+    /** Arranges `auto` and `assisted` diagrams; without it they render only when fully placed. */
+    readonly engine?: LayoutEngine;
+    /**
+     * Lays out as if the diagram's `layout` were this mode. The `layout` command arranges the
+     * unplaced elements with `assisted` and every element with `auto`.
+     */
+    readonly layout?: LayoutMode;
+    /**
+     * Resolves the paths of `image` objects, relative to the diagram's file. Without it, or for a
+     * file that cannot be read, a placeholder is drawn and `layout.image-unavailable` is reported.
+     */
+    readonly images?: ImageResolver;
+    /** Sequence diagrams: lays out one scenario instead of every event. */
+    readonly scenario?: string;
+    /**
+     * The language of the words the layout adds to the drawing (the type lines of C4 entities):
+     * the project's `locale` or an export's. English by default; never the machine's language.
+     */
+    readonly locale?: Locale;
+}
+export interface LayoutResult {
+    readonly scene: Scene | null;
+    readonly diagnostics: readonly Diagnostic[];
+    /**
+     * Boxes of the elements and groups in diagram coordinates, where `place` statements live, when
+     * there is a scene. The scene itself is moved to make room for margins and the frame.
+     */
+    readonly boxes?: ReadonlyMap<string, Box>;
+    /** Scene coordinates minus diagram coordinates, when there is a scene. */
+    readonly offset?: Point;
+    /** Label pills of the relations that have one, by relation key, in diagram coordinates. */
+    readonly labels?: ReadonlyMap<string, Box>;
+    /** The route of every relation, by relation key, in diagram coordinates. */
+    readonly connectors?: ReadonlyMap<string, ConnectorGeometry>;
+    /**
+     * Free diagrams: the interior origin of the parent group of every group child, in diagram
+     * coordinates. A child's written `place` is its centre minus this origin. Empty for flow.
+     */
+    readonly origins?: ReadonlyMap<string, Point>;
+    /** The resolved theme the diagram was laid out with, when there is a scene. */
+    readonly theme?: Theme;
+    /** Sequence diagrams: the row band of every event by key, in diagram coordinates. */
+    readonly events?: ReadonlyMap<string, {
+        readonly y: number;
+        readonly height: number;
+    }>;
+    /**
+     * The drawn shape of every element box but groups', when there is a scene: the `shape` of a free
+     * box or a flow node, a decision's diamond, a data store's cylinder, a C4 person's person, a
+     * tag's pill, and `rounded` for the others. Hosts pass it with the box to `shapeOutline`,
+     * `onOutline`, `shapeMagnets` and `pointInShape`. Absent for sequence diagrams.
+     */
+    readonly shapes?: ReadonlyMap<string, BoxShape>;
+    /**
+     * The label of every element that draws it outside its box (`shape icon`), by element id, in
+     * diagram coordinates: from the top of its first line to the descenders of its last. The box in
+     * `boxes` stays the icon's square, which connectors, magnets, handles and selection use; the
+     * element's extent, which the engine and derived groups use, is the union of both, and the
+     * composition checks take the square and the label as two rectangles. Absent for sequence
+     * diagrams.
+     */
+    readonly elementLabels?: ReadonlyMap<string, Box>;
+    /**
+     * The angle of every turned element, clockwise in degrees about the centre of its box in
+     * `boxes`, which stays its unturned box (decision 0045).
+     */
+    readonly rotations?: ReadonlyMap<string, number>;
+    /**
+     * The corner radius every element with corners is drawn with, its `ShapeOptions.radius`, for
+     * hosts that draw its outline, magnets and hit tests with `shapeOutline` and its relatives.
+     */
+    readonly radii?: ReadonlyMap<string, number>;
+}
+/** Where a relation is drawn, for editors. */
+export interface ConnectorGeometry {
+    /** The route from the source anchor to the target anchor, before the arrowhead is cut out. */
+    readonly points: readonly Point[];
+    /**
+     * The polyline the connector is drawn with, the heads cut out: a Bézier route's samples, the
+     * rounded corners, the elbows of a detour.
+     */
+    readonly line: readonly Point[];
+    readonly fromSide: "north" | "south" | "east" | "west";
+    readonly toSide: "north" | "south" | "east" | "west";
+    /** The waypoints written in the relation's `route` and used for drawing. */
+    readonly via: readonly Point[];
+}
+/** Widest content canvas of `preset document` before `layout.too-large`. */
+export declare const DOCUMENT_MAX_WIDTH = 1200;
+/** The 16:9 canvas of `preset slide`. */
+export declare const SLIDE_SIZE: {
+    readonly width: 1920;
+    readonly height: 1080;
+};
+/** Size of one pattern tile in pixels. */
+export declare const PATTERN_SIZE = 8;
+/** Default box sizes of the `technical.*` type scale (13 px labels); others scale with `labelSize`. */
+export declare const DEFAULT_SIZES: Readonly<Record<ElementKind, {
+    width: number;
+    height: number;
+} | null>>;
+/**
+ * The type line of a C4 entity in the content language: `[Container: React]`, `[Contenedor: React]`.
+ * The content language is explicit (English by default), never the interface's.
+ */
+export declare function c4TypeLine(element: Element, locale?: Locale): string | null;
+/**
+ * The type word of a C4 entity in the content language, as its type line draws it without the
+ * brackets and the technology: `Container`, `External Software System`, `Contenedor`. Null for
+ * the boundary group and for elements that draw no entity.
+ */
+export declare function c4TypeName(element: Pick<Element, "entity" | "kind" | "external">, locale?: Locale): string | null;
+/** Type sizes, line heights and frame measures derived from a theme's type tokens. */
+export interface TypeScale {
+    readonly label: number;
+    readonly labelWeight: number;
+    readonly description: number;
+    readonly descriptionLine: number;
+    readonly groupTitle: number;
+    readonly note: number;
+    readonly noteLine: number;
+    readonly tag: number;
+    readonly tagHeight: number;
+    readonly tagPadding: number;
+    readonly relationLabel: number;
+    readonly relationLabelHeight: number;
+    readonly relationLabelPadding: number;
+    readonly frameBrand: number;
+    readonly frameTitle: number;
+    readonly frameHeight: number;
+    readonly frameMark: number;
+}
+/**
+ * Derives line heights and pill sizes from the type tokens. The ratios are those of the
+ * `technical.*` themes: 11 px descriptions on 16 px lines, 18 px tags at 10.5 px, a 44 px frame
+ * at 12 px.
+ */
+export declare function typeScale(theme: Theme): TypeScale;
+/**
+ * The visible pieces of a polyline that passes under `holes`: the parts inside a hole are left
+ * out. A line no hole touches is one piece.
+ */
+export declare function splitAround(line: readonly Point[], holes: readonly Box[]): Point[][];
+/**
+ * Lays out one compiled diagram into a scene, then checks that no label is cut or overlaps
+ * another label, a box or a connector (`layout.label-cut`, `layout.label-overlap`).
+ */
+export declare function layoutDiagram(compilation: Compilation, diagram: FlowDiagram, options?: LayoutOptions): LayoutResult;
+/** Moves path data made of absolute coordinate pairs (`M` and `C` commands) by (dx, dy). */
+/** The group of an element with the element's `url`, when it has one. */
+export declare function withUrl(group: GroupItem, element: Pick<Element, "url">): GroupItem;
+/**
+ * The group with the box it was drawn in, for motion effects. The corner radius is the one of the
+ * outline drawn on that box, when there is one. `inner` is the inscribed rectangle the text of a
+ * shape other than a box lies in, and `label` the box of a label drawn outside it, for the label
+ * audit.
+ */
+export declare function withBounds(group: GroupItem, box: Box, inner?: Box, label?: Box): GroupItem;
+/**
+ * The canvas for the diagram's `preset` or `canvas`, reporting `layout.too-large` when the content
+ * canvas exceeds what the preset holds. Nothing is clipped: a fixed canvas grows to fit.
+ */
+export declare function canvasSize(diagram: FlowDiagram, width: number, height: number, lines: LineIndex, diagnostics: Diagnostic[]): {
+    width: number;
+    height: number;
+};
+/** Width the frame needs for the mark, the brand text and the title without overlap. */
+export declare function frameMinWidth(theme: Theme, scale: TypeScale, title: string | null, metrics: TextMetrics): number;
+/** How a centred icon and its label share an element's box (`iconPosition center`). */
+export interface CentredLayout {
+    /** The rectangle they share: the box, or the largest rectangle inscribed in the shape. */
+    readonly content: Box;
+    /** The room kept around the icon and between the label and the content's edge. */
+    readonly margin: number;
+    /** The band of the label at the `labelPosition` edge; empty when there is no text. */
+    readonly band: Box;
+    /** The icon's square, centred in the rest of the content. */
+    readonly icon: Box;
+    /** Whether the label's lines fit the band. */
+    readonly fits: boolean;
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

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