rnwind 0.0.4 → 0.0.5

package/lib/cjs/runtime/resolve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.cjs","sources":["../../../../src/runtime/resolve.ts"],"sourcesContent":["import { getStyleVersion, lookupCss, type InteractState } from './lookup-css'\nimport type { RnwindState } from './components/rnwind-provider'\nimport { normalizeClassName } from '../core/normalize-classname'\nimport type { GradientAtomInfo, GradientDirection } from '../core/parser/gradient'\nimport type { HapticRequest, HapticTrigger } from '../core/parser/haptics'\n\n/**\n * Rich className resolver — the runtime heart of the wrap / `useCss`.\n *\n * Resolution order, per className string:\n *  1. **Molecule** — a build-time PRE-MERGED single style object for the\n *     whole literal className (per scheme). One map lookup returns it by\n *     reference: no array, no merge, no per-atom loop. The common case.\n *  2. **Atom fallback** — for a className the scanner never saw (a\n *     runtime-built string like `` `${className} px-2` ``) OR one that\n *     carries context-dependent atoms (`pt-safe`, `text-base`, `md:*`),\n *     fall back to per-atom resolution via `lookupCss`, which folds in\n *     insets / fontScale / breakpoint / scheme.\n *\n * Results are cached by `(normalized className, scheme, insets, fontScale,\n * breakpoint)` so repeated renders return the SAME reference until the\n * reactive context changes. Atoms / molecules / features all live in\n * build-time registries the generated `.rnwind/*.js` modules populate.\n */\n\n/** Always-loaded fallback scheme key. */\nconst COMMON_SCHEME = 'common'\n\n/** Empty style sentinel. */\nconst EMPTY: readonly unknown[] = []\n\n/** scheme → normalized className → pre-merged style object. */\nlet molecules: Record<string, Record<string, unknown>> = Object.create(null)\n/** atom name → gradient role + resolved colour. */\nlet gradients: Record<string, GradientAtomInfo> = Object.create(null)\n/** atom name (incl. `active:`/`focus:` prefix) → haptic request. */\nlet haptics: Record<string, HapticRequest> = Object.create(null)\n/** Bumps on any molecule/gradient/haptic registration. */\nlet registryVersion = 0\n\n/** Per-(className·state) resolved cache — strong references between context changes. */\nconst resolvedCache = new Map<string, ResolvedCss>()\n/** Version the cache was last valid for (`getStyleVersion()` + {@link registryVersion}). */\nlet cachedFor = -1\n\n/** A unit-square gradient endpoint. */\ninterface GradientPoint {\n  readonly x: number\n  readonly y: number\n}\n\n/** Rich resolution: the RN `style` plus any className-derived props. */\nexport interface ResolvedCss {\n  /** RN `style` value — a single molecule object (by ref) or an atom array. */\n  readonly style: unknown\n  /** Gradient stop colours (when the className is a complete gradient). */\n  readonly colors?: readonly string[]\n  /** Gradient start point. */\n  readonly start?: GradientPoint\n  /** Gradient end point. */\n  readonly end?: GradientPoint\n  /** Text truncation line count. */\n  readonly numberOfLines?: number\n  /** Text ellipsize mode. */\n  readonly ellipsizeMode?: 'tail' | 'clip'\n  /** Haptic requests present on the className, for the wrap to dispatch. */\n  readonly haptics?: readonly { readonly request: HapticRequest; readonly trigger: HapticTrigger }[]\n}\n\n/** `GradientDirection` → expo-linear-gradient start/end points. */\nconst DIRECTION_POINTS: Record<GradientDirection, { start: GradientPoint; end: GradientPoint }> = {\n  'to-t': { start: { x: 0.5, y: 1 }, end: { x: 0.5, y: 0 } },\n  'to-b': { start: { x: 0.5, y: 0 }, end: { x: 0.5, y: 1 } },\n  'to-l': { start: { x: 1, y: 0.5 }, end: { x: 0, y: 0.5 } },\n  'to-r': { start: { x: 0, y: 0.5 }, end: { x: 1, y: 0.5 } },\n  'to-tl': { start: { x: 1, y: 1 }, end: { x: 0, y: 0 } },\n  'to-tr': { start: { x: 0, y: 1 }, end: { x: 1, y: 0 } },\n  'to-bl': { start: { x: 1, y: 0 }, end: { x: 0, y: 1 } },\n  'to-br': { start: { x: 0, y: 0 }, end: { x: 1, y: 1 } },\n  unknown: { start: { x: 0, y: 0.5 }, end: { x: 1, y: 0.5 } },\n}\n\n/**\n * Register one scheme's pre-merged molecules (atom-merged literal\n * classNames). Merges onto any existing entries for the scheme.\n * @param scheme Scheme name (or `'common'`).\n * @param entries Normalized className → merged style object.\n */\nexport function registerMolecules(scheme: string, entries: Record<string, unknown>): void {\n  molecules[scheme] = { ...molecules[scheme], ...entries }\n  registryVersion += 1\n}\n\n/**\n * Register the gradient atom map (atom name → role + resolved colour).\n * @param map Atom name → gradient info.\n */\nexport function registerGradients(map: Record<string, GradientAtomInfo>): void {\n  gradients = map\n  registryVersion += 1\n}\n\n/**\n * Register the haptic atom map (atom name → request).\n * @param map Atom name → haptic request.\n */\nexport function registerHaptics(map: Record<string, HapticRequest>): void {\n  haptics = map\n  registryVersion += 1\n}\n\n\n\n/**\n * Per-state-object signature memo. `RnwindState` is created fresh (via the\n * provider's `useMemo`) whenever any field changes, so its identity is a\n * sound key — a new object means a new signature. Keyed weakly so states\n * GC with their provider.\n */\nconst stateSignatureCache = new WeakMap<RnwindState, string>()\n\n/**\n * Cache key dimension for the reactive context — everything that can\n * change a resolved style.\n * @param state Rnwind context.\n * @returns Compact signature string.\n */\nfunction stateSignature(state: RnwindState): string {\n  const { insets } = state\n  return `${state.scheme}|${insets.top},${insets.right},${insets.bottom},${insets.left}|${state.fontScale}|${state.windowWidth}`\n}\n\n/**\n * Memoised {@link stateSignature} — one `WeakMap.get` on the hot path\n * instead of rebuilding the template string every resolve.\n * @param state Rnwind context.\n * @returns Cached compact signature.\n */\nfunction stateSignatureCached(state: RnwindState): string {\n  let signature = stateSignatureCache.get(state)\n  if (signature === undefined) {\n    signature = stateSignature(state)\n    stateSignatureCache.set(state, signature)\n  }\n  return signature\n}\n\n/**\n * Compact signature of the live interactive state for the cache key.\n * @param interactState Active/focus flags, or undefined for the plain path.\n * @returns Two-bit signature (`''` when no interactive state).\n */\nfunction interactSignature(interactState?: InteractState): string {\n  if (!interactState) return ''\n  const active = interactState.active ? 1 : 0\n  const focus = interactState.focus ? 1 : 0\n  return `${active}${focus}`\n}\n\n/**\n * Whether a token is a feature-ONLY utility (gradient stop/direction,\n * haptic request, or text-truncate) that contributes NO RN `style`. These\n * are folded in via {@link attachFeatures}, so they must be kept OUT of\n * the `lookupCss` input — otherwise the atom resolver treats them as\n * unknown style atoms and emits a spurious \"unknown class\" dev warning\n * (e.g. for `active:haptic-rigid`).\n * @param token Atom name.\n * @returns True when the token carries no style.\n */\nfunction isFeatureOnlyToken(token: string): boolean {\n  return Boolean(gradients[token]) || Boolean(haptics[token]) || truncateForToken(token) !== null\n}\n\n/**\n * Lifecycle trigger for a haptic atom from its variant prefix.\n * @param token Atom name (maybe `active:`/`focus:`/`hover:` prefixed).\n * @returns The trigger.\n */\nfunction hapticTriggerForToken(token: string): HapticTrigger {\n  const colon = token.indexOf(':')\n  if (colon === -1) return 'mount'\n  const prefix = token.slice(0, colon)\n  if (prefix === 'active') return 'pressIn'\n  if (prefix === 'focus') return 'focus'\n  if (prefix === 'hover') return 'hover'\n  return 'mount'\n}\n\n/**\n * Syntactic text-truncate directive for one atom.\n * @param token Atom name.\n * @returns Partial truncate props, or null.\n */\nfunction truncateForToken(token: string): { numberOfLines?: number; ellipsizeMode?: 'tail' | 'clip' } | null {\n  if (token === 'truncate') return { numberOfLines: 1, ellipsizeMode: 'tail' }\n  if (token === 'text-ellipsis') return { ellipsizeMode: 'tail' }\n  if (token === 'text-clip') return { ellipsizeMode: 'clip' }\n  if (token === 'line-clamp-none') return { numberOfLines: 0 }\n  if (token.startsWith('line-clamp-')) {\n    const count = Number(token.slice('line-clamp-'.length))\n    if (Number.isInteger(count) && count >= 0) return { numberOfLines: count }\n  }\n  return null\n}\n\n/**\n * Assemble gradient props from gradient roles present in the atom list.\n * @param tokens Atom names.\n * @returns `{colors, start, end}` or null when not a complete gradient.\n */\nfunction assembleGradient(tokens: readonly string[]): { colors: string[]; start: GradientPoint; end: GradientPoint } | null {\n  let from: string | undefined\n  let via: string | undefined\n  let to: string | undefined\n  let dir: GradientDirection | undefined\n  for (const token of tokens) {\n    const info = gradients[token]\n    if (!info) continue\n    switch (info.role) {\n      case 'from': {\n        from = info.color\n        break\n      }\n      case 'via': {\n        via = info.color\n        break\n      }\n      case 'to': {\n        to = info.color\n        break\n      }\n      default: {\n        ;({ dir } = info)\n      }\n    }\n  }\n  if (dir === undefined) return null\n  const colors = [from, via, to].filter((color): color is string => color !== undefined)\n  if (colors.length < 2) return null\n  const points = DIRECTION_POINTS[dir]\n  return { colors, start: points.start, end: points.end }\n}\n\n/**\n * Fold every truncate directive across the atom list into one result —\n * last token wins per prop (matches Tailwind last-wins).\n * @param tokens Atom names.\n * @returns Merged truncate props (empty when none apply).\n */\nfunction collectTruncate(tokens: readonly string[]): { numberOfLines?: number; ellipsizeMode?: 'tail' | 'clip' } {\n  const out: { numberOfLines?: number; ellipsizeMode?: 'tail' | 'clip' } = {}\n  for (const token of tokens) {\n    const truncate = truncateForToken(token)\n    if (!truncate) continue\n    if (truncate.numberOfLines !== undefined) out.numberOfLines = truncate.numberOfLines\n    if (truncate.ellipsizeMode !== undefined) out.ellipsizeMode = truncate.ellipsizeMode\n  }\n  return out\n}\n\n/**\n * Collect every haptic request present in the atom list, tagged with the\n * lifecycle trigger its variant prefix implies.\n * @param tokens Atom names.\n * @returns Haptic request list, or undefined when none apply.\n */\nfunction collectHaptics(tokens: readonly string[]): { request: HapticRequest; trigger: HapticTrigger }[] | undefined {\n  let collected: { request: HapticRequest; trigger: HapticTrigger }[] | undefined\n  for (const token of tokens) {\n    const request = haptics[token]\n    if (!request) continue\n    collected ??= []\n    collected.push({ request, trigger: hapticTriggerForToken(token) })\n  }\n  return collected\n}\n\n/**\n * Scan tokens for the className-derived feature props (gradient,\n * truncate, haptics) and fold them onto the base result.\n * @param base Result carrying the resolved `style`.\n * @param tokens Atom names.\n * @returns The result with any feature props attached.\n */\nfunction attachFeatures(base: ResolvedCss, tokens: readonly string[]): ResolvedCss {\n  const { numberOfLines, ellipsizeMode } = collectTruncate(tokens)\n  const collected = collectHaptics(tokens)\n  const gradient = assembleGradient(tokens)\n  const result: Mutable<ResolvedCss> = { style: base.style }\n  if (gradient) {\n    result.colors = gradient.colors\n    result.start = gradient.start\n    result.end = gradient.end\n  }\n  // `numberOfLines: 0` is kept (RN reads it as \"unlimited\"): `line-clamp-none`\n  // must be able to explicitly reset an earlier `line-clamp-N` on the same\n  // element — dropping the 0 would silently leave the prior limit in place.\n  if (numberOfLines !== undefined) {\n    result.numberOfLines = numberOfLines\n    if (ellipsizeMode !== undefined) result.ellipsizeMode = ellipsizeMode\n  }\n  if (collected) result.haptics = collected\n  return result\n}\n\n/**\n * Compose a resolved style with a caller-supplied inline style (user wins).\n * @param style\n * @param userStyle\n */\nfunction withUserStyle(style: unknown, userStyle: unknown): unknown {\n  return Array.isArray(style) ? [...style, userStyle] : [style, userStyle]\n}\n\n/**\n * Resolve a className against the reactive context into a style plus any\n * className-derived props. Molecule-first (one lookup, by reference),\n * atom-fallback for unseen / context-dependent strings, cached per\n * `(className, state)`.\n * @param className Raw className string.\n * @param state Rnwind context from `useRnwind()`.\n * @param userStyle Optional inline style appended last (wins).\n * @param interactState Live active/focus flags (for `active:`/`focus:` atoms).\n * @returns The resolved style + feature props.\n */\nexport function resolve(\n  className: string | null | undefined,\n  state: RnwindState,\n  userStyle?: unknown,\n  interactState?: InteractState,\n): ResolvedCss {\n  const version = getStyleVersion() + registryVersion\n  if (version !== cachedFor) {\n    resolvedCache.clear()\n    cachedFor = version\n  }\n  if (className == null) {\n    return { style: userStyle === undefined || userStyle === null ? EMPTY : [userStyle] }\n  }\n  // Key on the RAW className so the hot (cache-hit) path skips normalize\n  // entirely — normalization only runs on a miss. The state signature is\n  // memoised per state object, so the hit path is one WeakMap.get + one\n  // string concat + one Map.get.\n  const key = `${className}@${stateSignatureCached(state)}@${interactSignature(interactState)}`\n  const cached = resolvedCache.get(key)\n  if (cached !== undefined) {\n    return userStyle === undefined || userStyle === null ? cached : { ...cached, style: withUserStyle(cached.style, userStyle) }\n  }\n  const normalized = normalizeClassName(className)\n  if (normalized.length === 0) {\n    const empty: ResolvedCss = { style: EMPTY }\n    resolvedCache.set(key, empty)\n    return userStyle === undefined || userStyle === null ? empty : { style: [userStyle] }\n  }\n  // Molecules are static pre-merges; anything carrying `active:`/`focus:`\n  // is never registered as one, so the atom path handles interactive state.\n  const tokens = normalized.split(' ')\n  const molecule = interactState ? undefined : molecules[state.scheme]?.[normalized] ?? molecules[COMMON_SCHEME]?.[normalized]\n  // Feature-only tokens (gradient / haptic / truncate) carry no style — keep\n  // them out of the atom lookup so they don't warn as \"unknown class\".\n  const style =\n    molecule === undefined ? lookupCss(tokens.filter((token) => !isFeatureOnlyToken(token)).join(' '), state, undefined, interactState) : molecule\n  const base = attachFeatures({ style }, tokens)\n  resolvedCache.set(key, base)\n  return userStyle === undefined || userStyle === null ? base : { ...base, style: withUserStyle(base.style, userStyle) }\n}\n\n/** Local mutable view for building the frozen-shaped result. */\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] }\n\n/** Test-only — clear the molecule / gradient / haptic registries + cache. */\nexport function __resetResolveState(): void {\n  molecules = Object.create(null)\n  gradients = Object.create(null)\n  haptics = Object.create(null)\n  resolvedCache.clear()\n  registryVersion += 1\n  cachedFor = -1\n}\n\nexport {normalizeClassName} from '../core/normalize-classname'"],"names":["getStyleVersion","normalizeClassName","lookupCss"],"mappings":"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"}

package/lib/cjs/runtime/resolve.d.ts

@@ -0,0 +1,61 @@
+import { type InteractState } from './lookup-css';
+import type { RnwindState } from './components/rnwind-provider';
+import type { GradientAtomInfo } from '../core/parser/gradient';
+import type { HapticRequest, HapticTrigger } from '../core/parser/haptics';
+/** A unit-square gradient endpoint. */
+interface GradientPoint {
+    readonly x: number;
+    readonly y: number;
+}
+/** Rich resolution: the RN `style` plus any className-derived props. */
+export interface ResolvedCss {
+    /** RN `style` value — a single molecule object (by ref) or an atom array. */
+    readonly style: unknown;
+    /** Gradient stop colours (when the className is a complete gradient). */
+    readonly colors?: readonly string[];
+    /** Gradient start point. */
+    readonly start?: GradientPoint;
+    /** Gradient end point. */
+    readonly end?: GradientPoint;
+    /** Text truncation line count. */
+    readonly numberOfLines?: number;
+    /** Text ellipsize mode. */
+    readonly ellipsizeMode?: 'tail' | 'clip';
+    /** Haptic requests present on the className, for the wrap to dispatch. */
+    readonly haptics?: readonly {
+        readonly request: HapticRequest;
+        readonly trigger: HapticTrigger;
+    }[];
+}
+/**
+ * Register one scheme's pre-merged molecules (atom-merged literal
+ * classNames). Merges onto any existing entries for the scheme.
+ * @param scheme Scheme name (or `'common'`).
+ * @param entries Normalized className → merged style object.
+ */
+export declare function registerMolecules(scheme: string, entries: Record<string, unknown>): void;
+/**
+ * Register the gradient atom map (atom name → role + resolved colour).
+ * @param map Atom name → gradient info.
+ */
+export declare function registerGradients(map: Record<string, GradientAtomInfo>): void;
+/**
+ * Register the haptic atom map (atom name → request).
+ * @param map Atom name → haptic request.
+ */
+export declare function registerHaptics(map: Record<string, HapticRequest>): void;
+/**
+ * Resolve a className against the reactive context into a style plus any
+ * className-derived props. Molecule-first (one lookup, by reference),
+ * atom-fallback for unseen / context-dependent strings, cached per
+ * `(className, state)`.
+ * @param className Raw className string.
+ * @param state Rnwind context from `useRnwind()`.
+ * @param userStyle Optional inline style appended last (wins).
+ * @param interactState Live active/focus flags (for `active:`/`focus:` atoms).
+ * @returns The resolved style + feature props.
+ */
+export declare function resolve(className: string | null | undefined, state: RnwindState, userStyle?: unknown, interactState?: InteractState): ResolvedCss;
+/** Test-only — clear the molecule / gradient / haptic registries + cache. */
+export declare function __resetResolveState(): void;
+export { normalizeClassName } from '../core/normalize-classname';

package/lib/cjs/runtime/wrap.cjs

@@ -0,0 +1,254 @@
+'use strict';
+
+var React = require('react');
+var chainHandlers = require('./chain-handlers.cjs');
+var useInteract = require('./hooks/use-interact.cjs');
+var rnwindProvider = require('./components/rnwind-provider.cjs');
+var resolve = require('./resolve.cjs');
+
+/** Matches a leading `active:` / `focus:` variant token (`\b` excludes `inactive:`). */
+const INTERACTIVE_VARIANT = /\b(?:active|focus):/;
+/** One-shot guard so the missing-`onHaptics` warning logs once per session. */
+let warnedMissingOnHaptics = false;
+/**
+ * Dev-only warning when a className carries a haptic utility but no
+ * `onHaptics` dispatcher is wired on the nearest `<RnwindProvider>` — the
+ * haptic would silently drop otherwise. Fires once per session.
+ * @param onHaptics The dispatcher from context (or undefined).
+ * @param haptics The resolved haptic requests (or undefined).
+ */
+function warnIfHapticsUnwired(onHaptics, haptics) {
+    if (onHaptics || !haptics || haptics.length === 0)
+        return;
+    const isDevelopment = typeof __DEV__ === 'undefined' || __DEV__;
+    if (!isDevelopment || warnedMissingOnHaptics)
+        return;
+    warnedMissingOnHaptics = true;
+    // eslint-disable-next-line no-console
+    console.warn('rnwind: a `haptic-*` utility resolved but no `onHaptics` callback is wired on <RnwindProvider>. ' +
+        'Pass `onHaptics` on the provider to forward the request to expo-haptics (or any library).');
+}
+/**
+ * Whether a className needs press/focus state tracking.
+ * @param className Raw className string.
+ * @returns True when an `active:` / `focus:` variant is present.
+ */
+function hasInteractiveVariant(className) {
+    return INTERACTIVE_VARIANT.test(className);
+}
+/**
+ * Best-effort display name for the wrapped component.
+ * @param component Component being wrapped.
+ * @returns Its `displayName`, `name`, or `'Component'`.
+ */
+function displayNameOf(component) {
+    const named = component;
+    return named.displayName ?? named.name ?? 'Component';
+}
+/**
+ * Fire the `mount`-trigger haptics once, after the element mounts. Snaps
+ * the resolved requests + dispatcher at mount via a `useRef` initializer
+ * (evaluated only on the first render), so an unstable inline `onHaptics`
+ * doesn't re-fire them and no ref is written during render.
+ * @param resolved The resolved className (carries any haptic requests).
+ * @param onHaptics The dispatcher from context (or undefined).
+ */
+function useMountHaptics(resolved, onHaptics) {
+    const mount = React.useRef({ resolved, onHaptics });
+    React.useEffect(() => {
+        const { resolved: current, onHaptics: dispatch } = mount.current;
+        if (!dispatch || !current.haptics)
+            return;
+        for (const entry of current.haptics)
+            if (entry.trigger === 'mount')
+                dispatch(entry.request, 'mount');
+    }, []);
+}
+/** Suffix marking a secondary class-prop (`contentContainerClassName`, …). */
+const CLASSNAME_SUFFIX = 'ClassName';
+/**
+ * Resolve every secondary `<prefix>ClassName` prop (e.g.
+ * `contentContainerClassName` on a ScrollView / FlatList) into its
+ * matching `<prefix>Style`, in place. Any existing `<prefix>Style` is
+ * appended last (caller wins). The original `*ClassName` prop is deleted
+ * so RN never sees an unknown attribute. The primary `className` is
+ * handled separately by the leaf and never reaches here.
+ * @param props Mutable prop object being assembled for the host.
+ * @param state Rnwind context for resolution.
+ */
+function applyContainerClassNames(props, state) {
+    for (const key of Object.keys(props)) {
+        if (!key.endsWith(CLASSNAME_SUFFIX))
+            continue;
+        const value = props[key];
+        if (typeof value !== 'string')
+            continue;
+        const styleKey = `${key.slice(0, -CLASSNAME_SUFFIX.length)}Style`;
+        props[styleKey] = resolve.resolve(value, state, props[styleKey]).style;
+        delete props[key];
+    }
+}
+/**
+ * Build the props for the wrapped host: resolved `style`, gradient
+ * (`colors`/`start`/`end`), truncate (`numberOfLines`/`ellipsizeMode`),
+ * secondary `<prefix>ClassName` → `<prefix>Style`, and a chained
+ * `onPressIn` that fires press-trigger haptics. Unknown props on a host
+ * are simply ignored by RN, so this stays generic.
+ * @param rest Forwarded props (incl. `ref`).
+ * @param resolved Resolved className result.
+ * @param state Rnwind context — used to resolve secondary class props.
+ * @param onHaptics Dispatcher from context.
+ * @param userOnPressIn Caller-supplied onPressIn to chain after the haptic.
+ * @returns The merged prop object for `createElement`.
+ */
+function buildProps(rest, resolved, state, onHaptics, userOnPressIn) {
+    warnIfHapticsUnwired(onHaptics, resolved.haptics);
+    const props = { ...rest, style: resolved.style };
+    applyContainerClassNames(props, state);
+    if (resolved.colors) {
+        props.colors = resolved.colors;
+        props.start = resolved.start;
+        props.end = resolved.end;
+    }
+    if (resolved.numberOfLines !== undefined) {
+        props.numberOfLines = resolved.numberOfLines;
+        if (resolved.ellipsizeMode !== undefined)
+            props.ellipsizeMode = resolved.ellipsizeMode;
+    }
+    const pressHaptics = onHaptics && resolved.haptics?.filter((entry) => entry.trigger === 'pressIn');
+    if (pressHaptics && pressHaptics.length > 0) {
+        const previous = userOnPressIn;
+        props.onPressIn = (event) => {
+            for (const entry of pressHaptics)
+                onHaptics(entry.request, 'pressIn');
+            previous?.(event);
+        };
+    }
+    else if (userOnPressIn !== undefined) {
+        props.onPressIn = userOnPressIn;
+    }
+    return props;
+}
+/**
+ * Non-interactive leaf: resolve className → style (+ features) and
+ * forward. One context read, one molecule/atom resolve.
+ * @param props Leaf props.
+ * @param props.as
+ * @param props.className
+ * @param props.style
+ * @param props.onPressIn
+ * @returns The rendered `as` element.
+ */
+function PlainLeaf({ as: As, className, style, onPressIn, ...rest }) {
+    const state = rnwindProvider.useRnwind();
+    const resolved = resolve.resolve(className, state, style);
+    useMountHaptics(resolved, state.onHaptics);
+    return React.createElement(As, buildProps(rest, resolved, state, state.onHaptics, onPressIn));
+}
+/**
+ * Interactive leaf: tracks press/focus via `useInteract()`, feeds it into
+ * `resolve` so `active:`/`focus:` atoms apply, and chains the
+ * press/focus handlers.
+ * @param props Leaf props.
+ * @param props.as
+ * @param props.className
+ * @param props.style
+ * @param props.onPressIn
+ * @param props.onPressOut
+ * @param props.onFocus
+ * @param props.onBlur
+ * @returns The rendered `as` element with interactive wiring.
+ */
+function InteractiveLeaf({ as: As, className, style, onPressIn, onPressOut, onFocus, onBlur, ...rest }) {
+    const state = rnwindProvider.useRnwind();
+    const interact = useInteract.useInteract();
+    const resolved = resolve.resolve(className, state, style, interact.state);
+    useMountHaptics(resolved, state.onHaptics);
+    const props = buildProps(rest, resolved, state, state.onHaptics, onPressIn);
+    props.onPressIn = chainHandlers.chainPress(props.onPressIn, interact.onPressIn);
+    props.onPressOut = chainHandlers.chainPress(onPressOut, interact.onPressOut);
+    props.onFocus = chainHandlers.chainFocus(onFocus, interact.onFocus);
+    props.onBlur = chainHandlers.chainFocus(onBlur, interact.onBlur);
+    return React.createElement(As, props);
+}
+/**
+ * Wrap a component so its `className` prop resolves to RN `style` (plus
+ * gradient / truncate props and haptic dispatch) at render — no matter
+ * how className arrived: written directly, spread through `{...rest}`, or
+ * forwarded down custom wrappers. The returned component is hook-free; it
+ * dispatches to a plain or interactive leaf so non-interactive elements
+ * never pay for press/focus state. `ref` (a normal prop in React 19) and
+ * all other props forward untouched.
+ * @example
+ * ```tsx
+ * const Pressable = wrap(RNPressable)
+ * <Pressable className="active:bg-sky-700 px-4 haptic-light" onPress={fn} />
+ * ```
+ * @param Component Any component accepting a `style` prop.
+ * @returns A component accepting `className`.
+ */
+function wrap(Component) {
+    const as = Component;
+    /**
+     * The wrapped component — hook-free dispatcher to a leaf.
+     * @param props Forwarded props with `className` intercepted.
+     * @param props.className
+     * @returns The rendered leaf.
+     */
+    function RnwindWrapped({ className, ...rest }) {
+        if (className !== undefined && hasInteractiveVariant(className)) {
+            return React.createElement(InteractiveLeaf, { as, className, ...rest });
+        }
+        return React.createElement(PlainLeaf, { as, className, ...rest });
+    }
+    RnwindWrapped.displayName = `wrap(${displayNameOf(Component)})`;
+    return RnwindWrapped;
+}
+/**
+ * Whether a namespace member name denotes a component to wrap —
+ * PascalCase and not a React context (`*Context`). Lowercase utilities /
+ * hooks (`createAnimatedComponent`, `spring`) pass through untouched.
+ * @param name Member key.
+ * @returns True when the member should be `wrap()`-ed.
+ */
+function isComponentMember(name) {
+    return /^[A-Z]/.test(name) && !name.endsWith('Context');
+}
+/**
+ * Wrap a component NAMESPACE (a default/namespace import like reanimated's
+ * `Animated`) so member access — `Animated.View`, `Animated.ScrollView` —
+ * returns a `wrap()`-ed component whose `className` resolves at render.
+ * Returns a Proxy: component members are wrapped lazily and memoised so
+ * each access yields the SAME wrapped component (stable identity — React
+ * would remount otherwise). Non-component members (`createAnimatedComponent`,
+ * config objects) pass straight through.
+ * @example
+ * ```tsx
+ * const Animated = wrapNamespace(RNReanimated)
+ * <Animated.View className="enter-fade" />
+ * ```
+ * @param namespace The imported namespace object.
+ * @returns A Proxy that wraps component members on access.
+ */
+function wrapNamespace(namespace) {
+    const cache = new Map();
+    return new Proxy(namespace, {
+        get(target, key, receiver) {
+            const value = Reflect.get(target, key, receiver);
+            if (typeof key !== 'string' || !isComponentMember(key))
+                return value;
+            if (!value || (typeof value !== 'function' && typeof value !== 'object'))
+                return value;
+            let wrapped = cache.get(key);
+            if (wrapped === undefined) {
+                wrapped = wrap(value);
+                cache.set(key, wrapped);
+            }
+            return wrapped;
+        },
+    });
+}
+
+exports.wrap = wrap;
+exports.wrapNamespace = wrapNamespace;
+//# sourceMappingURL=wrap.cjs.map

package/lib/cjs/runtime/wrap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.cjs","sources":["../../../../src/runtime/wrap.tsx"],"sourcesContent":["import { createElement, useEffect, useRef, type ComponentType, type ReactElement } from 'react'\nimport { chainFocus, chainPress } from './chain-handlers'\nimport { useInteract } from './hooks/use-interact'\nimport { useRnwind } from './components/rnwind-provider'\nimport type { RnwindState } from './components/rnwind-provider'\nimport { resolve, type ResolvedCss } from './resolve'\nimport type { OnHaptics } from '../core/parser/haptics'\n\n/** Matches a leading `active:` / `focus:` variant token (`\\b` excludes `inactive:`). */\nconst INTERACTIVE_VARIANT = /\\b(?:active|focus):/\n\n/** One-shot guard so the missing-`onHaptics` warning logs once per session. */\nlet warnedMissingOnHaptics = false\n\n/**\n * Dev-only warning when a className carries a haptic utility but no\n * `onHaptics` dispatcher is wired on the nearest `<RnwindProvider>` — the\n * haptic would silently drop otherwise. Fires once per session.\n * @param onHaptics The dispatcher from context (or undefined).\n * @param haptics The resolved haptic requests (or undefined).\n */\nfunction warnIfHapticsUnwired(onHaptics: OnHaptics | undefined, haptics: ResolvedCss['haptics']): void {\n  if (onHaptics || !haptics || haptics.length === 0) return\n  const isDevelopment = typeof __DEV__ === 'undefined' || __DEV__\n  if (!isDevelopment || warnedMissingOnHaptics) return\n  warnedMissingOnHaptics = true\n  // eslint-disable-next-line no-console\n  console.warn(\n    'rnwind: a `haptic-*` utility resolved but no `onHaptics` callback is wired on <RnwindProvider>. ' +\n      'Pass `onHaptics` on the provider to forward the request to expo-haptics (or any library).',\n  )\n}\n\n/**\n * Whether a className needs press/focus state tracking.\n * @param className Raw className string.\n * @returns True when an `active:` / `focus:` variant is present.\n */\nfunction hasInteractiveVariant(className: string): boolean {\n  return INTERACTIVE_VARIANT.test(className)\n}\n\n/**\n * Best-effort display name for the wrapped component.\n * @param component Component being wrapped.\n * @returns Its `displayName`, `name`, or `'Component'`.\n */\nfunction displayNameOf(component: unknown): string {\n  const named = component as { displayName?: string; name?: string }\n  return named.displayName ?? named.name ?? 'Component'\n}\n\n/**\n * Fire the `mount`-trigger haptics once, after the element mounts. Snaps\n * the resolved requests + dispatcher at mount via a `useRef` initializer\n * (evaluated only on the first render), so an unstable inline `onHaptics`\n * doesn't re-fire them and no ref is written during render.\n * @param resolved The resolved className (carries any haptic requests).\n * @param onHaptics The dispatcher from context (or undefined).\n */\nfunction useMountHaptics(resolved: ResolvedCss, onHaptics: OnHaptics | undefined): void {\n  const mount = useRef({ resolved, onHaptics })\n  useEffect(() => {\n    const { resolved: current, onHaptics: dispatch } = mount.current\n    if (!dispatch || !current.haptics) return\n    for (const entry of current.haptics) if (entry.trigger === 'mount') dispatch(entry.request, 'mount')\n  }, [])\n}\n\n/** Suffix marking a secondary class-prop (`contentContainerClassName`, …). */\nconst CLASSNAME_SUFFIX = 'ClassName'\n\n/**\n * Resolve every secondary `<prefix>ClassName` prop (e.g.\n * `contentContainerClassName` on a ScrollView / FlatList) into its\n * matching `<prefix>Style`, in place. Any existing `<prefix>Style` is\n * appended last (caller wins). The original `*ClassName` prop is deleted\n * so RN never sees an unknown attribute. The primary `className` is\n * handled separately by the leaf and never reaches here.\n * @param props Mutable prop object being assembled for the host.\n * @param state Rnwind context for resolution.\n */\nfunction applyContainerClassNames(props: Record<string, unknown>, state: RnwindState): void {\n  for (const key of Object.keys(props)) {\n    if (!key.endsWith(CLASSNAME_SUFFIX)) continue\n    const value = props[key]\n    if (typeof value !== 'string') continue\n    const styleKey = `${key.slice(0, -CLASSNAME_SUFFIX.length)}Style`\n    props[styleKey] = resolve(value, state, props[styleKey]).style\n    delete props[key]\n  }\n}\n\n/**\n * Build the props for the wrapped host: resolved `style`, gradient\n * (`colors`/`start`/`end`), truncate (`numberOfLines`/`ellipsizeMode`),\n * secondary `<prefix>ClassName` → `<prefix>Style`, and a chained\n * `onPressIn` that fires press-trigger haptics. Unknown props on a host\n * are simply ignored by RN, so this stays generic.\n * @param rest Forwarded props (incl. `ref`).\n * @param resolved Resolved className result.\n * @param state Rnwind context — used to resolve secondary class props.\n * @param onHaptics Dispatcher from context.\n * @param userOnPressIn Caller-supplied onPressIn to chain after the haptic.\n * @returns The merged prop object for `createElement`.\n */\nfunction buildProps(\n  rest: Record<string, unknown>,\n  resolved: ResolvedCss,\n  state: RnwindState,\n  onHaptics: OnHaptics | undefined,\n  userOnPressIn?: unknown,\n): Record<string, unknown> {\n  warnIfHapticsUnwired(onHaptics, resolved.haptics)\n  const props: Record<string, unknown> = { ...rest, style: resolved.style }\n  applyContainerClassNames(props, state)\n  if (resolved.colors) {\n    props.colors = resolved.colors\n    props.start = resolved.start\n    props.end = resolved.end\n  }\n  if (resolved.numberOfLines !== undefined) {\n    props.numberOfLines = resolved.numberOfLines\n    if (resolved.ellipsizeMode !== undefined) props.ellipsizeMode = resolved.ellipsizeMode\n  }\n  const pressHaptics = onHaptics && resolved.haptics?.filter((entry) => entry.trigger === 'pressIn')\n  if (pressHaptics && pressHaptics.length > 0) {\n    const previous = userOnPressIn as ((event: unknown) => void) | undefined\n    props.onPressIn = (event: unknown): void => {\n      for (const entry of pressHaptics) onHaptics(entry.request, 'pressIn')\n      previous?.(event)\n    }\n  } else if (userOnPressIn !== undefined) {\n    props.onPressIn = userOnPressIn\n  }\n  return props\n}\n\n/** Props a leaf receives — the wrapped `as` tag plus forwarded props. */\ninterface LeafProps {\n  readonly as: ComponentType<Record<string, unknown>>\n  readonly className?: string\n  readonly style?: unknown\n  readonly [key: string]: unknown\n}\n\n/**\n * Non-interactive leaf: resolve className → style (+ features) and\n * forward. One context read, one molecule/atom resolve.\n * @param props Leaf props.\n * @param props.as\n * @param props.className\n * @param props.style\n * @param props.onPressIn\n * @returns The rendered `as` element.\n */\nfunction PlainLeaf({ as: As, className, style, onPressIn, ...rest }: LeafProps): ReactElement {\n  const state = useRnwind()\n  const resolved = resolve(className, state, style)\n  useMountHaptics(resolved, state.onHaptics)\n  return createElement(As, buildProps(rest, resolved, state, state.onHaptics, onPressIn))\n}\n\n/**\n * Interactive leaf: tracks press/focus via `useInteract()`, feeds it into\n * `resolve` so `active:`/`focus:` atoms apply, and chains the\n * press/focus handlers.\n * @param props Leaf props.\n * @param props.as\n * @param props.className\n * @param props.style\n * @param props.onPressIn\n * @param props.onPressOut\n * @param props.onFocus\n * @param props.onBlur\n * @returns The rendered `as` element with interactive wiring.\n */\nfunction InteractiveLeaf({ as: As, className, style, onPressIn, onPressOut, onFocus, onBlur, ...rest }: LeafProps): ReactElement {\n  const state = useRnwind()\n  const interact = useInteract()\n  const resolved = resolve(className, state, style, interact.state)\n  useMountHaptics(resolved, state.onHaptics)\n  const props = buildProps(rest, resolved, state, state.onHaptics, onPressIn)\n  props.onPressIn = chainPress(props.onPressIn as Parameters<typeof chainPress>[0], interact.onPressIn)\n  props.onPressOut = chainPress(onPressOut as Parameters<typeof chainPress>[0], interact.onPressOut)\n  props.onFocus = chainFocus(onFocus as Parameters<typeof chainFocus>[0], interact.onFocus)\n  props.onBlur = chainFocus(onBlur as Parameters<typeof chainFocus>[0], interact.onBlur)\n  return createElement(As, props)\n}\n\n/**\n * Wrap a component so its `className` prop resolves to RN `style` (plus\n * gradient / truncate props and haptic dispatch) at render — no matter\n * how className arrived: written directly, spread through `{...rest}`, or\n * forwarded down custom wrappers. The returned component is hook-free; it\n * dispatches to a plain or interactive leaf so non-interactive elements\n * never pay for press/focus state. `ref` (a normal prop in React 19) and\n * all other props forward untouched.\n * @example\n * ```tsx\n * const Pressable = wrap(RNPressable)\n * <Pressable className=\"active:bg-sky-700 px-4 haptic-light\" onPress={fn} />\n * ```\n * @param Component Any component accepting a `style` prop.\n * @returns A component accepting `className`.\n */\nexport function wrap<P>(Component: ComponentType<P>): ComponentType<P & { className?: string }> {\n  const as = Component as unknown as ComponentType<Record<string, unknown>>\n  /**\n   * The wrapped component — hook-free dispatcher to a leaf.\n   * @param props Forwarded props with `className` intercepted.\n   * @param props.className\n   * @returns The rendered leaf.\n   */\n  function RnwindWrapped({ className, ...rest }: { className?: string; [key: string]: unknown }): ReactElement {\n    if (className !== undefined && hasInteractiveVariant(className)) {\n      return createElement(InteractiveLeaf, { as, className, ...rest })\n    }\n    return createElement(PlainLeaf, { as, className, ...rest })\n  }\n  RnwindWrapped.displayName = `wrap(${displayNameOf(Component)})`\n  return RnwindWrapped as unknown as ComponentType<P & { className?: string }>\n}\n\n/**\n * Whether a namespace member name denotes a component to wrap —\n * PascalCase and not a React context (`*Context`). Lowercase utilities /\n * hooks (`createAnimatedComponent`, `spring`) pass through untouched.\n * @param name Member key.\n * @returns True when the member should be `wrap()`-ed.\n */\nfunction isComponentMember(name: string): boolean {\n  return /^[A-Z]/.test(name) && !name.endsWith('Context')\n}\n\n/**\n * Wrap a component NAMESPACE (a default/namespace import like reanimated's\n * `Animated`) so member access — `Animated.View`, `Animated.ScrollView` —\n * returns a `wrap()`-ed component whose `className` resolves at render.\n * Returns a Proxy: component members are wrapped lazily and memoised so\n * each access yields the SAME wrapped component (stable identity — React\n * would remount otherwise). Non-component members (`createAnimatedComponent`,\n * config objects) pass straight through.\n * @example\n * ```tsx\n * const Animated = wrapNamespace(RNReanimated)\n * <Animated.View className=\"enter-fade\" />\n * ```\n * @param namespace The imported namespace object.\n * @returns A Proxy that wraps component members on access.\n */\nexport function wrapNamespace<T extends object>(namespace: T): T {\n  const cache = new Map<string, unknown>()\n  return new Proxy(namespace, {\n    get(target, key, receiver): unknown {\n      const value = Reflect.get(target, key, receiver)\n      if (typeof key !== 'string' || !isComponentMember(key)) return value\n      if (!value || (typeof value !== 'function' && typeof value !== 'object')) return value\n      let wrapped = cache.get(key)\n      if (wrapped === undefined) {\n        wrapped = wrap(value as ComponentType<unknown>)\n        cache.set(key, wrapped)\n      }\n      return wrapped\n    },\n  })\n}\n"],"names":["useRef","useEffect","resolve","useRnwind","createElement","useInteract","chainPress","chainFocus"],"mappings":"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"}

package/lib/cjs/runtime/wrap.d.ts

@@ -0,0 +1,37 @@
+import { type ComponentType } from 'react';
+/**
+ * Wrap a component so its `className` prop resolves to RN `style` (plus
+ * gradient / truncate props and haptic dispatch) at render — no matter
+ * how className arrived: written directly, spread through `{...rest}`, or
+ * forwarded down custom wrappers. The returned component is hook-free; it
+ * dispatches to a plain or interactive leaf so non-interactive elements
+ * never pay for press/focus state. `ref` (a normal prop in React 19) and
+ * all other props forward untouched.
+ * @example
+ * ```tsx
+ * const Pressable = wrap(RNPressable)
+ * <Pressable className="active:bg-sky-700 px-4 haptic-light" onPress={fn} />
+ * ```
+ * @param Component Any component accepting a `style` prop.
+ * @returns A component accepting `className`.
+ */
+export declare function wrap<P>(Component: ComponentType<P>): ComponentType<P & {
+    className?: string;
+}>;
+/**
+ * Wrap a component NAMESPACE (a default/namespace import like reanimated's
+ * `Animated`) so member access — `Animated.View`, `Animated.ScrollView` —
+ * returns a `wrap()`-ed component whose `className` resolves at render.
+ * Returns a Proxy: component members are wrapped lazily and memoised so
+ * each access yields the SAME wrapped component (stable identity — React
+ * would remount otherwise). Non-component members (`createAnimatedComponent`,
+ * config objects) pass straight through.
+ * @example
+ * ```tsx
+ * const Animated = wrapNamespace(RNReanimated)
+ * <Animated.View className="enter-fade" />
+ * ```
+ * @param namespace The imported namespace object.
+ * @returns A Proxy that wraps component members on access.
+ */
+export declare function wrapNamespace<T extends object>(namespace: T): T;

package/lib/cjs/testing/index.cjs

@@ -8,8 +8,9 @@ var node_os = require('node:os');
 var path = require('node:path');
 var React = require('react');
 var lookupCss = require('../runtime/lookup-css.cjs');
+var resolve = require('../runtime/resolve.cjs');
+var runtime_index = require('../runtime/index.cjs');
 var rnwindProvider = require('../runtime/components/rnwind-provider.cjs');
-var haptics = require('../runtime/haptics.cjs');
 var state = require('../metro/state.cjs');
 var metro_transformer = require('../metro/transformer.cjs');
 
@@ -50,26 +51,6 @@ const DEFAULT_THEME_CSS = `@import 'tailwindcss';
 `;
 /** `StyleSheet.create` stub the evaluated bundle calls — identity at test time. */
 const BUNDLE_STYLE_SHEET = { create: (styles) => styles, hairlineWidth: 1 };
-/** Stubbed interactive-state hook return matching `useInteract()`. */
-const NOOP_INTERACT = {
-    state: undefined,
-    onPressIn: () => undefined,
-    onPressOut: () => undefined,
-    onFocus: () => undefined,
-    onBlur: () => undefined,
-};
-/**
- * Identity chain helper matching `chainPress` / `chainFocus`. Returns a
- * single callback that invokes every supplied handler in turn.
- * @param handlers Handlers to chain.
- * @returns Combined callback.
- */
-const NOOP_CHAIN = (...handlers) => (...args) => {
-    for (const handler of handlers) {
-        if (typeof handler === 'function')
-            handler(...args);
-    }
-};
 // Synthesize a require rooted at the consumer's cwd so optional peer
 // lookups (`@testing-library/react-native`, `esbuild`) resolve from THEIR
 // node_modules, not rnwind's. A workspace-local rnwind install resolves
@@ -127,28 +108,87 @@ function compileToJs(source) {
     }
 }
 /**
- * Evaluate the union `style.js` the ledger wrote during the transform
- * so its `registerAtoms` call lands in the process-global registry.
- * Strips the `react-native` + `rnwind` imports from the source and
- * forwards local bindings into the evaluated closure.
- * @param cacheDir The rnwind cache dir where the ledger writes bundles.
+ * Evaluate one generated registry file (`common.style.js`,
+ * `<variant>.style.js`, or `schemes.js`) so its `registerAtoms` /
+ * `registerBreakpoints` / `registerGradients` / `registerHaptics` /
+ * `registerSchemeLoader` calls land in the process-global registries the
+ * runtime resolver reads. Imports (`'rnwind'`, `'react-native'`, relative
+ * `./common.style`), `require(...)` loaders, and `export {...}` are
+ * stripped — every scheme file is evaluated directly, so lazy loaders are
+ * inert.
+ * @param filePath Absolute path to the generated file.
  */
-function evaluateStyleBundle(cacheDir) {
-    const filePath = path.join(cacheDir, 'style.js');
+function evaluateGeneratedFile(filePath) {
     if (!node_fs.existsSync(filePath))
         return;
     const body = node_fs.readFileSync(filePath, 'utf8')
-        .replaceAll(/import \{ StyleSheet \} from 'react-native'\s*\n/g, '')
-        .replaceAll(/import \{[^}]+\} from 'rnwind'\s*\n/g, '');
-    // Bundle body is generated by rnwind itself — not user-controlled.
+        .replaceAll(/import\s+\{[^}]*\}\s+from\s+['"][^'"]+['"];?\s*\n?/g, '')
+        .replaceAll(/import\s+['"][^'"]+['"];?\s*\n?/g, '')
+        .replaceAll(/export\s+\{[^}]*\}\s*;?\s*\n?/g, '');
+    // Generated body is produced by rnwind itself — not user-controlled.
+    // `require` is neutralised: each variant file is evaluated directly,
+    // so the manifest's lazy `require('./x.style')` loaders are no-ops.
     // eslint-disable-next-line sonarjs/code-eval
-    new Function('StyleSheet', 'registerAtoms', body)(BUNDLE_STYLE_SHEET, lookupCss.registerAtoms);
+    new Function('StyleSheet', 'registerAtoms', 'registerMolecules', 'registerBreakpoints', 'registerGradients', 'registerHaptics', 'registerSchemeLoader', 'require', body)(BUNDLE_STYLE_SHEET, lookupCss.registerAtoms, resolve.registerMolecules, lookupCss.registerBreakpoints, resolve.registerGradients, resolve.registerHaptics, lookupCss.registerSchemeLoader, () => { });
+}
+/**
+ * Sort comparator that floats `common.style.js` to the front, rest alpha.
+ * @param a
+ * @param b
+ */
+function commonFirst(a, b) {
+    if (a === 'common.style.js')
+        return -1;
+    if (b === 'common.style.js')
+        return 1;
+    return a.localeCompare(b);
+}
+/**
+ * Evaluate every generated registry the transform wrote (`common` +
+ * every variant scheme + the manifest) so the runtime resolver sees the
+ * full atom / molecule / gradient / haptic registries — same state a
+ * production bundle would hold once all scheme files load.
+ * @param cacheDir The rnwind cache dir holding the generated files.
+ */
+function evaluateGeneratedRegistries(cacheDir) {
+    if (!node_fs.existsSync(cacheDir))
+        return;
+    const files = node_fs.readdirSync(cacheDir).filter((name) => name.endsWith('.style.js'));
+    // common first so variants layer their diffs on top of it.
+    for (const name of files.toSorted(commonFirst)) {
+        evaluateGeneratedFile(path.join(cacheDir, name));
+    }
+    evaluateGeneratedFile(path.join(cacheDir, 'schemes.js'));
+}
+/**
+ * Move every `const {…} = __rnwind;` / `const {…} = __reactNative;`
+ * binding line to the top of the source, preserving order, so they
+ * initialise before the transformer's `const View = _rnwWrap(_rnw0)`
+ * wrap declarations reference them. Mirrors ESM import hoisting.
+ * @param source Source with imports already converted to const-destructures.
+ * @returns Source with binding consts hoisted to the front.
+ */
+function hoistBindingConsts(source) {
+    const hoisted = [];
+    const rest = [];
+    for (const line of source.split('\n')) {
+        if (/=\s*__(?:rnwind|reactNative);\s*$/.test(line))
+            hoisted.push(line);
+        else
+            rest.push(line);
+    }
+    return [...hoisted, ...rest].join('\n');
 }
 /**
  * Evaluate the transformer's rewritten source as a standalone module:
- * strip synthetic imports, forward `import ... from 'rnwind'` +
- * `'react-native'` to local bindings, compile JSX via the compiler, and
- * capture the default export.
+ * strip synthetic generated imports, forward `import ... from 'rnwind'`
+ * (incl. the injected `wrap as _rnwWrap`) and `'react-native'` to local
+ * bindings, compile JSX via the compiler, and capture the default export.
+ * Aliased named imports (`{ View as _rnw0 }`) are converted to valid
+ * destructuring (`{ View: _rnw0 }`). The import-derived `const`s are then
+ * hoisted above the body: the transformer injects `const View =
+ * _rnwWrap(_rnw0)` ahead of the (real-ESM-hoisted) `import … as _rnw0`,
+ * so without re-hoisting the binding the eval would hit a TDZ on `_rnw0`.
  * @param transformedSource Post-transformer source.
  * @param reactNative `react-native` namespace bindings to forward.
  * @returns The default-exported component.
@@ -156,24 +196,14 @@ function evaluateStyleBundle(cacheDir) {
 function evaluateRewrittenModule(transformedSource, reactNative) {
     const prepared = transformedSource
         .replaceAll(/import\s+["']rnwind\/__generated\/[^"']+["'];?\s*\n?/g, '')
-        .replaceAll(/import\s+\{([^}]+)\}\s+from\s+["']rnwind["'];?/g, 'const {$1} = __rnwind;')
-        .replaceAll(/import\s+\{([^}]+)\}\s+from\s+["']react-native["'];?/g, 'const {$1} = __reactNative;')
+        .replaceAll(/import\s+\{([^}]+)\}\s+from\s+["']rnwind["'];?/g, (_m, spec) => `const {${spec.replaceAll(/\bas\b/g, ':')}} = __rnwind;`)
+        .replaceAll(/import\s+\{([^}]+)\}\s+from\s+["']react-native["'];?/g, (_m, spec) => `const {${spec.replaceAll(/\bas\b/g, ':')}} = __reactNative;`)
         .replace(/export\s+default\s+/, 'module.exports.default = ');
-    const compiled = compileToJs(prepared);
-    const rnwindEnv = {
-        lookupCss: lookupCss.lookupCss,
-        useRnwind: rnwindProvider.useRnwind,
-        useR_: rnwindProvider.useR_,
-        useMountHaptic: haptics.useMountHaptic,
-        triggerHaptic: haptics.triggerHaptic,
-        useInteract: () => NOOP_INTERACT,
-        chainPress: NOOP_CHAIN,
-        chainFocus: NOOP_CHAIN,
-    };
+    const compiled = compileToJs(hoistBindingConsts(prepared));
     const moduleObject = { exports: {} };
     // Compiled source originates from rnwind's own transformer + the JSX compiler.
     // eslint-disable-next-line sonarjs/code-eval
-    new Function('React', '__rnwind', '__reactNative', 'module', compiled)(React__namespace, rnwindEnv, reactNative, moduleObject);
+    new Function('React', '__rnwind', '__reactNative', 'module', compiled)(React__namespace, runtime_index, reactNative, moduleObject);
     if (!moduleObject.exports.default) {
         throw new Error('rnwind/testing: evaluated module did not export a default component.');
     }
@@ -249,10 +279,11 @@ async function bootstrapRnwindRuntime(options) {
         const ast = parser.parse(options.source, { sourceType: 'module', plugins: ['typescript', 'jsx'] });
         const result = await metro_transformer.transform({ filename, src: options.source, options: { projectRoot }, ast });
         transformedSource = generate(result.ast).code;
-        evaluateStyleBundle(cacheDir);
+        evaluateGeneratedRegistries(cacheDir);
     }
     const cleanup = () => {
         lookupCss.__resetLookupCssState();
+        resolve.__resetResolveState();
         state.resetRnwindState();
         if (node_fs.existsSync(projectRoot))
             node_fs.rmSync(projectRoot, { recursive: true, force: true });