/**
 * シルギア 和暦・元号API v1 の型定義
 * https://api.shirugear.com/wareki/
 *
 * 明治以降の元号（明治・大正・昭和・平成・令和）と、1868〜2100年の西暦と和暦の対応を返します。
 * 令和は、次の元号が決まっていないため 2100年まで今の元号のまま数えます。
 * 明治5年（1872年）までは旧暦のため、和暦の年の区切りは旧暦の元日です。
 * 西暦 = 和暦の年 + offset（例: 令和8年 = 8 + 2018 = 2026年）。
 *
 * 互換の方針: v1 の中では項目や元号を「足す」ことはあっても、名前や意味は変えません。
 * 知らない項目・元号が増えていても無視してください。
 */

/** 元号の英字の名前 */
export type EraKey = "meiji" | "taisho" | "showa" | "heisei" | "reiwa";

export interface WarekiSource {
  label: string;
  url: string;
}

/** 元号の1件（eras.json の eras の1件・元号ごとの応答の era） */
export interface Era {
  key: EraKey;
  /** 例: "令和" */
  name: string;
  /** 読み（ひらがな） */
  kana: string;
  romaji: string;
  /** 最初の日 "YYYY-MM-DD"（グレゴリオ暦） */
  start: string;
  /** 最後の日 "YYYY-MM-DD"。今の元号（令和）は null */
  end: string | null;
  /** 改元を定めた日（改元の詔・詔書の日、または元号を改める政令の公布日）"YYYY-MM-DD" */
  proclaimed: string;
  /** 最後の年。令和は null */
  last_year: number | null;
  /** 西暦 = 和暦の年 + offset */
  offset: number;
  /** 境目の日の根拠 */
  basis: {
    text: string;
    sources: WarekiSource[];
  };
}

/** GET /wareki/v1/eras.json */
export interface ErasResponse {
  eras: Era[];
  /** 変換の説明 */
  note: string;
  /** 資料と照らし合わせた日 "YYYY-MM-DD" */
  data_version: string;
}

/** 西暦の年の中にある和暦の年の1件 */
export interface YearEra {
  /** 元号（例: "平成"） */
  era: string;
  key: EraKey;
  /** 和暦の年（元年は 1） */
  year: number;
  /** 例: "平成元年" */
  label: string;
  /** その西暦の年の中での期間 "YYYY-MM-DD" */
  from: string;
  to: string;
}

/** GET /wareki/v1/{西暦4桁}.json（1868〜2100） */
export interface YearResponse {
  year: number;
  /** 例: "令和8年"・"昭和64年・平成元年" */
  wareki: string;
  /** 早い順 */
  eras: YearEra[];
  /** 旧暦を使っていた年か（1868〜1872年は true） */
  lunar_calendar: boolean;
  data_version: string;
  /** 注意書き（1868〜1872年だけ） */
  note?: string;
}

/** 元号の中の和暦の1年 */
export interface EraYear {
  /** 元年は 1 */
  year: number;
  label: string;
  /** その和暦の年が始まった西暦の年 */
  seireki: number;
  /** その和暦の年の最初の日と最後の日 "YYYY-MM-DD" */
  from: string;
  to: string;
  lunar_calendar: boolean;
}

/** GET /wareki/v1/{meiji|taisho|showa|heisei|reiwa}.json */
export interface EraResponse {
  era: Era;
  years: EraYear[];
  data_version: string;
}

/** GET /wareki/v1/meta.json */
export interface WarekiMeta {
  data_version: string;
  checked_at: string;
  range: { from: number; to: number };
  scope: string;
  eras: EraKey[];
  counts: { eras: number; years: number };
  sources: WarekiSource[];
}

/** エラー（400・403・404・405） */
export interface WarekiError {
  error: {
    status: number;
    code: "invalid_path" | "region_not_allowed" | "year_not_found" | "method_not_allowed";
    message: string;
  };
}
