@dxos/app-framework 0.8.3 → 0.8.4-main.1068cf700f

package/moon.yml

@@ -0,0 +1,25 @@
+layer: library
+language: typescript
+tags:
+  - pack
+  - ts-build
+  - ts-test
+  - typedoc
+  - storybook
+tasks:
+  compile:
+    args:
+      - '--entryPoint=src/index.ts'
+      - '--entryPoint=src/cli/index.ts'
+      - '--entryPoint=src/core/activation-event.ts'
+      - '--entryPoint=src/core/capability.ts'
+      - '--entryPoint=src/core/plugin.ts'
+      - '--entryPoint=src/core/plugin-manager.ts'
+      - '--entryPoint=src/common/capabilities.ts'
+      - '--entryPoint=src/common/activation-events.ts'
+      - '--entryPoint=src/ui/index.ts'
+      - '--entryPoint=src/testing/index.ts'
+  test:
+    inputs:
+      - .storybook/*
+      - /tools/storybook-react/.storybook/main.ts

package/package.json

@@ -1,79 +1,147 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.8.3",
+  "version": "0.8.4-main.1068cf700f",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "node": "./dist/lib/node-esm/index.mjs",
+      "source": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts"
+    },
+    "./ActivationEvent": {
+      "browser": "./dist/lib/browser/activation-event/index.mjs",
+      "node": "./dist/lib/node-esm/activation-event/index.mjs",
+      "source": "./src/core/activation-event.ts",
+      "types": "./dist/types/src/activation-event/index.d.ts"
+    },
+    "./ActivationEvents": {
+      "browser": "./dist/lib/browser/common/activation-events.mjs",
+      "node": "./dist/lib/node-esm/common/activation-events.mjs",
+      "source": "./src/common/activation-events.ts",
+      "types": "./dist/types/src/common/activation-events.d.ts"
+    },
+    "./Capabilities": {
+      "browser": "./dist/lib/browser/common/capabilities.mjs",
+      "node": "./dist/lib/node-esm/common/capabilities.mjs",
+      "source": "./src/common/capabilities.ts",
+      "types": "./dist/types/src/common/capabilities.d.ts"
+    },
+    "./Capability": {
+      "browser": "./dist/lib/browser/capability/index.mjs",
+      "node": "./dist/lib/node-esm/capability/index.mjs",
+      "source": "./src/core/capability.ts",
+      "types": "./dist/types/src/capability/index.d.ts"
+    },
+    "./Plugin": {
+      "browser": "./dist/lib/browser/plugin/index.mjs",
+      "node": "./dist/lib/node-esm/plugin/index.mjs",
+      "source": "./src/core/plugin.ts",
+      "types": "./dist/types/src/plugin/index.d.ts"
+    },
+    "./PluginManager": {
+      "browser": "./dist/lib/browser/plugin-manager/index.mjs",
+      "node": "./dist/lib/node-esm/plugin-manager/index.mjs",
+      "source": "./src/core/plugin-manager.ts",
+      "types": "./dist/types/src/plugin-manager/index.d.ts"
+    },
+    "./cli": {
+      "browser": "./dist/lib/browser/cli/index.mjs",
+      "node": "./dist/lib/node-esm/cli/index.mjs",
+      "source": "./src/cli/index.ts",
+      "types": "./dist/types/src/cli/index.d.ts"
     },
     "./testing": {
-      "types": "./dist/types/src/testing/index.d.ts",
       "browser": "./dist/lib/browser/testing/index.mjs",
-      "node": "./dist/lib/node-esm/testing/index.mjs"
+      "node": "./dist/lib/node-esm/testing/index.mjs",
+      "source": "./src/testing/index.ts",
+      "types": "./dist/types/src/testing/index.d.ts"
     },
-    "./worker": {
-      "types": "./dist/types/src/worker.d.ts",
-      "browser": "./dist/lib/browser/worker.mjs",
-      "node": "./dist/lib/node-esm/worker.mjs"
+    "./ui": {
+      "browser": "./dist/lib/browser/ui/index.mjs",
+      "node": "./dist/lib/node-esm/ui/index.mjs",
+      "source": "./src/ui/index.ts",
+      "types": "./dist/types/src/ui/index.d.ts"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
-      "./testing": [
+      "ActivationEvent": [
+        "dist/types/src/activation-event/index.d.ts"
+      ],
+      "ActivationEvents": [
+        "dist/types/src/common/activation-events.d.ts"
+      ],
+      "Capabilities": [
+        "dist/types/src/common/capabilities.d.ts"
+      ],
+      "Capability": [
+        "dist/types/src/capability/index.d.ts"
+      ],
+      "Plugin": [
+        "dist/types/src/plugin/index.d.ts"
+      ],
+      "PluginManager": [
+        "dist/types/src/plugin-manager/index.d.ts"
+      ],
+      "cli": [
+        "dist/types/src/cli/index.d.ts"
+      ],
+      "testing": [
         "dist/types/src/testing/index.d.ts"
       ],
-      "./worker": [
-        "dist/types/src/worker.d.ts"
+      "ui": [
+        "dist/types/src/ui/index.d.ts"
       ]
     }
   },
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "@dxos/app-graph": "0.8.3",
-    "@dxos/ai": "0.8.3",
-    "@dxos/artifact": "0.8.3",
-    "@dxos/client-protocol": "0.8.3",
-    "@dxos/debug": "0.8.3",
-    "@dxos/async": "0.8.3",
-    "@dxos/invariant": "0.8.3",
-    "@dxos/echo-schema": "0.8.3",
-    "@dxos/keys": "0.8.3",
-    "@dxos/live-object": "0.8.3",
-    "@dxos/log": "0.8.3",
-    "@dxos/local-storage": "0.8.3",
-    "@dxos/react-hooks": "0.8.3",
-    "@dxos/util": "0.8.3",
-    "@dxos/schema": "0.8.3"
+    "@effect/cli": "0.73.2",
+    "@dxos/async": "0.8.4-main.1068cf700f",
+    "@dxos/debug": "0.8.4-main.1068cf700f",
+    "@dxos/echo": "0.8.4-main.1068cf700f",
+    "@dxos/invariant": "0.8.4-main.1068cf700f",
+    "@dxos/effect": "0.8.4-main.1068cf700f",
+    "@dxos/log": "0.8.4-main.1068cf700f",
+    "@dxos/operation": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f",
+    "@dxos/util": "0.8.4-main.1068cf700f",
+    "@dxos/react-hooks": "0.8.4-main.1068cf700f",
+    "@dxos/web-context": "0.8.4-main.1068cf700f",
+    "@dxos/web-context-react": "0.8.4-main.1068cf700f"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "0.80.12",
-    "@phosphor-icons/react": "^2.1.5",
-    "@types/react": "~18.2.0",
-    "effect": "3.14.21",
-    "react": "~18.2.0",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "@effect/vitest": "0.27.0",
+    "@types/react": "~19.2.7",
+    "effect": "3.19.16",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
     "typedoc": "0.28.1",
-    "@dxos/echo-signals": "0.8.3",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/random": "0.8.3",
-    "@dxos/react-ui-syntax-highlighter": "0.8.3",
-    "@dxos/storybook-utils": "0.8.3"
+    "@dxos/echo-db": "0.8.4-main.1068cf700f",
+    "@dxos/storybook-utils": "0.8.4-main.1068cf700f",
+    "@dxos/test-utils": "0.8.4-main.1068cf700f",
+    "@dxos/random": "0.8.4-main.1068cf700f",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "0.80.12",
-    "effect": "^3.13.3",
-    "react": "~18.2.0"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.19.16",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3"
   },
   "publishConfig": {
     "access": "public"

package/src/cli/cli.ts

@@ -0,0 +1,107 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Command from '@effect/cli/Command';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+
+import { invariant } from '@dxos/invariant';
+
+import { ActivationEvents, Capabilities } from '../common';
+import { Capability, Plugin, PluginManager } from '../core';
+
+const defaultPluginLoader =
+  (plugins: Plugin.Plugin[]): PluginManager.ManagerOptions['pluginLoader'] =>
+  (id: string) =>
+    Effect.sync(() => {
+      const plugin = plugins.find((plugin) => plugin.meta.id === id);
+      invariant(plugin, `Plugin not found: ${id}`);
+      return plugin;
+    });
+
+type SubCommands = [Command.Command<any, any, any, any>, ...Array<Command.Command<any, any, any, any>>];
+
+export type CreateCliAppOptions = {
+  rootCommand: Command.Command<any, any, any, any>;
+  subCommands?: SubCommands;
+  pluginManager?: PluginManager.PluginManager;
+  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];
+  plugins?: Plugin.Plugin[];
+  core?: string[];
+  enabled?: string[];
+  safeMode?: boolean;
+};
+
+/**
+ * Creates a CLI application with plugin support.
+ * Similar to useApp but for CLI environments.
+ *
+ * @example
+ * const plugins = [ClientPluginCLI()];
+ * const manager = await createCliApp({ plugins });
+ * const commands = manager.capabilities.getAll(Capabilities.Command);
+ *
+ * @param options.pluginManager Optional existing PluginManager instance.
+ * @param options.pluginLoader Function to load plugins by ID.
+ * @param options.plugins All plugins available to the application.
+ * @param options.core Core plugins which will always be enabled.
+ * @param options.enabled Enabled plugins.
+ * @param options.safeMode Whether to enable safe mode, which disables optional plugins.
+ */
+export const createCliApp = Effect.fn(function* ({
+  rootCommand,
+  subCommands: subCommandsProp,
+  pluginManager: pluginManagerProp,
+  pluginLoader: pluginLoaderProp,
+  plugins: pluginsProp = [],
+  core: coreProp,
+  enabled: enabledProp = [],
+  safeMode = false,
+}: CreateCliAppOptions) {
+  const plugins = pluginsProp;
+  const core = coreProp ?? plugins.map(({ meta }) => meta.id);
+  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);
+  const enabled = safeMode ? [] : enabledProp;
+  const manager =
+    pluginManagerProp ??
+    PluginManager.make({
+      pluginLoader,
+      plugins,
+      core,
+      enabled,
+    });
+
+  manager.capabilities.contribute({
+    interface: Capabilities.PluginManager,
+    implementation: manager,
+    module: 'dxos.org/app-framework/plugin-manager',
+  });
+
+  manager.capabilities.contribute({
+    interface: Capabilities.AtomRegistry,
+    implementation: manager.registry,
+    module: 'dxos.org/app-framework/atom-registry',
+  });
+
+  // Activate startup event to load CLI commands and Effect layers.
+  yield* manager.activate(ActivationEvents.Startup);
+
+  // Gather all layers and merge them into a single layer.
+  const layers = manager.capabilities.getAll(Capabilities.Layer);
+  const capabilityServiceLayer = Layer.succeed(Capability.Service, manager.capabilities);
+  const pluginServiceLayer = Layer.succeed(Plugin.Service, manager);
+  const layer = (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(
+    capabilityServiceLayer,
+    pluginServiceLayer,
+    ...layers,
+  );
+
+  // Gather all commands and provide them to the root command.
+  const pluginCommands = manager.capabilities.getAll(Capabilities.Command);
+  const subCommands = subCommandsProp ? [...subCommandsProp, ...pluginCommands] : pluginCommands;
+  invariant(subCommands.length > 0, 'No subcommands provided');
+  const command = rootCommand.pipe(Command.withSubcommands(subCommands as SubCommands));
+
+  return { command, layer };
+});

package/src/{playground/layout → cli}/index.ts

@@ -2,4 +2,4 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './plugin';
+export * from './cli';

package/src/common/activation-events.ts

@@ -0,0 +1,44 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { ActivationEvent as ActivationEvent$ } from '../core';
+
+/**
+ * Fired when the app is started.
+ */
+export const Startup = ActivationEvent$.make('dxos.org/app-framework/event/startup');
+
+//
+// Dependent Events
+//
+
+/**
+ * Fired to load any newly available surfaces.
+ */
+export const SetupReactSurface = ActivationEvent$.make('dxos.org/app-framework/event/setup-react-surface');
+
+/**
+ * Fired before the operation invoker is activated.
+ */
+export const SetupOperationResolver = ActivationEvent$.make('dxos.org/app-framework/event/setup-operation-resolver');
+
+/**
+ * Fired before the managed runtime is created.
+ * Plugins should contribute their Layer capabilities before this event.
+ */
+export const SetupLayer = ActivationEvent$.make('dxos.org/app-framework/event/setup-layer');
+
+//
+// Triggered Events
+//
+
+/**
+ * Fired after the operation invoker is ready.
+ */
+export const OperationInvokerReady = ActivationEvent$.make('dxos.org/app-framework/event/operation-invoker-ready');
+
+/**
+ * Fired after the managed runtime is ready.
+ */
+export const ManagedRuntimeReady = ActivationEvent$.make('dxos.org/app-framework/event/managed-runtime-ready');