@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fcc0d83b33

package/.storybook/main.mts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { createConfig } from '../../../../tools/storybook-react/.storybook/main';
+
+export const stories = ['../src/**/*.stories.tsx'];
+
+export default createConfig({ stories });

package/.storybook/preview.mts

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

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

@@ -0,0 +1,38 @@
+import "./chunk-5GNRIKCE.mjs";
+import {
+  capabilities_exports
+} from "./chunk-2F5RSEOR.mjs";
+import {
+  activation_events_exports
+} from "./chunk-45CHLTBV.mjs";
+import "./chunk-G7SDBRKH.mjs";
+import "./chunk-UNGY3SDY.mjs";
+import "./chunk-2FUSTGNO.mjs";
+import "./chunk-66IXTIVK.mjs";
+import {
+  plugin_exports
+} from "./chunk-GUJTQEK7.mjs";
+import {
+  capability_exports
+} from "./chunk-TZGMTFCT.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(activation_events_exports.SetupLayer);
+  const layers = yield* capability_exports.getAll(capabilities_exports.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(capabilities_exports.ManagedRuntime, runtime);
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-FU2RXY4V.mjs.map

package/dist/lib/browser/capability-FU2RXY4V.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 { ActivationEvents, Capabilities } 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(ActivationEvents.SetupLayer);\n\n    // Gather all contributed layers.\n    const layers = yield* Capability.getAll(Capabilities.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 Capabilities.ManagedRuntime;\n\n    return Capability.contributes(Capabilities.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,SAASC,0BAAiBC,UAAU;AAGlD,QAAMC,SAAS,OAAOV,mBAAWW,OAAOC,qBAAaC,KAAK;AAG1D,QAAMC,yBAA+BC,cAAQf,mBAAWI,SAASD,iBAAAA;AACjE,QAAMa,qBAA2BD,cAAQT,eAAOF,SAASC,aAAAA;AAIzD,QAAMY,gBACJP,OAAOQ,SAAS,IACLC,eACLL,wBACAE,oBAAAA,GACGN,MAAAA,IAEES,eACLL,wBACAE,kBAAAA;AAIR,QAAMI,UAAyBC,oBAAKJ,aAAAA;AAEpC,SAAOjB,mBAAWsB,YAAYV,qBAAaW,gBAAgBH,OAAAA;AAC7D,CAAA,CAAA;",
+  "names": ["Effect", "Layer", "ManagedRuntime", "Capability", "makeModule", "fnUntraced", "capabilityManager", "Service", "pluginManager", "Plugin", "activate", "ActivationEvents", "SetupLayer", "layers", "getAll", "Capabilities", "Layer", "capabilityServiceLayer", "succeed", "pluginServiceLayer", "composedLayer", "length", "mergeAll", "runtime", "make", "contributes", "ManagedRuntime"]
+}

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

@@ -0,0 +1,35 @@
+import {
+  make,
+  make2
+} from "./chunk-EV4VOV4X.mjs";
+import "./chunk-5GNRIKCE.mjs";
+import {
+  capabilities_exports
+} from "./chunk-2F5RSEOR.mjs";
+import "./chunk-45CHLTBV.mjs";
+import "./chunk-G7SDBRKH.mjs";
+import "./chunk-UNGY3SDY.mjs";
+import "./chunk-2FUSTGNO.mjs";
+import "./chunk-66IXTIVK.mjs";
+import "./chunk-GUJTQEK7.mjs";
+import {
+  capability_exports
+} from "./chunk-TZGMTFCT.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(capabilities_exports.UndoMapping).flat());
+  const invoker = yield* capability_exports.get(capabilities_exports.OperationInvoker);
+  const historyTracker = make2(invoker, undoRegistry);
+  return [
+    capability_exports.contributes(capabilities_exports.UndoRegistry, undoRegistry),
+    capability_exports.contributes(capabilities_exports.HistoryTracker, historyTracker)
+  ];
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-UZNIX34E.mjs.map

package/dist/lib/browser/capability-UZNIX34E.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/compute';\n\nimport { Capabilities } from '../../common';\nimport { Capability } from '../../core';\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(Capabilities.UndoMapping).flat());\n\n    // Create HistoryTracker (depends on UndoRegistry and OperationInvoker).\n    const invoker = yield* Capability.get(Capabilities.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(Capabilities.UndoRegistry, undoRegistry),\n      Capability.contributes(Capabilities.HistoryTracker, historyTracker),\n    ];\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAaxB,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AAGvC,QAAMC,eAA4BC,KAAK,MAAMH,aAAaI,OAAOC,qBAAaC,WAAW,EAAEC,KAAI,CAAA;AAG/F,QAAMC,UAAU,OAAOX,mBAAWY,IAAIJ,qBAAaK,gBAAgB;AAEnE,QAAMC,iBAAgCR,MAAKK,SAAsDN,YAAAA;AAEjG,SAAO;IACLL,mBAAWe,YAAYP,qBAAaQ,cAAcX,YAAAA;IAClDL,mBAAWe,YAAYP,qBAAaS,gBAAgBH,cAAAA;;AAExD,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "undoRegistry", "make", "getAll", "Capabilities", "UndoMapping", "flat", "invoker", "get", "OperationInvoker", "historyTracker", "contributes", "UndoRegistry", "HistoryTracker"]
+}

package/dist/lib/browser/chunk-2F5RSEOR.mjs

@@ -0,0 +1,80 @@
+import {
+  capability_exports
+} from "./chunk-TZGMTFCT.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/common/capabilities.ts
+var capabilities_exports = {};
+__export(capabilities_exports, {
+  AtomRegistry: () => AtomRegistry,
+  Command: () => Command,
+  HistoryTracker: () => HistoryTracker,
+  Layer: () => Layer,
+  ManagedRuntime: () => ManagedRuntime,
+  Null: () => Null,
+  OperationHandler: () => OperationHandler,
+  OperationInvoker: () => OperationInvoker,
+  PluginManager: () => PluginManager,
+  ReactContext: () => ReactContext,
+  ReactRoot: () => ReactRoot,
+  ReactSurface: () => ReactSurface,
+  UndoMapping: () => UndoMapping,
+  UndoRegistry: () => UndoRegistry,
+  getAtomValue: () => getAtomValue,
+  subscribeAtom: () => subscribeAtom,
+  updateAtomValue: () => updateAtomValue
+});
+import * as Effect from "effect/Effect";
+var Null = capability_exports.make("org.dxos.app-framework.capability.null");
+var PluginManager = capability_exports.make("org.dxos.app-framework.capability.plugin-manager");
+var AtomRegistry = capability_exports.make("org.dxos.app-framework.capability.atom-registry");
+var ReactContext = capability_exports.make("org.dxos.app-framework.capability.react-context");
+var ReactRoot = capability_exports.make("org.dxos.app-framework.capability.react-root");
+var ReactSurface = capability_exports.make("org.dxos.app-framework.common.react-surface");
+var Command = capability_exports.make("org.dxos.app-framework.capability.command");
+var Layer = capability_exports.make("org.dxos.app-framework.capability.layer");
+var ManagedRuntime = capability_exports.make("org.dxos.app-framework.capability.managed-runtime");
+var OperationHandler = capability_exports.make("org.dxos.app-framework.capability.operation-handler");
+var UndoMapping = capability_exports.make("org.dxos.app-framework.capability.undo-mapping");
+var OperationInvoker = capability_exports.make("org.dxos.app-framework.capability.operation-invoker");
+var UndoRegistry = capability_exports.make("org.dxos.app-framework.capability.undo-registry");
+var HistoryTracker = capability_exports.make("org.dxos.app-framework.capability.history-tracker");
+var getAtomValue = (atomCapability) => Effect.gen(function* () {
+  const registry = yield* capability_exports.get(AtomRegistry);
+  const atom = yield* capability_exports.get(atomCapability);
+  return registry.get(atom);
+});
+var updateAtomValue = (atomCapability, fn) => Effect.gen(function* () {
+  const registry = yield* capability_exports.get(AtomRegistry);
+  const atom = yield* capability_exports.get(atomCapability);
+  registry.set(atom, fn(registry.get(atom)));
+});
+var subscribeAtom = (atomCapability, callback) => Effect.gen(function* () {
+  const registry = yield* capability_exports.get(AtomRegistry);
+  const atom = yield* capability_exports.get(atomCapability);
+  return registry.subscribe(atom, () => callback(registry.get(atom)));
+});
+
+export {
+  Null,
+  PluginManager,
+  AtomRegistry,
+  ReactContext,
+  ReactRoot,
+  ReactSurface,
+  Command,
+  Layer,
+  ManagedRuntime,
+  OperationHandler,
+  UndoMapping,
+  OperationInvoker,
+  UndoRegistry,
+  HistoryTracker,
+  getAtomValue,
+  updateAtomValue,
+  subscribeAtom,
+  capabilities_exports
+};
+//# sourceMappingURL=chunk-2F5RSEOR.mjs.map

package/dist/lib/browser/chunk-2F5RSEOR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/capabilities.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, type Registry } from '@effect-atom/atom-react';\nimport type * as Command$ from '@effect/cli/Command';\nimport * as Effect from 'effect/Effect';\nimport type * as Layer$ from 'effect/Layer';\nimport type * as ManagedRuntime$ from 'effect/ManagedRuntime';\nimport type { FC, PropsWithChildren } from 'react';\n\nimport type { OperationInvoker as OperationInvoker$, OperationHandlerSet } from '@dxos/compute';\n\nimport { Capability as Capability$, type PluginManager as PluginManager$ } from '../core';\nimport type {\n  HistoryTracker as HistoryTracker$,\n  UndoMapping as UndoMapping$,\n  UndoRegistry as UndoRegistry$,\n} from '../plugin-operation';\nimport type { Surface } from '../ui';\n\n/**\n * Null capability.\n * @category Capability\n */\nexport const Null = Capability$.make<null>('org.dxos.app-framework.capability.null');\n\n/**\n * @category Capability\n */\nexport const PluginManager = Capability$.make<PluginManager$.PluginManager>(\n  'org.dxos.app-framework.capability.plugin-manager',\n);\n\n/**\n * @category Capability\n */\nexport const AtomRegistry = Capability$.make<Registry.Registry>('org.dxos.app-framework.capability.atom-registry');\n\nexport type ReactContext = Readonly<{\n  id: string;\n  dependsOn?: string[];\n  context: FC<PropsWithChildren>;\n}>;\n\n/**\n * @category Capability\n */\nexport const ReactContext = Capability$.make<ReactContext>('org.dxos.app-framework.capability.react-context');\n\nexport type ReactRoot = Readonly<{ id: string; root: FC<PropsWithChildren> }>;\n\n/**\n * @category Capability\n */\nexport const ReactRoot = Capability$.make<ReactRoot>('org.dxos.app-framework.capability.react-root');\n\n/**\n * Surface definitions that can be either React components or Web Components.\n */\nexport type ReactSurface = Surface.Definition | readonly Surface.Definition[];\n\n/**\n * @category Capability\n */\nexport const ReactSurface = Capability$.make<ReactSurface>('org.dxos.app-framework.common.react-surface');\n\nexport type AnyCommand = Command$.Command<any, any, any, any>;\n\n/**\n * @category Capability\n */\nexport const Command = Capability$.make<AnyCommand>('org.dxos.app-framework.capability.command');\n\n/**\n * @category Capability\n */\nexport const Layer = Capability$.make<Layer$.Layer<any, any, any>>('org.dxos.app-framework.capability.layer');\n\nexport type ManagedRuntime = ManagedRuntime$.ManagedRuntime<any, any>;\n\n/**\n * @category Capability\n */\nexport const ManagedRuntime = Capability$.make<ManagedRuntime>('org.dxos.app-framework.capability.managed-runtime');\n\n//\n// Operation System Capabilities\n//\n\nexport const OperationHandler = Capability$.make<OperationHandlerSet.OperationHandlerSet>(\n  'org.dxos.app-framework.capability.operation-handler',\n);\n\nexport type UndoMapping = UndoMapping$.UndoMapping;\n\n/**\n * Undo mapping registration - contributed by plugins.\n * @category Capability\n */\nexport const UndoMapping = Capability$.make<UndoMapping[]>('org.dxos.app-framework.capability.undo-mapping');\n\nexport type OperationInvoker = OperationInvoker$.OperationInvoker;\n\n/**\n * Operation invoker - provided by OperationPlugin.\n * @category Capability\n */\nexport const OperationInvoker = Capability$.make<OperationInvoker>(\n  'org.dxos.app-framework.capability.operation-invoker',\n);\n\nexport type UndoRegistry = UndoRegistry$.UndoRegistry;\n\n/**\n * Undo registry - provided by OperationPlugin.\n * @category Capability\n */\nexport const UndoRegistry = Capability$.make<UndoRegistry>('org.dxos.app-framework.capability.undo-registry');\n\nexport type HistoryTracker = HistoryTracker$.HistoryTracker;\n\n/**\n * History tracker - provided by OperationPlugin.\n * @category Capability\n */\nexport const HistoryTracker = Capability$.make<HistoryTracker>('org.dxos.app-framework.capability.history-tracker');\n\n//\n// Atom Capability Helpers\n//\n\n/**\n * Get the current value of an atom capability.\n * @example const settings = yield* Capabilities.getAtomValue(ThreadCapabilities.Settings);\n */\nexport const getAtomValue = <T>(\n  atomCapability: Capability$.InterfaceDef<Atom.Atom<T>>,\n): Effect.Effect<T, Error, Capability$.Service> =>\n  Effect.gen(function* () {\n    const registry = yield* Capability$.get(AtomRegistry);\n    const atom = yield* Capability$.get(atomCapability);\n    return registry.get(atom);\n  });\n\n/**\n * Update an atom capability value (requires writable atom).\n * @example yield* Capabilities.updateAtomValue(ThreadCapabilities.Settings, (s) => ({ ...s, foo: true }));\n */\nexport const updateAtomValue = <T>(\n  atomCapability: Capability$.InterfaceDef<Atom.Writable<T>>,\n  fn: (current: T) => T,\n): Effect.Effect<void, Error, Capability$.Service> =>\n  Effect.gen(function* () {\n    const registry = yield* Capability$.get(AtomRegistry);\n    const atom = yield* Capability$.get(atomCapability);\n    registry.set(atom, fn(registry.get(atom)));\n  });\n\n/**\n * Subscribe to an atom capability.\n * @example const unsubscribe = yield* Capabilities.subscribeAtom(ThreadCapabilities.Settings, (value) => ...);\n */\nexport const subscribeAtom = <T>(\n  atomCapability: Capability$.InterfaceDef<Atom.Atom<T>>,\n  callback: (value: T) => void,\n): Effect.Effect<() => void, Error, Capability$.Service> =>\n  Effect.gen(function* () {\n    const registry = yield* Capability$.get(AtomRegistry);\n    const atom = yield* Capability$.get(atomCapability);\n    return registry.subscribe(atom, () => callback(registry.get(atom)));\n  });\n"],
+  "mappings": ";;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;AAMA,YAAYA,YAAY;AAmBjB,IAAMC,OAAOC,mBAAYC,KAAW,wCAAA;AAKpC,IAAMC,gBAAgBF,mBAAYC,KACvC,kDAAA;AAMK,IAAME,eAAeH,mBAAYC,KAAwB,iDAAA;AAWzD,IAAMG,eAAeJ,mBAAYC,KAAmB,iDAAA;AAOpD,IAAMI,YAAYL,mBAAYC,KAAgB,8CAAA;AAU9C,IAAMK,eAAeN,mBAAYC,KAAmB,6CAAA;AAOpD,IAAMM,UAAUP,mBAAYC,KAAiB,2CAAA;AAK7C,IAAMO,QAAQR,mBAAYC,KAAkC,yCAAA;AAO5D,IAAMQ,iBAAiBT,mBAAYC,KAAqB,mDAAA;AAMxD,IAAMS,mBAAmBV,mBAAYC,KAC1C,qDAAA;AASK,IAAMU,cAAcX,mBAAYC,KAAoB,gDAAA;AAQpD,IAAMW,mBAAmBZ,mBAAYC,KAC1C,qDAAA;AASK,IAAMY,eAAeb,mBAAYC,KAAmB,iDAAA;AAQpD,IAAMa,iBAAiBd,mBAAYC,KAAqB,mDAAA;AAUxD,IAAMc,eAAe,CAC1BC,mBAEOC,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOlB,mBAAYmB,IAAIhB,YAAAA;AACxC,QAAMiB,OAAO,OAAOpB,mBAAYmB,IAAIH,cAAAA;AACpC,SAAOE,SAASC,IAAIC,IAAAA;AACtB,CAAA;AAMK,IAAMC,kBAAkB,CAC7BL,gBACAM,OAEOL,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOlB,mBAAYmB,IAAIhB,YAAAA;AACxC,QAAMiB,OAAO,OAAOpB,mBAAYmB,IAAIH,cAAAA;AACpCE,WAASK,IAAIH,MAAME,GAAGJ,SAASC,IAAIC,IAAAA,CAAAA,CAAAA;AACrC,CAAA;AAMK,IAAMI,gBAAgB,CAC3BR,gBACAS,aAEOR,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOlB,mBAAYmB,IAAIhB,YAAAA;AACxC,QAAMiB,OAAO,OAAOpB,mBAAYmB,IAAIH,cAAAA;AACpC,SAAOE,SAASQ,UAAUN,MAAM,MAAMK,SAASP,SAASC,IAAIC,IAAAA,CAAAA,CAAAA;AAC9D,CAAA;",
+  "names": ["Effect", "Null", "Capability$", "make", "PluginManager", "AtomRegistry", "ReactContext", "ReactRoot", "ReactSurface", "Command", "Layer", "ManagedRuntime", "OperationHandler", "UndoMapping", "OperationInvoker", "UndoRegistry", "HistoryTracker", "getAtomValue", "atomCapability", "gen", "registry", "get", "atom", "updateAtomValue", "fn", "set", "subscribeAtom", "callback", "subscribe"]
+}