@hkdigital/lib-core 0.4.12 → 0.4.13

package/dist/util/array.js

@@ -0,0 +1,9 @@
+/**
+ * Array utilities main export
+ *
+ * @description
+ * This module provides utilities for array manipulation, conversion,
+ * and processing operations.
+ */
+
+export * from './array/index.js';

package/dist/util/bases/base64.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Decode a base64 encoded string into a Uint8Array
+ *
+ * @param {string} str64 - Base64 encoded string
+ *
+ * @returns {Uint8Array} byte array that contains the decoded contents
+ */
+export function base64ToUint8Array(str64: string): Uint8Array;

package/dist/util/bases/base64.js

@@ -0,0 +1,23 @@
+/**
+ * base64.js
+ *
+ * @description
+ * This file contains utilities for working with base64 encoding/decoding
+ */
+
+import * as expect from '../expect.js';
+
+/**
+ * Decode a base64 encoded string into a Uint8Array
+ *
+ * @param {string} str64 - Base64 encoded string
+ *
+ * @returns {Uint8Array} byte array that contains the decoded contents
+ */
+export function base64ToUint8Array( str64 )
+{
+  expect.string( str64 );
+  
+  const binaryString = atob(str64);
+  return Uint8Array.from(binaryString, char => char.charCodeAt(0));
+}

package/dist/util/bases/index.d.ts

@@ -1 +0,0 @@
-export * from "./base58.js";

package/dist/util/bases/index.js

@@ -1 +0,0 @@
-export * from './base58.js';

package/dist/util/bases.d.ts

@@ -0,0 +1,2 @@
+export * from "./bases/base58.js";
+export * from "./bases/base64.js";

package/dist/util/bases.js

@@ -0,0 +1,10 @@
+/**
+ * Bases utilities main export
+ *
+ * @description
+ * This module provides a clean API for base encoding/decoding operations
+ * including base58 and base64 utilities.
+ */
+
+export * from './bases/base58.js';
+export * from './bases/base64.js';

package/dist/util/compare.d.ts

@@ -0,0 +1 @@
+export * from "./compare/index.js";

package/dist/util/compare.js

@@ -0,0 +1,9 @@
+/**
+ * Compare utilities main export
+ *
+ * @description
+ * This module provides comparison functions for sorting, equality checking,
+ * and value comparison operations.
+ */
+
+export * from './compare/index.js';

package/dist/util/css/index.d.ts

@@ -1 +0,0 @@
-export * from "./css-vars.js";

package/dist/util/css/index.js

@@ -1 +0,0 @@
-export * from './css-vars.js';

package/dist/util/css.d.ts

@@ -0,0 +1 @@
+export * from "./css/css-vars.js";

package/dist/util/css.js

@@ -0,0 +1,8 @@
+/**
+ * CSS utilities main export
+ *
+ * @description
+ * This module provides CSS-related utilities including CSS variable management.
+ */
+
+export * from './css/css-vars.js';

package/dist/util/env.d.ts

@@ -0,0 +1 @@
+export * from "./env/index.js";

package/dist/util/env.js

@@ -0,0 +1,8 @@
+/**
+ * Environment utilities main export
+ *
+ * @description
+ * This module provides environment detection utilities.
+ */
+
+export * from './env/index.js';

package/dist/util/exceptions.d.ts

@@ -0,0 +1 @@
+export * from "./exceptions/index.js";

package/dist/util/exceptions.js

@@ -0,0 +1,8 @@
+/**
+ * Exception utilities main export
+ *
+ * @description
+ * This module provides exception handling utilities including error rethrowing.
+ */
+
+export * from './exceptions/index.js';

package/dist/util/expect/arrays.js

@@ -53,3 +53,5 @@ export function expect_arrayLike(value) {
 }
 
 export { expect_arrayLike as arrayLike };
+
+// arrayOrSet moved to compounds.js

package/dist/util/expect/compounds.d.ts

@@ -0,0 +1,20 @@
+/** Compound validators - combinations and unions of basic validators */
+/**
+ * Throws a validation error if value is not iterable
+ *
+ * @param {any} value
+ */
+export function expect_iterable(value: any): void;
+/**
+ * Throws a validation error if value is not a store (has no subscribe method)
+ *
+ * @param {any} value
+ */
+export function expect_store(value: any): void;
+/**
+ * Throws a validation error if value is not an array or Set
+ *
+ * @param {any} value
+ */
+export function expect_arrayOrSet(value: any): void;
+export { expect_iterable as iterable, expect_store as store, expect_arrayOrSet as arrayOrSet };

package/dist/util/expect/compounds.js

@@ -0,0 +1,48 @@
+import * as v from 'valibot';
+import * as is from '../is/index.js';
+
+/** Compound validators - combinations and unions of basic validators */
+
+/**
+ * Throws a validation error if value is not iterable
+ *
+ * @param {any} value
+ */
+export function expect_iterable(value) {
+	const schema = v.pipe(v.looseObject({ [Symbol.iterator]: v.function() }));
+
+	v.parse(schema, value);
+}
+
+export { expect_iterable as iterable };
+
+/**
+ * Throws a validation error if value is not a store (has no subscribe method)
+ *
+ * @param {any} value
+ */
+export function expect_store(value) {
+	v.parse(
+		v.custom((value) => {
+			if (!is.object(value) || typeof value?.subscribe !== 'function') {
+				return false;
+			}
+
+			return true;
+		}),
+		value
+	);
+}
+
+export { expect_store as store };
+
+/**
+ * Throws a validation error if value is not an array or Set
+ *
+ * @param {any} value
+ */
+export function expect_arrayOrSet(value) {
+	v.parse(v.union([v.instance(Array), v.instance(Set)]), value);
+}
+
+export { expect_arrayOrSet as arrayOrSet };

package/dist/util/expect/objects.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Throws a validation error if value is not an object or the value
+ * is an array
+ *
+ * @param {any} value
+ */
+export function expect_objectNoArray(value: any): void;
+/**
+ * Throws a validation error if value is not an object or the value
+ * is a function
+ *
+ * @param {any} value
+ */
+export function expect_objectNoFunction(value: any): void;
+/**
+ * Throws a validation error if value is not an object or null
+ *
+ * @param {any} value
+ */
+export function expect_objectOrNull(value: any): void;
+/** Object-related validators */
+/**
+ * Throws a validation error if value is not an object
+ *
+ * @param {any} value
+ */
+declare function expect_object(value: any): void;
+export { expect_object as object, expect_objectNoArray as objectNoArray, expect_objectNoFunction as objectNoFunction, expect_objectOrNull as objectOrNull };

package/dist/util/expect/objects.js

@@ -0,0 +1,70 @@
+import * as v from 'valibot';
+import * as is from '../is/index.js';
+
+/** Internals */
+
+const ObjectSchema = v.custom(is.object, `Invalid type: Expected object`);
+
+/** Object-related validators */
+
+/**
+ * Throws a validation error if value is not an object
+ *
+ * @param {any} value
+ */
+function expect_object(value) {
+	v.parse(ObjectSchema, value);
+}
+
+export { expect_object as object };
+
+/**
+ * Throws a validation error if value is not an object or the value
+ * is an array
+ *
+ * @param {any} value
+ */
+export function expect_objectNoArray(value) {
+	v.parse(
+		v.custom((value) => {
+			if (!is.object(value) || value instanceof Array) {
+				return false;
+			}
+
+			return true;
+		}),
+		value
+	);
+}
+
+/**
+ * Throws a validation error if value is not an object or the value
+ * is a function
+ *
+ * @param {any} value
+ */
+export function expect_objectNoFunction(value) {
+	v.parse(
+		v.custom((value) => {
+			if (!is.object(value) || typeof value === 'function') {
+				return false;
+			}
+
+			return true;
+		}),
+		value
+	);
+}
+
+/**
+ * Throws a validation error if value is not an object or null
+ *
+ * @param {any} value
+ */
+export function expect_objectOrNull(value) {
+	v.parse(v.union([v.literal(null), v.looseObject({})]), value);
+}
+
+export { expect_objectNoArray as objectNoArray };
+export { expect_objectNoFunction as objectNoFunction };
+export { expect_objectOrNull as objectOrNull };

package/dist/util/expect/primitives.d.ts

@@ -28,4 +28,34 @@ export function expect_symbol(value: any): void;
  * @param {any} value
  */
 export function expect_defined(value: any): void;
-export { expect_string as string, expect_boolean as boolean, expect_number as number, expect_symbol as symbol, expect_defined as defined };
+/**
+ * Throws a validation error if value is not a function
+ *
+ * @param {any} value
+ */
+export function expect_function(value: any): void;
+/**
+ * Throws a validation error if value is not a Promise
+ *
+ * @param {any} value
+ */
+export function expect_promise(value: any): void;
+/**
+ * Throws a validation error if value is not a Map
+ *
+ * @param {any} value
+ */
+export function expect_map(value: any): void;
+/**
+ * Throws a validation error if value is not a Set
+ *
+ * @param {any} value
+ */
+export function expect_set(value: any): void;
+/**
+ * Throws a validation error if value is not an Error instance
+ *
+ * @param {any} value
+ */
+export function expect_error(value: any): void;
+export { expect_string as string, expect_boolean as boolean, expect_number as number, expect_symbol as symbol, expect_defined as defined, expect_function as function, _function as function, expect_function as class, _class as class, expect_promise as promise, expect_map as map, expect_set as set, expect_error as error };

package/dist/util/expect/primitives.js

@@ -63,3 +63,59 @@ export function expect_defined(value) {
 }
 
 export { expect_defined as defined };
+
+/**
+ * Throws a validation error if value is not a function
+ *
+ * @param {any} value
+ */
+export function expect_function(value) {
+	v.parse(v.function(), value);
+}
+
+export { expect_function as function };
+export { expect_function as class };
+
+/**
+ * Throws a validation error if value is not a Promise
+ *
+ * @param {any} value
+ */
+export function expect_promise(value) {
+	v.parse(v.instance(Promise), value);
+}
+
+export { expect_promise as promise };
+
+/**
+ * Throws a validation error if value is not a Map
+ *
+ * @param {any} value
+ */
+export function expect_map(value) {
+	v.parse(v.instance(Map), value);
+}
+
+export { expect_map as map };
+
+/**
+ * Throws a validation error if value is not a Set
+ *
+ * @param {any} value
+ */
+export function expect_set(value) {
+	v.parse(v.instance(Set), value);
+}
+
+export { expect_set as set };
+
+/**
+ * Throws a validation error if value is not an Error instance
+ *
+ * @param {any} value
+ */
+export function expect_error(value) {
+	v.parse(v.instance(Error), value);
+}
+
+export { expect_error as error };

package/dist/util/expect/values.d.ts

@@ -0,0 +1,26 @@
+/** Value/constraint validators */
+/**
+ * Expect a value not to be null
+ *
+ * @param {any} value
+ */
+export function expect_notNull(value: any): void;
+/**
+ * Expect a value to be a boolean and true
+ *
+ * @param {any} value
+ */
+export function expect_true(value: any): void;
+/**
+ * Expect a positive number
+ *
+ * @param {any} value
+ */
+export function expect_positiveNumber(value: any): void;
+/**
+ * Throws a validation error if value is not a string
+ *
+ * @param {any} value
+ */
+export function expect_notEmptyString(value: any): void;
+export { expect_true as true, _true as true, expect_notNull as notNull, expect_positiveNumber as positiveNumber, expect_notEmptyString as notEmptyString };

package/dist/util/expect/values.js

@@ -0,0 +1,48 @@
+import * as v from 'valibot';
+
+/** Value/constraint validators */
+
+/**
+ * Expect a value not to be null
+ *
+ * @param {any} value
+ */
+export function expect_notNull(value) {
+	v.notValue(null, value);
+}
+
+/**
+ * Expect a value to be a boolean and true
+ *
+ * @param {any} value
+ */
+export function expect_true(value) {
+	v.value(true, value);
+}
+
+export { expect_true as true };
+
+/**
+ * Expect a positive number
+ *
+ * @param {any} value
+ */
+export function expect_positiveNumber(value) {
+	const schema = v.pipe(v.number(), v.minValue(0));
+	v.parse(schema, value);
+}
+
+/**
+ * Throws a validation error if value is not a string
+ *
+ * @param {any} value
+ */
+export function expect_notEmptyString(value) {
+	const schema = v.pipe(v.string(), v.minLength(1));
+
+	v.parse(schema, value);
+}
+
+export { expect_notNull as notNull };
+export { expect_positiveNumber as positiveNumber };
+export { expect_notEmptyString as notEmptyString };

package/dist/util/expect.d.ts

@@ -0,0 +1,6 @@
+export * from "./expect/arrays.js";
+export * from "./expect/primitives.js";
+export * from "./expect/url.js";
+export * from "./expect/objects.js";
+export * from "./expect/values.js";
+export * from "./expect/compounds.js";

package/dist/util/expect.js

@@ -0,0 +1,31 @@
+/**
+ * Validation functions that can be used as safe guards in your code
+ *
+ * @example
+ *
+ * import * as expect from 'util/expect.js';
+ *
+ * function logText( text )
+ * {
+ *   expect.string( text );
+ *   expect.true( 1 > 0 );
+ *
+ *   console.log( text );
+ * }
+ *
+ * logText( 'Hello' );
+ * logText( 123 );      // <- Will throw an exception
+ */
+
+export * from './expect/arrays.js';
+export * from './expect/primitives.js';
+export * from './expect/url.js';
+export * from './expect/objects.js';
+export * from './expect/values.js';
+export * from './expect/compounds.js';
+
+// TODO: Implement these validators as needed
+// notNegativeNumber, positiveInteger, notNegativeInteger
+// stringOrNull, stringOrUndefined, notEmptyStringOrNull
+// ArrayBuffer, arrayOrUndefined, arangoCollectionId, uriComponent
+// objectOrUndefined, objectPath, asyncIterator

package/dist/util/function/index.js

@@ -24,7 +24,7 @@
 
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../expect/index.js';
+import * as expect from '../expect.js';
 
 /* ---------------------------------------------------------------- Internals */
 

package/dist/util/function.d.ts

@@ -0,0 +1 @@
+export * from "./function/index.js";

package/dist/util/function.js

@@ -0,0 +1,8 @@
+/**
+ * Function utilities main export
+ *
+ * @description
+ * This module provides function manipulation utilities.
+ */
+
+export * from './function/index.js';

package/dist/util/geometry.d.ts

@@ -0,0 +1 @@
+export * from "./geometry/index.js";

package/dist/util/geometry.js

@@ -0,0 +1,9 @@
+/**
+ * Geometry utilities main export
+ *
+ * @description
+ * This module provides geometric calculation utilities including
+ * point-in-polygon tests and other mathematical geometry functions.
+ */
+
+export * from './geometry/index.js';

package/dist/util/is.d.ts

@@ -0,0 +1 @@
+export * from "./is/index.js";

package/dist/util/is.js

@@ -0,0 +1,8 @@
+/**
+ * Type checking utilities main export
+ *
+ * @description
+ * This module provides type checking and validation utilities.
+ */
+
+export * from './is/index.js';

package/dist/util/iterate/index.js

@@ -1,6 +1,6 @@
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../expect/index.js';
+import * as expect from '../expect.js';
 import { smallestFirst, largestFirst } from '../compare/index.js';
 
 import { IterableTree } from '../../generic/data.js';

package/dist/util/iterate.d.ts

@@ -0,0 +1 @@
+export * from "./iterate/index.js";

package/dist/util/iterate.js

@@ -0,0 +1,8 @@
+/**
+ * Iteration utilities main export
+ *
+ * @description
+ * This module provides iteration and looping utilities.
+ */
+
+export * from './iterate/index.js';

package/dist/util/object/index.js

@@ -1,12 +1,12 @@
 /* ------------------------------------------------------------------ Imports */
 
-import * as expect from '../expect/index.js';
+import * as expect from '../expect.js';
 
 import { equals } from '../compare/index.js';
 
 import { toArrayPath } from '../array/index.js';
 
-import { toStringPath } from '../string/index.js';
+import { toStringPath } from '../string.js';
 
 import * as is from '../is/index.js';
 

package/dist/util/object.d.ts

@@ -0,0 +1 @@
+export * from "./object/index.js";

package/dist/util/object.js

@@ -0,0 +1,8 @@
+/**
+ * Object utilities main export
+ *
+ * @description
+ * This module provides object manipulation and utility functions.
+ */
+
+export * from './object/index.js';

package/dist/util/random/bytes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generate cryptographically secure random bytes
+ * - Uses Web Crypto API (works in Node.js 16+ and all modern browsers)
+ * - Returns Uint8Array for maximum compatibility
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {Uint8Array} Random bytes
+ */
+export function randomBytes(length: number): Uint8Array;
+/**
+ * Generate random bytes and return as base64 string
+ * - Cross-platform base64 encoding
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {string} Base64 encoded random bytes
+ */
+export function randomBytesBase64(length: number): string;
+/**
+ * Generate random bytes and return as hex string
+ * - Cross-platform hex encoding
+ *
+ * @param {number} length - Number of bytes to generate
+ *
+ * @returns {string} Hex encoded random bytes
+ */
+export function randomBytesHex(length: number): string;