@edgeandnode/eds-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Edge & Node
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @edgeandnode/eds-utils
+
+General utility functions for The Edge Design System.
+
+## Installation
+
+```bash
+pnpm add @edgeandnode/eds-utils
+```
+
+## Utilities
+
+### BigInt Formatting
+
+```ts
+import { bigIntToNumber, formatBigInt, numberToBigInt, parseBigInt } from '@edgeandnode/eds-utils'
+
+// Format a BigInt with decimals (precision defaults to 18)
+formatBigInt(1000000000000000000n) // "1"
+formatBigInt(1500000000000000000n) // "1.5"
+
+// Parse a string to BigInt
+parseBigInt('1.5') // 1500000000000000000n
+
+// Convert between BigInt and number
+bigIntToNumber(1000000000000000000n) // 1
+numberToBigInt(1.5) // 1500000000000000000n
+
+// Custom precision
+formatBigInt(1000000n, { precision: 6n }) // "1"
+```
+
+### String Utilities
+
+```ts
+import { camelToKebab } from '@edgeandnode/eds-utils'
+
+camelToKebab('backgroundColor') // "background-color"
+camelToKebab('HTMLElement') // "html-element"
+```
+
+### Identicon Generation
+
+```ts
+import { createIdenticon } from '@edgeandnode/eds-utils'
+
+// Generate a deterministic identicon SVG from an Ethereum address
+const svg = createIdenticon('0x1234...')
+```
+
+## License
+
+MIT

package/dist/bigIntToNumber.d.ts

@@ -0,0 +1,17 @@
+export interface BigIntToNumberOptions {
+    /**
+     * The number of digits starting from the right of `value` to consider as decimal places.
+     *
+     * @default 18n
+     */
+    precision?: bigint | undefined;
+}
+/**
+ * Converts a bigint to a number.
+ *
+ * @param value - The bigint to convert to a number.
+ * @param options - Conversion options.
+ * @returns The number representation of `value`
+ */
+export declare function bigIntToNumber(value: bigint, options?: BigIntToNumberOptions): number;
+//# sourceMappingURL=bigIntToNumber.d.ts.map

package/dist/bigIntToNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigIntToNumber.d.ts","sourceRoot":"","sources":["../src/bigIntToNumber.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAiBrF"}

package/dist/bigIntToNumber.js

@@ -0,0 +1,25 @@
+/**
+ * Converts a bigint to a number.
+ *
+ * @param value - The bigint to convert to a number.
+ * @param options - Conversion options.
+ * @returns The number representation of `value`
+ */
+export function bigIntToNumber(value, options) {
+    const { precision = 18n } = options ?? {};
+    if (precision < 0n) {
+        throw new Error(`[bigIntToNumber] \`precision\` must be positive, got ${precision}`);
+    }
+    if (precision === 0n) {
+        return Number(value);
+    }
+    else {
+        const valueString = String(value);
+        const decimalPointIndex = valueString.length - Number(precision);
+        if (decimalPointIndex <= 0) {
+            return Number(`0.${'0'.repeat(Math.abs(decimalPointIndex))}${valueString}`);
+        }
+        return Number(`${valueString.slice(0, decimalPointIndex)}.${valueString.slice(decimalPointIndex)}`);
+    }
+}
+//# sourceMappingURL=bigIntToNumber.js.map

package/dist/bigIntToNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigIntToNumber.js","sourceRoot":"","sources":["../src/bigIntToNumber.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,OAA+B;IAC3E,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IACzC,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC;IACD,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;QAChE,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,MAAM,CACX,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CACrF,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/camelToKebab.d.ts

@@ -0,0 +1,3 @@
+/** Converts a camelCase string to kebab-case. */
+export declare function camelToKebab(string: string): string;
+//# sourceMappingURL=camelToKebab.d.ts.map

package/dist/camelToKebab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToKebab.d.ts","sourceRoot":"","sources":["../src/camelToKebab.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,UAc1C"}

package/dist/camelToKebab.js

@@ -0,0 +1,15 @@
+/** Converts a camelCase string to kebab-case. */
+export function camelToKebab(string) {
+    return (string
+        // Insert dash between a group of uppercase letters and an uppercase letter followed by lowercase (`HTTPSEncryptionMethod200Success` => `HTTPS-EncryptionMethod200Success`)
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
+        // Insert dash between a lowercase letter and an uppercase letter (`HTTPS-EncryptionMethod200Success` => `HTTPS-Encryption-Method200Success`)
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        // Insert dash between a letter and a digit (`HTTPS-Encryption-Method200Success` => `HTTPS-Encryption-Method-200Success`)
+        .replace(/([A-Za-z])(\d)/g, '$1-$2')
+        // Insert dash between a digit and a letter (`HTTPS-Encryption-Method-200Success` => `HTTPS-Encryption-Method-200-Success`)
+        .replace(/(\d)([A-Za-z])/g, '$1-$2')
+        // Convert to lowercase (`HTTPS-Encryption-Method-200-Success` => `https-encryption-method-200-success`)
+        .toLowerCase());
+}
+//# sourceMappingURL=camelToKebab.js.map

package/dist/camelToKebab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelToKebab.js","sourceRoot":"","sources":["../src/camelToKebab.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CACL,MAAM;QACJ,2KAA2K;SAC1K,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAC1C,6IAA6I;SAC5I,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,yHAAyH;SACxH,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,2HAA2H;SAC1H,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACpC,wGAAwG;SACvG,WAAW,EAAE,CACjB,CAAA;AACH,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const PLACEHOLDER_ADDRESS = "0x646563656E7472616c697a656420646174612121";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,+CAA+C,CAAA;AACxE,eAAO,MAAM,mBAAmB,+CAA+C,CAAA"}

package/dist/constants.js

@@ -0,0 +1,3 @@
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+export const PLACEHOLDER_ADDRESS = '0x646563656E7472616c697a656420646174612121'; // "decentralized data!!" in HEX format
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,4CAA4C,CAAA;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,4CAA4C,CAAA,CAAC,uCAAuC"}

package/dist/createIdenticon.d.ts

@@ -0,0 +1,2 @@
+export declare function createIdenticon(address: string): string;
+//# sourceMappingURL=createIdenticon.d.ts.map

package/dist/createIdenticon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIdenticon.d.ts","sourceRoot":"","sources":["../src/createIdenticon.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,UA6E9C"}

package/dist/createIdenticon.js

@@ -0,0 +1,75 @@
+import md5 from 'md5';
+import { sliceWrap } from './sliceWrap.js';
+const identiconCache = new Map();
+export function createIdenticon(address) {
+    const lowercasedAddress = address.toLowerCase();
+    // Check the cache first
+    const cachedIdenticon = identiconCache.get(lowercasedAddress);
+    if (cachedIdenticon) {
+        return cachedIdenticon;
+    }
+    const hash = md5(lowercasedAddress);
+    const bytesPerPixel = 3;
+    const pixels = 5;
+    const rowPadding = (4 - ((pixels * bytesPerPixel) % 4)) % 4;
+    const pixelArraySize = pixels * (pixels * bytesPerPixel + rowPadding);
+    const fileHeaderSize = 14;
+    const dibHeaderSize = 40;
+    const totalHeaderSize = fileHeaderSize + dibHeaderSize;
+    const bufferSize = totalHeaderSize + pixelArraySize;
+    const buffer = new Uint8Array(bufferSize);
+    // Set up the bitmap headers
+    buffer[0] = 0x42; // 'B'
+    buffer[1] = 0x4d; // 'M'
+    buffer[2] = bufferSize & 0xff;
+    buffer[3] = (bufferSize >> 8) & 0xff;
+    buffer[4] = (bufferSize >> 16) & 0xff;
+    buffer[5] = (bufferSize >> 24) & 0xff;
+    buffer[10] = totalHeaderSize; // Pixel data offset
+    buffer[14] = dibHeaderSize;
+    buffer[18] = pixels & 0xff;
+    buffer[19] = (pixels >> 8) & 0xff;
+    buffer[22] = pixels & 0xff;
+    buffer[23] = (pixels >> 8) & 0xff;
+    buffer[26] = 1; // Planes
+    buffer[28] = 24; // Bits per pixel
+    // Determine the primary color based on the hash
+    const match = /#(..)(..)(..)/.exec(`#${hash.slice(0, 6)}`);
+    if (!match)
+        throw new Error('[createIdenticon] Invalid color format');
+    const [r, g, b] = match.slice(1).map((hex) => parseInt(hex, 16));
+    const primaryColor = [b, g, r];
+    const backgroundColor = [255, 255, 255];
+    // Draw the image
+    const hashBinary = hash
+        .split('')
+        .map((el) => parseInt(el, 16))
+        .map((num) => (num < 8 ? 0 : 1));
+    const hashBinaryMap = [];
+    const columns = Math.ceil(pixels / 2);
+    for (let x = 0; x < columns; x++) {
+        hashBinaryMap[x] = sliceWrap(hashBinary, x * pixels, (x + 1) * pixels);
+    }
+    let position = totalHeaderSize;
+    for (let y = pixels - 1; y >= 0; y--) {
+        for (let x = 0; x < pixels; x++) {
+            const color = hashBinaryMap[x > columns - 1 ? pixels - 1 - x : x]?.[y]
+                ? primaryColor
+                : backgroundColor;
+            buffer[position++] = color[0];
+            buffer[position++] = color[1];
+            buffer[position++] = color[2];
+        }
+        position += rowPadding;
+    }
+    // Convert the image to a base64 string
+    let binary = '';
+    for (let i = 0; i < buffer.length; i++) {
+        binary += String.fromCharCode(buffer[i]);
+    }
+    const identicon = `data:image/bmp;base64,${btoa(binary)}`;
+    // Store it in the cache, then return it
+    identiconCache.set(lowercasedAddress, identicon);
+    return identicon;
+}
+//# sourceMappingURL=createIdenticon.js.map

package/dist/createIdenticon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIdenticon.js","sourceRoot":"","sources":["../src/createIdenticon.ts"],"names":[],"mappings":"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"}

package/dist/formatAddress.d.ts

@@ -0,0 +1,14 @@
+type FormatAddressOptions = {
+    /** @default 'short' */
+    style?: 'short' | 'full' | undefined;
+};
+/**
+ * Formats an EVM wallet address as a string.
+ *
+ * @param address - The address to format.
+ * @param options - Formatting options.
+ * @returns The formatted address string.
+ */
+export declare function formatAddress(address: string, options?: FormatAddressOptions): string;
+export {};
+//# sourceMappingURL=formatAddress.d.ts.map

package/dist/formatAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatAddress.d.ts","sourceRoot":"","sources":["../src/formatAddress.ts"],"names":[],"mappings":"AAIA,KAAK,oBAAoB,GAAG;IAC1B,uBAAuB;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CACrC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAgBzF"}

package/dist/formatAddress.js

@@ -0,0 +1,28 @@
+import { getAddress } from 'viem';
+import { ZERO_ADDRESS } from './constants.js';
+/**
+ * Formats an EVM wallet address as a string.
+ *
+ * @param address - The address to format.
+ * @param options - Formatting options.
+ * @returns The formatted address string.
+ */
+export function formatAddress(address, options = {}) {
+    const { style = 'short' } = options;
+    if (!address)
+        address = ZERO_ADDRESS;
+    try {
+        address = address.startsWith('0x') ? getAddress(address) : address;
+    }
+    catch { }
+    switch (style) {
+        case 'short':
+            const lengthOnEachSide = 6;
+            if (address.length <= lengthOnEachSide * 2 + 1)
+                return address;
+            return `${address.slice(0, lengthOnEachSide)}–${address.slice(-lengthOnEachSide)}`;
+        case 'full':
+            return address;
+    }
+}
+//# sourceMappingURL=formatAddress.js.map

package/dist/formatAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatAddress.js","sourceRoot":"","sources":["../src/formatAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAO7C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAO,GAAyB,EAAE;IAC/E,MAAM,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,OAAO,CAAA;IAEnC,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,YAAY,CAAA;IACpC,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,MAAM,gBAAgB,GAAG,CAAC,CAAA;YAC1B,IAAI,OAAO,CAAC,MAAM,IAAI,gBAAgB,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,OAAO,CAAA;YAC9D,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAA;QACpF,KAAK,MAAM;YACT,OAAO,OAAO,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/formatBigInt.d.ts

@@ -0,0 +1,23 @@
+export interface BigIntFormatOptions {
+    /**
+     * The number of digits starting from the right of `value` to consider as decimal places.
+     *
+     * @default 18n
+     */
+    precision?: bigint | undefined;
+    /** @default 0 */
+    minimumFractionDigits?: number | undefined;
+    /** @default 20 */
+    maximumFractionDigits?: number | undefined;
+    /** @default 'auto' */
+    trailingZeroDisplay?: 'auto' | 'stripIfInteger' | undefined;
+}
+/**
+ * Formats a bigint as a string.
+ *
+ * @param value - The bigint to format.
+ * @param options - Formatting options.
+ * @returns The string representation of `value`
+ */
+export declare function formatBigInt(value: bigint, options?: BigIntFormatOptions): string;
+//# sourceMappingURL=formatBigInt.d.ts.map

package/dist/formatBigInt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatBigInt.d.ts","sourceRoot":"","sources":["../src/formatBigInt.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,iBAAiB;IACjB,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,kBAAkB;IAClB,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,sBAAsB;IACtB,mBAAmB,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAA;CAC5D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAqCjF"}

package/dist/formatBigInt.js

@@ -0,0 +1,38 @@
+/**
+ * Formats a bigint as a string.
+ *
+ * @param value - The bigint to format.
+ * @param options - Formatting options.
+ * @returns The string representation of `value`
+ */
+export function formatBigInt(value, options) {
+    const { precision = 18n, minimumFractionDigits = 0, maximumFractionDigits = 20, trailingZeroDisplay = 'auto', } = options ?? {};
+    if (precision < 0n) {
+        throw new Error(`[formatBigInt] \`precision\` must be positive, got ${precision}`);
+    }
+    if (minimumFractionDigits > maximumFractionDigits) {
+        throw new Error(`[formatBigInt] \`minimumFractionDigits\` (${minimumFractionDigits}) cannot be greater than \`maximumFractionDigits\` (${maximumFractionDigits})`);
+    }
+    const isNegative = value < 0n;
+    const absValue = isNegative ? value * -1n : value;
+    const precisionFactor = 10n ** precision;
+    const integerPart = absValue / precisionFactor;
+    const integerPartString = `${isNegative ? '-' : ''}${integerPart.toLocaleString('en-US')}`;
+    const decimalPart = absValue % precisionFactor;
+    let decimalPartString = '';
+    if ((decimalPart > 0n || minimumFractionDigits > 0) && maximumFractionDigits > 0) {
+        decimalPartString = decimalPart
+            .toLocaleString('en-US', {
+            useGrouping: false,
+        })
+            .padStart(Number(precision), '0')
+            .replace(/0+$/, '')
+            .padEnd(minimumFractionDigits, '0')
+            .slice(0, maximumFractionDigits);
+        if (trailingZeroDisplay === 'stripIfInteger' && decimalPartString.replace(/0/g, '') === '') {
+            decimalPartString = '';
+        }
+    }
+    return `${integerPartString}${decimalPartString ? `.${decimalPartString}` : ''}`;
+}
+//# sourceMappingURL=formatBigInt.js.map

package/dist/formatBigInt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatBigInt.js","sourceRoot":"","sources":["../src/formatBigInt.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAA6B;IACvE,MAAM,EACJ,SAAS,GAAG,GAAG,EACf,qBAAqB,GAAG,CAAC,EACzB,qBAAqB,GAAG,EAAE,EAC1B,mBAAmB,GAAG,MAAM,GAC7B,GAAG,OAAO,IAAI,EAAE,CAAA;IAEjB,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,SAAS,EAAE,CAAC,CAAA;IACpF,CAAC;IACD,IAAI,qBAAqB,GAAG,qBAAqB,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,6CAA6C,qBAAqB,uDAAuD,qBAAqB,GAAG,CAClJ,CAAA;IACH,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,GAAG,EAAE,CAAA;IAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IACjD,MAAM,eAAe,GAAG,GAAG,IAAI,SAAS,CAAA;IACxC,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAA;IAC9C,MAAM,iBAAiB,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAA;IAC1F,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAA;IAC9C,IAAI,iBAAiB,GAAG,EAAE,CAAA;IAC1B,IAAI,CAAC,WAAW,GAAG,EAAE,IAAI,qBAAqB,GAAG,CAAC,CAAC,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACjF,iBAAiB,GAAG,WAAW;aAC5B,cAAc,CAAC,OAAO,EAAE;YACvB,WAAW,EAAE,KAAK;SACnB,CAAC;aACD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC;aAChC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;aAClB,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC;aAClC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAA;QAClC,IAAI,mBAAmB,KAAK,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAC3F,iBAAiB,GAAG,EAAE,CAAA;QACxB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAAC,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAClF,CAAC"}

package/dist/getKey.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates a stable, unique string key for any JS value.
+ *
+ * - null / undefined => 'null' / 'undefined'
+ * - string / number / boolean => `${type}:${value}` (e.g. 'string:hello', 'number:42',
+ *   'boolean:false')
+ * - registered symbols (`Symbol.for('foo')`) => 'symbol:foo'
+ * - objects / functions / non-registered symbols => one-time ID (e.g. 'ref:1', 'ref:2', etc.)
+ *
+ * @param value - Any JavaScript value.
+ * @returns A string that uniquely and consistently identifies the value.
+ */
+export declare function getKey(value: unknown): string;
+//# sourceMappingURL=getKey.d.ts.map

package/dist/getKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKey.d.ts","sourceRoot":"","sources":["../src/getKey.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqB7C"}

package/dist/getKey.js

@@ -0,0 +1,36 @@
+const refMap = new WeakMap();
+let refCounter = 0;
+/**
+ * Generates a stable, unique string key for any JS value.
+ *
+ * - null / undefined => 'null' / 'undefined'
+ * - string / number / boolean => `${type}:${value}` (e.g. 'string:hello', 'number:42',
+ *   'boolean:false')
+ * - registered symbols (`Symbol.for('foo')`) => 'symbol:foo'
+ * - objects / functions / non-registered symbols => one-time ID (e.g. 'ref:1', 'ref:2', etc.)
+ *
+ * @param value - Any JavaScript value.
+ * @returns A string that uniquely and consistently identifies the value.
+ */
+export function getKey(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return `${typeof value}:${value}`;
+    }
+    if (typeof value === 'symbol') {
+        const registryKey = Symbol.keyFor(value);
+        if (registryKey !== undefined) {
+            return `symbol:${registryKey}`;
+        }
+    }
+    let id = refMap.get(value);
+    if (!id) {
+        id = `ref:${++refCounter}`;
+        refMap.set(value, id);
+    }
+    return id;
+}
+//# sourceMappingURL=getKey.js.map

package/dist/getKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKey.js","sourceRoot":"","sources":["../src/getKey.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,IAAI,OAAO,EAAkB,CAAA;AAC5C,IAAI,UAAU,GAAG,CAAC,CAAA;AAElB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAA;IAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACzF,OAAO,GAAG,OAAO,KAAK,IAAI,KAAK,EAAE,CAAA;IACnC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,UAAU,WAAW,EAAE,CAAA;QAChC,CAAC;IACH,CAAC;IAED,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAA;QAC1B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './constants.ts';
+export * from './types.ts';
+export { bigIntToNumber, type BigIntToNumberOptions } from './bigIntToNumber.ts';
+export { camelToKebab } from './camelToKebab.ts';
+export { createIdenticon } from './createIdenticon.ts';
+export { formatAddress } from './formatAddress.ts';
+export { formatBigInt, type BigIntFormatOptions } from './formatBigInt.ts';
+export { getKey } from './getKey.ts';
+export { loremIpsum } from './loremIpsum.ts';
+export { numberToBigInt, type NumberToBigIntOptions } from './numberToBigInt.ts';
+export { parseBigInt, type ParseBigIntOptions } from './parseBigInt.ts';
+export { parseNumber, type ParseNumberOptions } from './parseNumber.ts';
+export { sliceWrap } from './sliceWrap.ts';
+//# 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,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './constants.js';
+export * from './types.js';
+export { bigIntToNumber } from './bigIntToNumber.js';
+export { camelToKebab } from './camelToKebab.js';
+export { createIdenticon } from './createIdenticon.js';
+export { formatAddress } from './formatAddress.js';
+export { formatBigInt } from './formatBigInt.js';
+export { getKey } from './getKey.js';
+export { loremIpsum } from './loremIpsum.js';
+export { numberToBigInt } from './numberToBigInt.js';
+export { parseBigInt } from './parseBigInt.js';
+export { parseNumber } from './parseNumber.js';
+export { sliceWrap } from './sliceWrap.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,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,cAAc,EAA8B,MAAM,qBAAqB,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAA8B,MAAM,qBAAqB,CAAA;AAChF,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/loremIpsum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generates lorem ipsum text.
+ *
+ * @param {number} [count=4] - The number of words, sentences, or paragraphs to generate. Default is
+ *   `4`
+ * @param {'words' | 'sentences' | 'paragraphs'} [units='sentences'] - The units to generate.
+ *   Default is `'sentences'`
+ * @returns {string} The generated text.
+ */
+export declare function loremIpsum(count?: number, units?: 'words' | 'sentences' | 'paragraphs'): string;
+//# sourceMappingURL=loremIpsum.d.ts.map

package/dist/loremIpsum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loremIpsum.d.ts","sourceRoot":"","sources":["../src/loremIpsum.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,GAAE,MAAU,EACjB,KAAK,GAAE,OAAO,GAAG,WAAW,GAAG,YAA0B,GACxD,MAAM,CAeR"}