itaiji-normalize v0.2.0

このライブラリが「しない」こと

• 根拠なく1つに決めない。 候補が複数あって、法務省告示の順位・戸籍通達の 経由数・常用漢字/人名用漢字のいずれでも決着しなければ、unique は null を返します。上のデモで ambiguous が出るのはこの場合です。
• 空白と不可視文字は、キーから落とします。 姓名の間に空白を 入れるかどうかは人物の属性ではないので、渡辺 太郎 と 渡辺太郎 は同じキーになります。ゼロ幅スペースや BOM のような 画面に見えない文字も同じ扱いです——Excel や PDF からの コピーで混入し、見た目が同じなのに一致しない、という形でいちばん困るのがここ。 ただし・ や ー／― の違い、 ひらがなとカタカナは畳みません。文字列の意味が変わるので、 同じだと決めるのは呼び出し側の仕事です
• 逆変換（新字→特定の旧字）は提供しません。 「辺」を「邉」と「邊」の どちらに戻すかを決める根拠は、データの側に存在しないためです。
• 戸籍・法務・金融用途での同一性判断は保証しません。 このライブラリが 保証しているのは「決められないときに決めないこと」であって、「答えが正しいこと」では ありません。人が確認する工程の前段として使ってください。

使う

npm install itaiji-normalize@0.2.0

import { toMatchingKey, reduce } from "itaiji-normalize";

toMatchingKey("渡邉 太郎").key;  // "渡辺 太郎"
reduce("朢").unique;             // null （候補が2つあり決められない）

依存ゼロ。データは全部同梱で、実行時に外部へ取りに行きません。 Node 18+ / ブラウザ / Cloudflare Workers で動きます。