@hagicode/hagi18n 0.1.0-dev.1.1.45d0d2f

package/dist/config.js

@@ -0,0 +1,341 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import yaml from "js-yaml";
+export const DEFAULT_BASE_LOCALE = "en-US";
+export const DEFAULT_CONFIG_FILE_NAMES = ["hagi18n.yaml", "hagi18n.yml"];
+export const DEFAULT_DOCTOR_EXCLUDED_DIRECTORIES = [
+    ".git",
+    "coverage",
+    "dist",
+    "indexGenerator",
+    "node_modules",
+    "public"
+];
+export const DEFAULT_DOCTOR_TEXT_FILE_EXTENSIONS = [
+    ".cjs",
+    ".js",
+    ".jsx",
+    ".md",
+    ".mjs",
+    ".ts",
+    ".tsx"
+];
+export const DEFAULT_DOCTOR_EXCLUDED_PATH_PREFIXES = ["src/generated/"];
+export const DEFAULT_DOCTOR_SCAN_RULES = [
+    {
+        id: "legacy-locale-path",
+        message: "Legacy locale paths should use en-US instead of en.",
+        pattern: "(?:src\\/locales\\/en\\/|\\.\\.\\/\\.\\.\\/locales\\/en\\/)"
+    },
+    {
+        id: "legacy-language-change-call",
+        message: "Use en-US when switching the canonical UI language in code or tests.",
+        pattern: "\\b(?:i18n\\.)?changeLanguage\\(\\s*['\"]en['\"]\\s*\\)"
+    },
+    {
+        id: "legacy-ui-language-literal",
+        message: "Use en-US as the canonical UI language literal.",
+        pattern: "\\b(currentLanguage|confirmedLanguage|detectedLanguage|resolvedLanguage|language|lng)\\s*[:=]\\s*['\"]en['\"]"
+    },
+    {
+        id: "legacy-ui-language-union",
+        message: "Use en-US in UI-language unions and casts.",
+        pattern: "(?:as\\s+)?['\"]en['\"]\\s*\\|\\s*['\"]zh-CN['\"]"
+    }
+];
+export const DEFAULT_DOCTOR_ALLOWLIST = {
+    "legacy-ui-language-literal": [
+        "src/services/__tests__/frontendConfigBootstrap.generalSettings.test.ts",
+        "src/services/__tests__/frontendConfigBootstrap.projectScope.test.ts",
+        "src/store/__tests__/aiLanguageSlice.test.ts",
+        "src/store/listeners/__tests__/frontendConfigSyncListener.projectScope.test.ts",
+        "src/store/slices/__tests__/generalSettingsSlice.test.ts"
+    ],
+    "legacy-language-change-call": [],
+    "legacy-locale-path": [],
+    "legacy-ui-language-union": []
+};
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function ensureString(value, fieldName, { allowEmpty = false } = {}) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new Error(`${fieldName} must be a string.`);
+    }
+    const trimmed = value.trim();
+    if (!allowEmpty && trimmed.length === 0) {
+        throw new Error(`${fieldName} must not be empty.`);
+    }
+    return trimmed;
+}
+function ensureStringArray(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${fieldName} must be an array of strings.`);
+    }
+    return value.map((entry, index) => {
+        const validated = ensureString(entry, `${fieldName}[${index}]`);
+        return validated ?? "";
+    });
+}
+function dedupeStrings(values) {
+    const output = [];
+    for (const value of values) {
+        const trimmed = value.trim();
+        if (!trimmed || output.includes(trimmed)) {
+            continue;
+        }
+        output.push(trimmed);
+    }
+    return output;
+}
+function normalizeAllowlist(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isPlainObject(value)) {
+        throw new Error(`${fieldName} must be a mapping of rule ids to file paths.`);
+    }
+    const output = {};
+    for (const [ruleId, paths] of Object.entries(value)) {
+        output[ruleId] = dedupeStrings(ensureStringArray(paths, `${fieldName}.${ruleId}`) ?? []);
+    }
+    return output;
+}
+function normalizeScanRules(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${fieldName} must be an array of rule definitions.`);
+    }
+    return value.map((entry, index) => {
+        if (!isPlainObject(entry)) {
+            throw new Error(`${fieldName}[${index}] must be a mapping.`);
+        }
+        return {
+            id: ensureString(entry.id, `${fieldName}[${index}].id`) ?? "",
+            message: ensureString(entry.message, `${fieldName}[${index}].message`) ?? "",
+            pattern: ensureString(entry.pattern, `${fieldName}[${index}].pattern`) ?? "",
+            flags: ensureString(entry.flags, `${fieldName}[${index}].flags`, {
+                allowEmpty: true
+            })
+        };
+    });
+}
+function parseDoctorConfig(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isPlainObject(value)) {
+        throw new Error("doctor must be a mapping.");
+    }
+    return {
+        excludedDirectories: ensureStringArray(value.excludedDirectories, "doctor.excludedDirectories"),
+        textFileExtensions: ensureStringArray(value.textFileExtensions, "doctor.textFileExtensions"),
+        excludedPathPrefixes: ensureStringArray(value.excludedPathPrefixes, "doctor.excludedPathPrefixes"),
+        allowlist: normalizeAllowlist(value.allowlist, "doctor.allowlist"),
+        scanRules: normalizeScanRules(value.scanRules, "doctor.scanRules")
+    };
+}
+function parseConfigDocument(document, configPath) {
+    if (document === undefined) {
+        return {};
+    }
+    if (!isPlainObject(document)) {
+        throw new Error(`Top-level YAML document in ${configPath} must be a mapping object.`);
+    }
+    return {
+        localesRoot: ensureString(document.localesRoot, "localesRoot"),
+        repoRoot: ensureString(document.repoRoot, "repoRoot"),
+        baseLocale: ensureString(document.baseLocale, "baseLocale"),
+        targetLocales: ensureStringArray(document.targetLocales, "targetLocales"),
+        doctor: parseDoctorConfig(document.doctor)
+    };
+}
+export async function findHagi18nConfigPath(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const explicitConfigPath = options.configPath?.trim();
+    if (explicitConfigPath) {
+        return path.resolve(cwd, explicitConfigPath);
+    }
+    for (const fileName of DEFAULT_CONFIG_FILE_NAMES) {
+        const candidate = path.join(cwd, fileName);
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export async function loadHagi18nConfig(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const configPath = await findHagi18nConfigPath({ ...options, cwd });
+    if (!configPath) {
+        return {
+            cwd,
+            configPath: null,
+            config: null
+        };
+    }
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read ${configPath}: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse ${configPath}: ${message}`);
+    }
+    return {
+        cwd,
+        configPath,
+        config: parseConfigDocument(parsed, configPath)
+    };
+}
+function compileScanRules(rules) {
+    return rules.map((rule) => ({
+        ...rule,
+        regex: new RegExp(rule.pattern, rule.flags ?? "u")
+    }));
+}
+function resolveStringPath(value, baseDirectory) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return path.isAbsolute(value) ? value : path.resolve(baseDirectory, value);
+}
+function resolveConfigLayer(config, { cwd, configPath }) {
+    if (!config) {
+        return {};
+    }
+    const baseDirectory = configPath ? path.dirname(configPath) : cwd;
+    return {
+        localesRoot: resolveStringPath(config.localesRoot, baseDirectory),
+        repoRoot: resolveStringPath(config.repoRoot, baseDirectory),
+        baseLocale: config.baseLocale?.trim(),
+        targetLocales: config.targetLocales
+            ? dedupeStrings(config.targetLocales)
+            : undefined,
+        doctor: {
+            excludedDirectories: config.doctor?.excludedDirectories
+                ? dedupeStrings(config.doctor.excludedDirectories)
+                : undefined,
+            textFileExtensions: config.doctor?.textFileExtensions
+                ? dedupeStrings(config.doctor.textFileExtensions)
+                : undefined,
+            excludedPathPrefixes: config.doctor?.excludedPathPrefixes
+                ? dedupeStrings(config.doctor.excludedPathPrefixes)
+                : undefined,
+            allowlist: config.doctor?.allowlist
+                ? Object.fromEntries(Object.entries(config.doctor.allowlist).map(([ruleId, filePaths]) => [
+                    ruleId,
+                    dedupeStrings(filePaths)
+                ]))
+                : undefined,
+            scanRules: config.doctor?.scanRules
+                ? compileScanRules(config.doctor.scanRules)
+                : undefined
+        }
+    };
+}
+function mergeAllowlists(baseAllowlist, overrideAllowlist) {
+    if (!overrideAllowlist) {
+        return { ...baseAllowlist };
+    }
+    const merged = { ...baseAllowlist };
+    for (const [ruleId, filePaths] of Object.entries(overrideAllowlist)) {
+        merged[ruleId] = dedupeStrings(filePaths);
+    }
+    return merged;
+}
+function mergeResolvedDoctorConfig(baseConfig, overrideConfig) {
+    if (!overrideConfig) {
+        return {
+            excludedDirectories: [...baseConfig.excludedDirectories],
+            textFileExtensions: [...baseConfig.textFileExtensions],
+            excludedPathPrefixes: [...baseConfig.excludedPathPrefixes],
+            allowlist: mergeAllowlists(baseConfig.allowlist),
+            scanRules: [...baseConfig.scanRules]
+        };
+    }
+    return {
+        excludedDirectories: overrideConfig.excludedDirectories
+            ? [...overrideConfig.excludedDirectories]
+            : [...baseConfig.excludedDirectories],
+        textFileExtensions: overrideConfig.textFileExtensions
+            ? [...overrideConfig.textFileExtensions]
+            : [...baseConfig.textFileExtensions],
+        excludedPathPrefixes: overrideConfig.excludedPathPrefixes
+            ? [...overrideConfig.excludedPathPrefixes]
+            : [...baseConfig.excludedPathPrefixes],
+        allowlist: mergeAllowlists(baseConfig.allowlist, overrideConfig.allowlist),
+        scanRules: overrideConfig.scanRules
+            ? [...overrideConfig.scanRules]
+            : [...baseConfig.scanRules]
+    };
+}
+function createDefaultResolvedConfig(cwd) {
+    return {
+        cwd,
+        configPath: null,
+        localesRoot: path.resolve(cwd, "src/locales"),
+        repoRoot: cwd,
+        baseLocale: DEFAULT_BASE_LOCALE,
+        targetLocales: [],
+        doctor: {
+            excludedDirectories: [...DEFAULT_DOCTOR_EXCLUDED_DIRECTORIES],
+            textFileExtensions: [...DEFAULT_DOCTOR_TEXT_FILE_EXTENSIONS],
+            excludedPathPrefixes: [...DEFAULT_DOCTOR_EXCLUDED_PATH_PREFIXES],
+            allowlist: { ...DEFAULT_DOCTOR_ALLOWLIST },
+            scanRules: compileScanRules(DEFAULT_DOCTOR_SCAN_RULES)
+        }
+    };
+}
+export async function resolveHagi18nConfig(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const loaded = await loadHagi18nConfig({
+        cwd,
+        configPath: options.configPath
+    });
+    const defaults = createDefaultResolvedConfig(cwd);
+    const fileLayer = resolveConfigLayer(loaded.config, loaded);
+    const overrideLayer = resolveConfigLayer({
+        localesRoot: options.localesRoot,
+        repoRoot: options.repoRoot,
+        baseLocale: options.baseLocale,
+        targetLocales: options.targetLocales,
+        doctor: options.doctor
+    }, {
+        cwd,
+        configPath: null
+    });
+    const mergedDoctor = mergeResolvedDoctorConfig(mergeResolvedDoctorConfig(defaults.doctor, fileLayer.doctor), overrideLayer.doctor);
+    return {
+        cwd,
+        configPath: loaded.configPath,
+        localesRoot: overrideLayer.localesRoot ?? fileLayer.localesRoot ?? defaults.localesRoot,
+        repoRoot: overrideLayer.repoRoot ?? fileLayer.repoRoot ?? defaults.repoRoot,
+        baseLocale: overrideLayer.baseLocale ?? fileLayer.baseLocale ?? defaults.baseLocale,
+        targetLocales: overrideLayer.targetLocales ??
+            fileLayer.targetLocales ??
+            defaults.targetLocales,
+        doctor: mergedDoctor
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { DEFAULT_BASE_LOCALE, DEFAULT_CONFIG_FILE_NAMES, DEFAULT_DOCTOR_ALLOWLIST, DEFAULT_DOCTOR_EXCLUDED_DIRECTORIES, DEFAULT_DOCTOR_EXCLUDED_PATH_PREFIXES, DEFAULT_DOCTOR_SCAN_RULES, DEFAULT_DOCTOR_TEXT_FILE_EXTENSIONS, findHagi18nConfigPath, loadHagi18nConfig, resolveHagi18nConfig, type DoctorScanRuleConfig, type Hagi18nConfig, type Hagi18nDoctorConfig, type LoadHagi18nConfigOptions, type LoadHagi18nConfigResult, type ResolvedDoctorScanRule, type ResolvedHagi18nConfig, type ResolvedHagi18nDoctorConfig, type ResolveHagi18nConfigOptions } from "./config.js";
+export { auditHasIssues, auditLocaleTree, collectPlaceholderDifferences, collectPlaceholders, collectScalarPaths, createAuditResult, difference, doctorLocaleTree, formatAuditSummary, formatDoctorSummary, formatMutationSummary, listLocaleDirectories, normalizeLocaleName, pruneLocaleTree, readYamlLocaleFile, syncLocaleTree, walkYamlFiles, type AuditLocaleResult, type AuditLocaleTreeSummary, type DoctorLocaleTreeSummary, type DoctorRuleIssue, type LocaleMutationParseError, type LocaleParseError, type LocalePathIssue, type LocalePlaceholderMismatch, type LocaleToolkitOptions, type MutationChangedFile, type MutationLocaleToolkitOptions, type MutationRemovedFile, type MutationSummary, type MutationTotals, type YamlLocaleDocument } from "./locale-toolkit.js";
+export { getPackageMetadata, packageName, packageVersion, type PackageMetadata } from "./version.js";
+export interface Hagi18nRuntimeInfo {
+    packageName: string;
+    version: string;
+    status: "foundation";
+}
+export declare function createRuntimeInfo(): Hagi18nRuntimeInfo;

package/dist/index.js

@@ -0,0 +1,12 @@
+import { packageName, packageVersion } from "./version.js";
+export { DEFAULT_BASE_LOCALE, DEFAULT_CONFIG_FILE_NAMES, DEFAULT_DOCTOR_ALLOWLIST, DEFAULT_DOCTOR_EXCLUDED_DIRECTORIES, DEFAULT_DOCTOR_EXCLUDED_PATH_PREFIXES, DEFAULT_DOCTOR_SCAN_RULES, DEFAULT_DOCTOR_TEXT_FILE_EXTENSIONS, findHagi18nConfigPath, loadHagi18nConfig, resolveHagi18nConfig } from "./config.js";
+export { auditHasIssues, auditLocaleTree, collectPlaceholderDifferences, collectPlaceholders, collectScalarPaths, createAuditResult, difference, doctorLocaleTree, formatAuditSummary, formatDoctorSummary, formatMutationSummary, listLocaleDirectories, normalizeLocaleName, pruneLocaleTree, readYamlLocaleFile, syncLocaleTree, walkYamlFiles } from "./locale-toolkit.js";
+export { getPackageMetadata, packageName, packageVersion } from "./version.js";
+export function createRuntimeInfo() {
+    return {
+        packageName,
+        version: packageVersion,
+        status: "foundation"
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,mCAAmC,EACnC,qCAAqC,EACrC,yBAAyB,EACzB,mCAAmC,EACnC,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EAUrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,eAAe,EACf,6BAA6B,EAC7B,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,aAAa,EAgBd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EAEf,MAAM,cAAc,CAAC;AAQtB,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,WAAW;QACX,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,YAAY;KACrB,CAAC;AACJ,CAAC"}

package/dist/locale-toolkit.d.ts

@@ -0,0 +1,113 @@
+import { type ResolveHagi18nConfigOptions } from "./config.js";
+export interface YamlLocaleDocument {
+    absolutePath: string;
+    raw: string;
+    data: Record<string, unknown>;
+}
+export interface LocaleParseError {
+    file: string;
+    message: string;
+}
+export interface LocaleMutationParseError extends LocaleParseError {
+    locale: string;
+}
+export interface LocalePathIssue {
+    file: string;
+    path: string;
+}
+export interface LocalePlaceholderMismatch extends LocalePathIssue {
+    expected: string[];
+    actual: string[];
+}
+export interface AuditLocaleResult {
+    locale: string;
+    missingFiles: string[];
+    extraFiles: string[];
+    filesWithProtectedTokens: string[];
+    parseErrors: LocaleParseError[];
+    missingKeys: LocalePathIssue[];
+    extraKeys: LocalePathIssue[];
+    placeholderMismatches: LocalePlaceholderMismatch[];
+}
+export interface AuditLocaleTreeSummary {
+    localesRoot: string;
+    baseLocale: string;
+    locales: string[];
+    allLocales: string[];
+    baseFileCount: number;
+    results: AuditLocaleResult[];
+    hasIssues: boolean;
+}
+export interface MutationChangedFile {
+    locale: string;
+    file: string;
+    action: "create" | "update";
+    addedPaths?: string[];
+    removedPaths?: string[];
+}
+export interface MutationRemovedFile {
+    locale: string;
+    file: string;
+    action: "remove-file";
+}
+export interface MutationTotals {
+    createdFiles: number;
+    updatedFiles: number;
+    removedFiles: number;
+    addedPaths: number;
+    removedPaths: number;
+}
+export interface MutationSummary {
+    command: "sync" | "prune";
+    localesRoot: string;
+    baseLocale: string;
+    targetLocales: string[];
+    dryRun: boolean;
+    changedFiles: MutationChangedFile[];
+    removedFiles: MutationRemovedFile[];
+    parseErrors: LocaleMutationParseError[];
+    totals: MutationTotals;
+    hasIssues: boolean;
+}
+export interface DoctorRuleIssue {
+    ruleId: string;
+    file: string;
+    line: number;
+    message: string;
+    snippet: string;
+}
+export interface DoctorLocaleTreeSummary {
+    repoRoot: string;
+    localesRoot: string;
+    baseLocale: string;
+    locales: string[];
+    audit: AuditLocaleTreeSummary;
+    legacyReferenceIssues: DoctorRuleIssue[];
+    totals: {
+        legacyReferenceIssues: number;
+        affectedFiles: number;
+    };
+    hasIssues: boolean;
+}
+export interface LocaleToolkitOptions extends ResolveHagi18nConfigOptions {
+}
+export interface MutationLocaleToolkitOptions extends LocaleToolkitOptions {
+    dryRun?: boolean;
+}
+export declare function normalizeLocaleName(value: unknown): string | null;
+export declare function listLocaleDirectories(localesRoot: string): Promise<string[]>;
+export declare function walkYamlFiles(directory: string, prefix?: string): Promise<string[]>;
+export declare function readYamlLocaleFile(localesRoot: string, locale: string, relativeFilePath: string): Promise<YamlLocaleDocument>;
+export declare function collectScalarPaths(value: unknown, prefix?: string[], output?: string[]): string[];
+export declare function collectPlaceholders(value: unknown, prefix?: string[], output?: Map<string, string[]>): Map<string, string[]>;
+export declare function difference(source: string[], other: string[]): string[];
+export declare function collectPlaceholderDifferences(basePlaceholders: Map<string, string[]>, currentPlaceholders: Map<string, string[]>): Array<Omit<LocalePlaceholderMismatch, "file">>;
+export declare function createAuditResult(locale: string): AuditLocaleResult;
+export declare function auditHasIssues(result: AuditLocaleResult): boolean;
+export declare function auditLocaleTree(options?: LocaleToolkitOptions): Promise<AuditLocaleTreeSummary>;
+export declare function syncLocaleTree(options?: MutationLocaleToolkitOptions): Promise<MutationSummary>;
+export declare function pruneLocaleTree(options?: MutationLocaleToolkitOptions): Promise<MutationSummary>;
+export declare function doctorLocaleTree(options?: LocaleToolkitOptions): Promise<DoctorLocaleTreeSummary>;
+export declare function formatAuditSummary(summary: AuditLocaleTreeSummary): string;
+export declare function formatMutationSummary(summary: MutationSummary): string;
+export declare function formatDoctorSummary(summary: DoctorLocaleTreeSummary): string;