@dxos/app-framework 0.8.3 → 0.8.4-main.1068cf700f

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ui/components/App.tsx", "../../../src/helpers.ts", "../../../src/ui/hooks/useApp.tsx", "../../../src/ui/components/DefaultFallback.tsx", "../../../src/ui/components/ErrorBoundary.tsx", "../../../src/ui/components/PluginManagerProvider.ts", "../../../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/surface/context.ts", "../../../src/ui/components/surface/index.ts", "../../../src/ui/components/surface/types.ts", "../../../src/ui/components/surface/SurfaceComponent.tsx", "../../../src/ui/components/surface/SurfaceInfo.tsx"],
+  "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 { 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 } from '../components/App';\nimport { DefaultFallback } from '../components/DefaultFallback';\nimport { ErrorBoundary } from '../components/ErrorBoundary';\nimport { PluginManagerProvider } from '../components/PluginManagerProvider';\n\nconst ENABLED_KEY = 'dxos.org/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  placeholder?: FC<{ stage: number }>;\n  fallback?: ErrorBoundary['props']['fallback'];\n  cacheEnabled?: boolean;\n  safeMode?: boolean;\n  debounce?: number;\n  timeout?: 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.placeholder Placeholder component to render during startup.\n * @param params.fallback Fallback component to render if an error occurs during startup.\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 */\nexport const useApp = ({\n  pluginManager,\n  pluginLoader: pluginLoaderProp,\n  plugins: pluginsProp,\n  core: coreProp,\n  defaults: defaultsProp,\n  setupEvents: setupEventsProp,\n  placeholder,\n  fallback = DefaultFallback,\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: 'dxos.org/app-framework/plugin-manager',\n    });\n\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'dxos.org/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 fallback={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 React from 'react';\n\n/**\n * NOTE: Default fallback should not use tailwind or theme.\n */\nexport const DefaultFallback = ({ error }: { error: Error }) => {\n  return (\n    <div\n      style={{\n        margin: '1rem',\n        padding: '1rem',\n        overflow: 'hidden',\n        border: '4px solid teal',\n        borderRadius: '1rem',\n      }}\n    >\n      {/* TODO(wittjosiah): Link to docs for replacing default. */}\n      <h1 style={{ margin: '0.5rem 0', fontSize: '1.2rem' }}>ERROR: {error.message}</h1>\n      <pre style={{ overflow: 'auto', fontSize: '1rem', whiteSpace: 'pre-wrap', color: '#888888' }}>{error.stack}</pre>\n    </div>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { Component, type FC, type PropsWithChildren, type ReactNode } from 'react';\n\ntype State = {\n  error: Error | undefined;\n};\n\nexport type ErrorBoundaryProps = PropsWithChildren<{\n  data?: any;\n  fallback?: FC<{ data?: any; error: Error }>;\n}>;\n\n/**\n * Surface error boundary.\n * For basic usage prefer providing a fallback component to `Surface`.\n *\n * Ref: https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, State> {\n  static getDerivedStateFromError(error: Error): { error: Error } {\n    return { error };\n  }\n\n  override state = { error: undefined };\n\n  override componentDidUpdate(prevProps: ErrorBoundaryProps): void {\n    if (prevProps.data !== this.props.data) {\n      this.resetError();\n    }\n  }\n\n  override render(): ReactNode {\n    if (this.state.error) {\n      const Fallback = this.props.fallback ?? DefaultFallback;\n      return <Fallback data={this.props.data} error={this.state.error} />;\n    }\n\n    return this.props.children;\n  }\n\n  private resetError(): void {\n    this.setState({ error: undefined });\n  }\n}\n\nconst DefaultFallback: NonNullable<ErrorBoundaryProps['fallback']> = ({ data, error }) => {\n  return (\n    <div className='flex flex-col gap-2 overflow-hidden border border-red-500 rounded-sm'>\n      <h1 className='p-2'>ERROR: {error.message}</h1>\n      <pre className='p-2 overflow-y-auto text-sm text-subdued'>{JSON.stringify(data, null, 2)}</pre>\n    </div>\n  );\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 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/PluginManagerProvider';\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/PluginManagerProvider';\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 { SurfaceContext } from '../components/surface/context';\n\nexport const useSurface = (): SurfaceContext => {\n  return useContext(SurfaceContext) ?? raise(new Error('Missing SurfaceContext'));\n};\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\nexport * from './types';\nexport { Surface } from './SurfaceComponent';\nexport { isSurfaceAvailable as isAvailable } from './SurfaceComponent';\nexport type { SurfaceContext as Root } from './context';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { PropsWithChildren, ReactNode, RefCallback } from 'react';\n\nimport type { MakeOptional, Position } from '@dxos/util';\n\nimport type { ErrorBoundary } from '..';\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?: ErrorBoundary['props']['fallback'];\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\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 { useDefaultValue } from '@dxos/react-hooks';\nimport { ScrollArea } from '@dxos/react-ui';\nimport { byPosition } from '@dxos/util';\n\nimport { Capabilities } from '../../../common';\nimport { type CapabilityManager } from '../../../core';\nimport { useCapabilities } from '../../hooks';\nimport { ErrorBoundary } from '../ErrorBoundary';\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 */\nconst SurfaceContextProvider = memo(\n  forwardRef<HTMLElement, Props & { definition: Definition }>(\n    ({ id, role, data, limit, fallback = DefaultFallback, 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 data={data} fallback={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 data={data} fallback={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 data={data} fallback={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 Surface: 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\nSurface.displayName = 'Surface';\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// TODO(burdon): Make user facing, with telemetry.\n// TODO(burdon): Change based on dev/prod mode; infer subject type, id.\nconst DefaultFallback = ({ data, error, dev }: { data: any; error: Error; dev?: boolean }) => {\n  if (dev) {\n    return (\n      <ScrollArea.Root orientation='vertical'>\n        <ScrollArea.Viewport classNames='p-4 gap-4'>\n          <h1 className='flex gap-2 text-sm mbs-2'>{error.message}</h1>\n          <pre className='overflow-auto text-xs text-description'>{JSON.stringify(data, null, 2)}</pre>\n        </ScrollArea.Viewport>\n      </ScrollArea.Root>\n    );\n  }\n\n  return (\n    <ScrollArea.Root orientation='vertical'>\n      <ScrollArea.Viewport classNames='p-4 gap-4 border border-roseFill'>\n        <h1 className='flex gap-2 text-sm mbs-2 text-errorText'>{error.message}</h1>\n        <pre className='overflow-x-auto text-xs text-description'>{error.stack}</pre>\n        <pre className='overflow-x-auto text-xs text-description'>{JSON.stringify(data, null, 2)}</pre>\n      </ScrollArea.Viewport>\n    </ScrollArea.Root>\n  );\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-deckSurface 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"],
+  "mappings": "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",
+  "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", "useAsyncEffect", "useDefaultValue", "ContextProtocolProvider", "React", "DefaultFallback", "error", "div", "style", "margin", "padding", "overflow", "border", "borderRadius", "h1", "fontSize", "message", "pre", "whiteSpace", "color", "stack", "React", "Component", "ErrorBoundary", "Component", "getDerivedStateFromError", "error", "state", "undefined", "componentDidUpdate", "prevProps", "data", "props", "resetError", "render", "Fallback", "fallback", "DefaultFallback", "React", "children", "setState", "div", "className", "h1", "message", "pre", "JSON", "stringify", "createContext", "useContext", "raise", "PluginManagerContext", "createContext", "undefined", "usePluginManager", "useContext", "raise", "Error", "PluginManagerProvider", "Provider", "ENABLED_KEY", "useApp", "pluginManager", "pluginLoader", "pluginLoaderProp", "plugins", "pluginsProp", "core", "coreProp", "defaults", "defaultsProp", "setupEvents", "setupEventsProp", "placeholder", "fallback", "DefaultFallback", "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", "React", "ErrorBoundary", "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", "createContext", "SurfaceContext", "createContext", "undefined", "useSurface", "useContext", "SurfaceContext", "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", "create", "definition", "kind", "createWeb", "React", "Fragment", "Suspense", "forwardRef", "memo", "useEffect", "useMemo", "useRef", "log", "useDefaultValue", "ScrollArea", "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", "DefaultFallback", "contextValue", "useMemo", "kind", "ErrorBoundary", "SurfaceContext", "Provider", "value", "Component", "component", "debug", "window", "className", "data-id", "data-role", "SurfaceInfo", "Surface", "_id", "dataProp", "placeholder", "useDefaultValue", "surfaces", "useSurfaces", "definitions", "findCandidates", "candidates", "slice", "length", "log", "warn", "Suspense", "map", "key", "values", "filter", "Array", "isArray", "includes", "toSorted", "byPosition", "error", "dev", "ScrollArea", "Root", "orientation", "Viewport", "classNames", "h1", "message", "pre", "JSON", "stringify", "stack", "useCapabilities", "Capabilities", "ReactSurface", "flat", "isSurfaceAvailable", "capabilityManager", "getAll"]
+}

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

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

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

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

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

@@ -0,0 +1,89 @@
+import "../chunk-4DQMLMGU.mjs";
+import {
+  capabilities_exports
+} from "../chunk-IGRQWMWW.mjs";
+import {
+  activation_events_exports
+} from "../chunk-NPUEVX42.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import {
+  plugin_manager_exports
+} from "../chunk-WGWEEBUV.mjs";
+import "../chunk-PKQT6C53.mjs";
+import {
+  plugin_exports
+} from "../chunk-KWP6PKIU.mjs";
+import {
+  capability_exports
+} from "../chunk-ZQO3UZ4R.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: "dxos.org/app-framework/plugin-manager"
+  });
+  manager.capabilities.contribute({
+    interface: capabilities_exports.AtomRegistry,
+    implementation: manager.registry,
+    module: "dxos.org/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: 'dxos.org/app-framework/plugin-manager',\n  });\n\n  manager.capabilities.contribute({\n    interface: Capabilities.AtomRegistry,\n    implementation: manager.registry,\n    module: 'dxos.org/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-NPUEVX42.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import "../chunk-WGWEEBUV.mjs";
+import "../chunk-PKQT6C53.mjs";
+import "../chunk-KWP6PKIU.mjs";
+import "../chunk-ZQO3UZ4R.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-IGRQWMWW.mjs";
+import "../chunk-YAFEA4GV.mjs";
+import "../chunk-WGWEEBUV.mjs";
+import "../chunk-PKQT6C53.mjs";
+import "../chunk-KWP6PKIU.mjs";
+import "../chunk-ZQO3UZ4R.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

@@ -0,0 +1,20 @@
+import {
+  allOf,
+  eventKey,
+  getEvents,
+  isAllOf,
+  isOneOf,
+  make,
+  oneOf
+} from "../chunk-PKQT6C53.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  allOf,
+  eventKey,
+  getEvents,
+  isAllOf,
+  isOneOf,
+  make,
+  oneOf
+};
+//# sourceMappingURL=activation-event.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,28 @@
+import {
+  ModuleTag,
+  Service,
+  atom,
+  contributes,
+  get,
+  getAll,
+  getModuleTag,
+  lazy,
+  make,
+  makeModule,
+  waitFor
+} from "../chunk-ZQO3UZ4R.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ModuleTag,
+  Service,
+  atom,
+  contributes,
+  get,
+  getAll,
+  getModuleTag,
+  lazy,
+  make,
+  makeModule,
+  waitFor
+};
+//# sourceMappingURL=capability.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/browser/core/plugin-manager.mjs

@@ -0,0 +1,15 @@
+import {
+  ManagerTypeId,
+  isManager,
+  make
+} from "../chunk-WGWEEBUV.mjs";
+import "../chunk-PKQT6C53.mjs";
+import "../chunk-KWP6PKIU.mjs";
+import "../chunk-ZQO3UZ4R.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ManagerTypeId,
+  isManager,
+  make
+};
+//# sourceMappingURL=plugin-manager.mjs.map

package/dist/lib/browser/core/plugin-manager.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,27 @@
+import {
+  PluginModuleTypeId,
+  PluginTypeId,
+  Service,
+  activate,
+  addModule,
+  define,
+  isPlugin,
+  isPluginModule,
+  make,
+  reset
+} from "../chunk-KWP6PKIU.mjs";
+import "../chunk-ZQO3UZ4R.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  PluginModuleTypeId,
+  PluginTypeId,
+  Service,
+  activate,
+  addModule,
+  define,
+  isPlugin,
+  isPluginModule,
+  make,
+  reset
+};
+//# sourceMappingURL=plugin.mjs.map

package/dist/lib/browser/core/plugin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}