@ukhomeoffice/formio-gds-template 2.0.2 → 3.0.0-bravo

package/lib/components/datetime/GDSDatetimeComponent.js

@@ -1,19 +1,4 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -37,95 +22,62 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var formiojs_1 = require("formiojs");
-var utils_1 = __importDefault(require("formiojs/utils"));
-var _ = __importStar(require("lodash"));
-var moment_1 = __importDefault(require("moment"));
-var TimeHelper_1 = __importDefault(require("../util/TimeHelper"));
-var Field = formiojs_1.Components.components.field;
-var Day = formiojs_1.Components.components.day;
-// @ts-ignore
-var GDSDatetimeComponent = /** @class */ (function (_super) {
-    __extends(GDSDatetimeComponent, _super);
-    function GDSDatetimeComponent() {
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.timeHelper = new TimeHelper_1.default();
-        return _this;
+const js_1 = require("@formio/js");
+const js_2 = require("@formio/js");
+const _ = __importStar(require("lodash"));
+const moment_1 = __importDefault(require("moment"));
+const TimeHelper_1 = __importDefault(require("../util/TimeHelper"));
+const Field = js_1.Components.components.field;
+const Day = js_1.Components.components.day;
+class GDSDatetimeComponent extends Day {
+    constructor() {
+        super(...arguments);
+        this.timeHelper = new TimeHelper_1.default();
     }
-    Object.defineProperty(GDSDatetimeComponent.prototype, "format", {
-        get: function () {
-            return 'DD-MM-YYYY';
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(GDSDatetimeComponent.prototype, "defaultValue", {
-        // @ts-ignore
-        get: function () {
-            var defaultValue = this.component.defaultValue;
-            if (!defaultValue && this.component.defaultDate) {
-                defaultValue = utils_1.default.getDateSetting(this.component.defaultDate);
-                defaultValue = defaultValue ? (0, moment_1.default)(defaultValue).format() : '';
-            }
-            return defaultValue;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(GDSDatetimeComponent.prototype, "emptyValue", {
-        // @ts-ignore
-        get: function () {
-            return null;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(GDSDatetimeComponent.prototype, "parts", {
-        get: function () {
-            return {
-                day: this.getFieldValue('day'),
-                month: this.getFieldValue('month'),
-                year: this.getFieldValue('year'),
-                hour: this.getFieldValue('hour'),
-                minute: this.getFieldValue('minute'),
-            };
-        },
-        enumerable: false,
-        configurable: true
-    });
-    GDSDatetimeComponent.prototype.attach = function (element) {
-        var _this = this;
+    get format() {
+        return 'DD-MM-YYYY';
+    }
+    get defaultValue() {
+        let defaultValue = this.component.defaultValue;
+        if (!defaultValue && this.component.defaultDate) {
+            defaultValue = js_2.Utils.getDateSetting(this.component.defaultDate);
+            defaultValue = defaultValue ? (0, moment_1.default)(defaultValue).format() : '';
+        }
+        return defaultValue !== null && defaultValue !== void 0 ? defaultValue : '';
+    }
+    get emptyValue() {
+        return null;
+    }
+    get parts() {
+        return {
+            day: this.getFieldValue('day'),
+            month: this.getFieldValue('month'),
+            year: this.getFieldValue('year'),
+            hour: this.getFieldValue('hour'),
+            minute: this.getFieldValue('minute'),
+        };
+    }
+    // element typed as `any` to match the base Day.attach(element: any) override signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    attach(element) {
         this.loadRefs(element, { hour: 'single', minute: 'single' });
-        this.addEventListener(this.refs.hour, 'input', function () {
-            _this.timeHelper.checkAndValidateHour(_this.refs.hour);
-            _this.setPristine(false);
-            _this.checkComponentValidity(_this.data, true);
-            _this.updateValue(null, {
-                modified: true,
-            });
-            _this.triggerChange();
+        this.addEventListener(this.refs.hour, 'input', () => {
+            this.timeHelper.checkAndValidateHour(this.refs.hour);
+            this.setPristine(false);
+            this.checkComponentValidity(this.data, true);
+            this.updateValue(null, { modified: true });
+            this.triggerChange();
         });
-        this.addEventListener(this.refs.minute, 'input', function () {
-            _this.timeHelper.checkAndValidateMinutes(_this.refs.minute);
-            _this.setPristine(false);
-            _this.checkComponentValidity(_this.data, true);
-            _this.updateValue(null, {
-                modified: true,
-            });
-            _this.triggerChange();
+        this.addEventListener(this.refs.minute, 'input', () => {
+            this.timeHelper.checkAndValidateMinutes(this.refs.minute);
+            this.setPristine(false);
+            this.checkComponentValidity(this.data, true);
+            this.updateValue(null, { modified: true });
+            this.triggerChange();
         });
         this.addEventListener(this.refs.hour, 'keypress', this.timeHelper.preventNonNumericKeyPress);
         this.addEventListener(this.refs.minute, 'keypress', this.timeHelper.preventNonNumericKeyPress);
@@ -133,48 +85,73 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
             this.setDisabled(this.refs.hour, true);
             this.setDisabled(this.refs.minute, true);
         }
-        var superAttach = _super.prototype.attach.call(this, element);
+        const superAttach = super.attach(element);
         this.addEventListener(this.refs.year, 'keypress', this.timeHelper.preventNonNumericKeyPress);
         this.addEventListener(this.refs.month, 'keypress', this.timeHelper.preventNonNumericKeyPress);
         this.addEventListener(this.refs.day, 'keypress', this.timeHelper.preventNonNumericKeyPress);
-        this.addEventListener(this.refs.year, 'input', function () {
-            _this.timeHelper.validateDateInput(_this.refs.year, 4);
+        this.addEventListener(this.refs.year, 'input', () => {
+            this.timeHelper.validateDateInput(this.refs.year, 4);
         });
-        this.addEventListener(this.refs.day, 'input', function () {
-            _this.timeHelper.validateDateInput(_this.refs.day, 2);
+        this.addEventListener(this.refs.day, 'input', () => {
+            this.timeHelper.validateDateInput(this.refs.day, 2);
         });
-        this.addEventListener(this.refs.month, 'input', function () {
-            _this.timeHelper.validateDateInput(_this.refs.month, 2);
+        this.addEventListener(this.refs.month, 'input', () => {
+            this.timeHelper.validateDateInput(this.refs.month, 2);
         });
         return superAttach;
-    };
-    GDSDatetimeComponent.prototype.init = function () {
-        _super.prototype.init.call(this);
-        this.validators = this.validators.filter(function (v) { return v !== 'day'; }).concat(['date']);
-        this.component.maxDate = this.component.datePicker.maxDate;
-        this.component.minDate = this.component.datePicker.minDate;
+    }
+    /**
+     * Override t() to remap translation keys emitted by @formio/core validators that
+     * differ from the @formio/js English translation map.
+     *
+     * @formio/core's date validator emits FieldError('invalidDate', ...) (camelCase).
+     * @formio/js translations only define 'invalid_date' (underscore). When t()
+     * cannot find 'invalidDate' it returns the raw key as the error message.
+     *
+     * We map the camelCase core keys to their underscored @formio/js equivalents so
+     * the user sees a proper human-readable message.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    t(text, ...args) {
+        var _a;
+        const keyMap = {
+            invalidDate: 'invalid_date',
+        };
+        return super.t((_a = keyMap[text]) !== null && _a !== void 0 ? _a : text, ...args);
+    }
+    init() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        super.init();
+        // @formio/js@5.x: this.validators is not pre-populated by the base class; guard before filtering
+        this.validators = (this.validators || []).filter((v) => v !== 'day').concat(['date']);
+        this.component.maxDate = (_b = (_a = this.component.datePicker) === null || _a === void 0 ? void 0 : _a.maxDate) !== null && _b !== void 0 ? _b : undefined;
+        this.component.minDate = (_d = (_c = this.component.datePicker) === null || _c === void 0 ? void 0 : _c.minDate) !== null && _d !== void 0 ? _d : undefined;
         this.component.suffix = null;
-        this.component.fields.day.required = this.component.validate.required;
-        this.component.fields.month.required = this.component.validate.required;
-        this.component.fields.year.required = this.component.validate.required;
+        this.component.fields.day.required = (_e = this.component.validate) === null || _e === void 0 ? void 0 : _e.required;
+        this.component.fields.month.required = (_f = this.component.validate) === null || _f === void 0 ? void 0 : _f.required;
+        this.component.fields.year.required = (_g = this.component.validate) === null || _g === void 0 ? void 0 : _g.required;
         this.component.fields.hour = {
-            type: 'number', placeholder: 'HH',
-            required: this.component.validate.required,
+            type: 'number',
+            placeholder: 'HH',
+            required: (_h = this.component.validate) === null || _h === void 0 ? void 0 : _h.required,
         };
         this.component.fields.minute = {
-            type: 'number', placeholder: 'MM',
-            required: this.component.validate.required,
+            type: 'number',
+            placeholder: 'MM',
+            required: (_j = this.component.validate) === null || _j === void 0 ? void 0 : _j.required,
         };
-    };
-    GDSDatetimeComponent.prototype.setErrorClasses = function (elements, dirty, hasError) {
-        // @ts-ignore
-        _super.prototype.setErrorClasses.call(this, __spreadArray([this.refs.hour, this.refs.minute], elements, true), dirty, hasError);
-    };
-    GDSDatetimeComponent.prototype.removeInputError = function (elements) {
-        // @ts-ignore
-        _super.prototype.removeInputError.call(this, __spreadArray([this.refs.hour, this.refs.minute], elements, true));
-    };
-    GDSDatetimeComponent.prototype.render = function () {
+    }
+    // elements typed as `any` to match the base Day.setErrorClasses(elements: any, ...) override signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    setErrorClasses(elements, dirty, hasError) {
+        super.setErrorClasses([this.refs.hour, this.refs.minute, ...elements], dirty, hasError);
+    }
+    // elements typed as `any` to match the base Component.removeInputError(elements: any) signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    removeInputError(elements) {
+        super.removeInputError([this.refs.hour, this.refs.minute, ...elements]);
+    }
+    render() {
         return Field.prototype.render.call(this, this.renderTemplate('datetime', {
             component: this.component,
             dataValue: this.dataValue,
@@ -186,45 +163,49 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
             hour: this.renderField('hour'),
             minute: this.renderField('minute'),
         }));
-    };
-    GDSDatetimeComponent.prototype.getDate = function (value) {
-        var defaults = [];
-        var _a = [0, 1, 2, 3, 4], DAY = _a[0], MONTH = _a[1], YEAR = _a[2], HOUR = _a[3], MINUTE = _a[4];
-        var defaultValue = value || this.component.defaultValue;
+    }
+    // value typed as `any` to match the base Day.getDate(value: any): null | string signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    getDate(value) {
+        const defaults = [];
+        const [DAY, MONTH, YEAR, HOUR, MINUTE] = [0, 1, 2, 3, 4];
+        const defaultValue = value || this.component.defaultValue;
         if (defaultValue) {
             try {
-                var defaultDate = (0, moment_1.default)(defaultValue);
+                const defaultDate = (0, moment_1.default)(defaultValue);
                 defaults[DAY] = defaultDate.format('DD');
                 defaults[MONTH] = defaultDate.format('MM');
                 defaults[YEAR] = defaultDate.format('YYYY');
                 defaults[HOUR] = defaultDate.format('HH');
                 defaults[MINUTE] = defaultDate.format('mm');
             }
-            catch (e) {
+            catch (_a) {
                 // ignored
             }
         }
-        var day = this.processField('day', defaults, DAY);
-        var month = this.processField('month', defaults, MONTH);
-        var year = this.processField('year', defaults, YEAR);
-        var hour = this.processField('hour', defaults, HOUR);
-        var minute = this.processField('minute', defaults, MINUTE);
+        const day = this.processField('day', defaults, DAY);
+        const month = this.processField('month', defaults, MONTH);
+        const year = this.processField('year', defaults, YEAR);
+        const hour = this.processField('hour', defaults, HOUR);
+        const minute = this.processField('minute', defaults, MINUTE);
         if (!day && !month && !year && (!hour && !minute)) {
             return null;
         }
-        day = day.toString().padStart(2, 0);
-        month = month.toString().padStart(2, 0);
-        year = year.toString().padStart(4, 0);
-        hour = hour.toString().padStart(2, 0);
-        minute = minute.toString().padStart(2, 0);
-        var toMoment = (0, moment_1.default)("".concat(year, "-").concat(month, "-").concat(day, " ").concat(hour, ":").concat(minute), 'YYYY-MM-DD HH:mm');
+        const dayStr = day.toString().padStart(2, '0');
+        const monthStr = month.toString().padStart(2, '0');
+        const yearStr = year.toString().padStart(4, '0');
+        const hourStr = hour.toString().padStart(2, '0');
+        const minuteStr = minute.toString().padStart(2, '0');
+        const toMoment = (0, moment_1.default)(`${yearStr}-${monthStr}-${dayStr} ${hourStr}:${minuteStr}`, 'YYYY-MM-DD HH:mm');
         return toMoment.format();
-    };
-    GDSDatetimeComponent.prototype.getFieldValue = function (name) {
+    }
+    // name typed as `any` to match the base Day.getFieldValue(name: any): number signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    getFieldValue(name) {
         if (this.dataValue && this.dataValue !== 'Invalid date') {
             try {
-                var val = null;
-                var date = (0, moment_1.default)(this.dataValue, 'YYYY-MM-DD HH:mm');
+                let val = null;
+                const date = (0, moment_1.default)(this.dataValue, 'YYYY-MM-DD HH:mm');
                 switch (name) {
                     case 'month':
                         val = date.format('MM');
@@ -244,13 +225,13 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
                 }
                 return val;
             }
-            catch (e) {
+            catch (_a) {
                 return null;
             }
         }
         return null;
-    };
-    GDSDatetimeComponent.prototype.boolValue = function (value) {
+    }
+    boolValue(value) {
         if (_.isBoolean(value)) {
             return value;
         }
@@ -260,14 +241,15 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
         else {
             return !!value;
         }
-    };
-    GDSDatetimeComponent.prototype.setValueAt = function (index, value) {
-        // temporary solution to avoid input reset
-        // on invalid date.
+    }
+    // value typed as `any` to match the base Day.setValueAt(index: number, value: any) signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    setValueAt(_index, value) {
+        // temporary solution to avoid input reset on invalid date.
         if (!value || value === 'Invalid date') {
             return;
         }
-        var date = (0, moment_1.default)(value, moment_1.default.ISO_8601);
+        const date = (0, moment_1.default)(value, moment_1.default.ISO_8601);
         if (date.isValid()) {
             if (this.refs.day) {
                 this.refs.day.value = date.format('DD');
@@ -285,10 +267,10 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
                 this.refs.minute.value = date.format('mm');
             }
         }
-    };
-    GDSDatetimeComponent.prototype.getValueAt = function (index) {
-        // @ts-ignore
-        var date = this.date;
+    }
+    getValueAt(index) {
+        // `date` is a public getter declared on DayComponent: get date(): string | null
+        const date = this.date;
         if (date) {
             this.refs.input[index].value = date;
             return this.refs.input[index].value;
@@ -297,39 +279,46 @@ var GDSDatetimeComponent = /** @class */ (function (_super) {
             this.refs.input[index].value = '';
             return null;
         }
-    };
-    GDSDatetimeComponent.prototype.normalizeValue = function (value) {
+    }
+    // value typed as `any` to match the base Component.normalizeValue(value: any): any signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    normalizeValue(value) {
         return value;
-    };
-    GDSDatetimeComponent.prototype.validateRequired = function (setting, value) {
-        var _a = this.parts, day = _a.day, month = _a.month, year = _a.year, minute = _a.minute, hour = _a.hour;
-        if (this.component.validate.required && (!day || parseInt(day, 10) === 0)) {
+    }
+    // setting/value typed as `any` to match the base Day.validateRequired(setting: any, value: any) signature
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    validateRequired(setting, value) {
+        var _a, _b, _c, _d, _e;
+        const { day, month, year, minute, hour } = this.parts;
+        if (((_a = this.component.validate) === null || _a === void 0 ? void 0 : _a.required) && (!day || parseInt(day, 10) === 0)) {
             return false;
         }
-        if (this.component.validate.required && (!month || parseInt(month, 10) === 0)) {
+        if (((_b = this.component.validate) === null || _b === void 0 ? void 0 : _b.required) && (!month || parseInt(month, 10) === 0)) {
             return false;
         }
-        if (this.component.validate.required && (!year || parseInt(year, 10) === 0)) {
+        if (((_c = this.component.validate) === null || _c === void 0 ? void 0 : _c.required) && (!year || parseInt(year, 10) === 0)) {
             return false;
         }
-        if (this.component.validate.required && ((this.refs.minute && this.refs.minute.value === '') || !minute)) {
+        if (((_d = this.component.validate) === null || _d === void 0 ? void 0 : _d.required) && (this.refs.minute.value === '' || !minute)) {
             return false;
         }
-        if (this.component.validate.required && ((this.refs.hour && this.refs.hour.value === '') || !hour)) {
+        if (((_e = this.component.validate) === null || _e === void 0 ? void 0 : _e.required) && (this.refs.hour.value === '' || !hour)) {
             return false;
         }
         if (!this.boolValue(setting)) {
             return true;
         }
         return !this.isEmpty(value);
-    };
-    GDSDatetimeComponent.prototype.processField = function (field, defaults, fieldIndex) {
-        var fieldValue = this.refs["".concat(field)] ? parseInt(this.refs["".concat(field)].value, 10) : undefined;
+    }
+    processField(field, defaults, fieldIndex) {
+        const refKey = field;
+        const ref = this.refs[refKey];
+        const inputRef = ref instanceof HTMLInputElement ? ref : undefined;
+        let fieldValue = inputRef ? parseInt(inputRef.value, 10) : undefined;
         if (fieldValue === undefined || _.isNaN(fieldValue)) {
-            fieldValue = defaults[fieldIndex] && !_.isNaN(defaults[fieldIndex]) ? defaults[fieldIndex] : 0;
+            fieldValue = defaults[fieldIndex] && !_.isNaN(defaults[fieldIndex]) ? Number(defaults[fieldIndex]) : 0;
         }
         return fieldValue;
-    };
-    return GDSDatetimeComponent;
-}(Day));
+    }
+}
 exports.default = GDSDatetimeComponent;

package/lib/components/index.d.ts

@@ -1,11 +1,14 @@
 import datamap from './datamap/GDSDataMap';
 import datetime from './datetime/GDSDatetimeComponent';
+import select from './select/GDSSelect';
 import selectboxes from './selectboxes/GDSCheckBoxes';
 import time from './time/GDSTimeComponent';
 declare const _default: {
     datamap: typeof datamap;
     datetime: typeof datetime;
+    select: typeof select;
     selectboxes: typeof selectboxes;
     time: typeof time;
 };
 export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,IAAI,MAAM,yBAAyB,CAAC;;;;;;;;AAE3C,wBAME"}

package/lib/components/index.js

@@ -3,13 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var GDSDataMap_1 = __importDefault(require("./datamap/GDSDataMap"));
-var GDSDatetimeComponent_1 = __importDefault(require("./datetime/GDSDatetimeComponent"));
-var GDSCheckBoxes_1 = __importDefault(require("./selectboxes/GDSCheckBoxes"));
-var GDSTimeComponent_1 = __importDefault(require("./time/GDSTimeComponent"));
+const GDSDataMap_1 = __importDefault(require("./datamap/GDSDataMap"));
+const GDSDatetimeComponent_1 = __importDefault(require("./datetime/GDSDatetimeComponent"));
+const GDSSelect_1 = __importDefault(require("./select/GDSSelect"));
+const GDSCheckBoxes_1 = __importDefault(require("./selectboxes/GDSCheckBoxes"));
+const GDSTimeComponent_1 = __importDefault(require("./time/GDSTimeComponent"));
 exports.default = {
     datamap: GDSDataMap_1.default,
     datetime: GDSDatetimeComponent_1.default,
+    select: GDSSelect_1.default,
     selectboxes: GDSCheckBoxes_1.default,
     time: GDSTimeComponent_1.default,
 };

package/lib/components/select/GDSSelect.d.ts

@@ -0,0 +1,143 @@
+import { SelectComponent as CoreSelectComponent } from '../../types';
+declare const Select: any;
+interface ChoiceItem {
+    label: string;
+    active: boolean;
+    rank: number;
+    id: string | number;
+    choiceEl?: HTMLElement;
+    [key: string]: unknown;
+}
+interface SearchResult {
+    item: ChoiceItem;
+    score: number;
+    rank: number;
+}
+interface ChoicesInstance {
+    _isSearching: boolean;
+    _currentValue: string;
+    _store: {
+        choices: ChoiceItem[];
+        dispatch(action: {
+            type: string;
+            active?: boolean;
+            results?: SearchResult[];
+        }): void;
+    };
+    _searchChoices?: (needle: string) => number | null;
+    input?: {
+        element?: HTMLInputElement;
+    };
+}
+/**
+ * A formio item from a URL datasource — at minimum it has an id and arbitrary
+ * string fields (e.g. name, code). We only constrain what we actually access.
+ */
+interface ReferenceItem {
+    id?: string | number;
+    label?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of the `value` argument passed to itemTemplate / getOptionTemplate.
+ * For reference selects (valueProperty = '') this is the full item object;
+ * for string selects it is a plain string.
+ */
+type SelectValue = ReferenceItem | string | number | null | undefined;
+export default class GDSSelect extends Select {
+    component: CoreSelectComponent;
+    protected _gdsSearchPatchedChoices?: ChoicesInstance;
+    protected _gdsFilterKey?: string;
+    constructor(component?: any, options?: any, data?: any);
+    init(): any;
+    /**
+     * Patch the choices.js instance attached to this component so that every
+     * search query uses a plain case-insensitive substring filter instead of
+     * fuse.js. The patch is applied lazily the first time items are set so
+     * that `this.choices` is guaranteed to exist.
+     */
+    protected _patchChoicesSearch(): void;
+    /**
+     * True when this select's `filter` is interpolated from other form data
+     * (e.g. a port list filtered by the selected country).
+     */
+    protected get _gdsHasDynamicFilter(): boolean;
+    /** The interpolated filter, used to detect when the dependency changed. */
+    protected _gdsCurrentFilterKey(): string;
+    setItems(items: unknown, fromSearch?: boolean): void;
+    attach(element: HTMLElement): Promise<unknown>;
+    checkComponentConditions(data: any, flags: any, row: any): boolean;
+    updateItems(searchInput: unknown, forceUpdate: boolean): any;
+    /**
+     * Override getOptionTemplate to escape item data values with `_.escape()`
+     * before interpolating them into the template.
+     *
+     * ## Security model
+     *
+     * formio 5.x `getOptionTemplate` (ListComponent) passes the assembled template
+     * string through `DOMPurify.sanitize()` — which internally calls
+     * `DOMParser.parseFromString()`. With thousands of reference-data items this
+     * is the dominant performance cost (~300 ms).
+     *
+     * We replace that post-hoc sanitization with pre-interpolation escaping:
+     *
+     * 1. Every string value in the item object is passed through `_.escape()`
+     *    **before** it is substituted into the template. `_.escape` converts
+     *    `< > & " '` to their HTML-entity equivalents (`&lt;` etc.).
+     * 2. The assembled template string — now containing only safe entity-encoded
+     *    text where user/API data appears — is returned directly without any
+     *    further DOMPurify call.
+     *
+     * ### Why this is equivalent security to DOMPurify for text-content templates
+     *
+     * A template such as `<span>{{ item.name }}</span>` embeds the API value as
+     * the *text content* of an element. The only injection vector is:
+     *
+     * ```
+     * item.name = '</span><script>alert(1)</script>'
+     * ```
+     *
+     * After `_.escape()` this becomes:
+     *
+     * ```
+     * &lt;/span&gt;&lt;script&gt;alert(1)&lt;/script&gt;
+     * ```
+     *
+     * The browser renders this as literal text, never as markup or script.
+     * DOMPurify would produce the same effective result by stripping the tags.
+     *
+     * ### Limitation — attribute / URL contexts
+     *
+     * `_.escape()` is **not** sufficient if the template places a value inside
+     * an HTML attribute or a URL (e.g. `<a href="{{ item.url }}">`).
+     * HTML-entity encoding does not prevent `javascript:` injection in `href`.
+     * If any form schema introduces such a template, this override must be
+     * revisited and either DOMPurify reinstated or the attribute value
+     * sanitized separately.
+     *
+     * Current GDS templates are all text-content only (`<span>{{ item.name }}</span>`
+     * etc.) so this limitation does not apply today.
+     */
+    getOptionTemplate(data: ReferenceItem, value: SelectValue, index?: number): string;
+    /**
+     * Override itemTemplate to skip the redundant outer `sanitize()` call that
+     * formio 5.x `ListComponent.itemTemplate` wraps around `getOptionTemplate()`.
+     *
+     * ## Why the outer sanitize is now safe to skip
+     *
+     * Our `getOptionTemplate` override (above) pre-escapes all API data values
+     * with `_.escape()` before they are interpolated into the template. The
+     * assembled string therefore contains no unescaped HTML from variable sources.
+     * Running DOMPurify on that string a second time is idempotent — it produces
+     * the same output — but costs a full `DOMParser.parseFromString` call per item.
+     *
+     * This override handles only the common URL-datasource path (object data with
+     * a component template). All other branches — primitives, arrays, read-only,
+     * selectData, reference fields — fall through to `super.itemTemplate` which
+     * retains its full sanitize() call unchanged.
+     */
+    itemTemplate(data: ReferenceItem | string | number | unknown[], value: SelectValue, index?: number): any;
+    choicesOptions(): Record<string, any>;
+}
+export {};
+//# sourceMappingURL=GDSSelect.d.ts.map

package/lib/components/select/GDSSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GDSSelect.d.ts","sourceRoot":"","sources":["../../../src/components/select/GDSSelect.ts"],"names":[],"mappings":"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"}