@ashstack/lint 0.3.1 → 0.5.0

package/dist/lib/rule-types/react-native.d.ts

@@ -0,0 +1,333 @@
+import type { AllowWarnDeny } from "oxlint";
+/** Every rule id `react-native()` adds on top of the entry below it. */
+export type ReactNativeRuleId = "@ashstack/react-native/no-keyboard-will-events" | "@ashstack/react-native/no-scroll-position-state" | "@ashstack/react-native/no-conditional-style-array" | "@ashstack/react-native/no-leaked-render" | "@ashstack/react-native/no-rn-image-network-source" | "@ashstack/react-native/no-redundant-view-nesting" | "@ashstack/react-native/no-rn-namespace-import" | "@ashstack/react-native/no-unlabeled-icon-pressable" | "@ashstack/react-native/hoist-stateless-function" | "@ashstack/react-native/no-manual-memo" | "@ashstack/react-native/no-dynamic-import" | "@ashstack/unistyles/animated-theme" | "@ashstack/unistyles/content-container" | "@ashstack/unistyles/in-sheet" | "@ashstack/unistyles/insets" | "@ashstack/unistyles/no-hardcoded-color" | "@ashstack/unistyles/no-hardcoded-spacing" | "@ashstack/unistyles/no-margin" | "@ashstack/unistyles/no-style-spread" | "@ashstack/unistyles/no-unused-styles" | "@ashstack/unistyles/rtl-style-call" | "@ashstack/unistyles/theme-screen-component" | "@ashstack/unistyles/theme-style-attr" | "@ashstack/legend-list/required-props" | "@ashstack/legend-list/no-index-key-extractor" | "@ashstack/legend-list/no-remount-key" | "@ashstack/legend-list/no-inline-render-item-props" | "@ashstack/legend-list/no-mixed-children" | "@ashstack/legend-list/no-flex-in-content-container" | "@ashstack/legend-list/typed-items-need-item-type" | "@ashstack/legend-list/no-scrollview-map" | "@ashstack/legend-list/no-unsupported-props" | "@ashstack/legend-state/no-assignment" | "@ashstack/legend-state/naming" | "@ashstack/legend-state/no-nested-observable" | "@ashstack/legend-state/no-react-mirror" | "@ashstack/legend-state/no-untracked-get-in-jsx" | "@ashstack/legend-state/no-peek-in-selector" | "@ashstack/legend-state/no-object-selector" | "@ashstack/legend-state/no-observable-in-component" | "@ashstack/reanimated/animated-reaction-safety" | "@ashstack/reanimated/animated-style-needs-animated-component" | "@ashstack/reanimated/animated-updater-purity" | "@ashstack/reanimated/gpu-properties-only" | "@ashstack/reanimated/hoist-layout-animation-builder" | "@ashstack/reanimated/interpolate-needs-clamp" | "@ashstack/reanimated/no-shared-value-dot-value" | "@ashstack/reanimated/no-react-state-from-continuous-worklet" | "@ashstack/reanimated/prefer-lazy-shared-value-initializer" | "@ashstack/reanimated/schedule-on-rn-scope" | "@ashstack/reanimated/shared-value-usage" | "@ashstack/turbo-image/require-resize" | "@ashstack/turbo-image/require-cache-policy" | "@ashstack/skia/canvas-opaque";
+declare module "oxlint" {
+    interface DummyRuleMap {
+        /**
+         * Disallow the `keyboardWill*` event names. They are iOS-only, so on Android the listener registers and never fires.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-keyboard-will-events
+         */
+        "@ashstack/react-native/no-keyboard-will-events"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a React state setter inside a scroll handler prop. Scroll fires every frame, and so would the re-render.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-scroll-position-state
+         */
+        "@ashstack/react-native/no-scroll-position-state"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow conditional and logical entries inside a JSX `style` array. A falsy entry leaves a hole that breaks the Unistyles C++ proxy.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-conditional-style-array
+         */
+        "@ashstack/react-native/no-conditional-style-array"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a `&&` guard in JSX on a value this rule can see is a number or a string — a `.length`, a `.size`, arithmetic, a literal. The falsy left operand leaks into the output, and a bare `0` crashes React Native with "Text strings must be rendered within a <Text> component".
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-leaked-render
+         */
+        "@ashstack/react-native/no-leaked-render"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a react-native `<Image>` with a network `{ uri }` source. It has no disk cache and no decode sizing, so the image re-downloads at full size on every cold start.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-rn-image-network-source
+         */
+        "@ashstack/react-native/no-rn-image-network-source"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a View or Animated.View that wraps an identical view when neither carries anything but a style. Every extra host view is a real node in the native tree.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-redundant-view-nesting
+         */
+        "@ashstack/react-native/no-redundant-view-nesting"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a namespace import of react-native and a re-export of its `Platform`. Both defeat Metro's platform shaking, so dead `Platform.OS` branches ship in both bundles.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-rn-namespace-import
+         */
+        "@ashstack/react-native/no-rn-namespace-import"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require an accessible name on an icon-only touchable or an icon-only Expo UI `<Button>`. Without a label, hint or visible text, a screen reader cannot reach the control.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-unlabeled-icon-pressable
+         */
+        "@ashstack/react-native/no-unlabeled-icon-pressable"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require module scope for a non-component function that reads nothing from the component around it. Out there it is created once, keeps a stable identity, and can be tested without rendering.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativehoist-stateless-function
+         */
+        "@ashstack/react-native/hoist-stateless-function"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require a `// why:` line above every kept `useMemo`, `useCallback` and `memo`. The React Compiler memoises on a best-effort basis, not a guarantee, so a memo is allowed where the cost is real: something rendered per list row, or a computation measured as heavy. The `// why:` line names which of the two applies. `@ashstack/core/no-comments` keeps that line and never counts it against its `budget`, so both rules run together.
+         *
+         * Enabled only when one of `babel-plugin-react-compiler`, `react-compiler-runtime`, `react-compiler-marker` is a dependency.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-manual-memo
+         */
+        "@ashstack/react-native/no-manual-memo"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow dynamic `import()` outside a `React.lazy` or `dynamic` wrapper. Metro inlines it into the same bundle, so nothing is deferred and the module is hidden from the typechecker.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreact-nativeno-dynamic-import
+         */
+        "@ashstack/react-native/no-dynamic-import"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A Reanimated worklet hook cannot see `useUnistyles()` theme changes on the UI thread. Read the shared value from `useAnimatedTheme()` there instead.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesanimated-theme
+         */
+        "@ashstack/unistyles/animated-theme"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A raw component never subscribes its `contentContainerStyle` to theme or `rt` updates. Wrap the component with `withUnistyles` when the style depends on either.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylescontent-container
+         */
+        "@ashstack/unistyles/content-container"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * 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`.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesin-sheet
+         */
+        "@ashstack/unistyles/in-sheet"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow passing `useSafeAreaInsets()` values into a dynamic style function or an inline JSX style object. Read `rt.insets` inside `StyleSheet.create` instead.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesinsets
+         */
+        "@ashstack/unistyles/insets"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow hex and CSS-function colors inside `StyleSheet.create`. A raw color skips dark mode and never changes with the theme.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesno-hardcoded-color
+         */
+        "@ashstack/unistyles/no-hardcoded-color"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require `theme.spacing` or `theme.sizing.scale` for spacing, radius and type values inside `StyleSheet.create`, instead of raw numbers.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesno-hardcoded-spacing
+         */
+        "@ashstack/unistyles/no-hardcoded-spacing"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow non-negative `margin` inside `StyleSheet.create`; `gap` on the parent or `padding` on the element spaces children without leaving a hole when one is removed.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesno-margin
+         */
+        "@ashstack/unistyles/no-margin"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow spreading a stylesheet style into another object. The spread reads through the Unistyles C++ proxy once, so the result stops reacting to the theme.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesno-style-spread
+         */
+        "@ashstack/unistyles/no-style-spread"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow stylesheet keys that nothing in the file reads. A computed key, a computed read, or a sheet that leaves the module skips the whole file.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesno-unused-styles
+         */
+        "@ashstack/unistyles/no-unused-styles"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow passing `I18nManager.isRTL` from JSX into a dynamic style function. Unistyles tracks the dependency itself once the style reads `rt.rtl`.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylesrtl-style-call
+         */
+        "@ashstack/unistyles/rtl-style-call"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * `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.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylestheme-screen-component
+         */
+        "@ashstack/unistyles/theme-screen-component"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Theme-dependent values belong in `StyleSheet.create`, not in a JSX `style` prop that reads a `useUnistyles()` theme.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistylestheme-style-attr
+         */
+        "@ashstack/unistyles/theme-style-attr"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require `keyExtractor` and an explicit `recycleItems` on a Legend List. Without a key extractor the list keys its rows by index.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listrequired-props
+         */
+        "@ashstack/legend-list/required-props"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a `keyExtractor` that uses its index parameter. Cached sizes and recycled row state hang off the key, so a prepend points every measurement at the wrong item.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-index-key-extractor
+         */
+        "@ashstack/legend-list/no-index-key-extractor"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow `key` on a Legend List, which remounts on any key change and loses its measurements and scroll position. Pass `dataKey` instead.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-remount-key
+         */
+        "@ashstack/legend-list/no-remount-key"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow inline object and array literals on props nested inside `renderItem`. A row whose props take a new identity every render can never be skipped.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-inline-render-item-props
+         */
+        "@ashstack/legend-list/no-inline-render-item-props"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow passing both `data` and real children to a Legend List. The combination is unsupported and one of the two is dropped without a warning.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-mixed-children
+         */
+        "@ashstack/legend-list/no-mixed-children"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow `flex` in a Legend List's `contentContainerStyle`, where it sizes the scrolled content to the viewport and the list ends up measuring zero height.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-flex-in-content-container
+         */
+        "@ashstack/legend-list/no-flex-in-content-container"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require `getItemType` when a row branches on `item.type`. Without it every layout shares one recycling pool and one size average.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listtyped-items-need-item-type
+         */
+        "@ashstack/legend-list/typed-items-need-item-type"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A `ScrollView` mounts every child up front, so a mapped collection does not belong in its children.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-scrollview-map
+         */
+        "@ashstack/legend-list/no-scrollview-map"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow FlashList and FlatList props that Legend List v3 does not have. It ignores them rather than rejecting them, so the feature looks broken.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-listno-unsupported-props
+         */
+        "@ashstack/legend-list/no-unsupported-props"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Write an observable with `.set(...)` or `.assign({...})`. Assigning or incrementing it with an operator is a silent no-op.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-assignment
+         */
+        "@ashstack/legend-state/no-assignment"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A variable initialized from `observable()` or `useObservable()` needs a trailing `$`. The other rules in this module key off that suffix.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-statenaming
+         */
+        "@ashstack/legend-state/naming"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Never pass an observable to `observable()` or `useObservable()`. The wrapper is a second node, and reads and writes on it never reach the original.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-nested-observable
+         */
+        "@ashstack/legend-state/no-nested-observable"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Seeding `useState` from an observable's `get()` or `peek()` gives the value two owners. Read it with `useValue(...)` where it renders.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-react-mirror
+         */
+        "@ashstack/legend-state/no-react-mirror"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A `get()` placed directly in a JSX expression container is a plain read. The value renders once and never updates.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-untracked-get-in-jsx
+         */
+        "@ashstack/legend-state/no-untracked-get-in-jsx"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * `peek()` never subscribes, so a selector or tracking callback that uses it never re-runs. Call `get()` there and keep `peek()` for handlers.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-peek-in-selector
+         */
+        "@ashstack/legend-state/no-peek-in-selector"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A `useValue` selector that builds a new object or array returns a fresh identity every run. The component then re-renders on every store change.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-object-selector
+         */
+        "@ashstack/legend-state/no-object-selector"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Calling `observable()` inside a component or hook makes a new observable on every render. Use `useObservable()` or a module-level store instead.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-stateno-observable-in-component
+         */
+        "@ashstack/legend-state/no-observable-in-component"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A `useAnimatedReaction` result callback loops forever if it writes a shared value the prepare callback reads. Guard `scheduleOnRN` there on the current result differing from the previous one.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedanimated-reaction-safety
+         */
+        "@ashstack/reanimated/animated-reaction-safety"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * An animated style only takes effect on an `Animated.*` component. A plain element applies it once at mount and then never updates.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedanimated-style-needs-animated-component
+         */
+        "@ashstack/reanimated/animated-style-needs-animated-component"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * An updater passed to `useAnimatedStyle` or `useAnimatedProps` must stay pure, so it may not write a shared value or call `scheduleOnRN`.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedanimated-updater-purity
+         */
+        "@ashstack/reanimated/animated-updater-purity"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Animate `transform` and `opacity` in `useAnimatedStyle` and `useAnimatedProps`. Layout properties such as `width` or `margin` recalculate layout every frame.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedgpu-properties-only
+         */
+        "@ashstack/reanimated/gpu-properties-only"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A layout animation belongs at module scope, or inside a memo when it depends on component values. The `entering`/`exiting`/`layout` props otherwise rebuild it on every render.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedhoist-layout-animation-builder
+         */
+        "@ashstack/reanimated/hoist-layout-animation-builder"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Give `interpolate()` a fourth argument that clamps. Without one, or with `EXTEND` or `IDENTITY`, the output keeps going past the ends of the input range.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedinterpolate-needs-clamp
+         */
+        "@ashstack/reanimated/interpolate-needs-clamp"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Shared values are read with `.get()` and written with `.set(...)`, never through `.value`. React Compiler cannot track a `.value` access.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedno-shared-value-dot-value
+         */
+        "@ashstack/reanimated/no-shared-value-dot-value"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * A worklet that runs every frame must not send a React state setter through `scheduleOnRN`. That puts a Fabric commit on an animation frame.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedno-react-state-from-continuous-worklet
+         */
+        "@ashstack/reanimated/no-react-state-from-continuous-worklet"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Pass a computed `useSharedValue` initial value as a function. An eager call runs on every render while only the first result is kept.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedprefer-lazy-shared-value-initializer
+         */
+        "@ashstack/reanimated/prefer-lazy-shared-value-initializer"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * `scheduleOnRN` takes a function declared in RN Runtime scope. An inline callback can end up created on the wrong runtime.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedschedule-on-rn-scope
+         */
+        "@ashstack/reanimated/schedule-on-rn-scope"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Destructuring a shared value or mutating what its `get()` returned detaches it from Reanimated reactivity. Reading or writing one while JSX evaluates also makes render impure.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimatedshared-value-usage
+         */
+        "@ashstack/reanimated/shared-value-usage"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * 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.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackturbo-imagerequire-resize
+         */
+        "@ashstack/turbo-image/require-resize"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * 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.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackturbo-imagerequire-cache-policy
+         */
+        "@ashstack/turbo-image/require-cache-policy"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * 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.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackskiacanvas-opaque
+         */
+        "@ashstack/skia/canvas-opaque"?: AllowWarnDeny | [AllowWarnDeny];
+    }
+}

package/dist/lib/rule-types/react-native.js

@@ -0,0 +1 @@
+export{};

package/dist/lib/rule-types/react.d.ts

@@ -0,0 +1,153 @@
+import type { AllowWarnDeny } from "oxlint";
+/** Every rule id `react()` adds on top of the entry below it. */
+export type ReactRuleId = "@ashstack/react/no-unlabeled-icon-button" | "@ashstack/react/no-svg-without-title" | "@ashstack/query/no-inline-keys" | "@ashstack/query/no-deprecated-filters" | "@ashstack/query/require-destructured-hooks" | "@ashstack/query/no-fetch-in-query-fn" | "@ashstack/query/next-page-param-undefined" | "@ashstack/zustand/require-selector" | "@ashstack/i18n/no-bare-text" | "@ashstack/i18n/no-bare-attrs" | "@ashstack/i18n/no-bare-toast" | "@ashstack/tailwind/prefer-cn" | "@ashstack/tailwind/use-logical-classes" | "@ashstack/tanstack-router/require-selector" | "@ashstack/tanstack-router/no-search-casts" | "@ashstack/effects/no-derived-state" | "@ashstack/effects/no-chain-state-updates" | "@ashstack/effects/no-event-handler" | "@ashstack/effects/no-adjust-state-on-prop-change" | "@ashstack/effects/no-reset-all-state-on-prop-change" | "@ashstack/effects/no-pass-live-state-to-parent" | "@ashstack/effects/no-pass-data-to-parent" | "@ashstack/effects/no-external-store-subscription" | "@ashstack/effects/no-initialize-state";
+declare module "oxlint" {
+    interface DummyRuleMap {
+        /**
+         * Require an accessible name on an icon-only `<button>` or `<Button>`. Without a label, visible text or image alt text, a screen reader cannot reach the control.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreactno-unlabeled-icon-button
+         */
+        "@ashstack/react/no-unlabeled-icon-button"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require an accessible name on an inline `<svg>`: a `<title>` child with content, an `aria-label`, or a marker that it is decorative. Every child counts, and a self-closing `<svg />` reports.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreactno-svg-without-title
+         */
+        "@ashstack/react/no-svg-without-title"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a query key written as an array literal at the call site instead of coming from a keys factory.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackqueryno-inline-keys
+         */
+        "@ashstack/query/no-inline-keys"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow the positional key argument that TanStack Query v5 removed from `invalidateQueries` and its sibling methods. The suggestion rewrites it to the filter-object form.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackqueryno-deprecated-filters
+         */
+        "@ashstack/query/no-deprecated-filters"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require destructuring the result of a hook imported from an `@/api/*.queries` or `@/api/*.mutations` module.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackqueryrequire-destructured-hooks
+         */
+        "@ashstack/query/require-destructured-hooks"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a bare `fetch(` inside a `queryFn` or `mutationFn`.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackqueryno-fetch-in-query-fn
+         */
+        "@ashstack/query/no-fetch-in-query-fn"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow `return null` in the body of a `getNextPageParam`.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackquerynext-page-param-undefined
+         */
+        "@ashstack/query/next-page-param-undefined"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require a selector on a store hook, rather than no arguments or `undefined` in its place.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackzustandrequire-selector
+         */
+        "@ashstack/zustand/require-selector"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a JSX element that carries no attributes and whose single child is plain literal text.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacki18nno-bare-text
+         */
+        "@ashstack/i18n/no-bare-text"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow a plain string literal on a configurable list of user-visible JSX attributes, defaulting to placeholder, accessibilityLabel, accessibilityHint and title.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacki18nno-bare-attrs
+         */
+        "@ashstack/i18n/no-bare-attrs"?: AllowWarnDeny | [AllowWarnDeny] | [AllowWarnDeny, {
+            attributes?: Array<string>;
+        }];
+        /**
+         * Disallow a `toast.*` call whose only argument is a string literal.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacki18nno-bare-toast
+         */
+        "@ashstack/i18n/no-bare-toast"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require a dynamic class value to go through `cn(...)` before it reaches a `class`, `className` or `*ClassName` prop. Reports both where the value reaches the prop and where a variable named after classes is declared.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktailwindprefer-cn
+         */
+        "@ashstack/tailwind/prefer-cn"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require a logical Tailwind utility over its physical left/right twin, so a right-to-left layout mirrors. Reads class props and bindings named after classes, through variant prefixes and the `!` and `-` modifiers.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktailwinduse-logical-classes
+         */
+        "@ashstack/tailwind/use-logical-classes"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Require a `select` on `useLocation`, `useRouterState` and non-strict `useSearch`, so a component reads the smallest router value it needs instead of re-rendering on every navigation.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktanstack-routerrequire-selector
+         */
+        "@ashstack/tanstack-router/require-selector"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow an `as` assertion on a `useSearch()` result or on `router.state.location.search`. The route's `validateSearch` schema is what supplies the type.
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktanstack-routerno-search-casts
+         */
+        "@ashstack/tanstack-router/no-search-casts"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow storing derived state in an effect. [Why](https://react.dev/learn/you-might-not-need-an-effect#updating-state-based-on-props-or-state)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-derived-state
+         */
+        "@ashstack/effects/no-derived-state"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow chaining state changes in an effect. [Why](https://react.dev/learn/you-might-not-need-an-effect#chains-of-computations)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-chain-state-updates
+         */
+        "@ashstack/effects/no-chain-state-updates"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow using state and an effect as an event handler. [Why](https://react.dev/learn/you-might-not-need-an-effect#sharing-logic-between-event-handlers)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-event-handler
+         */
+        "@ashstack/effects/no-event-handler"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow adjusting state in an effect when a prop changes. [Why](https://react.dev/learn/you-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-adjust-state-on-prop-change
+         */
+        "@ashstack/effects/no-adjust-state-on-prop-change"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow resetting all state in an effect when a prop changes. [Why](https://react.dev/learn/you-might-not-need-an-effect#resetting-all-state-when-a-prop-changes)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-reset-all-state-on-prop-change
+         */
+        "@ashstack/effects/no-reset-all-state-on-prop-change"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow passing live state to parents in an effect. [Why](https://react.dev/learn/you-might-not-need-an-effect#notifying-parent-components-about-state-changes)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-pass-live-state-to-parent
+         */
+        "@ashstack/effects/no-pass-live-state-to-parent"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow passing data to parents in an effect. [Why](https://react.dev/learn/you-might-not-need-an-effect#passing-data-to-the-parent)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-pass-data-to-parent
+         */
+        "@ashstack/effects/no-pass-data-to-parent"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow subscribing to an external store in an effect. [Why](https://react.dev/learn/you-might-not-need-an-effect#subscribing-to-an-external-store)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-external-store-subscription
+         */
+        "@ashstack/effects/no-external-store-subscription"?: AllowWarnDeny | [AllowWarnDeny];
+        /**
+         * Disallow initializing state in an effect. [Why](https://tkdodo.eu/blog/avoiding-hydration-mismatches-with-use-sync-external-store)
+         *
+         * @see https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackeffectsno-initialize-state
+         */
+        "@ashstack/effects/no-initialize-state"?: AllowWarnDeny | [AllowWarnDeny];
+    }
+}

package/dist/lib/rule-types/react.js

@@ -0,0 +1 @@
+export{};

package/dist/lib/types.d.ts

@@ -69,22 +69,49 @@ export interface ModuleManifest {
     /** import bans that ship with (and only with) this module */
     restrictedImports?: RestrictedImports;
 }
+/**
+ * What a config needs from a module: the plugin file to hand oxlint, and the
+ * two flags per rule that decide whether it is on. Generated into
+ * `lib/registry.ts` from the manifests, so a config never imports rule code
+ * that oxlint is going to load from the path anyway.
+ */
+export interface ModuleMeta {
+    meta: {
+        name: `@ashstack/${string}`;
+    };
+    /** Absolute URL of the module's plugin file. */
+    url: string;
+    /** Enable when one of these is a dependency; absent = always on. */
+    packages?: string[];
+    /** Key in the entry options that forces the module on/off; absent = auto-only. */
+    option?: string;
+    restrictedImports?: RestrictedImports;
+    /** Rule name to the flags that gate it: off unless asked for, or gated on its own dependency. */
+    rules: Record<string, {
+        defaultOff?: boolean;
+        packages?: string[];
+    }>;
+}
 /** A ban-only group: import bans gated on a library, with no rules of its own. */
 export interface BanGroup {
     packages: string[];
     restrictedImports: RestrictedImports;
 }
 export type CoreOptions = {
-    /** `@ashstack/zod/` rules — detected from `zod` */
+    /** [`@ashstack/zod/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackzod) — detected from `zod` */
     zod?: boolean;
 };
 export type ReactOptions = CoreOptions & {
-    /** `@ashstack/query/` rules — detected from `@tanstack/react-query` */
+    /** [`@ashstack/query/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackquery) — detected from `@tanstack/react-query` */
     query?: boolean;
-    /** `@ashstack/zustand/` rules — detected from `zustand` */
+    /** [`@ashstack/zustand/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackzustand) — detected from `zustand` */
     zustand?: boolean;
-    /** `@ashstack/i18n/` rules — detected from i18next/lingui/react-intl/use-intl/next-intl/expo-localization */
+    /** [`@ashstack/i18n/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacki18n) — detected from i18next/lingui/react-intl/use-intl/next-intl/expo-localization */
     i18n?: boolean;
+    /** [`@ashstack/tailwind/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktailwind) — detected from `tailwindcss` */
+    tailwind?: boolean;
+    /** [`@ashstack/tanstack-router/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacktanstack-router) — detected from `@tanstack/react-router` */
+    tanstackRouter?: boolean;
 };
 /**
  * Every toggle is a rule module — one rule namespace each. Import bans and
@@ -92,23 +119,24 @@ export type ReactOptions = CoreOptions & {
  * by name in your `rules` block.
  */
 export type ReactNativeOptions = ReactOptions & {
-    /** `@ashstack/unistyles/` rules + StyleSheet/Dimensions/SafeArea import bans — `react-native-unistyles` */
+    /** [`@ashstack/unistyles/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackunistyles) + StyleSheet/Dimensions/SafeArea import bans — `react-native-unistyles` */
     unistyles?: boolean;
-    /** `@ashstack/legend-list/` rules + FlatList/FlashList bans — `@legendapp/list` */
+    /** [`@ashstack/legend-list/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-list) + FlatList/FlashList bans — `@legendapp/list` */
     legendList?: boolean;
-    /** `@ashstack/legend-state/` rules + use$/useSelector ban — `@legendapp/state` */
+    /** [`@ashstack/legend-state/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstacklegend-state) + use$/useSelector ban — `@legendapp/state` */
     legendState?: boolean;
-    /** `@ashstack/reanimated/` rules + Animated/runOnJS bans — `react-native-reanimated` */
+    /** [`@ashstack/reanimated/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackreanimated) + Animated/runOnJS bans — `react-native-reanimated` */
     reanimated?: boolean;
-    /** `@ashstack/turbo-image/` rules — `react-native-turbo-image` */
+    /** [`@ashstack/turbo-image/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackturbo-image) — `react-native-turbo-image` */
     turboImage?: boolean;
-    /** `@ashstack/skia/` rules — `@shopify/react-native-skia` */
+    /** [`@ashstack/skia/` rules](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackskia) — `@shopify/react-native-skia` */
     skia?: boolean;
-    /** `@ashstack/keyboard` import bans — `react-native-keyboard-controller` */
+    /** [`@ashstack/keyboard` import bans](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#ashstackkeyboard) — `react-native-keyboard-controller` */
     keyboard?: boolean;
 };
 /** The config object an entry returns: oxlint's own shape, so `defineConfig({ extends: [core()] })` typechecks. */
 export type OxlintConfig = OxlintNativeConfig;
 /** The `rules` block of a config: oxlint's own map, so a built-in rule's options are checked. */
 export type RuleMap = NonNullable<OxlintConfig["rules"]>;
+export type JsPlugin = NonNullable<OxlintConfig["jsPlugins"]>[number];
 export {};

package/dist/modules.js

@@ -0,0 +1 @@
+import o from"./core/rules/core/index.js";import r from"./core/rules/zod/index.js";import e from"./react-native/rules/keyboard/index.js";import t from"./react-native/rules/legend-list/index.js";import m from"./react-native/rules/legend-state/index.js";import d from"./react-native/rules/react-native/index.js";import i from"./react-native/rules/reanimated/index.js";import u from"./react-native/rules/skia/index.js";import l from"./react-native/rules/turbo-image/index.js";import p from"./react-native/rules/unistyles/index.js";import M from"./react/rules/i18n/index.js";import a from"./react/rules/query/index.js";import f from"./react/rules/react/index.js";import s from"./react/rules/tailwind/index.js";import n from"./react/rules/tanstack-router/index.js";import c from"./react/rules/zustand/index.js";export const coreModules=[o,r],reactModules=[f,a,c,M,s,n],reactNativeModules=[d,p,t,m,i,l,u,e];

package/dist/react/index.d.ts

@@ -1,9 +1,14 @@
 import type { OxlintConfig, ReactOptions } from "../lib/types.js";
-export declare const reactModules: import("../lib/types.js").ModuleManifest[];
 /**
  * React (web) entry — everything in core plus react, jsx-a11y, React Compiler
  * diagnostics, you-might-not-need-an-effect, and the auto-detected library
  * modules (query, zustand, i18n).
+ *
+ * @see [every rule `react()` sets](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md#react)
  */
 declare const react: (options?: ReactOptions) => OxlintConfig;
+export { react };
+export type { CoreRuleId } from "../lib/rule-types/core.js";
+export type { ReactRuleId } from "../lib/rule-types/react.js";
+export type { ReactOptions, ModuleManifest } from "../lib/types.js";
 export default react;