chaffjs 0.14.0 → 0.16.0

package/src/number-name.ts

@@ -1,12 +1,13 @@
+import { hyphenGroups, isHyphen } from "./orthography.ts";
 import type { Span, Token } from "./plugin.ts";
 
 /**
  * 数量ではなく名前として書かれた数（番号・識別子）。鉤括弧で引いた「3.1 リサーチの原則」の節番号、※1 のような注の番号、
- * 「〒102-0094 東京都」の郵便番号は、後ろの空白が番号と題・項目の区切りで、「3回」「3 回」のような空け方の好みではない。
+ * 「〒100-8916 東京都」の郵便番号、「紀尾井町1-3 東京ガーデンテラス」の番地は、後ろの空白が番号と題・項目の区切りで、「3回」「3 回」のような空け方の好みではない。
  * 空け方を数える材料にしない。
  *
- * 形で名前と読むのは四つだけ。0 で始まる組を含むハイフンつなぎの番号、※ や鉤括弧のすぐ後ろの番号、文頭の階層つきの節番号（2.1、3.1.2）、
- * 続き番号になった行の頭の番号（白書の注）。文頭でも「223 言語」「1ターン」は数量なので、階層の無い数は文頭というだけでは名前と読まない。
+ * 形で名前と読むのは五つだけ。0 で始まる組を含むハイフンつなぎの番号、※・〒や鉤括弧のすぐ後ろの番号、市・区・町まで下りた地名のすぐ後ろのハイフンつなぎの番号、
+ * 文頭の階層つきの節番号（2.1、3.1.2）、続き番号になった行の頭の番号（白書の注）。文頭でも「223 言語」「1ターン」は数量なので、階層の無い数は文頭というだけでは名前と読まない。
  * そのうえで、すぐ後ろ（空白 1 つまで）の語が数につく語（助数詞・数・助詞・助動詞）なら数量として数え続ける（「3-5 日」「26.7 万行」）。
  * 品詞が無ければ判断せず、名前とは読まない。
  */
@@ -14,8 +15,8 @@ import type { Span, Token } from "./plugin.ts";
 /** 数と結びついて読まれる語。助数詞は NounType=Class、数は NumType=Card で渡る。 */
 const BOUND_TO_NUMBER = new Set(["ADP", "PART", "AUX", "SCONJ", "CCONJ"]);
 
-/** 番号が立つ位置の直前: 題を包む鉤括弧、注の印。 */
-const LABEL_LEAD = /[「『【※]$/u;
+/** 番号が立つ位置の直前: 題を包む鉤括弧、注の印、郵便番号の印。 */
+const LABEL_LEAD = /[「『【※〒]$/u;
 
 /** 文頭（前に空白と箇条書きの印だけ）。 */
 const LINE_HEAD = /^[\s\-*+・•]*$/u;
@@ -28,17 +29,18 @@ const SECTION_NUMBER = /^\d+(?:\.\d+)+$/u;
  * 数え続ける。三つ以上つないだもの（073-489-5909）は、orthography.ts が境目を作る前に外している。
  */
 const isHyphenIdentifier = (digits: string): boolean => {
-  const parts = digits.split("-").filter((part) => part !== "");
+  const parts = hyphenGroups(digits);
   return parts.length > 1 && parts.some((part) => part.startsWith("0"));
 };
 
-const RUN_CHAR = /[\d.-]/u;
+const DIGIT_OR_POINT = /[\d.]/u;
+const isRunChar = (char: string | undefined): boolean => DIGIT_OR_POINT.test(char ?? "") || isHyphen(char);
 
-/** at を含む、数字・小数点・ハイフンの並び。at が並びの中に無ければ undefined。 */
+/** at を含む、数字・小数点・ハイフン（全角の「－」なども）の並び。at が並びの中に無ければ undefined。 */
 export const digitRunAround = (text: string, at: number): Span | undefined => {
-  if (!RUN_CHAR.test(text[at] ?? "")) return undefined;
-  const startAt = (index: number): number => (index > 0 && RUN_CHAR.test(text[index - 1] ?? "") ? startAt(index - 1) : index);
-  const endAt = (index: number): number => (index < text.length && RUN_CHAR.test(text[index] ?? "") ? endAt(index + 1) : index);
+  if (!isRunChar(text[at])) return undefined;
+  const startAt = (index: number): number => (index > 0 && isRunChar(text[index - 1]) ? startAt(index - 1) : index);
+  const endAt = (index: number): number => (index < text.length && isRunChar(text[index]) ? endAt(index + 1) : index);
   return { start: startAt(at), end: endAt(at) };
 };
 
@@ -71,6 +73,24 @@ export const sequenceLabelStarts = (text: string): ReadonlySet<number> => {
   return new Set(lines.flatMap((line, index) => (continues(index) ? [line.start] : [])));
 };
 
+const isGeoUnit = (token: Token): boolean => token.features?.["NameType"] === "GeoUnit";
+const isPlaceWord = (token: Token): boolean => isGeoUnit(token) || token.features?.["NameType"] === "Geo";
+
+/** end で終わる、間を空けずに続く地名と地名の単位（東京都千代田区紀尾井町）。近いほうから。 */
+export const placeChainBefore = (tokens: readonly Token[], end: number): Token[] => {
+  const last = tokens.find((token) => token.span.end === end && isPlaceWord(token));
+  return last === undefined ? [] : [last, ...placeChainBefore(tokens, last.span.start)];
+};
+
+/**
+ * 住所の番地（千代田区紀尾井町1-3、霞が関2-1）。都道府県より下の単位（市・区・町）まで下りた地名のすぐ後ろの、ハイフンつなぎの番号。
+ * 地名だけ（北海道2-3 営業日）や都道府県まで（東京都2-3 営業日）の後ろは、地域ごとの範囲のことがあるので読まない。
+ * ハイフンの無い数（千代田区23 番）も読まない。topUnits は都道府県の単位（語彙表 prefecture-unit）。
+ */
+const isAddressNumber = (text: string, run: Span, tokens: readonly Token[], base: number, topUnits: ReadonlySet<string>): boolean =>
+  [...text.slice(run.start, run.end)].some(isHyphen) &&
+  placeChainBefore(tokens, base + run.start).some((token) => isGeoUnit(token) && !topUnits.has(token.surface));
+
 /** ハイフンでつないだ識別子か、番号の立つ位置の番号か、文頭の節番号か。 */
 const isNameShaped = (text: string, run: Span): boolean => {
   const [before, digits] = [text.slice(0, run.start), text.slice(run.start, run.end)];
@@ -78,7 +98,8 @@ const isNameShaped = (text: string, run: Span): boolean => {
 };
 
 /**
- * text の run が名前として書かれた数か。tokens は文書全体の座標で、base は text の先頭の位置。sequence は sequenceLabelStarts の結果。
+ * text の run が名前として書かれた数か。tokens は文書全体の座標で、base は text の先頭の位置。sequence は sequenceLabelStarts の結果、
+ * topUnits は都道府県の単位。
  * 後ろの語が読めない（品詞が無い、語の切れ目が合わない）ときは、数量として数え続ける。
  */
 export const isNumberName = (
@@ -87,9 +108,10 @@ export const isNumberName = (
   tokens: readonly Token[] | undefined,
   base: number,
   sequence: ReadonlySet<number> = new Set(),
+  topUnits: ReadonlySet<string> = new Set(),
 ): boolean => {
   const inSequence = sequence.has(base + run.start);
-  if (tokens === undefined || !(inSequence || isNameShaped(text, run))) return false;
+  if (tokens === undefined || !(inSequence || isNameShaped(text, run) || isAddressNumber(text, run, tokens, base, topUnits))) return false;
   const next = wordAfter(tokens, text, run, base);
   if (next === undefined) return false;
   return !isBoundToNumber(next) || (inSequence && CONJUNCTIONS.has(next.pos));

package/src/orthography.ts

@@ -125,22 +125,28 @@ const isOrdinalRun = (chars: readonly string[], index: number): boolean => {
 };
 
 /**
- * 「073-489-5909」「2026-06-02」「Ⅰ-4-1-3」のように - でつないだ 3 組以上の数字は、電話番号・日付・図の番号で
+ * 「073-489-5909」「2026-06-02」「Ⅰ-4-1-3」「5－1－1」のように - でつないだ 3 組以上の数字は、電話番号・日付・図や項目の番号で
  * 数量ではない。後ろの空白は欄の区切りで、「3回」の空け方とは別のもの。両側とも数えない。
  * 2 組（「1-3ヶ月」「20-30分」）は幅のある数量なので数える。
  */
 const MIN_CODE_GROUPS = 3;
-const CODE_CHAR = /[\d-]/u;
+
+// 通達の「5－1－1」は全角の「－」でつなぐ。ハイフン「‐」やマイナス「−」も同じに読む。長音「ー」は仮名の一部なので入れない。
+const HYPHEN = /[-‐‑−－]/u;
+
+/** 数字をつなぐハイフンか。半角の - のほか、全角・和文のハイフンも。 */
+export const isHyphen = (char: string | undefined): boolean => char !== undefined && HYPHEN.test(char);
+
+/** ハイフンで区切った組（空の組は除く）。「5－1－1」は ["5", "1", "1"]。 */
+export const hyphenGroups = (text: string): string[] => text.split(HYPHEN).filter((group) => group !== "");
+
+const isCodeChar = (char: string | undefined): boolean => DIGIT.test(char ?? "") || isHyphen(char);
 
 const isCode = (chars: readonly string[], digit: number): boolean => {
   let [first, last] = [digit, digit];
-  while (first > 0 && CODE_CHAR.test(chars[first - 1] ?? "")) first -= 1;
-  while (last < chars.length - 1 && CODE_CHAR.test(chars[last + 1] ?? "")) last += 1;
-  const groups = chars
-    .slice(first, last + 1)
-    .join("")
-    .split("-");
-  return groups.filter((group) => group !== "").length >= MIN_CODE_GROUPS;
+  while (first > 0 && isCodeChar(chars[first - 1])) first -= 1;
+  while (last < chars.length - 1 && isCodeChar(chars[last + 1])) last += 1;
+  return hyphenGroups(chars.slice(first, last + 1).join("")).length >= MIN_CODE_GROUPS;
 };
 
 /** 日本語との境目にある数字が、数えない書き方（「第3条」の番地、「073-489-5909」の符号）か。 */

package/src/plain-source.ts

@@ -0,0 +1,5 @@
+/**
+ * The Markdown parser drops a leading BOM and reads a lone "\r" as a line break; the rest of chaff counts "\n" only.
+ * Reading the file this way keeps every offset, line and column on the text the writer sees.
+ */
+export const plainSource = (raw: string): string => raw.replace(/^\uFEFF/u, "").replace(/\r\n?/gu, "\n");

package/src/plugin.ts

@@ -8,7 +8,16 @@ export type Span = { readonly start: number; readonly end: number };
  * token の span は文の span と同じ座標系（segment に渡した文字列の先頭が 0）。
  * 2 つの基準を混ぜると、ずれたときに どちらが悪いか分からなくなる。
  */
-export type Sentence = { readonly span: Span; readonly text: string; readonly tokens?: readonly Token[] };
+export type Sentence = {
+  readonly span: Span;
+  readonly text: string;
+  readonly tokens?: readonly Token[];
+  /**
+   * 行の折り返しで語の途中に入った改行（前後の行頭・行末の空白ごと）。span と同じ座標系。chaff が入れる。
+   * tokens は全角どうしに挟まれた段落内の改行を除いた文字列から作るので、改行をまたぐ語の span は改行ごと覆い、surface より長い。
+   */
+  readonly wrapBreaks?: readonly Span[];
+};
 
 /**
  * 品詞は Universal Dependencies の UPOS に統一する。アダプタ独自の体系を露出させない。
@@ -133,7 +142,10 @@ export type StructurePatterns = {
   readonly numbered: (line: string, context: NumberingContext) => NumberedLine | undefined;
   /** 定義。attrs.term に定義された語。 */
   readonly definitions: (text: string) => readonly Mention[];
-  /** 参照。attrs.target に正規化した番地（"12.1"）、attrs.label に書かれたまま。 */
+  /**
+   * 参照。attrs.target に正規化した番地（"12.1"）、attrs.label に書かれたまま。他の文書を指すなら attrs.document にその名。
+   * 書き方だけでは他の文書か決まらない角括弧の語は attrs.citedTag に入れ、文書がその語を一覧に載せていれば core が他の文書とみなす。
+   */
   readonly references: (text: string) => readonly Mention[];
   /** 義務・禁止・許可。attrs.marker に語、attrs.type に must / must-not / may。 */
   readonly obligations: (text: string) => readonly Mention[];
@@ -156,6 +168,11 @@ export type StructurePatterns = {
    * 数字と点だけの通し番号は core が言語を問わず読むので、それを数量と見分けられるのは言語パッケージだけ。
    */
   readonly countedAfter?: (number: string, rest: string) => boolean;
+  /**
+   * 本文の行頭の「3.11.0 を公開しました。」の 3.11.0 は、文の中の数で通し番号ではない。番号と後ろの文字列を渡し、文の続き
+   * （日本語なら助詞で始まる）なら true。小文字で始まる続きは core が言語を問わず読む。
+   */
+  readonly continuesSentence?: (number: string, rest: string) => boolean;
   /** 数の書き方（「二十二」「3」）を数にする。相対の参照の「前二項」「前条第二項」が使う。 */
   readonly number?: (text: string) => number | undefined;
 };
@@ -291,10 +308,14 @@ export type ProseDocument = {
   readonly paragraphs: readonly Paragraph[];
   /** 箇条書き 1 つ。項目の数と長さのばらつきを見る rule が使う。 */
   readonly lists: readonly BulletList[];
+  /** リンク（`[text](url)`、`<https://…>`、`[text][ref]`）の範囲。行き先が相対パスでもページ内でも、読み手が辿れる出典。 */
+  readonly links: readonly Span[];
   /** アダプタが持つ語彙表と、チームが chaff.yaml に足した語彙表。detector は出所を知らない。 */
   readonly lexicons: Readonly<Record<string, Lexicon>>;
   /** この種類の文書に無いと困る見出し。チームが chaff.yaml で決める。 */
   readonly requiredSections: readonly string[];
+  /** チームが chaff.yaml の names に並べた固有名詞。1 つの名前として読み、書き手の落ち度に数えない。 */
+  readonly names?: readonly string[];
   /** 番地の付いた木（§27）。adapter が structure を持たない言語では無い。 */
   readonly structure: StructureNode | undefined;
   /** 文書の種類（法令など）。選ばれなければ無い。 */
@@ -314,6 +335,8 @@ export type Finding = {
   readonly quote: string;
   /** message のプレースホルダに入れる値。 */
   readonly values: Readonly<Record<string, string | number>>;
+  /** 1 つの rule が 2 通りの見つけ方を持つとき、どちらで見つけたか。rule の messages から文を選ぶ。無ければ message。 */
+  readonly variant?: string;
 };
 
 /** rule 定義が threshold を渡す。数値は 4 語から解決済み。 */
@@ -341,6 +364,8 @@ export type RuleDefinition = {
   readonly why: Localized;
   readonly how_to_fix: Localized;
   readonly message: Localized;
+  /** 見つけ方ごとの message（Finding の variant で引く）。ほとんどの rule は持たない。 */
+  readonly messages: Readonly<Record<string, Localized>>;
   /** 4 語と数値の対応。2 つ以上。未定義の段は normal に落ちる。spec §18.1。
    *  言語別の閾値を持つ rule（max-sentence-length）は、読み込み時に言語で平坦化済み。 */
   readonly levels: LevelTable;

package/src/profile/check.ts

@@ -0,0 +1,34 @@
+import { NO_PROFILE } from "./select.ts";
+
+/** Where a profile was set: chaff.yaml's profile, or one of its by_path entries. */
+export type ProfileSetting = "config" | "by_path";
+
+type UnknownProfile = {
+  readonly where: ProfileSetting;
+  readonly profile: string;
+  /** The by_path entry's files, so the message can say which entry; empty for chaff.yaml's profile. */
+  readonly files: readonly string[];
+};
+
+type PathProfile = { readonly files: readonly string[]; readonly profile?: string | undefined };
+
+type WrittenProfiles = { readonly config: string | undefined; readonly byPath: readonly PathProfile[] };
+
+/** Commands that never read a document, so never choose a profile. A wrong one in chaff.yaml must not stop them. */
+const PROFILE_FREE: ReadonlySet<string> = new Set(["init", "genres", "skill", "relax", "strict", "off", "rules", "explain"]);
+
+/** The profiles a command would read from chaff.yaml: none for a command that reads no document. */
+export const writtenProfiles = (command: string, config: { readonly profile: string | undefined; readonly byPath: readonly PathProfile[] }): WrittenProfiles =>
+  PROFILE_FREE.has(command) ? { config: undefined, byPath: [] } : { config: config.profile, byPath: config.byPath };
+
+const setting = (where: ProfileSetting, profile: string | undefined, files: readonly string[] = []): UnknownProfile[] =>
+  profile === undefined ? [] : [{ where, profile, files }];
+
+/**
+ * Every profile a setting names that is neither a bundled one nor none. Such a name chooses nothing and also stops the choice from the content,
+ * so it silently acts as none. All of them, not only the one a file would use, because a wrong setting is wrong for every file.
+ */
+export const unknownProfiles = (written: WrittenProfiles, known: readonly string[]): UnknownProfile[] =>
+  [...setting("config", written.config), ...written.byPath.flatMap((entry) => setting("by_path", entry.profile, entry.files))].filter(
+    (entry) => entry.profile !== NO_PROFILE && !known.includes(entry.profile),
+  );

package/src/profile/for-file.ts

@@ -1,11 +1,18 @@
 import { applyByPath } from "../config/by-path.ts";
 import type { Config } from "../config/load.ts";
 import type { DocumentProfile } from "../plugin.ts";
+import { presetProfile } from "../genre-load.ts";
 import { loadProfiles } from "./load.ts";
 import { chooseProfile } from "./select.ts";
 
 type ProfileSettings = Pick<Config, "profile" | "byPath" | "baseDir">;
 
-/** 1 ファイルの文書の種類。by_path、chaff.yaml、内容の順に選ぶ。 */
-export const profileFor = (config: ProfileSettings, path: string, source: string, language: string): DocumentProfile | undefined =>
-  chooseProfile(loadProfiles(), { byPath: applyByPath(config.byPath, config.baseDir, path).profile, config: config.profile, source, language })?.profile;
+/** 1 ファイルの文書の種類。by_path、chaff.yaml、ジャンル、内容の順に選ぶ。 */
+export const profileFor = (config: ProfileSettings, path: string, source: string, language: string, genre?: string): DocumentProfile | undefined =>
+  chooseProfile(loadProfiles(), {
+    byPath: applyByPath(config.byPath, config.baseDir, path).profile,
+    config: config.profile,
+    genre: genre === undefined ? undefined : presetProfile(genre),
+    source,
+    language,
+  })?.profile;

package/src/profile/load.ts

@@ -12,7 +12,7 @@ const loaded: { value: readonly ProfileDefinition[] | undefined } = { value: und
 export const loadProfiles = (): readonly ProfileDefinition[] => {
   loaded.value ??= readdirSync(PROFILES_DIR)
     .filter((file) => file.endsWith(".yaml"))
-    .sort((left, right) => left.localeCompare(right))
+    .toSorted((left, right) => left.localeCompare(right))
     .flatMap((file) => {
       const path = join(PROFILES_DIR, file);
       try {

package/src/profile/select.ts

@@ -4,13 +4,15 @@ import { detected, type ProfileDefinition } from "./parse.ts";
 /** 設定で書いた「使わない」。内容から選ぶのも止める。 */
 export const NO_PROFILE = "none";
 
-type ProfileSource = "by-path" | "config" | "content";
+type ProfileSource = "by-path" | "config" | "genre" | "content";
 
 export type ChosenProfile = { readonly profile: DocumentProfile; readonly from: ProfileSource };
 
 export type ProfileRequest = {
   readonly byPath: string | undefined;
   readonly config: string | undefined;
+  /** The profile the file's genre reads with (genres.yaml), when it names one. */
+  readonly genre?: string | undefined;
   readonly source: string;
   readonly language: string;
 };
@@ -18,16 +20,21 @@ export type ProfileRequest = {
 const named = (definitions: readonly ProfileDefinition[], id: string, language: string): DocumentProfile | undefined =>
   definitions.find((definition) => definition.id === id)?.languages[language];
 
+const writtenIn = (request: ProfileRequest): ProfileSource => {
+  if (request.byPath !== undefined) return "by-path";
+  return request.config === undefined ? "genre" : "config";
+};
+
 /**
- * 強いものから: by_path、chaff.yaml の profile、内容。どれかが none と書けばそこで止め、内容からも選ばない。
+ * 強いものから: by_path、chaff.yaml の profile、ジャンルの profile、内容。どれかが none と書けばそこで止め、内容からも選ばない。
  * 名前で選んだ種類にその言語の中身が無ければ選ばない。黙って別の種類にしない。
  */
 export const chooseProfile = (definitions: readonly ProfileDefinition[], request: ProfileRequest): ChosenProfile | undefined => {
-  const written = request.byPath ?? request.config;
+  const written = request.byPath ?? request.config ?? request.genre;
   if (written === NO_PROFILE) return undefined;
   if (written !== undefined) {
     const profile = named(definitions, written, request.language);
-    return profile === undefined ? undefined : { profile, from: request.byPath === undefined ? "config" : "by-path" };
+    return profile === undefined ? undefined : { profile, from: writtenIn(request) };
   }
   const found = definitions.find((definition) => detected(definition, request.source, request.language));
   const profile = found?.languages[request.language];

package/src/quoted-span.ts

@@ -0,0 +1,39 @@
+import type { Sentence, Span } from "./plugin.ts";
+
+/** 開きの字と、それを閉じる字。 */
+type Marks = Readonly<Record<string, string>>;
+
+/** 鉤括弧。日本語の引用と題名。 */
+export const KAGI_MARKS: Marks = { "「": "」", "『": "』" };
+
+/**
+ * 引用符も含めた、人の言葉を引く印。英語の "…" は開きと閉じが同じ字なので、開いている間に来たら閉じと読む。
+ * 一重の ’ は "don’t" の省略の印と見分けられないので入れない。
+ */
+export const QUOTATION_MARKS: Marks = { ...KAGI_MARKS, "“": "”", '"': '"' };
+
+type Open = { readonly closer: string; readonly at: number };
+type Scan = { readonly open: readonly Open[]; readonly spans: readonly Span[] };
+
+const step =
+  (marks: Marks) =>
+  (scan: Scan, char: string, at: number): Scan => {
+    const last = scan.open.at(-1);
+    if (last !== undefined && last.closer === char) return { open: scan.open.slice(0, -1), spans: [...scan.spans, { start: last.at + 1, end: at }] };
+    const closer = marks[char];
+    return closer === undefined ? scan : { open: [...scan.open, { closer, at }], spans: scan.spans };
+  };
+
+/**
+ * 引いたものの中身の位置（既定は鉤括弧「」『』）。括弧そのものは含まない。入れ子はそれぞれを返す。
+ * 閉じない括弧と、開きと組にならない閉じ括弧は中身を作らない。位置は text の先頭を 0 とする。
+ * 括弧は BMP の字なので、UTF-16 の 1 単位ずつ見れば位置がそのまま使える。
+ */
+export const quotedSpans = (text: string, marks: Marks = KAGI_MARKS): Span[] => [...text.split("").reduce<Scan>(step(marks), { open: [], spans: [] }).spans];
+
+/** 文の中の、引いたものを括弧ごと、文書全体の座標で。 */
+export const quotedIn = (sentence: Sentence, marks: Marks = KAGI_MARKS): Span[] =>
+  quotedSpans(sentence.text, marks).map((span) => ({ start: sentence.span.start + span.start - 1, end: sentence.span.start + span.end + 1 }));
+
+/** inner が、spans のどれかにまるごと入っているか。 */
+export const isWithinAny = (spans: readonly Span[], inner: Span): boolean => spans.some((span) => inner.start >= span.start && inner.end <= span.end);

package/src/reasons.ts

@@ -1,4 +1,5 @@
 import type { Texts } from "./ui.ts";
+import { formFor } from "./render/plural.ts";
 
 /** Why a rule did not run, in the document's language. Listed under the findings so "0 findings" is never a silent pass. */
 export type Reasons = {
@@ -8,6 +9,7 @@ export type Reasons = {
   readonly semantic: string;
   readonly experimental: string;
   readonly turnedOff: string;
+  readonly presetOff: (genre: string) => string;
   readonly noStructure: (language: string) => string;
   readonly unreadStructure: (clauses: number, units: number) => string;
   readonly noDetector: (name: string) => string;
@@ -27,6 +29,7 @@ export const REASONS: Texts<Reasons> = {
     semantic: "意味を読む検査のため（npx chaff test で動きます）",
     experimental: "まだ試験中のため",
     turnedOff: "設定で止めているため",
+    presetOff: (genre) => `ジャンル ${genre} では見ないため`,
     noStructure: (language) => `${language} のパッケージは文書の構造を読めないため`,
     unreadStructure: (clauses, units) =>
       `条項の番号が本文に ${String(clauses)} 個あるのに、番号として読めたのは ${String(units)} 個のため（深い字下げや、行が本文につながった文書）`,
@@ -40,9 +43,10 @@ export const REASONS: Texts<Reasons> = {
     semantic: "it reads meaning; npx chaff test runs it",
     experimental: "still experimental",
     turnedOff: "turned off in the settings",
+    presetOff: (genre) => `the ${genre} genre does not check it`,
     noStructure: (language) => `the ${language} package cannot read a document's structure`,
     unreadStructure: (clauses, units) =>
-      `the text has ${String(clauses)} clause numbers but only ${String(units)} were read as numbered lines (deep indents, or lines run into the text)`,
+      `the text has ${String(clauses)} clause numbers but only ${String(units)} ${formFor(units, "was read as a numbered line", "were read as numbered lines")} (deep indents, or lines run into the text)`,
     noDetector: (name) => `no detector named ${name}`,
     noLexicon: (language, list) => `the ${language} package has no word list ${list}`,
   },

package/src/render/compact.ts

@@ -1,11 +1,9 @@
 import type { RuleDefinition } from "../plugin.ts";
 import type { RunResult } from "../run.ts";
 import { messageOf } from "./text.ts";
+import { counted } from "./plural.ts";
 import { uiLanguageOf, type Texts } from "../ui.ts";
 
-/** 「1 finding」「2 findings」。 */
-const counted = (count: number, noun: string): string => `${String(count)} ${noun}${count === 1 ? "" : "s"}`;
-
 /**
  * 最後の集計の行は、画面のほかの部分と同じく文書の言語で出す。行ごとの重さ（warning / error）は、grep や別の道具が読むので英語のまま。
  */

package/src/render/eval.ts

@@ -1,62 +1,126 @@
-import { MIN_CORPUS, TARGET_HIT_RATE, type RuleReport } from "../eval.ts";
+import { MIN_CORPUS, TARGET_HIT_RATE, type Point, type RuleReport } from "../eval.ts";
+import type { Texts, UiLanguage } from "../ui.ts";
+import { counted, formFor } from "./plural.ts";
 
 const pct = (part: number, whole: number): string => `${((part / Math.max(1, whole)) * 100).toFixed(1)}%`;
 
-const mark = (report: RuleReport, limit: number): string => {
-  if (limit === report.current && limit === report.recommended) return "  ← 現在 / 推奨";
-  if (limit === report.current) return "  ← 現在";
-  if (limit === report.recommended) return "  ← 推奨";
+const TARGET = TARGET_HIT_RATE * 100;
+
+/** In the English hint, a rule's line sits one YAML level under `rules:`. */
+const EN_CONFIG_LEAD = "    In chaff.yaml:  ";
+const YAML_INDENT = 2;
+
+const TEXT: Texts<{
+  readonly current: string;
+  readonly recommended: string;
+  readonly both: string;
+  readonly point: (point: Point, share: string) => string;
+  readonly fits: string;
+  readonly nothingFits: string;
+  readonly over: (share: string) => string;
+  readonly recommend: (limit: number) => string;
+  readonly toConfig: (rule: string, limit: number) => string;
+  readonly measured: (paths: number, rules: number) => string;
+  readonly premise: readonly string[];
+  readonly smallCorpus: (total: number) => readonly string[];
+  readonly untouched: string;
+}> = {
+  ja: {
+    current: "  ← 現在",
+    recommended: "  ← 推奨",
+    both: "  ← 現在 / 推奨",
+    point: (point, share) =>
+      `${String(point.documents).padStart(3)} 文書 (${share.padStart(6)})   指摘 ${String(point.findings).padStart(3)} 件   1万字あたり ${point.per10k.toFixed(1)}`,
+    fits: `    いまの閾値で目標（${TARGET}% 未満）を満たしています。`,
+    nothingFits: `    どの閾値でも目標を満たしません。この corpus に対して rule 自体が合っていない可能性があります。`,
+    over: (share) => `    いまの閾値では ${share} の文書が該当し、目標（${TARGET}% 未満）を超えています。`,
+    recommend: (limit) => `    推奨: ${limit}`,
+    toConfig: (rule, limit) => `    chaff.yaml に書くなら:  rules:\n                              ${rule}: ${limit}`,
+    measured: (paths, rules) => `  ${paths} ファイルを corpus として ${rules} 本の rule を測りました。`,
+    premise: [
+      "  ここにある文書は「人間が書いて公開した良い文書」として扱っています。",
+      `  そこで多く発火する rule は、閾値が現実に合っていない疑いがあります（目標: ${TARGET}% 未満）。`,
+    ],
+    smallCorpus: (total) => [
+      `  ※ corpus が ${total} 文書しかありません。${TARGET}% を表すには ${MIN_CORPUS} 文書以上が要ります。`,
+      "     いまは割合が「0 か全部」に振れるので、右端の密度（1万字あたりの指摘数）のほうを見てください。",
+    ],
+    untouched: `  閾値は自動で書き換えていません。corpus が変われば答えも変わるためです。`,
+  },
+  en: {
+    current: "  ← current",
+    recommended: "  ← recommended",
+    both: "  ← current / recommended",
+    point: (point, share) =>
+      `${String(point.documents).padStart(3)} ${formFor(point.documents, "doc ", "docs")} (${share.padStart(6)})   ${String(point.findings).padStart(3)} ${formFor(point.findings, "finding ", "findings")}   ${point.per10k.toFixed(1)} per 10,000 characters`,
+    fits: `    The current limit meets the target (under ${TARGET}%).`,
+    nothingFits: "    No limit meets the target. The rule itself may not suit this corpus.",
+    over: (share) => `    At the current limit ${share} of the documents are hit, over the target (under ${TARGET}%).`,
+    recommend: (limit) => `    Recommended: ${limit}`,
+    toConfig: (rule, limit) => `${EN_CONFIG_LEAD}rules:\n${" ".repeat(EN_CONFIG_LEAD.length + YAML_INDENT)}${rule}: ${limit}`,
+    measured: (paths, rules) => `  Measured ${counted(rules, "rule")} on ${counted(paths, "file")} as a corpus.`,
+    premise: [
+      "  The documents here are taken as good documents that people wrote and published.",
+      `  A rule that fires often on them may have a limit that does not fit real writing (target: under ${TARGET}%).`,
+    ],
+    smallCorpus: (total) => [
+      `  Note: the corpus has only ${counted(total, "document")}. Showing ${TARGET}% takes at least ${MIN_CORPUS}.`,
+      "     For now each share is either 0 or all, so read the density on the right (findings per 10,000 characters).",
+    ],
+    untouched: "  No limit was changed. A different corpus gives a different answer.",
+  },
+};
+
+type EvalText = (typeof TEXT)[UiLanguage];
+
+const mark = (report: RuleReport, limit: number, text: EvalText): string => {
+  if (limit === report.current && limit === report.recommended) return text.both;
+  if (limit === report.current) return text.current;
+  if (limit === report.recommended) return text.recommended;
   return "";
 };
 
-const sweepLines = (report: RuleReport): string[] =>
-  report.sweep.map((point) => {
-    const limit = String(point.limit).padStart(6);
-    const docs = `${String(point.documents).padStart(3)} 文書`;
-    const density = `1万字あたり ${point.per10k.toFixed(1)}`;
-    return `    ${limit}   ${docs} (${pct(point.documents, report.total).padStart(6)})   指摘 ${String(point.findings).padStart(3)} 件   ${density}${mark(report, point.limit)}`;
-  });
+const sweepLines = (report: RuleReport, text: EvalText): string[] =>
+  report.sweep.map(
+    (point) => `    ${String(point.limit).padStart(6)}   ${text.point(point, pct(point.documents, report.total))}${mark(report, point.limit, text)}`,
+  );
 
-const verdict = (report: RuleReport): string[] => {
+const verdict = (report: RuleReport, text: EvalText): string[] => {
   const now = report.sweep.find((point) => point.limit === report.current);
   const rate = now === undefined ? 0 : now.documents / Math.max(1, report.total);
-  if (rate <= TARGET_HIT_RATE) return [`    いまの閾値で目標（${TARGET_HIT_RATE * 100}% 未満）を満たしています。`];
-  if (report.recommended === undefined) {
-    return [`    どの閾値でも目標を満たしません。この corpus に対して rule 自体が合っていない可能性があります。`];
-  }
-  return [
-    `    いまの閾値では ${pct(now?.documents ?? 0, report.total)} の文書が該当し、目標（${TARGET_HIT_RATE * 100}% 未満）を超えています。`,
-    `    推奨: ${report.recommended}`,
-    "",
-    `    chaff.yaml に書くなら:  rules:\n                              ${report.rule}: ${report.recommended}`,
-  ];
+  if (rate <= TARGET_HIT_RATE) return [text.fits];
+  if (report.recommended === undefined) return [text.nothingFits];
+  return [text.over(pct(now?.documents ?? 0, report.total)), text.recommend(report.recommended), "", text.toConfig(report.rule, report.recommended)];
 };
 
-const block = (report: RuleReport): string[] => ["", `  ${report.name}   (${report.rule})`, "", ...sweepLines(report), "", ...verdict(report), ""];
+const block = (report: RuleReport, text: EvalText): string[] => [
+  "",
+  `  ${report.name}   (${report.rule})`,
+  "",
+  ...sweepLines(report, text),
+  "",
+  ...verdict(report, text),
+  "",
+];
 
 /**
  * 閾値は自動で書き換えない。提示して選ばせる。
  * 較正は corpus に対する答えであって、正解ではないため。
  */
-export const renderEval = (reports: readonly RuleReport[], total: number, paths: number): string =>
-  [
+export const renderEval = (reports: readonly RuleReport[], total: number, paths: number, ui: UiLanguage): string => {
+  const text = TEXT[ui];
+  return [
     "",
-    `  ${paths} ファイルを corpus として ${reports.length} 本の rule を測りました。`,
+    text.measured(paths, reports.length),
     "",
-    "  ここにある文書は「人間が書いて公開した良い文書」として扱っています。",
-    `  そこで多く発火する rule は、閾値が現実に合っていない疑いがあります（目標: ${TARGET_HIT_RATE * 100}% 未満）。`,
-    ...(total < MIN_CORPUS
-      ? [
-          "",
-          `  ※ corpus が ${total} 文書しかありません。${TARGET_HIT_RATE * 100}% を表すには ${MIN_CORPUS} 文書以上が要ります。`,
-          "     いまは割合が「0 か全部」に振れるので、右端の密度（1万字あたりの指摘数）のほうを見てください。",
-        ]
-      : []),
-    ...reports.flatMap(block),
+    ...text.premise,
+    ...(total < MIN_CORPUS ? ["", ...text.smallCorpus(total)] : []),
+    ...reports.flatMap((report) => block(report, text)),
     "  " + "─".repeat(58),
     "",
-    `  閾値は自動で書き換えていません。corpus が変われば答えも変わるためです。`,
+    text.untouched,
     "",
   ]
     .join("\n")
     .replace(/\{total\}/gu, String(total));
+};