@wallarm-org/design-system 0.27.1-rc-feature-WDS-96-update-data-input-component.1 → 0.27.1

package/dist/components/FilterInput/FilterInput.d.ts

@@ -1,6 +1,20 @@
 import type { FC, HTMLAttributes } from 'react';
 import type { ExprNode, FieldMetadata } from './types';
 export interface FilterInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange'> {
+    /**
+     * Filter-field configurations driving the autocomplete. Most fields are
+     * passed through as-is, but a few names are **reserved** and auto-wired
+     * with design-system helpers (`acceptChar` / `normalize` / `getSuggestions`
+     * / `validate`). Current reserved names:
+     *
+     *   - `status_code` — HTTP status code field (mask suggestions, format
+     *     validation, digit-or-X input filter, partial-input normalization).
+     *
+     * Consumer-supplied callbacks always override the auto-wiring, so you can
+     * opt out per-field. For the same helpers on a field with a different
+     * `name`, import the factories (`createStatusCodeSuggestions`, …) and
+     * attach them manually.
+     */
     fields?: FieldMetadata[];
     value?: ExprNode | null;
     onChange?: (expression: ExprNode | null) => void;

package/dist/components/FilterInput/FilterInput.js

@@ -6,7 +6,8 @@ import { FilterInputErrors, parseFilterInputErrors } from "./FilterInputErrors/i
 import { FilterInputField } from "./FilterInputField/index.js";
 import { FilterInputMenu } from "./FilterInputMenu/FilterInputMenu.js";
 import { useFilterInputAutocomplete, useFilterInputExpression, useFilterInputSelection } from "./hooks/index.js";
-const FilterInput = ({ fields = [], value, onChange, placeholder = 'Type to filter...', error = false, showKeyboardHint = false, className, ...props })=>{
+import { applyKnownFieldHelpers } from "./lib/applyKnownFieldHelpers.js";
+const FilterInput = ({ fields: rawFields = [], value, onChange, placeholder = 'Type to filter...', error = false, showKeyboardHint = false, className, ...props })=>{
     const inputRef = useRef(null);
     const containerRef = useRef(null);
     const buildingChipRef = useRef(null);
@@ -15,6 +16,9 @@ const FilterInput = ({ fields = [], value, onChange, placeholder = 'Type to filt
         if (el) chipRegistryRef.current.set(id, el);
         else chipRegistryRef.current.delete(id);
     }, []);
+    const fields = useMemo(()=>applyKnownFieldHelpers(rawFields), [
+        rawFields
+    ]);
     const { conditions, connectors, chips, upsertCondition, removeCondition, removeConditionAtIndex, clearAll, setConnectorValue } = useFilterInputExpression({
         fields,
         value,

package/dist/components/FilterInput/index.d.ts

@@ -1,5 +1,5 @@
 export { FilterInput, type FilterInputProps } from './FilterInput';
 export { FilterInputChip, type FilterInputChipProps } from './FilterInputField';
 export { FilterInputFieldMenu, type FilterInputFieldMenuProps, FilterInputOperatorMenu, type FilterInputOperatorMenuProps, FilterInputValueMenu, type FilterInputValueMenuProps, type ValueOption, } from './FilterInputMenu';
-export { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator, type FilterParseError, isFilterParseError, parseExpression, type StatusCodeSuggestionsOptions, serializeExpression, } from './lib';
+export { applyFieldValueTransforms, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator, type FilterParseError, isFilterParseError, parseExpression, serializeExpression, } from './lib';
 export type { Condition, ExprNode, FieldMetadata, FieldType, FieldValueOption, FilterInputChipData, FilterInputChipVariant, FilterOperator, Group, } from './types';

package/dist/components/FilterInput/index.js

@@ -1,5 +1,5 @@
 import { FilterInput } from "./FilterInput.js";
 import { FilterInputChip } from "./FilterInputField/index.js";
 import { FilterInputFieldMenu, FilterInputOperatorMenu, FilterInputValueMenu } from "./FilterInputMenu/index.js";
-import { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator, isFilterParseError, parseExpression, serializeExpression } from "./lib/index.js";
-export { FilterInput, FilterInputChip, FilterInputFieldMenu, FilterInputOperatorMenu, FilterInputValueMenu, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator, isFilterParseError, parseExpression, serializeExpression };
+import { applyFieldValueTransforms, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator, isFilterParseError, parseExpression, serializeExpression } from "./lib/index.js";
+export { FilterInput, FilterInputChip, FilterInputFieldMenu, FilterInputOperatorMenu, FilterInputValueMenu, applyFieldValueTransforms, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator, isFilterParseError, parseExpression, serializeExpression };

package/dist/components/FilterInput/lib/applyFieldValueTransforms.d.ts

@@ -0,0 +1,11 @@
+import type { ExprNode, FieldMetadata } from '../types';
+/**
+ * Walk an expression tree and apply each field's `serializeValue` hook to the
+ * matching condition's value. Typical use: consumer has the UI-facing
+ * `ExprNode` (e.g. status code chip with `"2XX"`) and wants the backend
+ * payload to carry the transformed form (`"2"`).
+ *
+ * Returns the original node (by reference) when nothing changed, so
+ * downstream memoization stays stable.
+ */
+export declare const applyFieldValueTransforms: (expr: ExprNode | null, fields: FieldMetadata[]) => ExprNode | null;

package/dist/components/FilterInput/lib/applyFieldValueTransforms.js

@@ -0,0 +1,43 @@
+const transformConditionValue = (condition, fieldsByName)=>{
+    const field = fieldsByName.get(condition.field);
+    const transform = field?.serializeValue;
+    if (!transform) return condition;
+    const { value } = condition;
+    if (null == value) return condition;
+    if (Array.isArray(value)) {
+        const next = value.map((v)=>transform(v));
+        if (next.every((v, i)=>v === value[i])) return condition;
+        return {
+            ...condition,
+            value: next
+        };
+    }
+    const next = transform(value);
+    if (next === value) return condition;
+    return {
+        ...condition,
+        value: next
+    };
+};
+const transformGroup = (group, fieldsByName)=>{
+    const children = group.children.map((child)=>transformNode(child, fieldsByName));
+    if (children.every((c, i)=>c === group.children[i])) return group;
+    return {
+        ...group,
+        children
+    };
+};
+const transformNode = (node, fieldsByName)=>{
+    if ('condition' === node.type) return transformConditionValue(node, fieldsByName);
+    return transformGroup(node, fieldsByName);
+};
+const applyFieldValueTransforms = (expr, fields)=>{
+    if (!expr) return expr;
+    if (!fields.some((f)=>f.serializeValue)) return expr;
+    const fieldsByName = new Map(fields.map((f)=>[
+            f.name,
+            f
+        ]));
+    return transformNode(expr, fieldsByName);
+};
+export { applyFieldValueTransforms };

package/dist/components/FilterInput/lib/applyKnownFieldHelpers.d.ts

@@ -0,0 +1,21 @@
+import type { FieldMetadata } from '../types';
+/**
+ * Decorate `fields` in place with design-system helpers for known field names.
+ * `FilterInput` calls this on the `fields` prop before rendering.
+ *
+ * Reserved names and what they auto-attach (unless the consumer already
+ * provided a value for that slot):
+ *
+ * | `name`        | Attaches                                                                                   |
+ * | ------------- | ------------------------------------------------------------------------------------------ |
+ * | `status_code` | HTTP status code: `acceptChar`, `normalize`, `getSuggestions`, `validate`, `serializeValue` |
+ *
+ * Consumer-supplied callbacks always win over the auto-wired ones. If the
+ * backend uses a different name (e.g. `http_status_code`), the helpers are
+ * NOT applied — the consumer must either rename the field to match or wire
+ * the factories (`createStatusCode*`) manually.
+ *
+ * The returned array has **reference-stable identity** when no field matches,
+ * so downstream `useMemo` that depends on it does not invalidate unnecessarily.
+ */
+export declare const applyKnownFieldHelpers: (fields: FieldMetadata[]) => FieldMetadata[];

package/dist/components/FilterInput/lib/applyKnownFieldHelpers.js

@@ -0,0 +1,29 @@
+import { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator } from "./statusCode/index.js";
+const KNOWN_FIELD_HELPERS = {
+    status_code: ()=>({
+            acceptChar: createStatusCodeInputFilter(),
+            normalize: createStatusCodeNormalizer(),
+            getSuggestions: createStatusCodeSuggestions(),
+            validate: createStatusCodeValidator(),
+            serializeValue: createStatusCodeSerializer()
+        })
+};
+const applyKnownFieldHelpers = (fields)=>{
+    let changed = false;
+    const out = fields.map((field)=>{
+        const factory = KNOWN_FIELD_HELPERS[field.name];
+        if (!factory) return field;
+        const helpers = factory();
+        changed = true;
+        return {
+            ...field,
+            acceptChar: field.acceptChar ?? helpers.acceptChar,
+            normalize: field.normalize ?? helpers.normalize,
+            getSuggestions: field.getSuggestions ?? helpers.getSuggestions,
+            validate: field.validate ?? helpers.validate,
+            serializeValue: field.serializeValue ?? helpers.serializeValue
+        };
+    });
+    return changed ? out : fields;
+};
+export { applyKnownFieldHelpers };

package/dist/components/FilterInput/lib/index.d.ts

@@ -1,6 +1,8 @@
 export type { DatePreset } from '../FilterInputMenu/FilterInputDateValueMenu/constants';
 export { DATE_PRESETS, formatDateForChip, getDateDisplayLabel, isDatePreset, } from '../FilterInputMenu/FilterInputDateValueMenu/constants';
 export { applyAcceptChar } from './applyAcceptChar';
+export { applyFieldValueTransforms } from './applyFieldValueTransforms';
+export { applyKnownFieldHelpers } from './applyKnownFieldHelpers';
 export { chipIdToConditionIndex, findChipSplitIndex } from './conditions';
 export { CONNECTOR_ID_PATTERN, NO_VALUE_OPERATORS, OPERATOR_LABELS, OPERATOR_LABELS_BY_TYPE, OPERATOR_SYMBOLS, OPERATORS_BY_TYPE, QUERY_BAR_SELECTOR, VARIANT_LABELS, } from './constants';
 export { buildContainerAnchoredRect, isMenuRelated } from './dom';
@@ -10,4 +12,4 @@ export { getCurrentValueTokenText, getValueFilterText } from './menuFilterText';
 export { getOperatorFromLabel, getOperatorLabel, isBetweenOperator, isMultiSelectOperator, isNoValueOperator, } from './operators';
 export { type FilterParseError, isFilterParseError, parseExpression } from './parseExpression';
 export { serializeExpression } from './serializeExpression';
-export { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator, type StatusCodeSuggestionsOptions, } from './statusCode';
+export { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator, } from './statusCode';

package/dist/components/FilterInput/lib/index.js

@@ -1,5 +1,7 @@
 import { DATE_PRESETS, formatDateForChip, getDateDisplayLabel, isDatePreset } from "../FilterInputMenu/FilterInputDateValueMenu/constants.js";
 import { applyAcceptChar } from "./applyAcceptChar.js";
+import { applyFieldValueTransforms } from "./applyFieldValueTransforms.js";
+import { applyKnownFieldHelpers } from "./applyKnownFieldHelpers.js";
 import { chipIdToConditionIndex, findChipSplitIndex } from "./conditions.js";
 import { CONNECTOR_ID_PATTERN, NO_VALUE_OPERATORS, OPERATORS_BY_TYPE, OPERATOR_LABELS, OPERATOR_LABELS_BY_TYPE, OPERATOR_SYMBOLS, QUERY_BAR_SELECTOR, VARIANT_LABELS } from "./constants.js";
 import { buildContainerAnchoredRect, isMenuRelated } from "./dom.js";
@@ -9,5 +11,5 @@ import { getCurrentValueTokenText, getValueFilterText } from "./menuFilterText.j
 import { getOperatorFromLabel, getOperatorLabel, isBetweenOperator, isMultiSelectOperator, isNoValueOperator } from "./operators.js";
 import { isFilterParseError, parseExpression } from "./parseExpression/index.js";
 import { serializeExpression } from "./serializeExpression.js";
-import { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator } from "./statusCode/index.js";
-export { CONNECTOR_ID_PATTERN, DATE_PRESETS, NO_VALUE_OPERATORS, OPERATORS_BY_TYPE, OPERATOR_LABELS, OPERATOR_LABELS_BY_TYPE, OPERATOR_SYMBOLS, QUERY_BAR_SELECTOR, VARIANT_LABELS, applyAcceptChar, buildContainerAnchoredRect, chipIdToConditionIndex, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator, filterAndSort, findChipSplitIndex, formatDateForChip, getCurrentValueTokenText, getDateDisplayLabel, getFieldValues, getOperatorFromLabel, getOperatorLabel, getValueFilterText, hasFieldValues, hasStaticAllowlist, isBetweenOperator, isDatePreset, isFilterParseError, isMenuRelated, isMultiSelectOperator, isNoValueOperator, parseExpression, serializeExpression };
+import { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator } from "./statusCode/index.js";
+export { CONNECTOR_ID_PATTERN, DATE_PRESETS, NO_VALUE_OPERATORS, OPERATORS_BY_TYPE, OPERATOR_LABELS, OPERATOR_LABELS_BY_TYPE, OPERATOR_SYMBOLS, QUERY_BAR_SELECTOR, VARIANT_LABELS, applyAcceptChar, applyFieldValueTransforms, applyKnownFieldHelpers, buildContainerAnchoredRect, chipIdToConditionIndex, createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator, filterAndSort, findChipSplitIndex, formatDateForChip, getCurrentValueTokenText, getDateDisplayLabel, getFieldValues, getOperatorFromLabel, getOperatorLabel, getValueFilterText, hasFieldValues, hasStaticAllowlist, isBetweenOperator, isDatePreset, isFilterParseError, isMenuRelated, isMultiSelectOperator, isNoValueOperator, parseExpression, serializeExpression };

package/dist/components/FilterInput/lib/serializeExpression.d.ts

@@ -1,6 +1,16 @@
-import type { ExprNode } from '../types';
+import type { ExprNode, FieldMetadata } from '../types';
 /**
  * Serialize an expression tree to a canonical text string.
  * Top-level conditions are sorted alphabetically by field name.
+ *
+ * **Pass `fields` when the output targets the backend.** Per-field
+ * `serializeValue` hooks run first, so values like the status-code mask
+ * `"2XX"` become `"2"` in the emitted string. Omitting `fields` keeps the
+ * UI-facing values verbatim — useful for clipboard round-trip, debug
+ * display, or any case where the output feeds `parseExpression` back. If
+ * you forget `fields` on the path to the backend, the placeholder `X`s
+ * ride through silently — name the backend call-site helper explicitly
+ * (e.g. `const query = serializeExpression(expr, fields)`) to make the
+ * intent obvious at callsite.
  */
-export declare const serializeExpression: (expr: ExprNode | null) => string;
+export declare const serializeExpression: (expr: ExprNode | null, fields?: FieldMetadata[]) => string;

package/dist/components/FilterInput/lib/serializeExpression.js

@@ -1,3 +1,4 @@
+import { applyFieldValueTransforms } from "./applyFieldValueTransforms.js";
 const quoteValue = (v)=>`"${v}"`;
 const serializeValue = (condition)=>{
     if ('is_null' === condition.operator || 'is_not_null' === condition.operator) return '';
@@ -27,8 +28,10 @@ const serializeNode = (node, isTopLevel)=>{
     if ('condition' === node.type) return serializeCondition(node);
     return serializeGroup(node, isTopLevel);
 };
-const serializeExpression = (expr)=>{
+const serializeExpression = (expr, fields)=>{
     if (!expr) return '';
-    return serializeNode(expr, true);
+    const normalized = fields ? applyFieldValueTransforms(expr, fields) : expr;
+    if (!normalized) return '';
+    return serializeNode(normalized, true);
 };
 export { serializeExpression };

package/dist/components/FilterInput/lib/statusCode/createStatusCodeSerializer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Build the `serializeValue` callback for the HTTP status code field. Strips
+ * trailing mask placeholders (`X` / `x`) from the UI value so the backend
+ * receives the shorter class form:
+ *
+ *   "2XX" → "2"
+ *   "22X" → "22"
+ *   "222" → "222"
+ *   "4XX" → "4"
+ *   "40X" → "40"
+ *
+ * Anything that isn't a status-code-shaped string (e.g. a number, boolean,
+ * or freeform text) is returned unchanged so invalid committed values still
+ * surface in the backend payload for the parser to reject.
+ */
+export declare const createStatusCodeSerializer: () => ((value: string | number | boolean) => string | number | boolean);

package/dist/components/FilterInput/lib/statusCode/createStatusCodeSerializer.js

@@ -0,0 +1,6 @@
+const createStatusCodeSerializer = ()=>(value)=>{
+        if ('string' != typeof value) return value;
+        if (!/^\d[\dX]{0,2}$/i.test(value)) return value;
+        return value.replace(/X+$/i, '');
+    };
+export { createStatusCodeSerializer };

package/dist/components/FilterInput/lib/statusCode/createStatusCodeSuggestions.d.ts

@@ -1,16 +1,17 @@
 import type { FieldValueOption } from '../../types';
-import { type StatusCodeSuggestionsOptions } from './utils';
 /**
  * Build the `getSuggestions` callback for an HTTP status code field. The
  * returned function:
- *   - reads the active `maskRoots` from `options.codes`
- *   - on empty input, offers every available class mask
+ *   - on empty input, offers every HTTP class mask (`1XX..5XX`)
  *   - on partial input (`"3"`, `"3X"`, `"30"`, …), expands it via
  *     `canonicalizeStatusCodeInput` and offers the single matching mask
  *   - merges any `context.selectedValues` (values already committed to the
  *     chip) in front of the input-driven output so they always appear with
  *     their canonical badge styling
+ *
+ * No backend config is required — the status-code class range is fixed to
+ * `[1..5]` per the HTTP spec.
  */
-export declare const createStatusCodeSuggestions: (options?: StatusCodeSuggestionsOptions) => ((inputText: string, context?: {
+export declare const createStatusCodeSuggestions: () => ((inputText: string, context?: {
     selectedValues?: Array<string | number | boolean>;
 }) => FieldValueOption[]);

package/dist/components/FilterInput/lib/statusCode/createStatusCodeSuggestions.js

@@ -1,7 +1,6 @@
-import { canonicalizeStatusCodeInput, getMaskRoots, makeMask } from "./utils/index.js";
-const createStatusCodeSuggestions = (options)=>{
-    const maskRoots = getMaskRoots(options?.codes);
-    const resolveSelected = (selectedValues)=>(selectedValues ?? []).map((v)=>String(v)).filter((s)=>/^\d[\dX]{0,2}$/.test(s) && maskRoots.includes(s.charAt(0))).map((s)=>makeMask(s));
+import { MASK_ROOTS, canonicalizeStatusCodeInput, makeMask } from "./utils/index.js";
+const createStatusCodeSuggestions = ()=>{
+    const resolveSelected = (selectedValues)=>(selectedValues ?? []).map((v)=>String(v)).filter((s)=>/^\d[\dX]{0,2}$/.test(s) && MASK_ROOTS.includes(s.charAt(0))).map((s)=>makeMask(s));
     return (inputText, context)=>{
         const norm = inputText.trim();
         const selected = resolveSelected(context?.selectedValues);
@@ -10,8 +9,8 @@ const createStatusCodeSuggestions = (options)=>{
                 ...selected,
                 ...primary.filter((o)=>!seen.has(String(o.value)))
             ];
-        if (0 === norm.length) return merge(maskRoots.map((d)=>makeMask(`${d}XX`)));
-        const mask = canonicalizeStatusCodeInput(norm, maskRoots);
+        if (0 === norm.length) return merge(MASK_ROOTS.map((d)=>makeMask(`${d}XX`)));
+        const mask = canonicalizeStatusCodeInput(norm);
         if (!mask) return selected;
         return merge([
             makeMask(mask)

package/dist/components/FilterInput/lib/statusCode/createStatusCodeValidator.d.ts

@@ -1,4 +1,3 @@
-import { type StatusCodeSuggestionsOptions } from './utils';
 /**
  * Build a validator for the HTTP status code field. Accepts only 3-character
  * values whose leading digit is a valid HTTP class (`[1..5]`) and whose
@@ -9,11 +8,5 @@ import { type StatusCodeSuggestionsOptions } from './utils';
  *
  * Returns `true` when the value is invalid, matching the
  * `FieldMetadata.validate` contract.
- *
- * The `options` argument is accepted for API symmetry with
- * `createStatusCodeSuggestions` (same wiring on the field), but validity is
- * bound to the static `[1..5]` HTTP class range rather than `codes` — the
- * backend's available-data list doesn't narrow what the user may legitimately
- * type.
  */
-export declare const createStatusCodeValidator: (_options?: StatusCodeSuggestionsOptions) => ((value: string | number | boolean) => boolean);
+export declare const createStatusCodeValidator: () => ((value: string | number | boolean) => boolean);

package/dist/components/FilterInput/lib/statusCode/createStatusCodeValidator.js

@@ -1,8 +1,8 @@
-import { STATUS_CODE_LENGTH, VALID_MASK_ROOTS } from "./utils/index.js";
-const createStatusCodeValidator = (_options)=>(value)=>{
+import { MASK_ROOTS, STATUS_CODE_LENGTH } from "./utils/index.js";
+const createStatusCodeValidator = ()=>(value)=>{
         const s = String(value);
         if (s.length !== STATUS_CODE_LENGTH) return true;
-        if (!VALID_MASK_ROOTS.has(s.charAt(0))) return true;
+        if (!MASK_ROOTS.includes(s.charAt(0))) return true;
         return !/^(XX|\dX|\d\d)$/.test(s.slice(1));
     };
 export { createStatusCodeValidator };

package/dist/components/FilterInput/lib/statusCode/index.d.ts

@@ -1,5 +1,5 @@
 export { createStatusCodeInputFilter } from './createStatusCodeInputFilter';
 export { createStatusCodeNormalizer } from './createStatusCodeNormalizer';
+export { createStatusCodeSerializer } from './createStatusCodeSerializer';
 export { createStatusCodeSuggestions } from './createStatusCodeSuggestions';
 export { createStatusCodeValidator } from './createStatusCodeValidator';
-export type { StatusCodeSuggestionsOptions } from './utils';

package/dist/components/FilterInput/lib/statusCode/index.js

@@ -1,5 +1,6 @@
 import { createStatusCodeInputFilter } from "./createStatusCodeInputFilter.js";
 import { createStatusCodeNormalizer } from "./createStatusCodeNormalizer.js";
+import { createStatusCodeSerializer } from "./createStatusCodeSerializer.js";
 import { createStatusCodeSuggestions } from "./createStatusCodeSuggestions.js";
 import { createStatusCodeValidator } from "./createStatusCodeValidator.js";
-export { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator };
+export { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSerializer, createStatusCodeSuggestions, createStatusCodeValidator };

package/dist/components/FilterInput/lib/statusCode/utils/canonicalize.d.ts

@@ -14,7 +14,7 @@
  * Rejected:
  *   "3X0"            (digit after placeholder)
  *   "X30"            (starts with placeholder)
- *   "6..."           (leading digit not in `maskRoots`)
+ *   "6..."           (leading digit outside the `[1..5]` HTTP class range)
  *   "ab..."          (non-digit, non-X)
  */
-export declare const canonicalizeStatusCodeInput: (input: string, maskRoots: string[]) => string | null;
+export declare const canonicalizeStatusCodeInput: (input: string) => string | null;

package/dist/components/FilterInput/lib/statusCode/utils/canonicalize.js

@@ -1,10 +1,10 @@
-import { MASK_PLACEHOLDER, STATUS_CODE_LENGTH } from "./constants.js";
-const canonicalizeStatusCodeInput = (input, maskRoots)=>{
+import { MASK_PLACEHOLDER, MASK_ROOTS, STATUS_CODE_LENGTH } from "./constants.js";
+const canonicalizeStatusCodeInput = (input)=>{
     const s = input.toUpperCase();
     if (0 === s.length || s.length > STATUS_CODE_LENGTH) return null;
     if (!/^[\dX]+$/.test(s)) return null;
     const d1 = s.charAt(0);
-    if (d1 === MASK_PLACEHOLDER || !maskRoots.includes(d1)) return null;
+    if (d1 === MASK_PLACEHOLDER || !MASK_ROOTS.includes(d1)) return null;
     if (1 === s.length) return `${d1}XX`;
     const c2 = s.charAt(1);
     if (c2 === MASK_PLACEHOLDER) {

package/dist/components/FilterInput/lib/statusCode/utils/constants.d.ts

@@ -1,8 +1,12 @@
 import type { BadgeColor } from '../../../../Badge';
 /** The five valid HTTP status-code classes, used both for suggestion-building
- *  and validation. Backed by the standard HTTP spec, independent of what the
- *  backend happens to carry. */
-export declare const VALID_MASK_ROOTS: Set<string>;
+ *  and validation. Backed by the standard HTTP spec — entirely frontend-driven,
+ *  independent of what the backend config carries.
+ *
+ *  Typed as `readonly string[]` (not `as const`) so `.includes(someString)`
+ *  stays callable without casting; declaration-file generation rejects the
+ *  tuple-narrowed overload of `.includes`. */
+export declare const MASK_ROOTS: readonly string[];
 /** Badge color per HTTP class, keyed by the leading digit. Derived from the
  *  AS-877 Figma designs: informational greys, success greens, redirect blues,
  *  client-error ambers, server-error reds. */

package/dist/components/FilterInput/lib/statusCode/utils/constants.js

@@ -1,10 +1,10 @@
-const VALID_MASK_ROOTS = new Set([
+const MASK_ROOTS = [
     '1',
     '2',
     '3',
     '4',
     '5'
-]);
+];
 const HTTP_CLASS_BADGE_COLOR = {
     1: 'slate',
     2: 'green',
@@ -14,4 +14,4 @@ const HTTP_CLASS_BADGE_COLOR = {
 };
 const STATUS_CODE_LENGTH = 3;
 const MASK_PLACEHOLDER = 'X';
-export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, STATUS_CODE_LENGTH, VALID_MASK_ROOTS };
+export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, MASK_ROOTS, STATUS_CODE_LENGTH };

package/dist/components/FilterInput/lib/statusCode/utils/index.d.ts

@@ -1,5 +1,3 @@
 export { canonicalizeStatusCodeInput } from './canonicalize';
-export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, STATUS_CODE_LENGTH, VALID_MASK_ROOTS, } from './constants';
+export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, MASK_ROOTS, STATUS_CODE_LENGTH, } from './constants';
 export { makeMask } from './makeMask';
-export { getMaskRoots } from './maskRoots';
-export type { StatusCodeSuggestionsOptions } from './types';

package/dist/components/FilterInput/lib/statusCode/utils/index.js

@@ -1,5 +1,4 @@
 import { canonicalizeStatusCodeInput } from "./canonicalize.js";
-import { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, STATUS_CODE_LENGTH, VALID_MASK_ROOTS } from "./constants.js";
+import { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, MASK_ROOTS, STATUS_CODE_LENGTH } from "./constants.js";
 import { makeMask } from "./makeMask.js";
-import { getMaskRoots } from "./maskRoots.js";
-export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, STATUS_CODE_LENGTH, VALID_MASK_ROOTS, canonicalizeStatusCodeInput, getMaskRoots, makeMask };
+export { HTTP_CLASS_BADGE_COLOR, MASK_PLACEHOLDER, MASK_ROOTS, STATUS_CODE_LENGTH, canonicalizeStatusCodeInput, makeMask };

package/dist/components/FilterInput/types.d.ts

@@ -98,6 +98,15 @@ export interface FieldMetadata {
      * commits apply this per token.
      */
     normalize?: (value: string | number | boolean) => string | number | boolean;
+    /**
+     * Optional backend-value transformer. The UI stores whatever
+     * `normalize` produced (e.g. `"2XX"`), but some backends want a
+     * stripped form (e.g. `"2"`). Pass the expression tree through
+     * `applyFieldValueTransforms(expr, fields)` — or a string through
+     * `serializeExpression(expr, fields)` — to apply this hook when
+     * emitting the query. Display in the chip is unaffected.
+     */
+    serializeValue?: (value: string | number | boolean) => string | number | boolean;
 }
 /**
  * Expression Tree Types

package/dist/components/TemporalCore/TemporalSegment.js

@@ -4,14 +4,14 @@ import { useDateSegment } from "@react-aria/datepicker";
 import { cva } from "class-variance-authority";
 import { cn } from "../../utils/cn.js";
 import { getMonthSegmentText } from "./utils.js";
-const segmentVariants = cva(cn('relative outline-none text-left', 'font-sans text-sm transition-all', 'focus:bg-states-primary-pressed', 'focus:outline-none'), {
+const segmentVariants = cva(cn('relative outline-none text-left', 'font-sans text-sm transition-all', 'focus:bg-bg-fill-brand focus:text-text-primary-alt', 'focus:outline-none'), {
     variants: {
         isPlaceholder: {
             true: 'text-text-secondary',
             false: 'text-text-primary'
         },
         disabled: {
-            true: 'cursor-not-allowed',
+            true: 'cursor-not-allowed opacity-50',
             false: 'hover:bg-states-primary-default-alt cursor-text'
         },
         type: {

package/dist/metadata/components.json

@@ -1,6 +1,6 @@
 {
   "version": "0.27.0",
-  "generatedAt": "2026-04-20T18:13:10.238Z",
+  "generatedAt": "2026-04-21T09:43:50.074Z",
   "components": [
     {
       "name": "Alert",
@@ -15198,7 +15198,7 @@
           "name": "fields",
           "type": "FieldMetadata[] | undefined",
           "required": false,
-          "defaultValue": "[]"
+          "description": "Filter-field configurations driving the autocomplete. Most fields are\npassed through as-is, but a few names are **reserved** and auto-wired\nwith design-system helpers (`acceptChar` / `normalize` / `getSuggestions`\n/ `validate`). Current reserved names:\n\n  - `status_code` — HTTP status code field (mask suggestions, format\n    validation, digit-or-X input filter, partial-input normalization).\n\nConsumer-supplied callbacks always override the auto-wiring, so you can\nopt out per-field. For the same helpers on a field with a different\n`name`, import the factories (`createStatusCodeSuggestions`, …) and\nattach them manually."
         },
         {
           "name": "value",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wallarm-org/design-system",
-  "version": "0.27.1-rc-feature-WDS-96-update-data-input-component.1",
+  "version": "0.27.1",
   "description": "Core design system library with React components and Storybook documentation",
   "publishConfig": {
     "access": "public",

package/dist/components/FilterInput/lib/statusCode/utils/maskRoots.d.ts

@@ -1,4 +0,0 @@
-/** Extract the HTTP class digits (`1`..`5`) that actually appear as single-
- *  character entries in the backend `codes` list. These become the "available"
- *  class masks the helper is willing to emit. */
-export declare const getMaskRoots: (codes: string[] | undefined) => string[];

package/dist/components/FilterInput/lib/statusCode/utils/maskRoots.js

@@ -1,3 +0,0 @@
-import { VALID_MASK_ROOTS } from "./constants.js";
-const getMaskRoots = (codes)=>(codes ?? []).filter((c)=>1 === c.length && VALID_MASK_ROOTS.has(c));
-export { getMaskRoots };

package/dist/components/FilterInput/lib/statusCode/utils/types.d.ts

@@ -1,8 +0,0 @@
-export interface StatusCodeSuggestionsOptions {
-    /**
-     * Raw backend status-code list. The helper keeps only 1-char entries in
-     * `[1..5]` as mask roots; everything else is ignored. When omitted or
-     * empty, the helper returns `[]` for every input.
-     */
-    codes?: string[];
-}

package/dist/components/FilterInput/stories/mockStatusCodes.d.ts

@@ -1,6 +0,0 @@
-/**
- * Example HTTP status code backend response used by FilterInput stories.
- * Mixes 1-char HTTP classes with 3-char concrete codes — the same shape the
- * real backend produces. See AS-877 design spec.
- */
-export declare const MOCK_STATUS_CODES: string[];

package/dist/components/FilterInput/stories/mockStatusCodes.js

@@ -1,20 +0,0 @@
-const MOCK_STATUS_CODES = [
-    '1',
-    '2',
-    '3',
-    '4',
-    '5',
-    '101',
-    '200',
-    '201',
-    '301',
-    '302',
-    '400',
-    '401',
-    '403',
-    '404',
-    '500',
-    '502',
-    '503'
-];
-export { MOCK_STATUS_CODES };