@jeremybarbet/oxlint-plugin 0.1.0

package/dist/rules/no-unused-class-members.mjs

@@ -0,0 +1,116 @@
+import { relative } from 'node:path';
+import { matchesGlob } from "../glob.mjs";
+import { getProjectIndex, readProjectSettings } from "../project-index.mjs";
+import {} from "../types.mjs";
+/**
+ * Neither knip nor tsc can see an unused *public class member*: knip analyses module-level exports
+ * only, and an exported, used class hides its whole body from it, while tsc's `noUnusedLocals`
+ * covers private members alone. In a NestJS codebase where nearly all logic lives on services,
+ * resolvers and processors, that is most of the code.
+ *
+ * The check is name-based rather than type-based, because oxlint exposes no type checker to JS
+ * plugins. That makes it deliberately conservative: a member whose name is referenced anywhere
+ * else — even on a different class — is treated as used, so the rule under-reports rather than
+ * pointing at live code.
+ */
+const DEFAULT_IGNORE_NAMES = [
+    'constructor',
+    /** NestJS lifecycle hooks, called by the framework and never by name. */
+    'onModuleInit',
+    'onModuleDestroy',
+    'onApplicationBootstrap',
+    'onApplicationShutdown',
+    'beforeApplicationShutdown',
+];
+/** Mirrors `knip --production` — code only a test reaches is still dead code. */
+const DEFAULT_IGNORE_USAGES_IN = ['**/*.spec.ts', '**/*.test.ts', '**/*.mock.ts', 'src/test/**'];
+const MEMBER_TYPES = new Set(['MethodDefinition', 'PropertyDefinition', 'AccessorProperty']);
+/**
+ * A class that extends or implements anything can have its members invoked polymorphically — by a
+ * base class, or by whatever holds the interface. `R2PMTilesSource implements Source` is called
+ * entirely by the `pmtiles` library, and `UserGuard extends AuthGuard(…)` has `getRequest` called
+ * by Passport. Neither reference shows up as a member access anywhere in this repo.
+ */
+const isPolymorphic = (node) => Boolean(node.superClass) || (node.implements ?? []).length > 0;
+const isReportableMember = (member, ignoreNames) => {
+    if (!MEMBER_TYPES.has(member.type) || member.computed || member.key?.type !== 'Identifier') {
+        return false;
+    }
+    // `#x` is already covered by the compiler, and `private x` is covered by `noUnusedLocals`.
+    if (member.accessibility === 'private' || member.kind === 'constructor') {
+        return false;
+    }
+    // A decorator means something outside the type system reaches this member — a `@Cron` schedule,
+    // a GraphQL `@Field`, a `class-validator` constraint. This is what kept `deprecatedDailyClouds`
+    // correctly silent until its `@Cron` was removed.
+    if ((member.decorators ?? []).length > 0) {
+        return false;
+    }
+    return !ignoreNames.includes(member.key.name);
+};
+const rule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow public class members that nothing outside the declaring file references',
+        },
+        messages: {
+            unused: "'{{name}}' is never referenced outside {{file}}. Remove it if it is dead.",
+            privateCandidate: "'{{name}}' is only referenced inside {{file}}. Mark it `private`.",
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    ignoreNames: { type: 'array', items: { type: 'string' } },
+                    ignoreUsagesIn: { type: 'array', items: { type: 'string' } },
+                    reportPrivateCandidates: { type: 'boolean' },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    create(context) {
+        const raw = (context.options?.[0] ?? {});
+        const ignoreNames = raw.ignoreNames ?? DEFAULT_IGNORE_NAMES;
+        const ignoreUsagesIn = raw.ignoreUsagesIn ?? DEFAULT_IGNORE_USAGES_IN;
+        const reportPrivateCandidates = raw.reportPrivateCandidates ?? false;
+        const index = getProjectIndex(context.cwd, readProjectSettings(context));
+        const self = context.filename;
+        // A file outside the indexed roots (or an unsaved buffer) has no entry, and every member in it
+        // would look unused. Staying silent is the only safe answer.
+        if (!index.files.has(self)) {
+            return {};
+        }
+        const countsAsUsage = (path) => path !== self && !matchesGlob(relative(index.root, path).split('\\').join('/'), ignoreUsagesIn);
+        return {
+            ClassBody(node) {
+                const declaration = node.parent;
+                if (!declaration || isPolymorphic(declaration)) {
+                    return;
+                }
+                for (const member of (node.body ?? [])) {
+                    if (!isReportableMember(member, ignoreNames)) {
+                        continue;
+                    }
+                    const name = member.key.name;
+                    const seenIn = index.memberUsage.get(name);
+                    if (seenIn && [...seenIn].some(countsAsUsage)) {
+                        continue;
+                    }
+                    const usedInternally = Boolean(seenIn?.has(self));
+                    if (usedInternally && !reportPrivateCandidates) {
+                        continue;
+                    }
+                    context.report({
+                        node: member.key,
+                        messageId: usedInternally ? 'privateCandidate' : 'unused',
+                        data: { name, file: relative(index.root, self) },
+                    });
+                }
+            },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=no-unused-class-members.mjs.map

package/dist/rules/no-unused-class-members.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-class-members.mjs","sourceRoot":"","sources":["../../src/rules/no-unused-class-members.mts"],"names":[],"mappings":"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"}

package/dist/rules/no-unused-modules.d.mts

@@ -0,0 +1,3 @@
+import { type Rule } from '../types.mts';
+declare const rule: Rule;
+export default rule;

package/dist/rules/no-unused-modules.mjs

@@ -0,0 +1,115 @@
+import { relative } from 'node:path';
+import { matchesGlob } from "../glob.mjs";
+import { getProjectIndex, readProjectSettings } from "../project-index.mjs";
+import {} from "../types.mjs";
+/**
+ * Port of `import/no-unused-modules` from `eslint-plugin-import`, which this repo used before
+ * moving to oxlint.
+ *
+ * It overlaps with `knip --production` by design — the difference is where the diagnostic lands.
+ * knip prints a report at the end of a separate command; this puts the error on the export itself,
+ * in the editor, on the same pass as every other lint rule.
+ */
+/**
+ * Always applied, on top of whatever a project configures. A `*.config.*` file is loaded by path by
+ * the tool that owns it, so its default export is an entry point by definition, never an import.
+ */
+const ALWAYS_IGNORED_EXPORTS = ['**/*.config.*'];
+const rule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow modules without exports, and exports nothing else imports',
+        },
+        messages: {
+            unused: "'{{name}}' is exported but never imported.",
+            missing: 'This file has no exports.',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    unusedExports: { type: 'boolean' },
+                    missingExports: { type: 'boolean' },
+                    ignoreExports: { type: 'array', items: { type: 'string' } },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    create(context) {
+        const raw = (context.options?.[0] ?? {});
+        const unusedExports = raw.unusedExports ?? true;
+        const missingExports = raw.missingExports ?? false;
+        const ignoreExports = [...ALWAYS_IGNORED_EXPORTS, ...(raw.ignoreExports ?? [])];
+        const index = getProjectIndex(context.cwd, readProjectSettings(context));
+        const self = context.filename;
+        const file = index.files.get(self);
+        if (!file) {
+            return {};
+        }
+        const relativePath = relative(index.root, self).split('\\').join('/');
+        if (matchesGlob(relativePath, ignoreExports)) {
+            return {};
+        }
+        const importers = index.importedFrom.get(self);
+        // A namespace import (`import * as x`) or a bare `import './x'` re-export pulls in everything,
+        // so no individual export can be called unused.
+        const wholeModuleUsed = Boolean(importers?.has('*'));
+        const isUsed = (name) => {
+            if (wholeModuleUsed || importers?.has(name)) {
+                return true;
+            }
+            // `@public` is the escape hatch knip already honours, and the codebase already uses it.
+            if (file.intentionalExports.has(name)) {
+                return true;
+            }
+            // An export consumed inside its own file is over-exposed, not dead — the fix is dropping the
+            // `export` keyword, not deleting the declaration. Reporting it as unused would be wrong, and
+            // it is what most of a codebase's exported return types look like.
+            return file.localReferences.has(name);
+        };
+        const report = (node, name) => {
+            if (!isUsed(name)) {
+                context.report({ node, messageId: 'unused', data: { name } });
+            }
+        };
+        return {
+            ExportNamedDeclaration(node) {
+                if (!unusedExports || node.source) {
+                    return;
+                }
+                for (const specifier of (node.specifiers ?? [])) {
+                    if (specifier.exported?.name) {
+                        report(specifier.exported, specifier.exported.name);
+                    }
+                }
+                const declaration = node.declaration;
+                if (!declaration) {
+                    return;
+                }
+                if (declaration.id?.name) {
+                    report(declaration.id, declaration.id.name);
+                    return;
+                }
+                for (const declarator of (declaration.declarations ?? [])) {
+                    if (declarator.id?.type === 'Identifier') {
+                        report(declarator.id, declarator.id.name);
+                    }
+                }
+            },
+            ExportDefaultDeclaration(node) {
+                if (unusedExports) {
+                    report(node, 'default');
+                }
+            },
+            'Program:exit'(node) {
+                if (missingExports && file.exports.size === 0) {
+                    context.report({ node, messageId: 'missing' });
+                }
+            },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=no-unused-modules.mjs.map

package/dist/rules/no-unused-modules.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-modules.mjs","sourceRoot":"","sources":["../../src/rules/no-unused-modules.mts"],"names":[],"mappings":"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"}

package/dist/rules/no-unused-styles.d.mts

@@ -0,0 +1,3 @@
+import { type Rule } from '../types.mts';
+declare const rule: Rule;
+export default rule;

package/dist/rules/no-unused-styles.mjs

@@ -0,0 +1,149 @@
+import {} from "../types.mjs";
+/** Special marker meaning "every style on this sheet is used". */
+const ALL_STYLES = '*';
+const getStyleNames = (object) => object.properties
+    .filter(prop => prop.type === 'Property' && prop.key?.type === 'Identifier')
+    .map(prop => prop.key.name);
+/**
+ * Resolve the object literal a `StyleSheet.create` argument ultimately produces.
+ *
+ * Handles the plain object form, plus the two function forms react-native-unistyles uses:
+ * `create(theme => ({ ... }))` and `create(theme => { return { ... } })`.
+ */
+const getStylesObject = (argument) => {
+    if (!argument) {
+        return null;
+    }
+    if (argument.type === 'ObjectExpression') {
+        return argument;
+    }
+    if (argument.type !== 'ArrowFunctionExpression') {
+        return null;
+    }
+    if (argument.body.type === 'ObjectExpression') {
+        return argument.body;
+    }
+    if (argument.body.type === 'BlockStatement') {
+        const returnStatement = argument.body.body.find(statement => statement.type === 'ReturnStatement');
+        if (returnStatement?.argument?.type === 'ObjectExpression') {
+            return returnStatement.argument;
+        }
+    }
+    return null;
+};
+const rule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow unused StyleSheet styles in React Native and react-native-unistyles',
+        },
+        messages: {
+            unusedStyle: 'Style "{{name}}" is defined but never used.',
+        },
+        schema: [],
+        fixable: 'code',
+    },
+    create(context) {
+        const styleSheets = new Map();
+        const usages = [];
+        return {
+            // Collect every member expression up front — the stylesheet it refers to may not have been
+            // visited yet, so matching is deferred to `Program:exit`.
+            MemberExpression(node) {
+                if (node.object.type !== 'Identifier') {
+                    return;
+                }
+                let styleName = null;
+                if (node.property.type === 'Identifier' && !node.computed) {
+                    styleName = node.property.name;
+                }
+                else if (node.property.type === 'Literal') {
+                    styleName = node.property.value;
+                }
+                if (styleName) {
+                    usages.push({ objectName: node.object.name, styleName });
+                }
+            },
+            'CallExpression[callee.object.name="StyleSheet"][callee.property.name="create"]'(node) {
+                if (node.parent.type !== 'VariableDeclarator') {
+                    return;
+                }
+                const variableName = node.parent.id.name;
+                const stylesNode = getStylesObject(node.arguments[0]);
+                if (!variableName || !stylesNode) {
+                    return;
+                }
+                const styles = getStyleNames(stylesNode);
+                if (styles.length > 0) {
+                    styleSheets.set(variableName, { node: stylesNode, styles: new Set(styles) });
+                }
+            },
+            // `const { container } = styles`
+            VariableDeclarator(node) {
+                if (node.init?.type !== 'Identifier' || node.id.type !== 'ObjectPattern') {
+                    return;
+                }
+                const objectName = node.init.name;
+                for (const prop of node.id.properties) {
+                    if (prop.type === 'Property' && prop.key.type === 'Identifier') {
+                        usages.push({ objectName, styleName: prop.key.name });
+                    }
+                }
+            },
+            // `{ ...styles }` — treat the whole sheet as used.
+            SpreadElement(node) {
+                if (node.argument?.type === 'Identifier') {
+                    usages.push({ objectName: node.argument.name, styleName: ALL_STYLES });
+                }
+            },
+            'Program:exit'() {
+                const usedStyles = new Set();
+                for (const { objectName, styleName } of usages) {
+                    const sheet = styleSheets.get(objectName);
+                    if (!sheet) {
+                        continue;
+                    }
+                    if (styleName === ALL_STYLES) {
+                        for (const name of sheet.styles) {
+                            usedStyles.add(`${objectName}.${name}`);
+                        }
+                    }
+                    else {
+                        usedStyles.add(`${objectName}.${styleName}`);
+                    }
+                }
+                for (const [sheetName, sheet] of styleSheets) {
+                    for (const styleName of sheet.styles) {
+                        if (usedStyles.has(`${sheetName}.${styleName}`)) {
+                            continue;
+                        }
+                        const styleNode = sheet.node.properties.find(prop => prop.key?.name === styleName);
+                        if (!styleNode) {
+                            continue;
+                        }
+                        context.report({
+                            node: styleNode.key,
+                            messageId: 'unusedStyle',
+                            data: { name: styleName },
+                            fix(fixer) {
+                                const { sourceCode } = context;
+                                const tokenAfter = sourceCode.getTokenAfter(styleNode);
+                                const tokenBefore = sourceCode.getTokenBefore(styleNode);
+                                // Swallow the trailing comma, or the leading one for the last property.
+                                if (tokenAfter?.value === ',') {
+                                    return fixer.removeRange([styleNode.range[0], tokenAfter.range[1]]);
+                                }
+                                if (tokenBefore?.value === ',') {
+                                    return fixer.removeRange([tokenBefore.range[0], styleNode.range[1]]);
+                                }
+                                return fixer.remove(styleNode);
+                            },
+                        });
+                    }
+                }
+            },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=no-unused-styles.mjs.map

package/dist/rules/no-unused-styles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-styles.mjs","sourceRoot":"","sources":["../../src/rules/no-unused-styles.mts"],"names":[],"mappings":"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"}

package/dist/rules/require-cache-control.d.mts

@@ -0,0 +1,3 @@
+import { type Rule } from '../types.mts';
+declare const rule: Rule;
+export default rule;

package/dist/rules/require-cache-control.mjs

@@ -0,0 +1,105 @@
+import {} from "../types.mjs";
+const SCALAR_TYPES = ['ID', 'String', 'Boolean', 'Int', 'Float', 'Number', 'Date'];
+const CACHE_FIELD_IMPORT = "import { CacheField } from '@/libs/cache-control/cache-field.decorator';";
+/**
+ * Resolve the GraphQL type name a `@Field(() => X)` thunk returns.
+ *
+ * Handles the two forms the codebase uses: `() => Type` and `() => [Type]`. Anything else
+ * (a member expression, a call, a literal) is treated as unknown and left alone.
+ */
+const getReturnedTypeName = (body) => {
+    if (body.type === 'Identifier') {
+        return body.name;
+    }
+    if (body.type === 'ArrayExpression') {
+        const first = body.elements[0];
+        if (first?.type === 'Identifier') {
+            return first.name;
+        }
+    }
+    return null;
+};
+/**
+ * We only want `@CacheField` on classes declared as `@ObjectType()`, because those are the
+ * responses Apollo caches. `@InputType()` is ignored — we don't cache mutation inputs.
+ */
+const isObjectTypeMember = (property) => {
+    const classNode = property.parent?.parent;
+    return (classNode?.decorators ?? []).some(decorator => decorator.expression?.callee?.name === 'ObjectType');
+};
+const rule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Require `@CacheField` over `@Field` for non-scalar GraphQL object type fields',
+        },
+        messages: {
+            noCacheControl: `Fields resolving as arrays/objects should configure @CacheField to not break Apollo's caching logic.`,
+        },
+        schema: [],
+        hasSuggestions: true,
+    },
+    create(context) {
+        let hasImport = false;
+        let lastImport = null;
+        return {
+            ImportDeclaration(node) {
+                lastImport = node;
+                for (const specifier of (node.specifiers ?? [])) {
+                    if (specifier.type === 'ImportSpecifier' && specifier.local?.name === 'CacheField') {
+                        hasImport = true;
+                    }
+                }
+            },
+            PropertyDefinition(node) {
+                if (!isObjectTypeMember(node)) {
+                    return;
+                }
+                const decorators = (node.decorators ?? []);
+                const hasCacheControl = decorators.some(decorator => decorator.expression?.callee?.name === 'CacheControl');
+                if (hasCacheControl) {
+                    return;
+                }
+                for (const decorator of decorators) {
+                    const callExpression = decorator.expression;
+                    if (callExpression?.type !== 'CallExpression' || callExpression.callee?.name !== 'Field') {
+                        continue;
+                    }
+                    const thunk = callExpression.arguments[0];
+                    if (thunk?.type !== 'ArrowFunctionExpression') {
+                        continue;
+                    }
+                    const typeName = getReturnedTypeName(thunk.body);
+                    if (typeName === null || SCALAR_TYPES.includes(typeName) || /json/i.test(typeName)) {
+                        continue;
+                    }
+                    context.report({
+                        node: callExpression,
+                        messageId: 'noCacheControl',
+                        suggest: [
+                            {
+                                desc: 'Use @CacheField() instead.',
+                                fix: fixer => {
+                                    const fixes = [fixer.replaceText(callExpression.callee, 'CacheField')];
+                                    if (!hasImport) {
+                                        if (lastImport) {
+                                            // insert after the last import decl
+                                            fixes.push(fixer.insertTextAfter(lastImport, `\n${CACHE_FIELD_IMPORT}`));
+                                        }
+                                        else {
+                                            // insert at the start of the file
+                                            fixes.push(fixer.insertTextAfterRange([0, 0], `${CACHE_FIELD_IMPORT}\n`));
+                                        }
+                                    }
+                                    return fixes;
+                                },
+                            },
+                        ],
+                    });
+                }
+            },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=require-cache-control.mjs.map

package/dist/rules/require-cache-control.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-cache-control.mjs","sourceRoot":"","sources":["../../src/rules/require-cache-control.mts"],"names":[],"mappings":"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"}

package/dist/types.d.mts

@@ -0,0 +1,70 @@
+/**
+ * Minimal structural types for oxlint's JS plugin API.
+ *
+ * Oxlint ships the full definitions in `oxlint/plugins-dev`, but only `RuleTester` is actually
+ * exported from that entrypoint, so the rule/context types are not importable. These cover the
+ * surface the local rules use — the AST is ESTree-shaped, same as ESLint's.
+ */
+export interface Node {
+    type: string;
+    parent: Node;
+    range: [number, number];
+    [key: string]: any;
+}
+interface Token {
+    type: string;
+    value: string;
+    range: [number, number];
+}
+interface Fixer {
+    remove(node: Node): unknown;
+    removeRange(range: [number, number]): unknown;
+    replaceText(node: Node, text: string): unknown;
+    insertTextAfter(node: Node, text: string): unknown;
+    insertTextAfterRange(range: [number, number], text: string): unknown;
+}
+interface Suggestion {
+    desc: string;
+    fix: (fixer: Fixer) => unknown;
+}
+interface SourceCode {
+    getTokenAfter(node: Node): Token | null;
+    getTokenBefore(node: Node): Token | null;
+}
+export interface Context {
+    sourceCode: SourceCode;
+    /** Absolute path of the file being linted. */
+    filename: string;
+    /** Absolute path oxlint was invoked from — the project root. */
+    cwd: string;
+    /** Whatever was passed after the severity in `oxlint.config.mts`. */
+    options?: unknown[];
+    /** The config's `settings` block — shared by rules, unlike per-rule `options`. */
+    settings?: Record<string, unknown>;
+    report(diagnostic: {
+        node: Node;
+        messageId: string;
+        data?: Record<string, string | number | boolean | null | undefined>;
+        fix?: (fixer: Fixer) => unknown;
+        suggest?: Suggestion[];
+    }): void;
+}
+/**
+ * Named so a rule that bails early can annotate its `create` return and have `return {}` checked
+ * against this directly, instead of TS widening the two branches into an awkward union.
+ */
+export type Visitor = Record<string, (node: any) => void>;
+export interface Rule {
+    meta: {
+        type: 'problem' | 'suggestion' | 'layout';
+        docs: {
+            description: string;
+        };
+        messages: Record<string, string>;
+        schema: unknown[];
+        fixable?: 'code' | 'whitespace';
+        hasSuggestions?: boolean;
+    };
+    create(context: Context): Visitor;
+}
+export {};

package/dist/types.mjs

@@ -0,0 +1,9 @@
+/**
+ * Minimal structural types for oxlint's JS plugin API.
+ *
+ * Oxlint ships the full definitions in `oxlint/plugins-dev`, but only `RuleTester` is actually
+ * exported from that entrypoint, so the rule/context types are not importable. These cover the
+ * surface the local rules use — the AST is ESTree-shaped, same as ESLint's.
+ */
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}