@orangelogic/design-system 2.110.0 → 2.112.0

package/library/packages/utils/src/date/date.d.ts

@@ -0,0 +1,42 @@
+/** Strict date-only string in YYYY-MM-DD format. No time, no timezone. */
+export type CalendarDate = string;
+/** Returns true only for well-formed, calendar-valid YYYY-MM-DD strings. */
+export declare function isValidIsoDate(value: string): value is CalendarDate;
+/** Builds a CalendarDate from numeric parts. Month is 1-based. */
+export declare function toIsoDate(year: number, month: number, day: number): CalendarDate;
+/** Splits a CalendarDate into numeric year/month/day. Month is 1-based. */
+export declare function parseIsoDate(date: CalendarDate): {
+    day: number;
+    month: number;
+    year: number;
+};
+/** Converts a valid CalendarDate into a local Date object. */
+export declare function isoToDate(value: string): Date | undefined;
+/** Converts YYYY-MM-DD to DD-MM-YYYY for date input display. */
+export declare function isoToDisplay(value: string): string;
+/** Converts complete DD-MM-YYYY display input to YYYY-MM-DD. Returns empty for partial input. */
+export declare function displayToIso(value: string): CalendarDate | '';
+/** Returns today's date as a CalendarDate in the browser's local timezone. */
+export declare function getTodayIsoDate(): CalendarDate;
+/**
+ * Adds (or subtracts) months from a given year/month pair.
+ * Native Date handles overflow — e.g. month 13 becomes January of next year.
+ */
+export declare function addMonths(year: number, month: number, delta: number): {
+    month: number;
+    year: number;
+};
+/** Formats a year/month pair as a human-readable label, e.g. "June 2026". */
+export declare function formatMonthYearLabel(year: number, month: number): string;
+/** Returns the 0-based day-of-week index for the 1st of the given month. 0 = Sunday. */
+export declare function getFirstDayOfWeek(year: number, month: number): number;
+/**
+ * Normalizes a consumer-provided value to a CalendarDate (YYYY-MM-DD).
+ *
+ * Supported formats:
+ *   - YYYY-MM-DD           → returned as-is after validation
+ *   - ISO UTC datetime (Z) → converted to the browser's local date
+ *
+ * Unsupported formats log a warning and return null.
+ */
+export declare function normalizeToIsoDate(value: string): CalendarDate | null;

package/library/packages/utils/src/date/index.d.ts

@@ -0,0 +1,3 @@
+export * from './calendar-grid';
+export * from './date';
+export * from './date-range-preset';

package/library/packages/utils/src/index.d.ts

@@ -24,6 +24,7 @@ export * from './custom-element/slot';
 export * from './custom-element/tabbable';
 export * from './custom-element/user-agent';
 export * from './custom-element/watch';
+export * from './date';
 export * from './dom';
 export * from './drag-scroll';
 export * from './event';