@octo-cyber/kinship-calc 0.5.2

package/dist/engine/kinship-engine.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Kinship Engine — core calculation logic.
+ *
+ * Given a relation path (sequence of atoms) and ego's gender,
+ * returns the appropriate Chinese kinship title with regional variants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateKinship = calculateKinship;
+exports.detectGenerationConflict = detectGenerationConflict;
+const kinship_data_js_1 = require("./kinship-data.js");
+const relation_path_js_1 = require("./relation-path.js");
+/**
+ * Calculate the kinship title for a given relation path.
+ * @param path dot-separated atom path, e.g. "F.B-.W"
+ * @param options region and ego gender
+ */
+function calculateKinship(path, options = {}) {
+    const { region = 'standard', egoGender = 'male' } = options;
+    const atoms = (0, relation_path_js_1.decodePath)(path);
+    const lastAtom = atoms[atoms.length - 1] ?? '';
+    const entry = kinship_data_js_1.KINSHIP_LOOKUP.get(path);
+    const generationDelta = (0, relation_path_js_1.pathGenerationDelta)(path);
+    const relativeGender = (0, relation_path_js_1.atomGender)(lastAtom);
+    if (entry) {
+        return buildResult(path, entry, region, egoGender, generationDelta, relativeGender, true);
+    }
+    // Try to find approximate match via substitution rules
+    const approximated = approximatePath(path, region, egoGender, generationDelta, relativeGender);
+    if (approximated)
+        return approximated;
+    // Fallback to generation-based generic description
+    return buildGenericResult(path, generationDelta, relativeGender, egoGender);
+}
+function buildResult(path, entry, region, egoGender, generationDelta, relativeGender, isExact) {
+    const title = resolveRegionalTitle(entry, region) ?? entry.standard;
+    const reverseRaw = entry.reverse ?? null;
+    const reverseTitle = resolveReverseTitle(reverseRaw, egoGender);
+    const variants = {
+        standard: entry.standard,
+    };
+    if (entry.northern)
+        variants.northern = entry.northern;
+    if (entry.southern)
+        variants.southern = entry.southern;
+    if (entry.cantonese)
+        variants.cantonese = entry.cantonese;
+    if (entry.minnan)
+        variants.minnan = entry.minnan;
+    if (entry.wu)
+        variants.wu = entry.wu;
+    return {
+        path,
+        title,
+        standardTitle: entry.standard,
+        reverseTitle,
+        generationDelta,
+        relativeGender,
+        isExact,
+        note: entry.note ?? null,
+        variants,
+    };
+}
+/** Resolve the best title for a region, falling back to standard */
+function resolveRegionalTitle(entry, region) {
+    if (region === 'northern' && entry.northern)
+        return entry.northern;
+    if (region === 'southern' && entry.southern)
+        return entry.southern;
+    if (region === 'cantonese' && entry.cantonese)
+        return entry.cantonese;
+    if (region === 'minnan' && entry.minnan)
+        return entry.minnan;
+    if (region === 'wu' && entry.wu)
+        return entry.wu;
+    return null;
+}
+/** "孙子/孙女" → pick by ego gender */
+function resolveReverseTitle(raw, egoGender) {
+    if (!raw)
+        return null;
+    if (raw.includes('/')) {
+        const [male, female] = raw.split('/');
+        return egoGender === 'female' ? female : male;
+    }
+    return raw;
+}
+/**
+ * Try to approximate a title for unknown paths using heuristic rules.
+ * Examples:
+ * - "B+.B+" → treat as another sibling (堂兄 / older male)
+ * - Very deep ancestor → "先祖" + generation count
+ */
+function approximatePath(path, region, egoGender, generationDelta, relativeGender) {
+    // Try removing H/W spouses from end and see if the bare path exists
+    const atoms = (0, relation_path_js_1.decodePath)(path);
+    if (atoms.length >= 2) {
+        const lastTwo = atoms.slice(-2);
+        if (lastTwo[1] === 'W' || lastTwo[1] === 'H') {
+            // Parent + spouse: e.g. "F.B+.W" → try the spouse rule
+            const parentPath = atoms.slice(0, -1).join('.');
+            const parentEntry = kinship_data_js_1.KINSHIP_LOOKUP.get(parentPath);
+            if (parentEntry) {
+                const spouseGender = lastTwo[1] === 'W' ? 'female' : 'male';
+                const spouseTitle = deriveSpouseTitle(parentEntry.standard, spouseGender);
+                if (spouseTitle) {
+                    return {
+                        path,
+                        title: spouseTitle,
+                        standardTitle: spouseTitle,
+                        reverseTitle: null,
+                        generationDelta,
+                        relativeGender: spouseGender,
+                        isExact: false,
+                        note: `${parentEntry.standard}的配偶`,
+                        variants: { standard: spouseTitle },
+                    };
+                }
+            }
+        }
+    }
+    return null;
+}
+/** Derive spouse title from a relative's title */
+function deriveSpouseTitle(relativeTitle, spouseGender) {
+    const maleTitles = {
+        '姐姐': '姐夫', '妹妹': '妹夫', '女儿': '女婿',
+        '伯母': '伯父', '婶母': '叔父', '舅母': '舅父',
+        '姑母': '姑父', '姨母': '姨父',
+    };
+    const femaleTitles = {
+        '哥哥': '嫂子', '弟弟': '弟媳', '儿子': '儿媳妇',
+        '伯父': '伯母', '叔父': '婶母', '舅父': '舅母',
+        '姑父': '姑母',
+    };
+    return spouseGender === 'male'
+        ? (maleTitles[relativeTitle] ?? null)
+        : (femaleTitles[relativeTitle] ?? null);
+}
+/** Generic fallback for unrecognized deep paths */
+function buildGenericResult(path, generationDelta, relativeGender, egoGender) {
+    let title;
+    if (generationDelta > 3) {
+        title = relativeGender === 'female' ? `先祖${generationDelta}代女` : `先祖${generationDelta}代`;
+    }
+    else if (generationDelta < -3) {
+        const gen = Math.abs(generationDelta);
+        title = relativeGender === 'female' ? `第${gen}代孙女` : `第${gen}代孙`;
+    }
+    else if (generationDelta === 0) {
+        title = relativeGender === 'female' ? '同辈女性亲属' : '同辈男性亲属';
+    }
+    else {
+        title = '未知亲属关系';
+    }
+    return {
+        path,
+        title,
+        standardTitle: title,
+        reverseTitle: null,
+        generationDelta,
+        relativeGender,
+        isExact: false,
+        note: '无法精确匹配，请检查关系链',
+        variants: { standard: title },
+    };
+}
+/**
+ * Detect generational conflict — returns true if the path creates an
+ * impossible or paradoxical family structure.
+ * Example: ego being uncle AND father to the same person would be a conflict.
+ */
+function detectGenerationConflict(paths) {
+    if (paths.length < 2)
+        return null;
+    const deltas = paths.map(relation_path_js_1.pathGenerationDelta);
+    const [delta0, delta1] = [deltas[0], deltas[1]];
+    // If two paths describe the same person but differ by more than one generation
+    if (delta0 !== undefined && delta1 !== undefined && Math.abs(delta0 - delta1) > 1) {
+        return `辈分冲突：两条路径的辈分差为 ${Math.abs(delta0 - delta1)} 代，请检查关系链`;
+    }
+    return null;
+}
+//# sourceMappingURL=kinship-engine.js.map

package/dist/engine/kinship-engine.js.map

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

package/dist/engine/relation-path.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Relation Path Encoding
+ *
+ * Each basic relation is encoded as a short atom:
+ *   F  = father (父)
+ *   M  = mother (母)
+ *   S  = son (子)
+ *   D  = daughter (女儿)
+ *   B+ = elder brother (兄)
+ *   B- = younger brother (弟)
+ *   Z+ = elder sister (姐)
+ *   Z- = younger sister (妹)
+ *   H  = husband (夫)
+ *   W  = wife (妻)
+ *
+ * A path is a sequence of atoms separated by dots, e.g.:
+ *   "F"      = father
+ *   "F.F"    = paternal grandfather
+ *   "M.F"    = maternal grandfather
+ *   "F.B+"   = father's elder brother (伯父)
+ *   "F.B-.W" = father's younger brother's wife (婶婶)
+ *
+ * Gender of ego is passed separately because it affects some reverse titles.
+ */
+export type RelationAtom = 'F' | 'M' | 'S' | 'D' | 'B+' | 'B-' | 'Z+' | 'Z-' | 'H' | 'W' | 'FF' | 'FM' | 'MF' | 'MM';
+export type EgoGender = 'male' | 'female';
+/** Encode a chain of atom strings into a canonical path string */
+export declare function encodePath(atoms: string[]): string;
+/** Decode a path string into atom array */
+export declare function decodePath(path: string): string[];
+/** Return the gender implied by the final atom */
+export declare function atomGender(atom: string): 'male' | 'female' | 'unknown';
+/** Generation delta of a single atom (+1 = elder generation, -1 = younger) */
+export declare function atomGenerationDelta(atom: string): number;
+/** Total generation delta for a path */
+export declare function pathGenerationDelta(path: string): number;
+//# sourceMappingURL=relation-path.d.ts.map

package/dist/engine/relation-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-path.d.ts","sourceRoot":"","sources":["../../src/engine/relation-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,YAAY,GACpB,GAAG,GAAG,GAAG,GACT,GAAG,GAAG,GAAG,GACT,IAAI,GAAG,IAAI,GACX,IAAI,GAAG,IAAI,GACX,GAAG,GAAG,GAAG,GACT,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE7B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEzC,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAElD;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAItE;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/engine/relation-path.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Relation Path Encoding
+ *
+ * Each basic relation is encoded as a short atom:
+ *   F  = father (父)
+ *   M  = mother (母)
+ *   S  = son (子)
+ *   D  = daughter (女儿)
+ *   B+ = elder brother (兄)
+ *   B- = younger brother (弟)
+ *   Z+ = elder sister (姐)
+ *   Z- = younger sister (妹)
+ *   H  = husband (夫)
+ *   W  = wife (妻)
+ *
+ * A path is a sequence of atoms separated by dots, e.g.:
+ *   "F"      = father
+ *   "F.F"    = paternal grandfather
+ *   "M.F"    = maternal grandfather
+ *   "F.B+"   = father's elder brother (伯父)
+ *   "F.B-.W" = father's younger brother's wife (婶婶)
+ *
+ * Gender of ego is passed separately because it affects some reverse titles.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodePath = encodePath;
+exports.decodePath = decodePath;
+exports.atomGender = atomGender;
+exports.atomGenerationDelta = atomGenerationDelta;
+exports.pathGenerationDelta = pathGenerationDelta;
+/** Encode a chain of atom strings into a canonical path string */
+function encodePath(atoms) {
+    return atoms.join('.');
+}
+/** Decode a path string into atom array */
+function decodePath(path) {
+    return path.split('.');
+}
+/** Return the gender implied by the final atom */
+function atomGender(atom) {
+    if (['F', 'S', 'B+', 'B-', 'H', 'FF', 'MF'].includes(atom))
+        return 'male';
+    if (['M', 'D', 'Z+', 'Z-', 'W', 'FM', 'MM'].includes(atom))
+        return 'female';
+    return 'unknown';
+}
+/** Generation delta of a single atom (+1 = elder generation, -1 = younger) */
+function atomGenerationDelta(atom) {
+    if (['F', 'M', 'FF', 'FM', 'MF', 'MM'].includes(atom))
+        return 1;
+    if (['S', 'D'].includes(atom))
+        return -1;
+    return 0; // siblings, spouses
+}
+/** Total generation delta for a path */
+function pathGenerationDelta(path) {
+    return decodePath(path).reduce((sum, atom) => sum + atomGenerationDelta(atom), 0);
+}
+//# sourceMappingURL=relation-path.js.map

package/dist/engine/relation-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-path.js","sourceRoot":"","sources":["../../src/engine/relation-path.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAaH,gCAEC;AAGD,gCAEC;AAGD,gCAIC;AAGD,kDAIC;AAGD,kDAEC;AA3BD,kEAAkE;AAClE,SAAgB,UAAU,CAAC,KAAe;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,2CAA2C;AAC3C,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,kDAAkD;AAClD,SAAgB,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACzE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC3E,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,8EAA8E;AAC9E,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IAC/D,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAA;IACxC,OAAO,CAAC,CAAA,CAAC,oBAAoB;AAC/B,CAAC;AAED,wCAAwC;AACxC,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACnF,CAAC"}

package/dist/entities/family-tree-person.entity.d.ts

@@ -0,0 +1,12 @@
+export type PersonGender = 'male' | 'female';
+export declare class FamilyTreePerson {
+    id: number;
+    treeId: number;
+    name: string;
+    gender: PersonGender;
+    birthYear: number | null;
+    notes: string | null;
+    isRoot: boolean;
+    createdAt: Date;
+}
+//# sourceMappingURL=family-tree-person.entity.d.ts.map

package/dist/entities/family-tree-person.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree-person.entity.d.ts","sourceRoot":"","sources":["../../src/entities/family-tree-person.entity.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5C,qBAEa,gBAAgB;IAE3B,EAAE,EAAG,MAAM,CAAA;IAGX,MAAM,EAAG,MAAM,CAAA;IAGf,IAAI,EAAG,MAAM,CAAA;IAGb,MAAM,EAAG,YAAY,CAAA;IAGrB,SAAS,EAAG,MAAM,GAAG,IAAI,CAAA;IAGzB,KAAK,EAAG,MAAM,GAAG,IAAI,CAAA;IAGrB,MAAM,EAAG,OAAO,CAAA;IAGhB,SAAS,EAAG,IAAI,CAAA;CACjB"}

package/dist/entities/family-tree-person.entity.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FamilyTreePerson = void 0;
+const core_1 = require("@octo-cyber/core");
+let FamilyTreePerson = class FamilyTreePerson {
+    id;
+    treeId;
+    name;
+    gender;
+    birthYear;
+    notes;
+    isRoot;
+    createdAt;
+};
+exports.FamilyTreePerson = FamilyTreePerson;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], FamilyTreePerson.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'tree_id' }),
+    __metadata("design:type", Number)
+], FamilyTreePerson.prototype, "treeId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 50 }),
+    __metadata("design:type", String)
+], FamilyTreePerson.prototype, "name", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 10 }),
+    __metadata("design:type", String)
+], FamilyTreePerson.prototype, "gender", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', nullable: true, name: 'birth_year' }),
+    __metadata("design:type", Object)
+], FamilyTreePerson.prototype, "birthYear", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], FamilyTreePerson.prototype, "notes", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'boolean', default: false, name: 'is_root' }),
+    __metadata("design:type", Boolean)
+], FamilyTreePerson.prototype, "isRoot", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], FamilyTreePerson.prototype, "createdAt", void 0);
+exports.FamilyTreePerson = FamilyTreePerson = __decorate([
+    (0, core_1.Entity)('kinship_family_tree_person'),
+    (0, core_1.Index)(['treeId'])
+], FamilyTreePerson);
+//# sourceMappingURL=family-tree-person.entity.js.map

package/dist/entities/family-tree-person.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree-person.entity.js","sourceRoot":"","sources":["../../src/entities/family-tree-person.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAMyB;AAMlB,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAE3B,EAAE,CAAS;IAGX,MAAM,CAAS;IAGf,IAAI,CAAS;IAGb,MAAM,CAAe;IAGrB,SAAS,CAAgB;IAGzB,KAAK,CAAgB;IAGrB,MAAM,CAAU;IAGhB,SAAS,CAAO;CACjB,CAAA;AAxBY,4CAAgB;AAE3B;IADC,IAAA,6BAAsB,GAAE;;4CACd;AAGX;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;gDAC9B;AAGf;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;8CAC3B;AAGb;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;gDACnB;AAGrB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;;mDACvC;AAGzB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACpB;AAGrB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;gDAC7C;AAGhB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;mDAAA;2BAvBL,gBAAgB;IAF5B,IAAA,aAAM,EAAC,4BAA4B,CAAC;IACpC,IAAA,YAAK,EAAC,CAAC,QAAQ,CAAC,CAAC;GACL,gBAAgB,CAwB5B"}

package/dist/entities/family-tree-relation.entity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Directed edge: fromPersonId → toPersonId with relationType.
+ * relationType is a basic atom code such as 'father', 'mother', 'son', 'daughter',
+ * 'elder-brother', 'younger-brother', 'elder-sister', 'younger-sister',
+ * 'husband', 'wife'.
+ */
+export declare class FamilyTreeRelation {
+    id: number;
+    treeId: number;
+    fromPersonId: number;
+    toPersonId: number;
+    relationType: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=family-tree-relation.entity.d.ts.map

package/dist/entities/family-tree-relation.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree-relation.entity.d.ts","sourceRoot":"","sources":["../../src/entities/family-tree-relation.entity.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,qBAGa,kBAAkB;IAE7B,EAAE,EAAG,MAAM,CAAA;IAGX,MAAM,EAAG,MAAM,CAAA;IAGf,YAAY,EAAG,MAAM,CAAA;IAGrB,UAAU,EAAG,MAAM,CAAA;IAGnB,YAAY,EAAG,MAAM,CAAA;IAGrB,SAAS,EAAG,IAAI,CAAA;CACjB"}

package/dist/entities/family-tree-relation.entity.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FamilyTreeRelation = void 0;
+const core_1 = require("@octo-cyber/core");
+/**
+ * Directed edge: fromPersonId → toPersonId with relationType.
+ * relationType is a basic atom code such as 'father', 'mother', 'son', 'daughter',
+ * 'elder-brother', 'younger-brother', 'elder-sister', 'younger-sister',
+ * 'husband', 'wife'.
+ */
+let FamilyTreeRelation = class FamilyTreeRelation {
+    id;
+    treeId;
+    fromPersonId;
+    toPersonId;
+    relationType;
+    createdAt;
+};
+exports.FamilyTreeRelation = FamilyTreeRelation;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], FamilyTreeRelation.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'tree_id' }),
+    __metadata("design:type", Number)
+], FamilyTreeRelation.prototype, "treeId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'from_person_id' }),
+    __metadata("design:type", Number)
+], FamilyTreeRelation.prototype, "fromPersonId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'to_person_id' }),
+    __metadata("design:type", Number)
+], FamilyTreeRelation.prototype, "toPersonId", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 30, name: 'relation_type' }),
+    __metadata("design:type", String)
+], FamilyTreeRelation.prototype, "relationType", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], FamilyTreeRelation.prototype, "createdAt", void 0);
+exports.FamilyTreeRelation = FamilyTreeRelation = __decorate([
+    (0, core_1.Entity)('kinship_family_tree_relation'),
+    (0, core_1.Index)(['treeId', 'fromPersonId']),
+    (0, core_1.Index)(['treeId', 'toPersonId'])
+], FamilyTreeRelation);
+//# sourceMappingURL=family-tree-relation.entity.js.map

package/dist/entities/family-tree-relation.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree-relation.entity.js","sourceRoot":"","sources":["../../src/entities/family-tree-relation.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAMyB;AAEzB;;;;;GAKG;AAII,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAE7B,EAAE,CAAS;IAGX,MAAM,CAAS;IAGf,YAAY,CAAS;IAGrB,UAAU,CAAS;IAGnB,YAAY,CAAS;IAGrB,SAAS,CAAO;CACjB,CAAA;AAlBY,gDAAkB;AAE7B;IADC,IAAA,6BAAsB,GAAE;;8CACd;AAGX;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;kDAC9B;AAGf;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;;wDAC/B;AAGrB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;;sDAC/B;AAGnB;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;;wDAC1C;AAGrB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;qDAAA;6BAjBL,kBAAkB;IAH9B,IAAA,aAAM,EAAC,8BAA8B,CAAC;IACtC,IAAA,YAAK,EAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACjC,IAAA,YAAK,EAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;GACnB,kBAAkB,CAkB9B"}

package/dist/entities/family-tree.entity.d.ts

@@ -0,0 +1,9 @@
+export declare class FamilyTree {
+    id: number;
+    name: string;
+    description: string | null;
+    ownerId: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=family-tree.entity.d.ts.map

package/dist/entities/family-tree.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree.entity.d.ts","sourceRoot":"","sources":["../../src/entities/family-tree.entity.ts"],"names":[],"mappings":"AAQA,qBACa,UAAU;IAErB,EAAE,EAAG,MAAM,CAAA;IAGX,IAAI,EAAG,MAAM,CAAA;IAGb,WAAW,EAAG,MAAM,GAAG,IAAI,CAAA;IAG3B,OAAO,EAAG,MAAM,CAAA;IAGhB,SAAS,EAAG,IAAI,CAAA;IAGhB,SAAS,EAAG,IAAI,CAAA;CACjB"}

package/dist/entities/family-tree.entity.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FamilyTree = void 0;
+const core_1 = require("@octo-cyber/core");
+let FamilyTree = class FamilyTree {
+    id;
+    name;
+    description;
+    ownerId;
+    createdAt;
+    updatedAt;
+};
+exports.FamilyTree = FamilyTree;
+__decorate([
+    (0, core_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], FamilyTree.prototype, "id", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'varchar', length: 100 }),
+    __metadata("design:type", String)
+], FamilyTree.prototype, "name", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], FamilyTree.prototype, "description", void 0);
+__decorate([
+    (0, core_1.Column)({ type: 'integer', name: 'owner_id' }),
+    __metadata("design:type", Number)
+], FamilyTree.prototype, "ownerId", void 0);
+__decorate([
+    (0, core_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], FamilyTree.prototype, "createdAt", void 0);
+__decorate([
+    (0, core_1.UpdateDateColumn)({ name: 'updated_at' }),
+    __metadata("design:type", Date)
+], FamilyTree.prototype, "updatedAt", void 0);
+exports.FamilyTree = FamilyTree = __decorate([
+    (0, core_1.Entity)('kinship_family_tree')
+], FamilyTree);
+//# sourceMappingURL=family-tree.entity.js.map

package/dist/entities/family-tree.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-tree.entity.js","sourceRoot":"","sources":["../../src/entities/family-tree.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAMyB;AAGlB,IAAM,UAAU,GAAhB,MAAM,UAAU;IAErB,EAAE,CAAS;IAGX,IAAI,CAAS;IAGb,WAAW,CAAgB;IAG3B,OAAO,CAAS;IAGhB,SAAS,CAAO;IAGhB,SAAS,CAAO;CACjB,CAAA;AAlBY,gCAAU;AAErB;IADC,IAAA,6BAAsB,GAAE;;sCACd;AAGX;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;wCAC5B;AAGb;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACd;AAG3B;IADC,IAAA,aAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;;2CAC9B;AAGhB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;6CAAA;AAGhB;IADC,IAAA,uBAAgB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;8BAC7B,IAAI;6CAAA;qBAjBL,UAAU;IADtB,IAAA,aAAM,EAAC,qBAAqB,CAAC;GACjB,UAAU,CAkBtB"}

package/dist/entities/index.d.ts

@@ -0,0 +1,12 @@
+import { FamilyTree } from './family-tree.entity.js';
+import { FamilyTreePerson } from './family-tree-person.entity.js';
+import { FamilyTreeRelation } from './family-tree-relation.entity.js';
+import { KinshipTitle } from './kinship-title.entity.js';
+export { FamilyTree } from './family-tree.entity.js';
+export { FamilyTreePerson } from './family-tree-person.entity.js';
+export { FamilyTreeRelation } from './family-tree-relation.entity.js';
+export { KinshipTitle } from './kinship-title.entity.js';
+export type { KinshipRegion } from './kinship-title.entity.js';
+export type { PersonGender } from './family-tree-person.entity.js';
+export declare const KINSHIP_CALC_ENTITIES: (typeof FamilyTree | typeof FamilyTreePerson | typeof FamilyTreeRelation | typeof KinshipTitle)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAElE,eAAO,MAAM,qBAAqB,mGAKjC,CAAA"}

package/dist/entities/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KINSHIP_CALC_ENTITIES = exports.KinshipTitle = exports.FamilyTreeRelation = exports.FamilyTreePerson = exports.FamilyTree = void 0;
+const family_tree_entity_js_1 = require("./family-tree.entity.js");
+const family_tree_person_entity_js_1 = require("./family-tree-person.entity.js");
+const family_tree_relation_entity_js_1 = require("./family-tree-relation.entity.js");
+const kinship_title_entity_js_1 = require("./kinship-title.entity.js");
+var family_tree_entity_js_2 = require("./family-tree.entity.js");
+Object.defineProperty(exports, "FamilyTree", { enumerable: true, get: function () { return family_tree_entity_js_2.FamilyTree; } });
+var family_tree_person_entity_js_2 = require("./family-tree-person.entity.js");
+Object.defineProperty(exports, "FamilyTreePerson", { enumerable: true, get: function () { return family_tree_person_entity_js_2.FamilyTreePerson; } });
+var family_tree_relation_entity_js_2 = require("./family-tree-relation.entity.js");
+Object.defineProperty(exports, "FamilyTreeRelation", { enumerable: true, get: function () { return family_tree_relation_entity_js_2.FamilyTreeRelation; } });
+var kinship_title_entity_js_2 = require("./kinship-title.entity.js");
+Object.defineProperty(exports, "KinshipTitle", { enumerable: true, get: function () { return kinship_title_entity_js_2.KinshipTitle; } });
+exports.KINSHIP_CALC_ENTITIES = [
+    family_tree_entity_js_1.FamilyTree,
+    family_tree_person_entity_js_1.FamilyTreePerson,
+    family_tree_relation_entity_js_1.FamilyTreeRelation,
+    kinship_title_entity_js_1.KinshipTitle,
+];
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":";;;AAAA,mEAAoD;AACpD,iFAAiE;AACjE,qFAAqE;AACrE,uEAAwD;AAExD,iEAAoD;AAA3C,mHAAA,UAAU,OAAA;AACnB,+EAAiE;AAAxD,gIAAA,gBAAgB,OAAA;AACzB,mFAAqE;AAA5D,oIAAA,kBAAkB,OAAA;AAC3B,qEAAwD;AAA/C,uHAAA,YAAY,OAAA;AAIR,QAAA,qBAAqB,GAAG;IACnC,kCAAU;IACV,+CAAgB;IAChB,mDAAkB;IAClB,sCAAY;CACb,CAAA"}

package/dist/entities/kinship-title.entity.d.ts

@@ -0,0 +1,18 @@
+export type KinshipRegion = 'standard' | 'northern' | 'southern' | 'cantonese' | 'minnan' | 'wu';
+/**
+ * Stores a computed kinship title for a specific relation path + region.
+ * relationPath is the canonical encoded path, e.g. "F" (father), "FF" (paternal grandfather).
+ */
+export declare class KinshipTitle {
+    id: number;
+    /** Encoded relation path, e.g. "F", "M", "FF", "MF", "FB+", "MS" */
+    relationPath: string;
+    region: KinshipRegion;
+    /** How ego calls the relative, e.g. 爷爷, 外公 */
+    title: string;
+    /** How the relative calls ego back, e.g. 孙子/孙女 */
+    reverseTitle: string | null;
+    /** Description / mnemonic for this term */
+    description: string | null;
+}
+//# sourceMappingURL=kinship-title.entity.d.ts.map

package/dist/entities/kinship-title.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinship-title.entity.d.ts","sourceRoot":"","sources":["../../src/entities/kinship-title.entity.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAA;AAEhG;;;GAGG;AACH,qBAEa,YAAY;IAEvB,EAAE,EAAG,MAAM,CAAA;IAEX,oEAAoE;IAEpE,YAAY,EAAG,MAAM,CAAA;IAGrB,MAAM,EAAG,aAAa,CAAA;IAEtB,8CAA8C;IAE9C,KAAK,EAAG,MAAM,CAAA;IAEd,kDAAkD;IAElD,YAAY,EAAG,MAAM,GAAG,IAAI,CAAA;IAE5B,2CAA2C;IAE3C,WAAW,EAAG,MAAM,GAAG,IAAI,CAAA;CAC5B"}