Rebasely Beta: data may be purged

justintypescript-ultra-strict Public

JavaScript · 78 lines · 1.9 KiB · at 74947de

// Renders registry entries for `tsus explain`, docs/rules.md and the code// table in AGENTS.md. Everything here reads from rules/registry.js.import { REGISTRY, ruleFor } from "./rules/registry.js";const FIX_TEXT = {  safe: "`tsus fix` applies it (behavior is kept).",  unsafe: "`tsus fix --unsafe` applies it; review the change, it can alter behavior.",  none: "No automatic fix: the right change depends on intent.",};const indent = (text, pad = "    ") =>  text    .split("\n")    .map((l) => (l === "" ? "" : pad + l))    .join("\n");export const renderExplainText = (rule) =>  [    `${rule.code} ${rule.name}: ${rule.title}`,    "",    `  ${rule.message}`,    "",    "Why",    indent(rule.why, "  "),    "",    "Bad",    indent(rule.bad),    "",    "Good",    indent(rule.good),    "",    `Hint: ${rule.hint}`,    `Fix:  ${FIX_TEXT[rule.fix].replaceAll("`", "")}`,  ].join("\n");export const renderList = () =>  REGISTRY.map((r) => `${r.code}  ${r.name.padEnd(24)} ${r.title}`).join("\n");export const explain = (code) => ruleFor(code);const mdFence = (code) => "```ts\n" + code + "\n```";export const renderRuleMarkdown = (rule) =>  [    `## ${rule.code} ${rule.name}`,    "",    `**${rule.title}.** ${rule.why}`,    "",    "Rejected:",    "",    mdFence(rule.bad),    "",    "Accepted:",    "",    mdFence(rule.good),    "",    `Hint: ${rule.hint}`,    "",    `Fix: ${FIX_TEXT[rule.fix]}`,  ].join("\n");export const renderRulesDoc = () =>  [    "# TSUS diagnostic codes",    "",    "Generated from `packages/cli/src/rules/registry.js` by `npm run docs`. Do not edit by hand; `tsus explain <CODE>` prints the same text.",    "",    renderCodeTable(),    "",    ...REGISTRY.map(renderRuleMarkdown).flatMap((s) => [s, ""]),  ].join("\n");export const renderCodeTable = () =>  [    "| Code | Rule | Fix |",    "|---|---|---|",    ...REGISTRY.map((r) => `| ${r.code} | ${r.title} | ${r.fix} |`),  ].join("\n");