@cube-dev/ui-kit 0.155.0 → 0.157.0

package/dist/components/form/Form/use-field/use-field-props.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { mergeProps } from "../../../../utils/react/mergeProps.js";
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { warn } from "../../../../utils/warnings.js";

package/dist/components/form/Form/use-field/use-field.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { useIsFirstRender } from "../../../../_internal/hooks/use-is-first-render.js";
 import { resolveValidationProps } from "../../validation/resolve-validation-props.js";

package/dist/components/form/Form/use-form.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { applyRules } from "./validation.js";
 import { dotize } from "@tenphi/tasty";
 import { useRef, useState } from "react";

package/dist/components/form/Form/validation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { validate } from "email-validator";
 import validUrl from "valid-url";
 

package/dist/components/form/Label.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { extractStyles } from "../../utils/styles.js";
 import { useProviderProps } from "../../provider.js";
 import { useI18n } from "../../i18n/useI18n.js";

package/dist/components/form/validation/ValidationIndicator.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { hasValidationState } from "./resolve-validation-props.js";
 import { InvalidIcon } from "../../shared/InvalidIcon.js";

package/dist/components/form/validation/resolve-validation-props.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 //#region src/components/form/validation/resolve-validation-props.ts
 /**
 * Normalizes the validation props of a field into a pair of booleans.

package/dist/components/form/validation/use-validation-props.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { useWarn } from "../../../_internal/hooks/use-warn.js";
 import { resolveValidationProps } from "./resolve-validation-props.js";
 

package/dist/components/form/wrapper.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { mergeProps } from "../../utils/react/mergeProps.js";
 import { FieldWrapper } from "./FieldWrapper/FieldWrapper.js";
 import { jsx } from "react/jsx-runtime";

package/dist/components/helpers/DisplayTransition/DisplayTransition.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { useCallback, useLayoutEffect, useRef, useState } from "react";
 
 //#region src/components/helpers/DisplayTransition/DisplayTransition.tsx

package/dist/components/helpers/IconSwitch/IconSwitch.d.ts

@@ -0,0 +1,26 @@
+
+import { BaseProps } from "@tenphi/tasty";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/helpers/IconSwitch/IconSwitch.d.ts
+interface CubeIconSwitchProps extends BaseProps {
+  /** The icon to display */
+  children: ReactNode;
+  /** Override the default key derivation for detecting icon changes */
+  contentKey?: string | number;
+  /** When true, renders without wrapper element, expecting parent to provide grid context */
+  noWrapper?: boolean;
+}
+/**
+ * A component that cross-fades between icons when children change.
+ * Useful for animated icon transitions in buttons, items, etc.
+ *
+ * When `contentKey` changes, a transition is triggered.
+ * When only `children` changes (same `contentKey`), content is updated in-place
+ * without transition, allowing self-animating icons (like DirectionIcon) to work.
+ */
+declare function IconSwitch(props: CubeIconSwitchProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { CubeIconSwitchProps, IconSwitch };
+//# sourceMappingURL=IconSwitch.d.ts.map

package/dist/components/helpers/IconSwitch/IconSwitch.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.155.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.157.0 | Cube Dev Team */
 import { DisplayTransition } from "../DisplayTransition/DisplayTransition.js";
 import { tasty } from "@tenphi/tasty";
 import { isValidElement, useCallback, useLayoutEffect, useRef, useState } from "react";

package/dist/components/layout/Board/Board.d.ts

@@ -1,5 +1,6 @@
 
 import { LayoutConstraint, LayoutItem, ResizeHandleAxis } from "./grid-core/types.js";
+import { BoardSelectionMode } from "./use-board-selection.js";
 import { CubeBoardWidgetProps } from "./Widget.js";
 import { AllBaseProps, ContainerStyleProps } from "@tenphi/tasty";
 import { ReactNode } from "react";
@@ -12,12 +13,23 @@ type BoardCompactType = 'vertical' | 'horizontal' | 'free' | null;
  * (falls back to `oldItem` if the item just left this board via a cross-board
  * transfer), `oldItem` is that item as it was when the gesture started, and
  * `placeholder` is the current drop-slot preview (if any).
+ *
+ * The plural fields describe the whole gesture: a group drag moves every
+ * selected widget at once, so `items`/`oldItems`/`placeholders` list them all,
+ * grabbed widget first. An ordinary drag or a resize produces exactly one entry,
+ * so `items[0] === item` and `placeholders[0] === placeholder` always hold.
  */
 interface BoardInteractionInfo {
   layout: LayoutItem[];
   item: LayoutItem;
   oldItem: LayoutItem;
   placeholder: LayoutItem | null;
+  /** Every item in this gesture, grabbed first. */
+  items: LayoutItem[];
+  /** Those items as they were when the gesture started, same order. */
+  oldItems: LayoutItem[];
+  /** Every drop-slot preview. Empty exactly when `placeholder` is `null`. */
+  placeholders: LayoutItem[];
 }
 /** Visibility of the internal grid-line overlay. */
 type BoardGridLines = boolean | 'drag';
@@ -109,6 +121,41 @@ interface CubeBoardProps extends Omit<AllBaseProps, 'children' | 'onDragStart' |
    * rows at that height. @default false
    */
   isAligned?: boolean;
+  /**
+   * Whether widgets can be selected, and how many at a time. `'multiple'` also
+   * enables the marquee and rigid group movement: dragging any selected widget
+   * moves the whole selection. @default 'none'
+   */
+  selectionMode?: BoardSelectionMode;
+  /** Controlled selection. Keys are layout item ids (`LayoutItem.i`). */
+  selectedKeys?: string[];
+  /** Initial selection for uncontrolled usage. */
+  defaultSelectedKeys?: string[];
+  /**
+   * Called when the selection changes. Keys are deduped and returned in the
+   * board's layout order, never in click order.
+   */
+  onSelectionChange?: (keys: string[]) => void;
+  /**
+   * CSS selector for descendants whose clicks must never change the selection
+   * (form controls, buttons, links). Mirrors `dragCancel`; can be overridden per
+   * widget. Pass `''` to disable the guard entirely.
+   * @default BOARD_SELECTION_CANCEL
+   */
+  selectionCancel?: string;
+  /**
+   * Draw a rubber-band (marquee) selection when a drag starts on empty board
+   * space. Only meaningful with `selectionMode="multiple"`.
+   * @default selectionMode === 'multiple'
+   */
+  allowMarqueeSelection?: boolean;
+  /**
+   * Called when the user presses <kbd>Delete</kbd>/<kbd>Backspace</kbd> with a
+   * non-empty selection, and focus is inside the board but not in an editable
+   * field. Board never mutates the layout itself — removing the widgets is the
+   * consumer's job. Board only handles these keys when this handler is set.
+   */
+  onWidgetsDelete?: (keys: string[]) => void;
   /** Grid/item layout constraints. */
   constraints?: LayoutConstraint[];
   /**
@@ -125,6 +172,13 @@ interface CubeBoardProps extends Omit<AllBaseProps, 'children' | 'onDragStart' |
   widgetProps?: Partial<CubeBoardWidgetDefaults>;
   children?: ReactNode;
 }
+/**
+ * Descendants whose clicks never change the selection. A widget is a large
+ * surface the user also clicks to *work with*, so anything interactive inside it
+ * must keep its click. `[data-no-select]` is the escape hatch for an app's own
+ * custom controls.
+ */
+declare const BOARD_SELECTION_CANCEL: string;
 //#endregion
-export { BoardCompactType, BoardGridLines, BoardInteractionInfo, CubeBoardProps };
+export { BOARD_SELECTION_CANCEL, BoardCompactType, BoardGridLines, BoardInteractionInfo, CubeBoardProps };
 //# sourceMappingURL=Board.d.ts.map