@obinexusmk2/hypernum 0.1.0

package/dist/types/structures/power-tower.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Interface for power tower computation options
+ */
+interface PowerTowerOptions {
+    maxHeight?: number;
+    maxValue?: bigint;
+    checkOverflow?: boolean;
+    precision?: number;
+}
+/**
+ * Class representing a power tower (tetration) computation structure
+ * Handles expressions of the form: a↑↑b = a^(a^(a^...)) (b times)
+ */
+export declare class PowerTower {
+    private readonly options;
+    private head;
+    private tail;
+    private size;
+    constructor(options?: PowerTowerOptions);
+    /**
+     * Creates a new power tower node
+     */
+    private createNode;
+    /**
+     * Validates power tower height
+     */
+    private validateHeight;
+    /**
+     * Validates value for computation
+     */
+    private validateValue;
+    /**
+     * Computes power with overflow checking
+     */
+    private computePower;
+    /**
+     * Builds a power tower of specified height with given base
+     */
+    build(base: bigint | number | string, height: number): void;
+    /**
+     * Evaluates the power tower up to specified height
+     */
+    evaluate(height?: number): bigint;
+    /**
+     * Gets the current height of the power tower
+     */
+    getHeight(): number;
+    /**
+     * Checks if the tower can be evaluated to a given height
+     */
+    isComputable(height?: number): boolean;
+    /**
+     * Gets the computation state at each level
+     */
+    getState(): {
+        height: number;
+        value: bigint;
+        evaluated: boolean;
+    }[];
+    /**
+     * Clears the power tower
+     */
+    clear(): void;
+    /**
+     * Gets the maximum computationally feasible height for a given base
+     */
+    static getMaxFeasibleHeight(base: bigint | number | string): number;
+    /**
+     * Creates a string representation of the power tower
+     */
+    toString(): string;
+}
+export default PowerTower;
+//# sourceMappingURL=power-tower.d.ts.map

package/dist/types/structures/power-tower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-tower.d.ts","sourceRoot":"","sources":["../../../src/structures/power-tower.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,GAAE,iBAAsB;IAO3C;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAqBlE;;OAEG;IACI,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAmCxC;;OAEG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IA8B7C;;OAEG;IACI,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE;IAgB1E;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;WACW,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAY1E;;OAEG;IACI,QAAQ,IAAI,MAAM;CAe1B;AAED,eAAe,UAAU,CAAC"}

package/dist/types/utils/formatting.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Formatting utilities for Hypernum library
+ * Provides functions for formatting large numbers and converting between different representations
+ */
+export interface FormatOptions {
+    notation?: 'standard' | 'scientific' | 'engineering' | 'compact';
+    precision?: number;
+    grouping?: boolean;
+    groupSize?: number;
+    decimalSeparator?: string;
+    groupSeparator?: string;
+}
+export interface ScientificNotation {
+    coefficient: string;
+    exponent: number;
+}
+export interface ScientificNotation {
+    coefficient: string;
+    exponent: number;
+}
+/**
+ * Formats a BigInt value according to specified options
+ */
+export declare const formatBigInt: (value: bigint, options?: FormatOptions) => string;
+/**
+ * Parses a formatted string back to BigInt
+ */
+export declare const parseBigIntString: (str: string, options?: FormatOptions) => bigint;
+/**
+ * Normalizes a string representation for comparison
+ */
+export declare const normalizeNumberString: (str: string) => string;
+/**
+ * Formats a number for display in a tree structure
+ */
+export declare const formatTreeValue: (value: bigint, depth?: number) => string;
+/**
+ * Formats a range of numbers for display
+ */
+export declare const formatRange: (start: bigint, end: bigint, options?: FormatOptions) => string;
+/**
+ * Formats a percentage
+ */
+export declare const formatPercentage: (value: bigint, total: bigint, precision?: number) => string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/types/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;GAEG;AACH,eAAO,MAAM,YAAY,UAAW,MAAM,YAAW,aAAa,KAAQ,MAwBzE,CAAC;AAoGF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAS,MAAM,YAAW,aAAa,KAAQ,MAiC5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,KAAG,MAanD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,UAAW,MAAM,UAAS,MAAM,KAAO,MAGlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,OAAO,MAAM,YAAW,aAAa,KAAQ,MAErF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,SAAS,MAAM,cAAa,MAAM,KAAO,MAOtF,CAAC"}

package/dist/types/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './validation';
+export * from './precision';
+export * from './formatting';
+export * from './parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA"}

package/dist/types/utils/parser.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Parser utilities for Hypernum library
+ * Provides functions for parsing various number formats and notations
+ */
+import { RoundingMode } from './precision';
+/**
+ * Supported number format types
+ */
+export declare enum NumberFormat {
+    STANDARD = "STANDARD",// Regular decimal notation
+    SCIENTIFIC = "SCIENTIFIC",// Scientific notation (e.g., 1.23e4)
+    ENGINEERING = "ENGINEERING",// Engineering notation (e.g., 1.23e6)
+    COMPACT = "COMPACT",// Compact notation with suffixes (e.g., 1.23M)
+    FRACTION = "FRACTION",// Fractional notation (e.g., 1/3)
+    PERCENTAGE = "PERCENTAGE",// Percentage notation (e.g., 12.3%)
+    HEXADECIMAL = "HEXADECIMAL",// Hex notation (e.g., 0xFF)
+    BINARY = "BINARY",// Binary notation (e.g., 0b1010)
+    OCTAL = "OCTAL"
+}
+/**
+ * Options for parsing numbers
+ */
+export interface ParseOptions {
+    format?: NumberFormat;
+    base?: number;
+    allowFractions?: boolean;
+    rounding?: RoundingMode;
+    precision?: number;
+    strict?: boolean;
+}
+/**
+ * Parse any supported number format to BigInt
+ */
+export declare const parseNumber: (input: string, options?: ParseOptions) => bigint;
+/**
+ * Detect number format from string
+ */
+export declare const detectNumberFormat: (str: string) => NumberFormat;
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/utils/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/utils/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa,CAAU,2BAA2B;IAC1D,UAAU,eAAe,CAAM,qCAAqC;IACpE,WAAW,gBAAgB,CAAI,sCAAsC;IACrE,OAAO,YAAY,CAAW,+CAA+C;IAC7E,QAAQ,aAAa,CAAS,kCAAkC;IAChE,UAAU,eAAe,CAAK,oCAAoC;IAClE,WAAW,gBAAgB,CAAG,4BAA4B;IAC1D,MAAM,WAAW,CAAY,iCAAiC;IAC9D,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,YAAW,YAAY,KAAQ,MAoCvE,CAAC;AAiJF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,KAAG,YAahD,CAAC"}

package/dist/types/utils/precision.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Precision utilities for Hypernum library
+ * Provides functions for handling decimal precision and rounding operations
+ */
+/**
+ * Rounding modes for decimal operations
+ */
+export declare enum RoundingMode {
+    FLOOR = "FLOOR",// Round towards negative infinity
+    CEIL = "CEIL",// Round towards positive infinity
+    DOWN = "DOWN",// Round towards zero
+    UP = "UP",// Round away from zero
+    HALF_EVEN = "HALF_EVEN",// Round to nearest even number when tied (Banker's rounding)
+    HALF_UP = "HALF_UP",// Round up when tied
+    HALF_DOWN = "HALF_DOWN"
+}
+/**
+ * Scale a bigint by a power of 10
+ */
+export declare const scaleByPowerOfTen: (value: bigint, power: number) => bigint;
+/**
+ * Round a number according to specified mode and precision
+ */
+export declare const round: (value: bigint, precision?: number, mode?: RoundingMode) => bigint;
+/**
+ * Calculate precision required to represent a number without loss
+ */
+export declare const calculateRequiredPrecision: (value: bigint) => number;
+/**
+ * Normalize two numbers to the same precision
+ */
+export declare const normalizePrecision: (a: bigint, b: bigint, precisionA: number, precisionB: number) => [bigint, bigint];
+/**
+ * Scale a division operation to achieve desired precision
+ */
+export declare const scaledDivision: (numerator: bigint, denominator: bigint, precision: number, roundingMode?: RoundingMode) => bigint;
+/**
+ * Calculate the number of significant digits
+ */
+export declare const significantDigits: (value: bigint) => number;
+/**
+ * Truncate to specified number of significant digits
+ */
+export declare const truncateToSignificantDigits: (value: bigint, digits: number, roundingMode?: RoundingMode) => bigint;
+/**
+ * Check if two numbers are equal within a specified precision
+ */
+export declare const equalWithinPrecision: (a: bigint, b: bigint, precision: number) => boolean;
+/**
+ * Get the fractional part of a number at a given precision
+ */
+export declare const getFractionalPart: (value: bigint, precision: number) => bigint;
+/**
+ * Format a number with exact precision (no rounding)
+ */
+export declare const toExactPrecision: (value: bigint, precision: number) => string;
+//# sourceMappingURL=precision.d.ts.map

package/dist/types/utils/precision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../../src/utils/precision.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,oBAAY,YAAY;IACtB,KAAK,UAAU,CAAY,kCAAkC;IAC7D,IAAI,SAAS,CAAc,kCAAkC;IAC7D,IAAI,SAAS,CAAc,qBAAqB;IAChD,EAAE,OAAO,CAAkB,uBAAuB;IAClD,SAAS,cAAc,CAAI,6DAA6D;IACxF,OAAO,YAAY,CAAQ,qBAAqB;IAChD,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAAW,MAAM,SAAS,MAAM,KAAG,MAMhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,UACT,MAAM,cACF,MAAM,SACX,YAAY,KACjB,MAyCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,UAAW,MAAM,KAAG,MAM1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,MAC1B,MAAM,KACN,MAAM,cACG,MAAM,cACN,MAAM,KACjB,CAAC,MAAM,EAAE,MAAM,CAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,cACd,MAAM,eACJ,MAAM,aACR,MAAM,iBACH,YAAY,KACzB,MAcF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,MAQjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,UAC/B,MAAM,UACL,MAAM,iBACA,YAAY,KACzB,MAaF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,MAC5B,MAAM,KACN,MAAM,aACE,MAAM,KAChB,OAIF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,UACrB,MAAM,aACF,MAAM,KAChB,MAKF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,aAAa,MAAM,KAAG,MAmBnE,CAAC"}

package/dist/types/utils/validation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Validation utilities for Hypernum library
+ * Provides type checking and validation functions for large number operations
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class OverflowError extends Error {
+    constructor(message: string);
+}
+export declare const isBigInt: (value: unknown) => value is bigint;
+export declare const isValidNumberString: (value: string) => boolean;
+export declare const isValidNumber: (value: unknown) => value is number;
+export declare const toBigInt: (value: unknown) => bigint;
+export declare const validateRange: (value: bigint, min?: bigint, max?: bigint) => void;
+export declare const checkAdditionOverflow: (a: bigint, b: bigint) => void;
+export declare const checkMultiplicationOverflow: (a: bigint, b: bigint) => void;
+export declare const checkPowerOverflow: (base: bigint, exponent: bigint) => void;
+export declare const validateArrayLength: (length: number) => void;
+export declare const validateArrayIndex: (index: number, length: number) => void;
+export declare const validateTreeNode: (value: unknown) => void;
+export declare const validateHeapProperty: <T>(value: T, parent: T | undefined, comparator: (a: T, b: T) => -1 | 0 | 1, isMinHeap: boolean) => void;
+export declare const validateAckermannInput: (m: number, n: number) => void;
+export declare const isInRange: (value: bigint, min: bigint, max: bigint) => boolean;
+export declare const isPowerOfTwo: (value: bigint) => boolean;
+export declare const validatePositive: (value: bigint) => void;
+export declare const validateNonNegative: (value: bigint) => void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,qBAAa,eAAgB,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAGD,eAAO,MAAM,QAAQ,UAAW,OAAO,oBAEtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,OAEnD,CAAC;AAEF,eAAO,MAAM,aAAa,UAAW,OAAO,oBAE3C,CAAC;AAGF,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,MAoBzC,CAAC;AAGF,eAAO,MAAM,aAAa,UAAW,MAAM,QAAQ,MAAM,QAAQ,MAAM,KAAG,IAOzE,CAAC;AAGF,eAAO,MAAM,qBAAqB,MAAO,MAAM,KAAK,MAAM,KAAG,IAQ5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,MAAO,MAAM,KAAK,MAAM,KAAG,IAUlE,CAAC;AAEF,eAAO,MAAM,kBAAkB,SAAU,MAAM,YAAY,MAAM,KAAG,IAanE,CAAC;AAGF,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,IAOpD,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAAW,MAAM,UAAU,MAAM,KAAG,IAOlE,CAAC;AAGF,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,IAMjD,CAAC;AAGF,eAAO,MAAM,oBAAoB,aACxB,CAAC,UACA,CAAC,GAAG,SAAS,cACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,aAC3B,OAAO,KACjB,IAUF,CAAC;AAGF,eAAO,MAAM,sBAAsB,MAAO,MAAM,KAAK,MAAM,KAAG,IAU7D,CAAC;AAGF,eAAO,MAAM,SAAS,UAAW,MAAM,OAAO,MAAM,OAAO,MAAM,KAAG,OAEnE,CAAC;AAEF,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,OAE5C,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,IAIhD,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,IAInD,CAAC"}

package/package.json

@@ -0,0 +1,164 @@
+{
+  "name": "@obinexusmk2/hypernum",
+  "version": "0.1.0",
+  "description": "A high-precision mathematics library for large number operations with BigInt support, custom data structures, and comprehensive type safety",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/index.umd.js",
+  "unpkg": "dist/index.umd.js",
+  "cdn": "dist/index.umd.js",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "rollup.config.js",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rimraf dist coverage .nyc_output",
+    "prebuild": "npm run clean",
+    "prepack": "npm run build",
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "test:ci": "jest --ci --coverage --runInBand",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepare": "npm run build",
+    "docs": "typedoc --out docs src",
+    "benchmark": "ts-node benchmark/index.ts",
+    "release": "standard-version",
+    "commit": "git-cz"
+  },
+  "keywords": [
+    "bigint",
+    "large-numbers",
+    "arithmetic",
+    "mathematics",
+    "computation",
+    "data-structures",
+    "typescript",
+    "javascript",
+    "number-theory",
+    "high-precision",
+    "ackermann",
+    "tetration",
+    "avl-tree",
+    "power-tower"
+  ],
+  "author": "Obi Nexus Computing <contact@obinexusmk2.com> (https://obinexusmk2.com)",
+  "funding": {
+    "type": "individual",
+    "url": "https://www.buymeacoffee.com/obinexusmk2"
+  },
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/obinexusmk2/hypernum.git"
+  },
+  "bugs": {
+    "url": "https://github.com/obinexusmk2/hypernum/issues"
+  },
+  "homepage": "https://obinexusmk2.github.io/hypernum",
+  "dependencies": {
+    "find-up": "^5.0.0",
+    "rc": "^1.2.8",
+    "tslib": "^2.6.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^18.0.0",
+    "@commitlint/config-conventional": "^18.0.0",
+    "@rollup/plugin-alias": "^5.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-json": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "@types/rc": "^1.2.1",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "commitizen": "^4.2.4",
+    "cz-conventional-changelog": "^3.3.0",
+    "eslint": "^8.0.0",
+    "eslint-config-prettier": "^6.15.0",
+    "eslint-plugin-prettier": "^2.7.0",
+    "husky": "^8.0.0",
+    "jest": "^19.0.2",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-copy": "^2.0.1",
+    "rollup-plugin-dts": "^6.0.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "standard-version": "^9.5.0",
+    "ts-jest": "^19.0.14",
+    "ts-node": "^10.0.0",
+    "typedoc": "^0.28.17",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.5.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "config": {
+    "commitizen": {
+      "path": "cz-conventional-changelog"
+    }
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": [
+      "<rootDir>/src/**/*.test.ts"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.ts",
+      "!src/**/*.d.ts",
+      "!src/**/*.test.ts"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 80,
+        "functions": 80,
+        "lines": 80,
+        "statements": 80
+      }
+    }
+  },
+  "prettier": {
+    "semi": true,
+    "singleQuote": true,
+    "trailingComma": "es5",
+    "printWidth": 80
+  },
+  "directories": {
+    "doc": "docs",
+    "example": "examples"
+  }
+}

package/rollup.config.js

@@ -0,0 +1,162 @@
+import typescript from 'rollup-plugin-typescript2';
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import terser from '@rollup/plugin-terser';
+import dts from 'rollup-plugin-dts';
+import alias from '@rollup/plugin-alias';
+import path from 'path';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+
+const banner = `/**
+ * ${pkg.name} v${pkg.version}
+*  Precison at Scale
+ *${pkg.description} 
+ * @license ISC
+ */`;
+
+// External dependencies
+const external = [
+  ...Object.keys(pkg.dependencies || {}),
+  ...Object.keys(pkg.peerDependencies || {}),
+  'tslib'
+];
+
+// Alias configurations for hypernum specific paths
+const srcAliases = [
+  { find: '@', replacement: path.resolve(__dirname, 'src') },
+  { find: '@core', replacement: path.resolve(__dirname, 'src/core') },
+  { find: '@operations', replacement: path.resolve(__dirname, 'src/operations') },
+  { find: '@structures', replacement: path.resolve(__dirname, 'src/structures') },
+  {find: '@storage', replacement: path.resolve(__dirname, 'src/storage') },
+  { find: '@utils', replacement: path.resolve(__dirname, 'src/utils') },
+  { find: '@types', replacement: path.resolve(__dirname, 'src/types') }
+];
+
+// TypeScript configuration optimized for BigInt operations
+const typeScriptConfig = {
+  tsconfig: './tsconfig.json',
+  clean: true,
+  useTsconfigDeclarationDir: true,
+  tsconfigOverride: {
+    compilerOptions: {
+      declaration: true,
+      declarationDir: './dist/types',
+      sourceMap: true,
+      module: 'esnext',
+      moduleResolution: 'node',
+      target: 'es2020', // Ensures BigInt compatibility
+      lib: ['es2020', 'dom'],
+      allowSyntheticDefaultImports: true
+    },
+    exclude: ['**/__tests__/**', '**/*.test.ts', 'src/**/*.spec.ts']
+  }
+};
+
+// Base plugins configuration
+const basePlugins = [
+  alias({ entries: srcAliases }),
+  resolve({
+    browser: true,
+    preferBuiltins: true,
+    mainFields: ['module', 'browser', 'main'],
+    extensions: ['.ts', '.js']
+  }),
+  commonjs({
+    include: /node_modules/,
+    requireReturnsDefault: 'auto'
+  }),
+  typescript(typeScriptConfig)
+];
+
+// Base output configuration
+const baseOutput = {
+  banner,
+  sourcemap: true,
+  exports: 'named'
+};
+
+// Main builds configuration
+const mainBuilds = [
+  // UMD build
+  {
+    input: 'src/index.ts',
+    output: {
+      ...baseOutput,
+      file: 'dist/index.umd.js',
+      format: 'umd',
+      name: 'Hypernum',
+      globals: {
+        tslib: 'tslib'
+      }
+    },
+    external,
+    plugins: [
+      ...basePlugins,
+      terser({
+        output: {
+          comments: (node, comment) =>
+            comment.type === 'comment2' && /@license/i.test(comment.value)
+        }
+      })
+    ]
+  },
+  // ESM build
+  {
+    input: 'src/index.ts',
+    output: {
+      ...baseOutput,
+      file: 'dist/index.js',
+      format: 'esm'
+    },
+    external,
+    plugins: basePlugins
+  },
+  // CommonJS build
+  {
+    input: 'src/index.ts',
+    output: {
+      ...baseOutput,
+      file: 'dist/index.cjs',
+      format: 'cjs'
+    },
+    external,
+    plugins: basePlugins
+  }
+];
+
+// Types build configuration
+const typesBuild = {
+  input: 'src/index.ts',
+  output: {
+    file: 'dist/index.d.ts',
+    format: 'es'
+  },
+  external: [
+    ...external,
+    /\.css$/,
+    /@types\/.*/,
+    /@core\/.*/,
+    /@operations\/.*/,
+    /@structures\/.*/,
+    /@utils\/.*/,
+    /@\/.*/
+  ],
+  plugins: [
+    alias({
+      entries: srcAliases.map(entry => ({
+        ...entry,
+        replacement: entry.replacement.replace('/src/', '/dist/types/')
+      }))
+    }),
+    dts()
+  ]
+};
+
+export default [
+  ...mainBuilds,
+  typesBuild
+];