@jirawatpyk/aura-react 5.68.0 → 5.69.0

package/README.md

@@ -186,6 +186,12 @@ DataTable with sort and page in the URL (4.17): `onStateChange={({ sort, page })
 - **Time zone**: `timeZone` on AuraProvider, DatePicker, DateRangePicker and Calendar decides "today" (the marker, `min`/`max="today"`, the first month shown); or pass `today` as an ISO date. `todayIn('Asia/Bangkok')` is exported from the root and `/server`.
 - **Toasts** queue past three instead of dropping: six in a row all show, in order, three at a time.
 
+## 5.69 — Chamber-OS addendum 86 (#185)
+
+- **ActionBar's edge look:** a `position="viewport"` bar takes `look="edge"` (every width) or `edgeBelow="sm"` / `"md"` (the strip below 640px / 768px, the card at and above it — as PageHeader's `actionsBarBelow`) and draws PageHeader's edge strip: the screen's full width, on the bottom edge or directly on a BottomNav, a top border only (no radius, shadow or top margin), the home-indicator inset as padding inside it. `look="floating"` (default) is the inset card, unchanged; a `container` bar ignores both props.
+- **Its promises hold:** the strip is `position: fixed`, so it stays on screen for the whole page, not only while its form is. As PageHeader's bar, `<html>` gets its measured height as `--aura-actionbar-height` (60px before hydration; the home-indicator padding counts), the page's end is padded by it (AppShell's content, else the `body`) and `scroll-padding-bottom` keeps a focused field clear — so the last field, and anything after the form, scroll clear. The ActionBar root is the strip, so `getBoundingClientRect()` on it measures the strip. On a screen 30rem tall or less it is static, in the flow, as every bar. An idle bulk bar (`selected={0}`) stays folded away and adds no room. Drop your own clearance (a hook adding the bar's height to `scroll-padding-bottom` or page padding) when you adopt `look` / `edgeBelow`, or it is counted twice. Buttons stay 44px on a phone; `start`, `status`, `children`, the region and its label are unchanged.
+- **Mind:** a transform, filter, `will-change` or paint containment on an ancestor places a fixed strip against that ancestor instead of the screen (a dev warning says so), and `look="edge"` at desktop widths spans the screen under a side nav — use `edgeBelow` for a phone-only strip. Passing both `look="edge"` and `edgeBelow` warns in development (`look` wins). Replace a hand-built `position: fixed` pay band with `<ActionBar edgeBelow="sm">`.
+
 ## 5.68 — Chamber-OS addendum 85 (#184)
 
 - **A disabled group dims its legend:** `RadioGroup` and `CheckboxGroup` with `disabled` add `is-disabled` to the fieldset, so the legend takes the disabled colour (`fg-secondary`) a disabled `Field`'s label has — a form that disables its fields while submitting no longer shows group legends at full contrast over dimmed controls.

package/dist/aura.bundle.js

@@ -409,6 +409,14 @@ window.Aura = (() => {
     return !e.defaultPrevented && e.button === 0 && !e.metaKey && !e.ctrlKey && !e.shiftKey && !e.altKey;
   }
   var FilterSheet = React3.createContext(false);
+  function fixedTrapped(el) {
+    for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
+      const s = getComputedStyle(p);
+      if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
+        return true;
+    }
+    return false;
+  }
 
   // src/display.tsx
   var React4 = __toESM(require_react(), 1);
@@ -8113,14 +8121,6 @@ window.Aura = (() => {
   // src/PageHeaderClient.tsx
   var NAME = "--aura-page-actions-height";
   var bars = [];
-  function trapped(el) {
-    for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
-      const s = getComputedStyle(p);
-      if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
-        return true;
-    }
-    return false;
-  }
   var PageHeader3 = React45.forwardRef(function PageHeader4(props, ref) {
     const own = React45.useRef(null);
     const merged = useMergedRef(ref, own);
@@ -8137,7 +8137,7 @@ window.Aura = (() => {
           if (bars[bars.length - 1] !== sync) return;
           if (getComputedStyle(el).position === "fixed") {
             root.style.setProperty(NAME, el.offsetHeight + "px");
-            if (!checked && (checked = true, trapped(el)))
+            if (!checked && (checked = true, fixedTrapped(el)))
               devWarnOnce(
                 "pageheader-bar-trapped",
                 "PageHeader actionsBarBelow: an ancestor has a transform, filter, will-change or paint containment, so the fixed bar is placed against it instead of the screen. Remove it from the page header's ancestors."
@@ -8680,6 +8680,17 @@ window.Aura = (() => {
 
   // src/ActionBar.tsx
   var React50 = __toESM(require_react(), 1);
+  var HEIGHT = "--aura-actionbar-height";
+  var edges = [];
+  function writeHeight() {
+    const root = document.documentElement;
+    for (let i = edges.length - 1; i >= 0; i--)
+      if (getComputedStyle(edges[i]).position === "fixed") {
+        root.style.setProperty(HEIGHT, edges[i].offsetHeight + "px");
+        return;
+      }
+    root.style.removeProperty(HEIGHT);
+  }
   var ActionBar = React50.forwardRef(function ActionBar2(props, ref) {
     const t = useStrings();
     const bulk = props.selected != null;
@@ -8690,6 +8701,40 @@ window.Aura = (() => {
     });
     const cameFrom = React50.useRef(null);
     const own = React50.useRef(null);
+    const viewport = (props.position || "viewport") === "viewport";
+    const edge = !viewport ? null : props.look === "edge" ? "all" : props.edgeBelow || null;
+    if (props.look === "edge" && props.edgeBelow && viewport)
+      devWarnOnce(
+        "actionbar-edge-both",
+        'ActionBar: look="edge" draws the edge strip at every width, so edgeBelow does nothing. Pass edgeBelow alone for a strip on a phone and the floating card above it.'
+      );
+    React50.useEffect(
+      function() {
+        const el = own.current;
+        if (!edge || !el) return;
+        let checked = false;
+        function sync() {
+          writeHeight();
+          if (!checked && getComputedStyle(el).position === "fixed" && (checked = true, fixedTrapped(el)))
+            devWarnOnce(
+              "actionbar-edge-trapped",
+              `ActionBar look="edge": an ancestor has a transform, filter, will-change or paint containment, so the fixed strip is placed against it instead of the screen. Remove it from the bar's ancestors.`
+            );
+        }
+        edges.push(el);
+        const ro = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(sync);
+        if (ro) ro.observe(el, { box: "border-box" });
+        window.addEventListener("resize", sync);
+        sync();
+        return function() {
+          if (ro) ro.disconnect();
+          window.removeEventListener("resize", sync);
+          edges.splice(edges.indexOf(el), 1);
+          writeHeight();
+        };
+      },
+      [edge, idle]
+    );
     function clear() {
       props.onClearSelection();
       setTimeout(function() {
@@ -8716,6 +8761,7 @@ window.Aura = (() => {
         className: cx(
           "aura-actionbar",
           "aura-actionbar--" + (props.position || "viewport"),
+          edge && (edge === "all" ? "aura-actionbar--edge" : "aura-actionbar--edge-below-" + edge),
           idle && "is-idle",
           props.className
         )

package/dist/cjs/index.cjs

@@ -391,6 +391,14 @@ function plainClick(e) {
   return !e.defaultPrevented && e.button === 0 && !e.metaKey && !e.ctrlKey && !e.shiftKey && !e.altKey;
 }
 var FilterSheet = React3.createContext(false);
+function fixedTrapped(el) {
+  for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
+    const s = getComputedStyle(p);
+    if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
+      return true;
+  }
+  return false;
+}
 
 // src/display.tsx
 var React4 = __toESM(require("react"), 1);
@@ -8095,14 +8103,6 @@ var PageHeader = React44.forwardRef(function PageHeader2(props, ref) {
 // src/PageHeaderClient.tsx
 var NAME = "--aura-page-actions-height";
 var bars = [];
-function trapped(el) {
-  for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
-    const s = getComputedStyle(p);
-    if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
-      return true;
-  }
-  return false;
-}
 var PageHeader3 = React45.forwardRef(function PageHeader4(props, ref) {
   const own = React45.useRef(null);
   const merged = useMergedRef(ref, own);
@@ -8119,7 +8119,7 @@ var PageHeader3 = React45.forwardRef(function PageHeader4(props, ref) {
         if (bars[bars.length - 1] !== sync) return;
         if (getComputedStyle(el).position === "fixed") {
           root.style.setProperty(NAME, el.offsetHeight + "px");
-          if (!checked && (checked = true, trapped(el)))
+          if (!checked && (checked = true, fixedTrapped(el)))
             devWarnOnce(
               "pageheader-bar-trapped",
               "PageHeader actionsBarBelow: an ancestor has a transform, filter, will-change or paint containment, so the fixed bar is placed against it instead of the screen. Remove it from the page header's ancestors."
@@ -8662,6 +8662,17 @@ var AppShell = React49.forwardRef(function AppShell2(props, ref) {
 
 // src/ActionBar.tsx
 var React50 = __toESM(require("react"), 1);
+var HEIGHT = "--aura-actionbar-height";
+var edges = [];
+function writeHeight() {
+  const root = document.documentElement;
+  for (let i = edges.length - 1; i >= 0; i--)
+    if (getComputedStyle(edges[i]).position === "fixed") {
+      root.style.setProperty(HEIGHT, edges[i].offsetHeight + "px");
+      return;
+    }
+  root.style.removeProperty(HEIGHT);
+}
 var ActionBar = React50.forwardRef(function ActionBar2(props, ref) {
   const t = useStrings();
   const bulk = props.selected != null;
@@ -8672,6 +8683,40 @@ var ActionBar = React50.forwardRef(function ActionBar2(props, ref) {
   });
   const cameFrom = React50.useRef(null);
   const own = React50.useRef(null);
+  const viewport = (props.position || "viewport") === "viewport";
+  const edge = !viewport ? null : props.look === "edge" ? "all" : props.edgeBelow || null;
+  if (props.look === "edge" && props.edgeBelow && viewport)
+    devWarnOnce(
+      "actionbar-edge-both",
+      'ActionBar: look="edge" draws the edge strip at every width, so edgeBelow does nothing. Pass edgeBelow alone for a strip on a phone and the floating card above it.'
+    );
+  React50.useEffect(
+    function() {
+      const el = own.current;
+      if (!edge || !el) return;
+      let checked = false;
+      function sync() {
+        writeHeight();
+        if (!checked && getComputedStyle(el).position === "fixed" && (checked = true, fixedTrapped(el)))
+          devWarnOnce(
+            "actionbar-edge-trapped",
+            `ActionBar look="edge": an ancestor has a transform, filter, will-change or paint containment, so the fixed strip is placed against it instead of the screen. Remove it from the bar's ancestors.`
+          );
+      }
+      edges.push(el);
+      const ro = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(sync);
+      if (ro) ro.observe(el, { box: "border-box" });
+      window.addEventListener("resize", sync);
+      sync();
+      return function() {
+        if (ro) ro.disconnect();
+        window.removeEventListener("resize", sync);
+        edges.splice(edges.indexOf(el), 1);
+        writeHeight();
+      };
+    },
+    [edge, idle]
+  );
   function clear() {
     props.onClearSelection();
     setTimeout(function() {
@@ -8698,6 +8743,7 @@ var ActionBar = React50.forwardRef(function ActionBar2(props, ref) {
       className: cx(
         "aura-actionbar",
         "aura-actionbar--" + (props.position || "viewport"),
+        edge && (edge === "all" ? "aura-actionbar--edge" : "aura-actionbar--edge-below-" + edge),
         idle && "is-idle",
         props.className
       )

package/dist/esm/ActionBar.js

@@ -1,8 +1,19 @@
 'use client';
 import * as React from "react";
 import { Button } from "./Button.js";
-import { cx } from "./internal.js";
+import { cx, devWarnOnce, fixedTrapped } from "./internal.js";
 import { useStrings } from "./locale.js";
+const HEIGHT = "--aura-actionbar-height";
+const edges = [];
+function writeHeight() {
+  const root = document.documentElement;
+  for (let i = edges.length - 1; i >= 0; i--)
+    if (getComputedStyle(edges[i]).position === "fixed") {
+      root.style.setProperty(HEIGHT, edges[i].offsetHeight + "px");
+      return;
+    }
+  root.style.removeProperty(HEIGHT);
+}
 const ActionBar = React.forwardRef(function ActionBar2(props, ref) {
   const t = useStrings();
   const bulk = props.selected != null;
@@ -13,6 +24,40 @@ const ActionBar = React.forwardRef(function ActionBar2(props, ref) {
   });
   const cameFrom = React.useRef(null);
   const own = React.useRef(null);
+  const viewport = (props.position || "viewport") === "viewport";
+  const edge = !viewport ? null : props.look === "edge" ? "all" : props.edgeBelow || null;
+  if (props.look === "edge" && props.edgeBelow && viewport)
+    devWarnOnce(
+      "actionbar-edge-both",
+      'ActionBar: look="edge" draws the edge strip at every width, so edgeBelow does nothing. Pass edgeBelow alone for a strip on a phone and the floating card above it.'
+    );
+  React.useEffect(
+    function() {
+      const el = own.current;
+      if (!edge || !el) return;
+      let checked = false;
+      function sync() {
+        writeHeight();
+        if (!checked && getComputedStyle(el).position === "fixed" && (checked = true, fixedTrapped(el)))
+          devWarnOnce(
+            "actionbar-edge-trapped",
+            `ActionBar look="edge": an ancestor has a transform, filter, will-change or paint containment, so the fixed strip is placed against it instead of the screen. Remove it from the bar's ancestors.`
+          );
+      }
+      edges.push(el);
+      const ro = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(sync);
+      if (ro) ro.observe(el, { box: "border-box" });
+      window.addEventListener("resize", sync);
+      sync();
+      return function() {
+        if (ro) ro.disconnect();
+        window.removeEventListener("resize", sync);
+        edges.splice(edges.indexOf(el), 1);
+        writeHeight();
+      };
+    },
+    [edge, idle]
+  );
   function clear() {
     props.onClearSelection();
     setTimeout(function() {
@@ -39,6 +84,7 @@ const ActionBar = React.forwardRef(function ActionBar2(props, ref) {
       className: cx(
         "aura-actionbar",
         "aura-actionbar--" + (props.position || "viewport"),
+        edge && (edge === "all" ? "aura-actionbar--edge" : "aura-actionbar--edge-below-" + edge),
         idle && "is-idle",
         props.className
       )

package/dist/esm/PageHeaderClient.js

@@ -1,17 +1,9 @@
 'use client';
 import * as React from "react";
 import { PageHeader as StaticPageHeader } from "./PageHeader.js";
-import { devWarnOnce, useMergedRef } from "./internal.js";
+import { devWarnOnce, fixedTrapped as trapped, useMergedRef } from "./internal.js";
 const NAME = "--aura-page-actions-height";
 const bars = [];
-function trapped(el) {
-  for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
-    const s = getComputedStyle(p);
-    if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
-      return true;
-  }
-  return false;
-}
 const PageHeader = React.forwardRef(function PageHeader2(props, ref) {
   const own = React.useRef(null);
   const merged = useMergedRef(ref, own);

package/dist/esm/internal.js

@@ -109,6 +109,14 @@ function plainClick(e) {
   return !e.defaultPrevented && e.button === 0 && !e.metaKey && !e.ctrlKey && !e.shiftKey && !e.altKey;
 }
 const FilterSheet = React.createContext(false);
+function fixedTrapped(el) {
+  for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
+    const s = getComputedStyle(p);
+    if (s.transform !== "none" || s.filter !== "none" || (s.backdropFilter || "none") !== "none" || s.contentVisibility === "auto" || s.perspective !== "none" || /transform|filter|perspective/.test(s.willChange) || /paint|layout|strict|content/.test(s.contain))
+      return true;
+  }
+  return false;
+}
 export {
   FOCUSABLE,
   FilterSheet,
@@ -117,6 +125,7 @@ export {
   compare,
   cx,
   devWarnOnce,
+  fixedTrapped,
   focusFirst,
   inClosedDetails,
   isTabStop,

package/dist/index.d.cts

@@ -1514,6 +1514,16 @@ export interface ActionBarProps {
 	 * parent, so they never cover the last field. Make it the last child of the form or card it belongs to: like any
 	 * `position: sticky` element it sticks only while that parent is on screen. */
 	position?: "viewport" | "container" | undefined;
+	/** 5.69 (Chamber-OS 185), `position="viewport"` only. `floating` (default): the inset card, bordered all round,
+	 * rounded, with a shadow. `edge`: PageHeader's edge strip at every width — the screen's full width, on the bottom
+	 * edge or on a BottomNav, a top border only, the home-indicator inset inside it. The strip is `position: fixed` and
+	 * stays on screen for the whole page (not only while its form is), so, as PageHeader's bar, the page gains its height
+	 * at the end (`--aura-actionbar-height` on `<html>`) and a focused field scrolls clear; on a screen 30rem tall or
+	 * less it is static, in the flow. For a strip on a phone only, use `edgeBelow`. */
+	look?: "floating" | "edge" | undefined;
+	/** 5.69 (Chamber-OS 185), `position="viewport"` only: the edge strip below this width (`sm` 640px, `md` 768px),
+	 * the `look` card at and above it — as PageHeader's `actionsBarBelow`. */
+	edgeBelow?: "sm" | "md" | undefined;
 	/** 5.35 (DxT Monitor #14): while this bar is on the page, a BottomNav (and its spacer) is hidden and the bar takes the
 	 * bottom edge — for a page whose own actions (Acknowledge, Visit site) replace the tab bar. Any element can do the
 	 * same with the `data-aura-hide-bottomnav` attribute. */
@@ -2296,8 +2306,6 @@ export declare const STRINGS: {
 export declare const TileGrid: React$1.ForwardRefExoticComponent<TileGridProps & React$1.RefAttributes<HTMLUListElement>>;
 export declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<SVGSVGElement>>;
 export declare const AppShell: React$1.ForwardRefExoticComponent<AppShellProps & React$1.RefAttributes<HTMLDivElement>>;
-/** ActionBar — a bar stuck to the bottom of the screen or of a card: a status line and the form's or selection's
- * actions. It is `position: sticky`, so it stays in the flow at the end of its parent and never covers the last field. */
 export declare const ActionBar: React$1.ForwardRefExoticComponent<ActionBarProps & React$1.RefAttributes<HTMLDivElement>>;
 /** Separator — a 1px `aura-border-default` rule between groups of content (4.20). Decorative by default (hidden from
  * screen readers); `decorative={false}` makes it a `role="separator"` that is announced. */

package/dist/index.d.ts

@@ -1514,6 +1514,16 @@ export interface ActionBarProps {
 	 * parent, so they never cover the last field. Make it the last child of the form or card it belongs to: like any
 	 * `position: sticky` element it sticks only while that parent is on screen. */
 	position?: "viewport" | "container" | undefined;
+	/** 5.69 (Chamber-OS 185), `position="viewport"` only. `floating` (default): the inset card, bordered all round,
+	 * rounded, with a shadow. `edge`: PageHeader's edge strip at every width — the screen's full width, on the bottom
+	 * edge or on a BottomNav, a top border only, the home-indicator inset inside it. The strip is `position: fixed` and
+	 * stays on screen for the whole page (not only while its form is), so, as PageHeader's bar, the page gains its height
+	 * at the end (`--aura-actionbar-height` on `<html>`) and a focused field scrolls clear; on a screen 30rem tall or
+	 * less it is static, in the flow. For a strip on a phone only, use `edgeBelow`. */
+	look?: "floating" | "edge" | undefined;
+	/** 5.69 (Chamber-OS 185), `position="viewport"` only: the edge strip below this width (`sm` 640px, `md` 768px),
+	 * the `look` card at and above it — as PageHeader's `actionsBarBelow`. */
+	edgeBelow?: "sm" | "md" | undefined;
 	/** 5.35 (DxT Monitor #14): while this bar is on the page, a BottomNav (and its spacer) is hidden and the bar takes the
 	 * bottom edge — for a page whose own actions (Acknowledge, Visit site) replace the tab bar. Any element can do the
 	 * same with the `data-aura-hide-bottomnav` attribute. */
@@ -2296,8 +2306,6 @@ export declare const STRINGS: {
 export declare const TileGrid: React$1.ForwardRefExoticComponent<TileGridProps & React$1.RefAttributes<HTMLUListElement>>;
 export declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<SVGSVGElement>>;
 export declare const AppShell: React$1.ForwardRefExoticComponent<AppShellProps & React$1.RefAttributes<HTMLDivElement>>;
-/** ActionBar — a bar stuck to the bottom of the screen or of a card: a status line and the form's or selection's
- * actions. It is `position: sticky`, so it stays in the flow at the end of its parent and never covers the last field. */
 export declare const ActionBar: React$1.ForwardRefExoticComponent<ActionBarProps & React$1.RefAttributes<HTMLDivElement>>;
 /** Separator — a 1px `aura-border-default` rule between groups of content (4.20). Decorative by default (hidden from
  * screen readers); `decorative={false}` makes it a `role="separator"` that is announced. */

package/dist/styles.css

@@ -2270,6 +2270,32 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
 .aura-actionbar__start:empty { display: none; }
 @container aura-actionbar (min-width: 640px) { .aura-actionbar__start { order: -1; } }
 @container aura-actionbar (max-width: 639.98px) { .aura-actionbar__inner.has-start > .aura-actionbar__status:not(:empty) { flex-basis: 100%; } }
+/* 5.69 (Chamber-OS 185): look="edge" / edgeBelow — PageHeader's edge strip (5.48): the screen's full width, on the
+ * bottom edge or on a BottomNav, a top border only, the home-indicator inset inside it. Fixed, so it spans the screen
+ * and not its parent; as PageHeader's bar, the page gains its height at the end (the shell's content, else the body)
+ * and as scroll-padding — --aura-actionbar-height, measured on the client, 60px until then — so the page's end and a
+ * focused field scroll clear of it. On a screen 30rem tall or less it is static, in the flow, as every bar (5.48/5.49). */
+.aura-actionbar--edge:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; }
+@media (min-height: 30.00125rem) {
+  .aura-actionbar--edge:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
+@media (max-width: 639.98px) { .aura-actionbar--edge-below-sm:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; } }
+@media (max-width: 639.98px) and (min-height: 30.00125rem) {
+  .aura-actionbar--edge-below-sm:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
+@media (max-width: 767.98px) { .aura-actionbar--edge-below-md:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; } }
+@media (max-width: 767.98px) and (min-height: 30.00125rem) {
+  .aura-actionbar--edge-below-md:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
 
 /* ---------- 4.20: Separator ---------- */
 .aura-separator { flex: none; align-self: stretch; height: 1px; margin: var(--aura-separator-space, 0) 0; background: var(--aura-border-default); border: 0; }

package/dist/styles.layer.css

@@ -2272,6 +2272,32 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
 .aura-actionbar__start:empty { display: none; }
 @container aura-actionbar (min-width: 640px) { .aura-actionbar__start { order: -1; } }
 @container aura-actionbar (max-width: 639.98px) { .aura-actionbar__inner.has-start > .aura-actionbar__status:not(:empty) { flex-basis: 100%; } }
+/* 5.69 (Chamber-OS 185): look="edge" / edgeBelow — PageHeader's edge strip (5.48): the screen's full width, on the
+ * bottom edge or on a BottomNav, a top border only, the home-indicator inset inside it. Fixed, so it spans the screen
+ * and not its parent; as PageHeader's bar, the page gains its height at the end (the shell's content, else the body)
+ * and as scroll-padding — --aura-actionbar-height, measured on the client, 60px until then — so the page's end and a
+ * focused field scroll clear of it. On a screen 30rem tall or less it is static, in the flow, as every bar (5.48/5.49). */
+.aura-actionbar--edge:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; }
+@media (min-height: 30.00125rem) {
+  .aura-actionbar--edge:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
+@media (max-width: 639.98px) { .aura-actionbar--edge-below-sm:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; } }
+@media (max-width: 639.98px) and (min-height: 30.00125rem) {
+  .aura-actionbar--edge-below-sm:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge-below-sm:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
+@media (max-width: 767.98px) { .aura-actionbar--edge-below-md:not(.is-idle) { border: 0; border-top: 1px solid var(--aura-border-default); border-radius: 0; box-shadow: none; } }
+@media (max-width: 767.98px) and (min-height: 30.00125rem) {
+  .aura-actionbar--edge-below-md:not(.is-idle) { position: fixed; left: 0; right: 0; width: auto; bottom: var(--aura-bottomnav-offset, 0px); margin: 0; padding-bottom: max(0px, env(safe-area-inset-bottom, 0px) - var(--aura-bottomnav-offset, 0px)); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)) { --aura-actionbar-space: calc(var(--aura-actionbar-height, 60px) + var(--aura-bottomnav-offset, 0px) + var(--aura-space-3)); scroll-padding-bottom: var(--aura-actionbar-space); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)) .aura-shell__content { padding-bottom: calc(var(--aura-space-6) + var(--aura-actionbar-space)); }
+  :root:has(.aura-actionbar--edge-below-md:not(.is-idle)):not(:has(.aura-shell__content)) body { padding-bottom: var(--aura-actionbar-space); }
+}
 
 /* ---------- 4.20: Separator ---------- */
 .aura-separator { flex: none; align-self: stretch; height: 1px; margin: var(--aura-separator-space, 0) 0; background: var(--aura-border-default); border: 0; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jirawatpyk/aura-react",
-  "version": "5.68.0",
+  "version": "5.69.0",
   "description": "AURA Design System — React components (Enterprise Standard, Human Creative). Thai-first: Buddhist-era dates, Thai collation.",
   "license": "MIT",
   "type": "module",