{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "date-picker",
  "type": "registry:ui",
  "title": "Date Picker",
  "description": "Date Picker is a date-only field with editable D MMM YYYY text entry (en-GB) and calendar popover for single-date selection.",
  "author": "Skrewww",
  "dependencies": [
    "@phosphor-icons/react"
  ],
  "registryDependencies": [
    "@skrewww/calendar-grid",
    "@skrewww/popover",
    "@skrewww/form-field",
    "@skrewww/foundation"
  ],
  "docs": "Host requirements (assumed already present, not installed by this command): react, react-dom.",
  "files": [
    {
      "path": "components/ui/DatePicker.tsx",
      "content": "/** @skrewww-component date-picker */\n\"use client\";\n\nimport { CalendarBlank } from \"@phosphor-icons/react\";\nimport {\n  useCallback,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type KeyboardEvent,\n  type MouseEvent,\n  type RefObject,\n} from \"react\";\nimport { CalendarGrid } from \"@/components/ui/CalendarGrid\";\nimport { FormField } from \"@/components/ui/FormField\";\nimport {\n  Popover,\n  PopoverBody,\n  PopoverContent,\n  PopoverTrigger,\n} from \"@/components/ui/Popover\";\nimport { TextInputControl } from \"@/components/ui/TextInputControl\";\nimport { cn } from \"@/lib/cn\";\nimport {\n  CALENDAR_DEFAULT_LOCALE,\n  CALENDAR_DEFAULT_WEEK_STARTS_ON,\n  formatDisplayDate,\n  getMonthFromDate,\n  getTodayCalendarDate,\n  isDateWithinRange,\n  parseCalendarDate,\n  parseDisplayDate,\n  warnIfFormatterPairIncomplete,\n  type CalendarDateString,\n  type CalendarFormatterOverrides,\n  type CalendarMonthParts,\n} from \"@/components/ui/internal/calendar-date\";\nimport { useControllableState } from \"@/lib/use-controllable\";\nimport styles from \"@/components/ui/date-picker.module.css\";\n\nconst OUT_OF_RANGE_MESSAGE = \"Choose a date within the allowed range.\";\nconst DISABLED_DATE_MESSAGE = \"This date is not available.\";\nconst REQUIRED_MESSAGE = \"This field is required.\";\n\nexport type DatePickerProps = {\n  label: string;\n  value?: CalendarDateString;\n  defaultValue?: CalendarDateString;\n  onValueChange?: (value: CalendarDateString | undefined) => void;\n  name?: string;\n  id?: string;\n  required?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  error?: string;\n  supportingText?: string;\n  hideLabel?: boolean;\n  placeholder?: string;\n  className?: string;\n  minDate?: CalendarDateString;\n  maxDate?: CalendarDateString;\n  isDateDisabled?: (date: CalendarDateString) => boolean;\n  locale?: string;\n  weekStartsOn?: 0 | 1;\n} & CalendarFormatterOverrides;\n\nfunction formatInputValue(\n  date: CalendarDateString | undefined,\n  locale: string,\n  formatDate?: (date: CalendarDateString) => string,\n): string {\n  if (!date) return \"\";\n  return formatDate?.(date) ?? formatDisplayDate(date, locale);\n}\n\nfunction invalidFormatMessage(\n  locale: string,\n  formatDate?: (date: CalendarDateString) => string,\n): string {\n  if (formatDate) {\n    return `Enter a date like ${formatDate(\"2026-07-11\")}.`;\n  }\n  return `Enter a date like ${formatDisplayDate(\"2026-07-11\", locale)}.`;\n}\n\nfunction resolveInitialVisibleMonth(\n  date: CalendarDateString | undefined,\n): CalendarMonthParts {\n  if (date && parseCalendarDate(date)) {\n    return getMonthFromDate(date);\n  }\n  return getMonthFromDate(getTodayCalendarDate());\n}\n\nexport function DatePicker(props: DatePickerProps) {\n  const valueProvided = \"value\" in props;\n  const {\n    label,\n    value,\n    defaultValue,\n    onValueChange,\n    name,\n    id,\n    required = false,\n    disabled = false,\n    readOnly = false,\n    error,\n    supportingText,\n    hideLabel = false,\n    placeholder = \"Select a date\",\n    className,\n    minDate,\n    maxDate,\n    isDateDisabled,\n    locale = CALENDAR_DEFAULT_LOCALE,\n    weekStartsOn = CALENDAR_DEFAULT_WEEK_STARTS_ON,\n    formatMonth,\n    formatWeekday,\n    formatDate,\n    parseDate,\n  } = props;\n  useEffect(() => {\n    warnIfFormatterPairIncomplete({ formatMonth, formatWeekday, formatDate, parseDate });\n  }, [formatDate, formatMonth, formatWeekday, parseDate]);\n\n  const generatedId = useId();\n  const controlId = id ?? generatedId;\n  const calendarButtonId = `${controlId}-calendar-button`;\n  const initialFocusRef = useRef<HTMLButtonElement | null>(null);\n  const calendarButtonRef = useRef<HTMLButtonElement | null>(null);\n  const [open, setOpen] = useState(false);\n\n  const calendarPopoverId = `${controlId}-calendar-popover`;\n\n  const [selectedDate, setSelectedDate] = useControllableState<CalendarDateString | undefined>({\n    value,\n    defaultValue,\n    onChange: onValueChange,\n    valueProvided,\n  });\n\n  const [inputText, setInputText] = useState(() =>\n    formatInputValue(defaultValue ?? value, locale, formatDate),\n  );\n  const [internalError, setInternalError] = useState<string | undefined>();\n  const [visibleMonth, setVisibleMonth] = useState<CalendarMonthParts>(() =>\n    resolveInitialVisibleMonth(defaultValue ?? value),\n  );\n\n  const [valueSync, setValueSync] = useState<{\n    value: CalendarDateString | undefined;\n    locale: string;\n    formatDate: typeof formatDate;\n  } | null>(() =>\n    valueProvided ? { value, locale, formatDate } : null,\n  );\n  if (valueProvided) {\n    const changed =\n      valueSync == null ||\n      valueSync.value !== value ||\n      valueSync.locale !== locale ||\n      valueSync.formatDate !== formatDate;\n    if (changed) {\n      setValueSync({ value, locale, formatDate });\n      setInputText(formatInputValue(value, locale, formatDate));\n      setInternalError(undefined);\n      if (value) {\n        setVisibleMonth(getMonthFromDate(value));\n      }\n    }\n  }\n\n  const wasOpenRef = useRef(open);\n  useEffect(() => {\n    // Popover's own close-time focus restore targets the PopoverTrigger\n    // wrapper (the plain <div> below) via requestClose's `restoreFocus`\n    // option, but that div isn't focusable — the actual interactive trigger\n    // is the calendar icon button nested inside it. Restore focus there\n    // explicitly whenever the popover transitions from open to closed\n    // (Escape, outside click, or a completed selection all go through this).\n    if (wasOpenRef.current && !open) {\n      calendarButtonRef.current?.focus();\n    }\n    wasOpenRef.current = open;\n  }, [open]);\n\n  const parseInputText = useCallback(\n    (text: string) => parseDate?.(text) ?? parseDisplayDate(text, locale),\n    [locale, parseDate],\n  );\n\n  const formatSelectedDate = useCallback(\n    (date: CalendarDateString) => formatDate?.(date) ?? formatDisplayDate(date, locale),\n    [formatDate, locale],\n  );\n\n  const fieldError = error ?? internalError;\n\n  const handleOpenChange = useCallback(\n    (next: boolean) => {\n      if ((disabled || readOnly) && next) return;\n      setOpen(next);\n    },\n    [disabled, readOnly],\n  );\n\n  const commitInputText = useCallback(\n    (text: string) => {\n      const trimmed = text.trim();\n\n      if (!trimmed) {\n        if (required) {\n          setInternalError(REQUIRED_MESSAGE);\n          return;\n        }\n        setInternalError(undefined);\n        setSelectedDate(undefined);\n        return;\n      }\n\n      const parsed = parseInputText(trimmed);\n      if (!parsed) {\n        setInternalError(invalidFormatMessage(locale, formatDate));\n        return;\n      }\n\n      if (!isDateWithinRange(parsed, minDate, maxDate)) {\n        setInternalError(OUT_OF_RANGE_MESSAGE);\n        return;\n      }\n\n      if (isDateDisabled?.(parsed)) {\n        setInternalError(DISABLED_DATE_MESSAGE);\n        return;\n      }\n\n      setInternalError(undefined);\n      setSelectedDate(parsed);\n      setVisibleMonth(getMonthFromDate(parsed));\n      setInputText(formatSelectedDate(parsed));\n    },\n    [\n      formatDate,\n      formatSelectedDate,\n      isDateDisabled,\n      locale,\n      maxDate,\n      minDate,\n      parseInputText,\n      required,\n      setSelectedDate,\n    ],\n  );\n\n  const handleInputChange = useCallback((event: ChangeEvent<HTMLInputElement>) => {\n    setInputText(event.target.value);\n    if (internalError) {\n      setInternalError(undefined);\n    }\n  }, [internalError]);\n\n  const handleInputBlur = useCallback(() => {\n    if (disabled || readOnly) return;\n    commitInputText(inputText);\n  }, [commitInputText, disabled, inputText, readOnly]);\n\n  const handleInputKeyDown = useCallback(\n    (event: KeyboardEvent<HTMLInputElement>) => {\n      event.stopPropagation();\n      if (event.key === \"Enter\") {\n        event.preventDefault();\n        commitInputText(inputText);\n      }\n    },\n    [commitInputText, inputText],\n  );\n\n  const handleGridSelect = useCallback(\n    (date: CalendarDateString) => {\n      setSelectedDate(date);\n      setInputText(formatSelectedDate(date));\n      setInternalError(undefined);\n      setVisibleMonth(getMonthFromDate(date));\n      setOpen(false);\n    },\n    [formatSelectedDate, setSelectedDate],\n  );\n\n  const handleCalendarButtonClick = useCallback(\n    (event: MouseEvent<HTMLButtonElement>) => {\n      event.preventDefault();\n      handleOpenChange(!open);\n    },\n    [handleOpenChange, open],\n  );\n\n  const handleTriggerPointerDown = useCallback((event: MouseEvent<HTMLDivElement>) => {\n    const target = event.target as HTMLElement;\n    if (target.closest(\"input\") || target.closest(\"button\")) {\n      event.preventDefault();\n    }\n  }, []);\n\n  const initialFocusDate =\n    selectedDate && parseCalendarDate(selectedDate)\n      ? selectedDate\n      : getTodayCalendarDate();\n\n  return (\n    <FormField\n      label={label}\n      controlId={controlId}\n      required={required}\n      hideLabel={hideLabel}\n      supportingText={supportingText}\n      error={fieldError}\n    >\n      {({ controlId: fieldId, describedBy, invalid }) => (\n        <Popover open={open} onOpenChange={handleOpenChange} focusMode=\"content\" contentId={calendarPopoverId}>\n          <PopoverTrigger>\n            <div\n              className={cn(styles.root, className)}\n              onClick={handleTriggerPointerDown}\n            >\n              <TextInputControl\n                id={fieldId}\n                readOnly={readOnly}\n                disabled={disabled}\n                required={required}\n                aria-invalid={invalid || undefined}\n                aria-describedby={describedBy}\n                aria-haspopup=\"grid\"\n                placeholder={placeholder}\n                value={readOnly ? formatInputValue(selectedDate, locale, formatDate) : inputText}\n                onChange={readOnly ? undefined : handleInputChange}\n                onBlur={readOnly ? undefined : handleInputBlur}\n                onKeyDown={readOnly ? undefined : handleInputKeyDown}\n                trailingAction={\n                  <button\n                    ref={calendarButtonRef}\n                    id={calendarButtonId}\n                    type=\"button\"\n                    className={styles.calendarButton}\n                    aria-label=\"Open calendar\"\n                    aria-expanded={open}\n                    aria-controls={open ? calendarPopoverId : undefined}\n                    disabled={disabled || readOnly}\n                    onClick={handleCalendarButtonClick}\n                  >\n                    <CalendarBlank size={18} aria-hidden=\"true\" />\n                  </button>\n                }\n              />\n              {name ? (\n                <input type=\"hidden\" name={name} value={selectedDate ?? \"\"} disabled={disabled} />\n              ) : null}\n            </div>\n          </PopoverTrigger>\n          {/*\n            matchTriggerWidth is intentionally off: the calendar grid has a fixed\n            natural width (--calendar-grid-width) wider than most single-line inputs.\n            Pinning to the trigger would squeeze the 7-column grid and clip day cells.\n          */}\n          <PopoverContent\n            id={calendarPopoverId}\n            initialFocusRef={initialFocusRef as RefObject<HTMLElement | null>}\n            className={styles.popover}\n          >\n            <PopoverBody>\n              <CalendarGrid\n                aria-label=\"Choose date\"\n                value={selectedDate}\n                onValueChange={handleGridSelect}\n                visibleMonth={visibleMonth}\n                onVisibleMonthChange={setVisibleMonth}\n                initialFocusDate={initialFocusDate}\n                minDate={minDate}\n                maxDate={maxDate}\n                isDateDisabled={isDateDisabled}\n                locale={locale}\n                weekStartsOn={weekStartsOn}\n                formatMonth={formatMonth}\n                formatWeekday={formatWeekday}\n                dayButtonRef={initialFocusRef}\n              />\n            </PopoverBody>\n          </PopoverContent>\n        </Popover>\n      )}\n    </FormField>\n  );\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/DatePicker.tsx"
    },
    {
      "path": "components/ui/date-picker.module.css",
      "content": ".root {\n  position: relative;\n  display: block;\n  width: 100%;\n  min-width: 0;\n}\n\n.calendarButton {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--date-picker-trigger-icon-size);\n  height: var(--date-picker-trigger-icon-size);\n  border: 0;\n  border-radius: min(var(--shape-radius-control), 9999px);\n  background: transparent;\n  color: var(--semantic-icon-muted);\n  cursor: pointer;\n}\n\n.calendarButton:focus {\n  outline: none;\n}\n\n.calendarButton:focus-visible {\n  outline: 2px solid var(--semantic-focus-ring);\n  outline-offset: 2px;\n}\n\n.calendarButton:disabled {\n  cursor: not-allowed;\n  opacity: var(--opacity-disabled);\n}\n\n/* Double class beats canonical Popover Card-rim / no-elevation / lg blur.\n * Date Picker calendar is a field shell, not the rich Popover overlay. */\n.popover.popover {\n  box-sizing: border-box;\n  width: auto;\n  max-width: min(\n    var(--calendar-grid-width),\n    calc(100vw - (var(--popover-viewport-padding) * 2))\n  );\n  padding: 0;\n  overflow: hidden;\n  background: var(--popover-surface);\n  border: 1px solid var(--popover-border);\n  box-shadow: var(--popover-elevation);\n  backdrop-filter: none;\n}\n\n:global([data-skrewww-surface=\"glass\"]) .popover.popover {\n  background: color-mix(in srgb, var(--popover-surface) var(--glass-mix-md), white);\n  border: 1px solid var(--popover-border);\n  box-shadow: var(--popover-elevation);\n  backdrop-filter: var(--glass-backdrop-filter-md);\n}\n\n@supports not (backdrop-filter: blur(1px)) {\n  :global([data-skrewww-surface=\"glass\"]) .popover.popover {\n    background: color-mix(in srgb, var(--popover-surface) var(--glass-mix-md-fallback), white);\n  }\n}\n\n.popover :global([class*=\"body\"]) {\n  padding: 0;\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/date-picker.module.css"
    },
    {
      "path": "lib/cn.ts",
      "content": "export function cn(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(\" \");\n}\n",
      "type": "registry:lib",
      "target": "~/lib/cn.ts"
    },
    {
      "path": "lib/use-controllable.ts",
      "content": "import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n  controlled: controlledProp,\n  valueProvided,\n}: {\n  value?: T;\n  defaultValue?: T;\n  onChange?: (next: T) => void;\n  /** Explicit controlled override — prefer `valueProvided` from the component root. */\n  controlled?: boolean;\n  /** True when the parent passed a `value` prop, including `undefined`. */\n  valueProvided?: boolean;\n}) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue as T);\n  const isControlled = controlledProp ?? valueProvided ?? value !== undefined;\n  const current = isControlled ? (value as T) : uncontrolled;\n  const wasControlledRef = useRef(isControlled);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") return;\n    if (wasControlledRef.current !== isControlled) {\n      console.warn(\n        \"[Skrewww] A component changed between controlled and uncontrolled modes. Keep `value` or `defaultValue` usage consistent across renders.\",\n      );\n    }\n    wasControlledRef.current = isControlled;\n  }, [isControlled]);\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) setUncontrolled(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange],\n  );\n\n  return [current, setValue] as const;\n}\n",
      "type": "registry:lib",
      "target": "~/lib/use-controllable.ts"
    },
    {
      "path": "components/ui/TextInputControl.tsx",
      "content": "\"use client\";\n\nimport { forwardRef, type InputHTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport styles from \"@/components/ui/text-input.module.css\";\n\nexport type TextInputControlSize = \"sm\" | \"md\" | \"lg\";\n\nexport type TextInputControlProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"size\"\n> & {\n  size?: TextInputControlSize;\n  leadingIcon?: ReactNode;\n  trailingIcon?: ReactNode;\n  trailingAction?: ReactNode;\n};\n\nconst sizeClass: Record<TextInputControlSize, string> = {\n  sm: styles.sizeSm,\n  md: styles.sizeMd,\n  lg: styles.sizeLg,\n};\n\n/** Control-only single-line input — compose with FormField for label and validation. */\nexport const TextInputControl = forwardRef<HTMLInputElement, TextInputControlProps>(\n  function TextInputControl(\n    {\n      size = \"md\",\n      leadingIcon,\n      trailingIcon,\n      trailingAction,\n      className,\n      disabled,\n      required,\n      readOnly,\n      ...props\n    },\n    ref,\n  ) {\n    return (\n      <div className={cn(styles.controlWrap, className)}>\n        {leadingIcon ? (\n          <span className={styles.leading} aria-hidden=\"true\">\n            {leadingIcon}\n          </span>\n        ) : null}\n\n        <input\n          ref={ref}\n          className={cn(\n            styles.input,\n            sizeClass[size],\n            leadingIcon ? styles.withLeading : undefined,\n            trailingIcon || trailingAction ? styles.withTrailing : undefined,\n          )}\n          disabled={disabled}\n          readOnly={readOnly}\n          required={required}\n          aria-required={required || undefined}\n          {...props}\n        />\n\n        {trailingAction ? (\n          <span className={styles.trailingAction}>{trailingAction}</span>\n        ) : trailingIcon ? (\n          <span className={styles.trailing} aria-hidden=\"true\">\n            {trailingIcon}\n          </span>\n        ) : null}\n      </div>\n    );\n  },\n);\n",
      "type": "registry:ui",
      "target": "~/components/ui/TextInputControl.tsx"
    },
    {
      "path": "components/ui/text-input.module.css",
      "content": ".controlWrap {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n}\n\n.input {\n  width: 100%;\n  border: 1px solid var(--semantic-border-default);\n  border-radius: var(--shape-radius-control);\n  /* TextInput wasn't in the originally-reported list of squircle consumers,\n     but it consumes --shape-radius-control via plain border-radius exactly\n     like Button/Checkbox/Drawer's close button — same bug, fixed the same\n     way, found while auditing the other 5. */\n  clip-path: var(--squircle-clip-path-control, none);\n  background-color: var(--surface-fill-control);\n  background-image: var(--component-surface-gradient-overlay);\n  backdrop-filter: var(--glass-backdrop-filter-sm, none);\n  color: var(--semantic-text-primary);\n  font-family: inherit;\n  line-height: 1.4;\n  transition:\n    border-color 0.15s ease,\n    box-shadow 0.15s ease;\n}\n\n.input::placeholder {\n  color: var(--semantic-text-disabled);\n}\n\n.input:hover:not(:disabled):not([aria-invalid=\"true\"]) {\n  border-color: var(--semantic-border-strong);\n}\n\n.input:focus {\n  outline: none;\n}\n\n.input:focus-visible {\n  border-color: var(--semantic-focus-ring);\n  box-shadow: 0 0 0 2px var(--semantic-focus-ring);\n}\n\n/* clip-path clips an outset box-shadow ring exactly like it clips outline\n   (same reasoning as Button/Checkbox) — an inset ring stays fully visible\n   since it never extends past the clip boundary. Squircle mode only; every\n   other shape mode keeps the outset ring above unchanged. */\n[data-skrewww-shape=\"squircle\"] .input:focus-visible {\n  box-shadow: inset 0 0 0 2px var(--semantic-focus-ring);\n}\n\n.input:disabled {\n  cursor: not-allowed;\n  pointer-events: none;\n  color: var(--semantic-text-disabled);\n  border-color: var(--semantic-border-disabled);\n  background-color: var(--semantic-surface-disabled);\n  opacity: var(--opacity-disabled);\n}\n\n.input:read-only:not(:disabled) {\n  background-color: var(--semantic-surface-subtle);\n  cursor: default;\n}\n\n.input[aria-invalid=\"true\"] {\n  border-color: var(--semantic-action-danger);\n}\n\n.input[aria-invalid=\"true\"]:focus-visible {\n  box-shadow: 0 0 0 2px var(--semantic-action-danger);\n}\n\n[data-skrewww-shape=\"squircle\"] .input[aria-invalid=\"true\"]:focus-visible {\n  box-shadow: inset 0 0 0 2px var(--semantic-action-danger);\n}\n\n.input[type=\"search\"]::-webkit-search-cancel-button {\n  -webkit-appearance: none;\n  appearance: none;\n  display: none;\n}\n\n.sizeSm {\n  min-height: var(--control-height-sm);\n  padding: 0 var(--control-padding-x-sm);\n  font-size: var(--control-font-size-sm);\n}\n\n.sizeMd {\n  min-height: var(--control-height-md);\n  padding: 0 var(--control-padding-x-md);\n  font-size: var(--control-font-size-md);\n}\n\n.sizeLg {\n  min-height: var(--control-height-lg);\n  padding: 0 var(--control-padding-x-lg);\n  font-size: var(--control-font-size-lg);\n}\n\n.withLeading {\n  padding-left: 2.25rem;\n}\n\n.withTrailing {\n  padding-right: 2.25rem;\n}\n\n.leading,\n.trailing {\n  position: absolute;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--semantic-icon-muted);\n  pointer-events: none;\n}\n\n.leading {\n  left: 0.75rem;\n}\n\n.trailing {\n  right: 0.75rem;\n  pointer-events: auto;\n}\n\n.trailingAction {\n  position: absolute;\n  right: 0.25rem;\n  display: inline-flex;\n  align-items: center;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .input {\n    transition: none;\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/text-input.module.css"
    },
    {
      "path": "components/ui/internal/calendar-date.ts",
      "content": "/** Date-only value in ISO YYYY-MM-DD form — never includes time or time zone. */\nexport type CalendarDateString = string;\n\nexport type CalendarDateParts = {\n  year: number;\n  month: number;\n  day: number;\n};\n\nexport type CalendarMonthParts = {\n  year: number;\n  month: number;\n};\n\n/** Range mode's value shape. Either end may be unset while a selection is in progress. */\nexport type CalendarDateRange = {\n  start: CalendarDateString | undefined;\n  end: CalendarDateString | undefined;\n};\n\nconst ISO_DATE_RE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/** Default display/accessibility locale for the first Calendar batch. */\nexport const CALENDAR_DEFAULT_LOCALE = \"en-GB\";\n\n/** Initial week-start policy: Monday (ISO). */\nexport const CALENDAR_DEFAULT_WEEK_STARTS_ON = 1 as const;\n\nexport type CalendarFormatterOverrides = {\n  formatMonth?: (month: CalendarMonthParts) => string;\n  formatWeekday?: (dayIndex: number) => string;\n  formatDate?: (date: CalendarDateString) => string;\n  parseDate?: (text: string) => CalendarDateString | null;\n};\n\nconst warnedInvalidLocales = new Set<string>();\n\n/** Resolve a requested locale, falling back to en-GB when Intl rejects it. */\nexport function resolveCalendarLocale(locale?: string): string {\n  const requested = locale ?? CALENDAR_DEFAULT_LOCALE;\n  if (requested === CALENDAR_DEFAULT_LOCALE) return CALENDAR_DEFAULT_LOCALE;\n\n  try {\n    if (typeof Intl.DateTimeFormat.supportedLocalesOf === \"function\") {\n      const supported = Intl.DateTimeFormat.supportedLocalesOf([requested]);\n      if (supported.length === 0) throw new RangeError(`Unsupported locale: ${requested}`);\n      return supported[0] ?? CALENDAR_DEFAULT_LOCALE;\n    }\n    new Intl.DateTimeFormat(requested).format(new Date());\n    return requested;\n  } catch {\n    if (process.env.NODE_ENV !== \"production\" && !warnedInvalidLocales.has(requested)) {\n      warnedInvalidLocales.add(requested);\n      console.warn(\n        `[calendar] Invalid locale \"${requested}\", falling back to \"${CALENDAR_DEFAULT_LOCALE}\".`,\n      );\n    }\n    return CALENDAR_DEFAULT_LOCALE;\n  }\n}\n\n/** Dev-only guard when only one of formatDate / parseDate is supplied. */\nexport function warnIfFormatterPairIncomplete(overrides: CalendarFormatterOverrides): void {\n  if (process.env.NODE_ENV === \"production\") return;\n  const hasFormat = Boolean(overrides.formatDate);\n  const hasParse = Boolean(overrides.parseDate);\n  if (hasFormat !== hasParse) {\n    console.warn(\n      \"[calendar] formatDate and parseDate must both be provided when overriding date text formatting.\",\n    );\n  }\n}\n\nfunction createDateTimeFormat(\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): Intl.DateTimeFormat {\n  const resolved = resolveCalendarLocale(locale);\n  return new Intl.DateTimeFormat(resolved, options);\n}\n\nexport function isValidCalendarDateParts(parts: CalendarDateParts): boolean {\n  if (!Number.isInteger(parts.year) || parts.year < 1) return false;\n  if (parts.month < 1 || parts.month > 12) return false;\n  if (parts.day < 1) return false;\n  return parts.day <= daysInMonth(parts.year, parts.month);\n}\n\nexport function daysInMonth(year: number, month: number): number {\n  return new Date(year, month, 0).getDate();\n}\n\nexport function parseCalendarDate(value: string): CalendarDateParts | null {\n  const match = ISO_DATE_RE.exec(value);\n  if (!match) return null;\n  const parts = {\n    year: Number(match[1]),\n    month: Number(match[2]),\n    day: Number(match[3]),\n  };\n  return isValidCalendarDateParts(parts) ? parts : null;\n}\n\nexport function formatCalendarDate(parts: CalendarDateParts): CalendarDateString {\n  return `${String(parts.year).padStart(4, \"0\")}-${String(parts.month).padStart(2, \"0\")}-${String(parts.day).padStart(2, \"0\")}`;\n}\n\nexport function compareCalendarDates(a: CalendarDateString, b: CalendarDateString): number {\n  return a.localeCompare(b);\n}\n\nexport function calendarDateFromParts(parts: CalendarDateParts): CalendarDateString {\n  return formatCalendarDate(parts);\n}\n\nexport function getCalendarDateParts(date: CalendarDateString): CalendarDateParts {\n  const parsed = parseCalendarDate(date);\n  if (!parsed) {\n    throw new Error(`Invalid calendar date: ${date}`);\n  }\n  return parsed;\n}\n\n/** Local calendar arithmetic — avoids UTC conversion when adding days. */\nexport function addDays(date: CalendarDateString, delta: number): CalendarDateString {\n  const parts = getCalendarDateParts(date);\n  const local = new Date(parts.year, parts.month - 1, parts.day);\n  local.setDate(local.getDate() + delta);\n  return formatCalendarDate({\n    year: local.getFullYear(),\n    month: local.getMonth() + 1,\n    day: local.getDate(),\n  });\n}\n\nexport function addMonths(month: CalendarMonthParts, delta: number): CalendarMonthParts {\n  const index = month.year * 12 + (month.month - 1) + delta;\n  return {\n    year: Math.floor(index / 12),\n    month: (index % 12) + 1,\n  };\n}\n\nexport function getTodayCalendarDate(now = new Date()): CalendarDateString {\n  return formatCalendarDate({\n    year: now.getFullYear(),\n    month: now.getMonth() + 1,\n    day: now.getDate(),\n  });\n}\n\nexport function getMonthFromDate(date: CalendarDateString): CalendarMonthParts {\n  const parts = getCalendarDateParts(date);\n  return { year: parts.year, month: parts.month };\n}\n\nexport function formatMonthLabel(\n  month: CalendarMonthParts,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n): string {\n  return createDateTimeFormat(locale, { month: \"long\", year: \"numeric\" }).format(\n    new Date(month.year, month.month - 1, 1),\n  );\n}\n\n/** Month name only (no year) — used to label cells in the month drill-up grid. */\nexport function formatMonthNameLabel(\n  month: number,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n): string {\n  return createDateTimeFormat(locale, { month: \"long\" }).format(new Date(2021, month - 1, 1));\n}\n\nexport function formatDisplayDate(\n  date: CalendarDateString,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n): string {\n  const parts = getCalendarDateParts(date);\n  return createDateTimeFormat(locale, {\n    day: \"numeric\",\n    month: \"short\",\n    year: \"numeric\",\n  }).format(new Date(parts.year, parts.month - 1, parts.day));\n}\n\n/** Short month abbreviations keyed lowercase — built from the same Intl locale as formatDisplayDate. */\nfunction buildDisplayMonthAbbrevMap(locale: string): Map<string, number> {\n  const resolved = resolveCalendarLocale(locale);\n  const map = new Map<string, number>();\n\n  function registerAbbrev(raw: string, month: number) {\n    const lower = raw.toLowerCase();\n    map.set(lower, month);\n    map.set(lower.replace(/\\.$/, \"\"), month);\n  }\n\n  for (let month = 1; month <= 12; month += 1) {\n    registerAbbrev(\n      new Intl.DateTimeFormat(resolved, { month: \"short\" }).format(new Date(2021, month - 1, 1)),\n      month,\n    );\n\n    // Month token inside a full date string can differ from standalone month: \"short\"\n    // (e.g. de-DE uses \"Juli\" in dates but \"Jul\" standalone).\n    const inContext = createDateTimeFormat(resolved, {\n      day: \"numeric\",\n      month: \"short\",\n      year: \"numeric\",\n    }).format(new Date(2021, month - 1, 15));\n    const yearMatch = /(\\d{4})\\s*$/.exec(inContext);\n    if (yearMatch) {\n      const prefix = inContext.slice(0, yearMatch.index).trim();\n      const dayMatch = /^(\\d{1,2})/.exec(prefix);\n      if (dayMatch) {\n        const rest = prefix.slice(dayMatch[0].length);\n        const contextMonth = rest.match(/[A-Za-zÀ-ÿ][A-Za-zÀ-ÿ.]*/)?.[0];\n        if (contextMonth) registerAbbrev(contextMonth, month);\n      }\n    }\n  }\n  return map;\n}\n\nconst displayMonthAbbrevCache = new Map<string, Map<string, number>>();\n\nfunction getDisplayMonthAbbrevMap(locale: string): Map<string, number> {\n  const resolved = resolveCalendarLocale(locale);\n  const cached = displayMonthAbbrevCache.get(resolved);\n  if (cached) return cached;\n  const built = buildDisplayMonthAbbrevMap(resolved);\n  displayMonthAbbrevCache.set(resolved, built);\n  return built;\n}\n\nfunction normalizeMonthToken(token: string): string {\n  return token.toLowerCase().replace(/\\.$/, \"\").trim();\n}\n\nfunction lookupDisplayMonth(monthMap: Map<string, number>, token: string): number | undefined {\n  return monthMap.get(token.toLowerCase()) ?? monthMap.get(normalizeMonthToken(token));\n}\n\n/**\n * Parse a display-formatted date string back to ISO YYYY-MM-DD.\n * Accepts the D MMM YYYY pattern produced by formatDisplayDate for the given locale.\n * Does not accept numeric-only regional formats (DD/MM, MM/DD, etc.).\n */\nexport function parseDisplayDate(\n  text: string,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n): CalendarDateString | null {\n  const trimmed = text.trim();\n  if (!trimmed) return null;\n\n  const resolvedLocale = resolveCalendarLocale(locale);\n  const yearMatch = /(\\d{4})\\s*$/.exec(trimmed);\n  if (!yearMatch) return null;\n\n  const year = Number(yearMatch[1]);\n  const prefix = trimmed.slice(0, yearMatch.index).trim();\n  const dayMatch = /^(\\d{1,2})/.exec(prefix);\n  if (!dayMatch) return null;\n\n  const day = Number(dayMatch[1]);\n  const rest = prefix.slice(dayMatch[0].length);\n  const monthMatch = rest.match(/[A-Za-zÀ-ÿ][A-Za-zÀ-ÿ.]*/);\n  const monthRaw = monthMatch?.[0]?.trim();\n  if (!monthRaw) return null;\n\n  const month = lookupDisplayMonth(getDisplayMonthAbbrevMap(resolvedLocale), monthRaw);\n  if (!month) return null;\n\n  const parts = { year, month, day };\n  return isValidCalendarDateParts(parts) ? formatCalendarDate(parts) : null;\n}\n\nexport function formatAccessibleDateLabel(\n  date: CalendarDateString,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n): string {\n  const parts = getCalendarDateParts(date);\n  return createDateTimeFormat(locale, {\n    day: \"numeric\",\n    month: \"long\",\n    year: \"numeric\",\n  }).format(new Date(parts.year, parts.month - 1, parts.day));\n}\n\nexport function formatWeekdayLabel(\n  weekdayIndex: number,\n  locale: string = CALENDAR_DEFAULT_LOCALE,\n  weekStartsOn: 0 | 1 = CALENDAR_DEFAULT_WEEK_STARTS_ON,\n): string {\n  // Jan 3 2021 is a Sunday — anchor for weekday 0..6.\n  const weekday = (weekStartsOn + weekdayIndex) % 7;\n  const date = new Date(2021, 0, 3 + weekday);\n  return createDateTimeFormat(locale, { weekday: \"short\" }).format(date);\n}\n\nexport function getDayNumber(date: CalendarDateString): number {\n  return getCalendarDateParts(date).day;\n}\n\nexport function isSameCalendarMonth(\n  date: CalendarDateString,\n  month: CalendarMonthParts,\n): boolean {\n  const parts = getCalendarDateParts(date);\n  return parts.year === month.year && parts.month === month.month;\n}\n\nexport function clampDateToMonth(\n  date: CalendarDateString,\n  month: CalendarMonthParts,\n): CalendarDateString {\n  const parts = getCalendarDateParts(date);\n  const day = Math.min(parts.day, daysInMonth(month.year, month.month));\n  return formatCalendarDate({ year: month.year, month: month.month, day });\n}\n\n/** Whether `date` falls within [min, max], inclusive. Either bound is optional. */\nexport function isDateWithinRange(\n  date: CalendarDateString,\n  min?: CalendarDateString,\n  max?: CalendarDateString,\n): boolean {\n  if (min && compareCalendarDates(date, min) < 0) return false;\n  if (max && compareCalendarDates(date, max) > 0) return false;\n  return true;\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/calendar-date.ts"
    }
  ]
}
