@ecoma-io/loom 0.2.0 → 0.3.0

package/dist/packages/primitives/date-time-range-picker/src/DateTimeRangePicker.vue.d.ts

@@ -0,0 +1,133 @@
+import { type LabelOverrides } from "@ecoma-io/loom-labels";
+import type { DateTimeRangeLabels } from "@ecoma-io/loom-labels";
+import type { CalendarPanelLabels, DateSegmentLabels, RangeCellLabels, TimeSegmentLabels } from "@ecoma-io/loom-labels";
+/**
+ * A span between two instants as the outside world holds it: two plain ISO
+ * local date-time strings, `"YYYY-MM-DDTHH:mm"`, both optional.
+ *
+ * The shape is `DateRange`'s and the reasoning behind it is `DateRange`'s — a
+ * half-made range has to be representable, and `range.start` reads where
+ * `range[0]` needs a comment. What is deliberately not shared is the **name**.
+ * Two identically-shaped types whose strings are in different formats are
+ * exactly what distinct names are for: a `DateRange` handed to this control
+ * loses its times, and a `DateTimeRange` handed to DateRangePicker carries a
+ * `T09:30` no calendar day can hold. One name for both would let either mistake
+ * compile.
+ */
+export interface DateTimeRange {
+    /** The instant the span opens at, ISO `"YYYY-MM-DDTHH:mm"`. Absent while nothing has been chosen. */
+    start?: string | undefined;
+    /** The instant the span closes at, ISO `"YYYY-MM-DDTHH:mm"`. Absent while only the start has been chosen. */
+    end?: string | undefined;
+}
+/**
+ * Loom's English, co-located with the component so it tree-shakes with it, and
+ * exported so a host can build a partial vocabulary against the real thing.
+ */
+export declare const DATE_TIME_RANGE_LABELS: DateTimeRangeLabels;
+/**
+ * Everything this control can be asked to say: the four shared slices, plus its
+ * own. Annotate a bag with `LabelOverrides<DateTimeRangePickerLabels>` and never
+ * with this, which is total.
+ */
+export type DateTimeRangePickerLabels = DateSegmentLabels & TimeSegmentLabels & CalendarPanelLabels & RangeCellLabels & DateTimeRangeLabels;
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /**
+     * The chosen span, as `{ start, end }` ISO `"YYYY-MM-DDTHH:mm"` strings —
+     * `"…:ss"` when `granularity` asks for seconds. Either half may be absent:
+     * `{}` is nothing chosen, `{ start }` is a range half made. A bare
+     * `"YYYY-MM-DD"` is accepted in either half and read as midnight that day.
+     * The explicit `| undefined` is what lets `v-model` bind a ref that clears.
+     */
+    modelValue?: DateTimeRange | undefined;
+    /** The earliest choosable instant, same format. The calendar disables every day that lies wholly before it; a time before it on the boundary day is announced invalid rather than refused. */
+    min?: string;
+    /** The latest choosable instant, same format. The calendar disables every day that lies wholly after it; a time after it on the boundary day is announced invalid rather than refused. */
+    max?: string;
+    /** How far down both halves of the field go. `"minute"` reports `"YYYY-MM-DDTHH:mm"`; `"second"` adds a seconds segment to each end and reports `"YYYY-MM-DDTHH:mm:ss"`. */
+    granularity?: "minute" | "second";
+    /** Whether both times read as 12-hour with an AM/PM segment or as 24-hour. Display only: the value stays 24-hour. Unset follows `locale`. */
+    hourCycle?: 12 | 24;
+    /** BCP 47 tag driving the order of the segments in both halves, the month and weekday names, which day a week starts on, and the 12-or-24-hour default. */
+    locale?: string;
+    /** How many months the calendar shows at once. Two is the default because a span is usually read across a month boundary; one is for a host that knows it is rendering into a narrow shell. */
+    months?: 1 | 2;
+    /** Unavailable: dims the control, refuses the calendar, and takes the field out of the tab order. Unset defers to a wrapping Field. */
+    disabled?: boolean | undefined;
+    /** Shows the span without allowing an edit: the field stays a Tab stop and stays submitted, and the calendar button is dropped because nothing in the calendar could be chosen. Unset defers to a wrapping Field. */
+    readonly?: boolean | undefined;
+    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. An instant outside `min`/`max`, or an end before its start, does the same on its own whatever this says. Unset defers to a wrapping Field's `error`. */
+    invalid?: boolean | undefined;
+    /** Marks the field mandatory to assistive tech (`aria-required` on the group holding both halves). Unset defers to a wrapping Field. */
+    required?: boolean | undefined;
+    /** The field name for a native form post or `FormData`. Reka submits the whole span through one hidden input, as `start - end`. Unset defers to a wrapping Field. */
+    name?: string;
+    /**
+     * Names for everything this control says out loud, as any subset of
+     * `DateTimeRangePickerLabels` — the rest stay as the host's
+     * `provideLoomLabels` vocabulary left them, and then as Loom's English.
+     *
+     * This is the per-instance correction, not the place to localise an
+     * application: eleven of the eighteen names replace English literals Reka UI
+     * writes of its own accord, and a language is set once with
+     * `provideLoomLabels`.
+     */
+    labels?: LabelOverrides<DateTimeRangePickerLabels>;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: DateTimeRange) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /**
+     * The chosen span, as `{ start, end }` ISO `"YYYY-MM-DDTHH:mm"` strings —
+     * `"…:ss"` when `granularity` asks for seconds. Either half may be absent:
+     * `{}` is nothing chosen, `{ start }` is a range half made. A bare
+     * `"YYYY-MM-DD"` is accepted in either half and read as midnight that day.
+     * The explicit `| undefined` is what lets `v-model` bind a ref that clears.
+     */
+    modelValue?: DateTimeRange | undefined;
+    /** The earliest choosable instant, same format. The calendar disables every day that lies wholly before it; a time before it on the boundary day is announced invalid rather than refused. */
+    min?: string;
+    /** The latest choosable instant, same format. The calendar disables every day that lies wholly after it; a time after it on the boundary day is announced invalid rather than refused. */
+    max?: string;
+    /** How far down both halves of the field go. `"minute"` reports `"YYYY-MM-DDTHH:mm"`; `"second"` adds a seconds segment to each end and reports `"YYYY-MM-DDTHH:mm:ss"`. */
+    granularity?: "minute" | "second";
+    /** Whether both times read as 12-hour with an AM/PM segment or as 24-hour. Display only: the value stays 24-hour. Unset follows `locale`. */
+    hourCycle?: 12 | 24;
+    /** BCP 47 tag driving the order of the segments in both halves, the month and weekday names, which day a week starts on, and the 12-or-24-hour default. */
+    locale?: string;
+    /** How many months the calendar shows at once. Two is the default because a span is usually read across a month boundary; one is for a host that knows it is rendering into a narrow shell. */
+    months?: 1 | 2;
+    /** Unavailable: dims the control, refuses the calendar, and takes the field out of the tab order. Unset defers to a wrapping Field. */
+    disabled?: boolean | undefined;
+    /** Shows the span without allowing an edit: the field stays a Tab stop and stays submitted, and the calendar button is dropped because nothing in the calendar could be chosen. Unset defers to a wrapping Field. */
+    readonly?: boolean | undefined;
+    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. An instant outside `min`/`max`, or an end before its start, does the same on its own whatever this says. Unset defers to a wrapping Field's `error`. */
+    invalid?: boolean | undefined;
+    /** Marks the field mandatory to assistive tech (`aria-required` on the group holding both halves). Unset defers to a wrapping Field. */
+    required?: boolean | undefined;
+    /** The field name for a native form post or `FormData`. Reka submits the whole span through one hidden input, as `start - end`. Unset defers to a wrapping Field. */
+    name?: string;
+    /**
+     * Names for everything this control says out loud, as any subset of
+     * `DateTimeRangePickerLabels` — the rest stay as the host's
+     * `provideLoomLabels` vocabulary left them, and then as Loom's English.
+     *
+     * This is the per-instance correction, not the place to localise an
+     * application: eleven of the eighteen names replace English literals Reka UI
+     * writes of its own accord, and a language is set once with
+     * `provideLoomLabels`.
+     */
+    labels?: LabelOverrides<DateTimeRangePickerLabels>;
+}> & Readonly<{
+    "onUpdate:modelValue"?: (value: DateTimeRange) => any;
+}>, {
+    locale: string;
+    disabled: boolean | undefined;
+    invalid: boolean | undefined;
+    readonly: boolean | undefined;
+    required: boolean | undefined;
+    granularity: "minute" | "second";
+    months: 1 | 2;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+//# sourceMappingURL=DateTimeRangePicker.vue.d.ts.map

package/dist/packages/primitives/date-time-range-picker/src/DateTimeRangePicker.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimeRangePicker.vue.d.ts","sourceRoot":"","sources":["../../../../../packages/primitives/date-time-range-picker/src/DateTimeRangePicker.vue"],"names":[],"mappings":"AAwgCA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAavE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6GAA6G;IAC7G,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AA2CD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAapC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GACvD,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,mBAAmB,CAAC;wBACD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAiEd;;;;;;OAMG;iBACU,aAAa,GAAG,SAAS;IACtC,8LAA8L;UACxL,MAAM;IACZ,0LAA0L;UACpL,MAAM;IACZ,4KAA4K;kBAC9J,QAAQ,GAAG,QAAQ;IACjC,6IAA6I;gBACjI,EAAE,GAAG,EAAE;IACnB,2JAA2J;aAClJ,MAAM;IACf,+LAA+L;aACtL,CAAC,GAAG,CAAC;IACd,uIAAuI;eAC5H,OAAO,GAAG,SAAS;IAC9B,qNAAqN;eAC1M,OAAO,GAAG,SAAS;IAC9B,yOAAyO;cAC/N,OAAO,GAAG,SAAS;IAC7B,wIAAwI;eAC7H,OAAO,GAAG,SAAS;IAC9B,qKAAqK;WAC9J,MAAM;IACb;;;;;;;;;OASG;aACM,cAAc,CAAC,yBAAyB,CAAC;;;;IAxClD;;;;;;OAMG;iBACU,aAAa,GAAG,SAAS;IACtC,8LAA8L;UACxL,MAAM;IACZ,0LAA0L;UACpL,MAAM;IACZ,4KAA4K;kBAC9J,QAAQ,GAAG,QAAQ;IACjC,6IAA6I;gBACjI,EAAE,GAAG,EAAE;IACnB,2JAA2J;aAClJ,MAAM;IACf,+LAA+L;aACtL,CAAC,GAAG,CAAC;IACd,uIAAuI;eAC5H,OAAO,GAAG,SAAS;IAC9B,qNAAqN;eAC1M,OAAO,GAAG,SAAS;IAC9B,yOAAyO;cAC/N,OAAO,GAAG,SAAS;IAC7B,wIAAwI;eAC7H,OAAO,GAAG,SAAS;IAC9B,qKAAqK;WAC9J,MAAM;IACb;;;;;;;;;OASG;aACM,cAAc,CAAC,yBAAyB,CAAC;;;;YAvBzC,MAAM;cAIJ,OAAO,GAAG,SAAS;aAIpB,OAAO,GAAG,SAAS;cAFlB,OAAO,GAAG,SAAS;cAInB,OAAO,GAAG,SAAS;iBAdhB,QAAQ,GAAG,QAAQ;YAMxB,CAAC,GAAG,CAAC;6EA+xCd,CAAC"}