@dinilmusick/gutts 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# GutTS
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Gut stands for Global Utilities. Gut is the aggregate library for the very basic functions and operations needed by KrnlTS services, FrnlTS components, Skipo applications, and other code assets. Its purpose is to prevent multiple libraries from solving the same foundational problems.
+
+## Structure
+
+Each category is a directory with a `<category>-concepts.ts` facade. The facade re-exports small implementation files containing focused functions and category-owned shared types.
+
+Current categories: JSON, strings, arrays, objects, numbers, and URLs.
+
+## Library policy
+
+GutTS is an aggregation layer, not a collection of reimplemented utility algorithms.
+
+- Prefer mature, widely adopted, well-maintained libraries when they provide the required primitive.
+- Current third-party utility dependencies are Lodash ES modules for general-purpose collections/string/number/object operations and Validator for email validation.
+- JSON and URL operations use the platform's native implementations because `JSON` and `URL` are established runtime primitives rather than functionality that benefits from another abstraction.
+- Keep GutTS wrappers small and stable; do not duplicate the implementation of the underlying library.
+- Keep application/domain-specific behavior out of GutTS.
+
+## Design rules
+
+- Prefer small, composable functions.
+- Keep category facades stable.
+- Keep shared types beside the category that owns them.
+- Add regression tests for every public utility family.

package/dist/arrays/array-concepts.d.ts

@@ -0,0 +1,2 @@
+export { compact, unique, chunk, flatten, last } from "./array-operations.js";
+//# sourceMappingURL=array-concepts.d.ts.map

package/dist/arrays/array-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-concepts.d.ts","sourceRoot":"","sources":["../../src/arrays/array-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/arrays/array-concepts.js

@@ -0,0 +1,2 @@
+export { compact, unique, chunk, flatten, last } from "./array-operations.js";
+//# sourceMappingURL=array-concepts.js.map

package/dist/arrays/array-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-concepts.js","sourceRoot":"","sources":["../../src/arrays/array-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAC,OAAO,EAAC,IAAI,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/arrays/array-operations.d.ts

@@ -0,0 +1,6 @@
+export declare function compact<T>(values: readonly (T | null | undefined)[]): T[];
+export declare function unique<T>(values: readonly T[]): T[];
+export declare function chunk<T>(values: readonly T[], size: number): T[][];
+export declare function flatten<T>(values: readonly (T | readonly T[])[]): T[];
+export declare function last<T>(values: readonly T[]): T | undefined;
+//# sourceMappingURL=array-operations.d.ts.map

package/dist/arrays/array-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-operations.d.ts","sourceRoot":"","sources":["../../src/arrays/array-operations.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAC,SAAQ,CAAC,CAAC,GAAC,IAAI,GAAC,SAAS,CAAC,EAAE,GAAE,CAAC,EAAE,CAAsC;AACzG,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAC,SAAS,CAAC,EAAE,GAAE,CAAC,EAAE,CAAmC;AACrF,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAC,SAAS,CAAC,EAAE,EAAC,IAAI,EAAC,MAAM,GAAE,CAAC,EAAE,EAAE,CAG9D;AACD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAC,SAAQ,CAAC,CAAC,GAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAE,CAAC,EAAE,CAAwC;AACzG,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAC,SAAS,CAAC,EAAE,GAAE,CAAC,GAAC,SAAS,CAAmC"}

package/dist/arrays/array-operations.js

@@ -0,0 +1,11 @@
+import { chunk as lodashChunk, compact as lodashCompact, flatten as lodashFlatten, last as lodashLast, uniq as lodashUniq } from "lodash-es";
+export function compact(values) { return lodashCompact(values); }
+export function unique(values) { return lodashUniq(values); }
+export function chunk(values, size) {
+    if (!Number.isInteger(size) || size <= 0)
+        throw new RangeError("size must be a positive integer");
+    return lodashChunk(values, size);
+}
+export function flatten(values) { return lodashFlatten(values); }
+export function last(values) { return lodashLast(values); }
+//# sourceMappingURL=array-operations.js.map

package/dist/arrays/array-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-operations.js","sourceRoot":"","sources":["../../src/arrays/array-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,IAAI,WAAW,EAAE,OAAO,IAAI,aAAa,EAAE,OAAO,IAAI,aAAa,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,UAAU,EAAC,MAAM,WAAW,CAAC;AAE3I,MAAM,UAAU,OAAO,CAAI,MAAmC,IAAM,OAAO,aAAa,CAAC,MAAa,CAAC,CAAC,CAAA,CAAC;AACzG,MAAM,UAAU,MAAM,CAAI,MAAmB,IAAM,OAAO,UAAU,CAAC,MAAa,CAAC,CAAC,CAAA,CAAC;AACrF,MAAM,UAAU,KAAK,CAAI,MAAmB,EAAC,IAAW;IACtD,IAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAE,IAAI,IAAE,CAAC;QAAC,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;IAC5F,OAAO,WAAW,CAAC,MAAa,EAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AACD,MAAM,UAAU,OAAO,CAAI,MAAiC,IAAM,OAAO,aAAa,CAAC,MAAe,CAAC,CAAC,CAAA,CAAC;AACzG,MAAM,UAAU,IAAI,CAAI,MAAmB,IAAc,OAAO,UAAU,CAAC,MAAa,CAAC,CAAC,CAAA,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./json/json-concepts.js";
+export * from "./strings/string-concepts.js";
+export * from "./arrays/array-concepts.js";
+export * from "./objects/object-concepts.js";
+export * from "./numbers/number-concepts.js";
+export * from "./urls/url-concepts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./json/json-concepts.js";
+export * from "./strings/string-concepts.js";
+export * from "./arrays/array-concepts.js";
+export * from "./objects/object-concepts.js";
+export * from "./numbers/number-concepts.js";
+export * from "./urls/url-concepts.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC"}

package/dist/json/json-concepts.d.ts

@@ -0,0 +1,4 @@
+export type { JsonPrimitive, JsonValue, JsonObject } from "./json-value.js";
+export { isJsonValue } from "./json-value.js";
+export { parseJson, tryParseJson, stringifyJson } from "./json-parse.js";
+//# sourceMappingURL=json-concepts.d.ts.map

package/dist/json/json-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-concepts.d.ts","sourceRoot":"","sources":["../../src/json/json-concepts.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,aAAa,EAAC,SAAS,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAC,SAAS,EAAC,YAAY,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/json/json-concepts.js

@@ -0,0 +1,3 @@
+export { isJsonValue } from "./json-value.js";
+export { parseJson, tryParseJson, stringifyJson } from "./json-parse.js";
+//# sourceMappingURL=json-concepts.js.map

package/dist/json/json-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-concepts.js","sourceRoot":"","sources":["../../src/json/json-concepts.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAC,SAAS,EAAC,YAAY,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/json/json-parse.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "./json-value.js";
+export declare function parseJson<T extends JsonValue = JsonValue>(text: string): T;
+export declare function tryParseJson<T extends JsonValue = JsonValue>(text: string): T | undefined;
+export declare function stringifyJson(value: JsonValue, space?: number): string;
+//# sourceMappingURL=json-parse.d.ts.map

package/dist/json/json-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parse.d.ts","sourceRoot":"","sources":["../../src/json/json-parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC/C,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,GAAC,SAAS,EAAE,IAAI,EAAC,MAAM,GAAE,CAAC,CAA+B;AACtG,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,GAAC,SAAS,EAAE,IAAI,EAAC,MAAM,GAAE,CAAC,GAAC,SAAS,CAAyD;AAC7I,wBAAgB,aAAa,CAAC,KAAK,EAAC,SAAS,EAAC,KAAK,CAAC,EAAC,MAAM,GAAE,MAAM,CAAiJ"}

package/dist/json/json-parse.js

@@ -0,0 +1,10 @@
+export function parseJson(text) { return JSON.parse(text); }
+export function tryParseJson(text) { try {
+    return parseJson(text);
+}
+catch {
+    return undefined;
+} }
+export function stringifyJson(value, space) { const result = JSON.stringify(value, null, space); if (result === undefined)
+    throw new TypeError("Value could not be serialized as JSON"); return result; }
+//# sourceMappingURL=json-parse.js.map

package/dist/json/json-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parse.js","sourceRoot":"","sources":["../../src/json/json-parse.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAgC,IAAW,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC,CAAA,CAAC;AACtG,MAAM,UAAU,YAAY,CAAgC,IAAW,IAAc,IAAG,CAAC;IAAA,OAAO,SAAS,CAAI,IAAI,CAAC,CAAC;AAAA,CAAC;AAAA,MAAK,CAAC;IAAA,OAAO,SAAS,CAAC;AAAA,CAAC,CAAA,CAAC;AAC7I,MAAM,UAAU,aAAa,CAAC,KAAe,EAAC,KAAa,IAAS,MAAM,MAAM,GAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAA,IAAG,MAAM,KAAG,SAAS;IAAC,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC,CAAA,OAAO,MAAM,CAAC,CAAA,CAAC"}

package/dist/json/json-value.d.ts

@@ -0,0 +1,7 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare function isJsonValue(value: unknown): value is JsonValue;
+//# sourceMappingURL=json-value.d.ts.map

package/dist/json/json-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.d.ts","sourceRoot":"","sources":["../../src/json/json-value.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAC,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,CAAC;AACrD,MAAM,MAAM,SAAS,GAAC,aAAa,GAAC,UAAU,GAAC,SAAS,EAAE,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAC;IAAC,CAAC,GAAG,EAAC,MAAM,GAAE,SAAS,CAAA;CAAC,CAAC;AAChD,wBAAgB,WAAW,CAAC,KAAK,EAAC,OAAO,GAAE,KAAK,IAAI,SAAS,CAM5D"}

package/dist/json/json-value.js

@@ -0,0 +1,12 @@
+export function isJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    if (typeof value === "object")
+        return Object.values(value).every(isJsonValue);
+    return false;
+}
+//# sourceMappingURL=json-value.js.map

package/dist/json/json-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.js","sourceRoot":"","sources":["../../src/json/json-value.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,IAAG,KAAK,KAAG,IAAI,IAAE,OAAO,KAAK,KAAG,QAAQ,IAAE,OAAO,KAAK,KAAG,SAAS;QAAC,OAAO,IAAI,CAAC;IAC/E,IAAG,OAAO,KAAK,KAAG,QAAQ;QAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,IAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAC,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACxD,IAAG,OAAO,KAAK,KAAG,QAAQ;QAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAA+B,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACpG,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/numbers/number-concepts.d.ts

@@ -0,0 +1,2 @@
+export { clamp, inRange, roundTo, isFiniteNumber, sum } from "./number-operations.js";
+//# sourceMappingURL=number-concepts.d.ts.map

package/dist/numbers/number-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-concepts.d.ts","sourceRoot":"","sources":["../../src/numbers/number-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,OAAO,EAAC,OAAO,EAAC,cAAc,EAAC,GAAG,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/numbers/number-concepts.js

@@ -0,0 +1,2 @@
+export { clamp, inRange, roundTo, isFiniteNumber, sum } from "./number-operations.js";
+//# sourceMappingURL=number-concepts.js.map

package/dist/numbers/number-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-concepts.js","sourceRoot":"","sources":["../../src/numbers/number-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,OAAO,EAAC,OAAO,EAAC,cAAc,EAAC,GAAG,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/numbers/number-operations.d.ts

@@ -0,0 +1,6 @@
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function inRange(value: number, min: number, max: number): boolean;
+export declare function roundTo(value: number, decimals?: number): number;
+export declare function isFiniteNumber(value: unknown): value is number;
+export declare function sum(values: readonly number[]): number;
+//# sourceMappingURL=number-operations.d.ts.map

package/dist/numbers/number-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-operations.d.ts","sourceRoot":"","sources":["../../src/numbers/number-operations.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK,CAAC,KAAK,EAAC,MAAM,EAAC,GAAG,EAAC,MAAM,EAAC,GAAG,EAAC,MAAM,GAAE,MAAM,CAG/D;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAC,MAAM,EAAC,GAAG,EAAC,MAAM,EAAC,GAAG,EAAC,MAAM,GAAE,OAAO,CAGlE;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAC,MAAM,EAAC,QAAQ,SAAE,GAAE,MAAM,CAGtD;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAC,OAAO,GAAE,KAAK,IAAI,MAAM,CAAwD;AACrH,wBAAgB,GAAG,CAAC,MAAM,EAAC,SAAS,MAAM,EAAE,GAAE,MAAM,CAAuC"}

package/dist/numbers/number-operations.js

@@ -0,0 +1,19 @@
+import { clamp as lodashClamp, inRange as lodashInRange, isFinite as lodashIsFinite, round as lodashRound, sum as lodashSum } from "lodash-es";
+export function clamp(value, min, max) {
+    if (min > max)
+        throw new RangeError("min must not exceed max");
+    return lodashClamp(value, min, max);
+}
+export function inRange(value, min, max) {
+    if (min > max)
+        throw new RangeError("min must not exceed max");
+    return lodashInRange(value, min, max);
+}
+export function roundTo(value, decimals = 0) {
+    if (!Number.isInteger(decimals) || decimals < 0)
+        throw new RangeError("decimals must be a non-negative integer");
+    return lodashRound(value, decimals);
+}
+export function isFiniteNumber(value) { return typeof value === "number" && lodashIsFinite(value); }
+export function sum(values) { return lodashSum(values); }
+//# sourceMappingURL=number-operations.js.map

package/dist/numbers/number-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-operations.js","sourceRoot":"","sources":["../../src/numbers/number-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,IAAI,WAAW,EAAE,OAAO,IAAI,aAAa,EAAE,QAAQ,IAAI,cAAc,EAAE,KAAK,IAAI,WAAW,EAAE,GAAG,IAAI,SAAS,EAAC,MAAM,WAAW,CAAC;AAE7I,MAAM,UAAU,KAAK,CAAC,KAAY,EAAC,GAAU,EAAC,GAAU;IACtD,IAAG,GAAG,GAAC,GAAG;QAAC,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAC3D,OAAO,WAAW,CAAC,KAAK,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,KAAY,EAAC,GAAU,EAAC,GAAU;IACxD,IAAG,GAAG,GAAC,GAAG;QAAC,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAC3D,OAAO,aAAa,CAAC,KAAK,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,KAAY,EAAC,QAAQ,GAAC,CAAC;IAC7C,IAAG,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAE,QAAQ,GAAC,CAAC;QAAC,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAC3G,OAAO,WAAW,CAAC,KAAK,EAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,KAAa,IAAkB,OAAO,OAAO,KAAK,KAAG,QAAQ,IAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AACrH,MAAM,UAAU,GAAG,CAAC,MAAwB,IAAS,OAAO,SAAS,CAAC,MAAkB,CAAC,CAAC,CAAA,CAAC"}

package/dist/objects/object-concepts.d.ts

@@ -0,0 +1,2 @@
+export { hasOwn, pick, omit, isPlainObject } from "./object-operations.js";
+//# sourceMappingURL=object-concepts.d.ts.map

package/dist/objects/object-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-concepts.d.ts","sourceRoot":"","sources":["../../src/objects/object-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,IAAI,EAAC,IAAI,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/objects/object-concepts.js

@@ -0,0 +1,2 @@
+export { hasOwn, pick, omit, isPlainObject } from "./object-operations.js";
+//# sourceMappingURL=object-concepts.js.map

package/dist/objects/object-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-concepts.js","sourceRoot":"","sources":["../../src/objects/object-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,IAAI,EAAC,IAAI,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/objects/object-operations.d.ts

@@ -0,0 +1,5 @@
+export declare function hasOwn<T extends object>(value: T, key: PropertyKey): boolean;
+export declare function pick<T extends object, K extends keyof T>(value: T, keys: readonly K[]): Pick<T, K>;
+export declare function omit<T extends object, K extends keyof T>(value: T, keys: readonly K[]): Omit<T, K>;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=object-operations.d.ts.map

package/dist/objects/object-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-operations.d.ts","sourceRoot":"","sources":["../../src/objects/object-operations.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAC,CAAC,EAAC,GAAG,EAAC,WAAW,GAAE,OAAO,CAA8B;AACvG,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAC,CAAC,EAAC,IAAI,EAAC,SAAS,CAAC,EAAE,GAAE,IAAI,CAAC,CAAC,EAAC,CAAC,CAAC,CAAuC;AACpI,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAC,CAAC,EAAC,IAAI,EAAC,SAAS,CAAC,EAAE,GAAE,IAAI,CAAC,CAAC,EAAC,CAAC,CAAC,CAAuC;AACpI,wBAAgB,aAAa,CAAC,KAAK,EAAC,OAAO,GAAE,KAAK,IAAI,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,CAAoC"}

package/dist/objects/object-operations.js

@@ -0,0 +1,6 @@
+import { has as lodashHas, isPlainObject as lodashIsPlainObject, omit as lodashOmit, pick as lodashPick } from "lodash-es";
+export function hasOwn(value, key) { return lodashHas(value, key); }
+export function pick(value, keys) { return lodashPick(value, keys); }
+export function omit(value, keys) { return lodashOmit(value, keys); }
+export function isPlainObject(value) { return lodashIsPlainObject(value); }
+//# sourceMappingURL=object-operations.js.map

package/dist/objects/object-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-operations.js","sourceRoot":"","sources":["../../src/objects/object-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,IAAI,SAAS,EAAE,aAAa,IAAI,mBAAmB,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,UAAU,EAAC,MAAM,WAAW,CAAC;AAEzH,MAAM,UAAU,MAAM,CAAmB,KAAO,EAAC,GAAe,IAAU,OAAO,SAAS,CAAC,KAAK,EAAC,GAAG,CAAC,CAAC,CAAA,CAAC;AACvG,MAAM,UAAU,IAAI,CAAqC,KAAO,EAAC,IAAiB,IAAY,OAAO,UAAU,CAAC,KAAK,EAAC,IAAW,CAAC,CAAC,CAAA,CAAC;AACpI,MAAM,UAAU,IAAI,CAAqC,KAAO,EAAC,IAAiB,IAAY,OAAO,UAAU,CAAC,KAAK,EAAC,IAAW,CAAC,CAAC,CAAA,CAAC;AACpI,MAAM,UAAU,aAAa,CAAC,KAAa,IAAkC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC"}

package/dist/strings/string-concepts.d.ts

@@ -0,0 +1,4 @@
+export { isBlank, isNonBlank, isEmail, startsWithAny, endsWithAny } from "./string-predicates.js";
+export { capitalize, camelCase, kebabCase, snakeCase, truncate } from "./string-transform.js";
+export { truncateWords } from "./string-truncate-words.js";
+//# sourceMappingURL=string-concepts.d.ts.map

package/dist/strings/string-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-concepts.d.ts","sourceRoot":"","sources":["../../src/strings/string-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,UAAU,EAAC,OAAO,EAAC,aAAa,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAC,UAAU,EAAC,SAAS,EAAC,SAAS,EAAC,SAAS,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC"}

package/dist/strings/string-concepts.js

@@ -0,0 +1,4 @@
+export { isBlank, isNonBlank, isEmail, startsWithAny, endsWithAny } from "./string-predicates.js";
+export { capitalize, camelCase, kebabCase, snakeCase, truncate } from "./string-transform.js";
+export { truncateWords } from "./string-truncate-words.js";
+//# sourceMappingURL=string-concepts.js.map

package/dist/strings/string-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-concepts.js","sourceRoot":"","sources":["../../src/strings/string-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,UAAU,EAAC,OAAO,EAAC,aAAa,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAC,UAAU,EAAC,SAAS,EAAC,SAAS,EAAC,SAAS,EAAC,QAAQ,EAAC,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC"}

package/dist/strings/string-predicates.d.ts

@@ -0,0 +1,6 @@
+export declare function isBlank(value: string): boolean;
+export declare function isNonBlank(value: string): boolean;
+export declare function isEmail(value: string): boolean;
+export declare function startsWithAny(value: string, prefixes: readonly string[]): boolean;
+export declare function endsWithAny(value: string, suffixes: readonly string[]): boolean;
+//# sourceMappingURL=string-predicates.d.ts.map

package/dist/strings/string-predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-predicates.d.ts","sourceRoot":"","sources":["../../src/strings/string-predicates.ts"],"names":[],"mappings":"AAGA,wBAAgB,OAAO,CAAC,KAAK,EAAC,MAAM,GAAE,OAAO,CAAiC;AAC9E,wBAAgB,UAAU,CAAC,KAAK,EAAC,MAAM,GAAE,OAAO,CAAyB;AACzE,wBAAgB,OAAO,CAAC,KAAK,EAAC,MAAM,GAAE,OAAO,CAAkC;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAC,MAAM,EAAC,QAAQ,EAAC,SAAS,MAAM,EAAE,GAAE,OAAO,CAA+D;AAC7I,wBAAgB,WAAW,CAAC,KAAK,EAAC,MAAM,EAAC,QAAQ,EAAC,SAAS,MAAM,EAAE,GAAE,OAAO,CAA6D"}

package/dist/strings/string-predicates.js

@@ -0,0 +1,8 @@
+import { endsWith as lodashEndsWith, startsWith as lodashStartsWith } from "lodash-es";
+import validator from "validator";
+export function isBlank(value) { return value.trim().length === 0; }
+export function isNonBlank(value) { return !isBlank(value); }
+export function isEmail(value) { return validator.isEmail(value); }
+export function startsWithAny(value, prefixes) { return prefixes.some(prefix => lodashStartsWith(value, prefix)); }
+export function endsWithAny(value, suffixes) { return suffixes.some(suffix => lodashEndsWith(value, suffix)); }
+//# sourceMappingURL=string-predicates.js.map

package/dist/strings/string-predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-predicates.js","sourceRoot":"","sources":["../../src/strings/string-predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,IAAI,cAAc,EAAE,UAAU,IAAI,gBAAgB,EAAC,MAAM,WAAW,CAAC;AACrF,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,OAAO,CAAC,KAAY,IAAU,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAG,CAAC,CAAC,CAAA,CAAC;AAC9E,MAAM,UAAU,UAAU,CAAC,KAAY,IAAU,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AACzE,MAAM,UAAU,OAAO,CAAC,KAAY,IAAU,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AAC/E,MAAM,UAAU,aAAa,CAAC,KAAY,EAAC,QAA0B,IAAU,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA,EAAE,CAAA,gBAAgB,CAAC,KAAK,EAAC,MAAM,CAAC,CAAC,CAAC,CAAA,CAAC;AAC7I,MAAM,UAAU,WAAW,CAAC,KAAY,EAAC,QAA0B,IAAU,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA,EAAE,CAAA,cAAc,CAAC,KAAK,EAAC,MAAM,CAAC,CAAC,CAAC,CAAA,CAAC"}

package/dist/strings/string-transform.d.ts

@@ -0,0 +1,6 @@
+export declare function capitalize(value: string): string;
+export declare function camelCase(value: string): string;
+export declare function kebabCase(value: string): string;
+export declare function snakeCase(value: string): string;
+export declare function truncate(value: string, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=string-transform.d.ts.map

package/dist/strings/string-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-transform.d.ts","sourceRoot":"","sources":["../../src/strings/string-transform.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAAiC;AAChF,wBAAgB,SAAS,CAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAAgC;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAAgC;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAAgC;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAC,MAAM,EAAC,SAAS,EAAC,MAAM,EAAC,MAAM,SAAI,GAAE,MAAM,CAGxE"}

package/dist/strings/string-transform.js

@@ -0,0 +1,11 @@
+import { camelCase as lodashCamelCase, capitalize as lodashCapitalize, kebabCase as lodashKebabCase, snakeCase as lodashSnakeCase, truncate as lodashTruncate } from "lodash-es";
+export function capitalize(value) { return lodashCapitalize(value); }
+export function camelCase(value) { return lodashCamelCase(value); }
+export function kebabCase(value) { return lodashKebabCase(value); }
+export function snakeCase(value) { return lodashSnakeCase(value); }
+export function truncate(value, maxLength, suffix = "…") {
+    if (maxLength < 0)
+        throw new RangeError("maxLength must be non-negative");
+    return lodashTruncate(value, { length: maxLength, omission: suffix });
+}
+//# sourceMappingURL=string-transform.js.map

package/dist/strings/string-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-transform.js","sourceRoot":"","sources":["../../src/strings/string-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,IAAI,eAAe,EAAE,UAAU,IAAI,gBAAgB,EAAE,SAAS,IAAI,eAAe,EAAE,SAAS,IAAI,eAAe,EAAE,QAAQ,IAAI,cAAc,EAAC,MAAM,WAAW,CAAC;AAE/K,MAAM,UAAU,UAAU,CAAC,KAAY,IAAS,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AAChF,MAAM,UAAU,SAAS,CAAC,KAAY,IAAS,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AAC9E,MAAM,UAAU,SAAS,CAAC,KAAY,IAAS,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AAC9E,MAAM,UAAU,SAAS,CAAC,KAAY,IAAS,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA,CAAC;AAC9E,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAC,SAAgB,EAAC,MAAM,GAAC,GAAG;IAC/D,IAAG,SAAS,GAAC,CAAC;QAAC,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACtE,OAAO,cAAc,CAAC,KAAK,EAAC,EAAC,MAAM,EAAC,SAAS,EAAC,QAAQ,EAAC,MAAM,EAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/strings/string-truncate-words.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Truncates an input string to a maximum number of words.
+ *
+ * @param value The input string to truncate.
+ * @param maxWords Maximum number of words allowed.
+ * @param suffix Suffix to append if truncated (default: '…').
+ * @returns Truncated string.
+ */
+export declare function truncateWords(value: string, maxWords: number, suffix?: string): string;
+//# sourceMappingURL=string-truncate-words.d.ts.map

package/dist/strings/string-truncate-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-truncate-words.d.ts","sourceRoot":"","sources":["../../src/strings/string-truncate-words.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAMnF"}

package/dist/strings/string-truncate-words.js

@@ -0,0 +1,19 @@
+/**
+ * Truncates an input string to a maximum number of words.
+ *
+ * @param value The input string to truncate.
+ * @param maxWords Maximum number of words allowed.
+ * @param suffix Suffix to append if truncated (default: '…').
+ * @returns Truncated string.
+ */
+export function truncateWords(value, maxWords, suffix = "…") {
+    if (maxWords < 0)
+        throw new RangeError("maxWords must be non-negative");
+    if (!value)
+        return "";
+    const words = value.trim().split(/\s+/);
+    if (words.length <= maxWords)
+        return value;
+    return `${words.slice(0, maxWords).join(" ")}${suffix}`;
+}
+//# sourceMappingURL=string-truncate-words.js.map

package/dist/strings/string-truncate-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-truncate-words.js","sourceRoot":"","sources":["../../src/strings/string-truncate-words.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAM,GAAG,GAAG;IACzE,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;AAC1D,CAAC"}

package/dist/urls/url-concepts.d.ts

@@ -0,0 +1,2 @@
+export { isUrl, joinUrl, getQueryParam, setQueryParam } from "./url-operations.js";
+//# sourceMappingURL=url-concepts.d.ts.map

package/dist/urls/url-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-concepts.d.ts","sourceRoot":"","sources":["../../src/urls/url-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,OAAO,EAAC,aAAa,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/urls/url-concepts.js

@@ -0,0 +1,2 @@
+export { isUrl, joinUrl, getQueryParam, setQueryParam } from "./url-operations.js";
+//# sourceMappingURL=url-concepts.js.map

package/dist/urls/url-concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-concepts.js","sourceRoot":"","sources":["../../src/urls/url-concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,OAAO,EAAC,aAAa,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/urls/url-operations.d.ts

@@ -0,0 +1,5 @@
+export declare function isUrl(value: string): boolean;
+export declare function joinUrl(base: string, ...parts: string[]): string;
+export declare function getQueryParam(url: string | URL, key: string): string | null;
+export declare function setQueryParam(url: string | URL, key: string, value: string): string;
+//# sourceMappingURL=url-operations.d.ts.map

package/dist/urls/url-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-operations.d.ts","sourceRoot":"","sources":["../../src/urls/url-operations.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAC,MAAM,GAAE,OAAO,CAAsD;AACjG,wBAAgB,OAAO,CAAC,IAAI,EAAC,MAAM,EAAC,GAAG,KAAK,EAAC,MAAM,EAAE,GAAE,MAAM,CAAyL;AACtP,wBAAgB,aAAa,CAAC,GAAG,EAAC,MAAM,GAAC,GAAG,EAAC,GAAG,EAAC,MAAM,GAAE,MAAM,GAAC,IAAI,CAA4C;AAChH,wBAAgB,aAAa,CAAC,GAAG,EAAC,MAAM,GAAC,GAAG,EAAC,GAAG,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAAwF"}

package/dist/urls/url-operations.js

@@ -0,0 +1,11 @@
+export function isUrl(value) { try {
+    new URL(value);
+    return true;
+}
+catch {
+    return false;
+} }
+export function joinUrl(base, ...parts) { const normalizedBase = base.replace(/\/+$/, ""); const normalizedParts = parts.map(part => part.replace(/^\/+|\/+$/g, "")); return [normalizedBase, ...normalizedParts].filter(Boolean).join("/"); }
+export function getQueryParam(url, key) { return new URL(url).searchParams.get(key); }
+export function setQueryParam(url, key, value) { const result = new URL(url); result.searchParams.set(key, value); return result.toString(); }
+//# sourceMappingURL=url-operations.js.map

package/dist/urls/url-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-operations.js","sourceRoot":"","sources":["../../src/urls/url-operations.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,KAAY,IAAU,IAAG,CAAC;IAAA,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAAA,OAAO,IAAI,CAAC;AAAA,CAAC;AAAA,MAAK,CAAC;IAAA,OAAO,KAAK,CAAC;AAAA,CAAC,CAAA,CAAC;AACjG,MAAM,UAAU,OAAO,CAAC,IAAW,EAAC,GAAG,KAAc,IAAS,MAAM,cAAc,GAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAC,EAAE,CAAC,CAAC,CAAA,MAAM,eAAe,GAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAA,EAAE,CAAA,IAAI,CAAC,OAAO,CAAC,YAAY,EAAC,EAAE,CAAC,CAAC,CAAC,CAAA,OAAO,CAAC,cAAc,EAAC,GAAG,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,CAAC;AACtP,MAAM,UAAU,aAAa,CAAC,GAAc,EAAC,GAAU,IAAc,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA,CAAC;AAChH,MAAM,UAAU,aAAa,CAAC,GAAc,EAAC,GAAU,EAAC,KAAY,IAAS,MAAM,MAAM,GAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAC,KAAK,CAAC,CAAC,CAAA,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@dinilmusick/gutts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "private": false,
+  "description": "Global Utilities for TypeScript applications.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./json": "./dist/json/json-concepts.js",
+    "./strings": "./dist/strings/string-concepts.js",
+    "./arrays": "./dist/arrays/array-concepts.js",
+    "./objects": "./dist/objects/object-concepts.js",
+    "./numbers": "./dist/numbers/number-concepts.js",
+    "./urls": "./dist/urls/url-concepts.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "lodash-es": "^4.17.21",
+    "validator": "^13.15.15"
+  },
+  "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
+    "@types/validator": "^13.12.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "packageManager": "pnpm@9.15.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dinilmusick/GutTS.git"
+  },
+  "license": "MIT"
+}