pixelize-native-library 1.2.0 → 1.3.0

package/lib/module/core/a11y/MODULE.md

@@ -12,6 +12,7 @@ once instead of each re-implementing the same hook.
 | `announce.ts` / `announce.web.ts` | `useAnnouncer()` — the platform's "say this now" primitive behind `useAnnounce`. |
 | `keyboard.ts` / `keyboard.web.ts` | Physical-keyboard interaction — WCAG 2.1.1 / 2.4.3. Native file is all no-ops. |
 | `labels.ts` | Accessibility-label phrasings that must read identically everywhere the same action appears (WCAG 3.2.4) — currently `removeAccessibilityLabel()`. |
+| `touchTarget.ts` | Shared `MIN_TOUCH_TARGET` (44dp) and `slopFor()` — imported by control `*.variants.ts` files. |
 
 **Internal only.** Nothing here is a package subpath export (`package.json` `exports` is generated
 from `src/modules/` alone) — these are helpers modules import, never part of the public surface.
@@ -106,7 +107,7 @@ Imported directly (`core/a11y/keyboard`), not through `index.ts`. Five exports:
 `PressResponder.isValidKeyPress` is `Enter || (Space && isButtonish)`, and `isButtonish` needs a
 `button` tag or `role="button"` — so `role="checkbox" | "radio" | "tab" | "menuitem"` render as a
 `div` where Space scrolls the page instead of activating. **Do not "fix" that by changing the role.**
-First consumer: `checkbox` (`Checkbox.tsx`, where Space is the primary key).
+Wired in `checkbox`, `select`, `multi-select`, `combobox` and `menu`.
 
 ## Accessibility state props — flat, never object-shaped
 
@@ -132,14 +133,13 @@ native `accessibilityState` key.
   `Platform.OS === "android"`-gated live region instead — iOS/VoiceOver announces a text-content
   change in an already-visible node without it, so `useAnnounce` there would double-speak.
 - No `useAccessibilityFocus` (programmatically moving reader focus) — nothing has needed it yet.
-- Six modules besides `checkbox` need `useSpaceActivation` (radio, tab, menu item, …) — only
-  `checkbox` is wired so far.
+- `useSpaceActivation` is still unwired on the remaining non-`button` roles (`radio-group`'s radios,
+  `tabs`' tabs), where Space scrolls the page on web instead of activating.
 - `useFocusTrap` does not pull focus back when it escapes the subtree by means other than Tab
   (a click outside, or a programmatic `focus()`); it only cycles Tab at the ends.
-- **A consumer that freezes the value at mount still reads the pre-probe seed.**
-  `message-bubble/MessageBubble.tsx:41` does `useRef(motion.decorative)`, so the very first bubble
-  mounted in a process keeps whatever the seed said. The cache makes that one mount, not every
-  mount; the real fix belongs in the module.
+- **A consumer that freezes the value at mount reads the pre-probe seed for that mount's lifetime.**
+  The process cache limits it to the first mount in an app run, but a module that copies
+  `motion.*` into a ref instead of reading the hook opts out of every later OS change.
 - A probe that settles after the last reader unmounts still writes the cache on purpose (the next
   mount wants that answer). There is no per-instance `mounted` guard any more — the store simply has
   no listeners to notify.

package/lib/module/core/a11y/touchTarget.js

@@ -0,0 +1,6 @@
+"use strict";
+
+/** WCAG 2.5.5 / Apple HIG minimum touch target (44×44 dp). */
+export const MIN_TOUCH_TARGET = 44;
+export const slopFor = height => Math.max(0, Math.ceil((MIN_TOUCH_TARGET - height) / 2));
+//# sourceMappingURL=touchTarget.js.map

package/lib/module/core/blur/blur.js

@@ -0,0 +1,17 @@
+"use strict";
+
+/** Minimal `expo-blur` `BlurView` surface — only props AppBar passes. */
+
+let blurView = null;
+
+/** Injects expo-blur at runtime — never imports the package at module scope. */
+export function setBlurModule(BlurView) {
+  blurView = BlurView;
+}
+export function hasBlurModule() {
+  return blurView !== null;
+}
+export function getBlurModule() {
+  return blurView;
+}
+//# sourceMappingURL=blur.js.map

package/lib/module/core/blur/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { setBlurModule, hasBlurModule, getBlurModule } from "./blur.js";
+//# sourceMappingURL=index.js.map

package/lib/module/core/device/MODULE.md

@@ -9,7 +9,8 @@ One probe, once per process, behind a `globalThis` slot. `MOTION_TIER` (`core/mo
 | `resolveDeviceTier(reducedMotion)` | `probeTier()` plus the reduce-motion demotion. What `useMotion` calls. |
 | `useDeviceTier()` | The hook form — `resolveDeviceTier` over the reduce-motion store. |
 | `setDeviceTierForTests(tier)` | Overrides (or, with `undefined`, clears) the cached slot. |
-| `getListWindowSize(tier)` | Rows to keep windowed. No current caller. |
+| `DeviceTier` | The `low \| mid \| high` union itself. |
+| `getListWindowSize(tier)` | Rows to keep windowed (5 / 10 / 15). Dead — nothing in the repo calls it. |
 
 ## The mapping
 
@@ -37,11 +38,7 @@ repo. Until it is, Android is `low` or `mid`, so this probe only ever *demotes*.
 **iOS demotes only on positive evidence.** An unreadable `Platform.Version` (Jest, a stubbed
 Platform) stays `high`, so a missing signal never silently strips motion from every iOS device.
 
-## What this replaced
+## Testing
 
-The shipped probe read `Platform.constants.reactNativeVersion.minor` — the **bundler's** RN version —
-and compared it to a device year class: `if (Platform.OS === 'android' && yearClass < 74) tier =
-'low'`. RN is 0.86, so the value was always 86 and the branch never fired: **every** Android device
-resolved `mid`, including the 2GB target the tier system exists for, and every iOS device resolved
-`high` unconditionally. It survived because ~15 suites pin the tier with `setDeviceTierForTests` and
-`probeTier` itself had no test. `__tests__/probeTier.test.ts` now covers it, and pre-seeds nothing.
+Roughly 15 suites pin the tier with `setDeviceTierForTests`, so a broken `probeTier` hides easily —
+`__tests__/probeTier.test.ts` covers the probe itself and pre-seeds nothing.

package/lib/module/core/gradient/AccentGradientFill.js

@@ -0,0 +1,83 @@
+"use strict";
+
+import { memo, useId } from 'react';
+import { StyleSheet, View } from 'react-native';
+import { accentGradientStops, shouldRenderGradient } from "./gradientStops.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+let svgModule;
+function loadSvg() {
+  if (svgModule !== undefined) return svgModule;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports -- optional peer fallback
+    svgModule = require('react-native-svg');
+  } catch {
+    svgModule = null;
+  }
+  return svgModule;
+}
+export const AccentGradientFill = /*#__PURE__*/memo(function AccentGradientFill({
+  color,
+  style
+}) {
+  const stops = accentGradientStops(color);
+  const gradId = `accentGrad-${useId().replace(/:/g, '')}`;
+  if (!shouldRenderGradient(stops)) {
+    return /*#__PURE__*/_jsx(View, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: color
+      }, style, {
+        pointerEvents: 'none'
+      }]
+    });
+  }
+  const svg = loadSvg();
+  if (!svg) {
+    return /*#__PURE__*/_jsx(View, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: color
+      }, style, {
+        pointerEvents: 'none'
+      }]
+    });
+  }
+  const {
+    Svg,
+    Defs,
+    LinearGradient,
+    Stop,
+    Rect
+  } = svg;
+  return /*#__PURE__*/_jsx(View, {
+    style: [StyleSheet.absoluteFill, style, {
+      pointerEvents: 'none'
+    }],
+    children: /*#__PURE__*/_jsxs(Svg, {
+      width: "100%",
+      height: "100%",
+      style: StyleSheet.absoluteFill,
+      children: [/*#__PURE__*/_jsx(Defs, {
+        children: /*#__PURE__*/_jsxs(LinearGradient, {
+          id: gradId,
+          x1: "0",
+          y1: "0",
+          x2: "0",
+          y2: "1",
+          children: [/*#__PURE__*/_jsx(Stop, {
+            offset: "0",
+            stopColor: stops.top
+          }), /*#__PURE__*/_jsx(Stop, {
+            offset: "1",
+            stopColor: stops.bottom
+          })]
+        })
+      }), /*#__PURE__*/_jsx(Rect, {
+        x: "0",
+        y: "0",
+        width: "100%",
+        height: "100%",
+        fill: `url(#${gradId})`
+      })]
+    })
+  });
+});
+//# sourceMappingURL=AccentGradientFill.js.map

package/lib/module/core/gradient/ShimmerGradientFill.js

@@ -0,0 +1,79 @@
+"use strict";
+
+import { memo, useId } from "react";
+import { StyleSheet, View } from "react-native";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+let svgModule;
+function loadSvg() {
+  if (svgModule !== undefined) return svgModule;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports -- optional peer fallback
+    svgModule = require("react-native-svg");
+  } catch {
+    svgModule = null;
+  }
+  return svgModule;
+}
+export const ShimmerGradientFill = /*#__PURE__*/memo(function ShimmerGradientFill({
+  base,
+  highlight,
+  style
+}) {
+  const gradId = `shimmerGrad-${useId().replace(/:/g, "")}`;
+  const svg = loadSvg();
+  if (!svg) {
+    return /*#__PURE__*/_jsx(View, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: highlight
+      }, style, {
+        pointerEvents: 'none'
+      }]
+    });
+  }
+  const {
+    Svg,
+    Defs,
+    LinearGradient,
+    Stop,
+    Rect
+  } = svg;
+  return /*#__PURE__*/_jsx(View, {
+    style: [StyleSheet.absoluteFill, style, {
+      pointerEvents: 'none'
+    }],
+    children: /*#__PURE__*/_jsxs(Svg, {
+      width: "100%",
+      height: "100%",
+      style: StyleSheet.absoluteFill,
+      children: [/*#__PURE__*/_jsx(Defs, {
+        children: /*#__PURE__*/_jsxs(LinearGradient, {
+          id: gradId,
+          x1: "0",
+          y1: "0",
+          x2: "1",
+          y2: "0",
+          children: [/*#__PURE__*/_jsx(Stop, {
+            offset: "0",
+            stopColor: base,
+            stopOpacity: "1"
+          }), /*#__PURE__*/_jsx(Stop, {
+            offset: "0.5",
+            stopColor: highlight,
+            stopOpacity: "1"
+          }), /*#__PURE__*/_jsx(Stop, {
+            offset: "1",
+            stopColor: base,
+            stopOpacity: "1"
+          })]
+        })
+      }), /*#__PURE__*/_jsx(Rect, {
+        x: "0",
+        y: "0",
+        width: "100%",
+        height: "100%",
+        fill: `url(#${gradId})`
+      })]
+    })
+  });
+});
+//# sourceMappingURL=ShimmerGradientFill.js.map

package/lib/module/core/gradient/darkenHex.js

@@ -0,0 +1,13 @@
+"use strict";
+
+export function darkenHex(hex, amount) {
+  const normalized = hex.replace('#', '');
+  const full = normalized.length === 3 ? normalized.split('').map(c => c + c).join('') : normalized;
+  const r = parseInt(full.slice(0, 2), 16);
+  const g = parseInt(full.slice(2, 4), 16);
+  const b = parseInt(full.slice(4, 6), 16);
+  const factor = 1 - amount;
+  const toHex = n => Math.round(Math.max(0, Math.min(255, n * factor))).toString(16).padStart(2, '0');
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+//# sourceMappingURL=darkenHex.js.map

package/lib/module/core/gradient/gradientStops.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { hexToHsl, withLightness } from "../../theme/tokens/builders/color.js";
+import { darkenHex } from "./darkenHex.js";
+export function accentGradientStops(color) {
+  const {
+    l: lightness
+  } = hexToHsl(color);
+  if (lightness > 30) {
+    return {
+      top: color,
+      bottom: withLightness(color, lightness - 10)
+    };
+  }
+  return {
+    top: withLightness(color, lightness + 7),
+    bottom: color
+  };
+}
+export function gradientStopDelta(stops) {
+  return Math.abs(hexToHsl(stops.top).l - hexToHsl(stops.bottom).l);
+}
+export function shouldRenderGradient(stops) {
+  return gradientStopDelta(stops) >= 3;
+}
+export { darkenHex };
+//# sourceMappingURL=gradientStops.js.map

package/lib/module/core/gradient/index.js

@@ -0,0 +1,8 @@
+"use strict";
+
+export { AccentGradientFill } from "./AccentGradientFill.js";
+export { ShimmerGradientFill } from "./ShimmerGradientFill.js";
+export { accentGradientStops, gradientStopDelta, shouldRenderGradient } from "./gradientStops.js";
+export { darkenHex } from "./darkenHex.js";
+export { withAlpha } from "./withAlpha.js";
+//# sourceMappingURL=index.js.map

package/lib/module/core/gradient/withAlpha.js

@@ -0,0 +1,19 @@
+"use strict";
+
+function expandHex(hex) {
+  const normalized = hex.replace('#', '');
+  if (normalized.length === 3) {
+    return normalized.split('').map(c => c + c).join('');
+  }
+  if (normalized.length === 8) return normalized.slice(0, 6);
+  return normalized;
+}
+export function withAlpha(hex, alpha) {
+  const full = expandHex(hex);
+  const r = parseInt(full.slice(0, 2), 16);
+  const g = parseInt(full.slice(2, 4), 16);
+  const b = parseInt(full.slice(4, 6), 16);
+  const a = Math.max(0, Math.min(1, alpha));
+  return `rgba(${r}, ${g}, ${b}, ${a})`;
+}
+//# sourceMappingURL=withAlpha.js.map

package/lib/module/core/haptics/MODULE.md

@@ -0,0 +1,8 @@
+# core/haptics — the optional expo-haptics seam
+
+Call `setHapticsModule(Haptics)` at app startup; `useHaptics()` returns `{ selection, impact,
+notification }`, each a no-op when the module is unset, on web, or when `haptics={false}` on
+`PixelizeProvider` (read through `HapticsContext`).
+
+Published as `pixelize-native-library/haptics` and re-exported from the root barrel so apps can wire
+the peer without deep-importing module internals.

package/lib/module/core/haptics/context.js

@@ -0,0 +1,7 @@
+"use strict";
+
+import { createContext } from 'react';
+
+/** Whether the provider allows haptics — see `PixelizeProvider`'s `haptics` prop. */
+export const HapticsContext = /*#__PURE__*/createContext(false);
+//# sourceMappingURL=context.js.map

package/lib/module/core/haptics/haptics.js

@@ -0,0 +1,17 @@
+"use strict";
+
+/** Optional peer — injected at app startup, never imported at module scope. */
+
+let hapticsModule = null;
+
+/** Injects expo-haptics at runtime — never imports the package at module scope. */
+export function setHapticsModule(module) {
+  hapticsModule = module;
+}
+export function hasHapticsModule() {
+  return hapticsModule !== null;
+}
+export function getHapticsModule() {
+  return hapticsModule;
+}
+//# sourceMappingURL=haptics.js.map

package/lib/module/core/haptics/index.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export { setHapticsModule, hasHapticsModule, getHapticsModule } from "./haptics.js";
+export { HapticsContext } from "./context.js";
+export { useHaptics } from "./useHaptics.js";
+//# sourceMappingURL=index.js.map

package/lib/module/core/haptics/useHaptics.js

@@ -0,0 +1,73 @@
+"use strict";
+
+import { useCallback, useContext, useMemo } from 'react';
+import { Platform } from 'react-native';
+import { HapticsContext } from "./context.js";
+import { getHapticsModule } from "./haptics.js";
+const IMPACT_STYLE = {
+  light: 'Light',
+  medium: 'Medium',
+  heavy: 'Heavy',
+  soft: 'Soft',
+  rigid: 'Rigid'
+};
+const NOTIFICATION_TYPE = {
+  success: 'Success',
+  warning: 'Warning',
+  error: 'Error'
+};
+function runSafe(task) {
+  try {
+    void task().catch(() => {});
+  } catch {
+    // Unconfigured or unsupported — silent no-op.
+  }
+}
+const NOOP_HAPTICS = {
+  selection: () => undefined,
+  impact: () => undefined,
+  notification: () => undefined
+};
+
+/**
+ * Fires haptic feedback when a module is registered and the provider has not disabled it.
+ * No-ops on web, when unset, or when `haptics={false}`.
+ */
+export function useHaptics() {
+  const enabled = useContext(HapticsContext);
+  const module = getHapticsModule();
+  const selection = useCallback(() => {
+    if (!enabled || Platform.OS === 'web' || module === null) return;
+    if (Platform.OS === 'android') {
+      runSafe(() => module.performAndroidHapticsAsync(module.AndroidHaptics.Context_Click));
+      return;
+    }
+    runSafe(() => module.selectionAsync());
+  }, [enabled, module]);
+  const impact = useCallback((style = 'light') => {
+    if (!enabled || Platform.OS === 'web' || module === null) return;
+    if (Platform.OS === 'android') {
+      // Bluesky downgrade — Android simulated impacts feel too strong; use the lightest constant.
+      runSafe(() => module.performAndroidHapticsAsync(module.AndroidHaptics.Virtual_Key));
+      return;
+    }
+    const key = IMPACT_STYLE[style];
+    runSafe(() => module.impactAsync(module.ImpactFeedbackStyle[key]));
+  }, [enabled, module]);
+  const notification = useCallback(type => {
+    if (!enabled || Platform.OS === 'web' || module === null) return;
+    if (Platform.OS === 'android') {
+      const androidType = type === 'success' ? module.AndroidHaptics.Confirm : type === 'error' ? module.AndroidHaptics.Reject : module.AndroidHaptics.Context_Click;
+      runSafe(() => module.performAndroidHapticsAsync(androidType));
+      return;
+    }
+    const key = NOTIFICATION_TYPE[type];
+    runSafe(() => module.notificationAsync(module.NotificationFeedbackType[key]));
+  }, [enabled, module]);
+  return useMemo(() => enabled && module !== null && Platform.OS !== 'web' ? {
+    selection,
+    impact,
+    notification
+  } : NOOP_HAPTICS, [enabled, module, selection, impact, notification]);
+}
+//# sourceMappingURL=useHaptics.js.map

package/lib/module/core/heading/MODULE.md

@@ -1,4 +1,4 @@
-# core/heading
+# core/heading — the one place aria-level is typed
 
 The single place that types and documents `aria-level` — the prop `react-native-web` needs to turn
 `accessibilityRole="header"` into the right `<h1>`-`<h6>`, instead of always `<h1>`.

package/lib/module/core/icon/MODULE.md

@@ -2,13 +2,17 @@
 
 Every module's `icon` prop takes a NAME from `IconName`, never a `ReactNode` — same discipline as
 `tone`/`variant` elsewhere in the contract. Hoisted out of `button/` (where it first landed) so
-every one of the 39 shipped modules imports one registry instead of each re-copying its own.
+every shipped module imports one registry instead of each re-copying its own.
 
 ## Files
 
 | File | Role |
 |------|------|
-| `index.tsx` | `Icon` component + `ICON_COMPONENTS` map + the `IconName` union. |
+| `index.tsx` | Barrel re-exporting `Icon`, `resolveIcon` and the `IconName` / `IconProps` / `IconComponent` / `LucideIconProps` types. |
+| `Icon.tsx` | The `Icon` component (resolves `name` via `resolveIcon`, applies the a11y contract below). |
+| `names.ts` | The `IconName` union — one string literal per glyph. |
+| `resolve.ts` | `resolveIcon(name)` — a `switch` over `IconName`, one `case` per glyph, each `require`-ing its own file under `icons/`. |
+| `icons/<kebab-name>.tsx` | One file per glyph, each deep-importing its own `lucide-react-native/icons/<kebab-name>`. |
 
 ## Accessibility contract (WCAG 1.3.1 / 1.1.1)
 
@@ -24,12 +28,9 @@ Pass `label` (optional) for the rare icon that carries information no neighbouri
   itself (`View.js`), so one prop covers both platforms.
 - **Why decorative-by-default, not opt-in-hidden**: every consumer in this catalogue that renders a
   meaningful glyph already provides a text label beside it (a button's own `accessibilityLabel`, a
-  banner's title/message) — the icon was ALWAYS meant to be redundant, and most call sites already
-  hand-wrapped it in a hidden `View` to say so. The one that didn't (`Banner`'s tone glyph) shipped
-  an exposed, unlabelled glyph to assistive tech — a per-consumer mistake that recurred because the
-  default made it easy to forget, not a `Banner`-specific defect. Flagged prominently: `label` is new
-  public API on `IconProps`/`IconComponent` callers that pass it through `Icon` directly (most
-  modules resolve their own glyph via `resolveIcon` and never touch this prop).
+  banner's title/message) — the icon is meant to be redundant, so hiding by default puts the easy
+  mistake on the safe side. Most modules resolve their own glyph via `resolveIcon` and never pass
+  `label` at all.
 - `__tests__/Icon.render.test.tsx` pins both states on the native project; `__tests__/Icon.dom.test.tsx`
   proves the same contract lands as a real DOM `aria-hidden`/`role="img"` attribute under
   `jest.web.config.js` — the native assertion alone cannot catch a prop RNW silently drops.
@@ -39,9 +40,10 @@ Pass `label` (optional) for the rare icon that carries information no neighbouri
 - Icons are DEEP-IMPORTED from `lucide-react-native/icons/<kebab-name>`, never the barrel
   `lucide-react-native` — the barrel is ~233 KB and defeats per-icon tree-shaking; a deep import is
   ~656 B.
-- `ICON_COMPONENTS` is a STATIC object literal so every deep import stays statically analysable.
-- Adding a glyph: add one deep import + one `ICON_COMPONENTS` entry here. Never add a per-module
-  icon map.
+- Each glyph's deep import lives in its own `icons/<kebab-name>.tsx` file, kept statically
+  analysable per-glyph rather than one shared object literal.
+- Adding a glyph: add `icons/<kebab-name>.tsx` (deep import, mirrors any existing file), one
+  `IconName` union member in `names.ts`, one `case` in `resolve.ts`. Never add a per-module icon map.
 
 ## Dependencies
 
@@ -51,19 +53,16 @@ devDependencies here for local build/typecheck/test only.
 
 ## Known gaps
 
-- Catalogue started as a starter set (the icons Button needed) and has grown one batch at a time —
-  69 glyphs as of the 2026-07 addition of `rich-text-editor`'s toolbar set (`bold`, `italic`,
-  `underline`, `strikethrough`, `code`, `square-code`, `heading-1/2/3`, `quote`, `list-ordered`,
-  `list-checks`, `at-sign`), on top of the earlier navigation + ticket-detail names for the
-  tickets-native consumer (`layout-dashboard`, `kanban`, `calendar`, `tag`, `flag`, … — see the
-  inline comment above `ICON_COMPONENTS` for the full list). Add names as later components need them.
+- The catalogue is a curated 74-glyph set grown one batch at a time, not a mirror of lucide. Add
+  names as later components need them — `names.ts` is the full current list. A name missing from it
+  is a compile error at the call site, and `resolve.ts`'s `default` branch is an exhaustiveness
+  `never`, so a name added to the union without a `case` fails typecheck rather than at runtime.
 - `filter` deep-imports from lucide's `funnel` module: lucide renamed the `filter` icon to `funnel`
   and only left a `.d.ts` type alias at the old path (no runtime file there) — confirmed by
   resolving `lucide-react-native/icons/funnel` before adding this entry, the same trap
   `more-horizontal` (now `ellipsis`) already hit once in this registry.
-
-## Modernization (v1.0.7)
-
-- Theme imports decoupled to `theme/hooks`; optional peers (reanimated, gesture-handler, flash-list) load at runtime.
-- List-heavy surfaces use `VirtualList` with device-tier window sizing where applicable.
-- `React.memo` + stable callbacks retained; render-item/key-extractor hoisted per ESLint perf rules.
+- `building-2` keeps its public `IconName` key but deep-imports `building-complex` — lucide 1.45+
+  dropped the old path. `__tests__/lucideRuntimeResolution.test.ts`
+  walks every glyph file and asserts `require.resolve('lucide-react-native/icons/<path>')` succeeds.
+- `resolve.ts` loads each glyph via `require()` inside the switch so only the requested icon's
+  lucide file enters the bundle; `index.tsx` does not import every glyph at module scope.

package/lib/module/core/icon/icons/building-2.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import Building2 from "lucide-react-native/icons/building-2";
+import Building2 from "lucide-react-native/icons/building-complex";
 import { jsx as _jsx } from "react/jsx-runtime";
 export function IconBuilding2(props) {
   return /*#__PURE__*/_jsx(Building2, {

package/lib/module/core/icon/icons/trash.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import Trash from "lucide-react-native/icons/trash-2";
+import Trash from "lucide-react-native/icons/trash";
 import { jsx as _jsx } from "react/jsx-runtime";
 export function IconTrash(props) {
   return /*#__PURE__*/_jsx(Trash, {

package/lib/module/core/icon/icons/trending-up.js

@@ -0,0 +1,10 @@
+"use strict";
+
+import TrendingUp from "lucide-react-native/icons/trending-up";
+import { jsx as _jsx } from "react/jsx-runtime";
+export function IconTrendingUp(props) {
+  return /*#__PURE__*/_jsx(TrendingUp, {
+    ...props
+  });
+}
+//# sourceMappingURL=trending-up.js.map

package/lib/module/core/icon/resolve.js

@@ -136,6 +136,8 @@ export function resolveIcon(name) {
       return require("./icons/tag").IconTag;
     case "trash":
       return require("./icons/trash").IconTrash;
+    case "trending-up":
+      return require("./icons/trending-up").IconTrendingUp;
     case "triangle-alert":
       return require("./icons/triangle-alert").IconTriangleAlert;
     case "underline":

package/lib/module/core/list/VirtualList.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import { useCallback, useMemo } from 'react';
-import { FlatList, Platform } from 'react-native';
+import { FlatList, Platform, RefreshControl } from 'react-native';
 import { useDeviceTier } from "../device/index.js";
 
 /**
@@ -94,7 +94,12 @@ export function VirtualList({
   accessibilityRole = 'list',
   accessibilityLabel,
   accessibilityHint,
-  testID
+  testID,
+  refreshing,
+  onRefresh,
+  onEndReached,
+  onEndReachedThreshold,
+  ItemSeparatorComponent
 }) {
   const tier = useDeviceTier();
   const tuning = useMemo(() => flatListTuning(tier), [tier]);
@@ -114,6 +119,10 @@ export function VirtualList({
     index,
     separators: NO_SEPARATORS
   }), [renderItem]);
+  const refreshControl = useMemo(() => onRefresh === undefined ? undefined : /*#__PURE__*/_jsx(RefreshControl, {
+    refreshing: refreshing ?? false,
+    onRefresh: onRefresh
+  }), [onRefresh, refreshing]);
   if (FlashList) {
     return /*#__PURE__*/_jsx(FlashList, {
       testID: testID,
@@ -153,7 +162,11 @@ export function VirtualList({
     maxToRenderPerBatch: tuning.maxToRenderPerBatch,
     windowSize: tuning.windowSize,
     updateCellsBatchingPeriod: tuning.updateCellsBatchingPeriod,
-    removeClippedSubviews: tuning.removeClippedSubviews
+    removeClippedSubviews: tuning.removeClippedSubviews,
+    onEndReached: onEndReached,
+    onEndReachedThreshold: onEndReachedThreshold,
+    ItemSeparatorComponent: ItemSeparatorComponent,
+    refreshControl: refreshControl
   });
 }
 

package/lib/module/core/media/expoImage.js

@@ -1,5 +1,11 @@
 "use strict";
 
+/**
+ * expo-image's real `Image` component does NOT extend RN's `ImageProps` (its `source`, `style` and
+ * `tintColor` shapes all diverge) — this is a minimal structural subset covering only what
+ * `MediaImage.tsx` actually passes, not a copy of RN's own image props.
+ */
+
 let imageComponent = null;
 
 /** Injects expo-image at runtime — never imports the package at module scope. */