@viasat/beam-react 2.73.0 → 2.75.0

package/lib/wip/Calendar/Calendar.Dates.d.ts

@@ -0,0 +1,12 @@
+import { CalendarDatesProps } from './Calendar.types';
+/**
+ * The date grid — owns the whole `<table>`, weekday header included.
+ *
+ * `Calendar.Days` renders `<thead>` and the rows render `<tbody>`, so neither
+ * is valid as a standalone sibling; keeping both under one owner means the
+ * markup is well-formed however the calendar is composed. They stay exported
+ * for Storybook `subcomponents` autodocs and the future `renderDay` hook, not
+ * as composition points — see the ADR's note that `Calendar.Date` is "exported
+ * but typically rendered by `Calendar.Dates`".
+ */
+export declare const Dates: import('react').ForwardRefExoticComponent<CalendarDatesProps & import('react').RefAttributes<HTMLTableElement>>;

package/lib/wip/Calendar/Calendar.Dates.es.js

@@ -0,0 +1,44 @@
+import { jsxs as f, jsx as a } from "react/jsx-runtime";
+import y from "clsx";
+import { forwardRef as D } from "react";
+import { s as r, a as e } from "../../../chunks/calendar.module.CXGuMNJB.js";
+import "../../../chunks/constants.XFX4nOSf.js";
+import { d as s } from "../../../chunks/dates.NqdbQ2fR.js";
+import { CalendarDate as b } from "./Calendar.Date.es.js";
+import { Days as h } from "./Calendar.Days.es.js";
+import { useCalendar as N } from "./Calendar.context.es.js";
+const v = D(
+  function({ className: m, ...i }, l) {
+    const { weeks: d, visibleMonth: n, navDirection: c, monthLabelId: p } = N();
+    return (
+      // The grid takes its name from the header's month label, so it announces
+      // as "July 2025 table" rather than an unnamed one. Placed before the
+      // spread so a consumer can still name it themselves.
+      /* @__PURE__ */ f(
+        "table",
+        {
+          "aria-labelledby": p,
+          ...i,
+          ref: l,
+          className: y(r[e.grid], m),
+          children: [
+            /* @__PURE__ */ a(h, {}),
+            /* @__PURE__ */ a(
+              "tbody",
+              {
+                "data-nav-direction": c ?? void 0,
+                className: r[e.dates],
+                children: d.map((t) => /* @__PURE__ */ a("tr", { className: r[e.week], children: t.map((o) => /* @__PURE__ */ a(b, { date: o }, s(o))) }, s(t[0])))
+              },
+              s(n)
+            )
+          ]
+        }
+      )
+    );
+  }
+);
+v.displayName = "Dates";
+export {
+  v as Dates
+};

package/lib/wip/Calendar/Calendar.Days.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),m=require("react"),a=require("../../../chunks/calendar.module.D0wrnDz0.js"),p=require("./Calendar.context.cjs.js"),r=require("./Calendar.utils.cjs.js"),t=m.forwardRef(function({className:n,...c},d){const{weekdayLabels:i,weekStart:s,locale:o}=p.useCalendar(),u=r.getWeekdayFullLabels(o,s);return e.jsx("thead",{...c,ref:d,className:n,children:e.jsx("tr",{children:i.map((y,l)=>e.jsxs("th",{scope:"col",className:a.styles[a.staticCalendarClassNames.day],children:[e.jsx("span",{"aria-hidden":"true",children:y}),e.jsx("span",{className:a.styles[a.staticCalendarClassNames.visuallyHidden],children:u[l]})]},r.wrapWeekday(s+l)))})})});t.displayName="Days";exports.Days=t;

package/lib/wip/Calendar/Calendar.Days.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The weekday header row. Native `<th scope="col">` is the C-1 baseline;
+ * explicit `role="columnheader"` arrives with the rest of the grid ARIA in C-11.
+ */
+export declare const Days: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, "ref"> & import('react').RefAttributes<HTMLTableSectionElement>>;

package/lib/wip/Calendar/Calendar.Days.es.js

@@ -0,0 +1,30 @@
+import { jsx as a, jsxs as p } from "react/jsx-runtime";
+import { forwardRef as f } from "react";
+import { s as r, a as l } from "../../../chunks/calendar.module.CXGuMNJB.js";
+import { useCalendar as y } from "./Calendar.context.es.js";
+import { getWeekdayFullLabels as h, wrapWeekday as u } from "./Calendar.utils.es.js";
+const k = f(
+  function({ className: t, ...o }, d) {
+    const { weekdayLabels: i, weekStart: e, locale: n } = y(), c = h(n, e);
+    return /* @__PURE__ */ a("thead", { ...o, ref: d, className: t, children: /* @__PURE__ */ a("tr", { children: i.map((m, s) => (
+      // Keyed by weekday number rather than the label: `short` names are
+      // not guaranteed unique across every locale.
+      /* @__PURE__ */ p(
+        "th",
+        {
+          scope: "col",
+          className: r[l.day],
+          children: [
+            /* @__PURE__ */ a("span", { "aria-hidden": "true", children: m }),
+            /* @__PURE__ */ a("span", { className: r[l.visuallyHidden], children: c[s] })
+          ]
+        },
+        u(e + s)
+      )
+    )) }) });
+  }
+);
+k.displayName = "Days";
+export {
+  k as Days
+};

package/lib/wip/Calendar/Calendar.Header.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),h=require("clsx"),C=require("react"),v=require("../../../chunks/ChevronLeftCurved.JKg9pOxN.js"),m=require("../../../chunks/ChevronRightCurved.CoT-Bqyo.js"),r=require("../../../chunks/calendar.module.D0wrnDz0.js"),b=require("../../Button/Button.cjs.js"),x=require("../../Icon/Icon.cjs.js"),g=require("./Calendar.context.cjs.js"),a=({icon:o,label:t,onClick:n})=>e.jsx(b.Button,{type:"button",appearance:"neutral",kind:"ghost",size:"md",iconOnly:!0,iconBefore:e.jsx(x.Icon,{icon:o}),"aria-label":t,onClick:n}),s=C.forwardRef(function({className:t,...n},i){const{monthLabel:l,monthLabelId:c,goToPreviousMonth:u,goToNextMonth:d}=g.useCalendar();return e.jsxs("div",{...n,ref:i,className:h(r.styles[r.staticCalendarClassNames.header],t),children:[e.jsx(a,{icon:v.SvgChevronLeftCurved,label:"Previous month",onClick:u}),e.jsx("span",{id:c,"aria-live":"polite",className:r.styles[r.staticCalendarClassNames.headerLabel],children:l}),e.jsx(a,{icon:m.SvgChevronRightCurved,label:"Next month",onClick:d})]})});s.displayName="Header";exports.Header=s;

package/lib/wip/Calendar/Calendar.Header.d.ts

@@ -0,0 +1,15 @@
+import { CalendarHeaderProps } from './Calendar.types';
+/**
+ * Month label with previous / next arrows.
+ *
+ * The arrows are Beam `<Button>`s rather than hand-rolled, which supplies the
+ * Figma `neutral/ghost` treatment, the 40×40 `md` sizing, and the `StateLayer`.
+ * Labels are hardcoded English until `ariaLabels` arrives with I-7.
+ *
+ * The label is a live region as well as the grid's accessible name. Paging the
+ * month replaces the grid's contents without moving focus — the arrow keeps it
+ * — so nothing else would tell a screen-reader user the month changed. It
+ * announces on update only: the text is already in the region at mount, which
+ * is when assistive tech registers it, so the first paint is silent.
+ */
+export declare const Header: import('react').ForwardRefExoticComponent<CalendarHeaderProps & import('react').RefAttributes<HTMLDivElement>>;

package/lib/wip/Calendar/Calendar.Header.es.js

@@ -0,0 +1,65 @@
+import { jsxs as p, jsx as o } from "react/jsx-runtime";
+import f from "clsx";
+import { forwardRef as h } from "react";
+import { S as u } from "../../../chunks/ChevronLeftCurved.CX7aH27X.js";
+import { S as v } from "../../../chunks/ChevronRightCurved.9hi9Zc8J.js";
+import { s as t, a as n } from "../../../chunks/calendar.module.CXGuMNJB.js";
+import { Button as C } from "../../Button/Button.es.js";
+import { Icon as b } from "../../Icon/Icon.es.js";
+import { useCalendar as N } from "./Calendar.context.es.js";
+const i = ({ icon: a, label: e, onClick: r }) => /* @__PURE__ */ o(
+  C,
+  {
+    type: "button",
+    appearance: "neutral",
+    kind: "ghost",
+    size: "md",
+    iconOnly: !0,
+    iconBefore: /* @__PURE__ */ o(b, { icon: a }),
+    "aria-label": e,
+    onClick: r
+  }
+), g = h(
+  function({ className: e, ...r }, s) {
+    const { monthLabel: m, monthLabelId: l, goToPreviousMonth: c, goToNextMonth: d } = N();
+    return /* @__PURE__ */ p(
+      "div",
+      {
+        ...r,
+        ref: s,
+        className: f(t[n.header], e),
+        children: [
+          /* @__PURE__ */ o(
+            i,
+            {
+              icon: u,
+              label: "Previous month",
+              onClick: c
+            }
+          ),
+          /* @__PURE__ */ o(
+            "span",
+            {
+              id: l,
+              "aria-live": "polite",
+              className: t[n.headerLabel],
+              children: m
+            }
+          ),
+          /* @__PURE__ */ o(
+            i,
+            {
+              icon: v,
+              label: "Next month",
+              onClick: d
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+g.displayName = "Header";
+export {
+  g as Header
+};

package/lib/wip/Calendar/Calendar.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),j=require("clsx"),_=require("react"),p=require("../../../chunks/calendar.module.D0wrnDz0.js"),H=require("../../../chunks/classNames.CEoAKlth.js");require("../../../chunks/constants.DLsDVPyH.js");const L=require("../../../chunks/dates.CVW08OQ2.js"),S=require("../../../utils/hooks/useId.cjs.js"),k=require("../../../utils/spacing.cjs.js"),T=require("./Calendar.context.cjs.js"),I=require("./Calendar.Date.cjs.js"),D=require("./Calendar.Dates.cjs.js"),R=require("./Calendar.Days.cjs.js"),q=require("./Calendar.Header.cjs.js");require("./Calendar.utils.cjs.js");const A=require("./useCalendarGrid.cjs.js"),E=require("./useCalendarMonth.cjs.js"),e=_.forwardRef(function({today:y,onVisibleMonthChange:b,locale:m,role:w="group","aria-label":x="Calendar",className:g,...h},N){const[v,M]=k.partitionSpacingProps(h),r=m??L.DEFAULT_LOCALE,{today:n,visibleMonth:s,navDirection:t,goToPreviousMonth:l,goToNextMonth:i}=E.useCalendarMonth({today:y,onVisibleMonthChange:b}),{weekStart:o,weekdayLabels:d,weeks:c,monthLabel:u}=A.useCalendarGrid(s,r),C=S.useId(),P=_.useMemo(()=>({locale:r,today:n,visibleMonth:s,weekStart:o,weeks:c,weekdayLabels:d,monthLabel:u,monthLabelId:C,goToPreviousMonth:l,goToNextMonth:i,navDirection:t}),[r,n,s,o,c,d,u,C,l,i,t]),f=j(p.styles[p.baseClassNamePrefix],...H.generateSpacingClasses(v),g);return a.jsx(T.CalendarContext.Provider,{value:P,children:a.jsxs("div",{...M,ref:N,role:w,"aria-label":x,className:f,children:[a.jsx(q.Header,{}),a.jsx(D.Dates,{})]})})});e.displayName="Calendar";e.Header=q.Header;e.Days=R.Days;e.Dates=D.Dates;e.Date=I.CalendarDate;e.Header.displayName="Calendar.Header";e.Days.displayName="Calendar.Days";e.Dates.displayName="Calendar.Dates";e.Date.displayName="Calendar.Date";exports.Calendar=e;

package/lib/wip/Calendar/Calendar.context.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),n=t.createContext(null),r=()=>{const e=t.useContext(n);if(!e)throw new Error("Calendar sub-components must be used within a Calendar");return e};exports.CalendarContext=n;exports.useCalendar=r;

package/lib/wip/Calendar/Calendar.context.d.ts

@@ -0,0 +1,8 @@
+import { CalendarContextValue } from './Calendar.types';
+export declare const CalendarContext: import('react').Context<CalendarContextValue | null>;
+/**
+ * Reads the grid state published by the `Calendar` root. Throws outside a
+ * `Calendar`, matching the throwing contract Accordion and Tabs use — the
+ * sub-components are meaningless without a root to derive the month.
+ */
+export declare const useCalendar: () => CalendarContextValue;

package/lib/wip/Calendar/Calendar.context.es.js

@@ -0,0 +1,11 @@
+import { createContext as e, useContext as n } from "react";
+const o = e(null), a = () => {
+  const t = n(o);
+  if (!t)
+    throw new Error("Calendar sub-components must be used within a Calendar");
+  return t;
+};
+export {
+  o as CalendarContext,
+  a as useCalendar
+};

package/lib/wip/Calendar/Calendar.d.ts

@@ -0,0 +1,24 @@
+import { ForwardRefExoticComponent, RefAttributes } from 'react';
+import { CalendarDate } from './Calendar.Date';
+import { Dates } from './Calendar.Dates';
+import { Days } from './Calendar.Days';
+import { Header } from './Calendar.Header';
+import { CalendarProps } from './Calendar.types';
+interface CalendarComponent extends ForwardRefExoticComponent<CalendarProps & RefAttributes<HTMLDivElement>> {
+    Header: typeof Header;
+    Days: typeof Days;
+    Dates: typeof Dates;
+    Date: typeof CalendarDate;
+}
+/**
+ * A month grid with a header for moving between months.
+ *
+ * The root owns the layout rather than exposing the parts as composable
+ * children: the weekday row and the date rows can't be reordered or used apart,
+ * Figma has no variant that hides the header, and modelling it as children
+ * would leave `<Calendar />` with no way to change months. Figma treats the
+ * genuinely optional parts — footer and presets — as variants, so those become
+ * props when they land.
+ */
+export declare const Calendar: CalendarComponent;
+export {};

package/lib/wip/Calendar/Calendar.es.js

@@ -0,0 +1,94 @@
+import { jsx as r, jsxs as w } from "react/jsx-runtime";
+import H from "clsx";
+import { forwardRef as k, useMemo as S } from "react";
+import { s as T, b as j } from "../../../chunks/calendar.module.CXGuMNJB.js";
+import { a as A } from "../../../chunks/classNames.koX0H7D0.js";
+import "../../../chunks/constants.XFX4nOSf.js";
+import { D as E } from "../../../chunks/dates.NqdbQ2fR.js";
+import { useId as I } from "../../../utils/hooks/useId.es.js";
+import { partitionSpacingProps as F } from "../../../utils/spacing.es.js";
+import { CalendarContext as G } from "./Calendar.context.es.js";
+import { CalendarDate as O } from "./Calendar.Date.es.js";
+import { Dates as f } from "./Calendar.Dates.es.js";
+import { Days as R } from "./Calendar.Days.es.js";
+import { Header as C } from "./Calendar.Header.es.js";
+import "./Calendar.utils.es.js";
+import { useCalendarGrid as U } from "./useCalendarGrid.es.js";
+import { useCalendarMonth as V } from "./useCalendarMonth.es.js";
+const a = k(
+  function({
+    today: D,
+    onVisibleMonthChange: y,
+    locale: u,
+    // Destructured with defaults rather than written after the prop spread:
+    // spreading first would silently drop a caller's own `role` or
+    // `aria-label`, and spreading last would let an unrelated pass-through
+    // erase the group semantics. This way the caller wins explicitly.
+    role: N = "group",
+    "aria-label": b = "Calendar",
+    className: h,
+    ...x
+  }, g) {
+    const [v, L] = F(x), e = u ?? E, { today: t, visibleMonth: o, navDirection: s, goToPreviousMonth: m, goToNextMonth: n } = V({ today: D, onVisibleMonthChange: y }), { weekStart: i, weekdayLabels: l, weeks: d, monthLabel: p } = U(
+      o,
+      e
+    ), c = I(), P = S(
+      () => ({
+        locale: e,
+        today: t,
+        visibleMonth: o,
+        weekStart: i,
+        weeks: d,
+        weekdayLabels: l,
+        monthLabel: p,
+        monthLabelId: c,
+        goToPreviousMonth: m,
+        goToNextMonth: n,
+        navDirection: s
+      }),
+      [
+        e,
+        t,
+        o,
+        i,
+        d,
+        l,
+        p,
+        c,
+        m,
+        n,
+        s
+      ]
+    ), M = H(
+      T[j],
+      ...A(v),
+      h
+    );
+    return /* @__PURE__ */ r(G.Provider, { value: P, children: /* @__PURE__ */ w(
+      "div",
+      {
+        ...L,
+        ref: g,
+        role: N,
+        "aria-label": b,
+        className: M,
+        children: [
+          /* @__PURE__ */ r(C, {}),
+          /* @__PURE__ */ r(f, {})
+        ]
+      }
+    ) });
+  }
+);
+a.displayName = "Calendar";
+a.Header = C;
+a.Days = R;
+a.Dates = f;
+a.Date = O;
+a.Header.displayName = "Calendar.Header";
+a.Days.displayName = "Calendar.Days";
+a.Dates.displayName = "Calendar.Dates";
+a.Date.displayName = "Calendar.Date";
+export {
+  a as Calendar
+};

package/lib/wip/Calendar/Calendar.types.cjs.js

@@ -0,0 +1 @@
+"use strict";

package/lib/wip/Calendar/Calendar.types.d.ts

@@ -0,0 +1,75 @@
+import { ComponentPropsWithoutRef } from 'react';
+import { MarginSpacingProps, PaddingSpacingProps } from '../../../utils/spacing';
+export interface CalendarProps extends MarginSpacingProps, PaddingSpacingProps, Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+    /**
+     * Override the current date. Seeds the visible month, and keeps tests and
+     * server-rendered output deterministic — the Calendar otherwise reads the
+     * system clock, which can differ between server and browser across a
+     * timezone or midnight boundary. Pass a timezone-stable value.
+     *
+     * Ignored when it isn't a valid `Date`.
+     *
+     * @default new Date()
+     */
+    today?: Date;
+    /**
+     * Fires whenever the visible month changes, with the first day of the new
+     * month at local midnight.
+     */
+    onVisibleMonthChange?: (date: Date) => void;
+    /**
+     * Specify the BCP-47 locale tag driving weekday and month names, the spoken
+     * date labels, and which day the week starts on (e.g. `de-DE` → Montag first,
+     * `en-US` → Sunday first). An unsupported tag falls back to the default.
+     *
+     * @default 'en-US'
+     */
+    locale?: string;
+    /**
+     * Accessible name for the calendar group.
+     *
+     * @default 'Calendar'
+     */
+    'aria-label'?: string;
+}
+/** Which way the visible month last moved, for the enter animation. */
+export type CalendarNavDirection = 'previous' | 'next';
+/**
+ * Everything the sub-components need, derived once by the `Calendar` root.
+ * @internal
+ */
+export interface CalendarContextValue {
+    /** BCP-47 tag driving weekday names, week start, and day numerals. */
+    locale: string;
+    /** The current date, at local midnight. */
+    today: Date;
+    /** First day of the rendered month, at local midnight. */
+    visibleMonth: Date;
+    /** First day of the week, in `Date.getDay()` numbering (0 = Sunday). */
+    weekStart: number;
+    /** Whole weeks covering `visibleMonth`, padded with adjacent-month days. */
+    weeks: Date[][];
+    /** Abbreviated weekday names, ordered from `weekStart`. */
+    weekdayLabels: ReadonlyArray<string>;
+    /** Localized "Month Year" label for `visibleMonth`. */
+    monthLabel: string;
+    /**
+     * `id` of the element rendering `monthLabel`, so the grid can be named by it.
+     * `undefined` only on a React < 18 server render, where `useId` has no id to
+     * give yet and both the `id` and the `aria-labelledby` are simply omitted.
+     */
+    monthLabelId: string | undefined;
+    /** Moves the visible month back one and fires `onVisibleMonthChange`. */
+    goToPreviousMonth: () => void;
+    /** Moves the visible month forward one and fires `onVisibleMonthChange`. */
+    goToNextMonth: () => void;
+    /** Direction of the last navigation; `null` until the user navigates. */
+    navDirection: CalendarNavDirection | null;
+}
+export type CalendarHeaderProps = Omit<ComponentPropsWithoutRef<'div'>, 'children'>;
+export type CalendarDaysProps = ComponentPropsWithoutRef<'thead'>;
+export type CalendarDatesProps = Omit<ComponentPropsWithoutRef<'table'>, 'children'>;
+export interface CalendarDateProps extends Omit<ComponentPropsWithoutRef<'td'>, 'children'> {
+    /** The day this cell renders. Outside-month styling is derived from it. */
+    date: Date;
+}

package/lib/wip/Calendar/Calendar.types.es.js

@@ -0,0 +1 @@
+

package/lib/wip/Calendar/Calendar.utils.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../../chunks/constants.DLsDVPyH.js");const o=require("../../../chunks/dates.CVW08OQ2.js"),r=7,y=0,i=1,E=6,g=e=>(e%r+r)%r,s=(e,t,n)=>{const a=new Date;return a.setFullYear(e,t,n),a.setHours(0,0,0,0),a},_=e=>s(e.getFullYear(),e.getMonth(),e.getDate()),h=e=>s(e.getFullYear(),e.getMonth(),1),d=e=>s(e.getFullYear(),e.getMonth()+1,0),m=e=>d(e).getDate(),D=(e,t)=>s(e.getFullYear(),e.getMonth(),e.getDate()+t),I=(e,t)=>{const n=s(e.getFullYear(),e.getMonth()+t,1),a=Math.min(e.getDate(),m(n));return s(n.getFullYear(),n.getMonth(),a)},T=(e,t)=>e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate(),k=(e,t)=>e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth(),L=[],l=(e,t)=>{const n=o.createBoundedMemo(e,t);return L.push(n),n},C=e=>{var t,n;try{const a=new Intl.Locale(e),c=((t=a.getWeekInfo)==null?void 0:t.call(a).firstDay)??((n=a.weekInfo)==null?void 0:n.firstDay);return typeof c=="number"?g(c):null}catch{return null}},N=new Set(["BD","BR","CA","CO","ET","HK","ID","IL","IN","JP","KE","KR","MO","MX","NP","PE","PH","PK","PT","SA","SG","TH","TW","US","VE","YE","ZA"]),O=new Set(["AF","BH","DZ","EG","IQ","IR","JO","KW","LY","OM","QA","SD","SY"]),W=e=>{try{const t=new Intl.Locale(e).maximize().region;return t?N.has(t)?y:O.has(t)?E:null:null}catch{return null}},w=l(o.canonicalLocaleKey,e=>{const t=o.resolveLocale(e);return C(t)??W(t)??i}),b=864e5,M=e=>{const t=new Date(0);return t.setUTCFullYear(e.getFullYear(),e.getMonth(),e.getDate()),t},U=Date.UTC(2024,8,1),S=(e,t,n)=>{const a=new Intl.DateTimeFormat(o.resolveLocale(e),{weekday:n,timeZone:"UTC"});return Array.from({length:r},(c,u)=>a.format(U+g(t+u)*b))},A=(e,t)=>`${o.canonicalLocaleKey(e)}|${t}`,R=l(A,(e,t)=>S(e,t,"short")),K=l(A,(e,t)=>S(e,t,"long")),v=(e,t)=>R(e,t),P=(e,t)=>{const n=h(e),a=g(n.getDay()-t),c=D(n,-a),u=Math.ceil((a+m(e))/r);return Array.from({length:u},(Q,F)=>Array.from({length:r},($,Y)=>D(c,F*r+Y)))},p=(e,t)=>K(e,t),G=new Set(["gregory","buddhist","japanese","roc"]),f=e=>{const{calendar:t}=new Intl.DateTimeFormat(e).resolvedOptions();return G.has(t)?{}:{calendar:"gregory"}},H=l(o.canonicalLocaleKey,e=>{const t=o.resolveLocale(e);return new Intl.DateTimeFormat(t,{weekday:"long",year:"numeric",month:"long",day:"numeric",timeZone:"UTC",...f(t)})}),Z=(e,t)=>H(t).format(M(e)),B=l(o.canonicalLocaleKey,e=>{const t=o.resolveLocale(e);return new Intl.DateTimeFormat(t,{month:"long",year:"numeric",timeZone:"UTC",...f(t)})}),V=(e,t)=>B(t).format(M(e)),j=l(o.canonicalLocaleKey,e=>new Intl.NumberFormat(o.resolveLocale(e))),q=(e,t)=>j(t).format(e.getDate()),J=()=>{o.__clearLocaleKeyCache(),L.forEach(e=>e.clear())};exports.DEFAULT_LOCALE=o.DEFAULT_LOCALE;exports.isValidDate=o.isValidDate;exports.DAYS_IN_WEEK=r;exports.MONDAY=i;exports.SUNDAY=y;exports.__clearCalendarCaches=J;exports.addDays=D;exports.addMonths=I;exports.endOfMonth=d;exports.formatDayNumber=q;exports.getCalendarWeeks=P;exports.getDateLabel=Z;exports.getDaysInMonth=m;exports.getMonthLabel=V;exports.getWeekStart=w;exports.getWeekdayFullLabels=p;exports.getWeekdayLabels=v;exports.isSameDay=T;exports.isSameMonth=k;exports.startOfDay=_;exports.startOfMonth=h;exports.wrapWeekday=g;

package/lib/wip/Calendar/Calendar.utils.d.ts

@@ -0,0 +1,102 @@
+import { DEFAULT_LOCALE, isValidDate, BoundedMemo } from '@viasat/beam-shared/utils';
+export { DEFAULT_LOCALE, isValidDate };
+export declare const DAYS_IN_WEEK = 7;
+/** Sunday, in `Date.getDay()` numbering. */
+export declare const SUNDAY = 0;
+/** Monday, in `Date.getDay()` numbering. */
+export declare const MONDAY = 1;
+/**
+ * Normalizes any day number — including a negative one — into `Date.getDay()`
+ * range. Plain `%` keeps the sign in JavaScript, so `-1 % 7` is `-1`, not `6`.
+ */
+export declare const wrapWeekday: (day: number) => number;
+/** Strips time-of-day, returning local midnight on the same calendar day. */
+export declare const startOfDay: (date: Date) => Date;
+/** Local midnight on the first day of `date`'s month. */
+export declare const startOfMonth: (date: Date) => Date;
+/** Local midnight on the last day of `date`'s month. */
+export declare const endOfMonth: (date: Date) => Date;
+export declare const getDaysInMonth: (date: Date) => number;
+/** Shifts by whole calendar days. Negative amounts move backwards. */
+export declare const addDays: (date: Date, amount: number) => Date;
+/**
+ * Shifts by whole calendar months, clamping the day to the target month's
+ * length so Jan 31 lands on Feb 28 rather than overflowing into March. The
+ * clamp is invisible to month navigation, which always operates on the first
+ * of the month, but C-8's `PageUp`/`PageDown` moves arbitrary days and needs it.
+ */
+export declare const addMonths: (date: Date, amount: number) => Date;
+export declare const isSameDay: (a: Date, b: Date) => boolean;
+export declare const isSameMonth: (a: Date, b: Date) => boolean;
+/**
+ * First day of the week for a locale, as `Date.getDay()` numbering (0 =
+ * Sunday). This is the ADR's `weekStart: 'auto'` default — the locale decides,
+ * not the design system. Falls back to the region table, then to Monday (ISO
+ * 8601, and the ADR's stated final fallback).
+ *
+ * Resolves the tag through {@link resolveLocale} first, the same as every other
+ * helper here. Without that an unsupported tag would take its week start from
+ * itself while its labels fell back to English — a grid starting on the wrong
+ * day with English headers. The fallback is silent for now; the dev-only
+ * warning for an unsupported locale belongs to C-15.
+ */
+export declare const getWeekStart: BoundedMemo<[locale: string], number>;
+/**
+ * Abbreviated weekday names for the column headers. Figma's `weekStart=sunday`
+ * variant is drawn with inconsistent abbreviations ("Tues", "Thurs"); `Intl`
+ * yields the consistent set that the `weekStart=monday` variant uses.
+ */
+export declare const getWeekdayLabels: (locale: string, weekStart: number) => ReadonlyArray<string>;
+/**
+ * The rendered grid: whole weeks covering `visibleMonth`, padded at both ends
+ * with the adjacent months' days so every row holds {@link DAYS_IN_WEEK} dates.
+ *
+ * Returns 4, 5, or 6 rows depending on how the month falls — never a fixed 6.
+ * (A 28-day February starting on `weekStart` needs exactly 4; a 29-day one
+ * needs 5. Forcing
+ * a constant 6 is C-6's `consistentWeeks`.)
+ */
+export declare const getCalendarWeeks: (visibleMonth: Date, weekStart: number) => Date[][];
+/**
+ * Full weekday names for the column headers' spoken text. The visible label is
+ * an abbreviation, and screen readers read those inconsistently — "Mon" as a
+ * word or spelled out, and worse where the abbreviation is clipped ("Mi.",
+ * "mer."). The header shows the short form and announces this one.
+ */
+export declare const getWeekdayFullLabels: (locale: string, weekStart: number) => ReadonlyArray<string>;
+/**
+ * A cell's spoken name — "Wednesday, July 15, 2025".
+ *
+ * The visible text is only the day number, which leaves a screen reader unable
+ * to separate the padding days from the month's own: July 2025 opens on
+ * "29, 30, 1", so it sounds like July starts on the 29th. The dimmed colour is
+ * the only thing saying otherwise, and colour isn't available to a screen
+ * reader.
+ *
+ * Built by `Intl` rather than assembled from parts, so word order and
+ * punctuation follow the locale instead of an English template. C-13 extends
+ * this with state suffixes (today, selected, disabled); I-8 adds the per-cell
+ * override.
+ */
+export declare const getDateLabel: (date: Date, locale: string) => string;
+/**
+ * The header's "Month Year" label. Ordering is the locale's, not a template —
+ * en-US gives "July 2025", ja-JP gives "2025年7月", th-TH keeps its Buddhist
+ * year. Pinned the same way as {@link getDateLabel}, and for the same reasons,
+ * so the header can't name a different month from the cells below it.
+ */
+export declare const getMonthLabel: (date: Date, locale: string) => string;
+/**
+ * The day-of-month number as displayed. Routed through `Intl.NumberFormat` so
+ * locales with non-Latin default digits render correctly, and so the
+ * `numerals` prop (I-9) has a single place to override the numbering system.
+ *
+ * No timezone to pin — it's handed a number, not a date.
+ */
+export declare const formatDayNumber: (date: Date, locale: string) => string;
+/**
+ * @internal — test-only. Clears Calendar's per-locale caches plus the shared
+ * canonical-key cache they all index by, so one suite can't leak a resolved
+ * locale into the next.
+ */
+export declare const __clearCalendarCaches: () => void;