@dxos/app-framework 0.8.4-main.ae835ea → 0.8.4-main.bc674ce

package/.storybook/main.mts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { createConfig } from '../../../../tools/storybook/.storybook/main';
+import { createConfig } from '../../../../tools/storybook-react/.storybook/main';
 
 export const stories = [
   '../src/**/*.stories.tsx',

package/.storybook/preview.mts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { preview } from '../../../../tools/storybook/.storybook/preview';
+import { preview } from '../../../../tools/storybook-react/.storybook/preview';
 
-export * from '../../../../tools/storybook/.storybook/preview';
+export * from '../../../../tools/storybook-react/.storybook/preview';
 export default preview;

package/dist/lib/browser/app-graph-builder-M2VPYQC6.mjs

@@ -0,0 +1,149 @@
+import {
+  SETTINGS_ID,
+  SETTINGS_KEY,
+  SettingsOperation,
+  meta
+} from "./chunk-H4WPA7U7.mjs";
+import {
+  Capability
+} from "./chunk-BLQJSGL3.mjs";
+import "./chunk-FMZN33N4.mjs";
+import "./chunk-PKQT6C53.mjs";
+import "./chunk-TCLLRCS3.mjs";
+import {
+  capability_exports
+} from "./chunk-6Y7PZV72.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-settings/app-graph-builder.ts
+import * as Effect from "effect/Effect";
+import { GraphBuilder, NodeMatcher } from "@dxos/app-graph";
+import { Operation } from "@dxos/operation";
+import { isNonNullable } from "@dxos/util";
+var app_graph_builder_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilities = yield* capability_exports.Service;
+  const managerAtom = capabilities.atom(Capability.PluginManager);
+  const settingsAtom = capabilities.atom(Capability.Settings);
+  const extensions = yield* Effect.all([
+    GraphBuilder.createExtension({
+      id: `${meta.id}/action`,
+      match: NodeMatcher.whenRoot,
+      actions: () => Effect.succeed([
+        {
+          id: meta.id,
+          data: () => Operation.invoke(SettingsOperation.Open, {}),
+          properties: {
+            label: [
+              "open settings label",
+              {
+                ns: meta.id
+              }
+            ],
+            icon: "ph--gear--regular",
+            disposition: "menu",
+            keyBinding: {
+              macos: "meta+,",
+              windows: "alt+,"
+            }
+          }
+        }
+      ])
+    }),
+    GraphBuilder.createExtension({
+      id: `${meta.id}/core`,
+      match: NodeMatcher.whenRoot,
+      connector: () => Effect.succeed([
+        {
+          id: SETTINGS_ID,
+          type: meta.id,
+          properties: {
+            label: [
+              "app settings label",
+              {
+                ns: meta.id
+              }
+            ],
+            icon: "ph--gear--regular",
+            disposition: "pin-end",
+            position: "hoist",
+            testId: "treeView.appSettings"
+          }
+        }
+      ])
+    }),
+    GraphBuilder.createExtension({
+      id: `${meta.id}/core-plugins`,
+      match: NodeMatcher.whenId(SETTINGS_ID),
+      connector: (node, get) => {
+        const [manager] = get(managerAtom);
+        const allSettings = get(settingsAtom);
+        return Effect.succeed([
+          ...manager.getPlugins().filter((plugin) => manager.getCore().includes(plugin.meta.id)).map((plugin) => {
+            const settings = allSettings.find((s) => s.prefix === plugin.meta.id);
+            if (!settings) {
+              return null;
+            }
+            return [
+              plugin.meta,
+              settings
+            ];
+          }).filter(isNonNullable).map(([meta2, settings]) => ({
+            id: `${SETTINGS_KEY}:${meta2.id.replaceAll("/", ":")}`,
+            type: "category",
+            data: settings,
+            properties: {
+              label: meta2.name ?? meta2.id,
+              icon: meta2.icon ?? "ph--circle--regular"
+            }
+          })),
+          {
+            id: `${SETTINGS_KEY}:custom-plugins`,
+            type: "category",
+            properties: {
+              label: [
+                "custom plugins label",
+                {
+                  ns: meta.id
+                }
+              ],
+              icon: "ph--squares-four--regular",
+              role: "branch",
+              disposition: "collection"
+            }
+          }
+        ]);
+      }
+    }),
+    GraphBuilder.createExtension({
+      id: `${meta.id}/custom-plugins`,
+      match: NodeMatcher.whenId(`${SETTINGS_KEY}:custom-plugins`),
+      connector: (node, get) => {
+        const [manager] = get(managerAtom);
+        const allSettings = get(settingsAtom);
+        return Effect.succeed(manager.getPlugins().filter((plugin) => !manager.getCore().includes(plugin.meta.id)).map((plugin) => {
+          const settings = allSettings.find((s) => s.prefix === plugin.meta.id);
+          if (!settings) {
+            return null;
+          }
+          return [
+            plugin.meta,
+            settings
+          ];
+        }).filter(isNonNullable).map(([meta2, settings]) => ({
+          id: `${SETTINGS_KEY}:${meta2.id.replaceAll("/", ":")}`,
+          type: "category",
+          data: settings,
+          properties: {
+            label: meta2.name ?? meta2.id,
+            icon: meta2.icon ?? "ph--circle--regular"
+          }
+        })));
+      }
+    })
+  ]);
+  return capability_exports.contributes(Capability.AppGraphBuilder, extensions);
+}));
+export {
+  app_graph_builder_default as default
+};
+//# sourceMappingURL=app-graph-builder-M2VPYQC6.mjs.map

package/dist/lib/browser/app-graph-builder-M2VPYQC6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-settings/app-graph-builder.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { GraphBuilder, NodeMatcher } from '@dxos/app-graph';\nimport { Operation } from '@dxos/operation';\nimport { isNonNullable } from '@dxos/util';\n\nimport * as Common from '../common';\nimport { Capability, type Plugin } from '../core';\n\nimport { SETTINGS_ID, SETTINGS_KEY, SettingsOperation } from './actions';\nimport { meta } from './meta';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get context for lazy capability access in callbacks.\n    const capabilities = yield* Capability.Service;\n    const managerAtom = capabilities.atom(Common.Capability.PluginManager);\n    const settingsAtom = capabilities.atom(Common.Capability.Settings);\n\n    const extensions = yield* Effect.all([\n      GraphBuilder.createExtension({\n        id: `${meta.id}/action`,\n        match: NodeMatcher.whenRoot,\n        actions: () =>\n          Effect.succeed([\n            {\n              id: meta.id,\n              data: () => Operation.invoke(SettingsOperation.Open, {}),\n              properties: {\n                label: ['open settings label', { ns: meta.id }],\n                icon: 'ph--gear--regular',\n                disposition: 'menu',\n                keyBinding: {\n                  macos: 'meta+,',\n                  windows: 'alt+,',\n                },\n              },\n            },\n          ]),\n      }),\n      GraphBuilder.createExtension({\n        id: `${meta.id}/core`,\n        match: NodeMatcher.whenRoot,\n        connector: () =>\n          Effect.succeed([\n            {\n              id: SETTINGS_ID,\n              type: meta.id,\n              properties: {\n                label: ['app settings label', { ns: meta.id }],\n                icon: 'ph--gear--regular',\n                disposition: 'pin-end',\n                position: 'hoist',\n                testId: 'treeView.appSettings',\n              },\n            },\n          ]),\n      }),\n      GraphBuilder.createExtension({\n        id: `${meta.id}/core-plugins`,\n        match: NodeMatcher.whenId(SETTINGS_ID),\n        connector: (node, get) => {\n          const [manager] = get(managerAtom);\n          const allSettings = get(settingsAtom);\n          return Effect.succeed([\n            ...manager\n              .getPlugins()\n              .filter((plugin: Plugin.Plugin) => manager.getCore().includes(plugin.meta.id))\n              .map((plugin: Plugin.Plugin): [Plugin.Meta, Common.Capability.Settings] | null => {\n                const settings = allSettings.find((s) => s.prefix === plugin.meta.id);\n                if (!settings) {\n                  return null;\n                }\n\n                return [plugin.meta, settings];\n              })\n              .filter(isNonNullable)\n              .map(([meta, settings]: [Plugin.Meta, Common.Capability.Settings]) => ({\n                id: `${SETTINGS_KEY}:${meta.id.replaceAll('/', ':')}`,\n                type: 'category',\n                data: settings,\n                properties: {\n                  label: meta.name ?? meta.id,\n                  icon: meta.icon ?? 'ph--circle--regular',\n                },\n              })),\n\n            {\n              id: `${SETTINGS_KEY}:custom-plugins`,\n              type: 'category',\n              properties: {\n                label: ['custom plugins label', { ns: meta.id }],\n                icon: 'ph--squares-four--regular',\n                role: 'branch',\n                disposition: 'collection',\n              },\n            },\n          ]);\n        },\n      }),\n      GraphBuilder.createExtension({\n        id: `${meta.id}/custom-plugins`,\n        match: NodeMatcher.whenId(`${SETTINGS_KEY}:custom-plugins`),\n        connector: (node, get) => {\n          const [manager] = get(managerAtom);\n          const allSettings = get(settingsAtom);\n          return Effect.succeed(\n            manager\n              .getPlugins()\n              .filter((plugin: Plugin.Plugin) => !manager.getCore().includes(plugin.meta.id))\n              .map((plugin: Plugin.Plugin): [Plugin.Meta, Common.Capability.Settings] | null => {\n                const settings = allSettings.find((s) => s.prefix === plugin.meta.id);\n                if (!settings) {\n                  return null;\n                }\n\n                return [plugin.meta, settings];\n              })\n              .filter(isNonNullable)\n              .map(([meta, settings]: [Plugin.Meta, Common.Capability.Settings]) => ({\n                id: `${SETTINGS_KEY}:${meta.id.replaceAll('/', ':')}`,\n                type: 'category',\n                data: settings,\n                properties: {\n                  label: meta.name ?? meta.id,\n                  icon: meta.icon ?? 'ph--circle--regular',\n                },\n              })),\n          );\n        },\n      }),\n    ]);\n\n    return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,cAAcC,mBAAmB;AAC1C,SAASC,iBAAiB;AAC1B,SAASC,qBAAqB;AAQ9B,IAAA,4BAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AACvC,QAAMC,cAAcF,aAAaG,KAAYN,WAAWO,aAAa;AACrE,QAAMC,eAAeL,aAAaG,KAAYN,WAAWS,QAAQ;AAEjE,QAAMC,aAAa,OAAcC,WAAI;IACnCC,aAAaC,gBAAgB;MAC3BC,IAAI,GAAGC,KAAKD,EAAE;MACdE,OAAOC,YAAYC;MACnBC,SAAS,MACAC,eAAQ;QACb;UACEN,IAAIC,KAAKD;UACTO,MAAM,MAAMC,UAAUC,OAAOC,kBAAkBC,MAAM,CAAC,CAAA;UACtDC,YAAY;YACVC,OAAO;cAAC;cAAuB;gBAAEC,IAAIb,KAAKD;cAAG;;YAC7Ce,MAAM;YACNC,aAAa;YACbC,YAAY;cACVC,OAAO;cACPC,SAAS;YACX;UACF;QACF;OACD;IACL,CAAA;IACArB,aAAaC,gBAAgB;MAC3BC,IAAI,GAAGC,KAAKD,EAAE;MACdE,OAAOC,YAAYC;MACnBgB,WAAW,MACFd,eAAQ;QACb;UACEN,IAAIqB;UACJC,MAAMrB,KAAKD;UACXY,YAAY;YACVC,OAAO;cAAC;cAAsB;gBAAEC,IAAIb,KAAKD;cAAG;;YAC5Ce,MAAM;YACNC,aAAa;YACbO,UAAU;YACVC,QAAQ;UACV;QACF;OACD;IACL,CAAA;IACA1B,aAAaC,gBAAgB;MAC3BC,IAAI,GAAGC,KAAKD,EAAE;MACdE,OAAOC,YAAYsB,OAAOJ,WAAAA;MAC1BD,WAAW,CAACM,MAAMC,QAAAA;AAChB,cAAM,CAACC,OAAAA,IAAWD,IAAIpC,WAAAA;AACtB,cAAMsC,cAAcF,IAAIjC,YAAAA;AACxB,eAAcY,eAAQ;aACjBsB,QACAE,WAAU,EACVC,OAAO,CAACC,WAA0BJ,QAAQK,QAAO,EAAGC,SAASF,OAAO/B,KAAKD,EAAE,CAAA,EAC3EmC,IAAI,CAACH,WAAAA;AACJ,kBAAMI,WAAWP,YAAYQ,KAAK,CAACC,MAAMA,EAAEC,WAAWP,OAAO/B,KAAKD,EAAE;AACpE,gBAAI,CAACoC,UAAU;AACb,qBAAO;YACT;AAEA,mBAAO;cAACJ,OAAO/B;cAAMmC;;UACvB,CAAA,EACCL,OAAOS,aAAAA,EACPL,IAAI,CAAC,CAAClC,OAAMmC,QAAAA,OAA0D;YACrEpC,IAAI,GAAGyC,YAAAA,IAAgBxC,MAAKD,GAAG0C,WAAW,KAAK,GAAA,CAAA;YAC/CpB,MAAM;YACNf,MAAM6B;YACNxB,YAAY;cACVC,OAAOZ,MAAK0C,QAAQ1C,MAAKD;cACzBe,MAAMd,MAAKc,QAAQ;YACrB;UACF,EAAA;UAEF;YACEf,IAAI,GAAGyC,YAAAA;YACPnB,MAAM;YACNV,YAAY;cACVC,OAAO;gBAAC;gBAAwB;kBAAEC,IAAIb,KAAKD;gBAAG;;cAC9Ce,MAAM;cACN6B,MAAM;cACN5B,aAAa;YACf;UACF;SACD;MACH;IACF,CAAA;IACAlB,aAAaC,gBAAgB;MAC3BC,IAAI,GAAGC,KAAKD,EAAE;MACdE,OAAOC,YAAYsB,OAAO,GAAGgB,YAAAA,iBAA6B;MAC1DrB,WAAW,CAACM,MAAMC,QAAAA;AAChB,cAAM,CAACC,OAAAA,IAAWD,IAAIpC,WAAAA;AACtB,cAAMsC,cAAcF,IAAIjC,YAAAA;AACxB,eAAcY,eACZsB,QACGE,WAAU,EACVC,OAAO,CAACC,WAA0B,CAACJ,QAAQK,QAAO,EAAGC,SAASF,OAAO/B,KAAKD,EAAE,CAAA,EAC5EmC,IAAI,CAACH,WAAAA;AACJ,gBAAMI,WAAWP,YAAYQ,KAAK,CAACC,MAAMA,EAAEC,WAAWP,OAAO/B,KAAKD,EAAE;AACpE,cAAI,CAACoC,UAAU;AACb,mBAAO;UACT;AAEA,iBAAO;YAACJ,OAAO/B;YAAMmC;;QACvB,CAAA,EACCL,OAAOS,aAAAA,EACPL,IAAI,CAAC,CAAClC,OAAMmC,QAAAA,OAA0D;UACrEpC,IAAI,GAAGyC,YAAAA,IAAgBxC,MAAKD,GAAG0C,WAAW,KAAK,GAAA,CAAA;UAC/CpB,MAAM;UACNf,MAAM6B;UACNxB,YAAY;YACVC,OAAOZ,MAAK0C,QAAQ1C,MAAKD;YACzBe,MAAMd,MAAKc,QAAQ;UACrB;QACF,EAAA,CAAA;MAEN;IACF,CAAA;GACD;AAED,SAAO7B,mBAAW2D,YAAmB3D,WAAW4D,iBAAiBlD,UAAAA;AACnE,CAAA,CAAA;",
+  "names": ["Effect", "GraphBuilder", "NodeMatcher", "Operation", "isNonNullable", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "managerAtom", "atom", "PluginManager", "settingsAtom", "Settings", "extensions", "all", "GraphBuilder", "createExtension", "id", "meta", "match", "NodeMatcher", "whenRoot", "actions", "succeed", "data", "Operation", "invoke", "SettingsOperation", "Open", "properties", "label", "ns", "icon", "disposition", "keyBinding", "macos", "windows", "connector", "SETTINGS_ID", "type", "position", "testId", "whenId", "node", "get", "manager", "allSettings", "getPlugins", "filter", "plugin", "getCore", "includes", "map", "settings", "find", "s", "prefix", "isNonNullable", "SETTINGS_KEY", "replaceAll", "name", "role", "contributes", "AppGraphBuilder"]
+}

package/dist/lib/browser/capability-7PCNSWBT.mjs

@@ -0,0 +1,33 @@
+import {
+  ActivationEvent,
+  Capability
+} from "./chunk-BLQJSGL3.mjs";
+import "./chunk-FMZN33N4.mjs";
+import "./chunk-PKQT6C53.mjs";
+import {
+  plugin_exports
+} from "./chunk-TCLLRCS3.mjs";
+import {
+  capability_exports
+} from "./chunk-6Y7PZV72.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-runtime/capability.ts
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ManagedRuntime from "effect/ManagedRuntime";
+var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilityManager = yield* capability_exports.Service;
+  const pluginManager = yield* plugin_exports.Service;
+  yield* plugin_exports.activate(ActivationEvent.SetupLayer);
+  const layers = yield* capability_exports.getAll(Capability.Layer);
+  const capabilityServiceLayer = Layer.succeed(capability_exports.Service, capabilityManager);
+  const pluginServiceLayer = Layer.succeed(plugin_exports.Service, pluginManager);
+  const composedLayer = layers.length > 0 ? Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer, ...layers) : Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer);
+  const runtime = ManagedRuntime.make(composedLayer);
+  return capability_exports.contributes(Capability.ManagedRuntime, runtime);
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-7PCNSWBT.mjs.map

package/dist/lib/browser/capability-7PCNSWBT.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-runtime/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport * as Common from '../common';\nimport { Capability, Plugin } from '../core';\n\n//\n// Capability Module\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the CapabilityManager to create a layer for it.\n    const capabilityManager = yield* Capability.Service;\n\n    // Get the PluginManager to create a layer for it.\n    const pluginManager = yield* Plugin.Service;\n\n    // Trigger setup event so plugins can contribute their layers.\n    yield* Plugin.activate(Common.ActivationEvent.SetupLayer);\n\n    // Gather all contributed layers.\n    const layers = yield* Capability.getAll(Common.Capability.Layer);\n\n    // Create layers that provide Capability.Service and Plugin.Service.\n    const capabilityServiceLayer = Layer.succeed(Capability.Service, capabilityManager);\n    const pluginServiceLayer = Layer.succeed(Plugin.Service, pluginManager);\n\n    // Merge all layers including service layers.\n    // Layer.mergeAll requires a tuple type, so we use a cast for dynamic arrays.\n    const composedLayer =\n      layers.length > 0\n        ? (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n            ...layers,\n          )\n        : (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n          );\n\n    // Create the managed runtime from the composed layer.\n    const runtime = ManagedRuntime.make(composedLayer) as Common.Capability.ManagedRuntime;\n\n    return Capability.contributes(Common.Capability.ManagedRuntime, runtime);\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AACxB,YAAYC,WAAW;AACvB,YAAYC,oBAAoB;AAShC,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,oBAAoB,OAAOH,mBAAWI;AAG5C,QAAMC,gBAAgB,OAAOC,eAAOF;AAGpC,SAAOE,eAAOC,SAAgBC,gBAAgBC,UAAU;AAGxD,QAAMC,SAAS,OAAOV,mBAAWW,OAAcX,WAAWY,KAAK;AAG/D,QAAMC,yBAA+BC,cAAQd,mBAAWI,SAASD,iBAAAA;AACjE,QAAMY,qBAA2BD,cAAQR,eAAOF,SAASC,aAAAA;AAIzD,QAAMW,gBACJN,OAAOO,SAAS,IACLC,eACLL,wBACAE,oBAAAA,GACGL,MAAAA,IAEEQ,eACLL,wBACAE,kBAAAA;AAIR,QAAMI,UAAyBC,oBAAKJ,aAAAA;AAEpC,SAAOhB,mBAAWqB,YAAmBrB,WAAWsB,gBAAgBH,OAAAA;AAClE,CAAA,CAAA;",
+  "names": ["Effect", "Layer", "ManagedRuntime", "Capability", "makeModule", "fnUntraced", "capabilityManager", "Service", "pluginManager", "Plugin", "activate", "ActivationEvent", "SetupLayer", "layers", "getAll", "Layer", "capabilityServiceLayer", "succeed", "pluginServiceLayer", "composedLayer", "length", "mergeAll", "runtime", "make", "contributes", "ManagedRuntime"]
+}

package/dist/lib/browser/capability-KP3PFEXD.mjs

@@ -0,0 +1,31 @@
+import {
+  make,
+  make2
+} from "./chunk-7IQHKD4U.mjs";
+import {
+  Capability
+} from "./chunk-BLQJSGL3.mjs";
+import "./chunk-FMZN33N4.mjs";
+import "./chunk-PKQT6C53.mjs";
+import "./chunk-TCLLRCS3.mjs";
+import {
+  capability_exports
+} from "./chunk-6Y7PZV72.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-operation/history/capability.ts
+import * as Effect from "effect/Effect";
+var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilities = yield* capability_exports.Service;
+  const undoRegistry = make(() => capabilities.getAll(Capability.UndoMapping).flat());
+  const invoker = yield* capability_exports.get(Capability.OperationInvoker);
+  const historyTracker = make2(invoker, undoRegistry);
+  return [
+    capability_exports.contributes(Capability.UndoRegistry, undoRegistry),
+    capability_exports.contributes(Capability.HistoryTracker, historyTracker)
+  ];
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-KP3PFEXD.mjs.map

package/dist/lib/browser/capability-KP3PFEXD.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-operation/history/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { type OperationInvoker } from '@dxos/operation';\n\nimport * as Common from '../../common';\nimport { Capability } from '../../core';\n\nimport * as HistoryTracker from './history-tracker';\nimport * as UndoRegistry from './undo-registry';\n\n//\n// Capability Module - contributes both UndoRegistry and HistoryTracker.\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the context for synchronous access in callbacks.\n    const capabilities = yield* Capability.Service;\n\n    // Create UndoRegistry.\n    const undoRegistry = UndoRegistry.make(() => capabilities.getAll(Common.Capability.UndoMapping).flat());\n\n    // Create HistoryTracker (depends on UndoRegistry and OperationInvoker).\n    const invoker = yield* Capability.get(Common.Capability.OperationInvoker);\n    // Cast to internal type - the factory always returns OperationInvokerInternal.\n    const historyTracker = HistoryTracker.make(invoker as OperationInvoker.OperationInvokerInternal, undoRegistry);\n\n    return [\n      Capability.contributes(Common.Capability.UndoRegistry, undoRegistry),\n      Capability.contributes(Common.Capability.HistoryTracker, historyTracker),\n    ];\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAcxB,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AAGvC,QAAMC,eAA4BC,KAAK,MAAMH,aAAaI,OAAcP,WAAWQ,WAAW,EAAEC,KAAI,CAAA;AAGpG,QAAMC,UAAU,OAAOV,mBAAWW,IAAWX,WAAWY,gBAAgB;AAExE,QAAMC,iBAAgCP,MAAKI,SAAsDL,YAAAA;AAEjG,SAAO;IACLL,mBAAWc,YAAmBd,WAAWe,cAAcV,YAAAA;IACvDL,mBAAWc,YAAmBd,WAAWgB,gBAAgBH,cAAAA;;AAE7D,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "undoRegistry", "make", "getAll", "UndoMapping", "flat", "invoker", "get", "OperationInvoker", "historyTracker", "contributes", "UndoRegistry", "HistoryTracker"]
+}

package/dist/lib/browser/chunk-6Y7PZV72.mjs

@@ -0,0 +1,77 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/capability.ts
+var capability_exports = {};
+__export(capability_exports, {
+  ModuleTag: () => ModuleTag,
+  Service: () => Service,
+  atom: () => atom,
+  contributes: () => contributes,
+  get: () => get,
+  getAll: () => getAll,
+  getModuleTag: () => getModuleTag,
+  lazy: () => lazy,
+  make: () => make,
+  makeModule: () => makeModule,
+  waitFor: () => waitFor
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+var Service = class extends Context.Tag("@dxos/app-framework/CapabilityManager")() {
+};
+var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
+  try: () => manager.get(interfaceDef),
+  catch: (error) => error instanceof Error ? error : new Error(String(error))
+}));
+var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(interfaceDef));
+var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
+var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
+var InterfaceDefTypeId = Symbol.for("InterfaceDefTypeId");
+var ModuleTag = Symbol.for("@dxos/app-framework/ModuleTag");
+var make = (identifier) => {
+  return {
+    identifier
+  };
+};
+var contributes = (interfaceDef, implementation, deactivate) => {
+  return {
+    interface: interfaceDef,
+    implementation,
+    deactivate
+  };
+};
+var lazy = (name, c) => {
+  const lazyFn = (props) => Effect.gen(function* () {
+    const { default: getCapability } = yield* Effect.tryPromise(() => c());
+    const result = yield* getCapability(props);
+    const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [
+      result
+    ];
+    return normalized;
+  });
+  return Object.assign(lazyFn, {
+    [ModuleTag]: name
+  });
+};
+var getModuleTag = (capability) => {
+  return capability && typeof capability === "function" && ModuleTag in capability ? String(capability[ModuleTag]) : void 0;
+};
+var makeModule = (fn) => fn;
+
+export {
+  Service,
+  get,
+  getAll,
+  waitFor,
+  atom,
+  ModuleTag,
+  make,
+  contributes,
+  lazy,
+  getModuleTag,
+  makeModule,
+  capability_exports
+};
+//# sourceMappingURL=chunk-6Y7PZV72.mjs.map

package/dist/lib/browser/chunk-6Y7PZV72.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\n\nimport type * as CapabilityManager from './capability-manager';\nimport type * as Plugin from './plugin';\n\n//\n// Capability Service Layer\n//\n\n/**\n * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.\n * This allows capability modules to access the capability manager without having it passed as an argument.\n */\nexport class Service extends Context.Tag('@dxos/app-framework/CapabilityManager')<\n  Service,\n  CapabilityManager.CapabilityManager\n>() {}\n\n/**\n * Get a single capability from the capability manager.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation.\n * @throws If no capability is found.\n */\n// TODO(wittjosiah): Add custom tagged errors (Data.TaggedError) for app-framework to enable\n//   type-safe error handling with Effect. Consider CapabilityNotFoundError, ModuleActivationError, etc.\nexport const get = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) =>\n    Effect.try({\n      try: () => manager.get(interfaceDef),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }),\n  );\n\n/**\n * Get all capabilities from the capability manager for a given interface.\n * @param interfaceDef The interface definition of the capability.\n * @returns An array of capability implementations.\n */\nexport const getAll = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T[], never, Service> =>\n  Effect.map(Service, (manager) => manager.getAll(interfaceDef));\n\n/**\n * Wait for a capability to be available.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation once available.\n */\nexport const waitFor = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));\n\n/**\n * Get the Atom reference to capabilities for reactive access.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing the array of capability implementations.\n */\nexport const atom = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<Atom.Atom<T[]>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atom(interfaceDef));\n\nconst InterfaceDefTypeId: unique symbol = Symbol.for('InterfaceDefTypeId');\n\n/**\n * Symbol used to tag lazy capability functions with their module ID.\n */\nexport const ModuleTag: unique symbol = Symbol.for('@dxos/app-framework/ModuleTag');\n\n/**\n * The interface definition of a capability.\n */\nexport type InterfaceDef<T> = {\n  [InterfaceDefTypeId]: T;\n  identifier: string;\n};\n\nexport namespace InterfaceDef {\n  export type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;\n}\n\n/**\n * Helper to define the interface of a capability.\n */\nexport const make = <T>(identifier: string) => {\n  return { identifier } as InterfaceDef<T>;\n};\n\n/**\n * A unique string identifier with a Typescript type associated with it.\n * When a capability is contributed to the application an implementation of the interface is provided.\n */\nexport type Capability<T> = {\n  /**\n   * The interface definition of the capability.\n   */\n  readonly interface: InterfaceDef<T>;\n\n  /**\n   * The implementation of the capability.\n   */\n  readonly implementation: T;\n\n  /**\n   * Called when the capability is deactivated.\n   */\n  readonly deactivate?: () => Effect.Effect<void, Error>;\n};\n\nexport type Any = Capability<any>;\n\n/**\n * Union type representing all valid return types for a capability module.\n * Supports single capabilities, arrays, and tuples of different capability types.\n */\nexport type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];\n\n/**\n * Helper to define the implementation of a capability.\n */\nexport const contributes = <I extends InterfaceDef<any>>(\n  interfaceDef: I,\n  implementation: Capability<InterfaceDef.Implementation<I>>['implementation'],\n  deactivate?: Capability<InterfaceDef.Implementation<I>>['deactivate'],\n): Capability<I> => {\n  return {\n    interface: interfaceDef,\n    implementation,\n    deactivate,\n  } satisfies Capability<I>;\n};\n\ntype LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props?: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\ntype LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props?: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\n\ntype NormalizeReturn<R> = R extends readonly (infer A)[]\n  ? A[]\n  : R extends (infer A)[]\n    ? A[]\n    : R extends Any\n      ? [R]\n      : Any[];\n\nexport type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (\n  props?: Props,\n) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;\n\n/**\n * Helper to define a lazily loaded implementation of a capability.\n * Supports single capabilities, arrays, and tuples of different capability types.\n * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.\n * @param loader The lazy loader function.\n * @returns A lazy capability function with ModuleTag symbol attached.\n */\nexport const lazy = <T = void, R extends ModuleReturn = ModuleReturn>(\n  name: string,\n  c: LoadCapability<T, R> | LoadCapabilities<T, R>,\n): LazyCapability<T, R> => {\n  const lazyFn: LazyCapability<T, R> = (props?: T) =>\n    Effect.gen(function* () {\n      const { default: getCapability } = yield* Effect.tryPromise(() => c());\n      const result = yield* getCapability(props);\n      const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [result];\n      return normalized as NormalizeReturn<R>;\n    });\n\n  return Object.assign(lazyFn, { [ModuleTag]: name });\n};\n\n/**\n * Gets the module tag (export name) from a lazy capability function.\n * @param capability The lazy capability function.\n * @returns The module tag if present, undefined otherwise.\n */\n// TODO(wittjosiah): Stricter type for capability.\nexport const getModuleTag = (capability: unknown): string | undefined => {\n  return capability && typeof capability === 'function' && ModuleTag in capability\n    ? String(capability[ModuleTag])\n    : undefined;\n};\n\n/**\n * Helper to define a capability module with explicit typing.\n * Wraps the default export function to provide better type inference and make the pattern explicit.\n *\n * This helper provides explicit typing for the module activation function,\n * making it clear that the function should:\n * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)\n * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)\n *\n * Supports returning multiple capabilities of different types as a tuple, which will be normalized\n * to an array at runtime for compatibility with the plugin system.\n *\n * @example\n * ```ts\n * // Module without options - single capability\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     const client = yield* Capability.get(ClientCapabilities.Client);\n *     return contributes(Capabilities.SettingsStore, store);\n *   })\n * );\n *\n * // Module with multiple capabilities\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     return [\n *       contributes(Capabilities.SettingsStore, store),\n *       contributes(Capabilities.Translations, translations),\n *     ];\n *   })\n * );\n *\n * // Module with additional options (context accessed via layer)\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* ({ observability }: { observability?: boolean }) {\n *     const invoker = yield* Capability.get(Common.Capability.OperationInvoker);\n *     return contributes(Capabilities.IntentResolver, ...);\n *   })\n * );\n * ```\n */\nexport const makeModule = <\n  TProps = void,\n  TReturn extends ModuleReturn = ModuleReturn,\n  E extends Error = Error,\n  R extends Service | Plugin.Service | never = Service,\n>(\n  fn: (props?: TProps) => Effect.Effect<TReturn, E, R>,\n): ((props?: TProps) => Effect.Effect<TReturn, E, R>) => fn;\n"],
+  "mappings": ";;;;;AAAA;;;;;;;;;;;;;;AAKA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AAajB,IAAMC,UAAN,cAA8BC,YAAI,uCAAA,EAAA,EAAA;AAGpC;AAUE,IAAMC,MAAM,CAAIC,iBACdC,eAAQJ,SAAS,CAACK,YAChBC,WAAI;EACTA,KAAK,MAAMD,QAAQH,IAAIC,YAAAA;EACvBI,OAAO,CAACC,UAAWA,iBAAiBC,QAAQD,QAAQ,IAAIC,MAAMC,OAAOF,KAAAA,CAAAA;AACvE,CAAA,CAAA;AAQG,IAAMG,SAAS,CAAIR,iBACjBS,WAAIZ,SAAS,CAACK,YAAYA,QAAQM,OAAOR,YAAAA,CAAAA;AAO3C,IAAMU,UAAU,CAAIV,iBAClBC,eAAQJ,SAAS,CAACK,YAAYA,QAAQQ,QAAQV,YAAAA,CAAAA;AAOhD,IAAMW,OAAO,CAAIX,iBACfS,WAAIZ,SAAS,CAACK,YAAYA,QAAQS,KAAKX,YAAAA,CAAAA;AAEhD,IAAMY,qBAAoCC,OAAOC,IAAI,oBAAA;AAK9C,IAAMC,YAA2BF,OAAOC,IAAI,+BAAA;AAiB5C,IAAME,OAAO,CAAIC,eAAAA;AACtB,SAAO;IAAEA;EAAW;AACtB;AAkCO,IAAMC,cAAc,CACzBlB,cACAmB,gBACAC,eAAAA;AAEA,SAAO;IACLC,WAAWrB;IACXmB;IACAC;EACF;AACF;AA4BO,IAAME,OAAO,CAClBC,MACAC,MAAAA;AAEA,QAAMC,SAA+B,CAACC,UAC7BC,WAAI,aAAA;AACT,UAAM,EAAEC,SAASC,cAAa,IAAK,OAAcC,kBAAW,MAAMN,EAAAA,CAAAA;AAClE,UAAMO,SAAS,OAAOF,cAAcH,KAAAA;AACpC,UAAMM,aAAaD,UAAU,OAAO,CAAA,IAAKE,MAAMC,QAAQH,MAAAA,IAAUE,MAAME,KAAKJ,MAAAA,IAAU;MAACA;;AACvF,WAAOC;EACT,CAAA;AAEF,SAAOI,OAAOC,OAAOZ,QAAQ;IAAE,CAACV,SAAAA,GAAYQ;EAAK,CAAA;AACnD;AAQO,IAAMe,eAAe,CAACC,eAAAA;AAC3B,SAAOA,cAAc,OAAOA,eAAe,cAAcxB,aAAawB,aAClEhC,OAAOgC,WAAWxB,SAAAA,CAAU,IAC5ByB;AACN;AA2CO,IAAMC,aAAa,CAMxBC,OACuDA;",
+  "names": ["Context", "Effect", "Service", "Tag", "get", "interfaceDef", "flatMap", "manager", "try", "catch", "error", "Error", "String", "getAll", "map", "waitFor", "atom", "InterfaceDefTypeId", "Symbol", "for", "ModuleTag", "make", "identifier", "contributes", "implementation", "deactivate", "interface", "lazy", "name", "c", "lazyFn", "props", "gen", "default", "getCapability", "tryPromise", "result", "normalized", "Array", "isArray", "from", "Object", "assign", "getModuleTag", "capability", "undefined", "makeModule", "fn"]
+}

package/dist/lib/browser/chunk-7IQHKD4U.mjs

@@ -0,0 +1,170 @@
+import {
+  UndoOperation
+} from "./chunk-BLQJSGL3.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-operation/history/errors.ts
+import { OperationError } from "@dxos/operation";
+var EmptyHistoryError = class extends OperationError {
+  constructor() {
+    super("EMPTY_HISTORY", "Cannot undo: history is empty.");
+  }
+};
+
+// src/plugin-operation/history/undo-mapping.ts
+var undo_mapping_exports = {};
+__export(undo_mapping_exports, {
+  make: () => make,
+  resolveMessage: () => resolveMessage
+});
+var make = (props) => props;
+var resolveMessage = (message, input, output) => {
+  if (message === void 0) {
+    return void 0;
+  }
+  if (typeof message === "function") {
+    return message(input, output);
+  }
+  return message;
+};
+
+// src/plugin-operation/history/undo-registry.ts
+var undo_registry_exports = {};
+__export(undo_registry_exports, {
+  make: () => make2
+});
+var make2 = (getMappings) => {
+  const lookup = (operation) => {
+    const mappings = getMappings();
+    const mapping = mappings.find((m) => m.operation.meta.key === operation.meta.key);
+    if (!mapping) {
+      return void 0;
+    }
+    return {
+      inverse: mapping.inverse,
+      deriveContext: mapping.deriveContext,
+      message: mapping.message
+    };
+  };
+  return {
+    lookup
+  };
+};
+
+// src/plugin-operation/history/history-tracker.ts
+var history_tracker_exports = {};
+__export(history_tracker_exports, {
+  make: () => make3
+});
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import { runAndForwardErrors } from "@dxos/effect";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/plugin-operation/history/history-tracker.ts";
+var HISTORY_LIMIT = 100;
+var make3 = (invoker, undoRegistry) => {
+  const history = [];
+  const handleInvocation = (event) => {
+    const mapping = undoRegistry.lookup(event.operation);
+    if (!mapping) {
+      return;
+    }
+    const inverseInput = mapping.deriveContext(event.input, event.output);
+    if (inverseInput === void 0) {
+      log("operation not undoable", {
+        key: event.operation.meta.key
+      }, {
+        F: __dxlog_file,
+        L: 58,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+      return;
+    }
+    const entry = {
+      operation: event.operation,
+      input: event.input,
+      output: event.output,
+      inverse: mapping.inverse,
+      inverseInput,
+      timestamp: event.timestamp
+    };
+    history.push(entry);
+    log("history entry added", {
+      key: event.operation.meta.key,
+      historyLength: history.length
+    }, {
+      F: __dxlog_file,
+      L: 72,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    if (history.length > HISTORY_LIMIT) {
+      history.splice(0, history.length - HISTORY_LIMIT);
+    }
+    const resolvedMessage = resolveMessage(mapping.message, event.input, event.output);
+    Effect.runFork(invoker.invoke(UndoOperation.ShowUndo, {
+      message: resolvedMessage
+    }));
+  };
+  Effect.runFork(Stream.fromPubSub(invoker.invocations).pipe(Stream.runForEach((event) => Effect.sync(() => handleInvocation(event)))));
+  const undo = () => {
+    return Effect.gen(function* () {
+      const entry = history.pop();
+      if (!entry) {
+        return yield* Effect.fail(new EmptyHistoryError());
+      }
+      log("undoing operation", {
+        key: entry.operation.meta.key,
+        inverseKey: entry.inverse.meta.key
+      }, {
+        F: __dxlog_file,
+        L: 102,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      yield* invoker._invokeCore(entry.inverse, entry.inverseInput);
+      log("undo completed", {
+        key: entry.operation.meta.key
+      }, {
+        F: __dxlog_file,
+        L: 107,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+    });
+  };
+  const undoPromise = async () => {
+    return runAndForwardErrors(undo()).then(() => ({})).catch((error) => {
+      log.catch(error, void 0, {
+        F: __dxlog_file,
+        L: 115,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+      return {
+        error
+      };
+    });
+  };
+  const canUndo = () => {
+    return history.length > 0;
+  };
+  return {
+    undo,
+    undoPromise,
+    canUndo
+  };
+};
+
+export {
+  EmptyHistoryError,
+  undo_mapping_exports,
+  make2 as make,
+  undo_registry_exports,
+  make3 as make2,
+  history_tracker_exports
+};
+//# sourceMappingURL=chunk-7IQHKD4U.mjs.map

package/dist/lib/browser/chunk-7IQHKD4U.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-operation/history/errors.ts", "../../../src/plugin-operation/history/undo-mapping.ts", "../../../src/plugin-operation/history/undo-registry.ts", "../../../src/plugin-operation/history/history-tracker.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { OperationError } from '@dxos/operation';\n\nexport class EmptyHistoryError extends OperationError {\n  constructor() {\n    super('EMPTY_HISTORY', 'Cannot undo: history is empty.');\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type { Operation } from '@dxos/operation';\n\nimport type { Label } from '../../common/translations';\n\n/**\n * Extract the input type from an OperationDefinition.\n */\nexport type InputOf<T> = T extends Operation.Definition<infer I, any> ? I : never;\n\n/**\n * Extract the output type from an OperationDefinition.\n */\nexport type OutputOf<T> = T extends Operation.Definition<any, infer O> ? O : never;\n\n/**\n * Message provider for undo toast.\n * Can be a static Label or a function that derives the message from input/output.\n */\nexport type MessageProvider<Op extends Operation.Definition<any, any>> =\n  | Label\n  | ((input: InputOf<Op>, output: OutputOf<Op>) => Label);\n\n/**\n * Undo mapping that links a forward operation to its inverse.\n * Type parameters ensure deriveContext has correctly typed arguments.\n *\n * @template Op - The forward operation definition type.\n * @template Inv - The inverse operation definition type.\n */\nexport interface UndoMapping<\n  Op extends Operation.Definition<any, any> = Operation.Definition<any, any>,\n  Inv extends Operation.Definition<any, any> = Operation.Definition<any, any>,\n> {\n  /** The forward operation. */\n  readonly operation: Op;\n\n  /** The inverse operation to invoke for undo. */\n  readonly inverse: Inv;\n\n  /**\n   * Derives the input for the inverse operation from the forward operation's input and output.\n   * @param input - The input that was passed to the forward operation.\n   * @param output - The output that was returned by the forward operation.\n   * @returns The input to pass to the inverse operation, or undefined to indicate the operation is not undoable.\n   */\n  readonly deriveContext: (input: InputOf<Op>, output: OutputOf<Op>) => InputOf<Inv> | undefined;\n\n  /**\n   * Optional message to show in the undo toast.\n   * Can be a static Label or a function that derives the message from input/output.\n   */\n  readonly message?: MessageProvider<Op>;\n}\n\n/**\n * Props for creating an UndoMapping.\n */\nexport interface UndoMappingProps<\n  Op extends Operation.Definition<any, any>,\n  Inv extends Operation.Definition<any, any>,\n> {\n  /** The forward operation. */\n  operation: Op;\n\n  /** The inverse operation to invoke for undo. */\n  inverse: Inv;\n\n  /**\n   * Derives the input for the inverse operation from the forward operation's input and output.\n   * Return undefined to indicate the operation is not undoable.\n   */\n  deriveContext: (input: InputOf<Op>, output: OutputOf<Op>) => InputOf<Inv> | undefined;\n\n  /**\n   * Optional message to show in the undo toast.\n   * Can be a static Label or a function that derives the message from input/output.\n   */\n  message?: MessageProvider<Op>;\n}\n\n/**\n * Creates a type-safe undo mapping.\n *\n * @example\n * ```ts\n * // Static message\n * const mapping = UndoMapping.make({\n *   operation: DeleteThread,\n *   inverse: RestoreThread,\n *   deriveContext: (input, output) => ({\n *     thread: output.thread,\n *     anchor: output.anchor,\n *   }),\n *   message: ['thread deleted label', { ns: 'plugin-thread' }],\n * });\n *\n * // Dynamic message based on input/output\n * const mapping = UndoMapping.make({\n *   operation: RemoveObjects,\n *   inverse: RestoreObjects,\n *   deriveContext: (_input, output) => output,\n *   message: (input, _output) =>\n *     input.objects.length === 1\n *       ? ['object deleted label', { ns: getTypename(input.objects[0]) }]\n *       : ['objects deleted label', { ns: 'plugin-space' }],\n * });\n * ```\n */\nexport const make = <Op extends Operation.Definition<any, any>, Inv extends Operation.Definition<any, any>>(\n  props: UndoMappingProps<Op, Inv>,\n): UndoMapping<Op, Inv> => props;\n\n/**\n * Resolves a message provider to a Label.\n */\nexport const resolveMessage = <Op extends Operation.Definition<any, any>>(\n  message: MessageProvider<Op> | undefined,\n  input: InputOf<Op>,\n  output: OutputOf<Op>,\n): Label | undefined => {\n  if (message === undefined) {\n    return undefined;\n  }\n  if (typeof message === 'function') {\n    return message(input, output);\n  }\n  return message;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type { Operation } from '@dxos/operation';\n\nimport type * as UndoMapping from './undo-mapping';\n\n//\n// Public Interface\n//\n\n/**\n * Lookup result from UndoRegistry.\n */\nexport type UndoMappingResult = {\n  inverse: Operation.Definition<any, any>;\n  /** Returns undefined to indicate the operation is not undoable. */\n  deriveContext: (input: any, output: any) => any | undefined;\n  /** Message provider - may be a static Label or a function. */\n  message?: UndoMapping.MessageProvider<Operation.Definition<any, any>>;\n};\n\n/**\n * UndoRegistry interface - looks up inverse operations.\n */\nexport interface UndoRegistry {\n  lookup: (operation: Operation.Definition<any, any>) => UndoMappingResult | undefined;\n}\n\n//\n// Factory\n//\n\n/**\n * Creates an UndoRegistry that looks up inverse operations.\n */\nexport const make = (getMappings: () => UndoMapping.UndoMapping[]): UndoRegistry => {\n  const lookup = (operation: Operation.Definition<any, any>): UndoMappingResult | undefined => {\n    const mappings = getMappings();\n    const mapping = mappings.find((m) => m.operation.meta.key === operation.meta.key);\n    if (!mapping) {\n      return undefined;\n    }\n\n    return {\n      inverse: mapping.inverse,\n      deriveContext: mapping.deriveContext,\n      message: mapping.message,\n    };\n  };\n\n  return { lookup };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Stream from 'effect/Stream';\n\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { log } from '@dxos/log';\nimport { type OperationInvoker } from '@dxos/operation';\n\nimport { UndoOperation } from '../../common';\n\nimport { EmptyHistoryError } from './errors';\nimport type { HistoryEntry } from './types';\nimport { resolveMessage } from './undo-mapping';\nimport type { UndoRegistry } from './undo-registry';\n\nconst HISTORY_LIMIT = 100;\n\n//\n// Public Interface\n//\n\n/**\n * HistoryTracker interface - tracks operation history and provides undo.\n */\nexport interface HistoryTracker {\n  undo: () => Effect.Effect<void, Error>;\n  undoPromise: () => Promise<{ error?: Error }>;\n  canUndo: () => boolean;\n}\n\n//\n// Factory\n//\n\n/**\n * Creates a HistoryTracker that subscribes to invocation events and provides undo.\n */\nexport const make = (\n  invoker: OperationInvoker.OperationInvokerInternal,\n  undoRegistry: UndoRegistry,\n): HistoryTracker => {\n  const history: HistoryEntry[] = [];\n\n  // Subscribe to invocation stream.\n  const handleInvocation = (event: OperationInvoker.InvocationEvent) => {\n    const mapping = undoRegistry.lookup(event.operation);\n    if (!mapping) {\n      // Operation is not undoable, skip.\n      return;\n    }\n\n    const inverseInput = mapping.deriveContext(event.input, event.output);\n    if (inverseInput === undefined) {\n      // Operation is conditionally not undoable (deriveContext returned undefined).\n      log('operation not undoable', { key: event.operation.meta.key });\n      return;\n    }\n\n    const entry: HistoryEntry = {\n      operation: event.operation,\n      input: event.input,\n      output: event.output,\n      inverse: mapping.inverse,\n      inverseInput,\n      timestamp: event.timestamp,\n    };\n\n    history.push(entry);\n    log('history entry added', { key: event.operation.meta.key, historyLength: history.length });\n\n    // Trim history if it exceeds limit.\n    if (history.length > HISTORY_LIMIT) {\n      history.splice(0, history.length - HISTORY_LIMIT);\n    }\n\n    // Show undo toast (resolve message if it's a function).\n    const resolvedMessage = resolveMessage(mapping.message, event.input, event.output);\n    Effect.runFork(\n      invoker.invoke(UndoOperation.ShowUndo, {\n        message: resolvedMessage,\n      }),\n    );\n  };\n\n  // Fork a fiber to consume the invocation stream.\n  Effect.runFork(\n    Stream.fromPubSub(invoker.invocations).pipe(\n      Stream.runForEach((event) => Effect.sync(() => handleInvocation(event))),\n    ),\n  );\n\n  const undo = (): Effect.Effect<void, Error> => {\n    return Effect.gen(function* () {\n      const entry = history.pop();\n      if (!entry) {\n        return yield* Effect.fail(new EmptyHistoryError());\n      }\n\n      log('undoing operation', { key: entry.operation.meta.key, inverseKey: entry.inverse.meta.key });\n\n      // Use _invokeCore to skip event emission (avoid undo-of-undo loops).\n      yield* invoker._invokeCore(entry.inverse, entry.inverseInput);\n\n      log('undo completed', { key: entry.operation.meta.key });\n    });\n  };\n\n  const undoPromise = async (): Promise<{ error?: Error }> => {\n    return runAndForwardErrors(undo())\n      .then(() => ({}))\n      .catch((error) => {\n        log.catch(error);\n        return { error };\n      });\n  };\n\n  const canUndo = (): boolean => {\n    return history.length > 0;\n  };\n\n  return {\n    undo,\n    undoPromise,\n    canUndo,\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["OperationError", "EmptyHistoryError", "OperationError", "make", "props", "resolveMessage", "message", "input", "output", "undefined", "make", "make", "getMappings", "lookup", "operation", "mappings", "mapping", "find", "m", "meta", "key", "undefined", "inverse", "deriveContext", "message", "make", "Effect", "Stream", "runAndForwardErrors", "log", "HISTORY_LIMIT", "make", "invoker", "undoRegistry", "history", "handleInvocation", "event", "mapping", "lookup", "operation", "inverseInput", "deriveContext", "input", "output", "undefined", "log", "key", "meta", "entry", "inverse", "timestamp", "push", "historyLength", "length", "splice", "resolvedMessage", "resolveMessage", "message", "Effect", "runFork", "invoke", "UndoOperation", "ShowUndo", "fromPubSub", "invocations", "pipe", "runForEach", "sync", "undo", "gen", "pop", "fail", "EmptyHistoryError", "inverseKey", "_invokeCore", "undoPromise", "runAndForwardErrors", "then", "catch", "error", "canUndo"]
+}