@wallarm-org/design-system 1.0.0-rc-feature-AS-877-fix-filter-code.1 → 1.0.0-rc-feature-AS-877-fix-filter-code.3

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/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` |
+ *
+ * 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,27 @@
+import { createStatusCodeInputFilter, createStatusCodeNormalizer, createStatusCodeSuggestions, createStatusCodeValidator } from "./statusCode/index.js";
+const KNOWN_FIELD_HELPERS = {
+    status_code: ()=>({
+            acceptChar: createStatusCodeInputFilter(),
+            normalize: createStatusCodeNormalizer(),
+            getSuggestions: createStatusCodeSuggestions(),
+            validate: createStatusCodeValidator()
+        })
+};
+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
+        };
+    });
+    return changed ? out : fields;
+};
+export { applyKnownFieldHelpers };

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

@@ -1,6 +1,7 @@
 export type { DatePreset } from '../FilterInputMenu/FilterInputDateValueMenu/constants';
 export { DATE_PRESETS, formatDateForChip, getDateDisplayLabel, isDatePreset, } from '../FilterInputMenu/FilterInputDateValueMenu/constants';
 export { applyAcceptChar } from './applyAcceptChar';
+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';

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

@@ -1,5 +1,6 @@
 import { DATE_PRESETS, formatDateForChip, getDateDisplayLabel, isDatePreset } from "../FilterInputMenu/FilterInputDateValueMenu/constants.js";
 import { applyAcceptChar } from "./applyAcceptChar.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";
@@ -10,4 +11,4 @@ import { getOperatorFromLabel, getOperatorLabel, isBetweenOperator, isMultiSelec
 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 };
+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, applyKnownFieldHelpers, 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 };

package/dist/metadata/components.json

@@ -1,6 +1,6 @@
 {
   "version": "0.27.0",
-  "generatedAt": "2026-04-20T14:29:27.473Z",
+  "generatedAt": "2026-04-20T15:59:19.454Z",
   "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": "1.0.0-rc-feature-AS-877-fix-filter-code.1",
+  "version": "1.0.0-rc-feature-AS-877-fix-filter-code.3",
   "description": "Core design system library with React components and Storybook documentation",
   "publishConfig": {
     "access": "public",