@8ms/helpers 3.0.26 → 3.1.0

package/dist/react/client/hooks/useFontReady.mjs

@@ -0,0 +1,21 @@
+import { sleep } from "../../../util/sleep.mjs";
+import { isSafari } from "../../../device/client/isSafari.mjs";
+import { useLayoutEffect, useState } from "react";
+//#region src/react/client/hooks/useFontReady.ts
+const useFontReady = () => {
+	const [fontReady, setFontReady] = useState(false);
+	useLayoutEffect(() => {
+		(async () => {
+			if (isSafari) {
+				await sleep(.3);
+				setFontReady(true);
+			} else {
+				const ready = await document.fonts.ready;
+				setFontReady("loaded" === ready.status);
+			}
+		})();
+	}, []);
+	return fontReady;
+};
+//#endregion
+export { useFontReady };

package/dist/react/client/hooks/usePrefersReducedMotion.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/react/client/hooks/usePrefersReducedMotion.ts
+const mediaQuery = "(prefers-reduced-motion: no-preference)";
+/**
+* Tracks the user's reduced-motion preference. Defaults to true (no animations) since the
+* preference is unknown on the server, then corrects once mounted on the client.
+* https://www.joshwcomeau.com/react/prefers-reduced-motion/
+*/
+const usePrefersReducedMotion = () => {
+	const [prefersReducedMotion, setPrefersReducedMotion] = (0, react.useState)(true);
+	(0, react.useEffect)(() => {
+		const mediaQueryList = window.matchMedia(mediaQuery);
+		const listener = ({ matches }) => setPrefersReducedMotion(!matches);
+		listener(mediaQueryList);
+		mediaQueryList.addEventListener("change", listener);
+		return () => mediaQueryList.removeEventListener("change", listener);
+	}, []);
+	return prefersReducedMotion;
+};
+//#endregion
+exports.usePrefersReducedMotion = usePrefersReducedMotion;

package/dist/react/client/hooks/usePrefersReducedMotion.d.cts

@@ -0,0 +1,8 @@
+//#region src/react/client/hooks/usePrefersReducedMotion.d.ts
+/**
+ * Tracks the user's reduced-motion preference. Defaults to true (no animations) since the
+ * preference is unknown on the server, then corrects once mounted on the client.
+ * https://www.joshwcomeau.com/react/prefers-reduced-motion/
+ */
+export declare const usePrefersReducedMotion: () => boolean;
+//#endregion

package/dist/react/client/hooks/usePrefersReducedMotion.d.mts

@@ -0,0 +1,8 @@
+//#region src/react/client/hooks/usePrefersReducedMotion.d.ts
+/**
+ * Tracks the user's reduced-motion preference. Defaults to true (no animations) since the
+ * preference is unknown on the server, then corrects once mounted on the client.
+ * https://www.joshwcomeau.com/react/prefers-reduced-motion/
+ */
+export declare const usePrefersReducedMotion: () => boolean;
+//#endregion

package/dist/react/client/hooks/usePrefersReducedMotion.mjs

@@ -0,0 +1,21 @@
+import { useEffect, useState } from "react";
+//#region src/react/client/hooks/usePrefersReducedMotion.ts
+const mediaQuery = "(prefers-reduced-motion: no-preference)";
+/**
+* Tracks the user's reduced-motion preference. Defaults to true (no animations) since the
+* preference is unknown on the server, then corrects once mounted on the client.
+* https://www.joshwcomeau.com/react/prefers-reduced-motion/
+*/
+const usePrefersReducedMotion = () => {
+	const [prefersReducedMotion, setPrefersReducedMotion] = useState(true);
+	useEffect(() => {
+		const mediaQueryList = window.matchMedia(mediaQuery);
+		const listener = ({ matches }) => setPrefersReducedMotion(!matches);
+		listener(mediaQueryList);
+		mediaQueryList.addEventListener("change", listener);
+		return () => mediaQueryList.removeEventListener("change", listener);
+	}, []);
+	return prefersReducedMotion;
+};
+//#endregion
+export { usePrefersReducedMotion };

package/dist/react/client/index.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_react_client_cn = require("./cn.cjs");
+const require_react_client_hooks_useAsyncEffect = require("./hooks/useAsyncEffect.cjs");
+const require_react_client_hooks_useCopyText = require("./hooks/useCopyText.cjs");
+const require_react_client_hooks_usePrefersReducedMotion = require("./hooks/usePrefersReducedMotion.cjs");
+const require_react_client_nextAuth_isSessionReady = require("./nextAuth/isSessionReady.cjs");
+const require_react_client_nextAuth_nextAuth = require("./nextAuth/nextAuth.cjs");
+const require_LazyLoad = require("./LazyLoad.cjs");
+exports.LazyLoad = require_LazyLoad.LazyLoad;
+exports.NextAuthState = require_react_client_nextAuth_nextAuth.NextAuthState;
+exports.cn = require_react_client_cn.cn;
+exports.isSessionReady = require_react_client_nextAuth_isSessionReady.isSessionReady;
+exports.useAsyncEffect = require_react_client_hooks_useAsyncEffect.useAsyncEffect;
+exports.useCopyText = require_react_client_hooks_useCopyText.useCopyText;
+exports.usePrefersReducedMotion = require_react_client_hooks_usePrefersReducedMotion.usePrefersReducedMotion;

package/dist/react/client/index.d.cts

@@ -0,0 +1,8 @@
+import { cn } from "./cn.cjs";
+import { useAsyncEffect } from "./hooks/useAsyncEffect.cjs";
+import { useCopyText } from "./hooks/useCopyText.cjs";
+import { usePrefersReducedMotion } from "./hooks/usePrefersReducedMotion.cjs";
+import { isSessionReady } from "./nextAuth/isSessionReady.cjs";
+import { NextAuthState } from "./nextAuth/nextAuth.cjs";
+import { LazyLoad } from "./LazyLoad.cjs";
+export { LazyLoad, NextAuthState, cn, isSessionReady, useAsyncEffect, useCopyText, usePrefersReducedMotion };

package/dist/react/client/index.d.mts

@@ -0,0 +1,8 @@
+import { cn } from "./cn.mjs";
+import { useAsyncEffect } from "./hooks/useAsyncEffect.mjs";
+import { useCopyText } from "./hooks/useCopyText.mjs";
+import { usePrefersReducedMotion } from "./hooks/usePrefersReducedMotion.mjs";
+import { isSessionReady } from "./nextAuth/isSessionReady.mjs";
+import { NextAuthState } from "./nextAuth/nextAuth.mjs";
+import { LazyLoad } from "./LazyLoad.mjs";
+export { LazyLoad, NextAuthState, cn, isSessionReady, useAsyncEffect, useCopyText, usePrefersReducedMotion };

package/dist/react/client/index.mjs

@@ -0,0 +1,8 @@
+import { cn } from "./cn.mjs";
+import { useAsyncEffect } from "./hooks/useAsyncEffect.mjs";
+import { useCopyText } from "./hooks/useCopyText.mjs";
+import { usePrefersReducedMotion } from "./hooks/usePrefersReducedMotion.mjs";
+import { isSessionReady } from "./nextAuth/isSessionReady.mjs";
+import { NextAuthState } from "./nextAuth/nextAuth.mjs";
+import { LazyLoad } from "./LazyLoad.mjs";
+export { LazyLoad, NextAuthState, cn, isSessionReady, useAsyncEffect, useCopyText, usePrefersReducedMotion };

package/dist/react/client/nextAuth/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_react_client_nextAuth_isSessionReady = require("./isSessionReady.cjs");
+const require_react_client_nextAuth_nextAuth = require("./nextAuth.cjs");
+exports.NextAuthState = require_react_client_nextAuth_nextAuth.NextAuthState;
+exports.isSessionReady = require_react_client_nextAuth_isSessionReady.isSessionReady;

package/dist/{nextAuth → react/client/nextAuth}/isSessionReady.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/nextAuth/isSessionReady.ts
+//#region src/react/client/nextAuth/isSessionReady.ts
 const isSessionReady = (session) => {
 	return null !== session?.user;
 };

package/dist/react/client/nextAuth/isSessionReady.d.cts

@@ -0,0 +1,3 @@
+//#region src/react/client/nextAuth/isSessionReady.d.ts
+export declare const isSessionReady: (session: any) => boolean;
+//#endregion

package/dist/react/client/nextAuth/isSessionReady.d.mts

@@ -0,0 +1,3 @@
+//#region src/react/client/nextAuth/isSessionReady.d.ts
+export declare const isSessionReady: (session: any) => boolean;
+//#endregion

package/dist/{nextAuth → react/client/nextAuth}/isSessionReady.mjs

@@ -1,4 +1,4 @@
-//#region src/nextAuth/isSessionReady.ts
+//#region src/react/client/nextAuth/isSessionReady.ts
 const isSessionReady = (session) => {
 	return null !== session?.user;
 };

package/dist/{nextAuth → react/client/nextAuth}/nextAuth.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_nextAuth_isSessionReady = require("./isSessionReady.cjs");
-//#region src/nextAuth/nextAuth.ts
+const require_react_client_nextAuth_isSessionReady = require("./isSessionReady.cjs");
+//#region src/react/client/nextAuth/nextAuth.ts
 const NextAuthState = {
 	AUTHENTICATED: "authenticated",
 	PENDING: "loading",
@@ -8,4 +8,4 @@ const NextAuthState = {
 };
 //#endregion
 exports.NextAuthState = NextAuthState;
-exports.isSessionReady = require_nextAuth_isSessionReady.isSessionReady;
+exports.isSessionReady = require_react_client_nextAuth_isSessionReady.isSessionReady;

package/dist/{nextAuth → react/client/nextAuth}/nextAuth.d.cts

@@ -1,10 +1,10 @@
 import { isSessionReady } from "./isSessionReady.cjs";
-//#region src/nextAuth/nextAuth.d.ts
-declare const NextAuthState: {
+//#region src/react/client/nextAuth/nextAuth.d.ts
+export declare const NextAuthState: {
   readonly AUTHENTICATED: "authenticated";
   readonly PENDING: "loading";
   readonly UNAUTHENTICATED: "unauthenticated";
 };
-type NextAuthState = typeof NextAuthState[keyof typeof NextAuthState];
+export type NextAuthState = typeof NextAuthState[keyof typeof NextAuthState];
 //#endregion
-export { NextAuthState, isSessionReady };
+export { isSessionReady };

package/dist/{nextAuth → react/client/nextAuth}/nextAuth.d.mts

@@ -1,10 +1,10 @@
 import { isSessionReady } from "./isSessionReady.mjs";
-//#region src/nextAuth/nextAuth.d.ts
-declare const NextAuthState: {
+//#region src/react/client/nextAuth/nextAuth.d.ts
+export declare const NextAuthState: {
   readonly AUTHENTICATED: "authenticated";
   readonly PENDING: "loading";
   readonly UNAUTHENTICATED: "unauthenticated";
 };
-type NextAuthState = typeof NextAuthState[keyof typeof NextAuthState];
+export type NextAuthState = typeof NextAuthState[keyof typeof NextAuthState];
 //#endregion
-export { NextAuthState, isSessionReady };
+export { isSessionReady };

package/dist/{nextAuth → react/client/nextAuth}/nextAuth.mjs

@@ -1,5 +1,5 @@
 import { isSessionReady } from "./isSessionReady.mjs";
-//#region src/nextAuth/nextAuth.ts
+//#region src/react/client/nextAuth/nextAuth.ts
 const NextAuthState = {
 	AUTHENTICATED: "authenticated",
 	PENDING: "loading",

package/dist/react/client/nextjs/buildRelativeUrl.d.cts

@@ -0,0 +1 @@
+export {}

package/dist/react/client/nextjs/buildRelativeUrl.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/react/client/nextjs/buildRelativeUrl.mjs

@@ -0,0 +1 @@
+export {};

package/dist/regex/extractRegex.cjs

@@ -0,0 +1,31 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/regex/extractRegex.ts
+const REGEX_FLAG = "#";
+const FLAG_MODIFIER = /^\(\?([dgimsuyv]+)\)/;
+/**
+* Parses a #-delimited pattern string into a RegExp, or returns null if the pattern is plain text
+* or fails to compile (invalid syntax, duplicate flags, etc).
+*
+* A pattern must be wrapped in # characters, e.g. #asda-money#.
+* Flags are optional and must appear as a leading (?flags) group, e.g. #(?i)asda-money#.
+* The closing # must be the final character — nothing is permitted after it.
+*
+* An external flags argument (e.g. "g") is merged with any modifier flags, duplicates removed.
+*/
+const extractRegex = (pattern, flags) => {
+	if (!pattern.startsWith(REGEX_FLAG) || pattern.length < 3) return null;
+	const closingIndex = pattern.lastIndexOf(REGEX_FLAG);
+	if (closingIndex === 0 || closingIndex !== pattern.length - 1) return null;
+	const rawContent = pattern.slice(1, closingIndex);
+	const modifierMatch = rawContent.match(FLAG_MODIFIER);
+	const modifierFlags = modifierMatch ? modifierMatch[1] : "";
+	const regexContent = modifierMatch ? rawContent.slice(modifierMatch[0].length) : rawContent;
+	const mergedFlags = [.../* @__PURE__ */ new Set([...flags ?? "", ...modifierFlags])].join("");
+	try {
+		return new RegExp(regexContent, mergedFlags);
+	} catch {
+		return null;
+	}
+};
+//#endregion
+exports.extractRegex = extractRegex;

package/dist/regex/extractRegex.d.cts

@@ -0,0 +1,13 @@
+//#region src/regex/extractRegex.d.ts
+/**
+ * Parses a #-delimited pattern string into a RegExp, or returns null if the pattern is plain text
+ * or fails to compile (invalid syntax, duplicate flags, etc).
+ *
+ * A pattern must be wrapped in # characters, e.g. #asda-money#.
+ * Flags are optional and must appear as a leading (?flags) group, e.g. #(?i)asda-money#.
+ * The closing # must be the final character — nothing is permitted after it.
+ *
+ * An external flags argument (e.g. "g") is merged with any modifier flags, duplicates removed.
+ */
+export declare const extractRegex: (pattern: string, flags?: string) => RegExp | null;
+//#endregion

package/dist/regex/extractRegex.d.mts

@@ -0,0 +1,13 @@
+//#region src/regex/extractRegex.d.ts
+/**
+ * Parses a #-delimited pattern string into a RegExp, or returns null if the pattern is plain text
+ * or fails to compile (invalid syntax, duplicate flags, etc).
+ *
+ * A pattern must be wrapped in # characters, e.g. #asda-money#.
+ * Flags are optional and must appear as a leading (?flags) group, e.g. #(?i)asda-money#.
+ * The closing # must be the final character — nothing is permitted after it.
+ *
+ * An external flags argument (e.g. "g") is merged with any modifier flags, duplicates removed.
+ */
+export declare const extractRegex: (pattern: string, flags?: string) => RegExp | null;
+//#endregion

package/dist/regex/extractRegex.mjs

@@ -0,0 +1,30 @@
+//#region src/regex/extractRegex.ts
+const REGEX_FLAG = "#";
+const FLAG_MODIFIER = /^\(\?([dgimsuyv]+)\)/;
+/**
+* Parses a #-delimited pattern string into a RegExp, or returns null if the pattern is plain text
+* or fails to compile (invalid syntax, duplicate flags, etc).
+*
+* A pattern must be wrapped in # characters, e.g. #asda-money#.
+* Flags are optional and must appear as a leading (?flags) group, e.g. #(?i)asda-money#.
+* The closing # must be the final character — nothing is permitted after it.
+*
+* An external flags argument (e.g. "g") is merged with any modifier flags, duplicates removed.
+*/
+const extractRegex = (pattern, flags) => {
+	if (!pattern.startsWith(REGEX_FLAG) || pattern.length < 3) return null;
+	const closingIndex = pattern.lastIndexOf(REGEX_FLAG);
+	if (closingIndex === 0 || closingIndex !== pattern.length - 1) return null;
+	const rawContent = pattern.slice(1, closingIndex);
+	const modifierMatch = rawContent.match(FLAG_MODIFIER);
+	const modifierFlags = modifierMatch ? modifierMatch[1] : "";
+	const regexContent = modifierMatch ? rawContent.slice(modifierMatch[0].length) : rawContent;
+	const mergedFlags = [.../* @__PURE__ */ new Set([...flags ?? "", ...modifierFlags])].join("");
+	try {
+		return new RegExp(regexContent, mergedFlags);
+	} catch {
+		return null;
+	}
+};
+//#endregion
+export { extractRegex };

package/dist/regex/index.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_regex_extractRegex = require("./extractRegex.cjs");
+exports.extractRegex = require_regex_extractRegex.extractRegex;

package/dist/regex/index.d.cts

@@ -0,0 +1,2 @@
+import { extractRegex } from "./extractRegex.cjs";
+export { extractRegex };

package/dist/regex/index.d.mts

@@ -0,0 +1,2 @@
+import { extractRegex } from "./extractRegex.mjs";
+export { extractRegex };

package/dist/regex/index.mjs

@@ -0,0 +1,2 @@
+import { extractRegex } from "./extractRegex.mjs";
+export { extractRegex };

package/dist/snapchat/server/Snapchat.d.cts

@@ -1,6 +1,6 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
 //#region src/snapchat/server/Snapchat.d.ts
-type SnapchatConfig = {
+export type SnapchatConfig = {
   clientId: string;
   clientSecret: string;
   refreshToken: string;
@@ -9,7 +9,7 @@ type Client = {
   expires: number;
   refreshToken: string;
 };
-declare class Snapchat extends BaseNamespace {
+export declare class Snapchat extends BaseNamespace {
   client: Client;
   config: SnapchatConfig;
   /**
@@ -17,5 +17,4 @@ declare class Snapchat extends BaseNamespace {
    */
   init: (config: SnapchatConfig) => Promise<this>;
 }
-//#endregion
-export { Snapchat, SnapchatConfig };
+//#endregion

package/dist/snapchat/server/Snapchat.d.mts

@@ -1,6 +1,6 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
 //#region src/snapchat/server/Snapchat.d.ts
-type SnapchatConfig = {
+export type SnapchatConfig = {
   clientId: string;
   clientSecret: string;
   refreshToken: string;
@@ -9,7 +9,7 @@ type Client = {
   expires: number;
   refreshToken: string;
 };
-declare class Snapchat extends BaseNamespace {
+export declare class Snapchat extends BaseNamespace {
   client: Client;
   config: SnapchatConfig;
   /**
@@ -17,5 +17,4 @@ declare class Snapchat extends BaseNamespace {
    */
   init: (config: SnapchatConfig) => Promise<this>;
 }
-//#endregion
-export { Snapchat, SnapchatConfig };
+//#endregion

package/dist/sorting/byNumberAscending.d.cts

@@ -2,6 +2,5 @@
 /**
  * Take two values, ensure they are numbers and return the sorting value.
  */
-declare const byNumberAscending: (valueA: any, valueB: any) => number;
-//#endregion
-export { byNumberAscending };
+export declare const byNumberAscending: (valueA: any, valueB: any) => number;
+//#endregion

package/dist/sorting/byNumberAscending.d.mts

@@ -2,6 +2,5 @@
 /**
  * Take two values, ensure they are numbers and return the sorting value.
  */
-declare const byNumberAscending: (valueA: any, valueB: any) => number;
-//#endregion
-export { byNumberAscending };
+export declare const byNumberAscending: (valueA: any, valueB: any) => number;
+//#endregion

package/dist/sorting/byNumberDescending.d.cts

@@ -2,6 +2,5 @@
 /**
  * Take two values, ensure they are numbers and return the sorting value.
  */
-declare const byNumberDescending: (valueA: any, valueB: any) => number;
-//#endregion
-export { byNumberDescending };
+export declare const byNumberDescending: (valueA: any, valueB: any) => number;
+//#endregion

package/dist/sorting/byNumberDescending.d.mts

@@ -2,6 +2,5 @@
 /**
  * Take two values, ensure they are numbers and return the sorting value.
  */
-declare const byNumberDescending: (valueA: any, valueB: any) => number;
-//#endregion
-export { byNumberDescending };
+export declare const byNumberDescending: (valueA: any, valueB: any) => number;
+//#endregion

package/dist/sorting/byStringAscending.d.cts

@@ -2,6 +2,5 @@
 /**
  * Take two values, clean the strings and return the sorting value.
  */
-declare const byStringAscending: (valueA: any, valueB: any) => string;
-//#endregion
-export { byStringAscending };
+export declare const byStringAscending: (valueA: any, valueB: any) => string;
+//#endregion

package/dist/sorting/byStringAscending.d.mts

@@ -2,6 +2,5 @@
 /**
  * Take two values, clean the strings and return the sorting value.
  */
-declare const byStringAscending: (valueA: any, valueB: any) => string;
-//#endregion
-export { byStringAscending };
+export declare const byStringAscending: (valueA: any, valueB: any) => string;
+//#endregion

package/dist/sorting/byStringDescending.d.cts

@@ -2,6 +2,5 @@
 /**
  * Take two values, clean the strings and return the sorting value.
  */
-declare const byStringDescending: (valueA: any, valueB: any) => string;
-//#endregion
-export { byStringDescending };
+export declare const byStringDescending: (valueA: any, valueB: any) => string;
+//#endregion

package/dist/sorting/byStringDescending.d.mts

@@ -2,6 +2,5 @@
 /**
  * Take two values, clean the strings and return the sorting value.
  */
-declare const byStringDescending: (valueA: any, valueB: any) => string;
-//#endregion
-export { byStringDescending };
+export declare const byStringDescending: (valueA: any, valueB: any) => string;
+//#endregion

package/dist/stream/server/sort.d.cts

@@ -11,6 +11,5 @@ declare class SortStreamer<T> extends Transform {
   _transform(data: T, _: BufferEncoding, callback: TransformCallback): void;
   _flush(callback: TransformCallback): void;
 }
-declare const sort: <T>(comp: (a: T, b: T) => number, options?: TransformOptions) => SortStreamer<T>;
-//#endregion
-export { sort };
+export declare const sort: <T>(comp: (a: T, b: T) => number, options?: TransformOptions) => SortStreamer<T>;
+//#endregion

package/dist/stream/server/sort.d.mts

@@ -11,6 +11,5 @@ declare class SortStreamer<T> extends Transform {
   _transform(data: T, _: BufferEncoding, callback: TransformCallback): void;
   _flush(callback: TransformCallback): void;
 }
-declare const sort: <T>(comp: (a: T, b: T) => number, options?: TransformOptions) => SortStreamer<T>;
-//#endregion
-export { sort };
+export declare const sort: <T>(comp: (a: T, b: T) => number, options?: TransformOptions) => SortStreamer<T>;
+//#endregion

package/dist/string/client/copyText.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/string/client/copyText.ts
+/**
+* Copy a string to the clipboard using the browser's Clipboard API.
+* Returns false if the API is unavailable or the write fails, rather than throwing.
+*/
+const copyText = async (text) => {
+	if (!navigator?.clipboard) return false;
+	try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch (error) {
+		return false;
+	}
+};
+//#endregion
+exports.copyText = copyText;

package/dist/string/client/copyText.d.cts

@@ -0,0 +1,7 @@
+//#region src/string/client/copyText.d.ts
+/**
+ * Copy a string to the clipboard using the browser's Clipboard API.
+ * Returns false if the API is unavailable or the write fails, rather than throwing.
+ */
+export declare const copyText: (text: string) => Promise<boolean>;
+//#endregion

package/dist/string/client/copyText.d.mts

@@ -0,0 +1,7 @@
+//#region src/string/client/copyText.d.ts
+/**
+ * Copy a string to the clipboard using the browser's Clipboard API.
+ * Returns false if the API is unavailable or the write fails, rather than throwing.
+ */
+export declare const copyText: (text: string) => Promise<boolean>;
+//#endregion

package/dist/string/client/copyText.mjs

@@ -0,0 +1,16 @@
+//#region src/string/client/copyText.ts
+/**
+* Copy a string to the clipboard using the browser's Clipboard API.
+* Returns false if the API is unavailable or the write fails, rather than throwing.
+*/
+const copyText = async (text) => {
+	if (!navigator?.clipboard) return false;
+	try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch (error) {
+		return false;
+	}
+};
+//#endregion
+export { copyText };

package/dist/string/client/index.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_string_reservedWords = require("../reservedWords.cjs");
+const require_string_getCapitalised = require("../getCapitalised.cjs");
+const require_string_getString = require("../getString.cjs");
+const require_string_getWithoutHtmlTags = require("../getWithoutHtmlTags.cjs");
+const require_string_getWithoutAccents = require("../getWithoutAccents.cjs");
+const require_string_getProperCase = require("../getProperCase.cjs");
+const require_string_getWithoutWhitespaces = require("../getWithoutWhitespaces.cjs");
+const require_string_getWithoutPunctuation = require("../getWithoutPunctuation.cjs");
+const require_string_getWithoutUnderscores = require("../getWithoutUnderscores.cjs");
+const require_string_getUnescaped = require("../getUnescaped.cjs");
+const require_string_getClean = require("../getClean.cjs");
+const require_string_getFolder = require("../getFolder.cjs");
+const require_string_getNormalisedTypography = require("../getNormalisedTypography.cjs");
+const require_string_getStringFromStream = require("../getStringFromStream.cjs");
+require("../index.cjs");
+const require_string_client_copyText = require("./copyText.cjs");
+exports.copyText = require_string_client_copyText.copyText;
+exports.getCapitalised = require_string_getCapitalised.getCapitalised;
+exports.getClean = require_string_getClean.getClean;
+exports.getFolder = require_string_getFolder.getFolder;
+exports.getNormalisedTypography = require_string_getNormalisedTypography.getNormalisedTypography;
+exports.getProperCase = require_string_getProperCase.getProperCase;
+exports.getString = require_string_getString.getString;
+exports.getStringFromStream = require_string_getStringFromStream.getStringFromStream;
+exports.getUnescaped = require_string_getUnescaped.getUnescaped;
+exports.getWithoutAccents = require_string_getWithoutAccents.getWithoutAccents;
+exports.getWithoutHtmlTags = require_string_getWithoutHtmlTags.getWithoutHtmlTags;
+exports.getWithoutPunctuation = require_string_getWithoutPunctuation.getWithoutPunctuation;
+exports.getWithoutUnderscores = require_string_getWithoutUnderscores.getWithoutUnderscores;
+exports.getWithoutWhitespaces = require_string_getWithoutWhitespaces.getWithoutWhitespaces;
+exports.isReservedWord = require_string_reservedWords.isReservedWord;
+exports.reservedWords = require_string_reservedWords.reservedWords;

package/dist/string/client/index.d.cts

@@ -0,0 +1,16 @@
+import { copyText } from "./copyText.cjs";
+import { getCapitalised } from "../getCapitalised.cjs";
+import { getClean } from "../getClean.cjs";
+import { getFolder } from "../getFolder.cjs";
+import { getNormalisedTypography } from "../getNormalisedTypography.cjs";
+import { getProperCase } from "../getProperCase.cjs";
+import { getString } from "../getString.cjs";
+import { getStringFromStream } from "../getStringFromStream.cjs";
+import { getUnescaped } from "../getUnescaped.cjs";
+import { getWithoutAccents } from "../getWithoutAccents.cjs";
+import { getWithoutHtmlTags } from "../getWithoutHtmlTags.cjs";
+import { getWithoutPunctuation } from "../getWithoutPunctuation.cjs";
+import { getWithoutUnderscores } from "../getWithoutUnderscores.cjs";
+import { getWithoutWhitespaces } from "../getWithoutWhitespaces.cjs";
+import { isReservedWord, reservedWords } from "../reservedWords.cjs";
+export { copyText, getCapitalised, getClean, getFolder, getNormalisedTypography, getProperCase, getString, getStringFromStream, getUnescaped, getWithoutAccents, getWithoutHtmlTags, getWithoutPunctuation, getWithoutUnderscores, getWithoutWhitespaces, isReservedWord, reservedWords };

package/dist/string/client/index.d.mts

@@ -0,0 +1,16 @@
+import { copyText } from "./copyText.mjs";
+import { getCapitalised } from "../getCapitalised.mjs";
+import { getClean } from "../getClean.mjs";
+import { getFolder } from "../getFolder.mjs";
+import { getNormalisedTypography } from "../getNormalisedTypography.mjs";
+import { getProperCase } from "../getProperCase.mjs";
+import { getString } from "../getString.mjs";
+import { getStringFromStream } from "../getStringFromStream.mjs";
+import { getUnescaped } from "../getUnescaped.mjs";
+import { getWithoutAccents } from "../getWithoutAccents.mjs";
+import { getWithoutHtmlTags } from "../getWithoutHtmlTags.mjs";
+import { getWithoutPunctuation } from "../getWithoutPunctuation.mjs";
+import { getWithoutUnderscores } from "../getWithoutUnderscores.mjs";
+import { getWithoutWhitespaces } from "../getWithoutWhitespaces.mjs";
+import { isReservedWord, reservedWords } from "../reservedWords.mjs";
+export { copyText, getCapitalised, getClean, getFolder, getNormalisedTypography, getProperCase, getString, getStringFromStream, getUnescaped, getWithoutAccents, getWithoutHtmlTags, getWithoutPunctuation, getWithoutUnderscores, getWithoutWhitespaces, isReservedWord, reservedWords };