@8ms/helpers 3.0.27 → 3.1.0

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 };

package/dist/string/client/index.mjs

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

package/dist/string/getCapitalised.d.cts

@@ -3,6 +3,5 @@
  * Convert a string into Capitalised Text.
  * https://stackoverflow.com/a/196991/2664955
  */
-declare const getCapitalised: (input: string, split?: string) => string;
-//#endregion
-export { getCapitalised };
+export declare const getCapitalised: (input: string, split?: string) => string;
+//#endregion

package/dist/string/getCapitalised.d.mts

@@ -3,6 +3,5 @@
  * Convert a string into Capitalised Text.
  * https://stackoverflow.com/a/196991/2664955
  */
-declare const getCapitalised: (input: string, split?: string) => string;
-//#endregion
-export { getCapitalised };
+export declare const getCapitalised: (input: string, split?: string) => string;
+//#endregion

package/dist/string/getClean.d.cts

@@ -15,6 +15,5 @@ type GetCleanProps = {
 /**
  * Shorthand function to get a clean version of a string.
  */
-declare const getClean: (props: GetCleanProps) => string;
-//#endregion
-export { getClean };
+export declare const getClean: (props: GetCleanProps) => string;
+//#endregion

package/dist/string/getClean.d.mts

@@ -15,6 +15,5 @@ type GetCleanProps = {
 /**
  * Shorthand function to get a clean version of a string.
  */
-declare const getClean: (props: GetCleanProps) => string;
-//#endregion
-export { getClean };
+export declare const getClean: (props: GetCleanProps) => string;
+//#endregion

package/dist/string/getFolder.d.cts

@@ -2,6 +2,5 @@
 /**
  * Take an input that may have a / before or after the input and return just the folder.
  */
-declare const getFolder: (input: string) => string;
-//#endregion
-export { getFolder };
+export declare const getFolder: (input: string) => string;
+//#endregion

package/dist/string/getFolder.d.mts

@@ -2,6 +2,5 @@
 /**
  * Take an input that may have a / before or after the input and return just the folder.
  */
-declare const getFolder: (input: string) => string;
-//#endregion
-export { getFolder };
+export declare const getFolder: (input: string) => string;
+//#endregion

package/dist/string/getNormalisedTypography.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/string/getNormalisedTypography.ts
+/**
+* AI output commonly substitutes "smart" typography (curly quotes, en/em dashes) for plain
+* ASCII. Patterns are authored with plain ASCII (e.g. "claridge'?s"), so the text must be
+* normalised before matching or literal/regex matches silently fail on these variants.
+*
+* INVARIANT: every substitution must be exactly one code unit for one code unit. Callers may
+* match against a normalised copy and slice the ORIGINAL string at the returned indices to
+* preserve the rendered typography - a length-changing replacement (e.g. "…" -> "...")
+* would shift every subsequent index and misplace the highlights.
+*/
+const getNormalisedTypography = (input) => {
+	return input.replace(/[‘’]/g, "'").replace(/[“”]/g, "\"").replace(/[–—]/g, "-");
+};
+//#endregion
+exports.getNormalisedTypography = getNormalisedTypography;

package/dist/string/getNormalisedTypography.d.cts

@@ -0,0 +1,13 @@
+//#region src/string/getNormalisedTypography.d.ts
+/**
+ * AI output commonly substitutes "smart" typography (curly quotes, en/em dashes) for plain
+ * ASCII. Patterns are authored with plain ASCII (e.g. "claridge'?s"), so the text must be
+ * normalised before matching or literal/regex matches silently fail on these variants.
+ *
+ * INVARIANT: every substitution must be exactly one code unit for one code unit. Callers may
+ * match against a normalised copy and slice the ORIGINAL string at the returned indices to
+ * preserve the rendered typography - a length-changing replacement (e.g. "…" -> "...")
+ * would shift every subsequent index and misplace the highlights.
+ */
+export declare const getNormalisedTypography: (input: string) => string;
+//#endregion

package/dist/string/getNormalisedTypography.d.mts

@@ -0,0 +1,13 @@
+//#region src/string/getNormalisedTypography.d.ts
+/**
+ * AI output commonly substitutes "smart" typography (curly quotes, en/em dashes) for plain
+ * ASCII. Patterns are authored with plain ASCII (e.g. "claridge'?s"), so the text must be
+ * normalised before matching or literal/regex matches silently fail on these variants.
+ *
+ * INVARIANT: every substitution must be exactly one code unit for one code unit. Callers may
+ * match against a normalised copy and slice the ORIGINAL string at the returned indices to
+ * preserve the rendered typography - a length-changing replacement (e.g. "…" -> "...")
+ * would shift every subsequent index and misplace the highlights.
+ */
+export declare const getNormalisedTypography: (input: string) => string;
+//#endregion

package/dist/string/getNormalisedTypography.mjs

@@ -0,0 +1,16 @@
+//#region src/string/getNormalisedTypography.ts
+/**
+* AI output commonly substitutes "smart" typography (curly quotes, en/em dashes) for plain
+* ASCII. Patterns are authored with plain ASCII (e.g. "claridge'?s"), so the text must be
+* normalised before matching or literal/regex matches silently fail on these variants.
+*
+* INVARIANT: every substitution must be exactly one code unit for one code unit. Callers may
+* match against a normalised copy and slice the ORIGINAL string at the returned indices to
+* preserve the rendered typography - a length-changing replacement (e.g. "…" -> "...")
+* would shift every subsequent index and misplace the highlights.
+*/
+const getNormalisedTypography = (input) => {
+	return input.replace(/[‘’]/g, "'").replace(/[“”]/g, "\"").replace(/[–—]/g, "-");
+};
+//#endregion
+export { getNormalisedTypography };