@platforma-open/milaboratories.software-ptabler.schema 1.11.4 → 1.11.5

package/dist/expressions/index.d.ts

@@ -16,10 +16,10 @@ import type { WhenThenOtherwiseExpression, FillNullExpression, FillNaNExpression
 import type { RankExpression, CumsumExpression, WindowExpression } from './window';
 import type { HashExpression } from './hash';
 import type { StructFieldExpression } from './struct';
-import type { MatchesEcmaRegexExpression, ContainsFuzzyMatchExpression } from './pframes';
+import type { MatchesEcmaRegexExpression, ContainsFuzzyMatchExpression, ReplaceEcmaRegexExpression, ExtractEcmaRegexExpression } from './pframes';
 /**
  * Represents all possible expression types in the system.
  * This is the main union type that includes all concrete expression implementations.
  */
-export type Expression = ComparisonExpression | BinaryArithmeticExpression | UnaryArithmeticExpression | CastExpression | BooleanLogicExpression | NotExpression | NullCheckExpression | StringJoinExpression | HashExpression | ColumnReferenceExpression | AxisReferenceExpression | ConstantValueExpression | RankExpression | CumsumExpression | ExtendedUnaryStringExpression | StringDistanceExpression | FuzzyStringFilterExpression | WhenThenOtherwiseExpression | SubstringExpression | StringReplaceExpression | StringContainsExpression | StringStartsWithExpression | StringEndsWithExpression | StringContainsAnyExpression | StringCountMatchesExpression | StringExtractExpression | MinMaxExpression | FillNullExpression | FillNaNExpression | WindowExpression | StructFieldExpression | MatchesEcmaRegexExpression | ContainsFuzzyMatchExpression | InSetExpression | AliasExpression | AllSelectorExpression | StringSelectorExpression | NumericSelectorExpression | IntegerSelectorExpression | FloatSelectorExpression | StartsWithSelectorExpression | EndsWithSelectorExpression | ContainsSelectorExpression | MatchesSelectorExpression | ExcludeSelectorExpression | ByNameSelectorExpression | AxisSelectorExpression | NestedSelectorExpression | SelectorComplementExpression | SelectorUnionExpression | SelectorIntersectionExpression | SelectorDifferenceExpression | SelectorSymmetricDifferenceExpression;
+export type Expression = ComparisonExpression | BinaryArithmeticExpression | UnaryArithmeticExpression | CastExpression | BooleanLogicExpression | NotExpression | NullCheckExpression | StringJoinExpression | HashExpression | ColumnReferenceExpression | AxisReferenceExpression | ConstantValueExpression | RankExpression | CumsumExpression | ExtendedUnaryStringExpression | StringDistanceExpression | FuzzyStringFilterExpression | WhenThenOtherwiseExpression | SubstringExpression | StringReplaceExpression | StringContainsExpression | StringStartsWithExpression | StringEndsWithExpression | StringContainsAnyExpression | StringCountMatchesExpression | StringExtractExpression | MinMaxExpression | FillNullExpression | FillNaNExpression | WindowExpression | StructFieldExpression | MatchesEcmaRegexExpression | ContainsFuzzyMatchExpression | ReplaceEcmaRegexExpression | ExtractEcmaRegexExpression | InSetExpression | AliasExpression | AllSelectorExpression | StringSelectorExpression | NumericSelectorExpression | IntegerSelectorExpression | FloatSelectorExpression | StartsWithSelectorExpression | EndsWithSelectorExpression | ContainsSelectorExpression | MatchesSelectorExpression | ExcludeSelectorExpression | ByNameSelectorExpression | AxisSelectorExpression | NestedSelectorExpression | SelectorComplementExpression | SelectorUnionExpression | SelectorIntersectionExpression | SelectorDifferenceExpression | SelectorSymmetricDifferenceExpression;
 //# sourceMappingURL=index.d.ts.map

package/dist/expressions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expressions/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAE1B,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,qCAAqC,EACtC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,oBAAoB,GACpB,0BAA0B,GAC1B,yBAAyB,GACzB,cAAc,GACd,sBAAsB,GACtB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,yBAAyB,GACzB,uBAAuB,GACvB,uBAAuB,GACvB,cAAc,GACd,gBAAgB,GAChB,6BAA6B,GAC7B,wBAAwB,GACxB,2BAA2B,GAC3B,2BAA2B,GAC3B,mBAAmB,GACnB,uBAAuB,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,GAC3B,4BAA4B,GAC5B,uBAAuB,GACvB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,0BAA0B,GAC1B,4BAA4B,GAC5B,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,wBAAwB,GACxB,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,4BAA4B,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB,GACtB,wBAAwB,GACxB,4BAA4B,GAC5B,uBAAuB,GACvB,8BAA8B,GAC9B,4BAA4B,GAC5B,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expressions/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAE1B,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,qCAAqC,EACtC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,oBAAoB,GACpB,0BAA0B,GAC1B,yBAAyB,GACzB,cAAc,GACd,sBAAsB,GACtB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,yBAAyB,GACzB,uBAAuB,GACvB,uBAAuB,GACvB,cAAc,GACd,gBAAgB,GAChB,6BAA6B,GAC7B,wBAAwB,GACxB,2BAA2B,GAC3B,2BAA2B,GAC3B,mBAAmB,GACnB,uBAAuB,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,GAC3B,4BAA4B,GAC5B,uBAAuB,GACvB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,0BAA0B,GAC1B,4BAA4B,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC1B,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,wBAAwB,GACxB,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,4BAA4B,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB,GACtB,wBAAwB,GACxB,4BAA4B,GAC5B,uBAAuB,GACvB,8BAA8B,GAC9B,4BAA4B,GAC5B,qCAAqC,CAAC"}

package/dist/expressions/pframes.d.ts

@@ -31,4 +31,85 @@ export interface ContainsFuzzyMatchExpression {
     /** If true, only substitutions are allowed (deletions and insertions are also allowed by default). */
     substitutions_only?: boolean;
 }
+/**
+ * Represents a regex replacement operation using ECMAScript regular expressions.
+ * Performs JavaScript String.prototype.replace() operation.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace
+ *
+ * @example
+ * Input: "result.POIS_P001_W104_PBMC_2.clns"
+ * Pattern: "^.*(P\\d+)_(W\\d+).*$"
+ * Replacement: "$2-$1"
+ * Result: "W104-P001"
+ */
+export interface ReplaceEcmaRegexExpression {
+    /** The type of operation, always 'replace_ecma_regex'. */
+    type: 'replace_ecma_regex';
+    /** The string expression whose value will be replaced. */
+    value: Expression;
+    /**
+     * String representing ECMAScript RegEx with at least one capturing group.
+     * If you need to reorder capturing groups - use RegExp matching the whole string
+     * (must start with string begin anchor ^, end with string end anchor $).
+     * Use regex playground https://regexr.com/ to test your ideas.
+     */
+    ecma_regex: string;
+    /**
+     * Replacement pattern used to construct result string from captured groups.
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace#specifying_a_string_as_the_replacement
+     * Empty string as result would become NA.
+     */
+    replacement: string;
+}
+/**
+ * Represents a regex extraction operation using ECMAScript regular expressions.
+ * Simplified 'regexpReplace' with replacement set to $1.
+ * This means that string is replaced with first capture group value.
+ *
+ * RegEx must match the entire string, this would be enforced even when ^ and $ are skipped.
+ * If there are no matches - value would be replaced with empty string.
+ *
+ * @example
+ * // Example 1:
+ * Input: "123___abc.xlsx"
+ * Pattern: "\\d+___([a-z]+).xlsx"
+ * Result: "abc"
+ *
+ * @example
+ * // Example 2:
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+)___([a-z]+).xlsx"
+ * Result: "123"
+ *
+ * @example
+ * // Example 3:
+ * Input: "123___abc.xlsx"
+ * Pattern: "((\\d+)___([a-z]+)).xlsx"
+ * Result: "123___abc"
+ *
+ * @example
+ * // Wrong example (pattern doesn't match entire string):
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+___[a-z]+)"
+ * Result: "" (empty string, as .xlsx part is missing in pattern, so pattern was not matched)
+ *
+ * @example
+ * // Correct example:
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+___[a-z]+).xlsx"
+ * Result: "123___abc"
+ */
+export interface ExtractEcmaRegexExpression {
+    /** The type of operation, always 'extract_ecma_regex'. */
+    type: 'extract_ecma_regex';
+    /** The string expression whose value will be extracted. */
+    value: Expression;
+    /**
+     * String representing ECMAScript RegEx with at least one capturing group.
+     * RegEx must match the entire string, this would be enforced even when ^ and $ are skipped.
+     * If there are no matches - value would be replaced with empty string.
+     */
+    ecma_regex: string;
+}
 //# sourceMappingURL=pframes.d.ts.map

package/dist/expressions/pframes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pframes.d.ts","sourceRoot":"","sources":["../../src/expressions/pframes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4DAA4D;IAC5D,IAAI,EAAE,sBAAsB,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"version":3,"file":"pframes.d.ts","sourceRoot":"","sources":["../../src/expressions/pframes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4DAA4D;IAC5D,IAAI,EAAE,sBAAsB,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,2DAA2D;IAC3D,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-open/milaboratories.software-ptabler.schema",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "description": "Type definitions for PTabler",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -22,8 +22,8 @@
   "devDependencies": {
     "eslint": "^9.25.1",
     "typescript": "~5.6.3",
-    "@milaboratories/ts-configs": "1.0.6",
     "@milaboratories/ts-builder": "1.0.5",
+    "@milaboratories/ts-configs": "1.0.6",
     "@platforma-sdk/eslint-config": "1.1.0"
   },
   "scripts": {

package/src/expressions/index.ts

@@ -81,6 +81,8 @@ import type { StructFieldExpression } from './struct';
 import type {
   MatchesEcmaRegexExpression,
   ContainsFuzzyMatchExpression,
+  ReplaceEcmaRegexExpression,
+  ExtractEcmaRegexExpression,
 } from './pframes';
 
 /**
@@ -121,6 +123,8 @@ export type Expression =
   | StructFieldExpression
   | MatchesEcmaRegexExpression
   | ContainsFuzzyMatchExpression
+  | ReplaceEcmaRegexExpression
+  | ExtractEcmaRegexExpression
   | InSetExpression
   | AliasExpression
   | AllSelectorExpression

package/src/expressions/pframes.ts

@@ -33,3 +33,86 @@ export interface ContainsFuzzyMatchExpression {
   /** If true, only substitutions are allowed (deletions and insertions are also allowed by default). */
   substitutions_only?: boolean;
 }
+
+/**
+ * Represents a regex replacement operation using ECMAScript regular expressions.
+ * Performs JavaScript String.prototype.replace() operation.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace
+ *
+ * @example
+ * Input: "result.POIS_P001_W104_PBMC_2.clns"
+ * Pattern: "^.*(P\\d+)_(W\\d+).*$"
+ * Replacement: "$2-$1"
+ * Result: "W104-P001"
+ */
+export interface ReplaceEcmaRegexExpression {
+  /** The type of operation, always 'replace_ecma_regex'. */
+  type: 'replace_ecma_regex';
+  /** The string expression whose value will be replaced. */
+  value: Expression;
+  /**
+   * String representing ECMAScript RegEx with at least one capturing group.
+   * If you need to reorder capturing groups - use RegExp matching the whole string
+   * (must start with string begin anchor ^, end with string end anchor $).
+   * Use regex playground https://regexr.com/ to test your ideas.
+   */
+  ecma_regex: string;
+  /**
+   * Replacement pattern used to construct result string from captured groups.
+   * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace#specifying_a_string_as_the_replacement
+   * Empty string as result would become NA.
+   */
+  replacement: string;
+}
+
+/**
+ * Represents a regex extraction operation using ECMAScript regular expressions.
+ * Simplified 'regexpReplace' with replacement set to $1.
+ * This means that string is replaced with first capture group value.
+ *
+ * RegEx must match the entire string, this would be enforced even when ^ and $ are skipped.
+ * If there are no matches - value would be replaced with empty string.
+ *
+ * @example
+ * // Example 1:
+ * Input: "123___abc.xlsx"
+ * Pattern: "\\d+___([a-z]+).xlsx"
+ * Result: "abc"
+ *
+ * @example
+ * // Example 2:
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+)___([a-z]+).xlsx"
+ * Result: "123"
+ *
+ * @example
+ * // Example 3:
+ * Input: "123___abc.xlsx"
+ * Pattern: "((\\d+)___([a-z]+)).xlsx"
+ * Result: "123___abc"
+ *
+ * @example
+ * // Wrong example (pattern doesn't match entire string):
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+___[a-z]+)"
+ * Result: "" (empty string, as .xlsx part is missing in pattern, so pattern was not matched)
+ *
+ * @example
+ * // Correct example:
+ * Input: "123___abc.xlsx"
+ * Pattern: "(\\d+___[a-z]+).xlsx"
+ * Result: "123___abc"
+ */
+export interface ExtractEcmaRegexExpression {
+  /** The type of operation, always 'extract_ecma_regex'. */
+  type: 'extract_ecma_regex';
+  /** The string expression whose value will be extracted. */
+  value: Expression;
+  /**
+   * String representing ECMAScript RegEx with at least one capturing group.
+   * RegEx must match the entire string, this would be enforced even when ^ and $ are skipped.
+   * If there are no matches - value would be replaced with empty string.
+   */
+  ecma_regex: string;
+}