@dxos/app-framework 0.3.3-main.0c081e6

package/src/plugins/helpers.ts

@@ -0,0 +1,43 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { raise } from '@dxos/debug';
+
+import { type Plugin } from './PluginHost';
+
+/**
+ * Find a plugin by ID.
+ */
+export const findPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> | undefined => {
+  return plugins.find(
+    (plugin) => plugin.meta.id === id || (typeof plugin.meta.shortId === 'string' && plugin.meta.shortId === id),
+  ) as Plugin<T>;
+};
+
+/**
+ * Find a plugin by ID, or raise an error if not found.
+ */
+export const getPlugin = <T>(plugins: Plugin[], id: string): Plugin<T> => {
+  return findPlugin(plugins, id) ?? raise(new Error(`Plugin not found: ${id}`));
+};
+
+/**
+ * Filter a list of plugins to only those that match a predicate.
+ */
+export const filterPlugins = <T>(
+  plugins: Plugin[],
+  predicate: (plugin: Plugin) => Plugin<T> | undefined,
+): Plugin<T>[] => plugins.map((plugin) => predicate(plugin)).filter((plugin): plugin is Plugin<T> => !!plugin);
+
+/**
+ * Resolves a plugin by predicate.
+ *
+ * @example
+ * import { parseIntentPlugin, resolvePlugin } from '@dxos/app-framework';
+ * const intentPlugin = resolvePlugin(plugins, parseIntentPlugin);
+ */
+export const resolvePlugin = <T>(
+  plugins: Plugin[],
+  predicate: (plugin: Plugin) => Plugin<T> | undefined,
+): Plugin<T> | undefined => filterPlugins(plugins, predicate)[0];

package/src/plugins/index.ts

@@ -0,0 +1,10 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './common';
+export * from './helpers';
+
+export * from './IntentPlugin';
+export * from './PluginHost';
+export * from './SurfacePlugin';

package/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "jsx": "react",
+    "lib": [
+      "DOM",
+      "ESNext"
+    ],
+    "module": "ESNext",
+    "outDir": "dist"
+  },
+  "exclude": [
+    "/node_modules/"
+  ],
+  "include": [
+    "src"
+  ],
+  "references": [
+    {
+      "path": "../../common/async"
+    },
+    {
+      "path": "../../common/debug"
+    },
+    {
+      "path": "../../common/invariant"
+    },
+    {
+      "path": "../../common/log"
+    },
+    {
+      "path": "../app-graph"
+    }
+  ],
+  "ts-node": {
+    "compilerOptions": {
+      "module": "CommonJS"
+    },
+    "files": true,
+    "transpileOnly": true
+  }
+}

package/tsconfig.node.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "allowSyntheticDefaultImports": true
+  },
+  "include": [
+    "vite.config.ts"
+  ]
+}