@multiplatform.one/components 6.7.0 → 7.0.0

package/dist/cjs/index.native.js

@@ -26,7 +26,9 @@ var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
 var index_exports = {};
 __export(index_exports, {
   Accordion: () => import_Accordion.Accordion,
+  AnimateHeight: () => import_AnimateHeight.AnimateHeight,
   Avatar: () => import_Avatar.Avatar,
+  Button: () => import_Button.Button,
   Card: () => import_surfaces.Card,
   CardFooter: () => import_surfaces.CardFooter,
   CardHeader: () => import_surfaces.CardHeader,
@@ -40,6 +42,7 @@ __export(index_exports, {
   Panel: () => import_surfaces.Panel,
   PopoverContent: () => import_surfaces.PopoverContent,
   SheetFrame: () => import_surfaces.SheetFrame,
+  Spinner: () => import_forms2.Spinner,
   Tabs: () => import_Tabs.Tabs,
   TamaguiToast: () => import_toast.Toast,
   Toast: () => import_Toast.Toast,
@@ -47,6 +50,7 @@ __export(index_exports, {
   Tooltip: () => import_Tooltip.Tooltip,
   getInitials: () => import_Avatar.getInitials,
   getPaginationItems: () => import_Pagination.getPaginationItems,
+  settleMs: () => import_AnimateHeight.settleMs,
   unwrapText: () => import_unwrapText.unwrapText,
   useToast: () => import_Toast.useToast,
   useToastController: () => import_toast.useToastController,
@@ -79,6 +83,7 @@ __reExport(index_exports, require("./views/index.native.js"), module.exports);
 var import_unwrapText = require("./utils/unwrapText.native.js");
 var import_Pagination = require("./Pagination.native.js");
 var import_Accordion = require("./Accordion/index.native.js");
+var import_AnimateHeight = require("./AnimateHeight/index.native.js");
 var import_Tabs = require("./Tabs/index.native.js");
 var import_Tooltip = require("./Tooltip/index.native.js");
 var import_surfaces = require("./surfaces.native.js");
@@ -88,5 +93,7 @@ var import_lucide = require("./icons/lucide.native.js");
 var import_toast = require("@tamagui/toast");
 var import_Avatar = require("./Avatar/index.native.js");
 var import_forms = require("@multiplatform.one/forms");
+var import_forms2 = require("@multiplatform.one/forms");
+var import_Button = require("./Button.native.js");
 var import_Image = require("./images/Image/index.native.js");
 //# sourceMappingURL=index.native.js.map

package/dist/cjs/index.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","index_exports","__export","Accordion","import_Accordion","Avatar","import_Avatar","Card","import_surfaces","CardFooter","CardHeader","DialogContent","DialogOverlay","Fieldset","import_forms","Image","import_Image","Menu","import_lucide","MenuIcon","Pagination","import_Pagination","Panel","PopoverContent","SheetFrame","Tabs","import_Tabs","TamaguiToast","import_toast","Toast","import_Toast","ToastViewport","Tooltip","import_Tooltip","getInitials","getPaginationItems","unwrapText","import_unwrapText","useToast","useToastController","useToastState","module","exports","__reExport","require"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","index_exports","__export","Accordion","import_Accordion","AnimateHeight","import_AnimateHeight","Avatar","import_Avatar","Button","import_Button","Card","import_surfaces","CardFooter","CardHeader","DialogContent","DialogOverlay","Fieldset","import_forms","Image","import_Image","Menu","import_lucide","MenuIcon","Pagination","import_Pagination","Panel","PopoverContent","SheetFrame","Spinner","import_forms2","Tabs","import_Tabs","TamaguiToast","import_toast","Toast","import_Toast","ToastViewport","Tooltip","import_Tooltip","getInitials","getPaginationItems","settleMs","unwrapText","import_unwrapText","useToast","useToastController","useToastState","module","exports","__reExport","require"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/knobImmuneExports.cjs

@@ -0,0 +1,95 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var knobImmuneExports_exports = {};
+__export(knobImmuneExports_exports, {
+  knobImmuneExports: () => knobImmuneExports
+});
+module.exports = __toCommonJS(knobImmuneExports_exports);
+const knobImmuneExports = {
+  // ── Structural layout lego ────────────────────────────────────────────
+  // The knobs system is designed around these: house surfaces SPREAD
+  // knobProps.* fragments ONTO View/Stack/etc (knobs-system.md). The lego
+  // itself carries no opinionated chrome; a self-knobbing primitive would
+  // double-apply fragments under every house surface.
+  View: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  XStack: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  YStack: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  XGroup: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  YGroup: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  Group: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  Spacer: "pure whitespace; no paintable chrome for knobs to reach",
+  Square: "geometric lego (fixed aspect); consumers spread knob fragments onto it",
+  Circle: "geometric lego (identity circle by definition); radius knob story is N/A",
+  ScrollView: "scroll container lego; no opinionated chrome, fragments ride the content",
+  Separator: "token-driven hairline ($borderColor / hairline width); no knob channel maps to it today. ADJUDICATION-CANDIDATE: should borderWidth knob drive separator weight?",
+  ListItem: "raw list-row primitive consumed as lego by house list surfaces (List, sidebar, tags) which own the knob story. ADJUDICATION-CANDIDATE + BACKLOG: painted row with own padding/press states \u2014 deserves a house shadow or Tamagui* demotion once consumers migrate",
+  // ── Typography lego ───────────────────────────────────────────────────
+  // Text knobs (bodyFont, headingFont, fontWeight, textAccent) ride the
+  // knobProps.body / knobProps.heading fragments that composing surfaces
+  // spread; the primitives are the substrate those fragments land on.
+  Text: "typography substrate; font knobs ride knobProps.body/heading fragments spread by surfaces",
+  SizableText: "typography substrate; font knobs ride spread fragments",
+  Paragraph: "typography substrate; font knobs ride spread fragments",
+  Heading: "typography substrate; font knobs ride knobProps.heading fragments",
+  H1: "typography substrate; heading knobs ride knobProps.heading/pageTitle fragments",
+  H2: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H3: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H4: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H5: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H6: "typography substrate; heading knobs ride knobProps.heading fragments",
+  Anchor: "text link substrate; typography knobs ride spread fragments. ADJUDICATION-CANDIDATE: link color/underline currently tamagui-default, no LC rule owns link chrome",
+  // ── Overlay composition roots ─────────────────────────────────────────
+  // Logic shells with no painted frame of their own; the knob channel lands
+  // on the house content surfaces designed to fill them (DialogContent,
+  // PopoverContent, SheetFrame, ConfirmDialog).
+  Dialog: "composition root (logic/portal shell); knobs land on house DialogContent",
+  AlertDialog: "composition root; knobs land on house ConfirmDialog / DialogContent surfaces composed inside",
+  Popover: "composition root; knobs land on house PopoverContent",
+  Sheet: "composition root; knobs land on house SheetFrame",
+  Adapt: "platform adaptation control-flow component; renders nothing itself",
+  Portal: "reparenting utility; renders children elsewhere, paints nothing",
+  PortalProvider: "provider; paints nothing",
+  // ── Providers / theme / animation drivers ────────────────────────────
+  TamaguiProvider: "root provider (tamagui's own name, not an escape hatch); paints nothing",
+  Theme: "theme scoping provider; hue selection is the theme system, not a knob",
+  AnimatePresence: "mount/unmount choreography wrapper; motion values come from knob-gated children",
+  // ── Hooks (non-visual) ────────────────────────────────────────────────
+  useControllableState: "state hook; no rendered output",
+  useDidFinishSSR: "SSR lifecycle hook; no rendered output",
+  useEvent: "callback identity hook; no rendered output",
+  useMedia: "media query hook; no rendered output",
+  usePropsAndStyle: "style resolution hook; no rendered output",
+  useTheme: "theme access hook; no rendered output",
+  useThemeName: "theme access hook; no rendered output",
+  useToastController: "imperative toast controller hook (@tamagui/toast); no rendered output",
+  useToastState: "toast state hook (@tamagui/toast); no rendered output",
+  // ── Styling / token utilities (non-visual) ────────────────────────────
+  styled: "component factory; output components consume knobs where house code applies them",
+  createStyledContext: "context factory utility; no rendered output",
+  withStaticProperties: "object composition utility; no rendered output",
+  getToken: "token lookup utility; no rendered output",
+  getTokens: "token lookup utility; no rendered output",
+  getTokenValue: "token lookup utility; no rendered output",
+  isClient: "environment boolean; not a component",
+  isWeb: "environment boolean; not a component"
+};

package/dist/cjs/knobImmuneExports.native.js

@@ -0,0 +1,98 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var knobImmuneExports_exports = {};
+__export(knobImmuneExports_exports, {
+  knobImmuneExports: () => knobImmuneExports
+});
+module.exports = __toCommonJS(knobImmuneExports_exports);
+var knobImmuneExports = {
+  // ── Structural layout lego ────────────────────────────────────────────
+  // The knobs system is designed around these: house surfaces SPREAD
+  // knobProps.* fragments ONTO View/Stack/etc (knobs-system.md). The lego
+  // itself carries no opinionated chrome; a self-knobbing primitive would
+  // double-apply fragments under every house surface.
+  View: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  XStack: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  YStack: "unopinionated layout lego; knob fragments are spread onto it by composing surfaces",
+  XGroup: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  YGroup: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  Group: "layout grouping lego; knob fragments are spread onto it by composing surfaces",
+  Spacer: "pure whitespace; no paintable chrome for knobs to reach",
+  Square: "geometric lego (fixed aspect); consumers spread knob fragments onto it",
+  Circle: "geometric lego (identity circle by definition); radius knob story is N/A",
+  ScrollView: "scroll container lego; no opinionated chrome, fragments ride the content",
+  Separator: "token-driven hairline ($borderColor / hairline width); no knob channel maps to it today. ADJUDICATION-CANDIDATE: should borderWidth knob drive separator weight?",
+  ListItem: "raw list-row primitive consumed as lego by house list surfaces (List, sidebar, tags) which own the knob story. ADJUDICATION-CANDIDATE + BACKLOG: painted row with own padding/press states \u2014 deserves a house shadow or Tamagui* demotion once consumers migrate",
+  // ── Typography lego ───────────────────────────────────────────────────
+  // Text knobs (bodyFont, headingFont, fontWeight, textAccent) ride the
+  // knobProps.body / knobProps.heading fragments that composing surfaces
+  // spread; the primitives are the substrate those fragments land on.
+  Text: "typography substrate; font knobs ride knobProps.body/heading fragments spread by surfaces",
+  SizableText: "typography substrate; font knobs ride spread fragments",
+  Paragraph: "typography substrate; font knobs ride spread fragments",
+  Heading: "typography substrate; font knobs ride knobProps.heading fragments",
+  H1: "typography substrate; heading knobs ride knobProps.heading/pageTitle fragments",
+  H2: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H3: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H4: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H5: "typography substrate; heading knobs ride knobProps.heading fragments",
+  H6: "typography substrate; heading knobs ride knobProps.heading fragments",
+  Anchor: "text link substrate; typography knobs ride spread fragments. ADJUDICATION-CANDIDATE: link color/underline currently tamagui-default, no LC rule owns link chrome",
+  // ── Overlay composition roots ─────────────────────────────────────────
+  // Logic shells with no painted frame of their own; the knob channel lands
+  // on the house content surfaces designed to fill them (DialogContent,
+  // PopoverContent, SheetFrame, ConfirmDialog).
+  Dialog: "composition root (logic/portal shell); knobs land on house DialogContent",
+  AlertDialog: "composition root; knobs land on house ConfirmDialog / DialogContent surfaces composed inside",
+  Popover: "composition root; knobs land on house PopoverContent",
+  Sheet: "composition root; knobs land on house SheetFrame",
+  Adapt: "platform adaptation control-flow component; renders nothing itself",
+  Portal: "reparenting utility; renders children elsewhere, paints nothing",
+  PortalProvider: "provider; paints nothing",
+  // ── Providers / theme / animation drivers ────────────────────────────
+  TamaguiProvider: "root provider (tamagui's own name, not an escape hatch); paints nothing",
+  Theme: "theme scoping provider; hue selection is the theme system, not a knob",
+  AnimatePresence: "mount/unmount choreography wrapper; motion values come from knob-gated children",
+  // ── Hooks (non-visual) ────────────────────────────────────────────────
+  useControllableState: "state hook; no rendered output",
+  useDidFinishSSR: "SSR lifecycle hook; no rendered output",
+  useEvent: "callback identity hook; no rendered output",
+  useMedia: "media query hook; no rendered output",
+  usePropsAndStyle: "style resolution hook; no rendered output",
+  useTheme: "theme access hook; no rendered output",
+  useThemeName: "theme access hook; no rendered output",
+  useToastController: "imperative toast controller hook (@tamagui/toast); no rendered output",
+  useToastState: "toast state hook (@tamagui/toast); no rendered output",
+  // ── Styling / token utilities (non-visual) ────────────────────────────
+  styled: "component factory; output components consume knobs where house code applies them",
+  createStyledContext: "context factory utility; no rendered output",
+  withStaticProperties: "object composition utility; no rendered output",
+  getToken: "token lookup utility; no rendered output",
+  getTokens: "token lookup utility; no rendered output",
+  getTokenValue: "token lookup utility; no rendered output",
+  isClient: "environment boolean; not a component",
+  isWeb: "environment boolean; not a component"
+};
+//# sourceMappingURL=knobImmuneExports.native.js.map

package/dist/cjs/knobImmuneExports.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","knobImmuneExports_exports","__export","knobImmuneExports","module","exports","View","XStack","YStack","XGroup","YGroup","Group","Spacer","Square","Circle","ScrollView","Separator","ListItem","Text","SizableText","Paragraph","Heading","H1","H2","H3","H4","H5","H6","Anchor","Dialog","AlertDialog","Popover","Sheet","Adapt","Portal","PortalProvider","TamaguiProvider","Theme","AnimatePresence","useControllableState","useDidFinishSSR","useEvent","useMedia","usePropsAndStyle","useTheme","useThemeName","useToastController","useToastState","styled","createStyledContext","withStaticProperties","getToken","getTokens","getTokenValue","isClient","isWeb"],"sources":["../../src/knobImmuneExports.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,yBAAA;AAAAC,QAAA,CAAAD,yBAAA;EAAAE,iBAAA,EAAAA,CAAA,KAAAA;AAAA;AAmBOC,MAAM,CAAAC,OAAA,GAAAT,YAAsD,CAAAK,yBAAA;AAAA,IAAAE,iBAAA;EAAA;EAAA;EAAA;EAAA;EAMjE;EACAG,IAAA,sFAAQ;EACRC,MAAA,EAAQ;EACRC,MAAA,EAAQ;EACRC,MAAA,EAAQ;EACRC,MAAA,EAAO;EACPC,KAAA,iFAAQ;EACRC,MAAA,EAAQ;EACRC,MAAA,EAAQ;EACRC,MAAA,4EAAY;EACZC,UAAA,EACE;EACFC,SAAA,EACE;EAAAC,QAAA;EAAA;EAAA;EAAA;EAMF;EACAC,IAAA,6FAAa;EACbC,WAAW;EACXC,SAAS;EACTC,OAAI;EACJC,EAAA,EAAI;EACJC,EAAA,EAAI;EACJC,EAAA,EAAI;EACJC,EAAA,EAAI;EACJC,EAAA,EAAI;EACJC,EAAA,wEACE;EAAAC,MAAA;EAAA;EAAA;EAAA;EAMF;EACAC,MAAA,4EACE;EACFC,WAAS;EACTC,OAAO;EACPC,KAAA,EAAO;EACPC,KAAA,sEAAQ;EACRC,MAAA,mEAAgB;EAAAC,cAAA;EAGhB;EACAC,eAAO;EACPC,KAAA,yEACE;EAAAC,eAAA;EAGF;EACAC,oBAAiB;EACjBC,eAAU;EACVC,QAAA,EAAU;EACVC,QAAA,wCAAkB;EAClBC,gBAAU;EACVC,QAAA,yCAAc;EACdC,YAAA,yCAAoB;EACpBC,kBAAe;EAAAC,aAAA;EAGf;EACAC,MAAA,oFAAqB;EACrBC,mBAAA,+CAAsB;EACtBC,oBAAU;EACVC,QAAA,4CAAW;EACXC,SAAA,4CAAe;EACfC,aAAU;EACVC,QAAO;EACTC,KAAA","ignoreList":[]}

package/dist/cjs/layouts/AsyncBoundary.cjs

@@ -31,10 +31,13 @@ __export(AsyncBoundary_exports, {
 });
 module.exports = __toCommonJS(AsyncBoundary_exports);
 var import_forms = require("@multiplatform.one/forms");
+var import_theme = require("@multiplatform.one/theme");
 var import_react = require("@phosphor-icons/react");
 var import_react2 = require("react");
-var import_react_i18next = require("react-i18next");
+var import_i18n = require("../shared/i18n.cjs");
 var import_tamagui = require("tamagui");
+var import_Alert = require("../Alert/index.cjs");
+var import_componentColors = require("../componentColors.cjs");
 var import_Skeleton = require("../Skeleton/index.cjs");
 var import_page = require("./page.cjs");
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -102,7 +105,7 @@ function AsyncSkeleton({
 }) {
   const {
     t
-  } = (0, import_react_i18next.useTranslation)();
+  } = (0, import_i18n.useTranslation)();
   switch (layout) {
     case "list":
       return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_tamagui.YStack, {
@@ -263,6 +266,73 @@ function AsyncSkeleton({
       });
   }
 }
+function AsyncPendingBar() {
+  const {
+    t
+  } = (0, import_i18n.useTranslation)();
+  const {
+    knobProps
+  } = (0, import_theme.useResolvedKnobs)({
+    compact: true
+  });
+  return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.XStack, {
+    "data-async-pending": "true",
+    role: "status",
+    "aria-live": "polite",
+    "aria-label": t("Updating..."),
+    alignItems: "center",
+    ...knobProps.gap,
+    children: [/* @__PURE__ */(0, import_jsx_runtime.jsx)(import_forms.Spinner, {
+      size: "small",
+      "aria-hidden": true
+    }), /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_tamagui.Text, {
+      ...knobProps.label,
+      color: import_componentColors.componentColors.text.muted,
+      children: t("Updating...")
+    })]
+  });
+}
+function defaultEmptyBody({
+  empty,
+  compact,
+  emptyTitle,
+  emptyDescription
+}) {
+  if (empty !== true && isReactNodeSlot(empty)) return empty;
+  return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_page.EmptyState, {
+    compact,
+    intent: "neutral",
+    "data-async-state": "empty",
+    title: emptyTitle,
+    description: emptyDescription
+  });
+}
+function defaultErrorBody({
+  error,
+  compact,
+  errorTitle,
+  errorDescription,
+  onRetry,
+  retryLabel
+}) {
+  if (isReactNodeSlot(error)) return error;
+  const copy = errorCopy(error, errorTitle, errorDescription);
+  return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_page.EmptyState, {
+    compact,
+    intent: "error",
+    "data-async-state": "error",
+    title: copy.title,
+    description: copy.description,
+    icon: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_react.WarningCircleIcon, {
+      size: compact ? 24 : 32
+    }),
+    action: onRetry ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_forms.Button, {
+      size: compact ? "$3" : "$4",
+      onPress: onRetry,
+      children: retryLabel
+    }) : void 0
+  });
+}
 function AsyncBoundary({
   loading,
   empty,
@@ -277,71 +347,128 @@ function AsyncBoundary({
   errorDescription,
   compact = false,
   chrome,
+  keepPrevious = true,
   ...stackProps
 }) {
+  const {
+    t
+  } = (0, import_i18n.useTranslation)();
+  const {
+    knobProps
+  } = (0, import_theme.useResolvedKnobs)({
+    compact
+  });
   const status = resolveAsyncStatus({
     loading,
     empty,
     error
   });
-  const hideBadges = status === "error";
+  const content = data ?? children;
+  const retryLabel = t("Retry");
+  const emptyBody = defaultEmptyBody({
+    empty,
+    compact,
+    emptyTitle,
+    emptyDescription
+  });
+  const settledRef = (0, import_react2.useRef)(null);
+  if (status === "data") {
+    settledRef.current = {
+      kind: "data",
+      body: content
+    };
+  } else if (status === "empty") {
+    settledRef.current = {
+      kind: "empty",
+      body: emptyBody
+    };
+  }
+  const settled = keepPrevious ? settledRef.current : null;
   (0, import_react2.useEffect)(() => {
     if (status === "error" && isActiveFlag(empty)) {
       asyncDevWarn("empty-chrome-ignored-on-error", "DG-ST-01: empty slot is ignored while error is set");
     }
   }, [status, empty]);
-  const ctx = {
-    status,
-    hideBadges,
-    error: error ?? null
-  };
+  let displayStatus = status;
+  let pending = false;
+  let stale = false;
   let body = null;
+  let showChrome = status !== "error";
   if (status === "error") {
     if (isReactNodeSlot(error)) {
       body = error;
-    } else {
+    } else if (settled?.kind === "data") {
+      stale = true;
+      displayStatus = "data";
+      showChrome = true;
       const copy = errorCopy(error, errorTitle, errorDescription);
-      body = /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_page.EmptyState, {
+      body = /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+        width: "100%",
+        ...knobProps.gap,
+        children: [/* @__PURE__ */(0, import_jsx_runtime.jsx)(import_Alert.Alert, {
+          compact,
+          intent: "error",
+          title: copy.title,
+          actionLabel: onRetry ? retryLabel : void 0,
+          onAction: onRetry,
+          children: copy.description
+        }), content ?? settled.body]
+      });
+    } else {
+      body = defaultErrorBody({
+        error,
         compact,
-        intent: "error",
-        "data-async-state": "error",
-        title: copy.title,
-        description: copy.description,
-        icon: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_react.WarningCircleIcon, {
-          size: compact ? 24 : 32
-        }),
-        action: onRetry ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_forms.Button, {
-          size: compact ? "$3" : "$4",
-          onPress: onRetry,
-          children: "Retry"
-        }) : void 0
+        errorTitle,
+        errorDescription,
+        onRetry,
+        retryLabel
       });
     }
   } else if (status === "loading") {
-    body = loading !== true && isReactNodeSlot(loading) ? loading : /* @__PURE__ */(0, import_jsx_runtime.jsx)(AsyncSkeleton, {
-      layout
-    });
+    if (settled) {
+      pending = true;
+      displayStatus = settled.kind;
+      showChrome = true;
+      const kept = settled.kind === "data" ? content ?? settled.body : settled.body;
+      body = /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+        width: "100%",
+        ...knobProps.gap,
+        children: [/* @__PURE__ */(0, import_jsx_runtime.jsx)(AsyncPendingBar, {}), kept]
+      });
+    } else {
+      body = loading !== true && isReactNodeSlot(loading) ? loading : /* @__PURE__ */(0, import_jsx_runtime.jsx)(AsyncSkeleton, {
+        layout
+      });
+    }
   } else if (status === "empty") {
-    body = empty !== true && isReactNodeSlot(empty) ? empty : /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_page.EmptyState, {
-      compact,
-      intent: "neutral",
-      "data-async-state": "empty",
-      title: emptyTitle,
-      description: emptyDescription
-    });
+    body = emptyBody;
   } else {
-    body = data ?? children;
+    body = content;
   }
+  const hideBadges = displayStatus === "error";
+  const ctx = {
+    status: displayStatus,
+    hideBadges,
+    error: error ?? null,
+    pending,
+    stale
+  };
   return /* @__PURE__ */(0, import_jsx_runtime.jsx)(AsyncBoundaryContext.Provider, {
     value: ctx,
     children: /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
-      "data-async-status": status,
+      "data-async-status": displayStatus,
+      ...(pending ? {
+        "data-async-pending": "true"
+      } : {}),
+      ...(stale ? {
+        "data-async-stale": "true"
+      } : {}),
       width: "100%",
-      ...(status === "loading" ? {
+      ...(pending || status === "loading" ? {
         "aria-busy": true
       } : {}),
       ...stackProps,
-      children: [status !== "error" ? chrome : null, body]
+      children: [showChrome ? chrome : null, body]
     })
   });
 }