@dxos/app-framework 0.4.2 → 0.4.3-main.c3bfede

package/dist/types/src/plugins/IntentPlugin/provides.d.ts

@@ -11,4 +11,10 @@ export type IntentPluginProvides = {
 };
 export declare const parseIntentPlugin: (plugin: Plugin) => Plugin<IntentPluginProvides> | undefined;
 export declare const parseIntentResolverPlugin: (plugin: Plugin) => Plugin<IntentResolverProvides> | undefined;
+export declare enum IntentAction {
+    /**
+     * Fired after an intent is dispatched if the intent is undoable.
+     */
+    SHOW_UNDO = "dxos.org/plugin/intent/show-undo"
+}
 //# sourceMappingURL=provides.d.ts.map

package/dist/types/src/plugins/IntentPlugin/provides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE;QACN,QAAQ,EAAE,cAAc,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,6CACkD,CAAC;AAEnG,eAAO,MAAM,yBAAyB,WAAY,MAAM,+CAC4C,CAAC"}
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/provides.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE;QACN,QAAQ,EAAE,cAAc,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,6CACkD,CAAC;AAEnG,eAAO,MAAM,yBAAyB,WAAY,MAAM,+CAC4C,CAAC;AAOrG,oBAAY,YAAY;IACtB;;OAEG;IACH,SAAS,qCAA+B;CACzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.4.2",
+  "version": "0.4.3-main.c3bfede",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,13 +16,13 @@
     "@preact/signals-react": "^1.3.6",
     "deepsignal": "1.4.0-shallow.0",
     "zod": "^3.22.4",
-    "@dxos/app-graph": "0.4.2",
-    "@dxos/async": "0.4.2",
-    "@dxos/debug": "0.4.2",
-    "@dxos/local-storage": "0.4.2",
-    "@dxos/invariant": "0.4.2",
-    "@dxos/util": "0.4.2",
-    "@dxos/log": "0.4.2"
+    "@dxos/async": "0.4.3-main.c3bfede",
+    "@dxos/app-graph": "0.4.3-main.c3bfede",
+    "@dxos/local-storage": "0.4.3-main.c3bfede",
+    "@dxos/debug": "0.4.3-main.c3bfede",
+    "@dxos/util": "0.4.3-main.c3bfede",
+    "@dxos/invariant": "0.4.3-main.c3bfede",
+    "@dxos/log": "0.4.3-main.c3bfede"
   },
   "devDependencies": {
     "@types/react": "^18.0.21",

package/src/plugins/IntentPlugin/IntentContext.tsx

@@ -5,27 +5,36 @@
 import { type Context, createContext, useContext, type Provider } from 'react';
 import { useEffect } from 'react';
 
-import { type UnsubscribeCallback } from '@dxos/async';
+import type { UnsubscribeCallback } from '@dxos/async';
 
-import { type IntentDispatcher, type IntentResolver } from './intent';
+import type { Intent, IntentDispatcher, IntentResolver, IntentResult } from './intent';
+
+export type IntentExecution = {
+  intent: Intent;
+  result: IntentResult;
+};
 
 export type IntentContext = {
   dispatch: IntentDispatcher;
+  undo: () => Promise<IntentResult | void>;
+  history: IntentExecution[][];
   registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;
 };
 
 const IntentContext: Context<IntentContext> = createContext<IntentContext>({
   dispatch: async () => ({}),
+  undo: async () => ({}),
+  history: [],
   registerResolver: () => () => {},
 });
 
 /**
- * @deprecated
- * TODO(burdon): Use useIntentDispatcher.
+ * @deprecated Prefer granular hooks.
+ * TODO(burdon): Remove. Use useIntentDispatcher.
  */
 export const useIntent = () => useContext(IntentContext);
 
-// TODO(burdon): Dispatch or Dispatcher?
+// TODO(burdon): Rename useIntentDispatch.
 export const useIntentDispatcher = (): IntentDispatcher => {
   const { dispatch } = useIntent();
   return dispatch;

package/src/plugins/IntentPlugin/helpers.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type IntentExecution } from './IntentContext';
+
+/**
+ * Check if the chain of intents is undoable.
+ */
+export const isUndoable = (chain: IntentExecution[]): boolean =>
+  chain.length > 0 && chain.every(({ result }) => result.undoable);

package/src/plugins/IntentPlugin/intent.ts

@@ -30,6 +30,11 @@ export type Intent = {
    */
   action: string;
 
+  /**
+   * Whether or not the intent is being undone.
+   */
+  undo?: boolean;
+
   /**
    * Any data needed to perform the desired action.
    */
@@ -44,6 +49,21 @@ export type IntentResult = {
    */
   data?: any;
 
+  /**
+   * If provided, the action will be undoable.
+   */
+  undoable?: {
+    /**
+     * Message to display to the user when indicating that the action can be undone.
+     */
+    message: string;
+
+    /**
+     * Will be merged with the original intent data when firing the undo intent.
+     */
+    data?: IntentData;
+  };
+
   /**
    * An error that occurred while performing the action.
    *

package/src/plugins/IntentPlugin/plugin.tsx

@@ -7,21 +7,33 @@ import React from 'react';
 
 import { log } from '@dxos/log';
 
-import { type IntentContext, IntentProvider } from './IntentContext';
-import type { Intent, IntentResolver, IntentResult } from './intent';
+import { type IntentContext, IntentProvider, type IntentExecution } from './IntentContext';
+import { isUndoable } from './helpers';
+import type { Intent, IntentResolver } from './intent';
 import IntentMeta from './meta';
-import { type IntentPluginProvides, type IntentResolverProvides, parseIntentResolverPlugin } from './provides';
+import {
+  type IntentPluginProvides,
+  type IntentResolverProvides,
+  parseIntentResolverPlugin,
+  IntentAction,
+} from './provides';
 import type { PluginDefinition } from '../PluginHost';
 import { filterPlugins, findPlugin } from '../helpers';
 
 const EXECUTION_LIMIT = 1000;
+const HISTORY_LIMIT = 100;
 
 /**
  * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.
  * Inspired by https://developer.android.com/reference/android/content/Intent.
  */
 const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {
-  const state = deepSignal<IntentContext>({ dispatch: async () => ({}), registerResolver: () => () => {} });
+  const state = deepSignal<IntentContext>({
+    dispatch: async () => ({}),
+    undo: async () => ({}),
+    history: [],
+    registerResolver: () => () => {},
+  });
 
   const dynamicResolvers = new Set<{ plugin: string; resolver: IntentResolver }>();
 
@@ -77,24 +89,51 @@ const IntentPlugin = (): PluginDefinition<IntentPluginProvides> => {
           };
         }
 
-        let result: IntentResult | undefined;
-        for (const intent of Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray]) {
-          const data = intent.data ? { result: result?.data, ...intent.data } : result?.data;
-          result = (await dispatch({ ...intent, data })) ?? undefined;
+        const executionResults: IntentExecution[] = [];
+        const chain = Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray];
+        for (const intent of chain) {
+          const { result: prevResult } = executionResults.at(-1) ?? {};
+          const data = intent.data ? { result: prevResult?.data, ...intent.data } : prevResult?.data;
+          const result = await dispatch({ ...intent, data });
 
-          if (result?.error) {
+          if (!result || result?.error) {
             break;
           }
 
+          executionResults.push({ intent, result });
+
+          // TODO(wittjosiah): How does undo work with returned intents?
           result?.intents?.forEach((intents) => {
             void dispatchChain(intents, depth + 1);
           });
         }
 
-        return result;
+        state.history = [...state.history.slice(0, HISTORY_LIMIT - 2), executionResults];
+
+        if (isUndoable(executionResults)) {
+          void dispatch({ action: IntentAction.SHOW_UNDO, data: { results: executionResults } });
+        }
+
+        return executionResults.at(-1)?.result;
+      };
+
+      const undo = async () => {
+        const last = state.history.findLastIndex(isUndoable);
+        const chain =
+          last !== -1 &&
+          state.history[last]?.map(({ intent, result }): Intent => {
+            const data = result.undoable?.data ? { ...intent.data, ...result.undoable.data } : intent.data;
+            return { ...intent, data, undo: true };
+          });
+        if (chain) {
+          const result = await dispatchChain(chain);
+          state.history = state.history.filter((_, index) => index !== last);
+          return result;
+        }
       };
 
       state.dispatch = dispatchChain;
+      state.undo = undo;
       state.registerResolver = (plugin, resolver) => {
         const entry = { plugin, resolver };
         dynamicResolvers.add(entry);

package/src/plugins/IntentPlugin/provides.ts

@@ -21,3 +21,15 @@ export const parseIntentPlugin = (plugin: Plugin) =>
 
 export const parseIntentResolverPlugin = (plugin: Plugin) =>
   (plugin.provides as any).intent?.resolver ? (plugin as Plugin<IntentResolverProvides>) : undefined;
+
+//
+// Intents
+//
+
+const INTENT_ACTION = 'dxos.org/plugin/intent';
+export enum IntentAction {
+  /**
+   * Fired after an intent is dispatched if the intent is undoable.
+   */
+  SHOW_UNDO = `${INTENT_ACTION}/show-undo`,
+}

package/dist/lib/browser/chunk-7MQ2DVDI.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// 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 IntentDispatcher, type IntentResolver } from './intent';\n\nexport type IntentContext = {\n  dispatch: IntentDispatcher;\n  registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;\n};\n\nconst IntentContext: Context<IntentContext> = createContext<IntentContext>({\n  dispatch: async () => ({}),\n  registerResolver: () => () => {},\n});\n\n/**\n * @deprecated\n * TODO(burdon): Use useIntentDispatcher.\n */\nexport const useIntent = () => useContext(IntentContext);\n\n// TODO(burdon): Dispatch or Dispatcher?\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;;;AClB3F,SAAuBG,eAAeC,kBAAiC;AACvE,SAASC,iBAAiB;AAW1B,IAAMC,gBAAwCC,8BAA6B;EACzEC,UAAU,aAAa,CAAC;EACxBC,kBAAkB,MAAM,MAAA;EAAO;AACjC,CAAA;AAMO,IAAMC,YAAY,MAAMC,WAAWL,aAAAA;AAGnC,IAAMM,sBAAsB,MAAA;AACjC,QAAM,EAAEJ,SAAQ,IAAKE,UAAAA;AACrB,SAAOF;AACT;AAEO,IAAMK,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,iBAA0CX,cAAcY;;;ACpCrE,IAAMC,aAAa;EACjBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["parseIntentPlugin", "plugin", "provides", "intent", "dispatch", "undefined", "parseIntentResolverPlugin", "resolver", "createContext", "useContext", "useEffect", "IntentContext", "createContext", "dispatch", "registerResolver", "useIntent", "useContext", "useIntentDispatcher", "useIntentResolver", "plugin", "resolver", "useEffect", "IntentProvider", "Provider", "IntentMeta", "id"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/IntentPlugin/plugin.tsx"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\nimport React from 'react';\n\nimport { log } from '@dxos/log';\n\nimport { type IntentContext, IntentProvider } from './IntentContext';\nimport type { Intent, IntentResolver, IntentResult } from './intent';\nimport IntentMeta from './meta';\nimport { type IntentPluginProvides, type IntentResolverProvides, parseIntentResolverPlugin } from './provides';\nimport type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins, findPlugin } from '../helpers';\n\nconst EXECUTION_LIMIT = 1000;\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 = deepSignal<IntentContext>({ dispatch: async () => ({}), registerResolver: () => () => {} });\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        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        let result: IntentResult | undefined;\n        for (const intent of Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray]) {\n          const data = intent.data ? { result: result?.data, ...intent.data } : result?.data;\n          result = (await dispatch({ ...intent, data })) ?? undefined;\n\n          if (result?.error) {\n            break;\n          }\n\n          result?.intents?.forEach((intents) => {\n            void dispatchChain(intents, depth + 1);\n          });\n        }\n\n        return result;\n      };\n\n      state.dispatch = dispatchChain;\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"],
-  "mappings": ";;;;;;;;;;;AAIA,SAASA,kBAAkB;AAC3B,OAAOC,WAAW;AAElB,SAASC,WAAW;;AASpB,IAAMC,kBAAkB;AAMxB,IAAMC,eAAe,MAAA;AACnB,QAAMC,QAAQC,WAA0B;IAAEC,UAAU,aAAa,CAAC;IAAIC,kBAAkB,MAAM,MAAA;IAAO;EAAE,CAAA;AAEvG,QAAMC,mBAAmB,oBAAIC,IAAAA;AAE7B,SAAO;IACLC,MAAMC;IACNC,OAAO,OAAOC,YAAAA;AAEZ,YAAMP,WAAW,OAAOQ,WAAAA;AACtB,YAAIA,OAAOC,QAAQ;AACjB,qBAAWC,SAASR,kBAAkB;AACpC,gBAAIQ,MAAMD,WAAWD,OAAOC,QAAQ;AAClC,oBAAME,UAAS,MAAMD,MAAME,SAASJ,QAAQD,OAAAA;AAC5C,kBAAII,SAAQ;AACV,uBAAOA;cACT;YACF;UACF;AAEA,gBAAMF,SAASI,WAAmCN,SAASC,OAAOC,MAAM;AACxE,gBAAME,SAASF,QAAQK,SAASN,OAAOI,SAASJ,QAAQD,OAAAA;AACxD,iBAAOI;QACT;AAEA,mBAAWD,SAASR,kBAAkB;AACpC,gBAAMS,SAAS,MAAMD,MAAME,SAASJ,QAAQD,OAAAA;AAC5C,cAAII,QAAQ;AACV,mBAAOA;UACT;QACF;AAGA,mBAAWF,UAAUM,cAAcR,SAASS,yBAAAA,GAA4B;AACtE,gBAAML,SAAS,MAAMF,OAAOK,SAASN,OAAOI,SAASJ,QAAQD,OAAAA;AAC7D,cAAII,QAAQ;AACV,mBAAOA;UACT;QACF;AAIA,YAAI,aAAaM,KAAKC,KAAK;AACzBC,cAAIC,KAAK,oCAAoCZ,QAAAA;;;;;;QAC/C;MACF;AAGA,YAAMa,gBAAgB,OAAOC,eAAkCC,QAAQ,MAAC;AACtE,YAAIA,QAAQ3B,iBAAiB;AAC3B,iBAAO;YACL4B,OAAO,IAAIC,MACT,oCAAoC7B,eAAAA,+EAA8F;UAEtI;QACF;AAEA,YAAIe;AACJ,mBAAWH,UAAUkB,MAAMC,QAAQL,aAAAA,IAAiBA,gBAAgB;UAACA;WAAgB;AACnF,gBAAMM,OAAOpB,OAAOoB,OAAO;YAAEjB,QAAQA,QAAQiB;YAAM,GAAGpB,OAAOoB;UAAK,IAAIjB,QAAQiB;AAC9EjB,mBAAU,MAAMX,SAAS;YAAE,GAAGQ;YAAQoB;UAAK,CAAA,KAAOC;AAElD,cAAIlB,QAAQa,OAAO;AACjB;UACF;AAEAb,kBAAQmB,SAASC,QAAQ,CAACD,YAAAA;AACxB,iBAAKT,cAAcS,SAASP,QAAQ,CAAA;UACtC,CAAA;QACF;AAEA,eAAOZ;MACT;AAEAb,YAAME,WAAWqB;AACjBvB,YAAMG,mBAAmB,CAACQ,QAAQG,aAAAA;AAChC,cAAMF,QAAQ;UAAED;UAAQG;QAAS;AACjCV,yBAAiB8B,IAAItB,KAAAA;AACrB,eAAO,MAAMR,iBAAiB+B,OAAOvB,KAAAA;MACvC;IACF;IACAI,UAAU;MACRN,QAAQV;MACRoC,SAAS,CAAC,EAAEC,SAAQ,MAAO,sBAAA,cAACC,gBAAAA;QAAeC,OAAOvC;SAAQqC,QAAAA;IAC5D;EACF;AACF;AAEA,IAAA,iBAAetC;",
-  "names": ["deepSignal", "React", "log", "EXECUTION_LIMIT", "IntentPlugin", "state", "deepSignal", "dispatch", "registerResolver", "dynamicResolvers", "Set", "meta", "IntentMeta", "ready", "plugins", "intent", "plugin", "entry", "result", "resolver", "findPlugin", "provides", "filterPlugins", "parseIntentResolverPlugin", "env", "DEV", "log", "warn", "dispatchChain", "intentOrArray", "depth", "error", "Error", "Array", "isArray", "data", "undefined", "intents", "forEach", "add", "delete", "context", "children", "IntentProvider", "value"]
-}

package/dist/lib/node/chunk-FETX4EGX.cjs.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// 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 IntentDispatcher, type IntentResolver } from './intent';\n\nexport type IntentContext = {\n  dispatch: IntentDispatcher;\n  registerResolver: (pluginId: string, resolver: IntentResolver) => UnsubscribeCallback;\n};\n\nconst IntentContext: Context<IntentContext> = createContext<IntentContext>({\n  dispatch: async () => ({}),\n  registerResolver: () => () => {},\n});\n\n/**\n * @deprecated\n * TODO(burdon): Use useIntentDispatcher.\n */\nexport const useIntent = () => useContext(IntentContext);\n\n// TODO(burdon): Dispatch or Dispatcher?\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": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACIA,mBAAuE;AACvE,IAAAA,gBAA0B;ADanB,IAAMC,oBAAoB,CAACC,WAC/BA,OAAOC,SAAiBC,QAAQC,WAAYH,SAA0CI;AAElF,IAAMC,4BAA4B,CAACL,WACvCA,OAAOC,SAAiBC,QAAQI,WAAYN,SAA4CI;ACN3F,IAAMG,gBAAwCC,gDAA6B;EACzEL,UAAU,aAAa,CAAC;EACxBM,kBAAkB,MAAM,MAAA;EAAO;AACjC,CAAA;AAMO,IAAMC,YAAY,UAAMC,yBAAWJ,aAAAA;AAGnC,IAAMK,sBAAsB,MAAA;AACjC,QAAM,EAAET,SAAQ,IAAKO,UAAAA;AACrB,SAAOP;AACT;AAEO,IAAMU,oBAAoB,CAACb,QAAgBM,aAAAA;AAChD,QAAM,EAAEG,iBAAgB,IAAKC,UAAAA;AAC7BI,+BAAU,MAAA;AACR,WAAOL,iBAAiBT,QAAQM,QAAAA;EAClC,GAAG;IAACN;IAAQM;GAAS;AACvB;AAEO,IAAMS,iBAA0CR,cAAcS;ACpCrE,IAAMC,aAAa;EACjBC,IAAI;AACN;AAEA,IAAA,eAAeD;",
-  "names": ["import_react", "parseIntentPlugin", "plugin", "provides", "intent", "dispatch", "undefined", "parseIntentResolverPlugin", "resolver", "IntentContext", "createContext", "registerResolver", "useIntent", "useContext", "useIntentDispatcher", "useIntentResolver", "useEffect", "IntentProvider", "Provider", "IntentMeta", "id"]
-}

package/dist/lib/node/plugin-HLGHD6N5.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/plugins/IntentPlugin/plugin.tsx"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\nimport React from 'react';\n\nimport { log } from '@dxos/log';\n\nimport { type IntentContext, IntentProvider } from './IntentContext';\nimport type { Intent, IntentResolver, IntentResult } from './intent';\nimport IntentMeta from './meta';\nimport { type IntentPluginProvides, type IntentResolverProvides, parseIntentResolverPlugin } from './provides';\nimport type { PluginDefinition } from '../PluginHost';\nimport { filterPlugins, findPlugin } from '../helpers';\n\nconst EXECUTION_LIMIT = 1000;\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 = deepSignal<IntentContext>({ dispatch: async () => ({}), registerResolver: () => () => {} });\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        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        let result: IntentResult | undefined;\n        for (const intent of Array.isArray(intentOrArray) ? intentOrArray : [intentOrArray]) {\n          const data = intent.data ? { result: result?.data, ...intent.data } : result?.data;\n          result = (await dispatch({ ...intent, data })) ?? undefined;\n\n          if (result?.error) {\n            break;\n          }\n\n          result?.intents?.forEach((intents) => {\n            void dispatchChain(intents, depth + 1);\n          });\n        }\n\n        return result;\n      };\n\n      state.dispatch = dispatchChain;\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"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,mBAA2B;AAC3B,IAAAA,gBAAkB;AAElB,iBAAoB;;;AASpB,IAAMC,kBAAkB;AAMxB,IAAMC,eAAe,MAAA;AACnB,QAAMC,YAAQC,yBAA0B;IAAEC,UAAU,aAAa,CAAC;IAAIC,kBAAkB,MAAM,MAAA;IAAO;EAAE,CAAA;AAEvG,QAAMC,mBAAmB,oBAAIC,IAAAA;AAE7B,SAAO;IACLC,MAAMC;IACNC,OAAO,OAAOC,YAAAA;AAEZ,YAAMP,WAAW,OAAOQ,WAAAA;AACtB,YAAIA,OAAOC,QAAQ;AACjB,qBAAWC,SAASR,kBAAkB;AACpC,gBAAIQ,MAAMD,WAAWD,OAAOC,QAAQ;AAClC,oBAAME,UAAS,MAAMD,MAAME,SAASJ,QAAQD,OAAAA;AAC5C,kBAAII,SAAQ;AACV,uBAAOA;cACT;YACF;UACF;AAEA,gBAAMF,aAASI,kCAAmCN,SAASC,OAAOC,MAAM;AACxE,gBAAME,SAASF,QAAQK,SAASN,OAAOI,SAASJ,QAAQD,OAAAA;AACxD,iBAAOI;QACT;AAEA,mBAAWD,SAASR,kBAAkB;AACpC,gBAAMS,SAAS,MAAMD,MAAME,SAASJ,QAAQD,OAAAA;AAC5C,cAAII,QAAQ;AACV,mBAAOA;UACT;QACF;AAGA,mBAAWF,cAAUM,qCAAcR,SAASS,+CAAAA,GAA4B;AACtE,gBAAML,SAAS,MAAMF,OAAOK,SAASN,OAAOI,SAASJ,QAAQD,OAAAA;AAC7D,cAAII,QAAQ;AACV,mBAAOA;UACT;QACF;AAIA,YAAI,aAAaM,KAAKC,KAAK;AACzBC,yBAAIC,KAAK,oCAAoCZ,QAAAA;;;;;;QAC/C;MACF;AAGA,YAAMa,gBAAgB,OAAOC,eAAkCC,QAAQ,MAAC;AACtE,YAAIA,QAAQ3B,iBAAiB;AAC3B,iBAAO;YACL4B,OAAO,IAAIC,MACT,oCAAoC7B,eAAAA,+EAA8F;UAEtI;QACF;AAEA,YAAIe;AACJ,mBAAWH,UAAUkB,MAAMC,QAAQL,aAAAA,IAAiBA,gBAAgB;UAACA;WAAgB;AACnF,gBAAMM,OAAOpB,OAAOoB,OAAO;YAAEjB,QAAQA,QAAQiB;YAAM,GAAGpB,OAAOoB;UAAK,IAAIjB,QAAQiB;AAC9EjB,mBAAU,MAAMX,SAAS;YAAE,GAAGQ;YAAQoB;UAAK,CAAA,KAAOC;AAElD,cAAIlB,QAAQa,OAAO;AACjB;UACF;AAEAb,kBAAQmB,SAASC,QAAQ,CAACD,YAAAA;AACxB,iBAAKT,cAAcS,SAASP,QAAQ,CAAA;UACtC,CAAA;QACF;AAEA,eAAOZ;MACT;AAEAb,YAAME,WAAWqB;AACjBvB,YAAMG,mBAAmB,CAACQ,QAAQG,aAAAA;AAChC,cAAMF,QAAQ;UAAED;UAAQG;QAAS;AACjCV,yBAAiB8B,IAAItB,KAAAA;AACrB,eAAO,MAAMR,iBAAiB+B,OAAOvB,KAAAA;MACvC;IACF;IACAI,UAAU;MACRN,QAAQV;MACRoC,SAAS,CAAC,EAAEC,SAAQ,MAAO,8BAAAC,QAAA,cAACC,sCAAAA;QAAeC,OAAOxC;SAAQqC,QAAAA;IAC5D;EACF;AACF;AAEA,IAAA,iBAAetC;",
-  "names": ["import_react", "EXECUTION_LIMIT", "IntentPlugin", "state", "deepSignal", "dispatch", "registerResolver", "dynamicResolvers", "Set", "meta", "IntentMeta", "ready", "plugins", "intent", "plugin", "entry", "result", "resolver", "findPlugin", "provides", "filterPlugins", "parseIntentResolverPlugin", "env", "DEV", "log", "warn", "dispatchChain", "intentOrArray", "depth", "error", "Error", "Array", "isArray", "data", "undefined", "intents", "forEach", "add", "delete", "context", "children", "React", "IntentProvider", "value"]
-}