@pai-forge/riichi-mahjong 0.3.5 → 0.3.6

package/dist/index.d.ts

@@ -1,25 +1,9 @@
+import { Result } from 'neverthrow';
+
 declare const __tehai13Brand: unique symbol;
 
 declare const __tehai14Brand: unique symbol;
 
-/**
- * 手牌がTehai13（有効枚数13枚）であることを表明します。
- * バリデーション成功後、引数を Tehai13 型にナローイングします。
- * @throws {ShoushaiError} 枚数が不足している場合
- * @throws {TahaiError} 枚数が超過している場合
- */
-export declare function assertTehai13<T extends HaiKindId | HaiId>(tehai: Tehai<T>): asserts tehai is Tehai13<T>;
-
-/**
- * 手牌がTehai14（有効枚数14枚）であることを表明します。
- * バリデーション成功後、引数を Tehai14 型にナローイングします。
- * @throws {ShoushaiError} 枚数が不足している場合
- * @throws {TahaiError} 枚数が超過している場合
- * @throws {InvalidHaiQuantityError} 同一種の牌が5枚以上ある場合
- * @throws {DuplicatedHaiIdError} 物理牌モードでIDが重複している場合
- */
-export declare function assertTehai14<T extends HaiKindId | HaiId>(tehai: Tehai<T>): asserts tehai is Tehai14<T>;
-
 /**
  * 基本的な面子構造 (ジェネリック)
  *
@@ -62,7 +46,7 @@ export declare function calculateScoreForTehai(tehai: Tehai14, config: Readonly<
  * @param tehai 手牌
  * @returns シャンテン数
  */
-export declare function calculateShanten(tehai: Tehai13, useChiitoitsu?: boolean, useKokushi?: boolean): number;
+export declare function calculateShanten(tehai: Tehai13, useChiitoitsu?: boolean, useKokushi?: boolean): Result<number, TehaiError>;
 
 /**
  * 七対子の和了構造 (ChiitoitsuHouraStructure)
@@ -664,7 +648,7 @@ export declare interface OyaTsumo {
  * @param input 拡張MSPZ形式の文字列
  * @returns 手牌オブジェクト
  */
-export declare function parseExtendedMspz(input: string): Tehai;
+export declare function parseExtendedMspz(input: string): Result<Tehai, MspzParseError>;
 
 /**
  * 標準的なMSPZ文字列（例: "123m456p..."）を解析して手牌オブジェクトを生成します。
@@ -673,7 +657,7 @@ export declare function parseExtendedMspz(input: string): Tehai;
  * @param input MSPZ形式の文字列
  * @returns 手牌オブジェクト
  */
-export declare function parseMspz(input: string): Tehai;
+export declare function parseMspz(input: string): Result<Tehai, MspzParseError>;
 
 /** 支払い情報 */
 export declare type Payment = Ron | KoTsumo | OyaTsumo;
@@ -868,6 +852,8 @@ export declare interface Tehai14<T extends HaiKindId | HaiId = HaiKindId> extend
     readonly [__tehai14Brand]: never;
 }
 
+declare type TehaiError = ShoushaiError | TahaiError | InvalidHaiQuantityError | DuplicatedHaiIdError;
+
 /**
  * 手牌役 (TehaiYaku)
  *
@@ -886,15 +872,21 @@ declare type Toitsu<T extends HaiKindId | HaiId = HaiKindId> = BaseMentsu<T> & {
 };
 
 /**
- * 手牌が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;
+export declare function validateTehai<T extends HaiKindId | HaiId>(tehai: Tehai<T>): Result<Tehai<T>, TehaiError>;
+
+/**
+ * 手牌がTehai13（有効枚数13枚）であるか検証し、スマートコンストラクタとして機能します。
+ * バリデーション成功後、Tehai13 型にナローイングされたオブジェクトをResultで返します。
+ */
+export declare function validateTehai13<T extends HaiKindId | HaiId>(tehai: Tehai<T>): Result<Tehai13<T>, TehaiError>;
+
+/**
+ * 手牌がTehai14（有効枚数14枚）であるか検証し、スマートコンストラクタとして機能します。
+ * バリデーション成功後、Tehai14 型にナローイングされたオブジェクトをResultで返します。
+ */
+export declare function validateTehai14<T extends HaiKindId | HaiId>(tehai: Tehai<T>): Result<Tehai14<T>, TehaiError>;
 
 /**
  * 役牌 (Yakuhai)