@dxos/app-framework 0.8.4-main.937b3ca → 0.8.4-main.9be5663bfe

package/dist/types/src/ui/components/Surface/SurfaceProfilerContext.d.ts

@@ -0,0 +1,48 @@
+import React, { type PropsWithChildren, type ProfilerOnRenderCallback } from 'react';
+/**
+ * Single profiler record captured from React Profiler onRender callback.
+ */
+export type SurfaceProfilerEntry = {
+    id: string;
+    phase: 'mount' | 'update' | 'nested-update';
+    actualDuration: number;
+    baseDuration: number;
+    startTime: number;
+    commitTime: number;
+    timestamp: number;
+};
+/**
+ * Aggregated stats for a single profiled surface.
+ */
+export type SurfaceProfilerStats = {
+    id: string;
+    mountCount: number;
+    updateCount: number;
+    totalRenders: number;
+    avgActualDuration: number;
+    maxActualDuration: number;
+    avgBaseDuration: number;
+    lastActualDuration: number;
+    lastCommitTime: number;
+};
+/**
+ * Provider that collects React Profiler data from Surface components.
+ */
+export declare const SurfaceProfilerProvider: ({ children }: PropsWithChildren) => React.JSX.Element;
+/**
+ * Returns a stable onRender callback for use with React Profiler.
+ */
+export declare const useSurfaceProfilerCallback: () => ProfilerOnRenderCallback | undefined;
+/**
+ * Returns all profiler entries reactively.
+ */
+export declare const useSurfaceProfilerEntries: () => readonly SurfaceProfilerEntry[];
+/**
+ * Returns aggregated stats grouped by surface id.
+ */
+export declare const useSurfaceProfilerStats: () => SurfaceProfilerStats[];
+/**
+ * Clears all collected profiler entries.
+ */
+export declare const useSurfaceProfilerClear: () => (() => void) | undefined;
+//# sourceMappingURL=SurfaceProfilerContext.d.ts.map

package/dist/types/src/ui/components/Surface/SurfaceProfilerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceProfilerContext.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceProfilerContext.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAEZ,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAM9B,MAAM,OAAO,CAAC;AAIf;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAmEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,cAAc,iBAAiB,sBAQtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAO,wBAAwB,GAAG,SAkBxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,SAAS,oBAAoB,EAGzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,oBAAoB,EAqC9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,CAAC,MAAM,IAAI,CAAC,GAAG,SAGzD,CAAC"}

package/dist/types/src/ui/components/Surface/context.d.ts

@@ -0,0 +1,5 @@
+import { type Context } from 'react';
+import { type Props } from './types';
+export type SurfaceContext = Pick<Props, 'id' | 'role' | 'data'>;
+export declare const SurfaceContext: Context<SurfaceContext | undefined>;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/src/ui/components/Surface/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAGjE,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,cAAc,GAAG,SAAS,CAAwD,CAAC"}

package/dist/types/src/ui/components/Surface/index.d.ts

@@ -0,0 +1,26 @@
+import { SurfaceContext } from './context';
+import { type Definition as SurfaceDefinition } from './types';
+export declare namespace Surface {
+    type Definition = SurfaceDefinition;
+    const create: <T extends Record<string, any> = any>(definition: Omit<import("./types").ReactDefinition<T>, "kind">) => import("./types").ReactDefinition<T>;
+    const createWeb: <T extends Record<string, any> = any>(definition: Omit<import("./types").WebComponentDefinition<T>, "kind">) => import("./types").WebComponentDefinition<T>;
+    type Context = SurfaceContext;
+    const Context: import("react").Context<SurfaceContext | undefined>;
+    const Surface: import("react").NamedExoticComponent<{
+        fallback?: import("react").FC<{
+            error: Error;
+            data?: any;
+        }>;
+        placeholder?: import("react").ReactNode;
+    } & Omit<import("./types").CoreProps<Record<string, unknown>>, "id" | "data"> & Partial<Pick<import("./types").CoreProps<Record<string, unknown>>, "id" | "data">> & {
+        [x: string]: any;
+    } & import("react").RefAttributes<HTMLElement>>;
+    const isAvailable: (capabilityManager: import("../../../core/capability-manager").CapabilityManager, { role, data }: Pick<import("./types").Props, "role" | "data">) => boolean;
+    const ProfilerProvider: ({ children }: import("react").PropsWithChildren) => import("react").JSX.Element;
+    const useProfilerCallback: () => import("react").ProfilerOnRenderCallback | undefined;
+    const useProfilerEntries: () => readonly import("./SurfaceProfilerContext").SurfaceProfilerEntry[];
+    const useProfilerStats: () => import("./SurfaceProfilerContext").SurfaceProfilerStats[];
+    const useProfilerClear: () => (() => void) | undefined;
+}
+export type { SurfaceProfilerEntry, SurfaceProfilerStats } from './SurfaceProfilerContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/ui/components/Surface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAS3C,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAA0D,MAAM,SAAS,CAAC;AAEvH,yBAAiB,OAAO,CAAC;IACvB,KAAY,UAAU,GAAG,iBAAiB,CAAC;IACpC,MAAM,MAAM,+IAAgB,CAAC;IAC7B,MAAM,SAAS,6JAAmB,CAAC;IAE1C,KAAY,OAAO,GAAG,cAAc,CAAC;IAC9B,MAAM,OAAO,qDAAiB,CAAC;IAE/B,MAAM,OAAO;;;gBAVkF,CAAC;;;;;mDAUhE,CAAC;IACjC,MAAM,WAAW,8JAAqB,CAAC;IAEvC,MAAM,gBAAgB,kFAA0B,CAAC;IACjD,MAAM,mBAAmB,4DAA6B,CAAC;IACvD,MAAM,kBAAkB,0EAA4B,CAAC;IACrD,MAAM,gBAAgB,iEAA0B,CAAC;IACjD,MAAM,gBAAgB,gCAA0B,CAAC;CACzD;AAED,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/src/{common/surface.d.ts → ui/components/Surface/types.d.ts}

@@ -1,33 +1,35 @@
-import type { PropsWithChildren, ReactNode, RefCallback } from 'react';
+import type { FC, PropsWithChildren, ReactNode, RefCallback } from 'react';
 import type { MakeOptional, Position } from '@dxos/util';
-import type { ErrorBoundary } from '../react';
 /**
- * SurfaceProps are the props that are passed to the Surface component.
+ * Props that are passed to the Surface component.
  */
-export type SurfaceProps<T extends Record<string, any> = Record<string, unknown>> = {
+export type Props<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'];
+    fallback?: FC<{
+        error: Error;
+        data?: any;
+    }>;
     /**
      * 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'> & 
+} & MakeOptional<CoreProps<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;
+    [K in keyof Record<string, any>]: K extends keyof CoreProps<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<{
+export type CoreProps<T extends Record<string, any> = Record<string, unknown>> = PropsWithChildren<{
     /**
      * ID for debugging.
      */
@@ -46,28 +48,28 @@ export type CoreSurfaceProps<T extends Record<string, any> = Record<string, unkn
      */
     limit?: number | undefined;
 }>;
-export type SurfaceComponentProps<T extends Record<string, any> = Record<string, any>> = CoreSurfaceProps<T> & {
+export type ComponentProps<T extends Record<string, any> = Record<string, any>> = CoreProps<T> & {
     ref?: RefCallback<HTMLElement>;
 } & 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>> = (props: SurfaceComponentProps<T>) => ReactNode;
+export type ComponentFunction<T extends Record<string, any> = Record<string, any>> = (props: ComponentProps<T>) => ReactNode;
 /**
- * Definition of when a React SurfaceComponent should be rendered.
+ * Definition of when a React component surface should be rendered.
  */
-export type ReactSurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
+export type ReactDefinition<T extends Record<string, any> = any> = Readonly<{
     kind: 'react';
     id: string;
     role: string | string[];
     position?: Position;
-    component: SurfaceComponent<T>;
+    component: ComponentFunction<T>;
     filter?: (data: Record<string, unknown>) => data is T;
 }>;
 /**
  * Definition of when a Web Component surface should be rendered.
  */
-export type WebComponentSurfaceDefinition<T extends Record<string, any> = any> = Readonly<{
+export type WebComponentDefinition<T extends Record<string, any> = any> = Readonly<{
     kind: 'web-component';
     id: string;
     role: string | string[];
@@ -82,13 +84,13 @@ export type WebComponentSurfaceDefinition<T extends Record<string, any> = any> =
 /**
  * Definition of when a surface (React or Web Component) should be rendered.
  */
-export type SurfaceDefinition<T extends Record<string, any> = any> = ReactSurfaceDefinition<T> | WebComponentSurfaceDefinition<T>;
+export type Definition<T extends Record<string, any> = any> = ReactDefinition<T> | WebComponentDefinition<T>;
 /**
  * Creates a React surface definition.
  */
-export declare const createSurface: <T extends Record<string, any> = any>(definition: Omit<ReactSurfaceDefinition<T>, "kind">) => ReactSurfaceDefinition<T>;
+export declare const create: <T extends Record<string, any> = any>(definition: Omit<ReactDefinition<T>, "kind">) => ReactDefinition<T>;
 /**
  * Creates a Web Component surface definition.
  */
-export declare const createWebSurface: <T extends Record<string, any> = any>(definition: Omit<WebComponentSurfaceDefinition<T>, "kind">) => WebComponentSurfaceDefinition<T>;
-//# sourceMappingURL=surface.d.ts.map
+export declare const createWeb: <T extends Record<string, any> = any>(definition: Omit<WebComponentDefinition<T>, "kind">) => WebComponentDefinition<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/src/ui/components/Surface/types.d.ts.map

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

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

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

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

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

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

@@ -0,0 +1,6 @@
+export * from './useApp';
+export * from './useCapabilities';
+export * from './useLoading';
+export * from './useSettingsState';
+export * from './useSurface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/types/src/{react → ui/hooks}/useApp.d.ts

@@ -1,20 +1,37 @@
 import React, { type FC } from 'react';
-import { type Plugin, PluginManager } from '../core';
-import { ErrorBoundary } from './ErrorBoundary';
+import { type FallbackProps } from '@dxos/react-error-boundary';
+import { type ActivationEvent, type Plugin, PluginManager } from '../../core';
+export type StartupProgress = {
+    /** Number of modules that have been activated. */
+    activated: number;
+    /** Total number of modules registered. */
+    total: number;
+    /** Fractional progress (0-1). */
+    progress: number;
+    /** Human-readable label for the currently activating module. */
+    status?: string;
+};
+export type PlaceholderProps = {
+    stage?: number;
+    progress?: StartupProgress;
+};
 export type UseAppOptions = {
     pluginManager?: PluginManager.PluginManager;
     pluginLoader?: PluginManager.ManagerOptions['pluginLoader'];
     plugins?: Plugin.Plugin[];
     core?: string[];
     defaults?: string[];
-    placeholder?: FC<{
-        stage: number;
-    }>;
-    fallback?: ErrorBoundary['props']['fallback'];
+    /**
+     * Additional activation events to fire before startup.
+     * These are fired alongside SetupReactSurface before the Startup event.
+     */
+    setupEvents?: ActivationEvent.ActivationEvent[];
     cacheEnabled?: boolean;
     safeMode?: boolean;
     debounce?: number;
     timeout?: number;
+    fallback?: FC<FallbackProps>;
+    placeholder?: FC<PlaceholderProps>;
 };
 /**
  * Expected usage is for this to be the entrypoint of the application.
@@ -36,10 +53,10 @@ export type UseAppOptions = {
  * @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.
+ * @param params.fallback Fallback component to render if an error occurs during startup.
+ * @param params.placeholder Placeholder component to render during startup.
  */
-export declare const useApp: ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsProp, core: coreProp, defaults: defaultsProp, placeholder, fallback, cacheEnabled, safeMode, debounce, timeout, }: UseAppOptions) => () => React.JSX.Element;
+export declare const useApp: ({ pluginManager, pluginLoader: pluginLoaderProp, plugins: pluginsProp, core: coreProp, defaults: defaultsProp, setupEvents: setupEventsProp, placeholder, fallback, cacheEnabled, safeMode, debounce, timeout, }: UseAppOptions) => () => React.JSX.Element;
 //# sourceMappingURL=useApp.d.ts.map

package/dist/types/src/ui/hooks/useApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApp.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useApp.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAqD,MAAM,OAAO,CAAC;AAK1F,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAM9F,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK9E,MAAM,MAAM,eAAe,GAAG;IAC5B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC;IAC5C,YAAY,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC,eAAe,EAAE,CAAC;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM,GAAI,kNAapB,aAAa,4BAoKf,CAAC"}

package/dist/types/src/ui/hooks/useApp.test.d.ts

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

package/dist/types/src/ui/hooks/useApp.test.d.ts.map

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

package/dist/types/src/{react → ui/hooks}/useCapabilities.d.ts

@@ -1,5 +1,6 @@
 import { type Atom } from '@effect-atom/atom-react';
-import { type Capability } from '../core';
+import { Capabilities } from '../../common';
+import { type Capability } from '../../core';
 /**
  * Hook to request capabilities from the plugin context.
  * @returns An array of capabilities.
@@ -23,4 +24,8 @@ export declare const useAtomCapability: <T>(atomCapability: Capability.Interface
  * @example const [settings, updateSettings] = useAtomCapabilityState(ThreadCapabilities.Settings);
  */
 export declare const useAtomCapabilityState: <T>(atomCapability: Capability.InterfaceDef<Atom.Writable<T>>) => [T, (fn: (current: T) => T) => void];
+/**
+ * Hook to get the operation invoker capability.
+ */
+export declare const useOperationInvoker: () => Capabilities.OperationInvoker;
 //# sourceMappingURL=useCapabilities.d.ts.map

package/dist/types/src/ui/hooks/useCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useCapabilities.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,yBAAyB,CAAC;AAKlE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,cAAc,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,QAG1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,cAAc,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAIxE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,gBAAgB,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAG,CAG5F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EACtC,gBAAgB,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KACxD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAWrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,YAAY,CAAC,gBAAgE,CAAC"}

package/dist/types/src/ui/hooks/useLoading.d.ts.map

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

package/dist/types/src/{react/common.d.ts → ui/hooks/useSettingsState.d.ts}

@@ -1,8 +1,4 @@
 import { type Atom } from '@effect-atom/atom-react';
-import * as Common from '../common';
-export declare const useOperationInvoker: () => Common.Capability.OperationInvoker;
-export declare const useAppGraph: () => Common.Capability.AppGraph;
-export declare const useLayout: () => Common.Capability.Layout;
 /**
  * Hook to read and update a settings atom.
  * Returns the current value and an update function.
@@ -11,4 +7,4 @@ export declare const useSettingsState: <T>(atom: Atom.Writable<T>) => {
     settings: T;
     updateSettings: (fn: (current: T) => T) => void;
 };
-//# sourceMappingURL=common.d.ts.map
+//# sourceMappingURL=useSettingsState.d.ts.map

package/dist/types/src/ui/hooks/useSettingsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettingsState.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useSettingsState.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAiC,MAAM,yBAAyB,CAAC;AAGnF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KACrB;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;CAYhE,CAAC"}

package/dist/types/src/ui/hooks/useSurface.d.ts

@@ -0,0 +1,3 @@
+import { Surface } from '../components';
+export declare const useSurface: () => Surface.Context;
+//# sourceMappingURL=useSurface.d.ts.map

package/dist/types/src/ui/hooks/useSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurface.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useSurface.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,UAAU,QAAO,OAAO,CAAC,OAErC,CAAC"}

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

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

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

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

package/dist/types/src/vite-plugin/composer-plugin.d.ts

@@ -0,0 +1,18 @@
+import { type Plugin } from 'vite';
+/**
+ * Vite plugin for **external Composer plugin projects**. Configures the build to produce
+ * an ESM bundle that externalizes all framework dependencies, which the Composer host app
+ * provides at runtime via import map.
+ *
+ * Handles three concerns:
+ * 1. Build config — lib mode entry point, ES format output, rollup externals.
+ * 2. Dev externalization — marks shared deps as external during `vite serve` and strips
+ *    the `/@id/` prefix that Vite's import analysis adds to external bare specifiers.
+ * 3. JSX dev runtime shim — bridges `react/jsx-dev-runtime` (used by React refresh in dev)
+ *    to `react/jsx-runtime` (which is what the externalized React provides).
+ */
+export declare const composerPlugin: (options?: {
+    entry?: string;
+    port?: number;
+}) => Plugin[];
+//# sourceMappingURL=composer-plugin.d.ts.map

package/dist/types/src/vite-plugin/composer-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-plugin.d.ts","sourceRoot":"","sources":["../../../../src/vite-plugin/composer-plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAYnC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,EAmGlF,CAAC"}

package/dist/types/src/vite-plugin/import-map-plugin.d.ts

@@ -0,0 +1,16 @@
+import { type Plugin } from 'vite';
+/**
+ * Vite plugin for the **host app** (Composer). Generates a browser import map so that
+ * shared packages are loaded once and reused by both the host and any remote plugins.
+ *
+ * In dev mode, maps bare specifiers directly to resolved file paths.
+ * In production, emits a dedicated chunk per specifier via virtual wrapper modules,
+ * then injects a `<script type="importmap">` tag into the HTML with the chunk URLs.
+ *
+ * Virtual wrappers are needed because directly emitting chunks for CJS packages loses
+ * their named exports due to Rollup's interop. The wrapper re-exports them explicitly.
+ */
+export declare const importMapPlugin: (options?: {
+    packages?: string[];
+}) => Plugin[];
+//# sourceMappingURL=import-map-plugin.d.ts.map

package/dist/types/src/vite-plugin/import-map-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-map-plugin.d.ts","sourceRoot":"","sources":["../../../../src/vite-plugin/import-map-plugin.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAmKnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,MAAM,EAmIzE,CAAC"}

package/dist/types/src/vite-plugin/index.d.ts

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

package/dist/types/src/vite-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vite-plugin/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/types/src/vite-plugin/packages.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Packages shared between the Composer host app and remote plugins.
+ * The host provides these via import map so plugins don't bundle their own copies.
+ * Used as the default list for both `importMapPlugin` (host) and `composerPlugin` (plugin).
+ */
+export declare const DEFAULT_PACKAGES: string[];
+//# sourceMappingURL=packages.d.ts.map

package/dist/types/src/vite-plugin/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../../../src/vite-plugin/packages.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAmB5B,CAAC"}