@dxos/app-framework 0.7.5-main.9cb18ac → 0.7.5-main.9d2a38b

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

@@ -0,0 +1,90 @@
+/**
+ * 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 LazyCapability<T, U> = () => Promise<{
+    default: (props: T) => MaybePromise<Capability<U>>;
+}>;
+/**
+ * Helper to define a lazily loaded implementation of a capability.
+ */
+export declare const lazy: <T, U>(c: LazyCapability<T, U>) => (props?: T) => Promise<Capability<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":"AAAA;;GAEG;AAMH,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMrC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,QAAA,MAAM,kBAAkB,EAAE,OAAO,MAAyC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,cAAc,MAAM,KAC3B,YAAY,CAAC,CAAC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B;;OAEG;IACH,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE3B;;OAEG;IACH,cAAc,EAAE,CAAC,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;AAE5C,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC1D,CAAC;AAUF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,gBACb,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBACxB,UAAU,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAClC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KACvC,UAAU,CAAC,CAAC,CAEd,CAAC;AAEF,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,IAAI,GACd,CAAC,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,cACrB,CAAC,KAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAG9B,CAAC;AAEP;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAgD;IAErF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAErD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBAEnC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,qBAAqB;IA4CtD;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EACpC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,GAC5D,CAAC,EAAE;IAaN;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAClC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,GAC5D,CAAC;IAMJ;;;OAGG;IACG,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EACxC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,KAAK,UAAU,IAAI,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC;CAYd"}

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,126 @@
+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 modules which are pending removal.
+     *
+     * @reactive
+     */
+    get pendingRemoval(): 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): 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): 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 _activate;
+    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":""}

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

@@ -0,0 +1,94 @@
+import { type Effect } from 'effect';
+import { type MaybePromise } from '@dxos/util';
+import { type AnyCapability, type PluginsContext } from './capabilities';
+import { type ActivationEvent, type ActivationEvents } from './events';
+interface PluginModuleInterface {
+    /**
+     * Unique id of the module.
+     */
+    id: string;
+    /**
+     * Events for which the module will be activated.
+     */
+    activatesOn: ActivationEvents;
+    /**
+     * Events which the plugin depends on being activated.
+     * Plugin is marked as needing reset a plugin activated by a dependent event is removed.
+     * Events are automatically activated before activation of the plugin.
+     */
+    activatesBefore?: ActivationEvent[];
+    /**
+     * Events which this plugin triggers upon activation.
+     */
+    activatesAfter?: ActivationEvent[];
+    /**
+     * Called when the module is activated.
+     * @param context The plugin context.
+     * @returns The capabilities of the module.
+     */
+    activate: (context: PluginsContext) => MaybePromise<AnyCapability | AnyCapability[]> | Effect.Effect<AnyCapability | AnyCapability[], Error>;
+}
+/**
+ * A unit of containment of modular functionality that can be provided to an application.
+ * Plugins provide things like components, state, actions, etc. to the application.
+ */
+export declare class PluginModule implements PluginModuleInterface {
+    readonly id: PluginModuleInterface['id'];
+    readonly activatesOn: PluginModuleInterface['activatesOn'];
+    readonly activatesBefore?: PluginModuleInterface['activatesBefore'];
+    readonly activatesAfter?: PluginModuleInterface['activatesAfter'];
+    readonly activate: PluginModuleInterface['activate'];
+    constructor(options: PluginModuleInterface);
+}
+/**
+ * Helper to define a module.
+ */
+export declare const defineModule: (options: PluginModuleInterface) => PluginModule;
+export type PluginMeta = {
+    /**
+     * Globally unique ID.
+     *
+     * Expected to be in the form of a valid URL.
+     *
+     * @example dxos.org/plugin/example
+     */
+    id: string;
+    /**
+     * Human-readable name.
+     */
+    name?: string;
+    /**
+     * Short description of plugin functionality.
+     */
+    description?: string;
+    /**
+     * URL of home page.
+     */
+    homePage?: string;
+    /**
+     * URL of source code.
+     */
+    source?: string;
+    /**
+     * Tags to help categorize the plugin.
+     */
+    tags?: string[];
+    /**
+     * A grep-able symbol string which can be resolved to an icon asset by @ch-ui/icons, via @ch-ui/vite-plugin-icons.
+     */
+    icon?: string;
+};
+/**
+ * A collection of modules that are be enabled/disabled as a unit.
+ */
+export declare class Plugin {
+    readonly meta: PluginMeta;
+    readonly modules: PluginModule[];
+    constructor(meta: PluginMeta, modules: PluginModule[]);
+}
+/**
+ * Helper to define a plugin.
+ */
+export declare const definePlugin: (meta: PluginMeta, modules: PluginModule[]) => Plugin;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEvE,UAAU,qBAAqB;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAE9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,EAAE,CACR,OAAO,EAAE,cAAc,KACpB,YAAY,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,aAAa,EAAE,EAAE,KAAK,CAAC,CAAC;CAC5G;AAED;;;GAGG;AAEH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAC3D,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;gBAEzC,OAAO,EAAE,qBAAqB;CAO3C;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,YAAa,qBAAqB,iBAA8B,CAAC;AAE1F,MAAM,MAAM,UAAU,GAAG;IACvB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AAEH,qBAAa,MAAM;IAEf,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE;gBADvB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,YAAY,EAAE;CAEnC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,SAAU,UAAU,WAAW,YAAY,EAAE,WAErE,CAAC"}

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

@@ -0,0 +1,10 @@
+type DependencyNode = {
+    id: string;
+    dependsOn?: string[];
+};
+/**
+ * Topologically sorts a list of nodes based on their dependencies.
+ */
+export declare const topologicalSort: <T extends DependencyNode>(nodes: T[]) => T[];
+export {};
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers.ts"],"names":[],"mappings":"AAIA,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,cAAc,SAAS,CAAC,EAAE,KAAG,CAAC,EA+BvE,CAAC"}

package/dist/types/src/helpers.test.d.ts

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

package/dist/types/src/helpers.test.d.ts.map

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

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

@@ -1,3 +1,7 @@
-export * from './plugins';
 export * from './App';
+export * from './common';
+export * from './core';
+export * from './plugin-intent';
+export * from './plugin-settings';
+export * from './react';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAE1B,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/types/src/playground/debug/Debug.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { Capabilities } from '../../common';
+export declare const Debug: () => React.JSX.Element;
+declare const _default: () => import("../../core").Capability<Capabilities.ReactSurface>;
+export default _default;
+//# sourceMappingURL=Debug.d.ts.map

package/dist/types/src/playground/debug/Debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../../../../src/playground/debug/Debug.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AAI3D,eAAO,MAAM,KAAK,yBAgBjB,CAAC;;AAEF,wBAQI"}

package/dist/types/src/playground/debug/index.d.ts

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

package/dist/types/src/playground/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/playground/debug/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC"}

package/dist/types/src/playground/debug/plugin.d.ts

@@ -0,0 +1,2 @@
+export declare const DebugPlugin: () => import("../../core").Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/playground/debug/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/playground/debug/plugin.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,mCAOpB,CAAC"}

package/dist/types/src/playground/generator/Main.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { Capabilities } from '../../common';
+export declare const Main: () => React.JSX.Element;
+declare const _default: () => import("../../core").Capability<Capabilities.ReactSurface>;
+export default _default;
+//# sourceMappingURL=Main.d.ts.map

package/dist/types/src/playground/generator/Main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Main.d.ts","sourceRoot":"","sources":["../../../../../src/playground/generator/Main.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAI3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiC5C,eAAO,MAAM,IAAI,yBAsBhB,CAAC;;AAEF,wBAKK"}

package/dist/types/src/playground/generator/Toolbar.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { Capabilities } from '../../common';
+export declare const Toolbar: () => React.JSX.Element;
+declare const _default: () => import("../../core").Capability<Capabilities.ReactSurface>;
+export default _default;
+//# sourceMappingURL=Toolbar.d.ts.map

package/dist/types/src/playground/generator/Toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../../../src/playground/generator/Toolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAK3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,eAAO,MAAM,OAAO,yBAyBnB,CAAC;;AAEF,wBAKK"}

package/dist/types/src/playground/generator/generator.d.ts

@@ -0,0 +1,5 @@
+export declare const Number: import("../../core").InterfaceDef<number>;
+export declare const CountEvent: import("../../core").ActivationEvent;
+export declare const createPluginId: (id: string) => string;
+export declare const createNumberPlugin: (id: string) => import("../../core").Plugin;
+//# sourceMappingURL=generator.d.ts.map

package/dist/types/src/playground/generator/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../src/playground/generator/generator.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,MAAM,2CAA6D,CAAC;AAEjF,eAAO,MAAM,UAAU,sCAA+C,CAAC;AAEvE,eAAO,MAAM,cAAc,OAAQ,MAAM,WAAoC,CAAC;AAE9E,eAAO,MAAM,kBAAkB,OAAQ,MAAM,gCAU5C,CAAC"}

package/dist/types/src/playground/generator/index.d.ts

@@ -0,0 +1,3 @@
+export * from './plugin';
+export * from './generator';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/playground/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/playground/generator/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/types/src/playground/generator/plugin.d.ts

@@ -0,0 +1,2 @@
+export declare const GeneratorPlugin: () => import("../../core").Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/playground/generator/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/playground/generator/plugin.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe,mCAOxB,CAAC"}

package/dist/types/src/playground/layout/Layout.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export declare const Layout: () => React.JSX.Element;
+declare const _default: () => import("../../core").Capability<Readonly<{
+    id: string;
+    root: React.FC<React.PropsWithChildren>;
+}>>;
+export default _default;
+//# sourceMappingURL=Layout.d.ts.map

package/dist/types/src/playground/layout/Layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../../../src/playground/layout/Layout.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,eAAO,MAAM,MAAM,yBAgBlB,CAAC;;;;;AAEF,wBAIK"}

package/dist/types/src/playground/layout/index.d.ts

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

package/dist/types/src/playground/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/playground/layout/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC"}

package/dist/types/src/playground/layout/plugin.d.ts

@@ -0,0 +1,2 @@
+export declare const LayoutPlugin: () => import("../../core").Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/playground/layout/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/playground/layout/plugin.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,YAAY,mCAOrB,CAAC"}

package/dist/types/src/playground/logger/Toolbar.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { Capabilities } from '../../common';
+export declare const Logger: () => React.JSX.Element;
+declare const _default: () => import("../../core").Capability<Capabilities.ReactSurface>;
+export default _default;
+//# sourceMappingURL=Toolbar.d.ts.map

package/dist/types/src/playground/logger/Toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../../../src/playground/logger/Toolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAK3C,OAAO,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AAI3D,eAAO,MAAM,MAAM,yBAIlB,CAAC;;AAEF,wBAQI"}

package/dist/types/src/playground/logger/index.d.ts

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

package/dist/types/src/playground/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/playground/logger/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC"}

package/dist/types/src/playground/logger/plugin.d.ts

@@ -0,0 +1,2 @@
+export declare const LoggerPlugin: () => import("../../core").Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/playground/logger/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/playground/logger/plugin.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,YAAY,mCAmBrB,CAAC"}

package/dist/types/src/playground/logger/schema.d.ts

@@ -0,0 +1,13 @@
+import { S } from '@dxos/echo-schema';
+declare const Log_base: S.TaggedClass<Log, "dxos.org/test/logger/log", {
+    readonly _tag: S.tag<"dxos.org/test/logger/log">;
+} & {
+    input: S.Struct<{
+        message: typeof S.String;
+    }>;
+    output: typeof S.Void;
+}>;
+export declare class Log extends Log_base {
+}
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/src/playground/logger/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/playground/logger/schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;;AAEtC,qBAAa,GAAI,SAAQ,QAKvB;CAAG"}

package/dist/types/src/playground/playground.stories.d.ts

@@ -0,0 +1,10 @@
+import '@dxos-theme';
+import React from 'react';
+export declare const Playground: {};
+declare const _default: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react/*").Decorator[];
+};
+export default _default;
+//# sourceMappingURL=playground.stories.d.ts.map

package/dist/types/src/playground/playground.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.stories.d.ts","sourceRoot":"","sources":["../../../../src/playground/playground.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,MAAM,OAAO,CAAC;AAqB1B,eAAO,MAAM,UAAU,IAAK,CAAC;;;;;;AAE7B,wBAIE"}

package/dist/types/src/{plugins/plugin-intent → plugin-intent}/IntentContext.d.ts

@@ -2,7 +2,7 @@ import { type Context, type Provider } from 'react';
 import { type AnyIntentResolver, type IntentContext } from './intent-dispatcher';
 declare const IntentContext: Context<IntentContext | undefined>;
 export declare const useIntentDispatcher: () => Pick<IntentContext, "dispatch" | "dispatchPromise">;
-export declare const useIntentResolver: (pluginId: string, resolver: AnyIntentResolver) => void;
+export declare const useIntentResolver: (module: string, resolver: AnyIntentResolver) => void;
 export declare const IntentProvider: Provider<IntentContext | undefined>;
 export {};
 //# sourceMappingURL=IntentContext.d.ts.map