@worldware/msg-cli 0.0.5 → 0.1.0

package/dist/commands/init.cjs

@@ -0,0 +1,259 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/commands/init.ts
+var init_exports = {};
+__export(init_exports, {
+  default: () => Init
+});
+module.exports = __toCommonJS(init_exports);
+var import_core = require("@oclif/core");
+var import_child_process = require("child_process");
+var import_fs2 = require("fs");
+var import_readline = require("readline");
+var import_path2 = require("path");
+
+// src/lib/init-helpers.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var DEFAULT_I18N_DIR = "src/i18n";
+var DEFAULT_L10N_DIR = "res/l10n";
+function findPackageJsonPath(cwd) {
+  let dir = cwd;
+  for (; ; ) {
+    const p = (0, import_path.join)(dir, "package.json");
+    if ((0, import_fs.existsSync)(p)) return p;
+    const parent = (0, import_path.dirname)(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readPackageJson(pkgPath) {
+  const raw = (0, import_fs.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;
+  }
+}
+function writePackageJson(pkgPath, pkg) {
+  const json = JSON.stringify(pkg, null, 2) + "\n";
+  (0, import_fs.writeFileSync)(pkgPath, json, "utf-8");
+}
+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 };
+}
+var GITKEEP = ".gitkeep";
+function ensureDirectoriesWithGitkeep(rootDir, i18nDir, l10nDir, force) {
+  const leaves = [
+    (0, import_path.join)(rootDir, i18nDir, "projects"),
+    (0, import_path.join)(rootDir, i18nDir, "resources"),
+    (0, import_path.join)(rootDir, l10nDir, "translations"),
+    (0, import_path.join)(rootDir, l10nDir, "xliff")
+  ];
+  for (const leaf of leaves) {
+    const parent = (0, import_path.dirname)(leaf);
+    if (!(0, import_fs.existsSync)(parent)) {
+      (0, import_fs.mkdirSync)(parent, { recursive: true });
+    }
+    if (!(0, import_fs.existsSync)(leaf)) {
+      (0, import_fs.mkdirSync)(leaf, { recursive: true });
+    }
+    const gitkeepPath = (0, import_path.join)(leaf, GITKEEP);
+    if (force || !(0, import_fs.existsSync)(gitkeepPath)) {
+      (0, import_fs.writeFileSync)(gitkeepPath, "", "utf-8");
+    }
+  }
+}
+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, import_path.join)(rootDir, i18nDir);
+  const l10nFull = (0, import_path.join)(rootDir, l10nDir);
+  return (0, import_fs.existsSync)(i18nFull) && (0, import_fs.existsSync)(l10nFull);
+}
+function addDirectoriesToPackageJson(pkg, i18nDir, l10nDir) {
+  const directories = { ...pkg.directories, i18n: i18nDir, l10n: l10nDir, root: "." };
+  return { ...pkg, directories };
+}
+function addImportAliasesToPackageJson(pkg, i18nDir, l10nDir) {
+  const imports = {
+    ...pkg.imports,
+    "#i18n/*": `${i18nDir}/*`,
+    "#l10n/*": `${l10nDir}/*`,
+    "#root/*": "./*"
+  };
+  return { ...pkg, imports };
+}
+function addScriptsToPackageJson(pkg) {
+  const scripts = {
+    ...pkg.scripts,
+    "i18n-export": "msg export:resources",
+    "l10n-import": "msg import:translations"
+  };
+  return { ...pkg, scripts };
+}
+function addTsconfigPaths(tsconfigPath, i18nDir, l10nDir) {
+  const raw = (0, import_fs.readFileSync)(tsconfigPath, "utf-8");
+  let config;
+  try {
+    config = JSON.parse(raw);
+  } catch {
+    throw new Error("Invalid tsconfig.json");
+  }
+  if (!config.compilerOptions) config.compilerOptions = {};
+  const co = config.compilerOptions;
+  co.baseUrl = co.baseUrl ?? ".";
+  co.paths = {
+    ...co.paths,
+    "#i18n/*": [`${i18nDir}/*`],
+    "#l10n/*": [`${l10nDir}/*`],
+    "#root/*": ["./*"]
+  };
+  (0, import_fs.writeFileSync)(tsconfigPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
+// src/commands/init.ts
+var Init = class _Init extends import_core.Command {
+  static description = "Scaffold a msg project (i18n/l10n directories, package.json, and dependencies)";
+  static examples = [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> <%= command.id %> --i18nDir lib/i18n --l10nDir data/l10n",
+    "<%= config.bin %> <%= command.id %> -f"
+  ];
+  static flags = {
+    help: import_core.Flags.help({ char: "h" }),
+    interactive: import_core.Flags.boolean({
+      char: "i",
+      description: "Prompt for i18n and l10n directory paths"
+    }),
+    force: import_core.Flags.boolean({
+      char: "f",
+      description: "Force clean install; overwrite existing msg setup"
+    }),
+    i18nDir: import_core.Flags.string({
+      description: "Relative path for the i18n directory"
+    }),
+    l10nDir: import_core.Flags.string({
+      description: "Relative path for the l10n directory"
+    })
+  };
+  async run() {
+    const { flags } = await this.parse(_Init);
+    const cwd = process.cwd();
+    const pkgPath = findPackageJsonPath(cwd);
+    if (!pkgPath) {
+      this.error("package.json not found. Run this command from the project root.", {
+        exit: 1
+      });
+    }
+    let i18nDir = flags.i18nDir ?? DEFAULT_I18N_DIR;
+    let l10nDir = flags.l10nDir ?? DEFAULT_L10N_DIR;
+    if (flags.interactive) {
+      const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
+      const ask = (question, defaultVal) => new Promise((resolve) => {
+        rl.question(`${question} [${defaultVal}]: `, (answer) => {
+          resolve((answer?.trim() || defaultVal).trim() || defaultVal);
+        });
+      });
+      if (!flags.i18nDir) {
+        i18nDir = await ask("i18n directory path (relative to project root):", DEFAULT_I18N_DIR);
+      }
+      if (!flags.l10nDir) {
+        l10nDir = await ask("l10n directory path (relative to project root):", DEFAULT_L10N_DIR);
+      }
+      rl.close();
+    }
+    const rootDir = (0, import_path2.join)(cwd);
+    const validation = validatePaths(rootDir, i18nDir, l10nDir);
+    if (!validation.valid) {
+      this.error(validation.error ?? "Invalid paths", { exit: 1 });
+    }
+    let pkg;
+    try {
+      pkg = readPackageJson(pkgPath);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "Invalid or unreadable package.json";
+      this.error(msg, { exit: 1 });
+    }
+    const alreadyInit = 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 {
+      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 = addDirectoriesToPackageJson(pkg, i18nDir, l10nDir);
+    pkg = addImportAliasesToPackageJson(pkg, i18nDir, l10nDir);
+    pkg = addScriptsToPackageJson(pkg);
+    try {
+      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, import_path2.join)(rootDir, "tsconfig.json");
+    if ((0, import_fs2.existsSync)(tsconfigPath)) {
+      this.log("Updating tsconfig.json for path aliases...");
+      try {
+        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, import_child_process.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.");
+  }
+};

package/dist/commands/init.d.mts

@@ -0,0 +1,20 @@
+import * as _oclif_core_lib_interfaces_parser_js from '@oclif/core/lib/interfaces/parser.js';
+import { Command } from '@oclif/core';
+
+/**
+ * Scaffolds a msg project: directories, package.json entries, and dependencies.
+ */
+declare class Init extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: _oclif_core_lib_interfaces_parser_js.BooleanFlag<void>;
+        interactive: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        force: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        i18nDir: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
+        l10nDir: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+
+export { Init as default };

package/dist/commands/init.d.ts

@@ -0,0 +1,20 @@
+import * as _oclif_core_lib_interfaces_parser_js from '@oclif/core/lib/interfaces/parser.js';
+import { Command } from '@oclif/core';
+
+/**
+ * Scaffolds a msg project: directories, package.json entries, and dependencies.
+ */
+declare class Init extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: _oclif_core_lib_interfaces_parser_js.BooleanFlag<void>;
+        interactive: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        force: _oclif_core_lib_interfaces_parser_js.BooleanFlag<boolean>;
+        i18nDir: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
+        l10nDir: _oclif_core_lib_interfaces_parser_js.OptionFlag<string | undefined, _oclif_core_lib_interfaces_parser_js.CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+
+export { Init as default };

package/dist/commands/init.mjs

@@ -0,0 +1,133 @@
+import {
+  DEFAULT_I18N_DIR,
+  DEFAULT_L10N_DIR,
+  addDirectoriesToPackageJson,
+  addImportAliasesToPackageJson,
+  addScriptsToPackageJson,
+  addTsconfigPaths,
+  ensureDirectoriesWithGitkeep,
+  findPackageJsonPath,
+  isAlreadyInitialized,
+  readPackageJson,
+  validatePaths,
+  writePackageJson
+} from "../chunk-DBC2Y6VQ.mjs";
+
+// src/commands/init.ts
+import { Command, Flags } from "@oclif/core";
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { createInterface } from "readline";
+import { join } from "path";
+var Init = class _Init extends Command {
+  static description = "Scaffold a msg project (i18n/l10n directories, package.json, and dependencies)";
+  static examples = [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> <%= command.id %> --i18nDir lib/i18n --l10nDir data/l10n",
+    "<%= config.bin %> <%= command.id %> -f"
+  ];
+  static flags = {
+    help: Flags.help({ char: "h" }),
+    interactive: Flags.boolean({
+      char: "i",
+      description: "Prompt for i18n and l10n directory paths"
+    }),
+    force: Flags.boolean({
+      char: "f",
+      description: "Force clean install; overwrite existing msg setup"
+    }),
+    i18nDir: Flags.string({
+      description: "Relative path for the i18n directory"
+    }),
+    l10nDir: Flags.string({
+      description: "Relative path for the l10n directory"
+    })
+  };
+  async run() {
+    const { flags } = await this.parse(_Init);
+    const cwd = process.cwd();
+    const pkgPath = findPackageJsonPath(cwd);
+    if (!pkgPath) {
+      this.error("package.json not found. Run this command from the project root.", {
+        exit: 1
+      });
+    }
+    let i18nDir = flags.i18nDir ?? DEFAULT_I18N_DIR;
+    let l10nDir = flags.l10nDir ?? DEFAULT_L10N_DIR;
+    if (flags.interactive) {
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const ask = (question, defaultVal) => new Promise((resolve) => {
+        rl.question(`${question} [${defaultVal}]: `, (answer) => {
+          resolve((answer?.trim() || defaultVal).trim() || defaultVal);
+        });
+      });
+      if (!flags.i18nDir) {
+        i18nDir = await ask("i18n directory path (relative to project root):", DEFAULT_I18N_DIR);
+      }
+      if (!flags.l10nDir) {
+        l10nDir = await ask("l10n directory path (relative to project root):", DEFAULT_L10N_DIR);
+      }
+      rl.close();
+    }
+    const rootDir = join(cwd);
+    const validation = validatePaths(rootDir, i18nDir, l10nDir);
+    if (!validation.valid) {
+      this.error(validation.error ?? "Invalid paths", { exit: 1 });
+    }
+    let pkg;
+    try {
+      pkg = readPackageJson(pkgPath);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "Invalid or unreadable package.json";
+      this.error(msg, { exit: 1 });
+    }
+    const alreadyInit = 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 {
+      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 = addDirectoriesToPackageJson(pkg, i18nDir, l10nDir);
+    pkg = addImportAliasesToPackageJson(pkg, i18nDir, l10nDir);
+    pkg = addScriptsToPackageJson(pkg);
+    try {
+      writePackageJson(pkgPath, pkg);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : "Failed to write package.json";
+      this.error(msg, { exit: 1 });
+    }
+    const tsconfigPath = join(rootDir, "tsconfig.json");
+    if (existsSync(tsconfigPath)) {
+      this.log("Updating tsconfig.json for path aliases...");
+      try {
+        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 = 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.");
+  }
+};
+export {
+  Init as default
+};

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

@@ -0,0 +1,163 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/create-project-helpers.ts
+var create_project_helpers_exports = {};
+__export(create_project_helpers_exports, {
+  calculateRelativePath: () => calculateRelativePath,
+  importMsgProjectFile: () => importMsgProjectFile,
+  loadPackageJsonForCreateProject: () => loadPackageJsonForCreateProject,
+  writeMsgProjectFile: () => writeMsgProjectFile
+});
+module.exports = __toCommonJS(create_project_helpers_exports);
+var import_fs2 = require("fs");
+var import_path2 = require("path");
+var import_url2 = require("url");
+
+// src/lib/create-resource-helpers.ts
+var import_module = require("module");
+var import_url = require("url");
+
+// src/lib/init-helpers.ts
+var import_fs = require("fs");
+var import_path = require("path");
+function findPackageJsonPath(cwd) {
+  let dir = cwd;
+  for (; ; ) {
+    const p = (0, import_path.join)(dir, "package.json");
+    if ((0, import_fs.existsSync)(p)) return p;
+    const parent = (0, import_path.dirname)(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readPackageJson(pkgPath) {
+  const raw = (0, import_fs.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;
+  }
+}
+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?.requireL10n && !dirs.l10n) {
+    throw new Error(
+      "package.json must contain directories.i18n and directories.l10n. Run 'msg init' first."
+    );
+  }
+  const rootDir = (0, import_path.dirname)(pkgPath);
+  const useTypeScript = (0, import_fs.existsSync)((0, import_path.join)(rootDir, "tsconfig.json"));
+  const isEsm = pkg.type === "module";
+  return {
+    pkgPath,
+    rootDir,
+    pkg,
+    i18nDir: dirs.i18n,
+    l10nDir: dirs.l10n,
+    isEsm,
+    useTypeScript
+  };
+}
+
+// src/lib/create-resource-helpers.ts
+async function dynamicImportFromUrl(url) {
+  try {
+    return await import(
+      /* @vite-ignore */
+      url
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const useRequire = msg.includes("dynamic import callback") || msg.includes("ERR_VM_DYNAMIC_IMPORT");
+    if (useRequire) {
+      try {
+        const path = url.startsWith("file:") ? (0, import_url.fileURLToPath)(url) : url;
+        const base = (0, import_url.pathToFileURL)(process.cwd()).href;
+        const req = (0, import_module.createRequire)(base);
+        const mod = req(path);
+        return Promise.resolve(mod ?? {});
+      } catch {
+      }
+    }
+    throw err;
+  }
+}
+
+// src/lib/create-project-helpers.ts
+function calculateRelativePath(projectsDir, translationsDir) {
+  const rel = (0, import_path2.relative)(projectsDir, translationsDir);
+  return rel.startsWith(".") ? rel : `./${rel}`;
+}
+async function importMsgProjectFile(projectsDir, projectName) {
+  const basePath = (0, import_path2.join)(projectsDir, projectName);
+  const exts = [".ts", ".js"];
+  for (const ext of exts) {
+    const p = `${basePath}${ext}`;
+    if ((0, import_fs2.existsSync)(p)) {
+      try {
+        const url = (0, import_url2.pathToFileURL)(p).href;
+        const mod = await dynamicImportFromUrl(url);
+        return mod?.default ?? mod;
+      } catch {
+        return void 0;
+      }
+    }
+  }
+  return void 0;
+}
+function writeMsgProjectFile(filePath, content) {
+  const dir = (0, import_path2.dirname)(filePath);
+  if (!(0, import_fs2.existsSync)(dir)) {
+    (0, import_fs2.mkdirSync)(dir, { recursive: true });
+  }
+  (0, import_fs2.writeFileSync)(filePath, content, "utf-8");
+}
+function loadPackageJsonForCreateProject(cwd) {
+  const ctx = loadPackageJsonForMsg(cwd, { requireL10n: true });
+  return ctx.pkg;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateRelativePath,
+  importMsgProjectFile,
+  loadPackageJsonForCreateProject,
+  writeMsgProjectFile
+});

package/dist/lib/create-project-helpers.d.mts

@@ -0,0 +1,50 @@
+import { PackageJson } from './init-helpers.mjs';
+
+/** Minimal type for MsgProject-like data we read from an existing project file. */
+interface MsgProjectFileData {
+    project?: {
+        name?: string;
+        version?: number;
+    };
+    locales?: {
+        sourceLocale?: string;
+        pseudoLocale?: string;
+        targetLocales?: Record<string, string[]>;
+    };
+    loader?: unknown;
+}
+/**
+ * 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()
+ */
+declare function calculateRelativePath(projectsDir: string, translationsDir: string): string;
+/**
+ * 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
+ */
+declare function importMsgProjectFile(projectsDir: string, projectName: string): Promise<MsgProjectFileData | 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
+ */
+declare function writeMsgProjectFile(filePath: string, content: string): void;
+/**
+ * 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
+ */
+declare function loadPackageJsonForCreateProject(cwd: string): PackageJson & {
+    directories: {
+        i18n: string;
+        l10n: string;
+    };
+};
+
+export { type MsgProjectFileData, calculateRelativePath, importMsgProjectFile, loadPackageJsonForCreateProject, writeMsgProjectFile };