@worldware/msg-cli 0.0.2

package/dist/commands/init.js

@@ -0,0 +1,131 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const readline_1 = require("readline");
+const path_1 = require("path");
+const init_helpers_js_1 = require("../lib/init-helpers.js");
+/**
+ * Scaffolds a msg project: directories, package.json entries, and dependencies.
+ */
+class Init extends core_1.Command {
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { flags } = yield this.parse(Init);
+            const cwd = process.cwd();
+            const pkgPath = (0, init_helpers_js_1.findPackageJsonPath)(cwd);
+            if (!pkgPath) {
+                this.error("package.json not found. Run this command from the project root.", {
+                    exit: 1,
+                });
+            }
+            let i18nDir = (_a = flags.i18nDir) !== null && _a !== void 0 ? _a : init_helpers_js_1.DEFAULT_I18N_DIR;
+            let l10nDir = (_b = flags.l10nDir) !== null && _b !== void 0 ? _b : init_helpers_js_1.DEFAULT_L10N_DIR;
+            if (flags.interactive) {
+                const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+                const ask = (question, defaultVal) => new Promise((resolve) => {
+                    rl.question(`${question} [${defaultVal}]: `, (answer) => {
+                        resolve(((answer === null || answer === void 0 ? void 0 : answer.trim()) || defaultVal).trim() || defaultVal);
+                    });
+                });
+                if (!flags.i18nDir) {
+                    i18nDir = yield ask("i18n directory path (relative to project root):", init_helpers_js_1.DEFAULT_I18N_DIR);
+                }
+                if (!flags.l10nDir) {
+                    l10nDir = yield ask("l10n directory path (relative to project root):", init_helpers_js_1.DEFAULT_L10N_DIR);
+                }
+                rl.close();
+            }
+            const rootDir = (0, path_1.join)(cwd);
+            const validation = (0, init_helpers_js_1.validatePaths)(rootDir, i18nDir, l10nDir);
+            if (!validation.valid) {
+                this.error((_c = validation.error) !== null && _c !== void 0 ? _c : "Invalid paths", { exit: 1 });
+            }
+            let pkg;
+            try {
+                pkg = (0, init_helpers_js_1.readPackageJson)(pkgPath);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : "Invalid or unreadable package.json";
+                this.error(msg, { exit: 1 });
+            }
+            const alreadyInit = (0, init_helpers_js_1.isAlreadyInitialized)(pkg, rootDir, i18nDir, l10nDir);
+            if (alreadyInit && !flags.force) {
+                this.warn("Project appears already initialized for msg. Use -f or --force to re-run.");
+                return;
+            }
+            this.log("Creating i18n and l10n directories...");
+            try {
+                (0, init_helpers_js_1.ensureDirectoriesWithGitkeep)(rootDir, i18nDir, l10nDir, flags.force);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : "Failed to create directories";
+                this.error(msg, { exit: 1 });
+            }
+            this.log("Updating package.json...");
+            pkg = (0, init_helpers_js_1.addDirectoriesToPackageJson)(pkg, i18nDir, l10nDir);
+            pkg = (0, init_helpers_js_1.addImportAliasesToPackageJson)(pkg, i18nDir, l10nDir);
+            pkg = (0, init_helpers_js_1.addScriptsToPackageJson)(pkg);
+            try {
+                (0, init_helpers_js_1.writePackageJson)(pkgPath, pkg);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : "Failed to write package.json";
+                this.error(msg, { exit: 1 });
+            }
+            const tsconfigPath = (0, path_1.join)(rootDir, "tsconfig.json");
+            if ((0, fs_1.existsSync)(tsconfigPath)) {
+                this.log("Updating tsconfig.json for path aliases...");
+                try {
+                    (0, init_helpers_js_1.addTsconfigPaths)(tsconfigPath, i18nDir, l10nDir);
+                }
+                catch (err) {
+                    this.warn(err instanceof Error ? err.message : "Could not update tsconfig.json; you may add paths manually.");
+                }
+            }
+            this.log("Installing @worldware/msg...");
+            const installResult = (0, child_process_1.spawnSync)("npm", ["install", "@worldware/msg@latest", "--save"], { cwd: rootDir, shell: true, stdio: "inherit" });
+            if (installResult.status !== 0) {
+                this.error("Failed to install @worldware/msg. Check your network and npm registry.", {
+                    exit: 1,
+                });
+            }
+            this.log("Init complete.");
+        });
+    }
+}
+Init.description = "Scaffold a msg project (i18n/l10n directories, package.json, and dependencies)";
+Init.examples = [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> <%= command.id %> --i18nDir lib/i18n --l10nDir data/l10n",
+    "<%= config.bin %> <%= command.id %> -f",
+];
+Init.flags = {
+    help: core_1.Flags.help({ char: "h" }),
+    interactive: core_1.Flags.boolean({
+        char: "i",
+        description: "Prompt for i18n and l10n directory paths",
+    }),
+    force: core_1.Flags.boolean({
+        char: "f",
+        description: "Force clean install; overwrite existing msg setup",
+    }),
+    i18nDir: core_1.Flags.string({
+        description: "Relative path for the i18n directory",
+    }),
+    l10nDir: core_1.Flags.string({
+        description: "Relative path for the l10n directory",
+    }),
+};
+exports.default = Init;

package/dist/lib/create-project-helpers.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateRelativePath = calculateRelativePath;
+exports.importMsgProjectFile = importMsgProjectFile;
+exports.writeMsgProjectFile = writeMsgProjectFile;
+exports.loadPackageJsonForCreateProject = loadPackageJsonForCreateProject;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const init_helpers_js_1 = require("./init-helpers.js");
+/**
+ * Calculates the relative path from the i18n projects directory to the l10n translations directory.
+ * @param projectsDir - Absolute path to i18n/projects (e.g. root/i18n/projects)
+ * @param translationsDir - Absolute path to l10n/translations (e.g. root/l10n/translations)
+ * @returns Relative path string from projects to translations, suitable for import()
+ */
+function calculateRelativePath(projectsDir, translationsDir) {
+    const rel = (0, path_1.relative)(projectsDir, translationsDir);
+    return rel.startsWith(".") ? rel : `./${rel}`;
+}
+/**
+ * Imports an existing MsgProject module from the projects directory.
+ * @param projectsDir - Absolute path to i18n/projects
+ * @param projectName - Name of the project (file name without extension)
+ * @returns The default export (MsgProject instance or data) or undefined if not found
+ */
+function importMsgProjectFile(projectsDir, projectName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const basePath = (0, path_1.join)(projectsDir, projectName);
+        const exts = [".ts", ".js"];
+        for (const ext of exts) {
+            const p = `${basePath}${ext}`;
+            if ((0, fs_1.existsSync)(p)) {
+                try {
+                    const url = (0, url_1.pathToFileURL)(p).href;
+                    const mod = yield Promise.resolve(`${url}`).then(s => __importStar(require(s)));
+                    return ((_a = mod === null || mod === void 0 ? void 0 : mod.default) !== null && _a !== void 0 ? _a : mod);
+                }
+                catch (_b) {
+                    return undefined;
+                }
+            }
+        }
+        return undefined;
+    });
+}
+/**
+ * Writes an MsgProject file to the projects directory.
+ * @param filePath - Absolute path of the file to write (including extension)
+ * @param content - Full file content string
+ */
+function writeMsgProjectFile(filePath, content) {
+    const dir = (0, path_1.dirname)(filePath);
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(filePath, content, "utf-8");
+}
+/**
+ * Loads package.json from the given directory (walking up to find it).
+ * Requires directories.i18n and directories.l10n.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @returns Parsed package.json with directories.i18n and directories.l10n
+ * @throws Error if package.json not found or missing directories.i18n / directories.l10n
+ */
+function loadPackageJsonForCreateProject(cwd) {
+    const ctx = (0, init_helpers_js_1.loadPackageJsonForMsg)(cwd, { requireL10n: true });
+    return ctx.pkg;
+}

package/dist/lib/create-resource-helpers.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPackageJsonForCreateResource = readPackageJsonForCreateResource;
+exports.importMsgProjectForResource = importMsgProjectForResource;
+exports.generateMsgResourceContent = generateMsgResourceContent;
+exports.writeMsgResourceFile = writeMsgResourceFile;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const init_helpers_js_1 = require("./init-helpers.js");
+/**
+ * Reads package.json and returns i18n directory and module type info.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @returns Object with i18nDir, isEsm, useTypeScript
+ * @throws Error if package.json not found or missing directories.i18n
+ */
+function readPackageJsonForCreateResource(cwd) {
+    const ctx = (0, init_helpers_js_1.loadPackageJsonForMsg)(cwd);
+    return {
+        i18nDir: ctx.i18nDir,
+        isEsm: ctx.isEsm,
+        useTypeScript: ctx.useTypeScript,
+    };
+}
+/**
+ * Derives dir (ltr/rtl) from a locale string based on language subtag.
+ * @param sourceLocale - Full locale (e.g. "en", "ar-SA", "he-IL")
+ * @returns "rtl" for ar/he, "ltr" otherwise
+ */
+function dirFromSourceLocale(sourceLocale) {
+    var _a, _b;
+    const lang = (_b = (_a = sourceLocale.split("-")[0]) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : "";
+    return lang === "ar" || lang === "he" ? "rtl" : "ltr";
+}
+/**
+ * Imports the MsgProject module and returns sourceLocale and dir (ltr/rtl).
+ * @param projectsDir - Absolute path to i18n/projects
+ * @param projectName - Name of the project file (without extension)
+ * @returns Object with sourceLocale and dir, or undefined if project not found
+ */
+function importMsgProjectForResource(projectsDir, projectName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const basePath = (0, path_1.join)(projectsDir, projectName);
+        const exts = [".ts", ".js"];
+        for (const ext of exts) {
+            const p = `${basePath}${ext}`;
+            if ((0, fs_1.existsSync)(p)) {
+                try {
+                    const url = (0, url_1.pathToFileURL)(p).href;
+                    const mod = yield Promise.resolve(`${url}`).then(s => __importStar(require(s)));
+                    const data = ((_a = mod === null || mod === void 0 ? void 0 : mod.default) !== null && _a !== void 0 ? _a : mod);
+                    const sourceLocale = (_b = data === null || data === void 0 ? void 0 : data.locales) === null || _b === void 0 ? void 0 : _b.sourceLocale;
+                    if (!sourceLocale || typeof sourceLocale !== "string") {
+                        return undefined;
+                    }
+                    return {
+                        sourceLocale,
+                        dir: dirFromSourceLocale(sourceLocale),
+                    };
+                }
+                catch (_c) {
+                    return undefined;
+                }
+            }
+        }
+        return undefined;
+    });
+}
+/**
+ * Generates the MsgResource file content as a string.
+ * @param params - Title, projectName, sourceLocale, dir, and isEsm
+ * @returns The generated file content
+ */
+function generateMsgResourceContent(params) {
+    const { title, projectName, sourceLocale, dir, isEsm } = params;
+    const projectImport = `../projects/${projectName}`;
+    const messagesBlock = `  messages: [
+    {
+      key: 'example.message',
+      value: 'Example message.',
+      notes: [
+        { type: 'description', content: 'This is an example message. You can delete it.' }
+      ]
+    }
+  ]`;
+    const titleStr = `'${title.replace(/'/g, "\\'")}'`;
+    const langStr = `'${sourceLocale.replace(/'/g, "\\'")}'`;
+    const dirStr = `'${dir}'`;
+    if (isEsm) {
+        return `import { MsgResource } from '@worldware/msg';
+import project from '${projectImport}';
+
+export default MsgResource.create({
+  title: ${titleStr},
+  attributes: {
+    lang: ${langStr},
+    dir: ${dirStr}
+  },
+  notes: [
+    { type: 'DESCRIPTION', content: 'This is a generated file. Replace this description with your own.' }
+  ],
+${messagesBlock}
+}, project);
+`;
+    }
+    return `const { MsgResource } = require('@worldware/msg');
+const project = require('${projectImport}');
+
+module.exports = MsgResource.create({
+  title: ${titleStr},
+  attributes: {
+    lang: ${langStr},
+    dir: ${dirStr}
+  },
+  notes: [
+    { type: 'DESCRIPTION', content: 'This is a generated file. Replace this description with your own.' }
+  ],
+${messagesBlock}
+}, project);
+`;
+}
+/**
+ * Writes the MsgResource content to file.
+ * @param filePath - Absolute path of the file to write (including extension)
+ * @param content - Full file content string
+ */
+function writeMsgResourceFile(filePath, content) {
+    const dir = (0, path_1.dirname)(filePath);
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(filePath, content, "utf-8");
+}

package/dist/lib/init-helpers.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_L10N_DIR = exports.DEFAULT_I18N_DIR = void 0;
+exports.findPackageJsonPath = findPackageJsonPath;
+exports.readPackageJson = readPackageJson;
+exports.loadPackageJsonForMsg = loadPackageJsonForMsg;
+exports.writePackageJson = writePackageJson;
+exports.validatePaths = validatePaths;
+exports.ensureDirectoriesWithGitkeep = ensureDirectoriesWithGitkeep;
+exports.isAlreadyInitialized = isAlreadyInitialized;
+exports.addDirectoriesToPackageJson = addDirectoriesToPackageJson;
+exports.addImportAliasesToPackageJson = addImportAliasesToPackageJson;
+exports.addScriptsToPackageJson = addScriptsToPackageJson;
+exports.addTsconfigPaths = addTsconfigPaths;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/** Default relative path for the i18n directory. */
+exports.DEFAULT_I18N_DIR = "src/i18n";
+/** Default relative path for the l10n directory. */
+exports.DEFAULT_L10N_DIR = "res/l10n";
+/**
+ * Finds package.json by walking up from the given directory.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @returns Absolute path to package.json, or null if not found
+ */
+function findPackageJsonPath(cwd) {
+    let dir = cwd;
+    for (;;) {
+        const p = (0, path_1.join)(dir, "package.json");
+        if ((0, fs_1.existsSync)(p))
+            return p;
+        const parent = (0, path_1.dirname)(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Reads and parses package.json.
+ * @param pkgPath - Absolute path to package.json
+ * @returns Parsed package.json object
+ * @throws Error if file is unreadable or invalid JSON
+ */
+function readPackageJson(pkgPath) {
+    const raw = (0, fs_1.readFileSync)(pkgPath, "utf-8");
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("package.json must be a JSON object");
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error("Invalid package.json: " + err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * Loads package.json for msg commands (create project, create resource, etc.).
+ * Finds package.json from cwd, validates directories, and derives module info.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @param options - requireL10n: if true, directories.l10n must exist (default: false)
+ * @returns Package context with pkgPath, rootDir, pkg, i18nDir, l10nDir?, isEsm, useTypeScript
+ * @throws Error if package.json not found or required directories missing
+ */
+function loadPackageJsonForMsg(cwd, options) {
+    const pkgPath = findPackageJsonPath(cwd);
+    if (!pkgPath) {
+        throw new Error("package.json not found. Run this command from the project root.");
+    }
+    let pkg;
+    try {
+        pkg = readPackageJson(pkgPath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "package.json could not be parsed.";
+        throw new Error(msg);
+    }
+    const dirs = pkg.directories;
+    if (!dirs || typeof dirs !== "object" || !dirs.i18n) {
+        throw new Error("package.json must contain directories.i18n. Run 'msg init' first.");
+    }
+    if ((options === null || options === void 0 ? void 0 : options.requireL10n) && !dirs.l10n) {
+        throw new Error("package.json must contain directories.i18n and directories.l10n. Run 'msg init' first.");
+    }
+    const rootDir = (0, path_1.dirname)(pkgPath);
+    const useTypeScript = (0, fs_1.existsSync)((0, path_1.join)(rootDir, "tsconfig.json"));
+    const isEsm = pkg.type === "module";
+    return {
+        pkgPath,
+        rootDir,
+        pkg,
+        i18nDir: dirs.i18n,
+        l10nDir: dirs.l10n,
+        isEsm,
+        useTypeScript,
+    };
+}
+/**
+ * Writes package.json to disk with trailing newline.
+ * @param pkgPath - Absolute path to package.json
+ * @param pkg - Object to serialize
+ */
+function writePackageJson(pkgPath, pkg) {
+    const json = JSON.stringify(pkg, null, 2) + "\n";
+    (0, fs_1.writeFileSync)(pkgPath, json, "utf-8");
+}
+/**
+ * Validates i18n and l10n paths (relative, non-empty, no absolute segments).
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @returns Object with valid: boolean and optional error message
+ */
+function validatePaths(rootDir, i18nDir, l10nDir) {
+    const trimmedI18n = i18nDir.trim();
+    const trimmedL10n = l10nDir.trim();
+    if (!trimmedI18n)
+        return { valid: false, error: "i18n directory path cannot be empty" };
+    if (!trimmedL10n)
+        return { valid: false, error: "l10n directory path cannot be empty" };
+    if (trimmedI18n.startsWith("/") || /^[A-Za-z]:/.test(trimmedI18n)) {
+        return { valid: false, error: "i18n path must be relative" };
+    }
+    if (trimmedL10n.startsWith("/") || /^[A-Za-z]:/.test(trimmedL10n)) {
+        return { valid: false, error: "l10n path must be relative" };
+    }
+    return { valid: true };
+}
+const GITKEEP = ".gitkeep";
+/**
+ * Ensures i18n and l10n directory trees exist and adds .gitkeep to leaf dirs.
+ * Leaf dirs: i18n/projects, i18n/resources, l10n/translations, l10n/xliff.
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @param force - If true, overwrite/recreate even when dirs exist or are non-empty
+ */
+function ensureDirectoriesWithGitkeep(rootDir, i18nDir, l10nDir, force) {
+    const leaves = [
+        (0, path_1.join)(rootDir, i18nDir, "projects"),
+        (0, path_1.join)(rootDir, i18nDir, "resources"),
+        (0, path_1.join)(rootDir, l10nDir, "translations"),
+        (0, path_1.join)(rootDir, l10nDir, "xliff"),
+    ];
+    for (const leaf of leaves) {
+        const parent = (0, path_1.dirname)(leaf);
+        if (!(0, fs_1.existsSync)(parent)) {
+            (0, fs_1.mkdirSync)(parent, { recursive: true });
+        }
+        if (!(0, fs_1.existsSync)(leaf)) {
+            (0, fs_1.mkdirSync)(leaf, { recursive: true });
+        }
+        const gitkeepPath = (0, path_1.join)(leaf, GITKEEP);
+        if (force || !(0, fs_1.existsSync)(gitkeepPath)) {
+            (0, fs_1.writeFileSync)(gitkeepPath, "", "utf-8");
+        }
+    }
+}
+/**
+ * Returns true if package.json already has msg directories and they exist on disk.
+ */
+function isAlreadyInitialized(pkg, rootDir, i18nDir, l10nDir) {
+    const dirs = pkg.directories;
+    if (!dirs || typeof dirs !== "object")
+        return false;
+    if (dirs.i18n !== i18nDir || dirs.l10n !== l10nDir)
+        return false;
+    const i18nFull = (0, path_1.join)(rootDir, i18nDir);
+    const l10nFull = (0, path_1.join)(rootDir, l10nDir);
+    return (0, fs_1.existsSync)(i18nFull) && (0, fs_1.existsSync)(l10nFull);
+}
+/**
+ * Adds or overwrites directories.i18n, directories.l10n, directories.root in package.json.
+ */
+function addDirectoriesToPackageJson(pkg, i18nDir, l10nDir) {
+    const directories = Object.assign(Object.assign({}, pkg.directories), { i18n: i18nDir, l10n: l10nDir, root: "." });
+    return Object.assign(Object.assign({}, pkg), { directories });
+}
+/**
+ * Adds import aliases #i18n/*, #l10n/*, #root/* to package.json imports.
+ */
+function addImportAliasesToPackageJson(pkg, i18nDir, l10nDir) {
+    const imports = Object.assign(Object.assign({}, pkg.imports), { "#i18n/*": `${i18nDir}/*`, "#l10n/*": `${l10nDir}/*`, "#root/*": "./*" });
+    return Object.assign(Object.assign({}, pkg), { imports });
+}
+/**
+ * Adds i18n-export and l10n-import scripts to package.json.
+ */
+function addScriptsToPackageJson(pkg) {
+    const scripts = Object.assign(Object.assign({}, pkg.scripts), { "i18n-export": "msg export:resources", "l10n-import": "msg import:translations" });
+    return Object.assign(Object.assign({}, pkg), { scripts });
+}
+/**
+ * Reads tsconfig.json, adds baseUrl and paths for #i18n/*, #l10n/*, #root/*, and writes it back.
+ * Merges into existing compilerOptions.paths and compilerOptions.baseUrl if present.
+ * @param tsconfigPath - Absolute path to tsconfig.json
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ */
+function addTsconfigPaths(tsconfigPath, i18nDir, l10nDir) {
+    var _a;
+    const raw = (0, fs_1.readFileSync)(tsconfigPath, "utf-8");
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch (_b) {
+        throw new Error("Invalid tsconfig.json");
+    }
+    if (!config.compilerOptions)
+        config.compilerOptions = {};
+    const co = config.compilerOptions;
+    co.baseUrl = (_a = co.baseUrl) !== null && _a !== void 0 ? _a : ".";
+    co.paths = Object.assign(Object.assign({}, co.paths), { "#i18n/*": [`${i18nDir}/*`], "#l10n/*": [`${l10nDir}/*`], "#root/*": ["./*"] });
+    (0, fs_1.writeFileSync)(tsconfigPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}