pasika 0.3.2 → 0.3.4

package/dist/eslint/pasika/rules/enforce-barrel-exports.js

@@ -1,78 +0,0 @@
-/**
- * ESLint rule: pasika/enforce-barrel-exports
- *
- * Enforces the "Folder Nesting Rule" — index.ts only re-exports parent component.
- *
- * @see docs/code-organization-guide/rules/folder-nesting-rule.md
- */
-import path from "node:path";
-import fs from "node:fs";
-function isPascalCase(str) {
-    return /^[A-Z][A-Za-z0-9]*$/.test(str);
-}
-function isKebabCase(str) {
-    return /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(str);
-}
-const SUPPORT_FOLDERS = new Set(["types", "schemas", "hooks", "constants", "utils", "config", "locales"]);
-export const enforceBarrelExportsRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Enforce index.ts barrels only re-export the parent component.",
-        },
-    },
-    create(context) {
-        const filename = context.filename;
-        if (!filename)
-            return {};
-        const baseName = path.basename(filename);
-        if (baseName !== "index.ts" && baseName !== "index.cts" && baseName !== "index.mts")
-            return {};
-        const dirPath = path.dirname(filename);
-        const folderName = path.basename(dirPath);
-        const parentFolderName = path.basename(path.dirname(dirPath));
-        if (SUPPORT_FOLDERS.has(folderName))
-            return {};
-        if (!isPascalCase(folderName) && !isKebabCase(folderName))
-            return {};
-        const matchingTsx = fs.existsSync(path.join(dirPath, `${folderName}.tsx`)) ? folderName : null;
-        if (!matchingTsx)
-            return {};
-        if (!isPascalCase(parentFolderName) && !isKebabCase(parentFolderName))
-            return {};
-        const reExportedNames = new Set();
-        return {
-            ExportNamedDeclaration(node) {
-                if (!node.source)
-                    return;
-                for (const spec of node.specifiers) {
-                    if (spec.exported.type === "Identifier") {
-                        reExportedNames.add(spec.exported.name);
-                    }
-                }
-            },
-            "Program:exit"() {
-                if (reExportedNames.size === 0)
-                    return;
-                if (!reExportedNames.has(matchingTsx)) {
-                    context.report({
-                        loc: { line: 1, column: 0 },
-                        message: `index.ts in "${folderName}/" must re-export "${matchingTsx}". ` +
-                            "See docs/code-organization-guide/rules/folder-nesting-rule.md",
-                    });
-                    return;
-                }
-                const nonParentExports = [...reExportedNames].filter((n) => n !== matchingTsx);
-                if (nonParentExports.length > 0) {
-                    context.report({
-                        loc: { line: 1, column: 0 },
-                        message: `index.ts must not re-export exclusive children: ${nonParentExports.join(", ")}. ` +
-                            `Only "${matchingTsx}" may be re-exported. ` +
-                            "See docs/code-organization-guide/rules/folder-nesting-rule.md",
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/enforce-cn-merge.d.ts

@@ -1,21 +0,0 @@
-/**
- * ESLint rule: pasika/enforce-cn-merge
- *
- * Enforces the "Class Composition Rule".
- *
- * @see docs/styling-guide/rules/class-composition-rule.md
- */
-import type { Rule } from "eslint";
-import type { JsxAttributeNode } from "../ast-types.js";
-export declare const enforceCnMergeRule: {
-    meta: {
-        schema: never[];
-        type: "problem";
-        docs: {
-            description: string;
-        };
-    };
-    create(context: Rule.RuleContext): {
-        JSXAttribute(node: JsxAttributeNode): void;
-    };
-};

package/dist/eslint/pasika/rules/enforce-cn-merge.js

@@ -1,86 +0,0 @@
-/**
- * ESLint rule: pasika/enforce-cn-merge
- *
- * Enforces the "Class Composition Rule".
- *
- * @see docs/styling-guide/rules/class-composition-rule.md
- */
-function classCount(str) {
-    return str.split(/\s+/).filter(Boolean).length;
-}
-function isComponentName(name) {
-    return name?.type === "JSXIdentifier" && /^[A-Z]/.test(name.name);
-}
-function isOuterLayoutClass(className) {
-    const utility = className.split(":").pop() ?? className;
-    return /^(?:-?m[trblsexy]?-.+|(?:min-|max-)?[wh]-.+|size-.+|(?:flex-(?:1|auto|initial|none|grow|shrink|basis-.+)|grow(?:-.+)?|shrink(?:-.+)?|basis-.+|order-.+|(?:col|row)-(?:auto|span-.+|start-.+|end-.+)|(?:self|place-self|justify-self)-.+|z-.+|gap-.+|space-[xy]-.+))$/.test(utility);
-}
-function stringArguments(node) {
-    if (node?.type === "Literal" && typeof node.value === "string")
-        return [node.value];
-    if (node?.type === "TemplateLiteral")
-        return node.quasis.map((quasi) => quasi.value.raw);
-    if (node?.type === "ConditionalExpression")
-        return [...stringArguments(node.consequent), ...stringArguments(node.alternate)];
-    if (node?.type === "LogicalExpression")
-        return [...stringArguments(node.left), ...stringArguments(node.right)];
-    if (node?.type === "CallExpression" && node.callee.type === "Identifier" && node.callee.name === "cn") {
-        return node.arguments.flatMap((argument) => stringArguments(argument));
-    }
-    return [];
-}
-export const enforceCnMergeRule = {
-    meta: { schema: [], type: "problem", docs: { description: "Enforce cn() for conditional class merging." } },
-    create(context) {
-        return {
-            JSXAttribute(node) {
-                const attributeName = node.name?.name ?? "";
-                const element = node.parent.parent;
-                const isComponentProp = isComponentName(element.openingElement?.name);
-                if (isComponentProp && attributeName !== "className" && attributeName.endsWith("ClassName")) {
-                    context.report({ node, message: "Expose appearance through typed variant props instead of separate internal class-name props. See docs/styling-guide/rules/class-composition-rule.md" });
-                    return;
-                }
-                if (attributeName !== "className" && attributeName !== "class")
-                    return;
-                const valueNode = node.value;
-                if (!valueNode)
-                    return;
-                if (isComponentProp && attributeName === "className") {
-                    const expression = valueNode.type === "JSXExpressionContainer" ? valueNode.expression : valueNode;
-                    const invalidClass = stringArguments(expression).flatMap((value) => value.split(/\s+/).filter(Boolean)).find((className) => !isOuterLayoutClass(className));
-                    if (invalidClass)
-                        context.report({ node, message: `Passed className contains non-layout utility "${invalidClass}". Expose appearance through typed variant props. See docs/styling-guide/rules/class-composition-rule.md` });
-                    return;
-                }
-                if (valueNode.type === "Literal" && typeof valueNode.value === "string") {
-                    if (classCount(valueNode.value) > 5)
-                        context.report({ node, message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/styling-guide/rules/class-composition-rule.md" });
-                    return;
-                }
-                if (valueNode.type !== "JSXExpressionContainer")
-                    return;
-                const expr = valueNode.expression;
-                if (expr.type === "BinaryExpression" && expr.operator === "+") {
-                    context.report({ node, message: "Use cn() instead of + operator for className. See docs/styling-guide/rules/class-composition-rule.md" });
-                    return;
-                }
-                if (expr.type === "TemplateLiteral" && expr.expressions.length > 0) {
-                    context.report({ node, message: "Use cn() instead of template literals with conditionals for className. See docs/styling-guide/rules/class-composition-rule.md" });
-                    return;
-                }
-                if (expr.type === "Literal" && typeof expr.value === "string" && classCount(expr.value) > 5) {
-                    context.report({ node, message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/styling-guide/rules/class-composition-rule.md" });
-                    return;
-                }
-                if (expr.type === "CallExpression" && expr.callee.type === "Identifier" && expr.callee.name === "cn") {
-                    for (const arg of expr.arguments) {
-                        if (arg.type === "Literal" && typeof arg.value === "string" && classCount(arg.value) > 5) {
-                            context.report({ node: arg, message: "Each cn() string argument must contain at most 5 class names. Group by styling concern. See docs/styling-guide/rules/class-composition-rule.md" });
-                        }
-                    }
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/enforce-cva-variant-props.d.ts

@@ -1,9 +0,0 @@
-/**
- * ESLint rule: pasika/enforce-cva-variant-props
- *
- * Enforces the "Component Variant Rule" — VariantProps from CVA.
- *
- * @see docs/styling-guide/rules/component-variant-rule.md
- */
-import type { Rule } from "eslint";
-export declare const enforceCvaVariantPropsRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/enforce-cva-variant-props.js

@@ -1,86 +0,0 @@
-/**
- * ESLint rule: pasika/enforce-cva-variant-props
- *
- * Enforces the "Component Variant Rule" — VariantProps from CVA.
- *
- * @see docs/styling-guide/rules/component-variant-rule.md
- */
-export const enforceCvaVariantPropsRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Enforce VariantProps from CVA instead of manual variant union types.",
-        },
-    },
-    create(context) {
-        const cvaDefinitions = new Map();
-        return {
-            VariableDeclarator(node) {
-                const init = node.init;
-                if (init?.type !== "CallExpression" ||
-                    init.callee.type !== "Identifier" ||
-                    init.callee.name !== "cva" ||
-                    node.id.type !== "Identifier") {
-                    return;
-                }
-                const args = init.arguments;
-                if (args.length < 2)
-                    return;
-                const options = args[1];
-                if (options?.type !== "ObjectExpression")
-                    return;
-                for (const prop of options.properties) {
-                    if (prop.type !== "Property" ||
-                        prop.key.type !== "Identifier" ||
-                        prop.key.name !== "variants" ||
-                        prop.value.type !== "ObjectExpression") {
-                        continue;
-                    }
-                    const variantNames = prop.value.properties
-                        .filter((p) => p.type === "Property" && p.key.type === "Identifier")
-                        .map((p) => p.key.name);
-                    if (variantNames.length > 0) {
-                        cvaDefinitions.set(node.id.name, variantNames);
-                    }
-                }
-            },
-            TSTypeAliasDeclaration(node) {
-                const aliasName = node.id?.name;
-                if (!aliasName?.endsWith("Props"))
-                    return;
-                if (node.typeAnnotation?.type !== "TSTypeLiteral")
-                    return;
-                for (const member of node.typeAnnotation.members ?? []) {
-                    if (member.type !== "TSPropertySignature")
-                        continue;
-                    const keyName = member.key?.type === "Identifier" ? member.key.name : undefined;
-                    if (!keyName)
-                        continue;
-                    const typeAnn = member.typeAnnotation?.typeAnnotation;
-                    if (typeAnn?.type !== "TSUnionType")
-                        continue;
-                    // typescript-eslint emits ESTree `Literal` nodes; other TypeScript
-                    // parsers emit `StringLiteral`. Accept both so the rule works
-                    // whichever parser the consuming config installs.
-                    const allStringLiterals = (typeAnn.types ?? []).every((t) => t.type === "TSLiteralType" &&
-                        (t.literal?.type === "StringLiteral" ||
-                            (t.literal?.type === "Literal" && typeof t.literal.value === "string")));
-                    if (allStringLiterals && (typeAnn.types?.length ?? 0) >= 2) {
-                        for (const variantNames of cvaDefinitions.values()) {
-                            if (variantNames.includes(keyName)) {
-                                context.report({
-                                    node,
-                                    message: `Variant prop "${keyName}" duplicates CVA variant values. ` +
-                                        "Use VariantProps<typeof variants> instead of manually writing union types. " +
-                                        "See docs/styling-guide/rules/component-variant-rule.md",
-                                });
-                                return;
-                            }
-                        }
-                    }
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/filename-case.d.ts

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

package/dist/eslint/pasika/rules/filename-case.js

@@ -1,123 +0,0 @@
-/**
- * ESLint rule: pasika/filename-case
- *
- * Enforces the naming conventions from the "Smart vs Dumb Component Rule":
- *  - Smart components: PascalCase.tsx
- *  - Dumb components: kebab-case.tsx
- *  - Non-component files: kebab-case
- *
- * @see docs/code-organization-guide/rules/smart-vs-dumb-component-rule.md
- */
-import path from "node:path";
-import { parseComponentInfo } from "./component-conventions.js";
-/**
- * Next.js App Router routing files that are exempt from filename-case checks.
- * https://nextjs.org/docs/app/getting-started/project-structure#routing-files
- */
-const NEXT_ROUTING_FILES = new Set([
-    "page",
-    "layout",
-    "loading",
-    "error",
-    "not-found",
-    "route",
-    "template",
-    "default",
-    "middleware",
-    "instrumentation",
-]);
-/** Suffixes that form a compound extension with the real extension (e.g. .example.tsx, .test.ts). */
-const COMPOUND_SUFFIXES = new Set(["example", "test", "spec", "stories"]);
-/**
- * Checks whether a string is in kebab-case.
- * Allows lowercase letters, digits, and hyphens (but not leading/trailing/double hyphens).
- */
-function isKebabCase(str) {
-    return /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(str);
-}
-/**
- * Checks whether a string is in PascalCase.
- * Starts with an uppercase letter, followed by alphanumeric characters.
- */
-function isPascalCase(str) {
-    return /^[A-Z][A-Za-z0-9]*$/.test(str);
-}
-export const filenameCaseRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Enforce pasika filename conventions: kebab-case by default, PascalCase for smart .tsx components.",
-        },
-    },
-    create(context) {
-        const filename = context.filename;
-        if (!filename) {
-            return {};
-        }
-        // Only check files under src/
-        const normalized = filename.replace(/\\/g, "/");
-        if (!normalized.includes("/src/")) {
-            return {};
-        }
-        const ext = path.extname(filename);
-        let base = path.basename(filename, ext);
-        // Strip compound suffix (e.g. ".example", ".test", ".stories", ".spec") to get the real base name
-        const baseExt = path.extname(base);
-        if (baseExt && COMPOUND_SUFFIXES.has(baseExt.slice(1))) {
-            base = path.basename(base, baseExt);
-        }
-        // Next.js routing files are exempt
-        if (NEXT_ROUTING_FILES.has(base)) {
-            return {};
-        }
-        // .tsx components use PascalCase when smart and kebab-case when dumb.
-        if (ext === ".tsx") {
-            return {
-                Program(node) {
-                    const components = parseComponentInfo(context.sourceCode.text, filename);
-                    const component = components[0];
-                    if (component?.smart && !isPascalCase(base)) {
-                        context.report({
-                            node,
-                            message: `Smart component files must use PascalCase.tsx. Filename "${path.basename(filename)}" is not PascalCase.`,
-                        });
-                        return;
-                    }
-                    if (component && !component.smart && !isKebabCase(base)) {
-                        context.report({
-                            node,
-                            message: `Dumb component files must use kebab-case.tsx. Filename "${path.basename(filename)}" is not kebab-case.`,
-                        });
-                        return;
-                    }
-                    if (!component && !(isPascalCase(base) || isKebabCase(base))) {
-                        context.report({
-                            node,
-                            message: `Filename "${path.basename(filename)}" does not match pasika conventions. Component files must be PascalCase.tsx (smart) or kebab-case.tsx (dumb).`,
-                        });
-                    }
-                },
-            };
-        }
-        // Everything else must be kebab-case
-        if (!isKebabCase(base)) {
-            return report(context, filename, ext);
-        }
-        return {};
-    },
-};
-function report(context, filename, ext) {
-    return {
-        Program(node) {
-            const convention = ext === ".tsx"
-                ? "Component files must be PascalCase.tsx (smart) or kebab-case.tsx (dumb)."
-                : "Non-component files must use kebab-case.";
-            context.report({
-                node,
-                loc: { line: 1, column: 0 },
-                message: `Filename "${path.basename(filename)}" does not match pasika conventions. ${convention}`,
-            });
-        },
-    };
-}

package/dist/eslint/pasika/rules/hook-complexity.d.ts

@@ -1,12 +0,0 @@
-/**
- * ESLint rule: pasika/hook-complexity
- *
- * - A custom hook with exactly one consumer MUST be extracted when it contains
- *   two or more imperative categories.
- * - A custom hook with one consumer that contains fewer than two imperative
- *   categories MUST stay inline in its consumer file.
- *
- * @see docs/code-organization-guide/rules/hook-extraction-rule.md
- */
-import type { Rule } from "eslint";
-export declare const hookComplexityRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/hook-complexity.js

@@ -1,114 +0,0 @@
-/**
- * ESLint rule: pasika/hook-complexity
- *
- * - A custom hook with exactly one consumer MUST be extracted when it contains
- *   two or more imperative categories.
- * - A custom hook with one consumer that contains fewer than two imperative
- *   categories MUST stay inline in its consumer file.
- *
- * @see docs/code-organization-guide/rules/hook-extraction-rule.md
- */
-import path from "node:path";
-import ts from "typescript";
-const REACT_HOOKS = new Set([
-    "useState",
-    "useEffect",
-    "useContext",
-    "useReducer",
-    "useCallback",
-    "useMemo",
-    "useRef",
-    "useLayoutEffect",
-    "useImperativeHandle",
-    "useDebugValue",
-    "useDeferredValue",
-    "useTransition",
-    "useId",
-    "useSyncExternalStore",
-    "useInsertionEffect",
-]);
-function isHookName(name) {
-    return /^use[A-Z]/.test(name);
-}
-/**
- * Counts the distinct React hook categories called anywhere inside a hook body.
- * Re-parses just the body's source slice with the TypeScript compiler so the
- * walk stays fully typed instead of unrolling ESTree unions by hand.
- */
-function countImperativeCategories(body, sourceText) {
-    const start = body.range?.[0] ?? 0;
-    const end = body.range?.[1] ?? sourceText.length;
-    const sourceFile = ts.createSourceFile("hook.ts", sourceText.slice(start, end), ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-    const categories = new Set();
-    const visit = (node) => {
-        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && REACT_HOOKS.has(node.expression.text)) {
-            categories.add(node.expression.text);
-        }
-        ts.forEachChild(node, visit);
-    };
-    visit(sourceFile);
-    return categories.size;
-}
-export const hookComplexityRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require extraction of complex single-consumer hooks and inline of simple ones.",
-        },
-    },
-    create(context) {
-        const filename = context.filename;
-        const sourceRoot = path.resolve("src");
-        const relative = path.relative(sourceRoot, filename);
-        if (relative.startsWith(".."))
-            return {};
-        const segments = relative.split(path.sep);
-        const sourceText = context.sourceCode.text;
-        function checkHook(node, name, body, exported) {
-            if (!exported)
-                return;
-            if (!name || !isHookName(name))
-                return;
-            if (!body)
-                return;
-            const imperativeCount = countImperativeCategories(body, sourceText);
-            const parentFolder = segments.length >= 2 ? segments[segments.length - 2] : undefined;
-            const inSupportFolder = parentFolder === "hooks";
-            if (imperativeCount >= 2 && !inSupportFolder) {
-                context.report({
-                    node,
-                    message: `Hook "${name}" has ${String(imperativeCount)} imperative categories and must be extracted to a hooks/ folder. ` +
-                        "See docs/code-organization-guide/rules/hook-extraction-rule.md",
-                });
-            }
-            else if (imperativeCount < 2 && inSupportFolder) {
-                context.report({
-                    node,
-                    message: `Hook "${name}" has fewer than two imperative categories and must stay inline in its consumer file. ` +
-                        "See docs/code-organization-guide/rules/hook-extraction-rule.md",
-                });
-            }
-        }
-        return {
-            FunctionDeclaration(node) {
-                const exported = node.parent?.type === "ExportNamedDeclaration";
-                checkHook(node, node.id?.name, node.body, exported);
-            },
-            VariableDeclarator(node) {
-                if (node.id.type !== "Identifier")
-                    return;
-                const exported = node.parent.parent?.type === "ExportNamedDeclaration";
-                if (!exported)
-                    return;
-                const init = node.init;
-                if (!init || (init.type !== "ArrowFunctionExpression" && init.type !== "FunctionExpression")) {
-                    return;
-                }
-                if (init.body.type !== "BlockStatement")
-                    return;
-                checkHook(node, node.id.name, init.body, true);
-            },
-        };
-    },
-};

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

@@ -1,11 +0,0 @@
-/**
- * ESLint rule: pasika/hook-extraction
- *
- * A custom hook MUST be extracted to its own file when two or more consumers
- * use it. The file must be read across the tree, because how many files import
- * a hook is not visible from one file.
- *
- * @see docs/code-organization-guide/rules/hook-extraction-rule.md
- */
-import type { Rule } from "eslint";
-export declare const hookExtractionRule: Rule.RuleModule;

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

@@ -1,55 +0,0 @@
-/**
- * ESLint rule: pasika/hook-extraction
- *
- * A custom hook MUST be extracted to its own file when two or more consumers
- * use it. The file must be read across the tree, because how many files import
- * a hook is not visible from one file.
- *
- * @see docs/code-organization-guide/rules/hook-extraction-rule.md
- */
-import path from "node:path";
-import { getProjectIndex, symbolKey } from "../project/index.js";
-import { folderSegmentsOf, segmentsOf } from "../project/ccf.js";
-export const hookExtractionRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require a custom hook with two or more consumers to live in its own hooks/ file.",
-        },
-    },
-    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 folder = folderSegmentsOf(file, sourceRoot);
-        const alreadyInHooksFolder = folder.length > 0 && folder[folder.length - 1] === "hooks";
-        const reusedHooks = module.exports
-            .filter((exp) => exp.kind === "hook" && !alreadyInHooksFolder)
-            .map((exp) => ({ exp, consumers: index.symbolConsumers.get(symbolKey(file, exp.name)) }))
-            .filter(({ consumers }) => (consumers?.size ?? 0) >= 2);
-        if (reusedHooks.length === 0)
-            return {};
-        return {
-            Program(node) {
-                for (const { exp, consumers } of reusedHooks) {
-                    context.report({
-                        node,
-                        loc: { line: exp.line, column: 0 },
-                        message: `Hook "${exp.name}" has ${String(consumers?.size ?? 0)} consumers; ` +
-                            "extract it to its own file in a hooks/ folder. " +
-                            "See docs/code-organization-guide/rules/hook-extraction-rule.md",
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/import-boundaries.d.ts

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