@cube-dev/ui-kit 0.0.0-canary-8a359ff → 0.0.0-canary-f3c5e39

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { SURFACE_SATURATION_SHARE, getPaletteConfig, getPaletteVersion, resolvePaletteConfig } from "./palette-config.js";
 import { lazyStyles } from "./lazy-styles.js";
 import { apcaContrast, glaze, okhslToLinearSrgb, variantToOkhsl } from "@tenphi/glaze";

package/dist/tokens/resolve.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../utils/react/useLayoutEffect.js";
 import { subscribeScheme } from "../utils/react/useScheme.js";
 import { warn } from "../utils/warnings.js";

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/tokens/shadows.ts
 /**
 * Shadow tokens using tasty shorthand syntax.

package/dist/tokens/sizes.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/tokens/sizes.ts
 /**
 * Component size values in pixels.

package/dist/tokens/spacing.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/tokens/spacing.ts
 /**
 * Spacing tokens using tasty multiplier syntax.

package/dist/tokens/typography.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/tokens/typography.ts
 /**
 * Typography presets for headings, text, and special styles.

package/dist/utils/ResizeSensor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { hslToSrgb, okhslToOklch, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHexAlpha } from "@tenphi/glaze";
 
 //#region src/utils/colors.ts

package/dist/utils/dotize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/dotize.ts
 /**
 * Flattens a nested object into dot paths: `{ a: { b: 1 } }` becomes

package/dist/utils/is-dev-env.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 /**
 * `NODE_ENV` as the environment that is actually running reports it, or

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/modules.ts
 function extractModule(promise) {
 	return promise.then((module) => module.default || module);

package/dist/utils/promise.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/promise.ts
 function timeout(ms = 30) {
 	return new Promise((resolve) => {

package/dist/utils/raf.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/raf.ts
 /**
 * Chains N requestAnimationFrame calls and returns a cancel function.

package/dist/utils/random.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/random.ts
 function random(min, max) {
 	const realMin = min < max ? min : max;

package/dist/utils/range.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/range.ts
 function range(count) {
 	return Array.from({ length: count }, (_, i) => i);

package/dist/utils/react/RenderCache.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useRef } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/utils/react/Slots.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { c } from "react-compiler-runtime";
 import { Children, cloneElement, createContext, useContext } from "react";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/chain.ts
 /**
 * Calls all functions in the order they were chained with the same arguments.

package/dist/utils/react/disabledProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/disabledProps.ts
 /**
 * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch

package/dist/utils/react/escapePropagation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/escapePropagation.ts
 /**
 * Let `Escape` keep travelling out of a trigger or list, and hold every other

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { getDisabledElementProps, omitActivationEventProps } from "./disabledProps.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useRef, useState } from "react";
 import { useFocus } from "react-aria";

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { Children, isValidElement } from "react";
 
 //#region src/utils/react/isTextOnly.ts

package/dist/utils/react/mapProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/mapProps.ts
 /** Converts AriaButtonProps to CubeButtonProps */
 function ariaToCubeButtonProps(props) {

package/dist/utils/react/mergeProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));

package/dist/utils/react/programmaticFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/programmaticFocus.ts
 /**
 * Telling focus the user moved from focus a component moved for them.

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.

package/dist/utils/react/sharedStore.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { c } from "react-compiler-runtime";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useCallback, useRef, useState } from "react";
 

package/dist/utils/react/useCombinedRefs.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef } from "react";
 

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { c } from "react-compiler-runtime";
 import { useEffect } from "react";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef, useState } from "react";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react-compiler-runtime";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { c } from "react-compiler-runtime";
 import { useContext, useEffect, useRef } from "react";

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { Fragment, isValidElement } from "react";
 
 //#region src/utils/react/wrapNodeIfPlain.ts

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/styles.ts
 /**
 * Split properties into style and non-style properties.

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
 
 //#region src/utils/warnings.ts

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-8a359ff | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-f3c5e39 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-8a359ff";
+const VERSION = "0.0.0-canary-f3c5e39";
 const TASTY_VERSION = "3.9.3";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/fields/ComboBox.md

@@ -35,6 +35,7 @@ A combobox component that combines a text input with a dropdown list, allowing u
 - **`filter`** `((textValue: string, inputValue: string) => boolean) | false` — Custom filter function or false to disable filtering. If not provided, uses default contains filter
 - **`hideTrigger`** `boolean` (default: `false`) — Whether to hide the trigger button
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — ComboBox size
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`necessityIndicator`** `'label' | 'icon'` — How the required state should be indicated
 - **`onSelectionChange`** `(key: Key | null) => void` — Callback fired when the selected option changes
 - **`onInputChange`** `(value: string) => void` — Callback fired when the input text changes

package/docs/components/fields/CommandTextArea.md

@@ -61,6 +61,7 @@ Supports all [Field properties](../../FieldProperties.md) (`label`, `name`, `isR
 - **`optionStyles`** — Styles for individual options.
 - **`sectionStyles`** — Styles for section containers.
 - **`headingStyles`** — Styles for section headings.
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 
 ### Style Properties
 

package/docs/components/fields/FilterListBox.md

@@ -26,6 +26,7 @@ A searchable list selection component that combines a ListBox with an integrated
 - **`disallowEmptySelection`** `boolean` (default: `false`) — Whether to disallow empty selection
 - **`disabledKeys`** `Key[]` — Array of keys for disabled items
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — FilterListBox size
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`searchPlaceholder`** `string` (default: `Search...`) — Placeholder text in the search input
 - **`filter`** `((textValue: string, inputValue: string) => boolean) | false` — Custom filter function or `false` to disable filtering
 - **`emptyLabel`** `ReactNode` (default: context-aware: `No items` or `No results found`) — Label shown when the list is empty. When provided, overrides both defaults for any empty state

package/docs/components/fields/FilterPicker.md

@@ -41,6 +41,7 @@ Choose a different component when the interaction has another shape:
 - **`type`** `'outline' | 'outline-2' | 'clear' | 'primary'` (default: `outline`) — Button styling type
 - **`theme`** `'default' | 'special'` (default: `default`) — Button theme
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — Size of the picker component
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`searchPlaceholder`** `string` — Placeholder text in the search input
 - **`emptyLabel`** `ReactNode` (default: context-aware: `No items` or `No results found`) — Label shown when the list is empty. When provided, overrides both defaults for any empty state
 - **`filter`** `((textValue: string, inputValue: string) => boolean) | false` — Custom filter function for determining if an option should be included in search results

package/docs/components/fields/ListBox.md

@@ -29,12 +29,14 @@ A versatile list selection component that allows users to select one or more ite
 - **`disabledKeys`** `Key[]` — Array of keys for disabled items
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — ListBox size
 - **`shape`** `'card' | 'plain' | 'popover'` (default: `card`) — Visual shape of the ListBox
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`filter`** `(nodes: Iterable<Node>) => Iterable<Node>` — Filter function for the list items
 - **`emptyLabel`** `ReactNode` (default: `No items`) — Label shown when no items are available
 - **`header`** `ReactNode` — Custom header content
 - **`footer`** `ReactNode` — Custom footer content
 - **`focusOnHover`** `boolean` (default: `true`) — Whether moving the pointer over an option will move DOM focus to that option
 - **`shouldUseVirtualFocus`** `boolean` (default: `false`) — Whether to use virtual focus instead of DOM focus
+- **`isFocusWithin`** `boolean` — For a list whose focused option is moved from an input outside it: whether focus is within that input's component
 - **`isCheckable`** `boolean` (default: `false`) — Whether to show checkboxes for multiple selection mode
 - **`shouldFocusWrap`** `boolean` (default: `false`) — Whether keyboard navigation should wrap around
 - **`description`** `string` — Field description
@@ -69,7 +71,7 @@ Customizes the root wrapper element of the component.
 
 #### listStyles
 
-Customizes the list container element.
+Customizes the list container element. The list keeps `.5x` of padding below its last option; `listStyles={{ padding: 0 }}` takes it away.
 
 #### optionStyles
 
@@ -180,6 +182,13 @@ The `mods` property accepts the following modifiers you can override:
 - Use `plain` when embedding ListBox directly into another component
 - Use `popover` when using ListBox inside overlays (Dialog, ComboBox, Picker)
 
+**listGap** (`number`, default: a hairline, `1bw`)
+
+- The space between options, in pixels
+- Use it rather than a margin in `optionStyles`: a flat list is virtualized and positions its options itself, so it ignores their margins
+- Card-like options (`type="outline"`, `shape="card"`) usually want `4` or more, so each one reads as its own choice
+- FilterListBox, Picker, FilterPicker, ComboBox, SearchComboBox, TagInput and CommandTextArea pass it to their ListBox. Select takes it too
+
 ### Focus and Interaction
 
 **focusOnHover** (`boolean`, default: `true`)
@@ -192,6 +201,12 @@ The `mods` property accepts the following modifiers you can override:
 - When `true`, uses virtual focus for keyboard navigation
 - DOM focus stays outside individual option elements (useful for searchable lists)
 
+**isFocusWithin** (`boolean`)
+
+- For a list whose focused option is moved from an input outside it, as FilterListBox's search input does
+- The focused option shows as focused only while this is `true`
+- Unset, the list's own focus decides; with `shouldUseVirtualFocus`, the focused option always shows
+
 **shouldFocusWrap** (`boolean`, default: `false`)
 
 - When `true`, keyboard navigation wraps around when reaching the end of the list
@@ -592,6 +607,22 @@ const [selectedKey, setSelectedKey] = useState('apple');
 </ListBox>
 ```
 
+### Option Gap
+
+```jsx
+<ListBox label="Permission" listGap={4} defaultSelectedKey="read">
+  <ListBox.Item key="read" type="outline" shape="card" description="View content and data">
+    Read
+  </ListBox.Item>
+  <ListBox.Item key="write" type="outline" shape="card" description="Create and edit content">
+    Write
+  </ListBox.Item>
+  <ListBox.Item key="delete" type="outline" shape="card" description="Remove content permanently">
+    Delete
+  </ListBox.Item>
+</ListBox>
+```
+
 ### Custom Escape Handling
 
 ```jsx
@@ -668,7 +699,7 @@ const [keyOrder, setKeyOrder] = useState([
 
 ### Keyboard Navigation
 
-- `Tab` - Moves focus to/from the ListBox
+- `Tab` - Moves focus to/from the ListBox. A disabled ListBox is not in the Tab order
 - `Arrow Keys` - Navigate between options
 - `Space/Enter` - Select/deselect the focused option
 - `Home/End` - Move to first/last option

package/docs/components/fields/Picker.md

@@ -34,6 +34,7 @@ Choose a different component when the interaction has another shape:
 - **`defaultSelectedKeys`** `string[] | 'all'` — The default selected keys in uncontrolled multiple mode
 - **`items`** `Iterable<T>` — Array of items for dynamic content with render function pattern
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — Size of the picker component
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`type`** `'outline' | 'outline-2' | 'clear' | 'primary'` (default: `outline`) — Trigger button styling type
 - **`theme`** `'default' | 'danger'` (default: `default`) — Trigger button color theme
 - **`icon`** `ReactNode` — Icon displayed in the trigger button

package/docs/components/fields/SearchComboBox.md

@@ -37,6 +37,7 @@ Choose a different component when the interaction has another outcome:
 - **`isLoading`** `boolean` (default: `false`) — Whether items are being loaded (e.g. from a server)
 - **`loadingDelay`** `number` (default: `1000`) — Delay in ms before the loading indicator appears
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — Size of the component
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`disabledKeys`** `Iterable<Key>` — Keys of suggestions that cannot be selected
 - **`onSelect`** `(key: string, textValue: string) => void` — Fired when a suggestion is picked; the input clears afterwards
 - **`onSubmit`** `(value: string) => void` — Opt-in. Fired when Enter is pressed with no focused/available option; the input clears afterwards

package/docs/components/fields/Select.md

@@ -56,6 +56,7 @@ Choose a different component when the interaction has another shape:
 - **`inputStyles`** `Styles` — Styles for the input trigger element
 - **`listBoxStyles`** `Styles` — Styles for the dropdown list container
 - **`optionStyles`** `Styles` — Styles for individual option items
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`overlayStyles`** `Styles` — Styles for the dropdown overlay wrapper
 - **`triggerStyles`** `Styles` — Styles for the trigger button element
 - **`inputProps`** `Props` — Additional props for the input element

package/docs/components/fields/TagInput.md

@@ -39,6 +39,7 @@ A multi-value field. The user types a value into a single-line input and commits
 - **`hideTrigger`** `boolean` (default: `false`) — Whether to hide the button that toggles the popover
 - **`disabledKeys`** `Iterable<Key>` — Keys of options that cannot be picked
 - **`size`** `'small' | 'medium' | 'large'` (default: `medium`) — Size of the input. The chips follow it
+- **`listGap`** `number` — Space between options, in pixels. Defaults to a hairline (`1bw`)
 - **`direction`** `'bottom' | 'top'` (default: `bottom`) — Where the suggestions popover opens
 - **`shouldFlip`** `boolean` (default: `true`) — Whether the popover flips when there is no room
 - **`overlayOffset`** `number` (default: `8`) — Distance between the input and the popover, in pixels

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-8a359ff",
+  "version": "0.0.0-canary-f3c5e39",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {