rnwind 0.0.1 → 0.0.2

package/lib/cjs/core/parser/motion-dispatcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-dispatcher.cjs","sources":["../../../../../src/core/parser/motion-dispatcher.ts"],"sourcesContent":["import type { Declaration as LcDeclaration } from 'lightningcss'\nimport {\n  animationDelayEntries,\n  animationDirectionEntries,\n  animationDurationEntries,\n  animationFillModeEntries,\n  animationIterationCountEntries,\n  animationNameEntries,\n  animationPlayStateEntries,\n  animationShorthandToEntries,\n  animationTimingFunctionEntries,\n  transitionDelayEntries,\n  transitionDurationEntries,\n  transitionPropertyEntries,\n  transitionShorthandToEntries,\n  transitionTimingFunctionEntries,\n} from './animation'\nimport { rotateToEntries, scaleToEntries, transformFunctionsToEntries, translateToEntries } from './transform'\nimport type { RNEntry } from './types'\n\n/**\n * Dispatch motion-adjacent declarations (animation/transition/transform)\n * to their typed handlers. Returns `null` when the declaration isn't\n * one this dispatcher handles, so the caller can fall through to its\n * main switch.\n * @param decl One lightningcss declaration.\n * @returns RN entries when the property matched, else `null`.\n */\nexport function dispatchMotionDeclaration(decl: LcDeclaration): readonly RNEntry[] | null {\n  switch (decl.property) {\n    case 'animation': {\n      return animationShorthandToEntries(decl.value)\n    }\n    case 'animation-name': {\n      return animationNameEntries(decl.value)\n    }\n    case 'animation-duration': {\n      return animationDurationEntries(decl.value)\n    }\n    case 'animation-timing-function': {\n      return animationTimingFunctionEntries(decl.value)\n    }\n    case 'animation-iteration-count': {\n      return animationIterationCountEntries(decl.value)\n    }\n    case 'animation-delay': {\n      return animationDelayEntries(decl.value)\n    }\n    case 'animation-direction': {\n      return animationDirectionEntries(decl.value)\n    }\n    case 'animation-fill-mode': {\n      return animationFillModeEntries(decl.value)\n    }\n    case 'animation-play-state': {\n      return animationPlayStateEntries(decl.value)\n    }\n    case 'transition': {\n      return transitionShorthandToEntries(decl.value)\n    }\n    case 'transition-property': {\n      return transitionPropertyEntries(decl.value)\n    }\n    case 'transition-duration': {\n      return transitionDurationEntries(decl.value)\n    }\n    case 'transition-timing-function': {\n      return transitionTimingFunctionEntries(decl.value)\n    }\n    case 'transition-delay': {\n      return transitionDelayEntries(decl.value)\n    }\n    case 'transform': {\n      return transformFunctionsToEntries(decl.value)\n    }\n    case 'rotate': {\n      return rotateToEntries(decl.value)\n    }\n    case 'translate': {\n      return translateToEntries(decl.value)\n    }\n    case 'scale': {\n      return scaleToEntries(decl.value)\n    }\n    default: {\n      return null\n    }\n  }\n}\n"],"names":["animationShorthandToEntries","animationNameEntries","animationDurationEntries","animationTimingFunctionEntries","animationIterationCountEntries","animationDelayEntries","animationDirectionEntries","animationFillModeEntries","animationPlayStateEntries","transitionShorthandToEntries","transitionPropertyEntries","transitionDurationEntries","transitionTimingFunctionEntries","transitionDelayEntries","transformFunctionsToEntries","rotateToEntries","translateToEntries","scaleToEntries"],"mappings":";;;;;AAoBA;;;;;;;AAOG;AACG,SAAU,yBAAyB,CAAC,IAAmB,EAAA;AAC3D,IAAA,QAAQ,IAAI,CAAC,QAAQ;QACnB,KAAK,WAAW,EAAE;AAChB,YAAA,OAAOA,qCAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;QAChD;QACA,KAAK,gBAAgB,EAAE;AACrB,YAAA,OAAOC,8BAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QACzC;QACA,KAAK,oBAAoB,EAAE;AACzB,YAAA,OAAOC,kCAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7C;QACA,KAAK,2BAA2B,EAAE;AAChC,YAAA,OAAOC,wCAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QACnD;QACA,KAAK,2BAA2B,EAAE;AAChC,YAAA,OAAOC,wCAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QACnD;QACA,KAAK,iBAAiB,EAAE;AACtB,YAAA,OAAOC,+BAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1C;QACA,KAAK,qBAAqB,EAAE;AAC1B,YAAA,OAAOC,mCAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9C;QACA,KAAK,qBAAqB,EAAE;AAC1B,YAAA,OAAOC,kCAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7C;QACA,KAAK,sBAAsB,EAAE;AAC3B,YAAA,OAAOC,mCAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9C;QACA,KAAK,YAAY,EAAE;AACjB,YAAA,OAAOC,sCAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD;QACA,KAAK,qBAAqB,EAAE;AAC1B,YAAA,OAAOC,mCAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9C;QACA,KAAK,qBAAqB,EAAE;AAC1B,YAAA,OAAOC,mCAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9C;QACA,KAAK,4BAA4B,EAAE;AACjC,YAAA,OAAOC,yCAA+B,CAAC,IAAI,CAAC,KAAK,CAAC;QACpD;QACA,KAAK,kBAAkB,EAAE;AACvB,YAAA,OAAOC,gCAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C;QACA,KAAK,WAAW,EAAE;AAChB,YAAA,OAAOC,qCAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;QAChD;QACA,KAAK,QAAQ,EAAE;AACb,YAAA,OAAOC,yBAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QACpC;QACA,KAAK,WAAW,EAAE;AAChB,YAAA,OAAOC,4BAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QACvC;QACA,KAAK,OAAO,EAAE;AACZ,YAAA,OAAOC,wBAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC;QACA,SAAS;AACP,YAAA,OAAO,IAAI;QACb;;AAEJ;;;;"}

package/lib/cjs/core/parser/motion-dispatcher.d.ts

@@ -0,0 +1,11 @@
+import type { Declaration as LcDeclaration } from 'lightningcss';
+import type { RNEntry } from './types';
+/**
+ * Dispatch motion-adjacent declarations (animation/transition/transform)
+ * to their typed handlers. Returns `null` when the declaration isn't
+ * one this dispatcher handles, so the caller can fall through to its
+ * main switch.
+ * @param decl One lightningcss declaration.
+ * @returns RN entries when the property matched, else `null`.
+ */
+export declare function dispatchMotionDeclaration(decl: LcDeclaration): readonly RNEntry[] | null;

package/lib/cjs/core/parser/property.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+/**
+ * Serialize an `@property --x { initial-value: … }` body to plain text —
+ * enough for the downstream var() resolver to use as a fallback.
+ * @param initial Parsed-component AST node (or null when absent).
+ * @returns CSS-value string, or `null` when missing / unsupported shape.
+ */
+function serializeInitialValue(initial) {
+    if (!initial)
+        return null;
+    if (initial.type === 'literal')
+        return initial.value;
+    if (initial.type === 'custom-ident')
+        return initial.value;
+    if (initial.type === 'string')
+        return initial.value;
+    return null;
+}
+
+exports.serializeInitialValue = serializeInitialValue;
+//# sourceMappingURL=property.cjs.map

package/lib/cjs/core/parser/property.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.cjs","sources":["../../../../../src/core/parser/property.ts"],"sourcesContent":["import type { ParsedComponent } from 'lightningcss'\n\n/**\n * Serialize an `@property --x { initial-value: … }` body to plain text —\n * enough for the downstream var() resolver to use as a fallback.\n * @param initial Parsed-component AST node (or null when absent).\n * @returns CSS-value string, or `null` when missing / unsupported shape.\n */\nexport function serializeInitialValue(initial: ParsedComponent | null | undefined): string | null {\n  if (!initial) return null\n  if (initial.type === 'literal') return initial.value\n  if (initial.type === 'custom-ident') return initial.value\n  if (initial.type === 'string') return initial.value\n  return null\n}\n"],"names":[],"mappings":";;AAEA;;;;;AAKG;AACG,SAAU,qBAAqB,CAAC,OAA2C,EAAA;AAC/E,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,IAAI;AACzB,IAAA,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,KAAK;AACpD,IAAA,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,OAAO,CAAC,KAAK;AACzD,IAAA,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,KAAK;AACnD,IAAA,OAAO,IAAI;AACb;;;;"}

package/lib/cjs/core/parser/property.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedComponent } from 'lightningcss';
+/**
+ * Serialize an `@property --x { initial-value: … }` body to plain text —
+ * enough for the downstream var() resolver to use as a fallback.
+ * @param initial Parsed-component AST node (or null when absent).
+ * @returns CSS-value string, or `null` when missing / unsupported shape.
+ */
+export declare function serializeInitialValue(initial: ParsedComponent | null | undefined): string | null;

package/lib/cjs/core/parser/safe-area.cjs

@@ -0,0 +1,404 @@
+'use strict';
+
+/**
+ * Detect `env(safe-area-inset-*)` usage in a lightningcss TokenOrValue
+ * tree and convert the containing declaration into a runtime-resolved
+ * {@link SafeAreaMarker}.
+ *
+ * Three shapes the NativeWind-compatible `*-safe` utilities produce
+ * through Tailwind v4's compiler:
+ *  - Pure `env(safe-area-inset-top)` → `{ __safe: 't' }`
+ *  - `max(env(safe-area-inset-top), 16px)` → `{ __safe: 't', or: 16 }`
+ *  - `calc(env(safe-area-inset-top) + 16px)` → `{ __safe: 't', offset: 16 }`
+ *
+ * The `h-screen-safe` / `min-h-screen-safe` / `max-h-screen-safe` shape
+ * — `calc(100vh - (env(top) + env(bottom)))` — reports as
+ * `{ __safe: 'screen-minus-y' }`; the runtime resolves against
+ * `Dimensions.get('window').height` minus the current top + bottom
+ * insets.
+ *
+ * Unrecognised compound shapes (e.g. `env(safe-area-inset-top, 12px)`
+ * with a fallback) return `null` so the caller falls back to the
+ * regular token-serialisation path.
+ */
+/** Map UA env names to the compact side tag used in the marker. */
+const SIDE_TAG = {
+    'safe-area-inset-top': 't',
+    'safe-area-inset-right': 'r',
+    'safe-area-inset-bottom': 'b',
+    'safe-area-inset-left': 'l',
+};
+/** Rem → px factor used across the parser (matches `tokens.ts`). */
+const REM_TO_PX = 16;
+/**
+ * Try to compile a token list into a {@link SafeAreaMarker}. Returns
+ * `null` when the tokens don't match any recognised safe-area pattern
+ * — the caller should fall back to the regular unparsed-value path.
+ * @param tokens Declaration value token list from lightningcss.
+ * @param themeVars
+ * @returns Marker object, or `null`.
+ */
+function detectSafeAreaMarker(tokens, themeVars) {
+    const nonWs = stripWhitespace(tokens);
+    if (nonWs.length === 0)
+        return null;
+    // Shape 1: pure env(safe-area-inset-*)
+    if (nonWs.length === 1) {
+        const side = envSide(nonWs[0]);
+        if (side !== null)
+            return { __safe: side };
+    }
+    // Shape 2 / 3: max(env(...), n) or calc(env(...) + n)
+    if (nonWs.length === 1 && isFunction(nonWs[0])) {
+        const inner = functionInner(nonWs[0]);
+        if (inner) {
+            const marker = tryFromFunction(inner.name, inner.args, themeVars);
+            if (marker)
+                return marker;
+        }
+    }
+    return null;
+}
+/**
+ * Short-circuit whether this token is a `function` token.
+ * @param token
+ */
+function isFunction(token) {
+    return token.type === 'function';
+}
+/**
+ * Pull `(name, args-without-whitespace)` out of a function token.
+ * @param token A function-type TokenOrValue.
+ * @returns Inner record, or null when the shape is unexpected.
+ */
+function functionInner(token) {
+    if (token.type !== 'function')
+        return null;
+    return { name: token.value.name, args: token.value.arguments };
+}
+/**
+ * Pattern-match `max(env(...), n)` / `calc(env(...) + n)` / nested
+ * screen-minus-y calc. Operates on the function's already-whitespace-
+ * trimmed arg list so every branch can index by position.
+ * @param name Function name (`max` / `calc`).
+ * @param args Raw argument tokens (whitespace still present).
+ * @param themeVars
+ * @returns Marker, or null when not recognised.
+ */
+function tryFromFunction(name, args, themeVars) {
+    if (name === 'max')
+        return tryMax(args, themeVars);
+    if (name === 'calc')
+        return tryCalc(args, themeVars);
+    return null;
+}
+/**
+ * `max(env(safe-area-inset-*), <length>)` — Tailwind v4's `*-safe-or-n`
+ * shape. Optionally `max(env(...), calc(var(--spacing) * n))` — the
+ * calc inside has already been resolved to a bare length by Tailwind's
+ * compiler step.
+ * @param args Whitespace-preserving argument tokens.
+ * @param themeVars
+ * @returns Marker, or null.
+ */
+function tryMax(args, themeVars) {
+    const parts = splitTopLevelComma(args);
+    if (parts.length !== 2)
+        return null;
+    const firstToken = onlyNonWhitespace(parts[0]);
+    if (!firstToken)
+        return null;
+    const firstSide = envSide(firstToken);
+    if (firstSide === null)
+        return null;
+    const rhs = coerceLengthPx(parts[1], themeVars);
+    if (rhs === null)
+        return null;
+    return { __safe: firstSide, or: rhs };
+}
+/**
+ * Recognise:
+ *  - `calc(env(safe-area-inset-*) + n)` — `*-safe-offset-n`
+ *  - `calc(100vh - (env(...-top) + env(...-bottom)))` — `h-screen-safe`
+ * @param args Whitespace-preserving calc argument tokens.
+ * @param themeVars
+ * @returns Marker, or null.
+ */
+function tryCalc(args, themeVars) {
+    const [signIndex, sign] = findTopLevelPlusOrMinus(args);
+    if (signIndex === -1)
+        return reduceNestedCalc(args, themeVars);
+    const lhs = stripWhitespace(args.slice(0, signIndex));
+    const rhs = stripWhitespace(args.slice(signIndex + 1));
+    const offset = matchOffset(lhs, rhs, sign, themeVars);
+    if (offset)
+        return offset;
+    if (sign === '-' && isViewportHeightHundred(lhs) && isParenthesisedTopBottomSum(rhs))
+        return { __safe: 'screen-minus-y' };
+    return null;
+}
+/**
+ * Fall-through arm of {@link tryCalc}: when there's no +/− at the calc
+ * body's top level, try to interpret the whole body as a nested
+ * function (e.g. a bare `calc(max(...))`).
+ * @param args Calc arguments.
+ * @param themeVars Optional theme-vars table for length resolution.
+ * @returns Marker or null.
+ */
+function reduceNestedCalc(args, themeVars) {
+    const inner = onlyNonWhitespace(args);
+    if (!inner)
+        return null;
+    return detectSafeAreaMarker([inner], themeVars);
+}
+/**
+ * Try to match `calc(env(side) ± amount)` against the two-side split of
+ * the calc body. Returns a marker with positive / negative `offset`
+ * based on the sign, or null when the shape doesn't fit.
+ * @param lhs Left-hand tokens (whitespace already stripped).
+ * @param rhs Right-hand tokens (whitespace already stripped).
+ * @param sign The `+` or `-` delim captured between them.
+ * @param themeVars Optional theme-vars table.
+ * @returns Offset marker, or null.
+ */
+function matchOffset(lhs, rhs, sign, themeVars) {
+    if (!sign || lhs.length !== 1 || rhs.length !== 1)
+        return null;
+    const side = envSide(lhs[0]);
+    if (side === null)
+        return null;
+    const amount = coerceLengthPx([rhs[0]], themeVars);
+    if (amount === null)
+        return null;
+    return { __safe: side, offset: sign === '+' ? amount : -amount };
+}
+/**
+ * Check whether a token is the env() that names one of the four safe-area sides.
+ * @param token One TokenOrValue.
+ * @returns The compact side tag, or `null` when the token isn't a safe-area env reference.
+ */
+function envSide(token) {
+    if (token.type !== 'env')
+        return null;
+    const { name } = token.value;
+    if (name.type !== 'ua')
+        return null;
+    return SIDE_TAG[name.value] ?? null;
+}
+/**
+ * Drop whitespace / comment tokens from a list so downstream branches
+ * can pattern-match by index without counting spaces.
+ * @param tokens Raw token list.
+ * @returns Copy with whitespace tokens removed.
+ */
+function stripWhitespace(tokens) {
+    const out = [];
+    for (const token of tokens) {
+        if (isWhitespaceToken(token))
+            continue;
+        out.push(token);
+    }
+    return out;
+}
+/**
+ * Like {@link stripWhitespace} but returns the single non-whitespace
+ * token (or null when there's zero or more than one).
+ * @param tokens Raw token list.
+ * @returns The single meaningful token, or null.
+ */
+function onlyNonWhitespace(tokens) {
+    const stripped = stripWhitespace(tokens);
+    return stripped.length === 1 ? stripped[0] : null;
+}
+/**
+ * Whether the token is pure whitespace / comment — ignorable when
+ * matching by position.
+ * @param token One TokenOrValue.
+ * @returns True when the token carries no semantic value.
+ */
+function isWhitespaceToken(token) {
+    if (token.type !== 'token')
+        return false;
+    const { value } = token;
+    return value.type === 'white-space' || value.type === 'comment';
+}
+/**
+ * Split `a, b` top-level argument lists into their slices. Respects
+ * nested function/paren groups so commas inside an inner `calc(a, b)`
+ * don't cause an outer split.
+ * @param args Raw argument token list.
+ * @returns Array of slices (one per top-level comma-separated segment).
+ */
+function splitTopLevelComma(args) {
+    // Functions already arrive as atomic `{type:'function', value}` nodes,
+    // so commas inside them are never in `args` — a flat scan for the
+    // raw `comma` token is enough.
+    const parts = [[]];
+    for (const token of args) {
+        if (token.type === 'token' && token.value.type === 'comma') {
+            parts.push([]);
+            continue;
+        }
+        parts.at(-1).push(token);
+    }
+    return parts;
+}
+/**
+ * Find the first top-level `+` / `-` delim in a calc body.
+ * @param args Raw argument token list.
+ * @returns Tuple of `[index, sign]` or `[-1, null]` when not found.
+ */
+function findTopLevelPlusOrMinus(args) {
+    for (const [index, argument] of args.entries()) {
+        const token = argument;
+        if (token.type !== 'token')
+            continue;
+        if (token.value.type !== 'delim')
+            continue;
+        const delim = token.value.value;
+        if (delim === '+' || delim === '-')
+            return [index, delim];
+    }
+    return [-1, null];
+}
+/**
+ * Coerce a token list that should represent a CSS length (px / rem /
+ * integer-number with no unit) into a px value.
+ * @param tokens Tokens for the length fragment.
+ * @param themeVars
+ * @returns Px value, or null when the shape is unrecognised.
+ */
+function coerceLengthPx(tokens, themeVars) {
+    const stripped = stripWhitespace(tokens);
+    if (stripped.length !== 1)
+        return null;
+    return coerceTokenToPx(stripped[0], themeVars);
+}
+/**
+ * Convert one token to a px number, handling the lengths Tailwind v4
+ * commonly emits after compile: `length` (px/rem), bare numbers,
+ * `calc(0.25rem * 4)` nested functions.
+ * @param token One TokenOrValue.
+ * @param themeVars
+ * @returns Px value, or null.
+ */
+function coerceTokenToPx(token, themeVars) {
+    if (token.type === 'length') {
+        const { unit, value } = token.value;
+        if (unit === 'px')
+            return value;
+        if (unit === 'rem' || unit === 'em')
+            return value * REM_TO_PX;
+        return null;
+    }
+    if (token.type === 'token' && token.value.type === 'number') {
+        return token.value.value;
+    }
+    if (token.type === 'function' && token.value.name === 'calc') {
+        return evaluateSimpleCalc(token.value.arguments, themeVars);
+    }
+    if (token.type === 'var')
+        return resolveVariableToPx(token.value.name.ident, themeVars);
+    return null;
+}
+/**
+ * Evaluate a trivial `calc(A * B)` where A / B are lengths or numbers
+ * Tailwind compiles down to — the exact shape `var(--spacing)` resolves
+ * to after `theme(inline)` substitution.
+ * @param args Raw calc argument token list.
+ * @param themeVars
+ * @returns Px value, or null.
+ */
+function evaluateSimpleCalc(args, themeVars) {
+    const stripped = stripWhitespace(args);
+    if (stripped.length === 3) {
+        const mul = stripped[1];
+        if (mul.type === 'token' && mul.value.type === 'delim' && mul.value.value === '*') {
+            const left = coerceTokenToPx(stripped[0], themeVars);
+            const right = coerceTokenToPx(stripped[2], themeVars);
+            if (left !== null && right !== null)
+                return left * right;
+        }
+    }
+    if (stripped.length === 1)
+        return coerceTokenToPx(stripped[0], themeVars);
+    return null;
+}
+/**
+ * Resolve a `var(--name)` reference to a px value using the supplied
+ * theme-var table. Returns null when the name isn't registered or the
+ * value isn't a recognisable length.
+ * @param name Custom-property name (with leading `--`).
+ * @param themeVars Lookup table (or undefined).
+ * @returns Px value, or null.
+ */
+function resolveVariableToPx(name, themeVars) {
+    if (!themeVars)
+        return null;
+    const raw = themeVars.get(name);
+    if (raw === undefined)
+        return null;
+    const trimmed = raw.trim();
+    if (trimmed.endsWith('rem')) {
+        const n = Number(trimmed.slice(0, -3));
+        return Number.isFinite(n) ? n * REM_TO_PX : null;
+    }
+    if (trimmed.endsWith('em')) {
+        const n = Number(trimmed.slice(0, -2));
+        return Number.isFinite(n) ? n * REM_TO_PX : null;
+    }
+    if (trimmed.endsWith('px')) {
+        const n = Number(trimmed.slice(0, -2));
+        return Number.isFinite(n) ? n : null;
+    }
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Whether the token list represents `100vh`.
+ * @param tokens Whitespace-stripped token list.
+ * @returns True when the only meaningful token is the length `100vh`.
+ */
+function isViewportHeightHundred(tokens) {
+    if (tokens.length !== 1)
+        return false;
+    const token = tokens[0];
+    if (token.type !== 'length')
+        return false;
+    return token.value.unit === 'vh' && token.value.value === 100;
+}
+/**
+ * Whether the rhs of `calc(100vh - <rhs>)` is the nested `(env(top) + env(bottom))`
+ * parenthesised sum Tailwind emits for `h-screen-safe` and siblings.
+ * @param tokens Whitespace-stripped rhs token list.
+ * @returns True on match.
+ */
+function isParenthesisedTopBottomSum(tokens) {
+    // lightningcss emits bare `(...)` as a `parenthesis-block` token
+    // followed by the inner tokens inline, then a `close-parenthesis`
+    // token at the matching depth. Strip whitespace + the grouping tokens
+    // and check that what remains is exactly `env(top) + env(bottom)`
+    // (either order).
+    const meaningful = [];
+    for (const token of tokens) {
+        if (isWhitespaceToken(token))
+            continue;
+        if (token.type === 'token') {
+            const t = token.value.type;
+            if (t === 'parenthesis-block' || t === 'close-parenthesis')
+                continue;
+        }
+        meaningful.push(token);
+    }
+    if (meaningful.length !== 3)
+        return false;
+    const plus = meaningful[1];
+    if (plus.type !== 'token' || plus.value.type !== 'delim' || plus.value.value !== '+')
+        return false;
+    const first = envSide(meaningful[0]);
+    const last = envSide(meaningful[2]);
+    return (first === 't' && last === 'b') || (first === 'b' && last === 't');
+}
+
+exports.detectSafeAreaMarker = detectSafeAreaMarker;
+//# sourceMappingURL=safe-area.cjs.map

package/lib/cjs/core/parser/safe-area.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-area.cjs","sources":["../../../../../src/core/parser/safe-area.ts"],"sourcesContent":["/**\n * Detect `env(safe-area-inset-*)` usage in a lightningcss TokenOrValue\n * tree and convert the containing declaration into a runtime-resolved\n * {@link SafeAreaMarker}.\n *\n * Three shapes the NativeWind-compatible `*-safe` utilities produce\n * through Tailwind v4's compiler:\n *  - Pure `env(safe-area-inset-top)` → `{ __safe: 't' }`\n *  - `max(env(safe-area-inset-top), 16px)` → `{ __safe: 't', or: 16 }`\n *  - `calc(env(safe-area-inset-top) + 16px)` → `{ __safe: 't', offset: 16 }`\n *\n * The `h-screen-safe` / `min-h-screen-safe` / `max-h-screen-safe` shape\n * — `calc(100vh - (env(top) + env(bottom)))` — reports as\n * `{ __safe: 'screen-minus-y' }`; the runtime resolves against\n * `Dimensions.get('window').height` minus the current top + bottom\n * insets.\n *\n * Unrecognised compound shapes (e.g. `env(safe-area-inset-top, 12px)`\n * with a fallback) return `null` so the caller falls back to the\n * regular token-serialisation path.\n */\n\nimport type { TokenOrValue } from 'lightningcss'\nimport type { SafeAreaMarker } from './types'\n\n/** Map UA env names to the compact side tag used in the marker. */\nconst SIDE_TAG: Record<string, SafeAreaMarker['__safe']> = {\n  'safe-area-inset-top': 't',\n  'safe-area-inset-right': 'r',\n  'safe-area-inset-bottom': 'b',\n  'safe-area-inset-left': 'l',\n}\n\n/** Rem → px factor used across the parser (matches `tokens.ts`). */\nconst REM_TO_PX = 16\n\n/**\n * Theme-var lookup table we optionally receive. Values are stored as\n * raw CSS value strings (`'0.25rem'`, `'#fff'`, …); the safe-area\n * detector only needs the ones that resolve to lengths.\n */\ntype ThemeVars = ReadonlyMap<string, string>\n\n/**\n * Try to compile a token list into a {@link SafeAreaMarker}. Returns\n * `null` when the tokens don't match any recognised safe-area pattern\n * — the caller should fall back to the regular unparsed-value path.\n * @param tokens Declaration value token list from lightningcss.\n * @param themeVars\n * @returns Marker object, or `null`.\n */\nfunction detectSafeAreaMarker(tokens: readonly TokenOrValue[], themeVars?: ThemeVars): SafeAreaMarker | null {\n  const nonWs = stripWhitespace(tokens)\n  if (nonWs.length === 0) return null\n\n  // Shape 1: pure env(safe-area-inset-*)\n  if (nonWs.length === 1) {\n    const side = envSide(nonWs[0]!)\n    if (side !== null) return { __safe: side }\n  }\n\n  // Shape 2 / 3: max(env(...), n) or calc(env(...) + n)\n  if (nonWs.length === 1 && isFunction(nonWs[0]!)) {\n    const inner = functionInner(nonWs[0]!)\n    if (inner) {\n      const marker = tryFromFunction(inner.name, inner.args, themeVars)\n      if (marker) return marker\n    }\n  }\n\n  return null\n}\n\n/**\n * Short-circuit whether this token is a `function` token.\n * @param token\n */\nfunction isFunction(token: TokenOrValue): boolean {\n  return token.type === 'function'\n}\n\n/**\n * Pull `(name, args-without-whitespace)` out of a function token.\n * @param token A function-type TokenOrValue.\n * @returns Inner record, or null when the shape is unexpected.\n */\nfunction functionInner(token: TokenOrValue): { name: string; args: readonly TokenOrValue[] } | null {\n  if (token.type !== 'function') return null\n  return { name: token.value.name, args: token.value.arguments }\n}\n\n/**\n * Pattern-match `max(env(...), n)` / `calc(env(...) + n)` / nested\n * screen-minus-y calc. Operates on the function's already-whitespace-\n * trimmed arg list so every branch can index by position.\n * @param name Function name (`max` / `calc`).\n * @param args Raw argument tokens (whitespace still present).\n * @param themeVars\n * @returns Marker, or null when not recognised.\n */\nfunction tryFromFunction(name: string, args: readonly TokenOrValue[], themeVars: ThemeVars | undefined): SafeAreaMarker | null {\n  if (name === 'max') return tryMax(args, themeVars)\n  if (name === 'calc') return tryCalc(args, themeVars)\n  return null\n}\n\n/**\n * `max(env(safe-area-inset-*), <length>)` — Tailwind v4's `*-safe-or-n`\n * shape. Optionally `max(env(...), calc(var(--spacing) * n))` — the\n * calc inside has already been resolved to a bare length by Tailwind's\n * compiler step.\n * @param args Whitespace-preserving argument tokens.\n * @param themeVars\n * @returns Marker, or null.\n */\nfunction tryMax(args: readonly TokenOrValue[], themeVars: ThemeVars | undefined): SafeAreaMarker | null {\n  const parts = splitTopLevelComma(args)\n  if (parts.length !== 2) return null\n  const firstToken = onlyNonWhitespace(parts[0]!)\n  if (!firstToken) return null\n  const firstSide = envSide(firstToken)\n  if (firstSide === null) return null\n  const rhs = coerceLengthPx(parts[1]!, themeVars)\n  if (rhs === null) return null\n  return { __safe: firstSide, or: rhs }\n}\n\n/**\n * Recognise:\n *  - `calc(env(safe-area-inset-*) + n)` — `*-safe-offset-n`\n *  - `calc(100vh - (env(...-top) + env(...-bottom)))` — `h-screen-safe`\n * @param args Whitespace-preserving calc argument tokens.\n * @param themeVars\n * @returns Marker, or null.\n */\nfunction tryCalc(args: readonly TokenOrValue[], themeVars: ThemeVars | undefined): SafeAreaMarker | null {\n  const [signIndex, sign] = findTopLevelPlusOrMinus(args)\n  if (signIndex === -1) return reduceNestedCalc(args, themeVars)\n  const lhs = stripWhitespace(args.slice(0, signIndex))\n  const rhs = stripWhitespace(args.slice(signIndex + 1))\n  const offset = matchOffset(lhs, rhs, sign, themeVars)\n  if (offset) return offset\n  if (sign === '-' && isViewportHeightHundred(lhs) && isParenthesisedTopBottomSum(rhs)) return { __safe: 'screen-minus-y' }\n  return null\n}\n\n/**\n * Fall-through arm of {@link tryCalc}: when there's no +/− at the calc\n * body's top level, try to interpret the whole body as a nested\n * function (e.g. a bare `calc(max(...))`).\n * @param args Calc arguments.\n * @param themeVars Optional theme-vars table for length resolution.\n * @returns Marker or null.\n */\nfunction reduceNestedCalc(args: readonly TokenOrValue[], themeVars: ThemeVars | undefined): SafeAreaMarker | null {\n  const inner = onlyNonWhitespace(args)\n  if (!inner) return null\n  return detectSafeAreaMarker([inner], themeVars)\n}\n\n/**\n * Try to match `calc(env(side) ± amount)` against the two-side split of\n * the calc body. Returns a marker with positive / negative `offset`\n * based on the sign, or null when the shape doesn't fit.\n * @param lhs Left-hand tokens (whitespace already stripped).\n * @param rhs Right-hand tokens (whitespace already stripped).\n * @param sign The `+` or `-` delim captured between them.\n * @param themeVars Optional theme-vars table.\n * @returns Offset marker, or null.\n */\nfunction matchOffset(\n  lhs: readonly TokenOrValue[],\n  rhs: readonly TokenOrValue[],\n  sign: '+' | '-' | null,\n  themeVars: ThemeVars | undefined,\n): SafeAreaMarker | null {\n  if (!sign || lhs.length !== 1 || rhs.length !== 1) return null\n  const side = envSide(lhs[0]!)\n  if (side === null) return null\n  const amount = coerceLengthPx([rhs[0]!], themeVars)\n  if (amount === null) return null\n  return { __safe: side, offset: sign === '+' ? amount : -amount }\n}\n\n/**\n * Check whether a token is the env() that names one of the four safe-area sides.\n * @param token One TokenOrValue.\n * @returns The compact side tag, or `null` when the token isn't a safe-area env reference.\n */\nfunction envSide(token: TokenOrValue): SafeAreaMarker['__safe'] | null {\n  if (token.type !== 'env') return null\n  const { name } = token.value\n  if (name.type !== 'ua') return null\n  return SIDE_TAG[name.value] ?? null\n}\n\n/**\n * Drop whitespace / comment tokens from a list so downstream branches\n * can pattern-match by index without counting spaces.\n * @param tokens Raw token list.\n * @returns Copy with whitespace tokens removed.\n */\nfunction stripWhitespace(tokens: readonly TokenOrValue[]): readonly TokenOrValue[] {\n  const out: TokenOrValue[] = []\n  for (const token of tokens) {\n    if (isWhitespaceToken(token)) continue\n    out.push(token)\n  }\n  return out\n}\n\n/**\n * Like {@link stripWhitespace} but returns the single non-whitespace\n * token (or null when there's zero or more than one).\n * @param tokens Raw token list.\n * @returns The single meaningful token, or null.\n */\nfunction onlyNonWhitespace(tokens: readonly TokenOrValue[]): TokenOrValue | null {\n  const stripped = stripWhitespace(tokens)\n  return stripped.length === 1 ? stripped[0]! : null\n}\n\n/**\n * Whether the token is pure whitespace / comment — ignorable when\n * matching by position.\n * @param token One TokenOrValue.\n * @returns True when the token carries no semantic value.\n */\nfunction isWhitespaceToken(token: TokenOrValue): boolean {\n  if (token.type !== 'token') return false\n  const { value } = token\n  return value.type === 'white-space' || value.type === 'comment'\n}\n\n/**\n * Split `a, b` top-level argument lists into their slices. Respects\n * nested function/paren groups so commas inside an inner `calc(a, b)`\n * don't cause an outer split.\n * @param args Raw argument token list.\n * @returns Array of slices (one per top-level comma-separated segment).\n */\nfunction splitTopLevelComma(args: readonly TokenOrValue[]): readonly TokenOrValue[][] {\n  // Functions already arrive as atomic `{type:'function', value}` nodes,\n  // so commas inside them are never in `args` — a flat scan for the\n  // raw `comma` token is enough.\n  const parts: TokenOrValue[][] = [[]]\n  for (const token of args) {\n    if (token.type === 'token' && token.value.type === 'comma') {\n      parts.push([])\n      continue\n    }\n    parts.at(-1)!.push(token)\n  }\n  return parts\n}\n\n/**\n * Find the first top-level `+` / `-` delim in a calc body.\n * @param args Raw argument token list.\n * @returns Tuple of `[index, sign]` or `[-1, null]` when not found.\n */\nfunction findTopLevelPlusOrMinus(args: readonly TokenOrValue[]): [number, '+' | '-' | null] {\n  for (const [index, argument] of args.entries()) {\n    const token = argument!\n    if (token.type !== 'token') continue\n    if (token.value.type !== 'delim') continue\n    const delim = token.value.value as string\n    if (delim === '+' || delim === '-') return [index, delim]\n  }\n  return [-1, null]\n}\n\n/**\n * Coerce a token list that should represent a CSS length (px / rem /\n * integer-number with no unit) into a px value.\n * @param tokens Tokens for the length fragment.\n * @param themeVars\n * @returns Px value, or null when the shape is unrecognised.\n */\nfunction coerceLengthPx(tokens: readonly TokenOrValue[], themeVars: ThemeVars | undefined): number | null {\n  const stripped = stripWhitespace(tokens)\n  if (stripped.length !== 1) return null\n  return coerceTokenToPx(stripped[0]!, themeVars)\n}\n\n/**\n * Convert one token to a px number, handling the lengths Tailwind v4\n * commonly emits after compile: `length` (px/rem), bare numbers,\n * `calc(0.25rem * 4)` nested functions.\n * @param token One TokenOrValue.\n * @param themeVars\n * @returns Px value, or null.\n */\nfunction coerceTokenToPx(token: TokenOrValue, themeVars: ThemeVars | undefined): number | null {\n  if (token.type === 'length') {\n    const { unit, value } = token.value\n    if (unit === 'px') return value\n    if (unit === 'rem' || unit === 'em') return value * REM_TO_PX\n    return null\n  }\n  if (token.type === 'token' && token.value.type === 'number') {\n    return token.value.value\n  }\n  if (token.type === 'function' && token.value.name === 'calc') {\n    return evaluateSimpleCalc(token.value.arguments, themeVars)\n  }\n  if (token.type === 'var') return resolveVariableToPx(token.value.name.ident, themeVars)\n  return null\n}\n\n/**\n * Evaluate a trivial `calc(A * B)` where A / B are lengths or numbers\n * Tailwind compiles down to — the exact shape `var(--spacing)` resolves\n * to after `theme(inline)` substitution.\n * @param args Raw calc argument token list.\n * @param themeVars\n * @returns Px value, or null.\n */\nfunction evaluateSimpleCalc(args: readonly TokenOrValue[], themeVars: ThemeVars | undefined): number | null {\n  const stripped = stripWhitespace(args)\n  if (stripped.length === 3) {\n    const mul = stripped[1]!\n    if (mul.type === 'token' && mul.value.type === 'delim' && (mul.value.value as string) === '*') {\n      const left = coerceTokenToPx(stripped[0]!, themeVars)\n      const right = coerceTokenToPx(stripped[2]!, themeVars)\n      if (left !== null && right !== null) return left * right\n    }\n  }\n  if (stripped.length === 1) return coerceTokenToPx(stripped[0]!, themeVars)\n  return null\n}\n\n/**\n * Resolve a `var(--name)` reference to a px value using the supplied\n * theme-var table. Returns null when the name isn't registered or the\n * value isn't a recognisable length.\n * @param name Custom-property name (with leading `--`).\n * @param themeVars Lookup table (or undefined).\n * @returns Px value, or null.\n */\nfunction resolveVariableToPx(name: string, themeVars: ThemeVars | undefined): number | null {\n  if (!themeVars) return null\n  const raw = themeVars.get(name)\n  if (raw === undefined) return null\n  const trimmed = raw.trim()\n  if (trimmed.endsWith('rem')) {\n    const n = Number(trimmed.slice(0, -3))\n    return Number.isFinite(n) ? n * REM_TO_PX : null\n  }\n  if (trimmed.endsWith('em')) {\n    const n = Number(trimmed.slice(0, -2))\n    return Number.isFinite(n) ? n * REM_TO_PX : null\n  }\n  if (trimmed.endsWith('px')) {\n    const n = Number(trimmed.slice(0, -2))\n    return Number.isFinite(n) ? n : null\n  }\n  const n = Number(trimmed)\n  return Number.isFinite(n) ? n : null\n}\n\n/**\n * Whether the token list represents `100vh`.\n * @param tokens Whitespace-stripped token list.\n * @returns True when the only meaningful token is the length `100vh`.\n */\nfunction isViewportHeightHundred(tokens: readonly TokenOrValue[]): boolean {\n  if (tokens.length !== 1) return false\n  const token = tokens[0]!\n  if (token.type !== 'length') return false\n  return token.value.unit === 'vh' && token.value.value === 100\n}\n\n/**\n * Whether the rhs of `calc(100vh - <rhs>)` is the nested `(env(top) + env(bottom))`\n * parenthesised sum Tailwind emits for `h-screen-safe` and siblings.\n * @param tokens Whitespace-stripped rhs token list.\n * @returns True on match.\n */\nfunction isParenthesisedTopBottomSum(tokens: readonly TokenOrValue[]): boolean {\n  // lightningcss emits bare `(...)` as a `parenthesis-block` token\n  // followed by the inner tokens inline, then a `close-parenthesis`\n  // token at the matching depth. Strip whitespace + the grouping tokens\n  // and check that what remains is exactly `env(top) + env(bottom)`\n  // (either order).\n  const meaningful: TokenOrValue[] = []\n  for (const token of tokens) {\n    if (isWhitespaceToken(token)) continue\n    if (token.type === 'token') {\n      const t = token.value.type\n      if (t === 'parenthesis-block' || t === 'close-parenthesis') continue\n    }\n    meaningful.push(token)\n  }\n  if (meaningful.length !== 3) return false\n  const plus = meaningful[1]!\n  if (plus.type !== 'token' || plus.value.type !== 'delim' || (plus.value.value as string) !== '+') return false\n  const first = envSide(meaningful[0]!)\n  const last = envSide(meaningful[2]!)\n  return (first === 't' && last === 'b') || (first === 'b' && last === 't')\n}\n\nexport { detectSafeAreaMarker }\n\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;AAoBG;AAKH;AACA,MAAM,QAAQ,GAA6C;AACzD,IAAA,qBAAqB,EAAE,GAAG;AAC1B,IAAA,uBAAuB,EAAE,GAAG;AAC5B,IAAA,wBAAwB,EAAE,GAAG;AAC7B,IAAA,sBAAsB,EAAE,GAAG;CAC5B;AAED;AACA,MAAM,SAAS,GAAG,EAAE;AASpB;;;;;;;AAOG;AACH,SAAS,oBAAoB,CAAC,MAA+B,EAAE,SAAqB,EAAA;AAClF,IAAA,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC;AACrC,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;;AAGnC,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI;AAAE,YAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;IAC5C;;AAGA,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE;QAC/C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACtC,IAAI,KAAK,EAAE;AACT,YAAA,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;AACjE,YAAA,IAAI,MAAM;AAAE,gBAAA,OAAO,MAAM;QAC3B;IACF;AAEA,IAAA,OAAO,IAAI;AACb;AAEA;;;AAGG;AACH,SAAS,UAAU,CAAC,KAAmB,EAAA;AACrC,IAAA,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU;AAClC;AAEA;;;;AAIG;AACH,SAAS,aAAa,CAAC,KAAmB,EAAA;AACxC,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;AAAE,QAAA,OAAO,IAAI;AAC1C,IAAA,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE;AAChE;AAEA;;;;;;;;AAQG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,IAA6B,EAAE,SAAgC,EAAA;IACpG,IAAI,IAAI,KAAK,KAAK;AAAE,QAAA,OAAO,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;IAClD,IAAI,IAAI,KAAK,MAAM;AAAE,QAAA,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;AACpD,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;AAQG;AACH,SAAS,MAAM,CAAC,IAA6B,EAAE,SAAgC,EAAA;AAC7E,IAAA,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC;AACtC,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;IACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;AAC/C,IAAA,IAAI,CAAC,UAAU;AAAE,QAAA,OAAO,IAAI;AAC5B,IAAA,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACrC,IAAI,SAAS,KAAK,IAAI;AAAE,QAAA,OAAO,IAAI;IACnC,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC;IAChD,IAAI,GAAG,KAAK,IAAI;AAAE,QAAA,OAAO,IAAI;IAC7B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE;AACvC;AAEA;;;;;;;AAOG;AACH,SAAS,OAAO,CAAC,IAA6B,EAAE,SAAgC,EAAA;IAC9E,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC;IACvD,IAAI,SAAS,KAAK,EAAE;AAAE,QAAA,OAAO,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC;AAC9D,IAAA,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACrD,IAAA,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;AACtD,IAAA,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;AACrD,IAAA,IAAI,MAAM;AAAE,QAAA,OAAO,MAAM;AACzB,IAAA,IAAI,IAAI,KAAK,GAAG,IAAI,uBAAuB,CAAC,GAAG,CAAC,IAAI,2BAA2B,CAAC,GAAG,CAAC;AAAE,QAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE;AACzH,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;AAOG;AACH,SAAS,gBAAgB,CAAC,IAA6B,EAAE,SAAgC,EAAA;AACvF,IAAA,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC;AACrC,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;IACvB,OAAO,oBAAoB,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;AACjD;AAEA;;;;;;;;;AASG;AACH,SAAS,WAAW,CAClB,GAA4B,EAC5B,GAA4B,EAC5B,IAAsB,EACtB,SAAgC,EAAA;AAEhC,IAAA,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;IAC7B,IAAI,IAAI,KAAK,IAAI;AAAE,QAAA,OAAO,IAAI;AAC9B,IAAA,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,EAAE,SAAS,CAAC;IACnD,IAAI,MAAM,KAAK,IAAI;AAAE,QAAA,OAAO,IAAI;IAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE;AAClE;AAEA;;;;AAIG;AACH,SAAS,OAAO,CAAC,KAAmB,EAAA;AAClC,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;AAAE,QAAA,OAAO,IAAI;AACrC,IAAA,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK;AAC5B,IAAA,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;AAAE,QAAA,OAAO,IAAI;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI;AACrC;AAEA;;;;;AAKG;AACH,SAAS,eAAe,CAAC,MAA+B,EAAA;IACtD,MAAM,GAAG,GAAmB,EAAE;AAC9B,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE;AAC9B,QAAA,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;IACjB;AACA,IAAA,OAAO,GAAG;AACZ;AAEA;;;;;AAKG;AACH,SAAS,iBAAiB,CAAC,MAA+B,EAAA;AACxD,IAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC;AACxC,IAAA,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,GAAG,IAAI;AACpD;AAEA;;;;;AAKG;AACH,SAAS,iBAAiB,CAAC,KAAmB,EAAA;AAC5C,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACxC,IAAA,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK;IACvB,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;AACjE;AAEA;;;;;;AAMG;AACH,SAAS,kBAAkB,CAAC,IAA6B,EAAA;;;;AAIvD,IAAA,MAAM,KAAK,GAAqB,CAAC,EAAE,CAAC;AACpC,IAAA,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE;AACxB,QAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;AAC1D,YAAA,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACd;QACF;QACA,KAAK,CAAC,EAAE,CAAC,EAAE,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B;AACA,IAAA,OAAO,KAAK;AACd;AAEA;;;;AAIG;AACH,SAAS,uBAAuB,CAAC,IAA6B,EAAA;AAC5D,IAAA,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,QAAS;AACvB,QAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE;AAC5B,QAAA,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE;AAClC,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAe;AACzC,QAAA,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;AAAE,YAAA,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;IAC3D;AACA,IAAA,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC;AACnB;AAEA;;;;;;AAMG;AACH,SAAS,cAAc,CAAC,MAA+B,EAAE,SAAgC,EAAA;AACvF,IAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC;AACxC,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;IACtC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC;AACjD;AAEA;;;;;;;AAOG;AACH,SAAS,eAAe,CAAC,KAAmB,EAAE,SAAgC,EAAA;AAC5E,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE;QAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK;QACnC,IAAI,IAAI,KAAK,IAAI;AAAE,YAAA,OAAO,KAAK;AAC/B,QAAA,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,GAAG,SAAS;AAC7D,QAAA,OAAO,IAAI;IACb;AACA,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC3D,QAAA,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK;IAC1B;AACA,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE;QAC5D,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC;IAC7D;AACA,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;AAAE,QAAA,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;AACvF,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;AAOG;AACH,SAAS,kBAAkB,CAAC,IAA6B,EAAE,SAAgC,EAAA;AACzF,IAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC;AACtC,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AACzB,QAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE;QACxB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAK,GAAG,CAAC,KAAK,CAAC,KAAgB,KAAK,GAAG,EAAE;YAC7F,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC;YACrD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC;AACtD,YAAA,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,GAAG,KAAK;QAC1D;IACF;AACA,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,SAAS,CAAC;AAC1E,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;AAOG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,SAAgC,EAAA;AACzE,IAAA,IAAI,CAAC,SAAS;AAAE,QAAA,OAAO,IAAI;IAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS;AAAE,QAAA,OAAO,IAAI;AAClC,IAAA,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAC1B,IAAA,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AAC3B,QAAA,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI;IAClD;AACA,IAAA,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;AAC1B,QAAA,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI;IAClD;AACA,IAAA,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;AAC1B,QAAA,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;IACtC;AACA,IAAA,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;AACzB,IAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI;AACtC;AAEA;;;;AAIG;AACH,SAAS,uBAAuB,CAAC,MAA+B,EAAA;AAC9D,IAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;AACrC,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE;AACxB,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;AAAE,QAAA,OAAO,KAAK;AACzC,IAAA,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG;AAC/D;AAEA;;;;;AAKG;AACH,SAAS,2BAA2B,CAAC,MAA+B,EAAA;;;;;;IAMlE,MAAM,UAAU,GAAmB,EAAE;AACrC,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE;AAC9B,QAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;AAC1B,YAAA,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI;AAC1B,YAAA,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,KAAK,mBAAmB;gBAAE;QAC9D;AACA,QAAA,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;IACxB;AACA,IAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;AACzC,IAAA,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE;IAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAK,IAAI,CAAC,KAAK,CAAC,KAAgB,KAAK,GAAG;AAAE,QAAA,OAAO,KAAK;IAC9G,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;AACpC,IAAA,OAAO,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,MAAM,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;AAC3E;;;;"}

package/lib/cjs/core/parser/safe-area.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Detect `env(safe-area-inset-*)` usage in a lightningcss TokenOrValue
+ * tree and convert the containing declaration into a runtime-resolved
+ * {@link SafeAreaMarker}.
+ *
+ * Three shapes the NativeWind-compatible `*-safe` utilities produce
+ * through Tailwind v4's compiler:
+ *  - Pure `env(safe-area-inset-top)` → `{ __safe: 't' }`
+ *  - `max(env(safe-area-inset-top), 16px)` → `{ __safe: 't', or: 16 }`
+ *  - `calc(env(safe-area-inset-top) + 16px)` → `{ __safe: 't', offset: 16 }`
+ *
+ * The `h-screen-safe` / `min-h-screen-safe` / `max-h-screen-safe` shape
+ * — `calc(100vh - (env(top) + env(bottom)))` — reports as
+ * `{ __safe: 'screen-minus-y' }`; the runtime resolves against
+ * `Dimensions.get('window').height` minus the current top + bottom
+ * insets.
+ *
+ * Unrecognised compound shapes (e.g. `env(safe-area-inset-top, 12px)`
+ * with a fallback) return `null` so the caller falls back to the
+ * regular token-serialisation path.
+ */
+import type { TokenOrValue } from 'lightningcss';
+import type { SafeAreaMarker } from './types';
+/**
+ * Theme-var lookup table we optionally receive. Values are stored as
+ * raw CSS value strings (`'0.25rem'`, `'#fff'`, …); the safe-area
+ * detector only needs the ones that resolve to lengths.
+ */
+type ThemeVars = ReadonlyMap<string, string>;
+/**
+ * Try to compile a token list into a {@link SafeAreaMarker}. Returns
+ * `null` when the tokens don't match any recognised safe-area pattern
+ * — the caller should fall back to the regular unparsed-value path.
+ * @param tokens Declaration value token list from lightningcss.
+ * @param themeVars
+ * @returns Marker object, or `null`.
+ */
+declare function detectSafeAreaMarker(tokens: readonly TokenOrValue[], themeVars?: ThemeVars): SafeAreaMarker | null;
+export { detectSafeAreaMarker };

package/lib/cjs/core/parser/selector.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+/**
+ * Pull a bare class name out of a lightningcss selector-part array. Accepts
+ * only the simple shape — one `{type: 'class', name}` component — since
+ * Tailwind utility rules land as flat single-class selectors once variants
+ * are folded in. Compound or pseudo selectors return `null` so the caller
+ * skips them.
+ * @param selector One selector's component array.
+ * @returns Bare class name, or `null` when the selector is anything more complex.
+ */
+function classNameFromSelector(selector) {
+    if (selector.length !== 1)
+        return null;
+    const [head] = selector;
+    if (head?.type !== 'class')
+        return null;
+    return head.name;
+}
+
+exports.classNameFromSelector = classNameFromSelector;
+//# sourceMappingURL=selector.cjs.map

package/lib/cjs/core/parser/selector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.cjs","sources":["../../../../../src/core/parser/selector.ts"],"sourcesContent":["import type { SelectorComponent } from 'lightningcss'\n\n/**\n * Pull a bare class name out of a lightningcss selector-part array. Accepts\n * only the simple shape — one `{type: 'class', name}` component — since\n * Tailwind utility rules land as flat single-class selectors once variants\n * are folded in. Compound or pseudo selectors return `null` so the caller\n * skips them.\n * @param selector One selector's component array.\n * @returns Bare class name, or `null` when the selector is anything more complex.\n */\nexport function classNameFromSelector(selector: readonly SelectorComponent[]): string | null {\n  if (selector.length !== 1) return null\n  const [head] = selector\n  if (head?.type !== 'class') return null\n  return head.name\n}\n"],"names":[],"mappings":";;AAEA;;;;;;;;AAQG;AACG,SAAU,qBAAqB,CAAC,QAAsC,EAAA;AAC1E,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;AACtC,IAAA,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ;AACvB,IAAA,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO;AAAE,QAAA,OAAO,IAAI;IACvC,OAAO,IAAI,CAAC,IAAI;AAClB;;;;"}

package/lib/cjs/core/parser/selector.d.ts

@@ -0,0 +1,11 @@
+import type { SelectorComponent } from 'lightningcss';
+/**
+ * Pull a bare class name out of a lightningcss selector-part array. Accepts
+ * only the simple shape — one `{type: 'class', name}` component — since
+ * Tailwind utility rules land as flat single-class selectors once variants
+ * are folded in. Compound or pseudo selectors return `null` so the caller
+ * skips them.
+ * @param selector One selector's component array.
+ * @returns Bare class name, or `null` when the selector is anything more complex.
+ */
+export declare function classNameFromSelector(selector: readonly SelectorComponent[]): string | null;