@borisj74/bv-ds 0.1.3 → 0.1.4

package/dist/index.cjs

@@ -6117,6 +6117,97 @@ function ButtonUtility({
     ) : null
   ] });
 }
+var dotClasses = {
+  neutral: "bg-utility-neutral-500",
+  brand: "bg-utility-brand-500",
+  emerald: "bg-utility-emerald-500",
+  blue: "bg-utility-blue-500",
+  indigo: "bg-utility-indigo-500",
+  purple: "bg-utility-purple-500",
+  pink: "bg-utility-pink-500",
+  orange: "bg-utility-orange-500",
+  amber: "bg-utility-amber-500"
+};
+var filledClasses = {
+  neutral: "bg-utility-neutral-50 border-utility-neutral-200 text-utility-neutral-700",
+  brand: "bg-utility-brand-50 border-utility-brand-200 text-utility-brand-700",
+  emerald: "bg-utility-emerald-50 border-utility-emerald-200 text-utility-emerald-700",
+  blue: "bg-utility-blue-50 border-utility-blue-200 text-utility-blue-700",
+  indigo: "bg-utility-indigo-50 border-utility-indigo-200 text-utility-indigo-700",
+  purple: "bg-utility-purple-50 border-utility-purple-200 text-utility-purple-700",
+  pink: "bg-utility-pink-50 border-utility-pink-200 text-utility-pink-700",
+  orange: "bg-utility-orange-50 border-utility-orange-200 text-utility-orange-700",
+  amber: "bg-utility-amber-50 border-utility-amber-200 text-utility-amber-700"
+};
+var filledHoverClasses = {
+  neutral: "bg-utility-neutral-100",
+  brand: "bg-utility-brand-100",
+  emerald: "bg-utility-emerald-100",
+  blue: "bg-utility-blue-100",
+  indigo: "bg-utility-indigo-100",
+  purple: "bg-utility-purple-100",
+  pink: "bg-utility-pink-100",
+  orange: "bg-utility-orange-100",
+  amber: "bg-utility-amber-100"
+};
+var timeClasses = {
+  neutral: "text-utility-neutral-600",
+  brand: "text-utility-brand-600",
+  emerald: "text-utility-emerald-600",
+  blue: "text-utility-blue-600",
+  indigo: "text-utility-indigo-600",
+  purple: "text-utility-purple-600",
+  pink: "text-utility-pink-600",
+  orange: "text-utility-orange-600",
+  amber: "text-utility-amber-600"
+};
+function CalendarEvent({
+  title,
+  time: time2,
+  color: color2 = "neutral",
+  filled = false,
+  breakpoint = "desktop",
+  state = "default",
+  className
+}) {
+  if (breakpoint === "mobile") {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        className: clsx_default("inline-block size-2 rounded-full", dotClasses[color2], className),
+        role: "img",
+        "aria-label": time2 ? `${title}, ${time2}` : title
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: clsx_default(
+        "flex w-full items-center gap-md rounded-sm border px-md py-xs font-body text-xs",
+        filled ? clsx_default(filledClasses[color2], state === "hover" && filledHoverClasses[color2]) : clsx_default(
+          "border-border-secondary bg-bg-primary text-text-secondary",
+          state === "hover" && "bg-bg-primary-hover"
+        ),
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: clsx_default("size-2 shrink-0 rounded-full", dotClasses[color2]), "aria-hidden": true }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate font-semibold", children: title }),
+        time2 ? /* @__PURE__ */ jsxRuntime.jsx(
+          "span",
+          {
+            className: clsx_default(
+              "ml-auto shrink-0 font-normal",
+              filled ? timeClasses[color2] : "text-text-tertiary"
+            ),
+            children: time2
+          }
+        ) : null
+      ]
+    }
+  );
+}
 function PlusIcon2() {
   return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 20 20", fill: "none", className: "size-4", "aria-hidden": true, children: /* @__PURE__ */ jsxRuntime.jsx(
     "path",
@@ -6131,19 +6222,26 @@ function PlusIcon2() {
 }
 function CalendarCell({
   date: date2,
+  events,
   children,
   moreCount,
-  muted = false,
+  isToday,
+  isSelected = false,
+  isDisabled,
   current = false,
+  muted = false,
+  breakpoint = "desktop",
   onAdd,
   className
 }) {
+  const today = isToday ?? current;
+  const disabled = isDisabled ?? muted;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
       className: clsx_default(
         "group relative flex min-h-[120px] flex-col gap-xs bg-bg-primary p-md font-body",
-        muted && "bg-bg-secondary",
+        disabled && "bg-bg-secondary",
         className
       ),
       children: [
@@ -6151,12 +6249,31 @@ function CalendarCell({
           "span",
           {
             className: clsx_default(
-              "text-xs font-semibold",
-              current ? "text-text-brand-secondary" : muted ? "text-text-quaternary" : "text-text-secondary"
+              "flex size-6 items-center justify-center text-xs font-semibold",
+              today ? "rounded-full bg-bg-brand-solid text-white" : isSelected ? "rounded-full bg-bg-secondary text-text-secondary" : disabled ? "text-text-quaternary" : "text-text-secondary"
             ),
             children: date2
           }
         ),
+        events && events.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            className: clsx_default(
+              breakpoint === "mobile" ? "flex flex-row flex-wrap gap-xxs" : "flex flex-col gap-xs"
+            ),
+            children: events.map((ev, i) => /* @__PURE__ */ jsxRuntime.jsx(
+              CalendarEvent,
+              {
+                title: ev.title,
+                time: ev.time,
+                color: ev.color,
+                filled: true,
+                breakpoint
+              },
+              i
+            ))
+          }
+        ) : null,
         children ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-col gap-xs", children }) : null,
         moreCount && moreCount > 0 ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-xs font-medium text-text-tertiary", children: [
           moreCount,
@@ -6176,6 +6293,13 @@ function CalendarCell({
     }
   );
 }
+var heightClasses = {
+  empty: "h-[48px]",
+  "30min": "h-[48px]",
+  "60min": "h-[96px]",
+  "90min": "h-[144px]",
+  "120min": "h-[192px]"
+};
 function PlusIcon3() {
   return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 20 20", fill: "none", className: "size-4", "aria-hidden": true, children: /* @__PURE__ */ jsxRuntime.jsx(
     "path",
@@ -6189,6 +6313,8 @@ function PlusIcon3() {
   ) });
 }
 function CalendarCellDayWeekView({
+  type,
+  state = "default",
   children,
   onAdd,
   muted = false,
@@ -6198,8 +6324,9 @@ function CalendarCellDayWeekView({
     "div",
     {
       className: clsx_default(
-        "group relative min-h-[64px] border-b border-border-secondary p-xs font-body",
-        muted ? "bg-bg-secondary" : "bg-bg-primary",
+        "group relative border-b border-border-secondary p-xs font-body transition-colors hover:bg-bg-secondary",
+        type ? heightClasses[type] : "min-h-[64px]",
+        muted ? "bg-bg-secondary" : state === "hover" ? "bg-bg-secondary" : "bg-bg-primary",
         className
       ),
       children: [
@@ -6221,16 +6348,20 @@ function CalendarCellDayWeekView({
 function CalendarColumnHeader({
   weekday,
   date: date2,
+  type,
   current = false,
   orientation = "vertical",
+  breakpoint = "desktop",
   className
 }) {
+  const state = type ?? (current ? "selected" : "default");
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
       className: clsx_default(
         "flex items-center justify-center gap-md py-md font-body",
         orientation === "vertical" && "flex-col gap-xs",
+        breakpoint === "desktop" && "w-[160px]",
         className
       ),
       children: [
@@ -6240,9 +6371,11 @@ function CalendarColumnHeader({
           {
             className: clsx_default(
               "flex items-center justify-center text-xs font-semibold",
-              current ? "size-6 rounded-full bg-bg-brand-solid text-white" : "text-text-secondary"
+              state === "selected" && "size-6 rounded-full bg-bg-brand-solid text-white",
+              state === "today" && "border-b-2 border-border-brand pb-xxs text-text-brand-secondary",
+              state === "default" && "text-text-secondary"
             ),
-            "aria-current": current ? "date" : void 0,
+            "aria-current": state !== "default" ? "date" : void 0,
             children: date2
           }
         )
@@ -6265,51 +6398,6 @@ function CalendarDateIcon({ month, day, className }) {
     }
   );
 }
-var dotClasses = {
-  neutral: "bg-utility-neutral-500",
-  brand: "bg-utility-brand-500",
-  emerald: "bg-utility-emerald-500",
-  blue: "bg-utility-blue-500",
-  indigo: "bg-utility-indigo-500",
-  purple: "bg-utility-purple-500",
-  pink: "bg-utility-pink-500",
-  orange: "bg-utility-orange-500",
-  amber: "bg-utility-amber-500"
-};
-var filledClasses = {
-  neutral: "bg-utility-neutral-100 text-utility-neutral-700",
-  brand: "bg-utility-brand-100 text-utility-brand-700",
-  emerald: "bg-utility-emerald-100 text-utility-emerald-700",
-  blue: "bg-utility-blue-100 text-utility-blue-700",
-  indigo: "bg-utility-indigo-100 text-utility-indigo-700",
-  purple: "bg-utility-purple-100 text-utility-purple-700",
-  pink: "bg-utility-pink-100 text-utility-pink-700",
-  orange: "bg-utility-orange-100 text-utility-orange-700",
-  amber: "bg-utility-amber-100 text-utility-amber-700"
-};
-function CalendarEvent({
-  title,
-  time: time2,
-  color: color2 = "neutral",
-  filled = false,
-  className
-}) {
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    "div",
-    {
-      className: clsx_default(
-        "flex w-full items-center gap-md rounded-sm px-md py-xs font-body text-xs",
-        filled ? filledClasses[color2] : "border border-border-secondary bg-bg-primary text-text-secondary",
-        className
-      ),
-      children: [
-        /* @__PURE__ */ jsxRuntime.jsx("span", { className: clsx_default("size-2 shrink-0 rounded-full", dotClasses[color2]), "aria-hidden": true }),
-        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate font-semibold", children: title }),
-        time2 ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: clsx_default("ml-auto shrink-0 font-normal", !filled && "text-text-tertiary"), children: time2 }) : null
-      ]
-    }
-  );
-}
 var accentClasses = {
   neutral: "border-l-utility-neutral-500",
   brand: "border-l-utility-brand-500",
@@ -6376,11 +6464,13 @@ function CalendarEventDayWeekView({
 function CalendarHeader({
   title,
   range: range6,
+  supportingText,
   badge,
   dateIcon,
   actions,
   className
 }) {
+  const subtitle = range6 ?? supportingText;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
@@ -6396,7 +6486,7 @@ function CalendarHeader({
               /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-bold text-text-primary", children: title }),
               badge
             ] }),
-            range6 ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-text-tertiary", children: range6 }) : null
+            subtitle ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-text-tertiary", children: subtitle }) : null
           ] })
         ] }),
         actions ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex items-center gap-md", children: actions }) : null
@@ -6404,7 +6494,7 @@ function CalendarHeader({
     }
   );
 }
-function CalendarRowLabel({ label, className }) {
+function CalendarRowLabel({ label, time: time2, className }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
@@ -6412,7 +6502,7 @@ function CalendarRowLabel({ label, className }) {
         "pr-md text-right text-xs font-medium text-text-quaternary font-body",
         className
       ),
-      children: label
+      children: time2 ?? label
     }
   );
 }
@@ -6422,15 +6512,17 @@ var Label = ({ time: time2 }) => /* @__PURE__ */ jsxRuntime.jsx("span", { classN
 function CalendarTimemarker({
   time: time2,
   align = "left",
+  breakpoint = "desktop",
   className
 }) {
+  const showLabel = breakpoint === "desktop";
   return /* @__PURE__ */ jsxRuntime.jsx("div", { className: clsx_default("flex w-full items-center gap-xs font-body", className), children: align === "center" ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(Dot, {}),
     /* @__PURE__ */ jsxRuntime.jsx(Line, {}),
-    /* @__PURE__ */ jsxRuntime.jsx(Label, { time: time2 }),
+    showLabel ? /* @__PURE__ */ jsxRuntime.jsx(Label, { time: time2 }) : null,
     /* @__PURE__ */ jsxRuntime.jsx(Line, {})
   ] }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    /* @__PURE__ */ jsxRuntime.jsx(Label, { time: time2 }),
+    showLabel ? /* @__PURE__ */ jsxRuntime.jsx(Label, { time: time2 }) : null,
     /* @__PURE__ */ jsxRuntime.jsx(Dot, {}),
     /* @__PURE__ */ jsxRuntime.jsx(Line, {})
   ] }) });
@@ -6455,10 +6547,19 @@ function Chevron2() {
 function CalendarViewDropdown({
   value,
   onChange,
+  onSelect,
+  open: openProp,
+  onOpenChange,
   options = DEFAULT_OPTIONS,
   className
 }) {
-  const [open, setOpen] = React28.useState(false);
+  const [internalOpen, setInternalOpen] = React28.useState(false);
+  const isControlled = openProp !== void 0;
+  const open = isControlled ? openProp : internalOpen;
+  const setOpen = (next) => {
+    if (!isControlled) setInternalOpen(next);
+    onOpenChange?.(next);
+  };
   const selected = options.find((o) => o.value === value) ?? options[0];
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: clsx_default("relative inline-block font-body", className), children: [
     /* @__PURE__ */ jsxRuntime.jsxs(
@@ -6467,7 +6568,7 @@ function CalendarViewDropdown({
         type: "button",
         "aria-haspopup": "listbox",
         "aria-expanded": open,
-        onClick: () => setOpen((v) => !v),
+        onClick: () => setOpen(!open),
         className: "inline-flex items-center gap-md rounded-md border border-border-primary bg-bg-primary px-lg py-md text-sm font-semibold text-text-secondary shadow-skeuomorphic transition-colors hover:bg-bg-primary-hover focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-border-brand focus-visible:ring-offset-2 focus-visible:ring-offset-bg-primary",
         children: [
           selected.label,
@@ -6488,6 +6589,7 @@ function CalendarViewDropdown({
               type: "button",
               onClick: () => {
                 onChange?.(opt.value);
+                onSelect?.(opt.value);
                 setOpen(false);
               },
               className: "flex w-full items-center gap-md rounded-sm px-md py-xs text-sm font-medium text-text-secondary transition-colors hover:bg-bg-primary-hover",

package/dist/index.d.cts

@@ -313,25 +313,73 @@ interface ButtonUtilityProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement
 }
 declare function ButtonUtility({ icon, label, size, variant, tooltip, className, ...rest }: ButtonUtilityProps): react.JSX.Element;
 
+type CalendarEventColor = "neutral" | "brand" | "emerald" | "blue" | "indigo" | "purple" | "pink" | "orange" | "amber";
+type CalendarEventBreakpoint = "desktop" | "mobile";
+type CalendarEventState = "default" | "hover";
+interface CalendarEventProps {
+    /** Event title. */
+    title: string;
+    /** Optional time label (e.g. "9:00 AM"). */
+    time?: string;
+    color?: CalendarEventColor;
+    /** Filled colour-fill style vs the subtle white style. */
+    filled?: boolean;
+    /** Desktop renders the full chip; mobile collapses to an 8px dot. */
+    breakpoint?: CalendarEventBreakpoint;
+    /** `hover` darkens the fill one shade (filled chips only). */
+    state?: CalendarEventState;
+    className?: string;
+}
+declare function CalendarEvent({ title, time, color, filled, breakpoint, state, className, }: CalendarEventProps): react.JSX.Element;
+
+type CalendarCellBreakpoint = "desktop" | "mobile";
+interface CalendarCellEvent {
+    title: string;
+    time?: string;
+    color?: CalendarEventColor;
+}
 interface CalendarCellProps {
     /** Day-of-month number. */
     date: string | number;
+    /**
+     * Declarative events for this day — rendered as filled `CalendarEvent`
+     * chips (collapsed to dots on mobile). Use `children` instead for full
+     * control over each chip.
+     */
+    events?: CalendarCellEvent[];
     /** Event chips for this day — typically `CalendarEvent` instances. */
     children?: ReactNode;
     /** "+N more" overflow count shown beneath the events. */
     moreCount?: number;
+    /** Today — date number in a brand-solid circle. */
+    isToday?: boolean;
+    /** Selected day — date number in a secondary-fill circle. */
+    isSelected?: boolean;
     /** Other-month / disabled styling. */
-    muted?: boolean;
-    /** Marks today (date number in brand). */
+    isDisabled?: boolean;
+    /** Legacy alias for `isToday`. */
     current?: boolean;
+    /** Legacy alias for `isDisabled`. */
+    muted?: boolean;
+    /** Desktop renders full chips; mobile collapses chips to dots. */
+    breakpoint?: CalendarCellBreakpoint;
     /** Renders a hover "+" add button bottom-right. */
     onAdd?: () => void;
     className?: string;
 }
 /** A single day cell in the month grid. Composes CalendarEvent chips. */
-declare function CalendarCell({ date, children, moreCount, muted, current, onAdd, className, }: CalendarCellProps): react.JSX.Element;
+declare function CalendarCell({ date, events, children, moreCount, isToday, isSelected, isDisabled, current, muted, breakpoint, onAdd, className, }: CalendarCellProps): react.JSX.Element;
 
+type CalendarTimeslotType = "empty" | "30min" | "60min" | "90min" | "120min";
+type CalendarTimeslotState = "default" | "hover";
 interface CalendarCellDayWeekViewProps {
+    /**
+     * Slot duration — drives the row height (empty/30min → 48px, 60min → 96px,
+     * 90min → 144px, 120min → 192px). Omit to keep the auto min-height.
+     */
+    type?: CalendarTimeslotType;
+    /** `hover` tints the slot (also rendered via CSS :hover). */
+    state?: CalendarTimeslotState;
     /** Event block(s) occupying the slot — typically CalendarEventDayWeekView. */
     children?: ReactNode;
     /** Renders a hover "+" add button bottom-right. */
@@ -341,20 +389,29 @@ interface CalendarCellDayWeekViewProps {
     className?: string;
 }
 /** A time-slot cell in day/week view. Holds CalendarEventDayWeekView blocks. */
-declare function CalendarCellDayWeekView({ children, onAdd, muted, className, }: CalendarCellDayWeekViewProps): react.JSX.Element;
+declare function CalendarCellDayWeekView({ type, state, children, onAdd, muted, className, }: CalendarCellDayWeekViewProps): react.JSX.Element;
 
 type CalendarColumnHeaderOrientation = "horizontal" | "vertical";
+type CalendarColumnHeaderType = "default" | "selected" | "today";
+type CalendarBreakpoint = "desktop" | "mobile";
 interface CalendarColumnHeaderProps {
     /** Weekday label (e.g. "Mon"). */
     weekday: string;
     /** Date number. */
     date: string | number;
-    /** Active day — renders the date in a brand-solid circle. */
+    /**
+     * Cell state. `selected` → brand-solid circle behind the date; `today` →
+     * brand text + brand underline. Takes precedence over `current` when set.
+     */
+    type?: CalendarColumnHeaderType;
+    /** Legacy boolean — equivalent to `type="selected"`. Kept for back-compat. */
     current?: boolean;
     orientation?: CalendarColumnHeaderOrientation;
+    /** Desktop fixes the column to 160px; mobile lets it size to content. */
+    breakpoint?: CalendarBreakpoint;
     className?: string;
 }
-declare function CalendarColumnHeader({ weekday, date, current, orientation, className, }: CalendarColumnHeaderProps): react.JSX.Element;
+declare function CalendarColumnHeader({ weekday, date, type, current, orientation, breakpoint, className, }: CalendarColumnHeaderProps): react.JSX.Element;
 
 interface CalendarDateIconProps {
     /** Short month label (e.g. "JAN"). Rendered uppercase. */
@@ -365,19 +422,6 @@ interface CalendarDateIconProps {
 }
 declare function CalendarDateIcon({ month, day, className }: CalendarDateIconProps): react.JSX.Element;
 
-type CalendarEventColor = "neutral" | "brand" | "emerald" | "blue" | "indigo" | "purple" | "pink" | "orange" | "amber";
-interface CalendarEventProps {
-    /** Event title. */
-    title: string;
-    /** Optional time label (e.g. "9:00 AM"). */
-    time?: string;
-    color?: CalendarEventColor;
-    /** Filled colour-fill style vs the subtle white style. */
-    filled?: boolean;
-    className?: string;
-}
-declare function CalendarEvent({ title, time, color, filled, className, }: CalendarEventProps): react.JSX.Element;
-
 interface CalendarEventDayWeekViewProps {
     title: string;
     time?: string;
@@ -393,6 +437,8 @@ interface CalendarHeaderProps {
     title: string;
     /** Date range subtitle, e.g. "Jan 1, 2027 – Jan 31, 2027". */
     range?: string;
+    /** Alias for `range` — Batch-36 prop name. `range` wins if both set. */
+    supportingText?: string;
     /** Badge beside the title (e.g. a PillBadge "Week 1"). */
     badge?: ReactNode;
     /** Leading date chip — typically a CalendarDateIcon. */
@@ -402,25 +448,30 @@ interface CalendarHeaderProps {
     className?: string;
 }
 /** Top bar of the calendar composite. A layout shell — drop controls into `actions`. */
-declare function CalendarHeader({ title, range, badge, dateIcon, actions, className, }: CalendarHeaderProps): react.JSX.Element;
+declare function CalendarHeader({ title, range, supportingText, badge, dateIcon, actions, className, }: CalendarHeaderProps): react.JSX.Element;
 
 interface CalendarRowLabelProps {
     /** Time label for the row gutter (e.g. "9 AM"). */
-    label: string;
+    label?: string;
+    /** Alias for `label` — Batch-36 prop name. One of the two is required. */
+    time?: string;
     className?: string;
 }
 /** Left-gutter time label aligned to the top of a day/week-view row. */
-declare function CalendarRowLabel({ label, className }: CalendarRowLabelProps): react.JSX.Element;
+declare function CalendarRowLabel({ label, time, className }: CalendarRowLabelProps): react.JSX.Element;
 
 type CalendarTimemarkerAlign = "left" | "center";
+type CalendarTimemarkerBreakpoint = "desktop" | "mobile";
 interface CalendarTimemarkerProps {
     /** Time label (e.g. "2:20 PM"). */
     time: string;
     /** Label position: leading, or centered between two line halves. */
     align?: CalendarTimemarkerAlign;
+    /** Desktop shows the time label; mobile collapses to dot + line only. */
+    breakpoint?: CalendarTimemarkerBreakpoint;
     className?: string;
 }
-declare function CalendarTimemarker({ time, align, className, }: CalendarTimemarkerProps): react.JSX.Element;
+declare function CalendarTimemarker({ time, align, breakpoint, className, }: CalendarTimemarkerProps): react.JSX.Element;
 
 type CalendarView = "day" | "week" | "month";
 interface CalendarViewOption {
@@ -431,10 +482,16 @@ interface CalendarViewOption {
 interface CalendarViewDropdownProps {
     value: CalendarView;
     onChange?: (value: CalendarView) => void;
+    /** Alias for `onChange` — Batch-36 prop name. Both fire on selection. */
+    onSelect?: (value: CalendarView) => void;
+    /** Controlled open state. Omit to let the component manage its own. */
+    open?: boolean;
+    /** Fires whenever the menu wants to open/close (controlled or not). */
+    onOpenChange?: (open: boolean) => void;
     options?: CalendarViewOption[];
     className?: string;
 }
-declare function CalendarViewDropdown({ value, onChange, options, className, }: CalendarViewDropdownProps): react.JSX.Element;
+declare function CalendarViewDropdown({ value, onChange, onSelect, open: openProp, onOpenChange, options, className, }: CalendarViewDropdownProps): react.JSX.Element;
 
 interface CardHeaderProps {
     /** Card section title. */
@@ -2789,4 +2846,4 @@ declare namespace index {
   export { index_BoxIllustration as BoxIllustration, index_CloudIllustration as CloudIllustration, index_CreditCardIllustration as CreditCardIllustration, index_DocumentsIllustration as DocumentsIllustration };
 }
 
-export { ActivityFeed, type ActivityFeedDivider, type ActivityFeedProps, ActivityGauge, type ActivityGaugeLegend, type ActivityGaugeProps, type ActivityGaugeSeries, type ActivityGaugeSize, AdvancedFilterBar, type AdvancedFilterBarProps, Alert, type AlertAction, type AlertColor, type AlertProps, type AlertSize, Avatar, AvatarAddButton, type AvatarAddButtonProps, type AvatarAddButtonSize, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupSize, AvatarLabelGroup, type AvatarLabelGroupProps, type AvatarLabelGroupSize, AvatarProfilePhoto, type AvatarProfilePhotoProps, type AvatarProfilePhotoSize, type AvatarProps, type AvatarSize, BadgeCloseX, type BadgeCloseXProps, type BadgeCloseXShape, type BadgeColor, type BadgeCommonProps, BadgeGroup, type BadgeGroupBadgePosition, type BadgeGroupProps, type BadgeGroupSize, type BadgeGroupType, type BadgeSize, BreadcrumbButtonBase, type BreadcrumbButtonBaseProps, type BreadcrumbButtonType, Breadcrumbs, type BreadcrumbsDivider, type BreadcrumbsProps, Button, ButtonCloseX, type ButtonCloseXProps, type ButtonCloseXSize, ButtonDestructive, type ButtonDestructiveHierarchy, type ButtonDestructiveProps, type ButtonDestructiveSize, ButtonGroup, type ButtonGroupProps, ButtonGroupSegment, type ButtonGroupSegmentProps, type ButtonGroupSegmentSize, type ButtonProps, ButtonUtility, type ButtonUtilityProps, type ButtonUtilitySize, type ButtonUtilityVariant, CalendarCell, CalendarCellDayWeekView, type CalendarCellDayWeekViewProps, type CalendarCellProps, CalendarColumnHeader, type CalendarColumnHeaderOrientation, type CalendarColumnHeaderProps, CalendarDateIcon, type CalendarDateIconProps, CalendarEvent, type CalendarEventColor, CalendarEventDayWeekView, type CalendarEventDayWeekViewProps, type CalendarEventProps, CalendarHeader, type CalendarHeaderProps, CalendarRowLabel, type CalendarRowLabelProps, CalendarTimemarker, type CalendarTimemarkerAlign, type CalendarTimemarkerProps, type CalendarView, CalendarViewDropdown, type CalendarViewDropdownProps, type CalendarViewOption, CardHeader, type CardHeaderProps, CarouselArrow, type CarouselArrowDirection, type CarouselArrowProps, type CarouselArrowSize, CarouselImage, type CarouselImageProps, Change, type ChangeProps, type ChangeTrend, type ChangeType, ChartLegend, type ChartLegendItem, type ChartLegendPosition, type ChartLegendProps, ChartMarker, type ChartMarkerLine, type ChartMarkerProps, ChartMini, type ChartMiniDatum, type ChartMiniProps, type ChartMiniTrend, type ChartSeries, type ChartStyle, ChartTooltip, type ChartTooltipPayloadItem, type ChartTooltipProps, type CheckControlSize, Checkbox, type CheckboxProps, CodeSnippet, type CodeSnippetProps, CodeSnippetTabs, type CodeSnippetTabsProps, ColorBadge, type ColorBadgeProps, CommandBar, CommandBarFooter, type CommandBarFooterHint, type CommandBarFooterProps, CommandBarMenuSection, type CommandBarMenuSectionProps, CommandBarNavigationIcon, type CommandBarNavigationIconProps, type CommandBarProps, CommandDropdownMenuItem, type CommandDropdownMenuItemProps, CommandInput, type CommandInputProps, CommandShortcut, type CommandShortcutProps, ContentDivider, type ContentDividerProps, type ContentDividerStyle, type ContentDividerType, ContentFeatureText, type ContentFeatureTextProps, type ContentFeatureTextSize, ContentHeading, type ContentHeadingProps, type ContentHeadingSize, ContentParagraph, type ContentParagraphProps, type ContentParagraphSize, ContentQuote, type ContentQuoteAlign, type ContentQuoteProps, type ContentQuoteSize, ContentRule, type ContentRuleProps, type ContentRuleSize, ContextMenu, type ContextMenuProps, type ContextMenuState, DatePickerCell, type DatePickerCellProps, type DatePickerCellType, DatePickerListItem, type DatePickerListItemProps, DatePickerMenu, type DatePickerMenuProps, DropdownAccountListItem, type DropdownAccountListItemProps, DropdownMenuFooter, type DropdownMenuFooterProps, type DropdownMenuFooterType, DropdownMenuHeader, type DropdownMenuHeaderProps, type DropdownMenuHeaderType, DropdownMenuItemInsetIcon, type DropdownMenuItemInsetIconProps, type DropdownMenuItemInsetIconType, DropdownMenuListItem, type DropdownMenuListItemProps, EmptyState, type EmptyStateProps, type EmptyStateSize, FeaturedIcon, type FeaturedIconColor, type FeaturedIconProps, type FeaturedIconSize, type FeaturedIconTheme, FeedItemBase, type FeedItemBaseProps, type FeedItemSize, FileUpload, FileUploadBase, type FileUploadBaseProps, FileUploadItemBase, type FileUploadItemBaseProps, type FileUploadItemIconType, type FileUploadItemStatus, type FileUploadItemType, type FileUploadProps, FilterBar, type FilterBarProps, FilterTabs, type FilterTabsProps, FiltersDropdownMenu, type FiltersDropdownMenuProps, FiltersSlideoutMenu, type FiltersSlideoutMenuProps, type HeaderNavItem, HeaderNavigation, type HeaderNavigationProps, type HeaderNavigationType, HelpIcon, type HelpIconProps, InputField, type InputFieldProps, type InputFieldSize, type InputFieldType, LeadingInputField, type LeadingInputFieldProps, LineAndBarChart, type LineAndBarChartProps, LinkMessage, type LinkMessageProps, type LinkMessageType, LoadingIndicator, type LoadingIndicatorProps, type LoadingIndicatorSize, type LoadingIndicatorStyle, MediaMessage, type MediaMessageProps, type MediaMessageType, MegaInputFieldBase, type MegaInputFieldBaseProps, type MegaInputFieldBaseSize, Message, MessageAction, MessageActionButton, type MessageActionButtonProps, MessageActionPanel, type MessageActionPanelProps, type MessageActionProps, type MessageActionType, type MessageBubbleTone, type MessageProps, MessageReaction, type MessageReactionProps, type MessageStatus, MessageStatusIcon, type MessageStatusIconProps, type MessageType, MetricItem, type MetricItemProps, Modal, ModalActions, type ModalActionsProps, type ModalActionsType, ModalHeader, type ModalHeaderProps, type ModalHeaderType, type ModalProps, type ModalSize, ModernBadge, type ModernBadgeProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavAccountCard, type NavAccountCardBreakpoint, NavAccountCardMenuItem, type NavAccountCardMenuItemProps, type NavAccountCardMenuItemType, type NavAccountCardProps, type NavAccountCardVariant, NavButton, type NavButtonProps, NavFeaturedCard, type NavFeaturedCardProps, NavItemBase, type NavItemBaseProps, NavItemDropdownBase, type NavItemDropdownBaseProps, NavMenuButton, type NavMenuButtonProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputLayout, type NumberInputProps, PageHeader, type PageHeaderProps, type PageHeaderStyle, Pagination, PaginationButtonGroupBase, type PaginationButtonGroupBaseProps, type PaginationButtonGroupType, PaginationCards, type PaginationCardsProps, type PaginationCardsVariant, PaginationDotGroup, type PaginationDotGroupProps, PaginationDotIndicator, type PaginationDotIndicatorProps, type PaginationDotSize, type PaginationDotVariant, PaginationNumberBase, type PaginationNumberBaseProps, type PaginationNumberShape, type PaginationProps, type PaginationType, PieChart, type PieChartProps, type PieChartSize, type PieSlice, PillBadge, type PillBadgeProps, ProgressBar, type ProgressBarLabel, type ProgressBarProps, ProgressCircle, type ProgressCircleProps, type ProgressCircleShape, type ProgressCircleSize, RadarChart, type RadarChartProps, type RadarLegendPosition, Radio, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupItemSize, type RadioGroupItemType, type RadioGroupProps, type RadioProps, SectionFooter, type SectionFooterProps, type SectionFooterType, SectionHeader, type SectionHeaderProps, SectionLabel, type SectionLabelProps, type SectionLabelSize, Select, SelectMenuItem, type SelectMenuItemProps, type SelectMenuItemSize, type SelectProps, type SelectSize, type SelectType, SidebarNavigation, type SidebarNavigationProps, type SidebarNavigationType, SlideOutMenuHeader, type SlideOutMenuHeaderProps, SlideoutMenu, type SlideoutMenuProps, type SlideoutMenuSide, type SlideoutMenuSize, Slider, type SliderLabel, type SliderProps, type SocialBrand, SocialButton, type SocialButtonProps, type SocialButtonSize, type SocialButtonTheme, StatusIcon, type StatusIconProps, type StatusIconType, StepBase, type StepBaseProps, StepIconBase, type StepIconBaseProps, type StepIconSize, type StepIconType, type StepOrientation, type StepStatus, TabButtonBase, type TabButtonBaseProps, type TabButtonSize, type TabButtonType, type TabItem, TableCell, type TableCellProps, type TableCellSize, TableHeaderCell, type TableHeaderCellProps, type TableHeaderCellSize, TableHeaderLabel, type TableHeaderLabelArrow, type TableHeaderLabelProps, Tabs, type TabsOrientation, type TabsProps, Tag, type TagProps, type TagSize, TagsInputField, type TagsInputFieldProps, type TagsInputVariant, TextEditorToolbar, TextEditorToolbarDivider, type TextEditorToolbarProps, TextEditorTooltip, type TextEditorTooltipProps, TextareaInputField, type TextareaInputFieldProps, Toggle, type ToggleProps, type ToggleSize, type ToggleType, Tooltip, type TooltipArrow, type TooltipProps, TrailingInputField, type TrailingInputFieldProps, type TreeNode, TreeView, TreeViewConnector, type TreeViewConnectorProps, type TreeViewConnectorSize, type TreeViewConnectorType, TreeViewItem, type TreeViewItemProps, type TreeViewItemSize, type TreeViewProps, type UseContextMenuReturn, type VerificationCodeDigits, VerificationCodeInput, type VerificationCodeInputProps, type VerificationCodeSize, index as illustrations, useContextMenu };
+export { ActivityFeed, type ActivityFeedDivider, type ActivityFeedProps, ActivityGauge, type ActivityGaugeLegend, type ActivityGaugeProps, type ActivityGaugeSeries, type ActivityGaugeSize, AdvancedFilterBar, type AdvancedFilterBarProps, Alert, type AlertAction, type AlertColor, type AlertProps, type AlertSize, Avatar, AvatarAddButton, type AvatarAddButtonProps, type AvatarAddButtonSize, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupSize, AvatarLabelGroup, type AvatarLabelGroupProps, type AvatarLabelGroupSize, AvatarProfilePhoto, type AvatarProfilePhotoProps, type AvatarProfilePhotoSize, type AvatarProps, type AvatarSize, BadgeCloseX, type BadgeCloseXProps, type BadgeCloseXShape, type BadgeColor, type BadgeCommonProps, BadgeGroup, type BadgeGroupBadgePosition, type BadgeGroupProps, type BadgeGroupSize, type BadgeGroupType, type BadgeSize, BreadcrumbButtonBase, type BreadcrumbButtonBaseProps, type BreadcrumbButtonType, Breadcrumbs, type BreadcrumbsDivider, type BreadcrumbsProps, Button, ButtonCloseX, type ButtonCloseXProps, type ButtonCloseXSize, ButtonDestructive, type ButtonDestructiveHierarchy, type ButtonDestructiveProps, type ButtonDestructiveSize, ButtonGroup, type ButtonGroupProps, ButtonGroupSegment, type ButtonGroupSegmentProps, type ButtonGroupSegmentSize, type ButtonProps, ButtonUtility, type ButtonUtilityProps, type ButtonUtilitySize, type ButtonUtilityVariant, type CalendarBreakpoint, CalendarCell, type CalendarCellBreakpoint, CalendarCellDayWeekView, type CalendarCellDayWeekViewProps, type CalendarCellEvent, type CalendarCellProps, CalendarColumnHeader, type CalendarColumnHeaderOrientation, type CalendarColumnHeaderProps, type CalendarColumnHeaderType, CalendarDateIcon, type CalendarDateIconProps, CalendarEvent, type CalendarEventBreakpoint, type CalendarEventColor, CalendarEventDayWeekView, type CalendarEventDayWeekViewProps, type CalendarEventProps, type CalendarEventState, CalendarHeader, type CalendarHeaderProps, CalendarRowLabel, type CalendarRowLabelProps, CalendarTimemarker, type CalendarTimemarkerAlign, type CalendarTimemarkerBreakpoint, type CalendarTimemarkerProps, type CalendarTimeslotState, type CalendarTimeslotType, type CalendarView, CalendarViewDropdown, type CalendarViewDropdownProps, type CalendarViewOption, CardHeader, type CardHeaderProps, CarouselArrow, type CarouselArrowDirection, type CarouselArrowProps, type CarouselArrowSize, CarouselImage, type CarouselImageProps, Change, type ChangeProps, type ChangeTrend, type ChangeType, ChartLegend, type ChartLegendItem, type ChartLegendPosition, type ChartLegendProps, ChartMarker, type ChartMarkerLine, type ChartMarkerProps, ChartMini, type ChartMiniDatum, type ChartMiniProps, type ChartMiniTrend, type ChartSeries, type ChartStyle, ChartTooltip, type ChartTooltipPayloadItem, type ChartTooltipProps, type CheckControlSize, Checkbox, type CheckboxProps, CodeSnippet, type CodeSnippetProps, CodeSnippetTabs, type CodeSnippetTabsProps, ColorBadge, type ColorBadgeProps, CommandBar, CommandBarFooter, type CommandBarFooterHint, type CommandBarFooterProps, CommandBarMenuSection, type CommandBarMenuSectionProps, CommandBarNavigationIcon, type CommandBarNavigationIconProps, type CommandBarProps, CommandDropdownMenuItem, type CommandDropdownMenuItemProps, CommandInput, type CommandInputProps, CommandShortcut, type CommandShortcutProps, ContentDivider, type ContentDividerProps, type ContentDividerStyle, type ContentDividerType, ContentFeatureText, type ContentFeatureTextProps, type ContentFeatureTextSize, ContentHeading, type ContentHeadingProps, type ContentHeadingSize, ContentParagraph, type ContentParagraphProps, type ContentParagraphSize, ContentQuote, type ContentQuoteAlign, type ContentQuoteProps, type ContentQuoteSize, ContentRule, type ContentRuleProps, type ContentRuleSize, ContextMenu, type ContextMenuProps, type ContextMenuState, DatePickerCell, type DatePickerCellProps, type DatePickerCellType, DatePickerListItem, type DatePickerListItemProps, DatePickerMenu, type DatePickerMenuProps, DropdownAccountListItem, type DropdownAccountListItemProps, DropdownMenuFooter, type DropdownMenuFooterProps, type DropdownMenuFooterType, DropdownMenuHeader, type DropdownMenuHeaderProps, type DropdownMenuHeaderType, DropdownMenuItemInsetIcon, type DropdownMenuItemInsetIconProps, type DropdownMenuItemInsetIconType, DropdownMenuListItem, type DropdownMenuListItemProps, EmptyState, type EmptyStateProps, type EmptyStateSize, FeaturedIcon, type FeaturedIconColor, type FeaturedIconProps, type FeaturedIconSize, type FeaturedIconTheme, FeedItemBase, type FeedItemBaseProps, type FeedItemSize, FileUpload, FileUploadBase, type FileUploadBaseProps, FileUploadItemBase, type FileUploadItemBaseProps, type FileUploadItemIconType, type FileUploadItemStatus, type FileUploadItemType, type FileUploadProps, FilterBar, type FilterBarProps, FilterTabs, type FilterTabsProps, FiltersDropdownMenu, type FiltersDropdownMenuProps, FiltersSlideoutMenu, type FiltersSlideoutMenuProps, type HeaderNavItem, HeaderNavigation, type HeaderNavigationProps, type HeaderNavigationType, HelpIcon, type HelpIconProps, InputField, type InputFieldProps, type InputFieldSize, type InputFieldType, LeadingInputField, type LeadingInputFieldProps, LineAndBarChart, type LineAndBarChartProps, LinkMessage, type LinkMessageProps, type LinkMessageType, LoadingIndicator, type LoadingIndicatorProps, type LoadingIndicatorSize, type LoadingIndicatorStyle, MediaMessage, type MediaMessageProps, type MediaMessageType, MegaInputFieldBase, type MegaInputFieldBaseProps, type MegaInputFieldBaseSize, Message, MessageAction, MessageActionButton, type MessageActionButtonProps, MessageActionPanel, type MessageActionPanelProps, type MessageActionProps, type MessageActionType, type MessageBubbleTone, type MessageProps, MessageReaction, type MessageReactionProps, type MessageStatus, MessageStatusIcon, type MessageStatusIconProps, type MessageType, MetricItem, type MetricItemProps, Modal, ModalActions, type ModalActionsProps, type ModalActionsType, ModalHeader, type ModalHeaderProps, type ModalHeaderType, type ModalProps, type ModalSize, ModernBadge, type ModernBadgeProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavAccountCard, type NavAccountCardBreakpoint, NavAccountCardMenuItem, type NavAccountCardMenuItemProps, type NavAccountCardMenuItemType, type NavAccountCardProps, type NavAccountCardVariant, NavButton, type NavButtonProps, NavFeaturedCard, type NavFeaturedCardProps, NavItemBase, type NavItemBaseProps, NavItemDropdownBase, type NavItemDropdownBaseProps, NavMenuButton, type NavMenuButtonProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputLayout, type NumberInputProps, PageHeader, type PageHeaderProps, type PageHeaderStyle, Pagination, PaginationButtonGroupBase, type PaginationButtonGroupBaseProps, type PaginationButtonGroupType, PaginationCards, type PaginationCardsProps, type PaginationCardsVariant, PaginationDotGroup, type PaginationDotGroupProps, PaginationDotIndicator, type PaginationDotIndicatorProps, type PaginationDotSize, type PaginationDotVariant, PaginationNumberBase, type PaginationNumberBaseProps, type PaginationNumberShape, type PaginationProps, type PaginationType, PieChart, type PieChartProps, type PieChartSize, type PieSlice, PillBadge, type PillBadgeProps, ProgressBar, type ProgressBarLabel, type ProgressBarProps, ProgressCircle, type ProgressCircleProps, type ProgressCircleShape, type ProgressCircleSize, RadarChart, type RadarChartProps, type RadarLegendPosition, Radio, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupItemSize, type RadioGroupItemType, type RadioGroupProps, type RadioProps, SectionFooter, type SectionFooterProps, type SectionFooterType, SectionHeader, type SectionHeaderProps, SectionLabel, type SectionLabelProps, type SectionLabelSize, Select, SelectMenuItem, type SelectMenuItemProps, type SelectMenuItemSize, type SelectProps, type SelectSize, type SelectType, SidebarNavigation, type SidebarNavigationProps, type SidebarNavigationType, SlideOutMenuHeader, type SlideOutMenuHeaderProps, SlideoutMenu, type SlideoutMenuProps, type SlideoutMenuSide, type SlideoutMenuSize, Slider, type SliderLabel, type SliderProps, type SocialBrand, SocialButton, type SocialButtonProps, type SocialButtonSize, type SocialButtonTheme, StatusIcon, type StatusIconProps, type StatusIconType, StepBase, type StepBaseProps, StepIconBase, type StepIconBaseProps, type StepIconSize, type StepIconType, type StepOrientation, type StepStatus, TabButtonBase, type TabButtonBaseProps, type TabButtonSize, type TabButtonType, type TabItem, TableCell, type TableCellProps, type TableCellSize, TableHeaderCell, type TableHeaderCellProps, type TableHeaderCellSize, TableHeaderLabel, type TableHeaderLabelArrow, type TableHeaderLabelProps, Tabs, type TabsOrientation, type TabsProps, Tag, type TagProps, type TagSize, TagsInputField, type TagsInputFieldProps, type TagsInputVariant, TextEditorToolbar, TextEditorToolbarDivider, type TextEditorToolbarProps, TextEditorTooltip, type TextEditorTooltipProps, TextareaInputField, type TextareaInputFieldProps, Toggle, type ToggleProps, type ToggleSize, type ToggleType, Tooltip, type TooltipArrow, type TooltipProps, TrailingInputField, type TrailingInputFieldProps, type TreeNode, TreeView, TreeViewConnector, type TreeViewConnectorProps, type TreeViewConnectorSize, type TreeViewConnectorType, TreeViewItem, type TreeViewItemProps, type TreeViewItemSize, type TreeViewProps, type UseContextMenuReturn, type VerificationCodeDigits, VerificationCodeInput, type VerificationCodeInputProps, type VerificationCodeSize, index as illustrations, useContextMenu };