Config.js

/**
 * @fileoverview 共通定数・ヘルパー関数
 * 全スクリプトから参照される設定値とユーティリティを集約する。
 */

/** @const {Object} アプリケーション共通設定 */
const CONFIG = {
  /** @property {Object} FOLDER - フォルダ名定義 */
  FOLDER: {
    BACKUP: "backup",
    EXPORT: "export",
  },
  /** @property {Object} CACHE - キャッシュ関連定義 */
  CACHE: {
    BACKUP_FILE_ID_KEY: "BACKUP_FILE_ID",
    BACKUP_DATA_PREFIX: "backup_data_",
    /** @type {number} キャッシュTTL（秒）6時間 */
    TTL_SECONDS: 21600,
  },
  /** @property {Object} EXPORT - エクスポート設定 */
  EXPORT: {
    EXTENSION: ".txt",
    DATE_FORMAT: "yyyyMMdd_HHmmss",
    TIMEZONE: "JST",
  },
  /** @property {Object} BACKUP - バックアップ設定 */
  BACKUP: {
    NAME_PREFIX: "BACKUP_",
  },
  /** @type {string} エクスポート除外列の識別キーワード */
  IGNORE_KEYWORD: "無視",
  /** @type {number} Markdown見出しのオフセット基準レベル */
  HEADING_BASE_LEVEL: 4,
  /** @type {RegExp} コードブロック化する列名パターン */
  CODE_LANGUAGES: /(Python|Handlebars|Mermaid|YAML)/i,
  /** @property {Object} CELL_COLORS - セルの既定色 */
  CELL_COLORS: {
    /** @type {string} 通常セルの背景色 */
    DEFAULT_BACKGROUND: "white",
    /** @type {string} 通常セルの文字色 */
    DEFAULT_TEXT: "black",
    /** @type {string} ヘッダー行の背景色（暗い青2） */
    HEADER_BACKGROUND: "#0B5394",
    /** @type {string} ヘッダー行の文字色 */
    HEADER_TEXT: "white",
  },
  /** @property {Object} DIFF_HIGHLIGHT - 差分ハイライト設定 */
  DIFF_HIGHLIGHT: {
    /** @type {string} 変更行の背景色（ライトブルー） */
    BACKGROUND_COLOR: "#E3F2FD",
    /** @type {string} 変更文字色（青） */
    TEXT_COLOR: "blue",
    /** @type {string} ヘッダー行（1行目）の変更時背景色（ダークオレンジ系） */
    HEADER_BACKGROUND_COLOR: "#FF6B35",
    /** @type {string} ヘッダー行（1行目）の変更文字色（青） */
    HEADER_TEXT_COLOR: "blue",
  },
};

/**
 * アクティブなスプレッドシートの親フォルダを取得する。
 * @param {string} ssId - スプレッドシートのファイルID
 * @returns {GoogleAppsScript.Drive.Folder} 親フォルダ
 * @throws {Error} 親フォルダが存在しない場合
 */
function getParentFolder(ssId) {
  const parents = DriveApp.getFileById(ssId).getParents();
  if (!parents.hasNext()) throw new Error("親フォルダが見つかりません。");
  return parents.next();
}

/**
 * 親フォルダ内のサブフォルダを取得する。存在しなければ新規作成する。
 * @param {GoogleAppsScript.Drive.Folder} parentFolder - 親フォルダ
 * @param {string} folderName - サブフォルダ名
 * @returns {GoogleAppsScript.Drive.Folder} サブフォルダ
 */
function getOrCreateSubFolder(parentFolder, folderName) {
  const folders = parentFolder.getFoldersByName(folderName);
  return folders.hasNext() ? folders.next() : parentFolder.createFolder(folderName);
}

/**
 * バックアップファイル名を生成する。
 * @param {string} ssName - スプレッドシート名
 * @returns {string} "BACKUP_" + スプレッドシート名
 */
function getBackupName(ssName) {
  return CONFIG.BACKUP.NAME_PREFIX + ssName;
}

/**
 * 現在日時のフォーマット済み文字列を返す。
 * @returns {string} "yyyyMMdd_HHmmss" 形式のタイムスタンプ
 */
function getTimestamp() {
  return Utilities.formatDate(new Date(), CONFIG.EXPORT.TIMEZONE, CONFIG.EXPORT.DATE_FORMAT);
}