agent-ide 0.1.0

package/dist/shared/utils/string.js

@@ -0,0 +1,201 @@
+/**
+ * 將字串的首字母大寫
+ * @param str 待轉換的字串
+ * @returns 首字母大寫的字串
+ */
+export function capitalize(str) {
+    if (!str) {
+        return '';
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * 將字串轉換為駝峰命名
+ * @param str 待轉換的字串
+ * @returns 駝峰命名格式的字串
+ */
+export function camelCase(str) {
+    if (!str) {
+        return '';
+    }
+    return str
+        .replace(/[^\w\s]/g, ' ') // 將特殊字元替換為空格
+        .replace(/_/g, ' ') // 將底線替換為空格
+        .replace(/-/g, ' ') // 將短橫線替換為空格
+        .replace(/\s+/g, ' ') // 將多個空格合併為單個空格
+        .trim()
+        .replace(/(?:^\w|[A-Z]|\b\w)/g, (match, index) => {
+        return index === 0 ? match.toLowerCase() : match.toUpperCase();
+    })
+        .replace(/\s+/g, '');
+}
+/**
+ * 將字串轉換為蛇形命名
+ * @param str 待轉換的字串
+ * @returns 蛇形命名格式的字串
+ */
+export function snakeCase(str) {
+    if (!str) {
+        return '';
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1_$2') // 在小寫字母後的大寫字母前加底線
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2') // 處理連續大寫字母
+        .replace(/[^\w]/g, '_') // 將非字母數字字元替換為底線
+        .replace(/_+/g, '_') // 將多個底線合併為單個底線
+        .replace(/^_|_$/g, '') // 移除開頭和結尾的底線
+        .toLowerCase();
+}
+/**
+ * 將字串轉換為短橫線命名
+ * @param str 待轉換的字串
+ * @returns 短橫線命名格式的字串
+ */
+export function kebabCase(str) {
+    if (!str) {
+        return '';
+    }
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2') // 在小寫字母後的大寫字母前加短橫線
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2') // 處理連續大寫字母
+        .replace(/_/g, '-') // 將底線替換為短橫線
+        .replace(/[^\w-]/g, '-') // 將非字母數字短橫線字元替換為短橫線
+        .replace(/-+/g, '-') // 將多個短橫線合併為單個短橫線
+        .replace(/^-|-$/g, '') // 移除開頭和結尾的短橫線
+        .toLowerCase();
+}
+/**
+ * 截斷字串並添加省略符
+ * @param str 待截斷的字串
+ * @param length 最大長度
+ * @param ellipsis 省略符，預設為 '...'
+ * @returns 截斷後的字串
+ */
+export function truncate(str, length, ellipsis = '...') {
+    if (!str) {
+        return '';
+    }
+    if (length <= 0) {
+        return ellipsis;
+    }
+    if (str.length <= length) {
+        return str;
+    }
+    return str.slice(0, length) + ellipsis;
+}
+/**
+ * 在字串開頭填充字元
+ * @param str 待填充的字串
+ * @param targetLength 目標長度
+ * @param padString 填充字元，預設為空格
+ * @returns 填充後的字串
+ */
+export function padStart(str, targetLength, padString = ' ') {
+    if (!str && targetLength > 0) {
+        return padString.repeat(targetLength);
+    }
+    const currentLength = str.length;
+    if (currentLength >= targetLength) {
+        return str;
+    }
+    const padLength = targetLength - currentLength;
+    const pad = padString.repeat(Math.ceil(padLength / padString.length)).slice(0, padLength);
+    return pad + str;
+}
+/**
+ * 在字串結尾填充字元
+ * @param str 待填充的字串
+ * @param targetLength 目標長度
+ * @param padString 填充字元，預設為空格
+ * @returns 填充後的字串
+ */
+export function padEnd(str, targetLength, padString = ' ') {
+    if (!str && targetLength > 0) {
+        return padString.repeat(targetLength);
+    }
+    const currentLength = str.length;
+    if (currentLength >= targetLength) {
+        return str;
+    }
+    const padLength = targetLength - currentLength;
+    const pad = padString.repeat(Math.ceil(padLength / padString.length)).slice(0, padLength);
+    return str + pad;
+}
+/**
+ * 移除字串的共同縮排
+ * @param str 待處理的字串
+ * @returns 移除縮排後的字串
+ */
+export function stripIndent(str) {
+    if (!str) {
+        return '';
+    }
+    const lines = str.split('\n');
+    // 移除開頭和結尾的空行
+    while (lines.length > 0 && lines[0].trim() === '') {
+        lines.shift();
+    }
+    while (lines.length > 0 && lines[lines.length - 1].trim() === '') {
+        lines.pop();
+    }
+    if (lines.length === 0) {
+        return '';
+    }
+    // 找到最小縮排
+    const indents = lines
+        .filter(line => line.trim() !== '')
+        .map(line => line.match(/^[ \t]*/)?.[0].length ?? 0);
+    const minIndent = Math.min(...indents);
+    // 移除共同縮排
+    return lines
+        .map(line => line.slice(minIndent))
+        .join('\n');
+}
+/**
+ * 跳脫正則表達式特殊字元
+ * @param str 待跳脫的字串
+ * @returns 跳脫後的字串
+ */
+export function escapeRegExp(str) {
+    if (!str) {
+        return '';
+    }
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * 模板字串替換
+ * @param template 模板字串，使用 {{key}} 格式
+ * @param variables 變數物件
+ * @returns 替換後的字串
+ */
+export function template(template, variables) {
+    if (!template) {
+        return '';
+    }
+    return template.replace(/\{\{([^}]+)\}\}/g, (match, key) => {
+        const trimmedKey = key.trim();
+        // 支援巢狀物件存取，如 user.name
+        const value = trimmedKey.split('.').reduce((obj, prop) => {
+            return obj?.[prop];
+        }, variables);
+        return value !== undefined ? String(value) : match;
+    });
+}
+/**
+ * 轉換為 URL 友好的字串
+ * @param str 待轉換的字串
+ * @returns URL 友好的字串
+ */
+export function slugify(str) {
+    if (!str) {
+        return '';
+    }
+    return str
+        .trim()
+        .toLowerCase()
+        .replace(/[^\w\u4e00-\u9fff\s-]/g, ' ') // 將特殊字元替換為空格，保留字母、數字、中文、空格和短橫線
+        .replace(/\s+/g, '-') // 將空格替換為短橫線
+        .replace(/-+/g, '-') // 將多個短橫線合併為單個短橫線
+        .replace(/^-|-$/g, ''); // 移除開頭和結尾的短橫線
+}
+//# sourceMappingURL=string.js.map

package/dist/shared/utils/string.js.map

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

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "agent-ide",
+  "version": "0.1.0",
+  "description": "程式碼智能工具集 for AI Agents",
+  "type": "module",
+  "main": "dist/shared/index.js",
+  "types": "dist/shared/index.d.ts",
+  "bin": {
+    "agent-ide": "./bin/agent-ide.js",
+    "agent-ide-mcp": "./bin/mcp-server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run",
+    "test:watch": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest --watch",
+    "test:run": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run",
+    "test:memory": "NODE_OPTIONS='--expose-gc --max-old-space-size=2048 --trace-gc' npx vitest run --reporter=verbose",
+    "test:coverage": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run --coverage",
+    "test:single": "NODE_OPTIONS='--expose-gc --max-old-space-size=2048' npx vitest run --pool=forks --poolOptions.forks.singleFork=true",
+    "test:failed": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run --reporter=dot",
+    "test:bail": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run --bail=1",
+    "test:e2e": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run --config=vitest.e2e.config.ts",
+    "test:e2e:watch": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest --watch --config=vitest.e2e.config.ts",
+    "test:e2e:coverage": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx vitest run --coverage --config=vitest.e2e.config.ts",
+    "test:all": "npm run test && npm run test:e2e",
+    "test:all:coverage": "npm run test:coverage && npm run test:e2e:coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint 'src/**/*.ts' 'tests/**/*.{ts,js}' --fix",
+    "review:test": "codex \"review 所有測試 code, 把修改建議更新到 review.md\""
+  },
+  "keywords": [
+    "agent-ide",
+    "ast",
+    "parser",
+    "typescript",
+    "code-intelligence"
+  ],
+  "author": "Agent IDE Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vivalalova/agent-ide.git"
+  },
+  "homepage": "https://github.com/vivalalova/agent-ide",
+  "bugs": {
+    "url": "https://github.com/vivalalova/agent-ide/issues"
+  },
+  "devDependencies": {
+    "@babel/generator": "^7.28.3",
+    "@babel/parser": "^7.28.4",
+    "@babel/traverse": "^7.28.4",
+    "@babel/types": "^7.28.4",
+    "@types/babel__generator": "^7.27.0",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/node": "^24.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.44.1",
+    "@typescript-eslint/parser": "^8.44.1",
+    "@vitest/coverage-v8": "^2.1.9",
+    "chokidar": "^4.0.3",
+    "eslint": "^9.36.0",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "memfs": "^4.38.2",
+    "tsx": "^4.20.5",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "glob": "^11.0.3",
+    "web-tree-sitter": "^0.25.10"
+  }
+}