@pbkware/fielded-text-web 0.1.2 → 0.2.2

package/dist/index.d.ts

@@ -3,7 +3,9 @@ import { DotNetDateTimeStyles } from '@pbkware/dot-net-date-number-formatting';
 import { DotNetLocaleSettings } from '@pbkware/dot-net-date-number-formatting';
 import { DotNetNumberStyleFlags } from '@pbkware/dot-net-date-number-formatting';
 import { DotNetNumberStyles } from '@pbkware/dot-net-date-number-formatting';
-import { Result } from '@pbkware/js-utils';
+import { Err as FtErr } from '@pbkware/dot-net-date-number-formatting';
+import { Ok as FtOk } from '@pbkware/dot-net-date-number-formatting';
+import { Result as FtResult } from '@pbkware/dot-net-date-number-formatting';
 
 export { DotNetDateTimeStyleFlags }
 
@@ -34,8 +36,10 @@ export declare class FtBooleanField extends FtGenericField<boolean> {
     get falseText(): string;
     get trueText(): string;
     get styles(): FtBooleanStyles;
-    get nullableValue(): boolean | null;
-    set nullableValue(value: boolean | null);
+    static cast(field: FtField): field is FtBooleanField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsBoolean(): boolean;
+    protected setAsBoolean(newValue: boolean): void;
     protected isValueEqual(left: boolean, right: boolean): boolean;
 }
 
@@ -51,7 +55,7 @@ export declare class FtBooleanFieldDefinition extends FtGenericFieldDefinition<b
     get trueText(): string;
     get styles(): FtBooleanStyles;
     loadMeta(metaField: FtBooleanMetaField, myCulture: DotNetLocaleSettings | undefined, myMainHeadingIndex: number): void;
-    getValueText(value: boolean): string;
+    formatValue(value: boolean): string;
     parseValueText(text: string): boolean;
 }
 
@@ -194,6 +198,7 @@ export declare class FtCaseInsensitiveStringMetaSequenceRedirect extends FtMetaS
 export declare class FtCaseInsensitiveStringSequenceRedirect extends FtSequenceRedirect {
     static readonly TYPE: "CaseInsensitiveString";
     private _value;
+    private _lowerCaseValue;
     constructor(index: number);
     get value(): string;
     checkTriggered(field: FtField): boolean;
@@ -201,6 +206,50 @@ export declare class FtCaseInsensitiveStringSequenceRedirect extends FtSequenceR
     loadMeta(metaSequenceRedirect: FtCaseInsensitiveStringMetaSequenceRedirect, metaSequenceList: FtMetaSequenceList, sequenceList: FtSequenceList): void;
 }
 
+/** @public */
+export declare namespace FtCommaText {
+    const delimiterChar = ",";
+    const quoteChar = "\"";
+    const pairQuoteChar: string;
+    export function from2Values(value1: string, value2: string): string;
+    export function from3Values(value1: string, value2: string, value3: string): string;
+    export function from4Values(value1: string, value2: string, value3: string, value4: string): string;
+    export function fromStringArray(value: readonly string[]): string;
+    export function fromIntegerArray(value: number[]): string;
+    export function toStringArray(value: string): string[];
+    export function tryToStringArray(value: string, strict?: boolean): FtResult<string[], ErrorIdPlusExtra<typeof ErrorId.QuotesNotClosedInLastElement | typeof ErrorId.UnexpectedCharAfterQuotedElement>>;
+    export interface ToIntegerArrayResult {
+        success: boolean;
+        array: number[];
+        errorText: string;
+    }
+    export function toIntegerArrayWithResult(value: string): FtResult<number[], ErrorIdPlusExtra<typeof ErrorId.QuotesNotClosedInLastElement | typeof ErrorId.UnexpectedCharAfterQuotedElement | typeof ErrorId.InvalidIntegerString>>;
+    export interface StrictValidateResult {
+        success: boolean;
+        errorText: string;
+    }
+    export function strictValidate(value: string): FtResult<boolean, ErrorIdPlusExtra<typeof ErrorId.QuotesNotClosedInLastElement | typeof ErrorId.UnexpectedCharAfterQuotedElement>>;
+    const ErrorId: {
+        readonly UnexpectedCharAfterQuotedElement: "UnexpectedCharAfterQuotedElement";
+        readonly QuotesNotClosedInLastElement: "QuotesNotClosedInLastElement";
+        readonly InvalidIntegerString: "InvalidIntegerString";
+    };
+    export type ErrorId = (typeof ErrorId)[keyof typeof ErrorId];
+    export function errorIdToEnglish(errorId: ErrorId): "Unexpected char after quoted element" | "Quotes not closed in last element" | "Invalid integer string";
+    export interface ErrorIdPlusExtra<T extends ErrorId> {
+        readonly errorId: T;
+        readonly extraInfo: string;
+    }
+    export namespace ErrorIdPlusExtra {
+        export function toEnglish(errorIdPlusExtra: ErrorIdPlusExtra<ErrorId>): string;
+    }
+    export class Error extends globalThis.Error {
+        readonly errorId: ErrorId;
+        readonly extraInfo: string;
+        constructor(message: string, errorId: ErrorId, extraInfo: string);
+    }
+}
+
 /**
  * @public
  */
@@ -262,8 +311,10 @@ export declare class FtDateTimeField extends FtGenericField<Date> {
     get definition(): FtDateTimeFieldDefinition;
     get format(): string;
     get styles(): number;
-    get nullableValue(): Date | null;
-    set nullableValue(value: Date | null);
+    static cast(field: FtField): field is FtDateTimeField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsDateTime(): Date;
+    protected setAsDateTime(newValue: Date): void;
     protected isValueEqual(left: Date, right: Date): boolean;
 }
 
@@ -280,7 +331,7 @@ export declare class FtDateTimeFieldDefinition extends FtGenericFieldDefinition<
     get styles(): DotNetDateTimeStyles;
     get constantValue(): Date;
     loadMeta(metaField: FtMetaField, myCulture: DotNetLocaleSettings | undefined, myMainHeadingIndex: number): void;
-    getValueText(value: Date): string;
+    formatValue(value: Date): string;
     parseValueText(text: string): Date;
 }
 
@@ -346,8 +397,10 @@ export declare class FtDecimalField extends FtGenericField<number> {
     get definition(): FtDecimalFieldDefinition;
     get format(): string;
     get styles(): number;
-    get nullableValue(): number | null;
-    set nullableValue(value: number | null);
+    static cast(field: FtField): field is FtDecimalField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsDecimal(): number;
+    protected setAsDecimal(newValue: number): void;
     protected isValueEqual(left: number, right: number): boolean;
 }
 
@@ -362,7 +415,7 @@ export declare class FtDecimalFieldDefinition extends FtGenericFieldDefinition<n
     get format(): string;
     get styles(): DotNetNumberStyles;
     loadMeta(metaField: FtDecimalMetaField, myCulture: DotNetLocaleSettings | undefined, myMainHeadingIndex: number): void;
-    getValueText(value: number): string;
+    formatValue(value: number): string;
     parseValueText(text: string): number;
 }
 
@@ -438,7 +491,7 @@ export declare class FtDeclaredParameters {
     indexOfName(name: string): number;
     indexOfVersion(): number;
     setVersion(major: number, minor: number, comment?: string): void;
-    tryGetVersion(): Result<Version, boolean>;
+    tryGetVersion(): FtResult<Version, boolean>;
     getMetaReference(): {
         type: FtMetaReferenceType;
         reference: string;
@@ -506,6 +559,8 @@ export declare const FtEndOfLineType: {
  */
 export declare type FtEndOfLineType = (typeof FtEndOfLineType)[keyof typeof FtEndOfLineType];
 
+export { FtErr }
+
 /**
  * Meta sequence redirect that triggers when a field value exactly matches a specific date-time value.
  * Used in metadata to define sequence transitions based on exact date-time field values (including time component).
@@ -685,7 +740,7 @@ export declare abstract class FtField {
     static readonly NO_FIELDS_AFFECTED_INDEX = -1;
     protected static readonly IGNORED_SEQUENCE_INVOKATION_DELAY: "AfterSequence";
     sequenceRedirectEvent: FtSequenceRedirectDelegate | undefined;
-    protected valueAssigned: boolean;
+    protected _valueAssigned: boolean;
     protected quoted: boolean;
     private _index;
     private _definition;
@@ -702,7 +757,7 @@ export declare abstract class FtField {
     private _loadedLength;
     private _loadedRawOffset;
     private _loadedRawLength;
-    private _loadedValueText;
+    private _valueText;
     protected constructor(sequenceInvokation: FtSequenceInvokation, sequenceItem: FtSequenceItem, valueTextNullTrimmable: boolean);
     get definition_(): FtFieldDefinition;
     get index(): number;
@@ -716,8 +771,14 @@ export declare abstract class FtField {
     get sequenceInvokation(): FtSequenceInvokation;
     get headingCount(): number;
     get headings(): string[];
-    get valueAssigned_(): boolean;
-    get loadedValueText(): string;
+    /**
+     * Indicates whether a value has been assigned to the field.
+     */
+    get valueAssigned(): boolean;
+    /**
+     * The formatted text of the field value as loaded from the data or via {@link loadValueText}.
+     */
+    get valueText(): string;
     get dataType(): FtDataType;
     get id(): number | undefined;
     get name(): string;
@@ -760,41 +821,167 @@ export declare abstract class FtField {
     get asRedirectDateTime(): Date;
     /** @internal */
     get asRedirectDecimal(): number;
-    get asValueText(): string | null;
-    set asValueText(value: string | null);
-    get asObject(): unknown;
-    set asObject(value: unknown);
-    get asString(): string | null;
-    set asString(value: string | null);
+    /**
+     * The field value as an unspecified type.
+     *
+     * When setting the value, the actual type must be compatible with the field's expected type.
+     *
+     * @throws FtFieldNullError if the field is `null`.
+     */
+    get value(): FtField.Value;
+    set value(value: FtField.Value);
+    /**
+     * The field value as a string.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `String`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
+    get asString(): string;
+    set asString(value: string);
+    /**
+     * The field value as a boolean.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Boolean`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asBoolean(): boolean;
     set asBoolean(value: boolean);
+    /**
+     * The field value as an integer.
+
+     * @throws FtFieldTypeError if the field is not of data type `Integer`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asInteger(): number;
     set asInteger(value: number);
+    /**
+     * The field value as a bigint.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `BigInt`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asBigInt(): bigint;
     set asBigInt(value: bigint);
+    /**
+     * The field value as a float.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Float`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asFloat(): number;
     set asFloat(value: number);
+    /**
+     * The field value as a DateTime.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `DateTime`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asDateTime(): Date;
     set asDateTime(value: Date);
+    /**
+     * The field value as a number (decimal).
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Decimal`.
+     * @throws FtFieldNullError if the field is `null`.
+     */
     get asDecimal(): number;
     set asDecimal(value: number);
+    /**
+     * The field value as an unspecified type or null.
+
+     * Use with caution, as this bypasses type safety. Ensure that the value being set is compatible with the field's expected type.
+     */
+    get nullableValue(): FtField.Value | null;
+    set nullableValue(value: FtField.Value | null);
+    /**
+     * The field value as a string or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `String`.
+     */
+    get asNullableString(): string | null;
+    set asNullableString(value: string | null);
+    /**
+     * The field value as a boolean or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Boolean`.
+     */
     get asNullableBoolean(): boolean | null;
     set asNullableBoolean(value: boolean | null);
+    /**
+     * The field value as an integer or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `BigInt`.
+     */
     get asNullableInteger(): number | null;
     set asNullableInteger(value: number | null);
+    /**
+     * The field value as a bigint or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `BigInt`.
+     */
     get asNullableBigInt(): bigint | null;
     set asNullableBigInt(value: bigint | null);
+    /**
+     * The field value as a float or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Float`.
+     */
     get asNullableFloat(): number | null;
     set asNullableFloat(value: number | null);
+    /**
+     * The field value as a Date or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `DateTime`.
+     */
     get asNullableDateTime(): Date | null;
     set asNullableDateTime(value: Date | null);
+    /**
+     * The field value as a number (decimal) or null.
+     *
+     * @throws FtFieldTypeError if the field is not of data type `Decimal`.
+     */
     get asNullableDecimal(): number | null;
     set asNullableDecimal(value: number | null);
+    /**
+     * Checks if the field value is null.
+     * @returns True if the field value is null, false otherwise.
+     */
     isNull(): boolean;
+    /**
+     * Sets the field value to null.
+     *
+     * Checks for sequence redirects that may be triggered by setting the field to null.
+     *
+     * @returns If this setting of field to null caused a sequence redirect, returns the index of the first field affected by the redirect. If no redirect occurred, returns FtField.NO_FIELDS_AFFECTED_INDEX.
+     * @throws Error if the field is constant and cannot be set to null.
+     */
     setNull(): number;
+    /**
+     * Loads the field value from its formatted text representation.
+     * @param valueText - Formatted text representation of field value. Formatting only includes data type formatting and not text formatting such as quoting, padding, truncating etc.
+     */
+    loadValueText(valueText: string): void;
+    /**
+     * Loads the field headings from an array of strings.
+     *
+     * The headings are loaded according to the field's heading constraint. See {@link loadHeading} for more information.
+     *
+     * @param value - An array of headings. The length of the array should be equal to {@link headingCount}. Extra headings are ignored and missing headings are set to empty strings.
+     */
     loadHeadings(value: string[]): void;
+    /**
+     * Loads a heading into one of the field's heading lines.
+     *
+     * The heading is loaded according to the field's heading constraint.
+     *
+     * @param idx - Index of the heading to load.
+     * @param headingText - Text of the heading.
+     */
     loadHeading(idx: number, headingText: string): void;
-    /** @internal */
+    /**
+     * Checks if setting the field to null triggers a sequence redirect.
+     * @internal
+     */
     checkNullSequenceRedirect(): number;
     /** @internal */
     resetValue(): void;
@@ -806,40 +993,32 @@ export declare abstract class FtField {
     loadFixedWidthValue(valueText: string): void;
     /** @internal */
     loadNullValue(): void;
-    /**
-     * Get the field value as text (for writing). Public accessor for protected method.
-     * @internal
-     */
-    getValueText(): string;
-    /**
-     * Check if the field value has been assigned. Public accessor for protected property.
-     * @internal
-     */
-    isValueAssigned(): boolean;
     protected onSequenceRedirect(sequence: FtSequence | undefined, delay: FtSequenceInvokationDelay): number;
     protected clearNonConstantNull(): void;
-    private setAsNonNullValueText;
-    private setAsValueText;
-    private setAsObject;
-    private setAsString;
-    protected abstract getAsNonNullValueText(): string;
-    protected abstract loadNonNullValue(valueText: string): void;
-    protected abstract getAsNonNullObject(): unknown;
-    protected abstract getAsNonNullString(): string;
-    protected abstract getAsBoolean(): boolean;
-    protected abstract getAsInteger(): number;
-    protected abstract getAsBigInt(): bigint;
-    protected abstract getAsFloat(): number;
-    protected abstract getAsDateTime(): Date;
-    protected abstract getAsDecimal(): number;
-    protected abstract setAsNonNullObject(newValue: unknown): void;
-    protected abstract setAsNonNullString(newValue: string): void;
-    protected abstract setAsBoolean(newValue: boolean): void;
-    protected abstract setAsInteger(newValue: number): void;
-    protected abstract setAsBigInt(newValue: bigint): void;
-    protected abstract setAsFloat(newValue: number): void;
-    protected abstract setAsDateTime(newValue: Date): void;
-    protected abstract setAsDecimal(newValue: number): void;
+    protected getAsString(): string;
+    protected getAsBoolean(): boolean;
+    protected getAsInteger(): number;
+    protected getAsBigInt(): bigint;
+    protected getAsFloat(): number;
+    protected getAsDateTime(): Date;
+    protected getAsDecimal(): number;
+    protected setAsString(_newValue: string): void;
+    protected setAsBoolean(_newValue: boolean): void;
+    protected setAsInteger(_newValue: number): void;
+    protected setAsBigInt(_newValue: bigint): void;
+    protected setAsFloat(_newValue: number): void;
+    protected setAsDateTime(_newValue: Date): void;
+    protected setAsDecimal(_newValue: number): void;
+    /**
+     * Formats the field value to a string.
+     *
+     * The formatting includes data type formatting but not text formatting such as quoting, padding, truncating etc. This formatted string typically
+     * is identical to the string value in the field's {@link valueText} property (unless the field value has been modified after loading).
+     */
+    abstract formatValue(): string;
+    protected abstract loadValueFromText(valueText: string): void;
+    protected abstract getValue(): FtField.Value;
+    protected abstract setValue(newValue: FtField.Value): number;
     protected abstract getAsRedirectBoolean(): boolean;
     protected abstract getAsRedirectInteger(): bigint;
     protected abstract getAsRedirectFloat(): number;
@@ -847,6 +1026,12 @@ export declare abstract class FtField {
     protected abstract getAsRedirectDecimal(): number;
 }
 
+/** @public */
+export declare namespace FtField {
+    export type Value = string | boolean | number | bigint | Date;
+    export type NullableValue = Value | null;
+}
+
 /**
  * Abstract base class for all field definitions.
  * Field definitions hold metadata and configuration for fields in fielded text.
@@ -1012,8 +1197,10 @@ export declare class FtFloatField extends FtGenericField<number> {
     get definition(): FtFloatFieldDefinition;
     get format(): string;
     get styles(): number;
-    get nullableValue(): number | null;
-    set nullableValue(value: number | null);
+    static cast(field: FtField): field is FtFloatField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsFloat(): number;
+    protected setAsFloat(newValue: number): void;
     protected isValueEqual(left: number, right: number): boolean;
 }
 
@@ -1028,7 +1215,7 @@ export declare class FtFloatFieldDefinition extends FtGenericFieldDefinition<num
     get format(): string;
     get styles(): number;
     loadMeta(metaField: FtFloatMetaField, myCulture: DotNetLocaleSettings | undefined, myMainHeadingIndex: number): void;
-    getValueText(value: number): string;
+    formatValue(value: number): string;
     parseValueText(text: string): number;
 }
 
@@ -1078,37 +1265,23 @@ export declare class FtFloatMetaField extends FtGenericMetaField<number> {
  * Provides type-safe value access and implements conversion methods.
  * @public
  */
-export declare abstract class FtGenericField<T> extends FtField {
+export declare abstract class FtGenericField<T extends FtField.Value> extends FtField {
     private _value;
     protected constructor(sequenceInvokation: FtSequenceInvokation, sequenceItem: FtSequenceItem, valueTextNullTrimmable: boolean, definition: FtGenericFieldDefinition<T>);
     get definition_(): FtGenericFieldDefinition<T>;
     get value(): T;
     set value(val: T);
+    get nullableValue(): T | null;
+    set nullableValue(value: T | null);
     setValue(val: T): number;
-    protected getAsNonNullValueText(): string;
-    protected getAsNonNullObject(): unknown;
-    protected getAsNonNullString(): string;
-    protected getAsBoolean(): boolean;
-    protected getAsInteger(): number;
-    protected getAsBigInt(): bigint;
-    protected getAsFloat(): number;
-    protected getAsDateTime(): Date;
-    protected getAsDecimal(): number;
-    protected setAsNonNullObject(newValue: unknown): void;
-    protected setAsNonNullString(newValue: string): void;
-    protected setAsBoolean(newValue: boolean): void;
-    protected setAsInteger(newValue: number): void;
-    protected setAsBigInt(newValue: bigint): void;
-    protected setAsFloat(newValue: number): void;
-    protected setAsDateTime(newValue: Date): void;
-    protected setAsDecimal(newValue: number): void;
+    formatValue(): string;
+    protected getValue(): T;
     protected getAsRedirectBoolean(): boolean;
     protected getAsRedirectInteger(): bigint;
     protected getAsRedirectFloat(): number;
     protected getAsRedirectDateTime(): Date;
     protected getAsRedirectDecimal(): number;
-    protected loadNonNullValue(valueText: string): void;
-    private getValueOrThrowNull;
+    protected loadValueFromText(valueText: string): void;
     private checkValueSequenceRedirect;
     /**
      * Check if two values are equal.
@@ -1139,7 +1312,7 @@ export declare abstract class FtGenericFieldDefinition<T> extends FtFieldDefinit
      * @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.
      * @param text - The text to parse
@@ -1167,10 +1340,15 @@ export declare abstract class FtGenericMetaField<T> extends FtMetaField {
  * @public
  */
 export declare const FtHeadingConstraint: {
+    /** No constraings on headings */
     readonly None: "None";
+    /** All headings in the data must match the headings specified in the Meta */
     readonly AllConstant: "AllConstant";
+    /** The heading in the main heading line in the data must match the corresponding heading specified in the Meta */
     readonly MainConstant: "MainConstant";
+    /** The heading in the main heading line in the data must case-insensitively match the field's name */
     readonly NameConstant: "NameConstant";
+    /** The field's name is set to the heading in the main heading line in the data */
     readonly NameIsMain: "NameIsMain";
 };
 
@@ -1203,8 +1381,12 @@ export declare class FtIntegerField extends FtGenericField<bigint> {
     get definition(): FtIntegerFieldDefinition;
     get format(): string;
     get styles(): number;
-    get nullableValue(): bigint | null;
-    set nullableValue(value: bigint | null);
+    static cast(field: FtField): field is FtIntegerField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsBigInt(): bigint;
+    protected setAsBigInt(newValue: bigint): void;
+    protected getAsInteger(): number;
+    protected setAsInteger(newValue: number): void;
     protected isValueEqual(left: bigint, right: bigint): boolean;
 }
 
@@ -1220,7 +1402,7 @@ export declare class FtIntegerFieldDefinition extends FtGenericFieldDefinition<b
     get format(): string;
     get styles(): number;
     loadMeta(metaField: FtIntegerMetaField, myCulture: DotNetLocaleSettings | undefined, myMainHeadingIndex: number): void;
-    getValueText(value: bigint): string;
+    formatValue(value: bigint): string;
     parseValueText(text: string): bigint;
 }
 
@@ -1265,6 +1447,32 @@ export declare class FtIntegerMetaField extends FtGenericMetaField<bigint> {
     protected assignFrom(source: FtMetaField): void;
 }
 
+/** @public */
+export declare abstract class FtInternalError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string | undefined, errorType: string);
+}
+
+/** @public */
+export declare namespace FtInternalError {
+    const AssertErrorType = "FtAssert";
+    const UnreachableCaseErrorType = "FtUnreachableCase";
+    const ExtraFormatting: {
+        readonly Ignore: "Ignore";
+        readonly PrependWithColonSpace: "PrependWithColonSpace";
+        readonly PrependWithColonSpaceQuoteError: "PrependWithColonSpaceQuoteError";
+        readonly Postpend: "Postpend";
+        readonly PostpendColonSpace: "PostpendColonSpace";
+        readonly PostpendColonSpaceQuoted: "PostpendColonSpaceQuoted";
+    };
+    export type ExtraFormatting = (typeof ExtraFormatting)[keyof typeof ExtraFormatting];
+    export function formatExtra(existingMessage: string, extraMessage: string, extraFormatting: ExtraFormatting): string;
+    export function appendToErrorMessage(e: unknown, appendText: string): unknown;
+    export function prependErrorMessage(e: unknown, prependText: string): unknown;
+    export function createTypeIfNotError<E extends Error>(e: unknown, code: string, errorConstructor: new (code: string, message?: string) => E, extraMessage?: string, extraFormatting?: FtInternalError.ExtraFormatting): Error | E;
+    export function throwErrorTypeIfPromiseRejected<T>(promise: Promise<T>, code: string, errorConstructor: new (code: string, message?: string) => Error, extraMessage?: string, extraFormatting?: FtInternalError.ExtraFormatting): void;
+}
+
 /**
  * Serializes and deserializes FtMeta to/from JSON format.
  * This provides a simpler alternative to XML serialization.
@@ -1877,7 +2085,7 @@ export declare class FtMetaSequenceList {
     private readonly _list;
     get count(): number;
     get(index: number): FtMetaSequence;
-    getByName(name: string): FtMetaSequence;
+    getByName(name: string): FtMetaSequence | undefined;
     set(value: readonly FtMetaSequence[]): void;
     new(name?: string): FtMetaSequence;
     removeAt(index: number): void;
@@ -2063,6 +2271,14 @@ export declare class FtMetaSubstitutionList {
     assign(source: FtMetaSubstitutionList): void;
 }
 
+/**
+ * Thrown when a field value is null and an operation is attempted that requires a non-null value.
+ * @public
+ */
+export declare class FtNullError extends Error {
+    constructor(message: string);
+}
+
 /**
  * Meta sequence redirect that triggers when a field value is null.
  * Used in metadata to define sequence transitions based on null field values.
@@ -2103,6 +2319,8 @@ export declare class FtNumberStylesMetaSerialization {
     private static getDefaultNumberStyles;
 }
 
+export { FtOk }
+
 /**
  * @public
  */
@@ -2224,6 +2442,8 @@ export declare interface FtRecordStartedEventArgs {
     recordIndex: number;
 }
 
+export { FtResult }
+
 /**
  * Represents a sequence of fielded text items.
  * A sequence defines a pattern of fields that can be repeated.
@@ -2482,7 +2702,7 @@ export declare class FtSequenceRedirectFactory {
     static unregisterConstructor(constructorOrType: FtSequenceRedirectConstructor | FtSequenceRedirectType | string): void;
     static createSequenceRedirect(index: number, typeOrName: FtSequenceRedirectType | string): FtSequenceRedirect;
     static getName(type: FtSequenceRedirectType): string;
-    static tryGetType(typeName: string): Result<FtSequenceRedirectType, boolean>;
+    static tryGetType(typeName: string): FtResult<FtSequenceRedirectType, boolean>;
     private static tryFindConstructorByType;
     private static tryFindConstructorByName;
 }
@@ -2579,11 +2799,256 @@ export declare class FtSerialization {
     private setCore;
 }
 
+/**
+ * Base class for serialization (reading/writing).
+ * Manages configuration, field lists, sequences, and events.
+ * @public
+ */
+export declare abstract class FtSerializationCore {
+    static readonly VersionMajor = 1;
+    static readonly VersionMinor = 1;
+    static readonly PrefixSpaceChar = " ";
+    protected static readonly Signature = "|!Fielded Text^|";
+    protected static readonly VersionLabel = "Version";
+    protected static readonly VersionSeparator = ".";
+    protected static readonly CarriageReturnChar = "\r";
+    protected static readonly LineFeedChar = "\n";
+    protected static readonly CarriageReturnLineFeedString = "\r\n";
+    onFieldHeadingReadReady?: (args: FtFieldHeadingReadyEventArgs) => void;
+    onFieldHeadingWriteReady?: (args: FtFieldHeadingReadyEventArgs) => void;
+    onFieldValueReadReady?: (args: FtFieldValueReadyEventArgs) => void;
+    onFieldValueWriteReady?: (args: FtFieldValueReadyEventArgs) => void;
+    onHeadingLineStarted?: (args: FtHeadingLineStartedEventArgs) => void;
+    onHeadingLineFinished?: (args: FtHeadingLineFinishedEventArgs) => void;
+    onRecordStarted?: (args: FtRecordStartedEventArgs) => void;
+    onRecordFinished?: (args: FtRecordFinishedEventArgs) => void;
+    onSequenceRedirected?: (args: FtSequenceRedirectedEventArgs) => void;
+    protected _recordCount: number;
+    protected _tableCount: number;
+    private _fieldDefinitionList;
+    private _fieldList;
+    private _substitutionList;
+    private _sequenceList;
+    private _culture;
+    private _endOfLineType;
+    private _endOfLineChar;
+    private _endOfLineAutoWriteType;
+    private _lastLineEndedType;
+    private _quoteChar;
+    private _delimiterChar;
+    private _lineCommentChar;
+    private _allowEndOfLineCharInQuotes;
+    private _ignoreBlankLines;
+    private _ignoreExtraChars;
+    private _allowIncompleteRecords;
+    private _stuffedEmbeddedQuotes;
+    private _substitutionsEnabled;
+    private _substitutionChar;
+    private _headingLineCount;
+    private _mainHeadingLineIndex;
+    private _headingConstraint;
+    private _headingQuotedType;
+    private _headingAlwaysWriteOptionalQuote;
+    private _headingWritePrefixSpace;
+    private _headingPadAlignment;
+    private _headingPadCharType;
+    private _headingPadChar;
+    private _headingTruncateType;
+    private _headingTruncateChar;
+    private _headingEndOfValueChar;
+    private _rootSequence;
+    private _rootFieldCount;
+    private _sequenceInvokationList;
+    private _previousRecordSequenceInvokationList;
+    private _rootSequenceInvokation;
+    private _seeking;
+    protected constructor();
+    get fieldDefinitionList(): FtFieldDefinitionList;
+    get fieldList(): FtFieldList;
+    get substitutionList(): FtSubstitutionList;
+    get sequenceList(): FtSequenceList;
+    get sequenceInvokationList(): FtSequenceInvokationList;
+    get previousRecordSequenceInvokationList(): FtSequenceInvokationList;
+    get rootSequence(): FtSequence | undefined;
+    get rootFieldCount(): number;
+    get rootSequenceInvokation(): FtSequenceInvokation | undefined;
+    get seeking(): boolean;
+    get recordCount(): number;
+    get tableCount(): number;
+    get culture(): DotNetLocaleSettings;
+    get endOfLineType(): FtEndOfLineType;
+    get endOfLineChar(): string;
+    get endOfLineAutoWriteType(): FtEndOfLineAutoWriteType;
+    get lastLineEndedType(): FtLastLineEndedType;
+    get quoteChar(): string;
+    get delimiterChar(): string;
+    get lineCommentChar(): string;
+    get allowEndOfLineCharInQuotes(): boolean;
+    get ignoreBlankLines(): boolean;
+    get ignoreExtraChars(): boolean;
+    get allowIncompleteRecords(): boolean;
+    get stuffedEmbeddedQuotes(): boolean;
+    get substitutionsEnabled(): boolean;
+    get substitutionChar(): string;
+    get headingLineCount(): number;
+    get mainHeadingLineIndex(): number;
+    get headingConstraint(): FtHeadingConstraint;
+    get headingQuotedType(): FtQuotedType;
+    get headingAlwaysWriteOptionalQuote(): boolean;
+    get headingWritePrefixSpace(): boolean;
+    get headingPadAlignment(): FtPadAlignment;
+    get headingPadCharType(): FtPadCharType;
+    get headingPadChar(): string;
+    get headingTruncateType(): FtTruncateType;
+    get headingTruncateChar(): string;
+    get headingEndOfValueChar(): string;
+    /**
+     * Number of fields in the current record.
+     *
+     * IDataReader member
+     */
+    get fieldCount(): number;
+    /**
+     * Number of sequences currently invoked (depth of sequence invokation stack).
+     *
+     * IDataReader member
+     */
+    get depth(): number;
+    /**
+     * Whether the reader/writer is closed.
+     *
+     * IDataReader member
+     */
+    abstract get isClosed(): boolean;
+    /**
+     * Name of the field at the given index.
+     * Alias for {@link getFieldName}.
+     *
+     * IDataReader member
+     */
+    getName(idx: number): string;
+    /**
+     * Get a index of field in record by its name.
+     *
+     * IDataReader member
+     * @throws Error if the field is not found.
+     */
+    getOrdinal(name: string): number;
+    /**
+     * Whether the field value at the given index is null.
+     * Alias for {@link isFieldNull}.
+     *
+     * IDataReader member
+     */
+    isDBNull(idx: number): boolean;
+    /**
+     * Get a FtField object at index.
+     */
+    getField(idx: number): FtField;
+    /**
+     * Get a FtField object by name.
+     */
+    getFieldByName(name: string): FtField | undefined;
+    /**
+     * Get a index of field in record by its name.
+     * @throws Error if the field is not found.
+     */
+    getFieldIndexByName(name: string): number | undefined;
+    /**
+     * Get the name of the field at the given index.
+     */
+    getFieldName(idx: number): string;
+    /**
+     * Get a field value by index.
+     * @throws FtFieldNullError if the field value is null.
+     */
+    getFieldValue(idx: number): FtField.Value | null;
+    /**
+     * Whether the field value at the given index is null.
+     */
+    isFieldNull(idx: number): boolean;
+    /**
+     * Get the value type of the field at the given index.
+     */
+    getFieldValueType(idx: number): string;
+    /**
+     * Get a field value by index. Returns `null` if the field value is null.
+     */
+    getFieldNullableValue(idx: number): FtField.Value | null;
+    /**
+     * Get a field value by name.
+     * @throws FtFieldNullError if the field value is null.
+     * @throws Error if the field is not found.
+     */
+    getFieldValueByName(name: string): FtField.Value | null;
+    /**
+     * Get a field value by name. Returns `null` if the field value is null.
+     * @throws Error if the field is not found.
+     */
+    getFieldNullableValueByName(name: string): FtField.Value | null;
+    tryGetSubstitutionValue(token: string): {
+        found: boolean;
+        value: string;
+    };
+    /**
+     * Load configuration from FtMeta.
+     */
+    loadMeta(meta: FtMeta): void;
+    /**
+     * Invoke the root sequence to begin reading/writing.
+     * @internal For testing purposes, can be called to initialize field list.
+     */
+    invokeRootSequence(): void;
+    /** @internal */
+    fireFieldHeadingReadReady(field: FtField, lineIndex: number): void;
+    /** @internal */
+    fireFieldValueReadReady(field: FtField, recordIndex: number): void;
+    protected internalLoadMeta(meta: FtMeta): void;
+    protected setSeeking(value: boolean): void;
+    protected setLineCommentChar(aChar: string): void;
+    protected redirect(redirectingField: FtField, invokedSequence: FtSequence, invokationDelay: FtSequenceInvokationDelay): number;
+    protected unredirect(unredirectingField: FtField): number;
+    protected fireFieldHeadingWriteReady(field: FtField, lineIndex: number): void;
+    protected fireFieldValueWriteReady(field: FtField, recordIndex: number): void;
+    protected fireHeadingLineStarted(lineIndex: number): void;
+    protected fireHeadingLineFinished(lineIndex: number): void;
+    protected fireRecordStarted(recordIndex: number): void;
+    protected fireRecordFinished(recordIndex: number): void;
+    protected fireSequenceRedirected(redirectingField: FtField, fieldsAffectedFromIndex: number): void;
+    /**
+     * Reset serialization state.
+     */
+    protected reset(): void;
+    private resetAllFieldValues;
+    private resetFieldValues;
+    private handleSequenceRedirectEvent;
+    private calculateAutoEndOfLineSubstitutionValue;
+    abstract close(): void;
+}
+
+/**
+ * Exception thrown during fielded text serialization/deserialization.
+ * @public
+ */
+export declare class FtSerializationError extends Error {
+    private readonly _error;
+    private readonly _fieldName;
+    private readonly _fieldIndex;
+    private readonly _sequenceName;
+    private readonly _sequenceItemIndex;
+    constructor(errorCode: FtSerializationErrorCode, fieldOrMessage: FtField | string | undefined, messageOrInner?: string | Error, innerException?: Error);
+    get error(): FtSerializationErrorCode;
+    get fieldName(): string | undefined;
+    get fieldIndex(): number;
+    get sequenceName(): string | undefined;
+    get sequenceItemIndex(): number;
+}
+
 /**
  * Enumeration of serialization error codes.
  * @public
  */
-export declare const FtSerializationError: {
+export declare const FtSerializationErrorCode: {
     readonly Abort: "Abort";
     readonly DeclarationParameterNameIsZeroLength: "DeclarationParameterNameIsZeroLength";
     readonly DeclaredParameterNameContainsSeparator: "DeclaredParameterNameContainsSeparator";
@@ -2631,31 +3096,13 @@ export declare const FtSerializationError: {
 /**
  * @public
  */
-export declare type FtSerializationError = (typeof FtSerializationError)[keyof typeof FtSerializationError];
-
-/**
- * Exception thrown during fielded text serialization/deserialization.
- * @public
- */
-export declare class FtSerializationException extends Error {
-    private readonly _error;
-    private readonly _fieldName;
-    private readonly _fieldIndex;
-    private readonly _sequenceName;
-    private readonly _sequenceItemIndex;
-    constructor(error: FtSerializationError, fieldOrMessage: FtField | string | undefined, messageOrInner?: string | Error, innerException?: Error);
-    get error(): FtSerializationError;
-    get fieldName(): string | undefined;
-    get fieldIndex(): number;
-    get sequenceName(): string | undefined;
-    get sequenceItemIndex(): number;
-}
+export declare type FtSerializationErrorCode = (typeof FtSerializationErrorCode)[keyof typeof FtSerializationErrorCode];
 
 /**
  * Reader for fielded text streams. Coordinates all parsing components.
  * @public
  */
-export declare class FtSerializationReader extends SerializationCore {
+export declare class FtSerializationReader extends FtSerializationCore {
     /**
      * Event fired when seeking through records.
      */
@@ -2800,22 +3247,6 @@ export declare class FtSerializationReader extends SerializationCore {
      * Seek to the end of the stream.
      */
     seekEnd(): void;
-    /**
-     * Get a field object by index.
-     */
-    getField(idx: number): FtField;
-    /**
-     * Get a field object by name.
-     */
-    getFieldByName(name: string): FtField | undefined;
-    /**
-     * Get a field value by index.
-     */
-    getFieldValue(idx: number): unknown;
-    /**
-     * Get a field value by name.
-     */
-    getFieldValueByName(name: string): unknown;
     /**
      * Load metadata from a pre-parsed FtMeta object.
      * @param meta - The metadata to load.
@@ -2865,7 +3296,7 @@ export declare namespace FtSerializationReader {
  * Writer for fielded text streams. Coordinates all writing logic.
  * @public
  */
-export declare class FtSerializationWriter extends SerializationCore {
+export declare class FtSerializationWriter extends FtSerializationCore {
     private static readonly DECLARATION_LINE2_BEFORE_COMMENT_CHARS;
     private static readonly EMBEDDED_META_BEFORE_COMMENT_CHARS;
     private _loadedMeta;
@@ -2914,45 +3345,85 @@ export declare class FtSerializationWriter extends SerializationCore {
      */
     flush(): void;
     /**
-     * Set a field value by index.
+     * Set a field value by index. Accepts `null` to set the field to null.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
+     *
+     * @throws FtTypeError if the value being set is not of the field's expected type.
      */
-    setFieldValue(idx: number, value: unknown): void;
+    setFieldValue(idx: number, value: FtField.Value | null): void;
     /**
      * Set a field value by name.
+     *
+     * @param name - The name of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
+     *
+     * @throws FtTypeError if the value being set is not of the field's expected type.
      */
-    setFieldValueByName(name: string, value: unknown): void;
+    setFieldValueByName(name: string, value: FtField.Value | null): void;
     /**
      * Set a field to null.
+     *
+     * @param idx - The 0-based index of the field to set.
      */
     setNull(idx: number): void;
+    /**
+     * Set a field to null.
+     *
+     * @param name - The name of the field to set.
+     */
+    setNullByName(name: string): void;
     /**
      * Set a boolean field.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setBoolean(idx: number, value: boolean): void;
+    setBoolean(idx: number, value: boolean | null): void;
     /**
-     * Set a date/time field.
+     * Set a DateTime field's value.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setDateTime(idx: number, value: Date): void;
+    setDateTime(idx: number, value: Date | null): void;
     /**
      * Set a decimal field.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setDecimal(idx: number, value: number): void;
+    setDecimal(idx: number, value: number | null): void;
     /**
      * Set a float field.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setFloat(idx: number, value: number): void;
+    setFloat(idx: number, value: number | null): void;
     /**
      * Set an integer field.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setInteger(idx: number, value: number | bigint): void;
+    setInteger(idx: number, value: number | bigint | null): void;
     /**
      * Set a string field.
+     *
+     * @param idx - The 0-based index of the field to set.
+     * @param value - The value to set for the field. Can be `null` to set the field to null.
      */
-    setString(idx: number, value: string): void;
+    setString(idx: number, value: string | null): void;
     /**
      * Set multiple field values.
+     *
+     * @param values - An array of values to set for the fields. The length of the array must not exceed the number of fields. Array elements can be null to set the corresponding field to null.
+     *
+     * @throws FtTypeError if any of the values being set is not of the corresponding field's expected type.
      */
-    setValues(values: unknown[]): void;
+    setValues(values: (FtField.Value | null)[]): void;
     protected reset(): void;
     /**
      * Internal load metadata. Override from SerializationCore.
@@ -2995,9 +3466,10 @@ export declare class FtSerializationWriter extends SerializationCore {
 export declare class FtStringField extends FtGenericField<string> {
     private static readonly VALUE_TEXT_NULL_TRIMMABLE;
     constructor(sequenceInvokation: FtSequenceInvokation, sequenceItem: FtSequenceItem, definition: FtStringFieldDefinition);
-    get nullableValue(): string | null;
-    set nullableValue(value: string | null);
-    setValue(value: string | null): number;
+    static cast(field: FtField): field is FtStringField;
+    setValue(newValue: FtField.Value): number;
+    protected getAsString(): string;
+    protected setAsString(newValue: string): void;
     protected isValueEqual(left: string, right: string): boolean;
 }
 
@@ -3009,7 +3481,7 @@ export declare class FtStringFieldDefinition extends FtGenericFieldDefinition<st
     static readonly AUTO_LEFT_PAD = false;
     protected formatter: FtStringFieldFormatter;
     constructor(index: number);
-    getValueText(value: string): string;
+    formatValue(value: string): string;
     parseValueText(text: string): string;
 }
 
@@ -3213,6 +3685,14 @@ export declare const FtTruncateType: {
  */
 export declare type FtTruncateType = (typeof FtTruncateType)[keyof typeof FtTruncateType];
 
+/**
+ * Thrown when a field value is of an unexpected type.
+ * @public
+ */
+export declare class FtTypeError extends TypeError {
+    constructor(message: string);
+}
+
 /**
  * High-level writer for fielded text files.
  * Provides a convenient API for writing CSV and other delimited/fixed-width text.
@@ -3317,163 +3797,11 @@ export declare namespace FtXmlMetaSerialization {
     export function deserialize(xml: string, warnings?: string[]): FtMeta;
 }
 
-export { Result }
-
 /**
  * @public
  */
 declare type RootedEventHandler = (sequence: FtMetaSequence) => void;
 
-/**
- * Base class for serialization (reading/writing).
- * Manages configuration, field lists, sequences, and events.
- * @public
- */
-declare abstract class SerializationCore {
-    static readonly VersionMajor = 1;
-    static readonly VersionMinor = 1;
-    static readonly PrefixSpaceChar = " ";
-    protected static readonly Signature = "|!Fielded Text^|";
-    protected static readonly VersionLabel = "Version";
-    protected static readonly VersionSeparator = ".";
-    protected static readonly CarriageReturnChar = "\r";
-    protected static readonly LineFeedChar = "\n";
-    protected static readonly CarriageReturnLineFeedString = "\r\n";
-    onFieldHeadingReadReady?: (args: FtFieldHeadingReadyEventArgs) => void;
-    onFieldHeadingWriteReady?: (args: FtFieldHeadingReadyEventArgs) => void;
-    onFieldValueReadReady?: (args: FtFieldValueReadyEventArgs) => void;
-    onFieldValueWriteReady?: (args: FtFieldValueReadyEventArgs) => void;
-    onHeadingLineStarted?: (args: FtHeadingLineStartedEventArgs) => void;
-    onHeadingLineFinished?: (args: FtHeadingLineFinishedEventArgs) => void;
-    onRecordStarted?: (args: FtRecordStartedEventArgs) => void;
-    onRecordFinished?: (args: FtRecordFinishedEventArgs) => void;
-    onSequenceRedirected?: (args: FtSequenceRedirectedEventArgs) => void;
-    protected _recordCount: number;
-    protected _tableCount: number;
-    private _fieldDefinitionList;
-    private _fieldList;
-    private _substitutionList;
-    private _sequenceList;
-    private _culture;
-    private _endOfLineType;
-    private _endOfLineChar;
-    private _endOfLineAutoWriteType;
-    private _lastLineEndedType;
-    private _quoteChar;
-    private _delimiterChar;
-    private _lineCommentChar;
-    private _allowEndOfLineCharInQuotes;
-    private _ignoreBlankLines;
-    private _ignoreExtraChars;
-    private _allowIncompleteRecords;
-    private _stuffedEmbeddedQuotes;
-    private _substitutionsEnabled;
-    private _substitutionChar;
-    private _headingLineCount;
-    private _mainHeadingLineIndex;
-    private _headingConstraint;
-    private _headingQuotedType;
-    private _headingAlwaysWriteOptionalQuote;
-    private _headingWritePrefixSpace;
-    private _headingPadAlignment;
-    private _headingPadCharType;
-    private _headingPadChar;
-    private _headingTruncateType;
-    private _headingTruncateChar;
-    private _headingEndOfValueChar;
-    private _rootSequence;
-    private _rootFieldCount;
-    private _sequenceInvokationList;
-    private _previousRecordSequenceInvokationList;
-    private _rootSequenceInvokation;
-    private _seeking;
-    protected constructor();
-    get fieldDefinitionList(): FtFieldDefinitionList;
-    get fieldList(): FtFieldList;
-    get substitutionList(): FtSubstitutionList;
-    get sequenceList(): FtSequenceList;
-    get sequenceInvokationList(): FtSequenceInvokationList;
-    get previousRecordSequenceInvokationList(): FtSequenceInvokationList;
-    get rootSequence(): FtSequence | undefined;
-    get rootFieldCount(): number;
-    get rootSequenceInvokation(): FtSequenceInvokation | undefined;
-    get seeking(): boolean;
-    get recordCount(): number;
-    get tableCount(): number;
-    get culture(): DotNetLocaleSettings;
-    get endOfLineType(): FtEndOfLineType;
-    get endOfLineChar(): string;
-    get endOfLineAutoWriteType(): FtEndOfLineAutoWriteType;
-    get lastLineEndedType(): FtLastLineEndedType;
-    get quoteChar(): string;
-    get delimiterChar(): string;
-    get lineCommentChar(): string;
-    get allowEndOfLineCharInQuotes(): boolean;
-    get ignoreBlankLines(): boolean;
-    get ignoreExtraChars(): boolean;
-    get allowIncompleteRecords(): boolean;
-    get stuffedEmbeddedQuotes(): boolean;
-    get substitutionsEnabled(): boolean;
-    get substitutionChar(): string;
-    get headingLineCount(): number;
-    get mainHeadingLineIndex(): number;
-    get headingConstraint(): FtHeadingConstraint;
-    get headingQuotedType(): FtQuotedType;
-    get headingAlwaysWriteOptionalQuote(): boolean;
-    get headingWritePrefixSpace(): boolean;
-    get headingPadAlignment(): FtPadAlignment;
-    get headingPadCharType(): FtPadCharType;
-    get headingPadChar(): string;
-    get headingTruncateType(): FtTruncateType;
-    get headingTruncateChar(): string;
-    get headingEndOfValueChar(): string;
-    get fieldCount(): number;
-    get depth(): number;
-    abstract get isClosed(): boolean;
-    getName(idx: number): string;
-    getOrdinal(name: string): number;
-    getValueType(idx: number): string;
-    isDBNull(idx: number): boolean;
-    tryGetSubstitutionValue(token: string): {
-        found: boolean;
-        value: string;
-    };
-    /**
-     * Load configuration from FtMeta.
-     */
-    loadMeta(meta: FtMeta): void;
-    /**
-     * Invoke the root sequence to begin reading/writing.
-     * @internal For testing purposes, can be called to initialize field list.
-     */
-    invokeRootSequence(): void;
-    /** @internal */
-    fireFieldHeadingReadReady(field: FtField, lineIndex: number): void;
-    /** @internal */
-    fireFieldValueReadReady(field: FtField, recordIndex: number): void;
-    protected internalLoadMeta(meta: FtMeta): void;
-    protected setSeeking(value: boolean): void;
-    protected setLineCommentChar(aChar: string): void;
-    protected redirect(redirectingField: FtField, invokedSequence: FtSequence, invokationDelay: FtSequenceInvokationDelay): number;
-    protected unredirect(unredirectingField: FtField): number;
-    protected fireFieldHeadingWriteReady(field: FtField, lineIndex: number): void;
-    protected fireFieldValueWriteReady(field: FtField, recordIndex: number): void;
-    protected fireHeadingLineStarted(lineIndex: number): void;
-    protected fireHeadingLineFinished(lineIndex: number): void;
-    protected fireRecordStarted(recordIndex: number): void;
-    protected fireRecordFinished(recordIndex: number): void;
-    protected fireSequenceRedirected(redirectingField: FtField, fieldsAffectedFromIndex: number): void;
-    /**
-     * Reset serialization state.
-     */
-    protected reset(): void;
-    private resetAllFieldValues;
-    private resetFieldValues;
-    private handleSequenceRedirectEvent;
-    private calculateAutoEndOfLineSubstitutionValue;
-    abstract close(): void;
-}
-
 declare interface Version {
     major: number;
     minor: number;