@dxos/app-framework 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

package/dist/lib/browser/chunk-5LAIGWLU.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ui/components/App/App.tsx", "../../../src/ui/hooks/useApp.tsx", "../../../src/ui/hooks/useCapabilities.ts", "../../../src/ui/hooks/useLoading.tsx", "../../../src/ui/hooks/useSettingsState.ts", "../../../src/ui/components/Placeholder/Placeholder.tsx"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useEffect } from 'react';\n\nimport { Capabilities } from '../../../common';\nimport { topologicalSort } from '../../../helpers';\nimport { LoadingState, type StartupProgress, type UseAppOptions, useCapabilities, useLoading } from '../../hooks';\n\nexport type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {\n  ready: boolean;\n  error: unknown;\n  progress?: StartupProgress;\n};\n\nconst FIRST_INTERACTIVE_MARK = 'app-framework:first-interactive';\n\nexport const App = ({ placeholder: Placeholder, ready, error, debounce, progress }: AppProps) => {\n  const reactContexts = useCapabilities(Capabilities.ReactContext);\n  const reactRoots = useCapabilities(Capabilities.ReactRoot);\n  const stage = useLoading(ready, debounce);\n  const placeholderDismissed = stage >= LoadingState.Done;\n\n  // Emit a once-per-app `app-framework:first-interactive` mark the first time\n  // the placeholder is dismissed and the real app shell renders. Closes the\n  // gap between `Startup` activated and the first interactive paint.\n  //\n  // Also dismisses the native-DOM boot loader from\n  // `@dxos/app-framework/vite-plugin` here — the framework owns the\n  // handoff-complete signal, so dismissing in `App` covers both hosts that\n  // wire in a `Placeholder` (which may have its own dismiss path) and hosts\n  // that don't (the loader would otherwise sit forever as a `z-index: 10`\n  // overlay covering the rendered shell).\n  useEffect(() => {\n    if (!placeholderDismissed) {\n      return;\n    }\n    if (performance.getEntriesByName(FIRST_INTERACTIVE_MARK).length === 0) {\n      performance.mark(FIRST_INTERACTIVE_MARK);\n    }\n    (window as { __bootLoader?: { dismiss?: () => void } }).__bootLoader?.dismiss?.();\n  }, [placeholderDismissed]);\n\n  if (error) {\n    // This triggers the error boundary to provide UI feedback for the startup error.\n    throw error;\n  }\n\n  // TODO(wittjosiah): Consider using Suspense instead.\n  if (!placeholderDismissed) {\n    if (!Placeholder) {\n      return null;\n    }\n\n    return <Placeholder stage={stage} progress={progress} />;\n  }\n\n  const ComposedContext = composeContexts(reactContexts);\n  return (\n    <ComposedContext>\n      {reactRoots.map(({ id, root: Component }) => (\n        <Component key={id} />\n      ))}\n    </ComposedContext>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]) => {\n  if (contexts.length === 0) {\n    return ({ children }: PropsWithChildren) => <>{children}</>;\n  }\n\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\nimport * as Fiber from 'effect/Fiber';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\nimport React, { type FC, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { runAndForwardErrors } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { ErrorBoundary, ErrorFallback, type FallbackProps } from '@dxos/react-error-boundary';\nimport { useAsyncEffect, useDefaultValue } from '@dxos/react-hooks';\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { ActivationEvents, Capabilities } from '../../common';\nimport { PluginManagerContext } from '../../context';\nimport { type ActivationEvent, type Plugin, PluginManager } from '../../core';\nimport { App, PluginManagerProvider } from '../components';\n\nconst ENABLED_KEY = 'org.dxos.app-framework.enabled';\n\nexport type StartupProgress = {\n  /** Number of modules that have been activated. */\n  activated: number;\n  /** Total number of modules registered. */\n  total: number;\n  /** Fractional progress (0-1). */\n  progress: number;\n  /**\n   * Raw activation event key (e.g. `org.dxos.app-framework.event.startup`).\n   * Set on event-level transitions, *and* on module-level transitions where\n   * it carries the parent activation event that first triggered the\n   * module's load (plumbed through `_loadCapabilitiesForModules` →\n   * `_loadModule`). Consumers can use this either as the primary id (when\n   * {@link module} is absent) or as an extra \"context\" field alongside\n   * {@link module}.\n   */\n  event?: string;\n  /**\n   * Raw module id (e.g. `org.dxos.plugin.observability.module.ReactSurface`)\n   * when the in-flight activation is module-level. When present,\n   * {@link event} may also be set, identifying the parent activation that\n   * triggered this module's load.\n   */\n  module?: string;\n  /**\n   * Pre-humanized label for the currently surfaced transition (module\n   * label if {@link module} is set, otherwise the event label), supplied\n   * for consumers that want a sensible default. Hosts that prefer to\n   * render their own label can read the raw {@link event}/{@link module}\n   * fields and ignore this — the framework leaves the policy choice\n   * (which transitions to surface, how to format them, whether to drop\n   * sub-modules entirely) to the host's `Placeholder`.\n   */\n  humanizedName?: string;\n};\n\nexport type PlaceholderProps = {\n  stage?: number;\n  progress?: StartupProgress;\n};\n\nexport type UseAppOptions = {\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  onPluginRemove?: PluginManager.ManagerOptions['onRemove'];\n  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<PlaceholderProps>;\n};\n\n/**\n * Expected usage is for this to be the entrypoint of the application.\n * Initializes plugins and renders the root components.\n *\n * @example\n * const plugins = [LayoutPlugin(), MyPlugin()];\n * const 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  onPluginRemove,\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  const pluginLoader = useMemo(\n    () =>\n      pluginLoaderProp ??\n      ((id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.id === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return plugin;\n        })),\n    [pluginLoaderProp, plugins],\n  );\n\n  const readyRef = useRef(false);\n  const [ready, setReady] = useState(false);\n  const errorRef = useRef<unknown>(null);\n  const [error, setError] = useState<unknown>(null);\n  const [startupProgress, setStartupProgress] = useState<StartupProgress>({\n    activated: 0,\n    total: 0,\n    progress: 0,\n  });\n  // TODO(wittjosiah): Migrate to Atom.kvs for isomorphic storage.\n  const cached: string[] = useMemo(() => JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]'), []);\n  const enabled = useMemo(\n    () => (safeMode ? [] : cacheEnabled && cached.length > 0 ? cached : defaults),\n    [safeMode, cacheEnabled, cached, defaults],\n  );\n  const isExternalManager = !!pluginManager;\n  const manager = useMemo(() => {\n    const mgr = pluginManager ?? PluginManager.make({ pluginLoader, plugins, core, enabled, onRemove: onPluginRemove });\n    log('useApp: useMemo created/reused manager', { provided: !!pluginManager });\n    return mgr;\n  }, [pluginManager, pluginLoader, plugins, core, enabled, onPluginRemove]);\n\n  useEffect(() => {\n    if (!cacheEnabled) {\n      return;\n    }\n    return manager.registry.subscribe(manager.enabled, (value) => {\n      localStorage.setItem(ENABLED_KEY, JSON.stringify(value));\n    });\n  }, [cacheEnabled, manager]);\n\n  useEffect(() => {\n    setupDevtools(manager);\n  }, [manager]);\n\n  useAsyncEffect(async () => {\n    log('useApp: effect mount');\n\n    manager.capabilities.contribute({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'org.dxos.app-framework.plugin-manager',\n    });\n\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'org.dxos.app-framework.atom-registry',\n    });\n\n    const fiber = Effect.gen(function* () {\n      const queue = yield* PubSub.subscribe(manager.activation);\n      const listener = yield* Effect.forkDaemon(\n        Queue.take(queue).pipe(\n          Effect.tap(({ event, state, module, error: error$ }) =>\n            Effect.sync(() => {\n              // Event-level Startup activated (no `module` field) fires once,\n              // after every module triggered by Startup has finished. Module\n              // activations now also carry their parent event id (so the trace\n              // can attribute a module to its triggering event), which means\n              // each module activated under Startup publishes\n              // `{ event: 'startup', state: 'activated', module: <id> }`. Without\n              // the `!module` guard the listener would mark the app ready on\n              // the *first* such module rather than waiting for the event-level\n              // completion — leaving downstream capabilities (operation-invoker,\n              // app-graph, …) un-registered when the placeholder dismisses.\n              if (event === ActivationEvents.Startup.id && state === 'activated' && !module) {\n                clearTimeout(timeoutId);\n                setReady(true);\n                readyRef.current = true;\n                // Trigger startup profiler dump if available.\n                (globalThis as any).composer?.profiler?.dump();\n                // Notify any host observability layer that startup completed.\n                // A `CustomEvent` keeps this generic — app-framework doesn't\n                // import a provider, and consumers can capture the startup\n                // summary without us picking one.\n                if (typeof window !== 'undefined') {\n                  window.dispatchEvent(new CustomEvent('app-framework:startup-activated'));\n                }\n                return;\n              }\n              // `activating` is the start-of-load signal. Surface the raw\n              // `module` (or `event`) plus a pre-humanized label so the\n              // host placeholder can decide what to render — show\n              // everything, suppress noisy sub-modules, group by plugin,\n              // or apply its own formatting. We intentionally do NOT touch\n              // these fields on `activated`: pairing the two would cause\n              // back-to-back identical updates to the host's effect, which\n              // the boot loader treats as a re-trigger because\n              // `progress.progress` moved. Leaving the label alone on\n              // completion keeps it accurate (\"now activating X\") until\n              // the next module starts.\n              if (module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  // `event` here is the activation event that first\n                  // triggered this module load (plumbed through\n                  // `_loadCapabilitiesForModules` → `_loadModule`).\n                  // Falsy/empty falls back to undefined so consumers can\n                  // tell \"no parent context\" from \"parent context: <X>\".\n                  event: event || undefined,\n                  module,\n                  humanizedName: humanizeModuleId(module),\n                }));\n              }\n              // Update the activation count when a module commits. The\n              // ring's fraction comes from this; `event`/`module`/\n              // `humanizedName` were set by the matching `activating`\n              // message above and are left alone so the count can advance\n              // without re-firing the host's status callback.\n              if (module && state === 'activated' && !readyRef.current) {\n                const active = manager.getActive();\n                const total = manager.getModules().length;\n                setStartupProgress((current) => ({\n                  ...current,\n                  activated: active.length,\n                  total,\n                  progress: total > 0 ? active.length / total : 0,\n                }));\n              }\n              // Event-level `activating` (no `module`) — fired at the start\n              // of `_activateModulesForEvent` and recursively for each\n              // before/after event. Surfaces a label during the gap before\n              // the first module-level message lands; subsequent module\n              // updates immediately overwrite this with a more specific\n              // label.\n              if (event && !module && state === 'activating' && !readyRef.current) {\n                setStartupProgress((current) => ({\n                  ...current,\n                  event,\n                  module: undefined,\n                  humanizedName: humanizeEventKey(event),\n                }));\n              }\n              if (error$ && !readyRef.current) {\n                setError(error$);\n                errorRef.current = error$;\n              }\n            }),\n          ),\n          Effect.forever,\n        ),\n      );\n\n      yield* Effect.all([\n        ...setupEvents.map((event) => manager.activate(event)),\n        manager.activate(ActivationEvents.SetupReactSurface),\n        manager.activate(ActivationEvents.Startup),\n      ]);\n\n      return yield* Fiber.join(listener);\n    }).pipe(Effect.scoped, Effect.runFork);\n\n    // Set up a timeout for startup.\n    const timeoutId = setTimeout(() => {\n      if (!readyRef.current && !errorRef.current) {\n        log.warn('startup timeout diagnostic', {\n          eventsFired: manager.getEventsFired(),\n          activeModules: manager.getActive(),\n          pendingReset: manager.getPendingReset(),\n        });\n        void runAndForwardErrors(Fiber.interrupt(fiber));\n        setError(new Error(`Startup timed out after ${timeout}ms`));\n      }\n    }, timeout);\n\n    return () => {\n      log('useApp: effect cleanup');\n      clearTimeout(timeoutId);\n      void runAndForwardErrors(Fiber.interrupt(fiber));\n      if (!isExternalManager) {\n        void runAndForwardErrors(manager.shutdown());\n      }\n    };\n  }, [manager]);\n\n  const progressRef = useRef(startupProgress);\n  progressRef.current = startupProgress;\n\n  return useCallback(\n    () => (\n      <ErrorBoundary name='app' FallbackComponent={fallback}>\n        <PluginManagerProvider value={manager}>\n          <ContextProtocolProvider value={manager} context={PluginManagerContext}>\n            <RegistryContext.Provider value={manager.registry}>\n              <App\n                placeholder={placeholder}\n                ready={ready}\n                error={error}\n                debounce={debounce}\n                progress={progressRef.current}\n              />\n            </RegistryContext.Provider>\n          </ContextProtocolProvider>\n        </PluginManagerProvider>\n      </ErrorBoundary>\n    ),\n    [fallback, manager, placeholder, ready, error],\n  );\n};\n\nconst setupDevtools = (manager: PluginManager.PluginManager) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.manager = manager;\n};\n\n/**\n * Extracts a human-readable label from a module ID.\n *\n * Module IDs follow `org.dxos.plugin.<plugin-slug>.module.<module-name>`,\n * where `<plugin-slug>` is kebab-case and `<module-name>` is either an\n * explicit string (often kebab-case, e.g. `'observability'`, `'namespace'`)\n * or a capability tag in PascalCase from `Capability.getModuleTag(...)`\n * (e.g. `'ReactSurface'`, `'AppGraphBuilder'`). The output is\n * `\"Title Case Plugin: kebab-module\"` so the visible status names both the\n * plugin and the aspect being activated, helping disambiguate the multiple\n * modules a plugin contributes.\n *\n * Examples:\n *   - \"org.dxos.plugin.markdown.module.ReactSurface\" → \"Markdown: react-surface\"\n *   - \"org.dxos.plugin.observability.module.AppGraphBuilder\" → \"Observability: app-graph-builder\"\n *   - \"org.dxos.plugin.observability.module.observability\" → \"Observability\"\n *     (the module name matches the plugin slug — collapsed to avoid\n *     \"Observability: observability\" noise.)\n */\nconst humanizeModuleId = (moduleId: string): string => {\n  const match = moduleId.match(/\\.plugin\\.([^.]+)\\.module\\.(.+)$/);\n  if (!match) {\n    // Fallback: use the last segment.\n    const parts = moduleId.split('.');\n    return parts[parts.length - 1];\n  }\n  const [, pluginSlug, moduleName] = match;\n  const pluginLabel = pluginSlug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n  // Normalise the module name to kebab-case so PascalCase capability tags\n  // (\"ReactSurface\") read consistently with explicit kebab IDs\n  // (\"operation-handler\"). The two-step substitution handles consecutive\n  // uppercase runs (`URLLoader` → `url-loader`) without splitting them\n  // mid-acronym.\n  const moduleLabel = moduleName\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase();\n  // Capability modules whose name matches the plugin slug (e.g. the\n  // observability plugin's `observability` capability module) would render\n  // as \"Observability: observability\" — drop the redundant suffix.\n  if (moduleLabel === pluginSlug) {\n    return pluginLabel;\n  }\n  return `${pluginLabel}: ${moduleLabel}`;\n};\n\n/**\n * Extracts a human-readable label from an activation event key.\n * E.g., \"org.dxos.app-framework.event.setup-react-surface\" → \"Setup React Surface\".\n */\nconst humanizeEventKey = (eventKey: string): string => {\n  // Strip a leading specifier (composite key form: \"<id>:<specifier>\").\n  const id = eventKey.split(':')[0];\n  // Match the trailing segment after `.event.`.\n  const match = id.match(/\\.event\\.(.+)$/);\n  const slug = match ? match[1] : (id.split('.').pop() ?? id);\n  return slug\n    .split('-')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback } from 'react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { Capabilities } from '../../common';\nimport { type Capability } from '../../core';\nimport { usePluginManager } from '../components';\n\n/**\n * Hook to request capabilities from the plugin context.\n * @returns An array of capabilities.\n */\nexport const useCapabilities = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const manager = usePluginManager();\n  return useAtomValue(manager.capabilities.atom(interfaceDef));\n};\n\n/**\n * Hook to request a capability from the plugin context.\n * @returns The capability.\n * @throws If no capability is found.\n */\nexport const useCapability = <T>(interfaceDef: Capability.InterfaceDef<T>) => {\n  const capabilities = useCapabilities(interfaceDef);\n  invariant(capabilities.length > 0, `No capability found for ${interfaceDef.identifier}`);\n  return capabilities[0];\n};\n\n/**\n * Hook to get the current value of an atom capability.\n * Automatically subscribes to changes.\n * @example const settings = useAtomCapability(ThreadCapabilities.Settings);\n */\nexport const useAtomCapability = <T>(atomCapability: Capability.InterfaceDef<Atom.Atom<T>>): T => {\n  const atom = useCapability(atomCapability);\n  return useAtomValue(atom);\n};\n\n/**\n * Hook to get value and updater for an atom capability.\n * Returns [currentValue, updateFn] similar to useState.\n * @example const [settings, updateSettings] = useAtomCapabilityState(ThreadCapabilities.Settings);\n */\nexport const useAtomCapabilityState = <T>(\n  atomCapability: Capability.InterfaceDef<Atom.Writable<T>>,\n): [T, (fn: (current: T) => T) => void] => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const atom = useCapability(atomCapability);\n  const value = useAtomValue(atom);\n  const update = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n  return [value, update];\n};\n\n/**\n * Hook to get the operation invoker capability.\n */\nexport const useOperationInvoker = (): Capabilities.OperationInvoker => useCapability(Capabilities.OperationInvoker);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useRef, useState } from 'react';\n\nexport enum LoadingState {\n  Loading = 0,\n  FadeIn = 1,\n  FadeOut = 2,\n  Done = 3,\n}\n\n/**\n * To avoid \"flashing\" the placeholder, we wait a period of time before starting the loading animation.\n * If loading completes during this time the placehoder is not shown, otherwise is it displayed for a minimum period of time.\n *\n * States:\n * 0: Loading   - Wait for a period of time before starting the loading animation.\n * 1: Fade-in   - Display a loading animation.\n * 2: Fade-out  - Fade out the loading animation.\n * 3: Done      - Remove the placeholder.\n */\nexport const useLoading = (ready: boolean, debounce = 0) => {\n  const [stage, setStage] = useState<LoadingState>(LoadingState.Loading);\n  // Mirror `ready` into a ref so the interval's `setStage` callback can read\n  // the latest value without depending on the effect re-running. The pure\n  // closure-capture pattern (with `ready` in deps) sticks the FSM at\n  // `FadeIn` whenever HMR doesn't propagate the dep change end-to-end —\n  // a ref sidesteps that entirely and fires the read on every tick.\n  const readyRef = useRef(ready);\n  readyRef.current = ready;\n\n  useEffect(() => {\n    if (!debounce) {\n      return;\n    }\n\n    const i = setInterval(() => {\n      setStage((stage) => {\n        const isReady = readyRef.current;\n        switch (stage) {\n          case LoadingState.Loading: {\n            if (!isReady) {\n              return LoadingState.FadeIn;\n            }\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n\n          case LoadingState.FadeIn: {\n            if (isReady) {\n              return LoadingState.FadeOut;\n            }\n            break;\n          }\n\n          case LoadingState.FadeOut: {\n            clearInterval(i);\n            return LoadingState.Done;\n          }\n        }\n\n        return stage;\n      });\n    }, debounce);\n\n    return () => clearInterval(i);\n  }, [debounce]);\n\n  if (!debounce) {\n    return ready ? LoadingState.Done : LoadingState.Loading;\n  }\n\n  return stage;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom, RegistryContext, useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useContext } from 'react';\n\n/**\n * Hook to read and update a settings atom.\n * Returns the current value and an update function.\n */\nexport const useSettingsState = <T>(\n  atom: Atom.Writable<T>,\n): { settings: T; updateSettings: (fn: (current: T) => T) => void } => {\n  const registry = useContext(RegistryContext);\n  const settings = useAtomValue(atom);\n\n  const updateSettings = useCallback(\n    (fn: (current: T) => T) => {\n      registry.set(atom, fn(registry.get(atom)));\n    },\n    [registry, atom],\n  );\n\n  return { settings, updateSettings };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { type ReactNode, useEffect, useLayoutEffect, useRef } from 'react';\n\nimport { ThemeProvider } from '@dxos/react-ui';\nimport { defaultTx, mx } from '@dxos/ui-theme';\n\nimport { type PlaceholderProps as PlaceholderSlotProps } from '../../hooks';\n\ndeclare global {\n  interface Window {\n    /**\n     * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`.\n     * Declared here so the {@link Placeholder} can dismiss the native-DOM\n     * loader once the React placeholder commits without each host having to\n     * re-declare the type.\n     */\n    __bootLoader?: {\n      status: (payload: {\n        event?: string;\n        module?: string;\n        humanized: string;\n        /**\n         * Optional `(index/total)` tick. When present, the loader replaces the\n         * current line in place (\"Loading plugins (12/80)\") instead of\n         * appending a new entry — keeps the visible log compact during long\n         * counted phases like plugin chunk-loading or module activation.\n         */\n        range?: { index: number; total: number };\n      }) => void;\n      progress: (fraction?: number) => void;\n      dismiss: () => void;\n    };\n  }\n}\n\nexport type PlaceholderComponentProps = PlaceholderSlotProps & {\n  /**\n   * Brand mark rendered while the React tree settles. Pass either a static\n   * `ReactNode` (the framework wraps it in a sizing/animation div) or a\n   * render function that receives the precomputed `className` so the host\n   * can apply it directly to its logo (e.g. an SVG that accepts `className`\n   * — `composer-app` passes `(p) => <Composer {...p} />` from `@dxos/brand`).\n   */\n  logo?: ReactNode | ((props: { className: string }) => ReactNode);\n};\n\n/**\n * React placeholder. The native-DOM boot loader is the visible UI through\n * stages 0 (Loading) and 1 (FadeIn): we render `null` until `stage >= 2`\n * (FadeOut) and instead feed activation progress + status into the still-\n * alive boot loader. At stage 2 the loader dismisses and the React mark\n * appears for the cross-fade to the real shell:\n *\n *   - composer-app fills `0 → 50%` from `getPlugins`'s per-chunk counter.\n *   - this component fills `50 → 100%` from `useApp`'s\n *     `startupProgress.progress` (`activated / total` modules) and pushes\n *     the per-module status text to the loader's status line.\n *   - at `stage >= 2` the boot loader is dismissed and the React mark\n *     starts its `FadeOut → Done` shrink-and-fade.\n *\n * Stage progression (driven by `useApp`):\n *   - `0` — Loading: native-DOM boot loader visible. Placeholder renders nothing.\n *   - `1` — FadeIn: same — boot loader still owns the screen.\n *   - `2` — FadeOut: boot loader dismissed, React mark visible at full opacity then shrinks.\n */\nexport const Placeholder = ({ stage = 1, progress, logo }: PlaceholderComponentProps) => {\n  // Used in tests to exercise the error boundary & reset dialog.\n  if (location.search === '?throw') {\n    throw new Error('Test error');\n  }\n\n  // Phase B: feed activation progress + status to the still-visible boot\n  // loader. Maps `[0, 1]` activation → `[0.5, 1]` of the ring; forwards\n  // the raw activation source (`event` / `module`) plus the pre-humanised\n  // label to `__bootLoader.status` so the loader gets to decide how to\n  // render and trace each transition (current default policy: \"Activating\n  // <humanizedName>\"; trace mode and timings track the structured fields).\n  // No-op once the loader has been dismissed (its `status()` early-returns\n  // when the boot DOM is gone). Skipping `stage >= 2` lets the dismissal\n  // run uncontended.\n  useEffect(() => {\n    if (stage >= 2) {\n      return;\n    }\n    const fraction = progress?.progress ?? 0;\n    window.__bootLoader?.progress(0.5 + fraction * 0.5);\n    if (progress?.humanizedName) {\n      window.__bootLoader?.status({\n        event: progress.event,\n        module: progress.module,\n        humanized: `Activating ${progress.humanizedName}`,\n      });\n    }\n  }, [stage, progress?.progress, progress?.event, progress?.module, progress?.humanizedName]);\n\n  // Hand off from the native-DOM boot loader once the placeholder starts\n  // fading out — keeping the loader visible through `stage 0` and `stage 1`\n  // means the ring stays the visible source of truth for activation\n  // progress. `useLayoutEffect` runs before the next paint so the loader\n  // DOM is removed in the same frame the cross-fade begins.\n  useLayoutEffect(() => {\n    if (stage >= 2) {\n      window.__bootLoader?.dismiss();\n    }\n  }, [stage]);\n\n  // Backstop for the fast-load path where `useLoading` can skip straight\n  // from stage 0 to `Done` (ready=true at the first debounce tick) — the\n  // stage-driven effect above never sees `stage >= 2`, so dismiss on\n  // unmount instead. The `stageRef` guard is what keeps StrictMode's\n  // synthetic mount → cleanup → remount cycle from prematurely dismissing\n  // the loader: the synthetic cleanup runs while `stageRef.current === 0`,\n  // skips the dismiss, and the real unmount (later, at stage `Done`)\n  // performs it.\n  const stageRef = useRef(stage);\n  stageRef.current = stage;\n  useEffect(() => {\n    return () => {\n      if (stageRef.current >= 3 /* Done */) {\n        window.__bootLoader?.dismiss();\n      }\n    };\n  }, []);\n\n  // Defer rendering anything until the FadeOut stage. The boot loader owns\n  // the screen during stages 0 and 1, so any DOM we render here would just\n  // sit invisibly behind it — and rendering null avoids paint cost during\n  // the longest part of the loading sequence (plugin activation).\n  if (stage < 2) {\n    return null;\n  }\n\n  const logoClassName = mx(\n    'h-[300px] w-[300px] scale-600 transition-all duration-500 ease-in-out filter grayscale opacity-0',\n    stage >= 1 && 'scale-100 grayscale-0 opacity-70',\n    stage >= 2 && 'scale-50 opacity-0',\n  );\n\n  return (\n    <ThemeProvider tx={defaultTx}>\n      <div role='none' className='relative dx-container h-dvh flex flex-col'>\n        <div role='none' className='flex flex-col grow justify-center items-center'>\n          {typeof logo === 'function' ? (\n            logo({ className: logoClassName })\n          ) : logo ? (\n            <div className={logoClassName}>{logo}</div>\n          ) : null}\n        </div>\n      </div>\n    </ThemeProvider>\n  );\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAIA,OAAOA,UAAiCC,aAAAA,kBAAiB;;;ACAzD,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,IAAA,eAAMC;;AAwGEC,IAAOC,SAAAA,CAAAA,EAAAA,eAA0B,cAAiB,kBAAoBC,gBAAE,SAAA,aAAA,MAAA,UAAA,UAAA,cAAA,aAAA,iBAAA,aAAA,WAAA,eAAA,eAAA,OAAA,WAAA,OAAA,WAAA,GAAA,UAAA,IAAA,MAAA;AAC9E,QAAMC,UAAAA,gBAAWF,aAAgBG,MAAc,CAAA,CAAM;AACrD,QAAMC,OAAAA,gBAAcJ,UAAgBK,MAAAA,QAAAA,IAAiB,CAAA,EAAM,KAAE,MAAA,KAAA,EAAA,CAAA;AAE7D,QAAMC,WAAAA,gBAEFC,cAAAA,MAAAA,CAAAA,CACC;sBAESC,gBAAiBC,iBAAiBD,MAAOE,CAAAA,CAAAA;uBAC/CC,QAAUH,MAAS,qBAAoBP,CAAI,OAAA,YAAA,MAAA;AAC3C,UAAA,SAAOO,QAAAA,KAAAA,CAAAA,YAAAA,QAAAA,KAAAA,OAAAA,EAAAA;AACR,cACL,QAAA,qBAAA,EAAA,IAAA,EAAA,YAAA,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,QAAA,GAAA,CAAA,UAAA,2BAAA,EAAA,CAAA;AAACD,WAAAA;EAAkBK,CAAAA,IAAAA;IAAQ;IAG7B;EACA,CAAA;AACA,QAAMC,WAAWC,OAAgB,KAAA;AACjC,QAAM,CAACC,OAAOC,QAAAA,IAAYC,SAAkB,KAAA;AAC5C,QAAM,WAACC,OAAiBC,IAAAA;QACtBC,CAAAA,OAAAA,QAAW,IAAA,SAAA,IAAA;QACXC,CAAAA,iBAAO,kBAAA,IAAA,SAAA;IACPC,WAAU;IACZ,OAAA;IACA,UAAA;EACA,CAAA;QAGGC,SAAAA,QAAAA,MAAAA,KAAAA,MAAAA,aAAAA,QAAAA,WAAAA,KAAAA,IAAAA,GAAAA,CAAAA,CAAAA;QAAUC,UAAAA,QAAAA,MAAAA,WAAAA,CAAAA,IAAAA,gBAAAA,OAAAA,SAAAA,IAAAA,SAAAA,UAAAA;IAAcC;IAAQvB;IAAS;IAE5C;EACA,CAAA;QACE,oBAAYwB,CAAAA,CAAAA;kBAAsCpB,QAAAA,MAAAA;UAAcM,MAAAA,iBAAAA,uBAAAA,KAAAA;MAASb;MAAM4B;MAASC;MAAyB;MAC7G,UAAA;;AAAsE,QAAA,0CAAA;MAC1E,UAAOC,CAAAA,CAAAA;IACN,GAAA,EAAA,YAAA,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,OAAA,CAAA;AAACH,WAAAA;;IAA6Bd;IAASb;IAAM4B;IAASG;IAAe;IAExEC;;YAEI,MAAA;AACF,QAAA,CAAA,cAAA;AACA;;AAEA,WAAA,QAAA,SAAA,UAAA,QAAA,SAAA,CAAA,UAAA;AACC,mBAAA,QAAA,aAAA,KAAA,UAAA,KAAA,CAAA;IAACP,CAAAA;;IAAsB;IAE1BO;;AAEA,YAAG,MAAA;AAACC,kBAAAA,OAAAA;KAAQ;IAEZC;;iBAGUC,YAAaC;QACnBC,wBAAWC,QAAaC,EAAAA,YAAa,YAAA,GAAA,cAAA,GAAA,KAAA,GAAA,OAAA,CAAA;YACrCC,aAAgBP,WAAAA;MAChBQ,WAAQ,qBAAA;MACV,gBAAA;MAEAR,QAAQE;;YAENK,aAAgBP,WAAQS;MACxBD,WAAQ,qBAAA;MACV,gBAAA,QAAA;MAEA,QAAME;;UAEJ,QAAiB,WAAA,aAAcC;oBAIvB,OAAA,iBAAA,QAAA,UAAA;uBACA,OAAA,kBAAA,WAAA,KAAA,EAAA,KAA+D,WAAA,CAAA,EAAA,OAAA,OAAA,QAAA,OAAA,OAAA,MAAA,YAAA,MAAA;YAW7DC,UAAS,0BAAA,QAAA,MAAA,UAAA,eAAA,CAAA,QAAA;AACTC,uBAASC,SAAU;AACnB,mBAAA,IAAA;AACCC,mBAAAA,UAA2B;AAE5B,qBAAA,UAAA,UAAA,KAAA;AAKA,cAAA,OAAA,WAAA,aAAA;AACA,mBAAA,cAAA,IAAA,YAAA,iCAAA,CAAA;UACF;AACA;QACA;sBAYI,UAAU,gBAAA,CAAA,SAAA,SAAA;6BACV,CAAA,aAAA;YACA,GAAA;;;;;;YAMAC,OAAAA,SAAeC;YACjB;YACF,eAAA,iBAAA,MAAA;UACA,EAAA;QACA;YAME,UAAM5B,UAAQW,eAAqBkB,CAAAA,SAAM,SAAA;AACzC/B,gBAAAA,SAAAA,QAAoB2B,UAAa;wBAC5BA,QAAO,WAAA,EAAA;6BACCK,CAAAA,aAAOD;YAClB7B,GAAAA;YACAC,WAAUD,OAAQ;YACpB;YACF,UAAA,QAAA,IAAA,OAAA,SAAA,QAAA;UACA,EAAA;QACA;qBAOI,CAAA,UAAU,UAAA,gBAAA,CAAA,SAAA,SAAA;6BACV+B,CAAAA,aAAAA;YACAZ,GAAAA;YACAQ;YACF,QAAA;YACF,eAAA,iBAAA,KAAA;UACIK,EAAAA;;YAEFxC,UAASiC,CAAAA,SAAUO,SAAAA;AACrB,mBAAA,MAAA;AAGJC,mBAAOC,UAAO;QAIXD;WACFlD,cAAgB,CAACgD;aACZI,WAAAA;QACRxB,GAAAA,YAAQwB,IAASC,CAAAA,UAAAA,QAAiBC,SAAO,KAAA,CAAA;QAC1C,QAAA,SAAA,0BAAA,iBAAA;QAED,QAAO,SAAaC,0BAAKC,OAAAA;MACxBC,CAAAA;AAEH,aAAA,OAAA,WAAA,QAAgC;IAChC,CAAA,EAAA,KAAMC,eAAuB,cAAA;sBAEhB,WAAA,MAAA;oBACPC,WAAa/B,CAAAA,SAAQgC,SAAc;YACnCC,KAAAA,8BAAgC;UAChCC,aAAAA,QAAclC,eAAQmC;UACxB,eAAA,QAAA,UAAA;UACA,cAAKC,QAAoBC,gBAAgB3B;QACzC1B,GAAAA,EAAAA,YAAasD,YAAO,GAAA,cAAA,GAAA,KAA0BC,GAAAA,OAAAA,CAAAA;AAChD,aAAA,oBAAA,gBAAA,KAAA,CAAA;AACCA,iBAAAA,IAAAA,MAAAA,2BAAAA,OAAAA,IAAAA,CAAAA;MAEH;cACM;WACJC,MAAAA;AACA,UAAA,0BAAyBH,QAAMI,EAAAA,YAAU/B,YAAAA,GAAAA,cAAAA,GAAAA,KAAAA,GAAAA,OAAAA,CAAAA;AACzC,mBAAKgC,SAAAA;WACH,oBAAyB1C,gBAAQ2C,KAAQ,CAAA;AAC3C,UAAA,CAAA,mBAAA;AACF,aAAA,oBAAA,QAAA,SAAA,CAAA;MACC;IAAC3C;KAAQ;IAEZ;EACA4C,CAAAA;AAEA,QAAA,cACE,OAAA,eACE;cAAeC,UAAK;qBAAMC,MAAmBC,sBAAAA,cAAAA,eAAAA;;IACpBC,mBAAOhD;KAC5B,sBAAA,cAACiD,uBAAAA;IAAwBD,OAAOhD;KAAkBkD,sBAAAA,cAAAA,yBAAAA;;IACtBF,SAAOhD;KAC/B,sBAAA,cAACmD,gBAAAA,UAAAA;IACCC,OAAAA,QAAaA;KACNC,sBAAAA,cAAAA,KAAAA;IACPtE;IACAuE;IACAhE;;IAOXyD,UAAAA,YAAAA;EAAU/C,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,GAAAA;IAASoD;IAAaC;IAAOtE;IAAM;IAEhD;EAEF,CAAA;;IAEGgC,gBAAmBwC,CAAQ,YAAQ;AACtC,aAAA,aAAA,CAAA;AAEA,aAAA,SAAA,UAAA;;AAqBE,IAAKC,mBAAO,CAAA,aAAA;QACV,QAAA,SAAA,MAAA,kCAAkC;MAClC,CAAA,OAAMC;AAER,UAAA,QAAA,SAAA,MAAA,GAAA;AACA,WAASC,MAAAA,MAAYC,SAAW,CAAA;EAChC;AAIA,QAAA,CAAA,EAAA,YAAA,UAAA,IAAA;AACA,QAAA,cAAA,WAAA,MAAA,GAAA,EAAA,IAAA,CAAA,SAAA,KAAA,OAA6D,CAAA,EAAA,YAAA,IAAA,KAAA,MAAA,CAAA,CAAA,EAAA,KAAA,GAAA;AAS7D,QAAA,cAAA,WAAA,QAAA,sBAAA,OAAA,EAAA,QAAyE,yBAAA,OAAA,EAAA,YAAA;AAIzE,MAAA,gBAAA,YAAA;AACA,WAAUC;EACZ;AAEA,SAAA,GAAA,WAAA,KAAA,WAAA;;AAME,IAAM3F,mBAAmB,CAAC,aAAO;AAEjC,QAAMuF,KAAAA,SAAWA,MAAM,GAAA,EAAA,CAAA;AAEvB,QAAA,QACGK,GAAK,MACLC,gBAAcC;AAEnB,QAAA,OAAA,QAAA,MAAA,CAAA,IAAA,GAAA,MAAA,GAAA,EAAA,IAAA,KAAA;;;;;ACxZA,SAAoBC,oBAAoB;AACxC,SAASC,eAAAA,oBAAmB;AAE5B,SAASC,aAAAA,kBAAiB;AAM1B,IAAAC,gBAAA;AAMSC,IAAAA,kBAAqBC,CAAAA,iBAAkBC;AAC9C,QAAA,UAAA,iBAAA;AAEF,SAAA,aAAA,QAAA,aAAA,KAAA,YAAA,CAAA;;AAOEC,IAAUF,gBAAmB,CAAA,iBAAO;AACpC,QAAA,eAAoB,gBAAE,YAAA;AACtB,EAAAE,WAAA,aAAA,SAAA,GAAA,2BAAA,aAAA,UAAA,IAAA,EAAA,YAAA,YAAA,GAAAJ,eAAA,GAAA,IAAA,GAAA,QAAA,GAAA,CAAA,2BAAA,sDAAA,EAAA,CAAA;AAEF,SAAA,aAAA,CAAA;;AAOSC,IAAAA,oBAAaI,CAAAA,mBAAAA;AACpB,QAAA,OAAA,cAAA,cAAA;AAEF,SAAA,aAAA,IAAA;;AASQA,IAAOC,yBAAcC,CAAAA,mBAAAA;AAC3B,QAAMC,WAAQP,cAAaI,qBAAAA,YAAAA;AAC3B,QAAMI,OAAAA,cACJ,cAACC;QACCC,QAASC,aAAaD,IAAAA;AACxB,QACA,SAAAE,aAAA,CAAA,OAAA;AAACF,aAAAA,IAAAA,MAAAA,GAAAA,SAAAA,IAAAA,IAAAA,CAAAA,CAAAA;;IAAe;IAElB;;SAAeF;IAAO;IACtB;EAEF;;;;;AC3DA,SAASK,aAAAA,YAAWC,UAAAA,SAAQC,YAAAA,iBAAgB;AAErC,IAAKC,eAAAA,0BAAAA,eAAAA;;;;;SAAAA;;AAiBL,IAAMC,aAAa,CAACC,OAAgBC,WAAW,MAAC;AACrD,QAAM,CAACC,OAAOC,QAAAA,IAAYN,UAAAA,CAAAA;AAM1B,QAAMO,WAAWR,QAAOI,KAAAA;AACxBI,WAASC,UAAUL;AAEnBL,EAAAA,WAAU,MAAA;AACR,QAAI,CAACM,UAAU;AACb;IACF;AAEA,UAAMK,IAAIC,YAAY,MAAA;AACpBJ,eAAS,CAACD,WAAAA;AACR,cAAMM,UAAUJ,SAASC;AACzB,gBAAQH,QAAAA;UACN,KAAA,GAA2B;AACzB,gBAAI,CAACM,SAAS;AACZ,qBAAA;YACF;AACAC,0BAAcH,CAAAA;AACd,mBAAA;UACF;UAEA,KAAA,GAA0B;AACxB,gBAAIE,SAAS;AACX,qBAAA;YACF;AACA;UACF;UAEA,KAAA,GAA2B;AACzBC,0BAAcH,CAAAA;AACd,mBAAA;UACF;QACF;AAEA,eAAOJ;MACT,CAAA;IACF,GAAGD,QAAAA;AAEH,WAAO,MAAMQ,cAAcH,CAAAA;EAC7B,GAAG;IAACL;GAAS;AAEb,MAAI,CAACA,UAAU;AACb,WAAOD,QAAAA,IAAAA;EACT;AAEA,SAAOE;AACT;;;ACvEA,SAAoBQ,mBAAAA,kBAAiBC,gBAAAA,qBAAoB;AACzD,SAASC,eAAAA,cAAaC,kBAAkB;AAMjC,IAAMC,mBAAmB,CAC9BC,SAAAA;AAEA,QAAMC,WAAWH,WAAWH,gBAAAA;AAC5B,QAAMO,WAAWN,cAAaI,IAAAA;AAE9B,QAAMG,iBAAiBN,aACrB,CAACO,OAAAA;AACCH,aAASI,IAAIL,MAAMI,GAAGH,SAASK,IAAIN,IAAAA,CAAAA,CAAAA;EACrC,GACA;IAACC;IAAUD;GAAK;AAGlB,SAAO;IAAEE;IAAUC;EAAe;AACpC;;;AJTA,IAAMI,yBAAyB;AAExB,IAAMC,MAAM,CAAC,EAAEC,aAAaC,cAAaC,OAAOC,OAAOC,UAAUC,SAAQ,MAAY;AAC1F,QAAMC,gBAAgBC,gBAAgBC,qBAAaC,YAAY;AAC/D,QAAMC,aAAaH,gBAAgBC,qBAAaG,SAAS;AACzD,QAAMC,QAAQC,WAAWX,OAAOE,QAAAA;AAChC,QAAMU,uBAAuBF,SAASG,aAAaC;AAYnDC,EAAAA,WAAU,MAAA;AACR,QAAI,CAACH,sBAAsB;AACzB;IACF;AACA,QAAII,YAAYC,iBAAiBrB,sBAAAA,EAAwBsB,WAAW,GAAG;AACrEF,kBAAYG,KAAKvB,sBAAAA;IACnB;AACCwB,WAAuDC,cAAcC,UAAAA;EACxE,GAAG;IAACV;GAAqB;AAEzB,MAAIX,OAAO;AAET,UAAMA;EACR;AAGA,MAAI,CAACW,sBAAsB;AACzB,QAAI,CAACb,cAAa;AAChB,aAAO;IACT;AAEA,WAAO,gBAAAwB,OAAA,cAACxB,cAAAA;MAAYW;MAAcP;;EACpC;AAEA,QAAMqB,kBAAkBC,gBAAgBrB,aAAAA;AACxC,SACE,gBAAAmB,OAAA,cAACC,iBAAAA,MACEhB,WAAWkB,IAAI,CAAC,EAAEC,IAAIC,MAAMC,UAAS,MACpC,gBAAAN,OAAA,cAACM,WAAAA;IAAUC,KAAKH;;AAIxB;AAEA,IAAMF,kBAAkB,CAACM,aAAAA;AACvB,MAAIA,SAASb,WAAW,GAAG;AACzB,WAAO,CAAC,EAAEc,SAAQ,MAA0B,gBAAAT,OAAA,cAAAA,OAAA,UAAA,MAAGS,QAAAA;EACjD;AAEA,SAAOC,gBAAgBF,QAAAA,EACpBL,IAAI,CAAC,EAAEQ,QAAO,MAAOA,OAAAA,EACrBC,OAAO,CAACC,KAAKC,SAAS,CAAC,EAAEL,SAAQ,MAChC,gBAAAT,OAAA,cAACa,KAAAA,MACC,gBAAAb,OAAA,cAACc,MAAAA,MAAML,QAAAA,CAAAA,CAAAA;AAGf;;;AK5EA,OAAOM,UAAyBC,aAAAA,YAAWC,iBAAiBC,UAAAA,eAAc;AAE1E,SAASC,qBAAqB;AAC9B,SAASC,WAAWC,UAAU;AA6DvB,IAAMC,cAAc,CAAC,EAAEC,QAAQ,GAAGC,UAAUC,KAAI,MAA6B;AAElF,MAAIC,SAASC,WAAW,UAAU;AAChC,UAAM,IAAIC,MAAM,YAAA;EAClB;AAWAZ,EAAAA,WAAU,MAAA;AACR,QAAIO,SAAS,GAAG;AACd;IACF;AACA,UAAMM,WAAWL,UAAUA,YAAY;AACvCM,WAAOC,cAAcP,SAAS,MAAMK,WAAW,GAAA;AAC/C,QAAIL,UAAUQ,eAAe;AAC3BF,aAAOC,cAAcE,OAAO;QAC1BC,OAAOV,SAASU;QAChBC,QAAQX,SAASW;QACjBC,WAAW,cAAcZ,SAASQ,aAAa;MACjD,CAAA;IACF;EACF,GAAG;IAACT;IAAOC,UAAUA;IAAUA,UAAUU;IAAOV,UAAUW;IAAQX,UAAUQ;GAAc;AAO1Ff,kBAAgB,MAAA;AACd,QAAIM,SAAS,GAAG;AACdO,aAAOC,cAAcM,QAAAA;IACvB;EACF,GAAG;IAACd;GAAM;AAUV,QAAMe,WAAWpB,QAAOK,KAAAA;AACxBe,WAASC,UAAUhB;AACnBP,EAAAA,WAAU,MAAA;AACR,WAAO,MAAA;AACL,UAAIsB,SAASC,WAAW,GAAc;AACpCT,eAAOC,cAAcM,QAAAA;MACvB;IACF;EACF,GAAG,CAAA,CAAE;AAML,MAAId,QAAQ,GAAG;AACb,WAAO;EACT;AAEA,QAAMiB,gBAAgBnB,GACpB,oGACAE,SAAS,KAAK,oCACdA,SAAS,KAAK,oBAAA;AAGhB,SACE,gBAAAR,OAAA,cAACI,eAAAA;IAAcsB,IAAIrB;KACjB,gBAAAL,OAAA,cAAC2B,OAAAA;IAAIC,MAAK;IAAOC,WAAU;KACzB,gBAAA7B,OAAA,cAAC2B,OAAAA;IAAIC,MAAK;IAAOC,WAAU;KACxB,OAAOnB,SAAS,aACfA,KAAK;IAAEmB,WAAWJ;EAAc,CAAA,IAC9Bf,OACF,gBAAAV,OAAA,cAAC2B,OAAAA;IAAIE,WAAWJ;KAAgBf,IAAAA,IAC9B,IAAA,CAAA,CAAA;AAKd;",
+  "names": ["React", "useEffect", "RegistryContext", "Effect", "Fiber", "PubSub", "Queue", "React", "useCallback", "useEffect", "useMemo", "useRef", "useState", "runAndForwardErrors", "invariant", "log", "ErrorBoundary", "ErrorFallback", "useAsyncEffect", "useDefaultValue", "ContextProtocolProvider", "ENABLED_KEY", "core", "useDefaultValue", "id", "defaults", "defaultsProp", "setupEvents", "setupEventsProp", "pluginLoader", "pluginLoaderProp", "plugin", "find", "meta", "invariant", "plugins", "errorRef", "useRef", "error", "setError", "useState", "startupProgress", "setStartupProgress", "activated", "total", "progress", "safeMode", "cacheEnabled", "cached", "pluginManager", "enabled", "onRemove", "mgr", "onPluginRemove", "useEffect", "manager", "useAsyncEffect", "capabilities", "contribute", "interface", "Capabilities", "PluginManager", "implementation", "module", "registry", "fiber", "forkDaemon", "setReady", "readyRef", "current", "globalThis", "humanizedName", "humanizeModuleId", "length", "active", "event", "error$", "Effect", "forever", "activate", "ActivationEvents", "Startup", "join", "listener", "pipe", "timeoutId", "eventsFired", "getEventsFired", "activeModules", "pendingReset", "getPendingReset", "runAndForwardErrors", "Fiber", "Error", "timeout", "clearTimeout", "interrupt", "isExternalManager", "shutdown", "progressRef", "name", "FallbackComponent", "fallback", "value", "ContextProtocolProvider", "PluginManagerContext", "App", "placeholder", "ready", "debounce", "composer", "match", "parts", "pluginSlug", "moduleName", "pluginLabel", "split", "map", "word", "useAtomValue", "useCallback", "invariant", "__dxlog_file", "useAtomValue", "capabilities", "interfaceDef", "invariant", "atom", "useCapability", "atomCapability", "value", "update", "fn", "registry", "set", "useCallback", "useEffect", "useRef", "useState", "LoadingState", "useLoading", "ready", "debounce", "stage", "setStage", "readyRef", "current", "i", "setInterval", "isReady", "clearInterval", "RegistryContext", "useAtomValue", "useCallback", "useContext", "useSettingsState", "atom", "registry", "settings", "updateSettings", "fn", "set", "get", "FIRST_INTERACTIVE_MARK", "App", "placeholder", "Placeholder", "ready", "error", "debounce", "progress", "reactContexts", "useCapabilities", "Capabilities", "ReactContext", "reactRoots", "ReactRoot", "stage", "useLoading", "placeholderDismissed", "LoadingState", "Done", "useEffect", "performance", "getEntriesByName", "length", "mark", "window", "__bootLoader", "dismiss", "React", "ComposedContext", "composeContexts", "map", "id", "root", "Component", "key", "contexts", "children", "topologicalSort", "context", "reduce", "Acc", "Next", "React", "useEffect", "useLayoutEffect", "useRef", "ThemeProvider", "defaultTx", "mx", "Placeholder", "stage", "progress", "logo", "location", "search", "Error", "fraction", "window", "__bootLoader", "humanizedName", "status", "event", "module", "humanized", "dismiss", "stageRef", "current", "logoClassName", "tx", "div", "role", "className"]
+}

package/dist/lib/browser/{chunk-QSXYHXCE.mjs → chunk-66IXTIVK.mjs}

@@ -45,4 +45,4 @@ export {
   getEvents,
   activation_event_exports
 };
-//# sourceMappingURL=chunk-QSXYHXCE.mjs.map
+//# sourceMappingURL=chunk-66IXTIVK.mjs.map

package/dist/lib/browser/{chunk-QSXYHXCE.mjs.map → chunk-66IXTIVK.mjs.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../src/core/activation-event.ts"],
   "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { compositeKey } from '@dxos/util';\n\n/**\n * A unique string identifier representing an event.\n * This is expected to be a URI, where initial parts are often the id of the plugin whose package defines the event.\n *\n * @example org.dxos.plugin.example.event.ready\n */\nexport type ActivationEvent = {\n  id: string;\n  specifier?: string;\n};\n\n/**\n * An activation event that can be a single event, or a combination of events.\n */\nexport type Events =\n  | ActivationEvent\n  | { type: 'one-of'; events: ActivationEvent[] }\n  | { type: 'all-of'; events: ActivationEvent[] };\n\n/**\n * Helper to define an activation event.\n */\nexport const make = (id: string, specifier?: string) => {\n  return { id, specifier } as ActivationEvent;\n};\n\n/**\n * Helper to create an activation event key.\n */\nexport const eventKey = (event: ActivationEvent) =>\n  event.specifier ? compositeKey(event.id, event.specifier) : event.id;\n\n/**\n * Helper to create an activation event that triggers when any of the given events are activated.\n */\nexport const oneOf = (...events: ActivationEvent[]) => ({ type: 'one-of' as const, events });\n\n/**\n * Helper to create an activation event that triggers when all of the given events are activated.\n */\nexport const allOf = (...events: ActivationEvent[]) => ({ type: 'all-of' as const, events });\n\n/**\n * Helper to check if an activation event is a one-of event.\n */\nexport const isOneOf = (events: Events): events is { type: 'one-of'; events: ActivationEvent[] } =>\n  'type' in events && events.type === 'one-of';\n\n/**\n * Helper to check if an activation event is an all-of event.\n */\nexport const isAllOf = (events: Events): events is { type: 'all-of'; events: ActivationEvent[] } =>\n  'type' in events && events.type === 'all-of';\n\n/**\n * Helper to get the events from an activation event.\n */\nexport const getEvents = (events: Events) => ('type' in events ? events.events : [events]);\n"],
-  "mappings": ";;;;;AAAA;;;;;;;;;;AAIA,SAASA,oBAAoB;AAwBtB,IAAMC,OAAO,CAACC,IAAYC,cAAAA;AAC/B,SAAO;IAAED;IAAIC;EAAU;AACzB;AAKO,IAAMC,WAAW,CAACC,UACvBA,MAAMF,YAAYG,aAAaD,MAAMH,IAAIG,MAAMF,SAAS,IAAIE,MAAMH;AAK7D,IAAMK,QAAQ,IAAIC,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAME,QAAQ,IAAIF,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAMG,UAAU,CAACH,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMG,UAAU,CAACJ,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMI,YAAY,CAACL,WAAoB,UAAUA,SAASA,OAAOA,SAAS;EAACA;;",
-  "names": ["compositeKey", "make", "id", "specifier", "eventKey", "event", "compositeKey", "oneOf", "events", "type", "allOf", "isOneOf", "isAllOf", "getEvents"]
+  "mappings": ";;;;;AAAA;;;;;;;;;;AAIA,SAASA,oBAAoB;AAwBtB,IAAMC,OAAO,CAACC,IAAYC,cAAAA;AAC/B,SAAO;IAAED;IAAIC;EAAU;AACzB;AAKO,IAAMC,WAAW,CAACC,UACvBA,MAAMF,YAAYH,aAAaK,MAAMH,IAAIG,MAAMF,SAAS,IAAIE,MAAMH;AAK7D,IAAMI,QAAQ,IAAIC,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAME,QAAQ,IAAIF,YAA+B;EAAEC,MAAM;EAAmBD;AAAO;AAKnF,IAAMG,UAAU,CAACH,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMG,UAAU,CAACJ,WACtB,UAAUA,UAAUA,OAAOC,SAAS;AAK/B,IAAMI,YAAY,CAACL,WAAoB,UAAUA,SAASA,OAAOA,SAAS;EAACA;;",
+  "names": ["compositeKey", "make", "id", "specifier", "eventKey", "event", "oneOf", "events", "type", "allOf", "isOneOf", "isAllOf", "getEvents"]
 }

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

@@ -5,4 +5,4 @@ var PluginManagerContext = createContext("org.dxos.app-framework.plugin-manager"
 export {
   PluginManagerContext
 };
-//# sourceMappingURL=chunk-TGX63LTL.mjs.map
+//# sourceMappingURL=chunk-FJ4765WW.mjs.map

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

@@ -2,6 +2,6 @@
   "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>('org.dxos.app-framework.plugin-manager');\n"],
-  "mappings": ";AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBC,cAA2C,uCAAA;",
-  "names": ["createContext", "PluginManagerContext", "createContext"]
+  "mappings": ";AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBD,cAA2C,uCAAA;",
+  "names": ["createContext", "PluginManagerContext"]
 }

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

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

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

@@ -0,0 +1,372 @@
+import {
+  isPlugin
+} from "./chunk-Z55LVAGN.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  RemotePluginLoadError: () => RemotePluginLoadError,
+  getRemoteEntries: () => getRemoteEntries,
+  isLocalUrl: () => isLocalUrl,
+  make: () => make,
+  preload: () => preload,
+  uninstall: () => uninstall
+});
+import * as Effect3 from "effect/Effect";
+import * as Option from "effect/Option";
+import { BaseError as BaseError3 } from "@dxos/errors";
+import { log } from "@dxos/log";
+
+// src/core/plugin-asset-cache.ts
+var plugin_asset_cache_exports = {};
+__export(plugin_asset_cache_exports, {
+  PluginAssetCacheError: () => PluginAssetCacheError,
+  noop: () => noop
+});
+import * as Effect from "effect/Effect";
+import { BaseError } from "@dxos/errors";
+var PluginAssetCacheError = class extends BaseError.extend("PluginAssetCacheError", "Plugin asset cache operation failed") {
+};
+var noop = () => ({
+  cache: () => Effect.void,
+  evict: () => Effect.void,
+  resolve: (_pluginId, url) => Effect.succeed(url),
+  list: () => Effect.succeed([])
+});
+
+// src/core/plugin-manifest.ts
+var plugin_manifest_exports = {};
+__export(plugin_manifest_exports, {
+  Manifest: () => Manifest,
+  PluginManifestError: () => PluginManifestError,
+  fetchManifest: () => fetchManifest,
+  parse: () => parse
+});
+import * as FetchHttpClient from "@effect/platform/FetchHttpClient";
+import * as HttpClient from "@effect/platform/HttpClient";
+import * as HttpClientRequest from "@effect/platform/HttpClientRequest";
+import * as HttpClientResponse from "@effect/platform/HttpClientResponse";
+import * as Effect2 from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { BaseError as BaseError2 } from "@dxos/errors";
+import { PLUGIN_ENTRY_FILENAME } from "@dxos/protocols";
+var PluginManifestError = class extends BaseError2.extend("PluginManifestError", "Plugin manifest is invalid") {
+};
+var Manifest = Schema.Struct({
+  id: Schema.String,
+  name: Schema.String,
+  version: Schema.String,
+  assets: Schema.Array(Schema.String)
+});
+var resolve = (manifestUrl, manifest) => ({
+  id: manifest.id,
+  name: manifest.name,
+  version: manifest.version,
+  entryUrl: new URL(PLUGIN_ENTRY_FILENAME, manifestUrl).toString(),
+  assetUrls: manifest.assets.map((asset) => new URL(asset, manifestUrl).toString())
+});
+var parse = (manifestUrl, payload) => {
+  const manifest = Schema.decodeUnknownSync(Manifest)(payload);
+  if (!manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    throw new Error(`Manifest at ${manifestUrl} does not list ${PLUGIN_ENTRY_FILENAME} in assets.`);
+  }
+  return resolve(manifestUrl, manifest);
+};
+var fetchManifest = (manifestUrl) => Effect2.gen(function* () {
+  const response = yield* HttpClientRequest.get(manifestUrl).pipe(HttpClient.execute, Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "fetch-failed"
+    },
+    cause
+  })));
+  if (response.status >= 400) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "http-error",
+        status: response.status
+      }
+    }));
+  }
+  const manifest = yield* HttpClientResponse.schemaBodyJson(Manifest)(response).pipe(Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "parse-failed"
+    },
+    cause
+  })));
+  if (!manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "invalid"
+      },
+      cause: `assets does not include ${PLUGIN_ENTRY_FILENAME}`
+    }));
+  }
+  return resolve(manifestUrl, manifest);
+}).pipe(Effect2.scoped, Effect2.provide(FetchHttpClient.layer));
+
+// src/core/url-loader.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+var RemotePluginLoadError = class extends BaseError3.extend("RemotePluginLoadError", "Failed to load remote plugin") {
+};
+var defaultStorage = () => ({
+  get: (key) => localStorage.getItem(key),
+  set: (key, value) => localStorage.setItem(key, value)
+});
+var getPersistedRemotePlugins = (storage, key) => {
+  try {
+    const parsed = JSON.parse(storage.get(key) ?? "[]");
+    if (!Array.isArray(parsed)) {
+      return [];
+    }
+    return parsed.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.id === "string" && typeof entry.url === "string");
+  } catch {
+    return [];
+  }
+};
+var persistRemotePlugin = (storage, key, entry) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);
+    entries.push(entry);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to persist remote plugin entry", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 40, S: void 0 });
+  }
+};
+var removePersistedRemotePlugin = (storage, key, pluginId) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== pluginId);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to remove remote plugin entry", {
+      pluginId,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 51, S: void 0 });
+  }
+};
+var isUrl = (locator) => {
+  try {
+    const url = new URL(locator);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+var isLocalUrl = (locator) => {
+  try {
+    const hostname = new URL(locator).hostname.toLowerCase();
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+  } catch {
+    return false;
+  }
+};
+var getRemoteEntries = (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key);
+};
+var normalizePluginExport = (mod) => {
+  const exported = mod.default;
+  if (isPlugin(exported)) {
+    return exported;
+  }
+  if (typeof exported === "function") {
+    const result = exported();
+    if (isPlugin(result)) {
+      return result;
+    }
+  }
+  throw new Error("Remote module default export is not a Plugin or a zero-arg plugin factory.");
+};
+var loadStylesheets = (manifest, cache) => Effect3.gen(function* () {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const cssUrls = manifest.assetUrls.filter((url) => url.endsWith(".css"));
+  for (const url of cssUrls) {
+    const resolved = yield* cache.resolve(manifest.id, url);
+    if (document.querySelector(`link[data-dxos-plugin-id="${manifest.id}"][href="${resolved}"]`)) {
+      continue;
+    }
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = resolved;
+    link.dataset.dxosPluginId = manifest.id;
+    document.head.appendChild(link);
+  }
+});
+var loadFromManifest = (manifestUrl, cache) => Effect3.gen(function* () {
+  log.info("loading remote plugin", {
+    manifestUrl
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 119, S: this });
+  const manifest = yield* fetchManifest(manifestUrl).pipe(Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "manifest-error"
+    },
+    cause
+  })));
+  const cachedUrls = manifest.assetUrls.indexOf(manifestUrl) === -1 ? [
+    manifestUrl,
+    ...manifest.assetUrls
+  ] : manifest.assetUrls;
+  const wrapCacheError = Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "cache-error"
+    },
+    cause
+  }));
+  yield* cache.cache(manifest.id, cachedUrls).pipe(wrapCacheError);
+  const entryUrl = yield* cache.resolve(manifest.id, manifest.entryUrl).pipe(wrapCacheError);
+  const mod = yield* Effect3.tryPromise({
+    try: () => import(
+      /* @vite-ignore */
+      entryUrl
+    ),
+    catch: (cause) => new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "import-failed"
+      },
+      cause
+    })
+  });
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-missing"
+      }
+    }));
+  }
+  if (plugin.meta.id !== manifest.id) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-mismatch",
+        metaId: plugin.meta.id,
+        manifestId: manifest.id
+      }
+    }));
+  }
+  yield* loadStylesheets(manifest, cache).pipe(wrapCacheError);
+  return {
+    plugin,
+    manifest
+  };
+});
+var preload = (options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  const onPluginLoaded = options.onPluginLoaded;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 197, S: this });
+  const total = entries.length;
+  let loaded = 0;
+  const results = yield* Effect3.all(entries.map((entry) => loadFromManifest(entry.url, cache).pipe(
+    Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to preload remote plugin", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 202, S: this }))),
+    Effect3.option,
+    // Tick the progress hook on both success and recoverable failure so
+    // the counter monotonically reaches `total`. The host-supplied
+    // callback is best-effort: any synchronous throw flows through
+    // `Effect.try` and gets logged + ignored so a buggy hook can't
+    // derail the preload.
+    Effect3.tap(() => Effect3.sync(() => {
+      loaded += 1;
+    }).pipe(Effect3.andThen(Effect3.try(() => onPluginLoaded?.(loaded, total))), Effect3.tapError((error) => Effect3.sync(() => log.warn("onPluginLoaded threw", {
+      loaded,
+      total,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 212, S: this }))), Effect3.ignore))
+  )), {
+    concurrency: "unbounded"
+  });
+  return results.flatMap((result) => Option.match(result, {
+    onNone: () => [],
+    onSome: ({ plugin }) => [
+      plugin
+    ]
+  }));
+});
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  return (locator) => Effect3.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return builtin;
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect3.fail(new RemotePluginLoadError({
+        context: {
+          locator,
+          reason: "invalid-locator"
+        }
+      }));
+    }
+    const { plugin } = yield* loadFromManifest(locator, cache);
+    const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+    if (duplicate) {
+      return yield* Effect3.fail(new RemotePluginLoadError({
+        context: {
+          locator,
+          reason: "duplicate-id",
+          id: plugin.meta.id
+        }
+      }));
+    }
+    persistRemotePlugin(storage, key, {
+      id: plugin.meta.id,
+      url: locator
+    });
+    return plugin;
+  });
+};
+var uninstall = (pluginId, options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  removePersistedRemotePlugin(storage, key, pluginId);
+  if (typeof document !== "undefined") {
+    document.querySelectorAll(`link[data-dxos-plugin-id="${pluginId}"]`).forEach((node) => node.remove());
+  }
+  yield* cache.evict(pluginId).pipe(Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to evict plugin assets", {
+    pluginId,
+    error
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 282, S: this }))), Effect3.ignore);
+});
+
+export {
+  plugin_asset_cache_exports,
+  plugin_manifest_exports,
+  RemotePluginLoadError,
+  isLocalUrl,
+  getRemoteEntries,
+  preload,
+  make,
+  uninstall,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-JXCBZSBJ.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/url-loader.ts", "../../../src/core/plugin-asset-cache.ts", "../../../src/core/plugin-manifest.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { BaseError } from '@dxos/errors';\nimport { log } from '@dxos/log';\n\nimport * as Plugin from './plugin';\nimport * as PluginAssetCache from './plugin-asset-cache';\nimport * as PluginManifest from './plugin-manifest';\n\nconst DEFAULT_KEY = 'org.dxos.composer.remote-plugins';\n\n/**\n * Tagged error for any failure during remote plugin loading. Construction sites\n * set `context.locator` and `context.reason` (one of `'invalid-locator' |\n * 'manifest-error' | 'cache-error' | 'import-failed' | 'meta-missing' |\n * 'meta-mismatch' | 'duplicate-id'`) so handlers can route on the failure mode.\n */\nexport class RemotePluginLoadError extends BaseError.extend('RemotePluginLoadError', 'Failed to load remote plugin') {}\n\n/**\n * Abstraction over key-value storage (defaults to localStorage).\n */\nexport type Storage = {\n  get(key: string): string | null;\n  set(key: string, value: string): void;\n};\n\n/**\n * Options for configuring the URL loader.\n */\nexport type Options = {\n  storage?: Storage;\n  key?: string;\n  /**\n   * Per-platform offline asset cache. Defaults to a no-op cache (no offline support).\n   */\n  cache?: PluginAssetCache.Cache;\n};\n\n/**\n * Options for the preload entry point. Adds an optional progress hook so hosts\n * can drive a boot-loader counter (`Loading plugins (3/12)…`) as remote plugin\n * manifests resolve. Resolution order is *not* deterministic — each entry races\n * its own network fetch — so callers should treat `loaded` as a count, not an\n * index. Failures are still swallowed; `loaded` advances on both success and\n * recoverable failure so the counter always reaches `total`.\n */\nexport type PreloadOptions = Options & {\n  onPluginLoaded?: (loaded: number, total: number) => void;\n};\n\n/**\n * Persisted record of a remote plugin that has been loaded previously.\n *\n * `url` is the URL of the plugin manifest (`plugin.json`), not the entry module.\n */\nexport type RemotePluginEntry = {\n  id: string;\n  url: string;\n};\n\nconst defaultStorage = (): Storage => ({\n  get: (key) => localStorage.getItem(key),\n  set: (key, value) => localStorage.setItem(key, value),\n});\n\nconst getPersistedRemotePlugins = (storage: Storage, key: string): RemotePluginEntry[] => {\n  try {\n    const parsed: unknown = JSON.parse(storage.get(key) ?? '[]');\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter(\n      (entry): entry is RemotePluginEntry =>\n        typeof entry === 'object' && entry !== null && typeof entry.id === 'string' && typeof entry.url === 'string',\n    );\n  } catch {\n    return [];\n  }\n};\n\nconst persistRemotePlugin = (storage: Storage, key: string, entry: RemotePluginEntry): void => {\n  try {\n    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);\n    entries.push(entry);\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to persist remote plugin entry', { entry, error });\n  }\n};\n\nconst removePersistedRemotePlugin = (storage: Storage, key: string, pluginId: string): void => {\n  try {\n    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== pluginId);\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to remove remote plugin entry', { pluginId, error });\n  }\n};\n\nconst isUrl = (locator: string): boolean => {\n  try {\n    const url = new URL(locator);\n    return url.protocol === 'http:' || url.protocol === 'https:';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns true when the URL's hostname is the local host (localhost, 127.0.0.1, or ::1).\n */\nexport const isLocalUrl = (locator: string): boolean => {\n  try {\n    const hostname = new URL(locator).hostname.toLowerCase();\n    // WHATWG URL returns '::1' without brackets in Node; some browsers return '[::1]'.\n    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1' || hostname === '[::1]';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns the list of remote plugin entries previously persisted by {@link make}.\n * Useful for UI code that needs to know which loaded plugins were installed from a URL\n * (e.g. to surface a tag on remote or localhost-hosted plugins).\n */\nexport const getRemoteEntries = (options: Options = {}): readonly RemotePluginEntry[] => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  return getPersistedRemotePlugins(storage, key);\n};\n\nconst normalizePluginExport = (mod: Record<string, unknown>): Plugin.Plugin => {\n  const exported = mod.default;\n  if (Plugin.isPlugin(exported)) {\n    return exported;\n  }\n  if (typeof exported === 'function') {\n    const result = (exported as () => unknown)();\n    if (Plugin.isPlugin(result)) {\n      return result;\n    }\n  }\n  throw new Error('Remote module default export is not a Plugin or a zero-arg plugin factory.');\n};\n\n/**\n * Loads stylesheets declared in the manifest by appending `<link rel=\"stylesheet\">` elements to the host document.\n * Each link is tagged with `data-dxos-plugin-id` so `uninstall` can clean them up.\n */\nconst loadStylesheets = (\n  manifest: PluginManifest.ResolvedManifest,\n  cache: PluginAssetCache.Cache,\n): Effect.Effect<void, PluginAssetCache.PluginAssetCacheError> =>\n  Effect.gen(function* () {\n    if (typeof document === 'undefined') {\n      return;\n    }\n    const cssUrls = manifest.assetUrls.filter((url) => url.endsWith('.css'));\n    for (const url of cssUrls) {\n      const resolved = yield* cache.resolve(manifest.id, url);\n      if (document.querySelector(`link[data-dxos-plugin-id=\"${manifest.id}\"][href=\"${resolved}\"]`)) {\n        continue;\n      }\n      const link = document.createElement('link');\n      link.rel = 'stylesheet';\n      link.href = resolved;\n      link.dataset.dxosPluginId = manifest.id;\n      document.head.appendChild(link);\n    }\n  });\n\nconst loadFromManifest = (\n  manifestUrl: string,\n  cache: PluginAssetCache.Cache,\n): Effect.Effect<{ plugin: Plugin.Plugin; manifest: PluginManifest.ResolvedManifest }, RemotePluginLoadError> =>\n  Effect.gen(function* () {\n    log.info('loading remote plugin', { manifestUrl });\n    const manifest = yield* PluginManifest.fetchManifest(manifestUrl).pipe(\n      Effect.mapError(\n        (cause) => new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'manifest-error' }, cause }),\n      ),\n    );\n    // Cache the manifest URL alongside its declared assets. Without it, `preload` on a\n    // subsequent reload would fetch the manifest from the network — and fail when the\n    // plugin's host is offline, dropping the plugin from the runtime.\n    const cachedUrls =\n      manifest.assetUrls.indexOf(manifestUrl) === -1 ? [manifestUrl, ...manifest.assetUrls] : manifest.assetUrls;\n    const wrapCacheError = Effect.mapError(\n      (cause: PluginAssetCache.PluginAssetCacheError) =>\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'cache-error' }, cause }),\n    );\n    yield* cache.cache(manifest.id, cachedUrls).pipe(wrapCacheError);\n    const entryUrl = yield* cache.resolve(manifest.id, manifest.entryUrl).pipe(wrapCacheError);\n    const mod = yield* Effect.tryPromise({\n      try: () => import(/* @vite-ignore */ entryUrl),\n      catch: (cause) =>\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'import-failed' }, cause }),\n    });\n    const plugin = normalizePluginExport(mod);\n    if (!plugin.meta.id || !plugin.meta.name) {\n      return yield* Effect.fail(\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'meta-missing' } }),\n      );\n    }\n    if (plugin.meta.id !== manifest.id) {\n      return yield* Effect.fail(\n        new RemotePluginLoadError({\n          context: {\n            locator: manifestUrl,\n            reason: 'meta-mismatch',\n            metaId: plugin.meta.id,\n            manifestId: manifest.id,\n          },\n        }),\n      );\n    }\n    // Append stylesheets only after the entry imports cleanly and meta validation\n    // passes. If we did this earlier and the import or meta checks failed, the\n    // `<link>` tags would leak into the host DOM with no plugin to own their\n    // teardown — `uninstall` only runs for plugins the manager actually accepted.\n    yield* loadStylesheets(manifest, cache).pipe(wrapCacheError);\n    return { plugin, manifest };\n  });\n\n/**\n * Preloads previously persisted remote plugins from storage. Per-entry failures\n * are logged and swallowed — the returned effect always succeeds with whichever\n * plugins loaded cleanly, so a single bad entry can't block the host's startup.\n */\nexport const preload = (options: PreloadOptions = {}): Effect.Effect<Plugin.Plugin[], never> =>\n  Effect.gen(function* () {\n    const storage = options.storage ?? defaultStorage();\n    const key = options.key ?? DEFAULT_KEY;\n    const cache = options.cache ?? PluginAssetCache.noop();\n    const onPluginLoaded = options.onPluginLoaded;\n\n    const entries = getPersistedRemotePlugins(storage, key);\n    if (entries.length === 0) {\n      return [];\n    }\n    log.info('preloading remote plugins', { count: entries.length });\n    const total = entries.length;\n    let loaded = 0;\n    const results = yield* Effect.all(\n      entries.map((entry) =>\n        loadFromManifest(entry.url, cache).pipe(\n          Effect.tapError((error) => Effect.sync(() => log.warn('failed to preload remote plugin', { entry, error }))),\n          Effect.option,\n          // Tick the progress hook on both success and recoverable failure so\n          // the counter monotonically reaches `total`. The host-supplied\n          // callback is best-effort: any synchronous throw flows through\n          // `Effect.try` and gets logged + ignored so a buggy hook can't\n          // derail the preload.\n          Effect.tap(() =>\n            Effect.sync(() => {\n              loaded += 1;\n            }).pipe(\n              Effect.andThen(Effect.try(() => onPluginLoaded?.(loaded, total))),\n              Effect.tapError((error) => Effect.sync(() => log.warn('onPluginLoaded threw', { loaded, total, error }))),\n              Effect.ignore,\n            ),\n          ),\n        ),\n      ),\n      { concurrency: 'unbounded' },\n    );\n    return results.flatMap((result) =>\n      Option.match(result, {\n        onNone: () => [],\n        onSome: ({ plugin }) => [plugin],\n      }),\n    );\n  });\n\n/**\n * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.\n *\n * Remote URLs must point at a plugin manifest (`plugin.json`). The loader fetches the manifest,\n * eagerly persists every declared asset via the configured `PluginAssetCache`, then dynamic-imports\n * the entry module.\n */\nexport const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  const cache = options.cache ?? PluginAssetCache.noop();\n\n  return (locator: string): Effect.Effect<Plugin.Plugin, RemotePluginLoadError> =>\n    Effect.gen(function* () {\n      const builtin = builtinPlugins.find((plugin) => plugin.meta.id === locator);\n      if (builtin) {\n        return builtin;\n      }\n      if (!isUrl(locator)) {\n        return yield* Effect.fail(new RemotePluginLoadError({ context: { locator, reason: 'invalid-locator' } }));\n      }\n      const { plugin } = yield* loadFromManifest(locator, cache);\n      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);\n      if (duplicate) {\n        return yield* Effect.fail(\n          new RemotePluginLoadError({ context: { locator, reason: 'duplicate-id', id: plugin.meta.id } }),\n        );\n      }\n      persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });\n      return plugin;\n    });\n};\n\n/**\n * Removes a previously installed remote plugin: drops the persisted entry, evicts cached\n * assets, and removes any stylesheet `<link>` tags that {@link loadFromManifest} appended.\n *\n * Cache eviction failures are logged and swallowed — the persisted entry has already been\n * dropped so the user-visible state is consistent regardless of whether the platform\n * cache cooperated.\n */\nexport const uninstall = (pluginId: string, options: Options = {}): Effect.Effect<void, never> =>\n  Effect.gen(function* () {\n    const storage = options.storage ?? defaultStorage();\n    const key = options.key ?? DEFAULT_KEY;\n    const cache = options.cache ?? PluginAssetCache.noop();\n\n    removePersistedRemotePlugin(storage, key, pluginId);\n    if (typeof document !== 'undefined') {\n      document.querySelectorAll(`link[data-dxos-plugin-id=\"${pluginId}\"]`).forEach((node) => node.remove());\n    }\n    yield* cache.evict(pluginId).pipe(\n      Effect.tapError((error) => Effect.sync(() => log.warn('failed to evict plugin assets', { pluginId, error }))),\n      Effect.ignore,\n    );\n  });\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { BaseError } from '@dxos/errors';\n\n/**\n * Tagged error for cache operations. Construction sites supply `context.operation`\n * (one of `'cache' | 'evict' | 'resolve' | 'list'`) and `context.pluginId` so\n * downstream handlers can route on the failed call without scanning the message.\n */\nexport class PluginAssetCacheError extends BaseError.extend(\n  'PluginAssetCacheError',\n  'Plugin asset cache operation failed',\n) {}\n\n/**\n * Per-platform offline cache for third-party plugin assets.\n *\n * Implementations live alongside their platform glue (composer-app's\n * `asset-cache/{tauri,service-worker}.ts`); the no-op default is for tests\n * and unsupported environments.\n */\nexport interface Cache {\n  /**\n   * Persist all listed URLs under the namespace of `pluginId`. Idempotent.\n   * The order of `urls` is significant — the first entry is treated as the entry module.\n   */\n  cache(pluginId: string, urls: readonly string[]): Effect.Effect<void, PluginAssetCacheError>;\n\n  /**\n   * Drop all assets for a plugin (uninstall).\n   */\n  evict(pluginId: string): Effect.Effect<void, PluginAssetCacheError>;\n\n  /**\n   * Resolves a plugin asset URL to a platform-specific cached URL when one is available.\n   * Returns the original URL when no cached copy exists or the platform serves cached\n   * responses transparently (e.g. service worker fetch interception on web).\n   */\n  resolve(pluginId: string, url: string): Effect.Effect<string, PluginAssetCacheError>;\n\n  /**\n   * List currently cached plugin ids (diagnostic).\n   */\n  list(): Effect.Effect<readonly string[], PluginAssetCacheError>;\n}\n\n/**\n * No-op implementation. Used when no platform cache is registered (tests, unsupported environments).\n * Plugins still load — they just have no offline guarantee.\n */\nexport const noop = (): Cache => ({\n  cache: () => Effect.void,\n  evict: () => Effect.void,\n  resolve: (_pluginId, url) => Effect.succeed(url),\n  list: () => Effect.succeed([] as readonly string[]),\n});\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as FetchHttpClient from '@effect/platform/FetchHttpClient';\nimport * as HttpClient from '@effect/platform/HttpClient';\nimport * as HttpClientRequest from '@effect/platform/HttpClientRequest';\nimport * as HttpClientResponse from '@effect/platform/HttpClientResponse';\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { BaseError } from '@dxos/errors';\nimport { PLUGIN_ENTRY_FILENAME } from '@dxos/protocols';\n\n/**\n * Tagged error for manifest fetch / parse failures. Construction sites set\n * `context.manifestUrl` and `context.reason` (one of `'fetch-failed' |\n * 'http-error' | 'parse-failed' | 'invalid'`) so handlers can route on the\n * specific failure mode.\n */\nexport class PluginManifestError extends BaseError.extend('PluginManifestError', 'Plugin manifest is invalid') {}\n\n/**\n * Schema for a third-party plugin manifest.\n *\n * The manifest is published as a sibling of the plugin's entry module\n * ({@link PLUGIN_ENTRY_FILENAME}) and advertises every file the plugin needs at\n * runtime so the host can eagerly cache them for offline use.\n */\nexport const Manifest = Schema.Struct({\n  id: Schema.String,\n  name: Schema.String,\n  version: Schema.String,\n  assets: Schema.Array(Schema.String),\n});\n\nexport type Manifest = Schema.Schema.Type<typeof Manifest>;\n\n/**\n * Resolved manifest with all asset paths converted to absolute URLs.\n */\nexport type ResolvedManifest = {\n  id: string;\n  name: string;\n  version: string;\n  entryUrl: string;\n  assetUrls: readonly string[];\n};\n\n/**\n * Resolves a parsed manifest's relative asset paths against the manifest's URL.\n */\nconst resolve = (manifestUrl: string, manifest: Manifest): ResolvedManifest => ({\n  id: manifest.id,\n  name: manifest.name,\n  version: manifest.version,\n  entryUrl: new URL(PLUGIN_ENTRY_FILENAME, manifestUrl).toString(),\n  assetUrls: manifest.assets.map((asset) => new URL(asset, manifestUrl).toString()),\n});\n\n/**\n * Synchronous decode + validate + resolve for an in-memory manifest payload. Used\n * by tests and tooling that have the manifest body already loaded; the runtime\n * path goes through {@link fetchManifest}.\n */\nexport const parse = (manifestUrl: string, payload: unknown): ResolvedManifest => {\n  const manifest = Schema.decodeUnknownSync(Manifest)(payload);\n  if (!manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {\n    throw new Error(`Manifest at ${manifestUrl} does not list ${PLUGIN_ENTRY_FILENAME} in assets.`);\n  }\n  return resolve(manifestUrl, manifest);\n};\n\n/**\n * Fetches and parses a manifest from the given URL via Effect's HTTP client and\n * Schema-driven JSON decoding. All failure modes surface as a single tagged\n * {@link PluginManifestError}; callers route on `error.context.reason`.\n */\nexport const fetchManifest = (manifestUrl: string): Effect.Effect<ResolvedManifest, PluginManifestError> =>\n  Effect.gen(function* () {\n    const response = yield* HttpClientRequest.get(manifestUrl).pipe(\n      HttpClient.execute,\n      Effect.mapError((cause) => new PluginManifestError({ context: { manifestUrl, reason: 'fetch-failed' }, cause })),\n    );\n    if (response.status >= 400) {\n      return yield* Effect.fail(\n        new PluginManifestError({ context: { manifestUrl, reason: 'http-error', status: response.status } }),\n      );\n    }\n    const manifest = yield* HttpClientResponse.schemaBodyJson(Manifest)(response).pipe(\n      Effect.mapError((cause) => new PluginManifestError({ context: { manifestUrl, reason: 'parse-failed' }, cause })),\n    );\n    if (!manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {\n      return yield* Effect.fail(\n        new PluginManifestError({\n          context: { manifestUrl, reason: 'invalid' },\n          cause: `assets does not include ${PLUGIN_ENTRY_FILENAME}`,\n        }),\n      );\n    }\n    return resolve(manifestUrl, manifest);\n  }).pipe(Effect.scoped, Effect.provide(FetchHttpClient.layer));\n"],
+  "mappings": "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",
+  "names": ["Effect", "Option", "BaseError", "log", "Effect", "BaseError", "PluginAssetCacheError", "extend", "noop", "cache", "void", "evict", "resolve", "_pluginId", "url", "succeed", "list", "FetchHttpClient", "HttpClient", "HttpClientRequest", "HttpClientResponse", "Effect", "Schema", "BaseError", "PLUGIN_ENTRY_FILENAME", "PluginManifestError", "extend", "Manifest", "Struct", "id", "String", "name", "version", "assets", "Array", "resolve", "manifestUrl", "manifest", "entryUrl", "URL", "toString", "assetUrls", "map", "asset", "parse", "payload", "decodeUnknownSync", "includes", "Error", "fetchManifest", "gen", "response", "get", "pipe", "execute", "mapError", "cause", "context", "reason", "status", "fail", "schemaBodyJson", "scoped", "provide", "layer", "DEFAULT_KEY", "defaultStorage", "BaseError", "value", "localStorage", "getPersistedRemotePlugins", "storage", "key", "get", "parsed", "entries", "error", "log", "entry", "pluginId", "url", "URL", "hostname", "locator", "options", "normalizePluginExport", "mod", "exported", "Plugin", "result", "resolved", "resolve", "manifest", "document", "querySelector", "link", "href", "dataset", "head", "loadFromManifest", "manifestUrl", "context", "reason", "cause", "assetUrls", "wrapCacheError", "cache", "entryUrl", "Effect", "tryPromise", "try", "catch", "RemotePluginLoadError", "plugin", "metaId", "manifestId", "PluginAssetCache", "noop", "onPluginLoaded", "info", "total", "results", "pipe", "andThen", "loaded", "flatMap", "onSome", "gen", "builtin", "duplicate", "id", "persistRemotePlugin", "removePersistedRemotePlugin", "querySelectorAll", "evict", "sync", "warn"]
+}