@konce-pt/datetime 0.9.1 → 0.10.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { datePart, formatDate, formatTime, from12h, pad, parseDate, parseDateTime, parseTime, timePart, toIso, } from './iso.ts';
 export { KPT_CALENDAR_LEVELS, buildDayGrid, buildDecadeCells, buildMonthCells, buildYearCells, canPageBack, canPageForward, centuryStart, commitLevelFor, decadeStart, initialPage, isMonthYearDisabled, isYearDisabled, pageBy, resolveStartView, selectedYearMonth, topLevelFor, } from './calendar.ts';
 export type { DayGridOptions, KptCalendarPage, KptCalendarView, KptDateSelectionMode, KptDayCell, KptGridCell, MonthCellsOptions, YearCellsOptions, } from './calendar.ts';
+export { KPT_DAY_GRID_KEYS, clampIso, initialFocusDate, moveCellIndex, moveFocusDate } from './keys.ts';
 export { buildRangeGrid, clampVisibleMonths, pickRangeDay } from './range.ts';
 export type { KptDateRangeMode, KptDateRangeValue, KptMonthPanel, KptRangeDayCell, RangeGridOptions, } from './range.ts';
 export { KPT_CLOCK_R_INNER, KPT_CLOCK_R_OUTER, handAngle, handIsInner, hourFromAngle, hourMarks, markPosition, minuteFromAngle, minuteMarks, } from './clock.ts';

package/dist/index.js

@@ -1,4 +1,5 @@
 export { datePart, formatDate, formatTime, from12h, pad, parseDate, parseDateTime, parseTime, timePart, toIso, } from "./iso.js";
 export { KPT_CALENDAR_LEVELS, buildDayGrid, buildDecadeCells, buildMonthCells, buildYearCells, canPageBack, canPageForward, centuryStart, commitLevelFor, decadeStart, initialPage, isMonthYearDisabled, isYearDisabled, pageBy, resolveStartView, selectedYearMonth, topLevelFor, } from "./calendar.js";
+export { KPT_DAY_GRID_KEYS, clampIso, initialFocusDate, moveCellIndex, moveFocusDate } from "./keys.js";
 export { buildRangeGrid, clampVisibleMonths, pickRangeDay } from "./range.js";
 export { KPT_CLOCK_R_INNER, KPT_CLOCK_R_OUTER, handAngle, handIsInner, hourFromAngle, hourMarks, markPosition, minuteFromAngle, minuteMarks, } from "./clock.js";

package/dist/keys.d.ts

@@ -0,0 +1,28 @@
+/** Klawisze przesuwające skupiony dzień w siatce dni. */
+export declare const KPT_DAY_GRID_KEYS: Set<string>;
+/**
+ * Nowy skupiony dzień po klawiszu. `←`/`→` ±1 dzień, `↑`/`↓` ±7, `Home`/`End` poniedziałek
+ * i niedziela tego tygodnia, `PageUp`/`PageDown` ±1 miesiąc (z `shift` ±1 rok) — dzień miesiąca
+ * jest przycinany do długości docelowego miesiąca (31 stycznia → 28/29 lutego). W RTL strzałki
+ * w poziomie są odwrócone. Wynik nie wychodzi poza `minDate`/`maxDate`. `null` dla innego klawisza
+ * albo niepoprawnej daty.
+ */
+export declare function moveFocusDate(iso: string, key: string, options?: {
+    shift?: boolean;
+    rtl?: boolean;
+    minDate?: string | null;
+    maxDate?: string | null;
+}): string | null;
+/** Data przycięta do zakresu `[minDate, maxDate]` (porównanie napisów ISO). */
+export declare function clampIso(iso: string, minDate: string | null, maxDate: string | null): string;
+/**
+ * Pierwszy dzień do skupienia po otwarciu kalendarza: wybrany, a bez niego dzisiejszy — oba
+ * przycięte do zakresu.
+ */
+export declare function initialFocusDate(selectedIso: string, todayIso: string, minDate: string | null, maxDate: string | null): string;
+/**
+ * Nowy indeks w siatce komórek (miesiące, lata, dekady) o `columns` kolumnach: `←`/`→` ±1,
+ * `↑`/`↓` ±kolumna, `Home`/`End` pierwsza i ostatnia. Bez przechodzenia na sąsiednią stronę —
+ * od tego są przyciski ‹ ›. Pomija komórki wyłączone w kierunku ruchu.
+ */
+export declare function moveCellIndex(disabled: readonly boolean[], current: number, key: string, columns: number, rtl?: boolean): number | null;

package/dist/keys.js

@@ -0,0 +1,102 @@
+/**
+ * Klawiatura siatek kalendarza (wzorzec WAI-ARIA „date picker dialog”). Czysta arytmetyka na
+ * napisach ISO — komponenty obu portów trzymają tylko „skupiony dzień” i wołają te funkcje.
+ */
+import { parseDate, toIso } from "./iso.js";
+/** Klawisze przesuwające skupiony dzień w siatce dni. */
+export const KPT_DAY_GRID_KEYS = new Set([
+    'ArrowLeft',
+    'ArrowRight',
+    'ArrowUp',
+    'ArrowDown',
+    'Home',
+    'End',
+    'PageUp',
+    'PageDown',
+]);
+/**
+ * Nowy skupiony dzień po klawiszu. `←`/`→` ±1 dzień, `↑`/`↓` ±7, `Home`/`End` poniedziałek
+ * i niedziela tego tygodnia, `PageUp`/`PageDown` ±1 miesiąc (z `shift` ±1 rok) — dzień miesiąca
+ * jest przycinany do długości docelowego miesiąca (31 stycznia → 28/29 lutego). W RTL strzałki
+ * w poziomie są odwrócone. Wynik nie wychodzi poza `minDate`/`maxDate`. `null` dla innego klawisza
+ * albo niepoprawnej daty.
+ */
+export function moveFocusDate(iso, key, options = {}) {
+    const date = parseDate(iso);
+    if (!date || !KPT_DAY_GRID_KEYS.has(key))
+        return null;
+    const y = date.getFullYear();
+    const m = date.getMonth();
+    const d = date.getDate();
+    const horizontal = options.rtl ? -1 : 1;
+    let next;
+    switch (key) {
+        case 'ArrowLeft':
+            next = new Date(y, m, d - horizontal);
+            break;
+        case 'ArrowRight':
+            next = new Date(y, m, d + horizontal);
+            break;
+        case 'ArrowUp':
+            next = new Date(y, m, d - 7);
+            break;
+        case 'ArrowDown':
+            next = new Date(y, m, d + 7);
+            break;
+        case 'Home':
+            next = new Date(y, m, d - ((date.getDay() + 6) % 7));
+            break;
+        case 'End':
+            next = new Date(y, m, d + (6 - ((date.getDay() + 6) % 7)));
+            break;
+        default: {
+            const dir = key === 'PageDown' ? 1 : -1;
+            const months = options.shift ? 12 * dir : dir;
+            const target = new Date(y, m + months, 1);
+            const days = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();
+            next = new Date(target.getFullYear(), target.getMonth(), Math.min(d, days));
+        }
+    }
+    return clampIso(toIso(next), options.minDate ?? null, options.maxDate ?? null);
+}
+/** Data przycięta do zakresu `[minDate, maxDate]` (porównanie napisów ISO). */
+export function clampIso(iso, minDate, maxDate) {
+    if (minDate && iso < minDate)
+        return minDate;
+    if (maxDate && iso > maxDate)
+        return maxDate;
+    return iso;
+}
+/**
+ * Pierwszy dzień do skupienia po otwarciu kalendarza: wybrany, a bez niego dzisiejszy — oba
+ * przycięte do zakresu.
+ */
+export function initialFocusDate(selectedIso, todayIso, minDate, maxDate) {
+    return clampIso(parseDate(selectedIso) ? selectedIso : todayIso, minDate, maxDate);
+}
+/**
+ * Nowy indeks w siatce komórek (miesiące, lata, dekady) o `columns` kolumnach: `←`/`→` ±1,
+ * `↑`/`↓` ±kolumna, `Home`/`End` pierwsza i ostatnia. Bez przechodzenia na sąsiednią stronę —
+ * od tego są przyciski ‹ ›. Pomija komórki wyłączone w kierunku ruchu.
+ */
+export function moveCellIndex(disabled, current, key, columns, rtl = false) {
+    const count = disabled.length;
+    const horizontal = rtl ? -1 : 1;
+    const step = {
+        ArrowLeft: -horizontal,
+        ArrowRight: horizontal,
+        ArrowUp: -columns,
+        ArrowDown: columns,
+    };
+    if (key === 'Home' || key === 'End') {
+        const order = key === 'Home' ? [...Array(count).keys()] : [...Array(count).keys()].reverse();
+        return order.find((i) => !disabled[i]) ?? null;
+    }
+    const delta = step[key];
+    if (delta === undefined)
+        return null;
+    for (let i = current + delta; i >= 0 && i < count; i += delta)
+        if (!disabled[i])
+            return i;
+    return current;
+}

package/dist/range.d.ts

@@ -33,13 +33,16 @@ export interface RangeGridOptions {
     todayIso: string;
     /** Ukrywa dni sąsiednich miesięcy — konieczne, gdy paneli jest kilka. */
     hideOutside?: boolean;
+    /** Granice wyboru 'RRRR-MM-DD' (włącznie); dni poza nimi są wyłączone. */
+    minDate?: string | null;
+    maxDate?: string | null;
 }
 /**
  * Siatka dni z pasmem zakresu. Przy kilku panelach dni sąsiednich miesięcy stają się pustymi
  * slotami: inaczej ta sama data byłaby klikalna dwa razy — jako wygaszona w jednym panelu
  * i właściwa w drugim — a pasmo malowałoby się w obu miejscach.
  */
-export declare function buildRangeGrid({ page, start, end, todayIso, hideOutside, }: RangeGridOptions): KptRangeDayCell[][];
+export declare function buildRangeGrid({ page, start, end, todayIso, hideOutside, minDate, maxDate, }: RangeGridOptions): KptRangeDayCell[][];
 /**
  * Kolejny klik w zakresie: pierwszy ustawia początek, drugi koniec, trzeci zaczyna od nowa.
  * Klik przed początkiem nie tworzy odwróconego zakresu — kolejność jest normalizowana.

package/dist/range.js

@@ -4,7 +4,7 @@ import { toIso } from "./iso.js";
  * slotami: inaczej ta sama data byłaby klikalna dwa razy — jako wygaszona w jednym panelu
  * i właściwa w drugim — a pasmo malowałoby się w obu miejscach.
  */
-export function buildRangeGrid({ page, start, end, todayIso, hideOutside = false, }) {
+export function buildRangeGrid({ page, start, end, todayIso, hideOutside = false, minDate = null, maxDate = null, }) {
     const { y, m } = page;
     const hasBand = !!start && !!end && start < end;
     const first = new Date(y, m, 1);
@@ -28,7 +28,7 @@ export function buildRangeGrid({ page, start, end, todayIso, hideOutside = false
                 rangeStart: hasBand && iso === start,
                 rangeEnd: hasBand && iso === end,
                 blank: hideOutside && !inMonth,
-                disabled: false,
+                disabled: (!!minDate && iso < minDate) || (!!maxDate && iso > maxDate),
             });
         }
         weeks.push(row);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konce-pt/datetime",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Calendar and clock core for Koncept UI date controls — day/month/year/decade grids, ranges, dial marks. Framework-free TypeScript, zero runtime dependencies.",
   "license": "MIT",
   "author": "konce.pt",