@astryxdesign/core 0.7.9-canary.dedecd0 → 0.7.9-canary.df15de7

package/dist/Breadcrumbs/BreadcrumbItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BreadcrumbItem.d.ts","sourceRoot":"","sources":["../../src/Breadcrumbs/BreadcrumbItem.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAa5C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AAM7C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAarE,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,SAAS,CAAC,aAAa,CAAC,EACxB,SAAS,CACV;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B;;;;OAIG;IACH,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAsID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,GAAG,EACH,EAAE,EACF,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EAAE,aAAa,EACxB,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,mBAAmB,qBAuMrB;yBAtNe,cAAc"}
+{"version":3,"file":"BreadcrumbItem.d.ts","sourceRoot":"","sources":["../../src/Breadcrumbs/BreadcrumbItem.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAc5C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AAM7C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAarE,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,SAAS,CAAC,aAAa,CAAC,EACxB,SAAS,CACV;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B;;;;OAIG;IACH,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AA2ID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,GAAG,EACH,EAAE,EACF,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EAAE,aAAa,EACxB,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,mBAAmB,qBAuMrB;yBAtNe,cAAc"}

package/dist/Breadcrumbs/BreadcrumbItem.js

@@ -41,6 +41,8 @@ import { menuTouchActionStyles } from "../DropdownMenu/menuTouchAction.stylex.js
 import { useMenuOverflow } from "../DropdownMenu/useMenuOverflow.js";
 import { useTypeahead } from "../hooks/useTypeahead.js";
 import { layerAnimations } from "../Layer/layerAnimations.stylex.js";
+import "../Layer/layerViewportInset.stylex.js";
+import { layerViewportInset } from "../Layer/layerViewportInset.stylex.js";
 import { renderDropdownItems } from "../DropdownMenu/renderDropdownItems.js";
 import { DropdownMenuContext, DropdownMenuRootOpenContext } from "../DropdownMenu/DropdownMenuContext.js";
 import { MENU_ITEM_ROLES, MENU_ITEM_SELECTOR, MENU_BOUNDARY_SELECTOR } from "../DropdownMenu/menuItemRoles.js";
@@ -131,7 +133,7 @@ const menuStyles = {
     k1xSpc: "x78zum5",
     kXwgrk: "xdt5ytf",
     kOIVth: "x1lsbc85",
-    kskxy: "xuyqlj2",
+    kskxy: "x1uh1i8a",
     kORKVm: "x1odjw0f",
     "--_dropdown-menu-radius": "x1fcsqxe",
     "--_dropdown-menu-padding": "xgory14",

package/dist/ContextMenu/ContextMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../src/ContextMenu/ContextMenu.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KASN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAwCrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAgI1C,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAMnD,UAAU,oBAAqB,SAAQ,SAAS;IAC9C,oDAAoD;IACpD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,wCAAwC;IACxC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,oBAAqB,SAAQ,oBAAoB;IACzD,gDAAgD;IAChD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,UAAU,wBAAyB,SAAQ,oBAAoB;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;AAM/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,IAAW,EACX,KAAK,EAAE,cAAc,EACrB,UAAkB,EAClB,YAAY,EACZ,YAAwB,EACxB,SAAiB,EACjB,GAAG,EACH,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EACb,aAAa,EAAE,iBAAiB,EAChC,YAAY,EAAE,gBAAgB,EAC9B,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,cAAc,EAC1B,aAAa,EAAE,iBAAiB,EAChC,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,gBAAgB,qBAijBlB;yBAtkBe,WAAW"}
+{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../src/ContextMenu/ContextMenu.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KASN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAyCrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAqI1C,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAMnD,UAAU,oBAAqB,SAAQ,SAAS;IAC9C,oDAAoD;IACpD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,wCAAwC;IACxC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,oBAAqB,SAAQ,oBAAoB;IACzD,gDAAgD;IAChD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,UAAU,wBAAyB,SAAQ,oBAAoB;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;AAM/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,IAAW,EACX,KAAK,EAAE,cAAc,EACrB,UAAkB,EAClB,YAAY,EACZ,YAAwB,EACxB,SAAiB,EACjB,GAAG,EACH,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EACb,aAAa,EAAE,iBAAiB,EAChC,YAAY,EAAE,gBAAgB,EAC9B,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,cAAc,EAC1B,aAAa,EAAE,iBAAiB,EAChC,aAAa,EAAE,MAAM,EACrB,GAAG,IAAI,EACR,EAAE,gBAAgB,qBAijBlB;yBAtkBe,WAAW"}

package/dist/ContextMenu/ContextMenu.js

@@ -61,6 +61,8 @@ import { useMenuPress } from "../hooks/useMenuPress.js";
 import { useTypeahead } from "../hooks/useTypeahead.js";
 import { useLongPress } from "../hooks/useLongPress.js";
 import { layerAnimations } from "../Layer/layerAnimations.stylex.js";
+import "../Layer/layerViewportInset.stylex.js";
+import { layerViewportInset } from "../Layer/layerViewportInset.stylex.js";
 import "../theme/tokens.stylex.js";
 import { colorVars, spacingVars, radiusVars, durationVars, easeVars, shadowVars } from "../theme/tokens.stylex.js";
 import { mergeProps, rtlStyles } from "../utils/index.js";
@@ -87,7 +89,7 @@ const styles = {
     k1xSpc: "x78zum5",
     kXwgrk: "xdt5ytf",
     kOIVth: "x1lsbc85",
-    kskxy: "xuyqlj2",
+    kskxy: "x1uh1i8a",
     kORKVm: "x1odjw0f",
     "--_dropdown-menu-radius": "x1fcsqxe",
     "--_dropdown-menu-padding": "xgory14",

package/dist/Layer/LayerTouch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file LayerTouch.ts
+ * @input useLayerKeyboardClearance.ts (the software keyboard's part of the
+ *   viewport caps)
+ * @output The layer runtime's touch layer: useLayerKeyboardClearance
+ * @position The one module the layer runtime imports touch-only code through,
+ *   and its only import site is useLayer.tsx. It is imported statically, as
+ *   every touch module is.
+ *
+ * SYNC: When modified, keep every touch-only import of useLayer.tsx here.
+ */
+export { useLayerKeyboardClearance } from './useLayerKeyboardClearance.js';
+//# sourceMappingURL=LayerTouch.d.ts.map

package/dist/Layer/LayerTouch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayerTouch.d.ts","sourceRoot":"","sources":["../../src/Layer/LayerTouch.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAC"}

package/dist/Layer/LayerTouch.js

@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file LayerTouch.ts
+ * @input useLayerKeyboardClearance.ts (the software keyboard's part of the
+ *   viewport caps)
+ * @output The layer runtime's touch layer: useLayerKeyboardClearance
+ * @position The one module the layer runtime imports touch-only code through,
+ *   and its only import site is useLayer.tsx. It is imported statically, as
+ *   every touch module is.
+ *
+ * SYNC: When modified, keep every touch-only import of useLayer.tsx here.
+ */
+export { useLayerKeyboardClearance } from "./useLayerKeyboardClearance.js";

package/dist/Layer/layerKeyboardClearance.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file layerKeyboardClearance.ts
+ * @input A layer's box, the layout viewport's height and the keyboard's
+ *   cover
+ * @output Exports `LAYER_KEYBOARD_CLEARANCE_PX`, `LAYER_ANCHORED_ATTRIBUTE` and
+ *   `keyboardClearanceCap`
+ * @position Layer runtime: the software keyboard cap's numbers, with no DOM
+ *   and no React. A browser proof can import them on its own.
+ *   useLayerKeyboardClearance.ts applies them.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.ts
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.test.tsx
+ */
+/**
+ * How far above the software keyboard a capped layer ends, CSS px. It is the
+ * clearance UIKit keeps under a popover the keyboard would cover.
+ * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. A
+ *   320 × 533 popover below a source at y 160 (top 204) shrank to 325 pt.
+ *   Its bottom stopped at 529, with the keyboard's top at about 539. It
+ *   shrank from UIKeyboardWillShow over the keyboard's 0.3833 s, and grew
+ *   back the same way on the hide. A 320 × 240 popover clear of the keyboard
+ *   did not move.
+ */
+export declare const LAYER_KEYBOARD_CLEARANCE_PX = 10;
+/**
+ * The attribute useLayer.tsx renders on a layer in anchor positioning. The
+ * cap reads it from the committed element at measurement, not from a value a
+ * render wrote. Only an anchored layer is capped.
+ */
+export declare const LAYER_ANCHORED_ATTRIBUTE = "data-layer-anchored";
+/**
+ * The block size that keeps a layer `LAYER_KEYBOARD_CLEARANCE_PX` above a
+ * keyboard covering `inset` px of the layout viewport's bottom. It is null
+ * when the layer, at its own size, is already clear of the keyboard.
+ */
+export declare function keyboardClearanceCap(box: {
+    top: number;
+    bottom: number;
+}, viewportHeight: number, inset: number): number | null;
+//# sourceMappingURL=layerKeyboardClearance.d.ts.map

package/dist/Layer/layerKeyboardClearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerKeyboardClearance.d.ts","sourceRoot":"","sources":["../../src/Layer/layerKeyboardClearance.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,EAClC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CASf"}

package/dist/Layer/layerKeyboardClearance.js

@@ -0,0 +1,51 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file layerKeyboardClearance.ts
+ * @input A layer's box, the layout viewport's height and the keyboard's
+ *   cover
+ * @output Exports `LAYER_KEYBOARD_CLEARANCE_PX`, `LAYER_ANCHORED_ATTRIBUTE` and
+ *   `keyboardClearanceCap`
+ * @position Layer runtime: the software keyboard cap's numbers, with no DOM
+ *   and no React. A browser proof can import them on its own.
+ *   useLayerKeyboardClearance.ts applies them.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.ts
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.test.tsx
+ */
+
+/**
+ * How far above the software keyboard a capped layer ends, CSS px. It is the
+ * clearance UIKit keeps under a popover the keyboard would cover.
+ * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. A
+ *   320 × 533 popover below a source at y 160 (top 204) shrank to 325 pt.
+ *   Its bottom stopped at 529, with the keyboard's top at about 539. It
+ *   shrank from UIKeyboardWillShow over the keyboard's 0.3833 s, and grew
+ *   back the same way on the hide. A 320 × 240 popover clear of the keyboard
+ *   did not move.
+ */
+export const LAYER_KEYBOARD_CLEARANCE_PX = 10;
+
+/**
+ * The attribute useLayer.tsx renders on a layer in anchor positioning. The
+ * cap reads it from the committed element at measurement, not from a value a
+ * render wrote. Only an anchored layer is capped.
+ */
+export const LAYER_ANCHORED_ATTRIBUTE = 'data-layer-anchored';
+
+/**
+ * The block size that keeps a layer `LAYER_KEYBOARD_CLEARANCE_PX` above a
+ * keyboard covering `inset` px of the layout viewport's bottom. It is null
+ * when the layer, at its own size, is already clear of the keyboard.
+ */
+export function keyboardClearanceCap(box, viewportHeight, inset) {
+  if (inset <= 0) {
+    return null;
+  }
+  const limit = viewportHeight - inset - LAYER_KEYBOARD_CLEARANCE_PX;
+  if (box.bottom <= limit) {
+    return null;
+  }
+  return Math.max(0, limit - box.top);
+}

package/dist/Layer/layerViewportInset.stylex.d.ts

@@ -23,7 +23,11 @@ export declare const layerViewportInset: {
     /** The largest inline size a layer may take: the viewport minus both gutters. */
     maxInlineSize: string;
     maxInlineSizeFallback: string;
-    /** The largest block size a layer may take: the viewport minus both gutters. */
+    /**
+     * The largest block size a layer may take: the viewport minus both
+     * gutters. It is no more than the room the software keyboard leaves while
+     * it caps the layer.
+     */
     maxBlockSize: string;
     maxBlockSizeFallback: string;
 };

package/dist/Layer/layerViewportInset.stylex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layerViewportInset.stylex.d.ts","sourceRoot":"","sources":["../../src/Layer/layerViewportInset.stylex.ts"],"names":[],"mappings":"AAwDA;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;IAC7B,iDAAiD;;IAEjD,+CAA+C;;IAE/C,+CAA+C;;IAE/C,gFAAgF;;;;;;IAMhF,iFAAiF;;;IAGjF,gFAAgF;;;CAGhF,CAAC"}
+{"version":3,"file":"layerViewportInset.stylex.d.ts","sourceRoot":"","sources":["../../src/Layer/layerViewportInset.stylex.ts"],"names":[],"mappings":"AA+DA;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;IAC7B,iDAAiD;;IAEjD,+CAA+C;;IAE/C,+CAA+C;;IAE/C,gFAAgF;;;;;;IAMhF,iFAAiF;;;IAGjF;;;;OAIG;;;CAGH,CAAC"}

package/dist/Layer/layerViewportInset.stylex.js

@@ -2,8 +2,10 @@
 
 /**
  * @file layerViewportInset.stylex.ts
- * @input Uses the spacing token, the device safe-area insets, and the
- *   app-declared `--astryx-layer-inset-*` custom properties
+ * @input Uses the spacing token, the device safe-area insets, the
+ *   app-declared `--astryx-layer-inset-*` custom properties, and the
+ *   keyboard cap each layer's own style declares
+ *   (`--_layer-keyboard-max-block-size`)
  * @output Exports the one definition of an anchored layer's viewport gutter
  *   and the size caps derived from it
  * @position Layer runtime geometry; read by useLayer and by consumers that
@@ -27,6 +29,7 @@
  *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/Layer/useLayer.tsx
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.ts
  * - /packages/core/src/Layer/layerViewportInset.test.ts
  * - /docs/specs/AST-059-layer-viewport-inset/spec.md
  */
@@ -41,6 +44,10 @@ const INSET_BLOCK_START = 'var(--astryx-layer-inset-block-start, 0px)';
 const INSET_BLOCK_END = 'var(--astryx-layer-inset-block-end, 0px)';
 const INSET_INLINE_START = 'var(--astryx-layer-inset-inline-start, 0px)';
 const INSET_INLINE_END = 'var(--astryx-layer-inset-inline-end, 0px)';
+// Each layer's own style declares the room the software keyboard leaves it
+// (useLayer.tsx's `keyboardCap`, from useLayerKeyboardClearance.ts). An
+// uncapped layer declares a limit out of reach.
+const KEYBOARD_CAP_PROPERTY = '--_layer-keyboard-max-block-size';
 const GUTTER_BLOCK_START = `calc(max(${SPACING}, env(safe-area-inset-top, 0px)) + ${INSET_BLOCK_START})`;
 const GUTTER_BLOCK_END = `calc(max(${SPACING}, env(safe-area-inset-bottom, 0px)) + ${INSET_BLOCK_END})`;
 const GUTTER_INLINE_LEFT = `calc(max(${SPACING}, env(safe-area-inset-left, 0px)) + ${INSET_INLINE_START})`;
@@ -72,6 +79,6 @@ export const layerViewportInset = {
   gutterInlineFallback: "calc(var(--spacing-4) + max(var(--astryx-layer-inset-inline-start, 0px), var(--astryx-layer-inset-inline-end, 0px)))",
   maxInlineSize: "calc(100vi - calc(max(var(--spacing-4), env(safe-area-inset-left, 0px)) + var(--astryx-layer-inset-inline-start, 0px)) - calc(max(var(--spacing-4), env(safe-area-inset-right, 0px)) + var(--astryx-layer-inset-inline-end, 0px)))",
   maxInlineSizeFallback: "calc(100vw - var(--spacing-4) - var(--spacing-4) - var(--astryx-layer-inset-inline-start, 0px) - var(--astryx-layer-inset-inline-end, 0px))",
-  maxBlockSize: "calc(100dvb - calc(max(var(--spacing-4), env(safe-area-inset-top, 0px)) + var(--astryx-layer-inset-block-start, 0px)) - calc(max(var(--spacing-4), env(safe-area-inset-bottom, 0px)) + var(--astryx-layer-inset-block-end, 0px)))",
-  maxBlockSizeFallback: "calc(100vh - var(--spacing-4) - var(--spacing-4) - var(--astryx-layer-inset-block-start, 0px) - var(--astryx-layer-inset-block-end, 0px))"
+  maxBlockSize: "min(calc(100dvb - calc(max(var(--spacing-4), env(safe-area-inset-top, 0px)) + var(--astryx-layer-inset-block-start, 0px)) - calc(max(var(--spacing-4), env(safe-area-inset-bottom, 0px)) + var(--astryx-layer-inset-block-end, 0px))), var(--_layer-keyboard-max-block-size, 100dvb))",
+  maxBlockSizeFallback: "min(calc(100vh - var(--spacing-4) - var(--spacing-4) - var(--astryx-layer-inset-block-start, 0px) - var(--astryx-layer-inset-block-end, 0px)), var(--_layer-keyboard-max-block-size, 100vh))"
 };

package/dist/Layer/settledBox.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The layer's box where its position option put it, without the transform an
+ * entry animation (or anything else) applies to it. A Tooltip enters from a
+ * few pixels toward its trigger, scaled down. So the transformed box of a
+ * tooltip that fits beside its trigger can read as covering it while it
+ * enters. For this one read, the layer's transforms are overridden with
+ * `none !important`, which outranks an animation. They are restored in the
+ * same task, so no frame paints in between and the animation keeps running.
+ * Where the engine still applies an animated transform under that override
+ * (WebKit), the read box has that transform undone instead (`untransform`). A
+ * layer that transitions a transform property is not overridden, since
+ * restoring the value would start that transition. Its box has its transform
+ * undone.
+ */
+export declare function settledBox(layer: HTMLElement): DOMRect;
+//# sourceMappingURL=settledBox.d.ts.map

package/dist/Layer/settledBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settledBox.d.ts","sourceRoot":"","sources":["../../src/Layer/settledBox.ts"],"names":[],"mappings":"AAoFA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAuCtD"}

package/dist/Layer/settledBox.js

@@ -0,0 +1,117 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file settledBox.ts
+ * @input A layer element
+ * @output Exports `settledBox`: the layer's box where its position option put
+ *   it, without the transform an entrance (or anything else) applies to it
+ * @position Layer runtime: the one box read the fallback order and the
+ *   software keyboard's cap both measure with (useLayer.tsx,
+ *   useLayerKeyboardClearance.ts)
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Layer/useLayer.tsx
+ * - /packages/core/src/Layer/useLayerKeyboardClearance.ts
+ */
+
+const TRANSFORM_PROPERTIES = ['transform', 'translate', 'scale', 'rotate'];
+function hasTransform(style) {
+  return TRANSFORM_PROPERTIES.some(name => {
+    const value = style.getPropertyValue(name);
+    return value !== '' && value !== 'none';
+  });
+}
+
+/**
+ * `rect`, the box of an element whose computed style still carries a 2D
+ * transform, with that transform undone. The transformed box's centre is the
+ * image of the element's centre. So undoing the transform about its origin on
+ * that centre gives the untransformed box, at the element's layout size. A
+ * transform this cannot undo (3D, or a rotation in another unit) leaves `rect`
+ * as it is.
+ */
+function untransform(rect, layer, style) {
+  const set = value => value !== '' && value !== 'none';
+  if (typeof DOMMatrix === 'undefined' || layer.offsetWidth <= 0) {
+    return rect;
+  }
+  // The individual transform properties apply before `transform`, in this
+  // order (CSS Transforms 2).
+  let matrix = new DOMMatrix();
+  if (set(style.translate)) {
+    const [x = '0', y = '0', z] = style.translate.split(' ');
+    if (z != null) {
+      return rect;
+    }
+    matrix = matrix.translate(parseFloat(x), parseFloat(y));
+  }
+  if (set(style.rotate)) {
+    if (!/^-?[\d.]+deg$/.test(style.rotate)) {
+      return rect;
+    }
+    matrix = matrix.rotate(parseFloat(style.rotate));
+  }
+  if (set(style.scale)) {
+    const [x = '1', y = x, z] = style.scale.split(' ');
+    if (z != null) {
+      return rect;
+    }
+    matrix = matrix.scale(parseFloat(x), parseFloat(y));
+  }
+  if (set(style.transform)) {
+    matrix = matrix.multiply(new DOMMatrix(style.transform));
+  }
+  if (!matrix.is2D) {
+    return rect;
+  }
+  const [originX = 0, originY = 0] = style.transformOrigin.split(' ').map(value => parseFloat(value));
+  const width = layer.offsetWidth;
+  const height = layer.offsetHeight;
+  const centre = matrix.transformPoint(new DOMPoint(width / 2 - originX, height / 2 - originY));
+  const left = rect.left + rect.width / 2 - centre.x - originX;
+  const top = rect.top + rect.height / 2 - centre.y - originY;
+  return new DOMRect(left, top, width, height);
+}
+
+/**
+ * The layer's box where its position option put it, without the transform an
+ * entry animation (or anything else) applies to it. A Tooltip enters from a
+ * few pixels toward its trigger, scaled down. So the transformed box of a
+ * tooltip that fits beside its trigger can read as covering it while it
+ * enters. For this one read, the layer's transforms are overridden with
+ * `none !important`, which outranks an animation. They are restored in the
+ * same task, so no frame paints in between and the animation keeps running.
+ * Where the engine still applies an animated transform under that override
+ * (WebKit), the read box has that transform undone instead (`untransform`). A
+ * layer that transitions a transform property is not overridden, since
+ * restoring the value would start that transition. Its box has its transform
+ * undone.
+ */
+export function settledBox(layer) {
+  const view = layer.ownerDocument.defaultView;
+  const style = view?.getComputedStyle(layer);
+  if (style == null || !hasTransform(style)) {
+    return layer.getBoundingClientRect();
+  }
+  const transitions = style.transitionProperty.split(',').map(p => p.trim());
+  const durations = style.transitionDuration.split(',').map(parseFloat);
+  const transitioned = transitions.some((name, index) => (name === 'all' || TRANSFORM_PROPERTIES.includes(name)) && (durations[index % durations.length] ?? 0) > 0);
+  if (transitioned) {
+    return untransform(layer.getBoundingClientRect(), layer, style);
+  }
+  const saved = TRANSFORM_PROPERTIES.map(name => [name, layer.style.getPropertyValue(name), layer.style.getPropertyPriority(name)]);
+  for (const name of TRANSFORM_PROPERTIES) {
+    layer.style.setProperty(name, 'none', 'important');
+  }
+  const box = layer.getBoundingClientRect();
+  const under = view?.getComputedStyle(layer);
+  const settled = under != null && hasTransform(under) ? untransform(box, layer, under) : box;
+  for (const [name, value, priority] of saved) {
+    if (value === '') {
+      layer.style.removeProperty(name);
+    } else {
+      layer.style.setProperty(name, value, priority);
+    }
+  }
+  return settled;
+}

package/dist/Layer/useLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLayer.d.ts","sourceRoot":"","sources":["../../src/Layer/useLayer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"useLayer.d.ts","sourceRoot":"","sources":["../../src/Layer/useLayer.tsx"],"names":[],"mappings":"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"}

package/dist/Layer/useLayer.js

@@ -25,6 +25,9 @@ import { layerTextReset } from "./layerTextReset.stylex.js";
 import { layerStructureReset } from "./layerStructureReset.stylex.js";
 import "./layerViewportInset.stylex.js";
 import { layerViewportInset } from "./layerViewportInset.stylex.js";
+import { useLayerKeyboardClearance } from "./LayerTouch.js";
+import { LAYER_ANCHORED_ATTRIBUTE } from "./layerKeyboardClearance.js";
+import { settledBox } from "./settledBox.js";
 import { layerInsetProperties } from "./layerInset.js";
 import { LAYER_CLEARANCE_PROPERTY, LAYER_CLEARS_ANCHOR_ATTRIBUTE, LAYER_SCROLLS_ATTRIBUTE, LAYER_CLEAR_FALLBACKS_PROPERTY, LAYER_TRY_FALLBACKS_PROPERTY, ensureSlideRules, getAnchorClearFallbacks, slideRuleName } from "./layerSlideRules.js";
 import { afterPopoverOperations, isBrowserHideInFlight, isPopoverOperationInFlight, observeBrowserHide, runPopoverOperation } from "./popoverOperations.js";
@@ -52,6 +55,14 @@ const _temp4 = {
   "$$css": true
 };
 const styles = {
+  keyboardCap: (cap, overflow) => [{
+    "--_layer-keyboard-max-block-size": cap != null ? "x1ex41ac" : cap,
+    "--_layer-keyboard-overflow": overflow != null ? "xypflj0" : overflow,
+    $$css: true
+  }, {
+    "--x---_layer-keyboard-max-block-size": cap != null ? cap : undefined,
+    "--x---_layer-keyboard-overflow": overflow != null ? overflow : undefined
+  }],
   base: {
     keoZOQ: "xdj266r",
     k1K539: "xat24cr",
@@ -197,64 +208,6 @@ function placeAfresh(layer) {
     layer.style.display = display;
   });
 }
-const TRANSFORM_PROPERTIES = ['transform', 'translate', 'scale', 'rotate'];
-function hasTransform(style) {
-  return TRANSFORM_PROPERTIES.some(name => {
-    const value = style.getPropertyValue(name);
-    return value !== '' && value !== 'none';
-  });
-}
-
-/**
- * `rect`, the box of an element whose computed style still carries a 2D
- * transform, with that transform undone: the transformed box's centre is the
- * image of the element's centre, so undoing the transform about its origin on
- * that centre gives the untransformed box, at the element's layout size. A
- * transform this cannot undo (3D, or a rotation in another unit) leaves `rect`
- * as it is.
- */
-function untransform(rect, layer, style) {
-  const set = value => value !== '' && value !== 'none';
-  if (typeof DOMMatrix === 'undefined' || layer.offsetWidth <= 0) {
-    return rect;
-  }
-  // The individual transform properties apply before `transform`, in this
-  // order (CSS Transforms 2).
-  let matrix = new DOMMatrix();
-  if (set(style.translate)) {
-    const [x = '0', y = '0', z] = style.translate.split(' ');
-    if (z != null) {
-      return rect;
-    }
-    matrix = matrix.translate(parseFloat(x), parseFloat(y));
-  }
-  if (set(style.rotate)) {
-    if (!/^-?[\d.]+deg$/.test(style.rotate)) {
-      return rect;
-    }
-    matrix = matrix.rotate(parseFloat(style.rotate));
-  }
-  if (set(style.scale)) {
-    const [x = '1', y = x, z] = style.scale.split(' ');
-    if (z != null) {
-      return rect;
-    }
-    matrix = matrix.scale(parseFloat(x), parseFloat(y));
-  }
-  if (set(style.transform)) {
-    matrix = matrix.multiply(new DOMMatrix(style.transform));
-  }
-  if (!matrix.is2D) {
-    return rect;
-  }
-  const [originX = 0, originY = 0] = style.transformOrigin.split(' ').map(value => parseFloat(value));
-  const width = layer.offsetWidth;
-  const height = layer.offsetHeight;
-  const centre = matrix.transformPoint(new DOMPoint(width / 2 - originX, height / 2 - originY));
-  const left = rect.left + rect.width / 2 - centre.x - originX;
-  const top = rect.top + rect.height / 2 - centre.y - originY;
-  return new DOMRect(left, top, width, height);
-}
 
 /**
  * The finite animations still running on `layer` and its content. A layer
@@ -270,48 +223,6 @@ function exitAnimations(layer) {
   }).filter(animation => animation.playState === 'running' && animation.effect?.getComputedTiming().endTime !== Infinity);
 }
 
-/**
- * The layer's box where its position option put it, without the transform an
- * entry animation (or anything else) applies to it: a Tooltip enters from a
- * few pixels toward its trigger, scaled down, so the transformed box of a
- * tooltip that fits beside its trigger can read as covering it while it
- * enters. The layer's transforms are overridden with `none !important`, which
- * outranks an animation, for this one read and then restored, in the same
- * task: no frame paints in between and the animation keeps running. Where the
- * engine still applies an animated transform under that override (WebKit),
- * the read box has that transform undone instead (`untransform`). A layer
- * that transitions a transform property is not overridden, since restoring the
- * value would start that transition; its box has its transform undone.
- */
-function settledBox(layer) {
-  const view = layer.ownerDocument.defaultView;
-  const style = view?.getComputedStyle(layer);
-  if (style == null || !hasTransform(style)) {
-    return layer.getBoundingClientRect();
-  }
-  const transitions = style.transitionProperty.split(',').map(p => p.trim());
-  const durations = style.transitionDuration.split(',').map(parseFloat);
-  const transitioned = transitions.some((name, index) => (name === 'all' || TRANSFORM_PROPERTIES.includes(name)) && (durations[index % durations.length] ?? 0) > 0);
-  if (transitioned) {
-    return untransform(layer.getBoundingClientRect(), layer, style);
-  }
-  const saved = TRANSFORM_PROPERTIES.map(name => [name, layer.style.getPropertyValue(name), layer.style.getPropertyPriority(name)]);
-  for (const name of TRANSFORM_PROPERTIES) {
-    layer.style.setProperty(name, 'none', 'important');
-  }
-  const box = layer.getBoundingClientRect();
-  const under = view?.getComputedStyle(layer);
-  const settled = under != null && hasTransform(under) ? untransform(box, layer, under) : box;
-  for (const [name, value, priority] of saved) {
-    if (value === '') {
-      layer.style.removeProperty(name);
-    } else {
-      layer.style.setProperty(name, value, priority);
-    }
-  }
-  return settled;
-}
-
 /**
  * Whether the standard list has failed a layer that must keep its anchor
  * clear: its box covers the anchor or, while the anchor is in view, leaves the
@@ -1258,6 +1169,13 @@ function useLayerImplementation(options) {
       listenedHandlerRef.current = handler;
     }
   }, [handleBeforeToggle]);
+
+  // An anchored layer that would run under the software keyboard keeps its
+  // block-start edge and ends clear of the keyboard.
+  const {
+    cap: keyboardCap,
+    followLayerElement
+  } = useLayerKeyboardClearance(isOpen && mode === 'context', popoverRef);
   const popoverRefCallback = useCallback(el => {
     popoverRef.current = el;
     bindToggleListener(el, handleToggle);
@@ -1268,7 +1186,9 @@ function useLayerImplementation(options) {
       // Changing a portal target remounts the popover. Preserve the logical
       // open state without firing onShow again for the replacement element.
       // A show the browser refused during one of its own hides replays once
-      // that hide has ended, for the element still mounted then.
+      // that hide has ended, for the element still mounted then. The
+      // keyboard cap follows the replacement element too.
+      followLayerElement();
       if (showPopoverElement(el)) {
         if (keepsAnchorClear) {
           keepAnchorClear(el, triggerRef.current);
@@ -1282,7 +1202,7 @@ function useLayerImplementation(options) {
         });
       }
     }
-  }, [handleToggle, bindToggleListener, show, showPopoverElement, isCurrentContextPopover, keepsAnchorClear]);
+  }, [handleToggle, bindToggleListener, show, showPopoverElement, isCurrentContextPopover, keepsAnchorClear, followLayerElement]);
   const sentinelRefCallback = useCallback(el => {
     sentinelRef.current = el;
     // A layer that keeps its mount re-resolves it too once it has one.
@@ -1413,7 +1333,7 @@ function useLayerImplementation(options) {
     } : {};
     const offsetStyle = positioning !== 'anchor' ? null : clearance == null ? placement === 'above' ? styles.farAbove : placement === 'below' ? styles.farBelow : placement === 'start' ? styles.farStart : styles.farEnd : placement === 'above' ? styles.placementAbove(clearance) : placement === 'below' ? styles.placementBelow(clearance) : placement === 'start' ? styles.placementStart(clearance) : styles.placementEnd(clearance);
     const viewportStyles = positioning === 'anchor' ? [styles.viewportFit, ...getGutterStyles(placement, alignment)] : null;
-    const stylexResult = stylex.props(layerTextReset.reset, layerStructureReset.reset, styles.base, overlayPaddingReset.reset, viewportStyles, offsetStyle, xstyle);
+    const stylexResult = stylex.props(layerTextReset.reset, layerStructureReset.reset, styles.base, overlayPaddingReset.reset, styles.keyboardCap(keyboardCap == null ? '100vh' : `${keyboardCap}px`, keyboardCap == null ? 'visible' : 'auto'), viewportStyles, offsetStyle, xstyle);
     const combinedClassName = extraClassName ? `${extraClassName} ${stylexResult.className ?? ''}` : stylexResult.className;
 
     // The marker gives us the actual JSX parent without mounting arbitrary
@@ -1422,7 +1342,14 @@ function useLayerImplementation(options) {
     // The slot renders the layer once the hook has resolved that mount.
     const renderLayer = mount => /*#__PURE__*/_jsx(Container, {
       ref: popoverRefCallback,
-      id: id,
+      id: id
+      // Anchor positioning, as this commit renders it: the software
+      // keyboard caps only an anchored layer, and reads this at
+      // measurement.
+      ,
+      ...(positioning === 'anchor' ? {
+        [LAYER_ANCHORED_ATTRIBUTE]: ''
+      } : {}),
       role: role,
       "aria-label": ariaLabel,
       popover: lightDismiss ? 'auto' : 'manual',
@@ -1451,7 +1378,7 @@ function useLayerImplementation(options) {
       renderLayer: renderLayer,
       sentinelRef: sentinelRefCallback
     });
-  }, [anchorId, declaredInset, id, isAnchorInView, keepsAnchorClear, lightDismiss, mountStore, popoverRefCallback, sentinelRefCallback]);
+  }, [anchorId, declaredInset, id, isAnchorInView, keepsAnchorClear, keyboardCap, lightDismiss, mountStore, popoverRefCallback, sentinelRefCallback]);
 
   // Render function for fixed mode
   const renderFixed = useCallback((children, props) => {
@@ -1468,7 +1395,10 @@ function useLayerImplementation(options) {
       top: y,
       left: x
     };
-    const stylexResult = stylex.props(layerTextReset.reset, layerStructureReset.reset, styles.base, overlayPaddingReset.reset, styles.fixed, xstyle);
+    const stylexResult = stylex.props(layerTextReset.reset, layerStructureReset.reset, styles.base, overlayPaddingReset.reset,
+    // A fixed layer is never capped; it still sets its own limit so it is
+    // not clamped by a capped layer it sits in.
+    styles.keyboardCap('100vh', 'visible'), styles.fixed, xstyle);
     const combinedClassName = extraClassName ? `${extraClassName} ${stylexResult.className ?? ''}` : stylexResult.className;
     return /*#__PURE__*/_jsx("div", {
       ref: popoverRefCallback,