@dxos/app-framework 0.8.4-main.e8ec1fe → 0.8.4-main.ef1bc66f44

package/dist/types/src/react/ErrorBoundary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/react/ErrorBoundary.tsx"],"names":[],"mappings":"AAIA,OAAc,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1F,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,EAAE,CAAC;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC7C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,KAAK,CAAC;IACrE,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE;IAItD,KAAK;;MAAwB;IAE7B,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAMvD,MAAM,IAAI,SAAS;IAS5B,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/src/react/IntentContext.d.ts

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

package/dist/types/src/react/IntentContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../src/react/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAwC,MAAM,OAAO,CAAC;AAM1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI9E,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAuD,CAAC;AAE9G,eAAO,MAAM,mBAAmB,QAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,iBAAiB,CAGxF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,UAAU,iBAAiB,SAW5E,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,GAAG,SAAS,CAA0B,CAAC"}

package/dist/types/src/react/PluginManagerProvider.d.ts

@@ -1,10 +0,0 @@
-import { type PluginManager } from '../core';
-/**
- * Get the plugin manager.
- */
-export declare const usePluginManager: () => PluginManager;
-/**
- * Context provider for a plugin manager.
- */
-export declare const PluginManagerProvider: import("react").Provider<PluginManager | undefined>;
-//# sourceMappingURL=PluginManagerProvider.d.ts.map

package/dist/types/src/react/PluginManagerProvider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginManagerProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/PluginManagerProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,aACkD,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,qBAAqB,qDAAgC,CAAC"}

package/dist/types/src/react/Surface.d.ts

@@ -1,12 +0,0 @@
-import { type NamedExoticComponent, type RefAttributes } from 'react';
-import { type SurfaceProps } from '../common';
-import { type PluginContext } from '../core';
-/**
- * A surface is a named region of the screen that can be populated by plugins.
- */
-export declare const Surface: NamedExoticComponent<SurfaceProps & RefAttributes<HTMLElement>>;
-/**
- * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
- */
-export declare const isSurfaceAvailable: (context: PluginContext, { role, data }: Pick<SurfaceProps, "role" | "data">) => boolean;
-//# sourceMappingURL=Surface.d.ts.map

package/dist/types/src/react/Surface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAc,EAEZ,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAKnB,MAAM,OAAO,CAAC;AAKf,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7C;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,oBAAoB,CAAC,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,CA+BnF,CAAC;AA+BF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,gBAAgB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI7G,CAAC"}

package/dist/types/src/react/Surface.stories.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Surface.stories.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA2C,MAAM,OAAO,CAAC;AA0GhE,QAAA,MAAM,IAAI;;;;;;;CAO2B,CAAC;AAEtC,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

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

@@ -1,13 +0,0 @@
-export declare const useIntentDispatcher: () => import("..").IntentContext;
-export declare const useAppGraph: () => Readonly<Pick<import("@dxos/app-graph").GraphBuilder, "graph" | "explore">>;
-export declare const useLayout: () => Readonly<{
-    mode: string;
-    dialogOpen: boolean;
-    sidebarOpen: boolean;
-    complementarySidebarOpen: boolean;
-    workspace: string;
-    active: string[];
-    inactive: string[];
-    scrollIntoView: string | undefined;
-}>;
-//# sourceMappingURL=common.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/react/common.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB,kCAAqD,CAAC;AAEtF,eAAO,MAAM,WAAW,mFAA6C,CAAC;AAEtE,eAAO,MAAM,SAAS;;;;;;;;;EAA2C,CAAC"}

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

@@ -1,9 +0,0 @@
-export * from './common';
-export * from './types';
-export * from './ErrorBoundary';
-export * from './PluginManagerProvider';
-export * from './Surface';
-export * from './useApp';
-export * from './useCapabilities';
-export * from './useIntentResolver';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAE1B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

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

@@ -1,14 +0,0 @@
-import * as Schema from 'effect/Schema';
-import { type Obj } from '@dxos/echo';
-export declare const SurfaceCardRole: Schema.Literal<["card", "card--popover", "card--intrinsic", "card--extrinsic", "card--transclusion"]>;
-export type SurfaceCardRole = Schema.Schema.Type<typeof SurfaceCardRole>;
-export type SurfaceRole = 'item' | 'article' | 'complementary' | 'section' | SurfaceCardRole;
-/**
- * Base type for surface components.
- */
-export type SurfaceComponentProps<Subject extends Obj.Any = Obj.Any, Props = {}, Role extends string = string> = {
-    role?: Role;
-    /** The object being displayed. */
-    subject: Subject;
-} & Props;
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/react/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,eAAe,uGAM3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAGzE,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,SAAS,GACT,eAAe,GACf,SAAS,GACT,eAAe,CAAC;AAEpB;;GAEG;AAGH,MAAM,MAAM,qBAAqB,CAAC,OAAO,SAAS,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI;IAC/G,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,KAAK,CAAC"}

package/dist/types/src/react/useApp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useApp.d.ts","sourceRoot":"","sources":["../../../../src/react/useApp.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAmC,MAAM,OAAO,CAAC;AAOxE,OAAO,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAIhF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,EAAE,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM,GAAI,+KAWpB,aAAa,4BAwFf,CAAC"}

package/dist/types/src/react/useCapabilities.d.ts

@@ -1,13 +0,0 @@
-import { type InterfaceDef } from '../core';
-/**
- * Hook to request capabilities from the plugin context.
- * @returns An array of capabilities.
- */
-export declare const useCapabilities: <T>(interfaceDef: InterfaceDef<T>) => T[];
-/**
- * Hook to request a capability from the plugin context.
- * @returns The capability.
- * @throws If no capability is found.
- */
-export declare const useCapability: <T>(interfaceDef: InterfaceDef<T>) => T;
-//# sourceMappingURL=useCapabilities.d.ts.map

package/dist/types/src/react/useCapabilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,QAG/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,MAI7D,CAAC"}

package/dist/types/src/react/useIntentResolver.d.ts

@@ -1,3 +0,0 @@
-import { type AnyIntentResolver } from '../plugin-intent';
-export declare const useIntentResolver: (module: string, resolver: AnyIntentResolver) => void;
-//# sourceMappingURL=useIntentResolver.d.ts.map

package/dist/types/src/react/useIntentResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useIntentResolver.d.ts","sourceRoot":"","sources":["../../../../src/react/useIntentResolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,UAAU,iBAAiB,SAW5E,CAAC"}

package/dist/types/src/react/useLoading.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLoading.d.ts","sourceRoot":"","sources":["../../../../src/react/useLoading.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,oBAAY,YAAY;IACtB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAO,IAAI;IACX,IAAI,IAAI;CACT;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAY,iBA4ChE,CAAC"}

package/src/common/collaboration.ts

@@ -1,18 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { ContentBlock } from '@dxos/types';
-
-export namespace CollaborationActions {
-  export class AcceptProposal extends Schema.TaggedClass<AcceptProposal>()('collaboration/accept-proposal', {
-    input: Schema.Struct({
-      subject: Schema.Any,
-      anchor: Schema.String,
-      proposal: ContentBlock.Proposal,
-    }),
-    output: Schema.Void,
-  }) {}
-}

package/src/common/events.ts

@@ -1,79 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { defineEvent } from '../core';
-
-import { Capabilities } from './capabilities';
-
-export namespace Events {
-  /**
-   * Fired when the app is started.
-   */
-  export const Startup = defineEvent('dxos.org/app-framework/event/startup');
-
-  //
-  // Dependent Events
-  //
-
-  /**
-   * Fired to load any newly available surfaces.
-   */
-  export const SetupReactSurface = defineEvent('dxos.org/app-framework/event/setup-react-surface');
-
-  /**
-   * Fired to load any newly available metadata.
-   */
-  export const SetupMetadata = defineEvent('dxos.org/app-framework/event/setup-metadata');
-
-  /**
-   * Fired before the intent dispatcher is activated.
-   */
-  export const SetupIntentResolver = defineEvent('dxos.org/app-framework/event/setup-intent-resolver');
-
-  /**
-   * Fired before the settings store is activated.
-   */
-  export const SetupSettings = defineEvent('dxos.org/app-framework/event/setup-settings');
-
-  /**
-   * Fired before the graph is created.
-   */
-  export const SetupAppGraph = defineEvent('dxos.org/app-framework/event/setup-graph');
-
-  /**
-   * Fired before the translations provider is created.
-   */
-  export const SetupTranslations = defineEvent('dxos.org/app-framework/event/setup-translations');
-
-  /**
-   * Fired to load any newly available artifacts definitions.
-   */
-  // TODO(burdon): Rename.
-  export const SetupArtifactDefinition = defineEvent('dxos.org/app-framework/event/setup-artifact-definition');
-
-  //
-  // Triggered Events
-  //
-
-  /**
-   * Fired after the intent dispatcher is ready.
-   */
-  export const DispatcherReady = defineEvent('dxos.org/app-framework/event/dispatcher-ready');
-
-  /**
-   * Fired after the settings store is ready.
-   */
-  export const SettingsReady = defineEvent('dxos.org/app-framework/event/settings-ready');
-
-  /**
-   * Fired when the graph is ready.
-   */
-  export const AppGraphReady = defineEvent('dxos.org/app-framework/event/graph-ready');
-
-  /**
-   * Fired when plugin state is ready.
-   */
-  export const createStateEvent = (specifier: string) => defineEvent('dxos.org/app-framework/event/state', specifier);
-  export const LayoutReady = createStateEvent(Capabilities.Layout.identifier);
-}

package/src/common/file.ts

@@ -1,22 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-// TODO(burdon): See Accept attribute (uses MIME types).
-// E.g., 'image/*': ['.jpg', '.jpeg', '.png', '.gif'],
-export const defaultFileTypes = {
-  images: ['png', 'jpg', 'jpeg', 'gif'],
-  media: ['mp3', 'mp4', 'mov', 'avi'],
-  text: ['pdf', 'txt', 'md'],
-};
-
-export const FileInfoSchema = Schema.Struct({
-  name: Schema.String,
-  type: Schema.String,
-  url: Schema.optional(Schema.String),
-  cid: Schema.optional(Schema.String), // TODO(burdon): Meta key? Or other common properties with other file management system? (e.g., WNFS).
-});
-
-export type FileInfo = Schema.Schema.Type<typeof FileInfoSchema>;

package/src/common/graph.ts

@@ -1,30 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import type { Node } from '@dxos/app-graph';
-import { type MaybePromise, type Position } from '@dxos/util';
-
-// TODO(wittjosiah): Factor out.
-export type SerializedNode = {
-  name: string;
-  data: string;
-  type?: string;
-};
-
-// TODO(wittjosiah): Factor out.
-export type NodeSerializer<T = any> = {
-  inputType: string;
-  outputType: string;
-  position?: Position;
-
-  /**
-   * Takes a node and serializes it into a format that can be stored.
-   */
-  serialize: (node: Node<T>) => MaybePromise<SerializedNode>;
-
-  /**
-   * Takes a serialized node and deserializes it into the application.
-   */
-  deserialize: (data: SerializedNode, ancestors: unknown[]) => MaybePromise<T>;
-};

package/src/common/layout.ts

@@ -1,277 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-
-import { Label } from '../plugin-intent';
-
-const LAYOUT_PLUGIN = 'dxos.org/plugin/layout';
-
-/**
- * Expected payload for layout actions.
- */
-export namespace LayoutAction {
-  export const UPDATE_LAYOUT = `${LAYOUT_PLUGIN}/action/update-layout`;
-
-  /**
-   * Generic layout action.
-   */
-  export class UpdateLayout extends Schema.TaggedClass<UpdateLayout>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.String.annotations({ description: 'The part of the layout to mutate.' }),
-      subject: Schema.optional(Schema.Any.annotations({ description: 'The subject of the layout update.' })),
-      options: Schema.optional(
-        Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
-          description: 'Additional options for the layout action.',
-        }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  //
-  // Common layout actions.
-  //
-
-  // NOTE: These are layout actions which are currently in common use.
-  //  They constrain the generic layout action types to provide additional type safety.
-  //  However, they all follow the same generic structure and intent id.
-  //  This allows for plugins to update the layout without depending on a specific layout plugin.
-  //  The expectation is that other norms other than these will emerge over time.
-
-  export class SetLayoutMode extends Schema.TaggedClass<SetLayoutMode>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('mode').annotations({ description: 'Setting the layout mode.' }),
-      subject: Schema.optional(
-        Schema.String.annotations({ description: 'Item which is the subject of the new layout mode.' }),
-      ),
-      options: Schema.Union(
-        Schema.Struct({ mode: Schema.String.annotations({ description: 'The new layout mode.' }) }),
-        Schema.Struct({ revert: Schema.Boolean.annotations({ description: 'Revert to the previous layout mode.' }) }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class UpdateSidebar extends Schema.TaggedClass<UpdateSidebar>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('sidebar').annotations({ description: 'Updating the sidebar.' }),
-      subject: Schema.optional(
-        Schema.String.annotations({ description: 'URI of the component to display in the sidebar.' }),
-      ),
-      options: Schema.optional(
-        Schema.Struct({
-          state: Schema.Literal('closed', 'collapsed', 'expanded').annotations({
-            description: 'Whether the sidebar is closed, collapsed, or expanded.',
-          }),
-        }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class UpdateComplementary extends Schema.TaggedClass<UpdateComplementary>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('complementary').annotations({ description: 'Updating the complementary sidebar.' }),
-      subject: Schema.optional(
-        Schema.String.annotations({ description: 'URI of the component to display in the complementary area.' }),
-      ),
-      options: Schema.optional(
-        Schema.Struct({
-          state: Schema.Literal('closed', 'collapsed', 'expanded').annotations({
-            description: 'Whether the complementary sidebar is closed, collapsed, or expanded.',
-          }),
-        }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class UpdateDialog extends Schema.TaggedClass<UpdateDialog>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('dialog').annotations({ description: 'Updating the dialog.' }),
-      subject: Schema.optional(
-        Schema.String.annotations({ description: 'URI of the component to display in the dialog.' }),
-      ),
-      options: Schema.Struct({
-        state: Schema.optional(Schema.Boolean.annotations({ description: 'Whether the dialog is open or closed.' })),
-        type: Schema.optional(Schema.Literal('default', 'alert').annotations({ description: 'The type of dialog.' })),
-        blockAlign: Schema.optional(
-          Schema.Literal('start', 'center', 'end').annotations({ description: 'The alignment of the dialog.' }),
-        ),
-        overlayClasses: Schema.optional(
-          Schema.String.annotations({ description: 'Additional classes for the dialog overlay.' }),
-        ),
-        overlayStyle: Schema.optional(
-          Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
-            description: 'Additional styles for the dialog overlay.',
-          }),
-        ),
-        props: Schema.optional(
-          Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
-            description: 'Additional props for the dialog.',
-          }),
-        ),
-      }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class UpdatePopover extends Schema.TaggedClass<UpdatePopover>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('popover').annotations({ description: 'Updating the popover.' }),
-      subject: Schema.optional(
-        Schema.Any.annotations({
-          description: 'URI of the component to display in the popover or data to pass to the popover.',
-        }),
-      ),
-      options: Schema.Struct({
-        side: Schema.optional(
-          Schema.Literal('top', 'right', 'bottom', 'left').annotations({ description: 'The side of the anchor.' }),
-        ),
-        state: Schema.optional(Schema.Boolean.annotations({ description: 'Whether the popover is open or closed.' })),
-        props: Schema.optional(
-          Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
-            description: 'Additional props for the popover.',
-          }),
-        ),
-      }).pipe(
-        Schema.extend(
-          Schema.Union(
-            Schema.Struct({
-              variant: Schema.Literal('virtual'),
-              anchor: Schema.Any.annotations({ description: 'The DOM element to anchor the popover to.' }),
-            }),
-            Schema.Struct({
-              variant: Schema.optional(Schema.Literal('react')),
-              anchorId: Schema.String.annotations({
-                description: 'An id that can be used to determine whether to render the anchor subcomponent.',
-              }),
-            }),
-          ),
-        ),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export const Toast = Schema.Struct({
-    id: Schema.String.annotations({ description: 'The id of the toast.' }),
-    title: Schema.optional(Label.annotations({ description: 'The title of the toast.' })),
-    description: Schema.optional(Label.annotations({ description: 'The description of the toast.' })),
-    icon: Schema.optional(Schema.String.annotations({ description: 'The icon of the toast.' })),
-    duration: Schema.optional(Schema.Number.annotations({ description: 'The duration of the toast.' })),
-    closeLabel: Schema.optional(Label.annotations({ description: 'The label of the close button.' })),
-    actionLabel: Schema.optional(Label.annotations({ description: 'The label of the action button.' })),
-    actionAlt: Schema.optional(Label.annotations({ description: 'The alt text of the action button.' })),
-    onAction: Schema.optional(
-      Schema.Any.annotations({ description: 'The action to perform when the action button is clicked.' }),
-    ),
-  });
-
-  export interface Toast extends Omit<Schema.Schema.Type<typeof Toast>, 'onAction'> {
-    onAction?: () => void;
-  }
-
-  export class AddToast extends Schema.TaggedClass<AddToast>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('toast').annotations({ description: 'Adding a toast.' }),
-      subject: Toast.annotations({ description: 'The toast to add.' }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class SwitchWorkspace extends Schema.TaggedClass<SwitchWorkspace>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
-      subject: Schema.String.annotations({ description: 'The id of the workspace to switch to.' }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class RevertWorkspace extends Schema.TaggedClass<RevertWorkspace>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('workspace').annotations({ description: 'Switching the workspace.' }),
-      options: Schema.Struct({
-        revert: Schema.Literal(true).annotations({ description: 'Revert to the previous workspace.' }),
-      }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class Open extends Schema.TaggedClass<Open>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('main').annotations({ description: 'Opening an item in the main content area.' }),
-      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to open.' })),
-      options: Schema.optional(
-        Schema.Struct({
-          state: Schema.optional(Schema.Literal(true).annotations({ description: 'The items are being added.' })),
-          variant: Schema.optional(Schema.String.annotations({ description: 'The variant of the item to open.' })),
-          key: Schema.optional(
-            Schema.String.annotations({
-              description: 'If provided, will replace item with a matching key (id prefix).',
-            }),
-          ),
-          workspace: Schema.optional(Schema.String.annotations({ description: 'The workspace to open the items in.' })),
-          scrollIntoView: Schema.optional(Schema.Boolean.annotations({ description: 'Scroll the items into view.' })),
-          pivotId: Schema.optional(
-            Schema.String.annotations({ description: 'The id of the item to place new items next to.' }),
-          ),
-          positioning: Schema.optional(
-            Schema.Union(
-              Schema.Literal('start').annotations({ description: 'The items are being added before the pivot item.' }),
-              Schema.Literal('end').annotations({ description: 'The items are being added after the pivot item.' }),
-            ),
-          ),
-        }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class Set extends Schema.TaggedClass<Set>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('main').annotations({ description: 'Setting items in the main content area.' }),
-      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to set.' })),
-      options: Schema.Struct({
-        override: Schema.Literal(true).annotations({
-          description: 'Override the current items in the main content area.',
-        }),
-      }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class Close extends Schema.TaggedClass<Close>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('main').annotations({ description: 'Closing items in the main content area.' }),
-      subject: Schema.Array(Schema.String.annotations({ description: 'Ids of the items to close.' })),
-      options: Schema.Struct({
-        state: Schema.Literal(false).annotations({ description: 'The items are being removed.' }),
-      }),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class ScrollIntoView extends Schema.TaggedClass<ScrollIntoView>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('current').annotations({ description: 'Setting the current item' }),
-      subject: Schema.optional(Schema.String.annotations({ description: 'The id of the item to set as current.' })),
-      options: Schema.optional(
-        Schema.Record({ key: Schema.String, value: Schema.Any }).annotations({
-          description: 'Additional options for the scroll into view.',
-        }),
-      ),
-    }),
-    output: Schema.Void,
-  }) {}
-
-  export class Expose extends Schema.TaggedClass<Expose>()(UPDATE_LAYOUT, {
-    input: Schema.Struct({
-      part: Schema.Literal('navigation').annotations({ description: 'Exposing an item in the navigation area.' }),
-      subject: Schema.String.annotations({ description: 'The id of the item to expose.' }),
-    }),
-    output: Schema.Void,
-  }) {}
-}

package/src/common/surface.ts

@@ -1,88 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import type { ComponentType, PropsWithChildren, ReactNode } from 'react';
-
-import { type MakeOptional, type Position } from '@dxos/util';
-
-import { type ErrorBoundary } from '../react';
-
-/**
- * SurfaceProps are the props that are passed to the Surface component.
- */
-export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
-  /**
-   * 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 specified, the Surface will be wrapped in a suspense boundary.
-   * The placeholder component will be rendered while the surface component is loading.
-   */
-  placeholder?: ReactNode;
-} & MakeOptional<CoreSurfaceProps<T>, 'id' | 'data'> &
-  /**
-   * Additional props to pass to the component.
-   * These props are not used by Surface itself but may be used by components which resolve the surface.
-   * Exclude known prop names to prevent overriding well-defined props.
-   */
-  {
-    [K in keyof Record<string, any>]: K extends keyof CoreSurfaceProps<T> | 'fallback' | 'placeholder' ? never : any;
-  };
-
-/**
- * NOTE: If `[key: string]: unknown` is included in shared types, when re-used other fields become unknown as well.
- */
-export type CoreSurfaceProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
-  /**
-   * ID for debugging.
-   */
-  id: string;
-
-  /**
-   * Role defines how the data should be rendered.
-   */
-  role: string;
-
-  /**
-   * The data to be rendered by the surface.
-   * NOTE: This must be a stable value.
-   */
-  data: T;
-
-  /**
-   * If more than one component is resolved, the limit determines how many are rendered.
-   */
-  limit?: number | undefined;
-}>;
-
-export type SurfaceComponentProps<T extends Record<string, any> = Record<string, any>> = CoreSurfaceProps<T> &
-  Record<string, any>;
-
-/**
- * React component used to render a surface once is has matched.
- */
-export type SurfaceComponent<T extends Record<string, any> = Record<string, any>> = ComponentType<
-  SurfaceComponentProps<T>
->;
-
-/**
- * Definition of when a SurfaceComponent should be rendered.
- */
-export type SurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
-  id: string;
-  role: string | string[];
-  position?: Position;
-  component: SurfaceComponent<T>;
-  filter?: (data: Record<string, unknown>) => data is T;
-}>;
-
-/**
- * Creates a surface definition.
- */
-export const createSurface = <T extends Record<string, any> = any>(
-  definition: SurfaceDefinition<T>,
-): SurfaceDefinition<T> => definition;