@dxos/app-framework 0.8.4-main.74a063c4e0 → 0.8.4-main.765dc60934

package/moon.yml

@@ -20,6 +20,7 @@ tasks:
       - '--entryPoint=src/common/activation-events.ts'
       - '--entryPoint=src/ui/index.ts'
       - '--entryPoint=src/testing/index.ts'
+      - '--entryPoint=src/testing/react.tsx'
       - '--entryPoint=src/core/url-loader.ts'
     deps:
       - compile-plugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.8.4-main.74a063c4e0",
+  "version": "0.8.4-main.765dc60934",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,7 +8,7 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": false,
   "type": "module",
@@ -77,6 +77,12 @@
       "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",
@@ -85,80 +91,50 @@
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "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"
-      ],
-      "UrlLoader": [
-        "dist/types/src/url-loader/index.d.ts"
-      ],
-      "vite-plugin": [
-        "dist/types/src/vite-plugin/index.d.ts"
-      ],
-      "cli": [
-        "dist/types/src/cli/index.d.ts"
-      ],
-      "testing": [
-        "dist/types/src/testing/index.d.ts"
-      ],
-      "ui": [
-        "dist/types/src/ui/index.d.ts"
-      ]
-    }
-  },
   "dependencies": {
     "@effect/cli": "0.73.2",
     "cjs-module-lexer": "^2.2.0",
-    "@dxos/debug": "0.8.4-main.74a063c4e0",
-    "@dxos/async": "0.8.4-main.74a063c4e0",
-    "@dxos/effect": "0.8.4-main.74a063c4e0",
-    "@dxos/echo": "0.8.4-main.74a063c4e0",
-    "@dxos/errors": "0.8.4-main.74a063c4e0",
-    "@dxos/log": "0.8.4-main.74a063c4e0",
-    "@dxos/invariant": "0.8.4-main.74a063c4e0",
-    "@dxos/react-error-boundary": "0.8.4-main.74a063c4e0",
-    "@dxos/operation": "0.8.4-main.74a063c4e0",
-    "@dxos/react-hooks": "0.8.4-main.74a063c4e0",
-    "@dxos/web-context": "0.8.4-main.74a063c4e0",
-    "@dxos/web-context-react": "0.8.4-main.74a063c4e0",
-    "@dxos/util": "0.8.4-main.74a063c4e0"
+    "@dxos/async": "0.8.4-main.765dc60934",
+    "@dxos/compute": "0.8.4-main.765dc60934",
+    "@dxos/context": "0.8.4-main.765dc60934",
+    "@dxos/debug": "0.8.4-main.765dc60934",
+    "@dxos/edge-client": "0.8.4-main.765dc60934",
+    "@dxos/errors": "0.8.4-main.765dc60934",
+    "@dxos/invariant": "0.8.4-main.765dc60934",
+    "@dxos/effect": "0.8.4-main.765dc60934",
+    "@dxos/log": "0.8.4-main.765dc60934",
+    "@dxos/operation": "0.8.4-main.765dc60934",
+    "@dxos/protocols": "0.8.4-main.765dc60934",
+    "@dxos/react-hooks": "0.8.4-main.765dc60934",
+    "@dxos/react-error-boundary": "0.8.4-main.765dc60934",
+    "@dxos/ui-theme": "0.8.4-main.765dc60934",
+    "@dxos/web-context": "0.8.4-main.765dc60934",
+    "@dxos/web-context-react": "0.8.4-main.765dc60934",
+    "@dxos/util": "0.8.4-main.765dc60934",
+    "@dxos/react-ui": "0.8.4-main.765dc60934",
+    "@dxos/echo": "0.8.4-main.765dc60934"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
-    "@effect/vitest": "0.27.0",
+    "@effect/vitest": "0.29.0",
+    "@testing-library/react": "^16.3.0",
     "@types/react": "~19.2.7",
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
     "typedoc": "0.28.1",
-    "vite": "^7.1.11",
-    "@dxos/echo-db": "0.8.4-main.74a063c4e0",
-    "@dxos/random": "0.8.4-main.74a063c4e0",
-    "@dxos/react-ui": "0.8.4-main.74a063c4e0",
-    "@dxos/ui-theme": "0.8.4-main.74a063c4e0",
-    "@dxos/storybook-utils": "0.8.4-main.74a063c4e0",
-    "@dxos/test-utils": "0.8.4-main.74a063c4e0"
+    "vite": "^8.0.13",
+    "@dxos/brand": "0.8.4-main.765dc60934",
+    "@dxos/echo-db": "0.8.4-main.765dc60934",
+    "@dxos/random": "0.8.4-main.765dc60934",
+    "@dxos/storybook-utils": "0.8.4-main.765dc60934",
+    "@dxos/test-utils": "0.8.4-main.765dc60934"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
+    "@testing-library/react": "^16.3.0",
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3"

package/src/cli/cli.ts

@@ -17,7 +17,7 @@ const defaultPluginLoader =
     Effect.sync(() => {
       const plugin = plugins.find((plugin) => plugin.meta.id === id);
       invariant(plugin, `Plugin not found: ${id}`);
-      return plugin;
+      return { plugin };
     });
 
 type SubCommands = [Command.Command<any, any, any, any>, ...Array<Command.Command<any, any, any, any>>];

package/src/common/annotations.ts

@@ -0,0 +1,3 @@
+//
+// Copyright 2025 DXOS.org
+//

package/src/common/capabilities.ts

@@ -9,7 +9,8 @@ import type * as Layer$ from 'effect/Layer';
 import type * as ManagedRuntime$ from 'effect/ManagedRuntime';
 import type { FC, PropsWithChildren } from 'react';
 
-import type { OperationInvoker as OperationInvoker$, OperationHandlerSet } from '@dxos/operation';
+import type { OperationHandlerSet } from '@dxos/compute';
+import { OperationInvoker as OperationInvoker$ } from '@dxos/operation';
 
 import { Capability as Capability$, type PluginManager as PluginManager$ } from '../core';
 import type {

package/src/common/operations.ts

@@ -4,7 +4,7 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { Capability } from '../core';
 import { Label } from './translations';

package/src/core/capability.ts

@@ -232,7 +232,7 @@ export const getModuleTag = (capability: unknown): string | undefined => {
  * export default Capability.makeModule(
  *   Effect.fnUntraced(function* (props: { observability: boolean }) {
  *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);
- *     return contributes(Capabilities.IntentResolver, ...);
+ *     return contributes(Capabilities.OperationHandler, ...);
  *   })
  * );
  * ```

package/src/core/edge-registry-plugin-provider.ts

@@ -0,0 +1,92 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Context } from '@dxos/context';
+import { type EdgeHttpClient } from '@dxos/edge-client';
+import { type PluginEntry } from '@dxos/protocols';
+
+import * as Registry from './registry';
+
+/**
+ * Maps a wire-format `PluginEntry` (from `@dxos/protocols`) to a
+ * `Registry.Plugin` (the app-framework domain type).
+ *
+ * This is the only translation seam between the two independently-defined type
+ * hierarchies — fields are mapped explicitly, with no shared type between them.
+ */
+const toRegistryPlugin = (entry: PluginEntry): Registry.Plugin => ({
+  id: entry.meta.id,
+  name: entry.meta.name,
+  description: entry.meta.description,
+  homePage: entry.meta.homePage,
+  source: entry.meta.source,
+  screenshots: entry.meta.screenshots ? [...entry.meta.screenshots] : undefined,
+  tags: entry.meta.tags ? [...entry.meta.tags] : undefined,
+  icon: entry.meta.icon,
+  iconHue: entry.meta.iconHue,
+  moduleUrl: entry.moduleUrl,
+  repo: entry.repo,
+  version: entry.releaseTag,
+});
+
+/**
+ * Implements `Registry.PluginProvider` against the Edge `/registry` HTTP endpoints.
+ *
+ * Lives in app-framework (rather than the more obvious home of `@dxos/edge-client`)
+ * because edge-client doesn't depend on app-framework; siting the implementation
+ * here keeps the dependency arrow `app-framework → edge-client` and avoids a
+ * cycle. The class needs only the public `EdgeHttpClient` type, so a one-way
+ * type-import is enough.
+ *
+ * `listVersions` is currently a stub: it returns the single latest version derived
+ * from the cached plugin list, so the host's version picker has something to render.
+ * The wire contract for the real endpoint already exists — see
+ * `GetPluginVersionsResponseBodySchema` in `@dxos/protocols/edge/registry` and
+ * {@link EdgeHttpClient.getRegistryPluginVersions} — so once Edge ships
+ * `GET /registry/plugins/:repo/versions`, swap this stub for a call to
+ * `this._client.getRegistryPluginVersions(...)` and map each entry through a
+ * `toRegistryPluginVersion` helper (mirror of {@link toRegistryPlugin}).
+ */
+export class EdgeRegistryPluginProvider implements Registry.PluginProvider {
+  // Cached on first load so getPlugin/listVersions can resolve without re-fetching.
+  #cachedPlugins: readonly Registry.Plugin[] = [];
+
+  constructor(private readonly _client: EdgeHttpClient) {}
+
+  listPlugins(): Effect.Effect<readonly Registry.Plugin[], Error> {
+    return Effect.tryPromise({
+      try: () => this._client.getRegistryPlugins(Context.default()),
+      catch: (error) => (error instanceof Error ? error : new Error(String(error))),
+    }).pipe(
+      Effect.map((body) => {
+        const plugins = body.plugins.filter((entry) => entry.health === 'ok').map(toRegistryPlugin);
+        this.#cachedPlugins = plugins;
+        return plugins;
+      }),
+    );
+  }
+
+  listVersions(repo: string): Effect.Effect<readonly Registry.PluginVersion[], Error> {
+    // Stub: return only the currently-known version until Edge implements the versions endpoint.
+    const plugin = this.#cachedPlugins.find((candidate) => candidate.repo === repo);
+    if (!plugin) {
+      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));
+    }
+    const version: Registry.PluginVersion = { tag: plugin.version, moduleUrl: plugin.moduleUrl };
+    return Effect.succeed([version]);
+  }
+
+  getPlugin(repo: string, version?: string): Effect.Effect<Registry.Plugin, Error> {
+    const plugin = this.#cachedPlugins.find((p) => p.repo === repo);
+    if (!plugin) {
+      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));
+    }
+    if (version && version !== plugin.version) {
+      return Effect.fail(new Error(`Version ${version} not available for ${repo}; only ${plugin.version} is cached`));
+    }
+    return Effect.succeed(plugin);
+  }
+}

package/src/core/index.ts

@@ -6,5 +6,10 @@ export * as ActivationEvent from './activation-event';
 export * as Capability from './capability';
 export * as CapabilityManager from './capability-manager';
 export * as Plugin from './plugin';
+export * as PluginAssetCache from './plugin-asset-cache';
 export * as PluginManager from './plugin-manager';
+export * as PluginManifest from './plugin-manifest';
+export { PLUGIN_DEV_SERVER_PORT } from './plugin-manifest';
+export * as Registry from './registry';
+export { EdgeRegistryPluginProvider } from './edge-registry-plugin-provider';
 export * as UrlLoader from './url-loader';

package/src/core/plugin-asset-cache.ts

@@ -0,0 +1,60 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { BaseError } from '@dxos/errors';
+
+/**
+ * Tagged error for cache operations. Construction sites supply `context.operation`
+ * (one of `'cache' | 'evict' | 'resolve' | 'list'`) and `context.pluginId` so
+ * downstream handlers can route on the failed call without scanning the message.
+ */
+export class PluginAssetCacheError extends BaseError.extend(
+  'PluginAssetCacheError',
+  'Plugin asset cache operation failed',
+) {}
+
+/**
+ * Per-platform offline cache for third-party plugin assets.
+ *
+ * Implementations live alongside their platform glue (composer-app's
+ * `asset-cache/{tauri,service-worker}.ts`); the no-op default is for tests
+ * and unsupported environments.
+ */
+export interface Cache {
+  /**
+   * Persist all listed URLs under the namespace of `pluginId`. Idempotent.
+   * The order of `urls` is significant — the first entry is treated as the entry module.
+   */
+  cache(pluginId: string, urls: readonly string[]): Effect.Effect<void, PluginAssetCacheError>;
+
+  /**
+   * Drop all assets for a plugin (uninstall).
+   */
+  evict(pluginId: string): Effect.Effect<void, PluginAssetCacheError>;
+
+  /**
+   * Resolves a plugin asset URL to a platform-specific cached URL when one is available.
+   * Returns the original URL when no cached copy exists or the platform serves cached
+   * responses transparently (e.g. service worker fetch interception on web).
+   */
+  resolve(pluginId: string, url: string): Effect.Effect<string, PluginAssetCacheError>;
+
+  /**
+   * List currently cached plugin ids (diagnostic).
+   */
+  list(): Effect.Effect<readonly string[], PluginAssetCacheError>;
+}
+
+/**
+ * No-op implementation. Used when no platform cache is registered (tests, unsupported environments).
+ * Plugins still load — they just have no offline guarantee.
+ */
+export const noop = (): Cache => ({
+  cache: () => Effect.void,
+  evict: () => Effect.void,
+  resolve: (_pluginId, url) => Effect.succeed(url),
+  list: () => Effect.succeed([] as readonly string[]),
+});