@cahyo-dimas/freeday 1.34.0 → 1.36.0

package/CHANGELOG.md

@@ -3,6 +3,43 @@
 Semua perubahan penting dicatat di sini. Format longgar mengikuti
 [Keep a Changelog](https://keepachangelog.com/); tiap versi = git tag.
 
+## [1.36.0] — 2026-08-19
+One note from the back-office app (IDU_EMATE_APPL_WEB, #013).
+### Added
+- **A year grid in the calendar** (vanilla · Vue · React · Blazor). 1.32.0's month grid killed
+  one-click-per-month and left one-click-per-year behind it: the month grid's arrows step a year
+  each, so 2026 → 1998 was **28 clicks**. The title now drills twice — days → months → years — with
+  the arrows following the level shown, and picking a year drops to that year's months. Every level
+  above the day grid stays **navigation**: nothing is committed until a day is picked. Year pages
+  are aligned (2016–2027, 2028–2039) rather than centred on the year in view, so the pages tile
+  instead of sliding over each other. New classes `.fdy-cal__grid--years` / `.fdy-cal__year`; new
+  aria-label props `chooseYearLabel`, `prevYearsLabel`, `nextYearsLabel`.
+### Changed
+- **The month grid's title now drills UP to years rather than back down to days.** Getting back to
+  days is what picking a month already does. Nothing in the kit's own tests or in a consuming app's
+  helpers clicked the title from the month grid, so this is not expected to be breaking.
+### Fixed
+- **`freeday-datepicker.js` spoke Indonesian to the user.** Its placeholder and every nav
+  `aria-label` were Indonesian, and because `FdyDatepicker.razor` delegates to the vanilla
+  enhancer, **every Blazor app inherited them** — while #009's language guard, which scans
+  `adapters/` only, passed. The datepicker is English now. The rest of `src/` is NOT audited: see
+  improvement note #013 §2, which lists the enhancers still affected.
+
+## [1.35.0] — 2026-08-19
+One note from the back-office app (IDU_EMATE_APPL_WEB, #012).
+### Added
+- **`.fdy-table--sticky` + `.fdy-table-scroll--frozen`** — a table frozen on one axis or both, for
+  a grid read against two axes at once (a rate matrix, a timetable). This is a kit class rather
+  than four lines in an app because `position:sticky` on its own produces a **visibly broken**
+  table: `.fdy-table` collapses its borders, a collapsed border is painted by the table rather than
+  by either cell, and so a frozen cell scrolls out from under its own rule — the frozen column
+  arrives with nothing separating it from the data. The modifier separates the borders and puts
+  each one back on the cell that sticks. `<thead>` freezes at the top, `<th scope="row">` at the
+  left, the first header cell is the corner, and the row header paints the **body** surface so a
+  hovered row stays one band across the freeze line. `.fdy-table-scroll--frozen` is the scrollport
+  the freeze resolves against (the base `.fdy-table-scroll` scrolls one axis, so `top:0` never
+  engages); size it with `--fdy-table-frozen-h`, default `30rem`.
+
 ## [1.34.0] — 2026-08-19
 One note from the back-office app (IDU_EMATE_APPL_WEB, #008), and the second half of #005 it
 finally makes answerable.

package/COMPONENTS.md

@@ -516,20 +516,27 @@ Input-styled trigger + calendar popover. Needs `freeday-datepicker.js`. **Author
 — the enhancer builds everything.
 
 - `.fdy-datepicker` (+`--error`) · `__trigger` `__value` (+`--placeholder`) `__icon` `__clear`
-  `__panel`; calendar internals `.fdy-cal__head` `__nav` `__title` `__grid` (+`--months`) `__dow`
-  `__day` `__month`
+  `__panel`; calendar internals `.fdy-cal__head` `__nav` `__title` `__grid` (+`--months` `--years`)
+  `__dow` `__day` `__month` `__year`
 - Range: wrap two pickers in `.fdy-daterange` + `data-fdy-daterange` (`role="group"`), children
   get `data-role="from"` / `"to"`; separator `.fdy-daterange__sep`. The end can't precede the start.
   **Typed wrapper: `<FdyDateRange>`** (Vue/React/Blazor) — use it in those stacks.
-**Getting to a distant month.** The title is a **button**: press it and the day grid becomes a
-12-cell month grid (`.fdy-cal__grid--months` of `.fdy-cal__month`) for the current year, where the
-arrows step **years** instead of months. Pick a
-month and you are back on days — choosing a month is navigation, so nothing is committed until a day
-is selected. From August 2026 to March 2022 that is 7 clicks; walking month by month is 53.
+**Getting to a distant date.** The title is a **button**, and it drills up one level each press:
+day grid → 12-cell month grid (`.fdy-cal__grid--months` of `.fdy-cal__month`) → 12-cell year grid
+(`.fdy-cal__grid--years` of `.fdy-cal__year`). The arrows follow the level shown — months, then
+years, then pages of twelve years. Picking a year drops to that year's months, picking a month
+drops to its days: every level above the day grid is **navigation**, so nothing is committed until a
+day is selected. From the year grid the title steps back down to months.
+
+Year pages are **aligned**, not centred on the year in view — 2016–2027, then 2028–2039 — so the
+pages tile and a given year always sits in the same place. From August 2026 to March 2022 that is 7
+clicks; walking month by month is 53. To 1998 it is 8; walking is 336.
 
 Keyboard, in the day grid: arrows move a day, `Home`/`End` the week, `PageUp`/`PageDown` a month,
 and **`Shift`+`PageUp`/`PageDown` a year** (WAI-ARIA APG). The month grid mirrors it: arrows ±1/±3
-months, `Home`/`End` January/December, `PageUp`/`PageDown` a year, `Enter`/`Space` to choose.
+months, `Home`/`End` January/December, `PageUp`/`PageDown` a year, `Enter`/`Space` to choose. The
+year grid likewise: arrows ±1/±3 years, `Home`/`End` the ends of the page, `PageUp`/`PageDown` a
+page of twelve.
 
 - Attributes: `data-value="YYYY-MM-DD"`, `data-placeholder`, `data-label`, `data-fdy-no-icon`
 
@@ -687,6 +694,26 @@ Semantic static table. Wrap in `.fdy-table-wrap` (bordered surface) or `.fdy-tab
 </div>
 ```
 
+**Frozen axes — `.fdy-table--sticky`.** For a grid read against two axes at once (a rate
+matrix, a timetable). Put `.fdy-table-scroll--frozen` on the wrapper — it scrolls both ways
+and is the scrollport the frozen cells stick to — and size it with `--fdy-table-frozen-h`
+(default `30rem`). `<thead>` freezes at the top, `<th scope="row">` freezes at the left, and
+the first header cell is the corner. Do not reach for `position:sticky` directly: the base
+table collapses its borders, and a collapsed border belongs to the table rather than the
+cell, so it scrolls out from under whatever you froze.
+
+```html
+<div class="fdy-table-scroll fdy-table-scroll--frozen" style="--fdy-table-frozen-h:26rem">
+  <table class="fdy-table fdy-table--sticky">
+    <caption class="fdy-visually-hidden">Exchange rates, August 2026</caption>
+    <thead><tr><th scope="col">Date</th><th scope="col" class="fdy-table__num">USD</th></tr></thead>
+    <tbody>
+      <tr><th scope="row">1 Aug</th><td class="fdy-table__num">16,240</td></tr>
+    </tbody>
+  </table>
+</div>
+```
+
 ## Data table — `.fdy-datatable`
 > **Typed wrapper: `<FdyTable>`** — controlled: `columns` + `rows`, with sort/filter/page events (`update:pageIndex` · `onPageIndexChange` · `PageIndexChanged`) and `process` for driving a card list off the same processed set. The markup below is the raw enhancer path.
 

package/adapters/react/components/FdyDatepicker.tsx

@@ -21,6 +21,14 @@ interface DayCell {
   focusable: boolean;
 }
 
+interface YearCell {
+  year: number;
+  selected: boolean;
+  today: boolean;
+  disabled: boolean;
+  focusable: boolean;
+}
+
 interface MonthCell {
   index: number;
   label: string;
@@ -53,6 +61,11 @@ export interface FdyDatepickerProps {
   /** aria-labels for the year arrows shown in the month grid. Defaults 'Previous year' / 'Next year'. */
   prevYearLabel?: string;
   nextYearLabel?: string;
+  /** aria-label for the title button that drills from the month grid to the year grid. Default 'Choose year'. */
+  chooseYearLabel?: string;
+  /** aria-labels for the page arrows shown in the year grid. Defaults 'Previous years' / 'Next years'. */
+  prevYearsLabel?: string;
+  nextYearsLabel?: string;
   prevMonthLabel?: string;
   /** aria-label for the next-month nav button. Default 'Next month'. */
   nextMonthLabel?: string;
@@ -121,10 +134,19 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
   const [open, setOpen] = useState<boolean>(false);
   /* 'days' | 'months' — the calendar drills one level up instead of growing furniture beside the
      title. Before this the only pointer route to another month was one click per month. */
-  const [mode, setMode] = useState<'days' | 'months'>('days');
+  const [mode, setMode] = useState<'days' | 'months' | 'years'>('days');
   const [focusMonth, setFocusMonth] = useState<number>(0);
+  const [focusYear, setFocusYear] = useState<number>(0);
+
+  /* A page of twelve years, ALIGNED so pages tile: 2016-2027, 2028-2039. Anchoring on the year in
+     view would make the arrows land on overlapping windows, and the same year would sit somewhere
+     different every step. */
+  const YEARS_PER_PAGE = 12;
+  const yearPageStart = (year: number): number => Math.floor(year / YEARS_PER_PAGE) * YEARS_PER_PAGE;
   const monthRefs = useRef<Record<number, HTMLButtonElement | null>>({});
   const pendingMonthFocusRef = useRef<number | null>(null);
+  const yearRefs = useRef<Record<number, HTMLButtonElement | null>>({});
+  const pendingYearFocusRef = useRef<number | null>(null);
 
   // Render the calendar panel in the top layer (popover) so it never gets clipped by a card or
   // scroll container; positions against the trigger.
@@ -146,6 +168,9 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
   const chooseMonthLabelText: string = props.chooseMonthLabel ?? 'Choose month';
   const prevYearLabelText: string = props.prevYearLabel ?? 'Previous year';
   const nextYearLabelText: string = props.nextYearLabel ?? 'Next year';
+  const chooseYearLabelText: string = props.chooseYearLabel ?? 'Choose year';
+  const prevYearsLabelText: string = props.prevYearsLabel ?? 'Previous years';
+  const nextYearsLabelText: string = props.nextYearsLabel ?? 'Next years';
   const monthCellFmt: Intl.DateTimeFormat = useMemo(
     (): Intl.DateTimeFormat => new Intl.DateTimeFormat(props.locale, { month: 'short' }),
     [props.locale],
@@ -271,6 +296,13 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
     monthRefs.current[index]?.focus();
   });
 
+  useEffect((): void => {
+    if (pendingYearFocusRef.current === null) return;
+    const year: number = pendingYearFocusRef.current;
+    pendingYearFocusRef.current = null;
+    yearRefs.current[year]?.focus();
+  });
+
   function openMonthGrid(): void {
     setFocusMonth(viewMonth.getMonth());
     setMode('months');
@@ -296,6 +328,73 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
     pendingMonthFocusRef.current = next;
   }
 
+  /** A year is unreachable only when EVERY month in it falls outside min/max. */
+  function isYearDisabled(year: number): boolean {
+    if (minDate !== null && startOfDay(new Date(year, 11, 31)).getTime() < startOfDay(minDate).getTime()) return true;
+    if (maxDate !== null && startOfDay(new Date(year, 0, 1)).getTime() > startOfDay(maxDate).getTime()) return true;
+    return false;
+  }
+
+  const yearPage: number = yearPageStart(focusYear);
+  const yearRangeLabel: string = `${yearPage} – ${yearPage + YEARS_PER_PAGE - 1}`;
+
+  const yearCells: YearCell[] = useMemo((): YearCell[] => {
+    const start: number = yearPageStart(focusYear);
+    const thisYear: number = new Date().getFullYear();
+    const sel: Date | null = parseISO(props.value);
+    return Array.from({ length: YEARS_PER_PAGE }, (_unused: unknown, index: number): YearCell => {
+      const year: number = start + index;
+      return {
+        year,
+        selected: sel !== null && sel.getFullYear() === year,
+        today: thisYear === year,
+        disabled: isYearDisabled(year),
+        focusable: year === focusYear,
+      };
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [focusYear, props.value, minDate, maxDate]);
+
+  function openYearGrid(): void {
+    setFocusYear(viewMonth.getFullYear());
+    setMode('years');
+    pendingYearFocusRef.current = viewMonth.getFullYear();
+  }
+
+  /* Picking a year is NAVIGATION, exactly like picking a month: it drops to that year's month grid
+     and commits nothing. */
+  function openYear(year: number): void {
+    setViewMonth(new Date(year, viewMonth.getMonth(), 1));
+    setFocusMonth(viewMonth.getMonth());
+    setMode('months');
+    pendingMonthFocusRef.current = viewMonth.getMonth();
+  }
+
+  function moveYearFocus(year: number): void {
+    setFocusYear(year);
+    setViewMonth(new Date(year, viewMonth.getMonth(), 1));
+    pendingYearFocusRef.current = year;
+  }
+
+  function onYearKeydown(e: React.KeyboardEvent): void {
+    let handled: boolean = true;
+    switch (e.key) {
+      case 'ArrowLeft': moveYearFocus(focusYear - 1); break;
+      case 'ArrowRight': moveYearFocus(focusYear + 1); break;
+      case 'ArrowUp': moveYearFocus(focusYear - 3); break;
+      case 'ArrowDown': moveYearFocus(focusYear + 3); break;
+      case 'Home': moveYearFocus(yearPageStart(focusYear)); break;
+      case 'End': moveYearFocus(yearPageStart(focusYear) + YEARS_PER_PAGE - 1); break;
+      case 'PageUp': moveYearFocus(focusYear - YEARS_PER_PAGE); break;
+      case 'PageDown': moveYearFocus(focusYear + YEARS_PER_PAGE); break;
+      case 'Enter':
+      case ' ': openYear(focusYear); break;
+      case 'Escape': closePanel(true); break;
+      default: handled = false;
+    }
+    if (handled) { e.preventDefault(); e.stopPropagation(); }
+  }
+
   function onMonthKeydown(e: React.KeyboardEvent): void {
     let handled: boolean = true;
     switch (e.key) {
@@ -476,8 +575,12 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
           <button
             type="button"
             className="fdy-cal__nav"
-            aria-label={mode === 'months' ? prevYearLabelText : prevMonthLabelText}
-            onClick={(): void => { if (mode === 'months') moveMonthFocus(focusMonth, -1); else setViewMonth(addMonths(viewMonth, -1)); }}
+            aria-label={mode === 'years' ? prevYearsLabelText : mode === 'months' ? prevYearLabelText : prevMonthLabelText}
+            onClick={(): void => {
+              if (mode === 'years') moveYearFocus(focusYear - YEARS_PER_PAGE);
+              else if (mode === 'months') moveMonthFocus(focusMonth, -1);
+              else setViewMonth(addMonths(viewMonth, -1));
+            }}
           >
             &lsaquo;
           </button>
@@ -485,21 +588,44 @@ export function FdyDatepicker(props: FdyDatepickerProps): JSX.Element {
             id={titleId}
             type="button"
             className="fdy-cal__title"
-            aria-label={mode === 'months' ? undefined : chooseMonthLabelText}
-            onClick={(): void => { if (mode === 'months') setMode('days'); else openMonthGrid(); }}
+            aria-label={mode === 'years' ? undefined : mode === 'months' ? chooseYearLabelText : chooseMonthLabelText}
+            onClick={(): void => { if (mode === 'months') openYearGrid(); else openMonthGrid(); }}
           >
-            {mode === 'months' ? String(viewMonth.getFullYear()) : monthFmt.format(viewMonth)}
+            {mode === 'years' ? yearRangeLabel : mode === 'months' ? String(viewMonth.getFullYear()) : monthFmt.format(viewMonth)}
           </button>
           <button
             type="button"
             className="fdy-cal__nav"
-            aria-label={mode === 'months' ? nextYearLabelText : nextMonthLabelText}
-            onClick={(): void => { if (mode === 'months') moveMonthFocus(focusMonth, 1); else setViewMonth(addMonths(viewMonth, 1)); }}
+            aria-label={mode === 'years' ? nextYearsLabelText : mode === 'months' ? nextYearLabelText : nextMonthLabelText}
+            onClick={(): void => {
+              if (mode === 'years') moveYearFocus(focusYear + YEARS_PER_PAGE);
+              else if (mode === 'months') moveMonthFocus(focusMonth, 1);
+              else setViewMonth(addMonths(viewMonth, 1));
+            }}
           >
             &rsaquo;
           </button>
         </div>
-        {mode === 'months' ? (
+        {mode === 'years' ? (
+          <div className="fdy-cal__grid fdy-cal__grid--years" role="grid" aria-labelledby={titleId} onKeyDown={onYearKeydown}>
+            {yearCells.map((cell: YearCell) => (
+              <button
+                key={cell.year}
+                ref={(el: HTMLButtonElement | null): void => { yearRefs.current[cell.year] = el; }}
+                type="button"
+                className={['fdy-cal__year', cell.today ? 'is-today' : '', cell.selected ? 'is-selected' : ''].filter(Boolean).join(' ')}
+                role="gridcell"
+                aria-label={String(cell.year)}
+                aria-selected={cell.selected ? true : undefined}
+                disabled={cell.disabled}
+                tabIndex={cell.focusable ? 0 : -1}
+                onClick={(): void => openYear(cell.year)}
+              >
+                {cell.year}
+              </button>
+            ))}
+          </div>
+        ) : mode === 'months' ? (
           <div className="fdy-cal__grid fdy-cal__grid--months" role="grid" aria-labelledby={titleId} onKeyDown={onMonthKeydown}>
             {monthCells.map((cell: MonthCell) => (
               <button

package/adapters/vue/components/FdyDatepicker.vue

@@ -50,6 +50,11 @@ const props = defineProps<{
   /** aria-labels for the year arrows shown in the month grid. Defaults 'Previous year' / 'Next year'. */
   prevYearLabel?: string;
   nextYearLabel?: string;
+  /** aria-label for the title button that drills from the month grid to the year grid. Default 'Choose year'. */
+  chooseYearLabel?: string;
+  /** aria-labels for the page arrows shown in the year grid. Defaults 'Previous years' / 'Next years'. */
+  prevYearsLabel?: string;
+  nextYearsLabel?: string;
 }>();
 
 const emit = defineEmits<{
@@ -124,6 +129,9 @@ const clearLabelText: ComputedRef<string> = computed((): string => props.clearLa
 const chooseMonthLabelText: ComputedRef<string> = computed((): string => props.chooseMonthLabel ?? 'Choose month');
 const prevYearLabelText: ComputedRef<string> = computed((): string => props.prevYearLabel ?? 'Previous year');
 const nextYearLabelText: ComputedRef<string> = computed((): string => props.nextYearLabel ?? 'Next year');
+const chooseYearLabelText: ComputedRef<string> = computed((): string => props.chooseYearLabel ?? 'Choose year');
+const prevYearsLabelText: ComputedRef<string> = computed((): string => props.prevYearsLabel ?? 'Previous years');
+const nextYearsLabelText: ComputedRef<string> = computed((): string => props.nextYearsLabel ?? 'Next years');
 
 const view: Ref<Date> = ref(startOfMonth(selectedDate.value ?? new Date()));
 const focusDate: Ref<Date> = ref(selectedDate.value ?? new Date());
@@ -140,8 +148,15 @@ const effectiveFocusDate: ComputedRef<Date> = computed((): Date => {
 /* 'days' | 'months' — the calendar drills one level up instead of growing furniture beside the title.
    Before this the only pointer route to another month was one click per month: August 2026 to March
    2022 is fifty-three of them, and the Shift+PageUp jump had no affordance at all. */
-const mode: Ref<'days' | 'months'> = ref('days');
+const mode: Ref<'days' | 'months' | 'years'> = ref('days');
 const focusMonth: Ref<number> = ref(0);
+const focusYear: Ref<number> = ref(0);
+
+/* A page of twelve years, ALIGNED so pages tile: 2016-2027, 2028-2039. Anchoring the page on the
+   year in view would make the arrows land on overlapping windows, and the same year would sit at a
+   different spot every time you stepped. */
+const YEARS_PER_PAGE = 12;
+const yearPageStart = (year: number): number => Math.floor(year / YEARS_PER_PAGE) * YEARS_PER_PAGE;
 
 const monthCellFmt: ComputedRef<Intl.DateTimeFormat> = computed(
   (): Intl.DateTimeFormat => new Intl.DateTimeFormat(props.locale, { month: 'short' }),
@@ -189,6 +204,44 @@ const monthCells: ComputedRef<MonthCell[]> = computed((): MonthCell[] => {
   });
 });
 
+interface YearCell {
+  year: number;
+  selected: boolean;
+  today: boolean;
+  disabled: boolean;
+  focusable: boolean;
+}
+
+/** A year is unreachable only when EVERY month in it falls outside min/max — the same rule
+ *  isMonthDisabled applies one level down, and for the same reason. */
+function isYearDisabled(year: number): boolean {
+  if (minDate.value !== null && startOfDay(new Date(year, 11, 31)).getTime() < startOfDay(minDate.value).getTime()) return true;
+  if (maxDate.value !== null && startOfDay(new Date(year, 0, 1)).getTime() > startOfDay(maxDate.value).getTime()) return true;
+  return false;
+}
+
+const yearPage: ComputedRef<number> = computed((): number => yearPageStart(focusYear.value));
+
+const yearCells: ComputedRef<YearCell[]> = computed((): YearCell[] => {
+  const start: number = yearPage.value;
+  const thisYear: number = new Date().getFullYear();
+  const sel: Date | null = selectedDate.value;
+  return Array.from({ length: YEARS_PER_PAGE }, (_unused: unknown, index: number): YearCell => {
+    const year: number = start + index;
+    return {
+      year,
+      selected: sel !== null && sel.getFullYear() === year,
+      today: thisYear === year,
+      disabled: isYearDisabled(year),
+      focusable: year === focusYear.value,
+    };
+  });
+});
+
+const yearRangeLabel: ComputedRef<string> = computed(
+  (): string => `${yearPage.value} – ${yearPage.value + YEARS_PER_PAGE - 1}`,
+);
+
 const monthFmt: ComputedRef<Intl.DateTimeFormat> = computed(
   (): Intl.DateTimeFormat => new Intl.DateTimeFormat(props.locale, { month: 'long', year: 'numeric' }),
 );
@@ -278,6 +331,51 @@ function openMonth(index: number): void {
   void nextTick((): void => focusCell());
 }
 
+function openYearGrid(): void {
+  focusYear.value = view.value.getFullYear();
+  mode.value = 'years';
+  void nextTick((): void => focusYearCell());
+}
+
+function focusYearCell(): void {
+  const cell: HTMLElement | null = panelEl.value?.querySelector('.fdy-cal__year[tabindex="0"]') ?? null;
+  cell?.focus();
+}
+
+/* Picking a year is NAVIGATION, exactly like picking a month: it drops to that year's month grid
+   and commits nothing. */
+function openYear(year: number): void {
+  view.value = new Date(year, view.value.getMonth(), 1);
+  focusMonth.value = view.value.getMonth();
+  mode.value = 'months';
+  void nextTick((): void => focusMonthCell());
+}
+
+function moveYearFocus(year: number): void {
+  focusYear.value = year;
+  view.value = new Date(year, view.value.getMonth(), 1);
+  void nextTick((): void => focusYearCell());
+}
+
+function onYearKeydown(e: KeyboardEvent): void {
+  let handled: boolean = true;
+  switch (e.key) {
+    case 'ArrowLeft': moveYearFocus(focusYear.value - 1); break;
+    case 'ArrowRight': moveYearFocus(focusYear.value + 1); break;
+    case 'ArrowUp': moveYearFocus(focusYear.value - 3); break;
+    case 'ArrowDown': moveYearFocus(focusYear.value + 3); break;
+    case 'Home': moveYearFocus(yearPageStart(focusYear.value)); break;
+    case 'End': moveYearFocus(yearPageStart(focusYear.value) + YEARS_PER_PAGE - 1); break;
+    case 'PageUp': moveYearFocus(focusYear.value - YEARS_PER_PAGE); break;
+    case 'PageDown': moveYearFocus(focusYear.value + YEARS_PER_PAGE); break;
+    case 'Enter':
+    case ' ': openYear(focusYear.value); break;
+    case 'Escape': closePanel(true); break;
+    default: handled = false;
+  }
+  if (handled) { e.preventDefault(); e.stopPropagation(); }
+}
+
 function moveMonthFocus(index: number, yearDelta: number): void {
   if (yearDelta !== 0) view.value = addMonths(view.value, yearDelta * 12);
   focusMonth.value = (index + 12) % 12;
@@ -465,24 +563,51 @@ onBeforeUnmount((): void => {
         <button
           type="button"
           class="fdy-cal__nav"
-          :aria-label="mode === 'months' ? prevYearLabelText : prevMonthLabelText"
-          @click="mode === 'months' ? moveMonthFocus(focusMonth, -1) : (view = addMonths(view, -1))"
+          :aria-label="mode === 'years' ? prevYearsLabelText : mode === 'months' ? prevYearLabelText : prevMonthLabelText"
+          @click="
+            mode === 'years'
+              ? moveYearFocus(focusYear - 12)
+              : mode === 'months'
+                ? moveMonthFocus(focusMonth, -1)
+                : (view = addMonths(view, -1))
+          "
         >‹</button>
         <button
           :id="titleId"
           type="button"
           class="fdy-cal__title"
-          :aria-label="mode === 'months' ? undefined : chooseMonthLabelText"
-          @click="mode === 'months' ? (mode = 'days') : openMonthGrid()"
-        >{{ mode === 'months' ? String(view.getFullYear()) : monthFmt.format(view) }}</button>
+          :aria-label="mode === 'years' ? undefined : mode === 'months' ? chooseYearLabelText : chooseMonthLabelText"
+          @click="mode === 'months' ? openYearGrid() : openMonthGrid()"
+        >{{ mode === 'years' ? yearRangeLabel : mode === 'months' ? String(view.getFullYear()) : monthFmt.format(view) }}</button>
         <button
           type="button"
           class="fdy-cal__nav"
-          :aria-label="mode === 'months' ? nextYearLabelText : nextMonthLabelText"
-          @click="mode === 'months' ? moveMonthFocus(focusMonth, 1) : (view = addMonths(view, 1))"
+          :aria-label="mode === 'years' ? nextYearsLabelText : mode === 'months' ? nextYearLabelText : nextMonthLabelText"
+          @click="
+            mode === 'years'
+              ? moveYearFocus(focusYear + 12)
+              : mode === 'months'
+                ? moveMonthFocus(focusMonth, 1)
+                : (view = addMonths(view, 1))
+          "
         >›</button>
       </div>
-      <div v-if="mode === 'months'" class="fdy-cal__grid fdy-cal__grid--months" role="grid" :aria-labelledby="titleId" @keydown="onMonthKeydown">
+      <div v-if="mode === 'years'" class="fdy-cal__grid fdy-cal__grid--years" role="grid" :aria-labelledby="titleId" @keydown="onYearKeydown">
+        <button
+          v-for="cell in yearCells"
+          :key="cell.year"
+          type="button"
+          class="fdy-cal__year"
+          :class="{ 'is-today': cell.today, 'is-selected': cell.selected }"
+          role="gridcell"
+          :aria-label="String(cell.year)"
+          :aria-selected="cell.selected ? 'true' : undefined"
+          :disabled="cell.disabled"
+          :tabindex="cell.focusable ? 0 : -1"
+          @click="openYear(cell.year)"
+        >{{ cell.year }}</button>
+      </div>
+      <div v-else-if="mode === 'months'" class="fdy-cal__grid fdy-cal__grid--months" role="grid" :aria-labelledby="titleId" @keydown="onMonthKeydown">
         <button
           v-for="cell in monthCells"
           :key="cell.index"

package/dist/freeday-datepicker.js

@@ -57,8 +57,8 @@
     wrap.dataset.fdyDpReady = '1';
     wrap.classList.add('fdy-datepicker');
 
-    var placeholder = wrap.getAttribute('data-placeholder') || 'Pilih tanggal';
-    var label = wrap.getAttribute('data-label') || 'Tanggal';
+    var placeholder = wrap.getAttribute('data-placeholder') || 'Choose a date';
+    var label = wrap.getAttribute('data-label') || 'Date';
     var selected = parseISO(wrap.getAttribute('data-value'));
     var minDate = parseISO(wrap.getAttribute('data-min'));
     var maxDate = parseISO(wrap.getAttribute('data-max'));
@@ -73,6 +73,7 @@
        month" twenty-four times to reach a date two years back. */
     var mode = 'days';
     var focusMonth = null;
+    var focusYear = null;
 
     var trigger = document.createElement('button');
     trigger.type = 'button';
@@ -150,20 +151,21 @@
     }
 
     function render() {
+      if (mode === 'years') { renderYears(); return; }
       if (mode === 'months') { renderMonths(); return; }
       panel.innerHTML = '';
       var head = document.createElement('div');
       head.className = 'fdy-cal__head';
-      var title = titleButton(monthFmt.format(view), monthFmt.format(view) + ', pilih bulan', function () {
+      var title = titleButton(monthFmt.format(view), monthFmt.format(view) + ', choose month', function () {
         mode = 'months';
         focusMonth = view.getMonth();
         render();
         focusMonthCell();
       });
       panel.setAttribute('aria-labelledby', title.id);
-      head.appendChild(navButton('‹', 'Bulan sebelumnya', function () { view = addMonths(view, -1); render(); }));
+      head.appendChild(navButton('‹', 'Previous month', function () { view = addMonths(view, -1); render(); }));
       head.appendChild(title);
-      head.appendChild(navButton('›', 'Bulan berikutnya', function () { view = addMonths(view, 1); render(); }));
+      head.appendChild(navButton('›', 'Next month', function () { view = addMonths(view, 1); render(); }));
       panel.appendChild(head);
 
       var grid = document.createElement('div');
@@ -220,15 +222,16 @@
       var year = view.getFullYear();
       var head = document.createElement('div');
       head.className = 'fdy-cal__head';
-      var title = titleButton(String(year), year + ', kembali ke tanggal', function () {
-        mode = 'days';
+      var title = titleButton(String(year), year + ', choose year', function () {
+        mode = 'years';
+        focusYear = year;
         render();
-        focusFocusDate();
+        focusYearCell();
       });
       panel.setAttribute('aria-labelledby', title.id);
-      head.appendChild(navButton('‹', 'Tahun sebelumnya', function () { view = addMonths(view, -12); render(); focusMonthCell(); }));
+      head.appendChild(navButton('‹', 'Previous year', function () { view = addMonths(view, -12); render(); focusMonthCell(); }));
       head.appendChild(title);
-      head.appendChild(navButton('›', 'Tahun berikutnya', function () { view = addMonths(view, 12); render(); focusMonthCell(); }));
+      head.appendChild(navButton('›', 'Next year', function () { view = addMonths(view, 12); render(); focusMonthCell(); }));
       panel.appendChild(head);
 
       var grid = document.createElement('div');
@@ -259,6 +262,108 @@
       panel.appendChild(grid);
     }
 
+    /* A page of twelve years, aligned so pages TILE: 2016-2027, 2028-2039. Anchoring the page on
+       the year in view instead would make ‹ and › land on overlapping windows, and the same year
+       would appear at a different spot every time you stepped. */
+    var YEARS_PER_PAGE = 12;
+    function yearPageStart(y) { return Math.floor(y / YEARS_PER_PAGE) * YEARS_PER_PAGE; }
+
+    /* A year is only unreachable when EVERY month in it falls outside min/max — the same rule
+       monthDisabled applies one level down, for the same reason: a bound that sits inside the year
+       disables neither end. */
+    function yearDisabled(y) {
+      if (minDate && new Date(y, 11, 31) < startOfDay(minDate)) return true;
+      if (maxDate && new Date(y, 0, 1) > startOfDay(maxDate)) return true;
+      return false;
+    }
+
+    function renderYears() {
+      panel.innerHTML = '';
+      var start = yearPageStart(view.getFullYear());
+      var end = start + YEARS_PER_PAGE - 1;
+      var head = document.createElement('div');
+      head.className = 'fdy-cal__head';
+      var title = titleButton(start + ' – ' + end, start + ' to ' + end + ', back to months', function () {
+        mode = 'months';
+        focusMonth = view.getMonth();
+        render();
+        focusMonthCell();
+      });
+      panel.setAttribute('aria-labelledby', title.id);
+      head.appendChild(navButton('‹', 'Previous years', function () { moveYearFocus(focusYear - YEARS_PER_PAGE); }));
+      head.appendChild(title);
+      head.appendChild(navButton('›', 'Next years', function () { moveYearFocus(focusYear + YEARS_PER_PAGE); }));
+      panel.appendChild(head);
+
+      var grid = document.createElement('div');
+      grid.className = 'fdy-cal__grid fdy-cal__grid--years';
+      grid.setAttribute('role', 'grid');
+      grid.setAttribute('aria-labelledby', title.id);
+      var thisYear = new Date().getFullYear();
+      if (focusYear === null) focusYear = view.getFullYear();
+      for (var i = 0; i < YEARS_PER_PAGE; i++) {
+        var y = start + i;
+        var btn = document.createElement('button');
+        btn.type = 'button';
+        btn.className = 'fdy-cal__year';
+        btn.setAttribute('role', 'gridcell');
+        btn.setAttribute('aria-label', String(y));
+        btn.textContent = String(y);
+        if (y === thisYear) btn.classList.add('is-today');
+        if (selected && selected.getFullYear() === y) {
+          btn.classList.add('is-selected');
+          btn.setAttribute('aria-selected', 'true');
+        }
+        if (yearDisabled(y)) btn.disabled = true;
+        btn.tabIndex = y === focusYear ? 0 : -1;
+        btn.addEventListener('click', (function (yy) { return function () { openYear(yy); }; })(y));
+        grid.appendChild(btn);
+      }
+      grid.addEventListener('keydown', onYearKey);
+      panel.appendChild(grid);
+    }
+
+    function focusYearCell() {
+      var cell = panel.querySelector('.fdy-cal__year[tabindex="0"]');
+      if (cell) cell.focus();
+    }
+
+    /* Picking a year is navigation, exactly like picking a month: it drops to the month grid of
+       that year. Nothing is committed until a DAY is chosen. */
+    function openYear(y) {
+      view = new Date(y, view.getMonth(), 1);
+      focusMonth = view.getMonth();
+      mode = 'months';
+      render();
+      focusMonthCell();
+    }
+
+    function moveYearFocus(y) {
+      focusYear = y;
+      view = new Date(y, view.getMonth(), 1);
+      render();
+      focusYearCell();
+    }
+
+    function onYearKey(e) {
+      var handled = true;
+      switch (e.key) {
+        case 'ArrowLeft': moveYearFocus(focusYear - 1); break;
+        case 'ArrowRight': moveYearFocus(focusYear + 1); break;
+        case 'ArrowUp': moveYearFocus(focusYear - 3); break;
+        case 'ArrowDown': moveYearFocus(focusYear + 3); break;
+        case 'Home': moveYearFocus(yearPageStart(focusYear)); break;
+        case 'End': moveYearFocus(yearPageStart(focusYear) + YEARS_PER_PAGE - 1); break;
+        case 'PageUp': moveYearFocus(focusYear - YEARS_PER_PAGE); break;
+        case 'PageDown': moveYearFocus(focusYear + YEARS_PER_PAGE); break;
+        case 'Enter':
+        case ' ': openYear(focusYear); break;
+        case 'Escape': close(true); break;
+        default: handled = false;
+      }
+      if (handled) { e.preventDefault(); e.stopPropagation(); }
+    }
+
     function focusMonthCell() {
       var cell = panel.querySelector('.fdy-cal__month[tabindex="0"]');
       if (cell) cell.focus();

package/dist/freeday.bundle.css

@@ -1145,12 +1145,12 @@ a { color: var(--color-primary); }
 .fdy-cal__title{flex:1;appearance:none;border:0;background:transparent;margin:0;padding:var(--space-1) var(--space-2);border-radius:var(--radius-sm);text-align:center;font-family:inherit;font-weight:var(--weight-semibold);font-size:var(--text-sm);color:var(--color-text);text-transform:capitalize;cursor:pointer;}
 .fdy-cal__title:hover{background:var(--color-surface-2);}
 .fdy-cal__title:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
-.fdy-cal__month:hover{background:var(--color-surface-2);}
-.fdy-cal__month:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
-.fdy-cal__month.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
-.fdy-cal__month.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
+.fdy-cal__month,.fdy-cal__year{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
+.fdy-cal__month:hover,.fdy-cal__year:hover{background:var(--color-surface-2);}
+.fdy-cal__month:focus-visible,.fdy-cal__year:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
+.fdy-cal__month:disabled,.fdy-cal__year:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
+.fdy-cal__month.is-today,.fdy-cal__year.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
+.fdy-cal__month.is-selected,.fdy-cal__year.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
 .fdy-cal__nav{display:inline-flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;flex:none;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text-muted);font-size:var(--text-lg);line-height:1;cursor:pointer;}
 .fdy-cal__nav:hover{background:var(--color-surface-2);color:var(--color-text);}
 .fdy-cal__nav:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
@@ -1161,7 +1161,7 @@ a { color: var(--color-primary); }
    AFTER `.fdy-cal__grid`, and that is the whole rule: the element carries both classes, they weigh
    the same, so source order decides. Declared earlier, the modifier lost to the base it modifies and
    twelve months rendered seven across — the layout the comment above described, never once applied. */
-.fdy-cal__grid--months{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
+.fdy-cal__grid--months,.fdy-cal__grid--years{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
 .fdy-cal__dow{display:flex;align-items:center;justify-content:center;height:1.75rem;font-size:var(--text-xs);font-weight:var(--weight-semibold);color:var(--color-text-muted);text-transform:capitalize;}
 .fdy-cal__day{display:inline-flex;align-items:center;justify-content:center;width:2rem;height:2rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-size:var(--text-sm);font-variant-numeric:tabular-nums;cursor:pointer;}
 .fdy-cal__day:hover{background:var(--color-surface-2);}
@@ -1657,6 +1657,30 @@ fieldset.fdy-field>legend{padding:0;float:none;margin-bottom:var(--space-2);}
 .fdy-table__selcol{width:1px;white-space:nowrap;}
 .fdy-table tbody tr[aria-selected="true"],.fdy-table tbody tr[aria-selected="true"]:hover{background:var(--color-primary-soft);}
 
+/* Frozen header row and/or first column — a rate matrix, a timetable, any grid read
+   against two axes at once.
+
+   This modifier exists because `position:sticky` alone is NOT enough. With
+   `border-collapse:collapse` the shared border belongs to the TABLE, not to either
+   cell, so a frozen cell scrolls out from under its own rule and the frozen column
+   loses the line that separates it from the data. Separate borders put each border
+   back on the cell that sticks. */
+.fdy-table--sticky{border-collapse:separate;border-spacing:0;}
+.fdy-table--sticky th,.fdy-table--sticky td{border-bottom:var(--bw) solid var(--color-border-muted);}
+.fdy-table--sticky thead th{position:sticky;top:0;z-index:2;border-bottom:var(--bw) solid var(--color-border);}
+/* The row header freezes sideways over the data cells, so it needs an opaque
+   background of its own — and it takes the BODY surface, not the header one, so a
+   hovered row stays one continuous band across the freeze line. Losing that is
+   losing the only way to track a row across a wide grid. */
+.fdy-table--sticky tbody th{position:sticky;left:0;z-index:1;background:var(--color-surface);border-right:var(--bw) solid var(--color-border);}
+.fdy-table--sticky tbody tr:hover th{background:var(--color-surface-2);}
+/* The corner cell is frozen on both axes, so it has to outrank both. */
+.fdy-table--sticky thead th:first-child{left:0;z-index:3;border-right:var(--bw) solid var(--color-border);}
+
+/* The scrollport a sticky cell sticks to. Both axes scroll here, and the height is a
+   custom property so a page can size it without out-specifying this rule. */
+.fdy-table-scroll--frozen{position:relative;overflow:auto;max-height:var(--fdy-table-frozen-h,30rem);}
+
 /* Data-table shell (toolbar + scroll + footer stay put while the table scrolls) */
 .fdy-datatable{border:var(--bw) solid var(--color-border);border-radius:var(--radius-lg);box-shadow:var(--shadow-1);background:var(--color-surface);overflow:hidden;}
 .fdy-table-scroll{position:relative;overflow-x:auto;}

package/dist/freeday.css

@@ -762,12 +762,12 @@ a { color: var(--color-primary); }
 .fdy-cal__title{flex:1;appearance:none;border:0;background:transparent;margin:0;padding:var(--space-1) var(--space-2);border-radius:var(--radius-sm);text-align:center;font-family:inherit;font-weight:var(--weight-semibold);font-size:var(--text-sm);color:var(--color-text);text-transform:capitalize;cursor:pointer;}
 .fdy-cal__title:hover{background:var(--color-surface-2);}
 .fdy-cal__title:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
-.fdy-cal__month:hover{background:var(--color-surface-2);}
-.fdy-cal__month:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
-.fdy-cal__month.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
-.fdy-cal__month.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
+.fdy-cal__month,.fdy-cal__year{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
+.fdy-cal__month:hover,.fdy-cal__year:hover{background:var(--color-surface-2);}
+.fdy-cal__month:focus-visible,.fdy-cal__year:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
+.fdy-cal__month:disabled,.fdy-cal__year:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
+.fdy-cal__month.is-today,.fdy-cal__year.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
+.fdy-cal__month.is-selected,.fdy-cal__year.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
 .fdy-cal__nav{display:inline-flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;flex:none;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text-muted);font-size:var(--text-lg);line-height:1;cursor:pointer;}
 .fdy-cal__nav:hover{background:var(--color-surface-2);color:var(--color-text);}
 .fdy-cal__nav:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
@@ -778,7 +778,7 @@ a { color: var(--color-primary); }
    AFTER `.fdy-cal__grid`, and that is the whole rule: the element carries both classes, they weigh
    the same, so source order decides. Declared earlier, the modifier lost to the base it modifies and
    twelve months rendered seven across — the layout the comment above described, never once applied. */
-.fdy-cal__grid--months{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
+.fdy-cal__grid--months,.fdy-cal__grid--years{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
 .fdy-cal__dow{display:flex;align-items:center;justify-content:center;height:1.75rem;font-size:var(--text-xs);font-weight:var(--weight-semibold);color:var(--color-text-muted);text-transform:capitalize;}
 .fdy-cal__day{display:inline-flex;align-items:center;justify-content:center;width:2rem;height:2rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-size:var(--text-sm);font-variant-numeric:tabular-nums;cursor:pointer;}
 .fdy-cal__day:hover{background:var(--color-surface-2);}
@@ -1274,6 +1274,30 @@ fieldset.fdy-field>legend{padding:0;float:none;margin-bottom:var(--space-2);}
 .fdy-table__selcol{width:1px;white-space:nowrap;}
 .fdy-table tbody tr[aria-selected="true"],.fdy-table tbody tr[aria-selected="true"]:hover{background:var(--color-primary-soft);}
 
+/* Frozen header row and/or first column — a rate matrix, a timetable, any grid read
+   against two axes at once.
+
+   This modifier exists because `position:sticky` alone is NOT enough. With
+   `border-collapse:collapse` the shared border belongs to the TABLE, not to either
+   cell, so a frozen cell scrolls out from under its own rule and the frozen column
+   loses the line that separates it from the data. Separate borders put each border
+   back on the cell that sticks. */
+.fdy-table--sticky{border-collapse:separate;border-spacing:0;}
+.fdy-table--sticky th,.fdy-table--sticky td{border-bottom:var(--bw) solid var(--color-border-muted);}
+.fdy-table--sticky thead th{position:sticky;top:0;z-index:2;border-bottom:var(--bw) solid var(--color-border);}
+/* The row header freezes sideways over the data cells, so it needs an opaque
+   background of its own — and it takes the BODY surface, not the header one, so a
+   hovered row stays one continuous band across the freeze line. Losing that is
+   losing the only way to track a row across a wide grid. */
+.fdy-table--sticky tbody th{position:sticky;left:0;z-index:1;background:var(--color-surface);border-right:var(--bw) solid var(--color-border);}
+.fdy-table--sticky tbody tr:hover th{background:var(--color-surface-2);}
+/* The corner cell is frozen on both axes, so it has to outrank both. */
+.fdy-table--sticky thead th:first-child{left:0;z-index:3;border-right:var(--bw) solid var(--color-border);}
+
+/* The scrollport a sticky cell sticks to. Both axes scroll here, and the height is a
+   custom property so a page can size it without out-specifying this rule. */
+.fdy-table-scroll--frozen{position:relative;overflow:auto;max-height:var(--fdy-table-frozen-h,30rem);}
+
 /* Data-table shell (toolbar + scroll + footer stay put while the table scrolls) */
 .fdy-datatable{border:var(--bw) solid var(--color-border);border-radius:var(--radius-lg);box-shadow:var(--shadow-1);background:var(--color-surface);overflow:hidden;}
 .fdy-table-scroll{position:relative;overflow-x:auto;}

package/dist/freeday.js

@@ -1364,8 +1364,8 @@
     wrap.dataset.fdyDpReady = '1';
     wrap.classList.add('fdy-datepicker');
 
-    var placeholder = wrap.getAttribute('data-placeholder') || 'Pilih tanggal';
-    var label = wrap.getAttribute('data-label') || 'Tanggal';
+    var placeholder = wrap.getAttribute('data-placeholder') || 'Choose a date';
+    var label = wrap.getAttribute('data-label') || 'Date';
     var selected = parseISO(wrap.getAttribute('data-value'));
     var minDate = parseISO(wrap.getAttribute('data-min'));
     var maxDate = parseISO(wrap.getAttribute('data-max'));
@@ -1380,6 +1380,7 @@
        month" twenty-four times to reach a date two years back. */
     var mode = 'days';
     var focusMonth = null;
+    var focusYear = null;
 
     var trigger = document.createElement('button');
     trigger.type = 'button';
@@ -1457,20 +1458,21 @@
     }
 
     function render() {
+      if (mode === 'years') { renderYears(); return; }
       if (mode === 'months') { renderMonths(); return; }
       panel.innerHTML = '';
       var head = document.createElement('div');
       head.className = 'fdy-cal__head';
-      var title = titleButton(monthFmt.format(view), monthFmt.format(view) + ', pilih bulan', function () {
+      var title = titleButton(monthFmt.format(view), monthFmt.format(view) + ', choose month', function () {
         mode = 'months';
         focusMonth = view.getMonth();
         render();
         focusMonthCell();
       });
       panel.setAttribute('aria-labelledby', title.id);
-      head.appendChild(navButton('‹', 'Bulan sebelumnya', function () { view = addMonths(view, -1); render(); }));
+      head.appendChild(navButton('‹', 'Previous month', function () { view = addMonths(view, -1); render(); }));
       head.appendChild(title);
-      head.appendChild(navButton('›', 'Bulan berikutnya', function () { view = addMonths(view, 1); render(); }));
+      head.appendChild(navButton('›', 'Next month', function () { view = addMonths(view, 1); render(); }));
       panel.appendChild(head);
 
       var grid = document.createElement('div');
@@ -1527,15 +1529,16 @@
       var year = view.getFullYear();
       var head = document.createElement('div');
       head.className = 'fdy-cal__head';
-      var title = titleButton(String(year), year + ', kembali ke tanggal', function () {
-        mode = 'days';
+      var title = titleButton(String(year), year + ', choose year', function () {
+        mode = 'years';
+        focusYear = year;
         render();
-        focusFocusDate();
+        focusYearCell();
       });
       panel.setAttribute('aria-labelledby', title.id);
-      head.appendChild(navButton('‹', 'Tahun sebelumnya', function () { view = addMonths(view, -12); render(); focusMonthCell(); }));
+      head.appendChild(navButton('‹', 'Previous year', function () { view = addMonths(view, -12); render(); focusMonthCell(); }));
       head.appendChild(title);
-      head.appendChild(navButton('›', 'Tahun berikutnya', function () { view = addMonths(view, 12); render(); focusMonthCell(); }));
+      head.appendChild(navButton('›', 'Next year', function () { view = addMonths(view, 12); render(); focusMonthCell(); }));
       panel.appendChild(head);
 
       var grid = document.createElement('div');
@@ -1566,6 +1569,108 @@
       panel.appendChild(grid);
     }
 
+    /* A page of twelve years, aligned so pages TILE: 2016-2027, 2028-2039. Anchoring the page on
+       the year in view instead would make ‹ and › land on overlapping windows, and the same year
+       would appear at a different spot every time you stepped. */
+    var YEARS_PER_PAGE = 12;
+    function yearPageStart(y) { return Math.floor(y / YEARS_PER_PAGE) * YEARS_PER_PAGE; }
+
+    /* A year is only unreachable when EVERY month in it falls outside min/max — the same rule
+       monthDisabled applies one level down, for the same reason: a bound that sits inside the year
+       disables neither end. */
+    function yearDisabled(y) {
+      if (minDate && new Date(y, 11, 31) < startOfDay(minDate)) return true;
+      if (maxDate && new Date(y, 0, 1) > startOfDay(maxDate)) return true;
+      return false;
+    }
+
+    function renderYears() {
+      panel.innerHTML = '';
+      var start = yearPageStart(view.getFullYear());
+      var end = start + YEARS_PER_PAGE - 1;
+      var head = document.createElement('div');
+      head.className = 'fdy-cal__head';
+      var title = titleButton(start + ' – ' + end, start + ' to ' + end + ', back to months', function () {
+        mode = 'months';
+        focusMonth = view.getMonth();
+        render();
+        focusMonthCell();
+      });
+      panel.setAttribute('aria-labelledby', title.id);
+      head.appendChild(navButton('‹', 'Previous years', function () { moveYearFocus(focusYear - YEARS_PER_PAGE); }));
+      head.appendChild(title);
+      head.appendChild(navButton('›', 'Next years', function () { moveYearFocus(focusYear + YEARS_PER_PAGE); }));
+      panel.appendChild(head);
+
+      var grid = document.createElement('div');
+      grid.className = 'fdy-cal__grid fdy-cal__grid--years';
+      grid.setAttribute('role', 'grid');
+      grid.setAttribute('aria-labelledby', title.id);
+      var thisYear = new Date().getFullYear();
+      if (focusYear === null) focusYear = view.getFullYear();
+      for (var i = 0; i < YEARS_PER_PAGE; i++) {
+        var y = start + i;
+        var btn = document.createElement('button');
+        btn.type = 'button';
+        btn.className = 'fdy-cal__year';
+        btn.setAttribute('role', 'gridcell');
+        btn.setAttribute('aria-label', String(y));
+        btn.textContent = String(y);
+        if (y === thisYear) btn.classList.add('is-today');
+        if (selected && selected.getFullYear() === y) {
+          btn.classList.add('is-selected');
+          btn.setAttribute('aria-selected', 'true');
+        }
+        if (yearDisabled(y)) btn.disabled = true;
+        btn.tabIndex = y === focusYear ? 0 : -1;
+        btn.addEventListener('click', (function (yy) { return function () { openYear(yy); }; })(y));
+        grid.appendChild(btn);
+      }
+      grid.addEventListener('keydown', onYearKey);
+      panel.appendChild(grid);
+    }
+
+    function focusYearCell() {
+      var cell = panel.querySelector('.fdy-cal__year[tabindex="0"]');
+      if (cell) cell.focus();
+    }
+
+    /* Picking a year is navigation, exactly like picking a month: it drops to the month grid of
+       that year. Nothing is committed until a DAY is chosen. */
+    function openYear(y) {
+      view = new Date(y, view.getMonth(), 1);
+      focusMonth = view.getMonth();
+      mode = 'months';
+      render();
+      focusMonthCell();
+    }
+
+    function moveYearFocus(y) {
+      focusYear = y;
+      view = new Date(y, view.getMonth(), 1);
+      render();
+      focusYearCell();
+    }
+
+    function onYearKey(e) {
+      var handled = true;
+      switch (e.key) {
+        case 'ArrowLeft': moveYearFocus(focusYear - 1); break;
+        case 'ArrowRight': moveYearFocus(focusYear + 1); break;
+        case 'ArrowUp': moveYearFocus(focusYear - 3); break;
+        case 'ArrowDown': moveYearFocus(focusYear + 3); break;
+        case 'Home': moveYearFocus(yearPageStart(focusYear)); break;
+        case 'End': moveYearFocus(yearPageStart(focusYear) + YEARS_PER_PAGE - 1); break;
+        case 'PageUp': moveYearFocus(focusYear - YEARS_PER_PAGE); break;
+        case 'PageDown': moveYearFocus(focusYear + YEARS_PER_PAGE); break;
+        case 'Enter':
+        case ' ': openYear(focusYear); break;
+        case 'Escape': close(true); break;
+        default: handled = false;
+      }
+      if (handled) { e.preventDefault(); e.stopPropagation(); }
+    }
+
     function focusMonthCell() {
       var cell = panel.querySelector('.fdy-cal__month[tabindex="0"]');
       if (cell) cell.focus();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cahyo-dimas/freeday",
-  "version": "1.34.0",
+  "version": "1.36.0",
   "description": "Freeday — token-driven, framework-agnostic UI KIT (design source-of-truth).",
   "type": "module",
   "license": "MIT",

package/src/components/datepicker.css

@@ -34,12 +34,12 @@
 .fdy-cal__title{flex:1;appearance:none;border:0;background:transparent;margin:0;padding:var(--space-1) var(--space-2);border-radius:var(--radius-sm);text-align:center;font-family:inherit;font-weight:var(--weight-semibold);font-size:var(--text-sm);color:var(--color-text);text-transform:capitalize;cursor:pointer;}
 .fdy-cal__title:hover{background:var(--color-surface-2);}
 .fdy-cal__title:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
-.fdy-cal__month:hover{background:var(--color-surface-2);}
-.fdy-cal__month:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
-.fdy-cal__month:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
-.fdy-cal__month.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
-.fdy-cal__month.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
+.fdy-cal__month,.fdy-cal__year{display:inline-flex;align-items:center;justify-content:center;height:2.25rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-family:inherit;font-size:var(--text-sm);text-transform:capitalize;cursor:pointer;}
+.fdy-cal__month:hover,.fdy-cal__year:hover{background:var(--color-surface-2);}
+.fdy-cal__month:focus-visible,.fdy-cal__year:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
+.fdy-cal__month:disabled,.fdy-cal__year:disabled{opacity:.4;cursor:not-allowed;background:transparent;}
+.fdy-cal__month.is-today,.fdy-cal__year.is-today{font-weight:var(--weight-bold);box-shadow:inset 0 0 0 1.5px var(--color-border-strong);}
+.fdy-cal__month.is-selected,.fdy-cal__year.is-selected{background:var(--color-primary);color:var(--color-on-primary);font-weight:var(--weight-semibold);}
 .fdy-cal__nav{display:inline-flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;flex:none;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text-muted);font-size:var(--text-lg);line-height:1;cursor:pointer;}
 .fdy-cal__nav:hover{background:var(--color-surface-2);color:var(--color-text);}
 .fdy-cal__nav:focus-visible{outline:none;box-shadow:0 0 0 3px color-mix(in srgb,var(--color-primary) 26%,transparent);}
@@ -50,7 +50,7 @@
    AFTER `.fdy-cal__grid`, and that is the whole rule: the element carries both classes, they weigh
    the same, so source order decides. Declared earlier, the modifier lost to the base it modifies and
    twelve months rendered seven across — the layout the comment above described, never once applied. */
-.fdy-cal__grid--months{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
+.fdy-cal__grid--months,.fdy-cal__grid--years{grid-template-columns:repeat(3,1fr);gap:var(--space-1);}
 .fdy-cal__dow{display:flex;align-items:center;justify-content:center;height:1.75rem;font-size:var(--text-xs);font-weight:var(--weight-semibold);color:var(--color-text-muted);text-transform:capitalize;}
 .fdy-cal__day{display:inline-flex;align-items:center;justify-content:center;width:2rem;height:2rem;border:0;border-radius:var(--radius-sm);background:transparent;color:var(--color-text);font-size:var(--text-sm);font-variant-numeric:tabular-nums;cursor:pointer;}
 .fdy-cal__day:hover{background:var(--color-surface-2);}

package/src/components/table.css

@@ -37,6 +37,30 @@
 .fdy-table__selcol{width:1px;white-space:nowrap;}
 .fdy-table tbody tr[aria-selected="true"],.fdy-table tbody tr[aria-selected="true"]:hover{background:var(--color-primary-soft);}
 
+/* Frozen header row and/or first column — a rate matrix, a timetable, any grid read
+   against two axes at once.
+
+   This modifier exists because `position:sticky` alone is NOT enough. With
+   `border-collapse:collapse` the shared border belongs to the TABLE, not to either
+   cell, so a frozen cell scrolls out from under its own rule and the frozen column
+   loses the line that separates it from the data. Separate borders put each border
+   back on the cell that sticks. */
+.fdy-table--sticky{border-collapse:separate;border-spacing:0;}
+.fdy-table--sticky th,.fdy-table--sticky td{border-bottom:var(--bw) solid var(--color-border-muted);}
+.fdy-table--sticky thead th{position:sticky;top:0;z-index:2;border-bottom:var(--bw) solid var(--color-border);}
+/* The row header freezes sideways over the data cells, so it needs an opaque
+   background of its own — and it takes the BODY surface, not the header one, so a
+   hovered row stays one continuous band across the freeze line. Losing that is
+   losing the only way to track a row across a wide grid. */
+.fdy-table--sticky tbody th{position:sticky;left:0;z-index:1;background:var(--color-surface);border-right:var(--bw) solid var(--color-border);}
+.fdy-table--sticky tbody tr:hover th{background:var(--color-surface-2);}
+/* The corner cell is frozen on both axes, so it has to outrank both. */
+.fdy-table--sticky thead th:first-child{left:0;z-index:3;border-right:var(--bw) solid var(--color-border);}
+
+/* The scrollport a sticky cell sticks to. Both axes scroll here, and the height is a
+   custom property so a page can size it without out-specifying this rule. */
+.fdy-table-scroll--frozen{position:relative;overflow:auto;max-height:var(--fdy-table-frozen-h,30rem);}
+
 /* Data-table shell (toolbar + scroll + footer stay put while the table scrolls) */
 .fdy-datatable{border:var(--bw) solid var(--color-border);border-radius:var(--radius-lg);box-shadow:var(--shadow-1);background:var(--color-surface);overflow:hidden;}
 .fdy-table-scroll{position:relative;overflow-x:auto;}