@octo-cyber/kinship-calc 0.5.2

package/dist/services/kinship-calc.service.d.ts

@@ -0,0 +1,26 @@
+import { type KinshipResult, type Region } from '../engine/index.js';
+import type { CalculateKinshipDto, PathFromChainDto } from '../schemas/kinship.schema.js';
+export declare class KinshipCalcService {
+    private readonly logger;
+    initialize(): void;
+    calculate(dto: CalculateKinshipDto): KinshipResult;
+    calculateFromChain(dto: PathFromChainDto): KinshipResult;
+    /** Check if two paths to the same person create a generational conflict */
+    checkConflict(paths: string[]): {
+        conflict: boolean;
+        message: string | null;
+    };
+    /** Return all known relation paths with their standard titles */
+    listAllTitles(region?: Region): Array<{
+        path: string;
+        title: string;
+        generationDelta: number;
+    }>;
+    /** Return available relation atoms for building chains */
+    getRelationAtoms(): Array<{
+        code: string;
+        label: string;
+        generationDelta: number;
+    }>;
+}
+//# sourceMappingURL=kinship-calc.service.d.ts.map

package/dist/services/kinship-calc.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinship-calc.service.d.ts","sourceRoot":"","sources":["../../src/services/kinship-calc.service.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEzF,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IAEtD,UAAU,IAAI,IAAI;IAIlB,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,aAAa;IAOlD,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa;IAQxD,2EAA2E;IAC3E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAK7E,iEAAiE;IACjE,aAAa,CAAC,MAAM,GAAE,MAAmB,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3G,0DAA0D;IAC1D,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAcpF"}

package/dist/services/kinship-calc.service.js

@@ -0,0 +1,66 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KinshipCalcService = void 0;
+const core_1 = require("@octo-cyber/core");
+const index_js_1 = require("../engine/index.js");
+let KinshipCalcService = class KinshipCalcService {
+    logger = core_1.Container.get(core_1.LoggerService);
+    initialize() {
+        this.logger.info('KinshipCalcService initialized');
+    }
+    calculate(dto) {
+        return (0, index_js_1.calculateKinship)(dto.path, {
+            region: dto.region,
+            egoGender: dto.egoGender,
+        });
+    }
+    calculateFromChain(dto) {
+        const path = (0, index_js_1.encodePath)(dto.chain);
+        return (0, index_js_1.calculateKinship)(path, {
+            region: dto.region,
+            egoGender: dto.egoGender,
+        });
+    }
+    /** Check if two paths to the same person create a generational conflict */
+    checkConflict(paths) {
+        const message = (0, index_js_1.detectGenerationConflict)(paths);
+        return { conflict: message !== null, message };
+    }
+    /** Return all known relation paths with their standard titles */
+    listAllTitles(region = 'standard') {
+        return index_js_1.KINSHIP_TABLE.map((entry) => {
+            const result = (0, index_js_1.calculateKinship)(entry.path, { region });
+            return {
+                path: entry.path,
+                title: result.title,
+                generationDelta: result.generationDelta,
+            };
+        });
+    }
+    /** Return available relation atoms for building chains */
+    getRelationAtoms() {
+        return [
+            { code: 'F', label: '父亲', generationDelta: 1 },
+            { code: 'M', label: '母亲', generationDelta: 1 },
+            { code: 'S', label: '儿子', generationDelta: -1 },
+            { code: 'D', label: '女儿', generationDelta: -1 },
+            { code: 'B+', label: '哥哥', generationDelta: 0 },
+            { code: 'B-', label: '弟弟', generationDelta: 0 },
+            { code: 'Z+', label: '姐姐', generationDelta: 0 },
+            { code: 'Z-', label: '妹妹', generationDelta: 0 },
+            { code: 'H', label: '丈夫', generationDelta: 0 },
+            { code: 'W', label: '妻子', generationDelta: 0 },
+        ];
+    }
+};
+exports.KinshipCalcService = KinshipCalcService;
+exports.KinshipCalcService = KinshipCalcService = __decorate([
+    (0, core_1.Service)()
+], KinshipCalcService);
+//# sourceMappingURL=kinship-calc.service.js.map

package/dist/services/kinship-calc.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinship-calc.service.js","sourceRoot":"","sources":["../../src/services/kinship-calc.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoE;AACpE,iDAO2B;AAIpB,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IACZ,MAAM,GAAG,gBAAS,CAAC,GAAG,CAAC,oBAAa,CAAC,CAAA;IAEtD,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IACpD,CAAC;IAED,SAAS,CAAC,GAAwB;QAChC,OAAO,IAAA,2BAAgB,EAAC,GAAG,CAAC,IAAI,EAAE;YAChC,MAAM,EAAE,GAAG,CAAC,MAAgB;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAA;IACJ,CAAC;IAED,kBAAkB,CAAC,GAAqB;QACtC,MAAM,IAAI,GAAG,IAAA,qBAAU,EAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClC,OAAO,IAAA,2BAAgB,EAAC,IAAI,EAAE;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAgB;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAA;IACJ,CAAC;IAED,2EAA2E;IAC3E,aAAa,CAAC,KAAe;QAC3B,MAAM,OAAO,GAAG,IAAA,mCAAwB,EAAC,KAAK,CAAC,CAAA;QAC/C,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,EAAE,CAAA;IAChD,CAAC;IAED,iEAAiE;IACjE,aAAa,CAAC,SAAiB,UAAU;QACvC,OAAO,wBAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,IAAA,2BAAgB,EAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0DAA0D;IAC1D,gBAAgB;QACd,OAAO;YACL,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,CAAC,EAAE;YACjD,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,CAAC,EAAE;YACjD,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;YACjD,EAAE,IAAI,EAAE,GAAG,EAAG,KAAK,EAAE,IAAI,EAAG,eAAe,EAAE,CAAC,EAAG;SAClD,CAAA;IACH,CAAC;CACF,CAAA;AAvDY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,cAAO,GAAE;GACG,kBAAkB,CAuD9B"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@octo-cyber/kinship-calc",
+  "version": "0.5.2",
+  "description": "辈分计算器 — 输入关系链，自动计算亲属称呼，支持南北方差异与方言",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./web/index.ts",
+      "import": "./web/index.ts",
+      "default": "./web/index.ts"
+    },
+    "./web/pages/*": {
+      "types": "./web/pages/*.tsx",
+      "import": "./web/pages/*.tsx",
+      "default": "./web/pages/*.tsx"
+    }
+  },
+  "dependencies": {
+    "@octo-cyber/core": "^0.5.4",
+    "@octo-cyber/auth": "^0.5.6",
+    "@octo-cyber/ui": "^0.5.3"
+  },
+  "peerDependencies": {
+    "next": ">=15",
+    "next-intl": ">=3",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "zod": ">=3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19",
+    "typescript": "^5.8.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jefflower/octo-kinship-calc.git"
+  },
+  "publishMeta": {
+    "repository": "jefflower/octo-kinship-calc",
+    "branch": "main",
+    "commitHash": "7490bd3995fad90547d8d8d7febf4143142e5b35",
+    "publishedAt": "2026-03-27T15:19:48.392Z",
+    "publishedFrom": "monorepo:packages/kinship-calc"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/controllers/family-tree.controller.ts

@@ -0,0 +1,102 @@
+import type { Request, Response, RequestHandler } from '@octo-cyber/core'
+import { Container, ApiResponse, asyncHandler, AppError } from '@octo-cyber/core'
+import { FamilyTreeService } from '../services/family-tree.service.js'
+import {
+  CreateFamilyTreeSchema,
+  UpdateFamilyTreeSchema,
+  CreatePersonSchema,
+  UpdatePersonSchema,
+  CreateRelationSchema,
+  ResolveTreePathSchema,
+} from '../schemas/kinship.schema.js'
+
+type AuthRequest = Request & { user?: { userId: number } }
+
+function ownerId(req: Request): number {
+  const id = (req as AuthRequest).user?.userId
+  if (!id) throw new AppError('未认证', 401)
+  return id
+}
+
+export class FamilyTreeController {
+  private readonly service = Container.get(FamilyTreeService)
+
+  /** GET /api/v1/kinship/trees */
+  listTrees: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const trees = await this.service.listTrees(ownerId(req))
+    res.json(ApiResponse.ok(trees))
+  })
+
+  /** GET /api/v1/kinship/trees/:id */
+  getTree: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const graph = await this.service.getTree(Number(req.params.id), ownerId(req))
+    res.json(ApiResponse.ok(graph))
+  })
+
+  /** POST /api/v1/kinship/trees */
+  createTree: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = CreateFamilyTreeSchema.parse(req.body)
+    const tree = await this.service.createTree(dto, ownerId(req))
+    res.status(201).json(ApiResponse.ok(tree))
+  })
+
+  /** PUT /api/v1/kinship/trees/:id */
+  updateTree: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = UpdateFamilyTreeSchema.parse(req.body)
+    const tree = await this.service.updateTree(Number(req.params.id), dto, ownerId(req))
+    res.json(ApiResponse.ok(tree))
+  })
+
+  /** DELETE /api/v1/kinship/trees/:id */
+  deleteTree: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    await this.service.deleteTree(Number(req.params.id), ownerId(req))
+    res.json(ApiResponse.ok(null))
+  })
+
+  /** POST /api/v1/kinship/persons */
+  addPerson: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = CreatePersonSchema.parse(req.body)
+    const person = await this.service.addPerson(dto, ownerId(req))
+    res.status(201).json(ApiResponse.ok(person))
+  })
+
+  /** PUT /api/v1/kinship/persons/:id?treeId= */
+  updatePerson: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const personId = Number(req.params.id)
+    const treeId = Number(req.query.treeId)
+    if (!treeId) throw new AppError('缺少 treeId 参数', 400)
+    const dto = UpdatePersonSchema.parse(req.body)
+    const person = await this.service.updatePerson(personId, treeId, dto, ownerId(req))
+    res.json(ApiResponse.ok(person))
+  })
+
+  /** DELETE /api/v1/kinship/persons/:id?treeId= */
+  deletePerson: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const treeId = Number(req.query.treeId)
+    if (!treeId) throw new AppError('缺少 treeId 参数', 400)
+    await this.service.deletePerson(Number(req.params.id), treeId, ownerId(req))
+    res.json(ApiResponse.ok(null))
+  })
+
+  /** POST /api/v1/kinship/relations */
+  addRelation: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = CreateRelationSchema.parse(req.body)
+    const relation = await this.service.addRelation(dto, ownerId(req))
+    res.status(201).json(ApiResponse.ok(relation))
+  })
+
+  /** DELETE /api/v1/kinship/relations/:id?treeId= */
+  deleteRelation: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const treeId = Number(req.query.treeId)
+    if (!treeId) throw new AppError('缺少 treeId 参数', 400)
+    await this.service.deleteRelation(Number(req.params.id), treeId, ownerId(req))
+    res.json(ApiResponse.ok(null))
+  })
+
+  /** POST /api/v1/kinship/resolve */
+  resolveKinship: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = ResolveTreePathSchema.parse(req.body)
+    const result = await this.service.resolveKinship(dto, ownerId(req))
+    res.json(ApiResponse.ok(result))
+  })
+}

package/src/controllers/kinship-calc.controller.ts

@@ -0,0 +1,50 @@
+import type { Request, Response, RequestHandler } from '@octo-cyber/core'
+import { Container, ApiResponse, asyncHandler, AppError } from '@octo-cyber/core'
+import { KinshipCalcService } from '../services/kinship-calc.service.js'
+import {
+  CalculateKinshipSchema,
+  PathFromChainSchema,
+} from '../schemas/kinship.schema.js'
+import type { Region } from '../engine/index.js'
+
+const VALID_REGIONS: Region[] = ['standard', 'northern', 'southern', 'cantonese', 'minnan', 'wu']
+
+export class KinshipCalcController {
+  private readonly service = Container.get(KinshipCalcService)
+
+  /** POST /api/kinship/calculate */
+  calculate: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = CalculateKinshipSchema.parse(req.body)
+    const result = this.service.calculate(dto)
+    res.json(ApiResponse.ok(result))
+  })
+
+  /** POST /api/kinship/chain */
+  calculateFromChain: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const dto = PathFromChainSchema.parse(req.body)
+    const result = this.service.calculateFromChain(dto)
+    res.json(ApiResponse.ok(result))
+  })
+
+  /** POST /api/kinship/conflict-check */
+  checkConflict: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const { paths } = req.body as { paths: string[] }
+    if (!Array.isArray(paths)) throw AppError.badRequest('paths 必须是数组')
+    const result = this.service.checkConflict(paths)
+    res.json(ApiResponse.ok(result))
+  })
+
+  /** GET /api/kinship/titles?region=standard */
+  listTitles: RequestHandler = asyncHandler(async (req: Request, res: Response) => {
+    const region = ((req.query.region as string) || 'standard') as Region
+    if (!VALID_REGIONS.includes(region)) throw AppError.badRequest(`不支持的地区：${region}`)
+    const list = this.service.listAllTitles(region)
+    res.json(ApiResponse.ok(list))
+  })
+
+  /** GET /api/kinship/atoms */
+  getAtoms: RequestHandler = asyncHandler(async (_req: Request, res: Response) => {
+    const atoms = this.service.getRelationAtoms()
+    res.json(ApiResponse.ok(atoms))
+  })
+}

package/src/engine/index.ts

@@ -0,0 +1,6 @@
+export { calculateKinship, detectGenerationConflict } from './kinship-engine.js'
+export type { KinshipResult, CalcOptions, Region } from './kinship-engine.js'
+export { KINSHIP_TABLE, KINSHIP_LOOKUP } from './kinship-data.js'
+export type { KinshipEntry } from './kinship-data.js'
+export { encodePath, decodePath, pathGenerationDelta, atomGender } from './relation-path.js'
+export type { RelationAtom, EgoGender } from './relation-path.js'

package/src/engine/kinship-data.ts

@@ -0,0 +1,188 @@
+/**
+ * Comprehensive Chinese kinship term lookup table.
+ *
+ * Each entry: { path, standard, northern?, southern?, cantonese?, minnan?, wu?, reverse?, note? }
+ *
+ * path: encoded relation path (dot-separated atoms)
+ * standard: standard Mandarin title (普通话)
+ * northern: northern dialect variant (北方)
+ * southern: southern Mandarin variant (南方官话)
+ * cantonese: Cantonese variant (粤语)
+ * minnan: Min-nan / Hokkien variant (闽南语)
+ * wu: Wu dialect variant (吴语/上海话)
+ * reverse: how the relative addresses ego (男/女 separated by /)
+ * note: explanatory note
+ */
+
+export interface KinshipEntry {
+  path: string
+  standard: string
+  northern?: string
+  southern?: string
+  cantonese?: string
+  minnan?: string
+  wu?: string
+  reverse?: string  // e.g. "孙子/孙女" (male ego / female ego)
+  note?: string
+}
+
+export const KINSHIP_TABLE: KinshipEntry[] = [
+  // ── 直系 ─────────────────────────────────────────────────────────
+
+  // Parents
+  { path: 'F',   standard: '父亲',   northern: '爸',    cantonese: '爸爸', reverse: '孩子', note: '父' },
+  { path: 'M',   standard: '母亲',   northern: '妈',    cantonese: '妈妈', reverse: '孩子', note: '母' },
+
+  // Grandparents (paternal)
+  { path: 'F.F', standard: '祖父',   northern: '爷爷',  southern: '公公',  cantonese: '爺爺', minnan: '阿公', wu: '阿爷', reverse: '孙子/孙女', note: '父父' },
+  { path: 'F.M', standard: '祖母',   northern: '奶奶',  southern: '婆婆',  cantonese: '嫲嫲', minnan: '阿嬷', wu: '阿嬶', reverse: '孙子/孙女', note: '父母' },
+
+  // Grandparents (maternal)
+  { path: 'M.F', standard: '外祖父', northern: '姥爷',  southern: '外公',  cantonese: '外公', minnan: '阿公', wu: '外公', reverse: '外孙/外孙女', note: '母父' },
+  { path: 'M.M', standard: '外祖母', northern: '姥姥',  southern: '外婆',  cantonese: '外婆', minnan: '阿妈', wu: '外婆', reverse: '外孙/外孙女', note: '母母' },
+
+  // Great-grandparents (paternal)
+  { path: 'F.F.F', standard: '曾祖父', northern: '太爷爷', reverse: '曾孙/曾孙女' },
+  { path: 'F.F.M', standard: '曾祖母', northern: '太奶奶', reverse: '曾孙/曾孙女' },
+  { path: 'M.M.F', standard: '外曾祖父', northern: '太姥爷', reverse: '曾外孙/曾外孙女' },
+  { path: 'M.M.M', standard: '外曾祖母', northern: '太姥姥', reverse: '曾外孙/曾外孙女' },
+
+  // Great-great-grandparents
+  { path: 'F.F.F.F', standard: '高祖父', reverse: '玄孙/玄孙女' },
+  { path: 'F.F.F.M', standard: '高祖母', reverse: '玄孙/玄孙女' },
+
+  // Children
+  { path: 'S',   standard: '儿子',   northern: '儿子', cantonese: '仔', minnan: '囝', reverse: '父亲/母亲' },
+  { path: 'D',   standard: '女儿',   northern: '闺女', cantonese: '囡', reverse: '父亲/母亲' },
+
+  // Grandchildren (paternal line)
+  { path: 'S.S', standard: '孙子',   cantonese: '孙仔', reverse: '祖父/祖母' },
+  { path: 'S.D', standard: '孙女',   cantonese: '孙囡', reverse: '祖父/祖母' },
+  { path: 'D.S', standard: '外孙',   reverse: '外祖父/外祖母' },
+  { path: 'D.D', standard: '外孙女', reverse: '外祖父/外祖母' },
+
+  // Great-grandchildren
+  { path: 'S.S.S', standard: '曾孙',   reverse: '曾祖父/曾祖母' },
+  { path: 'S.S.D', standard: '曾孙女', reverse: '曾祖父/曾祖母' },
+
+  // Spouse
+  { path: 'H',   standard: '丈夫',   northern: '老公', cantonese: '老公', reverse: '妻子/老婆' },
+  { path: 'W',   standard: '妻子',   northern: '老婆', cantonese: '老婆', reverse: '丈夫/老公' },
+
+  // ── 旁系 (collateral) ────────────────────────────────────────────
+
+  // Father's brothers
+  { path: 'F.B+', standard: '伯父',   northern: '大爷', cantonese: '伯父', minnan: '阿伯', wu: '伯伯', reverse: '侄子/侄女', note: '父之兄' },
+  { path: 'F.B-', standard: '叔父',   northern: '叔叔', cantonese: '叔父', minnan: '阿叔', wu: '叔叔', reverse: '侄子/侄女', note: '父之弟' },
+
+  // Father's sisters
+  { path: 'F.Z+', standard: '姑母',   northern: '大姑', cantonese: '姑母', minnan: '阿姑', wu: '姑妈', reverse: '侄子/侄女', note: '父之姐' },
+  { path: 'F.Z-', standard: '姑母',   northern: '姑姑', cantonese: '姑母', minnan: '阿姑', wu: '姑姑', reverse: '侄子/侄女', note: '父之妹' },
+
+  // Mother's brothers
+  { path: 'M.B+', standard: '舅父',   northern: '大舅', cantonese: '舅父', minnan: '阿舅', wu: '舅舅', reverse: '外甥/外甥女', note: '母之兄' },
+  { path: 'M.B-', standard: '舅父',   northern: '舅舅', cantonese: '舅父', minnan: '阿舅', wu: '舅舅', reverse: '外甥/外甥女', note: '母之弟' },
+
+  // Mother's sisters
+  { path: 'M.Z+', standard: '姨母',   northern: '大姨', cantonese: '姨母', minnan: '阿姨', wu: '阿姨', reverse: '外甥/外甥女', note: '母之姐' },
+  { path: 'M.Z-', standard: '姨母',   northern: '阿姨', cantonese: '姨母', minnan: '阿姨', wu: '阿姨', reverse: '外甥/外甥女', note: '母之妹' },
+
+  // Siblings
+  { path: 'B+',  standard: '兄长',   northern: '哥哥', cantonese: '大佬', minnan: '阿兄', wu: '阿哥',  reverse: '弟弟/妹妹' },
+  { path: 'B-',  standard: '弟弟',   northern: '弟弟', cantonese: '细佬', minnan: '小弟', wu: '阿弟',  reverse: '哥哥/姐姐' },
+  { path: 'Z+',  standard: '姐姐',   northern: '姐姐', cantonese: '家姐', minnan: '阿姐', wu: '阿姐',  reverse: '弟弟/妹妹' },
+  { path: 'Z-',  standard: '妹妹',   northern: '妹妹', cantonese: '妹妹', minnan: '小妹', wu: '阿妹',  reverse: '哥哥/姐姐' },
+
+  // Paternal cousins (堂)
+  { path: 'F.B+.S',  standard: '堂兄', northern: '堂哥', note: '伯父之子(年长)' },
+  { path: 'F.B+.D',  standard: '堂姐', northern: '堂姐', note: '伯父之女(年长)' },
+  { path: 'F.B-.S',  standard: '堂弟', northern: '堂弟', note: '叔叔之子(年幼)' },
+  { path: 'F.B-.D',  standard: '堂妹', northern: '堂妹', note: '叔叔之女(年幼)' },
+  { path: 'F.Z+.S',  standard: '表兄', northern: '表哥', note: '姑母之子(年长)' },
+  { path: 'F.Z+.D',  standard: '表姐', northern: '表姐', note: '姑母之女(年长)' },
+  { path: 'F.Z-.S',  standard: '表弟', northern: '表弟', note: '姑母之子(年幼)' },
+  { path: 'F.Z-.D',  standard: '表妹', northern: '表妹', note: '姑母之女(年幼)' },
+
+  // Maternal cousins (表)
+  { path: 'M.B+.S',  standard: '表兄', northern: '表哥', note: '舅父之子(年长)' },
+  { path: 'M.B+.D',  standard: '表姐', northern: '表姐', note: '舅父之女(年长)' },
+  { path: 'M.B-.S',  standard: '表弟', northern: '表弟', note: '舅父之子(年幼)' },
+  { path: 'M.B-.D',  standard: '表妹', northern: '表妹', note: '舅父之女(年幼)' },
+  { path: 'M.Z+.S',  standard: '表兄', northern: '表哥', note: '姨母之子(年长)' },
+  { path: 'M.Z+.D',  standard: '表姐', northern: '表姐', note: '姨母之女(年长)' },
+  { path: 'M.Z-.S',  standard: '表弟', northern: '表弟', note: '姨母之子(年幼)' },
+  { path: 'M.Z-.D',  standard: '表妹', northern: '表妹', note: '姨母之女(年幼)' },
+
+  // Nephews/nieces (siblings' children)
+  { path: 'B+.S',  standard: '侄子', reverse: '伯父/伯母' },
+  { path: 'B+.D',  standard: '侄女', reverse: '伯父/伯母' },
+  { path: 'B-.S',  standard: '侄子', reverse: '叔叔/婶婶' },
+  { path: 'B-.D',  standard: '侄女', reverse: '叔叔/婶婶' },
+  { path: 'Z+.S',  standard: '外甥',   northern: '外甥',   note: '姐之子', reverse: '舅父/舅母' },
+  { path: 'Z+.D',  standard: '外甥女', northern: '外甥女', note: '姐之女', reverse: '舅父/舅母' },
+  { path: 'Z-.S',  standard: '外甥',   northern: '外甥',   note: '妹之子', reverse: '舅父/舅母' },
+  { path: 'Z-.D',  standard: '外甥女', northern: '外甥女', note: '妹之女', reverse: '舅父/舅母' },
+
+  // ── 姻亲 (in-laws) ───────────────────────────────────────────────
+
+  // Spouse's parents
+  { path: 'W.F',  standard: '岳父',   northern: '老丈人', cantonese: '外父', wu: '丈人', reverse: '女婿' },
+  { path: 'W.M',  standard: '岳母',   northern: '丈母娘', cantonese: '外母', wu: '丈母', reverse: '女婿' },
+  { path: 'H.F',  standard: '公公',   cantonese: '家翁',  wu: '阿公', reverse: '儿媳' },
+  { path: 'H.M',  standard: '婆婆',   cantonese: '家姑',  wu: '阿婆', reverse: '儿媳' },
+
+  // Children's spouses
+  { path: 'S.W',  standard: '儿媳妇', northern: '儿媳', reverse: '公公/婆婆' },
+  { path: 'D.H',  standard: '女婿',   reverse: '岳父/岳母' },
+
+  // Siblings' spouses
+  { path: 'B+.W', standard: '嫂子',   northern: '嫂嫂', cantonese: '大嫂', reverse: '小叔/小姑' },
+  { path: 'B-.W', standard: '弟媳',   northern: '弟妹', cantonese: '弟妇', reverse: '大伯/大姑' },
+  { path: 'Z+.H', standard: '姐夫',   cantonese: '姐夫', reverse: '小舅/小姨' },
+  { path: 'Z-.H', standard: '妹夫',   cantonese: '妹夫', reverse: '大舅/大姨' },
+
+  // Spouse's siblings
+  { path: 'H.B+', standard: '大伯子', northern: '大伯', note: '夫之兄' },
+  { path: 'H.B-', standard: '小叔子', northern: '小叔', note: '夫之弟' },
+  { path: 'H.Z+', standard: '大姑子', northern: '大姑', note: '夫之姐' },
+  { path: 'H.Z-', standard: '小姑子', northern: '小姑', note: '夫之妹' },
+  { path: 'W.B+', standard: '大舅子', northern: '大舅哥', note: '妻之兄' },
+  { path: 'W.B-', standard: '小舅子', northern: '小舅子', note: '妻之弟' },
+  { path: 'W.Z+', standard: '大姨子', northern: '大姨姐', note: '妻之姐' },
+  { path: 'W.Z-', standard: '小姨子', northern: '小姨妹', note: '妻之妹' },
+
+  // Father's brothers' wives
+  { path: 'F.B+.W', standard: '伯母', northern: '大娘', cantonese: '伯娘', minnan: '阿婶', wu: '伯娘', reverse: '侄子/侄女' },
+  { path: 'F.B-.W', standard: '婶母', northern: '婶婶', cantonese: '婶母', minnan: '阿婶', wu: '阿婶', reverse: '侄子/侄女' },
+
+  // Father's sisters' husbands
+  { path: 'F.Z+.H', standard: '姑父', northern: '姑父', reverse: '外甥/外甥女' },
+  { path: 'F.Z-.H', standard: '姑父', northern: '姑父', reverse: '外甥/外甥女' },
+
+  // Mother's brothers' wives
+  { path: 'M.B+.W', standard: '舅母', northern: '大妗', note: '舅父之妻' },
+  { path: 'M.B-.W', standard: '舅母', northern: '舅妈', note: '舅父之妻' },
+
+  // Mother's sisters' husbands
+  { path: 'M.Z+.H', standard: '姨父', northern: '姨夫', reverse: '外甥/外甥女' },
+  { path: 'M.Z-.H', standard: '姨父', northern: '姨夫', reverse: '外甥/外甥女' },
+
+  // Grandparents' siblings (祖父/祖母的兄弟姐妹)
+  { path: 'F.F.B+', standard: '伯祖父', northern: '老爷爷' },
+  { path: 'F.F.B-', standard: '叔祖父', northern: '老爷爷' },
+  { path: 'F.F.Z+', standard: '姑祖母', northern: '姑奶奶' },
+  { path: 'F.F.Z-', standard: '姑祖母', northern: '姑奶奶' },
+  { path: 'F.M.B+', standard: '舅祖父', northern: '舅太爷' },
+  { path: 'F.M.Z+', standard: '姨祖母', northern: '姨奶奶' },
+]
+
+/** Build a lookup map for O(1) access */
+export function buildLookupMap(table: KinshipEntry[]): Map<string, KinshipEntry> {
+  const map = new Map<string, KinshipEntry>()
+  for (const entry of table) {
+    map.set(entry.path, entry)
+  }
+  return map
+}
+
+export const KINSHIP_LOOKUP = buildLookupMap(KINSHIP_TABLE)