@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

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

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

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

@@ -0,0 +1,48 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/activation-event.ts
+var activation_event_exports = {};
+__export(activation_event_exports, {
+  allOf: () => allOf,
+  eventKey: () => eventKey,
+  getEvents: () => getEvents,
+  isAllOf: () => isAllOf,
+  isOneOf: () => isOneOf,
+  make: () => make,
+  oneOf: () => oneOf
+});
+import { compositeKey } from "@dxos/util";
+var make = (id, specifier) => {
+  return {
+    id,
+    specifier
+  };
+};
+var eventKey = (event) => event.specifier ? compositeKey(event.id, event.specifier) : event.id;
+var oneOf = (...events) => ({
+  type: "one-of",
+  events
+});
+var allOf = (...events) => ({
+  type: "all-of",
+  events
+});
+var isOneOf = (events) => "type" in events && events.type === "one-of";
+var isAllOf = (events) => "type" in events && events.type === "all-of";
+var getEvents = (events) => "type" in events ? events.events : [
+  events
+];
+
+export {
+  make,
+  eventKey,
+  oneOf,
+  allOf,
+  isOneOf,
+  isAllOf,
+  getEvents,
+  activation_event_exports
+};
+//# sourceMappingURL=chunk-QSXYHXCE.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "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"]
+}

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

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

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

@@ -0,0 +1,174 @@
+import {
+  isPlugin
+} from "./chunk-ZBA6IH6L.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  getRemoteEntries: () => getRemoteEntries,
+  isLocalUrl: () => isLocalUrl,
+  make: () => make,
+  preload: () => preload
+});
+import * as Effect from "effect/Effect";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+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
+    }, {
+      F: __dxlog_file,
+      L: 63,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+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 loadRemotePlugin = async (url) => {
+  log.info("loading remote plugin", {
+    url
+  }, {
+    F: __dxlog_file,
+    L: 115,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const mod = await import(
+    /* @vite-ignore */
+    url
+  );
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);
+  }
+  return plugin;
+};
+var preload = async (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, {
+    F: __dxlog_file,
+    L: 135,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));
+  const plugins = [];
+  for (let index = 0; index < results.length; index++) {
+    const result = results[index];
+    if (result.status === "fulfilled") {
+      plugins.push(result.value);
+    } else {
+      log.warn("failed to preload remote plugin", {
+        entry: entries[index],
+        error: result.reason
+      }, {
+        F: __dxlog_file,
+        L: 143,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  return plugins;
+};
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return (locator) => Effect.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return builtin;
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));
+    }
+    const plugin = yield* Effect.tryPromise({
+      try: () => loadRemotePlugin(locator),
+      catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`)
+    });
+    const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+    if (duplicate) {
+      return yield* Effect.fail(new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`));
+    }
+    persistRemotePlugin(storage, key, {
+      id: plugin.meta.id,
+      url: locator
+    });
+    return plugin;
+  });
+};
+
+export {
+  isLocalUrl,
+  getRemoteEntries,
+  preload,
+  make,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-RHQGPRWN.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/url-loader.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { log } from '@dxos/log';\n\nimport * as Plugin from './plugin';\n\nconst DEFAULT_KEY = 'org.dxos.composer.remote-plugins';\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\n/**\n * Persisted record of a remote plugin that has been loaded previously.\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 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\nconst loadRemotePlugin = async (url: string): Promise<Plugin.Plugin> => {\n  log.info('loading remote plugin', { url });\n  const mod = await import(/* @vite-ignore */ url);\n  const plugin = normalizePluginExport(mod);\n  if (!plugin.meta.id || !plugin.meta.name) {\n    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);\n  }\n  return plugin;\n};\n\n/**\n * Preloads previously persisted remote plugins from storage.\n */\nexport const preload = async (options: Options = {}): Promise<Plugin.Plugin[]> => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\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 results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));\n  const plugins: Plugin.Plugin[] = [];\n  for (let index = 0; index < results.length; index++) {\n    const result = results[index];\n    if (result.status === 'fulfilled') {\n      plugins.push(result.value);\n    } else {\n      log.warn('failed to preload remote plugin', { entry: entries[index], error: result.reason });\n    }\n  }\n  return plugins;\n};\n\n/**\n * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.\n */\nexport const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n\n  return (locator: string): Effect.Effect<Plugin.Plugin, Error> =>\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 Error(`Plugin not found and locator is not a URL: ${locator}`));\n      }\n      const plugin = yield* Effect.tryPromise({\n        try: () => loadRemotePlugin(locator),\n        catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`),\n      });\n      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);\n      if (duplicate) {\n        return yield* Effect.fail(\n          new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`),\n        );\n      }\n      persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });\n      return plugin;\n    });\n};\n"],
+  "mappings": ";;;;;;;;AAAA;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAW;;AAIpB,IAAMC,cAAc;AA0BpB,IAAMC,iBAAiB,OAAgB;EACrCC,KAAK,CAACC,QAAQC,aAAaC,QAAQF,GAAAA;EACnCG,KAAK,CAACH,KAAKI,UAAUH,aAAaI,QAAQL,KAAKI,KAAAA;AACjD;AAEA,IAAME,4BAA4B,CAACC,SAAkBP,QAAAA;AACnD,MAAI;AACF,UAAMQ,SAAkBC,KAAKC,MAAMH,QAAQR,IAAIC,GAAAA,KAAQ,IAAA;AACvD,QAAI,CAACW,MAAMC,QAAQJ,MAAAA,GAAS;AAC1B,aAAO,CAAA;IACT;AACA,WAAOA,OAAOK,OACZ,CAACC,UACC,OAAOA,UAAU,YAAYA,UAAU,QAAQ,OAAOA,MAAMC,OAAO,YAAY,OAAOD,MAAME,QAAQ,QAAA;EAE1G,QAAQ;AACN,WAAO,CAAA;EACT;AACF;AAEA,IAAMC,sBAAsB,CAACV,SAAkBP,KAAac,UAAAA;AAC1D,MAAI;AACF,UAAMI,UAAUZ,0BAA0BC,SAASP,GAAAA,EAAKa,OAAO,CAACM,aAAaA,SAASJ,OAAOD,MAAMC,EAAE;AACrGG,YAAQE,KAAKN,KAAAA;AACbP,YAAQJ,IAAIH,KAAKS,KAAKY,UAAUH,OAAAA,CAAAA;EAClC,SAASI,OAAO;AACdC,QAAIC,KAAK,yCAAyC;MAAEV;MAAOQ;IAAM,GAAA;;;;;;EACnE;AACF;AAEA,IAAMG,QAAQ,CAACC,YAAAA;AACb,MAAI;AACF,UAAMV,MAAM,IAAIW,IAAID,OAAAA;AACpB,WAAOV,IAAIY,aAAa,WAAWZ,IAAIY,aAAa;EACtD,QAAQ;AACN,WAAO;EACT;AACF;AAKO,IAAMC,aAAa,CAACH,YAAAA;AACzB,MAAI;AACF,UAAMI,WAAW,IAAIH,IAAID,OAAAA,EAASI,SAASC,YAAW;AAEtD,WAAOD,aAAa,eAAeA,aAAa,eAAeA,aAAa,SAASA,aAAa;EACpG,QAAQ;AACN,WAAO;EACT;AACF;AAOO,IAAME,mBAAmB,CAACC,UAAmB,CAAC,MAAC;AACpD,QAAM1B,UAAU0B,QAAQ1B,WAAWT,eAAAA;AACnC,QAAME,MAAMiC,QAAQjC,OAAOH;AAC3B,SAAOS,0BAA0BC,SAASP,GAAAA;AAC5C;AAEA,IAAMkC,wBAAwB,CAACC,QAAAA;AAC7B,QAAMC,WAAWD,IAAIE;AACrB,MAAWC,SAASF,QAAAA,GAAW;AAC7B,WAAOA;EACT;AACA,MAAI,OAAOA,aAAa,YAAY;AAClC,UAAMG,SAAUH,SAAAA;AAChB,QAAWE,SAASC,MAAAA,GAAS;AAC3B,aAAOA;IACT;EACF;AACA,QAAM,IAAIC,MAAM,4EAAA;AAClB;AAEA,IAAMC,mBAAmB,OAAOzB,QAAAA;AAC9BO,MAAImB,KAAK,yBAAyB;IAAE1B;EAAI,GAAA;;;;;;AACxC,QAAMmB,MAAM,MAAM;;IAA0BnB;;AAC5C,QAAM2B,SAAST,sBAAsBC,GAAAA;AACrC,MAAI,CAACQ,OAAOC,KAAK7B,MAAM,CAAC4B,OAAOC,KAAKC,MAAM;AACxC,UAAM,IAAIL,MAAM,oBAAoBxB,GAAAA,4CAA+C;EACrF;AACA,SAAO2B;AACT;AAKO,IAAMG,UAAU,OAAOb,UAAmB,CAAC,MAAC;AACjD,QAAM1B,UAAU0B,QAAQ1B,WAAWT,eAAAA;AACnC,QAAME,MAAMiC,QAAQjC,OAAOH;AAE3B,QAAMqB,UAAUZ,0BAA0BC,SAASP,GAAAA;AACnD,MAAIkB,QAAQ6B,WAAW,GAAG;AACxB,WAAO,CAAA;EACT;AACAxB,MAAImB,KAAK,6BAA6B;IAAEM,OAAO9B,QAAQ6B;EAAO,GAAA;;;;;;AAC9D,QAAME,UAAU,MAAMC,QAAQC,WAAWjC,QAAQkC,IAAI,CAACtC,UAAU2B,iBAAiB3B,MAAME,GAAG,CAAA,CAAA;AAC1F,QAAMqC,UAA2B,CAAA;AACjC,WAASC,QAAQ,GAAGA,QAAQL,QAAQF,QAAQO,SAAS;AACnD,UAAMf,SAASU,QAAQK,KAAAA;AACvB,QAAIf,OAAOgB,WAAW,aAAa;AACjCF,cAAQjC,KAAKmB,OAAOnC,KAAK;IAC3B,OAAO;AACLmB,UAAIC,KAAK,mCAAmC;QAAEV,OAAOI,QAAQoC,KAAAA;QAAQhC,OAAOiB,OAAOiB;MAAO,GAAA;;;;;;IAC5F;EACF;AACA,SAAOH;AACT;AAKO,IAAMI,OAAO,CAACC,gBAAiCzB,UAAmB,CAAC,MAAC;AACzE,QAAM1B,UAAU0B,QAAQ1B,WAAWT,eAAAA;AACnC,QAAME,MAAMiC,QAAQjC,OAAOH;AAE3B,SAAO,CAAC6B,YACCiC,WAAI,aAAA;AACT,UAAMC,UAAUF,eAAeG,KAAK,CAAClB,YAAWA,QAAOC,KAAK7B,OAAOW,OAAAA;AACnE,QAAIkC,SAAS;AACX,aAAOA;IACT;AACA,QAAI,CAACnC,MAAMC,OAAAA,GAAU;AACnB,aAAO,OAAcoC,YAAK,IAAItB,MAAM,8CAA8Cd,OAAAA,EAAS,CAAA;IAC7F;AACA,UAAMiB,SAAS,OAAcoB,kBAAW;MACtCC,KAAK,MAAMvB,iBAAiBf,OAAAA;MAC5BuC,OAAO,CAAC3C,UAAU,IAAIkB,MAAM,qCAAqCd,OAAAA,KAAYJ,KAAAA,EAAO;IACtF,CAAA;AACA,UAAM4C,YAAYR,eAAeG,KAAK,CAAC1C,aAAaA,SAASyB,KAAK7B,OAAO4B,OAAOC,KAAK7B,EAAE;AACvF,QAAImD,WAAW;AACb,aAAO,OAAcJ,YACnB,IAAItB,MAAM,iBAAiBG,OAAOC,KAAK7B,EAAE,iDAAiD,CAAA;IAE9F;AACAE,wBAAoBV,SAASP,KAAK;MAAEe,IAAI4B,OAAOC,KAAK7B;MAAIC,KAAKU;IAAQ,CAAA;AACrE,WAAOiB;EACT,CAAA;AACJ;",
+  "names": ["Effect", "log", "DEFAULT_KEY", "defaultStorage", "get", "key", "localStorage", "getItem", "set", "value", "setItem", "getPersistedRemotePlugins", "storage", "parsed", "JSON", "parse", "Array", "isArray", "filter", "entry", "id", "url", "persistRemotePlugin", "entries", "existing", "push", "stringify", "error", "log", "warn", "isUrl", "locator", "URL", "protocol", "isLocalUrl", "hostname", "toLowerCase", "getRemoteEntries", "options", "normalizePluginExport", "mod", "exported", "default", "isPlugin", "result", "Error", "loadRemotePlugin", "info", "plugin", "meta", "name", "preload", "length", "count", "results", "Promise", "allSettled", "map", "plugins", "index", "status", "reason", "make", "builtinPlugins", "gen", "builtin", "find", "fail", "tryPromise", "try", "catch", "duplicate"]
+}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,148 @@
+import {
+  getModuleTag
+} from "./chunk-2CKCJ6PN.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/plugin.ts
+var plugin_exports = {};
+__export(plugin_exports, {
+  PluginModuleTypeId: () => PluginModuleTypeId,
+  PluginTypeId: () => PluginTypeId,
+  Service: () => Service,
+  activate: () => activate,
+  addModule: () => addModule,
+  define: () => define,
+  isPlugin: () => isPlugin,
+  isPluginModule: () => isPluginModule,
+  make: () => make,
+  reset: () => reset,
+  shutdown: () => shutdown
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Pipeable from "effect/Pipeable";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/plugin.ts";
+var Service = class extends Context.Tag("@dxos/app-framework/PluginManager")() {
+};
+var activate = (event) => Effect.flatMap(Service, (manager) => manager.activate(event));
+var reset = (event) => Effect.flatMap(Service, (manager) => manager.reset(event));
+var shutdown = () => Effect.flatMap(Service, (manager) => manager.shutdown());
+var computeModuleId = (pluginId, moduleName) => {
+  return `${pluginId}.module.${moduleName}`;
+};
+var PluginModuleTypeId = /* @__PURE__ */ Symbol.for("@dxos/app-framework/PluginModule");
+var isPluginModule = (value) => {
+  return typeof value === "object" && value !== null && PluginModuleTypeId in value;
+};
+var PluginModuleImpl = class {
+  [PluginModuleTypeId] = PluginModuleTypeId;
+  id;
+  activatesOn;
+  firesBeforeActivation;
+  firesAfterActivation;
+  activate;
+  constructor(options) {
+    this.id = options.id;
+    this.activatesOn = options.activatesOn;
+    this.firesBeforeActivation = options.firesBeforeActivation;
+    this.firesAfterActivation = options.firesAfterActivation;
+    this.activate = options.activate;
+  }
+};
+var PluginTypeId = /* @__PURE__ */ Symbol.for("@dxos/app-framework/Plugin");
+var isPlugin = (value) => {
+  return typeof value === "object" && value !== null && PluginTypeId in value;
+};
+var PluginImpl = class {
+  _meta;
+  _modules;
+  [PluginTypeId] = PluginTypeId;
+  constructor(_meta, _modules) {
+    this._meta = _meta;
+    this._modules = _modules;
+  }
+  get meta() {
+    return this._meta;
+  }
+  get modules() {
+    return this._modules;
+  }
+};
+var PluginBuilderImpl = class {
+  meta;
+  _modules = [];
+  constructor(meta) {
+    this.meta = meta;
+  }
+  get modules() {
+    return this._modules;
+  }
+  addModule(moduleOptions) {
+    this._modules.push(moduleOptions);
+    return this;
+  }
+  pipe() {
+    return Pipeable.pipeArguments(this, arguments);
+  }
+};
+var define = (meta) => new PluginBuilderImpl(meta);
+function addModule(moduleOptionsOrBuilder, moduleOptions) {
+  if (moduleOptions !== void 0) {
+    return moduleOptionsOrBuilder.addModule(moduleOptions);
+  }
+  const moduleOpts = moduleOptionsOrBuilder;
+  return (builder) => builder.addModule(moduleOpts);
+}
+var resolveModule = (meta, module, options) => {
+  const moduleOptions = typeof module === "function" ? module(options) : module;
+  const id = Option.fromNullable(moduleOptions.id).pipe(Option.match({
+    onNone: () => {
+      const exportName = getModuleTag(moduleOptions.activate);
+      invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`, {
+        F: __dxlog_file,
+        L: 325,
+        S: void 0,
+        A: [
+          "exportName",
+          "`Plugin module missing name. Plugin: ${meta.id}`"
+        ]
+      });
+      return computeModuleId(meta.id, exportName);
+    },
+    onSome: (id2) => computeModuleId(meta.id, id2)
+  }));
+  return new PluginModuleImpl({
+    ...moduleOptions,
+    id
+  });
+};
+function make(builder) {
+  const meta = builder.meta;
+  const factory = (options) => {
+    const modules = builder.modules.map((module) => resolveModule(meta, module, options));
+    return new PluginImpl(meta, modules);
+  };
+  return Object.assign(factory, {
+    meta
+  });
+}
+
+export {
+  Service,
+  activate,
+  reset,
+  shutdown,
+  PluginModuleTypeId,
+  isPluginModule,
+  PluginTypeId,
+  isPlugin,
+  define,
+  addModule,
+  make,
+  plugin_exports
+};
+//# sourceMappingURL=chunk-ZBA6IH6L.mjs.map