liuyao 0.1.0 → 0.2.0

package/README.md

@@ -6,11 +6,11 @@ For more packages, see [my homepage](https://baendlorel.github.io/?repoType=npm)
 
 ## Features
 
-- Create a yao from its yang-count representation.
-- Build a hexagram from six yao lines or from a known hexagram name.
+- Create a yao from its Yang-count representation, quaternary or various arguments.
+- Build a hexagram from six Yao lines or from a known hexagram name.
 - Inspect hexagram metadata such as its name, palace, phase, and setup information.
 - Derive the changed hexagram for dynamic lines.
-- Access six-god ordering data for different heavenly stems.
+- Access Six God ordering data for different heavenly stems.
 
 ## Installation
 
@@ -23,16 +23,9 @@ pnpm add liuyao
 ```ts
 import { Hexagram, Yao, SixGodList } from 'liuyao';
 
-const hexagram = Hexagram.fromYaos([
-	new Yao(3),
-	new Yao(1),
-	new Yao(2),
-	new Yao(2),
-	new Yao(1),
-	new Yao(0),
-]);
+const hexagram = Hexagram.fromQuaternary('111222'); // gets a Hexagram instance of '地天泰'
 
-if (!hexagram) {
+if (hexagram === null) {
 	throw new Error('Invalid hexagram');
 }
 
@@ -101,11 +94,19 @@ Useful factory methods:
 
 The package currently exports:
 
+**Classes:**
 - `Hexagram`
 - `Yao`
-- `YaoIndex`
-- `SixGodList`
+
+**Data Lists:**
+- `HexagramList`(六十四卦): Includes 64 static hexagram info objects with traditional metadata.
+- `HexagramYaoIndex`(六十四卦爻位名)
+- `TrigramList`(八卦): Includes 8 static trigram info objects with traditional metadata.
+- `SixGodList`(六神表)
+
+**Types:**
 - type `SixGod`
+- type `SixGodInfo`
 - type `SetupGramInfo`
 
 ## Notes

package/dist/index.d.ts

@@ -30,7 +30,7 @@ interface PalaceIndexName {
     name: string;
     nameEn: string;
 }
-declare const PalaceIndexList: PalaceIndexName[];
+declare const PalaceIndexTable: PalaceIndexName[];
 interface HexagramInfo {
     /**
      * Binary representation of the hexagram, where 0 represents a yin line and 1 represents a yang line. The lines are ordered from the bottom (first line) to the top (sixth line).
@@ -82,7 +82,7 @@ interface HexagramInfo {
      */
     setupInfo: [SetupGramInfo, SetupGramInfo, SetupGramInfo, SetupGramInfo, SetupGramInfo, SetupGramInfo];
 }
-declare const HexagramList: readonly HexagramInfo[];
+declare const HexagramInfoTable: readonly HexagramInfo[];
 interface TrigramInfo {
     /**
      * Presents the trigram as a 3-digit binary string. 1 represents a Yang line and 0 represents a Yin line.
@@ -118,7 +118,7 @@ interface TrigramInfo {
 /**
  * List of all trigrams in the I Ching, with their binary representation, number of yang lines, name, what they represent, and their corresponding sign.
  */
-declare const TrigramList: readonly TrigramInfo[];
+declare const TrigramInfoTable: readonly TrigramInfo[];
 
 type SixGod = '玄武' | '白虎' | '螣蛇' | '勾陈' | '朱雀' | '青龙';
 interface SixGodInfo {
@@ -145,7 +145,7 @@ interface SixGodInfo {
 /**
  * @see 《增删卜易·六神章》
  */
-declare const SixGodList: readonly SixGodInfo[];
+declare const SixGodTable: readonly SixGodInfo[];
 
 declare class Yao {
     static getName(yangCount: number): "老阴" | "少阳" | "少阴" | "老阳";
@@ -226,7 +226,7 @@ declare class Yao {
 }
 
 type LiuYao = [Yao, Yao, Yao, Yao, Yao, Yao];
-declare const YaoIndex: readonly ["初爻", "二爻", "三爻", "四爻", "五爻", "上爻"];
+declare const HexagramYaoOrder: readonly ["初爻", "二爻", "三爻", "四爻", "五爻", "上爻"];
 /**
  * Hexagram class represents a hexagram, which consists of 6 Yao.
  * - Each Yao can be either yin or yang, and can be changing or not.
@@ -237,7 +237,7 @@ declare class Hexagram {
     /**
      * Use tokens like `'012132'` to create a Hexagram, where each digit represents the count of Yang in the corresponding Yao (0 for 老阴, 1 for 少阳, 2 for 少阴, 3 for 老阳). The first digit represents the first Yao (初爻) and the last digit represents the sixth Yao (上爻).
      */
-    static fromBinary(quaternary: string): Hexagram | null;
+    static fromQuaternary(quaternary: string): Hexagram | null;
     /**
      * Use tokens like `'单单拆拆重重'` to create a Hexagram.
      *
@@ -292,11 +292,32 @@ declare class Hexagram {
      * - e.g.：“本卦乾为天，变卦坤为地，动爻：初爻、三爻”
      */
     toDescription(): string;
-    toDescriptionEn(): string;
+    /**
+     * This output is meant for AI skills.
+     */
+    toAIReadable(): {
+        本卦: HexagramAIReadable<'本卦'>;
+        变卦: HexagramAIReadable<'变卦'> | null;
+    };
     clone(): Hexagram;
     toString(): string;
-    [Symbol.toPrimitive](hint: string): string;
+    [Symbol.toPrimitive](): string;
+}
+interface YaoInfo {
+    爻象: string;
+    类型: '世' | '应' | null;
+    六亲五行: string;
+}
+interface HexagramAIReadable<T extends '本卦' | '变卦'> {
+    初爻: YaoInfo;
+    二爻: YaoInfo;
+    三爻: YaoInfo;
+    四爻: YaoInfo;
+    五爻: YaoInfo;
+    上爻: YaoInfo;
+    卦名: string;
+    变爻?: string[];
 }
 
-export { Hexagram, HexagramList, PalaceIndexList, SixGodList, TrigramList, Yao, YaoIndex };
+export { Hexagram, HexagramInfoTable, HexagramYaoOrder, PalaceIndexTable, SixGodTable, TrigramInfoTable, Yao };
 export type { HexagramInfo, SetupGramInfo, SixGod, SixGodInfo, TrigramInfo };

package/dist/index.mjs

@@ -1655,7 +1655,7 @@ class h {
 const r = [ "初爻", "二爻", "三爻", "四爻", "五爻", "上爻" ];
 
 class l {
-  static fromBinary(n) {
+  static fromQuaternary(n) {
     const i = n.split("").map(h.fromDigitString);
     return i.every(n => null !== n) ? new l(i) : null;
   }
@@ -1708,14 +1708,88 @@ class l {
     return new l(this.yaos.map(n => n.toChanged()));
   }
   toDescription() {
-    const n = [ `本卦${this.info.id}` ], i = this.toChanged();
-    return i ? (n.push(`变卦${i.info.id}`), n.push(`动爻：${this.yaos.map((n, i) => n.isDynamic ? `${r[i]}` : null).filter(n => null !== n).join("、")}`)) : n.push("无动爻"), 
-    n.join("，");
+    const n = this.info.setupInfo.findIndex(n => "世" === n.hostGuest), i = this.info.setupInfo.findIndex(n => "应" === n.hostGuest), e = [ `本卦${this.info.id}`, `世爻为${r[n]}`, `应爻为${r[i]}` ], s = this.toChanged();
+    if (s) {
+      e.push(`${this.yaos.map((n, i) => n.isDynamic ? `${r[i]}` : null).filter(n => null !== n).join("、")}是动爻`), 
+      e.push(`变卦为${s.info.id}`);
+      const n = s.info.setupInfo.findIndex(n => "世" === n.hostGuest);
+      this.yaos[n].isDynamic ? e.push(`变卦世爻为${r[n]}`) : e.push("未变出新的世爻");
+      const i = s.info.setupInfo.findIndex(n => "应" === n.hostGuest);
+      this.yaos[i].isDynamic ? e.push(`变卦应爻为${r[i]}`) : e.push("未变出新的应爻");
+    } else e.push("无动爻");
+    return e.join("，");
   }
-  toDescriptionEn() {
-    const n = [ `Original Hexagram ${this.info.id}` ], i = this.toChanged();
-    return i ? (n.push(`Changed Hexagram ${i.info.id}`), n.push(`Dynamic Yaos: ${this.yaos.map((n, i) => n.isDynamic ? `${r[i]}` : null).filter(n => null !== n).join(", ")}`)) : n.push("No dynamic Yao"), 
-    n.join(", ");
+  toAIReadable() {
+    const n = this.info.setupInfo, i = this.toChanged(), e = i?.info.setupInfo;
+    return {
+      "本卦": {
+        "初爻": {
+          "爻象": this.yaos[0].name,
+          "类型": n[0].hostGuest || null,
+          "六亲五行": n[0].kin
+        },
+        "二爻": {
+          "爻象": this.yaos[1].name,
+          "类型": n[1].hostGuest || null,
+          "六亲五行": n[1].kin
+        },
+        "三爻": {
+          "爻象": this.yaos[2].name,
+          "类型": n[2].hostGuest || null,
+          "六亲五行": n[2].kin
+        },
+        "四爻": {
+          "爻象": this.yaos[3].name,
+          "类型": n[3].hostGuest || null,
+          "六亲五行": n[3].kin
+        },
+        "五爻": {
+          "爻象": this.yaos[4].name,
+          "类型": n[4].hostGuest || null,
+          "六亲五行": n[4].kin
+        },
+        "上爻": {
+          "爻象": this.yaos[5].name,
+          "类型": n[5].hostGuest || null,
+          "六亲五行": n[5].kin
+        },
+        "卦名": this.info.id,
+        "变爻": this.isDynamic ? this.yaos.map((n, i) => n.isDynamic ? r[i] : null).filter(n => null !== n) : void 0
+      },
+      "变卦": e ? {
+        "初爻": {
+          "爻象": i.yaos[0].name,
+          "类型": e[0].hostGuest || null,
+          "六亲五行": e[0].kin
+        },
+        "二爻": {
+          "爻象": i.yaos[1].name,
+          "类型": e[1].hostGuest || null,
+          "六亲五行": e[1].kin
+        },
+        "三爻": {
+          "爻象": i.yaos[2].name,
+          "类型": e[2].hostGuest || null,
+          "六亲五行": e[2].kin
+        },
+        "四爻": {
+          "爻象": i.yaos[3].name,
+          "类型": e[3].hostGuest || null,
+          "六亲五行": e[3].kin
+        },
+        "五爻": {
+          "爻象": i.yaos[4].name,
+          "类型": e[4].hostGuest || null,
+          "六亲五行": e[4].kin
+        },
+        "上爻": {
+          "爻象": i.yaos[5].name,
+          "类型": e[5].hostGuest || null,
+          "六亲五行": e[5].kin
+        },
+        "卦名": i.info.id
+      } : null
+    };
   }
   clone() {
     return new l(this.yaos);
@@ -1723,9 +1797,9 @@ class l {
   toString() {
     return this.info.id;
   }
-  [Symbol.toPrimitive](n) {
+  [Symbol.toPrimitive]() {
     return this.info.id;
   }
 }
 
-export { l as Hexagram, i as HexagramList, n as PalaceIndexList, s as SixGodList, e as TrigramList, h as Yao, r as YaoIndex };
+export { l as Hexagram, i as HexagramInfoTable, r as HexagramYaoOrder, n as PalaceIndexTable, s as SixGodTable, e as TrigramInfoTable, h as Yao };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "liuyao",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": {
     "name": "Kasukabe Tsumugi",
     "email": "futami16237@gmail.com"