@bpmn-ld/bpmn-ld 0.1.0 → 0.2.0

package/dist/bpmn-ld-cli.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/dist/bpmn-ld-cli.js

@@ -1,16 +1,18 @@
+#!/usr/bin/env node
 import { runAnalyze } from "./analyze-run.js";
 import { runCheckXml } from "./check-xml-run.js";
 import { runConvert } from "./convert-run.js";
 import { runExport } from "./export-run.js";
 import { runLayout } from "./layout-run.js";
 import { runRender } from "./render-run.js";
+import { runCheatSheet } from "./cheat-sheet-run.js";
 import { runInstallSkill } from "./install-skill-run.js";
 import { runValidate } from "./validate-run.js";
 import { ROOT } from "./paths.js";
 const USAGE = `Usage: bpmn-ld <command> [args]
 
 Commands:
-  validate, analyze, convert, export, layout, check-xml, render
+  validate, analyze, convert, export, layout, check-xml, render, cheat-sheet
   coverage, docs
   root, install-skill
 
@@ -64,6 +66,11 @@ const run = async (argv) => {
             write(r);
             return r.exitCode;
         }
+        case "cheat-sheet": {
+            const r = runCheatSheet(rest);
+            write(r);
+            return r.exitCode;
+        }
         case "root": {
             process.stdout.write(`${ROOT}\n`);
             return 0;

package/dist/cheat-sheet-catalog.d.ts

@@ -0,0 +1,10 @@
+export interface CheatSheetEntry {
+    category: string;
+    name: string;
+    draw: (x: number, y: number) => string;
+    explanation: string;
+}
+export declare const cheatSheetCatalog: CheatSheetEntry[];
+export declare const CATALOG: CheatSheetEntry[];
+export declare const catalog: CheatSheetEntry[];
+export type CatalogEntry = CheatSheetEntry;

package/dist/cheat-sheet-catalog.js

@@ -0,0 +1,72 @@
+import { eventCircle, taskRect, gatewayDiamond, doubleRect, thickRect, poolRect, laneRect, dataObject, dataStore } from "./render/symbols.js";
+export const cheatSheetCatalog = [];
+const add = (category, name, draw, explanation) => {
+    cheatSheetCatalog.push({ category, name, draw, explanation });
+};
+const timerIcon = (x, y) => {
+    const cx = x + 10;
+    const cy = y + 10;
+    const mr = 6;
+    return `<circle cx="${cx}" cy="${cy}" r="${mr}" fill="none" stroke="black" stroke-width="1.2"/><line x1="${cx}" y1="${cy}" x2="${cx}" y2="${cy - mr + 2}" stroke="black" stroke-width="1.2"/><line x1="${cx}" y1="${cy}" x2="${cx + mr - 2}" y2="${cy}" stroke="black" stroke-width="1.2"/>`;
+};
+const ev = (stroke = 1.5, dashed = false) => (x, y, inner = "") => {
+    const r = 10;
+    const cx = x + r;
+    const cy = y + r;
+    const parts = [`<circle cx="${cx}" cy="${cy}" r="${r}" fill="white" stroke="black" stroke-width="${stroke}"${dashed ? ' stroke-dasharray="4 3"' : ""}/>`, `<circle cx="${cx}" cy="${cy}" r="${r - 3}" fill="none" stroke="black" stroke-width="1.2"/>`];
+    if (inner)
+        parts.push(inner);
+    return parts.join("");
+};
+add("Events", "Start Event", (x, y) => ev(1.5, false)(x, y), "Begins a process; triggered once when the process starts.");
+add("Events", "Intermediate Event", (x, y) => ev(1.5, false)(x, y), "Occurs during flow execution, catching or throwing an event.");
+add("Events", "End Event", (x, y) => ev(3, false)(x, y), "Terminates a path or the whole process instance.");
+add("Events", "Non-interrupting Boundary", (x, y) => ev(1.5, true)(x, y), "Boundary event that does not cancel the activity.");
+add("Events", "Timer Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + timerIcon(x, y), "Fires on a date, cycle, or duration condition.");
+add("Events", "Message Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<rect x="${x + 5}" y="${y + 5}" width="10" height="7" fill="none" stroke="black" stroke-width="1.2"/>`, "Sends or receives a message between participants.");
+add("Events", "Error Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<polygon points="${x + 10},${y + 4} ${x + 14},${y + 16} ${x + 6},${y + 16}" fill="black" stroke="black" stroke-width="1.2"/>`, "Handles an error thrown by a failed activity.");
+add("Events", "Signal Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<polygon points="${x + 10},${y + 4} ${x + 16},${y + 16} ${x + 4},${y + 16}" fill="black" stroke="black" stroke-width="1.2"/>`, "Broadcasts or catches a signal across processes.");
+add("Events", "Escalation Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<polygon points="${x + 10},${y + 3} ${x + 16},${y + 17} ${x + 4},${y + 17}" fill="black" stroke="black" stroke-width="1.2"/>`, "Raises an escalation to an enclosing subprocess.");
+add("Events", "Compensation Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<polygon points="${x + 4},${y + 6} ${x + 10},${y + 6} ${x + 7},${y + 14} ${x + 13},${y + 14}" fill="black" stroke="black" stroke-width="1.2"/>`, "Triggers or confirms compensation.");
+add("Events", "Conditional Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<rect x="${x + 5}" y="${y + 5}" width="10" height="10" fill="black" stroke="black" stroke-width="1.2"/>`, "Fires when a condition becomes true.");
+add("Events", "Link Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<circle cx="${x + 10}" cy="${y + 10}" r="5" fill="black" stroke="black" stroke-width="1.2"/>`, "Connects two points in a large process.");
+add("Events", "Cancel Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<line x1="${x + 4}" y1="${y + 4}" x2="${x + 16}" y2="${y + 16}" stroke="black" stroke-width="1.5"/><line x1="${x + 16}" y1="${y + 4}" x2="${x + 4}" y2="${y + 16}" stroke="black" stroke-width="1.5"/>`, "Cancels a transaction subprocess.");
+add("Events", "Terminate Event", (x, y) => eventCircle(x + 10, y + 10, 10, 3, false) + `<circle cx="${x + 10}" cy="${y + 10}" r="5" fill="black" stroke="black" stroke-width="1.2"/>`, "Ends all running tokens in the process.");
+add("Events", "Multiple Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<polygon points="${x + 10},${y + 4} ${x + 16},${y + 6} ${x + 14},${y + 14} ${x + 6},${y + 14} ${x + 4},${y + 6}" fill="black" stroke="black" stroke-width="1.2"/>`, "Triggered when any listed condition occurs.");
+add("Events", "Parallel Multiple Event", (x, y) => eventCircle(x + 10, y + 10, 10, 1.5, false) + `<line x1="${x + 4}" y1="${y + 10}" x2="${x + 16}" y2="${y + 10}" stroke="black" stroke-width="1.2"/><line x1="${x + 10}" y1="${y + 4}" x2="${x + 10}" y2="${y + 16}" stroke="black" stroke-width="1.2"/>`, "Requires all listed events to have occurred.");
+const task = (x, y, iconSvg) => taskRect(x, y, 34, 22) + (iconSvg ? iconSvg.replace(/__x__/g, String(x + 10)).replace(/__y__/g, String(y + 4)) : "");
+add("Activities", "Task", (x, y) => taskRect(x, y, 34, 22), "Performs work that is not otherwise specialised.");
+add("Activities", "User Task", (x, y) => taskRect(x, y, 34, 22) + `<circle cx="${x + 17}" cy="${y + 9}" r="4" fill="none" stroke="black" stroke-width="1.2"/><line x1="${x + 17}" y1="${y + 13}" x2="${x + 17}" y2="${y + 18}" stroke="black" stroke-width="1.2"/>`, "Human work item performed by a person.");
+add("Activities", "Service Task", (x, y) => taskRect(x, y, 34, 22) + `<path d="M ${x + 17} ${y + 5} l 3 4 4 1 -4 1 -3 4 -3 -4 -4 -1 4 -1 z" fill="none" stroke="black" stroke-width="1.2"/>`, "Automated work performed by a service.");
+add("Activities", "Script Task", (x, y) => taskRect(x, y, 34, 22) + `<rect x="${x + 10}" y="${y + 6}" width="14" height="10" fill="none" stroke="black" stroke-width="1.2"/>`, "Executes a script within the engine.");
+add("Activities", "Send Task", (x, y) => taskRect(x, y, 34, 22) + `<polygon points="${x + 10},${y + 11} ${x + 24},${y + 4} ${x + 24},${y + 18}" fill="none" stroke="black" stroke-width="1.2"/>`, "Sends a message to another participant.");
+add("Activities", "Receive Task", (x, y) => taskRect(x, y, 34, 22) + `<polygon points="${x + 10},${y + 4} ${x + 24},${y + 11} ${x + 10},${y + 18}" fill="none" stroke="black" stroke-width="1.2"/>`, "Waits for and receives a message.");
+add("Activities", "Manual Task", (x, y) => taskRect(x, y, 34, 22) + `<path d="M ${x + 10} ${y + 18} V ${y + 11} M ${x + 14} ${y + 18} V ${y + 9} M ${x + 18} ${y + 18} V ${y + 9}" stroke="black" stroke-width="1.2" fill="none"/>`, "Work done by a person outside the system.");
+add("Activities", "Business Rule Task", (x, y) => taskRect(x, y, 34, 22) + `<rect x="${x + 13}" y="${y + 7}" width="8" height="8" fill="none" stroke="black" stroke-width="1.2"/>`, "Invokes a decision or rules service.");
+add("Activities", "Subprocess", (x, y) => taskRect(x, y, 34, 22) + `<line x1="${x + 13}" y1="${y + 11}" x2="${x + 21}" y2="${y + 11}" stroke="black" stroke-width="1.5"/><line x1="${x + 17}" y1="${y + 7}" x2="${x + 17}" y2="${y + 15}" stroke="black" stroke-width="1.5"/>`, "Embedded subprocess with its own scope.");
+add("Activities", "Ad-hoc Subprocess", (x, y) => taskRect(x, y, 34, 22) + `<text x="${x + 4}" y="${y + 16}" font-family="sans-serif" font-size="14" fill="black">~</text>`, "Subprocess with unordered inner activities.");
+add("Activities", "Transaction", (x, y) => doubleRect(x, y, 34, 22), "All-or-nothing subprocess boundary.");
+add("Activities", "Call Activity", (x, y) => thickRect(x, y, 34, 22), "Reusable callable subprocess (thick border).");
+add("Markers", "Loop Marker", (x, y) => `<path d="M ${x + 18} ${y + 11} a 6 6 0 1 1 -6 6" fill="none" stroke="black" stroke-width="1.2"/>`, "Repeats until a condition is met.");
+add("Markers", "Sequential Multi-instance", (x, y) => `<line x1="${x + 10}" y1="${y + 5}" x2="${x + 10}" y2="${y + 17}" stroke="black" stroke-width="1.2"/><line x1="${x + 14}" y1="${y + 5}" x2="${x + 14}" y2="${y + 17}" stroke="black" stroke-width="1.2"/><line x1="${x + 18}" y1="${y + 5}" x2="${x + 18}" y2="${y + 17}" stroke="black" stroke-width="1.2"/>`, "Creates instances processed one after another.");
+add("Markers", "Parallel Multi-instance", (x, y) => `<line x1="${x + 10}" y1="${y + 11}" x2="${x + 18}" y2="${y + 5}" stroke="black" stroke-width="1.2"/><line x1="${x + 10}" y1="${y + 11}" x2="${x + 18}" y2="${y + 11}" stroke="black" stroke-width="1.2"/><line x1="${x + 10}" y1="${y + 11}" x2="${x + 18}" y2="${y + 17}" stroke="black" stroke-width="1.2"/>`, "Creates instances processed concurrently.");
+add("Markers", "Compensation Marker", (x, y) => `<polygon points="${x + 6},${y + 3} ${x + 2},${y + 8} ${x + 6},${y + 13}" fill="black"/><polygon points="${x + 12},${y + 3} ${x + 8},${y + 8} ${x + 12},${y + 13}" fill="black"/>`, "Marks a compensation handler.");
+add("Gateways", "Exclusive Gateway", (x, y) => { const cx = x + 17, cy = y + 11, s = 12; return gatewayDiamond(cx, cy, s) + `<line x1="${cx - 4}" y1="${cy - 4}" x2="${cx + 4}" y2="${cy + 4}" stroke="black" stroke-width="1.5"/><line x1="${cx + 4}" y1="${cy - 4}" x2="${cx - 4}" y2="${cy + 4}" stroke="black" stroke-width="1.5"/>`; }, "One outgoing path is taken based on conditions.");
+add("Gateways", "Inclusive Gateway", (x, y) => { const cx = x + 17, cy = y + 11, s = 12; return gatewayDiamond(cx, cy, s) + `<circle cx="${cx}" cy="${cy}" r="4" fill="none" stroke="black" stroke-width="1.5"/>`; }, "One or more paths may be taken.");
+add("Gateways", "Parallel Gateway", (x, y) => { const cx = x + 17, cy = y + 11, s = 12; return gatewayDiamond(cx, cy, s) + `<line x1="${cx - 4}" y1="${cy}" x2="${cx + 4}" y2="${cy}" stroke="black" stroke-width="1.5"/><line x1="${cx}" y1="${cy - 4}" x2="${cx}" y2="${cy + 4}" stroke="black" stroke-width="1.5"/>`; }, "All outgoing paths are taken concurrently.");
+add("Gateways", "Event-Based Gateway", (x, y) => { const cx = x + 17, cy = y + 11, s = 12; return gatewayDiamond(cx, cy, s) + `<polygon points="${cx},${cy - 4} ${cx + 4},${cy} ${cx},${cy + 4} ${cx - 4},${cy}" fill="none" stroke="black" stroke-width="1.5"/>`; }, "Waits for one of several events before continuing.");
+add("Gateways", "Complex Gateway", (x, y) => { const cx = x + 17, cy = y + 11, s = 12; return gatewayDiamond(cx, cy, s) + `<text x="${cx}" y="${cy + 4}" text-anchor="middle" font-family="sans-serif" font-size="12" fill="black">*</text>`; }, "Custom merge/fork semantics with conditions.");
+add("Flows", "Sequence Flow", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1.5" marker-end="url(#arrow)"/>`, "Control passes from one element to the next.");
+add("Flows", "Default Flow", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1.5" marker-end="url(#arrow)"/><path d="M ${x + 12} ${y + 6} L ${x + 18} ${y + 11} L ${x + 12} ${y + 16}" fill="none" stroke="black" stroke-width="1.2"/>`, "Taken when no other condition matches.");
+add("Flows", "Conditional Flow", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1.5" stroke-dasharray="6 3" marker-end="url(#arrow)"/><polygon points="${x + 14},${y + 8} ${x + 19},${y + 11} ${x + 14},${y + 14}" fill="black"/>`, "Taken only if its condition holds.");
+add("Flows", "Message Flow", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1.5" stroke-dasharray="6 3" marker-end="url(#arrow-open)"/>`, "Communication between pools or participants.");
+add("Flows", "Association", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1" stroke-dasharray="2 2"/>`, "Relates artifacts to flow elements.");
+add("Flows", "Data Association", (x, y) => `<line x1="${x}" y1="${y + 11}" x2="${x + 30}" y2="${y + 11}" stroke="black" stroke-width="1" stroke-dasharray="2 2" marker-end="url(#arrow-open)"/>`, "Links data to activities or events.");
+add("Data", "Data Object", (x, y) => dataObject(x + 3, y + 4, 28, 16), "Carries business data through the process.");
+add("Data", "Data Store", (x, y) => dataStore(x + 3, y + 4, 28, 16), "Persistent shared data repository.");
+add("Organisation", "Pool", (x, y) => poolRect(x + 2, y + 4, 32, 16, true, true), "Represents a participant in collaboration.");
+add("Organisation", "Lane", (x, y) => laneRect(x + 2, y + 4, 32, 16, true), "Partitions a pool by role or responsibility.");
+add("Annotations/Groups", "Text Annotation", (x, y) => `<rect x="${x + 2}" y="${y + 4}" width="26" height="16" fill="none" stroke="black" stroke-width="1" stroke-dasharray="4 2"/>`, "Provides extra textual information.");
+add("Annotations/Groups", "Group", (x, y) => `<rect x="${x + 2}" y="${y + 4}" width="28" height="16" fill="none" stroke="black" stroke-width="1.5" stroke-dasharray="6 3" rx="6" ry="6"/>`, "Visually groups related elements.");
+export const CATALOG = cheatSheetCatalog;
+export const catalog = cheatSheetCatalog;

package/dist/cheat-sheet-cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cheat-sheet-cli.js

@@ -0,0 +1,7 @@
+import { runCheatSheet } from "./cheat-sheet-run.js";
+const result = runCheatSheet(process.argv.slice(2));
+if (result.stdout)
+    process.stdout.write(result.stdout);
+if (result.stderr)
+    process.stderr.write(result.stderr);
+process.exitCode = result.exitCode;

package/dist/cheat-sheet-compose.d.ts

@@ -0,0 +1,13 @@
+import { type CheatSheetEntry } from "./cheat-sheet-catalog.ts";
+export interface ComposeOptions {
+    catalog?: CheatSheetEntry[];
+    version?: string;
+}
+export declare const getVersion: () => string;
+export declare const composeCheatSheet: (options?: ComposeOptions) => string;
+export declare const compose: typeof composeCheatSheet;
+export declare const buildSvg: typeof composeCheatSheet;
+export declare const renderCheatSheet: typeof composeCheatSheet;
+export declare const composeCheatSheetSvg: typeof composeCheatSheet;
+export declare const build: typeof composeCheatSheet;
+export declare const generate: typeof composeCheatSheet;

package/dist/cheat-sheet-compose.js

@@ -0,0 +1,107 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { ROOT } from "./paths.js";
+import { cheatSheetCatalog } from "./cheat-sheet-catalog.js";
+export const getVersion = () => {
+    try {
+        const pkg = JSON.parse(readFileSync(resolve(ROOT, "package.json"), "utf8"));
+        return String(pkg.version ?? "0.0.0");
+    }
+    catch {
+        return "0.0.0";
+    }
+};
+export const composeCheatSheet = (options = {}) => {
+    const catalog = options.catalog ?? cheatSheetCatalog;
+    const version = options.version ?? getVersion();
+    const W = 595;
+    const H = 842;
+    const margin = 34;
+    const innerW = W - margin * 2;
+    const colW = (innerW - 12) / 2;
+    const glyphW = 44;
+    const titleY = margin + 20;
+    const subtitleY = titleY + 16;
+    const footerY = H - margin + 4;
+    const contentTop = subtitleY + 18;
+    const contentBottom = footerY - 18;
+    const availableH = contentBottom - contentTop;
+    const items = [];
+    let currentCat = "";
+    for (const entry of catalog) {
+        if (entry.category !== currentCat) {
+            currentCat = entry.category;
+            items.push({ type: "banner", category: currentCat });
+        }
+        items.push({ type: "row", entry });
+    }
+    const totalUnits = items.reduce((acc, it) => acc + (it.type === "banner" ? 1.4 : 1), 0);
+    const rowH = Math.max(12, Math.min(20, availableH / totalUnits));
+    const left = [];
+    const right = [];
+    const mid = Math.ceil(items.length / 2);
+    const leftItems = items.slice(0, mid);
+    const rightItems = items.slice(mid);
+    const esc = (v) => v.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const wrap = (text, maxPx) => {
+        const chars = Math.max(8, Math.floor(maxPx / 4.6));
+        const words = text.split(/\s+/);
+        const lines = [];
+        let cur = "";
+        for (const w of words) {
+            const cand = cur === "" ? w : `${cur} ${w}`;
+            if (cur !== "" && cand.length > chars) {
+                lines.push(cur);
+                cur = w;
+            }
+            else {
+                cur = cand;
+            }
+        }
+        if (cur !== "")
+            lines.push(cur);
+        return lines;
+    };
+    const renderBanner = (y, cat, colStartX, width) => {
+        const by = y + rowH * 0.3;
+        return `<rect x="${colStartX}" y="${by}" width="${width}" height="${rowH * 0.85}" fill="#e8e8e8" stroke="black" stroke-width="0.8"/><text x="${colStartX + 6}" y="${by + rowH * 0.6}" font-family="sans-serif" font-size="11" font-weight="bold" fill="black">${esc(cat)}</text>`;
+    };
+    const place = (list, startItems, startX) => {
+        let y = contentTop;
+        for (const it of startItems) {
+            if (it.type === "banner") {
+                list.push(renderBanner(y, it.category, startX, colW));
+                y += rowH * 1.4;
+            }
+            else {
+                const entry = it.entry;
+                const gy = y + (rowH - 22) / 2;
+                list.push(`<g>${entry.draw(startX + 4, gy)}</g>`);
+                const lines = wrap(entry.explanation, colW - glyphW - 4);
+                lines.slice(0, 2).forEach((ln, i) => {
+                    list.push(`<text x="${startX + glyphW}" y="${y + 9 + i * 10}" font-family="sans-serif" font-size="8.5" fill="black">${esc(ln)}</text>`);
+                });
+                y += rowH;
+            }
+        }
+    };
+    place(left, leftItems, margin);
+    place(right, rightItems, margin + colW + 12);
+    const defs = `<defs><marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" fill="black"/></marker><marker id="arrow-open" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M 0 0 L 10 5 L 0 10" fill="none" stroke="black" stroke-width="1.2"/></marker></defs>`;
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="0 0 ${W} ${H}">`,
+        defs,
+        `<text x="${W / 2}" y="${titleY}" text-anchor="middle" font-family="sans-serif" font-size="18" font-weight="bold" fill="black">BPMN 2.0 Cheat Sheet</text>`,
+        `<text x="${W / 2}" y="${subtitleY}" text-anchor="middle" font-family="sans-serif" font-size="10" fill="black">A one-page reference to the BPMN 2.0 notation vocabulary</text>`,
+        ...left,
+        ...right,
+        `<text x="${W / 2}" y="${footerY}" text-anchor="middle" font-family="sans-serif" font-size="9" fill="black">bpmn-ld ${esc(version)}</text>`,
+        `</svg>`,
+    ].join("");
+};
+export const compose = composeCheatSheet;
+export const buildSvg = composeCheatSheet;
+export const renderCheatSheet = composeCheatSheet;
+export const composeCheatSheetSvg = composeCheatSheet;
+export const build = composeCheatSheet;
+export const generate = composeCheatSheet;

package/dist/cheat-sheet-run.d.ts

@@ -0,0 +1,11 @@
+export declare const EXIT_OK = 0;
+export declare const EXIT_BAD_INPUT = 2;
+export interface CliResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare const USAGE = "Usage: cheat-sheet [options]\n\nGenerates a BPMN 2.0 cheat sheet SVG.\n\nOptions:\n  -o, --output <file>  Write SVG to <file> (use - for stdout)\n  -h, --help           Show this help\n\nExit codes:\n  0  Generated successfully\n  2  Usage error\n";
+export declare const runCheatSheet: (argv: string[]) => CliResult;
+export declare const runCheatSheetRun: typeof runCheatSheet;
+export declare const run: typeof runCheatSheet;

package/dist/cheat-sheet-run.js

@@ -0,0 +1,65 @@
+import { writeFileSync } from "node:fs";
+import { composeCheatSheet, getVersion } from "./cheat-sheet-compose.js";
+export const EXIT_OK = 0;
+export const EXIT_BAD_INPUT = 2;
+export const USAGE = `Usage: cheat-sheet [options]
+
+Generates a BPMN 2.0 cheat sheet SVG.
+
+Options:
+  -o, --output <file>  Write SVG to <file> (use - for stdout)
+  -h, --help           Show this help
+
+Exit codes:
+  0  Generated successfully
+  2  Usage error
+`;
+class UsageError extends Error {
+}
+const parseArgs = (argv) => {
+    const options = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "-h" || arg === "--help")
+            return "help";
+        else if (arg === "-o" || arg === "--output") {
+            const value = argv[++i];
+            if (value === undefined || value.startsWith("-") && value !== "-")
+                throw new UsageError(`${arg} requires a value`);
+            options.output = value;
+        }
+        else if (arg.startsWith("-"))
+            throw new UsageError(`unknown option ${arg}`);
+        else
+            throw new UsageError(`unexpected argument ${arg}`);
+    }
+    return options;
+};
+const failure = (stderr) => ({ exitCode: EXIT_BAD_INPUT, stdout: "", stderr });
+export const runCheatSheet = (argv) => {
+    let options;
+    try {
+        options = parseArgs(argv);
+    }
+    catch (error) {
+        if (error instanceof UsageError)
+            return failure(`error: ${error.message}\n\n${USAGE}`);
+        throw error;
+    }
+    if (options === "help")
+        return { exitCode: EXIT_OK, stdout: USAGE, stderr: "" };
+    const svg = composeCheatSheet();
+    const out = options.output ?? "bpmn-2.0-cheat-sheet.svg";
+    if (out === "-") {
+        return { exitCode: EXIT_OK, stdout: svg + "\n", stderr: "" };
+    }
+    try {
+        writeFileSync(out, svg + "\n", "utf8");
+    }
+    catch (error) {
+        return failure(`error: cannot write ${out}: ${error.message}\n`);
+    }
+    return { exitCode: EXIT_OK, stdout: "", stderr: "" };
+};
+export const runCheatSheetRun = runCheatSheet;
+export const run = runCheatSheet;

package/dist/cheat-sheet-svg.d.ts

@@ -0,0 +1,2 @@
+export * from "./cheat-sheet-compose.ts";
+export * from "./cheat-sheet-catalog.ts";

package/dist/cheat-sheet-svg.js

@@ -0,0 +1,2 @@
+export * from "./cheat-sheet-compose.js";
+export * from "./cheat-sheet-catalog.js";

package/dist/cheat-sheet.d.ts

@@ -0,0 +1,2 @@
+export * from "./cheat-sheet-catalog.ts";
+export * from "./cheat-sheet-compose.ts";

package/dist/cheat-sheet.js

@@ -0,0 +1,2 @@
+export * from "./cheat-sheet-catalog.js";
+export * from "./cheat-sheet-compose.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmn-ld/bpmn-ld",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A Semantic JSON-LD Representation of BPMN 2.0",
   "keywords": [
     "BPMN",
@@ -62,6 +62,7 @@
   },
   "files": [
     "dist",
+    "reference",
     "contexts",
     "ontology",
     "schema",

package/reference/bpmn-xsd/BPMN20.xsd

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsd:schema elementFormDefault="qualified" attributeFormDefault="unqualified"	
+	xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
+	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+	xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
+	targetNamespace="http://www.omg.org/spec/BPMN/20100524/MODEL">
+
+	<xsd:import namespace="http://www.omg.org/spec/BPMN/20100524/DI" schemaLocation="BPMNDI.xsd"/>
+	<xsd:include schemaLocation="Semantic.xsd"/>
+
+	<xsd:element name="definitions" type="tDefinitions"/>
+	<xsd:complexType name="tDefinitions">
+		<xsd:sequence>
+			<xsd:element ref="import" minOccurs="0" maxOccurs="unbounded"/>
+			<xsd:element ref="extension" minOccurs="0" maxOccurs="unbounded"/>
+			<xsd:element ref="rootElement" minOccurs="0" maxOccurs="unbounded"/>
+			<xsd:element ref="bpmndi:BPMNDiagram" minOccurs="0" maxOccurs="unbounded"/>
+			<xsd:element ref="relationship" minOccurs="0" maxOccurs="unbounded"/>
+		</xsd:sequence>
+		<xsd:attribute name="id" type="xsd:ID" use="optional"/>
+		<xsd:attribute name="name" type="xsd:string"/>
+		<xsd:attribute name="targetNamespace" type="xsd:anyURI" use="required"/>
+		<xsd:attribute name="expressionLanguage" type="xsd:anyURI" use="optional" default="http://www.w3.org/1999/XPath"/>
+		<xsd:attribute name="typeLanguage" type="xsd:anyURI" use="optional" default="http://www.w3.org/2001/XMLSchema"/>
+		<xsd:attribute name="exporter" type="xsd:string"/>
+		<xsd:attribute name="exporterVersion" type="xsd:string"/>
+		<xsd:anyAttribute namespace="##other" processContents="lax"/>
+	</xsd:complexType>
+	
+	<xsd:element name="import" type="tImport"/>
+	<xsd:complexType name="tImport">
+		<xsd:attribute name="namespace" type="xsd:anyURI" use="required"/>
+		<xsd:attribute name="location" type="xsd:string" use="required"/>
+		<xsd:attribute name="importType" type="xsd:anyURI" use="required"/>
+	</xsd:complexType>
+
+</xsd:schema>

package/reference/bpmn-xsd/BPMNDI.xsd

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" targetNamespace="http://www.omg.org/spec/BPMN/20100524/DI"  elementFormDefault="qualified" attributeFormDefault="unqualified">
+
+	<xsd:import namespace="http://www.omg.org/spec/DD/20100524/DC" schemaLocation="DC.xsd" />
+	<xsd:import namespace="http://www.omg.org/spec/DD/20100524/DI" schemaLocation="DI.xsd" />
+	
+	<xsd:element name="BPMNDiagram" type="bpmndi:BPMNDiagram" />
+	<xsd:element name="BPMNPlane" type="bpmndi:BPMNPlane" />
+	<xsd:element name="BPMNLabelStyle" type="bpmndi:BPMNLabelStyle" />
+	<xsd:element name="BPMNShape" type="bpmndi:BPMNShape" substitutionGroup="di:DiagramElement" />
+	<xsd:element name="BPMNLabel" type="bpmndi:BPMNLabel" />
+	<xsd:element name="BPMNEdge" type="bpmndi:BPMNEdge" substitutionGroup="di:DiagramElement" />
+	
+	<xsd:complexType name="BPMNDiagram">
+		<xsd:complexContent>
+			<xsd:extension base="di:Diagram">
+				<xsd:sequence>
+					<xsd:element ref="bpmndi:BPMNPlane" />
+					<xsd:element ref="bpmndi:BPMNLabelStyle" maxOccurs="unbounded" minOccurs="0" />
+				</xsd:sequence>
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:complexType name="BPMNPlane">
+		<xsd:complexContent>
+			<xsd:extension base="di:Plane">
+				<xsd:attribute name="bpmnElement" type="xsd:QName" />
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:complexType name="BPMNEdge">
+		<xsd:complexContent>
+			<xsd:extension base="di:LabeledEdge">
+				<xsd:sequence>
+					<xsd:element ref="bpmndi:BPMNLabel" minOccurs="0" />
+				</xsd:sequence>
+				<xsd:attribute name="bpmnElement" type="xsd:QName" />
+				<xsd:attribute name="sourceElement" type="xsd:QName" />
+				<xsd:attribute name="targetElement" type="xsd:QName" />
+				<xsd:attribute name="messageVisibleKind" type="bpmndi:MessageVisibleKind" />
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:complexType name="BPMNShape">
+		<xsd:complexContent>
+			<xsd:extension base="di:LabeledShape">
+				<xsd:sequence>
+					<xsd:element ref="bpmndi:BPMNLabel" minOccurs="0" />
+				</xsd:sequence>
+				<xsd:attribute name="bpmnElement" type="xsd:QName" />
+				<xsd:attribute name="isHorizontal" type="xsd:boolean" />
+				<xsd:attribute name="isExpanded" type="xsd:boolean" />
+				<xsd:attribute name="isMarkerVisible" type="xsd:boolean" />
+				<xsd:attribute name="isMessageVisible" type="xsd:boolean" />
+				<xsd:attribute name="participantBandKind" type="bpmndi:ParticipantBandKind" />
+        		<xsd:attribute name="choreographyActivityShape" type="xsd:QName"/>
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:complexType name="BPMNLabel">
+		<xsd:complexContent>
+			<xsd:extension base="di:Label">
+				<xsd:attribute name="labelStyle" type="xsd:QName" />
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:complexType name="BPMNLabelStyle">
+		<xsd:complexContent>
+			<xsd:extension base="di:Style">
+				<xsd:sequence>
+					<xsd:element ref="dc:Font" />
+				</xsd:sequence>
+			</xsd:extension>
+		</xsd:complexContent>
+	</xsd:complexType>
+	
+	<xsd:simpleType name="ParticipantBandKind">
+		<xsd:restriction base="xsd:string">
+			<xsd:enumeration value="top_initiating" />
+			<xsd:enumeration value="middle_initiating" />
+			<xsd:enumeration value="bottom_initiating" />
+			<xsd:enumeration value="top_non_initiating" />
+			<xsd:enumeration value="middle_non_initiating" />
+			<xsd:enumeration value="bottom_non_initiating" />
+		</xsd:restriction>
+	</xsd:simpleType>
+	
+	<xsd:simpleType name="MessageVisibleKind">
+		<xsd:restriction base="xsd:string">
+			<xsd:enumeration value="initiating" />
+			<xsd:enumeration value="non_initiating" />
+		</xsd:restriction>
+	</xsd:simpleType>
+
+</xsd:schema>

package/reference/bpmn-xsd/DC.xsd

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" targetNamespace="http://www.omg.org/spec/DD/20100524/DC" elementFormDefault="qualified" attributeFormDefault="unqualified">
+
+	<xsd:element name="Font" type="dc:Font" />
+	<xsd:element name="Point" type="dc:Point" />
+	<xsd:element name="Bounds" type="dc:Bounds" />
+	
+	<xsd:complexType name="Font">
+		<xsd:attribute name="name" type="xsd:string" />
+		<xsd:attribute name="size" type="xsd:double" />
+		<xsd:attribute name="isBold" type="xsd:boolean" />
+		<xsd:attribute name="isItalic" type="xsd:boolean" />
+		<xsd:attribute name="isUnderline" type="xsd:boolean" />
+		<xsd:attribute name="isStrikeThrough" type="xsd:boolean" />
+	</xsd:complexType>
+	
+	<xsd:complexType name="Point">
+		<xsd:attribute name="x" type="xsd:double" use="required" />
+		<xsd:attribute name="y" type="xsd:double" use="required" />
+	</xsd:complexType>
+	
+	<xsd:complexType name="Bounds">
+		<xsd:attribute name="x" type="xsd:double" use="required" />
+		<xsd:attribute name="y" type="xsd:double" use="required" />
+		<xsd:attribute name="width" type="xsd:double" use="required" />
+		<xsd:attribute name="height" type="xsd:double" use="required" />
+	</xsd:complexType>
+
+</xsd:schema>