@pbkware/fielded-text-web 0.1.2 → 0.2.2

package/dist/utils/ft-internal-error.js

@@ -0,0 +1,129 @@
+/** @public */
+export class FtInternalError extends Error {
+    code;
+    constructor(code, message, errorType) {
+        super(message === undefined || message === '' ? `${errorType}: ${code}` : `${errorType}: ${code}: ${message}`);
+        this.code = code;
+    }
+}
+/** @public */
+(function (FtInternalError) {
+    FtInternalError.AssertErrorType = 'FtAssert';
+    FtInternalError.UnreachableCaseErrorType = 'FtUnreachableCase';
+    FtInternalError.ExtraFormatting = {
+        Ignore: 'Ignore',
+        PrependWithColonSpace: 'PrependWithColonSpace',
+        PrependWithColonSpaceQuoteError: 'PrependWithColonSpaceQuoteError',
+        Postpend: 'Postpend',
+        PostpendColonSpace: 'PostpendColonSpace',
+        PostpendColonSpaceQuoted: 'PostpendColonSpaceQuoted',
+    };
+    function formatExtra(existingMessage, extraMessage, extraFormatting) {
+        switch (extraFormatting) {
+            case FtInternalError.ExtraFormatting.Ignore:
+                return existingMessage;
+            case FtInternalError.ExtraFormatting.PrependWithColonSpace:
+                return `${extraMessage}: ${existingMessage}`;
+            case FtInternalError.ExtraFormatting.PrependWithColonSpaceQuoteError:
+                return `${extraMessage}: "${existingMessage}"`;
+            case FtInternalError.ExtraFormatting.Postpend:
+                return `${existingMessage}${extraMessage}`;
+            case FtInternalError.ExtraFormatting.PostpendColonSpace:
+                return `${existingMessage}: ${extraMessage}`;
+            case FtInternalError.ExtraFormatting.PostpendColonSpaceQuoted:
+                return `${existingMessage}: "${extraMessage}"`;
+            default:
+                throw new FtUnreachableCaseError('IEAIECINE87339', extraFormatting);
+        }
+    }
+    FtInternalError.formatExtra = formatExtra;
+    function appendToErrorMessage(e, appendText) {
+        if (e instanceof Error) {
+            e.message += appendText;
+            return e;
+        }
+        else {
+            if (typeof e === 'string') {
+                e += appendText;
+                return e;
+            }
+            else {
+                return e; // Do not know how to append
+            }
+        }
+    }
+    FtInternalError.appendToErrorMessage = appendToErrorMessage;
+    function prependErrorMessage(e, prependText) {
+        if (e instanceof Error) {
+            e.message = prependText + e.message;
+            return e;
+        }
+        else {
+            if (typeof e === 'string') {
+                e = prependText + e;
+                return e;
+            }
+            else {
+                return e; // Do not know how to prepend
+            }
+        }
+    }
+    FtInternalError.prependErrorMessage = prependErrorMessage;
+    function createTypeIfNotError(e, code, errorConstructor, extraMessage, extraFormatting) {
+        if (e instanceof Error) {
+            let message;
+            if (extraMessage === undefined) {
+                message = `${code}: ${e.message}`;
+            }
+            else {
+                if (extraFormatting === undefined) {
+                    extraFormatting = FtInternalError.ExtraFormatting.PostpendColonSpaceQuoted;
+                }
+                const formattedMessage = FtInternalError.formatExtra(e.message, extraMessage, extraFormatting);
+                if (formattedMessage.length === 0) {
+                    message = code;
+                }
+                else {
+                    message = `${code}: ${formattedMessage}`;
+                }
+            }
+            e.message = message;
+            return e;
+        }
+        else {
+            if (typeof e === 'string' && extraFormatting !== undefined) {
+                if (extraMessage === undefined) {
+                    extraMessage = code;
+                }
+                const message = FtInternalError.formatExtra(e, extraMessage, extraFormatting);
+                return new errorConstructor(code, message);
+            }
+            else {
+                return new errorConstructor(code, extraMessage);
+            }
+        }
+    }
+    FtInternalError.createTypeIfNotError = createTypeIfNotError;
+    function throwErrorTypeIfPromiseRejected(promise, code, errorConstructor, extraMessage, extraFormatting) {
+        promise.then(() => {
+            /**/
+        }, (reason) => {
+            throw FtInternalError.createTypeIfNotError(reason, code, errorConstructor, extraMessage, extraFormatting);
+        });
+    }
+    FtInternalError.throwErrorTypeIfPromiseRejected = throwErrorTypeIfPromiseRejected;
+})(FtInternalError || (FtInternalError = {}));
+/** @public */
+export class FtAssertError extends FtInternalError {
+    constructor(code, message) {
+        super(code, message, 'FtAssert');
+    }
+}
+/** @public */
+export class FtUnreachableCaseError extends FtInternalError {
+    constructor(code, value) {
+        const errorText = `"${String(value)}"`;
+        super(code, errorText, 'FtUnreachableCase');
+    }
+}
+//# sourceMappingURL=ft-internal-error.js.map

package/dist/utils/ft-internal-error.js.map

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

package/dist/utils/ft-result.js

@@ -0,0 +1,2 @@
+export { Err as FtErr, Ok as FtOk } from '@pbkware/dot-net-date-number-formatting';
+//# sourceMappingURL=ft-result.js.map

package/dist/utils/ft-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-result.js","sourceRoot":"","sources":["../../src/utils/ft-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,KAAK,EAAE,EAAE,IAAI,IAAI,EAAsB,MAAM,yCAAyC,CAAC"}

package/dist/utils/number-parse.js

@@ -0,0 +1,33 @@
+export function parseIntStrict(value) {
+    return isStringifiedInteger(value) ? parseInt(value, 10) : undefined;
+}
+export function isStringifiedInteger(value) {
+    const length = value.length;
+    let gotDigit = false;
+    for (let i = 0; i < length; i++) {
+        const char = value[i];
+        switch (char) {
+            case '-': {
+                if (i !== 0) {
+                    return false;
+                }
+                else {
+                    break;
+                }
+            }
+            default: {
+                if (!isDigitCharCode(char.charCodeAt(0))) {
+                    return false;
+                }
+                else {
+                    gotDigit = true;
+                }
+            }
+        }
+    }
+    return gotDigit;
+}
+export function isDigitCharCode(charCode) {
+    return charCode >= 48 && charCode <= 57;
+}
+//# sourceMappingURL=number-parse.js.map

package/dist/utils/number-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-parse.js","sourceRoot":"","sources":["../../src/utils/number-parse.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE5B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACZ,OAAO,KAAK,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,MAAM;gBACR,CAAC;YACH,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,OAAO,KAAK,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,IAAI,EAAE,IAAI,QAAQ,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/utils/string-builder.js

@@ -0,0 +1,40 @@
+export class StringBuilder {
+    static _defaultInitialCapacity = 10;
+    _initialCapacity;
+    _count = 0;
+    _values;
+    constructor(initialCapacity = StringBuilder._defaultInitialCapacity) {
+        this._initialCapacity = initialCapacity;
+        this._values = new Array(this._initialCapacity);
+    }
+    get capacity() {
+        return this._values.length;
+    }
+    set capacity(newCapacity) {
+        this._values.length = newCapacity;
+        if (this._count > newCapacity) {
+            this._count = newCapacity;
+        }
+    }
+    toString() {
+        this.capacity = this._count;
+        return this._values.join('');
+    }
+    append(value) {
+        if (this._count >= this.capacity) {
+            this.growCapacity(1);
+        }
+        this._values[this._count++] = value;
+    }
+    appendLine(value = '') {
+        this.append(value + '\n');
+    }
+    clear() {
+        this._count = 0;
+        this._values.length = this._initialCapacity;
+    }
+    growCapacity(byAtLeast) {
+        this._values.length += (this._values.length + byAtLeast) * 2;
+    }
+}
+//# sourceMappingURL=string-builder.js.map

package/dist/utils/string-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-builder.js","sourceRoot":"","sources":["../../src/utils/string-builder.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAa;IAChB,MAAM,CAAU,uBAAuB,GAAG,EAAE,CAAC;IAE7C,gBAAgB,CAAS;IACzB,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,CAAW;IAE1B,YAAY,kBAA0B,aAAa,CAAC,uBAAuB;QACzE,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,IAAI,QAAQ,CAAC,WAAmB;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;IAC9C,CAAC;IAEO,YAAY,CAAC,SAAiB;QACpC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@pbkware/fielded-text-web",
-  "version": "0.1.2",
-  "description": "A parser/generator library based on Fielded Text.",
+  "version": "0.2.2",
+  "description": "A reader and writer TypeScript library for text data with fields, based on Fielded Text. Browser compatible.",
   "type": "module",
   "sideEffects": false,
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "exports": {
     ".": {
@@ -20,11 +20,18 @@
     "README.md",
     "LICENSE"
   ],
-  "homepage": "https://pbkware.github.io/fielded-text-web/",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://pbkware.github.io/fielded-text-ts/Web/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pbkware/fielded-text-web.git",
-    "directory": "lib"
+    "url": "git+https://github.com/pbkware/fielded-text-ts.git",
+    "directory": "web"
+  },
+  "bugs": {
+    "url": "https://github.com/pbkware/fielded-text-ts/issues"
   },
   "contributors": [
     "Paul Klink (https://paul.klink.au)"
@@ -56,33 +63,24 @@
     "docs:check:nullability": "(command -v rg >/dev/null && rg -n \"nullableValue.*undefined|asNullable.*undefined|nullable value accessors return.*undefined\" README.md docs/guide examples --glob \"*.md\" || grep -R -n -E \"nullableValue.*undefined|asNullable.*undefined|nullable value accessors return.*undefined\" README.md docs/guide examples --include='*.md') && echo \"ERROR: found undefined nullable-value docs pattern\" && exit 1 || true",
     "docs:align": "npm run build && npm test && npm run examples:all && npm run docs && npm run api && npm run docs:check:drift && npm run docs:check:nullability",
     "lint": "eslint",
-    "prettier": "npx prettier --write .",
-    "docs": "typedoc",
-    "docs:watch": "typedoc --watch",
-    "docs:serve": "vite --config ./vite.docs-dev.config.mjs --host",
-    "publish:pre": "cp ../README.md ./README.md && cp ../LICENSE ./LICENSE && npm run dist",
-    "publish:post": "rm ./README.md && rm ./LICENSE",
-    "publish": "npm run publish:pre && npm publish --access=public && npm run publish:post"
+    "prettier": "npx prettier --write ."
   },
   "dependencies": {
-    "@pbkware/dot-net-date-number-formatting": "^0.3.0",
-    "@pbkware/js-utils": "^0.9.1",
-    "fast-xml-builder": "^1.2.0",
-    "fast-xml-parser": "^5.8.0"
+    "@pbkware/dot-net-date-number-formatting": "^0.3.2",
+    "fast-xml-builder": "^1.3.1",
+    "fast-xml-parser": "^5.11.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@microsoft/api-extractor": "^7.58.7",
+    "@microsoft/api-extractor": "^7.59.1",
     "del-cli": "^7.0.0",
-    "eslint": "^10.4.0",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-import-x": "^4.16.2",
-    "prettier": "^3.8.3",
-    "tsx": "^4.21.0",
-    "typedoc": "^0.28.19",
+    "eslint": "^10.10.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.0",
-    "vite": "^8.0.16",
-    "vitest": "^4.1.5"
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^4.1.11"
   }
 }

package/src/api/ft-reader.ts

@@ -1,6 +1,7 @@
 import { FtMeta } from '../meta/ft-meta.js';
 import { FtSerializationReader } from '../serialization/ft-serialization-reader.js';
-import { FtStringReader, FtTextReader } from '../serialization/ft-text-reader.js';
+import { FtStringReader } from '../serialization/text-reader/ft-string-reader.js';
+import { FtTextReader } from '../serialization/text-reader/ft-text-reader.js';
 
 /**
  * High-level reader for fielded text files.

package/src/api/ft-serialization.ts

@@ -5,16 +5,16 @@ import { FtSequenceInvokationList } from '../sequences/core/ft-sequence-invokati
 import { FtSequenceInvokation } from '../sequences/core/ft-sequence-invokation.js';
 import { FtSequenceList } from '../sequences/core/ft-sequence-list.js';
 import { FtSequence } from '../sequences/core/ft-sequence.js';
+import { FtFieldHeadingReadyEventArgs } from '../serialization/events/ft-field-heading-ready-event-args.js';
+import { FtFieldValueReadyEventArgs } from '../serialization/events/ft-field-value-ready-event-args.js';
+import { FtHeadingLineFinishedEventArgs } from '../serialization/events/ft-heading-line-finished-event-args.js';
+import { FtHeadingLineStartedEventArgs } from '../serialization/events/ft-heading-line-started-event-args.js';
+import { FtRecordFinishedEventArgs } from '../serialization/events/ft-record-finished-event-args.js';
+import { FtRecordStartedEventArgs } from '../serialization/events/ft-record-started-event-args.js';
+import { FtSequenceRedirectedEventArgs } from '../serialization/events/ft-sequence-redirected-event-args.js';
+import { FtSerializationCore } from '../serialization/ft-serialization-core.js';
 import { FtTextWriter } from '../serialization/ft-text-writer.js';
-import { SerializationCore } from '../serialization/serialization-core.js';
 import { FtSubstitutionList } from '../substitutions/ft-substitution-list.js';
-import { FtFieldHeadingReadyEventArgs } from '../types/events/ft-field-heading-ready-event-args.js';
-import { FtFieldValueReadyEventArgs } from '../types/events/ft-field-value-ready-event-args.js';
-import { FtHeadingLineFinishedEventArgs } from '../types/events/ft-heading-line-finished-event-args.js';
-import { FtHeadingLineStartedEventArgs } from '../types/events/ft-heading-line-started-event-args.js';
-import { FtRecordFinishedEventArgs } from '../types/events/ft-record-finished-event-args.js';
-import { FtRecordStartedEventArgs } from '../types/events/ft-record-started-event-args.js';
-import { FtSequenceRedirectedEventArgs } from '../types/events/ft-sequence-redirected-event-args.js';
 import { FtReader } from './ft-reader.js';
 import { FtWriterSettings } from './ft-writer-settings.js';
 import { FtWriter } from './ft-writer.js';
@@ -36,9 +36,9 @@ export class FtAbortSerializationException extends Error {
  * @public
  */
 export class FtSerialization {
-  static readonly VERSION_MAJOR = SerializationCore.VersionMajor;
-  static readonly VERSION_MINOR = SerializationCore.VersionMinor;
-  static readonly PREFIX_SPACE_CHAR = SerializationCore.PrefixSpaceChar;
+  static readonly VERSION_MAJOR = FtSerializationCore.VersionMajor;
+  static readonly VERSION_MINOR = FtSerializationCore.VersionMinor;
+  static readonly PREFIX_SPACE_CHAR = FtSerializationCore.PrefixSpaceChar;
 
   // Event hooks
   onFieldHeadingReadReady: ((args: FtFieldHeadingReadyEventArgs) => void) | undefined = undefined;
@@ -52,7 +52,7 @@ export class FtSerialization {
   onSequenceRedirected: ((args: FtSequenceRedirectedEventArgs) => void) | undefined = undefined;
 
   private _meta: FtMeta;
-  private _core: SerializationCore | undefined = undefined;
+  private _core: FtSerializationCore | undefined = undefined;
 
   constructor(meta: FtMeta) {
     this._meta = meta;
@@ -155,7 +155,7 @@ export class FtSerialization {
     }
   }
 
-  private setCore(core: SerializationCore): void {
+  private setCore(core: FtSerializationCore): void {
     this._core = core;
 
     // Wire up event handlers

package/src/factory/ft-field-factory.ts

@@ -22,7 +22,7 @@ import { FtStringMetaField } from '../meta/fields/ft-string-meta-field.js';
 import { FtSequenceInvokation } from '../sequences/core/ft-sequence-invokation.js';
 import { FtSequenceItem } from '../sequences/core/ft-sequence-item.js';
 import { FtDataType } from '../types/enums/ft-data-type.js';
-import { FtUnreachableCaseError } from '../types/errors/ft-internal-error.js';
+import { FtUnreachableCaseError } from '../utils/ft-internal-error.js';
 
 /**
  * Factory for creating field instances based on their definitions.

package/src/factory/ft-sequence-redirect-factory.ts

@@ -1,4 +1,3 @@
-import { Err, Ok, Result } from '@pbkware/js-utils';
 import { FtBooleanSequenceRedirect } from '../sequences/redirects/ft-boolean-sequence-redirect.js';
 import { FtCaseInsensitiveStringSequenceRedirect } from '../sequences/redirects/ft-case-insensitive-string-sequence-redirect.js';
 import { FtDateSequenceRedirect } from '../sequences/redirects/ft-date-sequence-redirect.js';
@@ -10,6 +9,7 @@ import { FtExactStringSequenceRedirect } from '../sequences/redirects/ft-exact-s
 import { FtNullSequenceRedirect } from '../sequences/redirects/ft-null-sequence-redirect.js';
 import { FtSequenceRedirect } from '../sequences/redirects/ft-sequence-redirect.js';
 import { FtSequenceRedirectType } from '../types/enums/ft-sequence-redirect-type.js';
+import { FtErr, FtOk, FtResult } from '../utils/ft-result.js';
 import { FtSequenceRedirectConstructor } from './ft-sequence-redirect-constructor.js';
 
 // Concrete constructor implementations
@@ -178,12 +178,12 @@ export class FtSequenceRedirectFactory {
     return constructor.sequenceRedirectTypeName;
   }
 
-  static tryGetType(typeName: string): Result<FtSequenceRedirectType, boolean> {
+  static tryGetType(typeName: string): FtResult<FtSequenceRedirectType, boolean> {
     const constructor = FtSequenceRedirectFactory.tryFindConstructorByName(typeName);
     if (constructor) {
-      return new Ok(constructor.sequenceRedirectType);
+      return new FtOk(constructor.sequenceRedirectType);
     }
-    return new Err(false);
+    return new FtErr(false);
   }
 
   private static tryFindConstructorByType(type: FtSequenceRedirectType): FtSequenceRedirectConstructor | undefined {

package/src/fields/definitions/ft-boolean-field-definition.ts

@@ -39,7 +39,7 @@ export class FtBooleanFieldDefinition extends FtGenericFieldDefinition<boolean>
     this.formatter.styles = metaField.styles;
   }
 
-  getValueText(value: boolean): string {
+  formatValue(value: boolean): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/definitions/ft-date-time-field-definition.ts

@@ -42,7 +42,7 @@ export class FtDateTimeFieldDefinition extends FtGenericFieldDefinition<Date> {
     this._constantValue = dateTimeMetaField.value;
   }
 
-  getValueText(value: Date): string {
+  formatValue(value: Date): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/definitions/ft-decimal-field-definition.ts

@@ -33,7 +33,7 @@ export class FtDecimalFieldDefinition extends FtGenericFieldDefinition<number> {
     this.formatter.styles = metaField.styles;
   }
 
-  getValueText(value: number): string {
+  formatValue(value: number): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/definitions/ft-field-definition.ts

@@ -8,7 +8,7 @@ import { FtPadAlignment } from '../../types/enums/ft-pad-alignment.js';
 import { FtPadCharType } from '../../types/enums/ft-pad-char-type.js';
 import { FtQuotedType } from '../../types/enums/ft-quoted-type.js';
 import { FtTruncateType } from '../../types/enums/ft-truncate-type.js';
-import { FtUnreachableCaseError } from '../../types/errors/ft-internal-error.js';
+import { FtUnreachableCaseError } from '../../utils/ft-internal-error.js';
 
 const InternalError = {
   FtFieldFieldDefinition_LoadMeta_UnsupportedHeadingPadAlignment: 'FtFieldFieldDefinition_LoadMeta_UnsupportedHeadingPadAlignment',

package/src/fields/definitions/ft-float-field-definition.ts

@@ -33,7 +33,7 @@ export class FtFloatFieldDefinition extends FtGenericFieldDefinition<number> {
     this.formatter.styles = metaField.styles;
   }
 
-  getValueText(value: number): string {
+  formatValue(value: number): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/definitions/ft-generic-field-definition.ts

@@ -38,7 +38,7 @@ export abstract class FtGenericFieldDefinition<T> extends FtFieldDefinition {
    * @param value - The value to convert
    * @returns The text representation
    */
-  abstract getValueText(value: T): string;
+  abstract formatValue(value: T): string;
 
   /**
    * Parse text into a typed value.

package/src/fields/definitions/ft-integer-field-definition.ts

@@ -34,7 +34,7 @@ export class FtIntegerFieldDefinition extends FtGenericFieldDefinition<bigint> {
     this.formatter.styles = metaField.styles;
   }
 
-  getValueText(value: bigint): string {
+  formatValue(value: bigint): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/definitions/ft-string-field-definition.ts

@@ -16,7 +16,7 @@ export class FtStringFieldDefinition extends FtGenericFieldDefinition<string> {
     super(FtDataType.String, 'string', formatter, FtStringFieldDefinition.AUTO_LEFT_PAD, index);
   }
 
-  getValueText(value: string): string {
+  formatValue(value: string): string {
     return this.formatter.toText(value);
   }
 

package/src/fields/instances/errors/ft-field-null-error.ts

@@ -0,0 +1,10 @@
+/**
+ * Thrown when a field value is null and an operation is attempted that requires a non-null value.
+ * @public
+ */
+export class FtFieldNullError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'FtFieldNullError';
+  }
+}

package/src/fields/instances/errors/ft-field-type-error.ts

@@ -0,0 +1,10 @@
+/**
+ * Thrown when a field value is of an unexpected type.
+ * @public
+ */
+export class FtFieldTypeError extends TypeError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'FtFieldTypeError';
+  }
+}

package/src/fields/instances/ft-boolean-field.ts

@@ -1,7 +1,10 @@
 import { FtSequenceInvokation } from '../../sequences/core/ft-sequence-invokation.js';
 import { FtSequenceItem } from '../../sequences/core/ft-sequence-item.js';
 import { FtBooleanStyles } from '../../types/enums/ft-boolean-styles.js';
+import { FtDataType } from '../../types/enums/ft-data-type.js';
 import { FtBooleanFieldDefinition } from '../definitions/ft-boolean-field-definition.js';
+import { FtFieldTypeError } from './errors/ft-field-type-error.js';
+import { FtField } from './ft-field.js';
 import { FtGenericField } from './ft-generic-field.js';
 
 /**
@@ -31,18 +34,26 @@ export class FtBooleanField extends FtGenericField<boolean> {
     return this.definition.styles;
   }
 
-  get nullableValue(): boolean | null {
-    return this.isNull() ? null : this.value;
+  static cast(field: FtField): field is FtBooleanField {
+    return field.dataType === FtDataType.Boolean;
   }
 
-  set nullableValue(value: boolean | null) {
-    if (value === null) {
-      this.setNull();
+  override setValue(newValue: FtField.Value): number {
+    if (typeof newValue === 'boolean') {
+      return super.setValue(newValue);
     } else {
-      this.value = value;
+      throw new FtFieldTypeError(`Invalid type (${typeof newValue}) for boolean field: ${this.name}`);
     }
   }
 
+  protected override getAsBoolean(): boolean {
+    return this.getValue();
+  }
+
+  protected override setAsBoolean(newValue: boolean): void {
+    super.setValue(newValue);
+  }
+
   protected isValueEqual(left: boolean, right: boolean): boolean {
     return left === right;
   }

package/src/fields/instances/ft-date-time-field.ts

@@ -1,6 +1,9 @@
 import { FtSequenceInvokation } from '../../sequences/core/ft-sequence-invokation.js';
 import { FtSequenceItem } from '../../sequences/core/ft-sequence-item.js';
+import { FtDataType } from '../../types/enums/ft-data-type.js';
 import { FtDateTimeFieldDefinition } from '../definitions/ft-date-time-field-definition.js';
+import { FtFieldTypeError } from './errors/ft-field-type-error.js';
+import { FtField } from './ft-field.js';
 import { FtGenericField } from './ft-generic-field.js';
 
 /**
@@ -26,18 +29,36 @@ export class FtDateTimeField extends FtGenericField<Date> {
     return this.definition.styles;
   }
 
-  get nullableValue(): Date | null {
-    return this.isNull() ? null : this.value;
+  static cast(field: FtField): field is FtDateTimeField {
+    return field.dataType === FtDataType.DateTime;
   }
 
-  set nullableValue(value: Date | null) {
-    if (value === null) {
-      this.setNull();
-    } else {
-      this.value = value;
+  override setValue(newValue: FtField.Value): number {
+    switch (typeof newValue) {
+      case 'string':
+      case 'number':
+        return super.setValue(new Date(newValue));
+        break;
+      case 'object':
+        if (newValue instanceof Date) {
+          return super.setValue(newValue);
+        } else {
+          throw new FtFieldTypeError(`Invalid object for DateTime field: ${this.name}`);
+        }
+        break;
+      default:
+        throw new FtFieldTypeError(`Invalid type (${typeof newValue}) for date-time field: ${this.name}`);
     }
   }
 
+  protected override getAsDateTime(): Date {
+    return this.getValue();
+  }
+
+  protected override setAsDateTime(newValue: Date): void {
+    super.setValue(newValue);
+  }
+
   protected isValueEqual(left: Date, right: Date): boolean {
     return left.getTime() === right.getTime();
   }