@dxos/plugin-settings 0.8.4-main.51f1e5ca51 → 0.8.4-main.60689f5b1c

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-settings",
-  "version": "0.8.4-main.51f1e5ca51",
+  "version": "0.8.4-main.60689f5b1c",
   "description": "DXOS Settings plugin for managing application settings.",
   "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": true,
   "type": "module",
@@ -16,27 +16,30 @@
     "#capabilities": "./src/capabilities/index.ts",
     "#meta": "./src/meta.ts",
     "#operations": "./src/operations/index.ts",
+    "#plugin": "./src/SettingsPlugin.ts",
     "#translations": "./src/translations.ts",
     "#types": "./src/types/index.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"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./testing": {
+      "source": "./src/testing.ts",
+      "types": "./dist/types/src/testing.d.ts",
+      "default": "./dist/lib/neutral/testing.mjs"
     },
     "./translations": {
       "source": "./src/translations.ts",
       "types": "./dist/types/src/translations.d.ts",
-      "browser": "./dist/lib/browser/translations.mjs",
-      "node": "./dist/lib/node-esm/translations.mjs"
-    },
-    "./types": {
-      "source": "./src/types/index.ts",
-      "types": "./dist/types/src/types/index.d.ts",
-      "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -45,16 +48,17 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/app-graph": "0.8.4-main.51f1e5ca51",
-    "@dxos/app-framework": "0.8.4-main.51f1e5ca51",
-    "@dxos/compute": "0.8.4-main.51f1e5ca51",
-    "@dxos/util": "0.8.4-main.51f1e5ca51",
-    "@dxos/app-toolkit": "0.8.4-main.51f1e5ca51"
+    "@dxos/app-framework": "0.8.4-main.60689f5b1c",
+    "@dxos/app-graph": "0.8.4-main.60689f5b1c",
+    "@dxos/app-toolkit": "0.8.4-main.60689f5b1c",
+    "@dxos/compute": "0.8.4-main.60689f5b1c",
+    "@dxos/util": "0.8.4-main.60689f5b1c"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
     "effect": "3.20.0",
-    "react": "~19.2.3"
+    "react": "~19.2.3",
+    "@dxos/plugin-graph": "0.8.4-main.60689f5b1c"
   },
   "peerDependencies": {
     "effect": "3.20.0",

package/src/SettingsPlugin.test.ts

@@ -0,0 +1,33 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ProcessManagerPlugin } from '@dxos/app-framework';
+import { createTestApp } from '@dxos/app-framework/testing';
+import { GraphPlugin } from '@dxos/plugin-graph/plugin';
+
+import { SettingsPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('SettingsPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    // Use createTestApp directly to avoid a circular dep with plugin-testing.
+    // GraphPlugin fires SetupAppGraph (via firesBeforeActivation) during Startup,
+    // activating SettingsAppGraphBuilder. ProcessManagerPlugin fires SetupProcessManager
+    // during Startup, activating OperationHandler.
+    await using harness = await createTestApp({
+      plugins: [GraphPlugin(), ProcessManagerPlugin(), SettingsPlugin()],
+    });
+
+    // SettingsAppGraphBuilder activates on SetupAppGraph (fired by GraphPlugin during Startup).
+    // OperationHandler activates on SetupProcessManager (fired by ProcessManagerPlugin during Startup).
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('SettingsAppGraphBuilder'), moduleId('OperationHandler')]),
+    );
+  });
+});

package/src/SettingsPlugin.ts

@@ -15,3 +15,5 @@ export const SettingsPlugin = Plugin.define(meta).pipe(
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.make,
 );
+
+export default SettingsPlugin;

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

@@ -54,7 +54,7 @@ export default Capability.makeModule(
                 label: ['plugin-settings.label', { ns: meta.id }],
                 icon: 'ph--gear--regular',
                 disposition: 'pin-end',
-                position: 'hoist',
+                position: 'first',
                 testId: 'treeView.appSettings',
               },
             }),
@@ -78,6 +78,7 @@ export default Capability.makeModule(
                 return [plugin.meta, settings];
               })
               .filter(isNonNullable)
+              .sort(([a], [b]) => (a.name ?? a.id).localeCompare(b.name ?? b.id, undefined, { sensitivity: 'base' }))
               .map(([meta, settings]: [Plugin$.Meta, AppCapabilities.Settings]) =>
                 Node.make({
                   id: `${SETTINGS_KEY}:${meta.id.replaceAll('/', ':')}`,

package/src/index.ts

@@ -3,4 +3,5 @@
 //
 
 export * from './actions';
-export * from './SettingsPlugin';
+export * from './meta';
+export { SETTINGS_ID, SETTINGS_KEY } from './types';

package/src/meta.ts

@@ -7,4 +7,6 @@ import { type Plugin } from '@dxos/app-framework';
 export const meta: Plugin.Meta = {
   id: 'org.dxos.plugin.settings',
   name: 'Settings',
+  author: 'DXOS',
+  tags: ['system'],
 };

package/src/plugin.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const SettingsPlugin = Plugin.lazy(meta, () => import('#plugin'));
+
+export { SettingsOperationHandlerSet } from './operations';

package/src/testing.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// Eager re-export of `SettingsPlugin`. See `@dxos/plugin-testing/src/core.ts`
+// for the rationale.
+export * from './SettingsPlugin';

package/dist/lib/browser/meta.json

@@ -1 +0,0 @@
-{"inputs":{"src/actions.ts":{"bytes":2673,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#types","kind":"import-statement","external":true}],"format":"esm"},"src/SettingsPlugin.ts":{"bytes":2269,"imports":[{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#capabilities","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#translations","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":477,"imports":[{"path":"src/actions.ts","kind":"import-statement","original":"./actions"},{"path":"src/SettingsPlugin.ts","kind":"import-statement","original":"./SettingsPlugin"}],"format":"esm"},"src/translations.ts":{"bytes":1078,"imports":[{"path":"#meta","kind":"import-statement","external":true}],"format":"esm"},"src/types/index.ts":{"bytes":854,"imports":[{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":2437},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#types","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#capabilities","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#translations","kind":"import-statement","external":true}],"exports":["SETTINGS_ID","SETTINGS_KEY","SettingsAction","SettingsPlugin"],"entryPoint":"src/index.ts","inputs":{"src/actions.ts":{"bytesInOutput":637},"src/index.ts":{"bytesInOutput":0},"src/SettingsPlugin.ts":{"bytesInOutput":508}},"bytes":1302},"dist/lib/browser/translations.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":566},"dist/lib/browser/translations.mjs":{"imports":[{"path":"#meta","kind":"import-statement","external":true}],"exports":["translations"],"entryPoint":"src/translations.ts","inputs":{"src/translations.ts":{"bytesInOutput":161}},"bytes":253},"dist/lib/browser/types/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":444},"dist/lib/browser/types/index.mjs":{"imports":[{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"exports":["SETTINGS_ID","SETTINGS_KEY"],"entryPoint":"src/types/index.ts","inputs":{"src/types/index.ts":{"bytesInOutput":140}},"bytes":239}}}

package/dist/lib/browser/types/index.mjs

@@ -1,9 +0,0 @@
-// src/types/index.ts
-import { pinnedWorkspaceId } from "@dxos/app-toolkit";
-var SETTINGS_ID = pinnedWorkspaceId("dxos:settings");
-var SETTINGS_KEY = "settings";
-export {
-  SETTINGS_ID,
-  SETTINGS_KEY
-};
-//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs

@@ -1,44 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/actions.ts
-import * as Schema from "effect/Schema";
-import { meta } from "#meta";
-import { SETTINGS_ID, SETTINGS_KEY } from "#types";
-(function(SettingsAction2) {
-  class Open extends Schema.TaggedClass()(`${meta.id}.open`, {
-    input: Schema.Struct({
-      plugin: Schema.optional(Schema.String)
-    }),
-    output: Schema.Void
-  }) {
-  }
-  SettingsAction2.Open = Open;
-  class OpenPluginRegistry extends Schema.TaggedClass()(`${meta.id}.open-plugin-registry`, {
-    input: Schema.Void,
-    output: Schema.Void
-  }) {
-  }
-  SettingsAction2.OpenPluginRegistry = OpenPluginRegistry;
-})(SettingsAction || (SettingsAction = {}));
-var SettingsAction;
-
-// src/SettingsPlugin.ts
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { OperationHandler, SettingsAppGraphBuilder } from "#capabilities";
-import { meta as meta2 } from "#meta";
-import { translations } from "#translations";
-var SettingsPlugin = Plugin.define(meta2).pipe(AppPlugin.addAppGraphModule({
-  activate: SettingsAppGraphBuilder
-}), AppPlugin.addOperationHandlerModule({
-  activate: OperationHandler
-}), AppPlugin.addTranslationsModule({
-  translations
-}), Plugin.make);
-export {
-  SETTINGS_ID,
-  SETTINGS_KEY,
-  SettingsAction,
-  SettingsPlugin
-};
-//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/actions.ts", "../../../src/SettingsPlugin.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { meta } from '#meta';\nimport { SETTINGS_ID, SETTINGS_KEY } from '#types';\n\nexport { SETTINGS_ID, SETTINGS_KEY };\n\nexport namespace SettingsAction {\n  export class Open extends Schema.TaggedClass<Open>()(`${meta.id}.open`, {\n    input: Schema.Struct({\n      plugin: Schema.optional(Schema.String),\n    }),\n    output: Schema.Void,\n  }) {}\n\n  export class OpenPluginRegistry extends Schema.TaggedClass<OpenPluginRegistry>()(`${meta.id}.open-plugin-registry`, {\n    input: Schema.Void,\n    output: Schema.Void,\n  }) {}\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler, SettingsAppGraphBuilder } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nexport const SettingsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: SettingsAppGraphBuilder }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.make,\n);\n"],
-  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,YAAY;AACrB,SAASC,aAAaC,oBAAoB;UAIzBC,iBAAAA;EACR,MAAMC,aAAoBC,mBAAW,EAAS,GAAGC,KAAKC,EAAE,SAAS;IACtEC,OAAcC,cAAO;MACnBC,QAAeC,gBAAgBC,aAAM;IACvC,CAAA;IACAC,QAAeC;EACjB,CAAA,EAAA;EAAI;kBALSV,OAAAA;EAON,MAAMW,2BAAkCV,mBAAW,EAAuB,GAAGC,KAAKC,EAAE,yBAAyB;IAClHC,OAAcM;IACdD,QAAeC;EACjB,CAAA,EAAA;EAAI;kBAHSC,qBAAAA;AAIf,GAZiBZ,mBAAAA,iBAAAA,CAAAA,EAAAA;;;;ACPjB,SAASa,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,kBAAkBC,+BAA+B;AAC1D,SAASC,QAAAA,aAAY;AACrB,SAASC,oBAAoB;AAEtB,IAAMC,iBAAiBN,OAAOO,OAAOH,KAAAA,EAAMI,KAChDP,UAAUQ,kBAAkB;EAAEC,UAAUP;AAAwB,CAAA,GAChEF,UAAUU,0BAA0B;EAAED,UAAUR;AAAiB,CAAA,GACjED,UAAUW,sBAAsB;EAAEP;AAAa,CAAA,GAC/CL,OAAOa,IAAI;",
-  "names": ["Schema", "meta", "SETTINGS_ID", "SETTINGS_KEY", "SettingsAction", "Open", "TaggedClass", "meta", "id", "input", "Struct", "plugin", "optional", "String", "output", "Void", "OpenPluginRegistry", "Plugin", "AppPlugin", "OperationHandler", "SettingsAppGraphBuilder", "meta", "translations", "SettingsPlugin", "define", "pipe", "addAppGraphModule", "activate", "addOperationHandlerModule", "addTranslationsModule", "make"]
-}

package/dist/lib/node-esm/meta.json

@@ -1 +0,0 @@
-{"inputs":{"src/actions.ts":{"bytes":2673,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#types","kind":"import-statement","external":true}],"format":"esm"},"src/SettingsPlugin.ts":{"bytes":2269,"imports":[{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#capabilities","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#translations","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":477,"imports":[{"path":"src/actions.ts","kind":"import-statement","original":"./actions"},{"path":"src/SettingsPlugin.ts","kind":"import-statement","original":"./SettingsPlugin"}],"format":"esm"},"src/translations.ts":{"bytes":1078,"imports":[{"path":"#meta","kind":"import-statement","external":true}],"format":"esm"},"src/types/index.ts":{"bytes":854,"imports":[{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":2439},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#types","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#capabilities","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"#translations","kind":"import-statement","external":true}],"exports":["SETTINGS_ID","SETTINGS_KEY","SettingsAction","SettingsPlugin"],"entryPoint":"src/index.ts","inputs":{"src/actions.ts":{"bytesInOutput":637},"src/index.ts":{"bytesInOutput":0},"src/SettingsPlugin.ts":{"bytesInOutput":508}},"bytes":1395},"dist/lib/node-esm/translations.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":568},"dist/lib/node-esm/translations.mjs":{"imports":[{"path":"#meta","kind":"import-statement","external":true}],"exports":["translations"],"entryPoint":"src/translations.ts","inputs":{"src/translations.ts":{"bytesInOutput":161}},"bytes":346},"dist/lib/node-esm/types/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":446},"dist/lib/node-esm/types/index.mjs":{"imports":[{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"exports":["SETTINGS_ID","SETTINGS_KEY"],"entryPoint":"src/types/index.ts","inputs":{"src/types/index.ts":{"bytesInOutput":140}},"bytes":332}}}

package/dist/lib/node-esm/translations.mjs

@@ -1,17 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/translations.ts
-import { meta } from "#meta";
-var translations = [
-  {
-    "en-US": {
-      [meta.id]: {
-        "plugin-settings.label": "Plugin Settings"
-      }
-    }
-  }
-];
-export {
-  translations
-};
-//# sourceMappingURL=translations.mjs.map

package/dist/lib/node-esm/translations.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/translations.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Resource } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [meta.id]: {\n        'plugin-settings.label': 'Plugin Settings',\n      },\n    },\n  },\n] as const satisfies Resource[];\n"],
-  "mappings": ";;;AAMA,SAASA,YAAY;AAEd,IAAMC,eAAe;EAC1B;IACE,SAAS;MACP,CAACD,KAAKE,EAAE,GAAG;QACT,yBAAyB;MAC3B;IACF;EACF;;",
-  "names": ["meta", "translations", "id"]
-}

package/dist/lib/node-esm/types/index.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/types/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { pinnedWorkspaceId } from '@dxos/app-toolkit';\n\nexport const SETTINGS_ID = pinnedWorkspaceId('dxos:settings');\nexport const SETTINGS_KEY = 'settings';\n"],
-  "mappings": ";;;AAIA,SAASA,yBAAyB;AAE3B,IAAMC,cAAcD,kBAAkB,eAAA;AACtC,IAAME,eAAe;",
-  "names": ["pinnedWorkspaceId", "SETTINGS_ID", "SETTINGS_KEY"]
-}