@proyecto-viviana/solid-stately 0.6.0-rc.0 → 0.6.0-rc.1

package/dist/tokenfield/TokenFieldValue.d.ts

@@ -15,30 +15,54 @@ export interface Position {
     /** Text offset within the segment in UTF-16 code units. */
     offset: number;
 }
+/** Represents a text selection in a TokenField. */
+export declare class SelectedRange {
+    /** The anchor position. */
+    anchor: Position;
+    /** The current (i.e. caret) position. */
+    current: Position;
+    /**
+     * Creates a new selection range. If only a single position is provided, the selection is
+     * collapsed.
+     */
+    constructor(anchor: Position, current?: Position);
+    /** Whether the selection is collapsed to a single caret position. */
+    get isCollapsed(): boolean;
+    /** The side of the selection closest to the start of the value. */
+    get start(): Position;
+    /** The side of the selection closest to the end of the value. */
+    get end(): Position;
+    /** Returns whether this selection is equal to another. */
+    isEqual(other: SelectedRange): boolean;
+}
 declare enum Direction {
     Forward = 1,
     Backward = -1
 }
 export interface TokenFieldValueOptions {
-    caretPosition?: Position | null;
+    selectedRange?: SelectedRange | null;
 }
 /**
  * A list of segments containing editable text and non-editable tokens.
  */
 export declare class TokenFieldValue<T = any> {
     static readonly Direction: typeof Direction;
+    static readonly SelectedRange: typeof SelectedRange;
     /** The text and token segments in the list. */
     readonly segments: readonly TokenFieldSegment<T>[];
-    /** The caret position. */
-    caretPosition: Position;
+    /** The selected range. */
+    selectedRange: SelectedRange;
     private previous;
     private next;
     private isCoalescing;
     /** Create a new list with the given segments. */
     constructor(tokens: readonly TokenFieldSegment<T>[], options?: TokenFieldValueOptions);
+    get caretPosition(): Position;
     protected createFieldValue(segments: readonly TokenFieldSegment<T>[]): this;
+    /** Create a new list with the selected range set to the given range. */
+    withSelectedRange(selectedRange: SelectedRange): this;
     /** Create a new list with the caret position set to the given position. */
-    withCaretPosition(caretPosition: Position): this;
+    withCaretPosition(position: Position): this;
     private splitSegment;
     private createTextSegment;
     protected tokenize(text: string): TokenFieldSegment<T>[];

package/dist/tokenfield/TokenFieldValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenFieldValue.d.ts","sourceRoot":"","sources":["../../src/tokenfield/TokenFieldValue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TokenFieldValue.d.ts","sourceRoot":"","sources":["../../src/tokenfield/TokenFieldValue.ts"],"names":[],"mappings":"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"}

package/dist/tokenfield/index.d.ts

@@ -1,3 +1,3 @@
-export { TokenFieldValue, type TokenFieldSegment, type TextSegment, type TokenSegment, type Position, type TokenFieldValueOptions, } from "./TokenFieldValue";
+export { TokenFieldValue, type TokenFieldSegment, type TextSegment, type TokenSegment, type Position, type SelectedRange, type TokenFieldValueOptions, } from "./TokenFieldValue";
 export { createTokenFieldState, type TokenFieldStateOptions, type TokenFieldState, } from "./createTokenFieldState";
 //# sourceMappingURL=index.d.ts.map

package/dist/tokenfield/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokenfield/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokenfield/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/tree/createTreeState.d.ts

@@ -1,8 +1,8 @@
-import type { Accessor } from "solid-js";
 import type { TreeState, TreeStateOptions, TreeCollection } from "./types";
+import { type MaybeAccessor } from "../utils";
 /**
  * Creates state management for a tree component.
  * Handles expansion, selection, focus management, and keyboard navigation state.
  */
-export declare function createTreeState<T extends object, C extends TreeCollection<T> = TreeCollection<T>>(options: Accessor<TreeStateOptions<T, C>>): TreeState<T, C>;
+export declare function createTreeState<T extends object, C extends TreeCollection<T> = TreeCollection<T>>(options: MaybeAccessor<TreeStateOptions<T, C>>): TreeState<T, C>;
 //# sourceMappingURL=createTreeState.d.ts.map

package/dist/tree/createTreeState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTreeState.d.ts","sourceRoot":"","sources":["../../src/tree/createTreeState.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI3E;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAC/F,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACxC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CA8YjB"}
+{"version":3,"file":"createTreeState.d.ts","sourceRoot":"","sources":["../../src/tree/createTreeState.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3E,OAAO,EAAuC,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAC/F,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC7C,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAsZjB"}

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
-export { access, createInternalSignal, isAccessor, readNow, type MaybeAccessor, type MaybeAccessorValue, } from "./reactivity";
+export { access, createInternalSignal, isAccessor, propsAccessor, readNow, type MaybeAccessor, type MaybeAccessorValue, } from "./reactivity";
 export { useContextOptional } from "./owner";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/utils/reactivity.d.ts

@@ -26,6 +26,11 @@ export type MaybeAccessorValue<T> = T | undefined | Accessor<T | undefined>;
  * Checks if a value is an accessor function.
  */
 export declare function isAccessor<T>(value: MaybeAccessor<T>): value is Accessor<T>;
+/**
+ * Resolve a props bag once. Later reads call the accessor directly, so a
+ * function-valued field such as `getKey` is never treated as the bag.
+ */
+export declare function propsAccessor<T extends object>(props: MaybeAccessor<T>): Accessor<T>;
 /**
  * Headless state is written from factory setup and from public setters that
  * tests (and some call sites) invoke inside `createRoot` / a component body.

package/dist/utils/reactivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactivity.d.ts","sourceRoot":"","sources":["../../src/utils/reactivity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAA6B,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAEpD;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AAE5E;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAsBvF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAEnD"}
+{"version":3,"file":"reactivity.d.ts","sourceRoot":"","sources":["../../src/utils/reactivity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAA6B,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAEpD;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AAE5E;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAE3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAsBvF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAEnD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proyecto-viviana/solid-stately",
-  "version": "0.6.0-rc.0",
+  "version": "0.6.0-rc.1",
   "description": "A 1-1 SolidJS port of React Stately - headless state management for UI components",
   "keywords": [
     "headless",
@@ -38,7 +38,7 @@
       "default": "./dist/index.js"
     },
     "./private/flags/flags": {
-      "types": "./dist/flags/flags.d.ts",
+      "types": "./dist/private/flags/flags.d.ts",
       "import": "./dist/private/flags/flags.js",
       "default": "./dist/private/flags/flags.js"
     },

package/src/calendar/createCalendarState.ts

@@ -42,7 +42,7 @@ import {
   toCalendarDate as intlToCalendarDate,
   minDate,
 } from "@internationalized/date";
-import { access, createInternalSignal, readNow, type MaybeAccessor } from "../utils";
+import { access, createInternalSignal, propsAccessor, readNow, type MaybeAccessor } from "../utils";
 
 export type ValidationState = "valid" | "invalid";
 export type CalendarPageBehavior = "single" | "visible";
@@ -102,6 +102,8 @@ export interface CalendarStateProps<
   isDateDisabled?: (date: DateValue) => boolean;
   /** Validation state. */
   validationState?: MaybeAccessor<ValidationState | undefined>;
+  /** Whether the current selection is invalid according to application logic. */
+  isInvalid?: boolean;
   /** Error message. */
   errorMessage?: string;
   /** The first day of the week (0 = Sunday, 1 = Monday, etc.). */
@@ -206,21 +208,28 @@ export interface CalendarState<
 export function createCalendarState<
   T extends DateValue = CalendarDate,
   M extends CalendarSelectionMode = "single",
->(props: CalendarStateProps<T, M> = {}): CalendarState<T, M> {
+>(props: MaybeAccessor<CalendarStateProps<T, M>> = {}): CalendarState<T, M> {
+  const getProps = propsAccessor(props);
   const timeZone = getLocalTimeZone();
-  const locale = createMemo(() => access(props.locale) ?? "en-US");
-  const minValueState = createMemo(() => access(props.minValue) ?? null);
-  const maxValueState = createMemo(() => access(props.maxValue) ?? null);
+  const locale = createMemo(() => access(getProps().locale) ?? "en-US");
+  const minValueState = createMemo(() => access(getProps().minValue) ?? null);
+  const maxValueState = createMemo(() => access(getProps().maxValue) ?? null);
   const selectionMode = createMemo<CalendarSelectionMode>(
-    () => access(props.selectionMode) ?? "single",
+    () => access(getProps().selectionMode) ?? "single",
   );
   const resolvedOptions = createMemo(() => new DateFormatter(locale()).resolvedOptions());
   const calendar = createMemo(() =>
-    (props.createCalendar ?? intlCreateCalendar)(resolvedOptions().calendar as CalendarIdentifier),
+    (getProps().createCalendar ?? intlCreateCalendar)(
+      resolvedOptions().calendar as CalendarIdentifier,
+    ),
   );
-  const visibleMonths = createMemo(() => Math.max(1, Number(access(props.visibleMonths) ?? 1)));
-  const firstDayOfWeekName = (): CalendarDayOfWeek | undefined =>
-    props.firstDayOfWeek == null ? undefined : dayOfWeekNames[props.firstDayOfWeek];
+  const visibleMonths = createMemo(() =>
+    Math.max(1, Number(access(getProps().visibleMonths) ?? 1)),
+  );
+  const firstDayOfWeekName = (): CalendarDayOfWeek | undefined => {
+    const firstDayOfWeek = getProps().firstDayOfWeek;
+    return firstDayOfWeek == null ? undefined : dayOfWeekNames[firstDayOfWeek];
+  };
 
   const toDisplayCalendarDate = (date: DateValue): CalendarDate =>
     intlToCalendar(toCalendarDate(date), calendar());
@@ -228,7 +237,7 @@ export function createCalendarState<
   const selectionAlignmentOffset = (): number => {
     // Mirrors @react-stately/calendar useCalendarState, where selectionAlignment
     // defaults to "center" (alignCenter) when not provided.
-    switch (props.selectionAlignment) {
+    switch (getProps().selectionAlignment) {
       case "start":
         return 0;
       case "end":
@@ -244,9 +253,44 @@ export function createCalendarState<
     }
   };
 
+  const rawAlignStart = (date: CalendarDate): CalendarDate => startOfMonth(date);
+
+  const rawAlignEnd = (date: CalendarDate, months: number): CalendarDate =>
+    startOfMonth(date).subtract({ months: Math.max(months - 1, 0) });
+
+  // Month-duration constrainStart. The focused date only gates the clamp.
+  // alignStart(min) and alignEnd(max) take no min/max of their own. Compare
+  // instead of maxDate/minDate so a cross-calendar null is not introduced.
+  const constrainVisibleRangeStart = (
+    date: CalendarDate,
+    aligned: CalendarDate,
+    months: number,
+  ): CalendarDate => {
+    const minValue = access(getProps().minValue);
+    const maxValue = access(getProps().maxValue);
+    let constrained = aligned;
+
+    if (minValue && date.compare(toDisplayCalendarDate(minValue)) >= 0) {
+      const minStart = rawAlignStart(toDisplayCalendarDate(minValue));
+      if (minStart.compare(constrained) > 0) {
+        constrained = minStart;
+      }
+    }
+
+    if (maxValue && date.compare(toDisplayCalendarDate(maxValue)) <= 0) {
+      const maxStart = rawAlignEnd(toDisplayCalendarDate(maxValue), months);
+      if (maxStart.compare(constrained) < 0) {
+        constrained = maxStart;
+      }
+    }
+
+    return constrained;
+  };
+
   const alignVisibleRangeStart = (date: CalendarDate): CalendarDate => {
     const offset = selectionAlignmentOffset();
-    return startOfMonth(offset > 0 ? date.subtract({ months: offset }) : date);
+    const aligned = rawAlignStart(offset > 0 ? date.subtract({ months: offset }) : date);
+    return constrainVisibleRangeStart(date, aligned, visibleMonths());
   };
 
   const visibleRangeEnd = (start: CalendarDate): CalendarDate => {
@@ -260,8 +304,8 @@ export function createCalendarState<
   };
 
   const constrainDate = (date: CalendarDate): CalendarDate => {
-    const minValue = access(props.minValue);
-    const maxValue = access(props.maxValue);
+    const minValue = access(getProps().minValue);
+    const maxValue = access(getProps().maxValue);
 
     let constrained = date;
 
@@ -277,23 +321,28 @@ export function createCalendarState<
 
   // Determine the initially focused date
   const getInitialFocusedDate = (): CalendarDate => {
-    const controlledFocused = access(props.focusedValue);
+    const controlledFocused = access(getProps().focusedValue);
     if (controlledFocused) {
       return toDisplayCalendarDate(controlledFocused);
     }
-    if (props.defaultFocusedValue) {
-      return toDisplayCalendarDate(props.defaultFocusedValue);
+    const defaultFocusedValue = getProps().defaultFocusedValue;
+    if (defaultFocusedValue) {
+      return toDisplayCalendarDate(defaultFocusedValue);
     }
-    const controlledValue = access(props.value);
-    const controlledFirst = Array.isArray(controlledValue) ? controlledValue[0] : controlledValue;
-    if (controlledFirst) {
-      return toDisplayCalendarDate(controlledFirst);
-    }
-    const defaultFirst = Array.isArray(props.defaultValue)
-      ? props.defaultValue[0]
-      : props.defaultValue;
-    if (defaultFirst) {
-      return toDisplayCalendarDate(defaultFirst);
+    // A controlled null is a cleared selection. Pin useControlledState treats
+    // `value !== undefined` as controlled, so null must not fall through to defaultValue.
+    const controlledValue = access(getProps().value);
+    if (controlledValue !== undefined) {
+      const controlledFirst = Array.isArray(controlledValue) ? controlledValue[0] : controlledValue;
+      if (controlledFirst) {
+        return toDisplayCalendarDate(controlledFirst);
+      }
+    } else {
+      const defaultValue = getProps().defaultValue;
+      const defaultFirst = Array.isArray(defaultValue) ? defaultValue[0] : defaultValue;
+      if (defaultFirst) {
+        return toDisplayCalendarDate(defaultFirst);
+      }
     }
     return intlToCalendar(today(timeZone), calendar());
   };
@@ -301,7 +350,7 @@ export function createCalendarState<
   // State signals
   const initialFocusedDate = constrainDate(getInitialFocusedDate());
   const [internalValue, setInternalValue] = createInternalSignal<T | T[] | null>(
-    (props.defaultValue as T | T[] | null) ?? null,
+    (getProps().defaultValue as T | T[] | null) ?? null,
   );
   const [focusedDate, setFocusedDateInternal] =
     createInternalSignal<CalendarDate>(initialFocusedDate);
@@ -311,12 +360,12 @@ export function createCalendarState<
   // Init from autoFocus, mirroring @react-stately useCalendarState
   // (`useState(props.autoFocus || false)`). Without autoFocus the calendar
   // mounts unfocused and never steals DOM focus.
-  const [isFocused, setFocused] = createInternalSignal(props.autoFocus ?? false);
+  const [isFocused, setFocused] = createInternalSignal(getProps().autoFocus ?? false);
   const [isPaginating, setIsPaginating] = createInternalSignal(false);
 
   // Controlled vs uncontrolled value
   const sourceValue = createMemo<T | T[] | null>(() => {
-    const controlled = access(props.value);
+    const controlled = access(getProps().value);
     return controlled !== undefined ? (controlled as T | T[] | null) : internalValue();
   });
   const value = createMemo<T | T[] | null>(() => {
@@ -328,10 +377,34 @@ export function createCalendarState<
   });
 
   // Derived states
-  const isDisabled = createMemo(() => access(props.isDisabled) ?? false);
-  const isReadOnly = createMemo(() => access(props.isReadOnly) ?? false);
-  const validationState = createMemo(() => access(props.validationState));
-  const isValueInvalid = createMemo(() => validationState() === "invalid");
+  const isDisabled = createMemo(() => access(getProps().isDisabled) ?? false);
+  const isReadOnly = createMemo(() => access(getProps().isReadOnly) ?? false);
+  const validationState = createMemo(() => access(getProps().validationState));
+  // A value is invalid when the caller says so, validationState is invalid,
+  // or a selected date is unavailable or outside min/max. Mirrors useCalendarState.
+  const isInvalidSelection = createMemo(() => {
+    const current = value();
+    if (current == null) return false;
+    const dates = Array.isArray(current) ? current : [current];
+    const min = access(getProps().minValue);
+    const max = access(getProps().maxValue);
+    const minCal = min != null ? toDisplayCalendarDate(min) : null;
+    const maxCal = max != null ? toDisplayCalendarDate(max) : null;
+    return dates.some((date) => {
+      const cal = toDisplayCalendarDate(date);
+      return (
+        Boolean(getProps().isDateUnavailable?.(cal)) ||
+        (minCal != null && cal.compare(minCal) < 0) ||
+        (maxCal != null && cal.compare(maxCal) > 0)
+      );
+    });
+  });
+  const isValueInvalid = createMemo(
+    () =>
+      Boolean(access(getProps().isInvalid)) ||
+      validationState() === "invalid" ||
+      isInvalidSelection(),
+  );
 
   // Visible range based on the paged range start. Function (not memo) so
   // onFocusChange snapshots see the live page after a same-turn write.
@@ -348,15 +421,19 @@ export function createCalendarState<
     months: number,
   ) => {
     if (nextFocusedDate.compare(range.start) < 0) {
-      setVisibleRangeStart(startOfMonth(nextFocusedDate.subtract({ months: months - 1 })));
+      setVisibleRangeStart(
+        constrainVisibleRangeStart(nextFocusedDate, rawAlignEnd(nextFocusedDate, months), months),
+      );
     } else if (nextFocusedDate.compare(range.end) > 0) {
-      setVisibleRangeStart(startOfMonth(nextFocusedDate));
+      setVisibleRangeStart(
+        constrainVisibleRangeStart(nextFocusedDate, rawAlignStart(nextFocusedDate), months),
+      );
     }
   };
 
   createEffect(
     () => {
-      const controlledFocused = access(props.focusedValue);
+      const controlledFocused = access(getProps().focusedValue);
       if (!controlledFocused) return null;
       return {
         nextFocusedDate: constrainDate(toDisplayCalendarDate(controlledFocused)),
@@ -380,7 +457,7 @@ export function createCalendarState<
 
   createEffect(
     () => {
-      const controlledFocused = access(props.focusedValue);
+      const controlledFocused = access(getProps().focusedValue);
       if (controlledFocused) return null;
       const currentFocusedDate = focusedDate();
       const nextFocusedDate = constrainDate(currentFocusedDate);
@@ -401,7 +478,7 @@ export function createCalendarState<
       if (!data) return;
       syncVisibleRangeForFocusedDate(data.nextFocusedDate, data.range, data.months);
       setFocusedDateInternal(data.nextFocusedDate);
-      props.onFocusChange?.(data.nextFocusedDate);
+      getProps().onFocusChange?.(data.nextFocusedDate);
     },
   );
 
@@ -455,12 +532,12 @@ export function createCalendarState<
   // selectable when isDateUnavailable is set. Mirrors useCalendarState.normalizeValue.
   const normalizeValue = (newValue: CalendarDate): T | null => {
     const constrained = constrainDate(newValue);
-    const minBound = access(props.minValue);
+    const minBound = access(getProps().minValue);
     const lowerBound =
       minBound != null
         ? toDisplayCalendarDate(minBound)
         : (minDate(constrained, visibleRange().start) ?? constrained);
-    const prev = previousAvailableDate(constrained, lowerBound, props.isDateUnavailable);
+    const prev = previousAvailableDate(constrained, lowerBound, getProps().isDateUnavailable);
     if (!prev) {
       return null;
     }
@@ -491,13 +568,13 @@ export function createCalendarState<
       nextValue = localValue;
     }
 
-    const controlled = access(props.value);
+    const controlled = access(getProps().value);
     if (controlled === undefined) {
       setInternalValue(() => nextValue);
     }
 
-    if (!Object.is(oldValue, nextValue) && props.onChange) {
-      props.onChange(nextValue as CalendarValueType<T | null, M>);
+    if (!Object.is(oldValue, nextValue)) {
+      getProps().onChange?.(nextValue as CalendarValueType<T | null, M>);
     }
   };
 
@@ -511,7 +588,7 @@ export function createCalendarState<
 
     syncVisibleRangeForFocusedDate(constrained, visibleRange(), visibleMonths());
     setFocusedDateInternal(constrained);
-    props.onFocusChange?.(constrained);
+    getProps().onFocusChange?.(constrained);
   };
 
   // Check if a date is selected
@@ -536,16 +613,16 @@ export function createCalendarState<
 
   // Check if a date is unavailable
   const isCellUnavailable = (date: DateValue): boolean => {
-    return props.isDateUnavailable?.(date) ?? false;
+    return getProps().isDateUnavailable?.(date) ?? false;
   };
 
   // Check if a date is disabled
   const isCellDisabled = (date: DateValue): boolean => {
     if (isDisabled()) return true;
-    if (props.isDateDisabled?.(date)) return true;
+    if (getProps().isDateDisabled?.(date)) return true;
 
-    const minValue = access(props.minValue);
-    const maxValue = access(props.maxValue);
+    const minValue = access(getProps().minValue);
+    const maxValue = access(getProps().maxValue);
     const calDate = toDisplayCalendarDate(date);
 
     // Dates outside the visible range are disabled, mirroring
@@ -601,21 +678,25 @@ export function createCalendarState<
   // Navigation methods
   const focusPreviousPage = () => {
     setIsPaginating(true);
-    const pageMonths = props.pageBehavior === "single" ? 1 : visibleMonths();
-    const nextFocusedDate = constrainDate(focusedDate().subtract({ months: pageMonths }));
+    const pageMonths = getProps().pageBehavior === "single" ? 1 : visibleMonths();
+    const currentFocused = focusedDate();
+    const nextFocusedDate = constrainDate(currentFocused.subtract({ months: pageMonths }));
+    const slidStart = startOfMonth(visibleRangeStart().subtract({ months: pageMonths }));
     setFocusedDateInternal(nextFocusedDate);
-    setVisibleRangeStart(startOfMonth(visibleRangeStart().subtract({ months: pageMonths })));
-    props.onFocusChange?.(nextFocusedDate);
+    setVisibleRangeStart(constrainVisibleRangeStart(currentFocused, slidStart, pageMonths));
+    getProps().onFocusChange?.(nextFocusedDate);
     setIsPaginating(false);
   };
 
   const focusNextPage = () => {
     setIsPaginating(true);
-    const pageMonths = props.pageBehavior === "single" ? 1 : visibleMonths();
-    const nextFocusedDate = constrainDate(focusedDate().add({ months: pageMonths }));
+    const pageMonths = getProps().pageBehavior === "single" ? 1 : visibleMonths();
+    const currentFocused = focusedDate();
+    const nextFocusedDate = constrainDate(currentFocused.add({ months: pageMonths }));
+    const slidStart = startOfMonth(visibleRangeStart().add({ months: pageMonths }));
     setFocusedDateInternal(nextFocusedDate);
-    setVisibleRangeStart(startOfMonth(visibleRangeStart().add({ months: pageMonths })));
-    props.onFocusChange?.(nextFocusedDate);
+    setVisibleRangeStart(constrainVisibleRangeStart(currentFocused, slidStart, pageMonths));
+    getProps().onFocusChange?.(nextFocusedDate);
     setIsPaginating(false);
   };
 
@@ -671,7 +752,7 @@ export function createCalendarState<
     if (isReadOnly() || isDisabled()) return;
 
     if (selectionMode() === "multiple") {
-      const current = access(props.value) !== undefined ? value() : readNow(internalValue);
+      const current = access(getProps().value) !== undefined ? value() : readNow(internalValue);
       const base: CalendarDate[] = Array.isArray(current)
         ? current.map((v) => toDisplayCalendarDate(v))
         : current != null

package/src/calendar/createDatePickerState.ts

@@ -64,8 +64,10 @@ export interface DatePickerState<T extends DateValue = DateValue> {
   value: Accessor<T | null>;
   defaultValue: T | null;
   setValue: (value: T | null) => void;
+  /** Committed value, or the in-progress date before the other half commits. */
   dateValue: Accessor<DateValue | null>;
   setDateValue: (value: DateValue) => void;
+  /** Committed value when it has a time; otherwise the in-progress time. */
   timeValue: Accessor<TimeValue | null>;
   setTimeValue: (value: TimeValue) => void;
   granularity: Granularity;
@@ -129,18 +131,19 @@ export function createDatePickerState<T extends DateValue = DateValue>(
   const validationState = createMemo(() => access(props.validationState));
   const isOpen: Accessor<boolean> = () => access(props.isOpen) ?? readNow(internalOpen);
 
-  // Date and time portions of the current value
-  const dateValue = createMemo<DateValue | null>(() => {
-    const v = value();
-    if (!v) return null;
-    return toCalendarDate(v);
-  });
+  // useDatePickerState shadows selectedDate/selectedTime with the committed
+  // value during render. Otherwise the popover reads the in-progress half.
+  const dateValue: Accessor<DateValue | null> = () => {
+    const committed = value();
+    if (committed) return committed;
+    return selectedDate();
+  };
 
-  const timeValue = createMemo<TimeValue | null>(() => {
-    const v = value();
-    if (!v || !("hour" in v)) return null;
-    return v as unknown as TimeValue;
-  });
+  const timeValue: Accessor<TimeValue | null> = () => {
+    const committed = value();
+    if (committed && "hour" in committed) return committed as unknown as TimeValue;
+    return selectedTime();
+  };
 
   // Helper to resolve placeholder time (midnight fallback)
   const getPlaceholderTime = (): TimeValue => {