@antcde/vue-utils 0.2.14-rc.6346d95 → 0.2.14-rc.6a3e1ae

package/dist/index.js

@@ -3,8 +3,62 @@ import { computed as s, inject as c, onBeforeUnmount as l, onMounted as u, onUnm
 import { useI18n as g } from "vue-i18n";
 import { newCommsClient as _, newCommsHost as v } from "@antcde/connect-ts";
 import { BehaviorSubject as y, Subject as b, concat as x, concatMap as S, debounceTime as C, distinctUntilChanged as w, filter as T, map as E } from "rxjs";
+//#region src/formatDate.ts
+var D = "nl", O = {
+	short: {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric"
+	},
+	medium: {
+		day: "numeric",
+		month: "short",
+		year: "numeric"
+	},
+	long: {
+		day: "numeric",
+		month: "long",
+		year: "numeric"
+	},
+	monthDay: {
+		day: "numeric",
+		month: "short"
+	},
+	shortDateTime: {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric",
+		hour: "2-digit",
+		minute: "2-digit",
+		hour12: !1
+	},
+	mediumDateTime: {
+		day: "numeric",
+		month: "short",
+		year: "numeric",
+		hour: "2-digit",
+		minute: "2-digit",
+		hour12: !1
+	}
+}, k = new Set(["short", "shortDateTime"]);
+function A(e) {
+	return e instanceof Date ? e : new Date(e);
+}
+function j(e) {
+	return `${e.getFullYear()}-${String(e.getMonth() + 1).padStart(2, "0")}-${String(e.getDate()).padStart(2, "0")}`;
+}
+function M(e, t = {}) {
+	let { preset: n = "short", locale: r = D, fallback: i = "" } = t;
+	if (e == null || e === "") return i;
+	let a = A(e);
+	if (Number.isNaN(a.getTime())) return i;
+	if (n === "iso") return j(a);
+	let o = k.has(n) && /^en\b/i.test(r) ? D : r;
+	return new Intl.DateTimeFormat(o, O[n]).format(a);
+}
+//#endregion
 //#region src/useAntColorMode.ts
-function D(e, n) {
+function N(e, n) {
 	let i = r(n), a = s(() => e.context.value.darkMode), o = s(() => {
 		switch (a.value) {
 			case null: return "auto";
@@ -30,13 +84,36 @@ function D(e, n) {
 }
 //#endregion
 //#region src/useAntI18n.ts
-function O(e, t) {
+function P(e, t) {
 	let n = g(t);
 	return h(() => e.context.value.user?.language, (e) => n.locale.value = e ?? "en", { immediate: !0 }), n;
 }
 //#endregion
+//#region src/useAppTourMode.ts
+var F = p(!1), I = p(null);
+function L() {
+	function e(e) {
+		h(() => e.value.tourMode, (e) => {
+			F.value = !!e, e || (I.value = null);
+		}, { immediate: !0 });
+	}
+	function t(e) {
+		F.value && (I.value = e);
+	}
+	function n() {
+		F.value = !1, I.value = null;
+	}
+	return {
+		isActive: f(F),
+		activeZoneId: f(I),
+		connectContext: e,
+		setActiveZone: t,
+		exit: n
+	};
+}
+//#endregion
 //#region src/useCommsClient.ts
-function k(t, n, r) {
+function R(t, n, r) {
 	let i = p({}), a = _({
 		parent: window.parent,
 		connect: t,
@@ -45,17 +122,17 @@ function k(t, n, r) {
 		get: () => o.value,
 		set: (e) => a.appState.set(e)
 	});
-	return a.context.subscribe((e) => i.value = e), x(a.appState.get(), a.appState).subscribe((e) => o.value = e), j(a.signal, a, n), l(() => a.unsubscribe()), Object.assign(e(a, [
+	return a.context.subscribe((e) => i.value = e), x(a.appState.get(), a.appState).subscribe((e) => o.value = e), B(a.signal, a, n), l(() => a.unsubscribe()), Object.assign(e(a, [
 		"context",
 		"toolbar",
 		"appState"
 	]), {
 		context: i,
-		toolbar: A(a),
+		toolbar: z(a),
 		appState: c
 	});
 }
-function A(e) {
+function z(e) {
 	let t = p(""), n = {
 		title: s({
 			get: () => e.toolbar.get().title,
@@ -108,13 +185,13 @@ function A(e) {
 	};
 	return e.toolbar.pipe(E((e) => e.search.input ?? ""), w(), C(300)).forEach((e) => t.value = e), n;
 }
-function j(e, t, n) {
+function B(e, t, n) {
 	let r = i(), a = r.ctrl ?? s(() => !1), c = r.shift ?? s(() => !1), l = new b(), u = l.pipe(S(n ?? ((e) => Promise.resolve(e))), S((t) => e(t))).subscribe();
 	return t.add(u), u.add(o(a, () => l.next({ hotkeys: { ctrl: !0 } }))), u.add(o(c, () => l.next({ hotkeys: { shift: !0 } }))), u;
 }
 //#endregion
 //#region src/useCommsHost.ts
-function M(e) {
+function V(e) {
 	let { context: t } = e, n = new y({}), r = (e) => n.next(e(n.value)), i = p(), o = new y(void 0), c = h(i, (e) => o.next(e), { immediate: !0 }), l = o.asObservable().pipe(E((e) => e?.contentWindow), T((e) => !!e)), u = v({
 		...e,
 		contextChanges: n,
@@ -155,7 +232,7 @@ function M(e) {
 }
 //#endregion
 //#region src/usePermissions.ts
-function N(e) {
+function H(e) {
 	let t = s(() => e.value?.user), n = s(() => e.value?.license), r = s(() => e.value?.project), i = s(() => !!t.value?.is_admin), a = s(() => !!n.value?.user_is_admin), o = s(() => !!r.value?.user_is_admin || a.value);
 	function c(e) {
 		return !t.value || !n.value ? !1 : i.value || a.value ? !0 : (n.value.user_roles ?? []).some((t) => t.name === e);
@@ -181,7 +258,7 @@ function N(e) {
 }
 //#endregion
 //#region src/useTemplateVersioning.ts
-function P(e) {
+function U(e) {
 	let t = m(null), n = m(null), r = m(null), i = m(null), a = m([]), o = m(null), c = p(!1), l = p(!1), u = p(!1), d = p(!1), f = p(!1), h = p(!1), g = s(() => t.value?.has_update ?? !1), _ = s(() => t.value?.current_version ?? null), v = s(() => t.value?.latest_version ?? null), y = s(() => n.value ? n.value.added.length + n.value.removed.length + n.value.modified.length + n.value.relations_added.length + n.value.relations_removed.length : 0);
 	async function b(n) {
 		c.value = !0;
@@ -321,18 +398,18 @@ function P(e) {
 }
 //#endregion
 //#region src/utils.ts
-function F(e = "comms") {
-	let [t, n] = I(e, () => k(), (e) => e.unsubscribe());
+function W(e = "comms") {
+	let [t, n] = G(e, () => R(), (e) => e.unsubscribe());
 	return {
 		provideComms: t,
 		injectComms: n
 	};
 }
-function I(e, t, n) {
+function G(e, t, n) {
 	let r, i = () => (!r && (r = t()), r);
 	return [(t) => (t.onUnmount(() => n && r && n(r)), t.provide(e, i)), () => c(e)()];
 }
-function L(t, r, i) {
+function K(t, r, i) {
 	let a = n(t, r, {
 		immediate: !1,
 		...i
@@ -342,9 +419,9 @@ function L(t, r, i) {
 		executeDelayed: a.execute
 	});
 }
-function R(e) {
+function q(e) {
 	let t, n = p(void 0);
 	return u(() => t = e.signal.receive((e) => n.value = e)), d(() => t?.()), [f(n), () => t?.()];
 }
 //#endregion
-export { D as useAntColorMode, O as useAntI18n, L as useApi, k as useCommsClient, M as useCommsHost, F as useCommsInjection, N as usePermissions, R as useSignal, I as useSingleton, P as useTemplateVersioning };
+export { M as formatDate, N as useAntColorMode, P as useAntI18n, K as useApi, L as useAppTourMode, R as useCommsClient, V as useCommsHost, W as useCommsInjection, H as usePermissions, q as useSignal, G as useSingleton, U as useTemplateVersioning };

package/dist/types/formatDate.d.ts

@@ -0,0 +1,22 @@
+export type DateFormatPreset = 'short' | 'medium' | 'long' | 'monthDay' | 'shortDateTime' | 'mediumDateTime' | 'iso';
+export interface FormatDateOptions {
+    /** Display preset. Default: 'short' (DD-MM-YYYY numeric). */
+    preset?: DateFormatPreset;
+    /** BCP-47 locale tag. Default: 'nl' (Dutch DD-MM-YYYY notation). */
+    locale?: string;
+    /** Returned when value is null/undefined/empty/invalid. Default: ''. */
+    fallback?: string;
+}
+/**
+ * Format a date for display across the ANT environment.
+ *
+ * Default is the Dutch DD-MM-YYYY notation. German callers get DD.MM.YYYY
+ * via native Intl. English (`en`, `en-US`, `en-GB`, ...) is intentionally
+ * mapped to the Dutch numeric pattern for the `short`/`shortDateTime`
+ * presets to keep the project-wide DD-MM-YYYY default even when the host
+ * runs in English.
+ *
+ * Storage stays ISO everywhere — use the `iso` preset only for payload
+ * serialisation, never for display.
+ */
+export declare function formatDate(value: Date | string | number | null | undefined, options?: FormatDateOptions): string;

package/dist/types/index.d.ts

@@ -1,5 +1,7 @@
+export { type DateFormatPreset, formatDate, type FormatDateOptions } from './formatDate';
 export { useAntColorMode, type UseAntColorModeOptions, type UseAntColorModeReturn } from './useAntColorMode';
 export { useAntI18n, type UseAntI18nReturn } from './useAntI18n';
+export { useAppTourMode } from './useAppTourMode';
 export { type UseCommsClient, useCommsClient } from './useCommsClient';
 export { type CommsHostArgs, type UseCommsHost, useCommsHost } from './useCommsHost';
 export { type UsePermissions, usePermissions } from './usePermissions';

package/dist/types/useAppTourMode.d.ts

@@ -0,0 +1,26 @@
+import { Ref } from 'vue';
+/**
+ * Iframe-side tour mode — mirrors the OS `useTourMode` API.
+ *
+ * Call `connectContext(context)` once in App.vue to wire the OS context stream.
+ * Then call `useAppTourMode()` anywhere to read state and set the active zone.
+ *
+ * @example
+ * ```typescript
+ * // App.vue — one-time wiring
+ * const { comms } = injectContext()
+ * useAppTourMode().connectContext(comms.context)
+ *
+ * // Any component
+ * const { isActive, activeZoneId, setActiveZone } = useAppTourMode()
+ * ```
+ */
+export declare function useAppTourMode(): {
+    isActive: Readonly<Ref<boolean, boolean>>;
+    activeZoneId: Readonly<Ref<string | null, string | null>>;
+    connectContext: (context: Ref<{
+        tourMode?: boolean | null;
+    }>) => void;
+    setActiveZone: (id: string | null) => void;
+    exit: () => void;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antcde/vue-utils",
   "type": "module",
-  "version": "0.2.14-rc.6346d95",
+  "version": "0.2.14-rc.6a3e1ae",
   "description": "Helper to use ANT Comms in Vue 3",
   "author": "CollaborAll",
   "exports": {
@@ -31,16 +31,16 @@
     "vue-i18n": "^11.1.12"
   },
   "dependencies": {
-    "@antcde/connect-ts": "0.4.18-rc.6346d95"
+    "@antcde/connect-ts": "0.4.18-rc.6a3e1ae"
   },
   "devDependencies": {
     "@tsconfig/node22": "^22.0.5",
-    "@types/node": "^22.19.20",
+    "@types/node": "^22.19.21",
     "@vitejs/plugin-vue": "^6.0.7",
     "@vue/tsconfig": "^0.9.1",
     "typescript": "~6.0.3",
     "vite": "^8.0.16",
     "vite-plugin-dts": "^4.5.4",
-    "vue-tsc": "^3.3.4"
+    "vue-tsc": "^3.3.5"
   }
 }