@signal9/era-ui 22.0.0 → 23.0.0

package/dist/ui/dropdown-menu/dropdown-menu-sub-trigger.svelte

@@ -1,14 +1,14 @@
 <script lang="ts">
 	import { DropdownMenu } from 'bits-ui';
 	import ChevronRight from '@lucide/svelte/icons/chevron-right';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
 		children,
 		class: className,
 		...restProps
-	}: PartProps<DropdownMenu.SubTriggerProps> = $props();
+	}: OwnedPartProps<DropdownMenu.SubTriggerProps> = $props();
 </script>
 
 <DropdownMenu.SubTrigger

package/dist/ui/dropdown-menu/dropdown-menu-sub-trigger.svelte.d.ts

@@ -1,5 +1,5 @@
 import { DropdownMenu } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const DropdownMenuSubTrigger: import("svelte").Component<PartProps<DropdownMenu.SubTriggerProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const DropdownMenuSubTrigger: import("svelte").Component<OwnedPartProps<DropdownMenu.SubTriggerProps>, {}, "ref">;
 type DropdownMenuSubTrigger = ReturnType<typeof DropdownMenuSubTrigger>;
 export default DropdownMenuSubTrigger;

package/dist/ui/dropdown-menu/dropdown-menu-trigger.svelte

@@ -1,14 +1,22 @@
 <script lang="ts">
+	import { getAxisRelay } from '../provider/axis-relay.svelte.js';
 	import { DropdownMenu } from 'bits-ui';
 	import ChevronDown from '@lucide/svelte/icons/chevron-down';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
 		children,
 		class: className,
 		...restProps
-	}: PartProps<DropdownMenu.TriggerProps> = $props();
+	}: OwnedPartProps<DropdownMenu.TriggerProps> = $props();
+
+	// The trigger is the last node still inside the subtree, so it is the
+	// anchor the axes are read FROM when the content opens.
+	const relay = getAxisRelay();
+	$effect(() => {
+		relay?.register(ref);
+	});
 </script>
 
 <DropdownMenu.Trigger

package/dist/ui/dropdown-menu/dropdown-menu-trigger.svelte.d.ts

@@ -1,5 +1,5 @@
 import { DropdownMenu } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const DropdownMenuTrigger: import("svelte").Component<PartProps<DropdownMenu.TriggerProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const DropdownMenuTrigger: import("svelte").Component<OwnedPartProps<DropdownMenu.TriggerProps>, {}, "ref">;
 type DropdownMenuTrigger = ReturnType<typeof DropdownMenuTrigger>;
 export default DropdownMenuTrigger;

package/dist/ui/dropdown-menu/index.d.ts

@@ -1,5 +1,5 @@
 import { DropdownMenu } from 'bits-ui';
-export declare const Root: typeof DropdownMenu.Root;
+export { default as Root } from './dropdown-menu-root.svelte';
 export declare const Group: typeof DropdownMenu.Group;
 export declare const RadioGroup: typeof DropdownMenu.RadioGroup;
 export declare const Sub: typeof DropdownMenu.Sub;

package/dist/ui/dropdown-menu/index.js

@@ -1,5 +1,5 @@
 import { DropdownMenu } from 'bits-ui';
-export const Root = DropdownMenu.Root;
+export { default as Root } from './dropdown-menu-root.svelte';
 export const Group = DropdownMenu.Group;
 export const RadioGroup = DropdownMenu.RadioGroup;
 export const Sub = DropdownMenu.Sub;

package/dist/ui/index.d.ts

@@ -23,6 +23,7 @@ export * as Dialog from './dialog/index.js';
 export * as DropdownMenu from './dropdown-menu/index.js';
 export { FileUpload } from './file-upload/index.js';
 export * as Menubar from './menubar/index.js';
+export * as Nav from './nav/index.js';
 export * as Menu from './menu/index.js';
 export { Meter } from './meter/index.js';
 export { Progress } from './progress/index.js';

package/dist/ui/index.js

@@ -23,6 +23,7 @@ export * as Dialog from './dialog/index.js';
 export * as DropdownMenu from './dropdown-menu/index.js';
 export { FileUpload } from './file-upload/index.js';
 export * as Menubar from './menubar/index.js';
+export * as Nav from './nav/index.js';
 export * as Menu from './menu/index.js';
 export { Meter } from './meter/index.js';
 export { Progress } from './progress/index.js';

package/dist/ui/link-preview/index.d.ts

@@ -1,5 +1,5 @@
 import { LinkPreview } from 'bits-ui';
-export declare const Root: typeof LinkPreview.Root;
+export { default as Root } from './link-preview-root.svelte';
 export declare const Arrow: typeof LinkPreview.Arrow;
 export declare const ContentStatic: typeof LinkPreview.ContentStatic;
 export declare const Portal: typeof LinkPreview.Portal;

package/dist/ui/link-preview/index.js

@@ -1,5 +1,5 @@
 import { LinkPreview } from 'bits-ui';
-export const Root = LinkPreview.Root;
+export { default as Root } from './link-preview-root.svelte';
 export const Arrow = LinkPreview.Arrow;
 export const ContentStatic = LinkPreview.ContentStatic;
 export const Portal = LinkPreview.Portal;

package/dist/ui/link-preview/link-preview-content.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
+	import { getAxisRelay } from '../provider/axis-relay.svelte.js';
 	import { LinkPreview } from 'bits-ui';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
@@ -8,12 +9,15 @@
 		class: className,
 		sideOffset = 8,
 		...restProps
-	}: PartProps<LinkPreview.ContentProps> = $props();
+	}: OwnedPartProps<LinkPreview.ContentProps> = $props();
+
+	const relay = getAxisRelay();
 </script>
 
 <LinkPreview.Portal>
 	<LinkPreview.Content
 		bind:ref
+		{...relay?.attrs}
 		class={cn(
 			'z-overlay max-w-xs rounded-control bg-elevated p-inset-control text-body shadow-lg glass-blur',
 			className

package/dist/ui/link-preview/link-preview-content.svelte.d.ts

@@ -1,5 +1,5 @@
 import { LinkPreview } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const LinkPreviewContent: import("svelte").Component<PartProps<LinkPreview.ContentProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const LinkPreviewContent: import("svelte").Component<OwnedPartProps<LinkPreview.ContentProps>, {}, "ref">;
 type LinkPreviewContent = ReturnType<typeof LinkPreviewContent>;
 export default LinkPreviewContent;

package/dist/ui/link-preview/link-preview-root.svelte

@@ -0,0 +1,33 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import { LinkPreview } from 'bits-ui';
+	import { setAxisRelay } from '../provider/axis-relay.svelte.js';
+
+	/*
+	 * era owns Root ONLY to open the axis channel — it renders no DOM, adds no
+	 * behaviour and forwards everything. There has to BE a component here: a
+	 * re-export (`export const Root = LinkPreview.Root`) has nowhere to put a context,
+	 * which is exactly why the axes could not cross the portal before.
+	 *
+	 * `open` is re-declared bindable because a spread cannot carry a two-way
+	 * binding, so wrapping a primitive breaks `bind:open` at every call site
+	 * unless the wrapper states it.
+	 */
+	let {
+		open = $bindable(false),
+		children,
+		...restProps
+	}: LinkPreview.RootProps & { children?: Snippet } = $props();
+
+	const relay = setAxisRelay();
+
+	// Capture on OPEN, not on mount: bits-ui mounts content eagerly and toggles
+	// it, so a mount-time read runs once at page load and never again.
+	$effect(() => {
+		if (open) relay.refresh();
+	});
+</script>
+
+<LinkPreview.Root bind:open {...restProps}>
+	{@render children?.()}
+</LinkPreview.Root>

package/dist/ui/link-preview/link-preview-root.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { Snippet } from 'svelte';
+import { LinkPreview } from 'bits-ui';
+type $$ComponentProps = LinkPreview.RootProps & {
+    children?: Snippet;
+};
+declare const LinkPreviewRoot: import("svelte").Component<$$ComponentProps, {}, "open">;
+type LinkPreviewRoot = ReturnType<typeof LinkPreviewRoot>;
+export default LinkPreviewRoot;

package/dist/ui/link-preview/link-preview-trigger.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { getAxisRelay } from '../provider/axis-relay.svelte.js';
 	import { LinkPreview } from 'bits-ui';
 	import { cn, type PartProps } from '../../utils/index.js';
 
@@ -8,6 +9,13 @@
 		class: className,
 		...restProps
 	}: PartProps<LinkPreview.TriggerProps> = $props();
+
+	// The trigger is the last node still inside the subtree, so it is the
+	// anchor the axes are read FROM when the content opens.
+	const relay = getAxisRelay();
+	$effect(() => {
+		relay?.register(ref);
+	});
 </script>
 
 <LinkPreview.Trigger

package/dist/ui/menubar/menubar-content.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
+	import { getAxisRelay } from '../provider/axis-relay.svelte.js';
 	import { Menubar } from 'bits-ui';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
@@ -8,12 +9,15 @@
 		class: className,
 		sideOffset = 4,
 		...restProps
-	}: PartProps<Menubar.ContentProps> = $props();
+	}: OwnedPartProps<Menubar.ContentProps> = $props();
+
+	const relay = getAxisRelay();
 </script>
 
 <Menubar.Portal>
 	<Menubar.Content
 		bind:ref
+		{...relay?.attrs}
 		align="start"
 		// p-menu, SURFACE-owned on purpose: 0 on flat — rows run the
 		// panel's full width, flush, and the first row sits directly under the

package/dist/ui/menubar/menubar-content.svelte.d.ts

@@ -1,5 +1,5 @@
 import { Menubar } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const MenubarContent: import("svelte").Component<PartProps<Menubar.ContentProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const MenubarContent: import("svelte").Component<OwnedPartProps<Menubar.ContentProps>, {}, "ref">;
 type MenubarContent = ReturnType<typeof MenubarContent>;
 export default MenubarContent;

package/dist/ui/menubar/menubar-root.svelte

@@ -1,12 +1,37 @@
 <script lang="ts">
 	import { Menubar } from 'bits-ui';
 	import { cn } from '../../utils/index.js';
+	import { setAxisRelay } from '../provider/axis-relay.svelte.js';
 
-	let { ref = $bindable(null), class: className, ...restProps }: Menubar.RootProps = $props();
+	let {
+		ref = $bindable(null),
+		value = $bindable(''),
+		class: className,
+		...restProps
+	}: Menubar.RootProps = $props();
+
+	const relay = setAxisRelay();
+
+	/*
+	 * Menubar's "open" is `value` — WHICH menu is open, not whether one is — so
+	 * the capture keys off a non-empty value. Same reason as everywhere else:
+	 * bits-ui mounts content eagerly, so reading at mount reads page load.
+	 *
+	 * The root ELEMENT is the anchor here rather than a trigger. A menubar's
+	 * triggers are inside it, so the bar sits at the same place in the tree for
+	 * axis purposes, and it exists whether or not any menu has been opened.
+	 */
+	$effect(() => {
+		relay.register(ref);
+	});
+	$effect(() => {
+		if (value) relay.refresh();
+	});
 </script>
 
 <Menubar.Root
 	bind:ref
+	bind:value
 	class={cn('flex h-bar items-center rounded-bar bg-well px-gutter shadow-sm', className)}
 	{...restProps}
 />

package/dist/ui/menubar/menubar-root.svelte.d.ts

@@ -1,4 +1,4 @@
 import { Menubar } from 'bits-ui';
-declare const MenubarRoot: import("svelte").Component<Menubar.RootProps, {}, "ref">;
+declare const MenubarRoot: import("svelte").Component<Menubar.RootProps, {}, "value" | "ref">;
 type MenubarRoot = ReturnType<typeof MenubarRoot>;
 export default MenubarRoot;

package/dist/ui/menubar/menubar-sub-content.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
+	import { getAxisRelay } from '../provider/axis-relay.svelte.js';
 	import { Menubar } from 'bits-ui';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
@@ -8,12 +9,15 @@
 		class: className,
 		sideOffset = 4,
 		...restProps
-	}: PartProps<Menubar.SubContentProps> = $props();
+	}: OwnedPartProps<Menubar.SubContentProps> = $props();
+
+	const relay = getAxisRelay();
 </script>
 
 <Menubar.Portal>
 	<Menubar.SubContent
 		bind:ref
+		{...relay?.attrs}
 		class={cn(
 			'z-overlay w-max overflow-hidden rounded-control bg-elevated p-menu shadow-lg glass-blur',
 			className

package/dist/ui/menubar/menubar-sub-content.svelte.d.ts

@@ -1,5 +1,5 @@
 import { Menubar } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const MenubarSubContent: import("svelte").Component<PartProps<Menubar.SubContentProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const MenubarSubContent: import("svelte").Component<OwnedPartProps<Menubar.SubContentProps>, {}, "ref">;
 type MenubarSubContent = ReturnType<typeof MenubarSubContent>;
 export default MenubarSubContent;

package/dist/ui/menubar/menubar-sub-trigger.svelte

@@ -1,14 +1,14 @@
 <script lang="ts">
 	import { Menubar } from 'bits-ui';
 	import ChevronRight from '@lucide/svelte/icons/chevron-right';
-	import { cn, type PartProps } from '../../utils/index.js';
+	import { cn, type OwnedPartProps } from '../../utils/index.js';
 
 	let {
 		ref = $bindable(null),
 		children,
 		class: className,
 		...restProps
-	}: PartProps<Menubar.SubTriggerProps> = $props();
+	}: OwnedPartProps<Menubar.SubTriggerProps> = $props();
 </script>
 
 <Menubar.SubTrigger

package/dist/ui/menubar/menubar-sub-trigger.svelte.d.ts

@@ -1,5 +1,5 @@
 import { Menubar } from 'bits-ui';
-import { type PartProps } from '../../utils/index.js';
-declare const MenubarSubTrigger: import("svelte").Component<PartProps<Menubar.SubTriggerProps>, {}, "ref">;
+import { type OwnedPartProps } from '../../utils/index.js';
+declare const MenubarSubTrigger: import("svelte").Component<OwnedPartProps<Menubar.SubTriggerProps>, {}, "ref">;
 type MenubarSubTrigger = ReturnType<typeof MenubarSubTrigger>;
 export default MenubarSubTrigger;

package/dist/ui/nav/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Bar } from './nav-bar.svelte';
+export { default as Item } from './nav-item.svelte';

package/dist/ui/nav/index.js

@@ -0,0 +1,2 @@
+export { default as Bar } from './nav-bar.svelte';
+export { default as Item } from './nav-item.svelte';

package/dist/ui/nav/nav-bar.svelte

@@ -0,0 +1,51 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAttributes } from 'svelte/elements';
+	import { cn } from '../../utils/index.js';
+	// Bar's geometry, imported rather than restated. A re-export here would be a
+	// second name for one thing; anyone who wants the variants imports them from
+	// Bar, which is where they are defined.
+	import { barVariants } from '../bar/bar.svelte';
+
+	let {
+		ref = $bindable(null),
+		size = 'bar',
+		content = 'tier',
+		label = 'Main',
+		children,
+		class: className,
+		...restProps
+	}: HTMLAttributes<HTMLElement> & {
+		ref?: HTMLElement | null;
+		/** Height tier, exactly as Bar's — the geometry is Bar's, not a second copy. */
+		size?: 'chip' | 'control' | 'bar';
+		/** Tier of the items inside, so the wall stays concentric to them. */
+		content?: 'tier' | 'pill';
+		/**
+		 * The accessible name for this landmark. A page may hold several
+		 * navigations (primary, breadcrumb, pagination, footer) and a screen
+		 * reader lists them all by name — unnamed, they read as "navigation",
+		 * "navigation", "navigation". Defaults to "Main" rather than nothing so
+		 * the common case is named without anyone having to know this.
+		 */
+		label?: string;
+		children?: Snippet;
+	} = $props();
+</script>
+
+<!--
+	A <nav> LANDMARK, not a styled div, which is the entire reason this exists
+	next to Bar. Bar is a layout primitive: a flex row on a tier with concentric
+	walls, and deliberately semantics-free, so consumers were building tab bars
+	out of it and shipping a row of links no assistive technology could find or
+	skip. Nav.Bar is that same geometry — it literally reuses barVariants rather
+	than restating it — with the landmark and the name attached.
+-->
+<nav
+	bind:this={ref}
+	aria-label={label}
+	class={cn(barVariants({ size, content }), className)}
+	{...restProps}
+>
+	{@render children?.()}
+</nav>

package/dist/ui/nav/nav-bar.svelte.d.ts

@@ -0,0 +1,21 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+type $$ComponentProps = HTMLAttributes<HTMLElement> & {
+    ref?: HTMLElement | null;
+    /** Height tier, exactly as Bar's — the geometry is Bar's, not a second copy. */
+    size?: 'chip' | 'control' | 'bar';
+    /** Tier of the items inside, so the wall stays concentric to them. */
+    content?: 'tier' | 'pill';
+    /**
+     * The accessible name for this landmark. A page may hold several
+     * navigations (primary, breadcrumb, pagination, footer) and a screen
+     * reader lists them all by name — unnamed, they read as "navigation",
+     * "navigation", "navigation". Defaults to "Main" rather than nothing so
+     * the common case is named without anyone having to know this.
+     */
+    label?: string;
+    children?: Snippet;
+};
+declare const NavBar: import("svelte").Component<$$ComponentProps, {}, "ref">;
+type NavBar = ReturnType<typeof NavBar>;
+export default NavBar;

package/dist/ui/nav/nav-item.svelte

@@ -0,0 +1,79 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+	import type { HTMLAnchorAttributes } from 'svelte/elements';
+	import { cn } from '../../utils/index.js';
+	import { buttonVariants } from '../button/variants.js';
+
+	let {
+		ref = $bindable(null),
+		href,
+		current = false,
+		size = 'control',
+		lead,
+		trail,
+		children,
+		class: className,
+		...restProps
+	}: HTMLAnchorAttributes & {
+		ref?: HTMLAnchorElement | null;
+		href: string;
+		/**
+		 * Whether this item points at the page you are on.
+		 *
+		 * There is deliberately no `active` prop beside this one. `active` would
+		 * be a second source of truth for one fact, and the two drift the moment
+		 * a route changes and someone updates the styling flag but not the
+		 * announcement — leaving a tab that LOOKS current to sighted users and
+		 * announces nothing to a screen reader, or the reverse. This sets
+		 * `aria-current="page"`, and the styling below keys off that attribute,
+		 * so the look and the announcement cannot disagree: there is one fact
+		 * and it is the accessible one.
+		 */
+		current?: boolean;
+		/** Tier, matching Button's rungs so an item nests in a bar the same way. */
+		size?: 'control' | 'chip' | 'pill' | 'icon';
+		/** Icon before the label, outside it — same contract as Button's. */
+		lead?: Snippet;
+		/** Icon after the label, outside it. */
+		trail?: Snippet;
+		children?: Snippet;
+	} = $props();
+</script>
+
+<!--
+	GEOMETRY IS BUTTON'S, borrowed rather than restated: an item in a bar is a
+	control on a rung, and a nav that invented its own heights would fall off the
+	ladder the first time the density axis moved.
+
+	The latched face is Button's too — bg-fill, the pressed shadow, held on hover
+	so it does not spring back up on bevel — but it is driven by
+	[aria-current='page'] instead of a class the caller sets. That is the whole
+	design: the attribute a screen reader reads IS the selector that paints.
+-->
+<!-- Nav.Item takes app routes and external URLs alike; resolution is the caller's. -->
+<!-- eslint-disable svelte/no-navigation-without-resolve -->
+<a
+	bind:this={ref}
+	{href}
+	aria-current={current ? 'page' : undefined}
+	class={cn(
+		buttonVariants({ size }),
+		'no-underline aria-[current=page]:bg-fill aria-[current=page]:text-bright aria-[current=page]:shadow-pressed aria-[current=page]:hover:shadow-pressed',
+		className
+	)}
+	{...restProps}
+>
+	<span
+		data-button-content
+		class="inline-flex items-center justify-center [gap:inherit] not-has-[svg]:era-label-ink"
+	>
+		{#if lead || trail}
+			{@render lead?.()}
+			{#if children}<span class="era-text-trim">{@render children()}</span>{/if}
+			{@render trail?.()}
+		{:else}
+			{@render children?.()}
+		{/if}
+	</span>
+</a>
+<!-- eslint-enable svelte/no-navigation-without-resolve -->

package/dist/ui/nav/nav-item.svelte.d.ts

@@ -0,0 +1,29 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAnchorAttributes } from 'svelte/elements';
+type $$ComponentProps = HTMLAnchorAttributes & {
+    ref?: HTMLAnchorElement | null;
+    href: string;
+    /**
+     * Whether this item points at the page you are on.
+     *
+     * There is deliberately no `active` prop beside this one. `active` would
+     * be a second source of truth for one fact, and the two drift the moment
+     * a route changes and someone updates the styling flag but not the
+     * announcement — leaving a tab that LOOKS current to sighted users and
+     * announces nothing to a screen reader, or the reverse. This sets
+     * `aria-current="page"`, and the styling below keys off that attribute,
+     * so the look and the announcement cannot disagree: there is one fact
+     * and it is the accessible one.
+     */
+    current?: boolean;
+    /** Tier, matching Button's rungs so an item nests in a bar the same way. */
+    size?: 'control' | 'chip' | 'pill' | 'icon';
+    /** Icon before the label, outside it — same contract as Button's. */
+    lead?: Snippet;
+    /** Icon after the label, outside it. */
+    trail?: Snippet;
+    children?: Snippet;
+};
+declare const NavItem: import("svelte").Component<$$ComponentProps, {}, "ref">;
+type NavItem = ReturnType<typeof NavItem>;
+export default NavItem;

package/dist/ui/provider/axes.d.ts

@@ -15,7 +15,20 @@ export interface AxisMeta {
     key: string;
     /** Default level value. */
     default: string;
-    /** Must be set on <html> so portalled content inherits it. */
+    /**
+     * Set this axis on <html> for a whole-document default.
+     *
+     * This used to read "MUST be set on <html> so portalled content inherits
+     * it", which was not a description of the axis but a surrender: portalled
+     * content is reparented to <body>, so it stopped inheriting from its subtree,
+     * and hoisting to the root was the only way to make it look right. That cost
+     * subtree scoping for the eight portalling components, and it was not even
+     * always available — an app that scopes a surface to part of itself cannot
+     * hoist without restyling the rest.
+     *
+     * The axes now cross the portal on their own (provider/axis-relay.svelte.ts),
+     * so this is a convenience, not a requirement.
+     */
     onHtml: boolean;
     /** Selectable levels, in scale order. */
     levels: readonly AxisLevel[];

package/dist/ui/provider/axis-relay.svelte.d.ts

@@ -0,0 +1,34 @@
+export declare class AxisRelay {
+    #private;
+    /** Attributes to stamp on portalled content. Empty until a capture runs. */
+    attrs: Record<string, string>;
+    /** `dark` / `light` when a scoped one is in force, else undefined. */
+    scheme: "dark" | "light" | undefined;
+    /** Called by the Trigger once it has an element. */
+    register(el: HTMLElement | null | undefined): void;
+    /**
+     * Read the axes in force at the anchor and remember them.
+     *
+     * CALLED WHEN THE CONTENT OPENS, not when the trigger mounts. Capturing at
+     * mount looks equivalent and is not: an axis can change while a trigger sits
+     * there — the docs' own pickers do it on every click, and a consumer toggling
+     * a theme or pinning a panel to dense does it too — and a value read once at
+     * mount is then wrong for every subsequent open. Content is created fresh on
+     * each open, so refreshing there is both correct and self-scheduling.
+     *
+     * Nearest-ancestor per axis, INDEPENDENTLY: a subtree can override density
+     * without touching surface, and closest() answers each question separately,
+     * which is what makes the axes orthogonal in the first place.
+     */
+    refresh(): void;
+    /** The class string portalled content should carry. */
+    get schemeClass(): string;
+}
+/** Called by era's Root for a portalling component. */
+export declare function setAxisRelay(): AxisRelay;
+/**
+ * Called by a Trigger or Content. Returns null outside an era Root — a consumer
+ * using bits-ui's own Root directly still gets working components, just without
+ * the relay, so this must never throw.
+ */
+export declare function getAxisRelay(): AxisRelay | null;