@smartsoft001/react 0.0.0-stage → 2.193.0

package/src/lib/forms/form-group.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartFormGroup = void 0;
+const abstract_control_1 = require("./abstract-control");
+/**
+ * A set of named controls whose value is an object. Disabled controls are
+ * left out of `value` (use `getRawValue()` to read them), as in Angular.
+ */
+class SmartFormGroup extends abstract_control_1.SmartAbstractControl {
+    controls;
+    constructor(controls = {}, validators, asyncValidators) {
+        super(validators, asyncValidators);
+        this.controls = { ...controls };
+        for (const control of Object.values(this.controls)) {
+            control.setParent(this);
+        }
+        this.updateValueAndValidity({ onlySelf: true, emitEvent: false });
+    }
+    static create() {
+        return new SmartFormGroup({});
+    }
+    /** Adds `control` under `name`; does nothing when the name is taken. */
+    addControl(name, control, options = {}) {
+        if (this.controls[name])
+            return;
+        this.controls[name] = control;
+        control.setParent(this);
+        this.updateValueAndValidity({ emitEvent: options.emitEvent });
+    }
+    removeControl(name, options = {}) {
+        if (!this.controls[name])
+            return;
+        delete this.controls[name];
+        this.updateValueAndValidity({ emitEvent: options.emitEvent });
+    }
+    setControl(name, control, options = {}) {
+        delete this.controls[name];
+        this.controls[name] = control;
+        control.setParent(this);
+        this.updateValueAndValidity({ emitEvent: options.emitEvent });
+    }
+    /** True when the group has an enabled control named `name`. */
+    contains(name) {
+        return !!this.controls[name] && this.controls[name].enabled;
+    }
+    setValue(value, options = {}) {
+        this.patchValue(value, options);
+    }
+    patchValue(value, options = {}) {
+        if (!value)
+            return;
+        for (const key of Object.keys(value)) {
+            this.controls[key]?.setValue(value[key], {
+                onlySelf: true,
+                emitEvent: options.emitEvent,
+            });
+        }
+        this.updateValueAndValidity(options);
+    }
+    reset(value = {}, options = {}) {
+        this.forEachChild((control, key) => control.reset(value?.[key], {
+            onlySelf: true,
+            emitEvent: options.emitEvent,
+        }));
+        this.markAsPristine(options);
+        this.markAsUntouched(options);
+        this.updateValueAndValidity(options);
+    }
+    getRawValue() {
+        const result = {};
+        this.forEachChild((control, key) => {
+            result[key] = control.getRawValue();
+        });
+        return result;
+    }
+    /**
+     * Replaces the controls named in `form` with the ones `form` holds, the way
+     * the Angular `SmartFormGroup.setForm` does after an import.
+     */
+    setForm(form) {
+        for (const key of Object.keys(form.controls)) {
+            if (this.controls[key])
+                this.removeControl(key);
+            this.addControl(key, form.controls[key]);
+        }
+    }
+    child(key) {
+        return this.controls[key] ?? null;
+    }
+    updateValue() {
+        const result = {};
+        this.forEachChild((control, key) => {
+            if (control.enabled || this.disabled)
+                result[key] = control.value;
+        });
+        this._value = result;
+    }
+    forEachChild(callback) {
+        for (const key of Object.keys(this.controls)) {
+            const control = this.controls[key];
+            if (control)
+                callback(control, key);
+        }
+    }
+    allControlsDisabled() {
+        const keys = Object.keys(this.controls);
+        if (!keys.length)
+            return this.disabled;
+        return keys.every((key) => this.controls[key].disabled);
+    }
+}
+exports.SmartFormGroup = SmartFormGroup;
+//# sourceMappingURL=form-group.js.map

package/src/lib/forms/form-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-group.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/forms/form-group.ts"],"names":[],"mappings":"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"}

package/src/lib/forms/hooks.d.ts

@@ -0,0 +1,34 @@
+import { SmartAbstractControl, SmartControlStatus, SmartValidationErrors } from './abstract-control';
+/**
+ * Re-renders the calling component whenever `control` changes, and returns
+ * the control's version. Every other hook here is built on it.
+ */
+export declare function useControlVersion(control: SmartAbstractControl | null | undefined): number;
+export interface SmartControlState<TValue = any> {
+    value: TValue;
+    status: SmartControlStatus;
+    errors: SmartValidationErrors | null;
+    valid: boolean;
+    invalid: boolean;
+    pending: boolean;
+    disabled: boolean;
+    touched: boolean;
+    dirty: boolean;
+    /** The control reports `required` for an empty value. */
+    required: boolean;
+}
+/** The current state of `control`, kept up to date across changes. */
+export declare function useControlState<TValue = any>(control: SmartAbstractControl<TValue>): SmartControlState<TValue>;
+export declare function useControlState<TValue = any>(control: SmartAbstractControl<TValue> | null | undefined): SmartControlState<TValue> | null;
+export interface SmartControlBinding<TValue = any> extends SmartControlState<TValue> {
+    /** Sets the value as the user would: the control becomes dirty. */
+    onChange: (value: TValue) => void;
+    /** Marks the control as touched, as leaving a field does. */
+    onBlur: () => void;
+}
+/**
+ * Binds an input element to a control the way Angular's `formControl`
+ * directive does: a change sets the value and marks the control dirty, a blur
+ * marks it touched.
+ */
+export declare function useControlBinding<TValue = any>(control: SmartAbstractControl<TValue>): SmartControlBinding<TValue>;

package/src/lib/forms/hooks.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useControlVersion = useControlVersion;
+exports.useControlState = useControlState;
+exports.useControlBinding = useControlBinding;
+const react_1 = require("react");
+const validators_1 = require("./validators");
+const noop = () => undefined;
+/**
+ * Re-renders the calling component whenever `control` changes, and returns
+ * the control's version. Every other hook here is built on it.
+ */
+function useControlVersion(control) {
+    const subscribe = (0, react_1.useCallback)((onChange) => {
+        if (!control)
+            return noop;
+        const subscription = control.changes.subscribe(onChange);
+        return () => subscription.unsubscribe();
+    }, [control]);
+    const getSnapshot = (0, react_1.useCallback)(() => control?.version ?? 0, [control]);
+    return (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+}
+function snapshot(control) {
+    return {
+        value: control.value,
+        status: control.status,
+        errors: control.errors,
+        valid: control.valid,
+        invalid: control.invalid,
+        pending: control.pending,
+        disabled: control.disabled,
+        touched: control.touched,
+        dirty: control.dirty,
+        required: (0, validators_1.isControlRequired)(control),
+    };
+}
+function useControlState(control) {
+    const version = useControlVersion(control);
+    return (0, react_1.useMemo)(() => (control ? snapshot(control) : null), 
+    // `version` is the change signal: the control is mutable.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [control, version]);
+}
+/**
+ * Binds an input element to a control the way Angular's `formControl`
+ * directive does: a change sets the value and marks the control dirty, a blur
+ * marks it touched.
+ */
+function useControlBinding(control) {
+    const state = useControlState(control);
+    const onChange = (0, react_1.useCallback)((value) => {
+        // Dirty first, as Angular's `formControl` directive does, so listeners
+        // of the value change already see the control as edited.
+        control.markAsDirty();
+        control.setValue(value);
+    }, [control]);
+    const onBlur = (0, react_1.useCallback)(() => control.markAsTouched(), [control]);
+    return (0, react_1.useMemo)(() => ({ ...state, onChange, onBlur }), [state, onChange, onBlur]);
+}
+//# sourceMappingURL=hooks.js.map

package/src/lib/forms/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/forms/hooks.ts"],"names":[],"mappings":";;AAeA,8CAgBC;AAwCD,0CAWC;AAgBD,8CAmBC;AArHD,iCAAmE;AAOnE,6CAAiD;AAEjD,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAEnC;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,OAAgD;IAEhD,MAAM,SAAS,GAAG,IAAA,mBAAW,EAC3B,CAAC,QAAoB,EAAE,EAAE;QACvB,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEzD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IACF,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAExE,OAAO,IAAA,4BAAoB,EAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACnE,CAAC;AAgBD,SAAS,QAAQ,CACf,OAAqC;IAErC,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,IAAA,8BAAiB,EAAC,OAAO,CAAC;KACrC,CAAC;AACJ,CAAC;AASD,SAAgB,eAAe,CAC7B,OAAwD;IAExD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE3C,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,uDAAuD;IACvD,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;AACJ,CAAC;AAWD;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,OAAqC;IAErC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,CAAC,KAAa,EAAE,EAAE;QAChB,uEAAuE;QACvE,yDAAyD;QACzD,OAAO,CAAC,WAAW,EAAE,CAAC;QACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAErE,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EACtC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAC1B,CAAC;AACJ,CAAC"}

package/src/lib/forms/index.d.ts

@@ -0,0 +1,7 @@
+export * from './abstract-control';
+export * from './emitter';
+export * from './form-array';
+export * from './form-control';
+export * from './form-group';
+export * from './hooks';
+export * from './validators';

package/src/lib/forms/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./abstract-control"), exports);
+tslib_1.__exportStar(require("./emitter"), exports);
+tslib_1.__exportStar(require("./form-array"), exports);
+tslib_1.__exportStar(require("./form-control"), exports);
+tslib_1.__exportStar(require("./form-group"), exports);
+tslib_1.__exportStar(require("./hooks"), exports);
+tslib_1.__exportStar(require("./validators"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/forms/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,oDAA0B;AAC1B,uDAA6B;AAC7B,yDAA+B;AAC/B,uDAA6B;AAC7B,kDAAwB;AACxB,uDAA6B"}

package/src/lib/forms/validators.d.ts

@@ -0,0 +1,24 @@
+import { SmartAbstractControl, SmartValidationErrors, SmartValidatorFn } from './abstract-control';
+/**
+ * The built-in validators, with the error keys and payloads of Angular's
+ * `Validators`, so error messages and custom validator providers written for
+ * the Angular library read the same errors here.
+ */
+export declare class SmartValidators {
+    static required(control: SmartAbstractControl): SmartValidationErrors | null;
+    static requiredTrue(control: SmartAbstractControl): SmartValidationErrors | null;
+    static email(control: SmartAbstractControl): SmartValidationErrors | null;
+    static min(min: number): SmartValidatorFn;
+    static max(max: number): SmartValidatorFn;
+    static minLength(minLength: number): SmartValidatorFn;
+    static maxLength(maxLength: number): SmartValidatorFn;
+    static pattern(pattern: string | RegExp): SmartValidatorFn;
+    static nullValidator(): null;
+}
+/**
+ * True when the control's validators report `required` for an empty value.
+ * This is how the Angular inputs decide whether to draw the asterisk: they
+ * call the composed validator with an empty control, which also catches a
+ * required rule added by a custom validators provider.
+ */
+export declare function isControlRequired(control: SmartAbstractControl | null | undefined): boolean;

package/src/lib/forms/validators.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartValidators = void 0;
+exports.isControlRequired = isControlRequired;
+function isEmptyInputValue(value) {
+    return (value === null ||
+        value === undefined ||
+        ((typeof value === 'string' || Array.isArray(value)) && value.length === 0));
+}
+function hasValidLength(value) {
+    return (value !== null &&
+        value !== undefined &&
+        typeof value.length === 'number');
+}
+// The same pattern Angular's `Validators.email` uses (WHATWG, with a length cap).
+const EMAIL_REGEXP = /^(?=.{1,254}$)(?=.{1,64}@)[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+/**
+ * The built-in validators, with the error keys and payloads of Angular's
+ * `Validators`, so error messages and custom validator providers written for
+ * the Angular library read the same errors here.
+ */
+class SmartValidators {
+    static required(control) {
+        return isEmptyInputValue(control.value) ? { required: true } : null;
+    }
+    static requiredTrue(control) {
+        return control.value === true ? null : { required: true };
+    }
+    static email(control) {
+        if (isEmptyInputValue(control.value))
+            return null;
+        return EMAIL_REGEXP.test(String(control.value)) ? null : { email: true };
+    }
+    static min(min) {
+        return (control) => {
+            if (isEmptyInputValue(control.value) || isEmptyInputValue(min))
+                return null;
+            const value = parseFloat(control.value);
+            return !isNaN(value) && value < min
+                ? { min: { min, actual: control.value } }
+                : null;
+        };
+    }
+    static max(max) {
+        return (control) => {
+            if (isEmptyInputValue(control.value) || isEmptyInputValue(max))
+                return null;
+            const value = parseFloat(control.value);
+            return !isNaN(value) && value > max
+                ? { max: { max, actual: control.value } }
+                : null;
+        };
+    }
+    static minLength(minLength) {
+        return (control) => {
+            if (isEmptyInputValue(control.value) || !hasValidLength(control.value))
+                return null;
+            return control.value.length < minLength
+                ? {
+                    minlength: {
+                        requiredLength: minLength,
+                        actualLength: control.value.length,
+                    },
+                }
+                : null;
+        };
+    }
+    static maxLength(maxLength) {
+        return (control) => {
+            if (!hasValidLength(control.value))
+                return null;
+            return control.value.length > maxLength
+                ? {
+                    maxlength: {
+                        requiredLength: maxLength,
+                        actualLength: control.value.length,
+                    },
+                }
+                : null;
+        };
+    }
+    static pattern(pattern) {
+        const regex = typeof pattern === 'string'
+            ? new RegExp(`${pattern.startsWith('^') ? '' : '^'}${pattern}${pattern.endsWith('$') ? '' : '$'}`)
+            : pattern;
+        return (control) => {
+            if (isEmptyInputValue(control.value))
+                return null;
+            const value = String(control.value);
+            // A global or sticky regex keeps `lastIndex` between calls.
+            regex.lastIndex = 0;
+            return regex.test(value)
+                ? null
+                : {
+                    pattern: { requiredPattern: regex.toString(), actualValue: value },
+                };
+        };
+    }
+    static nullValidator() {
+        return null;
+    }
+}
+exports.SmartValidators = SmartValidators;
+/**
+ * True when the control's validators report `required` for an empty value.
+ * This is how the Angular inputs decide whether to draw the asterisk: they
+ * call the composed validator with an empty control, which also catches a
+ * required rule added by a custom validators provider.
+ */
+function isControlRequired(control) {
+    const validator = control?.validator;
+    if (!validator)
+        return false;
+    try {
+        const errors = validator({ value: undefined });
+        return !!errors && !!errors['required'];
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validators.js.map

package/src/lib/forms/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/forms/validators.ts"],"names":[],"mappings":"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"}

package/src/lib/i18n/index.d.ts

@@ -0,0 +1,2 @@
+export * from './translate';
+export * from './translations-default';

package/src/lib/i18n/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./translate"), exports);
+tslib_1.__exportStar(require("./translations-default"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/i18n/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,iEAAuC"}

package/src/lib/i18n/translate.d.ts

@@ -0,0 +1,14 @@
+import { ITranslateData } from './translations-default';
+/**
+ * Translates `key`, with `{{name}}` placeholders filled from `params`. Like
+ * ngx-translate's `instant`, it returns the key itself when there is no
+ * translation, which is what the label helpers rely on to detect a miss.
+ */
+export type SmartTranslateFn = (key: string, params?: Record<string, unknown>) => string;
+export type SmartTranslations = Record<string, unknown>;
+/** The dictionaries the library ships, by language. */
+export declare const SMART_DEFAULT_TRANSLATIONS: Record<string, ITranslateData>;
+/** Deep-merges dictionaries; later ones win. */
+export declare function mergeTranslations(...dictionaries: Array<SmartTranslations | null | undefined>): SmartTranslations;
+/** A translator over a nested dictionary, ngx-translate style. */
+export declare function createTranslator(dictionary: SmartTranslations): SmartTranslateFn;

package/src/lib/i18n/translate.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SMART_DEFAULT_TRANSLATIONS = void 0;
+exports.mergeTranslations = mergeTranslations;
+exports.createTranslator = createTranslator;
+const translations_default_1 = require("./translations-default");
+/** The dictionaries the library ships, by language. */
+exports.SMART_DEFAULT_TRANSLATIONS = {
+    pl: translations_default_1.TRANSLATE_DATA_PL,
+    eng: translations_default_1.TRANSLATE_DATA_ENG,
+};
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/** Deep-merges dictionaries; later ones win. */
+function mergeTranslations(...dictionaries) {
+    const result = {};
+    for (const dictionary of dictionaries) {
+        if (!dictionary)
+            continue;
+        for (const [key, value] of Object.entries(dictionary)) {
+            const current = result[key];
+            result[key] =
+                isPlainObject(current) && isPlainObject(value)
+                    ? mergeTranslations(current, value)
+                    : value;
+        }
+    }
+    return result;
+}
+function lookup(dictionary, key) {
+    if (key in dictionary)
+        return dictionary[key];
+    let current = dictionary;
+    for (const segment of key.split('.')) {
+        if (!isPlainObject(current) || !(segment in current))
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+/** A translator over a nested dictionary, ngx-translate style. */
+function createTranslator(dictionary) {
+    return (key, params) => {
+        if (!key)
+            return key;
+        const value = lookup(dictionary, key);
+        if (typeof value !== 'string')
+            return key;
+        if (!params)
+            return value;
+        return value.replace(/{{\s*([\w.]+)\s*}}/g, (match, name) => {
+            const param = lookup(params, name);
+            return param === undefined || param === null ? match : String(param);
+        });
+    };
+}
+//# sourceMappingURL=translate.js.map

package/src/lib/i18n/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/i18n/translate.ts"],"names":[],"mappings":";;;AA6BA,8CAmBC;AAgBD,4CAiBC;AAjFD,iEAIgC;AAchC,uDAAuD;AAC1C,QAAA,0BAA0B,GAAmC;IACxE,EAAE,EAAE,wCAAiB;IACrB,GAAG,EAAE,yCAAkB;CACxB,CAAC;AAEF,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,gDAAgD;AAChD,SAAgB,iBAAiB,CAC/B,GAAG,YAAyD;IAE5D,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAE5B,MAAM,CAAC,GAAG,CAAC;gBACT,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC;oBAC5C,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;oBACnC,CAAC,CAAC,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,UAA6B,EAAE,GAAW;IACxD,IAAI,GAAG,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,OAAO,GAAY,UAAU,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACvE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kEAAkE;AAClE,SAAgB,gBAAgB,CAC9B,UAA6B;IAE7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QACrB,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC;QAErB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAEtC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1B,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;YAClE,MAAM,KAAK,GAAG,MAAM,CAAC,MAA2B,EAAE,IAAI,CAAC,CAAC;YAExD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/i18n/translations-default.d.ts

@@ -0,0 +1,131 @@
+/**
+ * The translations the components fall back to when the application provides
+ * none of its own, the same data `@smartsoft001/angular` registers with
+ * ngx-translate. `SmartProvider` merges the application's dictionary over the
+ * one matching its `language` (`pl` by default).
+ */
+export interface ITranslateData {
+    details: string;
+    admin: string;
+    client: string;
+    guest: string;
+    add: string;
+    change: string;
+    confirm: string;
+    cancel: string;
+    delete: string;
+    undo: string;
+    search: string;
+    page: string;
+    filters: string;
+    or: string;
+    signInQuicklyWith: string;
+    select: string;
+    selected: string;
+    show: string;
+    download: string;
+    play: string;
+    writeHere: string;
+    browse: string;
+    remove: string;
+    next: string;
+    prev: string;
+    edit: string;
+    save: string;
+    noResults: string;
+    from: string;
+    to: string;
+    CALENDAR: {
+        DAY_OF_WEEK: {
+            Mon: string;
+            Tue: string;
+            Wed: string;
+            Thu: string;
+            Fri: string;
+            Sat: string;
+            Sun: string;
+        };
+        MONTH: {
+            January: string;
+            February: string;
+            March: string;
+            April: string;
+            May: string;
+            June: string;
+            July: string;
+            August: string;
+            September: string;
+            October: string;
+            November: string;
+            December: string;
+        };
+        Today: string;
+        LastSevenDays: string;
+        ThisMonth: string;
+        Yesterday: string;
+        LastThirtyDays: string;
+        LastMonth: string;
+    };
+    OBJECT: {
+        deleted: string;
+        confirmDelete: string;
+    };
+    APP: {
+        logout: string;
+        signIn: string;
+        logged: string;
+    };
+    MODEL: {
+        body: string;
+        buildingNumber: string;
+        city: string;
+        date: string;
+        disabled: string;
+        email: string;
+        file: string;
+        firstName: string;
+        flatNumber: string;
+        lastName: string;
+        password: string;
+        passwordConfirm: string;
+        passwordReset: string;
+        permissions: string;
+        price: string;
+        send: string;
+        street: string;
+        username: string;
+        zipCode: string;
+    };
+    INPUT: {
+        dropFileHereOr: string;
+        ERRORS: {
+            required: string;
+            requires: string;
+            invalidNip: string;
+            invalidFileType: string;
+            invalidUnique: string;
+            confirm: string;
+            invalidEmailFormat: string;
+            invalidPhoneNumberFormat: string;
+            invalidPeselFormat: string;
+            invalidMinLength: string;
+            invalidMaxLength: string;
+            invalidMin: string;
+            invalidMax: string;
+            upperLetters: string;
+            lowerLetters: string;
+            symbols: string;
+        };
+        'PASSWORD-STRENGTH': {
+            poor: string;
+            notGood: string;
+            good: string;
+        };
+    };
+    ERRORS: {
+        invalidUsernameOrPassword: string;
+        other: string;
+    };
+}
+export declare const TRANSLATE_DATA_ENG: ITranslateData;
+export declare const TRANSLATE_DATA_PL: ITranslateData;