@wssto2/vue-core 0.1.0 → 0.2.0

package/dist/collection/rowLayout.d.ts

@@ -0,0 +1,10 @@
+import { type ComputedRef } from "vue";
+import type { Column } from "./columns";
+/**
+ * How a list lays out its rows: below 1024 px (`narrow`), and when any column has a `mobile` role
+ * other than `hidden`, the rows are phone rows (`phone`); otherwise it stays a table at every width.
+ */
+export declare function useRowLayout(columns: () => readonly Pick<Column<never>, "mobile">[]): {
+    narrow: ComputedRef<boolean>;
+    phone: ComputedRef<boolean>;
+};

package/dist/collection/slots.d.ts

@@ -11,17 +11,20 @@ export type CellSlots<Row, Col extends Column<Row>> = {
         to: RouteLocationRaw | null;
     }) => unknown;
 };
-/** Every slot of a collection table, and so of `ListPage`, which forwards them. */
-export type CollectionSlots<Row, Col extends Column<Row>> = CellSlots<Row, Col> & {
+/** The slots of the rows themselves: what `DataTable` and, with the page's own, `CollectionTable` offer. */
+export type RowsSlots<Row, Col extends Column<Row>> = CellSlots<Row, Col> & {
     /** A mark that leads the record's identity (an avatar, a tile). Phone rows show it across both lines. */
     leading?: (scope: {
         item: Row;
         compact: boolean;
     }) => unknown;
-    /** Replaces the desktop actions cell (the link to the record and the More button). */
+    /** Replaces the desktop actions cell (the link to the record and the More button): a `RowActions` row of buttons. */
     actions?: (scope: {
         item: Row;
     }) => unknown;
+};
+/** Every slot of a collection table, and so of `ListPage`, which forwards them. */
+export type CollectionSlots<Row, Col extends Column<Row>> = RowsSlots<Row, Col> & {
     /** Page controls in the toolbar, after the filters. */
     toolbar?: () => unknown;
     /** What an empty list shows when nothing exists yet (no search or filter applies): a first use that teaches. */

package/dist/describeError-l5T9b8Uv.js

@@ -0,0 +1,41 @@
+import { useI18n as t } from "vue-i18n";
+import { i } from "./error-Bb_dr_Ay.js";
+function u({ t: r, te: s }) {
+  return (e, { fallback: o } = {}) => {
+    const c = o ?? r("core.errors.unexpected");
+    if (!i(e)) return c;
+    if (e.code) {
+      for (const n of [`errors.${e.code}`, `core.errors.${e.code}`])
+        if (s(n)) return r(n, { ...e.params });
+      if (e.message) return e.message;
+    }
+    switch (e.kind) {
+      case "unauthorized":
+        return r("core.errors.unauthenticated");
+      case "forbidden":
+        return r("core.errors.forbidden");
+      case "notFound":
+        return r("core.errors.not_found");
+      case "conflict":
+        return r("core.errors.conflict");
+      case "network":
+        return r("core.errors.offline");
+      case "aborted":
+        return r("core.errors.cancelled");
+      case "server":
+      case "malformed":
+        return c;
+      case "validation":
+        if (Object.keys(e.fields).length > 0) return r("core.errors.check_fields");
+        break;
+    }
+    return e.status === 429 ? r("core.errors.rate_limited") : o ?? (e.message || r("core.errors.unexpected"));
+  };
+}
+function f() {
+  const { t: r, te: s } = t();
+  return u({ t: (e, o) => r(e, o ?? {}), te: (e) => s(e) });
+}
+export {
+  f as u
+};

package/dist/dialogStack-DZZg55w0.js

@@ -0,0 +1,31 @@
+import { computed as c, onUnmounted as d, shallowRef as f } from "vue";
+import { p as v } from "./perDocument-DUuFrdGU.js";
+const y = "data-dialog-inert-skip", i = "overflow-hidden", m = Symbol("vue-core:dialog-stack"), a = () => v(m, () => ({ entries: f([]), inertedByUs: /* @__PURE__ */ new Set(), lockedByUs: !1 }));
+function r(e) {
+  const n = e.entries.value[e.entries.value.length - 1]?.root() ?? null;
+  for (const t of Array.from(document.body.children)) {
+    if (!(t instanceof HTMLElement)) continue;
+    const s = n !== null && !t.hasAttribute(y) && !t.contains(n);
+    s && !t.inert ? (t.inert = !0, e.inertedByUs.add(t)) : !s && e.inertedByUs.has(t) && (t.inert = !1, e.inertedByUs.delete(t));
+  }
+  const o = e.entries.value.length > 0;
+  o && !document.body.classList.contains(i) ? (document.body.classList.add(i), e.lockedByUs = !0) : !o && e.lockedByUs && (document.body.classList.remove(i), e.lockedByUs = !1);
+}
+function B(e) {
+  const n = a(), o = { root: () => e.value }, t = c(() => n.entries.value[n.entries.value.length - 1] === o), s = () => {
+    n.entries.value.includes(o) || (n.entries.value = [...n.entries.value, o]), r(n);
+  }, l = () => {
+    n.entries.value.includes(o) && (n.entries.value = n.entries.value.filter((u) => u !== o), r(n));
+  };
+  return d(l), { isTop: t, activate: s, deactivate: l };
+}
+function S() {
+  const e = a();
+  return c(() => e.entries.value.length);
+}
+export {
+  y as I,
+  i as S,
+  B as a,
+  S as u
+};

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

@@ -8,9 +8,13 @@ import type { Form } from "./useForm";
  *   <CommandDialog :command="assign" :title="t('assign')" :confirm-label="t('assign')" :done-label="t('assigned')">
  *     <FormGroup><ComboField v-bind="assign.form.bind('assignee')" :label="t('assignee')" :search="findUsers" /></FormGroup>
  *   </CommandDialog>
+ *
+ * Another action beside the primary one goes in `#actions`; `run({ addAnother: true })` saves like the primary action and then,
+ * instead of closing, opens the dialog again with fresh inputs (the command's defaults), so the next record can be entered
+ * (the add-a-record recipe, `docs/recipes/forms.md`).
  */
 type __VLS_Props = {
-    command: Pick<Command<object, unknown, unknown>, "open" | "run" | "dismiss"> & {
+    command: Pick<Command<object, unknown, unknown>, "open" | "run" | "dismiss" | "present"> & {
         readonly form: Pick<Form<object>, "dirty" | "submitting" | "failure" | "errors">;
     };
     title: string;
@@ -29,6 +33,13 @@ type __VLS_Props = {
 };
 type __VLS_Slots = {
     default?: () => unknown;
+    /** More actions in the footer, beside Cancel and the primary one. */
+    actions?: (scope: {
+        run: (options?: {
+            addAnother?: boolean;
+        }) => Promise<void>;
+        busy: boolean;
+    }) => unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     done: () => any;

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

@@ -44,8 +44,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     footer: string;
     header: string;
     section: boolean;
-    anchor: string;
     group: string;
+    anchor: string;
     editable: boolean;
     hideEmpty: boolean;
     labelWidth: string;

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/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;
@@ -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/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/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";