@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/domain/invoice-codes.d.ts

@@ -0,0 +1,142 @@
+/**
+ * 適格請求書発行事業者公表システム コード辞書
+ * Code dictionaries for the Invoice Issuer Publication System
+ *
+ * 根拠 / Source:
+ *   国税庁 リソース定義書 1.5版 (令和6年5月)
+ *   項番9 事業者処理区分 / 項番11 人格区分 / 項番12 国内外区分 / 項番13 最新履歴
+ *
+ * v0.3.0 のインボイス API 統合時に本格利用される (ADR 0012)。
+ * v0.1.0 では準備層として定義のみ提供、未使用。
+ */
+/**
+ * 事業者処理区分 (process) — リソース定義書 項番9
+ */
+export declare const INVOICE_PROCESS_CODES: {
+    readonly '01': {
+        readonly ja: "新規 (登録)";
+        readonly en: "Newly registered";
+    };
+    readonly '02': {
+        readonly ja: "公表内容の変更";
+        readonly en: "Publication content changed";
+    };
+    readonly '03': {
+        readonly ja: "登録の失効";
+        readonly en: "Registration expired";
+    };
+    readonly '04': {
+        readonly ja: "登録の取消";
+        readonly en: "Registration cancelled";
+    };
+    readonly '99': {
+        readonly ja: "削除";
+        readonly en: "Deleted (差分データのみ)";
+    };
+};
+export type InvoiceProcessCode = keyof typeof INVOICE_PROCESS_CODES;
+export declare function isInvoiceProcessCode(value: string): value is InvoiceProcessCode;
+export declare function invoiceProcessLabel(code: string, lang?: 'ja' | 'en'): string;
+/**
+ * 人格区分 (kind) — リソース定義書 項番11
+ */
+export declare const INVOICE_KIND_CODES: {
+    readonly '1': {
+        readonly ja: "個人";
+        readonly en: "Individual (sole proprietor)";
+    };
+    readonly '2': {
+        readonly ja: "法人 (人格のない社団等を含む)";
+        readonly en: "Corporation (incl. unincorporated association)";
+    };
+};
+export type InvoiceKindCode = keyof typeof INVOICE_KIND_CODES;
+export declare function isInvoiceKindCode(value: string): value is InvoiceKindCode;
+export declare function invoiceKindLabel(code: string, lang?: 'ja' | 'en'): string;
+/**
+ * 国内外区分 (country) — リソース定義書 項番12
+ */
+export declare const INVOICE_COUNTRY_CODES: {
+    readonly '1': {
+        readonly ja: "国内事業者";
+        readonly en: "Domestic business";
+    };
+    readonly '2': {
+        readonly ja: "特定国外事業者";
+        readonly en: "Specified foreign business";
+    };
+    readonly '3': {
+        readonly ja: "特定国外事業者以外の国外事業者";
+        readonly en: "Other foreign business";
+    };
+};
+export type InvoiceCountryCode = keyof typeof INVOICE_COUNTRY_CODES;
+export declare function isInvoiceCountryCode(value: string): value is InvoiceCountryCode;
+export declare function invoiceCountryLabel(code: string, lang?: 'ja' | 'en'): string;
+/**
+ * 最新履歴 (latest) — リソース定義書 項番13
+ */
+export declare const INVOICE_LATEST_CODES: {
+    readonly '0': {
+        readonly ja: "過去情報";
+        readonly en: "Past information";
+    };
+    readonly '1': {
+        readonly ja: "最新情報";
+        readonly en: "Latest information";
+    };
+};
+export type InvoiceLatestCode = keyof typeof INVOICE_LATEST_CODES;
+export declare function isInvoiceLatestCode(value: string): value is InvoiceLatestCode;
+/**
+ * 応答形式 (type) — 第二編 2.1.3 条件
+ * 注意: 法人番号 API と値が異なる (01=CSV, 11=XML, 21=JSON)
+ */
+export declare const INVOICE_RESPONSE_TYPES: {
+    readonly '01': {
+        readonly format: "CSV";
+        readonly encoding: "UTF-8";
+    };
+    readonly '11': {
+        readonly format: "XML";
+        readonly encoding: "UTF-8";
+    };
+    readonly '21': {
+        readonly format: "JSON";
+        readonly encoding: "UTF-8";
+    };
+};
+export type InvoiceResponseType = keyof typeof INVOICE_RESPONSE_TYPES;
+export declare function isInvoiceResponseType(value: string): value is InvoiceResponseType;
+/**
+ * 訂正区分 (correct) — リソース定義書 項番10
+ * Web-API 機能では常に「0」(訂正以外) が設定される (§2.3.1 参照)
+ * 差分データの場合のみ「1」(訂正) もあり得る
+ */
+export declare const INVOICE_CORRECT_CODES: {
+    readonly '0': {
+        readonly ja: "訂正以外";
+        readonly en: "Not corrected";
+    };
+    readonly '1': {
+        readonly ja: "訂正";
+        readonly en: "Corrected";
+    };
+};
+export type InvoiceCorrectCode = keyof typeof INVOICE_CORRECT_CODES;
+/**
+ * 差分 API で使う人格区分パラメータ (division) — 第二編 3.1.3
+ * 法人番号 API の `kind` パラメータとは別物に注意
+ */
+export declare const INVOICE_DIVISION_PARAMS: {
+    readonly '1': {
+        readonly ja: "個人";
+        readonly en: "Individual";
+    };
+    readonly '2': {
+        readonly ja: "法人";
+        readonly en: "Corporation";
+    };
+};
+export type InvoiceDivisionParam = keyof typeof INVOICE_DIVISION_PARAMS;
+//# sourceMappingURL=invoice-codes.d.ts.map

package/dist/domain/invoice-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-codes.d.ts","sourceRoot":"","sources":["../../src/domain/invoice-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAMxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAKlF;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;CAMrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAK/E;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAIxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAKlF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CAGvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAElE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAIzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAEjF;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;CAGxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;CAG1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,uBAAuB,CAAC"}

package/dist/domain/invoice-codes.js

@@ -0,0 +1,106 @@
+/**
+ * 適格請求書発行事業者公表システム コード辞書
+ * Code dictionaries for the Invoice Issuer Publication System
+ *
+ * 根拠 / Source:
+ *   国税庁 リソース定義書 1.5版 (令和6年5月)
+ *   項番9 事業者処理区分 / 項番11 人格区分 / 項番12 国内外区分 / 項番13 最新履歴
+ *
+ * v0.3.0 のインボイス API 統合時に本格利用される (ADR 0012)。
+ * v0.1.0 では準備層として定義のみ提供、未使用。
+ */
+/**
+ * 事業者処理区分 (process) — リソース定義書 項番9
+ */
+export const INVOICE_PROCESS_CODES = {
+    '01': { ja: '新規 (登録)', en: 'Newly registered' },
+    '02': { ja: '公表内容の変更', en: 'Publication content changed' },
+    '03': { ja: '登録の失効', en: 'Registration expired' },
+    '04': { ja: '登録の取消', en: 'Registration cancelled' },
+    '99': { ja: '削除', en: 'Deleted (差分データのみ)' },
+};
+export function isInvoiceProcessCode(value) {
+    return Object.prototype.hasOwnProperty.call(INVOICE_PROCESS_CODES, value);
+}
+export function invoiceProcessLabel(code, lang = 'ja') {
+    if (isInvoiceProcessCode(code)) {
+        return INVOICE_PROCESS_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+/**
+ * 人格区分 (kind) — リソース定義書 項番11
+ */
+export const INVOICE_KIND_CODES = {
+    '1': { ja: '個人', en: 'Individual (sole proprietor)' },
+    '2': {
+        ja: '法人 (人格のない社団等を含む)',
+        en: 'Corporation (incl. unincorporated association)',
+    },
+};
+export function isInvoiceKindCode(value) {
+    return value === '1' || value === '2';
+}
+export function invoiceKindLabel(code, lang = 'ja') {
+    if (isInvoiceKindCode(code)) {
+        return INVOICE_KIND_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+/**
+ * 国内外区分 (country) — リソース定義書 項番12
+ */
+export const INVOICE_COUNTRY_CODES = {
+    '1': { ja: '国内事業者', en: 'Domestic business' },
+    '2': { ja: '特定国外事業者', en: 'Specified foreign business' },
+    '3': { ja: '特定国外事業者以外の国外事業者', en: 'Other foreign business' },
+};
+export function isInvoiceCountryCode(value) {
+    return value === '1' || value === '2' || value === '3';
+}
+export function invoiceCountryLabel(code, lang = 'ja') {
+    if (isInvoiceCountryCode(code)) {
+        return INVOICE_COUNTRY_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+/**
+ * 最新履歴 (latest) — リソース定義書 項番13
+ */
+export const INVOICE_LATEST_CODES = {
+    '0': { ja: '過去情報', en: 'Past information' },
+    '1': { ja: '最新情報', en: 'Latest information' },
+};
+export function isInvoiceLatestCode(value) {
+    return value === '0' || value === '1';
+}
+/**
+ * 応答形式 (type) — 第二編 2.1.3 条件
+ * 注意: 法人番号 API と値が異なる (01=CSV, 11=XML, 21=JSON)
+ */
+export const INVOICE_RESPONSE_TYPES = {
+    '01': { format: 'CSV', encoding: 'UTF-8' },
+    '11': { format: 'XML', encoding: 'UTF-8' },
+    '21': { format: 'JSON', encoding: 'UTF-8' },
+};
+export function isInvoiceResponseType(value) {
+    return value === '01' || value === '11' || value === '21';
+}
+/**
+ * 訂正区分 (correct) — リソース定義書 項番10
+ * Web-API 機能では常に「0」(訂正以外) が設定される (§2.3.1 参照)
+ * 差分データの場合のみ「1」(訂正) もあり得る
+ */
+export const INVOICE_CORRECT_CODES = {
+    '0': { ja: '訂正以外', en: 'Not corrected' },
+    '1': { ja: '訂正', en: 'Corrected' },
+};
+/**
+ * 差分 API で使う人格区分パラメータ (division) — 第二編 3.1.3
+ * 法人番号 API の `kind` パラメータとは別物に注意
+ */
+export const INVOICE_DIVISION_PARAMS = {
+    '1': { ja: '個人', en: 'Individual' },
+    '2': { ja: '法人', en: 'Corporation' },
+};
+//# sourceMappingURL=invoice-codes.js.map

package/dist/domain/invoice-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-codes.js","sourceRoot":"","sources":["../../src/domain/invoice-codes.ts"],"names":[],"mappings":"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"}

package/dist/domain/invoice-number.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 適格請求書発行事業者 登録番号 (T+13桁) の Branded Type
+ * Qualified Invoice Issuer Registration Number (T + 13 digits)
+ * Nomor Registrasi Penerbit Invoice Berkualifikasi (T + 13 digit)
+ *
+ * 根拠 / Source:
+ *   国税庁 第二編 1.5版 2.1.3 条件: 登録番号は "T"＋13桁
+ *   国税庁 リソース定義書 1.5版 項番8: "T"+9999999999999 (14桁)
+ *
+ * T の次の 13 桁は法人番号 (法人の場合) または 個人事業主の識別番号 (個人の場合) であり、
+ * いずれもチェックデジット計算式は法人番号と同一 (第二編 別紙1 項番8 で定義)。
+ *
+ * 本ファイルは v0.3.0 のインボイス API 統合時に本格利用されるが、
+ * 法人番号ロジックの再利用可能性を担保するため、v0.1.0 で Branded type の骨格を提供する
+ * (ADR 0012 の前倒し実装方針)。
+ */
+import { z } from 'zod';
+/**
+ * "T" + 13桁の登録番号 (Branded type)
+ * Registered number: literal "T" prefix + 13-digit base (check digit + 12-digit basis)
+ */
+export declare const InvoiceNumberSchema: z.core.$ZodBranded<z.ZodString, "InvoiceNumber", "out">;
+export type InvoiceNumber = z.infer<typeof InvoiceNumberSchema>;
+export type InvoiceValidationReason = 'not_prefixed_with_T' | 'not_13_digits_after_T' | 'check_digit_mismatch' | 'invalid_characters' | 'first_digit_zero_after_T';
+export interface InvoiceValidationOk {
+    isValid: true;
+    normalized: string;
+    corporateNumberPart: string;
+}
+export interface InvoiceValidationError {
+    isValid: false;
+    reason: InvoiceValidationReason;
+}
+export type InvoiceValidationResult = InvoiceValidationOk | InvoiceValidationError;
+/**
+ * T番号文字列の正規化 + チェックデジット検証
+ *
+ * 入力は以下を許容:
+ * - `T1234567890123` (半角)
+ * - `ｔ1234567890123` (全角 t)
+ * - `T-1234-5678-90123` (ハイフン区切り)
+ * - `Ｔ１２３４５６７８９０１２３` (全角 T + 全角数字)
+ *
+ * @param raw 検証対象の文字列
+ */
+export declare function normalizeAndValidateInvoiceNumber(raw: string): InvoiceValidationResult;
+//# sourceMappingURL=invoice-number.d.ts.map

package/dist/domain/invoice-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number.d.ts","sourceRoot":"","sources":["../../src/domain/invoice-number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yDAOL,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAC/B,qBAAqB,GACrB,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEnF;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAkCtF"}

package/dist/domain/invoice-number.js

@@ -0,0 +1,71 @@
+/**
+ * 適格請求書発行事業者 登録番号 (T+13桁) の Branded Type
+ * Qualified Invoice Issuer Registration Number (T + 13 digits)
+ * Nomor Registrasi Penerbit Invoice Berkualifikasi (T + 13 digit)
+ *
+ * 根拠 / Source:
+ *   国税庁 第二編 1.5版 2.1.3 条件: 登録番号は "T"＋13桁
+ *   国税庁 リソース定義書 1.5版 項番8: "T"+9999999999999 (14桁)
+ *
+ * T の次の 13 桁は法人番号 (法人の場合) または 個人事業主の識別番号 (個人の場合) であり、
+ * いずれもチェックデジット計算式は法人番号と同一 (第二編 別紙1 項番8 で定義)。
+ *
+ * 本ファイルは v0.3.0 のインボイス API 統合時に本格利用されるが、
+ * 法人番号ロジックの再利用可能性を担保するため、v0.1.0 で Branded type の骨格を提供する
+ * (ADR 0012 の前倒し実装方針)。
+ */
+import { z } from 'zod';
+import { isValidCheckDigit, normalizeAndValidateCorporateNumber } from './check-digit.js';
+/**
+ * "T" + 13桁の登録番号 (Branded type)
+ * Registered number: literal "T" prefix + 13-digit base (check digit + 12-digit basis)
+ */
+export const InvoiceNumberSchema = z
+    .string()
+    .regex(/^T\d{13}$/, '登録番号は T + 半角数字13桁です / Must be "T" + 13 half-width digits')
+    .refine((s) => isValidCheckDigit(s.slice(1)), {
+    message: '登録番号のチェックデジットが一致しません (T を除いた 13桁部分) / Invalid check digit on the 13-digit base',
+})
+    .brand();
+/**
+ * T番号文字列の正規化 + チェックデジット検証
+ *
+ * 入力は以下を許容:
+ * - `T1234567890123` (半角)
+ * - `ｔ1234567890123` (全角 t)
+ * - `T-1234-5678-90123` (ハイフン区切り)
+ * - `Ｔ１２３４５６７８９０１２３` (全角 T + 全角数字)
+ *
+ * @param raw 検証対象の文字列
+ */
+export function normalizeAndValidateInvoiceNumber(raw) {
+    if (raw.length === 0) {
+        return { isValid: false, reason: 'not_prefixed_with_T' };
+    }
+    // 全角 T/t を半角 T に、全角数字を半角数字に
+    const normalizedT = raw
+        .replace(/[\uFF34\uFF54]/g, 'T') // Ｔ (U+FF34), ｔ (U+FF54)
+        .replace(/^[tT]/, 'T')
+        .replace(/[\uFF10-\uFF19]/g, (ch) => String.fromCharCode(ch.charCodeAt(0) - 0xfee0));
+    if (!normalizedT.startsWith('T')) {
+        return { isValid: false, reason: 'not_prefixed_with_T' };
+    }
+    const afterT = normalizedT.slice(1);
+    // 法人番号と同じ正規化ロジックを 13桁部分に適用
+    const cnResult = normalizeAndValidateCorporateNumber(afterT);
+    if (!cnResult.isValid) {
+        const mapReason = {
+            not_13_digits: 'not_13_digits_after_T',
+            check_digit_mismatch: 'check_digit_mismatch',
+            invalid_characters: 'invalid_characters',
+            first_digit_zero: 'first_digit_zero_after_T',
+        };
+        return { isValid: false, reason: mapReason[cnResult.reason] };
+    }
+    return {
+        isValid: true,
+        normalized: `T${cnResult.normalized}`,
+        corporateNumberPart: cnResult.normalized,
+    };
+}
+//# sourceMappingURL=invoice-number.js.map

package/dist/domain/invoice-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number.js","sourceRoot":"","sources":["../../src/domain/invoice-number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,mCAAmC,EAAE,MAAM,kBAAkB,CAAC;AAE1F;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,KAAK,CAAC,WAAW,EAAE,0DAA0D,CAAC;KAC9E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;IAC5C,OAAO,EACL,gFAAgF;CACnF,CAAC;KACD,KAAK,EAAmB,CAAC;AAwB5B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iCAAiC,CAAC,GAAW;IAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC3D,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,GAAG;SACpB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,yBAAyB;SACzD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAEvF,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,mCAAmC,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,SAAS,GAA4D;YACzE,aAAa,EAAE,uBAAuB;YACtC,oBAAoB,EAAE,sBAAsB;YAC5C,kBAAkB,EAAE,oBAAoB;YACxC,gBAAgB,EAAE,0BAA0B;SAC7C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI,QAAQ,CAAC,UAAU,EAAE;QACrC,mBAAmB,EAAE,QAAQ,CAAC,UAAU;KACzC,CAAC;AACJ,CAAC"}

package/dist/domain/kind-codes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 法人種別コード辞書
+ * Corporate kind code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番15 法人種別
+ */
+export declare const KIND_CODES: {
+    readonly '101': {
+        readonly ja: "国の機関";
+        readonly en: "State agency";
+        readonly id: "state_agency";
+    };
+    readonly '201': {
+        readonly ja: "地方公共団体";
+        readonly en: "Local government";
+        readonly id: "local_government";
+    };
+    readonly '301': {
+        readonly ja: "株式会社";
+        readonly en: "Kabushiki Kaisha (Corporation)";
+        readonly id: "kabushiki_kaisha";
+    };
+    readonly '302': {
+        readonly ja: "有限会社（特例有限会社）";
+        readonly en: "Yugen Kaisha (Special LLC)";
+        readonly id: "yugen_kaisha";
+    };
+    readonly '303': {
+        readonly ja: "合名会社";
+        readonly en: "Gomei Kaisha (General partnership)";
+        readonly id: "gomei_kaisha";
+    };
+    readonly '304': {
+        readonly ja: "合資会社";
+        readonly en: "Goshi Kaisha (Limited partnership)";
+        readonly id: "goshi_kaisha";
+    };
+    readonly '305': {
+        readonly ja: "合同会社";
+        readonly en: "Godo Kaisha (LLC)";
+        readonly id: "godo_kaisha";
+    };
+    readonly '399': {
+        readonly ja: "その他の設立登記法人";
+        readonly en: "Other registered juridical persons";
+        readonly id: "other_registered";
+    };
+    readonly '401': {
+        readonly ja: "外国会社等";
+        readonly en: "Foreign companies etc.";
+        readonly id: "foreign_company";
+    };
+    readonly '499': {
+        readonly ja: "その他";
+        readonly en: "Other (unincorporated associations etc.)";
+        readonly id: "other";
+    };
+};
+export type KindCode = keyof typeof KIND_CODES;
+export declare function isKindCode(value: string): value is KindCode;
+export declare function kindLabel(code: string, lang?: 'ja' | 'en' | 'id'): string;
+//# sourceMappingURL=kind-codes.d.ts.map

package/dist/domain/kind-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-codes.d.ts","sourceRoot":"","sources":["../../src/domain/kind-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,MAAM,CAK/E"}

package/dist/domain/kind-codes.js

@@ -0,0 +1,68 @@
+/**
+ * 法人種別コード辞書
+ * Corporate kind code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番15 法人種別
+ */
+export const KIND_CODES = {
+    '101': {
+        ja: '国の機関',
+        en: 'State agency',
+        id: 'state_agency',
+    },
+    '201': {
+        ja: '地方公共団体',
+        en: 'Local government',
+        id: 'local_government',
+    },
+    '301': {
+        ja: '株式会社',
+        en: 'Kabushiki Kaisha (Corporation)',
+        id: 'kabushiki_kaisha',
+    },
+    '302': {
+        ja: '有限会社（特例有限会社）',
+        en: 'Yugen Kaisha (Special LLC)',
+        id: 'yugen_kaisha',
+    },
+    '303': {
+        ja: '合名会社',
+        en: 'Gomei Kaisha (General partnership)',
+        id: 'gomei_kaisha',
+    },
+    '304': {
+        ja: '合資会社',
+        en: 'Goshi Kaisha (Limited partnership)',
+        id: 'goshi_kaisha',
+    },
+    '305': {
+        ja: '合同会社',
+        en: 'Godo Kaisha (LLC)',
+        id: 'godo_kaisha',
+    },
+    '399': {
+        ja: 'その他の設立登記法人',
+        en: 'Other registered juridical persons',
+        id: 'other_registered',
+    },
+    '401': {
+        ja: '外国会社等',
+        en: 'Foreign companies etc.',
+        id: 'foreign_company',
+    },
+    '499': {
+        ja: 'その他',
+        en: 'Other (unincorporated associations etc.)',
+        id: 'other',
+    },
+};
+export function isKindCode(value) {
+    return Object.prototype.hasOwnProperty.call(KIND_CODES, value);
+}
+export function kindLabel(code, lang = 'ja') {
+    if (isKindCode(code)) {
+        return KIND_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+//# sourceMappingURL=kind-codes.js.map

package/dist/domain/kind-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-codes.js","sourceRoot":"","sources":["../../src/domain/kind-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,cAAc;QAClB,EAAE,EAAE,cAAc;KACnB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,kBAAkB;QACtB,EAAE,EAAE,kBAAkB;KACvB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,gCAAgC;QACpC,EAAE,EAAE,kBAAkB;KACvB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,cAAc;QAClB,EAAE,EAAE,4BAA4B;QAChC,EAAE,EAAE,cAAc;KACnB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,oCAAoC;QACxC,EAAE,EAAE,cAAc;KACnB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,oCAAoC;QACxC,EAAE,EAAE,cAAc;KACnB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,mBAAmB;QACvB,EAAE,EAAE,aAAa;KAClB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,YAAY;QAChB,EAAE,EAAE,oCAAoC;QACxC,EAAE,EAAE,kBAAkB;KACvB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,OAAO;QACX,EAAE,EAAE,wBAAwB;QAC5B,EAAE,EAAE,iBAAiB;KACtB;IACD,KAAK,EAAE;QACL,EAAE,EAAE,KAAK;QACT,EAAE,EAAE,0CAA0C;QAC9C,EAAE,EAAE,OAAO;KACZ;CACO,CAAC;AAIX,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAA2B,IAAI;IACrE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,IAAI,GAAG,CAAC;AAC5B,CAAC"}

package/dist/domain/normalizer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 表記揺れ正規化 (T7 の核)
+ * Company name normalization (T7 core logic)
+ * Normalisasi nama perusahaan (inti T7)
+ *
+ * ポジショニング / Positioning:
+ *   国税庁 API `target=1` が既にあいまい検索を内蔵する (第二編 §4.6.2):
+ *     - ひらがな → カタカナ置換
+ *     - 英小文字 → 英大文字置換
+ *     - 中点 (・) や全角スペース削除
+ *
+ *   T7 はこれらを重複実装せず、国税庁が拾えない 7 パターンを補完:
+ *     1. (株)/㈱/株式会社 表記揺れ (前株・後株・省略 の3展開)
+ *     2. 法人種別 [株式/有限/合同/合名/合資/一般社団/...] の正規化 + 分離
+ *     3. 英語法人名 → 日本語候補 (K.K. / Kabushiki Kaisha / Inc. 検出)
+ *     4. 半角/全角英数字の正規化 (NFKC)
+ *     5. 旧字体 → 新字体 (髙 → 高、齋 → 斎 等)
+ *     6. 異体字セレクタ (IVS / VS) 除去
+ *     7. 空白類の揃え (タブ・連続スペース・全角/半角スペース)
+ */
+export type KindHint = 'state_agency' | 'local_government' | 'kabushiki_kaisha' | 'yugen_kaisha' | 'gomei_kaisha' | 'goshi_kaisha' | 'godo_kaisha' | 'ippan_shadan_hojin' | 'ippan_zaidan_hojin' | 'koueki_shadan_hojin' | 'koueki_zaidan_hojin' | 'npo_hojin' | 'other_registered' | 'foreign_company' | 'other' | 'unknown';
+export type PrefixOrSuffix = 'mae_kabu' | 'ato_kabu' | 'none';
+export interface NormalizedCandidate {
+    /** 国税庁 API に投げる法人名候補 */
+    name: string;
+    /** 推定される法人種別 */
+    kind_hint: KindHint;
+    /** 法人種別の位置 (前株/後株/無し) */
+    prefix_or_suffix: PrefixOrSuffix;
+    /** 国税庁 API の target パラメータ推奨値 */
+    suggested_target: '1' | '2' | '3';
+    /** 信頼度 (0.0-1.0) */
+    confidence: number;
+    /** このルールで適用された補完パターン */
+    applied_rules: string[];
+}
+export interface NormalizerResult {
+    original: string;
+    extracted_core_name: string;
+    normalized_candidates: NormalizedCandidate[];
+    fallback_note?: string;
+}
+/**
+ * 文字列を正規化して法人名候補リストを生成
+ *
+ * @param raw 入力文字列 (名刺OCR や手入力の揺れを含む)
+ * @returns 最大10件の正規化候補
+ */
+export declare function normalizeCompanyName(raw: string): NormalizerResult;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/domain/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/domain/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,WAAW,GACX,kBAAkB,GAClB,iBAAiB,GACjB,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,SAAS,EAAE,QAAQ,CAAC;IACpB,yBAAyB;IACzB,gBAAgB,EAAE,cAAc,CAAC;IACjC,gCAAgC;IAChC,gBAAgB,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAClC,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,mBAAmB,EAAE,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwFD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAyIlE"}