@foldkit/ui 0.126.0 → 0.128.0

package/dist/datePicker/index.d.ts

@@ -6,16 +6,13 @@ import { type ChildAttribute, type Html } from 'foldkit/html';
 import { type Reflect } from 'foldkit/submodel';
 import type { AnchorConfig } from '../anchor.js';
 import * as UiCalendar from '../calendar/index.js';
-/** Schema for the date picker component's state. Holds the selected date,
- * the embedded Calendar submodel (the visible grid), and the embedded Popover
- * submodel (the open/close + transition layer). */
+/** Schema for the date picker component's private interaction state. The
+ * selected date is owned by the parent and passed in via
+ * `ViewInputs.maybeSelectedDate`. This holds the embedded Calendar submodel
+ * (the visible grid) and the embedded Popover submodel (the open/close +
+ * transition layer). */
 export declare const Model: S.Struct<{
     readonly id: S.String;
-    readonly maybeSelectedDate: S.Option<S.Struct<{
-        readonly year: S.Int;
-        readonly month: S.Int;
-        readonly day: S.Int;
-    }>>;
     readonly calendar: S.Struct<{
         readonly id: S.String;
         readonly today: S.Struct<{
@@ -31,11 +28,6 @@ export declare const Model: S.Struct<{
             readonly month: S.Int;
             readonly day: S.Int;
         }>>;
-        readonly maybeSelectedDate: S.Option<S.Struct<{
-            readonly year: S.Int;
-            readonly month: S.Int;
-            readonly day: S.Int;
-        }>>;
         readonly isGridFocused: S.Boolean;
         readonly locale: S.Struct<{
             readonly firstDayOfWeek: S.Literals<readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]>;
@@ -144,8 +136,8 @@ export declare const ChangedViewMonth: import("foldkit/schema").CallableTaggedSt
     month: S.Int;
 }>;
 /** Emitted when the user commits a date selection (propagated from the
- * embedded Calendar). The popover has already closed; the parent reads the
- * committed date and lifts it into domain state. */
+ * embedded Calendar). The popover has already closed; the parent stores the
+ * committed date and passes it back in as `maybeSelectedDate`. */
 export declare const SelectedDate: import("foldkit/schema").CallableTaggedStruct<"SelectedDate", {
     date: S.Struct<{
         readonly year: S.Int;
@@ -153,6 +145,9 @@ export declare const SelectedDate: import("foldkit/schema").CallableTaggedStruct
         readonly day: S.Int;
     }>;
 }>;
+/** Emitted when the user clears the selected date. The parent clears its own
+ * value field. */
+export declare const ClearedDate: import("foldkit/schema").CallableTaggedStruct<"ClearedDate", {}>;
 /** Union of out-messages the date picker can produce. */
 export declare const OutMessage: S.Union<readonly [import("foldkit/schema").CallableTaggedStruct<"ChangedViewMonth", {
     year: S.Int;
@@ -163,15 +158,16 @@ export declare const OutMessage: S.Union<readonly [import("foldkit/schema").Call
         readonly month: S.Int;
         readonly day: S.Int;
     }>;
-}>]>;
+}>, import("foldkit/schema").CallableTaggedStruct<"ClearedDate", {}>]>;
 export type OutMessage = typeof OutMessage.Type;
 export type ChangedViewMonth = typeof ChangedViewMonth.Type;
 export type SelectedDate = typeof SelectedDate.Type;
+export type ClearedDate = typeof ClearedDate.Type;
 /** Configuration for creating a date picker model with `init`. */
 export type InitConfig = Readonly<{
     id: string;
     today: CalendarDate;
-    initialSelectedDate?: CalendarDate;
+    initialViewDate?: CalendarDate;
     isAnimated?: boolean;
     locale?: Calendar.LocaleConfig;
     minDate?: CalendarDate;
@@ -179,10 +175,12 @@ export type InitConfig = Readonly<{
     disabledDaysOfWeek?: ReadonlyArray<Calendar.DayOfWeek>;
     disabledDates?: ReadonlyArray<CalendarDate>;
 }>;
-/** Creates an initial date picker model from a config. The calendar and
- * popover submodels are created with derived ids so their DOM elements stay
- * addressable. The popover is opened in `contentFocus` mode so focus lands on
- * the calendar grid instead of the panel. */
+/** Creates an initial date picker model from a config. The selected date is
+ * owned by the parent; pass its current value as `initialViewDate` to open the
+ * calendar onto that month. The calendar and popover submodels are created
+ * with derived ids so their DOM elements stay addressable. The popover is
+ * opened in `contentFocus` mode so focus lands on the calendar grid instead of
+ * the panel. */
 export declare const init: (config: InitConfig) => Model;
 type UpdateReturn = readonly [
     Model,
@@ -201,16 +199,12 @@ export declare const close: (model: Model) => UpdateReturn;
 export declare const selectDate: (model: Model, date: CalendarDate) => UpdateReturn;
 /** Programmatically clears the selected date. */
 export declare const clear: (model: Model) => UpdateReturn;
-/** Reflects an externally-sourced selected date onto the date picker
- *  without emitting an OutMessage or touching the popover. Sets the
- *  picker's selection and reflects it onto the embedded calendar (moving
- *  the calendar's view to the date), mirroring `selectDate`'s state change
- *  minus the `SelectedDate` announcement and the popover close. Pass
- *  `Option.none()` to clear. Use this to mirror external truth (a URL
- *  parameter, a saved draft) onto the picker. Contrast with `selectDate`,
- *  a user or programmatic *choice* that emits `SelectedDate`. Returns the
- *  model directly because it produces no commands and no OutMessage. */
-export declare const reflectSelectedDate: Reflect<Model, Option.Option<CalendarDate>>;
+/** Moves the embedded calendar's view and cursor to a date without changing
+ *  the selection (which the parent owns). Use it to navigate the picker onto a
+ *  known date, for example after the parent sets its value externally (a URL
+ *  parameter, a saved draft) so opening the picker shows that month. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export declare const focusDate: Reflect<Model, CalendarDate>;
 /** Reflects the minimum selectable date onto the embedded calendar. Pass
  * `Option.none()` to remove the minimum. Use this when the minimum derives
  * from other Model state (e.g. a start date field whose current selection
@@ -246,6 +240,10 @@ export declare const triggerId: (id: string) => string;
  *  `DatePicker.update`'s return) to lift the date into domain state. */
 export type ViewInputs = Readonly<{
     anchor: AnchorConfig;
+    /** The selected date, read straight from the parent Model. The trigger
+     * content, the calendar's selected-day marker, and the hidden form input all
+     * derive from it. */
+    maybeSelectedDate: Option.Option<CalendarDate>;
     /** Renders the trigger button's content (typically the formatted selected
      * date or a placeholder). Receives the current selection. */
     triggerContent: (maybeDate: Option.Option<CalendarDate>) => Html;
@@ -276,11 +274,6 @@ export type ViewInputs = Readonly<{
  * focus choreography, open/close state, and form submission. */
 export declare const view: import("foldkit/submodel").View<S.Struct.ReadonlySide<{
     readonly id: S.String;
-    readonly maybeSelectedDate: S.Option<S.Struct<{
-        readonly year: S.Int;
-        readonly month: S.Int;
-        readonly day: S.Int;
-    }>>;
     readonly calendar: S.Struct<{
         readonly id: S.String;
         readonly today: S.Struct<{
@@ -296,11 +289,6 @@ export declare const view: import("foldkit/submodel").View<S.Struct.ReadonlySide
             readonly month: S.Int;
             readonly day: S.Int;
         }>>;
-        readonly maybeSelectedDate: S.Option<S.Struct<{
-            readonly year: S.Int;
-            readonly month: S.Int;
-            readonly day: S.Int;
-        }>>;
         readonly isGridFocused: S.Boolean;
         readonly locale: S.Struct<{
             readonly firstDayOfWeek: S.Literals<readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]>;
@@ -386,6 +374,10 @@ export declare const view: import("foldkit/submodel").View<S.Struct.ReadonlySide
     readonly _tag: S.tag<"Cleared">;
 }, "Type">, Readonly<{
     anchor: AnchorConfig;
+    /** The selected date, read straight from the parent Model. The trigger
+     * content, the calendar's selected-day marker, and the hidden form input all
+     * derive from it. */
+    maybeSelectedDate: Option.Option<CalendarDate>;
     /** Renders the trigger button's content (typically the formatted selected
      * date or a placeholder). Receives the current selection. */
     triggerContent: (maybeDate: Option.Option<CalendarDate>) => Html;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datePicker/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAa,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC7E,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAQ,MAAM,cAAc,CAAA;AAGnE,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,kBAAkB,CAAA;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAA;AAMlD;;;;wBAIwB;AACxB,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhB,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAIrC,wDAAwD;AACxD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAA;AACF,uDAAuD;AACvD,eAAO,MAAM,iBAAiB;;;;;;;EAE5B,CAAA;AACF;gEACgE;AAChE,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAA;AACF,+EAA+E;AAC/E,eAAO,MAAM,OAAO,8DAAe,CAAA;AACnC;4EAC4E;AAC5E,eAAO,MAAM,MAAM,6DAAc,CAAA;AACjC;kCACkC;AAClC,eAAO,MAAM,MAAM,6DAAc,CAAA;AAEjC,mEAAmE;AACnE,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,KAAK,CAC3B;IACE,OAAO,kBAAkB;IACzB,OAAO,iBAAiB;IACxB,OAAO,mBAAmB;IAC1B,OAAO,OAAO;IACd,OAAO,MAAM;IACb,OAAO,MAAM;CACd,CAQD,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAIzC;sDACsD;AACtD,eAAO,MAAM,gBAAgB;;;EAG3B,CAAA;AAEF;;kEAEkE;AAClE,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAA;AAEF;kBACkB;AAClB,eAAO,MAAM,WAAW,kEAAmB,CAAA;AAE3C,yDAAyD;AACzD,eAAO,MAAM,UAAU;;;;;;;;;sEAAyD,CAAA;AAChF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AACnD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAIjD,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,YAAY,CAAA;IACnB,eAAe,CAAC,EAAE,YAAY,CAAA;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAA;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,kBAAkB,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACtD,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CAC5C,CAAC,CAAA;AAEF;;;;;gBAKgB;AAChB,eAAO,MAAM,IAAI,GAAI,QAAQ,UAAU,KAAG,KAuBxC,CAAA;AAIF,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK;IACL,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAC1B,CAAA;AAgFD;0BAC0B;AAC1B,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,YAuDrD,CAAA;AAEH;oEACoE;AACpE,eAAO,MAAM,IAAI,GAAI,OAAO,KAAK,KAAG,YAAuC,CAAA;AAE3E,kFAAkF;AAClF,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,KAAG,YAAuC,CAAA;AAE5E,sJAAsJ;AACtJ,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,EAAE,MAAM,YAAY,KAAG,YAChB,CAAA;AAE9C,iDAAiD;AACjD,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,KAAG,YAAwC,CAAA;AAE7E;;;;4EAI4E;AAC5E,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,YAAY,CAMlD,CAAA;AAED;;;;;;;uEAOuE;AACvE,eAAO,MAAM,cAAc,EAAE,OAAO,CAClC,KAAK,EACL,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAO5B,CAAA;AAED;;gBAEgB;AAChB,eAAO,MAAM,cAAc,EAAE,OAAO,CAClC,KAAK,EACL,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAO5B,CAAA;AAED;;gBAEgB;AAChB,eAAO,MAAM,oBAAoB,EAAE,OAAO,CACxC,KAAK,EACL,aAAa,CAAC,YAAY,CAAC,CAQ5B,CAAA;AAED;;wBAEwB;AACxB,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAC7C,KAAK,EACL,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAclC,CAAA;AAID;;;;yCAIyC;AACzC,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,MAAgC,CAAA;AAMvE;;;;;wEAKwE;AACxE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB;;yBAEqB;IACrB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IAC9C;iEAC6D;IAC7D,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI,CAAA;IAChE;;6BAEyB;IACzB,cAAc,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,KAAK,IAAI,CAAA;IACnE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;wDAEoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kBAAkB,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;CACnD,CAAC,CAAA;AAEF;;;;gEAIgE;AAChE,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAlCP,YAAY;IACpB;;yBAEqB;uBACF,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC9C;iEAC6D;oBAC7C,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI;IAChE;;6BAEyB;oBACT,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,KAAK,IAAI;iBACtD,OAAO;IACpB;;wDAEoD;WAC7C,MAAM;gBACD,MAAM;iBACL,aAAa,CAAC,cAAc,CAAC;uBACvB,MAAM;wBACL,aAAa,CAAC,cAAc,CAAC;gBACrC,MAAM;qBACD,MAAM;qBACN,MAAM;sBACL,aAAa,CAAC,cAAc,CAAC;wBAC3B,MAAM;yBACL,aAAa,CAAC,cAAc,CAAC;GAyHnD,CAAA"}

package/dist/datePicker/index.js

@@ -9,12 +9,13 @@ import * as UiCalendar from '../calendar/index.js';
 import { idSelector } from '../internal/selectors.js';
 import * as Popover from '../popover/index.js';
 // MODEL
-/** Schema for the date picker component's state. Holds the selected date,
- * the embedded Calendar submodel (the visible grid), and the embedded Popover
- * submodel (the open/close + transition layer). */
+/** Schema for the date picker component's private interaction state. The
+ * selected date is owned by the parent and passed in via
+ * `ViewInputs.maybeSelectedDate`. This holds the embedded Calendar submodel
+ * (the visible grid) and the embedded Popover submodel (the open/close +
+ * transition layer). */
 export const Model = S.Struct({
     id: S.String,
-    maybeSelectedDate: S.Option(Calendar.CalendarDate),
     calendar: UiCalendar.Model,
     popover: Popover.Model,
 });
@@ -57,25 +58,29 @@ export const ChangedViewMonth = m('ChangedViewMonth', {
     month: S.Int,
 });
 /** Emitted when the user commits a date selection (propagated from the
- * embedded Calendar). The popover has already closed; the parent reads the
- * committed date and lifts it into domain state. */
+ * embedded Calendar). The popover has already closed; the parent stores the
+ * committed date and passes it back in as `maybeSelectedDate`. */
 export const SelectedDate = m('SelectedDate', {
     date: Calendar.CalendarDate,
 });
+/** Emitted when the user clears the selected date. The parent clears its own
+ * value field. */
+export const ClearedDate = m('ClearedDate');
 /** Union of out-messages the date picker can produce. */
-export const OutMessage = S.Union([ChangedViewMonth, SelectedDate]);
-/** Creates an initial date picker model from a config. The calendar and
- * popover submodels are created with derived ids so their DOM elements stay
- * addressable. The popover is opened in `contentFocus` mode so focus lands on
- * the calendar grid instead of the panel. */
+export const OutMessage = S.Union([ChangedViewMonth, SelectedDate, ClearedDate]);
+/** Creates an initial date picker model from a config. The selected date is
+ * owned by the parent; pass its current value as `initialViewDate` to open the
+ * calendar onto that month. The calendar and popover submodels are created
+ * with derived ids so their DOM elements stay addressable. The popover is
+ * opened in `contentFocus` mode so focus lands on the calendar grid instead of
+ * the panel. */
 export const init = (config) => ({
     id: config.id,
-    maybeSelectedDate: Option.fromNullishOr(config.initialSelectedDate),
     calendar: UiCalendar.init({
         id: `${config.id}-calendar`,
         today: config.today,
-        ...(config.initialSelectedDate !== undefined && {
-            initialSelectedDate: config.initialSelectedDate,
+        ...(config.initialViewDate !== undefined && {
+            initialViewDate: config.initialViewDate,
         }),
         ...(config.locale !== undefined && { locale: config.locale }),
         ...(config.minDate !== undefined && { minDate: config.minDate }),
@@ -115,7 +120,6 @@ const delegateToCalendar = (model, calendarMessage) => {
                 const [nextPopover, popoverCommands] = Popover.close(model.popover);
                 return [
                     evo(modelWithCalendar, {
-                        maybeSelectedDate: () => Option.some(date),
                         popover: () => nextPopover,
                     }),
                     [
@@ -178,7 +182,6 @@ export const update = (model, message) => M.value(message).pipe(withUpdateReturn
         const [nextPopover, popoverCommands] = Popover.close(model.popover);
         return [
             evo(model, {
-                maybeSelectedDate: () => Option.some(date),
                 calendar: () => nextCalendar,
                 popover: () => nextPopover,
             }),
@@ -189,14 +192,7 @@ export const update = (model, message) => M.value(message).pipe(withUpdateReturn
             Option.some(SelectedDate({ date })),
         ];
     },
-    Cleared: () => [
-        evo(model, {
-            maybeSelectedDate: () => Option.none(),
-            calendar: UiCalendar.reflectSelectedDate(Option.none()),
-        }),
-        [],
-        Option.none(),
-    ],
+    Cleared: () => [model, [], Option.some(ClearedDate())],
 }));
 /** Programmatically opens the date picker, updating the model and returning
  * focus and popover commands. Use this in domain-event handlers. */
@@ -207,18 +203,13 @@ export const close = (model) => update(model, Closed());
 export const selectDate = (model, date) => update(model, RequestedSelectDate({ date }));
 /** Programmatically clears the selected date. */
 export const clear = (model) => update(model, Cleared());
-/** Reflects an externally-sourced selected date onto the date picker
- *  without emitting an OutMessage or touching the popover. Sets the
- *  picker's selection and reflects it onto the embedded calendar (moving
- *  the calendar's view to the date), mirroring `selectDate`'s state change
- *  minus the `SelectedDate` announcement and the popover close. Pass
- *  `Option.none()` to clear. Use this to mirror external truth (a URL
- *  parameter, a saved draft) onto the picker. Contrast with `selectDate`,
- *  a user or programmatic *choice* that emits `SelectedDate`. Returns the
- *  model directly because it produces no commands and no OutMessage. */
-export const reflectSelectedDate = Function.dual(2, (model, maybeDate) => evo(model, {
-    maybeSelectedDate: () => maybeDate,
-    calendar: () => UiCalendar.reflectSelectedDate(model.calendar, maybeDate),
+/** Moves the embedded calendar's view and cursor to a date without changing
+ *  the selection (which the parent owns). Use it to navigate the picker onto a
+ *  known date, for example after the parent sets its value externally (a URL
+ *  parameter, a saved draft) so opening the picker shows that month. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export const focusDate = Function.dual(2, (model, date) => evo(model, {
+    calendar: () => UiCalendar.focusDate(model.calendar, date),
 }));
 /** Reflects the minimum selectable date onto the embedded calendar. Pass
  * `Option.none()` to remove the minimum. Use this when the minimum derives
@@ -265,7 +256,7 @@ const encodeIsoDate = S.encodeSync(Calendar.CalendarDateFromIsoString);
  * focus choreography, open/close state, and form submission. */
 export const view = defineView((model, viewInputs) => {
     const h = html();
-    const { anchor, triggerContent, toCalendarView, isDisabled, name, className, attributes = [], triggerClassName, triggerAttributes = [], ariaLabel, ariaLabelledBy, panelClassName, panelAttributes = [], backdropClassName, backdropAttributes = [], } = viewInputs;
+    const { anchor, maybeSelectedDate, triggerContent, toCalendarView, isDisabled, name, className, attributes = [], triggerClassName, triggerAttributes = [], ariaLabel, ariaLabelledBy, panelClassName, panelAttributes = [], backdropClassName, backdropAttributes = [], } = viewInputs;
     const resolveTriggerLabel = () => {
         if (Predicate.isNotUndefined(ariaLabel)) {
             return [h.AriaLabel(ariaLabel)];
@@ -282,7 +273,7 @@ export const view = defineView((model, viewInputs) => {
         slotId: model.calendar.id,
         model: model.calendar,
         view: UiCalendar.view,
-        viewInputs: { toView: toCalendarView },
+        viewInputs: { maybeSelectedDate, toView: toCalendarView },
         toParentMessage: message => GotCalendarMessage({ message }),
     });
     const popoverVNode = h.submodel({
@@ -301,7 +292,7 @@ export const view = defineView((model, viewInputs) => {
                         ? [h.Class(triggerClassName)]
                         : []),
                     ...triggerAttributes,
-                ], [triggerContent(model.maybeSelectedDate)]),
+                ], [triggerContent(maybeSelectedDate)]),
                 ...(isVisible
                     ? [
                         h.div([
@@ -324,7 +315,7 @@ export const view = defineView((model, viewInputs) => {
         },
         toParentMessage: message => GotPopoverMessage({ message }),
     });
-    const hiddenInputValue = Option.match(model.maybeSelectedDate, {
+    const hiddenInputValue = Option.match(maybeSelectedDate, {
         onNone: () => '',
         onSome: encodeIsoDate,
     });

package/dist/datePicker/public.d.ts

@@ -1,3 +1,3 @@
-export { init, update, view, triggerId, open, close, selectDate, clear, reflectSelectedDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, Model, Message, OutMessage, GotCalendarMessage, GotPopoverMessage, RequestedSelectDate, SelectedDate, Cleared, Opened, Closed, ChangedViewMonth, } from './index.js';
+export { init, update, view, triggerId, open, close, selectDate, clear, focusDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, Model, Message, OutMessage, GotCalendarMessage, GotPopoverMessage, RequestedSelectDate, SelectedDate, ClearedDate, Cleared, Opened, Closed, ChangedViewMonth, } from './index.js';
 export type { InitConfig, ViewInputs } from './index.js';
 //# sourceMappingURL=public.d.ts.map

package/dist/datePicker/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/datePicker/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,EACL,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,OAAO,EACP,MAAM,EACN,MAAM,EACN,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/datePicker/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,EACL,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,OAAO,EACP,MAAM,EACN,MAAM,EACN,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/datePicker/public.js

@@ -1 +1 @@
-export { init, update, view, triggerId, open, close, selectDate, clear, reflectSelectedDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, Model, Message, OutMessage, GotCalendarMessage, GotPopoverMessage, RequestedSelectDate, SelectedDate, Cleared, Opened, Closed, ChangedViewMonth, } from './index.js';
+export { init, update, view, triggerId, open, close, selectDate, clear, focusDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, Model, Message, OutMessage, GotCalendarMessage, GotPopoverMessage, RequestedSelectDate, SelectedDate, ClearedDate, Cleared, Opened, Closed, ChangedViewMonth, } from './index.js';

package/dist/dialog/index.d.ts

@@ -80,10 +80,21 @@ export type InitConfig = Readonly<{
     id: string;
     isOpen?: boolean;
     isAnimated?: boolean;
+    /** CSS selector for the element that receives focus when the dialog opens.
+     *  A selector-based override of the `initialFocus` RenderInfo marker, for the
+     *  cases a spread-on marker cannot express: an element whose id you do not
+     *  own, or a descendant selector. Takes precedence over `initialFocus`. With
+     *  neither set, focus falls to the first focusable element. */
     focusSelector?: string;
 }>;
 /** Creates an initial dialog model from a config. Defaults to closed and non-animated. */
 export declare const init: (config: InitConfig) => Model;
+/** Data attribute the dialog places on the `initialFocus` RenderInfo group and
+ *  focuses on open. */
+export declare const initialFocusMarkerAttribute = "foldkit-dialog-initial-focus";
+/** Selector for {@link initialFocusMarkerAttribute}, focused against the open
+ *  dialog when no `focusSelector` is configured. */
+export declare const initialFocusMarkerSelector = "[data-foldkit-dialog-initial-focus]";
 type UpdateReturn = readonly [
     Model,
     ReadonlyArray<Command.Command<Message>>,
@@ -96,7 +107,7 @@ type UpdateReturn = readonly [
  *  component supplies its own backdrop. */
 export declare const ShowDialog: Command.CommandDefinitionWithArgs<"ShowDialog", {
     id: S.String;
-    maybeFocusSelector: S.Option<S.String>;
+    focusSelector: S.String;
 }, Effect.Effect<{
     readonly _tag: "CompletedShowDialog";
 }, never, never>>;
@@ -162,6 +173,10 @@ export declare const descriptionId: (model: Model) => string;
  *  - `description`: attributes for the description element. Carries the
  *    framework-managed id the dialog's `aria-describedby` points at. Spread
  *    onto your description element (`h.p([...description], [...])`).
+ *  - `initialFocus`: attributes for the element that should receive focus when
+ *    the dialog opens. Spread onto that element (`h.input([...initialFocus])`).
+ *    A configured `focusSelector` (see `init`) takes precedence, and focus
+ *    falls back to the default when no element carries the group.
  *  - `closeButton`: attributes for an in-panel close control such as a Cancel
  *    or dismiss button. Carries the `OnClick` handler that closes the
  *    dialog (suppressed while a leave animation is in progress). Spread
@@ -175,6 +190,7 @@ export type RenderInfo = Readonly<{
     panel: ReadonlyArray<ChildAttribute>;
     title: ReadonlyArray<ChildAttribute>;
     description: ReadonlyArray<ChildAttribute>;
+    initialFocus: ReadonlyArray<ChildAttribute>;
     closeButton: ReadonlyArray<ChildAttribute>;
     isVisible: boolean;
 }>;

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

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

package/dist/dialog/index.js

@@ -78,16 +78,19 @@ export const init = (config) => ({
 });
 // UPDATE
 const dialogSelector = (id) => idSelector(id);
+/** Data attribute the dialog places on the `initialFocus` RenderInfo group and
+ *  focuses on open. */
+export const initialFocusMarkerAttribute = 'foldkit-dialog-initial-focus';
+/** Selector for {@link initialFocusMarkerAttribute}, focused against the open
+ *  dialog when no `focusSelector` is configured. */
+export const initialFocusMarkerSelector = `[data-${initialFocusMarkerAttribute}]`;
 const withUpdateReturn = M.withReturnType();
 /** Locks page scroll and opens the native dialog element through
  *  `Dom.showDialog`, which calls `show()` (not native `showModal()`) so other
  *  high-z-index overlays stay interactive. It layers the dialog with a high
  *  z-index, traps focus, and dispatches a `cancel` event on Esc. The Dialog
  *  component supplies its own backdrop. */
-export const ShowDialog = Command.define('ShowDialog', { id: S.String, maybeFocusSelector: S.Option(S.String) }, CompletedShowDialog)(({ id, maybeFocusSelector }) => Dom.lockScroll.pipe(Effect.andThen(() => Dom.showDialog(dialogSelector(id), Option.match(maybeFocusSelector, {
-    onNone: () => undefined,
-    onSome: focusSelector => ({ focusSelector }),
-}))), Effect.ignore, Effect.as(CompletedShowDialog())));
+export const ShowDialog = Command.define('ShowDialog', { id: S.String, focusSelector: S.String }, CompletedShowDialog)(({ id, focusSelector }) => Dom.lockScroll.pipe(Effect.andThen(() => Dom.showDialog(dialogSelector(id), { focusSelector })), Effect.ignore, Effect.as(CompletedShowDialog())));
 /** Calls `close()` on the native dialog element and unlocks page scroll. */
 export const CloseDialog = Command.define('CloseDialog', { id: S.String }, CompletedCloseDialog)(({ id }) => Dom.closeDialog(dialogSelector(id)).pipe(Effect.andThen(() => Dom.unlockScroll), Effect.ignore, Effect.as(CompletedCloseDialog())));
 /** Releases the framework hygiene the dialog holds while open (scroll lock,
@@ -120,7 +123,7 @@ export const update = (model, message) => M.value(message).pipe(withUpdateReturn
         const wasClosed = !model.isOpen;
         const maybeShow = Option.liftPredicate(ShowDialog({
             id: model.id,
-            maybeFocusSelector: model.maybeFocusSelector,
+            focusSelector: Option.getOrElse(model.maybeFocusSelector, () => initialFocusMarkerSelector),
         }), () => wasClosed);
         const maybeOutMessage = wasClosed
             ? Option.some(Opened())
@@ -259,6 +262,9 @@ export const view = defineView((model, viewInputs) => {
     const panelAttributes = [h.Id(`${id}-panel`), ...animationAttributes];
     const titleAttributes = [h.Id(titleId(model))];
     const descriptionAttributes = [h.Id(descriptionId(model))];
+    const initialFocusAttributes = [
+        h.DataAttribute(initialFocusMarkerAttribute, ''),
+    ];
     const closeButtonAttributes = isLeaving ? [] : [h.OnClick(RequestedClose())];
     return toView({
         dialog: childAttributes(dialogAttributes),
@@ -266,6 +272,7 @@ export const view = defineView((model, viewInputs) => {
         panel: childAttributes(panelAttributes),
         title: childAttributes(titleAttributes),
         description: childAttributes(descriptionAttributes),
+        initialFocus: childAttributes(initialFocusAttributes),
         closeButton: childAttributes(closeButtonAttributes),
         isVisible,
     });