@dxos/app-framework 0.7.5-main.9d26e3a → 0.7.5-main.e9bb01b

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

@@ -0,0 +1,248 @@
+import { Schema as S } from '@effect/schema';
+export declare const LAYOUT_PLUGIN = "dxos.org/plugin/layout";
+export declare const LAYOUT_ACTION = "dxos.org/plugin/layout/action";
+/**
+ * Expected payload for layout actions.
+ */
+export declare namespace LayoutAction {
+    export const UPDATE_LAYOUT = "dxos.org/plugin/layout/action/update-layout";
+    const UpdateLayout_base: S.TaggedClass<UpdateLayout, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.SchemaClass<string, string, never>;
+            subject: S.optional<S.SchemaClass<any, any, never>>;
+            options: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    /**
+     * Generic layout action.
+     */
+    export class UpdateLayout extends UpdateLayout_base {
+    }
+    const SetLayoutMode_base: S.TaggedClass<SetLayoutMode, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["mode"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.Union<[S.Struct<{
+                mode: S.SchemaClass<string, string, never>;
+            }>, S.Struct<{
+                revert: S.SchemaClass<boolean, boolean, never>;
+            }>]>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class SetLayoutMode extends SetLayoutMode_base {
+    }
+    const UpdateSidebar_base: S.TaggedClass<UpdateSidebar, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["sidebar"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.optional<S.Struct<{
+                state: S.Literal<["closed", "collapsed", "expanded"]>;
+            }>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class UpdateSidebar extends UpdateSidebar_base {
+    }
+    const UpdateComplementary_base: S.TaggedClass<UpdateComplementary, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["complementary"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.optional<S.Struct<{
+                state: S.Literal<["closed", "collapsed", "expanded"]>;
+            }>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class UpdateComplementary extends UpdateComplementary_base {
+    }
+    const UpdateDialog_base: S.TaggedClass<UpdateDialog, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["dialog"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.Struct<{
+                state: S.optional<S.SchemaClass<boolean, boolean, never>>;
+                blockAlign: S.optional<S.Literal<["start", "center"]>>;
+                type: S.optional<S.Literal<["default", "alert"]>>;
+                props: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+            }>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class UpdateDialog extends UpdateDialog_base {
+    }
+    const UpdatePopover_base: S.TaggedClass<UpdatePopover, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["popover"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.Struct<{
+                anchorId: S.SchemaClass<string, string, never>;
+                state: S.optional<S.SchemaClass<boolean, boolean, never>>;
+                props: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+            }>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class UpdatePopover extends UpdatePopover_base {
+    }
+    export const Toast: S.Struct<{
+        id: S.SchemaClass<string, string, never>;
+        title: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+            ns: typeof S.String;
+            count: S.optional<typeof S.Number>;
+        }>>]>>]>>;
+        description: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+            ns: typeof S.String;
+            count: S.optional<typeof S.Number>;
+        }>>]>>]>>;
+        icon: S.optional<S.SchemaClass<string, string, never>>;
+        duration: S.optional<S.SchemaClass<number, number, never>>;
+        closeLabel: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+            ns: typeof S.String;
+            count: S.optional<typeof S.Number>;
+        }>>]>>]>>;
+        actionLabel: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+            ns: typeof S.String;
+            count: S.optional<typeof S.Number>;
+        }>>]>>]>>;
+        actionAlt: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+            ns: typeof S.String;
+            count: S.optional<typeof S.Number>;
+        }>>]>>]>>;
+        onAction: S.optional<S.SchemaClass<any, any, never>>;
+    }>;
+    export interface Toast extends Omit<S.Schema.Type<typeof Toast>, 'onAction'> {
+        onAction?: () => void;
+    }
+    const AddToast_base: S.TaggedClass<AddToast, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["toast"]>;
+            subject: S.Struct<{
+                id: S.SchemaClass<string, string, never>;
+                title: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                    ns: typeof S.String;
+                    count: S.optional<typeof S.Number>;
+                }>>]>>]>>;
+                description: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                    ns: typeof S.String;
+                    count: S.optional<typeof S.Number>;
+                }>>]>>]>>;
+                icon: S.optional<S.SchemaClass<string, string, never>>;
+                duration: S.optional<S.SchemaClass<number, number, never>>;
+                closeLabel: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                    ns: typeof S.String;
+                    count: S.optional<typeof S.Number>;
+                }>>]>>]>>;
+                actionLabel: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                    ns: typeof S.String;
+                    count: S.optional<typeof S.Number>;
+                }>>]>>]>>;
+                actionAlt: S.optional<S.Union<[typeof S.String, S.mutable<S.Tuple<[typeof S.String, S.mutable<S.Struct<{
+                    ns: typeof S.String;
+                    count: S.optional<typeof S.Number>;
+                }>>]>>]>>;
+                onAction: S.optional<S.SchemaClass<any, any, never>>;
+            }>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class AddToast extends AddToast_base {
+    }
+    const SwitchWorkspace_base: S.TaggedClass<SwitchWorkspace, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["workspace"]>;
+            subject: S.SchemaClass<string, string, never>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class SwitchWorkspace extends SwitchWorkspace_base {
+    }
+    const Open_base: S.TaggedClass<Open, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["main"]>;
+            subject: S.Array$<S.SchemaClass<string, string, never>>;
+            options: S.optional<S.Struct<{
+                state: S.optional<S.Literal<[true]>>;
+                key: S.optional<S.SchemaClass<string, string, never>>;
+                scrollIntoView: S.optional<S.SchemaClass<boolean, boolean, never>>;
+                pivotId: S.optional<S.SchemaClass<string, string, never>>;
+                positioning: S.optional<S.Union<[S.Literal<["start"]>, S.Literal<["end"]>]>>;
+            }>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class Open extends Open_base {
+    }
+    const Set_base: S.TaggedClass<Set, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["main"]>;
+            subject: S.Array$<S.SchemaClass<string, string, never>>;
+            options: S.Struct<{
+                override: S.Literal<[true]>;
+            }>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class Set extends Set_base {
+    }
+    const Close_base: S.TaggedClass<Close, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["main"]>;
+            subject: S.Array$<S.SchemaClass<string, string, never>>;
+            options: S.Struct<{
+                state: S.Literal<[false]>;
+            }>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class Close extends Close_base {
+    }
+    const ScrollIntoView_base: S.TaggedClass<ScrollIntoView, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["current"]>;
+            subject: S.optional<S.SchemaClass<string, string, never>>;
+            options: S.optional<S.Record$<typeof S.String, typeof S.Any>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class ScrollIntoView extends ScrollIntoView_base {
+    }
+    const Expose_base: S.TaggedClass<Expose, "dxos.org/plugin/layout/action/update-layout", {
+        readonly _tag: S.tag<"dxos.org/plugin/layout/action/update-layout">;
+    } & {
+        input: S.Struct<{
+            part: S.Literal<["navigation"]>;
+            subject: S.SchemaClass<string, string, never>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class Expose extends Expose_base {
+    }
+    export {};
+}
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../src/common/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,gBAAgB,CAAC;AAI7C,eAAO,MAAM,aAAa,2BAA2B,CAAC;AACtD,eAAO,MAAM,aAAa,kCAA4B,CAAC;AAEvD;;GAEG;AACH,yBAAiB,YAAY,CAAC;IAC5B,MAAM,CAAC,MAAM,aAAa,gDAAmC,CAAC;;;;;;;;;;;IAE9D;;OAEG;IACH,MAAM,OAAO,YAAa,SAAQ,iBAWhC;KAAG;;;;;;;;;;;;;;;IAYL,MAAM,OAAO,aAAc,SAAQ,kBAUjC;KAAG;;;;;;;;;;;;;IAEL,MAAM,OAAO,aAAc,SAAQ,kBAajC;KAAG;;;;;;;;;;;;;IAEL,MAAM,OAAO,mBAAoB,SAAQ,wBAevC;KAAG;;;;;;;;;;;;;;;;IAEL,MAAM,OAAO,YAAa,SAAQ,iBAkBhC;KAAG;;;;;;;;;;;;;;;IAEL,MAAM,OAAO,aAAc,SAAQ,kBAejC;KAAG;IAEL,MAAM,CAAC,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;MAYhB,CAAC;IAEH,MAAM,WAAW,KAAM,SAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,UAAU,CAAC;QAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;KACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAED,MAAM,OAAO,QAAS,SAAQ,aAM5B;KAAG;;;;;;;;;;IAEL,MAAM,OAAO,eAAgB,SAAQ,oBAMnC;KAAG;;;;;;;;;;;;;;;;;IAEL,MAAM,OAAO,IAAK,SAAQ,SAsBxB;KAAG;;;;;;;;;;;;;IAEL,MAAM,OAAO,GAAI,SAAQ,QASvB;KAAG;;;;;;;;;;;;;IAEL,MAAM,OAAO,KAAM,SAAQ,UASzB;KAAG;;;;;;;;;;;IAEL,MAAM,OAAO,cAAe,SAAQ,mBAWlC;KAAG;;;;;;;;;;IAEL,MAAM,OAAO,MAAO,SAAQ,WAM1B;KAAG;;CACN"}

package/dist/types/src/{plugins/plugin-surface/SurfaceContext.d.ts → common/surface.d.ts}

@@ -1,6 +1,6 @@
 import { type JSX, type ForwardedRef, type PropsWithChildren, type ReactNode } from 'react';
-import { type GuardedType, type MakeOptional } from '@dxos/util';
-import { type ErrorBoundary } from './ErrorBoundary';
+import { type GuardedType, type MakeOptional, type Position } from '@dxos/util';
+import { type ErrorBoundary } from '../react';
 /**
  * SurfaceProps are the props that are passed to the Surface component.
  */
@@ -47,39 +47,22 @@ type SurfaceComponentProps<T extends Record<string, any> = Record<string, unknow
  * 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;
-/**
- * Determines the priority of the surface when multiple components are resolved.
- *
- * - `static` - The component is rendered in the order it was resolved.
- * - `hoist` - The component is rendered before `static` components.
- * - `fallback` - The component is rendered after `static` components.
- */
-export type SurfaceDisposition = 'static' | 'hoist' | 'fallback';
 /**
  * Definition of when a SurfaceComponent should be rendered.
  */
-export type SurfaceDefinition<T extends Record<string, any> = any> = {
+export type SurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
     id: string;
     role: string | string[];
-    disposition?: SurfaceDisposition;
+    position?: Position;
     filter?: (data: Record<string, unknown>) => data is T;
     component: SurfaceComponent<GuardedType<SurfaceDefinition<T>['filter']>>;
-};
-export declare const createSurface: <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => SurfaceDefinition<T>;
-/**
- * Surface debug info.
- * NOTE: Short-term measure to track perf issues.
- */
-export type DebugInfo = {
+}>;
+export declare const createSurface: <T extends Record<string, any> = any>(definition: SurfaceDefinition<T>) => Readonly<{
     id: string;
-    created: number;
-    renderCount: number;
-} & Pick<SurfaceProps, 'role'>;
-export type SurfaceContextValue = {
-    surfaces: Record<string, SurfaceDefinition>;
-    debugInfo?: Map<string, DebugInfo>;
-};
-export declare const useSurfaceRoot: () => SurfaceContextValue;
-export declare const SurfaceProvider: import("react").Provider<SurfaceContextValue | undefined>;
+    role: string | string[];
+    position?: Position;
+    filter?: ((data: Record<string, unknown>) => data is T) | undefined;
+    component: SurfaceComponent<T>;
+}>;
 export {};
-//# sourceMappingURL=SurfaceContext.d.ts.map
+//# sourceMappingURL=surface.d.ts.map

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

@@ -0,0 +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,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,oBAAoB,iBAAiB,CAAC,CAAC,CAAC;QAP7F,MAAM;UACJ,MAAM,GAAG,MAAM,EAAE;eACZ,QAAQ;qBACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;;EAI2D,CAAC"}

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

@@ -0,0 +1,11 @@
+import { Schema as S } from '@effect/schema';
+export declare const ResourceKey: S.Union<[typeof S.String, S.Record$<typeof S.String, typeof S.Any>]>;
+export type ResourceKey = S.Schema.Type<typeof ResourceKey>;
+export declare const ResourceLanguage: S.Record$<typeof S.String, S.Union<[typeof S.String, S.Record$<typeof S.String, typeof S.Any>]>>;
+export type ResourceLanguage = S.Schema.Type<typeof ResourceLanguage>;
+/**
+ * A resource is a collection of translations for a language.
+ */
+export declare const Resource: S.Record$<typeof S.String, S.Record$<typeof S.String, S.Union<[typeof S.String, S.Record$<typeof S.String, typeof S.Any>]>>>;
+export type Resource = S.Schema.Type<typeof Resource>;
+//# sourceMappingURL=translations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../src/common/translations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,gBAAgB,CAAC;AAE7C,eAAO,MAAM,WAAW,sEAA+D,CAAC;AACxF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAE5D,eAAO,MAAM,gBAAgB,kGAAkD,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,QAAQ,8HAAuD,CAAC;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC"}

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

@@ -0,0 +1,94 @@
+/**
+ * Interface definition for a capability.
+ */
+import { type Effect } from 'effect';
+import { type MaybePromise } from '@dxos/util';
+import { type ActivationEvent } from './events';
+declare const InterfaceDefTypeId: unique symbol;
+/**
+ * The interface definition of a capability.
+ */
+export type InterfaceDef<T> = {
+    [InterfaceDefTypeId]: T;
+    identifier: string;
+};
+/**
+ * Helper to define the interface of a capability.
+ */
+export declare const defineCapability: <T>(identifier: string) => InterfaceDef<T>;
+/**
+ * Functionality contributed to the application by a plugin module.
+ */
+export type Capability<T> = {
+    /**
+     * The interface definition of the capability.
+     */
+    interface: InterfaceDef<T>;
+    /**
+     * The implementation of the capability.
+     */
+    implementation: T;
+    /**
+     * Called when the capability is deactivated.
+     */
+    deactivate?: () => MaybePromise<void> | Effect.Effect<void, Error>;
+};
+export type AnyCapability = Capability<any>;
+type PluginsContextOptions = {
+    activate: (event: ActivationEvent) => MaybePromise<boolean>;
+    reset: (event: ActivationEvent) => MaybePromise<boolean>;
+};
+/**
+ * Helper to define the implementation of a capability.
+ */
+export declare const contributes: <T>(interfaceDef: Capability<T>["interface"], implementation: Capability<T>["implementation"], deactivate?: Capability<T>["deactivate"]) => Capability<T>;
+type LoadCapability<T, U> = () => Promise<{
+    default: (props: T) => MaybePromise<Capability<U>>;
+}>;
+type LoadCapabilities<T> = () => Promise<{
+    default: (props: T) => MaybePromise<AnyCapability[]>;
+}>;
+type LazyCapability<T, U> = (props?: T) => Promise<() => Promise<Capability<U> | AnyCapability[]>>;
+/**
+ * Helper to define a lazily loaded implementation of a capability.
+ */
+export declare const lazy: <T, U>(c: LoadCapability<T, U> | LoadCapabilities<T>) => LazyCapability<T, U>;
+/**
+ * Context which is passed to plugins, allowing them to interact with each other.
+ */
+export declare class PluginsContext {
+    private readonly _definedCapabilities;
+    /**
+     * Activates plugins based on the activation event.
+     * @param event The activation event.
+     * @returns Whether the activation was successful.
+     */
+    readonly activate: PluginsContextOptions['activate'];
+    /**
+     * Re-activates the modules that were activated by the event.
+     * @param event The activation event.
+     * @returns Whether the reset was successful.
+     */
+    readonly reset: PluginsContextOptions['reset'];
+    constructor({ activate, reset }: PluginsContextOptions);
+    /**
+     * Requests capabilities from the plugin context.
+     * @returns An array of capabilities.
+     * @reactive
+     */
+    requestCapabilities<T, U extends T = T>(interfaceDef: InterfaceDef<T>, filter?: (capability: T, moduleId: string) => capability is U): U[];
+    /**
+     * Requests a single capability from the plugin context.
+     * @returns The capability.
+     * @throws If no capability is found.
+     * @reactive
+     */
+    requestCapability<T, U extends T = T>(interfaceDef: InterfaceDef<T>, filter?: (capability: T, moduleId: string) => capability is U): U;
+    /**
+     * Waits for a capability to be contributed.
+     * @returns The capability.
+     */
+    waitForCapability<T, U extends T = T>(interfaceDef: InterfaceDef<T>, filter?: (capability: T) => capability is U): Promise<U>;
+}
+export {};
+//# sourceMappingURL=capabilities.d.ts.map

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

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

package/dist/types/src/core/capabilities.test.d.ts

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

package/dist/types/src/core/capabilities.test.d.ts.map

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

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

@@ -0,0 +1,58 @@
+/**
+ * An event which activates a plugin module.
+ */
+export type ActivationEvent = {
+    id: string;
+    specifier?: string;
+};
+/**
+ * An activation event that can be a single event, or a combination of events.
+ */
+export type ActivationEvents = ActivationEvent | {
+    type: 'one-of';
+    events: ActivationEvent[];
+} | {
+    type: 'all-of';
+    events: ActivationEvent[];
+};
+/**
+ * Helper to define an activation event.
+ */
+export declare const defineEvent: (id: string, specifier?: string) => ActivationEvent;
+/**
+ * Helper to create an activation event key.
+ */
+export declare const eventKey: (event: ActivationEvent) => string;
+/**
+ * Helper to create an activation event that triggers when any of the given events are activated.
+ */
+export declare const oneOf: (...events: ActivationEvent[]) => {
+    type: "one-of";
+    events: ActivationEvent[];
+};
+/**
+ * Helper to create an activation event that triggers when all of the given events are activated.
+ */
+export declare const allOf: (...events: ActivationEvent[]) => {
+    type: "all-of";
+    events: ActivationEvent[];
+};
+/**
+ * Helper to check if an activation event is a one-of event.
+ */
+export declare const isOneOf: (events: ActivationEvents) => 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 {
+    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

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/core/events.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,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,WAAW,OAAQ,MAAM,cAAc,MAAM,KAC5B,eAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,UAAW,eAAe,WAAoE,CAAC;AAEpH;;GAEG;AACH,eAAO,MAAM,KAAK,cAAe,eAAe,EAAE;;;CAA0C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,KAAK,cAAe,eAAe,EAAE;;;CAA0C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,OAAO,WAAY,gBAAgB,KAAG,MAAM,IAAI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1D,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,OAAO,WAAY,gBAAgB,KAAG,MAAM,IAAI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1D,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,SAAS,WAAY,gBAAgB,sBAAkD,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './capabilities';
+export * from './events';
+export * from './manager';
+export * from './plugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,119 @@
+import { Event } from '@dxos/async';
+import { type ReactiveObject } from '@dxos/live-object';
+import { type MaybePromise } from '@dxos/util';
+import { PluginsContext } from './capabilities';
+import { type ActivationEvent } from './events';
+import { type PluginModule, type Plugin } from './plugin';
+export type PluginManagerOptions = {
+    pluginLoader: (id: string) => MaybePromise<Plugin>;
+    plugins?: Plugin[];
+    core?: string[];
+    enabled?: string[];
+};
+export declare class PluginManager {
+    readonly activation: Event<{
+        event: string;
+        state: "activating" | "activated" | "error";
+        error?: any;
+    }>;
+    readonly context: PluginsContext;
+    private readonly _state;
+    private readonly _pluginLoader;
+    private readonly _capabilities;
+    constructor({ pluginLoader, plugins, core, enabled, }: PluginManagerOptions);
+    /**
+     * Plugins that are currently registered.
+     *
+     * @reactive
+     */
+    get plugins(): ReactiveObject<readonly Plugin[]>;
+    /**
+     * Ids of plugins that are core and cannot be removed.
+     *
+     * @reactive
+     */
+    get core(): ReactiveObject<readonly string[]>;
+    /**
+     * Ids of plugins that are currently enabled.
+     *
+     * @reactive
+     */
+    get enabled(): ReactiveObject<readonly string[]>;
+    /**
+     * Modules of plugins which are currently enabled.
+     *
+     * @reactive
+     */
+    get modules(): ReactiveObject<readonly PluginModule[]>;
+    /**
+     * Ids of modules which are currently active.
+     *
+     * @reactive
+     */
+    get active(): ReactiveObject<readonly string[]>;
+    /**
+     * Ids of events which have been fired.
+     *
+     * @reactive
+     */
+    get eventsFired(): ReactiveObject<readonly string[]>;
+    /**
+     * Ids of modules which are pending reset.
+     *
+     * @reactive
+     */
+    get pendingReset(): ReactiveObject<readonly string[]>;
+    /**
+     * Adds a plugin to the manager via the plugin loader.
+     * @param id The id of the plugin.
+     */
+    add(id: string): Promise<boolean>;
+    /**
+     * Enables a plugin.
+     * @param id The id of the plugin.
+     */
+    enable(id: string): Promise<boolean>;
+    /**
+     * Removes a plugin from the manager.
+     * @param id The id of the plugin.
+     */
+    remove(id: string): boolean;
+    /**
+     * Disables a plugin.
+     * @param id The id of the plugin.
+     */
+    disable(id: string): Promise<boolean>;
+    /**
+     * Activates plugins based on the activation event.
+     * @param event The activation event.
+     * @returns Whether the activation was successful.
+     */
+    activate(event: ActivationEvent | string): Promise<boolean>;
+    /**
+     * Deactivates all of the modules for a plugin.
+     * @param id The id of the plugin.
+     * @returns Whether the deactivation was successful.
+     */
+    deactivate(id: string): Promise<boolean>;
+    /**
+     * Re-activates the modules that were activated by the event.
+     * @param event The activation event.
+     * @returns Whether the reset was successful.
+     */
+    reset(event: ActivationEvent | string): Promise<boolean>;
+    private _addPlugin;
+    private _removePlugin;
+    private _addModule;
+    private _removeModule;
+    private _getPlugin;
+    private _getActiveModules;
+    private _getInactiveModules;
+    private _getActiveModulesByEvent;
+    private _getInactiveModulesByEvent;
+    private _setPendingResetByModule;
+    private _activateModule;
+    private _deactivate;
+    private _deactivateModule;
+    private _reset;
+}
+//# sourceMappingURL=manager.d.ts.map

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

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

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

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

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

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