@meltemi/diagrams-editor 1.9.0 → 1.10.17

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/arrange.d.ts

@@ -1,5 +1,5 @@
 import type { EditOperation } from "@meltemi/diagrams-edit";
-import { type Point } from "@meltemi/diagrams-model";
+import { type Element, type FlowDiagram, 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
@@ -8,6 +8,20 @@ import { type DiagramView, type DocumentAnalysis } from "./analysis.js";
  * places are in diagram coordinates.
  */
 export declare function interiorOf(view: DiagramView, group: string | null): Point;
+/** Whether an element keeps its points in its statement: a free line or a pen stroke. */
+export declare function keepsPoints(element: Element): boolean;
+/**
+ * The list group (`layout column` or `layout row`) that places an element of a free diagram: its
+ * group when that group is a list, which puts its children one after another and takes no
+ * `place` for them. Undefined for any other element, and for lines and pens, which keep their
+ * points in a list as in any group.
+ */
+export declare function placingList(diagram: FlowDiagram, element: Element): string | undefined;
+/**
+ * Whether alignment and distribution move an element: not a group, a line or a pen, which have no
+ * edges to line up, nor a child of a list, which its list places.
+ */
+export declare function alignable(diagram: FlowDiagram, element: Element): boolean;
 /**
  * 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
@@ -39,6 +53,45 @@ export declare function stackedAfterMove(view: DiagramView, ids: readonly string
  *   lands where it was dropped and the other children stay.
  */
 export declare function steadyGroups(view: DiagramView, leaving: readonly string[], target: string | null): EditOperation[];
+/**
+ * The group a stroke through `points` (diagram coordinates) of `width` belongs to, from `start`
+ * (the innermost group under its first point, or the group it is in) outwards: the first that is
+ * not a list and whose drawn box holds the whole stroke, so that a stroke never grows a list nor
+ * moves the children it places; the top level (null) when none does. `start` as it is when it is
+ * no group of a drawn free diagram, which the edit judges.
+ */
+export declare function strokeParent(view: DiagramView, start: string | null, points: readonly Point[], width: number): string | null;
+/**
+ * The `setSize` that keeps a plain group of a free diagram drawn as it is while a stroke goes into
+ * it or moves in it: a group without `size` derives its size from what it holds and grows about
+ * its centre, which moves its interior and every child placed in it. The size is written as drawn,
+ * unrounded, so that the interior stays where it is to the hundredth. Nothing for the top level,
+ * a list (which grows with its children) or a group with a size.
+ */
+export declare function steadySize(view: DiagramView, group: string | null): EditOperation[];
+/**
+ * The operations that draw the pen `element` through `points`, in diagram coordinates, as a drag
+ * or a scale of its stroke leaves it: its points in its group's interior. A pen in a list, which
+ * would grow the list and move the children it places, goes out first to the nearest group around
+ * the list that is not a list and holds the stroke (`strokeParent`), or to the top level, so that
+ * it lands where it is dropped. `parent` is the group it ends in, which the caller keeps steady
+ * (`steadySize`).
+ */
+export declare function penOperations(view: DiagramView, element: Element, points: readonly Point[]): {
+    readonly operations: EditOperation[];
+    readonly parent: string | null;
+};
+/**
+ * The operations that keep what the list group `list` holds drawn where it is once the list no
+ * longer places it, in the interior of `into`: the list itself when its layout goes, its parent
+ * when it is ungrouped (null: the top level). Each child the list places gets its `place` at its
+ * drawn centre, and the size it is drawn with when the list stretches it; when the list stays a
+ * group, a written size, which was its least size, becomes the size it is drawn with. Lines and
+ * pens that leave the list get their drawn points in the new interior. Into another list, which
+ * places them in order, the children get no place; nor in an `auto` diagram, whose engine places
+ * them, and which a place would make `assisted`.
+ */
+export declare function unlistedOperations(view: DiagramView, list: string, into: 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`),

package/dist/arrange.d.ts.map

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

package/dist/arrange.js

@@ -1,4 +1,4 @@
-import { groupHeaderOf, layoutDiagram, stacked, StyleResolver, typeScale, } from "@meltemi/diagrams-layout";
+import { DEFAULT_PEN_WIDTH, groupHeaderOf, layoutDiagram, stacked, StyleResolver, typeScale, } from "@meltemi/diagrams-layout";
 import { MAIN_LAYER } from "@meltemi/diagrams-model";
 import { diagramView } from "./analysis.js";
 /**
@@ -28,6 +28,29 @@ export function interiorOf(view, group) {
 }
 const parentId = (e) => e.groupPath[e.groupPath.length - 1] ?? null;
 const layerOf = (e) => e.layer ?? MAIN_LAYER;
+/** Whether an element keeps its points in its statement: a free line or a pen stroke. */
+export function keepsPoints(element) {
+    return element.kind === "line" || element.kind === "pen";
+}
+/**
+ * The list group (`layout column` or `layout row`) that places an element of a free diagram: its
+ * group when that group is a list, which puts its children one after another and takes no
+ * `place` for them. Undefined for any other element, and for lines and pens, which keep their
+ * points in a list as in any group.
+ */
+export function placingList(diagram, element) {
+    if (diagram.type !== "free" || keepsPoints(element))
+        return undefined;
+    const parent = parentId(element);
+    return parent !== null && diagram.elementsById.get(parent)?.list ? parent : undefined;
+}
+/**
+ * Whether alignment and distribution move an element: not a group, a line or a pen, which have no
+ * edges to line up, nor a child of a list, which its list places.
+ */
+export function alignable(diagram, element) {
+    return (element.kind !== "group" && !keepsPoints(element) && placingList(diagram, element) === undefined);
+}
 /**
  * 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
@@ -46,7 +69,9 @@ export function containerOperation(view, id) {
     const after = diagram.elements.slice(diagram.elements.indexOf(element) + 1);
     const children = after.filter((e) => {
         const inner = boxes.get(e.id);
+        // Lines and pens keep their points where they are: they are drawings over the box.
         return (inner !== undefined &&
+            !keepsPoints(e) &&
             parentId(e) === parentId(element) &&
             layerOf(e) === layerOf(element) &&
             stacked(box, inner));
@@ -91,13 +116,16 @@ export function stackedAfterMove(view, ids, delta) {
     for (const id of ids) {
         const element = diagram.elementsById.get(id);
         const box = boxes.get(id);
-        if (!element || !box)
+        // A stroke or a line over a box is a drawing on it, which no container carries.
+        if (!element || !box || keepsPoints(element))
             continue;
         const landed = { ...box, x: box.x + delta.x, y: box.y + delta.y };
         // The smallest box that holds it, which is the one it is seen on.
         let outer;
         for (const other of diagram.elements) {
-            if (other.kind === "group" || moves(other) || layerOf(other) !== layerOf(element))
+            if (other.kind === "group" || keepsPoints(other) || moves(other))
+                continue;
+            if (layerOf(other) !== layerOf(element))
                 continue;
             const holder = boxes.get(other.id);
             if (!holder || !stacked(holder, landed))
@@ -140,7 +168,10 @@ export function steadyGroups(view, leaving, target) {
             continue;
         const emptied = sources.has(group) &&
             diagram.elements.every((e) => e.groupPath[e.groupPath.length - 1] !== group || leaving.includes(e.id));
-        if (!emptied && !(placed && diagram.type === "free"))
+        // A list grows and shrinks with its children, whose places it sets: it keeps no size of the
+        // moment unless it is left empty.
+        const list = Boolean(diagram.elementsById.get(group)?.list);
+        if (!emptied && (list || !(placed && diagram.type === "free")))
             continue;
         if (!placed) {
             // Relative to the interior of its own group in free diagrams.
@@ -163,10 +194,178 @@ export function steadyGroups(view, leaving, target) {
     }
     return ops;
 }
+/**
+ * Whether a box holds a stroke through `points` of `width`: the box of its points grown by half
+ * its width on every side, as the layout bounds a pen.
+ */
+function holdsStroke(box, points, width) {
+    const half = width / 2;
+    const slack = 1e-6;
+    return points.every((p) => p.x - half >= box.x - slack &&
+        p.x + half <= box.x + box.width + slack &&
+        p.y - half >= box.y - slack &&
+        p.y + half <= box.y + box.height + slack);
+}
+/**
+ * The group a stroke through `points` (diagram coordinates) of `width` belongs to, from `start`
+ * (the innermost group under its first point, or the group it is in) outwards: the first that is
+ * not a list and whose drawn box holds the whole stroke, so that a stroke never grows a list nor
+ * moves the children it places; the top level (null) when none does. `start` as it is when it is
+ * no group of a drawn free diagram, which the edit judges.
+ */
+export function strokeParent(view, start, points, width) {
+    const diagram = view.diagram;
+    const group = start === null ? undefined : diagram.elementsById.get(start);
+    const boxes = view.layout?.boxes;
+    if (start === null || group?.kind !== "group" || diagram.type !== "free" || !boxes)
+        return start;
+    for (const id of [start, ...[...group.groupPath].reverse()]) {
+        const candidate = diagram.elementsById.get(id);
+        const box = boxes.get(id);
+        if (candidate && candidate.list === null && box && holdsStroke(box, points, width))
+            return id;
+    }
+    return null;
+}
+/**
+ * The `setSize` that keeps a plain group of a free diagram drawn as it is while a stroke goes into
+ * it or moves in it: a group without `size` derives its size from what it holds and grows about
+ * its centre, which moves its interior and every child placed in it. The size is written as drawn,
+ * unrounded, so that the interior stays where it is to the hundredth. Nothing for the top level,
+ * a list (which grows with its children) or a group with a size.
+ */
+export function steadySize(view, group) {
+    const diagram = view.diagram;
+    if (group === null || diagram.type !== "free")
+        return [];
+    const element = diagram.elementsById.get(group);
+    const box = view.layout?.boxes?.get(group);
+    if (element?.kind !== "group" || element.list !== null || !box)
+        return [];
+    if (diagram.placement.some((p) => p.statement === "size" && p.target === group))
+        return [];
+    return [
+        { kind: "setSize", diagram: view.id, element: group, width: box.width, height: box.height },
+    ];
+}
+/**
+ * The operations that draw the pen `element` through `points`, in diagram coordinates, as a drag
+ * or a scale of its stroke leaves it: its points in its group's interior. A pen in a list, which
+ * would grow the list and move the children it places, goes out first to the nearest group around
+ * the list that is not a list and holds the stroke (`strokeParent`), or to the top level, so that
+ * it lands where it is dropped. `parent` is the group it ends in, which the caller keeps steady
+ * (`steadySize`).
+ */
+export function penOperations(view, element, points) {
+    const diagram = view.diagram;
+    const current = parentId(element);
+    const width = view.layout?.pens?.get(element.id)?.width ?? DEFAULT_PEN_WIDTH;
+    const parent = current !== null && diagram.elementsById.get(current)?.list
+        ? strokeParent(view, current, points, width)
+        : current;
+    const operations = [];
+    if (parent !== current) {
+        operations.push({ kind: "moveElement", diagram: view.id, element: element.id, parent });
+    }
+    const origin = interiorOf(view, parent);
+    operations.push({
+        kind: "setPenPoints",
+        diagram: view.id,
+        element: element.id,
+        points: points.map((p) => ({ x: p.x - origin.x, y: p.y - origin.y })),
+    });
+    return { operations, parent };
+}
+/**
+ * The operations that keep what the list group `list` holds drawn where it is once the list no
+ * longer places it, in the interior of `into`: the list itself when its layout goes, its parent
+ * when it is ungrouped (null: the top level). Each child the list places gets its `place` at its
+ * drawn centre, and the size it is drawn with when the list stretches it; when the list stays a
+ * group, a written size, which was its least size, becomes the size it is drawn with. Lines and
+ * pens that leave the list get their drawn points in the new interior. Into another list, which
+ * places them in order, the children get no place; nor in an `auto` diagram, whose engine places
+ * them, and which a place would make `assisted`.
+ */
+export function unlistedOperations(view, list, into) {
+    const diagram = view.diagram;
+    const layout = view.layout;
+    const geometry = layout?.lists?.get(list);
+    const boxes = layout?.boxes;
+    if (diagram.type !== "free" || !geometry || !boxes)
+        return [];
+    const d = view.id;
+    const sized = (id) => diagram.placement.some((p) => p.statement === "size" && p.target === id);
+    const size = (id, box) => ({
+        kind: "setSize",
+        diagram: d,
+        element: id,
+        width: Math.round(box.width),
+        height: Math.round(box.height),
+    });
+    const origin = into === list ? geometry.origin : interiorOf(view, into);
+    const ops = [];
+    const intoList = into !== null && into !== list && Boolean(diagram.elementsById.get(into)?.list);
+    if (!intoList) {
+        for (const id of geometry.children) {
+            const box = boxes.get(id);
+            if (!box)
+                continue;
+            if (view.mode !== "auto") {
+                ops.push({
+                    kind: "setPosition",
+                    diagram: d,
+                    element: id,
+                    x: Math.round(box.x + box.width / 2 - origin.x),
+                    y: Math.round(box.y + box.height / 2 - origin.y),
+                });
+            }
+            if (geometry.align === "stretch" && !sized(id))
+                ops.push(size(id, box));
+        }
+    }
+    if (into === list) {
+        const box = boxes.get(list);
+        if (box && sized(list))
+            ops.push(size(list, box));
+        return ops;
+    }
+    for (const element of diagram.elements) {
+        if (parentId(element) !== list)
+            continue;
+        if (element.kind === "pen") {
+            const stroke = layout.pens?.get(element.id);
+            if (!stroke)
+                continue;
+            ops.push({
+                kind: "setPenPoints",
+                diagram: d,
+                element: element.id,
+                points: stroke.points.map((p) => ({ x: p.x - origin.x, y: p.y - origin.y })),
+            });
+        }
+        else if (element.kind === "line" && element.line) {
+            const at = layout.origins?.get(element.id) ?? { x: 0, y: 0 };
+            const moved = (p) => ({
+                x: Math.round(p.x + at.x - origin.x),
+                y: Math.round(p.y + at.y - origin.y),
+            });
+            ops.push({
+                kind: "setLinePoints",
+                diagram: d,
+                element: element.id,
+                from: moved(element.line.from),
+                to: moved(element.line.to),
+                via: element.line.via.map(moved),
+            });
+        }
+    }
+    return ops;
+}
 /**
  * Centres of elements and sizes of groups from laid-out boxes. In free diagrams the centres of
  * group children are written relative to their group's interior (`origins`), and groups get a
- * place and a size.
+ * place and a size; lines and pens keep their points, the children of a list get no centre (the
+ * list places them) and a list no size (it grows with its children).
  */
 function fromBoxes(diagram, boxes, origins) {
     const positions = new Map();
@@ -174,15 +373,18 @@ function fromBoxes(diagram, boxes, origins) {
     const free = diagram.type === "free";
     for (const element of diagram.elements) {
         const box = boxes.get(element.id);
-        if (!box)
+        if (!box || (free && keepsPoints(element)))
+            continue;
+        if (placingList(diagram, element) !== undefined)
             continue;
         const origin = free ? origins?.get(element.id) : undefined;
         positions.set(element.id, {
             x: box.x + box.width / 2 - (origin?.x ?? 0),
             y: box.y + box.height / 2 - (origin?.y ?? 0),
         });
-        if (element.kind === "group")
+        if (element.kind === "group" && !element.list) {
             sizes.set(element.id, { width: box.width, height: box.height });
+        }
     }
     return free ? { positions, sizes, writeGroups: true } : { positions, sizes };
 }
@@ -278,7 +480,6 @@ export function convertOperation(analysis, diagramId, id) {
         metrics: {
             groupPadding: layout.theme.groupPadding,
             groupHeader: layout.theme.groupHeader,
-            noteSize: scale.note,
             tagSize: scale.tag,
         },
     };