pasika 0.3.2 → 0.3.4

package/dist/eslint/pasika/rules/import-boundaries.js

@@ -1,167 +0,0 @@
-/**
- * ESLint rule: pasika/import-boundaries
- *
- * Enforces the import conventions from the "Exports and Imports Rule":
- *  - Whichever of the relative path and the @/* alias has fewer segments, with
- *    a tie going to the relative path.
- *  - Layer boundary enforcement (app → compositions → features → shared → root).
- *
- * @see docs/code-organization-guide/rules/exports-and-imports-rule.md
- */
-import path from "node:path";
-const sourceRoot = path.resolve("src");
-const rootSupportFolders = new Set(["config", "constants", "hooks", "locales", "schemas", "types", "utils"]);
-const moduleExtensions = new Set([".cjs", ".cts", ".js", ".jsx", ".mjs", ".mts", ".ts", ".tsx"]);
-const styleExtensions = new Set([".css", ".less", ".sass", ".scss"]);
-function resolveSourceImport(filename, importPath) {
-    if (importPath.startsWith("@/")) {
-        return path.resolve(sourceRoot, importPath.slice(2));
-    }
-    if (importPath.startsWith(".")) {
-        return path.resolve(path.dirname(filename), importPath);
-    }
-    return undefined;
-}
-function sourceSegments(absolutePath) {
-    const relativePath = path.relative(sourceRoot, absolutePath);
-    if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
-        return undefined;
-    }
-    return relativePath.split(path.sep);
-}
-/** The relative form of an import, always prefixed so it reads as a path. */
-function relativeSpecifier(filename, resolvedPath) {
-    const relativePath = path.relative(path.dirname(filename), resolvedPath).split(path.sep).join("/");
-    return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
-}
-/** The `@/*` form of an import. */
-function aliasSpecifier(resolvedPath) {
-    return `@/${(sourceSegments(resolvedPath) ?? []).join("/")}`;
-}
-/** Segments in a specifier: one per `../` step and one per name, ignoring a leading `./`. */
-function segmentCount(specifier) {
-    return specifier
-        .replace(/^@\//, "")
-        .split("/")
-        .filter((segment) => segment !== "." && segment !== "").length;
-}
-function describeSegments(count) {
-    return `${String(count)} segment${count === 1 ? "" : "s"}`;
-}
-/**
- * Whether the relative form is the one to use. Shorter wins, and a tie goes to
- * the relative form. Because crossing a layer always costs at least one `../`
- * while the alias spells the same tail, the alias always wins for a
- * cross-layer import without this needing to know what a layer is.
- */
-function prefersRelative(filename, resolvedPath) {
-    return segmentCount(relativeSpecifier(filename, resolvedPath)) <= segmentCount(aliasSpecifier(resolvedPath));
-}
-export const importBoundariesRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-    },
-    create(context) {
-        const filename = context.filename;
-        if (!filename) {
-            return {};
-        }
-        function reportImport(source) {
-            if (typeof source.value !== "string") {
-                return;
-            }
-            const importPath = source.value;
-            const resolvedPath = resolveSourceImport(filename, importPath);
-            if (!resolvedPath) {
-                return;
-            }
-            const importer = sourceSegments(filename);
-            const imported = sourceSegments(resolvedPath);
-            if (!importer || !imported || importer.length === 0 || imported.length === 0) {
-                return;
-            }
-            const [importerLayer = "", importerFeature] = importer;
-            const [importedLayer = "", importedFeature] = imported;
-            const extension = path.extname(importPath);
-            const isCodeModule = !extension || moduleExtensions.has(extension);
-            const isAppLocalStyleImport = importerLayer === "app" && importedLayer === "app" && styleExtensions.has(extension);
-            const importedIsRootSupport = rootSupportFolders.has(importedLayer);
-            const importedIsSameConfig = importerLayer === "config" && importedLayer === "config" && importer[1] === imported[1];
-            const isAllowed = (!isCodeModule && importerLayer === "app" && isAppLocalStyleImport) ||
-                (isCodeModule &&
-                    importerLayer === "app" &&
-                    (importedLayer === "compositions" ||
-                        importedLayer === "features" ||
-                        importedLayer === "shared" ||
-                        importedIsRootSupport)) ||
-                (isCodeModule &&
-                    importerLayer === "compositions" &&
-                    (importedLayer === "compositions" ||
-                        importedLayer === "features" ||
-                        importedLayer === "shared" ||
-                        importedIsRootSupport)) ||
-                (isCodeModule &&
-                    importerLayer === "features" &&
-                    ((importedLayer === "features" && importerFeature === importedFeature) ||
-                        importedLayer === "shared" ||
-                        importedIsRootSupport)) ||
-                (isCodeModule && importerLayer === "shared" && (importedLayer === "shared" || importedIsRootSupport)) ||
-                (isCodeModule &&
-                    rootSupportFolders.has(importerLayer) &&
-                    importedIsRootSupport &&
-                    (importerLayer !== "config" || importedLayer !== "config" || importedIsSameConfig));
-            if (!isAllowed) {
-                context.report({
-                    node: source,
-                    message: "This import violates the src layer boundary.",
-                });
-                // The fix is to move the file, so how the specifier is spelled does not matter yet.
-                return;
-            }
-            const relativeForm = relativeSpecifier(filename, resolvedPath);
-            const aliasForm = aliasSpecifier(resolvedPath);
-            const relativeSegments = segmentCount(relativeForm);
-            const aliasSegments = segmentCount(aliasForm);
-            function describeChoice(preferred, preferredSegments, other, otherSegments) {
-                const tie = preferredSegments === otherSegments ? ", and a tie goes to the relative path" : "";
-                return (`Use "${preferred}" (${describeSegments(preferredSegments)}) ` +
-                    `instead of "${other}" (${describeSegments(otherSegments)})${tie}.`);
-            }
-            if (prefersRelative(filename, resolvedPath) && importPath.startsWith("@/")) {
-                context.report({
-                    node: source,
-                    message: describeChoice(relativeForm, relativeSegments, aliasForm, aliasSegments),
-                });
-                return;
-            }
-            if (!prefersRelative(filename, resolvedPath) && importPath.startsWith(".")) {
-                context.report({
-                    node: source,
-                    message: describeChoice(aliasForm, aliasSegments, relativeForm, relativeSegments),
-                });
-            }
-        }
-        return {
-            ImportDeclaration(node) {
-                reportImport(node.source);
-            },
-            ExportAllDeclaration(node) {
-                reportImport(node.source);
-            },
-            ExportNamedDeclaration(node) {
-                if (node.source) {
-                    reportImport(node.source);
-                }
-            },
-            ImportExpression(node) {
-                reportImport(node.source);
-            },
-            CallExpression(node) {
-                if (node.callee.type === "Identifier" && node.callee.name === "require" && node.arguments[0]) {
-                    reportImport(node.arguments[0]);
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/import-through-index.d.ts

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

package/dist/eslint/pasika/rules/import-through-index.js

@@ -1,52 +0,0 @@
-import path from "node:path";
-import { resolveSpecifier } from "../project/index.js";
-import { segmentsOf } from "../project/ccf.js";
-export const importThroughIndexRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require imports of support files to use their support-folder index.",
-        },
-    },
-    create(context) {
-        const filename = path.resolve(context.filename);
-        const sourceRoot = sourceRootOf(filename);
-        return {
-            Program(node) {
-                for (const specifier of importSpecifiers(context.sourceCode.text)) {
-                    const target = resolveSpecifier(filename, specifier, sourceRoot);
-                    if (!target)
-                        continue;
-                    const targetSegments = segmentsOf(target, sourceRoot);
-                    const supportFolderIndex = targetSegments.findIndex((segment) => ["constants", "types", "schemas"].includes(segment));
-                    const supportFolder = supportFolderIndex >= 0 ? targetSegments[supportFolderIndex] : undefined;
-                    if (!supportFolder || path.basename(target).startsWith("index."))
-                        continue;
-                    const folderIndex = targetSegments.slice(0, supportFolderIndex + 1);
-                    const expected = `@/${folderIndex.join("/")}`;
-                    context.report({
-                        node,
-                        message: `Import support files through ${expected} instead of "${specifier}". ` +
-                            "See the code-organization-guide exports and imports rules.",
-                    });
-                }
-            },
-        };
-    },
-};
-function importSpecifiers(source) {
-    const specifiers = [];
-    const pattern = /\bimport\s+(?:(?:type\s+)?[\s\S]*?\sfrom\s+)?["'](?<specifier>[^"']+)["']/g;
-    for (const match of source.matchAll(pattern)) {
-        const specifier = match.groups?.specifier;
-        if (specifier)
-            specifiers.push(specifier);
-    }
-    return specifiers;
-}
-function sourceRootOf(filename) {
-    const marker = `${path.sep}src${path.sep}`;
-    const srcIndex = filename.lastIndexOf(marker);
-    return srcIndex >= 0 ? filename.slice(0, srcIndex + marker.length - 1) : path.resolve("src");
-}

package/dist/eslint/pasika/rules/interactive-component.d.ts

@@ -1,10 +0,0 @@
-/**
- * ESLint rule: pasika/interactive-component
- *
- * Interactive elements are component boundaries when they are mixed with other
- * content in the same component. Standalone interactive components are valid.
- *
- * @see docs/code-organization-guide/rules/interactive-component-rule.md
- */
-import type { Rule } from "eslint";
-export declare const interactiveComponentRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/interactive-component.js

@@ -1,76 +0,0 @@
-/**
- * ESLint rule: pasika/interactive-component
- *
- * Interactive elements are component boundaries when they are mixed with other
- * content in the same component. Standalone interactive components are valid.
- *
- * @see docs/code-organization-guide/rules/interactive-component-rule.md
- */
-const INTERACTIVE_TAGS = new Set([
-    "a",
-    "button",
-    "details",
-    "embed",
-    "iframe",
-    "input",
-    "label",
-    "select",
-    "textarea",
-    "video",
-]);
-function tagName(node) {
-    const name = node.openingElement?.name;
-    if (name?.type !== "JSXIdentifier")
-        return undefined;
-    return name.name;
-}
-function isInteractive(node) {
-    const name = tagName(node);
-    return name !== undefined && INTERACTIVE_TAGS.has(name);
-}
-function isComponentElement(node) {
-    const name = tagName(node);
-    return name !== undefined && /^[A-Z]/.test(name);
-}
-function isComponentReturn(node) {
-    const parent = node.parent;
-    if (parent.type === "ReturnStatement")
-        return true;
-    return parent.type === "ArrowFunctionExpression" && parent.body === node;
-}
-export const interactiveComponentRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require interactive HTML elements mixed with other content to be extracted into components.",
-        },
-    },
-    create(context) {
-        if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx"))
-            return {};
-        return {
-            JSXElement(node) {
-                if (!isInteractive(node))
-                    return;
-                if (isComponentElement(node.parent)) {
-                    return;
-                }
-                if (isInteractive(node.parent)) {
-                    return;
-                }
-                if (isComponentReturn(node)) {
-                    return;
-                }
-                const name = tagName(node);
-                if (name === undefined)
-                    return;
-                context.report({
-                    node,
-                    message: `Extract the interactive <${name}> into a descriptive component. ` +
-                        "See docs/code-organization-guide/rules/interactive-component-rule.md",
-                });
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/json/index.d.ts

@@ -1,5 +0,0 @@
-export declare const jsonRules: {
-    "no-cache-flag": import("@eslint/json").JSONRuleDefinition;
-    "no-vulyk-dependency": import("@eslint/json").JSONRuleDefinition;
-};
-export type JsonRuleName = keyof typeof jsonRules;

package/dist/eslint/pasika/rules/json/index.js

@@ -1,9 +0,0 @@
-/**
- * All JSON rules for the package.json checks.
- */
-import { noCacheFlagRule } from "./no-cache-flag.js";
-import { noVulykDependencyRule } from "./no-vulyk-dependency.js";
-export const jsonRules = {
-    "no-cache-flag": noCacheFlagRule,
-    "no-vulyk-dependency": noVulykDependencyRule,
-};

package/dist/eslint/pasika/rules/json/no-cache-flag.d.ts

@@ -1,10 +0,0 @@
-/**
- * ESLint rule: pasika/no-cache-flag
- *
- * A lint command MUST NOT pass ESLint's --cache flag, because rules that
- * compare a file against the rest of the tree need every file in the run.
- *
- * @see docs/agent-policy.md
- */
-import type { JSONRuleDefinition } from "@eslint/json";
-export declare const noCacheFlagRule: JSONRuleDefinition;

package/dist/eslint/pasika/rules/json/no-cache-flag.js

@@ -1,45 +0,0 @@
-/**
- * ESLint rule: pasika/no-cache-flag
- *
- * A lint command MUST NOT pass ESLint's --cache flag, because rules that
- * compare a file against the rest of the tree need every file in the run.
- *
- * @see docs/agent-policy.md
- */
-function memberName(member) {
-    return member.name.type === "String" ? member.name.value : member.name.name;
-}
-export const noCacheFlagRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require lint scripts to not pass ESLint's --cache flag.",
-        },
-    },
-    create(context) {
-        return {
-            Document(node) {
-                const root = node.body;
-                if (root.type !== "Object")
-                    return;
-                const scripts = root.members.find((member) => memberName(member) === "scripts");
-                if (scripts?.value.type !== "Object")
-                    return;
-                for (const member of scripts.value.members) {
-                    const name = memberName(member);
-                    if (name !== "lint" && name !== "fix")
-                        continue;
-                    if (member.value.type !== "String")
-                        continue;
-                    if (member.value.value.includes("--cache")) {
-                        context.report({
-                            node: member,
-                            message: "Lint scripts must not pass ESLint's --cache flag because cross-file rules require every file in the run.",
-                        });
-                    }
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/json/no-vulyk-dependency.d.ts

@@ -1,10 +0,0 @@
-/**
- * ESLint rule: pasika/no-vulyk-dependency
- *
- * Vulyk MUST NOT be added to package.json in order to run its CLI; it MUST run
- * as an ephemeral command such as npx vulyk@latest.
- *
- * @see docs/agent-policy.md
- */
-import type { JSONRuleDefinition } from "@eslint/json";
-export declare const noVulykDependencyRule: JSONRuleDefinition;

package/dist/eslint/pasika/rules/json/no-vulyk-dependency.js

@@ -1,41 +0,0 @@
-/**
- * ESLint rule: pasika/no-vulyk-dependency
- *
- * Vulyk MUST NOT be added to package.json in order to run its CLI; it MUST run
- * as an ephemeral command such as npx vulyk@latest.
- *
- * @see docs/agent-policy.md
- */
-function memberName(member) {
-    return member.name.type === "String" ? member.name.value : member.name.name;
-}
-export const noVulykDependencyRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require vulyk to run as an ephemeral command, not a package.json dependency.",
-        },
-    },
-    create(context) {
-        return {
-            Document(node) {
-                const root = node.body;
-                if (root.type !== "Object")
-                    return;
-                for (const key of ["dependencies", "devDependencies"]) {
-                    const section = root.members.find((member) => memberName(member) === key);
-                    if (section?.value.type !== "Object")
-                        continue;
-                    const vulyk = section.value.members.find((member) => memberName(member) === "vulyk");
-                    if (vulyk) {
-                        context.report({
-                            node: vulyk,
-                            message: 'Vulyk must not be a package.json dependency. Run it as "npx vulyk@latest" instead.',
-                        });
-                    }
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/json/rule-tester.d.ts

@@ -1,11 +0,0 @@
-/**
- * Shared RuleTester wiring for the package.json rule tests.
- *
- * Each `describe` title in a rule test is the exact text of the requirement the
- * case pins, which is how `pasika coverage` verifies that a requirement recorded
- * as lint-enforced has a test behind it.
- */
-import { describe } from "node:test";
-import { RuleTester } from "eslint";
-export declare const jsonRuleTester: RuleTester;
-export { describe };

package/dist/eslint/pasika/rules/json/rule-tester.js

@@ -1,21 +0,0 @@
-/**
- * Shared RuleTester wiring for the package.json rule tests.
- *
- * Each `describe` title in a rule test is the exact text of the requirement the
- * case pins, which is how `pasika coverage` verifies that a requirement recorded
- * as lint-enforced has a test behind it.
- */
-import { describe, it } from "node:test";
-import { RuleTester } from "eslint";
-import jsonPlugin from "@eslint/json";
-import { jsonRules } from "../../index.js";
-RuleTester.describe = describe;
-RuleTester.it = it;
-export const jsonRuleTester = new RuleTester({
-    language: "json/json",
-    plugins: {
-        json: { languages: { json: jsonPlugin.languages.json } },
-        pasika: { rules: jsonRules },
-    },
-});
-export { describe };

package/dist/eslint/pasika/rules/jsx-hygiene.d.ts

@@ -1,9 +0,0 @@
-/**
- * ESLint rule: pasika/jsx-hygiene
- *
- * Keeps calculations and complex conditions out of JSX children and attributes.
- *
- * @see docs/code-organization-guide/rules/jsx-hygiene-rule.md
- */
-import type { Rule } from "eslint";
-export declare const jsxHygieneRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/jsx-hygiene.js

@@ -1,108 +0,0 @@
-/**
- * ESLint rule: pasika/jsx-hygiene
- *
- * Keeps calculations and complex conditions out of JSX children and attributes.
- *
- * @see docs/code-organization-guide/rules/jsx-hygiene-rule.md
- */
-import ts from "typescript";
-const ARITHMETIC_OPERATORS = new Set(["+", "-", "*", "/", "%"]);
-function isCallExpression(node) {
-    return node.type === "CallExpression";
-}
-function isMemberExpression(node) {
-    return ["MemberExpression", "OptionalMemberExpression"].includes(node.type);
-}
-function logicalOperatorCount(node) {
-    if (node.type !== "LogicalExpression")
-        return 0;
-    return 1 + logicalOperatorCount(node.left) + logicalOperatorCount(node.right);
-}
-/**
- * Whether the parsed text of a node's subtree contains a conditional expression
- * anywhere. Re-parses just the node's source slice with the TypeScript compiler
- * so the walk stays fully typed, including inside JSX children.
- */
-function containsConditionalIn(node, sourceText) {
-    const start = node.range?.[0] ?? 0;
-    const end = node.range?.[1] ?? sourceText.length;
-    const sourceFile = ts.createSourceFile("fragment.tsx", sourceText.slice(start, end), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    let found = false;
-    const visit = (child) => {
-        if (found)
-            return;
-        if (ts.isConditionalExpression(child)) {
-            found = true;
-            return;
-        }
-        ts.forEachChild(child, visit);
-    };
-    visit(sourceFile);
-    return found;
-}
-function hasNestedTernary(node, sourceText) {
-    if (node.type !== "ConditionalExpression")
-        return false;
-    return containsConditionalIn(node.consequent, sourceText) || containsConditionalIn(node.alternate, sourceText);
-}
-function hasChainedCall(node) {
-    if (!isCallExpression(node) || !isMemberExpression(node.callee))
-        return false;
-    return isCallExpression(node.callee.object) || isMemberExpression(node.callee.object);
-}
-function hasExternalCall(node) {
-    if (!isCallExpression(node))
-        return false;
-    const callee = node.callee;
-    if (callee.type === "Identifier" && callee.name === "cn")
-        return false;
-    if (isMemberExpression(callee))
-        return false;
-    return callee.type === "Identifier";
-}
-function findViolation(node, sourceText) {
-    if (node.type === "BinaryExpression" && ARITHMETIC_OPERATORS.has(node.operator)) {
-        return "arithmetic";
-    }
-    if (hasChainedCall(node))
-        return "chained built-in method calls";
-    if (hasExternalCall(node))
-        return "calls to functions declared outside the component";
-    if (hasNestedTernary(node, sourceText))
-        return "nested ternaries";
-    if (logicalOperatorCount(node) >= 2)
-        return "conditions containing two or more logical operators";
-    return undefined;
-}
-export const jsxHygieneRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require complex JSX expressions to be extracted before return.",
-        },
-    },
-    create(context) {
-        if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx"))
-            return {};
-        const sourceText = context.sourceCode.text;
-        function checkExpression(node) {
-            const violation = findViolation(node, sourceText);
-            if (!violation)
-                return;
-            context.report({
-                node,
-                message: `Extract ${violation} from JSX before return. ` +
-                    "See docs/code-organization-guide/rules/jsx-hygiene-rule.md",
-            });
-        }
-        return {
-            JSXExpressionContainer(node) {
-                const expression = node.expression;
-                if (!expression || expression.type === "JSXEmptyExpression")
-                    return;
-                checkExpression(expression);
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/locale-dotted-path.d.ts

@@ -1,10 +0,0 @@
-/**
- * ESLint rule: pasika/locale-dotted-path
- *
- * A namespaced locale MUST be read through its full dotted path
- * (locales.stream.watchLiveStream) rather than destructured.
- *
- * @see docs/code-organization-guide/rules/locales-rule.md
- */
-import type { Rule } from "eslint";
-export declare const localeDottedPathRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/locale-dotted-path.js

@@ -1,65 +0,0 @@
-/**
- * ESLint rule: pasika/locale-dotted-path
- *
- * A namespaced locale MUST be read through its full dotted path
- * (locales.stream.watchLiveStream) rather than destructured.
- *
- * @see docs/code-organization-guide/rules/locales-rule.md
- */
-import path from "node:path";
-function isInLocalesDir(filename) {
-    const segments = path.resolve(filename).split(path.sep);
-    const srcIdx = segments.lastIndexOf("src");
-    return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
-}
-function isLocalesAccess(node) {
-    if (node.type === "Identifier" && node.name === "locales") {
-        return true;
-    }
-    if (node.type === "MemberExpression" &&
-        node.object.type === "Identifier" &&
-        node.object.name === "locales" &&
-        node.property.type === "Identifier") {
-        return true;
-    }
-    return false;
-}
-export const localeDottedPathRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require reading namespaced locales through their full dotted path.",
-        },
-    },
-    create(context) {
-        if (isInLocalesDir(context.filename))
-            return {};
-        return {
-            VariableDeclarator(node) {
-                if (node.id.type !== "ObjectPattern")
-                    return;
-                const init = node.init;
-                if (!init || !isLocalesAccess(init))
-                    return;
-                for (const prop of node.id.properties) {
-                    if (prop.type !== "Property")
-                        continue;
-                    let valueName;
-                    if (prop.value.type === "Identifier") {
-                        valueName = prop.value.name;
-                    }
-                    else if (prop.key.type === "Identifier") {
-                        valueName = prop.key.name;
-                    }
-                    if (valueName) {
-                        context.report({
-                            node,
-                            message: `Destructuring locales.${valueName} loses the namespace; read through the full dotted path instead.`,
-                        });
-                    }
-                }
-            },
-        };
-    },
-};