@0001-labs/design-system-1 0.3.0-alpha.20 → 0.3.0-alpha.21

package/dist/3-unit/ds-date-picker.js

@@ -1,499 +0,0 @@
-// ds-date-picker.ts
-// A field that opens a panel below it: the first and last day written out
-// where they can be typed, a small month one square a day, a switch for a
-// time, and Clear. It always collects a range: the first day pressed starts
-// it and the second ends it; leaving after the first keeps that one day. A
-// form takes the value as ISO 8601: a day, a day and a time, or two of them
-// joined by a slash.
-import { LitElement, html, nothing, unsafeCSS } from "lit";
-import { define } from "../0-face/define";
-import { getText } from "../0-face/i18n";
-import { dateFormatter } from "../0-face/format";
-import { dayOf, isDay, today as todayDay } from "../0-face/calendar";
-import "../2-core/ds-icon";
-import "./ds-calendar";
-import metrics from "../1-root/component-metrics.css?inline";
-import controls from "../1-root/controls.css?inline";
-import styles from "./styles/ds-date-picker.css?inline";
-const TIME = /^([01]\d|2[0-3]):([0-5]\d)$/;
-/** Reads a value: `2026-10-21`, `2026-10-21T14:30`, or two of them joined by `/`. */
-export function readDateValue(value) {
-    const read = (part) => {
-        const [day = "", time = ""] = (part ?? "").trim().split("T");
-        if (!isDay(day))
-            return undefined;
-        const clock = time.slice(0, 5);
-        return { day, time: TIME.test(clock) ? clock : "" };
-    };
-    const [first, second] = (value ?? "").split("/");
-    let start = read(first), end = read(second);
-    if (start && end && `${end.day}T${end.time}` < `${start.day}T${start.time}`)
-        [start, end] = [end, start];
-    return { start, end };
-}
-/**
- * Writes a value from its ends, the times only with `time`. An end that is
- * the same moment as the start leaves the value one day.
- */
-export function writeDateValue(start, end, options) {
-    if (!start)
-        return "";
-    const part = (side) => (options.time && side.time ? `${side.day}T${side.time}` : side.day);
-    return end && part(end) !== part(start) ? `${part(start)}/${part(end)}` : part(start);
-}
-/** Reads what a person typed: a day written `YYYY-MM-DD`, or a date the browser can read ("Oct 21, 2026"). */
-export function parseTypedDay(text) {
-    const trimmed = text.trim();
-    if (isDay(trimmed))
-        return trimmed;
-    const moment = Date.parse(trimmed);
-    return Number.isFinite(moment) ? dayOf(new Date(moment)) : null;
-}
-const openPickers = new Set();
-/**
- * @element ds-date-picker
- * @prop {string} value - `YYYY-MM-DD`, `YYYY-MM-DDTHH:MM`, or two joined by
- *   `/` for a range; empty for none.
- * @prop {string} name - The form field's name.
- * @prop {string} label - The field's accessible name: a translation key, or
- *   literal words.
- * @prop {boolean} literal - Show `label` and `placeholder` as written.
- * @prop {string} placeholder - The words before a day is chosen; the shared
- *   "Choose a date" by default.
- * @prop {string} length - How a day is written: `short`, `medium` (the
- *   default) or `long`.
- * @prop {boolean} time - Choose a time with each day (the Include time switch).
- * @prop {boolean} noOptions - Leave the Include time switch out (`no-options`);
- *   `time` still applies.
- * @prop {string} min - The first day a person may choose.
- * @prop {string} max - The last day a person may choose.
- * @prop {string} weekStart - The week's first day (`week-start`); the
- *   language's own by default.
- * @prop {string} today - The day drawn as today; the reader's own by default.
- * @prop {boolean} required - A form needs a value; Clear is left out.
- * @prop {boolean} disabled - The field cannot be opened.
- * @prop {boolean} open - The panel is open.
- *
- * @fires change - A person changed the value; `{ value, previous }`.
- * @fires input - The same moment, for code listening as to a field.
- * @fires ds-date-picker-toggle - The panel opened or closed; `{ open }`.
- *
- * @example
- * <ds-date-picker label="When" literal name="when" value="2026-10-21/2026-10-24"></ds-date-picker>
- */
-export class DatePicker extends LitElement {
-    constructor() {
-        super();
-        this.internals = typeof this.attachInternals === "function" ? this.attachInternals() : null;
-        /** The value the field started with, for a form's reset. */
-        this.initial = "";
-        this.shown = false;
-        /** Whether opening should move focus into the month (a key opened it). */
-        this.focusMonth = false;
-        this.relabel = () => this.requestUpdate();
-        /** Below the field, half a square from it, or above when there is more room there; held inside the screen. */
-        this.place = () => {
-            const panel = this.panel, trigger = this.trigger;
-            if (!this.shown || !panel || !trigger)
-                return;
-            const rect = trigger.getBoundingClientRect();
-            const view = this.ownerDocument.defaultView;
-            const viewport = view.visualViewport;
-            const left = viewport?.offsetLeft ?? 0, top = viewport?.offsetTop ?? 0;
-            const width = viewport?.width ?? view.innerWidth, height = viewport?.height ?? view.innerHeight;
-            const box = panel.getBoundingClientRect();
-            const gap = (parseFloat(getComputedStyle(panel).paddingTop) || 9) + 1;
-            // The face is one control high at the foot of its square: measure from that square.
-            const square = Math.max(rect.height, gap * 2);
-            const foot = rect.bottom, head = rect.bottom - square;
-            const below = top + height - foot - 2 * gap, above = head - top - 2 * gap;
-            const up = below < box.height && above > below;
-            const x = getComputedStyle(this).direction === "rtl" ? rect.right - box.width : rect.left;
-            panel.style.left = `${Math.max(left + gap, Math.min(x, left + width - gap - box.width))}px`;
-            panel.style.top = `${Math.max(top + gap, up ? head - gap - box.height : foot + gap)}px`;
-        };
-        this.onOutside = (event) => {
-            if (!event.composedPath().includes(this))
-                this.open = false;
-        };
-        this.toggle = () => {
-            if (this.disabled)
-                return;
-            this.focusMonth = false;
-            this.open = !this.open;
-        };
-        this.onTriggerKey = (event) => {
-            if (this.disabled)
-                return;
-            if (event.key === "ArrowDown" || event.key === "ArrowUp" || ((event.key === "Enter" || event.key === " ") && !this.open)) {
-                event.preventDefault();
-                this.focusMonth = true;
-                if (this.open)
-                    void this.focusDay();
-                else
-                    this.open = true;
-            }
-        };
-        this.onPanelKey = (event) => {
-            if (event.key === "Escape" && !event.defaultPrevented) {
-                event.preventDefault();
-                event.stopPropagation();
-                this.open = false;
-            }
-        };
-        this.onFocusOut = (event) => {
-            const next = event.relatedTarget;
-            if (this.open && next instanceof Node && !this.contains(next) && !this.renderRoot.contains(next))
-                this.open = false;
-        };
-        /**
-         * A day pressed in the month. The first press of an opening starts the range
-         * (the value is that day until another is pressed); the second ends it and,
-         * without times to set, closes the panel.
-         */
-        this.picked = (event) => {
-            event.stopPropagation();
-            const { start, end } = this.ends;
-            const first = { day: event.detail.start, time: start?.time || (this.time ? "09:00" : "") };
-            if (!event.detail.end) {
-                this.awaitingEnd = true;
-                this.write(first, undefined);
-                return;
-            }
-            this.awaitingEnd = false;
-            const last = { day: event.detail.end, time: end?.time || (this.time ? "10:00" : "") };
-            this.write(first, last);
-            if (!this.time)
-                this.open = false;
-        };
-        this.setTime = () => {
-            this.time = !this.time;
-            const { start, end } = this.ends;
-            const timed = (side, clock) => (side ? { ...side, time: this.time ? side.time || clock : "" } : undefined);
-            this.write(timed(start, "09:00"), timed(end ?? (this.time ? start : undefined), "10:00"));
-        };
-        /** Pressing the switch's row presses the switch, as a label would. */
-        this.passPress = (event) => {
-            const row = event.currentTarget;
-            const control = row.querySelector(".ds-switch");
-            if (control && !event.composedPath().includes(control))
-                control.click();
-        };
-        this.clear = () => {
-            this.commit("");
-            this.open = false;
-        };
-        this.value = "";
-        this.literal = false;
-        this.time = false;
-        this.noOptions = false;
-        this.required = false;
-        this.disabled = false;
-        this.open = false;
-        this.awaitingEnd = false;
-    }
-    connectedCallback() {
-        super.connectedCallback();
-        window.addEventListener("language-changed", this.relabel);
-        window.addEventListener("translations-loaded", this.relabel);
-    }
-    disconnectedCallback() {
-        window.removeEventListener("language-changed", this.relabel);
-        window.removeEventListener("translations-loaded", this.relabel);
-        this.hide(false);
-        super.disconnectedCallback();
-    }
-    firstUpdated() {
-        this.initial = this.value;
-    }
-    /** The form was reset: back to the value it started with. */
-    formResetCallback() {
-        this.value = this.initial;
-    }
-    formDisabledCallback(disabled) {
-        this.disabled = disabled;
-    }
-    words(value, fallback) {
-        if (value && this.literal)
-            return value;
-        return getText(value || fallback) || value || fallback;
-    }
-    get trigger() {
-        return this.renderRoot.querySelector(".trigger");
-    }
-    get panel() {
-        return this.renderRoot.querySelector(".popover");
-    }
-    get calendar() {
-        return this.renderRoot.querySelector("ds-calendar");
-    }
-    get ends() {
-        return readDateValue(this.value);
-    }
-    willUpdate(changed) {
-        super.willUpdate(changed);
-        if (changed.has("value") && this.value) {
-            const { start, end } = this.ends;
-            // A value with a time turns the switch on.
-            if (!start)
-                this.value = "";
-            else if (start.time || end?.time)
-                this.time = true;
-        }
-        if (changed.has("disabled") && this.disabled)
-            this.open = false;
-    }
-    updated(changed) {
-        super.updated(changed);
-        if (changed.has("value") || changed.has("required")) {
-            this.internals?.setFormValue(this.value || null);
-            if (this.required && !this.value)
-                this.internals?.setValidity({ valueMissing: true }, this.words(undefined, "Choose a date"), this.trigger ?? undefined);
-            else
-                this.internals?.setValidity({});
-        }
-        if (changed.has("open")) {
-            if (this.open)
-                this.show();
-            else
-                this.hide(changed.get("open") === true);
-        }
-    }
-    /** Opens the panel. */
-    show() {
-        if (this.shown || this.disabled || !this.isConnected)
-            return;
-        const panel = this.panel;
-        if (!panel)
-            return;
-        for (const other of openPickers)
-            if (other !== this)
-                other.open = false;
-        openPickers.add(this);
-        this.shown = true;
-        this.open = true;
-        this.awaitingEnd = false;
-        const calendar = this.calendar;
-        if (calendar)
-            calendar.month = (this.ends.start?.day || this.today || todayDay()).slice(0, 7);
-        panel.showPopover?.();
-        this.place();
-        if (calendar)
-            void calendar.updateComplete.then(this.place);
-        this.ownerDocument.addEventListener("pointerdown", this.onOutside, true);
-        this.ownerDocument.addEventListener("scroll", this.place, true);
-        window.addEventListener("resize", this.place);
-        this.dispatchEvent(new CustomEvent("ds-date-picker-toggle", { bubbles: true, composed: true, detail: { open: true } }));
-        if (this.focusMonth)
-            void this.focusDay();
-    }
-    /** Closes the panel, giving focus back to the field when it was inside. */
-    hide(restore = true) {
-        if (!this.shown)
-            return;
-        this.shown = false;
-        openPickers.delete(this);
-        this.awaitingEnd = false;
-        const panel = this.panel;
-        const within = panel?.matches(":focus-within");
-        if (panel?.matches(":popover-open"))
-            panel.hidePopover?.();
-        this.ownerDocument.removeEventListener("pointerdown", this.onOutside, true);
-        this.ownerDocument.removeEventListener("scroll", this.place, true);
-        window.removeEventListener("resize", this.place);
-        this.open = false;
-        if (restore && within)
-            this.trigger?.focus({ preventScroll: true });
-        this.dispatchEvent(new CustomEvent("ds-date-picker-toggle", { bubbles: true, composed: true, detail: { open: false } }));
-    }
-    async focusDay() {
-        const calendar = this.calendar;
-        if (!calendar)
-            return;
-        await calendar.updateComplete;
-        calendar.renderRoot.querySelector('[data-day][tabindex="0"]')?.focus({ preventScroll: true });
-    }
-    /** Takes a new value and says so. */
-    commit(value) {
-        const previous = this.value || "";
-        if (value === previous)
-            return;
-        this.value = value;
-        const detail = { value, previous };
-        this.dispatchEvent(new CustomEvent("input", { bubbles: true, composed: true, detail }));
-        this.dispatchEvent(new CustomEvent("change", { bubbles: true, composed: true, detail }));
-    }
-    write(start, end) {
-        this.commit(writeDateValue(start, end, { time: this.time }));
-    }
-    /** A day typed in a field, read when the person leaves it or presses Enter. */
-    typed(side, input) {
-        const { start, end } = this.ends;
-        const text = input.value.trim();
-        if (!text) {
-            if (side === "start")
-                this.commit("");
-            else
-                this.write(start, undefined);
-            return;
-        }
-        const day = parseTypedDay(text);
-        if (!day) {
-            input.value = this.fieldText(side === "start" ? start : end);
-            return;
-        }
-        const current = side === "start" ? start : end;
-        const next = { day, time: current?.time || (this.time ? (side === "start" ? "09:00" : "10:00") : "") };
-        if (side === "start")
-            this.write(next, end);
-        else
-            this.write(start ?? next, next);
-        this.awaitingEnd = false;
-        const calendar = this.calendar;
-        if (calendar)
-            calendar.month = day.slice(0, 7);
-    }
-    timed(side, input) {
-        const { start, end } = this.ends;
-        const clock = TIME.test(input.value) ? input.value : "";
-        if (side === "start" && start)
-            this.write({ ...start, time: clock }, end);
-        if (side === "end" && start)
-            this.write(start, { day: (end ?? start).day, time: clock });
-    }
-    moment(side) {
-        const [year, month, date] = side.day.split("-").map(Number);
-        const [hours, minutes] = (side.time || "12:00").split(":").map(Number);
-        return Date.UTC(year, month - 1, date, hours, minutes);
-    }
-    formatter(withTime) {
-        return dateFormatter({ dateStyle: this.length ?? "medium", ...(withTime ? { timeStyle: "short" } : {}), timeZone: "UTC" });
-    }
-    fieldText(side) {
-        return side ? this.formatter(false).format(this.moment(side)) : "";
-    }
-    /** The face's words: one day, or a range written as the language writes one ("Oct 21 – 24, 2026"). */
-    faceText() {
-        const { start, end } = this.ends;
-        if (!start)
-            return this.words(this.placeholder, "Choose a date");
-        const formatter = this.formatter(Boolean(start.time || end?.time));
-        if (!end)
-            return formatter.format(this.moment(start));
-        return formatter.formatRange ? formatter.formatRange(this.moment(start), this.moment(end)) : `${formatter.format(this.moment(start))} – ${formatter.format(this.moment(end))}`;
-    }
-    renderEnd(side, value, name) {
-        const label = side === "start" ? name : `${name}, ${this.words(undefined, "End date")}`;
-        return html `<div class="field-row" part="field">
-        <input
-          class="ds-input field"
-          type="text"
-          autocomplete="off"
-          aria-label=${label}
-          placeholder=${side === "start" ? this.words(this.placeholder, "Choose a date") : this.words(undefined, "End date")}
-          .value=${this.fieldText(value)}
-          @change=${(event) => this.typed(side, event.target)}
-          @keydown=${(event) => { if (event.key === "Enter") {
-            event.preventDefault();
-            this.typed(side, event.target);
-        } }}
-        />
-      </div>
-      ${this.time
-            ? html `<div class="field-row" part="field">
-            <input
-              class="ds-input clock"
-              type="time"
-              aria-label=${`${label}, ${this.words(undefined, "Time")}`}
-              .value=${value?.time ?? ""}
-              ?disabled=${!this.ends.start}
-              @change=${(event) => this.timed(side, event.target)}
-            />
-          </div>`
-            : nothing}`;
-    }
-    render() {
-        const { start, end } = this.ends;
-        const text = this.faceText();
-        const name = this.label ? this.words(this.label, this.label) : this.words(undefined, "Date");
-        // While the end is still to come the month holds the start alone; otherwise the range is whole (one day is a range of one).
-        const days = start ? (this.awaitingEnd ? start.day : `${start.day}/${(end ?? start).day}`) : "";
-        return html `<button
-        class="ds-select trigger"
-        part="trigger"
-        type="button"
-        aria-haspopup="dialog"
-        aria-expanded=${String(this.open)}
-        aria-label=${start ? `${name}, ${text}` : name}
-        ?disabled=${this.disabled}
-        ?data-empty=${!start}
-        @click=${this.toggle}
-        @keydown=${this.onTriggerKey}
-      >
-        <ds-icon class="icon" type="calendar" aria-hidden="true"></ds-icon>
-        <span class="text">${text}</span>
-        <ds-icon class="arrow" type="down" aria-hidden="true"></ds-icon>
-      </button>
-      <div
-        class="popover"
-        part="popover"
-        popover="manual"
-        role="dialog"
-        aria-label=${name}
-        @keydown=${this.onPanelKey}
-        @focusout=${this.onFocusOut}
-      >
-        <div class="fields">
-          ${this.renderEnd("start", start, name)}
-          ${this.renderEnd("end", start ? end ?? start : undefined, name)}
-        </div>
-        <ds-calendar
-          compact
-          selectable
-          range
-          fixed
-          outside-days
-          .value=${days}
-          .min=${this.min}
-          .max=${this.max}
-          .weekStart=${this.weekStart}
-          .today=${this.today}
-          @change=${this.picked}
-        ></ds-calendar>
-        <div class="options" part="options">
-          ${this.noOptions
-            ? nothing
-            : html `<div class="separator" aria-hidden="true"></div>
-                <div class="option" @click=${this.passPress}>
-                  <span>${this.words(undefined, "Include time")}</span>
-                  <button class="ds-switch" type="button" role="switch" aria-label=${this.words(undefined, "Include time")} aria-checked=${String(this.time)} @click=${this.setTime}></button>
-                </div>`}
-          ${this.required
-            ? nothing
-            : html `<div class="separator" aria-hidden="true"></div>
-                <button class="option clear" part="clear" type="button" ?disabled=${!start} @click=${this.clear}>${this.words(undefined, "Clear")}</button>`}
-        </div>
-      </div>`;
-    }
-}
-DatePicker.formAssociated = true;
-DatePicker.properties = {
-    value: { type: String, reflect: true },
-    name: { type: String, reflect: true },
-    label: { type: String },
-    literal: { type: Boolean, reflect: true },
-    placeholder: { type: String },
-    length: { type: String },
-    time: { type: Boolean, reflect: true },
-    noOptions: { type: Boolean, attribute: "no-options", reflect: true },
-    min: { type: String },
-    max: { type: String },
-    weekStart: { type: String, attribute: "week-start" },
-    today: { type: String },
-    required: { type: Boolean, reflect: true },
-    disabled: { type: Boolean, reflect: true },
-    open: { type: Boolean, reflect: true },
-    awaitingEnd: { state: true },
-};
-DatePicker.styles = [unsafeCSS(metrics), unsafeCSS(controls), unsafeCSS(styles)];
-define("ds-date-picker", DatePicker);