@dxos/app-framework 0.10.0 → 0.11.1

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

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/testing/react.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAuB,MAAM,wBAAwB,CAAC;AACpG,OAAc,EAAE,KAAK,EAAE,EAAY,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,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,CAAC,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,IAAI;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACrD,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,GAAI,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,WAChD,WAAW,SACb,kBAAkB,CAAC,MAAM,CAAC,YACvB,oBAAoB,KAC7B,YAOF,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/testing/react.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAuB,MAAM,wBAAwB,CAAC;AACpG,OAAc,EAAE,KAAK,EAAE,EAAY,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAKlG,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAOvC,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,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACrD,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,GAAI,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAChD,WAAW,SACb,kBAAkB,CAAC,MAAM,CAAC,YACvB,oBAAoB,KAC7B,YAOF,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;AAQrE,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;AA0CnD,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"}
+{"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;AAQrE,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;AA4CnD,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,SAwCxF,CAAC"}

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

@@ -8,4 +8,10 @@ declare const meta: {
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
+/**
+ * Demonstrates `withPluginManager`'s default fallback (`StorybookErrorFallback`): when the app
+ * throws, the theme-independent `ErrorFallback` renders with a "Download logs" button alongside
+ * the usual "Copy" action.
+ */
+export declare const Crashes: Story;
 //# sourceMappingURL=withPluginManager.stories.d.ts.map

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;AAqB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;eAEvB,IAAI;AAEnB,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;AAuB1B,QAAA,MAAM,IAAI;;;;CAkB2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,KAMrB,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type Decorator } from '@storybook/react';
+/**
+ * Storybook decorator that enables the surface debug overlays (`<dx-surface>` wrappers + boundary
+ * badges) for the wrapped story. The flag is a `window` singleton, so it is (re)applied on every
+ * render — enabling it on decorated stories and clearing it otherwise, so the setting never leaks
+ * between stories. Prefer this over the `.storybook/preview` flag when the story must also render
+ * under the aggregate root Storybook, which does not load a per-package preview.
+ */
+export declare const withSurfaceDebug: (enabled?: boolean) => Decorator;
+//# sourceMappingURL=withSurfaceDebug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withSurfaceDebug.d.ts","sourceRoot":"","sources":["../../../../src/testing/withSurfaceDebug.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,yBACT,SAIjB,CAAC"}

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

@@ -1,37 +1,5 @@
 import React from 'react';
 import { type StartupProgress, type UseAppOptions } from '../../hooks';
-declare global {
-    interface Window {
-        /**
-         * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`
-         * (a Solid app inlined into `index.html`). Declared here — on a module that
-         * is part of the `@dxos/app-framework/ui` export surface — so the React side
-         * and host apps (e.g. composer-app) can drive the loader without each
-         * re-declaring the type. The canonical definition lives in the plugin's
-         * `loader-app/types.ts`; this mirror exists because that source compiles in a
-         * separate (Solid) program that doesn't ship its globals to consumers.
-         */
-        __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.
-                 */
-                range?: {
-                    index: number;
-                    total: number;
-                };
-            }) => void;
-            progress: (fraction?: number) => void;
-            ready: () => void;
-            dismiss: () => void;
-        };
-    }
-}
 export type AppProps = Pick<UseAppOptions, 'debounce'> & {
     ready: boolean;
     error: unknown;

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,KAA6D,MAAM,OAAO,CAAC;AAIlF,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,aAAa,EAA+B,MAAM,aAAa,CAAC;AAElH,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,MAAM;QACd;;;;;;;;WAQG;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;;;;mBAIG;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,KAAK,EAAE,MAAM,IAAI,CAAC;YAClB,OAAO,EAAE,MAAM,IAAI,CAAC;SACrB,CAAC;KACH;CACF;AAED,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,GAAG,yCAA0C,QAAQ,6BAiFjE,CAAC"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/App.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAIlF,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,aAAa,EAA+B,MAAM,aAAa,CAAC;AAKlH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,GAAG,yCAA0C,QAAQ,6BAkFjE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,35 @@
+declare global {
+    interface 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.
+             */
+            range?: {
+                index: number;
+                total: number;
+            };
+        }) => void;
+        progress: (fraction?: number) => void;
+        ready: () => void;
+        dismiss: () => void;
+    }
+    interface Window {
+        /**
+         * Driver injected by `@dxos/app-framework/vite-plugin`'s `bootLoaderPlugin`
+         * (a Solid app inlined into `index.html`). Declared here — on a module that
+         * is part of the `@dxos/app-framework/ui` export surface — so the React side
+         * and host apps (e.g. composer-app) can drive the loader without each
+         * re-declaring the type. The canonical definition lives in the plugin's
+         * `loader-app/types.ts`; this mirror exists because that source compiles in a
+         * separate (Solid) program that doesn't ship its globals to consumers.
+         */
+        __bootLoader?: BootLoader;
+    }
+}
+export declare const bootLoader: BootLoader | undefined;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/App/loader.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,UAAU;QAClB,MAAM,EAAE,CAAC,OAAO,EAAE;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB;;;;eAIG;YACH,KAAK,CAAC,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC;SAC1C,KAAK,IAAI,CAAC;QACX,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QACtC,KAAK,EAAE,MAAM,IAAI,CAAC;QAClB,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB;IAED,UAAU,MAAM;QACd;;;;;;;;WAQG;QACH,YAAY,CAAC,EAAE,UAAU,CAAC;KAC3B;CACF;AAID,eAAO,MAAM,UAAU,wBAAkE,CAAC"}

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

@@ -0,0 +1,26 @@
+import React, { type PropsWithChildren } from 'react';
+import { type ThemedClassName } from '@dxos/react-ui';
+type HomeSectionRootProps = ThemedClassName<PropsWithChildren>;
+type HomeSectionHeaderProps = ThemedClassName<PropsWithChildren<{
+    /** Section heading. */
+    title?: string;
+    /** When provided, renders a close affordance that hides the section. */
+    onClose?: () => void;
+}>>;
+export declare const HomeSection: {
+    Root: React.ForwardRefExoticComponent<Omit<{
+        children?: React.ReactNode | undefined;
+    }, "className"> & {
+        classNames?: import("@dxos/ui-types").ClassNameValue;
+    } & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<Omit<PropsWithChildren<{
+        /** Section heading. */
+        title?: string;
+        /** When provided, renders a close affordance that hides the section. */
+        onClose?: () => void;
+    }>, "className"> & {
+        classNames?: import("@dxos/ui-types").ClassNameValue;
+    } & React.RefAttributes<HTMLDivElement>>;
+};
+export type { HomeSectionHeaderProps, HomeSectionRootProps };
+//# sourceMappingURL=HomeSection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HomeSection.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/HomeSection/HomeSection.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAc,MAAM,OAAO,CAAC;AAElE,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOxE,KAAK,oBAAoB,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;AAmB/D,KAAK,sBAAsB,GAAG,eAAe,CAC3C,iBAAiB,CAAC;IAChB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC,CACH,CAAC;AAwBF,eAAO,MAAM,WAAW;IACtB,IAAI;;;;;IACJ,MAAM;QA/BJ,uBAAuB;gBACf,MAAM;QACd,wEAAwE;kBAC9D,MAAM,IAAI;;;;CA6BvB,CAAC;AAEF,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const meta: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const WithActions: Story;
+//# sourceMappingURL=HomeSection.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HomeSection.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/HomeSection/HomeSection.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAwB1B,QAAA,MAAM,IAAI;;;;;QAIM,MAAM;;CACe,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,WAAW,EAAE,KAAoC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import React, { type PropsWithChildren } from 'react';
+export type NamePopoverProps = PropsWithChildren<{
+    open: boolean;
+    placeholder: string;
+    /** Translated label for the submit button (e.g. "Create"). */
+    submitLabel: string;
+    onSubmit: (name: string) => void;
+    onCancel: () => void;
+}>;
+export declare function NamePopover({ children, open, placeholder, submitLabel, onSubmit, onCancel }: NamePopoverProps): React.JSX.Element;
+export declare namespace NamePopover {
+    var displayName: string;
+}
+//# sourceMappingURL=NamePopover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NamePopover.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/NamePopover/NamePopover.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAY,MAAM,OAAO,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC,CAAC;oCAMyB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,gBAAgB"}

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

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

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

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

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

@@ -1,20 +1,32 @@
-import React, { type NamedExoticComponent, type RefAttributes } from 'react';
-import { type CapabilityManager } from '../../../core';
-import { type RoleToken, type TokenData, type TypedProps } from './types';
+import React, { type NamedExoticComponent } from 'react';
+import { Role } from '../../../common';
+import { type TypedProps } from './types';
 /**
  * A surface is a named region of the screen that can be populated by plugins.
- * The `type` prop is a {@link RoleToken} that defines which region and its
+ * The `type` prop is a {@link Role.Role} that defines which region and its
  * associated data contract.
+ *
+ * A surface is a boundary that may resolve to zero, one, or many components, so
+ * it intentionally accepts no `ref`; consumers needing an element should own one
+ * inside their contributed component.
  */
-export declare const SurfaceComponent: (<TToken extends RoleToken<any>>(props: TypedProps<TToken> & RefAttributes<HTMLElement>) => React.ReactNode) & NamedExoticComponent<TypedProps<RoleToken<any>> & RefAttributes<HTMLElement>>;
+export declare const SurfaceComponent: (<TToken extends Role.Role<any>>(props: TypedProps<TToken>) => React.ReactNode) & NamedExoticComponent<TypedProps<Role.Role<any>>>;
 /**
- * @returns `true` if there is a contributed surface which matches the specified role & data, `false` otherwise.
+ * Reports whether a contributed surface matches the given role & data, without mounting it.
  *
  * Typed: pass a `type` role token and `data` is constrained to the token's
  * declared contract (e.g. `AppSurface.Section` requires `attendableId`).
  */
-export declare function isSurfaceAvailable<TToken extends RoleToken<any>>(capabilityManager: CapabilityManager.CapabilityManager, args: {
+type IsSurfaceAvailable = <TToken extends Role.Role<any>>(args: {
     type: TToken;
-    data?: TokenData<TToken>;
-}): boolean;
+    data?: Role.Data<TToken>;
+}) => boolean;
+/**
+ * @returns a stable function that checks whether a contributed surface is available for a
+ * role & data. The surface manager is captured via context, so the returned function carries
+ * no dependency of its own and is safe to store and invoke later — e.g. from inside another
+ * callback such as a render-prop or event handler — since it calls no hooks itself.
+ */
+export declare const useIsSurfaceAvailable: () => IsSurfaceAvailable;
+export {};
 //# 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":"AAKA,OAAO,KAAK,EAAE,EAGZ,KAAK,oBAAoB,EAEzB,KAAK,aAAa,EAOnB,MAAM,OAAO,CAAC;AAQf,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAmKjB;;;;GAIG;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,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAwChF;;;;;GAKG;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,CAAA;CAAE,GAC/C,OAAO,CAYT"}
+{"version":3,"file":"SurfaceComponent.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceComponent.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAGZ,KAAK,oBAAoB,EAS1B,MAAM,OAAO,CAAC;AAMf,OAAO,EAAgB,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAOrD,OAAO,EAA+B,KAAK,UAAU,EAA+B,MAAM,SAAS,CAAC;AAiJpG;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAqExB,CAAC,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAClF,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AA6CnD;;;;;GAKG;AACH,KAAK,kBAAkB,GAAG,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;AAEvH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,kBAoBxC,CAAC"}

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

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

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,KAAmD,MAAM,OAAO,CAAC;AA6HxE,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"}
+{"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,KAA2C,MAAM,OAAO,CAAC;AAyDhE,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA2FF,QAAA,MAAM,IAAI;;mCAzFkC,UAAU;;;QA8FlD,MAAM;;CAE2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,40 @@
+import { type PropsWithChildren, type ReactNode } from 'react';
+import { type SurfaceContext } from './context';
+declare global {
+    interface Window {
+        __DX_DEBUG__?: boolean;
+        __DX__?: {
+            surfaces: (component?: string) => HTMLElement[];
+        };
+    }
+}
+/**
+ * Custom element tag wrapping each React surface in debug builds.
+ */
+export declare const DX_SURFACE_TAG = "dx-surface";
+/**
+ * Whether surface debugging is enabled, via the `VITE_DEBUG` build flag or the
+ * `__DX_DEBUG__` runtime global. The runtime flag is toggleable without a
+ * rebuild and takes effect on the next render.
+ */
+export declare const isSurfaceDebugEnabled: () => boolean;
+/**
+ * Whether the `<dx-surface>` wrapper is rendered. Enabled in any development build (or when
+ * `VITE_DEBUG` is set) so the wrapper's `data-*` attributes and `window.__DX__` helpers are available
+ * for DOM inspection independent of the runtime highlight flag. Production renders no wrapper.
+ */
+export declare const isSurfaceWrapperEnabled: () => boolean;
+/**
+ * Toggles the `__DX_DEBUG__` runtime flag, which gates the visual highlight overlay (not the
+ * `<dx-surface>` wrapper). The overlay redraws immediately; surfaces pick it up on their next render.
+ */
+export declare const setSurfaceDebug: (enabled: boolean) => void;
+/**
+ * Debug wrapper that mounts each React surface inside a `<dx-surface>` element
+ * and registers it with the centralized overlay. The element is named and
+ * inspectable in DevTools and queryable (`document.querySelectorAll('dx-surface')`).
+ */
+export declare const DebugSurface: ({ info, children }: PropsWithChildren<{
+    info: SurfaceContext;
+}>) => ReactNode;
+//# sourceMappingURL=SurfaceDebug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceDebug.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceDebug.tsx"],"names":[],"mappings":"AAIA,OAAc,EACZ,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAOf,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,MAAM;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,CAAC,EAAE;YAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,WAAW,EAAE,CAAA;SAAE,CAAC;KAC9D;CACF;AAID;;GAEG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC;AAuB3C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,OACwD,CAAC;AAElG;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,OAC4B,CAAC;AAYxE;;;GAGG;AACH,eAAO,MAAM,eAAe,YAAa,OAAO,KAAG,IAalD,CAAC;AA+RF;;;;GAIG;AACH,eAAO,MAAM,YAAY,uBAAwB,iBAAiB,CAAC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,KAAG,SAyC9F,CAAC"}

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

@@ -0,0 +1,23 @@
+import { Atom } from '@effect-atom/atom';
+import { type CapabilityManager } from '../../../core';
+import { type Definition } from './types';
+/**
+ * Groups definitions by role with each bucket pre-sorted by {@link Position}, so
+ * dispatch avoids a full scan and re-sort on every render. Pure helper — callers
+ * are responsible for filtering out invalid definitions before calling this.
+ */
+export declare const indexByRole: (definitions: Definition[]) => Map<string, Definition[]>;
+/**
+ * Owns the per-manager surface memoization: one derived index atom plus a per-role
+ * family of candidate atoms. A single instance is provided via
+ * {@link SurfaceManagerProvider}, so instance identity does the per-manager keying
+ * (replacing module-level WeakMaps) and `Atom.family` does the per-role keying.
+ * Atom lifecycle is tied to the provider rather than module-global state.
+ */
+export declare class SurfaceManager {
+    #private;
+    constructor(capabilities: CapabilityManager.CapabilityManager);
+    /** Derived atom yielding the (position-sorted) candidates for a single role. */
+    candidatesAtom(role: string): Atom.Atom<ReadonlyArray<Definition>>;
+}
+//# sourceMappingURL=SurfaceManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceManager.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAOzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,SAAS,CAAC;AAI1D;;;;GAIG;AACH,eAAO,MAAM,WAAW,gBAAiB,UAAU,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAiB/E,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,cAAc;;IAuBzB,YAAY,YAAY,EAAE,iBAAiB,CAAC,iBAAiB,EAE5D;IAED,gFAAgF;IAChF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAEjE;CAiBF"}

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

@@ -0,0 +1,11 @@
+import { type SurfaceManager } from './SurfaceManager';
+/**
+ * Get the surface manager. Throws when rendered outside a {@link SurfaceManagerProvider};
+ * surfaces already hard-require the plugin-manager context, so there is no optional variant.
+ */
+export declare const useSurfaceManager: () => SurfaceManager;
+/**
+ * Context provider for a surface manager.
+ */
+export declare const SurfaceManagerProvider: import("react").Provider<SurfaceManager | undefined>;
+//# sourceMappingURL=SurfaceManagerContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceManagerContext.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceManagerContext.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,cACmD,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,sBAAsB,sDAAiC,CAAC"}

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

@@ -0,0 +1,72 @@
+/**
+ * Per-surface dev metrics, complementing the render-timing data collected by the
+ * React Profiler ({@link SurfaceProfilerStats}). Captures dispatch-level signals
+ * the Profiler cannot see: how many candidates matched, whether the consumer's
+ * `data` prop is referentially unstable (the most common Surface footgun), error
+ * boundary trips, and mount churn.
+ *
+ * Keyed by the same `surface/<id>/<role>` identifier the Profiler uses, so the
+ * two can be joined in the devtools panel.
+ */
+export type SurfaceMetric = {
+    /** `surface/<id>/<role>`. */
+    id: string;
+    /** Surface definition id. */
+    surfaceId: string;
+    /** Resolved role NSID. */
+    role: string;
+    /** Number of times the dispatcher resolved candidates for this surface. */
+    dispatches: number;
+    /** Candidates matched on the last dispatch. */
+    candidates: number;
+    /** `true` when more candidates matched than `limit` rendered. */
+    truncated: boolean;
+    /** `true` when the `data` prop identity churns across renders without changing value. */
+    dataUnstable: boolean;
+    /** Consecutive renders where `data` identity changed but value did not. */
+    dataChurn: number;
+    /** Error boundary trips. */
+    errors: number;
+    /** Mounts of the matched component. */
+    mounts: number;
+    /** Unmounts of the matched component. */
+    unmounts: number;
+};
+export declare const surfaceMetricKey: (surfaceId: string, role: string) => string;
+/**
+ * Singleton store of surface dev metrics. A module singleton (rather than a React
+ * context) so the debug overlay — which renders in its own root outside the app's
+ * provider tree — can read the same data as the in-app devtools panel.
+ */
+declare class SurfaceMetricsStore {
+    #private;
+    /**
+     * Records a dispatch. `previousData` is the consumer's prior `data` reference;
+     * the store derives churn/instability from the identity-vs-value comparison.
+     */
+    recordDispatch(surfaceId: string, role: string, args: {
+        candidates: number;
+        truncated: boolean;
+        dataChurn: number;
+    }): void;
+    recordError(surfaceId: string, role: string): void;
+    recordMount(surfaceId: string, role: string): void;
+    recordUnmount(surfaceId: string, role: string): void;
+    clear(): void;
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => SurfaceMetric[];
+}
+export declare const surfaceMetrics: SurfaceMetricsStore;
+/**
+ * Updates the running churn count for a consumer's `data` prop.
+ *
+ * @returns the new churn count (0 when `data` changed value or is unchanged).
+ */
+export declare const nextDataChurn: (previous: unknown, next: unknown, churn: number) => number;
+/**
+ * Subscribes to surface dev metrics, sorted with the most concerning first
+ * (unstable data, then errors, then dispatch count).
+ */
+export declare const useSurfaceMetrics: () => SurfaceMetric[];
+export {};
+//# sourceMappingURL=SurfaceMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceMetrics.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceMetrics.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,YAAY,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAKF,eAAO,MAAM,gBAAgB,cAAe,MAAM,QAAQ,MAAM,KAAG,MAAwC,CAAC;AAqB5G;;;;GAIG;AACH,cAAM,mBAAmB;;IA4BvB;;;OAGG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAClE,IAAI,CAQN;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGjD;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGjD;IAED,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGnD;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,SAAS,aAAc,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK9C;IAEF,WAAW,QAAO,aAAa,EAAE,CAAmB;CAuBrD;AAED,eAAO,MAAM,cAAc,qBAA4B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,aAAa,aAAc,OAAO,QAAQ,OAAO,SAAS,MAAM,KAAG,MAU/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,aAAa,EASjD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"SurfaceProfilerContext.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceProfilerContext.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAEZ,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EAMvB,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"}
+{"version":3,"file":"SurfaceProfilerContext.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/SurfaceProfilerContext.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAEZ,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EAMvB,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;AA6EF;;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"}

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

@@ -1,43 +1,38 @@
-import type { DXN } from '@dxos/keys';
+import { Role } from '../../../common';
 import { SurfaceContext } from './context';
-import { isSurfaceAvailable } from './SurfaceComponent';
-import { type SurfaceBinding as SurfaceBindingType, type Definition as SurfaceDefinition, type SurfaceFilter as SurfaceFilterType, type RoleToken as SurfaceRoleToken, type TokenData as SurfaceTokenData, type TypedProps as SurfaceTypedProps, create as createSurface, createWeb as createWebSurface } from './types';
+import { type SurfaceMetric } from './SurfaceMetrics';
+import { type Binding as SurfaceBindingType, type ComponentProps as SurfaceComponentPropsType, type Definition as SurfaceDefinition, type Filter as SurfaceFilterType, type TypedProps as SurfaceTypedProps, create as createSurface, createWeb as createWebSurface } from './types';
 export declare namespace Surface {
     type Definition = SurfaceDefinition;
     const create: typeof createSurface;
     const createWeb: typeof createWebSurface;
     type Context = SurfaceContext;
     const Context: import("react").Context<SurfaceContext | undefined>;
-    const Surface: (<TToken extends SurfaceRoleToken<any>>(props: SurfaceTypedProps<TToken> & import("react").RefAttributes<HTMLElement>) => React.ReactNode) & import("react").NamedExoticComponent<{
-        fallback?: import("react").FC<{
-            error: Error;
-            data?: any;
-        }>;
-        placeholder?: import("react").ReactNode;
-        id?: string;
-        type: SurfaceRoleToken<any>;
-        data?: any;
-        limit?: number | undefined;
-    } & {
-        [x: string]: any;
-    } & import("react").RefAttributes<HTMLElement>>;
-    const isAvailable: typeof isSurfaceAvailable;
-    type RoleToken<TData> = SurfaceRoleToken<TData>;
+    const Surface: (<TToken extends Role.Role<any>>(props: SurfaceTypedProps<TToken>) => React.ReactNode) & import("react").NamedExoticComponent<SurfaceTypedProps<Role.Role<any>>>;
+    const useIsAvailable: () => <TToken extends Role.Role<any>>(args: {
+        type: TToken;
+        data?: Role.Data<TToken>;
+    }) => boolean;
     type Binding = SurfaceBindingType;
     type Filter<TData> = SurfaceFilterType<TData>;
-    type TokenData<T> = SurfaceTokenData<T>;
-    type TypedProps<TToken extends SurfaceRoleToken<any>> = SurfaceTypedProps<TToken>;
-    /** Mints a typed role token. The NSID is validated at compile time via {@link DXN.Name}. */
-    const makeType: {
-        <TData = unknown, T extends string = string>(nsid: [DXN.Name<T>] extends [never] ? `Invalid NSID "${T}": final segment must be camelCase (no hyphens)` : T): SurfaceRoleToken<TData>;
-    };
-    const makeFilter: <TData>(token: SurfaceRoleToken<TData>, guard?: (data: TData) => boolean) => SurfaceFilterType<TData>;
+    const makeFilter: <TData>(token: Role.Role<TData>, guard?: (data: TData) => boolean) => SurfaceFilterType<TData>;
     const isFilter: (value: unknown) => value is SurfaceFilterType<any>;
+    type TypedProps<TToken extends Role.Role<any>> = SurfaceTypedProps<TToken>;
+    /** Props a matched surface component receives, and the input to a definition's `props` mapper. */
+    type ComponentProps<T extends Record<string, any> = Record<string, any>> = SurfaceComponentPropsType<T>;
+    const isDebugEnabled: () => boolean;
+    const setDebug: (enabled: boolean) => void;
     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;
+    type Metric = SurfaceMetric;
+    const useMetrics: () => SurfaceMetric[];
+    const clearMetrics: () => void;
 }
 export type { SurfaceProfilerEntry, SurfaceProfilerStats } from './SurfaceProfilerContext';
+export type { SurfaceMetric } from './SurfaceMetrics';
+export { SurfaceManager } from './SurfaceManager';
+export { SurfaceManagerProvider, useSurfaceManager } from './SurfaceManagerContext';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAoB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAQ1E,OAAO,EACL,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,UAAU,IAAI,iBAAiB,EACpC,KAAK,aAAa,IAAI,iBAAiB,EACvC,KAAK,SAAS,IAAI,gBAAgB,EAClC,KAAK,SAAS,IAAI,gBAAgB,EAClC,KAAK,UAAU,IAAI,iBAAiB,EACpC,MAAM,IAAI,aAAa,EACvB,SAAS,IAAI,gBAAgB,EAI9B,MAAM,SAAS,CAAC;AAEjB,yBAAiB,OAAO,CAAC,CAAC;IACxB,KAAY,UAAU,GAAG,iBAAiB,CAAC;IACpC,MAAM,MAAM,sBAAgB,CAAC;IAC7B,MAAM,SAAS,yBAAmB,CAAC;IAE1C,KAAY,OAAO,GAAG,cAAc,CAAC;IAC9B,MAAM,OAAO,qDAAiB,CAAC;IAE/B,MAAM,OAAO;;;;;;;;;;;;mDAAmB,CAAC;IACjC,MAAM,WAAW,2BAAqB,CAAC;IAE9C,KAAY,SAAS,CAAC,KAAK,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvD,KAAY,OAAO,GAAG,kBAAkB,CAAC;IACzC,KAAY,MAAM,CAAC,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrD,KAAY,SAAS,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/C,KAAY,UAAU,CAAC,MAAM,SAAS,gBAAgB,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEzF,4FAA4F;IACrF,MAAM,QAAQ,EAAE;QACrB,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACzC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,iDAAiD,GAAG,CAAC,GAC5G,gBAAgB,CAAC,KAAK,CAAC,CAAC;KACf,CAAC;IAER,MAAM,UAAU,uGAAe,CAAC;IAChC,MAAM,QAAQ,qDAAoB,CAAC;IAEnC,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/Surface/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,KAAK,aAAa,EAAqC,MAAM,kBAAkB,CAAC;AAQzF,OAAO,EACL,KAAK,OAAO,IAAI,kBAAkB,EAClC,KAAK,cAAc,IAAI,yBAAyB,EAChD,KAAK,UAAU,IAAI,iBAAiB,EACpC,KAAK,MAAM,IAAI,iBAAiB,EAChC,KAAK,UAAU,IAAI,iBAAiB,EACpC,MAAM,IAAI,aAAa,EACvB,SAAS,IAAI,gBAAgB,EAG9B,MAAM,SAAS,CAAC;AAEjB,yBAAiB,OAAO,CAAC,CAAC;IACxB,KAAY,UAAU,GAAG,iBAAiB,CAAC;IACpC,MAAM,MAAM,sBAAgB,CAAC;IAC7B,MAAM,SAAS,yBAAmB,CAAC;IAE1C,KAAY,OAAO,GAAG,cAAc,CAAC;IAC9B,MAAM,OAAO,qDAAiB,CAAC;IAE/B,MAAM,OAAO,kKAAmB,CAAC;IACjC,MAAM,cAAc;;;iBAAwB,CAAC;IAEpD,KAAY,OAAO,GAAG,kBAAkB,CAAC;IACzC,KAAY,MAAM,CAAC,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,UAAU,gGAAe,CAAC;IAChC,MAAM,QAAQ,qDAAa,CAAC;IAEnC,KAAY,UAAU,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAElF,kGAAkG;IAClG,KAAY,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAExG,MAAM,cAAc,eAAwB,CAAC;IAC7C,MAAM,QAAQ,4BAAkB,CAAC;IAEjC,MAAM,gBAAgB,kFAA0B,CAAC;IACjD,MAAM,mBAAmB,4DAA6B,CAAC;IACvD,MAAM,kBAAkB,0EAA4B,CAAC;IACrD,MAAM,gBAAgB,iEAA0B,CAAC;IACjD,MAAM,gBAAgB,gCAA0B,CAAC;IAExD,KAAY,MAAM,GAAG,aAAa,CAAC;IAC5B,MAAM,UAAU,uBAAoB,CAAC;IACrC,MAAM,YAAY,YAA+B,CAAC;CAC1D;AAED,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}