@ptolemy2002/rgx 6.2.0 → 7.0.0

package/README.md

@@ -86,6 +86,7 @@ type RGXCapture<T = unknown> = {
     value: T;
     start: number;
     end: number;
+    ownerId: string | null;
 };
 
 type RGXPartOptions<R, T=string> = {
@@ -663,8 +664,8 @@ constructor(source: string, tokens: RGXTokenCollectionInput, options?: RGXWalker
 - `tokens` (`RGXTokenCollection`): The internal collection of tokens in 'concat' mode (readonly).
 - `tokenPosition` (`number`): The current index in the token collection. Setting this validates that the value is >= 0 and <= `tokens.length`, throwing `RGXOutOfBoundsError` if not.
 - `reduced` (`R`): A user-defined accumulator value, typically updated by `RGXPart` callbacks during walking.
-- `captures` (`RGXCapture[]`): An array of structured capture results recorded during walking. Each entry has a `raw` string and a `value` (the transform result for Parts, or the raw string for plain tokens).
-- `namedCaptures` (`Record<string, RGXCapture>`): An object mapping capture IDs to their corresponding `RGXCapture` results. Only Parts with non-null IDs are included.
+- `captures` (`RGXCapture[]`): An array of structured capture results recorded during walking. Each entry has a `raw` string, a `value` (the transform result for Parts, or the raw string for plain tokens), `start` and `end` indices in the source string, and an `ownerId` that is the `id` of the Part that produced it (or `null` for captures from plain tokens or parts without ids).
+- `namedCaptures` (`Record<string, RGXCapture[]>`): An object mapping capture IDs to their corresponding `RGXCapture` results. Only Parts with non-null IDs are included. The captures occur in the same order as they appear in the `captures` array.
 - `stopped` (`boolean`, readonly): Whether the walker has been stopped, either by a Part's `beforeCapture` returning `"stop"` or by calling `stop()` in an `afterCapture` callback.
 
 #### Methods

package/dist/walker/base.d.ts

@@ -13,7 +13,7 @@ export declare class RGXWalker<R> implements RGXConvertibleToken {
     _tokenPosition: number;
     reduced: R;
     captures: RGXCapture[];
-    namedCaptures: Record<string, RGXCapture>;
+    namedCaptures: Record<string, RGXCapture[]>;
     private _stopped;
     static check: (value: unknown) => value is RGXWalker<unknown>;
     static assert: (value: unknown) => asserts value is RGXWalker<unknown>;

package/dist/walker/base.js

@@ -98,7 +98,7 @@ class RGXWalker {
         const raw = this.capture(token);
         const end = this.sourcePosition;
         const value = isPart ? token.transform(raw) : raw;
-        const captureResult = { raw, value, start, end };
+        const captureResult = { raw, value, start, end, ownerId: isPart && token.hasId() ? token.id : null };
         // Validate the part. If validation fails, it will throw an error, so nothing below will run.
         if (isPart) {
             token.validate(captureResult, this);
@@ -107,7 +107,9 @@ class RGXWalker {
         if (!silent) {
             this.captures.push(captureResult);
             if (isPart && token.hasId()) {
-                this.namedCaptures[token.id] = captureResult;
+                if (!(token.id in this.namedCaptures))
+                    this.namedCaptures[token.id] = [];
+                this.namedCaptures[token.id].push(captureResult);
             }
         }
         // Notify Part after capture

package/dist/walker/part.d.ts

@@ -7,6 +7,7 @@ export type RGXCapture<T = unknown> = {
     value: T;
     start: number;
     end: number;
+    ownerId: string | null;
 };
 export type RGXPartOptions<R, T = string> = {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ptolemy2002/rgx",
-    "version": "6.2.0",
+    "version": "7.0.0",
     "private": false,
     "main": "dist/index.js",
     "types": "dist/index.d.ts",