@fairfox/polly 0.22.0 → 0.24.0

package/dist/tools/quality/src/cli.js

@@ -42,28 +42,55 @@ function isLineClean(line) {
   }
   if (line.match(/\bas\s*[=:,]/))
     return true;
-  if (line.match(/\)\s+as\s+\w+/))
+  if (everyAsInsideString(line))
+    return true;
+  if (isJsxText(trimmed))
+    return true;
+  if (isPlainText(trimmed))
     return true;
-  const idx = line.indexOf(" as ");
-  if (idx >= 0) {
-    const before = line.substring(0, idx);
-    const singleQuotes = (before.match(/'/g) ?? []).length;
-    const doubleQuotes = (before.match(/"/g) ?? []).length;
-    const backticks = (before.match(/`/g) ?? []).length;
-    if (singleQuotes % 2 === 1 || doubleQuotes % 2 === 1 || backticks % 2 === 1) {
-      return true;
-    }
-  }
   const commentIdx = line.indexOf("//");
   if (commentIdx >= 0 && line.indexOf(" as ", commentIdx) >= 0) {
     const beforeComment = line.substring(0, commentIdx);
     if (!beforeComment.includes(" as "))
       return true;
   }
+  if (line.match(/"\)\s+as\s+\w+"/))
+    return true;
   if (line.includes(" satisfies "))
     return true;
   return false;
 }
+function everyAsInsideString(line) {
+  let searchFrom = 0;
+  while (true) {
+    const idx = line.indexOf(" as ", searchFrom);
+    if (idx < 0)
+      return true;
+    const before = line.substring(0, idx);
+    const singleQuotes = (before.match(/'/g) ?? []).length;
+    const doubleQuotes = (before.match(/"/g) ?? []).length;
+    const backticks = (before.match(/`/g) ?? []).length;
+    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {
+      return false;
+    }
+    searchFrom = idx + 4;
+  }
+}
+function isJsxText(trimmed) {
+  if (trimmed.match(/^[^{};=()]*\bas\b[^{};=()]*$/)) {
+    if (!trimmed.match(/\bas\s+[A-Z]\w*/) && !trimmed.match(/\bas\s+(string|number|boolean|any|unknown|never)\b/)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isPlainText(trimmed) {
+  const idx = trimmed.indexOf(" as ");
+  if (idx < 0)
+    return false;
+  const before = trimmed.substring(0, idx);
+  return !before.match(/[={}:;(]/) && !before.match(/\b(const|let|var|type|interface|function|return|await)\b/);
+}
 function suggestFix(line) {
   if (line.includes("JSON.parse")) {
     return "Use a validation function or type guard to parse and validate the result.";
@@ -94,52 +121,72 @@ function suggestFix(line) {
   }
   return;
 }
+function isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles) {
+  const segments = relative.split("/");
+  if (segments.some((s) => excludeDirs.has(s)))
+    return true;
+  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s)))
+    return true;
+  const basename = segments[segments.length - 1] ?? "";
+  return excludeFiles.has(basename) || excludeFiles.has(relative);
+}
+function findViolations(relative, content) {
+  const results = [];
+  const lines = content.split(`
+`);
+  let insideTemplate = false;
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    const backticks = (line.match(/`/g) ?? []).length;
+    const startedInTemplate = insideTemplate;
+    if (backticks % 2 === 1)
+      insideTemplate = !insideTemplate;
+    if (startedInTemplate && backticks === 0 && !line.includes("${"))
+      continue;
+    if (!isLineClean(line)) {
+      results.push({
+        file: relative,
+        line: i + 1,
+        content: line.trim(),
+        advice: suggestFix(line.trim())
+      });
+    }
+  }
+  return results;
+}
+function printViolations(violations) {
+  if (violations.length === 0) {
+    console.log("[no-as-casting] ✅ No violations found.");
+    return;
+  }
+  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:
+`);
+  for (const v of violations) {
+    console.log(`  ${v.file}:${v.line}`);
+    console.log(`    ${v.content}`);
+    if (v.advice)
+      console.log(`    \uD83D\uDCA1 ${v.advice}`);
+    console.log();
+  }
+  console.log("[no-as-casting] Use type guards, validation, or fix the types at the source.");
+  console.log('[no-as-casting] Only "as const" and "as unknown as" are allowed.');
+}
 async function checkNoAsCasting(options) {
   const rootDir = options.rootDir;
   const excludeDirs = new Set(options.exclude ?? ["node_modules", "dist", ".git", ".bun"]);
+  const excludePackages = new Set(options.excludePackages ?? []);
+  const excludeFiles = new Set(options.excludeFiles ?? []);
   const pattern = options.filePatterns ?? "**/*.{ts,tsx}";
   const glob = new Glob(pattern);
   const violations = [];
   for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {
     const relative = file.replace(`${rootDir}/`, "");
-    const segments = relative.split("/");
-    if (segments.some((s) => excludeDirs.has(s)))
+    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles))
       continue;
     const content = readFileSync(file, "utf-8");
-    const lines = content.split(`
-`);
-    for (let i = 0;i < lines.length; i++) {
-      const line = lines[i] ?? "";
-      if (!isLineClean(line)) {
-        violations.push({
-          file: relative,
-          line: i + 1,
-          content: line.trim(),
-          advice: suggestFix(line.trim())
-        });
-      }
-    }
+    violations.push(...findViolations(relative, content));
   }
-  return {
-    violations,
-    print() {
-      if (violations.length === 0) {
-        console.log("[no-as-casting] ✅ No violations found.");
-        return;
-      }
-      console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:
-`);
-      for (const v of violations) {
-        console.log(`  ${v.file}:${v.line}`);
-        console.log(`    ${v.content}`);
-        if (v.advice)
-          console.log(`    \uD83D\uDCA1 ${v.advice}`);
-        console.log();
-      }
-      console.log("[no-as-casting] Use type guards, validation, or fix the types at the source.");
-      console.log('[no-as-casting] Only "as const" and "as unknown as" are allowed.');
-    }
-  };
+  return { violations, print: () => printViolations(violations) };
 }
 
 // tools/quality/src/cli.ts
@@ -150,13 +197,17 @@ function getFlag(name) {
 }
 var rootDir = getFlag("root") ?? process.cwd();
 var exclude = getFlag("exclude")?.split(",") ?? ["node_modules", "dist", ".git", ".bun"];
+var excludePackages = getFlag("exclude-packages")?.split(",");
+var excludeFiles = getFlag("exclude-files")?.split(",");
 var filePatterns = getFlag("pattern");
 var result = await checkNoAsCasting({
   rootDir,
   exclude,
+  ...excludePackages ? { excludePackages } : {},
+  ...excludeFiles ? { excludeFiles } : {},
   ...filePatterns ? { filePatterns } : {}
 });
 result.print();
 process.exit(result.violations.length > 0 ? 1 : 0);
 
-//# debugId=C4D3FE8A6910608764756E2164756E21
+//# debugId=D4F70D746137C24364756E2164756E21

package/dist/tools/quality/src/cli.js.map

@@ -2,10 +2,10 @@
   "version": 3,
   "sources": ["../tools/quality/src/no-as-casting.ts", "../tools/quality/src/cli.ts"],
   "sourcesContent": [
-    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n  if (line.match(/\\)\\s+as\\s+\\w+/)) return true;\n\n  const idx = line.indexOf(\" as \");\n  if (idx >= 0) {\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 1 || doubleQuotes % 2 === 1 || backticks % 2 === 1) {\n      return true;\n    }\n  }\n\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    const segments = relative.split(\"/\");\n    if (segments.some((s) => excludeDirs.has(s))) continue;\n\n    const content = readFileSync(file, \"utf-8\");\n    const lines = content.split(\"\\n\");\n\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i] ?? \"\";\n      if (!isLineClean(line)) {\n        violations.push({\n          file: relative,\n          line: i + 1,\n          content: line.trim(),\n          advice: suggestFix(line.trim()),\n        });\n      }\n    }\n  }\n\n  return {\n    violations,\n    print() {\n      if (violations.length === 0) {\n        console.log(\"[no-as-casting] ✅ No violations found.\");\n        return;\n      }\n      console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n      for (const v of violations) {\n        console.log(`  ${v.file}:${v.line}`);\n        console.log(`    ${v.content}`);\n        if (v.advice) console.log(`    💡 ${v.advice}`);\n        console.log();\n      }\n      console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n      console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n    },\n  };\n}\n",
-    "#!/usr/bin/env bun\n\n/**\n * CLI entry point for Polly quality checks.\n *\n *   polly quality [--root <dir>] [--exclude <dirs>] [--pattern <glob>]\n *\n * Runs all conformance checks (currently: no-as-casting) against the\n * target directory and exits non-zero when violations are found.\n */\n\nimport { checkNoAsCasting } from \"./no-as-casting\";\n\nconst args = process.argv.slice(2);\n\nfunction getFlag(name: string): string | undefined {\n  const idx = args.indexOf(`--${name}`);\n  return idx >= 0 ? args[idx + 1] : undefined;\n}\n\nconst rootDir = getFlag(\"root\") ?? process.cwd();\nconst exclude = getFlag(\"exclude\")?.split(\",\") ?? [\"node_modules\", \"dist\", \".git\", \".bun\"];\nconst filePatterns = getFlag(\"pattern\");\n\nconst result = await checkNoAsCasting({\n  rootDir,\n  exclude,\n  ...(filePatterns ? { filePatterns } : {}),\n});\n\nresult.print();\nprocess.exit(result.violations.length > 0 ? 1 : 0);\n"
+    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  excludePackages?: string[];\n  excludeFiles?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  // Full-line comments\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  // as const (literal narrowing)\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  // as unknown as (explicit escape hatch)\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  // Import/export renames\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  // Property declarations: as= or as: or as,\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n\n  // String literal detection: count quotes before each ` as ` occurrence.\n  // If any quote type has an odd count, the ` as ` is inside a string.\n  if (everyAsInsideString(line)) return true;\n\n  // JSX text: ` as ` between > and < with no code syntax around it\n  if (isJsxText(trimmed)) return true;\n\n  // Plain text heuristic: indented line with no code syntax characters\n  // before ` as ` — catches multiline JSX text and template literal bodies.\n  if (isPlainText(trimmed)) return true;\n\n  // Inline comment: ` as ` appears only after //\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  // SQL alias: `) as column_name`\n  if (line.match(/\"\\)\\s+as\\s+\\w+\"/)) return true;\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Returns true when every ` as ` occurrence in the line falls inside a\n * string literal (single-quoted, double-quoted, or backtick).\n */\nfunction everyAsInsideString(line: string): boolean {\n  let searchFrom = 0;\n  while (true) {\n    const idx = line.indexOf(\" as \", searchFrom);\n    if (idx < 0) return true; // no more ` as ` to check\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {\n      return false; // this ` as ` is outside any string\n    }\n    searchFrom = idx + 4;\n  }\n}\n\n/**\n * Detects JSX text content — ` as ` appearing between > and < with no\n * code-like syntax around it (no braces, semicolons, equals signs).\n */\nfunction isJsxText(trimmed: string): boolean {\n  // Classic JSX text: starts after > or is plain text ending before <\n  if (trimmed.match(/^[^{};=()]*\\bas\\b[^{};=()]*$/)) {\n    // No code syntax at all — could be JSX text or template literal body.\n    // Reject if it looks like a type assertion (word ` as ` TypeName pattern\n    // where TypeName starts with uppercase, or is a known TS type).\n    if (\n      !trimmed.match(/\\bas\\s+[A-Z]\\w*/) &&\n      !trimmed.match(/\\bas\\s+(string|number|boolean|any|unknown|never)\\b/)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Heuristic for plain text in template literals or JSX: the line has no\n * code-like characters before ` as ` — no `=`, `{`, `}`, `:`, `;`, `(`.\n */\nfunction isPlainText(trimmed: string): boolean {\n  const idx = trimmed.indexOf(\" as \");\n  if (idx < 0) return false;\n  const before = trimmed.substring(0, idx);\n  // If nothing before ` as ` looks like code, it's probably prose.\n  return (\n    !before.match(/[={}:;(]/) &&\n    !before.match(/\\b(const|let|var|type|interface|function|return|await)\\b/)\n  );\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\nfunction isFileExcluded(\n  relative: string,\n  excludeDirs: Set<string>,\n  excludePackages: Set<string>,\n  excludeFiles: Set<string>\n): boolean {\n  const segments = relative.split(\"/\");\n  if (segments.some((s) => excludeDirs.has(s))) return true;\n  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s))) return true;\n  const basename = segments[segments.length - 1] ?? \"\";\n  return excludeFiles.has(basename) || excludeFiles.has(relative);\n}\n\nfunction findViolations(relative: string, content: string): Violation[] {\n  const results: Violation[] = [];\n  const lines = content.split(\"\\n\");\n  let insideTemplate = false;\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    const backticks = (line.match(/`/g) ?? []).length;\n    const startedInTemplate = insideTemplate;\n    if (backticks % 2 === 1) insideTemplate = !insideTemplate;\n\n    // Line is entirely inside a multi-line template literal and has no\n    // interpolation — treat as string content (e.g. SQL column aliases).\n    if (startedInTemplate && backticks === 0 && !line.includes(\"${\")) continue;\n\n    if (!isLineClean(line)) {\n      results.push({\n        file: relative,\n        line: i + 1,\n        content: line.trim(),\n        advice: suggestFix(line.trim()),\n      });\n    }\n  }\n  return results;\n}\n\nfunction printViolations(violations: Violation[]): void {\n  if (violations.length === 0) {\n    console.log(\"[no-as-casting] ✅ No violations found.\");\n    return;\n  }\n  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n  for (const v of violations) {\n    console.log(`  ${v.file}:${v.line}`);\n    console.log(`    ${v.content}`);\n    if (v.advice) console.log(`    💡 ${v.advice}`);\n    console.log();\n  }\n  console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n  console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const excludePackages = new Set(options.excludePackages ?? []);\n  const excludeFiles = new Set(options.excludeFiles ?? []);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles)) continue;\n    const content = readFileSync(file, \"utf-8\");\n    violations.push(...findViolations(relative, content));\n  }\n\n  return { violations, print: () => printViolations(violations) };\n}\n",
+    "#!/usr/bin/env bun\n\n/**\n * CLI entry point for Polly quality checks.\n *\n *   polly quality [--root <dir>] [--exclude <dirs>] [--pattern <glob>]\n *                 [--exclude-packages <names>] [--exclude-files <names>]\n *\n * Runs all conformance checks (currently: no-as-casting) against the\n * target directory and exits non-zero when violations are found.\n */\n\nimport { checkNoAsCasting } from \"./no-as-casting\";\n\nconst args = process.argv.slice(2);\n\nfunction getFlag(name: string): string | undefined {\n  const idx = args.indexOf(`--${name}`);\n  return idx >= 0 ? args[idx + 1] : undefined;\n}\n\nconst rootDir = getFlag(\"root\") ?? process.cwd();\nconst exclude = getFlag(\"exclude\")?.split(\",\") ?? [\"node_modules\", \"dist\", \".git\", \".bun\"];\nconst excludePackages = getFlag(\"exclude-packages\")?.split(\",\");\nconst excludeFiles = getFlag(\"exclude-files\")?.split(\",\");\nconst filePatterns = getFlag(\"pattern\");\n\nconst result = await checkNoAsCasting({\n  rootDir,\n  exclude,\n  ...(excludePackages ? { excludePackages } : {}),\n  ...(excludeFiles ? { excludeFiles } : {}),\n  ...(filePatterns ? { filePatterns } : {}),\n});\n\nresult.print();\nprocess.exit(result.violations.length > 0 ? 1 : 0);\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAcA;AACA;AAyBO,SAAS,WAAW,CAAC,MAAuB;AAAA,EACjD,IAAI,CAAC,KAAK,SAAS,MAAM;AAAA,IAAG,OAAO;AAAA,EAEnC,MAAM,UAAU,KAAK,KAAK;AAAA,EAE1B,IAAI,QAAQ,WAAW,IAAI,KAAK,QAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,IAAI,GAAG;AAAA,IACnF,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,KAAK,MAAM,cAAc,GAAG;AAAA,IAC9B,MAAM,iBAAiB,KAAK,QAAQ,iBAAiB,EAAE;AAAA,IACvD,IAAI,CAAC,eAAe,SAAS,MAAM;AAAA,MAAG,OAAO;AAAA,EAC/C;AAAA,EAEA,IAAI,KAAK,SAAS,iBAAiB,KAAK,KAAK,QAAQ,EAAE,SAAS,eAAe,GAAG;AAAA,IAChF,MAAM,qBAAqB,KAAK,QAAQ,sBAAsB,EAAE;AAAA,IAChE,IAAI,CAAC,mBAAmB,SAAS,MAAM;AAAA,MAAG,OAAO;AAAA,EACnD;AAAA,EAEA,IACE,KAAK,MAAM,mCAAmC,KAC9C,KAAK,MAAM,mCAAmC,KAC9C,KAAK,MAAM,0CAA0C,KACrD,KAAK,MAAM,0BAA0B,KACrC,KAAK,MAAM,iCAAiC,GAC5C;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,KAAK,MAAM,cAAc;AAAA,IAAG,OAAO;AAAA,EACvC,IAAI,KAAK,MAAM,eAAe;AAAA,IAAG,OAAO;AAAA,EAExC,MAAM,MAAM,KAAK,QAAQ,MAAM;AAAA,EAC/B,IAAI,OAAO,GAAG;AAAA,IACZ,MAAM,SAAS,KAAK,UAAU,GAAG,GAAG;AAAA,IACpC,MAAM,gBAAgB,OAAO,MAAM,IAAI,KAAK,CAAC,GAAG;AAAA,IAChD,MAAM,gBAAgB,OAAO,MAAM,IAAI,KAAK,CAAC,GAAG;AAAA,IAChD,MAAM,aAAa,OAAO,MAAM,IAAI,KAAK,CAAC,GAAG;AAAA,IAC7C,IAAI,eAAe,MAAM,KAAK,eAAe,MAAM,KAAK,YAAY,MAAM,GAAG;AAAA,MAC3E,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,KAAK,QAAQ,IAAI;AAAA,EACpC,IAAI,cAAc,KAAK,KAAK,QAAQ,QAAQ,UAAU,KAAK,GAAG;AAAA,IAC5D,MAAM,gBAAgB,KAAK,UAAU,GAAG,UAAU;AAAA,IAClD,IAAI,CAAC,cAAc,SAAS,MAAM;AAAA,MAAG,OAAO;AAAA,EAC9C;AAAA,EAEA,IAAI,KAAK,SAAS,aAAa;AAAA,IAAG,OAAO;AAAA,EAEzC,OAAO;AAAA;AAOF,SAAS,UAAU,CAAC,MAAkC;AAAA,EAC3D,IAAI,KAAK,SAAS,YAAY,GAAG;AAAA,IAC/B,OAAO;AAAA,EACT;AAAA,EACA,IACE,KAAK,SAAS,qBAAqB,KACnC,KAAK,SAAS,wBAAwB,KACtC,KAAK,SAAS,sBAAsB,GACpC;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,gBAAgB,KAAK,KAAK,SAAS,YAAY,GAAG;AAAA,IAClE,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,KAAK,GAAG;AAAA,IACnD,OAAO;AAAA,EACT;AAAA,EACA,IACE,KAAK,SAAS,yBAAyB,MACtC,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,YAAY,IACtD;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,yBAAyB,GAAG;AAAA,IAC5C,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,eAAe,GAAG;AAAA,IAChE,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,YAAY,GAAG;AAAA,IAC3F,OAAO;AAAA,EACT;AAAA,EACA,IAAI,KAAK,SAAS,QAAQ,GAAG;AAAA,IAC3B,OAAO;AAAA,EACT;AAAA,EACA;AAAA;AAOF,eAAsB,gBAAgB,CAAC,SAA6C;AAAA,EAClF,MAAM,UAAU,QAAQ;AAAA,EACxB,MAAM,cAAc,IAAI,IAAI,QAAQ,WAAW,CAAC,gBAAgB,QAAQ,QAAQ,MAAM,CAAC;AAAA,EACvF,MAAM,UAAU,QAAQ,gBAAgB;AAAA,EACxC,MAAM,OAAO,IAAI,KAAK,OAAO;AAAA,EAC7B,MAAM,aAA0B,CAAC;AAAA,EAEjC,iBAAiB,QAAQ,KAAK,KAAK,EAAE,KAAK,SAAS,UAAU,KAAK,CAAC,GAAG;AAAA,IACpE,MAAM,WAAW,KAAK,QAAQ,GAAG,YAAY,EAAE;AAAA,IAC/C,MAAM,WAAW,SAAS,MAAM,GAAG;AAAA,IACnC,IAAI,SAAS,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC;AAAA,MAAG;AAAA,IAE9C,MAAM,UAAU,aAAa,MAAM,OAAO;AAAA,IAC1C,MAAM,QAAQ,QAAQ,MAAM;AAAA,CAAI;AAAA,IAEhC,SAAS,IAAI,EAAG,IAAI,MAAM,QAAQ,KAAK;AAAA,MACrC,MAAM,OAAO,MAAM,MAAM;AAAA,MACzB,IAAI,CAAC,YAAY,IAAI,GAAG;AAAA,QACtB,WAAW,KAAK;AAAA,UACd,MAAM;AAAA,UACN,MAAM,IAAI;AAAA,UACV,SAAS,KAAK,KAAK;AAAA,UACnB,QAAQ,WAAW,KAAK,KAAK,CAAC;AAAA,QAChC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA,KAAK,GAAG;AAAA,MACN,IAAI,WAAW,WAAW,GAAG;AAAA,QAC3B,QAAQ,IAAI,wCAAuC;AAAA,QACnD;AAAA,MACF;AAAA,MACA,QAAQ,IAAI,qBAAoB,WAAW;AAAA,CAA8B;AAAA,MACzE,WAAW,KAAK,YAAY;AAAA,QAC1B,QAAQ,IAAI,KAAK,EAAE,QAAQ,EAAE,MAAM;AAAA,QACnC,QAAQ,IAAI,OAAO,EAAE,SAAS;AAAA,QAC9B,IAAI,EAAE;AAAA,UAAQ,QAAQ,IAAI,oBAAS,EAAE,QAAQ;AAAA,QAC7C,QAAQ,IAAI;AAAA,MACd;AAAA,MACA,QAAQ,IAAI,8EAA8E;AAAA,MAC1F,QAAQ,IAAI,kEAAkE;AAAA;AAAA,EAElF;AAAA;;;AC5KF,IAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AAEjC,SAAS,OAAO,CAAC,MAAkC;AAAA,EACjD,MAAM,MAAM,KAAK,QAAQ,KAAK,MAAM;AAAA,EACpC,OAAO,OAAO,IAAI,KAAK,MAAM,KAAK;AAAA;AAGpC,IAAM,UAAU,QAAQ,MAAM,KAAK,QAAQ,IAAI;AAC/C,IAAM,UAAU,QAAQ,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC,gBAAgB,QAAQ,QAAQ,MAAM;AACzF,IAAM,eAAe,QAAQ,SAAS;AAEtC,IAAM,SAAS,MAAM,iBAAiB;AAAA,EACpC;AAAA,EACA;AAAA,KACI,eAAe,EAAE,aAAa,IAAI,CAAC;AACzC,CAAC;AAED,OAAO,MAAM;AACb,QAAQ,KAAK,OAAO,WAAW,SAAS,IAAI,IAAI,CAAC;",
-  "debugId": "C4D3FE8A6910608764756E2164756E21",
+  "mappings": "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",
+  "debugId": "D4F70D746137C24364756E2164756E21",
   "names": []
 }

package/dist/tools/quality/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fairfox/polly/quality — conformance checks for Polly applications.
+ *
+ * Exports the same quality rules that Polly enforces on itself, so
+ * consuming applications can adopt the same standards. The flagship
+ * check is `isLineClean` which detects forbidden `as` type assertions;
+ * applications wire it into their own CI or pre-commit hook via the
+ * companion `checkNoAsCasting` runner.
+ *
+ * @example
+ * ```typescript
+ * import { checkNoAsCasting } from "@fairfox/polly/quality";
+ *
+ * const result = await checkNoAsCasting({
+ *   rootDir: process.cwd(),
+ *   exclude: ["node_modules", "dist"],
+ * });
+ *
+ * if (result.violations.length > 0) {
+ *   result.print();
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export { type CheckResult, checkNoAsCasting, isLineClean, suggestFix, type Violation, } from "./no-as-casting";

package/dist/tools/quality/src/index.js

@@ -0,0 +1,196 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// tools/quality/src/no-as-casting.ts
+import { readFileSync } from "node:fs";
+import { Glob } from "bun";
+function isLineClean(line) {
+  if (!line.includes(" as "))
+    return true;
+  const trimmed = line.trim();
+  if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+    return true;
+  }
+  if (line.match(/\bas const\b/)) {
+    const withoutAsConst = line.replace(/\bas const\b/g, "");
+    if (!withoutAsConst.includes(" as "))
+      return true;
+  }
+  if (line.includes(" as unknown as ") || line.trimEnd().endsWith("as unknown as")) {
+    const withoutEscapeHatch = line.replace(/\bas unknown as\b/g, "");
+    if (!withoutEscapeHatch.includes(" as "))
+      return true;
+  }
+  if (line.match(/\b(import|export)\s+.*\s+as\s+\w+/) || line.match(/\b(import|export)\s+\*\s+as\s+\w+/) || line.match(/\b(import|export)\s+type\s+.*\s+as\s+\w+/) || line.match(/^\s*\w+\s+as\s+\w+,?\s*$/) || line.match(/^\s*type\s+\w+\s+as\s+\w+,?\s*$/)) {
+    return true;
+  }
+  if (line.match(/\bas\s*[=:,]/))
+    return true;
+  if (everyAsInsideString(line))
+    return true;
+  if (isJsxText(trimmed))
+    return true;
+  if (isPlainText(trimmed))
+    return true;
+  const commentIdx = line.indexOf("//");
+  if (commentIdx >= 0 && line.indexOf(" as ", commentIdx) >= 0) {
+    const beforeComment = line.substring(0, commentIdx);
+    if (!beforeComment.includes(" as "))
+      return true;
+  }
+  if (line.match(/"\)\s+as\s+\w+"/))
+    return true;
+  if (line.includes(" satisfies "))
+    return true;
+  return false;
+}
+function everyAsInsideString(line) {
+  let searchFrom = 0;
+  while (true) {
+    const idx = line.indexOf(" as ", searchFrom);
+    if (idx < 0)
+      return true;
+    const before = line.substring(0, idx);
+    const singleQuotes = (before.match(/'/g) ?? []).length;
+    const doubleQuotes = (before.match(/"/g) ?? []).length;
+    const backticks = (before.match(/`/g) ?? []).length;
+    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {
+      return false;
+    }
+    searchFrom = idx + 4;
+  }
+}
+function isJsxText(trimmed) {
+  if (trimmed.match(/^[^{};=()]*\bas\b[^{};=()]*$/)) {
+    if (!trimmed.match(/\bas\s+[A-Z]\w*/) && !trimmed.match(/\bas\s+(string|number|boolean|any|unknown|never)\b/)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isPlainText(trimmed) {
+  const idx = trimmed.indexOf(" as ");
+  if (idx < 0)
+    return false;
+  const before = trimmed.substring(0, idx);
+  return !before.match(/[={}:;(]/) && !before.match(/\b(const|let|var|type|interface|function|return|await)\b/);
+}
+function suggestFix(line) {
+  if (line.includes("JSON.parse")) {
+    return "Use a validation function or type guard to parse and validate the result.";
+  }
+  if (line.includes("as HTMLInputElement") || line.includes("as HTMLTextAreaElement") || line.includes("as HTMLButtonElement")) {
+    return "Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }";
+  }
+  if (line.includes("as HTMLElement") || line.includes("as Element")) {
+    return "Use instanceof: if (el instanceof HTMLElement) { ... }";
+  }
+  if (line.includes(".doc()") && line.includes("as ")) {
+    return "Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.";
+  }
+  if (line.includes("Record<string, unknown>") && (line.includes("window") || line.includes("globalThis"))) {
+    return "Extract a type guard: function getGlobalProp(name: string): unknown { ... }";
+  }
+  if (line.includes("Record<string, unknown>")) {
+    return "Use a type guard function that narrows the unknown value to the target shape.";
+  }
+  if (line.includes("as PeerId") || line.includes("as DocumentId")) {
+    return "Use the library's branded-type constructor if available, or centralise the cast in a factory.";
+  }
+  if (line.includes("as string") || line.includes("as number") || line.includes("as boolean")) {
+    return "Narrow with typeof: if (typeof x === 'string') { ... }";
+  }
+  if (line.includes("as any")) {
+    return "Replace 'any' with 'unknown' and add a type guard or validation at the boundary.";
+  }
+  return;
+}
+function isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles) {
+  const segments = relative.split("/");
+  if (segments.some((s) => excludeDirs.has(s)))
+    return true;
+  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s)))
+    return true;
+  const basename = segments[segments.length - 1] ?? "";
+  return excludeFiles.has(basename) || excludeFiles.has(relative);
+}
+function findViolations(relative, content) {
+  const results = [];
+  const lines = content.split(`
+`);
+  let insideTemplate = false;
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    const backticks = (line.match(/`/g) ?? []).length;
+    const startedInTemplate = insideTemplate;
+    if (backticks % 2 === 1)
+      insideTemplate = !insideTemplate;
+    if (startedInTemplate && backticks === 0 && !line.includes("${"))
+      continue;
+    if (!isLineClean(line)) {
+      results.push({
+        file: relative,
+        line: i + 1,
+        content: line.trim(),
+        advice: suggestFix(line.trim())
+      });
+    }
+  }
+  return results;
+}
+function printViolations(violations) {
+  if (violations.length === 0) {
+    console.log("[no-as-casting] ✅ No violations found.");
+    return;
+  }
+  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:
+`);
+  for (const v of violations) {
+    console.log(`  ${v.file}:${v.line}`);
+    console.log(`    ${v.content}`);
+    if (v.advice)
+      console.log(`    \uD83D\uDCA1 ${v.advice}`);
+    console.log();
+  }
+  console.log("[no-as-casting] Use type guards, validation, or fix the types at the source.");
+  console.log('[no-as-casting] Only "as const" and "as unknown as" are allowed.');
+}
+async function checkNoAsCasting(options) {
+  const rootDir = options.rootDir;
+  const excludeDirs = new Set(options.exclude ?? ["node_modules", "dist", ".git", ".bun"]);
+  const excludePackages = new Set(options.excludePackages ?? []);
+  const excludeFiles = new Set(options.excludeFiles ?? []);
+  const pattern = options.filePatterns ?? "**/*.{ts,tsx}";
+  const glob = new Glob(pattern);
+  const violations = [];
+  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {
+    const relative = file.replace(`${rootDir}/`, "");
+    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles))
+      continue;
+    const content = readFileSync(file, "utf-8");
+    violations.push(...findViolations(relative, content));
+  }
+  return { violations, print: () => printViolations(violations) };
+}
+export {
+  suggestFix,
+  isLineClean,
+  checkNoAsCasting
+};
+
+//# debugId=8394B2630EA383EC64756E2164756E21

package/dist/tools/quality/src/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../tools/quality/src/no-as-casting.ts"],
+  "sourcesContent": [
+    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  excludePackages?: string[];\n  excludeFiles?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  // Full-line comments\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  // as const (literal narrowing)\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  // as unknown as (explicit escape hatch)\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  // Import/export renames\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  // Property declarations: as= or as: or as,\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n\n  // String literal detection: count quotes before each ` as ` occurrence.\n  // If any quote type has an odd count, the ` as ` is inside a string.\n  if (everyAsInsideString(line)) return true;\n\n  // JSX text: ` as ` between > and < with no code syntax around it\n  if (isJsxText(trimmed)) return true;\n\n  // Plain text heuristic: indented line with no code syntax characters\n  // before ` as ` — catches multiline JSX text and template literal bodies.\n  if (isPlainText(trimmed)) return true;\n\n  // Inline comment: ` as ` appears only after //\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  // SQL alias: `) as column_name`\n  if (line.match(/\"\\)\\s+as\\s+\\w+\"/)) return true;\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Returns true when every ` as ` occurrence in the line falls inside a\n * string literal (single-quoted, double-quoted, or backtick).\n */\nfunction everyAsInsideString(line: string): boolean {\n  let searchFrom = 0;\n  while (true) {\n    const idx = line.indexOf(\" as \", searchFrom);\n    if (idx < 0) return true; // no more ` as ` to check\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 0 && doubleQuotes % 2 === 0 && backticks % 2 === 0) {\n      return false; // this ` as ` is outside any string\n    }\n    searchFrom = idx + 4;\n  }\n}\n\n/**\n * Detects JSX text content — ` as ` appearing between > and < with no\n * code-like syntax around it (no braces, semicolons, equals signs).\n */\nfunction isJsxText(trimmed: string): boolean {\n  // Classic JSX text: starts after > or is plain text ending before <\n  if (trimmed.match(/^[^{};=()]*\\bas\\b[^{};=()]*$/)) {\n    // No code syntax at all — could be JSX text or template literal body.\n    // Reject if it looks like a type assertion (word ` as ` TypeName pattern\n    // where TypeName starts with uppercase, or is a known TS type).\n    if (\n      !trimmed.match(/\\bas\\s+[A-Z]\\w*/) &&\n      !trimmed.match(/\\bas\\s+(string|number|boolean|any|unknown|never)\\b/)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Heuristic for plain text in template literals or JSX: the line has no\n * code-like characters before ` as ` — no `=`, `{`, `}`, `:`, `;`, `(`.\n */\nfunction isPlainText(trimmed: string): boolean {\n  const idx = trimmed.indexOf(\" as \");\n  if (idx < 0) return false;\n  const before = trimmed.substring(0, idx);\n  // If nothing before ` as ` looks like code, it's probably prose.\n  return (\n    !before.match(/[={}:;(]/) &&\n    !before.match(/\\b(const|let|var|type|interface|function|return|await)\\b/)\n  );\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\nfunction isFileExcluded(\n  relative: string,\n  excludeDirs: Set<string>,\n  excludePackages: Set<string>,\n  excludeFiles: Set<string>\n): boolean {\n  const segments = relative.split(\"/\");\n  if (segments.some((s) => excludeDirs.has(s))) return true;\n  if (excludePackages.size > 0 && segments.some((s) => excludePackages.has(s))) return true;\n  const basename = segments[segments.length - 1] ?? \"\";\n  return excludeFiles.has(basename) || excludeFiles.has(relative);\n}\n\nfunction findViolations(relative: string, content: string): Violation[] {\n  const results: Violation[] = [];\n  const lines = content.split(\"\\n\");\n  let insideTemplate = false;\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    const backticks = (line.match(/`/g) ?? []).length;\n    const startedInTemplate = insideTemplate;\n    if (backticks % 2 === 1) insideTemplate = !insideTemplate;\n\n    // Line is entirely inside a multi-line template literal and has no\n    // interpolation — treat as string content (e.g. SQL column aliases).\n    if (startedInTemplate && backticks === 0 && !line.includes(\"${\")) continue;\n\n    if (!isLineClean(line)) {\n      results.push({\n        file: relative,\n        line: i + 1,\n        content: line.trim(),\n        advice: suggestFix(line.trim()),\n      });\n    }\n  }\n  return results;\n}\n\nfunction printViolations(violations: Violation[]): void {\n  if (violations.length === 0) {\n    console.log(\"[no-as-casting] ✅ No violations found.\");\n    return;\n  }\n  console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n  for (const v of violations) {\n    console.log(`  ${v.file}:${v.line}`);\n    console.log(`    ${v.content}`);\n    if (v.advice) console.log(`    💡 ${v.advice}`);\n    console.log();\n  }\n  console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n  console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const excludePackages = new Set(options.excludePackages ?? []);\n  const excludeFiles = new Set(options.excludeFiles ?? []);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    if (isFileExcluded(relative, excludeDirs, excludePackages, excludeFiles)) continue;\n    const content = readFileSync(file, \"utf-8\");\n    violations.push(...findViolations(relative, content));\n  }\n\n  return { violations, print: () => printViolations(violations) };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "8394B2630EA383EC64756E2164756E21",
+  "names": []
+}

package/dist/tools/quality/src/no-as-casting.d.ts

@@ -0,0 +1,44 @@
+/**
+ * No-as-casting conformance check.
+ *
+ * Bans all TypeScript type assertions (`as Type`) except the allowed
+ * patterns: `as const` (literal narrowing), `as unknown as` (explicit
+ * escape hatch), import/export renames, and `as` inside strings or
+ * comments. Violations include pattern-specific fix advice.
+ *
+ * This module exports the check logic as a library so consuming
+ * applications can import it from `@fairfox/polly/quality` and run it
+ * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a
+ * thin CLI wrapper around these exports.
+ */
+export interface Violation {
+    file: string;
+    line: number;
+    content: string;
+    advice?: string;
+}
+export interface CheckResult {
+    violations: Violation[];
+    print: () => void;
+}
+export interface CheckOptions {
+    rootDir: string;
+    exclude?: string[];
+    excludePackages?: string[];
+    excludeFiles?: string[];
+    filePatterns?: string;
+}
+/**
+ * Check whether a line contains a forbidden `as` type assertion.
+ * Returns true if the line is clean (no violation), false if it violates.
+ */
+export declare function isLineClean(line: string): boolean;
+/**
+ * Suggest a concrete fix for a specific violation pattern.
+ */
+export declare function suggestFix(line: string): string | undefined;
+/**
+ * Run the no-as-casting check against a directory. Returns a result
+ * object with the violations and a print function for CLI output.
+ */
+export declare function checkNoAsCasting(options: CheckOptions): Promise<CheckResult>;