@meltemi/diagrams-edit 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,57 @@
-# Temporary Holding Version
+# @meltemi/diagrams-edit
 
-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.
+Structured edits of `.meltemi` sources: an operation (move, resize, route, relabel, rename,
+reorder, add, remove and many more) becomes the smallest text change that does it, keeping
+comments and formatting, or a refusal with its reason.
+
+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-edit
+```
+
+Node 22.12.0 or later. The package is an ES module with type declarations.
+
+## Use
+
+```ts
+import { planEdit } from "@meltemi/diagrams-edit";
+import { applyTextEdits } from "@meltemi/diagrams-language";
+import { compile } from "@meltemi/diagrams-model";
+
+const text = `language "0.2"
+
+diagram shop: flow {
+  web["Web shop"]
+  api["Orders API"]
+  db[("Orders")]
+  web -> api: "HTTPS" as call
+  api -> db: "SQL" as store
+}
+`;
+
+const result = planEdit(compile(text), {
+  kind: "setRelationLabel",
+  diagram: "shop",
+  relation: "call",
+  label: "HTTPS and JSON",
+});
+if (result.ok) console.log(applyTextEdits(text, result.plan.edits));
+else console.log(result.rejection.reason);
+```
+
+Elements created without a label take `defaultLabel(kind)` in the interface language of
+`@meltemi/diagrams-i18n` ("Node", or "Nodo" in Spanish), as if the person had typed it;
+`DEFAULT_LABELS` keeps the English ones.
+
+## 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/animate.d.ts

@@ -0,0 +1,18 @@
+import { type TextEdit } from "@meltemi/diagrams-language";
+import { type AnimationEffect } from "@meltemi/diagrams-model";
+import { type EditContext } from "./context.js";
+import { type OperationOf } from "./plan.js";
+export declare const ANIMATION_PROPERTIES: readonly ["duration", "repeat", "delay", "direction", "particles", "color"];
+export type AnimationProperty = (typeof ANIMATION_PROPERTIES)[number];
+/** Whether a property can be written for an effect. */
+export declare function animationPropertyApplies(effect: AnimationEffect, property: string): boolean;
+/** Writes an animation value as the language reads it; times are milliseconds. */
+export declare function formatAnimationValue(property: string, value: string | number): string;
+/**
+ * Makes sure a target has an `animate` statement with an effect, and sets or (with `null`) removes
+ * one of its properties. A statement shared by several targets is split.
+ */
+export declare function setAnimation(ctx: EditContext, op: OperationOf<"setAnimation">): TextEdit[];
+/** Removes a target's effect: the target leaves its statement, or the statement goes. */
+export declare function removeAnimation(ctx: EditContext, op: OperationOf<"removeAnimation">): TextEdit[];
+//# sourceMappingURL=animate.d.ts.map

package/dist/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA2C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIzF,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAgB9D,eAAO,MAAM,oBAAoB,6EAOvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,uDAAuD;AACvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3F;AA+BD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA4CrF;AAaD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,QAAQ,EAAE,CAmE1F;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,GAAG,QAAQ,EAAE,CAehG"}

package/dist/animate.js

@@ -0,0 +1,188 @@
+import { isIdentifierText } from "@meltemi/diagrams-language";
+import { ANIMATION_DIRECTIONS, ANIMATION_EFFECT_PROPERTIES, ANIMATION_LIMITS, } from "@meltemi/diagrams-model";
+import { insertStatement, reject, requireElement } from "./context.js";
+import { deleteStatements } from "./delete.js";
+import { diagramBody, insertAfter, isKeyword, verifyNoNewErrors } from "./insert.js";
+import { reasons } from "./messages/index.js";
+import { removeListItems } from "./plan.js";
+import { requireRelation } from "./relations.js";
+import { formatNumber, quoteString } from "./text.js";
+/** Element kinds drawn without an outline, which a moving dash cannot follow. */
+const NO_OUTLINE = new Set([
+    "note",
+    "text",
+    "icon",
+    "image",
+    "actor",
+    "boundary",
+    "control",
+    "entity",
+]);
+export const ANIMATION_PROPERTIES = [
+    "duration",
+    "repeat",
+    "delay",
+    "direction",
+    "particles",
+    "color",
+];
+/** Whether a property can be written for an effect. */
+export function animationPropertyApplies(effect, property) {
+    return (["duration", "repeat", "delay"].includes(property) ||
+        ANIMATION_EFFECT_PROPERTIES[effect].includes(property));
+}
+function requireTarget(ctx, target, kind, effect) {
+    if (kind === "element") {
+        const element = requireElement(ctx, target);
+        if (effect === "flow")
+            reject("edit.invalid-value", reasons().animations.flowOnBoxes);
+        if (effect === "trace")
+            reject("edit.invalid-value", reasons().animations.traceOnBoxes);
+        if (effect === "dash" && NO_OUTLINE.has(element.kind)) {
+            reject("edit.invalid-value", reasons().animations.noOutline(target));
+        }
+        return;
+    }
+    if (kind === "relation") {
+        const relation = requireRelation(ctx, target);
+        if (relation.id === null) {
+            reject("edit.anonymous-relation", reasons().animations.nameRelation);
+        }
+        return;
+    }
+    const event = ctx.diagram.eventsByKey.get(target);
+    if (!event || event.id !== target || event.kind === "message") {
+        reject("edit.unsafe-target", reasons().animations.unnamedEvent(target));
+    }
+    if (effect !== "pulse")
+        reject("edit.invalid-value", reasons().animations.pulseOnly);
+}
+/** Writes an animation value as the language reads it; times are milliseconds. */
+export function formatAnimationValue(property, value) {
+    switch (property) {
+        case "duration":
+        case "delay": {
+            const ms = typeof value === "number" ? value : Number(value);
+            const min = property === "duration" ? ANIMATION_LIMITS.minDuration : 0;
+            const max = property === "duration" ? ANIMATION_LIMITS.maxDuration : ANIMATION_LIMITS.maxDelay;
+            if (!Number.isFinite(ms) || ms < min || ms > max) {
+                reject("edit.invalid-value", reasons().animations.timeRange(property, min, max));
+            }
+            return `${formatNumber(ms)}ms`;
+        }
+        case "repeat": {
+            if (value === "forever")
+                return "forever";
+            const n = typeof value === "number" ? value : Number(value);
+            if (!Number.isInteger(n) || n < 1 || n > ANIMATION_LIMITS.maxRepeat) {
+                reject("edit.invalid-value", reasons().animations.repeatRange(ANIMATION_LIMITS.maxRepeat));
+            }
+            return String(n);
+        }
+        case "particles": {
+            const n = typeof value === "number" ? value : Number(value);
+            if (!Number.isInteger(n) || n < 1 || n > ANIMATION_LIMITS.maxParticles) {
+                reject("edit.invalid-value", reasons().animations.particlesRange(ANIMATION_LIMITS.maxParticles));
+            }
+            return String(n);
+        }
+        case "direction":
+            if (!ANIMATION_DIRECTIONS.includes(String(value))) {
+                reject("edit.invalid-value", reasons().animations.direction);
+            }
+            return String(value);
+        case "color": {
+            const text = String(value);
+            const token = text.startsWith("@") ? text.slice(1) : text;
+            return isIdentifierText(token) ? token : quoteString(text);
+        }
+        default:
+            return reject("edit.invalid-value", reasons().animations.notProperty(property));
+    }
+}
+function entryFor(ctx, target, kind, effect) {
+    return ctx.diagram.animations.find((e) => e.target === target && e.targetKind === kind && e.effect === effect);
+}
+/**
+ * Makes sure a target has an `animate` statement with an effect, and sets or (with `null`) removes
+ * one of its properties. A statement shared by several targets is split.
+ */
+export function setAnimation(ctx, op) {
+    requireTarget(ctx, op.target, op.targetKind, op.effect);
+    const property = op.property;
+    if (property !== undefined && !animationPropertyApplies(op.effect, property)) {
+        reject("edit.invalid-value", reasons().animations.notForEffect(property, op.effect));
+    }
+    const value = property === undefined || op.value === undefined || op.value === null
+        ? null
+        : formatAnimationValue(property, op.value);
+    const entry = entryFor(ctx, op.target, op.targetKind, op.effect);
+    const edits = [];
+    if (!entry) {
+        if (property !== undefined && value === null)
+            return [];
+        const inner = [
+            `effect ${op.effect}`,
+            ...(property !== undefined && value !== null ? [`${property} ${value}`] : []),
+        ];
+        const text = `animate ${op.target} { ${inner.join("; ")} }`;
+        const body = diagramBody(ctx);
+        const anchors = body.statements.filter((s) => isKeyword(s, "animate") || isKeyword(s, "style"));
+        const last = anchors[anchors.length - 1];
+        edits.push(last
+            ? insertAfter(ctx, body, last, () => text)
+            : insertStatement(ctx, body, ctx.diagram.node.start, () => text));
+        verifyNoNewErrors(ctx, edits);
+        return edits;
+    }
+    if (property === undefined)
+        return [];
+    const statement = entry.node;
+    const block = statement.block;
+    const written = block.statements.find((s) => isKeyword(s, property));
+    if (statement.args.length > 1) {
+        // The target leaves the shared statement and gets its own copy with the change.
+        const index = statement.args.findIndex((a) => a.start === entry.targetRange.start.offset);
+        edits.push(...removeListItems(statement.args, new Set([index])));
+        const kept = block.statements
+            .filter((s) => !isKeyword(s, property))
+            .map((s) => ctx.text.slice(s.start, s.end));
+        if (value !== null)
+            kept.push(`${property} ${value}`);
+        edits.push(insertAfter(ctx, diagramBody(ctx), statement, () => `animate ${op.target} { ${kept.join("; ")} }`));
+    }
+    else if (written) {
+        if (value === null) {
+            edits.push(...deleteStatements(ctx.text, ctx.compilation.parse.root, [written]));
+        }
+        else {
+            const first = written.args[0];
+            const last = written.args[written.args.length - 1];
+            if (!first || !last)
+                reject("edit.unsafe-target", reasons().targets.propertyUnreadable);
+            if (ctx.text.slice(first.start, last.end) === value)
+                return [];
+            edits.push({ start: first.start, end: last.end, newText: value });
+        }
+    }
+    else {
+        if (value === null)
+            return [];
+        edits.push(insertStatement(ctx, block, statement.start, () => `${property} ${value}`));
+    }
+    verifyNoNewErrors(ctx, edits);
+    return edits;
+}
+/** Removes a target's effect: the target leaves its statement, or the statement goes. */
+export function removeAnimation(ctx, op) {
+    const entry = ctx.diagram.animations.find((e) => e.target === op.target && e.effect === op.effect);
+    if (!entry)
+        return [];
+    const statement = entry.node;
+    const edits = statement.args.length > 1
+        ? removeListItems(statement.args, new Set([statement.args.findIndex((a) => a.start === entry.targetRange.start.offset)]))
+        : deleteStatements(ctx.text, ctx.compilation.parse.root, [statement]);
+    verifyNoNewErrors(ctx, edits);
+    return edits;
+}
+//# sourceMappingURL=animate.js.map

package/dist/animate.js.map

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

package/dist/attachments.d.ts

@@ -0,0 +1,30 @@
+import type { Arg, TextEdit } from "@meltemi/diagrams-language";
+import type { Element } from "@meltemi/diagrams-model";
+import { type EditContext, type TextContext } from "./context.js";
+import type { OperationOf } from "./plan.js";
+import type { Dependent } from "./types.js";
+/** The words after the text of a note's declaration: `on` and the target that follows it. */
+export interface AttachmentArgs {
+    /** The argument before `on`: the note's text (or its id when it has none). */
+    readonly before: Arg;
+    readonly word: Arg;
+    readonly target: Arg;
+}
+/** The `on <target>` clause of a note's statement, or undefined when it has none. */
+export declare function attachmentArgs(note: Element): AttachmentArgs | undefined;
+/** The edit that takes ` on <target>` out of a note's statement, keeping its block and comments. */
+export declare function stripAttachment(note: Element): TextEdit | undefined;
+/**
+ * A note attached to something about to go, as a dependent of the removal and the edit that
+ * leaves the note without its clause: a note's text is the person's words, so it stays.
+ */
+export declare function attachmentDependent(ctx: TextContext, note: Element): {
+    dependent: Dependent;
+    edit: TextEdit;
+} | undefined;
+/**
+ * Writes, replaces or removes the `on <element>` clause of a note, in the same declaration and
+ * with the smallest edit: the clause follows the note's text and the block stays where it is.
+ */
+export declare function attachNote(ctx: EditContext, op: OperationOf<"attachNote">): TextEdit[];
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAoB,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;CACtB;AAID,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAOxE;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAGnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,GACZ;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,SAAS,CAatD;AAUD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,QAAQ,EAAE,CA+BtF"}

package/dist/attachments.js

@@ -0,0 +1,85 @@
+import { reject, requireElement } from "./context.js";
+import { verifyNoNewErrors } from "./insert.js";
+import { messages, reasons } from "./messages/index.js";
+const isOn = (arg) => arg?.kind === "QualifiedRef" && arg.text === "on";
+/** The `on <target>` clause of a note's statement, or undefined when it has none. */
+export function attachmentArgs(note) {
+    const node = note.node;
+    if (note.kind !== "note" || node?.kind !== "KeywordStatement")
+        return undefined;
+    const args = node.args;
+    const at = args.findIndex((arg, i) => i >= 2 && isOn(arg));
+    const target = args[at + 1];
+    return at < 0 || !target ? undefined : { before: args[at - 1], word: args[at], target };
+}
+/** The edit that takes ` on <target>` out of a note's statement, keeping its block and comments. */
+export function stripAttachment(note) {
+    const clause = attachmentArgs(note);
+    return clause && { start: clause.before.end, end: clause.target.end, newText: "" };
+}
+/**
+ * A note attached to something about to go, as a dependent of the removal and the edit that
+ * leaves the note without its clause: a note's text is the person's words, so it stays.
+ */
+export function attachmentDependent(ctx, note) {
+    const edit = stripAttachment(note);
+    if (!edit || !note.node)
+        return undefined;
+    const lines = ctx.compilation.parse.lines;
+    return {
+        edit,
+        dependent: {
+            kind: "attachment",
+            name: note.id,
+            description: messages().dependents.attachment(note.id, lines.location(note.node.start).line),
+            range: lines.range(note.node),
+        },
+    };
+}
+/** Whether `path` is an element a note of the diagram may be attached to. */
+function attachable(ctx, note, path) {
+    if (path === note.id)
+        return false;
+    const element = ctx.diagram.elementsById.get(path);
+    // A view draws entities, and notes attach to what it draws.
+    return ctx.diagram.type === "c4" ? element?.entity != null : element !== undefined;
+}
+/**
+ * Writes, replaces or removes the `on <element>` clause of a note, in the same declaration and
+ * with the smallest edit: the clause follows the note's text and the block stays where it is.
+ */
+export function attachNote(ctx, op) {
+    const note = requireElement(ctx, op.note);
+    const r = reasons().attach;
+    if (note.kind !== "note" || note.node?.kind !== "KeywordStatement") {
+        reject("edit.invalid-value", r.onlyNotes(note.id, note.kind));
+    }
+    const clause = attachmentArgs(note);
+    const node = note.node;
+    if (op.element === null) {
+        const edit = stripAttachment(note);
+        return edit ? [edit] : [];
+    }
+    if (op.element === note.id)
+        reject("edit.invalid-value", r.self(note.id));
+    if (!attachable(ctx, note, op.element)) {
+        if (ctx.diagram.type === "c4") {
+            reject("edit.unsafe-target", r.notDrawn(op.element, ctx.diagram.id));
+        }
+        requireElement(ctx, op.element);
+    }
+    if (clause?.target.kind === "QualifiedRef" && clause.target.text === op.element)
+        return [];
+    const edits = clause
+        ? [{ start: clause.target.start, end: clause.target.end, newText: op.element }]
+        : [
+            {
+                start: (node.args[1] ?? node.args[0]).end,
+                end: (node.args[1] ?? node.args[0]).end,
+                newText: ` on ${op.element}`,
+            },
+        ];
+    verifyNoNewErrors(ctx, edits);
+    return edits;
+}
+//# sourceMappingURL=attachments.js.map

package/dist/attachments.js.map

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

package/dist/batch.d.ts

@@ -0,0 +1,18 @@
+import { type TextEdit } from "@meltemi/diagrams-language";
+import { type Compilation } from "@meltemi/diagrams-model";
+import type { EditOperation, PlanOptions, PlanResult } from "./types.js";
+/**
+ * One set of edits against `base` doing what `first` does and then `second`, given against the
+ * text `first` leaves.
+ */
+export declare function composeEdits(base: string, first: readonly TextEdit[], second: readonly TextEdit[]): TextEdit[];
+/**
+ * Plans several operations as one edit against the compiled text: each one is planned on the
+ * text left by the previous ones, and the results are composed back onto the base text. A
+ * refusal of any operation refuses the batch and names the operation.
+ */
+export declare function planBatch(compilation: Compilation, operations: readonly EditOperation[], options: PlanOptions & {
+    /** Plans one operation; `planEdit`, passed in to keep the modules acyclic. */
+    readonly plan: (compilation: Compilation, operation: EditOperation) => PlanResult;
+}): PlanResult;
+//# sourceMappingURL=batch.d.ts.map

package/dist/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAY,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkFnF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,QAAQ,EAAE,GAC1B,QAAQ,EAAE,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,OAAO,EAAE,WAAW,GAAG;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,KAAK,UAAU,CAAC;CACnF,GACA,UAAU,CA0BZ"}

package/dist/batch.js

@@ -0,0 +1,120 @@
+import { applyTextEdits, invertTextEdits, normalizeTextEdits, } from "@meltemi/diagrams-language";
+import { compile } from "@meltemi/diagrams-model";
+const pieceLength = (piece) => piece.kind === "base" ? piece.end - piece.start : piece.text.length;
+/** Cuts `pieces` at `offset` of the text they spell, so that a piece boundary falls there. */
+function splitAt(pieces, offset) {
+    let position = 0;
+    for (let i = 0; i < pieces.length; i++) {
+        const piece = pieces[i];
+        const length = pieceLength(piece);
+        if (offset === position)
+            return i;
+        if (offset < position + length) {
+            const cut = offset - position;
+            const [left, right] = piece.kind === "base"
+                ? [
+                    { kind: "base", start: piece.start, end: piece.start + cut },
+                    { kind: "base", start: piece.start + cut, end: piece.end },
+                ]
+                : [
+                    { kind: "new", text: piece.text.slice(0, cut) },
+                    { kind: "new", text: piece.text.slice(cut) },
+                ];
+            pieces.splice(i, 1, left, right);
+            return i + 1;
+        }
+        position += length;
+    }
+    return pieces.length;
+}
+/** Applies edits, given against the text the pieces spell, to the pieces. */
+function applyToPieces(pieces, text, edits) {
+    // From the end, so earlier offsets stay valid.
+    const sorted = normalizeTextEdits(text, edits);
+    for (let k = sorted.length - 1; k >= 0; k--) {
+        const edit = sorted[k];
+        // Split at the start first: splitting at the end never moves the start's index.
+        const start = splitAt(pieces, edit.start);
+        const end = splitAt(pieces, edit.end);
+        const inserted = edit.newText === "" ? [] : [{ kind: "new", text: edit.newText }];
+        pieces.splice(start, end - start, ...inserted);
+    }
+}
+/**
+ * The edits against the base text that produce the text the pieces spell. Base text that
+ * survives in place is untouched; everything between two surviving runs becomes one edit.
+ */
+function editsFromPieces(pieces, baseLength) {
+    const edits = [];
+    let cursor = 0;
+    let pending = "";
+    let pendingStart = null;
+    const flush = (end) => {
+        if (pendingStart !== null || end > cursor) {
+            const start = pendingStart ?? cursor;
+            edits.push({ start, end, newText: pending });
+        }
+        pending = "";
+        pendingStart = null;
+    };
+    for (const piece of pieces) {
+        if (piece.kind === "new") {
+            pendingStart ??= cursor;
+            pending += piece.text;
+            continue;
+        }
+        if (piece.start === piece.end)
+            continue;
+        if (piece.start !== cursor || pendingStart !== null)
+            flush(piece.start);
+        cursor = piece.end;
+    }
+    if (pendingStart !== null || cursor < baseLength)
+        flush(baseLength);
+    return edits;
+}
+/**
+ * One set of edits against `base` doing what `first` does and then `second`, given against the
+ * text `first` leaves.
+ */
+export function composeEdits(base, first, second) {
+    const pieces = base.length > 0 ? [{ kind: "base", start: 0, end: base.length }] : [];
+    applyToPieces(pieces, base, first);
+    applyToPieces(pieces, applyTextEdits(base, first), second);
+    return editsFromPieces(pieces, base.length);
+}
+/**
+ * Plans several operations as one edit against the compiled text: each one is planned on the
+ * text left by the previous ones, and the results are composed back onto the base text. A
+ * refusal of any operation refuses the batch and names the operation.
+ */
+export function planBatch(compilation, operations, options) {
+    const base = compilation.text;
+    const pieces = base.length > 0 ? [{ kind: "base", start: 0, end: base.length }] : [];
+    const notes = [];
+    let current = compilation;
+    let text = base;
+    for (let i = 0; i < operations.length; i++) {
+        const result = options.plan(current, operations[i]);
+        if (!result.ok) {
+            return { ok: false, rejection: { ...result.rejection, operationIndex: i } };
+        }
+        notes.push(...result.plan.notes);
+        if (result.plan.edits.length === 0)
+            continue;
+        applyToPieces(pieces, text, result.plan.edits);
+        text = applyTextEdits(text, result.plan.edits);
+        if (i < operations.length - 1)
+            current = compile(text, compilation.options);
+    }
+    const edits = editsFromPieces(pieces, base.length);
+    const plan = {
+        operation: operations.length === 1 ? operations[0] : { kind: "batch", operations },
+        baseRevision: options.revision ?? 0,
+        edits,
+        inverse: invertTextEdits(base, edits),
+        notes,
+    };
+    return { ok: true, plan };
+}
+//# sourceMappingURL=batch.js.map

package/dist/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,GAEnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAoB,MAAM,yBAAyB,CAAC;AAQpE,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,EAAE,CACnC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;AAEtE,8FAA8F;AAC9F,SAAS,OAAO,CAAC,MAAe,EAAE,MAAc;IAC9C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QAClC,IAAI,MAAM,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,MAAM,GAAG,QAAQ,CAAC;YAC9B,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GACjB,KAAK,CAAC,IAAI,KAAK,MAAM;gBACnB,CAAC,CAAC;oBACE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,EAAE;oBAC5D,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;iBAC3D;gBACH,CAAC,CAAC;oBACE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;oBAC/C,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;iBAC7C,CAAC;YACR,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QACD,QAAQ,IAAI,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CAAC,MAAe,EAAE,IAAY,EAAE,KAA0B;IAC9E,+CAA+C;IAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACxB,gFAAgF;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAY,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAwB,EAAE,UAAkB;IACnE,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE;QAC5B,IAAI,YAAY,KAAK,IAAI,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,YAAY,IAAI,MAAM,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACzB,YAAY,KAAK,MAAM,CAAC;YACxB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG;YAAE,SAAS;QACxC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,YAAY,KAAK,IAAI;YAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;IACrB,CAAC;IACD,IAAI,YAAY,KAAK,IAAI,IAAI,MAAM,GAAG,UAAU;QAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,KAA0B,EAC1B,MAA2B;IAE3B,MAAM,MAAM,GAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,WAAwB,EACxB,UAAoC,EACpC,OAGC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,WAAW,CAAC;IAC1B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC7C,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,GAAa;QACrB,SAAS,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE;QACnF,YAAY,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QACnC,KAAK;QACL,OAAO,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;QACrC,KAAK;KACN,CAAC;IACF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}