@formicoidea/labre-framework-cynefin 0.59.0 → 0.60.0

package/dist/actions.js

@@ -1,7 +1,8 @@
 import { DefaultTool } from '@formicoidea/labre-core/blocks/surface';
-import { Bound } from '@formicoidea/labre-core/global/gfx';
 import { GfxControllerIdentifier } from '@formicoidea/labre-core/std/gfx';
-import { CYNEFIN_H, CYNEFIN_W, cynefinBackgroundProps, ESTUARINE_MAP_H, ESTUARINE_MAP_W, estuarineHexagonBox, estuarineHexagonProps, estuarineMapProps, } from './presets.js';
+import { HEX_SIZE } from './estuarine/consts.js';
+import { CYNEFIN_H, CYNEFIN_W, ESTUARINE_MAP_H, ESTUARINE_MAP_W, } from './presets.js';
+import { constraintHexagonElement, cynefinElement, estuarineMapElement, } from './toolbox.js';
 /**
  * Creation actions for the Cynefin / Estuarine toolbox — lifted out of
  * `toolbar/menu.ts` by PF3. This is also the framework that emitted NO
@@ -9,7 +10,10 @@ import { CYNEFIN_H, CYNEFIN_W, cynefinBackgroundProps, ESTUARINE_MAP_H, ESTUARIN
  * `runCommand` fixes that for free (`docs/adr/0008`).
  *
  * What each artefact IS lives in `presets.ts`, which the palette reads too: the
- * templates used to restate these props and drifted from them.
+ * templates used to restate these props and drifted from them. What the
+ * toolbar places comes from the ONE assembly a host with no editor also calls
+ * (`toolbox.ts`, `docs/adr/0045`); only the viewport centre and the selection
+ * stay here.
  */
 const gfxOf = (std) => std.get(GfxControllerIdentifier);
 function finish(gfx, id) {
@@ -17,32 +21,28 @@ function finish(gfx, id) {
     gfx.tool.setTool(DefaultTool);
     gfx.selection.set({ elements: [id], editing: false });
 }
-/** The box an artefact of the given size is born in, centred on the viewport. */
+/** The top-left an artefact of the given size is born at, centred on the viewport. */
 function centered(gfx, width, height) {
     const { centerX, centerY } = gfx.viewport;
-    return new Bound(centerX - width / 2, centerY - height / 2, width, height).serialize();
+    return { x: centerX - width / 2, y: centerY - height / 2 };
+}
+/** Write one built element; the builder's local id is the editor's to mint. */
+function place(gfx, element) {
+    const surface = gfx.surface;
+    if (!surface)
+        return;
+    const { id: _local, ...props } = element;
+    finish(gfx, surface.addElement(props));
 }
 export function createCynefin(std) {
     const gfx = gfxOf(std);
-    if (!gfx.surface)
-        return;
-    const id = gfx.surface.addElement(cynefinBackgroundProps({ xywh: centered(gfx, CYNEFIN_W, CYNEFIN_H) }));
-    finish(gfx, id);
+    place(gfx, cynefinElement(centered(gfx, CYNEFIN_W, CYNEFIN_H)));
 }
 export function createEstuarineMap(std) {
     const gfx = gfxOf(std);
-    if (!gfx.surface)
-        return;
-    const id = gfx.surface.addElement(estuarineMapProps({
-        xywh: centered(gfx, ESTUARINE_MAP_W, ESTUARINE_MAP_H),
-    }));
-    finish(gfx, id);
+    place(gfx, estuarineMapElement(centered(gfx, ESTUARINE_MAP_W, ESTUARINE_MAP_H)));
 }
 export function createConstraintHexagon(std) {
     const gfx = gfxOf(std);
-    if (!gfx.surface)
-        return;
-    const { centerX, centerY } = gfx.viewport;
-    const id = gfx.surface.addElement(estuarineHexagonProps({ xywh: estuarineHexagonBox(centerX, centerY) }));
-    finish(gfx, id);
+    place(gfx, constraintHexagonElement(centered(gfx, HEX_SIZE, HEX_SIZE)));
 }

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './comma
 export { cynefinEstuarineTranslationEntries } from './translations.js';
 export { ESTUARINE_ROLE, ESTUARINE_ROLES, type EstuarineRoleId, } from './estuarine/roles.js';
 export { ESTUARINE_READING } from './estuarine/reading.js';
+export { constraintHexagonElement, CYNEFIN_ESTUARINE_TOOLBOX, cynefinElement, estuarineMapElement, } from './toolbox.js';

package/dist/index.js

@@ -5,3 +5,5 @@ export { cynefinEstuarineTranslationEntries } from './translations.js';
 // Cynefin contributes neither, having no role of its own (ADR 0013).
 export { ESTUARINE_ROLE, ESTUARINE_ROLES, } from './estuarine/roles.js';
 export { ESTUARINE_READING } from './estuarine/reading.js';
+// The toolbar as pure builders (`docs/adr/0045`), also on `./interchange`.
+export { constraintHexagonElement, CYNEFIN_ESTUARINE_TOOLBOX, cynefinElement, estuarineMapElement, } from './toolbox.js';

package/dist/interchange-headless.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@labre/affine-gfx-cynefin-estuarine/interchange` — Cynefin and estuarine
+ * mapping with no editor behind them.
+ *
+ * The framework declares no file format. What a host without an editor uses
+ * is its toolbar as pure builders (`docs/adr/0045`): the elements a user
+ * places from the toolbar, for a server or an MCP tool to place the same ones.
+ *
+ * Held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+export { constraintHexagonElement, CYNEFIN_ESTUARINE_TOOLBOX, cynefinElement, estuarineMapElement, } from './toolbox.js';

package/dist/interchange-headless.js

@@ -0,0 +1,11 @@
+/**
+ * `@labre/affine-gfx-cynefin-estuarine/interchange` — Cynefin and estuarine
+ * mapping with no editor behind them.
+ *
+ * The framework declares no file format. What a host without an editor uses
+ * is its toolbar as pure builders (`docs/adr/0045`): the elements a user
+ * places from the toolbar, for a server or an MCP tool to place the same ones.
+ *
+ * Held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+export { constraintHexagonElement, CYNEFIN_ESTUARINE_TOOLBOX, cynefinElement, estuarineMapElement, } from './toolbox.js';

package/dist/presets.js

@@ -1,4 +1,7 @@
-import { ShapeStyle, TextFitMode } from '@formicoidea/labre-core/model';
+// Values from the headless entry, never the model index: the toolbox
+// (`toolbox.ts`, `docs/adr/0045`) builds on these presets from the
+// editor-free `./interchange` entry.
+import { ShapeStyle, TextFitMode } from '@formicoidea/labre-core/model/headless';
 import { REF_H as CYN_H, REF_W as CYN_W } from './cynefin/consts.js';
 import { HEX_FILL, HEX_SIZE, HEX_STROKE, HEX_VERTICES, REF_H as EST_H, REF_W as EST_W, } from './estuarine/consts.js';
 import { ESTUARINE_ROLE } from './estuarine/roles.js';

package/dist/toolbox.d.ts

@@ -0,0 +1,19 @@
+import type { FrameworkToolbox, SerializedElementProps, ToolboxPoint } from '@formicoidea/labre-core/interchange';
+/**
+ * The Cynefin and estuarine toolbar as pure builders (`docs/adr/0045`): what
+ * `createCynefin`, `createEstuarineMap` and `createConstraintHexagon` place,
+ * with no editor behind them. The actions call these, so an element built
+ * here and one placed from the toolbar are the same element. The framework
+ * has no relation style: there is no link.
+ */
+/** The Cynefin framework background at `at`, its top-left. */
+export declare function cynefinElement(at: ToolboxPoint, local?: string): SerializedElementProps;
+/** The estuarine map background at `at`, its top-left. */
+export declare function estuarineMapElement(at: ToolboxPoint, local?: string): SerializedElementProps;
+/**
+ * A constraint hexagon at `at`, its top-left. The toolbar places it empty; a
+ * `name` is written as the shape's own inner text, where a user types it.
+ */
+export declare function constraintHexagonElement(at: ToolboxPoint, name?: string, local?: string): SerializedElementProps;
+/** Every item of the Cynefin and estuarine toolbar, in the toolbar's order. */
+export declare const CYNEFIN_ESTUARINE_TOOLBOX: FrameworkToolbox;

package/dist/toolbox.js

@@ -0,0 +1,82 @@
+import { Bound } from '@formicoidea/labre-core/global/gfx';
+import { cynefinEstuarineCommandsManifest } from './commands-manifest.js';
+import { HEX_SIZE } from './estuarine/consts.js';
+import { CYNEFIN_H, CYNEFIN_W, cynefinBackgroundProps, ESTUARINE_MAP_H, ESTUARINE_MAP_W, estuarineHexagonProps, estuarineMapProps, } from './presets.js';
+/**
+ * The Cynefin and estuarine toolbar as pure builders (`docs/adr/0045`): what
+ * `createCynefin`, `createEstuarineMap` and `createConstraintHexagon` place,
+ * with no editor behind them. The actions call these, so an element built
+ * here and one placed from the toolbar are the same element. The framework
+ * has no relation style: there is no link.
+ */
+/** The Cynefin framework background at `at`, its top-left. */
+export function cynefinElement(at, local = 'cynefin') {
+    return {
+        ...cynefinBackgroundProps({
+            xywh: new Bound(at.x, at.y, CYNEFIN_W, CYNEFIN_H).serialize(),
+        }),
+        id: local,
+    };
+}
+/** The estuarine map background at `at`, its top-left. */
+export function estuarineMapElement(at, local = 'estuarine-map') {
+    return {
+        ...estuarineMapProps({
+            xywh: new Bound(at.x, at.y, ESTUARINE_MAP_W, ESTUARINE_MAP_H).serialize(),
+        }),
+        id: local,
+    };
+}
+/**
+ * A constraint hexagon at `at`, its top-left. The toolbar places it empty; a
+ * `name` is written as the shape's own inner text, where a user types it.
+ */
+export function constraintHexagonElement(at, name, local = 'constraint-hexagon') {
+    const text = name?.trim();
+    return {
+        ...estuarineHexagonProps({
+            xywh: new Bound(at.x, at.y, HEX_SIZE, HEX_SIZE).serialize(),
+        }),
+        ...(text ? { text } : {}),
+        id: local,
+    };
+}
+/** The toolbar command's label, so a host names an item as the toolbar does. */
+function label(commandId) {
+    const row = cynefinEstuarineCommandsManifest.find(r => r.id === commandId);
+    return {
+        labelKey: row?.labelKey ?? commandId,
+        labelFallback: row?.labelFallback ?? commandId,
+    };
+}
+const items = [
+    {
+        id: 'cynefin',
+        ...label('cynefin-estuarine.addCynefin'),
+        texts: [],
+        size: { w: CYNEFIN_W, h: CYNEFIN_H },
+        build: (at, _texts, local) => [cynefinElement(at, local)],
+    },
+    {
+        id: 'estuarine-map',
+        ...label('cynefin-estuarine.addEstuarineMap'),
+        texts: [],
+        size: { w: ESTUARINE_MAP_W, h: ESTUARINE_MAP_H },
+        build: (at, _texts, local) => [estuarineMapElement(at, local)],
+    },
+    {
+        id: 'constraint-hexagon',
+        ...label('cynefin-estuarine.addConstraintHexagon'),
+        texts: ['name'],
+        size: { w: HEX_SIZE, h: HEX_SIZE },
+        build: (at, texts, local) => [
+            constraintHexagonElement(at, texts?.name, local),
+        ],
+    },
+];
+/** Every item of the Cynefin and estuarine toolbar, in the toolbar's order. */
+export const CYNEFIN_ESTUARINE_TOOLBOX = {
+    framework: 'cynefin-estuarine',
+    items,
+    links: [],
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-cynefin",
   "description": "Labre cynefin-estuarine framework for @formicoidea/labre-core.",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -25,13 +25,17 @@
     "./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.59.0",
+    "@formicoidea/labre-core": "0.60.0",
     "@preact/signals-core": "^1.8.0",
     "lit": "^3.2.0"
   }