@urbicon-ui/blocks 6.26.3 → 6.27.0

package/dist/primitives/Card/card.variants.js

@@ -89,7 +89,14 @@ export const cardVariants = tv({
         },
         elementType: {
             button: {
-                base: 'border-none font-inherit text-left cursor-pointer'
+                // `[font:inherit]` (arbitrary property), NOT `font-inherit`: Tailwind
+                // v4 has no `font-inherit` utility (no `--font-inherit` theme key), so
+                // that class emitted no rule and a clickable Card kept the UA button
+                // font instead of inheriting the surrounding type. Same utility gap as
+                // Button's `[gap:inherit]` (Codeberg #21); found ground-truthing the
+                // variants-lint theme-existence guard (`font-` itself stays unguarded —
+                // family keys are legitimately consumer-supplied).
+                base: 'border-none [font:inherit] text-left cursor-pointer'
             },
             a: {
                 base: 'no-underline text-inherit'

package/dist/primitives/Combobox/Combobox.svelte

@@ -35,6 +35,7 @@
     queryFn,
     debounceMs = 250,
     loadingText = 'Loading…',
+    onError,
     tier,
     variant = 'outlined',
     size = 'md',
@@ -154,12 +155,21 @@
   // The dev-warn is gated to *sync* mode: with `queryFn`, a pre-bound value that
   // isn't in the current result set is expected, not a bug (there is no API to
   // seed labels for it), so warning there would cry wolf on a legitimate pattern.
-  // See technical-debt (async pre-selected labels + warn dedup).
+  // See technical-debt (async pre-selected labels).
+  //
+  // Warn dedup: `selectedTags` recomputes on every fresh `options` array a
+  // parent re-render passes in (the common `options={items.map(…)}` idiom), so
+  // an unguarded warn would re-fire per recompute. A plain Set — deliberately
+  // outside the reactive graph, so adding to it never invalidates the derived —
+  // makes it one warn per orphan value for the instance's lifetime (mirrors
+  // Select).
+  const warnedOrphanValues = new Set<T>();
   const selectedTags = $derived.by<ComboboxOption<T>[]>(() =>
     selectedValues.map((v) => {
       const found = allOptions.find((o) => o.value === v) ?? tagCache.get(v);
       if (found) return found;
-      if (!queryFn && import.meta.env?.DEV) {
+      if (!queryFn && import.meta.env?.DEV && !warnedOrphanValues.has(v)) {
+        warnedOrphanValues.add(v);
         console.warn(
           `[Combobox] value ${JSON.stringify(v)} has no matching option — tag falls back to its raw value.`
         );
@@ -261,7 +271,18 @@
         .catch((err: unknown) => {
           if (controller.signal.aborted || (err as { name?: string })?.name === 'AbortError')
             return;
-          if (import.meta.env?.DEV) console.warn('[Combobox] queryFn rejected:', err);
+          // Failure contract: the loading state ends (`finally`) and the
+          // previous — now stale — options stay in place (no result-set
+          // clobber; a UI error slot remains an open debt). The rejection is
+          // handed to `onError`; without one it is surfaced DEV-only instead
+          // of vanishing silently (ConfirmDialog onConfirm precedent). A
+          // throwing `onError` is a consumer bug and deliberately escapes
+          // (fail-loud, mirrors createCronRunner).
+          if (onError) {
+            onError(err);
+          } else if (import.meta.env?.DEV) {
+            console.warn('[Combobox] queryFn rejected:', err);
+          }
         })
         .finally(() => {
           if (!controller.signal.aborted) loading = false;

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

@@ -56,16 +56,25 @@ interface ComboboxBaseProps<T extends SelectValue = string> extends ComboboxVari
      * by {@link debounceMs} — on each query change, replacing the option list with
      * the resolved result. The `AbortSignal` is aborted when a newer query
      * supersedes an in-flight request, so a slow stale response never clobbers a
-     * fresh one. Aborted rejections are swallowed; other rejections leave the
-     * previous options in place (and warn in dev). `options`/`groups` are ignored
-     * in this mode. The selected option's label is cached so it survives result
-     * sets that no longer contain it.
+     * fresh one. Aborted rejections are swallowed; other rejections end the
+     * loading state, leave the previous options in place, and are reported via
+     * `onError`. `options`/`groups` are ignored in this mode. The selected
+     * option's label is cached so it survives result sets that no longer
+     * contain it.
      */
     queryFn?: (query: string, signal: AbortSignal) => Promise<ComboboxOption<T>[]>;
     /** Debounce applied to `queryFn` in milliseconds. @default 250 */
     debounceMs?: number;
     /** Text shown in the listbox while an async `queryFn` request is in flight. @default 'Loading…' */
     loadingText?: string;
+    /**
+     * Fired when `queryFn` rejects (aborted / superseded requests are ignored).
+     * The loading state ends and the previous option list stays in place — use
+     * this to surface the failure (toast, inline message). Without a handler
+     * the rejection is logged DEV-only (`console.warn`) and swallowed in
+     * production; it never escapes as an unhandled promise rejection.
+     */
+    onError?: (error: unknown) => void;
     /** Show a clear button when a value is selected. Click or press Escape to reset. @default false */
     clearable?: boolean;
     /** Disable the entire combobox. @default false */

package/dist/primitives/Pagination/Pagination.svelte

@@ -20,7 +20,10 @@
     intent = 'primary',
     tier,
     visiblePages = 7,
-    showFirstLast = true,
+    // Undefaulted so the DEV no-op warning below can tell an explicit
+    // `showFirstLast` from the default; `showFirstLast` itself (derived) keeps
+    // the documented `true` default for every render-path consumer.
+    showFirstLast: showFirstLastProp,
     showPreviousNext = true,
     showNumbers = true,
     showInfo = false,
@@ -52,6 +55,29 @@
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
 
+  const showFirstLast = $derived(showFirstLastProp ?? true);
+
+  // DEV fail-loud: First/Last are redundancy-gated to the number window (they
+  // render only beside a start/end ellipsis), so with `showNumbers={false}` an
+  // explicitly-set `showFirstLast` is a silent no-op. Surface that once per
+  // instance — the coupling itself is a settled decision (see the
+  // `showFirstLast` JSDoc), only its silence was the bug. Plain flag, not
+  // `$state`: the warn must not feed back into the reactive graph.
+  let warnedFirstLastWithoutNumbers = false;
+  $effect(() => {
+    if (
+      import.meta.env?.DEV &&
+      !warnedFirstLastWithoutNumbers &&
+      showFirstLastProp === true &&
+      !showNumbers
+    ) {
+      warnedFirstLastWithoutNumbers = true;
+      console.warn(
+        '[Pagination] showFirstLast has no effect while showNumbers is false — First/Last only render beside the number window’s ellipsis. Drop showFirstLast or re-enable showNumbers.'
+      );
+    }
+  });
+
   const variantProps: PaginationVariants = $derived({
     layout,
     size,

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

@@ -68,7 +68,15 @@ export interface PaginationProps extends Omit<PaginationVariants, 'disabled' | '
     tier?: InteractiveTier;
     /** Maximum number of page buttons shown between the ellipsis indicators. */
     visiblePages?: number;
-    /** Show "First" / "Last" boundary buttons when the current page is far from the edges. */
+    /**
+     * Show "First" / "Last" boundary buttons when the current page is far from
+     * the edges. Deliberately redundancy-gated to the number window: the buttons
+     * render only beside a start/end ellipsis, so without `showNumbers` there is
+     * no number window, no ellipsis — and no First/Last buttons. That coupling is
+     * intentional (a compact prev/next-only bar stays compact), not a bug.
+     * Setting `showFirstLast` explicitly while `showNumbers` is `false` warns
+     * once per instance in dev. @default true
+     */
     showFirstLast?: boolean;
     /** Show "Previous" / "Next" navigation buttons. */
     showPreviousNext?: boolean;

package/dist/primitives/Select/Select.svelte

@@ -177,14 +177,23 @@
    * dev so the consumer notices the orphan. The orphan is also filtered out
    * of the hidden form input, so the submitted form stays consistent with
    * what the trigger shows.
+   *
+   * Warn dedup: `selectedOptions` recomputes on every fresh `options` array a
+   * parent re-render passes in (the common `options={items.map(…)}` idiom), so
+   * an unguarded warn would re-fire per recompute. A plain Set — deliberately
+   * outside the reactive graph, so adding to it never invalidates the derived —
+   * makes it one warn per orphan value for the instance's lifetime (mirrors
+   * Combobox).
    */
+  const warnedOrphanValues = new Set<unknown>();
   const selectedOptions = $derived.by((): SelectOption<T>[] => {
     if (multiple) {
       const values = Array.isArray(value) ? value : [];
       return values
         .map((v) => {
           const found = allOptions.find((o) => o.value === v);
-          if (!found && import.meta.env?.DEV) {
+          if (!found && import.meta.env?.DEV && !warnedOrphanValues.has(v)) {
+            warnedOrphanValues.add(v);
             console.warn(
               `[Select] value ${JSON.stringify(v)} has no matching option — dropped from selection.`
             );
@@ -195,7 +204,8 @@
     }
     if (value === null || value === undefined) return [];
     const found = allOptions.find((o) => o.value === value);
-    if (!found && import.meta.env?.DEV) {
+    if (!found && import.meta.env?.DEV && !warnedOrphanValues.has(value)) {
+      warnedOrphanValues.add(value);
       console.warn(
         `[Select] value ${JSON.stringify(value)} has no matching option — trigger will fall back to placeholder.`
       );

package/package.json

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