@obinexusmk2/hypernum 0.1.0

package/dist/types/config/config-loader.d.ts

@@ -0,0 +1,56 @@
+/**
+ * src/config/config-loader.ts
+ * Responsible for finding and loading configuration files
+ */
+import { HypernumConfig } from "@/core";
+import { ConfigSource } from "./config-source";
+export interface ConfigSearchOptions {
+    /**
+     * Whether to search in parent directories
+     */
+    searchParentDirs?: boolean;
+    /**
+     * Additional paths to search
+     */
+    additionalPaths?: string[];
+    /**
+     * Base directory to start searching from
+     */
+    baseDir?: string;
+}
+export declare class ConfigLoader {
+    private readonly DEFAULT_CONFIG_FILES;
+    private readonly DEFAULT_CONFIG_PATHS;
+    private configParser;
+    private cachedConfig;
+    constructor();
+    /**
+     * Finds configuration files in standard locations
+     */
+    findConfigFiles(options?: ConfigSearchOptions): Map<ConfigSource, string>;
+    /**
+     * Determines the config source type from filename
+     */
+    getConfigSourceFromFilename(filename: string): ConfigSource;
+    /**
+     * Loads configuration from a file
+     */
+    loadConfigFromFile(filePath: string): Partial<HypernumConfig>;
+    /**
+     * Loads configuration from all available sources
+     */
+    loadConfig(options?: ConfigSearchOptions): HypernumConfig;
+    /**
+     * Loads environment variables as configuration
+     */
+    loadEnvConfig(): Partial<HypernumConfig>;
+    /**
+     * Saves configuration to a file
+     */
+    saveConfig(config: HypernumConfig, filePath: string): void;
+    /**
+     * Clears the configuration cache
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/types/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/config/config-loader.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAe,MAAM,QAAQ,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI/C,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAMnC;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAInC;IAEF,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAA+B;;IAMnD;;OAEG;IACI,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC;IAiDpF;;OAEG;IACI,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAYlE;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBpE;;OAEG;IACI,UAAU,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc;IAmCpE;;OAEG;IACI,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAQ/C;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwBjE;;OAEG;IACI,UAAU,IAAI,IAAI;CAG1B"}

package/dist/types/config/config-parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * src/config/config-parser.ts
+ * Parses configuration files in different formats
+ */
+import { HypernumConfig } from "@/core";
+export declare class ConfigParser {
+    /**
+     * Parses a JSON configuration file
+     */
+    parseJsonConfig(filePath: string): Partial<HypernumConfig>;
+    /**
+     * Parses a JavaScript configuration file
+     */
+    parseJsConfig(filePath: string): Partial<HypernumConfig>;
+    /**
+     * Parses an RC configuration file
+     */
+    parseRcConfig(filePath: string): Partial<HypernumConfig>;
+    /**
+     * Parses an INI-style configuration
+     */
+    private parseIniStyleConfig;
+    /**
+     * Stringifies a configuration object for saving
+     */
+    stringifyConfig(config: HypernumConfig): string;
+}
+//# sourceMappingURL=config-parser.d.ts.map

package/dist/types/config/config-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-parser.d.ts","sourceRoot":"","sources":["../../../src/config/config-parser.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAKxC,qBAAa,YAAY;IACvB;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUjE;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmB/D;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiC/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsD3B;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAgBvD"}

package/dist/types/config/config-resolver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * src/config/config-resolver.ts
+ * Resolves configuration from multiple sources
+ */
+import { HypernumConfig } from '../core/config';
+import { ConfigSource } from './config-source';
+export declare class ConfigResolver {
+    /**
+     * Default precedence order for configuration sources
+     */
+    private readonly DEFAULT_PRECEDENCE;
+    /**
+     * Resolves configuration from multiple sources
+     */
+    resolveConfig(configs: Map<ConfigSource, Partial<HypernumConfig>>): HypernumConfig;
+    /**
+     * Validates a configuration source
+     */
+    validateConfigSource(config: Partial<HypernumConfig>): boolean;
+}
+//# sourceMappingURL=config-resolver.d.ts.map

package/dist/types/config/config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.d.ts","sourceRoot":"","sources":["../../../src/config/config-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,qBAAa,cAAc;IACzB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAMjC;IAEF;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc;IAkBzF;;OAEG;IACI,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO;CAQtE"}

package/dist/types/config/config-source.d.ts

@@ -0,0 +1,27 @@
+/**
+ * src/config/config-source.ts
+ * Enum defining possible configuration sources
+ */
+export declare enum ConfigSource {
+    /**
+     * Environment variables with HYPERNUM_ prefix
+     */
+    ENV_VARIABLES = "ENV_VARIABLES",
+    /**
+     * RC file (.hypernumrc, .hypernumrc.json, etc.)
+     */
+    RC_FILE = "RC_FILE",
+    /**
+     * JSON configuration file (hypernum.config.json)
+     */
+    JSON_FILE = "JSON_FILE",
+    /**
+     * JavaScript configuration file (hypernum.config.js)
+     */
+    JS_FILE = "JS_FILE",
+    /**
+     * Inline configuration passed to createHypernum()
+     */
+    INLINE_CONFIG = "INLINE_CONFIG"
+}
+//# sourceMappingURL=config-source.d.ts.map

package/dist/types/config/config-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.d.ts","sourceRoot":"","sources":["../../../src/config/config-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,YAAY;IACpB;;OAEG;IACH,aAAa,kBAAkB;IAE/B;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,aAAa,kBAAkB;CAChC"}

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

@@ -0,0 +1,68 @@
+/**
+ * src/config/index.ts
+ * Main configuration module
+ */
+import { HypernumConfig } from '../core/config';
+import { ConfigLoader } from './config-loader';
+import { ConfigParser } from './config-parser';
+import { ConfigResolver } from './config-resolver';
+import { ConfigSource } from './config-source';
+interface ConfigurationOptions {
+    /**
+     * Path to a configuration file to use
+     */
+    configFile?: string;
+    /**
+     * Whether to search for configuration files in parent directories
+     */
+    searchParentDirs?: boolean;
+    /**
+     * Additional paths to search for configuration files
+     */
+    additionalSearchPaths?: string[];
+    /**
+     * Whether to use environment variables
+     */
+    useEnvVars?: boolean;
+    /**
+     * Whether to cache the configuration
+     */
+    cacheConfig?: boolean;
+    /**
+     * Inline configuration to use as a base
+     */
+    baseConfig?: Partial<HypernumConfig>;
+}
+/**
+ * Main configuration module for Hypernum
+ */
+export declare class ConfigurationModule {
+    configLoader: ConfigLoader;
+    configParser: ConfigParser;
+    configResolver: ConfigResolver;
+    cachedConfig: HypernumConfig | null;
+    constructor();
+    /**
+     * Gets the configuration, loading from all available sources
+     */
+    getConfig(options?: ConfigurationOptions): HypernumConfig;
+    /**
+     * Initializes configuration from a file
+     */
+    initializeFromFile(filePath: string, options?: ConfigurationOptions): HypernumConfig;
+    /**
+     * Creates a default configuration
+     */
+    createDefaultConfig(type: 'basic' | 'full'): HypernumConfig;
+    /**
+     * Saves configuration to a file
+     */
+    saveConfigToFile(config: HypernumConfig, filePath: string): void;
+    getConfigSourceFromFilename(filename: string): ConfigSource;
+    /**
+     * Clears the configuration cache
+     */
+    clearCache(): void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAA4C,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,UAAU,oBAAoB;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,mBAAmB;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,cAAc,GAAG,IAAI,CAAQ;;IAQlD;;OAEG;IACI,SAAS,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc;IA+DpE;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,cAAc;IAO/F;;OAEG;IACI,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc;IAIlE;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIhE,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAIlE;;OAEG;IACI,UAAU,IAAI,IAAI;CAI1B"}

package/dist/types/core/common.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Common type definitions for Hypernum library
+ * Contains shared types used throughout the library's modules
+ */
+import { RoundingMode } from '../utils/precision';
+/**
+ * Valid input types for numeric values
+ */
+export type NumericInput = bigint | string | number;
+/**
+ * Result type for operations that may fail
+ */
+export type Result<T> = {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The operation result if successful */
+    value?: T;
+    /** Error message if operation failed */
+    error?: string;
+};
+/**
+ * Base options interface for operations
+ */
+export interface BaseOptions {
+    /** Decimal precision for operations */
+    precision?: number;
+    /** Rounding mode for decimal operations */
+    roundingMode?: RoundingMode;
+    /** Whether to check for overflow */
+    checkOverflow?: boolean;
+}
+/**
+ * Options for number formatting
+ */
+export interface FormatOptions extends BaseOptions {
+    /** Number notation style */
+    notation?: 'standard' | 'scientific' | 'engineering' | 'compact';
+    /** Enable grouping separators */
+    grouping?: boolean;
+    /** Size of digit groups */
+    groupSize?: number;
+    /** Decimal point character */
+    decimalSeparator?: string;
+    /** Grouping separator character */
+    groupSeparator?: string;
+    /** Convert to uppercase (for special formats) */
+    uppercase?: boolean;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Maximum number of entries */
+    maxSize: number;
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+    /** Eviction policy */
+    evictionPolicy?: 'LRU' | 'LFU' | 'FIFO';
+}
+/**
+ * Mathematical constants configuration
+ */
+export interface MathConstantsConfig {
+    /** Precision for constant calculations */
+    precision: number;
+    /** Enable caching of computed values */
+    cache?: boolean;
+    /** Custom calculation algorithm */
+    algorithm?: 'series' | 'iteration' | 'approximation';
+}
+/**
+ * Debug configuration
+ */
+export interface DebugConfig {
+    /** Enable detailed logging */
+    verbose: boolean;
+    /** Track operation performance */
+    trackPerformance: boolean;
+    /** Log level */
+    logLevel: 'error' | 'warn' | 'info' | 'debug';
+}
+/**
+ * Numeric range specification
+ */
+export interface NumericRange {
+    /** Start of range (inclusive) */
+    start: bigint;
+    /** End of range (inclusive) */
+    end: bigint;
+    /** Step size for iteration */
+    step?: bigint;
+}
+/**
+ * Operation status monitoring
+ */
+export interface OperationStatus {
+    /** Current phase of operation */
+    phase: string;
+    /** Percentage complete (0-100) */
+    progress: number;
+    /** Estimated time remaining (ms) */
+    estimatedTimeRemaining?: number;
+    /** Memory usage in bytes */
+    memoryUsage?: number;
+    /** Computation steps completed */
+    steps: number;
+}
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    /** Operation execution time (ms) */
+    executionTime: number;
+    /** Number of computation steps */
+    steps: number;
+    /** Peak memory usage (bytes) */
+    peakMemory: number;
+    /** Cache hit rate (0-1) */
+    cacheHitRate?: number;
+}
+/**
+ * Comparison function type
+ * Returns:
+ *  -1: a < b
+ *   0: a = b
+ *   1: a > b
+ */
+export type Comparator<T> = (a: T, b: T) => -1 | 0 | 1;
+/**
+ * Progress callback type
+ */
+export type ProgressCallback = (status: OperationStatus) => void;
+/**
+ * Error callback type
+ */
+export type ErrorCallback = (error: Error, phase: string) => void;
+/**
+ * Value validation function type
+ */
+export type Validator<T> = (value: T) => boolean;
+/**
+ * Node statistics interface
+ */
+export interface NodeStats {
+    /** Node height in tree */
+    height: number;
+    /** Subtree size */
+    size: number;
+    /** Sum of subtree values */
+    sum: bigint;
+    /** Minimum value in subtree */
+    min: bigint;
+    /** Maximum value in subtree */
+    max: bigint;
+}
+/**
+ * Operation options interface
+ */
+export interface OperationOptions extends BaseOptions {
+    /** Maximum computation steps */
+    maxSteps?: number;
+    /** Progress callback */
+    onProgress?: ProgressCallback;
+    /** Error callback */
+    onError?: ErrorCallback;
+    /** Value validator */
+    validator?: Validator<bigint>;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/core/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/core/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;IACjE,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,eAAe,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,qBAAqB;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,sBAAsB;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC/B"}

package/dist/types/core/config.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Configuration type definitions for Hypernum library
+ * Defines all configuration options and their default values
+ */
+import { RoundingMode } from '../utils/precision';
+import { FormatOptions, DebugConfig, CacheConfig, MathConstantsConfig } from './common';
+/**
+ * Basic configuration options for simple usage
+ */
+export interface BasicConfig {
+    /** Decimal precision for operations */
+    precision?: number;
+    /** Rounding mode for decimal operations */
+    roundingMode?: RoundingMode;
+    /** Whether to check for overflow */
+    checkOverflow?: boolean;
+    /** Maximum allowed computation steps */
+    maxSteps?: number;
+    /** Enable debug mode */
+    debug?: boolean;
+}
+/**
+ * Configuration for arithmetic operations
+ */
+export interface ArithmeticConfig {
+    /** Default precision for decimal operations */
+    defaultPrecision: number;
+    /** Default rounding mode */
+    defaultRoundingMode: RoundingMode;
+    /** Whether to check for overflow by default */
+    checkOverflow: boolean;
+    /** Maximum steps for iterative calculations */
+    maxComputationSteps: number;
+    /** Configure automatic precision adjustment */
+    autoPrecision: {
+        enabled: boolean;
+        maxPrecision: number;
+        minPrecision: number;
+    };
+    /** Constants calculation configuration */
+    constants: MathConstantsConfig;
+}
+/**
+ * Configuration for data structures
+ */
+export interface DataStructuresConfig {
+    /** Array configuration */
+    array: {
+        initialCapacity: number;
+        growthFactor: number;
+        maxSize: number;
+    };
+    /** Tree configuration */
+    tree: {
+        maxDepth: number;
+        autoBalance: boolean;
+        nodeLimit: number;
+    };
+    /** Heap configuration */
+    heap: {
+        initialCapacity: number;
+        growthPolicy: 'double' | 'linear' | 'fibonacci';
+        validatePropertyOnOperation: boolean;
+    };
+    /** Cache configuration */
+    cache: CacheConfig & {
+        enabled: boolean;
+        persistToDisk: boolean;
+        compressionEnabled: boolean;
+    };
+}
+/**
+ * Configuration for number formatting
+ */
+export interface FormattingConfig extends FormatOptions {
+    /** Scientific notation configuration */
+    scientific: {
+        /** Minimum exponent to trigger scientific notation */
+        minExponent: number;
+        /** Maximum significant digits */
+        maxSignificantDigits: number;
+        /** Exponent separator character */
+        exponentSeparator: string;
+    };
+    /** Engineering notation configuration */
+    engineering: {
+        /** Use SI prefixes */
+        useSIPrefixes: boolean;
+        /** Custom unit definitions */
+        customUnits?: Map<number, string>;
+    };
+    /** Localization settings */
+    localization: {
+        /** Locale identifier */
+        locale: string;
+        /** Custom number formatting */
+        numberFormat?: Intl.NumberFormatOptions;
+        /** Use locale-specific grouping */
+        useLocaleGrouping: boolean;
+    };
+}
+/**
+ * Configuration for performance monitoring
+ */
+export interface PerformanceConfig {
+    /** Enable performance tracking */
+    enableTracking: boolean;
+    /** Sampling rate for metrics (0-1) */
+    samplingRate: number;
+    /** Performance thresholds */
+    thresholds: {
+        /** Warning threshold in milliseconds */
+        warnThresholdMs: number;
+        /** Error threshold in milliseconds */
+        errorThresholdMs: number;
+        /** Maximum allowed memory usage in bytes */
+        maxMemoryBytes: number;
+    };
+    /** Metrics collection configuration */
+    metrics: {
+        /** Enable detailed operation timing */
+        timing: boolean;
+        /** Track memory usage */
+        memory: boolean;
+        /** Track cache performance */
+        cache: boolean;
+        /** Custom metrics to track */
+        custom?: Map<string, (operation: any) => number>;
+    };
+}
+/**
+ * Feature flags for optional functionality
+ */
+export interface FeatureFlags {
+    /** Enable experimental features */
+    experimentalFeatures: boolean;
+    /** Use WebAssembly implementations when available */
+    useWasm: boolean;
+    /** Enable worker thread support */
+    workerThreads: boolean;
+    /** Enable SharedArrayBuffer support */
+    sharedArrayBuffer: boolean;
+    /** Enable BigInt64Array support */
+    bigIntTypedArrays: boolean;
+}
+/**
+ * Full configuration interface with all options
+ */
+export interface FullConfig {
+    /** Arithmetic operation configuration */
+    arithmetic: ArithmeticConfig;
+    /** Data structure configuration */
+    dataStructures: DataStructuresConfig;
+    /** Formatting configuration */
+    formatting: FormattingConfig;
+    /** Performance configuration */
+    performance: PerformanceConfig;
+    /** Debug configuration */
+    debug: DebugConfig;
+    /** Feature flags */
+    features: FeatureFlags;
+    /** Custom configuration options */
+    custom?: Map<string, any>;
+}
+/**
+ * Converts FullConfig to BasicConfig if necessary
+ */
+export declare function convertToBasicConfig(config: HypernumConfig): BasicConfig;
+/**
+ * Combined configuration type that can be either basic or full
+ */
+export type HypernumConfig = BasicConfig | FullConfig;
+/**
+ * Default configuration values for basic config
+ */
+export declare const DEFAULT_BASIC_CONFIG: Required<BasicConfig>;
+/**
+ * Full default configuration values
+ */
+export declare const DEFAULT_FULL_CONFIG: FullConfig;
+/**
+ * Type guard to check if config is a full configuration
+ */
+export declare function isFullConfig(config: HypernumConfig): config is FullConfig;
+/**
+ * Type guard to check if config is a basic configuration
+ */
+export declare function isBasicConfig(config: HypernumConfig): config is BasicConfig;
+/**
+ * Validates configuration values
+ */
+export declare function validateConfig(config: HypernumConfig): void;
+/**
+ * Merges configuration with appropriate defaults
+ */
+export declare function mergeConfig(custom?: Partial<HypernumConfig>): HypernumConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/core/config.d.ts.map

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