@wssto2/vue-core 0.4.15 → 0.4.17

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,6 +7,10 @@ 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.
  *
@@ -15,23 +19,29 @@ import { type FieldProps } from "./field";
  * 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;
@@ -51,10 +61,18 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     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;
@@ -31,4 +32,10 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     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,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, 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<{
@@ -16,7 +16,7 @@ declare const _default: <Value extends string | number, Clearable extends boolea
     }) & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: {};
+    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 & {

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;
@@ -84,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;
@@ -40,4 +41,10 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     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;
@@ -38,4 +39,10 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     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

@@ -34,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";