@quidgest/ui 0.20.0 → 0.21.0

package/esm/composables/useDialog/index.d.ts

@@ -1,8 +1,16 @@
-import { UseDialogReturn } from './types.ts';
+import { UseDialogReturn } from './types';
+export type { DialogItem, UseDialogReturn } from './types';
 /**
- * Manager for dialog models
+ * Manages programmatic dialogs for the current app (`createFramework`).
  *
- * @returns Dialog state and functions
+ * Mount exactly one `QDialogProvider` in the app (typically next to the
+ * root layout). Every provider renders the same shared list.
+ *
+ * @returns An object containing:
+ * - dialogs: The array of currently active QDialog instances.
+ * - addDialog: A function that adds a QDialog instance according to the given props.
+ * - removeDialog: A function to remove a QDialog instance.
+ * - cancelDialog: A function to cancel a not-yet-registered dialog by `props.id`.
  */
 export declare function useDialog(): UseDialogReturn;
 //# sourceMappingURL=index.d.ts.map

package/esm/composables/useDialog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useDialog/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAA;AAQjE;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAyD3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useDialog/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAW9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE1D;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,IAAI,eAAe,CA6F3C"}

package/esm/composables/useDialog/index.js

@@ -1,29 +1,45 @@
-import { useId as e } from "../uid.js";
-import { ref as t } from "vue";
+import { cancelDialogByPropsId as e, hasDialogWithId as t, injectDialogInstance as n, removeDialogEntry as r } from "./_internal.js";
+import { computed as i } from "vue";
 //#region src/composables/useDialog/index.ts
-var n = t([]);
-function r() {
-	function t(t, r, i, a) {
-		let o = e(r).value;
-		return n.value.push({
-			id: o,
-			props: {
-				...t,
-				modelValue: !0
-			},
-			options: i,
-			handlers: a
-		}), a?.onEnter && a.onEnter(), o;
+function a() {
+	let a = n(), { dialogs: o, nextEntryKey: s, pendingByKey: c, hasProvider: l } = a, u = i(() => o.value.map(({ id: e, props: t, options: n, handlers: r }) => ({
+		id: e,
+		props: t,
+		options: n,
+		handlers: r
+	})));
+	function d(e, n, r) {
+		return l() ? e.id !== void 0 && t(a, e.id) ? Promise.reject(/* @__PURE__ */ Error(`addDialog(): a dialog with id "${e.id}" already exists.`)) : new Promise((t, i) => {
+			let a = s();
+			c.set(a, {
+				resolve: t,
+				reject: i,
+				settled: !1
+			}), o.value.push({
+				entryKey: a,
+				props: {
+					...e,
+					modelValue: !0
+				},
+				options: n,
+				handlers: r
+			});
+		}) : Promise.reject(/* @__PURE__ */ Error("addDialog() requires a mounted QDialogProvider before it can be called."));
 	}
-	function r(e) {
-		let t = n.value.findIndex((t) => t.id === e);
-		t !== -1 && (n.value[t]?.handlers?.onLeave?.() ?? !0) && n.value.splice(t, 1);
+	function f(e) {
+		let t = o.value.findIndex((t) => t.id === e);
+		if (t === -1) throw Error(`removeDialog(): no mounted dialog found with id "${e}".`);
+		r(a, t);
+	}
+	function p(t) {
+		e(a, t);
 	}
 	return {
-		dialogs: n,
-		addDialog: t,
-		removeDialog: r
+		dialogs: u,
+		addDialog: d,
+		removeDialog: f,
+		cancelDialog: p
 	};
 }
 //#endregion
-export { r as useDialog };
+export { a as useDialog };

package/esm/composables/useDialog/types.d.ts

@@ -1,13 +1,16 @@
-import { Ref } from 'vue';
-import { QDialogProps, QDialogOptions, QDialogHandlers } from '../../components/QDialog/types.ts';
+import { ComputedRef } from 'vue';
+import { QDialogProps, QDialogOptions, QDialogHandlers } from '../../components/QDialog/types';
 /**
- * Represents an instance of a dialog component.
+ * Public view of a dialog managed by {@link useDialog}.
+ *
+ * `id` is set when the dialog registers during setup. Prefer `await addDialog(...)` to
+ * obtain the id rather than reading it from this list before the promise resolves.
  */
-export type DialogInstance = {
+export type DialogItem = {
     /**
-     * A unique identifier for the dialog instance.
+     * Unique identifier for the dialog instance, set when the dialog registers during setup.
      */
-    id: string;
+    id?: string;
     /**
      * The properties applied to the dialog, conforming to `QDialogProps`.
      */
@@ -27,16 +30,27 @@ export type DialogInstance = {
  */
 export type UseDialogReturn = {
     /**
-     * A Vue Ref containing the list of currently active dialog instances.
+     * Currently active dialogs (public fields only: `id`, `props`, `options`, `handlers`).
+     * Read-only: mutating this array does not change the dialog store — use `removeDialog`.
+     * `id` is undefined until the dialog registers during setup; use the `addDialog` promise for the id.
      */
-    dialogs: Ref<DialogInstance[]>;
+    dialogs: ComputedRef<DialogItem[]>;
     /**
-     * Adds a new dialog to the state with the specified properties and an optional custom ID.
+     * Adds a new dialog to the state with the specified properties.
+     * Requires a mounted QDialogProvider (exactly one per app); rejects immediately when none is present.
+     * Rejects when `props.id` is already used by an active dialog.
+     * Resolves with the dialog id once the component registers it during setup.
      */
-    addDialog(props: QDialogProps, id?: string, options?: QDialogOptions, handlers?: QDialogHandlers): string;
+    addDialog(props: QDialogProps, options?: QDialogOptions, handlers?: QDialogHandlers): Promise<string>;
     /**
-     * Removes a dialog from the state by its unique identifier.
+     * Removes a mounted dialog by id.
+     * Throws when no mounted dialog with that id exists.
      */
     removeDialog(id: string): void;
+    /**
+     * Cancels a dialog that has not registered yet.
+     * Matches `props.id` from `addDialog`. No-op when no matching entry exists.
+     */
+    cancelDialog(id: string): void;
 };
 //# sourceMappingURL=types.d.ts.map

package/esm/composables/useDialog/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/composables/useDialog/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC9B,OAAO,KAAK,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,MAAM,mCAAmC,CAAA;AAE1C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,KAAK,EAAE,YAAY,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAA;IAE9B;;OAEG;IACH,SAAS,CACR,KAAK,EAAE,YAAY,EACnB,EAAE,CAAC,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE,eAAe,GACxB,MAAM,CAAA;IAET;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/composables/useDialog/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAO,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AA+EnG;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX;;OAEG;IACH,KAAK,EAAE,YAAY,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B,CAAA;AAeD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;OAIG;IACH,OAAO,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAA;IAElC;;;;;OAKG;IACH,SAAS,CACR,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAAA;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA"}

package/esm/composables/useDismissibleLayerStack/index.d.ts

@@ -1,12 +1,27 @@
-import { Ref } from 'vue';
+import { MaybeRefOrGetter, Ref } from 'vue';
 export type DismissibleLayerStack = {
+    /** Registered layer ids, from bottom (first) to top (last). */
     layers: Ref<string[]>;
     register(id: string): void;
     unregister(id: string): void;
+    update(oldId: string, newId: string): void;
     isTop(id: string): boolean;
 };
+/**
+ * App-wide stack of dismissible layers (overlays, popovers, and similar).
+ *
+ * The last registered id is the top layer. Escape and outside-interact
+ * handling should only run for that layer.
+ *
+ * @returns The reactive layer list and helpers to register, unregister, and update ids.
+ */
 export declare function useDismissibleLayerStack(): DismissibleLayerStack;
-export declare function useDismissibleLayerStackItem(id: string): {
+/**
+ * Stack item helpers that keep the registered id in sync when the override changes.
+ *
+ * @param id - Layer id (plain string, ref, or getter).
+ */
+export declare function useDismissibleLayerStackItem(id: MaybeRefOrGetter<string>): {
     register: () => void;
     unregister: () => void;
     isTop: () => boolean;

package/esm/composables/useDismissibleLayerStack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useDismissibleLayerStack/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAK9B,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B,CAAA;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAmBhE;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM;;;;EActD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useDismissibleLayerStack/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAmB,MAAM,KAAK,CAAA;AAKjE,MAAM,MAAM,qBAAqB,GAAG;IACnC,+DAA+D;IAC/D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAsDhE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC;;;;EA0CxE"}

package/esm/composables/useDismissibleLayerStack/index.js

@@ -1,7 +1,7 @@
 import { DismissibleLayerKey as e } from "../../symbols/dismissibleLayer.js";
-import { inject as t, ref as n } from "vue";
+import { inject as t, ref as n, toValue as r, watch as i } from "vue";
 //#region src/composables/useDismissibleLayerStack/index.ts
-function r() {
+function a() {
 	let e = n([]);
 	function t(t) {
 		e.value.push(t);
@@ -10,24 +10,41 @@ function r() {
 		let n = e.value.indexOf(t);
 		n !== -1 && e.value.splice(n, 1);
 	}
-	function i(t) {
+	function i(t, n) {
+		if (t === n) return;
+		let r = e.value.indexOf(t);
+		if (r === -1) return;
+		let i = [...e.value];
+		i[r] = n, e.value = i;
+	}
+	function a(t) {
 		return e.value[e.value.length - 1] === t;
 	}
 	return {
 		layers: e,
 		register: t,
 		unregister: r,
-		isTop: i
+		update: i,
+		isTop: a
 	};
 }
-function i(n) {
-	let r = t(e);
-	if (!r) throw Error("useDismissibleLayerStackItem must be used within a dismissible layer stack context.");
+function o(n) {
+	let a = t(e);
+	if (!a) throw Error("useDismissibleLayerStackItem must be used within a dismissible layer stack context.");
+	let o = a, s, c;
+	function l() {
+		s = r(n), o.register(s), c?.(), c = i(() => r(n), (e, t) => {
+			!t || e === t || (o.update(t, e), s = e);
+		});
+	}
+	function u() {
+		c?.(), c = void 0, s !== void 0 && (o.unregister(s), s = void 0);
+	}
 	return {
-		register: () => r.register(n),
-		unregister: () => r.unregister(n),
-		isTop: () => r.isTop(n)
+		register: l,
+		unregister: u,
+		isTop: () => o.isTop(r(n))
 	};
 }
 //#endregion
-export { r as useDismissibleLayerStack, i as useDismissibleLayerStackItem };
+export { a as useDismissibleLayerStack, o as useDismissibleLayerStackItem };

package/esm/composables/useGroup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useGroup/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAKnE,qDAAqD;AACrD,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAyB,CAAA;AAE9E,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAA;AAEpC;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC;IACvB;;;;OAIG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAEtB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAA;IAElB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CA2C5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,SAAS,CAyC/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useGroup/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAKnE,qDAAqD;AACrD,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAyB,CAAA;AAE9E,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAA;AAEpC;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC;IACvB;;;;OAIG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAEtB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAA;IAElB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CA2C5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,SAAS,CA+D/E"}

package/esm/composables/useGroup/index.js

@@ -20,7 +20,18 @@ function l(n) {
 		let e = a(n);
 		return Array.isArray(r.active.value) ? r.active.value?.includes(e) : r.active.value === e;
 	});
-	return {
+	return o(() => a(n), (e, t) => {
+		if (!(t === void 0 || e === t)) {
+			if (Array.isArray(r.active.value)) {
+				let n = r.active.value.indexOf(t);
+				if (n === -1) return;
+				let i = [...r.active.value];
+				i[n] = e, r.active.value = i;
+				return;
+			}
+			r.active.value === t && (r.active.value = e);
+		}
+	}), {
 		isActive: i,
 		toggle: () => {
 			let e = a(n);

package/esm/composables/useId/index.d.ts

@@ -0,0 +1,18 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+/**
+ * Generates a unique ID for the current component instance, with optional override.
+ *
+ * Must be called synchronously during `setup`. The returned ID tracks changes to the
+ * optional override (for example a reactive `props.id`).
+ *
+ * Vue's `useId()` prefixes with `app.config.idPrefix` (default `v`) plus `-`.
+ * The Vue prefix is rewritten to `q-` by default (`q-0`). When the host sets a custom
+ * `idPrefix` (for example `my-app`), it is kept after `q-` (`q-my-app-0`) so nested
+ * apps on the same page do not collide.
+ *
+ * @param [componentId] - Optional component-specific ID.
+ * @returns A computed ref containing the resolved ID.
+ * @throws When called outside component setup.
+ */
+export declare function useId(componentId?: MaybeRefOrGetter<string | undefined>): ComputedRef<string>;
+//# sourceMappingURL=index.d.ts.map

package/esm/composables/useId/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useId/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAKxD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAgB7F"}

package/esm/composables/useId/index.js

@@ -0,0 +1,10 @@
+import { computed as e, getCurrentInstance as t, toValue as n, useId as r } from "vue";
+//#region src/composables/useId/index.ts
+function i(i) {
+	let a = r();
+	if (!a) throw Error("useId() must be called synchronously during component setup.");
+	let o = t()?.appContext.config.idPrefix || "v", s = `${o}-`, c = a.startsWith(s) ? a.slice(s.length) : a, l = o === "v" ? `q-${c}` : `q-${o}-${c}`;
+	return e(() => n(i) ?? l);
+}
+//#endregion
+export { i as useId };

package/esm/composables/useToast/_internal.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=_internal.d.ts.map

package/esm/composables/useToast/_internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_internal.d.ts","sourceRoot":"","sources":["../../../src/composables/useToast/_internal.ts"],"names":[],"mappings":""}

package/esm/composables/useToast/_internal.js

@@ -0,0 +1,142 @@
+import { inject as e, ref as t } from "vue";
+//#region src/composables/useToast/_internal.ts
+var n = Symbol.for("q-toast");
+function r(e, t, n) {
+	let r = e.get(t);
+	if (!r || r.settled) {
+		e.delete(t);
+		return;
+	}
+	r.reject(n), e.delete(t);
+}
+function i(e, t) {
+	for (let [, n] of e) n.settled || n.reject(t);
+	e.clear();
+}
+function a(e, t) {
+	let n = e.toasts.value[t];
+	n && (r(e.pendingByKey, n.entryKey, /* @__PURE__ */ Error("Toast removed before it was ready")), e.toasts.value.splice(t, 1), e.flushQueue());
+}
+function o(e, t) {
+	let n = e.toasts.value.findIndex((e) => e.id === t);
+	if (n !== -1) {
+		a(e, n);
+		return;
+	}
+	let i = e.queue.value.findIndex((e) => e.id === t);
+	if (i === -1) throw Error(`removeToast(): no toast found with id "${t}".`);
+	let o = e.queue.value[i];
+	r(e.pendingByKey, o.entryKey, /* @__PURE__ */ Error("Toast removed before it was ready")), e.queue.value.splice(i, 1);
+}
+function s(e, t) {
+	let n = e.toasts.value.findIndex((e) => e.entryKey === t);
+	if (n !== -1) {
+		a(e, n);
+		return;
+	}
+	let i = e.queue.value.findIndex((e) => e.entryKey === t);
+	i !== -1 && (r(e.pendingByKey, t, /* @__PURE__ */ Error("Toast removed before it was ready")), e.queue.value.splice(i, 1));
+}
+function c(e, t) {
+	let n = (e) => e.id === t || e.props.id === t;
+	return e.toasts.value.some(n) || e.queue.value.some(n);
+}
+function l(e, t) {
+	let n = e.queue.value.findIndex((e) => e.props.id === t);
+	if (n !== -1) {
+		let t = e.queue.value[n];
+		r(e.pendingByKey, t.entryKey, /* @__PURE__ */ Error("Toast canceled")), e.queue.value.splice(n, 1);
+		return;
+	}
+	let i = e.toasts.value.findIndex((e) => e.props.id === t && e.id === void 0);
+	if (i === -1) return;
+	let a = e.toasts.value[i];
+	r(e.pendingByKey, a.entryKey, /* @__PURE__ */ Error("Toast canceled")), e.toasts.value.splice(i, 1), e.flushQueue();
+}
+function u() {
+	let e = t([]), n = t([]), r = /* @__PURE__ */ new Map(), a, o = 0, s = 0;
+	function c() {
+		return a === void 0 || e.value.length < a;
+	}
+	function l() {
+		for (; n.value.length > 0 && c();) {
+			let t = n.value.shift();
+			t && e.value.push(t);
+		}
+	}
+	function u(t) {
+		if (a = t, typeof t == "number") for (; e.value.length > t;) {
+			let t = e.value.pop();
+			if (!t) break;
+			t.id && t.props.id !== t.id && (t.props = {
+				...t.props,
+				id: t.id
+			}), n.value.unshift(t);
+		}
+		l();
+	}
+	function d(t) {
+		if (c()) {
+			e.value.push(t);
+			return;
+		}
+		n.value.push(t);
+	}
+	function f(t, n) {
+		let i = e.value.find((e) => e.entryKey === t);
+		if (!i) return;
+		i.id = n;
+		let a = r.get(t);
+		!a || a.settled || (a.settled = !0, a.resolve(n), r.delete(t));
+	}
+	function p(t, n) {
+		let r = e.value.find((e) => e.entryKey === t);
+		!r || r.id === n || (r.id = n);
+	}
+	function m(t, r) {
+		let i = e.value.find((e) => e.entryKey === t) ?? n.value.find((e) => e.entryKey === t);
+		i && (i.remainingTimeout = r);
+	}
+	function h(t) {
+		let r = e.value.find((e) => e.entryKey === t) ?? n.value.find((e) => e.entryKey === t);
+		if (!r || r.remainingTimeout === void 0) return;
+		let i = r.remainingTimeout;
+		return delete r.remainingTimeout, i;
+	}
+	function g() {
+		return `toast-${++o}`;
+	}
+	function _() {
+		return s > 0;
+	}
+	function v() {
+		if (s > 0) throw Error("Only one QToaster may be mounted per app.");
+		s++;
+	}
+	function y() {
+		s = Math.max(0, s - 1), !(s > 0) && (i(r, /* @__PURE__ */ Error("QToaster unmounted before the toast was ready")), e.value = [], n.value = []);
+	}
+	return {
+		toasts: e,
+		queue: n,
+		pendingByKey: r,
+		setMaxToasts: u,
+		enqueue: d,
+		flushQueue: l,
+		registerToastEntry: f,
+		updateToastEntryId: p,
+		setRemainingTimeout: m,
+		consumeRemainingTimeout: h,
+		nextEntryKey: g,
+		hasToaster: _,
+		registerToaster: v,
+		unregisterToaster: y
+	};
+}
+function d() {
+	let t = e(n);
+	if (!t) throw Error("useToast() requires a provided toast instance (e.g. via createFramework)");
+	return t;
+}
+//#endregion
+export { n as ToastSymbol, l as cancelToastByPropsId, u as createToastInstance, c as hasToastWithId, d as injectToastInstance, s as removeToastByEntryKey, o as removeToastById, a as removeToastEntry };

package/esm/composables/useToast/index.d.ts

@@ -1,33 +1,16 @@
-import { ToastInstance, UseToastReturn } from './types.ts';
+import { UseToastReturn } from './types';
+export type { ToastItem, UseToastReturn } from './types';
 /**
- * A composable function that manages existing QToast instances.
+ * Manages programmatic toasts for the current app (`createFramework`).
+ *
+ * Mount exactly one `QToaster` in the app (typically next to the root
+ * layout). Every toaster renders the same shared list.
  *
  * @returns An object containing:
- * - toasts: The array of currently active QToast instances.
+ * - toasts: The array of currently mounted QToast instances.
  * - addToast: A function that adds a QToast instance to the DOM, according to the given QToastProps.
  * - removeToast: A function to remove a QToast instance from the DOM.
+ * - cancelToast: A function to cancel a queued or not-yet-registered toast by `props.id`.
  */
 export declare function useToast(): UseToastReturn;
-/**
- * Creates a new toast instance for managing toast notifications.
- *
- * @returns An object containing a reactive array of toast items.
- */
-export declare function createToastInstance(): ToastInstance;
-/**
- * Provides a toast notification instance to the current Vue component context.
- *
- * @returns The provided toast instance for managing toast notifications.
- *
- * @see createToastInstance
- * @see ToastSymbol
- */
-export declare function provideToast(): ToastInstance;
-/**
- * Injects the ToastInstance provided by the ToastSymbol.
- *
- * @throws If the ToastInstance has not been provided via provideToast.
- * @returns The injected ToastInstance.
- */
-export declare function injectToastInstance(): ToastInstance;
 //# sourceMappingURL=index.d.ts.map

package/esm/composables/useToast/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useToast/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,aAAa,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAMjG;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAoCzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAInD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAI5C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAMnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/useToast/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAW7C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAsFzC"}

package/esm/composables/useToast/index.js

@@ -1,33 +1,36 @@
-import { useId as e } from "../uid.js";
-import { ToastSymbol as t } from "./types.js";
-import { inject as n, ref as r } from "vue";
+import { cancelToastByPropsId as e, hasToastWithId as t, injectToastInstance as n, removeToastById as r } from "./_internal.js";
+import { computed as i } from "vue";
 //#region src/composables/useToast/index.ts
-function i() {
-	let { toasts: t } = o();
-	function n(n, r) {
-		let i = e(r).value;
-		return t.value.push({
-			id: i,
-			props: n
-		}), i;
+function a() {
+	let a = n(), { toasts: o, nextEntryKey: s, enqueue: c, pendingByKey: l, hasToaster: u } = a, d = i(() => o.value.map(({ id: e, props: t }) => ({
+		id: e,
+		props: t
+	})));
+	function f(e) {
+		return u() ? e.id !== void 0 && t(a, e.id) ? Promise.reject(/* @__PURE__ */ Error(`addToast(): a toast with id "${e.id}" already exists.`)) : new Promise((t, n) => {
+			let r = s();
+			l.set(r, {
+				resolve: t,
+				reject: n,
+				settled: !1
+			}), c({
+				entryKey: r,
+				props: e
+			});
+		}) : Promise.reject(/* @__PURE__ */ Error("addToast() requires a mounted QToaster before it can be called."));
+	}
+	function p(e) {
+		r(a, e);
 	}
-	function r(e) {
-		let n = t.value.findIndex((t) => t.id === e);
-		n !== -1 && t.value.splice(n, 1);
+	function m(t) {
+		e(a, t);
 	}
 	return {
-		toasts: t,
-		addToast: n,
-		removeToast: r
+		toasts: d,
+		addToast: f,
+		removeToast: p,
+		cancelToast: m
 	};
 }
-function a() {
-	return { toasts: r([]) };
-}
-function o() {
-	let e = n(t);
-	if (!e) throw Error("useInjectedToast must be used after provideToast");
-	return e;
-}
 //#endregion
-export { a as createToastInstance, o as injectToastInstance, i as useToast };
+export { a as useToast };

package/esm/composables/useToast/types.d.ts

@@ -1,23 +1,15 @@
-import { InjectionKey, Ref } from 'vue';
+import { ComputedRef } from 'vue';
 import { QToastProps } from '../../components/QToast';
-export declare const ToastSymbol: InjectionKey<ToastInstance>;
 /**
- * Represents an instance of the toast notification system.
- */
-export type ToastInstance = {
-    /**
-     * A Vue Ref containing the list of active toast notifications.
-     */
-    toasts: Ref<ToastItem[]>;
-};
-/**
- * Represents a single toast item managed in the toasts state array.
+ * Public view of a mounted toast.
+ *
+ * `id` is set when the toast registers during setup. Prefer `await addToast(...)` to obtain the id.
  */
 export type ToastItem = {
     /**
-     * A unique identifier for the toast item.
+     * Unique identifier for the toast item, set when the toast registers during setup.
      */
-    id: string;
+    id?: string;
     /**
      * The properties applied to the toast item, conforming to `QToastProps`.
      */
@@ -27,14 +19,36 @@ export type ToastItem = {
  * Represents the return type of the `useToast` composable, providing methods and state
  * for managing toast notifications.
  */
-export type UseToastReturn = ToastInstance & {
+export type UseToastReturn = {
+    /**
+     * Currently mounted toasts (public fields only: `id`, `props`).
+     * Read-only: mutating this array does not change the toast store — use `removeToast`.
+     * `id` is undefined until the toast registers during setup; use the `addToast` promise for the id.
+     */
+    toasts: ComputedRef<ToastItem[]>;
     /**
      * A function to add a toast item to the DOM.
+     * Requires a mounted QToaster (exactly one per app); rejects immediately when none is present.
+     * Rejects when `props.id` is already used by a mounted or queued toast.
+     * Resolves with the toast id once the component registers it during setup.
+     * When `maxToasts` is set and the stack is full, the toast waits in a queue and the
+     * promise stays pending until a slot opens and the toast registers during setup.
      */
-    addToast(props: QToastProps, id?: string): string;
+    addToast(props: QToastProps): Promise<string>;
     /**
-     * A function to remove a toast item from the DOM.
+     * Removes a toast that has already registered its public id — mounted or demoted
+     * into the queue. Throws when no toast with that registered id exists.
+     * For never-mounted queue entries or not-yet-registered mounts, use `cancelToast`
+     * with `props.id`. Demoted toasts accept either API.
      */
     removeToast(id: string): void;
+    /**
+     * Cancels a never-mounted queue entry, a demoted queue entry, or a mount that has
+     * not registered yet. Matches `props.id` from `addToast` (demotion copies the
+     * registered id onto `props.id`). No-op when no matching entry exists.
+     * For registered mounted toasts, use `removeToast`. Rejects an unsettled
+     * `addToast` promise with "Toast canceled".
+     */
+    cancelToast(id: string): void;
 };
 //# sourceMappingURL=types.d.ts.map