@tbsten/mir-core 0.0.2-alpha02 → 0.0.2-alpha03

package/src/helpers/string-helpers.ts

@@ -1,76 +0,0 @@
-/**
- * Handlebars カスタムヘルパー用の純粋関数群
- * 外部ライブラリ不使用
- */
-
-/** 単語分割: `-`, `_`, `.`, スペース, camelCase 境界で分割 */
-function splitWords(value: string): string[] {
-  return value
-    .replace(/([a-z0-9])([A-Z])/g, "$1\0$2")
-    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1\0$2")
-    .split(/[-_.\s\0]+/)
-    .filter((w) => w.length > 0);
-}
-
-export function lowercase(value: unknown): string {
-  return String(value).toLowerCase();
-}
-
-export function uppercase(value: unknown): string {
-  return String(value).toUpperCase();
-}
-
-export function capitalize(value: unknown): string {
-  const s = String(value);
-  if (s.length === 0) return s;
-  return s[0].toUpperCase() + s.slice(1);
-}
-
-export function uncapitalize(value: unknown): string {
-  const s = String(value);
-  if (s.length === 0) return s;
-  return s[0].toLowerCase() + s.slice(1);
-}
-
-/** リテラル文字列置換（replaceAll）。正規表現は受け付けない（ReDoS 防止） */
-export function replace(
-  value: unknown,
-  search: unknown,
-  replacement: unknown,
-): string {
-  const s = String(value);
-  const searchStr = String(search);
-  const replaceStr = String(replacement);
-  if (searchStr === "") return s;
-  return s.split(searchStr).join(replaceStr);
-}
-
-export function camelCase(value: unknown): string {
-  const words = splitWords(String(value));
-  return words
-    .map((w, i) =>
-      i === 0 ? w.toLowerCase() : w[0].toUpperCase() + w.slice(1).toLowerCase(),
-    )
-    .join("");
-}
-
-export function pascalCase(value: unknown): string {
-  const words = splitWords(String(value));
-  return words.map((w) => w[0].toUpperCase() + w.slice(1).toLowerCase()).join("");
-}
-
-export function snakeCase(value: unknown): string {
-  return splitWords(String(value))
-    .map((w) => w.toLowerCase())
-    .join("_");
-}
-
-export function kebabCase(value: unknown): string {
-  return splitWords(String(value))
-    .map((w) => w.toLowerCase())
-    .join("-");
-}
-
-export function trim(value: unknown): string {
-  return String(value).trim();
-}

package/src/hooks.ts

@@ -1,63 +0,0 @@
-import { MirError } from "./errors.js";
-import { expandTemplate } from "./template-engine.js";
-import { t } from "./i18n/index.js";
-import type { Action } from "./snippet-schema.js";
-
-export class ExitHookError extends MirError {
-  constructor() {
-    super(t("error.exit-hook"));
-    this.name = "ExitHookError";
-  }
-}
-
-export interface HookExecutionOptions {
-  onEcho?: (message: string) => void;
-}
-
-export function executeHooks(
-  actions: Action[],
-  variables: Record<string, unknown>,
-  options?: HookExecutionOptions,
-): Record<string, unknown> {
-  const vars = { ...variables };
-
-  for (const action of actions) {
-    if (action.echo !== undefined) {
-      const message = expandTemplate(action.echo, vars);
-      options?.onEcho?.(message);
-    }
-
-    if (action.exit !== undefined) {
-      if (action.if !== undefined) {
-        const condition = expandTemplate(action.if, vars);
-        if (isTruthy(condition)) {
-          throw new ExitHookError();
-        }
-      } else if (action.exit) {
-        throw new ExitHookError();
-      }
-    }
-
-    if (action.input !== undefined) {
-      for (const [, inputDef] of Object.entries(action.input)) {
-        const answerTo = inputDef["answer-to"];
-        if (!answerTo) continue;
-
-        if (inputDef.schema?.default !== undefined) {
-          vars[answerTo] = inputDef.schema.default;
-        } else {
-          throw new MirError(
-            t("error.hook-input-required", { key: answerTo }),
-          );
-        }
-      }
-    }
-  }
-
-  return vars;
-}
-
-function isTruthy(value: string): boolean {
-  const trimmed = value.trim();
-  return trimmed !== "" && trimmed !== "false" && trimmed !== "0";
-}

package/src/i18n/index.ts

@@ -1,32 +0,0 @@
-import type { MessageKey, MessageCatalog } from "./types.js";
-import { ja } from "./locales/ja.js";
-import { en } from "./locales/en.js";
-
-export type Locale = "ja" | "en";
-
-const catalogs: Record<Locale, MessageCatalog> = { ja, en };
-
-let currentLocale: Locale = "ja";
-
-export function setLocale(locale: Locale): void {
-  currentLocale = locale;
-}
-
-export function getLocale(): Locale {
-  return currentLocale;
-}
-
-export function t(
-  key: MessageKey,
-  params?: Record<string, string | number>,
-): string {
-  let message = catalogs[currentLocale][key];
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      message = message.replaceAll(`{${k}}`, String(v));
-    }
-  }
-  return message;
-}
-
-export type { MessageKey, MessageCatalog };

package/src/i18n/locales/en.ts

@@ -1,96 +0,0 @@
-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",
-  "error.publish-token-required": "publish_token is required to publish to remote registry. Configure it in ~/.mir/mirconfig.yaml",
-  "error.publish-auth-failed": "Publish authentication failed. Please verify your publish_token",
-  "error.publish-token-invalid": "Invalid publish_token. Check your registry configuration",
-  "error.publish-failed": "Failed to publish snippet: {error}",
-  "error.publish-network-error": "Network error: {message}",
-
-  // 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

@@ -1,96 +0,0 @@
-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 の履歴がありません",
-  "error.publish-token-required": "リモート registry への publish には publish_token が必要です。~/.mir/mirconfig.yaml で設定してください",
-  "error.publish-auth-failed": "publish 認証に失敗しました。publish_token を確認してください",
-  "error.publish-token-invalid": "publish_token が無効です。registry の設定を確認してください",
-  "error.publish-failed": "Snippet の publish に失敗しました: {error}",
-  "error.publish-network-error": "ネットワークエラー: {message}",
-
-  // 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

@@ -1,96 +0,0 @@
-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;
-  "error.publish-token-required": string;
-  "error.publish-auth-failed": string;
-  "error.publish-token-invalid": string;
-  "error.publish-failed": string;
-  "error.publish-network-error": 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

@@ -1,86 +0,0 @@
-// 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";
-
-// helpers
-export { HELPER_NAMES } from "./helpers/index.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,
-  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

@@ -1,62 +0,0 @@
-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,
-  };
-}