rnwind 0.0.1 → 0.0.2

package/src/runtime/chain-handlers.ts

@@ -0,0 +1,47 @@
+/**
+ * Tiny helpers that compose rnwind's press / focus handlers with any
+ * user-provided ones the JSX site already has. The transformer uses
+ * these when it rewrites a `<Pressable onPressIn={user}>` into
+ * `<Pressable onPressIn={chainPress(user, _i.onPressIn)}>` so the user's
+ * callback keeps firing.
+ *
+ * Both helpers bail out when the user's handler is `null` / `undefined`,
+ * returning rnwind's handler directly — that gives the transformer a
+ * cheap uniform rewrite ("always chain") without allocating a new
+ * function per render when the user didn't opt in to the handler.
+ */
+import type { GestureResponderEvent, NativeSyntheticEvent, TargetedEvent } from 'react-native'
+
+type PressHandler = (event: GestureResponderEvent) => void
+type FocusHandler = (event: NativeSyntheticEvent<TargetedEvent>) => void
+
+/**
+ * Compose a user-supplied press handler with rnwind's internal one.
+ * User fires first (its return / side-effects happen pre-gate flip); the
+ * rnwind handler then updates the active flag.
+ * @param user User-supplied handler from the original JSX (optional).
+ * @param ours rnwind's internal active-toggling handler.
+ * @returns Combined handler, or `ours` directly when the user didn't provide one.
+ */
+export function chainPress(user: PressHandler | null | undefined, ours: PressHandler): PressHandler {
+  if (user == null) return ours
+  return (event: GestureResponderEvent): void => {
+    user(event)
+    ours(event)
+  }
+}
+
+/**
+ * Compose a user-supplied focus/blur handler with rnwind's internal one.
+ * Same ordering rule as {@link chainPress}: user first, rnwind second.
+ * @param user User-supplied handler (optional).
+ * @param ours rnwind's internal focus-toggling handler.
+ * @returns Combined handler, or `ours` directly when the user didn't provide one.
+ */
+export function chainFocus(user: FocusHandler | null | undefined, ours: FocusHandler): FocusHandler {
+  if (user == null) return ours
+  return (event: NativeSyntheticEvent<TargetedEvent>): void => {
+    user(event)
+    ours(event)
+  }
+}

package/src/runtime/components/rnwind-provider.tsx

@@ -0,0 +1,144 @@
+import { createContext, useContext, useMemo, type ReactNode } from 'react'
+import { useWindowDimensions } from 'react-native'
+import type { ThemeTables } from '../../core/types'
+import type { Scheme } from '../types'
+import type { OnHaptics } from '../../core/parser/haptics'
+import { activeBreakpointFor, BASE_BREAKPOINT, loadScheme } from '../lookup-css'
+
+/**
+ * Per-render safe-area insets snapshot. Bridge from any source
+ * (`useSafeAreaInsets()`, expo-router insets, a manually computed
+ * value) into the {@link RnwindProvider} — rnwind stays
+ * library-agnostic.
+ */
+export type Insets = Readonly<{
+  top: number
+  right: number
+  bottom: number
+  left: number
+}>
+
+/**
+ * Single value carried by the rnwind context. Every piece of runtime
+ * state rnwind needs — scheme, theme tables, insets, font scale,
+ * window width, active responsive breakpoint, optional haptic
+ * dispatcher — lives on this one bag. Consumers read it via
+ * {@link useRnwind} and either destructure or forward straight to
+ * `lookupCss` / `useCss`.
+ *
+ * `activeBreakpoint` is the highest-threshold registered breakpoint
+ * whose min-width is `<= windowWidth`, or `'base'` when below the
+ * smallest one (mobile-first tier) or when no breakpoints are
+ * registered yet (tests, bundles without rnwind-transformed sources).
+ * Always a string — never null. Reactive: it updates with
+ * `useWindowDimensions().width`, so consumers can branch on it
+ * without a separate hook.
+ */
+export type RnwindState = Readonly<{
+  scheme: Scheme
+  tables: ThemeTables
+  insets: Insets
+  onHaptics: OnHaptics | undefined
+  fontScale: number
+  windowWidth: number
+  activeBreakpoint: string
+}>
+
+/** Props accepted by {@link RnwindProvider}. */
+export type RnwindProviderProps = Readonly<{
+  scheme: Scheme
+  tables?: ThemeTables
+  insets?: Partial<Insets>
+  onHaptics?: OnHaptics
+  children?: ReactNode
+}>
+
+const EMPTY_TABLES: ThemeTables = {}
+const ZERO_INSETS: Insets = { top: 0, right: 0, bottom: 0, left: 0 }
+const DEFAULT_STATE: RnwindState = {
+  scheme: 'light' as Scheme,
+  tables: EMPTY_TABLES,
+  insets: ZERO_INSETS,
+  onHaptics: undefined,
+  fontScale: 1,
+  windowWidth: 0,
+  activeBreakpoint: BASE_BREAKPOINT,
+}
+
+/**
+ * Normalise a `Partial<Insets>` into a complete {@link Insets}, returning
+ * the shared {@link ZERO_INSETS} reference when nothing is supplied so
+ * downstream memoisation stays stable.
+ * @param partial Caller-supplied insets (or undefined).
+ * @returns Complete insets record.
+ */
+function normaliseInsets(partial: Partial<Insets> | undefined): Insets {
+  if (!partial) return ZERO_INSETS
+  const top = partial.top ?? 0
+  const right = partial.right ?? 0
+  const bottom = partial.bottom ?? 0
+  const left = partial.left ?? 0
+  if (top === 0 && right === 0 && bottom === 0 && left === 0) return ZERO_INSETS
+  return { top, right, bottom, left }
+}
+
+/** Single internal context the runtime reads from. */
+const RnwindContext = createContext<RnwindState>(DEFAULT_STATE)
+
+/**
+ * Read rnwind's full runtime state — scheme, theme tables, insets,
+ * fontScale, windowWidth, onHaptics — in one go. Pass the returned
+ * value straight to `lookupCss` / `useCss`, or destructure what you
+ * need.
+ * @returns Active rnwind state under the nearest {@link RnwindProvider}.
+ */
+export function useRnwind(): RnwindState {
+  return useContext(RnwindContext)
+}
+
+/**
+ * Internal context hook the babel transformer injects at the top of
+ * every rewritten component as `const _t = useR_()`. Same body as the
+ * public {@link useRnwind} — exposed under a `use*`-prefixed name so
+ * react-refresh's babel plugin (which only tracks call-sites whose
+ * identifier matches `^use[A-Z]`) folds it into each component's
+ * fast-refresh signature. Without that prefix the signature stayed
+ * stable across transformer changes; HMR then preserved fiber state
+ * while the rendered hook list shifted, surfacing as "change in the
+ * order of Hooks" runtime errors. Trailing underscore keeps it
+ * visually distinct from the user-facing `useRnwind`.
+ * @returns Active rnwind state.
+ */
+export function useR_(): RnwindState {
+  return useContext(RnwindContext)
+}
+
+/**
+ * Provider for rnwind's full runtime state. fontScale + windowWidth
+ * come from `useWindowDimensions()` so they react to OS-level
+ * orientation / accessibility-text-size changes automatically.
+ * @param props Provider props.
+ * @param props.scheme Active scheme name.
+ * @param props.tables Optional pre-resolved token tables.
+ * @param props.insets Optional safe-area insets.
+ * @param props.onHaptics Optional haptic dispatcher.
+ * @param props.children React subtree.
+ * @returns Provider element.
+ */
+export function RnwindProvider({ scheme, tables, insets, onHaptics, children }: RnwindProviderProps): ReactNode {
+  const normalized = normaliseInsets(insets)
+  const { fontScale, width } = useWindowDimensions()
+  const value = useMemo<RnwindState>(() => {
+    loadScheme(scheme)
+    return {
+      scheme,
+      tables: tables ?? EMPTY_TABLES,
+      insets: normalized,
+      onHaptics,
+      fontScale,
+      windowWidth: width,
+      activeBreakpoint: activeBreakpointFor(width),
+    }
+  }, [scheme, tables, normalized, onHaptics, fontScale, width])
+  return <RnwindContext.Provider value={value}>{children}</RnwindContext.Provider>
+}

package/src/runtime/gradient-types.ts

@@ -0,0 +1,60 @@
+/**
+ * Typed contract for the component rnwind's transformer calls with a
+ * gradient-class `className`. Matches `expo-linear-gradient` verbatim
+ * so users can plug any gradient library that mirrors that API.
+ *
+ * A typical wiring:
+ *
+ * ```tsx
+ * import { LinearGradient } from 'expo-linear-gradient'
+ * import type { AsLinearGradientProps } from 'rnwind'
+ *
+ * // Assert at the type level — CI catches mismatches before runtime.
+ * const _typeCheck: AsLinearGradientProps = {} as Parameters<typeof LinearGradient>[0]
+ *
+ * // Then use it in real JSX. rnwind fills in colors / start / end.
+ * <LinearGradient className="bg-gradient-to-r from-red-500 to-blue-500" />
+ * ```
+ *
+ * The rnwind transformer emits `colors` as a frozen `readonly string[]`,
+ * and `start` / `end` as frozen `{x: number, y: number}` records.
+ * Users pass the component; rnwind fills the props. Unused props
+ * (`locations`, `dither`, …) are forwarded verbatim from the JSX site.
+ */
+
+/** A unit-square point. Matches the `LinearGradientPoint` object form. */
+export interface LinearGradientPoint {
+  /** Horizontal component, 0..1. */
+  readonly x: number
+  /** Vertical component, 0..1. */
+  readonly y: number
+}
+
+/**
+ * The exact prop shape rnwind fills onto a gradient component at
+ * build time. A user-supplied `<LinearGradient>` (or any other
+ * component) must accept these props — no wrapper, no adapter.
+ */
+export interface AsLinearGradientProps {
+  /**
+   * Gradient colour stops in source order. rnwind emits a frozen
+   * `readonly string[]` with 2+ entries (at least `from` + `to`).
+   * Compatible with expo-linear-gradient's `colors: readonly [ColorValue, ColorValue, ...ColorValue[]]`.
+   */
+  readonly colors: readonly string[]
+  /**
+   * Start point, in the unit square (0,0)=top-left → (1,1)=bottom-right.
+   * rnwind emits a frozen `{x, y}` record matching the Tailwind
+   * direction utility (`to-r` → `{x: 0, y: 0.5}`).
+   */
+  readonly start: LinearGradientPoint
+  /** End point — same unit-square coordinates as `start`. */
+  readonly end: LinearGradientPoint
+  /**
+   * Optional colour-stop positions matching `colors` length. rnwind
+   * doesn't emit this today (Tailwind v4's stop-position atoms aren't
+   * wired yet); listed here so the prop surface still matches
+   * expo-linear-gradient when a consumer passes their own.
+   */
+  readonly locations?: readonly number[] | null
+}

package/src/runtime/haptics.ts

@@ -0,0 +1,120 @@
+/**
+ * Runtime helpers the transformer injects for haptic utilities.
+ *
+ * Two entry points:
+ *
+ *   useMountHaptic(requests) — fires each request on mount via
+ *     `useEffect(() => { ... }, [])`. Used by the transformer for bare
+ *     `haptic-*` atoms (no variant prefix).
+ *
+ *   triggerHaptic(onHaptics, request, trigger) — thin forwarding
+ *     helper for event-driven variants (`active:haptic-*`, `focus:...`,
+ *     `hover:...`). The transformer emits an inline arrow that calls
+ *     this from `onPressIn` / `onFocus` / etc.
+ *
+ * Both emit a one-shot dev-mode warning when `onHaptics` is missing —
+ * so developers get a clear "you forgot to wire <SchemeProvider
+ * onHaptics=...>" signal instead of silently dropping the haptic.
+ */
+
+import { useEffect } from 'react'
+import type { HapticRequest, HapticTrigger, OnHaptics } from '../core/parser/haptics'
+import { useRnwind } from './components/rnwind-provider'
+
+/**
+ * Module-scope set tracking haptic trigger strings we've already
+ * warned about. Prevents the "missing onHaptics" warning from
+ * spamming the console when the same class appears on many elements.
+ */
+const WARNED_MISSING_HAPTICS = new Set<string>()
+
+/**
+ * Render a `HapticRequest` as a short descriptive tag for log lines.
+ * @param request Haptic request.
+ * @returns `impact/Light`, `notification/Success`, or `selection`.
+ */
+function hapticTag(request: HapticRequest): string {
+  if (request.kind === 'impact') return `impact/${request.style}`
+  if (request.kind === 'notification') return `notification/${request.type}`
+  return 'selection'
+}
+
+/**
+ * Warn once per haptic trigger kind when a `haptic-*` atom tries to
+ * dispatch without an `onHaptics` provider. Dev-mode only — `__DEV__`
+ * is a Metro / Expo / RN global that compiles to `false` in release
+ * bundles, so no warn code ships to production.
+ * @param request The haptic request that had no provider.
+ * @param trigger The lifecycle trigger that tried to fire.
+ */
+function warnMissingOnHaptics(request: HapticRequest, trigger: HapticTrigger): void {
+  // `__DEV__` is a RN / Metro global — `false` in release, strips the
+  // branch entirely. Guarded in case we're evaluated outside of Metro
+  // (tests, node scripts) where the global isn't defined.
+  const isDevelopment = typeof __DEV__ === 'undefined' || __DEV__
+  if (!isDevelopment) return
+  const tag = hapticTag(request)
+  const key = `${tag}@${trigger}`
+  if (WARNED_MISSING_HAPTICS.has(key)) return
+  WARNED_MISSING_HAPTICS.add(key)
+  // eslint-disable-next-line no-console
+  console.warn(
+    `rnwind: a haptic utility fired (${tag}, trigger=${trigger}) but no onHaptics callback is wired on <SchemeProvider>. ` +
+      `Pass \`onHaptics\` on the provider to forward this to expo-haptics (or any library of your choice).`,
+  )
+}
+
+/**
+ * Test-only hook — clears the warned-haptics set so successive test
+ * runs don't silently swallow their own warnings.
+ */
+function __resetHapticWarnings(): void {
+  WARNED_MISSING_HAPTICS.clear()
+}
+
+/**
+ * Invoke every request in `requests` on mount (once per component
+ * mount), using the `onHaptics` dispatcher from the nearest
+ * `<SchemeProvider>`. Missing-provider dev warnings fire via
+ * {@link warnMissingOnHaptics}.
+ *
+ * Uses `useEffect(..., [])` — the requests array is identity-stable
+ * (hoisted at module scope by the transformer), so re-firing on
+ * re-renders isn't a concern.
+ * @param requests Hoisted request list for this component.
+ */
+function useMountHaptic(requests: readonly HapticRequest[]): void {
+  const { onHaptics } = useRnwind()
+   
+  useEffect(() => {
+    for (const request of requests) {
+      if (onHaptics) onHaptics(request, 'mount')
+      else warnMissingOnHaptics(request, 'mount')
+    }
+    // requests is a hoisted stable reference — depending on onHaptics
+    // identity keeps the effect fresh if the provider remounts with a
+    // different dispatcher, while the hoisted const prevents a remount
+    // from an inline `onHaptics={(r) => ...}`.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [onHaptics])
+}
+
+/**
+ * Fire one haptic request through the provider dispatcher. Emits the
+ * missing-provider dev warning when no dispatcher is wired. Designed
+ * for the inline arrows the transformer synthesises:
+ *
+ *   onPressIn={(e) => { triggerHaptic(_h, _HR_xxx, 'pressIn'); user?.(e) }}
+ * @param onHaptics Provider dispatcher (may be undefined).
+ * @param request Pre-hoisted request object.
+ * @param trigger Lifecycle trigger.
+ */
+function triggerHaptic(onHaptics: OnHaptics | undefined, request: HapticRequest, trigger: HapticTrigger): void {
+  if (onHaptics) {
+    onHaptics(request, trigger)
+    return
+  }
+  warnMissingOnHaptics(request, trigger)
+}
+
+export { useMountHaptic, triggerHaptic, __resetHapticWarnings }

package/src/runtime/hooks/use-css.ts

@@ -0,0 +1,16 @@
+import { useRnwind } from '../components/rnwind-provider'
+import { lookupCss } from '../lookup-css'
+
+/**
+ * Convenience hook: `useRnwind()` + `lookupCss()` rolled into one. Use
+ * inside any component that wants the resolved style array without
+ * threading the rnwind context manually. JSX-heavy components should
+ * still call `useRnwind()` once and pass it to `lookupCss(...)` per
+ * element so React only does a single context read per render.
+ * @param className Raw className string or transformer-hoisted atom-name array.
+ * @param userStyle Optional caller-supplied style appended last.
+ * @returns Frozen style array for React Native's `style` prop.
+ */
+export function useCss(className?: string | readonly string[] | null, userStyle?: unknown): readonly unknown[] {
+  return lookupCss(className, useRnwind(), userStyle)
+}

package/src/runtime/hooks/use-interact.ts

@@ -0,0 +1,65 @@
+import { useCallback, useMemo, useState } from 'react'
+import type { GestureResponderEvent, NativeSyntheticEvent, TargetedEvent } from 'react-native'
+import type { InteractState } from '../lookup-css'
+
+/**
+ * Idle state reference reused across every non-interactive render —
+ * when neither `active` nor `focus` is true, every call site returns
+ * the exact same object. That's the ~99 % path for a typical list row,
+ * so sharing the ref is a legitimate allocation elimination.
+ */
+const IDLE_STATE: InteractState = { active: false, focus: false }
+
+/**
+ * Live interact-state snapshot plus the press/focus handlers the
+ * transformer wires onto the JSX opening element. The state object is
+ * referentially stable across renders when the underlying `active` /
+ * `focus` flags don't change, which keeps `lookupCss` cache hits
+ * aligned with React's render cadence (same state ref → same
+ * resolved-array cache key → same reference back, no React diff
+ * triggered).
+ */
+export interface UseInteractResult {
+  /** Current interact flags — forwarded as the 4th arg to `lookupCss`. */
+  state: InteractState
+  /** Wired by the transformer onto `<Pressable onPressIn={…}>` etc. */
+  onPressIn: (event: GestureResponderEvent) => void
+  /** Wired by the transformer onto `<Pressable onPressOut={…}>` etc. */
+  onPressOut: (event: GestureResponderEvent) => void
+  /** Wired by the transformer onto `<TextInput onFocus={…}>` etc. */
+  onFocus: (event: NativeSyntheticEvent<TargetedEvent>) => void
+  /** Wired by the transformer onto `<TextInput onBlur={…}>` etc. */
+  onBlur: (event: NativeSyntheticEvent<TargetedEvent>) => void
+}
+
+/**
+ * React hook driving `active:` / `focus:` variants at runtime. The
+ * transformer injects exactly one call per JSX element that uses an
+ * interactive classname, caching the hook's result into a component-
+ * local `_i` binding so every `lookupCss(…, _i.state)` site shares the
+ * same snapshot per render.
+ *
+ * React Native's `Pressable` fires `onPressIn` / `onPressOut` on touch
+ * down / release — the touch-device analogue of CSS `:active`. Text
+ * fields use `onFocus` / `onBlur`. Both pairs drive `useState` Booleans;
+ * unused handlers on elements that don't emit the corresponding event
+ * are harmless no-ops.
+ *
+ * Result stability: both `state` and the returned wrapper object stay
+ * reference-equal across renders unless `active` / `focus` actually
+ * flip. Downstream `React.memo` + `lookupCss` caches hit on equal refs.
+ * @returns Stable state + handler bundle.
+ */
+export function useInteract(): UseInteractResult {
+  const [active, setActive] = useState(false)
+  const [focus, setFocus] = useState(false)
+  const onPressIn = useCallback(() => setActive(true), [])
+  const onPressOut = useCallback(() => setActive(false), [])
+  const onFocus = useCallback(() => setFocus(true), [])
+  const onBlur = useCallback(() => setFocus(false), [])
+  const state = useMemo<InteractState>(() => {
+    if (!active && !focus) return IDLE_STATE
+    return { active, focus }
+  }, [active, focus])
+  return useMemo(() => ({ state, onPressIn, onPressOut, onFocus, onBlur }), [state, onPressIn, onPressOut, onFocus, onBlur])
+}

package/src/runtime/hooks/use-scheme.ts

@@ -0,0 +1,63 @@
+import type { ThemeTable } from '../../core/types'
+import { useRnwind } from '../components/rnwind-provider'
+
+/**
+ * Synthetic scheme name applied when tokens aren't declared under any
+ * `@variant` block — the "no active variant" fallback every theme table
+ * inherits from.
+ */
+const BASE_SCHEME = 'base'
+
+/**
+ * Access the resolved theme table for the active scheme.
+ *
+ * Tokens declared outside any `@variant` block live in the `base` table and
+ * should apply everywhere — just like the CSS cascade treats `:root` as a
+ * default for every ancestor-scoped override. We merge `base` under the
+ * active scheme so a scheme that doesn't declare a token still sees the
+ * base default, while the scheme's own entries win on overlap.
+ * @returns Token table for the active scheme.
+ */
+export function useTheme(): ThemeTable {
+  const { scheme, tables } = useRnwind()
+  const base = tables[BASE_SCHEME] ?? {}
+  const schemeTable = tables[scheme]
+  if (!schemeTable) return base
+  // Fast path: nothing to merge when the scheme table is empty.
+  if (Object.keys(schemeTable).length === 0) return base
+  return { ...base, ...schemeTable }
+}
+
+/**
+ * Read a raw CSS custom property's value for the active scheme. Accepts
+ * either `--foo` or the bare `foo` form for convenience.
+ * @param cssVariable CSS custom property name (with or without the leading `--`).
+ * @returns The resolved value, or undefined when the token is missing.
+ */
+export function useToken(cssVariable: string): string | number | undefined {
+  const table = useTheme()
+  const name = cssVariable.startsWith('--') ? cssVariable : `--${cssVariable}`
+  return table[name]
+}
+
+/**
+ * Read a color token by shorthand name — `useColor('primary')` resolves
+ * `--color-primary` for the active scheme.
+ * @param name Token suffix after `--color-`.
+ * @returns Resolved color string, or undefined when the token is missing
+ *   or its value isn't a string.
+ */
+export function useColor(name: string): string | undefined {
+  const value = useToken(`--color-${name}`)
+  return typeof value === 'string' ? value : undefined
+}
+
+/**
+ * Read a spacing token by shorthand name — `useSize('4')` resolves
+ * `--spacing-4` for the active scheme.
+ * @param name Token suffix after `--spacing-`.
+ * @returns Resolved spacing value, or undefined when the token is missing.
+ */
+export function useSize(name: string): number | string | undefined {
+  return useToken(`--spacing-${name}`)
+}

package/src/runtime/index.ts

@@ -0,0 +1,54 @@
+
+
+
+
+export {
+  lookupCss,
+  registerAtoms,
+  registerBreakpoints,
+  registerSchemeLoader,
+  setWindowHeightProvider,
+  getBreakpoints,
+  activeBreakpointFor,
+  lookupCss as _l,
+} from './lookup-css'
+export { useR_ } from './components/rnwind-provider'
+export type { HoistedClassName, InteractState, LookupInsets, SafeMarkerSpec } from './lookup-css'
+export { useCss } from './hooks/use-css'
+export { useInteract } from './hooks/use-interact'
+export type { UseInteractResult } from './hooks/use-interact'
+export { chainPress, chainFocus } from './chain-handlers'
+export { InteractiveBox, InteractiveBox as _ib } from './interactive-box'
+export type { InteractiveBoxProps, InteractiveSpec } from './interactive-box'
+export { RnwindProvider, useRnwind } from './components/rnwind-provider'
+export type { RnwindProviderProps, RnwindState, Insets } from './components/rnwind-provider'
+export { useMountHaptic, triggerHaptic, triggerHaptic as _ht, useMountHaptic as _hm } from './haptics'
+
+// ──────────────────────────────────────────────────────────────────────
+// Internal aliases the babel transformer uses. Underscore-prefixed so
+// user code (which imports the public names above) can never collide
+// with what we inject at JSX sites — even if the user shadows
+// `lookupCss` / `useHaptics` / `InteractiveBox` with a local symbol,
+// the transformer's emitted code still references the private alias.
+// Don't import these in app code.
+// ──────────────────────────────────────────────────────────────────────
+/** @internal */
+
+/** @internal */
+
+/** @internal */
+
+/** @internal */
+
+export type { HapticRequest, HapticTrigger, OnHaptics } from '../core/parser/haptics'
+export type { AsLinearGradientProps, LinearGradientPoint } from './gradient-types'
+export type { ThemeTable, ThemeTables } from '../core/types'
+export { useTheme, useToken, useColor, useSize } from './hooks/use-scheme'
+export type { Scheme, RnwindConfig } from './types'
+
+/**
+ * Installed rnwind version, inlined at publish time. Compare against a pinned
+ * string when integrating with build tooling that may see multiple rnwind
+ * copies (e.g. workspace overrides).
+ */
+export const VERSION = '0.0.1' as const

package/src/runtime/interactive-box.tsx

@@ -0,0 +1,57 @@
+import { createElement, type ComponentType, type ElementType, type ReactElement } from 'react'
+import { chainFocus, chainPress } from './chain-handlers'
+import { useInteract } from './hooks/use-interact'
+import { lookupCss, type HoistedClassName } from './lookup-css'
+import type { RnwindState } from './components/rnwind-provider'
+
+/**
+ * Per-element "interactive" spec the transformer packs into the `_rw`
+ * prop on every JSX site it rewrites for active/focus support. Carrying
+ * it as one object prop (rather than four sibling props) keeps the
+ * rewritten JSX legible and avoids colliding with any host component's
+ * own naming.
+ */
+export interface InteractiveSpec {
+  /** The original JSX tag (`Pressable`, `TextInput`, `Animated.View`, …). */
+  readonly as: ElementType
+  /** Hoisted atom-name array (or a dynamic classname string). */
+  readonly cn: HoistedClassName | string | null | undefined
+  /** Full rnwind context — `_t = useRnwind___()` from the call site. */
+  readonly t: RnwindState
+  /** Optional caller-supplied style forwarded as `lookupCss`'s 3rd arg. */
+  readonly us?: unknown
+}
+
+/** Props InteractiveBox accepts — `_rw` plus anything to forward. */
+export interface InteractiveBoxProps {
+  /** Compile-time spec packed by the transformer. */
+  readonly _rw: InteractiveSpec
+  /** Every other prop passes through to the inner component. */
+  readonly [key: string]: unknown
+}
+
+/**
+ * Per-instance wrapper that drives `active:` / `focus:` variants. One
+ * `useInteract()` hook per mounted `InteractiveBox` means each element
+ * owns its own state — siblings never share `active` / `focus` flags.
+ *
+ * The transformer replaces
+ *   `<Pressable className="active:bg-sky-700" onPress={x} />`
+ * with
+ *   `<InteractiveBox _rw={{as: Pressable, cn: _c0, t: _t}} onPress={x} />`.
+ * @param props `_rw` spec + any props to forward to the inner component.
+ * @returns Rendered element of the inner component with interact wiring.
+ */
+export function InteractiveBox(props: InteractiveBoxProps): ReactElement {
+  const { _rw, onPressIn, onPressOut, onFocus, onBlur, ...rest } = props
+  const interact = useInteract()
+  const merged: Record<string, unknown> = {
+    ...rest,
+    style: lookupCss(_rw.cn, _rw.t, _rw.us, interact.state),
+    onPressIn: chainPress(onPressIn as Parameters<typeof chainPress>[0], interact.onPressIn),
+    onPressOut: chainPress(onPressOut as Parameters<typeof chainPress>[0], interact.onPressOut),
+    onFocus: chainFocus(onFocus as Parameters<typeof chainFocus>[0], interact.onFocus),
+    onBlur: chainFocus(onBlur as Parameters<typeof chainFocus>[0], interact.onBlur),
+  }
+  return createElement(_rw.as as ComponentType<Record<string, unknown>>, merged)
+}