@ashstack/lint 0.1.1 → 0.2.0

package/dist/react-native/rules/skia/canvas-opaque.js

@@ -1,49 +1 @@
-import { attributeName, gate, importedSpecifiers, problem, tagPath } from "../../../lib/ast.js";
-const MESSAGE = "Add an explicit `opaque` prop to this `<Canvas>`: `opaque={Platform.OS === 'android'}` for a fullscreen animated canvas, or `opaque={false}` when it needs transparency, view transforms, or ordinary stacking.";
-export const canvasOpaque = problem("Require an explicit `opaque` prop on a Skia `<Canvas>`. A fullscreen animated canvas wants it on; anything that needs transparency or a view transform wants it off.", {
-    createOnce(context) {
-        const canvasLocals = new Set();
-        const namespaces = new Set();
-        const elements = [];
-        /** `<Canvas>` under its imported name, or `<Skia.Canvas>` under a namespace or default import. */
-        const namesACanvas = (name) => {
-            const path = tagPath(name);
-            const dot = path.lastIndexOf(".");
-            if (dot === -1)
-                return canvasLocals.has(path);
-            return namespaces.has(path.slice(0, dot)) && path.slice(dot + 1) === "Canvas";
-        };
-        return {
-            before() {
-                canvasLocals.clear();
-                namespaces.clear();
-                elements.length = 0;
-                return gate(context, "react-native-skia");
-            },
-            ImportDeclaration(node) {
-                for (const specifier of importedSpecifiers(node, "@shopify/react-native-skia")) {
-                    if (specifier.type === "ImportSpecifier") {
-                        const { imported, local } = specifier;
-                        if (imported.type === "Identifier" && imported.name === "Canvas")
-                            canvasLocals.add(local.name);
-                        continue;
-                    }
-                    if (specifier.type === "ImportNamespaceSpecifier" || specifier.type === "ImportDefaultSpecifier") {
-                        namespaces.add(specifier.local.name);
-                    }
-                }
-            },
-            JSXOpeningElement(node) {
-                if (!namesACanvas(node.name))
-                    return;
-                const hasOpaque = node.attributes.some(attribute => attribute.type === "JSXAttribute" && attributeName(attribute) === "opaque");
-                if (!hasOpaque)
-                    elements.push(node);
-            },
-            "Program:exit"() {
-                for (const element of elements)
-                    context.report({ node: element, message: MESSAGE });
-            },
-        };
-    },
-});
+import{attributeName as p,gate as f,importedSpecifiers as m,problem as l,tagPath as u}from"../../../lib/ast.js";const d="Add an explicit `opaque` prop to this `<Canvas>`: `opaque={Platform.OS === 'android'}` for a fullscreen animated canvas, or `opaque={false}` when it needs transparency, view transforms, or ordinary stacking.";export const canvasOpaque=l("Require an explicit `opaque` prop on a Skia `<Canvas>`. A fullscreen animated canvas wants it on; anything that needs transparency or a view transform wants it off.",{createOnce(o){const n=new Set,r=new Set,s=[],i=(a)=>{const e=u(a),t=e.lastIndexOf(".");if(t===-1)return n.has(e);return r.has(e.slice(0,t))&&e.slice(t+1)==="Canvas"};return{before(){n.clear();r.clear();s.length=0;return f(o,"react-native-skia")},ImportDeclaration(a){for(const e of m(a,"@shopify/react-native-skia")){if(e.type==="ImportSpecifier"){const{imported:t,local:c}=e;if(t.type==="Identifier"&&t.name==="Canvas")n.add(c.name);continue}if(e.type==="ImportNamespaceSpecifier"||e.type==="ImportDefaultSpecifier")r.add(e.local.name)}},JSXOpeningElement(a){if(!i(a.name))return;if(!a.attributes.some((t)=>t.type==="JSXAttribute"&&p(t)==="opaque"))s.push(a)},"Program:exit"(){for(const a of s)o.report({node:a,message:d})}}}});

package/dist/react-native/rules/skia/index.js

@@ -1,21 +1 @@
-import { defineModule } from "../../../lib/module.js";
-import { canvasOpaque } from "./canvas-opaque.js";
-export default defineModule({
-    meta: { name: "@ashstack/skia" },
-    url: import.meta.url,
-    packages: ["@shopify/react-native-skia"],
-    option: "skia",
-    docsWhen: "auto-enabled when `@shopify/react-native-skia` is a dependency",
-    rules: {
-        "canvas-opaque": canvasOpaque,
-    },
-    restrictedImports: {
-        paths: [
-            {
-                name: "@shopify/react-native-skia",
-                importNames: ["usePathValue", "usePathInterpolation"],
-                message: "Keep one stable `SkPath` buffer and mutate it inside `useDerivedValue`, with consumers reading the driving shared value. These legacy path-value hooks self-dirty Reanimated mappers and re-record idle canvases.",
-            },
-        ],
-    },
-});
+import{defineModule as e}from"../../../lib/module.js";import{canvasOpaque as a}from"./canvas-opaque.js";export default e({meta:{name:"@ashstack/skia"},url:import.meta.url,packages:["@shopify/react-native-skia"],option:"skia",docsWhen:"auto-enabled when `@shopify/react-native-skia` is a dependency",rules:{"canvas-opaque":a},restrictedImports:{paths:[{name:"@shopify/react-native-skia",importNames:["usePathValue","usePathInterpolation"],message:"Keep one stable `SkPath` buffer and mutate it inside `useDerivedValue`, with consumers reading the driving shared value. These legacy path-value hooks self-dirty Reanimated mappers and re-record idle canvases."}]}});

package/dist/react-native/rules/turbo-image/index.js

@@ -1,14 +1 @@
-import { defineModule } from "../../../lib/module.js";
-import { requireCachePolicy } from "./require-cache-policy.js";
-import { requireResize } from "./require-resize.js";
-export default defineModule({
-    meta: { name: "@ashstack/turbo-image" },
-    url: import.meta.url,
-    packages: ["react-native-turbo-image"],
-    option: "turboImage",
-    docsWhen: "auto-enabled when `react-native-turbo-image` is a dependency",
-    rules: {
-        "require-resize": requireResize,
-        "require-cache-policy": requireCachePolicy,
-    },
-});
+import{defineModule as e}from"../../../lib/module.js";import{requireCachePolicy as r}from"./require-cache-policy.js";import{requireResize as a}from"./require-resize.js";export default e({meta:{name:"@ashstack/turbo-image"},url:import.meta.url,packages:["react-native-turbo-image"],option:"turboImage",docsWhen:"auto-enabled when `react-native-turbo-image` is a dependency",rules:{"require-resize":a,"require-cache-policy":r}});

package/dist/react-native/rules/turbo-image/require-cache-policy.js

@@ -1,21 +1 @@
-import { attributeName, componentName, gate, problem } from "../../../lib/ast.js";
-const MESSAGE = 'Add `cachePolicy` to this TurboImage (normally `cachePolicy="dataCache"`), or it re-fetches over the network on every cold start.';
-export const requireCachePolicy = problem("Require `cachePolicy` on a TurboImage. Without one the image is re-fetched over the network on every cold start, so an already-scrolled feed costs its bandwidth again.", {
-    createOnce(context) {
-        return {
-            before() {
-                return gate(context, "TurboImage");
-            },
-            JSXOpeningElement(node) {
-                if (componentName(node.name) !== "TurboImage")
-                    return;
-                const { attributes } = node;
-                if (attributes.some(attribute => attribute.type === "JSXSpreadAttribute"))
-                    return;
-                if (attributes.some(attribute => attributeName(attribute) === "cachePolicy"))
-                    return;
-                context.report({ node: node.name, message: MESSAGE });
-            },
-        };
-    },
-});
+import{attributeName as a,componentName as c,gate as n,problem as i}from"../../../lib/ast.js";const m='Add `cachePolicy` to this TurboImage (normally `cachePolicy="dataCache"`), or it re-fetches over the network on every cold start.';export const requireCachePolicy=i("Require `cachePolicy` on a TurboImage. Without one the image is re-fetched over the network on every cold start, so an already-scrolled feed costs its bandwidth again.",{createOnce(t){return{before(){return n(t,"TurboImage")},JSXOpeningElement(e){if(c(e.name)!=="TurboImage")return;const{attributes:o}=e;if(o.some((r)=>r.type==="JSXSpreadAttribute"))return;if(o.some((r)=>a(r)==="cachePolicy"))return;t.report({node:e.name,message:m})}}}});

package/dist/react-native/rules/turbo-image/require-resize.js

@@ -1,22 +1 @@
-import { attributeName, componentName, gate, problem } from "../../../lib/ast.js";
-const MESSAGE = "Add `resize` to this TurboImage, set slightly BELOW the rendered width in points, so the native decoder downsamples before the bitmap reaches memory. Rounding down costs nothing visible; a value above the rendered width keeps the full-resolution decode (a 4000px photo in a 100pt avatar holds roughly 48MB of pixels).";
-export const requireResize = problem("Require `resize` on a TurboImage so the native decoder downsamples before the bitmap reaches memory. A full-resolution decode wastes tens of megabytes and stalls the first frame.", {
-    createOnce(context) {
-        return {
-            before() {
-                return gate(context, "TurboImage");
-            },
-            JSXOpeningElement(node) {
-                if (componentName(node.name) !== "TurboImage")
-                    return;
-                const { attributes } = node;
-                if (attributes.some(attribute => attribute.type === "JSXSpreadAttribute"))
-                    return;
-                const hasResize = attributes.some(attribute => attribute.type === "JSXAttribute" && attributeName(attribute) === "resize");
-                if (hasResize)
-                    return;
-                context.report({ node: node.name, message: MESSAGE });
-            },
-        };
-    },
-});
+import{attributeName as s,componentName as a,gate as i,problem as n}from"../../../lib/ast.js";const m="Add `resize` to this TurboImage, set slightly BELOW the rendered width in points, so the native decoder downsamples before the bitmap reaches memory. Rounding down costs nothing visible; a value above the rendered width keeps the full-resolution decode (a 4000px photo in a 100pt avatar holds roughly 48MB of pixels).";export const requireResize=n("Require `resize` on a TurboImage so the native decoder downsamples before the bitmap reaches memory. A full-resolution decode wastes tens of megabytes and stalls the first frame.",{createOnce(r){return{before(){return i(r,"TurboImage")},JSXOpeningElement(t){if(a(t.name)!=="TurboImage")return;const{attributes:o}=t;if(o.some((e)=>e.type==="JSXSpreadAttribute"))return;if(o.some((e)=>e.type==="JSXAttribute"&&s(e)==="resize"))return;r.report({node:t.name,message:m})}}}});

package/dist/react-native/rules/unistyles/animated-theme.js

@@ -1,37 +1 @@
-import { calleeName, problem } from "../../../lib/ast.js";
-import { readsTheme } from "./shared.js";
-const WORKLET_HOOKS = new Set(["useAnimatedStyle", "useDerivedValue", "useAnimatedProps"]);
-const MESSAGE = "Use `useAnimatedTheme()` and read its shared value inside the Reanimated worklet so theme changes reach the UI thread.";
-export const animatedTheme = problem("A Reanimated worklet hook cannot see `useUnistyles()` theme changes on the UI thread. Read the shared value from `useAnimatedTheme()` there instead.", {
-    createOnce(context) {
-        let declaresTheme = false;
-        const candidates = [];
-        return {
-            before() {
-                declaresTheme = false;
-                candidates.length = 0;
-            },
-            VariableDeclarator(node) {
-                const { id, init } = node;
-                if (id.type === "ObjectPattern" &&
-                    calleeName(init) === "useUnistyles" &&
-                    id.properties.some(property => property.type === "Property" && property.key.type === "Identifier" && property.key.name === "theme")) {
-                    declaresTheme = true;
-                }
-            },
-            CallExpression(node) {
-                if (!WORKLET_HOOKS.has(calleeName(node)))
-                    return;
-                if (!readsTheme(node))
-                    return;
-                candidates.push(node);
-            },
-            "Program:exit"() {
-                if (!declaresTheme)
-                    return;
-                for (const node of candidates)
-                    context.report({ node, message: MESSAGE });
-            },
-        };
-    },
-});
+import{calleeName as n,problem as m}from"../../../lib/ast.js";import{readsTheme as h}from"./shared.js";const d=new Set(["useAnimatedStyle","useDerivedValue","useAnimatedProps"]),l="Use `useAnimatedTheme()` and read its shared value inside the Reanimated worklet so theme changes reach the UI thread.";export const animatedTheme=m("A Reanimated worklet hook cannot see `useUnistyles()` theme changes on the UI thread. Read the shared value from `useAnimatedTheme()` there instead.",{createOnce(i){let t=!1;const a=[];return{before(){t=!1;a.length=0},VariableDeclarator(e){const{id:s,init:o}=e;if(s.type==="ObjectPattern"&&n(o)==="useUnistyles"&&s.properties.some((r)=>r.type==="Property"&&r.key.type==="Identifier"&&r.key.name==="theme"))t=!0},CallExpression(e){if(!d.has(n(e)))return;if(!h(e))return;a.push(e)},"Program:exit"(){if(!t)return;for(const e of a)i.report({node:e,message:l})}}}});

package/dist/react-native/rules/unistyles/content-container.js

@@ -1,73 +1 @@
-import { calleeName, findInSubtree, gate, problem, subtreeHas, tagIdentifier } from "../../../lib/ast.js";
-import { isStyleSheetCreate, memberPath, propertyName, stylesObjectOf } from "./shared.js";
-const MESSAGES = {
-    contentContainerRuntime: "Wrap this component with `withUnistyles`, or pass `contentContainerStyle` a plain hook-fed style. On a raw component `contentContainerStyle` never subscribes to Unistyles updates.",
-    contentContainerTheme: "Wrap this component with `withUnistyles`, or pass `contentContainerStyle` a plain hook-fed style. On a raw component `contentContainerStyle` never subscribes to theme changes.",
-};
-export const contentContainer = problem("A raw component never subscribes its `contentContainerStyle` to theme or `rt` updates. Wrap the component with `withUnistyles` when the style depends on either.", {
-    createOnce(context) {
-        const sheetStyles = new Map();
-        const wrapped = new Set();
-        const attributes = [];
-        return {
-            before() {
-                sheetStyles.clear();
-                wrapped.clear();
-                attributes.length = 0;
-                return gate(context, "contentContainerStyle");
-            },
-            VariableDeclarator(node) {
-                const { id, init } = node;
-                if (id.type !== "Identifier")
-                    return;
-                if (calleeName(init) === "withUnistyles") {
-                    wrapped.add(id.name);
-                    return;
-                }
-                if (init?.type !== "CallExpression" || !isStyleSheetCreate(init))
-                    return;
-                const styles = stylesObjectOf(init.arguments[0]);
-                if (!styles)
-                    return;
-                const map = new Map();
-                for (const property of styles.properties) {
-                    if (property.type !== "Property")
-                        continue;
-                    map.set(propertyName(property), property.value);
-                }
-                sheetStyles.set(id.name, map);
-            },
-            JSXAttribute(node) {
-                if (node.name.type !== "JSXIdentifier" || node.name.name !== "contentContainerStyle")
-                    return;
-                attributes.push(node);
-            },
-            "Program:exit"() {
-                for (const attribute of attributes) {
-                    const reference = findInSubtree(attribute.value, current => current.type === "MemberExpression" &&
-                        current.object.type === "Identifier" &&
-                        sheetStyles.has(current.object.name));
-                    if (reference?.type !== "MemberExpression")
-                        continue;
-                    const owner = attribute.parent;
-                    if (owner.type === "JSXOpeningElement" && wrapped.has(tagIdentifier(owner.name)))
-                        continue;
-                    const { object, property } = reference;
-                    if (object.type !== "Identifier")
-                        continue;
-                    const definition = sheetStyles.get(object.name)?.get(property.type === "Identifier" ? property.name : "");
-                    if (!definition)
-                        continue;
-                    const usesRuntime = subtreeHas(definition, current => current.type === "MemberExpression" && memberPath(current).startsWith("rt."));
-                    if (usesRuntime) {
-                        context.report({ node: attribute, message: MESSAGES.contentContainerRuntime });
-                        continue;
-                    }
-                    const usesTheme = subtreeHas(definition, current => current.type === "MemberExpression" && memberPath(current).startsWith("theme."));
-                    if (usesTheme)
-                        context.report({ node: attribute, message: MESSAGES.contentContainerTheme });
-                }
-            },
-        };
-    },
-});
+import{calleeName as f,findInSubtree as u,gate as b,problem as d,subtreeHas as y,tagIdentifier as S}from"../../../lib/ast.js";import{isStyleSheetCreate as w,memberPath as l,propertyName as C,stylesObjectOf as g}from"./shared.js";const h={contentContainerRuntime:"Wrap this component with `withUnistyles`, or pass `contentContainerStyle` a plain hook-fed style. On a raw component `contentContainerStyle` never subscribes to Unistyles updates.",contentContainerTheme:"Wrap this component with `withUnistyles`, or pass `contentContainerStyle` a plain hook-fed style. On a raw component `contentContainerStyle` never subscribes to theme changes."};export const contentContainer=d("A raw component never subscribes its `contentContainerStyle` to theme or `rt` updates. Wrap the component with `withUnistyles` when the style depends on either.",{createOnce(p){const a=new Map,c=new Set,m=[];return{before(){a.clear();c.clear();m.length=0;return b(p,"contentContainerStyle")},VariableDeclarator(e){const{id:r,init:n}=e;if(r.type!=="Identifier")return;if(f(n)==="withUnistyles"){c.add(r.name);return}if(n?.type!=="CallExpression"||!w(n))return;const s=g(n.arguments[0]);if(!s)return;const i=new Map;for(const o of s.properties){if(o.type!=="Property")continue;i.set(C(o),o.value)}a.set(r.name,i)},JSXAttribute(e){if(e.name.type!=="JSXIdentifier"||e.name.name!=="contentContainerStyle")return;m.push(e)},"Program:exit"(){for(const e of m){const r=u(e.value,(t)=>t.type==="MemberExpression"&&t.object.type==="Identifier"&&a.has(t.object.name));if(r?.type!=="MemberExpression")continue;const n=e.parent;if(n.type==="JSXOpeningElement"&&c.has(S(n.name)))continue;const{object:s,property:i}=r;if(s.type!=="Identifier")continue;const o=a.get(s.name)?.get(i.type==="Identifier"?i.name:"");if(!o)continue;if(y(o,(t)=>t.type==="MemberExpression"&&l(t).startsWith("rt."))){p.report({node:e,message:h.contentContainerRuntime});continue}if(y(o,(t)=>t.type==="MemberExpression"&&l(t).startsWith("theme.")))p.report({node:e,message:h.contentContainerTheme})}}}}});

package/dist/react-native/rules/unistyles/in-sheet.js

@@ -1,116 +1 @@
-import { calleeName, subtreeHas } from "../../../lib/ast.js";
-import { inCreate, isStyleSheetCreate, memberPath, propertyName } from "./shared.js";
-const LOGICAL_SPACING = new Set(["paddingLeft", "paddingRight", "marginLeft", "marginRight"]);
-const LEGACY_SHADOW = new Set(["shadowColor", "shadowOffset", "shadowOpacity", "shadowRadius", "elevation"]);
-const MESSAGES = {
-    logicalSpacing: "Use `paddingStart`/`paddingEnd` or `marginStart`/`marginEnd` here so the directional spacing mirrors in RTL.",
-    rtlInSheet: "Use `rt.rtl` for RTL-dependent styles so Unistyles tracks the dependency natively.",
-    screenDimensions: "Use reactive `rt.screen` inside `StyleSheet.create` instead of a `Dimensions.get` snapshot.",
-    pixelRatio: "Use reactive `rt.pixelRatio` inside `StyleSheet.create`.",
-    fontScale: "Use reactive `rt.fontScale` inside `StyleSheet.create`.",
-    statusBar: "Use reactive `rt.statusBar.height` inside `StyleSheet.create`.",
-    colorScheme: "Use the Unistyles theme or reactive `rt.colorScheme` inside `StyleSheet.create`.",
-    fullRuntime: "Use the injected mini runtime (`rt`) inside `StyleSheet.create` instead of `UnistylesRuntime`, so the style recalculates on its own.",
-    fullRuntimeDestructure: "Destructure from the injected mini runtime (`rt`) inside `StyleSheet.create`, not from `UnistylesRuntime`.",
-    themeScreen: "Use reactive `rt.screen`, or Unistyles breakpoints, instead of the theme's module-initialization screen snapshot.",
-    borderCurve: 'Add `borderCurve` (normally `"continuous"`) alongside `borderRadius`, or the corner renders as a circular arc rather than the squircle native iOS controls use.',
-    legacyShadow: 'Use `boxShadow` with CSS syntax, e.g. `boxShadow: "0 2px 8px rgba(0, 0, 0, 0.1)"`, which renders on both platforms on the New Architecture, instead of the legacy `shadow*`/`elevation` props.',
-    asConst: "Drop `as const` here — the typed `StyleSheet.create` already narrows the literal. If TS still widens the value to `string`, fix the `StyleSheet` import instead.",
-};
-export const inSheet = inCreate("Inside `StyleSheet.create`, require `rt` and theme values rather than Dimensions, PixelRatio, Appearance, I18nManager, StatusBar or `UnistylesRuntime`. It also covers logical spacing, `boxShadow`, `borderCurve` and a redundant `as const`.", (context, inside) => ({
-    CallExpression(node) {
-        if (!inside() || isStyleSheetCreate(node))
-            return;
-        const { callee } = node;
-        const path = callee.type === "MemberExpression" ? memberPath(callee) : calleeName(node);
-        if (path === "Dimensions.get")
-            context.report({ node, message: MESSAGES.screenDimensions });
-        else if (path === "PixelRatio.get")
-            context.report({ node, message: MESSAGES.pixelRatio });
-        else if (path === "PixelRatio.getFontScale")
-            context.report({ node, message: MESSAGES.fontScale });
-        else if (path === "Appearance.getColorScheme")
-            context.report({ node, message: MESSAGES.colorScheme });
-        else if (path === "useColorScheme")
-            context.report({ node, message: MESSAGES.colorScheme });
-    },
-    MemberExpression(node) {
-        if (!inside())
-            return;
-        const { parent } = node;
-        if (parent.type === "MemberExpression" && parent.object === node)
-            return;
-        const path = memberPath(node);
-        if (path === "I18nManager.isRTL") {
-            context.report({ node, message: MESSAGES.rtlInSheet });
-            return;
-        }
-        if (path === "StatusBar.currentHeight") {
-            context.report({ node, message: MESSAGES.statusBar });
-            return;
-        }
-        if (path.startsWith("UnistylesRuntime.")) {
-            context.report({ node, message: MESSAGES.fullRuntime });
-            return;
-        }
-        if (path.startsWith("theme.screen."))
-            context.report({ node, message: MESSAGES.themeScreen });
-    },
-    VariableDeclarator(node) {
-        if (!inside())
-            return;
-        const { id, init } = node;
-        if (id.type !== "ObjectPattern")
-            return;
-        if (init?.type === "Identifier" && init.name === "UnistylesRuntime") {
-            context.report({ node, message: MESSAGES.fullRuntimeDestructure });
-        }
-    },
-    TSAsExpression(node) {
-        if (!inside())
-            return;
-        const { typeAnnotation } = node;
-        if (typeAnnotation.type !== "TSTypeReference")
-            return;
-        const { typeName } = typeAnnotation;
-        if (typeName.type !== "Identifier" || typeName.name !== "const")
-            return;
-        context.report({ node, message: MESSAGES.asConst });
-    },
-    ObjectExpression(node) {
-        if (!inside())
-            return;
-        let borderRadius = null;
-        let hasBorderCurve = false;
-        for (const property of node.properties) {
-            if (property.type !== "Property")
-                continue;
-            const name = propertyName(property);
-            if (name === "borderRadius")
-                borderRadius = property;
-            else if (name === "borderCurve")
-                hasBorderCurve = true;
-        }
-        if (borderRadius && !hasBorderCurve)
-            context.report({ node: borderRadius, message: MESSAGES.borderCurve });
-    },
-    Property(node) {
-        if (!inside())
-            return;
-        const name = propertyName(node);
-        if (LEGACY_SHADOW.has(name)) {
-            context.report({ node, message: MESSAGES.legacyShadow });
-            return;
-        }
-        if (!LOGICAL_SPACING.has(name))
-            return;
-        const usesInsets = subtreeHas(node, current => {
-            if (current.type !== "MemberExpression")
-                return false;
-            const path = memberPath(current);
-            return path === "rt.insets.left" || path === "rt.insets.right";
-        });
-        if (!usesInsets)
-            context.report({ node, message: MESSAGES.logicalSpacing });
-    },
-}));
+import{calleeName as h,subtreeHas as p}from"../../../lib/ast.js";import{inCreate as m,isStyleSheetCreate as u,memberPath as l,propertyName as c}from"./shared.js";const S=new Set(["paddingLeft","paddingRight","marginLeft","marginRight"]),f=new Set(["shadowColor","shadowOffset","shadowOpacity","shadowRadius","elevation"]),i={logicalSpacing:"Use `paddingStart`/`paddingEnd` or `marginStart`/`marginEnd` here so the directional spacing mirrors in RTL.",rtlInSheet:"Use `rt.rtl` for RTL-dependent styles so Unistyles tracks the dependency natively.",screenDimensions:"Use reactive `rt.screen` inside `StyleSheet.create` instead of a `Dimensions.get` snapshot.",pixelRatio:"Use reactive `rt.pixelRatio` inside `StyleSheet.create`.",fontScale:"Use reactive `rt.fontScale` inside `StyleSheet.create`.",statusBar:"Use reactive `rt.statusBar.height` inside `StyleSheet.create`.",colorScheme:"Use the Unistyles theme or reactive `rt.colorScheme` inside `StyleSheet.create`.",fullRuntime:"Use the injected mini runtime (`rt`) inside `StyleSheet.create` instead of `UnistylesRuntime`, so the style recalculates on its own.",fullRuntimeDestructure:"Destructure from the injected mini runtime (`rt`) inside `StyleSheet.create`, not from `UnistylesRuntime`.",themeScreen:"Use reactive `rt.screen`, or Unistyles breakpoints, instead of the theme's module-initialization screen snapshot.",borderCurve:'Add `borderCurve` (normally `"continuous"`) alongside `borderRadius`, or the corner renders as a circular arc rather than the squircle native iOS controls use.',legacyShadow:'Use `boxShadow` with CSS syntax, e.g. `boxShadow: "0 2px 8px rgba(0, 0, 0, 0.1)"`, which renders on both platforms on the New Architecture, instead of the legacy `shadow*`/`elevation` props.',asConst:"Drop `as const` here — the typed `StyleSheet.create` already narrows the literal. If TS still widens the value to `string`, fix the `StyleSheet` import instead."};export const inSheet=m("Inside `StyleSheet.create`, require `rt` and theme values rather than Dimensions, PixelRatio, Appearance, I18nManager, StatusBar or `UnistylesRuntime`. It also covers logical spacing, `boxShadow`, `borderCurve` and a redundant `as const`.",(s,a)=>({CallExpression(e){if(!a()||u(e))return;const{callee:r}=e,t=r.type==="MemberExpression"?l(r):h(e);if(t==="Dimensions.get")s.report({node:e,message:i.screenDimensions});else if(t==="PixelRatio.get")s.report({node:e,message:i.pixelRatio});else if(t==="PixelRatio.getFontScale")s.report({node:e,message:i.fontScale});else if(t==="Appearance.getColorScheme")s.report({node:e,message:i.colorScheme});else if(t==="useColorScheme")s.report({node:e,message:i.colorScheme})},MemberExpression(e){if(!a())return;const{parent:r}=e;if(r.type==="MemberExpression"&&r.object===e)return;const t=l(e);if(t==="I18nManager.isRTL"){s.report({node:e,message:i.rtlInSheet});return}if(t==="StatusBar.currentHeight"){s.report({node:e,message:i.statusBar});return}if(t.startsWith("UnistylesRuntime.")){s.report({node:e,message:i.fullRuntime});return}if(t.startsWith("theme.screen."))s.report({node:e,message:i.themeScreen})},VariableDeclarator(e){if(!a())return;const{id:r,init:t}=e;if(r.type!=="ObjectPattern")return;if(t?.type==="Identifier"&&t.name==="UnistylesRuntime")s.report({node:e,message:i.fullRuntimeDestructure})},TSAsExpression(e){if(!a())return;const{typeAnnotation:r}=e;if(r.type!=="TSTypeReference")return;const{typeName:t}=r;if(t.type!=="Identifier"||t.name!=="const")return;s.report({node:e,message:i.asConst})},ObjectExpression(e){if(!a())return;let r=null,t=!1;for(const n of e.properties){if(n.type!=="Property")continue;const o=c(n);if(o==="borderRadius")r=n;else if(o==="borderCurve")t=!0}if(r&&!t)s.report({node:r,message:i.borderCurve})},Property(e){if(!a())return;const r=c(e);if(f.has(r)){s.report({node:e,message:i.legacyShadow});return}if(!S.has(r))return;if(!p(e,(n)=>{if(n.type!=="MemberExpression")return!1;const o=l(n);return o==="rt.insets.left"||o==="rt.insets.right"}))s.report({node:e,message:i.logicalSpacing})}}));

package/dist/react-native/rules/unistyles/index.js

@@ -1,58 +1 @@
-import { defineModule } from "../../../lib/module.js";
-import { animatedTheme } from "./animated-theme.js";
-import { contentContainer } from "./content-container.js";
-import { inSheet } from "./in-sheet.js";
-import { insets } from "./insets.js";
-import { noHardcodedColor } from "./no-hardcoded-color.js";
-import { noHardcodedSpacing } from "./no-hardcoded-spacing.js";
-import { noMargin } from "./no-margin.js";
-import { noStyleSpread } from "./no-style-spread.js";
-import { noUnusedStyles } from "./no-unused-styles.js";
-import { rtlStyleCall } from "./rtl-style-call.js";
-import { themeScreenComponent } from "./theme-screen-component.js";
-import { themeStyleAttr } from "./theme-style-attr.js";
-export default defineModule({
-    meta: { name: "@ashstack/unistyles" },
-    rules: {
-        "animated-theme": animatedTheme,
-        "content-container": contentContainer,
-        "in-sheet": inSheet,
-        insets: insets,
-        "no-hardcoded-color": noHardcodedColor,
-        "no-hardcoded-spacing": noHardcodedSpacing,
-        "no-margin": noMargin,
-        "no-style-spread": noStyleSpread,
-        "no-unused-styles": noUnusedStyles,
-        "rtl-style-call": rtlStyleCall,
-        "theme-screen-component": themeScreenComponent,
-        "theme-style-attr": themeStyleAttr,
-    },
-    url: import.meta.url,
-    packages: ["react-native-unistyles"],
-    option: "unistyles",
-    docsWhen: "auto-enabled when `react-native-unistyles` is a dependency",
-    restrictedImports: {
-        paths: [
-            {
-                name: "react-native",
-                importNames: ["StyleSheet"],
-                message: "Import `StyleSheet` from `react-native-unistyles` instead of `react-native`.",
-            },
-            {
-                name: "react-native",
-                importNames: ["useWindowDimensions", "Dimensions"],
-                message: "Read screen size from `rt.screen` inside `StyleSheet.create`, or `UnistylesRuntime.screen` outside it, instead of the `Dimensions` APIs.",
-            },
-            {
-                name: "react-native",
-                importNames: ["SafeAreaView"],
-                message: 'Set `contentInsetAdjustmentBehavior="automatic"` on the scroll view, or apply `rt.insets` from `react-native-unistyles`, instead of `SafeAreaView`.',
-            },
-            {
-                name: "react-native-safe-area-context",
-                importNames: ["useSafeAreaInsets", "useSafeAreaFrame", "SafeAreaView"],
-                message: "Read safe-area values from `rt.insets`, or `UnistylesRuntime.insets` outside a stylesheet, in `react-native-unistyles`.",
-            },
-        ],
-    },
-});
+import{defineModule as e}from"../../../lib/module.js";import{animatedTheme as t}from"./animated-theme.js";import{contentContainer as n}from"./content-container.js";import{inSheet as a}from"./in-sheet.js";import{insets as r}from"./insets.js";import{noHardcodedColor as s}from"./no-hardcoded-color.js";import{noHardcodedSpacing as o}from"./no-hardcoded-spacing.js";import{noMargin as i}from"./no-margin.js";import{noStyleSpread as m}from"./no-style-spread.js";import{noUnusedStyles as l}from"./no-unused-styles.js";import{rtlStyleCall as c}from"./rtl-style-call.js";import{themeScreenComponent as d}from"./theme-screen-component.js";import{themeStyleAttr as p}from"./theme-style-attr.js";export default e({meta:{name:"@ashstack/unistyles"},rules:{"animated-theme":t,"content-container":n,"in-sheet":a,insets:r,"no-hardcoded-color":s,"no-hardcoded-spacing":o,"no-margin":i,"no-style-spread":m,"no-unused-styles":l,"rtl-style-call":c,"theme-screen-component":d,"theme-style-attr":p},url:import.meta.url,packages:["react-native-unistyles"],option:"unistyles",docsWhen:"auto-enabled when `react-native-unistyles` is a dependency",restrictedImports:{paths:[{name:"react-native",importNames:["StyleSheet"],message:"Import `StyleSheet` from `react-native-unistyles` instead of `react-native`."},{name:"react-native",importNames:["useWindowDimensions","Dimensions"],message:"Read screen size from `rt.screen` inside `StyleSheet.create`, or `UnistylesRuntime.screen` outside it, instead of the `Dimensions` APIs."},{name:"react-native",importNames:["SafeAreaView"],message:'Set `contentInsetAdjustmentBehavior="automatic"` on the scroll view, or apply `rt.insets` from `react-native-unistyles`, instead of `SafeAreaView`.'},{name:"react-native-safe-area-context",importNames:["useSafeAreaInsets","useSafeAreaFrame","SafeAreaView"],message:"Read safe-area values from `rt.insets`, or `UnistylesRuntime.insets` outside a stylesheet, in `react-native-unistyles`."}]}});

package/dist/react-native/rules/unistyles/insets.js

@@ -1,92 +1 @@
-import { calleeName, closestAncestor, gate, problem, subtreeHas } from "../../../lib/ast.js";
-import { isStyleSheetCreate } from "./shared.js";
-const INSET_TEXT = /(?:inset|safearea|top|bottom|left|right)/i;
-const MESSAGES = {
-    insetsStyleCall: "Read safe-area values from `rt.insets` inside `StyleSheet.create` instead of passing `useSafeAreaInsets()` into a style function.",
-    insetsAttribute: "Resolve these safe-area values through `rt.insets` in `StyleSheet.create` instead of a hook-fed inline JSX style object.",
-};
-const boundNames = (id) => {
-    if (id.type === "Identifier")
-        return [id.name];
-    if (id.type === "AssignmentPattern")
-        return boundNames(id.left);
-    if (id.type === "RestElement")
-        return boundNames(id.argument);
-    if (id.type === "ArrayPattern")
-        return id.elements.flatMap(element => (element ? boundNames(element) : []));
-    if (id.type !== "ObjectPattern")
-        return [];
-    return id.properties.flatMap(property => property.type === "Property" ? boundNames(property.value) : boundNames(property.argument));
-};
-export const insets = problem("Disallow passing `useSafeAreaInsets()` values into a dynamic style function or an inline JSX style object. Read `rt.insets` inside `StyleSheet.create` instead.", {
-    createOnce(context) {
-        const insetBindings = new Set();
-        const sheets = new Set();
-        const styleCalls = [];
-        const styleAttributes = [];
-        return {
-            before() {
-                insetBindings.clear();
-                sheets.clear();
-                styleCalls.length = 0;
-                styleAttributes.length = 0;
-                return gate(context, "useSafeAreaInsets");
-            },
-            VariableDeclarator(node) {
-                const { id, init } = node;
-                if (id.type === "Identifier" && isStyleSheetCreate(init)) {
-                    sheets.add(id.name);
-                    return;
-                }
-                if (calleeName(init) !== "useSafeAreaInsets")
-                    return;
-                for (const name of boundNames(id))
-                    insetBindings.add(name);
-            },
-            CallExpression(node) {
-                const { callee } = node;
-                if (callee.type !== "MemberExpression")
-                    return;
-                const receiver = callee.object;
-                if (receiver.type !== "Identifier")
-                    return;
-                const exempt = closestAncestor(node, new Set(["JSXAttribute"]));
-                if (exempt?.type === "JSXAttribute" &&
-                    exempt.name.type === "JSXIdentifier" &&
-                    exempt.name.name === "contentContainerStyle") {
-                    return;
-                }
-                styleCalls.push({ node, receiver: receiver.name });
-            },
-            JSXAttribute(node) {
-                if (node.name.type !== "JSXIdentifier" || node.name.name !== "style")
-                    return;
-                styleAttributes.push(node);
-            },
-            "Program:exit"() {
-                const referencesBinding = (node) => subtreeHas(node, current => current.type === "Identifier" && insetBindings.has(current.name));
-                for (const entry of styleCalls) {
-                    if (!sheets.has(entry.receiver))
-                        continue;
-                    const text = context.sourceCode.getText(entry.node);
-                    if (!INSET_TEXT.test(text))
-                        continue;
-                    if (!referencesBinding(entry.node))
-                        continue;
-                    context.report({ node: entry.node, message: MESSAGES.insetsStyleCall });
-                }
-                for (const attribute of styleAttributes) {
-                    const text = context.sourceCode.getText(attribute);
-                    if (!INSET_TEXT.test(text))
-                        continue;
-                    const usesInsetsMember = subtreeHas(attribute, current => current.type === "MemberExpression" &&
-                        current.object.type === "Identifier" &&
-                        insetBindings.has(current.object.name));
-                    if (!usesInsetsMember)
-                        continue;
-                    context.report({ node: attribute, message: MESSAGES.insetsAttribute });
-                }
-            },
-        };
-    },
-});
+import{calleeName as y,closestAncestor as S,gate as b,problem as d,subtreeHas as u}from"../../../lib/ast.js";import{isStyleSheetCreate as g}from"./shared.js";const m=/(?:inset|safearea|top|bottom|left|right)/i,p={insetsStyleCall:"Read safe-area values from `rt.insets` inside `StyleSheet.create` instead of passing `useSafeAreaInsets()` into a style function.",insetsAttribute:"Resolve these safe-area values through `rt.insets` in `StyleSheet.create` instead of a hook-fed inline JSX style object."},i=(t)=>{if(t.type==="Identifier")return[t.name];if(t.type==="AssignmentPattern")return i(t.left);if(t.type==="RestElement")return i(t.argument);if(t.type==="ArrayPattern")return t.elements.flatMap((s)=>s?i(s):[]);if(t.type!=="ObjectPattern")return[];return t.properties.flatMap((s)=>s.type==="Property"?i(s.value):i(s.argument))};export const insets=d("Disallow passing `useSafeAreaInsets()` values into a dynamic style function or an inline JSX style object. Read `rt.insets` inside `StyleSheet.create` instead.",{createOnce(t){const s=new Set,o=new Set,f=[],l=[];return{before(){s.clear();o.clear();f.length=0;l.length=0;return b(t,"useSafeAreaInsets")},VariableDeclarator(r){const{id:e,init:n}=r;if(e.type==="Identifier"&&g(n)){o.add(e.name);return}if(y(n)!=="useSafeAreaInsets")return;for(const a of i(e))s.add(a)},CallExpression(r){const{callee:e}=r;if(e.type!=="MemberExpression")return;const n=e.object;if(n.type!=="Identifier")return;const a=S(r,new Set(["JSXAttribute"]));if(a?.type==="JSXAttribute"&&a.name.type==="JSXIdentifier"&&a.name.name==="contentContainerStyle")return;f.push({node:r,receiver:n.name})},JSXAttribute(r){if(r.name.type!=="JSXIdentifier"||r.name.name!=="style")return;l.push(r)},"Program:exit"(){const r=(e)=>u(e,(n)=>n.type==="Identifier"&&s.has(n.name));for(const e of f){if(!o.has(e.receiver))continue;const n=t.sourceCode.getText(e.node);if(!m.test(n))continue;if(!r(e.node))continue;t.report({node:e.node,message:p.insetsStyleCall})}for(const e of l){const n=t.sourceCode.getText(e);if(!m.test(n))continue;if(!u(e,(c)=>c.type==="MemberExpression"&&c.object.type==="Identifier"&&s.has(c.object.name)))continue;t.report({node:e,message:p.insetsAttribute})}}}}});

package/dist/react-native/rules/unistyles/no-hardcoded-color.js

@@ -1,30 +1 @@
-import { ancestors } from "../../../lib/ast.js";
-import { inCreate, propertyName } from "./shared.js";
-const HEX_COLOR = /^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
-const CSS_COLOR_FUNCTION = /^(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\(/i;
-const MESSAGE = "Use a `theme.colors` token for this value — a raw color bypasses dark mode and never shifts with the theme. If no token fits, add one to the theme.";
-const COLOR_KEY = /^colors?$|Colors?$/;
-/** The nearest style property this literal belongs to, seen through the arrays a gradient uses. */
-const underAColorKey = (node) => {
-    for (const current of ancestors(node)) {
-        if (current.type === "ArrayExpression")
-            continue;
-        if (current.type !== "Property")
-            return false;
-        return COLOR_KEY.test(propertyName(current));
-    }
-    return false;
-};
-export const noHardcodedColor = inCreate("Disallow hex and CSS-function colors inside `StyleSheet.create`. A raw color skips dark mode and never changes with the theme.", (context, inside) => ({
-    Literal(node) {
-        if (!inside())
-            return;
-        if (typeof node.value !== "string")
-            return;
-        if (!HEX_COLOR.test(node.value) && !CSS_COLOR_FUNCTION.test(node.value))
-            return;
-        if (!underAColorKey(node))
-            return;
-        context.report({ node, message: MESSAGE });
-    },
-}));
+import{ancestors as o}from"../../../lib/ast.js";import{inCreate as s,propertyName as a}from"./shared.js";const n=/^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,i=/^(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\(/i,l="Use a `theme.colors` token for this value — a raw color bypasses dark mode and never shifts with the theme. If no token fits, add one to the theme.",c=/^colors?$|Colors?$/,f=(t)=>{for(const e of o(t)){if(e.type==="ArrayExpression")continue;if(e.type!=="Property")return!1;return c.test(a(e))}return!1};export const noHardcodedColor=s("Disallow hex and CSS-function colors inside `StyleSheet.create`. A raw color skips dark mode and never changes with the theme.",(t,e)=>({Literal(r){if(!e())return;if(typeof r.value!=="string")return;if(!n.test(r.value)&&!i.test(r.value))return;if(!f(r))return;t.report({node:r,message:l})}}));