@ashstack/lint 0.1.0

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

@@ -0,0 +1,70 @@
+import { ancestors, calleeName, gate, isFunction, problem, subtreeHas } from "../../../lib/ast.js";
+import { CREATE_MARKER, isStyleSheetCreate } from "../../stylesheet.js";
+export { CREATE_MARKER, isStyleSheetCreate, propertyName, stylesObjectOf, } from "../../stylesheet.js";
+export const memberPath = (node) => {
+    const parts = [];
+    let current = node;
+    while (current?.type === "MemberExpression") {
+        const { property } = current;
+        if (property.type === "Identifier")
+            parts.unshift(property.name);
+        else if (property.type === "Literal")
+            parts.unshift(String(property.value));
+        else
+            parts.unshift("*");
+        current = current.object;
+    }
+    if (current?.type === "Identifier")
+        parts.unshift(current.name);
+    return parts.join(".");
+};
+export const declaresUseUnistylesTheme = (scope) => subtreeHas(scope, current => {
+    if (current.type !== "VariableDeclarator")
+        return false;
+    const { id, init } = current;
+    return (id.type === "ObjectPattern" &&
+        calleeName(init) === "useUnistyles" &&
+        id.properties.some(property => property.type === "Property" && property.key.type === "Identifier" && property.key.name === "theme"));
+});
+/**
+ * The enclosing function that destructures a `useUnistyles()` theme, innermost first. Walking past the
+ * innermost function matters: the read is often inside a callback the component passes down.
+ */
+export const themeConsumingComponent = (node) => {
+    for (const current of ancestors(node)) {
+        if (isFunction(current) && declaresUseUnistylesTheme(current))
+            return current;
+    }
+    return null;
+};
+export const readsTheme = (node) => subtreeHas(node, current => current.type === "MemberExpression" && memberPath(current).startsWith("theme."));
+/**
+ * Builds a rule whose visitors only fire inside `StyleSheet.create(...)`, by tracking how deeply
+ * nested the traversal currently is in such a call. The depth resets per file in `before()`, which
+ * also runs the text gate.
+ */
+export const inCreate = (description, visit) => problem(description, {
+    createOnce(context) {
+        let createDepth = 0;
+        const inside = () => createDepth > 0;
+        const visitors = visit(context, inside);
+        const { CallExpression: enter, "CallExpression:exit": exit } = visitors;
+        return {
+            ...visitors,
+            before() {
+                createDepth = 0;
+                return gate(context, CREATE_MARKER);
+            },
+            CallExpression(node) {
+                if (isStyleSheetCreate(node))
+                    createDepth += 1;
+                enter?.(node);
+            },
+            "CallExpression:exit"(node) {
+                exit?.(node);
+                if (isStyleSheetCreate(node))
+                    createDepth -= 1;
+            },
+        };
+    },
+});

package/dist/react-native/rules/unistyles/theme-screen-component.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from "../../../lib/types.js";
+export declare const themeScreenComponent: Rule;

package/dist/react-native/rules/unistyles/theme-screen-component.js

@@ -0,0 +1,22 @@
+import { hasAncestor, problem } from "../../../lib/ast.js";
+import { isStyleSheetCreate, memberPath, themeConsumingComponent } from "./shared.js";
+const THEME_SCREEN_PREFIX = "theme.screen.";
+const MESSAGE = "Read current screen values from `useUnistyles().rt.screen` or `useWindowDimensions()` instead of the theme's module-initialization snapshot.";
+export const themeScreenComponent = problem("`theme.screen.*` is a snapshot taken at module initialization, so a component that reads it never sees the current size. `useUnistyles().rt.screen` and `useWindowDimensions` do.", {
+    createOnce(context) {
+        return {
+            MemberExpression(node) {
+                if (!memberPath(node).startsWith(THEME_SCREEN_PREFIX))
+                    return;
+                const { parent } = node;
+                if (parent.type === "MemberExpression" && parent.object === node)
+                    return;
+                if (hasAncestor(node, isStyleSheetCreate))
+                    return;
+                if (!themeConsumingComponent(node))
+                    return;
+                context.report({ node, message: MESSAGE });
+            },
+        };
+    },
+});

package/dist/react-native/rules/unistyles/theme-style-attr.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from "../../../lib/types.js";
+export declare const themeStyleAttr: Rule;

package/dist/react-native/rules/unistyles/theme-style-attr.js

@@ -0,0 +1,18 @@
+import { problem } from "../../../lib/ast.js";
+import { readsTheme, themeConsumingComponent } from "./shared.js";
+const MESSAGE = "Resolve theme-dependent style values inside `StyleSheet.create` instead of reading `theme` in a JSX `style` prop or passing it into a dynamic style function.";
+export const themeStyleAttr = problem("Theme-dependent values belong in `StyleSheet.create`, not in a JSX `style` prop that reads a `useUnistyles()` theme.", {
+    createOnce(context) {
+        return {
+            JSXAttribute(node) {
+                if (node.name.type !== "JSXIdentifier" || node.name.name !== "style")
+                    return;
+                if (!readsTheme(node))
+                    return;
+                if (!themeConsumingComponent(node))
+                    return;
+                context.report({ node, message: MESSAGE });
+            },
+        };
+    },
+});

package/dist/react-native/stylesheet.d.ts

@@ -0,0 +1,11 @@
+import type { AstNode } from "../lib/types.js";
+/** The object literal a stylesheet is built from. */
+export type StylesObject = Extract<AstNode, {
+    type: "ObjectExpression";
+}>;
+/** Source-text gate for the stylesheet rules. Just the object, so `StyleSheet\n  .create(...)` still counts. */
+export declare const CREATE_MARKER = "StyleSheet";
+export declare const isStyleSheetCreate: (node: AstNode | null | undefined) => boolean;
+export declare const propertyName: (node: AstNode) => string;
+/** The styles object a `StyleSheet.create` argument holds: a literal, or the one its theme function returns. */
+export declare const stylesObjectOf: (factory: AstNode | null | undefined) => StylesObject | null;

package/dist/react-native/stylesheet.js

@@ -0,0 +1,44 @@
+import { findInSubtree } from "../lib/ast.js";
+/** Source-text gate for the stylesheet rules. Just the object, so `StyleSheet\n  .create(...)` still counts. */
+export const CREATE_MARKER = "StyleSheet";
+export const isStyleSheetCreate = (node) => {
+    if (node?.type !== "CallExpression")
+        return false;
+    const { callee } = node;
+    if (callee.type !== "MemberExpression")
+        return false;
+    const { object, property } = callee;
+    return (object.type === "Identifier" &&
+        object.name === "StyleSheet" &&
+        property.type === "Identifier" &&
+        property.name === "create");
+};
+export const propertyName = (node) => {
+    if (node.type !== "Property" || node.computed)
+        return "";
+    const { key } = node;
+    if (key.type === "Identifier")
+        return key.name;
+    if (key.type === "Literal")
+        return String(key.value);
+    return "";
+};
+const themeFunctionBody = (factory) => factory.type === "ArrowFunctionExpression" || factory.type === "FunctionExpression" ? factory.body : null;
+const returnsAnObject = (node) => node.type === "ReturnStatement" && node.argument?.type === "ObjectExpression";
+const objectReturnedFrom = (body) => {
+    if (body.type === "ObjectExpression")
+        return body;
+    const found = findInSubtree(body, returnsAnObject);
+    if (found?.type !== "ReturnStatement" || found.argument?.type !== "ObjectExpression")
+        return null;
+    return found.argument;
+};
+/** The styles object a `StyleSheet.create` argument holds: a literal, or the one its theme function returns. */
+export const stylesObjectOf = (factory) => {
+    if (!factory)
+        return null;
+    if (factory.type === "ObjectExpression")
+        return factory;
+    const body = themeFunctionBody(factory);
+    return body === null ? null : objectReturnedFrom(body);
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@ashstack/lint",
+  "version": "0.1.0",
+  "description": "ashStack shared oxlint configuration and custom rules. Entries: core, react, react-native, with per-library rule groups auto-detected from your dependencies. Consume from oxlint.config.mts.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ali Alshehri (https://github.com/AlshehriAli0)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlshehriAli0/ashStack.git",
+    "directory": "packages/lint"
+  },
+  "homepage": "https://github.com/AlshehriAli0/ashStack/tree/main/packages/lint#readme",
+  "bugs": "https://github.com/AlshehriAli0/ashStack/issues",
+  "keywords": [
+    "oxlint",
+    "oxc",
+    "lint",
+    "linter",
+    "eslint-config",
+    "typescript",
+    "react",
+    "react-native",
+    "expo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./react-native": {
+      "types": "./dist/react-native/index.d.ts",
+      "default": "./dist/react-native/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "RULES.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "eslint-plugin-react-you-might-not-need-an-effect": "^1.0.1"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.79.0",
+    "oxlint-tsgolint": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "oxlint-tsgolint": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "prepack": "rm -rf dist && tsc"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^7.0.2"
+  }
+}