@resq-sw/helpers 0.1.0

package/README.md

@@ -0,0 +1,218 @@
+# @resq-sw/helpers
+
+> Functional utilities, type guards, result types, formatting, browser detection, and async task execution.
+
+## Installation
+
+```bash
+bun add @resq-sw/helpers
+```
+
+Dependencies: `@resq-sw/logger`, `tinyqueue`.
+
+## Quick Start
+
+```ts
+import { catchError, success, failure, isString, Stringify, getURL } from "@resq-sw/helpers";
+
+const result = await catchError(fetch, "/api/data");
+if (result.success) console.log(result.value);
+
+const json = Stringify({ name: "ResQ" });
+const url = getURL("api/users"); // origin-relative URL
+```
+
+## API Reference
+
+### Result Types
+
+Railway-oriented programming primitives for error handling without exceptions.
+
+#### `success(value): Success<T>`
+
+Creates a successful result wrapping `value`.
+
+#### `failure(error): Failure<E>`
+
+Creates a failed result wrapping `error`.
+
+#### `catchError(asyncFn, ...args): Promise<Result<T, Error>>`
+
+Wraps an async function call in a `Result`. Returns `Success` on resolve, `Failure` on rejection.
+
+```ts
+const result = await catchError(fetchUser, userId);
+if (result.success) console.log(result.value);
+```
+
+#### `map(fn): (result) => Result<U, E>`
+
+Transforms the value inside a successful result.
+
+```ts
+const double = map((n: number) => n * 2);
+double(success(5)); // success(10)
+```
+
+#### `bindResult(fn): (result) => Result<U, E>`
+
+Chains a result-returning function after a successful result (flatMap).
+
+#### `railway(input, ...fns): Result<T, E>`
+
+Pipes an input through a chain of result-returning functions, short-circuiting on the first failure. Supports up to 5 functions with full type inference.
+
+```ts
+const result = railway(
+  "42",
+  (s) => success(parseInt(s)),
+  (n) => n > 0 ? success(n) : failure("must be positive"),
+);
+```
+
+#### `recover(fn): (result) => Result<T, E2>`
+
+Recovers from a failure by applying `fn` to the error.
+
+#### `tap(fn): (result) => Result<T, E>`
+
+Executes a side effect on success without modifying the result.
+
+### Utilities
+
+#### `Stringify(obj): string`
+
+Converts an object to a pretty-printed JSON string (2-space indent).
+
+#### `getURL(path?): string`
+
+Builds a full URL from `globalThis.location.origin` (browser) or environment variables (`VITE_BASE_URL`, `NEXT_PUBLIC_BASE_URL`, `BASE_URL`).
+
+- **path** (`string`, default `""`) -- path to append.
+- Returns `""` if no origin is available.
+
+### Type Guards
+
+| Function | Narrows to |
+|----------|-----------|
+| `isNumber(value)` | `number` |
+| `isString(value)` | `string` |
+| `isFunction(value)` | `Function` |
+| `isPromise(value)` | `Promise<unknown>` |
+
+### TaskExec
+
+Priority-queue-based delayed task executor. Tasks are sorted by execution time and fired in order.
+
+```ts
+import { TaskExec } from "@resq-sw/helpers";
+
+const exec = new TaskExec();
+exec.exec(() => console.log("later"), 5000);  // runs after 5s
+exec.exec(() => console.log("sooner"), 1000); // runs after 1s
+```
+
+#### `exec(func, ttl): void`
+
+Schedules `func` to run after `ttl` milliseconds.
+
+### parseCodePath / parseCodePathDetailed
+
+Constructs formatted source-location strings for debugging.
+
+#### `parseCodePath(context, entity): string`
+
+- **context** -- description of the operation.
+- **entity** -- function, class, string, or symbol whose name is extracted.
+- Returns `"location: <path> @<entity>: <context>"`.
+
+#### `parseCodePathDetailed(context, entity, options?): string`
+
+Extended version with optional line number, ISO timestamp, and custom prefix.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `includeLineNumber` | `boolean` | Append call-site line number |
+| `includeTimestamp` | `boolean` | Append ISO 8601 timestamp |
+| `customPrefix` | `string` | Replace default `"location"` prefix |
+
+### Formatting (`@resq-sw/helpers/formatting`)
+
+#### Date Formatting
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `formatDate` | `(date: string \| Date, options?: DateFormatOptions) => string` | Formats a date with Intl.DateTimeFormat (UTC) |
+| `formatDatePeriod` | `(start, end?, isCurrent?) => string` | Formats a date range (e.g. `"Jan 2023 - Present"`) |
+| `formatDateTime` | `(date) => string` | Full date + time (e.g. `"January 15, 2023, 02:30 PM"`) |
+| `formatDateOnly` | `(date) => string` | Date without time (e.g. `"January 15, 2023"`) |
+| `formatMonthYear` | `(date) => string` | Short month + year (e.g. `"Jan 2023"`) |
+| `formatRelativeTime` | `(date) => string` | Relative time (e.g. `"2 days ago"`, `"Just now"`) |
+
+#### Number Formatting
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `formatNumber` | `(num: number) => string` | Locale-formatted number (`1,234,567`) |
+| `formatBytes` | `(bytes: number) => string` | Human-readable bytes (`1.5 MB`) |
+| `formatPercent` | `(value: number) => string` | Percentage from decimal (`0.85` -> `"85.0%"`) |
+
+#### String Formatting
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `capitalize` | `(str: string) => string` | Capitalize first character |
+| `truncate` | `(str: string, length: number) => string` | Truncate with `...` |
+| `slugify` | `(str: string) => string` | URL-safe slug |
+
+### Browser (`@resq-sw/helpers/browser`)
+
+#### Platform Detection
+
+| Function | Returns |
+|----------|---------|
+| `isIOS()` | `boolean` |
+| `isAndroid()` | `boolean` |
+| `isMacOS()` | `boolean` |
+| `isWindows()` | `boolean` |
+| `isChromeOS()` | `boolean` |
+| `getPlatform()` | `"ios" \| "android" \| "macos" \| "chromeos" \| "windows" \| "unknown"` |
+| `isTouchScreen()` | `boolean` |
+
+#### Browser Detection
+
+| Function | Returns |
+|----------|---------|
+| `getBrowser()` | `"edge" \| "chrome" \| "firefox" \| "safari" \| "opera" \| "android" \| "iphone" \| "unknown"` |
+| `isChrome()` | `boolean` |
+| `isFirefox()` | `boolean` |
+| `isSafari()` | `boolean` |
+| `isOpera()` | `boolean` |
+| `isEdge()` | `boolean` |
+
+Combo detectors: `isIOSSafari`, `isIOSChrome`, `isAndroidChrome`, `isMacOSChrome`, `isWindowsChrome`, `isIOSFirefox`, `isAndroidFirefox`, `isIOSEdge`, `isAndroidEdge`, `isMacOSEdge`, `isWindowsEdge`, `isIOSOpera`, `isAndroidOpera`.
+
+#### HTML Entities
+
+#### `obfuscateLink(opts): { href, encodedText }`
+
+Encodes contact links (mailto/tel) as HTML character references for spam protection.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `scheme` | `"mailto" \| "tel"` | URI scheme |
+| `address` | `string` | Email or phone |
+| `params` | `Record<string, string>` | Optional query params |
+| `text` | `string` | Display text (defaults to address) |
+
+```ts
+const { href, encodedText } = obfuscateLink({
+  scheme: "mailto",
+  address: "jane@example.com",
+  text: "Contact Jane",
+});
+```
+
+## License
+
+Apache-2.0

package/lib/browser/html-entities.d.ts

@@ -0,0 +1,34 @@
+//#region src/browser/html-entities.d.ts
+/**
+ * Obfuscates and encodes a contact hyperlink (such as mailto or tel) as HTML entities.
+ *
+ * @param {Object} opts Configuration options for link obfuscation.
+ * @param {'mailto'|'tel'|string} opts.scheme The URI scheme (e.g., 'mailto', 'tel', or custom).
+ * @param {string} opts.address The contact address (email or phone number).
+ * @param {Record<string, string>} [opts.params] Optional query parameters (used for mailto links).
+ * @param {string} [opts.text] Optional visible link text. Defaults to address.
+ * @returns {{ encodedHref: string, encodedText: string }} Object containing the obfuscated/encoded href and visible text.
+ * @throws {TypeError} If required fields are missing or invalid.
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#security_and_privacy
+ * @see https://github.com/resq-software/resQ
+ * @example
+ * ```ts
+ * const { encodedHref, encodedText } = obfuscateLink({
+ *   scheme: 'mailto',
+ *   address: 'jane.doe@example.com',
+ *   text: 'Contact Jane'
+ * });
+ * ```
+ */
+declare const obfuscateLink: (opts: {
+  scheme: "mailto" | "tel";
+  address: string;
+  params?: Record<string, string>;
+  text?: string;
+}) => {
+  href: string;
+  encodedText: string;
+};
+//#endregion
+export { obfuscateLink };
+//# sourceMappingURL=html-entities.d.ts.map

package/lib/browser/html-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-entities.d.ts","names":[],"sources":["../../src/browser/html-entities.ts"],"mappings":";;AAmDA;;;;;;;;;;;;;;;;;;;;cAAa,aAAA,GAAiB,IAAA;EAC5B,MAAA;EACA,OAAA;EACA,MAAA,GAAS,MAAA;EACT,IAAA;AAAA"}

package/lib/browser/html-entities.js

@@ -0,0 +1,63 @@
+//#region src/browser/html-entities.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.
+*/
+/**
+* Encodes every character in a string as a decimal HTML character reference.
+*
+* @param {string} str The string to encode.
+* @returns {string} The string with every character replaced by its HTML decimal entity.
+* @throws {TypeError} If the provided value is not a string.
+* @see https://developer.mozilla.org/en-US/docs/Glossary/Entity
+* @see https://dev.w3.org/html5/html-author/charref
+*/
+const toEntities = (str) => str.split("").map((c) => `&#${c.codePointAt(0)};`).join("");
+/**
+* Obfuscates and encodes a contact hyperlink (such as mailto or tel) as HTML entities.
+*
+* @param {Object} opts Configuration options for link obfuscation.
+* @param {'mailto'|'tel'|string} opts.scheme The URI scheme (e.g., 'mailto', 'tel', or custom).
+* @param {string} opts.address The contact address (email or phone number).
+* @param {Record<string, string>} [opts.params] Optional query parameters (used for mailto links).
+* @param {string} [opts.text] Optional visible link text. Defaults to address.
+* @returns {{ encodedHref: string, encodedText: string }} Object containing the obfuscated/encoded href and visible text.
+* @throws {TypeError} If required fields are missing or invalid.
+* @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#security_and_privacy
+* @see https://github.com/resq-software/resQ
+* @example
+* ```ts
+* const { encodedHref, encodedText } = obfuscateLink({
+*   scheme: 'mailto',
+*   address: 'jane.doe@example.com',
+*   text: 'Contact Jane'
+* });
+* ```
+*/
+const obfuscateLink = (opts) => {
+	const { scheme, address, params, text } = opts;
+	let uri = `${scheme}:${address}`;
+	if (params && Object.keys(params).length) {
+		const qs = Object.entries(params).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
+		uri += `?${qs}`;
+	}
+	return {
+		href: uri,
+		encodedText: toEntities(text ?? address)
+	};
+};
+//#endregion
+export { obfuscateLink };
+
+//# sourceMappingURL=html-entities.js.map

package/lib/browser/html-entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-entities.js","names":[],"sources":["../../src/browser/html-entities.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 * Encodes every character in a string as a decimal HTML character reference.\n *\n * @param {string} str The string to encode.\n * @returns {string} The string with every character replaced by its HTML decimal entity.\n * @throws {TypeError} If the provided value is not a string.\n * @see https://developer.mozilla.org/en-US/docs/Glossary/Entity\n * @see https://dev.w3.org/html5/html-author/charref\n */\nconst toEntities = (str: string): string =>\n  str\n    .split('')\n    .map((c) => `&#${c.codePointAt(0)};`)\n    .join('');\n\n/**\n * Obfuscates and encodes a contact hyperlink (such as mailto or tel) as HTML entities.\n *\n * @param {Object} opts Configuration options for link obfuscation.\n * @param {'mailto'|'tel'|string} opts.scheme The URI scheme (e.g., 'mailto', 'tel', or custom).\n * @param {string} opts.address The contact address (email or phone number).\n * @param {Record<string, string>} [opts.params] Optional query parameters (used for mailto links).\n * @param {string} [opts.text] Optional visible link text. Defaults to address.\n * @returns {{ encodedHref: string, encodedText: string }} Object containing the obfuscated/encoded href and visible text.\n * @throws {TypeError} If required fields are missing or invalid.\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#security_and_privacy\n * @see https://github.com/resq-software/resQ\n * @example\n * ```ts\n * const { encodedHref, encodedText } = obfuscateLink({\n *   scheme: 'mailto',\n *   address: 'jane.doe@example.com',\n *   text: 'Contact Jane'\n * });\n * ```\n */\nexport const obfuscateLink = (opts: {\n  scheme: 'mailto' | 'tel';\n  address: string;\n  params?: Record<string, string>;\n  text?: string;\n}) => {\n  const { scheme, address, params, text } = opts;\n\n  let uri = `${scheme}:${address}`;\n\n  if (params && Object.keys(params).length) {\n    const qs = Object.entries(params)\n      .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n      .join('&');\n    uri += `?${qs}`;\n  }\n\n  const href = uri;\n  const encodedText = toEntities(text ?? address);\n\n  return { href, encodedText };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,cAAc,QAClB,IACG,MAAM,GAAG,CACT,KAAK,MAAM,KAAK,EAAE,YAAY,EAAE,CAAC,GAAG,CACpC,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;AAuBb,MAAa,iBAAiB,SAKxB;CACJ,MAAM,EAAE,QAAQ,SAAS,QAAQ,SAAS;CAE1C,IAAI,MAAM,GAAG,OAAO,GAAG;AAEvB,KAAI,UAAU,OAAO,KAAK,OAAO,CAAC,QAAQ;EACxC,MAAM,KAAK,OAAO,QAAQ,OAAO,CAC9B,KAAK,CAAC,GAAG,OAAO,GAAG,mBAAmB,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,CACpE,KAAK,IAAI;AACZ,SAAO,IAAI;;AAMb,QAAO;EAAE,MAHI;EAGE,aAFK,WAAW,QAAQ,QAAQ;EAEnB"}

package/lib/browser/index.d.ts

@@ -0,0 +1,3 @@
+import { obfuscateLink } from "./html-entities.js";
+import { 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 } from "./platform.js";
+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, obfuscateLink };

package/lib/browser/index.js

@@ -0,0 +1,3 @@
+import { 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 } from "./platform.js";
+import { obfuscateLink } from "./html-entities.js";
+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, obfuscateLink };

package/lib/browser/platform.d.ts

@@ -0,0 +1,252 @@
+//#region src/browser/platform.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.
+ */
+/**
+ * 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'); }
+ * ```
+ */
+declare const isIOS: () => boolean;
+/**
+ * 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'); }
+ * ```
+ */
+declare const isAndroid: () => boolean;
+/**
+ * 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'); }
+ * ```
+ */
+declare const isMacOS: () => boolean;
+/**
+ * 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'); }
+ * ```
+ */
+declare const isWindows: () => boolean;
+/**
+ * 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'); }
+ * ```
+ */
+declare const isChromeOS: () => boolean;
+/**
+ * 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.
+ * ```
+ */
+declare const getBrowser: () => string;
+/**
+ * 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.
+ * ```
+ */
+declare const getPlatform: () => string;
+/**
+ * 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.'); }
+ * ```
+ */
+declare const isTouchScreen: () => boolean;
+/**
+ * Determines if the current browser is Google Chrome.
+ *
+ * @returns {boolean} True if Chrome, otherwise false.
+ * @see getBrowser
+ */
+declare const isChrome: () => boolean;
+/**
+ * Determines if the current browser is Mozilla Firefox.
+ *
+ * @returns {boolean} True if Firefox, otherwise false.
+ * @see getBrowser
+ */
+declare const isFirefox: () => boolean;
+/**
+ * Determines if the current browser is Safari.
+ *
+ * @returns {boolean} True if Safari, otherwise false.
+ * @see getBrowser
+ */
+declare const isSafari: () => boolean;
+/**
+ * Determines if the current browser is Opera.
+ *
+ * @returns {boolean} True if Opera, otherwise false.
+ * @see getBrowser
+ */
+declare const isOpera: () => boolean;
+/**
+ * Determines if the current browser is Microsoft Edge.
+ *
+ * @returns {boolean} True if Edge, otherwise false.
+ * @see getBrowser
+ */
+declare const isEdge: () => boolean;
+/**
+ * Detects Safari running on iOS devices.
+ *
+ * @returns {boolean} True if iOS Safari, otherwise false.
+ * @see isIOS
+ * @see isSafari
+ */
+declare const isIOSSafari: () => boolean;
+/**
+ * Detects Chrome running on iOS devices.
+ *
+ * @returns {boolean} True if iOS Chrome, otherwise false.
+ * @see isIOS
+ * @see isChrome
+ */
+declare const isIOSChrome: () => boolean;
+/**
+ * Detects Chrome running on Android devices.
+ *
+ * @returns {boolean} True if Android Chrome, otherwise false.
+ * @see isAndroid
+ * @see isChrome
+ */
+declare const isAndroidChrome: () => boolean;
+/**
+ * Detects Chrome running on macOS devices.
+ *
+ * @returns {boolean} True if macOS Chrome, otherwise false.
+ * @see isMacOS
+ * @see isChrome
+ */
+declare const isMacOSChrome: () => boolean;
+/**
+ * Detects Chrome running on Windows devices.
+ *
+ * @returns {boolean} True if Windows Chrome, otherwise false.
+ * @see isWindows
+ * @see isChrome
+ */
+declare const isWindowsChrome: () => boolean;
+/**
+ * Detects Firefox running on iOS devices.
+ *
+ * @returns {boolean} True if iOS Firefox, otherwise false.
+ * @see isIOS
+ * @see isFirefox
+ */
+declare const isIOSFirefox: () => boolean;
+/**
+ * Detects Firefox running on Android devices.
+ *
+ * @returns {boolean} True if Android Firefox, otherwise false.
+ * @see isAndroid
+ * @see isFirefox
+ */
+declare const isAndroidFirefox: () => boolean;
+/**
+ * Detects Edge running on iOS devices.
+ *
+ * @returns {boolean} True if iOS Edge, otherwise false.
+ * @see isIOS
+ * @see isEdge
+ */
+declare const isIOSEdge: () => boolean;
+/**
+ * Detects Edge running on Android devices.
+ *
+ * @returns {boolean} True if Android Edge, otherwise false.
+ * @see isAndroid
+ * @see isEdge
+ */
+declare const isAndroidEdge: () => boolean;
+/**
+ * Detects Edge running on macOS devices.
+ *
+ * @returns {boolean} True if macOS Edge, otherwise false.
+ * @see isMacOS
+ * @see isEdge
+ */
+declare const isMacOSEdge: () => boolean;
+/**
+ * Detects Edge running on Windows devices.
+ *
+ * @returns {boolean} True if Windows Edge, otherwise false.
+ * @see isWindows
+ * @see isEdge
+ */
+declare const isWindowsEdge: () => boolean;
+/**
+ * Detects Opera running on iOS devices.
+ *
+ * @returns {boolean} True if iOS Opera, otherwise false.
+ * @see isIOS
+ * @see isOpera
+ */
+declare const isIOSOpera: () => boolean;
+/**
+ * Detects Opera running on Android devices.
+ *
+ * @returns {boolean} True if Android Opera, otherwise false.
+ * @see isAndroid
+ * @see isOpera
+ */
+declare const isAndroidOpera: () => boolean;
+//#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.d.ts.map

package/lib/browser/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","names":[],"sources":["../../src/browser/platform.ts"],"mappings":";;AA0BA;;;;;AAaA;;;;;AAYA;;;;;AAaA;;;;;AAaA;;;;cAnDa,KAAA;AAgEb;;;;;AAyCA;;;;;AAzCA,cAnDa,SAAA;;;;;AAuIb;;;;;AAQA;cAnIa,OAAA;;;;AA2Ib;;;;;AAQA;;cAtIa,SAAA;;;AA8Ib;;;;;AASA;;;cA1Ia,UAAA;;AAmJb;;;;;AASA;;;;;cA/Ia,UAAA;;;;;AAiKb;;;;;AASA;;;;;cAjIa,WAAA;;;;;AAmJb;;;;;AASA;;cA9Ha,aAAA;;;AAuIb;;;;cA1Ha,QAAA;AAmIb;;;;;AASA;AATA,cA3Ha,SAAA;;;;AA6Ib;;;cArIa,QAAA;;;;;;;cAQA,OAAA;;;;;;;cAQA,MAAA;;;;;;;;cASA,WAAA;;;;;;;;cASA,WAAA;;;;;;;;cASA,eAAA;;;;;;;;cASA,aAAA;;;;;;;;cASA,eAAA;;;;;;;;cASA,YAAA;;;;;;;;cASA,gBAAA;;;;;;;;cASA,SAAA;;;;;;;;cASA,aAAA;;;;;;;;cASA,WAAA;;;;;;;;cASA,aAAA;;;;;;;;cASA,UAAA;;;;;;;;cASA,cAAA"}