@dxos/app-framework 0.8.4-main.b97322e → 0.8.4-main.bc674ce

package/dist/types/src/common/plugin.d.ts

@@ -0,0 +1,201 @@
+import type * as Command$ from '@effect/cli/Command';
+import { type Type } from '@dxos/echo';
+import { Plugin as Plugin$ } from '../core';
+import { Capability } from './capability';
+import { type Resource } from './translations';
+type PluginModuleOptions = Partial<Pick<Plugin$.PluginModuleOptions, 'id' | 'activatesOn' | 'activatesBefore' | 'activatesAfter'>> & Pick<Plugin$.PluginModuleOptions, 'activate'>;
+/**
+ * Helper functions for creating common plugin module patterns.
+ */
+export declare namespace Plugin {
+    type OperationResolverModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes operation handlers.
+     *
+     * @param options Module options including the activate function and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addOperationResolverModule({
+     *     activate: (context) =>
+     *       Capability.contributes(Common.Capability.OperationResolver, [{
+     *         operation: MyOperation,
+     *         handler: (input) => Effect.succeed(...)
+     *       }])
+     *   })
+     * )
+     * ```
+     */
+    function addOperationResolverModule<T = void>(options: OperationResolverModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type SurfaceModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes React surfaces.
+     *
+     * @param options Module options including the activate function and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addSurfaceModule({
+     *     activate: (context) =>
+     *       Capability.contributes(Common.Capability.ReactSurface, [
+     *         Common.createSurface({ id: `${meta.id}/my-surface`, ... })
+     *       ])
+     *   })
+     * )
+     * ```
+     */
+    function addSurfaceModule<T = void>(options: SurfaceModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type ReactRootModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes a React root.
+     */
+    function addReactRootModule<T = void>(options: ReactRootModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type ReactContextModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes a React context.
+     */
+    function addReactContextModule<T = void>(options: ReactContextModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type AppGraphModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes app graph builder extensions.
+     *
+     * @param options Module options including the activate function and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addAppGraphModule({
+     *     activate: Effect.fnUntraced(function* () {
+     *       const extensions = yield* GraphBuilder.createExtension({
+     *         id: meta.id,
+     *         match: NodeMatcher.whenRoot,
+     *         // All callbacks must return Effects.
+     *         actions: () => Effect.succeed([{
+     *           id: 'my-action',
+     *           // Action data returns Effect for automatic context access.
+     *           data: Effect.fnUntraced(function* () {
+     *             yield* Operation.invoke(MyOperation, { ... });
+     *           }),
+     *           properties: { label: 'My Action', icon: 'ph--icon' },
+     *         }]),
+     *         connector: (node, get) => Effect.succeed([{ id: 'child', ... }]),
+     *       });
+     *       return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);
+     *     })
+     *   })
+     * )
+     * ```
+     */
+    function addAppGraphModule<T = void>(options: AppGraphModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type TranslationsModuleOptions = Omit<PluginModuleOptions, 'activate'> & {
+        translations: Resource | Resource[];
+    };
+    /**
+     * Creates a module that contributes translations.
+     *
+     * @param options Module options including translations and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addTranslationsModule({
+     *     translations: translations
+     *   })
+     * )
+     * ```
+     */
+    function addTranslationsModule<T = void>(options: TranslationsModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type MetadataModuleOptions = Omit<PluginModuleOptions, 'activate'> & {
+        metadata: Capability.Metadata | Capability.Metadata[];
+    };
+    /**
+     * Creates a module that contributes metadata.
+     *
+     * @param options Module options including metadata and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addMetadataModule({
+     *     metadata: {
+     *       id: MyType.typename,
+     *       metadata: { icon: 'ph--icon', ... }
+     *     }
+     *   })
+     * )
+     * ```
+     */
+    function addMetadataModule<T = void>(options: MetadataModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type SettingsModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes settings.
+     */
+    function addSettingsModule<T = void>(options: SettingsModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type BlueprintDefinitionModuleOptions = PluginModuleOptions;
+    /**
+     * Creates a module that contributes blueprint definitions.
+     *
+     * @param options Module options including the activate function and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addBlueprintDefinitionModule({
+     *     activate: (context) =>
+     *       Capability.contributes(Common.Capability.BlueprintDefinition, [
+     *         BlueprintDefinition.make({ key: 'my-blueprint', ... })
+     *       ])
+     *   })
+     * )
+     * ```
+     */
+    function addBlueprintDefinitionModule<T = void>(options: BlueprintDefinitionModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type SchemaModuleOptions = Omit<PluginModuleOptions, 'activate'> & {
+        schema: ReadonlyArray<Type.Entity.Any>;
+    };
+    /**
+     * Creates a module that contributes schemas.
+     *
+     * @param options Module options including schema array and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addSchemaModule({
+     *     schema: [MyType.Type, AnotherType.Type]
+     *   })
+     * )
+     * ```
+     */
+    function addSchemaModule<T = void>(options: SchemaModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+    type CommandModuleOptions = Omit<PluginModuleOptions, 'activate'> & {
+        commands: ReadonlyArray<Command$.Command<any, any, any, any>>;
+    };
+    /**
+     * Creates a module that contributes CLI commands.
+     *
+     * @param options Module options including commands and optional configuration
+     * @returns A function that can be used with Plugin.addModule() in a pipe chain
+     *
+     * @example
+     * ```ts
+     * Plugin.define(meta).pipe(
+     *   Common.Plugin.addCommandModule({
+     *     commands: [myCommand, anotherCommand]
+     *   })
+     * )
+     * ```
+     */
+    function addCommandModule<T = void>(options: CommandModuleOptions): (builder: Plugin$.PluginBuilder<T>) => Plugin$.PluginBuilder<T>;
+}
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/common/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/common/plugin.ts"],"names":[],"mappings":"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"}

package/dist/types/src/common/surface.d.ts

@@ -1,10 +1,10 @@
-import { type JSX, type ForwardedRef, type PropsWithChildren, type ReactNode } from 'react';
-import { type GuardedType, type MakeOptional, type Position } from '@dxos/util';
-import { type ErrorBoundary } from '../react';
+import type { PropsWithChildren, ReactNode, RefCallback } from 'react';
+import type { MakeOptional, Position } from '@dxos/util';
+import type { ErrorBoundary } from '../react';
 /**
  * SurfaceProps are the props that are passed to the Surface component.
  */
-export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
+export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
     /**
      * If specified, the Surface will be wrapped in an error boundary.
      * The fallback component will be rendered if an error occurs.
@@ -15,14 +15,19 @@ export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>
      * The placeholder component will be rendered while the surface component is loading.
      */
     placeholder?: ReactNode;
-}> & MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> & {
-    /**
-     * Additional props to pass to the component.
-     * These props are not used by Surface itself but may be used by components which resolve the surface.
-     */
-    [key: string]: unknown;
+} & MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> & 
+/**
+ * Additional props to pass to the component.
+ * These props are not used by Surface itself but may be used by components which resolve the surface.
+ * Exclude known prop names to prevent overriding well-defined props.
+ */
+{
+    [K in keyof Record<string, any>]: K extends keyof CoreSurfaceProps<T> | 'fallback' | 'placeholder' ? never : any;
 };
-type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
+/**
+ * NOTE: If `[key: string]: unknown` is included in shared types, when re-used other fields become unknown as well.
+ */
+export type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
     /**
      * ID for debugging.
      */
@@ -33,33 +38,57 @@ type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> =
     role: string;
     /**
      * The data to be rendered by the surface.
+     * NOTE: This must be a stable value.
      */
     data: T;
     /**
      * If more than one component is resolved, the limit determines how many are rendered.
      */
     limit?: number | undefined;
-};
-type SurfaceComponentProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<CoreSurfaceProps<T> & {
-    [key: string]: unknown;
 }>;
+export type SurfaceComponentProps<T extends Record<string, any> = Record<string, any>> = CoreSurfaceProps<T> & {
+    ref?: RefCallback<HTMLElement>;
+} & Record<string, any>;
 /**
  * React component used to render a surface once is has matched.
  */
-export type SurfaceComponent<T extends Record<string, any> = Record<string, unknown>> = (props: SurfaceComponentProps<T>, forwardedRef: ForwardedRef<HTMLElement>) => JSX.Element | null;
+export type SurfaceComponent<T extends Record<string, any> = Record<string, any>> = (props: SurfaceComponentProps<T>) => ReactNode;
+/**
+ * Definition of when a React SurfaceComponent should be rendered.
+ */
+export type ReactSurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
+    kind: 'react';
+    id: string;
+    role: string | string[];
+    position?: Position;
+    component: SurfaceComponent<T>;
+    filter?: (data: Record<string, unknown>) => data is T;
+}>;
 /**
- * Definition of when a SurfaceComponent should be rendered.
+ * Definition of when a Web Component surface should be rendered.
  */
-export type SurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
+export type WebComponentSurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
+    kind: 'web-component';
     id: string;
     role: string | string[];
     position?: Position;
+    /**
+     * The tag name of the Web Component to render.
+     * The Web Component will receive the same props as React surfaces via properties/attributes.
+     */
+    tagName: string;
     filter?: (data: Record<string, unknown>) => data is T;
-    component: SurfaceComponent<GuardedType<SurfaceDefinition<T>['filter']>>;
 }>;
 /**
- * Creates a surface definition.
+ * Definition of when a surface (React or Web Component) should be rendered.
+ */
+export type SurfaceDefinition<T extends Record<string, any> = any> = ReactSurfaceDefinition<T> | WebComponentSurfaceDefinition<T>;
+/**
+ * Creates a React surface definition.
+ */
+export declare const createSurface: <T extends Record<string, any> = any>(definition: Omit<ReactSurfaceDefinition<T>, "kind">) => ReactSurfaceDefinition<T>;
+/**
+ * Creates a Web Component surface definition.
  */
-export declare const createSurface: <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => SurfaceDefinition<T>;
-export {};
+export declare const createWebSurface: <T extends Record<string, any> = any>(definition: Omit<WebComponentSurfaceDefinition<T>, "kind">) => WebComponentSurfaceDefinition<T>;
 //# sourceMappingURL=surface.d.ts.map

package/dist/types/src/common/surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../../src/common/surface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5F,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9C;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB,CAAC,GACA,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;IACjD;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAGJ,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC/E;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CACrG,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACtF,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,KACpC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IACtD,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAC/D,YAAY,iBAAiB,CAAC,CAAC,CAAC,KAC/B,iBAAiB,CAAC,CAAC,CAAe,CAAC"}
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../../src/common/surface.ts"],"names":[],"mappings":"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"}

package/dist/types/src/common/translations.d.ts

@@ -1,4 +1,13 @@
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
+/**
+ * A Label represents translatable text - either a simple string or a tuple of [key, options].
+ */
+export declare const Label: Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Tuple2<typeof Schema.String, Schema.mutable<Schema.Struct<{
+    ns: typeof Schema.String;
+    count: Schema.optional<typeof Schema.Number>;
+    defaultValue: Schema.optional<typeof Schema.String>;
+}>>>>]>;
+export type Label = Schema.Schema.Type<typeof Label>;
 export declare const ResourceKey: Schema.Union<[typeof Schema.String, Schema.Record$<typeof Schema.String, typeof Schema.Any>]>;
 export type ResourceKey = Schema.Schema.Type<typeof ResourceKey>;
 export declare const ResourceLanguage: Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, Schema.Record$<typeof Schema.String, typeof Schema.Any>]>>;

package/dist/types/src/common/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/common/translations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,WAAW,+FAAwF,CAAC;AACjH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,qIAA4D,CAAC;AAC1F,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,QAAQ,2KAAiE,CAAC;AACvF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/common/translations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,KAAK;;;;OAcjB,CAAC;AACF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,WAAW,+FAAwF,CAAC;AACjH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,qIAA4D,CAAC;AAC1F,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,QAAQ,2KAAiE,CAAC;AACvF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/types/src/context.d.ts

@@ -0,0 +1,5 @@
+import { type PluginManager } from './core';
+export declare const PluginManagerContext: {
+    __context__: PluginManager.PluginManager;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/types/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,eAAO,MAAM,oBAAoB;;CAAsF,CAAC"}

package/dist/types/src/core/{events.d.ts → activation-event.d.ts}

@@ -11,7 +11,7 @@ export type ActivationEvent = {
 /**
  * An activation event that can be a single event, or a combination of events.
  */
-export type ActivationEvents = ActivationEvent | {
+export type Events = ActivationEvent | {
     type: 'one-of';
     events: ActivationEvent[];
 } | {
@@ -21,7 +21,7 @@ export type ActivationEvents = ActivationEvent | {
 /**
  * Helper to define an activation event.
  */
-export declare const defineEvent: (id: string, specifier?: string) => ActivationEvent;
+export declare const make: (id: string, specifier?: string) => ActivationEvent;
 /**
  * Helper to create an activation event key.
  */
@@ -43,19 +43,19 @@ export declare const allOf: (...events: ActivationEvent[]) => {
 /**
  * Helper to check if an activation event is a one-of event.
  */
-export declare const isOneOf: (events: ActivationEvents) => events is {
+export declare const isOneOf: (events: Events) => events is {
     type: "one-of";
     events: ActivationEvent[];
 };
 /**
  * Helper to check if an activation event is an all-of event.
  */
-export declare const isAllOf: (events: ActivationEvents) => events is {
+export declare const isAllOf: (events: Events) => events is {
     type: "all-of";
     events: ActivationEvent[];
 };
 /**
  * Helper to get the events from an activation event.
  */
-export declare const getEvents: (events: ActivationEvents) => ActivationEvent[];
-//# sourceMappingURL=events.d.ts.map
+export declare const getEvents: (events: Events) => ActivationEvent[];
+//# sourceMappingURL=activation-event.d.ts.map

package/dist/types/src/core/activation-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-event.d.ts","sourceRoot":"","sources":["../../../../src/core/activation-event.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,eAAe,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,IAAI,MAAM,EAAE,YAAY,MAAM,KACrB,eAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,eAAe,WAAoE,CAAC;AAEpH;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,eAAe,EAAE;;;CAA0C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,eAAe,EAAE;;;CAA0C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAChD,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAChD,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,sBAAkD,CAAC"}

package/dist/types/src/core/capability-manager.d.ts

@@ -0,0 +1,43 @@
+import { Atom } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
+import type * as Capability from './capability';
+/**
+ * Interface for the Capability Manager.
+ * Provides methods for contributing, removing, and accessing capabilities.
+ */
+export interface CapabilityManager {
+    contribute<T>(args: {
+        module: string;
+        interface: Capability.InterfaceDef<T>;
+        implementation: T;
+    }): void;
+    remove<T>(interfaceDef: Capability.InterfaceDef<T>, implementation: T): void;
+    /**
+     * Get the Atom reference to the available capabilities for a given interface.
+     * Primarily useful for deriving other Atom values based on the capabilities or
+     * for subscribing to changes in the capabilities.
+     * @returns An atom reference to the available capabilities.
+     */
+    atom<T>(interfaceDef: Capability.InterfaceDef<T>): Atom.Atom<T[]>;
+    /**
+     * Get capabilities from the capability manager.
+     * @returns An array of capabilities.
+     */
+    getAll<T>(interfaceDef: Capability.InterfaceDef<T>): T[];
+    /**
+     * Requests a single capability from the capability manager.
+     * @returns The capability.
+     * @throws If no capability is found.
+     */
+    get<T>(interfaceDef: Capability.InterfaceDef<T>): T;
+    /**
+     * Waits for a capability to be available.
+     * @returns The capability.
+     */
+    waitFor<T>(interfaceDef: Capability.InterfaceDef<T>): Effect.Effect<T, Error>;
+}
+/**
+ * Creates a new Capability Manager instance.
+ */
+export declare const make: (options: CapabilityManagerOptions) => CapabilityManager;
+//# sourceMappingURL=capability-manager.d.ts.map

package/dist/types/src/core/capability-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/capability-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAiB,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,KAAK,KAAK,UAAU,MAAM,cAAc,CAAC;AAehD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAAC,cAAc,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAExG,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC;IAE7E;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAElE;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAEzD;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEpD;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;CAC/E;AA0GD;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS,wBAAwB,KAAG,iBAAuD,CAAC"}

package/dist/types/src/core/capability-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability-manager.test.d.ts.map

package/dist/types/src/core/capability-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-manager.test.d.ts","sourceRoot":"","sources":["../../../../src/core/capability-manager.test.ts"],"names":[],"mappings":""}

package/dist/types/src/core/capability.d.ts

@@ -0,0 +1,150 @@
+import { type Atom } from '@effect-atom/atom-react';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import type * as CapabilityManager from './capability-manager';
+import type * as Plugin from './plugin';
+declare const Service_base: Context.TagClass<Service, "@dxos/app-framework/CapabilityManager", CapabilityManager.CapabilityManager>;
+/**
+ * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.
+ * This allows capability modules to access the capability manager without having it passed as an argument.
+ */
+export declare class Service extends Service_base {
+}
+/**
+ * Get a single capability from the capability manager.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns The capability implementation.
+ * @throws If no capability is found.
+ */
+export declare const get: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T, Error, Service>;
+/**
+ * Get all capabilities from the capability manager for a given interface.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns An array of capability implementations.
+ */
+export declare const getAll: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T[], never, Service>;
+/**
+ * Wait for a capability to be available.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns The capability implementation once available.
+ */
+export declare const waitFor: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T, Error, Service>;
+/**
+ * Get the Atom reference to capabilities for reactive access.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns An Atom containing the array of capability implementations.
+ */
+export declare const atom: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<Atom.Atom<T[]>, never, Service>;
+declare const InterfaceDefTypeId: unique symbol;
+/**
+ * Symbol used to tag lazy capability functions with their module ID.
+ */
+export declare const ModuleTag: unique symbol;
+/**
+ * The interface definition of a capability.
+ */
+export type InterfaceDef<T> = {
+    [InterfaceDefTypeId]: T;
+    identifier: string;
+};
+export declare namespace InterfaceDef {
+    type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;
+}
+/**
+ * Helper to define the interface of a capability.
+ */
+export declare const make: <T>(identifier: string) => InterfaceDef<T>;
+/**
+ * A unique string identifier with a Typescript type associated with it.
+ * When a capability is contributed to the application an implementation of the interface is provided.
+ */
+export type Capability<T> = {
+    /**
+     * The interface definition of the capability.
+     */
+    readonly interface: InterfaceDef<T>;
+    /**
+     * The implementation of the capability.
+     */
+    readonly implementation: T;
+    /**
+     * Called when the capability is deactivated.
+     */
+    readonly deactivate?: () => Effect.Effect<void, Error>;
+};
+export type Any = Capability<any>;
+/**
+ * Union type representing all valid return types for a capability module.
+ * Supports single capabilities, arrays, and tuples of different capability types.
+ */
+export type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];
+/**
+ * Helper to define the implementation of a capability.
+ */
+export declare const contributes: <I extends InterfaceDef<any>>(interfaceDef: I, implementation: Capability<InterfaceDef.Implementation<I>>["implementation"], deactivate?: Capability<InterfaceDef.Implementation<I>>["deactivate"]) => Capability<I>;
+type LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{
+    default: (props?: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;
+}>;
+type LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{
+    default: (props?: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;
+}>;
+type NormalizeReturn<R> = R extends readonly (infer A)[] ? A[] : R extends (infer A)[] ? A[] : R extends Any ? [R] : Any[];
+export type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (props?: Props) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;
+/**
+ * Helper to define a lazily loaded implementation of a capability.
+ * Supports single capabilities, arrays, and tuples of different capability types.
+ * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.
+ * @param loader The lazy loader function.
+ * @returns A lazy capability function with ModuleTag symbol attached.
+ */
+export declare const lazy: <T = void, R extends ModuleReturn = ModuleReturn>(name: string, c: LoadCapability<T, R> | LoadCapabilities<T, R>) => LazyCapability<T, R>;
+/**
+ * Gets the module tag (export name) from a lazy capability function.
+ * @param capability The lazy capability function.
+ * @returns The module tag if present, undefined otherwise.
+ */
+export declare const getModuleTag: (capability: unknown) => string | undefined;
+/**
+ * Helper to define a capability module with explicit typing.
+ * Wraps the default export function to provide better type inference and make the pattern explicit.
+ *
+ * This helper provides explicit typing for the module activation function,
+ * making it clear that the function should:
+ * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)
+ * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)
+ *
+ * Supports returning multiple capabilities of different types as a tuple, which will be normalized
+ * to an array at runtime for compatibility with the plugin system.
+ *
+ * @example
+ * ```ts
+ * // Module without options - single capability
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* () {
+ *     const client = yield* Capability.get(ClientCapabilities.Client);
+ *     return contributes(Capabilities.SettingsStore, store);
+ *   })
+ * );
+ *
+ * // Module with multiple capabilities
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* () {
+ *     return [
+ *       contributes(Capabilities.SettingsStore, store),
+ *       contributes(Capabilities.Translations, translations),
+ *     ];
+ *   })
+ * );
+ *
+ * // Module with additional options (context accessed via layer)
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* ({ observability }: { observability?: boolean }) {
+ *     const invoker = yield* Capability.get(Common.Capability.OperationInvoker);
+ *     return contributes(Capabilities.IntentResolver, ...);
+ *   })
+ * );
+ * ```
+ */
+export declare const makeModule: <TProps = void, TReturn extends ModuleReturn = ModuleReturn, E extends Error = Error, R extends Service | Plugin.Service | never = Service>(fn: (props?: TProps) => Effect.Effect<TReturn, E, R>) => ((props?: TProps) => Effect.Effect<TReturn, E, R>);
+export {};
+//# sourceMappingURL=capability.d.ts.map

package/dist/types/src/core/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../src/core/capability.ts"],"names":[],"mappings":"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"}

package/dist/types/src/core/index.d.ts

@@ -1,5 +1,6 @@
-export * from './capabilities';
-export * from './events';
-export * from './manager';
-export * from './plugin';
+export * as ActivationEvent from './activation-event';
+export * as Capability from './capability';
+export * as CapabilityManager from './capability-manager';
+export * as Plugin from './plugin';
+export * as PluginManager from './plugin-manager';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,eAAe,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC"}