js-dev-tool 1.0.14 → 1.0.16

package/README.md

@@ -37,12 +37,13 @@ rws help: (R)ecord(W)ebpack(S)ize
     dest     - if not specified then apply "./logs/webpack-size.json"
 
 cjbm help: (C)onvert (J)S to (B)rowser (M)odule
-  ex - jstool -cmd cjbm [-root ./build | -basePath "./dist/esm,extra-tests/mini-semaphore"] [-ext js] [-targets "['core.js', 'object.js']"]
+  ex - jstool -cmd cjbm [-root ./build | -basePath "./dist/esm,extra-tests/mini-semaphore"] [-ext js] [-test /\.js$/] [-targets "['core.js', 'object.js']"]
   note:
     root     - Recursively searches for files.
                This option is useful, but if there are directories that need to be avoided, use the 'basePath' option
     basePath - can be "<path>,<path>,..." (array type arg)
     ext      - specifies the module extension for import clauses. default is "js"
+    test     - Any file extension can be specified. (The default is /\.js$/)
     targets  - specify this if you want to apply it only to a specific file.
                the file specified here should be directly under `basePath`!
                value must be array type arg, "['<path>', '<path>',...]" or "<path>,<path>,..."
@@ -75,12 +76,15 @@ minify help: jstool -cmd minify -basePath extra-tests/web/mini-semaphore [-test
     test     - can be omit, default is `/\.js$/`
     suffix   - can be omit, default is ".mini"
 
-rmc help: $ jstool -cmd rmc -basePath "./dist/cjs,./dist/cjs/gulp" -test "/\.(js|d\.ts)$/"
+rmc help: $ jstool -cmd rmc [-rmc4ts[:keepBangLine]] -basePath "./dist/cjs,./dist/cjs/gulp" -test "/\.(js|d\.ts)$/"
   note: basePath - can be "<path>,<path>,..." (array type arg)
-    test     - can be omit, defulat `/.js$/`
-    rmc4ts   - for typescript source.
+    test  - can be omit, defulat `/.js$/`
+    rmc4ts- for typescript source.
       keep comment that start with "/*" when "*/" end mark appears in same line.
       if start with "/*-" remove it
+    rmc4ts=keepBangLine (2025/12/24)
+          - In addition to the "rmc4ts" processing, it also preserves line comments that start with "//!".
+
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "bin": {
     "jstool": "tools.js"
   },

package/regex.d.ts

@@ -8,14 +8,49 @@
 /**
  * @file js-dev-scripts/regex.d.ts
  */
+declare global {
+  interface RegExp/* extends TypedRegExp<string, string>*/ {
+    /**
+     * Executes a search on a string using a regular expression pattern, and returns an array containing the results of that search.
+     * @param string The String object or string literal on which to perform the search.
+     */
+    exec<const P extends string, const F extends string = "">(this: TypedRegExp<P, F>, string: string): RegExpExecArrayFixed< this > | null;
+  }
+  interface RegExpConstructor {
+    new <const P extends string, const F extends string = "">(pattern: P, flags?: F): RegExp & {
+      readonly source: P;
+      readonly flags: F;
+    };
+    <const P extends string, const F extends string = "">(pattern: P, flags?: F): RegExp & {
+      readonly source: P;
+      readonly flags: F;
+    };
+    readonly "prototype": RegExp;
+  }
+}
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//                                   Basics
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
 /**
  * Extracts the literal type from the source property of a RegExp.
  * @template R - A RegExp type.
  */
 export type ReSource<R extends RegExp> = R extends RegExp & { readonly source: infer T } ? T : never;
-export declare function createRegExp<P extends string>(pattern: P, flags?: string): RegExp & {
+export type TypedRegExp<const P extends string, const F extends string = ""> = RegExp & {
   readonly source: P;
+  readonly flags: F;
 };
+export declare function createRegExp<
+  const P extends string,
+  const F extends string = ""
+>(pattern: P, flags?: F): TypedRegExp<P, F>;
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//                            Named Capture Groups
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
 type FirstChar<S extends string> = S extends `${infer F}${infer _}` ? F : never;
 /**
  * Recursively extracts parts that match the format (?<GroupName>...) from a string pattern,
@@ -34,41 +69,43 @@ export type ExtractGroupNames<S extends string> =
  * Creates an object type with keys as the extracted group names and values as strings.
  * If no groups are found, it results in an empty object.
  * @template R - A RegExp type.
+ * @date 2025/12/24 14:46:30 - It may be possible to extract the group name accurately (?)
  */
-export type ReGroups<R extends RegExp> = {
-  [K in ExtractGroupNames<ReSource<R>>]?: string;
-};
-export type PreprocessEscapes<S extends string, Result extends string = ""> =
+export type ReGroups<R extends RegExp> = R extends (/*RegExp &*/ { readonly source: infer T })
+ ? {
+  [K in ExtractGroupNames<T>]?: string;
+} : never;
+/**
+ * Preprocesses escape sequences in a string pattern by replacing escaped backslashes and characters.
+ * 
+ * + NOTE: This type is used to preprocess the pattern string before counting capture groups.
+ * 
+ * @template S - A string pattern.
+ * @template Result - The resulting string after preprocessing. 
+ * @internal
+ */
+export type __PreprocessEscapes<S extends string, Result extends string = ""> =
   S extends `\\\\${infer Rest}`
-    ? PreprocessEscapes<Rest, `${Result}__`>
+    ? __PreprocessEscapes<Rest, `${Result}__`>
     : S extends `\\${infer Next}${infer Rest}`
-      ? PreprocessEscapes<Rest, `${Result}_`>
+      ? __PreprocessEscapes<Rest, `${Result}_!`>
       : S extends `${infer Char}${infer Rest}`
-        ? PreprocessEscapes<Rest, `${Result}${Char}`>
+        ? __PreprocessEscapes<Rest, `${Result}${Char}`>
         : Result;
 /**
  * Counts the exact number of capture groups in a string pattern.
  * @template S - A string pattern.
  * @template Counter - An array used to count the capture groups.
- * 
- * @todo FIXME: 多く count してしまう場合あり. 2025/3/18 15:47:57
- * @deprecated text base の parse には限界があり cost が見合わないので、この type は将来削除予定!
  */
 export type CountCaptureGroups<
   S extends string,
   Counter extends unknown[] = []
 > =
-  S extends `${infer _Before}(${infer Rest}`
-    ? _Before extends "\\"
-      ? never
-      : Rest extends `?:${infer After}`
-        | `?=${infer After}`
-        | `?!${infer After}`
-        | `?<=${infer After}`
-        | `?<!${infer After}`
-        ? CountCaptureGroups<After, Counter>
+  __PreprocessEscapes<S> extends `${infer _Before}(${infer Rest}`
+    ? Rest extends `${"?:" | "?=" | "?!" | "?<=" | "?<!"}${infer After}`
+      ? CountCaptureGroups<After, Counter>
       : CountCaptureGroups<Rest, [...Counter, unknown]>
-    : Counter['length'];
+    : Counter["length"];
 /**
  * Represents a fixed version of RegExpExecArray that includes the matched string,
  * captures, and optionally named groups.
@@ -79,20 +116,31 @@ export type CountCaptureGroups<
 export type RegExpExecArrayFixed<
   R extends RegExp,
   S extends ReSource<R> = ReSource<R>,
-  GroupCount extends number = CountCaptureGroups<
-    PreprocessEscapes<S>
-  >
-> = [match: string, ...ExtractCaptures<GroupCount>] & {
+  GroupCount extends number = CountCaptureGroups<S>
+> = [match: string, ...BuildCaptureTuple<GroupCount>] & {
   groups?: ReGroups<R>;
+  index: number;
+  input: string;
 };
+export type TupleOf<
+  Count extends number, ArrayType,
+  Result extends ArrayType[] = []
+> = Result["length"] extends Count
+  ? Result
+  : TupleOf<Count, ArrayType, [...Result, ArrayType]>;
 /**
- * Generates an array type with a length corresponding to the number of capture groups.
- * @template Count - The number of capture groups.
- * @template Result - The resulting array type.
+ * Builds a tuple type whose length equals the number of capture groups.
+ * @template Count - Number of capture groups.
+ * @template Result - Accumulator (internal).
  */
-export type ExtractCaptures<Count extends number, Result extends unknown[] = []> =
-  Result['length'] extends Count
-    ? Result : ExtractCaptures<Count, [...Result, string]>;
+export type BuildCaptureTuple<
+  Count extends number, ArrayType = string,
+> = TupleOf<Count, ArrayType>;
+/*!
+// ============================================================================
+//                          Helper Types for Replacer
+// ============================================================================
+*/
 /**
  * Creates the parameter types for String.replace callback function.
  * 
@@ -103,12 +151,10 @@ export type ExtractCaptures<Count extends number, Result extends unknown[] = []>
 export type ReplaceCallbackParams<
   R extends RegExp,
   S extends ReSource<R> = ReSource<R>,
-  GroupCount extends number = CountCaptureGroups<
-    PreprocessEscapes<S>
-  >
+  GroupCount extends number = CountCaptureGroups<S>
 > = [
   match: string,
-  ...captures: ExtractCaptures<GroupCount>,
+  ...captures: BuildCaptureTuple<GroupCount>,
   offset: number,
   input: string,
   groups: ReGroups<R>

package/scripts/publish-version.json

@@ -1,3 +1,3 @@
 {
-  "version": "1.0.14"
+  "version": "1.0.16"
 }

package/tool-lib/cjbm.js

@@ -6,49 +6,32 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="./tools.d.ts"/>
-/// <reference path="../regex.d.ts"/>
 // @ts-check
 /**
  * @file (C)onvert (J)S to (B)rowser (M)odule
  */
 const fs = require("fs");
 const path = require("path");
-const RE_TEXT = String.raw`
-# NOTE: PCRE での検証時は line comment assertion を (?<!\/\/|\/\/\s)(?:(?<!@)import|export) とすること (regex101.com)
-# 正しくは: (?<!\s*\/\/+.*?)(?:(?<!@)import|export)
-(?<!\s*\/\/+.*?)(?:(?<!@)import|export)
-\s*
-(?:
-  # 2025/12/22 14:57:44 - support quote character detection ["']
-  # global import, import "./"; import './global.mjs';
-  (?<qcGlobal>["'])(?!https?:)(?=[.\/]+)(?:
-    (?<globalName>(?:[.\/]+)?[^'"]+?)(?:\.(?<globalExt>(?:c|m)?jsx?))?
-  )\k<qcGlobal>|
-  # dynamic import, import("...") import('...')
-  \(\s*
-    (?<qcDynamic>["'])(?!https?:)(?=[.\/]+)(?<dynamicName>(?:[.\/]+)?[^'"]+?)(?:\.(?<dynamicExt>(?:c|m)?jsx?))?\k<qcDynamic>
-  \s*\)|
-  # esm import/export
-  (?:(?<clause>.+?|(?:\w+\s*,)?\s*\{[^}]+\})\s*from)\s*
-    (?<qcEsm>["'])(?!https?:)(?=[.\/]+)
-    (?:
-      (?<moduleName>(?:[.\/]+)?[^'"]+?)(?:\.(?<moduleExt>(?:c|m)?jsx?))?
-    )\k<qcEsm>
-)
-(?=\s*;)?
-`;
 /**
- * @date 2025/12/22 16:09:36
- * @see https://regex101.com/r/uMMsD4/31
+ * @type {typeof XRegex.createRegExp}
  */
-const reImportExportDetection = new RegExp(
-  RE_TEXT.replace(/\s*\(\?\#.*\)\s*$|(?<!\\)\#\s*.*$|\s+/gm, ""), "g",
+function createRegExp(pattern, flags) {
+  return new RegExp(pattern, flags);
+}
+const reImportExportDetection = createRegExp(
+  `(?<!\\s*\\/\\/+.*?)(?:(?<!@)import|export)\\s*(?:(?<qcGlobal>["'])(?!https?:)(?=[.\\/]+)\
+(?:(?<globalName>(?:[.\\/]+)?[^'"]+?)(?:\\.(?<globalExt>(?:c|m)?jsx?))?)\\k<qcGlobal>|\\(\\s*(?<qcDynamic>["'])(?!https?:)(?=[.\\/]+)(?<dynamicName>(?:[.\\/]+)?[^'"]+?)\
+(?:\\.(?<dynamicExt>(?:c|m)?jsx?))?\\k<qcDynamic>\\s*\\)|(?:(?<clause>.+?|(?:\\w+\\s*,)?\\s*\\{[^}]+\\})\\s*from)\\s*(?<qcEsm>["'])(?!https?:)(?=[.\\/]+)\
+(?:(?<moduleName>(?:[.\\/]+)?[^'"]+?)(?:\\.(?<moduleExt>(?:c|m)?jsx?))?)\\k<qcEsm>)(?=\\s*;)?`, "g"
 );
+/**
+ * @typedef {XRegex.ReplacerFunctionSignature<typeof reImportExportDetection>} TImportExportDetectRegexReplacer
+ */
 /**
  * Generates a replacer function to update import/export statements with a new file extension.
  *
  * @param {string} ext - The new file extension to use.
- * @returns {TRegexImportExportDetectorReplacer} A function to update import/export statements with the specified file extension.
+ * @returns {TImportExportDetectRegexReplacer} A function to update import/export statements with the specified file extension.
  * @date 2025/2/16 18:38:39
  * @date 2025/12/22 16:05:13 - ./tool-lib/cjbm-resources/cjbm-browser-test.mjs を参照
  */
@@ -57,11 +40,18 @@ function getReplacer(ext) {
    * NOTE: Replacement is only performed with the syntax "$` is $1".
    * String concatenation is not allowed.
    */
-  /** @type {TRegexImportExportDetectorReplacer} */
-  const replacer = (
-    $0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _offset, _input, { clause, dynamicName, globalName, moduleName, qcDynamic, qcEsm, qcGlobal }
+  /** @type {TImportExportDetectRegexReplacer} */
+  return (
+    match, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _offset, _input, groups
   ) => {
-    const kword = $0.startsWith("import") ? "import" : "export";
+    const {
+      clause,
+      dynamicName,
+      globalName,
+      moduleName,
+      qcDynamic, qcEsm, qcGlobal,
+    } = groups;
+    const kword = match.startsWith("import") ? "import" : "export";
     const qc = qcDynamic || qcEsm || qcGlobal;
     let whichName = /** @type {string} */ (
       globalName || moduleName || dynamicName
@@ -79,7 +69,6 @@ function getReplacer(ext) {
       `(${modId})`
     }`;
   };
-  return replacer;
 }
 /**
  * @param {string} ext

package/tool-lib/tools.d.ts

@@ -6,16 +6,10 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="../regex.d.ts"/>
-declare const ImportExportDetectRegex = `(?<!\\s*\\/\\/+.*?)(?:(?<!@)import|export)\\s*(?:(?<qcGlobal>["'])(?!https?:)(?=[.\\/]+)\
-(?:(?<globalName>(?:[.\\/]+)?[^'"]+?)(?:\\.(?<globalExt>(?:c|m)?jsx?))?)\\k<qcGlobal>|\\(\\s*(?<qcDynamic>["'])(?!https?:)(?=[.\\/]+)(?<dynamicName>(?:[.\\/]+)?[^'"]+?)\
-(?:\\.(?<dynamicExt>(?:c|m)?jsx?))?\\k<qcDynamic>\\s*\\)|(?:(?<clause>.+?|(?:\\w+\\s*,)?\\s*\\{[^}]+\\})\\s*from)\\s*(?<qcEsm>["'])(?!https?:)(?=[.\\/]+)\
-(?:(?<moduleName>(?:[.\\/]+)?[^'"]+?)(?:\\.(?<moduleExt>(?:c|m)?jsx?))?)\\k<qcEsm>)(?=\\s*;)?`;
-declare const reOk: ReturnType<typeof XRegex.createRegExp<typeof ImportExportDetectRegex>>;
 /**
  * @date 2023-10-25
  */
 declare global {
-    type TRegexImportExportDetectorReplacer = XRegex.ReplacerFunctionSignature<typeof reOk>;
     declare function processSources(
         taskName: string,
         process: (source: string) => Promise<string> | string,
@@ -82,7 +76,7 @@ declare global {
         /** replace */
         regex: RegExp;
         /** rmc */
-        rmc4ts: boolean;
+        rmc4ts: boolean | "keepBangLine";
         /**
          * webpacked source path. 
          * @default `./dist/webpack/index.js`

package/tools.js

@@ -206,9 +206,12 @@ const ToolFunctions = {
     fn() {
       const rmc = require("rm-cstyle-cmts");
       if (params.rmc4ts) {
+        const keepBangLine = params.rmc4ts === "keepBangLine";
         rmc.setListener(({ event, fragment }) => {
           if (event === /*EScannerEvent.MultiLineComment*/ 1) {
             return /^\/\*(\*|!)\s|^\/\*(?!-).+\*\/$/.test(fragment);
+          } else if (keepBangLine && event === /*EScannerEvent.SingleLineComment*/0) {
+            return /^\/\/+!/.test(fragment);
           }
           return false;
         });
@@ -228,12 +231,14 @@ const ToolFunctions = {
         },
       );
     },
-    help: `$ jstool -cmd rmc -basePath "./dist/cjs,./dist/cjs/gulp" -test "/\\.(js|d\\.ts)$/"
+    help: `$ jstool -cmd rmc [-rmc4ts[:keepBangLine]] -basePath "./dist/cjs,./dist/cjs/gulp" -test "/\\.(js|d\\.ts)$/"
   note: basePath - can be "<path>,<path>,..." (array type arg)
-    test     - can be omit, defulat \`/\.js$/\`
-    rmc4ts   - for typescript source.
+    test  - can be omit, defulat \`/\.js$/\`
+    rmc4ts- for typescript source.
       keep comment that start with "/*" when "*/" end mark appears in same line.
       if start with "/*-" remove it
+    rmc4ts=keepBangLine (2025/12/24)
+          - In addition to the "rmc4ts" processing, it also preserves line comments that start with "//!".
 `,
   },
   backup: {