@dxos/app-framework 0.3.3-main.082f8b3

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

@@ -0,0 +1,19 @@
+import { type BootstrapPluginsParams } from './plugins';
+/**
+ * Expected usage is for this to be the entrypoint of the application.
+ * Initializes plugins and renders the root components.
+ *
+ * @example
+ * const fallback = <div>Initializing Plugins...</div>;
+ * const App = createApp({ plugins, fallback });
+ * createRoot(document.getElementById('root')!).render(
+ *   <StrictMode>
+ *     <App />
+ *   </StrictMode>,
+ * );
+ *
+ * @param params.plugins List of plugin definitions to initialize.
+ * @param params.fallback Fallback component to render while plugins are initializing.
+ */
+export declare const createApp: ({ plugins, fallback }: BootstrapPluginsParams) => () => JSX.Element;
+//# sourceMappingURL=App.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/App.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,sBAAsB,EAA2C,MAAM,WAAW,CAAC;AAEjG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,0BAA2B,sBAAsB,sBAgBtE,CAAC"}

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

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

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

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

package/dist/types/src/plugins/IntentPlugin/IntentContext.d.ts

@@ -0,0 +1,8 @@
+import { type Provider } from 'react';
+import { type DispatchIntent } from './intent';
+export type IntentContext = {
+    dispatch: DispatchIntent;
+};
+export declare const useIntent: () => IntentContext;
+export declare const IntentProvider: Provider<IntentContext>;
+//# sourceMappingURL=IntentContext.d.ts.map

package/dist/types/src/plugins/IntentPlugin/IntentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE/E,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAIF,eAAO,MAAM,SAAS,qBAAkC,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAA0B,CAAC"}

package/dist/types/src/plugins/IntentPlugin/IntentPlugin.d.ts

@@ -0,0 +1,19 @@
+import { type IntentContext } from './IntentContext';
+import { type Intent } from './intent';
+import { type PluginDefinition, type Plugin } from '../PluginHost';
+export type IntentResolverProvides = {
+    intent: {
+        resolver: (intent: Intent, plugins: Plugin[]) => any;
+    };
+};
+export type IntentPluginProvides = {
+    intent: IntentContext;
+};
+export declare const parseIntentPlugin: (plugin: Plugin) => Plugin<IntentPluginProvides> | undefined;
+export declare const parseIntentResolverPlugin: (plugin: Plugin) => Plugin<IntentResolverProvides> | undefined;
+/**
+ * Allows plugins to register intent handlers and routes sent intents to the appropriate plugin.
+ * Inspired by https://developer.android.com/reference/android/content/Intent.
+ */
+export declare const IntentPlugin: () => PluginDefinition<IntentPluginProvides>;
+//# sourceMappingURL=IntentPlugin.d.ts.map

package/dist/types/src/plugins/IntentPlugin/IntentPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/IntentPlugin.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGnE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC;KACtD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,6CACkD,CAAC;AAEnG,eAAO,MAAM,yBAAyB,WAAY,MAAM,+CAC4C,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,iBAAiB,oBAAoB,CAoCpE,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './intent';
+export * from './IntentContext';
+export * from './IntentPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/types/src/plugins/IntentPlugin/intent.d.ts

@@ -0,0 +1,28 @@
+/**
+ * An intent is an abstract description of an operation to be performed.
+ * Intents allow actions to be performed across plugins.
+ */
+export type Intent = {
+    /**
+     * Plugin ID.
+     * If specified, the intent will be sent explicitly to the plugin.
+     * Otherwise, the intent will be sent to all plugins, in order and the first to resolve a non-null value will be used.
+     */
+    plugin?: string;
+    /**
+     * The action to perform.
+     */
+    action: string;
+    /**
+     * Any data needed to perform the desired action.
+     */
+    data?: any;
+};
+/**
+ * Trigger one or more intents to be sent.
+ * If multiple intents are specified, the result of each will be merged with the data to the next.
+ *
+ * @returns The result of the last intent.
+ */
+export type DispatchIntent = (intent: Intent | Intent[]) => Promise<any>;
+//# sourceMappingURL=intent.d.ts.map

package/dist/types/src/plugins/IntentPlugin/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/IntentPlugin/intent.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC"}

package/dist/types/src/plugins/PluginHost/PluginContext.d.ts

@@ -0,0 +1,24 @@
+import { type Context, type Provider } from 'react';
+import { type Plugin, type PluginDefinition } from './plugin';
+export type PluginContext = {
+    ready: boolean;
+    initializing: PluginDefinition[];
+    loading: PluginDefinition[];
+    plugins: Plugin[];
+};
+declare const PluginContext: Context<PluginContext>;
+/**
+ * Get all plugins.
+ */
+export declare const usePlugins: () => PluginContext;
+/**
+ * Get a plugin by ID.
+ */
+export declare const usePlugin: <T>(id: string) => Plugin<T> | undefined;
+/**
+ * Resolve a plugin by predicate.
+ */
+export declare const useResolvePlugin: <T>(predicate: (plugin: Plugin) => Plugin<T> | undefined) => Plugin<T> | undefined;
+export declare const PluginProvider: Provider<PluginContext>;
+export {};
+//# sourceMappingURL=PluginContext.d.ts.map

package/dist/types/src/plugins/PluginHost/PluginContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/PluginContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,OAAO,CAAC;AAE/E,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG9D,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAAa,CAKxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,QAAO,aAA0C,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,SAAS,UAAY,MAAM,0BAGvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,0BAA4B,MAAM,oDAG9D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAA0B,CAAC"}

package/dist/types/src/plugins/PluginHost/PluginHost.d.ts

@@ -0,0 +1,20 @@
+import { type FC, type ReactNode } from 'react';
+import { type PluginContext } from './PluginContext';
+import { type Plugin, type PluginDefinition } from './plugin';
+export type BootstrapPluginsParams = {
+    plugins: PluginDefinition[];
+    fallback?: ReactNode | FC<Omit<PluginContext, 'ready'>>;
+};
+export type PluginHostProvides = {
+    plugins: PluginContext;
+};
+export declare const parsePluginHost: (plugin: Plugin) => Plugin<PluginHostProvides> | undefined;
+/**
+ * Bootstraps an application by initializing plugins and rendering root components.
+ */
+export declare const PluginHost: ({ plugins: definitions, fallback, }: BootstrapPluginsParams) => PluginDefinition<PluginHostProvides>;
+/**
+ * Resolve a `PluginDefinition` into a fully initialized `Plugin`.
+ */
+export declare const initializePlugin: <T, U>(pluginDefinition: PluginDefinition<T, U>) => Promise<Plugin<T & U>>;
+//# sourceMappingURL=PluginHost.d.ts.map

package/dist/types/src/plugins/PluginHost/PluginHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHost.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/PluginHost.tsx"],"names":[],"mappings":"AAKA,OAAc,EAAa,KAAK,EAAE,EAA0B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI1F,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAuB,MAAM,UAAU,CAAC;AAEnF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,eAAe,WAAY,MAAM,2CACwD,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,UAAU,wCAGpB,sBAAsB,KAAG,iBAAiB,kBAAkB,CA+D9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,4EAS5B,CAAC"}

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

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

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

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

package/dist/types/src/plugins/PluginHost/plugin.d.ts

@@ -0,0 +1,66 @@
+import { type FC, type PropsWithChildren } from 'react';
+/**
+ * Capabilities provided by a plugin.
+ * The base surface capabilities are always included.
+ */
+export type PluginProvides<TProvides> = TProvides & {
+    /**
+     * React Context which is wrapped around the application to enable any hooks the plugin may provide.
+     */
+    context?: FC<PropsWithChildren>;
+    root?: FC<PropsWithChildren>;
+};
+/**
+ * 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 type Plugin<TProvides = {}> = {
+    meta: {
+        /**
+         * Globally unique ID.
+         *
+         * Expected to be in the form of a valid URL.
+         *
+         * @example dxos.org/plugin/example
+         */
+        id: string;
+        /**
+         * Short ID for use in URLs.
+         *
+         * NOTE: This is especially experimental and likely to change.
+         */
+        shortId?: string;
+    };
+    /**
+     * Capabilities provided by the plugin.
+     */
+    provides: PluginProvides<TProvides>;
+};
+/**
+ * Plugin definitions extend the base `Plugin` interface with additional lifecycle methods.
+ */
+export type PluginDefinition<TProvides = {}, TInitializeProvides = {}> = Omit<Plugin, 'provides'> & {
+    /**
+     * Capabilities provided by the plugin.
+     */
+    provides?: Plugin<TProvides>['provides'];
+    /**
+     * Initialize any async behavior required by the plugin.
+     *
+     * @return Capabilities provided by the plugin which are merged with base capabilities.
+     */
+    initialize?: () => Promise<PluginProvides<TInitializeProvides>>;
+    /**
+     * Called once all plugins have been initialized.
+     * This is the place to do any initialization which requires other plugins to be ready.
+     *
+     * @param plugins All plugins which successfully initialized.
+     */
+    ready?: (plugins: Plugin[]) => Promise<void>;
+    /**
+     * Called when the plugin is unloaded.
+     * This is the place to do any cleanup required by the plugin.
+     */
+    unload?: () => Promise<void>;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/plugins/PluginHost/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,IAAI,SAAS,GAAG;IAClD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAKhC,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,SAAS,GAAG,EAAE,IAAI;IACnC,IAAI,EAAE;QACJ;;;;;;WAMG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;WAIG;QAEH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,GAAG,EAAE,EAAE,mBAAmB,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAClG;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC"}

package/dist/types/src/plugins/PluginHost/plugin.test.d.ts

@@ -0,0 +1,35 @@
+import { type FC } from 'react';
+export interface Interface<T> {
+    key: string;
+}
+type InterfaceDef<T> = {
+    key: Interface<T>;
+    impl: T;
+};
+export declare const provide: <T>(key: Interface<T>, impl: T) => InterfaceDef<T>;
+export type PluginProps = {
+    provides?: InterfaceDef<any>[];
+};
+export declare class TestPlugin {
+    readonly _interfaces: Map<string, any>;
+    constructor({ provides }: PluginProps);
+    getInterface: <T>(key: Interface<T>) => T | undefined;
+}
+export interface Printable {
+    print: (data: any | undefined) => void;
+}
+export declare const Printable: Interface<Printable>;
+export interface Selectable {
+    selection: () => string | undefined;
+    select: (object?: {
+        id: string | undefined;
+    }) => void;
+}
+export declare const Selectable: Interface<Selectable>;
+export type Section = FC<{
+    object: any;
+    onSelect: (object: string | undefined) => void;
+}>;
+export declare const Section: Interface<Section>;
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/types/src/plugins/PluginHost/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/PluginHost/plugin.test.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,OAAO,oDAAsE,CAAC;AAE3F,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;CAChC,CAAC;AAEF,qBAAa,UAAU;IACrB,QAAQ,CAAC,WAAW,mBAA0B;gBAClC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAIrC,YAAY,0CAA0E;CACvF;AAYD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,SAAS,CAAwB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC,UAAU,CAAyB,CAAC;AAGvE,MAAM,MAAM,OAAO,GAAG,EAAE,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;CAAE,CAAC,CAAC;AAE1F,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,CAAmB,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/ErrorBoundary.d.ts

@@ -0,0 +1,30 @@
+import React, { Component, type FC, type PropsWithChildren } from 'react';
+type Props = PropsWithChildren<{
+    data?: any;
+    fallback: FC<{
+        error: Error;
+        reset: () => void;
+    }>;
+}>;
+type State = {
+    error: Error | undefined;
+};
+/**
+ * Surface error boundary.
+ *
+ * For basic usage prefer providing a fallback component to `Surface`.
+ *
+ * For more information on error boundaries, see:
+ * https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
+ */
+export declare class ErrorBoundary extends Component<Props, State> {
+    constructor(props: Props);
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    componentDidUpdate(prevProps: Props): void;
+    render(): string | number | boolean | React.ReactFragment | JSX.Element | null | undefined;
+    private resetError;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/ErrorBoundary.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE1E,KAAK,KAAK,GAAG,iBAAiB,CAAC;IAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,EAAE,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAClG,KAAK,KAAK,GAAG;IAAE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC5C,KAAK,EAAE,KAAK;IAKxB,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK;;;IAInC,kBAAkB,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI;IAM1C,MAAM;IAQf,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/src/plugins/SurfacePlugin/Surface.d.ts

@@ -0,0 +1,45 @@
+import { ErrorBoundary } from './ErrorBoundary';
+/**
+ * Direction determines how multiple components are laid out.
+ */
+export type Direction = 'inline' | 'inline-reverse' | 'block' | 'block-reverse';
+export type SurfaceProps = {
+    /**
+     * Role defines how the data should be rendered.
+     */
+    role?: string;
+    /**
+     * Names allow nested surfaces to be specified in the parent context, similar to a slot.
+     *
+     * Defaults to the value of `role` if not specified.
+     */
+    name?: string;
+    /**
+     * The data to be rendered by the surface.
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Configure nested surfaces.
+     */
+    surfaces?: Record<string, Pick<SurfaceProps, 'data' | 'surfaces'>>;
+    /**
+     * If specified, the Surface will be wrapped in an error boundary.
+     * The fallback component will be rendered if an error occurs.
+     */
+    fallback?: ErrorBoundary['props']['fallback'];
+    /**
+     * If more than one component is resolved, the limit determines how many are rendered.
+     */
+    limit?: number | undefined;
+    /**
+     * If more than one component is resolved, the direction determines how they are laid out.
+     *
+     * NOTE: This is not yet implemented.
+     */
+    direction?: Direction;
+};
+/**
+ * A surface is a named region of the screen that can be populated by plugins.
+ */
+export declare const Surface: ({ role, name, fallback, ...rest }: SurfaceProps) => JSX.Element;
+//# sourceMappingURL=Surface.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/Surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/Surface.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,GAAG,eAAe,CAAC;AAEhF,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,sCAA8C,YAAY,gBAgB7E,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/SurfacePlugin.d.ts

@@ -0,0 +1,20 @@
+import { type SurfaceComponent, type SurfaceRootContext } from './SurfaceRootContext';
+import type { Plugin, PluginDefinition } from '../PluginHost';
+export type SurfaceProvides = {
+    surface: {
+        /**
+         * Used by the `Surface` resolver to find a component to render.
+         */
+        component: SurfaceComponent;
+    };
+};
+export type SurfacePluginProvides = {
+    surface: SurfaceRootContext;
+};
+export declare const parseRootSurfacePlugin: (plugin?: Plugin) => Plugin<SurfacePluginProvides> | undefined;
+export declare const parseSurfacePlugin: (plugin?: Plugin) => Plugin<SurfaceProvides> | undefined;
+/**
+ * Provides a registry of surface components.
+ */
+export declare const SurfacePlugin: () => PluginDefinition<SurfacePluginProvides>;
+//# sourceMappingURL=SurfacePlugin.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/SurfacePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfacePlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/SurfacePlugin.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,gBAAgB,EAAmB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE;QACP;;WAEG;QACH,SAAS,EAAE,gBAAgB,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,YAAa,MAAM,8CACkD,CAAC;AAEzG,eAAO,MAAM,kBAAkB,YAAa,MAAM,wCAC+C,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,iBAAiB,qBAAqB,CAmBtE,CAAC"}

package/dist/types/src/plugins/SurfacePlugin/SurfaceRootContext.d.ts

@@ -0,0 +1,13 @@
+import { type Provider, type ReactNode } from 'react';
+/**
+ * Function which resolves a Surface.
+ *
+ * If a null value is returned, the rendering is deferred to other plugins.
+ */
+export type SurfaceComponent = (data: Record<string, unknown>, role?: string) => ReactNode;
+export type SurfaceRootContext = {
+    components: Record<string, SurfaceComponent>;
+};
+export declare const useSurface: () => SurfaceRootContext;
+export declare const SurfaceProvider: Provider<SurfaceRootContext>;
+//# sourceMappingURL=SurfaceRootContext.d.ts.map

package/dist/types/src/plugins/SurfacePlugin/SurfaceRootContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceRootContext.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/SurfaceRootContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA2C,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC;AAE3F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAIF,eAAO,MAAM,UAAU,0BAAuC,CAAC;AAE/D,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,kBAAkB,CAA+B,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './ErrorBoundary';
+export * from './Surface';
+export * from './SurfacePlugin';
+export * from './SurfaceRootContext';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/SurfacePlugin/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/types/src/plugins/common/graph.d.ts

@@ -0,0 +1,26 @@
+import type { Graph, Node } from '@dxos/app-graph';
+import type { UnsubscribeCallback } from '@dxos/async';
+import type { Plugin } from '../PluginHost';
+/**
+ * Provides for a plugin that exposes the application graph.
+ */
+export type GraphPluginProvides = {
+    graph: Graph;
+};
+export type GraphBuilderProvides = {
+    graph: {
+        builder: (params: {
+            parent: Node;
+            plugins: Plugin[];
+        }) => UnsubscribeCallback | void;
+    };
+};
+/**
+ * Type guard for graph plugins.
+ */
+export declare const parseGraphPlugin: (plugin: Plugin) => Plugin<GraphPluginProvides> | undefined;
+/**
+ * Type guard for graph builder plugins.
+ */
+export declare const parseGraphBuilderPlugin: (plugin: Plugin) => Plugin<GraphBuilderProvides> | undefined;
+//# sourceMappingURL=graph.d.ts.map

package/dist/types/src/plugins/common/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/graph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE;QACL,OAAO,EAAE,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,IAAI,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,KAAK,mBAAmB,GAAG,IAAI,CAAC;KACtF,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,WAAY,MAAM,4CAC6C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,uBAAuB,WAAY,MAAM,6CAC0C,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './graph';
+export * from './layout';
+export * from './translations';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import type { Plugin } from '../PluginHost';
+/**
+ * Basic state provided by a layout plugin.
+ */
+export declare const Layout: z.ZodObject<{
+    fullscreen: z.ZodBoolean;
+    sidebarOpen: z.ZodBoolean;
+    complementarySidebarOpen: z.ZodBoolean;
+    dialogContent: z.ZodOptional<z.ZodAny>;
+    dialogOpen: z.ZodBoolean;
+    popoverAnchorId: z.ZodOptional<z.ZodString>;
+    popoverContent: z.ZodOptional<z.ZodAny>;
+    popoverOpen: z.ZodBoolean;
+    active: z.ZodOptional<z.ZodString>;
+    previous: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    dialogContent?: any;
+    popoverAnchorId?: string | undefined;
+    popoverContent?: any;
+    active?: string | undefined;
+    previous?: string | undefined;
+    fullscreen: boolean;
+    sidebarOpen: boolean;
+    complementarySidebarOpen: boolean;
+    dialogOpen: boolean;
+    popoverOpen: boolean;
+}, {
+    dialogContent?: any;
+    popoverAnchorId?: string | undefined;
+    popoverContent?: any;
+    active?: string | undefined;
+    previous?: string | undefined;
+    fullscreen: boolean;
+    sidebarOpen: boolean;
+    complementarySidebarOpen: boolean;
+    dialogOpen: boolean;
+    popoverOpen: boolean;
+}>;
+export type Layout = z.infer<typeof Layout>;
+/**
+ * Provides for a plugin that can manage the app layout.
+ */
+export type LayoutProvides = {
+    layout: Readonly<Layout>;
+};
+/**
+ * Type guard for layout plugins.
+ */
+export declare const parseLayoutPlugin: (plugin: Plugin) => Plugin<LayoutProvides> | undefined;
+export declare enum LayoutAction {
+    TOGGLE_FULLSCREEN = "dxos.org/plugin/intent/toggle-fullscreen",
+    TOGGLE_SIDEBAR = "dxos.org/plugin/intent/toggle-sidebar",
+    TOGGLE_COMPLEMENTARY_SIDEBAR = "dxos.org/plugin/intent/toggle-complementary-sidebar",
+    OPEN_DIALOG = "dxos.org/plugin/intent/open-dialog",
+    CLOSE_DIALOG = "dxos.org/plugin/intent/close-dialog",
+    OPEN_POPOVER = "dxos.org/plugin/intent/open-popover",
+    CLOSE_POPOVER = "dxos.org/plugin/intent/close-popover",
+    ACTIVATE = "dxos.org/plugin/intent/activate"
+}
+/**
+ * Expected payload for layout actions.
+ */
+export declare namespace LayoutAction {
+    type ToggleFullscreen = {
+        state?: boolean;
+    };
+    type ToggleSidebar = {
+        state?: boolean;
+    };
+    type ToggleComplementarySidebar = {
+        state?: boolean;
+    };
+    type OpenDialog = {
+        component: string;
+        subject: any;
+    };
+    type CloseDialog = {};
+    type OpenPopover = {
+        anchorId: string;
+        component: string;
+        subject: any;
+    };
+    type ClosePopover = {};
+    type Activate = {
+        id: string;
+    };
+}
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/layout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAM5C;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBjB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAY,MAAM,uCAG/C,CAAC;AAQF,oBAAY,YAAY;IACtB,iBAAiB,6CAAuC;IACxD,cAAc,0CAAoC;IAClD,4BAA4B,wDAAkD;IAC9E,WAAW,uCAAiC;IAC5C,YAAY,wCAAkC;IAC9C,YAAY,wCAAkC;IAC9C,aAAa,yCAAmC;IAChD,QAAQ,oCAA8B;CACvC;AAED;;GAEG;AACH,yBAAiB,YAAY,CAAC;IAC5B,KAAY,gBAAgB,GAAG;QAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IAEF,KAAY,aAAa,GAAG;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IAEF,KAAY,0BAA0B,GAAG;QACvC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IAEF,KAAY,UAAU,GAAG;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,GAAG,CAAC;KACd,CAAC;IAEF,KAAY,WAAW,GAAG,EAAE,CAAC;IAE7B,KAAY,WAAW,GAAG;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,GAAG,CAAC;KACd,CAAC;IAEF,KAAY,YAAY,GAAG,EAAE,CAAC;IAE9B,KAAY,QAAQ,GAAG;QACrB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH"}

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { Plugin } from '../PluginHost';
+export declare const ResourceKey: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>;
+export type ResourceKey = z.infer<typeof ResourceKey>;
+export declare const ResourceLanguage: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+export type ResourceLanguage = z.infer<typeof ResourceLanguage>;
+/**
+ * A resource is a collection of translations for a language.
+ */
+export declare const Resource: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>>;
+export type Resource = z.infer<typeof Resource>;
+/**
+ * Provides for a plugin that exposes translations.
+ */
+export type TranslationsProvides = {
+    translations: Readonly<Resource[]>;
+};
+/**
+ * Type guard for translation plugins.
+ */
+export declare const parseTranslationsPlugin: (plugin: Plugin) => Plugin<TranslationsProvides> | undefined;
+//# sourceMappingURL=translations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/common/translations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,eAAO,MAAM,WAAW,+DAA2C,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB,yFAAwB,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,QAAQ,mHAA6B,CAAC;AACnD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,WAAY,MAAM,6CAGrD,CAAC"}

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

@@ -0,0 +1,22 @@
+import { type Plugin } from './PluginHost';
+/**
+ * Find a plugin by ID.
+ */
+export declare const findPlugin: <T>(plugins: Plugin[], id: string) => Plugin<T> | undefined;
+/**
+ * Find a plugin by ID, or raise an error if not found.
+ */
+export declare const getPlugin: <T>(plugins: Plugin[], id: string) => Plugin<T>;
+/**
+ * Filter a list of plugins to only those that match a predicate.
+ */
+export declare const filterPlugins: <T>(plugins: Plugin[], predicate: (plugin: Plugin) => Plugin<T> | undefined) => Plugin<T>[];
+/**
+ * Resolves a plugin by predicate.
+ *
+ * @example
+ * import { parseIntentPlugin, resolvePlugin } from '@dxos/app-framework';
+ * const intentPlugin = resolvePlugin(plugins, parseIntentPlugin);
+ */
+export declare const resolvePlugin: <T>(plugins: Plugin[], predicate: (plugin: Plugin) => Plugin<T> | undefined) => Plugin<T> | undefined;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/plugins/helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,UAAU,eAAgB,MAAM,EAAE,MAAM,MAAM,0BAI1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,eAAgB,MAAM,EAAE,MAAM,MAAM,cAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,eACf,MAAM,EAAE,sBACG,MAAM,0CACkF,CAAC;AAE/G;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,eACf,MAAM,EAAE,sBACG,MAAM,oDACoC,CAAC"}

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

@@ -0,0 +1,6 @@
+export * from './common';
+export * from './helpers';
+export * from './IntentPlugin';
+export * from './PluginHost';
+export * from './SurfacePlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAE1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}