@urbicon-ui/blocks 6.2.0 → 6.3.1

package/dist/primitives/Toggle/Toggle.svelte

@@ -1,8 +1,8 @@
 <script lang="ts">
   import { useBlocksI18n, mintRegistry } from '../..';
-  import { getBlocksConfig, mergeSlotClasses, resolvePresetSlotClasses } from '../../provider';
+  import { getBlocksConfig, resolveSlotClasses } from '../../provider';
   import { getTierContext, useFormField } from '../../utils';
-  import { toggleVariants } from './toggle.variants';
+  import { toggleVariants, type ToggleVariants } from './toggle.variants';
   import type { ToggleProps } from './index';
 
   const bt = useBlocksI18n();
@@ -42,13 +42,6 @@
 
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
-  const slotClasses = $derived(
-    mergeSlotClasses(
-      blocksConfig?.defaults?.Toggle?.slotClasses,
-      resolvePresetSlotClasses(blocksConfig?.presets, 'Toggle', preset),
-      slotClassesProp
-    )
-  );
 
   let rootEl = $state<HTMLElement>();
 
@@ -58,16 +51,23 @@
   const tierCtx = getTierContext();
   const effectiveTier = $derived(tier ?? tierCtx?.tier ?? 'commit');
 
-  const styles = $derived(
-    toggleVariants({
-      tier: effectiveTier,
-      size,
-      intent,
-      appearance,
-      checked,
-      disabled,
-      withBorder
-    })
+  // Variant props feed both the tv() style computation and the slot-class
+  // cascade — extracted into one derived so `resolveSlotClasses` can match
+  // conditional `overrides` against the toggle's active variants.
+  const variantProps: ToggleVariants = $derived({
+    tier: effectiveTier,
+    size,
+    intent,
+    appearance,
+    checked,
+    disabled,
+    withBorder
+  });
+
+  const styles = $derived(toggleVariants(variantProps));
+
+  const slotClasses = $derived(
+    resolveSlotClasses(blocksConfig, 'Toggle', preset, variantProps, slotClassesProp)
   );
 
   const dataState = $derived(checked ? 'checked' : 'unchecked');

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

@@ -1,7 +1,7 @@
 import type { HTMLInputAttributes } from 'svelte/elements';
 import type { MintProp } from '../../mint';
 import type { InteractiveTier } from '../../utils';
-import type { ToggleVariants } from './toggle.variants';
+import type { ToggleSlots, ToggleVariants } from './toggle.variants';
 /**
  * @description Accessible switch control for boolean on/off states.
  * Built on a hidden native input with semantic intents and Mint micro-interactions.
@@ -43,8 +43,12 @@ export interface ToggleProps extends Omit<ToggleVariants, 'checked'>, Omit<HTMLI
     class?: string;
     /** Strip all default tailwind-variants classes. Use with `slotClasses` for a fully custom look. The track exposes `data-state` for conditional styling. */
     unstyled?: boolean;
-    /** Per-slot class overrides merged with (or replacing, when `unstyled`) the default styles. */
-    slotClasses?: Partial<Record<'wrapper' | 'control' | 'track' | 'thumb' | 'label' | 'message', string>>;
+    /**
+     * Per-slot class overrides merged with (or replacing, when `unstyled`) the
+     * default styles. Slots: wrapper (root — what `class` also targets) | control
+     * (the `<label>` wrapping the input) | track | thumb | label | message.
+     */
+    slotClasses?: Partial<Record<ToggleSlots, string>>;
     /**
      * Apply a named preset registered via `<BlocksProvider presets={{ Toggle: {...} }}>`.
      * Prefer this over `class` overrides when the requested look falls outside the

package/dist/primitives/Toggle/toggle.variants.d.ts

@@ -1,4 +1,4 @@
-import { type VariantProps } from '../../utils/variants';
+import { type SlotNames, type VariantProps } from '../../utils/variants';
 export declare const toggleVariants: (props?: import("../../utils/variants").TVProps<{
     tier: {
         commit: {
@@ -132,3 +132,5 @@ export declare const toggleVariants: (props?: import("../../utils/variants").TVP
     }) | undefined) => string;
 };
 export type ToggleVariants = VariantProps<typeof toggleVariants>;
+/** Slot names derived from the `tv()` config above — single source of truth for `slotClasses`. */
+export type ToggleSlots = SlotNames<typeof toggleVariants>;

package/dist/primitives/Toolbar/Toolbar.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
-  import { toolbarVariants } from './toolbar.variants';
+  import { toolbarVariants, type ToolbarVariants } from './toolbar.variants';
   import type { ToolbarProps } from './index';
-  import { getBlocksConfig, mergeSlotClasses, resolvePresetSlotClasses } from '../../provider';
+  import { getBlocksConfig, resolveSlotClasses } from '../../provider';
   import { setTierContext } from '../../utils/tier-context';
 
   let {
@@ -30,15 +30,13 @@
 
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
+
+  const variantProps: ToolbarVariants = $derived({ variant, orientation, gap, padding });
+  const styles = $derived(toolbarVariants(variantProps));
+
   const slotClasses = $derived(
-    mergeSlotClasses(
-      blocksConfig?.defaults?.Toolbar?.slotClasses,
-      resolvePresetSlotClasses(blocksConfig?.presets, 'Toolbar', preset),
-      slotClassesProp
-    )
+    resolveSlotClasses(blocksConfig, 'Toolbar', preset, variantProps, slotClassesProp)
   );
-
-  const styles = $derived(toolbarVariants({ variant, orientation, gap, padding }));
 </script>
 
 <div

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

@@ -1,7 +1,7 @@
 import type { Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 import type { InteractiveTier } from '../../utils';
-import type { ToolbarVariants } from './toolbar.variants';
+import type { ToolbarSlots, ToolbarVariants } from './toolbar.variants';
 /**
  * Props interface for Toolbar component
  *
@@ -54,8 +54,9 @@ export interface ToolbarProps extends ToolbarVariants, Omit<HTMLAttributes<HTMLD
     tier?: InteractiveTier;
     /** Remove all default tv() classes. Combine with `slotClasses` to restyle from scratch. */
     unstyled?: boolean;
-    /** Per-slot class overrides merged with (or replacing when `unstyled`) the default classes. */
-    slotClasses?: Partial<Record<'base', string>>;
+    /** Per-slot class overrides merged with (or replacing when `unstyled`) the default classes.
+     *  Slots: base */
+    slotClasses?: Partial<Record<ToolbarSlots, string>>;
     /**
      * Apply a named preset registered via `<BlocksProvider presets={{ Toolbar: {...} }}>`.
      * Prefer this over `class` overrides when the requested look falls outside the

package/dist/primitives/Toolbar/toolbar.variants.d.ts

@@ -1,4 +1,4 @@
-import { type VariantProps } from '../../utils/variants';
+import { type SlotNames, type VariantProps } from '../../utils/variants';
 export declare const toolbarVariants: (props?: import("../../utils/variants").TVProps<{
     variant: {
         quiet: {
@@ -68,3 +68,5 @@ export declare const toolbarVariants: (props?: import("../../utils/variants").TV
     }) | undefined) => string;
 };
 export type ToolbarVariants = VariantProps<typeof toolbarVariants>;
+/** Slot names derived from the tv() config — single source of truth for slotClasses. */
+export type ToolbarSlots = SlotNames<typeof toolbarVariants>;

package/dist/primitives/Tooltip/Tooltip.svelte

@@ -1,7 +1,8 @@
 <script lang="ts">
   import { tooltipVariants } from './tooltip.variants';
+  import type { VariantProps } from '../../utils/variants';
   import type { TooltipProps } from './index';
-  import { getBlocksConfig, mergeSlotClasses, resolvePresetSlotClasses } from '../../provider';
+  import { getBlocksConfig, resolveSlotClasses } from '../../provider';
   import {
     computePosition,
     autoUpdate,
@@ -31,13 +32,6 @@
 
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
-  const slotClasses = $derived(
-    mergeSlotClasses(
-      blocksConfig?.defaults?.Tooltip?.slotClasses,
-      resolvePresetSlotClasses(blocksConfig?.presets, 'Tooltip', preset),
-      slotClassesProp
-    )
-  );
 
   let visible = $state(false);
   let triggerElement = $state<HTMLElement>();
@@ -48,7 +42,11 @@
   const propsId = $props.id();
   const tooltipId = `tooltip-${propsId}`;
 
-  const styles = $derived(tooltipVariants({ visible, intent, size }));
+  const variantProps: VariantProps<typeof tooltipVariants> = $derived({ visible, intent, size });
+  const styles = $derived(tooltipVariants(variantProps));
+  const slotClasses = $derived(
+    resolveSlotClasses(blocksConfig, 'Tooltip', preset, variantProps, slotClassesProp)
+  );
 
   let showTimeout: number;
   let hideTimeout: number;

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

@@ -1,7 +1,7 @@
 import type { Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 import type { Placement } from '../../utils/floating';
-import type { TooltipVariants } from './tooltip.variants';
+import type { TooltipSlots, TooltipVariants } from './tooltip.variants';
 /**
  * @description Contextual overlay that displays brief, supplementary text on hover or focus.
  * Built with Floating UI for precise positioning and accessibility support.
@@ -43,7 +43,7 @@ export interface TooltipProps extends TooltipVariants, Omit<HTMLAttributes<HTMLD
     /** Remove default tv classes; only consumer classes apply. */
     unstyled?: boolean;
     /** Per-slot class overrides merged with (or replacing, when unstyled) tv styles. */
-    slotClasses?: Partial<Record<'base' | 'arrow', string>>;
+    slotClasses?: Partial<Record<TooltipSlots, string>>;
     /**
      * Apply a named preset registered via `<BlocksProvider presets={{ Tooltip: {...} }}>`.
      * Prefer this over `class` overrides when the requested look falls outside the

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

@@ -1,4 +1,4 @@
-import { type VariantProps } from '../../utils/variants';
+import { type SlotNames, type VariantProps } from '../../utils/variants';
 export declare const tooltipVariants: (props?: import("../../utils/variants").TVProps<{
     visible: {
         true: {
@@ -61,3 +61,5 @@ export declare const tooltipVariants: (props?: import("../../utils/variants").TV
     }) | undefined) => string;
 };
 export type TooltipVariants = Omit<VariantProps<typeof tooltipVariants>, 'visible'>;
+/** Slot names derived from the `tv()` config above — single source of truth for `slotClasses`. */
+export type TooltipSlots = SlotNames<typeof tooltipVariants>;

package/dist/style/semantic.css

@@ -38,6 +38,11 @@
   --color-surface-selected: light-dark(var(--color-primary-50), var(--color-primary-900));
   --color-surface-subtle: light-dark(var(--color-neutral-50), var(--color-neutral-800));
   --color-surface-inverted: light-dark(var(--color-neutral-900), var(--color-neutral-100));
+  /* Skeleton wave-shimmer highlight (Skeleton animation="wave"). A translucent
+     white glint that sweeps across `surface-interactive`; lower alpha in dark
+     mode so it reads as a subtle sheen, not a flash. light-dark() keeps it
+     mode-aware so the wave needs no `dark:` override. */
+  --color-skeleton-shimmer: light-dark(oklch(1 0 0 / 0.5), oklch(1 0 0 / 0.1));
 
   /* === TEXT ===
      tertiary/quaternary shifted darker (light) so informative text on

package/dist/utils/variants.d.ts

@@ -16,6 +16,23 @@ type CompoundVariant<V extends Record<string, Record<string, unknown>>> = {
 };
 export type TVProps<V extends Record<string, Record<string, unknown>>> = VariantPropsMap<V> & TVClassOverrides;
 export type VariantProps<T extends (...args: never[]) => unknown> = Omit<Exclude<Parameters<T>[0], undefined>, 'class' | 'className'>;
+/**
+ * Extracts the slot-name union from a slotted `tv()` config function — the
+ * companion to {@link VariantProps}. The slot-mode overload returns
+ * `(props?) => { [K in keyof S]: SlotFn }`, so `keyof ReturnType<T>` is exactly
+ * the set of slot names a component declares in `tv({ slots: … })`.
+ *
+ * Use it to type a component's `slotClasses` prop from the single source of
+ * truth (its `*.variants.ts`) instead of hand-maintaining a parallel union
+ * that silently drifts when a slot is added or renamed:
+ *
+ * @example
+ * // button.variants.ts
+ * export type ButtonSlots = SlotNames<typeof buttonVariants>; // 'base' | 'content' | 'spinner'
+ * // index.ts
+ * slotClasses?: Partial<Record<ButtonSlots, string>>;
+ */
+export type SlotNames<T extends (...args: never[]) => unknown> = keyof ReturnType<T> & string;
 /**
  * Concatenate class inputs into a single string. Accepts strings, nested
  * arrays, and falsy values (filtered out). Trims and joins with single

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbicon-ui/blocks",
-  "version": "6.2.0",
+  "version": "6.3.1",
   "description": "Svelte 5 UI component library with Tailwind CSS 4, OKLCH design tokens and zero runtime dependencies",
   "license": "MIT",
   "repository": {
@@ -90,8 +90,8 @@
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "@tailwindcss/vite": "^4.3.1",
-    "@urbicon-ui/i18n": "6.2.0",
-    "@urbicon-ui/shared-types": "6.2.0",
+    "@urbicon-ui/i18n": "6.3.1",
+    "@urbicon-ui/shared-types": "6.3.1",
     "prettier": "^3.8.4",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.0",