@resq-sw/helpers 0.1.0

package/lib/browser/platform.js

@@ -0,0 +1,272 @@
+//#region src/browser/platform.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+* Detects if the current user agent is an iOS device (iPad, iPhone, iPod).
+*
+* @returns {boolean} True if the platform is iOS, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @example
+* ```ts
+* if (isIOS()) { console.log('Running on iOS'); }
+* ```
+*/
+const isIOS = () => /iPad|iPhone|iPod/.test(navigator.userAgent) && !globalThis.window.MSStream;
+/**
+* Detects if the current user agent is an Android device.
+*
+* @returns {boolean} True if the platform is Android, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @example
+* ```ts
+* if (isAndroid()) { console.log('Running on Android'); }
+* ```
+*/
+const isAndroid = () => /android/i.test(navigator.userAgent);
+/**
+* Detects if the current user agent is a macOS device.
+*
+* @returns {boolean} True if the platform is macOS, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @example
+* ```ts
+* if (isMacOS()) { console.log('Running on macOS'); }
+* ```
+*/
+const isMacOS = () => /Macintosh|Mac|Mac OS|MacIntel|MacPPC|Mac68K/gi.test(navigator.userAgent);
+/**
+* Detects if the current user agent is a Windows device.
+*
+* @returns {boolean} True if the platform is Windows, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @example
+* ```ts
+* if (isWindows()) { console.log('Running on Windows'); }
+* ```
+*/
+const isWindows = () => /Win32|Win64|Windows|Windows NT|WinCE/gi.test(navigator.userAgent);
+/**
+* Detects if the current user agent is Chrome OS.
+*
+* @returns {boolean} True if the platform is Chrome OS, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @example
+* ```ts
+* if (isChromeOS()) { console.log('Running on Chrome OS'); }
+* ```
+*/
+const isChromeOS = () => /CrOS/gi.test(navigator.userAgent);
+/**
+* Retrieves the browser name based on the user agent string.
+*
+* @returns {string} The browser name: 'edge', 'chrome', 'firefox', 'safari', 'opera', 'android', 'iphone', or 'unknown'.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent
+* @throws {TypeError} Throws if navigator.userAgent is not accessible.
+* @example
+* ```ts
+* const browser = getBrowser(); // 'chrome', 'firefox', etc.
+* ```
+*/
+const getBrowser = () => {
+	const { userAgent } = navigator;
+	if (/edg/i.test(userAgent)) return "edge";
+	if (/chrome|chromium|crios/i.test(userAgent)) return "chrome";
+	if (/firefox|fxios/i.test(userAgent)) return "firefox";
+	if (/safari/i.test(userAgent)) return "safari";
+	if (/opr\//i.test(userAgent)) return "opera";
+	if (/android/i.test(userAgent)) return "android";
+	if (/iphone/i.test(userAgent)) return "iphone";
+	return "unknown";
+};
+/**
+* Determines the device platform as a string: 'ios', 'android', 'macos', 'chromeos', 'windows', or 'unknown'.
+*
+* @returns {string} The detected platform.
+* @see isIOS
+* @see isAndroid
+* @see isMacOS
+* @see isChromeOS
+* @see isWindows
+* @example
+* ```ts
+* const platform = getPlatform(); // 'android', 'ios', etc.
+* ```
+*/
+const getPlatform = () => {
+	if (isIOS()) return "ios";
+	if (isAndroid()) return "android";
+	if (isMacOS()) return "macos";
+	if (isChromeOS()) return "chromeos";
+	if (isWindows()) return "windows";
+	return "unknown";
+};
+/**
+* Checks if the current device has a touchscreen capability.
+*
+* @returns {boolean} True if touch screen is supported, otherwise false.
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/maxTouchPoints
+* @see https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia
+* @example
+* ```ts
+* if (isTouchScreen()) { console.log('Device supports touch.'); }
+* ```
+*/
+const isTouchScreen = () => {
+	return navigator.maxTouchPoints && navigator.maxTouchPoints > 0 || globalThis.window.matchMedia?.("(any-pointer:coarse)").matches;
+};
+/**
+* Determines if the current browser is Google Chrome.
+*
+* @returns {boolean} True if Chrome, otherwise false.
+* @see getBrowser
+*/
+const isChrome = () => getBrowser() === "chrome";
+/**
+* Determines if the current browser is Mozilla Firefox.
+*
+* @returns {boolean} True if Firefox, otherwise false.
+* @see getBrowser
+*/
+const isFirefox = () => getBrowser() === "firefox";
+/**
+* Determines if the current browser is Safari.
+*
+* @returns {boolean} True if Safari, otherwise false.
+* @see getBrowser
+*/
+const isSafari = () => getBrowser() === "safari";
+/**
+* Determines if the current browser is Opera.
+*
+* @returns {boolean} True if Opera, otherwise false.
+* @see getBrowser
+*/
+const isOpera = () => getBrowser() === "opera";
+/**
+* Determines if the current browser is Microsoft Edge.
+*
+* @returns {boolean} True if Edge, otherwise false.
+* @see getBrowser
+*/
+const isEdge = () => getBrowser() === "edge";
+/**
+* Detects Safari running on iOS devices.
+*
+* @returns {boolean} True if iOS Safari, otherwise false.
+* @see isIOS
+* @see isSafari
+*/
+const isIOSSafari = () => getBrowser() === "safari" && isIOS();
+/**
+* Detects Chrome running on iOS devices.
+*
+* @returns {boolean} True if iOS Chrome, otherwise false.
+* @see isIOS
+* @see isChrome
+*/
+const isIOSChrome = () => getBrowser() === "chrome" && isIOS();
+/**
+* Detects Chrome running on Android devices.
+*
+* @returns {boolean} True if Android Chrome, otherwise false.
+* @see isAndroid
+* @see isChrome
+*/
+const isAndroidChrome = () => getBrowser() === "chrome" && isAndroid();
+/**
+* Detects Chrome running on macOS devices.
+*
+* @returns {boolean} True if macOS Chrome, otherwise false.
+* @see isMacOS
+* @see isChrome
+*/
+const isMacOSChrome = () => getBrowser() === "chrome" && isMacOS();
+/**
+* Detects Chrome running on Windows devices.
+*
+* @returns {boolean} True if Windows Chrome, otherwise false.
+* @see isWindows
+* @see isChrome
+*/
+const isWindowsChrome = () => getBrowser() === "chrome" && isWindows();
+/**
+* Detects Firefox running on iOS devices.
+*
+* @returns {boolean} True if iOS Firefox, otherwise false.
+* @see isIOS
+* @see isFirefox
+*/
+const isIOSFirefox = () => getBrowser() === "firefox" && isIOS();
+/**
+* Detects Firefox running on Android devices.
+*
+* @returns {boolean} True if Android Firefox, otherwise false.
+* @see isAndroid
+* @see isFirefox
+*/
+const isAndroidFirefox = () => getBrowser() === "firefox" && isAndroid();
+/**
+* Detects Edge running on iOS devices.
+*
+* @returns {boolean} True if iOS Edge, otherwise false.
+* @see isIOS
+* @see isEdge
+*/
+const isIOSEdge = () => getBrowser() === "edge" && isIOS();
+/**
+* Detects Edge running on Android devices.
+*
+* @returns {boolean} True if Android Edge, otherwise false.
+* @see isAndroid
+* @see isEdge
+*/
+const isAndroidEdge = () => getBrowser() === "edge" && isAndroid();
+/**
+* Detects Edge running on macOS devices.
+*
+* @returns {boolean} True if macOS Edge, otherwise false.
+* @see isMacOS
+* @see isEdge
+*/
+const isMacOSEdge = () => getBrowser() === "edge" && isMacOS();
+/**
+* Detects Edge running on Windows devices.
+*
+* @returns {boolean} True if Windows Edge, otherwise false.
+* @see isWindows
+* @see isEdge
+*/
+const isWindowsEdge = () => getBrowser() === "edge" && isWindows();
+/**
+* Detects Opera running on iOS devices.
+*
+* @returns {boolean} True if iOS Opera, otherwise false.
+* @see isIOS
+* @see isOpera
+*/
+const isIOSOpera = () => getBrowser() === "opera" && isIOS();
+/**
+* Detects Opera running on Android devices.
+*
+* @returns {boolean} True if Android Opera, otherwise false.
+* @see isAndroid
+* @see isOpera
+*/
+const isAndroidOpera = () => getBrowser() === "opera" && isAndroid();
+//#endregion
+export { getBrowser, getPlatform, isAndroid, isAndroidChrome, isAndroidEdge, isAndroidFirefox, isAndroidOpera, isChrome, isChromeOS, isEdge, isFirefox, isIOS, isIOSChrome, isIOSEdge, isIOSFirefox, isIOSOpera, isIOSSafari, isMacOS, isMacOSChrome, isMacOSEdge, isOpera, isSafari, isTouchScreen, isWindows, isWindowsChrome, isWindowsEdge };
+
+//# sourceMappingURL=platform.js.map

package/lib/browser/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","names":[],"sources":["../../src/browser/platform.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Detects if the current user agent is an iOS device (iPad, iPhone, iPod).\n *\n * @returns {boolean} True if the platform is iOS, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @example\n * ```ts\n * if (isIOS()) { console.log('Running on iOS'); }\n * ```\n */\nexport const isIOS = (): boolean =>\n  /iPad|iPhone|iPod/.test(navigator.userAgent) && !(globalThis.window as any).MSStream;\n\n/**\n * Detects if the current user agent is an Android device.\n *\n * @returns {boolean} True if the platform is Android, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @example\n * ```ts\n * if (isAndroid()) { console.log('Running on Android'); }\n * ```\n */\nexport const isAndroid = (): boolean => /android/i.test(navigator.userAgent);\n\n/**\n * Detects if the current user agent is a macOS device.\n *\n * @returns {boolean} True if the platform is macOS, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @example\n * ```ts\n * if (isMacOS()) { console.log('Running on macOS'); }\n * ```\n */\nexport const isMacOS = (): boolean =>\n  /Macintosh|Mac|Mac OS|MacIntel|MacPPC|Mac68K/gi.test(navigator.userAgent);\n\n/**\n * Detects if the current user agent is a Windows device.\n *\n * @returns {boolean} True if the platform is Windows, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @example\n * ```ts\n * if (isWindows()) { console.log('Running on Windows'); }\n * ```\n */\nexport const isWindows = (): boolean =>\n  /Win32|Win64|Windows|Windows NT|WinCE/gi.test(navigator.userAgent);\n\n/**\n * Detects if the current user agent is Chrome OS.\n *\n * @returns {boolean} True if the platform is Chrome OS, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @example\n * ```ts\n * if (isChromeOS()) { console.log('Running on Chrome OS'); }\n * ```\n */\nexport const isChromeOS = (): boolean => /CrOS/gi.test(navigator.userAgent);\n\n/**\n * Retrieves the browser name based on the user agent string.\n *\n * @returns {string} The browser name: 'edge', 'chrome', 'firefox', 'safari', 'opera', 'android', 'iphone', or 'unknown'.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent\n * @throws {TypeError} Throws if navigator.userAgent is not accessible.\n * @example\n * ```ts\n * const browser = getBrowser(); // 'chrome', 'firefox', etc.\n * ```\n */\nexport const getBrowser = (): string => {\n  const { userAgent } = navigator;\n\n  if (/edg/i.test(userAgent)) {\n    return 'edge';\n  }\n  if (/chrome|chromium|crios/i.test(userAgent)) {\n    return 'chrome';\n  }\n  if (/firefox|fxios/i.test(userAgent)) {\n    return 'firefox';\n  }\n  if (/safari/i.test(userAgent)) {\n    return 'safari';\n  }\n  if (/opr\\//i.test(userAgent)) {\n    return 'opera';\n  }\n  if (/android/i.test(userAgent)) {\n    return 'android';\n  }\n  if (/iphone/i.test(userAgent)) {\n    return 'iphone';\n  }\n  return 'unknown';\n};\n\n/**\n * Determines the device platform as a string: 'ios', 'android', 'macos', 'chromeos', 'windows', or 'unknown'.\n *\n * @returns {string} The detected platform.\n * @see isIOS\n * @see isAndroid\n * @see isMacOS\n * @see isChromeOS\n * @see isWindows\n * @example\n * ```ts\n * const platform = getPlatform(); // 'android', 'ios', etc.\n * ```\n */\nexport const getPlatform = (): string => {\n  if (isIOS()) {\n    return 'ios';\n  }\n  if (isAndroid()) {\n    return 'android';\n  }\n  if (isMacOS()) {\n    return 'macos';\n  }\n  if (isChromeOS()) {\n    return 'chromeos';\n  }\n  if (isWindows()) {\n    return 'windows';\n  }\n  return 'unknown';\n};\n\n/**\n * Checks if the current device has a touchscreen capability.\n *\n * @returns {boolean} True if touch screen is supported, otherwise false.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigator/maxTouchPoints\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia\n * @example\n * ```ts\n * if (isTouchScreen()) { console.log('Device supports touch.'); }\n * ```\n */\nexport const isTouchScreen = (): boolean => {\n  return (\n    (navigator.maxTouchPoints && navigator.maxTouchPoints > 0) ||\n    globalThis.window.matchMedia?.('(any-pointer:coarse)').matches\n  );\n};\n\n/**\n * Determines if the current browser is Google Chrome.\n *\n * @returns {boolean} True if Chrome, otherwise false.\n * @see getBrowser\n */\nexport const isChrome = (): boolean => getBrowser() === 'chrome';\n\n/**\n * Determines if the current browser is Mozilla Firefox.\n *\n * @returns {boolean} True if Firefox, otherwise false.\n * @see getBrowser\n */\nexport const isFirefox = (): boolean => getBrowser() === 'firefox';\n\n/**\n * Determines if the current browser is Safari.\n *\n * @returns {boolean} True if Safari, otherwise false.\n * @see getBrowser\n */\nexport const isSafari = (): boolean => getBrowser() === 'safari';\n\n/**\n * Determines if the current browser is Opera.\n *\n * @returns {boolean} True if Opera, otherwise false.\n * @see getBrowser\n */\nexport const isOpera = (): boolean => getBrowser() === 'opera';\n\n/**\n * Determines if the current browser is Microsoft Edge.\n *\n * @returns {boolean} True if Edge, otherwise false.\n * @see getBrowser\n */\nexport const isEdge = (): boolean => getBrowser() === 'edge';\n\n/**\n * Detects Safari running on iOS devices.\n *\n * @returns {boolean} True if iOS Safari, otherwise false.\n * @see isIOS\n * @see isSafari\n */\nexport const isIOSSafari = (): boolean => getBrowser() === 'safari' && isIOS();\n\n/**\n * Detects Chrome running on iOS devices.\n *\n * @returns {boolean} True if iOS Chrome, otherwise false.\n * @see isIOS\n * @see isChrome\n */\nexport const isIOSChrome = (): boolean => getBrowser() === 'chrome' && isIOS();\n\n/**\n * Detects Chrome running on Android devices.\n *\n * @returns {boolean} True if Android Chrome, otherwise false.\n * @see isAndroid\n * @see isChrome\n */\nexport const isAndroidChrome = (): boolean => getBrowser() === 'chrome' && isAndroid();\n\n/**\n * Detects Chrome running on macOS devices.\n *\n * @returns {boolean} True if macOS Chrome, otherwise false.\n * @see isMacOS\n * @see isChrome\n */\nexport const isMacOSChrome = (): boolean => getBrowser() === 'chrome' && isMacOS();\n\n/**\n * Detects Chrome running on Windows devices.\n *\n * @returns {boolean} True if Windows Chrome, otherwise false.\n * @see isWindows\n * @see isChrome\n */\nexport const isWindowsChrome = (): boolean => getBrowser() === 'chrome' && isWindows();\n\n/**\n * Detects Firefox running on iOS devices.\n *\n * @returns {boolean} True if iOS Firefox, otherwise false.\n * @see isIOS\n * @see isFirefox\n */\nexport const isIOSFirefox = (): boolean => getBrowser() === 'firefox' && isIOS();\n\n/**\n * Detects Firefox running on Android devices.\n *\n * @returns {boolean} True if Android Firefox, otherwise false.\n * @see isAndroid\n * @see isFirefox\n */\nexport const isAndroidFirefox = (): boolean => getBrowser() === 'firefox' && isAndroid();\n\n/**\n * Detects Edge running on iOS devices.\n *\n * @returns {boolean} True if iOS Edge, otherwise false.\n * @see isIOS\n * @see isEdge\n */\nexport const isIOSEdge = (): boolean => getBrowser() === 'edge' && isIOS();\n\n/**\n * Detects Edge running on Android devices.\n *\n * @returns {boolean} True if Android Edge, otherwise false.\n * @see isAndroid\n * @see isEdge\n */\nexport const isAndroidEdge = (): boolean => getBrowser() === 'edge' && isAndroid();\n\n/**\n * Detects Edge running on macOS devices.\n *\n * @returns {boolean} True if macOS Edge, otherwise false.\n * @see isMacOS\n * @see isEdge\n */\nexport const isMacOSEdge = (): boolean => getBrowser() === 'edge' && isMacOS();\n\n/**\n * Detects Edge running on Windows devices.\n *\n * @returns {boolean} True if Windows Edge, otherwise false.\n * @see isWindows\n * @see isEdge\n */\nexport const isWindowsEdge = (): boolean => getBrowser() === 'edge' && isWindows();\n\n/**\n * Detects Opera running on iOS devices.\n *\n * @returns {boolean} True if iOS Opera, otherwise false.\n * @see isIOS\n * @see isOpera\n */\nexport const isIOSOpera = (): boolean => getBrowser() === 'opera' && isIOS();\n\n/**\n * Detects Opera running on Android devices.\n *\n * @returns {boolean} True if Android Opera, otherwise false.\n * @see isAndroid\n * @see isOpera\n */\nexport const isAndroidOpera = (): boolean => getBrowser() === 'opera' && isAndroid();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,cACX,mBAAmB,KAAK,UAAU,UAAU,IAAI,CAAE,WAAW,OAAe;;;;;;;;;;;AAY9E,MAAa,kBAA2B,WAAW,KAAK,UAAU,UAAU;;;;;;;;;;;AAY5E,MAAa,gBACX,gDAAgD,KAAK,UAAU,UAAU;;;;;;;;;;;AAY3E,MAAa,kBACX,yCAAyC,KAAK,UAAU,UAAU;;;;;;;;;;;AAYpE,MAAa,mBAA4B,SAAS,KAAK,UAAU,UAAU;;;;;;;;;;;;AAa3E,MAAa,mBAA2B;CACtC,MAAM,EAAE,cAAc;AAEtB,KAAI,OAAO,KAAK,UAAU,CACxB,QAAO;AAET,KAAI,yBAAyB,KAAK,UAAU,CAC1C,QAAO;AAET,KAAI,iBAAiB,KAAK,UAAU,CAClC,QAAO;AAET,KAAI,UAAU,KAAK,UAAU,CAC3B,QAAO;AAET,KAAI,SAAS,KAAK,UAAU,CAC1B,QAAO;AAET,KAAI,WAAW,KAAK,UAAU,CAC5B,QAAO;AAET,KAAI,UAAU,KAAK,UAAU,CAC3B,QAAO;AAET,QAAO;;;;;;;;;;;;;;;;AAiBT,MAAa,oBAA4B;AACvC,KAAI,OAAO,CACT,QAAO;AAET,KAAI,WAAW,CACb,QAAO;AAET,KAAI,SAAS,CACX,QAAO;AAET,KAAI,YAAY,CACd,QAAO;AAET,KAAI,WAAW,CACb,QAAO;AAET,QAAO;;;;;;;;;;;;;AAcT,MAAa,sBAA+B;AAC1C,QACG,UAAU,kBAAkB,UAAU,iBAAiB,KACxD,WAAW,OAAO,aAAa,uBAAuB,CAAC;;;;;;;;AAU3D,MAAa,iBAA0B,YAAY,KAAK;;;;;;;AAQxD,MAAa,kBAA2B,YAAY,KAAK;;;;;;;AAQzD,MAAa,iBAA0B,YAAY,KAAK;;;;;;;AAQxD,MAAa,gBAAyB,YAAY,KAAK;;;;;;;AAQvD,MAAa,eAAwB,YAAY,KAAK;;;;;;;;AAStD,MAAa,oBAA6B,YAAY,KAAK,YAAY,OAAO;;;;;;;;AAS9E,MAAa,oBAA6B,YAAY,KAAK,YAAY,OAAO;;;;;;;;AAS9E,MAAa,wBAAiC,YAAY,KAAK,YAAY,WAAW;;;;;;;;AAStF,MAAa,sBAA+B,YAAY,KAAK,YAAY,SAAS;;;;;;;;AASlF,MAAa,wBAAiC,YAAY,KAAK,YAAY,WAAW;;;;;;;;AAStF,MAAa,qBAA8B,YAAY,KAAK,aAAa,OAAO;;;;;;;;AAShF,MAAa,yBAAkC,YAAY,KAAK,aAAa,WAAW;;;;;;;;AASxF,MAAa,kBAA2B,YAAY,KAAK,UAAU,OAAO;;;;;;;;AAS1E,MAAa,sBAA+B,YAAY,KAAK,UAAU,WAAW;;;;;;;;AASlF,MAAa,oBAA6B,YAAY,KAAK,UAAU,SAAS;;;;;;;;AAS9E,MAAa,sBAA+B,YAAY,KAAK,UAAU,WAAW;;;;;;;;AASlF,MAAa,mBAA4B,YAAY,KAAK,WAAW,OAAO;;;;;;;;AAS5E,MAAa,uBAAgC,YAAY,KAAK,WAAW,WAAW"}

package/lib/formatting/date.d.ts

@@ -0,0 +1,80 @@
+import { DateFormatOptions } from "./date.types.js";
+
+//#region src/formatting/date.d.ts
+/**
+ * Formats a date string to a consistent format to prevent hydration mismatches.
+ *
+ * @param {string | Date} date - The date to format (ISO string or Date object).
+ * @param {DateFormatOptions} [options] - Optional formatting options.
+ * @returns {string} The formatted date string.
+ * @throws {Error} If the date is invalid.
+ * @example
+ * ```ts
+ * formatDate('2023-01-15T10:00:00Z', { month: 'short', year: 'numeric' })
+ * // Returns: "Jan 2023"
+ * ```
+ */
+declare function formatDate(date: string | Date, options?: DateFormatOptions): string;
+/**
+ * Formats a date period (start to end or start to present).
+ *
+ * @param {string | Date} startDate - The start date.
+ * @param {string | Date | null} [endDate] - The end date, or null for ongoing.
+ * @param {boolean} [isCurrent=false] - Whether the period is current/ongoing.
+ * @returns {string} The formatted date period string.
+ * @example
+ * ```ts
+ * formatDatePeriod('2023-01-01', '2023-12-31')
+ * // Returns: "Jan 2023 - Dec 2023"
+ *
+ * formatDatePeriod('2023-01-01', null, true)
+ * // Returns: "Jan 2023 - Present"
+ * ```
+ */
+declare function formatDatePeriod(startDate: string | Date, endDate?: string | Date | null, isCurrent?: boolean): string;
+/**
+ * Formats a full date with time for display.
+ *
+ * @param {string | Date} date - The date to format.
+ * @returns {string} The formatted date and time string.
+ * @example
+ * ```ts
+ * formatDateTime('2023-01-15T14:30:00Z')
+ * // Returns: "January 15, 2023, 02:30 PM"
+ * ```
+ */
+declare function formatDateTime(date: string | Date): string;
+/**
+ * Formats a date for display without time.
+ *
+ * @param {string | Date} date - The date to format.
+ * @returns {string} The formatted date string.
+ * @example
+ * ```ts
+ * formatDateOnly('2023-01-15')
+ * // Returns: "January 15, 2023"
+ * ```
+ */
+declare function formatDateOnly(date: string | Date): string;
+/**
+ * Formats a month and year for display.
+ *
+ * @param {string | Date} date - The date to format.
+ * @returns {string} The formatted month and year string.
+ * @example
+ * ```ts
+ * formatMonthYear('2023-01-15')
+ * // Returns: "Jan 2023"
+ * ```
+ */
+declare function formatMonthYear(date: string | Date): string;
+/**
+ * Formats a relative time string (e.g. "2 days ago").
+ *
+ * @param {string | Date} date - The date to format.
+ * @returns {string} The relative time string.
+ */
+declare function formatRelativeTime(date: Date | string): string;
+//#endregion
+export { formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatRelativeTime };
+//# sourceMappingURL=date.d.ts.map

package/lib/formatting/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","names":[],"sources":["../../src/formatting/date.ts"],"mappings":";;;;;;;;;;;AAuGA;;;;;iBAxEgB,UAAA,CACd,IAAA,WAAe,IAAA,EACf,OAAA,GAGK,iBAAA;;;;;AA2GP;;;;;AAaA;;;;;;;iBAnFgB,gBAAA,CACd,SAAA,WAAoB,IAAA,EACpB,OAAA,YAAmB,IAAA,SACnB,SAAA;;;;;;;;;;;;iBA2Bc,cAAA,CAAe,IAAA,WAAe,IAAA;;;;;;;;;;;;iBAqB9B,cAAA,CAAe,IAAA,WAAe,IAAA;;;;;;;;;;;;iBAmB9B,eAAA,CAAgB,IAAA,WAAe,IAAA;;;;;;;iBAa/B,kBAAA,CAAmB,IAAA,EAAM,IAAA"}

package/lib/formatting/date.js

@@ -0,0 +1,135 @@
+//#region src/formatting/date.ts
+/**
+* Formats a date string to a consistent format to prevent hydration mismatches.
+*
+* @param {string | Date} date - The date to format (ISO string or Date object).
+* @param {DateFormatOptions} [options] - Optional formatting options.
+* @returns {string} The formatted date string.
+* @throws {Error} If the date is invalid.
+* @example
+* ```ts
+* formatDate('2023-01-15T10:00:00Z', { month: 'short', year: 'numeric' })
+* // Returns: "Jan 2023"
+* ```
+*/
+function formatDate(date, options = {
+	month: "short",
+	year: "numeric"
+}) {
+	try {
+		const dateObj = typeof date === "string" ? new Date(date) : date;
+		if (Number.isNaN(dateObj.getTime())) return "Invalid date";
+		return new Intl.DateTimeFormat("en-US", {
+			...options,
+			timeZone: "UTC"
+		}).format(dateObj);
+	} catch (error) {
+		console.error("Error formatting date:", error);
+		return "Invalid date";
+	}
+}
+/**
+* Formats a date period (start to end or start to present).
+*
+* @param {string | Date} startDate - The start date.
+* @param {string | Date | null} [endDate] - The end date, or null for ongoing.
+* @param {boolean} [isCurrent=false] - Whether the period is current/ongoing.
+* @returns {string} The formatted date period string.
+* @example
+* ```ts
+* formatDatePeriod('2023-01-01', '2023-12-31')
+* // Returns: "Jan 2023 - Dec 2023"
+*
+* formatDatePeriod('2023-01-01', null, true)
+* // Returns: "Jan 2023 - Present"
+* ```
+*/
+function formatDatePeriod(startDate, endDate, isCurrent = false) {
+	const formattedStart = formatDate(startDate, {
+		month: "short",
+		year: "numeric"
+	});
+	if (isCurrent) return `${formattedStart} - Present`;
+	if (endDate) return `${formattedStart} - ${formatDate(endDate, {
+		month: "short",
+		year: "numeric"
+	})}`;
+	return `${formattedStart} - Present`;
+}
+/**
+* Formats a full date with time for display.
+*
+* @param {string | Date} date - The date to format.
+* @returns {string} The formatted date and time string.
+* @example
+* ```ts
+* formatDateTime('2023-01-15T14:30:00Z')
+* // Returns: "January 15, 2023, 02:30 PM"
+* ```
+*/
+function formatDateTime(date) {
+	return formatDate(date, {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+}
+/**
+* Formats a date for display without time.
+*
+* @param {string | Date} date - The date to format.
+* @returns {string} The formatted date string.
+* @example
+* ```ts
+* formatDateOnly('2023-01-15')
+* // Returns: "January 15, 2023"
+* ```
+*/
+function formatDateOnly(date) {
+	return formatDate(date, {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	});
+}
+/**
+* Formats a month and year for display.
+*
+* @param {string | Date} date - The date to format.
+* @returns {string} The formatted month and year string.
+* @example
+* ```ts
+* formatMonthYear('2023-01-15')
+* // Returns: "Jan 2023"
+* ```
+*/
+function formatMonthYear(date) {
+	return formatDate(date, {
+		month: "short",
+		year: "numeric"
+	});
+}
+/**
+* Formats a relative time string (e.g. "2 days ago").
+*
+* @param {string | Date} date - The date to format.
+* @returns {string} The relative time string.
+*/
+function formatRelativeTime(date) {
+	const d = typeof date === "string" ? new Date(date) : date;
+	const diff = (/* @__PURE__ */ new Date()).getTime() - d.getTime();
+	const seconds = Math.floor(diff / 1e3);
+	const minutes = Math.floor(seconds / 60);
+	const hours = Math.floor(minutes / 60);
+	const days = Math.floor(hours / 24);
+	if (days > 0) return `${days} day${days > 1 ? "s" : ""} ago`;
+	if (hours > 0) return `${hours} hour${hours > 1 ? "s" : ""} ago`;
+	if (minutes > 0) return `${minutes} minute${minutes > 1 ? "s" : ""} ago`;
+	return "Just now";
+}
+//#endregion
+export { formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatRelativeTime };
+
+//# sourceMappingURL=date.js.map

package/lib/formatting/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","names":[],"sources":["../../src/formatting/date.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { DateFormatOptions } from './date.types.js';\n\n/**\n * Formats a date string to a consistent format to prevent hydration mismatches.\n *\n * @param {string | Date} date - The date to format (ISO string or Date object).\n * @param {DateFormatOptions} [options] - Optional formatting options.\n * @returns {string} The formatted date string.\n * @throws {Error} If the date is invalid.\n * @example\n * ```ts\n * formatDate('2023-01-15T10:00:00Z', { month: 'short', year: 'numeric' })\n * // Returns: \"Jan 2023\"\n * ```\n */\nexport function formatDate(\n  date: string | Date,\n  options = {\n    month: 'short',\n    year: 'numeric',\n  } as DateFormatOptions,\n): string {\n  try {\n    const dateObj = typeof date === 'string' ? new Date(date) : date;\n\n    if (Number.isNaN(dateObj.getTime())) {\n      return 'Invalid date';\n    }\n\n    const formatter = new Intl.DateTimeFormat('en-US', {\n      ...options,\n      timeZone: 'UTC',\n    });\n\n    return formatter.format(dateObj);\n  } catch (error) {\n    console.error('Error formatting date:', error);\n    return 'Invalid date';\n  }\n}\n\n/**\n * Formats a date period (start to end or start to present).\n *\n * @param {string | Date} startDate - The start date.\n * @param {string | Date | null} [endDate] - The end date, or null for ongoing.\n * @param {boolean} [isCurrent=false] - Whether the period is current/ongoing.\n * @returns {string} The formatted date period string.\n * @example\n * ```ts\n * formatDatePeriod('2023-01-01', '2023-12-31')\n * // Returns: \"Jan 2023 - Dec 2023\"\n *\n * formatDatePeriod('2023-01-01', null, true)\n * // Returns: \"Jan 2023 - Present\"\n * ```\n */\nexport function formatDatePeriod(\n  startDate: string | Date,\n  endDate?: string | Date | null,\n  isCurrent: boolean = false,\n): string {\n  const formattedStart = formatDate(startDate, { month: 'short', year: 'numeric' });\n\n  if (isCurrent) {\n    return `${formattedStart} - Present`;\n  }\n\n  if (endDate) {\n    const formattedEnd = formatDate(endDate, { month: 'short', year: 'numeric' });\n    return `${formattedStart} - ${formattedEnd}`;\n  }\n\n  return `${formattedStart} - Present`;\n}\n\n/**\n * Formats a full date with time for display.\n *\n * @param {string | Date} date - The date to format.\n * @returns {string} The formatted date and time string.\n * @example\n * ```ts\n * formatDateTime('2023-01-15T14:30:00Z')\n * // Returns: \"January 15, 2023, 02:30 PM\"\n * ```\n */\nexport function formatDateTime(date: string | Date): string {\n  return formatDate(date, {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n    hour: '2-digit',\n    minute: '2-digit',\n  });\n}\n\n/**\n * Formats a date for display without time.\n *\n * @param {string | Date} date - The date to format.\n * @returns {string} The formatted date string.\n * @example\n * ```ts\n * formatDateOnly('2023-01-15')\n * // Returns: \"January 15, 2023\"\n * ```\n */\nexport function formatDateOnly(date: string | Date): string {\n  return formatDate(date, {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n  });\n}\n\n/**\n * Formats a month and year for display.\n *\n * @param {string | Date} date - The date to format.\n * @returns {string} The formatted month and year string.\n * @example\n * ```ts\n * formatMonthYear('2023-01-15')\n * // Returns: \"Jan 2023\"\n * ```\n */\nexport function formatMonthYear(date: string | Date): string {\n  return formatDate(date, {\n    month: 'short',\n    year: 'numeric',\n  });\n}\n\n/**\n * Formats a relative time string (e.g. \"2 days ago\").\n *\n * @param {string | Date} date - The date to format.\n * @returns {string} The relative time string.\n */\nexport function formatRelativeTime(date: Date | string): string {\n  const d = typeof date === 'string' ? new Date(date) : date;\n  const now = new Date();\n  const diff = now.getTime() - d.getTime();\n\n  const seconds = Math.floor(diff / 1000);\n  const minutes = Math.floor(seconds / 60);\n  const hours = Math.floor(minutes / 60);\n  const days = Math.floor(hours / 24);\n\n  if (days > 0) return `${days} day${days > 1 ? 's' : ''} ago`;\n  if (hours > 0) return `${hours} hour${hours > 1 ? 's' : ''} ago`;\n  if (minutes > 0) return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;\n  return 'Just now';\n}\n"],"mappings":";;;;;;;;;;;;;;AA+BA,SAAgB,WACd,MACA,UAAU;CACR,OAAO;CACP,MAAM;CACP,EACO;AACR,KAAI;EACF,MAAM,UAAU,OAAO,SAAS,WAAW,IAAI,KAAK,KAAK,GAAG;AAE5D,MAAI,OAAO,MAAM,QAAQ,SAAS,CAAC,CACjC,QAAO;AAQT,SALkB,IAAI,KAAK,eAAe,SAAS;GACjD,GAAG;GACH,UAAU;GACX,CAAC,CAEe,OAAO,QAAQ;UACzB,OAAO;AACd,UAAQ,MAAM,0BAA0B,MAAM;AAC9C,SAAO;;;;;;;;;;;;;;;;;;;AAoBX,SAAgB,iBACd,WACA,SACA,YAAqB,OACb;CACR,MAAM,iBAAiB,WAAW,WAAW;EAAE,OAAO;EAAS,MAAM;EAAW,CAAC;AAEjF,KAAI,UACF,QAAO,GAAG,eAAe;AAG3B,KAAI,QAEF,QAAO,GAAG,eAAe,KADJ,WAAW,SAAS;EAAE,OAAO;EAAS,MAAM;EAAW,CAAC;AAI/E,QAAO,GAAG,eAAe;;;;;;;;;;;;;AAc3B,SAAgB,eAAe,MAA6B;AAC1D,QAAO,WAAW,MAAM;EACtB,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT,CAAC;;;;;;;;;;;;;AAcJ,SAAgB,eAAe,MAA6B;AAC1D,QAAO,WAAW,MAAM;EACtB,MAAM;EACN,OAAO;EACP,KAAK;EACN,CAAC;;;;;;;;;;;;;AAcJ,SAAgB,gBAAgB,MAA6B;AAC3D,QAAO,WAAW,MAAM;EACtB,OAAO;EACP,MAAM;EACP,CAAC;;;;;;;;AASJ,SAAgB,mBAAmB,MAA6B;CAC9D,MAAM,IAAI,OAAO,SAAS,WAAW,IAAI,KAAK,KAAK,GAAG;CAEtD,MAAM,wBADM,IAAI,MAAM,EACL,SAAS,GAAG,EAAE,SAAS;CAExC,MAAM,UAAU,KAAK,MAAM,OAAO,IAAK;CACvC,MAAM,UAAU,KAAK,MAAM,UAAU,GAAG;CACxC,MAAM,QAAQ,KAAK,MAAM,UAAU,GAAG;CACtC,MAAM,OAAO,KAAK,MAAM,QAAQ,GAAG;AAEnC,KAAI,OAAO,EAAG,QAAO,GAAG,KAAK,MAAM,OAAO,IAAI,MAAM,GAAG;AACvD,KAAI,QAAQ,EAAG,QAAO,GAAG,MAAM,OAAO,QAAQ,IAAI,MAAM,GAAG;AAC3D,KAAI,UAAU,EAAG,QAAO,GAAG,QAAQ,SAAS,UAAU,IAAI,MAAM,GAAG;AACnE,QAAO"}

package/lib/formatting/date.types.d.ts

@@ -0,0 +1,35 @@
+//#region src/formatting/date.types.d.ts
+/**
+ * Copyright 2026 ResQ
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Format options for date display.
+ *
+ * @property {'short' | 'long' | 'numeric'} [month] - Month display format.
+ * @property {'numeric' | '2-digit'} [year] - Year display format.
+ * @property {'numeric' | '2-digit'} [day] - Day display format.
+ * @property {'numeric' | '2-digit'} [hour] - Hour display format.
+ * @property {'numeric' | '2-digit'} [minute] - Minute display format.
+ */
+interface DateFormatOptions {
+  month?: 'short' | 'long' | 'numeric';
+  year?: 'numeric' | '2-digit';
+  day?: 'numeric' | '2-digit';
+  hour?: 'numeric' | '2-digit';
+  minute?: 'numeric' | '2-digit';
+}
+//#endregion
+export { DateFormatOptions };
+//# sourceMappingURL=date.types.d.ts.map

package/lib/formatting/date.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.types.d.ts","names":[],"sources":["../../src/formatting/date.types.ts"],"mappings":";;AAyBA;;;;;;;;;;;;;;;;;;;;;;;UAAiB,iBAAA;EACf,KAAA;EACA,IAAA;EACA,GAAA;EACA,IAAA;EACA,MAAA;AAAA"}

package/lib/formatting/index.d.ts

@@ -0,0 +1,5 @@
+import { DateFormatOptions } from "./date.types.js";
+import { formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatRelativeTime } from "./date.js";
+import { formatBytes, formatNumber, formatPercent } from "./number.js";
+import { capitalize, slugify, truncate } from "./string.js";
+export { DateFormatOptions, capitalize, formatBytes, formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatNumber, formatPercent, formatRelativeTime, slugify, truncate };

package/lib/formatting/index.js

@@ -0,0 +1,4 @@
+import { formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatRelativeTime } from "./date.js";
+import { formatBytes, formatNumber, formatPercent } from "./number.js";
+import { capitalize, slugify, truncate } from "./string.js";
+export { capitalize, formatBytes, formatDate, formatDateOnly, formatDatePeriod, formatDateTime, formatMonthYear, formatNumber, formatPercent, formatRelativeTime, slugify, truncate };

package/lib/formatting/number.d.ts

@@ -0,0 +1,22 @@
+//#region src/formatting/number.d.ts
+/**
+ * Copyright 2026 ResQ
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function formatNumber(num: number): string;
+declare function formatBytes(bytes: number): string;
+declare function formatPercent(value: number): string;
+//#endregion
+export { formatBytes, formatNumber, formatPercent };
+//# sourceMappingURL=number.d.ts.map

package/lib/formatting/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","names":[],"sources":["../../src/formatting/number.ts"],"mappings":";;AAgBA;;;;;AAIA;;;;;AAQA;;;;iBAZgB,YAAA,CAAa,GAAA;AAAA,iBAIb,WAAA,CAAY,KAAA;AAAA,iBAQZ,aAAA,CAAc,KAAA"}

package/lib/formatting/number.js

@@ -0,0 +1,39 @@
+//#region src/formatting/number.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+function formatNumber(num) {
+	return new Intl.NumberFormat("en-US").format(num);
+}
+function formatBytes(bytes) {
+	if (bytes === 0) return "0 Bytes";
+	const k = 1024;
+	const sizes = [
+		"Bytes",
+		"KB",
+		"MB",
+		"GB",
+		"TB"
+	];
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return Math.round(bytes / Math.pow(k, i) * 100) / 100 + " " + sizes[i];
+}
+function formatPercent(value) {
+	return `${(value * 100).toFixed(1)}%`;
+}
+//#endregion
+export { formatBytes, formatNumber, formatPercent };
+
+//# sourceMappingURL=number.js.map

package/lib/formatting/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","names":[],"sources":["../../src/formatting/number.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function formatNumber(num: number): string {\n  return new Intl.NumberFormat('en-US').format(num)\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return '0 Bytes'\n  const k = 1024\n  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB']\n  const i = Math.floor(Math.log(bytes) / Math.log(k))\n  return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i]\n}\n\nexport function formatPercent(value: number): string {\n  return `${(value * 100).toFixed(1)}%`\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,aAAa,KAAqB;AAChD,QAAO,IAAI,KAAK,aAAa,QAAQ,CAAC,OAAO,IAAI;;AAGnD,SAAgB,YAAY,OAAuB;AACjD,KAAI,UAAU,EAAG,QAAO;CACxB,MAAM,IAAI;CACV,MAAM,QAAQ;EAAC;EAAS;EAAM;EAAM;EAAM;EAAK;CAC/C,MAAM,IAAI,KAAK,MAAM,KAAK,IAAI,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC;AACnD,QAAO,KAAK,MAAO,QAAQ,KAAK,IAAI,GAAG,EAAE,GAAI,IAAI,GAAG,MAAM,MAAM,MAAM;;AAGxE,SAAgB,cAAc,OAAuB;AACnD,QAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC"}