@ac-kit/core 0.1.0

package/dist/object/traverse.js

@@ -0,0 +1,358 @@
+import { isMap } from "../guards/is-map.js";
+import { isPlainObject } from "../guards/is-plain-object.js";
+import { isSet } from "../guards/is-set.js";
+import { defaults } from "./defaults.js";
+import { getObjectKeys, } from "./get-object-keys.js";
+export const TraverseSkip = Symbol("TraverseSkip"); // Skip recursion into children while continuing traversal
+export const TraverseBreak = Symbol("TraverseBreak"); // Skip visiting sibling properties and ascend to parent
+export const TraverseHalt = Symbol("TraverseHalt"); // Halt visiting entirely
+export const TraverseContinue = Symbol("TraverseContinue"); // Continue traversal as normal
+export const TRAVERSE_DEFAULT_OPTIONS = {
+    includeSymbolKeys: false,
+    includeNonEnumerable: false,
+    includePrototypeChain: true,
+    visitPrimitives: true,
+    visitObjects: true,
+    traverseArrays: true,
+    traverseMaps: true,
+    traverseMapKeys: false,
+    traverseSets: true,
+    traversePlainObjects: true,
+    traverseCustomObjects: false,
+};
+const CONTROL_SYMBOLS = new Set([TraverseSkip, TraverseBreak, TraverseHalt]);
+export function traverse(value, callback, options) {
+    const effectiveOptions = defaults(options, TRAVERSE_DEFAULT_OPTIONS);
+    const context = wrapContext({
+        key: null,
+        parent: undefined,
+        parentPath: null,
+    });
+    const result = traverseValue_(value, callback, effectiveOptions, context);
+    // Check if top-level value was removed
+    if (context.action_?.type === "remove") {
+        return;
+    }
+    // If halt occurred, return the partially-mutated original value
+    if (result === TraverseHalt) {
+        return value;
+    }
+    return result;
+}
+function traverseValue_(value, visitor, options, context) {
+    // Check if we should visit this value based on its type
+    const isObject = typeof value === "object" && value !== null;
+    const shouldVisit = isObject ? options.visitObjects : options.visitPrimitives;
+    if (!shouldVisit) {
+        return value;
+    }
+    // Reset action state before calling visitor
+    context.action_ = null;
+    const result = visitor(value, context);
+    // Check context action first (takes precedence)
+    const action = context.action_;
+    if (action) {
+        if (action.type === "remove") {
+            return TraverseHalt; // Use TraverseHalt as removal signal internally
+        }
+        // action.type === "replace"
+        value = action.value;
+    }
+    // Check if result is a control symbol
+    if (isControlSymbol(result)) {
+        if (result === TraverseSkip) {
+            return value;
+        }
+        if (result === TraverseBreak || result === TraverseHalt) {
+            return result; // Propagate control flow
+        }
+    }
+    // Now potentially traverse into the value if it's an object
+    if (typeof value === "object" && value !== null) {
+        const parentPath = [...(context.parentPath ?? [])];
+        if (context.key !== null) {
+            parentPath.push(context.key);
+        }
+        if (Array.isArray(value)) {
+            if (options.traverseArrays) {
+                return traverseArrayIndices_(value, visitor, options, parentPath);
+            }
+            // Don't traverse if option is false
+            return value;
+        }
+        if (isSet(value)) {
+            if (options.traverseSets) {
+                return traverseSetValues_(value, visitor, options, parentPath);
+            }
+            // Don't traverse if option is false
+            return value;
+        }
+        if (isMap(value)) {
+            if (options.traverseMaps) {
+                return traverseMapEntries_(value, visitor, options, parentPath);
+            }
+            // Don't traverse if option is false
+            return value;
+        }
+        // Check if we should traverse this object's properties
+        const shouldTraverseObject = (isPlainObject(value) && options.traversePlainObjects) ||
+            (!isPlainObject(value) &&
+                shouldTraverseCustomObject(value, options.traverseCustomObjects));
+        if (shouldTraverseObject) {
+            return traverseObjectProperties_(value, visitor, options, parentPath);
+        }
+        // Non-traversable object, return as-is
+        return value;
+    }
+    return value;
+}
+function traverseArrayIndices_(array, visitor, options, parentPath) {
+    // Snapshot indices before iteration to handle sparse arrays and mutations
+    const indices = [];
+    for (const indexStr in array) {
+        indices.push(+indexStr);
+    }
+    const indicesToRemove = [];
+    let halted = false;
+    for (const index of indices) {
+        const context = wrapContext({
+            key: { kind: "array", index },
+            parent: array,
+            parentPath,
+        });
+        const transformed = traverseValue_(array[index], visitor, options, context);
+        if (transformed === TraverseHalt) {
+            // Check if it's a remove signal or actual halt
+            if (context.action_?.type === "remove") {
+                indicesToRemove.push(index);
+            }
+            else {
+                halted = true;
+                break;
+            }
+            continue;
+        }
+        if (transformed === TraverseBreak) {
+            break;
+        }
+        // Check for replacement via context
+        if (context.action_?.type === "replace") {
+            array[index] = context.action_.value;
+        }
+        else if (transformed !== array[index]) {
+            array[index] = transformed;
+        }
+    }
+    // Remove marked indices in reverse order to maintain correct indices
+    for (let i = indicesToRemove.length - 1; i >= 0; i--) {
+        const indexToRemove = indicesToRemove[i];
+        if (indexToRemove !== undefined) {
+            array.splice(indexToRemove, 1);
+        }
+    }
+    if (halted) {
+        return TraverseHalt;
+    }
+    return array;
+}
+function traverseMapEntries_(map, visitor, options, parentPath) {
+    // Snapshot entries before iteration to prevent iterator invalidation
+    const entries = Array.from(map.entries());
+    const entriesToUpdate = [];
+    const keysToRemove = [];
+    let halted = false;
+    for (const [key, value] of entries) {
+        let transformedKey = key;
+        // Traverse into Map keys only if traverseMapKeys is enabled
+        if (options.traverseMapKeys) {
+            const keyContext = wrapContext({
+                key: { kind: "map-key", name: key },
+                parent: map,
+                parentPath,
+            });
+            transformedKey = traverseValue_(key, visitor, options, keyContext);
+            if (transformedKey === TraverseHalt) {
+                if (keyContext.action_?.type === "remove") {
+                    keysToRemove.push(key);
+                    continue;
+                }
+                halted = true;
+                break;
+            }
+            if (transformedKey === TraverseBreak) {
+                break;
+            }
+            if (keyContext.action_?.type === "replace") {
+                transformedKey = keyContext.action_.value;
+            }
+        }
+        // Visit value
+        const valueContext = wrapContext({
+            key: { kind: "map", key },
+            parent: map,
+            parentPath,
+        });
+        const transformedValue = traverseValue_(value, visitor, options, valueContext);
+        if (transformedValue === TraverseHalt) {
+            if (valueContext.action_?.type === "remove") {
+                keysToRemove.push(key);
+                continue;
+            }
+            halted = true;
+            break;
+        }
+        if (transformedValue === TraverseBreak) {
+            break;
+        }
+        let finalValue = value;
+        if (valueContext.action_?.type === "replace") {
+            finalValue = valueContext.action_.value;
+        }
+        else if (transformedValue !== value) {
+            finalValue = transformedValue;
+        }
+        if (transformedKey !== key || finalValue !== value) {
+            entriesToUpdate.push({
+                oldKey: key,
+                newKey: transformedKey,
+                newValue: finalValue,
+            });
+        }
+    }
+    // Apply changes to the map
+    for (const key of keysToRemove) {
+        map.delete(key);
+    }
+    for (const { oldKey, newKey, newValue } of entriesToUpdate) {
+        if (oldKey !== newKey) {
+            map.delete(oldKey);
+        }
+        map.set(newKey, newValue);
+    }
+    if (halted) {
+        return TraverseHalt;
+    }
+    return map;
+}
+function traverseSetValues_(set, visitor, options, parentPath) {
+    // Snapshot values before iteration to prevent iterator invalidation
+    const values = Array.from(set.values());
+    const valuesToRemove = [];
+    const valuesToAdd = [];
+    let halted = false;
+    for (const item of values) {
+        const context = wrapContext({
+            key: { kind: "set", value: item },
+            parent: set,
+            parentPath,
+        });
+        const transformed = traverseValue_(item, visitor, options, context);
+        if (transformed === TraverseHalt) {
+            if (context.action_?.type === "remove") {
+                valuesToRemove.push(item);
+                continue;
+            }
+            halted = true;
+            break;
+        }
+        if (transformed === TraverseBreak) {
+            break;
+        }
+        if (context.action_?.type === "replace") {
+            valuesToAdd.push({ old: item, new: context.action_.value });
+        }
+        else if (transformed !== item) {
+            valuesToAdd.push({ old: item, new: transformed });
+        }
+    }
+    // Apply changes to the set
+    for (const value of valuesToRemove) {
+        set.delete(value);
+    }
+    for (const { old: oldValue, new: newValue } of valuesToAdd) {
+        set.delete(oldValue);
+        set.add(newValue);
+    }
+    if (halted) {
+        return TraverseHalt;
+    }
+    return set;
+}
+/**
+ * Traverse object properties
+ *
+ * @param object - The object to traverse
+ * @param visitor - The visitor callback
+ * @param options - Traverse options
+ * @param parentPath - The path to the parent object
+ * @returns
+ */
+function traverseObjectProperties_(object, visitor, options, parentPath) {
+    const keys = getObjectKeys(object, options);
+    let halted = false;
+    for (const key of keys) {
+        const context = wrapContext({
+            key: { kind: "object", ...key },
+            parent: object,
+            parentPath,
+        });
+        const transformed = traverseValue_(object[key.property], visitor, options, context);
+        if (transformed === TraverseHalt) {
+            if (context.action_?.type === "remove") {
+                delete object[key.property];
+                continue;
+            }
+            halted = true;
+            break;
+        }
+        if (transformed === TraverseBreak) {
+            break;
+        }
+        const currentValue = object[key.property];
+        if (context.action_?.type === "replace") {
+            object[key.property] =
+                context.action_.value;
+        }
+        else if (transformed !== currentValue) {
+            object[key.property] = transformed;
+        }
+    }
+    if (halted) {
+        return TraverseHalt;
+    }
+    return object;
+}
+function isControlSymbol(value) {
+    return typeof value === "symbol" && CONTROL_SYMBOLS.has(value);
+}
+/** Wrap visitor context to add action methods */
+function wrapContext(visitorContext) {
+    const context = {
+        ...visitorContext,
+        action_: null,
+        replace(value) {
+            context.action_ = { type: "replace", value };
+        },
+        remove() {
+            context.action_ = { type: "remove" };
+        },
+    };
+    return context;
+}
+/** Check if a custom object should be traversed based on options */
+function shouldTraverseCustomObject(value, options) {
+    if (options === false) {
+        return false;
+    }
+    if (typeof options === "function") {
+        return options(value);
+    }
+    // Array of constructor functions - check instanceof
+    for (const ctor of options) {
+        if (value instanceof ctor) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=traverse.js.map

package/dist/object/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../src/object/traverse.ts"],"names":[],"mappings":"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"}

package/dist/pattern/pattern-trim.d.ts

@@ -0,0 +1,71 @@
+import type { Pattern } from "./types.js";
+/**
+ * Creates a function that trims the specified pattern from the start and end of
+ * a string. Prefer this over {@link patternTrim} when trimming the same pattern
+ * repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from both ends of a string.
+ */
+export declare function buildPatternTrim(pattern?: Pattern): (string: string) => string;
+/**
+ * Creates a function that trims the specified pattern from the start of a
+ * string. Prefer this over {@link patternTrimStart} when trimming the same
+ * pattern repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from the start of a string.
+ */
+export declare function buildPatternTrimStart(pattern?: Pattern): (string: string) => string;
+/**
+ * Creates a function that trims the specified pattern from the end of a string.
+ * Prefer this over {@link patternTrimEnd} when trimming the same pattern
+ * repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from the end of a string.
+ */
+export declare function buildPatternTrimEnd(pattern?: Pattern): (string: string) => string;
+/**
+ * Trims the specified pattern from the start and end of the string.
+ *
+ * This method is like `String.prototype.trim()`, but allows specifying a custom
+ * pattern. Use {@link buildPatternTrim} instead when trimming the same pattern
+ * repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export declare function patternTrim(string: string, pattern?: Pattern): string;
+/**
+ * Trims the specified pattern from the start of the string.
+ *
+ * This method is like `String.prototype.trimStart()`, but allows specifying a
+ * custom pattern. Use {@link buildPatternTrimStart} instead when trimming the
+ * same pattern repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export declare function patternTrimStart(string: string, pattern?: Pattern): string;
+/**
+ * Trims the specified pattern from the end of the string.
+ *
+ * This method is like `String.prototype.trimEnd()`, but allows specifying a
+ * custom pattern. Use {@link buildPatternTrimEnd} instead when trimming the same
+ * pattern repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export declare function patternTrimEnd(string: string, pattern?: Pattern): string;
+//# sourceMappingURL=pattern-trim.d.ts.map

package/dist/pattern/pattern-trim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-trim.d.ts","sourceRoot":"","sources":["../../src/pattern/pattern-trim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,CAAC,EAAE,OAAO,GACf,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAM5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,CAAC,EAAE,OAAO,GACf,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAM5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,CAAC,EAAE,OAAO,GACf,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAM5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAErE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAExE"}

package/dist/pattern/pattern-trim.js

@@ -0,0 +1,94 @@
+/**
+ * Creates a function that trims the specified pattern from the start and end of
+ * a string. Prefer this over {@link patternTrim} when trimming the same pattern
+ * repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from both ends of a string.
+ */
+export function buildPatternTrim(pattern) {
+    if (!pattern) {
+        return (s) => s.trim();
+    }
+    const regex = new RegExp(`(?:^(?:${pattern})+)|(?:(?:${pattern})+$)`, "g");
+    return (s) => s.replace(regex, "");
+}
+/**
+ * Creates a function that trims the specified pattern from the start of a
+ * string. Prefer this over {@link patternTrimStart} when trimming the same
+ * pattern repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from the start of a string.
+ */
+export function buildPatternTrimStart(pattern) {
+    if (!pattern) {
+        return (s) => s.trimStart();
+    }
+    const regex = new RegExp(`^(?:${pattern})+`);
+    return (s) => s.replace(regex, "");
+}
+/**
+ * Creates a function that trims the specified pattern from the end of a string.
+ * Prefer this over {@link patternTrimEnd} when trimming the same pattern
+ * repeatedly, as the regex is compiled once.
+ *
+ * @param pattern The pattern to trim. If not provided, whitespace and line
+ *   terminators are trimmed.
+ * @returns A function that trims the pattern from the end of a string.
+ */
+export function buildPatternTrimEnd(pattern) {
+    if (!pattern) {
+        return (s) => s.trimEnd();
+    }
+    const regex = new RegExp(`(?:${pattern})+$`);
+    return (s) => s.replace(regex, "");
+}
+/**
+ * Trims the specified pattern from the start and end of the string.
+ *
+ * This method is like `String.prototype.trim()`, but allows specifying a custom
+ * pattern. Use {@link buildPatternTrim} instead when trimming the same pattern
+ * repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export function patternTrim(string, pattern) {
+    return buildPatternTrim(pattern)(string);
+}
+/**
+ * Trims the specified pattern from the start of the string.
+ *
+ * This method is like `String.prototype.trimStart()`, but allows specifying a
+ * custom pattern. Use {@link buildPatternTrimStart} instead when trimming the
+ * same pattern repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export function patternTrimStart(string, pattern) {
+    return buildPatternTrimStart(pattern)(string);
+}
+/**
+ * Trims the specified pattern from the end of the string.
+ *
+ * This method is like `String.prototype.trimEnd()`, but allows specifying a
+ * custom pattern. Use {@link buildPatternTrimEnd} instead when trimming the same
+ * pattern repeatedly.
+ *
+ * @param string The string to be trimmed.
+ * @param pattern The pattern to be trimmed. If not provided, whitespace and
+ *   line terminators are trimmed.
+ * @returns The trimmed string.
+ */
+export function patternTrimEnd(string, pattern) {
+    return buildPatternTrimEnd(pattern)(string);
+}
+//# sourceMappingURL=pattern-trim.js.map

package/dist/pattern/pattern-trim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-trim.js","sourceRoot":"","sources":["../../src/pattern/pattern-trim.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAiB;IAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,OAAO,aAAa,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3E,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAAiB;IAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAiB;IAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAiB;IAC5D,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,OAAiB;IACjE,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAiB;IAC/D,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/pattern/pattern-util.d.ts

@@ -0,0 +1,51 @@
+import type { Pattern } from "./types.js";
+/**
+ * Enclose the pattern with a capture group, optionally named with `name`
+ *
+ * If `name` is not provided, the capture group will be non-capturing.
+ *
+ * @param pattern The pattern to be captured.
+ * @param name Optional name for the capture group.
+ * @returns The pattern string enclosed in a capture group.
+ */
+export declare function patternCapture(pattern: Pattern, name?: string): Pattern;
+export type PatternInOutCaptureOptions = {
+    prePattern?: Pattern;
+    postPattern?: Pattern;
+    inCaptureName?: string;
+    outCaptureName?: string;
+};
+/**
+ * Enclose the pattern with in-out capture groups, provided `pre`/`post` pattern
+ * strings.
+ *
+ * `inCaptureName` is the name of the inner capture group (the main pattern).
+ * `outCaptureName` is the name of the outer capture group (the whole pattern
+ * with pre/post).
+ *
+ * If `inCaptureName` is not provided, the inner capture group will be
+ * non-capturing. If `outCaptureName` is not provided, the outer capture group
+ * will be non-capturing.
+ *
+ * The `prePattern` and `postPattern` are added before and after the main
+ * pattern, respectively.
+ *
+ * Exemple:
+ *
+ * ```ts
+ * const pattern = patternInOutCapture("\\d+", {
+ * 	prePattern: "\\(",
+ * 	postPattern: "\\)",
+ * 	inCaptureName: "number",
+ * 	outCaptureName: "parenthesizedNumber",
+ * });
+ * // pattern is "(?<(parenthesizedNumber)>(?:\\((?<number>\\d+)\\)))"
+ * // new RegExp(pattern) is /(?(<parenthesizedNumber>)(?:\((?<number>\d+)\)))/
+ * ```
+ *
+ * @param pattern The main pattern to be captured.
+ * @param options Options for pre/post patterns and capture group names.
+ * @returns The composed pattern string with in-out capture groups.
+ */
+export declare function patternInOutCapture(pattern: Pattern, { prePattern, postPattern, inCaptureName, outCaptureName, }?: PatternInOutCaptureOptions): Pattern;
+//# sourceMappingURL=pattern-util.d.ts.map

package/dist/pattern/pattern-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-util.d.ts","sourceRoot":"","sources":["../../src/pattern/pattern-util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,MAAM,MAAM,0BAA0B,GAAG;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,OAAO,EAChB,EACC,UAAe,EACf,WAAgB,EAChB,aAAa,EACb,cAAc,GACd,GAAE,0BAA+B,GAChC,OAAO,CAIT"}

package/dist/pattern/pattern-util.js

@@ -0,0 +1,49 @@
+/**
+ * Enclose the pattern with a capture group, optionally named with `name`
+ *
+ * If `name` is not provided, the capture group will be non-capturing.
+ *
+ * @param pattern The pattern to be captured.
+ * @param name Optional name for the capture group.
+ * @returns The pattern string enclosed in a capture group.
+ */
+export function patternCapture(pattern, name) {
+    return name ? `(?<${name}>${pattern})` : `(?:${pattern})`;
+}
+/**
+ * Enclose the pattern with in-out capture groups, provided `pre`/`post` pattern
+ * strings.
+ *
+ * `inCaptureName` is the name of the inner capture group (the main pattern).
+ * `outCaptureName` is the name of the outer capture group (the whole pattern
+ * with pre/post).
+ *
+ * If `inCaptureName` is not provided, the inner capture group will be
+ * non-capturing. If `outCaptureName` is not provided, the outer capture group
+ * will be non-capturing.
+ *
+ * The `prePattern` and `postPattern` are added before and after the main
+ * pattern, respectively.
+ *
+ * Exemple:
+ *
+ * ```ts
+ * const pattern = patternInOutCapture("\\d+", {
+ * 	prePattern: "\\(",
+ * 	postPattern: "\\)",
+ * 	inCaptureName: "number",
+ * 	outCaptureName: "parenthesizedNumber",
+ * });
+ * // pattern is "(?<(parenthesizedNumber)>(?:\\((?<number>\\d+)\\)))"
+ * // new RegExp(pattern) is /(?(<parenthesizedNumber>)(?:\((?<number>\d+)\)))/
+ * ```
+ *
+ * @param pattern The main pattern to be captured.
+ * @param options Options for pre/post patterns and capture group names.
+ * @returns The composed pattern string with in-out capture groups.
+ */
+export function patternInOutCapture(pattern, { prePattern = "", postPattern = "", inCaptureName, outCaptureName, } = {}) {
+    const inPattern = prePattern + patternCapture(pattern, inCaptureName) + postPattern;
+    return patternCapture(inPattern, outCaptureName);
+}
+//# sourceMappingURL=pattern-util.js.map

package/dist/pattern/pattern-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-util.js","sourceRoot":"","sources":["../../src/pattern/pattern-util.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,IAAa;IAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,OAAO,GAAG,CAAC;AAC3D,CAAC;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAgB,EAChB,EACC,UAAU,GAAG,EAAE,EACf,WAAW,GAAG,EAAE,EAChB,aAAa,EACb,cAAc,GACd,GAA+B,EAAE;IAElC,MAAM,SAAS,GACd,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,WAAW,CAAC;IACnE,OAAO,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC"}

package/dist/pattern/types.d.ts

@@ -0,0 +1,3 @@
+/** A pattern string, as used in regular expressions. */
+export type Pattern = string;
+//# sourceMappingURL=types.d.ts.map

package/dist/pattern/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pattern/types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC"}

package/dist/pattern/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map