@astryxdesign/core 0.7.8 → 0.7.9-canary.0200dfe

package/dist/utils/calendarDateParser.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @file calendarDateParser.ts
+ * @input Date text, locale, calendar; Intl, calendarSystem, unicodeDigits
+ * @output Cached per-locale lexicons, a typed-date parser with distinct rejection
+ *   kinds, committed display text, the format hint, and calendar display names
+ * @position Core utility; used by DateInput and DateTimeInput through useTypedDate
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/utils/calendarDateParser.test.ts
+ * - /packages/core/src/utils/calendarDateParser.roundtrip.test.ts
+ */
+import type { PlainDate } from './dateTypes.js';
+import type { Locale } from '../i18n/types.js';
+import { type CalendarSystem } from './calendarSystem.js';
+import { type SharedDateFormat } from './plainDate.js';
+/** How a typed text reads in a calendar. */
+export type CalendarDateParseResult = {
+    readonly kind: 'empty';
+}
+/** Part of a date: nothing to report yet. */
+ | {
+    readonly kind: 'incomplete';
+}
+/** Text that cannot become a date. */
+ | {
+    readonly kind: 'unreadable';
+}
+/** A readable date that the calendar does not have. */
+ | {
+    readonly kind: 'nonexistent';
+    readonly isComplete: boolean;
+}
+/** A date that the constraints reject. */
+ | {
+    readonly kind: 'outOfRange';
+    readonly date: PlainDate;
+    readonly isComplete: boolean;
+}
+/**
+ * A date. `isComplete` is true when more typing cannot change its meaning,
+ * so a field may report it while the person types.
+ */
+ | {
+    readonly kind: 'value';
+    readonly date: PlainDate;
+    readonly isComplete: boolean;
+};
+export interface CalendarDateParseOptions {
+    /** The Gregorian date that two-digit and omitted years resolve against. */
+    readonly today?: PlainDate;
+    /** Reads ISO-shaped text as a Gregorian ISO date, as `system_date` shows. */
+    readonly isoIsGregorian?: boolean;
+    /** Returns true for a date that may not be chosen. */
+    readonly isDateDisabled?: (date: PlainDate) => boolean;
+}
+type DateField = 'year' | 'month' | 'day';
+interface EraArithmetic {
+    /** The Gregorian year before era year 1, or after it for a backward era. */
+    readonly base: number;
+    readonly isForward: boolean;
+}
+/** What a locale writes for one calendar, learned from Intl. */
+export interface CalendarDateLexicon {
+    readonly locale: Locale;
+    readonly calendar: CalendarSystem;
+    readonly order: ReadonlyArray<DateField>;
+    readonly nameOrder: ReadonlyArray<DateField>;
+    readonly months: ReadonlyMap<string, ReadonlySet<string>>;
+    readonly monthTemplates: ReadonlyArray<MonthTemplate>;
+    readonly leapMarkers: ReadonlySet<string>;
+    readonly eras: ReadonlyMap<string, string>;
+    readonly yearAliases: ReadonlyMap<string, string>;
+    readonly trailers: ReadonlySet<string>;
+    readonly yearMarkers: ReadonlySet<string>;
+    readonly separators: ReadonlySet<string>;
+    readonly weekdays: ReadonlySet<string>;
+    readonly vocabulary: ReadonlyArray<string>;
+    readonly vocabularySet: ReadonlySet<string>;
+    readonly isNumericMonthOrdinal: boolean;
+    readonly eraArithmetic: ReadonlyMap<string, EraArithmetic>;
+}
+interface MonthTemplate {
+    readonly pre: string;
+    readonly post: string;
+    readonly isLeap: boolean;
+}
+/** Text in one comparable form: ASCII digits, lower case, no Latin accents. */
+export declare function normalizeDateText(text: string, locale: Locale): string;
+/**
+ * The lexicon for a locale and calendar, built on first use and cached.
+ * Building one formats a few hundred dates; call it when a field gains focus.
+ */
+export declare function getCalendarDateLexicon(locale: Locale, calendar: CalendarSystem): CalendarDateLexicon;
+/**
+ * Reads typed text as a date in the lexicon's calendar. Values are Gregorian.
+ * The result tells an empty field, part of a date, unreadable text, a date the
+ * calendar does not have, a date out of range, and a date apart.
+ */
+export declare function parseCalendarDate(text: string, lex: CalendarDateLexicon, options?: CalendarDateParseOptions): CalendarDateParseResult;
+/**
+ * The committed text of a date field in a calendar. Gregorian text is the
+ * shared Timestamp date text; `system_date` is always the ISO date.
+ */
+export declare function formatCalendarDateText(pd: PlainDate, format: SharedDateFormat, locale: Locale, calendar: CalendarSystem): string;
+/** An example date in the calendar's numeric pattern, with its era. */
+export declare function formatCalendarDateHint(pd: PlainDate, locale: Locale, calendar: CalendarSystem): string;
+/** The calendar's name in the locale, such as "Persian Calendar". */
+export declare function calendarDisplayName(calendar: CalendarSystem, locale: Locale): string;
+export {};
+//# sourceMappingURL=calendarDateParser.d.ts.map

package/dist/utils/calendarDateParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarDateParser.d.ts","sourceRoot":"","sources":["../../src/utils/calendarDateParser.ts"],"names":[],"mappings":"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"}