@formicoidea/labre-core 0.32.0 → 0.34.1

package/dist/_pkgs/store/model/store/crud.js

@@ -195,7 +195,10 @@ export class DocCRUD {
             // be answered before indexing.
             if (index === 0)
                 return null;
-            return parent.get('sys:children').toArray().at(index - 1) ?? null;
+            return (parent
+                .get('sys:children')
+                .toArray()
+                .at(index - 1) ?? null);
         });
     }
     moveBlocks(blocksToMove, newParent, targetSibling = null, shouldInsertBeforeSibling = true) {

package/dist/commands.js

@@ -1,5 +1,5 @@
 import { coreCommands, pivotCommands, readingCommands, tagCommands, } from './_pkgs/affine-block-root/index.js';
-import { auditCommands, mapQualityCommands, } from './_pkgs/affine-block-surface/index.js';
+import { auditCommands, mapQualityCommands } from './_pkgs/affine-block-surface/index.js';
 import { edgeDirectionCommands } from './_pkgs/affine-gfx-connector/index.js';
 import { shapeCommands } from './_pkgs/affine-gfx-shape/index.js';
 import { toCommandManifestEntry, } from './_pkgs/std/index.js';

package/dist/extensions/command-usage.d.ts

@@ -0,0 +1,23 @@
+import { type ViewExtensionContext, ViewExtensionProvider } from '../_pkgs/affine-ext-loader/index.js';
+import type { ExtensionType } from '../_pkgs/store/index.js';
+/**
+ * The DEFAULT command usage measure: `localStorage`, this browser only.
+ *
+ * `runCommand` records every invocation into whatever answers
+ * `CommandUsageIdentifier`; without a default nothing would be measured at all
+ * until a host wired a store, and PF6's "seven most-recent + six most-used"
+ * sub-menu would have nothing to rank in a standalone editor. A host that owns
+ * a per-user database replaces this with `CommandUsageExtension(store)`, whose
+ * `di.override` beats the `addImpl` below.
+ */
+export declare const CommandUsageDefaultExtension: ExtensionType;
+/**
+ * Registered unconditionally by `getInternalViewExtensions`, next to
+ * `CommandTelemetryViewExtension` and for the same reason: measuring which
+ * commands a user reaches for is not a framework's business, and a framework
+ * toggled off simply never invokes a command.
+ */
+export declare class CommandUsageViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}

package/dist/extensions/command-usage.js

@@ -0,0 +1,37 @@
+import { ViewExtensionProvider, } from '../_pkgs/affine-ext-loader/index.js';
+import { createLocalCommandUsageStore } from '../_pkgs/affine-shared/services/index.js';
+import { CommandUsageIdentifier } from '../_pkgs/std/index.js';
+/**
+ * The DEFAULT command usage measure: `localStorage`, this browser only.
+ *
+ * `runCommand` records every invocation into whatever answers
+ * `CommandUsageIdentifier`; without a default nothing would be measured at all
+ * until a host wired a store, and PF6's "seven most-recent + six most-used"
+ * sub-menu would have nothing to rank in a standalone editor. A host that owns
+ * a per-user database replaces this with `CommandUsageExtension(store)`, whose
+ * `di.override` beats the `addImpl` below.
+ */
+export const CommandUsageDefaultExtension = {
+    // Factory form, not value form — as for the telemetry reporter: the container
+    // calls a function argument as a factory, so the store is built here and the
+    // service provider is never passed to it.
+    setup: di => {
+        di.addImpl(CommandUsageIdentifier, () => createLocalCommandUsageStore());
+    },
+};
+/**
+ * Registered unconditionally by `getInternalViewExtensions`, next to
+ * `CommandTelemetryViewExtension` and for the same reason: measuring which
+ * commands a user reaches for is not a framework's business, and a framework
+ * toggled off simply never invokes a command.
+ */
+export class CommandUsageViewExtension extends ViewExtensionProvider {
+    constructor() {
+        super(...arguments);
+        this.name = 'affine-command-usage';
+    }
+    setup(context) {
+        super.setup(context);
+        context.register(CommandUsageDefaultExtension);
+    }
+}

package/dist/extensions/view.js

@@ -58,6 +58,7 @@ import { ToolbarViewExtension } from '../_pkgs/affine-widget-toolbar/view.js';
 import { ViewportOverlayViewExtension } from '../_pkgs/affine-widget-viewport-overlay/view.js';
 import { isBlockEnabled, isCapabilityEnabled, } from '../flags.js';
 import { CommandTelemetryViewExtension } from './command-telemetry.js';
+import { CommandUsageViewExtension } from './command-usage.js';
 /**
  * View extensions.
  *
@@ -74,9 +75,20 @@ export function getInternalViewExtensions(flags) {
         // The single command-telemetry emitter. Unconditional: a disabled
         // framework simply never invokes a command (docs/adr/0008).
         CommandTelemetryViewExtension,
+        // The default (browser-local) recency/frequency measure. Unconditional for
+        // the same reason, and independent of telemetry: it feeds an in-editor
+        // ranking, not a dashboard (docs/adr/0008).
+        CommandUsageViewExtension,
         // Gfx — each framework contributes an always-on `…Render…` extension
         // (element view + renderer + interaction + contextual toolbar) and a
         // flag-gated tooling extension (senior button + creation shortcuts).
+        //
+        // The eight business frameworks are registered as PAIRS, in the order their
+        // senior buttons must read left to right: no framework declares a
+        // `SeniorTool.order`, so they all share the default group and the row is
+        // sorted stably — i.e. left in registration order. The single source of that
+        // order is `FRAMEWORK_DESCRIPTORS`, and `senior-row-order.unit.spec.ts` pins
+        // the two lists together.
         PointerViewExtension,
         GfxNoteViewExtension,
         BrushRenderViewExtension,

package/dist/frameworks.js

@@ -2,6 +2,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'wardley',
         labelKey: 'com.labre.framework.wardley',
+        labelFallback: 'Wardley map',
         iconKey: 'wardley.toolbar',
         // The only allocated chord prefix: `w` was free against
         // RESERVED_EDGELESS_KEYS. The other six frameworks ship no chord, so they
@@ -26,6 +27,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'edgy',
         labelKey: 'com.labre.framework.edgy',
+        labelFallback: 'EDGY',
         iconKey: 'edgy.toolbar',
         telemetryKey: 'edgy',
         telemetrySegment: 'edgy toolbox',
@@ -43,6 +45,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'cynefin-estuarine',
         labelKey: 'com.labre.framework.cynefin-estuarine',
+        labelFallback: 'Cynefin / Estuarine',
         iconKey: 'cynefin.toolbar',
         // Historical PostHog value; the flag and the owner say
         // `cynefin-estuarine`, the wire says `cynefin`.
@@ -66,6 +69,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'bpmn',
         labelKey: 'com.labre.framework.bpmn',
+        labelFallback: 'BPMN',
         iconKey: 'bpmn.toolbar',
         telemetryKey: 'bpmn',
         telemetrySegment: 'bpmn toolbox',
@@ -83,6 +87,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'ddd-event-storming',
         labelKey: 'com.labre.framework.ddd-event-storming',
+        labelFallback: 'Event Storming',
         iconKey: 'ddd-event-storming.toolbar',
         telemetryKey: 'event-storming',
         telemetrySegment: 'ddd toolbox',
@@ -91,6 +96,9 @@ export const FRAMEWORK_DESCRIPTORS = [
         pkg: '@labre/affine-gfx-ddd-event-storming',
         dir: 'affine/gfx/ddd-event-storming',
         extensions: [
+            // always-on: placed Event Storming boards must paint even with the button
+            // off, and their role vocabulary must stay readable
+            { viewExtension: 'DddEventStormingRenderViewExtension' },
             {
                 flag: 'ddd-event-storming',
                 viewExtension: 'DddEventStormingViewExtension',
@@ -98,9 +106,29 @@ export const FRAMEWORK_DESCRIPTORS = [
         ],
         shortcuts: true,
     },
+    {
+        id: 'c4',
+        labelKey: 'com.labre.framework.c4',
+        labelFallback: 'C4 model',
+        iconKey: 'c4.toolbar',
+        telemetryKey: 'c4',
+        telemetrySegment: 'c4 toolbox',
+        bundle: 'framework-c4',
+        info: 'c4Framework',
+        pkg: '@labre/affine-gfx-c4',
+        dir: 'affine/gfx/c4',
+        extensions: [
+            // always-on: placed C4 boards, boundaries and elements must paint even
+            // with the button off
+            { viewExtension: 'C4RenderViewExtension' },
+            { flag: 'c4', viewExtension: 'C4ViewExtension' },
+        ],
+        shortcuts: true,
+    },
     {
         id: 'ddd-core-domain',
         labelKey: 'com.labre.framework.ddd-core-domain',
+        labelFallback: 'Core Domain Chart',
         iconKey: 'ddd-core-domain.toolbar',
         telemetryKey: 'core-domain',
         telemetrySegment: 'ddd toolbox',
@@ -118,6 +146,7 @@ export const FRAMEWORK_DESCRIPTORS = [
     {
         id: 'ddd-context-map',
         labelKey: 'com.labre.framework.ddd-context-map',
+        labelFallback: 'Context Map',
         iconKey: 'ddd-context-map.toolbar',
         telemetryKey: 'context-map',
         telemetrySegment: 'ddd toolbox',
@@ -126,6 +155,9 @@ export const FRAMEWORK_DESCRIPTORS = [
         pkg: '@labre/affine-gfx-ddd-context-map',
         dir: 'affine/gfx/ddd-context-map',
         extensions: [
+            // always-on: placed Context Map boards must paint even with the button
+            // off, and their role vocabulary must stay readable
+            { viewExtension: 'DddContextMapRenderViewExtension' },
             { flag: 'ddd-context-map', viewExtension: 'DddContextMapViewExtension' },
         ],
         shortcuts: true,

package/dist/shortcuts.d.ts

@@ -1,24 +1,38 @@
-import type { ShortcutDescriptor } from './_pkgs/std/index.js';
+import { type ShortcutManifestEntry } from './_pkgs/std/index.js';
 import type { LabreFlags } from './flags.js';
 /**
  * Manifest view of a shortcut: the metadata a host "Shortcuts" settings panel
  * needs, without the runtime `handler`.
  *
- * Since PF3 it is a projection of a projection: {@link CommandDescriptor} →
- * {@link ShortcutDescriptor} → here. It KEEPS representing shortcuts and
- * nothing else — no `iconKey`, no `category`; catalogue metadata travels on
- * `CommandManifestEntry` (`docs/adr/0008` § Icons).
+ * Since PF3 it is a projection of `CommandDescriptor`, and it is now declared
+ * ONCE, in `@labre/std` beside the projection that builds it — because the
+ * framework bundles publish the very same rows on their own
+ * `./commands-manifest` subpath, and a host composing core's manifest with a
+ * framework's must be handed one type, not two.
+ *
+ * It KEEPS representing shortcuts and nothing else — no `iconKey`, no
+ * `category`; catalogue metadata travels on `CommandManifestEntry`
+ * (`docs/adr/0008` § Icons). `labelFallback` is the one addition, and it is not
+ * catalogue metadata: it is the wording the panel SHOWS when the host has no
+ * translation for `labelKey`. Dropping it was why a host with no catalogue
+ * rendered raw keys, and why every host had to re-project from the main entry
+ * to recover a wording the library already knew.
  *
  * Breaking shape change for hosts: `when?: string` is gone (no descriptor in
  * the repo ever set it), `defaultKeys` is always present, and `owner` narrows
  * from `string` to `CommandOwner`.
  */
-export type ShortcutManifestEntry = Omit<ShortcutDescriptor, 'handler'>;
+export type { ShortcutManifestEntry };
 /**
  * The enumerable shortcut manifest for a given flag set. TOTAL over the command
  * registry: every command yields a row, keyless ones included, so Settings ›
  * Shortcuts can bind precisely the commands a user most wants to bind. The
  * panel therefore grows from ~10 rows to the full command count — that is the
  * intent, and `owner` grouping is what keeps it usable.
+ *
+ * In the BUNDLED distribution this returns core's share only: each framework
+ * bundle's commands are stripped out of core by `scripts/build-bundles.mjs` and
+ * republished as that bundle's data-only `./commands-manifest` export, which
+ * the host concatenates for the frameworks it enables.
  */
 export declare function getShortcutManifest(flags?: LabreFlags): ShortcutManifestEntry[];

package/dist/shortcuts.js

@@ -1,19 +1,17 @@
-import { toShortcutDescriptor } from './_pkgs/std/index.js';
+import { toShortcutManifestEntry, } from './_pkgs/std/index.js';
 import { getCommands } from './commands.js';
-const toEntry = (d) => ({
-    id: d.id,
-    labelKey: d.labelKey,
-    defaultKeys: d.defaultKeys,
-    scope: d.scope,
-    owner: d.owner,
-});
 /**
  * The enumerable shortcut manifest for a given flag set. TOTAL over the command
  * registry: every command yields a row, keyless ones included, so Settings ›
  * Shortcuts can bind precisely the commands a user most wants to bind. The
  * panel therefore grows from ~10 rows to the full command count — that is the
  * intent, and `owner` grouping is what keeps it usable.
+ *
+ * In the BUNDLED distribution this returns core's share only: each framework
+ * bundle's commands are stripped out of core by `scripts/build-bundles.mjs` and
+ * republished as that bundle's data-only `./commands-manifest` export, which
+ * the host concatenates for the frameworks it enables.
  */
 export function getShortcutManifest(flags) {
-    return getCommands(flags).map(toShortcutDescriptor).map(toEntry);
+    return getCommands(flags).map(toShortcutManifestEntry);
 }

package/dist/translations.js

@@ -1,5 +1,6 @@
-import { EXEMPTION_FALLBACK, RELATION_SIDE_FALLBACK, SEVERITY_FALLBACK, } from './_pkgs/affine-block-surface/index.js';
-import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from './_pkgs/std/index.js';
+import { EXEMPTION_FALLBACK, PROVENANCE_FALLBACK, RELATION_SIDE_FALLBACK, SEVERITY_FALLBACK, } from './_pkgs/affine-block-surface/index.js';
+import { CHROME_WORDINGS } from './_pkgs/affine-shared/services/index.js';
+import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from './_pkgs/std/index.js';
 import { getCommands } from './commands.js';
 import { FRAMEWORK_DESCRIPTORS } from './frameworks.js';
 const FRAMEWORK_TRANSLATION_GROUPS = [];
@@ -13,6 +14,11 @@ const FRAMEWORK_TRANSLATION_GROUPS = [];
 const CHROME_TABLES = [
     ['com.labre.validation.severity.', SEVERITY_FALLBACK],
     ['com.labre.validation.state.exempted.', EXEMPTION_FALLBACK],
+    // The four kinds of authority a rule can claim. `organization` is enumerated
+    // with the rest although nothing declares it yet: the table is the TYPE, and
+    // a host building a catalogue must not have to come back for a fourth word
+    // the day the first org profile ships.
+    ['com.labre.validation.provenance.', PROVENANCE_FALLBACK],
     ['com.labre.reading.relations.', RELATION_SIDE_FALLBACK],
 ];
 const chromeTableEntries = () => CHROME_TABLES.flatMap(([prefix, table]) => Object.entries(table).map(([suffix, fallback]) => ({
@@ -20,6 +26,29 @@ const chromeTableEntries = () => CHROME_TABLES.flatMap(([prefix, table]) => Obje
     fallback,
     source: 'chrome',
 })));
+/**
+ * The artefact catalogue's group headers — one key per `category` any command
+ * declares, with the sidepanel's own humanised fallback.
+ *
+ * DERIVED, not restated: the categories are walked out of `getCommands()`, so a
+ * framework that invents a category gets its header key in the manifest by
+ * construction. The fallback comes from `humanizeCategory`, the very function
+ * the panel renders with, so the two cannot drift.
+ *
+ * Flag-independent like the rest of the manifest: `getCommands()` with no flags
+ * enumerates every command, so a catalogue built once covers a framework
+ * switched on later.
+ *
+ * In the BUNDLED distribution this walks core's commands alone — the framework
+ * groups are stripped from this file — which is why every framework contributes
+ * its OWN category headers from its `…TranslationEntries` as well (#183: a
+ * bundled host was offered translated catalogue ENTRIES under untranslated
+ * headers, because "EVENTS" and "GATEWAYS" are BPMN's categories and BPMN's
+ * commands are not in core). The two overlap in the monorepo and
+ * `mergeTranslationEntries` de-duplicates them, so both assemblies produce the
+ * same list.
+ */
+const catalogueCategoryEntries = () => commandCategoryTranslationEntries(getCommands());
 /**
  * Chrome wordings: the `translateKey(std, key, fallback)` literals of the
  * library's own panels and toolbars. Restated data, guarded against drift AND
@@ -43,8 +72,23 @@ const CHROME_KEYS = [
     ['com.labre.validation.map-quality.section', 'Map quality'],
     ['com.labre.validation.map-quality.checklist.yours', 'To be checked by you:'],
     ['com.labre.validation.map-quality.close', 'Close'],
+    // Senior sub-menu, past the fourteen-slot cap
+    ['com.labre.catalogue.open', 'More artefacts…'],
+    [
+        'com.labre.catalogue.open.description',
+        'This framework offers more than the menu can show.',
+    ],
+    // Artefact catalogue sidepanel
+    ['com.labre.catalogue.title', 'Artefacts'],
+    ['com.labre.catalogue.close', 'Close'],
+    ['com.labre.catalogue.other', 'Other'],
+    ['com.labre.catalogue.ranked', 'Recent & frequent'],
     // Qualify (tags) toolbar
     ['com.labre.tags.toolbar.label', 'Qualify'],
+    // Morph ("Change type") toolbar — generic chrome, like the two above: the
+    // KINDS it offers are named by each framework's own creation commands, and
+    // only the drop-down's own word lives here.
+    ['com.labre.morph.toolbar.label', 'Change type'],
     // Reading panel
     ['com.labre.reading.toolbar.label', 'Read this component'],
     ['com.labre.reading.panel.label', 'Proposed record'],
@@ -89,6 +133,47 @@ const CHROME_KEYS = [
     ['com.labre.reading.record.linked', 'Linked'],
     ['com.labre.reading.record.none', 'Not linked to a record.'],
     ['com.labre.reading.drift.message', 'The board and the record disagree'],
+    // BPMN interchange: what an export could not write down. Chrome and not
+    // framework prose — these are the words the library's own notification puts
+    // around a report the writer produced, so they ship with an English default
+    // and a standalone playground reads correctly with no catalogue registered.
+    [
+        'com.labre.commands.bpmn.exportXml.warnings',
+        'What this export could not write down',
+    ],
+    // Wardley's own, and the same sentence: one key per WRITER, because an
+    // export's losses are the capability's own words and there is no generic
+    // pipeline writing them (the import's wordings below are shared precisely
+    // because there is one).
+    [
+        'com.labre.commands.wardley.exportOwm.warnings',
+        'What this export could not write down',
+    ],
+    // What an IMPORT did with the file — one set of keys for every format, not
+    // one per format. The format's own name is composed into the wording
+    // ("BPMN" + "file imported", "OWM 2.0" after the counts), which is the same
+    // compromise the three count labels below already make: the seam has no
+    // interpolation, so a proper noun and a countable noun are the largest units
+    // this library can hand over without inventing grammar. A key per format
+    // would ask a host to translate the same sentence once per reader we ship,
+    // and would leave every new format silently untranslated.
+    ['com.labre.interchange.import.done', 'file imported'],
+    ['com.labre.interchange.import.failed', 'This file could not be imported'],
+    [
+        'com.labre.interchange.import.remarks',
+        'What the import could not keep as it was',
+    ],
+    [
+        'com.labre.interchange.import.console',
+        'remarks — the full report is in the browser console.',
+    ],
+    // The three count labels of the summary line. Separate keys rather than one
+    // sentence with holes in it: the seam has no interpolation and no
+    // pluralisation (both are the host's), so a countable noun is the largest
+    // unit this library can hand over without inventing grammar.
+    ['com.labre.interchange.import.drawn', 'drawn'],
+    ['com.labre.interchange.import.carried', 'carried'],
+    ['com.labre.interchange.import.quarantined', 'quarantined'],
 ];
 /**
  * Every i18n key THIS package can ask the host for, with its English fallback
@@ -104,7 +189,17 @@ const CHROME_KEYS = [
  * not filtered either.
  */
 export function getTranslationKeyManifest() {
-    return mergeTranslationEntries(commandTranslationEntries(getCommands()), collectTranslationKeys('framework', FRAMEWORK_DESCRIPTORS), ...FRAMEWORK_TRANSLATION_GROUPS.map(group => group.entries), chromeTableEntries(), CHROME_KEYS.map(([key, fallback]) => ({
+    return mergeTranslationEntries(commandTranslationEntries(getCommands()), collectTranslationKeys('framework', FRAMEWORK_DESCRIPTORS), ...FRAMEWORK_TRANSLATION_GROUPS.map(group => group.entries), chromeTableEntries(), catalogueCategoryEntries(), 
+    // The editor's own shared vocabulary — the toasts, the toolbar verbs, the
+    // view switcher, the board tooltips — DECLARED in
+    // `@labre/affine-shared/services` beside nothing at all, and walked here
+    // rather than restated. Same rule as the tables above: a wording added to
+    // `CHROME_WORDINGS` reaches a host with no second edit.
+    CHROME_WORDINGS.map(([key, fallback]) => ({
+        key,
+        fallback,
+        source: 'chrome',
+    })), CHROME_KEYS.map(([key, fallback]) => ({
         key,
         fallback,
         source: 'chrome',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-core",
   "description": "Labre editor — the full BlockSuite-derived editor as one package.",
-  "version": "0.32.0",
+  "version": "0.34.1",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -853,6 +853,18 @@
     "./foundation/view": {
       "types": "./dist/foundation/view.d.ts",
       "import": "./dist/foundation/view.js"
+    },
+    "./_pkgs/affine-widget-edgeless-toolbar": {
+      "types": "./dist/_pkgs/affine-widget-edgeless-toolbar/index.d.ts",
+      "import": "./dist/_pkgs/affine-widget-edgeless-toolbar/index.js"
+    },
+    "./_pkgs/global/di": {
+      "types": "./dist/_pkgs/global/di/index.d.ts",
+      "import": "./dist/_pkgs/global/di/index.js"
+    },
+    "./_pkgs/global/utils": {
+      "types": "./dist/_pkgs/global/utils/index.d.ts",
+      "import": "./dist/_pkgs/global/utils/index.js"
     }
   },
   "files": [