@tbsten/mir-core 0.0.1-alpha02

package/src/i18n/locales/en.ts

@@ -0,0 +1,91 @@
+import type { MessageCatalog } from "../types.js";
+
+export const en: MessageCatalog = {
+  // errors
+  "error.snippet-not-found": "Snippet \"{name}\" not found. Use `mir list` to see available snippets or specify `--registry` for another registry",
+  "error.snippet-already-exists": "Snippet \"{name}\" already exists. Use `--force` to overwrite or specify a different name",
+  "error.registry-not-found": "Registry \"{name}\" not found. Configure registries in `~/.mir/mirconfig.yaml`",
+  "error.registry-remote": "Cannot publish to remote registry",
+  "error.registry-remote-named": "Cannot publish to registry \"{name}\" because it is a remote registry",
+  "error.path-traversal": "Security error: File path \"{path}\" references outside the output directory. Check your template files",
+  "error.file-conflict": "File \"{path}\" already exists. Use `--no-interactive` to overwrite all files or `--out-dir` to specify another directory",
+  "error.validation": "Validation error",
+  "error.invalid-snippet-name": "Invalid snippet name \"{name}\". Only alphanumeric characters and hyphens are allowed, and must start with an alphanumeric character",
+  "error.variable-empty": "No value provided for variable \"{key}\"",
+  "error.variable-required": "Variable \"{key}\" is required. Specify it with {hint}",
+  "error.exit-hook": "Installation was cancelled",
+  "error.hook-input-required": "Variable \"{key}\" requires input, but interactive mode is not yet supported. Please specify a default value",
+  "error.no-snippets": "No snippets available to select",
+  "error.remote-fetch": "Failed to fetch from remote registry: {url}",
+  "error.remote-fetch-status": "Failed to fetch from remote registry: {url} (HTTP {status})",
+  "error.invalid-manifest": "Invalid manifest from remote registry: {url}",
+  "error.fetch-timeout": "Timeout: Connection to {url} did not complete within {timeout} seconds",
+  "error.symlink-detected": "Symbolic link detected: {path}",
+  "error.symlink-in-snippet": "Snippet contains symbolic links: {paths}",
+  "error.safe-mode-overwrite": "Overwriting existing files is not allowed in safe mode: {path}",
+  "error.file-not-found": "File \"{path}\" not found",
+  "error.file-read-failed": "Failed to read file \"{path}\"",
+  "error.snippet-not-found-details": "\nPossible causes:\n1. Typo in snippet name\n2. Snippet not registered in registry\n3. No access permission to registry\n\nWays to check:\n• mir list              - Show available snippets\n• mir search <keyword> - Search by keyword\n• mir info <name>      - Show snippet details",
+
+  // create
+  "create.success": "Created snippet \"{name}\"",
+
+  // publish
+  "publish.success": "Published snippet \"{name}\" to registry",
+  "publish.cancelled": "Publish cancelled",
+  "publish.confirm-overwrite": "Snippet \"{name}\" already exists. Overwrite?",
+
+  // install
+  "install.success": "Installed snippet \"{name}\"",
+  "install.skip": "Skipped: {path}",
+  "install.confirm-overwrite": "File \"{path}\" already exists. Overwrite? (y/n/a): ",
+  "install.dry-run-files": "[dry-run] Files to be generated:",
+  "install.dry-run-complete": "[dry-run] No actual file writes were performed.",
+  "install.multiple-snippets": "Installing multiple snippets...",
+  "install.snippet-n-of-m": "{current} / {total}: {name}",
+  "install.completed-multiple": "Installed {count} snippet(s)",
+  "install.failed-multiple": "Failed to install {count} snippet(s)",
+  "install.safe-mode-hooks-skipped": "[safe] Skipped hooks execution",
+  "install.symlink-warning": "Symbolic link detected: {path}",
+
+  // sync
+  "sync.no-new-vars": "No new variables to add",
+  "sync.success": "Added {count} variable(s)",
+
+  // search
+  "search.query-required": "Search query is required",
+  "search.no-results": "No snippets found matching \"{query}\"",
+
+  // error specific
+  "error.no-failed-snippets": "No failed snippet history",
+
+  // clone
+  "clone.success": "Cloned snippet \"{name}\" to \"{alias}\"",
+
+  // preview
+  "preview.title": "Preview: {name}",
+  "preview.confirm": "Do you want to install this snippet?",
+
+  // prompt
+  "prompt.snippet-name": "Snippet name: ",
+  "prompt.select-snippet": "Select a snippet",
+  "prompt.select": "Select: ",
+  "prompt.enter-number": "Please enter a number",
+  "prompt.other-manual": "Other (manual input)",
+  "prompt.use-default": "Press Enter to use {value}",
+  "prompt.use-default-value": "Press Enter to use default \"{value}\"",
+  "prompt.yes-no-all": "(y/n/a): ",
+  "prompt.yes-no": "(y/N): ",
+
+  // batch-summary
+  "batch-summary.results": "Installation results:",
+  "batch-summary.success": "Success",
+  "batch-summary.failure": "Failed",
+  "batch-summary.skipped": "Skipped",
+  "batch-summary.counts": "Success: {success}/{total}, Failed: {failure}/{total}, Skipped: {skipped}/{total}",
+  "batch-summary.retry-hint": "💡 To retry failed snippets: mir install --retry-failed",
+
+  // general
+  "general.variables": "Variables:",
+  "general.default": "(default)",
+};

package/src/i18n/locales/ja.ts

@@ -0,0 +1,91 @@
+import type { MessageCatalog } from "../types.js";
+
+export const ja: MessageCatalog = {
+  // errors
+  "error.snippet-not-found": "Snippet \"{name}\" が見つかりません。`mir list` で利用可能な snippet を確認するか、`--registry` で別の registry を指定してください",
+  "error.snippet-already-exists": "Snippet \"{name}\" は既に存在します。`--force` で上書きするか、別の名前を指定してください",
+  "error.registry-not-found": "Registry \"{name}\" が見つかりません。`~/.mir/mirconfig.yaml` で registry を設定してください",
+  "error.registry-remote": "リモート registry には publish できません",
+  "error.registry-remote-named": "Registry \"{name}\" はリモート registry のため publish できません",
+  "error.path-traversal": "セキュリティエラー: ファイルパス \"{path}\" が出力範囲外を参照しています。テンプレートファイルを確認してください",
+  "error.file-conflict": "ファイル \"{path}\" は既に存在します。`--no-interactive` で全て上書きするか、`--out-dir` で別ディレクトリを指定してください",
+  "error.validation": "バリデーションエラー",
+  "error.invalid-snippet-name": "不正な snippet 名 \"{name}\" です。英数字とハイフンのみ使用可能で、先頭は英数字にしてください",
+  "error.variable-empty": "変数 \"{key}\" の値が入力されませんでした",
+  "error.variable-required": "変数 \"{key}\" の値が必要です。{hint} で指定してください",
+  "error.exit-hook": "install が中止されました",
+  "error.hook-input-required": "変数 \"{key}\" の入力が必要ですが、interactive mode は未対応です。default 値を指定してください",
+  "error.no-snippets": "選択可能な snippet がありません",
+  "error.remote-fetch": "リモート registry の取得に失敗しました: {url}",
+  "error.remote-fetch-status": "リモート registry の取得に失敗しました: {url} (HTTP {status})",
+  "error.invalid-manifest": "リモート registry のマニフェストが不正です: {url}",
+  "error.fetch-timeout": "タイムアウト: {url} への接続が {timeout} 秒以内に完了しませんでした",
+  "error.symlink-detected": "シンボリックリンクが検出されました: {path}",
+  "error.symlink-in-snippet": "Snippet にシンボリックリンクが含まれています: {paths}",
+  "error.safe-mode-overwrite": "safe モードでは既存ファイルの上書きは許可されていません: {path}",
+  "error.file-not-found": "ファイル \"{path}\" が見つかりません",
+  "error.file-read-failed": "ファイル \"{path}\" の読み込みに失敗しました",
+  "error.snippet-not-found-details": "\n可能な原因:\n1. Snippet 名の入力ミス\n2. Registry に登録されていない\n3. Registry へのアクセス権限がない\n\n確認方法:\n• mir list              - 利用可能な snippet を表示\n• mir search <keyword> - キーワードで検索\n• mir info <name>      - snippet の詳細情報を表示",
+
+  // create
+  "create.success": "Snippet \"{name}\" を作成しました",
+
+  // publish
+  "publish.success": "Snippet \"{name}\" を registry に登録しました",
+  "publish.cancelled": "publish をキャンセルしました",
+  "publish.confirm-overwrite": "Snippet \"{name}\" は既に存在します。上書きしますか？",
+
+  // install
+  "install.success": "Snippet \"{name}\" をインストールしました",
+  "install.skip": "スキップ: {path}",
+  "install.confirm-overwrite": "ファイル \"{path}\" は既に存在します。上書きしますか？ (y/n/a): ",
+  "install.dry-run-files": "[dry-run] 生成されるファイル:",
+  "install.dry-run-complete": "[dry-run] 実際のファイル書き込みは実行されていません。",
+  "install.multiple-snippets": "複数の snippet をインストール中...",
+  "install.snippet-n-of-m": "{current} / {total}: {name}",
+  "install.completed-multiple": "{count} 個の snippet をインストールしました",
+  "install.failed-multiple": "{count} 個の snippet のインストールに失敗しました",
+  "install.safe-mode-hooks-skipped": "[safe] hooks の実行をスキップしました",
+  "install.symlink-warning": "シンボリックリンクが検出されました: {path}",
+
+  // sync
+  "sync.no-new-vars": "追加する変数はありません",
+  "sync.success": "{count} 件の変数を追加しました",
+
+  // search
+  "search.query-required": "検索キーワードが必要です",
+  "search.no-results": "\"{query}\" に一致する snippet が見つかりません",
+
+  // error specific
+  "error.no-failed-snippets": "失敗した snippet の履歴がありません",
+
+  // clone
+  "clone.success": "Snippet \"{name}\" を \"{alias}\" として複製しました",
+
+  // preview
+  "preview.title": "プレビュー: {name}",
+  "preview.confirm": "この snippet をインストールしますか？",
+
+  // prompt
+  "prompt.snippet-name": "snippet 名: ",
+  "prompt.select-snippet": "snippet を選択してください",
+  "prompt.select": "選択: ",
+  "prompt.enter-number": "番号を入力してください",
+  "prompt.other-manual": "その他 (手動入力)",
+  "prompt.use-default": "Enter で {value} を使用",
+  "prompt.use-default-value": "Enter でデフォルト値 \"{value}\" を使用",
+  "prompt.yes-no-all": "(y/n/a): ",
+  "prompt.yes-no": "(y/N): ",
+
+  // batch-summary
+  "batch-summary.results": "インストール結果:",
+  "batch-summary.success": "成功",
+  "batch-summary.failure": "失敗",
+  "batch-summary.skipped": "スキップ",
+  "batch-summary.counts": "成功: {success}/{total}, 失敗: {failure}/{total}, スキップ: {skipped}/{total}",
+  "batch-summary.retry-hint": "💡 失敗した snippet をもう一度インストールするには: mir install --retry-failed",
+
+  // general
+  "general.variables": "Variables:",
+  "general.default": "(default)",
+};

package/src/i18n/types.ts

@@ -0,0 +1,91 @@
+export interface MessageCatalog {
+  // errors
+  "error.snippet-not-found": string;
+  "error.snippet-already-exists": string;
+  "error.registry-not-found": string;
+  "error.registry-remote": string;
+  "error.registry-remote-named": string;
+  "error.path-traversal": string;
+  "error.file-conflict": string;
+  "error.validation": string;
+  "error.invalid-snippet-name": string;
+  "error.variable-empty": string;
+  "error.variable-required": string;
+  "error.exit-hook": string;
+  "error.hook-input-required": string;
+  "error.no-snippets": string;
+  "error.remote-fetch": string;
+  "error.remote-fetch-status": string;
+  "error.invalid-manifest": string;
+  "error.fetch-timeout": string;
+  "error.symlink-detected": string;
+  "error.symlink-in-snippet": string;
+  "error.safe-mode-overwrite": string;
+  "error.file-not-found": string;
+  "error.file-read-failed": string;
+  "error.snippet-not-found-details": string;
+
+  // create
+  "create.success": string;
+
+  // publish
+  "publish.success": string;
+  "publish.cancelled": string;
+  "publish.confirm-overwrite": string;
+
+  // install
+  "install.success": string;
+  "install.skip": string;
+  "install.confirm-overwrite": string;
+  "install.dry-run-files": string;
+  "install.dry-run-complete": string;
+  "install.multiple-snippets": string;
+  "install.snippet-n-of-m": string;
+  "install.completed-multiple": string;
+  "install.failed-multiple": string;
+  "install.safe-mode-hooks-skipped": string;
+  "install.symlink-warning": string;
+
+  // sync
+  "sync.no-new-vars": string;
+  "sync.success": string;
+
+  // search
+  "search.query-required": string;
+  "search.no-results": string;
+
+  // error specific
+  "error.no-failed-snippets": string;
+
+  // clone
+  "clone.success": string;
+
+  // preview
+  "preview.title": string;
+  "preview.confirm": string;
+
+  // prompt
+  "prompt.snippet-name": string;
+  "prompt.select-snippet": string;
+  "prompt.select": string;
+  "prompt.enter-number": string;
+  "prompt.other-manual": string;
+  "prompt.use-default": string;
+  "prompt.use-default-value": string;
+  "prompt.yes-no-all": string;
+  "prompt.yes-no": string;
+
+  // batch-summary
+  "batch-summary.results": string;
+  "batch-summary.success": string;
+  "batch-summary.failure": string;
+  "batch-summary.skipped": string;
+  "batch-summary.counts": string;
+  "batch-summary.retry-hint": string;
+
+  // general
+  "general.variables": string;
+  "general.default": string;
+}
+
+export type MessageKey = keyof MessageCatalog;

package/src/index.ts

@@ -0,0 +1,84 @@
+// errors
+export {
+  MirError,
+  ValidationError,
+  SnippetNotFoundError,
+  SnippetAlreadyExistsError,
+  RegistryNotFoundError,
+  RegistryRemoteError,
+  PathTraversalError,
+  FileConflictError,
+  RemoteRegistryFetchError,
+  InvalidManifestError,
+} from "./errors.js";
+
+// snippet-schema
+export {
+  parseSnippetYaml,
+  serializeSnippetYaml,
+  validateSnippetDefinition,
+} from "./snippet-schema.js";
+export type {
+  VariableSchema,
+  VariableDefinition,
+  Action,
+  SnippetDefinition,
+} from "./snippet-schema.js";
+
+// validate-name
+export { validateSnippetName } from "./validate-name.js";
+
+// safe-yaml-parser
+export {
+  safeParseYaml,
+  checkNoRefInSchema,
+  YAML_MAX_SIZE_BYTES,
+} from "./safe-yaml-parser.js";
+
+// template-engine
+export {
+  expandTemplate,
+  expandPath,
+  extractVariables,
+  extractVariablesFromDirectory,
+  expandTemplateDirectory,
+} from "./template-engine.js";
+
+// hooks
+export { ExitHookError, executeHooks } from "./hooks.js";
+export type { HookExecutionOptions } from "./hooks.js";
+
+// registry
+export {
+  listRegistrySnippets,
+  snippetExistsInRegistry,
+  readSnippetFromRegistry,
+  listTemplateFiles,
+  readTemplateFile,
+  copySnippetToRegistry,
+  removeSnippetFromRegistry,
+} from "./registry.js";
+
+// remote-registry
+export {
+  fetchRegistryManifest,
+  listRemoteSnippets,
+  searchRemoteSnippets,
+  fetchSnippetDefinition,
+  fetchRemoteFiles,
+  fetchRemoteSnippet,
+  expandRemoteTemplateFiles,
+} from "./remote-registry.js";
+export type { RegistryManifest, RemoteSnippet, FetchOptions } from "./remote-registry.js";
+
+// symlink-checker
+export {
+  isSymbolicLink,
+  findSymlinksInDirectory,
+} from "./lib/symlink-checker.js";
+export type { SymlinkCheckResult } from "./lib/symlink-checker.js";
+
+// i18n
+export { setLocale, getLocale, t } from "./i18n/index.js";
+export type { Locale } from "./i18n/index.js";
+export type { MessageKey, MessageCatalog } from "./i18n/types.js";

package/src/lib/symlink-checker.ts

@@ -0,0 +1,62 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export interface SymlinkCheckResult {
+  hasSymlinks: boolean;
+  symlinkPaths: string[];
+}
+
+/**
+ * 指定ファイルがシンボリックリンクかどうかを確認する
+ * lstat を使用することで、リンク先ではなくリンク自体の情報を取得する
+ */
+export function isSymbolicLink(filePath: string): boolean {
+  try {
+    const stat = fs.lstatSync(filePath);
+    return stat.isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * ディレクトリ内のシンボリックリンクを再帰的に検索する
+ * @param dirPath 検索対象ディレクトリ
+ * @returns シンボリックリンクの有無と、見つかったシンボリックリンクのパス一覧
+ */
+export function findSymlinksInDirectory(dirPath: string): SymlinkCheckResult {
+  const symlinkPaths: string[] = [];
+
+  function walkDir(currentPath: string, relativePath: string): void {
+    let entries: fs.Dirent[];
+    try {
+      entries = fs.readdirSync(currentPath, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      const fullPath = path.join(currentPath, entry.name);
+      const relPath = relativePath
+        ? path.join(relativePath, entry.name)
+        : entry.name;
+
+      // isSymbolicLink() は entry レベルで確認可能だが、
+      // lstat で確実に判定するため個別確認
+      if (isSymbolicLink(fullPath)) {
+        symlinkPaths.push(relPath);
+      } else if (entry.isDirectory()) {
+        walkDir(fullPath, relPath);
+      }
+    }
+  }
+
+  if (fs.existsSync(dirPath)) {
+    walkDir(dirPath, "");
+  }
+
+  return {
+    hasSymlinks: symlinkPaths.length > 0,
+    symlinkPaths,
+  };
+}

package/src/registry.ts

@@ -0,0 +1,117 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parseSnippetYaml, type SnippetDefinition } from "./snippet-schema.js";
+
+export function listRegistrySnippets(registryPath: string): string[] {
+  if (!fs.existsSync(registryPath)) {
+    return [];
+  }
+  const entries = fs.readdirSync(registryPath);
+  return entries
+    .filter((e) => e.endsWith(".yaml"))
+    .map((e) => e.replace(/\.yaml$/, ""));
+}
+
+export function snippetExistsInRegistry(
+  registryPath: string,
+  name: string,
+): boolean {
+  const yamlPath = path.join(registryPath, `${name}.yaml`);
+  return fs.existsSync(yamlPath);
+}
+
+export function readSnippetFromRegistry(
+  registryPath: string,
+  name: string,
+): SnippetDefinition {
+  const yamlPath = path.join(registryPath, `${name}.yaml`);
+  const content = fs.readFileSync(yamlPath, "utf-8");
+  return parseSnippetYaml(content);
+}
+
+export function listTemplateFiles(
+  registryPath: string,
+  name: string,
+): string[] {
+  const dirPath = path.join(registryPath, name);
+  if (!fs.existsSync(dirPath)) {
+    return [];
+  }
+  return listFilesRecursive(dirPath, "");
+}
+
+function listFilesRecursive(basePath: string, relativePath: string): string[] {
+  const fullPath = relativePath
+    ? path.join(basePath, relativePath)
+    : basePath;
+  const entries = fs.readdirSync(fullPath, { withFileTypes: true });
+  const files: string[] = [];
+
+  for (const entry of entries) {
+    const entryRelative = relativePath
+      ? path.join(relativePath, entry.name)
+      : entry.name;
+    if (entry.isDirectory()) {
+      files.push(...listFilesRecursive(basePath, entryRelative));
+    } else {
+      files.push(entryRelative);
+    }
+  }
+
+  return files;
+}
+
+export function readTemplateFile(
+  registryPath: string,
+  name: string,
+  filePath: string,
+): string {
+  const fullPath = path.join(registryPath, name, filePath);
+  return fs.readFileSync(fullPath, "utf-8");
+}
+
+export function copySnippetToRegistry(
+  sourceDir: string,
+  sourceYamlPath: string,
+  registryPath: string,
+  name: string,
+): void {
+  fs.mkdirSync(registryPath, { recursive: true });
+
+  const destYaml = path.join(registryPath, `${name}.yaml`);
+  fs.copyFileSync(sourceYamlPath, destYaml);
+
+  const destDir = path.join(registryPath, name);
+  copyDirectoryRecursive(sourceDir, destDir);
+}
+
+function copyDirectoryRecursive(src: string, dest: string): void {
+  fs.mkdirSync(dest, { recursive: true });
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirectoryRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+export function removeSnippetFromRegistry(
+  registryPath: string,
+  name: string,
+): void {
+  const yamlPath = path.join(registryPath, `${name}.yaml`);
+  if (fs.existsSync(yamlPath)) {
+    fs.unlinkSync(yamlPath);
+  }
+
+  const dirPath = path.join(registryPath, name);
+  if (fs.existsSync(dirPath)) {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+  }
+}