@antadesign/anta 0.3.30 → 0.3.32

package/dist/anta_helpers.d.ts

@@ -57,6 +57,10 @@ export declare function nativeStateChange<D>(e: StateChangeEvent<D>): {
 export declare function customEventHandler<D>(handler?: (event: CustomEvent<D>, detail: D) => void): ((input: StateChangeEvent<D>) => void) | undefined;
 /** Parse a finite number, falling back for missing, empty, or invalid values. */
 export declare function finiteNumber(value: string | number | null, fallback: number): number;
+/** Normalize the JSX `truncate` shorthand to a positive CSS line count. */
+export declare function lineClamp(truncate: boolean | number | undefined): number | undefined;
+/** Leave modified navigation to the browser, OS, or text field. Shift+Tab remains focus navigation. */
+export declare function isModifiedNavigationKey(event: Pick<KeyboardEvent, 'key' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'>): boolean;
 export declare const IS_MAC: boolean;
 /** Default row hint teaching the Alt/⌥-click "select only this" accelerator on
  *  bulk-select rows (`Select` multiple, `SelectFaceted` multiple facets). Shared

package/dist/anta_helpers.js

@@ -36,6 +36,14 @@ function finiteNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) ? number : fallback;
 }
+function lineClamp(truncate) {
+  const lines = typeof truncate === "number" ? truncate : truncate ? 1 : void 0;
+  return lines != null && lines >= 1 ? lines : void 0;
+}
+const NAVIGATION_KEYS = /* @__PURE__ */ new Set(["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End", "PageUp", "PageDown", "Tab"]);
+function isModifiedNavigationKey(event) {
+  return NAVIGATION_KEYS.has(event.key) && (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey && event.key !== "Tab");
+}
 const IS_MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad/i.test(navigator.userAgent || "");
 const ISOLATE_HINT = IS_MAC ? "\u2325+Click to select only this" : "Alt+Click to select only this";
 const ISOLATE_HINT_DELAY = 700;
@@ -204,8 +212,10 @@ export {
   installDismissTrigger,
   isInsideOpenMenu,
   isMenuOpen,
+  isModifiedNavigationKey,
   isPopupAriaReceiver,
   lengthStyle,
+  lineClamp,
   nativeStateChange,
   neutralToneAttr,
   optionPresentationAttrs,

package/dist/box-types.d.ts

@@ -120,11 +120,22 @@ export interface BoxContext {
      * own background is not behind it. */
     backgroundColor: string;
 }
-/** Current box dimensions and its content-overflow state. */
+/** A descendant's border box, in CSS pixels from the Box's top-left border edge. */
+export interface BoxRect {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+}
+/** Current box dimensions, matching descendant rects, and content-overflow state. */
 export interface BoxMeasurement {
     /** Border-box width and height in CSS pixels. */
     width: number;
     height: number;
+    /** Matches for `includeRectsFor`, in document order. Empty when omitted. */
+    rects: BoxRect[];
     /** Padding-box dimensions, matching the browser's `clientWidth` / `clientHeight`. */
     clientWidth: number;
     clientHeight: number;