@rzl-zone/build-tools 0.0.7 → 0.0.9

package/dist/index.d.cts

@@ -2,18 +2,18 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.7`
+*  Version: `0.0.9`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
 */
 
-import { a as OmitStrict, c as PrettifyOptions, r as DefaultPrettifyOptions, s as Prettify } from "./extra-2iX9E4Hj.cjs";
-import { n as generatePackageBanner, r as PackageJson, t as GeneratePackageBannerOptions } from "./index-B3VpO-fM.cjs";
-import { t as CommandIdentity } from "./index-BNJNsFwK.cjs";
-import { n as PatternOptions, t as PatternConfig } from "./fast-globe-options-BLHLcUA_.cjs";
-import * as acorn from "acorn";
+import { a as OmitStrict, c as PrettifyOptions, r as DefaultPrettifyOptions, s as Prettify } from "./extra-CsRmdXC4.cjs";
+import { n as generatePackageBanner, r as PackageJson, t as GeneratePackageBannerOptions } from "./index-TgjbNRWB.cjs";
+import { t as CommandIdentity } from "./index-xAz8brx-.cjs";
+import { n as PatternOptions, t as PatternConfig } from "./fast-globe-options-PH-bHWVK.cjs";
 import { ChildProcess, SpawnOptions, StdioOptions } from "node:child_process";
+import * as acorn from "acorn";
 
 /** ----------------------------------------------------------------
 * * ***Flexible input type for value collections.***
@@ -1417,157 +1417,6 @@ type NormalizeJsBuildNewlinesOptions = BaseOptions<typeof DEFAULT_NJBN_PATTERN_P
 */
 declare const normalizeJsBuildNewlines: (pattern: StringCollection, options?: NormalizeJsBuildNewlinesOptions) => Promise<void>;
 /** ----------------------------------------------------------------
-* * ***Default Pattern Policy for **strip js comments** operations.***
-* ----------------------------------------------------------------
-*
-* Defines the runtime behavior for pattern resolution used by:
-* - {@link stripJsComments | **`strip-js-comments`**}.
-*
-* @remarks
-* - `filesOnly`: Ensures only files are matched.
-* - `forceUnique`: Deduplicates matched results.
-*/
-declare const DEFAULT_SJC_PATTERN_POLICY: {
-  readonly filesOnly: true;
-  readonly forceUnique: true;
-};
-/** ----------------------------------------------------------------
-* * ***Resolved Pattern Options for **strip js comments** operations.***
-* ----------------------------------------------------------------
-*
-* Pattern options used by:
-* - {@link stripJsComments | **`strip-js-comments`**}.
-*/
-declare const resolvedSjcPatternOption: PatternOptions<true, true>;
-/** Command identity associated with {@link stripJsComments | **`strip-js-comments`**}. */
-declare const commandSjcIdentity: CommandIdentity;
-/** ----------------------------------------------------------------
-* * ***Configuration options for {@link stripJsComments | `strip-js-comment`}.***
-* ----------------------------------------------------------------
-*/
-type StripJsCommentsOptions = {
-  /** ----------------------------------------------------------------
-  * * ***Whether to remove `sourceMappingURL` comments.***
-  * ----------------------------------------------------------------
-  *
-  * @default false
-  */
-  removeSourceMap?: boolean;
-  /** ----------------------------------------------------------------
-  * * ***Whether to remove `region` comments.***
-  * ----------------------------------------------------------------
-  *
-  * @default true
-  */
-  removeRegion?: boolean;
-  /** ----------------------------------------------------------------
-  * * ***Parsing mode used when analyzing JavaScript code.***
-  * ----------------------------------------------------------------
-  *
-  * Determines how the source file should be interpreted by the parser.
-  * This affects strict mode behavior and how `import` / `export`
-  * statements are handled.
-  *
-  *
-  * Possible values:
-  *
-  * - `"module"` **(default)** ➔ Parse as an ES module.
-  * - `"script"` ➔ Parse as a classic script.
-  * - `"commonjs"` ➔ Parse using CommonJS semantics.
-  *
-  * ----------------------------------------------------------------
-  *
-  *  ⚠️ Fallback to default, is invalid input.
-  *
-  *
-  * @default "module"
-  *
-  */
-  sourceType?: acorn.Options["sourceType"];
-  /** ----------------------------------------------------------------
-  * * ***ECMAScript version used for parsing.***
-  * ----------------------------------------------------------------
-  *
-  * Specifies the ECMAScript syntax version supported by the parser.
-  * This determines which language features are recognized during parsing.
-  *
-  * Examples:
-  *
-  * - `5` ➔ ES5
-  * - `2020` ➔ ES2020
-  * - `"latest"` ➔ Latest supported version
-  *
-  * ----------------------------------------------------------------
-  *
-  * ⚠️ Invalid values will fallback to the default behavior.
-  *
-  * @default "latest"
-  */
-  ecmaVersion?: acorn.ecmaVersion;
-} & BaseOptions<typeof DEFAULT_SJC_PATTERN_POLICY.filesOnly, typeof DEFAULT_SJC_PATTERN_POLICY.forceUnique>;
-/** ----------------------------------------------------------------
-* * ***Strip comments from JavaScript output files.***
-* ----------------------------------------------------------------
-*
-* Scans files matching the provided glob pattern(s) and removes
-* non-essential comments from JavaScript output.
-*
-* The process preserves important comments such as:
-*
-* - `/*! ... *\/` (bang / license comments)
-* - `@license`
-* - `@preserve`
-* - `@copyright`
-* - `@cc_on`
-* - `@__PURE__`
-* - `@__INLINE__`
-* - `@__NOINLINE__`
-* - `@__NO_SIDE_EFFECTS__`
-*
-* unless explicitly overridden by the `@removeDocRuntime` directive.
-*
-* ----------------------------------------------------------------
-*
-* **Supported Features**
-*
-* - Removes regular block comments from compiled JS files.
-* - Optionally removes `sourceMappingURL` comments.
-* - Optionally removes `region` comments such as:
-*    - `// #region`
-*    - `// #endregion`
-* - Supports runtime directives inside comments:
-*    - `@keepDocRuntime`
-*    - `@removeDocRuntime`
-*
-* ----------------------------------------------------------------
-*
-* @param pattern - Glob pattern(s) or a set of patterns pointing to
-* files whose comments should be stripped.
-*
-* @param options - Optional configuration controlling how comments
-* are removed.
-*
-* ----------------------------------------------------------------
-*
-* @example
-* ```ts
-* await stripJsComments("dist/**\/*.js");
-* ```
-*
-* @example
-* ```ts
-* await stripJsComments(["dist/**\/*.js", "build/**\/*.mjs"], {
-*   removeSourceMap: true,
-*   removeRegion: true
-* });
-* ```
-*
-* ----------------------------------------------------------------
-*
-* @removeDocRuntime
-*/
-declare const stripJsComments: (pattern: StringCollection, options?: StripJsCommentsOptions) => Promise<void>;
-/** ----------------------------------------------------------------
 * * ***Base Options for `runCommand` or `runCommandCapture`.***
 * ----------------------------------------------------------------
 */
@@ -2189,5 +2038,156 @@ type RunCommandOptions = BaseRunCommandOptions;
 declare function runCommand(command: string, args: readonly string[]): Promise<ChildProcess>;
 declare function runCommand(command: string, options: RunCommandOptions): Promise<ChildProcess>;
 declare function runCommand(command: string, args: readonly string[], options: RunCommandOptions): Promise<ChildProcess>;
+/** ----------------------------------------------------------------
+* * ***Default Pattern Policy for **strip js comments** operations.***
+* ----------------------------------------------------------------
+*
+* Defines the runtime behavior for pattern resolution used by:
+* - {@link stripJsComments | **`strip-js-comments`**}.
+*
+* @remarks
+* - `filesOnly`: Ensures only files are matched.
+* - `forceUnique`: Deduplicates matched results.
+*/
+declare const DEFAULT_SJC_PATTERN_POLICY: {
+  readonly filesOnly: true;
+  readonly forceUnique: true;
+};
+/** ----------------------------------------------------------------
+* * ***Resolved Pattern Options for **strip js comments** operations.***
+* ----------------------------------------------------------------
+*
+* Pattern options used by:
+* - {@link stripJsComments | **`strip-js-comments`**}.
+*/
+declare const resolvedSjcPatternOption: PatternOptions<true, true>;
+/** Command identity associated with {@link stripJsComments | **`strip-js-comments`**}. */
+declare const commandSjcIdentity: CommandIdentity;
+/** ----------------------------------------------------------------
+* * ***Configuration options for {@link stripJsComments | `strip-js-comment`}.***
+* ----------------------------------------------------------------
+*/
+type StripJsCommentsOptions = {
+  /** ----------------------------------------------------------------
+  * * ***Whether to remove `sourceMappingURL` comments.***
+  * ----------------------------------------------------------------
+  *
+  * @default false
+  */
+  removeSourceMap?: boolean;
+  /** ----------------------------------------------------------------
+  * * ***Whether to remove `region` comments.***
+  * ----------------------------------------------------------------
+  *
+  * @default true
+  */
+  removeRegion?: boolean;
+  /** ----------------------------------------------------------------
+  * * ***Parsing mode used when analyzing JavaScript code.***
+  * ----------------------------------------------------------------
+  *
+  * Determines how the source file should be interpreted by the parser.
+  * This affects strict mode behavior and how `import` / `export`
+  * statements are handled.
+  *
+  *
+  * Possible values:
+  *
+  * - `"module"` **(default)** ➔ Parse as an ES module.
+  * - `"script"` ➔ Parse as a classic script.
+  * - `"commonjs"` ➔ Parse using CommonJS semantics.
+  *
+  * ----------------------------------------------------------------
+  *
+  *  ⚠️ Fallback to default, is invalid input.
+  *
+  *
+  * @default "module"
+  *
+  */
+  sourceType?: acorn.Options["sourceType"];
+  /** ----------------------------------------------------------------
+  * * ***ECMAScript version used for parsing.***
+  * ----------------------------------------------------------------
+  *
+  * Specifies the ECMAScript syntax version supported by the parser.
+  * This determines which language features are recognized during parsing.
+  *
+  * Examples:
+  *
+  * - `5` ➔ ES5
+  * - `2020` ➔ ES2020
+  * - `"latest"` ➔ Latest supported version
+  *
+  * ----------------------------------------------------------------
+  *
+  * ⚠️ Invalid values will fallback to the default behavior.
+  *
+  * @default "latest"
+  */
+  ecmaVersion?: acorn.ecmaVersion;
+} & BaseOptions<typeof DEFAULT_SJC_PATTERN_POLICY.filesOnly, typeof DEFAULT_SJC_PATTERN_POLICY.forceUnique>;
+/** ----------------------------------------------------------------
+* * ***Strip comments from JavaScript output files.***
+* ----------------------------------------------------------------
+*
+* Scans files matching the provided glob pattern(s) and removes
+* non-essential comments from JavaScript output.
+*
+* The process preserves important comments such as:
+*
+* - `/*! ... *\/` (bang / license comments)
+* - `@license`
+* - `@preserve`
+* - `@copyright`
+* - `@cc_on`
+* - `@__PURE__`
+* - `@__INLINE__`
+* - `@__NOINLINE__`
+* - `@__NO_SIDE_EFFECTS__`
+*
+* unless explicitly overridden by the `@removeDocRuntime` directive.
+*
+* ----------------------------------------------------------------
+*
+* **Supported Features**
+*
+* - Removes regular block comments from compiled JS files.
+* - Optionally removes `sourceMappingURL` comments.
+* - Optionally removes `region` comments such as:
+*    - `// #region`
+*    - `// #endregion`
+* - Supports runtime directives inside comments:
+*    - `@keepDocRuntime`
+*    - `@removeDocRuntime`
+*
+* ----------------------------------------------------------------
+*
+* @param pattern - Glob pattern(s) or a set of patterns pointing to
+* files whose comments should be stripped.
+*
+* @param options - Optional configuration controlling how comments
+* are removed.
+*
+* ----------------------------------------------------------------
+*
+* @example
+* ```ts
+* await stripJsComments("dist/**\/*.js");
+* ```
+*
+* @example
+* ```ts
+* await stripJsComments(["dist/**\/*.js", "build/**\/*.mjs"], {
+*   removeSourceMap: true,
+*   removeRegion: true
+* });
+* ```
+*
+* ----------------------------------------------------------------
+*
+* @removeDocRuntime
+*/
+declare const stripJsComments: (pattern: StringCollection, options?: StripJsCommentsOptions) => Promise<void>;
 export { type BaseOptions, type CleanJsArtifactsOptions, type CleanTypesArtifactsOptions, type Collection, CommandProcessError, type CopyFileToDestOptions, type CopyFileToDestParam, DEFAULT_CLEAN_PATTERN_POLICY, DEFAULT_ECI_PATTERN_POLICY, DEFAULT_EFN_PATTERN_POLICY, DEFAULT_GRI_PATTERN_POLICY, DEFAULT_IB_PATTERN_POLICY, DEFAULT_ID_PATTERN_POLICY, DEFAULT_NJBN_PATTERN_POLICY, DEFAULT_SJC_PATTERN_POLICY, type EnsureCssImportOptions, type EnsureFinalNewlineOptions, type GeneratePackageBannerOptions, type GenerateReferenceOptions, type GetPackageJsonOptions, type InjectBannerOptions, type InjectDirectiveOptions, type InternalOptions, type LogLevel, type LoggingOptions, type NormalizeJsBuildNewlinesOptions, type PatternConfig, type PatternOptions, type RunCommandCaptureOptions, type RunCommandCaptureResult, type RunCommandOptions, type StringCollection, type StripJsCommentsOptions, cleanJsBuildArtifacts, cleanTypesBuildArtifacts, commandCftdIdentity, commandCjbaIdentity, commandCtbaIdentity, commandEciIdentity, commandEfnIdentity, commandGriIdentity, commandIbIdentity, commandIdIdentity, commandNjbnIdentity, commandSjcIdentity, copyFileToDest, createCopyFileToDestParameterSet, ensureCssImport, ensureFinalNewline, generatePackageBanner, generateReferenceIndex, getPackageJson, injectBanner, injectDirective, isCommandProcessError, normalizeJsBuildNewlines, resolvedCleanPatternOption, resolvedEciPatternOption, resolvedEfnPatternOption, resolvedGriPatternOption, resolvedIbPatternOption, resolvedIdPatternOption, resolvedNjbnPatternOption, resolvedSjcPatternOption, runCommand, runCommandCapture, stripJsComments };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -2,18 +2,18 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.7`
+*  Version: `0.0.9`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
 */
 
-import { a as OmitStrict, c as PrettifyOptions, r as DefaultPrettifyOptions, s as Prettify } from "./extra-DY59MRMZ.js";
-import { n as generatePackageBanner, r as PackageJson, t as GeneratePackageBannerOptions } from "./index-CNjsgh1e.js";
-import { t as CommandIdentity } from "./index-CQatHoCR.js";
-import { n as PatternOptions, t as PatternConfig } from "./fast-globe-options-ClsKhWod.js";
-import * as acorn from "acorn";
+import { a as OmitStrict, c as PrettifyOptions, r as DefaultPrettifyOptions, s as Prettify } from "./extra-DxvrBev9.js";
+import { n as generatePackageBanner, r as PackageJson, t as GeneratePackageBannerOptions } from "./index-Dvmmz0f_.js";
+import { t as CommandIdentity } from "./index-B1t7Xs3T.js";
+import { n as PatternOptions, t as PatternConfig } from "./fast-globe-options-Cz8KJqKc.js";
 import { ChildProcess, SpawnOptions, StdioOptions, spawn } from "node:child_process";
+import * as acorn from "acorn";
 
 /** ----------------------------------------------------------------
 * * ***Flexible input type for value collections.***
@@ -1417,157 +1417,6 @@ type NormalizeJsBuildNewlinesOptions = BaseOptions<typeof DEFAULT_NJBN_PATTERN_P
 */
 declare const normalizeJsBuildNewlines: (pattern: StringCollection, options?: NormalizeJsBuildNewlinesOptions) => Promise<void>;
 /** ----------------------------------------------------------------
-* * ***Default Pattern Policy for **strip js comments** operations.***
-* ----------------------------------------------------------------
-*
-* Defines the runtime behavior for pattern resolution used by:
-* - {@link stripJsComments | **`strip-js-comments`**}.
-*
-* @remarks
-* - `filesOnly`: Ensures only files are matched.
-* - `forceUnique`: Deduplicates matched results.
-*/
-declare const DEFAULT_SJC_PATTERN_POLICY: {
-  readonly filesOnly: true;
-  readonly forceUnique: true;
-};
-/** ----------------------------------------------------------------
-* * ***Resolved Pattern Options for **strip js comments** operations.***
-* ----------------------------------------------------------------
-*
-* Pattern options used by:
-* - {@link stripJsComments | **`strip-js-comments`**}.
-*/
-declare const resolvedSjcPatternOption: PatternOptions<true, true>;
-/** Command identity associated with {@link stripJsComments | **`strip-js-comments`**}. */
-declare const commandSjcIdentity: CommandIdentity;
-/** ----------------------------------------------------------------
-* * ***Configuration options for {@link stripJsComments | `strip-js-comment`}.***
-* ----------------------------------------------------------------
-*/
-type StripJsCommentsOptions = {
-  /** ----------------------------------------------------------------
-  * * ***Whether to remove `sourceMappingURL` comments.***
-  * ----------------------------------------------------------------
-  *
-  * @default false
-  */
-  removeSourceMap?: boolean;
-  /** ----------------------------------------------------------------
-  * * ***Whether to remove `region` comments.***
-  * ----------------------------------------------------------------
-  *
-  * @default true
-  */
-  removeRegion?: boolean;
-  /** ----------------------------------------------------------------
-  * * ***Parsing mode used when analyzing JavaScript code.***
-  * ----------------------------------------------------------------
-  *
-  * Determines how the source file should be interpreted by the parser.
-  * This affects strict mode behavior and how `import` / `export`
-  * statements are handled.
-  *
-  *
-  * Possible values:
-  *
-  * - `"module"` **(default)** ➔ Parse as an ES module.
-  * - `"script"` ➔ Parse as a classic script.
-  * - `"commonjs"` ➔ Parse using CommonJS semantics.
-  *
-  * ----------------------------------------------------------------
-  *
-  *  ⚠️ Fallback to default, is invalid input.
-  *
-  *
-  * @default "module"
-  *
-  */
-  sourceType?: acorn.Options["sourceType"];
-  /** ----------------------------------------------------------------
-  * * ***ECMAScript version used for parsing.***
-  * ----------------------------------------------------------------
-  *
-  * Specifies the ECMAScript syntax version supported by the parser.
-  * This determines which language features are recognized during parsing.
-  *
-  * Examples:
-  *
-  * - `5` ➔ ES5
-  * - `2020` ➔ ES2020
-  * - `"latest"` ➔ Latest supported version
-  *
-  * ----------------------------------------------------------------
-  *
-  * ⚠️ Invalid values will fallback to the default behavior.
-  *
-  * @default "latest"
-  */
-  ecmaVersion?: acorn.ecmaVersion;
-} & BaseOptions<typeof DEFAULT_SJC_PATTERN_POLICY.filesOnly, typeof DEFAULT_SJC_PATTERN_POLICY.forceUnique>;
-/** ----------------------------------------------------------------
-* * ***Strip comments from JavaScript output files.***
-* ----------------------------------------------------------------
-*
-* Scans files matching the provided glob pattern(s) and removes
-* non-essential comments from JavaScript output.
-*
-* The process preserves important comments such as:
-*
-* - `/*! ... *\/` (bang / license comments)
-* - `@license`
-* - `@preserve`
-* - `@copyright`
-* - `@cc_on`
-* - `@__PURE__`
-* - `@__INLINE__`
-* - `@__NOINLINE__`
-* - `@__NO_SIDE_EFFECTS__`
-*
-* unless explicitly overridden by the `@removeDocRuntime` directive.
-*
-* ----------------------------------------------------------------
-*
-* **Supported Features**
-*
-* - Removes regular block comments from compiled JS files.
-* - Optionally removes `sourceMappingURL` comments.
-* - Optionally removes `region` comments such as:
-*    - `// #region`
-*    - `// #endregion`
-* - Supports runtime directives inside comments:
-*    - `@keepDocRuntime`
-*    - `@removeDocRuntime`
-*
-* ----------------------------------------------------------------
-*
-* @param pattern - Glob pattern(s) or a set of patterns pointing to
-* files whose comments should be stripped.
-*
-* @param options - Optional configuration controlling how comments
-* are removed.
-*
-* ----------------------------------------------------------------
-*
-* @example
-* ```ts
-* await stripJsComments("dist/**\/*.js");
-* ```
-*
-* @example
-* ```ts
-* await stripJsComments(["dist/**\/*.js", "build/**\/*.mjs"], {
-*   removeSourceMap: true,
-*   removeRegion: true
-* });
-* ```
-*
-* ----------------------------------------------------------------
-*
-* @removeDocRuntime
-*/
-declare const stripJsComments: (pattern: StringCollection, options?: StripJsCommentsOptions) => Promise<void>;
-/** ----------------------------------------------------------------
 * * ***Base Options for `runCommand` or `runCommandCapture`.***
 * ----------------------------------------------------------------
 */
@@ -2189,5 +2038,156 @@ type RunCommandOptions = BaseRunCommandOptions;
 declare function runCommand(command: string, args: readonly string[]): Promise<ChildProcess>;
 declare function runCommand(command: string, options: RunCommandOptions): Promise<ChildProcess>;
 declare function runCommand(command: string, args: readonly string[], options: RunCommandOptions): Promise<ChildProcess>;
+/** ----------------------------------------------------------------
+* * ***Default Pattern Policy for **strip js comments** operations.***
+* ----------------------------------------------------------------
+*
+* Defines the runtime behavior for pattern resolution used by:
+* - {@link stripJsComments | **`strip-js-comments`**}.
+*
+* @remarks
+* - `filesOnly`: Ensures only files are matched.
+* - `forceUnique`: Deduplicates matched results.
+*/
+declare const DEFAULT_SJC_PATTERN_POLICY: {
+  readonly filesOnly: true;
+  readonly forceUnique: true;
+};
+/** ----------------------------------------------------------------
+* * ***Resolved Pattern Options for **strip js comments** operations.***
+* ----------------------------------------------------------------
+*
+* Pattern options used by:
+* - {@link stripJsComments | **`strip-js-comments`**}.
+*/
+declare const resolvedSjcPatternOption: PatternOptions<true, true>;
+/** Command identity associated with {@link stripJsComments | **`strip-js-comments`**}. */
+declare const commandSjcIdentity: CommandIdentity;
+/** ----------------------------------------------------------------
+* * ***Configuration options for {@link stripJsComments | `strip-js-comment`}.***
+* ----------------------------------------------------------------
+*/
+type StripJsCommentsOptions = {
+  /** ----------------------------------------------------------------
+  * * ***Whether to remove `sourceMappingURL` comments.***
+  * ----------------------------------------------------------------
+  *
+  * @default false
+  */
+  removeSourceMap?: boolean;
+  /** ----------------------------------------------------------------
+  * * ***Whether to remove `region` comments.***
+  * ----------------------------------------------------------------
+  *
+  * @default true
+  */
+  removeRegion?: boolean;
+  /** ----------------------------------------------------------------
+  * * ***Parsing mode used when analyzing JavaScript code.***
+  * ----------------------------------------------------------------
+  *
+  * Determines how the source file should be interpreted by the parser.
+  * This affects strict mode behavior and how `import` / `export`
+  * statements are handled.
+  *
+  *
+  * Possible values:
+  *
+  * - `"module"` **(default)** ➔ Parse as an ES module.
+  * - `"script"` ➔ Parse as a classic script.
+  * - `"commonjs"` ➔ Parse using CommonJS semantics.
+  *
+  * ----------------------------------------------------------------
+  *
+  *  ⚠️ Fallback to default, is invalid input.
+  *
+  *
+  * @default "module"
+  *
+  */
+  sourceType?: acorn.Options["sourceType"];
+  /** ----------------------------------------------------------------
+  * * ***ECMAScript version used for parsing.***
+  * ----------------------------------------------------------------
+  *
+  * Specifies the ECMAScript syntax version supported by the parser.
+  * This determines which language features are recognized during parsing.
+  *
+  * Examples:
+  *
+  * - `5` ➔ ES5
+  * - `2020` ➔ ES2020
+  * - `"latest"` ➔ Latest supported version
+  *
+  * ----------------------------------------------------------------
+  *
+  * ⚠️ Invalid values will fallback to the default behavior.
+  *
+  * @default "latest"
+  */
+  ecmaVersion?: acorn.ecmaVersion;
+} & BaseOptions<typeof DEFAULT_SJC_PATTERN_POLICY.filesOnly, typeof DEFAULT_SJC_PATTERN_POLICY.forceUnique>;
+/** ----------------------------------------------------------------
+* * ***Strip comments from JavaScript output files.***
+* ----------------------------------------------------------------
+*
+* Scans files matching the provided glob pattern(s) and removes
+* non-essential comments from JavaScript output.
+*
+* The process preserves important comments such as:
+*
+* - `/*! ... *\/` (bang / license comments)
+* - `@license`
+* - `@preserve`
+* - `@copyright`
+* - `@cc_on`
+* - `@__PURE__`
+* - `@__INLINE__`
+* - `@__NOINLINE__`
+* - `@__NO_SIDE_EFFECTS__`
+*
+* unless explicitly overridden by the `@removeDocRuntime` directive.
+*
+* ----------------------------------------------------------------
+*
+* **Supported Features**
+*
+* - Removes regular block comments from compiled JS files.
+* - Optionally removes `sourceMappingURL` comments.
+* - Optionally removes `region` comments such as:
+*    - `// #region`
+*    - `// #endregion`
+* - Supports runtime directives inside comments:
+*    - `@keepDocRuntime`
+*    - `@removeDocRuntime`
+*
+* ----------------------------------------------------------------
+*
+* @param pattern - Glob pattern(s) or a set of patterns pointing to
+* files whose comments should be stripped.
+*
+* @param options - Optional configuration controlling how comments
+* are removed.
+*
+* ----------------------------------------------------------------
+*
+* @example
+* ```ts
+* await stripJsComments("dist/**\/*.js");
+* ```
+*
+* @example
+* ```ts
+* await stripJsComments(["dist/**\/*.js", "build/**\/*.mjs"], {
+*   removeSourceMap: true,
+*   removeRegion: true
+* });
+* ```
+*
+* ----------------------------------------------------------------
+*
+* @removeDocRuntime
+*/
+declare const stripJsComments: (pattern: StringCollection, options?: StripJsCommentsOptions) => Promise<void>;
 export { type BaseOptions, type CleanJsArtifactsOptions, type CleanTypesArtifactsOptions, type Collection, CommandProcessError, type CopyFileToDestOptions, type CopyFileToDestParam, DEFAULT_CLEAN_PATTERN_POLICY, DEFAULT_ECI_PATTERN_POLICY, DEFAULT_EFN_PATTERN_POLICY, DEFAULT_GRI_PATTERN_POLICY, DEFAULT_IB_PATTERN_POLICY, DEFAULT_ID_PATTERN_POLICY, DEFAULT_NJBN_PATTERN_POLICY, DEFAULT_SJC_PATTERN_POLICY, type EnsureCssImportOptions, type EnsureFinalNewlineOptions, type GeneratePackageBannerOptions, type GenerateReferenceOptions, type GetPackageJsonOptions, type InjectBannerOptions, type InjectDirectiveOptions, type InternalOptions, type LogLevel, type LoggingOptions, type NormalizeJsBuildNewlinesOptions, type PatternConfig, type PatternOptions, type RunCommandCaptureOptions, type RunCommandCaptureResult, type RunCommandOptions, type StringCollection, type StripJsCommentsOptions, cleanJsBuildArtifacts, cleanTypesBuildArtifacts, commandCftdIdentity, commandCjbaIdentity, commandCtbaIdentity, commandEciIdentity, commandEfnIdentity, commandGriIdentity, commandIbIdentity, commandIdIdentity, commandNjbnIdentity, commandSjcIdentity, copyFileToDest, createCopyFileToDestParameterSet, ensureCssImport, ensureFinalNewline, generatePackageBanner, generateReferenceIndex, getPackageJson, injectBanner, injectDirective, isCommandProcessError, normalizeJsBuildNewlines, resolvedCleanPatternOption, resolvedEciPatternOption, resolvedEfnPatternOption, resolvedGriPatternOption, resolvedIbPatternOption, resolvedIdPatternOption, resolvedNjbnPatternOption, resolvedSjcPatternOption, runCommand, runCommandCapture, stripJsComments };
 //# sourceMappingURL=index.d.ts.map