@wssto2/vue-core 0.4.14 → 0.4.16

package/dist/form/MoneyField.vue.d.ts

@@ -1,5 +1,5 @@
 import type { ControlWidth } from "../controls";
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * An amount of money: a `NumberField` with two decimals and the currency after the number. The currency is
  * shown as given ("EUR", "€"); the amount is a plain number (what the payload carries is the feature's mapping).
@@ -12,10 +12,11 @@ type __VLS_Props = FieldProps & {
     negative?: boolean;
     width?: Exclude<ControlWidth, "content">;
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: number | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: number | null) => any;
@@ -29,10 +30,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     required: boolean;
     width: Exclude<ControlWidth, "content">;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
     decimals: number;
     negative: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/MonthYearField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * A month and a year shown as one date button, kept as two numbers (`month` 1 to 12, `year`), the way a record stores a
  * first registration. The button opens a popover with the year (arrows step it; clicking it opens a grid of twelve years,
@@ -12,11 +12,12 @@ type __VLS_Props = FieldProps & {
     minYear?: number;
     maxYear?: number;
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     "month"?: number | null;
     "year"?: number | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:month": (value: number | null) => any;
     "update:year": (value: number | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
@@ -29,10 +30,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
     minYear: number;
     maxYear: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/MultiSelectField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 import type { SelectOption } from "./options";
 import { type OptionsSource } from "./useOptions";
 declare const _default: <Value extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
@@ -15,7 +15,7 @@ declare const _default: <Value extends string | number>(__VLS_props: NonNullable
     }) & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: {};
+    slots: FieldSlots;
     emit: (evt: "update:modelValue", value: Value[]) => void;
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/form/NumberField.vue.d.ts

@@ -1,5 +1,5 @@
 import { type ControlWidth } from "../controls";
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * A number. Empty is `null`; the text is read as the user's locale writes numbers (and forgives the
  * other decimal mark), rounded to `decimals`, shown with grouping when the field is not being edited.
@@ -7,28 +7,41 @@ import { type FieldProps } from "./field";
  *   <NumberField v-bind="form.bind('quantity')" :label="t('quantity')" suffix="pcs" />
  *   <NumberField v-bind="form.bind('weight')" :decimals="2" suffix="kg" />
  *
+ * `decimals` is the most fraction digits the field takes and keeps; `minDecimals` is how many are always shown (default: `decimals`, so an
+ * amount reads `1.50`). A coordinate is `:decimals="7" :min-decimals="0" mono` and reads `43.566139`, not `43.5661390`. `mono` sets the
+ * number in the monospaced face of `TextField mono`, when it is read character by character.
+ *
  * `:grouping="false"` writes no thousands separator, shown or typed (a year 2024, a coordinate 45.815123), and then a "."
  * is always a decimal mark, never a group mark.
  *
  * Typing "1,5" mid-edit is never rewritten under the cursor: the text is the user's until the field loses focus.
+ * `:max-digits="5"` takes at most five digits (a postal code): typing a sixth does nothing, pasting a longer number keeps its first five.
  * Limits (`min`, `max`) are the validator's job; the field only keeps what cannot be a number out.
  */
 type __VLS_Props = FieldProps & {
+    /** The most fraction digits the field takes and keeps. */
     decimals?: number;
+    /** The fraction digits always shown, at most `decimals`: `1.50` for `decimals: 2`. Default: `decimals`; `0` shows only the digits the number has. */
+    minDecimals?: number;
     /** Allows a leading minus sign. */
     negative?: boolean;
     /** Separates thousands ("1.234.567"); off for years, coordinates and codes. */
     grouping?: boolean;
+    /** The most digits the field takes, fraction digits included (the sign, separators and decimal mark are not counted): a postal code is `:max-digits="5"`. Further digits are not accepted, as `maxlength` does for text; a pasted longer number keeps its first digits. */
+    maxDigits?: number;
+    /** The monospaced face of `TextField mono` (coordinates, codes). */
+    mono?: boolean;
     placeholder?: string;
     prefix?: string;
     suffix?: string;
     /** sm 10rem (the default for numbers) · md · lg · full. */
     width?: Exclude<ControlWidth, "content">;
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: number | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: number | null) => any;
@@ -44,12 +57,22 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     width: Exclude<ControlWidth, "content">;
     prefix: string;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
+    mono: boolean;
     suffix: string;
     decimals: number;
+    minDecimals: number;
     negative: boolean;
     grouping: boolean;
+    maxDigits: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/PhotoField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * One picture. The value is the chosen `File`, or a `string` for a picture the record already has (its URL); `null` is none.
  * The preview is made here and released when it is replaced or the field goes away; tapping it opens the picture in the `PhotoViewer`
@@ -10,10 +10,11 @@ type __VLS_Props = FieldProps & {
     accept?: readonly string[];
     maxSize?: number;
 };
+type __VLS_Slots = Pick<FieldSlots, "trailing" | "labelTrailing">;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: File | string | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string | File | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | File | null) => any) | undefined;
@@ -24,10 +25,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
     accept: readonly string[];
     maxSize: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/SegmentedField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 import type { SelectOption } from "./options";
 declare const _default: <Value extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
@@ -13,7 +13,7 @@ declare const _default: <Value extends string | number>(__VLS_props: NonNullable
     }) & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: {};
+    slots: FieldSlots;
     emit: (evt: "update:modelValue", value: Value) => void;
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/form/SelectField.vue.d.ts

@@ -1,24 +1,23 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 import type { SelectOption } from "./options";
 import { type OptionsSource } from "./useOptions";
-declare const _default: <Value extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const _default: <Value extends string | number, Clearable extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
-        readonly "onUpdate:modelValue"?: ((value: Value | null) => any) | undefined;
+        readonly "onUpdate:modelValue"?: ((value: Clearable extends true ? Value | null : Value) => any) | undefined;
     } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & (FieldProps & {
         options: OptionsSource<Value>;
         /** The option of the current value when the caller already has it (a saved record's model): its label shows before the options arrive, or when they do not contain it. */
         selected?: SelectOption<Value> | null;
         placeholder?: string;
-        clearable?: boolean;
+        clearable?: Clearable;
+        modelValue?: Value | null;
         /** Shows the search box from this many options. */
         searchFrom?: number;
-    } & {
-        modelValue?: Value | null;
     }) & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: {};
-    emit: (evt: "update:modelValue", value: Value | null) => void;
+    slots: FieldSlots;
+    emit: (evt: "update:modelValue", value: Clearable extends true ? Value | null : Value) => void;
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/form/SwitchField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * An on/off setting, iOS style: the label with a switch at the row's end. The value is a boolean: a column that
  * holds 0 and 1, or "0" and "1", is mapped where the record is (`toValues`, the payload), so the switch never has
@@ -11,7 +11,7 @@ import { type FieldProps } from "./field";
 type __VLS_Props = FieldProps & {
     size?: "sm" | "md" | "lg";
 };
-type __VLS_Slots = {
+type __VLS_Slots = FieldSlots & {
     before?: () => unknown;
 };
 type __VLS_PublicProps = __VLS_Props & {
@@ -29,6 +29,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps,
     required: boolean;
     size: "sm" | "md" | "lg";
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;

package/dist/form/TextField.vue.d.ts

@@ -1,5 +1,5 @@
 import { type ControlWidth } from "../controls";
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 import { type TextSuggestion } from "./suggestions";
 /**
  * A line of text: a name, an e-mail address, a code. The value is always a string ("" is empty); a nullable
@@ -40,10 +40,11 @@ type __VLS_Props = FieldProps & {
     /** The id the last picks are kept under (see `recentChoicesKey`); setting it shows them under "Recent" before typing. */
     recents?: string;
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: string;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
@@ -68,6 +69,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     width: Exclude<ControlWidth, "content">;
     prefix: string;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
@@ -83,4 +85,10 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     suggestionsDebounce: number;
     suggestionsLimit: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/TextareaField.vue.d.ts

@@ -1,4 +1,4 @@
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * Longer text. On wide screens a labelled textarea is an entry row like the others (the label in the label
  * column, top-aligned, with "n / max" under it when there is a `maxLength`); on phones, and when `stacked`,
@@ -14,10 +14,11 @@ type __VLS_Props = FieldProps & {
     /** The label above the field even on wide screens: for a group too narrow for a label column. */
     stacked?: boolean;
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: string;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
@@ -33,10 +34,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     presentation: "control" | "value";
     rows: number;
     stacked: boolean;
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
     maxLength: number;
     autocomplete: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/TimeField.vue.d.ts

@@ -1,5 +1,5 @@
 import type { QuickTime } from "./date/quickPicks";
-import { type FieldProps } from "./field";
+import { type FieldProps, type FieldSlots } from "./field";
 /**
  * A time of day on the clock of the user, without a date or a zone: `"14:35"`, or `null`. Typing is forgiving (`1435`,
  * `14.35`, `14:35`, `9`, the word for now); the popover (a drum sheet on a phone) has an hour list 00 to 23 and a minute
@@ -15,10 +15,11 @@ type __VLS_Props = FieldProps & {
     /** Shortcuts: `"now"`, a time such as `"08:00"`, or `{ label, time }`. */
     quickTimes?: readonly QuickTime[];
 };
+type __VLS_Slots = FieldSlots;
 type __VLS_PublicProps = __VLS_Props & {
     modelValue?: string | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string | null) => any;
@@ -31,10 +32,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     error: string;
     required: boolean;
     presentation: "control" | "value";
+    labelHidden: boolean;
     hint: string;
     editable: boolean;
     lockedReason: string;
     minuteStep: number;
     quickTimes: readonly QuickTime[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/form/field.d.ts

@@ -2,6 +2,8 @@ import { type ComputedRef, type InjectionKey, type Ref } from "vue";
 /** What every field takes besides its value. A field is one labelled row: the label, the control, a hint, the error. */
 export interface FieldProps {
     label?: string;
+    /** The label stays the control's accessible name (and the read-mode row's) but is not drawn: for a field whose group header already says it. */
+    labelHidden?: boolean;
     /** A sentence under the label (under the control outside a group) that says what to enter. */
     hint?: string;
     /** The message to show; `form.bind()` supplies it. */
@@ -22,6 +24,7 @@ export interface FieldProps {
 /** Defaults of `FieldProps` for `withDefaults(defineProps<FieldProps & …>(), { ...fieldDefaults, … })`. */
 export declare const fieldDefaults: {
     label: undefined;
+    labelHidden: boolean;
     hint: undefined;
     error: undefined;
     required: boolean;
@@ -31,6 +34,15 @@ export declare const fieldDefaults: {
     presentation: "control";
     name: undefined;
 };
+/** The slots every field passes through to its `Field` row (see `Field`). */
+export interface FieldSlots {
+    /** A custom read-only presentation (a picked record's card) when the value is not enough. */
+    readonly?: () => unknown;
+    /** A row action after the control (a per-row Save). */
+    trailing?: () => unknown;
+    /** At the end of the label's line while editing. */
+    labelTrailing?: () => unknown;
+}
 /** How a row lays out: a label column with a control, a label with a trailing control, a label over a full-width control, or a value. */
 export type FormRowLayout = "entry" | "setting" | "stacked" | "value";
 /** The state a `FormGroup` shares with the rows in it. */

package/dist/form/index.d.ts

@@ -20,7 +20,7 @@ export { default as DateField } from "./DateField.vue";
 export { default as DateTimeField } from "./DateTimeField.vue";
 export { default as Field } from "./Field.vue";
 export { fieldDefaults, fieldProps, formEditableKey, useFieldMode } from "./field";
-export type { FieldProps, FormRowLayout } from "./field";
+export type { FieldProps, FieldSlots, FormRowLayout } from "./field";
 export { default as FileField } from "./FileField.vue";
 export { checkFile, formatBytes } from "./file";
 export type { FileProblem } from "./file";
@@ -61,6 +61,8 @@ export { useGroupSheet } from "./useGroupSheet";
 export type { GroupSheetForm, GroupSheetOptions, GroupSheetState } from "./useGroupSheet";
 export { default as EditorPage } from "./EditorPage.vue";
 export { useSectionStates } from "./sectionStates";
+export { useHiddenFieldErrors } from "./useHiddenFieldErrors";
+export type { HiddenFieldError } from "./useHiddenFieldErrors";
 export { useSaveChrome } from "./useSaveChrome";
 export type { SaveChromeOptions } from "./useSaveChrome";
 export { default as CommandDialog } from "./CommandDialog.vue";