chaffjs 0.29.0 → 0.31.0

package/rules/name-variant.yaml

@@ -21,6 +21,9 @@ messages:
   spelling:
     ja: 「{name}」は、ほかの所では「{usual}」と書いています（字の大小・幅・記号の違い）
     en: '"{name}" is written "{usual}" elsewhere in the document (case, width or punctuation)'
+  kana:
+    ja: 「{name}」は、ほかの所では「{usual}」と書いています（名前の中の、同じ音を書く字の違い。ヶ と ケ など）
+    en: '"{name}" is written "{usual}" elsewhere in the document (the same sound written with another character inside the name)'
   reading:
     ja: 「{name}」は、ほかの所では同じ読みの「{usual}」と書いています
     en: '"{name}" is written "{usual}", read the same, elsewhere in the document'
@@ -30,6 +33,9 @@ messages:
   near:
     ja: 「{name}」は、ほかの所で何度も書いた「{usual}」と一字違いです
     en: '"{name}" is one letter away from "{usual}", which the document uses more than once'
+  surname:
+    ja: 「{name}」は、ほかの所で何度も書いた「{usual}」と名が同じで、姓が数字だけ違います
+    en: '"{name}" has the given name of "{usual}", which the document uses more than once, and a surname a few letters away'
   place-word:
     ja: 「{name}」は、ほかの所では場所の語を別の形にして「{usual}」と書いています
     en: '"{name}" is written "{usual}", with the place word in another form, elsewhere in the document'
@@ -39,9 +45,15 @@ messages:
   company-position:
     ja: 「{name}」は、ほかの所では会社の種類を名前の反対側に置いて「{usual}」と書いています
     en: '"{name}" is written "{usual}", with the company form on the other side, elsewhere in the document'
+  order:
+    ja: 「{name}」は、ほかの所では語の順を入れ替えた「{usual}」と書いています
+    en: '"{name}" is written "{usual}", with the words in another order, elsewhere in the document'
   company-near:
     ja: 「{name}」は、ほかの所で書いた会社名「{usual}」と一字違いです
     en: '"{name}" is one letter away from the company name "{usual}" written elsewhere in the document'
+  model-code:
+    ja: 「{name}」は、ほかの所ではハイフン・空白・字の大小を変えて「{usual}」と書いています
+    en: '"{name}" is written "{usual}", with other hyphens, spaces or case, elsewhere in the document'
 
 how_to_fix:
   ja: 正しい形を確かめ、一つに揃えてください。本当に別の人や会社なら、そのままで構いません。
@@ -76,8 +88,8 @@ example:
       The code lives on GitHub. Reviews happen on GitHub, and releases are tagged on GitHub.
 
 not_flagged:
-  ja: 品詞解析が固有名詞と読んだ語だけを見ます。大文字だけの名前（ACME INC、NASA）は見ません。一字違いの英字の名前は、6 字以上で、多いほうが二度以上、少ないほうが一度だけのときに限ります（Iran と Iraq は別の名前）。人の名前どうしは、字体の違う同じ字（斎藤 と 斉藤、渡辺 と 渡邊）か、読みが同じで一字だけ違い、多いほうが二度以上、少ないほうが一度だけのとき（松本 と 松元）に限ります（伊藤 と 伊東 は別の人のことがある）。人の名前とは、品詞解析が人名と読んだ語か、「様」「さん」「氏」の付いた名前です（解析器が名前と読めない字体の字を含む名前は、敬称の前の 2〜4 字の漢字を名前と読みます）。敬称の無い名前も、前後に漢字が続かない 2〜4 字の漢字で、片方の書き方に「担当の」「私、」などの前置きか敬称が付き、もう片方が「です」「が」「までご連絡」などの前にあれば比べます（担当の斎藤です と 斉藤までご連絡ください）。地名にも同じ組がある（鹿島 と 鹿嶋）ので、どちらにも前置きも敬称も無いときは比べません。会社の名前は、語彙表の会社の種類の語（株式会社、(株)、有限会社）の隣にあるものを、品詞と関係なく比べます。名前が同じで種類の語が違うもの（株式会社 と 有限会社）、種類の語を名前の反対側に置いたもの（株式会社アオバ と アオバ株式会社）、記号・幅だけが違うものを指します。同じ種類の語の略した形（株式会社 と (株)）、種類の語を省いた呼び名（アオバシステム、以下「アオバ」）は指しません。名前の一字違いは、7 字以上の名前で、違う字が漢字でないときに限ります（日本電気 と 日本電機 は別の会社のことがある）。漢字だけの名前は、品詞解析が固有名詞と読んだときだけ会社の名前と見ます（清算株式会社、当該株式会社）。場所の名前は、語彙表の場所の語（口、駅、センター、ホール）で終わる名前を、品詞と関係なく比べます。記号・幅だけが違うもの（コンベンションセンター と コンベンション・センター）を指し、名前の読みが同じかかなで書いた読みのもの（筑紫口 と ちくし口）と、固有名詞の字の一字違い（八重洲中央口 と 八重州中央口）は、多いほうが二度以上、少ないほうが一度だけのときに限ります。方角や数字の違い（北口 と 南口、第1会議室 と 第2会議室）は別の所なので指しません。
-  en: Only words the tagger reads as proper nouns are checked. Names in capitals only (ACME INC, NASA) are left out. Names one letter apart are reported only when six letters or longer, with the usual form used at least twice and the other once (Iran and Iraq are different names). Two Japanese person names are compared only when written with another form of the same character (斎藤 and 斉藤), or read the same with one character different, the usual form used at least twice and the other once (松本 and 松元); 伊藤 and 伊東 can be two people. A person's name is one the tagger reads as such, or one followed by 様, さん or 氏 (when a name holds a character form the tagger cannot read, the two to four kanji before the honorific are taken as the name). A name without an honorific is compared too when it is two to four kanji standing alone, one form has a lead such as 担当の or 私、 or an honorific, and the other stands before a word such as です, が or までご連絡 (担当の斎藤です and 斉藤までご連絡ください). Places have such pairs as well (鹿島 and 鹿嶋), so two forms with neither a lead nor an honorific are not compared. A company name is one next to a company form from the lexicon (Inc., Ltd., Co., Ltd., LLC), whatever the tagger reads it as. The same name with forms of two kinds (Inc. and Ltd.), and the same name written with other punctuation or width, are reported. The short and long spelling of one form (Inc and Incorporated) and a name written without its form (Aoba Systems, the "Company") are not. Two names one letter apart are reported only when seven letters or longer, with the same form, and the letter is not a kanji. A place name is one ending in a place word from the lexicon (Street, St., Avenue, Station, Center), whatever the tagger reads it as. The same place written with other punctuation (King's Cross and Kings Cross) or with the place word short and long (11th Street and 11th St.) is reported; a place whose name is one letter away (Union Station and Unoin Station) only when the usual form is used at least twice and the other once. Other numbers and other names (1st Street and 2nd Street, North Hall and South Hall) are different places.
+  ja: 品詞解析が固有名詞と読んだ語だけを見ます。大文字だけの名前（ACME INC、NASA）は見ません。一字違いの英字の名前は、6 字以上で、多いほうが二度以上、少ないほうが一度だけのときに限ります（Iran と Iraq は別の名前）。人の名前どうしは、字体の違う同じ字（斎藤 と 斉藤、渡辺 と 渡邊）か、読みが同じで一字だけ違い、多いほうが二度以上、少ないほうが一度だけのとき（松本 と 松元）に限ります（伊藤 と 伊東 は別の人のことがある）。人の名前とは、品詞解析が人名と読んだ語か、「様」「さん」「氏」の付いた名前です（解析器が名前と読めない字体の字を含む名前は、敬称の前の 2〜4 字の漢字を名前と読みます）。敬称の無い名前も、前後に漢字が続かない 2〜4 字の漢字で、片方の書き方に「担当の」「私、」などの前置きか敬称が付き、もう片方が「です」「が」「までご連絡」などの前にあれば比べます（担当の斎藤です と 斉藤までご連絡ください）。地名にも同じ組がある（鹿島 と 鹿嶋）ので、どちらにも前置きも敬称も無いときは比べません。会社の名前は、語彙表の会社の種類の語（株式会社、(株)、有限会社）の隣にあるものを、品詞と関係なく比べます。名前が同じで種類の語が違うもの（株式会社 と 有限会社）、種類の語を名前の反対側に置いたもの（株式会社アオバ と アオバ株式会社）、記号・幅だけが違うものを指します。同じ種類の語の略した形（株式会社 と (株)）、種類の語を省いた呼び名（アオバシステム、以下「アオバ」）は指しません。名前の一字違いは、7 字以上の名前で、違う字が漢字でないときに限ります（日本電気 と 日本電機 は別の会社のことがある）。漢字だけの名前は、品詞解析が固有名詞と読んだときだけ会社の名前と見ます（清算株式会社、当該株式会社）。場所の名前は、語彙表の場所の語（口、駅、センター、ホール）で終わる名前を、品詞と関係なく比べます。記号・幅だけが違うもの（コンベンションセンター と コンベンション・センター）を指し、名前の読みが同じかかなで書いた読みのもの（筑紫口 と ちくし口）と、固有名詞の字の一字違い（八重洲中央口 と 八重州中央口）は、多いほうが二度以上、少ないほうが一度だけのときに限ります。方角や数字の違い（北口 と 南口、第1会議室 と 第2会議室）は別の所なので指しません。表の升は升ごとに品詞解析し、名前の形をした升（空白を挟んだ二つか三つの漢字・カタカナの語）を本文の名前と比べます。記号・幅だけの違い（佐々木 美穂 と 佐々木　美穂）と、本文と同じく読みが同じで一語だけ違うもの（佐々木 美穂 と 佐々木 美保）を指し、後者は本文の形が二度以上、升の形が一度だけのときに限ります。読みの違う一字違い（佐藤 太郎 と 佐藤 次郎）は別の人のことが多いので指しません（英字の名前は一字違いも指します）。場所の名前は表の升の中のものも比べます。英字の人の名前は、名が同じで、7 字以上の姓の頭 4 字以上がそろい、あいだの 2 字（長いほうは 3 字）までだけ違うもの（Rachel Whitford と Rachel Whitfield）も、多いほうが二度以上、少ないほうが一度だけのときに指します。語の順を入れ替えた名前（統計学基礎 と 基礎統計学）は、同じ語（形態素）を違う順に並べ、どちらも他方を含まず、どちらかが括弧の中か「前提科目：」のような欄の後ろか表の升まるごとに書いた名前のときだけ指します（統計学基礎 と 統計学応用 は別の名前）。一語の名前の中で同じ音を書く字（桜ヶ丘・桜ケ丘、霞ヶ関・霞が関）は、漢字に挟まれたときだけ同じ字と見ます。品詞解析が一語と読まない書き方（桜・が・丘）は見ません。字を抜いた形（桜丘）や、違う漢字の名前（桜ヶ岡）は別の名前です。この違いだけは、表の升の中の名前とも比べます。型番（英大文字と数字を合わせた 4 字以上の語）は、文書の題か、語彙表の型番の欄の語（型番、品番、型式）の後ろに書いたものだけを文書の型番と読み、文書の中に二度以上出てくるとき、ハイフン・空白・字の大小・幅だけを変えた形（KM-SP300 と KM-SP-300、KMSP300、km-sp300）を指します。字や数の違う型番（KM-SP300 と KM-SP310、比べる表の兄弟機種、部品表の品番）は別の型番なので指しません。英小文字を含む語（iOS17）、版（v1.2 と v1.20）、より長い型番・URL・パス・ファイル名の一部（KM-SP300-B、km-sp300.pdf）は型番と読みません。空白で区切って書く規格の番号（JIS C 8714）は一つの語でないので、題や欄に書いても型番と読みません。
+  en: Only words the tagger reads as proper nouns are checked. Names in capitals only (ACME INC, NASA) are left out. Names one letter apart are reported only when six letters or longer, with the usual form used at least twice and the other once (Iran and Iraq are different names). Two Japanese person names are compared only when written with another form of the same character (斎藤 and 斉藤), or read the same with one character different, the usual form used at least twice and the other once (松本 and 松元); 伊藤 and 伊東 can be two people. A person's name is one the tagger reads as such, or one followed by 様, さん or 氏 (when a name holds a character form the tagger cannot read, the two to four kanji before the honorific are taken as the name). A name without an honorific is compared too when it is two to four kanji standing alone, one form has a lead such as 担当の or 私、 or an honorific, and the other stands before a word such as です, が or までご連絡 (担当の斎藤です and 斉藤までご連絡ください). Places have such pairs as well (鹿島 and 鹿嶋), so two forms with neither a lead nor an honorific are not compared. A company name is one next to a company form from the lexicon (Inc., Ltd., Co., Ltd., LLC), whatever the tagger reads it as. The same name with forms of two kinds (Inc. and Ltd.), and the same name written with other punctuation or width, are reported. The short and long spelling of one form (Inc and Incorporated) and a name written without its form (Aoba Systems, the "Company") are not. Two names one letter apart are reported only when seven letters or longer, with the same form, and the letter is not a kanji. A place name is one ending in a place word from the lexicon (Street, St., Avenue, Station, Center), whatever the tagger reads it as. The same place written with other punctuation (King's Cross and Kings Cross) or with the place word short and long (11th Street and 11th St.) is reported; a place whose name is one letter away (Union Station and Unoin Station) only when the usual form is used at least twice and the other once. Other numbers and other names (1st Street and 2nd Street, North Hall and South Hall) are different places. Table cells are tagged cell by cell, and a cell holding only a name (two to four capitalised words, or two or three kanji or katakana words with a space) is compared with the names read in the prose. Reported are the same name with other punctuation or case, or one word different with the other words the same, either a letter away (Sofia Mendes in the text, Sofia Mendez in the table) or, for a Japanese name, read the same as the prose name (佐々木 美穂 and 佐々木 美保); these only when the prose form is used at least twice and the cell form once. Place names inside table cells are compared too. A word next to a name that the tagger did not read as a name (to Rachel Whitford, with Rachel read as a verb) is read with it when the two together are read as a name elsewhere. Two names with the same given name and a surname of seven letters or more, whose first four letters match and which differ in at most two letters between the shared start and end (three in the longer one), are reported when the usual form is used at least twice and the other once (Rachel Whitford and Rachel Whitfield). A different given name (Daniel Whitfield) or a surname alone is not compared this way. A name with its words in another order (Foundations of Statistics and Statistical Foundations) is reported only when both hold the same words (by stem) and neither contains the other, and one of them is written as a name, in quotation marks, after a label such as "Prerequisite" and a colon, or as a whole table cell. Two Title Case runs alone are not compared (Florida Supreme Court and Supreme Court of Florida), nor are two names joined by "and". In a Japanese name, a character for the same sound (桜ヶ丘 and 桜ケ丘, 霞ヶ関 and 霞が関) is the same only between two kanji, in a name the tagger reads as one word (not 桜が丘, read as 桜, が, 丘). A name without it (桜丘) or with other kanji (桜ヶ岡) is another name. This difference alone is also looked for in the names inside table cells. A model number (four or more capitals and digits, as one word) is read as the document's model only when it is in the title or after a model label from the lexicon (Model, Model No., Part No.); when it appears twice or more, a form that changes only hyphens, spaces, case or width (KM-SP300 and KM-SP-300, KMSP300, km-sp300) is reported. Codes with other letters or digits (KM-SP300 and KM-SP310, a sibling model in a comparison table, the part numbers of a parts list) are different models and are not compared. A word with small letters (iOS17), a version (v1.2 and v1.20), and a code inside a longer code, a URL, a path or a file name (KM-SP300-B, km-sp300.pdf) are not read as model numbers. A standard number written with spaces (JIS C 8714) is not one word, so it is not read as a model even in the title or after a label.
 rewrite:
   depth: light
   ja:

package/rules/no-em-dash.yaml

@@ -13,8 +13,8 @@ name:
   en: Too many dashes
 
 why:
-  ja: 日本語の組版でダッシュは扱いが難しく、環境によって長さも見えかたも変わります。読点や括弧で書けることが多いです。
-  en: In English a dash is a legitimate tool, and a heavy hand with it is also one of the better-known marks of generated text. On its own it says little; it counts toward the composite signal.
+  ja: 日本語の組版でダッシュは扱いが難しく、環境によって長さも見えかたも変わります。読点や括弧で書けることが多いです。数字のあいだで範囲を示すダッシュ（45–58、10:00–10:15）は数えません。
+  en: In English a dash is a legitimate tool, and a heavy hand with it is also one of the better-known marks of generated text. On its own it says little; it counts toward the composite signal. An en dash between two numbers (45–58, 10:00–10:15) marks a range and is not counted.
 
 message:
   ja: 1000 字あたり {density} 個のダッシュがあります（{limit} 個まで）

package/rules/party-order.yaml

@@ -0,0 +1,84 @@
+id: party-order
+layer: L3
+status: stable
+how_to_find: party-order
+word_list: party-order-joiner
+extra_word_lists: [party-order-label, party-short-name, party-role, company-form]
+requires: [structure]
+# An English contract has no fixed order for its parties: "the Supplier and the Customer" and "the Customer and the Supplier"
+# are both plain English. Japanese contracts list 甲 before 乙 by convention, so the rule is Japanese only.
+languages: [ja]
+severity: info
+
+name:
+  ja: 当事者の呼び名を、ほかの所と逆の順に並べている
+  en: Parties listed in the reverse of the document's usual order
+
+why:
+  ja: 契約書は当事者の呼び名を決まった順に並べます（甲及び乙、甲又は乙、甲乙、甲・乙・丙）。ほかの所で「甲及び乙」と書いた契約に「乙及び甲」が一つだけあると、読み手は順を変えた意味（乙を先に立てる理由）を探して止まります。条項を貼り合わせたときや、書き直したときに起きます。並べる語（及び・又は・と・・）でつないだ呼び名だけを数え、同じ二つの呼び名を逆の順に並べた所が、ふだんの順の半分以下のときに指します。
+  en: A Japanese contract lists its parties in a fixed order (甲及び乙, 甲又は乙, 甲乙, 甲・乙・丙). In a contract that writes 甲及び乙 everywhere else, a single 乙及び甲 makes the reader look for a reason to put 乙 first. It comes from pasted or rewritten clauses. Only names joined by a listing word (及び, 又は, と, ・) are counted, and a listing is reported when its order is written at most half as often as the reverse.
+
+message:
+  ja: 「{written}」は、この文書がほかの所で書く順（「{usual}」）と逆です
+  en: '"{written}" lists the parties in the reverse of the order this document uses elsewhere ("{usual}")'
+
+how_to_fix:
+  ja: ほかの所と同じ順に並べ替えてください。順に意味がある（乙を先に立てる）なら、そのままにします。
+  en: List the parties in the same order as elsewhere. If the order is meant (the second party first on purpose), leave it.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [legal, docs, academic, literature, speech]
+off_for:
+  docs: "The order of a contract's parties is a contract's convention: the contract genre checks it."
+  academic: "The order of a contract's parties is a contract's convention: the contract genre checks it."
+  literature: "The order of a contract's parties is a contract's convention: the contract genre checks it."
+  speech: "The order of a contract's parties is a contract's convention: the contract genre checks it."
+  legal/statute: "A statute defines no parties: it names people by their role."
+  legal/judgment: "A court decision quotes each side's words in that side's order."
+  legal/patent: "A patent has no parties."
+
+group: consistency
+summary:
+  ja: 「甲及び乙」と書く契約の中の「乙及び甲」
+  en: 乙及び甲 in a contract that otherwise writes 甲及び乙
+example:
+  ja:
+    config: { genre: legal/contract }
+    before: |
+      # 業務委託契約書
+
+      株式会社みなと商会（以下「甲」という。）と株式会社しおさい技研（以下「乙」という。）は、次のとおり契約を結ぶ。
+
+      第1条　甲又は乙は、相手方が本契約に違反したときは、本契約を解除することができる。
+
+      第2条　本契約に定めのない事項は、乙及び甲が協議して定める。
+
+      第3条　本書2通を作成し、甲乙記名押印の上、各1通を保有する。
+    after: |
+      # 業務委託契約書
+
+      株式会社みなと商会（以下「甲」という。）と株式会社しおさい技研（以下「乙」という。）は、次のとおり契約を結ぶ。
+
+      第1条　甲又は乙は、相手方が本契約に違反したときは、本契約を解除することができる。
+
+      第2条　本契約に定めのない事項は、甲及び乙が協議して定める。
+
+      第3条　本書2通を作成し、甲乙記名押印の上、各1通を保有する。
+
+not_flagged:
+  ja: 向きのある言い方（乙から甲への通知、甲に対し乙は、甲が乙に）は、並べたのではなく順に意味があるので数えません。「、」は、あとに並べる語がある並び（甲、乙及び丙）だけをつなぎます。長い語の頭（甲種株式の甲、乙種の乙）は呼び名と読みません。二つの順の数が同じか近い（逆の順が半分より多い）ときは、どちらがふだんの順とも言えないので指しません。呼び名は甲・乙・丙・丁と、文書が括弧で当事者に定めた呼び名（以下「委託者」という）です。契約書のジャンルで、日本語の文書だけで動きます。
+  en: A direction (乙から甲への通知, 甲に対し乙は, 甲が乙に) is not a listing and is not counted. A comma joins names only in a listing that goes on to a listing word (甲、乙及び丙). A name that starts a longer word (the 甲 of 甲種株式) is not read. When the two orders are written about as often (the reverse more than half as often), neither is the usual order and nothing is reported. The names are 甲, 乙, 丙 and 丁 and the short names the document gives its parties in brackets. Contracts only, in Japanese documents only.
+rewrite:
+  depth: light
+  ja:
+    direction: 当事者の呼び名を、文書のほかの所と同じ順に並べ替えます。並べた語と、並べる語（及び・又は）は変えません。
+    pairs:
+      - before: 乙及び甲が協議して定める。
+        after: 甲及び乙が協議して定める。
+      - before: 乙又は甲は、本契約を解除することができる。
+        after: 甲又は乙は、本契約を解除することができる。
+    keep:
+      - 並べる語（及び・又は・と）
+    avoid:
+      - 向きのある言い方（乙から甲へ）の順を変える

package/rules/preamble-length.yaml

@@ -10,8 +10,8 @@ name:
   en: Too long before the point
 
 why:
-  ja: 業務文書の読み手は結論を探しに来ています。最初の見出しまでに段落が重なると、探す手間だけが増えます。
-  en: A reader of a business document is looking for the decision. Paragraphs before the first heading only delay it.
+  ja: 業務文書の読み手は結論を探しに来ています。最初の見出しまでに段落が重なると、探す手間だけが増えます。文の閉じない段落（分類の札、著者の行）と、値が会社名だけの宛先・差出人の欄（英語の To 欄）は数えません。
+  en: A reader of a business document is looking for the decision. Paragraphs before the first heading only delay it. A paragraph with no closed sentence (a category label, an author line) and an address field whose value is only a name ("To" followed by a company name) are not counted.
 
 message:
   ja: 最初の見出しまでに {count} 段落あります（{limit} 段落まで）

package/rules/quantity-range-reversed.yaml

@@ -0,0 +1,53 @@
+id: quantity-range-reversed
+layer: L3
+status: stable
+how_to_find: quantity-range
+# The quantities are read with the unit lexicons (unit-length, unit-mass, unit-time, unit-volume, unit-data, unit-temperature,
+# unit-pressure, with unit-context); the joints are range-connector, range-opener, range-closer and quantity-range-word;
+# quantity-change-word and quantity-bound-label come next.
+severity: warning
+
+name:
+  ja: 量の範囲の上限が下限より小さい
+  en: A measured range whose upper end is below its lower end
+
+why:
+  ja: 「使用温度範囲：-10〜-40℃」「重さ 5〜2 kg」のように、測った量の範囲の終わりが始まりより小さいと、読み手はどちらの値が正しいのか、範囲がどこからどこまでなのかを確かめることになります。仕様書の温度や寸法で、片方の値だけを書き換えたときや、負の符号を書き足したとき、二つを入れ替えて書いたときに起きます。同じ単位の二つの量の間が範囲の記号（〜、–）だけのときと、「から」でつなぎ終わりの量のあとに「まで」が続くときを範囲として比べます。単位を一度だけ書いた範囲（30〜10 cm）も読みます。負の数は符号ごと読むので、-10〜-40℃ は終わりが小さく、-40〜-10℃ はそのままです。数の直後のハイフン（5-10 kg）は負の符号ではなく範囲の記号と読みます。同じ行に下限と上限を書いた二つの量も比べます。
+  en: 'When a measured range ends below where it starts ("Operating temperature: -10 to -40 °C", "Weight: 5–2 kg"), the reader has to ask which value is right and what the range is. It happens in a spec sheet when only one of the two values is edited, when a minus sign is added, or when the two are written the wrong way round. Two quantities in one unit are read as a range when only a range mark (–, —) or "to" stands between them, including a range that writes its unit once ("30–10 cm"). A negative number is read with its sign, so -10 to -40 °C ends below its start and -40 to -10 °C does not. A hyphen right after a number ("5-10 kg") is a range mark, not a minus sign. Two quantities on one line labelled minimum and maximum are compared too.'
+
+message:
+  ja: 量の範囲「{range}」の上限が下限より小さくなっています
+  en: 'The range "{range}" ends below where it starts'
+
+how_to_fix:
+  ja: 範囲の二つの値と符号を確かめて、書き間違えたほうを直すか、小さいほうから書いてください。
+  en: Check both values and their signs, and correct the wrong one or write the smaller one first.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: facts
+summary:
+  ja: 「使用温度範囲：-10〜-40℃」のように、測った量の範囲の終わりが始まりより小さい所
+  en: A measured range whose second value is smaller than its first, such as "-10 to -40 °C"
+example:
+  ja:
+    before: |
+      使用温度範囲：-10〜-40℃（凍結しないこと）
+    after: |
+      使用温度範囲：-10〜40℃（凍結しないこと）
+  en:
+    before: |
+      Operating temperature: -10 to -40 °C (no freezing)
+    after: |
+      Operating temperature: -10 to 40 °C (no freezing)
+
+not_flagged:
+  ja: 同じ文に値を変える語や下る順を言う語のある二つの量（「40℃から10℃まで冷却」「カウントダウン 10〜0秒」「重い順」）、単位の違う二つの量、間に言葉のある二つの量、計算の式は比べません。百分率や単位の無い数は読みません。
+  en: 'Two quantities in a sentence with a word that changes a value or names a descending order ("cooled from 40 °C to 10 °C", "from 100 m down to 10 m", "countdown"), two quantities in different units, two quantities with words between them, and a sum are not compared. Percentages and numbers without a unit are not read.'
+level_meaning:
+  ja: 測った量の範囲の終わりが始まりより小さいとき指摘
+  en: reported when a measured range ends below where it starts

package/rules/range-band-mismatch.yaml

@@ -0,0 +1,70 @@
+id: range-band-mismatch
+layer: L3
+status: stable
+how_to_find: range-band-mismatch
+# The ends of a band are read with range-band-word, its unit with range-band-unit, and the bare numbers of a column with
+# range-band-heading.
+severity: warning
+
+name:
+  ja: 重なるか、間が空いた区分の幅
+  en: Bands that overlap or leave a gap
+
+why:
+  ja: 「7〜12歳」のあとに「12〜14歳」、「1〜6歳」のあとに「8歳以上」のように、表の列や箇条書きに並べた年齢・体重・金額・点数の区分が重なったり間が空いたりすると、12歳はどちらの量か、7歳はどの区分かを読み手が決められません。用量や料金の表で、一つの区分の端だけを書き換えたときに起きます。以上・以下は端を含み、未満・超は含まないと読みます。年齢・人数・点数のように間に値の無い数は、6〜11歳のあとの12歳〜を続いていると読み、同じ数で接する二つの区分は重なると読みます。重さ・金額・期間のように間に値のある量は、「〜」で同じ数に接する区分（50〜60kg、60〜70kg）と、書いた桁の一つ分だけ離れた区分（59kgまでと60kgから）を続いていると読みます。
+  en: 'When the bands of a table column or a list (ages, weights, amounts, scores) overlap or leave a gap, as "7 to 12" followed by "12 to 14", or "1 to 6 years" followed by "8 years and over", the reader cannot tell which amount a 12-year-old takes or which band a 7-year-old is in. It happens in a dosage or a fee table when only one end of one band is edited. "And over", "or more" and "up to" include their end; "under", "over", "more than" and "less than" do not. Ages, people and points have no value in between, so 6 to 11 then 12 and over is contiguous and two bands that share an end number overlap. Weights, money and durations do, so two bands that meet at one number with a range mark ("50-60 kg", "60-70 kg") are contiguous, and so are two a step of the written digits apart (59 kg then 60 kg).'
+
+message:
+  ja: 区分「{earlier}」と「{later}」の幅が重なっています
+  en: 'The bands "{earlier}" and "{later}" overlap'
+messages:
+  gap:
+    ja: 区分「{earlier}」と「{later}」の間が空いています
+    en: 'The bands "{earlier}" and "{later}" leave a gap between them'
+
+how_to_fix:
+  ja: 区分の端の数を確かめて、書き間違えたほうを直してください。
+  en: Check the end numbers of the two bands, and correct the wrong one.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: facts
+summary:
+  ja: 表の列や箇条書きの「7〜12歳」「12〜14歳」のように、隣り合う区分の幅が重なるか、間が空いた所
+  en: Neighbouring bands of a table column or a list that overlap or leave a gap, such as "7 to 12" then "12 to 14"
+example:
+  ja:
+    before: |
+      | 年齢 | 1回量 |
+      | --- | --- |
+      | 15歳以上 | 2錠 |
+      | 12〜14歳 | 1錠 |
+      | 7〜12歳 | 半錠 |
+    after: |
+      | 年齢 | 1回量 |
+      | --- | --- |
+      | 15歳以上 | 2錠 |
+      | 12〜14歳 | 1錠 |
+      | 7〜11歳 | 半錠 |
+  en:
+    before: |
+      | Age | Dose |
+      | --- | --- |
+      | 1 to 6 years | 1 chew |
+      | 8 years and over | 2 chews |
+    after: |
+      | Age | Dose |
+      | --- | --- |
+      | 1 to 6 years | 1 chew |
+      | 7 years and over | 2 chews |
+
+not_flagged:
+  ja: 区分は、表の一つの列の続いた行か、一つの箇条書きの続いた項目の頭に、同じ単位で書いたものだけを比べます。単位を書かない数は、列の見出しが何を数えるか言うとき（年齢、体重(kg)）だけ読みます。一方の端だけを書いた区分が重なっていく段階（〜100万円、〜200万円、5人以上、10人以上）は、重なるように書いたものとして読みません。半分を超えて重なる区分（大きさの目安）と、二つだけの区分で、狭いほうの幅より大きく離れたものも言いません。時刻、日付と年（暦の年と分けられない）、負の数、単位の違う区分は読みません。
+  en: 'Only bands in consecutive rows of one table column, or at the head of consecutive items of one list, in one unit, are compared. Bare numbers are read only when the column heading says what they count ("Age", "Weight (kg)"). Tiers bounded at one end that are meant to nest ("up to $100", "up to $200", "5 or more", "10 or more") are not read as overlapping. Bands that overlap by more than half (size guides), and two bands alone that are further apart than the narrower one is wide, are not reported. Times of day, dates, negative numbers and bands in different units are not read.'
+level_meaning:
+  ja: 隣り合う区分の幅が重なるか、間が空いたとき指摘
+  en: reported when neighbouring bands overlap or leave a gap

package/rules/rent-multiple-mismatch.yaml

@@ -0,0 +1,61 @@
+id: rent-multiple-mismatch
+layer: L3
+status: stable
+how_to_find: rent-multiple-mismatch
+# The amounts are read with currency-notation and amount-multiplier; the labels are rent-label and rent-multiple-label, the
+# words rent-multiple-word, counts written as words number-word (digit), and a range of rent range-connector.
+severity: warning
+
+name:
+  ja: 賃料の月数分と合わない敷金・礼金
+  en: A deposit that is not the stated months of rent
+
+why:
+  ja: 物件の案内で「敷金 1か月（85,000円）」のように月数と金額を並べて書くと、読み手は金額を確かめずに用意します。賃料を書き直したときや、別の部屋の行を写したときに、月数か金額のどちらかが残って食い違います。敷金・礼金・保証金・償却などの見出しの後に月数と金額が一つずつ並んでいるとき、その金額を、前に書いた賃料のその月数分と比べます。一つのページに物件がいくつもあれば、それぞれ直前の賃料と比べます。管理費・共益費が書いてあれば、賃料だけの月数分と、賃料に管理費を足した額の月数分のどちらでもよいとします（どちらで計算するかを書かない案内が多いため）。賃料が「85,000円〜90,000円」のように幅で書いてあれば、その幅に入る額を認めます。「9.8万円」は書いた桁までの丸めを認めます。
+  en: 'When a listing says "Deposit: 2 months ($3,200)", readers prepare the amount without working it out. It goes wrong when the rent is changed and the deposit line is not, or a line is copied from another unit. When a deposit, key money or guarantee states one number of months and one amount, the amount is compared with that many months of the rent stated before it; with several listings on one page, each deposit is compared with the rent just before it. When a service charge or maintenance fee is stated, the months may be of the rent alone or of the rent and the fee, since listings use both and seldom say which. A rent given as a range ("$1,600 to $1,700") accepts any amount in that range of months.'
+
+message:
+  ja: 「{months}」と書いた額 {amount} が、賃料 {rent} のその月数分と合いません
+  en: "{amount} is not {months} of the rent ({rent})"
+
+how_to_fix:
+  ja: 賃料・月数・金額のどれが正しいかを確かめて、ほかを直してください。賃料に管理費を足した額や税込みの額で計算するなら、そう書いてください。
+  en: Check which of the rent, the months and the amount is right, and correct the others. If the months are of the rent with a fee or with tax, say so.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: facts
+summary:
+  ja: 「敷金 2か月（98,000円）」のように、賃料のその月数分と合わない金額
+  en: A deposit amount that is not the stated months of rent
+example:
+  ja:
+    before: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 賃料 | 98,000円 |
+      | 敷金 | 2か月（98,000円） |
+    after: |
+      | 項目 | 金額 |
+      | --- | --- |
+      | 賃料 | 98,000円 |
+      | 敷金 | 1か月（98,000円） |
+  en:
+    before: |
+      | Item | Amount |
+      | --- | --- |
+      | Rent | $1,600 |
+      | Deposit | 2 months ($3,000) |
+    after: |
+      | Item | Amount |
+      | --- | --- |
+      | Rent | $1,600 |
+      | Deposit | 2 months ($3,200) |
+
+not_flagged:
+  ja: 月数だけ（敷金 1か月）・金額だけ（敷金 85,000円）・「なし」の記載、「1〜2か月」のような月数の幅、一つの見出しに月数と金額の組が二つ以上ある記載、税込みの記載、賃料の書いていない文書、賃料や管理費の行に金額が二つある（「6,000円から5,000円に改定」）か年額・週額・坪単価の語がある文書は比べません。賃料より前に敷金があるときは、文書の賃料が一つのときだけ比べます。通貨の違う額は比べません。表の列見出しだけに「賃料」「敷金」とある表（行に見出しの無い表）は読みません。
+  en: 'A deposit given only in months ("1 month") or only as an amount, "none", a range of months ("1 to 2 months"), a statement with two different pairs of months and amount, an amount with tax, a document with no rent, and a rent or fee line holding two amounts ("$1,600, rising to $1,700") or another period ("per week", "per sq ft per year") are not compared. A deposit before any rent is compared only when the document states one rent. Amounts in different currencies are not compared. A table that names rent and deposit only in its column headings is not read.'

package/rules/required-listed-as-preferred.yaml

@@ -0,0 +1,102 @@
+id: required-listed-as-preferred
+layer: L3
+status: stable
+how_to_find: requirement-lists
+# The headings and labels come from requirement-heading; a length of experience is read with requirement-length-unit,
+# requirement-length-word and number-word, and requirement-item-ending is taken off the end of an item.
+languages: [ja, en]
+severity: warning
+
+name:
+  ja: 必須の条件を歓迎の条件にも挙げている
+  en: A required skill listed again as preferred
+
+why:
+  ja: 求人の「必須」に挙げた資格や経験を「歓迎」にも挙げると、読み手はそれが必ず要るのか、あれば良いだけなのかが分からず、応募するかどうかを決められません。どちらかの項目を書き換えたつもりで、別の行を写したときに起きます。必須（必須スキル、応募資格）と歓迎（歓迎スキル、尚可）の見出しや札の下の箇条書きを比べ、同じ項目が両方にあれば、歓迎のほうを指します。大文字と小文字、全角と半角、記号、項目の終わりの「の方」「こと」は区別しません。経験の長さ（3年以上）は外して比べ、歓迎のほうが長い経験を求めていなければ同じ項目と読みます。
+  en: 'When a posting lists a qualification under "Required" and again under "Preferred", the reader cannot tell whether it is a must or only welcome, and cannot decide whether to apply. It happens when one line is copied in place of the one that was meant to be rewritten. The list items under a required heading or label (Required, Requirements, Must have) are compared with those under a preferred one (Preferred, Nice to have, Bonus points), and an item in both is pointed out where it is preferred. Case, full and half width and punctuation are ignored. A length of experience (3+ years) is taken out before comparing, and the two are read as the same item unless the preferred one asks for more experience.'
+
+message:
+  ja: 「{item}」は必須の条件（{required}）にも挙げています
+  en: '"{item}" is also listed as required ({required})'
+
+how_to_fix:
+  ja: 必ず要るなら歓迎から消し、あれば良いだけなら必須から消してください。歓迎で上の水準を求めるなら、「5年以上」のように違いを書いてください。
+  en: Remove it from the preferred list if it is a must, or from the required list if it is only welcome. If the preferred item asks for more, say how much more, such as "5+ years".
+
+# chaff explain と規則の一覧には指摘が無いので、{item} と {required} をこう読ませる。
+placeholders:
+  item:
+    ja: 〇〇
+    en: the item
+  required:
+    ja: 必須の項目
+    en: the required item
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+
+group: structure
+summary:
+  ja: 求人で、必須に挙げた資格や経験を歓迎にも挙げている所
+  en: A skill or qualification in a job posting listed both as required and as preferred
+example:
+  ja:
+    before: |
+      # 求人：経理スタッフ
+
+      ## 必須
+
+      - 日商簿記2級以上
+      - 経理の実務経験3年以上
+
+      ## 歓迎
+
+      - 日商簿記2級以上
+      - 英語の書類を読めること
+    after: |
+      # 求人：経理スタッフ
+
+      ## 必須
+
+      - 日商簿記2級以上
+      - 経理の実務経験3年以上
+
+      ## 歓迎
+
+      - 連結決算の経験
+      - 英語の書類を読めること
+  en:
+    before: |
+      # Job posting: Accounts Assistant
+
+      ## Required
+
+      - A degree in accounting or finance
+      - At least three years of bookkeeping experience
+
+      ## Preferred
+
+      - At least three years of bookkeeping experience
+      - Reading business documents in Japanese
+    after: |
+      # Job posting: Accounts Assistant
+
+      ## Required
+
+      - A degree in accounting or finance
+      - At least three years of bookkeeping experience
+
+      ## Preferred
+
+      - Experience with consolidated accounts
+      - Reading business documents in Japanese
+
+not_flagged:
+  ja: 歓迎のほうが長い経験を求める項目（必須「Python」、歓迎「Python 5年以上」）は、上の水準を歓迎していると読んで指しません。違う言葉で同じことを言う項目（「簿記2級」と「日商簿記2級」）、資格の級の違い（「2級以上」と「1級」）、表に書いた条件、一つの行に「必須：Python、Go」のように並べた条件は比べません。見出しや札の無い箇条書きは読みません。
+  en: 'A preferred item asking for more experience (required "Python", preferred "5+ years of Python") is read as welcoming a higher level, and is not pointed out. Two items saying the same thing in other words ("bookkeeping" and "accounting"), different grades of a certificate, conditions written in a table, and conditions run together on one line ("Required: Python, Go") are not compared. A list without a required or preferred heading or label is not read.'
+level_meaning:
+  ja: 必須と歓迎の両方に同じ項目があるとき指摘
+  en: reported when the same item is listed as required and as preferred

package/rules/return-type-mismatch.yaml

@@ -0,0 +1,79 @@
+id: return-type-mismatch
+layer: L1
+status: stable
+how_to_find: return-type
+# The words come from the return-label (Returns, 戻り値), return-verb (returns, 返します), return-subject (は),
+# return-type-word (string, 文字列), return-clause (when, とき) and return-item (per, ごと) lexicons.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 戻り値の型が二通りに書かれている
+  en: A return type stated two ways
+
+why:
+  ja: API リファレンスで、関数のシグネチャと、「戻り値：」の行や表や文が違う型を返すと書いていると、読み手はどちらを信じてよいか分からず、返った値を間違った型として扱います。戻り値を変えたときに、片方だけを直すと起きます。コードブロックのシグネチャ（戻り値の型が付いたもの）を基準に、同じ見出しの下の「戻り値：」の行、戻り値の列を持つ表の行、関数名を主語にして「返します」と言う文を、同じ名前の関数どうしで比べます。Array<string> と string[] のような同じ型の別の書き方は同じと読み、「文字列」「数値」のような語は種類として比べます。
+  en: When an API reference's signature and a "Returns:" line, a table or a sentence say a function returns different types, the reader cannot tell which to trust and handles the value as the wrong type. It happens when a return type is changed in one place only. The signature in a code block (one with a return type) is the reference; a "Returns:" line under the same heading, a row of a table with a return column, and a sentence whose subject is the function's name and whose verb is "returns" are compared with it, for the same function only. Two spellings of one type (Array<string> and string[]) are the same, and words such as "string" or "number" are compared as kinds of value.
+
+message:
+  ja: 「{function}」の戻り値が「{stated}」と書かれていますが、シグネチャでは「{signature}」です
+  en: "`{function}` is said to return {stated} here, but its signature returns `{signature}`"
+
+how_to_fix:
+  ja: 実際の戻り値を確かめて、シグネチャか説明のどちらかを直してください。
+  en: Check what the function really returns, and correct the signature or the description.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Signatures and return types belong to technical writing."
+  academic: "Signatures and return types belong to technical writing."
+  literature: "Signatures and return types belong to technical writing."
+  speech: "Signatures and return types belong to technical writing."
+
+group: facts
+summary:
+  ja: API リファレンスで、シグネチャと説明が違う戻り値の型を言う所
+  en: A return type that the signature and the description state differently
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure は、幅を "12" のような文字列で返します。
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure は、幅を桁数の数値で返します。
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure returns the width as a string such as "12".
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      measure returns the width as a number of columns.
+
+not_flagged:
+  ja: シグネチャの無い関数、別の名前の関数、引数の違う二つの宣言（オーバーロード。どちらかに合えば合っているとします）、型を読めないもの（オブジェクトの型、括弧で囲んだ型）、型の名前の無い文、二つの種類を言う文（文字列の配列）、条件の節の中の種類の語（「文字列が空のときに true を返します」の文字列）、一つ分を言う語が続く種類の語（「文字列ごとに」の文字列）、null だけを言う文（いつ null が返るかの説明）、ユニオンの一部だけを言うもの（number | null に対する number）、Promise やクラス名のように種類の語では比べられない型は見ません。「返していました」「返しません」のような過去や否定、関数名が主語でない文、名前と動詞の間に語を挟んだ英語の文（measure usually returns）、二つ以上の関数を宣言した見出しの下の「戻り値：」の行、コードブロックの中は読みません。
+  en: 'A function with no signature, a different function, two declarations with different parameters (overloads; a statement that fits either is fine), a type that cannot be read (an object type, a type in brackets), a sentence with no type in it, a sentence naming two kinds (an array of strings), a kind word inside a clause about when (string in "returns true when the string is empty"), a kind word naming one item ("one string per line"), a sentence naming only null (when null comes back), part of a union (number against number | null), and a type that a kind word cannot be compared with (Promise, a class name) are not reported. The past (returned), a sentence whose subject is not the function''s name or that puts a word between the name and returns (measure usually returns), a "Returns:" line under a heading that declares two or more functions, and code blocks are not read.'