@urbicon-ui/blocks 6.31.0 → 6.33.0

package/dist/components/Calendar/CalendarAgendaView.svelte

@@ -62,14 +62,18 @@
   const agendaKey = $derived(`${ctx.displayedYear}-${ctx.displayedMonth}`);
 
   function handleKeydown(e: KeyboardEvent) {
+    // Direction-gated like the swipes and header arrows (the DateGridScaffold
+    // pattern): an arrow key at the bound is inert — no navDirection flip, no
+    // clamped no-op onMonthChange emit. Disabled calendars ignore keys entirely.
+    if (ctx.disabled) return;
     switch (e.key) {
       case 'ArrowLeft':
         e.preventDefault();
-        ctx.navigate(-1);
+        if (ctx.canGoBack) ctx.navigate(-1);
         break;
       case 'ArrowRight':
         e.preventDefault();
-        ctx.navigate(1);
+        if (ctx.canGoForward) ctx.navigate(1);
         break;
     }
   }

package/dist/components/Calendar/CalendarDayView.svelte

@@ -33,14 +33,18 @@
   const totalEventCount = $derived(eventsWithInfo.length);
 
   function handleKeydown(e: KeyboardEvent) {
+    // Direction-gated like the swipes and header arrows (the DateGridScaffold
+    // pattern): an arrow key at the bound is inert — no navDirection flip, no
+    // clamped no-op onDayChange emit. Disabled calendars ignore keys entirely.
+    if (ctx.disabled) return;
     switch (e.key) {
       case 'ArrowLeft':
         e.preventDefault();
-        ctx.navigate(-1);
+        if (ctx.canGoBack) ctx.navigate(-1);
         break;
       case 'ArrowRight':
         e.preventDefault();
-        ctx.navigate(1);
+        if (ctx.canGoForward) ctx.navigate(1);
         break;
     }
   }

package/dist/internal/date-grid/date-grid.svelte.js

@@ -296,9 +296,11 @@ export class DateGridController {
                 break;
             }
             // Week/day steps carry no month bounds of their own, so clamp the shifted
-            // reference to [minDate, maxDate] too — otherwise a swipe or a day-view arrow
-            // key (neither gated by canGoBack/canGoForward the way the header arrows are)
-            // could step the anchor onto an all-disabled week/day past the boundary.
+            // reference to [minDate, maxDate] too. Swipes and the day/agenda arrow keys
+            // are canGoBack/canGoForward-gated like the header arrows these days, but the
+            // custom-header API (goTo/navigateWeek/navigateDay) is not — this clamp stays
+            // as the backstop so no caller can step the anchor onto an all-disabled
+            // week/day past the boundary.
             case 'week':
                 next = clampDate(addDays(referenceDate, delta * 7), minDate, maxDate);
                 break;

package/dist/primitives/ButtonGroup/ButtonGroup.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
   import { buttonGroupVariants, type ButtonGroupVariants } from '..';
   import { getBlocksConfig, resolveSlotClasses } from '../../provider';
+  import { composeHandlers } from '../../utils/compose-handlers';
   import { edgeEnabledIndex, nextEnabledIndex } from '../../utils';
   import { getTierContext, setTierContext } from '../../utils/tier-context';
   import type { ButtonGroupContext, ButtonGroupProps } from './index';
@@ -25,6 +26,12 @@
     preset,
     ariaLabel,
     ariaLabelledBy,
+    // Pulled out of restProps so the `{...restProps}`-first spread (internal
+    // attributes win — see docs/COMPONENT-API-CONVENTIONS.md) can't clobber
+    // it: the roving keyboard navigation below is composed with a consumer's
+    // own handler (internal first, consumer second) instead of either side
+    // silently replacing the other.
+    onkeydown: onkeydownProp,
     ...restProps
   }: ButtonGroupProps = $props();
 
@@ -271,18 +278,35 @@
   const ariaOrientation = $derived(ariaRole === 'radiogroup' ? orientation : undefined);
 </script>
 
+<!--
+  restProps spreads FIRST so component-owned state wins (COMPONENT-API-CONVENTIONS
+  §restProps ordering) — a consumer role/tabindex through restProps must not
+  defeat the radiogroup semantics. The attributes after the spread are
+  conditional merges, not plain overrides, because an explicit `undefined`
+  after a spread REMOVES the attribute:
+  - role: always internally computed (radiogroup/group) — internal wins outright.
+  - aria-label / aria-labelledby: the dedicated props win, a consumer's own
+    `aria-label`/`aria-labelledby` through restProps is the fallback.
+  - aria-orientation: internal on the radiogroup arm; on the `group` arm it is
+    actively removed even against restProps — ARIA disallows aria-orientation
+    on role=group (aria-allowed-attr), mirroring Button's aria-pressed force-off.
+  - aria-disabled: internal `true` is unoverridable, idle falls back to the
+    consumer value; the default DOM output stays byte-identical (attr absent).
+  - onkeydown is destructured (never in restProps) and composed: the roving
+    keyboard nav always runs, a consumer handler runs after it.
+-->
 <div
   bind:this={containerElement}
+  {...restProps}
   role={ariaRole}
   class={unstyled
     ? [slotClasses?.base, className].filter(Boolean).join(' ')
     : styles.base({ class: [slotClasses?.base, className] })}
-  aria-label={ariaLabel}
-  aria-labelledby={ariaLabelledBy}
+  aria-label={ariaLabel ?? restProps['aria-label']}
+  aria-labelledby={ariaLabelledBy ?? restProps['aria-labelledby']}
   aria-orientation={ariaOrientation}
-  aria-disabled={disabled || undefined}
-  onkeydown={handleKeyDown}
-  {...restProps}
+  aria-disabled={disabled || restProps['aria-disabled'] || undefined}
+  onkeydown={composeHandlers(handleKeyDown, onkeydownProp)}
 >
   {@render children?.()}
 </div>

package/dist/primitives/Toolbar/Toolbar.svelte

@@ -39,14 +39,24 @@
   );
 </script>
 
+<!--
+  restProps spreads FIRST so component-owned state wins (COMPONENT-API-CONVENTIONS
+  §restProps ordering) — a consumer role through restProps must not defeat the
+  toolbar semantics. No conditional merges are needed here (unlike
+  Button/ButtonGroup), because every attribute after the spread is always
+  defined: role is static, `orientation` has a default, and `aria-label` is a
+  required prop destructured out of restProps. `aria-orientation` is valid on
+  role=toolbar on both arms, so there is no removal case; `aria-labelledby`
+  and other native/data-* attributes pass through the spread untouched.
+-->
 <div
+  {...restProps}
   class={unstyled
     ? [slotClasses?.base, className].filter(Boolean).join(' ')
     : styles.base({ class: [slotClasses?.base, className] })}
   role="toolbar"
   aria-orientation={orientation}
   aria-label={ariaLabel}
-  {...restProps}
 >
   {@render children()}
 </div>

package/docs/MIGRATION-v5.md

@@ -58,10 +58,12 @@ its disclosure sibling `Collapsible`.)
 
 ## 3. Table chrome
 
-The Table no longer renders a frame by default. The new `appearance` prop
-controls the container chrome:
+The Table no longer renders a frame by default. The new `variant` prop
+controls the container chrome. (The prop was named `appearance` from v5.0
+to v6.32; it now shares the single style-axis name `variant` with every
+other component.)
 
-| `appearance` | Effect                                                       |
+| `variant`    | Effect                                                       |
 | ------------ | ------------------------------------------------------------ |
 | `flush` (default) | No frame; the table sits inline in the reading flow.    |
 | `surface`    | Quiet tinted zone — `bg-surface-quiet`.                      |
@@ -73,7 +75,7 @@ The dead `tableVariants` export is removed (was unused in any consumer).
 <!-- v4 — implicit frame -->
 <Table data={rows} columns={cols} />
 <!-- v5 — explicit equivalent -->
-<Table data={rows} columns={cols} appearance="framed" />
+<Table data={rows} columns={cols} variant="framed" />
 <!-- v5 — new editorial default -->
 <Table data={rows} columns={cols} />
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbicon-ui/blocks",
-  "version": "6.31.0",
+  "version": "6.33.0",
   "description": "Svelte 5 UI component library with Tailwind CSS 4, OKLCH design tokens and zero runtime dependencies",
   "license": "MIT",
   "repository": {
@@ -31,7 +31,8 @@
     "format": "biome format --write . && prettier --write \"**/*.svelte\"",
     "lint": "biome check . && svelte-check --tsconfig ./tsconfig.json",
     "test": "vitest",
-    "test:run": "vitest run"
+    "test:run": "vitest run",
+    "size": "bun scripts/bundle-size.ts"
   },
   "files": [
     "LICENSE",
@@ -94,8 +95,8 @@
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "@tailwindcss/vite": "^4.3.1",
-    "@urbicon-ui/i18n": "6.31.0",
-    "@urbicon-ui/shared-types": "6.31.0",
+    "@urbicon-ui/i18n": "6.33.0",
+    "@urbicon-ui/shared-types": "6.33.0",
     "prettier": "^3.8.4",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.0",