@dxos/app-framework 0.8.4-main.c85a9c8dae → 0.8.4-main.d05539e30a

package/dist/types/src/plugin-process-manager/history/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/capability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC"}

package/dist/types/src/plugin-process-manager/history/errors.d.ts

@@ -0,0 +1,32 @@
+import { BaseError } from '@dxos/errors';
+declare const EmptyHistoryError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+    };
+    isError(error: unknown): error is Error;
+    name: "EmptyHistoryError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class EmptyHistoryError extends EmptyHistoryError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/src/plugin-process-manager/history/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC,qBAAa,iBAAkB,SAAQ,sBAAuE;CAAG"}

package/dist/types/src/{plugin-operation → plugin-process-manager}/history/history-tracker.d.ts

@@ -1,5 +1,5 @@
 import * as Effect from 'effect/Effect';
-import { type OperationInvoker } from '@dxos/operation';
+import { OperationInvoker } from '@dxos/operation';
 import type { UndoRegistry } from './undo-registry';
 /**
  * HistoryTracker interface - tracks operation history and provides undo.

package/dist/types/src/plugin-process-manager/history/history-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-tracker.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/history-tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB;AAMD;;GAEG;AACH,eAAO,MAAM,IAAI,YACN,gBAAgB,CAAC,wBAAwB,gBACpC,YAAY,KACzB,cAqFF,CAAC"}

package/dist/types/src/plugin-process-manager/history/history-tracker.test.d.ts.map

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

package/dist/types/src/plugin-process-manager/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC"}

package/dist/types/src/{plugin-operation → plugin-process-manager}/history/types.d.ts

@@ -1,4 +1,4 @@
-import type { Operation } from '@dxos/operation';
+import type { Operation } from '@dxos/compute';
 /**
  * History entry stored by HistoryTracker.
  */

package/dist/types/src/plugin-process-manager/history/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/types/src/{plugin-operation → plugin-process-manager}/history/undo-mapping.d.ts

@@ -1,4 +1,4 @@
-import type { Operation } from '@dxos/operation';
+import type { Operation } from '@dxos/compute';
 /**
  * Label type for translatable text (canonical definition in @dxos/app-toolkit).
  */

package/dist/types/src/plugin-process-manager/history/undo-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/undo-mapping.ts"],"names":[],"mappings":"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"}

package/dist/types/src/{plugin-operation → plugin-process-manager}/history/undo-registry.d.ts

@@ -1,4 +1,4 @@
-import type { Operation } from '@dxos/operation';
+import type { Operation } from '@dxos/compute';
 import type * as UndoMapping from './undo-mapping';
 /**
  * Lookup result from UndoRegistry.

package/dist/types/src/plugin-process-manager/history/undo-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-registry.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/undo-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAMnD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,mEAAmE;IACnE,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,SAAS,CAAC;IAC5D,8DAA8D;IAC9D,OAAO,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;CACvE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,iBAAiB,GAAG,SAAS,CAAC;CACtF;AAMD;;GAEG;AACH,eAAO,MAAM,IAAI,gBAAiB,MAAM,WAAW,CAAC,WAAW,EAAE,KAAG,YAgBnE,CAAC"}

package/dist/types/src/plugin-process-manager/history/undo-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-registry.test.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-process-manager/history/undo-registry.test.ts"],"names":[],"mappings":""}

package/dist/types/src/plugin-process-manager/index.d.ts

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

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

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

package/dist/types/src/plugin-process-manager/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../src/plugin-process-manager/meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,IAOzB,CAAC"}

package/dist/types/src/plugin-process-manager/process-manager-capability.d.ts

@@ -0,0 +1,8 @@
+import * as Effect from 'effect/Effect';
+import { Process, ServiceResolver } from '@dxos/compute';
+import { OperationInvoker } from '@dxos/operation';
+import { Capabilities } from '../common';
+import { Capability, Plugin } from '../core';
+declare const _default: (props: void) => Effect.Effect<[Capability.Capability<Capability.InterfaceDef<Capabilities.ProcessManagerRuntime>>, Capability.Capability<Capability.InterfaceDef<ServiceResolver.ServiceResolver>>, Capability.Capability<Capability.InterfaceDef<Process.Monitor>>, Capability.Capability<Capability.InterfaceDef<OperationInvoker.OperationInvoker>>], Error, Plugin.Service | Capability.Service>;
+export default _default;
+//# sourceMappingURL=process-manager-capability.d.ts.map

package/dist/types/src/plugin-process-manager/process-manager-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager-capability.d.ts","sourceRoot":"","sources":["../../../../src/plugin-process-manager/process-manager-capability.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAkC,OAAO,EAAE,eAAe,EAAS,MAAM,eAAe,CAAC;AAKhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAoB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/src/plugin-process-manager/testing.d.ts

@@ -0,0 +1,59 @@
+import * as Effect from 'effect/Effect';
+import { Operation } from '@dxos/compute';
+import { OperationInvoker } from '@dxos/operation';
+export declare const Compute: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>;
+export declare const HalveCompute: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>;
+export declare const ToString: Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly string: string;
+}, never>;
+export declare const Add: Operation.Definition<readonly [number, number], number, never>;
+export declare const SideEffect: Operation.Definition<void, void, never>;
+export declare const computeHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>>;
+export declare const halveComputeHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly value: number;
+}, never>>;
+export declare const toStringHandler: Operation.WithHandler<Operation.Definition<{
+    readonly value: number;
+}, {
+    readonly string: string;
+}, never>>;
+export declare const addHandler: Operation.WithHandler<Operation.Definition<readonly [number, number], number, never>>;
+export declare const sideEffectHandler: Operation.WithHandler<Operation.Definition<void, void, never>>;
+/**
+ * Event collector for testing - provides deterministic event collection using Effect primitives.
+ */
+export interface EventCollector {
+    /** All collected events. */
+    readonly events: OperationInvoker.InvocationEvent[];
+    /** Wait until N events have been collected. */
+    waitForEvents: (count: number) => Effect.Effect<void>;
+    /** Clean up the subscription fiber. */
+    dispose: Effect.Effect<void>;
+}
+/**
+ * Creates an event collector that subscribes to invoker events.
+ * Uses Effect primitives for synchronization.
+ */
+export declare const createEventCollector: (invoker: OperationInvoker.OperationInvoker) => Effect.Effect<EventCollector>;
+/**
+ * Waits until a condition is true, yielding to the JS event loop between checks.
+ * Uses setImmediate to allow other async work to complete.
+ */
+export declare const waitUntil: (condition: () => boolean) => Effect.Effect<void>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/types/src/plugin-process-manager/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../src/plugin-process-manager/testing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,eAAO,MAAM,OAAO;;;;SAIlB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;SAIvB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;SAInB,CAAC;AAEH,eAAO,MAAM,GAAG,gEAId,CAAC;AAEH,eAAO,MAAM,UAAU,yCAIrB,CAAC;AAMH,eAAO,MAAM,cAAc;;;;UAK1B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;UAE/B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;UAE3B,CAAC;AAEF,eAAO,MAAM,UAAU,uFAA0E,CAAC;AAElG,eAAO,MAAM,iBAAiB,gEAAqE,CAAC;AAMpG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,eAAe,EAAE,CAAC;IACpD,+CAA+C;IAC/C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAAa,gBAAgB,CAAC,gBAAgB,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAoD1G,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,MAAM,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAKnE,CAAC"}

package/dist/types/src/testing/harness.d.ts

@@ -0,0 +1,79 @@
+import { type Registry } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
+import { type Operation } from '@dxos/compute';
+import { Capabilities } from '../common';
+import { ActivationEvent, type Capability, type CapabilityManager, type Plugin, PluginManager } from '../core';
+export type TestAppOptions = {
+    /**
+     * Plugins to register. Plugins whose `meta.tags` includes `'system'` are treated as core
+     * (force-enabled). For test convenience, plugins without a `'system'` tag are enabled by
+     * default unless `enabled` is provided.
+     */
+    plugins: Plugin.Plugin[];
+    /** Plugin ids that are enabled by default in addition to core. Defaults to all non-system plugin ids. */
+    enabled?: string[];
+    /** Additional activation events fired alongside SetupReactSurface. */
+    setupEvents?: ActivationEvent.ActivationEvent[];
+    /**
+     * Whether to automatically fire SetupReactSurface + Startup during setup.
+     * Defaults to true.
+     */
+    autoStart?: boolean;
+    /**
+     * Whether to register the PluginManager + AtomRegistry framework capabilities.
+     * Defaults to true.
+     */
+    registerFrameworkCapabilities?: boolean;
+};
+/**
+ * A running plugin manager plus helpers for driving it in tests.
+ */
+export interface TestHarness {
+    readonly manager: PluginManager.PluginManager;
+    readonly capabilities: CapabilityManager.CapabilityManager;
+    readonly registry: Registry.Registry;
+    /** Activate the given event. Equivalent to `manager.activate(event)`. */
+    fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;
+    /** Re-activate all modules that were activated by the given event. */
+    reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;
+    /** Returns the first contributed capability for the given interface. Throws if none are present. */
+    get<T>(iface: Capability.InterfaceDef<T>): T;
+    /** Returns all contributed capabilities for the given interface. */
+    getAll<T>(iface: Capability.InterfaceDef<T>): T[];
+    /** Waits until at least one capability is contributed for the given interface. */
+    waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: {
+        timeout?: number;
+    }): Promise<T>;
+    /** Waits until the given activation event has completed. */
+    waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: {
+        timeout?: number;
+    }): Promise<void>;
+    /** Invokes an operation through the `Capabilities.OperationInvoker` capability. */
+    invoke<I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]): Promise<O>;
+    /**
+     * Waits for `Capabilities.ProcessManagerRuntime` and runs the given effect on it.
+     * Convenience around `waitForCapability(ProcessManagerRuntime).runPromise(effect)`.
+     */
+    runPromise<A, E>(effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>, options?: {
+        readonly timeout?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<A>;
+    enable(id: string): Promise<boolean>;
+    disable(id: string): Promise<boolean>;
+    /** Shuts down the underlying plugin manager. */
+    dispose(): Promise<void>;
+    /** Async-disposable support so tests can use `await using harness = ...`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Creates a TestHarness with the same bootstrap sequence that `useApp` performs,
+ * minus the React provider tree.
+ *
+ * For Node-only tests, this is enough to fire activation events, read
+ * capabilities, and invoke operations.
+ *
+ * For React tests, pass the returned harness to `render` or `renderSurface`
+ * from `@dxos/app-framework/testing-react`.
+ */
+export declare const createTestApp: (opts: TestAppOptions) => Promise<TestHarness>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/types/src/testing/harness.d.ts.map

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

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

@@ -1,3 +1,4 @@
+export * from './harness';
 export * from './service';
 export * from './withPluginManager';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+import { type RenderOptions, type RenderResult } from '@testing-library/react';
+import { type FC, type PropsWithChildren, type ReactNode } from 'react';
+import { type TestHarness } from './harness';
+export type HarnessRenderOptions = Omit<RenderOptions, 'wrapper'> & {
+    /** Additional providers to wrap around the harness tree (applied innermost first). */
+    reactContexts?: FC<PropsWithChildren>[];
+};
+/**
+ * Renders `ui` wrapped in the same provider tree as `useApp` plus every contributed
+ * `Capabilities.ReactContext`.
+ */
+export declare const render: (harness: TestHarness, ui: ReactNode, options?: HarnessRenderOptions) => RenderResult;
+export type RenderSurfaceProps = {
+    role: string;
+    data?: unknown;
+    limit?: number;
+    fallback?: FC<{
+        error: Error;
+        data?: any;
+    }>;
+    placeholder?: ReactNode;
+};
+/**
+ * Renders a `Surface` with the given role/data inside the harness provider tree.
+ */
+export declare const renderSurface: (harness: TestHarness, props: RenderSurfaceProps, options?: HarnessRenderOptions) => RenderResult;
+//# sourceMappingURL=react.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/testing/react.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAc,EAAE,KAAK,EAAE,EAAY,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG;IAClE,sFAAsF;IACtF,aAAa,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAa,WAAW,MAAM,SAAS,YAAY,oBAAoB,KAAG,YAQ5F,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,EAAE,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,YACf,WAAW,SACb,kBAAkB,YACf,oBAAoB,KAC7B,YAOF,CAAC"}

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

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

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

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

package/dist/types/src/testing/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/testing/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAKtC,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,8CAmCjD,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/testing/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAKtC,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,CAAC,MAAM,EAAE,8CAmCjD,CAAC"}

package/dist/types/src/testing/withPluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrE,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAyB,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,OAAO,CAAC;AA+BnD,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG;IACrD,kBAAkB;IAClB,YAAY,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACpF,kBAAkB;IAClB,UAAU,CAAC,EAAE,CAAC,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,4BAA4B,CAAC,IAAI,GAAG,IAAI,IAChD,wBAAwB,GACxB,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,wBAAwB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,IAAI,EAAG,OAAM,4BAA4B,CAAC,IAAI,CAAM,KAAG,SAmCxF,CAAC"}
+{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrE,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAyB,MAAM,SAAS,CAAC;AAC1G,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,OAAO,CAAC;AAwCnD,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG;IACrD,kBAAkB;IAClB,YAAY,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACpF,kBAAkB;IAClB,UAAU,CAAC,EAAE,CAAC,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,4BAA4B,CAAC,IAAI,GAAG,IAAI,IAChD,wBAAwB,GACxB,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,wBAAwB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,IAAI,SAAS,4BAA4B,CAAC,IAAI,CAAC,KAAQ,SAuCxF,CAAC"}

package/dist/types/src/testing/withPluginManager.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAoB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;AAEtC,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}
+{"version":3,"file":"withPluginManager.stories.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAmB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

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

@@ -1,8 +1,9 @@
 import React from 'react';
-import { type UseAppOptions } from '../../hooks';
+import { type StartupProgress, type UseAppOptions } from '../../hooks';
 export type AppProps = Pick<UseAppOptions, 'placeholder' | 'debounce'> & {
     ready: boolean;
     error: unknown;
+    progress?: StartupProgress;
 };
-export declare const App: ({ placeholder: Placeholder, ready, error, debounce }: AppProps) => React.JSX.Element | null;
+export declare const App: ({ placeholder: Placeholder, ready, error, debounce, progress }: AppProps) => React.JSX.Element | null;
 //# sourceMappingURL=App.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAiC,MAAM,OAAO,CAAC;AAItD,OAAO,EAAgB,KAAK,aAAa,EAA+B,MAAM,aAAa,CAAC;AAE5F,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,sDAAsD,QAAQ,6BA2BjF,CAAC"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA4C,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,aAAa,EAA+B,MAAM,aAAa,CAAC;AAElH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,GAAG,mEAAoE,QAAQ,6BAgD3F,CAAC"}

package/dist/types/src/ui/components/App/App.stories.d.ts

@@ -1,12 +1,12 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 import { Plugin } from '../../../core';
-type StoryProps = {
+type DefaultStoryProps = {
     plugins?: Plugin.Plugin[];
 };
 declare const meta: {
     title: string;
-    render: ({ plugins }: StoryProps) => React.JSX.Element;
+    render: ({ plugins }: DefaultStoryProps) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;

package/dist/types/src/ui/components/App/App.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAoB,MAAM,OAAO,CAAC;AAKzC,OAAO,EAAc,MAAM,EAAE,MAAM,eAAe,CAAC;AAuCnD,KAAK,UAAU,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;CAAE,CAAC;AAkBhD,QAAA,MAAM,IAAI;;0BAhByB,UAAU;;;;;CAuB7B,CAAC;AAEjB,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}
+{"version":3,"file":"App.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAoB,MAAM,OAAO,CAAC;AAKzC,OAAO,EAAc,MAAM,EAAE,MAAM,eAAe,CAAC;AAsCnD,KAAK,iBAAiB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;CAAE,CAAC;AAavD,QAAA,MAAM,IAAI;;0BAXyB,iBAAiB;;;QAgBhD,MAAM;;CAEM,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}

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

@@ -0,0 +1,64 @@
+import React, { type ReactNode } from 'react';
+import { type PlaceholderProps as PlaceholderSlotProps } from '../../hooks';
+declare global {
+    interface Window {
+        /**
+         * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`.
+         * Declared here so the {@link Placeholder} can dismiss the native-DOM
+         * loader once the React placeholder commits without each host having to
+         * re-declare the type.
+         */
+        __bootLoader?: {
+            status: (payload: {
+                event?: string;
+                module?: string;
+                humanized: string;
+                /**
+                 * Optional `(index/total)` tick. When present, the loader replaces the
+                 * current line in place ("Loading plugins (12/80)") instead of
+                 * appending a new entry — keeps the visible log compact during long
+                 * counted phases like plugin chunk-loading or module activation.
+                 */
+                range?: {
+                    index: number;
+                    total: number;
+                };
+            }) => void;
+            progress: (fraction?: number) => void;
+            dismiss: () => void;
+        };
+    }
+}
+export type PlaceholderComponentProps = PlaceholderSlotProps & {
+    /**
+     * Brand mark rendered while the React tree settles. Pass either a static
+     * `ReactNode` (the framework wraps it in a sizing/animation div) or a
+     * render function that receives the precomputed `className` so the host
+     * can apply it directly to its logo (e.g. an SVG that accepts `className`
+     * — `composer-app` passes `(p) => <Composer {...p} />` from `@dxos/brand`).
+     */
+    logo?: ReactNode | ((props: {
+        className: string;
+    }) => ReactNode);
+};
+/**
+ * React placeholder. The native-DOM boot loader is the visible UI through
+ * stages 0 (Loading) and 1 (FadeIn): we render `null` until `stage >= 2`
+ * (FadeOut) and instead feed activation progress + status into the still-
+ * alive boot loader. At stage 2 the loader dismisses and the React mark
+ * appears for the cross-fade to the real shell:
+ *
+ *   - composer-app fills `0 → 50%` from `getPlugins`'s per-chunk counter.
+ *   - this component fills `50 → 100%` from `useApp`'s
+ *     `startupProgress.progress` (`activated / total` modules) and pushes
+ *     the per-module status text to the loader's status line.
+ *   - at `stage >= 2` the boot loader is dismissed and the React mark
+ *     starts its `FadeOut → Done` shrink-and-fade.
+ *
+ * Stage progression (driven by `useApp`):
+ *   - `0` — Loading: native-DOM boot loader visible. Placeholder renders nothing.
+ *   - `1` — FadeIn: same — boot loader still owns the screen.
+ *   - `2` — FadeOut: boot loader dismissed, React mark visible at full opacity then shrinks.
+ */
+export declare const Placeholder: ({ stage, progress, logo }: PlaceholderComponentProps) => React.JSX.Element | null;
+//# sourceMappingURL=Placeholder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Placeholder.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Placeholder/Placeholder.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAKlF,OAAO,EAAE,KAAK,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,MAAM;QACd;;;;;WAKG;QACH,YAAY,CAAC,EAAE;YACb,MAAM,EAAE,CAAC,OAAO,EAAE;gBAChB,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChB,SAAS,EAAE,MAAM,CAAC;gBAClB;;;;;mBAKG;gBACH,KAAK,CAAC,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC1C,KAAK,IAAI,CAAC;YACX,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YACtC,OAAO,EAAE,MAAM,IAAI,CAAC;SACrB,CAAC;KACH;CACF;AAED,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,8BAAmC,yBAAyB,6BAsFnF,CAAC"}

package/dist/types/src/ui/components/Placeholder/Placeholder.stories.d.ts

@@ -0,0 +1,19 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+/**
+ * The story renders the brand-agnostic `Placeholder` from `@dxos/app-framework/ui`
+ * with the Composer brand icon as its `logo`, so the storybook mirrors what
+ * composer-app actually mounts in production. The render function form lets
+ * the SVG accept the placeholder's animation `className` directly.
+ */
+declare const meta: {
+    title: string;
+    component: ({ stage, progress, logo }: import("./Placeholder").PlaceholderComponentProps) => React.JSX.Element | null;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=Placeholder.stories.d.ts.map

package/dist/types/src/ui/components/Placeholder/Placeholder.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Placeholder.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Placeholder/Placeholder.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA8B,MAAM,OAAO,CAAC;AASnD;;;;;GAKG;AACH,QAAA,MAAM,IAAI;;;;;;CAwC0B,CAAC;eAEtB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC"}

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

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

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

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

package/dist/types/src/ui/components/PluginManager/PluginManagerContext.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginManagerContext.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/PluginManager/PluginManagerContext.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAuC,MAAM,OAAO,CAAC;AAoK5D,QAAA,MAAM,IAAI;;;;;;;CAOM,CAAC;AAEjB,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAM,CAAC"}
+{"version":3,"file":"PluginManagerContext.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/PluginManager/PluginManagerContext.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAuC,MAAM,OAAO,CAAC;AAqK5D,QAAA,MAAM,IAAI;;;;;QAKN,MAAM;;CAEM,CAAC;eAEF,IAAI;AAEnB,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAM,CAAC"}

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

@@ -1,12 +1,24 @@
-import { type NamedExoticComponent, type RefAttributes } from 'react';
+import React, { type NamedExoticComponent, type RefAttributes } from 'react';
 import { type CapabilityManager } from '../../../core';
-import { type Props } from './types';
+import { type Props, type RoleToken, type TokenData, type TypedProps } from './types';
 /**
  * A surface is a named region of the screen that can be populated by plugins.
  */
-export declare const SurfaceComponent: NamedExoticComponent<Props & RefAttributes<HTMLElement>>;
+export declare const SurfaceComponent: (<TToken extends RoleToken<any>>(props: TypedProps<TToken> & RefAttributes<HTMLElement>) => React.ReactNode) & NamedExoticComponent<Props & RefAttributes<HTMLElement>>;
 /**
  * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
+ *
+ * Two overloads:
+ * - Typed: pass a `type` role token and `data` is constrained to the token's
+ *   declared contract (e.g. `AppSurface.Section` requires `attendableId`).
+ * - Legacy: pass a string `role` and `data` is untyped.
  */
-export declare const isSurfaceAvailable: (capabilityManager: CapabilityManager.CapabilityManager, { role, data }: Pick<Props, "role" | "data">) => boolean;
+export declare function isSurfaceAvailable<TToken extends RoleToken<any>>(capabilityManager: CapabilityManager.CapabilityManager, args: {
+    type: TToken;
+    data?: TokenData<TToken>;
+    role?: never;
+}): boolean;
+export declare function isSurfaceAvailable(capabilityManager: CapabilityManager.CapabilityManager, args: Pick<Props, 'role' | 'data'> & {
+    type?: undefined;
+}): boolean;
 //# sourceMappingURL=SurfaceComponent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SurfaceComponent.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceComponent.tsx"],"names":[],"mappings":"AAIA,OAAc,EAEZ,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAOnB,MAAM,OAAO,CAAC;AAQf,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,EAAmB,KAAK,KAAK,EAA+B,MAAM,SAAS,CAAC;AA0InF;;GAEG;AAEH,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,CAAC,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAoCrF,CAAC;AA+BF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,mBAAmB,iBAAiB,CAAC,iBAAiB,EACtD,gBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,YAK7C,CAAC"}
+{"version":3,"file":"SurfaceComponent.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceComponent.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAEZ,KAAK,oBAAoB,EAEzB,KAAK,aAAa,EAOnB,MAAM,OAAO,CAAC;AAQf,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAkJjB;;GAEG;AAEH,eAAO,MAAM,gBAAgB,EA6CxB,CAAC,CAAC,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAC/G,oBAAoB,CAAC,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAwC3D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAC9D,iBAAiB,EAAE,iBAAiB,CAAC,iBAAiB,EACtD,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GAC7D,OAAO,CAAC;AACX,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,iBAAiB,CAAC,iBAAiB,EACtD,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACxD,OAAO,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"SurfaceComponent.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceComponent.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA+D,MAAM,OAAO,CAAC;AA4HpF,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"}
+{"version":3,"file":"SurfaceComponent.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceComponent.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA+D,MAAM,OAAO,CAAC;AA6HpF,QAAA,MAAM,IAAI;;;;;QAKN,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"SurfaceInfo.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceInfo.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EACZ,KAAK,YAAY,EACjB,KAAK,GAAG,EAMT,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;QAAE,GAAG,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,sFA+EtB,CAAC"}
+{"version":3,"file":"SurfaceInfo.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceInfo.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EACZ,KAAK,YAAY,EACjB,KAAK,GAAG,EAMT,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;QAAE,GAAG,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,sFA8EtB,CAAC"}

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,iBAAkB,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"}