@wssto2/vue-core 0.4.20 → 0.4.21

package/dist/form/useCommand.d.ts

@@ -1,10 +1,23 @@
 import { type Ref } from "vue";
 import { type Form, type FormOptions, type SubmitContext, type SubmitResult } from "./useForm";
+/** The question a command asks before it runs: it names the consequence ("Archive the vehicle?"), and `confirmLabel` says exactly what yes does. */
+export interface CommandQuestion {
+    readonly title: string;
+    readonly message?: string;
+    readonly confirmLabel?: string;
+    readonly tone?: "neutral" | "warning" | "critical";
+}
 export interface CommandOptions<Values extends object, Output = Values, Done = unknown> extends FormOptions<Values, Output> {
     /** The call: one purpose-specific endpoint (advance a status, assign, approve, change a price). Its payload is the validator's output. */
     readonly run: (input: Output, context: SubmitContext) => Promise<Done>;
     /** After the call went through: the page updates itself (reloads the record, toasts). */
     readonly done?: (result: Done) => Promise<unknown> | unknown;
+    /**
+     * A question to put after the inputs check out and before anything is sent (an irreversible step): its answer, not the primary action,
+     * runs the command. It reads the validated input and whatever the caller holds (what is still unpaid); `null` asks nothing this time.
+     * `CommandDialog` presents it; No returns to the filled form, Yes calls with the usual idempotency key.
+     */
+    readonly ask?: (input: Output) => CommandQuestion | null;
 }
 export interface Command<Values extends object, Output = Values, Done = unknown> {
     /** The command's inputs: a small form (`command.form.bind('assignee')`). */
@@ -16,6 +29,10 @@ export interface Command<Values extends object, Output = Values, Done = unknown>
     dismiss(): void;
     /** Validates and calls. One call at a time; a failure keeps the inputs and says why (`form.failure`, field errors on the fields). */
     run(): Promise<SubmitResult<Done>>;
+    /** The question waiting for an answer (set by `run()` when `ask` returned one, instead of calling). */
+    readonly question: Readonly<Ref<CommandQuestion | null>>;
+    /** Answers it: Yes calls (the result is `run()`'s), No sends nothing and keeps the inputs (`aborted`). */
+    answer(yes: boolean): Promise<SubmitResult<Done>>;
     /** For `AlertDialog`'s `action`: resolves when the call went through, throws when it did not, so the dialog stays open and `@failed` fires. */
     confirm(): Promise<void>;
 }
@@ -32,6 +49,7 @@ export interface Command<Values extends object, Output = Values, Done = unknown>
  *   <CommandDialog :command="assign" :title="t('assign')" :confirm-label="t('assign')"><SelectField v-bind="assign.form.bind('assignee')" … /></CommandDialog>
  *   <Button @click="assign.present()">Assign</Button>
  *
+ * `ask: (input) => ({ title, message, confirmLabel, tone }) | null` puts a question before the call (a delivery that archives the vehicle).
  * A command with nothing to enter is an `AlertDialog` with `:action="command.confirm"`.
  */
 export declare function useCommand<Values extends object, Output = Values, Done = unknown>(options: CommandOptions<Values, Output, Done>): Command<Values, Output, Done>;

package/dist/identity/index.js

@@ -1,4 +1,4 @@
-import { _ as t, h as n, j as a, i, k as o, d as r, l as d, m as u, n as y, r as l, o as I, s as f, q as p, t as A, f as c } from "../index-Dxu7ZfCC.js";
+import { _ as t, h as n, j as a, i, k as o, d as r, l as d, m as u, n as y, r as l, o as I, s as f, q as p, t as A, f as c } from "../index-DiEoRV9D.js";
 export {
   t as SignInAsButton,
   n as identityFeature,

package/dist/{index-D6BjUQJT.js → index-C3HWRCEe.js}

@@ -16,7 +16,7 @@ import { _ as Oe } from "./AsyncSection.vue_vue_type_script_setup_true_lang-Blj6
 import { u as Ae } from "./useLoad-M7V-AVwR.js";
 import { _ as De, a as Ke } from "./SelectField.vue_vue_type_script_setup_true_lang-C3FbRQW7.js";
 import { _ as Be } from "./SegmentedField.vue_vue_type_script_setup_true_lang-Dg-_ZjgR.js";
-import { u as Pe, _ as Ue } from "./useCommand-YN9EMb7s.js";
+import { u as Pe, _ as Ue } from "./useCommand-VIZE7xG-.js";
 import { u as Fe } from "./platform-q3cjODLx.js";
 import { _ as Ge } from "./IconTile.vue_vue_type_script_setup_true_lang-_FXvaj93.js";
 import { u as Me } from "./mediaQuery-CygcXmFW.js";
@@ -43,12 +43,12 @@ const C = {
   viewAccess: "iam.user:view",
   manageBindings: "iam.user:manage"
 }, re = Ee({
-  roles: { name: "access.roles", path: "/iam/roles", component: () => import("./RolesPage-8uWWCClN.js"), meta: { access: F.viewRoles, titleKey: "core.access.title" } },
-  newRole: { name: "access.roles.new", path: "/iam/roles/new", component: () => import("./NewRolePage-D-LunWMH.js"), meta: { access: F.manageRoles, titleKey: "core.access.new_title" } },
+  roles: { name: "access.roles", path: "/iam/roles", component: () => import("./RolesPage-BGPoUCMP.js"), meta: { access: F.viewRoles, titleKey: "core.access.title" } },
+  newRole: { name: "access.roles.new", path: "/iam/roles/new", component: () => import("./NewRolePage-OosTaMfZ.js"), meta: { access: F.manageRoles, titleKey: "core.access.new_title" } },
   role: {
     name: "access.role",
     path: "/iam/roles/:ref",
-    component: () => import("./RolePage-Ha-EgoEJ.js"),
+    component: () => import("./RolePage-33RUvHYD.js"),
     // A role's ref (its key, or the id of a custom one) swaps in place when a link leads to another role.
     meta: { access: F.viewRoles, titleKey: "core.access.title", remountOnParam: "ref" }
   }

package/dist/{index-Dxu7ZfCC.js → index-DiEoRV9D.js}

@@ -315,7 +315,7 @@ function Cs(e) {
 const Ye = async (e) => {
   await B(e.http);
 }, Je = z({
-  login: { name: "login", path: "/login", component: () => import("./SignInPage-CsjC4aiV.js"), meta: { public: !0, titleKey: "core.identity.signin.title" } }
+  login: { name: "login", path: "/login", component: () => import("./SignInPage-D9jryXA7.js"), meta: { public: !0, titleKey: "core.identity.signin.title" } }
 });
 function Os(e = {}) {
   return H({
@@ -334,7 +334,7 @@ function Os(e = {}) {
   });
 }
 const Z = z({
-  index: { name: "profile", path: "/profile", component: () => import("./ProfilePage-DJUDCyEr.js"), meta: { titleKey: "core.profile.title" } }
+  index: { name: "profile", path: "/profile", component: () => import("./ProfilePage-Dn8fQ3ff.js"), meta: { titleKey: "core.profile.title" } }
 }), Qe = /* @__PURE__ */ E({
   __name: "ProfileMenuItem",
   setup(e) {
@@ -358,19 +358,19 @@ function es(e) {
   return { name: `users.record.${e.path}`, path: e.path, component: s, meta: { ...e.meta } };
 }
 const W = "iam.user:view", qs = "iam.user:manage", ss = "iam.user.activity:view", ee = z({
-  index: { name: "users.index", path: "/users", component: () => import("./UsersList-BBLa3OCv.js"), meta: { access: W, titleKey: "core.users.title" } },
+  index: { name: "users.index", path: "/users", component: () => import("./UsersList-BE8fnICz.js"), meta: { access: W, titleKey: "core.users.title" } },
   record: {
     name: "users.record",
     path: "/users/:id",
-    component: () => import("./UserRecord-B9r_9U1z.js"),
+    component: () => import("./UserRecord-CUhbz62x.js"),
     meta: { access: W, titleKey: "core.users.title", remountOnParam: "id" },
     children: [
-      { name: "users.record.general", path: "general", component: () => import("./General-9Sgxb74n.js"), meta: { section: { labelKey: "core.users.sections.general", icon: "user3Line", groupKey: "core.users.section_groups.person" } } },
-      { name: "users.record.signin", path: "signin", component: () => import("./SignIn-CNv68Tba.js"), meta: { section: { labelKey: "core.users.sections.signin", icon: "key2Line", groupKey: "core.users.section_groups.access" } } },
-      { name: "users.record.sessions", path: "sessions", component: () => import("./Sessions-Dz4KYMu9.js"), meta: { section: { labelKey: "core.users.sections.sessions", icon: "deviceLine", groupKey: "core.users.section_groups.access" } } },
-      { name: "users.record.signins", path: "signins", component: () => import("./SignIns-CgsNf8uf.js"), meta: { section: { labelKey: "core.users.sections.signins", icon: "timeFill", groupKey: "core.users.section_groups.activity" } } },
-      { name: "users.record.changes", path: "changes", component: () => import("./Changes-hoMHeAZt.js"), meta: { section: { labelKey: "core.users.sections.changes", icon: "edit", groupKey: "core.users.section_groups.activity" } } },
-      { name: "users.record.activity", path: "activity", component: () => import("./Activity-C0NvjIi5.js"), meta: { access: ss, section: { labelKey: "core.users.sections.activity", icon: "listCheck", groupKey: "core.users.section_groups.activity" } } }
+      { name: "users.record.general", path: "general", component: () => import("./General-CkZoXu29.js"), meta: { section: { labelKey: "core.users.sections.general", icon: "user3Line", groupKey: "core.users.section_groups.person" } } },
+      { name: "users.record.signin", path: "signin", component: () => import("./SignIn-DDCRzlUq.js"), meta: { section: { labelKey: "core.users.sections.signin", icon: "key2Line", groupKey: "core.users.section_groups.access" } } },
+      { name: "users.record.sessions", path: "sessions", component: () => import("./Sessions-BbAdbjmG.js"), meta: { section: { labelKey: "core.users.sections.sessions", icon: "deviceLine", groupKey: "core.users.section_groups.access" } } },
+      { name: "users.record.signins", path: "signins", component: () => import("./SignIns-C_5sRrB4.js"), meta: { section: { labelKey: "core.users.sections.signins", icon: "timeFill", groupKey: "core.users.section_groups.activity" } } },
+      { name: "users.record.changes", path: "changes", component: () => import("./Changes-_nARQ9IC.js"), meta: { section: { labelKey: "core.users.sections.changes", icon: "edit", groupKey: "core.users.section_groups.activity" } } },
+      { name: "users.record.activity", path: "activity", component: () => import("./Activity-DX-RK9xj.js"), meta: { access: ss, section: { labelKey: "core.users.sections.activity", icon: "listCheck", groupKey: "core.users.section_groups.activity" } } }
     ]
   }
 });

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 /** The version of @wssto2/vue-core (kept equal to package.json by index.test.ts). */
-export declare const version = "0.4.20";
+export declare const version = "0.4.21";

package/dist/index.js

@@ -1,4 +1,4 @@
-const o = "0.4.20";
+const o = "0.4.21";
 export {
   o as version
 };

package/dist/{status-BLTC7wi1.js → status-UWWFHi9t.js}

@@ -1,5 +1,5 @@
 import { a, r as o } from "./http-D_D9YbLH.js";
-import { i as r } from "./index-Dxu7ZfCC.js";
+import { i as r } from "./index-DiEoRV9D.js";
 const n = ["active", "locked", "inactive", "all"];
 function l(i) {
   return a({

package/dist/useCommand-VIZE7xG-.js

@@ -0,0 +1,168 @@
+import { nextTick as f, defineComponent as C, useTemplateRef as v, ref as b, watch as L, onBeforeUnmount as N, computed as q, openBlock as p, createElementBlock as D, Fragment as z, createVNode as S, unref as y, createSlots as F, withCtx as $, createElementVNode as V, toDisplayString as A, createCommentVNode as h, renderSlot as x, createBlock as O } from "vue";
+import { useI18n as I } from "vue-i18n";
+import { f as R } from "./useDialog-CXR3hN0G.js";
+import { _ as U } from "./Modal.vue_vue_type_script_setup_true_lang-DpBb8ans.js";
+import { _ as G } from "./AlertDialog.vue_vue_type_script_setup_true_lang-whA4WLdl.js";
+import { D as K } from "./useWaitStatus-fsacMl4W.js";
+import { _ as M, u as P } from "./FormErrors.vue_vue_type_script_setup_true_lang-DWcVKZM3.js";
+import { a as W } from "./leaveGuard-Cc8yeLxM.js";
+const c = "input:not([type=hidden]):not([disabled]), textarea:not([disabled]), select:not([disabled]), button:not([disabled]), [tabindex]:not([tabindex='-1'])";
+async function Y(t = document, r) {
+  const e = [...t.querySelectorAll("[data-field-error]")], n = e.find((o) => o.matches(c) || o.querySelector(c)) ?? e[0];
+  if (!n) return !1;
+  const i = r?.sections.value.find((o) => o.element.contains(n));
+  i && (await r?.scrollTo(i.id, { updateUrl: !1 }), await f());
+  const l = n.matches(c) ? n : n.querySelector(c);
+  return (l ?? n).scrollIntoView?.({ block: "center" }), (l ?? n).focus({ preventScroll: !0 }), !0;
+}
+const se = (t) => ({ "data-field-key": t }), j = {
+  key: 0,
+  class: "text-body text-content-muted"
+}, ne = /* @__PURE__ */ C({
+  __name: "CommandDialog",
+  props: {
+    command: {},
+    title: {},
+    subtitle: { default: void 0 },
+    confirmLabel: {},
+    confirmDisabled: { type: Boolean, default: !1 },
+    doneLabel: { default: void 0 },
+    busyLabel: { default: void 0 },
+    message: { default: void 0 },
+    size: { default: "sm" },
+    fieldLabel: { type: Function, default: void 0 }
+  },
+  emits: ["done"],
+  setup(t, { emit: r }) {
+    const e = t, n = r, { t: i } = I(), l = v("modal"), o = v("body"), a = b(!1);
+    let u = null;
+    const { confirmDiscard: E } = W(() => e.command.open.value && e.command.form.dirty.value);
+    L(() => e.command.open.value, (s) => {
+      s ? (a.value = !1, l.value?.present()) : l.value?.dismiss();
+    });
+    async function w(s = {}) {
+      e.confirmDisabled || await g(await e.command.run(), s);
+    }
+    async function g(s, d = {}) {
+      if (s.status === "failed") {
+        s.failure.kind === "invalid" && await f().then(() => Y(o.value ?? document));
+        return;
+      }
+      if (s.status !== "aborted") {
+        if (n("done"), d.addAnother) {
+          e.command.present(), await f(), R(o.value)[0]?.focus();
+          return;
+        }
+        a.value = !0, u = setTimeout(() => e.command.dismiss(), K);
+      }
+    }
+    const k = v("ask"), m = b(null);
+    L(() => e.command.question?.value, (s) => {
+      s && (m.value = s, f(() => k.value?.present()));
+    });
+    const T = async () => {
+      e.command.answer && await g(await e.command.answer(!0));
+    };
+    N(() => {
+      u && clearTimeout(u);
+    });
+    const B = q(() => e.command.form.submitting.value ? "processing" : a.value ? "done" : "idle");
+    return (s, d) => (p(), D(z, null, [
+      S(U, {
+        ref_key: "modal",
+        ref: l,
+        size: e.size,
+        grouped: "",
+        title: e.title,
+        subtitle: e.subtitle,
+        "before-dismiss": y(E),
+        "primary-label": e.confirmLabel,
+        "primary-disabled": e.confirmDisabled,
+        status: B.value,
+        "processing-label": e.busyLabel ?? y(i)("core.actions.saving"),
+        "done-label": e.doneLabel ?? y(i)("core.actions.saved"),
+        onPrimary: d[0] || (d[0] = (_) => w()),
+        onDismissed: d[1] || (d[1] = (_) => e.command.dismiss())
+      }, F({
+        default: $(() => [
+          V("div", {
+            ref_key: "body",
+            ref: o,
+            class: "flex min-w-0 flex-col gap-group-gap",
+            "data-test": "command-dialog"
+          }, [
+            e.message ? (p(), D("p", j, A(e.message), 1)) : h("", !0),
+            S(M, {
+              form: e.command.form,
+              label: e.fieldLabel,
+              scope: o.value
+            }, null, 8, ["form", "label", "scope"]),
+            x(s.$slots, "default")
+          ], 512)
+        ]),
+        _: 2
+      }, [
+        s.$slots.actions ? {
+          name: "actions",
+          fn: $(() => [
+            x(s.$slots, "actions", {
+              run: w,
+              busy: e.command.form.submitting.value
+            })
+          ]),
+          key: "0"
+        } : void 0
+      ]), 1032, ["size", "title", "subtitle", "before-dismiss", "primary-label", "primary-disabled", "status", "processing-label", "done-label"]),
+      m.value ? (p(), O(G, {
+        key: 0,
+        ref_key: "ask",
+        ref: k,
+        title: m.value.title,
+        message: m.value.message,
+        "confirm-label": m.value.confirmLabel,
+        tone: m.value.tone,
+        action: T,
+        onDismissed: d[2] || (d[2] = (_) => void e.command.answer?.(!1))
+      }, null, 8, ["title", "message", "confirm-label", "tone"])) : h("", !0)
+    ], 64));
+  }
+});
+function oe(t) {
+  const r = P(t), e = b(!1), n = () => typeof t.defaults == "function" ? t.defaults() : t.defaults, i = b(null);
+  async function l() {
+    return await r.submit(t.run, {
+      // The page updating itself after the call is the refresh: its failure is "saved, but could not be read back".
+      refresh: t.done ? (u) => t.done?.(u) : void 0
+    });
+  }
+  async function o() {
+    const a = t.ask ? r.validate() : null, u = a === null ? null : t.ask?.(a) ?? null;
+    return u ? (i.value = u, { status: "aborted" }) : l();
+  }
+  return {
+    form: r,
+    open: e,
+    present(a) {
+      r.hydrate({ ...n(), ...a }), e.value = !0;
+    },
+    dismiss() {
+      e.value = !1;
+    },
+    run: o,
+    question: i,
+    async answer(a) {
+      return i.value = null, a ? l() : { status: "aborted" };
+    },
+    async confirm() {
+      const a = await l();
+      if (a.status === "failed") throw new Error(a.failure.message);
+      if (a.status === "aborted") throw new Error("aborted");
+    }
+  };
+}
+export {
+  ne as _,
+  se as a,
+  Y as f,
+  oe as u
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wssto2/vue-core",
-  "version": "0.4.20",
+  "version": "0.4.21",
   "goCore": "v1.7.0",
   "description": "Shared Vue 3 library for go-core applications: app shell, list / record / form pages and their controls.",
   "keywords": [

package/dist/useCommand-YN9EMb7s.js

@@ -1,138 +0,0 @@
-import { nextTick as f, defineComponent as L, useTemplateRef as p, ref as w, watch as D, onBeforeUnmount as S, computed as x, openBlock as v, createBlock as E, unref as c, createSlots as T, withCtx as y, createElementVNode as $, createElementBlock as B, toDisplayString as C, createCommentVNode as N, createVNode as z, renderSlot as g } from "vue";
-import { useI18n as V } from "vue-i18n";
-import { f as q } from "./useDialog-CXR3hN0G.js";
-import { _ as A } from "./Modal.vue_vue_type_script_setup_true_lang-DpBb8ans.js";
-import { D as F } from "./useWaitStatus-fsacMl4W.js";
-import { _ as O, u as I } from "./FormErrors.vue_vue_type_script_setup_true_lang-DWcVKZM3.js";
-import { a as R } from "./leaveGuard-Cc8yeLxM.js";
-const d = "input:not([type=hidden]):not([disabled]), textarea:not([disabled]), select:not([disabled]), button:not([disabled]), [tabindex]:not([tabindex='-1'])";
-async function U(t = document, n) {
-  const e = [...t.querySelectorAll("[data-field-error]")], o = e.find((s) => s.matches(d) || s.querySelector(d)) ?? e[0];
-  if (!o) return !1;
-  const r = n?.sections.value.find((s) => s.element.contains(o));
-  r && (await n?.scrollTo(r.id, { updateUrl: !1 }), await f());
-  const a = o.matches(d) ? o : o.querySelector(d);
-  return (a ?? o).scrollIntoView?.({ block: "center" }), (a ?? o).focus({ preventScroll: !0 }), !0;
-}
-const Q = (t) => ({ "data-field-key": t }), G = {
-  key: 0,
-  class: "text-body text-content-muted"
-}, X = /* @__PURE__ */ L({
-  __name: "CommandDialog",
-  props: {
-    command: {},
-    title: {},
-    subtitle: { default: void 0 },
-    confirmLabel: {},
-    confirmDisabled: { type: Boolean, default: !1 },
-    doneLabel: { default: void 0 },
-    busyLabel: { default: void 0 },
-    message: { default: void 0 },
-    size: { default: "sm" },
-    fieldLabel: { type: Function, default: void 0 }
-  },
-  emits: ["done"],
-  setup(t, { emit: n }) {
-    const e = t, o = n, { t: r } = V(), a = p("modal"), s = p("body"), u = w(!1);
-    let m = null;
-    const { confirmDiscard: _ } = R(() => e.command.open.value && e.command.form.dirty.value);
-    D(() => e.command.open.value, (l) => {
-      l ? (u.value = !1, a.value?.present()) : a.value?.dismiss();
-    });
-    async function b(l = {}) {
-      if (e.confirmDisabled) return;
-      const i = await e.command.run();
-      if (i.status === "failed") {
-        i.failure.kind === "invalid" && await f().then(() => U(s.value ?? document));
-        return;
-      }
-      if (i.status !== "aborted") {
-        if (o("done"), l.addAnother) {
-          e.command.present(), await f(), q(s.value)[0]?.focus();
-          return;
-        }
-        u.value = !0, m = setTimeout(() => e.command.dismiss(), F);
-      }
-    }
-    S(() => {
-      m && clearTimeout(m);
-    });
-    const k = x(() => e.command.form.submitting.value ? "processing" : u.value ? "done" : "idle");
-    return (l, i) => (v(), E(A, {
-      ref_key: "modal",
-      ref: a,
-      size: e.size,
-      grouped: "",
-      title: e.title,
-      subtitle: e.subtitle,
-      "before-dismiss": c(_),
-      "primary-label": e.confirmLabel,
-      "primary-disabled": e.confirmDisabled,
-      status: k.value,
-      "processing-label": e.busyLabel ?? c(r)("core.actions.saving"),
-      "done-label": e.doneLabel ?? c(r)("core.actions.saved"),
-      onPrimary: i[0] || (i[0] = (h) => b()),
-      onDismissed: i[1] || (i[1] = (h) => e.command.dismiss())
-    }, T({
-      default: y(() => [
-        $("div", {
-          ref_key: "body",
-          ref: s,
-          class: "flex min-w-0 flex-col gap-group-gap",
-          "data-test": "command-dialog"
-        }, [
-          e.message ? (v(), B("p", G, C(e.message), 1)) : N("", !0),
-          z(O, {
-            form: e.command.form,
-            label: e.fieldLabel,
-            scope: s.value
-          }, null, 8, ["form", "label", "scope"]),
-          g(l.$slots, "default")
-        ], 512)
-      ]),
-      _: 2
-    }, [
-      l.$slots.actions ? {
-        name: "actions",
-        fn: y(() => [
-          g(l.$slots, "actions", {
-            run: b,
-            busy: e.command.form.submitting.value
-          })
-        ]),
-        key: "0"
-      } : void 0
-    ]), 1032, ["size", "title", "subtitle", "before-dismiss", "primary-label", "primary-disabled", "status", "processing-label", "done-label"]));
-  }
-});
-function Y(t) {
-  const n = I(t), e = w(!1), o = () => typeof t.defaults == "function" ? t.defaults() : t.defaults;
-  async function r() {
-    return await n.submit(t.run, {
-      // The page updating itself after the call is the refresh: its failure is "saved, but could not be read back".
-      refresh: t.done ? (s) => t.done?.(s) : void 0
-    });
-  }
-  return {
-    form: n,
-    open: e,
-    present(a) {
-      n.hydrate({ ...o(), ...a }), e.value = !0;
-    },
-    dismiss() {
-      e.value = !1;
-    },
-    run: r,
-    async confirm() {
-      const a = await r();
-      if (a.status === "failed") throw new Error(a.failure.message);
-      if (a.status === "aborted") throw new Error("aborted");
-    }
-  };
-}
-export {
-  X as _,
-  Q as a,
-  U as f,
-  Y as u
-};