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

package/dist/lib/browser/chunk-ZBA6IH6L.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/browser/cli/index.mjs

@@ -0,0 +1,90 @@
+import "../chunk-T3Y4AEKX.mjs";
+import {
+  capabilities_exports
+} from "../chunk-JKWMHZP6.mjs";
+import {
+  activation_events_exports
+} from "../chunk-I34GF4NG.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-RHQGPRWN.mjs";
+import {
+  plugin_manager_exports
+} from "../chunk-56CEL32L.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import {
+  plugin_exports
+} from "../chunk-ZBA6IH6L.mjs";
+import {
+  capability_exports
+} from "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/cli/cli.ts
+import * as Command from "@effect/cli/Command";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/cli/cli.ts";
+var defaultPluginLoader = (plugins) => (id) => Effect.sync(() => {
+  const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
+  invariant(plugin, `Plugin not found: ${id}`, {
+    F: __dxlog_file,
+    L: 19,
+    S: void 0,
+    A: [
+      "plugin",
+      "`Plugin not found: ${id}`"
+    ]
+  });
+  return plugin;
+});
+var createCliApp = Effect.fn(function* ({ rootCommand, subCommands: subCommandsProp, pluginManager: pluginManagerProp, pluginLoader: pluginLoaderProp, plugins: pluginsProp = [], core: coreProp, enabled: enabledProp = [], safeMode = false }) {
+  const plugins = pluginsProp;
+  const core = coreProp ?? plugins.map(({ meta }) => meta.id);
+  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);
+  const enabled = safeMode ? [] : enabledProp;
+  const manager = pluginManagerProp ?? plugin_manager_exports.make({
+    pluginLoader,
+    plugins,
+    core,
+    enabled
+  });
+  manager.capabilities.contribute({
+    interface: capabilities_exports.PluginManager,
+    implementation: manager,
+    module: "org.dxos.app-framework.plugin-manager"
+  });
+  manager.capabilities.contribute({
+    interface: capabilities_exports.AtomRegistry,
+    implementation: manager.registry,
+    module: "org.dxos.app-framework.atom-registry"
+  });
+  yield* manager.activate(activation_events_exports.Startup);
+  const layers = manager.capabilities.getAll(capabilities_exports.Layer);
+  const capabilityServiceLayer = Layer.succeed(capability_exports.Service, manager.capabilities);
+  const pluginServiceLayer = Layer.succeed(plugin_exports.Service, manager);
+  const layer = Layer.mergeAll(capabilityServiceLayer, pluginServiceLayer, ...layers);
+  const pluginCommands = manager.capabilities.getAll(capabilities_exports.Command);
+  const subCommands = subCommandsProp ? [
+    ...subCommandsProp,
+    ...pluginCommands
+  ] : pluginCommands;
+  invariant(subCommands.length > 0, "No subcommands provided", {
+    F: __dxlog_file,
+    L: 103,
+    S: this,
+    A: [
+      "subCommands.length > 0",
+      "'No subcommands provided'"
+    ]
+  });
+  const command = rootCommand.pipe(Command.withSubcommands(subCommands));
+  return {
+    command,
+    layer
+  };
+});
+export {
+  createCliApp
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/cli.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Command from '@effect/cli/Command';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Capability, Plugin, PluginManager } from '../core';\n\nconst defaultPluginLoader =\n  (plugins: Plugin.Plugin[]): PluginManager.ManagerOptions['pluginLoader'] =>\n  (id: string) =>\n    Effect.sync(() => {\n      const plugin = plugins.find((plugin) => plugin.meta.id === id);\n      invariant(plugin, `Plugin not found: ${id}`);\n      return plugin;\n    });\n\ntype SubCommands = [Command.Command<any, any, any, any>, ...Array<Command.Command<any, any, any, any>>];\n\nexport type CreateCliAppOptions = {\n  rootCommand: Command.Command<any, any, any, any>;\n  subCommands?: SubCommands;\n  pluginManager?: PluginManager.PluginManager;\n  pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];\n  plugins?: Plugin.Plugin[];\n  core?: string[];\n  enabled?: string[];\n  safeMode?: boolean;\n};\n\n/**\n * Creates a CLI application with plugin support.\n * Similar to useApp but for CLI environments.\n *\n * @example\n * const plugins = [ClientPluginCLI()];\n * const manager = await createCliApp({ plugins });\n * const commands = manager.capabilities.getAll(Capabilities.Command);\n *\n * @param options.pluginManager Optional existing PluginManager instance.\n * @param options.pluginLoader Function to load plugins by ID.\n * @param options.plugins All plugins available to the application.\n * @param options.core Core plugins which will always be enabled.\n * @param options.enabled Enabled plugins.\n * @param options.safeMode Whether to enable safe mode, which disables optional plugins.\n */\nexport const createCliApp = Effect.fn(function* ({\n  rootCommand,\n  subCommands: subCommandsProp,\n  pluginManager: pluginManagerProp,\n  pluginLoader: pluginLoaderProp,\n  plugins: pluginsProp = [],\n  core: coreProp,\n  enabled: enabledProp = [],\n  safeMode = false,\n}: CreateCliAppOptions) {\n  const plugins = pluginsProp;\n  const core = coreProp ?? plugins.map(({ meta }) => meta.id);\n  const pluginLoader = pluginLoaderProp ?? defaultPluginLoader(plugins);\n  const enabled = safeMode ? [] : enabledProp;\n  const manager =\n    pluginManagerProp ??\n    PluginManager.make({\n      pluginLoader,\n      plugins,\n      core,\n      enabled,\n    });\n\n  manager.capabilities.contribute({\n    interface: Capabilities.PluginManager,\n    implementation: manager,\n    module: 'org.dxos.app-framework.plugin-manager',\n  });\n\n  manager.capabilities.contribute({\n    interface: Capabilities.AtomRegistry,\n    implementation: manager.registry,\n    module: 'org.dxos.app-framework.atom-registry',\n  });\n\n  // Activate startup event to load CLI commands and Effect layers.\n  yield* manager.activate(ActivationEvents.Startup);\n\n  // Gather all layers and merge them into a single layer.\n  const layers = manager.capabilities.getAll(Capabilities.Layer);\n  const capabilityServiceLayer = Layer.succeed(Capability.Service, manager.capabilities);\n  const pluginServiceLayer = Layer.succeed(Plugin.Service, manager);\n  const layer = (Layer.mergeAll as (...args: Layer.Layer<any, any, any>[]) => Layer.Layer<any, any, never>)(\n    capabilityServiceLayer,\n    pluginServiceLayer,\n    ...layers,\n  );\n\n  // Gather all commands and provide them to the root command.\n  const pluginCommands = manager.capabilities.getAll(Capabilities.Command);\n  const subCommands = subCommandsProp ? [...subCommandsProp, ...pluginCommands] : pluginCommands;\n  invariant(subCommands.length > 0, 'No subcommands provided');\n  const command = rootCommand.pipe(Command.withSubcommands(subCommands as SubCommands));\n\n  return { command, layer };\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAIA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AACxB,YAAYC,WAAW;AAEvB,SAASC,iBAAiB;;AAK1B,IAAMC,sBACJ,CAACC,YACD,CAACC,OACQC,YAAK,MAAA;AACV,QAAMC,SAASH,QAAQI,KAAK,CAACD,YAAWA,QAAOE,KAAKJ,OAAOA,EAAAA;AAC3DK,YAAUH,QAAQ,qBAAqBF,EAAAA,IAAI;;;;;;;;;AAC3C,SAAOE;AACT,CAAA;AA+BG,IAAMI,eAAsBC,UAAG,WAAW,EAC/CC,aACAC,aAAaC,iBACbC,eAAeC,mBACfC,cAAcC,kBACdf,SAASgB,cAAc,CAAA,GACvBC,MAAMC,UACNC,SAASC,cAAc,CAAA,GACvBC,WAAW,MAAK,GACI;AACpB,QAAMrB,UAAUgB;AAChB,QAAMC,OAAOC,YAAYlB,QAAQsB,IAAI,CAAC,EAAEjB,KAAI,MAAOA,KAAKJ,EAAE;AAC1D,QAAMa,eAAeC,oBAAoBhB,oBAAoBC,OAAAA;AAC7D,QAAMmB,UAAUE,WAAW,CAAA,IAAKD;AAChC,QAAMG,UACJV,qBACAW,uBAAcC,KAAK;IACjBX;IACAd;IACAiB;IACAE;EACF,CAAA;AAEFI,UAAQG,aAAaC,WAAW;IAC9BC,WAAWC,qBAAaL;IACxBM,gBAAgBP;IAChBQ,QAAQ;EACV,CAAA;AAEAR,UAAQG,aAAaC,WAAW;IAC9BC,WAAWC,qBAAaG;IACxBF,gBAAgBP,QAAQU;IACxBF,QAAQ;EACV,CAAA;AAGA,SAAOR,QAAQW,SAASC,0BAAiBC,OAAO;AAGhD,QAAMC,SAASd,QAAQG,aAAaY,OAAOT,qBAAaU,KAAK;AAC7D,QAAMC,yBAA+BC,cAAQC,mBAAWC,SAASpB,QAAQG,YAAY;AACrF,QAAMkB,qBAA2BH,cAAQI,eAAOF,SAASpB,OAAAA;AACzD,QAAMuB,QAAeC,eACnBP,wBACAI,oBAAAA,GACGP,MAAAA;AAIL,QAAMW,iBAAiBzB,QAAQG,aAAaY,OAAOT,qBAAaoB,OAAO;AACvE,QAAMvC,cAAcC,kBAAkB;OAAIA;OAAoBqC;MAAkBA;AAChF1C,YAAUI,YAAYwC,SAAS,GAAG,2BAAA;;;;;;;;;AAClC,QAAMC,UAAU1C,YAAY2C,KAAaC,wBAAgB3C,WAAAA,CAAAA;AAEzD,SAAO;IAAEyC;IAASL;EAAM;AAC1B,CAAA;",
+  "names": ["Command", "Effect", "Layer", "invariant", "defaultPluginLoader", "plugins", "id", "sync", "plugin", "find", "meta", "invariant", "createCliApp", "fn", "rootCommand", "subCommands", "subCommandsProp", "pluginManager", "pluginManagerProp", "pluginLoader", "pluginLoaderProp", "pluginsProp", "core", "coreProp", "enabled", "enabledProp", "safeMode", "map", "manager", "PluginManager", "make", "capabilities", "contribute", "interface", "Capabilities", "implementation", "module", "AtomRegistry", "registry", "activate", "ActivationEvents", "Startup", "layers", "getAll", "Layer", "capabilityServiceLayer", "succeed", "Capability", "Service", "pluginServiceLayer", "Plugin", "layer", "mergeAll", "pluginCommands", "Command", "length", "command", "pipe", "withSubcommands"]
+}

package/dist/lib/browser/common/activation-events.mjs

@@ -0,0 +1,24 @@
+import {
+  ManagedRuntimeReady,
+  OperationInvokerReady,
+  SetupLayer,
+  SetupOperationHandler,
+  SetupReactSurface,
+  Startup
+} from "../chunk-I34GF4NG.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-RHQGPRWN.mjs";
+import "../chunk-56CEL32L.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import "../chunk-ZBA6IH6L.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ManagedRuntimeReady,
+  OperationInvokerReady,
+  SetupLayer,
+  SetupOperationHandler,
+  SetupReactSurface,
+  Startup
+};
+//# sourceMappingURL=activation-events.mjs.map

package/dist/lib/browser/common/capabilities.mjs

@@ -0,0 +1,46 @@
+import {
+  AtomRegistry,
+  Command,
+  HistoryTracker,
+  Layer,
+  ManagedRuntime,
+  Null,
+  OperationHandler,
+  OperationInvoker,
+  PluginManager,
+  ReactContext,
+  ReactRoot,
+  ReactSurface,
+  UndoMapping,
+  UndoRegistry,
+  getAtomValue,
+  subscribeAtom,
+  updateAtomValue
+} from "../chunk-JKWMHZP6.mjs";
+import "../chunk-RFSO3JRG.mjs";
+import "../chunk-RHQGPRWN.mjs";
+import "../chunk-56CEL32L.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import "../chunk-ZBA6IH6L.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  AtomRegistry,
+  Command,
+  HistoryTracker,
+  Layer,
+  ManagedRuntime,
+  Null,
+  OperationHandler,
+  OperationInvoker,
+  PluginManager,
+  ReactContext,
+  ReactRoot,
+  ReactSurface,
+  UndoMapping,
+  UndoRegistry,
+  getAtomValue,
+  subscribeAtom,
+  updateAtomValue
+};
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/browser/core/activation-event.mjs

@@ -0,0 +1,20 @@
+import {
+  allOf,
+  eventKey,
+  getEvents,
+  isAllOf,
+  isOneOf,
+  make,
+  oneOf
+} from "../chunk-QSXYHXCE.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  allOf,
+  eventKey,
+  getEvents,
+  isAllOf,
+  isOneOf,
+  make,
+  oneOf
+};
+//# sourceMappingURL=activation-event.mjs.map

package/dist/lib/browser/core/activation-event.mjs.map

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

package/dist/lib/browser/core/capability.mjs

@@ -0,0 +1,30 @@
+import {
+  ModuleTag,
+  Service,
+  atom,
+  atomByModule,
+  contributes,
+  get,
+  getAll,
+  getModuleTag,
+  lazy,
+  make,
+  makeModule,
+  waitFor
+} from "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ModuleTag,
+  Service,
+  atom,
+  atomByModule,
+  contributes,
+  get,
+  getAll,
+  getModuleTag,
+  lazy,
+  make,
+  makeModule,
+  waitFor
+};
+//# sourceMappingURL=capability.mjs.map

package/dist/lib/browser/core/capability.mjs.map

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

package/dist/lib/browser/core/plugin-manager.mjs

@@ -0,0 +1,15 @@
+import {
+  ManagerTypeId,
+  isManager,
+  make
+} from "../chunk-56CEL32L.mjs";
+import "../chunk-QSXYHXCE.mjs";
+import "../chunk-ZBA6IH6L.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ManagerTypeId,
+  isManager,
+  make
+};
+//# sourceMappingURL=plugin-manager.mjs.map

package/dist/lib/browser/core/plugin-manager.mjs.map

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

package/dist/lib/browser/core/plugin.mjs

@@ -0,0 +1,29 @@
+import {
+  PluginModuleTypeId,
+  PluginTypeId,
+  Service,
+  activate,
+  addModule,
+  define,
+  isPlugin,
+  isPluginModule,
+  make,
+  reset,
+  shutdown
+} from "../chunk-ZBA6IH6L.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  PluginModuleTypeId,
+  PluginTypeId,
+  Service,
+  activate,
+  addModule,
+  define,
+  isPlugin,
+  isPluginModule,
+  make,
+  reset,
+  shutdown
+};
+//# sourceMappingURL=plugin.mjs.map

package/dist/lib/browser/core/plugin.mjs.map

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

package/dist/lib/browser/core/url-loader.mjs

@@ -0,0 +1,16 @@
+import {
+  getRemoteEntries,
+  isLocalUrl,
+  make,
+  preload
+} from "../chunk-RHQGPRWN.mjs";
+import "../chunk-ZBA6IH6L.mjs";
+import "../chunk-2CKCJ6PN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  getRemoteEntries,
+  isLocalUrl,
+  make,
+  preload
+};
+//# sourceMappingURL=url-loader.mjs.map

package/dist/lib/browser/core/url-loader.mjs.map

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

package/dist/lib/browser/index.mjs

@@ -1,166 +1,101 @@
 import {
-  ErrorBoundary,
-  PluginManagerProvider,
-  Surface,
-  isSurfaceAvailable,
-  useApp,
-  useAppGraph,
-  useCapabilities,
-  useCapability,
-  useIntentDispatcher,
-  useIntentResolver,
-  useLayout,
-  usePluginManager,
-  useSurfaces
-} from "./chunk-DHZB7HG7.mjs";
+  PluginManagerContext
+} from "./chunk-TGX63LTL.mjs";
 import {
-  SETTINGS_ACTION,
-  SETTINGS_ID,
-  SETTINGS_KEY,
-  SETTINGS_PLUGIN,
-  SettingsAction
-} from "./chunk-ORWHM7CO.mjs";
+  EmptyHistoryError,
+  history_tracker_exports,
+  undo_mapping_exports,
+  undo_registry_exports
+} from "./chunk-F7FW2RK2.mjs";
 import {
-  Capabilities,
-  CollaborationActions,
-  Events,
-  FileInfoSchema,
-  INTENT_ACTION,
-  INTENT_PLUGIN,
-  IntentAction,
-  IntentPlugin,
-  LAYOUT_ACTION,
-  LAYOUT_PLUGIN,
   Label,
-  LayoutAction,
-  Plugin,
-  PluginContext,
-  PluginManager,
-  PluginModule,
-  Resource,
-  ResourceKey,
-  ResourceLanguage,
-  allOf,
-  chain,
-  contributes,
-  createDispatcher,
-  createIntent,
-  createResolver,
-  createSurface,
-  defaultFileTypes,
-  defineCapability,
-  defineEvent,
-  defineModule,
-  definePlugin,
-  eventKey,
-  getEvents,
-  isAllOf,
-  isOneOf,
-  lazy,
-  oneOf
-} from "./chunk-2636QSIK.mjs";
+  UndoOperation
+} from "./chunk-T3Y4AEKX.mjs";
+import {
+  capabilities_exports
+} from "./chunk-JKWMHZP6.mjs";
+import {
+  activation_events_exports
+} from "./chunk-I34GF4NG.mjs";
+import "./chunk-RFSO3JRG.mjs";
+import {
+  url_loader_exports
+} from "./chunk-RHQGPRWN.mjs";
+import {
+  capability_manager_exports,
+  plugin_manager_exports
+} from "./chunk-56CEL32L.mjs";
+import {
+  activation_event_exports
+} from "./chunk-QSXYHXCE.mjs";
+import {
+  plugin_exports
+} from "./chunk-ZBA6IH6L.mjs";
+import {
+  capability_exports
+} from "./chunk-2CKCJ6PN.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/plugin-operation/meta.ts
+var meta = {
+  id: "org.dxos.plugin.operation",
+  name: "Operation Plugin",
+  description: "Provides operation invocation, undo registry, and history tracking."
+};
 
-// src/plugin-settings/translations.ts
-var translations = [
-  {
-    "en-US": {
-      [SETTINGS_PLUGIN]: {
-        "open settings label": "Open settings",
-        "app settings label": "Settings",
-        "custom plugins label": "Plugins"
-      }
-    }
-  }
-];
+// src/plugin-operation/OperationPlugin.ts
+var OperationInvoker = capability_exports.lazy("OperationInvoker", () => import("./invoker-capability-35BJSGXJ.mjs"));
+var HistoryCapabilities = capability_exports.lazy("HistoryCapabilities", () => import("./capability-EYY7KYU5.mjs"));
+var OperationPlugin = plugin_exports.define(meta).pipe(plugin_exports.addModule({
+  activatesOn: activation_events_exports.ManagedRuntimeReady,
+  firesBeforeActivation: [
+    activation_events_exports.SetupOperationHandler
+  ],
+  firesAfterActivation: [
+    activation_events_exports.OperationInvokerReady
+  ],
+  activate: OperationInvoker
+}), plugin_exports.addModule({
+  activatesOn: activation_events_exports.OperationInvokerReady,
+  activate: HistoryCapabilities
+}), plugin_exports.make);
+
+// src/plugin-runtime/meta.ts
+var meta2 = {
+  id: "org.dxos.plugin.runtime",
+  name: "Runtime Plugin",
+  description: "Provides a managed Effect runtime by composing contributed layers."
+};
 
-// src/plugin-settings/SettingsPlugin.ts
-var SettingsPlugin = () => definePlugin({
-  id: SETTINGS_PLUGIN,
-  name: "Settings"
-}, [
-  defineModule({
-    id: `${SETTINGS_PLUGIN}/module/store`,
-    activatesOn: Events.Startup,
-    activatesBefore: [
-      Events.SetupSettings
-    ],
-    activatesAfter: [
-      Events.SettingsReady
-    ],
-    activate: lazy(() => import("./store-LFKDWHUQ.mjs"))
-  }),
-  defineModule({
-    id: `${SETTINGS_PLUGIN}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations)
-  }),
-  defineModule({
-    id: `${SETTINGS_PLUGIN}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: lazy(() => import("./intent-resolver-O67UANYP.mjs"))
-  }),
-  defineModule({
-    id: `${SETTINGS_PLUGIN}/module/app-graph-builder`,
-    activatesOn: Events.SetupAppGraph,
-    activate: lazy(() => import("./app-graph-builder-BGGXLD6T.mjs"))
-  })
-]);
+// src/plugin-runtime/RuntimePlugin.ts
+var ManagedRuntimeCapability = capability_exports.lazy("ManagedRuntime", () => import("./capability-W7NPZR6A.mjs"));
+var RuntimePlugin = plugin_exports.define(meta2).pipe(plugin_exports.addModule({
+  activatesOn: activation_events_exports.Startup,
+  firesBeforeActivation: [
+    activation_events_exports.SetupLayer
+  ],
+  firesAfterActivation: [
+    activation_events_exports.ManagedRuntimeReady
+  ],
+  activate: ManagedRuntimeCapability
+}), plugin_exports.make);
 export {
-  Capabilities,
-  CollaborationActions,
-  ErrorBoundary,
-  Events,
-  FileInfoSchema,
-  INTENT_ACTION,
-  INTENT_PLUGIN,
-  IntentAction,
-  IntentPlugin,
-  LAYOUT_ACTION,
-  LAYOUT_PLUGIN,
+  activation_event_exports as ActivationEvent,
+  activation_events_exports as ActivationEvents,
+  capabilities_exports as Capabilities,
+  capability_exports as Capability,
+  capability_manager_exports as CapabilityManager,
+  EmptyHistoryError,
+  history_tracker_exports as HistoryTracker,
   Label,
-  LayoutAction,
-  Plugin,
-  PluginContext,
-  PluginManager,
-  PluginManagerProvider,
-  PluginModule,
-  Resource,
-  ResourceKey,
-  ResourceLanguage,
-  SETTINGS_ACTION,
-  SETTINGS_ID,
-  SETTINGS_KEY,
-  SETTINGS_PLUGIN,
-  SettingsAction,
-  SettingsPlugin,
-  Surface,
-  allOf,
-  chain,
-  contributes,
-  createDispatcher,
-  createIntent,
-  createResolver,
-  createSurface,
-  defaultFileTypes,
-  defineCapability,
-  defineEvent,
-  defineModule,
-  definePlugin,
-  eventKey,
-  getEvents,
-  isAllOf,
-  isOneOf,
-  isSurfaceAvailable,
-  lazy,
-  oneOf,
-  useApp,
-  useAppGraph,
-  useCapabilities,
-  useCapability,
-  useIntentDispatcher,
-  useIntentResolver,
-  useLayout,
-  usePluginManager,
-  useSurfaces
+  OperationPlugin,
+  plugin_exports as Plugin,
+  plugin_manager_exports as PluginManager,
+  PluginManagerContext,
+  RuntimePlugin,
+  undo_mapping_exports as UndoMapping,
+  UndoOperation,
+  undo_registry_exports as UndoRegistry,
+  url_loader_exports as UrlLoader
 };
 //# sourceMappingURL=index.mjs.map