@beeq/core 1.12.14-beta.0 → 1.13.0

package/dist/collection/components/date-picker/helper/input.js

@@ -0,0 +1,37 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+import { parseDateInput, toISODateString } from "../../../shared/utils/date/dateParsing";
+import { padBound } from "./bounds";
+import { serializeValue } from "./selection";
+/**
+ * Precision-aware, bounds-aware parser for the trigger input field.
+ * Returns the parsed date as a wire-format string at the configured
+ * precision, clamped against `min`/`max`, or `{ invalid: true }` on failure.
+ */
+export const parseTypedInput = (text, locale, precision, min, max, isDateDisallowed) => {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return { value: undefined };
+    const parsed = parseDateInput(trimmed, locale);
+    if (!parsed || isDateDisallowed?.(parsed))
+        return { invalid: true };
+    const iso = clampISO(toISODateString(parsed), min, max);
+    return { value: serializeValue([iso], 'single', precision) };
+};
+/**
+ * Lexically clamp a full `YYYY-MM-DD` ISO date to precision-padded bounds.
+ * Coarser bounds (`YYYY`, `YYYY-MM`) are padded to the widest matching day
+ * before comparing.
+ */
+export const clampISO = (iso, min, max) => {
+    const paddedMin = padBound(min, 'min');
+    const paddedMax = padBound(max, 'max');
+    if (paddedMin && iso < paddedMin)
+        return paddedMin;
+    if (paddedMax && iso > paddedMax)
+        return paddedMax;
+    return iso;
+};
+//# sourceMappingURL=input.js.map

package/dist/collection/components/date-picker/helper/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAa7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,MAA4B,EAC5B,SAAyB,EACzB,GAAY,EACZ,GAAY,EACZ,gBAA0C,EAC5B,EAAE;IAChB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEpE,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,GAAY,EAAE,GAAY,EAAU,EAAE;IAC1E,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,GAAG,GAAG,SAAS;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,SAAS,IAAI,GAAG,GAAG,SAAS;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC","sourcesContent":["import { parseDateInput, toISODateString } from '../../../shared/utils/date/dateParsing';\nimport type { TDatePrecision } from '../bq-date-picker.types';\nimport { padBound } from './bounds';\nimport { serializeValue } from './selection';\n\n/**\n * Result of parsing user-typed input.\n * - `value` is set when parsing succeeded — always at the configured precision.\n * - `invalid: true` when the string could not be parsed or `isDateDisallowed`\n *   rejected the result.\n */\nexport type TParsedInput = {\n  value?: string;\n  invalid?: boolean;\n};\n\n/**\n * Precision-aware, bounds-aware parser for the trigger input field.\n * Returns the parsed date as a wire-format string at the configured\n * precision, clamped against `min`/`max`, or `{ invalid: true }` on failure.\n */\nexport const parseTypedInput = (\n  text: string,\n  locale: Intl.LocalesArgument,\n  precision: TDatePrecision,\n  min?: string,\n  max?: string,\n  isDateDisallowed?: (date: Date) => boolean,\n): TParsedInput => {\n  const trimmed = text.trim();\n  if (!trimmed) return { value: undefined };\n\n  const parsed = parseDateInput(trimmed, locale);\n  if (!parsed || isDateDisallowed?.(parsed)) return { invalid: true };\n\n  const iso = clampISO(toISODateString(parsed), min, max);\n  return { value: serializeValue([iso], 'single', precision) };\n};\n\n/**\n * Lexically clamp a full `YYYY-MM-DD` ISO date to precision-padded bounds.\n * Coarser bounds (`YYYY`, `YYYY-MM`) are padded to the widest matching day\n * before comparing.\n */\nexport const clampISO = (iso: string, min?: string, max?: string): string => {\n  const paddedMin = padBound(min, 'min');\n  const paddedMax = padBound(max, 'max');\n  if (paddedMin && iso < paddedMin) return paddedMin;\n  if (paddedMax && iso > paddedMax) return paddedMax;\n  return iso;\n};\n"]}

package/dist/collection/components/date-picker/helper/intl.js

@@ -0,0 +1,78 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+/**
+ * Cached `Intl.DateTimeFormat` factories.
+ *
+ * The Intl API is powerful but relatively expensive to instantiate. Since the
+ * calendar re-renders on every user interaction we keep a small LRU-ish cache
+ * keyed by locale + option shape.
+ */
+const cache = new Map();
+/** Prevents unbounded growth in long-running apps. */
+const CACHE_MAX_SIZE = 64;
+const cacheKey = (locale, options) => {
+    const localeKey = typeof locale === 'string' ? locale : JSON.stringify(locale ?? '');
+    return `${localeKey}|${JSON.stringify(options)}`;
+};
+const getFormatter = (locale, options) => {
+    const key = cacheKey(locale, options);
+    let formatter = cache.get(key);
+    if (!formatter) {
+        formatter = new Intl.DateTimeFormat(locale, options);
+        cache.set(key, formatter);
+        if (cache.size > CACHE_MAX_SIZE) {
+            const firstKey = cache.keys().next().value;
+            if (firstKey !== undefined)
+                cache.delete(firstKey);
+        }
+    }
+    return formatter;
+};
+/**
+ * Format a full date, e.g. "1 January 2026".
+ */
+export const formatDate = (date, locale, options = { day: 'numeric', month: 'long', year: 'numeric' }) => getFormatter(locale, options).format(date);
+/**
+ * Format a month, e.g. "January 2026" or "Jan".
+ */
+export const formatMonth = (date, locale, monthStyle = 'long', includeYear = true) => getFormatter(locale, {
+    month: monthStyle,
+    ...(includeYear ? { year: 'numeric' } : {}),
+}).format(date);
+/**
+ * Format a year, e.g. "2026".
+ */
+export const formatYear = (date, locale) => getFormatter(locale, { year: 'numeric' }).format(date);
+/**
+ * Returns the weekday names for the given locale ordered from `firstDayOfWeek`.
+ *
+ * @param locale        The locale used for formatting.
+ * @param firstDayOfWeek The first day of the week (0 = Sunday, 1 = Monday, ...).
+ * @param style         Weekday style (long, short, narrow).
+ * @returns             An array of `{short, long}` names in display order.
+ */
+export const getWeekdayNames = (locale, firstDayOfWeek, style = 'short') => {
+    const shortFormatter = getFormatter(locale, { weekday: style });
+    const longFormatter = getFormatter(locale, { weekday: 'long' });
+    // Any known Sunday works as the anchor date. 2024-01-07 is a Sunday.
+    const anchor = new Date(2024, 0, 7);
+    return Array.from({ length: 7 }, (_, i) => {
+        const dayIndex = (firstDayOfWeek + i) % 7;
+        const day = new Date(anchor);
+        day.setDate(anchor.getDate() + dayIndex);
+        return { short: shortFormatter.format(day), long: longFormatter.format(day) };
+    });
+};
+/**
+ * Returns the localized month names.
+ *
+ * @param locale The locale used for formatting.
+ * @param style  Month style (long, short, narrow).
+ */
+export const getMonthNames = (locale, style = 'short') => {
+    const formatter = getFormatter(locale, { month: style });
+    return Array.from({ length: 12 }, (_, month) => formatter.format(new Date(2024, month, 1)));
+};
+//# sourceMappingURL=intl.js.map

package/dist/collection/components/date-picker/helper/intl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/intl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cached `Intl.DateTimeFormat` factories.\n *\n * The Intl API is powerful but relatively expensive to instantiate. Since the\n * calendar re-renders on every user interaction we keep a small LRU-ish cache\n * keyed by locale + option shape.\n */\n\nconst cache = new Map<string, Intl.DateTimeFormat>();\n\n/** Prevents unbounded growth in long-running apps. */\nconst CACHE_MAX_SIZE = 64;\n\nconst cacheKey = (locale: Intl.LocalesArgument, options: Intl.DateTimeFormatOptions): string => {\n  const localeKey = typeof locale === 'string' ? locale : JSON.stringify(locale ?? '');\n  return `${localeKey}|${JSON.stringify(options)}`;\n};\n\nconst getFormatter = (locale: Intl.LocalesArgument, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat => {\n  const key = cacheKey(locale, options);\n  let formatter = cache.get(key);\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat(locale, options);\n    cache.set(key, formatter);\n    if (cache.size > CACHE_MAX_SIZE) {\n      const firstKey = cache.keys().next().value;\n      if (firstKey !== undefined) cache.delete(firstKey);\n    }\n  }\n  return formatter;\n};\n\n/**\n * Format a full date, e.g. \"1 January 2026\".\n */\nexport const formatDate = (\n  date: Date,\n  locale: Intl.LocalesArgument,\n  options: Intl.DateTimeFormatOptions = { day: 'numeric', month: 'long', year: 'numeric' },\n): string => getFormatter(locale, options).format(date);\n\n/**\n * Format a month, e.g. \"January 2026\" or \"Jan\".\n */\nexport const formatMonth = (\n  date: Date,\n  locale: Intl.LocalesArgument,\n  monthStyle: 'long' | 'short' | 'narrow' = 'long',\n  includeYear = true,\n): string =>\n  getFormatter(locale, {\n    month: monthStyle,\n    ...(includeYear ? { year: 'numeric' } : {}),\n  }).format(date);\n\n/**\n * Format a year, e.g. \"2026\".\n */\nexport const formatYear = (date: Date, locale: Intl.LocalesArgument): string =>\n  getFormatter(locale, { year: 'numeric' }).format(date);\n\n/**\n * Returns the weekday names for the given locale ordered from `firstDayOfWeek`.\n *\n * @param locale        The locale used for formatting.\n * @param firstDayOfWeek The first day of the week (0 = Sunday, 1 = Monday, ...).\n * @param style         Weekday style (long, short, narrow).\n * @returns             An array of `{short, long}` names in display order.\n */\nexport const getWeekdayNames = (\n  locale: Intl.LocalesArgument,\n  firstDayOfWeek: number,\n  style: 'long' | 'short' | 'narrow' = 'short',\n): Array<{ short: string; long: string }> => {\n  const shortFormatter = getFormatter(locale, { weekday: style });\n  const longFormatter = getFormatter(locale, { weekday: 'long' });\n  // Any known Sunday works as the anchor date. 2024-01-07 is a Sunday.\n  const anchor = new Date(2024, 0, 7);\n\n  return Array.from({ length: 7 }, (_, i) => {\n    const dayIndex = (firstDayOfWeek + i) % 7;\n    const day = new Date(anchor);\n    day.setDate(anchor.getDate() + dayIndex);\n    return { short: shortFormatter.format(day), long: longFormatter.format(day) };\n  });\n};\n\n/**\n * Returns the localized month names.\n *\n * @param locale The locale used for formatting.\n * @param style  Month style (long, short, narrow).\n */\nexport const getMonthNames = (locale: Intl.LocalesArgument, style: 'long' | 'short' | 'narrow' = 'short'): string[] => {\n  const formatter = getFormatter(locale, { month: style });\n  return Array.from({ length: 12 }, (_, month) => formatter.format(new Date(2024, month, 1)));\n};\n"]}

package/dist/collection/components/date-picker/helper/labels.js

@@ -0,0 +1,61 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+import { addMonths, startOfMonth } from "./calendar";
+import { DECADE_GRID_SIZE, DEFAULT_ARIA_LABELS } from "./constants";
+import { formatMonth, formatYear } from "./intl";
+/**
+ * Builds the label shown in the calendar header title button.
+ *
+ * - `days`: localized "Month Year" for a single panel, or "StartYear – EndYear"
+ *   when several months are visible at once.
+ * - `months`: the localized year currently in focus.
+ * - `years`: the closed range spanning the visible decade.
+ */
+export const getHeaderLabel = ({ view, viewDate, focusedYear, decadeStart, monthCount, locale, }) => {
+    if (view === 'days') {
+        if (monthCount > 1) {
+            const first = startOfMonth(viewDate);
+            const last = startOfMonth(addMonths(viewDate, monthCount - 1));
+            const startYear = formatYear(first, locale);
+            const endYear = formatYear(last, locale);
+            return startYear === endYear ? startYear : `${startYear} – ${endYear}`;
+        }
+        return formatMonth(viewDate, locale, 'long', true);
+    }
+    if (view === 'months') {
+        return formatYear(new Date(focusedYear, 0, 1), locale);
+    }
+    const end = decadeStart + DECADE_GRID_SIZE - 1;
+    return `${decadeStart} – ${end}`;
+};
+/**
+ * Aria label announcing what clicking the title switches to.
+ * Views cycle days → months → years → back to the base view (days for
+ * `precision="day"`, months for `precision="month"`).
+ */
+export const getHeaderTitleLabel = (view, precision = 'day') => {
+    if (view === 'days')
+        return DEFAULT_ARIA_LABELS.chooseMonth;
+    if (view === 'months')
+        return DEFAULT_ARIA_LABELS.chooseYear;
+    return precision === 'month' ? DEFAULT_ARIA_LABELS.chooseMonth : DEFAULT_ARIA_LABELS.chooseDate;
+};
+/** Aria label for the "previous" navigation button, per view. */
+export const getPreviousLabel = (view) => {
+    if (view === 'days')
+        return DEFAULT_ARIA_LABELS.previousMonth;
+    if (view === 'months')
+        return DEFAULT_ARIA_LABELS.previousYear;
+    return DEFAULT_ARIA_LABELS.previousDecade;
+};
+/** Aria label for the "next" navigation button, per view. */
+export const getNextLabel = (view) => {
+    if (view === 'days')
+        return DEFAULT_ARIA_LABELS.nextMonth;
+    if (view === 'months')
+        return DEFAULT_ARIA_LABELS.nextYear;
+    return DEFAULT_ARIA_LABELS.nextDecade;
+};
+//# sourceMappingURL=labels.js.map

package/dist/collection/components/date-picker/helper/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAWjD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,MAAM,GACU,EAAU,EAAE;IAC5B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,MAAM,OAAO,EAAE,CAAC;QACzE,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,GAAG,GAAG,WAAW,GAAG,gBAAgB,GAAG,CAAC,CAAC;IAC/C,OAAO,GAAG,WAAW,MAAM,GAAG,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAmB,EAAE,YAA4B,KAAK,EAAU,EAAE;IACpG,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,mBAAmB,CAAC,WAAW,CAAC;IAC5D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,UAAU,CAAC;IAC7D,OAAO,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC;AAClG,CAAC,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAmB,EAAU,EAAE;IAC9D,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,mBAAmB,CAAC,aAAa,CAAC;IAC9D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,YAAY,CAAC;IAC/D,OAAO,mBAAmB,CAAC,cAAc,CAAC;AAC5C,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAmB,EAAU,EAAE;IAC1D,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC;IAC1D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC,QAAQ,CAAC;IAC3D,OAAO,mBAAmB,CAAC,UAAU,CAAC;AACxC,CAAC,CAAC","sourcesContent":["import type { TCalendarView, TDatePrecision } from '../bq-date-picker.types';\nimport { addMonths, startOfMonth } from './calendar';\nimport { DECADE_GRID_SIZE, DEFAULT_ARIA_LABELS } from './constants';\nimport { formatMonth, formatYear } from './intl';\n\ninterface HeaderLabelArgs {\n  view: TCalendarView;\n  viewDate: Date;\n  focusedYear: number;\n  decadeStart: number;\n  monthCount: number;\n  locale: Intl.LocalesArgument;\n}\n\n/**\n * Builds the label shown in the calendar header title button.\n *\n * - `days`: localized \"Month Year\" for a single panel, or \"StartYear – EndYear\"\n *   when several months are visible at once.\n * - `months`: the localized year currently in focus.\n * - `years`: the closed range spanning the visible decade.\n */\nexport const getHeaderLabel = ({\n  view,\n  viewDate,\n  focusedYear,\n  decadeStart,\n  monthCount,\n  locale,\n}: HeaderLabelArgs): string => {\n  if (view === 'days') {\n    if (monthCount > 1) {\n      const first = startOfMonth(viewDate);\n      const last = startOfMonth(addMonths(viewDate, monthCount - 1));\n      const startYear = formatYear(first, locale);\n      const endYear = formatYear(last, locale);\n      return startYear === endYear ? startYear : `${startYear} – ${endYear}`;\n    }\n    return formatMonth(viewDate, locale, 'long', true);\n  }\n  if (view === 'months') {\n    return formatYear(new Date(focusedYear, 0, 1), locale);\n  }\n  const end = decadeStart + DECADE_GRID_SIZE - 1;\n  return `${decadeStart} – ${end}`;\n};\n\n/**\n * Aria label announcing what clicking the title switches to.\n * Views cycle days → months → years → back to the base view (days for\n * `precision=\"day\"`, months for `precision=\"month\"`).\n */\nexport const getHeaderTitleLabel = (view: TCalendarView, precision: TDatePrecision = 'day'): string => {\n  if (view === 'days') return DEFAULT_ARIA_LABELS.chooseMonth;\n  if (view === 'months') return DEFAULT_ARIA_LABELS.chooseYear;\n  return precision === 'month' ? DEFAULT_ARIA_LABELS.chooseMonth : DEFAULT_ARIA_LABELS.chooseDate;\n};\n\n/** Aria label for the \"previous\" navigation button, per view. */\nexport const getPreviousLabel = (view: TCalendarView): string => {\n  if (view === 'days') return DEFAULT_ARIA_LABELS.previousMonth;\n  if (view === 'months') return DEFAULT_ARIA_LABELS.previousYear;\n  return DEFAULT_ARIA_LABELS.previousDecade;\n};\n\n/** Aria label for the \"next\" navigation button, per view. */\nexport const getNextLabel = (view: TCalendarView): string => {\n  if (view === 'days') return DEFAULT_ARIA_LABELS.nextMonth;\n  if (view === 'months') return DEFAULT_ARIA_LABELS.nextYear;\n  return DEFAULT_ARIA_LABELS.nextDecade;\n};\n"]}

package/dist/collection/components/date-picker/helper/navigation.js

@@ -0,0 +1,45 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+import { DECADE_GRID_SIZE } from "./constants";
+/**
+ * Advances a focused month cursor by `delta` months, carrying over to the
+ * previous or next year as needed. Pure — accepts and returns primitives so
+ * it can be unit-tested and reused by keyboard handlers.
+ */
+export const advanceFocusedMonth = (focusedMonth, focusedYear, delta) => {
+    let month = focusedMonth + delta;
+    let year = focusedYear;
+    while (month < 0) {
+        month += 12;
+        year -= 1;
+    }
+    while (month > 11) {
+        month -= 12;
+        year += 1;
+    }
+    return { month, year };
+};
+/**
+ * Advances a focused year cursor by `delta` years, sliding the visible
+ * decade grid so the focused year always stays in view.
+ */
+export const advanceFocusedYear = (focusedYear, decadeStart, delta) => {
+    const year = focusedYear + delta;
+    let nextDecadeStart = decadeStart;
+    if (year < decadeStart) {
+        nextDecadeStart = decadeStart - DECADE_GRID_SIZE;
+    }
+    else if (year > decadeStart + DECADE_GRID_SIZE - 1) {
+        nextDecadeStart = decadeStart + DECADE_GRID_SIZE;
+    }
+    return { year, decadeStart: nextDecadeStart };
+};
+/**
+ * Number of columns used to render the months/years grids. The grids widen
+ * from 3 → 4 columns when multiple months are visible, so vertical arrow
+ * navigation stride must match.
+ */
+export const getGridColumns = (monthCount) => (monthCount > 1 ? 4 : 3);
+//# sourceMappingURL=navigation.js.map

package/dist/collection/components/date-picker/helper/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,YAAoB,EACpB,WAAmB,EACnB,KAAa,EACoB,EAAE;IACnC,IAAI,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC;IACjC,IAAI,IAAI,GAAG,WAAW,CAAC;IACvB,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,GAAG,EAAE,EAAE,CAAC;QAClB,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,WAAmB,EACnB,WAAmB,EACnB,KAAa,EAC0B,EAAE;IACzC,MAAM,IAAI,GAAG,WAAW,GAAG,KAAK,CAAC;IACjC,IAAI,eAAe,GAAG,WAAW,CAAC;IAClC,IAAI,IAAI,GAAG,WAAW,EAAE,CAAC;QACvB,eAAe,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACnD,CAAC;SAAM,IAAI,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACrD,eAAe,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["import { DECADE_GRID_SIZE } from './constants';\n\n/**\n * Advances a focused month cursor by `delta` months, carrying over to the\n * previous or next year as needed. Pure — accepts and returns primitives so\n * it can be unit-tested and reused by keyboard handlers.\n */\nexport const advanceFocusedMonth = (\n  focusedMonth: number,\n  focusedYear: number,\n  delta: number,\n): { month: number; year: number } => {\n  let month = focusedMonth + delta;\n  let year = focusedYear;\n  while (month < 0) {\n    month += 12;\n    year -= 1;\n  }\n  while (month > 11) {\n    month -= 12;\n    year += 1;\n  }\n  return { month, year };\n};\n\n/**\n * Advances a focused year cursor by `delta` years, sliding the visible\n * decade grid so the focused year always stays in view.\n */\nexport const advanceFocusedYear = (\n  focusedYear: number,\n  decadeStart: number,\n  delta: number,\n): { year: number; decadeStart: number } => {\n  const year = focusedYear + delta;\n  let nextDecadeStart = decadeStart;\n  if (year < decadeStart) {\n    nextDecadeStart = decadeStart - DECADE_GRID_SIZE;\n  } else if (year > decadeStart + DECADE_GRID_SIZE - 1) {\n    nextDecadeStart = decadeStart + DECADE_GRID_SIZE;\n  }\n  return { year, decadeStart: nextDecadeStart };\n};\n\n/**\n * Number of columns used to render the months/years grids. The grids widen\n * from 3 → 4 columns when multiple months are visible, so vertical arrow\n * navigation stride must match.\n */\nexport const getGridColumns = (monthCount: number): number => (monthCount > 1 ? 4 : 3);\n"]}

package/dist/collection/components/date-picker/helper/selection.js

@@ -0,0 +1,167 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+import { compareISO, isValidISO, sortRange } from "./calendar";
+/* -------------------------------------------------------------------------- */
+/*                          Wire format parse/serialize                       */
+/* -------------------------------------------------------------------------- */
+/**
+ * Regex matching the wire-format ISO shape for each precision.
+ * The internal selection is always `YYYY-MM-DD`; these only apply at the
+ * public value boundary.
+ */
+const PRECISION_ISO_REGEX = {
+    day: /^\d{4}-\d{2}-\d{2}$/,
+    month: /^\d{4}-\d{2}$/,
+    year: /^\d{4}$/,
+};
+/** Expand a wire-format token to a full `YYYY-MM-DD` ISO date. */
+const expandToken = (token, precision) => {
+    if (precision === 'month')
+        return `${token}-01`;
+    if (precision === 'year')
+        return `${token}-01-01`;
+    return token;
+};
+/** Truncate a full `YYYY-MM-DD` ISO date to the wire-format for the precision. */
+const truncateISO = (iso, precision) => {
+    if (precision === 'month')
+        return iso.slice(0, 7);
+    if (precision === 'year')
+        return iso.slice(0, 4);
+    return iso;
+};
+/**
+ * Whether the token matches the precision-specific shape *and* is a real date.
+ * For month/year we still expand to a full ISO date so `2026-13` / `2026-02-30`
+ * style errors are caught by `isValidISO`.
+ */
+const isValidToken = (token, precision) => {
+    if (!PRECISION_ISO_REGEX[precision].test(token))
+        return false;
+    return isValidISO(expandToken(token, precision));
+};
+/**
+ * Parse a raw `value` string into an internal `TSelection` array.
+ *
+ * Wire format:
+ * - single: `YYYY-MM-DD` (or `YYYY-MM` / `YYYY` at coarser precision)
+ * - multi:  space-separated tokens
+ * - range:  `<start>/<end>`
+ *
+ * Internally the selection is always stored as full `YYYY-MM-DD` — month
+ * precision expands to the first day of the month; year precision to Jan 1st.
+ *
+ * Invalid tokens (malformed strings, impossible dates like `2026-99-99`,
+ * non-ISO input) are silently discarded — the returned selection is
+ * guaranteed to contain only valid ISO-8601 dates.
+ */
+export const parseValue = (value, type, precision = 'day') => {
+    if (!value)
+        return [];
+    const trimmed = value.trim();
+    if (!trimmed)
+        return [];
+    if (type === 'range') {
+        const parts = trimmed
+            .split('/')
+            .filter((token) => isValidToken(token, precision))
+            .map((token) => expandToken(token, precision));
+        if (parts.length === 0)
+            return [];
+        if (parts.length === 1)
+            return [parts[0]];
+        const [start, end] = sortRange(parts[0], parts[1]);
+        return [start, end];
+    }
+    if (type === 'multi') {
+        const valid = trimmed
+            .split(/\s+/)
+            .filter((token) => isValidToken(token, precision))
+            .map((token) => expandToken(token, precision));
+        return Array.from(new Set(valid)).sort(compareISO);
+    }
+    return isValidToken(trimmed, precision) ? [expandToken(trimmed, precision)] : [];
+};
+/**
+ * Serialize an internal `TSelection` array back to the wire format.
+ * Truncates each entry to the precision's ISO shape.
+ */
+export const serializeValue = (selection, type, precision = 'day') => {
+    if (!selection.length)
+        return '';
+    const format = (iso) => truncateISO(iso, precision);
+    if (type === 'range') {
+        if (selection.length < 2)
+            return format(selection[0] ?? '');
+        const [start, end] = sortRange(selection[0], selection[1]);
+        return `${format(start)}/${format(end)}`;
+    }
+    if (type === 'multi') {
+        return Array.from(new Set(selection.map(format)))
+            .sort(compareISO)
+            .join(' ');
+    }
+    return format(selection[0]);
+};
+/* -------------------------------------------------------------------------- */
+/*                                Predicates                                  */
+/* -------------------------------------------------------------------------- */
+/** Whether the given ISO day is included in the selection. */
+export const isSelected = (iso, selection, type) => {
+    if (!selection.length)
+        return false;
+    if (type === 'range') {
+        if (selection.length < 2)
+            return iso === selection[0];
+        const [start, end] = selection;
+        return iso >= start && iso <= end;
+    }
+    return selection.includes(iso);
+};
+/** Whether the ISO day is the start of a range selection. */
+export const isRangeStart = (iso, selection, type) => type === 'range' && selection.length === 2 && iso === selection[0];
+/** Whether the ISO day is the end of a range selection. */
+export const isRangeEnd = (iso, selection, type) => type === 'range' && selection.length === 2 && iso === selection[1];
+/** Whether the ISO day sits strictly inside the range (not start/end). */
+export const isRangeInner = (iso, selection, type) => {
+    if (type !== 'range' || selection.length < 2)
+        return false;
+    const [start, end] = selection;
+    return iso > start && iso < end;
+};
+/* -------------------------------------------------------------------------- */
+/*                               Selection ops                                */
+/* -------------------------------------------------------------------------- */
+/**
+ * Apply a click on `iso` and return the next selection.
+ *
+ * - single: always replace.
+ * - multi:  toggle (add if missing, remove if present).
+ * - range:  if there is no start OR a full range exists, start a new range;
+ *           otherwise complete the range (auto-sorted).
+ */
+export const applySelection = (iso, selection, type) => {
+    if (type === 'single')
+        return [iso];
+    if (type === 'multi') {
+        return selection.includes(iso) ? selection.filter((v) => v !== iso) : [...selection, iso].sort(compareISO);
+    }
+    // range
+    if (selection.length === 0 || selection.length === 2)
+        return [iso];
+    const [start, end] = sortRange(selection[0], iso);
+    return [start, end];
+};
+/**
+ * Build the highlighted range while the user is hovering with an in-progress
+ * range selection (`tentative` = the pending start).
+ */
+export const buildTentativeRange = (tentative, hovered) => {
+    if (!tentative || !hovered)
+        return [];
+    const [start, end] = sortRange(tentative, hovered);
+    return [start, end];
+};
+//# sourceMappingURL=selection.js.map

package/dist/collection/components/date-picker/helper/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TDatePickerType, TDatePrecision, TSelection } from '../bq-date-picker.types';\nimport { compareISO, isValidISO, sortRange } from './calendar';\n\n/* -------------------------------------------------------------------------- */\n/*                          Wire format parse/serialize                       */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Regex matching the wire-format ISO shape for each precision.\n * The internal selection is always `YYYY-MM-DD`; these only apply at the\n * public value boundary.\n */\nconst PRECISION_ISO_REGEX: Record<TDatePrecision, RegExp> = {\n  day: /^\\d{4}-\\d{2}-\\d{2}$/,\n  month: /^\\d{4}-\\d{2}$/,\n  year: /^\\d{4}$/,\n};\n\n/** Expand a wire-format token to a full `YYYY-MM-DD` ISO date. */\nconst expandToken = (token: string, precision: TDatePrecision): string => {\n  if (precision === 'month') return `${token}-01`;\n  if (precision === 'year') return `${token}-01-01`;\n  return token;\n};\n\n/** Truncate a full `YYYY-MM-DD` ISO date to the wire-format for the precision. */\nconst truncateISO = (iso: string, precision: TDatePrecision): string => {\n  if (precision === 'month') return iso.slice(0, 7);\n  if (precision === 'year') return iso.slice(0, 4);\n  return iso;\n};\n\n/**\n * Whether the token matches the precision-specific shape *and* is a real date.\n * For month/year we still expand to a full ISO date so `2026-13` / `2026-02-30`\n * style errors are caught by `isValidISO`.\n */\nconst isValidToken = (token: string, precision: TDatePrecision): boolean => {\n  if (!PRECISION_ISO_REGEX[precision].test(token)) return false;\n  return isValidISO(expandToken(token, precision));\n};\n\n/**\n * Parse a raw `value` string into an internal `TSelection` array.\n *\n * Wire format:\n * - single: `YYYY-MM-DD` (or `YYYY-MM` / `YYYY` at coarser precision)\n * - multi:  space-separated tokens\n * - range:  `<start>/<end>`\n *\n * Internally the selection is always stored as full `YYYY-MM-DD` — month\n * precision expands to the first day of the month; year precision to Jan 1st.\n *\n * Invalid tokens (malformed strings, impossible dates like `2026-99-99`,\n * non-ISO input) are silently discarded — the returned selection is\n * guaranteed to contain only valid ISO-8601 dates.\n */\nexport const parseValue = (\n  value: string | undefined | null,\n  type: TDatePickerType,\n  precision: TDatePrecision = 'day',\n): TSelection => {\n  if (!value) return [];\n  const trimmed = value.trim();\n  if (!trimmed) return [];\n\n  if (type === 'range') {\n    const parts = trimmed\n      .split('/')\n      .filter((token) => isValidToken(token, precision))\n      .map((token) => expandToken(token, precision));\n    if (parts.length === 0) return [];\n    if (parts.length === 1) return [parts[0]];\n    const [start, end] = sortRange(parts[0], parts[1]);\n    return [start, end];\n  }\n\n  if (type === 'multi') {\n    const valid = trimmed\n      .split(/\\s+/)\n      .filter((token) => isValidToken(token, precision))\n      .map((token) => expandToken(token, precision));\n    return Array.from(new Set(valid)).sort(compareISO);\n  }\n\n  return isValidToken(trimmed, precision) ? [expandToken(trimmed, precision)] : [];\n};\n\n/**\n * Serialize an internal `TSelection` array back to the wire format.\n * Truncates each entry to the precision's ISO shape.\n */\nexport const serializeValue = (\n  selection: TSelection,\n  type: TDatePickerType,\n  precision: TDatePrecision = 'day',\n): string => {\n  if (!selection.length) return '';\n  const format = (iso: string) => truncateISO(iso, precision);\n\n  if (type === 'range') {\n    if (selection.length < 2) return format(selection[0] ?? '');\n    const [start, end] = sortRange(selection[0], selection[1]);\n    return `${format(start)}/${format(end)}`;\n  }\n\n  if (type === 'multi') {\n    return Array.from(new Set(selection.map(format)))\n      .sort(compareISO)\n      .join(' ');\n  }\n\n  return format(selection[0]);\n};\n\n/* -------------------------------------------------------------------------- */\n/*                                Predicates                                  */\n/* -------------------------------------------------------------------------- */\n\n/** Whether the given ISO day is included in the selection. */\nexport const isSelected = (iso: string, selection: TSelection, type: TDatePickerType): boolean => {\n  if (!selection.length) return false;\n  if (type === 'range') {\n    if (selection.length < 2) return iso === selection[0];\n    const [start, end] = selection;\n    return iso >= start && iso <= end;\n  }\n  return selection.includes(iso);\n};\n\n/** Whether the ISO day is the start of a range selection. */\nexport const isRangeStart = (iso: string, selection: TSelection, type: TDatePickerType): boolean =>\n  type === 'range' && selection.length === 2 && iso === selection[0];\n\n/** Whether the ISO day is the end of a range selection. */\nexport const isRangeEnd = (iso: string, selection: TSelection, type: TDatePickerType): boolean =>\n  type === 'range' && selection.length === 2 && iso === selection[1];\n\n/** Whether the ISO day sits strictly inside the range (not start/end). */\nexport const isRangeInner = (iso: string, selection: TSelection, type: TDatePickerType): boolean => {\n  if (type !== 'range' || selection.length < 2) return false;\n  const [start, end] = selection;\n  return iso > start && iso < end;\n};\n\n/* -------------------------------------------------------------------------- */\n/*                               Selection ops                                */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Apply a click on `iso` and return the next selection.\n *\n * - single: always replace.\n * - multi:  toggle (add if missing, remove if present).\n * - range:  if there is no start OR a full range exists, start a new range;\n *           otherwise complete the range (auto-sorted).\n */\nexport const applySelection = (iso: string, selection: TSelection, type: TDatePickerType): TSelection => {\n  if (type === 'single') return [iso];\n\n  if (type === 'multi') {\n    return selection.includes(iso) ? selection.filter((v) => v !== iso) : [...selection, iso].sort(compareISO);\n  }\n\n  // range\n  if (selection.length === 0 || selection.length === 2) return [iso];\n  const [start, end] = sortRange(selection[0], iso);\n  return [start, end];\n};\n\n/**\n * Build the highlighted range while the user is hovering with an in-progress\n * range selection (`tentative` = the pending start).\n */\nexport const buildTentativeRange = (tentative: string | undefined, hovered: string | undefined): TSelection => {\n  if (!tentative || !hovered) return [];\n  const [start, end] = sortRange(tentative, hovered);\n  return [start, end];\n};\n"]}

package/dist/collection/components/date-picker/helper/value.js

@@ -0,0 +1,49 @@
+/*!
+ * Built by Endavans
+ * © https://beeq.design - Apache 2 License.
+ */
+import { formatDisplayValue, isDefined } from "../../../shared/utils";
+import { parseValue, serializeValue } from "./selection";
+/**
+ * Normalizes a raw public `value` string against the current picker `type`
+ * and `precision`.
+ *
+ * Runs the value through `parseValue`/`serializeValue` so any invalid ISO
+ * tokens are dropped before the value ever reaches the form, the display
+ * input, or the visible selection. Returns `undefined` when normalization
+ * leaves an empty string, so callers can distinguish "no value" from "empty
+ * string value".
+ */
+export const normalizeValue = (raw, type, precision = 'day') => {
+    const serialized = serializeValue(parseValue(raw, type, precision), type, precision);
+    return serialized === '' ? undefined : serialized;
+};
+/** Whether a value string is present and non-empty — used to drive UI affordances. */
+export const computeHasValue = (value) => isDefined(value) && `${value}`.length > 0;
+/**
+ * Formats the current value for display in the trigger input. Thin wrapper
+ * around `formatDisplayValue` that accepts `undefined` and coerces to an
+ * empty string, so callers don't have to repeat the null check.
+ *
+ * Precision-agnostic: internally the selection is stored as full ISO dates
+ * (the first day of the month / January 1st for coarser precisions), so
+ * `Intl.DateTimeFormat(locale, formatOptions)` produces the right label
+ * whether the user asked for `{ year: 'numeric' }` or `{ dateStyle: 'full' }`.
+ */
+export const computeDisplayDate = (value, type, locale, formatOptions, precision = 'day') => {
+    // Expand precision-truncated wire values back to full ISO so
+    // `formatDisplayValue` (which expects YYYY-MM-DD) can parse them.
+    const expanded = serializeValue(parseValue(value ?? '', type, precision), type, 'day');
+    return formatDisplayValue(expanded, type, locale, formatOptions);
+};
+/**
+ * Default `Intl.DateTimeFormat` options per precision.
+ * Applied when the consumer hasn't explicitly overridden `formatOptions`, so
+ * a `precision="month"` picker doesn't show "1 May 2026".
+ */
+export const DEFAULT_FORMAT_OPTIONS_BY_PRECISION = {
+    day: { day: 'numeric', month: 'short', year: 'numeric' },
+    month: { month: 'long', year: 'numeric' },
+    year: { year: 'numeric' },
+};
+//# sourceMappingURL=value.js.map

package/dist/collection/components/date-picker/helper/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../../../../../../packages/beeq/src/components/date-picker/helper/value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,GAAuB,EACvB,IAAqB,EACrB,YAA4B,KAAK,EACb,EAAE;IACtB,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACrF,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AACpD,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAyB,EAAW,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAEjH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAyB,EACzB,IAAqB,EACrB,MAA4B,EAC5B,aAAyC,EACzC,YAA4B,KAAK,EACb,EAAE;IACtB,6DAA6D;IAC7D,kEAAkE;IAClE,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvF,OAAO,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAuD;IACrG,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;IACxD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;IACzC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC1B,CAAC","sourcesContent":["import { formatDisplayValue, isDefined } from '../../../shared/utils';\nimport type { TDatePickerType, TDatePrecision } from '../bq-date-picker.types';\nimport { parseValue, serializeValue } from './selection';\n\n/**\n * Normalizes a raw public `value` string against the current picker `type`\n * and `precision`.\n *\n * Runs the value through `parseValue`/`serializeValue` so any invalid ISO\n * tokens are dropped before the value ever reaches the form, the display\n * input, or the visible selection. Returns `undefined` when normalization\n * leaves an empty string, so callers can distinguish \"no value\" from \"empty\n * string value\".\n */\nexport const normalizeValue = (\n  raw: string | undefined,\n  type: TDatePickerType,\n  precision: TDatePrecision = 'day',\n): string | undefined => {\n  const serialized = serializeValue(parseValue(raw, type, precision), type, precision);\n  return serialized === '' ? undefined : serialized;\n};\n\n/** Whether a value string is present and non-empty — used to drive UI affordances. */\nexport const computeHasValue = (value: string | undefined): boolean => isDefined(value) && `${value}`.length > 0;\n\n/**\n * Formats the current value for display in the trigger input. Thin wrapper\n * around `formatDisplayValue` that accepts `undefined` and coerces to an\n * empty string, so callers don't have to repeat the null check.\n *\n * Precision-agnostic: internally the selection is stored as full ISO dates\n * (the first day of the month / January 1st for coarser precisions), so\n * `Intl.DateTimeFormat(locale, formatOptions)` produces the right label\n * whether the user asked for `{ year: 'numeric' }` or `{ dateStyle: 'full' }`.\n */\nexport const computeDisplayDate = (\n  value: string | undefined,\n  type: TDatePickerType,\n  locale: Intl.LocalesArgument,\n  formatOptions: Intl.DateTimeFormatOptions,\n  precision: TDatePrecision = 'day',\n): string | undefined => {\n  // Expand precision-truncated wire values back to full ISO so\n  // `formatDisplayValue` (which expects YYYY-MM-DD) can parse them.\n  const expanded = serializeValue(parseValue(value ?? '', type, precision), type, 'day');\n  return formatDisplayValue(expanded, type, locale, formatOptions);\n};\n\n/**\n * Default `Intl.DateTimeFormat` options per precision.\n * Applied when the consumer hasn't explicitly overridden `formatOptions`, so\n * a `precision=\"month\"` picker doesn't show \"1 May 2026\".\n */\nexport const DEFAULT_FORMAT_OPTIONS_BY_PRECISION: Record<TDatePrecision, Intl.DateTimeFormatOptions> = {\n  day: { day: 'numeric', month: 'short', year: 'numeric' },\n  month: { month: 'long', year: 'numeric' },\n  year: { year: 'numeric' },\n};\n"]}