@meltemi/diagrams-cli 1.9.0 → 1.11.1

package/dist/messages/index.d.ts

@@ -6,6 +6,7 @@
 export declare const messages: (locale?: import("@meltemi/diagrams-i18n").Locale) => {
     help: {
         main: (name: string, alias: string) => string;
+        skill: string;
         init: (templates: string) => string;
         import: string;
         review: string;
@@ -109,7 +110,6 @@ export declare const messages: (locale?: import("@meltemi/diagrams-i18n").Locale
         size: (max: number, size: string) => string;
         backgroundHtml: string;
         background: (background: string) => string;
-        mp4Transparent: string;
         linkFormats: string;
         link: (link: string) => string;
         oneFile: (option: string) => string;
@@ -148,14 +148,47 @@ export declare const messages: (locale?: import("@meltemi/diagrams-i18n").Locale
         };
         folderSummary: (check: boolean, files: number, folder: string, parts: readonly string[]) => string;
     };
+    skill: {
+        wrote: (path: string) => string;
+        subcommand: (given: string) => string;
+        tooMany: string;
+        userWithFolder: string;
+        unknownAgent: (agent: string, agents: readonly string[]) => string;
+        promptArguments: string;
+        exists: (path: string) => string;
+    };
     init: {
         templates: {
-            flow: string;
-            c4: string;
-            sequence: string;
-            free: string;
-            purchase: string;
+            flow: {
+                title: string;
+                description: string;
+            };
+            c4: {
+                title: string;
+                description: string;
+            };
+            sequence: {
+                title: string;
+                description: string;
+            };
+            free: {
+                title: string;
+                description: string;
+            };
+            kanban: {
+                title: string;
+                description: string;
+            };
+            whiteboard: {
+                title: string;
+                description: string;
+            };
+            purchase: {
+                title: string;
+                description: string;
+            };
         };
+        contents: (counts: readonly (readonly ["models" | "views" | "diagrams" | "stories", number])[]) => string;
         exists: (path: string) => string;
         gitlab: string;
         oneFolder: string;
@@ -179,6 +212,8 @@ export declare const messages: (locale?: import("@meltemi/diagrams-i18n").Locale
         packs: string;
         aliases: string;
         fonts: string;
+        bundledFonts: string;
+        fontGroups: Readonly<Record<string, string>>;
         noWords: string;
         limit: string;
         noMatch: (query: string) => string;

package/dist/messages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkB,CAAC;AAExC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBrD;AAED,4FAA4F;AAC5F,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkB,CAAC;AAExC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBrD;AAED,4FAA4F;AAC5F,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7C"}

package/dist/skill-command.d.ts

@@ -0,0 +1,48 @@
+/** What the skill command needs from the CLI. */
+export interface SkillContext {
+    readonly name: string;
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    /** A path as printed: relative to the working folder. */
+    readonly display: (path: string) => string;
+    /** The person's home folder, where `--user` installs; the system's by default. */
+    readonly home?: string;
+}
+/**
+ * The agents the skill installs for, with the folder under the project (or the home folder) each
+ * reads skills from, as the vendors' pages name them (decision 0063): Claude Code reads
+ * `.claude/skills`; Codex, Cursor, GitHub Copilot, Gemini CLI and Devin Desktop (once Windsurf)
+ * read the cross-agent `.agents/skills`, which `agents` names for any other agent that reads it.
+ */
+export declare const SKILL_AGENTS: {
+    readonly claude: ".claude/skills";
+    readonly codex: ".agents/skills";
+    readonly cursor: ".agents/skills";
+    readonly copilot: ".agents/skills";
+    readonly gemini: ".agents/skills";
+    readonly windsurf: ".agents/skills";
+    readonly devin: ".agents/skills";
+    readonly agents: ".agents/skills";
+};
+export type SkillAgent = keyof typeof SKILL_AGENTS;
+/** The skill the package ships. */
+export declare const SKILL_NAME = "meltemi-diagrams";
+/**
+ * The skill's text as an installed project reads it: the repository's `pnpm mdg <command>` becomes
+ * the installed command's `mdg <command>`, the repository's preview server the command's own, and
+ * the repository root the project's folder.
+ */
+export declare function installedText(text: string): string;
+/**
+ * The skill folders the named agents read, each once, in the table's order; `all` names every
+ * folder. The first name that is empty or unknown otherwise.
+ */
+export declare function skillFolders(names: readonly string[]): {
+    folders: string[];
+} | {
+    unknown: string;
+};
+/** `meltemi-diagrams skill install` and `meltemi-diagrams skill prompt`. */
+export declare function skillCommand(args: readonly string[], context: SkillContext): number;
+//# sourceMappingURL=skill-command.d.ts.map

package/dist/skill-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-command.d.ts","sourceRoot":"","sources":["../src/skill-command.ts"],"names":[],"mappings":"AAeA,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC;AAKnD,mCAAmC;AACnC,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAW7C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAsBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAQ7C;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CA2DnF"}

package/dist/skill-command.js

@@ -0,0 +1,148 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+import { argumentsError, messages } from "./messages/index.js";
+/**
+ * The agents the skill installs for, with the folder under the project (or the home folder) each
+ * reads skills from, as the vendors' pages name them (decision 0063): Claude Code reads
+ * `.claude/skills`; Codex, Cursor, GitHub Copilot, Gemini CLI and Devin Desktop (once Windsurf)
+ * read the cross-agent `.agents/skills`, which `agents` names for any other agent that reads it.
+ */
+export const SKILL_AGENTS = {
+    claude: ".claude/skills",
+    codex: ".agents/skills",
+    cursor: ".agents/skills",
+    copilot: ".agents/skills",
+    gemini: ".agents/skills",
+    windsurf: ".agents/skills",
+    devin: ".agents/skills",
+    agents: ".agents/skills",
+};
+/** The agents' names and `all`, as the help and the refusal list them. */
+const AGENT_NAMES = [...Object.keys(SKILL_AGENTS), "all"];
+/** The skill the package ships. */
+export const SKILL_NAME = "meltemi-diagrams";
+/** The folder of the shipped skills: `skills/` beside `src/` and `dist/`. */
+const SKILL_ROOT = fileURLToPath(new URL("../skills/", import.meta.url));
+/** The agent setup prompt the package ships, which `skill prompt` prints and the site serves. */
+const PROMPT = fileURLToPath(new URL("../agent-setup/prompt.md", import.meta.url));
+const EXIT_OK = 0;
+const EXIT_USAGE = 2;
+/**
+ * The skill's text as an installed project reads it: the repository's `pnpm mdg <command>` becomes
+ * the installed command's `mdg <command>`, the repository's preview server the command's own, and
+ * the repository root the project's folder.
+ */
+export function installedText(text) {
+    return text
+        .replaceAll("`pnpm preview` serves the repository at `http://localhost:4173`", "`mdg preview` serves the folder at `http://localhost:4173`")
+        .replaceAll("`pnpm preview`", "`mdg preview`")
+        .replaceAll("(from the repository root)", "(from the project's folder)")
+        .replaceAll("pnpm mdg ", "mdg ");
+}
+/**
+ * Copies the shipped skill to `destination`, rewriting its text for an installed project: the
+ * Markdown and the commands the examples' comments name.
+ */
+function writeSkill(destination) {
+    const source = join(SKILL_ROOT, SKILL_NAME);
+    mkdirSync(destination, { recursive: true });
+    cpSync(source, destination, { recursive: true });
+    const rewrite = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                rewrite(path);
+            else if (entry.name.endsWith(".md") || entry.name.endsWith(".meltemi")) {
+                writeFileSync(path, installedText(readFileSync(path, "utf8")));
+            }
+        }
+    };
+    rewrite(destination);
+}
+/**
+ * The skill folders the named agents read, each once, in the table's order; `all` names every
+ * folder. The first name that is empty or unknown otherwise.
+ */
+export function skillFolders(names) {
+    const wanted = new Set();
+    for (const name of names) {
+        if (name === "all")
+            Object.values(SKILL_AGENTS).forEach((folder) => wanted.add(folder));
+        else if (Object.hasOwn(SKILL_AGENTS, name))
+            wanted.add(SKILL_AGENTS[name]);
+        else
+            return { unknown: name };
+    }
+    return { folders: [...new Set(Object.values(SKILL_AGENTS))].filter((f) => wanted.has(f)) };
+}
+/** `meltemi-diagrams skill install` and `meltemi-diagrams skill prompt`. */
+export function skillCommand(args, context) {
+    const fail = (message) => {
+        context.stderr(`${context.name} skill: ${message}\n`);
+        return EXIT_USAGE;
+    };
+    let options;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                agent: { type: "string", multiple: true },
+                user: { type: "boolean", default: false },
+                force: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        options = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (error) {
+        return fail(argumentsError(error));
+    }
+    const t = messages().skill;
+    if (options.help) {
+        context.stdout(messages().help.skill);
+        return EXIT_OK;
+    }
+    const [subcommand, folder, ...extra] = positionals;
+    if (subcommand === "prompt") {
+        const given = options.agent !== undefined || options.user || options.force;
+        if (folder !== undefined || given)
+            return fail(t.promptArguments);
+        // Byte for byte: the text is written for the installed command and is never rewritten.
+        context.stdout(readFileSync(PROMPT, "utf8"));
+        return EXIT_OK;
+    }
+    if (subcommand !== "install")
+        return fail(t.subcommand(subcommand ?? ""));
+    if (extra.length > 0)
+        return fail(t.tooMany);
+    if (options.user && folder !== undefined)
+        return fail(t.userWithFolder);
+    const names = (options.agent ?? ["all"]).flatMap((value) => value.split(",").map((name) => name.trim()));
+    const chosen = skillFolders(names);
+    if ("unknown" in chosen)
+        return fail(t.unknownAgent(chosen.unknown, AGENT_NAMES));
+    const base = options.user ? (context.home ?? homedir()) : resolve(context.cwd, folder ?? ".");
+    const destinations = chosen.folders.map((agentFolder) => join(base, agentFolder, SKILL_NAME));
+    // Nothing is written when any destination holds a copy, unless asked to replace it.
+    if (!options.force) {
+        const existing = destinations.find((path) => existsSync(path));
+        if (existing)
+            return fail(t.exists(context.display(existing)));
+    }
+    for (const destination of destinations) {
+        // Only the skill's own folder is replaced; the folders beside it stay.
+        if (options.force)
+            rmSync(destination, { recursive: true, force: true });
+        writeSkill(destination);
+        context.stdout(`${t.wrote(context.display(destination))}\n`);
+    }
+    return EXIT_OK;
+}
+//# sourceMappingURL=skill-command.js.map

package/dist/skill-command.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltemi/diagrams-cli",
-  "version": "1.9.0",
+  "version": "1.11.1",
   "description": "Command line interface (meltemi-diagrams, alias mdg) for .meltemi projects.",
   "license": "MIT",
   "repository": {
@@ -27,31 +27,38 @@
     }
   },
   "files": [
+    "agent-setup",
     "dist",
+    "skills",
     "templates"
   ],
   "dependencies": {
-    "@meltemi/diagrams-assets": "1.9.0",
-    "@meltemi/diagrams-assist": "1.9.0",
-    "@meltemi/diagrams-capture": "1.9.0",
-    "@meltemi/diagrams-catalog": "1.9.0",
-    "@meltemi/diagrams-edit": "1.9.0",
-    "@meltemi/diagrams-fonts": "1.9.0",
-    "@meltemi/diagrams-i18n": "1.9.0",
-    "@meltemi/diagrams-editor": "1.9.0",
-    "@meltemi/diagrams-import": "1.9.0",
-    "@meltemi/diagrams-layout": "1.9.0",
-    "@meltemi/diagrams-layout-elk": "1.9.0",
-    "@meltemi/diagrams-model": "1.9.0",
-    "@meltemi/diagrams-language": "1.9.0",
-    "@meltemi/diagrams-motion": "1.9.0",
-    "@meltemi/diagrams-project": "1.9.0",
-    "@meltemi/diagrams-render": "1.9.0",
-    "@meltemi/diagrams-player": "1.9.0"
+    "@meltemi/diagrams-assets": "1.11.1",
+    "@meltemi/diagrams-assist": "1.11.1",
+    "@meltemi/diagrams-capture": "1.11.1",
+    "@meltemi/diagrams-edit": "1.11.1",
+    "@meltemi/diagrams-editor": "1.11.1",
+    "@meltemi/diagrams-catalog": "1.11.1",
+    "@meltemi/diagrams-fonts": "1.11.1",
+    "@meltemi/diagrams-i18n": "1.11.1",
+    "@meltemi/diagrams-language": "1.11.1",
+    "@meltemi/diagrams-layout": "1.11.1",
+    "@meltemi/diagrams-import": "1.11.1",
+    "@meltemi/diagrams-model": "1.11.1",
+    "@meltemi/diagrams-layout-elk": "1.11.1",
+    "@meltemi/diagrams-motion": "1.11.1",
+    "@meltemi/diagrams-player": "1.11.1",
+    "@meltemi/diagrams-render": "1.11.1",
+    "@meltemi/diagrams-project": "1.11.1"
   },
   "publishConfig": {
     "access": "public"
   },
+  "meltemiRelease": {
+    "repository": "askenaz-dev/meltemi-diagrams",
+    "sha": "bdcca7b5a0690c564978e045e6d6d43f84d379ab",
+    "tag": "v1.11.1"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json"

package/skills/.skills-sync.json

@@ -0,0 +1,5 @@
+{
+  "skills": [
+    "meltemi-diagrams"
+  ]
+}

package/skills/meltemi-diagrams/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: meltemi-diagrams
+description: Use when asked to draw, document or convert a system or software architecture, sketch a whiteboard or kanban board, turn a diagram or a screenshot into code, or change a `.meltemi` file. Creates, edits, converts and exports Meltemi diagrams as code (`.meltemi` files) - flow sheets with groups, plain containers, data stores, decisions, notes, tags and boxes in 24 shapes with icons, laid out by ELK, assisted or by hand, with ports, constraints, styles and themes; free compositions (slides with boxes, text, icons, images, layers and links to flow views, and whiteboards with pen strokes, stickies and kanban lists); sequence diagrams (participants, calls, replies, activations, notes, alt/opt/loop/par fragments, scenarios); C4 models with context, container and component views; motion effects and stories that walk through a diagram scene by scene; SVG, PNG, PDF and HTML-player exports with export profiles. Imports Mermaid and PlantUML instead of retyping them, and turns draw.io, HTML or SVG pictures into sheets.
+license: MIT
+metadata:
+  version: 1.11.1
+---
+
+# Meltemi Diagrams
+
+Diagrams as code for the Meltemi family. A sheet is a `.meltemi` text file; the `meltemi-diagrams` command
+compiles it, validates it and exports SVG. The text is the source of truth: when a `.meltemi` file
+can produce the image, never draw the image by hand and never edit the exported SVG.
+
+## Workflow
+
+Before you start: `pnpm mdg --version` says which version of the command line is there; where
+`mdg` is not on the path, `npx @meltemi/diagrams-cli@latest <command>` runs the same command. New
+sheets go under `diagrams/`, or where the project keeps them (the `sources` of its
+`project.json`). Cloud commands run only when the person asks
+([reference/cloud.md](reference/cloud.md)), and a token (`mdg_…`) is never printed, read, copied
+or committed.
+
+1. Collect the pieces from the request or the source material: elements (boxes, data stores,
+   decisions), bands (groups), arrows with their labels, annotations (notes, tags), what is
+   proposed versus in use, and the numbered steps of the main path. Choose the profile: `flow` for
+   an architecture or process that ELK can arrange, `free` for a slide or a hand-composed picture
+   with headings, icons and images, or a whiteboard with pen strokes, stickies and kanban columns
+   under `preset board` ([reference/free.md](reference/free.md)), `sequence` for an
+   interaction over time between participants ([reference/sequence.md](reference/sequence.md)),
+   a `model` with `c4` views for a C4 architecture (context, containers, components) shared by
+   several pictures ([reference/c4.md](reference/c4.md)).
+   To walk an audience through a diagram, add a `story` after it
+   ([reference/stories.md](reference/stories.md)).
+   A Mermaid or PlantUML source is imported, never retyped: `pnpm mdg import source.mmd` writes
+   `source.meltemi` and reports what it approximated or dropped
+   ([reference/converting.md](reference/converting.md)).
+   A flow sheet becomes a slide with `pnpm mdg convert sheet.meltemi --to free`. Sequence
+   diagrams have no layout modes or positions: skip step 2's layout choice and write the events in
+   order.
+2. Write the file from the template below. Pick the layout mode:
+   - `layout auto` (the default) for a new sheet: write no positions; ELK arranges the boxes in the
+     `direction` (`LR`, `TB`, ...). Add constraints such as `row a, b` when you need alignment.
+   - `layout assisted` to pin some boxes with `place` and let ELK arrange the rest around them.
+   - `layout manual` when converting a picture or matching an original exactly: give every element
+     a `place`, and a `size` to any box whose width matters.
+
+   `pnpm mdg layout path/to/sheet.meltemi` writes ELK's positions into the file as `place`
+   statements (and turns `auto` into `assisted`) when you want to fine-tune them by hand. Keep the
+   labels in the language of the source.
+   For icons, find names with `pnpm mdg assets icons <words>` (for example `database`) and set
+   them with `style <id> { icon "tabler:database" }`; never invent an icon name. The icon goes
+   beside the text by default; `iconPosition right|top|bottom|center` moves it (`center` makes it
+   the picture of the box) and `iconSize 32` (8 to 128, or `auto`) sizes it. Architecture icons
+   with their label below, as provider diagrams draw them, are `shape icon`:
+   `style fn { icon "aws:lambda"; shape icon }` ([reference/free.md](reference/free.md)).
+
+3. Validate: `pnpm mdg validate path/to/sheet.meltemi` (from the repository root). Fix every
+   diagnostic, each code explained in [reference/language.md](reference/language.md), until the
+   last line reads `Checked 1 file: 0 errors, 0 warnings.`, which is what success prints.
+4. Export: `pnpm mdg export path/to/sheet.meltemi` writes `sheet.svg` beside the source.
+   `--stdout` prints it, `--theme editorial.light` gives a neutral sheet without the brand frame
+   and `--theme stage.light` a presentation sheet. `--format png` (with `--scale`, `--size 1920x1080`,
+   `--background transparent`) and `--format pdf` use the installed Edge or Chrome; an `export`
+   block in the file makes a delivery repeatable with `--profile <id>` or `--profiles`
+   ([reference/language.md](reference/language.md)).
+5. Review the SVG. When the person wants to look at it in a browser, start a server:
+   `pnpm preview` serves the repository at `http://localhost:4173` until stopped with Ctrl+C, and
+   tell them how to stop it. Check: no overlapping boxes, text fits its box, arrows leave and
+   enter the intended sides, labels are readable, a legend exists when colours carry meaning. The
+   export prints composition warnings (`layout.overlap`, `layout.label-under-connector`,
+   `layout.container-margin`, `layout.connector-overlap`); fix every one.
+6. Iterate with small edits. Keep ids stable and keep the author's comments. Finish with
+   `pnpm mdg format path/to/sheet.meltemi` so the file has the canonical layout.
+
+People who prefer a visual tool open the same file in VS Code with the Meltemi Diagrams extension
+(`docs/editor.md`). It shows a canvas beside the code, and each drag, resize or inspector change is
+a small edit of the text. A sheet you write stays editable there, and their changes come back as
+ordinary text edits that you can review.
+
+## Template
+
+```text
+language "0.2"
+
+diagram checkout: flow {
+  title "Checkout"
+  description "One sentence that becomes the <desc> of the SVG."
+  layout manual
+
+  group backend "Backend" {
+    api["Order API"] { description "REST · validates input" }
+    data orders "Orders DB" { description "PostgreSQL" }
+  }
+  client["Client app"] { description "web & mobile" }
+  tag jwt "JWT"
+  note limits "Limits to confirm\n500 rps per tenant"
+
+  client -> api: "1" as request
+  api -> orders: "2" as persist
+
+  placement {
+    place client at (120, 60); size client (160, 56)
+    place api at (420, 60); size api (200, 56)
+    place orders at (420, 200)
+    place jwt at (500, 32)
+    place limits at (700, 60)
+    label request at 50% offset (0, -16)
+    label persist at 50% offset (16, 0)
+  }
+
+  style request, persist { fill "#0B1830"; color "#FFFFFF" }
+}
+```
+
+## Rules that save iterations
+
+- Ids match `[A-Za-z_][A-Za-z0-9_]*` and are unique per diagram across elements and relations.
+  Labels carry the human text (`\n` breaks a label into lines); `description` is the smaller text
+  under the label, inside the box.
+- Name every relation you need to route, position a label on, or style: `a -> b: "text" as id`.
+- `place` is the centre of the box in pixels; y grows downwards. Groups fit their children unless
+  you give them both `place` and `size`.
+- Default sizes: `node` 160 x 56, `decision` 160 x 80, `data` 160 x 64, widened automatically to
+  fit their text; a `shape` has its own default size ([reference/free.md](reference/free.md));
+  tags and notes size themselves from their text. Use `size` only to make boxes larger or equal;
+  if `layout.text-overflow` appears, use the width its hint gives.
+- Shapes go on flow nodes and free boxes: `style api { shape hexagon }`, one of `rounded`,
+  `rectangle`, `square`, `ellipse`, `circle`, `diamond`, `cylinder`, `pill`, `triangle`,
+  `parallelogram`, `trapezoid`, `pentagon`, `hexagon`, `octagon`, `star`, `cloud`, `document`,
+  `callout`, `arrow`, `framed`, `flag`, `person`, `agent` (an AI agent: a robot head over a body
+  that holds the text), `icon` (the element drawn as its `icon` alone, 64 x 64, with the label
+  outside at `labelPosition`, `bottom` by default). Decisions, data stores, notes, tags and groups
+  draw their own shape and refuse it, and so do free texts, icons and images. Text stays inside
+  the shape and arrows end on its outline (on the icon's square for `shape icon`). `radius <n>`
+  (0 to 64) sets the corner radius of a node, box, decision, note or group, and rounds every
+  shape with corners: `rectangle` and `square` (square by default), the polygons' vertices (sharp
+  by default: `style h { shape hexagon; radius 10 }`); `radius 0` squares a rounded box,
+  `rule group { radius 0 }` squares every group. Circles, ellipses, pills, cylinders, clouds and
+  documents ignore it.
+- `rotation <degrees>` (0 to 360, clockwise) turns an element of a flow or free diagram about the
+  centre of its box, text and icon included (`style label { rotation 270 }` for text up a side);
+  `place` and `size` stay those of the unturned box, and arrows meet the turned outline. Groups,
+  sequence diagrams and C4 views refuse it.
+- Nested plain rectangles (a visual editor's containers) are untitled groups: `group g "" { ... }`
+  with `style g { fill "#dae8fc"; stroke "#6c8ebf"; radius 0 }`. They draw no title and reserve no
+  title band: their interior starts 16 px below the top edge instead of 40 px. A box meant to hold
+  others is such a group, never a `node` or `box` with boxes stacked on it: a stack is only drawn
+  on top, so the engine separates it and moving the outer box leaves the inner ones behind. A
+  group's `size` is the least the engine gives it in `layout auto`, its children centred.
+- Boxes stacked on purpose, each strictly inside the one before, are declared outer first; give
+  the outer boxes empty labels (`box outer ""`) or labels away from the inner ones
+  (`textAlign left`, a separate `text`). A stack declared inner first, or two boxes of the same
+  size at the same place, is `layout.overlap`.
+- A band behind boxes is an untitled group with `place`, `size` and `layer back` (with
+  `layers back, main`); boxes and groups on different layers are not checked against each other,
+  and the engine arranges boxes over the band, in `layout assisted` and, at the top level, in
+  `layout auto`.
+- Arrows need no `route`: facing sides meet at the centre of their overlap, so boxes aligned in a
+  column get straight vertical arrows. Add `route id from a.east to b.north via [(x, y)]` only for
+  a bend.
+- `place` is ignored in `layout auto` (`layout.placement-ignored`): write `layout manual` or
+  `layout assisted` whenever a sheet has positions.
+- A box with named ports (`bus["Bus"] { port in west 30% }`) is entered at that exact point with
+  `route r from a.east to bus.in`. `routing orthogonal|polyline|bezier` changes the connector
+  shape for the diagram or, in a `style`, for one relation.
+- Text takes a font, size and weight in every profile: `style api { font "Roboto"; fontSize 16;
+fontWeight 600 }`, also in classes and rules (`rule note { font "Caveat" }`); icons, images and
+  pens refuse them. Name a bundled family, never a system one: Inter, IBM Plex Sans, Roboto, Open
+  Sans, Lato, Montserrat, Poppins, Nunito, Merriweather, Lora, Playfair Display, Cascadia Mono,
+  Roboto Mono, Source Code Pro, Patrick Hand, Caveat, Comic Neue (`pnpm mdg assets list` prints
+  them). A family nobody has is `layout.unmeasured-font` and measured with estimates.
+- Dashed means proposed: one statement, `style a, b, c { line dashed }`.
+- Numbered steps are relation labels `"1"`, `"2"` with `label r1 at 50% offset (16, 0)` and a
+  dark style; the narrative goes in comments next to the relations.
+- A legend is a row of `tag` elements under the sheet with the category colours, plus a dashed
+  white tag for "proposed".
+- One diagram per file unless they share a model; the SVG is named after the file.
+- In `free` diagrams, a child's `place` is relative to its group's interior, every group has a
+  `place`, and the paint order is the source order within each layer: declare on-top objects last
+  or give them `layer front` (with `layers main, front`). A group with `layout column` or
+  `layout row` places its children itself, in source order: give them no `place`
+  (`layout.place-ignored`). Strokes are `pen` statements with their points, never lines with many
+  bends.
+
+## When the result looks wrong
+
+| Symptom                                          | Fix                                                                              |
+| ------------------------------------------------ | -------------------------------------------------------------------------------- |
+| `layout.missing-placement`                       | add `place <id> at (x, y)`; groups need `place` and `size` together or neither   |
+| `layout.placement-ignored`                       | the sheet has positions but no `layout`: add `layout manual` or `assisted`       |
+| `layout.constraint-conflict`                     | two placed boxes cannot satisfy the constraint; move one or drop the constraint  |
+| `layout.overlap` after `auto` or `assisted`      | add `distance a, b 40` or pin one box with `place`                               |
+| `layout.overlap` on boxes stacked on purpose     | declaration order: declare the outer box before the boxes inside it              |
+| `layout.label-overlap` on a stack                | the stacked labels coincide; leave the outer labels empty or move them           |
+| `prop.invalid-value` on `shape`                  | only `node` and `box` take `shape`; a decision is already a diamond              |
+| `layout.icon-missing`, a dashed square           | `shape icon` needs an `icon` style on the element (or a rule or class)           |
+| `layout.label-position-ignored`                  | `labelPosition` needs `iconPosition center` or `shape icon`; remove it otherwise |
+| a band pushes boxes or warns                     | make it an untitled group with `place`, `size` and `layer back`                  |
+| `ref.unknown-relation` on `route`/`label`        | the relation is anonymous: add `as <id>` to it                                   |
+| `prop.duplicate` in a style                      | the property is already set for that target in an earlier `style`                |
+| arrow crosses a box                              | add a waypoint with `route ... via [(x, y)]` or move the box                     |
+| text wider than its box                          | add `size <id> (w, h)` or shorten the description                                |
+| diagonal arrow where a straight one was expected | the two boxes do not overlap on that axis; align them or use a waypoint          |
+
+## Reference
+
+- [reference/language.md](reference/language.md): grammar, vocabulary, diagnostics and fixes.
+- [reference/layout.md](reference/layout.md): layout modes, constraints, ports, coordinates, sizes,
+  anchors, routes, groups, frame.
+- [reference/themes.md](reference/themes.md): built-in themes, theme blocks, the brand frame.
+- [reference/converting.md](reference/converting.md): importing Mermaid and PlantUML, turning any
+  other diagram or a screenshot into a sheet, with the checks that prove the conversion.
+- [reference/free.md](reference/free.md): free compositions, the twenty-four shapes, icons in
+  boxes and as shapes, interior coordinates, plain containers, stacks and bands, layers, links,
+  images, the conversion from flow, and whiteboards: pen strokes, stickies and lists (kanban
+  boards).
+- [reference/sequence.md](reference/sequence.md): sequence diagrams, fragments, scenarios,
+  spacing, their diagnostics and the mapping from Mermaid and PlantUML.
+- [reference/c4.md](reference/c4.md): models, C4 views, levels and scopes, lifted and combined
+  relations, local labels, imported models and their diagnostics.
+- [reference/stories.md](reference/stories.md): stories, scenes, actions, transitions, timing,
+  their diagnostics and frame exports.
+- [reference/cloud.md](reference/cloud.md): sharing a project in the optional cloud service, only
+  when the person asks, and where its token lives.
+- [examples/platform.meltemi](examples/platform.meltemi): a complete sheet using every construct.
+- [examples/slide.meltemi](examples/slide.meltemi): a flow view and a free slide linked to it.
+- [examples/sequence.meltemi](examples/sequence.meltemi): a payment sequence with a group, an
+  alternative, a loop, a note, an async message and two scenarios.
+- [examples/architecture.meltemi](examples/architecture.meltemi): a model with a context, a
+  container and a component view.
+- [examples/story.meltemi](examples/story.meltemi): a checkout flow and the story of a purchase.