js-dev-tool 1.0.15 → 1.0.16

package/package.json

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

package/regex.d.ts

@@ -9,18 +9,30 @@
  * @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: string, flags?: F): RegExp & {
+    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: string, flags?: F): RegExp & {
+    <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.
@@ -34,6 +46,11 @@ 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,
@@ -52,10 +69,12 @@ 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 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.
  * 
@@ -86,7 +105,7 @@ export type CountCaptureGroups<
     ? 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.
@@ -98,19 +117,30 @@ export type RegExpExecArrayFixed<
   R extends RegExp,
   S extends ReSource<R> = ReSource<R>,
   GroupCount extends number = CountCaptureGroups<S>
-> = [match: string, ...ExtractCaptures<GroupCount>] & {
+> = [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.
  * 
@@ -124,7 +154,7 @@ export type ReplaceCallbackParams<
   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.15"
+  "version": "1.0.16"
 }