@dxos/app-framework 0.8.4-main.937b3ca → 0.8.4-main.9be5663bfe

package/dist/lib/browser/{react → ui}/index.mjs

@@ -1,46 +1,44 @@
 import {
-  ErrorBoundary,
+  App,
+  LoadingState,
   PluginManagerProvider,
   Surface,
-  isSurfaceAvailable,
   useApp,
-  useAppGraph,
   useAtomCapability,
   useAtomCapabilityState,
   useCapabilities,
   useCapability,
-  useLayout,
+  useLoading,
   useOperationInvoker,
-  useOperationResolver,
   usePluginManager,
   useSettingsState,
-  useSurface,
-  useSurfaces
-} from "../chunk-XYNO72GQ.mjs";
-import "../chunk-FHQTHCX7.mjs";
-import "../chunk-BLQJSGL3.mjs";
-import "../chunk-FMZN33N4.mjs";
-import "../chunk-PKQT6C53.mjs";
-import "../chunk-TCLLRCS3.mjs";
-import "../chunk-6Y7PZV72.mjs";
+  useSurface
+} from "../chunk-WPE6AL7I.mjs";
+import "../chunk-TGX63LTL.mjs";
+import "../chunk-T3Y4AEKX.mjs";
+import "../chunk-JKWMHZP6.mjs";
+import "../chunk-I34GF4NG.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-LVJW5EFU.mjs";
+import "../chunk-GX4TUNM6.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import "../chunk-FU4GAFUQ.mjs";
+import "../chunk-2CKCJ6PN.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
-  ErrorBoundary,
+  App,
+  LoadingState,
   PluginManagerProvider,
   Surface,
-  isSurfaceAvailable,
   useApp,
-  useAppGraph,
   useAtomCapability,
   useAtomCapabilityState,
   useCapabilities,
   useCapability,
-  useLayout,
+  useLoading,
   useOperationInvoker,
-  useOperationResolver,
   usePluginManager,
   useSettingsState,
-  useSurface,
-  useSurfaces
+  useSurface
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/browser/ui/index.mjs.map

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

package/dist/lib/node-esm/{capability-CFLQ2QQU.mjs → capability-AWBEMRYR.mjs}

@@ -1,16 +1,21 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import "./chunk-VKHGNEDB.mjs";
 import {
-  ActivationEvent,
-  Capability
-} from "./chunk-GQEBIGKD.mjs";
-import "./chunk-XYQTBFPA.mjs";
-import "./chunk-7OWSHPYK.mjs";
+  capabilities_exports
+} from "./chunk-G3RTFSNG.mjs";
+import {
+  activation_events_exports
+} from "./chunk-WZCSOX5Q.mjs";
+import "./chunk-EL3R25OQ.mjs";
+import "./chunk-4A3ZCMI3.mjs";
+import "./chunk-BCEOLX47.mjs";
+import "./chunk-ZZ7CKK6W.mjs";
 import {
   plugin_exports
-} from "./chunk-GT6OKM5I.mjs";
+} from "./chunk-ULUEXB7Q.mjs";
 import {
   capability_exports
-} from "./chunk-STMXUEPO.mjs";
+} from "./chunk-42KBWDE4.mjs";
 import "./chunk-HSLMI22Q.mjs";
 
 // src/plugin-runtime/capability.ts
@@ -20,15 +25,15 @@ import * as ManagedRuntime from "effect/ManagedRuntime";
 var capability_default = capability_exports.makeModule(Effect.fnUntraced(function* () {
   const capabilityManager = yield* capability_exports.Service;
   const pluginManager = yield* plugin_exports.Service;
-  yield* plugin_exports.activate(ActivationEvent.SetupLayer);
-  const layers = yield* capability_exports.getAll(Capability.Layer);
+  yield* plugin_exports.activate(activation_events_exports.SetupLayer);
+  const layers = yield* capability_exports.getAll(capabilities_exports.Layer);
   const capabilityServiceLayer = Layer.succeed(capability_exports.Service, capabilityManager);
   const pluginServiceLayer = Layer.succeed(plugin_exports.Service, pluginManager);
   const composedLayer = layers.length > 0 ? Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer, ...layers) : Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer);
   const runtime = ManagedRuntime.make(composedLayer);
-  return capability_exports.contributes(Capability.ManagedRuntime, runtime);
+  return capability_exports.contributes(capabilities_exports.ManagedRuntime, runtime);
 }));
 export {
   capability_default as default
 };
-//# sourceMappingURL=capability-CFLQ2QQU.mjs.map
+//# sourceMappingURL=capability-AWBEMRYR.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin-runtime/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Capability, Plugin } from '../core';\n\n//\n// Capability Module\n//\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    // Get the CapabilityManager to create a layer for it.\n    const capabilityManager = yield* Capability.Service;\n\n    // Get the PluginManager to create a layer for it.\n    const pluginManager = yield* Plugin.Service;\n\n    // Trigger setup event so plugins can contribute their layers.\n    yield* Plugin.activate(ActivationEvents.SetupLayer);\n\n    // Gather all contributed layers.\n    const layers = yield* Capability.getAll(Capabilities.Layer);\n\n    // Create layers that provide Capability.Service and Plugin.Service.\n    const capabilityServiceLayer = Layer.succeed(Capability.Service, capabilityManager);\n    const pluginServiceLayer = Layer.succeed(Plugin.Service, pluginManager);\n\n    // Merge all layers including service layers.\n    // Layer.mergeAll requires a tuple type, so we use a cast for dynamic arrays.\n    const composedLayer =\n      layers.length > 0\n        ? (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n            ...layers,\n          )\n        : (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n            capabilityServiceLayer,\n            pluginServiceLayer,\n          );\n\n    // Create the managed runtime from the composed layer.\n    const runtime = ManagedRuntime.make(composedLayer) as Capabilities.ManagedRuntime;\n\n    return Capability.contributes(Capabilities.ManagedRuntime, runtime);\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AACxB,YAAYC,WAAW;AACvB,YAAYC,oBAAoB;AAShC,IAAA,qBAAeC,mBAAWC,WACjBC,kBAAW,aAAA;AAEhB,QAAMC,oBAAoB,OAAOH,mBAAWI;AAG5C,QAAMC,gBAAgB,OAAOC,eAAOF;AAGpC,SAAOE,eAAOC,SAASC,0BAAiBC,UAAU;AAGlD,QAAMC,SAAS,OAAOV,mBAAWW,OAAOC,qBAAaC,KAAK;AAG1D,QAAMC,yBAA+BC,cAAQf,mBAAWI,SAASD,iBAAAA;AACjE,QAAMa,qBAA2BD,cAAQT,eAAOF,SAASC,aAAAA;AAIzD,QAAMY,gBACJP,OAAOQ,SAAS,IACLC,eACLL,wBACAE,oBAAAA,GACGN,MAAAA,IAEES,eACLL,wBACAE,kBAAAA;AAIR,QAAMI,UAAyBC,oBAAKJ,aAAAA;AAEpC,SAAOjB,mBAAWsB,YAAYV,qBAAaW,gBAAgBH,OAAAA;AAC7D,CAAA,CAAA;",
+  "names": ["Effect", "Layer", "ManagedRuntime", "Capability", "makeModule", "fnUntraced", "capabilityManager", "Service", "pluginManager", "Plugin", "activate", "ActivationEvents", "SetupLayer", "layers", "getAll", "Capabilities", "Layer", "capabilityServiceLayer", "succeed", "pluginServiceLayer", "composedLayer", "length", "mergeAll", "runtime", "make", "contributes", "ManagedRuntime"]
+}

package/dist/lib/node-esm/capability-WFEG6CIZ.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-4A3ZCMI3.mjs";
+import "./chunk-BCEOLX47.mjs";
+import "./chunk-ZZ7CKK6W.mjs";
+import "./chunk-ULUEXB7Q.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-WFEG6CIZ.mjs.map

package/dist/lib/node-esm/capability-WFEG6CIZ.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-STMXUEPO.mjs → chunk-42KBWDE4.mjs}

@@ -9,6 +9,7 @@ __export(capability_exports, {
   ModuleTag: () => ModuleTag,
   Service: () => Service,
   atom: () => atom,
+  atomByModule: () => atomByModule,
   contributes: () => contributes,
   get: () => get,
   getAll: () => getAll,
@@ -29,8 +30,8 @@ var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
 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 InterfaceDefTypeId = Symbol.for("InterfaceDefTypeId");
-var ModuleTag = Symbol.for("@dxos/app-framework/ModuleTag");
+var atomByModule = (interfaceDef) => Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));
+var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
 var make = (identifier) => {
   return {
     identifier
@@ -45,7 +46,7 @@ var contributes = (interfaceDef, implementation, deactivate) => {
 };
 var lazy = (name, c) => {
   const lazyFn = (props) => Effect.gen(function* () {
-    const { default: getCapability } = yield* Effect.tryPromise(() => c());
+    const { default: getCapability } = yield* Effect.promise(() => c());
     const result = yield* getCapability(props);
     const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [
       result
@@ -67,6 +68,7 @@ export {
   getAll,
   waitFor,
   atom,
+  atomByModule,
   ModuleTag,
   make,
   contributes,
@@ -75,4 +77,4 @@ export {
   makeModule,
   capability_exports
 };
-//# sourceMappingURL=chunk-STMXUEPO.mjs.map
+//# 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-4A3ZCMI3.mjs

@@ -0,0 +1,158 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  isPlugin
+} from "./chunk-ULUEXB7Q.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  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: 57,
+      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 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: 85,
+    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: 105,
+    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: 113,
+        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 {
+  preload,
+  make,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-4A3ZCMI3.mjs.map

package/dist/lib/node-esm/chunk-4A3ZCMI3.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\ntype RemotePluginEntry = { id: string; url: string };\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\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", "normalizePluginExport", "mod", "exported", "default", "isPlugin", "result", "Error", "loadRemotePlugin", "info", "plugin", "meta", "name", "preload", "options", "length", "count", "results", "Promise", "allSettled", "map", "plugins", "index", "status", "reason", "make", "builtinPlugins", "gen", "builtin", "find", "fail", "tryPromise", "try", "catch", "duplicate"]
+}