rnwind 0.0.1 → 0.0.3

package/lib/esm/core/parser/transform.mjs

@@ -0,0 +1,193 @@
+import { lengthToPx } from './length.mjs';
+
+/**
+ * Map a single typed transform function into zero-or-more RN transform
+ * operations. Compound ops (like `translate`, `scale`, `skew`) expand
+ * into per-axis entries the way RN expects them.
+ * @param fn Typed transform function.
+ * @returns RN transform operations.
+ */
+function mapTransformFunction(fn) {
+    switch (fn.type) {
+        case 'rotate':
+        case 'rotateZ': {
+            return [{ rotate: angleToString(fn.value) }];
+        }
+        case 'rotateX': {
+            return [{ rotateX: angleToString(fn.value) }];
+        }
+        case 'rotateY': {
+            return [{ rotateY: angleToString(fn.value) }];
+        }
+        case 'scale': {
+            const [x, y] = fn.value;
+            return [{ scaleX: numberOrPercentageToNumber(x) }, { scaleY: numberOrPercentageToNumber(y) }];
+        }
+        case 'scaleX': {
+            return [{ scaleX: numberOrPercentageToNumber(fn.value) }];
+        }
+        case 'scaleY': {
+            return [{ scaleY: numberOrPercentageToNumber(fn.value) }];
+        }
+        case 'translateX': {
+            return [{ translateX: lengthOrPercentToNumber(fn.value) }];
+        }
+        case 'translateY': {
+            return [{ translateY: lengthOrPercentToNumber(fn.value) }];
+        }
+        case 'translate': {
+            const [x, y] = fn.value;
+            const out = [{ translateX: lengthOrPercentToNumber(x) }];
+            if (y)
+                out.push({ translateY: lengthOrPercentToNumber(y) });
+            return out;
+        }
+        case 'translate3d': {
+            const [x, y] = fn.value;
+            return [{ translateX: lengthOrPercentToNumber(x) }, { translateY: lengthOrPercentToNumber(y) }];
+        }
+        case 'skew': {
+            const [x, y] = fn.value;
+            const out = [{ skewX: angleToString(x) }];
+            if (y)
+                out.push({ skewY: angleToString(y) });
+            return out;
+        }
+        case 'skewX': {
+            return [{ skewX: angleToString(fn.value) }];
+        }
+        case 'skewY': {
+            return [{ skewY: angleToString(fn.value) }];
+        }
+        default: {
+            // RN doesn't have a direct equivalent for `matrix()` / `matrix3d()` /
+            // `perspective()` at the transform-op level — skip silently. Tailwind's
+            // generated transforms stay within rotate/translate/scale/skew.
+            return null;
+        }
+    }
+}
+/**
+ * Serialize a typed angle into the CSS degree string RN accepts
+ * (`'45deg'`, `'0.5turn'` → `'180deg'`).
+ * @param angle Typed angle.
+ * @returns Degree string.
+ */
+function angleToString(angle) {
+    switch (angle.type) {
+        case 'deg': {
+            return `${formatNumber(angle.value)}deg`;
+        }
+        case 'rad': {
+            return `${formatNumber((angle.value * 180) / Math.PI)}deg`;
+        }
+        case 'grad': {
+            return `${formatNumber((angle.value * 360) / 400)}deg`;
+        }
+        case 'turn': {
+            return `${formatNumber(angle.value * 360)}deg`;
+        }
+        default: {
+            return '0deg';
+        }
+    }
+}
+/**
+ * Convert a `NumberOrPercentage` to a plain number. Percentages become
+ * their fractional equivalent (e.g. `50%` → `0.5`).
+ * @param value Typed value.
+ * @returns Plain number.
+ */
+function numberOrPercentageToNumber(value) {
+    if (value.type === 'percentage')
+        return value.value;
+    return value.value;
+}
+/**
+ * Convert a length-or-percentage used by translate into the shape RN
+ * accepts (`number` for px, `string` for `%`). Percentages stay as
+ * strings so RN layout can resolve them against the element size.
+ * @param value Typed length or percentage.
+ * @returns RN-style translate value.
+ */
+function lengthOrPercentToNumber(value) {
+    if (value.type === 'dimension')
+        return lengthToPx(value.value);
+    if (value.type === 'value')
+        return lengthToPx(value.value);
+    if (value.type === 'percentage')
+        return `${formatNumber(value.value * 100)}%`;
+    return 0;
+}
+/**
+ * Render a number without trailing IEEE noise.
+ * @param value Number to format.
+ * @returns Compact string form.
+ */
+function formatNumber(value) {
+    const rounded = Math.round(value * 10_000) / 10_000;
+    return String(rounded);
+}
+/**
+ * Convert lightningcss's typed `transform: ...` value into RN's
+ * `transform: [{ op: value }, ...]` array. RN supports a restricted subset
+ * of CSS transforms — this function picks out the ones it actually
+ * handles and drops the rest.
+ *
+ * Reanimated v4's CSS engine reads this same array shape, so the output
+ * is drop-in for both static RN `style` props and `Animated.View` styles.
+ * @param fns Typed transform function list.
+ * @returns Zero-or-one RN entry with the `transform` array.
+ */
+function transformFunctionsToEntries(fns) {
+    const ops = [];
+    for (const fn of fns) {
+        const mapped = mapTransformFunction(fn);
+        if (mapped)
+            ops.push(...mapped);
+    }
+    if (ops.length === 0)
+        return [];
+    return [['transform', ops]];
+}
+/**
+ * Convert Tailwind v4's typed `rotate: ...` (individual property) into
+ * the RN transform array. Tailwind's `rotate-*` utilities emit this
+ * property rather than the classic `transform: rotate(...)` shorthand.
+ * @param value Typed rotate value.
+ * @returns Zero-or-one RN entry.
+ */
+function rotateToEntries(value) {
+    if (value === 'none')
+        return [];
+    return [['transform', [{ rotate: angleToString(value.angle) }]]];
+}
+/**
+ * Convert Tailwind v4's typed `translate: ...` into the RN transform
+ * array. Both axes are emitted as separate ops so each is independently
+ * animatable by Reanimated.
+ * @param value Typed translate value.
+ * @returns Zero-or-one RN entry.
+ */
+function translateToEntries(value) {
+    if (value === 'none')
+        return [];
+    const ops = [{ translateX: lengthOrPercentToNumber(value.x) }];
+    const yNumber = lengthOrPercentToNumber(value.y);
+    if (yNumber !== 0)
+        ops.push({ translateY: yNumber });
+    return [['transform', ops]];
+}
+/**
+ * Convert Tailwind v4's typed `scale: ...` into the RN transform array.
+ * @param value Typed scale value.
+ * @returns Zero-or-one RN entry.
+ */
+function scaleToEntries(value) {
+    if (value === 'none')
+        return [];
+    return [['transform', [{ scaleX: numberOrPercentageToNumber(value.x) }, { scaleY: numberOrPercentageToNumber(value.y) }]]];
+}
+
+export { rotateToEntries, scaleToEntries, transformFunctionsToEntries, translateToEntries };
+//# sourceMappingURL=transform.mjs.map

package/lib/esm/core/parser/transform.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.mjs","sources":["../../../../../src/core/parser/transform.ts"],"sourcesContent":["import type { Angle, LengthValue, NumberOrPercentage, Rotate, Scale, Transform, Translate } from 'lightningcss'\nimport type { RNEntry } from './types'\nimport { lengthToPx } from './length'\n\ntype RnTransformRecord = Record<string, string | number>\n\ntype DimensionPercent =\n  | { type: 'dimension'; value: LengthValue }\n  | { type: 'percentage'; value: number }\n  | { type: 'calc'; value: unknown }\n\n/**\n * Map a single typed transform function into zero-or-more RN transform\n * operations. Compound ops (like `translate`, `scale`, `skew`) expand\n * into per-axis entries the way RN expects them.\n * @param fn Typed transform function.\n * @returns RN transform operations.\n */\nfunction mapTransformFunction(fn: Transform): RnTransformRecord[] | null {\n  switch (fn.type) {\n    case 'rotate':\n    case 'rotateZ': {\n      return [{ rotate: angleToString(fn.value) }]\n    }\n    case 'rotateX': {\n      return [{ rotateX: angleToString(fn.value) }]\n    }\n    case 'rotateY': {\n      return [{ rotateY: angleToString(fn.value) }]\n    }\n    case 'scale': {\n      const [x, y] = fn.value\n      return [{ scaleX: numberOrPercentageToNumber(x) }, { scaleY: numberOrPercentageToNumber(y) }]\n    }\n    case 'scaleX': {\n      return [{ scaleX: numberOrPercentageToNumber(fn.value) }]\n    }\n    case 'scaleY': {\n      return [{ scaleY: numberOrPercentageToNumber(fn.value) }]\n    }\n    case 'translateX': {\n      return [{ translateX: lengthOrPercentToNumber(fn.value) }]\n    }\n    case 'translateY': {\n      return [{ translateY: lengthOrPercentToNumber(fn.value) }]\n    }\n    case 'translate': {\n      const [x, y] = fn.value\n      const out: RnTransformRecord[] = [{ translateX: lengthOrPercentToNumber(x) }]\n      if (y) out.push({ translateY: lengthOrPercentToNumber(y) })\n      return out\n    }\n    case 'translate3d': {\n      const [x, y] = fn.value\n      return [{ translateX: lengthOrPercentToNumber(x) }, { translateY: lengthOrPercentToNumber(y) }]\n    }\n    case 'skew': {\n      const [x, y] = fn.value\n      const out: RnTransformRecord[] = [{ skewX: angleToString(x) }]\n      if (y) out.push({ skewY: angleToString(y) })\n      return out\n    }\n    case 'skewX': {\n      return [{ skewX: angleToString(fn.value) }]\n    }\n    case 'skewY': {\n      return [{ skewY: angleToString(fn.value) }]\n    }\n    default: {\n      // RN doesn't have a direct equivalent for `matrix()` / `matrix3d()` /\n      // `perspective()` at the transform-op level — skip silently. Tailwind's\n      // generated transforms stay within rotate/translate/scale/skew.\n      return null\n    }\n  }\n}\n\n/**\n * Serialize a typed angle into the CSS degree string RN accepts\n * (`'45deg'`, `'0.5turn'` → `'180deg'`).\n * @param angle Typed angle.\n * @returns Degree string.\n */\nfunction angleToString(angle: Angle): string {\n  switch (angle.type) {\n    case 'deg': {\n      return `${formatNumber(angle.value)}deg`\n    }\n    case 'rad': {\n      return `${formatNumber((angle.value * 180) / Math.PI)}deg`\n    }\n    case 'grad': {\n      return `${formatNumber((angle.value * 360) / 400)}deg`\n    }\n    case 'turn': {\n      return `${formatNumber(angle.value * 360)}deg`\n    }\n    default: {\n      return '0deg'\n    }\n  }\n}\n\n/**\n * Convert a `NumberOrPercentage` to a plain number. Percentages become\n * their fractional equivalent (e.g. `50%` → `0.5`).\n * @param value Typed value.\n * @returns Plain number.\n */\nfunction numberOrPercentageToNumber(value: NumberOrPercentage): number {\n  if (value.type === 'percentage') return value.value\n  return value.value\n}\n\n/**\n * Convert a length-or-percentage used by translate into the shape RN\n * accepts (`number` for px, `string` for `%`). Percentages stay as\n * strings so RN layout can resolve them against the element size.\n * @param value Typed length or percentage.\n * @returns RN-style translate value.\n */\nfunction lengthOrPercentToNumber(value: DimensionPercent | { type: 'value'; value: LengthValue }): number | string {\n  if (value.type === 'dimension') return lengthToPx(value.value)\n  if (value.type === 'value') return lengthToPx(value.value)\n  if (value.type === 'percentage') return `${formatNumber(value.value * 100)}%`\n  return 0\n}\n\n/**\n * Render a number without trailing IEEE noise.\n * @param value Number to format.\n * @returns Compact string form.\n */\nfunction formatNumber(value: number): string {\n  const rounded = Math.round(value * 10_000) / 10_000\n  return String(rounded)\n}\n\n/**\n * Convert lightningcss's typed `transform: ...` value into RN's\n * `transform: [{ op: value }, ...]` array. RN supports a restricted subset\n * of CSS transforms — this function picks out the ones it actually\n * handles and drops the rest.\n *\n * Reanimated v4's CSS engine reads this same array shape, so the output\n * is drop-in for both static RN `style` props and `Animated.View` styles.\n * @param fns Typed transform function list.\n * @returns Zero-or-one RN entry with the `transform` array.\n */\nexport function transformFunctionsToEntries(fns: readonly Transform[]): readonly RNEntry[] {\n  const ops: RnTransformRecord[] = []\n  for (const fn of fns) {\n    const mapped = mapTransformFunction(fn)\n    if (mapped) ops.push(...mapped)\n  }\n  if (ops.length === 0) return []\n  return [['transform', ops]]\n}\n\n/**\n * Convert Tailwind v4's typed `rotate: ...` (individual property) into\n * the RN transform array. Tailwind's `rotate-*` utilities emit this\n * property rather than the classic `transform: rotate(...)` shorthand.\n * @param value Typed rotate value.\n * @returns Zero-or-one RN entry.\n */\nexport function rotateToEntries(value: Rotate | 'none'): readonly RNEntry[] {\n  if (value === 'none') return []\n  return [['transform', [{ rotate: angleToString(value.angle) }]]]\n}\n\n/**\n * Convert Tailwind v4's typed `translate: ...` into the RN transform\n * array. Both axes are emitted as separate ops so each is independently\n * animatable by Reanimated.\n * @param value Typed translate value.\n * @returns Zero-or-one RN entry.\n */\nexport function translateToEntries(value: Translate | 'none'): readonly RNEntry[] {\n  if (value === 'none') return []\n  const ops: RnTransformRecord[] = [{ translateX: lengthOrPercentToNumber(value.x) }]\n  const yNumber = lengthOrPercentToNumber(value.y)\n  if (yNumber !== 0) ops.push({ translateY: yNumber })\n  return [['transform', ops]]\n}\n\n/**\n * Convert Tailwind v4's typed `scale: ...` into the RN transform array.\n * @param value Typed scale value.\n * @returns Zero-or-one RN entry.\n */\nexport function scaleToEntries(value: Scale | 'none'): readonly RNEntry[] {\n  if (value === 'none') return []\n  return [['transform', [{ scaleX: numberOrPercentageToNumber(value.x) }, { scaleY: numberOrPercentageToNumber(value.y) }]]]\n}\n"],"names":[],"mappings":"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"}

package/lib/esm/core/parser/tw-parser.d.ts

@@ -0,0 +1,210 @@
+import { type SourceEntry } from '@tailwindcss/oxide';
+import { type GradientAtomInfo } from './gradient';
+import { type HapticRequest } from './haptics';
+import type { RNStyle } from './types';
+/** Parser configuration — one instance per Metro session, theme CSS fixed. */
+export interface TailwindParserConfig {
+    /**
+     * Theme CSS passed to `@tailwindcss/node`'s compiler. Typically the
+     * user's `global.css`. We append `theme(inline)` to the tailwindcss
+     * import so Tailwind resolves every `var(--theme-token)` at compile
+     * time — that gives lightningcss fully-typed values (integers / rems /
+     * colors) instead of unresolved `var()` references.
+     */
+    themeCss: string;
+    /**
+     * Glob sources the oxide Scanner walks at project-scan time
+     * (`parseProject()`). Typically
+     * `[{ base: projectRoot, pattern: '**\/*.{ts,tsx,js,jsx}', negated: false }]`
+     * plus negated globs for `node_modules` and the rnwind cache dir.
+     *
+     * When omitted, the scanner has no sources and `parseProject()`
+     * returns an empty result — `parseAtoms()` (per-file, content-driven)
+     * still works without sources.
+     */
+    sources?: readonly SourceEntry[];
+}
+/** Per-call inputs — Metro hands us file content + filename; we derive the extension. */
+export interface ParseOptions {
+    content: string;
+    extension: string;
+}
+/** One parsed keyframe step — offset plus the RN style at that offset. */
+export interface KeyframeStep {
+    offset: string;
+    style: RNStyle;
+}
+/** One parsed `@keyframes` animation block. */
+export interface KeyframeBlock {
+    name: string;
+    steps: KeyframeStep[];
+}
+/** Interactive variant ('active' / 'focus') an `active:`/`focus:` atom carries. */
+export type InteractiveStateTag = 'active' | 'focus';
+/**
+ * Per-scheme resolved style for a single utility class. Keys are scheme
+ * names declared via `@variant <name>` in the theme CSS (or the synthetic
+ * `'base'` scheme for themes without variants). Values are the RN style
+ * object under that scheme.
+ *
+ * The reserved `__state` key is set on `active:` / `focus:` atoms so
+ * the build-side style-builder can tag the atom for `precomputeHoist`
+ * — which routes interactive atoms into the stated-hoist's 4-state
+ * precompute. Standard atoms have no `__state`.
+ */
+export type SchemedStyle = Readonly<Record<string, RNStyle>> & {
+    /** Interactive-state gate set by `active:` / `focus:` variants. */
+    readonly __state?: InteractiveStateTag;
+};
+/** Full result of one `parseAtoms` call. */
+export interface ParsedOutput {
+    /** Resolved RN style per utility class, per declared scheme. */
+    atoms: Map<string, SchemedStyle>;
+    /** `@keyframes <name> { ... }` blocks the candidates pulled in. */
+    keyframes: Map<string, KeyframeBlock>;
+    /** `@property --x { initial-value: y }` declared custom-property defaults. */
+    propertyDefaults: Map<string, string>;
+    /**
+     * Gradient metadata per atom, for atoms that play a role in a
+     * Tailwind v4 gradient (`from-*`, `via-*`, `to-*`, `bg-gradient-to-*`,
+     * `bg-linear-to-*`). The transformer reads this map to extract
+     * `colors / start / end` props at JSX-rewrite time. Regular non-
+     * gradient atoms don't appear here.
+     */
+    gradientAtoms: Map<string, GradientAtomInfo>;
+    /**
+     * Haptic metadata per atom for classes that emit a
+     * `--rnwind-haptic` marker. The transformer reads this map to
+     * strip the atom from the className and wire a mount-time or
+     * press-time call into the `onHaptics` callback registered on
+     * `<SchemeProvider>`.
+     */
+    hapticAtoms: Map<string, HapticRequest>;
+    /** Candidates oxide surfaced, in document order. */
+    candidates: readonly string[];
+    /** Every scheme the theme declares (or `['base']` when there are no `@variant` blocks). */
+    schemes: readonly string[];
+    /**
+     * Responsive breakpoint name → minimum-width threshold (px). Pulled from
+     * `--breakpoint-*` tokens in the compiled `:root` block, so both
+     * Tailwind defaults (`sm`, `md`, `lg`, `xl`, `2xl`) and any user
+     * override (e.g. `--breakpoint-3xl: 120rem`) land here. Used by the
+     * style-builder to emit `registerBreakpoints({...})` in the manifest
+     * so the runtime can filter `md:*` / `lg:*` atoms based on the
+     * provider's `windowWidth`.
+     */
+    breakpoints: ReadonlyMap<string, number>;
+}
+/**
+ * Parses one source file's Tailwind usage into RN-ready style objects.
+ *
+ * Pipeline:
+ *  1. `@tailwindcss/oxide` Scanner finds every Tailwind candidate.
+ *  2. `@tailwindcss/node` compiler emits CSS for those candidates with
+ *     theme tokens inlined.
+ *  3. lightningcss `transform` + typed visitor walks the emitted CSS:
+ *     - `style` rules → per-class RN-style object.
+ *     - `@keyframes` rules → per-name step map (Reanimated-ready).
+ *     - `@property` rules → custom-property initial values.
+ *
+ * One instance holds one Scanner + one lazily-built compiler so repeated
+ * calls share upstream state. Theme CSS is fixed at construction — theme
+ * edits require a new parser.
+ */
+export declare class TailwindParser {
+    private readonly config;
+    private readonly scanner;
+    private compiler;
+    private readonly themeSchemes;
+    private readonly schemeAliases;
+    /**
+     * Scheme names declared via `@custom-variant <name> …;`. A scheme
+     * listed here but absent from {@link themeSchemes} (no `@variant`
+     * override block) draws its values from the base `@theme` — the
+     * standard Tailwind v4 "light defaults + dark override" shape.
+     */
+    private readonly customVariantSchemes;
+    /**
+     * Memoise `resolveCandidates` results by candidate-list fingerprint.
+     * Fast Refresh hits this on every save: oxide's scan is cheap, but
+     * the LightningCSS visitor walk over the compiled CSS is ~2ms per
+     * file. A file whose `className` literals didn't change returns the
+     * SAME candidate set, so the second `parseAtoms` call returns the
+     * cached `ParsedOutput` — zero compile, zero visitor walk.
+     *
+     * Theme CSS changes build a new `TailwindParser` (from
+     * `getRnwindState` detecting the hash shift), so this cache is
+     * naturally invalidated — no stale-theme values leak through.
+     */
+    private readonly parseCache;
+    /**
+     * Build a parser bound to a theme CSS source. `@theme` and
+     * `@variant` blocks are extracted eagerly into a scheme table the
+     * visitor consults when resolving `var(--x)` references.
+     * @param config Parser configuration.
+     */
+    constructor(config: TailwindParserConfig);
+    /**
+     * Schemes declared by the user — the union of every `@custom-variant
+     * <name>` declaration and every `@variant <name>` block, or just
+     * `['base']` for themes without any. Used to decide how many
+     * per-scheme buckets the per-atom resolver fills. Exposed publicly so
+     * Metro integration can hand the names to the `.d.ts` generator
+     * without a full parse.
+     *
+     * Both sources matter. `@variant` blocks alone miss the common
+     * Tailwind v4 shape where the light palette sits in the base `@theme`
+     * and only `@variant dark` overrides it: there `light` exists solely
+     * as a `@custom-variant` and would otherwise be dropped, collapsing
+     * every themed atom to a single bucket that can't switch.
+     * `@custom-variant` order wins (it's where users enumerate their
+     * schemes); any `@variant`-only scheme is appended after.
+     * @returns Scheme names.
+     */
+    get declaredSchemes(): readonly string[];
+    /**
+     * Build an effective var table for one scheme — base vars overridden by
+     * variant vars. When the scheme IS `'base'` (no variants declared), the
+     * base table is returned unchanged.
+     * @param scheme Scheme name.
+     * @returns Effective var name → value lookup for the scheme.
+     */
+    private effectiveVars;
+    /**
+     * Build the Tailwind compiler on first use and cache it. The theme CSS
+     * gets a `theme(inline)` modifier on its `@import 'tailwindcss'` so
+     * lightningcss sees resolved colors/lengths instead of `var()` refs.
+     * @returns Cached compiler instance.
+     */
+    private ensureCompiler;
+    /**
+     * Parse one file's Tailwind usage into the full typed result.
+     * @param options Source content + extension.
+     * @param options.content Raw source text to scan for Tailwind candidates.
+     * @param options.extension File extension (`tsx`, `ts`, `jsx`, `js`) — feeds oxide's tokenizer.
+     * @returns RN atoms, keyframes, property defaults, candidates list.
+     */
+    parseAtoms({ content, extension }: ParseOptions): Promise<ParsedOutput>;
+    /**
+     * Scan every source file the Scanner was configured to watch via
+     * `sources` and resolve the union of candidates in one pass. Used by
+     * `UnionBuilder` at Metro startup (and on first worker access) to
+     * populate the complete atom registry before ANY per-file transform
+     * has run — so scheme files never ship a partial view of the theme.
+     *
+     * Hot-reload path uses `parseAtoms` for the per-file delta; this one
+     * only runs once per parser instance (and whenever the parser is
+     * rebuilt due to a theme CSS change).
+     * @returns Full RN atoms, keyframes, property defaults for every
+     *   candidate discovered across the configured sources.
+     */
+    parseProject(): Promise<ParsedOutput>;
+    /**
+     * Compile + typed-visit the given candidate class names. Shared
+     * implementation for both `parseAtoms` (single file) and
+     * `parseProject` (whole project).
+     * @param candidates Class-name candidates the oxide Scanner produced.
+     * @returns Fully-typed parser result.
+     */
+    private resolveCandidates;
+}