@dynatrace/strato-components 3.0.1 → 3.1.0

package/filters/filter-field/suggestions/SuggestionsOverlay.sty.js

@@ -26,8 +26,8 @@ __export(SuggestionsOverlay_css_exports, {
 });
 module.exports = __toCommonJS(SuggestionsOverlay_css_exports);
 var import_SuggestionsOverlay_css_ts_vanilla = require("./SuggestionsOverlay.css");
-var suggestionsOverlay = "_ssu5rt2-3-0-1";
-var suggestionsOverlayWrapper = "_ssu5rt1-3-0-1";
-var suggestionsOverlayWrapperContainer = "_ssu5rt0-3-0-1";
-var suggestionsScrollContainer = "_ssu5rt4-3-0-1";
-var suggestionsScrollContainerWrapper = "_ssu5rt3-3-0-1";
+var suggestionsOverlay = "_ssu5rt2-3-1-0";
+var suggestionsOverlayWrapper = "_ssu5rt1-3-1-0";
+var suggestionsOverlayWrapperContainer = "_ssu5rt0-3-1-0";
+var suggestionsScrollContainer = "_ssu5rt4-3-1-0";
+var suggestionsScrollContainerWrapper = "_ssu5rt3-3-1-0";

package/filters/filter-field/suggestions/suggestions-extension.d.ts

@@ -1,12 +1,12 @@
 import type { EditorState, Extension } from '@codemirror/state';
-import type { FilterFieldSuggestion } from './Suggestion.types.js';
 import type { OverlayTriggerState } from '../../../overlays/hooks/useOverlay.js';
 import type { FallbackKeys, FilterFieldProps, FilterStatementKeysMap } from '../FilterField.types.js';
+import type { FilterFieldSuggestion } from './Suggestion.types.js';
 import type { useCachedTreeConversion } from '../hooks/useCachedTreeConversion.js';
 import type { NumberFormatParser } from '../parser/getNumberParser.js';
 import type { FilterFieldGroupedSuggestions, FilterFieldSuggestionsCallback } from '../types/suggestions.js';
 import type { FilterFieldNode, FilterFieldStatementNode, FilterFieldValueNode } from '../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../types/validation.js';
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../types/validation.js';
 import { type FilterFieldSuggestionRecentPinnedSuggestion } from '../utils/suggestions-utils/recent-and-pinned-suggestions.js';
 /** @internal */
 export type FilterFieldSuggestionsContext = {
@@ -43,11 +43,12 @@ type SuggestionsExtensionProps = {
     parserConfig?: FilterFieldProps['parserConfig'];
     fallbackKeys?: FallbackKeys;
     filterStatementKeysMap?: FilterStatementKeysMap;
+    customTypes?: FilterFieldCustomTypes;
 };
 /**
  * @internal
  */
-export declare const suggestionsExtension: ({ overlayState, numberParser, validatorMap, fallbackKeys, filterStatementKeysMap, onSuggest, _onSuggest, getSyntaxTree, parserConfig, }: SuggestionsExtensionProps) => Extension;
+export declare const suggestionsExtension: ({ overlayState, numberParser, validatorMap, fallbackKeys, filterStatementKeysMap, onSuggest, _onSuggest, getSyntaxTree, customTypes, parserConfig, }: SuggestionsExtensionProps) => Extension;
 /** @internal */
 export declare function getTokenBeforePastedContent(pastedRangeFrom: number, editorState: EditorState, pastedContentToken: FilterFieldNode): {
     token: FilterFieldNode;

package/filters/filter-field/suggestions/suggestions-extension.js

@@ -43,6 +43,7 @@ const suggestionsExtension = ({
   onSuggest,
   _onSuggest,
   getSyntaxTree,
+  customTypes,
   parserConfig
 }) => {
   const filterFieldSuggestion = (context) => {
@@ -54,6 +55,7 @@ const suggestionsExtension = ({
       tree,
       numberParser,
       doc: context.state.doc.toString(),
+      customTypes,
       parserConfig
     });
     const pastingStateField = context.view?.state.field(import_editor_config.pastingMode, false);
@@ -150,6 +152,7 @@ const suggestionsExtension = ({
       currentTokenType,
       prevNode,
       validatorMap,
+      customTypes,
       showLogicalOperators,
       showInclusionOperators,
       doc: context.state.doc.toString(),
@@ -210,7 +213,7 @@ const suggestionsExtension = ({
         return;
       }
       if (update.focusChanged && update.view.hasFocus || update.transactions.some(
-        (transaction) => transaction.isUserEvent("input") || transaction.isUserEvent(import_editor_config.ANNOTATION_SUGGESTION_APPLY) || transaction.isUserEvent(import_editor_config.ANNOTATION_SUGGESTION_PIN) || transaction.isUserEvent("delete") || transaction.selection !== void 0
+        (transaction) => transaction.isUserEvent("input") || transaction.isUserEvent(import_editor_config.ANNOTATION_SUGGESTION_APPLY) || transaction.isUserEvent(import_editor_config.ANNOTATION_SUGGESTION_PIN) || transaction.isUserEvent("delete") || transaction.selection !== void 0 && (transaction.isUserEvent(import_editor_config.ANNOTATION_DOC_CHANGED_CONTROLLED) || update.view.hasFocus)
       )) {
         (0, import_autocomplete.startCompletion)(update.view);
         return;

package/filters/filter-field/types/validation.d.ts

@@ -1,3 +1,4 @@
+import type { ReactElement } from 'react';
 import type { FilterFieldError } from './filter-field-error.js';
 import type { FilterFieldDurationNode, FilterFieldLeafNode, FilterFieldStatementNode } from './tree-nodes.js';
 /**
@@ -10,6 +11,16 @@ export type FilterFieldComparisonOperators = 'equals' | 'not-equals' | 'less-tha
  * @public
  */
 export type FilterFieldPrimitive = 'Number' | 'String' | 'Boolean' | 'Duration' | 'JSONPath' | 'IPAddress' | 'UID' | 'Timestamp' | 'SmartscapeId' | 'Any';
+/**
+ * Map of custom types and their validation functions.
+ * @public
+ */
+export type FilterFieldCustomTypes = Record<string, ((value: string) => boolean) | {
+    /** Validation function to check whether a given value is of the given type. */
+    valuePredicate: (value: string) => boolean;
+    /** Icon to render for suggestions of this type. */
+    icon?: ReactElement;
+}>;
 /**
  * FilterField Duration type.
  * @public
@@ -37,7 +48,27 @@ export type FilterFieldDuration = Required<Pick<FilterFieldDurationNode, 'value'
  * ```
  * @public
  */
-export type FilterFieldValidatorMapTypePredicate = Record<'type', FilterFieldPrimitive | FilterFieldPrimitive[]>;
+export type FilterFieldValidatorMapTypePredicate = Record<'type', FilterFieldPrimitive | string | (FilterFieldPrimitive | string)[]>;
+/**
+ * Value predicate with optional metadata for displaying in suggestions.
+ * Allows specifying displayValue and details for value suggestions.
+ * @public
+ */
+export type FilterFieldRichValuePredicate = {
+    /**
+     * The actual value to apply when the suggestion is selected.
+     */
+    value: string | number | boolean;
+    /**
+     * The display value to show for the value suggestion.
+     * If not set, the value is used.
+     */
+    displayValue?: string;
+    /**
+     * Additional information to render for the value suggestion.
+     */
+    details?: string;
+};
 /**
  * Value predicate for restricting the valid values in the FilterField validatorMap.
  * @public
@@ -51,8 +82,10 @@ FilterFieldValidatorMapTypePredicate
  | number
 /** Boolean value allowed for the value of the given key. */
  | boolean | FilterFieldDuration
+/** Value with optional displayValue and details. */
+ | FilterFieldRichValuePredicate
 /** Value literals allowed for the value of the given key. */
- | Array<FilterFieldValidatorMapTypePredicate | string | number | boolean | FilterFieldDuration>;
+ | Array<FilterFieldValidatorMapTypePredicate | string | number | boolean | FilterFieldDuration | FilterFieldRichValuePredicate>;
 /**
  * Function executed for validating the value of a filter field statement.
  * - Returning true, the value is considered valid.
@@ -80,6 +113,8 @@ export type FilterFieldValidatorMap = {
             valuePredicate?: FilterFieldValuePredicate | FilterFieldValuePredicateFn;
             fallbackKey?: boolean | Array<Exclude<FilterFieldComparisonOperators, 'exists' | 'not-exists'>>;
             suggestStatementOnValueMatch?: boolean | FilterFieldValueMatchFn;
+            displayValue?: string;
+            details?: string;
         } | FilterFieldValidatorMapTypePredicate;
     }
     /**

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/group.d.ts

@@ -3,10 +3,10 @@ import type { FilterFieldProps } from '../../../../FilterField.types.js';
 import type { NumberFormatParser } from '../../../../parser/getNumberParser.js';
 import type { ConvertedLezerNode, FilterFieldFlatGroupNode } from '../../../../types/conversion-utils.js';
 import type { FilterFieldLezerNodeType } from '../../../../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../../../../types/validation.js';
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../../../../types/validation.js';
 /**
  * Convert a filter field group node.
  * The root 'Filter' node is also handled as group.
  * @internal
  */
-export declare function convertFilterGroup(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, validatorMap?: FilterFieldValidatorMap, parserConfig?: FilterFieldProps['parserConfig'], context?: FilterFieldLezerNodeType): ConvertedLezerNode<FilterFieldFlatGroupNode>;
+export declare function convertFilterGroup(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, validatorMap?: FilterFieldValidatorMap, customTypes?: FilterFieldCustomTypes, parserConfig?: FilterFieldProps['parserConfig'], context?: FilterFieldLezerNodeType): ConvertedLezerNode<FilterFieldFlatGroupNode>;

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/group.js

@@ -27,7 +27,7 @@ var import_decoration_marks = require("../../../../decorations/decoration-marks.
 var import_validation_helper_functions = require("../../../validation-utils/validation-helper-functions.js");
 var import_logical_operator = require("../logical-operator.js");
 var import_error = require("../value/error.js");
-function convertFilterGroup(node, doc, numberParser, validatorMap, parserConfig, context) {
+function convertFilterGroup(node, doc, numberParser, validatorMap, customTypes, parserConfig, context) {
   const { from, to } = node;
   const cursor = node.node.cursor();
   const convertedNode = {
@@ -60,6 +60,7 @@ function convertFilterGroup(node, doc, numberParser, validatorMap, parserConfig,
           doc,
           numberParser,
           validatorMap,
+          customTypes,
           parserConfig,
           "FilterGroup"
         );
@@ -74,6 +75,7 @@ function convertFilterGroup(node, doc, numberParser, validatorMap, parserConfig,
           doc,
           numberParser,
           validatorMap,
+          customTypes,
           parserConfig,
           context
         );

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/inclusion.d.ts

@@ -1,9 +1,11 @@
 import type { SyntaxNodeRef } from '@lezer/common';
+import type { FilterFieldProps } from '../../../../FilterField.types.js';
 import type { NumberFormatParser } from '../../../../parser/getNumberParser.js';
 import type { ConvertedLezerNode } from '../../../../types/conversion-utils.js';
 import type { FilterFieldListNode } from '../../../../types/tree-nodes.js';
+import { FilterFieldCustomTypes } from '../../../../types/validation.js';
 /**
  * Convert an inclusion node.
  * @internal
  */
-export declare function convertInclusionValue(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser): ConvertedLezerNode<FilterFieldListNode>;
+export declare function convertInclusionValue(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, customTypes?: FilterFieldCustomTypes, parserConfig?: FilterFieldProps['parserConfig']): ConvertedLezerNode<FilterFieldListNode>;

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/inclusion.js

@@ -29,7 +29,7 @@ var import_duration = require("../value/duration.js");
 var import_identifier = require("../value/identifier.js");
 var import_number = require("../value/number.js");
 var import_simple_value = require("../value/simple-value.js");
-function convertInclusionValue(node, doc, numberParser) {
+function convertInclusionValue(node, doc, numberParser, customTypes, parserConfig) {
   const { from, to } = node;
   const cursor = node.node.cursor();
   const convertedNode = {
@@ -63,7 +63,7 @@ function convertInclusionValue(node, doc, numberParser) {
           convertedNode: valueNode,
           errors: valueErrors,
           positionOperators
-        } = (0, import_simple_value.convertSimpleValue)(childNode, doc, numberParser);
+        } = (0, import_simple_value.convertSimpleValue)(childNode, doc, numberParser, customTypes, parserConfig);
         if (positionOperators) {
           (0, import_node_mutations.convertToErrorNode)(valueNode);
           for (const range of positionOperators.ranges) {

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/statement.d.ts

@@ -3,9 +3,9 @@ import type { FilterFieldProps } from '../../../../FilterField.types.js';
 import type { NumberFormatParser } from '../../../../parser/getNumberParser.js';
 import type { ConvertedLezerNode } from '../../../../types/conversion-utils.js';
 import type { FilterFieldLezerNodeType, FilterFieldStatementNode } from '../../../../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../../../../types/validation.js';
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../../../../types/validation.js';
 /**
  * Convert a filter field statement node.
  * @internal
  */
-export declare function convertFilterStatement(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, validatorMap?: FilterFieldValidatorMap, parserConfig?: FilterFieldProps['parserConfig'], context?: FilterFieldLezerNodeType): ConvertedLezerNode<FilterFieldStatementNode>;
+export declare function convertFilterStatement(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, validatorMap?: FilterFieldValidatorMap, customTypes?: FilterFieldCustomTypes, parserConfig?: FilterFieldProps['parserConfig'], context?: FilterFieldLezerNodeType): ConvertedLezerNode<FilterFieldStatementNode>;

package/filters/filter-field/utils/conversion/lezer-tree-conversion/parent-node/statement.js

@@ -70,7 +70,7 @@ function convertPositionOperators(convertedStatement, validatorMap, positionOper
     }
   }
 }
-function validateKeyAndValue(validatorMap, convertedStatement, doc, errors, parserConfig) {
+function validateKeyAndValue(validatorMap, convertedStatement, doc, errors, customTypes, parserConfig) {
   if (!validatorMap?.keyPredicates || !convertedStatement.key) {
     return;
   }
@@ -88,6 +88,7 @@ function validateKeyAndValue(validatorMap, convertedStatement, doc, errors, pars
         convertedStatement,
         validatorMap,
         errors,
+        customTypes,
         parserConfig
       );
     }
@@ -98,6 +99,7 @@ function validateKeyAndValue(validatorMap, convertedStatement, doc, errors, pars
       convertedStatement,
       validatorMap,
       errors,
+      customTypes,
       parserConfig
     );
     if (!isValid) {
@@ -107,7 +109,7 @@ function validateKeyAndValue(validatorMap, convertedStatement, doc, errors, pars
     }
   }
 }
-function validateSingleValue(value, doc, convertedStatement, validatorMap, errors = [], parserConfig) {
+function validateSingleValue(value, doc, convertedStatement, validatorMap, errors = [], customTypes, parserConfig) {
   if (!value || !convertedStatement.key) {
     return true;
   }
@@ -118,6 +120,7 @@ function validateSingleValue(value, doc, convertedStatement, validatorMap, error
     validatorMap,
     convertedStatement,
     doc.toString(),
+    customTypes,
     parserConfig
   );
   if (!isValid) {
@@ -149,7 +152,7 @@ function validateKey(key, validatorMap, errors = []) {
     });
   }
 }
-function convertFilterStatement(node, doc, numberParser, validatorMap, parserConfig, context) {
+function convertFilterStatement(node, doc, numberParser, validatorMap, customTypes, parserConfig, context) {
   const nodeName = node.name;
   const { from, to } = node;
   const cursor = node.node.cursor();
@@ -211,14 +214,20 @@ function convertFilterStatement(node, doc, numberParser, validatorMap, parserCon
           convertedNode: value,
           errors: valueErrors,
           positionOperators: valuePositionOperators
-        } = (0, import_simple_value.convertSimpleValue)(childNode, doc, numberParser, parserConfig);
+        } = (0, import_simple_value.convertSimpleValue)(
+          childNode,
+          doc,
+          numberParser,
+          customTypes,
+          parserConfig
+        );
         convertedStatement.value = value;
         errors.push(...valueErrors);
         positionOperators = valuePositionOperators;
         return updatePreviousAndContinue(nodeName2);
       }
       case "FilterIncludesValue": {
-        const { convertedNode: value, errors: valueErrors } = (0, import_inclusion.convertInclusionValue)(childNode, doc, numberParser);
+        const { convertedNode: value, errors: valueErrors } = (0, import_inclusion.convertInclusionValue)(childNode, doc, numberParser, customTypes, parserConfig);
         convertedStatement.value = value;
         errors.push(...valueErrors);
         return updatePreviousAndContinue(nodeName2);
@@ -331,6 +340,7 @@ function convertFilterStatement(node, doc, numberParser, validatorMap, parserCon
     convertedStatement,
     doc,
     errors,
+    customTypes,
     parserConfig
   );
   const operator = convertedStatement.comparisonOperator;

package/filters/filter-field/utils/conversion/lezer-tree-conversion/value/simple-value.d.ts

@@ -3,11 +3,11 @@ import type { FilterFieldProps } from '../../../../FilterField.types.js';
 import type { NumberFormatParser } from '../../../../parser/getNumberParser.js';
 import type { ConvertedLezerNode } from '../../../../types/conversion-utils.js';
 import type { FilterFieldLeafNode } from '../../../../types/tree-nodes.js';
-import type { PositionOperators } from '../../../../types/validation.js';
+import type { FilterFieldCustomTypes, PositionOperators } from '../../../../types/validation.js';
 /**
  * Convert a simple value node.
  * @internal
  */
-export declare function convertSimpleValue(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, parserConfig?: FilterFieldProps['parserConfig']): ConvertedLezerNode<FilterFieldLeafNode, {
+export declare function convertSimpleValue(node: SyntaxNodeRef, doc: string, numberParser: NumberFormatParser, customTypes?: FilterFieldCustomTypes, parserConfig?: FilterFieldProps['parserConfig']): ConvertedLezerNode<FilterFieldLeafNode, {
     positionOperators?: PositionOperators;
 }>;

package/filters/filter-field/utils/conversion/lezer-tree-conversion/value/simple-value.js

@@ -30,7 +30,7 @@ var import_duration = require("./duration.js");
 var import_identifier = require("./identifier.js");
 var import_number = require("./number.js");
 var import_validation_helper_functions = require("../../../validation-utils/validation-helper-functions.js");
-function convertSimpleValue(node, doc, numberParser, parserConfig) {
+function convertSimpleValue(node, doc, numberParser, customTypes, parserConfig) {
   const { from, to } = node;
   const cursor = node.node.cursor();
   let convertedNode = {
@@ -85,6 +85,10 @@ function convertSimpleValue(node, doc, numberParser, parserConfig) {
         ) {
           convertedNode.type = "SmartscapeId";
         }
+        const customType = (0, import_validation_helper_functions.isValidCustomType)(value, customTypes);
+        if (customType) {
+          convertedNode.type = customType;
+        }
         if (endsWithOperator || startsWithOperator) {
           if (!positionOperatorsInsideString) {
             positionOperatorsInsideString = { ranges: [] };

package/filters/filter-field/utils/conversion/string-tree-conversion.d.ts

@@ -1,7 +1,31 @@
 import type { FilterFieldProps } from '../../FilterField.types.js';
 import type { FilterFieldTree } from '../../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../../types/validation.js';
-/** @public */
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../../types/validation.js';
+/**
+ * Conversion util that converts a string into a filter field tree.
+ * @param filterString - Input string
+ * @param options - Conversion options
+ * @public
+ */
+export declare function convertStringToFilterFieldTree(filterString: string, options?: {
+    /** Validators to restrict allowed keys and their operators. */
+    validatorMap?: FilterFieldValidatorMap;
+    /** Map of custom types and their validation functions. */
+    customTypes?: FilterFieldCustomTypes;
+    /** Config to enable new nodes in the FilterFieldTree. */
+    parserConfig?: FilterFieldProps['parserConfig'];
+}): {
+    tree: FilterFieldTree;
+    isValid: boolean;
+};
+/**
+ * Conversion util that converts a string into a filter field tree.
+ * @param filterString - Input string
+ * @param validatorMap - Validators to restrict allowed keys and their operators
+ * @param parserConfig - Config to enable new nodes in the FilterFieldTree
+ * @public
+ * @deprecated Use the options object overload instead, passing a `ConvertStringToFilterFieldTreeOptions` object as the second argument.
+ */
 export declare function convertStringToFilterFieldTree(filterString: string, validatorMap?: FilterFieldValidatorMap, parserConfig?: FilterFieldProps['parserConfig']): {
     tree: FilterFieldTree;
     isValid: boolean;

package/filters/filter-field/utils/conversion/string-tree-conversion.js

@@ -24,13 +24,17 @@ module.exports = __toCommonJS(string_tree_conversion_exports);
 var import_tree_conversion = require("./tree-conversion.js");
 var import_getNumberParser = require("../../parser/getNumberParser.js");
 var import_parser = require("../../parser/parser.js");
-function convertStringToFilterFieldTree(filterString, validatorMapOrParserConfig, parserConfig) {
+function convertStringToFilterFieldTree(filterString, optionsOrValidatorMap, parserConfig) {
   let validatorMap;
-  let _parserConfig = parserConfig;
-  if (isFilterFieldValidatorMap(validatorMapOrParserConfig)) {
-    validatorMap = validatorMapOrParserConfig;
-  } else if (parserConfig === void 0) {
-    _parserConfig = validatorMapOrParserConfig;
+  let customTypes = void 0;
+  let _parserConfig;
+  if (isConvertStringToFilterFieldTreeOptions(optionsOrValidatorMap)) {
+    validatorMap = optionsOrValidatorMap?.validatorMap;
+    customTypes = optionsOrValidatorMap?.customTypes;
+    _parserConfig = optionsOrValidatorMap?.parserConfig;
+  } else {
+    validatorMap = optionsOrValidatorMap;
+    _parserConfig = parserConfig;
   }
   const numberParser = (0, import_getNumberParser.getNumberParser)();
   const parsedTree = import_parser.parser.parse(filterString);
@@ -39,12 +43,14 @@ function convertStringToFilterFieldTree(filterString, validatorMapOrParserConfig
     numberParser,
     doc: filterString,
     validatorMap,
+    customTypes,
     parserConfig: _parserConfig
   });
   return { tree, isValid };
 }
-function isFilterFieldValidatorMap(value) {
-  return typeof value === "object" && (value?.keyPredicates !== void 0 || typeof value?.exhaustive === "boolean") || Array.isArray(
-    value?.comparisonOperators
-  );
+function isConvertStringToFilterFieldTreeOptions(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  return "validatorMap" in value || "customTypes" in value || "parserConfig" in value;
 }

package/filters/filter-field/utils/conversion/tree-conversion.d.ts

@@ -3,7 +3,7 @@ import type { Tree } from '@lezer/common';
 import type { FilterFieldProps } from '../../FilterField.types.js';
 import type { NumberFormatParser } from '../../parser/getNumberParser.js';
 import type { FilterFieldTree } from '../../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../../types/validation.js';
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../../types/validation.js';
 /**
  * Used parser version
  * @internal
@@ -13,12 +13,13 @@ export declare const parserVersion = "004";
  * Iterate over the parsed document and convert the lezer tree to an object.
  * @internal
  */
-export declare function convertLezerTree({ tree, view, numberParser, doc, validatorMap, parserConfig, }: {
+export declare function convertLezerTree({ tree, view, numberParser, doc, validatorMap, customTypes, parserConfig, }: {
     tree: Tree;
     numberParser: NumberFormatParser;
     view?: EditorView;
     doc?: string;
     validatorMap?: FilterFieldValidatorMap;
+    customTypes?: FilterFieldCustomTypes;
     parserConfig?: FilterFieldProps['parserConfig'];
 }): {
     tree?: FilterFieldTree;

package/filters/filter-field/utils/conversion/tree-conversion.js

@@ -32,6 +32,7 @@ function convertLezerTree({
   numberParser,
   doc,
   validatorMap,
+  customTypes,
   parserConfig
 }) {
   const errorsStateField = view?.state.field(import_editor_config.usedErrors, false);
@@ -44,6 +45,7 @@ function convertLezerTree({
     numberParser,
     doc,
     validatorMap,
+    customTypes,
     parserConfig
   });
   const {
@@ -70,6 +72,7 @@ function convertFlatLezerTree({
   numberParser,
   doc,
   validatorMap,
+  customTypes,
   parserConfig
 }) {
   if (!doc || doc.toString() === "") {
@@ -95,6 +98,7 @@ function convertFlatLezerTree({
           doc,
           numberParser,
           validatorMap,
+          customTypes,
           parserConfig,
           "Filter"
         );

package/filters/filter-field/utils/suggestions-utils/flatten-suggestions.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from 'react';
+import type { FilterFieldSuggestion, FlattenedSuggestionItem, GroupMetadata } from '../../suggestions/Suggestion.types.js';
+import type { FilterFieldSuggestionGroup } from '../../suggestions/SuggestionGroup.types.js';
+/**
+ * Flattens a suggestions array so that every suggestion — whether standalone or inside a group — becomes its own entry.
+ * Group labels are emitted as separate `group-header` items.
+ * Empty groups are omitted entirely.
+ * The original array can contain:
+ * - Data objects of type FilterFieldSuggestion and FilterFieldSuggestionGroup
+ * - FilterField.SuggestionGroup and FilterField.SuggestionGroupLabel elements
+ * @internal
+ */
+export declare function flattenSuggestions(items: (ReactNode | FilterFieldSuggestion | FilterFieldSuggestionGroup)[]): {
+    flattenedSuggestionItems: FlattenedSuggestionItem[];
+    groupMetadata: GroupMetadata[];
+};

package/filters/filter-field/utils/suggestions-utils/flatten-suggestions.js

@@ -0,0 +1,117 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var flatten_suggestions_exports = {};
+__export(flatten_suggestions_exports, {
+  flattenSuggestions: () => flattenSuggestions
+});
+module.exports = __toCommonJS(flatten_suggestions_exports);
+var import_react = require("react");
+var import_is_slot = require("../../../../core/utils/is-slot.js");
+var import_SuggestionGroup = require("../../suggestions/SuggestionGroup.js");
+var import_SuggestionGroupLabel = require("../../suggestions/SuggestionGroupLabel.js");
+var import_tree_node_guards = require("../tree-node-guards.js");
+function flattenSuggestions(items) {
+  const flattenedSuggestionItems = [];
+  const groupMetadata = [];
+  let isFirstGroup = true;
+  for (let index = 0; index < items.length; index++) {
+    const item = items[index];
+    if ((0, import_react.isValidElement)(item)) {
+      if ((0, import_is_slot.isSlot)(item, import_SuggestionGroup.SuggestionGroup)) {
+        const { label, suggestions, children, id } = item.props;
+        const groupId = id ?? `__group_${index}`;
+        const childArray = import_react.Children.toArray(children);
+        const labelSlot = (0, import_is_slot.isSlot)(childArray[0], import_SuggestionGroupLabel.SuggestionGroupLabel) ? childArray[0] : void 0;
+        const groupedSuggestionChildren = labelSlot ? childArray.slice(1) : childArray;
+        const suggestionCount = (suggestions?.length ?? 0) + groupedSuggestionChildren.length;
+        if (suggestionCount === 0) {
+          continue;
+        }
+        const hasLabel = labelSlot !== void 0 || label !== void 0;
+        const shouldAddHeader = hasLabel || !isFirstGroup;
+        isFirstGroup = false;
+        if (shouldAddHeader) {
+          if (labelSlot) {
+            flattenedSuggestionItems.push({
+              kind: "group-header",
+              label: labelSlot,
+              groupId
+            });
+            groupMetadata.push({ groupId, label: labelSlot });
+          } else if (label) {
+            flattenedSuggestionItems.push({
+              kind: "group-header",
+              label,
+              groupId
+            });
+            groupMetadata.push({ groupId, label });
+          } else {
+            flattenedSuggestionItems.push({ kind: "group-header", groupId });
+          }
+        }
+        if (suggestions) {
+          for (const s of suggestions) {
+            flattenedSuggestionItems.push({
+              kind: "suggestion",
+              data: s,
+              groupId
+            });
+          }
+        }
+        for (const child of groupedSuggestionChildren) {
+          flattenedSuggestionItems.push({
+            kind: "react-node",
+            node: child,
+            groupId
+          });
+        }
+        continue;
+      }
+      flattenedSuggestionItems.push({ kind: "react-node", node: item });
+      continue;
+    }
+    if ((0, import_tree_node_guards.isFilterFieldSuggestionGroup)(item)) {
+      const groupId = item.id ?? `__group_${index}`;
+      if (!item.suggestions || item.suggestions.length === 0) {
+        continue;
+      }
+      const hasLabel = item.label !== void 0;
+      const shouldAddHeader = hasLabel || !isFirstGroup;
+      isFirstGroup = false;
+      if (shouldAddHeader) {
+        flattenedSuggestionItems.push({
+          kind: "group-header",
+          label: item.label,
+          groupId
+        });
+        if (hasLabel) {
+          groupMetadata.push({ groupId, label: item.label });
+        }
+      }
+      for (const s of item.suggestions) {
+        flattenedSuggestionItems.push({ kind: "suggestion", data: s, groupId });
+      }
+      continue;
+    }
+    if ((0, import_tree_node_guards.isFilterFieldSuggestion)(item)) {
+      flattenedSuggestionItems.push({ kind: "suggestion", data: item });
+    }
+  }
+  return { flattenedSuggestionItems, groupMetadata };
+}

package/filters/filter-field/utils/suggestions-utils/get-suggestions.d.ts

@@ -3,15 +3,9 @@ import type { FilterFieldProps } from '../../FilterField.types.js';
 import type { FilterFieldSuggestion } from '../../suggestions/Suggestion.types.js';
 import type { FilterFieldGroupedSuggestions, FilterFieldSuggestionsCallback } from '../../types/suggestions.js';
 import type { FilterFieldLezerNodeType, FilterFieldStatementNode, FilterFieldStatementTokenType, FilterFieldValueNode } from '../../types/tree-nodes.js';
-import type { FilterFieldValidatorMap } from '../../types/validation.js';
-/**
- * Matches a potential JSONPath (also incomplete ones like `content$.`)
- * https://regex101.com/r/9QQvzF/1
- * @internal
- */
-export declare const JSONPATH_PATTERN_PARTIAL: RegExp;
+import type { FilterFieldCustomTypes, FilterFieldValidatorMap } from '../../types/validation.js';
 /** @internal */
-export declare function getSuggestions({ suggestionTypes, overlappingSuggestions, currentStatement, currentToken, currentTokenType, prevNode, validatorMap, parserConfig, showLogicalOperators, showInclusionOperators, doc, suggestionTypeForToken, }: {
+export declare function getSuggestions({ suggestionTypes, overlappingSuggestions, currentStatement, currentToken, currentTokenType, prevNode, validatorMap, customTypes, parserConfig, showLogicalOperators, showInclusionOperators, doc, suggestionTypeForToken, }: {
     suggestionTypes: NonNullable<Parameters<FilterFieldSuggestionsCallback>[0]>['suggestionTypes'];
     overlappingSuggestions?: FilterFieldOverlappingSuggestions;
     currentStatement: FilterFieldStatementNode | undefined;
@@ -19,6 +13,7 @@ export declare function getSuggestions({ suggestionTypes, overlappingSuggestions
     currentTokenType?: FilterFieldStatementTokenType;
     prevNode: FilterFieldLezerNodeType | 'FilterValue';
     validatorMap?: FilterFieldValidatorMap;
+    customTypes?: FilterFieldCustomTypes;
     parserConfig?: FilterFieldProps['parserConfig'];
     showLogicalOperators: boolean;
     showInclusionOperators: boolean;