@dxos/app-framework 0.8.4-main.69d29f4 → 0.8.4-main.6fa680abb7

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ui/components/App/App.tsx", "../../../src/helpers.ts", "../../../src/ui/hooks/useApp.tsx", "../../../src/ui/hooks/useCapabilities.ts", "../../../src/ui/hooks/useLoading.tsx", "../../../src/ui/hooks/useOperationResolver.ts", "../../../src/ui/hooks/useSettingsState.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/types.ts", "../../../src/ui/components/Surface/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\nexport type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n};\n\nexport const App = ({ placeholder: Placeholder, ready, error, debounce }: AppProps) => {\n  const reactContexts = useCapabilities(Capabilities.ReactContext);\n  const reactRoots = useCapabilities(Capabilities.ReactRoot);\n  const stage = useLoading(ready, debounce);\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (stage < LoadingState.Done) {\n    if (!Placeholder) {\n      return null;\n    }\n\n    return <Placeholder stage={stage} />;\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\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 { RegistryContext } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\nimport * as Fiber from 'effect/Fiber';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\nimport React, { type FC, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { ErrorBoundary, ErrorFallback, type FallbackProps } from '@dxos/react-error-boundary';\nimport { useAsyncEffect, useDefaultValue } from '@dxos/react-hooks';\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { ActivationEvents, Capabilities } from '../../common';\nimport { PluginManagerContext } from '../../context';\nimport { type ActivationEvent, type Plugin, PluginManager } from '../../core';\nimport { App, PluginManagerProvider } from '../components';\n\nconst ENABLED_KEY = 'org.dxos.app-framework.enabled';\n\nexport type UseAppOptions = {\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  plugins?: Plugin.Plugin[];\n  core?: string[];\n  defaults?: string[];\n  /**\n   * Additional activation events to fire before startup.\n   * These are fired alongside SetupReactSurface before the Startup event.\n   */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  cacheEnabled?: boolean;\n  safeMode?: boolean;\n  debounce?: number;\n  timeout?: number;\n  fallback?: FC<FallbackProps>;\n  placeholder?: FC<{ stage: number }>;\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 core = [LayoutPluginId];\n * const default = [MyPluginId];\n * const fallback = <div>Initializing Plugins...</div>;\n * const App = useApp({ plugins, core, default, 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.\n * @param params.core Core plugins which will always be enabled.\n * @param params.defaults Default plugins are enabled by default but can be disabled by the user.\n * @param params.cacheEnabled Whether to cache enabled plugins in localStorage.\n * @param params.safeMode Whether to enable safe mode, which disables optional plugins.\n * @param params.fallback Fallback component to render if an error occurs during startup.\n * @param params.placeholder Placeholder component to render during startup.\n */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  plugins: pluginsProp,\n  core: coreProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\n  placeholder,\n  fallback = ErrorFallback,\n  cacheEnabled = false,\n  safeMode = false,\n  debounce = 0,\n  timeout = 30_000,\n}: UseAppOptions) => {\n  const plugins = useDefaultValue(pluginsProp, () => []);\n  const core = useDefaultValue(coreProp, () => plugins.map(({ meta }) => meta.id));\n  const defaults = useDefaultValue(defaultsProp, () => []);\n  const setupEvents = useDefaultValue(setupEventsProp, () => []);\n\n  // TODO(wittjosiah): Provide a custom plugin loader which supports loading via url.\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  // 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 manager = useMemo(\n    () => pluginManager ?? PluginManager.make({ pluginLoader, plugins, core, enabled }),\n    [pluginManager, pluginLoader, plugins, core, enabled],\n  );\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    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, error: error$ }) =>\n            Effect.sync(() => {\n              if (event === ActivationEvents.Startup.id && state === 'activated') {\n                clearTimeout(timeoutId);\n                setReady(true);\n                readyRef.current = true;\n              }\n              if (error$ && !readyRef.current) {\n                setError(error$);\n                errorRef.current = error$;\n              }\n            }),\n          ),\n          Effect.forever,\n        ),\n      );\n\n      yield* Effect.all([\n        ...setupEvents.map((event) => manager.activate(event)),\n        manager.activate(ActivationEvents.SetupReactSurface),\n        manager.activate(ActivationEvents.Startup),\n      ]);\n\n      return yield* Fiber.join(listener);\n    }).pipe(Effect.scoped, Effect.runFork);\n\n    // Set up a timeout for startup.\n    const timeoutId = setTimeout(() => {\n      if (!readyRef.current && !errorRef.current) {\n        log.warn('startup timeout diagnostic', {\n          eventsFired: manager.getEventsFired(),\n          activeModules: manager.getActive(),\n          pendingReset: manager.getPendingReset(),\n        });\n        void runAndForwardErrors(Fiber.interrupt(fiber));\n        setError(new Error(`Startup timed out after ${timeout}ms`));\n      }\n    }, timeout);\n\n    return () => {\n      clearTimeout(timeoutId);\n      void runAndForwardErrors(Fiber.interrupt(fiber));\n      manager.capabilities.remove(Capabilities.PluginManager, manager);\n      manager.capabilities.remove(Capabilities.AtomRegistry, manager.registry);\n    };\n  }, [manager]);\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 placeholder={placeholder} ready={ready} error={error} debounce={debounce} />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, placeholder, ready, error],\n  );\n};\n\nconst setupDevtools = (manager: PluginManager.PluginManager) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.manager = manager;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback } from 'react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { Capabilities } from '../../common';\nimport { type Capability } from '../../core';\nimport { usePluginManager } from '../components';\n\n/**\n * Hook to request capabilities from the plugin context.\n * @returns An array of capabilities.\n */\nexport const useCapabilities = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const manager = usePluginManager();\n  return useAtomValue(manager.capabilities.atom(interfaceDef));\n};\n\n/**\n * Hook to request a capability from the plugin context.\n * @returns The capability.\n * @throws If no capability is found.\n */\nexport const useCapability = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const capabilities = useCapabilities(interfaceDef);\n  invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`);\n  return capabilities[0];\n};\n\n/**\n * Hook to get the current value of an atom capability.\n * Automatically subscribes to changes.\n * @example const settings = useAtomCapability(ThreadCapabilities.Settings);\n */\nexport const useAtomCapability = <T>(atomCapability: Capability.InterfaceDef<Atom.Atom<T>>): T => {\n  const atom = useCapability(atomCapability);\n  return useAtomValue(atom);\n};\n\n/**\n * Hook to get value and updater for an atom capability.\n * Returns [currentValue, updateFn] similar to useState.\n * @example const [settings, updateSettings] = useAtomCapabilityState(ThreadCapabilities.Settings);\n */\nexport const useAtomCapabilityState = <T>(\n  atomCapability: Capability.InterfaceDef<Atom.Writable<T>>,\n): [T, (fn: (current: T) => T) => void] => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const atom = useCapability(atomCapability);\n  const value = useAtomValue(atom);\n  const update = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n  return [value, update];\n};\n\n/**\n * Hook to get the operation invoker capability.\n */\nexport const useOperationInvoker = (): Capabilities.OperationInvoker => useCapability(Capabilities.OperationInvoker);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, 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  useEffect(() => {\n    if (!debounce) {\n      return;\n    }\n\n    const i = setInterval(() => {\n      setStage((stage) => {\n        switch (stage) {\n          case LoadingState.Loading: {\n            if (!ready) {\n              return LoadingState.FadeIn;\n            } else {\n              clearInterval(i);\n              return LoadingState.Done;\n            }\n          }\n\n          case LoadingState.FadeIn: {\n            if (ready) {\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 2025 DXOS.org\n//\n\nimport { useEffect, useMemo } from 'react';\n\nimport { Capabilities } from '../../common';\nimport { usePluginManager } from '../components';\n\n/**\n * Hook to dynamically register an operation resolver (handler) within a React component.\n * The resolver is added when the component mounts and removed when it unmounts.\n *\n * @example\n * ```tsx\n * const scrollHandler = useMemo(() => OperationResolver.make({\n *   operation: LayoutOperation.ScrollIntoView,\n *   handler: (input) => Effect.sync(() => {\n *     // Handle scroll\n *   }),\n * }), [deps]);\n *\n * useOperationResolver(meta.id, scrollHandler);\n * ```\n */\nexport const useOperationResolver = (module: string, resolver: Capabilities.OperationResolver) => {\n  const manager = usePluginManager();\n  // Wrap single resolver in array as the capability expects an array.\n  const resolverArray = useMemo(() => [resolver], [resolver]);\n\n  useEffect(() => {\n    manager.capabilities.contribute({\n      module,\n      interface: Capabilities.OperationResolver,\n      implementation: resolverArray,\n    });\n\n    return () => manager.capabilities.remove(Capabilities.OperationResolver, resolverArray);\n  }, [module, resolverArray]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, RegistryContext, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useContext } from 'react';\n\n/**\n * Hook to read and update a settings atom.\n * Returns the current value and an update function.\n */\nexport const useSettingsState = <T>(\n  atom: Atom.Writable<T>,\n): { settings: T; updateSettings: (fn: (current: T) => T) => void } => {\n  const registry = useContext(RegistryContext);\n  const settings = useAtomValue(atom);\n\n  const updateSettings = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n\n  return { settings, updateSettings };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { 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 React, {\n  Fragment,\n  type NamedExoticComponent,\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 { useCapabilities } from '../../hooks';\n\nimport { SurfaceContext } from './context';\nimport { SurfaceInfo } from './SurfaceInfo';\nimport { type Definition, type Props, type WebComponentDefinition } from './types';\n\nconst DEFAULT_PLACEHOLDER = <Fragment />;\n\nconst DEBUG = import.meta.env.VITE_DEBUG;\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, Props & { 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, Props & { definition: Definition }>(\n    ({ id, role, data, limit, fallback = ErrorFallback, definition, ...rest }, forwardedRef) => {\n      const contextValue = useMemo(() => ({ id, role, data }), [id, role, data]);\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 role='none' className='contents' data-id={id} data-role={role}>\n              <SurfaceContext.Provider value={contextValue}>\n                <SurfaceInfo ref={forwardedRef}>\n                  <Component id={id} role={role} data={data} limit={limit} {...rest} />\n                </SurfaceInfo>\n              </SurfaceContext.Provider>\n            </div>\n          </ErrorBoundary>\n        );\n      }\n\n      return (\n        <ErrorBoundary name='surface' resetKeys={[data]} FallbackComponent={fallback}>\n          <div role='none' 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: NamedExoticComponent<Props & RefAttributes<HTMLElement>> = memo(\n  forwardRef(({ id: _id, role, data: dataProp, limit, placeholder = DEFAULT_PLACEHOLDER, ...rest }, forwardedRef) => {\n    const data = useDefaultValue(dataProp, () => ({}));\n\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    // NOTE: Memoizing the candidates makes the surface not re-render based on reactivity within data.\n    const definitions = findCandidates(surfaces, { role, data });\n    const candidates = limit ? definitions.slice(0, limit) : definitions;\n    if (DEBUG && candidates.length === 0) {\n      log.warn('no candidates for surface', { role, 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={role}\n            data={data}\n            limit={limit}\n            definition={definition}\n            ref={forwardedRef}\n            {...rest}\n          />\n        ))}\n      </Suspense>\n    );\n  }),\n);\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 }: Pick<Props, 'role' | '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 ?? {}) : true))\n    .toSorted(byPosition);\n};\n\n/**\n * @internal\n */\nexport const useSurfaces = () => {\n  const surfaces = useCapabilities(Capabilities.ReactSurface);\n  return useMemo(() => surfaces.flat(), [surfaces]);\n};\n\n/**\n * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.\n */\nexport const isSurfaceAvailable = (\n  capabilityManager: CapabilityManager.CapabilityManager,\n  { role, data }: Pick<Props, 'role' | 'data'>,\n) => {\n  const surfaces = capabilityManager.getAll(Capabilities.ReactSurface);\n  const candidates = findCandidates(surfaces.flat(), { role, data });\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            role='none'\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 2023 DXOS.org\n//\n\nimport type { FC, PropsWithChildren, ReactNode, RefCallback } from 'react';\n\nimport type { MakeOptional, Position } from '@dxos/util';\n\n/**\n * Props that are passed to the Surface component.\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'> &\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  {\n    [K in keyof Record<string, any>]: K extends keyof CoreProps<T> | 'fallback' | 'placeholder' ? never : 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.\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 */\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>) => 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>) => 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 * Creates a React surface definition.\n */\nexport const create = <T extends Record<string, any> = any>(\n  definition: Omit<ReactDefinition<T>, 'kind'>,\n): ReactDefinition<T> => ({ ...definition, kind: 'react' });\n\n/**\n * Creates a Web Component surface definition.\n */\nexport const createWeb = <T extends Record<string, any> = any>(\n  definition: Omit<WebComponentDefinition<T>, 'kind'>,\n): WebComponentDefinition<T> => ({ ...definition, kind: 'web-component' });\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 { type Definition as SurfaceDefinition, create as createSurface, createWeb as createWebSurface } 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"],
+  "mappings": ";;;;;;;;;;;;;;AAIA,OAAOA,YAAuC;;;ACSvC,IAAMC,kBAAkB,CAA2BC,UAAAA;AACxD,QAAMC,kBAAkB,CAACC,QAAgBC,OAAO,oBAAIC,IAAAA,GAAeC,OAAO,oBAAID,IAAAA,MAAa;AACzF,QAAIC,KAAKC,IAAIJ,MAAAA,GAAS;AACpB,YAAM,IAAIK,MAAM,0CAA0CL,MAAAA,EAAQ;IACpE;AACA,QAAIC,KAAKG,IAAIJ,MAAAA,GAAS;AACpB,aAAO,CAAA;IACT;AAEA,UAAMM,OAAOR,MAAMS,KAAK,CAACC,MAAMA,EAAEC,OAAOT,MAAAA;AACxC,QAAI,CAACM,MAAM;AACT,YAAM,IAAID,MAAM,QAAQL,MAAAA,0CAAgD;IAC1E;AAEA,UAAMU,UAAU,oBAAIR,IAAI;SAAIC;MAAMH;KAAO;AACzC,UAAMW,UAAU,oBAAIT,IAAI;SAAID;MAAMD;KAAO;AAEzC,UAAMY,YAAYN,KAAKM,aAAa,CAAA;AACpC,WAAO;SAAIA,UAAUC,QAAQ,CAACC,UAAUf,gBAAgBe,OAAOH,SAASD,OAAAA,CAAAA;MAAWV;;EACrF;AAGA,QAAMe,kBAAkBjB,MACrBkB,IAAI,CAACV,SAASA,KAAKG,EAAE,EACrBI,QAAQ,CAACJ,OAAOV,gBAAgBU,EAAAA,CAAAA,EAChCQ,OAAO,CAACR,IAAIS,OAAOC,SAASA,KAAKC,QAAQX,EAAAA,MAAQS,KAAAA;AAGpD,SAAOH,gBACJC,IAAI,CAACP,OAAOX,MAAMS,KAAK,CAACD,SAASA,KAAKG,OAAOA,EAAAA,CAAAA,EAC7CQ,OAAO,CAACX,SAAoBA,SAASe,MAAAA;AAC1C;;;ACxCA,SAASC,uBAAuB;AAChC,YAAYC,YAAY;AACxB,YAAYC,WAAW;AACvB,YAAYC,YAAY;AACxB,YAAYC,WAAW;AACvB,OAAOC,SAAkBC,aAAaC,WAAWC,SAASC,QAAQC,gBAAgB;AAElF,SAASC,2BAA2B;AACpC,SAASC,iBAAiB;AAC1B,SAASC,WAAW;AACpB,SAASC,eAAeC,qBAAyC;AACjE,SAASC,gBAAgBC,uBAAuB;AAChD,SAASC,+BAA+B;;AAOxC,IAAMC,cAAc;AA8Cb,IAAMC,SAAS,CAAC,EACrBC,eACAC,cAAcC,kBACdC,SAASC,aACTC,MAAMC,UACNC,UAAUC,cACVC,aAAaC,iBACbC,aACAC,WAAWC,eACXC,eAAe,OACfC,WAAW,OACXC,WAAW,GACXC,UAAU,IAAM,MACF;AACd,QAAMd,UAAUe,gBAAgBd,aAAa,MAAM,CAAA,CAAE;AACrD,QAAMC,OAAOa,gBAAgBZ,UAAU,MAAMH,QAAQgB,IAAI,CAAC,EAAEC,KAAI,MAAOA,KAAKC,EAAE,CAAA;AAC9E,QAAMd,WAAWW,gBAAgBV,cAAc,MAAM,CAAA,CAAE;AACvD,QAAMC,cAAcS,gBAAgBR,iBAAiB,MAAM,CAAA,CAAE;AAG7D,QAAMT,eAAeqB,QACnB,MACEpB,qBACC,CAACmB,OACOE,YAAK,MAAA;AACV,UAAMC,SAASrB,QAAQsB,KAAK,CAACD,YAAWA,QAAOJ,KAAKC,OAAOA,EAAAA;AAC3DK,cAAUF,QAAQ,qBAAqBH,EAAAA,IAAI;;;;;;;;;AAC3C,WAAOG;EACT,CAAA,IACJ;IAACtB;IAAkBC;GAAQ;AAG7B,QAAMwB,WAAWC,OAAO,KAAA;AACxB,QAAM,CAACC,OAAOC,QAAAA,IAAYC,SAAS,KAAA;AACnC,QAAMC,WAAWJ,OAAgB,IAAA;AACjC,QAAM,CAACK,OAAOC,QAAAA,IAAYH,SAAkB,IAAA;AAE5C,QAAMI,SAAmBb,QAAQ,MAAMc,KAAKC,MAAMC,aAAaC,QAAQzC,WAAAA,KAAgB,IAAA,GAAO,CAAA,CAAE;AAChG,QAAM0C,UAAUlB,QACd,MAAOP,WAAW,CAAA,IAAKD,gBAAgBqB,OAAOM,SAAS,IAAIN,SAAS5B,UACpE;IAACQ;IAAUD;IAAcqB;IAAQ5B;GAAS;AAE5C,QAAMmC,UAAUpB,QACd,MAAMtB,iBAAiB2C,uBAAcC,KAAK;IAAE3C;IAAcE;IAASE;IAAMmC;EAAQ,CAAA,GACjF;IAACxC;IAAeC;IAAcE;IAASE;IAAMmC;GAAQ;AAGvDK,YAAU,MAAA;AACR,QAAI,CAAC/B,cAAc;AACjB;IACF;AACA,WAAO4B,QAAQI,SAASC,UAAUL,QAAQF,SAAS,CAACQ,UAAAA;AAClDV,mBAAaW,QAAQnD,aAAasC,KAAKc,UAAUF,KAAAA,CAAAA;IACnD,CAAA;EACF,GAAG;IAAClC;IAAc4B;GAAQ;AAE1BG,YAAU,MAAA;AACRM,kBAAcT,OAAAA;EAChB,GAAG;IAACA;GAAQ;AAEZU,iBAAe,YAAA;AACbV,YAAQW,aAAaC,WAAW;MAC9BC,WAAWC,qBAAab;MACxBc,gBAAgBf;MAChBgB,QAAQ;IACV,CAAA;AAEAhB,YAAQW,aAAaC,WAAW;MAC9BC,WAAWC,qBAAaG;MACxBF,gBAAgBf,QAAQI;MACxBY,QAAQ;IACV,CAAA;AAEA,UAAME,QAAeC,WAAI,aAAA;AACvB,YAAMC,QAAQ,OAAcf,iBAAUL,QAAQqB,UAAU;AACxD,YAAMC,WAAW,OAAcC,kBACvBC,WAAKJ,KAAAA,EAAOK,KACTC,WAAI,CAAC,EAAEC,OAAOC,OAAOrC,OAAOsC,OAAM,MAChChD,YAAK,MAAA;AACV,YAAI8C,UAAUG,0BAAiBC,QAAQpD,MAAMiD,UAAU,aAAa;AAClEI,uBAAaC,SAAAA;AACb7C,mBAAS,IAAA;AACTH,mBAASiD,UAAU;QACrB;AACA,YAAIL,UAAU,CAAC5C,SAASiD,SAAS;AAC/B1C,mBAASqC,MAAAA;AACTvC,mBAAS4C,UAAUL;QACrB;MACF,CAAA,CAAA,GAEKM,cAAO,CAAA;AAIlB,aAAcC,WAAI;WACbrE,YAAYU,IAAI,CAACkD,UAAU3B,QAAQqC,SAASV,KAAAA,CAAAA;QAC/C3B,QAAQqC,SAASP,0BAAiBQ,iBAAiB;QACnDtC,QAAQqC,SAASP,0BAAiBC,OAAO;OAC1C;AAED,aAAO,OAAaQ,WAAKjB,QAAAA;IAC3B,CAAA,EAAGG,KAAYe,eAAeC,cAAO;AAGrC,UAAMR,YAAYS,WAAW,MAAA;AAC3B,UAAI,CAACzD,SAASiD,WAAW,CAAC5C,SAAS4C,SAAS;AAC1CS,YAAIC,KAAK,8BAA8B;UACrCC,aAAa7C,QAAQ8C,eAAc;UACnCC,eAAe/C,QAAQgD,UAAS;UAChCC,cAAcjD,QAAQkD,gBAAe;QACvC,GAAA;;;;;;AACA,aAAKC,oBAA0BC,gBAAUlC,KAAAA,CAAAA;AACzC1B,iBAAS,IAAI6D,MAAM,2BAA2B9E,OAAAA,IAAW,CAAA;MAC3D;IACF,GAAGA,OAAAA;AAEH,WAAO,MAAA;AACLyD,mBAAaC,SAAAA;AACb,WAAKkB,oBAA0BC,gBAAUlC,KAAAA,CAAAA;AACzClB,cAAQW,aAAa2C,OAAOxC,qBAAab,eAAeD,OAAAA;AACxDA,cAAQW,aAAa2C,OAAOxC,qBAAaG,cAAcjB,QAAQI,QAAQ;IACzE;EACF,GAAG;IAACJ;GAAQ;AAEZ,SAAOuD,YACL,MACE,sBAAA,cAACC,eAAAA;IAAcC,MAAK;IAAMC,mBAAmBxF;KAC3C,sBAAA,cAACyF,uBAAAA;IAAsBrD,OAAON;KAC5B,sBAAA,cAAC4D,yBAAAA;IAAwBtD,OAAON;IAAS6D,SAASC;KAChD,sBAAA,cAACC,gBAAgBC,UAAQ;IAAC1D,OAAON,QAAQI;KACvC,sBAAA,cAAC6D,KAAAA;IAAIhG;IAA0BkB;IAAcI;IAAcjB;UAMrE;IAACJ;IAAU8B;IAAS/B;IAAakB;IAAOI;GAAM;AAElD;AAEA,IAAMkB,gBAAgB,CAACT,YAAAA;AACpBkE,aAAmBC,aAAa,CAAC;AACjCD,aAAmBC,SAASnE,UAAUA;AACzC;;;AChNA,SAAoBoE,oBAAoB;AACxC,SAASC,eAAAA,oBAAmB;AAE5B,SAASC,aAAAA,kBAAiB;;AAUnB,IAAMC,kBAAkB,CAAIC,iBAAAA;AACjC,QAAMC,UAAUC,iBAAAA;AAChB,SAAOC,aAAaF,QAAQG,aAAaC,KAAKL,YAAAA,CAAAA;AAChD;AAOO,IAAMM,gBAAgB,CAAIN,iBAAAA;AAC/B,QAAMI,eAAeL,gBAAgBC,YAAAA;AACrCO,EAAAA,WAAUH,aAAaI,SAAS,GAAG,2BAA2BR,aAAaS,UAAU,IAAE;;;;;;;;;AACvF,SAAOL,aAAa,CAAA;AACtB;AAOO,IAAMM,oBAAoB,CAAIC,mBAAAA;AACnC,QAAMN,OAAOC,cAAcK,cAAAA;AAC3B,SAAOR,aAAaE,IAAAA;AACtB;AAOO,IAAMO,yBAAyB,CACpCD,mBAAAA;AAEA,QAAME,WAAWP,cAAcQ,qBAAaC,YAAY;AACxD,QAAMV,OAAOC,cAAcK,cAAAA;AAC3B,QAAMK,QAAQb,aAAaE,IAAAA;AAC3B,QAAMY,SAASC,aACb,CAACC,OAAAA;AACCN,aAASO,IAAIf,MAAMc,GAAGN,SAASQ,IAAIhB,IAAAA,CAAAA,CAAAA;EACrC,GACA;IAACQ;IAAUR;GAAK;AAElB,SAAO;IAACW;IAAOC;;AACjB;AAKO,IAAMK,sBAAsB,MAAqChB,cAAcQ,qBAAaS,gBAAgB;;;AC9DnH,SAASC,aAAAA,YAAWC,YAAAA,iBAAgB;AAE7B,IAAKC,eAAAA,0BAAAA,eAAAA;;;;;SAAAA;;AAiBL,IAAMC,aAAa,CAACC,OAAgBC,WAAW,MAAC;AACrD,QAAM,CAACC,OAAOC,QAAAA,IAAYC,UAAAA,CAAAA;AAC1BC,EAAAA,WAAU,MAAA;AACR,QAAI,CAACJ,UAAU;AACb;IACF;AAEA,UAAMK,IAAIC,YAAY,MAAA;AACpBJ,eAAS,CAACD,WAAAA;AACR,gBAAQA,QAAAA;UACN,KAAA,GAA2B;AACzB,gBAAI,CAACF,OAAO;AACV,qBAAA;YACF,OAAO;AACLQ,4BAAcF,CAAAA;AACd,qBAAA;YACF;UACF;UAEA,KAAA,GAA0B;AACxB,gBAAIN,OAAO;AACT,qBAAA;YACF;AACA;UACF;UAEA,KAAA,GAA2B;AACzBQ,0BAAcF,CAAAA;AACd,mBAAA;UACF;QACF;AAEA,eAAOJ;MACT,CAAA;IACF,GAAGD,QAAAA;AAEH,WAAO,MAAMO,cAAcF,CAAAA;EAC7B,GAAG;IAACL;GAAS;AAEb,MAAI,CAACA,UAAU;AACb,WAAOD,QAAAA,IAAAA;EACT;AAEA,SAAOE;AACT;;;AC/DA,SAASO,aAAAA,YAAWC,WAAAA,gBAAe;AAqB5B,IAAMC,uBAAuB,CAACC,QAAgBC,aAAAA;AACnD,QAAMC,UAAUC,iBAAAA;AAEhB,QAAMC,gBAAgBC,SAAQ,MAAM;IAACJ;KAAW;IAACA;GAAS;AAE1DK,EAAAA,WAAU,MAAA;AACRJ,YAAQK,aAAaC,WAAW;MAC9BR;MACAS,WAAWC,qBAAaC;MACxBC,gBAAgBR;IAClB,CAAA;AAEA,WAAO,MAAMF,QAAQK,aAAaM,OAAOH,qBAAaC,mBAAmBP,aAAAA;EAC3E,GAAG;IAACJ;IAAQI;GAAc;AAC5B;;;ACnCA,SAAoBU,mBAAAA,kBAAiBC,gBAAAA,qBAAoB;AACzD,SAASC,eAAAA,cAAaC,kBAAkB;AAMjC,IAAMC,mBAAmB,CAC9BC,SAAAA;AAEA,QAAMC,WAAWC,WAAWC,gBAAAA;AAC5B,QAAMC,WAAWC,cAAaL,IAAAA;AAE9B,QAAMM,iBAAiBC,aACrB,CAACC,OAAAA;AACCP,aAASQ,IAAIT,MAAMQ,GAAGP,SAASS,IAAIV,IAAAA,CAAAA,CAAAA;EACrC,GACA;IAACC;IAAUD;GAAK;AAGlB,SAAO;IAAEI;IAAUE;EAAe;AACpC;;;ACrBA,SAASK,cAAAA,mBAAkB;AAE3B,SAASC,aAAa;AAIf,IAAMC,aAAa,MAAA;AACxB,SAAOC,YAAWC,QAAQC,OAAO,KAAKC,MAAM,IAAIC,MAAM,wBAAA,CAAA;AACxD;;;APGO,IAAMC,MAAM,CAAC,EAAEC,aAAaC,aAAaC,OAAOC,OAAOC,SAAQ,MAAY;AAChF,QAAMC,gBAAgBC,gBAAgBC,qBAAaC,YAAY;AAC/D,QAAMC,aAAaH,gBAAgBC,qBAAaG,SAAS;AACzD,QAAMC,QAAQC,WAAWV,OAAOE,QAAAA;AAEhC,MAAID,OAAO;AAET,UAAMA;EACR;AAGA,MAAIQ,QAAQE,aAAaC,MAAM;AAC7B,QAAI,CAACb,aAAa;AAChB,aAAO;IACT;AAEA,WAAO,gBAAAc,OAAA,cAACd,aAAAA;MAAYU;;EACtB;AAEA,QAAMK,kBAAkBC,gBAAgBZ,aAAAA;AACxC,SACE,gBAAAU,OAAA,cAACC,iBAAAA,MACEP,WAAWS,IAAI,CAAC,EAAEC,IAAIC,MAAMC,UAAS,MACpC,gBAAAN,OAAA,cAACM,WAAAA;IAAUC,KAAKH;;AAIxB;AAEA,IAAMF,kBAAkB,CAACM,aAAAA;AACvB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAO,CAAC,EAAEC,SAAQ,MAA0B,gBAAAV,OAAA,cAAAA,OAAA,UAAA,MAAGU,QAAAA;EACjD;AAEA,SAAOC,gBAAgBH,QAAAA,EACpBL,IAAI,CAAC,EAAES,QAAO,MAAOA,OAAAA,EACrBC,OAAO,CAACC,KAAKC,SAAS,CAAC,EAAEL,SAAQ,MAChC,gBAAAV,OAAA,cAACc,KAAAA,MACC,gBAAAd,OAAA,cAACe,MAAAA,MAAML,QAAAA,CAAAA,CAAAA;AAGf;;;AQpDA,SAASM,eAAeC,cAAAA,mBAAkB;AAE1C,SAASC,SAAAA,cAAa;AAItB,IAAMC,wBAAuBC,cAAuDC,MAAAA;AAK7E,IAAMC,mBAAmB,MAC9BC,YAAWJ,qBAAAA,KAAyBK,OAAM,IAAIC,MAAM,8BAAA,CAAA;AAK/C,IAAMC,wBAAwBP,sBAAqBQ;;;ACjB1D,SAAuBC,iBAAAA,sBAAqB;AAOrC,IAAMC,iBAAsDC,eAA0CC,MAAAA;;;ACP7G,OAAOC,UACLC,UAGAC,UACAC,cAAAA,aACAC,MACAC,aAAAA,YACAC,WAAAA,UACAC,UAAAA,eACK;AAEP,SAASC,OAAAA,YAAW;AACpB,SAASC,iBAAAA,sBAAqB;AAC9B,SAASC,mBAAAA,wBAAuB;AAChC,SAASC,kBAAkB;;;ACf3B,OAAOC,UAGLC,cACAC,YACAC,eAAAA,cACAC,iBACAC,YAAAA,iBACK;AACP,SAASC,oBAAoB;AAE7B,SAASC,kBAAkBC,eAAe;AAC1C,SAASC,oBAAoB;AAWtB,IAAMC,cAAcC,2BAA0C,CAAC,EAAEC,SAAQ,GAAIC,iBAAAA;AAClF,QAAM,CAACC,MAAMC,OAAAA,IAAWC,UAAyB,IAAA;AACjD,QAAM,CAACC,QAAQC,SAAAA,IAAaF,UAAS,KAAA;AACrC,QAAMG,OAAOC,WAAAA;AAEb,QAAM,CAACC,MAAMC,OAAAA,IAAWN,UAA6B,IAAA;AACrD,QAAMO,aAAaC,aAAY,CAACC,SAA6BH,QAAQG,IAAAA,GAAO,CAAA,CAAE;AAC9E,QAAMC,YAAYC,aAAa;IAACJ;IAAYV;GAAa;AACzD,QAAMe,eAAeC,6BAAajB,UAAU;IAAEkB,KAAKJ;EAAU,CAAA;AAE7DK,kBAAgB,MAAA;AACd,QAAI,CAACV,MAAM;AACTN,cAAQ,IAAA;AACR;IACF;AAEA,UAAMiB,UAAU,MAAA;AACdjB,cAAQM,KAAKY,sBAAqB,CAAA;IACpC;AAEA,UAAMC,WAAW,IAAIC,eAAeH,OAAAA;AACpCE,aAASE,QAAQf,IAAAA;AACjBW,YAAAA;AAEA,WAAOK,QACLC,iBAAiBC,QAAQ,UAAUP,SAAS,IAAA,GAC5CM,iBAAiBC,QAAQ,UAAUP,OAAAA,GACnC,MAAA;AACEE,eAASM,WAAU;IACrB,CAAA;EAEJ,GAAG;IAACnB;GAAK;AAET,QAAMoB,UAAU;AAChB,SACE,gBAAAC,OAAA,cAAAA,OAAA,UAAA,MACGd,cACAd,QACC6B;IACE,gBAAAD,OAAA,cAACE,OAAAA;MACCC,MAAK;MACLC,WAAU;MACVC,OAAO;QACLC,KAAKlC,KAAKkC,MAAMP;QAChBQ,MAAMnC,KAAKmC,OAAOR;QAClBS,OAAOpC,KAAKoC,QAAQT,UAAU;QAC9BU,QAAQrC,KAAKqC,SAASV,UAAU;MAClC;OAECxB,SACC,gBAAAyB,OAAA,cAACE,OAAAA;MACCE,WAAU;MACVM,eAAe,CAACC,OAAOA,GAAGC,gBAAe;MACzCC,SAAS,CAACF,OAAAA;AACRA,WAAGC,gBAAe;AAClBpC,kBAAU,KAAA;MACZ;OAEA,gBAAAwB,OAAA,cAACc,OAAAA;MAAIV,WAAU;OAA0CW,KAAKC,UAAU;MAAEvC;IAAK,GAAG,MAAM,CAAA,CAAA,CAAA,IAG1F,gBAAAuB,OAAA,cAACiB,QAAAA;MACCb,WAAU;MACVc,OAAOzC,KAAK0C;MACZT,eAAe,CAACC,OAAOA,GAAGC,gBAAe;MACzCC,SAAS,CAACF,OAAAA;AACRA,WAAGC,gBAAe;AAClBpC,kBAAU,IAAA;MACZ;OACD,QAAA,CAAA;;IAML4C,SAASC;EAAI,CAAA;AAIvB,CAAA;;;;AD7EA,IAAMC,sBAAsB,gBAAAC,OAAA,cAACC,UAAAA,IAAAA;AAE7B,IAAMC,QAAQ,YAAYC,IAAIC;AAM9B,IAAMC,sBAAsBC,qBAC1BC,gBAAAA,YACE,CAAC,EAAEC,IAAIC,MAAMC,MAAMC,OAAOC,YAAY,GAAGC,KAAAA,GAAQC,iBAAAA;AAC/C,QAAMC,eAAeC,QAAuB,IAAA;AAC5C,QAAMC,aAAaD,QAA2B,IAAA;AAC9C,QAAME,WAAWF,QAAO;IAAER;IAAIC;IAAMC;IAAMC;IAAO,GAAGE;EAAK,CAAA;AAGzDK,WAASC,UAAU;IAAEX;IAAIC;IAAMC;IAAMC;IAAO,GAAGE;EAAK;AAGpDO,EAAAA,WAAU,MAAA;AACR,QAAI,CAACL,aAAaI,WAAWF,WAAWE,SAAS;AAC/C;IACF;AAGA,UAAME,UAAUC,SAASC,cAAcX,WAAWY,OAAO;AACzDP,eAAWE,UAAUE;AAGrBI,WAAOC,OAAOL,SAASH,SAASC,OAAO;AAGvCJ,iBAAaI,QAAQQ,YAAYN,OAAAA;AAGjC,QAAI,OAAOP,iBAAiB,YAAY;AACtCA,mBAAaO,OAAAA;IACf,WAAWP,cAAc;AACvBA,mBAAaK,UAAUE;IACzB;AAGA,WAAO,MAAA;AACL,UAAIJ,WAAWE,WAAWJ,aAAaI,SAASS,SAASX,WAAWE,OAAO,GAAG;AAC5EJ,qBAAaI,QAAQU,YAAYZ,WAAWE,OAAO;MACrD;AACA,UAAI,OAAOL,iBAAiB,YAAY;AACtCA,qBAAa,IAAA;MACf,WAAWA,cAAc;AACvBA,qBAAaK,UAAU;MACzB;AACAF,iBAAWE,UAAU;IACvB;EACF,GAAG;IAACP,WAAWY;IAASV;GAAa;AAIrCM,EAAAA,WAAU,MAAA;AACR,UAAMC,UAAUJ,WAAWE;AAC3B,QAAI,CAACE,SAAS;AACZ;IACF;AAGAI,WAAOC,OAAOL,SAASH,SAASC,OAAO;EACzC,CAAA;AAEA,SAAO,gBAAAnB,OAAA,cAAC8B,OAAAA;IAAIC,KAAKhB;;AACnB,CAAA,CAAA;AAIJV,oBAAoB2B,cAAc;AAMlC,IAAMC,yBAAyB3B,qBAC7BC,gBAAAA,YACE,CAAC,EAAEC,IAAIC,MAAMC,MAAMC,OAAOuB,WAAWC,gBAAevB,YAAY,GAAGC,KAAAA,GAAQC,iBAAAA;AACzE,QAAMsB,eAAeC,SAAQ,OAAO;IAAE7B;IAAIC;IAAMC;EAAK,IAAI;IAACF;IAAIC;IAAMC;GAAK;AAGzE,MAAIE,WAAW0B,SAAS,iBAAiB;AACvC,WACE,gBAAAtC,OAAA,cAACuC,gBAAAA;MAAcC,MAAK;MAAUC,WAAW;QAAC/B;;MAAOgC,mBAAmBR;OAClE,gBAAAlC,OAAA,cAAC2C,eAAeC,UAAQ;MAACC,OAAOT;OAC9B,gBAAApC,OAAA,cAACK,qBAAAA;MACCG;MACAC;MACAC;MACAC;MACAC;MACAmB,KAAKjB;MACJ,GAAGD;;EAKd;AAGA,QAAMiC,YAAYlC,WAAWmC;AAG7B,QAAMC,QAAQ9C,SAAS,kBAAkB+C;AACzC,MAAID,OAAO;AACT,WACE,gBAAAhD,OAAA,cAACuC,gBAAAA;MAAcC,MAAK;MAAUC,WAAW;QAAC/B;;MAAOgC,mBAAmBR;OAClE,gBAAAlC,OAAA,cAAC8B,OAAAA;MAAIrB,MAAK;MAAOyC,WAAU;MAAWC,WAAS3C;MAAI4C,aAAW3C;OAC5D,gBAAAT,OAAA,cAAC2C,eAAeC,UAAQ;MAACC,OAAOT;OAC9B,gBAAApC,OAAA,cAACqD,aAAAA;MAAYtB,KAAKjB;OAChB,gBAAAd,OAAA,cAAC8C,WAAAA;MAAUtC;MAAQC;MAAYC;MAAYC;MAAe,GAAGE;;EAMzE;AAEA,SACE,gBAAAb,OAAA,cAACuC,gBAAAA;IAAcC,MAAK;IAAUC,WAAW;MAAC/B;;IAAOgC,mBAAmBR;KAClE,gBAAAlC,OAAA,cAAC8B,OAAAA;IAAIrB,MAAK;IAAOyC,WAAU;IAAWC,WAAS3C;IAAI4C,aAAW3C;KAC5D,gBAAAT,OAAA,cAAC2C,eAAeC,UAAQ;IAACC,OAAOT;KAC9B,gBAAApC,OAAA,cAAC8C,WAAAA;IAAUtC;IAAQC;IAAYC;IAAYC;IAAe,GAAGE;IAAMkB,KAAKjB;;AAKlF,CAAA,CAAA;AAIJmB,uBAAuBD,cAAc;AAM9B,IAAMsB,mBAA6EhD,qBACxFC,gBAAAA,YAAW,CAAC,EAAEC,IAAI+C,KAAK9C,MAAMC,MAAM8C,UAAU7C,OAAO8C,cAAc1D,qBAAqB,GAAGc,KAAAA,GAAQC,iBAAAA;AAChG,QAAMJ,OAAOgD,iBAAgBF,UAAU,OAAO,CAAC,EAAA;AAO/C,QAAMG,WAAWC,YAAAA;AAGjB,QAAMC,cAAcC,eAAeH,UAAU;IAAElD;IAAMC;EAAK,CAAA;AAC1D,QAAMqD,aAAapD,QAAQkD,YAAYG,MAAM,GAAGrD,KAAAA,IAASkD;AACzD,MAAI3D,SAAS6D,WAAWE,WAAW,GAAG;AACpCC,IAAAA,KAAIC,KAAK,6BAA6B;MAAE1D;MAAMC;IAAK,GAAA;;;;;;AACnD,WAAO;EACT;AAEA,SACE,gBAAAV,OAAA,cAACoE,UAAAA;IAASlC,UAAUuB;KACjBM,WAAWM,IAAI,CAACzD,eACf,gBAAAZ,OAAA,cAACiC,wBAAAA;IACCqC,KAAK1D,WAAWJ;IAChBA,IAAII,WAAWJ;IACfC;IACAC;IACAC;IACAC;IACAmB,KAAKjB;IACJ,GAAGD;;AAKd,CAAA,CAAA;AAGFyC,iBAAiBtB,cAAc;AAG/B,IAAMG,iBAAgB,CAAC,EAAEoC,MAAK,MAAS;AACrC,QAAM,EAAEC,QAAO,IAAKD,iBAAiBE,QAAQF,QAAQ;IAAEC,SAASE,OAAOH,KAAAA;EAAO;AAC9E,SACE,gBAAAvE,OAAA,cAAC8B,OAAAA;IAAIrB,MAAK;IAAQkE,eAAY;KAC5B,gBAAA3E,OAAA,cAAC4E,MAAAA;IAAG1B,WAAU;KAA0CsB,OAAAA,CAAAA;AAG9D;AAEA,IAAMV,iBAAiB,CAACH,UAAwB,EAAElD,MAAMC,KAAI,MAAgC;AAC1F,SAAOe,OAAOoD,OAAOlB,QAAAA,EAClBmB,OAAO,CAAClE,eACPmE,MAAMC,QAAQpE,WAAWH,IAAI,IAAIG,WAAWH,KAAKwE,SAASxE,IAAAA,IAAQG,WAAWH,SAASA,IAAAA,EAEvFqE,OAAO,CAAC,EAAEA,OAAM,MAAQA,SAASA,OAAOpE,QAAQ,CAAC,CAAA,IAAK,IAAA,EACtDwE,SAASC,UAAAA;AACd;AAKO,IAAMvB,cAAc,MAAA;AACzB,QAAMD,WAAWyB,gBAAgBC,qBAAaC,YAAY;AAC1D,SAAOjD,SAAQ,MAAMsB,SAAS4B,KAAI,GAAI;IAAC5B;GAAS;AAClD;AAKO,IAAM6B,qBAAqB,CAChCC,mBACA,EAAEhF,MAAMC,KAAI,MAAgC;AAE5C,QAAMiD,WAAW8B,kBAAkBC,OAAOL,qBAAaC,YAAY;AACnE,QAAMvB,aAAaD,eAAeH,SAAS4B,KAAI,GAAI;IAAE9E;IAAMC;EAAK,CAAA;AAChE,SAAOqD,WAAWE,SAAS;AAC7B;;;AE3IO,IAAM0B,SAAS,CACpBC,gBACwB;EAAE,GAAGA;EAAYC,MAAM;AAAQ;AAKlD,IAAMC,YAAY,CACvBF,gBAC+B;EAAE,GAAGA;EAAYC,MAAM;AAAgB;;;UC3GvDE,UAAAA;WAEFC,SAASC;WACTC,YAAYC;WAGZC,UAAUC;WAEVN,UAAUO;WACVC,cAAcC;AAC7B,GAViBT,YAAAA,UAAAA,CAAAA,EAAAA;;",
+  "names": ["React", "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", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "runAndForwardErrors", "invariant", "log", "ErrorBoundary", "ErrorFallback", "useAsyncEffect", "useDefaultValue", "ContextProtocolProvider", "ENABLED_KEY", "useApp", "pluginManager", "pluginLoader", "pluginLoaderProp", "plugins", "pluginsProp", "core", "coreProp", "defaults", "defaultsProp", "setupEvents", "setupEventsProp", "placeholder", "fallback", "ErrorFallback", "cacheEnabled", "safeMode", "debounce", "timeout", "useDefaultValue", "map", "meta", "id", "useMemo", "sync", "plugin", "find", "invariant", "readyRef", "useRef", "ready", "setReady", "useState", "errorRef", "error", "setError", "cached", "JSON", "parse", "localStorage", "getItem", "enabled", "length", "manager", "PluginManager", "make", "useEffect", "registry", "subscribe", "value", "setItem", "stringify", "setupDevtools", "useAsyncEffect", "capabilities", "contribute", "interface", "Capabilities", "implementation", "module", "AtomRegistry", "fiber", "gen", "queue", "activation", "listener", "forkDaemon", "take", "pipe", "tap", "event", "state", "error$", "ActivationEvents", "Startup", "clearTimeout", "timeoutId", "current", "forever", "all", "activate", "SetupReactSurface", "join", "scoped", "runFork", "setTimeout", "log", "warn", "eventsFired", "getEventsFired", "activeModules", "getActive", "pendingReset", "getPendingReset", "runAndForwardErrors", "interrupt", "Error", "remove", "useCallback", "ErrorBoundary", "name", "FallbackComponent", "PluginManagerProvider", "ContextProtocolProvider", "context", "PluginManagerContext", "RegistryContext", "Provider", "App", "globalThis", "composer", "useAtomValue", "useCallback", "invariant", "useCapabilities", "interfaceDef", "manager", "usePluginManager", "useAtomValue", "capabilities", "atom", "useCapability", "invariant", "length", "identifier", "useAtomCapability", "atomCapability", "useAtomCapabilityState", "registry", "Capabilities", "AtomRegistry", "value", "update", "useCallback", "fn", "set", "get", "useOperationInvoker", "OperationInvoker", "useEffect", "useState", "LoadingState", "useLoading", "ready", "debounce", "stage", "setStage", "useState", "useEffect", "i", "setInterval", "clearInterval", "useEffect", "useMemo", "useOperationResolver", "module", "resolver", "manager", "usePluginManager", "resolverArray", "useMemo", "useEffect", "capabilities", "contribute", "interface", "Capabilities", "OperationResolver", "implementation", "remove", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "useContext", "RegistryContext", "settings", "useAtomValue", "updateSettings", "useCallback", "fn", "set", "get", "useContext", "raise", "useSurface", "useContext", "Surface", "Context", "raise", "Error", "App", "placeholder", "Placeholder", "ready", "error", "debounce", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "LoadingState", "Done", "React", "ComposedContext", "composeContexts", "map", "id", "root", "Component", "key", "contexts", "length", "children", "topologicalSort", "context", "reduce", "Acc", "Next", "createContext", "useContext", "raise", "PluginManagerContext", "createContext", "undefined", "usePluginManager", "useContext", "raise", "Error", "PluginManagerProvider", "Provider", "createContext", "SurfaceContext", "createContext", "undefined", "React", "Fragment", "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", "React", "createPortal", "div", "role", "className", "style", "top", "left", "width", "height", "onPointerDown", "ev", "stopPropagation", "onClick", "pre", "JSON", "stringify", "span", "title", "id", "document", "body", "DEFAULT_PLACEHOLDER", "React", "Fragment", "DEBUG", "env", "VITE_DEBUG", "WebComponentWrapper", "memo", "forwardRef", "id", "role", "data", "limit", "definition", "rest", "forwardedRef", "containerRef", "useRef", "elementRef", "propsRef", "current", "useEffect", "element", "document", "createElement", "tagName", "Object", "assign", "appendChild", "contains", "removeChild", "div", "ref", "displayName", "SurfaceContextProvider", "fallback", "ErrorFallback", "contextValue", "useMemo", "kind", "ErrorBoundary", "name", "resetKeys", "FallbackComponent", "SurfaceContext", "Provider", "value", "Component", "component", "debug", "window", "className", "data-id", "data-role", "SurfaceInfo", "SurfaceComponent", "_id", "dataProp", "placeholder", "useDefaultValue", "surfaces", "useSurfaces", "definitions", "findCandidates", "candidates", "slice", "length", "log", "warn", "Suspense", "map", "key", "error", "message", "Error", "String", "data-testid", "h1", "values", "filter", "Array", "isArray", "includes", "toSorted", "byPosition", "useCapabilities", "Capabilities", "ReactSurface", "flat", "isSurfaceAvailable", "capabilityManager", "getAll", "create", "definition", "kind", "createWeb", "Surface", "create", "createSurface", "createWeb", "createWebSurface", "Context", "SurfaceContext", "SurfaceComponent", "isAvailable", "isSurfaceAvailable"]
+}

package/dist/lib/browser/chunk-TGX63LTL.mjs

@@ -0,0 +1,8 @@
+// src/context.ts
+import { createContext } from "@dxos/web-context";
+var PluginManagerContext = createContext("org.dxos.app-framework.plugin-manager");
+
+export {
+  PluginManagerContext
+};
+//# sourceMappingURL=chunk-TGX63LTL.mjs.map

package/dist/lib/browser/{chunk-FHQTHCX7.mjs.map → chunk-TGX63LTL.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/context.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@dxos/web-context';\n\nimport { type PluginManager } from './core';\n\nexport const PluginManagerContext = createContext<PluginManager.PluginManager>('dxos.org/app-framework/plugin-manager');\n"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@dxos/web-context';\n\nimport { type PluginManager } from './core';\n\nexport const PluginManagerContext = createContext<PluginManager.PluginManager>('org.dxos.app-framework.plugin-manager');\n"],
   "mappings": ";AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBC,cAA2C,uCAAA;",
   "names": ["createContext", "PluginManagerContext", "createContext"]
 }

package/dist/lib/browser/chunk-TIEBZMTF.mjs

@@ -0,0 +1,44 @@
+import {
+  capability_exports
+} from "./chunk-YNFPIQGB.mjs";
+
+// src/common/translations.ts
+import * as Schema from "effect/Schema";
+var Label = Schema.Union(Schema.String, Schema.mutable(Schema.Tuple(Schema.String, Schema.mutable(Schema.Struct({
+  ns: Schema.String,
+  count: Schema.optional(Schema.Number),
+  defaultValue: Schema.optional(Schema.String)
+})))));
+
+// src/common/operations.ts
+import * as Schema2 from "effect/Schema";
+import { Operation } from "@dxos/operation";
+var UNDO_NAMESPACE = "org.dxos.app-framework.undo";
+(function(UndoOperation2) {
+  UndoOperation2.ShowUndo = Operation.make({
+    meta: {
+      key: `${UNDO_NAMESPACE}.operation.show-undo`,
+      name: "Show Undo",
+      description: "Show an undo toast notification."
+    },
+    executionMode: "sync",
+    services: [
+      capability_exports.Service
+    ],
+    schema: {
+      input: Schema2.Struct({
+        message: Schema2.optional(Label.annotations({
+          description: "The message to display in the undo toast."
+        }))
+      }),
+      output: Schema2.Void
+    }
+  });
+})(UndoOperation || (UndoOperation = {}));
+var UndoOperation;
+
+export {
+  Label,
+  UndoOperation
+};
+//# sourceMappingURL=chunk-TIEBZMTF.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/translations.ts", "../../../src/common/operations.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\n/**\n * A Label represents translatable text - either a simple string or a tuple of [key, options].\n */\nexport const Label = Schema.Union(\n  Schema.String,\n  Schema.mutable(\n    Schema.Tuple(\n      Schema.String,\n      Schema.mutable(\n        Schema.Struct({\n          ns: Schema.String,\n          count: Schema.optional(Schema.Number),\n          defaultValue: Schema.optional(Schema.String),\n        }),\n      ),\n    ),\n  ),\n);\nexport type Label = Schema.Schema.Type<typeof Label>;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Operation } from '@dxos/operation';\n\nimport { Capability } from '../core';\n\nimport { Label } from './translations';\n\nconst UNDO_NAMESPACE = 'org.dxos.app-framework.undo';\n\n/**\n * Operations related to undo/history functionality.\n */\nexport namespace UndoOperation {\n  /**\n   * Show an undo toast notification.\n   * Fired by HistoryTracker when an undoable operation is tracked.\n   */\n  export const ShowUndo = Operation.make({\n    meta: {\n      key: `${UNDO_NAMESPACE}.operation.show-undo`,\n      name: 'Show Undo',\n      description: 'Show an undo toast notification.',\n    },\n    executionMode: 'sync',\n    services: [Capability.Service],\n    schema: {\n      input: Schema.Struct({\n        message: Schema.optional(Label.annotations({ description: 'The message to display in the undo toast.' })),\n      }),\n      output: Schema.Void,\n    },\n  });\n}\n"],
+  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAKjB,IAAMC,QAAeC,aACnBC,eACAC,eACEC,aACEF,eACAC,eACEE,cAAO;EACZC,IAAWJ;EACXK,OAAcC,gBAAgBC,aAAM;EACpCC,cAAqBF,gBAAgBN,aAAM;AAC7C,CAAA,CAAA,CAAA,CAAA,CAAA;;;ACfR,YAAYS,aAAY;AAExB,SAASC,iBAAiB;AAM1B,IAAMC,iBAAiB;UAKNC,gBAAAA;iBAKFC,WAAWC,UAAUC,KAAK;IACrCC,MAAM;MACJC,KAAK,GAAGN,cAAAA;MACRO,MAAM;MACNC,aAAa;IACf;IACAC,eAAe;IACfC,UAAU;MAACC,mBAAWC;;IACtBC,QAAQ;MACNC,OAAcC,eAAO;QACnBC,SAAgBC,iBAASC,MAAMC,YAAY;UAAEX,aAAa;QAA4C,CAAA,CAAA;MACxG,CAAA;MACAY,QAAeC;IACjB;EACF,CAAA;AACF,GApBiBpB,kBAAAA,gBAAAA,CAAAA,EAAAA;;",
+  "names": ["Schema", "Label", "Union", "String", "mutable", "Tuple", "Struct", "ns", "count", "optional", "Number", "defaultValue", "Schema", "Operation", "UNDO_NAMESPACE", "UndoOperation", "ShowUndo", "Operation", "make", "meta", "key", "name", "description", "executionMode", "services", "Capability", "Service", "schema", "input", "Struct", "message", "optional", "Label", "annotations", "output", "Void"]
+}

package/dist/lib/browser/chunk-WEBSGU5L.mjs

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

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

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

package/dist/lib/browser/chunk-YAFEA4GV.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-YAFEA4GV.mjs.map

package/dist/lib/browser/{chunk-6Y7PZV72.mjs → chunk-YNFPIQGB.mjs}

@@ -28,8 +28,7 @@ var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
 var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(interfaceDef));
 var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
 var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
-var InterfaceDefTypeId = Symbol.for("InterfaceDefTypeId");
-var ModuleTag = Symbol.for("@dxos/app-framework/ModuleTag");
+var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
 var make = (identifier) => {
   return {
     identifier
@@ -74,4 +73,4 @@ export {
   makeModule,
   capability_exports
 };
-//# sourceMappingURL=chunk-6Y7PZV72.mjs.map
+//# sourceMappingURL=chunk-YNFPIQGB.mjs.map

package/dist/lib/browser/{chunk-6Y7PZV72.mjs.map → chunk-YNFPIQGB.mjs.map}

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

package/dist/lib/browser/cli/index.mjs

@@ -0,0 +1,89 @@
+import "../chunk-TIEBZMTF.mjs";
+import {
+  capabilities_exports
+} from "../chunk-WEBSGU5L.mjs";
+import {
+  activation_events_exports
+} from "../chunk-M5IC326L.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import {
+  plugin_manager_exports
+} from "../chunk-2UI6ACB5.mjs";
+import "../chunk-272IPLHQ.mjs";
+import {
+  plugin_exports
+} from "../chunk-7M4467QR.mjs";
+import {
+  capability_exports
+} from "../chunk-YNFPIQGB.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/cli/cli.ts
+import * as Command from "@effect/cli/Command";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/cli/cli.ts";
+var defaultPluginLoader = (plugins) => (id) => Effect.sync(() => {
+  const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
+  invariant(plugin, `Plugin not found: ${id}`, {
+    F: __dxlog_file,
+    L: 19,
+    S: void 0,
+    A: [
+      "plugin",
+      "`Plugin not found: ${id}`"
+    ]
+  });
+  return plugin;
+});
+var createCliApp = Effect.fn(function* ({ rootCommand, subCommands: subCommandsProp, pluginManager: pluginManagerProp, pluginLoader: pluginLoaderProp, plugins: pluginsProp = [], core: coreProp, enabled: enabledProp = [], safeMode = false }) {
+  const plugins = pluginsProp;
+  const core = coreProp ?? plugins.map(({ meta }) => meta.id);
+  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);
+  const enabled = safeMode ? [] : enabledProp;
+  const manager = pluginManagerProp ?? plugin_manager_exports.make({
+    pluginLoader,
+    plugins,
+    core,
+    enabled
+  });
+  manager.capabilities.contribute({
+    interface: capabilities_exports.PluginManager,
+    implementation: manager,
+    module: "org.dxos.app-framework.plugin-manager"
+  });
+  manager.capabilities.contribute({
+    interface: capabilities_exports.AtomRegistry,
+    implementation: manager.registry,
+    module: "org.dxos.app-framework.atom-registry"
+  });
+  yield* manager.activate(activation_events_exports.Startup);
+  const layers = manager.capabilities.getAll(capabilities_exports.Layer);
+  const capabilityServiceLayer = Layer.succeed(capability_exports.Service, manager.capabilities);
+  const pluginServiceLayer = Layer.succeed(plugin_exports.Service, manager);
+  const layer = Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer, ...layers);
+  const pluginCommands = manager.capabilities.getAll(capabilities_exports.Command);
+  const subCommands = subCommandsProp ? [
+    ...subCommandsProp,
+    ...pluginCommands
+  ] : pluginCommands;
+  invariant(subCommands.length > 0, "No subcommands provided", {
+    F: __dxlog_file,
+    L: 103,
+    S: this,
+    A: [
+      "subCommands.length > 0",
+      "'No subcommands provided'"
+    ]
+  });
+  const command = rootCommand.pipe(Command.withSubcommands(subCommands));
+  return {
+    command,
+    layer
+  };
+});
+export {
+  createCliApp
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/browser/cli/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/cli.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Command from '@effect/cli/Command';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Capability, Plugin, PluginManager } from '../core';\n\nconst defaultPluginLoader =\n  (plugins: Plugin.Plugin[]): PluginManager.ManagerOptions['pluginLoader'] =>\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\ntype SubCommands = [Command.Command<any, any, any, any>, ...Array<Command.Command<any, any, any, any>>];\n\nexport type CreateCliAppOptions = {\n  rootCommand: Command.Command<any, any, any, any>;\n  subCommands?: SubCommands;\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  plugins?: Plugin.Plugin[];\n  core?: string[];\n  enabled?: string[];\n  safeMode?: boolean;\n};\n\n/**\n * Creates a CLI application with plugin support.\n * Similar to useApp but for CLI environments.\n *\n * @example\n * const plugins = [ClientPluginCLI()];\n * const manager = await createCliApp({ plugins });\n * const commands = manager.capabilities.getAll(Capabilities.Command);\n *\n * @param options.pluginManager Optional existing PluginManager instance.\n * @param options.pluginLoader Function to load plugins by ID.\n * @param options.plugins All plugins available to the application.\n * @param options.core Core plugins which will always be enabled.\n * @param options.enabled Enabled plugins.\n * @param options.safeMode Whether to enable safe mode, which disables optional plugins.\n */\nexport const createCliApp = Effect.fn(function* ({\n  rootCommand,\n  subCommands: subCommandsProp,\n  pluginManager: pluginManagerProp,\n  pluginLoader: pluginLoaderProp,\n  plugins: pluginsProp = [],\n  core: coreProp,\n  enabled: enabledProp = [],\n  safeMode = false,\n}: CreateCliAppOptions) {\n  const plugins = pluginsProp;\n  const core = coreProp ?? plugins.map(({ meta }) => meta.id);\n  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);\n  const enabled = safeMode ? [] : enabledProp;\n  const manager =\n    pluginManagerProp ??\n    PluginManager.make({\n      pluginLoader,\n      plugins,\n      core,\n      enabled,\n    });\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  // Activate startup event to load CLI commands and Effect layers.\n  yield* manager.activate(ActivationEvents.Startup);\n\n  // Gather all layers and merge them into a single layer.\n  const layers = manager.capabilities.getAll(Capabilities.Layer);\n  const capabilityServiceLayer = Layer.succeed(Capability.Service, manager.capabilities);\n  const pluginServiceLayer = Layer.succeed(Plugin.Service, manager);\n  const layer = (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n    capabilityServiceLayer,\n    pluginServiceLayer,\n    ...layers,\n  );\n\n  // Gather all commands and provide them to the root command.\n  const pluginCommands = manager.capabilities.getAll(Capabilities.Command);\n  const subCommands = subCommandsProp ? [...subCommandsProp, ...pluginCommands] : pluginCommands;\n  invariant(subCommands.length > 0, 'No subcommands provided');\n  const command = rootCommand.pipe(Command.withSubcommands(subCommands as SubCommands));\n\n  return { command, layer };\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AACxB,YAAYC,WAAW;AAEvB,SAASC,iBAAiB;;AAK1B,IAAMC,sBACJ,CAACC,YACD,CAACC,OACQC,YAAK,MAAA;AACV,QAAMC,SAASH,QAAQI,KAAK,CAACD,YAAWA,QAAOE,KAAKJ,OAAOA,EAAAA;AAC3DK,YAAUH,QAAQ,qBAAqBF,EAAAA,IAAI;;;;;;;;;AAC3C,SAAOE;AACT,CAAA;AA+BG,IAAMI,eAAsBC,UAAG,WAAW,EAC/CC,aACAC,aAAaC,iBACbC,eAAeC,mBACfC,cAAcC,kBACdf,SAASgB,cAAc,CAAA,GACvBC,MAAMC,UACNC,SAASC,cAAc,CAAA,GACvBC,WAAW,MAAK,GACI;AACpB,QAAMrB,UAAUgB;AAChB,QAAMC,OAAOC,YAAYlB,QAAQsB,IAAI,CAAC,EAAEjB,KAAI,MAAOA,KAAKJ,EAAE;AAC1D,QAAMa,eAAeC,oBAAoBhB,oBAAoBC,OAAAA;AAC7D,QAAMmB,UAAUE,WAAW,CAAA,IAAKD;AAChC,QAAMG,UACJV,qBACAW,uBAAcC,KAAK;IACjBX;IACAd;IACAiB;IACAE;EACF,CAAA;AAEFI,UAAQG,aAAaC,WAAW;IAC9BC,WAAWC,qBAAaL;IACxBM,gBAAgBP;IAChBQ,QAAQ;EACV,CAAA;AAEAR,UAAQG,aAAaC,WAAW;IAC9BC,WAAWC,qBAAaG;IACxBF,gBAAgBP,QAAQU;IACxBF,QAAQ;EACV,CAAA;AAGA,SAAOR,QAAQW,SAASC,0BAAiBC,OAAO;AAGhD,QAAMC,SAASd,QAAQG,aAAaY,OAAOT,qBAAaU,KAAK;AAC7D,QAAMC,yBAA+BC,cAAQC,mBAAWC,SAASpB,QAAQG,YAAY;AACrF,QAAMkB,qBAA2BH,cAAQI,eAAOF,SAASpB,OAAAA;AACzD,QAAMuB,QAAeC,eACnBP,wBACAI,oBAAAA,GACGP,MAAAA;AAIL,QAAMW,iBAAiBzB,QAAQG,aAAaY,OAAOT,qBAAaoB,OAAO;AACvE,QAAMvC,cAAcC,kBAAkB;OAAIA;OAAoBqC;MAAkBA;AAChF1C,YAAUI,YAAYwC,SAAS,GAAG,2BAAA;;;;;;;;;AAClC,QAAMC,UAAU1C,YAAY2C,KAAaC,wBAAgB3C,WAAAA,CAAAA;AAEzD,SAAO;IAAEyC;IAASL;EAAM;AAC1B,CAAA;",
+  "names": ["Command", "Effect", "Layer", "invariant", "defaultPluginLoader", "plugins", "id", "sync", "plugin", "find", "meta", "invariant", "createCliApp", "fn", "rootCommand", "subCommands", "subCommandsProp", "pluginManager", "pluginManagerProp", "pluginLoader", "pluginLoaderProp", "pluginsProp", "core", "coreProp", "enabled", "enabledProp", "safeMode", "map", "manager", "PluginManager", "make", "capabilities", "contribute", "interface", "Capabilities", "implementation", "module", "AtomRegistry", "registry", "activate", "ActivationEvents", "Startup", "layers", "getAll", "Layer", "capabilityServiceLayer", "succeed", "Capability", "Service", "pluginServiceLayer", "Plugin", "layer", "mergeAll", "pluginCommands", "Command", "length", "command", "pipe", "withSubcommands"]
+}

package/dist/lib/browser/common/activation-events.mjs

@@ -0,0 +1,23 @@
+import {
+  ManagedRuntimeReady,
+  OperationInvokerReady,
+  SetupLayer,
+  SetupOperationResolver,
+  SetupReactSurface,
+  Startup
+} from "../chunk-M5IC326L.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import "../chunk-2UI6ACB5.mjs";
+import "../chunk-272IPLHQ.mjs";
+import "../chunk-7M4467QR.mjs";
+import "../chunk-YNFPIQGB.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ManagedRuntimeReady,
+  OperationInvokerReady,
+  SetupLayer,
+  SetupOperationResolver,
+  SetupReactSurface,
+  Startup
+};
+//# sourceMappingURL=activation-events.mjs.map

package/dist/lib/browser/common/capabilities.mjs

@@ -0,0 +1,45 @@
+import {
+  AtomRegistry,
+  Command,
+  HistoryTracker,
+  Layer,
+  ManagedRuntime,
+  Null,
+  OperationInvoker,
+  OperationResolver,
+  PluginManager,
+  ReactContext,
+  ReactRoot,
+  ReactSurface,
+  UndoMapping,
+  UndoRegistry,
+  getAtomValue,
+  subscribeAtom,
+  updateAtomValue
+} from "../chunk-WEBSGU5L.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import "../chunk-2UI6ACB5.mjs";
+import "../chunk-272IPLHQ.mjs";
+import "../chunk-7M4467QR.mjs";
+import "../chunk-YNFPIQGB.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  AtomRegistry,
+  Command,
+  HistoryTracker,
+  Layer,
+  ManagedRuntime,
+  Null,
+  OperationInvoker,
+  OperationResolver,
+  PluginManager,
+  ReactContext,
+  ReactRoot,
+  ReactSurface,
+  UndoMapping,
+  UndoRegistry,
+  getAtomValue,
+  subscribeAtom,
+  updateAtomValue
+};
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/browser/core/activation-event.mjs

@@ -6,7 +6,7 @@ import {
   isOneOf,
   make,
   oneOf
-} from "../chunk-PKQT6C53.mjs";
+} from "../chunk-272IPLHQ.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   allOf,

package/dist/lib/browser/core/capability.mjs

@@ -10,7 +10,7 @@ import {
   make,
   makeModule,
   waitFor
-} from "../chunk-6Y7PZV72.mjs";
+} from "../chunk-YNFPIQGB.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   ModuleTag,