configorama 0.6.18 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/README.md +78 -2
  2. package/cli.js +1 -0
  3. package/index.d.ts +90 -37
  4. package/package.json +8 -2
  5. package/src/index.js +42 -14
  6. package/src/main.js +135 -62
  7. package/src/parsers/index.js +10 -0
  8. package/src/parsers/typescript.js +20 -43
  9. package/src/parsers/yaml.js +35 -2
  10. package/src/resolvers/valueFromFile.js +87 -24
  11. package/src/resolvers/valueFromGit.js +11 -3
  12. package/src/utils/encoders/js-fixes.js +44 -0
  13. package/src/utils/parsing/mergeByKeys.js +4 -3
  14. package/src/utils/parsing/parse.js +4 -2
  15. package/src/utils/parsing/preProcess.js +42 -25
  16. package/src/utils/parsing/preProcess.test.js +214 -0
  17. package/src/utils/paths/getFullFilePath.js +1 -1
  18. package/src/utils/resolution/preResolveVariable.js +1 -0
  19. package/src/utils/strings/quoteUtils.js +2 -2
  20. package/src/utils/strings/splitCsv.js +1 -1
  21. package/src/utils/ui/logs.js +4 -4
  22. package/src/utils/validation/warnIfNotFound.js +3 -3
  23. package/src/utils/variables/findNestedVariables.js +2 -2
  24. package/src/utils/variables/variableUtils.js +43 -0
  25. package/src/utils/variables/variableUtils.test.js +38 -1
  26. package/types/cli.d.ts +3 -0
  27. package/types/cli.d.ts.map +1 -0
  28. package/types/src/functions/md5.d.ts +3 -0
  29. package/types/src/functions/md5.d.ts.map +1 -0
  30. package/types/src/index.d.ts +100 -0
  31. package/types/src/index.d.ts.map +1 -0
  32. package/types/src/main.d.ts +275 -0
  33. package/types/src/main.d.ts.map +1 -0
  34. package/types/src/parsers/esm.d.ts +15 -0
  35. package/types/src/parsers/esm.d.ts.map +1 -0
  36. package/types/src/parsers/hcl.d.ts +1 -0
  37. package/types/src/parsers/hcl.d.ts.map +1 -0
  38. package/types/src/parsers/index.d.ts +18 -0
  39. package/types/src/parsers/index.d.ts.map +1 -0
  40. package/types/src/parsers/ini.d.ts +6 -0
  41. package/types/src/parsers/ini.d.ts.map +1 -0
  42. package/types/src/parsers/json5.d.ts +10 -0
  43. package/types/src/parsers/json5.d.ts.map +1 -0
  44. package/types/src/parsers/toml.d.ts +7 -0
  45. package/types/src/parsers/toml.d.ts.map +1 -0
  46. package/types/src/parsers/typescript.d.ts +15 -0
  47. package/types/src/parsers/typescript.d.ts.map +1 -0
  48. package/types/src/parsers/yaml.d.ts +45 -0
  49. package/types/src/parsers/yaml.d.ts.map +1 -0
  50. package/types/src/resolvers/valueFromCron.d.ts +14 -0
  51. package/types/src/resolvers/valueFromCron.d.ts.map +1 -0
  52. package/types/src/resolvers/valueFromEnv.d.ts +8 -0
  53. package/types/src/resolvers/valueFromEnv.d.ts.map +1 -0
  54. package/types/src/resolvers/valueFromEval.d.ts +7 -0
  55. package/types/src/resolvers/valueFromEval.d.ts.map +1 -0
  56. package/types/src/resolvers/valueFromFile.d.ts +58 -0
  57. package/types/src/resolvers/valueFromFile.d.ts.map +1 -0
  58. package/types/src/resolvers/valueFromGit.d.ts +11 -0
  59. package/types/src/resolvers/valueFromGit.d.ts.map +1 -0
  60. package/types/src/resolvers/valueFromNumber.d.ts +6 -0
  61. package/types/src/resolvers/valueFromNumber.d.ts.map +1 -0
  62. package/types/src/resolvers/valueFromOptions.d.ts +9 -0
  63. package/types/src/resolvers/valueFromOptions.d.ts.map +1 -0
  64. package/types/src/resolvers/valueFromSelf.d.ts +1 -0
  65. package/types/src/resolvers/valueFromSelf.d.ts.map +1 -0
  66. package/types/src/resolvers/valueFromString.d.ts +6 -0
  67. package/types/src/resolvers/valueFromString.d.ts.map +1 -0
  68. package/types/src/sync.d.ts +3 -0
  69. package/types/src/sync.d.ts.map +1 -0
  70. package/types/src/utils/PromiseTracker.d.ts +19 -0
  71. package/types/src/utils/PromiseTracker.d.ts.map +1 -0
  72. package/types/src/utils/encoders/index.d.ts +2 -0
  73. package/types/src/utils/encoders/index.d.ts.map +1 -0
  74. package/types/src/utils/encoders/js-fixes.d.ts +23 -0
  75. package/types/src/utils/encoders/js-fixes.d.ts.map +1 -0
  76. package/types/src/utils/encoders/unknown-values.d.ts +18 -0
  77. package/types/src/utils/encoders/unknown-values.d.ts.map +1 -0
  78. package/types/src/utils/handleSignalEvents.d.ts +3 -0
  79. package/types/src/utils/handleSignalEvents.d.ts.map +1 -0
  80. package/types/src/utils/lodash.d.ts +4 -0
  81. package/types/src/utils/lodash.d.ts.map +1 -0
  82. package/types/src/utils/parsing/arrayToJsonPath.d.ts +5 -0
  83. package/types/src/utils/parsing/arrayToJsonPath.d.ts.map +1 -0
  84. package/types/src/utils/parsing/cloudformationSchema.d.ts +2 -0
  85. package/types/src/utils/parsing/cloudformationSchema.d.ts.map +1 -0
  86. package/types/src/utils/parsing/enrichMetadata.d.ts +17 -0
  87. package/types/src/utils/parsing/enrichMetadata.d.ts.map +1 -0
  88. package/types/src/utils/parsing/mergeByKeys.d.ts +5 -0
  89. package/types/src/utils/parsing/mergeByKeys.d.ts.map +1 -0
  90. package/types/src/utils/parsing/parse.d.ts +54 -0
  91. package/types/src/utils/parsing/parse.d.ts.map +1 -0
  92. package/types/src/utils/parsing/preProcess.d.ts +10 -0
  93. package/types/src/utils/parsing/preProcess.d.ts.map +1 -0
  94. package/types/src/utils/paths/filePathUtils.d.ts +32 -0
  95. package/types/src/utils/paths/filePathUtils.d.ts.map +1 -0
  96. package/types/src/utils/paths/findLineForKey.d.ts +12 -0
  97. package/types/src/utils/paths/findLineForKey.d.ts.map +1 -0
  98. package/types/src/utils/paths/findProjectRoot.d.ts +2 -0
  99. package/types/src/utils/paths/findProjectRoot.d.ts.map +1 -0
  100. package/types/src/utils/paths/getFullFilePath.d.ts +25 -0
  101. package/types/src/utils/paths/getFullFilePath.d.ts.map +1 -0
  102. package/types/src/utils/paths/resolveAlias.d.ts +14 -0
  103. package/types/src/utils/paths/resolveAlias.d.ts.map +1 -0
  104. package/types/src/utils/regex/index.d.ts +14 -0
  105. package/types/src/utils/regex/index.d.ts.map +1 -0
  106. package/types/src/utils/resolution/preResolveVariable.d.ts +51 -0
  107. package/types/src/utils/resolution/preResolveVariable.d.ts.map +1 -0
  108. package/types/src/utils/strings/bracketMatcher.d.ts +25 -0
  109. package/types/src/utils/strings/bracketMatcher.d.ts.map +1 -0
  110. package/types/src/utils/strings/formatFunctionArgs.d.ts +3 -0
  111. package/types/src/utils/strings/formatFunctionArgs.d.ts.map +1 -0
  112. package/types/src/utils/strings/quoteUtils.d.ts +31 -0
  113. package/types/src/utils/strings/quoteUtils.d.ts.map +1 -0
  114. package/types/src/utils/strings/replaceAll.d.ts +9 -0
  115. package/types/src/utils/strings/replaceAll.d.ts.map +1 -0
  116. package/types/src/utils/strings/splitByComma.d.ts +2 -0
  117. package/types/src/utils/strings/splitByComma.d.ts.map +1 -0
  118. package/types/src/utils/strings/splitCsv.d.ts +10 -0
  119. package/types/src/utils/strings/splitCsv.d.ts.map +1 -0
  120. package/types/src/utils/strings/textUtils.d.ts +15 -0
  121. package/types/src/utils/strings/textUtils.d.ts.map +1 -0
  122. package/types/src/utils/ui/chalk.d.ts +70 -0
  123. package/types/src/utils/ui/chalk.d.ts.map +1 -0
  124. package/types/src/utils/ui/configWizard.d.ts +67 -0
  125. package/types/src/utils/ui/configWizard.d.ts.map +1 -0
  126. package/types/src/utils/ui/createEditorLink.d.ts +11 -0
  127. package/types/src/utils/ui/createEditorLink.d.ts.map +1 -0
  128. package/types/src/utils/ui/deep-log.d.ts +3 -0
  129. package/types/src/utils/ui/deep-log.d.ts.map +1 -0
  130. package/types/src/utils/ui/logs.d.ts +2 -0
  131. package/types/src/utils/ui/logs.d.ts.map +1 -0
  132. package/types/src/utils/validation/warnIfNotFound.d.ts +15 -0
  133. package/types/src/utils/validation/warnIfNotFound.d.ts.map +1 -0
  134. package/types/src/utils/variables/appendDeepVariable.d.ts +3 -0
  135. package/types/src/utils/variables/appendDeepVariable.d.ts.map +1 -0
  136. package/types/src/utils/variables/cleanVariable.d.ts +3 -0
  137. package/types/src/utils/variables/cleanVariable.d.ts.map +1 -0
  138. package/types/src/utils/variables/findNestedVariables.d.ts +23 -0
  139. package/types/src/utils/variables/findNestedVariables.d.ts.map +1 -0
  140. package/types/src/utils/variables/getVariableType.d.ts +8 -0
  141. package/types/src/utils/variables/getVariableType.d.ts.map +1 -0
  142. package/types/src/utils/variables/variableUtils.d.ts +21 -0
  143. package/types/src/utils/variables/variableUtils.d.ts.map +1 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/encoders/index.js"],"names":[],"mappings":"AAIA,oDAQC"}
@@ -0,0 +1,23 @@
1
+ export const OPEN_PAREN_PLACEHOLDER_PATTERN: RegExp;
2
+ export function hasParenthesesPlaceholder(value?: string): boolean;
3
+ export function encodeJsSyntax(value?: string): string;
4
+ export function decodeJsSyntax(value: any): any;
5
+ /**
6
+ * Encode a JSON object to base64 for safe embedding in variable strings
7
+ * @param {object} obj - Object to encode
8
+ * @returns {string} Encoded string like __JSON_B64__eyJmb28iOiJiYXIifQ==__
9
+ */
10
+ export function encodeJsonForVariable(obj: object): string;
11
+ /**
12
+ * Decode base64-encoded JSON from variable strings
13
+ * @param {string} value - String potentially containing encoded JSON
14
+ * @returns {string} String with encoded JSON decoded back to JSON strings
15
+ */
16
+ export function decodeJsonInVariable(value: string): string;
17
+ /**
18
+ * Check if string contains encoded JSON
19
+ * @param {string} value - String to check
20
+ * @returns {boolean}
21
+ */
22
+ export function hasEncodedJson(value: string): boolean;
23
+ //# sourceMappingURL=js-fixes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"js-fixes.d.ts","sourceRoot":"","sources":["../../../../src/utils/encoders/js-fixes.js"],"names":[],"mappings":"AACA,oDAA2D;AAc3D,mEAEC;AAXD,uDAEC;AAED,gDAGC;AAMD;;;;GAIG;AACH,2CAHW,MAAM,GACJ,MAAM,CAMlB;AAED;;;;GAIG;AACH,4CAHW,MAAM,GACJ,MAAM,CAYlB;AAED;;;;GAIG;AACH,sCAHW,MAAM,GACJ,OAAO,CAKnB"}
@@ -0,0 +1,18 @@
1
+ export const PASSTHROUGH_PATTERN: RegExp;
2
+ export function hasEncodedUnknown(value: any): boolean;
3
+ /**
4
+ * Encode unknown variable for passthrough
5
+ */
6
+ export function encodeUnknown(v: any): string;
7
+ /**
8
+ * Decode unknown variable from passthrough
9
+ */
10
+ export function decodeUnknown(rawValue: any): any;
11
+ /**
12
+ * Find base64 encoded unknown values in text
13
+ */
14
+ export function findUnknownValues(text: any): {
15
+ match: string;
16
+ value: string;
17
+ }[];
18
+ //# sourceMappingURL=unknown-values.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unknown-values.d.ts","sourceRoot":"","sources":["../../../../src/utils/encoders/unknown-values.js"],"names":[],"mappings":"AACA,yCAA2C;AAS3C,uDAEC;AATD;;GAEG;AACH,8CAEC;AAMD;;GAEG;AACH,kDAUC;AAED;;GAEG;AACH;;;IAcC"}
@@ -0,0 +1,3 @@
1
+ export = handleSignalEvents;
2
+ declare function handleSignalEvents(): void;
3
+ //# sourceMappingURL=handleSignalEvents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handleSignalEvents.d.ts","sourceRoot":"","sources":["../../../src/utils/handleSignalEvents.js"],"names":[],"mappings":";AAEA,4CAsDC"}
@@ -0,0 +1,4 @@
1
+ export function trim(string: any, chars: any): any;
2
+ export function set(object: any, path: any, value: any): any;
3
+ export { isArray, isString, isNumber, isObject, isDate, isRegExp, isFunction, isEmpty, camelCase, kebabCase, capitalize, split, map, mapValues, assign, cloneDeep };
4
+ //# sourceMappingURL=lodash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lodash.d.ts","sourceRoot":"","sources":["../../../src/utils/lodash.js"],"names":[],"mappings":"AAiDA,mDAoBC;AAnDD,6DA4BC"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Convert array of paths to JSON path string
3
+ */
4
+ export function arrayToJsonPath(paths: any): any;
5
+ //# sourceMappingURL=arrayToJsonPath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"arrayToJsonPath.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/arrayToJsonPath.js"],"names":[],"mappings":"AAAA;;GAEG;AACH,iDAKC"}
@@ -0,0 +1,2 @@
1
+ export let schema: any;
2
+ //# sourceMappingURL=cloudformationSchema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloudformationSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/cloudformationSchema.js"],"names":[],"mappings":""}
@@ -0,0 +1,17 @@
1
+ export = enrichMetadata;
2
+ /**
3
+ * Enriches variable metadata with resolution tracking data.
4
+ * @param {object} metadata - The metadata object from collectVariableMetadata.
5
+ * @param {object} resolutionTracking - The resolution tracking data from Configorama instance.
6
+ * @param {RegExp} variableSyntax - The variable syntax regex.
7
+ * @param {Array} fileRefsFound - The (incomplete) list of file refs found during resolution.
8
+ * @param {object} originalConfig - The original config object (before resolution) for self/dot.prop lookups.
9
+ * @param {string} configPath - The path to the config file.
10
+ * @param {Array} filterNames - Array of known filter names.
11
+ * @param {object} [resolvedConfig] - The resolved config object (optional, for post-resolution enrichment).
12
+ * @param {object} [options] - CLI options object for opt: resolution.
13
+ * @param {Array} [variableTypes] - Array of variable type definitions with source info.
14
+ * @returns {Promise<object>} Enriched metadata with resolution details and a complete file reference list.
15
+ */
16
+ declare function enrichMetadata(metadata: object, resolutionTracking: object, variableSyntax: RegExp, fileRefsFound: any[], originalConfig: object, configPath: string, filterNames?: any[], resolvedConfig?: object, options?: object, variableTypes?: any[]): Promise<object>;
17
+ //# sourceMappingURL=enrichMetadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrichMetadata.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/enrichMetadata.js"],"names":[],"mappings":";AAsGA;;;;;;;;;;;;;GAaG;AACH,0CAZW,MAAM,sBACN,MAAM,kBACN,MAAM,wCAEN,MAAM,cACN,MAAM,wCAEN,MAAM,YACN,MAAM,0BAEJ,OAAO,CAAC,MAAM,CAAC,CAyoB3B"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Merge objects by specified keys
3
+ */
4
+ export function mergeByKeys(data: any, path: any, keysToMerge: any): any;
5
+ //# sourceMappingURL=mergeByKeys.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mergeByKeys.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/mergeByKeys.js"],"names":[],"mappings":"AAAA;;GAEG;AACH,yEAwBC"}
@@ -0,0 +1,54 @@
1
+ export type ParseOptions = {
2
+ /**
3
+ * - Raw file contents to parse
4
+ */
5
+ contents: string;
6
+ /**
7
+ * - Full file path (used for extension detection and error messages)
8
+ */
9
+ filePath: string;
10
+ /**
11
+ * - Variable syntax regex (defaults to configorama syntax)
12
+ */
13
+ varRegex?: RegExp;
14
+ /**
15
+ * - Arguments passed to JS/TS function exports
16
+ */
17
+ dynamicArgs?: any | Function;
18
+ };
19
+ export type ParseFileOptions = {
20
+ /**
21
+ * - Variable syntax regex (defaults to configorama syntax)
22
+ */
23
+ varRegex?: RegExp;
24
+ /**
25
+ * - Arguments passed to JS/TS function exports
26
+ */
27
+ dynamicArgs?: any | Function;
28
+ };
29
+ /**
30
+ * @typedef {Object} ParseOptions
31
+ * @property {string} contents - Raw file contents to parse
32
+ * @property {string} filePath - Full file path (used for extension detection and error messages)
33
+ * @property {RegExp} [varRegex] - Variable syntax regex (defaults to configorama syntax)
34
+ * @property {Object|Function} [dynamicArgs] - Arguments passed to JS/TS function exports
35
+ */
36
+ /**
37
+ * Parse file contents based on file extension
38
+ * @param {ParseOptions} options
39
+ * @returns {Object} Parsed configuration object
40
+ */
41
+ export function parseFileContents({ contents, filePath, varRegex, dynamicArgs }: ParseOptions): any;
42
+ /**
43
+ * @typedef {Object} ParseFileOptions
44
+ * @property {RegExp} [varRegex] - Variable syntax regex (defaults to configorama syntax)
45
+ * @property {Object|Function} [dynamicArgs] - Arguments passed to JS/TS function exports
46
+ */
47
+ /**
48
+ * Read and parse a config file
49
+ * @param {string} filePath - Path to the config file
50
+ * @param {ParseFileOptions} [opts]
51
+ * @returns {Object} Parsed configuration object
52
+ */
53
+ export function parseFile(filePath: string, opts?: ParseFileOptions): any;
54
+ //# sourceMappingURL=parse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/parse.js"],"names":[],"mappings":";;;;cAec,MAAM;;;;cACN,MAAM;;;;eACN,MAAM;;;;kBACN,cAAe;;;;;;eAkGf,MAAM;;;;kBACN,cAAe;;AAxG7B;;;;;;GAMG;AAEH;;;;GAIG;AACH,iFAHW,YAAY,OAyFtB;AAED;;;;GAIG;AAEH;;;;;GAKG;AACH,oCAJW,MAAM,SACN,gBAAgB,OAW1B"}
@@ -0,0 +1,10 @@
1
+ export = preProcess;
2
+ /**
3
+ * Preprocess config to fix malformed fallback references
4
+ * @param {Object} configObject - The parsed configuration object
5
+ * @param {RegExp} variableSyntax - The variable syntax regex to use
6
+ * @param {Array} [variableTypes] - Array of variable type definitions with type/prefix fields
7
+ * @returns {Object} The preprocessed configuration object
8
+ */
9
+ declare function preProcess(configObject: any, variableSyntax: RegExp, variableTypes?: any[]): any;
10
+ //# sourceMappingURL=preProcess.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preProcess.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsing/preProcess.js"],"names":[],"mappings":";AAOA;;;;;;GAMG;AACH,+DAJW,MAAM,8BAyKhB"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Normalize a file path (add ./ prefix, fix .//, skip deep refs)
3
+ * @param {string} filePath - The file path to normalize
4
+ * @returns {string|null} Normalized path, or null if should be skipped
5
+ */
6
+ export function normalizePath(filePath: string): string | null;
7
+ /**
8
+ * Extract file path from a file() or text() variable string
9
+ * @param {string} variableString - The variable string (with or without ${} wrapper)
10
+ * @returns {object|null} Object with filePath, or null if no match
11
+ */
12
+ export function extractFilePath(variableString: string): object | null;
13
+ /**
14
+ * Normalize a file() or text() variable string
15
+ * Strips key accessors and normalizes the path inside
16
+ * @param {string} variableString - e.g. "file('./config.json'):key" or "file(config.json)"
17
+ * @returns {string} Normalized variable string, e.g. "file(./config.json)"
18
+ */
19
+ export function normalizeFileVariable(variableString: string): string;
20
+ /**
21
+ * Resolve inner variables in a string from config values
22
+ * @param {string} str - String containing variables like ${self:stage}
23
+ * @param {RegExp} variableSyntax - Regex to match variable syntax
24
+ * @param {object} config - Config object to look up values
25
+ * @param {function} getProp - Function to get nested property (e.g. dotProp.get)
26
+ * @returns {{resolved: string, didResolve: boolean}} Resolved string and whether resolution happened
27
+ */
28
+ export function resolveInnerVariables(str: string, variableSyntax: RegExp, config: object, getProp: Function): {
29
+ resolved: string;
30
+ didResolve: boolean;
31
+ };
32
+ //# sourceMappingURL=filePathUtils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filePathUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/paths/filePathUtils.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wCAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CA0BvB;AAED;;;;GAIG;AACH,gDAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CAkBvB;AAED;;;;;GAKG;AACH,sDAHW,MAAM,GACJ,MAAM,CAkBlB;AAED;;;;;;;GAOG;AACH,2CANW,MAAM,kBACN,MAAM,UACN,MAAM,sBAEJ;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC,CAwCnD"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Finds the line number for a given key in config file contents
3
+ */
4
+ /**
5
+ * Find the line number where a key is defined in config file contents
6
+ * @param {string} keyToFind - The key to search for
7
+ * @param {string[]} lines - Array of file lines
8
+ * @param {string} fileType - File extension (e.g., '.yml', '.json', '.toml')
9
+ * @returns {number} Line number (1-indexed) or 0 if not found
10
+ */
11
+ export function findLineForKey(keyToFind: string, lines: string[], fileType: string): number;
12
+ //# sourceMappingURL=findLineForKey.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findLineForKey.d.ts","sourceRoot":"","sources":["../../../../src/utils/paths/findLineForKey.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,0CALW,MAAM,SACN,MAAM,EAAE,YACR,MAAM,GACJ,MAAM,CAiClB"}
@@ -0,0 +1,2 @@
1
+ export function findProjectRoot(startDir?: string, maxLookup?: number): string;
2
+ //# sourceMappingURL=findProjectRoot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findProjectRoot.d.ts","sourceRoot":"","sources":["../../../../src/utils/paths/findProjectRoot.js"],"names":[],"mappings":"AAGA,+EAiBC"}
@@ -0,0 +1,25 @@
1
+ export = getFullPath;
2
+ declare function getFullPath(fileString: any, cwd: any): string;
3
+ declare namespace getFullPath {
4
+ export { resolveFilePathFromMatch, resolveFilePath };
5
+ }
6
+ /**
7
+ * Resolves a file path from a matched file string (e.g., from file() or text() syntax)
8
+ * @param {string} matchedFileString - The matched file string (e.g., "file(path/to/file.js)")
9
+ * @param {RegExp} syntax - The regex pattern used to match the file string (e.g., fileRefSyntax or textRefSyntax)
10
+ * @param {string} configPath - The base directory path for resolving relative paths
11
+ * @returns {{fullFilePath: string, resolvedPath: string, relativePath: string}} - Object containing the resolved full file path, resolved path (after alias resolution), and relative path
12
+ */
13
+ declare function resolveFilePathFromMatch(matchedFileString: string, syntax: RegExp, configPath: string): {
14
+ fullFilePath: string;
15
+ resolvedPath: string;
16
+ relativePath: string;
17
+ };
18
+ /**
19
+ * Core path resolution logic - resolves a file path handling absolute paths, symlinks, and findUp
20
+ * @param {string} pathToResolve - The path to resolve
21
+ * @param {string} basePath - The base directory for relative paths
22
+ * @returns {string} The resolved full file path
23
+ */
24
+ declare function resolveFilePath(pathToResolve: string, basePath: string): string;
25
+ //# sourceMappingURL=getFullFilePath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getFullFilePath.d.ts","sourceRoot":"","sources":["../../../../src/utils/paths/getFullFilePath.js"],"names":[],"mappings":";AA+BA,gEAIC;;;;AAED;;;;;;GAMG;AACH,6DALW,MAAM,UACN,MAAM,cACN,MAAM,GACJ;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC,CAY9E;AA/CD;;;;;GAKG;AACH,gDAJW,MAAM,YACN,MAAM,GACJ,MAAM,CAkBlB"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Resolves path aliases using TypeScript/JavaScript path mappings from config files
3
+ * @param {string} filePath - The potentially aliased file path
4
+ * @param {string} configDir - The base directory to search for config files
5
+ * @returns {string} - The resolved file path
6
+ */
7
+ export function resolveAlias(filePath: string, configDir: string): string;
8
+ /**
9
+ * Gets all configured aliases from tsconfig.json or jsconfig.json
10
+ * @param {string} configDir - The base directory to search for config files
11
+ * @returns {Object} - Object containing alias names and their resolved paths
12
+ */
13
+ export function getAliases(configDir: string): any;
14
+ //# sourceMappingURL=resolveAlias.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveAlias.d.ts","sourceRoot":"","sources":["../../../../src/utils/paths/resolveAlias.js"],"names":[],"mappings":"AA0CA;;;;;GAKG;AACH,uCAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAsElB;AAED;;;;GAIG;AACH,sCAHW,MAAM,OA2BhB"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Shared regex patterns and utilities
3
+ */
4
+ export const funcRegex: RegExp;
5
+ export const funcStartOfLineRegex: RegExp;
6
+ export const subFunctionRegex: RegExp;
7
+ /**
8
+ * Combine multiple regex patterns into single OR pattern
9
+ * @param {RegExp[]} regexes - Array of regex patterns to combine
10
+ * @returns {RegExp} Combined regex with OR operator
11
+ */
12
+ export function combineRegexes(regexes: RegExp[]): RegExp;
13
+ export { funcRegex as functionRegex };
14
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/regex/index.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAAoD;AACpD,0CAAgE;AAChE,sCAAiE;AAEjE;;;;GAIG;AACH,wCAHW,MAAM,EAAE,GACN,MAAM,CAKlB"}
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Pre-resolve a single variable reference
3
+ * @param {string} varString - Variable string like "self:path.to.value" or "env:VAR_NAME"
4
+ * @param {object} context - Resolution context
5
+ * @param {object} context.config - Original config object
6
+ * @param {string} context.configDir - Config file directory
7
+ * @param {RegExp} context.variableSyntax - Variable syntax regex
8
+ * @param {object} [context.options] - CLI options
9
+ * @returns {Promise<*>} Resolved value or undefined if can't pre-resolve
10
+ */
11
+ export function preResolveSingle(varString: string, context: {
12
+ config: object;
13
+ configDir: string;
14
+ variableSyntax: RegExp;
15
+ options?: object;
16
+ }): Promise<any>;
17
+ /**
18
+ * Pre-resolve variable references in a string
19
+ * Replaces ${varRef} patterns with resolved values where possible
20
+ * @param {string} str - String containing variable references
21
+ * @param {object} context - Resolution context
22
+ * @param {object} context.config - Original config object
23
+ * @param {string} context.configDir - Config file directory
24
+ * @param {RegExp} context.variableSyntax - Variable syntax regex
25
+ * @param {object} [options] - Options
26
+ * @param {boolean} [options.formatArrays=true] - Join arrays with ", "
27
+ * @returns {Promise<string>} String with pre-resolved variables
28
+ */
29
+ export function preResolveString(str: string, context: {
30
+ config: object;
31
+ configDir: string;
32
+ variableSyntax: RegExp;
33
+ }, options?: {
34
+ formatArrays?: boolean;
35
+ }): Promise<string>;
36
+ /**
37
+ * Pre-resolve variables in an object recursively
38
+ * @param {*} obj - Object to process
39
+ * @param {object} context - Resolution context
40
+ * @param {object} [options] - Options passed to preResolveString
41
+ * @returns {Promise<*>} Object with pre-resolved variables
42
+ */
43
+ export function preResolveObject(obj: any, context: object, options?: object): Promise<any>;
44
+ /**
45
+ * Check if a string contains unresolved variable syntax
46
+ * @param {string} str - String to check
47
+ * @param {RegExp} variableSyntax - Variable syntax regex
48
+ * @returns {boolean}
49
+ */
50
+ export function hasUnresolvedVars(str: string, variableSyntax: RegExp): boolean;
51
+ //# sourceMappingURL=preResolveVariable.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preResolveVariable.d.ts","sourceRoot":"","sources":["../../../../src/utils/resolution/preResolveVariable.js"],"names":[],"mappings":"AA+BA;;;;;;;;;GASG;AACH,4CARW,MAAM,WAEd;IAAwB,MAAM,EAAtB,MAAM;IACU,SAAS,EAAzB,MAAM;IACU,cAAc,EAA9B,MAAM;IACW,OAAO,GAAxB,MAAM;CACd,GAAU,OAAO,CAAC,GAAC,CAAC,CAsGtB;AAED;;;;;;;;;;;GAWG;AACH,sCATW,MAAM,WAEd;IAAwB,MAAM,EAAtB,MAAM;IACU,SAAS,EAAzB,MAAM;IACU,cAAc,EAA9B,MAAM;CACd,YACA;IAA0B,YAAY,GAA9B,OAAO;CACf,GAAU,OAAO,CAAC,MAAM,CAAC,CAuE3B;AAED;;;;;;GAMG;AACH,sCALW,GAAC,WACD,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,GAAC,CAAC,CAsBtB;AA/OD;;;;;GAKG;AACH,uCAJW,MAAM,kBACN,MAAM,GACJ,OAAO,CAWnB"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Finds all outermost matching brace pairs in a string
3
+ * @param {string} text - The text to search
4
+ * @param {string} openChar - The opening character (default: '{')
5
+ * @param {string} closeChar - The closing character (default: '}')
6
+ * @param {string} prefix - Optional prefix before opening char (e.g., '$' for '${')
7
+ * @returns {Array<string>} Array of matched substrings including delimiters
8
+ */
9
+ export function findOutermostBraces(text: string, openChar?: string, closeChar?: string, prefix?: string): Array<string>;
10
+ /**
11
+ * Alternative implementation for finding outermost braces using depth tracking
12
+ * Optimized for simple bracket matching without prefix
13
+ * @param {string} text - The text to search
14
+ * @param {string} openChar - The opening character
15
+ * @param {string} closeChar - The closing character
16
+ * @returns {Array<string>} Array of matched substrings including delimiters
17
+ */
18
+ export function findOutermostBracesDepthFirst(text: string, openChar?: string, closeChar?: string): Array<string>;
19
+ /**
20
+ * Finds outermost variables with ${} syntax
21
+ * @param {string} text - The text to search
22
+ * @returns {Array<string>} Array of matched variables including ${}
23
+ */
24
+ export function findOutermostVariables(text: string): Array<string>;
25
+ //# sourceMappingURL=bracketMatcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bracketMatcher.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/bracketMatcher.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,0CANW,MAAM,aACN,MAAM,cACN,MAAM,WACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAiCzB;AAED;;;;;;;GAOG;AACH,oDALW,MAAM,aACN,MAAM,cACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAuBzB;AAED;;;;GAIG;AACH,6CAHW,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAIzB"}
@@ -0,0 +1,3 @@
1
+ declare function _exports(args: any): any;
2
+ export = _exports;
3
+ //# sourceMappingURL=formatFunctionArgs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatFunctionArgs.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/formatFunctionArgs.js"],"names":[],"mappings":"AAiBiB,0CAOhB"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Quote manipulation utilities for string handling
3
+ */
4
+ /**
5
+ * Removes surrounding quotes (single, double, or backtick) from a string
6
+ * @param {string} str - The string to trim
7
+ * @param {boolean} includeBackticks - Whether to also trim backticks (default: true)
8
+ * @returns {string} The trimmed string
9
+ */
10
+ export function trimSurroundingQuotes(str?: string, includeBackticks?: boolean): string;
11
+ /**
12
+ * Ensures a value (string or array of strings) has quotes around it
13
+ * @param {string|string[]} value - The value to quote
14
+ * @param {string} [open] - Opening quote character (default: '"')
15
+ * @param {string} [close] - Closing quote character (default: same as open)
16
+ * @returns {string|string[]} The quoted value(s)
17
+ */
18
+ export function ensureQuote(value: string | string[], open?: string, close?: string): string | string[];
19
+ /**
20
+ * Checks if a string is surrounded by matching quotes (single or double)
21
+ * @param {string} str - The string to check
22
+ * @returns {boolean} True if surrounded by matching quotes
23
+ */
24
+ export function isSurroundedByQuotes(str: string): boolean;
25
+ /**
26
+ * Checks if a string starts with a quoted value followed by a pipe
27
+ * @param {string} str - The string to check
28
+ * @returns {boolean} True if matches pattern like 'xyz' | or "xyz" |
29
+ */
30
+ export function startsWithQuotedPipe(str: string): boolean;
31
+ //# sourceMappingURL=quoteUtils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quoteUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/quoteUtils.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,4CAJW,MAAM,qBACN,OAAO,GACL,MAAM,CAYlB;AAsBD;;;;;;GAMG;AACH,mCALW,MAAM,GAAC,MAAM,EAAE,SACf,MAAM,UACN,MAAM,GACJ,MAAM,GAAC,MAAM,EAAE,CAa3B;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,OAAO,CAOnB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,OAAO,CAInB"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Replace all occurrences of a string while handling regex special characters
3
+ * @param {string} replaceThis - String to replace
4
+ * @param {string} withThis - Replacement string
5
+ * @param {string} inThis - Source string
6
+ * @returns {string} String with all replacements made
7
+ */
8
+ export function replaceAll(replaceThis: string, withThis: string, inThis: string): string;
9
+ //# sourceMappingURL=replaceAll.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replaceAll.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/replaceAll.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wCALW,MAAM,YACN,MAAM,UACN,MAAM,GACJ,MAAM,CAMlB"}
@@ -0,0 +1,2 @@
1
+ export function splitByComma(string: any, regexPattern: any): string[];
2
+ //# sourceMappingURL=splitByComma.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"splitByComma.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/splitByComma.js"],"names":[],"mappings":"AAiBA,uEAsFC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Split a string by comma while preserving quoted content
3
+ * NOTE: This is a simpler version that delegates to splitByComma for consistency.
4
+ * For advanced use cases with bracket depth tracking and regex protection, use splitByComma directly.
5
+ * @param {string} str - String to split
6
+ * @param {string} [splitter] - Optional custom splitter (defaults to ',')
7
+ * @returns {string[]} Array of split strings
8
+ */
9
+ export function splitCsv(str: string, splitter?: string): string[];
10
+ //# sourceMappingURL=splitCsv.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"splitCsv.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/splitCsv.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,8BAJW,MAAM,aACN,MAAM,GACJ,MAAM,EAAE,CA2BpB"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Get text after first occurrence of search string
3
+ * @param {string} str - Source string
4
+ * @param {string} search - String to search for
5
+ * @returns {string} Text after search string or empty string if not found
6
+ */
7
+ export function getTextAfterOccurrence(str: string, search: string): string;
8
+ /**
9
+ * Find nested variable in split array that exists in original source
10
+ * @param {string[]} split - Array of potential variables
11
+ * @param {string} originalSource - Original source string
12
+ * @returns {string|undefined} Found nested variable or undefined
13
+ */
14
+ export function findNestedVariable(split: string[], originalSource: string): string | undefined;
15
+ //# sourceMappingURL=textUtils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"textUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/strings/textUtils.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,4CAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAMlB;AAED;;;;;GAKG;AACH,0CAJW,MAAM,EAAE,kBACR,MAAM,GACJ,MAAM,GAAC,SAAS,CAS5B"}
@@ -0,0 +1,70 @@
1
+ declare const _exports: {
2
+ (text: TemplateStringsArray, ...placeholders: unknown[]): string;
3
+ (...text: unknown[]): string;
4
+ Instance: safeChalk.Instance;
5
+ level: safeChalk.Level;
6
+ hex(color: string): safeChalk.Chalk;
7
+ keyword(color: string): safeChalk.Chalk;
8
+ rgb(red: number, green: number, blue: number): safeChalk.Chalk;
9
+ hsl(hue: number, saturation: number, lightness: number): safeChalk.Chalk;
10
+ hsv(hue: number, saturation: number, value: number): safeChalk.Chalk;
11
+ hwb(hue: number, whiteness: number, blackness: number): safeChalk.Chalk;
12
+ ansi(code: number): safeChalk.Chalk;
13
+ ansi256(index: number): safeChalk.Chalk;
14
+ bgHex(color: string): safeChalk.Chalk;
15
+ bgKeyword(color: string): safeChalk.Chalk;
16
+ bgRgb(red: number, green: number, blue: number): safeChalk.Chalk;
17
+ bgHsl(hue: number, saturation: number, lightness: number): safeChalk.Chalk;
18
+ bgHsv(hue: number, saturation: number, value: number): safeChalk.Chalk;
19
+ bgHwb(hue: number, whiteness: number, blackness: number): safeChalk.Chalk;
20
+ bgAnsi(code: number): safeChalk.Chalk;
21
+ bgAnsi256(index: number): safeChalk.Chalk;
22
+ readonly reset: safeChalk.Chalk;
23
+ readonly bold: safeChalk.Chalk;
24
+ readonly dim: safeChalk.Chalk;
25
+ readonly italic: safeChalk.Chalk;
26
+ readonly underline: safeChalk.Chalk;
27
+ readonly inverse: safeChalk.Chalk;
28
+ readonly hidden: safeChalk.Chalk;
29
+ readonly strikethrough: safeChalk.Chalk;
30
+ readonly visible: safeChalk.Chalk;
31
+ readonly black: safeChalk.Chalk;
32
+ readonly red: safeChalk.Chalk;
33
+ readonly green: safeChalk.Chalk;
34
+ readonly yellow: safeChalk.Chalk;
35
+ readonly blue: safeChalk.Chalk;
36
+ readonly magenta: safeChalk.Chalk;
37
+ readonly cyan: safeChalk.Chalk;
38
+ readonly white: safeChalk.Chalk;
39
+ readonly gray: safeChalk.Chalk;
40
+ readonly grey: safeChalk.Chalk;
41
+ readonly blackBright: safeChalk.Chalk;
42
+ readonly redBright: safeChalk.Chalk;
43
+ readonly greenBright: safeChalk.Chalk;
44
+ readonly yellowBright: safeChalk.Chalk;
45
+ readonly blueBright: safeChalk.Chalk;
46
+ readonly magentaBright: safeChalk.Chalk;
47
+ readonly cyanBright: safeChalk.Chalk;
48
+ readonly whiteBright: safeChalk.Chalk;
49
+ readonly bgBlack: safeChalk.Chalk;
50
+ readonly bgRed: safeChalk.Chalk;
51
+ readonly bgGreen: safeChalk.Chalk;
52
+ readonly bgYellow: safeChalk.Chalk;
53
+ readonly bgBlue: safeChalk.Chalk;
54
+ readonly bgMagenta: safeChalk.Chalk;
55
+ readonly bgCyan: safeChalk.Chalk;
56
+ readonly bgWhite: safeChalk.Chalk;
57
+ readonly bgGray: safeChalk.Chalk;
58
+ readonly bgGrey: safeChalk.Chalk;
59
+ readonly bgBlackBright: safeChalk.Chalk;
60
+ readonly bgRedBright: safeChalk.Chalk;
61
+ readonly bgGreenBright: safeChalk.Chalk;
62
+ readonly bgYellowBright: safeChalk.Chalk;
63
+ readonly bgBlueBright: safeChalk.Chalk;
64
+ readonly bgMagentaBright: safeChalk.Chalk;
65
+ readonly bgCyanBright: safeChalk.Chalk;
66
+ readonly bgWhiteBright: safeChalk.Chalk;
67
+ };
68
+ export = _exports;
69
+ import safeChalk = require("safe-chalk");
70
+ //# sourceMappingURL=chalk.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chalk.d.ts","sourceRoot":"","sources":["../../../../src/utils/ui/chalk.js"],"names":[],"mappings":""}