@hzblj/kara-components 0.5.0 → 0.7.0

package/lib/module/organisms/form/form.android.js.map

@@ -1 +1 @@
-{"version":3,"names":["Card","Text","VStack","useHostGuard","jsx","_jsx","jsxs","_jsxs","FormRoot","children","testID","spacing","wide","FormSection","footer","title","color","transform","variant","Form","Object","assign","Section"],"sourceRoot":"../../../../src","sources":["organisms/form/form.android.tsx"],"mappings":";;AAAA,SAAQA,IAAI,QAAO,2BAAkB;AACrC,SAAQC,IAAI,QAAO,2BAAkB;AACrC,SAAQC,MAAM,QAAO,8BAAqB;AAC1C,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAG/C,MAAMC,QAAQ,GAAGA,CAAC;EAACC,QAAQ;EAAEC;AAAiB,CAAC,KAAK;EAClDP,YAAY,CAAC,MAAM,CAAC;EAEpB,oBACEE,IAAA,CAACH,MAAM;IAACS,OAAO,EAAC,KAAK;IAACD,MAAM,EAAEA,MAAO;IAACE,IAAI;IAAAH,QAAA,EACvCA;EAAQ,CACH,CAAC;AAEb,CAAC;AAED,MAAMI,WAAW,GAAGA,CAAC;EAACJ,QAAQ;EAAEK,MAAM;EAAEC;AAAuB,CAAC,kBAC9DR,KAAA,CAACL,MAAM;EAACS,OAAO,EAAC,IAAI;EAACC,IAAI;EAAAH,QAAA,GACtBM,KAAK,gBACJV,IAAA,CAACJ,IAAI;IAACe,KAAK,EAAC,mBAAmB;IAACC,SAAS,EAAC,WAAW;IAACC,OAAO,EAAC,aAAa;IAAAT,QAAA,EACxEM;EAAK,CACF,CAAC,GACL,IAAI,eACRV,IAAA,CAACL,IAAI;IAACY,IAAI;IAAAH,QAAA,EAAEA;EAAQ,CAAO,CAAC,EAC3BK,MAAM,gBACLT,IAAA,CAACJ,IAAI;IAACe,KAAK,EAAC,kBAAkB;IAACE,OAAO,EAAC,UAAU;IAAAT,QAAA,EAC9CK;EAAM,CACH,CAAC,GACL,IAAI;AAAA,CACF,CACT;AAED,OAAO,MAAMK,IAAmB,GAAGC,MAAM,CAACC,MAAM,CAACb,QAAQ,EAAE;EAACc,OAAO,EAAET;AAAW,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["Card","Text","VStack","useHostGuard","jsx","_jsx","jsxs","_jsxs","FormRoot","children","testID","p","spacing","wide","FormSection","footer","title","px","color","transform","variant","Form","Object","assign","Section"],"sourceRoot":"../../../../src","sources":["organisms/form/form.android.tsx"],"mappings":";;AAAA,SAAQA,IAAI,QAAO,2BAAkB;AACrC,SAAQC,IAAI,QAAO,2BAAkB;AACrC,SAAQC,MAAM,QAAO,8BAAqB;AAC1C,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAG/C;AACA;AACA;AACA;AACA,MAAMC,QAAQ,GAAGA,CAAC;EAACC,QAAQ;EAAEC;AAAiB,CAAC,KAAK;EAClDP,YAAY,CAAC,MAAM,CAAC;EAEpB,oBACEE,IAAA,CAACH,MAAM;IAACS,CAAC,EAAC,KAAK;IAACC,OAAO,EAAC,KAAK;IAACF,MAAM,EAAEA,MAAO;IAACG,IAAI;IAAAJ,QAAA,EAC/CA;EAAQ,CACH,CAAC;AAEb,CAAC;AAED,MAAMK,WAAW,GAAGA,CAAC;EAACL,QAAQ;EAAEM,MAAM;EAAEC;AAAuB,CAAC,kBAC9DT,KAAA,CAACL,MAAM;EAACU,OAAO,EAAC,IAAI;EAACC,IAAI;EAAAJ,QAAA,GACtBO,KAAK,gBACJX,IAAA,CAACH,MAAM;IAACe,EAAE,EAAC,KAAK;IAACJ,IAAI;IAAAJ,QAAA,eACnBJ,IAAA,CAACJ,IAAI;MAACiB,KAAK,EAAC,mBAAmB;MAACC,SAAS,EAAC,WAAW;MAACC,OAAO,EAAC,aAAa;MAAAX,QAAA,EACxEO;IAAK,CACF;EAAC,CACD,CAAC,GACP,IAAI,eACRX,IAAA,CAACL,IAAI;IAACa,IAAI;IAAAJ,QAAA,EAAEA;EAAQ,CAAO,CAAC,EAC3BM,MAAM,gBACLV,IAAA,CAACH,MAAM;IAACe,EAAE,EAAC,KAAK;IAACJ,IAAI;IAAAJ,QAAA,eACnBJ,IAAA,CAACJ,IAAI;MAACiB,KAAK,EAAC,kBAAkB;MAACE,OAAO,EAAC,UAAU;MAAAX,QAAA,EAC9CM;IAAM,CACH;EAAC,CACD,CAAC,GACP,IAAI;AAAA,CACF,CACT;AAED,OAAO,MAAMM,IAAmB,GAAGC,MAAM,CAACC,MAAM,CAACf,QAAQ,EAAE;EAACgB,OAAO,EAAEV;AAAW,CAAC,CAAC","ignoreList":[]}

package/lib/module/organisms/swipe-actions/swipe-actions.android.js

@@ -1,17 +1,131 @@
 "use strict";
 
-import { warnUnsupported } from "../../platform-support.js";
-/** Passes the row straight through, so losing the gesture never costs you the content. */
-const SwipeActionsRoot = ({
-  children
+import { FilledIconButton } from '@expo/ui/jetpack-compose';
+import { size } from '@expo/ui/jetpack-compose/modifiers';
+import { SwipeActionsBox } from '@hzblj/kara-native/jetpack-compose';
+import { spacing, useAppTheme } from '@hzblj/kara-theme';
+import { useCallback, useEffect, useId, useState, useSyncExternalStore } from 'react';
+import { HStack } from "../../atoms/h-stack/index.js";
+import { Icon } from "../../atoms/icon/index.js";
+import { Text } from "../../atoms/text/index.js";
+import { VStack } from "../../atoms/v-stack/index.js";
+import { useHostGuard } from "../../host-context.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** A Material 3 Expressive wide icon button: wider than tall, a stadium, the label under it. */
+const BUTTON = [size(52, 32)];
+
+/**
+ * Which row is open, app-wide — SwiftUI's list keeps one row open, and so does this: opening one closes the last.
+ * React state cannot be shared between rows that know nothing of each other, so it lives in the module.
+ */
+let openRow = null;
+const listeners = new Set();
+const setOpenRow = row => {
+  if (openRow === row) {
+    return;
+  }
+  openRow = row;
+  for (const listener of listeners) {
+    listener();
+  }
+};
+const subscribe = listener => {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+};
+const getOpenRow = () => openRow;
+const ActionButton = ({
+  action,
+  onDone
 }) => {
-  warnUnsupported('SwipeActions', 'Android');
-  return children;
+  const theme = useAppTheme();
+  const fill = action.tint ?? (action.destructive ? 'fill.destructive.primary' : 'fill.accent.primary');
+  const content = !action.tint && action.destructive ? 'content.on.destructive' : 'content.on.bg';
+  const onClick = useCallback(() => {
+    onDone();
+    action.onPress();
+  }, [action, onDone]);
+  return /*#__PURE__*/_jsxs(VStack, {
+    align: "center",
+    spacing: "s2",
+    children: [/*#__PURE__*/_jsx(FilledIconButton, {
+      colors: {
+        containerColor: theme.color(fill),
+        contentColor: theme.color(content)
+      },
+      modifiers: BUTTON,
+      onClick: onClick,
+      children: /*#__PURE__*/_jsx(Icon, {
+        accessibilityLabel: action.label,
+        color: content,
+        name: action.icon,
+        size: "s20"
+      })
+    }), /*#__PURE__*/_jsx(Text, {
+      color: "content.secondary",
+      variant: "labelMedium",
+      children: action.label
+    })]
+  });
 };
-
-/** The buttons belong to a gesture that does not exist here, so they are dropped. */
-const SwipeActionsGroup = () => null;
-export const SwipeActions = Object.assign(SwipeActionsRoot, {
-  Actions: SwipeActionsGroup
+const Actions = ({
+  actions,
+  onDone
+}) => /*#__PURE__*/_jsx(HStack, {
+  align: "center",
+  spacing: "s8",
+  children: actions.map(action => /*#__PURE__*/_jsx(ActionButton, {
+    action: action,
+    onDone: onDone
+  }, action.label))
 });
+const close = () => setOpenRow(null);
+
+/**
+ * kara's `SwipeActionsBox`: the row slides on an anchored drag and the buttons show in the strip it leaves, fading in.
+ * Controlled from here so one row is open at a time; a press closes the row before the action runs.
+ */
+export const SwipeActions = ({
+  children,
+  leading = [],
+  trailing = []
+}) => {
+  useHostGuard('SwipeActions');
+  const row = useId();
+  const isOpenRow = useSyncExternalStore(subscribe, getOpenRow) === row;
+  const [edge, setEdge] = useState(null);
+  const onOpenChange = useCallback(next => {
+    setEdge(next);
+    if (next) {
+      setOpenRow(row);
+    } else if (openRow === row) {
+      setOpenRow(null);
+    }
+  }, [row]);
+
+  // A row that goes away open must not keep the others from opening.
+  useEffect(() => () => {
+    if (openRow === row) {
+      setOpenRow(null);
+    }
+  }, [row]);
+  return /*#__PURE__*/_jsxs(SwipeActionsBox, {
+    actionsSpacing: spacing.s12,
+    onOpenChange: onOpenChange,
+    openEdge: isOpenRow ? edge : null,
+    children: [leading.length > 0 ? /*#__PURE__*/_jsx(SwipeActionsBox.Leading, {
+      children: /*#__PURE__*/_jsx(Actions, {
+        actions: leading,
+        onDone: close
+      })
+    }) : null, trailing.length > 0 ? /*#__PURE__*/_jsx(SwipeActionsBox.Trailing, {
+      children: /*#__PURE__*/_jsx(Actions, {
+        actions: [...trailing].reverse(),
+        onDone: close
+      })
+    }) : null, children]
+  });
+};
 //# sourceMappingURL=swipe-actions.android.js.map

package/lib/module/organisms/swipe-actions/swipe-actions.android.js.map

@@ -1 +1 @@
-{"version":3,"names":["warnUnsupported","SwipeActionsRoot","children","SwipeActionsGroup","SwipeActions","Object","assign","Actions"],"sourceRoot":"../../../../src","sources":["organisms/swipe-actions/swipe-actions.android.tsx"],"mappings":";;AAAA,SAAQA,eAAe,QAAO,2BAAwB;AAGtD;AACA,MAAMC,gBAAgB,GAAGA,CAAC;EAACC;AAA2B,CAAC,KAAK;EAC1DF,eAAe,CAAC,cAAc,EAAE,SAAS,CAAC;EAE1C,OAAOE,QAAQ;AACjB,CAAC;;AAED;AACA,MAAMC,iBAAiB,GAAGA,CAAA,KAAM,IAAI;AAEpC,OAAO,MAAMC,YAAmC,GAAGC,MAAM,CAACC,MAAM,CAACL,gBAAgB,EAAE;EAACM,OAAO,EAAEJ;AAAiB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["FilledIconButton","size","SwipeActionsBox","spacing","useAppTheme","useCallback","useEffect","useId","useState","useSyncExternalStore","HStack","Icon","Text","VStack","useHostGuard","jsx","_jsx","jsxs","_jsxs","BUTTON","openRow","listeners","Set","setOpenRow","row","listener","subscribe","add","delete","getOpenRow","ActionButton","action","onDone","theme","fill","tint","destructive","content","onClick","onPress","align","children","colors","containerColor","color","contentColor","modifiers","accessibilityLabel","label","name","icon","variant","Actions","actions","map","close","SwipeActions","leading","trailing","isOpenRow","edge","setEdge","onOpenChange","next","actionsSpacing","s12","openEdge","length","Leading","Trailing","reverse"],"sourceRoot":"../../../../src","sources":["organisms/swipe-actions/swipe-actions.android.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/organisms/swipe-actions/swipe-actions.ios.js

@@ -1,28 +1,56 @@
 "use strict";
 
-import { SwipeActions as SwiftUISwipeActions } from '@expo/ui/swift-ui';
+import { Button, Image, Label, SwipeActions as SwiftUISwipeActions } from '@expo/ui/swift-ui';
+import { tint } from '@expo/ui/swift-ui/modifiers';
+import { iconResourceName } from '@hzblj/kara-native';
+import { useAppTheme } from '@hzblj/kara-theme';
 import { useHostGuard } from "../../host-context.js";
-import { jsx as _jsx } from "react/jsx-runtime";
-const SwipeActionsRoot = ({
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The edge's buttons, a `Label` each — iOS 26 draws its icon on a round button with the title under it; earlier
+ * versions, in a row of the usual height, the icon alone. No `destructive` role: SwiftUI would animate the row out by itself, and whether it goes is
+ * the list's data to say.
+ */
+const Actions = ({
+  actions,
+  allowsFullSwipe,
+  edge
+}) => {
+  const theme = useAppTheme();
+  return /*#__PURE__*/_jsx(SwiftUISwipeActions.Actions, {
+    allowsFullSwipe: allowsFullSwipe,
+    edge: edge,
+    children: actions.map(action => /*#__PURE__*/_jsx(Button, {
+      modifiers: [tint(theme.color(action.tint ?? (action.destructive ? 'fill.destructive.primary' : 'fill.accent.primary')))],
+      onPress: action.onPress,
+      children: /*#__PURE__*/_jsx(Label, {
+        icon: /*#__PURE__*/_jsx(Image, {
+          assetName: iconResourceName(action.icon)
+        }),
+        title: action.label
+      })
+    }, action.label))
+  });
+};
+export const SwipeActions = ({
+  allowsFullSwipe = true,
   children,
-  testID
+  leading = [],
+  testID,
+  trailing = []
 }) => {
   useHostGuard('SwipeActions');
-  return /*#__PURE__*/_jsx(SwiftUISwipeActions, {
+  return /*#__PURE__*/_jsxs(SwiftUISwipeActions, {
     testID: testID,
-    children: children
+    children: [children, leading.length > 0 ? /*#__PURE__*/_jsx(Actions, {
+      actions: leading,
+      allowsFullSwipe: allowsFullSwipe,
+      edge: "leading"
+    }) : null, trailing.length > 0 ? /*#__PURE__*/_jsx(Actions, {
+      actions: trailing,
+      allowsFullSwipe: allowsFullSwipe,
+      edge: "trailing"
+    }) : null]
   });
 };
-const SwipeActionsGroup = ({
-  allowsFullSwipe = true,
-  children,
-  edge = 'trailing'
-}) => /*#__PURE__*/_jsx(SwiftUISwipeActions.Actions, {
-  allowsFullSwipe: allowsFullSwipe,
-  edge: edge,
-  children: children
-});
-export const SwipeActions = Object.assign(SwipeActionsRoot, {
-  Actions: SwipeActionsGroup
-});
 //# sourceMappingURL=swipe-actions.ios.js.map

package/lib/module/organisms/swipe-actions/swipe-actions.ios.js.map

@@ -1 +1 @@
-{"version":3,"names":["SwipeActions","SwiftUISwipeActions","useHostGuard","jsx","_jsx","SwipeActionsRoot","children","testID","SwipeActionsGroup","allowsFullSwipe","edge","Actions","Object","assign"],"sourceRoot":"../../../../src","sources":["organisms/swipe-actions/swipe-actions.ios.tsx"],"mappings":";;AAAA,SAAQA,YAAY,IAAIC,mBAAmB,QAAO,mBAAmB;AAErE,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAG/C,MAAMC,gBAAgB,GAAGA,CAAC;EAACC,QAAQ;EAAEC;AAAyB,CAAC,KAAK;EAClEL,YAAY,CAAC,cAAc,CAAC;EAE5B,oBAAOE,IAAA,CAACH,mBAAmB;IAACM,MAAM,EAAEA,MAAO;IAAAD,QAAA,EAAEA;EAAQ,CAAsB,CAAC;AAC9E,CAAC;AAED,MAAME,iBAAiB,GAAGA,CAAC;EAACC,eAAe,GAAG,IAAI;EAAEH,QAAQ;EAAEI,IAAI,GAAG;AAAkC,CAAC,kBACtGN,IAAA,CAACH,mBAAmB,CAACU,OAAO;EAACF,eAAe,EAAEA,eAAgB;EAACC,IAAI,EAAEA,IAAK;EAAAJ,QAAA,EACvEA;AAAQ,CACkB,CAC9B;AAED,OAAO,MAAMN,YAAmC,GAAGY,MAAM,CAACC,MAAM,CAACR,gBAAgB,EAAE;EAACM,OAAO,EAAEH;AAAiB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["Button","Image","Label","SwipeActions","SwiftUISwipeActions","tint","iconResourceName","useAppTheme","useHostGuard","jsx","_jsx","jsxs","_jsxs","Actions","actions","allowsFullSwipe","edge","theme","children","map","action","modifiers","color","destructive","onPress","icon","assetName","title","label","leading","testID","trailing","length"],"sourceRoot":"../../../../src","sources":["organisms/swipe-actions/swipe-actions.ios.tsx"],"mappings":";;AAAA,SAAQA,MAAM,EAAEC,KAAK,EAAEC,KAAK,EAAEC,YAAY,IAAIC,mBAAmB,QAAO,mBAAmB;AAC3F,SAAQC,IAAI,QAAO,6BAA6B;AAChD,SAAQC,gBAAgB,QAAO,oBAAoB;AACnD,SAAQC,WAAW,QAAO,mBAAmB;AAE7C,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAK/C;AACA;AACA;AACA;AACA;AACA,MAAMC,OAAO,GAAGA,CAAC;EAACC,OAAO;EAAEC,eAAe;EAAEC;AAAkB,CAAC,KAAK;EAClE,MAAMC,KAAK,GAAGV,WAAW,CAAC,CAAC;EAE3B,oBACEG,IAAA,CAACN,mBAAmB,CAACS,OAAO;IAACE,eAAe,EAAEA,eAAgB;IAACC,IAAI,EAAEA,IAAK;IAAAE,QAAA,EACvEJ,OAAO,CAACK,GAAG,CAACC,MAAM,iBACjBV,IAAA,CAACV,MAAM;MAELqB,SAAS,EAAE,CACThB,IAAI,CAACY,KAAK,CAACK,KAAK,CAACF,MAAM,CAACf,IAAI,KAAKe,MAAM,CAACG,WAAW,GAAG,0BAA0B,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAC3G;MACFC,OAAO,EAAEJ,MAAM,CAACI,OAAQ;MAAAN,QAAA,eAExBR,IAAA,CAACR,KAAK;QAACuB,IAAI,eAAEf,IAAA,CAACT,KAAK;UAACyB,SAAS,EAAEpB,gBAAgB,CAACc,MAAM,CAACK,IAAI;QAAE,CAAE,CAAE;QAACE,KAAK,EAAEP,MAAM,CAACQ;MAAM,CAAE;IAAC,GANpFR,MAAM,CAACQ,KAON,CACT;EAAC,CACyB,CAAC;AAElC,CAAC;AAED,OAAO,MAAMzB,YAAmC,GAAGA,CAAC;EAClDY,eAAe,GAAG,IAAI;EACtBG,QAAQ;EACRW,OAAO,GAAG,EAAE;EACZC,MAAM;EACNC,QAAQ,GAAG;AACM,CAAC,KAAK;EACvBvB,YAAY,CAAC,cAAc,CAAC;EAE5B,oBACEI,KAAA,CAACR,mBAAmB;IAAC0B,MAAM,EAAEA,MAAO;IAAAZ,QAAA,GACjCA,QAAQ,EACRW,OAAO,CAACG,MAAM,GAAG,CAAC,gBAAGtB,IAAA,CAACG,OAAO;MAACC,OAAO,EAAEe,OAAQ;MAACd,eAAe,EAAEA,eAAgB;MAACC,IAAI,EAAC;IAAS,CAAE,CAAC,GAAG,IAAI,EAC1Ge,QAAQ,CAACC,MAAM,GAAG,CAAC,gBAAGtB,IAAA,CAACG,OAAO;MAACC,OAAO,EAAEiB,QAAS;MAAChB,eAAe,EAAEA,eAAgB;MAACC,IAAI,EAAC;IAAU,CAAE,CAAC,GAAG,IAAI;EAAA,CAC3F,CAAC;AAE1B,CAAC","ignoreList":[]}

package/lib/module/templates/screen/screen.android.js

@@ -1,11 +1,18 @@
 "use strict";
 
 import { Column, Host } from '@expo/ui/jetpack-compose';
+import { padding } from '@expo/ui/jetpack-compose/modifiers';
 import { useSxModifiers } from '@hzblj/kara-sx';
 import { useAppTheme } from '@hzblj/kara-theme';
-import { StyleSheet } from 'react-native';
+import { useCallback, useMemo, useRef, useState } from 'react';
+import { StatusBar, StyleSheet, View } from 'react-native';
 import { HostBoundary } from "../../host-context.js";
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The content keeps clear of as much of the status bar as the screen covers — all of it when nothing sits above the
+ * screen, none under a navigation bar — the way a SwiftUI host keeps to the safe area. Compose would draw under it:
+ * the app is edge to edge, and `Host` pads for nothing. The background still runs to the edge.
+ */
 export const Screen = ({
   bg = 'surface.base',
   children,
@@ -13,20 +20,34 @@ export const Screen = ({
   testID
 }) => {
   const theme = useAppTheme();
-  const modifiers = useSxModifiers({
+  const frame = useRef(null);
+  const [statusBarOverlap, setStatusBarOverlap] = useState(0);
+  const sx = useSxModifiers({
     bg,
     tall: true,
     wide: true
   });
-  return /*#__PURE__*/_jsx(Host, {
-    colorScheme: theme.dark ? 'dark' : 'light',
-    ignoreSafeAreaKeyboardInsets: ignoreKeyboardInset,
-    seedColor: theme.materialSeed,
+  const modifiers = useMemo(() => statusBarOverlap > 0 ? [...sx, padding(0, statusBarOverlap, 0, 0)] : sx, [statusBarOverlap, sx]);
+  const onLayout = useCallback(() => {
+    frame.current?.measureInWindow((_x, y) => {
+      setStatusBarOverlap(Math.max(0, Math.round((StatusBar.currentHeight ?? 0) - y)));
+    });
+  }, []);
+  return /*#__PURE__*/_jsx(View, {
+    onLayout: onLayout,
+    ref: frame,
     style: StyleSheet.absoluteFill,
-    children: /*#__PURE__*/_jsx(Column, {
-      modifiers: modifiers,
-      children: /*#__PURE__*/_jsx(HostBoundary, {
-        children: children
+    testID: testID,
+    children: /*#__PURE__*/_jsx(Host, {
+      colorScheme: theme.dark ? 'dark' : 'light',
+      ignoreSafeAreaKeyboardInsets: ignoreKeyboardInset,
+      seedColor: theme.materialSeed,
+      style: StyleSheet.absoluteFill,
+      children: /*#__PURE__*/_jsx(Column, {
+        modifiers: modifiers,
+        children: /*#__PURE__*/_jsx(HostBoundary, {
+          children: children
+        })
       })
     })
   });

package/lib/module/templates/screen/screen.android.js.map

@@ -1 +1 @@
-{"version":3,"names":["Column","Host","useSxModifiers","useAppTheme","StyleSheet","HostBoundary","jsx","_jsx","Screen","bg","children","ignoreKeyboardInset","testID","theme","modifiers","tall","wide","colorScheme","dark","ignoreSafeAreaKeyboardInsets","seedColor","materialSeed","style","absoluteFill"],"sourceRoot":"../../../../src","sources":["templates/screen/screen.android.tsx"],"mappings":";;AAAA,SAAQA,MAAM,EAAEC,IAAI,QAAO,0BAA0B;AACrD,SAAQC,cAAc,QAAO,gBAAgB;AAC7C,SAAQC,WAAW,QAAO,mBAAmB;AAC7C,SAAQC,UAAU,QAAO,cAAc;AACvC,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAG/C,OAAO,MAAMC,MAAuB,GAAGA,CAAC;EAACC,EAAE,GAAG,cAAc;EAAEC,QAAQ;EAAEC,mBAAmB;EAAEC;AAAmB,CAAC,KAAK;EACpH,MAAMC,KAAK,GAAGV,WAAW,CAAC,CAAC;EAC3B,MAAMW,SAAS,GAAGZ,cAAc,CAAC;IAACO,EAAE;IAAEM,IAAI,EAAE,IAAI;IAAEC,IAAI,EAAE;EAAI,CAAC,CAAC;EAE9D,oBACET,IAAA,CAACN,IAAI;IACHgB,WAAW,EAAEJ,KAAK,CAACK,IAAI,GAAG,MAAM,GAAG,OAAQ;IAC3CC,4BAA4B,EAAER,mBAAoB;IAClDS,SAAS,EAAEP,KAAK,CAACQ,YAAa;IAC9BC,KAAK,EAAElB,UAAU,CAACmB,YAAa;IAAAb,QAAA,eAE/BH,IAAA,CAACP,MAAM;MAACc,SAAS,EAAEA,SAAU;MAAAJ,QAAA,eAC3BH,IAAA,CAACF,YAAY;QAAAK,QAAA,EAAEA;MAAQ,CAAe;IAAC,CACjC;EAAC,CACL,CAAC;AAEX,CAAC","ignoreList":[]}
+{"version":3,"names":["Column","Host","padding","useSxModifiers","useAppTheme","useCallback","useMemo","useRef","useState","StatusBar","StyleSheet","View","HostBoundary","jsx","_jsx","Screen","bg","children","ignoreKeyboardInset","testID","theme","frame","statusBarOverlap","setStatusBarOverlap","sx","tall","wide","modifiers","onLayout","current","measureInWindow","_x","y","Math","max","round","currentHeight","ref","style","absoluteFill","colorScheme","dark","ignoreSafeAreaKeyboardInsets","seedColor","materialSeed"],"sourceRoot":"../../../../src","sources":["templates/screen/screen.android.tsx"],"mappings":";;AAAA,SAAQA,MAAM,EAAEC,IAAI,QAAO,0BAA0B;AACrD,SAAQC,OAAO,QAAO,oCAAoC;AAC1D,SAAQC,cAAc,QAAO,gBAAgB;AAC7C,SAAQC,WAAW,QAAO,mBAAmB;AAC7C,SAAQC,WAAW,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAO,OAAO;AAC5D,SAAQC,SAAS,EAAEC,UAAU,EAAEC,IAAI,QAAO,cAAc;AACxD,SAAQC,YAAY,QAAO,uBAAoB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAG/C;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,MAAuB,GAAGA,CAAC;EAACC,EAAE,GAAG,cAAc;EAAEC,QAAQ;EAAEC,mBAAmB;EAAEC;AAAmB,CAAC,KAAK;EACpH,MAAMC,KAAK,GAAGhB,WAAW,CAAC,CAAC;EAC3B,MAAMiB,KAAK,GAAGd,MAAM,CAAO,IAAI,CAAC;EAChC,MAAM,CAACe,gBAAgB,EAAEC,mBAAmB,CAAC,GAAGf,QAAQ,CAAC,CAAC,CAAC;EAC3D,MAAMgB,EAAE,GAAGrB,cAAc,CAAC;IAACa,EAAE;IAAES,IAAI,EAAE,IAAI;IAAEC,IAAI,EAAE;EAAI,CAAC,CAAC;EACvD,MAAMC,SAAS,GAAGrB,OAAO,CACvB,MAAOgB,gBAAgB,GAAG,CAAC,GAAG,CAAC,GAAGE,EAAE,EAAEtB,OAAO,CAAC,CAAC,EAAEoB,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAGE,EAAG,EAC/E,CAACF,gBAAgB,EAAEE,EAAE,CACvB,CAAC;EAED,MAAMI,QAAQ,GAAGvB,WAAW,CAAC,MAAM;IACjCgB,KAAK,CAACQ,OAAO,EAAEC,eAAe,CAAC,CAACC,EAAE,EAAEC,CAAC,KAAK;MACxCT,mBAAmB,CAACU,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,KAAK,CAAC,CAAC1B,SAAS,CAAC2B,aAAa,IAAI,CAAC,IAAIJ,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,oBACElB,IAAA,CAACH,IAAI;IAACiB,QAAQ,EAAEA,QAAS;IAACS,GAAG,EAAEhB,KAAM;IAACiB,KAAK,EAAE5B,UAAU,CAAC6B,YAAa;IAACpB,MAAM,EAAEA,MAAO;IAAAF,QAAA,eACnFH,IAAA,CAACb,IAAI;MACHuC,WAAW,EAAEpB,KAAK,CAACqB,IAAI,GAAG,MAAM,GAAG,OAAQ;MAC3CC,4BAA4B,EAAExB,mBAAoB;MAClDyB,SAAS,EAAEvB,KAAK,CAACwB,YAAa;MAC9BN,KAAK,EAAE5B,UAAU,CAAC6B,YAAa;MAAAtB,QAAA,eAE/BH,IAAA,CAACd,MAAM;QAAC2B,SAAS,EAAEA,SAAU;QAAAV,QAAA,eAC3BH,IAAA,CAACF,YAAY;UAAAK,QAAA,EAAEA;QAAQ,CAAe;MAAC,CACjC;IAAC,CACL;EAAC,CACH,CAAC;AAEX,CAAC","ignoreList":[]}

package/lib/typescript/atoms/avatar/avatar.types.d.ts

@@ -1,10 +1,15 @@
 import type { ReactNode } from 'react';
 import type { ImageSourcePropType } from 'react-native';
 export type AvatarSize = 'lg' | 'md' | 'sm';
+/** A round avatar: the image in `source`, or `initials` without one. The React Native tier — it needs no host. */
 export type AvatarProps = {
+    /** Shown in place of the image when there is no `source`. */
     initials?: string;
+    /** The diameter — `sm` is `s24`, `md` `s40`, `lg` `s64`. `md` by default. */
     size?: AvatarSize;
+    /** The image, cropped to the circle. */
     source?: ImageSourcePropType;
+    /** Test identifier, forwarded to the view. */
     testID?: string;
 };
 export type AvatarComponent = (props: AvatarProps) => ReactNode;

package/lib/typescript/atoms/badge/badge.types.d.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from 'react';
 export type BadgeTone = 'accent' | 'destructive' | 'neutral' | 'success';
+/** A small status label in a capsule — a SwiftUI `HStack` in the tone's fill on iOS, Material's `Badge` on Android. */
 export type BadgeProps = {
+    /** The text inside. */
     label: string;
+    /** The fill and text colours. `neutral` by default. */
     tone?: BadgeTone;
 };
 export type BadgeComponent = (props: BadgeProps) => ReactNode;

package/lib/typescript/atoms/button/button.types.d.ts

@@ -11,12 +11,22 @@ export type ButtonStyleName = 'automatic' | 'bordered' | 'borderedProminent' | '
  * whatever the surrounding SwiftUI environment provides.
  */
 export type ButtonControlSize = 'extraLarge' | 'large' | 'mini' | 'regular' | 'small';
+/** A text button — SwiftUI `Button` on iOS, Material's filled button (outlined for `glass`) on Android. */
 export type ButtonProps = {
+    /**
+     * Replaces the style the variant picks — `borderedProminent` for `accent` and `destructive`, `bordered` for
+     * `secondary`, `glass` for `glass`. iOS only — Android ignores it.
+     */
     buttonStyle?: ButtonStyleName;
+    /** SwiftUI's control size. `large` by default. iOS only — Android ignores it. */
     controlSize?: ButtonControlSize;
+    /** Draws the button in its disabled colours and stops it responding to presses. */
     disabled?: boolean;
+    /** The button's text. */
     label: string;
+    /** Called when the button is pressed. */
     onPress?: () => void;
+    /** Test identifier, forwarded to the native view. */
     testID?: string;
     /**
      * Overrides the variant's own tint. A prominent style takes it as the fill and picks a contrasting
@@ -24,7 +34,9 @@ export type ButtonProps = {
      * the stock `.glass` style — see the iOS implementation.
      */
     tint?: ColorToken;
+    /** The look. `accent` by default. Material has no glass, so on Android `glass` is an outlined button. */
     variant?: ButtonVariant;
+    /** Stretches the button to the full width it is offered. On by default. */
     wide?: boolean;
 };
 export type ButtonComponent = (props: ButtonProps) => ReactNode;

package/lib/typescript/atoms/card/card.types.d.ts

@@ -1,7 +1,13 @@
 import type { ResponsiveSx } from '@hzblj/kara-sx';
 import type { ReactNode } from 'react';
+/**
+ * A raised container — SwiftUI `VStack` / Compose `Column` on `surface.primary`, with a large radius, `s16` padding and
+ * the `card` shadow. Any `sx` prop overrides its default.
+ */
 export type CardProps = ResponsiveSx & {
+    /** Native views, stacked vertically from the leading edge. */
     children?: ReactNode;
+    /** Test identifier, forwarded to the native view. */
     testID?: string;
 };
 export type CardComponent = (props: CardProps) => ReactNode;

package/lib/typescript/atoms/checkbox/checkbox.types.d.ts

@@ -1,8 +1,13 @@
 import type { ReactNode } from 'react';
+/** Material's `Checkbox` on Android. iOS has none, so there it is a SwiftUI `Toggle` — the same switch as `Switch`. */
 export type CheckboxProps = {
+    /** Dims the control and ignores taps. */
     disabled?: boolean;
+    /** Text beside the control. On Android the whole labelled row toggles it. */
     label?: string;
+    /** Called with the new value when the user toggles it. */
     onValueChange?: (value: boolean) => void;
+    /** Whether it is checked. Controlled — update it from `onValueChange`. */
     value: boolean;
 };
 export type CheckboxComponent = (props: CheckboxProps) => ReactNode;

package/lib/typescript/atoms/chip/chip.types.d.ts

@@ -1,8 +1,13 @@
 import type { ReactNode } from 'react';
+/** A filter pill on a `Pressable`, not a native control — the React Native tier, so it needs no host. */
 export type ChipProps = {
+    /** The text in the pill. */
     label: string;
+    /** Called when the chip is pressed, with the `selection` haptic. */
     onPress?: () => void;
+    /** Draws the chip in the accent colours. Off by default. */
     selected?: boolean;
+    /** Test identifier, forwarded to the view. */
     testID?: string;
 };
 export type ChipComponent = (props: ChipProps) => ReactNode;

package/lib/typescript/atoms/color-picker/color-picker.types.d.ts

@@ -4,9 +4,13 @@ import type { ReactNode } from 'react';
  * renders nothing and says so in dev. Branch on `Platform.OS` if the screen needs a fallback.
  */
 export type ColorPickerProps = {
+    /** Text beside the colour well. */
     label?: string;
+    /** Called with the colour the user picks. */
     onValueChange?: (color: string) => void;
+    /** Lets the user pick an opacity as well. Off by default. */
     supportsOpacity?: boolean;
+    /** Test identifier, forwarded to the native view. */
     testID?: string;
     /** `#RRGGBB` or `#RRGGBBAA`. */
     value: string | null;

package/lib/typescript/atoms/date-picker/date-picker.ios.d.ts

@@ -1,3 +1,8 @@
 import type { DatePickerComponent } from './date-picker.types';
-/** The system's compact date picker, inline: a tap on it opens the calendar popover UIKit owns. */
+/**
+ * The system's compact date picker: the value in a pill, and a tap on it opens the calendar popover UIKit owns. Its own
+ * host, sized to the pill on both axes — a host that took the width it was given would lay the pill out against the
+ * far edge of it, or past its container's — so it drops into a row the way a `Text` does. The label is the caller's,
+ * beside it; the calendar is in the accent.
+ */
 export declare const DatePicker: DatePickerComponent;

package/lib/typescript/atoms/date-picker/date-picker.types.d.ts

@@ -1,11 +1,25 @@
 import type { ReactNode } from 'react';
 export type DatePickerMode = 'date' | 'datetime' | 'time';
+/**
+ * A date or time picker — SwiftUI's compact `DatePicker` on iOS, a field that opens Material's picker dialog on a tap
+ * on Android. The React Native tier: it brings its own host and sizes itself to the value, so it sits in a row beside
+ * its label like a `Text`.
+ */
 export type DatePickerProps = {
+    /** The latest date that can be picked. Android ignores it in `time` mode. */
     max?: Date;
+    /** The earliest date that can be picked. Android ignores it in `time` mode. */
     min?: Date;
+    /**
+     * What it picks. `date` by default. Android has no combined dialog, so there `datetime` picks the date and keeps
+     * `value`'s time of day.
+     */
     mode?: DatePickerMode;
+    /** Called with the new date — on iOS as it changes, on Android when the dialog is confirmed. */
     onValueChange?: (date: Date) => void;
+    /** Test identifier — on the native picker on iOS, on the tappable field on Android. */
     testID?: string;
+    /** The selected date. Controlled — update it from `onValueChange`. */
     value: Date;
 };
 export type DatePickerComponent = (props: DatePickerProps) => ReactNode;

package/lib/typescript/atoms/divider/divider.types.d.ts

@@ -1,7 +1,10 @@
 import type { ColorToken } from '@hzblj/kara-theme';
 import type { ReactNode } from 'react';
+/** A horizontal hairline — SwiftUI `Divider` / Compose `HorizontalDivider`. */
 export type DividerProps = {
+    /** The line's colour. `border.tertiary` by default. */
     color?: ColorToken;
+    /** Test identifier, forwarded to the native view on iOS — Android ignores it. */
     testID?: string;
 };
 export type DividerComponent = (props: DividerProps) => ReactNode;

package/lib/typescript/atoms/fab/fab.types.d.ts

@@ -1,8 +1,15 @@
 import type { ReactNode } from 'react';
 import type { IconName } from '../icon';
+/**
+ * A floating action button — Material's `FloatingActionButton` on Android, a 56pt accent circle (a plain SwiftUI
+ * `Button`) on iOS. It renders inline; pinning it to a corner is up to the screen.
+ */
 export type FabProps = {
+    /** The icon, one of the app's, drawn in `content.on.bg`. */
     name: IconName;
+    /** Called when the button is pressed. */
     onPress?: () => void;
+    /** Test identifier, forwarded to the native view on iOS — Android ignores it. */
     testID?: string;
 };
 export type FabComponent = (props: FabProps) => ReactNode;

package/lib/typescript/atoms/glass-view/glass-view.types.d.ts

@@ -11,6 +11,7 @@ export type GlassViewProps = ResponsiveViewSx & {
     children?: ReactNode;
     /** Swells toward the finger on touch, carrying the children with it. Wrap the view in a `Pressable` for the press. */
     interactive?: boolean;
+    /** Test identifier, forwarded to the view. */
     testID?: string;
     /** Tints the material. Unset leaves it clear. */
     tint?: ColorToken;

package/lib/typescript/atoms/h-stack/h-stack.types.d.ts

@@ -2,11 +2,17 @@ import type { ResponsiveSx } from '@hzblj/kara-sx';
 import type { SpaceSize } from '@hzblj/kara-theme';
 import type { ReactNode } from 'react';
 export type HStackAlign = 'center' | 'end' | 'start';
+/** A horizontal stack — SwiftUI `HStack` / Compose `Row`. */
 export type HStackProps = ResponsiveSx & {
+    /** How the children line up vertically — `start` is the top, `end` the bottom. `start` by default. */
     align?: HStackAlign;
+    /** Native views, laid out from the leading edge. */
     children?: ReactNode;
+    /** Makes the stack pressable — a tap gesture on iOS, a `clickable` with Material's ripple on Android. */
     onPress?: () => void;
+    /** The gap between children. Unset, SwiftUI puts its default spacing between them and Compose none. */
     spacing?: SpaceSize;
+    /** Test identifier, forwarded to the native view. */
     testID?: string;
 };
 export type HStackComponent = (props: HStackProps) => ReactNode;

package/lib/typescript/atoms/icon/icon.types.d.ts

@@ -15,12 +15,20 @@ type DeclaredIconName = keyof KaraIcons & string;
  * from the folder fails at every call site. Before that, any string, so a project can adopt icons gradually.
  */
 export type IconName = [DeclaredIconName] extends [never] ? string : DeclaredIconName;
+/**
+ * One of the app's icons, in a host — SwiftUI `Image` from the asset catalog on iOS, Material's `Icon` with the vector
+ * drawable on Android. `RnIcon` draws the same asset outside one.
+ */
 export type IconProps = {
     /** What a screen reader says. Unset, the icon is decorative and hidden from it. */
     accessibilityLabel?: string;
+    /** The icon's tint. `content.primary` by default. */
     color?: ColorToken;
+    /** Which of the app's icons — a key of `KaraIcons`. */
     name: IconName;
+    /** Its width and height, a spacing token. `s24` by default. */
     size?: SpaceSize;
+    /** Test identifier, forwarded to the native view on iOS — Android ignores it. */
     testID?: string;
 };
 export type IconComponent = (props: IconProps) => ReactNode;

package/lib/typescript/atoms/icon-button/icon-button.types.d.ts

@@ -1,9 +1,14 @@
 import type { ReactNode } from 'react';
 import type { IconName } from '../icon';
+/** A button that is just an icon — a plain SwiftUI `Button` on iOS, Material's `IconButton` on Android. */
 export type IconButtonProps = {
+    /** Draws the icon in `btn.content.disabled` and stops the button responding to presses. */
     disabled?: boolean;
+    /** The icon, one of the app's. */
     name: IconName;
+    /** Called when the button is pressed. */
     onPress?: () => void;
+    /** Test identifier, forwarded to the native view on iOS — Android ignores it. */
     testID?: string;
 };
 export type IconButtonComponent = (props: IconButtonProps) => ReactNode;

package/lib/typescript/atoms/index.d.ts

@@ -10,7 +10,6 @@ export * from './color-picker';
 export * from './date-picker';
 export * from './divider';
 export * from './fab';
-export * from './flash-list';
 export * from './glass-view';
 export * from './h-stack';
 export * from './icon';

package/lib/typescript/atoms/island/island.types.d.ts

@@ -1,6 +1,8 @@
 import type { ReactNode } from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
+/** A host for native atoms in a React Native layout — the SwiftUI / Compose `Host` an `@expo/ui` tree mounts into. */
 export type IslandProps = {
+    /** The native views it hosts. */
     children?: ReactNode;
     /**
      * Sizes the island's height to its native content while the width still comes from the parent, which
@@ -14,7 +16,9 @@ export type IslandProps = {
      * hangs the main thread as soon as the views lay out on screen.
      */
     matchContents?: boolean;
+    /** A React Native style for the host view — its size and placement. It needs a height when `matchContents` is off. */
     style?: StyleProp<ViewStyle>;
+    /** Test identifier, forwarded to the host view on iOS — Android ignores it. */
     testID?: string;
 };
 export type IslandComponent = (props: IslandProps) => ReactNode;

package/lib/typescript/atoms/list/list.types.d.ts

@@ -9,12 +9,14 @@ import type { ReactNode } from 'react';
  * the children is one too many: on iOS it becomes an empty row of its own.
  */
 export type ListProps = {
+    /** The rows — native views, one row each. */
     children: ReactNode;
     /**
      * Enables pull-to-refresh. Async on purpose — see `ScrollViewProps.onRefresh`: the spinner runs
      * until the promise settles, so neither platform needs a `refreshing` flag kept in sync by hand.
      */
     onRefresh?: () => Promise<void>;
+    /** Test identifier, forwarded to the native view on iOS — Android ignores it. */
     testID?: string;
 };
 export type ListComponent = (props: ListProps) => ReactNode;