@ac-kit/core 0.1.0

package/dist/string/ascii/is-ascii-octal-digit.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `isodigit` — whether `code` is an ASCII octal digit
+ * (`0`-`7`).
+ */
+export declare function isAsciiOctalDigit(code: number): boolean;
+//# sourceMappingURL=is-ascii-octal-digit.d.ts.map

package/dist/string/ascii/is-ascii-octal-digit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-octal-digit.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-octal-digit.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/string/ascii/is-ascii-octal-digit.js

@@ -0,0 +1,9 @@
+import { DIGIT_SEVEN, DIGIT_ZERO } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isodigit` — whether `code` is an ASCII octal digit
+ * (`0`-`7`).
+ */
+export function isAsciiOctalDigit(code) {
+    return code >= DIGIT_ZERO && code <= DIGIT_SEVEN;
+}
+//# sourceMappingURL=is-ascii-octal-digit.js.map

package/dist/string/ascii/is-ascii-octal-digit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-octal-digit.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-octal-digit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,WAAW,CAAC;AAClD,CAAC"}

package/dist/string/ascii/is-ascii-upper-alpha.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `isupper` — whether `code` is an ASCII uppercase letter
+ * (`A`-`Z`).
+ */
+export declare function isAsciiUpperAlpha(code: number): boolean;
+//# sourceMappingURL=is-ascii-upper-alpha.d.ts.map

package/dist/string/ascii/is-ascii-upper-alpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-upper-alpha.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-upper-alpha.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/string/ascii/is-ascii-upper-alpha.js

@@ -0,0 +1,9 @@
+import { UPPERCASE_A, UPPERCASE_Z } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isupper` — whether `code` is an ASCII uppercase letter
+ * (`A`-`Z`).
+ */
+export function isAsciiUpperAlpha(code) {
+    return code >= UPPERCASE_A && code <= UPPERCASE_Z;
+}
+//# sourceMappingURL=is-ascii-upper-alpha.js.map

package/dist/string/ascii/is-ascii-upper-alpha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-upper-alpha.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-upper-alpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,CAAC;AACnD,CAAC"}

package/dist/string/ascii/is-ascii-whitespace.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Equivalent to C's `isspace` — whether `code` is an ASCII whitespace
+ * character: space, or one of the contiguous `HT`-`CR` (`\t`, `\n`, `\v`, `\f`,
+ * `\r`) control codes.
+ */
+export declare function isAsciiWhitespace(code: number): boolean;
+//# sourceMappingURL=is-ascii-whitespace.d.ts.map

package/dist/string/ascii/is-ascii-whitespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-whitespace.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-whitespace.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/string/ascii/is-ascii-whitespace.js

@@ -0,0 +1,10 @@
+import { CR, HT, SPACE } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isspace` — whether `code` is an ASCII whitespace
+ * character: space, or one of the contiguous `HT`-`CR` (`\t`, `\n`, `\v`, `\f`,
+ * `\r`) control codes.
+ */
+export function isAsciiWhitespace(code) {
+    return code === SPACE || (code >= HT && code <= CR);
+}
+//# sourceMappingURL=is-ascii-whitespace.js.map

package/dist/string/ascii/is-ascii-whitespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-whitespace.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-whitespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/string/capitalize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capitalizes the first letter of a string and the remaining letters as lower
+ * case.
+ *
+ * @param value The input string.
+ * @returns The capitalized string.
+ */
+export declare function capitalize(value: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/string/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../src/string/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/string/capitalize.js

@@ -0,0 +1,14 @@
+/**
+ * Capitalizes the first letter of a string and the remaining letters as lower
+ * case.
+ *
+ * @param value The input string.
+ * @returns The capitalized string.
+ */
+export function capitalize(value) {
+    if (value[0] === undefined) {
+        return value;
+    }
+    return value[0].toUpperCase() + value.slice(1).toLowerCase();
+}
+//# sourceMappingURL=capitalize.js.map

package/dist/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../src/string/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9D,CAAC"}

package/dist/string/case/camel-case.d.ts

@@ -0,0 +1,17 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type CamelCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to camel case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to camel case.
+ */
+export declare function buildCamelCase(options?: StringCaseOptions): CamelCaseFn;
+/**
+ * Converts a string to camel case.
+ *
+ * @param input The input string.
+ * @returns The camel cased string.
+ */
+export declare const camelCase: CamelCaseFn;
+//# sourceMappingURL=camel-case.d.ts.map

package/dist/string/case/camel-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/camel-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAYvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/camel-case.js

@@ -0,0 +1,25 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to camel case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to camel case.
+ */
+export function buildCamelCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const leadingRe = new RegExp(`^(?:${sep})+`);
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(leadingRe, "")
+        .toLowerCase()
+        .replace(mainRe, (_, p1) => (p1 ?? "").toUpperCase());
+}
+/**
+ * Converts a string to camel case.
+ *
+ * @param input The input string.
+ * @returns The camel cased string.
+ */
+export const camelCase = buildCamelCase();
+//# sourceMappingURL=camel-case.js.map

package/dist/string/case/camel-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.js","sourceRoot":"","sources":["../../../src/string/case/camel-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/case/case-options.d.ts

@@ -0,0 +1,15 @@
+import { Pattern } from "../../pattern/types.js";
+export type StringCaseOptions = {
+    /**
+     * Regex pattern matching characters that act as word delimiters. Default:
+     * `[_.\\- ]`
+     */
+    separators?: Pattern;
+    /**
+     * Regex pattern matching non-separator characters to keep when following a
+     * separator. Default: `.`
+     */
+    keep?: Pattern;
+};
+export declare const STRING_CASE_DEFAULT_OPTIONS: Required<StringCaseOptions>;
+//# sourceMappingURL=case-options.d.ts.map

package/dist/string/case/case-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-options.d.ts","sourceRoot":"","sources":["../../../src/string/case/case-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAGnE,CAAC"}

package/dist/string/case/case-options.js

@@ -0,0 +1,5 @@
+export const STRING_CASE_DEFAULT_OPTIONS = {
+    separators: "[_.\\- ]",
+    keep: ".",
+};
+//# sourceMappingURL=case-options.js.map

package/dist/string/case/case-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-options.js","sourceRoot":"","sources":["../../../src/string/case/case-options.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,2BAA2B,GAAgC;IACvE,UAAU,EAAE,UAAU;IACtB,IAAI,EAAE,GAAG;CACT,CAAC"}

package/dist/string/case/kebab-case.d.ts

@@ -0,0 +1,17 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type KebabCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to kebab case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to kebab case.
+ */
+export declare function buildKebabCase(options?: StringCaseOptions): KebabCaseFn;
+/**
+ * Converts a string to kebab case.
+ *
+ * @param input The input string.
+ * @returns The kebab cased string.
+ */
+export declare const kebabCase: KebabCaseFn;
+//# sourceMappingURL=kebab-case.d.ts.map

package/dist/string/case/kebab-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/kebab-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAYvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/kebab-case.js

@@ -0,0 +1,25 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to kebab case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to kebab case.
+ */
+export function buildKebabCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const trimRe = new RegExp(`(?:^(?:${sep})+)|(?:(?:${sep})+$)`, "g");
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(trimRe, "")
+        .toLowerCase()
+        .replace(mainRe, (_, p1) => `-${(p1 ?? "").toLowerCase()}`);
+}
+/**
+ * Converts a string to kebab case.
+ *
+ * @param input The input string.
+ * @returns The kebab cased string.
+ */
+export const kebabCase = buildKebabCase();
+//# sourceMappingURL=kebab-case.js.map

package/dist/string/case/kebab-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.js","sourceRoot":"","sources":["../../../src/string/case/kebab-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/case/lower-case.d.ts

@@ -0,0 +1,17 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type LowerCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to lower case with spaces.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to lower case with spaces.
+ */
+export declare function buildLowerCase(options?: StringCaseOptions): LowerCaseFn;
+/**
+ * Converts a string to lower case, replacing word separators with spaces.
+ *
+ * @param input The input string.
+ * @returns The lower cased string.
+ */
+export declare const lowerCase: LowerCaseFn;
+//# sourceMappingURL=lower-case.d.ts.map

package/dist/string/case/lower-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/lower-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAYvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/lower-case.js

@@ -0,0 +1,25 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to lower case with spaces.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to lower case with spaces.
+ */
+export function buildLowerCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const trimRe = new RegExp(`(?:^(?:${sep})+)|(?:(?:${sep})+$)`, "g");
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(trimRe, "")
+        .toLowerCase()
+        .replace(mainRe, (_, p1) => ` ${(p1 ?? "").toLowerCase()}`);
+}
+/**
+ * Converts a string to lower case, replacing word separators with spaces.
+ *
+ * @param input The input string.
+ * @returns The lower cased string.
+ */
+export const lowerCase = buildLowerCase();
+//# sourceMappingURL=lower-case.js.map

package/dist/string/case/lower-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-case.js","sourceRoot":"","sources":["../../../src/string/case/lower-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/case/snake-case.d.ts

@@ -0,0 +1,21 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type SnakeCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to snake case.
+ *
+ * Rules: - Leading/trailing separators are removed. - All letters are converted
+ * to lowercase. - Separators are replaced with underscores. - Multiple
+ * consecutive separators are collapsed to a single underscore.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to snake case.
+ */
+export declare function buildSnakeCase(options?: StringCaseOptions): (input: string) => string;
+/**
+ * Converts a string to snake case.
+ *
+ * @param input The input string.
+ * @returns The snake cased string.
+ */
+export declare const snakeCase: SnakeCaseFn;
+//# sourceMappingURL=snake-case.d.ts.map

package/dist/string/case/snake-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/snake-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC7B,OAAO,CAAC,EAAE,iBAAiB,GACzB,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAY3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/snake-case.js

@@ -0,0 +1,29 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to snake case.
+ *
+ * Rules: - Leading/trailing separators are removed. - All letters are converted
+ * to lowercase. - Separators are replaced with underscores. - Multiple
+ * consecutive separators are collapsed to a single underscore.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to snake case.
+ */
+export function buildSnakeCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const trimRe = new RegExp(`(?:^(?:${sep})+)|(?:(?:${sep})+$)`, "g");
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(trimRe, "")
+        .toLowerCase()
+        .replace(mainRe, (_, p1) => `_${(p1 ?? "").toLowerCase()}`);
+}
+/**
+ * Converts a string to snake case.
+ *
+ * @param input The input string.
+ * @returns The snake cased string.
+ */
+export const snakeCase = buildSnakeCase();
+//# sourceMappingURL=snake-case.js.map

package/dist/string/case/snake-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case.js","sourceRoot":"","sources":["../../../src/string/case/snake-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC7B,OAA2B;IAE3B,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/case/start-case.d.ts

@@ -0,0 +1,18 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type StartCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to start case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to start case.
+ */
+export declare function buildStartCase(options?: StringCaseOptions): StartCaseFn;
+/**
+ * Converts a string to start case, replacing word separators with spaces and
+ * capitalizing the first letter of each word.
+ *
+ * @param input The input string.
+ * @returns The start cased string.
+ */
+export declare const startCase: StartCaseFn;
+//# sourceMappingURL=start-case.d.ts.map

package/dist/string/case/start-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/start-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAavE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/start-case.js

@@ -0,0 +1,27 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to start case.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to start case.
+ */
+export function buildStartCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const trimRe = new RegExp(`(?:^(?:${sep})+)|(?:(?:${sep})+$)`, "g");
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(trimRe, "")
+        .toLowerCase()
+        .replace(mainRe, (_, p1) => ` ${(p1 ?? "").toUpperCase()}`)
+        .replace(/^\w/, (c) => c.toUpperCase());
+}
+/**
+ * Converts a string to start case, replacing word separators with spaces and
+ * capitalizing the first letter of each word.
+ *
+ * @param input The input string.
+ * @returns The start cased string.
+ */
+export const startCase = buildStartCase();
+//# sourceMappingURL=start-case.js.map

package/dist/string/case/start-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-case.js","sourceRoot":"","sources":["../../../src/string/case/start-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;SAC1D,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/case/upper-case.d.ts

@@ -0,0 +1,18 @@
+import type { StringCaseOptions } from "./case-options.js";
+export type UpperCaseFn = (input: string) => string;
+/**
+ * Creates a function that converts strings to upper case with spaces.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to upper case with spaces.
+ */
+export declare function buildUpperCase(options?: StringCaseOptions): UpperCaseFn;
+/**
+ * Converts a string to upper case, replacing word separators with spaces.
+ *
+ * @param input The input string.
+ * @returns The string converted to upper case, with word separators replaced by
+ *   spaces.
+ */
+export declare const upperCase: UpperCaseFn;
+//# sourceMappingURL=upper-case.d.ts.map

package/dist/string/case/upper-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upper-case.d.ts","sourceRoot":"","sources":["../../../src/string/case/upper-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAYvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAA8B,CAAC"}

package/dist/string/case/upper-case.js

@@ -0,0 +1,26 @@
+import { defaults } from "../../object/defaults.js";
+import { STRING_CASE_DEFAULT_OPTIONS } from "./case-options.js";
+/**
+ * Creates a function that converts strings to upper case with spaces.
+ *
+ * @param options Options to customise separators and kept characters.
+ * @returns A function that converts strings to upper case with spaces.
+ */
+export function buildUpperCase(options) {
+    const { separators: sep, keep } = defaults(options, STRING_CASE_DEFAULT_OPTIONS);
+    const trimRe = new RegExp(`(?:^(?:${sep})+)|(?:(?:${sep})+$)`, "g");
+    const mainRe = new RegExp(`(?:${sep})+((?:${keep})|$)`, "g");
+    return (input) => input
+        .replace(trimRe, "")
+        .toUpperCase()
+        .replace(mainRe, (_, p1) => ` ${(p1 ?? "").toUpperCase()}`);
+}
+/**
+ * Converts a string to upper case, replacing word separators with spaces.
+ *
+ * @param input The input string.
+ * @returns The string converted to upper case, with word separators replaced by
+ *   spaces.
+ */
+export const upperCase = buildUpperCase();
+//# sourceMappingURL=upper-case.js.map

package/dist/string/case/upper-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upper-case.js","sourceRoot":"","sources":["../../../src/string/case/upper-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CACzC,OAAO,EACP,2BAA2B,CAC3B,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK;SACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB,cAAc,EAAE,CAAC"}

package/dist/string/dedent.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Removes the longest whitespace prefix shared by every non-blank line.
+ *
+ * The inverse of {@link prefixLines}: text indented to sit inside a block of
+ * code reads as an accident once it is lifted out of it. Blank lines are
+ * ignored when measuring, since a trailing line of zero length would otherwise
+ * force the common prefix to the empty string; they are emitted as empty rather
+ * than kept as runs of spaces.
+ *
+ * Tabs and spaces are compared as characters, not expanded to columns — mixing
+ * them within one block is what makes an expansion necessary, and guessing a
+ * tab width there would silently pick one indentation over another.
+ *
+ * O(n) in the total length of the text.
+ *
+ * @param text The text to dedent, as a string or as lines.
+ * @returns The dedented lines.
+ */
+export declare function dedentLines(text: string | string[]): string[];
+/**
+ * {@link dedentLines}, rejoined with `\n`.
+ *
+ * @param text The text to dedent.
+ * @returns The dedented text.
+ */
+export declare function dedent(text: string | string[]): string;
+//# sourceMappingURL=dedent.d.ts.map

package/dist/string/dedent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedent.d.ts","sourceRoot":"","sources":["../../src/string/dedent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CA8B7D;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAEtD"}

package/dist/string/dedent.js

@@ -0,0 +1,51 @@
+/**
+ * Removes the longest whitespace prefix shared by every non-blank line.
+ *
+ * The inverse of {@link prefixLines}: text indented to sit inside a block of
+ * code reads as an accident once it is lifted out of it. Blank lines are
+ * ignored when measuring, since a trailing line of zero length would otherwise
+ * force the common prefix to the empty string; they are emitted as empty rather
+ * than kept as runs of spaces.
+ *
+ * Tabs and spaces are compared as characters, not expanded to columns — mixing
+ * them within one block is what makes an expansion necessary, and guessing a
+ * tab width there would silently pick one indentation over another.
+ *
+ * O(n) in the total length of the text.
+ *
+ * @param text The text to dedent, as a string or as lines.
+ * @returns The dedented lines.
+ */
+export function dedentLines(text) {
+    const lines = (Array.isArray(text) ? text : [text]).flatMap((line) => line.split(/\r?\n/));
+    let common = null;
+    for (const line of lines) {
+        if (line.trim().length === 0) {
+            continue;
+        }
+        const indent = /^[ \t]*/.exec(line)?.[0] ?? "";
+        if (common === null) {
+            common = indent;
+            continue;
+        }
+        let shared = 0;
+        while (shared < common.length &&
+            shared < indent.length &&
+            common[shared] === indent[shared]) {
+            shared++;
+        }
+        common = common.slice(0, shared);
+    }
+    const width = common?.length ?? 0;
+    return lines.map((line) => line.trim().length === 0 ? "" : line.slice(width));
+}
+/**
+ * {@link dedentLines}, rejoined with `\n`.
+ *
+ * @param text The text to dedent.
+ * @returns The dedented text.
+ */
+export function dedent(text) {
+    return dedentLines(text).join("\n");
+}
+//# sourceMappingURL=dedent.js.map

package/dist/string/dedent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedent.js","sourceRoot":"","sources":["../../src/string/dedent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAuB;IAClD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CACnB,CAAC;IAEF,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,MAAM,CAAC;YAChB,SAAS;QACV,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OACC,MAAM,GAAG,MAAM,CAAC,MAAM;YACtB,MAAM,GAAG,MAAM,CAAC,MAAM;YACtB,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,EAChC,CAAC;YACF,MAAM,EAAE,CAAC;QACV,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CACjD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAuB;IAC7C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/string/join-non-empty.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Joins non-empty strings from an array using the specified separator.
+ *
+ * @param values The array of strings to join.
+ * @param separator The separator to use between non-empty strings.
+ * @returns The joined string.
+ */
+export declare function joinNonEmpty(values: readonly (string | null | undefined)[], separator: string): string;
+//# sourceMappingURL=join-non-empty.d.ts.map

package/dist/string/join-non-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-non-empty.d.ts","sourceRoot":"","sources":["../../src/string/join-non-empty.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC9C,SAAS,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/string/join-non-empty.js

@@ -0,0 +1,13 @@
+/**
+ * Joins non-empty strings from an array using the specified separator.
+ *
+ * @param values The array of strings to join.
+ * @param separator The separator to use between non-empty strings.
+ * @returns The joined string.
+ */
+export function joinNonEmpty(values, separator) {
+    return values
+        .filter((v) => typeof v === "string" && v.length > 0)
+        .join(separator);
+}
+//# sourceMappingURL=join-non-empty.js.map

package/dist/string/join-non-empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-non-empty.js","sourceRoot":"","sources":["../../src/string/join-non-empty.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC3B,MAA8C,EAC9C,SAAiB;IAEjB,OAAO,MAAM;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SACpD,IAAI,CAAC,SAAS,CAAC,CAAC;AACnB,CAAC"}

package/dist/string/lower-first.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts the first letter of a string to lower case.
+ *
+ * @param input The input string.
+ * @returns The string with the first letter converted to lower case.
+ */
+export declare function lowerFirst(input: string): string;
+//# sourceMappingURL=lower-first.d.ts.map

package/dist/string/lower-first.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-first.d.ts","sourceRoot":"","sources":["../../src/string/lower-first.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD"}