@vegastack/design 0.7.5 → 0.7.6

package/dist/{chunk-MSOIZXDR.js → chunk-OHGNXG5G.js}

@@ -70,6 +70,12 @@ var TIMINGS = {
   feedbackRevertMs: 1500,
   /** Debounce before auto-persisting a text field (AutoSaveInput). */
   autoSaveDebounceMs: 800,
+  /**
+   * Debounce before a typed search query is sent (SearchInput's settled value, FilterBar
+   * search, `useAsyncSearch`). Short enough to feel like type-ahead, long enough that one
+   * word is one request; {@link TIMINGS.autoSaveDebounceMs} is too slow for this role.
+   */
+  searchDebounceMs: 300,
   /** Hover delay before a rich preview (HoverCard) opens — guards accidental opens. */
   hoverOpenDelayMs: 700,
   /** Hover delay before a rich preview closes — lets the pointer travel into the card. */

package/dist/create-animated-icon.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   cn
-} from "./chunk-MSOIZXDR.js";
+} from "./chunk-OHGNXG5G.js";
 
 // src/icons/create-animated-icon.tsx
 import * as React from "react";

package/dist/icons/index.js

@@ -1,6 +1,6 @@
 import {
   cn
-} from "../chunk-MSOIZXDR.js";
+} from "../chunk-OHGNXG5G.js";
 
 // src/icons/icon.tsx
 import "react";

package/dist/index.cjs

@@ -99,6 +99,12 @@ var TIMINGS = {
   feedbackRevertMs: 1500,
   /** Debounce before auto-persisting a text field (AutoSaveInput). */
   autoSaveDebounceMs: 800,
+  /**
+   * Debounce before a typed search query is sent (SearchInput's settled value, FilterBar
+   * search, `useAsyncSearch`). Short enough to feel like type-ahead, long enough that one
+   * word is one request; {@link TIMINGS.autoSaveDebounceMs} is too slow for this role.
+   */
+  searchDebounceMs: 300,
   /** Hover delay before a rich preview (HoverCard) opens — guards accidental opens. */
   hoverOpenDelayMs: 700,
   /** Hover delay before a rich preview closes — lets the pointer travel into the card. */

package/dist/index.d.cts

@@ -132,6 +132,12 @@ declare const TIMINGS: {
     readonly feedbackRevertMs: 1500;
     /** Debounce before auto-persisting a text field (AutoSaveInput). */
     readonly autoSaveDebounceMs: 800;
+    /**
+     * Debounce before a typed search query is sent (SearchInput's settled value, FilterBar
+     * search, `useAsyncSearch`). Short enough to feel like type-ahead, long enough that one
+     * word is one request; {@link TIMINGS.autoSaveDebounceMs} is too slow for this role.
+     */
+    readonly searchDebounceMs: 300;
     /** Hover delay before a rich preview (HoverCard) opens — guards accidental opens. */
     readonly hoverOpenDelayMs: 700;
     /** Hover delay before a rich preview closes — lets the pointer travel into the card. */

package/dist/index.d.ts

@@ -132,6 +132,12 @@ declare const TIMINGS: {
     readonly feedbackRevertMs: 1500;
     /** Debounce before auto-persisting a text field (AutoSaveInput). */
     readonly autoSaveDebounceMs: 800;
+    /**
+     * Debounce before a typed search query is sent (SearchInput's settled value, FilterBar
+     * search, `useAsyncSearch`). Short enough to feel like type-ahead, long enough that one
+     * word is one request; {@link TIMINGS.autoSaveDebounceMs} is too slow for this role.
+     */
+    readonly searchDebounceMs: 300;
     /** Hover delay before a rich preview (HoverCard) opens — guards accidental opens. */
     readonly hoverOpenDelayMs: 700;
     /** Hover delay before a rich preview closes — lets the pointer travel into the card. */

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   mergeRefs,
   prose,
   proseClassName
-} from "./chunk-MSOIZXDR.js";
+} from "./chunk-OHGNXG5G.js";
 export {
   FLOATING,
   TIMINGS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vegastack/design",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "VegaStack design system — cn utility, icon runtime, Tailwind v4 preset, and the vegastack-design CLI (tokens ship separately as @vegastack/design-tokens)",
   "license": "MIT",
   "repository": {

package/skills/vegastack-design-system/SKILL.md

@@ -212,11 +212,12 @@ contract.
 
 ## Composition patterns
 
-- **Forms are composed, not configured** — `Field` is layout and copy: `FieldLabel` bound with
-  `htmlFor`, the control, then `FieldDescription` and `FieldError` as CHILDREN. There is no `label`,
-  `description` or `error` prop, and no context that reaches into the control. State is written where
-  it belongs: `aria-invalid` on the control (for assistive tech), `data-invalid` / `data-disabled` on
-  the `Field` (for the block's styling). `FieldError` is `role="alert"`, carries a leading icon so an
+- **Forms are composed, not configured** — `Field` is layout and copy: `FieldLabel`, the control,
+  then `FieldDescription` and `FieldError` as CHILDREN. There is no `label`, `description` or `error`
+  prop. `Field` wires the control through Base UI Field — the label's `for`, the description and
+  error ids in `aria-describedby`, and `aria-invalid` from the Field's `data-invalid` — so pass ids
+  only to override; an explicit `aria-*` prop on the control merges with the Field's, it does not
+  replace it. Write `data-invalid` / `data-disabled` on the `Field`, not by hand on the control. `FieldError` is `role="alert"`, carries a leading icon so an
   error is never colour alone, and takes either children or an `errors` array it de-duplicates.
   react-hook-form's `register` wires straight to the control; there is no `Controller` indirection.
 - **A set of related checkboxes is a `FieldSet` + `FieldLegend` + one `Field` per option** — that is

package/skills/vegastack-design-system/references/components.md

@@ -3,7 +3,7 @@
 <!-- GENERATED — do not hand-edit. Regenerated from the design system's component contract,
      which is the authority for membership and counts. -->
 
-**114 components**, plus 467 animated-icon items, 11 hooks (`use-animation-replay`, `use-announcer`, `use-drag-reorder`, `use-file-drop`, `use-inline-edit`, `use-list-nav`, `use-media-query`, `use-mobile`, `use-modal-inert`, `use-overflow`, `use-platform`), 4 starter blocks (`app-shell-01`, `board-01`, `login-01`, `settings-01`), 68 chart blocks across 7 families, and 2 data libs (`geo-data`, `drag-item`) — 666 registry items in total.
+**114 components**, plus 467 animated-icon items, 12 hooks (`use-animation-replay`, `use-announcer`, `use-async-search`, `use-drag-reorder`, `use-file-drop`, `use-inline-edit`, `use-list-nav`, `use-media-query`, `use-mobile`, `use-modal-inert`, `use-overflow`, `use-platform`), 7 starter blocks (`app-shell-01`, `board-01`, `login-01`, `review-split-01`, `settings-01`, `settings-02`, `status-pages-01`), 68 chart blocks across 7 families, and 2 data libs (`geo-data`, `drag-item`) — 670 registry items in total.
 
 Install any of them with `shadcn add @vegastack/<name>`. Animated icons install as
 `@vegastack/icon-<name>`; the bare name is reserved for components, so a component whose name