tooldock-cli 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,31 @@
1
- # Temporary Holding Version
1
+ # tooldock-cli
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ ToolDock 擴充開發工具,指令名稱是 `tooldock-ext`。這個套件沒有任何相依套件。
4
+
5
+ ```bash
6
+ npm install -D tooldock-cli
7
+ ```
8
+
9
+ 用 `npm create tooldock-extension` 建立的專案已經內建,不需要另外安裝。
10
+
11
+ | 指令 | 說明 |
12
+ |---|---|
13
+ | `tooldock-ext dev` | 以開發模式啟動 ToolDock 並載入目前的擴充。使用獨立的資料目錄,存檔後自動重新載入 |
14
+ | `tooldock-ext dev --inspect[=port]` | 後端開啟 Node inspector(預設 9229) |
15
+ | `tooldock-ext dev --inspect-brk[=port]` | 同上,並停在第一行等待除錯器 |
16
+ | `tooldock-ext dev --fresh` | 使用全新的暫存資料目錄 |
17
+ | `tooldock-ext validate` | 檢查 manifest、進入點、畫面檔、指令註冊、設定型別、相依是否已安裝 |
18
+ | `tooldock-ext pack [--out dir]` | 打包成 `.tbx`,只含 `dependencies` 的完整相依樹,並套用 `.tbxignore` |
19
+ | `tooldock-ext install` | 打包並安裝到本機的 ToolDock |
20
+
21
+ **ToolDock 位置**
22
+
23
+ 依序尋找以下位置:
24
+ 1. `--app <路徑>`
25
+ 2. 環境變數 `TOOLDOCK_PATH`
26
+ 3. 預設安裝位置:
27
+ - macOS:`/Applications`、`~/Applications`
28
+ - Windows:`%LOCALAPPDATA%\Programs`、`%ProgramFiles%`
29
+ - Linux:`/opt/ToolDock`
30
+
31
+ 路徑可以指向 `.app`、執行檔,或平台原始碼目錄。
@@ -0,0 +1,141 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+ const fs = require('fs');
4
+ const os = require('os');
5
+ const path = require('path');
6
+ const { spawn } = require('child_process');
7
+ const { validate } = require('../lib/manifest');
8
+ const { pack } = require('../lib/pack');
9
+ const { findApp } = require('../lib/find-app');
10
+
11
+ const tty = process.stdout.isTTY;
12
+ const color = (n) => (s) => (tty ? `\x1b[${n}m${s}\x1b[0m` : String(s));
13
+ const red = color(31);
14
+ const green = color(32);
15
+ const yellow = color(33);
16
+ const dim = color(2);
17
+ const bold = color(1);
18
+
19
+ const HELP = `
20
+ ${bold('tooldock-ext')} — ToolDock 擴充開發工具
21
+
22
+ 用法:tooldock-ext <指令> [選項]
23
+
24
+ 指令:
25
+ dev 以開發模式啟動 ToolDock 並載入目前的擴充(存檔即重載)
26
+ --inspect[=port] 後端開啟偵錯埠(預設 9229)
27
+ --inspect-brk[=port] 同上,並暫停在第一行等待除錯器
28
+ --fresh 使用全新的暫存資料目錄(乾淨狀態)
29
+ --app <路徑> 指定 ToolDock 執行檔、.app 或平台原始碼目錄
30
+ validate 檢查 manifest、檔案與相依套件
31
+ pack 打包成 .tbx(只含正式相依)
32
+ --out <資料夾> 輸出目錄(預設 dist)
33
+ install 打包並安裝到本機的 ToolDock(平台執行中時會轉交給執行中的視窗)
34
+ --app <路徑>
35
+ help 顯示說明
36
+
37
+ 環境變數:TOOLDOCK_PATH 指定 ToolDock 位置
38
+ `;
39
+
40
+ function parse(argv) {
41
+ const [cmd = 'help', ...rest] = argv;
42
+ const opts = {};
43
+ for (let i = 0; i < rest.length; i++) {
44
+ const m = rest[i].match(/^--([a-z-]+)(?:=(.*))?$/);
45
+ if (!m) continue;
46
+ const [, k, v] = m;
47
+ if (v !== undefined) opts[k] = v;
48
+ else if (['app', 'out'].includes(k) && rest[i + 1] && !rest[i + 1].startsWith('--')) opts[k] = rest[++i];
49
+ else opts[k] = true;
50
+ }
51
+ return { cmd, opts };
52
+ }
53
+
54
+ function report(result) {
55
+ for (const w of result.warnings) console.log(`${yellow('⚠')} ${w}`);
56
+ for (const e of result.errors) console.log(`${red('✘')} ${e}`);
57
+ }
58
+
59
+ function runValidate(root, { quiet } = {}) {
60
+ const r = validate(root);
61
+ report(r);
62
+ if (r.errors.length) {
63
+ console.log(red(`\n驗證失敗:${r.errors.length} 個錯誤`));
64
+ process.exit(1);
65
+ }
66
+ if (!quiet) console.log(green(`✔ ${r.id}@${r.pkg.version} 驗證通過${r.warnings.length ? `(${r.warnings.length} 個警告)` : ''}`));
67
+ return r;
68
+ }
69
+
70
+ function run(command, args) {
71
+ return new Promise((resolve) => {
72
+ const child = spawn(command, args, { stdio: 'inherit' });
73
+ const forward = (sig) => () => child.kill(sig);
74
+ process.on('SIGINT', forward('SIGINT'));
75
+ process.on('SIGTERM', forward('SIGTERM'));
76
+ child.on('exit', (code) => resolve(code ?? 0));
77
+ child.on('error', (err) => { console.error(red(err.message)); resolve(1); });
78
+ });
79
+ }
80
+
81
+ async function cmdDev(root, opts) {
82
+ const r = runValidate(root, { quiet: true });
83
+ const app = findApp(opts.app);
84
+ const args = [...app.baseArgs, `--extension-dev-path=${root}`];
85
+ const inspect = opts['inspect-brk'] || opts.inspect;
86
+ // --inspect 不帶值時為 true,使用預設 9229
87
+ const port = typeof inspect === 'string' && Number(inspect) >= 1024 ? Number(inspect) : 9229;
88
+ if (inspect) {
89
+ args.push(`--${opts['inspect-brk'] ? 'inspect-brk' : 'inspect'}-extensions=${port}`);
90
+ }
91
+ if (opts.fresh) args.push(`--user-data-dir=${fs.mkdtempSync(path.join(os.tmpdir(), 'tooldock-dev-'))}`);
92
+ console.log(`${bold('ToolDock 擴充開發模式')}
93
+ 擴充 ${r.manifest.displayName || r.id} ${dim(`(${r.id}@${r.pkg.version})`)}
94
+ 平台 ${app.label}
95
+ 重新載入 存檔後自動重新載入後端與畫面${inspect ? `
96
+ 偵錯 後端 inspector 127.0.0.1:${port}${opts['inspect-brk'] ? '(暫停中,請附加除錯器)' : ''}
97
+ VS Code:執行「附加到擴充後端」,或在 Chrome 開啟 chrome://inspect` : ''}
98
+ 畫面偵錯 在分頁上按右鍵 →「檢查此畫面」
99
+ ${dim('按 Ctrl+C 結束')}
100
+ `);
101
+ process.exitCode = await run(app.command, args);
102
+ }
103
+
104
+ function cmdPack(root, opts) {
105
+ const r = runValidate(root, { quiet: true });
106
+ const outDir = path.resolve(root, opts.out || 'dist');
107
+ const res = pack(root, { outDir, id: r.id, version: r.pkg.version });
108
+ const shown = path.relative(process.cwd(), res.file);
109
+ console.log(green(`✔ 已打包 ${shown.startsWith('..') ? res.file : shown}`) + dim(`(${res.count} 個檔案,${(res.size / 1024).toFixed(1)} KB)`));
110
+ return res;
111
+ }
112
+
113
+ async function cmdInstall(root, opts) {
114
+ const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'tooldock-pack-'));
115
+ const res = cmdPack(root, { out: tmp });
116
+ const app = findApp(opts.app);
117
+ console.log(dim(`安裝到 ${app.label}…`));
118
+ process.exitCode = await run(app.command, [...app.baseArgs, `--install-extension=${res.file}`]);
119
+ fs.rmSync(tmp, { recursive: true, force: true });
120
+ }
121
+
122
+ (async () => {
123
+ const { cmd, opts } = parse(process.argv.slice(2));
124
+ const root = process.cwd();
125
+ try {
126
+ switch (cmd) {
127
+ case 'dev': await cmdDev(root, opts); break;
128
+ case 'validate': runValidate(root); break;
129
+ case 'pack': cmdPack(root, opts); break;
130
+ case 'install': await cmdInstall(root, opts); break;
131
+ case 'help': case '--help': case '-h': console.log(HELP); break;
132
+ default:
133
+ console.log(red(`未知的指令:${cmd}`));
134
+ console.log(HELP);
135
+ process.exitCode = 1;
136
+ }
137
+ } catch (err) {
138
+ console.error(red(`✘ ${err.message}`));
139
+ process.exitCode = 1;
140
+ }
141
+ })();
@@ -0,0 +1,70 @@
1
+ 'use strict';
2
+ /** 尋找本機安裝的 ToolDock(或平台原始碼目錄,供平台開發者使用) */
3
+ const fs = require('fs');
4
+ const os = require('os');
5
+ const path = require('path');
6
+
7
+ function candidates() {
8
+ const home = os.homedir();
9
+ switch (process.platform) {
10
+ case 'darwin':
11
+ return [
12
+ '/Applications/ToolDock.app',
13
+ path.join(home, 'Applications', 'ToolDock.app'),
14
+ ];
15
+ case 'win32':
16
+ return [
17
+ path.join(process.env.LOCALAPPDATA || '', 'Programs', 'ToolDock', 'ToolDock.exe'),
18
+ path.join(process.env.ProgramFiles || 'C:\\Program Files', 'ToolDock', 'ToolDock.exe'),
19
+ ];
20
+ default:
21
+ return ['/opt/ToolDock/tooldock', '/usr/bin/tooldock', path.join(home, '.local', 'bin', 'tooldock')];
22
+ }
23
+ }
24
+
25
+ /**
26
+ * 回傳 { command, baseArgs, label }
27
+ * - .app 套件 → Contents/MacOS/ToolDock
28
+ * - 執行檔 → 直接執行
29
+ * - 平台原始碼目錄(package.json name = tooldock)→ 用該目錄的 electron 執行
30
+ */
31
+ function resolveTarget(p) {
32
+ if (!p || !fs.existsSync(p)) return null;
33
+ const st = fs.statSync(p);
34
+ if (st.isDirectory() && p.endsWith('.app')) {
35
+ const exe = path.join(p, 'Contents', 'MacOS', 'ToolDock');
36
+ return fs.existsSync(exe) ? { command: exe, baseArgs: [], label: p } : null;
37
+ }
38
+ if (st.isDirectory()) {
39
+ const pkgFile = path.join(p, 'package.json');
40
+ if (!fs.existsSync(pkgFile)) return null;
41
+ const pkg = JSON.parse(fs.readFileSync(pkgFile, 'utf8'));
42
+ if (pkg.name !== 'tooldock') return null;
43
+ let electron;
44
+ try {
45
+ electron = require(require.resolve('electron', { paths: [p] })); // electron 套件匯出執行檔路徑
46
+ } catch {
47
+ throw new Error(`${p} 是平台原始碼,但尚未安裝相依套件(請先在該目錄執行 npm install)`);
48
+ }
49
+ return { command: electron, baseArgs: [p], label: `${p}(原始碼)` };
50
+ }
51
+ return { command: p, baseArgs: [], label: p };
52
+ }
53
+
54
+ function findApp(explicit) {
55
+ const tried = [];
56
+ for (const p of [explicit, process.env.TOOLDOCK_PATH, ...candidates()]) {
57
+ if (!p) continue;
58
+ tried.push(p);
59
+ const t = resolveTarget(path.resolve(p));
60
+ if (t) return t;
61
+ }
62
+ const err = new Error(
63
+ '找不到 ToolDock。請先安裝 ToolDock,或用 --app <路徑> / 環境變數 TOOLDOCK_PATH 指定執行檔(也可指向平台原始碼目錄)。\n'
64
+ + `已尋找:\n ${tried.join('\n ')}`,
65
+ );
66
+ err.code = 'APP_NOT_FOUND';
67
+ throw err;
68
+ }
69
+
70
+ module.exports = { findApp };
@@ -0,0 +1,136 @@
1
+ 'use strict';
2
+ /** 擴充 manifest 檢查(與平台載入規則一致,並多做檔案存在、相依安裝等開發期檢查) */
3
+ const fs = require('fs');
4
+ const path = require('path');
5
+
6
+ const ID_RE = /^[a-z0-9][a-z0-9.-]{0,62}$/;
7
+ const SEMVER_RE = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/;
8
+ const RANGE_RE = /^(\*|(\^|~|>=)?\d+\.\d+\.\d+)$/;
9
+ const EVENT_RE = /^(\*|onStartup|onView:.+|onCommand:.+|onPhase:.+)$/;
10
+
11
+ function readPkg(dir) {
12
+ const file = path.join(dir, 'package.json');
13
+ if (!fs.existsSync(file)) throw new Error(`找不到 ${file},請在擴充專案根目錄執行`);
14
+ try {
15
+ return JSON.parse(fs.readFileSync(file, 'utf8'));
16
+ } catch (err) {
17
+ throw new Error(`package.json 格式錯誤:${err.message}`);
18
+ }
19
+ }
20
+
21
+ function resolveModule(dir, rel) {
22
+ const base = path.resolve(dir, rel);
23
+ for (const c of [base, `${base}.js`, `${base}.cjs`, path.join(base, 'index.js')]) {
24
+ if (fs.existsSync(c) && fs.statSync(c).isFile()) return c;
25
+ }
26
+ return null;
27
+ }
28
+
29
+ /** 從擴充根目錄尋找套件(與 Node 解析方式相同,往上找但不超出根目錄) */
30
+ function findPackage(root, fromDir, name) {
31
+ let dir = fromDir;
32
+ for (;;) {
33
+ const cand = path.join(dir, 'node_modules', name);
34
+ if (fs.existsSync(path.join(cand, 'package.json'))) return cand;
35
+ if (path.resolve(dir) === path.resolve(root)) return null;
36
+ const parent = path.dirname(dir);
37
+ if (parent === dir) return null;
38
+ dir = parent;
39
+ }
40
+ }
41
+
42
+ /** 正式相依(dependencies + optionalDependencies)的完整閉包;devDependencies 不會被打包 */
43
+ function productionPackages(root) {
44
+ const pkg = readPkg(root);
45
+ const keep = new Set();
46
+ const missing = [];
47
+ const visit = (fromDir, deps, optional) => {
48
+ for (const name of Object.keys(deps || {})) {
49
+ const dir = findPackage(root, fromDir, name);
50
+ if (!dir) { if (!optional) missing.push(name); continue; }
51
+ if (keep.has(dir)) continue;
52
+ keep.add(dir);
53
+ let p = {};
54
+ try { p = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')); } catch { /* ignore */ }
55
+ visit(dir, p.dependencies, false);
56
+ visit(dir, p.optionalDependencies, true);
57
+ }
58
+ };
59
+ visit(root, pkg.dependencies, false);
60
+ visit(root, pkg.optionalDependencies, true);
61
+ return { keep, missing };
62
+ }
63
+
64
+ function validate(dir) {
65
+ const errors = [];
66
+ const warnings = [];
67
+ const pkg = readPkg(dir);
68
+ const td = pkg.tooldock;
69
+ if (!td || typeof td !== 'object') {
70
+ return { errors: ['package.json 缺少 "tooldock" 欄位(擴充 manifest)'], warnings, pkg };
71
+ }
72
+ const id = String(td.id || pkg.name || '').toLowerCase();
73
+ if (!ID_RE.test(id)) errors.push(`id "${id}" 不合法:只能使用小寫英數、點與連字號,且以英數開頭`);
74
+ if (!SEMVER_RE.test(pkg.version || '')) errors.push(`version "${pkg.version}" 不是有效的 x.y.z 版本號`);
75
+ if (!td.displayName) warnings.push('建議設定 tooldock.displayName(顯示在工作台的名稱)');
76
+ if (!td.engine) warnings.push('建議設定 tooldock.engine(例如 "^1.0.0"),避免安裝到不相容的平台版本');
77
+ else if (!RANGE_RE.test(td.engine)) errors.push(`engine "${td.engine}" 格式不支援(可用 *、1.2.3、^1.2.3、~1.2.3、>=1.2.3)`);
78
+
79
+ const main = td.main || pkg.main;
80
+ let mainSrc = '';
81
+ if (main) {
82
+ const file = resolveModule(dir, main);
83
+ if (!file) errors.push(`找不到後端進入點 main: "${main}"`);
84
+ else mainSrc = fs.readFileSync(file, 'utf8');
85
+ }
86
+
87
+ const c = td.contributes || {};
88
+ const seen = new Set();
89
+ for (const v of c.views || []) {
90
+ if (!v.id) { errors.push('views[] 缺少 id'); continue; }
91
+ if (seen.has(v.id)) errors.push(`畫面 id 重複:${v.id}`);
92
+ seen.add(v.id);
93
+ if (!v.title) warnings.push(`畫面 ${v.id} 缺少 title`);
94
+ const entry = v.entry || 'ui/index.html';
95
+ const html = path.join(dir, entry);
96
+ if (!fs.existsSync(html)) errors.push(`畫面 ${v.id} 的 entry 不存在:${entry}`);
97
+ else if (!/tooldock:\/\/sdk\/ui-sdk\.js/.test(fs.readFileSync(html, 'utf8'))) {
98
+ warnings.push(`${entry} 沒有載入 tooldock://sdk/ui-sdk.js,將無法使用 window.tooldock`);
99
+ }
100
+ if (v.icon && /\.(svg|png|jpe?g)$/i.test(v.icon) && !fs.existsSync(path.join(dir, v.icon))) errors.push(`畫面 ${v.id} 的 icon 不存在:${v.icon}`);
101
+ }
102
+ const cmdSeen = new Set();
103
+ for (const cmd of c.commands || []) {
104
+ if (!cmd.id) { errors.push('commands[] 缺少 id'); continue; }
105
+ if (cmdSeen.has(cmd.id)) errors.push(`指令 id 重複:${cmd.id}`);
106
+ cmdSeen.add(cmd.id);
107
+ if (!cmd.title) warnings.push(`指令 ${cmd.id} 缺少 title(命令面板顯示用)`);
108
+ if (main && mainSrc && !mainSrc.includes(cmd.id)) warnings.push(`後端程式碼中找不到指令 "${cmd.id}" 的註冊(ctx.commands.register)`);
109
+ }
110
+ for (const ev of td.activationEvents || []) {
111
+ if (!EVENT_RE.test(ev)) errors.push(`不認得的啟用事件 "${ev}"(可用 onStartup、onView:、onCommand:、onPhase:)`);
112
+ }
113
+ if ((td.activationEvents || []).some((e) => e === 'onStartup' || e === '*')) {
114
+ warnings.push('使用 onStartup 會讓擴充隨平台常駐;若非背景服務,建議改用延遲載入');
115
+ }
116
+ for (const [key, def] of Object.entries(c.configuration || {})) {
117
+ if (!['string', 'number', 'boolean'].includes(def.type)) errors.push(`設定 ${key} 的 type 必須是 string / number / boolean`);
118
+ else if (def.default !== undefined && typeof def.default !== def.type) errors.push(`設定 ${key} 的 default 型別與 type 不符`);
119
+ if (def.enum && !Array.isArray(def.enum)) errors.push(`設定 ${key} 的 enum 必須是陣列`);
120
+ }
121
+ for (const [phase, fn] of Object.entries(c.lifecycle || {})) {
122
+ if (!main) errors.push(`contributes.lifecycle 需要後端 main(${phase} → ${fn})`);
123
+ else if (mainSrc && !new RegExp(`\\b${fn}\\b`).test(mainSrc)) warnings.push(`後端程式碼中找不到生命週期函式 ${fn}()(${phase})`);
124
+ }
125
+ if (!main && !(c.views || []).length) warnings.push('既沒有後端 main 也沒有畫面,這個擴充不會做任何事');
126
+
127
+ const { missing } = productionPackages(dir);
128
+ for (const name of missing) errors.push(`相依套件未安裝:${name}(請執行 npm install)`);
129
+ if (Object.keys(pkg.devDependencies || {}).some((d) => (pkg.dependencies || {})[d])) {
130
+ warnings.push('有套件同時列在 dependencies 與 devDependencies');
131
+ }
132
+
133
+ return { errors, warnings, pkg, id, manifest: td };
134
+ }
135
+
136
+ module.exports = { validate, productionPackages, readPkg };
package/lib/pack.js ADDED
@@ -0,0 +1,90 @@
1
+ 'use strict';
2
+ const fs = require('fs');
3
+ const path = require('path');
4
+ const { writeZip } = require('./zip');
5
+ const { productionPackages } = require('./manifest');
6
+
7
+ /** 一律排除(再加上專案的 .tbxignore) */
8
+ const DEFAULT_IGNORE = [
9
+ '.git', '.github', '.vscode', '.idea', '.DS_Store', 'Thumbs.db',
10
+ '*.tbx', '*.log', '.tbxignore', '.gitignore', 'dist/', 'node_modules/.bin', 'node_modules/.cache',
11
+ 'node_modules/.package-lock.json', 'package-lock.json', '*.map',
12
+ ];
13
+
14
+ /** 簡易 gitignore 風格比對:不含 / 的樣式比對任何層級的名稱;以 / 結尾只比對資料夾 */
15
+ function compile(pattern) {
16
+ let p = pattern.trim();
17
+ if (!p || p.startsWith('#')) return null;
18
+ const dirOnly = p.endsWith('/');
19
+ if (dirOnly) p = p.slice(0, -1);
20
+ const anchored = p.startsWith('/') || p.includes('/');
21
+ p = p.replace(/^\//, '');
22
+ const re = p
23
+ .replace(/[.+^${}()|[\]\\]/g, '\\$&')
24
+ .replace(/\*\*\//g, '\u0000')
25
+ .replace(/\*\*/g, '\u0001')
26
+ .replace(/\*/g, '[^/]*')
27
+ .replace(/\?/g, '[^/]')
28
+ .replace(/\u0000/g, '(?:.*/)?')
29
+ .replace(/\u0001/g, '.*');
30
+ const regex = new RegExp(anchored ? `^${re}$` : `(^|/)${re}$`);
31
+ return { regex, dirOnly };
32
+ }
33
+
34
+ function loadIgnore(root) {
35
+ const extra = fs.existsSync(path.join(root, '.tbxignore'))
36
+ ? fs.readFileSync(path.join(root, '.tbxignore'), 'utf8').split(/\r?\n/)
37
+ : [];
38
+ return [...DEFAULT_IGNORE, ...extra].map(compile).filter(Boolean);
39
+ }
40
+
41
+ /** node_modules 中檔案所屬的套件根目錄(處理巢狀與 @scope) */
42
+ function packageRootOf(rel) {
43
+ const parts = rel.split('/');
44
+ let idx = -1;
45
+ for (let i = 0; i < parts.length; i++) if (parts[i] === 'node_modules') idx = i;
46
+ if (idx < 0 || idx + 1 >= parts.length) return null;
47
+ const take = parts[idx + 1].startsWith('@') ? 2 : 1;
48
+ return parts.slice(0, idx + 1 + take).join('/');
49
+ }
50
+
51
+ function collect(root) {
52
+ const rules = loadIgnore(root);
53
+ const { keep, missing } = productionPackages(root);
54
+ if (missing.length) throw new Error(`相依套件未安裝:${missing.join(', ')}(請先執行 npm install)`);
55
+ const keepRel = new Set([...keep].map((d) => path.relative(root, d).split(path.sep).join('/')));
56
+ const ignored = (rel, isDir) => rules.some((r) => (!r.dirOnly || isDir) && r.regex.test(rel));
57
+
58
+ const files = [];
59
+ const walk = (dir) => {
60
+ for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
61
+ const abs = path.join(dir, ent.name);
62
+ const rel = path.relative(root, abs).split(path.sep).join('/');
63
+ const isDir = ent.isDirectory();
64
+ if (ignored(rel, isDir)) continue;
65
+ // 只打包正式相依:devDependencies(例如 tooldock-cli、tooldock-types)不會進入套件
66
+ if (rel.split('/').includes('node_modules')) {
67
+ const isContainer = isDir && (ent.name === 'node_modules' || (ent.name.startsWith('@') && path.basename(dir) === 'node_modules'));
68
+ if (!isContainer && !keepRel.has(packageRootOf(isDir ? `${rel}/_` : rel))) continue;
69
+ }
70
+ if (ent.isSymbolicLink()) {
71
+ const real = fs.statSync(abs);
72
+ if (real.isDirectory()) walk(abs); else files.push({ name: rel, file: abs });
73
+ } else if (isDir) walk(abs);
74
+ else if (ent.isFile()) files.push({ name: rel, file: abs });
75
+ }
76
+ };
77
+ walk(root);
78
+ return files;
79
+ }
80
+
81
+ function pack(root, { outDir, id, version }) {
82
+ const files = collect(root);
83
+ fs.mkdirSync(outDir, { recursive: true });
84
+ const out = path.join(outDir, `${id}-${version}.tbx`);
85
+ // 套件內以擴充 id 為最上層資料夾,平台安裝時會自動辨識
86
+ writeZip(out, files.map((f) => ({ name: `${id}/${f.name}`, file: f.file })));
87
+ return { file: out, count: files.length, size: fs.statSync(out).size };
88
+ }
89
+
90
+ module.exports = { pack, collect };
package/lib/zip.js ADDED
@@ -0,0 +1,92 @@
1
+ 'use strict';
2
+ /** 極簡 ZIP 寫入器(deflate、UTF-8 檔名),讓 CLI 不需任何相依套件 */
3
+ const fs = require('fs');
4
+ const zlib = require('zlib');
5
+
6
+ const CRC_TABLE = (() => {
7
+ const t = new Uint32Array(256);
8
+ for (let n = 0; n < 256; n++) {
9
+ let c = n;
10
+ for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
11
+ t[n] = c >>> 0;
12
+ }
13
+ return t;
14
+ })();
15
+
16
+ function crc32(buf) {
17
+ if (typeof zlib.crc32 === 'function') return zlib.crc32(buf) >>> 0;
18
+ let c = 0xffffffff;
19
+ for (let i = 0; i < buf.length; i++) c = CRC_TABLE[(c ^ buf[i]) & 0xff] ^ (c >>> 8);
20
+ return (c ^ 0xffffffff) >>> 0;
21
+ }
22
+
23
+ function dosTime(d) {
24
+ return {
25
+ time: (d.getHours() << 11) | (d.getMinutes() << 5) | Math.floor(d.getSeconds() / 2),
26
+ date: ((d.getFullYear() - 1980) << 9) | ((d.getMonth() + 1) << 5) | d.getDate(),
27
+ };
28
+ }
29
+
30
+ /**
31
+ * @param {string} outFile
32
+ * @param {Array<{ name: string, file: string }>} entries name 為 zip 內路徑(使用 /)
33
+ */
34
+ function writeZip(outFile, entries) {
35
+ const chunks = [];
36
+ const central = [];
37
+ let offset = 0;
38
+ const { time, date } = dosTime(new Date());
39
+
40
+ for (const e of entries) {
41
+ const data = fs.readFileSync(e.file);
42
+ const deflated = zlib.deflateRawSync(data, { level: 9 });
43
+ const useDeflate = deflated.length < data.length;
44
+ const body = useDeflate ? deflated : data;
45
+ const name = Buffer.from(e.name, 'utf8');
46
+ const crc = crc32(data);
47
+
48
+ const local = Buffer.alloc(30);
49
+ local.writeUInt32LE(0x04034b50, 0);
50
+ local.writeUInt16LE(20, 4); // version needed
51
+ local.writeUInt16LE(0x0800, 6); // UTF-8 檔名
52
+ local.writeUInt16LE(useDeflate ? 8 : 0, 8);
53
+ local.writeUInt16LE(time, 10);
54
+ local.writeUInt16LE(date, 12);
55
+ local.writeUInt32LE(crc, 14);
56
+ local.writeUInt32LE(body.length, 18);
57
+ local.writeUInt32LE(data.length, 22);
58
+ local.writeUInt16LE(name.length, 26);
59
+ local.writeUInt16LE(0, 28);
60
+ chunks.push(local, name, body);
61
+
62
+ const cen = Buffer.alloc(46);
63
+ cen.writeUInt32LE(0x02014b50, 0);
64
+ cen.writeUInt16LE(0x031e, 4); // made by: UNIX, 3.0
65
+ cen.writeUInt16LE(20, 6);
66
+ cen.writeUInt16LE(0x0800, 8);
67
+ cen.writeUInt16LE(useDeflate ? 8 : 0, 10);
68
+ cen.writeUInt16LE(time, 12);
69
+ cen.writeUInt16LE(date, 14);
70
+ cen.writeUInt32LE(crc, 16);
71
+ cen.writeUInt32LE(body.length, 20);
72
+ cen.writeUInt32LE(data.length, 24);
73
+ cen.writeUInt16LE(name.length, 28);
74
+ cen.writeUInt32LE(((0o100644) << 16) >>> 0, 38); // 檔案權限
75
+ cen.writeUInt32LE(offset, 42);
76
+ central.push(cen, name);
77
+
78
+ offset += local.length + name.length + body.length;
79
+ }
80
+
81
+ const cenSize = central.reduce((s, b) => s + b.length, 0);
82
+ const end = Buffer.alloc(22);
83
+ end.writeUInt32LE(0x06054b50, 0);
84
+ end.writeUInt16LE(entries.length, 8);
85
+ end.writeUInt16LE(entries.length, 10);
86
+ end.writeUInt32LE(cenSize, 12);
87
+ end.writeUInt32LE(offset, 16);
88
+
89
+ fs.writeFileSync(outFile, Buffer.concat([...chunks, ...central, end]));
90
+ }
91
+
92
+ module.exports = { writeZip };
package/package.json CHANGED
@@ -1,6 +1,22 @@
1
1
  {
2
2
  "name": "tooldock-cli",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "ToolDock 擴充開發工具:dev(開發模式啟動並偵錯)、validate、pack、install",
5
+ "bin": {
6
+ "tooldock-ext": "bin/tooldock-ext.js"
7
+ },
8
+ "files": [
9
+ "bin",
10
+ "lib",
11
+ "README.md"
12
+ ],
13
+ "engines": {
14
+ "node": ">=18"
15
+ },
16
+ "keywords": [
17
+ "tooldock",
18
+ "extension",
19
+ "cli"
20
+ ],
21
+ "license": "MIT"
22
+ }