rnwind 0.0.3 → 0.0.5

package/lib/esm/metro/wrap-imports.mjs

@@ -0,0 +1,250 @@
+import * as t from '@babel/types';
+
+/**
+ * Build-time import rewrite. For every `import { View } from
+ * 'react-native'` (and the other configured modules) it aliases the
+ * original export and binds a `wrap()`-ed component in its place:
+ *
+ * ```
+ * import { View, StyleSheet } from 'react-native'
+ * ⇩
+ * import { View as _rnw0, StyleSheet } from 'react-native'
+ * import { wrap as _rnwWrap } from 'rnwind'
+ * const View = _rnwWrap(_rnw0)
+ * ```
+ *
+ * Now `<View className="…">` resolves className → style at render via the
+ * wrapper — no matter how className arrived (literal, `{...rest}` spread,
+ * forwarded through custom layers). Non-component exports (`StyleSheet`)
+ * are left untouched.
+ */
+/** Local binding the injected `wrap` import is aliased to. */
+const WRAP_LOCAL = '_rnwWrap';
+/** Local binding the injected `wrapNamespace` import is aliased to. */
+const WRAP_NS_LOCAL = '_rnwWrapNs';
+/** Module the wrapper is imported from. */
+const RUNTIME_MODULE = 'rnwind';
+/**
+ * Wrap-modules whose DEFAULT export is a component NAMESPACE accessed via
+ * member expressions (`Animated.View`), not a single component. Their
+ * default import is bound through `wrapNamespace` (a Proxy that wraps each
+ * accessed component member) instead of `wrap`. Every other default import
+ * is treated as a plain component.
+ */
+const NAMESPACE_DEFAULT_MODULES = new Set(['react-native-reanimated']);
+/**
+ * react-native mixes styleable components with utilities (`StyleSheet`,
+ * `Platform`, …). Only these named exports are wrapped; everything else
+ * passes through. Other ecosystem modules export components only and use
+ * the `'all'` policy instead.
+ */
+const REACT_NATIVE_COMPONENTS = new Set([
+    'View',
+    'Text',
+    'TextInput',
+    'Pressable',
+    'ScrollView',
+    'Image',
+    'ImageBackground',
+    'FlatList',
+    'SectionList',
+    'VirtualizedList',
+    'KeyboardAvoidingView',
+    'SafeAreaView',
+    'Modal',
+    'Switch',
+    'RefreshControl',
+    'ActivityIndicator',
+    'TouchableOpacity',
+    'TouchableHighlight',
+    'TouchableWithoutFeedback',
+    'TouchableNativeFeedback',
+    'Button',
+    'StatusBar',
+]);
+/**
+ * Named exports that LOOK like components (PascalCase) under an `'all'`
+ * policy but aren't — React contexts, gesture-handler enums/namespaces,
+ * etc. Wrapping these would turn `Gesture.Pan()` / `State.ACTIVE` /
+ * `<XContext.Provider>` into a `wrap()`-ed component and break them.
+ * Names ending in `Context` are excluded separately.
+ */
+const NON_COMPONENT_EXPORTS = new Set([
+    'Gesture',
+    'GestureObjects',
+    'State',
+    'Directions',
+    'Extrapolation',
+    'Extrapolate',
+    'Easing',
+    'ReduceMotion',
+    'KeyframeRegistry',
+]);
+/**
+ * Default module → wrap policy. react-native is allow-listed (mixed
+ * exports); the rest are component-only packages → `'all'`. Only modules
+ * the project has installed are ever hit (you can't import from a missing
+ * package), so listing optional peers is free.
+ */
+const DEFAULT_WRAP_MODULES = new Map([
+    ['react-native', REACT_NATIVE_COMPONENTS],
+    ['react-native-reanimated', 'all'],
+    ['react-native-svg', 'all'],
+    ['react-native-gesture-handler', 'all'],
+    ['react-native-safe-area-context', 'all'],
+    ['expo-linear-gradient', 'all'],
+    ['expo-image', 'all'],
+    ['expo-blur', 'all'],
+    ['expo-symbols', 'all'],
+    ['@shopify/flash-list', 'all'],
+    ['@shopify/react-native-skia', 'all'],
+    ['lottie-react-native', 'all'],
+]);
+/**
+ * Whether a named import from a wrap-module should be wrapped.
+ *
+ * Explicit allow-lists (react-native) match by exact name. The `'all'`
+ * policy wraps only component-style names — PascalCase, not a React
+ * context (`*Context`), and not a known non-component export. This is
+ * what stops `useSafeAreaInsets` (a hook) from being wrapped into a
+ * component and crashing when called.
+ * @param policy The module's wrap policy.
+ * @param importedName The exported name being imported.
+ * @returns True when the name is a component to wrap.
+ */
+function shouldWrap(policy, importedName) {
+    if (policy !== 'all')
+        return policy.has(importedName);
+    if (!/^[A-Z]/.test(importedName))
+        return false;
+    if (importedName.endsWith('Context'))
+        return false;
+    return !NON_COMPONENT_EXPORTS.has(importedName);
+}
+/**
+ * Merge user-supplied wrap modules onto the defaults — a bare module name
+ * adopts the `'all'` policy.
+ * @param extra User module specifiers (or undefined).
+ * @returns Effective module → policy map.
+ */
+function buildWrapModules(extra) {
+    if (!extra || extra.length === 0)
+        return DEFAULT_WRAP_MODULES;
+    const merged = new Map(DEFAULT_WRAP_MODULES);
+    for (const moduleName of extra)
+        if (!merged.has(moduleName))
+            merged.set(moduleName, 'all');
+    return merged;
+}
+/**
+ * The `imported` name of an import specifier (`import { a as b }` → `'a'`).
+ * @param specifier Named import specifier.
+ * @returns The exported name.
+ */
+function importedNameOf(specifier) {
+    return t.isIdentifier(specifier.imported) ? specifier.imported.name : specifier.imported.value;
+}
+/**
+ * Build `const Local = <wrapper>(alias)` and rebind the specifier's local
+ * to `alias` in place.
+ * @param specifier The import specifier to rebind.
+ * @param alias The `_rnwN` alias to bind the original import to.
+ * @param wrapper The runtime helper local (`_rnwWrap` / `_rnwWrapNs`).
+ * @returns The wrap declaration.
+ */
+function makeWrapDecl(specifier, alias, wrapper) {
+    const { name: localName } = specifier.local;
+    specifier.local = t.identifier(alias);
+    return t.variableDeclaration('const', [
+        t.variableDeclarator(t.identifier(localName), t.callExpression(t.identifier(wrapper), [t.identifier(alias)])),
+    ]);
+}
+/**
+ * Rewrite one import declaration's wrappable specifiers, aliasing each to
+ * `_rnw<N>` in place:
+ *  - named (`{ View }`) → `const View = wrap(_rnwN)` (per policy),
+ *  - namespace (`* as Animated`) → `const Animated = wrapNamespace(_rnwN)`,
+ *  - default → `wrapNamespace` for {@link NAMESPACE_DEFAULT_MODULES}
+ *    (reanimated's `Animated`), else `wrap` (a plain default component).
+ * @param node Import declaration to inspect.
+ * @param policy The module's wrap policy.
+ * @param counter Next alias index (caller-threaded for uniqueness).
+ * @returns New wrap declarations, advanced counter, and whether any
+ *   binding used `wrapNamespace`.
+ */
+function wrapSpecifiers(node, policy, counter) {
+    const decls = [];
+    const moduleName = node.source.value;
+    let next = counter;
+    let usesNamespace = false;
+    for (const specifier of node.specifiers) {
+        if (t.isImportSpecifier(specifier)) {
+            if (!shouldWrap(policy, importedNameOf(specifier)))
+                continue;
+            decls.push(makeWrapDecl(specifier, `_rnw${next}`, WRAP_LOCAL));
+            next += 1;
+            continue;
+        }
+        const isNamespace = t.isImportNamespaceSpecifier(specifier) || NAMESPACE_DEFAULT_MODULES.has(moduleName);
+        const wrapper = isNamespace ? WRAP_NS_LOCAL : WRAP_LOCAL;
+        decls.push(makeWrapDecl(specifier, `_rnw${next}`, wrapper));
+        next += 1;
+        if (isNamespace)
+            usesNamespace = true;
+    }
+    return { decls, counter: next, usesNamespace };
+}
+/**
+ * Insert the `wrap` import at the top and the `const X = wrap(_rnwN)`
+ * declarations AFTER every import. The consts reference the aliased
+ * binding `_rnwN`, and in Metro's real transform (CommonJS interop + the
+ * reanimated worklets plugin) a const placed above its source import
+ * evaluates before the binding initialises → `ReferenceError: _rnw0
+ * doesn't exist`. ESM-only hoisting would mask this; the bundle does not.
+ * @param ast Parsed Babel file (mutated).
+ * @param wrapDecls The wrap declarations to place.
+ * @param usesNamespace Whether any binding used `wrapNamespace`.
+ */
+function placeWrapDecls(ast, wrapDecls, usesNamespace) {
+    const specifiers = [t.importSpecifier(t.identifier(WRAP_LOCAL), t.identifier('wrap'))];
+    if (usesNamespace)
+        specifiers.push(t.importSpecifier(t.identifier(WRAP_NS_LOCAL), t.identifier('wrapNamespace')));
+    ast.program.body.unshift(t.importDeclaration(specifiers, t.stringLiteral(RUNTIME_MODULE)));
+    let afterImports = 0;
+    for (let index = 0; index < ast.program.body.length; index += 1) {
+        if (t.isImportDeclaration(ast.program.body[index]))
+            afterImports = index + 1;
+    }
+    ast.program.body.splice(afterImports, 0, ...wrapDecls);
+}
+/**
+ * Rewrite component imports from the configured wrap-modules into
+ * `wrap()`-ed bindings, in place. Injects the `wrap` import once when any
+ * binding was rewritten.
+ * @param ast Parsed Babel file (mutated).
+ * @param modules Effective module → policy map.
+ * @returns True when at least one import was wrapped.
+ */
+function rewriteWrapImports(ast, modules) {
+    const wrapDecls = [];
+    let counter = 0;
+    let usesNamespace = false;
+    for (const node of ast.program.body) {
+        if (!t.isImportDeclaration(node))
+            continue;
+        const policy = modules.get(node.source.value);
+        if (!policy)
+            continue;
+        const { decls, counter: nextCounter, usesNamespace: ns } = wrapSpecifiers(node, policy, counter);
+        counter = nextCounter;
+        usesNamespace = usesNamespace || ns;
+        wrapDecls.push(...decls);
+    }
+    if (wrapDecls.length === 0)
+        return false;
+    placeWrapDecls(ast, wrapDecls, usesNamespace);
+    return true;
+}
+
+export { DEFAULT_WRAP_MODULES, buildWrapModules, rewriteWrapImports };
+//# sourceMappingURL=wrap-imports.mjs.map

package/lib/esm/metro/wrap-imports.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-imports.mjs","sources":["../../../../src/metro/wrap-imports.ts"],"sourcesContent":["import * as t from '@babel/types'\nimport type { File } from '@babel/types'\n\n/**\n * Build-time import rewrite. For every `import { View } from\n * 'react-native'` (and the other configured modules) it aliases the\n * original export and binds a `wrap()`-ed component in its place:\n *\n * ```\n * import { View, StyleSheet } from 'react-native'\n * ⇩\n * import { View as _rnw0, StyleSheet } from 'react-native'\n * import { wrap as _rnwWrap } from 'rnwind'\n * const View = _rnwWrap(_rnw0)\n * ```\n *\n * Now `<View className=\"…\">` resolves className → style at render via the\n * wrapper — no matter how className arrived (literal, `{...rest}` spread,\n * forwarded through custom layers). Non-component exports (`StyleSheet`)\n * are left untouched.\n */\n\n/** Local binding the injected `wrap` import is aliased to. */\nconst WRAP_LOCAL = '_rnwWrap'\n/** Local binding the injected `wrapNamespace` import is aliased to. */\nconst WRAP_NS_LOCAL = '_rnwWrapNs'\n/** Module the wrapper is imported from. */\nconst RUNTIME_MODULE = 'rnwind'\n\n/**\n * Wrap-modules whose DEFAULT export is a component NAMESPACE accessed via\n * member expressions (`Animated.View`), not a single component. Their\n * default import is bound through `wrapNamespace` (a Proxy that wraps each\n * accessed component member) instead of `wrap`. Every other default import\n * is treated as a plain component.\n */\nconst NAMESPACE_DEFAULT_MODULES: ReadonlySet<string> = new Set(['react-native-reanimated'])\n\n/**\n * react-native mixes styleable components with utilities (`StyleSheet`,\n * `Platform`, …). Only these named exports are wrapped; everything else\n * passes through. Other ecosystem modules export components only and use\n * the `'all'` policy instead.\n */\nconst REACT_NATIVE_COMPONENTS: ReadonlySet<string> = new Set([\n  'View',\n  'Text',\n  'TextInput',\n  'Pressable',\n  'ScrollView',\n  'Image',\n  'ImageBackground',\n  'FlatList',\n  'SectionList',\n  'VirtualizedList',\n  'KeyboardAvoidingView',\n  'SafeAreaView',\n  'Modal',\n  'Switch',\n  'RefreshControl',\n  'ActivityIndicator',\n  'TouchableOpacity',\n  'TouchableHighlight',\n  'TouchableWithoutFeedback',\n  'TouchableNativeFeedback',\n  'Button',\n  'StatusBar',\n])\n\n/**\n * Named exports that LOOK like components (PascalCase) under an `'all'`\n * policy but aren't — React contexts, gesture-handler enums/namespaces,\n * etc. Wrapping these would turn `Gesture.Pan()` / `State.ACTIVE` /\n * `<XContext.Provider>` into a `wrap()`-ed component and break them.\n * Names ending in `Context` are excluded separately.\n */\nconst NON_COMPONENT_EXPORTS: ReadonlySet<string> = new Set([\n  'Gesture',\n  'GestureObjects',\n  'State',\n  'Directions',\n  'Extrapolation',\n  'Extrapolate',\n  'Easing',\n  'ReduceMotion',\n  'KeyframeRegistry',\n])\n\n/** Per-module policy: an explicit allow-list, or `'all'` named exports. */\nexport type WrapPolicy = 'all' | ReadonlySet<string>\n\n/**\n * Default module → wrap policy. react-native is allow-listed (mixed\n * exports); the rest are component-only packages → `'all'`. Only modules\n * the project has installed are ever hit (you can't import from a missing\n * package), so listing optional peers is free.\n */\nexport const DEFAULT_WRAP_MODULES: ReadonlyMap<string, WrapPolicy> = new Map<string, WrapPolicy>([\n  ['react-native', REACT_NATIVE_COMPONENTS],\n  ['react-native-reanimated', 'all'],\n  ['react-native-svg', 'all'],\n  ['react-native-gesture-handler', 'all'],\n  ['react-native-safe-area-context', 'all'],\n  ['expo-linear-gradient', 'all'],\n  ['expo-image', 'all'],\n  ['expo-blur', 'all'],\n  ['expo-symbols', 'all'],\n  ['@shopify/flash-list', 'all'],\n  ['@shopify/react-native-skia', 'all'],\n  ['lottie-react-native', 'all'],\n])\n\n/**\n * Whether a named import from a wrap-module should be wrapped.\n *\n * Explicit allow-lists (react-native) match by exact name. The `'all'`\n * policy wraps only component-style names — PascalCase, not a React\n * context (`*Context`), and not a known non-component export. This is\n * what stops `useSafeAreaInsets` (a hook) from being wrapped into a\n * component and crashing when called.\n * @param policy The module's wrap policy.\n * @param importedName The exported name being imported.\n * @returns True when the name is a component to wrap.\n */\nfunction shouldWrap(policy: WrapPolicy, importedName: string): boolean {\n  if (policy !== 'all') return policy.has(importedName)\n  if (!/^[A-Z]/.test(importedName)) return false\n  if (importedName.endsWith('Context')) return false\n  return !NON_COMPONENT_EXPORTS.has(importedName)\n}\n\n/**\n * Merge user-supplied wrap modules onto the defaults — a bare module name\n * adopts the `'all'` policy.\n * @param extra User module specifiers (or undefined).\n * @returns Effective module → policy map.\n */\nexport function buildWrapModules(extra?: readonly string[]): ReadonlyMap<string, WrapPolicy> {\n  if (!extra || extra.length === 0) return DEFAULT_WRAP_MODULES\n  const merged = new Map<string, WrapPolicy>(DEFAULT_WRAP_MODULES)\n  for (const moduleName of extra) if (!merged.has(moduleName)) merged.set(moduleName, 'all')\n  return merged\n}\n\n/**\n * The `imported` name of an import specifier (`import { a as b }` → `'a'`).\n * @param specifier Named import specifier.\n * @returns The exported name.\n */\nfunction importedNameOf(specifier: t.ImportSpecifier): string {\n  return t.isIdentifier(specifier.imported) ? specifier.imported.name : specifier.imported.value\n}\n\n/**\n * Build `const Local = <wrapper>(alias)` and rebind the specifier's local\n * to `alias` in place.\n * @param specifier The import specifier to rebind.\n * @param alias The `_rnwN` alias to bind the original import to.\n * @param wrapper The runtime helper local (`_rnwWrap` / `_rnwWrapNs`).\n * @returns The wrap declaration.\n */\nfunction makeWrapDecl(\n  specifier: t.ImportSpecifier | t.ImportDefaultSpecifier | t.ImportNamespaceSpecifier,\n  alias: string,\n  wrapper: string,\n): t.VariableDeclaration {\n  const { name: localName } = specifier.local\n  specifier.local = t.identifier(alias)\n  return t.variableDeclaration('const', [\n    t.variableDeclarator(t.identifier(localName), t.callExpression(t.identifier(wrapper), [t.identifier(alias)])),\n  ])\n}\n\n/**\n * Rewrite one import declaration's wrappable specifiers, aliasing each to\n * `_rnw<N>` in place:\n *  - named (`{ View }`) → `const View = wrap(_rnwN)` (per policy),\n *  - namespace (`* as Animated`) → `const Animated = wrapNamespace(_rnwN)`,\n *  - default → `wrapNamespace` for {@link NAMESPACE_DEFAULT_MODULES}\n *    (reanimated's `Animated`), else `wrap` (a plain default component).\n * @param node Import declaration to inspect.\n * @param policy The module's wrap policy.\n * @param counter Next alias index (caller-threaded for uniqueness).\n * @returns New wrap declarations, advanced counter, and whether any\n *   binding used `wrapNamespace`.\n */\nfunction wrapSpecifiers(\n  node: t.ImportDeclaration,\n  policy: WrapPolicy,\n  counter: number,\n): { decls: t.VariableDeclaration[]; counter: number; usesNamespace: boolean } {\n  const decls: t.VariableDeclaration[] = []\n  const moduleName = node.source.value\n  let next = counter\n  let usesNamespace = false\n  for (const specifier of node.specifiers) {\n    if (t.isImportSpecifier(specifier)) {\n      if (!shouldWrap(policy, importedNameOf(specifier))) continue\n      decls.push(makeWrapDecl(specifier, `_rnw${next}`, WRAP_LOCAL))\n      next += 1\n      continue\n    }\n    const isNamespace = t.isImportNamespaceSpecifier(specifier) || NAMESPACE_DEFAULT_MODULES.has(moduleName)\n    const wrapper = isNamespace ? WRAP_NS_LOCAL : WRAP_LOCAL\n    decls.push(makeWrapDecl(specifier, `_rnw${next}`, wrapper))\n    next += 1\n    if (isNamespace) usesNamespace = true\n  }\n  return { decls, counter: next, usesNamespace }\n}\n\n/**\n * Insert the `wrap` import at the top and the `const X = wrap(_rnwN)`\n * declarations AFTER every import. The consts reference the aliased\n * binding `_rnwN`, and in Metro's real transform (CommonJS interop + the\n * reanimated worklets plugin) a const placed above its source import\n * evaluates before the binding initialises → `ReferenceError: _rnw0\n * doesn't exist`. ESM-only hoisting would mask this; the bundle does not.\n * @param ast Parsed Babel file (mutated).\n * @param wrapDecls The wrap declarations to place.\n * @param usesNamespace Whether any binding used `wrapNamespace`.\n */\nfunction placeWrapDecls(ast: File, wrapDecls: readonly t.VariableDeclaration[], usesNamespace: boolean): void {\n  const specifiers = [t.importSpecifier(t.identifier(WRAP_LOCAL), t.identifier('wrap'))]\n  if (usesNamespace) specifiers.push(t.importSpecifier(t.identifier(WRAP_NS_LOCAL), t.identifier('wrapNamespace')))\n  ast.program.body.unshift(t.importDeclaration(specifiers, t.stringLiteral(RUNTIME_MODULE)))\n  let afterImports = 0\n  for (let index = 0; index < ast.program.body.length; index += 1) {\n    if (t.isImportDeclaration(ast.program.body[index])) afterImports = index + 1\n  }\n  ast.program.body.splice(afterImports, 0, ...wrapDecls)\n}\n\n/**\n * Rewrite component imports from the configured wrap-modules into\n * `wrap()`-ed bindings, in place. Injects the `wrap` import once when any\n * binding was rewritten.\n * @param ast Parsed Babel file (mutated).\n * @param modules Effective module → policy map.\n * @returns True when at least one import was wrapped.\n */\nexport function rewriteWrapImports(ast: File, modules: ReadonlyMap<string, WrapPolicy>): boolean {\n  const wrapDecls: t.VariableDeclaration[] = []\n  let counter = 0\n  let usesNamespace = false\n\n  for (const node of ast.program.body) {\n    if (!t.isImportDeclaration(node)) continue\n    const policy = modules.get(node.source.value)\n    if (!policy) continue\n    const { decls, counter: nextCounter, usesNamespace: ns } = wrapSpecifiers(node, policy, counter)\n    counter = nextCounter\n    usesNamespace = usesNamespace || ns\n    wrapDecls.push(...decls)\n  }\n\n  if (wrapDecls.length === 0) return false\n  placeWrapDecls(ast, wrapDecls, usesNamespace)\n  return true\n}\n"],"names":[],"mappings":"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"}

package/lib/esm/runtime/components/rnwind-provider.d.ts

@@ -55,20 +55,6 @@ export type RnwindProviderProps = Readonly<{
  * @returns Active rnwind state under the nearest {@link RnwindProvider}.
  */
 export declare function useRnwind(): RnwindState;
-/**
- * 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 declare function useR_(): RnwindState;
 /**
  * Provider for rnwind's full runtime state. fontScale + windowWidth
  * come from `useWindowDimensions()` so they react to OS-level

package/lib/esm/runtime/components/rnwind-provider.mjs

@@ -44,22 +44,6 @@ const RnwindContext = createContext(DEFAULT_STATE);
 function useRnwind() {
     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.
- */
-function useR_() {
-    return useContext(RnwindContext);
-}
 /**
  * Provider for rnwind's full runtime state. fontScale + windowWidth
  * come from `useWindowDimensions()` so they react to OS-level
@@ -90,5 +74,5 @@ function RnwindProvider({ scheme, tables, insets, onHaptics, children }) {
     return jsx(RnwindContext.Provider, { value: value, children: children });
 }
 
-export { RnwindProvider, useR_, useRnwind };
+export { RnwindProvider, useRnwind };
 //# sourceMappingURL=rnwind-provider.mjs.map

package/lib/esm/runtime/components/rnwind-provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rnwind-provider.mjs","sources":["../../../../../src/runtime/components/rnwind-provider.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport { useWindowDimensions } from 'react-native'\nimport type { ThemeTables } from '../../core/types'\nimport type { Scheme } from '../types'\nimport type { OnHaptics } from '../../core/parser/haptics'\nimport { activeBreakpointFor, BASE_BREAKPOINT, loadScheme } from '../lookup-css'\n\n/**\n * Per-render safe-area insets snapshot. Bridge from any source\n * (`useSafeAreaInsets()`, expo-router insets, a manually computed\n * value) into the {@link RnwindProvider} — rnwind stays\n * library-agnostic.\n */\nexport type Insets = Readonly<{\n  top: number\n  right: number\n  bottom: number\n  left: number\n}>\n\n/**\n * Single value carried by the rnwind context. Every piece of runtime\n * state rnwind needs — scheme, theme tables, insets, font scale,\n * window width, active responsive breakpoint, optional haptic\n * dispatcher — lives on this one bag. Consumers read it via\n * {@link useRnwind} and either destructure or forward straight to\n * `lookupCss` / `useCss`.\n *\n * `activeBreakpoint` is the highest-threshold registered breakpoint\n * whose min-width is `<= windowWidth`, or `'base'` when below the\n * smallest one (mobile-first tier) or when no breakpoints are\n * registered yet (tests, bundles without rnwind-transformed sources).\n * Always a string — never null. Reactive: it updates with\n * `useWindowDimensions().width`, so consumers can branch on it\n * without a separate hook.\n */\nexport type RnwindState = Readonly<{\n  scheme: Scheme\n  tables: ThemeTables\n  insets: Insets\n  onHaptics: OnHaptics | undefined\n  fontScale: number\n  windowWidth: number\n  activeBreakpoint: string\n}>\n\n/** Props accepted by {@link RnwindProvider}. */\nexport type RnwindProviderProps = Readonly<{\n  scheme: Scheme\n  tables?: ThemeTables\n  insets?: Partial<Insets>\n  onHaptics?: OnHaptics\n  children?: ReactNode\n}>\n\nconst EMPTY_TABLES: ThemeTables = {}\nconst ZERO_INSETS: Insets = { top: 0, right: 0, bottom: 0, left: 0 }\nconst DEFAULT_STATE: RnwindState = {\n  scheme: 'light' as Scheme,\n  tables: EMPTY_TABLES,\n  insets: ZERO_INSETS,\n  onHaptics: undefined,\n  fontScale: 1,\n  windowWidth: 0,\n  activeBreakpoint: BASE_BREAKPOINT,\n}\n\n/**\n * Normalise a `Partial<Insets>` into a complete {@link Insets}, returning\n * the shared {@link ZERO_INSETS} reference when nothing is supplied so\n * downstream memoisation stays stable.\n * @param partial Caller-supplied insets (or undefined).\n * @returns Complete insets record.\n */\nfunction normaliseInsets(partial: Partial<Insets> | undefined): Insets {\n  if (!partial) return ZERO_INSETS\n  const top = partial.top ?? 0\n  const right = partial.right ?? 0\n  const bottom = partial.bottom ?? 0\n  const left = partial.left ?? 0\n  if (top === 0 && right === 0 && bottom === 0 && left === 0) return ZERO_INSETS\n  return { top, right, bottom, left }\n}\n\n/** Single internal context the runtime reads from. */\nconst RnwindContext = createContext<RnwindState>(DEFAULT_STATE)\n\n/**\n * Read rnwind's full runtime state — scheme, theme tables, insets,\n * fontScale, windowWidth, onHaptics — in one go. Pass the returned\n * value straight to `lookupCss` / `useCss`, or destructure what you\n * need.\n * @returns Active rnwind state under the nearest {@link RnwindProvider}.\n */\nexport function useRnwind(): RnwindState {\n  return useContext(RnwindContext)\n}\n\n/**\n * Internal context hook the babel transformer injects at the top of\n * every rewritten component as `const _t = useR_()`. Same body as the\n * public {@link useRnwind} — exposed under a `use*`-prefixed name so\n * react-refresh's babel plugin (which only tracks call-sites whose\n * identifier matches `^use[A-Z]`) folds it into each component's\n * fast-refresh signature. Without that prefix the signature stayed\n * stable across transformer changes; HMR then preserved fiber state\n * while the rendered hook list shifted, surfacing as \"change in the\n * order of Hooks\" runtime errors. Trailing underscore keeps it\n * visually distinct from the user-facing `useRnwind`.\n * @returns Active rnwind state.\n */\nexport function useR_(): RnwindState {\n  return useContext(RnwindContext)\n}\n\n/**\n * Provider for rnwind's full runtime state. fontScale + windowWidth\n * come from `useWindowDimensions()` so they react to OS-level\n * orientation / accessibility-text-size changes automatically.\n * @param props Provider props.\n * @param props.scheme Active scheme name.\n * @param props.tables Optional pre-resolved token tables.\n * @param props.insets Optional safe-area insets.\n * @param props.onHaptics Optional haptic dispatcher.\n * @param props.children React subtree.\n * @returns Provider element.\n */\nexport function RnwindProvider({ scheme, tables, insets, onHaptics, children }: RnwindProviderProps): ReactNode {\n  const normalized = normaliseInsets(insets)\n  const { fontScale, width } = useWindowDimensions()\n  const value = useMemo<RnwindState>(() => {\n    loadScheme(scheme)\n    return {\n      scheme,\n      tables: tables ?? EMPTY_TABLES,\n      insets: normalized,\n      onHaptics,\n      fontScale,\n      windowWidth: width,\n      activeBreakpoint: activeBreakpointFor(width),\n    }\n  }, [scheme, tables, normalized, onHaptics, fontScale, width])\n  return <RnwindContext.Provider value={value}>{children}</RnwindContext.Provider>\n}\n"],"names":["_jsx"],"mappings":";;;;;AAuDA,MAAM,YAAY,GAAgB,EAAE;AACpC,MAAM,WAAW,GAAW,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;AACpE,MAAM,aAAa,GAAgB;AACjC,IAAA,MAAM,EAAE,OAAiB;AACzB,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,SAAS,EAAE,SAAS;AACpB,IAAA,SAAS,EAAE,CAAC;AACZ,IAAA,WAAW,EAAE,CAAC;AACd,IAAA,gBAAgB,EAAE,eAAe;CAClC;AAED;;;;;;AAMG;AACH,SAAS,eAAe,CAAC,OAAoC,EAAA;AAC3D,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,WAAW;AAChC,IAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;AAC5B,IAAA,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;AAChC,IAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;AAClC,IAAA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC;AAC9B,IAAA,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;AAAE,QAAA,OAAO,WAAW;IAC9E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;AACrC;AAEA;AACA,MAAM,aAAa,GAAG,aAAa,CAAc,aAAa,CAAC;AAE/D;;;;;;AAMG;SACa,SAAS,GAAA;AACvB,IAAA,OAAO,UAAU,CAAC,aAAa,CAAC;AAClC;AAEA;;;;;;;;;;;;AAYG;SACa,KAAK,GAAA;AACnB,IAAA,OAAO,UAAU,CAAC,aAAa,CAAC;AAClC;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAuB,EAAA;AACjG,IAAA,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE;AAClD,IAAA,MAAM,KAAK,GAAG,OAAO,CAAc,MAAK;QACtC,UAAU,CAAC,MAAM,CAAC;QAClB,OAAO;YACL,MAAM;YACN,MAAM,EAAE,MAAM,IAAI,YAAY;AAC9B,YAAA,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,SAAS;AACT,YAAA,WAAW,EAAE,KAAK;AAClB,YAAA,gBAAgB,EAAE,mBAAmB,CAAC,KAAK,CAAC;SAC7C;AACH,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAOA,GAAA,CAAC,aAAa,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EAAG,QAAQ,EAAA,CAA0B;AAClF;;;;"}
+{"version":3,"file":"rnwind-provider.mjs","sources":["../../../../../src/runtime/components/rnwind-provider.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport { useWindowDimensions } from 'react-native'\nimport type { ThemeTables } from '../../core/types'\nimport type { Scheme } from '../types'\nimport type { OnHaptics } from '../../core/parser/haptics'\nimport { activeBreakpointFor, BASE_BREAKPOINT, loadScheme } from '../lookup-css'\n\n/**\n * Per-render safe-area insets snapshot. Bridge from any source\n * (`useSafeAreaInsets()`, expo-router insets, a manually computed\n * value) into the {@link RnwindProvider} — rnwind stays\n * library-agnostic.\n */\nexport type Insets = Readonly<{\n  top: number\n  right: number\n  bottom: number\n  left: number\n}>\n\n/**\n * Single value carried by the rnwind context. Every piece of runtime\n * state rnwind needs — scheme, theme tables, insets, font scale,\n * window width, active responsive breakpoint, optional haptic\n * dispatcher — lives on this one bag. Consumers read it via\n * {@link useRnwind} and either destructure or forward straight to\n * `lookupCss` / `useCss`.\n *\n * `activeBreakpoint` is the highest-threshold registered breakpoint\n * whose min-width is `<= windowWidth`, or `'base'` when below the\n * smallest one (mobile-first tier) or when no breakpoints are\n * registered yet (tests, bundles without rnwind-transformed sources).\n * Always a string — never null. Reactive: it updates with\n * `useWindowDimensions().width`, so consumers can branch on it\n * without a separate hook.\n */\nexport type RnwindState = Readonly<{\n  scheme: Scheme\n  tables: ThemeTables\n  insets: Insets\n  onHaptics: OnHaptics | undefined\n  fontScale: number\n  windowWidth: number\n  activeBreakpoint: string\n}>\n\n/** Props accepted by {@link RnwindProvider}. */\nexport type RnwindProviderProps = Readonly<{\n  scheme: Scheme\n  tables?: ThemeTables\n  insets?: Partial<Insets>\n  onHaptics?: OnHaptics\n  children?: ReactNode\n}>\n\nconst EMPTY_TABLES: ThemeTables = {}\nconst ZERO_INSETS: Insets = { top: 0, right: 0, bottom: 0, left: 0 }\nconst DEFAULT_STATE: RnwindState = {\n  scheme: 'light' as Scheme,\n  tables: EMPTY_TABLES,\n  insets: ZERO_INSETS,\n  onHaptics: undefined,\n  fontScale: 1,\n  windowWidth: 0,\n  activeBreakpoint: BASE_BREAKPOINT,\n}\n\n/**\n * Normalise a `Partial<Insets>` into a complete {@link Insets}, returning\n * the shared {@link ZERO_INSETS} reference when nothing is supplied so\n * downstream memoisation stays stable.\n * @param partial Caller-supplied insets (or undefined).\n * @returns Complete insets record.\n */\nfunction normaliseInsets(partial: Partial<Insets> | undefined): Insets {\n  if (!partial) return ZERO_INSETS\n  const top = partial.top ?? 0\n  const right = partial.right ?? 0\n  const bottom = partial.bottom ?? 0\n  const left = partial.left ?? 0\n  if (top === 0 && right === 0 && bottom === 0 && left === 0) return ZERO_INSETS\n  return { top, right, bottom, left }\n}\n\n/** Single internal context the runtime reads from. */\nconst RnwindContext = createContext<RnwindState>(DEFAULT_STATE)\n\n/**\n * Read rnwind's full runtime state — scheme, theme tables, insets,\n * fontScale, windowWidth, onHaptics — in one go. Pass the returned\n * value straight to `lookupCss` / `useCss`, or destructure what you\n * need.\n * @returns Active rnwind state under the nearest {@link RnwindProvider}.\n */\nexport function useRnwind(): RnwindState {\n  return useContext(RnwindContext)\n}\n\n/**\n * Provider for rnwind's full runtime state. fontScale + windowWidth\n * come from `useWindowDimensions()` so they react to OS-level\n * orientation / accessibility-text-size changes automatically.\n * @param props Provider props.\n * @param props.scheme Active scheme name.\n * @param props.tables Optional pre-resolved token tables.\n * @param props.insets Optional safe-area insets.\n * @param props.onHaptics Optional haptic dispatcher.\n * @param props.children React subtree.\n * @returns Provider element.\n */\nexport function RnwindProvider({ scheme, tables, insets, onHaptics, children }: RnwindProviderProps): ReactNode {\n  const normalized = normaliseInsets(insets)\n  const { fontScale, width } = useWindowDimensions()\n  const value = useMemo<RnwindState>(() => {\n    loadScheme(scheme)\n    return {\n      scheme,\n      tables: tables ?? EMPTY_TABLES,\n      insets: normalized,\n      onHaptics,\n      fontScale,\n      windowWidth: width,\n      activeBreakpoint: activeBreakpointFor(width),\n    }\n  }, [scheme, tables, normalized, onHaptics, fontScale, width])\n  return <RnwindContext.Provider value={value}>{children}</RnwindContext.Provider>\n}\n"],"names":["_jsx"],"mappings":";;;;;AAuDA,MAAM,YAAY,GAAgB,EAAE;AACpC,MAAM,WAAW,GAAW,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;AACpE,MAAM,aAAa,GAAgB;AACjC,IAAA,MAAM,EAAE,OAAiB;AACzB,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,SAAS,EAAE,SAAS;AACpB,IAAA,SAAS,EAAE,CAAC;AACZ,IAAA,WAAW,EAAE,CAAC;AACd,IAAA,gBAAgB,EAAE,eAAe;CAClC;AAED;;;;;;AAMG;AACH,SAAS,eAAe,CAAC,OAAoC,EAAA;AAC3D,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,WAAW;AAChC,IAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;AAC5B,IAAA,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;AAChC,IAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;AAClC,IAAA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC;AAC9B,IAAA,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;AAAE,QAAA,OAAO,WAAW;IAC9E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;AACrC;AAEA;AACA,MAAM,aAAa,GAAG,aAAa,CAAc,aAAa,CAAC;AAE/D;;;;;;AAMG;SACa,SAAS,GAAA;AACvB,IAAA,OAAO,UAAU,CAAC,aAAa,CAAC;AAClC;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAuB,EAAA;AACjG,IAAA,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE;AAClD,IAAA,MAAM,KAAK,GAAG,OAAO,CAAc,MAAK;QACtC,UAAU,CAAC,MAAM,CAAC;QAClB,OAAO;YACL,MAAM;YACN,MAAM,EAAE,MAAM,IAAI,YAAY;AAC9B,YAAA,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,SAAS;AACT,YAAA,WAAW,EAAE,KAAK;AAClB,YAAA,gBAAgB,EAAE,mBAAmB,CAAC,KAAK,CAAC;SAC7C;AACH,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAOA,GAAA,CAAC,aAAa,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EAAG,QAAQ,EAAA,CAA0B;AAClF;;;;"}

package/lib/esm/runtime/hooks/use-css.d.ts

@@ -1,11 +1,17 @@
 /**
- * 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.
+ * Resolve a className to a React Native `style` value against the active
+ * rnwind context (scheme, insets, fontScale, breakpoint). Molecule-fast:
+ * a literal className the scanner saw returns a pre-merged object by
+ * reference; anything else falls back to per-atom resolution. The escape
+ * hatch for custom components that hold a `className` prop:
+ *
+ * ```tsx
+ * function Card({ className, style, ...rest }) {
+ *   return <RNView style={useCss(className, style)} {...rest} />
+ * }
+ * ```
+ * @param className Raw className string.
+ * @param userStyle Optional caller-supplied style appended last (wins).
+ * @returns RN `style` value (a single object or an array).
  */
-export declare function useCss(className?: string | readonly string[] | null, userStyle?: unknown): readonly unknown[];
+export declare function useCss(className?: string | null, userStyle?: unknown): unknown;

package/lib/esm/runtime/hooks/use-css.mjs

@@ -1,18 +1,24 @@
 import { useRnwind } from '../components/rnwind-provider.mjs';
-import { lookupCss } from '../lookup-css.mjs';
+import { resolve } from '../resolve.mjs';
 
 /**
- * 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.
+ * Resolve a className to a React Native `style` value against the active
+ * rnwind context (scheme, insets, fontScale, breakpoint). Molecule-fast:
+ * a literal className the scanner saw returns a pre-merged object by
+ * reference; anything else falls back to per-atom resolution. The escape
+ * hatch for custom components that hold a `className` prop:
+ *
+ * ```tsx
+ * function Card({ className, style, ...rest }) {
+ *   return <RNView style={useCss(className, style)} {...rest} />
+ * }
+ * ```
+ * @param className Raw className string.
+ * @param userStyle Optional caller-supplied style appended last (wins).
+ * @returns RN `style` value (a single object or an array).
  */
 function useCss(className, userStyle) {
-    return lookupCss(className, useRnwind(), userStyle);
+    return resolve(className, useRnwind(), userStyle).style;
 }
 
 export { useCss };

package/lib/esm/runtime/hooks/use-css.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-css.mjs","sources":["../../../../../src/runtime/hooks/use-css.ts"],"sourcesContent":["import { useRnwind } from '../components/rnwind-provider'\nimport { lookupCss } from '../lookup-css'\n\n/**\n * Convenience hook: `useRnwind()` + `lookupCss()` rolled into one. Use\n * inside any component that wants the resolved style array without\n * threading the rnwind context manually. JSX-heavy components should\n * still call `useRnwind()` once and pass it to `lookupCss(...)` per\n * element so React only does a single context read per render.\n * @param className Raw className string or transformer-hoisted atom-name array.\n * @param userStyle Optional caller-supplied style appended last.\n * @returns Frozen style array for React Native's `style` prop.\n */\nexport function useCss(className?: string | readonly string[] | null, userStyle?: unknown): readonly unknown[] {\n  return lookupCss(className, useRnwind(), userStyle)\n}\n"],"names":[],"mappings":";;;AAGA;;;;;;;;;AASG;AACG,SAAU,MAAM,CAAC,SAA6C,EAAE,SAAmB,EAAA;IACvF,OAAO,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC;AACrD;;;;"}
+{"version":3,"file":"use-css.mjs","sources":["../../../../../src/runtime/hooks/use-css.ts"],"sourcesContent":["import { useRnwind } from '../components/rnwind-provider'\nimport { resolve } from '../resolve'\n\n/**\n * Resolve a className to a React Native `style` value against the active\n * rnwind context (scheme, insets, fontScale, breakpoint). Molecule-fast:\n * a literal className the scanner saw returns a pre-merged object by\n * reference; anything else falls back to per-atom resolution. The escape\n * hatch for custom components that hold a `className` prop:\n *\n * ```tsx\n * function Card({ className, style, ...rest }) {\n *   return <RNView style={useCss(className, style)} {...rest} />\n * }\n * ```\n * @param className Raw className string.\n * @param userStyle Optional caller-supplied style appended last (wins).\n * @returns RN `style` value (a single object or an array).\n */\nexport function useCss(className?: string | null, userStyle?: unknown): unknown {\n  return resolve(className, useRnwind(), userStyle).style\n}\n"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;AAeG;AACG,SAAU,MAAM,CAAC,SAAyB,EAAE,SAAmB,EAAA;IACnE,OAAO,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK;AACzD;;;;"}

package/lib/esm/runtime/index.d.ts

@@ -1,19 +1,14 @@
-export { lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider, getBreakpoints, activeBreakpointFor, lookupCss as _l, } from './lookup-css';
-export { useR_ } from './components/rnwind-provider';
+export { lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider, getBreakpoints, activeBreakpointFor, } from './lookup-css';
 export type { HoistedClassName, InteractState, LookupInsets, SafeMarkerSpec } from './lookup-css';
+export { wrap, wrapNamespace } from './wrap';
+export { resolve, registerMolecules, registerGradients, registerHaptics } from './resolve';
+export type { ResolvedCss } from './resolve';
 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 */
-/** @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';

package/lib/esm/runtime/index.mjs

@@ -1,10 +1,10 @@
-export { lookupCss as _l, activeBreakpointFor, getBreakpoints, lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider } from './lookup-css.mjs';
-export { RnwindProvider, useR_, useRnwind } from './components/rnwind-provider.mjs';
+export { activeBreakpointFor, getBreakpoints, lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider } from './lookup-css.mjs';
+export { wrap, wrapNamespace } from './wrap.mjs';
+export { registerGradients, registerHaptics, registerMolecules, resolve } from './resolve.mjs';
 export { useCss } from './hooks/use-css.mjs';
 export { useInteract } from './hooks/use-interact.mjs';
 export { chainFocus, chainPress } from './chain-handlers.mjs';
-export { InteractiveBox, InteractiveBox as _ib } from './interactive-box.mjs';
-export { useMountHaptic as _hm, triggerHaptic as _ht, triggerHaptic, useMountHaptic } from './haptics.mjs';
+export { RnwindProvider, useRnwind } from './components/rnwind-provider.mjs';
 export { useColor, useSize, useTheme, useToken } from './hooks/use-scheme.mjs';
 
 /**

package/lib/esm/runtime/index.mjs.map

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

package/lib/esm/runtime/lookup-css.d.ts

@@ -95,6 +95,13 @@ export declare function loadScheme(scheme: string): void;
  * @param atoms Plain record keyed by atom name.
  */
 export declare function registerAtoms(scheme: string, atoms: Record<string, unknown>): void;
+/**
+ * Current registry version — bumps on every `registerAtoms` /
+ * `registerBreakpoints`. The molecule resolver folds it into its cache
+ * key so an HMR atom reload invalidates derived results.
+ * @returns Monotonic version counter.
+ */
+export declare function getStyleVersion(): number;
 /**
  * Register the responsive-breakpoint table the manifest module emits at
  * load time. Replaces the prior table — calling with `{}` clears it.

package/lib/esm/runtime/lookup-css.mjs

@@ -407,6 +407,15 @@ function registerAtoms(scheme, atoms) {
     cache.atoms[scheme] = atoms;
     atomVersion += 1;
 }
+/**
+ * Current registry version — bumps on every `registerAtoms` /
+ * `registerBreakpoints`. The molecule resolver folds it into its cache
+ * key so an HMR atom reload invalidates derived results.
+ * @returns Monotonic version counter.
+ */
+function getStyleVersion() {
+    return atomVersion;
+}
 /**
  * Register the responsive-breakpoint table the manifest module emits at
  * load time. Replaces the prior table — calling with `{}` clears it.
@@ -527,5 +536,5 @@ function __resetLookupCssState() {
     atomVersion += 1;
 }
 
-export { BASE_BREAKPOINT, __resetLookupCssState, activeBreakpointFor, getBreakpoints, loadScheme, lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider };
+export { BASE_BREAKPOINT, __resetLookupCssState, activeBreakpointFor, getBreakpoints, getStyleVersion, loadScheme, lookupCss, registerAtoms, registerBreakpoints, registerSchemeLoader, setWindowHeightProvider };
 //# sourceMappingURL=lookup-css.mjs.map