AG-55306 fix docs

* commit '71a015125011e86637ffc7a884df6c478c863162':
  fix src docs
  about-scriptlets.md: Missing periods in json- documentation

Author: slvvko

src/scriptlets/evaldata-prune.js

@@ -30,7 +30,7 @@ import {
  * example.org#%#//scriptlet('evaldata-prune'[, propsToRemove [, obligatoryProps [, stack]]])
  * ```
  *
- * - `propsToRemove` — optional, string of space-separated properties to remove
+ * - `propsToRemove` — optional, string of space-separated properties to remove.
  * - `obligatoryProps` — optional, string of space-separated properties
  *   which must be all present for the pruning to occur
  * - `stack` — optional, string or regular expression that must match the current function call stack trace;

src/scriptlets/json-prune-fetch-response.ts

@@ -77,8 +77,8 @@ import { type Source } from './scriptlets';
  *   if regular expression is invalid it will be skipped.
  * - `mode` — optional, syntax mode selector.
  *   Supported values:
- *     - `legacy` — force the existing legacy path syntax
- *     - `jsonpath` — force JSONPath syntax
+ *     - `legacy` — force the existing legacy path syntax;
+ *     - `jsonpath` — force JSONPath syntax.
  *   If omitted, the scriptlet detects JSONPath automatically for clearly JSONPath-shaped expressions.
  *
  * > Note please that you can use wildcard `*` for chain property name,

src/scriptlets/json-prune-xhr-response.ts

@@ -59,22 +59,22 @@ import { type Source } from './scriptlets';
  *
  * <!-- markdownlint-enable line-length -->
  *
- * - `propsToRemove` — optional, string of space-separated properties to remove
+ * - `propsToRemove` — optional, string of space-separated properties to remove.
  *   In `jsonpath` mode only single JSONPath prune expression is supported.
  * - `obligatoryProps` — optional, string of space-separated properties
- *   which must be all present for the pruning to occur
+ *   which must be all present for the pruning to occur.
  * - `propsToMatch` — optional, string of space-separated properties to match for extra condition; possible props:
  *     - string or regular expression for matching the URL passed to `XMLHttpRequest.open()` call;
- *     - colon-separated pairs `name:value` where
- *         - `name` — string or regular expression for matching XMLHttpRequest property name
+ *     - colon-separated pairs `name:value` where:
+ *         - `name` — string or regular expression for matching XMLHttpRequest property name;
  *         - `value` — string or regular expression for matching the value of the option
- *           passed to `XMLHttpRequest.open()` call
+ *           passed to `XMLHttpRequest.open()` call.
  * - `stack` — optional, string or regular expression that must match the current function call stack trace;
- *   if regular expression is invalid it will be skipped
+ *   if regular expression is invalid it will be skipped.
  * - `mode` — optional, syntax mode selector.
  *   Supported values:
- *     - `legacy` — force the existing legacy path syntax
- *     - `jsonpath` — force JSONPath syntax
+ *     - `legacy` — force the existing legacy path syntax;
+ *     - `jsonpath` — force JSONPath syntax.
  *   If omitted, the scriptlet detects JSONPath automatically for clearly JSONPath-shaped expressions.
  *
  * > Note please that you can use wildcard `*` for chain property name,

src/scriptlets/json-prune.js

@@ -47,18 +47,18 @@ import {
  * example.org#%#//scriptlet('json-prune'[, propsToRemove [, obligatoryProps [, stack [, mode]]]])
  * ```
  *
- * - `propsToRemove` — optional, string of space-separated properties to remove
+ * - `propsToRemove` — optional, string of space-separated properties to remove.
  *   In `jsonpath` mode only single JSONPath prune expression is supported.
  * - `obligatoryProps` — optional, string of space-separated properties
- *   which must be all present for the pruning to occur
+ *   which must be all present for the pruning to occur.
  *   In `jsonpath` mode this argument is ignored. Express such preconditions
  *   directly in `propsToRemove` with leading JSONPath guards and filters.
  * - `stack` — optional, string or regular expression that must match the current function call stack trace;
- *   if regular expression is invalid it will be skipped
+ *   if regular expression is invalid it will be skipped.
  * - `mode` — optional, syntax mode selector.
  *   Supported values:
- *     - `legacy` — force the existing legacy path syntax
- *     - `jsonpath` — force JSONPath syntax
+ *     - `legacy` — force the existing legacy path syntax;
+ *     - `jsonpath` — force JSONPath syntax.
  *   If omitted, the scriptlet detects JSONPath automatically only for clearly JSONPath-shaped expressions,
  *   otherwise it falls back to legacy syntax.
  *

src/scriptlets/trusted-prune-inbound-object.js

@@ -33,12 +33,12 @@ import {
  * example.org#%#//scriptlet('trusted-prune-inbound-object', functionName[, propsToRemove [, obligatoryProps [, stack]]])
  * ```
  *
- * - `functionName` — required, the name of the function to trap, it must have an object as an argument
- * - `propsToRemove` — optional, string of space-separated properties to remove
+ * - `functionName` — required, the name of the function to trap, it must have an object as an argument.
+ * - `propsToRemove` — optional, string of space-separated properties to remove.
  * - `obligatoryProps` — optional, string of space-separated properties
- *   which must be all present for the pruning to occur
+ *   which must be all present for the pruning to occur.
  * - `stack` — optional, string or regular expression that must match the current function call stack trace;
- *   if regular expression is invalid it will be skipped
+ *   if regular expression is invalid it will be skipped.
  *
  * > Note please that you can use wildcard `*` for chain property name,
  * > e.g. `ad.*.src` instead of `ad.0.src ad.1.src ad.2.src`.

wiki/about-scriptlets.md

@@ -1298,7 +1298,7 @@ example.org#%#//scriptlet('json-prune-xhr-response'[, propsToRemove[, obligatory
 
 <!-- markdownlint-enable line-length -->
 
-- `propsToRemove` — optional, string of space-separated properties to remove
+- `propsToRemove` — optional, string of space-separated properties to remove.
   In `jsonpath` mode only single JSONPath prune expression is supported.
 - `obligatoryProps` — optional, string of space-separated properties
   which must be all present for the pruning to occur
@@ -1427,7 +1427,7 @@ https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/json-prune.js
 example.org#%#//scriptlet('json-prune'[, propsToRemove [, obligatoryProps [, stack [, mode]]]])
 ```
 
-- `propsToRemove` — optional, string of space-separated properties to remove
+- `propsToRemove` — optional, string of space-separated properties to remove.
   In `jsonpath` mode only single JSONPath prune expression is supported.
 - `obligatoryProps` — optional, string of space-separated properties
   which must be all present for the pruning to occur