@formicoidea/labre-framework-c4 0.49.0 → 0.51.0

package/dist/interchange-headless.d.ts

@@ -0,0 +1,37 @@
+import type { InterchangeFormat } from '@formicoidea/labre-core/interchange';
+/**
+ * `@labre/affine-gfx-c4/interchange` — C4's format declaration, with no editor
+ * behind it (ADR 0012, P3 as amended 2026-10-14).
+ *
+ * C4 has one capability, mermaid OUT, and it is not here: the writer reads
+ * live element models (`c4BoardFrom` by `instanceof`, `roleIsA`), which is the
+ * editor graph this entry exists to leave out. What a host without an editor
+ * can still use is the declaration — which extension, which media type, which
+ * file name — to route or name a file. `interchange.ts` re-exports all of it.
+ *
+ * Held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+/**
+ * mermaid C4 source. **Semantic** — the file carries a model, not a picture, so
+ * it takes the whole preservation contract the day an importer is written.
+ *
+ * `.mmd` is the extension the mermaid CLI and every editor plugin watch for.
+ * The format carries no `mime`, where `BPMN_XML_FORMAT` carries
+ * `application/xml`, and the difference is the truth rather than an oversight:
+ * mermaid has no registered media type, so there is none to declare. What a
+ * DOWNLOAD is served as is a different question with an answer — `text/plain`,
+ * because an invented type is a file some browsers refuse to save — and that
+ * answer is stated on the export result, where it belongs.
+ *
+ * The charset rides along with it because the text is the whole payload: unlike
+ * XML, a mermaid file has no prolog to declare its own encoding in.
+ */
+export declare const C4_MERMAID_EXTENSION = ".mmd";
+export declare const C4_MERMAID_MIME = "text/plain;charset=utf-8";
+export declare const C4_MERMAID_FORMAT: InterchangeFormat;
+/**
+ * A name a file system will accept, minus the extension: the shared
+ * `safeFilename` with C4's fallback, `diagram`. Held to it by
+ * `safe-filename-parity.unit.spec.ts`.
+ */
+export declare function c4SafeFilename(raw: string | undefined): string;

package/dist/interchange-headless.js

@@ -0,0 +1,43 @@
+import { safeFilename } from '@formicoidea/labre-core/shared/headless';
+/**
+ * `@labre/affine-gfx-c4/interchange` — C4's format declaration, with no editor
+ * behind it (ADR 0012, P3 as amended 2026-10-14).
+ *
+ * C4 has one capability, mermaid OUT, and it is not here: the writer reads
+ * live element models (`c4BoardFrom` by `instanceof`, `roleIsA`), which is the
+ * editor graph this entry exists to leave out. What a host without an editor
+ * can still use is the declaration — which extension, which media type, which
+ * file name — to route or name a file. `interchange.ts` re-exports all of it.
+ *
+ * Held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+/**
+ * mermaid C4 source. **Semantic** — the file carries a model, not a picture, so
+ * it takes the whole preservation contract the day an importer is written.
+ *
+ * `.mmd` is the extension the mermaid CLI and every editor plugin watch for.
+ * The format carries no `mime`, where `BPMN_XML_FORMAT` carries
+ * `application/xml`, and the difference is the truth rather than an oversight:
+ * mermaid has no registered media type, so there is none to declare. What a
+ * DOWNLOAD is served as is a different question with an answer — `text/plain`,
+ * because an invented type is a file some browsers refuse to save — and that
+ * answer is stated on the export result, where it belongs.
+ *
+ * The charset rides along with it because the text is the whole payload: unlike
+ * XML, a mermaid file has no prolog to declare its own encoding in.
+ */
+export const C4_MERMAID_EXTENSION = '.mmd';
+export const C4_MERMAID_MIME = 'text/plain;charset=utf-8';
+export const C4_MERMAID_FORMAT = {
+    id: 'mermaid',
+    tier: 'semantic',
+    extensions: [C4_MERMAID_EXTENSION],
+};
+/**
+ * A name a file system will accept, minus the extension: the shared
+ * `safeFilename` with C4's fallback, `diagram`. Held to it by
+ * `safe-filename-parity.unit.spec.ts`.
+ */
+export function c4SafeFilename(raw) {
+    return safeFilename(raw, 'diagram');
+}

package/dist/interchange.d.ts

@@ -1,6 +1,7 @@
-import type { InterchangeCapability, InterchangeExportCapability, InterchangeFormat } from '@formicoidea/labre-core/blocks/surface';
+import type { InterchangeCapability, InterchangeExportCapability } from '@formicoidea/labre-core/blocks/surface';
 import type { GfxPrimitiveElementModel } from '@formicoidea/labre-core/std/gfx';
 import { type C4ExportBoard } from './export.js';
+export { C4_MERMAID_EXTENSION, C4_MERMAID_FORMAT, C4_MERMAID_MIME, c4SafeFilename, } from './interchange-headless.js';
 /**
  * C4's entries in the interchange registry (`docs/adr/0012`, P1).
  *
@@ -21,24 +22,6 @@ import { type C4ExportBoard } from './export.js';
  * that hands over the whole surface gets every board, one document each, which
  * is the honest whole-surface answer for this framework.
  */
-/**
- * mermaid C4 source. **Semantic** — the file carries a model, not a picture, so
- * it takes the whole preservation contract the day an importer is written.
- *
- * `.mmd` is the extension the mermaid CLI and every editor plugin watch for.
- * The format carries no `mime`, where `BPMN_XML_FORMAT` carries
- * `application/xml`, and the difference is the truth rather than an oversight:
- * mermaid has no registered media type, so there is none to declare. What a
- * DOWNLOAD is served as is a different question with an answer — `text/plain`,
- * because an invented type is a file some browsers refuse to save — and that
- * answer is stated on the export result, where it belongs.
- *
- * The charset rides along with it because the text is the whole payload: unlike
- * XML, a mermaid file has no prolog to declare its own encoding in.
- */
-export declare const C4_MERMAID_EXTENSION = ".mmd";
-export declare const C4_MERMAID_MIME = "text/plain;charset=utf-8";
-export declare const C4_MERMAID_FORMAT: InterchangeFormat;
 /**
  * The artefacts the exporter speaks about, picked out of a list of elements and
  * kept in the order they were given.
@@ -57,12 +40,6 @@ export declare const C4_MERMAID_FORMAT: InterchangeFormat;
  * user can see.
  */
 export declare function c4BoardFrom(elements: readonly GfxPrimitiveElementModel[]): C4ExportBoard;
-/**
- * A name a file system will accept, minus the extension: the shared
- * `safeFilename` with C4's fallback, `diagram`. Held to it by
- * `safe-filename-parity.unit.spec.ts`.
- */
-export declare function c4SafeFilename(raw: string | undefined): string;
 /** `c4:mermaid:export` — C4's first capability. */
 export declare const C4_MERMAID_EXPORT: InterchangeExportCapability;
 /** Everything C4 registers, in one list the view extension can hand over. */

package/dist/interchange.js

@@ -1,7 +1,8 @@
 import { interchangeCapabilityId } from '@formicoidea/labre-core/blocks/surface';
 import { C4BoardElementModel, C4BoundaryElementModel, C4NodeElementModel, ConnectorElementModel, GroupElementModel, TextElementModel, } from '@formicoidea/labre-core/model';
-import { safeFilename } from '@formicoidea/labre-core/shared/utils';
 import { exportC4Mermaid } from './export.js';
+import { C4_MERMAID_EXTENSION, C4_MERMAID_FORMAT, C4_MERMAID_MIME, c4SafeFilename, } from './interchange-headless.js';
+export { C4_MERMAID_EXTENSION, C4_MERMAID_FORMAT, C4_MERMAID_MIME, c4SafeFilename, } from './interchange-headless.js';
 /**
  * C4's entries in the interchange registry (`docs/adr/0012`, P1).
  *
@@ -22,29 +23,6 @@ import { exportC4Mermaid } from './export.js';
  * that hands over the whole surface gets every board, one document each, which
  * is the honest whole-surface answer for this framework.
  */
-/* ── The format ───────────────────────────────────────────────────────── */
-/**
- * mermaid C4 source. **Semantic** — the file carries a model, not a picture, so
- * it takes the whole preservation contract the day an importer is written.
- *
- * `.mmd` is the extension the mermaid CLI and every editor plugin watch for.
- * The format carries no `mime`, where `BPMN_XML_FORMAT` carries
- * `application/xml`, and the difference is the truth rather than an oversight:
- * mermaid has no registered media type, so there is none to declare. What a
- * DOWNLOAD is served as is a different question with an answer — `text/plain`,
- * because an invented type is a file some browsers refuse to save — and that
- * answer is stated on the export result, where it belongs.
- *
- * The charset rides along with it because the text is the whole payload: unlike
- * XML, a mermaid file has no prolog to declare its own encoding in.
- */
-export const C4_MERMAID_EXTENSION = '.mmd';
-export const C4_MERMAID_MIME = 'text/plain;charset=utf-8';
-export const C4_MERMAID_FORMAT = {
-    id: 'mermaid',
-    tier: 'semantic',
-    extensions: [C4_MERMAID_EXTENSION],
-};
 /* ── Pure board helpers ───────────────────────────────────────────────── */
 /**
  * The artefacts the exporter speaks about, picked out of a list of elements and
@@ -86,14 +64,6 @@ export function c4BoardFrom(elements) {
     }
     return { boards, nodes, boundaries, connectors, texts, groups };
 }
-/**
- * A name a file system will accept, minus the extension: the shared
- * `safeFilename` with C4's fallback, `diagram`. Held to it by
- * `safe-filename-parity.unit.spec.ts`.
- */
-export function c4SafeFilename(raw) {
-    return safeFilename(raw, 'diagram');
-}
 /* ── The capability ───────────────────────────────────────────────────── */
 /**
  * The board as a mermaid C4 document.

package/dist/view.js

@@ -98,6 +98,13 @@ export class C4ViewExtension extends ViewExtensionProvider {
     }
     setup(context) {
         super.setup(context);
+        // C4's page of the colour pickers' carousel (`docs/adr/0027`). Here,
+        // in the flag-gated extension, because offering hues is TOOLING — the colours
+        // already painted on a stored diagram are content and do not move
+        // (`docs/adr/0009`).
+        // Both scopes, not the canvas alone: the database colour grid offers
+        // this page in a page too, softened (ADR 0036 amendment of 2026-10-14).
+        context.register(FrameworkPaletteExtension(C4_FRAMEWORK_PALETTE));
         if (this.isEdgeless(context.scope)) {
             context.register(ValidationRuleExtension(C4_RULES));
             context.register(ValidationProfileExtension(C4_PROFILES));
@@ -114,11 +121,6 @@ export class C4ViewExtension extends ViewExtensionProvider {
                 context.register(ReadingProfileExtension(reading));
             }
             context.register(c4SeniorTool);
-            // C4's page of the colour pickers' carousel (`docs/adr/0027`). Here,
-            // beside the senior tool, because offering hues is TOOLING — the colours
-            // already painted on a stored diagram are content and do not move
-            // (`docs/adr/0009`).
-            context.register(FrameworkPaletteExtension(C4_FRAMEWORK_PALETTE));
             // The Templates-panel category — tooling, so it goes with the flag (#244).
             context.register(TemplateCategoryExtension(c4TemplateCategory));
             context.register(CommandExtension(c4Commands, c4CommandIcons));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-c4",
   "description": "Labre c4 framework for @formicoidea/labre-core.",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -25,14 +25,18 @@
     "./commands-manifest": {
       "types": "./dist/commands-manifest.d.ts",
       "import": "./dist/commands-manifest.js"
+    },
+    "./interchange": {
+      "types": "./dist/interchange-headless.d.ts",
+      "import": "./dist/interchange-headless.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.49.0",
-    "@formicoidea/labre-ddd-shared": "0.49.0",
+    "@formicoidea/labre-core": "0.51.0",
+    "@formicoidea/labre-ddd-shared": "0.51.0",
     "lit": "^3.2.0"
   }
 }