@tarsis/toolkit 0.6.5 → 0.7.0

package/dist/utils-BGgmkNY4.cjs

@@ -0,0 +1,330 @@
+require("./chunk-CKQMccvm.cjs");
+const require_animation = require("./animation-BauloIgQ.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/utils/collections/BoundedMap.ts
+/**
+* LRU map with optional TTL. Evicts least-recently-used entries
+* when maxSize is exceeded, and expired entries on access.
+*/
+function createBoundedMap(options) {
+	const store = /* @__PURE__ */ new Map();
+	const maxSize = options.maxSize;
+	const ttlMs = options.ttlMs ?? null;
+	function evictExpired() {
+		if (ttlMs === null) return;
+		const now = Date.now();
+		for (const [key, entry] of store) if (entry.expiresAt !== null && entry.expiresAt <= now) store.delete(key);
+	}
+	function evictOverflow() {
+		while (store.size > maxSize) {
+			const oldestKey = store.keys().next().value;
+			if (oldestKey === void 0) break;
+			store.delete(oldestKey);
+		}
+	}
+	return {
+		get(key) {
+			const entry = store.get(key);
+			if (!entry) return void 0;
+			if (entry.expiresAt !== null && entry.expiresAt <= Date.now()) {
+				store.delete(key);
+				return;
+			}
+			store.delete(key);
+			store.set(key, entry);
+			return entry.value;
+		},
+		has(key) {
+			return this.get(key) !== void 0;
+		},
+		set(key, value) {
+			const expiresAt = ttlMs === null ? null : Date.now() + ttlMs;
+			if (store.has(key)) store.delete(key);
+			store.set(key, {
+				value,
+				expiresAt
+			});
+			evictExpired();
+			evictOverflow();
+		},
+		delete(key) {
+			return store.delete(key);
+		},
+		clear() {
+			store.clear();
+		},
+		get size() {
+			evictExpired();
+			return store.size;
+		}
+	};
+}
+//#endregion
+//#region src/utils/ui/chain.tsx
+var chain = (...elements) => {
+	return elements.map((element, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: element }), index !== elements.length - 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: " • " })] }, index));
+};
+//#endregion
+//#region src/utils/error.ts
+/**
+* Normalises unknown thrown values into proper Error instances.
+* Preserves original Error objects; wraps strings and unknowns.
+*/
+function normalizeError(err) {
+	if (err instanceof Error) return err;
+	if (typeof err === "string") return new Error(err);
+	return /* @__PURE__ */ new Error("Unknown error");
+}
+//#endregion
+//#region src/utils/format.ts
+/**
+* Formats seconds into MM:SS display string.
+*/
+function formatDuration(totalSeconds) {
+	return `${Math.floor(totalSeconds / 60)}:${(totalSeconds % 60).toString().padStart(2, "0")}`;
+}
+/**
+* Formats milliseconds into MM:SS.ms display string.
+* Useful for timers and stopwatches.
+*/
+function formatTime(totalMs) {
+	const totalSeconds = Math.floor(totalMs / 1e3);
+	const minutes = Math.floor(totalSeconds / 60);
+	const seconds = totalSeconds % 60;
+	const ms = Math.floor(totalMs % 1e3 / 10);
+	return `${minutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}.${ms.toString().padStart(2, "0")}`;
+}
+//#endregion
+//#region src/utils/math.ts
+/**
+* Math utility functions for animations and interactions
+*/
+function distance(x1, x2, y1, y2) {
+	const a = x1 - x2;
+	const b = y1 - y2;
+	return Math.hypot(a, b);
+}
+function lineEq(y2, y1, x2, x1, currentVal) {
+	const m = (y2 - y1) / (x2 - x1);
+	const b = y1 - m * x1;
+	return m * currentVal + b;
+}
+function lerp(a, b, n) {
+	return (1 - n) * a + n * b;
+}
+//#endregion
+//#region src/utils/presence.ts
+/**
+* Create standardized enter/exit motion variants using toolkit tokens.
+* Returns `{ initial, animate, exit }` for framer-motion / motion.
+*/
+var createPresenceVariants = (enter, exit, duration = require_animation.animationDuration.medium, easingCurve = require_animation.easing.easeOutCubic) => ({
+	initial: exit,
+	animate: {
+		...enter,
+		transition: {
+			duration,
+			ease: easingCurve
+		}
+	},
+	exit: {
+		...exit,
+		transition: {
+			duration,
+			ease: easingCurve
+		}
+	}
+});
+var fadePresence = createPresenceVariants({ opacity: 1 }, { opacity: 0 }, require_animation.animationDuration.fast);
+var slideUpPresence = createPresenceVariants({
+	opacity: 1,
+	y: 0
+}, {
+	opacity: 0,
+	y: 8
+});
+var scalePresence = createPresenceVariants({
+	opacity: 1,
+	scale: 1
+}, {
+	opacity: 0,
+	scale: .95
+}, require_animation.animationDuration.short);
+var slideDownPresence = createPresenceVariants({
+	opacity: 1,
+	y: 0
+}, {
+	opacity: 0,
+	y: -8
+});
+//#endregion
+//#region src/utils/promise.ts
+function delay(ms) {
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			resolve(void 0);
+		}, ms);
+	});
+}
+var wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//#endregion
+//#region src/utils/svg.ts
+function getPath(x, smoothing) {
+	const points = [
+		[2, 2],
+		[12 - x, 12 + x],
+		[22, 22]
+	];
+	const calculateControlPoint = (current, previous, next, reverse) => {
+		const p = previous || current;
+		const n = next || current;
+		const o = {
+			length: Math.sqrt(Math.pow(n[0] - p[0], 2) + Math.pow(n[1] - p[1], 2)),
+			angle: Math.atan2(n[1] - p[1], n[0] - p[0])
+		};
+		const angle = o.angle + (reverse ? Math.PI : 0);
+		const length = o.length * smoothing;
+		return [current[0] + Math.cos(angle) * length, current[1] + Math.sin(angle) * length];
+	};
+	return points.reduce((acc, point, i, a) => {
+		if (i === 0) return `M ${point[0]},${point[1]}`;
+		const previous = a[i - 1];
+		const cp1 = calculateControlPoint(previous, a[i - 2], point, false);
+		const cp2 = calculateControlPoint(point, previous, a[i + 1], true);
+		return `${acc} C ${cp1[0]},${cp1[1]} ${cp2[0]},${cp2[1]} ${point[0]},${point[1]}`;
+	}, "");
+}
+//#endregion
+//#region src/utils/viewTransition.ts
+/**
+* Wrapper around the View Transitions API.
+* Uses `document.startViewTransition` when available (Chrome 111+, Safari 18+),
+* falls back to calling the callback directly on unsupported browsers.
+*/
+var startViewTransition = (callback) => {
+	const doc = document;
+	if (typeof doc.startViewTransition === "function") return doc.startViewTransition(callback);
+	const result = callback();
+	const resolved = result instanceof Promise ? result : Promise.resolve();
+	return {
+		finished: resolved,
+		ready: Promise.resolve(),
+		updateCallbackDone: resolved
+	};
+};
+/**
+* Check if the View Transitions API is supported in the current browser.
+*/
+var supportsViewTransitions = () => {
+	return typeof document.startViewTransition === "function";
+};
+//#endregion
+Object.defineProperty(exports, "chain", {
+	enumerable: true,
+	get: function() {
+		return chain;
+	}
+});
+Object.defineProperty(exports, "createBoundedMap", {
+	enumerable: true,
+	get: function() {
+		return createBoundedMap;
+	}
+});
+Object.defineProperty(exports, "createPresenceVariants", {
+	enumerable: true,
+	get: function() {
+		return createPresenceVariants;
+	}
+});
+Object.defineProperty(exports, "delay", {
+	enumerable: true,
+	get: function() {
+		return delay;
+	}
+});
+Object.defineProperty(exports, "distance", {
+	enumerable: true,
+	get: function() {
+		return distance;
+	}
+});
+Object.defineProperty(exports, "fadePresence", {
+	enumerable: true,
+	get: function() {
+		return fadePresence;
+	}
+});
+Object.defineProperty(exports, "formatDuration", {
+	enumerable: true,
+	get: function() {
+		return formatDuration;
+	}
+});
+Object.defineProperty(exports, "formatTime", {
+	enumerable: true,
+	get: function() {
+		return formatTime;
+	}
+});
+Object.defineProperty(exports, "getPath", {
+	enumerable: true,
+	get: function() {
+		return getPath;
+	}
+});
+Object.defineProperty(exports, "lerp", {
+	enumerable: true,
+	get: function() {
+		return lerp;
+	}
+});
+Object.defineProperty(exports, "lineEq", {
+	enumerable: true,
+	get: function() {
+		return lineEq;
+	}
+});
+Object.defineProperty(exports, "normalizeError", {
+	enumerable: true,
+	get: function() {
+		return normalizeError;
+	}
+});
+Object.defineProperty(exports, "scalePresence", {
+	enumerable: true,
+	get: function() {
+		return scalePresence;
+	}
+});
+Object.defineProperty(exports, "slideDownPresence", {
+	enumerable: true,
+	get: function() {
+		return slideDownPresence;
+	}
+});
+Object.defineProperty(exports, "slideUpPresence", {
+	enumerable: true,
+	get: function() {
+		return slideUpPresence;
+	}
+});
+Object.defineProperty(exports, "startViewTransition", {
+	enumerable: true,
+	get: function() {
+		return startViewTransition;
+	}
+});
+Object.defineProperty(exports, "supportsViewTransitions", {
+	enumerable: true,
+	get: function() {
+		return supportsViewTransitions;
+	}
+});
+Object.defineProperty(exports, "wait", {
+	enumerable: true,
+	get: function() {
+		return wait;
+	}
+});

package/dist/utils-Dw5El_3G.js

@@ -0,0 +1,222 @@
+import { n as easing, t as animationDuration } from "./animation-BFpILbqb.js";
+import { Fragment } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/utils/collections/BoundedMap.ts
+/**
+* LRU map with optional TTL. Evicts least-recently-used entries
+* when maxSize is exceeded, and expired entries on access.
+*/
+function createBoundedMap(options) {
+	const store = /* @__PURE__ */ new Map();
+	const maxSize = options.maxSize;
+	const ttlMs = options.ttlMs ?? null;
+	function evictExpired() {
+		if (ttlMs === null) return;
+		const now = Date.now();
+		for (const [key, entry] of store) if (entry.expiresAt !== null && entry.expiresAt <= now) store.delete(key);
+	}
+	function evictOverflow() {
+		while (store.size > maxSize) {
+			const oldestKey = store.keys().next().value;
+			if (oldestKey === void 0) break;
+			store.delete(oldestKey);
+		}
+	}
+	return {
+		get(key) {
+			const entry = store.get(key);
+			if (!entry) return void 0;
+			if (entry.expiresAt !== null && entry.expiresAt <= Date.now()) {
+				store.delete(key);
+				return;
+			}
+			store.delete(key);
+			store.set(key, entry);
+			return entry.value;
+		},
+		has(key) {
+			return this.get(key) !== void 0;
+		},
+		set(key, value) {
+			const expiresAt = ttlMs === null ? null : Date.now() + ttlMs;
+			if (store.has(key)) store.delete(key);
+			store.set(key, {
+				value,
+				expiresAt
+			});
+			evictExpired();
+			evictOverflow();
+		},
+		delete(key) {
+			return store.delete(key);
+		},
+		clear() {
+			store.clear();
+		},
+		get size() {
+			evictExpired();
+			return store.size;
+		}
+	};
+}
+//#endregion
+//#region src/utils/ui/chain.tsx
+var chain = (...elements) => {
+	return elements.map((element, index) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", { children: element }), index !== elements.length - 1 && /* @__PURE__ */ jsx("span", { children: " • " })] }, index));
+};
+//#endregion
+//#region src/utils/error.ts
+/**
+* Normalises unknown thrown values into proper Error instances.
+* Preserves original Error objects; wraps strings and unknowns.
+*/
+function normalizeError(err) {
+	if (err instanceof Error) return err;
+	if (typeof err === "string") return new Error(err);
+	return /* @__PURE__ */ new Error("Unknown error");
+}
+//#endregion
+//#region src/utils/format.ts
+/**
+* Formats seconds into MM:SS display string.
+*/
+function formatDuration(totalSeconds) {
+	return `${Math.floor(totalSeconds / 60)}:${(totalSeconds % 60).toString().padStart(2, "0")}`;
+}
+/**
+* Formats milliseconds into MM:SS.ms display string.
+* Useful for timers and stopwatches.
+*/
+function formatTime(totalMs) {
+	const totalSeconds = Math.floor(totalMs / 1e3);
+	const minutes = Math.floor(totalSeconds / 60);
+	const seconds = totalSeconds % 60;
+	const ms = Math.floor(totalMs % 1e3 / 10);
+	return `${minutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}.${ms.toString().padStart(2, "0")}`;
+}
+//#endregion
+//#region src/utils/math.ts
+/**
+* Math utility functions for animations and interactions
+*/
+function distance(x1, x2, y1, y2) {
+	const a = x1 - x2;
+	const b = y1 - y2;
+	return Math.hypot(a, b);
+}
+function lineEq(y2, y1, x2, x1, currentVal) {
+	const m = (y2 - y1) / (x2 - x1);
+	const b = y1 - m * x1;
+	return m * currentVal + b;
+}
+function lerp(a, b, n) {
+	return (1 - n) * a + n * b;
+}
+//#endregion
+//#region src/utils/presence.ts
+/**
+* Create standardized enter/exit motion variants using toolkit tokens.
+* Returns `{ initial, animate, exit }` for framer-motion / motion.
+*/
+var createPresenceVariants = (enter, exit, duration = animationDuration.medium, easingCurve = easing.easeOutCubic) => ({
+	initial: exit,
+	animate: {
+		...enter,
+		transition: {
+			duration,
+			ease: easingCurve
+		}
+	},
+	exit: {
+		...exit,
+		transition: {
+			duration,
+			ease: easingCurve
+		}
+	}
+});
+var fadePresence = createPresenceVariants({ opacity: 1 }, { opacity: 0 }, animationDuration.fast);
+var slideUpPresence = createPresenceVariants({
+	opacity: 1,
+	y: 0
+}, {
+	opacity: 0,
+	y: 8
+});
+var scalePresence = createPresenceVariants({
+	opacity: 1,
+	scale: 1
+}, {
+	opacity: 0,
+	scale: .95
+}, animationDuration.short);
+var slideDownPresence = createPresenceVariants({
+	opacity: 1,
+	y: 0
+}, {
+	opacity: 0,
+	y: -8
+});
+//#endregion
+//#region src/utils/promise.ts
+function delay(ms) {
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			resolve(void 0);
+		}, ms);
+	});
+}
+var wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//#endregion
+//#region src/utils/svg.ts
+function getPath(x, smoothing) {
+	const points = [
+		[2, 2],
+		[12 - x, 12 + x],
+		[22, 22]
+	];
+	const calculateControlPoint = (current, previous, next, reverse) => {
+		const p = previous || current;
+		const n = next || current;
+		const o = {
+			length: Math.sqrt(Math.pow(n[0] - p[0], 2) + Math.pow(n[1] - p[1], 2)),
+			angle: Math.atan2(n[1] - p[1], n[0] - p[0])
+		};
+		const angle = o.angle + (reverse ? Math.PI : 0);
+		const length = o.length * smoothing;
+		return [current[0] + Math.cos(angle) * length, current[1] + Math.sin(angle) * length];
+	};
+	return points.reduce((acc, point, i, a) => {
+		if (i === 0) return `M ${point[0]},${point[1]}`;
+		const previous = a[i - 1];
+		const cp1 = calculateControlPoint(previous, a[i - 2], point, false);
+		const cp2 = calculateControlPoint(point, previous, a[i + 1], true);
+		return `${acc} C ${cp1[0]},${cp1[1]} ${cp2[0]},${cp2[1]} ${point[0]},${point[1]}`;
+	}, "");
+}
+//#endregion
+//#region src/utils/viewTransition.ts
+/**
+* Wrapper around the View Transitions API.
+* Uses `document.startViewTransition` when available (Chrome 111+, Safari 18+),
+* falls back to calling the callback directly on unsupported browsers.
+*/
+var startViewTransition = (callback) => {
+	const doc = document;
+	if (typeof doc.startViewTransition === "function") return doc.startViewTransition(callback);
+	const result = callback();
+	const resolved = result instanceof Promise ? result : Promise.resolve();
+	return {
+		finished: resolved,
+		ready: Promise.resolve(),
+		updateCallbackDone: resolved
+	};
+};
+/**
+* Check if the View Transitions API is supported in the current browser.
+*/
+var supportsViewTransitions = () => {
+	return typeof document.startViewTransition === "function";
+};
+//#endregion
+export { chain as _, wait as a, scalePresence as c, distance as d, lerp as f, normalizeError as g, formatTime as h, delay as i, slideDownPresence as l, formatDuration as m, supportsViewTransitions as n, createPresenceVariants as o, lineEq as p, getPath as r, fadePresence as s, startViewTransition as t, slideUpPresence as u, createBoundedMap as v };

package/dist/utils.cjs

@@ -1,38 +1,44 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const svg = require('./svg-BT_esDTZ.cjs');
-
-
-
-exports.BaseLogger = svg.BaseLogger;
-exports.animationLogger = svg.animationLogger;
-exports.apiLogger = svg.apiLogger;
-exports.chain = svg.chain;
-exports.clearSession = svg.clearSession;
-exports.componentLogger = svg.componentLogger;
-exports.delay = svg.delay;
-exports.distance = svg.distance;
-exports.eventLogger = svg.eventLogger;
-exports.getCurrentLogLevel = svg.getCurrentLogLevel;
-exports.getPath = svg.getPath;
-exports.hookLogger = svg.hookLogger;
-exports.is = svg.is;
-exports.isDebugEnabled = svg.isDebugEnabled;
-exports.isNonNullable = svg.isNonNullable;
-exports.keys = svg.keys;
-exports.lerp = svg.lerp;
-exports.lineEq = svg.lineEq;
-exports.logger = svg.logger;
-exports.move = svg.move;
-exports.noop = svg.noop;
-exports.notReachable = svg.notReachable;
-exports.setLogLevel = svg.setLogLevel;
-exports.setRequestId = svg.setRequestId;
-exports.setSessionId = svg.setSessionId;
-exports.storageLogger = svg.storageLogger;
-exports.times = svg.times;
-exports.utilsLogger = svg.utilsLogger;
-exports.values = svg.values;
-exports.wait = svg.wait;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_values = require("./values-BqSJ0h9o.cjs");
+const require_utils = require("./utils-BGgmkNY4.cjs");
+exports.BaseLogger = require_values.BaseLogger;
+exports.animationLogger = require_values.animationLogger;
+exports.apiLogger = require_values.apiLogger;
+exports.chain = require_utils.chain;
+exports.clearSession = require_values.clearSession;
+exports.componentLogger = require_values.componentLogger;
+exports.createBoundedMap = require_utils.createBoundedMap;
+exports.createPresenceVariants = require_utils.createPresenceVariants;
+exports.delay = require_utils.delay;
+exports.distance = require_utils.distance;
+exports.eventLogger = require_values.eventLogger;
+exports.fadePresence = require_utils.fadePresence;
+exports.formatDuration = require_utils.formatDuration;
+exports.formatTime = require_utils.formatTime;
+exports.getCurrentLogLevel = require_values.getCurrentLogLevel;
+exports.getPath = require_utils.getPath;
+exports.hookLogger = require_values.hookLogger;
+exports.is = require_values.is;
+exports.isDebugEnabled = require_values.isDebugEnabled;
+exports.isNonNullable = require_values.isNonNullable;
+exports.keys = require_values.keys;
+exports.lerp = require_utils.lerp;
+exports.lineEq = require_utils.lineEq;
+exports.logger = require_values.logger;
+exports.move = require_values.move;
+exports.noop = require_values.noop;
+exports.normalizeError = require_utils.normalizeError;
+exports.notReachable = require_values.notReachable;
+exports.scalePresence = require_utils.scalePresence;
+exports.setLogLevel = require_values.setLogLevel;
+exports.setRequestId = require_values.setRequestId;
+exports.setSessionId = require_values.setSessionId;
+exports.slideDownPresence = require_utils.slideDownPresence;
+exports.slideUpPresence = require_utils.slideUpPresence;
+exports.startViewTransition = require_utils.startViewTransition;
+exports.storageLogger = require_values.storageLogger;
+exports.supportsViewTransitions = require_utils.supportsViewTransitions;
+exports.times = require_values.times;
+exports.utilsLogger = require_values.utilsLogger;
+exports.values = require_values.values;
+exports.wait = require_utils.wait;