@dxos/plugin-registry 0.8.4-main.8360d9e660 → 0.8.4-main.8baae0fced

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-registry",
-  "version": "0.8.4-main.8360d9e660",
+  "version": "0.8.4-main.8baae0fced",
   "description": "Braneframe plugin gallery",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,28 +8,48 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#meta": "./src/meta.ts",
+    "#operations": "./src/operations/index.ts",
+    "#plugin": {
+      "source": {
+        "workerd": "./src/RegistryPlugin.workerd.ts",
+        "node": "./src/RegistryPlugin.node.ts",
+        "default": "./src/RegistryPlugin.tsx"
+      },
+      "types": "./dist/types/src/RegistryPlugin.d.ts",
+      "workerd": "./dist/lib/neutral/RegistryPlugin.workerd.mjs",
+      "node": "./dist/lib/neutral/RegistryPlugin.node.mjs",
+      "default": "./dist/lib/neutral/RegistryPlugin.mjs"
+    },
+    "#translations": "./src/translations.ts",
+    "#types": "./src/types.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs",
-      "types": "./dist/types/src/index.d.ts"
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
     },
-    "./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"
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {}
-  },
   "files": [
     "dist",
     "src"
@@ -37,44 +57,47 @@
   "dependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/cli": "0.73.2",
-    "yaml": "^2.7.0",
-    "@dxos/app-toolkit": "0.8.4-main.8360d9e660",
-    "@dxos/client-protocol": "0.8.4-main.8360d9e660",
-    "@dxos/cli-util": "0.8.4-main.8360d9e660",
-    "@dxos/invariant": "0.8.4-main.8360d9e660",
-    "@dxos/echo": "0.8.4-main.8360d9e660",
-    "@dxos/effect": "0.8.4-main.8360d9e660",
-    "@dxos/app-framework": "0.8.4-main.8360d9e660",
-    "@dxos/operation": "0.8.4-main.8360d9e660",
-    "@dxos/plugin-graph": "0.8.4-main.8360d9e660",
-    "@dxos/react-ui-form": "0.8.4-main.8360d9e660",
-    "@dxos/react-ui-mosaic": "0.8.4-main.8360d9e660",
-    "@dxos/plugin-observability": "0.8.4-main.8360d9e660",
-    "@dxos/react-ui-stack": "0.8.4-main.8360d9e660",
-    "@dxos/util": "0.8.4-main.8360d9e660"
+    "yaml": "^2.8.2",
+    "@dxos/app-framework": "0.8.4-main.8baae0fced",
+    "@dxos/cli-util": "0.8.4-main.8baae0fced",
+    "@dxos/client-protocol": "0.8.4-main.8baae0fced",
+    "@dxos/app-toolkit": "0.8.4-main.8baae0fced",
+    "@dxos/context": "0.8.4-main.8baae0fced",
+    "@dxos/compute": "0.8.4-main.8baae0fced",
+    "@dxos/echo": "0.8.4-main.8baae0fced",
+    "@dxos/effect": "0.8.4-main.8baae0fced",
+    "@dxos/invariant": "0.8.4-main.8baae0fced",
+    "@dxos/log": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-graph": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-observability": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-form": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-mosaic": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-stack": "0.8.4-main.8baae0fced",
+    "@dxos/util": "0.8.4-main.8baae0fced"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/random": "0.8.4-main.8360d9e660",
-    "@dxos/react-ui": "0.8.4-main.8360d9e660",
-    "@dxos/storybook-utils": "0.8.4-main.8360d9e660",
-    "@dxos/ui-theme": "0.8.4-main.8360d9e660"
+    "vite": "^8.0.13",
+    "@dxos/plugin-testing": "0.8.4-main.8baae0fced",
+    "@dxos/random": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui": "0.8.4-main.8baae0fced",
+    "@dxos/storybook-utils": "0.8.4-main.8baae0fced",
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
     "@effect/platform": "0.94.4",
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/ui-theme": "0.8.4-main.8360d9e660",
-    "@dxos/react-ui": "0.8.4-main.8360d9e660"
+    "@dxos/react-ui": "0.8.4-main.8baae0fced",
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced"
   },
   "publishConfig": {
     "access": "public"

package/src/{cli/plugin.ts → RegistryPlugin.node.ts}

@@ -5,7 +5,7 @@
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 
-import { meta } from '../meta';
+import { meta } from '#meta';
 
 import { plugin } from './commands';
 
@@ -15,3 +15,5 @@ export const RegistryPlugin = Plugin.define(meta).pipe(
   }),
   Plugin.make,
 );
+
+export default RegistryPlugin;

package/src/RegistryPlugin.test.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { RegistryPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('RegistryPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [RegistryPlugin()],
+    });
+
+    // CLI commands activate on startup.
+    expect(harness.manager.getActive()).toContain(moduleId('cli-commands'));
+  });
+});

package/src/RegistryPlugin.tsx

@@ -2,17 +2,25 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Plugin } from '@dxos/app-framework';
+import { ActivationEvents, Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
 
-import { AppGraphBuilder, OperationResolver, ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
+import { AppGraphBuilder, DevPluginLoader, OperationHandler, ReactSurface, RegistrySettings } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
 
 export const RegistryPlugin = Plugin.define(meta).pipe(
   AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
-  AppPlugin.addOperationResolverModule({ activate: OperationResolver }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addSettingsModule({ activate: RegistrySettings }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
+  Plugin.addModule({
+    id: 'dev-plugin-loader',
+    activatesOn: ActivationEvents.Startup,
+    activate: DevPluginLoader,
+  }),
   Plugin.make,
 );
+
+export default RegistryPlugin;

package/src/RegistryPlugin.workerd.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+export const RegistryPlugin = Plugin.define(meta).pipe(Plugin.make);
+
+export default RegistryPlugin;

package/src/capabilities/app-graph-builder.ts

@@ -0,0 +1,200 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability, type Registry, Plugin } from '@dxos/app-framework';
+import { AppCapabilities, LayoutOperation, SettingsOperation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { GraphBuilder, Node, NodeMatcher } from '@dxos/plugin-graph';
+
+import { REGISTRY_ID, REGISTRY_KEY, registryCategoryId, meta } from '#meta';
+
+import { LOAD_PLUGIN_DIALOG } from '../containers';
+
+/**
+ * Turns a registry catalog entry into a minimal {@link Plugin.Plugin} so it
+ * can be attached as the graph node's `data`. The synthesized plugin has no
+ * modules and only exists so the article surface can render details for
+ * registry plugins that haven't been installed yet.
+ */
+const toDisplayPlugin = (entry: Registry.Plugin): Plugin.Plugin =>
+  ({
+    [Plugin.PluginTypeId]: Plugin.PluginTypeId,
+    meta: {
+      id: entry.id,
+      name: entry.name,
+      description: entry.description,
+      homePage: entry.homePage,
+      source: entry.source,
+      screenshots: entry.screenshots,
+      tags: entry.tags,
+      icon: entry.icon,
+      iconHue: entry.iconHue,
+    },
+    modules: [],
+  }) as Plugin.Plugin;
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+
+    const extensions = yield* Effect.all([
+      GraphBuilder.createExtension({
+        id: 'open-registry',
+        match: NodeMatcher.whenRoot,
+        actions: () =>
+          Effect.succeed([
+            {
+              id: 'open-registry',
+              data: () => Operation.invoke(SettingsOperation.OpenPluginRegistry),
+              properties: {
+                label: ['open-plugin-registry.label', { ns: meta.id }],
+                icon: 'ph--squares-four--regular',
+                disposition: 'menu',
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: 'registry',
+        match: NodeMatcher.whenRoot,
+        connector: () =>
+          Effect.succeed([
+            Node.make({
+              id: REGISTRY_ID,
+              type: meta.id,
+              properties: {
+                label: ['plugin-registry.label', { ns: meta.id }],
+                icon: 'ph--squares-four--regular',
+                disposition: 'pin-end',
+                position: 'first',
+                testId: 'treeView.pluginRegistry',
+              },
+              nodes: [
+                Node.make({
+                  id: registryCategoryId('bundled'),
+                  type: 'category',
+                  data: registryCategoryId('bundled'),
+                  properties: {
+                    label: ['bundled-plugins.label', { ns: meta.id }],
+                    icon: 'ph--squares-four--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.bundled',
+                  },
+                }),
+                Node.make({
+                  id: registryCategoryId('installed'),
+                  type: 'category',
+                  data: registryCategoryId('installed'),
+                  properties: {
+                    label: ['installed-plugins.label', { ns: meta.id }],
+                    icon: 'ph--check--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.installed',
+                  },
+                }),
+                Node.make({
+                  id: registryCategoryId('recommended'),
+                  type: 'category',
+                  data: registryCategoryId('recommended'),
+                  properties: {
+                    label: ['recommended-plugins.label', { ns: meta.id }],
+                    icon: 'ph--star--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.recommended',
+                  },
+                }),
+                Node.make({
+                  id: registryCategoryId('labs'),
+                  type: 'category',
+                  data: registryCategoryId('labs'),
+                  properties: {
+                    label: ['labs-plugins.label', { ns: meta.id }],
+                    icon: 'ph--flask--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.labs',
+                  },
+                }),
+                Node.make({
+                  id: registryCategoryId('registry'),
+                  type: 'category',
+                  data: registryCategoryId('registry'),
+                  properties: {
+                    label: ['registry-plugins.label', { ns: meta.id }],
+                    icon: 'ph--users-three--regular',
+                    key: REGISTRY_KEY,
+                    testId: 'pluginRegistry.registry',
+                  },
+                }),
+              ],
+            }),
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: 'actions',
+        match: NodeMatcher.whenId(`root/${REGISTRY_ID}`),
+        actions: () =>
+          Effect.succeed([
+            {
+              id: 'load-by-url',
+              data: Effect.fnUntraced(function* () {
+                yield* Operation.invoke(LayoutOperation.UpdateDialog, {
+                  subject: LOAD_PLUGIN_DIALOG,
+                  state: true,
+                });
+              }),
+              properties: {
+                label: ['load-by-url.label', { ns: meta.id }],
+                icon: 'ph--cloud-arrow-down--regular',
+                disposition: 'list-item-primary',
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: 'plugins',
+        match: NodeMatcher.whenId(`root/${REGISTRY_ID}`),
+        connector: (_node, get) => {
+          const manager = capabilities.get(Capabilities.PluginManager);
+          const installedIds = new Set(manager.getPlugins().map((plugin) => plugin.meta.id));
+
+          const installedNodes = manager.getPlugins().map((plugin) =>
+            Node.make({
+              id: plugin.meta.id,
+              type: 'org.dxos.plugin',
+              data: plugin,
+              properties: {
+                label: plugin.meta.name ?? plugin.meta.id,
+                icon: plugin.meta.icon ?? 'ph--circle--regular',
+                disposition: 'hidden',
+              },
+            }),
+          );
+
+          const registryEntries = get(manager.pluginRegistry.plugins).entries;
+          const registryNodes = registryEntries
+            .filter((entry) => !installedIds.has(entry.id))
+            .map((entry) => {
+              const plugin = toDisplayPlugin(entry);
+              return Node.make({
+                id: plugin.meta.id,
+                type: 'org.dxos.plugin',
+                data: plugin,
+                properties: {
+                  label: plugin.meta.name ?? plugin.meta.id,
+                  icon: plugin.meta.icon ?? 'ph--circle--regular',
+                  disposition: 'hidden',
+                },
+              });
+            });
+
+          return Effect.succeed([...installedNodes, ...registryNodes]);
+        },
+      }),
+    ]);
+
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/dev-plugin-loader.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { log } from '@dxos/log';
+
+import { RegistryCapabilities } from '../types';
+
+/**
+ * Startup module that auto-loads a locally-served dev plugin when the user has
+ * the toggle enabled in registry settings. Failures (dev server offline, 404,
+ * timeout) are logged and swallowed so a stale dev URL never blocks app boot —
+ * the toggle stays on, the next reload retries.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const manager = yield* Capability.get(Capabilities.PluginManager);
+    const registry = yield* Capability.get(Capabilities.AtomRegistry);
+    const settingsAtom = yield* Capability.get(RegistryCapabilities.Settings);
+
+    const settings = registry.get(settingsAtom);
+    const url = settings.devPluginUrl?.trim();
+    if (!settings.devPluginEnabled || !url) {
+      return [];
+    }
+
+    log.info('loading dev plugin from registry settings', { url });
+    yield* manager.add(url).pipe(
+      Effect.flatMap((plugin) => manager.enable(plugin.meta.id)),
+      Effect.tapError((error) => Effect.sync(() => log.warn('dev plugin auto-load failed', { url, error }))),
+      Effect.ignore,
+    );
+
+    return [];
+  }),
+);

package/src/capabilities/index.ts

@@ -2,6 +2,14 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './app-graph-builder';
-export * from './operation-resolver';
-export * from './react-surface';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
+export const DevPluginLoader = Capability.lazy('DevPluginLoader', () => import('./dev-plugin-loader'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const RegistrySettings = Capability.lazy('RegistrySettings', () => import('./settings'));

package/src/capabilities/operation-handler.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import type { OperationHandlerSet } from '@dxos/compute';
+
+import { RegistryOperationHandlerSet } from '#operations';
+
+export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Capabilities.OperationHandler, RegistryOperationHandlerSet);
+  }),
+);

package/src/capabilities/react-surface.tsx

@@ -0,0 +1,145 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React, { type ComponentProps, useMemo } from 'react';
+
+import { Capabilities, Capability, Plugin } from '@dxos/app-framework';
+import { Surface, usePluginManager } from '@dxos/app-framework/ui';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { AppSurface } from '@dxos/app-toolkit/ui';
+
+import { DisableDependentsAlert } from '#components';
+import {
+  LOAD_PLUGIN_DIALOG,
+  LoadPluginDialog,
+  PluginArticle,
+  PublicRegistryArticle,
+  RegistryArticle,
+  RegistrySettingsContainer,
+} from '#containers';
+import { DISABLE_DEPENDENTS_DIALOG, meta, registryCategoryId } from '#meta';
+
+import { useAutoTags, useRegistryPlugins, useRemotePluginIds } from '../hooks';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: 'bundled',
+        filter: AppSurface.literal(AppSurface.Article, registryCategoryId('bundled')),
+        component: () => {
+          const manager = usePluginManager();
+          const remoteIds = useRemotePluginIds();
+          const core = useMemo(() => manager.getCore(), [manager]);
+          const predicate = useMemo<PluginPredicate>(
+            () =>
+              ({ meta }) =>
+                !core.includes(meta.id) && !remoteIds.has(meta.id),
+            [core, remoteIds],
+          );
+
+          return <FilteredRegistryArticle id={registryCategoryId('bundled')} filter={predicate} />;
+        },
+      }),
+      Surface.create({
+        id: 'installed',
+        filter: AppSurface.literal(AppSurface.Article, registryCategoryId('installed')),
+        component: () => {
+          const manager = usePluginManager();
+          const core = useMemo(() => manager.getCore(), [manager]);
+          const enabled = useMemo(() => manager.getEnabled(), [manager]);
+          const predicate = useMemo<PluginPredicate>(
+            () =>
+              ({ meta }) =>
+                !core.includes(meta.id) && enabled.includes(meta.id),
+            [core, enabled],
+          );
+
+          return <FilteredRegistryArticle id={registryCategoryId('installed')} filter={predicate} />;
+        },
+      }),
+      Surface.create({
+        id: 'recommended',
+        filter: AppSurface.literal(AppSurface.Article, registryCategoryId('recommended')),
+        component: () => {
+          const manager = usePluginManager();
+          const remoteIds = useRemotePluginIds();
+          const core = useMemo(() => manager.getCore(), [manager]);
+          const predicate = useMemo<PluginPredicate>(
+            () =>
+              ({ meta }) =>
+                !core.includes(meta.id) && !remoteIds.has(meta.id) && !meta.tags?.includes('labs'),
+            [core, remoteIds],
+          );
+
+          return <FilteredRegistryArticle id={registryCategoryId('recommended')} filter={predicate} />;
+        },
+      }),
+      Surface.create({
+        id: 'labs',
+        filter: AppSurface.literal(AppSurface.Article, registryCategoryId('labs')),
+        component: () => {
+          const predicate = useMemo<PluginPredicate>(
+            () =>
+              ({ meta }) =>
+                meta.tags?.includes('labs') ?? false,
+            [],
+          );
+
+          return <FilteredRegistryArticle id={registryCategoryId('labs')} filter={predicate} />;
+        },
+      }),
+      Surface.create({
+        id: 'registry',
+        filter: AppSurface.literal(AppSurface.Article, registryCategoryId('registry')),
+        component: () => <PublicRegistryArticle id={registryCategoryId('registry')} />,
+      }),
+      Surface.create({
+        id: 'plugin-details',
+        filter: AppSurface.subject(AppSurface.Article, Plugin.isPlugin),
+        component: ({ data: { subject } }) => {
+          return <PluginArticle subject={subject} />;
+        },
+      }),
+      Surface.create({
+        id: LOAD_PLUGIN_DIALOG,
+        filter: AppSurface.component(AppSurface.Dialog, LOAD_PLUGIN_DIALOG),
+        component: () => <LoadPluginDialog />,
+      }),
+      Surface.create({
+        id: DISABLE_DEPENDENTS_DIALOG,
+        filter: AppSurface.component<ComponentProps<typeof DisableDependentsAlert>>(
+          AppSurface.Dialog,
+          DISABLE_DEPENDENTS_DIALOG,
+        ),
+        component: ({ data }) => <DisableDependentsAlert {...data.props} />,
+      }),
+      Surface.create({
+        id: 'plugin-settings',
+        role: 'article',
+        filter: (data): data is { subject: AppCapabilities.Settings } =>
+          AppCapabilities.isSettings(data.subject) && data.subject.prefix === meta.id,
+        component: ({ data: { subject } }) => <RegistrySettingsContainer subject={subject} />,
+      }),
+    ]),
+  ),
+);
+
+type PluginPredicate = (plugin: Plugin.Plugin) => boolean;
+
+/**
+ * Renders the {@link RegistryArticle} surface filtered by an arbitrary
+ * predicate computed against the live plugin list. Centralises the
+ * `usePluginManager` + `useRegistryPlugins` + `useAutoTags` wiring shared
+ * by every category surface.
+ */
+const FilteredRegistryArticle = ({ id, filter }: { id: string; filter: PluginPredicate }) => {
+  const manager = usePluginManager();
+  const { entries } = useRegistryPlugins();
+  const extraTagsById = useAutoTags(entries);
+  const filtered = useMemo(() => manager.getPlugins().filter(filter), [manager, filter]);
+
+  return <RegistryArticle id={id} plugins={filtered} extraTagsById={extraTagsById} />;
+};