@dxos/app-framework 0.7.5-main.9d26e3a → 0.7.5-main.e9bb01b

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/plugin-settings/SettingsPlugin.tsx", "../../../src/plugins/plugin-settings/meta.ts", "../../../src/plugins/plugin-settings/provides.ts", "../../../src/plugins/plugin-settings/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { RootSettingsStore } from '@dxos/local-storage';\n\nimport SettingsMeta from './meta';\nimport { type SettingsPluginProvides } from './provides';\nimport { type PluginDefinition } from '../plugin-host';\n\nexport const SettingsPlugin = (): PluginDefinition<SettingsPluginProvides> => {\n  // Global settings singleton.\n  // TODO(burdon): Make settings storage extensible so that other plugins can decide the persistence of them.\n  const settingsStore = new RootSettingsStore();\n\n  return {\n    meta: SettingsMeta,\n    provides: {\n      settingsStore,\n    },\n  };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SettingsMeta = {\n  id: 'dxos.org/plugin/settings',\n};\n\nexport default SettingsMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { S } from '@dxos/echo-schema';\nimport { type SettingsStoreFactory, type SettingsValue } from '@dxos/local-storage';\n\nimport { type Plugin } from '../plugin-host';\n\nexport type SettingsProvides<T extends SettingsValue> = {\n  settings: T;\n};\n\nexport type SettingsPluginProvides = {\n  settingsStore: SettingsStoreFactory;\n};\n\nexport const parseSettingsPlugin = (plugin: Plugin) => {\n  return typeof (plugin.provides as any).settingsStore === 'object'\n    ? (plugin as Plugin<SettingsPluginProvides>)\n    : undefined;\n};\n\nexport const SETTINGS_PLUGIN = 'dxos.org/plugin/settings';\nexport const SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;\n\nexport namespace SettingsAction {\n  export class Open extends S.TaggedClass<Open>()(`${SETTINGS_ACTION}/open`, {\n    input: S.Struct({\n      plugin: S.optional(S.String),\n    }),\n    output: S.Void,\n  }) {}\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { SettingsPlugin } from './SettingsPlugin';\n\nexport * from './provides';\n\nexport default SettingsPlugin;\n"],
-  "mappings": ";AAIA,SAASA,yBAAyB;;;ACAlC,IAAMC,eAAe;EACnBC,IAAI;AACN;AAEA,IAAA,eAAeD;;;ADER,IAAME,iBAAiB,MAAA;AAG5B,QAAMC,gBAAgB,IAAIC,kBAAAA;AAE1B,SAAO;IACLC,MAAMC;IACNC,UAAU;MACRJ;IACF;EACF;AACF;;;AEjBA,SAASK,SAAS;AAaX,IAAMC,sBAAsB,CAACC,WAAAA;AAClC,SAAO,OAAQA,OAAOC,SAAiBC,kBAAkB,WACpDF,SACDG;AACN;AAEO,IAAMC,kBAAkB;AACxB,IAAMC,kBAAkB,GAAGD,eAAAA;;UAEjBE,iBAAAA;EACR,MAAMC,aAAaC,EAAEC,YAAW,EAAS,GAAGJ,eAAAA,SAAwB;IACzEK,OAAOF,EAAEG,OAAO;MACdX,QAAQQ,EAAEI,SAASJ,EAAEK,MAAM;IAC7B,CAAA;IACAC,QAAQN,EAAEO;EACZ,CAAA,EAAA;EAAI;kBALSR,OAAAA;AAMf,GAPiBD,mBAAAA,iBAAAA,CAAAA,EAAAA;;;AClBjB,IAAA,0BAAeU;",
-  "names": ["RootSettingsStore", "SettingsMeta", "id", "SettingsPlugin", "settingsStore", "RootSettingsStore", "meta", "SettingsMeta", "provides", "S", "parseSettingsPlugin", "plugin", "provides", "settingsStore", "undefined", "SETTINGS_PLUGIN", "SETTINGS_ACTION", "SettingsAction", "Open", "S", "TaggedClass", "input", "Struct", "optional", "String", "output", "Void", "SettingsPlugin"]
-}

package/dist/lib/browser/plugin-intent-T7Y3MJ5C.mjs

@@ -1,32 +0,0 @@
-import {
-  INTENT_ACTION,
-  IntentAction,
-  IntentProvider,
-  Label,
-  chain,
-  createDispatcher,
-  createIntent,
-  createResolver,
-  parseIntentPlugin,
-  parseIntentResolverPlugin,
-  plugin_intent_default,
-  useIntentDispatcher,
-  useIntentResolver
-} from "./chunk-QG25ZU2N.mjs";
-import "./chunk-3E7RY3CE.mjs";
-export {
-  INTENT_ACTION,
-  IntentAction,
-  IntentProvider,
-  Label,
-  chain,
-  createDispatcher,
-  createIntent,
-  createResolver,
-  plugin_intent_default as default,
-  parseIntentPlugin,
-  parseIntentResolverPlugin,
-  useIntentDispatcher,
-  useIntentResolver
-};
-//# sourceMappingURL=plugin-intent-T7Y3MJ5C.mjs.map

package/dist/lib/browser/plugin-settings-5U2L2NRU.mjs

@@ -1,15 +0,0 @@
-import {
-  SETTINGS_ACTION,
-  SETTINGS_PLUGIN,
-  SettingsAction,
-  parseSettingsPlugin,
-  plugin_settings_default
-} from "./chunk-WBOXEHBE.mjs";
-export {
-  SETTINGS_ACTION,
-  SETTINGS_PLUGIN,
-  SettingsAction,
-  plugin_settings_default as default,
-  parseSettingsPlugin
-};
-//# sourceMappingURL=plugin-settings-5U2L2NRU.mjs.map

package/dist/lib/browser/plugin-surface-OKPF3EQI.mjs

@@ -1,24 +0,0 @@
-import {
-  ErrorBoundary,
-  Surface,
-  SurfaceProvider,
-  createSurface,
-  isObject,
-  parseRootSurfacePlugin,
-  parseSurfacePlugin,
-  plugin_surface_default,
-  useSurfaceRoot
-} from "./chunk-SPDTXTOV.mjs";
-import "./chunk-3E7RY3CE.mjs";
-export {
-  ErrorBoundary,
-  Surface,
-  SurfaceProvider,
-  createSurface,
-  plugin_surface_default as default,
-  isObject,
-  parseRootSurfacePlugin,
-  parseSurfacePlugin,
-  useSurfaceRoot
-};
-//# sourceMappingURL=plugin-surface-OKPF3EQI.mjs.map

package/dist/lib/node/chunk-BW3RNEVI.cjs

@@ -1,185 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var chunk_BW3RNEVI_exports = {};
-__export(chunk_BW3RNEVI_exports, {
-  ErrorBoundary: () => ErrorBoundary,
-  Surface: () => Surface,
-  SurfaceProvider: () => SurfaceProvider,
-  createSurface: () => createSurface,
-  isObject: () => isObject,
-  meta_default: () => meta_default,
-  parseRootSurfacePlugin: () => parseRootSurfacePlugin,
-  parseSurfacePlugin: () => parseSurfacePlugin,
-  plugin_surface_default: () => plugin_surface_default,
-  useSurfaceRoot: () => useSurfaceRoot
-});
-module.exports = __toCommonJS(chunk_BW3RNEVI_exports);
-var import_chunk_QBM42OQ6 = require("./chunk-QBM42OQ6.cjs");
-var import_react = __toESM(require("react"));
-var import_live_object = require("@dxos/live-object");
-var import_react2 = require("react");
-var import_debug = require("@dxos/debug");
-var import_react3 = __toESM(require("react"));
-var import_react4 = __toESM(require("react"));
-var import_react_hooks = require("@dxos/react-hooks");
-var createSurface = (definition) => definition;
-var SurfaceContext = (0, import_react2.createContext)(void 0);
-var useSurfaceRoot = () => (0, import_react2.useContext)(SurfaceContext) ?? (0, import_debug.raise)(new Error("Missing SurfaceContext"));
-var SurfaceProvider = SurfaceContext.Provider;
-var SurfaceMeta = {
-  id: "dxos.org/plugin/surface"
-};
-var meta_default = SurfaceMeta;
-var parseRootSurfacePlugin = (plugin) => plugin?.provides?.surface?.surfaces ? plugin : void 0;
-var parseSurfacePlugin = (plugin) => plugin?.provides?.surface?.definitions ? plugin : void 0;
-var SurfacePlugin = () => {
-  const state = (0, import_live_object.create)({
-    surfaces: {},
-    debugInfo: /* @__PURE__ */ new Map()
-  });
-  return {
-    meta: meta_default,
-    ready: async (context) => {
-      state.surfaces = (0, import_chunk_QBM42OQ6.filterPlugins)(context.plugins, parseSurfacePlugin).reduce((acc, plugin) => reduceSurfaces(plugin.provides.surface.definitions(context), acc), {});
-    },
-    provides: {
-      surface: state,
-      context: ({ children }) => /* @__PURE__ */ import_react.default.createElement(SurfaceProvider, {
-        value: state
-      }, children)
-    }
-  };
-};
-var reduceSurfaces = (definitions, surfaces = {}) => {
-  if (Array.isArray(definitions)) {
-    return definitions.reduce((acc, definition) => reduceSurfaces(definition, acc), surfaces);
-  }
-  return {
-    ...surfaces,
-    [definitions.id]: definitions
-  };
-};
-var isObject = (data) => !!data && typeof data === "object";
-var ErrorBoundary = class extends import_react3.Component {
-  constructor(props) {
-    super(props);
-    this.state = {
-      error: void 0
-    };
-  }
-  static getDerivedStateFromError(error) {
-    return {
-      error
-    };
-  }
-  componentDidUpdate(prevProps) {
-    if (prevProps.data !== this.props.data) {
-      this.resetError();
-    }
-  }
-  render() {
-    if (this.state.error) {
-      return /* @__PURE__ */ import_react3.default.createElement(this.props.fallback, {
-        data: this.props.data,
-        error: this.state.error,
-        reset: this.resetError
-      });
-    }
-    return this.props.children;
-  }
-  resetError() {
-    this.setState({
-      error: void 0
-    });
-  }
-};
-var Surface = /* @__PURE__ */ (0, import_react4.memo)(/* @__PURE__ */ (0, import_react4.forwardRef)(({ id: _id, role, data: _data, limit, fallback, placeholder, ...rest }, forwardedRef) => {
-  const { surfaces, debugInfo } = useSurfaceRoot();
-  const data = (0, import_react_hooks.useDefaultValue)(_data, () => ({}));
-  const reactId = (0, import_react4.useId)();
-  const id = _id ?? reactId;
-  (0, import_react4.useEffect)(() => {
-    debugInfo?.set(id, {
-      id,
-      created: Date.now(),
-      role,
-      renderCount: 0
-    });
-    return () => {
-      debugInfo?.delete(id);
-    };
-  }, [
-    id
-  ]);
-  if (debugInfo?.get(id)) {
-    debugInfo.get(id).renderCount++;
-  }
-  const candidates = (0, import_react4.useMemo)(() => {
-    const definitions = Object.values(surfaces).filter((definition) => Array.isArray(definition.role) ? definition.role.includes(role) : definition.role === role).filter(({ filter }) => filter ? filter(data) : true).toSorted(({ disposition: a = "static" }, { disposition: b = "static" }) => {
-      return a === b ? 0 : a === "hoist" || b === "fallback" ? -1 : b === "hoist" || a === "fallback" ? 1 : 0;
-    });
-    return limit ? definitions.slice(0, limit) : definitions;
-  }, [
-    surfaces,
-    role,
-    data,
-    limit
-  ]);
-  const nodes = candidates.map(({ component: Component2, id: id2 }) => /* @__PURE__ */ import_react4.default.createElement(Component2, {
-    ref: forwardedRef,
-    key: id2,
-    id: id2,
-    role,
-    data,
-    limit,
-    ...rest
-  }));
-  const suspense = placeholder ? /* @__PURE__ */ import_react4.default.createElement(import_react4.Suspense, {
-    fallback: placeholder
-  }, nodes) : nodes;
-  return fallback ? /* @__PURE__ */ import_react4.default.createElement(ErrorBoundary, {
-    data,
-    fallback
-  }, suspense) : suspense;
-}));
-var plugin_surface_default = SurfacePlugin;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ErrorBoundary,
-  Surface,
-  SurfaceProvider,
-  createSurface,
-  isObject,
-  meta_default,
-  parseRootSurfacePlugin,
-  parseSurfacePlugin,
-  plugin_surface_default,
-  useSurfaceRoot
-});
-//# sourceMappingURL=chunk-BW3RNEVI.cjs.map

package/dist/lib/node/chunk-BW3RNEVI.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/plugin-surface/SurfacePlugin.tsx", "../../../src/plugins/plugin-surface/SurfaceContext.ts", "../../../src/plugins/plugin-surface/meta.ts", "../../../src/plugins/plugin-surface/provides.ts", "../../../src/plugins/plugin-surface/helpers.ts", "../../../src/plugins/plugin-surface/ErrorBoundary.tsx", "../../../src/plugins/plugin-surface/Surface.tsx", "../../../src/plugins/plugin-surface/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { create } from '@dxos/live-object';\n\nimport { SurfaceProvider, type SurfaceContextValue } from './SurfaceContext';\nimport SurfaceMeta from './meta';\nimport { parseSurfacePlugin, type SurfacePluginProvides, type SurfaceDefinitions } from './provides';\nimport { filterPlugins } from '../helpers';\nimport { type PluginDefinition } from '../plugin-host';\n\n/**\n * Provides a registry of surface components.\n */\nexport const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {\n  const state = create<SurfaceContextValue>({ surfaces: {}, debugInfo: new Map() });\n\n  return {\n    meta: SurfaceMeta,\n    ready: async (context) => {\n      state.surfaces = filterPlugins(context.plugins, parseSurfacePlugin).reduce(\n        (acc, plugin) => reduceSurfaces(plugin.provides.surface.definitions(context), acc),\n        {},\n      );\n    },\n    provides: {\n      surface: state,\n      context: ({ children }) => <SurfaceProvider value={state}>{children}</SurfaceProvider>,\n    },\n  };\n};\n\nconst reduceSurfaces = (\n  definitions: SurfaceDefinitions,\n  surfaces: SurfaceContextValue['surfaces'] = {},\n): SurfaceContextValue['surfaces'] => {\n  if (Array.isArray(definitions)) {\n    return definitions.reduce((acc, definition) => reduceSurfaces(definition, acc), surfaces);\n  }\n\n  return { ...surfaces, [definitions.id]: definitions };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { createContext, useContext, type JSX, type ForwardedRef, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { type GuardedType, type MakeOptional } from '@dxos/util';\n\nimport { type ErrorBoundary } from './ErrorBoundary';\n\n/**\n * SurfaceProps are the props that are passed to the Surface component.\n */\nexport type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{\n  /**\n   * If specified, the Surface will be wrapped in an error boundary.\n   * The fallback component will be rendered if an error occurs.\n   */\n  fallback?: ErrorBoundary['props']['fallback'];\n\n  /**\n   * If specified, the Surface will be wrapped in a suspense boundary.\n   * The placeholder component will be rendered while the surface component is loading.\n   */\n  placeholder?: ReactNode;\n}> &\n  MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> & {\n    /**\n     * Additional props to pass to the component.\n     * These props are not used by Surface itself but may be used by components which resolve the surface.\n     */\n    [key: string]: unknown;\n  };\n\n// NOTE: If `[key: string]: unknown` is included in shared types, when re-used other fields become unknown as well.\ntype CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {\n  /**\n   * ID for debugging.\n   */\n  id: string;\n\n  /**\n   * Role defines how the data should be rendered.\n   */\n  role: string;\n\n  /**\n   * The data to be rendered by the surface.\n   */\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\ntype SurfaceComponentProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<\n  CoreSurfaceProps<T> & { [key: string]: unknown }\n>;\n\n/**\n * React component used to render a surface once is has matched.\n */\nexport type SurfaceComponent<T extends Record<string, any> = Record<string, unknown>> = (\n  props: SurfaceComponentProps<T>,\n  forwardedRef: ForwardedRef<HTMLElement>,\n) => JSX.Element | null;\n\n/**\n * Determines the priority of the surface when multiple components are resolved.\n *\n * - `static` - The component is rendered in the order it was resolved.\n * - `hoist` - The component is rendered before `static` components.\n * - `fallback` - The component is rendered after `static` components.\n */\nexport type SurfaceDisposition = 'static' | 'hoist' | 'fallback';\n\n/**\n * Definition of when a SurfaceComponent should be rendered.\n */\nexport type SurfaceDefinition<T extends Record<string, any> = any> = {\n  id: string;\n  role: string | string[];\n  disposition?: SurfaceDisposition;\n  filter?: (data: Record<string, unknown>) => data is T;\n  component: SurfaceComponent<GuardedType<SurfaceDefinition<T>['filter']>>;\n};\n\nexport const createSurface = <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => definition;\n\n/**\n * Surface debug info.\n * NOTE: Short-term measure to track perf issues.\n */\nexport type DebugInfo = {\n  id: string;\n  created: number;\n  renderCount: number;\n} & Pick<SurfaceProps, 'role'>;\n\nexport type SurfaceContextValue = {\n  surfaces: Record<string, SurfaceDefinition>;\n  debugInfo?: Map<string, DebugInfo>;\n};\n\nconst SurfaceContext = createContext<SurfaceContextValue | undefined>(undefined);\n\nexport const useSurfaceRoot = () => useContext(SurfaceContext) ?? raise(new Error('Missing SurfaceContext'));\n\nexport const SurfaceProvider = SurfaceContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SurfaceMeta = {\n  id: 'dxos.org/plugin/surface',\n};\n\nexport default SurfaceMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SurfaceDefinition, type SurfaceContextValue } from './SurfaceContext';\nimport { type HostContext, type Plugin } from '../plugin-host';\n\nexport type SurfaceDefinitions = SurfaceDefinition | SurfaceDefinition[] | SurfaceDefinitions[];\n\nexport type SurfaceProvides = {\n  surface: {\n    /**\n     * Used by the `Surface` resolver to find a component to render.\n     */\n    definitions: (context: HostContext) => SurfaceDefinitions;\n  };\n};\n\nexport type SurfacePluginProvides = {\n  surface: SurfaceContextValue;\n};\n\nexport const parseRootSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.surfaces ? (plugin as Plugin<SurfacePluginProvides>) : undefined;\n\nexport const parseSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.definitions ? (plugin as Plugin<SurfaceProvides>) : undefined;\n", "//\n// Copyright 2023 DXOS.org\n//\n\n/**\n * Checks if the given data is an object and not null.\n *\n * Useful inside surface component resolvers as a type guard.\n *\n * @example\n * ```ts\n *  const old =\n *    data.content &&\n *      typeof data.content === 'object' &&\n *      'id' in data.content &&\n *      typeof data.content.id === 'string';\n *\n *  // becomes\n *  const new = isObject(data.content) && typeof data.content.id === 'string';\n * ```\n */\nexport const isObject = (data: unknown): data is { [key: string]: unknown } => !!data && typeof data === 'object';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { Component, type FC, type PropsWithChildren } from 'react';\n\ntype Props = PropsWithChildren<{ data?: any; fallback: FC<{ data?: any; error: Error; reset: () => void }> }>;\ntype State = { error: Error | undefined };\n\n/**\n * Surface error boundary.\n *\n * For basic usage prefer providing a fallback component to `Surface`.\n *\n * For more information on error boundaries, see:\n * https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary\n */\nexport class ErrorBoundary extends Component<Props, State> {\n  constructor(props: Props) {\n    super(props);\n    this.state = { error: undefined };\n  }\n\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  override componentDidUpdate(prevProps: Props): void {\n    if (prevProps.data !== this.props.data) {\n      this.resetError();\n    }\n  }\n\n  override render() {\n    if (this.state.error) {\n      return <this.props.fallback data={this.props.data} error={this.state.error} reset={this.resetError} />;\n    }\n\n    return this.props.children;\n  }\n\n  private resetError() {\n    this.setState({ error: undefined });\n  }\n}\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport React, { Suspense, forwardRef, memo, useEffect, useId, useMemo } from 'react';\n\nimport { useDefaultValue } from '@dxos/react-hooks';\n\nimport { ErrorBoundary } from './ErrorBoundary';\nimport { type SurfaceProps, useSurfaceRoot } from './SurfaceContext';\n\n/**\n * A surface is a named region of the screen that can be populated by plugins.\n */\nexport const Surface = memo(\n  forwardRef<HTMLElement, SurfaceProps>(\n    ({ id: _id, role, data: _data, limit, fallback, placeholder, ...rest }, forwardedRef) => {\n      const { surfaces, debugInfo } = useSurfaceRoot();\n      const data = useDefaultValue(_data, () => ({}));\n\n      // Track debug info.\n      const reactId = useId();\n      const id = _id ?? reactId;\n      useEffect(() => {\n        debugInfo?.set(id, { id, created: Date.now(), role, renderCount: 0 });\n        return () => {\n          debugInfo?.delete(id);\n        };\n      }, [id]);\n\n      if (debugInfo?.get(id)) {\n        debugInfo.get(id)!.renderCount++;\n      }\n\n      const candidates = useMemo(() => {\n        const definitions = Object.values(surfaces)\n          .filter((definition) =>\n            Array.isArray(definition.role) ? definition.role.includes(role) : definition.role === role,\n          )\n          .filter(({ filter }) => (filter ? filter(data) : true))\n          .toSorted(({ disposition: a = 'static' }, { disposition: b = 'static' }) => {\n            return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;\n          });\n        return limit ? definitions.slice(0, limit) : definitions;\n      }, [surfaces, role, data, limit]);\n\n      const nodes = candidates.map(({ component: Component, id }) => (\n        <Component ref={forwardedRef} key={id} id={id} role={role} data={data} limit={limit} {...rest} />\n      ));\n\n      const suspense = placeholder ? <Suspense fallback={placeholder}>{nodes}</Suspense> : nodes;\n\n      return fallback ? (\n        <ErrorBoundary data={data} fallback={fallback}>\n          {suspense}\n        </ErrorBoundary>\n      ) : (\n        suspense\n      );\n    },\n  ),\n);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { SurfacePlugin } from './SurfacePlugin';\n\nexport * from './helpers';\nexport * from './provides';\n\nexport * from './ErrorBoundary';\nexport * from './Surface';\nexport * from './SurfaceContext';\n\nexport default SurfacePlugin;\n"],
-  "mappings": "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",
-  "names": ["import_react", "createSurface", "definition", "SurfaceContext", "createContext", "undefined", "useSurfaceRoot", "useContext", "raise", "Error", "SurfaceProvider", "Provider", "SurfaceMeta", "id", "parseRootSurfacePlugin", "plugin", "provides", "surface", "surfaces", "parseSurfacePlugin", "definitions", "SurfacePlugin", "state", "create", "debugInfo", "Map", "meta", "ready", "context", "filterPlugins", "plugins", "reduce", "acc", "reduceSurfaces", "children", "React", "value", "Array", "isArray", "isObject", "data", "ErrorBoundary", "Component", "constructor", "props", "error", "getDerivedStateFromError", "componentDidUpdate", "prevProps", "resetError", "render", "this", "fallback", "reset", "setState", "Surface", "memo", "forwardRef", "_id", "role", "_data", "limit", "placeholder", "rest", "forwardedRef", "useDefaultValue", "reactId", "useId", "useEffect", "set", "created", "Date", "now", "renderCount", "delete", "get", "candidates", "useMemo", "Object", "values", "filter", "includes", "toSorted", "disposition", "a", "b", "slice", "nodes", "map", "component", "ref", "key", "suspense", "Suspense"]
-}

package/dist/lib/node/chunk-FCMHRU3M.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/plugin-settings/SettingsPlugin.tsx", "../../../src/plugins/plugin-settings/meta.ts", "../../../src/plugins/plugin-settings/provides.ts", "../../../src/plugins/plugin-settings/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { RootSettingsStore } from '@dxos/local-storage';\n\nimport SettingsMeta from './meta';\nimport { type SettingsPluginProvides } from './provides';\nimport { type PluginDefinition } from '../plugin-host';\n\nexport const SettingsPlugin = (): PluginDefinition<SettingsPluginProvides> => {\n  // Global settings singleton.\n  // TODO(burdon): Make settings storage extensible so that other plugins can decide the persistence of them.\n  const settingsStore = new RootSettingsStore();\n\n  return {\n    meta: SettingsMeta,\n    provides: {\n      settingsStore,\n    },\n  };\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SettingsMeta = {\n  id: 'dxos.org/plugin/settings',\n};\n\nexport default SettingsMeta;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { S } from '@dxos/echo-schema';\nimport { type SettingsStoreFactory, type SettingsValue } from '@dxos/local-storage';\n\nimport { type Plugin } from '../plugin-host';\n\nexport type SettingsProvides<T extends SettingsValue> = {\n  settings: T;\n};\n\nexport type SettingsPluginProvides = {\n  settingsStore: SettingsStoreFactory;\n};\n\nexport const parseSettingsPlugin = (plugin: Plugin) => {\n  return typeof (plugin.provides as any).settingsStore === 'object'\n    ? (plugin as Plugin<SettingsPluginProvides>)\n    : undefined;\n};\n\nexport const SETTINGS_PLUGIN = 'dxos.org/plugin/settings';\nexport const SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;\n\nexport namespace SettingsAction {\n  export class Open extends S.TaggedClass<Open>()(`${SETTINGS_ACTION}/open`, {\n    input: S.Struct({\n      plugin: S.optional(S.String),\n    }),\n    output: S.Void,\n  }) {}\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { SettingsPlugin } from './SettingsPlugin';\n\nexport * from './provides';\n\nexport default SettingsPlugin;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,2BAAkC;AEAlC,yBAAkB;ADAlB,IAAMA,eAAe;EACnBC,IAAI;AACN;AAEA,IAAA,eAAeD;ADER,IAAME,iBAAiB,MAAA;AAG5B,QAAMC,gBAAgB,IAAIC,uCAAAA;AAE1B,SAAO;IACLC,MAAML;IACNM,UAAU;MACRH;IACF;EACF;AACF;AEJO,IAAMI,sBAAsB,CAACC,WAAAA;AAClC,SAAO,OAAQA,OAAOF,SAAiBH,kBAAkB,WACpDK,SACDC;AACN;AAEO,IAAMC,kBAAkB;AACxB,IAAMC,kBAAkB,GAAGD,eAAAA;;UAEjBE,iBAAAA;EACR,MAAMC,aAAaC,qBAAEC,YAAW,EAAS,GAAGJ,eAAAA,SAAwB;IACzEK,OAAOF,qBAAEG,OAAO;MACdT,QAAQM,qBAAEI,SAASJ,qBAAEK,MAAM;IAC7B,CAAA;IACAC,QAAQN,qBAAEO;EACZ,CAAA,EAAA;EAAI;kBALSR,OAAAA;AAMf,GAPiBD,mBAAAA,iBAAAA,CAAAA,EAAAA;AClBjB,IAAA,0BAAeV;",
-  "names": ["SettingsMeta", "id", "SettingsPlugin", "settingsStore", "RootSettingsStore", "meta", "provides", "parseSettingsPlugin", "plugin", "undefined", "SETTINGS_PLUGIN", "SETTINGS_ACTION", "SettingsAction", "Open", "S", "TaggedClass", "input", "Struct", "optional", "String", "output", "Void"]
-}

package/dist/lib/node/chunk-QBM42OQ6.cjs

@@ -1,97 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var chunk_QBM42OQ6_exports = {};
-__export(chunk_QBM42OQ6_exports, {
-  definePlugin: () => definePlugin,
-  filterPlugins: () => filterPlugins,
-  findPlugin: () => findPlugin,
-  getPlugin: () => getPlugin,
-  resolvePlugin: () => resolvePlugin
-});
-module.exports = __toCommonJS(chunk_QBM42OQ6_exports);
-var import_context = require("@dxos/context");
-var import_debug = require("@dxos/debug");
-var import_invariant = require("@dxos/invariant");
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/app-framework/src/plugins/helpers.ts";
-var findPlugin = (plugins, id) => {
-  return plugins.find((plugin) => plugin.meta.id === id || typeof plugin.meta.shortId === "string" && plugin.meta.shortId === id);
-};
-var getPlugin = (plugins, id) => {
-  return findPlugin(plugins, id) ?? (0, import_debug.raise)(new Error(`Plugin not found: ${id}`));
-};
-var filterPlugins = (plugins, predicate) => plugins.map((plugin) => predicate(plugin)).filter((plugin) => !!plugin);
-var resolvePlugin = (plugins, predicate) => filterPlugins(plugins, predicate)[0];
-var PluginContext = class {
-  constructor() {
-    this.ctx = new import_context.Context(void 0, {
-      F: __dxlog_file,
-      L: 50
-    });
-  }
-  init(plugins) {
-    this._plugins = plugins;
-  }
-  getPlugin(id) {
-    (0, import_invariant.invariant)(this._plugins, void 0, {
-      F: __dxlog_file,
-      L: 59,
-      S: this,
-      A: [
-        "this._plugins",
-        ""
-      ]
-    });
-    return getPlugin(this._plugins, id);
-  }
-  resolvePlugin(resolver, required = false) {
-    (0, import_invariant.invariant)(this._plugins, "context not initialized", {
-      F: __dxlog_file,
-      L: 65,
-      S: this,
-      A: [
-        "this._plugins",
-        "'context not initialized'"
-      ]
-    });
-    const plugin = resolvePlugin(this._plugins, resolver);
-    if (required && !plugin) {
-      throw new Error("Plugin not found.");
-    }
-    return plugin;
-  }
-  onDispose(cb) {
-    this.ctx.onDispose(cb);
-  }
-  dispose() {
-    void this.ctx.dispose();
-  }
-};
-var definePlugin = (cb) => {
-  const context = new PluginContext();
-  return () => cb(context);
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  definePlugin,
-  filterPlugins,
-  findPlugin,
-  getPlugin,
-  resolvePlugin
-});
-//# sourceMappingURL=chunk-QBM42OQ6.cjs.map

package/dist/lib/node/chunk-QBM42OQ6.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/helpers.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Context, type DisposeCallback } from '@dxos/context';\nimport { raise } from '@dxos/debug';\nimport { invariant } from '@dxos/invariant';\n\nimport { type Plugin, type PluginDefinition } from './plugin-host';\n\n/**\n * Resolvers allow different instances of plugins to provide a particular capability.\n */\nexport type PluginResolver<T> = (plugin: Plugin) => Plugin<T> | undefined;\n\n/**\n * Find a plugin by ID.\n */\nexport const findPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> | undefined => {\n  return plugins.find(\n    (plugin) => plugin.meta.id === id || (typeof plugin.meta.shortId === 'string' && plugin.meta.shortId === id),\n  ) as Plugin<T>;\n};\n\n/**\n * Find a plugin by ID, or raise an error if not found.\n */\nexport const getPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> => {\n  return findPlugin(plugins, id) ?? raise(new Error(`Plugin not found: ${id}`));\n};\n\n/**\n * Filter a list of plugins to only those that match a predicate.\n */\nexport const filterPlugins = <T>(plugins: Plugin[], predicate: PluginResolver<T>): Plugin<T>[] =>\n  plugins.map((plugin) => predicate(plugin)).filter((plugin): plugin is Plugin<T> => !!plugin);\n\n/**\n * Resolves a plugin by predicate.\n *\n * @example\n * import { parseIntentPlugin, resolvePlugin } from '@dxos/app-framework';\n * const intentPlugin = resolvePlugin(plugins, parseIntentPlugin);\n */\nexport const resolvePlugin = <T>(plugins: Plugin[], predicate: PluginResolver<T>): Plugin<T> | undefined =>\n  filterPlugins(plugins, predicate)[0];\n\nclass PluginContext {\n  // TODO(burdon): Use Resource (@dima)?\n  public readonly ctx = new Context();\n\n  private _plugins?: Plugin[];\n\n  init(plugins: Plugin[]) {\n    this._plugins = plugins;\n  }\n\n  getPlugin<T>(id: string): Plugin<T> {\n    invariant(this._plugins);\n    return getPlugin(this._plugins, id);\n  }\n\n  resolvePlugin<T>(resolver: PluginResolver<T>): Plugin<T>;\n  resolvePlugin<T>(resolver: PluginResolver<T>, required = false): Plugin<T> | undefined {\n    invariant(this._plugins, 'context not initialized');\n    const plugin = resolvePlugin(this._plugins, resolver);\n    if (required && !plugin) {\n      // TODO(burdon): Resolver should have a name.\n      throw new Error('Plugin not found.');\n    }\n\n    return plugin;\n  }\n\n  onDispose(cb: DisposeCallback) {\n    this.ctx.onDispose(cb);\n  }\n\n  dispose() {\n    void this.ctx.dispose();\n  }\n}\n\n/**\n * Plugin helper with dependency injection and life-cycle support.\n */\nexport const definePlugin = <Provides>(\n  cb: (context: PluginContext) => PluginDefinition<Provides>,\n): (() => PluginDefinition<Provides>) => {\n  const context = new PluginContext();\n  return () => cb(context);\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,qBAA8C;AAC9C,mBAAsB;AACtB,uBAA0B;;AAYnB,IAAMA,aAAa,CAAIC,SAAmBC,OAAAA;AAC/C,SAAOD,QAAQE,KACb,CAACC,WAAWA,OAAOC,KAAKH,OAAOA,MAAO,OAAOE,OAAOC,KAAKC,YAAY,YAAYF,OAAOC,KAAKC,YAAYJ,EAAAA;AAE7G;AAKO,IAAMK,YAAY,CAAIN,SAAmBC,OAAAA;AAC9C,SAAOF,WAAWC,SAASC,EAAAA,SAAOM,oBAAM,IAAIC,MAAM,qBAAqBP,EAAAA,EAAI,CAAA;AAC7E;AAKO,IAAMQ,gBAAgB,CAAIT,SAAmBU,cAClDV,QAAQW,IAAI,CAACR,WAAWO,UAAUP,MAAAA,CAAAA,EAASS,OAAO,CAACT,WAAgC,CAAC,CAACA,MAAAA;AAShF,IAAMU,gBAAgB,CAAIb,SAAmBU,cAClDD,cAAcT,SAASU,SAAAA,EAAW,CAAA;AAEpC,IAAMI,gBAAN,MAAMA;EAAN,cAAA;eAEwB,IAAIC,uBAAAA,QAAAA;;;;;EAI1BC,KAAKhB,SAAmB;AACtB,SAAKiB,WAAWjB;EAClB;EAEAM,UAAaL,IAAuB;AAClCiB,oCAAU,KAAKD,UAAQ,QAAA;;;;;;;;;AACvB,WAAOX,UAAU,KAAKW,UAAUhB,EAAAA;EAClC;EAGAY,cAAiBM,UAA6BC,WAAW,OAA8B;AACrFF,oCAAU,KAAKD,UAAU,2BAAA;;;;;;;;;AACzB,UAAMd,SAASU,cAAc,KAAKI,UAAUE,QAAAA;AAC5C,QAAIC,YAAY,CAACjB,QAAQ;AAEvB,YAAM,IAAIK,MAAM,mBAAA;IAClB;AAEA,WAAOL;EACT;EAEAkB,UAAUC,IAAqB;AAC7B,SAAKC,IAAIF,UAAUC,EAAAA;EACrB;EAEAE,UAAU;AACR,SAAK,KAAKD,IAAIC,QAAO;EACvB;AACF;AAKO,IAAMC,eAAe,CAC1BH,OAAAA;AAEA,QAAMI,UAAU,IAAIZ,cAAAA;AACpB,SAAO,MAAMQ,GAAGI,OAAAA;AAClB;",
-  "names": ["findPlugin", "plugins", "id", "find", "plugin", "meta", "shortId", "getPlugin", "raise", "Error", "filterPlugins", "predicate", "map", "filter", "resolvePlugin", "PluginContext", "Context", "init", "_plugins", "invariant", "resolver", "required", "onDispose", "cb", "ctx", "dispose", "definePlugin", "context"]
-}