@pbkware/fielded-text-web 0.1.0

package/dist/fields/instances/ft-generic-field.js

@@ -0,0 +1,173 @@
+import { FtSequenceRedirectType } from '../../types/enums/ft-sequence-redirect-type.js';
+import { FtField } from './ft-field.js';
+/**
+ * Generic base class for typed fields.
+ * Provides type-safe value access and implements conversion methods.
+ * @public
+ */
+export class FtGenericField extends FtField {
+    _value;
+    constructor(sequenceInvokation, sequenceItem, valueTextNullTrimmable, definition) {
+        super(sequenceInvokation, sequenceItem, valueTextNullTrimmable);
+        // Verify the sequenceItem's definition matches the provided definition
+        if (sequenceItem.fieldDefinition !== definition) {
+            throw new Error('SequenceItem definition must match provided definition');
+        }
+        if (definition.constant && !definition.null) {
+            this._value = definition.value;
+        }
+    }
+    get definition_() {
+        return super.definition_;
+    }
+    get value() {
+        return this.getValueOrThrowNull();
+    }
+    set value(val) {
+        this.setValue(val); // ignore fieldsAffectedFromIndex for direct value sets, as sequence redirects are not expected in this case
+    }
+    setValue(val) {
+        if (this.constant) {
+            throw new Error(`Cannot set constant field "${this.name}"`);
+        }
+        else {
+            this.clearNonConstantNull();
+            this._value = val;
+            this.valueAssigned = true;
+            return this.checkValueSequenceRedirect(); // returns fieldsAffectedFromIndex
+        }
+    }
+    getAsNonNullValueText() {
+        try {
+            return this.definition_.getValueText(this._value);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to convert field "${this.name}" to text: ${message}`, { cause: error });
+        }
+    }
+    getAsNonNullObject() {
+        return this._value;
+    }
+    getAsNonNullString() {
+        return String(this._value);
+    }
+    getAsBoolean() {
+        return Boolean(this._value);
+    }
+    getAsInteger() {
+        return Number(this._value);
+    }
+    getAsBigInt() {
+        if (typeof this._value === 'bigint') {
+            return this._value;
+        }
+        return BigInt(Number(this._value));
+    }
+    getAsFloat() {
+        return Number(this._value);
+    }
+    getAsDateTime() {
+        if (this._value instanceof Date) {
+            return this._value;
+        }
+        return new Date(Number(this._value));
+    }
+    getAsDecimal() {
+        return Number(this._value);
+    }
+    setAsNonNullObject(newValue) {
+        this.value = newValue;
+    }
+    setAsNonNullString(newValue) {
+        this.value = newValue;
+    }
+    setAsBoolean(newValue) {
+        this.value = newValue;
+    }
+    setAsInteger(newValue) {
+        this.value = newValue;
+    }
+    setAsBigInt(newValue) {
+        this.value = newValue;
+    }
+    setAsFloat(newValue) {
+        this.value = newValue;
+    }
+    setAsDateTime(newValue) {
+        this.value = newValue;
+    }
+    setAsDecimal(newValue) {
+        this.value = newValue;
+    }
+    getAsRedirectBoolean() {
+        return Boolean(this._value);
+    }
+    getAsRedirectInteger() {
+        if (typeof this._value === 'bigint') {
+            return this._value;
+        }
+        return BigInt(Number(this._value));
+    }
+    getAsRedirectFloat() {
+        return Number(this._value);
+    }
+    getAsRedirectDateTime() {
+        if (this._value instanceof Date) {
+            return this._value;
+        }
+        return new Date(Number(this._value));
+    }
+    getAsRedirectDecimal() {
+        return Number(this._value);
+    }
+    loadNonNullValue(valueText) {
+        if (!this.constant) {
+            this.clearNonConstantNull();
+            this._value = this.definition_.parseValueText(valueText);
+            this.valueAssigned = true;
+            this.checkValueSequenceRedirect(); // ignore fieldsAffectedFromIndex for value loads, as sequence redirects are not expected in this case
+        }
+        else {
+            if (this.isNull()) {
+                throw new Error(`Constant field "${this.name}" expected null but got value: ${valueText}`);
+            }
+            else {
+                const parsedValue = this.definition_.parseValueText(valueText);
+                if (!this.isValueEqual(this._value, parsedValue)) {
+                    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+                    throw new Error(`Constant field "${this.name}" value mismatch: expected ${this._value}, got ${valueText}`);
+                }
+            }
+        }
+    }
+    getValueOrThrowNull() {
+        if (this.isNull()) {
+            throw new Error(`Attempt to get value from null field "${this.name}"`);
+        }
+        return this._value;
+    }
+    checkValueSequenceRedirect() {
+        if (this.sequenceRedirectList.count > 0 && !this.sidelined) {
+            let redirected = false;
+            for (let i = 0; i < this.sequenceRedirectList.count; i++) {
+                const redirect = this.sequenceRedirectList.get(i);
+                if (redirect.type !== FtSequenceRedirectType.Null) {
+                    if (redirect.checkTriggered(this)) {
+                        if (redirect.sequence) {
+                            return this.onSequenceRedirect(redirect.sequence, redirect.invokationDelay); // returns fieldsAffectedFromIndex
+                        }
+                        redirected = true;
+                        break;
+                    }
+                }
+            }
+            if (!redirected) {
+                // In case was previously redirected
+                return this.onSequenceRedirect(undefined, FtField.IGNORED_SEQUENCE_INVOKATION_DELAY); // returns fieldsAffectedFromIndex
+            }
+        }
+        return FtField.NO_FIELDS_AFFECTED_INDEX;
+    }
+}
+//# sourceMappingURL=ft-generic-field.js.map

package/dist/fields/instances/ft-generic-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-generic-field.js","sourceRoot":"","sources":["../../../src/fields/instances/ft-generic-field.ts"],"names":[],"mappings":"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"}

package/dist/fields/instances/ft-integer-field.js

@@ -0,0 +1,35 @@
+import { FtGenericField } from './ft-generic-field.js';
+/**
+ * Field for integer (bigint) values.
+ * @public
+ */
+export class FtIntegerField extends FtGenericField {
+    static VALUE_TEXT_NULL_TRIMMABLE = true;
+    constructor(sequenceInvokation, sequenceItem, definition) {
+        super(sequenceInvokation, sequenceItem, FtIntegerField.VALUE_TEXT_NULL_TRIMMABLE, definition);
+    }
+    get definition() {
+        return super.definition_;
+    }
+    get format() {
+        return this.definition.format;
+    }
+    get styles() {
+        return this.definition.styles;
+    }
+    get nullableValue() {
+        return this.isNull() ? null : this.value;
+    }
+    set nullableValue(value) {
+        if (value === null) {
+            this.setNull();
+        }
+        else {
+            this.value = value;
+        }
+    }
+    isValueEqual(left, right) {
+        return left === right;
+    }
+}
+//# sourceMappingURL=ft-integer-field.js.map

package/dist/fields/instances/ft-integer-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-integer-field.js","sourceRoot":"","sources":["../../../src/fields/instances/ft-integer-field.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAsB;IAChD,MAAM,CAAU,yBAAyB,GAAG,IAAI,CAAC;IAEzD,YAAY,kBAAwC,EAAE,YAA4B,EAAE,UAAoC;QACtH,KAAK,CAAC,kBAAkB,EAAE,YAAY,EAAE,cAAc,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC;IAChG,CAAC;IAED,IAAa,UAAU;QACrB,OAAO,KAAK,CAAC,WAAuC,CAAC;IACvD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,IAAI,aAAa,CAAC,KAAoB;QACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAES,YAAY,CAAC,IAAY,EAAE,KAAa;QAChD,OAAO,IAAI,KAAK,KAAK,CAAC;IACxB,CAAC"}

package/dist/fields/instances/ft-string-field.js

@@ -0,0 +1,34 @@
+import { FtGenericField } from './ft-generic-field.js';
+/**
+ * Field for string values.
+ * @public
+ */
+export class FtStringField extends FtGenericField {
+    static VALUE_TEXT_NULL_TRIMMABLE = false;
+    constructor(sequenceInvokation, sequenceItem, definition) {
+        super(sequenceInvokation, sequenceItem, FtStringField.VALUE_TEXT_NULL_TRIMMABLE, definition);
+    }
+    get nullableValue() {
+        return this.isNull() ? null : this.value;
+    }
+    set nullableValue(value) {
+        if (value === null) {
+            this.setNull();
+        }
+        else {
+            this.value = value;
+        }
+    }
+    setValue(value) {
+        if (value === null) {
+            return this.setNull(); // returns fieldsAffectedFromIndex
+        }
+        else {
+            return super.setValue(value); // returns fieldsAffectedFromIndex
+        }
+    }
+    isValueEqual(left, right) {
+        return left === right;
+    }
+}
+//# sourceMappingURL=ft-string-field.js.map

package/dist/fields/instances/ft-string-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-string-field.js","sourceRoot":"","sources":["../../../src/fields/instances/ft-string-field.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAsB;IAC/C,MAAM,CAAU,yBAAyB,GAAG,KAAK,CAAC;IAE1D,YAAY,kBAAwC,EAAE,YAA4B,EAAE,UAAmC;QACrH,KAAK,CAAC,kBAAkB,EAAE,YAAY,EAAE,aAAa,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,IAAI,aAAa,CAAC,KAAoB;QACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAEQ,QAAQ,CAAC,KAAoB;QACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,kCAAkC;QAC3D,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,kCAAkC;QAClE,CAAC;IACH,CAAC;IAES,YAAY,CAAC,IAAY,EAAE,KAAa;QAChD,OAAO,IAAI,KAAK,KAAK,CAAC;IACxB,CAAC"}