@formicoidea/labre-framework-bpmn 0.31.0 → 0.33.0

package/dist/toolbar/icons.d.ts

@@ -1,15 +1,82 @@
 /** Colored BPMN glyph for the main toolbar button: a pool (green name band) with
  * a single activity inside. */
 export declare const bpmnToolbarIcon: import("lit-html").TemplateResult<2>;
+/** Export BPMN XML — a document with an arrow leaving it. */
+export declare const bpmnExportXmlIcon: import("lit-html").TemplateResult<2>;
+/**
+ * Import BPMN XML — the export's document, with the arrow coming back IN.
+ *
+ * Deliberately the same page and the same arrow, mirrored: the two commands are
+ * one subject in two directions, and a reader who has met one should recognise
+ * the other without reading its label.
+ */
+export declare const bpmnImportXmlIcon: import("lit-html").TemplateResult<2>;
+/**
+ * Import an SVG sketch — the import page again, with the picture frame that
+ * says "this arrives as a drawing" rather than as a process.
+ *
+ * Kept a sibling of {@link bpmnImportXmlIcon} on purpose: they are the same
+ * gesture (a file becomes a board) and the difference between them is the TIER,
+ * which is what the mountain-in-a-frame glyph is for.
+ */
+export declare const bpmnImportSvgIcon: import("lit-html").TemplateResult<2>;
 /** Start event — thin green ring. */
 export declare const bpmnStartIcon: import("lit-html").TemplateResult<2>;
 /** End event — thick red ring. */
 export declare const bpmnEndIcon: import("lit-html").TemplateResult<2>;
+/** Message start event — thin green ring, envelope inside. */
+export declare const bpmnStartMessageIcon: import("lit-html").TemplateResult<2>;
+/** Timer start event — thin green ring, clock inside (rim + two hands). */
+export declare const bpmnStartTimerIcon: import("lit-html").TemplateResult<2>;
+/** Message end event — thick red ring, envelope inside. */
+export declare const bpmnEndMessageIcon: import("lit-html").TemplateResult<2>;
+/** Terminate end event — thick red ring, solid disc inside. */
+export declare const bpmnEndTerminateIcon: import("lit-html").TemplateResult<2>;
 /** Task — rounded rectangle. */
 export declare const bpmnTaskIcon: import("lit-html").TemplateResult<2>;
+/** User task — the rectangle with a person in its top-left corner. */
+export declare const bpmnTaskUserIcon: import("lit-html").TemplateResult<2>;
+/** Service task — the rectangle with a gear in its top-left corner. */
+export declare const bpmnTaskServiceIcon: import("lit-html").TemplateResult<2>;
+/** Sub-process — the rectangle with the collapsed [+] marker on its bottom edge. */
+export declare const bpmnSubProcessIcon: import("lit-html").TemplateResult<2>;
+/** Call activity — the same [+] marker, on the notation's THICKEST border. */
+export declare const bpmnCallActivityIcon: import("lit-html").TemplateResult<2>;
 /** Exclusive gateway — diamond with an X. */
 export declare const bpmnGatewayIcon: import("lit-html").TemplateResult<2>;
+/** Parallel gateway — diamond with a +. */
+export declare const bpmnGatewayParallelIcon: import("lit-html").TemplateResult<2>;
+/** Data object — a page with its top-right corner turned down. */
+export declare const bpmnDataObjectIcon: import("lit-html").TemplateResult<2>;
+/** Data store — a cylinder. */
+export declare const bpmnDataStoreIcon: import("lit-html").TemplateResult<2>;
+/** Text annotation — an open bracket down the leading edge, and a note beside it. */
+export declare const bpmnTextAnnotationIcon: import("lit-html").TemplateResult<2>;
 /** Sequence flow — solid arrow with a filled head. */
 export declare const bpmnSequenceIcon: import("lit-html").TemplateResult<2>;
+/** Group — a dashed, generously rounded rectangle drawn AROUND things. */
+export declare const bpmnGroupIcon: import("lit-html").TemplateResult<2>;
+/**
+ * Message flow — dashed line, disc at the source, open head at the target.
+ *
+ * The source terminator is drawn FILLED because that is what the canvas paints:
+ * `renderCircle` fills with the connector's `fillColor` before stroking it. The
+ * norm asks for a hollow ring, and the shared connector renderer is where that
+ * would be fixed; until then an icon promising a ring would be advertising a
+ * shape the tool does not draw.
+ */
+export declare const bpmnMessageIcon: import("lit-html").TemplateResult<2>;
+/**
+ * Association — a dashed line with no head at either end.
+ *
+ * Same weight as the message flow's line, because on canvas it IS the same
+ * weight: both are `strokeWidth: 2`. A thinner icon would hint at a distinction
+ * the tool cannot draw (`ASSOCIATION_WIDTH` in `../consts.ts` says why).
+ */
+export declare const bpmnAssociationIcon: import("lit-html").TemplateResult<2>;
 /** Pool — rectangle with a left name band. */
 export declare const bpmnPoolIcon: import("lit-html").TemplateResult<2>;
+/** Add lane — the pool, cut in two, with a plus on the new band. */
+export declare const bpmnLaneAddIcon: import("lit-html").TemplateResult<2>;
+/** Remove lane — the same pool, with a minus on the band that goes. */
+export declare const bpmnLaneRemoveIcon: import("lit-html").TemplateResult<2>;

package/dist/toolbar/icons.js

@@ -7,6 +7,37 @@ export const bpmnToolbarIcon = svg `<svg width="100%" height="100%" viewBox="0 0
   <line x1="11" y1="13" x2="11" y2="43" stroke="#262626" stroke-width="1.8"/>
   <rect x="20" y="20" width="24" height="16" rx="3.5" fill="#ffffff" stroke="#262626" stroke-width="2.2"/>
 </svg>`;
+/** Export BPMN XML — a document with an arrow leaving it. */
+export const bpmnExportXmlIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M13.5 3.5H7a1.5 1.5 0 0 0-1.5 1.5v14A1.5 1.5 0 0 0 7 20.5h3" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/>
+  <path d="M13.5 3.5 18.5 8.5V12" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M16 20.5v-6M13.5 18l2.5 2.5 2.5-2.5" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>`;
+/**
+ * Import BPMN XML — the export's document, with the arrow coming back IN.
+ *
+ * Deliberately the same page and the same arrow, mirrored: the two commands are
+ * one subject in two directions, and a reader who has met one should recognise
+ * the other without reading its label.
+ */
+export const bpmnImportXmlIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M13.5 3.5H7a1.5 1.5 0 0 0-1.5 1.5v14A1.5 1.5 0 0 0 7 20.5h3" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/>
+  <path d="M13.5 3.5 18.5 8.5V12" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M16 14.5v6M13.5 17l2.5-2.5 2.5 2.5" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>`;
+/**
+ * Import an SVG sketch — the import page again, with the picture frame that
+ * says "this arrives as a drawing" rather than as a process.
+ *
+ * Kept a sibling of {@link bpmnImportXmlIcon} on purpose: they are the same
+ * gesture (a file becomes a board) and the difference between them is the TIER,
+ * which is what the mountain-in-a-frame glyph is for.
+ */
+export const bpmnImportSvgIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3" y="5" width="14" height="11" rx="1.5" stroke="currentColor" stroke-width="1.5"/>
+  <path d="M3.5 13 7 9.5l3 3 2-2 3.5 3.5" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M19 14.5v6M16.5 17l2.5-2.5 2.5 2.5" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>`;
 /** Start event — thin green ring. */
 export const bpmnStartIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <circle cx="12" cy="12" r="8" stroke="#43a06b" stroke-width="2"/>
@@ -15,22 +46,132 @@ export const bpmnStartIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24
 export const bpmnEndIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <circle cx="12" cy="12" r="8" stroke="#cf5648" stroke-width="3.5"/>
 </svg>`;
+/** Message start event — thin green ring, envelope inside. */
+export const bpmnStartMessageIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="12" cy="12" r="8" stroke="#43a06b" stroke-width="2"/>
+  <rect x="8" y="9.5" width="8" height="5.5" stroke="currentColor" stroke-width="1.1"/>
+  <path d="M8 9.5 L12 13 L16 9.5" stroke="currentColor" stroke-width="1.1" stroke-linejoin="round"/>
+</svg>`;
+/** Timer start event — thin green ring, clock inside (rim + two hands). */
+export const bpmnStartTimerIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="12" cy="12" r="8" stroke="#43a06b" stroke-width="2"/>
+  <circle cx="12" cy="12" r="4.2" stroke="currentColor" stroke-width="1.1"/>
+  <path d="M12 12 V8.8 M12 12 L14.2 13.6" stroke="currentColor" stroke-width="1.1" stroke-linecap="round"/>
+</svg>`;
+/** Message end event — thick red ring, envelope inside. */
+export const bpmnEndMessageIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="12" cy="12" r="8" stroke="#cf5648" stroke-width="3.5"/>
+  <rect x="8.5" y="9.8" width="7" height="4.8" stroke="currentColor" stroke-width="1.1"/>
+  <path d="M8.5 9.8 L12 12.8 L15.5 9.8" stroke="currentColor" stroke-width="1.1" stroke-linejoin="round"/>
+</svg>`;
+/** Terminate end event — thick red ring, solid disc inside. */
+export const bpmnEndTerminateIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="12" cy="12" r="8" stroke="#cf5648" stroke-width="3.5"/>
+  <circle cx="12" cy="12" r="3.6" fill="currentColor"/>
+</svg>`;
 /** Task — rounded rectangle. */
 export const bpmnTaskIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <rect x="3.5" y="6.5" width="17" height="11" rx="2.5" stroke="currentColor" stroke-width="1.6"/>
 </svg>`;
+/** User task — the rectangle with a person in its top-left corner. */
+export const bpmnTaskUserIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="6.5" width="17" height="11" rx="2.5" stroke="currentColor" stroke-width="1.6"/>
+  <circle cx="7.4" cy="9.9" r="1.15" stroke="currentColor" stroke-width="1"/>
+  <path d="M5.7 13.3 A1.7 1.7 0 0 1 9.1 13.3" stroke="currentColor" stroke-width="1"/>
+</svg>`;
+/** Service task — the rectangle with a gear in its top-left corner. */
+export const bpmnTaskServiceIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="6.5" width="17" height="11" rx="2.5" stroke="currentColor" stroke-width="1.6"/>
+  <circle cx="7.6" cy="11" r="1.7" stroke="currentColor" stroke-width="1"/>
+  <circle cx="7.6" cy="11" r="0.5" stroke="currentColor" stroke-width="0.8"/>
+  <path d="M7.6 8.9 V9.3 M7.6 12.7 V13.1 M5.5 11 H5.9 M9.3 11 H9.7 M6.1 9.5 L6.4 9.8 M8.8 12.2 L9.1 12.5 M9.1 9.5 L8.8 9.8 M6.4 12.2 L6.1 12.5" stroke="currentColor" stroke-width="1" stroke-linecap="round"/>
+</svg>`;
+/** Sub-process — the rectangle with the collapsed [+] marker on its bottom edge. */
+export const bpmnSubProcessIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="6.5" width="17" height="11" rx="2.5" stroke="currentColor" stroke-width="1.6"/>
+  <rect x="9.6" y="12.6" width="4.8" height="4.8" stroke="currentColor" stroke-width="1.1"/>
+  <path d="M12 13.8 V16.2 M10.8 15 H13.2" stroke="currentColor" stroke-width="1.1" stroke-linecap="round"/>
+</svg>`;
+/** Call activity — the same [+] marker, on the notation's THICKEST border. */
+export const bpmnCallActivityIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="4" y="7" width="16" height="10" rx="2.5" stroke="currentColor" stroke-width="3"/>
+  <rect x="9.6" y="12.2" width="4.8" height="4.8" stroke="currentColor" stroke-width="1.1"/>
+  <path d="M12 13.4 V15.8 M10.8 14.6 H13.2" stroke="currentColor" stroke-width="1.1" stroke-linecap="round"/>
+</svg>`;
 /** Exclusive gateway — diamond with an X. */
 export const bpmnGatewayIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <path d="M12 3 L21 12 L12 21 L3 12 Z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>
   <path d="M9 9 L15 15 M15 9 L9 15" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
 </svg>`;
+/** Parallel gateway — diamond with a +. */
+export const bpmnGatewayParallelIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M12 3 L21 12 L12 21 L3 12 Z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>
+  <path d="M12 8 V16 M8 12 H16" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>`;
+/** Data object — a page with its top-right corner turned down. */
+export const bpmnDataObjectIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M6 3.5 H14 L18 7.5 V20.5 H6 Z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>
+  <path d="M14 3.5 V7.5 H18" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/>
+</svg>`;
+/** Data store — a cylinder. */
+export const bpmnDataStoreIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M4.5 7 V17 C4.5 18.4 8 19.5 12 19.5 C16 19.5 19.5 18.4 19.5 17 V7" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>
+  <ellipse cx="12" cy="7" rx="7.5" ry="2.5" stroke="currentColor" stroke-width="1.6"/>
+</svg>`;
+/** Text annotation — an open bracket down the leading edge, and a note beside it. */
+export const bpmnTextAnnotationIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M9 5 H5.5 V19 H9" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M11.5 9 H18.5 M11.5 12 H18.5 M11.5 15 H16" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"/>
+</svg>`;
 /** Sequence flow — solid arrow with a filled head. */
 export const bpmnSequenceIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <path d="M3 12 H17" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/>
   <path d="M15 8 L21 12 L15 16 Z" fill="currentColor"/>
 </svg>`;
+/** Group — a dashed, generously rounded rectangle drawn AROUND things. */
+export const bpmnGroupIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="5.5" width="17" height="13" rx="4" stroke="currentColor" stroke-width="1.6" stroke-dasharray="3.4 2.6"/>
+</svg>`;
+/**
+ * Message flow — dashed line, disc at the source, open head at the target.
+ *
+ * The source terminator is drawn FILLED because that is what the canvas paints:
+ * `renderCircle` fills with the connector's `fillColor` before stroking it. The
+ * norm asks for a hollow ring, and the shared connector renderer is where that
+ * would be fixed; until then an icon promising a ring would be advertising a
+ * shape the tool does not draw.
+ */
+export const bpmnMessageIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="4.8" cy="12" r="2.2" fill="currentColor"/>
+  <path d="M7.4 12 H17.5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-dasharray="3 2.6"/>
+  <path d="M15.6 8.6 L20 12 L15.6 15.4" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>`;
+/**
+ * Association — a dashed line with no head at either end.
+ *
+ * Same weight as the message flow's line, because on canvas it IS the same
+ * weight: both are `strokeWidth: 2`. A thinner icon would hint at a distinction
+ * the tool cannot draw (`ASSOCIATION_WIDTH` in `../consts.ts` says why).
+ */
+export const bpmnAssociationIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M3.5 17 L20.5 7" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-dasharray="2.4 2.4"/>
+</svg>`;
 /** Pool — rectangle with a left name band. */
 export const bpmnPoolIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <rect x="3.5" y="5.5" width="17" height="13" rx="1.5" stroke="currentColor" stroke-width="1.6"/>
   <path d="M8 5.5 V18.5" stroke="currentColor" stroke-width="1.6"/>
 </svg>`;
+/** Add lane — the pool, cut in two, with a plus on the new band. */
+export const bpmnLaneAddIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="5.5" width="17" height="13" rx="1.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 5.5 V18.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 12 H20.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M14.25 13.25 V17 M12.4 15.1 H16.1" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>`;
+/** Remove lane — the same pool, with a minus on the band that goes. */
+export const bpmnLaneRemoveIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3.5" y="5.5" width="17" height="13" rx="1.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 5.5 V18.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 12 H20.5" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M12.4 15.1 H16.1" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>`;

package/dist/toolbar/senior-tool.js

@@ -3,6 +3,7 @@ import { html } from 'lit';
 export const bpmnSeniorTool = SeniorToolExtension('bpmn', ({ block }) => {
     return {
         name: 'BPMN',
+        labelKey: 'com.labre.framework.bpmn',
         content: html `<edgeless-bpmn-senior-button
       .edgeless=${block}
     ></edgeless-bpmn-senior-button>`,

package/dist/translations.d.ts

@@ -0,0 +1,16 @@
+import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key BPMN can hand to `TranslationProvider.t`, derived from the
+ * very declarations the editor registers (never restated).
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-bpmn` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `bpmnCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export declare const bpmnTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,20 @@
+import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
+import { bpmnCommands } from './commands.js';
+import { BPMN_PROFILES } from './profiles.js';
+import { BPMN_ROLES } from './roles.js';
+import { BPMN_RULES } from './rules.js';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key BPMN can hand to `TranslationProvider.t`, derived from the
+ * very declarations the editor registers (never restated).
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-bpmn` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `bpmnCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export const bpmnTranslationEntries = mergeTranslationEntries(commandTranslationEntries(bpmnCommands), collectTranslationKeys('role', BPMN_ROLES), collectTranslationKeys('rule', BPMN_RULES), collectTranslationKeys('profile', BPMN_PROFILES));

package/dist/view.d.ts

@@ -1,4 +1,22 @@
 import { type ViewExtensionContext, ViewExtensionProvider } from '@formicoidea/labre-core/ext-loader';
+/**
+ * BPMN rendering — ALWAYS registered, independent of any flag. Disabling `bpmn`
+ * hides only the creation tooling (see {@link BpmnViewExtension}); pools and
+ * nodes already drawn must still paint, stay selectable, stay editable and keep
+ * their contextual toolbar. See `docs/adr/0009`.
+ */
+export declare class BpmnRenderViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}
+/**
+ * BPMN creation tooling — flag-gated (`bpmn`): the senior toolbar button, its
+ * templates category, the validation rules and profiles, and the interchange
+ * capabilities. All of it is tooling: a process drawn while the flag was on
+ * keeps rendering when it goes off, it just stops being checked — the profile
+ * its pool was put on stays written, unread, until the flag comes back, and so
+ * does anything an import wrote (`docs/adr/0009`, `docs/adr/0012`).
+ */
 export declare class BpmnViewExtension extends ViewExtensionProvider {
     name: string;
     effect(): void;

package/dist/view.js

@@ -1,13 +1,64 @@
+import { FrameworkBackgroundInteractionExtension, InterchangeExtension, morphToolbarConfig, ValidationProfileExtension, ValidationRuleExtension, validationToolbarConfig, } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
 import { extendTemplateCategory } from '@formicoidea/labre-core/gfx/template';
+import { ToolbarModuleExtension } from '@formicoidea/labre-core/shared/services';
+import { BlockFlavourIdentifier, CommandExtension } from '@formicoidea/labre-core/std';
+import { RoleVocabularyExtension } from '@formicoidea/labre-core/std/gfx';
+import { BPMN_POOL_BACKGROUND } from './background.js';
+import { bpmnCommandIcons, bpmnCommands } from './commands.js';
 import { effects } from './effects.js';
+import { BPMN_INTERCHANGE } from './interchange.js';
+import { BPMN_MORPH_SPEC } from './morph.js';
+import { BPMN_PROFILES } from './profiles.js';
+import { BPMN_ROLES } from './roles.js';
+import { BPMN_RULES } from './rules.js';
 import { bpmnTemplateCategory } from './templates/index.js';
 import { BpmnPoolRendererExtension } from './element-renderer.js';
-import { BpmnPoolInteraction, BpmnPoolView } from './element-view.js';
+import { BpmnPoolView } from './element-view.js';
 import { BpmnNodeRendererExtension } from './node/node-renderer.js';
 import { BpmnNodeView } from './node/node-view.js';
 import { bpmnPoolToolbarExtension } from './toolbar/config.js';
 import { bpmnSeniorTool } from './toolbar/senior-tool.js';
+/**
+ * BPMN rendering — ALWAYS registered, independent of any flag. Disabling `bpmn`
+ * hides only the creation tooling (see {@link BpmnViewExtension}); pools and
+ * nodes already drawn must still paint, stay selectable, stay editable and keep
+ * their contextual toolbar. See `docs/adr/0009`.
+ */
+export class BpmnRenderViewExtension extends ViewExtensionProvider {
+    constructor() {
+        super(...arguments);
+        this.name = 'affine-bpmn-render-gfx';
+    }
+    setup(context) {
+        super.setup(context);
+        context.register(BpmnPoolView);
+        context.register(BpmnPoolRendererExtension);
+        context.register(BpmnNodeView);
+        context.register(BpmnNodeRendererExtension);
+        // The role VOCABULARY, always on. A role is written in the document, not in
+        // the tooling: the direction reveal of the sequence flow, the inversion
+        // command and the toolbar entry that must not lie about a typed edge all
+        // read this, and they have to keep working on a process drawn while the flag
+        // was on and opened while it is off (`docs/adr/0009`, `docs/adr/0010`).
+        context.register(RoleVocabularyExtension(BPMN_ROLES));
+        if (this.isEdgeless(context.scope)) {
+            // Resize gating, driven by the declaration like every other framework
+            // background: the handles stay hidden until `resizeEnabled` says
+            // otherwise, and the toolbar toggle is what writes it.
+            context.register(FrameworkBackgroundInteractionExtension(BPMN_POOL_BACKGROUND));
+            context.register(bpmnPoolToolbarExtension);
+        }
+    }
+}
+/**
+ * BPMN creation tooling — flag-gated (`bpmn`): the senior toolbar button, its
+ * templates category, the validation rules and profiles, and the interchange
+ * capabilities. All of it is tooling: a process drawn while the flag was on
+ * keeps rendering when it goes off, it just stops being checked — the profile
+ * its pool was put on stays written, unread, until the flag comes back, and so
+ * does anything an import wrote (`docs/adr/0009`, `docs/adr/0012`).
+ */
 export class BpmnViewExtension extends ViewExtensionProvider {
     constructor() {
         super(...arguments);
@@ -15,19 +66,56 @@ export class BpmnViewExtension extends ViewExtensionProvider {
     }
     effect() {
         super.effect();
+        // Defines the senior button and its menu — tooling-only custom elements.
         effects();
         extendTemplateCategory(bpmnTemplateCategory);
     }
     setup(context) {
         super.setup(context);
-        context.register(BpmnPoolView);
-        context.register(BpmnPoolRendererExtension);
-        context.register(BpmnNodeView);
-        context.register(BpmnNodeRendererExtension);
         if (this.isEdgeless(context.scope)) {
-            context.register(BpmnPoolInteraction);
+            context.register(ValidationRuleExtension(BPMN_RULES));
+            context.register(ValidationProfileExtension(BPMN_PROFILES));
+            // Reading and writing `.bpmn` files, declared rather than assumed
+            // (`docs/adr/0012`). Tooling like the rest of this class: with the flag
+            // off there is nothing to export WITH, while a board a past import wrote
+            // keeps every element and every byte it was given (`docs/adr/0009`).
+            context.register(InterchangeExtension(BPMN_INTERCHANGE));
+            // The Validation dropdown on a selected pool's contextual toolbar. A
+            // SECOND module on the same element, through the `custom:` flavour slot,
+            // exactly as wardley and the context map register it on theirs:
+            // `bpmnPoolToolbarExtension` is registered always-on because a stored pool
+            // must keep its lanes and its resize toggle, while choosing how hard to
+            // check the process is tooling and belongs here. The config names no
+            // framework — it reads roles and profiles — so it is the very same object
+            // the other two register.
+            context.register(ToolbarModuleExtension({
+                id: BlockFlavourIdentifier('custom:affine:surface:bpmnPool'),
+                config: validationToolbarConfig,
+            }));
+            // The "Change type" dropdown on a selected NODE's contextual toolbar —
+            // the generic module, parameterized by BPMN's own families table.
+            //
+            // `affine:surface:bpmnNode` is a FREE slot, and class inheritance has
+            // nothing to do with it: `renderToolbar` merges by flavour KEY — the
+            // element's own, its `custom:` twin and the `affine:surface:*` wildcards
+            // — so `shapeToolbarExtension`, which binds `affine:surface:shape`, never
+            // reaches a bpmn node however much of `ShapeElementModel` the class
+            // inherits. Nothing claimed this key before, so the registration is purely
+            // additive: it joins the wildcard entries (tags, validation) that a node
+            // already gets, and a second module claiming the same key would throw
+            // `DuplicateServiceDefinitionError` before the editor finished setting up.
+            //
+            // Registered HERE, in the flag-gated half, because a morph is TOOLING: a
+            // node drawn while the flag was on keeps its kind, its role, its glyph
+            // and its place in every rule when the flag goes off — it just stops
+            // being something the toolbar offers to say more precisely
+            // (`docs/adr/0009`).
+            context.register(ToolbarModuleExtension({
+                id: BlockFlavourIdentifier('affine:surface:bpmnNode'),
+                config: morphToolbarConfig(BPMN_MORPH_SPEC),
+            }));
             context.register(bpmnSeniorTool);
-            context.register(bpmnPoolToolbarExtension);
+            context.register(CommandExtension(bpmnCommands, bpmnCommandIcons));
         }
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-bpmn",
   "description": "Labre bpmn framework for @formicoidea/labre-core.",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -27,7 +27,7 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.31.0",
+    "@formicoidea/labre-core": "0.33.0",
     "lit": "^3.2.0"
   }
 }