@hubstr/kit 0.1.5 → 0.1.6

package/ui/es/utils/blobToPng.mjs

@@ -0,0 +1,40 @@
+//#region src/utils/blobToPng.ts
+/**
+* Convert image blob to PNG format.
+* Clipboard API only supports image/png and image/svg+xml.
+* WebP, JPEG and other formats need to be converted for clipboard copy.
+*/
+const blobToPng = (blob) => new Promise((resolve, reject) => {
+	const img = new Image();
+	const url = URL.createObjectURL(blob);
+	img.onload = () => {
+		URL.revokeObjectURL(url);
+		const canvas = document.createElement("canvas");
+		canvas.width = img.naturalWidth;
+		canvas.height = img.naturalHeight;
+		const ctx = canvas.getContext("2d");
+		if (!ctx) {
+			reject(/* @__PURE__ */ new Error("Canvas context not available"));
+			return;
+		}
+		ctx.drawImage(img, 0, 0);
+		canvas.toBlob((pngBlob) => {
+			if (pngBlob) resolve(pngBlob);
+			else reject(/* @__PURE__ */ new Error("Failed to convert to PNG"));
+		}, "image/png", 1);
+	};
+	img.onerror = () => {
+		URL.revokeObjectURL(url);
+		reject(/* @__PURE__ */ new Error("Failed to load image"));
+	};
+	img.src = url;
+});
+const getClipboardBlob = async (blob) => {
+	const type = (blob.type || "").toLowerCase();
+	if (type === "image/png" || type === "image/svg+xml") return { [type]: blob };
+	return { "image/png": await blobToPng(blob) };
+};
+//#endregion
+export { getClipboardBlob };
+
+//# sourceMappingURL=blobToPng.mjs.map

package/ui/es/utils/blobToPng.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobToPng.mjs","names":[],"sources":["../../src/utils/blobToPng.ts"],"sourcesContent":["/**\r\n * Convert image blob to PNG format.\r\n * Clipboard API only supports image/png and image/svg+xml.\r\n * WebP, JPEG and other formats need to be converted for clipboard copy.\r\n */\r\nexport const blobToPng = (blob: Blob): Promise<Blob> =>\r\n  new Promise((resolve, reject) => {\r\n    const img = new Image();\r\n    const url = URL.createObjectURL(blob);\r\n\r\n    img.onload = () => {\r\n      URL.revokeObjectURL(url);\r\n      const canvas = document.createElement('canvas');\r\n      canvas.width = img.naturalWidth;\r\n      canvas.height = img.naturalHeight;\r\n      const ctx = canvas.getContext('2d');\r\n      if (!ctx) {\r\n        reject(new Error('Canvas context not available'));\r\n        return;\r\n      }\r\n      ctx.drawImage(img, 0, 0);\r\n      canvas.toBlob(\r\n        (pngBlob) => {\r\n          if (pngBlob) {\r\n            resolve(pngBlob);\r\n          } else {\r\n            reject(new Error('Failed to convert to PNG'));\r\n          }\r\n        },\r\n        'image/png',\r\n        1,\r\n      );\r\n    };\r\n\r\n    img.onerror = () => {\r\n      URL.revokeObjectURL(url);\r\n      reject(new Error('Failed to load image'));\r\n    };\r\n\r\n    img.src = url;\r\n  });\r\n\r\nconst CLIPBOARD_SUPPORTED_TYPES = ['image/png', 'image/svg+xml'] as const;\r\n\r\nexport const getClipboardBlob = async (\r\n  blob: Blob,\r\n): Promise<{ 'image/png': Blob } | { 'image/svg+xml': Blob }> => {\r\n  const type = (blob.type || '').toLowerCase();\r\n\r\n  if (type === 'image/png' || type === 'image/svg+xml') {\r\n    return { [type]: blob } as { 'image/png': Blob } | { 'image/svg+xml': Blob };\r\n  }\r\n\r\n  const pngBlob = await blobToPng(blob);\r\n  return { 'image/png': pngBlob };\r\n};\r\n"],"mappings":";;;;;;AAKA,MAAa,aAAa,SACxB,IAAI,SAAS,SAAS,WAAW;CAC/B,MAAM,MAAM,IAAI,OAAO;CACvB,MAAM,MAAM,IAAI,gBAAgB,KAAK;AAErC,KAAI,eAAe;AACjB,MAAI,gBAAgB,IAAI;EACxB,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,SAAO,QAAQ,IAAI;AACnB,SAAO,SAAS,IAAI;EACpB,MAAM,MAAM,OAAO,WAAW,KAAK;AACnC,MAAI,CAAC,KAAK;AACR,0BAAO,IAAI,MAAM,+BAA+B,CAAC;AACjD;;AAEF,MAAI,UAAU,KAAK,GAAG,EAAE;AACxB,SAAO,QACJ,YAAY;AACX,OAAI,QACF,SAAQ,QAAQ;OAEhB,wBAAO,IAAI,MAAM,2BAA2B,CAAC;KAGjD,aACA,EACD;;AAGH,KAAI,gBAAgB;AAClB,MAAI,gBAAgB,IAAI;AACxB,yBAAO,IAAI,MAAM,uBAAuB,CAAC;;AAG3C,KAAI,MAAM;EACV;AAIJ,MAAa,mBAAmB,OAC9B,SAC+D;CAC/D,MAAM,QAAQ,KAAK,QAAQ,IAAI,aAAa;AAE5C,KAAI,SAAS,eAAe,SAAS,gBACnC,QAAO,GAAG,OAAO,MAAM;AAIzB,QAAO,EAAE,aAAa,MADA,UAAU,KAAK,EACN"}

package/ui/es/utils/copyToClipboard.d.mts

@@ -0,0 +1,5 @@
+//#region src/utils/copyToClipboard.d.ts
+declare const copyToClipboard: (text: string) => Promise<void>;
+//#endregion
+export { copyToClipboard };
+//# sourceMappingURL=copyToClipboard.d.mts.map

package/ui/es/utils/copyToClipboard.mjs

@@ -0,0 +1,18 @@
+//#region src/utils/copyToClipboard.ts
+const copyToClipboard = async (text) => {
+	try {
+		await navigator.clipboard.writeText(text);
+	} catch {
+		const textArea = document.createElement("textarea");
+		textArea.value = text;
+		document.body.append(textArea);
+		textArea.focus();
+		textArea.select();
+		document.execCommand("copy");
+		textArea.remove();
+	}
+};
+//#endregion
+export { copyToClipboard };
+
+//# sourceMappingURL=copyToClipboard.mjs.map

package/ui/es/utils/copyToClipboard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyToClipboard.mjs","names":[],"sources":["../../src/utils/copyToClipboard.ts"],"sourcesContent":["export const copyToClipboard = async (text: string) => {\r\n  try {\r\n    await navigator.clipboard.writeText(text);\r\n  } catch {\r\n    const textArea = document.createElement('textarea');\r\n    textArea.value = text;\r\n    document.body.append(textArea);\r\n    textArea.focus();\r\n    textArea.select();\r\n    document.execCommand('copy');\r\n    textArea.remove();\r\n  }\r\n};\r\n"],"mappings":";AAAA,MAAa,kBAAkB,OAAO,SAAiB;AACrD,KAAI;AACF,QAAM,UAAU,UAAU,UAAU,KAAK;SACnC;EACN,MAAM,WAAW,SAAS,cAAc,WAAW;AACnD,WAAS,QAAQ;AACjB,WAAS,KAAK,OAAO,SAAS;AAC9B,WAAS,OAAO;AAChB,WAAS,QAAQ;AACjB,WAAS,YAAY,OAAO;AAC5B,WAAS,QAAQ"}

package/ui/es/utils/destroyOnInvalidActiveTriggerElement.mjs

@@ -0,0 +1,87 @@
+import { useLayoutEffect } from "react";
+//#region src/utils/destroyOnInvalidActiveTriggerElement.ts
+const isInvalidTriggerElement = (el) => {
+	if (!el) return true;
+	if (!el.isConnected) return true;
+	try {
+		let current = el;
+		while (current) {
+			if (getComputedStyle(current).display === "none") return true;
+			current = current.parentElement;
+		}
+		return false;
+	} catch {
+		return false;
+	}
+};
+/**
+* Destroys (hard reset) a group popup (Tooltip/Popover) when its active trigger element becomes
+* disconnected from the DOM or is effectively hidden via `display: none`.
+*
+* We intentionally poll while open to also catch CSS-driven visibility changes that won't
+* necessarily trigger DOM mutation observers.
+*/
+const useDestroyOnInvalidActiveTriggerElement = (store, destroy, options) => {
+	const enabled = options?.enabled ?? true;
+	const openReactive = store.useState?.("open") ?? Boolean(store.state.open);
+	const shouldWatch = enabled && openReactive;
+	useLayoutEffect(() => {
+		if (!shouldWatch) return;
+		let raf = 0;
+		const loop = () => {
+			if (isInvalidTriggerElement(store.state.activeTriggerElement ?? null)) {
+				destroy();
+				return;
+			}
+			raf = window.requestAnimationFrame(loop);
+		};
+		loop();
+		return () => window.cancelAnimationFrame(raf);
+	}, [
+		destroy,
+		shouldWatch,
+		store
+	]);
+};
+/**
+* UI-only fallback: If the positioner ends up at viewport (0,0), hide it to avoid a visible flash
+* in the corner. This doesn't replace "destroy on invalid trigger"; it's purely a visual guard.
+*/
+const useHidePopupWhenPositionerAtOrigin = (store, options) => {
+	const enabled = options?.enabled ?? true;
+	const threshold = options?.threshold ?? .5;
+	const openReactive = store.useState?.("open") ?? Boolean(store.state.open);
+	const positionerElementReactive = store.useState?.("positionerElement") ?? store.state.positionerElement ?? null;
+	useLayoutEffect(() => {
+		const positionerEl = store.state.positionerElement ?? positionerElementReactive;
+		if (!enabled || !openReactive || !positionerEl) {
+			if (positionerEl) delete positionerEl.dataset.zeroOrigin;
+			return;
+		}
+		let raf = 0;
+		const loop = () => {
+			const current = store.state.positionerElement ?? positionerEl;
+			if (!current) return;
+			const rect = current.getBoundingClientRect();
+			if (Math.abs(rect.left) <= threshold && Math.abs(rect.top) <= threshold) current.dataset.zeroOrigin = "true";
+			else delete current.dataset.zeroOrigin;
+			raf = window.requestAnimationFrame(loop);
+		};
+		loop();
+		return () => {
+			window.cancelAnimationFrame(raf);
+			const current = store.state.positionerElement ?? positionerEl;
+			if (current) delete current.dataset.zeroOrigin;
+		};
+	}, [
+		enabled,
+		openReactive,
+		positionerElementReactive,
+		store,
+		threshold
+	]);
+};
+//#endregion
+export { useDestroyOnInvalidActiveTriggerElement, useHidePopupWhenPositionerAtOrigin };
+
+//# sourceMappingURL=destroyOnInvalidActiveTriggerElement.mjs.map

package/ui/es/utils/destroyOnInvalidActiveTriggerElement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroyOnInvalidActiveTriggerElement.mjs","names":[],"sources":["../../src/utils/destroyOnInvalidActiveTriggerElement.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\r\n\r\ntype PopupStoreLike = {\r\n  // Base UI store's `useState` has a strongly-typed key union; we keep it loose here on purpose.\r\n  state: {\r\n    activeTriggerElement?: Element | null;\r\n    open?: boolean;\r\n    positionerElement?: HTMLElement | null;\r\n  };\r\n  useState?: (...args: any[]) => unknown;\r\n};\r\n\r\nconst isInvalidTriggerElement = (el: Element | null): boolean => {\r\n  if (!el) return true;\r\n\r\n  if (!el.isConnected) return true;\r\n\r\n  // \"display: none\" on self or an ancestor effectively hides the trigger.\r\n  // `getComputedStyle` can throw in some edge cases (e.g. non-Element in old envs),\r\n  // so we guard it defensively.\r\n  try {\r\n    // Check self and all ancestors for display: none\r\n    let current: Element | null = el;\r\n    while (current) {\r\n      if (getComputedStyle(current).display === 'none') {\r\n        return true;\r\n      }\r\n      current = current.parentElement;\r\n    }\r\n    return false;\r\n  } catch {\r\n    return false;\r\n  }\r\n};\r\n\r\n/**\r\n * Destroys (hard reset) a group popup (Tooltip/Popover) when its active trigger element becomes\r\n * disconnected from the DOM or is effectively hidden via `display: none`.\r\n *\r\n * We intentionally poll while open to also catch CSS-driven visibility changes that won't\r\n * necessarily trigger DOM mutation observers.\r\n */\r\nexport const useDestroyOnInvalidActiveTriggerElement = (\r\n  store: PopupStoreLike,\r\n  destroy: () => void,\r\n  options?: {\r\n    /**\r\n     * @default true\r\n     */\r\n    enabled?: boolean;\r\n  },\r\n) => {\r\n  const enabled = options?.enabled ?? true;\r\n\r\n  // Subscribe with `useState` (reactive), but read from `state` (immediate) inside the loop.\r\n  // Base UI note: `state` updates immediately, while `useState` reflects updates before the next render.\r\n  const openReactive =\r\n    (store.useState?.('open') as boolean | undefined) ?? Boolean(store.state.open);\r\n  const shouldWatch = enabled && openReactive;\r\n\r\n  // Use layout effect so the first check runs right after React commits DOM updates.\r\n  // Then keep watching via rAF while open to also capture CSS-driven visibility changes.\r\n  useLayoutEffect(() => {\r\n    if (!shouldWatch) return;\r\n\r\n    let raf = 0;\r\n\r\n    const loop = () => {\r\n      if (isInvalidTriggerElement(store.state.activeTriggerElement ?? null)) {\r\n        destroy();\r\n        return;\r\n      }\r\n      raf = window.requestAnimationFrame(loop);\r\n    };\r\n\r\n    loop();\r\n    return () => window.cancelAnimationFrame(raf);\r\n  }, [destroy, shouldWatch, store]);\r\n};\r\n\r\n/**\r\n * UI-only fallback: If the positioner ends up at viewport (0,0), hide it to avoid a visible flash\r\n * in the corner. This doesn't replace \"destroy on invalid trigger\"; it's purely a visual guard.\r\n */\r\nexport const useHidePopupWhenPositionerAtOrigin = (\r\n  store: PopupStoreLike,\r\n  options?: {\r\n    /**\r\n     * @default true\r\n     */\r\n    enabled?: boolean;\r\n    /**\r\n     * Pixel threshold to consider the element \"at origin\".\r\n     * @default 0.5\r\n     */\r\n    threshold?: number;\r\n  },\r\n) => {\r\n  const enabled = options?.enabled ?? true;\r\n  const threshold = options?.threshold ?? 0.5;\r\n\r\n  const openReactive =\r\n    (store.useState?.('open') as boolean | undefined) ?? Boolean(store.state.open);\r\n  const positionerElementReactive =\r\n    (store.useState?.('positionerElement') as HTMLElement | null | undefined) ??\r\n    store.state.positionerElement ??\r\n    null;\r\n\r\n  useLayoutEffect(() => {\r\n    const positionerEl = store.state.positionerElement ?? positionerElementReactive;\r\n\r\n    if (!enabled || !openReactive || !positionerEl) {\r\n      if (positionerEl) delete positionerEl.dataset.zeroOrigin;\r\n      return;\r\n    }\r\n\r\n    let raf = 0;\r\n    const loop = () => {\r\n      const current = store.state.positionerElement ?? positionerEl;\r\n      if (!current) return;\r\n\r\n      const rect = current.getBoundingClientRect();\r\n      const atOrigin = Math.abs(rect.left) <= threshold && Math.abs(rect.top) <= threshold;\r\n      if (atOrigin) current.dataset.zeroOrigin = 'true';\r\n      else delete current.dataset.zeroOrigin;\r\n\r\n      raf = window.requestAnimationFrame(loop);\r\n    };\r\n\r\n    loop();\r\n    return () => {\r\n      window.cancelAnimationFrame(raf);\r\n      const current = store.state.positionerElement ?? positionerEl;\r\n      if (current) delete current.dataset.zeroOrigin;\r\n    };\r\n  }, [enabled, openReactive, positionerElementReactive, store, threshold]);\r\n};\r\n"],"mappings":";;AAYA,MAAM,2BAA2B,OAAgC;AAC/D,KAAI,CAAC,GAAI,QAAO;AAEhB,KAAI,CAAC,GAAG,YAAa,QAAO;AAK5B,KAAI;EAEF,IAAI,UAA0B;AAC9B,SAAO,SAAS;AACd,OAAI,iBAAiB,QAAQ,CAAC,YAAY,OACxC,QAAO;AAET,aAAU,QAAQ;;AAEpB,SAAO;SACD;AACN,SAAO;;;;;;;;;;AAWX,MAAa,2CACX,OACA,SACA,YAMG;CACH,MAAM,UAAU,SAAS,WAAW;CAIpC,MAAM,eACH,MAAM,WAAW,OAAO,IAA4B,QAAQ,MAAM,MAAM,KAAK;CAChF,MAAM,cAAc,WAAW;AAI/B,uBAAsB;AACpB,MAAI,CAAC,YAAa;EAElB,IAAI,MAAM;EAEV,MAAM,aAAa;AACjB,OAAI,wBAAwB,MAAM,MAAM,wBAAwB,KAAK,EAAE;AACrE,aAAS;AACT;;AAEF,SAAM,OAAO,sBAAsB,KAAK;;AAG1C,QAAM;AACN,eAAa,OAAO,qBAAqB,IAAI;IAC5C;EAAC;EAAS;EAAa;EAAM,CAAC;;;;;;AAOnC,MAAa,sCACX,OACA,YAWG;CACH,MAAM,UAAU,SAAS,WAAW;CACpC,MAAM,YAAY,SAAS,aAAa;CAExC,MAAM,eACH,MAAM,WAAW,OAAO,IAA4B,QAAQ,MAAM,MAAM,KAAK;CAChF,MAAM,4BACH,MAAM,WAAW,oBAAoB,IACtC,MAAM,MAAM,qBACZ;AAEF,uBAAsB;EACpB,MAAM,eAAe,MAAM,MAAM,qBAAqB;AAEtD,MAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,cAAc;AAC9C,OAAI,aAAc,QAAO,aAAa,QAAQ;AAC9C;;EAGF,IAAI,MAAM;EACV,MAAM,aAAa;GACjB,MAAM,UAAU,MAAM,MAAM,qBAAqB;AACjD,OAAI,CAAC,QAAS;GAEd,MAAM,OAAO,QAAQ,uBAAuB;AAE5C,OADiB,KAAK,IAAI,KAAK,KAAK,IAAI,aAAa,KAAK,IAAI,KAAK,IAAI,IAAI,UAC7D,SAAQ,QAAQ,aAAa;OACtC,QAAO,QAAQ,QAAQ;AAE5B,SAAM,OAAO,sBAAsB,KAAK;;AAG1C,QAAM;AACN,eAAa;AACX,UAAO,qBAAqB,IAAI;GAChC,MAAM,UAAU,MAAM,MAAM,qBAAqB;AACjD,OAAI,QAAS,QAAO,QAAQ,QAAQ;;IAErC;EAAC;EAAS;EAAc;EAA2B;EAAO;EAAU,CAAC"}

package/ui/es/utils/devSingleton.mjs

@@ -0,0 +1,61 @@
+//#region src/utils/devSingleton.ts
+const DEV = process.env.NODE_ENV === "development";
+const GLOBAL_KEY = "__HUBSTR_UI_DEV_SINGLETON_REGISTRY__";
+const getRegistry = () => {
+	const g = globalThis;
+	if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = {
+		global: /* @__PURE__ */ new Map(),
+		scoped: /* @__PURE__ */ new Map()
+	};
+	return g[GLOBAL_KEY];
+};
+const getScopedMap = (registry, name) => {
+	const existing = registry.scoped.get(name);
+	if (existing) return existing;
+	const next = /* @__PURE__ */ new WeakMap();
+	registry.scoped.set(name, next);
+	return next;
+};
+const singletonError = (name) => /* @__PURE__ */ new Error(`[hubstr-ui] ${name} must be rendered only once in a single React tree. You probably mounted it multiple times (or in multiple roots).`);
+/**
+* Dev-only singleton guard.
+* - If `scope` is provided, it's enforced per scope object (e.g. portal root).
+* - Otherwise it's enforced globally in the current JS runtime.
+*/
+const registerDevSingleton = (name, scope) => {
+	if (!DEV) return () => {};
+	const registry = getRegistry();
+	if (scope) {
+		const scoped = getScopedMap(registry, name);
+		const prev = scoped.get(scope) ?? 0;
+		const next = prev + 1;
+		scoped.set(scope, next);
+		if (next > 1) {
+			if (prev === 0) scoped.delete(scope);
+			else scoped.set(scope, prev);
+			throw singletonError(name);
+		}
+		return () => {
+			const after = (scoped.get(scope) ?? 0) - 1;
+			if (after <= 0) scoped.delete(scope);
+			else scoped.set(scope, after);
+		};
+	}
+	const prev = registry.global.get(name) ?? 0;
+	const next = prev + 1;
+	registry.global.set(name, next);
+	if (next > 1) {
+		if (prev === 0) registry.global.delete(name);
+		else registry.global.set(name, prev);
+		throw singletonError(name);
+	}
+	return () => {
+		const after = (registry.global.get(name) ?? 0) - 1;
+		if (after <= 0) registry.global.delete(name);
+		else registry.global.set(name, after);
+	};
+};
+//#endregion
+export { registerDevSingleton };
+
+//# sourceMappingURL=devSingleton.mjs.map

package/ui/es/utils/devSingleton.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"devSingleton.mjs","names":[],"sources":["../../src/utils/devSingleton.ts"],"sourcesContent":["const DEV = process.env.NODE_ENV === 'development';\r\n\r\ntype Registry = {\r\n  global: Map<string, number>;\r\n  scoped: Map<string, WeakMap<object, number>>;\r\n};\r\n\r\nconst GLOBAL_KEY = '__HUBSTR_UI_DEV_SINGLETON_REGISTRY__';\r\n\r\nconst getRegistry = (): Registry => {\r\n  const g = globalThis as unknown as Record<string, unknown>;\r\n  if (!g[GLOBAL_KEY]) {\r\n    g[GLOBAL_KEY] = {\r\n      global: new Map<string, number>(),\r\n      scoped: new Map<string, WeakMap<object, number>>(),\r\n    } satisfies Registry;\r\n  }\r\n  return g[GLOBAL_KEY] as Registry;\r\n};\r\n\r\nconst getScopedMap = (registry: Registry, name: string) => {\r\n  const existing = registry.scoped.get(name);\r\n  if (existing) return existing;\r\n  const next = new WeakMap<object, number>();\r\n  registry.scoped.set(name, next);\r\n  return next;\r\n};\r\n\r\nconst singletonError = (name: string) =>\r\n  new Error(\r\n    `[hubstr-ui] ${name} must be rendered only once in a single React tree. ` +\r\n      `You probably mounted it multiple times (or in multiple roots).`,\r\n  );\r\n\r\n/**\r\n * Dev-only singleton guard.\r\n * - If `scope` is provided, it's enforced per scope object (e.g. portal root).\r\n * - Otherwise it's enforced globally in the current JS runtime.\r\n */\r\nexport const registerDevSingleton = (name: string, scope?: object | null): (() => void) => {\r\n  if (!DEV) return () => {};\r\n\r\n  const registry = getRegistry();\r\n\r\n  // Scoped singleton (preferred)\r\n  if (scope) {\r\n    const scoped = getScopedMap(registry, name);\r\n    const prev = scoped.get(scope) ?? 0;\r\n    const next = prev + 1;\r\n    scoped.set(scope, next);\r\n\r\n    if (next > 1) {\r\n      // rollback to avoid poisoning the registry after throwing\r\n      if (prev === 0) scoped.delete(scope);\r\n      else scoped.set(scope, prev);\r\n      throw singletonError(name);\r\n    }\r\n\r\n    return () => {\r\n      const curr = scoped.get(scope) ?? 0;\r\n      const after = curr - 1;\r\n      if (after <= 0) scoped.delete(scope);\r\n      else scoped.set(scope, after);\r\n    };\r\n  }\r\n\r\n  // Global singleton (fallback)\r\n  const prev = registry.global.get(name) ?? 0;\r\n  const next = prev + 1;\r\n  registry.global.set(name, next);\r\n\r\n  if (next > 1) {\r\n    // rollback to avoid poisoning the registry after throwing\r\n    if (prev === 0) registry.global.delete(name);\r\n    else registry.global.set(name, prev);\r\n    throw singletonError(name);\r\n  }\r\n\r\n  return () => {\r\n    const curr = registry.global.get(name) ?? 0;\r\n    const after = curr - 1;\r\n    if (after <= 0) registry.global.delete(name);\r\n    else registry.global.set(name, after);\r\n  };\r\n};\r\n"],"mappings":";AAAA,MAAM,MAAM,QAAQ,IAAI,aAAa;AAOrC,MAAM,aAAa;AAEnB,MAAM,oBAA8B;CAClC,MAAM,IAAI;AACV,KAAI,CAAC,EAAE,YACL,GAAE,cAAc;EACd,wBAAQ,IAAI,KAAqB;EACjC,wBAAQ,IAAI,KAAsC;EACnD;AAEH,QAAO,EAAE;;AAGX,MAAM,gBAAgB,UAAoB,SAAiB;CACzD,MAAM,WAAW,SAAS,OAAO,IAAI,KAAK;AAC1C,KAAI,SAAU,QAAO;CACrB,MAAM,uBAAO,IAAI,SAAyB;AAC1C,UAAS,OAAO,IAAI,MAAM,KAAK;AAC/B,QAAO;;AAGT,MAAM,kBAAkB,yBACtB,IAAI,MACF,eAAe,KAAK,oHAErB;;;;;;AAOH,MAAa,wBAAwB,MAAc,UAAwC;AACzF,KAAI,CAAC,IAAK,cAAa;CAEvB,MAAM,WAAW,aAAa;AAG9B,KAAI,OAAO;EACT,MAAM,SAAS,aAAa,UAAU,KAAK;EAC3C,MAAM,OAAO,OAAO,IAAI,MAAM,IAAI;EAClC,MAAM,OAAO,OAAO;AACpB,SAAO,IAAI,OAAO,KAAK;AAEvB,MAAI,OAAO,GAAG;AAEZ,OAAI,SAAS,EAAG,QAAO,OAAO,MAAM;OAC/B,QAAO,IAAI,OAAO,KAAK;AAC5B,SAAM,eAAe,KAAK;;AAG5B,eAAa;GAEX,MAAM,SADO,OAAO,IAAI,MAAM,IAAI,KACb;AACrB,OAAI,SAAS,EAAG,QAAO,OAAO,MAAM;OAC/B,QAAO,IAAI,OAAO,MAAM;;;CAKjC,MAAM,OAAO,SAAS,OAAO,IAAI,KAAK,IAAI;CAC1C,MAAM,OAAO,OAAO;AACpB,UAAS,OAAO,IAAI,MAAM,KAAK;AAE/B,KAAI,OAAO,GAAG;AAEZ,MAAI,SAAS,EAAG,UAAS,OAAO,OAAO,KAAK;MACvC,UAAS,OAAO,IAAI,MAAM,KAAK;AACpC,QAAM,eAAe,KAAK;;AAG5B,cAAa;EAEX,MAAM,SADO,SAAS,OAAO,IAAI,KAAK,IAAI,KACrB;AACrB,MAAI,SAAS,EAAG,UAAS,OAAO,OAAO,KAAK;MACvC,UAAS,OAAO,IAAI,MAAM,MAAM"}

package/ui/es/utils/dom.d.mts

@@ -0,0 +1,15 @@
+//#region src/utils/dom.d.ts
+declare const preventDefault: <T extends {
+  preventDefault: () => void;
+}>(event: T) => void;
+declare const stopPropagation: <T extends {
+  stopPropagation: () => void;
+}>(event: T) => void;
+declare const preventDefaultAndStopPropagation: <T extends {
+  preventBaseUIHandler?: () => void;
+  preventDefault: () => void;
+  stopPropagation: () => void;
+}>(event: T) => void;
+//#endregion
+export { preventDefault, preventDefaultAndStopPropagation, stopPropagation };
+//# sourceMappingURL=dom.d.mts.map

package/ui/es/utils/dom.mjs

@@ -0,0 +1,16 @@
+//#region src/utils/dom.ts
+const preventDefault = (event) => {
+	event.preventDefault();
+};
+const stopPropagation = (event) => {
+	event.stopPropagation();
+};
+const preventDefaultAndStopPropagation = (event) => {
+	event.preventDefault();
+	event.stopPropagation();
+	event.preventBaseUIHandler?.();
+};
+//#endregion
+export { preventDefault, preventDefaultAndStopPropagation, stopPropagation };
+
+//# sourceMappingURL=dom.mjs.map

package/ui/es/utils/dom.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.mjs","names":[],"sources":["../../src/utils/dom.ts"],"sourcesContent":["export const preventDefault = <\r\n  T extends {\r\n    preventDefault: () => void;\r\n  },\r\n>(\r\n  event: T,\r\n) => {\r\n  event.preventDefault();\r\n};\r\n\r\nexport const stopPropagation = <\r\n  T extends {\r\n    stopPropagation: () => void;\r\n  },\r\n>(\r\n  event: T,\r\n) => {\r\n  event.stopPropagation();\r\n};\r\n\r\nexport const preventDefaultAndStopPropagation = <\r\n  T extends {\r\n    preventBaseUIHandler?: () => void;\r\n    preventDefault: () => void;\r\n    stopPropagation: () => void;\r\n  },\r\n>(\r\n  event: T,\r\n) => {\r\n  event.preventDefault();\r\n  event.stopPropagation();\r\n  event.preventBaseUIHandler?.();\r\n};\r\n"],"mappings":";AAAA,MAAa,kBAKX,UACG;AACH,OAAM,gBAAgB;;AAGxB,MAAa,mBAKX,UACG;AACH,OAAM,iBAAiB;;AAGzB,MAAa,oCAOX,UACG;AACH,OAAM,gBAAgB;AACtB,OAAM,iBAAiB;AACvB,OAAM,wBAAwB"}

package/ui/es/utils/downloadBlob.mjs

@@ -0,0 +1,21 @@
+//#region src/utils/downloadBlob.ts
+const downloadBlob = async (blobUrl, fileName) => {
+	return new Promise((resolve, reject) => {
+		try {
+			const link = document.createElement("a");
+			link.href = blobUrl;
+			link.download = fileName;
+			link.style.display = "none";
+			document.body.append(link);
+			link.click();
+			link.remove();
+			resolve();
+		} catch (error) {
+			reject(error);
+		}
+	});
+};
+//#endregion
+export { downloadBlob };
+
+//# sourceMappingURL=downloadBlob.mjs.map

package/ui/es/utils/downloadBlob.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadBlob.mjs","names":[],"sources":["../../src/utils/downloadBlob.ts"],"sourcesContent":["export const downloadBlob = async (blobUrl: string, fileName: string): Promise<void> => {\r\n  return new Promise((resolve, reject) => {\r\n    try {\r\n      const link = document.createElement('a');\r\n      link.href = blobUrl;\r\n      link.download = fileName;\r\n      link.style.display = 'none';\r\n\r\n      document.body.append(link);\r\n      link.click();\r\n      link.remove();\r\n\r\n      resolve();\r\n    } catch (error) {\r\n      reject(error);\r\n    }\r\n  });\r\n};\r\n"],"mappings":";AAAA,MAAa,eAAe,OAAO,SAAiB,aAAoC;AACtF,QAAO,IAAI,SAAS,SAAS,WAAW;AACtC,MAAI;GACF,MAAM,OAAO,SAAS,cAAc,IAAI;AACxC,QAAK,OAAO;AACZ,QAAK,WAAW;AAChB,QAAK,MAAM,UAAU;AAErB,YAAS,KAAK,OAAO,KAAK;AAC1B,QAAK,OAAO;AACZ,QAAK,QAAQ;AAEb,YAAS;WACF,OAAO;AACd,UAAO,MAAM;;GAEf"}

package/ui/es/utils/formatTime.mjs

@@ -0,0 +1,13 @@
+import dayjs from "dayjs";
+//#region src/utils/formatTime.ts
+const formatTime = (time) => {
+	const now = dayjs();
+	const target = dayjs(time);
+	if (target.isSame(now, "day")) return target.format("HH:mm:ss");
+	else if (target.isSame(now, "year")) return target.format("MM-DD HH:mm:ss");
+	else return target.format("YYYY-MM-DD HH:mm:ss");
+};
+//#endregion
+export { formatTime };
+
+//# sourceMappingURL=formatTime.mjs.map

package/ui/es/utils/formatTime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatTime.mjs","names":[],"sources":["../../src/utils/formatTime.ts"],"sourcesContent":["import dayjs from 'dayjs';\r\n\r\nexport const formatTime = (time: number): string => {\r\n  const now = dayjs();\r\n  const target = dayjs(time);\r\n\r\n  if (target.isSame(now, 'day')) {\r\n    return target.format('HH:mm:ss');\r\n  } else if (target.isSame(now, 'year')) {\r\n    return target.format('MM-DD HH:mm:ss');\r\n  } else {\r\n    return target.format('YYYY-MM-DD HH:mm:ss');\r\n  }\r\n};\r\n"],"mappings":";;AAEA,MAAa,cAAc,SAAyB;CAClD,MAAM,MAAM,OAAO;CACnB,MAAM,SAAS,MAAM,KAAK;AAE1B,KAAI,OAAO,OAAO,KAAK,MAAM,CAC3B,QAAO,OAAO,OAAO,WAAW;UACvB,OAAO,OAAO,KAAK,OAAO,CACnC,QAAO,OAAO,OAAO,iBAAiB;KAEtC,QAAO,OAAO,OAAO,sBAAsB"}

package/ui/es/utils/genCdnUrl.d.mts

@@ -0,0 +1,17 @@
+//#region src/utils/genCdnUrl.d.ts
+type CDN = 'aliyun' | 'unpkg';
+interface CdnApi {
+  path: string;
+  pkg: string;
+  proxy?: CDN;
+  version?: string;
+}
+declare const genCdnUrl: ({
+  pkg,
+  version,
+  path,
+  proxy
+}: CdnApi) => string;
+//#endregion
+export { CDN, CdnApi, genCdnUrl };
+//# sourceMappingURL=genCdnUrl.d.mts.map

package/ui/es/utils/genCdnUrl.mjs

@@ -0,0 +1,14 @@
+import urlJoin from "url-join";
+//#region src/utils/genCdnUrl.ts
+const UNPKG_API = "https://unpkg.com";
+const ALIYUN_API = "https://registry.npmmirror.com";
+const genCdnUrl = ({ pkg, version = "latest", path, proxy }) => {
+	switch (proxy) {
+		case "unpkg": return urlJoin(UNPKG_API, `${pkg}@${version}`, path);
+		default: return urlJoin(ALIYUN_API, pkg, version, "files", path);
+	}
+};
+//#endregion
+export { genCdnUrl };
+
+//# sourceMappingURL=genCdnUrl.mjs.map

package/ui/es/utils/genCdnUrl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"genCdnUrl.mjs","names":[],"sources":["../../src/utils/genCdnUrl.ts"],"sourcesContent":["import urlJoin from 'url-join';\n\nconst UNPKG_API = 'https://unpkg.com';\nconst ALIYUN_API = 'https://registry.npmmirror.com';\n\nexport type CDN = 'aliyun' | 'unpkg';\nexport interface CdnApi {\n  path: string;\n  pkg: string;\n  proxy?: CDN;\n  version?: string;\n}\n\nexport const genCdnUrl = ({ pkg, version = 'latest', path, proxy }: CdnApi): string => {\n  switch (proxy) {\n    case 'unpkg': {\n      return urlJoin(UNPKG_API, `${pkg}@${version}`, path);\n    }\n    default: {\n      return urlJoin(ALIYUN_API, pkg, version, 'files', path);\n    }\n  }\n};\n\nexport { ALIYUN_API, UNPKG_API };\n"],"mappings":";;AAEA,MAAM,YAAY;AAClB,MAAM,aAAa;AAUnB,MAAa,aAAa,EAAE,KAAK,UAAU,UAAU,MAAM,YAA4B;AACrF,SAAQ,OAAR;EACE,KAAK,QACH,QAAO,QAAQ,WAAW,GAAG,IAAI,GAAG,WAAW,KAAK;EAEtD,QACE,QAAO,QAAQ,YAAY,KAAK,SAAS,SAAS,KAAK"}

package/ui/es/utils/getNow.mjs

@@ -0,0 +1,8 @@
+//#region src/utils/getNow.ts
+const getNow = () => {
+	return typeof performance === "undefined" ? Date.now() : performance.now();
+};
+//#endregion
+export { getNow };
+
+//# sourceMappingURL=getNow.mjs.map

package/ui/es/utils/getNow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNow.mjs","names":[],"sources":["../../src/utils/getNow.ts"],"sourcesContent":["export const getNow = (): number => {\r\n  return typeof performance === 'undefined' ? Date.now() : performance.now();\r\n};\r\n"],"mappings":";AAAA,MAAa,eAAuB;AAClC,QAAO,OAAO,gBAAgB,cAAc,KAAK,KAAK,GAAG,YAAY,KAAK"}

package/ui/es/utils/isDeepEqual.mjs

@@ -0,0 +1,21 @@
+//#region src/utils/isDeepEqual.ts
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isDeepEqual = (a, b) => {
+	if (a === b) return true;
+	if (Array.isArray(a) || Array.isArray(b)) {
+		if (!Array.isArray(a) || !Array.isArray(b)) return false;
+		if (a.length !== b.length) return false;
+		for (let i = 0; i < a.length; i++) if (!isDeepEqual(a[i], b[i])) return false;
+		return true;
+	}
+	if (!isRecord(a) || !isRecord(b)) return false;
+	const keysA = Object.keys(a);
+	const keysB = Object.keys(b);
+	if (keysA.length !== keysB.length) return false;
+	for (const key of keysA) if (!isDeepEqual(a[key], b[key])) return false;
+	return true;
+};
+//#endregion
+export { isDeepEqual };
+
+//# sourceMappingURL=isDeepEqual.mjs.map

package/ui/es/utils/isDeepEqual.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDeepEqual.mjs","names":[],"sources":["../../src/utils/isDeepEqual.ts"],"sourcesContent":["// Structural equality for prop/config-shaped values: primitives, plain\r\n// records, and arrays. Functions and class instances are compared by\r\n// reference (caller is expected to memoise callbacks via useCallback).\r\n// Lifted out of StreamdownRender so the same definition powers\r\n// `useStableValue` at the Markdown boundary — keep them in sync if you\r\n// extend the rules here.\r\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\r\n  typeof value === 'object' && value !== null;\r\n\r\nexport const isDeepEqual = (a: unknown, b: unknown): boolean => {\r\n  if (a === b) return true;\r\n\r\n  if (Array.isArray(a) || Array.isArray(b)) {\r\n    if (!Array.isArray(a) || !Array.isArray(b)) return false;\r\n    if (a.length !== b.length) return false;\r\n    for (let i = 0; i < a.length; i++) {\r\n      if (!isDeepEqual(a[i], b[i])) return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  if (!isRecord(a) || !isRecord(b)) return false;\r\n\r\n  const keysA = Object.keys(a);\r\n  const keysB = Object.keys(b);\r\n  if (keysA.length !== keysB.length) return false;\r\n\r\n  for (const key of keysA) {\r\n    if (!isDeepEqual(a[key], b[key])) return false;\r\n  }\r\n\r\n  return true;\r\n};\r\n"],"mappings":";AAMA,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU;AAEzC,MAAa,eAAe,GAAY,MAAwB;AAC9D,KAAI,MAAM,EAAG,QAAO;AAEpB,KAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,EAAE;AACxC,MAAI,CAAC,MAAM,QAAQ,EAAE,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAE,QAAO;AACnD,MAAI,EAAE,WAAW,EAAE,OAAQ,QAAO;AAClC,OAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,IAC5B,KAAI,CAAC,YAAY,EAAE,IAAI,EAAE,GAAG,CAAE,QAAO;AAEvC,SAAO;;AAGT,KAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAE,QAAO;CAEzC,MAAM,QAAQ,OAAO,KAAK,EAAE;CAC5B,MAAM,QAAQ,OAAO,KAAK,EAAE;AAC5B,KAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAE1C,MAAK,MAAM,OAAO,MAChB,KAAI,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAE,QAAO;AAG3C,QAAO"}

package/ui/es/utils/parseTrigger.d.mts

@@ -0,0 +1,12 @@
+import { Trigger } from "../types/trigger.mjs";
+//#region src/utils/parseTrigger.d.ts
+/**
+ * Parses trigger prop to determine hover and click behavior
+ */
+declare function parseTrigger(trigger: Trigger): {
+  openOnClick: boolean;
+  openOnHover: boolean;
+};
+//#endregion
+export { parseTrigger };
+//# sourceMappingURL=parseTrigger.d.mts.map

package/ui/es/utils/parseTrigger.mjs

@@ -0,0 +1,16 @@
+"use client";
+//#region src/utils/parseTrigger.ts
+/**
+* Parses trigger prop to determine hover and click behavior
+*/
+function parseTrigger(trigger) {
+	const normalizedTriggers = new Set((Array.isArray(trigger) ? trigger : [trigger]).flatMap((item) => item === "both" ? ["hover", "click"] : [item]));
+	return {
+		openOnClick: normalizedTriggers.has("click"),
+		openOnHover: normalizedTriggers.has("hover")
+	};
+}
+//#endregion
+export { parseTrigger };
+
+//# sourceMappingURL=parseTrigger.mjs.map

package/ui/es/utils/parseTrigger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseTrigger.mjs","names":[],"sources":["../../src/utils/parseTrigger.ts"],"sourcesContent":["'use client';\r\n\r\nimport type { Trigger } from '../types';\r\n\r\n/**\r\n * Parses trigger prop to determine hover and click behavior\r\n */\r\nexport function parseTrigger(trigger: Trigger): {\r\n  openOnClick: boolean;\r\n  openOnHover: boolean;\r\n} {\r\n  const triggers = Array.isArray(trigger) ? trigger : [trigger];\r\n  const normalizedTriggers = new Set(\r\n    triggers.flatMap((item) => (item === 'both' ? ['hover', 'click'] : [item])),\r\n  );\r\n  return {\r\n    openOnClick: normalizedTriggers.has('click'),\r\n    openOnHover: normalizedTriggers.has('hover'),\r\n  };\r\n}\r\n"],"mappings":";;;;;AAOA,SAAgB,aAAa,SAG3B;CAEA,MAAM,qBAAqB,IAAI,KADd,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAElD,SAAS,SAAU,SAAS,SAAS,CAAC,SAAS,QAAQ,GAAG,CAAC,KAAK,CAAE,CAC5E;AACD,QAAO;EACL,aAAa,mBAAmB,IAAI,QAAQ;EAC5C,aAAa,mBAAmB,IAAI,QAAQ;EAC7C"}

package/ui/es/utils/placement.d.mts

@@ -0,0 +1,36 @@
+import { Placement } from "@floating-ui/react";
+
+//#region src/utils/placement.d.ts
+/**
+ * Base UI uses a small set of string literal unions for alignment and side.
+ * We re-declare them here to avoid importing internal/non-exported Base UI paths.
+ */
+type Side = 'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start';
+type Align = 'start' | 'center' | 'end';
+type PlacementConfig = {
+  align: Align;
+  side: Side;
+};
+/**
+ * All supported placement values
+ * - Unified placement names for Tooltip, Popover, and DropdownMenu
+ * - Ant Design style: topLeft, topCenter, topRight, etc.
+ * - Additional aliases: top (same as topCenter), bottom (same as bottomCenter)
+ */
+type Placement$1 = 'top' | 'topLeft' | 'topCenter' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomCenter' | 'bottomRight' | 'left' | 'leftTop' | 'leftBottom' | 'right' | 'rightTop' | 'rightBottom';
+/**
+ * Map of placement values to Base UI placement config
+ * Used by Popover and DropdownMenu components
+ */
+declare const placementMap: Record<Placement$1, PlacementConfig>;
+/**
+ * Convert unified Placement to Floating UI placement format
+ * Used by Tooltip component which uses @floating-ui/react
+ *
+ * @param placement - Unified placement value
+ * @returns Floating UI placement (e.g., 'top-start', 'bottom-end')
+ */
+declare const toFloatingUIPlacement: (placement?: Placement$1) => Placement;
+//#endregion
+export { Placement$1 as Placement, PlacementConfig, placementMap, toFloatingUIPlacement };
+//# sourceMappingURL=placement.d.mts.map

package/ui/es/utils/placement.mjs

@@ -0,0 +1,92 @@
+//#region src/utils/placement.ts
+const top = {
+	align: "center",
+	side: "top"
+};
+const topLeft = {
+	align: "start",
+	side: "top"
+};
+const topRight = {
+	align: "end",
+	side: "top"
+};
+const bottom = {
+	align: "center",
+	side: "bottom"
+};
+/**
+* Map of placement values to Base UI placement config
+* Used by Popover and DropdownMenu components
+*/
+const placementMap = {
+	bottom,
+	bottomCenter: bottom,
+	bottomLeft: {
+		align: "start",
+		side: "bottom"
+	},
+	bottomRight: {
+		align: "end",
+		side: "bottom"
+	},
+	left: {
+		align: "center",
+		side: "left"
+	},
+	leftBottom: {
+		align: "end",
+		side: "left"
+	},
+	leftTop: {
+		align: "start",
+		side: "left"
+	},
+	right: {
+		align: "center",
+		side: "right"
+	},
+	rightBottom: {
+		align: "end",
+		side: "right"
+	},
+	rightTop: {
+		align: "start",
+		side: "right"
+	},
+	top,
+	topCenter: top,
+	topLeft,
+	topRight
+};
+/**
+* Convert unified Placement to Floating UI placement format
+* Used by Tooltip component which uses @floating-ui/react
+*
+* @param placement - Unified placement value
+* @returns Floating UI placement (e.g., 'top-start', 'bottom-end')
+*/
+const toFloatingUIPlacement = (placement) => {
+	if (!placement) return "top";
+	switch (placement) {
+		case "topLeft": return "top-start";
+		case "top":
+		case "topCenter": return "top";
+		case "topRight": return "top-end";
+		case "bottomLeft": return "bottom-start";
+		case "bottom":
+		case "bottomCenter": return "bottom";
+		case "bottomRight": return "bottom-end";
+		case "leftTop": return "left-start";
+		case "left": return "left";
+		case "leftBottom": return "left-end";
+		case "rightTop": return "right-start";
+		case "right": return "right";
+		case "rightBottom": return "right-end";
+		default: return "top";
+	}
+};
+//#endregion
+export { placementMap, toFloatingUIPlacement };
+
+//# sourceMappingURL=placement.mjs.map

package/ui/es/utils/placement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.mjs","names":[],"sources":["../../src/utils/placement.ts"],"sourcesContent":["import type { Placement as FloatingUIPlacement } from '@floating-ui/react';\r\n\r\n/**\r\n * Base UI uses a small set of string literal unions for alignment and side.\r\n * We re-declare them here to avoid importing internal/non-exported Base UI paths.\r\n */\r\nexport type Side = 'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start';\r\nexport type Align = 'start' | 'center' | 'end';\r\n\r\nexport type PlacementConfig = {\r\n  align: Align;\r\n  side: Side;\r\n};\r\n\r\n/**\r\n * All supported placement values\r\n * - Unified placement names for Tooltip, Popover, and DropdownMenu\r\n * - Ant Design style: topLeft, topCenter, topRight, etc.\r\n * - Additional aliases: top (same as topCenter), bottom (same as bottomCenter)\r\n */\r\nexport type Placement =\r\n  | 'top'\r\n  | 'topLeft'\r\n  | 'topCenter'\r\n  | 'topRight'\r\n  | 'bottom'\r\n  | 'bottomLeft'\r\n  | 'bottomCenter'\r\n  | 'bottomRight'\r\n  | 'left'\r\n  | 'leftTop'\r\n  | 'leftBottom'\r\n  | 'right'\r\n  | 'rightTop'\r\n  | 'rightBottom';\r\n\r\nconst top: PlacementConfig = { align: 'center', side: 'top' };\r\nconst topLeft: PlacementConfig = { align: 'start', side: 'top' };\r\nconst topRight: PlacementConfig = { align: 'end', side: 'top' };\r\nconst bottom: PlacementConfig = { align: 'center', side: 'bottom' };\r\nconst bottomLeft: PlacementConfig = { align: 'start', side: 'bottom' };\r\nconst bottomRight: PlacementConfig = { align: 'end', side: 'bottom' };\r\nconst left: PlacementConfig = { align: 'center', side: 'left' };\r\nconst leftTop: PlacementConfig = { align: 'start', side: 'left' };\r\nconst leftBottom: PlacementConfig = { align: 'end', side: 'left' };\r\nconst right: PlacementConfig = { align: 'center', side: 'right' };\r\nconst rightTop: PlacementConfig = { align: 'start', side: 'right' };\r\nconst rightBottom: PlacementConfig = { align: 'end', side: 'right' };\r\n\r\n/**\r\n * Map of placement values to Base UI placement config\r\n * Used by Popover and DropdownMenu components\r\n */\r\nexport const placementMap: Record<Placement, PlacementConfig> = {\r\n  bottom,\r\n  bottomCenter: bottom,\r\n  bottomLeft,\r\n  bottomRight,\r\n  left,\r\n  leftBottom,\r\n  leftTop,\r\n  right,\r\n  rightBottom,\r\n  rightTop,\r\n  top,\r\n  topCenter: top,\r\n  topLeft,\r\n  topRight,\r\n};\r\n\r\n/**\r\n * Convert unified Placement to Floating UI placement format\r\n * Used by Tooltip component which uses @floating-ui/react\r\n *\r\n * @param placement - Unified placement value\r\n * @returns Floating UI placement (e.g., 'top-start', 'bottom-end')\r\n */\r\nexport const toFloatingUIPlacement = (placement?: Placement): FloatingUIPlacement => {\r\n  if (!placement) return 'top';\r\n\r\n  switch (placement) {\r\n    case 'topLeft': {\r\n      return 'top-start';\r\n    }\r\n    case 'top':\r\n    case 'topCenter': {\r\n      return 'top';\r\n    }\r\n    case 'topRight': {\r\n      return 'top-end';\r\n    }\r\n    case 'bottomLeft': {\r\n      return 'bottom-start';\r\n    }\r\n    case 'bottom':\r\n    case 'bottomCenter': {\r\n      return 'bottom';\r\n    }\r\n    case 'bottomRight': {\r\n      return 'bottom-end';\r\n    }\r\n    case 'leftTop': {\r\n      return 'left-start';\r\n    }\r\n    case 'left': {\r\n      return 'left';\r\n    }\r\n    case 'leftBottom': {\r\n      return 'left-end';\r\n    }\r\n    case 'rightTop': {\r\n      return 'right-start';\r\n    }\r\n    case 'right': {\r\n      return 'right';\r\n    }\r\n    case 'rightBottom': {\r\n      return 'right-end';\r\n    }\r\n    default: {\r\n      return 'top';\r\n    }\r\n  }\r\n};\r\n"],"mappings":";AAoCA,MAAM,MAAuB;CAAE,OAAO;CAAU,MAAM;CAAO;AAC7D,MAAM,UAA2B;CAAE,OAAO;CAAS,MAAM;CAAO;AAChE,MAAM,WAA4B;CAAE,OAAO;CAAO,MAAM;CAAO;AAC/D,MAAM,SAA0B;CAAE,OAAO;CAAU,MAAM;CAAU;;;;;AAcnE,MAAa,eAAmD;CAC9D;CACA,cAAc;CACd;EAhBoC,OAAO;EAAS,MAAM;EAgB1D;CACA;EAhBqC,OAAO;EAAO,MAAM;EAgBzD;CACA;EAhB8B,OAAO;EAAU,MAAM;EAgBrD;CACA;EAfoC,OAAO;EAAO,MAAM;EAexD;CACA;EAjBiC,OAAO;EAAS,MAAM;EAiBvD;CACA;EAhB+B,OAAO;EAAU,MAAM;EAgBtD;CACA;EAfqC,OAAO;EAAO,MAAM;EAezD;CACA;EAjBkC,OAAO;EAAS,MAAM;EAiBxD;CACA;CACA,WAAW;CACX;CACA;CACD;;;;;;;;AASD,MAAa,yBAAyB,cAA+C;AACnF,KAAI,CAAC,UAAW,QAAO;AAEvB,SAAQ,WAAR;EACE,KAAK,UACH,QAAO;EAET,KAAK;EACL,KAAK,YACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK;EACL,KAAK,eACH,QAAO;EAET,KAAK,cACH,QAAO;EAET,KAAK,UACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,cACH,QAAO;EAET,QACE,QAAO"}

package/ui/es/utils/safeParseJSON.mjs

@@ -0,0 +1,15 @@
+//#region src/utils/safeParseJSON.ts
+const safeParseJSON = (text) => {
+	if (typeof text !== "string") return;
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		return;
+	}
+	return json;
+};
+//#endregion
+export { safeParseJSON };
+
+//# sourceMappingURL=safeParseJSON.mjs.map

package/ui/es/utils/safeParseJSON.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeParseJSON.mjs","names":[],"sources":["../../src/utils/safeParseJSON.ts"],"sourcesContent":["export const safeParseJSON = <T = Record<string, any>>(text?: string) => {\r\n  if (typeof text !== 'string') return;\r\n\r\n  let json: T;\r\n  try {\r\n    json = JSON.parse(text);\r\n  } catch {\r\n    return;\r\n  }\r\n\r\n  return json;\r\n};\r\n"],"mappings":";AAAA,MAAa,iBAA0C,SAAkB;AACvE,KAAI,OAAO,SAAS,SAAU;CAE9B,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN;;AAGF,QAAO"}

package/ui/es/utils/safeReadableColor.mjs

@@ -0,0 +1,15 @@
+import { cssVar } from "antd-style";
+import { readableColor } from "polished";
+//#region src/utils/safeReadableColor.ts
+const safeReadableColor = (bgColor, fallbackColor) => {
+	try {
+		return readableColor(bgColor);
+	} catch {
+		if (bgColor.startsWith("var(")) return `contrast-color(${bgColor})`;
+		return fallbackColor || cssVar.colorText;
+	}
+};
+//#endregion
+export { safeReadableColor };
+
+//# sourceMappingURL=safeReadableColor.mjs.map

package/ui/es/utils/safeReadableColor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeReadableColor.mjs","names":[],"sources":["../../src/utils/safeReadableColor.ts"],"sourcesContent":["import { cssVar } from 'antd-style';\r\nimport { readableColor } from 'polished';\r\n\r\nexport const safeReadableColor = (bgColor: string, fallbackColor?: string): string => {\r\n  try {\r\n    return readableColor(bgColor);\r\n  } catch {\r\n    if (bgColor.startsWith('var(')) return `contrast-color(${bgColor})`;\r\n    return fallbackColor || cssVar.colorText;\r\n  }\r\n};\r\n"],"mappings":";;;AAGA,MAAa,qBAAqB,SAAiB,kBAAmC;AACpF,KAAI;AACF,SAAO,cAAc,QAAQ;SACvB;AACN,MAAI,QAAQ,WAAW,OAAO,CAAE,QAAO,kBAAkB,QAAQ;AACjE,SAAO,iBAAiB,OAAO"}