repowiki-core 0.1.0

package/dist/scanner/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/file-scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AA4E5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAwErB"}

package/dist/scanner/file-scanner.js

@@ -0,0 +1,149 @@
+import fg from 'fast-glob';
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { createIgnoreFilter } from './ignore-rules.js';
+// ---------------------------------------------------------------------------
+// 语言映射表
+// ---------------------------------------------------------------------------
+/**
+ * 文件扩展名 → 语言标识的映射。
+ * 键为小写扩展名 (不含前导点)。
+ */
+const LANGUAGE_MAP = {
+    ts: 'typescript',
+    tsx: 'typescriptreact',
+    js: 'javascript',
+    jsx: 'javascriptreact',
+    py: 'python',
+    go: 'go',
+    rs: 'rust',
+    java: 'java',
+    rb: 'ruby',
+    css: 'css',
+    html: 'html',
+    md: 'markdown',
+    json: 'json',
+    yaml: 'yaml',
+    yml: 'yaml',
+    toml: 'toml',
+    sql: 'sql',
+    prisma: 'prisma',
+    vue: 'vue',
+    svelte: 'svelte',
+};
+/**
+ * 根据文件扩展名推断编程语言。
+ *
+ * @param filePath - 文件路径 (仅使用扩展名部分)
+ * @returns 语言标识字符串，无法识别时返回 `undefined`
+ */
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).slice(1).toLowerCase();
+    return LANGUAGE_MAP[ext];
+}
+// ---------------------------------------------------------------------------
+// 行数统计
+// ---------------------------------------------------------------------------
+/**
+ * 统计文件中非空行数。
+ * 对大于 2 MB 的文件跳过行数统计以避免内存压力。
+ */
+async function countNonEmptyLines(filePath, sizeBytes) {
+    // 跳过过大的文件
+    const MAX_SIZE_FOR_LINE_COUNT = 2 * 1024 * 1024; // 2 MB
+    if (sizeBytes > MAX_SIZE_FOR_LINE_COUNT) {
+        return undefined;
+    }
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return content.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+    }
+    catch {
+        // 二进制文件或无法读取 —— 静默跳过
+        return undefined;
+    }
+}
+/** 默认配置 */
+const DEFAULT_CONFIG = {
+    maxDepth: 5,
+    ignorePatterns: [],
+    includeExtensions: [],
+};
+// ---------------------------------------------------------------------------
+// 核心扫描函数
+// ---------------------------------------------------------------------------
+/**
+ * 递归扫描项目目录，返回扁平的 {@link FileNode} 列表。
+ *
+ * @param rootPath  - 项目根目录的绝对路径
+ * @param config    - 可选配置，覆盖默认值
+ * @returns 排序后的 FileNode 列表 (按相对路径字母序)
+ *
+ * @example
+ * ```ts
+ * const files = await scanDirectory('/path/to/project');
+ * console.log(files.length);
+ * ```
+ */
+export async function scanDirectory(rootPath, config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // 将 rootPath 规范化为 posix 风格以兼容 fast-glob
+    const normalizedRoot = rootPath.replace(/\\/g, '/');
+    // 构建忽略过滤器
+    const shouldIgnore = await createIgnoreFilter(rootPath);
+    // 构建 glob 模式
+    const pattern = `${normalizedRoot}/**/*`;
+    // fast-glob 选项
+    const entries = await fg(pattern, {
+        dot: false,
+        onlyFiles: true,
+        deep: cfg.maxDepth,
+        ignore: cfg.ignorePatterns,
+        absolute: true,
+        stats: false,
+    });
+    const nodes = [];
+    for (const absPath of entries) {
+        // 计算相对路径 (posix 风格)
+        const relativePath = path
+            .relative(rootPath, absPath)
+            .replace(/\\/g, '/');
+        // 应用 ignore 过滤器
+        if (shouldIgnore(relativePath)) {
+            continue;
+        }
+        // 扩展名过滤
+        if (cfg.includeExtensions.length > 0) {
+            const ext = path.extname(absPath).slice(1).toLowerCase();
+            if (!cfg.includeExtensions.includes(ext)) {
+                continue;
+            }
+        }
+        // 获取文件信息
+        let fileStat;
+        try {
+            fileStat = await stat(absPath);
+        }
+        catch {
+            // 文件在扫描期间被删除等异常情况 —— 静默跳过
+            continue;
+        }
+        const sizeBytes = fileStat.size;
+        const language = detectLanguage(absPath);
+        const lineCount = language
+            ? await countNonEmptyLines(absPath, sizeBytes)
+            : undefined;
+        nodes.push({
+            path: absPath,
+            relativePath,
+            nodeType: 'file',
+            sizeBytes,
+            language,
+            lineCount,
+        });
+    }
+    // 按相对路径排序
+    nodes.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return nodes;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/scanner/file-scanner.js.map

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

package/dist/scanner/ignore-rules.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 默认忽略的目录 / 文件 glob 模式。
+ * 这些模式在任何项目中都应被忽略 (构建产物、依赖、缓存等)。
+ */
+export declare const DEFAULT_IGNORE_PATTERNS: readonly string[];
+/**
+ * 敏感文件强制忽略模式。
+ * 为避免将密钥 / 凭据意外写入 Wiki，这些文件始终被排除。
+ */
+export declare const SENSITIVE_FILE_PATTERNS: readonly string[];
+/**
+ * 创建一个用于判断文件路径是否应被忽略的过滤函数。
+ *
+ * 合并以下三类规则:
+ * 1. 项目根目录下的 `.gitignore`
+ * 2. {@link DEFAULT_IGNORE_PATTERNS}
+ * 3. {@link SENSITIVE_FILE_PATTERNS}
+ *
+ * @param projectRoot - 项目根目录的绝对路径
+ * @returns 一个判定函数。传入**相对路径**，返回 `true` 代表该路径应被忽略。
+ *
+ * @example
+ * ```ts
+ * const shouldIgnore = await createIgnoreFilter('/path/to/project');
+ * if (shouldIgnore('node_modules/foo/index.js')) {
+ *     // 跳过
+ * }
+ * ```
+ */
+export declare function createIgnoreFilter(projectRoot: string): Promise<(relativePath: string) => boolean>;
+//# sourceMappingURL=ignore-rules.d.ts.map

package/dist/scanner/ignore-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-rules.d.ts","sourceRoot":"","sources":["../../src/scanner/ignore-rules.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAgBpD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAUpD,CAAC;AA8BF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,CAgB5C"}

package/dist/scanner/ignore-rules.js

@@ -0,0 +1,98 @@
+import ignore from 'ignore';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// 默认忽略规则
+// ---------------------------------------------------------------------------
+/**
+ * 默认忽略的目录 / 文件 glob 模式。
+ * 这些模式在任何项目中都应被忽略 (构建产物、依赖、缓存等)。
+ */
+export const DEFAULT_IGNORE_PATTERNS = [
+    '.git/',
+    'node_modules/',
+    'dist/',
+    'build/',
+    '.next/',
+    'venv/',
+    '.venv/',
+    '__pycache__/',
+    '.pytest_cache/',
+    'coverage/',
+    '.cache/',
+    '.DS_Store',
+    '*.lock',
+    '*.min.js',
+    '*.map',
+];
+/**
+ * 敏感文件强制忽略模式。
+ * 为避免将密钥 / 凭据意外写入 Wiki，这些文件始终被排除。
+ */
+export const SENSITIVE_FILE_PATTERNS = [
+    '.env',
+    '.env.local',
+    '.env.production',
+    '*.pem',
+    '*.key',
+    'id_rsa',
+    'id_ed25519',
+    'secrets.yaml',
+    'credentials.json',
+];
+// ---------------------------------------------------------------------------
+// 辅助函数
+// ---------------------------------------------------------------------------
+/**
+ * 尝试读取项目根目录下的 `.gitignore` 文件，并返回其内容行。
+ * 如果文件不存在或读取失败，返回空数组。
+ */
+async function loadGitignoreLines(projectRoot) {
+    try {
+        const content = await readFile(path.join(projectRoot, '.gitignore'), 'utf-8');
+        return content
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && !line.startsWith('#'));
+    }
+    catch {
+        // .gitignore 不存在或不可读 —— 静默跳过
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// 核心 API
+// ---------------------------------------------------------------------------
+/**
+ * 创建一个用于判断文件路径是否应被忽略的过滤函数。
+ *
+ * 合并以下三类规则:
+ * 1. 项目根目录下的 `.gitignore`
+ * 2. {@link DEFAULT_IGNORE_PATTERNS}
+ * 3. {@link SENSITIVE_FILE_PATTERNS}
+ *
+ * @param projectRoot - 项目根目录的绝对路径
+ * @returns 一个判定函数。传入**相对路径**，返回 `true` 代表该路径应被忽略。
+ *
+ * @example
+ * ```ts
+ * const shouldIgnore = await createIgnoreFilter('/path/to/project');
+ * if (shouldIgnore('node_modules/foo/index.js')) {
+ *     // 跳过
+ * }
+ * ```
+ */
+export async function createIgnoreFilter(projectRoot) {
+    const ig = (ignore.default || ignore)();
+    // 1. 加载 .gitignore
+    const gitignoreLines = await loadGitignoreLines(projectRoot);
+    if (gitignoreLines.length > 0) {
+        ig.add(gitignoreLines);
+    }
+    // 2. 默认忽略模式
+    ig.add(DEFAULT_IGNORE_PATTERNS);
+    // 3. 敏感文件模式
+    ig.add(SENSITIVE_FILE_PATTERNS);
+    return (relativePath) => ig.ignores(relativePath);
+}
+//# sourceMappingURL=ignore-rules.js.map

package/dist/scanner/ignore-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-rules.js","sourceRoot":"","sources":["../../src/scanner/ignore-rules.ts"],"names":[],"mappings":"AAAA,OAAO,MAAuB,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACtD,OAAO;IACP,eAAe;IACf,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;IACV,OAAO;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACtD,MAAM;IACN,YAAY;IACZ,iBAAiB;IACjB,OAAO;IACP,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,cAAc;IACd,kBAAkB;CACrB,CAAC;AAEF,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IACjD,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC1B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EACpC,OAAO,CACV,CAAC;QACF,OAAO,OAAO;aACT,KAAK,CAAC,OAAO,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACL,6BAA6B;QAC7B,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,WAAmB;IAEnB,MAAM,EAAE,GAAY,CAAE,MAAc,CAAC,OAAO,IAAI,MAAM,CAAS,EAAE,CAAC;IAElE,mBAAmB;IACnB,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC7D,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3B,CAAC;IAED,YAAY;IACZ,EAAE,CAAC,GAAG,CAAC,uBAAmC,CAAC,CAAC;IAE5C,YAAY;IACZ,EAAE,CAAC,GAAG,CAAC,uBAAmC,CAAC,CAAC;IAE5C,OAAO,CAAC,YAAoB,EAAW,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC"}

package/dist/scanner/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module scanner
+ * 文件扫描器统一导出
+ */
+export { DEFAULT_IGNORE_PATTERNS, SENSITIVE_FILE_PATTERNS, createIgnoreFilter, } from './ignore-rules.js';
+export { type ScannerConfig, scanDirectory, } from './file-scanner.js';
+export { buildTreeString, } from './tree-builder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,KAAK,aAAa,EAClB,aAAa,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,eAAe,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/scanner/index.js

@@ -0,0 +1,8 @@
+/**
+ * @module scanner
+ * 文件扫描器统一导出
+ */
+export { DEFAULT_IGNORE_PATTERNS, SENSITIVE_FILE_PATTERNS, createIgnoreFilter, } from './ignore-rules.js';
+export { scanDirectory, } from './file-scanner.js';
+export { buildTreeString, } from './tree-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/scanner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEH,aAAa,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,eAAe,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/scanner/tree-builder.d.ts

@@ -0,0 +1,20 @@
+import type { FileNode } from '../models/file-reference.js';
+/**
+ * 将扁平的 {@link FileNode} 列表渲染为可读的树形文本，类似 `tree` 命令输出。
+ *
+ * 使用 Unicode box-drawing 字符绘制分支 (├──, └──, │)。
+ * 输出末尾附带文件数 / 目录数汇总。
+ *
+ * @param files    - 扁平的 FileNode 列表 (由 `scanDirectory` 返回)
+ * @param rootPath - 项目根目录的绝对路径
+ * @returns 多行字符串形式的目录树
+ *
+ * @example
+ * ```ts
+ * const files = await scanDirectory('/project');
+ * const tree  = buildTreeString(files, '/project');
+ * console.log(tree);
+ * ```
+ */
+export declare function buildTreeString(files: FileNode[], rootPath: string): string;
+//# sourceMappingURL=tree-builder.d.ts.map

package/dist/scanner/tree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../../src/scanner/tree-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAuH5D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB3E"}

package/dist/scanner/tree-builder.js

@@ -0,0 +1,118 @@
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// 辅助函数
+// ---------------------------------------------------------------------------
+/**
+ * 将扁平文件列表构建为嵌套树结构。
+ */
+function buildTree(files, rootPath) {
+    const root = {
+        name: path.basename(rootPath),
+        isDir: true,
+        children: new Map(),
+    };
+    for (const file of files) {
+        const segments = file.relativePath.split('/');
+        let current = root;
+        for (let i = 0; i < segments.length; i++) {
+            const seg = segments[i];
+            const isLast = i === segments.length - 1;
+            if (!current.children.has(seg)) {
+                current.children.set(seg, {
+                    name: seg,
+                    isDir: !isLast,
+                    children: new Map(),
+                });
+            }
+            current = current.children.get(seg);
+        }
+    }
+    return root;
+}
+/**
+ * 统计树中所有叶子文件数量。
+ */
+function countFiles(node) {
+    if (!node.isDir || node.children.size === 0) {
+        return node.isDir ? 0 : 1;
+    }
+    let count = 0;
+    for (const child of node.children.values()) {
+        count += countFiles(child);
+    }
+    return count;
+}
+/**
+ * 统计树中所有目录数量 (不含根节点自身)。
+ */
+function countDirectories(node) {
+    let count = 0;
+    for (const child of node.children.values()) {
+        if (child.isDir) {
+            count += 1 + countDirectories(child);
+        }
+    }
+    return count;
+}
+/**
+ * 递归渲染树字符串。
+ *
+ * @param node   - 当前节点
+ * @param prefix - 当前行前缀 (用于缩进)
+ * @param lines  - 输出行收集器
+ */
+function renderNode(node, prefix, lines) {
+    // 对子节点排序: 目录在前，同类按名称排序
+    const sorted = [...node.children.entries()].sort(([, a], [, b]) => {
+        if (a.isDir !== b.isDir) {
+            return a.isDir ? -1 : 1;
+        }
+        return a.name.localeCompare(b.name);
+    });
+    for (let i = 0; i < sorted.length; i++) {
+        const [, child] = sorted[i];
+        const isLast = i === sorted.length - 1;
+        const connector = isLast ? '\u2514\u2500\u2500 ' : '\u251C\u2500\u2500 ';
+        const childPrefix = isLast ? '    ' : '\u2502   ';
+        const displayName = child.isDir ? `${child.name}/` : child.name;
+        lines.push(`${prefix}${connector}${displayName}`);
+        if (child.isDir && child.children.size > 0) {
+            renderNode(child, prefix + childPrefix, lines);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// 核心 API
+// ---------------------------------------------------------------------------
+/**
+ * 将扁平的 {@link FileNode} 列表渲染为可读的树形文本，类似 `tree` 命令输出。
+ *
+ * 使用 Unicode box-drawing 字符绘制分支 (├──, └──, │)。
+ * 输出末尾附带文件数 / 目录数汇总。
+ *
+ * @param files    - 扁平的 FileNode 列表 (由 `scanDirectory` 返回)
+ * @param rootPath - 项目根目录的绝对路径
+ * @returns 多行字符串形式的目录树
+ *
+ * @example
+ * ```ts
+ * const files = await scanDirectory('/project');
+ * const tree  = buildTreeString(files, '/project');
+ * console.log(tree);
+ * ```
+ */
+export function buildTreeString(files, rootPath) {
+    if (files.length === 0) {
+        const rootName = path.basename(rootPath);
+        return `${rootName}/\n\n0 directories, 0 files`;
+    }
+    const root = buildTree(files, rootPath);
+    const lines = [`${root.name}/`];
+    renderNode(root, '', lines);
+    const dirCount = countDirectories(root);
+    const fileCount = countFiles(root);
+    lines.push('');
+    lines.push(`${dirCount} directories, ${fileCount} files`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=tree-builder.js.map

package/dist/scanner/tree-builder.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "repowiki-core",
+  "version": "0.1.0",
+  "description": "RepoWiki 核心分析引擎",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "fast-glob": "^3.3.0",
+    "ignore": "^5.3.0",
+    "handlebars": "^4.7.8",
+    "dotenv": "^16.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "rimraf": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "test": "vitest run"
+  }
+}