@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

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,EAA6B,KAAK,QAAQ,EAAa,MAAM,OAAO,CAAC;AAO1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,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 React from 'react';
-import { type SurfaceProps } from '../common';
-import { type PluginContext } from '../core';
-/**
- * @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;
-/**
- * A surface is a named region of the screen that can be populated by plugins.
- */
-export declare const Surface: React.MemoExoticComponent<React.ForwardRefExoticComponent<Omit<SurfaceProps, "ref"> & React.RefAttributes<HTMLElement>>>;
-//# 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,OAAO,KAAwD,MAAM,OAAO,CAAC;AAO7E,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAqB7C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,gBAAgB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI7G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA6BnB,CAAC"}

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

@@ -1,16 +0,0 @@
-import '@dxos-theme';
-import React from 'react';
-import { type PluginManager } from '../core';
-declare const _default: {
-    title: string;
-    render: ({ manager }: {
-        manager: PluginManager;
-    }) => React.JSX.Element;
-    decorators: import("@storybook/react").Decorator[];
-    args: {
-        manager: PluginManager;
-    };
-};
-export default _default;
-export declare const Default: {};
-//# sourceMappingURL=Surface.stories.d.ts.map

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,aAAa,CAAC;AAErB,OAAO,KAAgC,MAAM,OAAO,CAAC;AASrD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;;;0BAkErB;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE;;;;;;AAFlD,wBAcE;AAEF,eAAO,MAAM,OAAO,IAAK,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":"AAOA,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,7 +0,0 @@
-export * from './common';
-export * from './ErrorBoundary';
-export * from './PluginManagerProvider';
-export * from './Surface';
-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,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,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":"AASA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;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/worker.d.ts

@@ -1,4 +0,0 @@
-export * from './core';
-export * from './common';
-export * from './plugin-intent';
-//# sourceMappingURL=worker.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/worker.ts"],"names":[],"mappings":"AAOA,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/src/App.tsx

@@ -1,276 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { RegistryContext } from '@effect-rx/rx-react';
-import { effect } from '@preact/signals-core';
-import React, { useCallback, useEffect, useMemo, useState, type FC, type PropsWithChildren } from 'react';
-
-import { invariant } from '@dxos/invariant';
-import { live } from '@dxos/live-object';
-import { useDefaultValue } from '@dxos/react-hooks';
-
-import { Capabilities, Events } from './common';
-import { PluginManager, type PluginManagerOptions, type Plugin } from './core';
-import { topologicalSort } from './helpers';
-import { ErrorBoundary, PluginManagerProvider, useCapabilities } from './react';
-
-const ENABLED_KEY = 'dxos.org/app-framework/enabled';
-
-export type CreateAppOptions = {
-  pluginManager?: PluginManager;
-  pluginLoader?: PluginManagerOptions['pluginLoader'];
-  plugins?: Plugin[];
-  core?: string[];
-  defaults?: string[];
-  placeholder?: FC<{ stage: number }>;
-  fallback?: ErrorBoundary['props']['fallback'];
-  cacheEnabled?: boolean;
-  safeMode?: boolean;
-};
-
-/**
- * Expected usage is for this to be the entrypoint of the application.
- * Initializes plugins and renders the root components.
- *
- * @example
- * const plugins = [LayoutPlugin(), MyPlugin()];
- * const core = [LayoutPluginId];
- * const default = [MyPluginId];
- * const fallback = <div>Initializing Plugins...</div>;
- * const App = createApp({ plugins, core, default, fallback });
- * createRoot(document.getElementById('root')!).render(
- *   <StrictMode>
- *     <App />
- *   </StrictMode>,
- * );
- *
- * @param params.pluginLoader A function which loads new plugins.
- * @param params.plugins All plugins available to the application.
- * @param params.core Core plugins which will always be enabled.
- * @param params.defaults Default plugins are enabled by default but can be disabled by the user.
- * @param params.placeholder Placeholder component to render during startup.
- * @param params.fallback Fallback component to render if an error occurs during startup.
- * @param params.cacheEnabled Whether to cache enabled plugins in localStorage.
- * @param params.safeMode Whether to enable safe mode, which disables optional plugins.
- */
-export const useApp = ({
-  pluginManager,
-  pluginLoader: _pluginLoader,
-  plugins: _plugins,
-  core: _core,
-  defaults: _defaults,
-  placeholder,
-  fallback = DefaultFallback,
-  cacheEnabled = false,
-  safeMode = false,
-}: CreateAppOptions) => {
-  const plugins = useDefaultValue(_plugins, () => []);
-  const core = useDefaultValue(_core, () => plugins.map(({ meta }) => meta.id));
-  const defaults = useDefaultValue(_defaults, () => []);
-
-  // TODO(wittjosiah): Provide a custom plugin loader which supports loading via url.
-  const pluginLoader = useMemo(
-    () =>
-      _pluginLoader ??
-      ((id: string) => {
-        const plugin = plugins.find((plugin) => plugin.meta.id === id);
-        invariant(plugin, `Plugin not found: ${id}`);
-        return plugin;
-      }),
-    [_pluginLoader, plugins],
-  );
-
-  const state = useMemo(() => live({ ready: false, error: null }), []);
-  const cached: string[] = useMemo(() => JSON.parse(localStorage.getItem(ENABLED_KEY) ?? '[]'), []);
-  const enabled = useMemo(
-    () => (safeMode ? [] : cacheEnabled && cached.length > 0 ? cached : defaults),
-    [safeMode, cacheEnabled, cached, defaults],
-  );
-  const manager = useMemo(
-    () => pluginManager ?? new PluginManager({ pluginLoader, plugins, core, enabled }),
-    [pluginManager, pluginLoader, plugins, core, enabled],
-  );
-
-  useEffect(() => {
-    return manager.activation.on(({ event, state: _state, error }) => {
-      // Once the app is ready the first time, don't show the fallback again.
-      if (!state.ready && event === Events.Startup.id) {
-        state.ready = _state === 'activated';
-      }
-
-      if (error && !state.ready && !state.error) {
-        state.error = error;
-      }
-    });
-  }, [manager, state]);
-
-  useEffect(() => {
-    effect(() => {
-      cacheEnabled && localStorage.setItem(ENABLED_KEY, JSON.stringify(manager.enabled));
-    });
-  }, [cacheEnabled, manager]);
-
-  useEffect(() => {
-    manager.context.contributeCapability({
-      interface: Capabilities.PluginManager,
-      implementation: manager,
-      module: 'dxos.org/app-framework/plugin-manager',
-    });
-
-    manager.context.contributeCapability({
-      interface: Capabilities.RxRegistry,
-      implementation: manager.registry,
-      module: 'dxos.org/app-framework/rx-registry',
-    });
-
-    return () => {
-      manager.context.removeCapability(Capabilities.PluginManager, manager);
-      manager.context.removeCapability(Capabilities.RxRegistry, manager.registry);
-    };
-  }, [manager]);
-
-  useEffect(() => {
-    setupDevtools(manager);
-  }, [manager]);
-
-  useEffect(() => {
-    const timeout = setTimeout(async () => {
-      await Promise.all([
-        // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
-        manager.activate(Events.SetupReactSurface),
-        manager.activate(Events.Startup),
-      ]);
-    });
-
-    return () => clearTimeout(timeout);
-  }, [manager]);
-
-  return useCallback(
-    () => (
-      <ErrorBoundary fallback={fallback}>
-        <PluginManagerProvider value={manager}>
-          <RegistryContext.Provider value={manager.registry}>
-            <App placeholder={placeholder} state={state} />
-          </RegistryContext.Provider>
-        </PluginManagerProvider>
-      </ErrorBoundary>
-    ),
-    [fallback, manager, placeholder, state],
-  );
-};
-
-const DELAY_PLACEHOLDER = 2_000;
-
-enum LoadingState {
-  Loading = 0,
-  FadeIn = 1,
-  FadeOut = 2,
-  Done = 3,
-}
-
-/**
- * To avoid "flashing" the placeholder, we wait a period of time before starting the loading animation.
- * If loading completes during this time the placehoder is not shown, otherwise is it displayed for a minimum period of time.
- *
- * States:
- * 0: Loading   - Wait for a period of time before starting the loading animation.
- * 1: Fade-in   - Display a loading animation.
- * 2: Fade-out  - Fade out the loading animation.
- * 3: Done      - Remove the placeholder.
- */
-const useLoading = (state: AppProps['state']) => {
-  const [stage, setStage] = useState<LoadingState>(LoadingState.Loading);
-  useEffect(() => {
-    const i = setInterval(() => {
-      setStage((tick) => {
-        switch (tick) {
-          case LoadingState.Loading:
-            if (!state.ready) {
-              return LoadingState.FadeIn;
-            } else {
-              clearInterval(i);
-              return LoadingState.Done;
-            }
-          case LoadingState.FadeIn:
-            if (state.ready) {
-              return LoadingState.FadeOut;
-            }
-            break;
-          case LoadingState.FadeOut:
-            clearInterval(i);
-            return LoadingState.Done;
-        }
-
-        return tick;
-      });
-    }, DELAY_PLACEHOLDER);
-
-    return () => clearInterval(i);
-  }, []);
-
-  return stage;
-};
-
-type AppProps = Pick<CreateAppOptions, 'placeholder'> & {
-  state: { ready: boolean; error: unknown };
-};
-
-const App = ({ placeholder: Placeholder, state }: AppProps) => {
-  const reactContexts = useCapabilities(Capabilities.ReactContext);
-  const reactRoots = useCapabilities(Capabilities.ReactRoot);
-  const stage = useLoading(state);
-
-  if (state.error) {
-    // This triggers the error boundary to provide UI feedback for the startup error.
-    throw state.error;
-  }
-
-  // TODO(wittjosiah): Consider using Suspense instead?
-  if (stage < LoadingState.Done) {
-    if (!Placeholder) {
-      return null;
-    }
-
-    return <Placeholder stage={stage} />;
-  }
-
-  const ComposedContext = composeContexts(reactContexts);
-  return (
-    <ComposedContext>
-      {reactRoots.map(({ id, root: Component }) => (
-        <Component key={id} />
-      ))}
-    </ComposedContext>
-  );
-};
-
-// Default fallback does not use tailwind or theme.
-const DefaultFallback = ({ error }: { error: Error }) => {
-  return (
-    <div style={{ margin: '0.5rem', padding: '1rem', overflow: 'hidden', border: '1px solid red' }}>
-      {/* TODO(wittjosiah): Link to docs for replacing default. */}
-      <h1 style={{ margin: '0.5rem 0', fontSize: '1.2rem' }}>[ERROR]: {error.message}</h1>
-      <pre style={{ overflow: 'auto', fontSize: '1rem' }}>{error.stack}</pre>
-    </div>
-  );
-};
-
-const composeContexts = (contexts: Capabilities.ReactContext[]) => {
-  if (contexts.length === 0) {
-    return ({ children }: PropsWithChildren) => <>{children}</>;
-  }
-
-  return topologicalSort(contexts)
-    .map(({ context }) => context)
-    .reduce((Acc, Next) => ({ children }) => (
-      <Acc>
-        <Next>{children}</Next>
-      </Acc>
-    ));
-};
-
-const setupDevtools = (manager: PluginManager) => {
-  (globalThis as any).composer ??= {};
-  (globalThis as any).composer.manager = manager;
-};

package/src/common/collaboration.ts

@@ -1,21 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Schema } from 'effect';
-
-import { Expando, Ref } from '@dxos/echo-schema';
-
-export namespace CollaborationActions {
-  export class InsertContent extends Schema.TaggedClass<InsertContent>()('assistant/intent-content', {
-    input: Schema.Struct({
-      target: Expando,
-      object: Ref(Expando),
-      at: Schema.optional(Schema.String),
-      label: Schema.String.pipe(Schema.optional),
-    }).annotations({
-      description: 'Enables plugins to inject content blocks or references into a related entity.',
-    }),
-    output: Schema.Void,
-  }) {}
-}

package/src/common/events.ts

@@ -1,77 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capabilities } from './capabilities';
-import { defineEvent } from '../core';
-
-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.
-   */
-  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 { Schema } from 'effect';
-
-// 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>;
-};