@cube-dev/ui-kit 0.0.0-canary-c325dcb → 0.0.0-canary-162cdb3

package/dist/components/layout/Board/grid-core/types.d.ts

@@ -1,186 +0,0 @@
-
-//#region src/components/layout/Board/grid-core/types.d.ts
-/**
- * Core types for the grid layout engine.
- *
- * Vendored and trimmed from react-grid-layout v2 (`src/core/types.ts`).
- * See ./NOTICE.md for attribution and license.
- *
- * These types are framework-agnostic and describe the data structures used by
- * the layout algorithms.
- */
-/**
- * Axis identifiers for resize handles.
- * - Cardinal: 'n', 's', 'e', 'w' (north, south, east, west)
- * - Diagonal: 'ne', 'nw', 'se', 'sw'
- */
-type ResizeHandleAxis = 's' | 'w' | 'e' | 'n' | 'sw' | 'nw' | 'se' | 'ne';
-/**
- * A single item in the grid layout.
- *
- * Position (x, y) is in grid units, not pixels. Size (w, h) is in grid units.
- */
-interface LayoutItem {
-  /** Unique identifier for this item */
-  i: string;
-  /** X position in grid units (0-indexed from left) */
-  x: number;
-  /** Y position in grid units (0-indexed from top) */
-  y: number;
-  /** Width in grid units */
-  w: number;
-  /** Height in grid units */
-  h: number;
-  /** Minimum width in grid units */
-  minW?: number;
-  /** Minimum height in grid units */
-  minH?: number;
-  /** Maximum width in grid units */
-  maxW?: number;
-  /** Maximum height in grid units */
-  maxH?: number;
-  /**
-   * If true, item cannot be dragged or resized, and other items will move
-   * around it during compaction.
-   */
-  static?: boolean;
-  /**
-   * If false, item cannot be dragged (but may still be resizable).
-   * Overrides grid-level isDraggable for this item.
-   */
-  isDraggable?: boolean;
-  /**
-   * If false, item cannot be resized (but may still be draggable).
-   * Overrides grid-level isResizable for this item.
-   */
-  isResizable?: boolean;
-  /**
-   * Which resize handles to show for this item.
-   * Overrides grid-level resizeHandles for this item.
-   */
-  resizeHandles?: ResizeHandleAxis[];
-  /**
-   * If true, item is constrained to the grid container bounds.
-   * Overrides grid-level isBounded for this item.
-   */
-  isBounded?: boolean;
-  /**
-   * Internal flag set during drag/resize operations to indicate the item has
-   * moved from its original position.
-   * @internal
-   */
-  moved?: boolean;
-  /**
-   * Per-item layout constraints. Applied in addition to grid-level constraints.
-   */
-  constraints?: LayoutConstraint[];
-}
-/**
- * A layout is a readonly array of layout items. Treat layouts as immutable.
- */
-type Layout = readonly LayoutItem[];
-/**
- * Type of compaction to apply to the layout.
- * - 'vertical': Items compact upward (default)
- * - 'horizontal': Items compact leftward
- * - 'wrap': Items arranged in wrapped-paragraph style (like words in text)
- * - null: No compaction (free-form positioning)
- */
-type CompactType = 'horizontal' | 'vertical' | 'wrap' | null;
-/**
- * How a blocked placement is resolved when collisions are prevented.
- *
- * - `'revert'` - snap the item back to where it was (the engine's own default).
- * - `'downscale'` - shrink the item into the free space at the cell it was
- *   dropped on, growing rightward and downward. Never upscales.
- * - `'swap'` - inside one board, exchange with one widget: the dragged widget
- *   takes the cell of the widget the drop covers most, and that widget takes the
- *   cell the dragged one came from, each keeping as much of its own size as fits
- *   there. Across boards, insert only at an empty anchor and downscale without
- *   exchanging or reflowing destination widgets; an invalid landing cancels the
- *   transfer. Never displaces more than one widget. Else downscale, else revert.
- *
- * Only consulted where a move would otherwise be refused, so it has no effect in
- * the compacting modes (a collision pushes neighbours there) or under
- * `allowOverlap` (nothing is refused).
- */
-type CollisionMode = 'revert' | 'downscale' | 'swap';
-/**
- * Interface for layout compaction strategies.
- *
- * Implement this interface to create custom compaction algorithms.
- */
-interface Compactor {
-  /** Compaction type identifier */
-  readonly type: CompactType;
-  /**
-   * Whether items can overlap (stack on top of each other).
-   *
-   * When true items can be placed on top of other items, dragging into another
-   * item does NOT push it away, and compaction is skipped after drag/resize.
-   */
-  readonly allowOverlap: boolean;
-  /**
-   * Whether to block movement that would cause collision.
-   *
-   * When true (and allowOverlap is false) dragging into another item is blocked
-   * (item snaps back) and other items are NOT pushed away. Only affects
-   * drag/resize, not compaction. Has no effect when allowOverlap is true.
-   */
-  readonly preventCollision?: boolean;
-  /**
-   * Compact the layout.
-   *
-   * @param layout - The layout to compact
-   * @param cols - Number of columns in the grid
-   * @returns The compacted layout
-   */
-  compact(layout: Layout, cols: number): Layout;
-}
-/** Context provided to constraint functions during drag/resize operations. */
-interface ConstraintContext {
-  /** Number of columns in the grid */
-  cols: number;
-  /** Maximum number of rows (Infinity if unbounded) */
-  maxRows: number;
-  /** Container width in pixels */
-  containerWidth: number;
-  /** Container height in pixels (may be 0 if auto-height) */
-  containerHeight: number;
-  /** Row height in pixels */
-  rowHeight: number;
-  /** Margin between items [x, y] in pixels */
-  margin: readonly [number, number];
-  /** Current layout state */
-  layout: Layout;
-}
-/**
- * Interface for layout constraints.
- *
- * Implement this interface to create custom position/size constraints.
- * Built-in constraints: gridBounds, minMaxSize, containerBounds, boundedX,
- * boundedY.
- */
-interface LayoutConstraint {
-  /** Constraint identifier for debugging */
-  readonly name: string;
-  /**
-   * Constrain position during drag operations. Called after grid unit
-   * conversion, before layout update.
-   */
-  constrainPosition?(item: LayoutItem, x: number, y: number, context: ConstraintContext): {
-    x: number;
-    y: number;
-  };
-  /**
-   * Constrain size during resize operations. Called after grid unit conversion,
-   * before layout update.
-   */
-  constrainSize?(item: LayoutItem, w: number, h: number, handle: ResizeHandleAxis, context: ConstraintContext): {
-    w: number;
-    h: number;
-  };
-}
-//#endregion
-export { CollisionMode, CompactType, Compactor, Layout, LayoutConstraint, LayoutItem, ResizeHandleAxis };
-//# sourceMappingURL=types.d.ts.map

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

@@ -1,24 +0,0 @@
-
-import { CollisionMode, Compactor, Layout, LayoutConstraint, LayoutItem, ResizeHandleAxis } from "./grid-core/types.js";
-import { distributeEvenly, placeInFreeSlot } from "./grid-core/placement.js";
-import { getCompactor, horizontalCompactor, noCompactor, verticalCompactor } from "./grid-core/compactors.js";
-import { aspectRatio, boundedX, boundedY, containerBounds, gridBounds, maxSize, minMaxSize, minSize, snapToGrid } from "./grid-core/constraints.js";
-import { BoardSelectionMode } from "./use-board-selection.js";
-import { BoardLayoutChangeInfo, BoardLayoutChangeReason } from "./use-board-layout.js";
-import { BoardCornerPlacement, BoardResizeGripPlacement, CubeBoardWidgetProps, Widget } from "./Widget.js";
-import { BOARD_SELECTION_CANCEL, BoardCompactType, BoardGridLines, BoardInteractionInfo, CubeBoardProps } from "./Board.js";
-import { BreakpointCols, Breakpoints, ResponsiveLayouts } from "./responsive-utils.js";
-import { BoardResponsive, CubeBoardResponsiveProps } from "./BoardResponsive.js";
-import { BoardDragActiveProvider, CubeBoardDragActiveProviderProps, WidgetTransferInfo } from "./board-context.js";
-import { BoardProvider, CubeBoardProviderProps } from "./BoardProvider.js";
-import * as react from "react";
-
-//#region src/components/layout/Board/index.d.ts
-declare const Board: react.ForwardRefExoticComponent<CubeBoardProps & react.RefAttributes<HTMLDivElement>> & {
-  Widget: typeof Widget;
-  Provider: typeof BoardProvider;
-  Responsive: react.ForwardRefExoticComponent<CubeBoardResponsiveProps & react.RefAttributes<HTMLDivElement>>;
-};
-//#endregion
-export { Board };
-//# sourceMappingURL=index.d.ts.map

package/dist/components/layout/Board/index.js

@@ -1,20 +0,0 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-c325dcb | Cube Dev Team */
-import { BoardDragActiveProvider } from "./board-context.js";
-import { distributeEvenly, placeInFreeSlot } from "./grid-core/placement.js";
-import { getCompactor, horizontalCompactor, noCompactor, verticalCompactor } from "./grid-core/compactors.js";
-import { aspectRatio, boundedX, boundedY, containerBounds, gridBounds, maxSize, minMaxSize, minSize, snapToGrid } from "./grid-core/constraints.js";
-import { BoardProvider } from "./BoardProvider.js";
-import { BOARD_SELECTION_CANCEL, Board as Board$1 } from "./Board.js";
-import { BoardResponsive } from "./BoardResponsive.js";
-import { Widget } from "./Widget.js";
-
-//#region src/components/layout/Board/index.tsx
-const Board = Object.assign(Board$1, {
-	Widget,
-	Provider: BoardProvider,
-	Responsive: BoardResponsive
-});
-
-//#endregion
-export { Board };
-//# sourceMappingURL=index.js.map

package/dist/components/layout/Board/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["Board","BoardBase","BoardProvider","BoardResponsive","Widget","Object","assign","Provider","Responsive","BoardWidget","BOARD_SELECTION_CANCEL","BoardDragActiveProvider","CubeBoardDragActiveProviderProps","CubeBoardProps","BoardCompactType","BoardGridLines","BoardInteractionInfo","BoardSelectionMode","CubeBoardResponsiveProps","CubeBoardWidgetProps","BoardResizeGripPlacement","BoardCornerPlacement","BoardLayoutChangeInfo","BoardLayoutChangeReason","CubeBoardProviderProps","WidgetTransferInfo","Breakpoints","BoardBreakpoints","BreakpointCols","BoardBreakpointCols","ResponsiveLayouts","BoardResponsiveLayouts","Layout","LayoutItem","ResizeHandleAxis","CollisionMode","Compactor","LayoutConstraint","PositionParams","placeInFreeSlot","distributeEvenly","verticalCompactor","horizontalCompactor","noCompactor","getCompactor","gridBounds","minMaxSize","containerBounds","boundedX","boundedY","aspectRatio","snapToGrid","minSize","maxSize"],"sources":["../../../../src/components/layout/Board/index.tsx"],"sourcesContent":["import { Board as BoardBase } from './Board';\nimport { BoardProvider } from './BoardProvider';\nimport { BoardResponsive } from './BoardResponsive';\nimport { Widget } from './Widget';\n\nconst Board = Object.assign(BoardBase, {\n  Widget,\n  Provider: BoardProvider,\n  Responsive: BoardResponsive,\n});\n\nexport { Board };\nexport { BoardProvider };\nexport { BoardResponsive };\nexport { Widget as BoardWidget };\nexport { BOARD_SELECTION_CANCEL } from './Board';\nexport { BoardDragActiveProvider } from './board-context';\nexport type { CubeBoardDragActiveProviderProps } from './board-context';\n\nexport type {\n  CubeBoardProps,\n  BoardCompactType,\n  BoardGridLines,\n  BoardInteractionInfo,\n} from './Board';\nexport type { BoardSelectionMode } from './use-board-selection';\nexport type { CubeBoardResponsiveProps } from './BoardResponsive';\nexport type {\n  CubeBoardWidgetProps,\n  BoardResizeGripPlacement,\n  BoardCornerPlacement,\n} from './Widget';\nexport type {\n  BoardLayoutChangeInfo,\n  BoardLayoutChangeReason,\n} from './use-board-layout';\nexport type { CubeBoardProviderProps } from './BoardProvider';\nexport type { WidgetTransferInfo } from './board-context';\nexport type {\n  Breakpoints as BoardBreakpoints,\n  BreakpointCols as BoardBreakpointCols,\n  ResponsiveLayouts as BoardResponsiveLayouts,\n} from './responsive-utils';\n\nexport type {\n  Layout,\n  LayoutItem,\n  ResizeHandleAxis,\n  CollisionMode,\n  Compactor,\n  LayoutConstraint,\n  PositionParams,\n} from './grid-core';\n\nexport { placeInFreeSlot, distributeEvenly } from './grid-core';\n\nexport {\n  verticalCompactor,\n  horizontalCompactor,\n  noCompactor,\n  getCompactor,\n  gridBounds,\n  minMaxSize,\n  containerBounds,\n  boundedX,\n  boundedY,\n  aspectRatio,\n  snapToGrid,\n  minSize,\n  maxSize,\n} from './grid-core';\n"],"mappings":";;;;;;;;;;;AAKA,MAAMA,QAAQK,OAAOC,OAAOL,SAAW;CACrCG;CACAG,UAAUL;CACVM,YAAYL;CACb,CAAC"}

package/dist/components/layout/Board/responsive-utils.d.ts

@@ -1,13 +0,0 @@
-
-import { LayoutItem } from "./grid-core/types.js";
-
-//#region src/components/layout/Board/responsive-utils.d.ts
-/** Map of breakpoint name -> minimum container width (px). */
-type Breakpoints = Record<string, number>;
-/** Map of breakpoint name -> column count. */
-type BreakpointCols = Record<string, number>;
-/** Map of breakpoint name -> layout. */
-type ResponsiveLayouts = Record<string, LayoutItem[]>;
-//#endregion
-export { BreakpointCols, Breakpoints, ResponsiveLayouts };
-//# sourceMappingURL=responsive-utils.d.ts.map

package/dist/components/layout/Board/responsive-utils.js

@@ -1,55 +0,0 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-c325dcb | Cube Dev Team */
-import { cloneLayout, correctBounds } from "./grid-core/layout.js";
-
-//#region src/components/layout/Board/responsive-utils.ts
-/**
-* Responsive helpers for `Board.Responsive`.
-*
-* Framework-agnostic breakpoint math adapted (MIT) from react-grid-layout's
-* `responsiveUtils`, rewritten to use this package's grid-core primitives. See
-* ./grid-core/NOTICE.md for the upstream attribution and license.
-*/
-/** Breakpoint names sorted ascending by their minimum width. */
-function sortBreakpoints(breakpoints) {
-	return Object.keys(breakpoints).sort((a, b) => breakpoints[a] - breakpoints[b]);
-}
-/**
-* The largest breakpoint whose minimum width is at or below `width`. Falls back
-* to the smallest breakpoint when `width` is narrower than all of them.
-*/
-function getBreakpointFromWidth(breakpoints, width) {
-	const sorted = sortBreakpoints(breakpoints);
-	let matching = sorted[0];
-	for (let i = 1; i < sorted.length; i++) {
-		const name = sorted[i];
-		if (width >= breakpoints[name]) matching = name;
-	}
-	return matching;
-}
-/** Column count for a breakpoint. */
-function getColsFromBreakpoint(breakpoint, cols) {
-	const value = cols[breakpoint];
-	if (value == null) throw new Error(`Board.Responsive: no columns defined for breakpoint "${breakpoint}".`);
-	return value;
-}
-/**
-* The layout for `breakpoint`, or one synthesized from the nearest available
-* breakpoint (preferring `lastBreakpoint`, then breakpoints at or above the
-* target) corrected into bounds and compacted for the target column count.
-*/
-function findOrGenerateResponsiveLayout(layouts, breakpoints, breakpoint, lastBreakpoint, cols, compactor) {
-	if (layouts[breakpoint]) return cloneLayout(layouts[breakpoint]);
-	let layout = layouts[lastBreakpoint];
-	const sorted = sortBreakpoints(breakpoints);
-	const above = sorted.slice(sorted.indexOf(breakpoint));
-	for (const name of above) if (layouts[name]) {
-		layout = layouts[name];
-		break;
-	}
-	layout = cloneLayout(layout || []);
-	return [...compactor.compact(correctBounds(layout, { cols }), cols)];
-}
-
-//#endregion
-export { findOrGenerateResponsiveLayout, getBreakpointFromWidth, getColsFromBreakpoint };
-//# sourceMappingURL=responsive-utils.js.map

package/dist/components/layout/Board/responsive-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"responsive-utils.js","names":["cloneLayout","Compactor","correctBounds","LayoutItem","Breakpoints","Record","BreakpointCols","ResponsiveLayouts","sortBreakpoints","breakpoints","Object","keys","sort","a","b","getBreakpointFromWidth","width","sorted","matching","i","length","name","getColsFromBreakpoint","breakpoint","cols","value","Error","findOrGenerateResponsiveLayout","layouts","lastBreakpoint","compactor","layout","above","slice","indexOf","compact"],"sources":["../../../../src/components/layout/Board/responsive-utils.ts"],"sourcesContent":["/**\n * Responsive helpers for `Board.Responsive`.\n *\n * Framework-agnostic breakpoint math adapted (MIT) from react-grid-layout's\n * `responsiveUtils`, rewritten to use this package's grid-core primitives. See\n * ./grid-core/NOTICE.md for the upstream attribution and license.\n */\nimport { cloneLayout, Compactor, correctBounds, LayoutItem } from './grid-core';\n\n/** Map of breakpoint name -> minimum container width (px). */\nexport type Breakpoints = Record<string, number>;\n/** Map of breakpoint name -> column count. */\nexport type BreakpointCols = Record<string, number>;\n/** Map of breakpoint name -> layout. */\nexport type ResponsiveLayouts = Record<string, LayoutItem[]>;\n\n/** Breakpoint names sorted ascending by their minimum width. */\nexport function sortBreakpoints(breakpoints: Breakpoints): string[] {\n  return Object.keys(breakpoints).sort(\n    (a, b) => breakpoints[a] - breakpoints[b],\n  );\n}\n\n/**\n * The largest breakpoint whose minimum width is at or below `width`. Falls back\n * to the smallest breakpoint when `width` is narrower than all of them.\n */\nexport function getBreakpointFromWidth(\n  breakpoints: Breakpoints,\n  width: number,\n): string {\n  const sorted = sortBreakpoints(breakpoints);\n  let matching = sorted[0];\n  for (let i = 1; i < sorted.length; i++) {\n    const name = sorted[i];\n    if (width >= breakpoints[name]) matching = name;\n  }\n  return matching;\n}\n\n/** Column count for a breakpoint. */\nexport function getColsFromBreakpoint(\n  breakpoint: string,\n  cols: BreakpointCols,\n): number {\n  const value = cols[breakpoint];\n  if (value == null) {\n    throw new Error(\n      `Board.Responsive: no columns defined for breakpoint \"${breakpoint}\".`,\n    );\n  }\n  return value;\n}\n\n/**\n * The layout for `breakpoint`, or one synthesized from the nearest available\n * breakpoint (preferring `lastBreakpoint`, then breakpoints at or above the\n * target) corrected into bounds and compacted for the target column count.\n */\nexport function findOrGenerateResponsiveLayout(\n  layouts: ResponsiveLayouts,\n  breakpoints: Breakpoints,\n  breakpoint: string,\n  lastBreakpoint: string,\n  cols: number,\n  compactor: Compactor,\n): LayoutItem[] {\n  if (layouts[breakpoint]) return cloneLayout(layouts[breakpoint]);\n\n  let layout = layouts[lastBreakpoint];\n  const sorted = sortBreakpoints(breakpoints);\n  const above = sorted.slice(sorted.indexOf(breakpoint));\n  for (const name of above) {\n    if (layouts[name]) {\n      layout = layouts[name];\n      break;\n    }\n  }\n\n  layout = cloneLayout(layout || []);\n  return [...compactor.compact(correctBounds(layout, { cols }), cols)];\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgBQ,gBAAgBC,aAAoC;AAClE,QAAOC,OAAOC,KAAKF,YAAY,CAACG,MAC7BC,GAAGC,MAAML,YAAYI,KAAKJ,YAAYK,GACxC;;;;;;AAOH,SAAgBC,uBACdN,aACAO,OACQ;CACR,MAAMC,SAAST,gBAAgBC,YAAY;CAC3C,IAAIS,WAAWD,OAAO;AACtB,MAAK,IAAIE,IAAI,GAAGA,IAAIF,OAAOG,QAAQD,KAAK;EACtC,MAAME,OAAOJ,OAAOE;AACpB,MAAIH,SAASP,YAAYY,MAAOH,YAAWG;;AAE7C,QAAOH;;;AAIT,SAAgBI,sBACdC,YACAC,MACQ;CACR,MAAMC,QAAQD,KAAKD;AACnB,KAAIE,SAAS,KACX,OAAM,IAAIC,MACR,wDAAwDH,WAAU,IACnE;AAEH,QAAOE;;;;;;;AAQT,SAAgBE,+BACdC,SACAnB,aACAc,YACAM,gBACAL,MACAM,WACc;AACd,KAAIF,QAAQL,YAAa,QAAOvB,YAAY4B,QAAQL,YAAY;CAEhE,IAAIQ,SAASH,QAAQC;CACrB,MAAMZ,SAAST,gBAAgBC,YAAY;CAC3C,MAAMuB,QAAQf,OAAOgB,MAAMhB,OAAOiB,QAAQX,WAAW,CAAC;AACtD,MAAK,MAAMF,QAAQW,MACjB,KAAIJ,QAAQP,OAAO;AACjBU,WAASH,QAAQP;AACjB;;AAIJU,UAAS/B,YAAY+B,UAAU,EAAE,CAAC;AAClC,QAAO,CAAC,GAAGD,UAAUK,QAAQjC,cAAc6B,QAAQ,EAAEP,MAAM,CAAC,EAAEA,KAAK,CAAC"}

package/dist/components/layout/Board/use-board-layout.d.ts

@@ -1,26 +0,0 @@
-
-//#region src/components/layout/Board/use-board-layout.d.ts
-/**
- * Why the layout changed.
- *
- * A board commits for two different kinds of reason, and an app usually cares
- * which: a gesture is the user arranging their board, while a normalization is
- * the board fitting an existing arrangement to a constraint that moved
- * underneath it. Without this, an app that persists `onLayoutChange` has no way
- * to tell "the user dragged a widget" from "the column count changed and the
- * board reflowed", so it writes the reflow back as if it were an edit — marking
- * a document dirty nobody touched.
- *
- * - `drag` / `resize` — a pointer or keyboard gesture on this board.
- * - `transfer` — a widget arrived from, or left for, another board.
- * - `normalize` — no gesture: a reflow for a changed column count, or an
- *   auto-height widget growing to fit its content.
- */
-type BoardLayoutChangeReason = 'drag' | 'resize' | 'transfer' | 'normalize';
-/** What `onLayoutChange` reports alongside the new layout. */
-interface BoardLayoutChangeInfo {
-  reason: BoardLayoutChangeReason;
-}
-//#endregion
-export { BoardLayoutChangeInfo, BoardLayoutChangeReason };
-//# sourceMappingURL=use-board-layout.d.ts.map

package/dist/components/layout/Board/use-board-layout.js

@@ -1,57 +0,0 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-c325dcb | Cube Dev Team */
-import { useEvent } from "../../../_internal/hooks/use-event.js";
-import { cloneLayout } from "./grid-core/layout.js";
-import { useCallback, useEffect, useRef, useState } from "react";
-
-//#region src/components/layout/Board/use-board-layout.ts
-/**
-* Headless layout state for a single board.
-*
-* Supports both controlled (`layout`) and uncontrolled (`defaultLayout`) usage.
-* Intermediate drag/resize previews always update local state; only committed
-* changes call `onLayoutChange`.
-*/
-function useBoardLayout(options) {
-	const { layout: controlledLayout, defaultLayout, onLayoutChange } = options;
-	const isControlled = controlledLayout !== void 0;
-	const [layout, setLayout] = useState(() => cloneLayout(controlledLayout ?? defaultLayout ?? []));
-	const layoutRef = useRef(layout);
-	layoutRef.current = layout;
-	const [placeholders, setPlaceholdersState] = useState([]);
-	const placeholdersRef = useRef([]);
-	const placeholderRef = useRef(null);
-	const setPlaceholders = useCallback((items) => {
-		placeholdersRef.current = items;
-		placeholderRef.current = items[0] ?? null;
-		setPlaceholdersState(items);
-	}, []);
-	const onLayoutChangeEvent = useEvent((next, reason) => onLayoutChange?.(next, { reason }));
-	const prevControlledRef = useRef(controlledLayout);
-	useEffect(() => {
-		if (isControlled && controlledLayout !== prevControlledRef.current) {
-			prevControlledRef.current = controlledLayout;
-			const next_0 = cloneLayout(controlledLayout ?? []);
-			layoutRef.current = next_0;
-			setLayout(next_0);
-		}
-	}, [controlledLayout, isControlled]);
-	const applyLayout = useCallback((next_1, commit, reason_0 = "normalize") => {
-		layoutRef.current = next_1;
-		setLayout(next_1);
-		if (commit) onLayoutChangeEvent(next_1, reason_0);
-	}, [onLayoutChangeEvent]);
-	return {
-		layout,
-		layoutRef,
-		placeholders,
-		placeholder: placeholders[0] ?? null,
-		placeholdersRef,
-		placeholderRef,
-		setPlaceholders,
-		applyLayout
-	};
-}
-
-//#endregion
-export { useBoardLayout };
-//# sourceMappingURL=use-board-layout.js.map

package/dist/components/layout/Board/use-board-layout.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-board-layout.js","names":["useCallback","useEffect","useRef","useState","useEvent","cloneLayout","LayoutItem","BoardLayoutChangeReason","BoardLayoutChangeInfo","reason","UseBoardLayoutOptions","layout","defaultLayout","onLayoutChange","info","UseBoardLayoutResult","layoutRef","React","MutableRefObject","placeholders","placeholder","placeholdersRef","placeholderRef","setPlaceholders","items","applyLayout","commit","useBoardLayout","options","controlledLayout","isControlled","undefined","setLayout","current","setPlaceholdersState","onLayoutChangeEvent","next","prevControlledRef"],"sources":["../../../../src/components/layout/Board/use-board-layout.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal/hooks';\n\nimport { cloneLayout, LayoutItem } from './grid-core';\n\n/**\n * Why the layout changed.\n *\n * A board commits for two different kinds of reason, and an app usually cares\n * which: a gesture is the user arranging their board, while a normalization is\n * the board fitting an existing arrangement to a constraint that moved\n * underneath it. Without this, an app that persists `onLayoutChange` has no way\n * to tell \"the user dragged a widget\" from \"the column count changed and the\n * board reflowed\", so it writes the reflow back as if it were an edit — marking\n * a document dirty nobody touched.\n *\n * - `drag` / `resize` — a pointer or keyboard gesture on this board.\n * - `transfer` — a widget arrived from, or left for, another board.\n * - `normalize` — no gesture: a reflow for a changed column count, or an\n *   auto-height widget growing to fit its content.\n */\nexport type BoardLayoutChangeReason =\n  | 'drag'\n  | 'resize'\n  | 'transfer'\n  | 'normalize';\n\n/** What `onLayoutChange` reports alongside the new layout. */\nexport interface BoardLayoutChangeInfo {\n  reason: BoardLayoutChangeReason;\n}\n\nexport interface UseBoardLayoutOptions {\n  /** Controlled layout. */\n  layout?: LayoutItem[];\n  /** Initial layout for uncontrolled usage. */\n  defaultLayout?: LayoutItem[];\n  onLayoutChange?: (layout: LayoutItem[], info: BoardLayoutChangeInfo) => void;\n}\n\nexport interface UseBoardLayoutResult {\n  layout: LayoutItem[];\n  layoutRef: React.MutableRefObject<LayoutItem[]>;\n  /**\n   * Every drop-slot preview for the gesture in flight. A single-widget drag or\n   * resize produces one; a group drag produces one per moving widget.\n   */\n  placeholders: LayoutItem[];\n  /**\n   * The grabbed widget's placeholder — `placeholders[0]`, or `null` when there\n   * is none. Kept as a derived singular so the public `BoardInteractionInfo`\n   * keeps its exact shape.\n   */\n  placeholder: LayoutItem | null;\n  /**\n   * Synchronously-updated mirrors of the two above. `setPlaceholders` only\n   * schedules a re-render, so consumers that run in the same tick as a\n   * `setPlaceholders` call (e.g. drag lifecycle callbacks fired right after the\n   * registry updates the placeholders) must read a ref to see the live value.\n   */\n  placeholdersRef: React.MutableRefObject<LayoutItem[]>;\n  placeholderRef: React.MutableRefObject<LayoutItem | null>;\n  setPlaceholders: (items: LayoutItem[]) => void;\n  /**\n   * Update the layout. `commit` fires `onLayoutChange` with `reason`, which is\n   * required on a commit so a new commit path cannot forget to say why it\n   * fired.\n   */\n  applyLayout: (\n    layout: LayoutItem[],\n    commit: boolean,\n    reason?: BoardLayoutChangeReason,\n  ) => void;\n}\n\n/**\n * Headless layout state for a single board.\n *\n * Supports both controlled (`layout`) and uncontrolled (`defaultLayout`) usage.\n * Intermediate drag/resize previews always update local state; only committed\n * changes call `onLayoutChange`.\n */\nexport function useBoardLayout(\n  options: UseBoardLayoutOptions,\n): UseBoardLayoutResult {\n  const { layout: controlledLayout, defaultLayout, onLayoutChange } = options;\n  const isControlled = controlledLayout !== undefined;\n\n  const [layout, setLayout] = useState<LayoutItem[]>(() =>\n    cloneLayout(controlledLayout ?? defaultLayout ?? []),\n  );\n  const layoutRef = useRef<LayoutItem[]>(layout);\n  layoutRef.current = layout;\n\n  const [placeholders, setPlaceholdersState] = useState<LayoutItem[]>([]);\n  const placeholdersRef = useRef<LayoutItem[]>([]);\n  const placeholderRef = useRef<LayoutItem | null>(null);\n  const setPlaceholders = useCallback((items: LayoutItem[]) => {\n    placeholdersRef.current = items;\n    // Both mirrors move in the same synchronous call, so a same-tick reader can\n    // never see the two disagree.\n    placeholderRef.current = items[0] ?? null;\n    setPlaceholdersState(items);\n  }, []);\n\n  const onLayoutChangeEvent = useEvent(\n    (next: LayoutItem[], reason: BoardLayoutChangeReason) =>\n      onLayoutChange?.(next, { reason }),\n  );\n\n  // Sync controlled prop into local state when it changes by reference.\n  const prevControlledRef = useRef(controlledLayout);\n  useEffect(() => {\n    if (isControlled && controlledLayout !== prevControlledRef.current) {\n      prevControlledRef.current = controlledLayout;\n      const next = cloneLayout(controlledLayout ?? []);\n      layoutRef.current = next;\n      setLayout(next);\n    }\n  }, [controlledLayout, isControlled]);\n\n  const applyLayout = useCallback(\n    (\n      next: LayoutItem[],\n      commit: boolean,\n      reason: BoardLayoutChangeReason = 'normalize',\n    ) => {\n      layoutRef.current = next;\n      setLayout(next);\n      if (commit) {\n        onLayoutChangeEvent(next, reason);\n      }\n    },\n    [onLayoutChangeEvent],\n  );\n\n  return {\n    layout,\n    layoutRef,\n    placeholders,\n    placeholder: placeholders[0] ?? null,\n    placeholdersRef,\n    placeholderRef,\n    setPlaceholders,\n    applyLayout,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAmFA,SAAgB2B,eACdC,SACsB;CACtB,MAAM,EAAEjB,QAAQkB,kBAAkBjB,eAAeC,mBAAmBe;CACpE,MAAME,eAAeD,qBAAqBE;CAE1C,MAAM,CAACpB,QAAQqB,aAAa7B,eAC1BE,YAAYwB,oBAAoBjB,iBAAiB,EAAE,CACrD,CAAC;CACD,MAAMI,YAAYd,OAAqBS,OAAO;AAC9CK,WAAUiB,UAAUtB;CAEpB,MAAM,CAACQ,cAAce,wBAAwB/B,SAAuB,EAAE,CAAC;CACvE,MAAMkB,kBAAkBnB,OAAqB,EAAE,CAAC;CAChD,MAAMoB,iBAAiBpB,OAA0B,KAAK;CACtD,MAAMqB,kBAAkBvB,aAAawB,UAAwB;AAC3DH,kBAAgBY,UAAUT;AAG1BF,iBAAeW,UAAUT,MAAM,MAAM;AACrCU,uBAAqBV,MAAM;IAC1B,EAAE,CAAC;CAEN,MAAMW,sBAAsB/B,UACzBgC,MAAoB3B,WACnBI,iBAAiBuB,MAAM,EAAE3B,QAAQ,CACrC,CAAC;CAGD,MAAM4B,oBAAoBnC,OAAO2B,iBAAiB;AAClD5B,iBAAgB;AACd,MAAI6B,gBAAgBD,qBAAqBQ,kBAAkBJ,SAAS;AAClEI,qBAAkBJ,UAAUJ;GAC5B,MAAMO,SAAO/B,YAAYwB,oBAAoB,EAAE,CAAC;AAChDb,aAAUiB,UAAUG;AACpBJ,aAAUI,OAAK;;IAEhB,CAACP,kBAAkBC,aAAa,CAAC;CAEpC,MAAML,cAAczB,aAEhBoC,QACAV,QACAjB,WAAkC,gBAC/B;AACHO,YAAUiB,UAAUG;AACpBJ,YAAUI,OAAK;AACf,MAAIV,OACFS,qBAAoBC,QAAM3B,SAAO;IAGrC,CAAC0B,oBACH,CAAC;AAED,QAAO;EACLxB;EACAK;EACAG;EACAC,aAAaD,aAAa,MAAM;EAChCE;EACAC;EACAC;EACAE;EACD"}