@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

package/dist/lib/node-esm/capability-RDCTCARS.mjs

@@ -0,0 +1,36 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  make,
+  make2
+} from "./chunk-URWHJQT2.mjs";
+import "./chunk-VKHGNEDB.mjs";
+import {
+  capabilities_exports
+} from "./chunk-G3RTFSNG.mjs";
+import "./chunk-WZCSOX5Q.mjs";
+import "./chunk-EL3R25OQ.mjs";
+import "./chunk-DER2JDBT.mjs";
+import "./chunk-W4K4RU4S.mjs";
+import "./chunk-ZZ7CKK6W.mjs";
+import "./chunk-DAYWQOOQ.mjs";
+import {
+  capability_exports
+} from "./chunk-42KBWDE4.mjs";
+import "./chunk-HSLMI22Q.mjs";
+
+// src/plugin-operation/history/capability.ts
+import * as Effect from "effect/Effect";
+var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
+  const capabilities = yield* capability_exports.Service;
+  const undoRegistry = make(() => capabilities.getAll(capabilities_exports.UndoMapping).flat());
+  const invoker = yield* capability_exports.get(capabilities_exports.OperationInvoker);
+  const historyTracker = make2(invoker, undoRegistry);
+  return [
+    capability_exports.contributes(capabilities_exports.UndoRegistry, undoRegistry),
+    capability_exports.contributes(capabilities_exports.HistoryTracker, historyTracker)
+  ];
+}));
+export {
+  capability_default as default
+};
+//# sourceMappingURL=capability-RDCTCARS.mjs.map

package/dist/lib/node-esm/capability-RDCTCARS.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-operation/history/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { type OperationInvoker } from '@dxos/operation';\n\nimport { Capabilities } from '../../common';\nimport { Capability } from '../../core';\nimport * as HistoryTracker from './history-tracker';\nimport * as UndoRegistry from './undo-registry';\n\n//\n// Capability Module - contributes both UndoRegistry and HistoryTracker.\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the context for synchronous access in callbacks.\n    const capabilities = yield* Capability.Service;\n\n    // Create UndoRegistry.\n    const undoRegistry = UndoRegistry.make(() => capabilities.getAll(Capabilities.UndoMapping).flat());\n\n    // Create HistoryTracker (depends on UndoRegistry and OperationInvoker).\n    const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n    // Cast to internal type - the factory always returns OperationInvokerInternal.\n    const historyTracker = HistoryTracker.make(invoker as OperationInvoker.OperationInvokerInternal, undoRegistry);\n\n    return [\n      Capability.contributes(Capabilities.UndoRegistry, undoRegistry),\n      Capability.contributes(Capabilities.HistoryTracker, historyTracker),\n    ];\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAaxB,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,eAAe,OAAOH,mBAAWI;AAGvC,QAAMC,eAA4BC,KAAK,MAAMH,aAAaI,OAAOC,qBAAaC,WAAW,EAAEC,KAAI,CAAA;AAG/F,QAAMC,UAAU,OAAOX,mBAAWY,IAAIJ,qBAAaK,gBAAgB;AAEnE,QAAMC,iBAAgCR,MAAKK,SAAsDN,YAAAA;AAEjG,SAAO;IACLL,mBAAWe,YAAYP,qBAAaQ,cAAcX,YAAAA;IAClDL,mBAAWe,YAAYP,qBAAaS,gBAAgBH,cAAAA;;AAExD,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "makeModule", "fnUntraced", "capabilities", "Service", "undoRegistry", "make", "getAll", "Capabilities", "UndoMapping", "flat", "invoker", "get", "OperationInvoker", "historyTracker", "contributes", "UndoRegistry", "HistoryTracker"]
+}

package/dist/lib/node-esm/chunk-42KBWDE4.mjs

@@ -0,0 +1,80 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/capability.ts
+var capability_exports = {};
+__export(capability_exports, {
+  ModuleTag: () => ModuleTag,
+  Service: () => Service,
+  atom: () => atom,
+  atomByModule: () => atomByModule,
+  contributes: () => contributes,
+  get: () => get,
+  getAll: () => getAll,
+  getModuleTag: () => getModuleTag,
+  lazy: () => lazy,
+  make: () => make,
+  makeModule: () => makeModule,
+  waitFor: () => waitFor
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+var Service = class extends Context.Tag("@dxos/app-framework/CapabilityManager")() {
+};
+var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
+  try: () => manager.get(interfaceDef),
+  catch: (error) => error instanceof Error ? error : new Error(String(error))
+}));
+var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(interfaceDef));
+var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
+var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
+var atomByModule = (interfaceDef) => Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));
+var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
+var make = (identifier) => {
+  return {
+    identifier
+  };
+};
+var contributes = (interfaceDef, implementation, deactivate) => {
+  return {
+    interface: interfaceDef,
+    implementation,
+    deactivate
+  };
+};
+var lazy = (name, c) => {
+  const lazyFn = (props) => Effect.gen(function* () {
+    const { default: getCapability } = yield* Effect.promise(() => c());
+    const result = yield* getCapability(props);
+    const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [
+      result
+    ];
+    return normalized;
+  });
+  return Object.assign(lazyFn, {
+    [ModuleTag]: name
+  });
+};
+var getModuleTag = (capability) => {
+  return capability && typeof capability === "function" && ModuleTag in capability ? String(capability[ModuleTag]) : void 0;
+};
+var makeModule = (fn) => fn;
+
+export {
+  Service,
+  get,
+  getAll,
+  waitFor,
+  atom,
+  atomByModule,
+  ModuleTag,
+  make,
+  contributes,
+  lazy,
+  getModuleTag,
+  makeModule,
+  capability_exports
+};
+//# sourceMappingURL=chunk-42KBWDE4.mjs.map

package/dist/lib/node-esm/chunk-42KBWDE4.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\n\nimport type * as CapabilityManager from './capability-manager';\nimport type * as Plugin from './plugin';\n\n//\n// Capability Service Layer\n//\n\n/**\n * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.\n * This allows capability modules to access the capability manager without having it passed as an argument.\n */\nexport class Service extends Context.Tag('@dxos/app-framework/CapabilityManager')<\n  Service,\n  CapabilityManager.CapabilityManager\n>() {}\n\n/**\n * Get a single capability from the capability manager.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation.\n * @throws If no capability is found.\n */\n// TODO(wittjosiah): Add custom tagged errors (Data.TaggedError) for app-framework to enable\n//   type-safe error handling with Effect. Consider CapabilityNotFoundError, ModuleActivationError, etc.\nexport const get = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) =>\n    Effect.try({\n      try: () => manager.get(interfaceDef),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }),\n  );\n\n/**\n * Get all capabilities from the capability manager for a given interface.\n * @param interfaceDef The interface definition of the capability.\n * @returns An array of capability implementations.\n */\nexport const getAll = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T[], never, Service> =>\n  Effect.map(Service, (manager) => manager.getAll(interfaceDef));\n\n/**\n * Wait for a capability to be available.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation once available.\n */\nexport const waitFor = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));\n\n/**\n * Get the Atom reference to capabilities for reactive access.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing the array of capability implementations.\n */\nexport const atom = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<Atom.Atom<T[]>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atom(interfaceDef));\n\n/**\n * Get capabilities grouped by the module that contributed them.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing a record from module ID to capability implementations.\n */\nexport const atomByModule = <T>(\n  interfaceDef: InterfaceDef<T>,\n): Effect.Effect<Atom.Atom<Record<string, T[]>>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));\n\nconst InterfaceDefTypeId: unique symbol = Symbol.for('InterfaceDefTypeId');\n\n/**\n * Symbol used to tag lazy capability functions with their module ID.\n */\nexport const ModuleTag: unique symbol = Symbol.for('@dxos/app-framework/ModuleTag');\n\n/**\n * The interface definition of a capability.\n */\nexport type InterfaceDef<T> = {\n  [InterfaceDefTypeId]: T;\n  identifier: string;\n};\n\nexport namespace InterfaceDef {\n  export type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;\n}\n\n/**\n * Helper to define the interface of a capability.\n */\nexport const make = <T>(identifier: string) => {\n  return { identifier } as InterfaceDef<T>;\n};\n\n/**\n * A unique string identifier with a Typescript type associated with it.\n * When a capability is contributed to the application an implementation of the interface is provided.\n */\nexport type Capability<T> = {\n  /**\n   * The interface definition of the capability.\n   */\n  readonly interface: InterfaceDef<T>;\n\n  /**\n   * The implementation of the capability.\n   */\n  readonly implementation: T;\n\n  /**\n   * Called when the capability is deactivated.\n   */\n  readonly deactivate?: () => Effect.Effect<void, Error>;\n};\n\nexport type Any = Capability<any>;\n\n/**\n * Union type representing all valid return types for a capability module.\n * Supports single capabilities, arrays, and tuples of different capability types.\n */\nexport type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];\n\n/**\n * Helper to define the implementation of a capability.\n */\n// TODO(dmaretskyi): Make the return type non-generic so capabilities are non-discernable.\nexport const contributes = <I extends InterfaceDef<any>>(\n  interfaceDef: I,\n  implementation: Capability<InterfaceDef.Implementation<I>>['implementation'],\n  deactivate?: Capability<InterfaceDef.Implementation<I>>['deactivate'],\n): Capability<I> => {\n  return {\n    interface: interfaceDef,\n    implementation,\n    deactivate,\n  } satisfies Capability<I>;\n};\n\ntype LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\ntype LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\n\ntype NormalizeReturn<R> = R extends readonly (infer A)[]\n  ? A[]\n  : R extends (infer A)[]\n    ? A[]\n    : R extends Any\n      ? [R]\n      : Any[];\n\nexport type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (\n  props: Props,\n) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;\n\n/**\n * Helper to define a lazily loaded implementation of a capability.\n * Supports single capabilities, arrays, and tuples of different capability types.\n * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.\n * @param loader The lazy loader function.\n * @returns A lazy capability function with ModuleTag symbol attached.\n */\nexport const lazy = <T = void, R extends ModuleReturn = ModuleReturn>(\n  name: string,\n  c: LoadCapability<T, R> | LoadCapabilities<T, R>,\n): LazyCapability<T, R> => {\n  const lazyFn: LazyCapability<T, R> = (props: T) =>\n    Effect.gen(function* () {\n      const { default: getCapability } = yield* Effect.promise(() => c());\n      const result = yield* getCapability(props);\n      const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [result];\n      return normalized as NormalizeReturn<R>;\n    });\n\n  return Object.assign(lazyFn, { [ModuleTag]: name });\n};\n\n/**\n * Gets the module tag (export name) from a lazy capability function.\n * @param capability The lazy capability function.\n * @returns The module tag if present, undefined otherwise.\n */\n// TODO(wittjosiah): Stricter type for capability.\nexport const getModuleTag = (capability: unknown): string | undefined => {\n  return capability && typeof capability === 'function' && ModuleTag in capability\n    ? String(capability[ModuleTag])\n    : undefined;\n};\n\n/**\n * Helper to define a capability module with explicit typing.\n * Wraps the default export function to provide better type inference and make the pattern explicit.\n *\n * This helper provides explicit typing for the module activation function,\n * making it clear that the function should:\n * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)\n * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)\n *\n * Supports returning multiple capabilities of different types as a tuple, which will be normalized\n * to an array at runtime for compatibility with the plugin system.\n *\n * @example\n * ```ts\n * // Module without options - single capability\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     const client = yield* Capability.get(ClientCapabilities.Client);\n *     return contributes(Capabilities.SettingsStore, store);\n *   })\n * );\n *\n * // Module with multiple capabilities\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     return [\n *       contributes(Capabilities.SettingsStore, store),\n *       contributes(Capabilities.Translations, translations),\n *     ];\n *   })\n * );\n *\n * // Module with required options (context accessed via layer)\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* (props: { observability: boolean }) {\n *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n *     return contributes(Capabilities.IntentResolver, ...);\n *   })\n * );\n * ```\n */\nexport const makeModule = <\n  TProps = void,\n  TReturn extends ModuleReturn = ModuleReturn,\n  E extends Error = Error,\n  R extends Service | Plugin.Service | never = Service,\n>(\n  fn: (props: TProps) => Effect.Effect<TReturn, E, R>,\n): ((props: TProps) => Effect.Effect<TReturn, E, R>) => fn;\n"],
+  "mappings": ";;;;;;AAAA;;;;;;;;;;;;;;;AAKA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AAajB,IAAMC,UAAN,cAA8BC,YAAI,uCAAA,EAAA,EAAA;AAGpC;AAUE,IAAMC,MAAM,CAAIC,iBACdC,eAAQJ,SAAS,CAACK,YAChBC,WAAI;EACTA,KAAK,MAAMD,QAAQH,IAAIC,YAAAA;EACvBI,OAAO,CAACC,UAAWA,iBAAiBC,QAAQD,QAAQ,IAAIC,MAAMC,OAAOF,KAAAA,CAAAA;AACvE,CAAA,CAAA;AAQG,IAAMG,SAAS,CAAIR,iBACjBS,WAAIZ,SAAS,CAACK,YAAYA,QAAQM,OAAOR,YAAAA,CAAAA;AAO3C,IAAMU,UAAU,CAAIV,iBAClBC,eAAQJ,SAAS,CAACK,YAAYA,QAAQQ,QAAQV,YAAAA,CAAAA;AAOhD,IAAMW,OAAO,CAAIX,iBACfS,WAAIZ,SAAS,CAACK,YAAYA,QAAQS,KAAKX,YAAAA,CAAAA;AAOzC,IAAMY,eAAe,CAC1BZ,iBAEOS,WAAIZ,SAAS,CAACK,YAAYA,QAAQU,aAAaZ,YAAAA,CAAAA;AAOjD,IAAMa,YAA2BC,uBAAOC,IAAI,+BAAA;AAiB5C,IAAMC,OAAO,CAAIC,eAAAA;AACtB,SAAO;IAAEA;EAAW;AACtB;AAmCO,IAAMC,cAAc,CACzBC,cACAC,gBACAC,eAAAA;AAEA,SAAO;IACLC,WAAWH;IACXC;IACAC;EACF;AACF;AA4BO,IAAME,OAAO,CAClBC,MACAC,MAAAA;AAEA,QAAMC,SAA+B,CAACC,UAC7BC,WAAI,aAAA;AACT,UAAM,EAAEC,SAASC,cAAa,IAAK,OAAcC,eAAQ,MAAMN,EAAAA,CAAAA;AAC/D,UAAMO,SAAS,OAAOF,cAAcH,KAAAA;AACpC,UAAMM,aAAaD,UAAU,OAAO,CAAA,IAAKE,MAAMC,QAAQH,MAAAA,IAAUE,MAAME,KAAKJ,MAAAA,IAAU;MAACA;;AACvF,WAAOC;EACT,CAAA;AAEF,SAAOI,OAAOC,OAAOZ,QAAQ;IAAE,CAACb,SAAAA,GAAYW;EAAK,CAAA;AACnD;AAQO,IAAMe,eAAe,CAACC,eAAAA;AAC3B,SAAOA,cAAc,OAAOA,eAAe,cAAc3B,aAAa2B,aAClEC,OAAOD,WAAW3B,SAAAA,CAAU,IAC5B6B;AACN;AA2CO,IAAMC,aAAa,CAMxBC,OACsDA;",
+  "names": ["Context", "Effect", "Service", "Tag", "get", "interfaceDef", "flatMap", "manager", "try", "catch", "error", "Error", "String", "getAll", "map", "waitFor", "atom", "atomByModule", "ModuleTag", "Symbol", "for", "make", "identifier", "contributes", "interfaceDef", "implementation", "deactivate", "interface", "lazy", "name", "c", "lazyFn", "props", "gen", "default", "getCapability", "promise", "result", "normalized", "Array", "isArray", "from", "Object", "assign", "getModuleTag", "capability", "String", "undefined", "makeModule", "fn"]
+}

package/dist/lib/node-esm/chunk-DAYWQOOQ.mjs

@@ -0,0 +1,149 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  getModuleTag
+} from "./chunk-42KBWDE4.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/plugin.ts
+var plugin_exports = {};
+__export(plugin_exports, {
+  PluginModuleTypeId: () => PluginModuleTypeId,
+  PluginTypeId: () => PluginTypeId,
+  Service: () => Service,
+  activate: () => activate,
+  addModule: () => addModule,
+  define: () => define,
+  isPlugin: () => isPlugin,
+  isPluginModule: () => isPluginModule,
+  make: () => make,
+  reset: () => reset,
+  shutdown: () => shutdown
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Pipeable from "effect/Pipeable";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/plugin.ts";
+var Service = class extends Context.Tag("@dxos/app-framework/PluginManager")() {
+};
+var activate = (event) => Effect.flatMap(Service, (manager) => manager.activate(event));
+var reset = (event) => Effect.flatMap(Service, (manager) => manager.reset(event));
+var shutdown = () => Effect.flatMap(Service, (manager) => manager.shutdown());
+var computeModuleId = (pluginId, moduleName) => {
+  return `${pluginId}.module.${moduleName}`;
+};
+var PluginModuleTypeId = /* @__PURE__ */ Symbol.for("@dxos/app-framework/PluginModule");
+var isPluginModule = (value) => {
+  return typeof value === "object" && value !== null && PluginModuleTypeId in value;
+};
+var PluginModuleImpl = class {
+  [PluginModuleTypeId] = PluginModuleTypeId;
+  id;
+  activatesOn;
+  firesBeforeActivation;
+  firesAfterActivation;
+  activate;
+  constructor(options) {
+    this.id = options.id;
+    this.activatesOn = options.activatesOn;
+    this.firesBeforeActivation = options.firesBeforeActivation;
+    this.firesAfterActivation = options.firesAfterActivation;
+    this.activate = options.activate;
+  }
+};
+var PluginTypeId = /* @__PURE__ */ Symbol.for("@dxos/app-framework/Plugin");
+var isPlugin = (value) => {
+  return typeof value === "object" && value !== null && PluginTypeId in value;
+};
+var PluginImpl = class {
+  _meta;
+  _modules;
+  [PluginTypeId] = PluginTypeId;
+  constructor(_meta, _modules) {
+    this._meta = _meta;
+    this._modules = _modules;
+  }
+  get meta() {
+    return this._meta;
+  }
+  get modules() {
+    return this._modules;
+  }
+};
+var PluginBuilderImpl = class {
+  meta;
+  _modules = [];
+  constructor(meta) {
+    this.meta = meta;
+  }
+  get modules() {
+    return this._modules;
+  }
+  addModule(moduleOptions) {
+    this._modules.push(moduleOptions);
+    return this;
+  }
+  pipe() {
+    return Pipeable.pipeArguments(this, arguments);
+  }
+};
+var define = (meta) => new PluginBuilderImpl(meta);
+function addModule(moduleOptionsOrBuilder, moduleOptions) {
+  if (moduleOptions !== void 0) {
+    return moduleOptionsOrBuilder.addModule(moduleOptions);
+  }
+  const moduleOpts = moduleOptionsOrBuilder;
+  return (builder) => builder.addModule(moduleOpts);
+}
+var resolveModule = (meta, module, options) => {
+  const moduleOptions = typeof module === "function" ? module(options) : module;
+  const id = Option.fromNullable(moduleOptions.id).pipe(Option.match({
+    onNone: () => {
+      const exportName = getModuleTag(moduleOptions.activate);
+      invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`, {
+        F: __dxlog_file,
+        L: 325,
+        S: void 0,
+        A: [
+          "exportName",
+          "`Plugin module missing name. Plugin: ${meta.id}`"
+        ]
+      });
+      return computeModuleId(meta.id, exportName);
+    },
+    onSome: (id2) => computeModuleId(meta.id, id2)
+  }));
+  return new PluginModuleImpl({
+    ...moduleOptions,
+    id
+  });
+};
+function make(builder) {
+  const meta = builder.meta;
+  const factory = (options) => {
+    const modules = builder.modules.map((module) => resolveModule(meta, module, options));
+    return new PluginImpl(meta, modules);
+  };
+  return Object.assign(factory, {
+    meta
+  });
+}
+
+export {
+  Service,
+  activate,
+  reset,
+  shutdown,
+  PluginModuleTypeId,
+  isPluginModule,
+  PluginTypeId,
+  isPlugin,
+  define,
+  addModule,
+  make,
+  plugin_exports
+};
+//# sourceMappingURL=chunk-DAYWQOOQ.mjs.map

package/dist/lib/node-esm/chunk-DAYWQOOQ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/plugin.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\nimport * as Pipeable from 'effect/Pipeable';\n\nimport { invariant } from '@dxos/invariant';\n\nimport type * as ActivationEvent from './activation-event';\nimport * as Capability from './capability';\nimport type * as PluginManager from './plugin-manager';\n\n//\n// Plugin Service Layer\n//\n\n/**\n * Effect Context.Tag for accessing PluginManager via the Effect layer system.\n * This allows lifecycle operations to access the plugin manager without having it passed as an argument.\n */\nexport class Service extends Context.Tag('@dxos/app-framework/PluginManager')<Service, PluginManager.PluginManager>() {}\n\n//\n// Lifecycle Functions\n//\n\n/**\n * Activates plugins based on the activation event.\n * Accesses the PluginManager via the Effect layer system.\n * @param event The activation event.\n * @returns Whether the activation was successful.\n */\nexport const activate = (event: ActivationEvent.ActivationEvent): Effect.Effect<boolean, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.activate(event));\n\n/**\n * Re-activates the modules that were activated by the event.\n * Accesses the PluginManager via the Effect layer system.\n * @param event The activation event.\n * @returns Whether the reset was successful.\n */\nexport const reset = (event: ActivationEvent.ActivationEvent): Effect.Effect<boolean, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.reset(event));\n\n/**\n * Shuts down the plugin manager, deactivating all active modules and clearing lifecycle state.\n * Accesses the PluginManager via the Effect layer system.\n */\nexport const shutdown = (): Effect.Effect<boolean, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.shutdown());\n\n/**\n * Computes a module ID from plugin ID and export name.\n */\nconst computeModuleId = (pluginId: string, moduleName: string): string => {\n  return `${pluginId}.module.${moduleName}`;\n};\n\n/**\n * Identifier denoting a PluginModule.\n */\nexport const PluginModuleTypeId: unique symbol = Symbol.for('@dxos/app-framework/PluginModule');\nexport type PluginModuleTypeId = typeof PluginModuleTypeId;\n\n/**\n * Type guard to check if a value is a PluginModule.\n */\nexport const isPluginModule = (value: unknown): value is PluginModule => {\n  return typeof value === 'object' && value !== null && PluginModuleTypeId in value;\n};\n\n/**\n * A unit of containment of modular functionality that can be provided to an application.\n * Activation of a module is async allowing for code to split and loaded lazily.\n */\nexport interface PluginModule {\n  readonly [PluginModuleTypeId]: PluginModuleTypeId;\n  /**\n   * Unique id of the module.\n   */\n  id: string;\n\n  /**\n   * Events for which the module will be activated.\n   */\n  activatesOn: ActivationEvent.Events;\n\n  /**\n   * Events that this module fires *before* its own activation runs.\n   *\n   * When this module is asked to activate (via {@link activatesOn}), the\n   * plugin manager first activates every event listed here, ensuring any\n   * other modules that contribute to those events have completed before\n   * this module's {@link activate} body executes. These events are fired\n   * by the framework on this module's behalf — the module does not need\n   * to wait for some other code to fire them.\n   *\n   * The module is marked as needing reset if a module activated by one\n   * of these events is later removed.\n   *\n   * Read as: \"this module fires these events before [its] activation\".\n   */\n  firesBeforeActivation?: ActivationEvent.ActivationEvent[];\n\n  /**\n   * Events that this module fires *after* its own activation completes.\n   *\n   * Once this module's {@link activate} body has finished executing, the\n   * plugin manager activates every event listed here, causing any modules\n   * listening on those events to run. These events are fired by the\n   * framework on this module's behalf as part of this module's lifecycle.\n   *\n   * Read as: \"this module fires these events after [its] activation\".\n   */\n  firesAfterActivation?: ActivationEvent.ActivationEvent[];\n\n  /**\n   * Called when the module is activated.\n   * CapabilityManager is accessed via the Effect layer system (Capability.Service).\n   * PluginManager is accessed via Plugin.Service.\n   * @param props Optional props passed to the module.\n   * @returns The capabilities of the module.\n   */\n  activate: (props?: any) => Effect.Effect<Capability.ModuleReturn, Error, Capability.Service | Service | never>;\n}\n\nexport type PluginModuleOptions = Omit<PluginModule, 'id' | typeof PluginModuleTypeId> & { id?: string };\n\nclass PluginModuleImpl implements PluginModule {\n  readonly [PluginModuleTypeId]: PluginModuleTypeId = PluginModuleTypeId;\n  readonly id: PluginModule['id'];\n  readonly activatesOn: PluginModule['activatesOn'];\n  readonly firesBeforeActivation?: PluginModule['firesBeforeActivation'];\n  readonly firesAfterActivation?: PluginModule['firesAfterActivation'];\n  readonly activate: PluginModule['activate'];\n\n  constructor(options: Omit<PluginModule, typeof PluginModuleTypeId>) {\n    this.id = options.id;\n    this.activatesOn = options.activatesOn;\n    this.firesBeforeActivation = options.firesBeforeActivation;\n    this.firesAfterActivation = options.firesAfterActivation;\n    this.activate = options.activate;\n  }\n}\n\nexport type Meta = {\n  /**\n   * Globally unique ID.\n   *\n   * Expected to be in the form of a valid URL.\n   *\n   * @example org.dxos.plugin.example\n   */\n  id: string;\n\n  /**\n   * Human-readable name.\n   */\n  name: string;\n\n  /**\n   * Short description of plugin functionality.\n   */\n  description?: string;\n\n  /**\n   * URL of home page.\n   */\n  homePage?: string;\n\n  /**\n   * URL of source code.\n   */\n  source?: string;\n\n  /**\n   * URL of screenshot.\n   */\n  screenshots?: string[];\n\n  /**\n   * Tags to help categorize the plugin.\n   */\n  tags?: string[];\n\n  /**\n   * A grep-able symbol string which can be resolved to an icon asset by @ch-ui/icons, via @ch-ui/vite-plugin-icons.\n   */\n  icon?: string;\n\n  /**\n   * Icon hue (ChromaticPalette).\n   */\n  iconHue?: string;\n};\n\n/**\n * Identifier denoting a Plugin.\n */\nexport const PluginTypeId: unique symbol = Symbol.for('@dxos/app-framework/Plugin');\nexport type PluginTypeId = typeof PluginTypeId;\n\n/**\n * Type guard to check if a value is a Plugin.\n */\nexport const isPlugin = (value: unknown): value is Plugin => {\n  return typeof value === 'object' && value !== null && PluginTypeId in value;\n};\n\n/**\n * A collection of modules that are be enabled/disabled as a unit.\n * Plugins provide things such as components, state, actions, etc. to the application.\n */\n// TODO(burdon): Convert to ECHO schema.\nexport interface Plugin {\n  readonly [PluginTypeId]: PluginTypeId;\n  readonly meta: Readonly<Meta>;\n  readonly modules: ReadonlyArray<PluginModule>;\n}\n\n/**\n * Internal implementation of Plugin.\n * @internal\n */\nclass PluginImpl implements Plugin {\n  readonly [PluginTypeId]: PluginTypeId = PluginTypeId;\n\n  constructor(\n    private readonly _meta: Meta,\n    private readonly _modules: PluginModule[],\n  ) {}\n\n  get meta(): Readonly<Meta> {\n    return this._meta;\n  }\n\n  get modules(): ReadonlyArray<PluginModule> {\n    return this._modules;\n  }\n}\n\n/**\n * Builder interface for creating plugins incrementally.\n */\nexport interface PluginBuilder<T = void> extends Pipeable.Pipeable {\n  readonly meta: Meta;\n  readonly modules: ReadonlyArray<PluginModuleOptions | ((options: T) => PluginModuleOptions)>;\n  addModule(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T>;\n}\n\n/**\n * Builder implementation for creating plugins incrementally.\n */\nclass PluginBuilderImpl<T = void> implements PluginBuilder<T> {\n  readonly meta: Meta;\n  private readonly _modules: Array<PluginModuleOptions | ((options: T) => PluginModuleOptions)> = [];\n\n  constructor(meta: Meta) {\n    this.meta = meta;\n  }\n\n  get modules(): ReadonlyArray<PluginModuleOptions | ((options: T) => PluginModuleOptions)> {\n    return this._modules;\n  }\n\n  addModule(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T> {\n    this._modules.push(moduleOptions);\n    return this;\n  }\n\n  pipe() {\n    // eslint-disable-next-line prefer-rest-params\n    return Pipeable.pipeArguments(this, arguments);\n  }\n}\n\n/**\n * Creates a new PluginBuilder to start building a plugin.\n */\nexport const define = <T = void>(meta: Meta): PluginBuilder<T> => new PluginBuilderImpl<T>(meta);\n\n/**\n * Adds a module to a plugin builder.\n * Supports both pipeline and direct call styles.\n * Modules can be either PluginModuleOptions or functions that receive options.\n */\nexport function addModule<T>(\n  moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions),\n): (builder: PluginBuilder<T>) => PluginBuilder<T>;\nexport function addModule<T>(\n  builder: PluginBuilder<T>,\n  moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions),\n): PluginBuilder<T>;\nexport function addModule<T>(\n  moduleOptionsOrBuilder: PluginModuleOptions | ((options: T) => PluginModuleOptions) | PluginBuilder<T>,\n  moduleOptions?: PluginModuleOptions | ((options: T) => PluginModuleOptions),\n): ((builder: PluginBuilder<T>) => PluginBuilder<T>) | PluginBuilder<T> {\n  // If second arg is provided, it's the direct call style: addModule(builder, moduleOptions)\n  if (moduleOptions !== undefined) {\n    return (moduleOptionsOrBuilder as PluginBuilder<T>).addModule(moduleOptions);\n  }\n  // Otherwise it's pipeline style: addModule(moduleOptions) returns a function\n  const moduleOpts = moduleOptionsOrBuilder as PluginModuleOptions | ((options: T) => PluginModuleOptions);\n  return (builder: PluginBuilder<T>) => builder.addModule(moduleOpts);\n}\n\nexport type PluginFactory<T = void> = ((options: T) => Plugin) & { meta: Meta };\n\n/**\n * Resolves a module from either PluginModuleOptions or a function that returns PluginModuleOptions.\n */\nconst resolveModule = (\n  meta: Meta,\n  module: PluginModuleOptions | ((options: any) => PluginModuleOptions),\n  options?: any,\n): PluginModuleImpl => {\n  const moduleOptions = typeof module === 'function' ? module(options) : module;\n  const id = Option.fromNullable(moduleOptions.id).pipe(\n    Option.match({\n      onNone: () => {\n        const exportName = Capability.getModuleTag(moduleOptions.activate);\n        invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`);\n        return computeModuleId(meta.id, exportName);\n      },\n      onSome: (id) => computeModuleId(meta.id, id),\n    }),\n  );\n  return new PluginModuleImpl({ ...moduleOptions, id });\n};\n\n/**\n * Creates a Plugin from a builder.\n * Supports both pipeline and direct call styles.\n * Always returns a factory function (options: T) => Plugin.\n * When T is void, the function takes no arguments: () => Plugin.\n */\nexport function make<T>(builder: PluginBuilder<T>): PluginFactory<T>;\nexport function make<T>(builder: PluginBuilder<T>): PluginFactory<T> {\n  const meta = builder.meta;\n\n  const factory = (options: T) => {\n    const modules = builder.modules.map((module) => resolveModule(meta, module, options));\n    return new PluginImpl(meta, modules);\n  };\n\n  return Object.assign(factory, { meta });\n}\n"],
+  "mappings": "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",
+  "names": ["Context", "Effect", "Option", "Pipeable", "invariant", "Service", "Tag", "activate", "event", "flatMap", "manager", "reset", "shutdown", "computeModuleId", "pluginId", "moduleName", "PluginModuleTypeId", "Symbol", "for", "isPluginModule", "value", "PluginModuleImpl", "id", "activatesOn", "firesBeforeActivation", "firesAfterActivation", "options", "PluginTypeId", "isPlugin", "PluginImpl", "_meta", "_modules", "meta", "modules", "PluginBuilderImpl", "addModule", "moduleOptions", "push", "pipe", "pipeArguments", "arguments", "define", "moduleOptionsOrBuilder", "undefined", "moduleOpts", "builder", "resolveModule", "module", "fromNullable", "match", "onNone", "exportName", "getModuleTag", "invariant", "onSome", "make", "factory", "map", "Object", "assign"]
+}

package/dist/lib/node-esm/chunk-DER2JDBT.mjs

@@ -0,0 +1,175 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  isPlugin
+} from "./chunk-DAYWQOOQ.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  getRemoteEntries: () => getRemoteEntries,
+  isLocalUrl: () => isLocalUrl,
+  make: () => make,
+  preload: () => preload
+});
+import * as Effect from "effect/Effect";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+var defaultStorage = () => ({
+  get: (key) => localStorage.getItem(key),
+  set: (key, value) => localStorage.setItem(key, value)
+});
+var getPersistedRemotePlugins = (storage, key) => {
+  try {
+    const parsed = JSON.parse(storage.get(key) ?? "[]");
+    if (!Array.isArray(parsed)) {
+      return [];
+    }
+    return parsed.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.id === "string" && typeof entry.url === "string");
+  } catch {
+    return [];
+  }
+};
+var persistRemotePlugin = (storage, key, entry) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);
+    entries.push(entry);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to persist remote plugin entry", {
+      entry,
+      error
+    }, {
+      F: __dxlog_file,
+      L: 63,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+var isUrl = (locator) => {
+  try {
+    const url = new URL(locator);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+var isLocalUrl = (locator) => {
+  try {
+    const hostname = new URL(locator).hostname.toLowerCase();
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+  } catch {
+    return false;
+  }
+};
+var getRemoteEntries = (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key);
+};
+var normalizePluginExport = (mod) => {
+  const exported = mod.default;
+  if (isPlugin(exported)) {
+    return exported;
+  }
+  if (typeof exported === "function") {
+    const result = exported();
+    if (isPlugin(result)) {
+      return result;
+    }
+  }
+  throw new Error("Remote module default export is not a Plugin or a zero-arg plugin factory.");
+};
+var loadRemotePlugin = async (url) => {
+  log.info("loading remote plugin", {
+    url
+  }, {
+    F: __dxlog_file,
+    L: 115,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const mod = await import(
+    /* @vite-ignore */
+    url
+  );
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);
+  }
+  return plugin;
+};
+var preload = async (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, {
+    F: __dxlog_file,
+    L: 135,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));
+  const plugins = [];
+  for (let index = 0; index < results.length; index++) {
+    const result = results[index];
+    if (result.status === "fulfilled") {
+      plugins.push(result.value);
+    } else {
+      log.warn("failed to preload remote plugin", {
+        entry: entries[index],
+        error: result.reason
+      }, {
+        F: __dxlog_file,
+        L: 143,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  return plugins;
+};
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return (locator) => Effect.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return builtin;
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));
+    }
+    const plugin = yield* Effect.tryPromise({
+      try: () => loadRemotePlugin(locator),
+      catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`)
+    });
+    const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+    if (duplicate) {
+      return yield* Effect.fail(new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`));
+    }
+    persistRemotePlugin(storage, key, {
+      id: plugin.meta.id,
+      url: locator
+    });
+    return plugin;
+  });
+};
+
+export {
+  isLocalUrl,
+  getRemoteEntries,
+  preload,
+  make,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-DER2JDBT.mjs.map

package/dist/lib/node-esm/chunk-DER2JDBT.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/url-loader.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { log } from '@dxos/log';\n\nimport * as Plugin from './plugin';\n\nconst DEFAULT_KEY = 'org.dxos.composer.remote-plugins';\n\n/**\n * Abstraction over key-value storage (defaults to localStorage).\n */\nexport type Storage = {\n  get(key: string): string | null;\n  set(key: string, value: string): void;\n};\n\n/**\n * Options for configuring the URL loader.\n */\nexport type Options = {\n  storage?: Storage;\n  key?: string;\n};\n\n/**\n * Persisted record of a remote plugin that has been loaded previously.\n */\nexport type RemotePluginEntry = {\n  id: string;\n  url: string;\n};\n\nconst defaultStorage = (): Storage => ({\n  get: (key) => localStorage.getItem(key),\n  set: (key, value) => localStorage.setItem(key, value),\n});\n\nconst getPersistedRemotePlugins = (storage: Storage, key: string): RemotePluginEntry[] => {\n  try {\n    const parsed: unknown = JSON.parse(storage.get(key) ?? '[]');\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter(\n      (entry): entry is RemotePluginEntry =>\n        typeof entry === 'object' && entry !== null && typeof entry.id === 'string' && typeof entry.url === 'string',\n    );\n  } catch {\n    return [];\n  }\n};\n\nconst persistRemotePlugin = (storage: Storage, key: string, entry: RemotePluginEntry): void => {\n  try {\n    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);\n    entries.push(entry);\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to persist remote plugin entry', { entry, error });\n  }\n};\n\nconst isUrl = (locator: string): boolean => {\n  try {\n    const url = new URL(locator);\n    return url.protocol === 'http:' || url.protocol === 'https:';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns true when the URL's hostname is the local host (localhost, 127.0.0.1, or ::1).\n */\nexport const isLocalUrl = (locator: string): boolean => {\n  try {\n    const hostname = new URL(locator).hostname.toLowerCase();\n    // WHATWG URL returns '::1' without brackets in Node; some browsers return '[::1]'.\n    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1' || hostname === '[::1]';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns the list of remote plugin entries previously persisted by {@link make}.\n * Useful for UI code that needs to know which loaded plugins were installed from a URL\n * (e.g. to surface a tag on remote or localhost-hosted plugins).\n */\nexport const getRemoteEntries = (options: Options = {}): readonly RemotePluginEntry[] => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  return getPersistedRemotePlugins(storage, key);\n};\n\nconst normalizePluginExport = (mod: Record<string, unknown>): Plugin.Plugin => {\n  const exported = mod.default;\n  if (Plugin.isPlugin(exported)) {\n    return exported;\n  }\n  if (typeof exported === 'function') {\n    const result = (exported as () => unknown)();\n    if (Plugin.isPlugin(result)) {\n      return result;\n    }\n  }\n  throw new Error('Remote module default export is not a Plugin or a zero-arg plugin factory.');\n};\n\nconst loadRemotePlugin = async (url: string): Promise<Plugin.Plugin> => {\n  log.info('loading remote plugin', { url });\n  const mod = await import(/* @vite-ignore */ url);\n  const plugin = normalizePluginExport(mod);\n  if (!plugin.meta.id || !plugin.meta.name) {\n    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);\n  }\n  return plugin;\n};\n\n/**\n * Preloads previously persisted remote plugins from storage.\n */\nexport const preload = async (options: Options = {}): Promise<Plugin.Plugin[]> => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n\n  const entries = getPersistedRemotePlugins(storage, key);\n  if (entries.length === 0) {\n    return [];\n  }\n  log.info('preloading remote plugins', { count: entries.length });\n  const results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));\n  const plugins: Plugin.Plugin[] = [];\n  for (let index = 0; index < results.length; index++) {\n    const result = results[index];\n    if (result.status === 'fulfilled') {\n      plugins.push(result.value);\n    } else {\n      log.warn('failed to preload remote plugin', { entry: entries[index], error: result.reason });\n    }\n  }\n  return plugins;\n};\n\n/**\n * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.\n */\nexport const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n\n  return (locator: string): Effect.Effect<Plugin.Plugin, Error> =>\n    Effect.gen(function* () {\n      const builtin = builtinPlugins.find((plugin) => plugin.meta.id === locator);\n      if (builtin) {\n        return builtin;\n      }\n      if (!isUrl(locator)) {\n        return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));\n      }\n      const plugin = yield* Effect.tryPromise({\n        try: () => loadRemotePlugin(locator),\n        catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`),\n      });\n      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);\n      if (duplicate) {\n        return yield* Effect.fail(\n          new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`),\n        );\n      }\n      persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });\n      return plugin;\n    });\n};\n"],
+  "mappings": "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",
+  "names": ["Effect", "log", "DEFAULT_KEY", "defaultStorage", "get", "key", "localStorage", "getItem", "set", "value", "setItem", "getPersistedRemotePlugins", "storage", "parsed", "JSON", "parse", "Array", "isArray", "filter", "entry", "id", "url", "persistRemotePlugin", "entries", "existing", "push", "stringify", "error", "log", "warn", "isUrl", "locator", "URL", "protocol", "isLocalUrl", "hostname", "toLowerCase", "getRemoteEntries", "options", "normalizePluginExport", "mod", "exported", "default", "isPlugin", "result", "Error", "loadRemotePlugin", "info", "plugin", "meta", "name", "preload", "length", "count", "results", "Promise", "allSettled", "map", "plugins", "index", "status", "reason", "make", "builtinPlugins", "gen", "builtin", "find", "fail", "tryPromise", "try", "catch", "duplicate"]
+}

package/dist/lib/node-esm/chunk-EL3R25OQ.mjs

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+//# sourceMappingURL=chunk-EL3R25OQ.mjs.map

package/dist/lib/node-esm/chunk-EL3R25OQ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/node-esm/chunk-FKE4Z3D6.mjs

@@ -0,0 +1,10 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// src/context.ts
+import { createContext } from "@dxos/web-context";
+var PluginManagerContext = createContext("org.dxos.app-framework.plugin-manager");
+
+export {
+  PluginManagerContext
+};
+//# sourceMappingURL=chunk-FKE4Z3D6.mjs.map

package/dist/lib/node-esm/chunk-FKE4Z3D6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/context.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@dxos/web-context';\n\nimport { type PluginManager } from './core';\n\nexport const PluginManagerContext = createContext<PluginManager.PluginManager>('org.dxos.app-framework.plugin-manager');\n"],
+  "mappings": ";;;AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBC,cAA2C,uCAAA;",
+  "names": ["createContext", "PluginManagerContext", "createContext"]
+}