@urbicon-ui/blocks 6.21.0 → 6.21.2

package/dist/primitives/Tooltip/Tooltip.svelte

@@ -21,9 +21,12 @@
     placement = 'top',
     showDelay = 200,
     hideDelay = 100,
+    transitionDuration,
+    transitionEasing,
     disabled = false,
     arrow = true,
-    onVisibleChange,
+    open = $bindable(false),
+    onOpenChange,
     class: className,
     unstyled: unstyledProp = false,
     slotClasses: slotClassesProp = {},
@@ -34,7 +37,13 @@
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
 
-  let visible = $state(false);
+  // ACC-3 follow-up: per-instance fade motion. Set the shared tooltip CSS
+  // variables inline only when a prop is provided, so the unset default keeps
+  // inheriting the reduced-motion-aware token.
+  const tooltipDuration = $derived(
+    transitionDuration != null ? `${transitionDuration}ms` : undefined
+  );
+
   let triggerElement = $state<HTMLElement>();
   let tooltipElement = $state<HTMLElement>();
   let arrowElement = $state<HTMLElement>();
@@ -43,7 +52,7 @@
   const propsId = $props.id();
   const tooltipId = `tooltip-${propsId}`;
 
-  const variantProps: VariantProps<typeof tooltipVariants> = $derived({ visible, intent, size });
+  const variantProps: VariantProps<typeof tooltipVariants> = $derived({ open, intent, size });
   const styles = $derived(tooltipVariants(variantProps));
   const slotClasses = $derived(
     resolveSlotClasses(blocksConfig, 'Tooltip', preset, variantProps, slotClassesProp)
@@ -51,16 +60,38 @@
 
   // Inside an open modal <dialog>, a popover shown via showPopover() forms a
   // second top-layer element WebKit won't render above the dialog (Codeberg
-  // #23). Evaluated while `visible` so the check runs once the dialog is
+  // #23). Evaluated while `open` so the check runs once the dialog is
   // already modal; the tooltip then renders in place (position:fixed + the
-  // opacity `visible` variant + pointer-events-none) within the dialog's own
+  // opacity `open` variant + pointer-events-none) within the dialog's own
   // top-layer subtree, no showPopover() needed.
-  const topLayer = $derived(visible ? !isAnchoredInModalDialog(triggerElement) : true);
+  const topLayer = $derived(open ? !isAnchoredInModalDialog(triggerElement) : true);
 
   let showTimeout: number;
   let hideTimeout: number;
   let cleanup: (() => void) | undefined = undefined;
 
+  // Clear pending show/hide timers on unmount — a hover followed by a
+  // teardown within `showDelay` (route change, {#if} removal) would
+  // otherwise fire setOpen after destroy: a write to the destroyed
+  // $bindable plus a ghost onOpenChange(true) for a tooltip that no
+  // longer exists. Dependency-free effect → runs once, teardown on destroy.
+  $effect(() => {
+    return () => {
+      clearTimeout(showTimeout);
+      clearTimeout(hideTimeout);
+    };
+  });
+
+  // Single mutation point for interaction-driven changes, so `onOpenChange`
+  // fires exactly once per transition. The no-change guard keeps a re-hover
+  // during the hide delay quiet (open never flipped). Consumer writes via
+  // `bind:open` bypass this on purpose — they don't re-announce themselves.
+  function setOpen(next: boolean) {
+    if (open === next) return;
+    open = next;
+    onOpenChange?.(next);
+  }
+
   function show() {
     if (disabled) return;
     clearTimeout(hideTimeout);
@@ -71,24 +102,21 @@
       // call would briefly flash the tooltip before the effect tears it
       // back down.
       if (disabled) return;
-      visible = true;
-      onVisibleChange?.(true);
+      setOpen(true);
     }, showDelay);
   }
 
   function hide() {
     clearTimeout(showTimeout);
     hideTimeout = window.setTimeout(() => {
-      visible = false;
-      onVisibleChange?.(false);
+      setOpen(false);
     }, hideDelay);
   }
 
   function handleKeydown(e: KeyboardEvent) {
-    if (e.key === 'Escape' && visible) {
+    if (e.key === 'Escape' && open) {
       clearTimeout(showTimeout);
-      visible = false;
-      onVisibleChange?.(false);
+      setOpen(false);
     }
   }
 
@@ -147,7 +175,7 @@
       });
   }
 
-  // Drive native popover state from `visible`. `popover="manual"` puts the
+  // Drive native popover state from `open`. `popover="manual"` puts the
   // element in the browser top layer when shown, so the tooltip is never
   // clipped by ancestor `overflow` (e.g. Toolbar). We deliberately avoid
   // `popover="auto"` here — auto would dismiss the tooltip on any outside
@@ -161,13 +189,13 @@
   $effect(() => {
     if (!triggerElement || !tooltipElement) return;
 
-    const shouldShow = !disabled && visible && !!label;
+    const shouldShow = !disabled && open && !!label;
 
     if (!shouldShow) {
-      // Force-clear `visible` so a stale show timeout that fired right
+      // Force-clear `open` so a stale show timeout that fired right
       // before `disabled` flipped doesn't immediately re-trigger this
       // effect into the show branch on the next mouse event.
-      if (disabled && visible) visible = false;
+      if (disabled && open) setOpen(false);
       cleanup?.();
       cleanup = undefined;
       if (tooltipElement.matches(':popover-open')) {
@@ -210,15 +238,22 @@
 </script>
 
 <!-- svelte-ignore a11y_no_static_element_interactions -->
+<!--
+  focusin/focusout (not focus/blur): the wrapper span is never focusable
+  itself — the actual trigger is the consumer's child element. focus/blur
+  don't bubble, so a keyboard focus on the child never reached the wrapper
+  and the tooltip silently skipped its WCAG 1.4.13 focus-open path;
+  focusin/focusout bubble and cover any focusable descendant.
+-->
 <span
   class="inline-flex"
   bind:this={triggerElement}
   onmouseenter={show}
   onmouseleave={hide}
-  onfocus={show}
-  onblur={hide}
+  onfocusin={show}
+  onfocusout={hide}
   onkeydown={handleKeydown}
-  aria-describedby={!disabled && label && visible ? tooltipId : undefined}
+  aria-describedby={!disabled && label && open ? tooltipId : undefined}
 >
   {@render children()}
 </span>
@@ -230,7 +265,7 @@
   the arrow node existed). In top-layer mode the `popover="manual"` attribute
   hides it via the UA stylesheet until `showPopover()` is called; inside a
   modal dialog (`topLayer === false`) the attribute is dropped and the
-  `visible` opacity variant drives visibility instead (Codeberg #23).
+  `open` opacity variant drives visibility instead (Codeberg #23).
 
   Load-bearing attributes (`popover`, `style`, `role`, `id`) intentionally
   follow `{...restProps}` so a consumer-supplied `popover="auto"`, custom
@@ -245,6 +280,8 @@
   {...restProps}
   popover={topLayer ? 'manual' : null}
   style="position: fixed; margin: 0; inset: auto; overflow: visible;"
+  style:--blocks-tooltip-duration={tooltipDuration}
+  style:--blocks-tooltip-easing={transitionEasing}
   role="tooltip"
   id={tooltipId}
 >

package/dist/primitives/Tooltip/Tooltip.svelte.d.ts

@@ -1,4 +1,4 @@
 import type { TooltipProps } from './index.js';
-declare const Tooltip: import("svelte").Component<TooltipProps, {}, "">;
+declare const Tooltip: import("svelte").Component<TooltipProps, {}, "open">;
 type Tooltip = ReturnType<typeof Tooltip>;
 export default Tooltip;

package/dist/primitives/Tooltip/index.d.ts

@@ -4,7 +4,7 @@ import type { Placement } from '../../utils/floating.js';
 import type { TooltipSlots, TooltipVariants } from './tooltip.variants.js';
 /**
  * @description Contextual overlay that displays brief, supplementary text on hover or focus.
- * Built with Floating UI for precise positioning and accessibility support.
+ * Built on the library's own positioning engine for precise placement and accessibility support.
  *
  * @tag display
  * @related Popover
@@ -22,6 +22,22 @@ import type { TooltipSlots, TooltipVariants } from './tooltip.variants.js';
  *   <Button variant="ghost" size="sm" onclick={handleCopy}>Copy</Button>
  * </Tooltip>
  * ```
+ *
+ * @example Controlled mode — programmatic "Copied!" feedback via `bind:open`
+ * ```svelte
+ * <script lang="ts">
+ *   let copied = $state(false);
+ *   async function copy() {
+ *     await navigator.clipboard.writeText(text);
+ *     copied = true;
+ *     setTimeout(() => (copied = false), 1500);
+ *   }
+ * </script>
+ *
+ * <Tooltip label="Copied!" bind:open={copied}>
+ *   <Button onclick={copy}>Copy</Button>
+ * </Tooltip>
+ * ```
  */
 export interface TooltipProps extends TooltipVariants, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     /** Text displayed inside the tooltip bubble. */
@@ -34,12 +50,38 @@ export interface TooltipProps extends TooltipVariants, Omit<HTMLAttributes<HTMLD
     showDelay?: number;
     /** Milliseconds before the tooltip disappears after leaving the trigger. @default 100 */
     hideDelay?: number;
+    /**
+     * Override the fade duration in milliseconds. Distinct from `showDelay` /
+     * `hideDelay`, which time *when* the tooltip appears — this is how fast the
+     * opacity fade itself runs. Defaults to the tooltip token
+     * `--blocks-tooltip-duration` (fast, 150ms). Respects `prefers-reduced-motion`.
+     */
+    transitionDuration?: number;
+    /**
+     * Override the fade easing as a CSS `<easing-function>` (e.g. `'linear'`,
+     * `'ease-out'`, `'cubic-bezier(0.4,0,0.2,1)'`). Defaults to the tooltip token
+     * `--blocks-tooltip-easing`. A CSS string, not a JS easing fn, because the
+     * tooltip fade is a pure CSS transition.
+     */
+    transitionEasing?: string;
     /** Whether to show a directional arrow pointing at the trigger. @default true */
     arrow?: boolean;
     /** Prevent the tooltip from appearing regardless of hover/focus. @default false */
     disabled?: boolean;
-    /** Fires when tooltip visibility changes (hover in/out, Escape key). */
-    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * Controls tooltip visibility. Supports `bind:open` for programmatic
+     * display (e.g. a transient "Copied!" confirmation). Hover/focus keep
+     * driving the state in parallel — the delays apply only to those
+     * interaction paths, a `bind:open` write takes effect immediately.
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Fires when the tooltip opens or closes from user interaction (hover
+     * in/out, focus/blur, Escape). Receives the new open state. Not called
+     * when the consumer writes `bind:open` directly.
+     */
+    onOpenChange?: (open: boolean) => void;
     /** Remove default tv classes; only consumer classes apply. */
     unstyled?: boolean;
     /** Per-slot class overrides merged with (or replacing, when unstyled) tv styles. */

package/dist/primitives/Tooltip/tooltip.variants.d.ts

@@ -1,65 +1,26 @@
 import { type SlotNames, type VariantProps } from '../../utils/variants.js';
-export declare const tooltipVariants: (props?: import("../../utils/variants.js").TVProps<{
-    visible: {
-        true: {
-            base: string;
-        };
-        false: {
-            base: string;
-        };
-    };
-    intent: {
-        primary: {
-            base: string;
-        };
-        secondary: {
-            base: string;
-        };
-        info: {
-            base: string;
-        };
-        success: {
-            base: string;
-        };
-        warning: {
-            base: string;
-        };
-        danger: {
-            base: string;
-        };
-        neutral: {
-            base: string;
-        };
-    };
-    size: {
-        sm: {
-            base: string;
-        };
-        md: {
-            base: string;
-        };
-        lg: {
-            base: string;
-        };
-    };
-}> | undefined) => {
+export declare const tooltipVariants: ((props?: {
+    open?: boolean | undefined;
+    intent?: "primary" | "secondary" | "info" | "success" | "warning" | "danger" | "neutral" | undefined;
+    size?: "sm" | "md" | "lg" | undefined;
+} | undefined) => {
     base: (props?: ({
-        visible?: boolean | undefined;
-        intent?: "info" | "primary" | "secondary" | "success" | "warning" | "danger" | "neutral" | undefined;
+        open?: boolean | undefined;
+        intent?: "primary" | "secondary" | "info" | "success" | "warning" | "danger" | "neutral" | undefined;
         size?: "sm" | "md" | "lg" | undefined;
     } & {
-        class?: string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | /*elided*/ any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
-        className?: string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | /*elided*/ any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
     }) | undefined) => string;
     arrow: (props?: ({
-        visible?: boolean | undefined;
-        intent?: "info" | "primary" | "secondary" | "success" | "warning" | "danger" | "neutral" | undefined;
+        open?: boolean | undefined;
+        intent?: "primary" | "secondary" | "info" | "success" | "warning" | "danger" | "neutral" | undefined;
         size?: "sm" | "md" | "lg" | undefined;
     } & {
-        class?: string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | /*elided*/ any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
-        className?: string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | (string | false | /*elided*/ any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
+        class?: string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | (string | number | false | /*elided*/ any | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined)[] | Record<string, boolean | null | undefined> | null | undefined;
     }) | undefined) => string;
+}) & {
+    readonly config: import("../../utils/variants.js").TVConfig;
 };
-export type TooltipVariants = Omit<VariantProps<typeof tooltipVariants>, 'visible'>;
+export type TooltipVariants = Omit<VariantProps<typeof tooltipVariants>, 'open'>;
 /** Slot names derived from the `tv()` config above — single source of truth for `slotClasses`. */
 export type TooltipSlots = SlotNames<typeof tooltipVariants>;

package/dist/primitives/Tooltip/tooltip.variants.js

@@ -21,13 +21,19 @@ export const tooltipVariants = tv({
             'z-[var(--z-tooltip)] overflow-visible',
             'font-medium text-center whitespace-normal max-w-xs',
             'rounded-contain pointer-events-none',
-            'transition-opacity duration-[var(--blocks-duration-fast)]',
+            // Tooltip fade tokens (ACC-3 follow-up) so `transitionDuration`/
+            // `transitionEasing` can retune the opacity fade per instance. `motion-reduce`
+            // guards the inline-override path (an inline duration bypasses the token that
+            // reduced-motion collapses to 1ms). The default easing token resolves to
+            // Tailwind's implicit transition curve, so the resting fade is unchanged.
+            'transition-opacity duration-[var(--blocks-tooltip-duration)] ease-[var(--blocks-tooltip-easing)]',
+            'motion-reduce:duration-[1ms]',
             'bg-surface-inverted text-text-inverted'
         ],
         arrow: ['absolute w-2 h-2', 'bg-inherit transform rotate-45']
     },
     variants: {
-        visible: {
+        open: {
             true: { base: 'opacity-100' },
             false: { base: 'opacity-0' }
         },
@@ -47,7 +53,7 @@ export const tooltipVariants = tv({
         }
     },
     defaultVariants: {
-        visible: false,
+        open: false,
         intent: 'neutral',
         size: 'md'
     }

package/dist/primitives/index.d.ts

@@ -18,7 +18,7 @@ export type { CheckboxProps } from './Checkbox/index.js';
 export * from './Checkbox/index.js';
 export type { CollapsibleProps } from './Collapsible/index.js';
 export * from './Collapsible/index.js';
-export type { ComboboxOptionType, ComboboxProps } from './Combobox/index.js';
+export type { ComboboxGroup, ComboboxOptionType, ComboboxProps } from './Combobox/index.js';
 export * from './Combobox/index.js';
 export type { ConfirmDialogProps, ConfirmIntent } from './ConfirmDialog/index.js';
 export * from './ConfirmDialog/index.js';
@@ -34,7 +34,7 @@ export type { JourneyNode, JourneyStatus, JourneyTimelineProps } from './Journey
 export * from './JourneyTimeline/index.js';
 export type { MenuContext, MenuCustomSlots, MenuItemType, MenuObjectOption, MenuOption, MenuProps, MenuSectionHeader } from './Menu/index.js';
 export * from './Menu/index.js';
-export type { PaginationItemProps, PaginationProps } from './Pagination/index.js';
+export type { PaginationItemContext, PaginationItemProps, PaginationProps } from './Pagination/index.js';
 export * from './Pagination/index.js';
 export * from './Popover/index.js';
 export type { ProgressProps } from './Progress/index.js';
@@ -61,7 +61,7 @@ export type { TabItemProps, TabPanelProps, TabProps } from './Tab/index.js';
 export * from './Tab/index.js';
 export type { TextareaProps } from './Textarea/index.js';
 export * from './Textarea/index.js';
-export type { ToastData, ToastInput, ToastIntent, ToastPlacement, ToastProps, ToastShorthandOpts } from './Toast/index.js';
+export type { ToastAction, ToastData, ToastInput, ToastIntent, ToastPlacement, ToastPromiseOptions, ToastProps, ToastShorthandOpts } from './Toast/index.js';
 export * from './Toast/index.js';
 export { TOAST_INTENTS } from './Toast/index.js';
 export type { ToggleProps } from './Toggle/index.js';

package/dist/style/foundation.css

@@ -163,8 +163,11 @@
   --z-auto: auto;
   --z-base: 0;
   --z-docked: 10;
-  --z-dropdown: 9999;
   --z-sticky: 1100;
+  /* Anchored dropdown panels (menus, listboxes) rendered in normal flow:
+     above sticky headers/toolbars (a table menu must clear its own sticky
+     header), below banner and every overlay/chrome layer that follows. */
+  --z-dropdown: 1150;
   --z-banner: 1200;
   --z-overlay: 1300;
   --z-sidebar: 1350;

package/dist/style/interaction.css

@@ -93,17 +93,19 @@
   --blocks-stagger-cards: 150ms;
 
   /* === OVERLAY ANIMATION TOKENS (XC-11) ===
-     Single source of truth for Dialog / Drawer / Popover / Tooltip /
-     Toast / ConfirmDialog enter/exit motion. Components read these via
-     CSS where they can (CSS-driven transitions) and via the matching
-     JS constants in `utils/overlay-tokens.ts` for Svelte transitions
-     that need numeric input.
-
-     Override globally with a `BlocksProvider` style block, or per
-     instance via the component's `transitionDuration` / `transitionEasing`
-     props. `prefers-reduced-motion` below collapses both enter and exit
-     to 1ms and removes scale/fly distance — kept in one place so motion
-     reduction is consistent across every overlay. */
+     Shared enter/exit motion for the panel overlays: Dialog, Drawer,
+     ConfirmDialog (via Dialog) and Toast. All four drive Svelte `fly`/`scale`
+     transitions, so they read these through the JS mirror in
+     `utils/overlay-tokens.ts` (`getOverlayMotion`) — Svelte transitions need
+     numeric input. Tooltip runs a deliberately faster CSS opacity fade off its
+     own `--blocks-tooltip-*` tokens below; Popover has no enter/exit motion yet
+     (ACC-3 follow-up).
+
+     Override globally with a `BlocksProvider` style block, or per instance via
+     the component's `transitionDuration` / `transitionEasing` props.
+     `prefers-reduced-motion` below collapses both enter and exit to 1ms and
+     removes scale/fly distance — kept in one place so motion reduction is
+     consistent across every overlay. */
   --blocks-overlay-enter-duration: 200ms;
   --blocks-overlay-exit-duration: 180ms;
   --blocks-overlay-backdrop-enter-duration: 200ms;
@@ -112,6 +114,32 @@
   --blocks-overlay-panel-scale-start: 0.96;
   --blocks-overlay-panel-fly-distance: 320px;
   --blocks-overlay-backdrop-blur: 4px;
+
+  /* === TOOLTIP FADE TOKENS (ACC-3 follow-up) ===
+     The CSS opacity fade shared by the hover/focus tooltip. Deliberately faster
+     than the panel overlays above — a hint should feel instant, not staged — so
+     it defaults to the `fast` duration (150ms) + the `confident` easing. That
+     easing token is `cubic-bezier(0.4,0,0.2,1)` — exactly Tailwind's implicit
+     transition curve, which the fade used before it carried an explicit `ease-*`
+     class — so the resting fade is unchanged. Defaulting the duration through
+     `--blocks-duration-fast` means `prefers-reduced-motion` below collapses it
+     to 1ms for free. Override globally here, or per instance via Tooltip's
+     `transitionDuration` / `transitionEasing` props (which set these inline +
+     carry a `motion-reduce` guard, since an inline duration can't see the media
+     query). */
+  --blocks-tooltip-duration: var(--blocks-duration-fast);
+  --blocks-tooltip-easing: var(--blocks-ease-confident);
+
+  /* === COLLAPSE ANIMATION TOKENS (ACC-3) ===
+     The CSS-driven grid-template-rows collapse shared by Accordion +
+     Collapsible (and their chevron spin). Default to the normal/smooth
+     tokens — so `prefers-reduced-motion` below collapses them to 1ms via
+     the inherited `--blocks-duration-normal`. Override globally here, or per
+     instance via the component's `transitionDuration` / `transitionEasing`
+     props (which set these variables inline + carry a `motion-reduce` guard,
+     since an inline duration can't see the media query). */
+  --blocks-collapse-duration: var(--blocks-duration-normal);
+  --blocks-collapse-easing: var(--blocks-ease-smooth);
 }
 
 /* ===== TOUCH DEVICE ADAPTATIONS ===== */

package/dist/style/semantic.css

@@ -84,7 +84,7 @@
 
      `--neutral-chrome-hue` defaults to 240 (:root, below), so the library
      default reads as a cool grey matching its cool chassis. Each theme
-     overrides it to its accent temperature; editorial.css re-pins the neutral
+     overrides it to its accent temperature; rooms-docs.css re-pins the neutral
      intent to the warm ramp directly. Uses the same relative-color syntax
      already relied on by `--color-interactive-*` below. */
   --color-neutral: light-dark(
@@ -232,7 +232,7 @@
      The neutral intent (above) keeps the warm-neutral ramp's lightness but
      takes its hue from here. Default 240 = cool grey, matching the default
      cool chassis. Each theme overrides this to its accent temperature;
-     editorial.css re-pins the neutral intent to the warm ramp instead. */
+     rooms-docs.css re-pins the neutral intent to the warm ramp instead. */
   --neutral-chrome-hue: 240;
 }
 

package/dist/style/themes/index.css

@@ -45,6 +45,6 @@
  * overrides these ramps. Use the Theme Builder at /customization/theme-builder
  * in the docs app to generate matched OKLCH palettes (accent + chassis)
  * interactively. To art-direct further (re-tuned intents, custom surface
- * stops, warm shadow tint), see apps/docs/src/lib/style/editorial.css for a
+ * stops, warm shadow tint), see apps/docs/src/lib/style/rooms-docs.css for a
  * fully worked example.
  */

package/dist/translations/de.d.ts

@@ -1,6 +1,8 @@
 declare const _default: {
     readonly accessibility: {
         readonly avatar: "Avatar";
+        readonly breadcrumb: "Pfadnavigation";
+        readonly breadcrumbExpand: "Alle Pfadebenen anzeigen";
         readonly clearInput: "Eingabe löschen";
         readonly clearSearch: "Suche löschen";
         readonly clearSelection: "Auswahl löschen";
@@ -19,6 +21,7 @@ declare const _default: {
         readonly removableBadge: "Entfernbarer Badge";
         readonly removeBadge: "Badge entfernen";
         readonly removeFile: "{{name}} entfernen";
+        readonly removeTag: "{{label}} entfernen";
     };
     readonly button: {
         readonly close: "Schließen";

package/dist/translations/de.js

@@ -1,6 +1,8 @@
 export default {
     accessibility: {
         avatar: 'Avatar',
+        breadcrumb: 'Pfadnavigation',
+        breadcrumbExpand: 'Alle Pfadebenen anzeigen',
         clearInput: 'Eingabe löschen',
         clearSearch: 'Suche löschen',
         clearSelection: 'Auswahl löschen',
@@ -18,7 +20,8 @@ export default {
         toggleOptions: 'Optionen umschalten',
         removableBadge: 'Entfernbarer Badge',
         removeBadge: 'Badge entfernen',
-        removeFile: '{{name}} entfernen'
+        removeFile: '{{name}} entfernen',
+        removeTag: '{{label}} entfernen'
     },
     button: {
         close: 'Schließen',

package/dist/translations/en.d.ts

@@ -1,6 +1,8 @@
 declare const _default: {
     readonly accessibility: {
         readonly avatar: "Avatar";
+        readonly breadcrumb: "Breadcrumb";
+        readonly breadcrumbExpand: "Show all breadcrumb items";
         readonly clearInput: "Clear input";
         readonly clearSearch: "Clear search";
         readonly clearSelection: "Clear selection";
@@ -19,6 +21,7 @@ declare const _default: {
         readonly removableBadge: "Removable badge";
         readonly removeBadge: "Remove badge";
         readonly removeFile: "Remove {{name}}";
+        readonly removeTag: "Remove {{label}}";
     };
     readonly button: {
         readonly close: "Close";

package/dist/translations/en.js

@@ -1,6 +1,8 @@
 export default {
     accessibility: {
         avatar: 'Avatar',
+        breadcrumb: 'Breadcrumb',
+        breadcrumbExpand: 'Show all breadcrumb items',
         clearInput: 'Clear input',
         clearSearch: 'Clear search',
         clearSelection: 'Clear selection',
@@ -18,7 +20,8 @@ export default {
         toggleOptions: 'Toggle options',
         removableBadge: 'Removable badge',
         removeBadge: 'Remove badge',
-        removeFile: 'Remove {{name}}'
+        removeFile: 'Remove {{name}}',
+        removeTag: 'Remove {{label}}'
     },
     button: {
         close: 'Close',

package/dist/utils/guide.svelte.d.ts

@@ -103,8 +103,14 @@ export interface GuideTour {
  * consumer can inject a server-state adapter. Kept deliberately tiny.
  */
 export interface GuideStorageAdapter {
-    /** Returns the persisted set of seen/completed ids. */
-    load(): string[];
+    /**
+     * Returns the persisted set of seen/completed ids. Return a `string[]`
+     * synchronously (localStorage, the default) or a `Promise<string[]>` for a
+     * DB-/remote-backed store. While an async load is pending the seen set starts
+     * empty and is merged (union) with the resolved ids once they arrive — so a
+     * tour may briefly be startable before the store answers.
+     */
+    load(): string[] | Promise<string[]>;
     /** Persists the full set of seen/completed ids. */
     save(ids: string[]): void;
 }