@wssto2/vue-core 0.1.0 → 0.3.0

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

@@ -1,10 +1,13 @@
 import { type FieldProps } 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<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly "onUpdate:modelValue"?: ((value: Value[]) => any) | undefined;
     } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & (FieldProps & {
-        options: readonly SelectOption<Value>[];
+        options: OptionsSource<Value>;
+        /** The options of the current values when the caller already has them (a saved record's equipment): their labels show before the options arrive, or when they do not contain them. */
+        selected?: readonly SelectOption<Value>[];
         placeholder?: string;
         searchFrom?: number;
     } & {

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

@@ -24,9 +24,9 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
 }>, {
-    invalid: boolean;
     disabled: boolean;
     placeholder: string;
+    invalid: boolean;
     wide: boolean;
     min: number;
     max: number;

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

@@ -7,6 +7,9 @@ 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" />
  *
+ * `: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.
  * Limits (`min`, `max`) are the validator's job; the field only keeps what cannot be a number out.
  */
@@ -14,6 +17,8 @@ type __VLS_Props = FieldProps & {
     decimals?: number;
     /** Allows a leading minus sign. */
     negative?: boolean;
+    /** Separates thousands ("1.234.567"); off for years, coordinates and codes. */
+    grouping?: boolean;
     placeholder?: string;
     prefix?: string;
     suffix?: string;
@@ -30,13 +35,13 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
 }>, {
+    disabled: boolean;
+    placeholder: string;
     name: string;
     label: string;
     error: string;
     required: boolean;
     width: Exclude<ControlWidth, "content">;
-    disabled: boolean;
-    placeholder: string;
     prefix: string;
     presentation: "control" | "value";
     hint: string;
@@ -45,5 +50,6 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     suffix: string;
     decimals: number;
     negative: boolean;
+    grouping: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -1,8 +1,10 @@
 import { type SelectOption } from "./options";
+import type { SuggestionStatus } from "./suggestions";
 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<{
         readonly onSelect?: ((value: Value | null) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onSelect"> & {
+        readonly onRetry?: (() => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onSelect" | "onRetry"> & {
         options: readonly SelectOption<Value>[];
         /** The chosen value, or the chosen values when `multiple`. */
         modelValue?: Value | null | readonly Value[];
@@ -13,11 +15,13 @@ declare const _default: <Value extends string | number>(__VLS_props: NonNullable
         noneLabel?: string;
         /** `grouped` lists sit on the canvas of a sheet; `plain` in a popover. */
         presentation?: "grouped" | "plain";
+        /** Where the options are in loading; anything but `loaded` and `idle` replaces the rows with a line saying so. */
+        status?: SuggestionStatus;
     } & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
     slots: {};
-    emit: (evt: "select", value: Value | null) => void;
+    emit: ((evt: "select", value: Value | null) => void) & ((evt: "retry") => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

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

@@ -31,11 +31,11 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     onComplete?: ((code: string) => any) | undefined;
 }>, {
+    length: number;
+    disabled: boolean;
     name: string;
     label: string;
     invalid: boolean;
-    length: number;
-    disabled: boolean;
     autofocus: boolean;
     describedBy: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -18,11 +18,11 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | File | null) => any) | undefined;
 }>, {
+    disabled: boolean;
     name: string;
     label: string;
     error: string;
     required: boolean;
-    disabled: boolean;
     presentation: "control" | "value";
     hint: string;
     editable: boolean;

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

@@ -1,10 +1,13 @@
 import { type FieldProps } 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<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly "onUpdate:modelValue"?: ((value: Value | null) => any) | undefined;
     } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & (FieldProps & {
-        options: readonly SelectOption<Value>[];
+        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;
         /** Shows the search box from this many options. */

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

@@ -22,12 +22,12 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps,
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
+    disabled: boolean;
     name: string;
     label: string;
     error: string;
     required: boolean;
     size: "sm" | "md" | "lg";
-    disabled: boolean;
     presentation: "control" | "value";
     hint: string;
     editable: boolean;

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

@@ -58,14 +58,14 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
         detail?: string;
     }) => any) | undefined;
 }>, {
+    disabled: boolean;
+    type: "text" | "email" | "tel" | "url" | "password" | "search";
+    placeholder: string;
     name: string;
     label: string;
     error: string;
     required: boolean;
-    type: "text" | "email" | "tel" | "url" | "password" | "search";
     width: Exclude<ControlWidth, "content">;
-    disabled: boolean;
-    placeholder: string;
     prefix: string;
     presentation: "control" | "value";
     hint: string;

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

@@ -24,14 +24,14 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
+    disabled: boolean;
+    placeholder: string;
     name: string;
     label: string;
     error: string;
     required: boolean;
-    disabled: boolean;
-    placeholder: string;
-    presentation: "control" | "value";
     rows: number;
+    presentation: "control" | "value";
     stacked: boolean;
     hint: string;
     editable: boolean;

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

@@ -25,11 +25,11 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
 }>, {
+    disabled: boolean;
     name: string;
     label: string;
     error: string;
     required: boolean;
-    disabled: boolean;
     presentation: "control" | "value";
     hint: string;
     editable: boolean;

package/dist/form/date/DatePickerSheet.vue.d.ts

@@ -32,7 +32,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     step: number;
     modelValue: string | null;
-    clearable: boolean;
     min: Day | null;
     max: Day | null;
     disabledDates: DisabledDates;
@@ -40,5 +39,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     shortcuts: readonly (Shortcut & {
         disabled?: boolean;
     })[];
+    clearable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/form/date/MonthYearPanel.vue.d.ts

@@ -25,8 +25,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
         year: number;
     }) => any) | undefined;
 }>, {
-    year: number | null;
     month: number | null;
+    year: number | null;
     viewYear: number;
     minYear: number;
     maxYear: number;

package/dist/form/index.d.ts

@@ -42,6 +42,8 @@ export { groupOptions, matchOptions } from "./options";
 export { recentChoicesKey } from "./suggestions";
 export type { RecentChoices, SuggestionSource, TextSuggestion } from "./suggestions";
 export type { OptionGroup, SelectOption } from "./options";
+export { useOptions } from "./useOptions";
+export type { AsyncOptions, OptionsContext, OptionsSource } from "./useOptions";
 export { default as OtpInput } from "./OtpInput.vue";
 export { default as PhotoField } from "./PhotoField.vue";
 export { default as SegmentedField } from "./SegmentedField.vue";