pasika 0.3.2 → 0.3.4

package/dist/eslint/pasika/rules/md/project-index.js

@@ -1,67 +0,0 @@
-/**
- * @fileoverview Shared project index for cross-document markdown rules.
- * Scans the docs folder and caches document metadata.
- */
-import { readdirSync, readFileSync, statSync } from "node:fs";
-import path from "node:path";
-const KIND_BY_SUFFIX = [
-    ["-rule.md", "rule"],
-    ["-guide.md", "guide"],
-    ["-reference.md", "reference"],
-    ["-policy.md", "policy"],
-];
-function listMarkdownFiles(dir) {
-    return readdirSync(dir).flatMap((entry) => {
-        const entryPath = path.join(dir, entry);
-        if (statSync(entryPath).isDirectory()) {
-            return entry.startsWith("_") ? [] : listMarkdownFiles(entryPath);
-        }
-        return entry.endsWith(".md") ? [entryPath] : [];
-    });
-}
-function extractTitle(filePath) {
-    const content = readFileSync(filePath, "utf8");
-    const match = /^# (?<title>.+)$/m.exec(content);
-    return match?.groups?.title?.trim() ?? "";
-}
-// Memoized cache keyed by docsRoot
-const cache = new Map();
-/**
- * Get all documents in the docs folder. Results are cached per docsRoot.
- */
-export function getProjectDocs(docsRoot) {
-    const cached = cache.get(docsRoot);
-    if (cached)
-        return cached;
-    const files = listMarkdownFiles(docsRoot);
-    const docs = files
-        .sort((a, b) => a.localeCompare(b))
-        .map((filePath) => {
-        const fileName = path.basename(filePath);
-        const kind = KIND_BY_SUFFIX.find(([suffix]) => fileName.endsWith(suffix))?.[1];
-        return {
-            filePath,
-            doc: path.relative(docsRoot, filePath).split(path.sep).join("/"),
-            fileName,
-            kind,
-            title: extractTitle(filePath),
-        };
-    });
-    cache.set(docsRoot, docs);
-    return docs;
-}
-/**
- * Try to find the docsRoot from a file path by walking up to find the docs/ directory.
- */
-export function findDocsRoot(filePath) {
-    let dir = path.dirname(filePath);
-    for (;;) {
-        if (path.basename(dir) === "docs" && statSync(dir).isDirectory()) {
-            return dir;
-        }
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return undefined;
-        dir = parent;
-    }
-}

package/dist/eslint/pasika/rules/md/reference-block-headings.d.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Reference block headings rule.
- * A Reference with a single lookup block must not add a section heading for it.
- */
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const referenceBlockHeadingsRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/reference-block-headings.js

@@ -1,31 +0,0 @@
-import { getFilename } from "./helpers.js";
-export const referenceBlockHeadingsRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Reference block headings rule.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            root(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith("-reference.md"))
-                    return;
-                const sectionHeadings = [];
-                for (const child of node.children) {
-                    if (child.type === "heading" && child.depth >= 2) {
-                        sectionHeadings.push(child);
-                    }
-                }
-                if (sectionHeadings.length === 1) {
-                    context.report({
-                        node: node.children[0] ?? node,
-                        message: "reference has exactly one section heading, so either a single block is headed or a first block is not",
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/md/reference-no-rfc-vocabulary.d.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Reference documents must not use RFC 2119 vocabulary in prose.
- * Only naming a keyword in code spans is permitted.
- */
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const referenceNoRfcVocabularyRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/reference-no-rfc-vocabulary.js

@@ -1,26 +0,0 @@
-import { containsRfcKeyword, getFilename } from "./helpers.js";
-export const referenceNoRfcVocabularyRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Reference documents must not use RFC 2119 vocabulary (MUST, MUST NOT, SHOULD, SHOULD NOT, MAY) in prose.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            text(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith("-reference.md"))
-                    return;
-                const keyword = containsRfcKeyword(node.value);
-                if (keyword) {
-                    context.report({
-                        node,
-                        message: `reference uses RFC 2119 vocabulary: ${keyword}`,
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/md/requirement-present.d.ts

@@ -1,5 +0,0 @@
-/**
- * @fileoverview Rule and policy documents must state at least one requirement.
- */
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const requirementPresentRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/requirement-present.js

@@ -1,41 +0,0 @@
-import { containsRfcKeyword, getFilename, getTextContent } from "./helpers.js";
-/** Check whether a subtree contains a bullet with RFC vocabulary. */
-function hasRequirement(node) {
-    if (node.type === "listItem") {
-        if (containsRfcKeyword(getTextContent(node)))
-            return true;
-    }
-    if ("children" in node) {
-        for (const child of node.children) {
-            if (hasRequirement(child))
-                return true;
-        }
-    }
-    return false;
-}
-export const requirementPresentRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Rule and policy documents must state at least one requirement.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            root(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith("-rule.md") && !filename.endsWith("-policy.md")) {
-                    return;
-                }
-                if (!hasRequirement(node)) {
-                    const kind = filename.endsWith("-rule.md") ? "rule" : "policy";
-                    context.report({
-                        node,
-                        message: `${kind} document states no requirement`,
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/md/rfc-only-in-bullets.d.ts

@@ -1,5 +0,0 @@
-/**
- * @fileoverview RFC 2119 vocabulary must appear only in bullet points.
- */
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const rfcOnlyInBulletsRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/rfc-only-in-bullets.js

@@ -1,46 +0,0 @@
-import { containsRfcKeyword, getFilename } from "./helpers.js";
-/** Check whether a subtree contains a text node outside a bullet using RFC vocabulary. */
-function checkOutsideBullets(node, context, insideBullet) {
-    if (node.type === "listItem") {
-        // Everything under a list item is a bullet; stop descending for the
-        // outside-bullet check, but nested lists still need walking.
-        for (const child of node.children) {
-            checkOutsideBullets(child, context, true);
-        }
-        return;
-    }
-    if (node.type === "text") {
-        const keyword = containsRfcKeyword(node.value);
-        if (keyword && !insideBullet) {
-            context.report({
-                node,
-                message: `RFC 2119 vocabulary "${keyword}" appears outside a bullet point`,
-            });
-        }
-        return;
-    }
-    if ("children" in node) {
-        for (const child of node.children) {
-            checkOutsideBullets(child, context, insideBullet);
-        }
-    }
-}
-export const rfcOnlyInBulletsRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "RFC 2119 vocabulary must appear only in bullet points.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            root(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith("-rule.md"))
-                    return;
-                checkOutsideBullets(node, context, false);
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/md/rule-paired-examples.d.ts

@@ -1,5 +0,0 @@
-/**
- * @fileoverview Rule must have paired Incorrect/Correct examples.
- */
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const rulePairedExamplesRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/rule-paired-examples.js

@@ -1,36 +0,0 @@
-import { getFilename, getLine, getTextContent } from "./helpers.js";
-export const rulePairedExamplesRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Rule must have paired Incorrect/Correct examples.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            root(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith("-rule.md"))
-                    return;
-                const exampleHeadings = [];
-                for (const child of node.children) {
-                    if (child.type === "heading" && child.depth === 2) {
-                        const text = getTextContent(child).trim();
-                        if (/^(?:Incorrect|Correct)\b/.test(text)) {
-                            exampleHeadings.push({ line: getLine(child), text });
-                        }
-                    }
-                }
-                const incorrect = exampleHeadings.filter((h) => h.text.startsWith("Incorrect"));
-                const correct = exampleHeadings.filter((h) => h.text.startsWith("Correct"));
-                if (incorrect.length === 0 || incorrect.length !== correct.length) {
-                    context.report({
-                        node,
-                        message: `${String(incorrect.length)} Incorrect and ${String(correct.length)} Correct examples`,
-                    });
-                }
-            },
-        };
-    },
-};

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

@@ -1,11 +0,0 @@
-/**
- * Shared RuleTester wiring for the markdown 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 mdRuleTester: RuleTester;
-export { describe };

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

@@ -1,21 +0,0 @@
-/**
- * Shared RuleTester wiring for the markdown 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 markdown from "@eslint/markdown";
-import { mdRules } from "../../index.js";
-RuleTester.describe = describe;
-RuleTester.it = it;
-export const mdRuleTester = new RuleTester({
-    language: "markdown/gfm",
-    plugins: {
-        markdown,
-        pasika: { rules: mdRules },
-    },
-});
-export { describe };

package/dist/eslint/pasika/rules/md/support-document-placement.d.ts

@@ -1,2 +0,0 @@
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const supportDocumentPlacementRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/support-document-placement.js

@@ -1,36 +0,0 @@
-/**
- * @fileoverview Rules must live in rules/, references must live in references/.
- */
-import path from "node:path";
-import { getFilename } from "./helpers.js";
-export const supportDocumentPlacementRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Rules must live in rules/, references must live in references/.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            root(node) {
-                const filename = getFilename(context);
-                if (!filename.endsWith(".md"))
-                    return;
-                const parentFolder = path.basename(path.dirname(filename));
-                if (filename.endsWith("-rule.md") && parentFolder !== "rules") {
-                    context.report({
-                        node,
-                        message: `rule lives in "${parentFolder}/" instead of "rules/"`,
-                    });
-                }
-                if (filename.endsWith("-reference.md") && parentFolder !== "references") {
-                    context.report({
-                        node,
-                        message: `reference lives in "${parentFolder}/" instead of "references/"`,
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/md/title-matches-file-name.d.ts

@@ -1,2 +0,0 @@
-import type { MarkdownRuleDefinition } from "@eslint/markdown";
-export declare const titleMatchesFileNameRule: MarkdownRuleDefinition;

package/dist/eslint/pasika/rules/md/title-matches-file-name.js

@@ -1,46 +0,0 @@
-/**
- * @fileoverview Document title must match the file name in kebab-case.
- */
-import path from "node:path";
-import { getFilename, getTextContent } from "./helpers.js";
-function toExpectedFileName(title) {
-    return `${title
-        .toLowerCase()
-        .replaceAll(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "")}.md`;
-}
-export const titleMatchesFileNameRule = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Document title must match the file name in kebab-case.",
-            recommended: true,
-        },
-    },
-    create(context) {
-        return {
-            heading(node) {
-                if (node.depth !== 1)
-                    return;
-                const filename = getFilename(context);
-                if (!filename.endsWith(".md"))
-                    return;
-                const title = getTextContent(node).trim();
-                const expectedFileName = toExpectedFileName(title);
-                const actualFileName = path.basename(filename);
-                if (!title) {
-                    context.report({
-                        node,
-                        message: "document has no `# Title` heading",
-                    });
-                }
-                else if (expectedFileName !== actualFileName) {
-                    context.report({
-                        node,
-                        message: `title "${title}" expects file name ${expectedFileName}`,
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/named-exports.d.ts

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

package/dist/eslint/pasika/rules/named-exports.js

@@ -1,49 +0,0 @@
-/**
- * ESLint rule: pasika/named-exports
- *
- * Enforces named exports for application files while allowing framework routing
- * files such as Next.js page.tsx and layout.tsx to use their required default
- * export contract.
- *
- * @see docs/code-organization-guide/rules/exports-and-imports-rule.md
- */
-import path from "node:path";
-const FRAMEWORK_DEFAULT_EXPORT_FILES = new Set([
-    "default",
-    "error",
-    "layout",
-    "loading",
-    "not-found",
-    "page",
-    "route",
-    "template",
-]);
-function isFrameworkDefaultExportFile(filename) {
-    const normalized = filename.replaceAll(path.sep, "/");
-    if (!normalized.includes("/src/app/"))
-        return false;
-    const basename = path.basename(filename, path.extname(filename));
-    return FRAMEWORK_DEFAULT_EXPORT_FILES.has(basename);
-}
-export const namedExportsRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Require named exports except where a framework requires a default export.",
-        },
-    },
-    create(context) {
-        if (isFrameworkDefaultExportFile(context.filename))
-            return {};
-        return {
-            ExportDefaultDeclaration(node) {
-                context.report({
-                    node,
-                    message: "Files that export values must use named exports unless a framework or third-party package requires a different export style for that file. " +
-                        "See docs/code-organization-guide/rules/exports-and-imports-rule.md",
-                });
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/no-arbitrary-tailwind.d.ts

@@ -1,9 +0,0 @@
-/**
- * ESLint rule: pasika/no-arbitrary-tailwind
- *
- * Enforces the "Arbitrary Value Rule" — no arbitrary-value Tailwind classes.
- *
- * @see docs/styling-guide/rules/arbitrary-value-rule.md
- */
-import type { Rule } from "eslint";
-export declare const noArbitraryTailwindRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/no-arbitrary-tailwind.js

@@ -1,97 +0,0 @@
-/**
- * ESLint rule: pasika/no-arbitrary-tailwind
- *
- * Enforces the "Arbitrary Value Rule" — no arbitrary-value Tailwind classes.
- *
- * @see docs/styling-guide/rules/arbitrary-value-rule.md
- */
-/**
- * Matches Tailwind arbitrary-value utility classes like rounded-[13px], text-[#fff].
- *
- * Does NOT match variant prefixes like min-[400px]:flex-row or md:flex.
- * The negative lookahead (?![-\w]*:) excludes anything followed by a colon + more.
- *
- * Note: Tailwind breakpoint variants (sm:, md:, lg:, etc.) don't use brackets,
- * so they're never matched. Only bracket-based variants like min-[400px]: need
- * the lookahead exclusion.
- */
-const ARBITRARY_VALUE_RE = /(?:^|(?<=\s))(?:[a-z]+(?:-[a-z]+)*)-\[[^\]]+\](?![-\w]*:)/g;
-const CLASS_HELPERS = new Set(["cn", "clsx", "twMerge", "twJoin"]);
-export const noArbitraryTailwindRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Disallow Tailwind arbitrary-value classes like rounded-[13px].",
-        },
-    },
-    create(context) {
-        function reportClassString(node, value) {
-            ARBITRARY_VALUE_RE.lastIndex = 0;
-            const match = ARBITRARY_VALUE_RE.exec(value);
-            if (!match)
-                return;
-            context.report({
-                node,
-                message: `Tailwind arbitrary-value class "${match[0]}" is not allowed. ` +
-                    "Use a named token or custom utility. " +
-                    "See docs/styling-guide/rules/arbitrary-value-rule.md",
-            });
-        }
-        /** Walks every expression a class name can hide in: conditionals, arrays, and object keys. */
-        function checkExpression(node, expression) {
-            if (!expression)
-                return;
-            if (expression.type === "Literal") {
-                if (typeof expression.value === "string")
-                    reportClassString(node, expression.value);
-                return;
-            }
-            if (expression.type === "TemplateLiteral") {
-                for (const quasi of expression.quasis)
-                    reportClassString(node, quasi.value.raw);
-                return;
-            }
-            if (expression.type === "LogicalExpression") {
-                checkExpression(node, expression.left);
-                checkExpression(node, expression.right);
-                return;
-            }
-            if (expression.type === "ConditionalExpression") {
-                checkExpression(node, expression.consequent);
-                checkExpression(node, expression.alternate);
-                return;
-            }
-            if (expression.type === "ArrayExpression") {
-                for (const element of expression.elements)
-                    checkExpression(node, element);
-                return;
-            }
-            if (expression.type === "ObjectExpression") {
-                // clsx and cn accept `{ "px-[3px]": isActive }`, so the keys carry classes.
-                for (const property of expression.properties) {
-                    if (property.type === "Property")
-                        checkExpression(node, property.key);
-                }
-            }
-        }
-        return {
-            JSXAttribute(node) {
-                const attributeName = node.name?.name;
-                if (attributeName !== "className" && attributeName !== "class")
-                    return;
-                const value = node.value;
-                if (!value)
-                    return;
-                checkExpression(node, value.type === "JSXExpressionContainer" ? value.expression : value);
-            },
-            CallExpression(node) {
-                if (node.callee.type !== "Identifier" || !CLASS_HELPERS.has(node.callee.name))
-                    return;
-                for (const argument of node.arguments) {
-                    checkExpression(node, argument);
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/no-eslint-disable.d.ts

@@ -1,10 +0,0 @@
-/**
- * ESLint rule: pasika/no-eslint-disable
- *
- * Code MUST NOT use eslint-disable directives, and a reported violation MUST
- * be fixed instead.
- *
- * @see docs/agent-policy.md
- */
-import type { Rule } from "eslint";
-export declare const noEslintDisableRule: Rule.RuleModule;

package/dist/eslint/pasika/rules/no-eslint-disable.js

@@ -1,33 +0,0 @@
-/**
- * ESLint rule: pasika/no-eslint-disable
- *
- * Code MUST NOT use eslint-disable directives, and a reported violation MUST
- * be fixed instead.
- *
- * @see docs/agent-policy.md
- */
-export const noEslintDisableRule = {
-    meta: {
-        schema: [],
-        type: "problem",
-        docs: {
-            description: "Forbid eslint-disable directives.",
-        },
-    },
-    create(context) {
-        return {
-            Program() {
-                for (const comment of context.sourceCode.getAllComments()) {
-                    if (!comment.value.includes("eslint-disable"))
-                        continue;
-                    if (!comment.loc)
-                        continue;
-                    context.report({
-                        loc: comment.loc,
-                        message: "Do not use eslint-disable directives; fix the reported violation instead.",
-                    });
-                }
-            },
-        };
-    },
-};

package/dist/eslint/pasika/rules/no-mixed-concerns.d.ts

@@ -1,9 +0,0 @@
-/**
- * ESLint rule: pasika/no-mixed-concerns
- *
- * Enforces the "No Mixed Concerns Rule" — one React component per .tsx file.
- *
- * @see docs/code-organization-guide/rules/no-mixed-concerns-rule.md
- */
-import type { Rule } from "eslint";
-export declare const noMixedConcernsRule: Rule.RuleModule;