@antadesign/anta 0.3.29 → 0.3.31

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;
@@ -106,7 +114,7 @@ function isMenuOpen() {
 function isInsideOpenMenu(node) {
   return menuPresence?.contains(node) ?? false;
 }
-const SYNC_POPUP_ARIA = Symbol("anta.sync-popup-aria");
+const SYNC_POPUP_ARIA = /* @__PURE__ */ Symbol("anta.sync-popup-aria");
 function isPopupAriaReceiver(element) {
   return element != null && typeof element[SYNC_POPUP_ARIA] === "function";
 }
@@ -204,8 +212,10 @@ export {
   installDismissTrigger,
   isInsideOpenMenu,
   isMenuOpen,
+  isModifiedNavigationKey,
   isPopupAriaReceiver,
   lengthStyle,
+  lineClamp,
   nativeStateChange,
   neutralToneAttr,
   optionPresentationAttrs,