@dxos/app-framework 0.8.4-main.fffef41 → 0.9.0

package/moon.yml

@@ -1,18 +1,37 @@
-type: library
+layer: library
 language: typescript
 tags:
   - pack
   - ts-build
   - ts-test
+  - ts-test-storybook
   - typedoc
   - storybook
 tasks:
   compile:
     args:
       - '--entryPoint=src/index.ts'
-      - '--entryPoint=src/react/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'
-      - '--preactSignalTracking'
-  test:
-    inputs:
-      - .storybook/*
+      - '--entryPoint=src/testing/react.tsx'
+      - '--entryPoint=src/core/url-loader.ts'
+    deps:
+      - compile-plugin
+  compile-plugin:
+    command: dx-compile
+    args:
+      - '--entryPoint=src/vite-plugin/index.ts'
+      - '--outputPath=dist/plugin'
+      - '--platform=node'
+    deps:
+      - ^:compile
+      - dx-compile:compile
+    outputs:
+      - dist/plugin

package/package.json

@@ -1,87 +1,153 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.8.4-main.fffef41",
+  "version": "0.9.0",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
-  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "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",
+      "types": "./dist/types/src/index.d.ts"
+    },
+    "./ActivationEvent": {
+      "source": "./src/core/activation-event.ts",
+      "browser": "./dist/lib/browser/activation-event/index.mjs",
+      "node": "./dist/lib/node-esm/activation-event/index.mjs",
+      "types": "./dist/types/src/activation-event/index.d.ts"
+    },
+    "./ActivationEvents": {
+      "source": "./src/common/activation-events.ts",
+      "browser": "./dist/lib/browser/common/activation-events.mjs",
+      "node": "./dist/lib/node-esm/common/activation-events.mjs",
+      "types": "./dist/types/src/common/activation-events.d.ts"
+    },
+    "./Capabilities": {
+      "source": "./src/common/capabilities.ts",
+      "browser": "./dist/lib/browser/common/capabilities.mjs",
+      "node": "./dist/lib/node-esm/common/capabilities.mjs",
+      "types": "./dist/types/src/common/capabilities.d.ts"
+    },
+    "./Capability": {
+      "source": "./src/core/capability.ts",
+      "browser": "./dist/lib/browser/capability/index.mjs",
+      "node": "./dist/lib/node-esm/capability/index.mjs",
+      "types": "./dist/types/src/capability/index.d.ts"
+    },
+    "./Plugin": {
+      "source": "./src/core/plugin.ts",
+      "browser": "./dist/lib/browser/plugin/index.mjs",
+      "node": "./dist/lib/node-esm/plugin/index.mjs",
+      "types": "./dist/types/src/plugin/index.d.ts"
+    },
+    "./PluginManager": {
+      "source": "./src/core/plugin-manager.ts",
+      "browser": "./dist/lib/browser/plugin-manager/index.mjs",
+      "node": "./dist/lib/node-esm/plugin-manager/index.mjs",
+      "types": "./dist/types/src/plugin-manager/index.d.ts"
     },
-    "./react": {
-      "source": "./src/react/index.ts",
-      "types": "./dist/types/src/react/index.d.ts",
-      "browser": "./dist/lib/browser/react/index.mjs",
-      "node": "./dist/lib/node-esm/react/index.mjs"
+    "./UrlLoader": {
+      "source": "./src/core/url-loader.ts",
+      "browser": "./dist/lib/browser/url-loader/index.mjs",
+      "node": "./dist/lib/node-esm/url-loader/index.mjs",
+      "types": "./dist/types/src/url-loader/index.d.ts"
+    },
+    "./vite-plugin": {
+      "import": "./dist/plugin/node-esm/index.mjs",
+      "types": "./dist/types/src/vite-plugin/index.d.ts"
+    },
+    "./cli": {
+      "source": "./src/cli/index.ts",
+      "browser": "./dist/lib/browser/cli/index.mjs",
+      "node": "./dist/lib/node-esm/cli/index.mjs",
+      "types": "./dist/types/src/cli/index.d.ts"
     },
     "./testing": {
       "source": "./src/testing/index.ts",
-      "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",
+      "types": "./dist/types/src/testing/index.d.ts"
+    },
+    "./testing-react": {
+      "source": "./src/testing/react.tsx",
+      "browser": "./dist/lib/browser/testing/react.mjs",
+      "node": "./dist/lib/node-esm/testing/react.mjs",
+      "types": "./dist/types/src/testing/react.d.ts"
+    },
+    "./ui": {
+      "source": "./src/ui/index.ts",
+      "browser": "./dist/lib/browser/ui/index.mjs",
+      "node": "./dist/lib/node-esm/ui/index.mjs",
+      "types": "./dist/types/src/ui/index.d.ts"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "react": [
-        "dist/types/src/react/index.d.ts"
-      ],
-      "testing": [
-        "dist/types/src/testing/index.d.ts"
-      ]
-    }
-  },
   "dependencies": {
-    "@effect/ai": "0.29.1",
-    "@effect/experimental": "0.56.0",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
-    "@dxos/ai": "0.8.4-main.fffef41",
-    "@dxos/app-graph": "0.8.4-main.fffef41",
-    "@dxos/assistant": "0.8.4-main.fffef41",
-    "@dxos/blueprints": "0.8.4-main.fffef41",
-    "@dxos/client-protocol": "0.8.4-main.fffef41",
-    "@dxos/echo": "0.8.4-main.fffef41",
-    "@dxos/async": "0.8.4-main.fffef41",
-    "@dxos/invariant": "0.8.4-main.fffef41",
-    "@dxos/debug": "0.8.4-main.fffef41",
-    "@dxos/keys": "0.8.4-main.fffef41",
-    "@dxos/live-object": "0.8.4-main.fffef41",
-    "@dxos/local-storage": "0.8.4-main.fffef41",
-    "@dxos/schema": "0.8.4-main.fffef41",
-    "@dxos/types": "0.8.4-main.fffef41",
-    "@dxos/log": "0.8.4-main.fffef41",
-    "@dxos/util": "0.8.4-main.fffef41",
-    "@dxos/functions": "0.8.4-main.fffef41",
-    "@dxos/react-hooks": "0.8.4-main.fffef41"
+    "@babel/core": "^7.18.13",
+    "@babel/preset-typescript": "^7.27.1",
+    "@effect-atom/atom": "^0.5.3",
+    "@effect/cli": "0.75.2",
+    "@effect/platform": "0.96.1",
+    "babel-preset-solid": "^1.9.9",
+    "cjs-module-lexer": "^2.2.0",
+    "esbuild": "0.28.0",
+    "idb-keyval": "^6.2.1",
+    "solid-js": "^1.9.11",
+    "@dxos/async": "0.9.0",
+    "@dxos/compute-runtime": "0.9.0",
+    "@dxos/compute": "0.9.0",
+    "@dxos/context": "0.9.0",
+    "@dxos/edge-client": "0.9.0",
+    "@dxos/debug": "0.9.0",
+    "@dxos/errors": "0.9.0",
+    "@dxos/keys": "0.9.0",
+    "@dxos/effect": "0.9.0",
+    "@dxos/invariant": "0.9.0",
+    "@dxos/log": "0.9.0",
+    "@dxos/protocols": "0.9.0",
+    "@dxos/operation": "0.9.0",
+    "@dxos/react-error-boundary": "0.9.0",
+    "@dxos/react-hooks": "0.9.0",
+    "@dxos/ui-theme": "0.9.0",
+    "@dxos/react-ui": "0.9.0",
+    "@dxos/util": "0.9.0",
+    "@dxos/web-context": "0.9.0",
+    "@dxos/web-context-react": "0.9.0"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "0.92.1",
-    "@types/react": "~19.2.2",
-    "effect": "3.18.3",
-    "react": "~19.2.0",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.96.1",
+    "@effect/vitest": "0.29.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "~19.2.7",
+    "effect": "3.21.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
     "typedoc": "0.28.1",
-    "@dxos/echo-signals": "0.8.4-main.fffef41",
-    "@dxos/react-ui": "0.8.4-main.fffef41",
-    "@dxos/random": "0.8.4-main.fffef41",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.fffef41",
-    "@dxos/react-ui-theme": "0.8.4-main.fffef41",
-    "@dxos/storybook-utils": "0.8.4-main.fffef41"
+    "vite": "^8.0.16",
+    "vite-plugin-solid": "^2.11.12",
+    "@dxos/brand": "0.9.0",
+    "@dxos/echo-client": "0.9.0",
+    "@dxos/random": "0.9.0",
+    "@dxos/storybook-utils": "0.9.0",
+    "@dxos/test-utils": "0.9.0"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "^19.0.0"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.96.1",
+    "@testing-library/react": "^16.3.0",
+    "effect": "3.21.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3"
   },
   "publishConfig": {
     "access": "public"

package/src/cli/cli.ts

@@ -0,0 +1,102 @@
+//
+// 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[];
+  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. Plugins whose `meta.tags` includes `'system'` are treated as core.
+ * @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 = [],
+  enabled: enabledProp = [],
+  safeMode = false,
+}: CreateCliAppOptions) {
+  const plugins = pluginsProp;
+  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);
+  const enabled = safeMode ? [] : enabledProp;
+  const manager =
+    pluginManagerProp ??
+    PluginManager.make({
+      pluginLoader,
+      plugins,
+      enabled,
+    });
+
+  manager.capabilities.contribute({
+    interface: Capabilities.PluginManager,
+    implementation: manager,
+    module: 'org.dxos.app-framework.plugin-manager',
+  });
+
+  manager.capabilities.contribute({
+    interface: Capabilities.AtomRegistry,
+    implementation: manager.registry,
+    module: 'org.dxos.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/debug → 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,39 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { ActivationEvent as ActivationEvent$ } from '../core';
+
+/**
+ * Fired when the app is started.
+ */
+export const Startup = ActivationEvent$.make('org.dxos.app-framework.event.startup');
+
+//
+// Dependent Events
+//
+
+/**
+ * Fired to load any newly available surfaces.
+ */
+export const SetupReactSurface = ActivationEvent$.make('org.dxos.app-framework.event.setup-react-surface');
+
+/**
+ * Fired before the process manager is created.
+ * Plugins should contribute their {@link Capabilities.LayerSpec} entries and
+ * {@link Capabilities.OperationHandler} sets before this event fires so the
+ * process manager's {@link ServiceResolver} and {@link OperationInvoker} pick
+ * them up at construction time.
+ */
+export const SetupProcessManager = ActivationEvent$.make('org.dxos.app-framework.event.setup-process-manager');
+
+//
+// Triggered Events
+//
+
+/**
+ * Fired after the process manager runtime is ready and its derived capabilities
+ * (`ProcessManagerRuntime`, `ServiceResolver`, `ProcessMonitor`, `OperationInvoker`)
+ * have been contributed.
+ */
+export const ProcessManagerReady = ActivationEvent$.make('org.dxos.app-framework.event.process-manager-ready');

package/src/{playground/logger/index.ts → common/annotations.ts}

@@ -1,5 +1,3 @@
 //
 // Copyright 2025 DXOS.org
 //
-
-export * from './plugin';