@pai-forge/riichi-mahjong 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -1,21 +1,738 @@
-/**
- * Riichi Mahjong Library
- */
-export { HaiKind, Tacha, FuroType, MentsuType, HaiType } from "./types";
-export type { HaiId, HaiKindId, Furo, Shuntsu, Koutsu, Kantsu, CompletedMentsu, Tehai, Tehai13, Tehai14, Mentsu, IncompletedMentsu, Kazehai, Fu, } from "./types";
-export type { YakuResult, YakuName, Hansu } from "./features/yaku";
-export type { ScoreResult, ScoreCalculationConfig, Payment, Ron, KoTsumo, OyaTsumo, } from "./features/score/types";
-export { MahjongError, ShoushaiError, TahaiError, MahjongArgumentError, DuplicatedHaiIdError, InvalidHaiQuantityError, ChomboError, NoYakuError, } from "./errors";
-export { haiIdToKindId, kindIdToHaiType, haiKindToNumber, isSuupai, isYaochu, YAOCHU_KIND_IDS, } from "./core/hai";
-export { validateTehai, isTehai13, isTehai14 } from "./core/tehai";
-export { isValidShuntsu, isValidKoutsu, isValidKantsu, isValidToitsu, isValidTatsu, } from "./core/mentsu";
-export { getDoraNext, countDora } from "./core/dora";
-export { classifyMachi } from "./core/machi";
-export type { MachiType } from "./core/machi";
-export { calculateShanten } from "./features/shanten";
-export { getUkeire } from "./features/machi";
-export { detectYaku } from "./features/yaku";
-export { isMenzen, isKazehai } from "./features/yaku/utils";
-export { parseMspz, parseExtendedMspz } from "./features/parser";
-export { isMspz, isExtendedMspz } from "./features/parser/mspz";
-export { calculateScoreForTehai, getPaymentTotal } from "./features/score";
+/**
+ * 基本的な面子構造 (ジェネリック)
+ *
+ * 牌の型をジェネリクス `T` で抽象化することで、以下の両方のユースケースに対応します：
+ * 1. `HaiKindId`: MPSZ形式の手牌をもとにシャンテン計算を行うなど、牌の種類のみに関心がある場合（抽象的な計算）。
+ * 2. `HaiId`: 実際のゲームの牌譜など、牌の物理的なIDを処理対象とする場合（具象的な計算）。
+ */
+declare interface BaseMentsu<T extends HaiKindId | HaiId> {
+    readonly type: MentsuType;
+    /**
+     * 構成する牌のリスト。
+     *
+     * 各面子型（Shuntsu等）において固定長タプル（例: `[T, T, T]`）として再定義することで、
+     * 面子の種類ごとの正しい牌枚数（順子なら3枚、槓子なら4枚など）を型レベルで強制します。
+     */
+    hais: readonly T[];
+}
+
+/**
+ * 手牌とコンテキストから点数を計算する（公開API）
+ *
+ * 手牌の構造解析を行い、最も高点となる解釈を採用して点数を返します。
+ *
+ * 注: 同一手牌で「翻数が高いが符が低い解釈」と「翻数が低いが符が高い解釈」が
+ * 両立するケースは実質的に存在しないため、翻数最大の解釈を採用しています。
+ *
+ * @param tehai 手牌 (14枚)
+ * @param config 点数計算の設定 (場風、自風、ドラなど)
+ * @returns 点数計算結果
+ */
+export declare function calculateScoreForTehai(tehai: Tehai14, config: Readonly<ScoreCalculationConfig>): ScoreResult;
+
+/**
+ * シャンテン数を計算します。
+ * 面子手、七対子、国士無双のシャンテン数のうち最小値を返します。
+ *
+ * NOTE: 入力は必ず牌種ID (`HaiKindId`) である必要があります。
+ * 物理牌ID (`HaiId`) を持っている場合は、事前に `haiIdToKindId` で変換してください。
+ *
+ * @param tehai 手牌
+ * @returns シャンテン数
+ */
+export declare function calculateShanten(tehai: Tehai13, useChiitoitsu?: boolean, useKokushi?: boolean): number;
+
+declare interface ChiitoitsuHouraStructure {
+    readonly type: "Chiitoitsu";
+    readonly pairs: readonly [
+    Toitsu,
+    Toitsu,
+    Toitsu,
+    Toitsu,
+    Toitsu,
+    Toitsu,
+    Toitsu
+    ];
+}
+
+/**
+ * チョンボ（錯和）の基底エラークラス
+ *
+ * 不正な和了宣言に関するエラーの基底クラス。
+ * 具体的なチョンボ種別（役なし、フリテン等）はサブクラスで定義する。
+ */
+export declare class ChomboError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/**
+ * 手牌構造と和了牌から待ちの形を判定する
+ * @param hand 分解された手牌構造
+ * @param agariHai 和了牌
+ * @returns 待ちの形（判定できない、または Shanpon などの場合は undefined）
+ */
+export declare function classifyMachi(hand: HouraStructure, agariHai: HaiKindId): MachiType | undefined;
+
+/**
+ * 完成面子 (CompletedMentsu)
+ * - 順子 (Shuntsu)
+ * - 刻子 (Koutsu)
+ * - 槓子 (Kantsu)
+ */
+export declare type CompletedMentsu<T extends HaiKindId | HaiId = HaiKindId> = Shuntsu<T> | Koutsu<T> | Kantsu<T>;
+
+/**
+ * 手牌に含まれるドラの数を数える
+ * @param tehai 手牌
+ * @param indicators ドラ表示牌のリスト
+ * @returns ドラの総数
+ */
+export declare function countDora(tehai: Tehai, indicators: readonly HaiKindId[]): number;
+
+/**
+ * 手牌の構造役を検出する
+ *
+ * @param tehai 判定対象の手牌
+ * @param agariHai 和了牌
+ * @returns 成立した役と翻数のリスト（最も高得点となる解釈の結果）
+ */
+export declare function detectYaku(tehai: Tehai14, agariHai: HaiKindId, bakaze?: HaiKindId, jikaze?: HaiKindId, doraMarkers?: readonly HaiKindId[], uraDoraMarkers?: readonly HaiKindId[], isTsumo?: boolean): YakuResult;
+
+/**
+ * 牌IDが重複している場合のエラー
+ * (物理的な牌IDは一意である必要があります)
+ */
+export declare class DuplicatedHaiIdError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/**
+ * 拡張MSPZ形式の文字列
+ * 通常のMSPZに加え、`[...]` (副露) や `(...)` (暗槓) を含むことができます。
+ */
+declare type ExtendedMspzString = string & {
+    readonly __brand: "ExtendedMspzString";
+};
+
+/**
+ * 符 (Fu)
+ *
+ * 和了時の手牌構成から算出される符の値。
+ *
+ * - 20: 副底（基本符）
+ * - 25: 七対子専用
+ * - 30〜110: 10符刻みの値
+ */
+export declare type Fu = 20 | 25 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 | 110;
+
+/**
+ * 副露 (Furo)
+ *
+ * 面子に対する「鳴き」のメタ情報。
+ * ここでは副露を「自分の手牌が不足している面子を、他家が捨てた牌を取って完成させる行為」と定義し、
+ * 暗槓（自力で4枚揃える行為）はここには含めない。
+ *
+ * 構成する牌自体はここには含めず、この型を持つ親（Mentsuなど）が保持することを想定する。
+ */
+export declare type Furo = {
+    readonly type: typeof FuroType.Chi;
+    readonly from: Tacha;
+} | {
+    readonly type: typeof FuroType.Pon;
+    readonly from: Tacha;
+} | {
+    readonly type: typeof FuroType.Daiminkan;
+    readonly from: Tacha;
+} | {
+    readonly type: typeof FuroType.Kakan;
+    readonly from: Tacha;
+};
+
+/**
+ * 副露種別 (FuroType)
+ */
+export declare const FuroType: {
+    readonly Chi: "Chi";
+    readonly Pon: "Pon";
+    readonly Daiminkan: "Daiminkan";
+    readonly Kakan: "Kakan";
+};
+
+export declare type FuroType = (typeof FuroType)[keyof typeof FuroType];
+
+/**
+ * ドラ表示牌から次の牌（ドラ）を求める
+ * @param indicator ドラ表示牌のID (HaiKindId)
+ * @returns ドラ牌のID (HaiKindId)
+ */
+export declare function getDoraNext(indicator: HaiKindId): HaiKindId;
+
+/**
+ * 支払い情報から和了者が受け取る総点数を計算する
+ */
+export declare function getPaymentTotal(payment: Readonly<Payment>): number;
+
+/**
+ * 手牌の受け入れ（有効牌）を計算する。
+ * 今回は面子手のみを対象とし、七対子や国士無双は考慮しない。
+ *
+ * @param tehai 手牌 (13枚)
+ * @returns シャンテン数を進める牌のリスト
+ */
+export declare function getUkeire(tehai: Tehai13): HaiKindId[];
+
+/**
+ * 牌種IDの定数セット
+ *
+ * - 0-8: 萬子 (ManZu)
+ * - 9-17: 筒子 (PinZu)
+ * - 18-26: 索子 (SouZu)
+ * - 27-33: 字牌 (JiHai)
+ */
+declare const HAI_KIND_IDS: readonly [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33];
+
+/**
+ * 物理的な牌の一意な識別子 (HaiId)
+ *
+ * 麻雀セットに含まれる136枚の牌それぞれに一意のIDが割り当てられます (0-135)。
+ *
+ * - 0-35: 萬子
+ * - 36-71: 筒子
+ * - 72-107: 索子
+ * - 108-135: 字牌
+ *
+ * Branded Type を使用して通常の number と区別します。
+ */
+export declare type HaiId = number & {
+    readonly __brand: "HaiId";
+};
+
+/**
+ * 物理牌IDから牌種IDを取得する
+ * 0-35: 萬子 (36枚 = 9種 * 4枚) -> 0-8
+ * 36-71: 筒子 (36枚) -> 9-17
+ * 72-107: 索子 (36枚) -> 18-26
+ * 108-135: 字牌 (28枚 = 7種 * 4枚) -> 27-33
+ */
+export declare function haiIdToKindId(id: HaiId): HaiKindId;
+
+/**
+ * 牌種 (HaiKind)
+ *
+ * 牌種IDに対応する定数定義。
+ */
+export declare const HaiKind: {
+    readonly ManZu1: 0;
+    readonly ManZu2: 1;
+    readonly ManZu3: 2;
+    readonly ManZu4: 3;
+    readonly ManZu5: 4;
+    readonly ManZu6: 5;
+    readonly ManZu7: 6;
+    readonly ManZu8: 7;
+    readonly ManZu9: 8;
+    readonly PinZu1: 9;
+    readonly PinZu2: 10;
+    readonly PinZu3: 11;
+    readonly PinZu4: 12;
+    readonly PinZu5: 13;
+    readonly PinZu6: 14;
+    readonly PinZu7: 15;
+    readonly PinZu8: 16;
+    readonly PinZu9: 17;
+    readonly SouZu1: 18;
+    readonly SouZu2: 19;
+    readonly SouZu3: 20;
+    readonly SouZu4: 21;
+    readonly SouZu5: 22;
+    readonly SouZu6: 23;
+    readonly SouZu7: 24;
+    readonly SouZu8: 25;
+    readonly SouZu9: 26;
+    readonly Ton: 27;
+    readonly Nan: 28;
+    readonly Sha: 29;
+    readonly Pei: 30;
+    readonly Haku: 31;
+    readonly Hatsu: 32;
+    readonly Chun: 33;
+};
+
+export declare type HaiKind = (typeof HaiKind)[keyof typeof HaiKind];
+
+/**
+ * 牌種ID (HaiKindId)
+ *
+ * 麻雀の34種類の牌を一意に識別するID。
+ */
+export declare type HaiKindId = (typeof HAI_KIND_IDS)[number];
+
+/**
+ * 牌種IDから数値(1-9)を取得する
+ * 字牌の場合は undefined を返す
+ */
+export declare function haiKindToNumber(kind: HaiKindId): number | undefined;
+
+/**
+ * 牌種タイプ (HaiType)
+ */
+export declare const HaiType: {
+    readonly Manzu: "Manzu";
+    readonly Pinzu: "Pinzu";
+    readonly Souzu: "Souzu";
+    readonly Jihai: "Jihai";
+};
+
+export declare type HaiType = (typeof HaiType)[keyof typeof HaiType];
+
+/**
+ * 役の翻数 (Hansu)
+ *
+ * 1, 2, 3, 5(流し満貫/清一色喰い下がり), 6(清一色), 13(役満), 26(ダブル役満)
+ */
+export declare type Hansu = 1 | 2 | 3 | 5 | 6 | 13 | 26;
+
+declare type HouraStructure = MentsuHouraStructure | ChiitoitsuHouraStructure | KokushiHouraStructure;
+
+/**
+ * 未完成面子 (IncompletedMentsu)
+ * - 対子 (Toitsu)
+ * - 塔子 (Tatsu)
+ */
+export declare type IncompletedMentsu<T extends HaiKindId | HaiId = HaiKindId> = Toitsu<T> | Tatsu<T>;
+
+/**
+ * 牌の枚数が不正な場合のエラー
+ * (同種の牌は最大4枚までです)
+ */
+export declare class InvalidHaiQuantityError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/**
+ * 文字列が拡張MSPZ形式（`[` または `(` を含み、かつ正しい書式）かどうかを判定します。
+ * @param input 判定対象の文字列
+ * @returns 拡張MSPZ形式であれば true
+ */
+export declare function isExtendedMspz(input: string): input is ExtendedMspzString;
+
+/**
+ * 指定された牌が風牌かどうかを判定する。
+ *
+ * @param id 判定対象の牌種ID
+ * @returns 風牌（東・南・西・北）であれば true
+ */
+export declare function isKazehai(id: HaiKindId): id is Kazehai;
+
+/**
+ * 手牌が門前（メンゼン）かどうかを判定する。
+ *
+ * 門前の定義:
+ * - 明刻、明順、明槓などの「晒し」が含まれていないこと。
+ * - 暗槓は門前として扱う。
+ *
+ * @param tehai 判定対象の手牌
+ * @returns 門前であれば true、そうでなければ false
+ */
+export declare function isMenzen(tehai: Tehai14): boolean;
+
+/**
+ * 文字列が標準的なMSPZ形式（拡張記法を含まず、かつ正しい書式）かどうかを判定します。
+ * @param input 判定対象の文字列
+ * @returns 標準MSPZ形式であれば true
+ */
+export declare function isMspz(input: string): input is MspzString;
+
+/**
+ * 数牌かどうかを判定する
+ */
+export declare function isSuupai(kind: HaiKindId): boolean;
+
+/**
+ * Type Guard for Tehai13
+ */
+export declare function isTehai13<T extends HaiKindId | HaiId>(tehai: Tehai<T>): tehai is Tehai13<T>;
+
+/**
+ * Type Guard for Tehai14
+ */
+export declare function isTehai14<T extends HaiKindId | HaiId>(tehai: Tehai<T>): tehai is Tehai14<T>;
+
+/**
+ * 槓子かどうかを検証する
+
+ */
+export declare function isValidKantsu(kindIds: readonly HaiKindId[]): boolean;
+
+/**
+ * 刻子かどうかを検証する
+
+ */
+export declare function isValidKoutsu(kindIds: readonly HaiKindId[]): boolean;
+
+/**
+ * 順子かどうかを検証する
+
+ */
+export declare function isValidShuntsu(kindIds: readonly HaiKindId[]): boolean;
+
+/**
+ * 塔子かどうかを検証する
+
+ */
+export declare function isValidTatsu(kindIds: readonly HaiKindId[]): boolean;
+
+/**
+ * 対子かどうかを検証する
+
+ */
+export declare function isValidToitsu(kindIds: readonly HaiKindId[]): boolean;
+
+/**
+ * 么九牌（1,9,字牌）かどうかを判定する
+ */
+export declare function isYaochu(kind: HaiKindId): boolean;
+
+/**
+ * 槓子 (Kantsu)
+ */
+export declare type Kantsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
+    readonly type: typeof MentsuType.Kantsu;
+    readonly hais: readonly [T, T, T, T];
+    readonly furo?: Furo;
+};
+
+/** 自風・場風を表す牌 (東・南・西・北) */
+export declare type Kazehai = typeof HaiKind.Ton | typeof HaiKind.Nan | typeof HaiKind.Sha | typeof HaiKind.Pei;
+
+/**
+ * 牌種IDから牌種タイプを取得する
+ */
+export declare function kindIdToHaiType(kind: HaiKindId): HaiType;
+
+declare interface KokushiHouraStructure {
+    readonly type: "Kokushi";
+    /** 13種類の么九牌（重複なし） */
+    readonly yaochu: readonly HaiKindId[];
+    /** 雀頭となる牌の種類 */
+    readonly jantou: HaiKindId;
+}
+
+/** 子のツモ和了時の支払い */
+export declare interface KoTsumo {
+    type: "koTsumo";
+    /** [子の支払い, 親の支払い] */
+    readonly amount: readonly [number, number];
+}
+
+/**
+ * 刻子 (Koutsu)
+ */
+export declare type Koutsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
+    readonly type: typeof MentsuType.Koutsu;
+    readonly hais: readonly [T, T, T];
+    readonly furo?: Furo;
+};
+
+/** 待ちの形 */
+export declare type MachiType = "Tanki" | "Shanpon" | "Ryanmen" | "Kanchan" | "Penchan";
+
+/**
+ * 引数が不正な場合のエラー
+ * 必要なパラメータが不足している、または不正な値の場合にスローされます。
+ */
+export declare class MahjongArgumentError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message: string);
+}
+
+/**
+ * riichi-mahjong ライブラリの基本エラークラス
+ * 全てのカスタムエラーはこのクラスを継承します。
+ */
+export declare class MahjongError extends Error {
+    /**
+     *
+     */
+    constructor(message: string);
+}
+
+/**
+ * 面子 (Mentsu)
+ *
+ * 広義の面子（ブロック）。指定がない場合は HaiKindId のリストを持つ。
+ */
+export declare type Mentsu<T extends HaiKindId | HaiId = HaiKindId> = CompletedMentsu<T> | IncompletedMentsu<T>;
+
+declare interface MentsuHouraStructure {
+    readonly type: "Mentsu";
+    readonly fourMentsu: readonly [
+    CompletedMentsu,
+    CompletedMentsu,
+    CompletedMentsu,
+    CompletedMentsu
+    ];
+    readonly jantou: Toitsu;
+}
+
+/**
+ * 面子種別 (MentsuType)
+ */
+export declare const MentsuType: {
+    readonly Shuntsu: "Shuntsu";
+    readonly Koutsu: "Koutsu";
+    readonly Kantsu: "Kantsu";
+    readonly Toitsu: "Toitsu";
+    readonly Tatsu: "Tatsu";
+};
+
+export declare type MentsuType = (typeof MentsuType)[keyof typeof MentsuType];
+
+/**
+ * 標準的なMSPZ形式の文字列（拡張記法を含まない）
+ */
+declare type MspzString = string & {
+    readonly __brand: "MspzString";
+};
+
+/**
+ * 役なし和了のエラー
+ *
+ * 和了形は成立しているが、役が一つも成立していない場合にスローされます。
+ */
+export declare class NoYakuError extends ChomboError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/** 親のツモ和了時の支払い */
+export declare interface OyaTsumo {
+    type: "oyaTsumo";
+    /** 子全員が支払う点数（オール） */
+    amount: number;
+}
+
+/**
+ * 拡張MSPZ文字列（例: "123m[123p]..."）を解析して手牌オブジェクトを生成します。
+ * 副露牌（`[...]`）や暗槓（`(...)`）を含めることができます。
+ *
+ * @param input 拡張MSPZ形式の文字列
+ * @returns 手牌オブジェクト
+ */
+export declare function parseExtendedMspz(input: string): Tehai;
+
+/**
+ * 標準的なMSPZ文字列（例: "123m456p..."）を解析して手牌オブジェクトを生成します。
+ * 副露牌は含まれません。
+ *
+ * @param input MSPZ形式の文字列
+ * @returns 手牌オブジェクト
+ */
+export declare function parseMspz(input: string): Tehai;
+
+/** 支払い情報 */
+export declare type Payment = Ron | KoTsumo | OyaTsumo;
+
+/** ロン和了時の支払い */
+export declare interface Ron {
+    type: "ron";
+    /** 振り込んだプレイヤーが支払う点数 */
+    amount: number;
+}
+
+export declare interface ScoreCalculationConfig {
+    /** 和了牌 */
+    agariHai: HaiKindId;
+    /** ツモ和了かどうか (必須) */
+    isTsumo: boolean;
+    /** 自風 (必須) */
+    jikaze: Kazehai;
+    /** 場風 (必須) */
+    bakaze: Kazehai;
+    /** ドラ表示牌 (必須、なければ空配列) */
+    doraMarkers: readonly HaiKindId[];
+    /** 裏ドラ表示牌 (任意) */
+    uraDoraMarkers?: readonly HaiKindId[];
+}
+
+/**
+ * 点数レベル (ScoreLevel)
+ *
+ * 翻数と基本点から決まる点数の区分。
+ * 満貫以上では符に関係なく固定の基本点が適用される。
+ */
+declare const ScoreLevel: {
+    /** 満貫未満（通常計算） */
+    readonly Normal: "Normal";
+    /** 満貫（5翻、または基本点2000以上） */
+    readonly Mangan: "Mangan";
+    /** 跳満（6-7翻） */
+    readonly Haneman: "Haneman";
+    /** 倍満（8-10翻） */
+    readonly Baiman: "Baiman";
+    /** 三倍満（11-12翻） */
+    readonly Sanbaiman: "Sanbaiman";
+    /** 役満（13翻以上） */
+    readonly Yakuman: "Yakuman";
+    /** ダブル役満（26翻以上、または役満複合） */
+    readonly DoubleYakuman: "DoubleYakuman";
+};
+
+declare type ScoreLevel = (typeof ScoreLevel)[keyof typeof ScoreLevel];
+
+export declare interface ScoreResult {
+    han: number;
+    fu: Fu;
+    scoreLevel: ScoreLevel;
+    payment: Payment;
+}
+
+/**
+ * ツモれなかった場合のエラー (少牌)
+ * 手牌が規定枚数（13枚）より少ない場合にスローされます。
+ */
+export declare class ShoushaiError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/**
+ * 順子 (Shuntsu)
+ */
+export declare type Shuntsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
+    readonly type: typeof MentsuType.Shuntsu;
+    readonly hais: readonly [T, T, T];
+    readonly furo?: Furo;
+};
+
+/**
+ * 他家 (Tacha)
+ *
+ * 自分から見た他家の位置関係（相対席）。
+ * 副露（鳴き）の発生元などを表現するために使用する。
+ *
+ * - 1: 下家 (Shimocha) - 右側
+ * - 2: 対面 (Toimen) - 正面
+ * - 3: 上家 (Kamicha) - 左側
+ */
+export declare const Tacha: {
+    readonly Shimocha: 1;
+    readonly Toimen: 2;
+    readonly Kamicha: 3;
+};
+
+export declare type Tacha = (typeof Tacha)[keyof typeof Tacha];
+
+/**
+ * 切り忘れの場合のエラー (多牌)
+ * 手牌が規定枚数（13枚）より多い場合にスローされます。
+ */
+export declare class TahaiError extends MahjongError {
+    /**
+     *
+     */
+    constructor(message?: string);
+}
+
+/**
+ * 塔子 (Tatsu)
+ */
+declare type Tatsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
+    readonly type: typeof MentsuType.Tatsu;
+    readonly hais: readonly [T, T];
+    readonly furo?: never;
+};
+
+/**
+ * 手牌 (Tehai)
+ *
+ * 純手牌と副露を合わせたもの。
+ * @template T 牌の型 (HaiKindId | HaiId)
+ */
+export declare interface Tehai<T extends HaiKindId | HaiId = HaiKindId> {
+    readonly closed: readonly T[];
+    readonly exposed: readonly CompletedMentsu<T>[];
+}
+
+/**
+ * ツモる前の手牌 (13枚)
+ */
+export declare type Tehai13<T extends HaiKindId | HaiId = HaiKindId> = Tehai<T>;
+
+/**
+ * ツモった後の手牌 (14枚)
+ */
+export declare type Tehai14<T extends HaiKindId | HaiId = HaiKindId> = Tehai<T>;
+
+/**
+ * 手牌役 (TehaiYaku)
+ *
+ * 手牌役（手牌の構成のみで成立する役）の識別子。
+ * 偶然役（嶺上開花など）や状況役（場風、自風、立直など）は含まない。
+ */
+declare type TehaiYaku = "Tanyao" | "Pinfu" | "Iipeikou" | Yakuhai | "SanshokuDoujun" | "Ikkitsuukan" | "Honchan" | "Chiitoitsu" | "Toitoi" | "Sanankou" | "Sankantsu" | "SanshokuDoukou" | "Honroutou" | "Shousangen" | "Honitsu" | "Junchan" | "Ryanpeikou" | "Chinitsu" | "KokushiMusou" | "Suuankou" | "Daisangen" | "Shousuushii" | "Daisuushii" | "Tsuuiisou" | "Chinroutou" | "Ryuuiisou" | "ChuurenPoutou" | "Suukantsu" | "MenzenTsumo";
+
+/**
+ * 対子 (Toitsu)
+ */
+declare type Toitsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
+    readonly type: typeof MentsuType.Toitsu;
+    readonly hais: readonly [T, T];
+    readonly furo?: never;
+};
+
+/**
+ * 手牌がTehai13またはTehai14（有効枚数が13または14枚）であるか検証します。
+ * シャンテン計算や待ち判定など、13枚/14枚の区別なく手牌として扱いたい場合に使用します。
+ *
+ * @throws {ShoushaiError} 枚数が不足している場合 (< 13)
+ * @throws {TahaiError} 枚数が超過している場合 (> 14)
+ * @throws {InvalidHaiQuantityError} 同一種の牌が5枚以上ある場合
+ * @throws {DuplicatedHaiIdError} 物理牌モードでIDが重複している場合
+ */
+export declare function validateTehai<T extends HaiKindId | HaiId>(tehai: Tehai<T>): void;
+
+/**
+ * 役牌 (Yakuhai)
+ *
+ * 構造的に成立する三元牌。
+ * ※場風・自風は状況役（Bakaze, Jikaze）として別途定義するためここには含めない。
+ */
+declare type Yakuhai = "Haku" | "Hatsu" | "Chun";
+
+/**
+ * 役ID (YakuName)
+ *
+ * 全ての役の識別子ユニオン。
+ */
+export declare type YakuName = TehaiYaku;
+
+/**
+ * 役判定結果 (YakuResult)
+ *
+ * 成立した役と、その翻数のペアのリスト。
+ * 役が一つも成立しない場合は空配列となる。
+ */
+export declare type YakuResult = readonly [YakuName, Hansu][];
+
+/**
+ * 么九牌（1,9,字牌）の牌種IDセット
+ */
+export declare const YAOCHU_KIND_IDS: readonly [0, 8, 9, 17, 18, 26, 27, 28, 29, 30, 31, 32, 33];
+
+export { }