@typescript-calendar-lib/cli 0.2.5 → 0.2.7

package/src/bin.ts

@@ -1,209 +0,0 @@
-#!/usr/bin/env bun
-import type {
-  HighlightStyle,
-  Locale,
-  WeekStart,
-} from "@typescript-calendar-lib/core";
-import { createDate } from "@typescript-calendar-lib/core";
-import { calendar } from "./calendar.ts";
-import type { ColorSchemeName, ThemeName } from "./theme.ts";
-
-export interface CliArgs {
-  year?: number;
-  month?: number;
-  theme?: ThemeName;
-  colorScheme?: ColorSchemeName;
-  color?: boolean;
-  locale?: Locale;
-  weekStart?: WeekStart;
-  highlight?: Date;
-  highlightStyle?: HighlightStyle;
-}
-
-export interface ParseResult {
-  args: CliArgs;
-  error?: string;
-  help?: boolean;
-}
-
-const THEMES: readonly ThemeName[] = ["default", "modern"];
-const COLOR_SCHEMES: readonly ColorSchemeName[] = [
-  "default",
-  "ocean",
-  "forest",
-  "sunset",
-  "mono",
-];
-const LOCALES: readonly Locale[] = ["en", "ja", "es", "de", "fr", "ko", "zh"];
-const WEEK_STARTS: readonly WeekStart[] = ["sunday", "monday"];
-const HIGHLIGHT_STYLES: readonly HighlightStyle[] = ["bracket", "reverse"];
-
-/** 値を一つ取るオプションと、代入先のフィールド名 */
-const VALUE_OPTIONS: Record<string, keyof CliArgs> = {
-  "--theme": "theme",
-  "--color-scheme": "colorScheme",
-  "--locale": "locale",
-  "--week-start": "weekStart",
-  "--highlight-style": "highlightStyle",
-};
-
-/** YYYY-MM-DD 形式の日付文字列をパースする */
-export function parseDate(value: string): Date | null {
-  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
-  if (!match) return null;
-  const year = Number(match[1]);
-  const month = Number(match[2]);
-  const day = Number(match[3]);
-  if (year < 1 || month < 1 || month > 12 || day < 1 || day > 31) {
-    return null;
-  }
-  const date = createDate(year, month - 1, day);
-  if (
-    date.getFullYear() !== year ||
-    date.getMonth() !== month - 1 ||
-    date.getDate() !== day
-  ) {
-    return null;
-  }
-  return date;
-}
-
-/**
- * CLI 引数をパースする。テスト可能なように副作用を分離している。
- */
-export function parseArgs(args: readonly string[]): ParseResult {
-  const result: CliArgs = {};
-  const error = (message: string): ParseResult => ({
-    args: result,
-    error: message,
-  });
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i]!;
-
-    if (arg === "-h" || arg === "--help") {
-      return { args: result, help: true };
-    }
-    if (arg === "--color") {
-      result.color = true;
-      continue;
-    }
-    if (arg === "--highlight") {
-      const value = args[++i];
-      if (value === undefined) {
-        return error("Missing value for option: --highlight");
-      }
-      const parsed = parseDate(value);
-      if (parsed === null) {
-        return error(
-          `Invalid --highlight date: "${value}" (expected YYYY-MM-DD, e.g. 2026-09-08)`,
-        );
-      }
-      result.highlight = parsed;
-      continue;
-    }
-
-    const key = VALUE_OPTIONS[arg];
-    if (key !== undefined) {
-      const value = args[++i];
-      if (value === undefined) {
-        return error(`Missing value for option: ${arg}`);
-      }
-      (result as Record<string, unknown>)[key] = value;
-      continue;
-    }
-
-    const numeric = /^-?\d+$/.test(arg);
-    if (arg.startsWith("-") && !numeric) {
-      return error(`Unknown option: ${arg}`);
-    }
-    if (!numeric) {
-      return error(
-        `Invalid argument: "${arg}" (expected a year or month number)`,
-      );
-    }
-    if (result.year === undefined) {
-      result.year = Number(arg);
-    } else if (result.month === undefined) {
-      result.month = Number(arg);
-    } else {
-      return error(`Too many arguments: "${arg}"`);
-    }
-  }
-
-  // 値のバリデーション
-  if (result.year !== undefined && (result.year < 1 || result.year > 9999)) {
-    return error(`Invalid year: ${result.year} (expected 1–9999)`);
-  }
-  if (result.month !== undefined && (result.month < 1 || result.month > 12)) {
-    return error(`Invalid month: ${result.month} (expected 1–12)`);
-  }
-
-  const choiceTable: Array<[string | undefined, readonly string[], string]> = [
-    [result.theme, THEMES, "theme"],
-    [result.colorScheme, COLOR_SCHEMES, "color-scheme"],
-    [result.locale, LOCALES, "locale"],
-    [result.weekStart, WEEK_STARTS, "week-start"],
-    [result.highlightStyle, HIGHLIGHT_STYLES, "highlight-style"],
-  ];
-  for (const [value, choices, name] of choiceTable) {
-    if (value !== undefined && !choices.includes(value)) {
-      return error(
-        `Invalid ${name}: "${value}" (expected: ${choices.join(" | ")})`,
-      );
-    }
-  }
-
-  return { args: result };
-}
-
-export function printUsage(): string {
-  return `Usage: typescript-calendar-lib [YYYY] [MM] [options]
-
-  typescript-calendar-lib                       Render the current month
-  typescript-calendar-lib 2026                  Render the current month of 2026
-  typescript-calendar-lib 2026 9                Render September 2026
-
-Options:
-  --theme <name>           Look: default | modern (default: default)
-  --color-scheme <name>    Colors: default | ocean | forest | sunset | mono
-  --color                  Enable ANSI colors
-  --locale <lang>          Language: en | ja | es | de | fr | ko | zh (default: en)
-  --week-start <day>       First weekday: sunday | monday (default: sunday)
-  --highlight <YYYY-MM-DD> Highlight a date (e.g. 2026-09-08)
-  --highlight-style <style> Highlight style: bracket | reverse (default: bracket)
-  -h, --help               Show this help
-`;
-}
-
-if (import.meta.main) {
-  const { args, error, help } = parseArgs(process.argv.slice(2));
-
-  if (help) {
-    console.log(printUsage());
-    process.exit(0);
-  }
-  if (error) {
-    console.error(`Error: ${error}`);
-    console.error(printUsage());
-    process.exit(1);
-  }
-
-  const now = new Date();
-  const year = args.year ?? now.getFullYear();
-  const month = args.month ?? now.getMonth() + 1;
-
-  console.log(
-    calendar({
-      year,
-      month,
-      theme: args.theme,
-      colorScheme: args.colorScheme,
-      color: args.color,
-      locale: args.locale,
-      weekStart: args.weekStart,
-      highlight: args.highlight,
-      highlightStyle: args.highlightStyle,
-    }),
-  );
-}

package/src/border.ts

@@ -1,55 +0,0 @@
-import type { FrameChars } from "./theme.ts";
-
-// ─── 枠線 ─────────────────────────────────────────────────
-
-/** 枠内のコンテンツ幅（例: 7列×3幅+区切り6 = 27） */
-export function innerWidth(cellWidth: number, cols: number): number {
-  return cols * cellWidth + (cols - 1);
-}
-
-/** セル幅の水平線を cols 個つなげた区切り線を生成する */
-function divider(
-  frame: FrameChars,
-  cellWidth: number,
-  cols: number,
-  left: string,
-  right: string,
-  join: string,
-): string {
-  const segments = Array<string>(cols).fill(frame.h.repeat(cellWidth));
-  return `${left}${segments.join(join)}${right}`;
-}
-
-/** 上枠: ┌────┬────...────┐ */
-export function topBorder(
-  frame: FrameChars,
-  cellWidth: number,
-  cols: number,
-): string {
-  return `${frame.topLeft}${frame.h.repeat(innerWidth(cellWidth, cols))}${frame.topRight}`;
-}
-
-/** 下枠: └────┴────...────┘ */
-export function bottomBorder(
-  frame: FrameChars,
-  cellWidth: number,
-  cols: number,
-): string {
-  return divider(
-    frame,
-    cellWidth,
-    cols,
-    frame.bottomLeft,
-    frame.bottomRight,
-    frame.footJ,
-  );
-}
-
-/** 区切り行: ├────┬────...┬────┤ */
-export function separatorRow(
-  frame: FrameChars,
-  cellWidth: number,
-  cols: number,
-): string {
-  return divider(frame, cellWidth, cols, "├", "┤", frame.j);
-}

package/src/calendar.ts

@@ -1,31 +0,0 @@
-import { getMonthRange } from "@typescript-calendar-lib/core";
-import { renderMonth, renderYear } from "./render.ts";
-import type {
-  CalendarOptions,
-  CalendarRangeOptions,
-  CalendarYearOptions,
-} from "./types.ts";
-
-/**
- * 月カレンダーをテキストで返す
- */
-export function calendar(options: CalendarOptions): string {
-  return renderMonth(options.year, options.month, options);
-}
-
-/**
- * 年間カレンダーを4列×3行でテキストで返す
- */
-export function calendarYear(options: CalendarYearOptions): string {
-  return renderYear(options.year, options);
-}
-
-/**
- * 任意の日付範囲のカレンダーをテキストで返す
- */
-export function calendarRange(options: CalendarRangeOptions): string {
-  const months = getMonthRange(options.from, options.to);
-  return months
-    .map(({ year, month }) => renderMonth(year, month, options))
-    .join("\n\n");
-}

package/src/index.ts

@@ -1,24 +0,0 @@
-export {
-  calendar,
-  calendarRange,
-  calendarYear,
-} from "./calendar.ts";
-export type {
-  CliPalette,
-  CliTheme,
-  ColorSchemeName,
-  FrameChars,
-  ThemeName,
-} from "./theme.ts";
-export {
-  COLOR_SCHEMES,
-  resolveColorScheme,
-  resolveTheme,
-  THEMES,
-} from "./theme.ts";
-export type {
-  CalendarOptions,
-  CalendarRangeOptions,
-  CalendarYearOptions,
-  RenderMonthOptions,
-} from "./types.ts";

package/src/month.ts

@@ -1,144 +0,0 @@
-import {
-  buildMonthGrid,
-  createDate,
-  getMonthName,
-  getWeekdayHeaders,
-  isDateInRange,
-  isSameDay,
-} from "@typescript-calendar-lib/core";
-import {
-  centerText,
-  centerTextFull,
-  displayWidth,
-  padStartWidth,
-} from "./align.ts";
-import { colorize } from "./ansi.ts";
-import { bottomBorder, innerWidth, separatorRow, topBorder } from "./border.ts";
-import { resolveColorScheme, resolveTheme } from "./theme.ts";
-import type { RenderMonthOptions } from "./types.ts";
-
-/**
- * 1ヶ月分のカレンダーテキストを描画する
- */
-export function renderMonth(
-  year: number,
-  month: number,
-  options: RenderMonthOptions = {},
-): string {
-  const {
-    locale = "en",
-    weekStart = "sunday",
-    highlight,
-    highlightStyle = "bracket",
-    range,
-    color = false,
-    theme: themeOption = "default",
-    colorScheme: schemeOption = "default",
-    today = new Date(),
-  } = options;
-
-  const theme = resolveTheme(themeOption);
-  const palette = resolveColorScheme(schemeOption);
-  const frame = theme.frame;
-
-  const title = `${getMonthName(locale, month)} ${year}`;
-  const weekdays = getWeekdayHeaders(locale, weekStart);
-  const grid = buildMonthGrid(year, month, weekStart);
-  const cols = weekdays.length;
-
-  // セル幅はテーマ指定を基本としつつ、以下を満たすように広げる:
-  // - 曜日ヘッダーの表示幅（fr の "dim." 等がセル幅を超えると列が崩れる）
-  // - bracket ハイライトは2桁の日付で `[10]` の4文字になるため
-  const cellWidth = Math.max(
-    theme.cellWidth,
-    ...weekdays.map(displayWidth),
-    highlight !== undefined && highlightStyle === "bracket" ? 4 : 2,
-  );
-
-  // 枠なしテーマは separator、枠ありテーマは縦線でセルを繋ぐ
-  const sep = frame === null ? theme.separator : frame.v;
-
-  /** 1セルを描画する（day は日数または null=空欄） */
-  const renderCell = (day: number | null): string => {
-    if (day === null) return " ".repeat(cellWidth);
-
-    const date = createDate(year, month - 1, day);
-    const isHighlight = highlight !== undefined && isSameDay(date, highlight);
-    const isInRange = isDateInRange(date, range);
-    const isToday = isSameDay(date, today);
-    const isWeekend = date.getDay() === 0 || date.getDay() === 6;
-
-    const text = (
-      isHighlight && highlightStyle === "bracket" ? `[${day}]` : String(day)
-    ).padStart(cellWidth);
-
-    let code: number | undefined;
-    if (isHighlight && highlightStyle === "reverse") {
-      code = palette.highlight ?? 7;
-    } else if (isInRange && !isHighlight) {
-      code = palette.range ?? 33;
-    } else if (isToday && palette.today !== undefined) {
-      code = palette.today;
-    } else if (isWeekend && palette.weekend !== undefined) {
-      code = palette.weekend;
-    } else if (palette.day !== undefined) {
-      code = palette.day;
-    }
-
-    return colorize(text, code, color);
-  };
-
-  const lines: string[] = [];
-
-  if (frame === null) {
-    // ── 枠なし（default） ──
-    const totalWidth = cols * cellWidth + (cols - 1) * sep.length;
-    lines.push(centerText(title, totalWidth));
-    lines.push(
-      weekdays
-        .map((d) =>
-          colorize(padStartWidth(d, cellWidth), palette.weekday, color),
-        )
-        .join(sep),
-    );
-  } else {
-    // ── 枠あり（modern） ──
-    lines.push(
-      colorize(topBorder(frame, cellWidth, cols), palette.frame, color),
-    );
-    lines.push(
-      colorize(
-        `${frame.v}${centerTextFull(title, innerWidth(cellWidth, cols))}${frame.v}`,
-        palette.title,
-        color,
-      ),
-    );
-    lines.push(
-      colorize(separatorRow(frame, cellWidth, cols), palette.frame, color),
-    );
-    lines.push(
-      colorize(
-        `${frame.v}${weekdays.map((d) => padStartWidth(d, cellWidth)).join(frame.v)}${frame.v}`,
-        palette.weekday,
-        color,
-      ),
-    );
-    lines.push(
-      colorize(separatorRow(frame, cellWidth, cols), palette.frame, color),
-    );
-  }
-
-  for (const row of grid) {
-    if (row.every((d) => d === null)) continue;
-    const cells = row.map(renderCell).join(sep);
-    lines.push(frame === null ? cells : `${frame.v}${cells}${frame.v}`);
-  }
-
-  if (frame !== null) {
-    lines.push(
-      colorize(bottomBorder(frame, cellWidth, cols), palette.frame, color),
-    );
-  }
-
-  return lines.join("\n");
-}

package/src/render.ts

@@ -1,5 +0,0 @@
-// レンダリングは責務ごとに ansi / align / border / month / year に分割されている。
-// このファイルは互換性のため公開 API を再エクスポートする。
-
-export { renderMonth } from "./month.ts";
-export { renderYear } from "./year.ts";

package/src/theme.ts

@@ -1,146 +0,0 @@
-// ─── テーマ ───────────────────────────────────────────────
-
-/** 組み込みテーマ名。カスタムテーマは CliTheme オブジェクトを直接渡せる */
-export type ThemeName = "default" | "modern";
-
-/** 枠線の文字セット（modern テーマで使用） */
-export interface FrameChars {
-  topLeft: string;
-  topRight: string;
-  bottomLeft: string;
-  bottomRight: string;
-  /** 水平線 */
-  h: string;
-  /** 垂直線 */
-  v: string;
-  /** ヘッダー/本文の区切り行で使う交差（┬ や ┼） */
-  j: string;
-  /** 下端区切りで使う交差（┴） */
-  footJ: string;
-}
-
-/** 文字ベースの見た目定義 */
-export interface CliTheme {
-  /** セル幅（日付表記の文字幅） */
-  cellWidth: number;
-  /** セル間の区切り文字（default: " " / modern: "│"） */
-  separator: string;
-  /** 枠線文字。null なら枠なし */
-  frame: FrameChars | null;
-}
-
-export const THEMES: Record<ThemeName, CliTheme> = {
-  default: {
-    cellWidth: 3,
-    separator: " ",
-    frame: null,
-  },
-  modern: {
-    cellWidth: 3,
-    separator: "│",
-    frame: {
-      topLeft: "┌",
-      topRight: "┐",
-      bottomLeft: "└",
-      bottomRight: "┘",
-      h: "─",
-      v: "│",
-      j: "┬",
-      footJ: "┴",
-    },
-  },
-};
-
-export function resolveTheme(theme?: ThemeName | CliTheme): CliTheme {
-  return typeof theme === "string"
-    ? (THEMES[theme] ?? THEMES.default)
-    : (theme ?? THEMES.default);
-}
-
-// ─── カラースキーム ───────────────────────────────────────
-
-/** 組み込みカラースキーム名。カスタムは CliPalette を直接渡せる */
-export type ColorSchemeName =
-  | "default"
-  | "ocean"
-  | "forest"
-  | "sunset"
-  | "mono";
-
-/**
- * ANSIカラーパレット。
- * 各フィールドは前景色（またはハイライト時の背景）のANSIコード。
- * undefined はその要素を着色しない。
- */
-export interface CliPalette {
-  title?: number;
-  weekday?: number;
-  day?: number;
-  weekend?: number;
-  today?: number;
-  /** highlightStyle: "reverse" のときに使うコード（default は 7 = 反転） */
-  highlight?: number;
-  range?: number;
-  frame?: number;
-  dim?: number;
-}
-
-export const COLOR_SCHEMES: Record<ColorSchemeName, CliPalette> = {
-  /** 従来どおり。着色は range(黄) と highlight(反転) のみ */
-  default: {
-    range: 33,
-    highlight: 7,
-  },
-  ocean: {
-    title: 36,
-    weekday: 36,
-    day: 37,
-    weekend: 34,
-    today: 36,
-    highlight: 7,
-    range: 34,
-    frame: 36,
-    dim: 90,
-  },
-  forest: {
-    title: 32,
-    weekday: 32,
-    day: 37,
-    weekend: 90,
-    today: 32,
-    highlight: 7,
-    range: 32,
-    frame: 32,
-    dim: 90,
-  },
-  sunset: {
-    title: 35,
-    weekday: 35,
-    day: 37,
-    weekend: 33,
-    today: 35,
-    highlight: 7,
-    range: 35,
-    frame: 35,
-    dim: 90,
-  },
-  mono: {
-    title: 37,
-    weekday: 37,
-    day: 37,
-    weekend: 90,
-    today: 37,
-    highlight: 7,
-    range: 90,
-    frame: 90,
-    dim: 90,
-  },
-};
-
-export function resolveColorScheme(
-  scheme?: ColorSchemeName | CliPalette,
-): CliPalette {
-  return typeof scheme === "string"
-    ? (COLOR_SCHEMES[scheme] ?? COLOR_SCHEMES.default)
-    : (scheme ?? COLOR_SCHEMES.default);
-}

package/src/types.ts

@@ -1,27 +0,0 @@
-import type {
-  CalendarOptions as CoreCalendarOptions,
-  CalendarRangeOptions as CoreCalendarRangeOptions,
-  CalendarYearOptions as CoreCalendarYearOptions,
-  RenderMonthOptions as CoreRenderMonthOptions,
-} from "@typescript-calendar-lib/core";
-import type {
-  CliPalette,
-  CliTheme,
-  ColorSchemeName,
-  ThemeName,
-} from "./theme.ts";
-
-/** CLI 固有のオプション（core のオプションに追加で受け付ける） */
-export interface CliExtraOptions {
-  /** 見た目テーマ。既定は "default" */
-  theme?: ThemeName | CliTheme;
-  /** カラースキーム。color: true のとき有効。既定は "default" */
-  colorScheme?: ColorSchemeName | CliPalette;
-  /** 今日の基準日。カラースキームの today 着色に使用 */
-  today?: Date;
-}
-
-export type CalendarOptions = CoreCalendarOptions & CliExtraOptions;
-export type CalendarYearOptions = CoreCalendarYearOptions & CliExtraOptions;
-export type CalendarRangeOptions = CoreCalendarRangeOptions & CliExtraOptions;
-export type RenderMonthOptions = CoreRenderMonthOptions & CliExtraOptions;

package/src/year.ts

@@ -1,48 +0,0 @@
-import { displayWidth } from "./align.ts";
-import { stripAnsi } from "./ansi.ts";
-import { renderMonth } from "./month.ts";
-import type { RenderMonthOptions } from "./types.ts";
-
-/**
- * 年間カレンダーを4列×3行でテキストで返す
- *
- * 列幅・パディングは「ANSI 除去後のターミナル表示幅」で計算する。
- * 全角文字（日本語・韓国語・中国語の月名や曜日）も正しく揃う。
- */
-export function renderYear(
-  year: number,
-  options: RenderMonthOptions = {},
-): string {
-  const widthOf = (line: string): number => displayWidth(stripAnsi(line));
-
-  const months = Array.from({ length: 12 }, (_, i) =>
-    renderMonth(year, i + 1, options).split("\n"),
-  );
-  const maxLines = Math.max(...months.map((lines) => lines.length));
-  const colWidths = months.map((lines) => Math.max(...lines.map(widthOf)));
-
-  /** 月の各行をその列幅まで右パディングする（行が足りなければ空行として埋める） */
-  const padMonth = (monthIdx: number): string[] =>
-    Array.from({ length: maxLines }, (_, li) => {
-      const line = months[monthIdx]![li] ?? "";
-      return (
-        line + " ".repeat(Math.max(0, colWidths[monthIdx]! - widthOf(line)))
-      );
-    });
-
-  const padded = months.map((_, mi) => padMonth(mi));
-
-  const rows: string[] = [];
-  for (let row = 0; row < 3; row++) {
-    rows.push(
-      Array.from({ length: maxLines }, (_, li) =>
-        Array.from({ length: 4 }, (_, col) => {
-          const monthIdx = row * 4 + col;
-          return monthIdx < 12 ? padded[monthIdx]![li]! : "";
-        }).join("    "),
-      ).join("\n"),
-    );
-  }
-
-  return rows.join("\n\n");
-}