@bpmnkit/plugins 0.0.32 → 0.1.0

package/README.md

@@ -9,7 +9,7 @@
   [![ai-assisted](https://img.shields.io/badge/AI--assisted-claude-8b5cf6?style=flat-square)](https://github.com/bpmnkit/monorepo)
   [![experimental](https://img.shields.io/badge/status-experimental-f59e0b?style=flat-square)](https://github.com/bpmnkit/monorepo)
 
-  [Website](https://bpmnkit.com) · [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/packages/plugins/CHANGELOG.md)
+  [Website](https://bpmnkit.com) · [Documentation](https://bpmnkit.com/docs) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/packages/plugins/CHANGELOG.md)
 </div>
 
 ---
@@ -147,10 +147,12 @@ const ai = createAiBridgePlugin({
 | [`@bpmnkit/feel`](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language parser & evaluator |
 | [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
 | [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/docspack`](https://www.npmjs.com/package/@bpmnkit/docspack) | BPMN Kit docs as an offline docspack package for AI agents |
 | [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
 | [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
 | [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
 | [`@bpmnkit/connector-gen`](https://www.npmjs.com/package/@bpmnkit/connector-gen) | Generate connector templates from OpenAPI specs |
+| [`@bpmnkit/connectors`](https://www.npmjs.com/package/@bpmnkit/connectors) | Camunda 8 OOTB connector catalog and deterministic template application |
 | [`@bpmnkit/cli`](https://www.npmjs.com/package/@bpmnkit/cli) | Camunda 8 command-line interface (casen) |
 | [`@bpmnkit/proxy`](https://www.npmjs.com/package/@bpmnkit/proxy) | Local AI bridge and Camunda API proxy server |
 | [`@bpmnkit/patterns`](https://www.npmjs.com/package/@bpmnkit/patterns) | Domain process patterns for BPMNKit AIKit |

package/dist/ai-bridge/panel.js

@@ -65,14 +65,17 @@ async function* streamChat(serverUrl, messages, context, backend, signal, action
         reader.releaseLock();
     }
 }
-async function* streamImprove(serverUrl, compactDiagram, backend, signal, onOps, onXml) {
+async function* streamImprove(serverUrl, xml, backend, signal, onOps, onXml) {
     let res;
     try {
         res = await fetch(`${serverUrl}/improve`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
-                context: compactDiagram,
+                // The whole model, not a compact projection of it: the server applies
+                // the operations to this, so pools, lanes, data wiring and ioMapping
+                // detail survive an edit. It compactifies for the prompt itself.
+                xml,
                 instruction: null,
                 backend: backend === "auto" ? null : backend,
             }),
@@ -931,13 +934,12 @@ export function createAiPanel(options) {
         addMessage("user", "Improve this diagram");
         const aiMsgEl = addMessage("ai", "");
         aiMsgEl.classList.add("ai-msg-cursor");
-        const compactDiagram = compactify(defs);
         let capturedOps = [];
         let capturedAutoFixCount = 0;
         let capturedXml;
         let fullText = "";
         try {
-            for await (const token of streamImprove(options.serverUrl, compactDiagram, backendSelect.value, signal, (ops, autoFixCount) => {
+            for await (const token of streamImprove(options.serverUrl, Bpmn.export(defs), backendSelect.value, signal, (ops, autoFixCount) => {
                 capturedOps = ops;
                 capturedAutoFixCount = autoFixCount;
             }, (xml) => {

package/dist/command-palette/index.d.ts

@@ -50,7 +50,7 @@ export interface CommandPaletteOptions {
     aiServerUrl?: string;
     /**
      * Base URL for documentation links.
-     * Defaults to `https://docs.bpmnkit.com`.
+     * Defaults to `https://bpmnkit.com/docs`.
      */
     docsBaseUrl?: string;
 }

package/dist/command-palette/index.js

@@ -39,31 +39,31 @@ function wordsMatch(text, query) {
         .every((w) => target.includes(w));
 }
 // ── Docs registry ─────────────────────────────────────────────────────────────
-const DOCS_BASE_DEFAULT = "https://docs.bpmnkit.com";
+const DOCS_BASE_DEFAULT = "https://bpmnkit.com/docs";
 const DOC_ENTRIES = [
     {
         title: "Quick Start",
-        path: "/getting-started/quick-start/",
+        path: "/getting-started/quick-start",
         keywords: ["start", "install", "begin", "setup", "first", "hello", "quickstart"],
     },
     {
         title: "Installation",
-        path: "/getting-started/installation/",
+        path: "/getting-started/installation",
         keywords: ["install", "npm", "pnpm", "yarn", "add", "package", "require"],
     },
     {
         title: "Concepts",
-        path: "/getting-started/concepts/",
+        path: "/getting-started/concepts",
         keywords: ["concept", "bpmn", "process", "element", "overview", "intro", "what"],
     },
     {
         title: "Building Processes",
-        path: "/guides/building-processes/",
+        path: "/guides/building-processes",
         keywords: ["build", "create", "process", "task", "flow", "sequence", "diagram", "guide"],
     },
     {
         title: "Gateways",
-        path: "/guides/gateways/",
+        path: "/guides/gateways",
         keywords: [
             "gateway",
             "exclusive",
@@ -79,17 +79,17 @@ const DOC_ENTRIES = [
     },
     {
         title: "Simulation",
-        path: "/guides/simulation/",
+        path: "/guides/simulation",
         keywords: ["simulate", "run", "test", "engine", "execute", "play", "simulation"],
     },
     {
         title: "Deployment",
-        path: "/guides/deployment/",
+        path: "/guides/deployment",
         keywords: ["deploy", "camunda", "cluster", "zeebe", "publish", "production", "upload"],
     },
     {
         title: "AI Guide",
-        path: "/guides/ai/",
+        path: "/guides/ai",
         keywords: [
             "ai",
             "artificial",
@@ -105,7 +105,7 @@ const DOC_ENTRIES = [
     },
     {
         title: "@bpmnkit/core",
-        path: "/packages/core/",
+        path: "/packages/core",
         keywords: [
             "core",
             "parser",
@@ -120,32 +120,32 @@ const DOC_ENTRIES = [
     },
     {
         title: "@bpmnkit/editor",
-        path: "/packages/editor/",
+        path: "/packages/editor",
         keywords: ["editor", "edit", "modeler", "interactive", "canvas", "plugin"],
     },
     {
         title: "@bpmnkit/engine",
-        path: "/packages/engine/",
+        path: "/packages/engine",
         keywords: ["engine", "execute", "run", "simulate", "worker", "job", "token", "fire"],
     },
     {
         title: "@bpmnkit/api",
-        path: "/packages/api/",
+        path: "/packages/api",
         keywords: ["api", "client", "camunda", "rest", "http", "zeebe", "operate", "instance"],
     },
     {
         title: "@bpmnkit/canvas",
-        path: "/packages/canvas/",
+        path: "/packages/canvas",
         keywords: ["canvas", "viewer", "svg", "render", "view", "display", "embed"],
     },
     {
         title: "Connector Generator",
-        path: "/packages/connector-gen/",
+        path: "/packages/connector-gen",
         keywords: ["connector", "openapi", "swagger", "template", "generate", "rest", "http", "api"],
     },
     {
         title: "casen CLI",
-        path: "/cli/casen/",
+        path: "/cli/casen",
         keywords: [
             "cli",
             "command",
@@ -161,7 +161,7 @@ const DOC_ENTRIES = [
     },
     {
         title: "casen connector",
-        path: "/cli/connector/",
+        path: "/cli/connector",
         keywords: ["connector", "cli", "generate", "api", "catalog", "swagger", "openapi"],
     },
 ];

package/dist/config-panel-bpmn/index.d.ts

@@ -25,11 +25,11 @@
  * @packageDocumentation
  */
 import type { CanvasPlugin } from "@bpmnkit/canvas";
+import type { ElementTemplate } from "@bpmnkit/connectors";
 import type { BpmnDefinitions } from "@bpmnkit/core";
 import { ELEMENT_TYPE_LABELS } from "@bpmnkit/editor";
 import type { ConfigPanelPlugin } from "../config-panel/index.js";
-import type { ElementTemplate } from "./template-types.js";
-export { CAMUNDA_CONNECTOR_TEMPLATES } from "./templates/generated.js";
+export { CAMUNDA_CONNECTOR_TEMPLATES } from "@bpmnkit/connectors";
 export { templateToServiceTaskOptions } from "./template-to-service-task.js";
 export interface ConfigPanelBpmnOptions {
     /**

package/dist/config-panel-bpmn/index.js

@@ -24,11 +24,11 @@
  *
  * @packageDocumentation
  */
+import { CAMUNDA_CONNECTOR_TEMPLATES } from "@bpmnkit/connectors";
 import { buildValidationDmn, findValidationStructure, insertValidationStructure, removeValidationStructure, validationDecisionId, zeebeExtensionsToXmlElements, } from "@bpmnkit/core";
 import { ELEMENT_TYPE_LABELS } from "@bpmnkit/editor";
+export { CAMUNDA_CONNECTOR_TEMPLATES } from "@bpmnkit/connectors";
 import { buildRegistrationFromTemplate } from "./template-engine.js";
-import { CAMUNDA_CONNECTOR_TEMPLATES } from "./templates/generated.js";
-export { CAMUNDA_CONNECTOR_TEMPLATES } from "./templates/generated.js";
 export { templateToServiceTaskOptions } from "./template-to-service-task.js";
 import { buildPropertiesWithExampleOutput, buildZeebeLoopCharacteristics, findFlowElement, findSequenceFlow, getExampleOutputJson, getIoInput, getTaskHeader, parseCalledElement, parseZeebeError, parseZeebeEscalation, parseZeebeExtensions, parseZeebeLoopCharacteristics, parseZeebeMessage, parseZeebeScript, parseZeebeSignal, updateFlowElement, updateSequenceFlow, xmlLocalName, } from "./util.js";
 /** Validates that a field value is valid JSON, or returns an error message. */

package/dist/config-panel-bpmn/template-engine.d.ts

@@ -2,8 +2,8 @@
  * Converts a Camunda element template into the PanelSchema + PanelAdapter pair
  * used by the config-panel plugin renderer.
  */
+import type { ElementTemplate } from "@bpmnkit/connectors";
 import type { PanelAdapter, PanelSchema } from "../config-panel/index.js";
-import type { ElementTemplate } from "./template-types.js";
 export interface TemplateRegistration {
     schema: PanelSchema;
     adapter: PanelAdapter;

package/dist/config-panel-bpmn/template-to-service-task.d.ts

@@ -2,13 +2,17 @@
  * Convert an element template + user-provided values into ServiceTaskOptions
  * for use with the core `Bpmn` builder.
  */
+import type { ElementTemplate } from "@bpmnkit/connectors";
 import type { ServiceTaskOptions } from "@bpmnkit/core";
-import type { ElementTemplate } from "./template-types.js";
 /**
- * Convert a Camunda element template into `ServiceTaskOptions` for the core
+ * Converts a Camunda element template into `ServiceTaskOptions` for the core
  * `Bpmn` builder, applying `values` for user-configurable properties and
  * fixed template defaults for Hidden properties.
  *
+ * Delegates to `@bpmnkit/connectors`' `applyElementTemplate()`, which resolves
+ * every binding kind (`zeebe:input`/`output`/`taskHeader`/`taskDefinition`/`property`),
+ * not just `zeebe:input` as this function did historically.
+ *
  * @example
  * ```typescript
  * import { Bpmn } from "@bpmnkit/core";

package/dist/config-panel-bpmn/template-to-service-task.js

@@ -1,46 +1,13 @@
-/** Derive the lookup key for a template property (same logic as the template engine). */
-function propertyKey(prop) {
-    if (prop.id)
-        return prop.id;
-    const b = prop.binding;
-    if (b.type === "zeebe:input")
-        return b.name;
-    if (b.type === "zeebe:output")
-        return b.source;
-    if (b.type === "zeebe:taskHeader")
-        return b.key;
-    if (b.type === "zeebe:taskDefinition")
-        return `taskDef.${b.property}`;
-    if (b.type === "zeebe:taskDefinition:type")
-        return "taskDef.type";
-    if (b.type === "property")
-        return b.name;
-    if (b.type === "zeebe:property")
-        return b.name;
-    return "";
-}
-function applyBinding(binding, value, inputs, taskHeaders, out) {
-    if (binding.type === "zeebe:input") {
-        inputs.push({ source: value, target: binding.name });
-    }
-    else if (binding.type === "zeebe:taskHeader") {
-        taskHeaders[binding.key] = value;
-    }
-    else if (binding.type === "zeebe:taskDefinition" && binding.property === "type") {
-        out.taskType = value;
-    }
-    else if (binding.type === "zeebe:taskDefinition" && binding.property === "retries") {
-        out.retries = value;
-    }
-    else if (binding.type === "zeebe:taskDefinition:type") {
-        out.taskType = value;
-    }
-}
+import { applyElementTemplate } from "@bpmnkit/connectors";
 /**
- * Convert a Camunda element template into `ServiceTaskOptions` for the core
+ * Converts a Camunda element template into `ServiceTaskOptions` for the core
  * `Bpmn` builder, applying `values` for user-configurable properties and
  * fixed template defaults for Hidden properties.
  *
+ * Delegates to `@bpmnkit/connectors`' `applyElementTemplate()`, which resolves
+ * every binding kind (`zeebe:input`/`output`/`taskHeader`/`taskDefinition`/`property`),
+ * not just `zeebe:input` as this function did historically.
+ *
  * @example
  * ```typescript
  * import { Bpmn } from "@bpmnkit/core";
@@ -59,34 +26,10 @@ function applyBinding(binding, value, inputs, taskHeaders, out) {
  * ```
  */
 export function templateToServiceTaskOptions(template, values = {}) {
-    const inputs = [];
-    const taskHeaders = {};
-    const out = {
-        taskType: "",
-        retries: undefined,
-    };
-    for (const prop of template.properties) {
-        if (prop.type === "Hidden") {
-            if (typeof prop.value === "string" && prop.value) {
-                applyBinding(prop.binding, prop.value, inputs, taskHeaders, out);
-            }
-            continue;
-        }
-        const key = propertyKey(prop);
-        const val = values[key] ?? (typeof prop.value === "string" ? prop.value : undefined);
-        if (!val)
-            continue;
-        applyBinding(prop.binding, val, inputs, taskHeaders, out);
-    }
-    return {
+    const result = applyElementTemplate(template, values);
+    return (result.serviceTask ?? {
         name: values.name ?? template.name,
-        taskType: out.taskType,
-        retries: out.retries,
-        modelerTemplate: template.id,
-        modelerTemplateVersion: template.version !== undefined ? String(template.version) : undefined,
-        modelerTemplateIcon: template.icon?.contents,
-        ioMapping: inputs.length > 0 ? { inputs } : undefined,
-        taskHeaders: Object.keys(taskHeaders).length > 0 ? taskHeaders : undefined,
-    };
+        taskType: "",
+    });
 }
 //# sourceMappingURL=template-to-service-task.js.map

package/dist/config-panel-bpmn/util.js

@@ -5,9 +5,37 @@ export function xmlLocalName(qname) {
     return idx >= 0 ? qname.slice(idx + 1) : qname;
 }
 // ── Element lookup / update ───────────────────────────────────────────────────
+// id → index per flowElements array. Every badge refresh looks up every shape,
+// which made the panel O(S²) per change. Positions are verified against the
+// array on each hit, so an array mutated in place still resolves correctly.
+const positionIndex = new WeakMap();
+function indexedFind(elements, id) {
+    let index = positionIndex.get(elements);
+    if (index === undefined) {
+        index = new Map();
+        for (let i = 0; i < elements.length; i++)
+            index.set(elements[i].id, i);
+        positionIndex.set(elements, index);
+    }
+    const at = index.get(id);
+    if (at !== undefined) {
+        const hit = elements[at];
+        if (hit !== undefined && hit.id === id)
+            return hit;
+    }
+    // Stale or missing entry: fall back to a scan and repair the index.
+    for (let i = 0; i < elements.length; i++) {
+        const el = elements[i];
+        if (el.id === id) {
+            index.set(id, i);
+            return el;
+        }
+    }
+    return undefined;
+}
 export function findFlowElement(defs, id) {
     for (const process of defs.processes) {
-        const el = process.flowElements.find((e) => e.id === id);
+        const el = indexedFind(process.flowElements, id);
         if (el)
             return el;
     }

package/dist/connector-catalog/builtin-templates.d.ts

@@ -5,6 +5,6 @@
  * the local proxy is running. They mirror the runtime definitions served by
  * `GET /worker-templates` on the proxy.
  */
-import type { ElementTemplate } from "../config-panel-bpmn/template-types.js";
+import type { ElementTemplate } from "@bpmnkit/connectors";
 export declare const BUILTIN_WORKER_TEMPLATES: ElementTemplate[];
 //# sourceMappingURL=builtin-templates.d.ts.map

package/dist/connector-catalog/panel.d.ts

@@ -9,7 +9,7 @@
  *   panel.open()
  */
 import type { CatalogEntry } from "@bpmnkit/connector-gen/browser";
-import type { ElementTemplate } from "../config-panel-bpmn/template-types.js";
+import type { ElementTemplate } from "@bpmnkit/connectors";
 export interface CatalogPanelOptions {
     builtinTemplates: ElementTemplate[];
     catalogEntries: CatalogEntry[];

package/dist/storage/auto-save.d.ts

@@ -1,10 +1,12 @@
+/** Content to save, or a producer that renders it when the save actually runs. */
+export type SaveContent = string | (() => string);
 export declare class AutoSave {
     private readonly _timers;
     private readonly _latest;
     private readonly _delay;
     private readonly _onSave;
     constructor(onSave: (fileId: string, content: string) => Promise<void>, delay?: number);
-    schedule(fileId: string, content: string): void;
+    schedule(fileId: string, content: SaveContent): void;
     flush(): Promise<void>;
     private _save;
 }

package/dist/storage/auto-save.js

@@ -30,7 +30,7 @@ export class AutoSave {
             this._timers.delete(fileId);
         }
         this._latest.clear();
-        await Promise.all(entries.map(([id, content]) => this._onSave(id, content)));
+        await Promise.all(entries.map(([id, content]) => this._onSave(id, resolveContent(content))));
     }
     async _save(fileId) {
         const content = this._latest.get(fileId);
@@ -38,7 +38,10 @@ export class AutoSave {
             return;
         this._latest.delete(fileId);
         this._timers.delete(fileId);
-        await this._onSave(fileId, content);
+        await this._onSave(fileId, resolveContent(content));
     }
 }
+function resolveContent(content) {
+    return typeof content === "function" ? content() : content;
+}
 //# sourceMappingURL=auto-save.js.map

package/dist/storage/index.js

@@ -184,9 +184,9 @@ export function createStoragePlugin(options) {
                 const currentId = storageApi.getCurrentFileId();
                 if (!currentId)
                     return;
+                // Export lazily: only the last change before the debounced save is serialized.
                 const defs = rawDefs;
-                const xml = Bpmn.export(defs);
-                storageApi.scheduleSave(currentId, xml);
+                storageApi.scheduleSave(currentId, () => Bpmn.export(defs));
             }
             offDiagramChange = anyOn("diagram:change", onDiagramUpdate);
             anyOn("diagram:load", onDiagramUpdate);

package/dist/storage/storage-api.d.ts

@@ -1,3 +1,4 @@
+import type { SaveContent } from "./auto-save.js";
 import type { FileRecord, FileType, ProjectRecord, WorkspaceRecord } from "./types.js";
 export interface StorageApiOptions {
     /** Called when the user opens a file from the menu. */
@@ -60,7 +61,7 @@ export declare class StorageApi {
         projectId: string;
         fileId: string;
     } | null;
-    scheduleSave(fileId: string, content: string): void;
+    scheduleSave(fileId: string, content: SaveContent): void;
     flush(): Promise<void>;
     private _persistContent;
     private _updateProjectCacheTimestamp;

package/dist/tabs/tabs-plugin.js

@@ -699,15 +699,18 @@ export function createTabsPlugin(options = {}) {
     // --- BPMN process tracking ---
     function trackBpmnProcesses(tabId, xml) {
         try {
-            for (const proc of Bpmn.parse(xml).processes) {
-                bpmnProcessToTabId.set(proc.id, tabId);
-                bpmnProcessNames.set(proc.id, proc.name ?? proc.id);
-            }
+            trackBpmnDefinitions(tabId, Bpmn.parse(xml));
         }
         catch {
             // Malformed XML — tab still opens, process map unchanged
         }
     }
+    function trackBpmnDefinitions(tabId, defs) {
+        for (const proc of defs.processes) {
+            bpmnProcessToTabId.set(proc.id, tabId);
+            bpmnProcessNames.set(proc.id, proc.name ?? proc.id);
+        }
+    }
     function untrackBpmnProcesses(tabId) {
         for (const [procId, tid] of [...bpmnProcessToTabId]) {
             if (tid === tabId) {
@@ -1128,9 +1131,10 @@ export function createTabsPlugin(options = {}) {
                 const xml = Bpmn.export(defs);
                 // Update stored XML so onTabActivate always receives the latest content
                 activeTab.config = { ...activeTab.config, xml };
-                // Refresh process map for this tab
+                // Refresh process map for this tab from the model we already have,
+                // rather than parsing the XML we just produced.
                 untrackBpmnProcesses(activeId);
-                trackBpmnProcesses(activeId, xml);
+                trackBpmnDefinitions(activeId, defs);
                 // Keep raw pane in sync
                 if (isRawMode)
                     updateRawPane();

package/dist/token-highlight/index.js

@@ -1,4 +1,4 @@
-import { injectTokenHighlightStyles } from "./css";
+import { injectTokenHighlightStyles } from "./css.js";
 // ── Plugin factory ─────────────────────────────────────────────────────────────
 export function createTokenHighlightPlugin() {
     let canvasApi = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmnkit/plugins",
-  "version": "0.0.32",
+  "version": "0.1.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -132,12 +132,13 @@
     "dist/**/*.d.ts"
   ],
   "dependencies": {
-    "@bpmnkit/ascii": "0.0.29",
-    "@bpmnkit/canvas": "0.0.29",
-    "@bpmnkit/connector-gen": "0.0.14",
-    "@bpmnkit/core": "0.1.1",
-    "@bpmnkit/editor": "0.0.32",
-    "@bpmnkit/feel": "0.0.19"
+    "@bpmnkit/canvas": "0.0.31",
+    "@bpmnkit/ascii": "0.0.31",
+    "@bpmnkit/connector-gen": "0.0.15",
+    "@bpmnkit/connectors": "0.0.3",
+    "@bpmnkit/core": "0.2.0",
+    "@bpmnkit/feel": "0.0.20",
+    "@bpmnkit/editor": "0.0.34"
   },
   "description": "23 composable canvas plugins for BPMN editors and viewers — minimap, AI chat, process simulation, storage, and more",
   "keywords": [