@notedge/panduck 0.0.0 → 0.0.1

package/bin/{panduck.mjs → panduck}

@@ -1,11 +1,11 @@
-#!/usr/bin/env node
-
-import { createJiti } from "jiti";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const jiti = createJiti(import.meta.url, { interopDefault: true });
-const { runCli } = await jiti.import(join(here, "../src/cli/main.ts"));
-
-process.exit(await runCli(process.argv.slice(2)));
+#!/usr/bin/env node
+
+import { createJiti } from "jiti";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const jiti = createJiti(import.meta.url, { interopDefault: true });
+const { runCli } = await jiti.import(join(here, "../src/cli/main.ts"));
+
+process.exit(await runCli(process.argv.slice(2)));

package/locales/en-US/cli.json

@@ -1,46 +1,46 @@
-{
-  "cli.intro": "panduck — document conversion orchestrator for notedown-ir::DocumentGraph",
-  "cli.cmd.convert": "Convert one input document to a target format",
-  "cli.cmd.plan": "Probe input and plan a conversion pipeline without writing output",
-  "cli.cmd.inspect": "Inspect input format and container structure",
-  "cli.cmd.check": "Validate source or generated output against Panduck contracts",
-  "cli.cmd.formats": "List format capabilities from the shared registry",
-  "cli.cmd.doctor": "Check CLI install, native bindings, and environment",
-  "cli.opt.to": "Target format ID (e.g. epub, docx, markdown, notedown)",
-  "cli.opt.from": "Source format ID when detection should be skipped",
-  "cli.opt.output": "Output file path, or - for stdout",
-  "cli.opt.profile": "Named conversion profile from config",
-  "cli.opt.config": "Path to Panduck config file",
-  "cli.opt.assets-dir": "Output assets root directory",
-  "cli.opt.asset-policy": "Asset handling: preserve, copy, embed, or drop",
-  "cli.opt.link-policy": "Link handling: preserve, rewrite, or drop",
-  "cli.opt.loss": "Loss policy: allow, warn, or deny",
-  "cli.opt.strict": "Reject unknown coverage in addition to loss",
-  "cli.opt.allow-partial": "Allow publishing partial source reads when the writer accepts them",
-  "cli.opt.diagnostics": "Diagnostics channel: silent, human, or json",
-  "cli.opt.batch": "Process multiple inputs independently",
-  "cli.opt.output-dir": "Batch output directory",
-  "cli.opt.report": "Write JSON report to a file, or - for stdout",
-  "cli.opt.overwrite": "Replace an existing output file",
-  "cli.opt.budget": "Parse budget limit (repeatable KEY=VALUE)",
-  "cli.opt.dry-run": "Alias for plan-style validation on convert",
-  "cli.opt.stage": "Inspect depth: probe, index, decode, or validate",
-  "cli.opt.path": "Layout path inside a container (inspect)",
-  "cli.opt.operation": "Filter formats by read or write operation",
-  "cli.opt.json": "Emit machine-readable JSON on stdout",
-  "cli.opt.log-file": "Append structured console events to a JSON lines log file",
-  "cli.err.same_path": "Input and output paths must not be the same: {path}",
-  "cli.err.missing_to_stdout": "Writing to stdout requires an explicit --to format",
-  "cli.err.missing_input": "Input path is required",
-  "cli.err.stdin_batch": "Standard input cannot be used with --batch",
-  "cli.err.ambiguous_format": "Ambiguous input format; specify --from explicitly",
-  "cli.err.unsupported_target": "Target format {format} is not ready for {operation}",
-  "cli.err.unsupported_source": "Source format {format} is not ready for read",
-  "cli.err.output_exists": "Output already exists; pass --overwrite to replace it",
-  "cli.err.not_implemented": "Pipeline step not implemented yet: {step}",
-  "cli.err.invalid_policy": "Invalid {name}: {value}",
-  "cli.msg.plan_ready": "Plan complete",
-  "cli.msg.convert_blocked": "Conversion blocked by capability registry",
-  "cli.msg.doctor_ok": "Panduck environment looks healthy",
-  "cli.msg.doctor_issues": "Panduck environment has issues"
-}
+{
+  "cli.intro": "panduck — document conversion orchestrator for notedown-ir::DocumentGraph",
+  "cli.cmd.convert": "Convert one input document to a target format",
+  "cli.cmd.plan": "Probe input and plan a conversion pipeline without writing output",
+  "cli.cmd.inspect": "Inspect input format and container structure",
+  "cli.cmd.check": "Validate source or generated output against Panduck contracts",
+  "cli.cmd.formats": "List format capabilities from the shared registry",
+  "cli.cmd.doctor": "Check CLI install, native bindings, and environment",
+  "cli.opt.to": "Target format ID (e.g. epub, docx, markdown, notedown)",
+  "cli.opt.from": "Source format ID when detection should be skipped",
+  "cli.opt.output": "Output file path, or - for stdout",
+  "cli.opt.profile": "Named conversion profile from config",
+  "cli.opt.config": "Path to Panduck config file",
+  "cli.opt.assets-dir": "Output assets root directory",
+  "cli.opt.asset-policy": "Asset handling: preserve, copy, embed, or drop",
+  "cli.opt.link-policy": "Link handling: preserve, rewrite, or drop",
+  "cli.opt.loss": "Loss policy: allow, warn, or deny",
+  "cli.opt.strict": "Reject unknown coverage in addition to loss",
+  "cli.opt.allow-partial": "Allow publishing partial source reads when the writer accepts them",
+  "cli.opt.diagnostics": "Diagnostics channel: silent, human, or json",
+  "cli.opt.batch": "Process multiple inputs independently",
+  "cli.opt.output-dir": "Batch output directory",
+  "cli.opt.report": "Write JSON report to a file, or - for stdout",
+  "cli.opt.overwrite": "Replace an existing output file",
+  "cli.opt.budget": "Parse budget limit (repeatable KEY=VALUE)",
+  "cli.opt.dry-run": "Alias for plan-style validation on convert",
+  "cli.opt.stage": "Inspect depth: probe, index, decode, or validate",
+  "cli.opt.path": "Layout path inside a container (inspect)",
+  "cli.opt.operation": "Filter formats by read or write operation",
+  "cli.opt.json": "Emit machine-readable JSON on stdout",
+  "cli.opt.log-file": "Append structured console events to a JSON lines log file",
+  "cli.err.same_path": "Input and output paths must not be the same: {path}",
+  "cli.err.missing_to_stdout": "Writing to stdout requires an explicit --to format",
+  "cli.err.missing_input": "Input path is required",
+  "cli.err.stdin_batch": "Standard input cannot be used with --batch",
+  "cli.err.ambiguous_format": "Ambiguous input format; specify --from explicitly",
+  "cli.err.unsupported_target": "Target format {format} is not ready for {operation}",
+  "cli.err.unsupported_source": "Source format {format} is not ready for read",
+  "cli.err.output_exists": "Output already exists; pass --overwrite to replace it",
+  "cli.err.not_implemented": "Pipeline step not implemented yet: {step}",
+  "cli.err.invalid_policy": "Invalid {name}: {value}",
+  "cli.msg.plan_ready": "Plan complete",
+  "cli.msg.convert_blocked": "Conversion blocked by capability registry",
+  "cli.msg.doctor_ok": "Panduck environment looks healthy",
+  "cli.msg.doctor_issues": "Panduck environment has issues"
+}

package/locales/locales.json

@@ -1,7 +1,7 @@
-{
-  "defaultLocale": "en-US",
-  "locales": [
-    { "id": "en-US", "label": "English", "direction": "ltr" },
-    { "id": "zh-CN", "label": "简体中文", "direction": "ltr" }
-  ]
-}
+{
+  "defaultLocale": "en-US",
+  "locales": [
+    { "id": "en-US", "label": "English", "direction": "ltr" },
+    { "id": "zh-CN", "label": "简体中文", "direction": "ltr" }
+  ]
+}

package/locales/zh-CN/cli.json

@@ -1,46 +1,46 @@
-{
-  "cli.intro": "panduck — 面向 notedown-ir::DocumentGraph 的文档转换编排器",
-  "cli.cmd.convert": "将单个输入文档转换为目标格式",
-  "cli.cmd.plan": "探测输入并规划转换流水线，不写输出",
-  "cli.cmd.inspect": "查看输入格式与容器结构",
-  "cli.cmd.check": "按 Panduck 合同校验源文件或已生成输出",
-  "cli.cmd.formats": "列出共享注册表中的格式能力",
-  "cli.cmd.doctor": "检查 CLI 安装、原生绑定与环境",
-  "cli.opt.to": "目标格式 ID（如 epub、docx、markdown、notedown）",
-  "cli.opt.from": "在跳过自动探测时指定源格式 ID",
-  "cli.opt.output": "输出文件路径，或 - 表示标准输出",
-  "cli.opt.profile": "配置中的命名转换 profile",
-  "cli.opt.config": "Panduck 配置文件路径",
-  "cli.opt.assets-dir": "输出资产根目录",
-  "cli.opt.asset-policy": "资产策略：preserve、copy、embed 或 drop",
-  "cli.opt.link-policy": "链接策略：preserve、rewrite 或 drop",
-  "cli.opt.loss": "损失策略：allow、warn 或 deny",
-  "cli.opt.strict": "除损失外还拒绝 unknown coverage",
-  "cli.opt.allow-partial": "在 writer 接受时允许发布 partial 源读取",
-  "cli.opt.diagnostics": "诊断通道：silent、human 或 json",
-  "cli.opt.batch": "独立处理多个输入",
-  "cli.opt.output-dir": "批处理输出目录",
-  "cli.opt.report": "将 JSON 报告写入文件，或 - 表示标准输出",
-  "cli.opt.overwrite": "覆盖已存在的输出文件",
-  "cli.opt.budget": "解析预算上限（可重复 KEY=VALUE）",
-  "cli.opt.dry-run": "在 convert 上等价于 plan 式校验",
-  "cli.opt.stage": "inspect 深度：probe、index、decode 或 validate",
-  "cli.opt.path": "容器内布局路径（inspect）",
-  "cli.opt.operation": "按 read 或 write 过滤格式",
-  "cli.opt.json": "在标准输出打印机器可读 JSON",
-  "cli.opt.log-file": "将结构化 console 事件追加写入 JSON lines 日志文件",
-  "cli.err.same_path": "输入与输出路径不能相同：{path}",
-  "cli.err.missing_to_stdout": "写入标准输出时必须显式指定 --to 格式",
-  "cli.err.missing_input": "必须提供输入路径",
-  "cli.err.stdin_batch": "标准输入不能与 --batch 同时使用",
-  "cli.err.ambiguous_format": "输入格式存在歧义，请显式指定 --from",
-  "cli.err.unsupported_target": "目标格式 {format} 尚未就绪，无法 {operation}",
-  "cli.err.unsupported_source": "源格式 {format} 尚未就绪，无法读取",
-  "cli.err.output_exists": "输出已存在，请使用 --overwrite 覆盖",
-  "cli.err.not_implemented": "流水线步骤尚未实现：{step}",
-  "cli.err.invalid_policy": "无效的 {name}：{value}",
-  "cli.msg.plan_ready": "规划完成",
-  "cli.msg.convert_blocked": "能力注册表阻止了转换",
-  "cli.msg.doctor_ok": "Panduck 环境正常",
-  "cli.msg.doctor_issues": "Panduck 环境存在问题"
-}
+{
+  "cli.intro": "panduck — 面向 notedown-ir::DocumentGraph 的文档转换编排器",
+  "cli.cmd.convert": "将单个输入文档转换为目标格式",
+  "cli.cmd.plan": "探测输入并规划转换流水线，不写输出",
+  "cli.cmd.inspect": "查看输入格式与容器结构",
+  "cli.cmd.check": "按 Panduck 合同校验源文件或已生成输出",
+  "cli.cmd.formats": "列出共享注册表中的格式能力",
+  "cli.cmd.doctor": "检查 CLI 安装、原生绑定与环境",
+  "cli.opt.to": "目标格式 ID（如 epub、docx、markdown、notedown）",
+  "cli.opt.from": "在跳过自动探测时指定源格式 ID",
+  "cli.opt.output": "输出文件路径，或 - 表示标准输出",
+  "cli.opt.profile": "配置中的命名转换 profile",
+  "cli.opt.config": "Panduck 配置文件路径",
+  "cli.opt.assets-dir": "输出资产根目录",
+  "cli.opt.asset-policy": "资产策略：preserve、copy、embed 或 drop",
+  "cli.opt.link-policy": "链接策略：preserve、rewrite 或 drop",
+  "cli.opt.loss": "损失策略：allow、warn 或 deny",
+  "cli.opt.strict": "除损失外还拒绝 unknown coverage",
+  "cli.opt.allow-partial": "在 writer 接受时允许发布 partial 源读取",
+  "cli.opt.diagnostics": "诊断通道：silent、human 或 json",
+  "cli.opt.batch": "独立处理多个输入",
+  "cli.opt.output-dir": "批处理输出目录",
+  "cli.opt.report": "将 JSON 报告写入文件，或 - 表示标准输出",
+  "cli.opt.overwrite": "覆盖已存在的输出文件",
+  "cli.opt.budget": "解析预算上限（可重复 KEY=VALUE）",
+  "cli.opt.dry-run": "在 convert 上等价于 plan 式校验",
+  "cli.opt.stage": "inspect 深度：probe、index、decode 或 validate",
+  "cli.opt.path": "容器内布局路径（inspect）",
+  "cli.opt.operation": "按 read 或 write 过滤格式",
+  "cli.opt.json": "在标准输出打印机器可读 JSON",
+  "cli.opt.log-file": "将结构化 console 事件追加写入 JSON lines 日志文件",
+  "cli.err.same_path": "输入与输出路径不能相同：{path}",
+  "cli.err.missing_to_stdout": "写入标准输出时必须显式指定 --to 格式",
+  "cli.err.missing_input": "必须提供输入路径",
+  "cli.err.stdin_batch": "标准输入不能与 --batch 同时使用",
+  "cli.err.ambiguous_format": "输入格式存在歧义，请显式指定 --from",
+  "cli.err.unsupported_target": "目标格式 {format} 尚未就绪，无法 {operation}",
+  "cli.err.unsupported_source": "源格式 {format} 尚未就绪，无法读取",
+  "cli.err.output_exists": "输出已存在，请使用 --overwrite 覆盖",
+  "cli.err.not_implemented": "流水线步骤尚未实现：{step}",
+  "cli.err.invalid_policy": "无效的 {name}：{value}",
+  "cli.msg.plan_ready": "规划完成",
+  "cli.msg.convert_blocked": "能力注册表阻止了转换",
+  "cli.msg.doctor_ok": "Panduck 环境正常",
+  "cli.msg.doctor_issues": "Panduck 环境存在问题"
+}

package/package.json

@@ -1,52 +1,47 @@
 {
-  "bin": {
-    "panduck": "./bin/panduck.mjs"
-  },
-  "dependencies": {
-    "@vmz/commander": "^0.2.0",
-    "jiti": "^2.4.2"
-  },
+  "name": "@notedge/panduck",
+  "version": "0.0.1",
   "description": "Panduck document conversion bindings (Node-API + TypeScript)",
-  "devDependencies": {
-    "@types/node": "^22.13.10",
-    "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+  "type": "module",
+  "license": "MPL-2.0",
+  "bin": {
+    "panduck": "bin/panduck"
   },
-  "engines": {
-    "node": ">=20"
+  "publishConfig": {
+    "access": "public"
   },
   "exports": {
     ".": "./src/index.ts",
-    "./cli": "./src/cli/index.ts",
     "./node": "./src/node/index.ts",
-    "./wasm": "./src/wasm/index.ts"
+    "./wasm": "./src/wasm/index.ts",
+    "./cli": "./src/cli/index.ts"
   },
   "files": [
     "bin",
     "locales",
     "src"
   ],
-  "license": "MPL-2.0",
-  "name": "@notedge/panduck",
-  "optionalDependencies": {
-    "@notedge/panduck-darwin-arm64": "0.0.0",
-    "@notedge/panduck-darwin-x64": "0.0.0",
-    "@notedge/panduck-linux-arm64": "0.0.0",
-    "@notedge/panduck-linux-x64": "0.0.0",
-    "@notedge/panduck-unknown-wasm32": "0.0.0",
-    "@notedge/panduck-win32-x64": "0.0.0"
+  "engines": {
+    "node": ">=20"
   },
-  "publishConfig": {
-    "access": "public"
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test:e2e": "tsx --test tests/**/*.test.ts"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/oovm/npm-tools.git"
+  "dependencies": {
+    "@vmz/commander": "^0.2.0",
+    "jiti": "^2.4.2"
   },
-  "scripts": {
-    "test:e2e": "tsx --test tests/**/*.test.ts",
-    "typecheck": "tsc --noEmit"
+  "optionalDependencies": {
+    "@notedge/panduck-darwin-arm64": "0.0.1",
+    "@notedge/panduck-darwin-x64": "0.0.1",
+    "@notedge/panduck-linux-arm64": "0.0.1",
+    "@notedge/panduck-linux-x64": "0.0.1",
+    "@notedge/panduck-win32-x64": "0.0.1",
+    "@notedge/panduck-unknown-wasm32": "0.0.1"
   },
-  "type": "module",
-  "version": "0.0.0"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notedge/panduck.git"
+  }
 }

package/readme.md

@@ -1,5 +1,5 @@
-# @notedge/panduck
-
-TypeScript loader for Panduck Node-API bindings under the `@notedge` scope.
-
-Build native artifacts first: `pnpm run build:napi` at the repo root.
+# @notedge/panduck
+
+TypeScript loader for Panduck Node-API bindings under the `@notedge` scope.
+
+Build native artifacts first: `pnpm run build:napi` at the repo root.

package/src/cli/cli.ts

@@ -1,28 +1,28 @@
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { createCli } from "@vmz/commander";
-
-import { registerCheckCommand } from "./commands/check-cmd.js";
-import { registerConvertCommand } from "./commands/convert-cmd.js";
-import { registerDoctorCommand } from "./commands/doctor-cmd.js";
-import { registerFormatsCommand } from "./commands/formats-cmd.js";
-import { registerInspectCommand } from "./commands/inspect-cmd.js";
-import { registerPlanCommand } from "./commands/plan-cmd.js";
-
-export function buildPanduckCli() {
-    const localesRoot = join(dirname(fileURLToPath(import.meta.url)), "../../locales");
-    const cli = createCli("panduck")
-        .locales(localesRoot, { envKeys: ["PANDUCK_LOCALE", "LOCALE", "LANG", "LC_ALL"] })
-        .intro("cli.intro")
-        .option("--log-file <file>", "cli.opt.log-file");
-
-    registerConvertCommand(cli);
-    registerPlanCommand(cli);
-    registerInspectCommand(cli);
-    registerCheckCommand(cli);
-    registerFormatsCommand(cli);
-    registerDoctorCommand(cli);
-
-    return cli;
-}
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createCli } from "@vmz/commander";
+
+import { registerCheckCommand } from "./commands/check-cmd.js";
+import { registerConvertCommand } from "./commands/convert-cmd.js";
+import { registerDoctorCommand } from "./commands/doctor-cmd.js";
+import { registerFormatsCommand } from "./commands/formats-cmd.js";
+import { registerInspectCommand } from "./commands/inspect-cmd.js";
+import { registerPlanCommand } from "./commands/plan-cmd.js";
+
+export function buildPanduckCli() {
+    const localesRoot = join(dirname(fileURLToPath(import.meta.url)), "../../locales");
+    const cli = createCli("panduck")
+        .locales(localesRoot, { envKeys: ["PANDUCK_LOCALE", "LOCALE", "LANG", "LC_ALL"] })
+        .intro("cli.intro")
+        .option("--log-file <file>", "cli.opt.log-file");
+
+    registerConvertCommand(cli);
+    registerPlanCommand(cli);
+    registerInspectCommand(cli);
+    registerCheckCommand(cli);
+    registerFormatsCommand(cli);
+    registerDoctorCommand(cli);
+
+    return cli;
+}