@sanguo-dev/calendar-ui 0.0.0-stage → 0.0.3

package/dist/index.d.cts

@@ -0,0 +1,286 @@
+/**
+ * 语言包
+ *
+ * 只负责日历自身的界面文字；农历、节气、节日等业务文案由适配器提供。
+ */
+interface CalendarLocale {
+  /** 语言标签，例如 "zh-CN"，仅用于调试与覆盖 */
+  name: string;
+  /** 一周七天的短名，下标 0 为周日 */
+  weekdays: readonly string[];
+  /** 一周七天的全名，下标 0 为周日，用于 title 提示 */
+  weekdaysLong: readonly string[];
+  /** 头部年月标题 */
+  monthTitle(year: number, month: number): string;
+  /** 上个月按钮的无障碍名称 */
+  prevMonth: string;
+  /** 下个月按钮的无障碍名称 */
+  nextMonth: string;
+  /** 折叠按钮的无障碍名称；不传时使用内置文案 */
+  collapse?: string;
+  /** 展开按钮的无障碍名称；不传时使用内置文案 */
+  expand?: string;
+}
+/** 内置语言包的名称，可直接传给 CalendarOptions.locale */
+type CalendarLocaleName = "zh-CN" | "en-US";
+/** 一周从哪天开始：0 为周日，1 为周一 */
+type WeekStartsOn = 0 | 1;
+/** 主题：light / dark 显式指定，auto 跟随最近的 data-theme 或系统偏好 */
+type CalendarTheme = "light" | "dark" | "auto";
+/**
+ * 外部传入的日期
+ *
+ * 支持 Date，或本地日期字符串：
+ * `2026-10-01`、`2026-10-1`、`2026/10/01`、`2026/10/1`。
+ */
+type CalendarDateInput = Date | string;
+/** 选择模式：单选 / 范围 */
+type CalendarMode = "single" | "range";
+/** 范围选择结果，start/end 为 null 表示还没选完 */
+interface CalendarRange {
+  start: Date | null;
+  end: Date | null;
+}
+/** 自定义副标题：返回 null/undefined 时回退到 adapter 的 subtitle */
+type SubtitleRenderer = (day: CalendarDate) => string | null | undefined;
+/** 翻月滑动动画；传了 slide 就开启，不传就是直接切换 */
+interface SlideAnimationOptions {
+  /** 动画时长，单位 ms，默认 220 */
+  duration?: number;
+  /** 缓动函数，默认 "ease" */
+  easing?: string;
+}
+/** 折叠配置；传了 collapse 就显示底部折叠箭头并开启过渡 */
+interface CollapseAnimationOptions {
+  /** 折叠时长，单位 ms，默认 200 */
+  duration?: number;
+  /** 缓动函数，默认 "ease" */
+  easing?: string;
+  /** 初始是否折叠，默认 false（展开） */
+  defaultCollapsed?: boolean;
+}
+/** 动画配置；整块不传时不做任何动画，也不显示折叠箭头 */
+interface CalendarAnimationOptions {
+  /** 翻月滑动；`{}` 表示用默认时长和缓动 */
+  slide?: SlideAnimationOptions;
+  /** 折叠；`{}` 表示启用折叠并默认展开 */
+  collapse?: CollapseAnimationOptions;
+}
+/** 规范后的年月 */
+interface YearMonth {
+  year: number;
+  /** 1-12 */
+  month: number;
+}
+/** 日历格的公历日期部分 */
+interface CalendarDate {
+  /** 公历年 */
+  year: number;
+  /** 公历月，1-12 */
+  month: number;
+  /** 公历日 */
+  day: number;
+  /** 该格对应的日期对象（本地时区） */
+  date: Date;
+  /** 是否属于当前展示的月份（false 表示上一月/下一月的补位格） */
+  inCurrentMonth: boolean;
+}
+/** 格子左上角的小标记，例如「休」「班」 */
+interface CalendarBadge {
+  /** 显示文字 */
+  text: string;
+  /** 传给样式的 data-tone，核心不解释具体含义 */
+  tone?: string;
+}
+/** 适配器对单个格子的装饰 */
+interface DayDecoration<TData = unknown> {
+  /** 格子副标题，例如节气、节日、农历日 */
+  subtitle?: string;
+  /** 左上角小标记；不传则不显示 */
+  badge?: CalendarBadge;
+  /** 透传给 onSelect 的数据，核心不解释 */
+  data?: TData;
+  /** 覆盖默认 aria-label；不传时由日期、标记、副标题拼接 */
+  ariaLabel?: string;
+}
+/** 每次渲染月视图时传给适配器的上下文 */
+interface MonthInput {
+  /** 公历年 */
+  year: number;
+  /** 公历月，1-12 */
+  month: number;
+  /** 一周从哪天开始 */
+  weekStartsOn: WeekStartsOn;
+  /** 今天 */
+  today: Date;
+  /** 当前界面语言 */
+  locale: CalendarLocale;
+  /** 固定 42 个日期，包含上下月补位格 */
+  days: readonly CalendarDate[];
+}
+/**
+ * 日历适配器
+ *
+ * 核心只认识这个接口，不依赖任何具体的农历/节假日实现。
+ * 第三方可以实现它接入自己的日历数据。
+ */
+interface CalendarAdapter<TData = unknown> {
+  /** 适配器标识，用于调试和排查 */
+  readonly id: string;
+  /**
+   * 生成当前月的 42 个格子的装饰
+   *
+   * 返回数组按索引和 input.days 对齐；没有装饰的位置返回 null。
+   * 每次换月、选中、重新渲染都会调用，适配器应自行缓存重计算。
+   */
+  decorateMonth(input: MonthInput): ReadonlyArray<DayDecoration<TData> | null>;
+}
+/** 日历中的一格 */
+interface CalendarDay<TData = null> extends CalendarDate {
+  /** 是否今天 */
+  isToday: boolean;
+  /** 是否当前选中 */
+  isSelected: boolean;
+  /** 是否被 minDate / maxDate / disabledDates 禁止 */
+  isDisabled: boolean;
+  /** 是否范围起点 */
+  isRangeStart: boolean;
+  /** 是否范围终点 */
+  isRangeEnd: boolean;
+  /** 是否在已选范围内（含起终点） */
+  isInRange: boolean;
+  /** 格子副标题，例如节气、节日、农历日 */
+  subtitle: string;
+  /** 左上角小标记 */
+  badge: CalendarBadge | null;
+  /** 适配器透传的数据 */
+  data: TData | null;
+  /** 无障碍名称 */
+  ariaLabel: string;
+}
+/** 自定义头部能拿到的上下文 */
+interface HeaderRenderContext {
+  /** 当前展示的年 */
+  year: number;
+  /** 当前展示的月，1-12 */
+  month: number;
+  /** 当前语言包 */
+  locale: CalendarLocale;
+  /** 切到上个月 */
+  prevMonth(): void;
+  /** 切到下个月 */
+  nextMonth(): void;
+}
+/** 自定义头部渲染函数：返回要放进头部的元素，每次换月都会重新调用 */
+type HeaderRenderer = (context: HeaderRenderContext) => HTMLElement;
+/** 创建日历时的配置 */
+interface CalendarOptions<TData = null> {
+  /** 初始日期，默认今天；超出约束时夹到最近的可选日期 */
+  initialDate?: CalendarDateInput;
+  /** 最小可选日期（包含） */
+  minDate?: CalendarDateInput;
+  /** 最大可选日期（包含） */
+  maxDate?: CalendarDateInput;
+  /** 禁止选中的日期，按本地年月日比较 */
+  disabledDates?: readonly CalendarDateInput[];
+  /** 选择模式，默认 "single" */
+  mode?: CalendarMode;
+  /** 范围模式下显示的月数，默认 1；设为 2 时显示相邻两个月 */
+  months?: 1 | 2;
+  /** 范围变化时触发 */
+  onRangeChange?: (range: CalendarRange) => void;
+  /** 一周从哪天开始，默认 1（周一） */
+  weekStartsOn?: WeekStartsOn;
+  /** 界面语言：内置 "zh-CN"（默认）/ "en-US"，也可直接传自定义语言包 */
+  locale?: CalendarLocale | CalendarLocaleName;
+  /** 主题，默认 "auto"：跟随最近的 data-theme，没有则跟随系统 */
+  theme?: CalendarTheme;
+  /**
+   * 动画配置
+   *
+   * 不传时翻月直接切换、不显示折叠箭头。传了 `slide` 才开启滑动，
+   * 传了 `collapse` 才显示折叠箭头。
+   */
+  animation?: CalendarAnimationOptions;
+  /** 自定义副标题；优先于 adapter.subtitle，返回 null/undefined 时回退 */
+  subtitle?: SubtitleRenderer;
+  /** 是否显示头部，默认 true */
+  header?: boolean;
+  /** 自定义头部，替换默认的 ‹ 标题 › */
+  renderHeader?: HeaderRenderer;
+  /** 选中某一天时触发 */
+  onSelect?: (day: CalendarDay<TData>) => void;
+  /** 切换月份时触发 */
+  onMonthChange?: (year: number, month: number) => void;
+  /** 日历适配器；不传时就是纯公历 */
+  adapter?: CalendarAdapter<TData>;
+}
+/** 返回的实例 */
+interface CalendarInstance {
+  /** 日历根元素，方便外部定位或再挂样式 */
+  readonly el: HTMLElement;
+  /** 跳到某年某月 */
+  setMonth(year: number, month: number): void;
+  /** 当前展示的年月 */
+  getMonth(): YearMonth;
+  /** 切到上个月 */
+  prevMonth(): void;
+  /** 切到下个月 */
+  nextMonth(): void;
+  /** 选中某个日期 */
+  select(date: CalendarDateInput): void;
+  /** 当前已选范围；单选模式返回 { start: null, end: null } */
+  getRange(): CalendarRange;
+  /** 设置范围；start 为空时清空，end 省略表示只选了起点 */
+  setRange(start: CalendarDateInput | null, end?: CalendarDateInput | null): void;
+  /** 清空范围 */
+  clearRange(): void;
+  /** 当前选中的日期 */
+  getSelected(): Date | null;
+  /** 显示整个日历 */
+  show(): void;
+  /** 隐藏整个日历 */
+  hide(): void;
+  /** 切换整个日历的显示状态 */
+  toggle(): void;
+  /** 整个日历当前是否可见 */
+  isVisible(): boolean;
+  /** 显示头部 */
+  showHeader(): void;
+  /** 隐藏头部 */
+  hideHeader(): void;
+  /** 切换头部的显示状态 */
+  toggleHeader(): void;
+  /** 头部当前是否可见 */
+  isHeaderVisible(): boolean;
+  /** 当前最小可选日期，未设置时为 null */
+  getMinDate(): Date | null;
+  /** 设置最小可选日期，传 null 取消 */
+  setMinDate(date: CalendarDateInput | null): void;
+  /** 当前最大可选日期，未设置时为 null */
+  getMaxDate(): Date | null;
+  /** 设置最大可选日期，传 null 取消 */
+  setMaxDate(date: CalendarDateInput | null): void;
+  /** 当前主题 */
+  getTheme(): CalendarTheme;
+  /** 切换主题，只改 data-theme，不重建 DOM */
+  setTheme(theme: CalendarTheme): void;
+  /** 移除 DOM 与事件监听 */
+  destroy(): void;
+}
+/**
+ * 在容器里创建一个日历
+ *
+ * 只依赖 DOM，不依赖任何框架；重复调用 createCalendarUI 会各自独立。
+ * 不传 adapter 时就是纯公历，适配器负责提供副标题、标记和透传数据。
+ */
+export declare function createCalendarUI<TData = null>(container: HTMLElement, options?: CalendarOptions<TData>): CalendarInstance;
+/** 英文 */
+export declare const enUS: CalendarLocale;
+/** 简体中文：默认语言 */
+export declare const zhCN: CalendarLocale;
+/** 内置语言包，key 可直接传给 createCalendarUI 的 locale 选项 */
+export declare const locales: Record<CalendarLocaleName, CalendarLocale>;
+/** 把 "zh-CN" 这类名称或自定义语言包，统一解析成语言包对象 */
+export declare const resolveLocale: (locale?: CalendarLocale | CalendarLocaleName) => CalendarLocale;
+export type { CalendarAdapter, CalendarAnimationOptions, CalendarBadge, CalendarDate, CalendarDateInput, CalendarDay, CalendarInstance, CalendarLocale, CalendarLocaleName, CalendarMode, CalendarOptions, CalendarRange, CalendarTheme, CollapseAnimationOptions, DayDecoration, HeaderRenderContext, HeaderRenderer, MonthInput, SlideAnimationOptions, SubtitleRenderer, WeekStartsOn, YearMonth };

package/dist/index.d.mts

@@ -0,0 +1,286 @@
+/**
+ * 语言包
+ *
+ * 只负责日历自身的界面文字；农历、节气、节日等业务文案由适配器提供。
+ */
+interface CalendarLocale {
+  /** 语言标签，例如 "zh-CN"，仅用于调试与覆盖 */
+  name: string;
+  /** 一周七天的短名，下标 0 为周日 */
+  weekdays: readonly string[];
+  /** 一周七天的全名，下标 0 为周日，用于 title 提示 */
+  weekdaysLong: readonly string[];
+  /** 头部年月标题 */
+  monthTitle(year: number, month: number): string;
+  /** 上个月按钮的无障碍名称 */
+  prevMonth: string;
+  /** 下个月按钮的无障碍名称 */
+  nextMonth: string;
+  /** 折叠按钮的无障碍名称；不传时使用内置文案 */
+  collapse?: string;
+  /** 展开按钮的无障碍名称；不传时使用内置文案 */
+  expand?: string;
+}
+/** 内置语言包的名称，可直接传给 CalendarOptions.locale */
+type CalendarLocaleName = "zh-CN" | "en-US";
+/** 一周从哪天开始：0 为周日，1 为周一 */
+type WeekStartsOn = 0 | 1;
+/** 主题：light / dark 显式指定，auto 跟随最近的 data-theme 或系统偏好 */
+type CalendarTheme = "light" | "dark" | "auto";
+/**
+ * 外部传入的日期
+ *
+ * 支持 Date，或本地日期字符串：
+ * `2026-10-01`、`2026-10-1`、`2026/10/01`、`2026/10/1`。
+ */
+type CalendarDateInput = Date | string;
+/** 选择模式：单选 / 范围 */
+type CalendarMode = "single" | "range";
+/** 范围选择结果，start/end 为 null 表示还没选完 */
+interface CalendarRange {
+  start: Date | null;
+  end: Date | null;
+}
+/** 自定义副标题：返回 null/undefined 时回退到 adapter 的 subtitle */
+type SubtitleRenderer = (day: CalendarDate) => string | null | undefined;
+/** 翻月滑动动画；传了 slide 就开启，不传就是直接切换 */
+interface SlideAnimationOptions {
+  /** 动画时长，单位 ms，默认 220 */
+  duration?: number;
+  /** 缓动函数，默认 "ease" */
+  easing?: string;
+}
+/** 折叠配置；传了 collapse 就显示底部折叠箭头并开启过渡 */
+interface CollapseAnimationOptions {
+  /** 折叠时长，单位 ms，默认 200 */
+  duration?: number;
+  /** 缓动函数，默认 "ease" */
+  easing?: string;
+  /** 初始是否折叠，默认 false（展开） */
+  defaultCollapsed?: boolean;
+}
+/** 动画配置；整块不传时不做任何动画，也不显示折叠箭头 */
+interface CalendarAnimationOptions {
+  /** 翻月滑动；`{}` 表示用默认时长和缓动 */
+  slide?: SlideAnimationOptions;
+  /** 折叠；`{}` 表示启用折叠并默认展开 */
+  collapse?: CollapseAnimationOptions;
+}
+/** 规范后的年月 */
+interface YearMonth {
+  year: number;
+  /** 1-12 */
+  month: number;
+}
+/** 日历格的公历日期部分 */
+interface CalendarDate {
+  /** 公历年 */
+  year: number;
+  /** 公历月，1-12 */
+  month: number;
+  /** 公历日 */
+  day: number;
+  /** 该格对应的日期对象（本地时区） */
+  date: Date;
+  /** 是否属于当前展示的月份（false 表示上一月/下一月的补位格） */
+  inCurrentMonth: boolean;
+}
+/** 格子左上角的小标记，例如「休」「班」 */
+interface CalendarBadge {
+  /** 显示文字 */
+  text: string;
+  /** 传给样式的 data-tone，核心不解释具体含义 */
+  tone?: string;
+}
+/** 适配器对单个格子的装饰 */
+interface DayDecoration<TData = unknown> {
+  /** 格子副标题，例如节气、节日、农历日 */
+  subtitle?: string;
+  /** 左上角小标记；不传则不显示 */
+  badge?: CalendarBadge;
+  /** 透传给 onSelect 的数据，核心不解释 */
+  data?: TData;
+  /** 覆盖默认 aria-label；不传时由日期、标记、副标题拼接 */
+  ariaLabel?: string;
+}
+/** 每次渲染月视图时传给适配器的上下文 */
+interface MonthInput {
+  /** 公历年 */
+  year: number;
+  /** 公历月，1-12 */
+  month: number;
+  /** 一周从哪天开始 */
+  weekStartsOn: WeekStartsOn;
+  /** 今天 */
+  today: Date;
+  /** 当前界面语言 */
+  locale: CalendarLocale;
+  /** 固定 42 个日期，包含上下月补位格 */
+  days: readonly CalendarDate[];
+}
+/**
+ * 日历适配器
+ *
+ * 核心只认识这个接口，不依赖任何具体的农历/节假日实现。
+ * 第三方可以实现它接入自己的日历数据。
+ */
+interface CalendarAdapter<TData = unknown> {
+  /** 适配器标识，用于调试和排查 */
+  readonly id: string;
+  /**
+   * 生成当前月的 42 个格子的装饰
+   *
+   * 返回数组按索引和 input.days 对齐；没有装饰的位置返回 null。
+   * 每次换月、选中、重新渲染都会调用，适配器应自行缓存重计算。
+   */
+  decorateMonth(input: MonthInput): ReadonlyArray<DayDecoration<TData> | null>;
+}
+/** 日历中的一格 */
+interface CalendarDay<TData = null> extends CalendarDate {
+  /** 是否今天 */
+  isToday: boolean;
+  /** 是否当前选中 */
+  isSelected: boolean;
+  /** 是否被 minDate / maxDate / disabledDates 禁止 */
+  isDisabled: boolean;
+  /** 是否范围起点 */
+  isRangeStart: boolean;
+  /** 是否范围终点 */
+  isRangeEnd: boolean;
+  /** 是否在已选范围内（含起终点） */
+  isInRange: boolean;
+  /** 格子副标题，例如节气、节日、农历日 */
+  subtitle: string;
+  /** 左上角小标记 */
+  badge: CalendarBadge | null;
+  /** 适配器透传的数据 */
+  data: TData | null;
+  /** 无障碍名称 */
+  ariaLabel: string;
+}
+/** 自定义头部能拿到的上下文 */
+interface HeaderRenderContext {
+  /** 当前展示的年 */
+  year: number;
+  /** 当前展示的月，1-12 */
+  month: number;
+  /** 当前语言包 */
+  locale: CalendarLocale;
+  /** 切到上个月 */
+  prevMonth(): void;
+  /** 切到下个月 */
+  nextMonth(): void;
+}
+/** 自定义头部渲染函数：返回要放进头部的元素，每次换月都会重新调用 */
+type HeaderRenderer = (context: HeaderRenderContext) => HTMLElement;
+/** 创建日历时的配置 */
+interface CalendarOptions<TData = null> {
+  /** 初始日期，默认今天；超出约束时夹到最近的可选日期 */
+  initialDate?: CalendarDateInput;
+  /** 最小可选日期（包含） */
+  minDate?: CalendarDateInput;
+  /** 最大可选日期（包含） */
+  maxDate?: CalendarDateInput;
+  /** 禁止选中的日期，按本地年月日比较 */
+  disabledDates?: readonly CalendarDateInput[];
+  /** 选择模式，默认 "single" */
+  mode?: CalendarMode;
+  /** 范围模式下显示的月数，默认 1；设为 2 时显示相邻两个月 */
+  months?: 1 | 2;
+  /** 范围变化时触发 */
+  onRangeChange?: (range: CalendarRange) => void;
+  /** 一周从哪天开始，默认 1（周一） */
+  weekStartsOn?: WeekStartsOn;
+  /** 界面语言：内置 "zh-CN"（默认）/ "en-US"，也可直接传自定义语言包 */
+  locale?: CalendarLocale | CalendarLocaleName;
+  /** 主题，默认 "auto"：跟随最近的 data-theme，没有则跟随系统 */
+  theme?: CalendarTheme;
+  /**
+   * 动画配置
+   *
+   * 不传时翻月直接切换、不显示折叠箭头。传了 `slide` 才开启滑动，
+   * 传了 `collapse` 才显示折叠箭头。
+   */
+  animation?: CalendarAnimationOptions;
+  /** 自定义副标题；优先于 adapter.subtitle，返回 null/undefined 时回退 */
+  subtitle?: SubtitleRenderer;
+  /** 是否显示头部，默认 true */
+  header?: boolean;
+  /** 自定义头部，替换默认的 ‹ 标题 › */
+  renderHeader?: HeaderRenderer;
+  /** 选中某一天时触发 */
+  onSelect?: (day: CalendarDay<TData>) => void;
+  /** 切换月份时触发 */
+  onMonthChange?: (year: number, month: number) => void;
+  /** 日历适配器；不传时就是纯公历 */
+  adapter?: CalendarAdapter<TData>;
+}
+/** 返回的实例 */
+interface CalendarInstance {
+  /** 日历根元素，方便外部定位或再挂样式 */
+  readonly el: HTMLElement;
+  /** 跳到某年某月 */
+  setMonth(year: number, month: number): void;
+  /** 当前展示的年月 */
+  getMonth(): YearMonth;
+  /** 切到上个月 */
+  prevMonth(): void;
+  /** 切到下个月 */
+  nextMonth(): void;
+  /** 选中某个日期 */
+  select(date: CalendarDateInput): void;
+  /** 当前已选范围；单选模式返回 { start: null, end: null } */
+  getRange(): CalendarRange;
+  /** 设置范围；start 为空时清空，end 省略表示只选了起点 */
+  setRange(start: CalendarDateInput | null, end?: CalendarDateInput | null): void;
+  /** 清空范围 */
+  clearRange(): void;
+  /** 当前选中的日期 */
+  getSelected(): Date | null;
+  /** 显示整个日历 */
+  show(): void;
+  /** 隐藏整个日历 */
+  hide(): void;
+  /** 切换整个日历的显示状态 */
+  toggle(): void;
+  /** 整个日历当前是否可见 */
+  isVisible(): boolean;
+  /** 显示头部 */
+  showHeader(): void;
+  /** 隐藏头部 */
+  hideHeader(): void;
+  /** 切换头部的显示状态 */
+  toggleHeader(): void;
+  /** 头部当前是否可见 */
+  isHeaderVisible(): boolean;
+  /** 当前最小可选日期，未设置时为 null */
+  getMinDate(): Date | null;
+  /** 设置最小可选日期，传 null 取消 */
+  setMinDate(date: CalendarDateInput | null): void;
+  /** 当前最大可选日期，未设置时为 null */
+  getMaxDate(): Date | null;
+  /** 设置最大可选日期，传 null 取消 */
+  setMaxDate(date: CalendarDateInput | null): void;
+  /** 当前主题 */
+  getTheme(): CalendarTheme;
+  /** 切换主题，只改 data-theme，不重建 DOM */
+  setTheme(theme: CalendarTheme): void;
+  /** 移除 DOM 与事件监听 */
+  destroy(): void;
+}
+/**
+ * 在容器里创建一个日历
+ *
+ * 只依赖 DOM，不依赖任何框架；重复调用 createCalendarUI 会各自独立。
+ * 不传 adapter 时就是纯公历，适配器负责提供副标题、标记和透传数据。
+ */
+export declare function createCalendarUI<TData = null>(container: HTMLElement, options?: CalendarOptions<TData>): CalendarInstance;
+/** 英文 */
+export declare const enUS: CalendarLocale;
+/** 简体中文：默认语言 */
+export declare const zhCN: CalendarLocale;
+/** 内置语言包，key 可直接传给 createCalendarUI 的 locale 选项 */
+export declare const locales: Record<CalendarLocaleName, CalendarLocale>;
+/** 把 "zh-CN" 这类名称或自定义语言包，统一解析成语言包对象 */
+export declare const resolveLocale: (locale?: CalendarLocale | CalendarLocaleName) => CalendarLocale;
+export type { CalendarAdapter, CalendarAnimationOptions, CalendarBadge, CalendarDate, CalendarDateInput, CalendarDay, CalendarInstance, CalendarLocale, CalendarLocaleName, CalendarMode, CalendarOptions, CalendarRange, CalendarTheme, CollapseAnimationOptions, DayDecoration, HeaderRenderContext, HeaderRenderer, MonthInput, SlideAnimationOptions, SubtitleRenderer, WeekStartsOn, YearMonth };