@dxos/app-framework 0.6.13 → 0.6.14-main.69511f5

package/src/plugins/plugin-settings/SettingsPlugin.tsx

@@ -0,0 +1,22 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { RootSettingsStore } from '@dxos/local-storage';
+
+import SettingsMeta from './meta';
+import { type SettingsPluginProvides } from './provides';
+import { type PluginDefinition } from '../plugin-host';
+
+export const SettingsPlugin = (): PluginDefinition<SettingsPluginProvides> => {
+  // Global settings singleton.
+  // TODO(burdon): Make settings storage extensible so that other plugins can decide the persistence of them.
+  const settingsStore = new RootSettingsStore();
+
+  return {
+    meta: SettingsMeta,
+    provides: {
+      settingsStore,
+    },
+  };
+};

package/src/plugins/plugin-settings/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { SettingsPlugin } from './SettingsPlugin';
+
+export * from './provides';
+
+export default SettingsPlugin;

package/src/plugins/plugin-settings/meta.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+const SettingsMeta = {
+  id: 'dxos.org/plugin/settings',
+};
+
+export default SettingsMeta;

package/src/plugins/plugin-settings/provides.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type SettingsStoreFactory, type SettingsValue } from '@dxos/local-storage';
+
+import { type Plugin } from '../plugin-host';
+
+export type SettingsProvides<T extends SettingsValue> = {
+  settings: T;
+};
+
+export type SettingsPluginProvides = {
+  settingsStore: SettingsStoreFactory;
+};
+
+export const parseSettingsPlugin = (plugin: Plugin) => {
+  return typeof (plugin.provides as any).settingsStore === 'object'
+    ? (plugin as Plugin<SettingsPluginProvides>)
+    : undefined;
+};
+
+const SETTINGS_PLUGIN = 'dxos.org/plugin/settings';
+
+const SETTINGS_ACTION = `${SETTINGS_PLUGIN}/action`;
+
+export enum SettingsAction {
+  OPEN = `${SETTINGS_ACTION}/open`,
+}

package/src/plugins/{SurfacePlugin → plugin-surface}/Surface.tsx

@@ -3,17 +3,22 @@
 //
 
 import React, {
-  forwardRef,
-  type ReactNode,
   Fragment,
   type ForwardedRef,
   type PropsWithChildren,
-  isValidElement,
+  type ReactNode,
   Suspense,
+  createContext,
+  forwardRef,
+  isValidElement,
+  memo,
+  useContext,
+  useEffect,
+  useState,
 } from 'react';
-import { createContext, useContext } from 'react';
 
 import { raise } from '@dxos/debug';
+import { log } from '@dxos/log';
 
 import { ErrorBoundary } from './ErrorBoundary';
 import { type SurfaceComponent, type SurfaceResult, useSurfaceRoot } from './SurfaceRootContext';
@@ -27,6 +32,11 @@ export type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';
  * SurfaceProps are the props that are passed to the Surface component.
  */
 export type SurfaceProps = PropsWithChildren<{
+  /**
+   * Optional ID for debugging.
+   */
+  id?: string;
+
   /**
    * Role defines how the data should be rendered.
    */
@@ -78,33 +88,55 @@ export type SurfaceProps = PropsWithChildren<{
   [key: string]: unknown;
 }>;
 
+let count = 0;
+
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
-export const Surface = forwardRef<HTMLElement, SurfaceProps>(
-  ({ role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
-    const props = { role, name, fallback, ...rest };
-    const context = useContext(SurfaceContext);
-    const data = props.data ?? ((name && context?.surfaces?.[name]?.data) || {});
-
-    const resolver = <SurfaceResolver {...props} ref={forwardedRef} />;
-    const suspense = placeholder ? <Suspense fallback={placeholder}>{resolver}</Suspense> : resolver;
-
-    return fallback ? (
-      <ErrorBoundary data={data} fallback={fallback}>
-        {suspense}
-      </ErrorBoundary>
-    ) : (
-      suspense
-    );
-  },
+export const Surface = memo(
+  forwardRef<HTMLElement, SurfaceProps>(
+    ({ id: _id, role, name = role, fallback, placeholder, ...rest }, forwardedRef) => {
+      const props = { role, name, fallback, ...rest };
+      const { debugInfo } = useSurfaceRoot();
+
+      // Track debug info.
+      const [id] = useState<string>(() => _id ?? `surface-${++count}`);
+      useEffect(() => {
+        debugInfo?.set(id, { id, created: Date.now(), name, role, renderCount: 0 });
+        return () => {
+          debugInfo?.delete(id);
+        };
+      }, [id]);
+
+      if (debugInfo?.get(id)) {
+        debugInfo.get(id)!.renderCount++;
+      }
+
+      const context = useContext(SurfaceContext);
+      const data = props.data ?? ((name && context?.surfaces?.[name]?.data) || {});
+
+      const resolver = <SurfaceResolver {...props} id={id} ref={forwardedRef} />;
+      const suspense = placeholder ? <Suspense fallback={placeholder}>{resolver}</Suspense> : resolver;
+
+      return fallback ? (
+        <ErrorBoundary data={data} fallback={fallback}>
+          {suspense}
+        </ErrorBoundary>
+      ) : (
+        suspense
+      );
+    },
+  ),
 );
 
-const SurfaceContext = createContext<SurfaceProps | null>(null);
+const SurfaceContext = createContext<SurfaceProps | undefined>(undefined);
 
 export const useSurface = (): SurfaceProps =>
   useContext(SurfaceContext) ?? raise(new Error('Surface context not found'));
 
+/**
+ * Root surface component.
+ */
 const SurfaceResolver = forwardRef<HTMLElement, SurfaceProps>((props, forwardedRef) => {
   const { components } = useSurfaceRoot();
   const parent = useContext(SurfaceContext);
@@ -120,10 +152,13 @@ const SurfaceResolver = forwardRef<HTMLElement, SurfaceProps>((props, forwardedR
   return <SurfaceContext.Provider value={currentContext}>{nodes}</SurfaceContext.Provider>;
 });
 
+/**
+ * Resolve surface nodes from across all component.
+ */
 const resolveNodes = (
   components: Record<string, SurfaceComponent>,
   props: SurfaceProps,
-  context: SurfaceProps | null,
+  context: SurfaceProps | undefined,
   forwardedRef: ForwardedRef<HTMLElement>,
 ): ReactNode[] => {
   const data = {
@@ -131,31 +166,30 @@ const resolveNodes = (
     ...props.data,
   };
 
-  const nodes = Object.entries(components)
+  const candidates = Object.entries(components)
     .map(([key, component]): [string, SurfaceResult] | undefined => {
+      // TODO(burdon): Avoid variable return types in plugin contract.
       const result = component({ ...props, data }, forwardedRef);
       if (!result || typeof result !== 'object') {
         return undefined;
       }
 
-      return 'node' in result ? [key, result] : isValidElement(result) ? [key, { node: result }] : undefined;
-    })
-    .filter((result): result is [string, SurfaceResult] => Boolean(result))
-    .sort(([, a], [, b]) => {
-      const aDisposition = a.disposition ?? 'default';
-      const bDisposition = b.disposition ?? 'default';
-
-      if (aDisposition === bDisposition) {
-        return 0;
-      } else if (aDisposition === 'hoist' || bDisposition === 'fallback') {
-        return -1;
-      } else if (bDisposition === 'hoist' || aDisposition === 'fallback') {
-        return 1;
+      // Normalize tuple.
+      if ('node' in result) {
+        return [key, result];
+      } else if (isValidElement(result)) {
+        return [key, { node: result }];
+      } else {
+        log.warn('invalid result', { result });
+        return undefined;
       }
-
-      return 0;
     })
-    .map(([key, result]) => <Fragment key={key}>{result.node}</Fragment>);
+    .filter((result): result is [string, SurfaceResult] => Boolean(result))
+    .sort(([, { disposition: a = 'default' }], [, { disposition: b = 'default' }]) => {
+      return a === b ? 0 : a === 'hoist' || b === 'fallback' ? -1 : b === 'hoist' || a === 'fallback' ? 1 : 0;
+    });
 
+  // TODO(burdon): Does this prematurely process the node?
+  const nodes = candidates.map(([key, result]) => <Fragment key={key}>{result.node}</Fragment>);
   return props.limit ? nodes.slice(0, props.limit) : nodes;
 };

package/src/plugins/{SurfacePlugin/plugin.tsx → plugin-surface/SurfacePlugin.tsx}

@@ -9,14 +9,14 @@ import { create } from '@dxos/echo-schema';
 import { SurfaceProvider, type SurfaceRootContext } from './SurfaceRootContext';
 import SurfaceMeta from './meta';
 import { parseSurfacePlugin, type SurfacePluginProvides } from './provides';
-import type { PluginDefinition } from '../PluginHost';
 import { filterPlugins } from '../helpers';
+import { type PluginDefinition } from '../plugin-host';
 
 /**
  * Provides a registry of surface components.
  */
-const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
-  const state = create<SurfaceRootContext>({ components: {} });
+export const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
+  const state = create<SurfaceRootContext>({ components: {}, debugInfo: new Map() });
 
   return {
     meta: SurfaceMeta,
@@ -31,5 +31,3 @@ const SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {
     },
   };
 };
-
-export default SurfacePlugin;

package/src/plugins/{SurfacePlugin → plugin-surface}/SurfaceRootContext.tsx

@@ -2,7 +2,9 @@
 // Copyright 2023 DXOS.org
 //
 
-import { createContext, useContext, type Context, type JSX, type Provider, type ForwardedRef } from 'react';
+import { createContext, useContext, type JSX, type ForwardedRef } from 'react';
+
+import { raise } from '@dxos/debug';
 
 import { type SurfaceProps } from './Surface';
 
@@ -18,6 +20,16 @@ type SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;
  */
 export type SurfaceDisposition = 'hoist' | 'fallback';
 
+/**
+ * Surface debug info.
+ * NOTE: Short-term measure to track perf issues.
+ */
+export type DebugInfo = {
+  id: string;
+  created: number;
+  renderCount: number;
+} & Pick<SurfaceProps, 'role' | 'name'>;
+
 export type SurfaceResult = {
   node: JSX.Element;
   disposition?: SurfaceDisposition;
@@ -35,10 +47,15 @@ export type SurfaceComponent = (
 
 export type SurfaceRootContext = {
   components: Record<string, SurfaceComponent>;
+
+  /**
+   * Debug info.
+   */
+  debugInfo?: Map<string, DebugInfo>;
 };
 
-const SurfaceRootContext: Context<SurfaceRootContext> = createContext<SurfaceRootContext>({ components: {} });
+const SurfaceRootContext = createContext<SurfaceRootContext | undefined>(undefined);
 
-export const useSurfaceRoot = () => useContext(SurfaceRootContext);
+export const useSurfaceRoot = () => useContext(SurfaceRootContext) ?? raise(new Error('Missing SurfaceRootContext'));
 
-export const SurfaceProvider: Provider<SurfaceRootContext> = SurfaceRootContext.Provider;
+export const SurfaceProvider = SurfaceRootContext.Provider;

package/src/plugins/{SurfacePlugin → plugin-surface}/index.ts

@@ -2,9 +2,13 @@
 // Copyright 2023 DXOS.org
 //
 
+import { SurfacePlugin } from './SurfacePlugin';
+
 export * from './helpers';
 export * from './provides';
 
 export * from './ErrorBoundary';
 export * from './Surface';
 export * from './SurfaceRootContext';
+
+export default SurfacePlugin;

package/src/plugins/{SurfacePlugin → plugin-surface}/provides.ts

@@ -3,8 +3,9 @@
 //
 
 import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
-import { type Plugin } from '../PluginHost';
+import { type Plugin } from '../plugin-host';
 
+// TODO(burdon): Predicate based providers?
 export type SurfaceProvides = {
   surface: {
     /**

package/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../../tsconfig.json",
+  "extends": "../../../tsconfig.base.json",
   "compilerOptions": {
     "esModuleInterop": true,
     "jsx": "react",
@@ -16,35 +16,7 @@
   "include": [
     "src"
   ],
-  "references": [
-    {
-      "path": "../../common/async"
-    },
-    {
-      "path": "../../common/debug"
-    },
-    {
-      "path": "../../common/invariant"
-    },
-    {
-      "path": "../../common/local-storage"
-    },
-    {
-      "path": "../../common/log"
-    },
-    {
-      "path": "../../common/util"
-    },
-    {
-      "path": "../../core/echo/echo-schema"
-    },
-    {
-      "path": "../app-graph"
-    },
-    {
-      "path": "../client-protocol"
-    }
-  ],
+  "references": [],
   "ts-node": {
     "compilerOptions": {
       "module": "CommonJS"

package/vitest.config.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { defineConfig, mergeConfig } from 'vitest/config';
+
+import { baseConfig } from '../../../vitest.shared';
+
+export default mergeConfig(baseConfig({ cwd: __dirname }), defineConfig({}));

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

@@ -1,52 +0,0 @@
-// packages/sdk/app-framework/src/plugins/IntentPlugin/provides.ts
-var parseIntentPlugin = (plugin) => plugin.provides.intent?.dispatch ? plugin : void 0;
-var parseIntentResolverPlugin = (plugin) => plugin.provides.intent?.resolver ? plugin : void 0;
-var INTENT_ACTION = "dxos.org/plugin/intent";
-var IntentAction;
-(function(IntentAction2) {
-  IntentAction2[IntentAction2["SHOW_UNDO"] = `${INTENT_ACTION}/show-undo`] = "SHOW_UNDO";
-})(IntentAction || (IntentAction = {}));
-
-// packages/sdk/app-framework/src/plugins/IntentPlugin/IntentContext.tsx
-import { createContext, useContext } from "react";
-import { useEffect } from "react";
-var IntentContext = /* @__PURE__ */ createContext({
-  dispatch: async () => ({}),
-  undo: async () => ({}),
-  history: [],
-  registerResolver: () => () => {
-  }
-});
-var useIntent = () => useContext(IntentContext);
-var useIntentDispatcher = () => {
-  const { dispatch } = useIntent();
-  return dispatch;
-};
-var useIntentResolver = (plugin, resolver) => {
-  const { registerResolver } = useIntent();
-  useEffect(() => {
-    return registerResolver(plugin, resolver);
-  }, [
-    plugin,
-    resolver
-  ]);
-};
-var IntentProvider = IntentContext.Provider;
-
-// packages/sdk/app-framework/src/plugins/IntentPlugin/meta.ts
-var IntentMeta = {
-  id: "dxos.org/plugin/intent"
-};
-var meta_default = IntentMeta;
-
-export {
-  parseIntentPlugin,
-  parseIntentResolverPlugin,
-  IntentAction,
-  useIntent,
-  useIntentDispatcher,
-  useIntentResolver,
-  IntentProvider,
-  meta_default
-};
-//# sourceMappingURL=chunk-J45KR4DI.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/IntentPlugin/provides.ts", "../../../src/plugins/IntentPlugin/IntentContext.tsx", "../../../src/plugins/IntentPlugin/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type IntentContext } from './IntentContext';\nimport { type IntentResolver } from './intent';\nimport { type Plugin } from '../PluginHost';\n\nexport type IntentResolverProvides = {\n  intent: {\n    resolver: IntentResolver;\n  };\n};\n\nexport type IntentPluginProvides = {\n  intent: IntentContext;\n};\n\nexport const parseIntentPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.dispatch ? (plugin as Plugin<IntentPluginProvides>) : undefined;\n\nexport const parseIntentResolverPlugin = (plugin: Plugin) =>\n  (plugin.provides as any).intent?.resolver ? (plugin as Plugin<IntentResolverProvides>) : undefined;\n\n//\n// Intents\n//\n\nconst INTENT_ACTION = 'dxos.org/plugin/intent';\nexport enum IntentAction {\n  /**\n   * Fired after an intent is dispatched if the intent is undoable.\n   */\n  SHOW_UNDO = `${INTENT_ACTION}/show-undo`,\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context, createContext, useContext, type Provider } from 'react';\nimport { useEffect } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport type { Intent, IntentDispatcher, IntentResolver, IntentResult } from './intent';\n\nexport type IntentExecution = {\n  intent: Intent;\n  result: IntentResult;\n};\n\nexport type IntentContext = {\n  dispatch: IntentDispatcher;\n  undo: () => Promise<IntentResult | void>;\n  history: IntentExecution[][];\n  registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;\n};\n\nconst IntentContext: Context<IntentContext> = createContext<IntentContext>({\n  dispatch: async () => ({}),\n  undo: async () => ({}),\n  history: [],\n  registerResolver: () => () => {},\n});\n\n/**\n * @deprecated Prefer granular hooks.\n */\n// TODO(burdon): Remove. Use useIntentDispatcher.\nexport const useIntent = () => useContext(IntentContext);\n\nexport const useIntentDispatcher = (): IntentDispatcher => {\n  const { dispatch } = useIntent();\n  return dispatch;\n};\n\nexport const useIntentResolver = (plugin: string, resolver: IntentResolver) => {\n  const { registerResolver } = useIntent();\n  useEffect(() => {\n    return registerResolver(plugin, resolver);\n  }, [plugin, resolver]);\n};\n\nexport const IntentProvider: Provider<IntentContext> = IntentContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst IntentMeta = {\n  id: 'dxos.org/plugin/intent',\n};\n\nexport default IntentMeta;\n"],
-  "mappings": ";AAkBO,IAAMA,oBAAoB,CAACC,WAC/BA,OAAOC,SAAiBC,QAAQC,WAAYH,SAA0CI;AAElF,IAAMC,4BAA4B,CAACL,WACvCA,OAAOC,SAAiBC,QAAQI,WAAYN,SAA4CI;AAM3F,IAAMG,gBAAgB;;UACVC,eAAAA;AAGT,EAAAA,cAAAA,cAAA,WAAA,IACW,GAAGD,aAAAA,YAAyB,IAAA;GAJ9BC,iBAAAA,eAAAA,CAAAA,EAAAA;;;ACzBZ,SAAuBC,eAAeC,kBAAiC;AACvE,SAASC,iBAAiB;AAkB1B,IAAMC,gBAAwCC,8BAA6B;EACzEC,UAAU,aAAa,CAAC;EACxBC,MAAM,aAAa,CAAC;EACpBC,SAAS,CAAA;EACTC,kBAAkB,MAAM,MAAA;EAAO;AACjC,CAAA;AAMO,IAAMC,YAAY,MAAMC,WAAWP,aAAAA;AAEnC,IAAMQ,sBAAsB,MAAA;AACjC,QAAM,EAAEN,SAAQ,IAAKI,UAAAA;AACrB,SAAOJ;AACT;AAEO,IAAMO,oBAAoB,CAACC,QAAgBC,aAAAA;AAChD,QAAM,EAAEN,iBAAgB,IAAKC,UAAAA;AAC7BM,YAAU,MAAA;AACR,WAAOP,iBAAiBK,QAAQC,QAAAA;EAClC,GAAG;IAACD;IAAQC;GAAS;AACvB;AAEO,IAAME,iBAA0Cb,cAAcc;;;AC5CrE,IAAMC,aAAa;EACjBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["parseIntentPlugin", "plugin", "provides", "intent", "dispatch", "undefined", "parseIntentResolverPlugin", "resolver", "INTENT_ACTION", "IntentAction", "createContext", "useContext", "useEffect", "IntentContext", "createContext", "dispatch", "undo", "history", "registerResolver", "useIntent", "useContext", "useIntentDispatcher", "useIntentResolver", "plugin", "resolver", "useEffect", "IntentProvider", "Provider", "IntentMeta", "id"]
-}

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

@@ -1,20 +0,0 @@
-// packages/sdk/app-framework/src/plugins/helpers.ts
-import { raise } from "@dxos/debug";
-var definePlugin = (plugin) => plugin;
-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) ?? 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];
-
-export {
-  definePlugin,
-  findPlugin,
-  getPlugin,
-  filterPlugins,
-  resolvePlugin
-};
-//# sourceMappingURL=chunk-S5CI6EUQ.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/helpers.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { raise } from '@dxos/debug';\n\nimport { type Plugin } from './PluginHost';\n\n/**\n * Define a plugin\n */\nexport const definePlugin = <TProvides>(plugin: Plugin<TProvides>): Plugin<TProvides> => plugin;\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>(\n  plugins: Plugin[],\n  predicate: (plugin: Plugin) => Plugin<T> | undefined,\n): Plugin<T>[] => 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>(\n  plugins: Plugin[],\n  predicate: (plugin: Plugin) => Plugin<T> | undefined,\n): Plugin<T> | undefined => filterPlugins(plugins, predicate)[0];\n"],
-  "mappings": ";AAIA,SAASA,aAAa;AAOf,IAAMC,eAAe,CAAYC,WAAiDA;AAKlF,IAAMC,aAAa,CAAIC,SAAmBC,OAAAA;AAC/C,SAAOD,QAAQE,KACb,CAACJ,WAAWA,OAAOK,KAAKF,OAAOA,MAAO,OAAOH,OAAOK,KAAKC,YAAY,YAAYN,OAAOK,KAAKC,YAAYH,EAAAA;AAE7G;AAKO,IAAMI,YAAY,CAAIL,SAAmBC,OAAAA;AAC9C,SAAOF,WAAWC,SAASC,EAAAA,KAAOK,MAAM,IAAIC,MAAM,qBAAqBN,EAAAA,EAAI,CAAA;AAC7E;AAKO,IAAMO,gBAAgB,CAC3BR,SACAS,cACgBT,QAAQU,IAAI,CAACZ,WAAWW,UAAUX,MAAAA,CAAAA,EAASa,OAAO,CAACb,WAAgC,CAAC,CAACA,MAAAA;AAShG,IAAMc,gBAAgB,CAC3BZ,SACAS,cAC0BD,cAAcR,SAASS,SAAAA,EAAW,CAAA;",
-  "names": ["raise", "definePlugin", "plugin", "findPlugin", "plugins", "id", "find", "meta", "shortId", "getPlugin", "raise", "Error", "filterPlugins", "predicate", "map", "filter", "resolvePlugin"]
-}

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

@@ -1,26 +0,0 @@
-// packages/sdk/app-framework/src/plugins/SurfacePlugin/provides.ts
-var parseRootSurfacePlugin = (plugin) => plugin?.provides?.surface?.components ? plugin : void 0;
-var parseSurfacePlugin = (plugin) => plugin?.provides?.surface?.component ? plugin : void 0;
-
-// packages/sdk/app-framework/src/plugins/SurfacePlugin/SurfaceRootContext.tsx
-import { createContext, useContext } from "react";
-var SurfaceRootContext = /* @__PURE__ */ createContext({
-  components: {}
-});
-var useSurfaceRoot = () => useContext(SurfaceRootContext);
-var SurfaceProvider = SurfaceRootContext.Provider;
-
-// packages/sdk/app-framework/src/plugins/SurfacePlugin/meta.ts
-var SurfaceMeta = {
-  id: "dxos.org/plugin/surface"
-};
-var meta_default = SurfaceMeta;
-
-export {
-  parseRootSurfacePlugin,
-  parseSurfacePlugin,
-  useSurfaceRoot,
-  SurfaceProvider,
-  meta_default
-};
-//# sourceMappingURL=chunk-YYV26N3W.mjs.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/provides.ts", "../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx", "../../../src/plugins/SurfacePlugin/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';\nimport { type Plugin } from '../PluginHost';\n\nexport type SurfaceProvides = {\n  surface: {\n    /**\n     * Used by the `Surface` resolver to find a component to render.\n     */\n    component: SurfaceComponent;\n  };\n};\n\nexport type SurfacePluginProvides = {\n  surface: SurfaceRootContext;\n};\n\nexport const parseRootSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.components ? (plugin as Plugin<SurfacePluginProvides>) : undefined;\n\nexport const parseSurfacePlugin = (plugin?: Plugin) =>\n  (plugin?.provides as any)?.surface?.component ? (plugin as Plugin<SurfaceProvides>) : undefined;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { createContext, useContext, type Context, type JSX, type Provider, type ForwardedRef } from 'react';\n\nimport { type SurfaceProps } from './Surface';\n\n// TODO(wittjosiah): Factor out.\ntype WithRequiredProperty<Type, Key extends keyof Type> = Type & {\n  [Property in Key]-?: Type[Property];\n};\n\ntype SurfaceComponentProps = WithRequiredProperty<SurfaceProps, 'data'>;\n\n/**\n * Determines the priority of the surface when multiple components are resolved.\n */\nexport type SurfaceDisposition = 'hoist' | 'fallback';\n\nexport type SurfaceResult = {\n  node: JSX.Element;\n  disposition?: SurfaceDisposition;\n};\n\n/**\n * Function which resolves a Surface.\n *\n * If a null value is returned, the rendering is deferred to other plugins.\n */\nexport type SurfaceComponent = (\n  props: SurfaceComponentProps,\n  forwardedRef: ForwardedRef<HTMLElement>,\n) => JSX.Element | SurfaceResult | null;\n\nexport type SurfaceRootContext = {\n  components: Record<string, SurfaceComponent>;\n};\n\nconst SurfaceRootContext: Context<SurfaceRootContext> = createContext<SurfaceRootContext>({ components: {} });\n\nexport const useSurfaceRoot = () => useContext(SurfaceRootContext);\n\nexport const SurfaceProvider: Provider<SurfaceRootContext> = SurfaceRootContext.Provider;\n", "//\n// Copyright 2023 DXOS.org\n//\n\nconst SurfaceMeta = {\n  id: 'dxos.org/plugin/surface',\n};\n\nexport default SurfaceMeta;\n"],
-  "mappings": ";AAoBO,IAAMA,yBAAyB,CAACC,WACpCA,QAAQC,UAAkBC,SAASC,aAAcH,SAA2CI;AAExF,IAAMC,qBAAqB,CAACL,WAChCA,QAAQC,UAAkBC,SAASI,YAAaN,SAAqCI;;;ACpBxF,SAASG,eAAeC,kBAA4E;AAmCpG,IAAMC,qBAAkDC,8BAAkC;EAAEC,YAAY,CAAC;AAAE,CAAA;AAEpG,IAAMC,iBAAiB,MAAMC,WAAWJ,kBAAAA;AAExC,IAAMK,kBAAgDL,mBAAmBM;;;ACvChF,IAAMC,cAAc;EAClBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["parseRootSurfacePlugin", "plugin", "provides", "surface", "components", "undefined", "parseSurfacePlugin", "component", "createContext", "useContext", "SurfaceRootContext", "createContext", "components", "useSurfaceRoot", "useContext", "SurfaceProvider", "Provider", "SurfaceMeta", "id"]
-}

package/dist/lib/browser/plugin-K3KCPCTJ.mjs

@@ -1,39 +0,0 @@
-import {
-  SurfaceProvider,
-  meta_default,
-  parseSurfacePlugin
-} from "./chunk-YYV26N3W.mjs";
-import {
-  filterPlugins
-} from "./chunk-S5CI6EUQ.mjs";
-
-// packages/sdk/app-framework/src/plugins/SurfacePlugin/plugin.tsx
-import React from "react";
-import { create } from "@dxos/echo-schema";
-var SurfacePlugin = () => {
-  const state = create({
-    components: {}
-  });
-  return {
-    meta: meta_default,
-    ready: async (plugins) => {
-      state.components = filterPlugins(plugins, parseSurfacePlugin).reduce((acc, plugin) => {
-        return {
-          ...acc,
-          [plugin.meta.id]: plugin.provides.surface.component
-        };
-      }, {});
-    },
-    provides: {
-      surface: state,
-      context: ({ children }) => /* @__PURE__ */ React.createElement(SurfaceProvider, {
-        value: state
-      }, children)
-    }
-  };
-};
-var plugin_default = SurfacePlugin;
-export {
-  plugin_default as default
-};
-//# sourceMappingURL=plugin-K3KCPCTJ.mjs.map

package/dist/lib/browser/plugin-K3KCPCTJ.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/SurfacePlugin/plugin.tsx"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { create } from '@dxos/echo-schema';\n\nimport { SurfaceProvider, type SurfaceRootContext } from './SurfaceRootContext';\nimport SurfaceMeta from './meta';\nimport { parseSurfacePlugin, type SurfacePluginProvides } from './provides';\nimport type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins } from '../helpers';\n\n/**\n * Provides a registry of surface components.\n */\nconst SurfacePlugin = (): PluginDefinition<SurfacePluginProvides> => {\n  const state = create<SurfaceRootContext>({ components: {} });\n\n  return {\n    meta: SurfaceMeta,\n    ready: async (plugins) => {\n      state.components = filterPlugins(plugins, parseSurfacePlugin).reduce((acc, plugin) => {\n        return { ...acc, [plugin.meta.id]: plugin.provides.surface.component };\n      }, {});\n    },\n    provides: {\n      surface: state,\n      context: ({ children }) => <SurfaceProvider value={state}>{children}</SurfaceProvider>,\n    },\n  };\n};\n\nexport default SurfacePlugin;\n"],
-  "mappings": ";;;;;;;;;;AAIA,OAAOA,WAAW;AAElB,SAASC,cAAc;AAWvB,IAAMC,gBAAgB,MAAA;AACpB,QAAMC,QAAQC,OAA2B;IAAEC,YAAY,CAAC;EAAE,CAAA;AAE1D,SAAO;IACLC,MAAMC;IACNC,OAAO,OAAOC,YAAAA;AACZN,YAAME,aAAaK,cAAcD,SAASE,kBAAAA,EAAoBC,OAAO,CAACC,KAAKC,WAAAA;AACzE,eAAO;UAAE,GAAGD;UAAK,CAACC,OAAOR,KAAKS,EAAE,GAAGD,OAAOE,SAASC,QAAQC;QAAU;MACvE,GAAG,CAAC,CAAA;IACN;IACAF,UAAU;MACRC,SAASd;MACTgB,SAAS,CAAC,EAAEC,SAAQ,MAAO,sBAAA,cAACC,iBAAAA;QAAgBC,OAAOnB;SAAQiB,QAAAA;IAC7D;EACF;AACF;AAEA,IAAA,iBAAelB;",
-  "names": ["React", "create", "SurfacePlugin", "state", "create", "components", "meta", "SurfaceMeta", "ready", "plugins", "filterPlugins", "parseSurfacePlugin", "reduce", "acc", "plugin", "id", "provides", "surface", "component", "context", "children", "SurfaceProvider", "value"]
-}

package/dist/lib/browser/plugin-MM66VRCO.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/IntentPlugin/plugin.tsx", "../../../src/plugins/IntentPlugin/helpers.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { create } from '@dxos/echo-schema';\nimport { log } from '@dxos/log';\n\nimport { type IntentContext, IntentProvider, type IntentExecution } from './IntentContext';\nimport { isUndoable } from './helpers';\nimport type { Intent, IntentResolver } from './intent';\nimport IntentMeta from './meta';\nimport {\n  type IntentPluginProvides,\n  type IntentResolverProvides,\n  parseIntentResolverPlugin,\n  IntentAction,\n} from './provides';\nimport type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins, findPlugin } from '../helpers';\n\nconst EXECUTION_LIMIT = 1000;\nconst HISTORY_LIMIT = 100;\n\n/**\n * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.\n * Inspired by https://developer.android.com/reference/android/content/Intent.\n */\nconst IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {\n  const state = create<IntentContext>({\n    dispatch: async () => ({}),\n    undo: async () => ({}),\n    history: [],\n    registerResolver: () => () => {},\n  });\n\n  const dynamicResolvers = new Set<{ plugin: string; resolver: IntentResolver }>();\n\n  return {\n    meta: IntentMeta,\n    ready: async (plugins) => {\n      // Dispatch intent to associated plugin.\n      const dispatch = async (intent: Intent) => {\n        log('dispatch', { action: intent.action, intent });\n        if (intent.plugin) {\n          for (const entry of dynamicResolvers) {\n            if (entry.plugin === intent.plugin) {\n              const result = await entry.resolver(intent, plugins);\n              if (result) {\n                return result;\n              }\n            }\n          }\n\n          const plugin = findPlugin<IntentResolverProvides>(plugins, intent.plugin);\n          const result = plugin?.provides.intent.resolver(intent, plugins);\n          return result;\n        }\n\n        for (const entry of dynamicResolvers) {\n          const result = await entry.resolver(intent, plugins);\n          if (result) {\n            return result;\n          }\n        }\n\n        // Return resolved value from first plugin that handles the intent.\n        for (const plugin of filterPlugins(plugins, parseIntentResolverPlugin)) {\n          const result = await plugin.provides.intent.resolver(intent, plugins);\n          if (result) {\n            return result;\n          }\n        }\n\n        // https://vitejs.dev/guide/env-and-mode#env-variables\n        // TODO(wittjosiah): How to handle this more generically?\n        if (import.meta?.env?.DEV) {\n          log.warn('No plugin found to handle intent', intent);\n        }\n      };\n\n      // Sequentially dispatch array of invents.\n      const dispatchChain = async (intentOrArray: Intent | Intent[], depth = 0) => {\n        if (depth > EXECUTION_LIMIT) {\n          return {\n            error: new Error(\n              `Intent execution limit exceeded (${EXECUTION_LIMIT} iterations). This is likely due to an infinite loop within intent resolvers.`,\n            ),\n          };\n        }\n\n        const executionResults: IntentExecution[] = [];\n        const chain = Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray];\n        for (const intent of chain) {\n          const { result: prevResult } = executionResults.at(-1) ?? {};\n          const data = intent.data ? { result: prevResult?.data, ...intent.data } : prevResult?.data;\n          const result = await dispatch({ ...intent, data });\n\n          if (!result || result?.error) {\n            break;\n          }\n\n          executionResults.push({ intent, result });\n\n          // TODO(wittjosiah): How does undo work with returned intents?\n          result?.intents?.forEach((intents) => {\n            void dispatchChain(intents, depth + 1);\n          });\n        }\n\n        state.history.push(executionResults);\n        if (state.history.length > HISTORY_LIMIT) {\n          state.history.splice(0, state.history.length - HISTORY_LIMIT);\n        }\n\n        if (isUndoable(executionResults)) {\n          void dispatch({ action: IntentAction.SHOW_UNDO, data: { results: executionResults } });\n        }\n\n        return executionResults.at(-1)?.result;\n      };\n\n      const undo = async () => {\n        const last = state.history.findLastIndex(isUndoable);\n        const chain =\n          last !== -1 &&\n          state.history[last]?.map(({ intent, result }): Intent => {\n            const data = result.undoable?.data ? { ...intent.data, ...result.undoable.data } : intent.data;\n            return { ...intent, data, undo: true };\n          });\n        if (chain) {\n          const result = await dispatchChain(chain);\n          state.history = state.history.filter((_, index) => index !== last);\n          return result;\n        }\n      };\n\n      state.dispatch = dispatchChain;\n      state.undo = undo;\n      state.registerResolver = (plugin, resolver) => {\n        const entry = { plugin, resolver };\n        dynamicResolvers.add(entry);\n        return () => dynamicResolvers.delete(entry);\n      };\n    },\n    provides: {\n      intent: state,\n      context: ({ children }) => <IntentProvider value={state}>{children}</IntentProvider>,\n    },\n  };\n};\n\nexport default IntentPlugin;\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type IntentExecution } from './IntentContext';\n\n/**\n * Check if the chain of intents is undoable.\n */\nexport const isUndoable = (chain: IntentExecution[]): boolean =>\n  chain.length > 0 && chain.every(({ result }) => result.undoable);\n"],
-  "mappings": "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",
-  "names": ["React", "create", "log", "isUndoable", "chain", "length", "every", "result", "undoable", "EXECUTION_LIMIT", "HISTORY_LIMIT", "IntentPlugin", "state", "create", "dispatch", "undo", "history", "registerResolver", "dynamicResolvers", "Set", "meta", "IntentMeta", "ready", "plugins", "intent", "log", "action", "plugin", "entry", "result", "resolver", "findPlugin", "provides", "filterPlugins", "parseIntentResolverPlugin", "env", "DEV", "warn", "dispatchChain", "intentOrArray", "depth", "error", "Error", "executionResults", "chain", "Array", "isArray", "prevResult", "at", "data", "push", "intents", "forEach", "length", "splice", "isUndoable", "IntentAction", "SHOW_UNDO", "results", "last", "findLastIndex", "map", "undoable", "filter", "_", "index", "add", "delete", "context", "children", "IntentProvider", "value"]
-}

package/dist/lib/node/chunk-62W6CMGM.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/helpers.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { raise } from '@dxos/debug';\n\nimport { type Plugin } from './PluginHost';\n\n/**\n * Define a plugin\n */\nexport const definePlugin = <TProvides>(plugin: Plugin<TProvides>): Plugin<TProvides> => plugin;\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>(\n  plugins: Plugin[],\n  predicate: (plugin: Plugin) => Plugin<T> | undefined,\n): Plugin<T>[] => 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>(\n  plugins: Plugin[],\n  predicate: (plugin: Plugin) => Plugin<T> | undefined,\n): Plugin<T> | undefined => filterPlugins(plugins, predicate)[0];\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,mBAAsB;AAOf,IAAMA,eAAe,CAAYC,WAAiDA;AAKlF,IAAMC,aAAa,CAAIC,SAAmBC,OAAAA;AAC/C,SAAOD,QAAQE,KACb,CAACJ,WAAWA,OAAOK,KAAKF,OAAOA,MAAO,OAAOH,OAAOK,KAAKC,YAAY,YAAYN,OAAOK,KAAKC,YAAYH,EAAAA;AAE7G;AAKO,IAAMI,YAAY,CAAIL,SAAmBC,OAAAA;AAC9C,SAAOF,WAAWC,SAASC,EAAAA,SAAOK,oBAAM,IAAIC,MAAM,qBAAqBN,EAAAA,EAAI,CAAA;AAC7E;AAKO,IAAMO,gBAAgB,CAC3BR,SACAS,cACgBT,QAAQU,IAAI,CAACZ,WAAWW,UAAUX,MAAAA,CAAAA,EAASa,OAAO,CAACb,WAAgC,CAAC,CAACA,MAAAA;AAShG,IAAMc,gBAAgB,CAC3BZ,SACAS,cAC0BD,cAAcR,SAASS,SAAAA,EAAW,CAAA;",
-  "names": ["definePlugin", "plugin", "findPlugin", "plugins", "id", "find", "meta", "shortId", "getPlugin", "raise", "Error", "filterPlugins", "predicate", "map", "filter", "resolvePlugin"]
-}