@formicoidea/labre-framework-wardley 0.33.0 → 0.34.1

package/dist/commands-manifest.d.ts

@@ -0,0 +1,18 @@
+import type { ShortcutManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * The Wardley commands as SHORTCUT-MANIFEST rows — id, label, chord, scope,
+ * owner — and nothing else.
+ *
+ * DATA ONLY, and that is the whole point (`docs/adr/0008` § Packaging). A
+ * `CommandDescriptor` carries its `run`, so a host settings pane that imports
+ * the package entry to list names and chords drags the entire action graph —
+ * the import/export machinery, the surface and gfx deep paths — into its
+ * chunk. This module has type-only imports, so the published bundle exposes it
+ * as `./commands-manifest`: a few hundred bytes that reference nothing.
+ *
+ * GENERATED-SHAPED, hand-committed: `commands-manifest.unit.spec.ts` asserts
+ * row-for-row equality with `toShortcutManifestEntry` over {@link wardleyCommands},
+ * so this file cannot drift from the commands it projects. Add a command and
+ * the test says exactly what to add here.
+ */
+export declare const wardleyCommandsManifest: ShortcutManifestEntry[];

package/dist/commands-manifest.js

@@ -0,0 +1,146 @@
+/**
+ * The Wardley commands as SHORTCUT-MANIFEST rows — id, label, chord, scope,
+ * owner — and nothing else.
+ *
+ * DATA ONLY, and that is the whole point (`docs/adr/0008` § Packaging). A
+ * `CommandDescriptor` carries its `run`, so a host settings pane that imports
+ * the package entry to list names and chords drags the entire action graph —
+ * the import/export machinery, the surface and gfx deep paths — into its
+ * chunk. This module has type-only imports, so the published bundle exposes it
+ * as `./commands-manifest`: a few hundred bytes that reference nothing.
+ *
+ * GENERATED-SHAPED, hand-committed: `commands-manifest.unit.spec.ts` asserts
+ * row-for-row equality with `toShortcutManifestEntry` over {@link wardleyCommands},
+ * so this file cannot drift from the commands it projects. Add a command and
+ * the test says exactly what to add here.
+ */
+export const wardleyCommandsManifest = [
+    {
+        id: 'wardley.addBackground',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.addBackground',
+        labelFallback: 'Wardley map background',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'b'], other: ['w', 'b'] },
+    },
+    {
+        id: 'wardley.addOpportunityBackground',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addOpportunityBackground',
+        labelFallback: 'Opportunity background (gradient)',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addBenefitBackground',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addBenefitBackground',
+        labelFallback: 'Benefit / Investment background (gradient)',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addEvolutionBackground',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addEvolutionBackground',
+        labelFallback: 'Evolution background (Wardley presentation)',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addComponent',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.addComponent',
+        labelFallback: 'Component',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'c'], other: ['w', 'c'] },
+    },
+    {
+        id: 'wardley.addMethod',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.addMethod',
+        labelFallback: 'Component + method',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'm'], other: ['w', 'm'] },
+    },
+    {
+        id: 'wardley.addMarket',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addMarket',
+        labelFallback: 'Market',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addEcosystem',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addEcosystem',
+        labelFallback: 'Ecosystem',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addAnchor',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.addAnchor',
+        labelFallback: 'Anchor',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.addPipeline',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.addPipeline',
+        labelFallback: 'Pipeline',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'p'], other: ['w', 'p'] },
+    },
+    {
+        id: 'wardley.linkTool',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.linkTool',
+        labelFallback: 'Link',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'l'], other: ['w', 'l'] },
+    },
+    {
+        id: 'wardley.evolutionArrow',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.evolutionArrow',
+        labelFallback: 'Arrow (evolution)',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'a'], other: ['w', 'a'] },
+    },
+    {
+        id: 'wardley.addInertia',
+        owner: 'wardley',
+        labelKey: 'com.labre.keyboardShortcuts.wardley.addInertia',
+        labelFallback: 'Inertia',
+        scope: 'edgeless',
+        defaultKeys: { mac: ['w', 'i'], other: ['w', 'i'] },
+    },
+    {
+        id: 'wardley.importOwm',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.importOwm',
+        labelFallback: 'Import Wardley map (OWM)',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.exportOwm',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.exportOwm',
+        labelFallback: 'Export Wardley map (OWM)',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+    {
+        id: 'wardley.importSvg',
+        owner: 'wardley',
+        labelKey: 'com.labre.commands.wardley.importSvg',
+        labelFallback: 'Import SVG sketch',
+        scope: 'edgeless',
+        defaultKeys: { mac: [], other: [] },
+    },
+];

package/dist/element-view.d.ts

@@ -1,4 +1,6 @@
 import type { WardleyBackgroundElementModel } from '@formicoidea/labre-core/model';
+import type { EditorHost } from '@formicoidea/labre-core/std';
+import type { PointTestOptions } from '@formicoidea/labre-core/std/gfx';
 import { GfxElementModelView } from '@formicoidea/labre-core/std/gfx';
 export declare class WardleyView extends GfxElementModelView<WardleyBackgroundElementModel> {
     static type: string;
@@ -6,6 +8,26 @@ export declare class WardleyView extends GfxElementModelView<WardleyBackgroundEl
     private _labelEditor;
     onCreated(): void;
     onDestroyed(): void;
+    /**
+     * The editable label under a MODEL-space point, or null.
+     *
+     * Which labels exist, where they sit, what they SAY and which are editable
+     * all come from the declaration the renderer paints — one source, resolved
+     * through the same catalogue, so a label can never be drawn in one place
+     * and clicked in another, nor read one thing and open on another.
+     */
+    private _labelAt;
+    /**
+     * The map is SELECTED by its border (`WardleyBackgroundElementModel`), but
+     * its axis labels must still receive the double-click that renames them.
+     *
+     * So the two areas differ, and this is where they are allowed to: the pointer
+     * router asks the VIEW (`GfxViewEventManager`), and the view adds the zones
+     * the declaration draws its labels in. Picking is unaffected —
+     * `getElementByPoint` still asks the model, so a click in the middle of the
+     * map still goes to whatever the user put there.
+     */
+    includesPoint(x: number, y: number, options: PointTestOptions, host: EditorHost): boolean;
     /** Double-click on a label → edit its text in place. */
     private _onDblClick;
     /**

package/dist/element-view.js

@@ -18,11 +18,15 @@ export class WardleyView extends GfxElementModelView {
         this._closeLabelEditor();
         super.onDestroyed();
     }
-    /** Double-click on a label → edit its text in place. */
-    _onDblClick(e) {
-        if (this.model.isLocked())
-            return;
-        const [mx, my] = this.gfx.viewport.toModelCoord(e.x, e.y);
+    /**
+     * The editable label under a MODEL-space point, or null.
+     *
+     * Which labels exist, where they sit, what they SAY and which are editable
+     * all come from the declaration the renderer paints — one source, resolved
+     * through the same catalogue, so a label can never be drawn in one place
+     * and clicked in another, nor read one thing and open on another.
+     */
+    _labelAt(mx, my) {
         const [bx, by, w, h] = this.model.deserializedXYWH;
         // Convert the model-space point into element-local coordinates, undoing the
         // element rotation around its center.
@@ -35,15 +39,34 @@ export class WardleyView extends GfxElementModelView {
             lx = ux - bx;
             ly = uy - by;
         }
-        // Which labels exist, where they sit, what they SAY and which are editable
-        // all come from the declaration the renderer paints — one source, resolved
-        // through the same catalogue, so a label can never be drawn in one place
-        // and clicked in another, nor read one thing and open on another.
         const hit = hitTestBackgroundLabel(backgroundLabelHits(WARDLEY_BACKGROUND, this.model, w, h, this.gfx.std.getOptional(TranslationProvider)), lx, ly);
-        if (!hit)
-            return;
         // The declaration names the prop; this decides whether it may be written.
-        if (!isWardleyLabelProp(hit.prop))
+        if (!hit || !isWardleyLabelProp(hit.prop))
+            return null;
+        return { prop: hit.prop, text: hit.text };
+    }
+    /**
+     * The map is SELECTED by its border (`WardleyBackgroundElementModel`), but
+     * its axis labels must still receive the double-click that renames them.
+     *
+     * So the two areas differ, and this is where they are allowed to: the pointer
+     * router asks the VIEW (`GfxViewEventManager`), and the view adds the zones
+     * the declaration draws its labels in. Picking is unaffected —
+     * `getElementByPoint` still asks the model, so a click in the middle of the
+     * map still goes to whatever the user put there.
+     */
+    includesPoint(x, y, options, host) {
+        if (super.includesPoint(x, y, options, host))
+            return true;
+        return this._labelAt(x, y) !== null;
+    }
+    /** Double-click on a label → edit its text in place. */
+    _onDblClick(e) {
+        if (this.model.isLocked())
+            return;
+        const [mx, my] = this.gfx.viewport.toModelCoord(e.x, e.y);
+        const hit = this._labelAt(mx, my);
+        if (!hit)
             return;
         this._openLabelEditor(hit.prop, hit.text, e);
     }

package/dist/toolbar/config.d.ts

@@ -1,9 +1,10 @@
-import { type ToolbarContext } from '@formicoidea/labre-core/shared/services';
+import { type ChromeWording, type ToolbarContext } from '@formicoidea/labre-core/shared/services';
 import { type TemplateResult } from 'lit';
 export declare const wardleyToolbarConfig: {
     readonly actions: [{
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         when: boolean | ((ctx: ToolbarContext) => boolean);
         active(ctx: ToolbarContext): boolean;
@@ -13,6 +14,7 @@ export declare const wardleyToolbarConfig: {
         readonly actions: [{
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -20,6 +22,7 @@ export declare const wardleyToolbarConfig: {
         }, {
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -27,6 +30,7 @@ export declare const wardleyToolbarConfig: {
         }, {
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -34,6 +38,7 @@ export declare const wardleyToolbarConfig: {
         }, {
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -41,6 +46,7 @@ export declare const wardleyToolbarConfig: {
         }, {
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -51,6 +57,7 @@ export declare const wardleyToolbarConfig: {
         readonly actions: [{
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -58,6 +65,7 @@ export declare const wardleyToolbarConfig: {
         }, {
             id: string;
             tooltip: string;
+            tooltipWording: ChromeWording | undefined;
             icon: TemplateResult;
             when: boolean | ((ctx: ToolbarContext) => boolean);
             active(ctx: ToolbarContext): boolean;
@@ -65,7 +73,7 @@ export declare const wardleyToolbarConfig: {
         }];
     }, {
         readonly id: "d.legend";
-        readonly tooltip: "Generate the legend (components present)";
+        readonly tooltipWording: ChromeWording;
         readonly icon: TemplateResult<2>;
         readonly run: (ctx: ToolbarContext) => void;
     }];

package/dist/toolbar/config.js

@@ -1,6 +1,6 @@
 import { EdgelessCRUDIdentifier } from '@formicoidea/labre-core/blocks/surface';
 import { WardleyBackgroundElementModel } from '@formicoidea/labre-core/model';
-import { TelemetryProvider, ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
+import { BOARD_LEGEND_COMPONENTS, BOARD_RESIZE_TOGGLE, TelemetryProvider, ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
 import { BlockFlavourIdentifier } from '@formicoidea/labre-core/std';
 import { html } from 'lit';
 import { createWardleyLegend } from '../legend.js';
@@ -129,7 +129,12 @@ const VisibilityIcon = html `<svg
 function booleanToggle(id, tooltip, icon, prop, when) {
     return {
         id,
-        tooltip,
+        tooltip: typeof tooltip === 'string' ? tooltip : tooltip[1],
+        // The declared wording, when the caller gave one instead of a literal:
+        // `combine` resolves it against the host's catalogue and writes it over
+        // the English default above, so a playground with no catalogue reads
+        // exactly what it read before (#183).
+        tooltipWording: typeof tooltip === 'string' ? undefined : tooltip,
         icon,
         when: when ?? true,
         active(ctx) {
@@ -151,7 +156,7 @@ function booleanToggle(id, tooltip, icon, prop, when) {
 }
 export const wardleyToolbarConfig = {
     actions: [
-        booleanToggle('a.toggle-resize', 'Enable / lock resizing', ResizeIcon, 'resizeEnabled'),
+        booleanToggle('a.toggle-resize', BOARD_RESIZE_TOGGLE, ResizeIcon, 'resizeEnabled'),
         // Group 1 — evolution (X) side: axis, phase labels, columns, corner
         // labels, and the gradient toggle.
         {
@@ -179,7 +184,7 @@ export const wardleyToolbarConfig = {
         // background's perimeter (+ a gradient-meaning block for gradient variants).
         {
             id: 'd.legend',
-            tooltip: 'Generate the legend (components present)',
+            tooltipWording: BOARD_LEGEND_COMPONENTS,
             icon: wardleyLegendIcon,
             run(ctx) {
                 const models = ctx.getSurfaceModelsByType(WardleyBackgroundElementModel);

package/dist/translations.js

@@ -1,4 +1,4 @@
-import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
+import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
 import { WARDLEY_AUDIT_CRITERIA } from './audit-criteria.js';
 import { WARDLEY_BACKGROUND } from './background.js';
 import { wardleyCommands } from './commands.js';
@@ -21,4 +21,10 @@ import { WARDLEY_RULES } from './rules.js';
  * complete in the monorepo and silently 61 % short (107 keys of 175) in the
  * distribution hosts actually consume.
  */
-export const wardleyTranslationEntries = mergeTranslationEntries(commandTranslationEntries(wardleyCommands), collectTranslationKeys('role', WARDLEY_ROLES), collectTranslationKeys('background', WARDLEY_BACKGROUND), collectTranslationKeys('rule', WARDLEY_RULES), collectTranslationKeys('nudge', WARDLEY_NUDGES), collectTranslationKeys('profile', WARDLEY_PROFILES), collectTranslationKeys('audit-criterion', WARDLEY_AUDIT_CRITERIA), collectTranslationKeys('reading', WARDLEY_READING));
+export const wardleyTranslationEntries = mergeTranslationEntries(commandTranslationEntries(wardleyCommands), 
+// The catalogue's own group headers, derived from the very categories
+// these commands declare. They ship WITH the framework because core's
+// registry names no framework category in the bundled distribution, so a
+// host that composed core's manifest alone drew translated entries under
+// English headers (#183).
+commandCategoryTranslationEntries(wardleyCommands), collectTranslationKeys('role', WARDLEY_ROLES), collectTranslationKeys('background', WARDLEY_BACKGROUND), collectTranslationKeys('rule', WARDLEY_RULES), collectTranslationKeys('nudge', WARDLEY_NUDGES), collectTranslationKeys('profile', WARDLEY_PROFILES), collectTranslationKeys('audit-criterion', WARDLEY_AUDIT_CRITERIA), collectTranslationKeys('reading', WARDLEY_READING));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-wardley",
   "description": "Labre wardley framework for @formicoidea/labre-core.",
-  "version": "0.33.0",
+  "version": "0.34.1",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -21,13 +21,17 @@
     "./descriptor": {
       "types": "./dist/descriptor.d.ts",
       "import": "./dist/descriptor.js"
+    },
+    "./commands-manifest": {
+      "types": "./dist/commands-manifest.d.ts",
+      "import": "./dist/commands-manifest.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.33.0",
+    "@formicoidea/labre-core": "0.34.1",
     "lit": "^3.2.0"
   }
 }