@12-apps/ui 6.22.0 → 6.24.0

package/dist/native/form/Switch.js

@@ -3,7 +3,7 @@ import {
 } from "../chunks/chunk-OXHZDFJZ.js";
 import {
   webKeyDown
-} from "../chunks/chunk-T6BJPP3E.js";
+} from "../chunks/chunk-DN73KYIZ.js";
 import {
   childTestId,
   resolveTestId

package/dist/native/layout/Card.js

@@ -8,14 +8,14 @@ import {
 import {
   renderTextChildren
 } from "../chunks/chunk-5GJ5OG5R.js";
+import {
+  muiTypeStyle
+} from "../chunks/chunk-2UFNPDYT.js";
 import {
   childTestId,
   resolveTestId,
   withoutTestIdProps
 } from "../chunks/chunk-AR5O4BEY.js";
-import {
-  muiTypeStyle
-} from "../chunks/chunk-2UFNPDYT.js";
 import {
   useUiTheme
 } from "../chunks/chunk-GWGIWQO7.js";

package/dist/native/layout/Skeleton.js

@@ -1,213 +1,10 @@
 import {
-  resolveTestId,
-  withoutTestIdProps
-} from "../chunks/chunk-AR5O4BEY.js";
-import {
-  useLoopedProgress
-} from "../chunks/chunk-MLQIOKQZ.js";
-import {
-  useUiTheme
-} from "../chunks/chunk-GWGIWQO7.js";
-import {
-  alpha
-} from "../chunks/chunk-LEMMXZFN.js";
-
-// src/components/layout/Skeleton/Skeleton.native.tsx
-import * as React from "react";
-import {
-  Animated,
-  Easing,
-  StyleSheet,
-  View
-} from "react-native";
-
-// src/components/layout/Skeleton/Skeleton.helpers.ts
-var SKELETON_DEFAULTS = {
-  variant: "text",
-  animation: "pulse",
-  count: 1,
-  spacing: 1,
-  intensity: "medium",
-  glassmorphism: false,
-  shimmer: false
-};
-var definedProps = (props) => Object.fromEntries(
-  Object.entries(props).filter(([, value]) => value !== void 0)
-);
-var resolveSkeletonProps = (props) => ({ ...SKELETON_DEFAULTS, ...definedProps(props) });
-var skeletonInstanceTestId = (base, index) => base ? `${base}-${index}` : void 0;
-
-// src/components/layout/Skeleton/Skeleton.metrics.ts
-var SKELETON_INTENSITY_OPACITY = {
-  low: 0.11,
-  medium: 0.13,
-  high: 0.15
-};
-var SKELETON_DEFAULT_DIMENSIONS = {
-  // `text` has no height of its own: MUI's line box gives it one (below).
-  text: { width: "100%", height: void 0 },
-  circular: { width: 40, height: 40 },
-  rectangular: { width: "100%", height: 40 },
-  wave: { width: "100%", height: 40 }
-};
-var GLASS_BACKGROUND_ALPHA_FROM = 0.8;
-var GLASS_BORDER_ALPHA = 0.2;
-var GLASS_SHADOW = { offsetY: 8, blur: 32, alpha: 0.1 };
-var SHIMMER_ALPHA = 0.3;
-var SHIMMER_DURATION_MS = 2e3;
-var COMMON_BLACK = "#000";
-var COMMON_WHITE = "#fff";
-var PULSE = { durationMs: 2e3, delayMs: 500, dip: 0.4 };
-var WAVE = { durationMs: 1600, delayMs: 500 };
-var TEXT_LINE_HEIGHT_EM = 1.2;
-var TEXT_SCALE_Y = 0.6;
-
-// src/components/layout/Skeleton/Skeleton.native.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
-var PULSE_EASING = Easing.inOut(Easing.ease);
-var PERCENT = /^-?\d+(?:\.\d+)?%$/;
-function dimension(value) {
-  if (value === void 0 || typeof value === "number") return value;
-  return PERCENT.test(value) ? value : void 0;
-}
-var skeletonTint = (theme, intensity) => alpha(
-  theme.mode === "dark" ? COMMON_WHITE : theme.palette.text.primary,
-  SKELETON_INTENSITY_OPACITY[intensity]
-);
-var radiusFor = (theme, variant) => {
-  if (variant === "circular") return theme.radius.full;
-  return variant === "text" ? theme.radius.md : 0;
-};
-function textBoxHeight(theme, height) {
-  if (typeof height === "string") return dimension(height);
-  const box = height ?? theme.typography.sizes.md.fontSize * TEXT_LINE_HEIGHT_EM;
-  return box * TEXT_SCALE_Y;
-}
-function glassStyle(theme) {
-  return {
-    backgroundColor: alpha(theme.palette.background.paper, GLASS_BACKGROUND_ALPHA_FROM),
-    borderWidth: 1,
-    borderColor: alpha(theme.palette.divider, GLASS_BORDER_ALPHA),
-    boxShadow: `0 ${GLASS_SHADOW.offsetY}px ${GLASS_SHADOW.blur}px 0 ${alpha(COMMON_BLACK, GLASS_SHADOW.alpha)}`
-  };
-}
-function skeletonBoxStyle(theme, a) {
-  const box = SKELETON_DEFAULT_DIMENSIONS[a.variant];
-  const height = a.height ?? box.height;
-  const style = {
-    width: dimension(a.width ?? box.width),
-    height: a.variant === "text" ? textBoxHeight(theme, height) : dimension(height),
-    borderRadius: dimension(a.borderRadius) ?? radiusFor(theme, a.variant),
-    backgroundColor: skeletonTint(theme, a.intensity)
-  };
-  if (a.clipped) style.overflow = "hidden";
-  return a.glassmorphism ? { ...style, ...glassStyle(theme) } : style;
-}
-function Wash({ color, durationMs, delayMs, testID }) {
-  const progress = useLoopedProgress(true, { durationMs, delayMs, easing: Easing.linear });
-  return /* @__PURE__ */ jsx(
-    Animated.View,
-    {
-      testID,
-      style: [
-        StyleSheet.absoluteFill,
-        {
-          pointerEvents: "none",
-          backgroundColor: color,
-          opacity: progress.interpolate({ inputRange: [0, 0.5, 1], outputRange: [0, 1, 0] })
-        }
-      ]
-    }
-  );
-}
-var effectiveAnimation = (variant, animation) => variant === "wave" ? "wave" : animation;
-function SkeletonBox({
-  animation,
-  shimmer,
-  style,
-  testID,
-  rest,
-  ...styleArgs
-}) {
-  const theme = useUiTheme();
-  const animates = effectiveAnimation(styleArgs.variant, animation);
-  const pulse = useLoopedProgress(animates === "pulse", {
-    durationMs: PULSE.durationMs,
-    delayMs: PULSE.delayMs,
-    easing: PULSE_EASING
-  });
-  const box = skeletonBoxStyle(theme, styleArgs);
-  const washId = testID ? `${testID}-wash` : void 0;
-  return /* @__PURE__ */ jsxs(
-    Animated.View,
-    {
-      "aria-hidden": true,
-      testID,
-      style: [
-        box,
-        animates === "pulse" ? { opacity: pulse.interpolate({ inputRange: [0, 0.5, 1], outputRange: [1, PULSE.dip, 1] }) } : null,
-        style
-      ],
-      ...rest,
-      children: [
-        shimmer ? /* @__PURE__ */ jsx(
-          Wash,
-          {
-            color: alpha(COMMON_WHITE, SHIMMER_ALPHA),
-            durationMs: SHIMMER_DURATION_MS,
-            delayMs: 0,
-            testID: washId
-          }
-        ) : null,
-        !shimmer && animates === "wave" ? /* @__PURE__ */ jsx(
-          Wash,
-          {
-            color: theme.palette.action.hover,
-            durationMs: WAVE.durationMs,
-            delayMs: WAVE.delayMs,
-            testID: washId
-          }
-        ) : null
-      ]
-    }
-  );
-}
-var Skeleton = React.memo(function Skeleton2(rawProps) {
-  const resolved = resolveSkeletonProps(rawProps);
-  const {
-    variant,
-    animation,
-    width,
-    height,
-    count,
-    spacing,
-    borderRadius,
-    intensity,
-    glassmorphism,
-    shimmer,
-    style,
-    ...others
-  } = resolved;
-  const theme = useUiTheme();
-  const testID = resolveTestId(others);
-  const box = {
-    variant,
-    animation,
-    intensity,
-    width,
-    height,
-    borderRadius,
-    glassmorphism,
-    shimmer,
-    clipped: shimmer || effectiveAnimation(variant, animation) === "wave",
-    style,
-    rest: withoutTestIdProps(others)
-  };
-  if (count === 0) return null;
-  if (count === 1) return /* @__PURE__ */ jsx(SkeletonBox, { ...box, testID });
-  return /* @__PURE__ */ jsx(View, { style: { gap: theme.spacing(spacing) }, children: Array.from({ length: count }, (_, index) => /* @__PURE__ */ jsx(View, { children: /* @__PURE__ */ jsx(SkeletonBox, { ...box, testID: skeletonInstanceTestId(testID, index) }) }, `skeleton-${index}`)) });
-});
-Skeleton.displayName = "Skeleton";
+  Skeleton
+} from "../chunks/chunk-GW7TQ7HO.js";
+import "../chunks/chunk-MLQIOKQZ.js";
+import "../chunks/chunk-AR5O4BEY.js";
+import "../chunks/chunk-GWGIWQO7.js";
+import "../chunks/chunk-LEMMXZFN.js";
 export {
   Skeleton
 };

package/dist/native/layout/Skeleton.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/layout/Skeleton/Skeleton.native.tsx","../../../src/components/layout/Skeleton/Skeleton.helpers.ts","../../../src/components/layout/Skeleton/Skeleton.metrics.ts"],"sourcesContent":["import * as React from 'react';\nimport {\n  Animated,\n  Easing,\n  StyleSheet,\n  View,\n  type DimensionValue,\n  type StyleProp,\n  type ViewProps,\n  type ViewStyle,\n} from 'react-native';\n\nimport { resolveSkeletonProps, skeletonInstanceTestId } from './Skeleton.helpers';\nimport {\n  COMMON_BLACK,\n  COMMON_WHITE,\n  GLASS_BACKGROUND_ALPHA_FROM,\n  GLASS_BORDER_ALPHA,\n  GLASS_SHADOW,\n  PULSE,\n  SHIMMER_ALPHA,\n  SHIMMER_DURATION_MS,\n  SKELETON_DEFAULT_DIMENSIONS,\n  SKELETON_INTENSITY_OPACITY,\n  TEXT_LINE_HEIGHT_EM,\n  TEXT_SCALE_Y,\n  WAVE,\n} from './Skeleton.metrics';\nimport type {\n  SkeletonAnimation,\n  SkeletonIntensity,\n  SkeletonProps,\n  SkeletonVariant,\n} from './Skeleton.types.native';\nimport { useLoopedProgress } from '../../../platform/animation';\nimport { resolveTestId, withoutTestIdProps } from '../../../platform/test-id';\nimport { useUiTheme } from '../../../provider/use-ui-theme.native';\nimport { alpha } from '../../../tokens/color';\nimport type { UiTheme } from '../../../tokens/theme';\n\n/** MUI's `pulseKeyframe` runs `ease-in-out`. */\nconst PULSE_EASING = Easing.inOut(Easing.ease);\nconst PERCENT = /^-?\\d+(?:\\.\\d+)?%$/;\n\n/**\n * A width or a height, as React Native accepts one. The web takes any CSS\n * length; here a number is dp and a percentage is a percentage — anything else\n * (`10rem`, `calc(...)`) has no equivalent and sizes the box from its content,\n * which `NATIVE-NOTES.md` records.\n */\nexport function dimension(value: number | string | undefined): DimensionValue | undefined {\n  if (value === undefined || typeof value === 'number') return value;\n  return PERCENT.test(value) ? (value as `${number}%`) : undefined;\n}\n\n/** The tint the web writes: the body ink at the intensity's alpha, white in dark mode. */\nexport const skeletonTint = (theme: UiTheme, intensity: SkeletonIntensity): string =>\n  alpha(\n    theme.mode === 'dark' ? COMMON_WHITE : theme.palette.text.primary,\n    SKELETON_INTENSITY_OPACITY[intensity],\n  );\n\n/** MUI's radius per variant: a circle, a square rectangle, the theme's 4px on text. */\nconst radiusFor = (theme: UiTheme, variant: SkeletonVariant): number => {\n  if (variant === 'circular') return theme.radius.full;\n  return variant === 'text' ? theme.radius.md : 0;\n};\n\n/**\n * The `text` variant's height. MUI gives it a `1.2em` line box and squashes the\n * whole box to 60%; React Native's transforms do not change layout, so the two\n * are multiplied out into the height the web actually shows.\n */\nexport function textBoxHeight(\n  theme: UiTheme,\n  height: number | string | undefined,\n): DimensionValue | undefined {\n  if (typeof height === 'string') return dimension(height);\n  const box = height ?? theme.typography.sizes.md.fontSize * TEXT_LINE_HEIGHT_EM;\n  return box * TEXT_SCALE_Y;\n}\n\n/**\n * `glassmorphism`: the gradient's first stop flat, the hairline, and the web's\n * own box-shadow string — React Native 0.76+ takes CSS shadow syntax, so the\n * two renderers draw the shadow from the same declaration. What is missing is\n * the 20px backdrop blur, which React Native has no equivalent of.\n */\nfunction glassStyle(theme: UiTheme): ViewStyle {\n  return {\n    backgroundColor: alpha(theme.palette.background.paper, GLASS_BACKGROUND_ALPHA_FROM),\n    borderWidth: 1,\n    borderColor: alpha(theme.palette.divider, GLASS_BORDER_ALPHA),\n    boxShadow: `0 ${GLASS_SHADOW.offsetY}px ${GLASS_SHADOW.blur}px 0 ${alpha(COMMON_BLACK, GLASS_SHADOW.alpha)}`,\n  };\n}\n\ninterface SkeletonBoxStyleArgs {\n  variant: SkeletonVariant;\n  intensity: SkeletonIntensity;\n  width?: number | string;\n  height?: number | string;\n  borderRadius?: number | string;\n  glassmorphism: boolean;\n  /** A box with a wash sliding over it clips, as MUI's `wave` and the shimmer do. */\n  clipped: boolean;\n}\n\n/** The box the web paints, in absolute numbers. */\nexport function skeletonBoxStyle(theme: UiTheme, a: SkeletonBoxStyleArgs): ViewStyle {\n  const box = SKELETON_DEFAULT_DIMENSIONS[a.variant];\n  const height = a.height ?? box.height;\n  const style: ViewStyle = {\n    width: dimension(a.width ?? box.width),\n    height: a.variant === 'text' ? textBoxHeight(theme, height) : dimension(height),\n    borderRadius: dimension(a.borderRadius) ?? radiusFor(theme, a.variant),\n    backgroundColor: skeletonTint(theme, a.intensity),\n  };\n  if (a.clipped) style.overflow = 'hidden';\n  return a.glassmorphism ? { ...style, ...glassStyle(theme) } : style;\n}\n\ninterface WashProps {\n  color: string;\n  durationMs: number;\n  delayMs: number;\n  testID?: string;\n}\n\n/**\n * MUI's sweeping `::after`, standing still. React Native core has no gradient\n * fill and no pseudo-elements, so the same wash covers the box and fades in and\n * out on the same cadence instead of travelling across it. It carries no\n * `aria-hidden` of its own: the box it sits in is already hidden, and the\n * shared stories count the boxes by that attribute.\n */\nfunction Wash({ color, durationMs, delayMs, testID }: WashProps): React.JSX.Element {\n  const progress = useLoopedProgress(true, { durationMs, delayMs, easing: Easing.linear });\n  return (\n    <Animated.View\n      testID={testID}\n      style={[\n        StyleSheet.absoluteFill,\n        {\n          pointerEvents: 'none',\n          backgroundColor: color,\n          opacity: progress.interpolate({ inputRange: [0, 0.5, 1], outputRange: [0, 1, 0] }),\n        },\n      ]}\n    />\n  );\n}\n\ninterface SkeletonBoxProps extends SkeletonBoxStyleArgs {\n  animation: SkeletonAnimation;\n  shimmer: boolean;\n  style?: StyleProp<ViewStyle>;\n  testID?: string;\n  rest: ViewProps;\n}\n\n/** The web's `muiAnimationFor`: the `wave` VARIANT always animates as a wave. */\nconst effectiveAnimation = (\n  variant: SkeletonVariant,\n  animation: SkeletonAnimation,\n): SkeletonAnimation => (variant === 'wave' ? 'wave' : animation);\n\n/** One skeleton box: the tint, the pulse, and the wash the sweep stands in for. */\nfunction SkeletonBox({\n  animation,\n  shimmer,\n  style,\n  testID,\n  rest,\n  ...styleArgs\n}: SkeletonBoxProps): React.JSX.Element {\n  const theme = useUiTheme();\n  const animates = effectiveAnimation(styleArgs.variant, animation);\n  const pulse = useLoopedProgress(animates === 'pulse', {\n    durationMs: PULSE.durationMs,\n    delayMs: PULSE.delayMs,\n    easing: PULSE_EASING,\n  });\n  const box = skeletonBoxStyle(theme, styleArgs);\n  const washId = testID ? `${testID}-wash` : undefined;\n\n  return (\n    <Animated.View\n      aria-hidden\n      testID={testID}\n      style={[\n        box,\n        animates === 'pulse'\n          ? { opacity: pulse.interpolate({ inputRange: [0, 0.5, 1], outputRange: [1, PULSE.dip, 1] }) }\n          : null,\n        style,\n      ]}\n      {...rest}\n    >\n      {shimmer ? (\n        <Wash\n          color={alpha(COMMON_WHITE, SHIMMER_ALPHA)}\n          durationMs={SHIMMER_DURATION_MS}\n          delayMs={0}\n          testID={washId}\n        />\n      ) : null}\n      {!shimmer && animates === 'wave' ? (\n        <Wash\n          color={theme.palette.action.hover}\n          durationMs={WAVE.durationMs}\n          delayMs={WAVE.delayMs}\n          testID={washId}\n        />\n      ) : null}\n    </Animated.View>\n  );\n}\n\n/**\n * The native `Skeleton`: the same box, the same tint and the same default\n * dimensions the MUI half draws, on a `View`.\n */\nexport const Skeleton: React.FC<SkeletonProps> = React.memo(function Skeleton(rawProps) {\n  const resolved = resolveSkeletonProps(rawProps);\n  const {\n    variant,\n    animation,\n    width,\n    height,\n    count,\n    spacing,\n    borderRadius,\n    intensity,\n    glassmorphism,\n    shimmer,\n    style,\n    ...others\n  } = resolved;\n  const theme = useUiTheme();\n  const testID = resolveTestId(others);\n  const box: Omit<SkeletonBoxProps, 'testID'> = {\n    variant,\n    animation,\n    intensity,\n    width,\n    height,\n    borderRadius,\n    glassmorphism,\n    shimmer,\n    clipped: shimmer || effectiveAnimation(variant, animation) === 'wave',\n    style,\n    rest: withoutTestIdProps(others),\n  };\n\n  // Handle edge case: count of 0 should render nothing\n  if (count === 0) return null;\n  if (count === 1) return <SkeletonBox {...box} testID={testID} />;\n\n  return (\n    <View style={{ gap: theme.spacing(spacing) }}>\n      {Array.from({ length: count }, (_, index) => (\n        <View key={`skeleton-${index}`}>\n          <SkeletonBox {...box} testID={skeletonInstanceTestId(testID, index)} />\n        </View>\n      ))}\n    </View>\n  );\n});\n\nSkeleton.displayName = 'Skeleton';\n","import type { SkeletonBaseProps } from './Skeleton.base';\n\ntype SkeletonDefaultedKeys =\n  | 'variant'\n  | 'animation'\n  | 'count'\n  | 'spacing'\n  | 'intensity'\n  | 'glassmorphism'\n  | 'shimmer';\n\n/**\n * Generic over the renderer's own props: the web and the native `Skeleton`\n * carry different extras (`className`/`style` against a `View`'s props), and\n * both come back out untouched.\n */\ntype ResolvedSkeletonProps<P extends SkeletonBaseProps> = P &\n  Required<Pick<SkeletonBaseProps, SkeletonDefaultedKeys>>;\n\nconst SKELETON_DEFAULTS: Required<Pick<SkeletonBaseProps, SkeletonDefaultedKeys>> = {\n  variant: 'text',\n  animation: 'pulse',\n  count: 1,\n  spacing: 1,\n  intensity: 'medium',\n  glassmorphism: false,\n  shimmer: false,\n};\n\n// Strips explicitly-undefined props before the merge, so `count={undefined}` still\n// falls back to the default exactly as a destructuring default would.\nconst definedProps = <P extends SkeletonBaseProps>(props: P): Partial<P> =>\n  Object.fromEntries(\n    Object.entries(props).filter(([, value]) => value !== undefined),\n  ) as Partial<P>;\n\nexport const resolveSkeletonProps = <P extends SkeletonBaseProps>(\n  props: P,\n): ResolvedSkeletonProps<P> =>\n  ({ ...SKELETON_DEFAULTS, ...definedProps(props) }) as ResolvedSkeletonProps<P>;\n\n/**\n * The id of instance `index` when a caller asked for several. Unnamed\n * skeletons stay unnamed — the web has always cloned `undefined` there.\n */\nexport const skeletonInstanceTestId = (\n  base: string | undefined,\n  index: number,\n): string | undefined => (base ? `${base}-${index}` : undefined);\n","import type { SkeletonIntensity, SkeletonVariant } from './Skeleton.base';\n\n/**\n * THE NUMBERS BOTH `Skeleton` RENDERERS DRAW WITH.\n *\n * `Skeleton.styles.ts` (web, emotion over MUI's own `Skeleton`) and\n * `Skeleton.native.tsx` (React Native) read this one table. The web turns them\n * into CSS strings — `blur(20px)`, `shimmer 2s infinite` — and native uses the\n * numbers as they are, so neither renderer restates a value.\n *\n * Two groups live here. The first is what the web component WRITES (the\n * intensity alphas, the default box, the glass and shimmer washes). The second\n * is what MUI's own `Skeleton` contributes on the web and the native half\n * therefore has to restate: its pulse keyframe, its wave cadence, and the\n * geometry of the `text` variant. Those are MUI's DEFAULTS — a host that\n * re-themes them moves the web only, which `NATIVE-NOTES.md` records.\n */\n\n/** The tint's alpha over the ink, per intensity. */\nexport const SKELETON_INTENSITY_OPACITY: Record<SkeletonIntensity, number> = {\n  low: 0.11,\n  medium: 0.13,\n  high: 0.15,\n};\n\n/** The box a variant draws when the caller gives no `width`/`height`. */\nexport const SKELETON_DEFAULT_DIMENSIONS: Record<\n  SkeletonVariant,\n  { width: number | string; height: number | undefined }\n> = {\n  // `text` has no height of its own: MUI's line box gives it one (below).\n  text: { width: '100%', height: undefined },\n  circular: { width: 40, height: 40 },\n  rectangular: { width: '100%', height: 40 },\n  wave: { width: '100%', height: 40 },\n};\n\n/* ── `glassmorphism` ──────────────────────────────────────────────────────── */\n\n/** The 135° wash over `background.paper`, from the first stop to the last. */\nexport const GLASS_BACKGROUND_ALPHA_FROM = 0.8;\nexport const GLASS_BACKGROUND_ALPHA_TO = 0.4;\nexport const GLASS_BLUR_PX = 20;\nexport const GLASS_BORDER_ALPHA = 0.2;\n/** `0 8px 32px 0 rgba(0, 0, 0, 0.1)`. */\nexport const GLASS_SHADOW = { offsetY: 8, blur: 32, alpha: 0.1 } as const;\n\n/* ── `shimmer` ────────────────────────────────────────────────────────────── */\n\n/** The sweep's middle stop, over white. */\nexport const SHIMMER_ALPHA = 0.3;\nexport const SHIMMER_DURATION_MS = 2000;\n\n/**\n * MUI's `palette.common`, which is a pair of fixed hexes rather than anything\n * derived — so the shared theme has no slot for them and they are named here.\n */\nexport const COMMON_BLACK = '#000';\nexport const COMMON_WHITE = '#fff';\n\n/* ── MUI's own `Skeleton`, restated for the renderer that has no MUI ──────── */\n\n/**\n * MUI's `pulseKeyframe`: opacity 1 → 0.4 → 1, `2s ease-in-out 0.5s infinite`.\n * The delay runs once on the web; native replays it each lap unless the\n * animation is sequenced, which `Skeleton.native.tsx` does.\n */\nexport const PULSE = { durationMs: 2000, delayMs: 500, dip: 0.4 } as const;\n\n/** MUI's `wave` sweep: `1.6s linear 0.5s infinite`, in `palette.action.hover`. */\nexport const WAVE = { durationMs: 1600, delayMs: 500 } as const;\n\n/**\n * The `text` variant, as MUI draws it: a line box `1.2em` tall squashed to 60%\n * of its height (`transform: scale(1, 0.60)`), with a `4px/6.7px` elliptical\n * radius that the same squash turns back into a round 4px. React Native has no\n * `em`, and its transforms do not change layout, so the native half multiplies\n * the two out into one height and draws the plain 4px radius the squash lands on.\n */\nexport const TEXT_LINE_HEIGHT_EM = 1.2;\nexport const TEXT_SCALE_Y = 0.6;\n"],"mappings":"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","names":["Skeleton"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/navigation/AppHeader.js

@@ -7,24 +7,24 @@ import {
   AppHeaderIdentity,
   AppHeaderStatus
 } from "../chunk-W2YNUUVJ.js";
-import {
-  AppHeaderDetails
-} from "../chunk-6NZTYZP5.js";
 import {
   AppHeaderBrand
 } from "../chunk-H37GIAAM.js";
+import {
+  AppHeaderDetails
+} from "../chunk-GVA5CYKP.js";
 import {
   brandGradient,
   highlightOf,
   initialsOf
 } from "../chunk-IQU4HKND.js";
-import "../chunk-ZIYMBR7K.js";
+import "../chunk-OTH7H3IP.js";
 import "../chunk-M2K7BPHX.js";
 import "../chunk-6JZE4IIN.js";
 import "../chunk-POUWN4PX.js";
-import "../chunk-REMK55JI.js";
-import "../chunk-F52N6ACD.js";
+import "../chunk-OLZTGVBT.js";
 import "../chunk-CRN4KKNI.js";
+import "../chunk-F52N6ACD.js";
 import "../chunk-YANLN6HP.js";
 import "../chunk-5KEMPCW4.js";
 import "../chunk-VM3HRSAU.js";

package/dist/navigation/Pagination.js

@@ -1,9 +1,9 @@
 import "../chunk-MQJDMQJZ.js";
 import {
   Pagination
-} from "../chunk-W2UTDN4T.js";
-import "../chunk-CZBONNPA.js";
+} from "../chunk-RBGOGTT2.js";
 import "../chunk-BB2IVF76.js";
+import "../chunk-CZBONNPA.js";
 import "../chunk-Z6TIAVEG.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/pt-BR.js

@@ -20,7 +20,10 @@ import {
   PT_BR_LIGHTBOX_COPY,
   PT_BR_MAP_PREVIEW_COPY,
   PT_BR_TIMING_DIAGRAM_COPY
-} from "./chunk-U2AC4AQX.js";
+} from "./chunk-TU5EIKJA.js";
+import {
+  PT_BR_TABLE_FILTER_COPY
+} from "./chunk-A7RIZOAL.js";
 import {
   PT_BR_INSTALL_PROMPT_COPY,
   PT_BR_USER_AVATAR_COPY
@@ -36,9 +39,6 @@ import {
   PT_BR_BREADCRUMB_COPY,
   PT_BR_COMMAND_PALETTE_COPY
 } from "./chunk-62OGPVCL.js";
-import {
-  PT_BR_TABLE_FILTER_COPY
-} from "./chunk-A7RIZOAL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   PT_BR_ADDRESS_AUTOCOMPLETE_COPY,

package/dist/types/components/data-display/FleetMap/FleetBody.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { FleetMapState } from './FleetMap.hooks';
+import type { FleetMapCopy } from './FleetMap.types';
+export interface FleetBodyProps extends Pick<FleetMapState, 'ordered' | 'centre' | 'markers' | 'select' | 'onKeyDown'> {
+    copy: FleetMapCopy;
+    selectedId: string | null | undefined;
+    laggingAfterSeconds: number;
+    staleAfterSeconds: number;
+    height: string;
+    loading: boolean;
+    testId: string;
+}
+/**
+ * The two halves side by side: the roster that reads the fleet, and the map.
+ *
+ * A component rather than JSX inside {@link import('./FleetMap').FleetMap}
+ * because the layout is where every responsive decision lives, and keeping it
+ * here is what leaves the exported component short enough to read in one
+ * screen — which the complexity ledger enforces rather than merely suggests.
+ */
+export declare function FleetBody({ ordered, centre, markers, select, onKeyDown, copy, selectedId, laggingAfterSeconds, staleAfterSeconds, height, loading, testId, }: FleetBodyProps): React.JSX.Element;
+//# sourceMappingURL=FleetBody.d.ts.map

package/dist/types/components/data-display/FleetMap/FleetBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FleetBody.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/FleetMap/FleetBody.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtF,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,EACJ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,MAAM,GACP,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsDpC"}

package/dist/types/components/data-display/FleetMap/FleetCanvas.d.ts

@@ -0,0 +1,50 @@
+import React from 'react';
+import type { FleetMarker } from './FleetMap.hooks';
+import type { LatLng } from './FleetMap.helpers';
+import type { FleetMapCopy } from './FleetMap.types';
+export interface FleetCanvasProps {
+    copy: FleetMapCopy;
+    /** Where to point. `null` renders NOTHING — see the component's note. */
+    centre: LatLng | null;
+    markers: FleetMarker[];
+    height: string;
+    testId: string;
+}
+/**
+ * The map half — a NAMED LANDMARK, not an `aria-hidden` one.
+ *
+ * Its controls are focusable, and `aria-hidden` over a focusable subtree is the
+ * `aria-hidden-focus` violation: a keyboard user tabs into something a screen
+ * reader insists is not there. `role="region"` with a name is what puts it in a
+ * screen reader's landmark rotor, so it can be jumped PAST in one gesture;
+ * `role="group"` is not a landmark and would not.
+ *
+ * ## Skipping it does not silence it, and that is not ours to fix here
+ *
+ * `MapPreview` puts `aria-live="polite"` on its own root, with an English
+ * `aria-label` naming the centre coordinates and zoom. So re-centring the map —
+ * which every selection change does — announces something like "Map preview
+ * centered at -23.5505, -46.6333 with zoom level 15", in English, however
+ * thoroughly a reader has skipped the landmark. Two things follow, and neither
+ * is solved by anything this file can do:
+ *
+ *   * a live region announces from wherever the reader is, so the landmark's
+ *     skippability does not suppress it;
+ *   * that string is the one piece of user-facing text in this component that
+ *     does NOT come through `copy`.
+ *
+ * Fixing it means changing `MapPreview`, which every other consumer shares, so
+ * it is stated here rather than quietly claimed away.
+ *
+ * ## No centre, no map
+ *
+ * `mapCentre` answers `null` rather than a coordinate for an empty fleet, and
+ * that refusal has to survive the whole way down. `MapPreview` has no default
+ * centre — it resolves `center || coordinates || { lat: 0, lng: 0 }` — so
+ * forwarding `undefined` sails the map to the Gulf of Guinea and prints
+ * `Lat: 0.000000` under a default pin. That is exactly the render the helper
+ * exists to prevent, and it is reachable: a board that is `loading` with
+ * nothing yet reported skips the empty state by design and lands here.
+ */
+export declare function FleetCanvas({ copy, centre, markers, height, testId, }: FleetCanvasProps): React.JSX.Element | null;
+//# sourceMappingURL=FleetCanvas.d.ts.map

package/dist/types/components/data-display/FleetMap/FleetCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FleetCanvas.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/FleetMap/FleetCanvas.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,GACP,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAmB7C"}

package/dist/types/components/data-display/FleetMap/FleetMap.base.d.ts

@@ -0,0 +1,141 @@
+/**
+ * THE CONTRACT BOTH `FleetMap` RENDERERS HONOUR — and nothing else.
+ *
+ * This file imports no MUI and no react-native, on purpose: it ships in BOTH
+ * declaration outputs (`dist/types` and `dist/types-native`), and a native
+ * consumer has no `@mui/material` to resolve a type import against.
+ *
+ * What is NOT here is as deliberate as what is. `map` (the map control bar's
+ * six words) lives on the web copy alone, because the map half is web-only
+ * until `MapPreview` is ported — see `NATIVE-NOTES.md`. A native caller that
+ * had to supply words for a bar no renderer draws would be asked to describe
+ * something it cannot see.
+ */
+/**
+ * One tracked unit's newest position, as the caller resolved it.
+ *
+ * Deliberately says nothing about WHAT is being tracked. A courier, a service
+ * van, a field engineer — the component draws a labelled dot with a freshness,
+ * and every word that names the domain arrives through the copy object.
+ */
+export interface FleetUnit {
+    id: string;
+    /** The name a human reads, on the pin and in the roster. */
+    label: string;
+    latitude: number;
+    longitude: number;
+    /**
+     * The fix's accuracy radius in metres, when the platform reported one.
+     *
+     * Kept because it is what separates a rooftop GPS fix from a cell-tower guess
+     * three blocks wide, and a map that draws both identically tells its reader
+     * something false.
+     */
+    accuracyM?: number | null;
+    /**
+     * Seconds since the fix was ACCEPTED, on the server's clock.
+     *
+     * The caller computes it, and the distinction matters: a device whose own
+     * clock is an hour slow would otherwise report itself as an hour stale while
+     * reporting perfectly.
+     */
+    staleSeconds: number;
+    /** A short pre-formatted badge beside the name, e.g. `"2 entregas"`. */
+    badge?: string;
+}
+/** How current a unit's newest fix is, derived from the thresholds below. */
+export type FleetFreshness = 'live' | 'lagging' | 'stale';
+/**
+ * Every word the board prints, and the two it FORMATS — minus the map's own.
+ *
+ * `lastSeen` and `accuracy` are functions rather than strings because a
+ * duration and a distance are locale rules, and this package holds the same
+ * line `StatCard` does: presentation only, the caller owns the formatting. A
+ * `lastSeenMinutes: string` template would have made "há 2 min" the only
+ * shape any consumer could ever render.
+ */
+export interface FleetMapCopyBase {
+    /** The panel's heading. */
+    title: string;
+    /** What the roster says when nobody is reporting. */
+    emptyTitle: string;
+    emptyDescription?: string;
+    /** The roster list's accessible name — it is the map's readable half. */
+    rosterLabel: string;
+    /**
+     * What a screen reader hears while the roster reloads, e.g. "Atualizando a
+     * frota". OPTIONAL, and silence is the honest default: the busy state marks
+     * the region stale without uttering anything, the skeletons are hidden from
+     * the reader, and this component cannot invent the sentence in the reader's
+     * language. Set it and the panel announces politely; leave it and it stays
+     * quiet.
+     *
+     * Announced on a TRANSITION into loading. A board mounted already loading is
+     * silent — as any live region is at mount, since there is no change for a
+     * reader to observe.
+     */
+    loading?: string;
+    /** The three freshness words, as a reader sees them on a row. */
+    freshness: Record<FleetFreshness, string>;
+    /** `(seconds) => "há 2 min"`. */
+    lastSeen: (staleSeconds: number) => string;
+    /** `(metres) => "±12 m"`. A unit with no accuracy renders none. */
+    accuracy: (metres: number) => string;
+}
+/**
+ * The props both renderers take.
+ *
+ * `height` and `className` are NOT here: the first is a CSS length the web
+ * gives the map, and the second is a DOM class. Each side declares its own
+ * layout escape hatch beside its own extras.
+ */
+export interface FleetMapBaseProps {
+    /** Everyone currently reporting. An empty array renders the empty state. */
+    units: readonly FleetUnit[];
+    /**
+     * Which unit is highlighted: the roster marks it selected, and on the web the
+     * map centres on it. `null` selects nobody.
+     *
+     * PASSING IT AT ALL IS THE DECISION. Present on the first render — `null`
+     * included — and the board is controlled for life: it renders what you pass
+     * and never moves the selection itself. Absent on the first render and it
+     * keeps its own, reporting each change through {@link onSelect}. The mode is
+     * latched on that first render, the way React latches an `<input>`, so the
+     * component cannot change its own semantics halfway through a session.
+     *
+     * A controlled board reads `undefined` as "nobody is selected", so
+     * `useState<string>()` in the caller behaves: clearing it clears the roster.
+     */
+    selectedId?: string | null;
+    /**
+     * A click or press on a row, and each arrow-key move on the web.
+     *
+     * Passing {@link selectedId} WITHOUT this is a selection nothing can move:
+     * the arrow keys then decline to act and leave the page to scroll, rather
+     * than swallowing a keypress that would do nothing.
+     */
+    onSelect?: (id: string) => void;
+    /**
+     * Seconds after which a unit stops reading as `live`, and then as `lagging`.
+     *
+     * Both carry a GENERIC default (90s and 300s, sized for a phone reporting
+     * every twenty seconds) and no domain one, because the answer is entirely a
+     * property of the fleet's own ping cadence: a phone reporting every twenty
+     * seconds is late at ninety, and a tracker reporting every five minutes is
+     * not. A component that picked one would be picking it for every consumer.
+     */
+    laggingAfterSeconds?: number;
+    staleAfterSeconds?: number;
+    /**
+     * While true the roster is marked busy, and renders skeletons IF no units
+     * have landed yet — a poll over a populated roster keeps the list, because
+     * unmounting it throws away the focus inside it.
+     *
+     * It only ANNOUNCES if the copy's `loading` sentence is set: busy is a state,
+     * not an utterance.
+     */
+    loading?: boolean;
+    /** Test id for the panel root; every child id is derived from it. */
+    dataTestId?: string;
+}
+//# sourceMappingURL=FleetMap.base.d.ts.map

package/dist/types/components/data-display/FleetMap/FleetMap.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FleetMap.base.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/FleetMap/FleetMap.base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC1C,iCAAiC;IACjC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/components/data-display/FleetMap/FleetMap.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { FleetMapProps } from './FleetMap.types';
+/**
+ * FleetMap — where a set of tracked units is right now, as a map beside the
+ * roster that reads it.
+ *
+ * Product-free by construction: it draws labelled dots with a freshness, and
+ * every word — the heading, the three freshness states, how a duration and a
+ * distance are written — arrives through {@link FleetMapProps.copy}. Couriers,
+ * service vans and field engineers are all the same picture.
+ *
+ * ## Three decisions worth knowing before changing it
+ *
+ * **The roster is the accessible representation, not a sidebar.** A map is a
+ * picture and a screen reader cannot read one, so the list carries the
+ * information: everything a sighted user gets from a pin — who, how recently,
+ * what they are carrying — is on the row. The map is a NAMED region rather than
+ * an `aria-hidden` one, because its controls are focusable and hiding a
+ * focusable subtree is the `aria-hidden-focus` violation.
+ *
+ * **Nothing here formats.** `lastSeen` and `accuracy` are functions on the copy
+ * object, the same line `StatCard` holds for its `value`: a duration and a
+ * distance are locale rules, and a component that wrote "2 min ago" would have
+ * made English the only language it could ever render.
+ *
+ * **An empty fleet is an empty STATE, not an empty map.** A map with no pins is
+ * indistinguishable from a map that failed to load, and the difference is the
+ * whole question a dispatcher is asking.
+ */
+export declare const FleetMap: React.FC<FleetMapProps>;
+export default FleetMap;
+//# sourceMappingURL=FleetMap.d.ts.map

package/dist/types/components/data-display/FleetMap/FleetMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FleetMap.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/FleetMap/FleetMap.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA6CtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAuE5C,CAAC;AAIF,eAAe,QAAQ,CAAC"}

package/dist/types/components/data-display/FleetMap/FleetMap.fixtures.d.ts

@@ -0,0 +1,23 @@
+import type { FleetMapCopy, FleetUnit } from './FleetMap.types';
+/**
+ * The copy and the fleet every story and test story shares.
+ *
+ * A module rather than a per-story literal, so a change to the shape breaks in
+ * ONE place rather than in fourteen — and so the test stories assert against
+ * the same words the visual ones render.
+ */
+/** English, because stories are developer-facing. A consumer passes its own. */
+export declare const FLEET_COPY: FleetMapCopy;
+/**
+ * Three riders around São Paulo, one in each freshness state.
+ *
+ * Deliberately NOT in staleness order, and the labels deliberately do not agree
+ * with it either. `rosterOrder` sorts on staleness and breaks ties on the
+ * label, so a fixture whose two orders coincide lets the roster's ordering
+ * assertion pass against a LABEL-only sort as readily as the real one — a test
+ * reporting coverage it does not have. Here the three orders are all different:
+ * declared is [ale, ana, bruno], alphabetical is the same, and the correct
+ * answer is [ana, bruno, ale].
+ */
+export declare const FLEET: FleetUnit[];
+//# sourceMappingURL=FleetMap.fixtures.d.ts.map

package/dist/types/components/data-display/FleetMap/FleetMap.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FleetMap.fixtures.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/FleetMap/FleetMap.fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;;GAMG;AAEH,gFAAgF;AAChF,eAAO,MAAM,UAAU,EAAE,YAgBxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,EA2B5B,CAAC"}