@eunomia/elements 1.0.0-beta.9 → 1.0.0

package/dist/features/scheduler/scheduler-event-editor/scheduler-event-editor.d.ts

@@ -33,13 +33,13 @@ declare const EunomiaSchedulerEventEditor_base: import("../../../utils/construct
  * @prop {EunomiaSchedulerEvent | null} [event] - The event being edited. Unset, or null, puts the form in create mode instead, seeded from initialStart and initialEnd
  * @prop {Date} [initialStart] - The start time to seed a new event with, in create mode. Defaults to the next hour
  * @prop {Date} [initialEnd] - The end time to seed a new event with, in create mode. Defaults to one hour after initialStart
- * @prop {string} [locale] - The locale used by the nested date and time fields. Defaults to the runtime's own
+ * @prop {string} [locale] - The locale used by the nested date and time fields. Defaults to the one set with setDefaultLocale, English otherwise
  * @prop {boolean} [hideActions=false] - Hides the built-in save, cancel, and delete footer, for a host that drives the form itself
  * @prop {string} [titleLabel] - The label of the title field. Defaults to the localized string for the current locale (English: "Title")
  * @prop {string} [descriptionLabel] - The label of the description field. Defaults to the localized string for the current locale (English: "Description")
  * @prop {string} [allDayLabel] - The label of the all day checkbox. Defaults to the localized string for the current locale (English: "All day")
  * @prop {string} [dateLabel] - The label of the date field. Defaults to the localized string for the current locale (English: "Date")
- * @prop {string} [endDateLabel] - The label of the end date field, shown in place of the start and end time fields while all day is checked. Defaults to the localized string for the current locale (English: "End date")
+ * @prop {string} [endDateLabel] - The label of the end date field. Defaults to the localized string for the current locale (English: "End date")
  * @prop {string} [startTimeLabel] - The label of the start time field. Defaults to the localized string for the current locale (English: "Start time")
  * @prop {string} [endTimeLabel] - The label of the end time field. Defaults to the localized string for the current locale (English: "End time")
  * @prop {string} [locationLabel] - The label of the location field. Defaults to the localized string for the current locale (English: "Location")
@@ -48,13 +48,18 @@ declare const EunomiaSchedulerEventEditor_base: import("../../../utils/construct
  * @prop {string} [colorLabel] - The label of the color swatch picker. Defaults to the localized string for the current locale (English: "Color")
  * @prop {string} [guestsLabel] - The label of the guest-sharing field. Defaults to the localized string for the current locale (English: "Guests")
  * @prop {string} [addGuestLabel] - The accessible label of the guest email input's add button. Defaults to the localized string for the current locale (English: "Add guest")
+ * @prop {string} [rangeErrorLabel] - The error shown under the time fields when the end isn't after the start. Defaults to the localized string for the current locale (English: "The end must be after the start")
+ * @prop {string} [guestErrorLabel] - The error shown under the guest email field when the entered address is malformed. Defaults to the localized string for the current locale (English: "Enter a valid email address")
  * @prop {string} [removeGuestLabel] - A prefix combined with the guest's email to build each guest chip's delete button accessible name, such as "Remove alice@example.com". Defaults to the localized string for the current locale (English: "Remove")
  * @prop {string} [saveLabel] - The label of the built-in save button. Defaults to the localized string for the current locale (English: "Save")
- * @prop {string} [cancelLabel] - The label of the built-in cancel button. Resets the form to its last-seeded values. Defaults to the localized string for the current locale (English: "Cancel")
+ * @prop {string} [cancelLabel] - The label of the built-in cancel button. Resets the form to its last-seeded values and fires the cancel event. Defaults to the localized string for the current locale (English: "Cancel")
  * @prop {string} [deleteLabel] - The label of the built-in delete button. Only shown while editing an existing event. Defaults to the localized string for the current locale (English: "Delete")
+ * @prop {string} [deleteConfirmLabel] - The question the built-in footer asks before deleting. Defaults to the localized string for the current locale (English: "Delete this event?")
  * @fires {EventCreateEvent} euneventcreate - Fired on a valid save, in create mode
- * @fires {EventUpdateEvent} euneventupdate - Fired on a valid save, in edit mode
+ * @fires {EventUpdateEvent} euneventupdate - Fired on a valid save, in edit mode, unless nothing changed
  * @fires {EventDeleteEvent} euneventdelete - Fired when the built-in delete button is activated
+ * @fires {EventCancelEvent} euneventcancel - Fired when the built-in cancel button, or requestCancel, resets the form
+ * @fires {EditorStateChangeEvent} euneditorstatechange - Fired whenever dirty or valid changes value. Not fired for the initial render
  * @fires {GuestInviteEvent} eunguestinvite - Fired whenever a guest email is added, so a consumer can actually send the share invite
  * @cssprop [--scheduler-event-editor-gap] - Sets the gap between fields
  * @element eun-scheduler-event-editor
@@ -107,8 +112,7 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      */
     dateLabel?: string;
     /**
-     * Label of the end-date field shown in place of the start/end time
-     * fields while {@link formAllDay} is set.
+     * Label of the end-date field.
      * Falls back to the localized string for the current locale when unset.
      */
     endDateLabel?: string;
@@ -139,7 +143,8 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
     /**
      * Accessible name appended after {@link titleLabel} when the title field
      * is left empty on submit (e.g. "Title is required").
-     * Falls back to the localized string for the current locale when unset.
+     * Left unset along with {@link titleLabel}, the whole message is the
+     * localized one for the current locale (e.g. "Le titre est obligatoire").
      */
     requiredLabel?: string;
     /**
@@ -156,6 +161,18 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * Falls back to the localized string for the current locale when unset.
      */
     addGuestLabel?: string;
+    /**
+     * Error shown under the guest email field when the entered address is
+     * malformed.
+     * Falls back to the localized string for the current locale when unset.
+     */
+    guestErrorLabel?: string;
+    /**
+     * The error shown under the time fields when the end isn't after the
+     * start.
+     * Falls back to the localized string for the current locale when unset.
+     */
+    rangeErrorLabel?: string;
     /**
      * Prefix combined with the guest's email to build each guest chip's
      * delete button accessible name, forwarded as `eun-chip`'s own
@@ -173,6 +190,16 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * Falls back to the localized string for the current locale when unset.
      */
     deleteLabel?: string;
+    /**
+     * Falls back to the localized string for the current locale when unset.
+     */
+    deleteConfirmLabel?: string;
+    /**
+     * Whether the built-in Delete was pressed once and now waits for its
+     * confirmation. Reset whenever the form is seeded.
+     * @internal
+     */
+    private confirmingDelete;
     /** @internal */
     private formTitle;
     /** @internal */
@@ -186,9 +213,9 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
     /** @internal */
     private formDate;
     /**
-     * The end date of an all-day/multi-day span, only shown/used while
-     * {@link formAllDay} is set — a single-day all-day event has this equal
-     * to {@link formDate}.
+     * The end date of the event — a single-day event has this equal to
+     * {@link formDate}. Combined with {@link formEnd}'s time outside
+     * all-day mode.
      * @internal
      */
     private formEndDate;
@@ -207,11 +234,10 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      */
     private formPriority;
     /**
-     * Defaults to the `blue` preset's own hex value, matching
-     * {@link COLOR_PRESETS}, rather than the bare keyword `"blue"` : both
-     * render identically (see `scheduler-event.styles.ts`), but the hex form
-     * is what lets the `eun-color-picker` rendered in {@link render} below
-     * show the matching preset swatch as picked in its own radiogroup.
+     * Always held as hex (see `toEventColorHex`), seeded from a preset name
+     * or hex alike, so the `eun-color-picker` rendered in {@link render}
+     * below shows the matching preset swatch as picked, and saved events
+     * always carry hex. Defaults to the `blue` preset's hex.
      * @internal
      */
     private formColor;
@@ -240,6 +266,12 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * @internal
      */
     private seedSnapshot;
+    /**
+     * The `dirty`/`valid` pair last reported by `EditorStateChangeEvent`,
+     * `null` until the first update records it without dispatching.
+     * @internal
+     */
+    private reportedState;
     connectedCallback(): void;
     /**
      * Re-seeds the form whenever `event`/`initialStart`/`initialEnd` change
@@ -264,6 +296,13 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * @param changed the changed properties.
      */
     protected updated(changed: PropertyValues): void;
+    /**
+     * Dispatches `EditorStateChangeEvent` when {@link dirty} or
+     * {@link valid} differs from what was last reported. The first call only
+     * records the initial pair.
+     * @private
+     */
+    private reportStateChange;
     /**
      * Seeds every form field from {@link event} (edit mode) or
      * {@link initialStart}/{@link initialEnd} (create mode, defaulting to
@@ -288,8 +327,9 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * Composes the current form fields into the final `start`/`end` instants
      * — in all-day mode, {@link formDate}/{@link formEndDate} at their own
      * day boundaries (no time-of-day involved) ; otherwise
-     * {@link formDate}'s calendar day with {@link formStart}/{@link formEnd}'s
-     * hour/minute, as before.
+     * {@link formDate}/{@link formEndDate}'s calendar days with
+     * {@link formStart}/{@link formEnd}'s hour/minute. Never rolls the end
+     * over to the next day : an end before the start stays invalid.
      * @private
      */
     private composeStartEnd;
@@ -302,11 +342,29 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
      * Validates the form and, if valid, dispatches
      * `EventCreateEvent`/`EventUpdateEvent` as appropriate. Otherwise turns
      * on inline error messages and returns `false` without dispatching
-     * anything.
+     * anything. Editing an event without changing anything succeeds without
+     * dispatching either, so the consumer's data is left untouched.
      *
      * @returns whether the save succeeded.
      */
     requestSave(): boolean;
+    /**
+     * The color to save : the edited event's own value, in whatever form it
+     * was given (a preset name, say), while the picked swatch still matches
+     * it, {@link formColor}'s hex otherwise.
+     * @private
+     */
+    private savedColor;
+    /**
+     * Whether the composed end falls at or before the start.
+     * @private
+     */
+    private get rangeInvalid();
+    /**
+     * Resets the form to its last-seeded values and dispatches
+     * `EventCancelEvent`, for a host modal or drawer to close itself.
+     */
+    requestCancel(): void;
     /**
      * Dispatches `EventDeleteEvent` for the event currently being edited. A
      * no-op in "create" mode (there's nothing to delete yet).
@@ -316,6 +374,24 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
     private handleSaveClick;
     /** @private */
     private handleCancelClick;
+    /**
+     * Swaps the built-in footer for the delete confirmation, moving focus
+     * onto its Cancel button since the pressed Delete button goes away.
+     * @private
+     */
+    private handleDeleteClick;
+    /** @private */
+    private handleConfirmDeleteClick;
+    /** @private */
+    private handleCancelDeleteClick;
+    /** @private */
+    private focusAction;
+    /**
+     * Moves {@link formDate} to `date`, shifting {@link formEndDate} by the
+     * same number of days so the event keeps its length.
+     * @private
+     */
+    private moveStartDate;
     /**
      * Reads the priority picker's new selection back into {@link formPriority}
      * — `eun-toggle-group` in `single` mode always has exactly one entry
@@ -345,6 +421,14 @@ export declare class EunomiaSchedulerEventEditor extends EunomiaSchedulerEventEd
     /** @private */
     private handleRemoveGuest;
     render(): TemplateResult;
+    /**
+     * Renders the built-in footer : Delete/Cancel/Save, or the delete
+     * confirmation that replaces them once Delete was pressed. Save stays
+     * disabled while an edited event has no changes. Nothing with
+     * {@link hideActions}.
+     * @private
+     */
+    private renderActions;
 }
 declare global {
     interface HTMLElementTagNameMap {