@hagicode/hagi18n 0.1.0-dev.1.1.45d0d2f

package/README.md

@@ -0,0 +1,184 @@
+# Hagi18n
+
+`@hagicode/hagi18n` is a reusable YAML locale maintenance toolkit for HagiCode projects. It was abstracted from the mature Web workflow in `repos/web/buildTools`, but it runs as an independent package and CLI.
+
+It supports:
+
+- Auditing locale trees for missing files, extra files, missing keys, extra keys, placeholder mismatches, parse errors, and protected tokens.
+- Repository hygiene checks for legacy locale references.
+- Safe `sync` and `prune` mutations with dry-run defaults.
+- Optional `hagi18n.yaml` defaults so each project can define its own locale layout.
+
+## Requirements
+
+- Node.js 20 or newer
+- npm for package management
+
+## Installation
+
+```bash
+npm install @hagicode/hagi18n
+```
+
+The installed CLI command is `hagi18n`.
+
+## YAML Locale Layout
+
+The package expects a locale tree like this:
+
+```text
+src/locales/
+  en-US/
+    common.yml
+    features/editor.yml
+  zh-CN/
+    common.yml
+    features/editor.yml
+```
+
+Supported files:
+
+- `.yml`
+- `.yaml`
+
+Supported values:
+
+- top-level mapping documents
+- nested objects
+- arrays
+- scalar translation leaves
+- `{{placeholder}}` interpolation tokens
+
+Common locale aliases such as `en`, `en-us`, `zh`, and `zh-cn` are accepted and normalized to canonical locale names like `en-US` and `zh-CN`.
+
+## Configuration
+
+By default, the CLI looks for `hagi18n.yaml` in the current working directory. You can also pass `--config <path>`.
+
+Example:
+
+```yaml
+localesRoot: src/locales
+repoRoot: .
+baseLocale: en-US
+targetLocales:
+  - zh-CN
+doctor:
+  excludedDirectories:
+    - .git
+    - dist
+    - node_modules
+  textFileExtensions:
+    - .ts
+    - .tsx
+    - .js
+    - .md
+  allowlist:
+    legacy-language-change-call:
+      - src/legacy-test.ts
+```
+
+Precedence is:
+
+1. CLI flags or direct API options
+2. `hagi18n.yaml`
+3. package defaults
+
+Relative paths in `hagi18n.yaml` are resolved from the config file directory.
+
+## CLI Commands
+
+```bash
+hagi18n info
+hagi18n audit
+hagi18n report
+hagi18n doctor
+hagi18n sync
+hagi18n prune
+```
+
+Examples:
+
+```bash
+hagi18n audit --locales-root src/locales --base-locale en-US
+hagi18n audit --config hagi18n.yaml --json
+hagi18n report --config hagi18n.yaml
+hagi18n doctor --config hagi18n.yaml
+hagi18n sync --from en-US --to zh-CN
+hagi18n sync --from en-US --to zh-CN --write
+hagi18n prune --from en-US --to zh-CN --write
+```
+
+`sync` and `prune` are dry-run by default. Pass `--write` to mutate files.
+
+## Option Reference
+
+| Option | Commands | Description |
+| --- | --- | --- |
+| `--config <path>` | all except `info` | Load defaults from a config file |
+| `--locales-root <path>` | audit, report, doctor, sync, prune | Locale root directory |
+| `--base-locale <locale>` | audit, report, doctor | Base locale for comparison |
+| `--from <locale>` | sync, prune | Base locale for mutation commands |
+| `--locale <locale>` | audit, report, doctor | Limit output to one or more locales |
+| `--to <locale>` | sync, prune | Limit mutations to one or more target locales |
+| `--repo-root <path>` | doctor | Repository root for repository scanning |
+| `--json` | audit, doctor, sync, prune | Print JSON instead of text |
+| `--dry-run` | sync, prune | Preview mutations without writing files |
+| `--write` | sync, prune | Apply mutations to disk |
+
+## JSON Output and Exit Codes
+
+- `audit` returns exit code `0` when clean and `1` when issues exist.
+- `report` runs the same audit and always prints JSON.
+- `doctor` returns exit code `1` when audit issues or repository scan issues exist.
+- `sync` and `prune` return exit code `1` only for parse or processing errors. Planned or applied mutations are reported in the summary.
+- Command parsing failures return exit code `1` from the current `commander` integration.
+
+The JSON payload is the same structured summary returned by the TypeScript API.
+
+## TypeScript API
+
+```ts
+import {
+  auditLocaleTree,
+  doctorLocaleTree,
+  formatAuditSummary,
+  pruneLocaleTree,
+  resolveHagi18nConfig,
+  syncLocaleTree
+} from "@hagicode/hagi18n";
+
+const audit = await auditLocaleTree({
+  localesRoot: "src/locales",
+  baseLocale: "en-US"
+});
+
+console.log(formatAuditSummary(audit));
+```
+
+Main exports include:
+
+- configuration helpers such as `findHagi18nConfigPath`, `loadHagi18nConfig`, and `resolveHagi18nConfig`
+- locale helpers such as `normalizeLocaleName`, `listLocaleDirectories`, and `readYamlLocaleFile`
+- workflows such as `auditLocaleTree`, `doctorLocaleTree`, `syncLocaleTree`, and `pruneLocaleTree`
+- text formatters such as `formatAuditSummary`, `formatDoctorSummary`, and `formatMutationSummary`
+- package metadata helpers such as `getPackageMetadata` and `createRuntimeInfo`
+
+## Web Reference Mapping
+
+This package preserves the maintenance model from the Web repository:
+
+- `repos/web/buildTools/lib/i18nLocaleToolkit.mjs` -> `src/locale-toolkit.ts`
+- `repos/web/buildTools/i18n-locale-cli.mjs` -> `src/cli.ts`
+
+The Web project remains the behavior reference, but it does not need runtime changes to use this package later.
+
+## Development
+
+Run commands from `repos/hagi18n/`:
+
+```bash
+npm install
+npm test
+npm run build
+```

package/README_cn.md

@@ -0,0 +1,178 @@
+# Hagi18n
+
+`@hagicode/hagi18n` 是一个可复用的 YAML 语言包维护工具，抽象自 `repos/web/buildTools` 中已经成熟的 Web i18n 工作流，但可以作为独立 npm 包和 CLI 使用。
+
+它提供：
+
+- 语言包树审计：缺失文件、多余文件、缺失 key、多余 key、占位符不匹配、解析错误、受保护 token 检测
+- 仓库级 doctor 检查：扫描旧的 locale 引用方式
+- 安全的 `sync` / `prune` 变更流程，默认 dry-run
+- 可选的 `hagi18n.yaml` 项目配置，适配不同仓库目录结构
+
+## 前提
+
+- Node.js 20 或更高版本
+- 使用 npm 管理依赖
+
+## 安装
+
+```bash
+npm install @hagicode/hagi18n
+```
+
+安装后可直接使用 `hagi18n` 命令。
+
+## YAML 目录结构
+
+默认语言包目录形态如下：
+
+```text
+src/locales/
+  en-US/
+    common.yml
+    features/editor.yml
+  zh-CN/
+    common.yml
+    features/editor.yml
+```
+
+支持：
+
+- `.yml`
+- `.yaml`
+- 顶层为 mapping 的 YAML 文档
+- 嵌套对象、数组、标量翻译值
+- `{{placeholder}}` 占位符
+
+像 `en`、`en-us`、`zh`、`zh-cn` 这样的常见别名会自动规范化为 `en-US`、`zh-CN`。
+
+## 配置文件
+
+CLI 默认会在当前工作目录查找 `hagi18n.yaml`。也可以显式传入 `--config <path>`。
+
+示例：
+
+```yaml
+localesRoot: src/locales
+repoRoot: .
+baseLocale: en-US
+targetLocales:
+  - zh-CN
+doctor:
+  excludedDirectories:
+    - .git
+    - dist
+    - node_modules
+  textFileExtensions:
+    - .ts
+    - .tsx
+    - .js
+    - .md
+  allowlist:
+    legacy-language-change-call:
+      - src/legacy-test.ts
+```
+
+优先级：
+
+1. CLI 参数或直接 API 传参
+2. `hagi18n.yaml`
+3. 包内默认值
+
+`hagi18n.yaml` 中的相对路径会相对于配置文件所在目录解析，因此不同项目可以用它自定义 `baseLocale`、`localesRoot`、`repoRoot` 和默认目标语言目录。
+
+## CLI 命令
+
+```bash
+hagi18n info
+hagi18n audit
+hagi18n report
+hagi18n doctor
+hagi18n sync
+hagi18n prune
+```
+
+示例：
+
+```bash
+hagi18n audit --locales-root src/locales --base-locale en-US
+hagi18n audit --config hagi18n.yaml --json
+hagi18n report --config hagi18n.yaml
+hagi18n doctor --config hagi18n.yaml
+hagi18n sync --from en-US --to zh-CN
+hagi18n sync --from en-US --to zh-CN --write
+hagi18n prune --from en-US --to zh-CN --write
+```
+
+`sync` 和 `prune` 默认不会写盘，只有传入 `--write` 才会真正修改文件。
+
+## 参数说明
+
+| 参数 | 命令 | 说明 |
+| --- | --- | --- |
+| `--config <path>` | `info` 之外所有命令 | 加载配置文件 |
+| `--locales-root <path>` | audit, report, doctor, sync, prune | 语言包根目录 |
+| `--base-locale <locale>` | audit, report, doctor | 审计时使用的基准语言 |
+| `--from <locale>` | sync, prune | 变更时使用的基准语言 |
+| `--locale <locale>` | audit, report, doctor | 限定一个或多个目标语言 |
+| `--to <locale>` | sync, prune | 限定一个或多个目标语言 |
+| `--repo-root <path>` | doctor | 仓库扫描根目录 |
+| `--json` | audit, doctor, sync, prune | 输出 JSON |
+| `--dry-run` | sync, prune | 仅预览，不写盘 |
+| `--write` | sync, prune | 真正写入文件 |
+
+## JSON 输出与退出码
+
+- `audit`：无问题退出码为 `0`，有问题为 `1`
+- `report`：执行与 `audit` 相同的检查，但默认输出 JSON
+- `doctor`：审计或仓库扫描存在问题时返回 `1`
+- `sync` / `prune`：只有解析或处理错误时返回 `1`，正常的预览或写入结果都会输出摘要
+
+JSON 输出与 TypeScript API 返回的结构化 summary 保持一致。
+
+## TypeScript API
+
+```ts
+import {
+  auditLocaleTree,
+  doctorLocaleTree,
+  formatAuditSummary,
+  pruneLocaleTree,
+  resolveHagi18nConfig,
+  syncLocaleTree
+} from "@hagicode/hagi18n";
+
+const audit = await auditLocaleTree({
+  localesRoot: "src/locales",
+  baseLocale: "en-US"
+});
+
+console.log(formatAuditSummary(audit));
+```
+
+主要导出包括：
+
+- 配置辅助函数：`findHagi18nConfigPath`、`loadHagi18nConfig`、`resolveHagi18nConfig`
+- locale 辅助函数：`normalizeLocaleName`、`listLocaleDirectories`、`readYamlLocaleFile`
+- 核心流程：`auditLocaleTree`、`doctorLocaleTree`、`syncLocaleTree`、`pruneLocaleTree`
+- 文本格式化函数：`formatAuditSummary`、`formatDoctorSummary`、`formatMutationSummary`
+- 元数据函数：`getPackageMetadata`、`createRuntimeInfo`
+
+## 与 Web 参考实现的对应关系
+
+此包保留了 Web 项目的维护模型：
+
+- `repos/web/buildTools/lib/i18nLocaleToolkit.mjs` -> `src/locale-toolkit.ts`
+- `repos/web/buildTools/i18n-locale-cli.mjs` -> `src/cli.ts`
+
+也就是说，这次抽象保留了 Web 的参考行为，但不会要求 `repos/web` 立即修改运行时代码。
+
+## 开发
+
+在 `repos/hagi18n/` 目录执行：
+
+```bash
+npm install
+npm test
+npm run build
+```

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+export declare function createCli(): Command;
+export declare function runCli(argv?: string[]): Promise<void>;
+export declare function isCliEntrypoint(moduleUrl?: string, argvPath?: string): boolean;

package/dist/cli.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Command, CommanderError, Option } from "commander";
+import { auditLocaleTree, createRuntimeInfo, doctorLocaleTree, formatAuditSummary, formatDoctorSummary, formatMutationSummary, packageVersion, pruneLocaleTree, syncLocaleTree } from "./index.js";
+function collectValues(value, previous = []) {
+    previous.push(value);
+    return previous;
+}
+function toToolkitOptions(options) {
+    const targetLocales = [...(options.locale ?? []), ...(options.to ?? [])];
+    return {
+        configPath: options.config,
+        localesRoot: options.localesRoot,
+        repoRoot: options.repoRoot,
+        baseLocale: options.baseLocale ?? options.from,
+        targetLocales: targetLocales.length > 0 ? targetLocales : undefined
+    };
+}
+function resolveDryRun(options) {
+    if (options.dryRun) {
+        return true;
+    }
+    return !options.write;
+}
+function printSummary(summary, { json = false, formatter }) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(`${formatter(summary)}\n`);
+}
+function applySharedOptions(command, { includeRepoRoot = false } = {}) {
+    command
+        .addOption(new Option("--config <path>", "load defaults from a hagi18n.yaml file"))
+        .addOption(new Option("--locales-root <path>", "locale root directory"))
+        .addOption(new Option("--base-locale <locale>", "base locale to compare against"))
+        .addOption(new Option("--from <locale>", "source locale used as the structure baseline"))
+        .addOption(new Option("--locale <locale>", "limit the command to one or more locales").argParser(collectValues))
+        .addOption(new Option("--to <locale>", "target locale; can be repeated").argParser(collectValues))
+        .addOption(new Option("--json", "print machine-readable JSON output"));
+    if (includeRepoRoot) {
+        command.addOption(new Option("--repo-root <path>", "repository root for doctor scanning"));
+    }
+    return command;
+}
+function applyMutationOptions(command) {
+    return applySharedOptions(command)
+        .addOption(new Option("--dry-run", "preview changes without writing files"))
+        .addOption(new Option("--write", "apply file mutations"));
+}
+export function createCli() {
+    const program = new Command();
+    program
+        .name("hagi18n")
+        .description("Hagi18n YAML locale maintenance toolkit.")
+        .version(packageVersion, "-v, --version", "print the hagi18n version");
+    program.showHelpAfterError();
+    program.exitOverride();
+    program
+        .command("info")
+        .description("print package foundation metadata")
+        .action(() => {
+        const info = createRuntimeInfo();
+        process.stdout.write(`${JSON.stringify(info, null, 2)}\n`);
+    });
+    applySharedOptions(program
+        .command("audit")
+        .description("audit YAML locale files for drift against a base locale")
+        .action(async (options) => {
+        const summary = await auditLocaleTree(toToolkitOptions(options));
+        printSummary(summary, {
+            json: options.json,
+            formatter: formatAuditSummary
+        });
+        process.exitCode = summary.hasIssues ? 1 : 0;
+    }));
+    applySharedOptions(program
+        .command("report")
+        .description("run audit and print JSON output")
+        .action(async (options) => {
+        const summary = await auditLocaleTree(toToolkitOptions(options));
+        printSummary(summary, {
+            json: true,
+            formatter: formatAuditSummary
+        });
+        process.exitCode = summary.hasIssues ? 1 : 0;
+    }));
+    applySharedOptions(program
+        .command("doctor")
+        .description("audit locale drift and scan the repository for legacy locale references")
+        .action(async (options) => {
+        const summary = await doctorLocaleTree(toToolkitOptions(options));
+        printSummary(summary, {
+            json: options.json,
+            formatter: formatDoctorSummary
+        });
+        process.exitCode = summary.hasIssues ? 1 : 0;
+    }), { includeRepoRoot: true });
+    applyMutationOptions(program
+        .command("sync")
+        .description("add missing files and keys from the base locale")
+        .action(async (options) => {
+        const summary = await syncLocaleTree({
+            ...toToolkitOptions(options),
+            dryRun: resolveDryRun(options)
+        });
+        printSummary(summary, {
+            json: options.json,
+            formatter: formatMutationSummary
+        });
+        process.exitCode = summary.hasIssues ? 1 : 0;
+    }));
+    applyMutationOptions(program
+        .command("prune")
+        .description("remove files and keys absent from the base locale")
+        .action(async (options) => {
+        const summary = await pruneLocaleTree({
+            ...toToolkitOptions(options),
+            dryRun: resolveDryRun(options)
+        });
+        printSummary(summary, {
+            json: options.json,
+            formatter: formatMutationSummary
+        });
+        process.exitCode = summary.hasIssues ? 1 : 0;
+    }));
+    program.addHelpText("after", `
+
+Examples:
+  hagi18n audit --locales-root src/locales --base-locale en-US
+  hagi18n report --config hagi18n.yaml
+  hagi18n doctor --repo-root . --locales-root src/locales
+  hagi18n sync --from en-US --to zh-CN --dry-run
+  hagi18n prune --from en-US --to zh-CN --write
+`);
+    program.action(() => {
+        program.outputHelp();
+    });
+    return program;
+}
+export async function runCli(argv = process.argv) {
+    const program = createCli();
+    process.exitCode = 0;
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            process.exitCode = error.exitCode;
+            return;
+        }
+        throw error;
+    }
+}
+export function isCliEntrypoint(moduleUrl = import.meta.url, argvPath = process.argv[1]) {
+    if (!argvPath) {
+        return false;
+    }
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argvPath);
+    }
+    catch {
+        return false;
+    }
+}
+if (isCliEntrypoint()) {
+    runCli().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+export declare const DEFAULT_BASE_LOCALE = "en-US";
+export declare const DEFAULT_CONFIG_FILE_NAMES: readonly ["hagi18n.yaml", "hagi18n.yml"];
+export declare const DEFAULT_DOCTOR_EXCLUDED_DIRECTORIES: readonly [".git", "coverage", "dist", "indexGenerator", "node_modules", "public"];
+export declare const DEFAULT_DOCTOR_TEXT_FILE_EXTENSIONS: readonly [".cjs", ".js", ".jsx", ".md", ".mjs", ".ts", ".tsx"];
+export declare const DEFAULT_DOCTOR_EXCLUDED_PATH_PREFIXES: readonly ["src/generated/"];
+export interface DoctorScanRuleConfig {
+    id: string;
+    message: string;
+    pattern: string;
+    flags?: string;
+}
+export interface Hagi18nDoctorConfig {
+    excludedDirectories?: string[];
+    textFileExtensions?: string[];
+    excludedPathPrefixes?: string[];
+    allowlist?: Record<string, string[]>;
+    scanRules?: DoctorScanRuleConfig[];
+}
+export interface Hagi18nConfig {
+    localesRoot?: string;
+    repoRoot?: string;
+    baseLocale?: string;
+    targetLocales?: string[];
+    doctor?: Hagi18nDoctorConfig;
+}
+export interface ResolvedDoctorScanRule extends DoctorScanRuleConfig {
+    regex: RegExp;
+}
+export interface ResolvedHagi18nDoctorConfig {
+    excludedDirectories: string[];
+    textFileExtensions: string[];
+    excludedPathPrefixes: string[];
+    allowlist: Record<string, string[]>;
+    scanRules: ResolvedDoctorScanRule[];
+}
+export interface ResolvedHagi18nConfig {
+    cwd: string;
+    configPath: string | null;
+    localesRoot: string;
+    repoRoot: string;
+    baseLocale: string;
+    targetLocales: string[];
+    doctor: ResolvedHagi18nDoctorConfig;
+}
+export interface LoadHagi18nConfigOptions {
+    cwd?: string;
+    configPath?: string | null;
+}
+export interface LoadHagi18nConfigResult {
+    cwd: string;
+    configPath: string | null;
+    config: Hagi18nConfig | null;
+}
+export interface ResolveHagi18nConfigOptions extends LoadHagi18nConfigOptions, Hagi18nConfig {
+}
+export declare const DEFAULT_DOCTOR_SCAN_RULES: DoctorScanRuleConfig[];
+export declare const DEFAULT_DOCTOR_ALLOWLIST: Record<string, string[]>;
+export declare function findHagi18nConfigPath(options?: LoadHagi18nConfigOptions): Promise<string | null>;
+export declare function loadHagi18nConfig(options?: LoadHagi18nConfigOptions): Promise<LoadHagi18nConfigResult>;
+export declare function resolveHagi18nConfig(options?: ResolveHagi18nConfigOptions): Promise<ResolvedHagi18nConfig>;