@mycodemap/mycodemap 0.1.0 → 0.2.0

package/dist/domain/entities/Dependency.js

@@ -0,0 +1,132 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain entity: Dependency - represents a dependency relationship between modules
+// ============================================
+// 领域实体：依赖 - 表示模块之间的依赖关系
+// ============================================
+/**
+ * 依赖领域实体
+ *
+ * 职责：
+ * - 维护依赖关系身份信息
+ * - 记录源模块和目标模块
+ * - 分类依赖类型
+ */
+export class Dependency {
+    id;
+    sourceId;
+    targetId;
+    type;
+    constructor(id, sourceId, targetId, type = 'import') {
+        this.id = id;
+        this.sourceId = sourceId;
+        this.targetId = targetId;
+        this.type = type;
+        this.validate();
+    }
+    /**
+     * 从接口数据创建依赖实体
+     */
+    static fromInterface(data) {
+        return new Dependency(data.id, data.sourceId, data.targetId, data.type);
+    }
+    /**
+     * 转换为接口数据
+     */
+    toInterface() {
+        return {
+            id: this.id,
+            sourceId: this.sourceId,
+            targetId: this.targetId,
+            type: this.type,
+        };
+    }
+    /**
+     * 更改依赖类型
+     */
+    setType(type) {
+        this.type = type;
+    }
+    /**
+     * 验证领域规则
+     */
+    validate() {
+        if (!this.id || this.id.trim().length === 0) {
+            throw new Error('Dependency ID cannot be empty');
+        }
+        if (!this.sourceId || this.sourceId.trim().length === 0) {
+            throw new Error('Source module ID cannot be empty');
+        }
+        if (!this.targetId || this.targetId.trim().length === 0) {
+            throw new Error('Target module ID cannot be empty');
+        }
+        if (this.sourceId === this.targetId) {
+            throw new Error('Source and target cannot be the same');
+        }
+    }
+    /**
+     * 检查两个依赖是否相同（基于 ID）
+     */
+    equals(other) {
+        return this.id === other.id;
+    }
+    /**
+     * 检查是否涉及指定模块（作为源或目标）
+     */
+    involvesModule(moduleId) {
+        return this.sourceId === moduleId || this.targetId === moduleId;
+    }
+    /**
+     * 获取模块的依赖方向
+     * @returns 'source' | 'target' | null
+     */
+    getDirectionFor(moduleId) {
+        if (this.sourceId === moduleId)
+            return 'source';
+        if (this.targetId === moduleId)
+            return 'target';
+        return null;
+    }
+    /**
+     * 是否是继承关系
+     */
+    isInheritance() {
+        return this.type === 'inherit' || this.type === 'implement';
+    }
+    /**
+     * 是否是调用关系
+     */
+    isCall() {
+        return this.type === 'call';
+    }
+    /**
+     * 是否是类型引用
+     */
+    isTypeReference() {
+        return this.type === 'type-ref';
+    }
+    /**
+     * 创建反向依赖（交换源和目标）
+     */
+    createReverse(newId) {
+        return new Dependency(newId, this.targetId, this.sourceId, this.type);
+    }
+    /**
+     * 创建依赖快照（克隆）
+     */
+    snapshot() {
+        return new Dependency(this.id, this.sourceId, this.targetId, this.type);
+    }
+    /**
+     * 创建唯一键（用于去重）
+     */
+    static createKey(sourceId, targetId, type) {
+        return `${sourceId}::${targetId}::${type}`;
+    }
+    /**
+     * 获取当前依赖的唯一键
+     */
+    getKey() {
+        return Dependency.createKey(this.sourceId, this.targetId, this.type);
+    }
+}
+//# sourceMappingURL=Dependency.js.map

package/dist/domain/entities/Dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.js","sourceRoot":"","sources":["../../../src/domain/entities/Dependency.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yFAAyF;AACzF,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAS/C;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACZ,EAAE,CAAS;IACX,QAAQ,CAAS;IACjB,QAAQ,CAAS;IAC1B,IAAI,CAAiB;IAErB,YACE,EAAU,EACV,QAAgB,EAChB,QAAgB,EAChB,OAAuB,QAAQ;QAE/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAyB;QAC5C,OAAO,IAAI,UAAU,CACnB,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,IAAI,CACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAoB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,QAAQ;QACd,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAiB;QACtB,OAAO,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,QAAgB;QAC9B,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAChD,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa;QACzB,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAoB;QACvE,OAAO,GAAG,QAAQ,KAAK,QAAQ,KAAK,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/domain/entities/Module.d.ts

@@ -0,0 +1,75 @@
+import type { Module as ModuleInterface } from '../../interface/types/index.js';
+/**
+ * 模块统计信息
+ */
+export interface ModuleStats {
+    lines: number;
+    codeLines: number;
+    commentLines: number;
+    blankLines: number;
+}
+/**
+ * 模块领域实体
+ *
+ * 职责：
+ * - 维护模块身份信息
+ * - 记录代码统计信息
+ * - 关联到项目和语言
+ */
+export declare class Module implements ModuleInterface {
+    readonly id: string;
+    readonly projectId: string;
+    path: string;
+    language: string;
+    stats: ModuleStats;
+    constructor(id: string, projectId: string, path: string, language: string, stats?: ModuleStats);
+    /**
+     * 从接口数据创建模块实体
+     */
+    static fromInterface(data: ModuleInterface): Module;
+    /**
+     * 转换为接口数据
+     */
+    toInterface(): ModuleInterface;
+    /**
+     * 更新代码统计信息
+     */
+    updateStats(stats: Partial<ModuleStats>): void;
+    /**
+     * 更新文件路径（如重命名）
+     */
+    updatePath(newPath: string): void;
+    /**
+     * 设置语言类型
+     */
+    setLanguage(language: string): void;
+    /**
+     * 验证领域规则
+     */
+    private validate;
+    /**
+     * 检查两个模块是否相同（基于 ID）
+     */
+    equals(other: Module): boolean;
+    /**
+     * 计算代码密度（代码行 / 总行数）
+     */
+    getCodeDensity(): number;
+    /**
+     * 计算注释密度（注释行 / 总行数）
+     */
+    getCommentDensity(): number;
+    /**
+     * 是否是测试文件（启发式判断）
+     */
+    isTestFile(): boolean;
+    /**
+     * 是否是配置文件
+     */
+    isConfigFile(): boolean;
+    /**
+     * 创建模块快照（克隆）
+     */
+    snapshot(): Module;
+}
+//# sourceMappingURL=Module.d.ts.map

package/dist/domain/entities/Module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Module.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,MAAO,YAAW,eAAe;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;gBAGjB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,WAKN;IAWH;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAUnD;;OAEG;IACH,WAAW,IAAI,eAAe;IAU9B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAO9C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,cAAc,IAAI,MAAM;IAKxB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAK3B;;OAEG;IACH,UAAU,IAAI,OAAO;IAYrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAWvB;;OAEG;IACH,QAAQ,IAAI,MAAM;CASnB"}

package/dist/domain/entities/Module.js

@@ -0,0 +1,151 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain entity: Module - represents a source code module (file) in the project
+// ============================================
+// 领域实体：模块 - 表示项目中的源代码模块（文件）
+// ============================================
+/**
+ * 模块领域实体
+ *
+ * 职责：
+ * - 维护模块身份信息
+ * - 记录代码统计信息
+ * - 关联到项目和语言
+ */
+export class Module {
+    id;
+    projectId;
+    path;
+    language;
+    stats;
+    constructor(id, projectId, path, language, stats = {
+        lines: 0,
+        codeLines: 0,
+        commentLines: 0,
+        blankLines: 0,
+    }) {
+        this.id = id;
+        this.projectId = projectId;
+        this.path = path;
+        this.language = language;
+        this.stats = { ...stats };
+        this.validate();
+    }
+    /**
+     * 从接口数据创建模块实体
+     */
+    static fromInterface(data) {
+        return new Module(data.id, data.projectId, data.path, data.language, data.stats);
+    }
+    /**
+     * 转换为接口数据
+     */
+    toInterface() {
+        return {
+            id: this.id,
+            projectId: this.projectId,
+            path: this.path,
+            language: this.language,
+            stats: { ...this.stats },
+        };
+    }
+    /**
+     * 更新代码统计信息
+     */
+    updateStats(stats) {
+        this.stats = {
+            ...this.stats,
+            ...stats,
+        };
+    }
+    /**
+     * 更新文件路径（如重命名）
+     */
+    updatePath(newPath) {
+        if (!newPath || newPath.trim().length === 0) {
+            throw new Error('Module path cannot be empty');
+        }
+        this.path = newPath.trim();
+    }
+    /**
+     * 设置语言类型
+     */
+    setLanguage(language) {
+        if (!language || language.trim().length === 0) {
+            throw new Error('Language cannot be empty');
+        }
+        this.language = language.trim().toLowerCase();
+    }
+    /**
+     * 验证领域规则
+     */
+    validate() {
+        if (!this.id || this.id.trim().length === 0) {
+            throw new Error('Module ID cannot be empty');
+        }
+        if (!this.projectId || this.projectId.trim().length === 0) {
+            throw new Error('Project ID cannot be empty');
+        }
+        if (!this.path || this.path.trim().length === 0) {
+            throw new Error('Module path cannot be empty');
+        }
+        if (!this.language || this.language.trim().length === 0) {
+            throw new Error('Language cannot be empty');
+        }
+    }
+    /**
+     * 检查两个模块是否相同（基于 ID）
+     */
+    equals(other) {
+        return this.id === other.id;
+    }
+    /**
+     * 计算代码密度（代码行 / 总行数）
+     */
+    getCodeDensity() {
+        if (this.stats.lines === 0)
+            return 0;
+        return this.stats.codeLines / this.stats.lines;
+    }
+    /**
+     * 计算注释密度（注释行 / 总行数）
+     */
+    getCommentDensity() {
+        if (this.stats.lines === 0)
+            return 0;
+        return this.stats.commentLines / this.stats.lines;
+    }
+    /**
+     * 是否是测试文件（启发式判断）
+     */
+    isTestFile() {
+        const testPatterns = [
+            /\.test\./,
+            /\.spec\./,
+            /__tests__/,
+            /_test\.ts$/,
+            /\.test\.ts$/,
+            /\.spec\.ts$/,
+        ];
+        return testPatterns.some(pattern => pattern.test(this.path));
+    }
+    /**
+     * 是否是配置文件
+     */
+    isConfigFile() {
+        const configPatterns = [
+            /\.config\./,
+            /config\./,
+            /^\./, // 隐藏文件
+            /rc\./,
+            /rc$/,
+        ];
+        return configPatterns.some(pattern => pattern.test(this.path));
+    }
+    /**
+     * 创建模块快照（克隆）
+     */
+    snapshot() {
+        return new Module(this.id, this.projectId, this.path, this.language, { ...this.stats });
+    }
+}
+//# sourceMappingURL=Module.js.map

package/dist/domain/entities/Module.js.map

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

package/dist/domain/entities/Project.d.ts

@@ -0,0 +1,50 @@
+import type { Project as ProjectInterface } from '../../interface/types/index.js';
+/**
+ * 项目领域实体
+ *
+ * 职责：
+ * - 维护项目身份信息
+ * - 管理项目生命周期（创建、更新）
+ * - 提供领域行为（重命名、更新路径等）
+ */
+export declare class Project implements ProjectInterface {
+    readonly id: string;
+    name: string;
+    rootPath: string;
+    readonly createdAt: Date;
+    updatedAt: Date;
+    constructor(id: string, name: string, rootPath: string, createdAt?: Date, updatedAt?: Date);
+    /**
+     * 从接口数据创建项目实体
+     */
+    static fromInterface(data: ProjectInterface): Project;
+    /**
+     * 转换为接口数据
+     */
+    toInterface(): ProjectInterface;
+    /**
+     * 重命名项目
+     */
+    rename(newName: string): void;
+    /**
+     * 更新根路径
+     */
+    updateRootPath(newPath: string): void;
+    /**
+     * 验证领域规则
+     */
+    private validate;
+    /**
+     * 更新时间戳
+     */
+    private touch;
+    /**
+     * 检查两个项目是否相同（基于 ID）
+     */
+    equals(other: Project): boolean;
+    /**
+     * 创建项目快照（克隆）
+     */
+    snapshot(): Project;
+}
+//# sourceMappingURL=Project.d.ts.map

package/dist/domain/entities/Project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Project.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElF;;;;;;;GAOG;AACH,qBAAa,OAAQ,YAAW,gBAAgB;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;gBAGd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,IAAiB,EAC5B,SAAS,GAAE,IAAiB;IAW9B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAUrD;;OAEG;IACH,WAAW,IAAI,gBAAgB;IAU/B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQrC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,OAAO;CASpB"}

package/dist/domain/entities/Project.js

@@ -0,0 +1,99 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain entity: Project - represents a codebase project with identity and lifecycle
+// ============================================
+// 领域实体：项目 - 表示具有身份和生命周期的代码库项目
+// ============================================
+/**
+ * 项目领域实体
+ *
+ * 职责：
+ * - 维护项目身份信息
+ * - 管理项目生命周期（创建、更新）
+ * - 提供领域行为（重命名、更新路径等）
+ */
+export class Project {
+    id;
+    name;
+    rootPath;
+    createdAt;
+    updatedAt;
+    constructor(id, name, rootPath, createdAt = new Date(), updatedAt = new Date()) {
+        this.id = id;
+        this.name = name;
+        this.rootPath = rootPath;
+        this.createdAt = createdAt;
+        this.updatedAt = updatedAt;
+        this.validate();
+    }
+    /**
+     * 从接口数据创建项目实体
+     */
+    static fromInterface(data) {
+        return new Project(data.id, data.name, data.rootPath, data.createdAt, data.updatedAt);
+    }
+    /**
+     * 转换为接口数据
+     */
+    toInterface() {
+        return {
+            id: this.id,
+            name: this.name,
+            rootPath: this.rootPath,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+        };
+    }
+    /**
+     * 重命名项目
+     */
+    rename(newName) {
+        if (!newName || newName.trim().length === 0) {
+            throw new Error('Project name cannot be empty');
+        }
+        this.name = newName.trim();
+        this.touch();
+    }
+    /**
+     * 更新根路径
+     */
+    updateRootPath(newPath) {
+        if (!newPath || newPath.trim().length === 0) {
+            throw new Error('Root path cannot be empty');
+        }
+        this.rootPath = newPath.trim();
+        this.touch();
+    }
+    /**
+     * 验证领域规则
+     */
+    validate() {
+        if (!this.id || this.id.trim().length === 0) {
+            throw new Error('Project ID cannot be empty');
+        }
+        if (!this.name || this.name.trim().length === 0) {
+            throw new Error('Project name cannot be empty');
+        }
+        if (!this.rootPath || this.rootPath.trim().length === 0) {
+            throw new Error('Root path cannot be empty');
+        }
+    }
+    /**
+     * 更新时间戳
+     */
+    touch() {
+        this.updatedAt = new Date();
+    }
+    /**
+     * 检查两个项目是否相同（基于 ID）
+     */
+    equals(other) {
+        return this.id === other.id;
+    }
+    /**
+     * 创建项目快照（克隆）
+     */
+    snapshot() {
+        return new Project(this.id, this.name, this.rootPath, new Date(this.createdAt), new Date(this.updatedAt));
+    }
+}
+//# sourceMappingURL=Project.js.map

package/dist/domain/entities/Project.js.map

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

package/dist/domain/entities/Symbol.d.ts

@@ -0,0 +1,75 @@
+import type { Symbol as SymbolInterface, SymbolKind, SourceLocation } from '../../interface/types/index.js';
+/**
+ * 符号可见性类型
+ */
+export type SymbolVisibility = 'public' | 'private' | 'protected' | 'internal';
+/**
+ * 符号领域实体
+ *
+ * 职责：
+ * - 维护符号身份信息
+ * - 记录符号类型和位置
+ * - 关联到所属模块
+ */
+export declare class Symbol implements SymbolInterface {
+    readonly id: string;
+    readonly moduleId: string;
+    name: string;
+    kind: SymbolKind;
+    location: SourceLocation;
+    visibility: SymbolVisibility;
+    constructor(id: string, moduleId: string, name: string, kind: SymbolKind, location: SourceLocation, visibility?: SymbolVisibility);
+    /**
+     * 从接口数据创建符号实体
+     */
+    static fromInterface(data: SymbolInterface): Symbol;
+    /**
+     * 转换为接口数据
+     */
+    toInterface(): SymbolInterface;
+    /**
+     * 重命名符号
+     */
+    rename(newName: string): void;
+    /**
+     * 更新位置信息
+     */
+    updateLocation(location: SourceLocation): void;
+    /**
+     * 更改可见性
+     */
+    setVisibility(visibility: SymbolVisibility): void;
+    /**
+     * 验证领域规则
+     */
+    private validate;
+    /**
+     * 检查两个符号是否相同（基于 ID）
+     */
+    equals(other: Symbol): boolean;
+    /**
+     * 是否是导出符号（公开可见）
+     */
+    isExported(): boolean;
+    /**
+     * 是否是私有符号
+     */
+    isPrivate(): boolean;
+    /**
+     * 是否是类型定义（类、接口、类型别名等）
+     */
+    isTypeDefinition(): boolean;
+    /**
+     * 是否是函数或方法
+     */
+    isFunction(): boolean;
+    /**
+     * 获取符号的完全限定名
+     */
+    getQualifiedName(): string;
+    /**
+     * 创建符号快照（克隆）
+     */
+    snapshot(): Symbol;
+}
+//# sourceMappingURL=Symbol.d.ts.map

package/dist/domain/entities/Symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Symbol.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Symbol.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,UAAU,EACV,cAAc,EACf,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E;;;;;;;GAOG;AACH,qBAAa,MAAO,YAAW,eAAe;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;gBAG3B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,cAAc,EACxB,UAAU,GAAE,gBAA2B;IAYzC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAWnD;;OAEG;IACH,WAAW,IAAI,eAAe;IAW9B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAI9C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAIjD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUnB"}