@cube-dev/ui-kit 0.168.0 → 0.168.1

package/dist/probe/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { canonicalize, canonicalizeClassNames, canonicalizeIds } from "./canonicalize.js";
 import { captureCss, diffRules, splitRules } from "./css.js";
 

package/dist/provider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { EventBusProvider } from "./utils/react/useEventBus.js";
 import { defaultNavigationAdapter } from "./providers/navigationAdapter.default.js";
 import { createContext, useContext, useMemo } from "react";

package/dist/providers/TrackingProvider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { createContext, useContext, useMemo } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/providers/navigationAdapter.default.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/providers/navigationAdapter.default.ts
 /**
 * Converts a Path object to a string URL

package/dist/tokens/all-tokens.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/base.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/tokens/base.ts
 /**
 * Base design system tokens.

package/dist/tokens/color-seed.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { glaze } from "@tenphi/glaze";
 
 //#region src/tokens/color-seed.ts

package/dist/tokens/color-theme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { DEFAULT_HUE, DEFAULT_SATURATION, getPaletteConfig, getPaletteVersion, usePaletteVersion } from "./palette-config.js";
 import { tintRecipe } from "./palette.js";

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/lazy-styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { useSyncExternalStore } from "react";
 

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../utils/react/useLayoutEffect.js";
 import { warn } from "../utils/warnings.js";
 import { getPaletteVersion, usePaletteVersion } from "./palette-config.js";

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 function isDevEnv() {
 	if (typeof window !== "undefined" && window.localStorage) try {

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { Children, cloneElement, createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useState } from "react";
 import { useFocus, useFocusVisible } from "react-aria";
 

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useSyncExternalStore } from "react";
 

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useEffect, useRef } from "react";
 
 //#region src/utils/react/useCombinedRefs.ts

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useIsDarwin.ts

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useCallback, useSyncExternalStore } from "react";
 

package/dist/utils/react/useMergeStyles.js

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

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { useCallback, useContext, useEffect, useRef } from "react";
 

package/dist/utils/react/useQaProps.js

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

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useViewportSize.ts

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 import { isValidElement } from "react";
 import { isFragment } from "react-is";
 

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | 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.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.168.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.168.1 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.168.0";
+const VERSION = "0.168.1";
 const TASTY_VERSION = "3.3.1";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/layout/Board.md

@@ -60,7 +60,7 @@ Dragging and resizing are powered by React Aria's `useMove`, so they work with m
 - **`allowMarqueeSelection`** `boolean` (default: `selectionMode === 'multiple'`) — Draw a rubber-band selection when a drag starts on empty board space. A press on a widget selects and drags instead, so the lasso owns empty canvas only. Hold <kbd>Shift</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> to add to the existing selection rather than replacing it. A board sized to its content has no empty space left once the grid fills up, which makes the lasso undiscoverable — use `extraRows` to keep a band of it.
 - **`onWidgetsDelete`** `(keys: string[]) => void` — Called when <kbd>Delete</kbd>/<kbd>Backspace</kbd> is pressed with a non-empty selection and focus is not in an editable field. **Board never mutates the layout itself** — removing the widgets is yours to do, which is what lets you make it undoable. Board only handles these keys when this handler is set.
 - **`constraints`** `LayoutConstraint[]` — Grid/item layout constraints.
-- **`width`** `number` — Explicit width (disables measurement; useful for SSR/tests).
+- **`width`** `number` — Explicit width, which **disables the board's own measurement**. Only needed for SSR, tests, or a forced-size export — see [Sizing](#sizing); a board in the document measures itself and does not need this.
 - **`widgetProps`** `Partial<Board.Widget props>` — Default props applied to every widget this board hosts (per-widget `Board.Widget` props override these). Use it to add a card border to every widget (`widgetProps={{ isCard: true }}`) or set shared `styles`/sizing defaults without repeating them on each widget.
 - **`place`** `Styles['place']` — Style prop shorthand for `place-items`/`place-content`.
 - **`scrollMargin`** `Styles['scrollMargin']` — Style prop for scroll margin.
@@ -275,6 +275,16 @@ An app that persists every commit without looking writes those normalizations ba
 
 ### Restyling the selection
 
+## Sizing
+
+**A board measures its own container. You do not need to measure it for it.**
+
+It observes its container with a `ResizeObserver` and derives the column width from that, so the only reason to pass `width` is to _prevent_ measurement — SSR, a test, or an export forced to a fixed size.
+
+The part worth knowing, because it is what makes hand-measuring look necessary: **a board renders no widgets at all until it has a width.** At width 0 a column works out negative (`(0 - margin × (cols - 1) - containerPadding × 2) / cols`), so painting then would put every widget at a nonsense size for a frame. Instead the board renders its own box and nothing inside it, and the widgets appear on the first measured frame. A board briefly hidden (an inactive tab, say) keeps its last non-zero measurement rather than dropping back to zero, so its widgets stay mounted — which is what keeps an in-flight drag alive.
+
+So a consumer that mirrors this — measuring the box itself, feeding the result back in as `width`, and gating its own render on `measured > 0` — is reimplementing behaviour it already has, and pays a `ResizeObserver` and an extra DOM node for it.
+
 ## Accessibility
 
 ### Keyboard Navigation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.168.0",
+  "version": "0.168.1",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {