@nmakarov/cli-toolkit 0.7.1 → 0.8.0

package/dist/params.cjs

@@ -31,8 +31,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var params_exports = {};
 __export(params_exports, {
   Params: () => Params,
-  getParamsInstance: () => getParamsInstance,
-  init: () => init,
   joiEdateType: () => joiEdateType,
   joiStringArrayType: () => joiStringArrayType
 });
@@ -175,18 +173,76 @@ var joiStringArrayType = (type) => (value, helpers) => {
 };
 
 // src/params/index.ts
-var Params = class {
+var Params = class _Params {
+  context;
+  // Partial context during initialization
   params = {};
   definitions = {};
   args;
   paramSetters = [];
   paramGetters = [];
-  constructor({ args }, opts = {}) {
-    this.args = args;
-    for (const [k, v] of Object.entries(opts)) {
+  trackedParams = [];
+  constructor(context, options = {}) {
+    this.context = context;
+    this.args = context.args;
+    if (Object.keys(options).length > 0) {
+      this.configure(options);
+    }
+  }
+  /**
+   * Configure parameters
+   * Only parameters present in options are updated
+   */
+  configure(options) {
+    for (const [k, v] of Object.entries(options)) {
       this.params[k] = v;
     }
   }
+  /**
+   * Initialize Params from context and CLI parameters
+   * Note: Params is special - it's initialized early with partial context
+   */
+  static init(context, options) {
+    return new _Params(context, options || {});
+  }
+  /**
+   * Track a parameter request for --stopAfter=init feature
+   */
+  trackParam(key, definition, value, source) {
+    this.trackedParams.push({
+      key,
+      definition,
+      value,
+      source
+    });
+  }
+  /**
+   * Get all tracked parameters (for --stopAfter=init)
+   */
+  getTrackedParams() {
+    return [...this.trackedParams];
+  }
+  /**
+   * Get all figured parameters as a record
+   * Returns all parameters that were collected during initialization,
+   * whether from CLI args, options, or defaults
+   */
+  getAllFigured() {
+    const result = {};
+    for (const param of this.trackedParams) {
+      result[param.key] = {
+        value: param.value,
+        source: param.source
+      };
+    }
+    return result;
+  }
+  /**
+   * Clear tracked parameters
+   */
+  clearTrackedParams() {
+    this.trackedParams = [];
+  }
   /**
    * Assign a parameter definition
    */
@@ -260,6 +316,8 @@ var Params = class {
       type = type.default(defValObj.value);
     } else if (str.match(/required/)) {
       type = type.required();
+    } else {
+      type = type.optional();
     }
     return type;
   }
@@ -267,7 +325,12 @@ var Params = class {
    * Validate a value against a definition
    */
   validate(key, val, def) {
-    const { value, error } = def.type.validate(val, { context: { params: this.params } });
+    const normalizedVal = val === null ? void 0 : val;
+    const { value, error } = def.type.validate(normalizedVal, {
+      context: { params: this.params },
+      abortEarly: false,
+      allowUnknown: false
+    });
     if (error) {
       const errs = error.details.map((el) => el.message).join(", ");
       throw new ParamError(`"${key}" validation error: ${errs}`);
@@ -285,11 +348,26 @@ var Params = class {
     }
     const valFromArgs = this.args.get(key);
     const valFromParams = this.params[key];
-    const res = valFromGetters ? this.validate(key, valFromGetters, def) : valFromArgs ? this.validate(key, valFromArgs, def) : this.validate(key, valFromParams, def);
-    if (res !== void 0 && def.values && !def.values.includes(res)) {
+    let source = "default";
+    let value;
+    if (valFromGetters !== void 0 && valFromGetters !== null) {
+      value = this.validate(key, valFromGetters, def);
+      source = "options";
+    } else if (valFromArgs !== void 0 && valFromArgs !== null) {
+      value = this.validate(key, valFromArgs, def);
+      source = "cli";
+    } else if (valFromParams !== void 0 && valFromParams !== null) {
+      value = this.validate(key, valFromParams, def);
+      source = "options";
+    } else {
+      value = this.validate(key, void 0, def);
+      source = "default";
+    }
+    this.trackParam(key, definition || "string", value, source);
+    if (value !== void 0 && def.values && !def.values.includes(value)) {
       throw new ParamError(`key ${key} should be one of ${def.values}`);
     }
-    return res;
+    return value;
   }
   /**
    * Set a parameter value with validation
@@ -323,10 +401,10 @@ var Params = class {
    * Run all registered getters for a key
    */
   runAllRegisteredGetters(key) {
-    let val = null;
+    let val = void 0;
     for (const getter of this.paramGetters) {
       val = getter(key, this.definitions[key]);
-      if (val !== void 0) {
+      if (val !== void 0 && val !== null) {
         break;
       }
     }
@@ -358,17 +436,9 @@ var Params = class {
     this.paramSetters.push(fn);
   }
 };
-var paramsInstance = null;
-var init = (fns, opts = {}) => {
-  paramsInstance = new Params(fns, opts);
-  return paramsInstance;
-};
-var getParamsInstance = () => paramsInstance;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Params,
-  getParamsInstance,
-  init,
   joiEdateType,
   joiStringArrayType
 });

package/dist/params.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/params.ts","../src/params/index.ts","../src/errors.ts","../src/params/custom-types.ts"],"sourcesContent":["// Re-export everything from the params module directory\nexport * from \"./params/index.js\";\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors\";\nimport { joiEdateType, joiStringArrayType } from \"./custom-types\";\n\n/**\n * Parameter definition types\n */\nexport type ParamDefinition = \n    | string \n    | Joi.Schema \n    | { \n        type?: string | Joi.Schema; \n        values?: any[]; \n        [key: string]: any; \n      };\n\nexport type ParamGetter = (key: string, definition?: any) => any;\nexport type ParamSetter = (key: string, value: any) => boolean;\n\n/**\n * Args instance interface\n */\nexport interface ArgsInstance {\n    get(key: string): any;\n}\n\n/**\n * Params constructor options\n */\nexport interface ParamsOptions {\n    [key: string]: any;\n}\n\n/**\n * Params class for parameter validation and type checking\n * Built on top of Args library with Joi validation\n */\nexport class Params {\n    private params: Record<string, any> = {};\n    private definitions: Record<string, any> = {};\n    private args: ArgsInstance;\n    private paramSetters: ParamSetter[] = [];\n    private paramGetters: ParamGetter[] = [];\n\n    constructor({ args }: { args: ArgsInstance }, opts: ParamsOptions = {}) {\n        this.args = args;\n\n        for (const [k, v] of Object.entries(opts)) {\n            // TODO: opt values might be an object with definitions in it, so perhaps `this.set` should be used\n            this.params[k] = v;\n        }\n    }\n\n    /**\n     * Assign a parameter definition\n     */\n    assignDefinition(key: string, definition?: ParamDefinition): any {\n        if (this.definitions[key] && !definition) {\n            return this.definitions[key];\n        }\n\n        let type: Joi.Schema;\n        if (!definition) {\n            type = Joi.string();\n        } else if (Joi.isSchema(definition)) {\n            type = definition;\n        } else if (Joi.isSchema(definition.type)) {\n            type = definition.type;\n        } else if (typeof definition === \"string\") {\n            type = this.toJoi(definition);\n        } else if (typeof definition.type === \"string\") {\n            type = this.toJoi(definition.type);\n        } else if (!definition.type) {\n            type = Joi.string();\n        } else {\n            type = Joi.string();\n        }\n\n        if (!this.definitions[key]) {\n            this.definitions[key] = {};\n        }\n        this.definitions[key].type = type;\n\n        if (definition && definition.values) {\n            if (Array.isArray(definition.values)) {\n                this.definitions[key].values = definition.values;\n            }\n        }\n        return this.definitions[key];\n    }\n\n    /**\n     * Convert string definition to Joi schema\n     */\n    toJoi(str: string): Joi.Schema {\n        let type: Joi.Schema;\n        \n        if (str.match(/^string|^text/i)) {\n            type = Joi.string();\n        } else if (str.match(/^number|^integer|^int/i)) {\n            type = Joi.number();\n        } else if (str.match(/^boolean|^bool/i)) {\n            type = Joi.boolean();\n        } else if (str.match(/^date/i)) {\n            type = Joi.custom(joiEdateType);\n        } else if (str.match(/^duration/i)) {\n            type = Joi.string().isoDuration();\n        } else if (str.match(/^array/i)) {\n            let elementTypes = \"string\";\n            const tmp = str.match(/\\((.*)\\)/);\n            if (tmp && tmp[1].match(/string/i)) {\n                elementTypes = \"string\";\n            } else if (tmp && tmp[1].match(/number|integer|int/i)) {\n                elementTypes = \"number\";\n            } else if (tmp && tmp[1].match(/boolean|bool/i)) {\n                elementTypes = \"boolean\";\n            }\n            type = Joi.custom(joiStringArrayType(elementTypes));\n        } else {\n            type = Joi.string();\n        }\n\n        // Handle default values\n        const regexForDefault = /\\bdefault\\s+([^\\s]+)/;\n        const matchForDefault = str.match(regexForDefault);\n        if (matchForDefault) {\n            const defValObj = type.validate(matchForDefault[1]);\n            if (defValObj.error) {\n                throw new ParamError(`default value \"${defValObj.value}\" type mismatch`);\n            }\n            type = type.default(defValObj.value);\n        } else if (str.match(/required/)) {\n            type = type.required();\n        }\n\n        return type;\n    }\n\n    /**\n     * Validate a value against a definition\n     */\n    validate(key: string, val: any, def: any): any {\n        // Pass current params as context to support cross-parameter references (e.g., @startTime+2h)\n        const { value, error } = def.type.validate(val, { context: { params: this.params } });\n        if (error) {\n            const errs = error.details.map((el: any) => el.message).join(\", \");\n            throw new ParamError(`\"${key}\" validation error: ${errs}`);\n        }\n        return value;\n    }\n\n    /**\n     * Get a parameter value with validation\n     */\n    get(key: string, definition?: ParamDefinition): any {\n        const def = this.assignDefinition(key, definition);\n        let valFromGetters: any = undefined;\n        \n        if (def.volatile || true) {\n            valFromGetters = this.runAllRegisteredGetters(key);\n        }\n        \n        const valFromArgs = this.args.get(key);\n        const valFromParams = this.params[key];\n\n        const res = valFromGetters ? this.validate(key, valFromGetters, def) :\n            valFromArgs ? this.validate(key, valFromArgs, def) :\n                this.validate(key, valFromParams, def);\n\n        if (res !== undefined && def.values && !def.values.includes(res)) {\n            throw new ParamError(`key ${key} should be one of ${def.values}`);\n        }\n        return res;\n    }\n\n    /**\n     * Set a parameter value with validation\n     */\n    set(key: string, val: any, definition?: ParamDefinition): void {\n        // TODO: check if there's a test for this:\n        if (val && val.type && val.value) {\n            definition = val;\n            val = val.value;\n        }\n        const def = this.assignDefinition(key, definition);\n\n        if (!this.runAllRegisteredSetters(key, val)) {\n            this.params[key] = val;\n        }\n    }\n\n    /**\n     * Get all parameters from definitions\n     * Processes parameters left-to-right to support cross-parameter references\n     */\n    getAll(defs: Record<string, ParamDefinition>): Record<string, any> {\n        const res: Record<string, any> = {};\n        for (const [k, def] of Object.entries(defs)) {\n            const value = this.get(k, def);\n            res[k] = value;\n            // Store validated value in params so subsequent params can reference it\n            if (value !== undefined) {\n                this.params[k] = value;\n            }\n        }\n        return res;\n    }\n\n    /**\n     * Run all registered getters for a key\n     */\n    runAllRegisteredGetters(key: string): any {\n        let val: any = null;\n        for (const getter of this.paramGetters) {\n            val = getter(key, this.definitions[key]);\n            if (val !== undefined) {\n                break;\n            }\n        }\n        return val;\n    }\n\n    /**\n     * Run all registered setters for a key\n     */\n    runAllRegisteredSetters(key: string, value: any): boolean {\n        let setterUsed: boolean = false;\n        for (const setter of this.paramSetters) {\n            setterUsed = setter(key, value);\n            if (setterUsed) {\n                break;\n            }\n        }\n        return setterUsed;\n    }\n\n    /**\n     * Register a parameter getter\n     */\n    registerParamGetter(fn: ParamGetter): void {\n        this.paramGetters.push(fn);\n    }\n\n    /**\n     * Register a parameter setter\n     */\n    registerParamSetter(fn: ParamSetter): void {\n        this.paramSetters.push(fn);\n    }\n}\n\n// Singleton instance\nlet paramsInstance: Params | null = null;\n\n/**\n * Initialize the singleton Params instance\n */\nexport const init = (fns: { args: ArgsInstance }, opts: ParamsOptions = {}): Params => {\n    paramsInstance = new Params(fns, opts);\n    return paramsInstance;\n};\n\n/**\n * Get the current singleton Params instance\n */\nexport const getParamsInstance = (): Params | null => paramsInstance;\n\n// Export custom types for external use\nexport { joiEdateType, joiStringArrayType };\n\n\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors.js\";\n\n/**\n * Custom Joi type for enhanced date parsing with relative time support\n * Supports:\n * - ISO8601 strings: \"2025-01-01T01:01:01Z\"\n * - Relative time: \"-2h\", \"+1d\", \"now\"\n * - Cross-parameter references: \"@startTime+2h\", \"@endDate-30m\"\n * \n * Internal representation: UTC ISO8601 string (YYYY-MM-DDTHH:mm:ssZ)\n * \n * @param value - Date value to parse\n * @param helpers - Joi helpers (includes context with other params)\n * @returns ISO8601 string in UTC timezone\n */\nexport const joiEdateType = (value: any, helpers: Joi.CustomHelpers): string => {\n    // If value is already a string in ISO format, validate and return\n    if (typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$/.test(value)) {\n        const testDate = new Date(value);\n        if (!isNaN(testDate.getTime())) {\n            return value;\n        }\n    }\n\n    // If value is a Date object, convert to ISO string\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    // If value is not a string, try to convert it\n    if (typeof value !== \"string\") {\n        value = String(value);\n    }\n\n    // Handle special keyword \"now\"\n    if (value.toLowerCase() === \"now\") {\n        return new Date().toISOString();\n    }\n\n    // Check for cross-parameter reference with relative time: @paramName+2h, @paramName-30m\n    const referenceRegex = /^@(\\w+)([+-]\\d+[smhdwy])$/i;\n    const referenceMatch = value.match(referenceRegex);\n    \n    if (referenceMatch) {\n        const [, paramName, relativeExpr] = referenceMatch;\n        \n        // Get the referenced parameter from context (if available via helpers.state.ancestors)\n        // For now, we'll use helpers.prefs.context which Joi provides\n        const context = (helpers as any).prefs?.context;\n        \n        if (!context || !context.params) {\n            throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);\n        }\n\n        const referencedValue = context.params[paramName];\n        \n        if (referencedValue === undefined || referencedValue === null) {\n            throw new ParamError(`Cannot resolve @${paramName}: parameter \"${paramName}\" is not defined or has no value. Parameters are evaluated left-to-right.`);\n        }\n\n        // Referenced value should be an ISO string or Date\n        let referenceDate: Date;\n        if (referencedValue instanceof Date) {\n            referenceDate = referencedValue;\n        } else if (typeof referencedValue === \"string\") {\n            referenceDate = new Date(referencedValue);\n            if (isNaN(referenceDate.getTime())) {\n                throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);\n            }\n        } else {\n            throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);\n        }\n\n        // Parse the relative expression and apply to reference date\n        const relativeMatch = relativeExpr.match(/^([+-])(\\d+)([smhdwy])$/i);\n        if (!relativeMatch) {\n            throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);\n        }\n\n        const [, sign, amount, unit] = relativeMatch;\n        const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);\n        const resultDate = new Date(referenceDate.getTime() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Check for relative time expressions like \"-2h\", \"+1d\", \"-30m\", etc.\n    const relativeTimeRegex = /^([+-])(\\d+)([smhdwy])$/i;\n    const relativeMatch = value.match(relativeTimeRegex);\n    \n    if (relativeMatch) {\n        const [, sign, amount, unit] = relativeMatch;\n        const numAmount = parseInt(amount, 10);\n        \n        if (isNaN(numAmount)) {\n            throw new ParamError(`Invalid relative time amount: ${amount}`);\n        }\n\n        const offset = calculateTimeOffset(numAmount, unit, sign);\n        const resultDate = new Date(Date.now() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Try to parse as a regular date string\n    const parsedDate = new Date(value);\n    \n    // Check if the parsed date is valid\n    if (isNaN(parsedDate.getTime())) {\n        throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, \"now\", relative time expression (e.g., \"-2h\", \"+1d\"), or cross-parameter reference (e.g., \"@startTime+2h\")`);\n    }\n\n    return parsedDate.toISOString();\n};\n\n/**\n * Calculate time offset in milliseconds\n */\nfunction calculateTimeOffset(amount: number, unit: string, sign: string): number {\n    let multiplier = 1;\n    \n    // Convert to milliseconds based on unit\n    switch (unit.toLowerCase()) {\n        case \"s\": // seconds\n            multiplier = 1000;\n            break;\n        case \"m\": // minutes\n            multiplier = 60 * 1000;\n            break;\n        case \"h\": // hours\n            multiplier = 60 * 60 * 1000;\n            break;\n        case \"d\": // days\n            multiplier = 24 * 60 * 60 * 1000;\n            break;\n        case \"w\": // weeks\n            multiplier = 7 * 24 * 60 * 60 * 1000;\n            break;\n        case \"y\": // years (approximate)\n            multiplier = 365 * 24 * 60 * 60 * 1000;\n            break;\n        default:\n            throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);\n    }\n\n    return sign === \"+\" ? amount * multiplier : -amount * multiplier;\n}\n\n/**\n * Custom Joi type for string array parsing\n * Converts comma-separated strings to typed arrays\n */\nexport const joiStringArrayType = (type: string) => (value: any, helpers: Joi.CustomHelpers): any[] => {\n    if (value === undefined || typeof value === \"function\") {\n        return [];\n    }\n    \n    const arr = value.split(/,\\s*/).map((el: string) => {\n        if (type === \"number\") {\n            const v = parseInt(el, 10);\n            if (isNaN(v)) {\n                throw new ParamError(`array element \"${el}\" should be numeric`);\n            }\n            return v;\n        } else if (type === \"boolean\") {\n            const v = el.match(/true|t|yes|1/i) ? true :\n                el.match(/false|f|no|0/i) ? false : null;\n            if (v === null) {\n                throw new ParamError(`array element \"${el}\" should be boolean`);\n            }\n            return v;\n        } else if (type === \"string\") {\n            return el;\n        } else {\n            throw new ParamError(`unknown type \"${type}\" for array elements`);\n        }\n    });\n    \n    return arr;\n};\n\n"],"mappings":"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","names":["relativeMatch","Joi"]}
+{"version":3,"sources":["../src/params.ts","../src/params/index.ts","../src/errors.ts","../src/params/custom-types.ts"],"sourcesContent":["// Re-export everything from the params module directory\nexport * from \"./params/index.js\";\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors\";\nimport { joiEdateType, joiStringArrayType } from \"./custom-types\";\n\n/**\n * Parameter definition types\n */\nexport type ParamDefinition = \n    | string \n    | Joi.Schema \n    | { \n        type?: string | Joi.Schema; \n        values?: any[]; \n        [key: string]: any; \n      };\n\nexport type ParamGetter = (key: string, definition?: any) => any;\nexport type ParamSetter = (key: string, value: any) => boolean;\n\n/**\n * Args instance interface\n */\nexport interface ArgsInstance {\n    get(key: string): any;\n}\n\n/**\n * Params constructor options\n */\nexport interface ParamsOptions {\n    [key: string]: any;\n}\n\n/**\n * Tracked parameter information for --stopAfter=init\n */\ninterface TrackedParam {\n    key: string;\n    definition: ParamDefinition;\n    value: any;\n    source: \"cli\" | \"options\" | \"default\";\n}\n\n/**\n * Params class for parameter validation and type checking\n * Built on top of Args library with Joi validation\n */\nexport class Params {\n    private context: any; // Partial context during initialization\n    private params: Record<string, any> = {};\n    private definitions: Record<string, any> = {};\n    private args: ArgsInstance;\n    private paramSetters: ParamSetter[] = [];\n    private paramGetters: ParamGetter[] = [];\n    private trackedParams: TrackedParam[] = [];\n\n    constructor(context: any, options: ParamsOptions = {}) {\n        // Context might be partial during initialization\n        this.context = context;\n        this.args = context.args;\n\n        // Apply initial configuration\n        if (Object.keys(options).length > 0) {\n            this.configure(options);\n        }\n    }\n\n    /**\n     * Configure parameters\n     * Only parameters present in options are updated\n     */\n    configure(options: ParamsOptions): void {\n        for (const [k, v] of Object.entries(options)) {\n            // TODO: opt values might be an object with definitions in it, so perhaps `this.set` should be used\n            this.params[k] = v;\n        }\n    }\n\n    /**\n     * Initialize Params from context and CLI parameters\n     * Note: Params is special - it's initialized early with partial context\n     */\n    static init(context: any, options?: ParamsOptions): Params {\n        return new Params(context, options || {});\n    }\n\n    /**\n     * Track a parameter request for --stopAfter=init feature\n     */\n    private trackParam(key: string, definition: ParamDefinition, value: any, source: \"cli\" | \"options\" | \"default\"): void {\n        this.trackedParams.push({\n            key,\n            definition,\n            value,\n            source\n        });\n    }\n\n    /**\n     * Get all tracked parameters (for --stopAfter=init)\n     */\n    getTrackedParams(): TrackedParam[] {\n        return [...this.trackedParams];\n    }\n\n    /**\n     * Get all figured parameters as a record\n     * Returns all parameters that were collected during initialization,\n     * whether from CLI args, options, or defaults\n     */\n    getAllFigured(): Record<string, { value: any; source: \"cli\" | \"options\" | \"default\" }> {\n        const result: Record<string, { value: any; source: \"cli\" | \"options\" | \"default\" }> = {};\n        for (const param of this.trackedParams) {\n            result[param.key] = {\n                value: param.value,\n                source: param.source,\n            };\n        }\n        return result;\n    }\n\n    /**\n     * Clear tracked parameters\n     */\n    clearTrackedParams(): void {\n        this.trackedParams = [];\n    }\n\n    /**\n     * Assign a parameter definition\n     */\n    assignDefinition(key: string, definition?: ParamDefinition): any {\n        if (this.definitions[key] && !definition) {\n            return this.definitions[key];\n        }\n\n        let type: Joi.Schema;\n        if (!definition) {\n            type = Joi.string();\n        } else if (Joi.isSchema(definition)) {\n            type = definition;\n        } else if (Joi.isSchema(definition.type)) {\n            type = definition.type;\n        } else if (typeof definition === \"string\") {\n            type = this.toJoi(definition);\n        } else if (typeof definition.type === \"string\") {\n            type = this.toJoi(definition.type);\n        } else if (!definition.type) {\n            type = Joi.string();\n        } else {\n            type = Joi.string();\n        }\n\n        if (!this.definitions[key]) {\n            this.definitions[key] = {};\n        }\n        this.definitions[key].type = type;\n\n        if (definition && definition.values) {\n            if (Array.isArray(definition.values)) {\n                this.definitions[key].values = definition.values;\n            }\n        }\n        return this.definitions[key];\n    }\n\n    /**\n     * Convert string definition to Joi schema\n     */\n    toJoi(str: string): Joi.Schema {\n        let type: Joi.Schema;\n        \n        if (str.match(/^string|^text/i)) {\n            type = Joi.string();\n        } else if (str.match(/^number|^integer|^int/i)) {\n            type = Joi.number();\n        } else if (str.match(/^boolean|^bool/i)) {\n            type = Joi.boolean();\n        } else if (str.match(/^date/i)) {\n            type = Joi.custom(joiEdateType);\n        } else if (str.match(/^duration/i)) {\n            type = Joi.string().isoDuration();\n        } else if (str.match(/^array/i)) {\n            let elementTypes = \"string\";\n            const tmp = str.match(/\\((.*)\\)/);\n            if (tmp && tmp[1].match(/string/i)) {\n                elementTypes = \"string\";\n            } else if (tmp && tmp[1].match(/number|integer|int/i)) {\n                elementTypes = \"number\";\n            } else if (tmp && tmp[1].match(/boolean|bool/i)) {\n                elementTypes = \"boolean\";\n            }\n            type = Joi.custom(joiStringArrayType(elementTypes));\n        } else {\n            type = Joi.string();\n        }\n\n        // Handle default values\n        const regexForDefault = /\\bdefault\\s+([^\\s]+)/;\n        const matchForDefault = str.match(regexForDefault);\n        if (matchForDefault) {\n            const defValObj = type.validate(matchForDefault[1]);\n            if (defValObj.error) {\n                throw new ParamError(`default value \"${defValObj.value}\" type mismatch`);\n            }\n            // Joi's default() automatically allows undefined and applies the default\n            type = type.default(defValObj.value);\n        } else if (str.match(/required/)) {\n            type = type.required();\n        } else {\n            // If not required and no default, make it optional\n            type = type.optional();\n        }\n\n        return type;\n    }\n\n    /**\n     * Validate a value against a definition\n     */\n    validate(key: string, val: any, def: any): any {\n        // Convert null to undefined so Joi defaults can be applied\n        // Joi's .default() only works with undefined, not null\n        const normalizedVal = val === null ? undefined : val;\n        \n        // Pass current params as context to support cross-parameter references (e.g., @startTime+2h)\n        // Use abortEarly: false to get all errors, and allowUnknown: false for strict validation\n        const { value, error } = def.type.validate(normalizedVal, { \n            context: { params: this.params },\n            abortEarly: false,\n            allowUnknown: false,\n        });\n        if (error) {\n            const errs = error.details.map((el: any) => el.message).join(\", \");\n            throw new ParamError(`\"${key}\" validation error: ${errs}`);\n        }\n        return value;\n    }\n\n    /**\n     * Get a parameter value with validation\n     */\n    get(key: string, definition?: ParamDefinition): any {\n        const def = this.assignDefinition(key, definition);\n        let valFromGetters: any = undefined;\n        \n        if (def.volatile || true) {\n            valFromGetters = this.runAllRegisteredGetters(key);\n        }\n        \n        const valFromArgs = this.args.get(key);\n        const valFromParams = this.params[key];\n\n        let source: \"cli\" | \"options\" | \"default\" = \"default\";\n        let value: any;\n\n        if (valFromGetters !== undefined && valFromGetters !== null) {\n            value = this.validate(key, valFromGetters, def);\n            source = \"options\";\n        } else if (valFromArgs !== undefined && valFromArgs !== null) {\n            value = this.validate(key, valFromArgs, def);\n            source = \"cli\";\n        } else if (valFromParams !== undefined && valFromParams !== null) {\n            value = this.validate(key, valFromParams, def);\n            source = \"options\";\n        } else {\n            // Use default from definition - Joi will apply default when value is undefined\n            // We need to pass undefined explicitly so Joi can apply the default\n            value = this.validate(key, undefined, def);\n            source = \"default\";\n        }\n\n        // Track parameter for --stopAfter=init\n        this.trackParam(key, definition || \"string\", value, source);\n\n        if (value !== undefined && def.values && !def.values.includes(value)) {\n            throw new ParamError(`key ${key} should be one of ${def.values}`);\n        }\n        return value;\n    }\n\n    /**\n     * Set a parameter value with validation\n     */\n    set(key: string, val: any, definition?: ParamDefinition): void {\n        // TODO: check if there's a test for this:\n        if (val && val.type && val.value) {\n            definition = val;\n            val = val.value;\n        }\n        const def = this.assignDefinition(key, definition);\n\n        if (!this.runAllRegisteredSetters(key, val)) {\n            this.params[key] = val;\n        }\n    }\n\n    /**\n     * Get all parameters from definitions\n     * Processes parameters left-to-right to support cross-parameter references\n     */\n    getAll(defs: Record<string, ParamDefinition>): Record<string, any> {\n        const res: Record<string, any> = {};\n        for (const [k, def] of Object.entries(defs)) {\n            const value = this.get(k, def);\n            res[k] = value;\n            // Store validated value in params so subsequent params can reference it\n            if (value !== undefined) {\n                this.params[k] = value;\n            }\n        }\n        return res;\n    }\n\n    /**\n     * Run all registered getters for a key\n     */\n    runAllRegisteredGetters(key: string): any {\n        let val: any = undefined;\n        for (const getter of this.paramGetters) {\n            val = getter(key, this.definitions[key]);\n            if (val !== undefined && val !== null) {\n                break;\n            }\n        }\n        return val;\n    }\n\n    /**\n     * Run all registered setters for a key\n     */\n    runAllRegisteredSetters(key: string, value: any): boolean {\n        let setterUsed: boolean = false;\n        for (const setter of this.paramSetters) {\n            setterUsed = setter(key, value);\n            if (setterUsed) {\n                break;\n            }\n        }\n        return setterUsed;\n    }\n\n    /**\n     * Register a parameter getter\n     */\n    registerParamGetter(fn: ParamGetter): void {\n        this.paramGetters.push(fn);\n    }\n\n    /**\n     * Register a parameter setter\n     */\n    registerParamSetter(fn: ParamSetter): void {\n        this.paramSetters.push(fn);\n    }\n}\n\n// Export custom types for external use\nexport { joiEdateType, joiStringArrayType };\n\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors.js\";\n\n/**\n * Custom Joi type for enhanced date parsing with relative time support\n * Supports:\n * - ISO8601 strings: \"2025-01-01T01:01:01Z\"\n * - Relative time: \"-2h\", \"+1d\", \"now\"\n * - Cross-parameter references: \"@startTime+2h\", \"@endDate-30m\"\n * \n * Internal representation: UTC ISO8601 string (YYYY-MM-DDTHH:mm:ssZ)\n * \n * @param value - Date value to parse\n * @param helpers - Joi helpers (includes context with other params)\n * @returns ISO8601 string in UTC timezone\n */\nexport const joiEdateType = (value: any, helpers: Joi.CustomHelpers): string => {\n    // If value is already a string in ISO format, validate and return\n    if (typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$/.test(value)) {\n        const testDate = new Date(value);\n        if (!isNaN(testDate.getTime())) {\n            return value;\n        }\n    }\n\n    // If value is a Date object, convert to ISO string\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    // If value is not a string, try to convert it\n    if (typeof value !== \"string\") {\n        value = String(value);\n    }\n\n    // Handle special keyword \"now\"\n    if (value.toLowerCase() === \"now\") {\n        return new Date().toISOString();\n    }\n\n    // Check for cross-parameter reference with relative time: @paramName+2h, @paramName-30m\n    const referenceRegex = /^@(\\w+)([+-]\\d+[smhdwy])$/i;\n    const referenceMatch = value.match(referenceRegex);\n    \n    if (referenceMatch) {\n        const [, paramName, relativeExpr] = referenceMatch;\n        \n        // Get the referenced parameter from context (if available via helpers.state.ancestors)\n        // For now, we'll use helpers.prefs.context which Joi provides\n        const context = (helpers as any).prefs?.context;\n        \n        if (!context || !context.params) {\n            throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);\n        }\n\n        const referencedValue = context.params[paramName];\n        \n        if (referencedValue === undefined || referencedValue === null) {\n            throw new ParamError(`Cannot resolve @${paramName}: parameter \"${paramName}\" is not defined or has no value. Parameters are evaluated left-to-right.`);\n        }\n\n        // Referenced value should be an ISO string or Date\n        let referenceDate: Date;\n        if (referencedValue instanceof Date) {\n            referenceDate = referencedValue;\n        } else if (typeof referencedValue === \"string\") {\n            referenceDate = new Date(referencedValue);\n            if (isNaN(referenceDate.getTime())) {\n                throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);\n            }\n        } else {\n            throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);\n        }\n\n        // Parse the relative expression and apply to reference date\n        const relativeMatch = relativeExpr.match(/^([+-])(\\d+)([smhdwy])$/i);\n        if (!relativeMatch) {\n            throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);\n        }\n\n        const [, sign, amount, unit] = relativeMatch;\n        const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);\n        const resultDate = new Date(referenceDate.getTime() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Check for relative time expressions like \"-2h\", \"+1d\", \"-30m\", etc.\n    const relativeTimeRegex = /^([+-])(\\d+)([smhdwy])$/i;\n    const relativeMatch = value.match(relativeTimeRegex);\n    \n    if (relativeMatch) {\n        const [, sign, amount, unit] = relativeMatch;\n        const numAmount = parseInt(amount, 10);\n        \n        if (isNaN(numAmount)) {\n            throw new ParamError(`Invalid relative time amount: ${amount}`);\n        }\n\n        const offset = calculateTimeOffset(numAmount, unit, sign);\n        const resultDate = new Date(Date.now() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Try to parse as a regular date string\n    const parsedDate = new Date(value);\n    \n    // Check if the parsed date is valid\n    if (isNaN(parsedDate.getTime())) {\n        throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, \"now\", relative time expression (e.g., \"-2h\", \"+1d\"), or cross-parameter reference (e.g., \"@startTime+2h\")`);\n    }\n\n    return parsedDate.toISOString();\n};\n\n/**\n * Calculate time offset in milliseconds\n */\nfunction calculateTimeOffset(amount: number, unit: string, sign: string): number {\n    let multiplier = 1;\n    \n    // Convert to milliseconds based on unit\n    switch (unit.toLowerCase()) {\n        case \"s\": // seconds\n            multiplier = 1000;\n            break;\n        case \"m\": // minutes\n            multiplier = 60 * 1000;\n            break;\n        case \"h\": // hours\n            multiplier = 60 * 60 * 1000;\n            break;\n        case \"d\": // days\n            multiplier = 24 * 60 * 60 * 1000;\n            break;\n        case \"w\": // weeks\n            multiplier = 7 * 24 * 60 * 60 * 1000;\n            break;\n        case \"y\": // years (approximate)\n            multiplier = 365 * 24 * 60 * 60 * 1000;\n            break;\n        default:\n            throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);\n    }\n\n    return sign === \"+\" ? amount * multiplier : -amount * multiplier;\n}\n\n/**\n * Custom Joi type for string array parsing\n * Converts comma-separated strings to typed arrays\n */\nexport const joiStringArrayType = (type: string) => (value: any, helpers: Joi.CustomHelpers): any[] => {\n    if (value === undefined || typeof value === \"function\") {\n        return [];\n    }\n    \n    const arr = value.split(/,\\s*/).map((el: string) => {\n        if (type === \"number\") {\n            const v = parseInt(el, 10);\n            if (isNaN(v)) {\n                throw new ParamError(`array element \"${el}\" should be numeric`);\n            }\n            return v;\n        } else if (type === \"boolean\") {\n            const v = el.match(/true|t|yes|1/i) ? true :\n                el.match(/false|f|no|0/i) ? false : null;\n            if (v === null) {\n                throw new ParamError(`array element \"${el}\" should be boolean`);\n            }\n            return v;\n        } else if (type === \"string\") {\n            return el;\n        } else {\n            throw new ParamError(`unknown type \"${type}\" for array elements`);\n        }\n    });\n    \n    return arr;\n};\n\n"],"mappings":"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","names":["relativeMatch","Joi"]}

package/dist/params.js

@@ -135,18 +135,76 @@ var joiStringArrayType = (type) => (value, helpers) => {
 };
 
 // src/params/index.ts
-var Params = class {
+var Params = class _Params {
+  context;
+  // Partial context during initialization
   params = {};
   definitions = {};
   args;
   paramSetters = [];
   paramGetters = [];
-  constructor({ args }, opts = {}) {
-    this.args = args;
-    for (const [k, v] of Object.entries(opts)) {
+  trackedParams = [];
+  constructor(context, options = {}) {
+    this.context = context;
+    this.args = context.args;
+    if (Object.keys(options).length > 0) {
+      this.configure(options);
+    }
+  }
+  /**
+   * Configure parameters
+   * Only parameters present in options are updated
+   */
+  configure(options) {
+    for (const [k, v] of Object.entries(options)) {
       this.params[k] = v;
     }
   }
+  /**
+   * Initialize Params from context and CLI parameters
+   * Note: Params is special - it's initialized early with partial context
+   */
+  static init(context, options) {
+    return new _Params(context, options || {});
+  }
+  /**
+   * Track a parameter request for --stopAfter=init feature
+   */
+  trackParam(key, definition, value, source) {
+    this.trackedParams.push({
+      key,
+      definition,
+      value,
+      source
+    });
+  }
+  /**
+   * Get all tracked parameters (for --stopAfter=init)
+   */
+  getTrackedParams() {
+    return [...this.trackedParams];
+  }
+  /**
+   * Get all figured parameters as a record
+   * Returns all parameters that were collected during initialization,
+   * whether from CLI args, options, or defaults
+   */
+  getAllFigured() {
+    const result = {};
+    for (const param of this.trackedParams) {
+      result[param.key] = {
+        value: param.value,
+        source: param.source
+      };
+    }
+    return result;
+  }
+  /**
+   * Clear tracked parameters
+   */
+  clearTrackedParams() {
+    this.trackedParams = [];
+  }
   /**
    * Assign a parameter definition
    */
@@ -220,6 +278,8 @@ var Params = class {
       type = type.default(defValObj.value);
     } else if (str.match(/required/)) {
       type = type.required();
+    } else {
+      type = type.optional();
     }
     return type;
   }
@@ -227,7 +287,12 @@ var Params = class {
    * Validate a value against a definition
    */
   validate(key, val, def) {
-    const { value, error } = def.type.validate(val, { context: { params: this.params } });
+    const normalizedVal = val === null ? void 0 : val;
+    const { value, error } = def.type.validate(normalizedVal, {
+      context: { params: this.params },
+      abortEarly: false,
+      allowUnknown: false
+    });
     if (error) {
       const errs = error.details.map((el) => el.message).join(", ");
       throw new ParamError(`"${key}" validation error: ${errs}`);
@@ -245,11 +310,26 @@ var Params = class {
     }
     const valFromArgs = this.args.get(key);
     const valFromParams = this.params[key];
-    const res = valFromGetters ? this.validate(key, valFromGetters, def) : valFromArgs ? this.validate(key, valFromArgs, def) : this.validate(key, valFromParams, def);
-    if (res !== void 0 && def.values && !def.values.includes(res)) {
+    let source = "default";
+    let value;
+    if (valFromGetters !== void 0 && valFromGetters !== null) {
+      value = this.validate(key, valFromGetters, def);
+      source = "options";
+    } else if (valFromArgs !== void 0 && valFromArgs !== null) {
+      value = this.validate(key, valFromArgs, def);
+      source = "cli";
+    } else if (valFromParams !== void 0 && valFromParams !== null) {
+      value = this.validate(key, valFromParams, def);
+      source = "options";
+    } else {
+      value = this.validate(key, void 0, def);
+      source = "default";
+    }
+    this.trackParam(key, definition || "string", value, source);
+    if (value !== void 0 && def.values && !def.values.includes(value)) {
       throw new ParamError(`key ${key} should be one of ${def.values}`);
     }
-    return res;
+    return value;
   }
   /**
    * Set a parameter value with validation
@@ -283,10 +363,10 @@ var Params = class {
    * Run all registered getters for a key
    */
   runAllRegisteredGetters(key) {
-    let val = null;
+    let val = void 0;
     for (const getter of this.paramGetters) {
       val = getter(key, this.definitions[key]);
-      if (val !== void 0) {
+      if (val !== void 0 && val !== null) {
         break;
       }
     }
@@ -318,16 +398,8 @@ var Params = class {
     this.paramSetters.push(fn);
   }
 };
-var paramsInstance = null;
-var init = (fns, opts = {}) => {
-  paramsInstance = new Params(fns, opts);
-  return paramsInstance;
-};
-var getParamsInstance = () => paramsInstance;
 export {
   Params,
-  getParamsInstance,
-  init,
   joiEdateType,
   joiStringArrayType
 };

package/dist/params.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/params/index.ts","../src/errors.ts","../src/params/custom-types.ts"],"sourcesContent":["import Joi from \"joi\";\nimport { ParamError } from \"../errors\";\nimport { joiEdateType, joiStringArrayType } from \"./custom-types\";\n\n/**\n * Parameter definition types\n */\nexport type ParamDefinition = \n    | string \n    | Joi.Schema \n    | { \n        type?: string | Joi.Schema; \n        values?: any[]; \n        [key: string]: any; \n      };\n\nexport type ParamGetter = (key: string, definition?: any) => any;\nexport type ParamSetter = (key: string, value: any) => boolean;\n\n/**\n * Args instance interface\n */\nexport interface ArgsInstance {\n    get(key: string): any;\n}\n\n/**\n * Params constructor options\n */\nexport interface ParamsOptions {\n    [key: string]: any;\n}\n\n/**\n * Params class for parameter validation and type checking\n * Built on top of Args library with Joi validation\n */\nexport class Params {\n    private params: Record<string, any> = {};\n    private definitions: Record<string, any> = {};\n    private args: ArgsInstance;\n    private paramSetters: ParamSetter[] = [];\n    private paramGetters: ParamGetter[] = [];\n\n    constructor({ args }: { args: ArgsInstance }, opts: ParamsOptions = {}) {\n        this.args = args;\n\n        for (const [k, v] of Object.entries(opts)) {\n            // TODO: opt values might be an object with definitions in it, so perhaps `this.set` should be used\n            this.params[k] = v;\n        }\n    }\n\n    /**\n     * Assign a parameter definition\n     */\n    assignDefinition(key: string, definition?: ParamDefinition): any {\n        if (this.definitions[key] && !definition) {\n            return this.definitions[key];\n        }\n\n        let type: Joi.Schema;\n        if (!definition) {\n            type = Joi.string();\n        } else if (Joi.isSchema(definition)) {\n            type = definition;\n        } else if (Joi.isSchema(definition.type)) {\n            type = definition.type;\n        } else if (typeof definition === \"string\") {\n            type = this.toJoi(definition);\n        } else if (typeof definition.type === \"string\") {\n            type = this.toJoi(definition.type);\n        } else if (!definition.type) {\n            type = Joi.string();\n        } else {\n            type = Joi.string();\n        }\n\n        if (!this.definitions[key]) {\n            this.definitions[key] = {};\n        }\n        this.definitions[key].type = type;\n\n        if (definition && definition.values) {\n            if (Array.isArray(definition.values)) {\n                this.definitions[key].values = definition.values;\n            }\n        }\n        return this.definitions[key];\n    }\n\n    /**\n     * Convert string definition to Joi schema\n     */\n    toJoi(str: string): Joi.Schema {\n        let type: Joi.Schema;\n        \n        if (str.match(/^string|^text/i)) {\n            type = Joi.string();\n        } else if (str.match(/^number|^integer|^int/i)) {\n            type = Joi.number();\n        } else if (str.match(/^boolean|^bool/i)) {\n            type = Joi.boolean();\n        } else if (str.match(/^date/i)) {\n            type = Joi.custom(joiEdateType);\n        } else if (str.match(/^duration/i)) {\n            type = Joi.string().isoDuration();\n        } else if (str.match(/^array/i)) {\n            let elementTypes = \"string\";\n            const tmp = str.match(/\\((.*)\\)/);\n            if (tmp && tmp[1].match(/string/i)) {\n                elementTypes = \"string\";\n            } else if (tmp && tmp[1].match(/number|integer|int/i)) {\n                elementTypes = \"number\";\n            } else if (tmp && tmp[1].match(/boolean|bool/i)) {\n                elementTypes = \"boolean\";\n            }\n            type = Joi.custom(joiStringArrayType(elementTypes));\n        } else {\n            type = Joi.string();\n        }\n\n        // Handle default values\n        const regexForDefault = /\\bdefault\\s+([^\\s]+)/;\n        const matchForDefault = str.match(regexForDefault);\n        if (matchForDefault) {\n            const defValObj = type.validate(matchForDefault[1]);\n            if (defValObj.error) {\n                throw new ParamError(`default value \"${defValObj.value}\" type mismatch`);\n            }\n            type = type.default(defValObj.value);\n        } else if (str.match(/required/)) {\n            type = type.required();\n        }\n\n        return type;\n    }\n\n    /**\n     * Validate a value against a definition\n     */\n    validate(key: string, val: any, def: any): any {\n        // Pass current params as context to support cross-parameter references (e.g., @startTime+2h)\n        const { value, error } = def.type.validate(val, { context: { params: this.params } });\n        if (error) {\n            const errs = error.details.map((el: any) => el.message).join(\", \");\n            throw new ParamError(`\"${key}\" validation error: ${errs}`);\n        }\n        return value;\n    }\n\n    /**\n     * Get a parameter value with validation\n     */\n    get(key: string, definition?: ParamDefinition): any {\n        const def = this.assignDefinition(key, definition);\n        let valFromGetters: any = undefined;\n        \n        if (def.volatile || true) {\n            valFromGetters = this.runAllRegisteredGetters(key);\n        }\n        \n        const valFromArgs = this.args.get(key);\n        const valFromParams = this.params[key];\n\n        const res = valFromGetters ? this.validate(key, valFromGetters, def) :\n            valFromArgs ? this.validate(key, valFromArgs, def) :\n                this.validate(key, valFromParams, def);\n\n        if (res !== undefined && def.values && !def.values.includes(res)) {\n            throw new ParamError(`key ${key} should be one of ${def.values}`);\n        }\n        return res;\n    }\n\n    /**\n     * Set a parameter value with validation\n     */\n    set(key: string, val: any, definition?: ParamDefinition): void {\n        // TODO: check if there's a test for this:\n        if (val && val.type && val.value) {\n            definition = val;\n            val = val.value;\n        }\n        const def = this.assignDefinition(key, definition);\n\n        if (!this.runAllRegisteredSetters(key, val)) {\n            this.params[key] = val;\n        }\n    }\n\n    /**\n     * Get all parameters from definitions\n     * Processes parameters left-to-right to support cross-parameter references\n     */\n    getAll(defs: Record<string, ParamDefinition>): Record<string, any> {\n        const res: Record<string, any> = {};\n        for (const [k, def] of Object.entries(defs)) {\n            const value = this.get(k, def);\n            res[k] = value;\n            // Store validated value in params so subsequent params can reference it\n            if (value !== undefined) {\n                this.params[k] = value;\n            }\n        }\n        return res;\n    }\n\n    /**\n     * Run all registered getters for a key\n     */\n    runAllRegisteredGetters(key: string): any {\n        let val: any = null;\n        for (const getter of this.paramGetters) {\n            val = getter(key, this.definitions[key]);\n            if (val !== undefined) {\n                break;\n            }\n        }\n        return val;\n    }\n\n    /**\n     * Run all registered setters for a key\n     */\n    runAllRegisteredSetters(key: string, value: any): boolean {\n        let setterUsed: boolean = false;\n        for (const setter of this.paramSetters) {\n            setterUsed = setter(key, value);\n            if (setterUsed) {\n                break;\n            }\n        }\n        return setterUsed;\n    }\n\n    /**\n     * Register a parameter getter\n     */\n    registerParamGetter(fn: ParamGetter): void {\n        this.paramGetters.push(fn);\n    }\n\n    /**\n     * Register a parameter setter\n     */\n    registerParamSetter(fn: ParamSetter): void {\n        this.paramSetters.push(fn);\n    }\n}\n\n// Singleton instance\nlet paramsInstance: Params | null = null;\n\n/**\n * Initialize the singleton Params instance\n */\nexport const init = (fns: { args: ArgsInstance }, opts: ParamsOptions = {}): Params => {\n    paramsInstance = new Params(fns, opts);\n    return paramsInstance;\n};\n\n/**\n * Get the current singleton Params instance\n */\nexport const getParamsInstance = (): Params | null => paramsInstance;\n\n// Export custom types for external use\nexport { joiEdateType, joiStringArrayType };\n\n\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors.js\";\n\n/**\n * Custom Joi type for enhanced date parsing with relative time support\n * Supports:\n * - ISO8601 strings: \"2025-01-01T01:01:01Z\"\n * - Relative time: \"-2h\", \"+1d\", \"now\"\n * - Cross-parameter references: \"@startTime+2h\", \"@endDate-30m\"\n * \n * Internal representation: UTC ISO8601 string (YYYY-MM-DDTHH:mm:ssZ)\n * \n * @param value - Date value to parse\n * @param helpers - Joi helpers (includes context with other params)\n * @returns ISO8601 string in UTC timezone\n */\nexport const joiEdateType = (value: any, helpers: Joi.CustomHelpers): string => {\n    // If value is already a string in ISO format, validate and return\n    if (typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$/.test(value)) {\n        const testDate = new Date(value);\n        if (!isNaN(testDate.getTime())) {\n            return value;\n        }\n    }\n\n    // If value is a Date object, convert to ISO string\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    // If value is not a string, try to convert it\n    if (typeof value !== \"string\") {\n        value = String(value);\n    }\n\n    // Handle special keyword \"now\"\n    if (value.toLowerCase() === \"now\") {\n        return new Date().toISOString();\n    }\n\n    // Check for cross-parameter reference with relative time: @paramName+2h, @paramName-30m\n    const referenceRegex = /^@(\\w+)([+-]\\d+[smhdwy])$/i;\n    const referenceMatch = value.match(referenceRegex);\n    \n    if (referenceMatch) {\n        const [, paramName, relativeExpr] = referenceMatch;\n        \n        // Get the referenced parameter from context (if available via helpers.state.ancestors)\n        // For now, we'll use helpers.prefs.context which Joi provides\n        const context = (helpers as any).prefs?.context;\n        \n        if (!context || !context.params) {\n            throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);\n        }\n\n        const referencedValue = context.params[paramName];\n        \n        if (referencedValue === undefined || referencedValue === null) {\n            throw new ParamError(`Cannot resolve @${paramName}: parameter \"${paramName}\" is not defined or has no value. Parameters are evaluated left-to-right.`);\n        }\n\n        // Referenced value should be an ISO string or Date\n        let referenceDate: Date;\n        if (referencedValue instanceof Date) {\n            referenceDate = referencedValue;\n        } else if (typeof referencedValue === \"string\") {\n            referenceDate = new Date(referencedValue);\n            if (isNaN(referenceDate.getTime())) {\n                throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);\n            }\n        } else {\n            throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);\n        }\n\n        // Parse the relative expression and apply to reference date\n        const relativeMatch = relativeExpr.match(/^([+-])(\\d+)([smhdwy])$/i);\n        if (!relativeMatch) {\n            throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);\n        }\n\n        const [, sign, amount, unit] = relativeMatch;\n        const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);\n        const resultDate = new Date(referenceDate.getTime() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Check for relative time expressions like \"-2h\", \"+1d\", \"-30m\", etc.\n    const relativeTimeRegex = /^([+-])(\\d+)([smhdwy])$/i;\n    const relativeMatch = value.match(relativeTimeRegex);\n    \n    if (relativeMatch) {\n        const [, sign, amount, unit] = relativeMatch;\n        const numAmount = parseInt(amount, 10);\n        \n        if (isNaN(numAmount)) {\n            throw new ParamError(`Invalid relative time amount: ${amount}`);\n        }\n\n        const offset = calculateTimeOffset(numAmount, unit, sign);\n        const resultDate = new Date(Date.now() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Try to parse as a regular date string\n    const parsedDate = new Date(value);\n    \n    // Check if the parsed date is valid\n    if (isNaN(parsedDate.getTime())) {\n        throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, \"now\", relative time expression (e.g., \"-2h\", \"+1d\"), or cross-parameter reference (e.g., \"@startTime+2h\")`);\n    }\n\n    return parsedDate.toISOString();\n};\n\n/**\n * Calculate time offset in milliseconds\n */\nfunction calculateTimeOffset(amount: number, unit: string, sign: string): number {\n    let multiplier = 1;\n    \n    // Convert to milliseconds based on unit\n    switch (unit.toLowerCase()) {\n        case \"s\": // seconds\n            multiplier = 1000;\n            break;\n        case \"m\": // minutes\n            multiplier = 60 * 1000;\n            break;\n        case \"h\": // hours\n            multiplier = 60 * 60 * 1000;\n            break;\n        case \"d\": // days\n            multiplier = 24 * 60 * 60 * 1000;\n            break;\n        case \"w\": // weeks\n            multiplier = 7 * 24 * 60 * 60 * 1000;\n            break;\n        case \"y\": // years (approximate)\n            multiplier = 365 * 24 * 60 * 60 * 1000;\n            break;\n        default:\n            throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);\n    }\n\n    return sign === \"+\" ? amount * multiplier : -amount * multiplier;\n}\n\n/**\n * Custom Joi type for string array parsing\n * Converts comma-separated strings to typed arrays\n */\nexport const joiStringArrayType = (type: string) => (value: any, helpers: Joi.CustomHelpers): any[] => {\n    if (value === undefined || typeof value === \"function\") {\n        return [];\n    }\n    \n    const arr = value.split(/,\\s*/).map((el: string) => {\n        if (type === \"number\") {\n            const v = parseInt(el, 10);\n            if (isNaN(v)) {\n                throw new ParamError(`array element \"${el}\" should be numeric`);\n            }\n            return v;\n        } else if (type === \"boolean\") {\n            const v = el.match(/true|t|yes|1/i) ? true :\n                el.match(/false|f|no|0/i) ? false : null;\n            if (v === null) {\n                throw new ParamError(`array element \"${el}\" should be boolean`);\n            }\n            return v;\n        } else if (type === \"string\") {\n            return el;\n        } else {\n            throw new ParamError(`unknown type \"${type}\" for array elements`);\n        }\n    });\n    \n    return arr;\n};\n\n"],"mappings":"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","names":["relativeMatch"]}
+{"version":3,"sources":["../src/params/index.ts","../src/errors.ts","../src/params/custom-types.ts"],"sourcesContent":["import Joi from \"joi\";\nimport { ParamError } from \"../errors\";\nimport { joiEdateType, joiStringArrayType } from \"./custom-types\";\n\n/**\n * Parameter definition types\n */\nexport type ParamDefinition = \n    | string \n    | Joi.Schema \n    | { \n        type?: string | Joi.Schema; \n        values?: any[]; \n        [key: string]: any; \n      };\n\nexport type ParamGetter = (key: string, definition?: any) => any;\nexport type ParamSetter = (key: string, value: any) => boolean;\n\n/**\n * Args instance interface\n */\nexport interface ArgsInstance {\n    get(key: string): any;\n}\n\n/**\n * Params constructor options\n */\nexport interface ParamsOptions {\n    [key: string]: any;\n}\n\n/**\n * Tracked parameter information for --stopAfter=init\n */\ninterface TrackedParam {\n    key: string;\n    definition: ParamDefinition;\n    value: any;\n    source: \"cli\" | \"options\" | \"default\";\n}\n\n/**\n * Params class for parameter validation and type checking\n * Built on top of Args library with Joi validation\n */\nexport class Params {\n    private context: any; // Partial context during initialization\n    private params: Record<string, any> = {};\n    private definitions: Record<string, any> = {};\n    private args: ArgsInstance;\n    private paramSetters: ParamSetter[] = [];\n    private paramGetters: ParamGetter[] = [];\n    private trackedParams: TrackedParam[] = [];\n\n    constructor(context: any, options: ParamsOptions = {}) {\n        // Context might be partial during initialization\n        this.context = context;\n        this.args = context.args;\n\n        // Apply initial configuration\n        if (Object.keys(options).length > 0) {\n            this.configure(options);\n        }\n    }\n\n    /**\n     * Configure parameters\n     * Only parameters present in options are updated\n     */\n    configure(options: ParamsOptions): void {\n        for (const [k, v] of Object.entries(options)) {\n            // TODO: opt values might be an object with definitions in it, so perhaps `this.set` should be used\n            this.params[k] = v;\n        }\n    }\n\n    /**\n     * Initialize Params from context and CLI parameters\n     * Note: Params is special - it's initialized early with partial context\n     */\n    static init(context: any, options?: ParamsOptions): Params {\n        return new Params(context, options || {});\n    }\n\n    /**\n     * Track a parameter request for --stopAfter=init feature\n     */\n    private trackParam(key: string, definition: ParamDefinition, value: any, source: \"cli\" | \"options\" | \"default\"): void {\n        this.trackedParams.push({\n            key,\n            definition,\n            value,\n            source\n        });\n    }\n\n    /**\n     * Get all tracked parameters (for --stopAfter=init)\n     */\n    getTrackedParams(): TrackedParam[] {\n        return [...this.trackedParams];\n    }\n\n    /**\n     * Get all figured parameters as a record\n     * Returns all parameters that were collected during initialization,\n     * whether from CLI args, options, or defaults\n     */\n    getAllFigured(): Record<string, { value: any; source: \"cli\" | \"options\" | \"default\" }> {\n        const result: Record<string, { value: any; source: \"cli\" | \"options\" | \"default\" }> = {};\n        for (const param of this.trackedParams) {\n            result[param.key] = {\n                value: param.value,\n                source: param.source,\n            };\n        }\n        return result;\n    }\n\n    /**\n     * Clear tracked parameters\n     */\n    clearTrackedParams(): void {\n        this.trackedParams = [];\n    }\n\n    /**\n     * Assign a parameter definition\n     */\n    assignDefinition(key: string, definition?: ParamDefinition): any {\n        if (this.definitions[key] && !definition) {\n            return this.definitions[key];\n        }\n\n        let type: Joi.Schema;\n        if (!definition) {\n            type = Joi.string();\n        } else if (Joi.isSchema(definition)) {\n            type = definition;\n        } else if (Joi.isSchema(definition.type)) {\n            type = definition.type;\n        } else if (typeof definition === \"string\") {\n            type = this.toJoi(definition);\n        } else if (typeof definition.type === \"string\") {\n            type = this.toJoi(definition.type);\n        } else if (!definition.type) {\n            type = Joi.string();\n        } else {\n            type = Joi.string();\n        }\n\n        if (!this.definitions[key]) {\n            this.definitions[key] = {};\n        }\n        this.definitions[key].type = type;\n\n        if (definition && definition.values) {\n            if (Array.isArray(definition.values)) {\n                this.definitions[key].values = definition.values;\n            }\n        }\n        return this.definitions[key];\n    }\n\n    /**\n     * Convert string definition to Joi schema\n     */\n    toJoi(str: string): Joi.Schema {\n        let type: Joi.Schema;\n        \n        if (str.match(/^string|^text/i)) {\n            type = Joi.string();\n        } else if (str.match(/^number|^integer|^int/i)) {\n            type = Joi.number();\n        } else if (str.match(/^boolean|^bool/i)) {\n            type = Joi.boolean();\n        } else if (str.match(/^date/i)) {\n            type = Joi.custom(joiEdateType);\n        } else if (str.match(/^duration/i)) {\n            type = Joi.string().isoDuration();\n        } else if (str.match(/^array/i)) {\n            let elementTypes = \"string\";\n            const tmp = str.match(/\\((.*)\\)/);\n            if (tmp && tmp[1].match(/string/i)) {\n                elementTypes = \"string\";\n            } else if (tmp && tmp[1].match(/number|integer|int/i)) {\n                elementTypes = \"number\";\n            } else if (tmp && tmp[1].match(/boolean|bool/i)) {\n                elementTypes = \"boolean\";\n            }\n            type = Joi.custom(joiStringArrayType(elementTypes));\n        } else {\n            type = Joi.string();\n        }\n\n        // Handle default values\n        const regexForDefault = /\\bdefault\\s+([^\\s]+)/;\n        const matchForDefault = str.match(regexForDefault);\n        if (matchForDefault) {\n            const defValObj = type.validate(matchForDefault[1]);\n            if (defValObj.error) {\n                throw new ParamError(`default value \"${defValObj.value}\" type mismatch`);\n            }\n            // Joi's default() automatically allows undefined and applies the default\n            type = type.default(defValObj.value);\n        } else if (str.match(/required/)) {\n            type = type.required();\n        } else {\n            // If not required and no default, make it optional\n            type = type.optional();\n        }\n\n        return type;\n    }\n\n    /**\n     * Validate a value against a definition\n     */\n    validate(key: string, val: any, def: any): any {\n        // Convert null to undefined so Joi defaults can be applied\n        // Joi's .default() only works with undefined, not null\n        const normalizedVal = val === null ? undefined : val;\n        \n        // Pass current params as context to support cross-parameter references (e.g., @startTime+2h)\n        // Use abortEarly: false to get all errors, and allowUnknown: false for strict validation\n        const { value, error } = def.type.validate(normalizedVal, { \n            context: { params: this.params },\n            abortEarly: false,\n            allowUnknown: false,\n        });\n        if (error) {\n            const errs = error.details.map((el: any) => el.message).join(\", \");\n            throw new ParamError(`\"${key}\" validation error: ${errs}`);\n        }\n        return value;\n    }\n\n    /**\n     * Get a parameter value with validation\n     */\n    get(key: string, definition?: ParamDefinition): any {\n        const def = this.assignDefinition(key, definition);\n        let valFromGetters: any = undefined;\n        \n        if (def.volatile || true) {\n            valFromGetters = this.runAllRegisteredGetters(key);\n        }\n        \n        const valFromArgs = this.args.get(key);\n        const valFromParams = this.params[key];\n\n        let source: \"cli\" | \"options\" | \"default\" = \"default\";\n        let value: any;\n\n        if (valFromGetters !== undefined && valFromGetters !== null) {\n            value = this.validate(key, valFromGetters, def);\n            source = \"options\";\n        } else if (valFromArgs !== undefined && valFromArgs !== null) {\n            value = this.validate(key, valFromArgs, def);\n            source = \"cli\";\n        } else if (valFromParams !== undefined && valFromParams !== null) {\n            value = this.validate(key, valFromParams, def);\n            source = \"options\";\n        } else {\n            // Use default from definition - Joi will apply default when value is undefined\n            // We need to pass undefined explicitly so Joi can apply the default\n            value = this.validate(key, undefined, def);\n            source = \"default\";\n        }\n\n        // Track parameter for --stopAfter=init\n        this.trackParam(key, definition || \"string\", value, source);\n\n        if (value !== undefined && def.values && !def.values.includes(value)) {\n            throw new ParamError(`key ${key} should be one of ${def.values}`);\n        }\n        return value;\n    }\n\n    /**\n     * Set a parameter value with validation\n     */\n    set(key: string, val: any, definition?: ParamDefinition): void {\n        // TODO: check if there's a test for this:\n        if (val && val.type && val.value) {\n            definition = val;\n            val = val.value;\n        }\n        const def = this.assignDefinition(key, definition);\n\n        if (!this.runAllRegisteredSetters(key, val)) {\n            this.params[key] = val;\n        }\n    }\n\n    /**\n     * Get all parameters from definitions\n     * Processes parameters left-to-right to support cross-parameter references\n     */\n    getAll(defs: Record<string, ParamDefinition>): Record<string, any> {\n        const res: Record<string, any> = {};\n        for (const [k, def] of Object.entries(defs)) {\n            const value = this.get(k, def);\n            res[k] = value;\n            // Store validated value in params so subsequent params can reference it\n            if (value !== undefined) {\n                this.params[k] = value;\n            }\n        }\n        return res;\n    }\n\n    /**\n     * Run all registered getters for a key\n     */\n    runAllRegisteredGetters(key: string): any {\n        let val: any = undefined;\n        for (const getter of this.paramGetters) {\n            val = getter(key, this.definitions[key]);\n            if (val !== undefined && val !== null) {\n                break;\n            }\n        }\n        return val;\n    }\n\n    /**\n     * Run all registered setters for a key\n     */\n    runAllRegisteredSetters(key: string, value: any): boolean {\n        let setterUsed: boolean = false;\n        for (const setter of this.paramSetters) {\n            setterUsed = setter(key, value);\n            if (setterUsed) {\n                break;\n            }\n        }\n        return setterUsed;\n    }\n\n    /**\n     * Register a parameter getter\n     */\n    registerParamGetter(fn: ParamGetter): void {\n        this.paramGetters.push(fn);\n    }\n\n    /**\n     * Register a parameter setter\n     */\n    registerParamSetter(fn: ParamSetter): void {\n        this.paramSetters.push(fn);\n    }\n}\n\n// Export custom types for external use\nexport { joiEdateType, joiStringArrayType };\n\n","/**\n * Error classes for the CLI toolkit\n */\n\nexport class FrameworkError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"FrameworkError\";\n    }\n}\n\nexport class ParamError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ParamError\";\n    }\n}\n\nexport class InitError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"InitError\";\n    }\n}\n\nexport class CriticalRequestError extends FrameworkError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"CriticalRequestError\";\n    }\n}\n\nexport class ControlFlowError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ControlFlowError\";\n    }\n}\n\n","import Joi from \"joi\";\nimport { ParamError } from \"../errors.js\";\n\n/**\n * Custom Joi type for enhanced date parsing with relative time support\n * Supports:\n * - ISO8601 strings: \"2025-01-01T01:01:01Z\"\n * - Relative time: \"-2h\", \"+1d\", \"now\"\n * - Cross-parameter references: \"@startTime+2h\", \"@endDate-30m\"\n * \n * Internal representation: UTC ISO8601 string (YYYY-MM-DDTHH:mm:ssZ)\n * \n * @param value - Date value to parse\n * @param helpers - Joi helpers (includes context with other params)\n * @returns ISO8601 string in UTC timezone\n */\nexport const joiEdateType = (value: any, helpers: Joi.CustomHelpers): string => {\n    // If value is already a string in ISO format, validate and return\n    if (typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$/.test(value)) {\n        const testDate = new Date(value);\n        if (!isNaN(testDate.getTime())) {\n            return value;\n        }\n    }\n\n    // If value is a Date object, convert to ISO string\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    // If value is not a string, try to convert it\n    if (typeof value !== \"string\") {\n        value = String(value);\n    }\n\n    // Handle special keyword \"now\"\n    if (value.toLowerCase() === \"now\") {\n        return new Date().toISOString();\n    }\n\n    // Check for cross-parameter reference with relative time: @paramName+2h, @paramName-30m\n    const referenceRegex = /^@(\\w+)([+-]\\d+[smhdwy])$/i;\n    const referenceMatch = value.match(referenceRegex);\n    \n    if (referenceMatch) {\n        const [, paramName, relativeExpr] = referenceMatch;\n        \n        // Get the referenced parameter from context (if available via helpers.state.ancestors)\n        // For now, we'll use helpers.prefs.context which Joi provides\n        const context = (helpers as any).prefs?.context;\n        \n        if (!context || !context.params) {\n            throw new ParamError(`Cannot resolve cross-parameter reference @${paramName}: context not available. Ensure parameters are processed with proper context.`);\n        }\n\n        const referencedValue = context.params[paramName];\n        \n        if (referencedValue === undefined || referencedValue === null) {\n            throw new ParamError(`Cannot resolve @${paramName}: parameter \"${paramName}\" is not defined or has no value. Parameters are evaluated left-to-right.`);\n        }\n\n        // Referenced value should be an ISO string or Date\n        let referenceDate: Date;\n        if (referencedValue instanceof Date) {\n            referenceDate = referencedValue;\n        } else if (typeof referencedValue === \"string\") {\n            referenceDate = new Date(referencedValue);\n            if (isNaN(referenceDate.getTime())) {\n                throw new ParamError(`Referenced parameter @${paramName} has invalid date value: ${referencedValue}`);\n            }\n        } else {\n            throw new ParamError(`Referenced parameter @${paramName} is not a valid date type (found: ${typeof referencedValue})`);\n        }\n\n        // Parse the relative expression and apply to reference date\n        const relativeMatch = relativeExpr.match(/^([+-])(\\d+)([smhdwy])$/i);\n        if (!relativeMatch) {\n            throw new ParamError(`Invalid relative time expression in @${paramName}${relativeExpr}`);\n        }\n\n        const [, sign, amount, unit] = relativeMatch;\n        const offset = calculateTimeOffset(parseInt(amount, 10), unit, sign);\n        const resultDate = new Date(referenceDate.getTime() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Check for relative time expressions like \"-2h\", \"+1d\", \"-30m\", etc.\n    const relativeTimeRegex = /^([+-])(\\d+)([smhdwy])$/i;\n    const relativeMatch = value.match(relativeTimeRegex);\n    \n    if (relativeMatch) {\n        const [, sign, amount, unit] = relativeMatch;\n        const numAmount = parseInt(amount, 10);\n        \n        if (isNaN(numAmount)) {\n            throw new ParamError(`Invalid relative time amount: ${amount}`);\n        }\n\n        const offset = calculateTimeOffset(numAmount, unit, sign);\n        const resultDate = new Date(Date.now() + offset);\n        \n        return resultDate.toISOString();\n    }\n\n    // Try to parse as a regular date string\n    const parsedDate = new Date(value);\n    \n    // Check if the parsed date is valid\n    if (isNaN(parsedDate.getTime())) {\n        throw new ParamError(`Invalid date format: ${value}. Expected a valid date string, \"now\", relative time expression (e.g., \"-2h\", \"+1d\"), or cross-parameter reference (e.g., \"@startTime+2h\")`);\n    }\n\n    return parsedDate.toISOString();\n};\n\n/**\n * Calculate time offset in milliseconds\n */\nfunction calculateTimeOffset(amount: number, unit: string, sign: string): number {\n    let multiplier = 1;\n    \n    // Convert to milliseconds based on unit\n    switch (unit.toLowerCase()) {\n        case \"s\": // seconds\n            multiplier = 1000;\n            break;\n        case \"m\": // minutes\n            multiplier = 60 * 1000;\n            break;\n        case \"h\": // hours\n            multiplier = 60 * 60 * 1000;\n            break;\n        case \"d\": // days\n            multiplier = 24 * 60 * 60 * 1000;\n            break;\n        case \"w\": // weeks\n            multiplier = 7 * 24 * 60 * 60 * 1000;\n            break;\n        case \"y\": // years (approximate)\n            multiplier = 365 * 24 * 60 * 60 * 1000;\n            break;\n        default:\n            throw new ParamError(`Invalid time unit: ${unit}. Supported units: s, m, h, d, w, y`);\n    }\n\n    return sign === \"+\" ? amount * multiplier : -amount * multiplier;\n}\n\n/**\n * Custom Joi type for string array parsing\n * Converts comma-separated strings to typed arrays\n */\nexport const joiStringArrayType = (type: string) => (value: any, helpers: Joi.CustomHelpers): any[] => {\n    if (value === undefined || typeof value === \"function\") {\n        return [];\n    }\n    \n    const arr = value.split(/,\\s*/).map((el: string) => {\n        if (type === \"number\") {\n            const v = parseInt(el, 10);\n            if (isNaN(v)) {\n                throw new ParamError(`array element \"${el}\" should be numeric`);\n            }\n            return v;\n        } else if (type === \"boolean\") {\n            const v = el.match(/true|t|yes|1/i) ? true :\n                el.match(/false|f|no|0/i) ? false : null;\n            if (v === null) {\n                throw new ParamError(`array element \"${el}\" should be boolean`);\n            }\n            return v;\n        } else if (type === \"string\") {\n            return el;\n        } else {\n            throw new ParamError(`unknown type \"${type}\" for array elements`);\n        }\n    });\n    \n    return arr;\n};\n\n"],"mappings":"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","names":["relativeMatch"]}

package/dist/screen.cjs

@@ -3,7 +3,7 @@
 var __esmCache = {};
 var __loadESMSync = function(moduleName) {
   if (!__esmCache[moduleName]) {
-    throw new Error(`ESM module "${moduleName}" not loaded. Please call the load() function first: const screen = require("@nmakarov/cli-toolkit/screen"); await screen.load();`);
+    throw new Error(`ESM module "${moduleName}" not loaded. Please call the load() function first: const toolkit = require("@nmakarov/cli-toolkit"); await toolkit.load();`);
   }
   return __esmCache[moduleName];
 };
@@ -161,7 +161,7 @@ function ScreenFooter({ lines, textStyle }) {
 // src/screen/list-components.ts
 var import_react2 = null; // Will be set by load();
 var import_ink2 = null; // Will be set by load();
-// Removed: intermediate assignment that would execute during module load
+// Removed: intermediate assignment - code will access import variable directly
 function MultiColumnListComponent({ items, ctx, selectedIndexRef }) {
   const [, forceUpdate] = (0, import_react2.useState)({});
   const termWidth = (process.stdout.columns || 80) - 8;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nmakarov/cli-toolkit",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "A comprehensive toolkit for building CLI applications",
   "type": "module",
   "main": "./dist/index.js",