@dxos/plugin-settings 0.9.1-main.c7dcc2e112 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-settings",
-  "version": "0.9.1-main.c7dcc2e112",
+  "version": "0.10.0",
   "description": "DXOS Settings plugin for managing application settings.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -14,6 +14,7 @@
   "type": "module",
   "imports": {
     "#capabilities": "./src/capabilities/index.ts",
+    "#containers": "./src/containers/index.ts",
     "#meta": "./src/meta.ts",
     "#operations": "./src/operations/index.ts",
     "#plugin": "./src/SettingsPlugin.ts",
@@ -49,23 +50,23 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/app-framework": "0.9.1-main.c7dcc2e112",
-    "@dxos/app-graph": "0.9.1-main.c7dcc2e112",
-    "@dxos/app-toolkit": "0.9.1-main.c7dcc2e112",
-    "@dxos/keys": "0.9.1-main.c7dcc2e112",
-    "@dxos/compute": "0.9.1-main.c7dcc2e112",
-    "@dxos/react-ui-form": "0.9.1-main.c7dcc2e112",
-    "@dxos/util": "0.9.1-main.c7dcc2e112"
+    "@dxos/app-toolkit": "0.10.0",
+    "@dxos/app-framework": "0.10.0",
+    "@dxos/app-graph": "0.10.0",
+    "@dxos/keys": "0.10.0",
+    "@dxos/react-ui-form": "0.10.0",
+    "@dxos/util": "0.10.0",
+    "@dxos/compute": "0.10.0"
   },
   "devDependencies": {
-    "@types/react": "~19.2.7",
-    "effect": "3.21.3",
-    "react": "~19.2.3",
-    "@dxos/plugin-graph": "0.9.1-main.c7dcc2e112"
+    "@types/react": "~19.2.17",
+    "effect": "3.21.4",
+    "react": "~19.2.7",
+    "@dxos/plugin-graph": "0.10.0"
   },
   "peerDependencies": {
-    "effect": "3.21.3",
-    "react": "~19.2.3"
+    "effect": "3.21.4",
+    "react": "~19.2.7"
   },
   "publishConfig": {
     "access": "public"

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

@@ -8,7 +8,7 @@ import { Capabilities, Capability, type Plugin as Plugin$ } from '@dxos/app-fram
 import { GraphBuilder, Node, NodeMatcher } from '@dxos/app-graph';
 import { AppCapabilities, Paths, SettingsOperation } from '@dxos/app-toolkit';
 import { Operation } from '@dxos/compute';
-import { isNonNullable } from '@dxos/util';
+import { Position, isNonNullable } from '@dxos/util';
 
 import { meta } from '#meta';
 
@@ -54,7 +54,7 @@ export default Capability.makeModule(
                 label: ['plugin-settings.label', { ns: meta.profile.key }],
                 icon: 'ph--gear--regular',
                 disposition: 'pin-end',
-                position: 'first',
+                position: Position.first,
                 testId: 'treeView.appSettings',
               },
             }),

package/src/capabilities/react-surface.tsx

@@ -6,42 +6,21 @@ import * as Effect from 'effect/Effect';
 import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import { Surface, useSettingsState } from '@dxos/app-framework/ui';
-import { type AppCapabilities } from '@dxos/app-toolkit';
+import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
-import { Settings as SettingsForm } from '@dxos/react-ui-form';
+import { Position } from '@dxos/util';
 
-/**
- * Generic settings surface rendered for any plugin that contributes an
- * `AppCapabilities.Settings` entry. It drives a schema-based form from the
- * contributed `schema`/`atom`, so plugins whose settings are plain editable
- * fields need not register a bespoke settings surface.
- *
- * No section title is rendered: the settings plank heading already names the
- * plugin. Registered with `position: 'last'` so a plugin-specific surface
- * (matching by prefix) always wins under the settings article's `limit={1}`
- * dispatch.
- */
-const DefaultSettings = ({ subject }: { subject: AppCapabilities.Settings }) => {
-  const { settings, updateSettings } = useSettingsState<Record<string, any>>(subject.atom);
-
-  return (
-    <SettingsForm.Viewport>
-      <SettingsForm.FieldSet
-        schema={subject.schema}
-        values={settings}
-        onValuesChanged={(values) => updateSettings(() => values)}
-      />
-    </SettingsForm.Viewport>
-  );
-};
+import { DefaultSettings } from '#containers';
 
+// `DefaultSettings` is registered with `position: Position.last` so a
+// plugin-specific surface (matching by prefix) always wins under the settings
+// article's `limit={1}` dispatch.
 export default Capability.makeModule(() =>
   Effect.succeed(
     Capability.contributes(Capabilities.ReactSurface, [
       Surface.create({
         id: 'defaultPluginSettings',
-        position: 'last',
+        position: Position.last,
         filter: AppSurface.settings(AppSurface.Article),
         component: ({ data: { subject } }) => <DefaultSettings subject={subject} />,
       }),

package/src/containers/DefaultSettings/DefaultSettings.tsx

@@ -0,0 +1,46 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { usePluginManager, useSettingsState } from '@dxos/app-framework/ui';
+import { type AppCapabilities } from '@dxos/app-toolkit';
+import { Form } from '@dxos/react-ui-form';
+
+export type DefaultSettingsProps = {
+  subject: AppCapabilities.Settings;
+};
+
+/**
+ * Generic settings surface rendered for any plugin that contributes an
+ * `AppCapabilities.Settings` entry. It drives a schema-based form from the
+ * contributed `schema`/`atom`, so plugins whose settings are plain editable
+ * fields need not register a bespoke settings surface.
+ *
+ * The contributing plugin's name is rendered as the section heading (resolved
+ * by matching `subject.prefix` against each plugin's `meta.profile.key`) so
+ * every schema-driven settings article shows a consistent title.
+ */
+export const DefaultSettings = ({ subject }: DefaultSettingsProps) => {
+  const manager = usePluginManager();
+  const { settings, updateSettings } = useSettingsState<Record<string, any>>(subject.atom);
+  const title = manager.getPlugins().find((plugin) => plugin.meta.profile.key === subject.prefix)?.meta.profile.name;
+
+  return (
+    <Form.Root
+      schema={subject.schema}
+      variant='settings'
+      values={settings}
+      onValuesChanged={(values) => updateSettings(() => values)}
+    >
+      <Form.Viewport scroll>
+        <Form.Content>
+          <Form.Section title={title ?? subject.prefix}>
+            <Form.FieldSet />
+          </Form.Section>
+        </Form.Content>
+      </Form.Viewport>
+    </Form.Root>
+  );
+};

package/src/containers/DefaultSettings/index.ts

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

package/src/containers/index.ts

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

package/src/index.ts

@@ -4,4 +4,4 @@
 
 export * from './actions';
 export * from './meta';
-export { SETTINGS_ID, SETTINGS_KEY, getPluginSettingsSectionPath, getPluginRegistrySectionPath } from './types';
+export { SETTINGS_ID, SETTINGS_KEY, getPluginRegistrySectionPath, getPluginSettingsSectionPath } from './types';