pasika 0.3.2 → 0.3.4

package/dist/eslint/pasika/rules/type-extraction.js

@@ -1,85 +0,0 @@
-/**
- * ESLint rule: pasika/type-extraction
- *
- * A type or schema declared in a component MUST stay in that component file
- * until another file imports it without the component where it is defined, and
- * a type or schema declared outside a component MUST stay in its file until
- * another file needs it without using the code in that file. Importing the
- * type alongside the component that defines it never requires extraction.
- *
- * @see docs/code-organization-guide/rules/types-and-schemas-rule.md
- */
-import path from "node:path";
-import { getProjectIndex, symbolKey } from "../project/index.js";
-import { describeConsumers, segmentsOf } from "../project/ccf.js";
-export const typeExtractionRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require a type or schema imported without its defining code to be extracted.",
-        },
-    },
-    create(context) {
-        const sourceRoot = path.resolve("src");
-        const file = path.resolve(context.filename);
-        const segments = segmentsOf(file, sourceRoot);
-        if (segments.length === 0)
-            return {};
-        const index = getProjectIndex(sourceRoot);
-        if (!index)
-            return {};
-        const module = index.modules.get(file);
-        if (!module)
-            return {};
-        const componentExport = module.exports.find((exp) => exp.kind === "component");
-        // The code a consumer can use from this file besides types: hooks,
-        // schemas, constants, and functions.
-        const codeExports = module.exports.filter((exp) => exp.kind !== "type" && exp.kind !== "other");
-        const findings = [];
-        for (const exp of module.exports) {
-            if (exp.kind !== "type" && exp.kind !== "schema")
-                continue;
-            const consumers = [...(index.symbolConsumers.get(symbolKey(file, exp.name)) ?? [])];
-            if (consumers.length === 0)
-                continue;
-            if (componentExport) {
-                // A consumer that also imports the component uses the code alongside
-                // the type, so extraction is not required.
-                const componentConsumers = index.symbolConsumers.get(symbolKey(file, componentExport.name)) ?? new Set();
-                const independent = consumers.filter((consumer) => !componentConsumers.has(consumer));
-                if (independent.length === 0)
-                    continue;
-                findings.push({
-                    line: exp.line,
-                    message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent, sourceRoot)} without ` +
-                        `the component "${componentExport.name}" that defines it. Extract it to a types/ or schemas/ folder. ` +
-                        "See docs/code-organization-guide/rules/types-and-schemas-rule.md",
-                });
-                continue;
-            }
-            if (codeExports.length === 0)
-                continue;
-            // A consumer that imports any other code from this file uses the file as
-            // a whole; one that takes only the type needs it independently.
-            const independent = consumers.filter((consumer) => !codeExports.some((other) => index.symbolConsumers.get(symbolKey(file, other.name))?.has(consumer)));
-            if (independent.length === 0)
-                continue;
-            findings.push({
-                line: exp.line,
-                message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent, sourceRoot)} without using ` +
-                    "the code in this file. Extract it to a types/ or schemas/ folder. " +
-                    "See docs/code-organization-guide/rules/types-and-schemas-rule.md",
-            });
-        }
-        if (findings.length === 0)
-            return {};
-        return {
-            Program(node) {
-                for (const finding of findings) {
-                    context.report({ node, loc: { line: finding.line, column: 0 }, message: finding.message });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/ui-state.d.ts

@@ -1,9 +0,0 @@
-/**
- * ESLint rule: pasika/ui-state
- *
- * Enforces native or ARIA state expression and Tailwind state variants.
- *
- * @see docs/styling-guide/rules/component-ui-state-rule.md
- */
-import type { Rule } from "eslint";
-export declare const uiStateRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/ui-state.js

@@ -1,99 +0,0 @@
-/**
- * ESLint rule: pasika/ui-state
- *
- * Enforces native or ARIA state expression and Tailwind state variants.
- *
- * @see docs/styling-guide/rules/component-ui-state-rule.md
- */
-const STATE_PROPS = new Set([
-    "disabled",
-    "loading",
-    "selected",
-    "expanded",
-    "pressed",
-    "checked",
-    "busy",
-    "invalid",
-    "open",
-]);
-const STATE_ATTRIBUTES = new Set([
-    "disabled",
-    "aria-busy",
-    "aria-selected",
-    "aria-expanded",
-    "aria-pressed",
-    "aria-checked",
-    "aria-invalid",
-    "open",
-]);
-const STATE_CLASS_RE = /^(?:disabled|aria-(?:busy|selected|expanded|pressed|checked|invalid)|data-\[state)/;
-function isComponentElement(node) {
-    const name = node.openingElement?.name;
-    return name?.type === "JSXIdentifier" && /^[A-Z]/.test(name.name);
-}
-function expressionName(node) {
-    if (node?.type !== "JSXExpressionContainer")
-        return undefined;
-    if (node.expression?.type === "Identifier")
-        return node.expression.name;
-    return undefined;
-}
-export const uiStateRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require semantic UI states and Tailwind state variants.",
-        },
-    },
-    create(context) {
-        return {
-            JSXElement(node) {
-                if (!isComponentElement(node))
-                    return;
-                const attributes = node.openingElement?.attributes ?? [];
-                const names = new Set();
-                for (const attribute of attributes) {
-                    names.add(String(attribute.name?.name));
-                }
-                for (const attribute of attributes) {
-                    const name = String(attribute.name?.name);
-                    const stateName = expressionName(attribute.value);
-                    if (!stateName || !STATE_PROPS.has(stateName))
-                        continue;
-                    const hasNativeState = [...STATE_ATTRIBUTES].some((nativeName) => names.has(nativeName));
-                    if (!hasNativeState) {
-                        context.report({
-                            node: attribute,
-                            message: `UI state prop "${name}" should be expressed with a native or ARIA state attribute. ` +
-                                "See docs/styling-guide/rules/component-ui-state-rule.md",
-                        });
-                    }
-                }
-                for (const attribute of attributes) {
-                    if (String(attribute.name?.name) !== "className")
-                        continue;
-                    const value = attribute.value;
-                    const text = value?.type === "Literal" ? String(value.value) : "";
-                    if (value?.type === "JSXExpressionContainer" && value.expression.type === "ConditionalExpression") {
-                        const consequent = value.expression.consequent;
-                        const alternate = value.expression.alternate;
-                        const classes = [consequent, alternate]
-                            .filter((branch) => branch.type === "Literal" && typeof branch.value === "string")
-                            .flatMap((branch) => String(branch.value).split(/\s+/));
-                        if (classes.length > 0 && !classes.some((className) => STATE_CLASS_RE.test(className))) {
-                            context.report({
-                                node: attribute,
-                                message: "Use a Tailwind state variant for a UI state instead of conditional replacement classes. " +
-                                    "See docs/styling-guide/rules/component-ui-state-rule.md",
-                            });
-                        }
-                    }
-                    if (text.split(/\s+/).some((className) => className.includes("state-"))) {
-                        return;
-                    }
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/util-file-name.d.ts

@@ -1,2 +0,0 @@
-import type { Rule } from "eslint";
-export declare const utilFileNameRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/util-file-name.js

@@ -1,48 +0,0 @@
-import path from "node:path";
-import { parseModule } from "../project/parse-module.js";
-function toKebabCase(value) {
-    return value
-        .replace(/(?<lower>[a-z0-9])(?<upper>[A-Z])/g, "$<lower>-$<upper>")
-        .replace(/(?<first>[A-Z])(?<rest>[A-Z][a-z])/g, "$<first>-$<rest>")
-        .toLowerCase();
-}
-export const utilFileNameRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require single-function utility files to use the function's kebab-case name.",
-        },
-    },
-    create(context) {
-        const filename = path.resolve(context.filename);
-        const segments = filename.replace(/\\/g, "/").split("/");
-        if (!segments.includes("utils"))
-            return {};
-        let module;
-        try {
-            module = parseModule(filename);
-        }
-        catch {
-            return {};
-        }
-        const functions = module.exports.filter((entry) => entry.kind === "function");
-        if (functions.length !== 1 || module.exports.length !== 1)
-            return {};
-        const functionName = functions[0]?.name;
-        if (!functionName)
-            return {};
-        const expected = toKebabCase(functionName);
-        const actual = path.basename(filename, path.extname(filename));
-        if (!expected || actual === expected)
-            return {};
-        return {
-            Program(node) {
-                context.report({
-                    node,
-                    message: `A utility file exporting ${functionName} must be named ${expected}.${path.extname(filename).slice(1)}.`,
-                });
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/value-extraction.d.ts

@@ -1,13 +0,0 @@
-/**
- * ESLint rule: pasika/value-extraction
- *
- * A value MUST remain in its declaring component or file until another file
- * imports it independently; it MUST then be extracted as a constant. A file
- * under src/app/ is supposed to hold only framework-convention files, so a
- * consumer outside src/app/ reaching into one means a value has crossed the
- * independence threshold.
- *
- * @see docs/code-organization-guide/rules/constants-rule.md
- */
-import type { Rule } from "eslint";
-export declare const valueExtractionRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/value-extraction.js

@@ -1,48 +0,0 @@
-/**
- * ESLint rule: pasika/value-extraction
- *
- * A value MUST remain in its declaring component or file until another file
- * imports it independently; it MUST then be extracted as a constant. A file
- * under src/app/ is supposed to hold only framework-convention files, so a
- * consumer outside src/app/ reaching into one means a value has crossed the
- * independence threshold.
- *
- * @see docs/code-organization-guide/rules/constants-rule.md
- */
-import path from "node:path";
-import { getProjectIndex } from "../project/index.js";
-import { describeConsumers, segmentsOf } from "../project/ccf.js";
-export const valueExtractionRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require a value imported independently to be extracted as a constant.",
-        },
-    },
-    create(context) {
-        const sourceRoot = path.resolve("src");
-        const file = path.resolve(context.filename);
-        const segments = segmentsOf(file, sourceRoot);
-        if (segments.length === 0 || segments[0] !== "app")
-            return {};
-        const index = getProjectIndex(sourceRoot);
-        if (!index)
-            return {};
-        const consumers = [...(index.consumers.get(file) ?? [])];
-        const outsideApp = consumers.filter((consumer) => segmentsOf(consumer, sourceRoot)[0] !== "app");
-        if (outsideApp.length === 0)
-            return {};
-        return {
-            Program(node) {
-                context.report({
-                    node,
-                    loc: { line: 1, column: 0 },
-                    message: `This file in src/app/ is imported by ${describeConsumers(outsideApp, sourceRoot)} ` +
-                        "outside src/app/. Extract the value to a shared or feature folder so it can be " +
-                        "imported independently. See docs/code-organization-guide/rules/constants-rule.md",
-                });
-            },
-        };
-    },
-};