@dxos/app-framework 0.8.4-main.cb12b3f963 → 0.8.4-main.d05539e30a

package/dist/lib/node-esm/{chunk-D347W3KO.mjs → chunk-BYHYYJZH.mjs}

@@ -1,17 +1,17 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   UndoOperation
-} from "./chunk-SBS2YMPT.mjs";
+} from "./chunk-OUEMWPIW.mjs";
 import {
   __export
 } from "./chunk-HSLMI22Q.mjs";
 
-// src/plugin-operation/history/errors.ts
+// src/plugin-process-manager/history/errors.ts
 import { BaseError } from "@dxos/errors";
 var EmptyHistoryError = class extends BaseError.extend("EmptyHistoryError", "Cannot undo: history is empty.") {
 };
 
-// src/plugin-operation/history/undo-mapping.ts
+// src/plugin-process-manager/history/undo-mapping.ts
 var undo_mapping_exports = {};
 __export(undo_mapping_exports, {
   make: () => make,
@@ -28,7 +28,7 @@ var resolveMessage = (message, input, output) => {
   return message;
 };
 
-// src/plugin-operation/history/undo-registry.ts
+// src/plugin-process-manager/history/undo-registry.ts
 var undo_registry_exports = {};
 __export(undo_registry_exports, {
   make: () => make2
@@ -51,7 +51,7 @@ var make2 = (getMappings) => {
   };
 };
 
-// src/plugin-operation/history/history-tracker.ts
+// src/plugin-process-manager/history/history-tracker.ts
 var history_tracker_exports = {};
 __export(history_tracker_exports, {
   make: () => make3
@@ -60,7 +60,7 @@ 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 __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/plugin-process-manager/history/history-tracker.ts";
 var HISTORY_LIMIT = 100;
 var make3 = (invoker, undoRegistry) => {
   const history = [];
@@ -140,4 +140,4 @@ export {
   make3 as make2,
   history_tracker_exports
 };
-//# sourceMappingURL=chunk-D347W3KO.mjs.map
+//# sourceMappingURL=chunk-BYHYYJZH.mjs.map

package/dist/lib/node-esm/{chunk-D347W3KO.mjs.map → chunk-BYHYYJZH.mjs.map}

@@ -1,6 +1,6 @@
 {
   "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"],
+  "sources": ["../../../src/plugin-process-manager/history/errors.ts", "../../../src/plugin-process-manager/history/undo-mapping.ts", "../../../src/plugin-process-manager/history/undo-registry.ts", "../../../src/plugin-process-manager/history/history-tracker.ts"],
   "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { BaseError } from '@dxos/errors';\n\nexport class EmptyHistoryError extends BaseError.extend('EmptyHistoryError', 'Cannot undo: history is empty.') {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type { Operation } from '@dxos/compute';\n\n/**\n * Label type for translatable text (canonical definition in @dxos/app-toolkit).\n */\ntype Label = string | [string, { ns: string; count?: number; defaultValue?: string }];\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: '@dxos/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: '@dxos/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/compute';\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 { OperationInvoker } from '@dxos/operation';\n\nimport { UndoOperation } from '../../common';\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": ";;;;;;;;;AAIA,SAASA,iBAAiB;AAEnB,IAAMC,oBAAN,cAAgCD,UAAUE,OAAO,qBAAqB,gCAAA,EAAA;AAAmC;;;ACNhH;;;;;AAmHO,IAAMC,OAAO,CAClBC,UACyBA;AAKpB,IAAMC,iBAAiB,CAC5BC,SACAC,OACAC,WAAAA;AAEA,MAAIF,YAAYG,QAAW;AACzB,WAAOA;EACT;AACA,MAAI,OAAOH,YAAY,YAAY;AACjC,WAAOA,QAAQC,OAAOC,MAAAA;EACxB;AACA,SAAOF;AACT;;;ACtIA;;cAAAI;;AAqCO,IAAMA,QAAO,CAACC,gBAAAA;AACnB,QAAMC,SAAS,CAACC,cAAAA;AACd,UAAMC,WAAWH,YAAAA;AACjB,UAAMI,UAAUD,SAASE,KAAK,CAACC,MAAMA,EAAEJ,UAAUK,KAAKC,QAAQN,UAAUK,KAAKC,GAAG;AAChF,QAAI,CAACJ,SAAS;AACZ,aAAOK;IACT;AAEA,WAAO;MACLC,SAASN,QAAQM;MACjBC,eAAeP,QAAQO;MACvBC,SAASR,QAAQQ;IACnB;EACF;AAEA,SAAO;IAAEX;EAAO;AAClB;;;ACrDA;;cAAAY;;AAIA,YAAYC,YAAY;AACxB,YAAYC,YAAY;AAExB,SAASC,2BAA2B;AACpC,SAASC,WAAW;AASpB,IAAA,eAAMC;AAgBN,IAAA,gBAAU;AAYR,IAAAC,QAAA,CAAA,SAAA,iBAAkC;AAClC,QAAMC,UAAAA,CAAAA;QAEJ,mBAAc,CAAA,UAAA;UACZ,UAAA,aAAA,OAAA,MAAmC,SAAA;QACnC,CAAA,SAAA;AAGF;IACA;UACE,eAAA,QAAA,cAAA,MAAA,OAAA,MAAA,MAAA;QACAC,iBAAI,QAAA;AAA0D,UAAA,0BAAA;QAC9D,KAAA,MAAA,UAAA,KAAA;MACF,GAAA,EAAA,YAAA,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,OAAA,CAAA;AAEA;;UAEEC,QAAOC;MACPC,WAAQD,MAAMC;MACdC,OAAAA,MAASC;MACTC,QAAAA,MAAAA;MACAC,SAAAA,QAAiBA;MACnB;MAEAC,WAAaC,MAAAA;IACbT;YAA6BU,KAAKR,KAAMS;QAAoBC,uBAAuBC;MAAO,KAAA,MAAA,UAAA,KAAA;MAE1F,eAAA,QAAA;IACA,GAAA,EAAA,YAAYA,YAAShB,GAAAA,cAAe,GAAA,IAAA,GAAA,OAAA,CAAA;AAEpC,QAAA,QAAA,SAAA,eAAA;AAEA,cAAA,OAAA,GAAA,QAAA,SAAA,aAAA;IACA;UAGIiB,kBAASC,eAAAA,QAAAA,SAAAA,MAAAA,OAAAA,MAAAA,MAAAA;AACX,IAAA,eAAA,QAAA,OAAA,cAAA,UAAA;MAEJ,SAAA;IAEA,CAAA,CAAA;EACAC;EAOE,eAAkB,kBAAA,QAAA,WAAA,EAAA,KAAA,kBAAA,CAAA,UAAA,YAAA,MAAA,iBAAA,KAAA,CAAA,CAAA,CAAA,CAAA;eAChB,MAAMP;WACDA,WAAO,aAAA;YACV,QAAO,QAAOO,IAAOC;AACvB,UAAA,CAAA,OAAA;AAEI,eAAA,OAAqB,YAAA,IAAA,kBAAA,CAAA;;UAAiCC,qBAAkBd;QAAiB,KAAA,MAAA,UAAA,KAAA;QAE7F,YAAA,MAAA,QAAA,KAAA;MACA,GAAA,EAAA,YAAOe,YAAQC,GAAYX,cAAa,GAAEA,IAAAA,GAAAA,KAAMH,CAAAA;aAExBI,QAAWC,YAAUU,MAAQ,SAAA,MAAA,YAAA;AAAC,UAAA,kBAAA;QACxD,KAAA,MAAA,UAAA,KAAA;MACF,GAAA,EAAA,YAAA,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,KAAA,CAAA;IAEA,CAAA;;sBAIgBC,YAAAA;WACV,oBAAO,KAAA,CAAA,EAAA,KAAA,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,UAAA;UAAEA,MAAAA,OAAAA,QAAAA,EAAAA,YAAAA,YAAAA,GAAAA,cAAAA,GAAAA,IAAAA,GAAAA,OAAAA,CAAAA;AAAM,aAAA;QACjB;MACJ;IAEA,CAAA;;AAEA,QAAA,UAAA,MAAA;AAEA,WAAO,QAAA,SAAA;;SAELC;IACAC;IACF;IACA;;;",
   "names": ["BaseError", "EmptyHistoryError", "extend", "make", "props", "resolveMessage", "message", "input", "output", "undefined", "make", "getMappings", "lookup", "operation", "mappings", "mapping", "find", "m", "meta", "key", "undefined", "inverse", "deriveContext", "message", "make", "Effect", "Stream", "runAndForwardErrors", "log", "HISTORY_LIMIT", "make", "handleInvocation", "log", "input", "event", "output", "inverse", "mapping", "inverseInput", "timestamp", "history", "entry", "key", "operation", "historyLength", "length", "message", "resolvedMessage", "Effect", "fail", "inverseKey", "invoker", "_invokeCore", "meta", "error", "undoPromise", "canUndo"]

package/dist/lib/node-esm/{chunk-SDJ4B2LU.mjs → chunk-CTKEZHKF.mjs}

@@ -8,6 +8,7 @@ var capability_exports = {};
 __export(capability_exports, {
   ModuleTag: () => ModuleTag,
   Service: () => Service,
+  asLayer: () => asLayer,
   atom: () => atom,
   atomByModule: () => atomByModule,
   contributes: () => contributes,
@@ -21,6 +22,7 @@ __export(capability_exports, {
 });
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
 var Service = class extends Context.Tag("@dxos/app-framework/CapabilityManager")() {
 };
 var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
@@ -31,6 +33,7 @@ var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(i
 var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
 var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
 var atomByModule = (interfaceDef) => Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));
+var asLayer = (interfaceDef, tag) => Layer.effect(tag, get(interfaceDef).pipe(Effect.orDie));
 var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
 var make = (identifier) => {
   return {
@@ -69,6 +72,7 @@ export {
   waitFor,
   atom,
   atomByModule,
+  asLayer,
   ModuleTag,
   make,
   contributes,
@@ -77,4 +81,4 @@ export {
   makeModule,
   capability_exports
 };
-//# sourceMappingURL=chunk-SDJ4B2LU.mjs.map
+//# sourceMappingURL=chunk-CTKEZHKF.mjs.map

package/dist/lib/node-esm/chunk-CTKEZHKF.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';\nimport * as Layer from 'effect/Layer';\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\n/**\n * Get capabilities grouped by the module that contributed them.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing a record from module ID to capability implementations.\n */\nexport const atomByModule = <T>(\n  interfaceDef: InterfaceDef<T>,\n): Effect.Effect<Atom.Atom<Record<string, T[]>>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));\n\n/**\n * Constructs a layer that will request its interface implementation from the capability manager.\n */\nexport const asLayer = <T, I>(interfaceDef: InterfaceDef<T>, tag: Context.Tag<I, T>): Layer.Layer<I, never, Service> =>\n  Layer.effect(tag, get(interfaceDef).pipe(Effect.orDie));\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 */\n// TODO(dmaretskyi): Make the return type non-generic so capabilities are non-discernable.\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.promise(() => 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 required options (context accessed via layer)\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* (props: { observability: boolean }) {\n *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n *     return contributes(Capabilities.OperationHandler, ...);\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;AACxB,YAAYC,WAAW;AAahB,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;AAOzC,IAAMY,eAAe,CAC1BZ,iBAEOS,WAAIZ,SAAS,CAACK,YAAYA,QAAQU,aAAaZ,YAAAA,CAAAA;AAKjD,IAAMa,UAAU,CAAOb,cAA+Bc,QACrDC,aAAOD,KAAKf,IAAIC,YAAAA,EAAcgB,KAAYC,YAAK,CAAA;AAOhD,IAAMC,YAA2BC,uBAAOC,IAAI,+BAAA;AAiB5C,IAAMC,OAAO,CAAIC,eAAAA;AACtB,SAAO;IAAEA;EAAW;AACtB;AAmCO,IAAMC,cAAc,CACzBC,cACAC,gBACAC,eAAAA;AAEA,SAAO;IACLC,WAAWH;IACXC;IACAC;EACF;AACF;AA4BO,IAAME,OAAO,CAClBC,MACAC,MAAAA;AAEA,QAAMC,SAA+B,CAACC,UAC7BC,WAAI,aAAA;AACT,UAAM,EAAEC,SAASC,cAAa,IAAK,OAAcC,eAAQ,MAAMN,EAAAA,CAAAA;AAC/D,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,CAACb,SAAAA,GAAYW;EAAK,CAAA;AACnD;AAQO,IAAMe,eAAe,CAACC,eAAAA;AAC3B,SAAOA,cAAc,OAAOA,eAAe,cAAc3B,aAAa2B,aAClEC,OAAOD,WAAW3B,SAAAA,CAAU,IAC5B6B;AACN;AA2CO,IAAMC,aAAa,CAMxBC,OACsDA;",
+  "names": ["Context", "Effect", "Layer", "Service", "Tag", "get", "interfaceDef", "flatMap", "manager", "try", "catch", "error", "Error", "String", "getAll", "map", "waitFor", "atom", "atomByModule", "asLayer", "tag", "effect", "pipe", "orDie", "ModuleTag", "Symbol", "for", "make", "identifier", "contributes", "interfaceDef", "implementation", "deactivate", "interface", "lazy", "name", "c", "lazyFn", "props", "gen", "default", "getCapability", "promise", "result", "normalized", "Array", "isArray", "from", "Object", "assign", "getModuleTag", "capability", "String", "undefined", "makeModule", "fn"]
+}

package/dist/lib/node-esm/{chunk-42J2ZUQQ.mjs → chunk-JNT72ZCN.mjs}

@@ -3,19 +3,19 @@ import {
   PluginManagerProvider,
   topologicalSort,
   usePluginManager
-} from "./chunk-WKTLE7MG.mjs";
+} from "./chunk-LJNUFNDO.mjs";
 import {
   PluginManagerContext
 } from "./chunk-37Z53PXZ.mjs";
 import {
   capabilities_exports
-} from "./chunk-WFSRZKBP.mjs";
+} from "./chunk-PW2VYGOS.mjs";
 import {
   activation_events_exports
-} from "./chunk-6XW6LET6.mjs";
+} from "./chunk-KFZEB6BV.mjs";
 import {
   plugin_manager_exports
-} from "./chunk-MUVUQC3G.mjs";
+} from "./chunk-SFYCO3PT.mjs";
 
 // src/ui/components/App/App.tsx
 import React2, { useEffect as useEffect3 } from "react";
@@ -35,14 +35,13 @@ import { useAsyncEffect, useDefaultValue } from "@dxos/react-hooks";
 import { ContextProtocolProvider } from "@dxos/web-context-react";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/ui/hooks/useApp.tsx";
 var ENABLED_KEY = "org.dxos.app-framework.enabled";
-var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, pluginRegistryProvider, plugins: pluginsProp, core: coreProp, defaults: defaultsProp, setupEvents: setupEventsProp, placeholder, fallback = ErrorFallback, cacheEnabled = false, safeMode = false, debounce = 0, timeout = 3e4 }) => {
+var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, pluginRegistryProvider, plugins: pluginsProp, defaults: defaultsProp, setupEvents: setupEventsProp, placeholder, fallback = ErrorFallback, cacheEnabled = false, safeMode = false, debounce = 0, timeout = 3e4 }) => {
   const plugins = useDefaultValue(pluginsProp, () => []);
-  const core = useDefaultValue(coreProp, () => plugins.map(({ meta }) => meta.id));
   const defaults = useDefaultValue(defaultsProp, () => []);
   const setupEvents = useDefaultValue(setupEventsProp, () => []);
   const pluginLoader = useMemo(() => pluginLoaderProp ?? ((id) => Effect.sync(() => {
     const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
-    invariant(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 52, S: void 0, A: ["plugin", "`Plugin not found: ${id}`"] });
+    invariant(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 49, S: void 0, A: ["plugin", "`Plugin not found: ${id}`"] });
     return {
       plugin
     };
@@ -71,20 +70,18 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, p
     const mgr = pluginManager ?? plugin_manager_exports.make({
       pluginLoader,
       plugins,
-      core,
       enabled,
       onRemove: onPluginRemove,
       pluginRegistryProvider
     });
     log("useApp: useMemo created/reused manager", {
       provided: !!pluginManager
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 87, S: void 0 });
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 83, S: void 0 });
     return mgr;
   }, [
     pluginManager,
     pluginLoader,
     plugins,
-    core,
     enabled,
     onPluginRemove,
     pluginRegistryProvider
@@ -106,7 +103,7 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, p
     manager
   ]);
   useAsyncEffect(async () => {
-    log("useApp: effect mount", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 117, S: void 0 });
+    log("useApp: effect mount", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 112, S: void 0 });
     manager.capabilities.contribute({
       interface: capabilities_exports.PluginManager,
       implementation: manager,
@@ -179,13 +176,13 @@ var useApp = ({ pluginManager, pluginLoader: pluginLoaderProp, onPluginRemove, p
           eventsFired: manager.getEventsFired(),
           activeModules: manager.getActive(),
           pendingReset: manager.getPendingReset()
-        }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 224, S: void 0 });
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 219, S: void 0 });
         void runAndForwardErrors(Fiber.interrupt(fiber));
         setError(new Error(`Startup timed out after ${timeout}ms`));
       }
     }, timeout);
     return () => {
-      log("useApp: effect cleanup", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 234, S: void 0 });
+      log("useApp: effect cleanup", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 229, S: void 0 });
       clearTimeout(timeoutId);
       void runAndForwardErrors(Fiber.interrupt(fiber));
       if (!isExternalManager) {
@@ -333,13 +330,57 @@ var useLoading = (ready, debounce = 0) => {
   return stage;
 };
 
+// src/ui/hooks/useProcessManagerRuntime.ts
+import * as Effect2 from "effect/Effect";
+import { use, useCallback as useCallback3, useMemo as useMemo2 } from "react";
+import { ServiceResolver } from "@dxos/compute";
+import { unwrapExit } from "@dxos/effect";
+var useProcessManagerRuntime = () => useCapability(capabilities_exports.ProcessManagerRuntime);
+var useSpaceCallback = (spaceId, tags, fn, deps) => {
+  const runtime = useProcessManagerRuntime();
+  return useCallback3(() => {
+    if (spaceId === void 0) {
+      throw new TypeError("Space not provided to useSpaceCallback");
+    }
+    const layer = ServiceResolver.provide({
+      space: spaceId
+    }, ...tags);
+    return runtime.runPromise(fn().pipe(Effect2.provide(layer)));
+  }, [
+    runtime,
+    spaceId,
+    ...deps ?? []
+  ]);
+};
+var useSpaceService = (tag, spaceId) => {
+  const runtime = useProcessManagerRuntime();
+  const promise = useMemo2(() => {
+    if (spaceId === void 0) {
+      return void 0;
+    }
+    const layer = ServiceResolver.provide({
+      space: spaceId
+    }, tag);
+    const effect = Effect2.flatMap(tag, (service) => Effect2.succeed(service)).pipe(Effect2.provide(layer));
+    return runtime.runPromiseExit(effect);
+  }, [
+    runtime,
+    spaceId,
+    tag
+  ]);
+  if (!promise) {
+    return void 0;
+  }
+  return unwrapExit(use(promise));
+};
+
 // src/ui/hooks/useSettingsState.ts
 import { RegistryContext as RegistryContext2, useAtomValue as useAtomValue2 } from "@effect-atom/atom-react";
-import { useCallback as useCallback3, useContext } from "react";
+import { useCallback as useCallback4, useContext } from "react";
 var useSettingsState = (atom) => {
   const registry = useContext(RegistryContext2);
   const settings = useAtomValue2(atom);
-  const updateSettings = useCallback3((fn) => {
+  const updateSettings = useCallback4((fn) => {
     registry.set(atom, fn(registry.get(atom)));
   }, [
     registry,
@@ -444,10 +485,8 @@ var Placeholder = ({ stage = 1, progress, logo }) => {
   return /* @__PURE__ */ React3.createElement(ThemeProvider, {
     tx: defaultTx
   }, /* @__PURE__ */ React3.createElement("div", {
-    role: "none",
     className: "relative dx-container h-dvh flex flex-col"
   }, /* @__PURE__ */ React3.createElement("div", {
-    role: "none",
     className: "flex flex-col grow justify-center items-center"
   }, typeof logo === "function" ? logo({
     className: logoClassName
@@ -465,8 +504,11 @@ export {
   useOperationInvoker,
   LoadingState,
   useLoading,
+  useProcessManagerRuntime,
+  useSpaceCallback,
+  useSpaceService,
   useSettingsState,
   App,
   Placeholder
 };
-//# sourceMappingURL=chunk-42J2ZUQQ.mjs.map
+//# sourceMappingURL=chunk-JNT72ZCN.mjs.map

package/dist/lib/node-esm/chunk-JNT72ZCN.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ui/components/App/App.tsx", "../../../src/ui/hooks/useApp.tsx", "../../../src/ui/hooks/useCapabilities.ts", "../../../src/ui/hooks/useLoading.tsx", "../../../src/ui/hooks/useProcessManagerRuntime.ts", "../../../src/ui/hooks/useSettingsState.ts", "../../../src/ui/components/Placeholder/Placeholder.tsx"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useEffect } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type StartupProgress, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\nexport type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n  progress?: StartupProgress;\n};\n\nconst FIRST_INTERACTIVE_MARK = 'app-framework:first-interactive';\n\nexport const App = ({ placeholder: Placeholder, ready, error, debounce, progress }: AppProps) => {\n  const reactContexts = useCapabilities(Capabilities.ReactContext);\n  const reactRoots = useCapabilities(Capabilities.ReactRoot);\n  const stage = useLoading(ready, debounce);\n  const placeholderDismissed = stage >= LoadingState.Done;\n\n  // Emit a once-per-app `app-framework:first-interactive` mark the first time\n  // the placeholder is dismissed and the real app shell renders. Closes the\n  // gap between `Startup` activated and the first interactive paint.\n  //\n  // Also dismisses the native-DOM boot loader from\n  // `@dxos/app-framework/vite-plugin` here — the framework owns the\n  // handoff-complete signal, so dismissing in `App` covers both hosts that\n  // wire in a `Placeholder` (which may have its own dismiss path) and hosts\n  // that don't (the loader would otherwise sit forever as a `z-index: 10`\n  // overlay covering the rendered shell).\n  useEffect(() => {\n    if (!placeholderDismissed) {\n      return;\n    }\n    if (performance.getEntriesByName(FIRST_INTERACTIVE_MARK).length === 0) {\n      performance.mark(FIRST_INTERACTIVE_MARK);\n    }\n    (window as { __bootLoader?: { dismiss?: () => void } }).__bootLoader?.dismiss?.();\n  }, [placeholderDismissed]);\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (!placeholderDismissed) {\n    if (!Placeholder) {\n      return null;\n    }\n\n    return <Placeholder stage={stage} progress={progress} />;\n  }\n\n  const ComposedContext = composeContexts(reactContexts);\n  return (\n    <ComposedContext>\n      {reactRoots.map(({ id, root: Component }) => (\n        <Component key={id} />\n      ))}\n    </ComposedContext>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]) => {\n  if (contexts.length === 0) {\n    return ({ children }: PropsWithChildren) => <>{children}</>;\n  }\n\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\nimport * as Fiber from 'effect/Fiber';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\nimport React, { type FC, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { ErrorBoundary, ErrorFallback, type FallbackProps } from '@dxos/react-error-boundary';\nimport { useAsyncEffect, useDefaultValue } from '@dxos/react-hooks';\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { ActivationEvents, Capabilities } from '../../common';\nimport { PluginManagerContext } from '../../context';\nimport { type ActivationEvent, type Plugin, PluginManager } from '../../core';\nimport { App, PluginManagerProvider } from '../components';\n\nconst ENABLED_KEY = 'org.dxos.app-framework.enabled';\n\nexport type StartupProgress = {\n  /** Number of modules that have been activated. */\n  activated: number;\n  /** Total number of modules registered. */\n  total: number;\n  /** Fractional progress (0-1). */\n  progress: number;\n  /**\n   * Raw activation event key (e.g. `org.dxos.app-framework.event.startup`).\n   * Set on event-level transitions, *and* on module-level transitions where\n   * it carries the parent activation event that first triggered the\n   * module's load (plumbed through `_loadCapabilitiesForModules` →\n   * `_loadModule`). Consumers can use this either as the primary id (when\n   * {@link module} is absent) or as an extra \"context\" field alongside\n   * {@link module}.\n   */\n  event?: string;\n  /**\n   * Raw module id (e.g. `org.dxos.plugin.observability.module.ReactSurface`)\n   * when the in-flight activation is module-level. When present,\n   * {@link event} may also be set, identifying the parent activation that\n   * triggered this module's load.\n   */\n  module?: string;\n  /**\n   * Pre-humanized label for the currently surfaced transition (module\n   * label if {@link module} is set, otherwise the event label), supplied\n   * for consumers that want a sensible default. Hosts that prefer to\n   * render their own label can read the raw {@link event}/{@link module}\n   * fields and ignore this — the framework leaves the policy choice\n   * (which transitions to surface, how to format them, whether to drop\n   * sub-modules entirely) to the host's `Placeholder`.\n   */\n  humanizedName?: string;\n};\n\nexport type PlaceholderProps = {\n  stage?: number;\n  progress?: StartupProgress;\n};\n\nexport type UseAppOptions = {\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  onPluginRemove?: PluginManager.ManagerOptions['onRemove'];\n  pluginRegistryProvider?: PluginManager.ManagerOptions['pluginRegistryProvider'];\n  plugins?: Plugin.Plugin[];\n  defaults?: string[];\n  /**\n   * Additional activation events to fire before startup.\n   * These are fired alongside SetupReactSurface before the Startup event.\n   */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  cacheEnabled?: boolean;\n  safeMode?: boolean;\n  debounce?: number;\n  timeout?: number;\n  fallback?: FC<FallbackProps>;\n  placeholder?: FC<PlaceholderProps>;\n};\n\n/**\n * Expected usage is for this to be the entrypoint of the application.\n * Initializes plugins and renders the root components.\n *\n * @example\n * const plugins = [LayoutPlugin(), MyPlugin()];\n * const defaults = [MyPluginId];\n * const fallback = () => <div>Initializing Plugins...</div>;\n * const App = useApp({ plugins, defaults, fallback });\n * createRoot(document.getElementById('root')!).render(\n *   <StrictMode>\n *     <App />\n *   </StrictMode>,\n * );\n *\n * @param params.pluginLoader A function which loads new plugins.\n * @param params.plugins All plugins available to the application. Plugins whose `meta.tags` includes `'system'` are treated as core (force-enabled, not user-toggleable).\n * @param params.defaults Default plugins are enabled by default but can be disabled by the user.\n * @param params.cacheEnabled Whether to cache enabled plugins in localStorage.\n * @param params.safeMode Whether to enable safe mode, which disables optional plugins.\n * @param params.fallback Fallback component to render if an error occurs during startup.\n * @param params.placeholder Placeholder component to render during startup.\n */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  onPluginRemove,\n  pluginRegistryProvider,\n  plugins: pluginsProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\n  placeholder,\n  fallback = ErrorFallback,\n  cacheEnabled = false,\n  safeMode = false,\n  debounce = 0,\n  timeout = 30_000,\n}: UseAppOptions) => {\n  const plugins = useDefaultValue(pluginsProp, () => []);\n  const defaults = useDefaultValue(defaultsProp, () => []);\n  const setupEvents = useDefaultValue(setupEventsProp, () => []);\n\n  const pluginLoader = useMemo(\n    () =>\n      pluginLoaderProp ??\n      ((id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.id === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return { plugin };\n        })),\n    [pluginLoaderProp, plugins],\n  );\n\n  const readyRef = useRef(false);\n  const [ready, setReady] = useState(false);\n  const errorRef = useRef<unknown>(null);\n  const [error, setError] = useState<unknown>(null);\n  const [startupProgress, setStartupProgress] = useState<StartupProgress>({\n    activated: 0,\n    total: 0,\n    progress: 0,\n  });\n  // TODO(wittjosiah): Migrate to Atom.kvs for isomorphic storage.\n  const cached: string[] = useMemo(() => JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]'), []);\n  const enabled = useMemo(\n    () => (safeMode ? [] : cacheEnabled && cached.length > 0 ? cached : defaults),\n    [safeMode, cacheEnabled, cached, defaults],\n  );\n  const isExternalManager = !!pluginManager;\n  const manager = useMemo(() => {\n    const mgr =\n      pluginManager ??\n      PluginManager.make({\n        pluginLoader,\n        plugins,\n        enabled,\n        onRemove: onPluginRemove,\n        pluginRegistryProvider,\n      });\n    log('useApp: useMemo created/reused manager', { provided: !!pluginManager });\n    return mgr;\n  }, [pluginManager, pluginLoader, plugins, enabled, onPluginRemove, pluginRegistryProvider]);\n\n  useEffect(() => {\n    if (!cacheEnabled) {\n      return;\n    }\n    return manager.registry.subscribe(manager.enabled, (value) => {\n      localStorage.setItem(ENABLED_KEY, JSON.stringify(value));\n    });\n  }, [cacheEnabled, manager]);\n\n  useEffect(() => {\n    setupDevtools(manager);\n  }, [manager]);\n\n  useAsyncEffect(async () => {\n    log('useApp: effect mount');\n\n    manager.capabilities.contribute({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'org.dxos.app-framework.plugin-manager',\n    });\n\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'org.dxos.app-framework.atom-registry',\n    });\n\n    const fiber = Effect.gen(function* () {\n      const queue = yield* PubSub.subscribe(manager.activation);\n      const listener = yield* Effect.forkDaemon(\n        Queue.take(queue).pipe(\n          Effect.tap(({ event, state, module, error: error$ }) =>\n            Effect.sync(() => {\n              // Event-level Startup activated (no `module` field) fires once,\n              // after every module triggered by Startup has finished. Module\n              // activations now also carry their parent event id (so the trace\n              // can attribute a module to its triggering event), which means\n              // each module activated under Startup publishes\n              // `{ event: 'startup', state: 'activated', module: <id> }`. Without\n              // the `!module` guard the listener would mark the app ready on\n              // the *first* such module rather than waiting for the event-level\n              // completion — leaving downstream capabilities (operation-invoker,\n              // app-graph, …) un-registered when the placeholder dismisses.\n              if (event === ActivationEvents.Startup.id && state === 'activated' && !module) {\n                clearTimeout(timeoutId);\n                setReady(true);\n                readyRef.current = true;\n                // Trigger startup profiler dump if available.\n                (globalThis as any).composer?.profiler?.dump();\n                // Notify any host observability layer that startup completed.\n                // A `CustomEvent` keeps this generic — app-framework doesn't\n                // import a provider, and consumers can capture the startup\n                // summary without us picking one.\n                if (typeof window !== 'undefined') {\n                  window.dispatchEvent(new CustomEvent('app-framework:startup-activated'));\n                }\n                return;\n              }\n              // `activating` is the start-of-load signal. Surface the raw\n              // `module` (or `event`) plus a pre-humanized label so the\n              // host placeholder can decide what to render — show\n              // everything, suppress noisy sub-modules, group by plugin,\n              // or apply its own formatting. We intentionally do NOT touch\n              // these fields on `activated`: pairing the two would cause\n              // back-to-back identical updates to the host's effect, which\n              // the boot loader treats as a re-trigger because\n              // `progress.progress` moved. Leaving the label alone on\n              // completion keeps it accurate (\"now activating X\") until\n              // the next module starts.\n              if (module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  // `event` here is the activation event that first\n                  // triggered this module load (plumbed through\n                  // `_loadCapabilitiesForModules` → `_loadModule`).\n                  // Falsy/empty falls back to undefined so consumers can\n                  // tell \"no parent context\" from \"parent context: <X>\".\n                  event: event || undefined,\n                  module,\n                  humanizedName: humanizeModuleId(module),\n                }));\n              }\n              // Update the activation count when a module commits. The\n              // ring's fraction comes from this; `event`/`module`/\n              // `humanizedName` were set by the matching `activating`\n              // message above and are left alone so the count can advance\n              // without re-firing the host's status callback.\n              if (module && state === 'activated' && !readyRef.current) {\n                const active = manager.getActive();\n                const total = manager.getModules().length;\n                setStartupProgress((current) => ({\n                  ...current,\n                  activated: active.length,\n                  total,\n                  progress: total > 0 ? active.length / total : 0,\n                }));\n              }\n              // Event-level `activating` (no `module`) — fired at the start\n              // of `_activateModulesForEvent` and recursively for each\n              // before/after event. Surfaces a label during the gap before\n              // the first module-level message lands; subsequent module\n              // updates immediately overwrite this with a more specific\n              // label.\n              if (event && !module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  event,\n                  module: undefined,\n                  humanizedName: humanizeEventKey(event),\n                }));\n              }\n              if (error$ && !readyRef.current) {\n                setError(error$);\n                errorRef.current = error$;\n              }\n            }),\n          ),\n          Effect.forever,\n        ),\n      );\n\n      yield* Effect.all([\n        ...setupEvents.map((event) => manager.activate(event)),\n        manager.activate(ActivationEvents.SetupReactSurface),\n        manager.activate(ActivationEvents.Startup),\n      ]);\n\n      return yield* Fiber.join(listener);\n    }).pipe(Effect.scoped, Effect.runFork);\n\n    // Set up a timeout for startup.\n    const timeoutId = setTimeout(() => {\n      if (!readyRef.current && !errorRef.current) {\n        log.warn('startup timeout diagnostic', {\n          eventsFired: manager.getEventsFired(),\n          activeModules: manager.getActive(),\n          pendingReset: manager.getPendingReset(),\n        });\n        void runAndForwardErrors(Fiber.interrupt(fiber));\n        setError(new Error(`Startup timed out after ${timeout}ms`));\n      }\n    }, timeout);\n\n    return () => {\n      log('useApp: effect cleanup');\n      clearTimeout(timeoutId);\n      void runAndForwardErrors(Fiber.interrupt(fiber));\n      if (!isExternalManager) {\n        void runAndForwardErrors(manager.shutdown());\n      }\n    };\n  }, [manager]);\n\n  const progressRef = useRef(startupProgress);\n  progressRef.current = startupProgress;\n\n  return useCallback(\n    () => (\n      <ErrorBoundary name='app' FallbackComponent={fallback}>\n        <PluginManagerProvider value={manager}>\n          <ContextProtocolProvider value={manager} context={PluginManagerContext}>\n            <RegistryContext.Provider value={manager.registry}>\n              <App\n                placeholder={placeholder}\n                ready={ready}\n                error={error}\n                debounce={debounce}\n                progress={progressRef.current}\n              />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, placeholder, ready, error],\n  );\n};\n\nconst setupDevtools = (manager: PluginManager.PluginManager) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.manager = manager;\n};\n\n/**\n * Extracts a human-readable label from a module ID.\n *\n * Module IDs follow `org.dxos.plugin.<plugin-slug>.module.<module-name>`,\n * where `<plugin-slug>` is kebab-case and `<module-name>` is either an\n * explicit string (often kebab-case, e.g. `'observability'`, `'namespace'`)\n * or a capability tag in PascalCase from `Capability.getModuleTag(...)`\n * (e.g. `'ReactSurface'`, `'AppGraphBuilder'`). The output is\n * `\"Title Case Plugin: kebab-module\"` so the visible status names both the\n * plugin and the aspect being activated, helping disambiguate the multiple\n * modules a plugin contributes.\n *\n * Examples:\n *   - \"org.dxos.plugin.markdown.module.ReactSurface\" → \"Markdown: react-surface\"\n *   - \"org.dxos.plugin.observability.module.AppGraphBuilder\" → \"Observability: app-graph-builder\"\n *   - \"org.dxos.plugin.observability.module.observability\" → \"Observability\"\n *     (the module name matches the plugin slug — collapsed to avoid\n *     \"Observability: observability\" noise.)\n */\nconst humanizeModuleId = (moduleId: string): string => {\n  const match = moduleId.match(/\\.plugin\\.([^.]+)\\.module\\.(.+)$/);\n  if (!match) {\n    // Fallback: use the last segment.\n    const parts = moduleId.split('.');\n    return parts[parts.length - 1];\n  }\n  const [, pluginSlug, moduleName] = match;\n  const pluginLabel = pluginSlug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n  // Normalise the module name to kebab-case so PascalCase capability tags\n  // (\"ReactSurface\") read consistently with explicit kebab IDs\n  // (\"operation-handler\"). The two-step substitution handles consecutive\n  // uppercase runs (`URLLoader` → `url-loader`) without splitting them\n  // mid-acronym.\n  const moduleLabel = moduleName\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase();\n  // Capability modules whose name matches the plugin slug (e.g. the\n  // observability plugin's `observability` capability module) would render\n  // as \"Observability: observability\" — drop the redundant suffix.\n  if (moduleLabel === pluginSlug) {\n    return pluginLabel;\n  }\n  return `${pluginLabel}: ${moduleLabel}`;\n};\n\n/**\n * Extracts a human-readable label from an activation event key.\n * E.g., \"org.dxos.app-framework.event.setup-react-surface\" → \"Setup React Surface\".\n */\nconst humanizeEventKey = (eventKey: string): string => {\n  // Strip a leading specifier (composite key form: \"<id>:<specifier>\").\n  const id = eventKey.split(':')[0];\n  // Match the trailing segment after `.event.`.\n  const match = id.match(/\\.event\\.(.+)$/);\n  const slug = match ? match[1] : (id.split('.').pop() ?? id);\n  return slug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback } from 'react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { Capabilities } from '../../common';\nimport { type Capability } from '../../core';\nimport { usePluginManager } from '../components';\n\n/**\n * Hook to request capabilities from the plugin context.\n * @returns An array of capabilities.\n */\nexport const useCapabilities = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const manager = usePluginManager();\n  return useAtomValue(manager.capabilities.atom(interfaceDef));\n};\n\n/**\n * Hook to request a capability from the plugin context.\n * @returns The capability.\n * @throws If no capability is found.\n */\nexport const useCapability = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const capabilities = useCapabilities(interfaceDef);\n  invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`);\n  return capabilities[0];\n};\n\n/**\n * Hook to get the current value of an atom capability.\n * Automatically subscribes to changes.\n * @example const settings = useAtomCapability(ThreadCapabilities.Settings);\n */\nexport const useAtomCapability = <T>(atomCapability: Capability.InterfaceDef<Atom.Atom<T>>): T => {\n  const atom = useCapability(atomCapability);\n  return useAtomValue(atom);\n};\n\n/**\n * Hook to get value and updater for an atom capability.\n * Returns [currentValue, updateFn] similar to useState.\n * @example const [settings, updateSettings] = useAtomCapabilityState(ThreadCapabilities.Settings);\n */\nexport const useAtomCapabilityState = <T>(\n  atomCapability: Capability.InterfaceDef<Atom.Writable<T>>,\n): [T, (fn: (current: T) => T) => void] => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const atom = useCapability(atomCapability);\n  const value = useAtomValue(atom);\n  const update = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n  return [value, update];\n};\n\n/**\n * Hook to get the operation invoker capability.\n */\nexport const useOperationInvoker = (): Capabilities.OperationInvoker => useCapability(Capabilities.OperationInvoker);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useRef, useState } from 'react';\n\nexport enum LoadingState {\n  Loading = 0,\n  FadeIn = 1,\n  FadeOut = 2,\n  Done = 3,\n}\n\n/**\n * To avoid \"flashing\" the placeholder, we wait a period of time before starting the loading animation.\n * If loading completes during this time the placehoder is not shown, otherwise is it displayed for a minimum period of time.\n *\n * States:\n * 0: Loading   - Wait for a period of time before starting the loading animation.\n * 1: Fade-in   - Display a loading animation.\n * 2: Fade-out  - Fade out the loading animation.\n * 3: Done      - Remove the placeholder.\n */\nexport const useLoading = (ready: boolean, debounce = 0) => {\n  const [stage, setStage] = useState<LoadingState>(LoadingState.Loading);\n  // Mirror `ready` into a ref so the interval's `setStage` callback can read\n  // the latest value without depending on the effect re-running. The pure\n  // closure-capture pattern (with `ready` in deps) sticks the FSM at\n  // `FadeIn` whenever HMR doesn't propagate the dep change end-to-end —\n  // a ref sidesteps that entirely and fires the read on every tick.\n  const readyRef = useRef(ready);\n  readyRef.current = ready;\n\n  useEffect(() => {\n    if (!debounce) {\n      return;\n    }\n\n    const i = setInterval(() => {\n      setStage((stage) => {\n        const isReady = readyRef.current;\n        switch (stage) {\n          case LoadingState.Loading: {\n            if (!isReady) {\n              return LoadingState.FadeIn;\n            }\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n\n          case LoadingState.FadeIn: {\n            if (isReady) {\n              return LoadingState.FadeOut;\n            }\n            break;\n          }\n\n          case LoadingState.FadeOut: {\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n        }\n\n        return stage;\n      });\n    }, debounce);\n\n    return () => clearInterval(i);\n  }, [debounce]);\n\n  if (!debounce) {\n    return ready ? LoadingState.Done : LoadingState.Loading;\n  }\n\n  return stage;\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport { type DependencyList, use, useCallback, useMemo } from 'react';\n\nimport { ServiceResolver } from '@dxos/compute';\nimport { unwrapExit } from '@dxos/effect';\nimport type { SpaceId } from '@dxos/keys';\n\nimport { Capabilities } from '../../common';\nimport { useCapability } from './useCapabilities';\n\n/**\n * Resolve the shared {@link Capabilities.ProcessManagerRuntime} from the plugin context.\n */\nexport const useProcessManagerRuntime = (): Capabilities.ProcessManagerRuntime =>\n  useCapability(Capabilities.ProcessManagerRuntime);\n\n/**\n * Build a callback that runs an effect on the {@link Capabilities.ProcessManagerRuntime}\n * with space-scoped services resolved via {@link ServiceResolver.provide}.\n *\n * The `tags` tuple must list every service the effect requires (beyond the\n * fixed {@link Capabilities.ProcessManagerRuntimeServices}); these services are\n * resolved for the given `spaceId` through the runtime's service resolver.\n */\nexport const useSpaceCallback = <const Tags extends readonly Context.Tag<any, any>[], T>(\n  spaceId: SpaceId | undefined,\n  tags: Tags,\n  fn: () => Effect.Effect<T, any, Context.Tag.Identifier<Tags[number]> | Capabilities.ProcessManagerRuntimeServices>,\n  deps?: DependencyList,\n): (() => Promise<T>) => {\n  const runtime = useProcessManagerRuntime();\n  return useCallback(() => {\n    if (spaceId === undefined) {\n      throw new TypeError('Space not provided to useSpaceCallback');\n    }\n    const layer = ServiceResolver.provide({ space: spaceId }, ...tags);\n    return runtime.runPromise(fn().pipe(Effect.provide(layer)) as Effect.Effect<T, any, any>);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [runtime, spaceId, ...(deps ?? [])]);\n};\n\n/**\n * Suspensefully resolve a single space-scoped service via the\n * {@link Capabilities.ProcessManagerRuntime}'s service resolver.\n */\nexport const useSpaceService = <T extends Context.Tag<any, any>>(\n  tag: T,\n  spaceId: SpaceId | undefined,\n): Context.Tag.Service<T> | undefined => {\n  const runtime = useProcessManagerRuntime();\n  const promise = useMemo(() => {\n    if (spaceId === undefined) {\n      return undefined;\n    }\n    const layer = ServiceResolver.provide({ space: spaceId }, tag);\n    const effect = Effect.flatMap(tag, (service) => Effect.succeed(service)).pipe(Effect.provide(layer));\n    return runtime.runPromiseExit(effect as Effect.Effect<Context.Tag.Service<T>, any, any>);\n  }, [runtime, spaceId, tag]);\n  if (!promise) {\n    return undefined;\n  }\n  return unwrapExit(use(promise));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, RegistryContext, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useContext } from 'react';\n\n/**\n * Hook to read and update a settings atom.\n * Returns the current value and an update function.\n */\nexport const useSettingsState = <T>(\n  atom: Atom.Writable<T>,\n): { settings: T; updateSettings: (fn: (current: T) => T) => void } => {\n  const registry = useContext(RegistryContext);\n  const settings = useAtomValue(atom);\n\n  const updateSettings = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n\n  return { settings, updateSettings };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type ReactNode, useEffect, useLayoutEffect, useRef } from 'react';\n\nimport { ThemeProvider } from '@dxos/react-ui';\nimport { defaultTx, mx } from '@dxos/ui-theme';\n\nimport { type PlaceholderProps as PlaceholderSlotProps } from '../../hooks';\n\ndeclare global {\n  interface Window {\n    /**\n     * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`.\n     * Declared here so the {@link Placeholder} can dismiss the native-DOM\n     * loader once the React placeholder commits without each host having to\n     * re-declare the type.\n     */\n    __bootLoader?: {\n      status: (payload: {\n        event?: string;\n        module?: string;\n        humanized: string;\n        /**\n         * Optional `(index/total)` tick. When present, the loader replaces the\n         * current line in place (\"Loading plugins (12/80)\") instead of\n         * appending a new entry — keeps the visible log compact during long\n         * counted phases like plugin chunk-loading or module activation.\n         */\n        range?: { index: number; total: number };\n      }) => void;\n      progress: (fraction?: number) => void;\n      dismiss: () => void;\n    };\n  }\n}\n\nexport type PlaceholderComponentProps = PlaceholderSlotProps & {\n  /**\n   * Brand mark rendered while the React tree settles. Pass either a static\n   * `ReactNode` (the framework wraps it in a sizing/animation div) or a\n   * render function that receives the precomputed `className` so the host\n   * can apply it directly to its logo (e.g. an SVG that accepts `className`\n   * — `composer-app` passes `(p) => <Composer {...p} />` from `@dxos/brand`).\n   */\n  logo?: ReactNode | ((props: { className: string }) => ReactNode);\n};\n\n/**\n * React placeholder. The native-DOM boot loader is the visible UI through\n * stages 0 (Loading) and 1 (FadeIn): we render `null` until `stage >= 2`\n * (FadeOut) and instead feed activation progress + status into the still-\n * alive boot loader. At stage 2 the loader dismisses and the React mark\n * appears for the cross-fade to the real shell:\n *\n *   - composer-app fills `0 → 50%` from `getPlugins`'s per-chunk counter.\n *   - this component fills `50 → 100%` from `useApp`'s\n *     `startupProgress.progress` (`activated / total` modules) and pushes\n *     the per-module status text to the loader's status line.\n *   - at `stage >= 2` the boot loader is dismissed and the React mark\n *     starts its `FadeOut → Done` shrink-and-fade.\n *\n * Stage progression (driven by `useApp`):\n *   - `0` — Loading: native-DOM boot loader visible. Placeholder renders nothing.\n *   - `1` — FadeIn: same — boot loader still owns the screen.\n *   - `2` — FadeOut: boot loader dismissed, React mark visible at full opacity then shrinks.\n */\nexport const Placeholder = ({ stage = 1, progress, logo }: PlaceholderComponentProps) => {\n  // Used in tests to exercise the error boundary & reset dialog.\n  if (location.search === '?throw') {\n    throw new Error('Test error');\n  }\n\n  // Phase B: feed activation progress + status to the still-visible boot\n  // loader. Maps `[0, 1]` activation → `[0.5, 1]` of the ring; forwards\n  // the raw activation source (`event` / `module`) plus the pre-humanised\n  // label to `__bootLoader.status` so the loader gets to decide how to\n  // render and trace each transition (current default policy: \"Activating\n  // <humanizedName>\"; trace mode and timings track the structured fields).\n  // No-op once the loader has been dismissed (its `status()` early-returns\n  // when the boot DOM is gone). Skipping `stage >= 2` lets the dismissal\n  // run uncontended.\n  useEffect(() => {\n    if (stage >= 2) {\n      return;\n    }\n    const fraction = progress?.progress ?? 0;\n    window.__bootLoader?.progress(0.5 + fraction * 0.5);\n    if (progress?.humanizedName) {\n      window.__bootLoader?.status({\n        event: progress.event,\n        module: progress.module,\n        humanized: `Activating ${progress.humanizedName}`,\n      });\n    }\n  }, [stage, progress?.progress, progress?.event, progress?.module, progress?.humanizedName]);\n\n  // Hand off from the native-DOM boot loader once the placeholder starts\n  // fading out — keeping the loader visible through `stage 0` and `stage 1`\n  // means the ring stays the visible source of truth for activation\n  // progress. `useLayoutEffect` runs before the next paint so the loader\n  // DOM is removed in the same frame the cross-fade begins.\n  useLayoutEffect(() => {\n    if (stage >= 2) {\n      window.__bootLoader?.dismiss();\n    }\n  }, [stage]);\n\n  // Backstop for the fast-load path where `useLoading` can skip straight\n  // from stage 0 to `Done` (ready=true at the first debounce tick) — the\n  // stage-driven effect above never sees `stage >= 2`, so dismiss on\n  // unmount instead. The `stageRef` guard is what keeps StrictMode's\n  // synthetic mount → cleanup → remount cycle from prematurely dismissing\n  // the loader: the synthetic cleanup runs while `stageRef.current === 0`,\n  // skips the dismiss, and the real unmount (later, at stage `Done`)\n  // performs it.\n  const stageRef = useRef(stage);\n  stageRef.current = stage;\n  useEffect(() => {\n    return () => {\n      if (stageRef.current >= 3 /* Done */) {\n        window.__bootLoader?.dismiss();\n      }\n    };\n  }, []);\n\n  // Defer rendering anything until the FadeOut stage. The boot loader owns\n  // the screen during stages 0 and 1, so any DOM we render here would just\n  // sit invisibly behind it — and rendering null avoids paint cost during\n  // the longest part of the loading sequence (plugin activation).\n  if (stage < 2) {\n    return null;\n  }\n\n  const logoClassName = mx(\n    'h-[300px] w-[300px] scale-600 transition-all duration-500 ease-in-out filter grayscale opacity-0',\n    stage >= 1 && 'scale-100 grayscale-0 opacity-70',\n    stage >= 2 && 'scale-50 opacity-0',\n  );\n\n  return (\n    <ThemeProvider tx={defaultTx}>\n      <div className='relative dx-container h-dvh flex flex-col'>\n        <div className='flex flex-col grow justify-center items-center'>\n          {typeof logo === 'function' ? (\n            logo({ className: logoClassName })\n          ) : logo ? (\n            <div className={logoClassName}>{logo}</div>\n          ) : null}\n        </div>\n      </div>\n    </ThemeProvider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["React", "useEffect", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "runAndForwardErrors", "invariant", "log", "ErrorBoundary", "ErrorFallback", "useAsyncEffect", "useDefaultValue", "ContextProtocolProvider", "ENABLED_KEY", "defaults", "useDefaultValue", "defaultsProp", "setupEvents", "setupEventsProp", "pluginLoader", "pluginLoaderProp", "plugin", "find", "meta", "invariant", "id", "plugins", "errorRef", "useRef", "error", "setError", "useState", "startupProgress", "setStartupProgress", "activated", "total", "progress", "safeMode", "cacheEnabled", "cached", "pluginManager", "enabled", "onRemove", "pluginRegistryProvider", "mgr", "onPluginRemove", "useEffect", "manager", "useAsyncEffect", "capabilities", "contribute", "interface", "Capabilities", "PluginManager", "implementation", "module", "registry", "fiber", "forkDaemon", "setReady", "readyRef", "current", "globalThis", "humanizedName", "humanizeModuleId", "length", "active", "event", "error$", "Effect", "forever", "activate", "ActivationEvents", "Startup", "join", "listener", "pipe", "timeoutId", "eventsFired", "getEventsFired", "activeModules", "pendingReset", "getPendingReset", "runAndForwardErrors", "Fiber", "Error", "timeout", "clearTimeout", "interrupt", "isExternalManager", "shutdown", "progressRef", "name", "FallbackComponent", "fallback", "value", "ContextProtocolProvider", "PluginManagerContext", "App", "placeholder", "ready", "debounce", "composer", "match", "parts", "pluginSlug", "moduleName", "pluginLabel", "split", "map", "word", "useAtomValue", "useCallback", "invariant", "__dxlog_file", "useAtomValue", "capabilities", "interfaceDef", "invariant", "atom", "useCapability", "atomCapability", "value", "update", "fn", "registry", "set", "useCallback", "useEffect", "useRef", "useState", "LoadingState", "useLoading", "ready", "debounce", "stage", "setStage", "readyRef", "current", "i", "setInterval", "isReady", "clearInterval", "Effect", "use", "useCallback", "useMemo", "ServiceResolver", "unwrapExit", "useProcessManagerRuntime", "useCapability", "Capabilities", "ProcessManagerRuntime", "useSpaceCallback", "spaceId", "tags", "fn", "deps", "runtime", "useCallback", "undefined", "TypeError", "layer", "ServiceResolver", "provide", "space", "runPromise", "pipe", "useSpaceService", "tag", "promise", "useMemo", "effect", "flatMap", "service", "succeed", "runPromiseExit", "unwrapExit", "use", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "settings", "updateSettings", "fn", "set", "get", "FIRST_INTERACTIVE_MARK", "App", "placeholder", "Placeholder", "ready", "error", "debounce", "progress", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "placeholderDismissed", "LoadingState", "Done", "useEffect", "performance", "getEntriesByName", "length", "mark", "window", "__bootLoader", "dismiss", "React", "ComposedContext", "composeContexts", "map", "id", "root", "Component", "key", "contexts", "children", "topologicalSort", "context", "reduce", "Acc", "Next", "React", "useEffect", "useLayoutEffect", "useRef", "ThemeProvider", "defaultTx", "mx", "Placeholder", "stage", "progress", "logo", "location", "search", "Error", "fraction", "window", "__bootLoader", "humanizedName", "status", "event", "module", "humanized", "dismiss", "stageRef", "current", "logoClassName", "tx", "div", "className"]
+}

package/dist/lib/node-esm/chunk-KFZEB6BV.mjs

@@ -0,0 +1,29 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  activation_event_exports
+} from "./chunk-XOCUANHO.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/common/activation-events.ts
+var activation_events_exports = {};
+__export(activation_events_exports, {
+  ProcessManagerReady: () => ProcessManagerReady,
+  SetupProcessManager: () => SetupProcessManager,
+  SetupReactSurface: () => SetupReactSurface,
+  Startup: () => Startup
+});
+var Startup = activation_event_exports.make("org.dxos.app-framework.event.startup");
+var SetupReactSurface = activation_event_exports.make("org.dxos.app-framework.event.setup-react-surface");
+var SetupProcessManager = activation_event_exports.make("org.dxos.app-framework.event.setup-process-manager");
+var ProcessManagerReady = activation_event_exports.make("org.dxos.app-framework.event.process-manager-ready");
+
+export {
+  Startup,
+  SetupReactSurface,
+  SetupProcessManager,
+  ProcessManagerReady,
+  activation_events_exports
+};
+//# sourceMappingURL=chunk-KFZEB6BV.mjs.map

package/dist/lib/node-esm/chunk-KFZEB6BV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/activation-events.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { ActivationEvent as ActivationEvent$ } from '../core';\n\n/**\n * Fired when the app is started.\n */\nexport const Startup = ActivationEvent$.make('org.dxos.app-framework.event.startup');\n\n//\n// Dependent Events\n//\n\n/**\n * Fired to load any newly available surfaces.\n */\nexport const SetupReactSurface = ActivationEvent$.make('org.dxos.app-framework.event.setup-react-surface');\n\n/**\n * Fired before the process manager is created.\n * Plugins should contribute their {@link Capabilities.LayerSpec} entries and\n * {@link Capabilities.OperationHandler} sets before this event fires so the\n * process manager's {@link ServiceResolver} and {@link OperationInvoker} pick\n * them up at construction time.\n */\nexport const SetupProcessManager = ActivationEvent$.make('org.dxos.app-framework.event.setup-process-manager');\n\n//\n// Triggered Events\n//\n\n/**\n * Fired after the process manager runtime is ready and its derived capabilities\n * (`ProcessManagerRuntime`, `ServiceResolver`, `ProcessMonitor`, `OperationInvoker`)\n * have been contributed.\n */\nexport const ProcessManagerReady = ActivationEvent$.make('org.dxos.app-framework.event.process-manager-ready');\n"],
+  "mappings": ";;;;;;;;;AAAA;;;;;;;AASO,IAAMA,UAAUC,yBAAiBC,KAAK,sCAAA;AAStC,IAAMC,oBAAoBF,yBAAiBC,KAAK,kDAAA;AAShD,IAAME,sBAAsBH,yBAAiBC,KAAK,oDAAA;AAWlD,IAAMG,sBAAsBJ,yBAAiBC,KAAK,oDAAA;",
+  "names": ["Startup", "ActivationEvent$", "make", "SetupReactSurface", "SetupProcessManager", "ProcessManagerReady"]
+}

package/dist/lib/node-esm/{chunk-WKTLE7MG.mjs → chunk-LJNUFNDO.mjs}

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   capabilities_exports
-} from "./chunk-WFSRZKBP.mjs";
+} from "./chunk-PW2VYGOS.mjs";
 
 // src/helpers.ts
 var topologicalSort = (nodes) => {
@@ -95,7 +95,6 @@ var SurfaceInfo = /* @__PURE__ */ forwardRef(({ children }, forwardedRef) => {
   const padding = 0;
   return /* @__PURE__ */ React.createElement(React.Fragment, null, childWithRef, rect && /* @__PURE__ */ createPortal(
     /* @__PURE__ */ React.createElement("div", {
-      role: "none",
       className: "z-[100] fixed flex flex-col-reverse scrollbar-none overflow-auto pointer-events-none",
       style: {
         top: rect.top + padding,
@@ -365,7 +364,6 @@ var SurfaceContextProvider = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef2(({
       ],
       FallbackComponent: fallback
     }, /* @__PURE__ */ React3.createElement("div", {
-      role: "none",
       className: "contents",
       "data-id": id,
       "data-role": role
@@ -397,7 +395,6 @@ var SurfaceContextProvider = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef2(({
     ],
     FallbackComponent: fallback
   }, /* @__PURE__ */ React3.createElement("div", {
-    role: "none",
     className: "contents",
     "data-id": id,
     "data-role": role
@@ -421,7 +418,7 @@ var SurfaceComponent = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef2(({ id: _
     if (DEBUG) {
       log.warn("Surface has neither `role` nor `type` prop", {
         id: _id
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 196, S: void 0 });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 194, S: void 0 });
     }
     return null;
   }
@@ -434,7 +431,7 @@ var SurfaceComponent = /* @__PURE__ */ memo(/* @__PURE__ */ forwardRef2(({ id: _
     log.warn("no candidates for surface", {
       role: effectiveRole,
       data
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 209, S: void 0 });
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 207, S: void 0 });
     return null;
   }
   return /* @__PURE__ */ React3.createElement(Suspense, {
@@ -582,4 +579,4 @@ export {
   SurfaceComponent,
   Surface
 };
-//# sourceMappingURL=chunk-WKTLE7MG.mjs.map
+//# sourceMappingURL=chunk-LJNUFNDO.mjs.map