@meltemi/diagrams-editor 0.0.0-stage → 1.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Architecture Studio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @meltemi/diagrams-editor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Host-neutral editor services: diagnostics, completion, hover, definitions, references, rename,
+formatting, quick fixes, symbols and semantic tokens; project sessions; the canvas session and its
+protocol; exports and catalogs (`./node`). The VS Code extension and the playground are built on
+it.
+
+It is part of [Meltemi Diagrams](https://github.com/askenaz-dev/meltemi-diagrams#readme), diagrams as code with a canvas, motion and
+exports. Every package of the product has the same version.
+
+## Install
+
+```bash
+npm install @meltemi/diagrams-editor
+```
+
+Node 22.12.0 or later. The package is an ES module with type declarations.
+
+## Use
+
+```js
+import { ProjectSessions } from "@meltemi/diagrams-editor/node";
+
+const sessions = new ProjectSessions({ toolVersion: "1.0.0" });
+const analysis = sessions.analyze("/work/shop/diagrams/overview.meltemi");
+console.log(
+  analysis.diagnostics,
+  analysis.diagrams.map((d) => d.id),
+);
+```
+
+## Documentation
+
+- [Editor guide](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/docs/editor.md)
+- [All documentation](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/docs/README.md)
+
+## Licence
+
+MIT. Third-party components and their licences are listed in [THIRD_PARTY_LICENSES.md](https://github.com/askenaz-dev/meltemi-diagrams/blob/main/THIRD_PARTY_LICENSES.md).

package/dist/add-icons.d.ts

@@ -0,0 +1,44 @@
+import { type IconRegistry } from "@meltemi/diagrams-assets";
+import type { FlowDiagram } from "@meltemi/diagrams-model";
+import type { AddedIconInfo, IconFileCheck, IconFileInput, IconPrefixCheck } from "./canvas/protocol.js";
+import type { AssetSteps, ProjectStep } from "./projects.js";
+/** The prefix the Add icon dialog offers first. */
+export declare const DEFAULT_ICON_PREFIX = "project";
+/**
+ * What the Add icon dialog may do with a prefix: put the icons in a new pack, or in a pack of the
+ * project read from a folder; never in a built-in pack, a plugin's, an Iconify file of the
+ * project (the dialog writes SVG files) or an alias of `project.json`.
+ */
+export declare function checkIconPrefix(registry: IconRegistry | undefined, prefix: string): IconPrefixCheck;
+/**
+ * Each file of the Add icon dialog as the dialog shows it: the name it gets (the one asked for, or
+ * one made of the file's name and free in the pack), a preview through the sanitiser, and what
+ * keeps it from being added: an SVG the sanitiser refuses, a name a reference cannot write, a name
+ * the pack or an earlier file has.
+ */
+export declare function checkIconFiles(registry: IconRegistry | undefined, prefix: string, files: readonly IconFileInput[]): IconFileCheck[];
+/** What `addIcons` gives: the icons added, the files refused, and what to write. */
+export interface AddedIcons {
+    readonly added: readonly AddedIconInfo[];
+    readonly refused: readonly {
+        readonly file: string;
+        readonly reason: string;
+    }[];
+    /** The files of the assets, and the statements that give the first icon to the targets. */
+    readonly assets: AssetSteps;
+    readonly steps: readonly ProjectStep[];
+}
+/**
+ * The files and statements that add icons to the project: one `assets/icons/<prefix>/<name>.svg`
+ * per file that can be added, the pack's licence in `assets/licenses.json` when it has none, an
+ * item per icon in the project's library (`assets/libraries/project.json`, a category per
+ * prefix), and `style <id> { icon }` of the first icon on the targets that take one. A prefix the
+ * icons cannot go into, or a licence missing or malformed, refuses every file.
+ */
+export declare function addIcons(registry: IconRegistry | undefined, diagram: FlowDiagram | undefined, request: {
+    readonly prefix: string;
+    readonly licence?: string;
+    readonly files: readonly IconFileInput[];
+    readonly targets: readonly string[];
+}): AddedIcons;
+//# sourceMappingURL=add-icons.d.ts.map

package/dist/add-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-icons.d.ts","sourceRoot":"","sources":["../src/add-icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQ3D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAU7C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,MAAM,EAAE,MAAM,GACb,eAAe,CAoBjB;AAQD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,aAAa,EAAE,CAkCjB;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,EAAE;IACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACA,UAAU,CAyEZ"}

package/dist/add-icons.js

@@ -0,0 +1,178 @@
+import { PACK_PREFIX, geometrySvg, humanise, isIconName, sanitizeSvg, slugifyIconName, } from "@meltemi/diagrams-assets";
+import { ICONS_FOLDER, LICENSES_FILE, PROJECT_LIBRARY_FILE, iconFilePath, } from "@meltemi/diagrams-project";
+import { libraryCategoryId } from "./asset-files.js";
+import { takesIcon } from "./icons.js";
+import { messages } from "./messages/index.js";
+/** The prefix the Add icon dialog offers first. */
+export const DEFAULT_ICON_PREFIX = "project";
+/** What a licence may be written as: an SPDX identifier or a `LicenseRef-` name. */
+const LICENCE = /^(?:LicenseRef-[A-Za-z0-9.-]+|[A-Za-z0-9][A-Za-z0-9.+-]*)$/;
+/** Whether a pack is one of the project's own, read from a folder or a file under `assets/icons`. */
+function projectPack(pack) {
+    return pack.metadata.source.startsWith(`${ICONS_FOLDER}/`);
+}
+/**
+ * What the Add icon dialog may do with a prefix: put the icons in a new pack, or in a pack of the
+ * project read from a folder; never in a built-in pack, a plugin's, an Iconify file of the
+ * project (the dialog writes SVG files) or an alias of `project.json`.
+ */
+export function checkIconPrefix(registry, prefix) {
+    const words = messages().addIcons;
+    const fail = (problem) => ({
+        prefix,
+        problem,
+        existing: false,
+        licensed: false,
+    });
+    if (prefix === "")
+        return fail(words.prefixEmpty);
+    if (!PACK_PREFIX.test(prefix))
+        return fail(words.prefixInvalid(prefix));
+    const alias = registry?.aliasList()[prefix];
+    if (alias !== undefined)
+        return fail(words.prefixAlias(prefix, alias));
+    const pack = registry?.list().find((p) => p.prefix === prefix);
+    if (!pack)
+        return { prefix, existing: false, licensed: false };
+    if (pack.metadata.source === "built-in")
+        return fail(words.prefixBuiltIn(prefix));
+    if (!projectPack(pack))
+        return fail(words.prefixPlugin(prefix));
+    if (pack.metadata.source.endsWith(".json")) {
+        return fail(words.prefixIconify(prefix, pack.metadata.source));
+    }
+    return { prefix, existing: true, licensed: pack.metadata.license !== null };
+}
+/** The names a pack has, lower case: a file system may not tell `Logo.svg` from `logo.svg`. */
+function takenNames(registry, prefix) {
+    const pack = registry?.list().find((p) => p.prefix === prefix);
+    return new Set((pack?.names() ?? []).map((n) => n.toLowerCase()));
+}
+/**
+ * Each file of the Add icon dialog as the dialog shows it: the name it gets (the one asked for, or
+ * one made of the file's name and free in the pack), a preview through the sanitiser, and what
+ * keeps it from being added: an SVG the sanitiser refuses, a name a reference cannot write, a name
+ * the pack or an earlier file has.
+ */
+export function checkIconFiles(registry, prefix, files) {
+    const words = messages().addIcons;
+    const taken = takenNames(registry, prefix);
+    const used = new Set();
+    return files.map((file) => {
+        let name = file.name?.trim() ?? "";
+        let problem;
+        if (file.name === undefined) {
+            // A name is offered: the file's own, made writable, then `-2`, `-3`… while it is taken.
+            const slug = slugifyIconName(file.file);
+            name = slug;
+            for (let n = 2; slug !== "" && (taken.has(name.toLowerCase()) || used.has(name.toLowerCase())); n++) {
+                name = `${slug}-${n}`;
+            }
+        }
+        if (name === "")
+            problem = words.nameEmpty;
+        else if (!isIconName(name))
+            problem = words.nameInvalid(name);
+        else if (taken.has(name.toLowerCase()))
+            problem = words.nameTaken(`${prefix}:${name}`);
+        else if (used.has(name.toLowerCase()))
+            problem = words.nameTwice(name);
+        if (name !== "")
+            used.add(name.toLowerCase());
+        let svg = null;
+        if (!/<svg[\s>]/i.test(file.svg)) {
+            problem = words.notSvg;
+        }
+        else {
+            const result = sanitizeSvg(file.svg);
+            if (result.ok)
+                svg = geometrySvg(result.icon, 48, 48);
+            else
+                problem = words.unsafe(result.problem.message);
+        }
+        return { file: file.file, name, svg, ...(problem !== undefined ? { problem } : {}) };
+    });
+}
+/**
+ * The files and statements that add icons to the project: one `assets/icons/<prefix>/<name>.svg`
+ * per file that can be added, the pack's licence in `assets/licenses.json` when it has none, an
+ * item per icon in the project's library (`assets/libraries/project.json`, a category per
+ * prefix), and `style <id> { icon }` of the first icon on the targets that take one. A prefix the
+ * icons cannot go into, or a licence missing or malformed, refuses every file.
+ */
+export function addIcons(registry, diagram, request) {
+    const words = messages().addIcons;
+    const none = { create: [], json: [] };
+    const refuseAll = (reason) => ({
+        added: [],
+        refused: request.files.map((f) => ({ file: f.file, reason })),
+        assets: none,
+        steps: [],
+    });
+    const prefix = checkIconPrefix(registry, request.prefix);
+    if (prefix.problem !== undefined)
+        return refuseAll(prefix.problem);
+    const licence = request.licence?.trim() ?? "";
+    if (!prefix.licensed) {
+        if (licence === "")
+            return refuseAll(words.licenceMissing);
+        if (!LICENCE.test(licence))
+            return refuseAll(words.licenceInvalid(licence));
+    }
+    const checks = checkIconFiles(registry, request.prefix, request.files.map((f) => ({ ...f, name: f.name ?? slugifyIconName(f.file) })));
+    const added = [];
+    const refused = [];
+    const create = [];
+    checks.forEach((check, i) => {
+        if (check.problem !== undefined) {
+            refused.push({ file: check.file, reason: check.problem });
+            return;
+        }
+        const reference = `${request.prefix}:${check.name}`;
+        create.push({ path: iconFilePath(request.prefix, check.name), text: request.files[i].svg });
+        const icon = sanitizeSvg(request.files[i].svg);
+        added.push({
+            file: check.file,
+            reference,
+            label: humanise(check.name),
+            svg: icon.ok ? geometrySvg(icon.icon, 24, 24) : null,
+        });
+    });
+    if (added.length === 0)
+        return { added, refused, assets: none, steps: [] };
+    const json = [];
+    if (!prefix.licensed) {
+        json.push({
+            path: LICENSES_FILE,
+            change: { kind: "licence", prefix: request.prefix, licence },
+        });
+    }
+    json.push({
+        path: PROJECT_LIBRARY_FILE,
+        change: {
+            kind: "libraryItems",
+            category: libraryCategoryId(request.prefix),
+            title: request.prefix,
+            items: added.map((icon) => ({ icon: icon.reference, label: icon.label })),
+        },
+    });
+    const steps = [];
+    if (diagram) {
+        for (const target of request.targets) {
+            const element = diagram.elementsById.get(target);
+            if (!element || !takesIcon(diagram, element))
+                continue;
+            const operation = {
+                kind: "setStyleProperty",
+                diagram: diagram.id,
+                target,
+                targetKind: "element",
+                property: "icon",
+                value: added[0].reference,
+            };
+            steps.push({ file: null, operation });
+        }
+    }
+    return { added, refused, assets: { create, json }, steps };
+}
+//# sourceMappingURL=add-icons.js.map

package/dist/add-icons.js.map

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

package/dist/analysis.d.ts

@@ -0,0 +1,70 @@
+import { type Library } from "@meltemi/diagrams-assets";
+import type { IconRegistry } from "@meltemi/diagrams-assets";
+import { type Diagnostic } from "@meltemi/diagrams-language";
+import { type LayoutOptions, type LayoutResult } from "@meltemi/diagrams-layout";
+import { type Compilation, type FlowDiagram, type LayoutMode, type ThemeDefinition } from "@meltemi/diagrams-model";
+import type { FontProvider } from "@meltemi/diagrams-render";
+/** One flow or free diagram of an analysed document. */
+export interface DiagramView {
+    readonly id: string;
+    readonly title: string | null;
+    readonly mode: LayoutMode;
+    readonly diagram: FlowDiagram;
+    /** The layout with the document's options; null when the diagram has compile errors. */
+    readonly layout: LayoutResult | null;
+}
+/** Everything the services and the canvas need about one version of a document. */
+export interface DocumentAnalysis {
+    readonly text: string;
+    readonly revision: number;
+    readonly compilation: Compilation;
+    /** Compile, module, project and layout diagnostics, deduplicated and sorted. */
+    readonly diagnostics: readonly Diagnostic[];
+    readonly diagrams: readonly DiagramView[];
+    readonly layoutOptions: LayoutOptions;
+    /** Themes in scope for the document: its own and the imported ones. */
+    readonly themes: readonly ThemeDefinition[];
+    readonly icons: IconRegistry | undefined;
+    /** The element libraries the document can create from: built-in, project and plugin ones. */
+    readonly libraries: readonly Library[];
+    /** Embeds fonts in rendered SVG; the same library that measures text. */
+    readonly fonts: FontProvider | undefined;
+    readonly formatOptions: {
+        readonly indent: number | "tab";
+    };
+    /** Image files of the project, relative to the document, for completion. */
+    readonly imageFiles: (() => readonly string[]) | undefined;
+    /** Lays out a diagram of another file of the project, for stories that show it. */
+    readonly importedView: ImportedViews | undefined;
+}
+/** A diagram of another file and its layout with that file's themes and assets. */
+export type ImportedViews = (file: string, diagram: string) => {
+    readonly diagram: FlowDiagram;
+    readonly layout: LayoutResult;
+} | undefined;
+export interface AnalysisInput {
+    readonly text: string;
+    readonly revision?: number;
+    /** The compilation of `text`, for example inside a project; compiled alone by default. */
+    readonly compilation?: Compilation;
+    /** Diagnostics of the compilation and its project; the compilation's own by default. */
+    readonly diagnostics?: readonly Diagnostic[];
+    /** Layout options; the ELK engine is used when no engine is given. */
+    readonly layout?: LayoutOptions;
+    readonly icons?: IconRegistry;
+    /** The libraries, or how to build them: built when first asked for, not on every analysis. */
+    readonly libraries?: readonly Library[] | (() => readonly Library[]);
+    readonly fonts?: FontProvider;
+    readonly formatOptions?: {
+        readonly indent: number | "tab";
+    };
+    /** Lists the project's image files relative to the document. */
+    readonly imageFiles?: () => readonly string[];
+    /** Lays out diagrams of other files of the project, for stories. */
+    readonly importedView?: ImportedViews;
+}
+/** Compiles (unless given a compilation), lays out every diagram and merges diagnostics. */
+export declare function analyzeDocument(input: AnalysisInput): DocumentAnalysis;
+/** The view of a diagram by id. */
+export declare function diagramView(analysis: DocumentAnalysis, id: string): DiagramView | undefined;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

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

package/dist/analysis.js

@@ -0,0 +1,59 @@
+import {} from "@meltemi/diagrams-assets";
+import { sortDiagnostics } from "@meltemi/diagrams-language";
+import { layoutDiagram } from "@meltemi/diagrams-layout";
+import { createElkEngine } from "@meltemi/diagrams-layout-elk";
+import { compile, } from "@meltemi/diagrams-model";
+let defaultEngine;
+const key = (d) => `${d.code}@${d.range.start.offset}:${d.range.end.offset}`;
+/** Compiles (unless given a compilation), lays out every diagram and merges diagnostics. */
+export function analyzeDocument(input) {
+    const compilation = input.compilation ?? compile(input.text);
+    const layoutOptions = {
+        ...input.layout,
+        engine: input.layout?.engine ?? (defaultEngine ??= createElkEngine()),
+    };
+    const diagnostics = [...(input.diagnostics ?? compilation.diagnostics)];
+    const seen = new Set(diagnostics.map(key));
+    const diagrams = compilation.document.diagrams.map((diagram) => {
+        const layout = diagram.hasErrors ? null : layoutDiagram(compilation, diagram, layoutOptions);
+        for (const d of layout?.diagnostics ?? []) {
+            if (seen.has(key(d)))
+                continue;
+            seen.add(key(d));
+            diagnostics.push(d);
+        }
+        return {
+            id: diagram.id,
+            title: diagram.properties.title,
+            mode: diagram.properties.layout,
+            diagram,
+            layout,
+        };
+    });
+    const given = input.libraries ?? [];
+    let libraries = typeof given === "function" ? undefined : given;
+    return {
+        text: input.text,
+        revision: input.revision ?? 0,
+        compilation,
+        diagnostics: sortDiagnostics(diagnostics),
+        diagrams,
+        layoutOptions,
+        themes: layoutOptions.themes ?? compilation.document.themes,
+        icons: input.icons,
+        // Libraries read packs' categories (Tabler's are a 2 MB file): only the panel needs them.
+        get libraries() {
+            libraries ??= given();
+            return libraries;
+        },
+        fonts: input.fonts,
+        formatOptions: input.formatOptions ?? { indent: 2 },
+        imageFiles: input.imageFiles,
+        importedView: input.importedView,
+    };
+}
+/** The view of a diagram by id. */
+export function diagramView(analysis, id) {
+    return analysis.diagrams.find((d) => d.id === id);
+}
+//# sourceMappingURL=analysis.js.map

package/dist/analysis.js.map

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

package/dist/arrange.d.ts

@@ -0,0 +1,71 @@
+import type { EditOperation } from "@meltemi/diagrams-edit";
+import { type Point } from "@meltemi/diagrams-model";
+import { type DiagramView, type DocumentAnalysis } from "./analysis.js";
+/**
+ * The interior origin of a group of a free diagram, which its children's places are measured
+ * from: the layout's origin of its children, or for an empty group its padding and its own header
+ * (the padding alone when it is untitled). (0, 0) for the top level and for flow diagrams, whose
+ * places are in diagram coordinates.
+ */
+export declare function interiorOf(view: DiagramView, group: string | null): Point;
+/**
+ * The `convertToContainer` operation for a flow node or a free box, with the elements drawn
+ * stacked on it as its children: siblings declared after it on its layer whose box lies inside
+ * its own (the composition checks' stack rule). Free children are placed in the interior the
+ * group will have; the group keeps the size it is drawn with. Undefined when it is not drawn.
+ */
+export declare function containerOperation(view: DiagramView, id: string): {
+    readonly operation: EditOperation & {
+        kind: "convertToContainer";
+    };
+    readonly children: readonly string[];
+} | undefined;
+/**
+ * The first moved element that lands stacked on a node or box of its layer, which is no
+ * container: the hint that converting the box would carry the element with it.
+ */
+export declare function stackedAfterMove(view: DiagramView, ids: readonly string[], delta: Point): {
+    readonly inner: string;
+    readonly outer: string;
+} | undefined;
+/**
+ * The operations that keep the groups an element leaves or enters drawn where they are, for a
+ * move of `leaving` into `target` (null: the top level), in one edit with it:
+ *
+ * - a group left with no children that lacks `place` or `size` gets the place and the size it is
+ *   drawn with, as an empty group needs both;
+ * - in a free diagram, a placed group without `size` that is left or entered gets the size it is
+ *   drawn with, so that its interior, where its children are placed, does not move: the element
+ *   lands where it was dropped and the other children stay.
+ */
+export declare function steadyGroups(view: DiagramView, leaving: readonly string[], target: string | null): EditOperation[];
+/**
+ * The `arrange` operation that writes what ELK draws: the unplaced elements around the placed
+ * ones (`unplaced`, laid out as `assisted`), or every element anew (`all`, laid out as `auto`),
+ * with the bends of the drawn connectors. Undefined when the diagram cannot be arranged.
+ */
+export declare function arrangeOperation(analysis: DocumentAnalysis, diagramId: string, scope: "unplaced" | "all"): EditOperation | undefined;
+/**
+ * The `arrange` operation of `arrangeOperation`, or the first problem that keeps the diagram from
+ * being arranged: an error of the text or of the layout, as written in its diagnostic.
+ */
+export declare function arrangeAttempt(analysis: DocumentAnalysis, diagramId: string, scope: "unplaced" | "all"): {
+    readonly operation?: EditOperation;
+    readonly problem?: string;
+};
+/**
+ * The `arrange` operation that writes the positions drawn now, so that an `auto` diagram
+ * becomes `assisted` without any box moving: the first step of a canvas gesture in `auto`.
+ */
+export declare function materializeOperation(view: DiagramView): EditOperation | undefined;
+/** A top-level id not used in the file: `base`, then `base_2`, `base_3`… */
+export declare function freeDiagramId(analysis: DocumentAnalysis, base: string): string;
+/**
+ * The `convertToFree` operation that copies a flow diagram, as drawn now, into a new free diagram
+ * named `id` (`<diagram>_free` by default), or undefined when the diagram is not drawn.
+ */
+export declare function convertOperation(analysis: DocumentAnalysis, diagramId: string, id?: string): (EditOperation & {
+    kind: "convertToFree";
+    id: string;
+}) | undefined;
+//# sourceMappingURL=arrange.d.ts.map

package/dist/arrange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../src/arrange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAU5D,OAAO,EAA8C,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAczE;AAKD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GAER;IACE,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG;QAAE,IAAI,EAAE,oBAAoB,CAAA;KAAE,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GACD,SAAS,CA2CZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,KAAK,EAAE,KAAK,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAuBhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,aAAa,EAAE,CA4CjB;AAgCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAAG,KAAK,GACxB,aAAa,GAAG,SAAS,CAE3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAAG,KAAK,GACxB;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAkCnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAUjF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,EAAE,CAAC,EAAE,MAAM,GACV,CAAC,aAAa,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAgBrE"}