@cube-dev/ui-kit 0.113.1 → 0.115.0

package/dist/README.md

@@ -0,0 +1,32 @@
+# UI Kit for Cube Dev Projects
+
+Based on React Aria and `tasty` styling library.
+
+## Available Scripts
+
+### pnpm start
+
+Runs the test page in the development mode.
+Open http://localhost:8080 to view it in the browser.
+
+The page will reload if you make edits.
+You will also see any lint errors in the console.
+
+### pnpm storybook
+
+Run storybook with all the components of UI Kit.
+
+Deployed version of the Storybook from the `main` branch is here: https://cube-uikit-storybook.netlify.app/ 
+
+### pnpm build
+
+Builds a static copy of UIKit to the `dist/` folder.
+Your app is ready to be deployed!
+
+### pnpm test
+
+Not yet implemented
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

package/dist/_internal/hooks/use-chained-callback.js

@@ -0,0 +1,15 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useEvent } from "./use-event.js";
+
+//#region src/_internal/hooks/use-chained-callback.ts
+function useChainedCallback(...callbacks) {
+	return useEvent((...args) => {
+		callbacks.forEach((callback) => {
+			if (typeof callback === "function") callback(...args);
+		});
+	});
+}
+
+//#endregion
+export { useChainedCallback };
+//# sourceMappingURL=use-chained-callback.js.map

package/dist/_internal/hooks/use-chained-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chained-callback.js","names":[],"sources":["../../../src/_internal/hooks/use-chained-callback.ts"],"sourcesContent":["import { useEvent } from './use-event';\n\nexport function useChainedCallback(\n  ...callbacks: (((...args: any) => any) | null | undefined | boolean)[]\n) {\n  return useEvent((...args: any[]) => {\n    callbacks.forEach((callback) => {\n      if (typeof callback === 'function') {\n        callback(...args);\n      }\n    });\n  });\n}\n"],"mappings":";;;;AAEA,SAAgB,mBACd,GAAG,WACH;AACA,QAAO,UAAU,GAAG,SAAgB;AAClC,YAAU,SAAS,aAAa;AAC9B,OAAI,OAAO,aAAa,WACtB,UAAS,GAAG,KAAK;IAEnB;GACF"}

package/dist/_internal/hooks/use-debounced-value.js

@@ -0,0 +1,46 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useEffect, useRef, useState } from "react";
+
+//#region src/_internal/hooks/use-debounced-value.ts
+function useDebouncedValue(value, delay = 300, maxWait) {
+	const [debouncedValue, setDebouncedValue] = useState(value);
+	const lastValueRef = useRef(value);
+	const timeoutRef = useRef(null);
+	const maxWaitTimeoutRef = useRef(null);
+	useEffect(() => {
+		if (value === lastValueRef.current) {
+			if (timeoutRef.current) clearTimeout(timeoutRef.current);
+			if (maxWaitTimeoutRef.current) clearTimeout(maxWaitTimeoutRef.current);
+			return;
+		}
+		timeoutRef.current = setTimeout(() => {
+			setDebouncedValue(value);
+			lastValueRef.current = value;
+			if (maxWaitTimeoutRef.current) {
+				clearTimeout(maxWaitTimeoutRef.current);
+				maxWaitTimeoutRef.current = null;
+			}
+		}, delay);
+		if (maxWait && !maxWaitTimeoutRef.current) maxWaitTimeoutRef.current = setTimeout(() => {
+			setDebouncedValue(value);
+			lastValueRef.current = value;
+			if (timeoutRef.current) {
+				clearTimeout(timeoutRef.current);
+				timeoutRef.current = null;
+			}
+		}, maxWait);
+		return () => {
+			if (timeoutRef.current) clearTimeout(timeoutRef.current);
+			if (maxWaitTimeoutRef.current) clearTimeout(maxWaitTimeoutRef.current);
+		};
+	}, [
+		value,
+		delay,
+		maxWait
+	]);
+	return debouncedValue;
+}
+
+//#endregion
+export { useDebouncedValue };
+//# sourceMappingURL=use-debounced-value.js.map

package/dist/_internal/hooks/use-debounced-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounced-value.js","names":[],"sources":["../../../src/_internal/hooks/use-debounced-value.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nexport function useDebouncedValue<T>(\n  value: T,\n  delay: number = 300,\n  maxWait?: number,\n): T {\n  const [debouncedValue, setDebouncedValue] = useState(value);\n  const lastValueRef = useRef(value);\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const maxWaitTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    // If value returns to the original while waiting, clear timeouts\n    if (value === lastValueRef.current) {\n      if (timeoutRef.current) clearTimeout(timeoutRef.current);\n      if (maxWaitTimeoutRef.current) clearTimeout(maxWaitTimeoutRef.current);\n      return;\n    }\n\n    // Handle delay\n    timeoutRef.current = setTimeout(() => {\n      setDebouncedValue(value);\n      lastValueRef.current = value;\n      if (maxWaitTimeoutRef.current) {\n        clearTimeout(maxWaitTimeoutRef.current);\n        maxWaitTimeoutRef.current = null;\n      }\n    }, delay);\n\n    // Handle maxWait if provided\n    if (maxWait && !maxWaitTimeoutRef.current) {\n      maxWaitTimeoutRef.current = setTimeout(() => {\n        setDebouncedValue(value);\n        lastValueRef.current = value;\n        if (timeoutRef.current) {\n          clearTimeout(timeoutRef.current);\n          timeoutRef.current = null;\n        }\n      }, maxWait);\n    }\n\n    return () => {\n      if (timeoutRef.current) clearTimeout(timeoutRef.current);\n      if (maxWaitTimeoutRef.current) clearTimeout(maxWaitTimeoutRef.current);\n    };\n  }, [value, delay, maxWait]);\n\n  return debouncedValue;\n}\n"],"mappings":";;;;AAEA,SAAgB,kBACd,OACA,QAAgB,KAChB,SACG;CACH,MAAM,CAAC,gBAAgB,qBAAqB,SAAS,MAAM;CAC3D,MAAM,eAAe,OAAO,MAAM;CAClC,MAAM,aAAa,OAA6C,KAAK;CACrE,MAAM,oBAAoB,OAA6C,KAAK;AAE5E,iBAAgB;AAEd,MAAI,UAAU,aAAa,SAAS;AAClC,OAAI,WAAW,QAAS,cAAa,WAAW,QAAQ;AACxD,OAAI,kBAAkB,QAAS,cAAa,kBAAkB,QAAQ;AACtE;;AAIF,aAAW,UAAU,iBAAiB;AACpC,qBAAkB,MAAM;AACxB,gBAAa,UAAU;AACvB,OAAI,kBAAkB,SAAS;AAC7B,iBAAa,kBAAkB,QAAQ;AACvC,sBAAkB,UAAU;;KAE7B,MAAM;AAGT,MAAI,WAAW,CAAC,kBAAkB,QAChC,mBAAkB,UAAU,iBAAiB;AAC3C,qBAAkB,MAAM;AACxB,gBAAa,UAAU;AACvB,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;;KAEtB,QAAQ;AAGb,eAAa;AACX,OAAI,WAAW,QAAS,cAAa,WAAW,QAAQ;AACxD,OAAI,kBAAkB,QAAS,cAAa,kBAAkB,QAAQ;;IAEvE;EAAC;EAAO;EAAO;EAAQ,CAAC;AAE3B,QAAO"}

package/dist/_internal/hooks/use-deprecation-warning.js

@@ -0,0 +1,17 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { deprecationWarning } from "../../utils/warnings.js";
+import React, { useEffect } from "react";
+
+//#region src/_internal/hooks/use-deprecation-warning.ts
+function useDeprecationWarning(...args) {
+	const didWarn = React.useRef(false);
+	useEffect(() => {
+		if (didWarn.current) return;
+		didWarn.current = true;
+		deprecationWarning(...args);
+	}, [args[0]]);
+}
+
+//#endregion
+export { useDeprecationWarning };
+//# sourceMappingURL=use-deprecation-warning.js.map

package/dist/_internal/hooks/use-deprecation-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deprecation-warning.js","names":[],"sources":["../../../src/_internal/hooks/use-deprecation-warning.ts"],"sourcesContent":["import React, { useEffect } from 'react';\n\nimport { deprecationWarning } from '../../utils/warnings';\n\nexport function useDeprecationWarning(\n  ...args: Parameters<typeof deprecationWarning>\n) {\n  const didWarn = React.useRef(false);\n\n  useEffect(() => {\n    if (didWarn.current) return;\n\n    didWarn.current = true;\n    deprecationWarning(...args);\n  }, [args[0]]);\n}\n"],"mappings":";;;;;AAIA,SAAgB,sBACd,GAAG,MACH;CACA,MAAM,UAAU,MAAM,OAAO,MAAM;AAEnC,iBAAgB;AACd,MAAI,QAAQ,QAAS;AAErB,UAAQ,UAAU;AAClB,qBAAmB,GAAG,KAAK;IAC1B,CAAC,KAAK,GAAG,CAAC"}

package/dist/_internal/hooks/use-event.js

@@ -0,0 +1,19 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useSyncRef } from "./use-sync-ref.js";
+import { useCallback } from "react";
+
+//#region src/_internal/hooks/use-event.ts
+/**
+* useEvent shim from the latest React RFC.
+*
+* @see https://github.com/reactjs/rfcs/pull/220
+* @see https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md#internal-implementation
+*/
+function useEvent(callback) {
+	const callbackRef = useSyncRef(callback);
+	return useCallback((...args) => callbackRef.current(...args), []);
+}
+
+//#endregion
+export { useEvent };
+//# sourceMappingURL=use-event.js.map

package/dist/_internal/hooks/use-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event.js","names":[],"sources":["../../../src/_internal/hooks/use-event.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nimport { useSyncRef } from './use-sync-ref';\n\n/**\n * useEvent shim from the latest React RFC.\n *\n * @see https://github.com/reactjs/rfcs/pull/220\n * @see https://github.com/reactjs/rfcs/blob/useevent/text/0000-useevent.md#internal-implementation\n */\nexport function useEvent<\n  Func extends (...args: Args) => Result,\n  Args extends Parameters<any> = Parameters<Func>,\n  Result extends ReturnType<any> = ReturnType<Func>,\n>(callback: Func): (...args: Args) => Result {\n  const callbackRef = useSyncRef(callback);\n\n  return useCallback((...args) => callbackRef.current(...args), []);\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,SAId,UAA2C;CAC3C,MAAM,cAAc,WAAW,SAAS;AAExC,QAAO,aAAa,GAAG,SAAS,YAAY,QAAQ,GAAG,KAAK,EAAE,EAAE,CAAC"}

package/dist/_internal/hooks/use-is-first-render.js

@@ -0,0 +1,16 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useRef } from "react";
+
+//#region src/_internal/hooks/use-is-first-render.ts
+function useIsFirstRender() {
+	const isFirst = useRef(true);
+	if (isFirst.current) {
+		isFirst.current = false;
+		return true;
+	}
+	return isFirst.current;
+}
+
+//#endregion
+export { useIsFirstRender };
+//# sourceMappingURL=use-is-first-render.js.map

package/dist/_internal/hooks/use-is-first-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-first-render.js","names":[],"sources":["../../../src/_internal/hooks/use-is-first-render.ts"],"sourcesContent":["import { useRef } from 'react';\n\nexport function useIsFirstRender(): boolean {\n  const isFirst = useRef(true);\n\n  if (isFirst.current) {\n    isFirst.current = false;\n\n    return true;\n  }\n\n  return isFirst.current;\n}\n"],"mappings":";;;;AAEA,SAAgB,mBAA4B;CAC1C,MAAM,UAAU,OAAO,KAAK;AAE5B,KAAI,QAAQ,SAAS;AACnB,UAAQ,UAAU;AAElB,SAAO;;AAGT,QAAO,QAAQ"}

package/dist/_internal/hooks/use-sync-ref.js

@@ -0,0 +1,16 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useLayoutEffect as useLayoutEffect$1 } from "../../utils/react/useLayoutEffect.js";
+import { useRef } from "react";
+
+//#region src/_internal/hooks/use-sync-ref.ts
+function useSyncRef(value) {
+	const ref = useRef(value);
+	useLayoutEffect$1(() => {
+		ref.current = value;
+	});
+	return ref;
+}
+
+//#endregion
+export { useSyncRef };
+//# sourceMappingURL=use-sync-ref.js.map

package/dist/_internal/hooks/use-sync-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sync-ref.js","names":[],"sources":["../../../src/_internal/hooks/use-sync-ref.ts"],"sourcesContent":["import { MutableRefObject, useRef } from 'react';\n\nimport { useLayoutEffect } from '../../utils/react';\n\nexport function useSyncRef<T>(value: T): MutableRefObject<T> {\n  const ref = useRef<T>(value);\n\n  useLayoutEffect(() => {\n    ref.current = value;\n  });\n\n  return ref;\n}\n"],"mappings":";;;;;AAIA,SAAgB,WAAc,OAA+B;CAC3D,MAAM,MAAM,OAAU,MAAM;AAE5B,yBAAsB;AACpB,MAAI,UAAU;GACd;AAEF,QAAO"}

package/dist/_internal/hooks/use-timer/timer.js

@@ -0,0 +1,52 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+//#region src/_internal/hooks/use-timer/timer.ts
+var Timer = class {
+	callback;
+	delay;
+	remaining;
+	timerId = null;
+	startTime = null;
+	_status = "stopped";
+	get status() {
+		return this._status;
+	}
+	set status(status) {
+		this._status = status;
+	}
+	constructor(callback, delay) {
+		this.callback = callback;
+		this.delay = delay;
+		this.remaining = delay;
+		this.resume();
+	}
+	reset() {
+		this.clear();
+		this.remaining = this.delay;
+		this.status = "stopped";
+	}
+	pause() {
+		if (this.timerId === null || this.startTime === null) return;
+		this.clear();
+		this.remaining -= Date.now() - this.startTime;
+		this.status = "paused";
+	}
+	resume() {
+		if (this.timerId !== null) return;
+		this.startTime = Date.now();
+		this.clear();
+		this.timerId = setTimeout(() => {
+			this.reset();
+			this.callback();
+		}, this.remaining);
+		this.status = "running";
+	}
+	clear() {
+		if (this.timerId === null) return;
+		clearTimeout(this.timerId);
+		this.timerId = null;
+	}
+};
+
+//#endregion
+export { Timer };
+//# sourceMappingURL=timer.js.map

package/dist/_internal/hooks/use-timer/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","names":[],"sources":["../../../../src/_internal/hooks/use-timer/timer.ts"],"sourcesContent":["export class Timer {\n  private readonly callback: () => void;\n  private readonly delay: number;\n\n  private remaining: number;\n  private timerId: ReturnType<typeof setTimeout> | null = null;\n  private startTime: number | null = null;\n\n  private _status: 'stopped' | 'paused' | 'running' = 'stopped';\n\n  get status() {\n    return this._status;\n  }\n\n  private set status(status) {\n    this._status = status;\n  }\n\n  constructor(callback: () => unknown, delay: number) {\n    this.callback = callback;\n    this.delay = delay;\n    this.remaining = delay;\n\n    this.resume();\n  }\n\n  reset() {\n    this.clear();\n    this.remaining = this.delay;\n    this.status = 'stopped';\n  }\n\n  pause() {\n    if (this.timerId === null || this.startTime === null) {\n      return;\n    }\n\n    this.clear();\n    this.remaining -= Date.now() - this.startTime;\n    this.status = 'paused';\n  }\n\n  resume() {\n    if (this.timerId !== null) return;\n\n    this.startTime = Date.now();\n    this.clear();\n\n    this.timerId = setTimeout(() => {\n      this.reset();\n      this.callback();\n    }, this.remaining);\n\n    this.status = 'running';\n  }\n\n  private clear() {\n    if (this.timerId === null) {\n      return;\n    }\n\n    clearTimeout(this.timerId);\n    this.timerId = null;\n  }\n}\n"],"mappings":";;AAAA,IAAa,QAAb,MAAmB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,AAAQ;CACR,AAAQ,UAAgD;CACxD,AAAQ,YAA2B;CAEnC,AAAQ,UAA4C;CAEpD,IAAI,SAAS;AACX,SAAO,KAAK;;CAGd,IAAY,OAAO,QAAQ;AACzB,OAAK,UAAU;;CAGjB,YAAY,UAAyB,OAAe;AAClD,OAAK,WAAW;AAChB,OAAK,QAAQ;AACb,OAAK,YAAY;AAEjB,OAAK,QAAQ;;CAGf,QAAQ;AACN,OAAK,OAAO;AACZ,OAAK,YAAY,KAAK;AACtB,OAAK,SAAS;;CAGhB,QAAQ;AACN,MAAI,KAAK,YAAY,QAAQ,KAAK,cAAc,KAC9C;AAGF,OAAK,OAAO;AACZ,OAAK,aAAa,KAAK,KAAK,GAAG,KAAK;AACpC,OAAK,SAAS;;CAGhB,SAAS;AACP,MAAI,KAAK,YAAY,KAAM;AAE3B,OAAK,YAAY,KAAK,KAAK;AAC3B,OAAK,OAAO;AAEZ,OAAK,UAAU,iBAAiB;AAC9B,QAAK,OAAO;AACZ,QAAK,UAAU;KACd,KAAK,UAAU;AAElB,OAAK,SAAS;;CAGhB,AAAQ,QAAQ;AACd,MAAI,KAAK,YAAY,KACnB;AAGF,eAAa,KAAK,QAAQ;AAC1B,OAAK,UAAU"}

package/dist/_internal/hooks/use-timer/use-timer.js

@@ -0,0 +1,32 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useEvent } from "../use-event.js";
+import { Timer } from "./timer.js";
+import { useEffect, useState } from "react";
+
+//#region src/_internal/hooks/use-timer/use-timer.ts
+function useTimer(props = {}) {
+	const { callback, delay, isDisabled, timer: propsTimer = null } = props;
+	const callbackEvent = useEvent(() => callback?.());
+	const [timer, setTimer] = useState(() => {
+		if (propsTimer) return propsTimer;
+		if (typeof delay === "number") return new Timer(callbackEvent, delay);
+		return null;
+	});
+	if (isDisabled) timer?.reset();
+	else timer?.resume();
+	useEffect(() => {
+		setTimer(propsTimer);
+		return () => timer?.reset();
+	}, [propsTimer]);
+	useEffect(() => {
+		if (propsTimer) return;
+		if (typeof delay === "number") setTimer(new Timer(callbackEvent, delay));
+		return () => timer?.reset();
+	}, [delay, propsTimer]);
+	useEffect(() => () => timer?.reset(), [timer]);
+	return { timer };
+}
+
+//#endregion
+export { useTimer };
+//# sourceMappingURL=use-timer.js.map

package/dist/_internal/hooks/use-timer/use-timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-timer.js","names":[],"sources":["../../../../src/_internal/hooks/use-timer/use-timer.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { useEvent } from '../use-event';\n\nimport { Timer } from './timer';\n\nexport type UseTimerProps = {\n  callback?: () => void;\n  delay?: number | null;\n  isDisabled?: boolean;\n  timer?: Timer | null;\n};\n\nexport function useTimer(props: UseTimerProps = {}) {\n  const { callback, delay, isDisabled, timer: propsTimer = null } = props;\n\n  const callbackEvent = useEvent(() => callback?.());\n  const [timer, setTimer] = useState<Timer | null>(() => {\n    if (propsTimer) {\n      return propsTimer;\n    }\n\n    if (typeof delay === 'number') {\n      return new Timer(callbackEvent, delay);\n    }\n\n    return null;\n  });\n\n  if (isDisabled) {\n    timer?.reset();\n  } else {\n    timer?.resume();\n  }\n\n  useEffect(() => {\n    setTimer(propsTimer);\n    return () => timer?.reset();\n  }, [propsTimer]);\n\n  useEffect(() => {\n    if (propsTimer) return;\n\n    if (typeof delay === 'number') {\n      setTimer(new Timer(callbackEvent, delay));\n    }\n\n    return () => timer?.reset();\n  }, [delay, propsTimer]);\n\n  useEffect(() => () => timer?.reset(), [timer]);\n\n  return { timer } as const;\n}\n"],"mappings":";;;;;;AAaA,SAAgB,SAAS,QAAuB,EAAE,EAAE;CAClD,MAAM,EAAE,UAAU,OAAO,YAAY,OAAO,aAAa,SAAS;CAElE,MAAM,gBAAgB,eAAe,YAAY,CAAC;CAClD,MAAM,CAAC,OAAO,YAAY,eAA6B;AACrD,MAAI,WACF,QAAO;AAGT,MAAI,OAAO,UAAU,SACnB,QAAO,IAAI,MAAM,eAAe,MAAM;AAGxC,SAAO;GACP;AAEF,KAAI,WACF,QAAO,OAAO;KAEd,QAAO,QAAQ;AAGjB,iBAAgB;AACd,WAAS,WAAW;AACpB,eAAa,OAAO,OAAO;IAC1B,CAAC,WAAW,CAAC;AAEhB,iBAAgB;AACd,MAAI,WAAY;AAEhB,MAAI,OAAO,UAAU,SACnB,UAAS,IAAI,MAAM,eAAe,MAAM,CAAC;AAG3C,eAAa,OAAO,OAAO;IAC1B,CAAC,OAAO,WAAW,CAAC;AAEvB,uBAAsB,OAAO,OAAO,EAAE,CAAC,MAAM,CAAC;AAE9C,QAAO,EAAE,OAAO"}

package/dist/_internal/hooks/use-warn.js

@@ -0,0 +1,35 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { useEvent } from "./use-event.js";
+import { warn } from "../../utils/warnings.js";
+import { useRef } from "react";
+
+//#region src/_internal/hooks/use-warn.ts
+const GLOBAL_WARNED = /* @__PURE__ */ new Set();
+function useWarn(condition, params) {
+	const { once = true, key, args } = params;
+	const hasWarnedRef = useRef(false);
+	const execute = useEvent((condition, args) => {
+		if (condition) {
+			warn(...args);
+			return true;
+		}
+		return false;
+	});
+	if (once) {
+		const keyString = JSON.stringify(key);
+		if (GLOBAL_WARNED.has(keyString)) return;
+		if (execute(condition, args)) {
+			GLOBAL_WARNED.add(keyString);
+			return;
+		}
+	}
+	if (hasWarnedRef.current) return;
+	if (execute(condition, args)) {
+		hasWarnedRef.current = true;
+		return;
+	}
+}
+
+//#endregion
+export { useWarn };
+//# sourceMappingURL=use-warn.js.map

package/dist/_internal/hooks/use-warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-warn.js","names":[],"sources":["../../../src/_internal/hooks/use-warn.ts"],"sourcesContent":["import { useRef } from 'react';\n\nimport { warn } from '../../utils/warnings';\n\nimport { useEvent } from './use-event';\n\nconst GLOBAL_WARNED = new Set<string>();\n\nexport type WarnKey = string | unknown[];\nexport type WarnArgs = Parameters<typeof warn>;\nexport type WarnParameters<T extends WarnKey = WarnKey> = {\n  /**\n   * If true, the warning will only be shown once per session.\n   * If false, the warning will be shown once for a component instance.\n   *\n   * @default true\n   */\n  once?: boolean;\n  key?: T;\n  args: [...WarnArgs];\n};\n\nexport function useWarn<Condition, Key extends WarnKey>(\n  condition: Condition,\n  params: WarnParameters<Key>,\n) {\n  const { once = true, key, args } = params;\n\n  const hasWarnedRef = useRef(false);\n\n  const execute = useEvent((condition: Condition, args: WarnArgs) => {\n    if (condition) {\n      warn(...args);\n      return true;\n    }\n\n    return false;\n  });\n\n  if (once) {\n    const keyString = JSON.stringify(key);\n\n    if (GLOBAL_WARNED.has(keyString)) return;\n\n    if (execute(condition, args)) {\n      GLOBAL_WARNED.add(keyString);\n      return;\n    }\n  }\n\n  if (hasWarnedRef.current) return;\n\n  if (execute(condition, args)) {\n    hasWarnedRef.current = true;\n    return;\n  }\n}\n"],"mappings":";;;;;;AAMA,MAAM,gCAAgB,IAAI,KAAa;AAgBvC,SAAgB,QACd,WACA,QACA;CACA,MAAM,EAAE,OAAO,MAAM,KAAK,SAAS;CAEnC,MAAM,eAAe,OAAO,MAAM;CAElC,MAAM,UAAU,UAAU,WAAsB,SAAmB;AACjE,MAAI,WAAW;AACb,QAAK,GAAG,KAAK;AACb,UAAO;;AAGT,SAAO;GACP;AAEF,KAAI,MAAM;EACR,MAAM,YAAY,KAAK,UAAU,IAAI;AAErC,MAAI,cAAc,IAAI,UAAU,CAAE;AAElC,MAAI,QAAQ,WAAW,KAAK,EAAE;AAC5B,iBAAc,IAAI,UAAU;AAC5B;;;AAIJ,KAAI,aAAa,QAAS;AAE1B,KAAI,QAAQ,WAAW,KAAK,EAAE;AAC5B,eAAa,UAAU;AACvB"}

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,8 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __require };

package/dist/chunks/cacheKey.js

@@ -0,0 +1,71 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { extractLocalPredefinedStates, extractPredefinedStateRefs } from "../states/index.js";
+
+//#region src/tasty/chunks/cacheKey.ts
+/**
+* Chunk-specific cache key generation.
+*
+* Generates cache keys that only include styles relevant to a specific chunk,
+* enabling more granular caching and reuse.
+*
+* Enhanced to support predefined states:
+* - Global predefined states don't affect cache keys (constant across app)
+* - Local predefined states only affect cache keys if referenced in the chunk
+*/
+/**
+* Recursively serialize a value with sorted keys for stable output.
+* This ensures that {a: 1, b: 2} and {b: 2, a: 1} produce the same string.
+*/
+function stableStringify(value) {
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (typeof value !== "object") return JSON.stringify(value);
+	if (Array.isArray(value)) return "[" + value.map(stableStringify).join(",") + "]";
+	const obj = value;
+	const sortedKeys = Object.keys(obj).sort();
+	const parts = [];
+	for (const key of sortedKeys) if (obj[key] !== void 0) parts.push(`${JSON.stringify(key)}:${stableStringify(obj[key])}`);
+	return "{" + parts.join(",") + "}";
+}
+/**
+* Generate a cache key for a specific chunk.
+*
+* Only includes the styles that belong to this chunk, allowing
+* chunks to be cached independently.
+*
+* Also includes relevant local predefined states that are referenced
+* by this chunk's styles.
+*
+* @param styles - The full styles object
+* @param chunkName - Name of the chunk
+* @param styleKeys - Keys of styles belonging to this chunk
+* @returns A stable cache key string
+*/
+function generateChunkCacheKey(styles, chunkName, styleKeys) {
+	const parts = [chunkName];
+	const sortedKeys = styleKeys.slice().sort();
+	let chunkStylesStr = "";
+	for (const key of sortedKeys) {
+		const value = styles[key];
+		if (value !== void 0) {
+			const serialized = stableStringify(value);
+			parts.push(`${key}:${serialized}`);
+			chunkStylesStr += serialized;
+		}
+	}
+	const localStates = extractLocalPredefinedStates(styles);
+	if (Object.keys(localStates).length > 0) {
+		const referencedStates = extractPredefinedStateRefs(chunkStylesStr);
+		const relevantLocalStates = [];
+		for (const stateName of referencedStates) if (localStates[stateName]) relevantLocalStates.push(`${stateName}=${localStates[stateName]}`);
+		if (relevantLocalStates.length > 0) {
+			relevantLocalStates.sort();
+			parts.unshift(`[states:${relevantLocalStates.join("|")}]`);
+		}
+	}
+	return parts.join("\0");
+}
+
+//#endregion
+export { generateChunkCacheKey };
+//# sourceMappingURL=cacheKey.js.map

package/dist/chunks/cacheKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/tasty/chunks/cacheKey.ts"],"sourcesContent":["/**\n * Chunk-specific cache key generation.\n *\n * Generates cache keys that only include styles relevant to a specific chunk,\n * enabling more granular caching and reuse.\n *\n * Enhanced to support predefined states:\n * - Global predefined states don't affect cache keys (constant across app)\n * - Local predefined states only affect cache keys if referenced in the chunk\n */\n\nimport {\n  extractLocalPredefinedStates,\n  extractPredefinedStateRefs,\n} from '../states';\nimport { Styles } from '../styles/types';\n\n/**\n * Recursively serialize a value with sorted keys for stable output.\n * This ensures that {a: 1, b: 2} and {b: 2, a: 1} produce the same string.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return 'undefined';\n  }\n  if (typeof value !== 'object') {\n    return JSON.stringify(value);\n  }\n  if (Array.isArray(value)) {\n    return '[' + value.map(stableStringify).join(',') + ']';\n  }\n  // Object: sort keys for stable order\n  const obj = value as Record<string, unknown>;\n  const sortedKeys = Object.keys(obj).sort();\n  const parts: string[] = [];\n  for (const key of sortedKeys) {\n    if (obj[key] !== undefined) {\n      parts.push(`${JSON.stringify(key)}:${stableStringify(obj[key])}`);\n    }\n  }\n  return '{' + parts.join(',') + '}';\n}\n\n/**\n * Generate a cache key for a specific chunk.\n *\n * Only includes the styles that belong to this chunk, allowing\n * chunks to be cached independently.\n *\n * Also includes relevant local predefined states that are referenced\n * by this chunk's styles.\n *\n * @param styles - The full styles object\n * @param chunkName - Name of the chunk\n * @param styleKeys - Keys of styles belonging to this chunk\n * @returns A stable cache key string\n */\nexport function generateChunkCacheKey(\n  styles: Styles,\n  chunkName: string,\n  styleKeys: string[],\n): string {\n  // Start with chunk name for namespace separation\n  const parts: string[] = [chunkName];\n\n  // Sort keys for stable ordering\n  const sortedKeys = styleKeys.slice().sort();\n\n  // Build the chunk-specific styles string for predefined state detection\n  let chunkStylesStr = '';\n\n  for (const key of sortedKeys) {\n    const value = styles[key];\n    if (value !== undefined) {\n      // Use stable stringify for consistent serialization regardless of key order\n      const serialized = stableStringify(value);\n      parts.push(`${key}:${serialized}`);\n      chunkStylesStr += serialized;\n    }\n  }\n\n  // Extract local predefined states from the full styles object\n  const localStates = extractLocalPredefinedStates(styles);\n\n  // Only include local predefined states that are actually referenced in this chunk\n  if (Object.keys(localStates).length > 0) {\n    const referencedStates = extractPredefinedStateRefs(chunkStylesStr);\n    const relevantLocalStates: string[] = [];\n\n    for (const stateName of referencedStates) {\n      if (localStates[stateName]) {\n        relevantLocalStates.push(`${stateName}=${localStates[stateName]}`);\n      }\n    }\n\n    // Add relevant local states to the cache key (sorted for stability)\n    if (relevantLocalStates.length > 0) {\n      relevantLocalStates.sort();\n      parts.unshift(`[states:${relevantLocalStates.join('|')}]`);\n    }\n  }\n\n  // Use null character as separator (safe, not in JSON output)\n  return parts.join('\\0');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,SAAS,gBAAgB,OAAwB;AAC/C,KAAI,UAAU,KACZ,QAAO;AAET,KAAI,UAAU,OACZ,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,KAAK,UAAU,MAAM;AAE9B,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,MAAM,IAAI,gBAAgB,CAAC,KAAK,IAAI,GAAG;CAGtD,MAAM,MAAM;CACZ,MAAM,aAAa,OAAO,KAAK,IAAI,CAAC,MAAM;CAC1C,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,OAAO,WAChB,KAAI,IAAI,SAAS,OACf,OAAM,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,GAAG,gBAAgB,IAAI,KAAK,GAAG;AAGrE,QAAO,MAAM,MAAM,KAAK,IAAI,GAAG;;;;;;;;;;;;;;;;AAiBjC,SAAgB,sBACd,QACA,WACA,WACQ;CAER,MAAM,QAAkB,CAAC,UAAU;CAGnC,MAAM,aAAa,UAAU,OAAO,CAAC,MAAM;CAG3C,IAAI,iBAAiB;AAErB,MAAK,MAAM,OAAO,YAAY;EAC5B,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,QAAW;GAEvB,MAAM,aAAa,gBAAgB,MAAM;AACzC,SAAM,KAAK,GAAG,IAAI,GAAG,aAAa;AAClC,qBAAkB;;;CAKtB,MAAM,cAAc,6BAA6B,OAAO;AAGxD,KAAI,OAAO,KAAK,YAAY,CAAC,SAAS,GAAG;EACvC,MAAM,mBAAmB,2BAA2B,eAAe;EACnE,MAAM,sBAAgC,EAAE;AAExC,OAAK,MAAM,aAAa,iBACtB,KAAI,YAAY,WACd,qBAAoB,KAAK,GAAG,UAAU,GAAG,YAAY,aAAa;AAKtE,MAAI,oBAAoB,SAAS,GAAG;AAClC,uBAAoB,MAAM;AAC1B,SAAM,QAAQ,WAAW,oBAAoB,KAAK,IAAI,CAAC,GAAG;;;AAK9D,QAAO,MAAM,KAAK,KAAK"}