@dxos/app-framework 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/lib/browser/chunk-Y66ELD4U.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useEffect, useLayoutEffect } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type StartupProgress, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\ndeclare global {\n  interface Window {\n    /**\n     * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`\n     * (a Solid app inlined into `index.html`). Declared here — on a module that\n     * is part of the `@dxos/app-framework/ui` export surface — so the React side\n     * and host apps (e.g. composer-app) can drive the loader without each\n     * re-declaring the type. The canonical definition lives in the plugin's\n     * `loader-app/types.ts`; this mirror exists because that source compiles in a\n     * separate (Solid) program that doesn't ship its globals to consumers.\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 appending\n         * a new entry — keeps the visible log compact during long counted phases.\n         */\n        range?: { index: number; total: number };\n      }) => void;\n      progress: (fraction?: number) => void;\n      ready: () => void;\n      dismiss: () => void;\n    };\n  }\n}\n\nexport type AppProps = Pick<UseAppOptions, 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n  progress?: StartupProgress;\n};\n\nconst FIRST_INTERACTIVE_MARK = 'app-framework:first-interactive';\n\nexport const App = ({ 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  // Relay the startup lifecycle into the boot loader injected by\n  // `@dxos/app-framework/vite-plugin` (a Solid app inlined into `index.html`,\n  // the only visible loading UI). Plugin activation fills the `[0.5, 1]` half\n  // of the ring; the raw `event` / `module` ids ride along so the loader owns\n  // how each transition is rendered and traced. No-op once the outro has\n  // started (`FadeOut`), so the dismissal runs uncontended.\n  useEffect(() => {\n    if (stage >= LoadingState.FadeOut) {\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 at fade-out: play the loader's graceful shrink-and-fade outro.\n  // `useLayoutEffect` runs before the next paint so the outro begins in the\n  // same frame the real shell starts rendering beneath it.\n  useLayoutEffect(() => {\n    if (stage >= LoadingState.FadeOut) {\n      window.__bootLoader?.ready();\n    }\n  }, [stage]);\n\n  // Emit a once-per-app `app-framework:first-interactive` mark the first time\n  // the loader is dismissed and the real app shell renders. Closes the gap\n  // between `Startup` activated and the first interactive paint.\n  //\n  // Also the framework-owned handoff-complete signal: `dismiss()` removes the\n  // loader immediately on the fast-load path (where `useLoading` skips\n  // `FadeOut`), and is a no-op once an outro is already in flight, so it never\n  // cuts the animation short.\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.__bootLoader?.dismiss();\n  }, [placeholderDismissed]);\n\n  // Used in tests to exercise the error boundary & reset dialog (see\n  // composer-app's `basic.spec.ts`). Thrown into the surrounding `ErrorBoundary`.\n  if (location.search === '?throw') {\n    throw new Error('Test error');\n  }\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // The boot loader owns the screen until handoff completes; render nothing\n  // until then (any DOM here would sit invisibly behind the `z-index: 10`\n  // loader anyway).\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (!placeholderDismissed) {\n    return null;\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 { EffectEx } 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 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};\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 */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  onPluginRemove,\n  pluginRegistryProvider,\n  plugins: pluginsProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\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 boot loader 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              // boot loader can decide how to render each transition — 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 EffectEx.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 EffectEx.runAndForwardErrors(Fiber.interrupt(fiber));\n      if (!isExternalManager) {\n        void EffectEx.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 ready={ready} error={error} debounce={debounce} progress={progressRef.current} />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, 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 */\n// TODO(burdon): Option not to throw?\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(CommentCapabilities.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(CommentCapabilities.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 * as Layer from 'effect/Layer';\nimport { type DependencyList, use, useCallback, useMemo } from 'react';\n\nimport { Operation, ServiceResolver } from '@dxos/compute';\nimport { EffectEx } 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 *\n * Nested `Operation.invoke` / `Operation.schedule` calls within the effect\n * inherit `spaceId` as a default {@link Operation.InvokeOptions} so that\n * spawned operation processes have a space context (and therefore can resolve\n * space-scoped services like `Database.Service`) without each call site having\n * to thread the id through manually.\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 = Layer.merge(\n      ServiceResolver.provide({ space: spaceId }, ...tags),\n      Operation.withInvocationOptions({ spaceId }),\n    );\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 EffectEx.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"],
-  "mappings": "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",
-  "names": ["React", "useEffect", "useLayoutEffect", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "EffectEx", "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", "interrupt", "Error", "timeout", "clearTimeout", "Fiber", "isExternalManager", "EffectEx", "shutdown", "progressRef", "name", "FallbackComponent", "fallback", "value", "ContextProtocolProvider", "PluginManagerContext", "App", "ready", "debounce", "composer", "match", "parts", "pluginSlug", "moduleName", "pluginLabel", "split", "map", "word", "useAtomValue", "useCallback", "invariant", "__dxlog_file", "useAtomValue", "capabilities", "interfaceDef", "invariant", "length", "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", "Layer", "use", "useCallback", "useMemo", "Operation", "ServiceResolver", "EffectEx", "useProcessManagerRuntime", "useCapability", "Capabilities", "ProcessManagerRuntime", "useSpaceCallback", "spaceId", "tags", "fn", "deps", "runtime", "useCallback", "undefined", "TypeError", "layer", "merge", "ServiceResolver", "provide", "space", "Operation", "withInvocationOptions", "runPromise", "pipe", "useSpaceService", "tag", "promise", "useMemo", "effect", "flatMap", "service", "succeed", "runPromiseExit", "EffectEx", "unwrapExit", "use", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "settings", "updateSettings", "fn", "set", "get", "FIRST_INTERACTIVE_MARK", "App", "ready", "error", "debounce", "progress", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "placeholderDismissed", "LoadingState", "Done", "useEffect", "FadeOut", "fraction", "window", "__bootLoader", "humanizedName", "status", "event", "module", "humanized", "useLayoutEffect", "performance", "getEntriesByName", "length", "mark", "dismiss", "location", "search", "Error", "ComposedContext", "composeContexts", "React", "map", "id", "root", "Component", "key", "contexts", "children", "topologicalSort", "context", "reduce", "Acc", "Next"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/helpers.ts", "../../../src/ui/hooks/useSurface.ts", "../../../src/ui/components/PluginManager/PluginManagerProvider.ts", "../../../src/ui/components/Surface/context.ts", "../../../src/ui/components/Surface/SurfaceComponent.tsx", "../../../src/ui/components/Surface/SurfaceInfo.tsx", "../../../src/ui/components/Surface/SurfaceProfilerContext.tsx", "../../../src/ui/components/Surface/types.ts", "../../../src/ui/components/Surface/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\ntype DependencyNode = {\n  id: string;\n  dependsOn?: string[];\n};\n\n/**\n * Topologically sorts a list of nodes based on their dependencies.\n */\n// TODO(wittjosiah): Factor out?\nexport const topologicalSort = <T extends DependencyNode>(nodes: T[]): T[] => {\n  const getDependencies = (nodeId: string, seen = new Set<string>(), path = new Set<string>()): string[] => {\n    if (path.has(nodeId)) {\n      throw new Error(`Circular dependency detected involving ${nodeId}`);\n    }\n    if (seen.has(nodeId)) {\n      return [];\n    }\n\n    const node = nodes.find((n) => n.id === nodeId);\n    if (!node) {\n      throw new Error(`Node ${nodeId} not found but is listed as a dependency`);\n    }\n\n    const newPath = new Set([...path, nodeId]);\n    const newSeen = new Set([...seen, nodeId]);\n\n    const dependsOn = node.dependsOn ?? [];\n    return [...dependsOn.flatMap((depId) => getDependencies(depId, newSeen, newPath)), nodeId];\n  };\n\n  // Get all unique dependencies.\n  const allDependencies = nodes\n    .map((node) => node.id)\n    .flatMap((id) => getDependencies(id))\n    .filter((id, index, self) => self.indexOf(id) === index);\n\n  // Map back to original nodes\n  return allDependencies\n    .map((id) => nodes.find((node) => node.id === id))\n    .filter((node): node is T => node !== undefined);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { Surface } from '../components';\n\nexport const useSurface = (): Surface.Context => {\n  return useContext(Surface.Context) ?? raise(new Error('Missing SurfaceContext'));\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { createContext, useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { type PluginManager } from '../../../core';\n\nconst PluginManagerContext = createContext<PluginManager.PluginManager | undefined>(undefined);\n\n/**\n * Get the plugin manager.\n */\nexport const usePluginManager = (): PluginManager.PluginManager =>\n  useContext(PluginManagerContext) ?? raise(new Error('Missing PluginManagerContext'));\n\n/**\n * Context provider for a plugin manager.\n */\nexport const PluginManagerProvider = PluginManagerContext.Provider;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Context, createContext } from 'react';\n\nimport { type Props } from './types';\n\nexport type SurfaceContext = Pick<Props, 'id' | 'role' | 'data'>;\n\n// TODO(burdon): Use @radix-ui/react-context\nexport const SurfaceContext: Context<SurfaceContext | undefined> = createContext<SurfaceContext | undefined>(undefined);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useAtomValue } from '@effect-atom/atom-react';\nimport React, {\n  Fragment,\n  type NamedExoticComponent,\n  Profiler,\n  type RefAttributes,\n  Suspense,\n  forwardRef,\n  memo,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport { log } from '@dxos/log';\nimport { ErrorBoundary } from '@dxos/react-error-boundary';\nimport { useDefaultValue } from '@dxos/react-hooks';\nimport { byPosition } from '@dxos/util';\n\nimport { Capabilities } from '../../../common';\nimport { type CapabilityManager } from '../../../core';\nimport { usePluginManager } from '../PluginManager/PluginManagerProvider';\nimport { SurfaceContext } from './context';\nimport { SurfaceInfo } from './SurfaceInfo';\nimport { useSurfaceProfilerCallback } from './SurfaceProfilerContext';\nimport {\n  type Definition,\n  type Props,\n  type RoleToken,\n  type TokenData,\n  type TypedProps,\n  type WebComponentDefinition,\n} from './types';\n\nconst DEBUG = import.meta.env.VITE_DEBUG;\n\nconst DEFAULT_PLACEHOLDER = <Fragment />;\n\n/**\n * Wrapper component for rendering Web Component surfaces.\n * Handles creation, prop setting, and cleanup of Web Components.\n */\nconst WebComponentWrapper = memo(\n  forwardRef<HTMLElement, Omit<Props, 'role'> & { role: string; definition: WebComponentDefinition }>(\n    ({ id, role, data, limit, definition, ...rest }, forwardedRef) => {\n      const containerRef = useRef<HTMLDivElement>(null);\n      const elementRef = useRef<HTMLElement | null>(null);\n      const propsRef = useRef({ id, role, data, limit, ...rest });\n\n      // Update props ref on every render\n      propsRef.current = { id, role, data, limit, ...rest };\n\n      // Create element only once\n      useEffect(() => {\n        if (!containerRef.current || elementRef.current) {\n          return;\n        }\n\n        // Create the Web Component\n        const element = document.createElement(definition.tagName);\n        elementRef.current = element;\n\n        // Set initial properties on the Web Component\n        Object.assign(element, propsRef.current);\n\n        // Append to container\n        containerRef.current.appendChild(element);\n\n        // Setup ref forwarding if provided\n        if (typeof forwardedRef === 'function') {\n          forwardedRef(element);\n        } else if (forwardedRef) {\n          forwardedRef.current = element;\n        }\n\n        // Cleanup on unmount to prevent memory leaks\n        return () => {\n          if (elementRef.current && containerRef.current?.contains(elementRef.current)) {\n            containerRef.current.removeChild(elementRef.current);\n          }\n          if (typeof forwardedRef === 'function') {\n            forwardedRef(null);\n          } else if (forwardedRef) {\n            forwardedRef.current = null;\n          }\n          elementRef.current = null;\n        };\n      }, [definition.tagName, forwardedRef]);\n\n      // Update props on existing element without recreating it\n      // This runs on every render to ensure all props (including those in `rest`) are kept up to date\n      useEffect(() => {\n        const element = elementRef.current;\n        if (!element) {\n          return;\n        }\n\n        // Update properties on the existing Web Component\n        Object.assign(element, propsRef.current);\n      });\n\n      return <div ref={containerRef} />;\n    },\n  ),\n);\n\nWebComponentWrapper.displayName = 'WebComponentWrapper';\n\n/**\n * Wrapper component that provides context for a surface.\n */\n// TODO(burdon): Allow DebugPlugin to provide different fallback using react-ui ErrorFallback.\nconst SurfaceContextProvider = memo(\n  forwardRef<HTMLElement, Omit<Props, 'role'> & { role: string; definition: Definition }>(\n    ({ id, role, data, limit, fallback = ErrorFallback, definition, ...rest }, forwardedRef) => {\n      const contextValue = useMemo(() => ({ id, role, data }), [id, role, data]);\n      const onProfilerRender = useSurfaceProfilerCallback();\n      const profilerId = `surface/${id}/${role}`;\n\n      // Handle Web Component surfaces\n      if (definition.kind === 'web-component') {\n        return (\n          <ErrorBoundary name='surface' resetKeys={[data]} FallbackComponent={fallback}>\n            <SurfaceContext.Provider value={contextValue}>\n              <WebComponentWrapper\n                id={id}\n                role={role}\n                data={data}\n                limit={limit}\n                definition={definition}\n                ref={forwardedRef}\n                {...rest}\n              />\n            </SurfaceContext.Provider>\n          </ErrorBoundary>\n        );\n      }\n\n      // Handle React component surfaces\n      const Component = definition.component;\n\n      // TODO(burdon): Remove from production build?\n      const debug = DEBUG || '__DX_DEBUG__' in window;\n      if (debug) {\n        return (\n          <ErrorBoundary name='surface' resetKeys={[data]} FallbackComponent={fallback}>\n            <div className='contents' data-id={id} data-role={role}>\n              <SurfaceContext.Provider value={contextValue}>\n                <SurfaceInfo ref={forwardedRef}>\n                  {onProfilerRender && !profilerId.includes('org.dxos.plugin.debug') ? (\n                    <Profiler id={profilerId} onRender={onProfilerRender}>\n                      <Component id={id} role={role} data={data} limit={limit} {...rest} />\n                    </Profiler>\n                  ) : (\n                    <Component id={id} role={role} data={data} limit={limit} {...rest} />\n                  )}\n                </SurfaceInfo>\n              </SurfaceContext.Provider>\n            </div>\n          </ErrorBoundary>\n        );\n      }\n\n      return (\n        <ErrorBoundary name='surface' resetKeys={[data]} FallbackComponent={fallback}>\n          <div className='contents' data-id={id} data-role={role}>\n            <SurfaceContext.Provider value={contextValue}>\n              <Component id={id} role={role} data={data} limit={limit} {...rest} ref={forwardedRef} />\n            </SurfaceContext.Provider>\n          </div>\n        </ErrorBoundary>\n      );\n    },\n  ),\n);\n\nSurfaceContextProvider.displayName = 'SurfaceContextProvider';\n\n/**\n * A surface is a named region of the screen that can be populated by plugins.\n */\n// TODO(burdon): Remove `ref` since relying on this would be error prone.\nexport const SurfaceComponent = memo(\n  forwardRef<HTMLElement, Props & { type?: RoleToken<any> }>(\n    ({ id: _id, role, type, data: dataProp, limit, placeholder = DEFAULT_PLACEHOLDER, ...rest }, forwardedRef) => {\n      const data = useDefaultValue(dataProp, () => ({}));\n      // TODO(wittjosiah): This will make all surfaces depend on a single signal.\n      //   This isn't ideal because it means that any change to the data will cause all surfaces to re-render.\n      //   This effectively means that plugin modules which contribute surfaces need to all be activated at startup.\n      //   This should be fine for now because it's how it worked prior to capabilities api anyway.\n      //   In the future, it would be nice to be able to bucket the surface contributions by role.\n      const surfaces = useSurfaces();\n\n      const effectiveRole = role ?? type?.role;\n      if (effectiveRole == null) {\n        if (DEBUG) {\n          log.warn('Surface has neither `role` nor `type` prop', { id: _id });\n        }\n        return null;\n      }\n\n      // NOTE: Memoizing the candidates makes the surface not re-render based on reactivity within data.\n      const definitions = findCandidates(surfaces, { role: effectiveRole, data });\n      const candidates = limit ? definitions.slice(0, limit) : definitions;\n      if (DEBUG && candidates.length === 0) {\n        log.warn('no candidates for surface', { role: effectiveRole, data });\n        return null;\n      }\n\n      return (\n        <Suspense fallback={placeholder}>\n          {candidates.map((definition) => (\n            <SurfaceContextProvider\n              key={definition.id}\n              id={definition.id}\n              role={effectiveRole}\n              data={data}\n              limit={limit}\n              definition={definition}\n              ref={forwardedRef}\n              {...rest}\n            />\n          ))}\n        </Suspense>\n      );\n    },\n  ),\n) as (<TToken extends RoleToken<any>>(props: TypedProps<TToken> & RefAttributes<HTMLElement>) => React.ReactNode) &\n  NamedExoticComponent<Props & RefAttributes<HTMLElement>>;\n\nSurfaceComponent.displayName = 'Surface';\n\n// TODO(burdon): Make user facing, with telemetry.\nconst ErrorFallback = ({ error }: Props) => {\n  const { message } = error instanceof Error ? error : { message: String(error) };\n  return (\n    <div role='alert' data-testid='error-boundary-fallback'>\n      <h1 className='flex gap-2 text-sm mt-2 text-info-text'>{message}</h1>\n    </div>\n  );\n};\n\nconst findCandidates = (surfaces: Definition[], { role, data }: { role: string; data: Props['data'] }) => {\n  return Object.values(surfaces)\n    .filter((definition) =>\n      Array.isArray(definition.role) ? definition.role.includes(role) : definition.role === role,\n    )\n    .filter(({ filter }) => (filter ? filter(data ?? {}, role) : true))\n    .toSorted(byPosition);\n};\n\n/**\n * @internal\n */\nexport const useSurfaces = () => {\n  const manager = usePluginManager();\n  const surfacesByModule = useAtomValue(manager.capabilities.atomByModule(Capabilities.ReactSurface));\n  return useMemo(() => {\n    const result: Definition[] = [];\n    for (const [moduleId, surfaces] of Object.entries(surfacesByModule)) {\n      for (const def of surfaces.flat()) {\n        result.push(def);\n      }\n    }\n    return result;\n  }, [surfacesByModule]);\n};\n\n/**\n * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.\n *\n * Two overloads:\n * - Typed: pass a `type` role token and `data` is constrained to the token's\n *   declared contract (e.g. `AppSurface.Section` requires `attendableId`).\n * - Legacy: pass a string `role` and `data` is untyped.\n */\nexport function isSurfaceAvailable<TToken extends RoleToken<any>>(\n  capabilityManager: CapabilityManager.CapabilityManager,\n  args: { type: TToken; data?: TokenData<TToken>; role?: never },\n): boolean;\nexport function isSurfaceAvailable(\n  capabilityManager: CapabilityManager.CapabilityManager,\n  args: Pick<Props, 'role' | 'data'> & { type?: undefined },\n): boolean;\nexport function isSurfaceAvailable(\n  capabilityManager: CapabilityManager.CapabilityManager,\n  { role, type, data }: { role?: string; type?: RoleToken<any>; data?: unknown },\n): boolean {\n  const effectiveRole = role ?? type?.role;\n  if (effectiveRole == null) {\n    return false;\n  }\n  const surfaces = capabilityManager.getAll(Capabilities.ReactSurface);\n  const candidates = findCandidates(surfaces.flat(), {\n    role: effectiveRole,\n    data: data as Props['data'],\n  });\n  return candidates.length > 0;\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  type ReactElement,\n  type Ref,\n  cloneElement,\n  forwardRef,\n  useCallback,\n  useLayoutEffect,\n  useState,\n} from 'react';\nimport { createPortal } from 'react-dom';\n\nimport { addEventListener, combine } from '@dxos/async';\nimport { useMergeRefs } from '@dxos/react-hooks';\n\nimport { useSurface } from '../../hooks';\n\nexport type SurfaceInfoProps = {\n  children: ReactElement<{ ref?: Ref<HTMLElement> }>;\n};\n\n/**\n * Debug wrapper for surfaces.\n */\nexport const SurfaceInfo = forwardRef<HTMLElement, SurfaceInfoProps>(({ children }, forwardedRef) => {\n  const [rect, setRect] = useState<DOMRect | null>(null);\n  const [expand, setExpand] = useState(false);\n  const info = useSurface();\n\n  const [root, setRoot] = useState<HTMLElement | null>(null);\n  const measureRef = useCallback((node: HTMLElement | null) => setRoot(node), []);\n  const mergedRef = useMergeRefs([measureRef, forwardedRef]);\n  const childWithRef = cloneElement(children, { ref: mergedRef });\n\n  useLayoutEffect(() => {\n    if (!root) {\n      setRect(null);\n      return;\n    }\n\n    const measure = () => {\n      setRect(root.getBoundingClientRect());\n    };\n\n    const observer = new ResizeObserver(measure);\n    observer.observe(root);\n    measure();\n\n    return combine(\n      addEventListener(window, 'scroll', measure, true),\n      addEventListener(window, 'resize', measure),\n      () => {\n        observer.disconnect();\n      },\n    );\n  }, [root]);\n\n  const padding = 0;\n  return (\n    <>\n      {childWithRef}\n      {rect &&\n        createPortal(\n          <div\n            className='z-[100] fixed flex flex-col-reverse scrollbar-none overflow-auto pointer-events-none'\n            style={{\n              top: rect.top + padding,\n              left: rect.left + padding,\n              width: rect.width - padding * 2,\n              height: rect.height - padding * 2,\n            }}\n          >\n            {expand ? (\n              <div\n                className='absolute inset-0 bg-deck-surface border border-green-500 cursor-pointer pointer-events-auto overflow-auto'\n                onPointerDown={(ev) => ev.stopPropagation()}\n                onClick={(ev) => {\n                  ev.stopPropagation();\n                  setExpand(false);\n                }}\n              >\n                <pre className='p-2 text-xs text-description font-mono'>{JSON.stringify({ info }, null, 2)}</pre>\n              </div>\n            ) : (\n              <span\n                className='absolute right-1 bottom-0 flex items-center p-1 text-green-500 opacity-80 hover:opacity-100 text-xl cursor-pointer pointer-events-auto'\n                title={info.id}\n                onPointerDown={(ev) => ev.stopPropagation()}\n                onClick={(ev) => {\n                  ev.stopPropagation();\n                  setExpand(true);\n                }}\n              >\n                ⓘ\n              </span>\n            )}\n          </div>,\n          // TODO(burdon): Create well-known element to gather all debug portals.\n          document.body,\n        )}\n    </>\n  );\n});\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport React, {\n  type Context,\n  type PropsWithChildren,\n  type ProfilerOnRenderCallback,\n  createContext,\n  useContext,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nconst MAX_ENTRIES = 500;\n\n/**\n * Single profiler record captured from React Profiler onRender callback.\n */\nexport type SurfaceProfilerEntry = {\n  id: string;\n  phase: 'mount' | 'update' | 'nested-update';\n  actualDuration: number;\n  baseDuration: number;\n  startTime: number;\n  commitTime: number;\n  timestamp: number;\n};\n\n/**\n * Aggregated stats for a single profiled surface.\n */\nexport type SurfaceProfilerStats = {\n  id: string;\n  mountCount: number;\n  updateCount: number;\n  totalRenders: number;\n  avgActualDuration: number;\n  maxActualDuration: number;\n  avgBaseDuration: number;\n  lastActualDuration: number;\n  lastCommitTime: number;\n};\n\n/**\n * Store that collects profiler entries and notifies subscribers.\n */\nclass SurfaceProfilerStore {\n  private _entries: SurfaceProfilerEntry[] = [];\n  private _listeners = new Set<() => void>();\n  private _snapshot: readonly SurfaceProfilerEntry[] = [];\n  private _pendingNotify = false;\n\n  /** Records an entry and schedules a deferred notification to avoid re-render loops. */\n  record(entry: SurfaceProfilerEntry) {\n    this._entries.push(entry);\n    if (this._entries.length > MAX_ENTRIES) {\n      this._entries = this._entries.slice(-MAX_ENTRIES);\n    }\n    this._snapshot = [...this._entries];\n    this._scheduleNotify();\n  }\n\n  clear() {\n    this._entries = [];\n    this._snapshot = [];\n    this._notifySync();\n  }\n\n  subscribe = (listener: () => void) => {\n    this._listeners.add(listener);\n    return () => {\n      this._listeners.delete(listener);\n    };\n  };\n\n  getSnapshot = (): readonly SurfaceProfilerEntry[] => {\n    return this._snapshot;\n  };\n\n  /**\n   * Defers notification to the next animation frame to break the\n   * Profiler onRender → record → notify → re-render → onRender loop.\n   */\n  private _scheduleNotify() {\n    if (!this._pendingNotify) {\n      this._pendingNotify = true;\n      requestAnimationFrame(() => {\n        this._pendingNotify = false;\n        this._notifySync();\n      });\n    }\n  }\n\n  private _notifySync() {\n    for (const listener of this._listeners) {\n      listener();\n    }\n  }\n}\n\ntype SurfaceProfilerContextValue = {\n  store: SurfaceProfilerStore;\n};\n\nconst SurfaceProfilerContext: Context<SurfaceProfilerContextValue | undefined> = createContext<\n  SurfaceProfilerContextValue | undefined\n>(undefined);\n\n/**\n * Provider that collects React Profiler data from Surface components.\n */\nexport const SurfaceProfilerProvider = ({ children }: PropsWithChildren) => {\n  const storeRef = useRef<SurfaceProfilerStore>(null);\n  if (!storeRef.current) {\n    storeRef.current = new SurfaceProfilerStore();\n  }\n  return (\n    <SurfaceProfilerContext.Provider value={{ store: storeRef.current }}>{children}</SurfaceProfilerContext.Provider>\n  );\n};\n\n/**\n * Returns a stable onRender callback for use with React Profiler.\n */\nexport const useSurfaceProfilerCallback = (): ProfilerOnRenderCallback | undefined => {\n  const store = useContext(SurfaceProfilerContext)?.store;\n  return useMemo<ProfilerOnRenderCallback | undefined>(() => {\n    if (!store) {\n      return undefined;\n    }\n    return (id, phase, actualDuration, baseDuration, startTime, commitTime) => {\n      store.record({\n        id,\n        phase,\n        actualDuration,\n        baseDuration,\n        startTime,\n        commitTime,\n        timestamp: Date.now(),\n      });\n    };\n  }, [store]);\n};\n\n/**\n * Returns all profiler entries reactively.\n */\nexport const useSurfaceProfilerEntries = (): readonly SurfaceProfilerEntry[] => {\n  const context = useContext(SurfaceProfilerContext);\n  return useSyncExternalStore(context?.store.subscribe ?? noop, context?.store.getSnapshot ?? emptySnapshot);\n};\n\n/**\n * Returns aggregated stats grouped by surface id.\n */\nexport const useSurfaceProfilerStats = (): SurfaceProfilerStats[] => {\n  const entries = useSurfaceProfilerEntries();\n  const statsMap = new Map<string, SurfaceProfilerStats>();\n\n  for (const entry of entries) {\n    let stats = statsMap.get(entry.id);\n    if (!stats) {\n      stats = {\n        id: entry.id,\n        mountCount: 0,\n        updateCount: 0,\n        totalRenders: 0,\n        avgActualDuration: 0,\n        maxActualDuration: 0,\n        avgBaseDuration: 0,\n        lastActualDuration: 0,\n        lastCommitTime: 0,\n      };\n      statsMap.set(entry.id, stats);\n    }\n\n    if (entry.phase === 'mount') {\n      stats.mountCount++;\n    } else {\n      stats.updateCount++;\n    }\n    stats.totalRenders++;\n    stats.avgActualDuration =\n      (stats.avgActualDuration * (stats.totalRenders - 1) + entry.actualDuration) / stats.totalRenders;\n    stats.avgBaseDuration =\n      (stats.avgBaseDuration * (stats.totalRenders - 1) + entry.baseDuration) / stats.totalRenders;\n    stats.maxActualDuration = Math.max(stats.maxActualDuration, entry.actualDuration);\n    stats.lastActualDuration = entry.actualDuration;\n    stats.lastCommitTime = entry.commitTime;\n  }\n\n  return [...statsMap.values()].sort((a, b) => b.maxActualDuration - a.maxActualDuration);\n};\n\n/**\n * Clears all collected profiler entries.\n */\nexport const useSurfaceProfilerClear = (): (() => void) | undefined => {\n  const store = useContext(SurfaceProfilerContext)?.store;\n  return useMemo(() => (store ? () => store.clear() : undefined), [store]);\n};\n\nconst noop = () => () => {};\nconst EMPTY_SNAPSHOT: readonly SurfaceProfilerEntry[] = [];\nconst emptySnapshot = () => EMPTY_SNAPSHOT;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { FC, PropsWithChildren, ReactNode, RefCallback } from 'react';\n\nimport type { MakeOptional, Position } from '@dxos/util';\n\n/**\n * A typed role token. Carries a role string for runtime dispatch plus a phantom\n * data type so consumers using `type={SomeToken}` and providers using\n * `AppSurface.object(SomeToken, ...)` share a single type-level contract.\n *\n * Mint via {@link makeType}.\n */\nexport type RoleToken<TData> = {\n  readonly role: string;\n  /** Covariant phantom; never accessed at runtime. */\n  readonly _phantom?: TData;\n};\n\n/**\n * One entry in a {@link SurfaceFilter} — a role plus the guard that validates\n * the data shape when the Surface dispatcher is matching that role.\n */\nexport type SurfaceBinding = {\n  readonly role: string;\n  readonly guard: (data: unknown) => boolean;\n};\n\n/**\n * Typed filter binding for {@link create}. Combines one or more `(role, guard)`\n * pairs so a provider can register against multiple roles while keeping the\n * role and its data shape in a single expression.\n */\nexport type SurfaceFilter<TData> = {\n  readonly bindings: ReadonlyArray<SurfaceBinding>;\n  /** Covariant phantom; never accessed at runtime. */\n  readonly _phantom?: TData;\n};\n\n/**\n * Narrow data type carried by a role token.\n */\nexport type TokenData<T> = T extends RoleToken<infer D> ? D : never;\n\n/**\n * Runtime guard for {@link SurfaceFilter}. Distinguishes new-style filter\n * bindings from legacy predicate filters.\n */\nexport const isSurfaceFilter = (value: unknown): value is SurfaceFilter<any> =>\n  typeof value === 'object' && value !== null && Array.isArray((value as { bindings?: unknown }).bindings);\n\n/**\n * Mints a typed role token. Identity is structural; all tokens with the same\n * `role` string are interchangeable at runtime.\n */\nexport const makeType = <TData>(role: string): RoleToken<TData> => ({ role });\n\n/**\n * Props that are passed to the Surface component.\n *\n * The role can be provided either as a string via `role` or as a typed\n * {@link RoleToken} via `type`. The typed form narrows `data` to the token's\n * declared shape.\n */\nexport type Props<T extends Record<string, any> = Record<string, unknown>> = {\n  /**\n   * If specified, the Surface will be wrapped in an error boundary.\n   * The fallback component will be rendered if an error occurs.\n   */\n  fallback?: FC<{ error: Error; data?: any }>;\n\n  /**\n   * If specified, the Surface will be wrapped in a suspense boundary.\n   * The placeholder component will be rendered while the surface component is loading.\n   */\n  placeholder?: ReactNode;\n} & MakeOptional<CoreProps<T>, 'id' | 'data' | 'role'> & {\n    /**\n     * Explicitly disallow `type` on the untyped Props overload — if the caller\n     * provides `type={AppSurface.X}`, TypeScript must route to the typed\n     * overload (where `data` is narrowed by the token). Without this, the\n     * catch-all index signature below would accept any `type` value and mask\n     * the typed overload entirely.\n     */\n    type?: undefined;\n  } /**\n   * Additional props to pass to the component.\n   * These props are not used by Surface itself but may be used by components which resolve the surface.\n   * Exclude known prop names to prevent overriding well-defined props.\n   */ & {\n    [K in keyof Record<string, any>]: K extends keyof CoreProps<T> | 'fallback' | 'placeholder' | 'type' ? never : any;\n  };\n\n/**\n * Typed Surface consumer props — carries the role/data-shape contract via a\n * {@link RoleToken}. Available as a typed overload of the Surface component so\n * ad-hoc `type` fields on arbitrary spread props don't conflict with the\n * untyped consumer form.\n */\nexport type TypedProps<TToken extends RoleToken<any>> = {\n  fallback?: FC<{ error: Error; data?: any }>;\n  placeholder?: ReactNode;\n  id?: string;\n  type: TToken;\n  data?: TokenData<TToken>;\n  limit?: number | undefined;\n} & {\n  /**\n   * Additional pass-through props. Known prop names are excluded so the\n   * catch-all doesn't widen `data` / `type` / etc. to `any` at the intersection.\n   */\n  [K in keyof Record<string, any>]: K extends 'fallback' | 'placeholder' | 'id' | 'type' | 'data' | 'limit'\n    ? never\n    : any;\n};\n\n/**\n * NOTE: If `[key: string]: unknown` is included in shared types, when re-used other fields become unknown as well.\n */\nexport type CoreProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{\n  /**\n   * ID for debugging.\n   */\n  id: string;\n\n  /**\n   * Role defines how the data should be rendered. For new code, prefer the\n   * typed overload of the Surface component which takes a {@link RoleToken}\n   * via the `type` prop instead — it enforces a role/data contract at compile\n   * time.\n   */\n  role: string;\n\n  /**\n   * The data to be rendered by the surface.\n   * NOTE: This must be a stable value.\n   */\n  data: T;\n\n  /**\n   * If more than one component is resolved, the limit determines how many are rendered.\n   */\n  limit?: number | undefined;\n}>;\n\n// TODO(burdon): Remove ref since relying on this would be error prone.\nexport type ComponentProps<T extends Record<string, any> = Record<string, any>> = CoreProps<T> & {\n  ref?: RefCallback<HTMLElement>;\n} & Record<string, any>;\n\n/**\n * React component used to render a surface once is has matched.\n */\nexport type ComponentFunction<T extends Record<string, any> = Record<string, any>> = (\n  props: ComponentProps<T>,\n) => ReactNode;\n\n/**\n * Definition of when a React component surface should be rendered.\n *\n * The optional `filter` receives the consumer-supplied `role` as its second\n * argument so a single definition can encode role-specific guards (used by the\n * {@link SurfaceFilter}-based `create` overload).\n */\nexport type ReactDefinition<T extends Record<string, any> = any> = Readonly<{\n  kind: 'react';\n  id: string;\n  role: string | string[];\n  position?: Position;\n  component: ComponentFunction<T>;\n  filter?: (data: Record<string, unknown>, role?: string) => data is T;\n}>;\n\n/**\n * Definition of when a Web Component surface should be rendered.\n */\nexport type WebComponentDefinition<T extends Record<string, any> = any> = Readonly<{\n  kind: 'web-component';\n  id: string;\n  role: string | string[];\n  position?: Position;\n  /**\n   * The tag name of the Web Component to render.\n   * The Web Component will receive the same props as React surfaces via properties/attributes.\n   */\n  tagName: string;\n  filter?: (data: Record<string, unknown>, role?: string) => data is T;\n}>;\n\n/**\n * Definition of when a surface (React or Web Component) should be rendered.\n */\nexport type Definition<T extends Record<string, any> = any> = ReactDefinition<T> | WebComponentDefinition<T>;\n\n/**\n * Typed React surface definition — role is derived from the filter's bindings.\n */\nexport type TypedReactDefinition<T extends Record<string, any> = any> = Readonly<{\n  id: string;\n  filter: SurfaceFilter<T>;\n  component: ComponentFunction<T>;\n  position?: Position;\n}>;\n\n/**\n * Typed Web Component surface definition.\n */\nexport type TypedWebComponentDefinition<T extends Record<string, any> = any> = Readonly<{\n  id: string;\n  filter: SurfaceFilter<T>;\n  tagName: string;\n  position?: Position;\n}>;\n\nconst expandBindings = <T extends Record<string, any>>(\n  filter: SurfaceFilter<T>,\n): { role: string | string[]; guard: (data: Record<string, unknown>, role?: string) => data is T } => {\n  const bindings = filter.bindings;\n  const roles = Array.from(new Set(bindings.map((binding) => binding.role)));\n  const guard = (data: Record<string, unknown>, role?: string): data is T => {\n    if (role != null) {\n      // Multiple bindings may share a role (e.g. via `oneOf` of same-role filters);\n      // the role matches if ANY of them passes.\n      return bindings.some((entry) => entry.role === role && entry.guard(data));\n    }\n    return bindings.some((entry) => entry.guard(data));\n  };\n  return { role: roles.length === 1 ? roles[0] : roles, guard };\n};\n\n/**\n * Validates that a surface or extension local ID follows NSID conventions:\n * each dot-separated segment must be alphanumeric, and the final segment must\n * be camelCase (no hyphens). This mirrors the rule enforced when the id is\n * appended to a plugin's NSID to form a full DXN path.\n *\n * @example Valid:   'about', 'integrationArticle', 'article.journal'\n * @example Invalid: 'integration-article', 'plugin-spec'\n */\nconst validateLocalId = (id: string): void => {\n  const segments = id.split('.');\n  const finalSegment = segments[segments.length - 1];\n  if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(finalSegment)) {\n    throw new Error(\n      `Invalid surface id: \"${id}\". The final segment \"${finalSegment}\" must be camelCase (letters and digits only, starting with a letter — no hyphens or underscores).`,\n    );\n  }\n};\n\n/**\n * Creates a React surface definition.\n */\nexport function create<T extends Record<string, any> = any>(definition: TypedReactDefinition<T>): ReactDefinition<T>;\nexport function create<T extends Record<string, any> = any>(\n  definition: Omit<ReactDefinition<T>, 'kind'>,\n): ReactDefinition<T>;\nexport function create<T extends Record<string, any> = any>(\n  definition: TypedReactDefinition<T> | Omit<ReactDefinition<T>, 'kind'>,\n): ReactDefinition<T> {\n  validateLocalId(definition.id);\n  if (isSurfaceFilter(definition.filter)) {\n    const { id, filter, component, position } = definition as TypedReactDefinition<T>;\n    const { role, guard } = expandBindings(filter);\n    return { kind: 'react', id, role, position, component, filter: guard };\n  }\n  return { ...(definition as Omit<ReactDefinition<T>, 'kind'>), kind: 'react' };\n}\n\n/**\n * Creates a Web Component surface definition.\n */\nexport function createWeb<T extends Record<string, any> = any>(\n  definition: TypedWebComponentDefinition<T>,\n): WebComponentDefinition<T>;\nexport function createWeb<T extends Record<string, any> = any>(\n  definition: Omit<WebComponentDefinition<T>, 'kind'>,\n): WebComponentDefinition<T>;\nexport function createWeb<T extends Record<string, any> = any>(\n  definition: TypedWebComponentDefinition<T> | Omit<WebComponentDefinition<T>, 'kind'>,\n): WebComponentDefinition<T> {\n  validateLocalId(definition.id);\n  if (isSurfaceFilter(definition.filter)) {\n    const { id, filter, tagName, position } = definition as TypedWebComponentDefinition<T>;\n    const { role, guard } = expandBindings(filter);\n    return { kind: 'web-component', id, role, position, tagName, filter: guard };\n  }\n  return { ...(definition as Omit<WebComponentDefinition<T>, 'kind'>), kind: 'web-component' };\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n// TODO(wittjosiah): Cleanup to avoid re-naming.\nimport { SurfaceContext } from './context';\nimport { SurfaceComponent, isSurfaceAvailable } from './SurfaceComponent';\nimport {\n  SurfaceProfilerProvider,\n  useSurfaceProfilerCallback,\n  useSurfaceProfilerClear,\n  useSurfaceProfilerEntries,\n  useSurfaceProfilerStats,\n} from './SurfaceProfilerContext';\nimport {\n  type Definition as SurfaceDefinition,\n  type RoleToken as SurfaceRoleToken,\n  type SurfaceBinding as SurfaceBindingType,\n  type SurfaceFilter as SurfaceFilterType,\n  type TokenData as SurfaceTokenData,\n  type TypedProps as SurfaceTypedProps,\n  create as createSurface,\n  createWeb as createWebSurface,\n  isSurfaceFilter as isSurfaceFilterFn,\n  makeType as makeTypeFn,\n} from './types';\n\nexport namespace Surface {\n  export type Definition = SurfaceDefinition;\n  export const create = createSurface;\n  export const createWeb = createWebSurface;\n\n  export type Context = SurfaceContext;\n  export const Context = SurfaceContext;\n\n  export const Surface = SurfaceComponent;\n  export const isAvailable = isSurfaceAvailable;\n\n  export type RoleToken<TData> = SurfaceRoleToken<TData>;\n  export type Binding = SurfaceBindingType;\n  export type Filter<TData> = SurfaceFilterType<TData>;\n  export type TokenData<T> = SurfaceTokenData<T>;\n  export type TypedProps<TToken extends SurfaceRoleToken<any>> = SurfaceTypedProps<TToken>;\n  export const makeType = makeTypeFn;\n  export const isFilter = isSurfaceFilterFn;\n\n  export const ProfilerProvider = SurfaceProfilerProvider;\n  export const useProfilerCallback = useSurfaceProfilerCallback;\n  export const useProfilerEntries = useSurfaceProfilerEntries;\n  export const useProfilerStats = useSurfaceProfilerStats;\n  export const useProfilerClear = useSurfaceProfilerClear;\n}\n\nexport type { SurfaceProfilerEntry, SurfaceProfilerStats } from './SurfaceProfilerContext';\n"],
-  "mappings": "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",
-  "names": ["topologicalSort", "nodes", "getDependencies", "nodeId", "seen", "Set", "path", "has", "Error", "node", "find", "n", "id", "newPath", "newSeen", "dependsOn", "flatMap", "depId", "allDependencies", "map", "filter", "index", "self", "indexOf", "undefined", "useContext", "raise", "createContext", "useContext", "raise", "PluginManagerContext", "undefined", "usePluginManager", "Error", "PluginManagerProvider", "Provider", "createContext", "SurfaceContext", "undefined", "useAtomValue", "React", "Fragment", "Profiler", "Suspense", "forwardRef", "memo", "useEffect", "useMemo", "useRef", "log", "ErrorBoundary", "useDefaultValue", "byPosition", "React", "cloneElement", "forwardRef", "useCallback", "useLayoutEffect", "useState", "createPortal", "addEventListener", "combine", "useMergeRefs", "SurfaceInfo", "forwardRef", "children", "forwardedRef", "rect", "setRect", "useState", "expand", "setExpand", "info", "useSurface", "root", "setRoot", "measureRef", "useCallback", "node", "mergedRef", "useMergeRefs", "childWithRef", "cloneElement", "ref", "useLayoutEffect", "measure", "getBoundingClientRect", "observer", "ResizeObserver", "observe", "combine", "addEventListener", "window", "disconnect", "padding", "createPortal", "div", "className", "style", "top", "left", "width", "height", "onPointerDown", "ev", "stopPropagation", "onClick", "pre", "JSON", "stringify", "span", "title", "id", "document", "body", "React", "createContext", "useContext", "useMemo", "useRef", "useSyncExternalStore", "MAX_ENTRIES", "SurfaceProfilerStore", "_entries", "_listeners", "Set", "_snapshot", "_pendingNotify", "record", "entry", "push", "length", "slice", "_scheduleNotify", "clear", "_notifySync", "subscribe", "listener", "add", "delete", "getSnapshot", "requestAnimationFrame", "SurfaceProfilerContext", "undefined", "SurfaceProfilerProvider", "children", "storeRef", "current", "Provider", "value", "store", "useSurfaceProfilerCallback", "id", "phase", "actualDuration", "baseDuration", "startTime", "commitTime", "timestamp", "Date", "now", "useSurfaceProfilerEntries", "context", "noop", "emptySnapshot", "useSurfaceProfilerStats", "entries", "statsMap", "Map", "stats", "get", "mountCount", "updateCount", "totalRenders", "avgActualDuration", "maxActualDuration", "avgBaseDuration", "lastActualDuration", "lastCommitTime", "set", "Math", "max", "values", "sort", "a", "b", "useSurfaceProfilerClear", "EMPTY_SNAPSHOT", "elementRef", "forwardRef", "propsRef", "useRef", "id", "role", "data", "limit", "useEffect", "Object", "assign", "element", "containerRef", "current", "appendChild", "forwardedRef", "definition", "div", "WebComponentWrapper", "React", "FallbackComponent", "value", "contextValue", "ref", "debug", "DEBUG", "name", "className", "data-role", "SurfaceInfo", "onProfilerRender", "includes", "profilerId", "Component", "SurfaceContextProvider", "effectiveRole", "log", "SurfaceComponent", "ErrorFallback", "String", "error", "message", "findCandidates", "surfacesByModule", "useAtomValue", "useMemo", "moduleId", "def", "result", "surfaces", "isSurfaceFilter", "value", "Array", "isArray", "bindings", "makeType", "role", "expandBindings", "filter", "roles", "from", "Set", "map", "binding", "guard", "data", "some", "entry", "length", "validateLocalId", "id", "segments", "split", "finalSegment", "test", "Error", "create", "definition", "component", "position", "kind", "createWeb", "tagName", "Surface", "create", "createSurface", "createWeb", "createWebSurface", "Context", "SurfaceContext", "SurfaceComponent", "isAvailable", "isSurfaceAvailable", "makeType", "makeTypeFn", "isFilter", "isSurfaceFilterFn", "ProfilerProvider", "SurfaceProfilerProvider", "useProfilerCallback", "useSurfaceProfilerCallback", "useProfilerEntries", "useSurfaceProfilerEntries", "useProfilerStats", "useSurfaceProfilerStats", "useProfilerClear", "useSurfaceProfilerClear", "useSurface", "useContext", "Surface", "Context", "raise", "Error"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "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-FSVGKTF6.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useEffect, useLayoutEffect } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type StartupProgress, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\ndeclare global {\n  interface Window {\n    /**\n     * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`\n     * (a Solid app inlined into `index.html`). Declared here — on a module that\n     * is part of the `@dxos/app-framework/ui` export surface — so the React side\n     * and host apps (e.g. composer-app) can drive the loader without each\n     * re-declaring the type. The canonical definition lives in the plugin's\n     * `loader-app/types.ts`; this mirror exists because that source compiles in a\n     * separate (Solid) program that doesn't ship its globals to consumers.\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 appending\n         * a new entry — keeps the visible log compact during long counted phases.\n         */\n        range?: { index: number; total: number };\n      }) => void;\n      progress: (fraction?: number) => void;\n      ready: () => void;\n      dismiss: () => void;\n    };\n  }\n}\n\nexport type AppProps = Pick<UseAppOptions, 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n  progress?: StartupProgress;\n};\n\nconst FIRST_INTERACTIVE_MARK = 'app-framework:first-interactive';\n\nexport const App = ({ 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  // Relay the startup lifecycle into the boot loader injected by\n  // `@dxos/app-framework/vite-plugin` (a Solid app inlined into `index.html`,\n  // the only visible loading UI). Plugin activation fills the `[0.5, 1]` half\n  // of the ring; the raw `event` / `module` ids ride along so the loader owns\n  // how each transition is rendered and traced. No-op once the outro has\n  // started (`FadeOut`), so the dismissal runs uncontended.\n  useEffect(() => {\n    if (stage >= LoadingState.FadeOut) {\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 at fade-out: play the loader's graceful shrink-and-fade outro.\n  // `useLayoutEffect` runs before the next paint so the outro begins in the\n  // same frame the real shell starts rendering beneath it.\n  useLayoutEffect(() => {\n    if (stage >= LoadingState.FadeOut) {\n      window.__bootLoader?.ready();\n    }\n  }, [stage]);\n\n  // Emit a once-per-app `app-framework:first-interactive` mark the first time\n  // the loader is dismissed and the real app shell renders. Closes the gap\n  // between `Startup` activated and the first interactive paint.\n  //\n  // Also the framework-owned handoff-complete signal: `dismiss()` removes the\n  // loader immediately on the fast-load path (where `useLoading` skips\n  // `FadeOut`), and is a no-op once an outro is already in flight, so it never\n  // cuts the animation short.\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.__bootLoader?.dismiss();\n  }, [placeholderDismissed]);\n\n  // Used in tests to exercise the error boundary & reset dialog (see\n  // composer-app's `basic.spec.ts`). Thrown into the surrounding `ErrorBoundary`.\n  if (location.search === '?throw') {\n    throw new Error('Test error');\n  }\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // The boot loader owns the screen until handoff completes; render nothing\n  // until then (any DOM here would sit invisibly behind the `z-index: 10`\n  // loader anyway).\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (!placeholderDismissed) {\n    return null;\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 { EffectEx } 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 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};\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 */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  onPluginRemove,\n  pluginRegistryProvider,\n  plugins: pluginsProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\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 boot loader 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              // boot loader can decide how to render each transition — 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 EffectEx.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 EffectEx.runAndForwardErrors(Fiber.interrupt(fiber));\n      if (!isExternalManager) {\n        void EffectEx.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 ready={ready} error={error} debounce={debounce} progress={progressRef.current} />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, 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 */\n// TODO(burdon): Option not to throw?\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(CommentCapabilities.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(CommentCapabilities.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 * as Layer from 'effect/Layer';\nimport { type DependencyList, use, useCallback, useMemo } from 'react';\n\nimport { Operation, ServiceResolver } from '@dxos/compute';\nimport { EffectEx } 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 *\n * Nested `Operation.invoke` / `Operation.schedule` calls within the effect\n * inherit `spaceId` as a default {@link Operation.InvokeOptions} so that\n * spawned operation processes have a space context (and therefore can resolve\n * space-scoped services like `Database.Service`) without each call site having\n * to thread the id through manually.\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 = Layer.merge(\n      ServiceResolver.provide({ space: spaceId }, ...tags),\n      Operation.withInvocationOptions({ spaceId }),\n    );\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 EffectEx.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"],
-  "mappings": "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",
-  "names": ["React", "useEffect", "useLayoutEffect", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "EffectEx", "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", "interrupt", "Error", "timeout", "clearTimeout", "Fiber", "isExternalManager", "EffectEx", "shutdown", "progressRef", "name", "FallbackComponent", "fallback", "value", "ContextProtocolProvider", "PluginManagerContext", "App", "ready", "debounce", "composer", "match", "parts", "pluginSlug", "moduleName", "pluginLabel", "split", "map", "word", "useAtomValue", "useCallback", "invariant", "__dxlog_file", "useAtomValue", "capabilities", "interfaceDef", "invariant", "length", "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", "Layer", "use", "useCallback", "useMemo", "Operation", "ServiceResolver", "EffectEx", "useProcessManagerRuntime", "useCapability", "Capabilities", "ProcessManagerRuntime", "useSpaceCallback", "spaceId", "tags", "fn", "deps", "runtime", "useCallback", "undefined", "TypeError", "layer", "merge", "ServiceResolver", "provide", "space", "Operation", "withInvocationOptions", "runPromise", "pipe", "useSpaceService", "tag", "promise", "useMemo", "effect", "flatMap", "service", "succeed", "runPromiseExit", "EffectEx", "unwrapExit", "use", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "settings", "updateSettings", "fn", "set", "get", "FIRST_INTERACTIVE_MARK", "App", "ready", "error", "debounce", "progress", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "placeholderDismissed", "LoadingState", "Done", "useEffect", "FadeOut", "fraction", "window", "__bootLoader", "humanizedName", "status", "event", "module", "humanized", "useLayoutEffect", "performance", "getEntriesByName", "length", "mark", "dismiss", "location", "search", "Error", "ComposedContext", "composeContexts", "React", "map", "id", "root", "Component", "key", "contexts", "children", "topologicalSort", "context", "reduce", "Acc", "Next"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "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-NULBHQYS.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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 Exit$ from 'effect/Exit';\nimport type * as Fiber$ from 'effect/Fiber';\nimport type * as Layer$ from 'effect/Layer';\nimport type * as ManagedRuntime$ from 'effect/ManagedRuntime';\nimport type * as Runtime$ from 'effect/Runtime';\nimport type { FC, PropsWithChildren } from 'react';\n\nimport type {\n  LayerSpec as LayerSpec$,\n  Operation as Operation$,\n  OperationHandlerSet,\n  Process as Process$,\n  ServiceResolver as ServiceResolver$,\n  Trace as Trace$,\n} from '@dxos/compute';\nimport type { ProcessManager as ProcessManager$ } from '@dxos/compute-runtime';\nimport { OperationInvoker as OperationInvoker$ } from '@dxos/operation';\n\nimport { Capability as Capability$, Plugin as Plugin$, type PluginManager as PluginManager$ } from '../core';\nimport type {\n  HistoryTracker as HistoryTracker$,\n  UndoMapping as UndoMapping$,\n  UndoRegistry as UndoRegistry$,\n} from '../plugin-process-manager';\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\n/**\n * Layer specification contributed by plugins.\n *\n * Plugins contribute {@link LayerSpec.LayerSpec} entries that are collected by the\n * process-manager module and composed into a {@link LayerStack} which backs the\n * {@link ProcessManagerRuntime}'s service resolver.\n *\n * @category Capability\n */\nexport const LayerSpec = Capability$.make<LayerSpec$.LayerSpec>('org.dxos.app-framework.capability.layer-spec');\n\n/**\n * Context passed to {@link TraceSinkFactory} implementations when the\n * process-manager capability materialises contributed sinks.\n */\nexport interface TraceSinkFactoryContext {\n  /**\n   * Service resolver backing the shared {@link ProcessManagerRuntime}. Use it\n   * to resolve per-space (or per-process) services like `FeedTraceSink` when\n   * building a routing sink.\n   */\n  readonly resolver: ServiceResolver$.ServiceResolver;\n}\n\n/**\n * Factory that builds a {@link Trace$.Sink} when the process-manager\n * capability is ready. Plugins that only need a static sink can ignore the\n * context (e.g. `() => myConsoleSink`); plugins that need per-space routing\n * can use {@link TraceSinkFactoryContext.resolver} to look up services.\n */\nexport type TraceSinkFactory = (ctx: TraceSinkFactoryContext) => Trace$.Sink;\n\n/**\n * Trace sink contribution.\n *\n * Plugins contribute {@link TraceSinkFactory} functions; the process-manager\n * capability invokes each factory with the runtime's\n * {@link ServiceResolver$.ServiceResolver}, collects the resulting\n * {@link Trace$.Sink}s, merges them via {@link Trace$.mergeSinks}, and\n * installs the merged sink as {@link Trace$.TraceSink} in the runtime layer\n * so every process writes to every contributed sink.\n *\n * @category Capability\n */\nexport const TraceSink = Capability$.make<TraceSinkFactory>('org.dxos.app-framework.capability.trace-sink');\n\n/**\n * Service resolver backing the shared {@link ProcessManagerRuntime}.\n *\n * Contributed by the process-manager capability module. Consumers can combine\n * it with {@link ServiceResolver$.provide} to build space-scoped layers without\n * having to go through the process-manager runtime:\n *\n * @example\n * ```ts\n * const resolver = yield* Capability.get(Capabilities.ServiceResolver);\n * yield* effect.pipe(\n *   Effect.provide(\n *     ServiceResolver.provide({ space }, Database.Service, Feed.FeedService).pipe(\n *       Layer.provide(Layer.succeed(ServiceResolver.ServiceResolver, resolver)),\n *     ),\n *   ),\n * );\n * ```\n *\n * @category Capability\n */\nexport const ServiceResolver = Capability$.make<ServiceResolver$.ServiceResolver>(\n  'org.dxos.app-framework.capability.service-resolver',\n);\n\n/**\n * Process monitor backing the shared {@link ProcessManagerRuntime}. Exposes the\n * live process tree (including inactive/terminated entries) via\n * {@link Process$.Monitor#processTreeAtom}.\n *\n * @category Capability\n */\nexport const ProcessMonitor = Capability$.make<Process$.Monitor>('org.dxos.app-framework.capability.process-monitor');\n\n/**\n * Services that are always available when running effects through a {@link ProcessManagerRuntime}.\n */\nexport type ProcessManagerRuntimeServices =\n  | Capability$.Service\n  | Plugin$.Service\n  | ProcessManager$.ProcessManagerService\n  | Operation$.Service\n  | ProcessManager$.ProcessOperationInvoker.Service\n  | ServiceResolver$.ServiceResolver;\n\n/**\n * Runtime that runs effects requiring a fixed set of capability-manager and\n * process-manager services.\n *\n * The shape mirrors {@link ManagedRuntime$.ManagedRuntime} but deliberately does\n * not expose `dispose` – lifecycle is driven by the host plugin manager.\n */\nexport interface ProcessManagerRuntime {\n  runPromise<A, E>(\n    effect: Effect.Effect<A, E, ProcessManagerRuntimeServices>,\n    options?: { readonly signal?: AbortSignal },\n  ): Promise<A>;\n  runPromiseExit<A, E>(\n    effect: Effect.Effect<A, E, ProcessManagerRuntimeServices>,\n    options?: { readonly signal?: AbortSignal },\n  ): Promise<Exit$.Exit<A, E>>;\n  runFork<A, E>(\n    effect: Effect.Effect<A, E, ProcessManagerRuntimeServices>,\n    options?: Runtime$.RunForkOptions,\n  ): Fiber$.RuntimeFiber<A, E>;\n  runSync<A, E>(effect: Effect.Effect<A, E, ProcessManagerRuntimeServices>): A;\n}\n\n/**\n * @category Capability\n */\nexport const ProcessManagerRuntime = Capability$.make<ProcessManagerRuntime>(\n  'org.dxos.app-framework.capability.process-manager-runtime',\n);\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\n/**\n * Operation invoker backed by the process manager. Spawns a process per\n * operation invocation; see {@link ProcessManager$.ProcessOperationInvoker}.\n */\nexport type OperationInvoker = OperationInvoker$.OperationInvoker;\n\n/**\n * Operation invoker - provided by the process-manager capability.\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 ProcessManagerPlugin.\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 ProcessManagerPlugin.\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(CommentCapabilities.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(CommentCapabilities.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(CommentCapabilities.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;AA+BjB,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;AAW5D,IAAMQ,YAAYT,mBAAYC,KAA2B,8CAAA;AAmCzD,IAAMS,YAAYV,mBAAYC,KAAuB,8CAAA;AAuBrD,IAAMU,kBAAkBX,mBAAYC,KACzC,oDAAA;AAUK,IAAMW,iBAAiBZ,mBAAYC,KAAuB,mDAAA;AAuC1D,IAAMY,wBAAwBb,mBAAYC,KAC/C,2DAAA;AAQK,IAAMa,iBAAiBd,mBAAYC,KAAqB,mDAAA;AAMxD,IAAMc,mBAAmBf,mBAAYC,KAC1C,qDAAA;AASK,IAAMe,cAAchB,mBAAYC,KAAoB,gDAAA;AAYpD,IAAMgB,mBAAmBjB,mBAAYC,KAC1C,qDAAA;AASK,IAAMiB,eAAelB,mBAAYC,KAAmB,iDAAA;AAQpD,IAAMkB,iBAAiBnB,mBAAYC,KAAqB,mDAAA;AAUxD,IAAMmB,eAAe,CAC1BC,mBAEOC,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOvB,mBAAYwB,IAAIrB,YAAAA;AACxC,QAAMsB,OAAO,OAAOzB,mBAAYwB,IAAIH,cAAAA;AACpC,SAAOE,SAASC,IAAIC,IAAAA;AACtB,CAAA;AAMK,IAAMC,kBAAkB,CAC7BL,gBACAM,OAEOL,WAAI,aAAA;AACT,QAAMC,WAAW,OAAOvB,mBAAYwB,IAAIrB,YAAAA;AACxC,QAAMsB,OAAO,OAAOzB,mBAAYwB,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,OAAOvB,mBAAYwB,IAAIrB,YAAAA;AACxC,QAAMsB,OAAO,OAAOzB,mBAAYwB,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", "LayerSpec", "TraceSink", "ServiceResolver", "ProcessMonitor", "ProcessManagerRuntime", "ManagedRuntime", "OperationHandler", "UndoMapping", "OperationInvoker", "UndoRegistry", "HistoryTracker", "getAtomValue", "atomCapability", "gen", "registry", "get", "atom", "updateAtomValue", "fn", "set", "subscribeAtom", "callback", "subscribe"]
-}