slopbrick 0.18.5 → 0.18.7

package/dist/index.cjs

@@ -36,7 +36,7 @@ var VERSION;
 var init_header = __esm({
   "src/types/_header.ts"() {
     "use strict";
-    VERSION = "0.18.5";
+    VERSION = "0.18.7";
   }
 });
 
@@ -29765,6 +29765,9 @@ var init_expired_code_example = __esm({
         const issues = [];
         const source = facts.v2?._source;
         if (!source) return issues;
+        const packages = declaredPackages(context.cwd);
+        const packageName = context.packageName;
+        if (packageName) packages.add(packageName);
         const blocks = extractFencedCodeBlocks(source);
         for (const block of blocks) {
           if (!CODE_LANGS.has(block.lang)) continue;
@@ -29772,7 +29775,7 @@ var init_expired_code_example = __esm({
           const imports = extractImports(block.body);
           for (const imp of imports) {
             const pkgName = stripSubpath(imp);
-            if (context.packages.has(pkgName)) continue;
+            if (packages.has(pkgName)) continue;
             issues.push({
               ruleId: "docs/expired-code-example",
               category: "docs",
@@ -29825,7 +29828,12 @@ function collectExports(cwd) {
       /\bexport\s+class\s+([A-Za-z_$][\w$]*)/g,
       /\bexport\s+interface\s+([A-Za-z_$][\w$]*)/g,
       /\bexport\s+type\s+([A-Za-z_$][\w$]*)/g,
-      /\bexport\s+default\s+(?:function\s+|class\s+)?([A-Za-z_$][\w$]*)/g
+      /\bexport\s+default\s+(?:function\s+|class\s+)?([A-Za-z_$][\w$]*)/g,
+      // v0.18.6: also collect field names from `export interface` and
+      // `export type` declarations. Without this, fields like
+      // `crossFileDrift`, `aiQuality`, `engineeringHygiene` are
+      // flagged as stale even though they're valid type fields.
+      /^\s*(?:readonly\s+)?([A-Za-z_$][\w$]*)\s*[?:]/gm
     ]) {
       let m;
       while ((m = re.exec(source)) !== null) {
@@ -29836,6 +29844,21 @@ function collectExports(cwd) {
   }
   return out;
 }
+function looksLikeProseLabel(inside) {
+  const trimmed = inside.trim();
+  if (trimmed.length === 0) return false;
+  if (trimmed.startsWith("`") || trimmed.startsWith("/")) return true;
+  if (trimmed.includes("`")) return true;
+  if (/\d+\s+[a-z]/i.test(trimmed)) return true;
+  const parts = trimmed.split(",").map((s) => s.trim());
+  if (parts.length >= 3) {
+    const allNumeric = parts.every((p) => /^\d+\.?\d*$/.test(p));
+    if (!allNumeric) return true;
+  }
+  if (trimmed.length > 40 && !trimmed.includes(",")) return true;
+  if (trimmed.includes("\u2014") || trimmed.includes("\u2013")) return true;
+  return false;
+}
 var import_node_fs7, import_node_path7, RESERVED, SOURCE_EXTS, SOURCE_ROOTS, CAP, staleFunctionReferenceRule;
 var init_stale_function_reference = __esm({
   "src/rules/docs/stale-function-reference.ts"() {
@@ -29845,6 +29868,7 @@ var init_stale_function_reference = __esm({
     init_rule();
     init_doc_freshness();
     RESERVED = /* @__PURE__ */ new Set([
+      // JS reserved words
       "true",
       "false",
       "null",
@@ -29944,7 +29968,472 @@ var init_stale_function_reference = __esm({
       "next",
       "vue",
       "angular",
-      "svelte"
+      "svelte",
+      // Framework / runtime names
+      "html",
+      "astro",
+      "python",
+      "jvm",
+      "kotlin",
+      "swift",
+      "dart",
+      "ruby",
+      "rust",
+      "cpp",
+      "go",
+      "java",
+      "php",
+      "php-html",
+      "csharp",
+      "typescript",
+      "javascript",
+      "jsx",
+      "tsx",
+      "mjs",
+      "cjs",
+      "esnext",
+      "es6",
+      "es2022",
+      "es2023",
+      "esm",
+      "cjs",
+      "umd",
+      "amd",
+      "commonjs",
+      "require",
+      "module",
+      "exports",
+      "define",
+      "global",
+      "window",
+      "document",
+      "process",
+      "console",
+      "buffer",
+      "stream",
+      "fetch",
+      "axios",
+      "express",
+      "fastify",
+      "koa",
+      "hapi",
+      "nextjs",
+      "nuxt",
+      "remix",
+      "gatsby",
+      "sveltekit",
+      "solid",
+      "preact",
+      "qwik",
+      "lit",
+      "stencil",
+      "marko",
+      "alpine",
+      "stimulus",
+      "turbo",
+      "hotwire",
+      // Models / providers
+      "gpt",
+      "claude",
+      "gpt-3",
+      "gpt-3.5",
+      "gpt-4",
+      "gpt-oss",
+      "haiku",
+      "sonnet",
+      "opus",
+      "aider",
+      "tabby",
+      "copilot",
+      "cursor",
+      "windsurf",
+      "devin",
+      "claude-code",
+      // LLM-detection lingo
+      "heuristic",
+      "heuristics",
+      "calibrate",
+      "calibration",
+      "calibrator",
+      "corpus",
+      "baseline",
+      "baselines",
+      "corpus-baselines",
+      "lift",
+      "recall",
+      "precision",
+      "fpRate",
+      "ratio",
+      "verdict",
+      "USEFUL",
+      "NOISY",
+      "INVERTED",
+      "HYGIENE",
+      "DORMANT",
+      "OK",
+      "aiSpecific",
+      "defaultOff",
+      // Common slop-audit verbs/nouns
+      "commit",
+      "push",
+      "reset",
+      "rebase",
+      "merge",
+      "cherry-pick",
+      "revert",
+      "scan",
+      "parse",
+      "build",
+      "test",
+      "lint",
+      "format",
+      "check",
+      "audit",
+      "fix",
+      "patch",
+      "diff",
+      "pr",
+      "ci",
+      "cd",
+      "gh",
+      "npm",
+      "npx",
+      "pnpm",
+      "yaml",
+      "json",
+      "toml",
+      "csv",
+      "md",
+      "mdx",
+      "sh",
+      "bash",
+      "zsh",
+      "fish",
+      "ascii",
+      "utf8",
+      "utf-8",
+      "base64",
+      "hex",
+      "binary",
+      "text",
+      // Common design / ui terms
+      "flex",
+      "grid",
+      "auto",
+      "min",
+      "max",
+      "fill",
+      "stretch",
+      "wrap",
+      "nowrap",
+      "inline",
+      "block",
+      "hidden",
+      "visible",
+      "static",
+      "fixed",
+      "absolute",
+      "relative",
+      "sticky",
+      "pointer",
+      "cursor",
+      "focus",
+      "hover",
+      "active",
+      "disabled",
+      "readonly",
+      "primary",
+      "secondary",
+      "tertiary",
+      "success",
+      "warning",
+      "danger",
+      "info",
+      "muted",
+      "sm",
+      "md",
+      "lg",
+      "xl",
+      "xxl",
+      "xs",
+      "2xl",
+      "3xl",
+      "4xl",
+      // Math / types
+      "array",
+      "map",
+      "set",
+      "weakmap",
+      "weakset",
+      "object",
+      "string",
+      "number",
+      "boolean",
+      "bigint",
+      "symbol",
+      "null",
+      "undefined",
+      "any",
+      "unknown",
+      "never",
+      "void",
+      "readonly",
+      "private",
+      "public",
+      "protected",
+      "static",
+      "abstract",
+      "async",
+      "generator",
+      "iterator",
+      "iterable",
+      "promise",
+      "observable",
+      // Auth / domain
+      "admin",
+      "user",
+      "guest",
+      "anonymous",
+      "authenticated",
+      "unauthenticated",
+      "jwt",
+      "oauth",
+      "oidc",
+      "saml",
+      "csrf",
+      "xss",
+      "sql",
+      "nosql",
+      "orm",
+      "prisma",
+      "drizzle",
+      "sequelize",
+      "mongoose",
+      "redis",
+      "postgres",
+      "mysql",
+      "sqlite",
+      "kafka",
+      "rabbitmq",
+      "graphql",
+      "rest",
+      "grpc",
+      "websocket",
+      // slop-audit specific
+      "slopbrick",
+      "usebrick",
+      "deadcode",
+      "unused",
+      "orphan",
+      "zombie",
+      "blocker",
+      "warning",
+      "info",
+      "error",
+      "verbose",
+      "debug",
+      "silly",
+      "p50",
+      "p90",
+      "p95",
+      "p99",
+      "min",
+      "max",
+      "avg",
+      "mean",
+      "median",
+      "ratchet",
+      "tier",
+      "composite",
+      "fitness",
+      "fpr",
+      "tpr",
+      "roc",
+      "should",
+      "could",
+      "would",
+      "might",
+      "must",
+      "shall",
+      "may",
+      "can",
+      "todo",
+      "fixme",
+      "xxx",
+      "hack",
+      "note",
+      "warning",
+      "attention",
+      "h1",
+      "h2",
+      "h3",
+      "h4",
+      "h5",
+      "h6",
+      "strong",
+      "em",
+      "b",
+      "i",
+      "u",
+      "true",
+      "false",
+      "yes",
+      "no",
+      "on",
+      "off",
+      "enable",
+      "disable",
+      "ltr",
+      "rtl",
+      "auto",
+      "start",
+      "end",
+      "center",
+      "baseline",
+      "stretch",
+      "rounded",
+      "sharp",
+      "outline",
+      "ghost",
+      "link",
+      "filled",
+      "row",
+      "col",
+      "gap",
+      "pad",
+      "margin",
+      "padding",
+      "border",
+      "shadow",
+      "transparent",
+      "currentcolor",
+      "inherit",
+      "initial",
+      "unset",
+      "revert",
+      "hover",
+      "focus",
+      "active",
+      "disabled",
+      "checked",
+      "indeterminate",
+      "open",
+      "close",
+      "expanded",
+      "collapsed",
+      "selected",
+      "pressed",
+      // Web/CSS
+      "div",
+      "span",
+      "p",
+      "a",
+      "img",
+      "ul",
+      "ol",
+      "li",
+      "table",
+      "tr",
+      "td",
+      "th",
+      "thead",
+      "tbody",
+      "tfoot",
+      "caption",
+      "figure",
+      "figcaption",
+      "main",
+      "section",
+      "article",
+      "aside",
+      "header",
+      "footer",
+      "nav",
+      "form",
+      "input",
+      "button",
+      "select",
+      "option",
+      "textarea",
+      "label",
+      "fieldset",
+      "legend",
+      "details",
+      "summary",
+      "dialog",
+      "menu",
+      "menuitem",
+      "template",
+      "slot",
+      "picture",
+      "source",
+      "track",
+      "video",
+      "audio",
+      "canvas",
+      "svg",
+      "iframe",
+      "embed",
+      "object",
+      "portal",
+      // Common business terms
+      "api",
+      "cli",
+      "ui",
+      "ux",
+      "sdk",
+      "ide",
+      "cli",
+      "docs",
+      "doc",
+      "blog",
+      "post",
+      "page",
+      "view",
+      "tab",
+      "panel",
+      "card",
+      "list",
+      "grid",
+      "form",
+      "modal",
+      "menu",
+      "button",
+      "icon",
+      "avatar",
+      "badge",
+      "chip",
+      "tooltip",
+      "popover",
+      "dropdown",
+      "banner",
+      "alert",
+      "toast",
+      "notification",
+      "drawer",
+      "sidebar",
+      "navbar",
+      "header",
+      "footer",
+      "hero",
+      "cta",
+      "cta-primary",
+      "cta-secondary",
+      "pricing",
+      "price",
+      "cost",
+      "rate",
+      "percent",
+      "pct",
+      "count",
+      "total",
+      "small",
+      "medium",
+      "large",
+      "xl",
+      "xxl",
+      "tiny",
+      "huge"
     ]);
     SOURCE_EXTS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
     SOURCE_ROOTS = ["src", "lib", "app", "components"];
@@ -29968,8 +30457,39 @@ var init_stale_function_reference = __esm({
           if (text.length < 3) continue;
           if (RESERVED.has(text.toLowerCase())) continue;
           if (context.exports.has(text)) continue;
-          const end = Math.min(source.length, span.index + text.length + 50);
-          if (!/\(/.test(source.slice(span.index, end))) continue;
+          const lineEnd = source.indexOf("\n", span.index);
+          const restOfLine = source.slice(
+            span.index,
+            lineEnd === -1 ? source.length : lineEnd
+          );
+          const closeTick = restOfLine.indexOf("`", 1);
+          if (closeTick === -1) continue;
+          const afterTick = restOfLine.slice(closeTick + 1);
+          const directCall = /^\s*\(/.test(afterTick);
+          let identifierRepeats = false;
+          if (!directCall) {
+            const afterSpan = restOfLine.slice(closeTick + 1);
+            const needle = text + "(";
+            identifierRepeats = afterSpan.indexOf(needle) !== -1;
+          }
+          if (!directCall && !identifierRepeats) continue;
+          const beforeTickIdx = span.index - 1;
+          const beforeChar = beforeTickIdx >= 0 ? source[beforeTickIdx] : "";
+          if (beforeChar === "." || beforeChar === "|") continue;
+          const parenStart = restOfLine.indexOf("(", closeTick);
+          const parenEnd = restOfLine.indexOf(")", parenStart);
+          if (parenStart !== -1 && parenEnd !== -1) {
+            const inside = restOfLine.slice(parenStart + 1, parenEnd);
+            const trimmed = inside.trim();
+            if (looksLikeProseLabel(inside)) continue;
+            const looksLikeTypeAnnotation = !inside.includes(":") && (/\b(string|number|boolean|null|undefined|object|array|required|optional|categorical|direct|n\/a|\bmapped\b|0[\-–][0-9]+|v[0-9]|higher is better|lower is better|added in|deprecated|pr-[0-9])\b/i.test(
+              inside
+            ) || // Short single-word label (≤ 24 chars, no `,`,
+            // doesn't look like a function arg). Real function
+            // calls are usually longer or contain commas.
+            trimmed.length > 0 && trimmed.length <= 24 && !trimmed.includes(",") && /[a-zA-Z]/.test(trimmed));
+            if (looksLikeTypeAnnotation) continue;
+          }
           issues.push({
             ruleId: "docs/stale-function-reference",
             category: "docs",
@@ -30049,7 +30569,33 @@ var init_stale_package_reference = __esm({
       "jsx",
       "ok",
       "no",
-      "yes"
+      "yes",
+      // v0.18.6: common English adjectives / adverbs that frequently
+      // appear in backticked prose but are not package names.
+      "aspirational",
+      "concrete",
+      "abstract",
+      "inline",
+      "exposed",
+      "deprecated",
+      "experimental",
+      "stable",
+      "beta",
+      "alpha",
+      "wip",
+      "draft",
+      "final",
+      "shim",
+      "polyfill",
+      "stub",
+      "mock",
+      "fake",
+      "real",
+      "false",
+      "true",
+      "optional",
+      "required",
+      "default"
     ]);
     stalePackageReferenceRule = createRule({
       id: "docs/stale-package-reference",
@@ -30271,7 +30817,15 @@ async function buildDocFreshness(cwd, config, options = {}) {
       continue;
     }
     const relPath = (0, import_node_path8.relative)(cwd, abs);
-    const context = { config, filePath: relPath, cwd };
+    let packageName;
+    try {
+      const pkg = JSON.parse(
+        (0, import_node_fs8.readFileSync)((0, import_node_path8.join)(cwd, "package.json"), "utf-8")
+      );
+      packageName = pkg.name;
+    } catch {
+    }
+    const context = { config, filePath: relPath, cwd, packageName };
     const facts = { filePath: relPath, v2: { _source: source } };
     const ruleConfigs = [
       { rule: stalePackageReferenceRule, ruleId: "docs/stale-package-reference" },
@@ -30387,7 +30941,9 @@ var init_broken_link = __esm({
           if (target.startsWith("#")) continue;
           if (target.startsWith("//")) continue;
           if (target.startsWith("/")) continue;
-          const resolved = (0, import_node_path9.join)(docDir, target);
+          const filePart = target.split("#")[0] ?? target;
+          if (filePart === "") continue;
+          const resolved = (0, import_node_path9.join)(docDir, filePart);
           if ((0, import_node_fs9.existsSync)(resolved)) continue;
           issues.push({
             ruleId: "docs/broken-link",