@pbkware/fielded-text-web 0.1.0

package/dist/api/ft-reader.js

@@ -0,0 +1,59 @@
+import { FtMeta } from '../meta/ft-meta.js';
+import { FtSerializationReader } from '../serialization/ft-serialization-reader.js';
+import { FtStringReader } from '../serialization/ft-text-reader.js';
+/**
+ * High-level reader for fielded text files.
+ * Provides a convenient API for reading CSV and other delimited/fixed-width text.
+ * This is a thin wrapper around SerializationReader with simpler constructors.
+ * @public
+ */
+export class FtReader extends FtSerializationReader {
+    constructor(metaOrInputOrTextReader, inputOrTextReaderOrImmediatelyReadHeader, immediatelyReadHeader = true) {
+        super();
+        if (metaOrInputOrTextReader instanceof FtMeta) {
+            // Constructor with meta
+            this.loadMeta(metaOrInputOrTextReader);
+            if (typeof inputOrTextReaderOrImmediatelyReadHeader === 'string') {
+                // FtReader(meta, input, immediatelyReadHeader)
+                this.open(inputOrTextReaderOrImmediatelyReadHeader, immediatelyReadHeader);
+            }
+            else if (inputOrTextReaderOrImmediatelyReadHeader &&
+                typeof inputOrTextReaderOrImmediatelyReadHeader === 'object' &&
+                'read' in inputOrTextReaderOrImmediatelyReadHeader) {
+                // FtReader(meta, textReader, immediatelyReadHeader)
+                this.open(inputOrTextReaderOrImmediatelyReadHeader, immediatelyReadHeader);
+            }
+            else {
+                // FtReader(meta) - just reset, no open
+                this.reset();
+            }
+        }
+        else if (typeof metaOrInputOrTextReader === 'string') {
+            // FtReader(input, immediatelyReadHeader)
+            const shouldReadHeader = typeof inputOrTextReaderOrImmediatelyReadHeader === 'boolean' ? inputOrTextReaderOrImmediatelyReadHeader : true;
+            this.open(metaOrInputOrTextReader, shouldReadHeader);
+        }
+        else if (metaOrInputOrTextReader && typeof metaOrInputOrTextReader === 'object' && 'read' in metaOrInputOrTextReader) {
+            // FtReader(textReader, immediatelyReadHeader)
+            const shouldReadHeader = typeof inputOrTextReaderOrImmediatelyReadHeader === 'boolean' ? inputOrTextReaderOrImmediatelyReadHeader : true;
+            this.open(metaOrInputOrTextReader, shouldReadHeader);
+        }
+    }
+    /**
+     * Open the reader with a text string.
+     * @param textReaderOrText - Text reader or string providing the data to read
+     * @param immediatelyReadHeader - Whether to automatically read header lines (default: true)
+     */
+    open(textReaderOrText, immediatelyReadHeader = true) {
+        let textReader;
+        if (typeof textReaderOrText === 'string') {
+            // String input - create StringReader
+            textReader = new FtStringReader(textReaderOrText);
+        }
+        else {
+            textReader = textReaderOrText;
+        }
+        super.open(textReader, immediatelyReadHeader);
+    }
+}
+//# sourceMappingURL=ft-reader.js.map

package/dist/api/ft-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-reader.js","sourceRoot":"","sources":["../../src/api/ft-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAgB,MAAM,oCAAoC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,qBAAqB;IA4CjD,YACE,uBAAwD,EACxD,wCAA0E,EAC1E,qBAAqB,GAAG,IAAI;QAE5B,KAAK,EAAE,CAAC;QAER,IAAI,uBAAuB,YAAY,MAAM,EAAE,CAAC;YAC9C,wBAAwB;YACxB,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;YAEvC,IAAI,OAAO,wCAAwC,KAAK,QAAQ,EAAE,CAAC;gBACjE,+CAA+C;gBAC/C,IAAI,CAAC,IAAI,CAAC,wCAAwC,EAAE,qBAAqB,CAAC,CAAC;YAC7E,CAAC;iBAAM,IACL,wCAAwC;gBACxC,OAAO,wCAAwC,KAAK,QAAQ;gBAC5D,MAAM,IAAI,wCAAwC,EAClD,CAAC;gBACD,oDAAoD;gBACpD,IAAI,CAAC,IAAI,CAAC,wCAAwC,EAAE,qBAAqB,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,uCAAuC;gBACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,uBAAuB,KAAK,QAAQ,EAAE,CAAC;YACvD,yCAAyC;YACzC,MAAM,gBAAgB,GAAG,OAAO,wCAAwC,KAAK,SAAS,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzI,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,uBAAuB,IAAI,OAAO,uBAAuB,KAAK,QAAQ,IAAI,MAAM,IAAI,uBAAuB,EAAE,CAAC;YACvH,8CAA8C;YAC9C,MAAM,gBAAgB,GAAG,OAAO,wCAAwC,KAAK,SAAS,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzI,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACM,IAAI,CAAC,gBAAuC,EAAE,qBAAqB,GAAG,IAAI;QACjF,IAAI,UAAwB,CAAC;QAC7B,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YACzC,qCAAqC;YACrC,UAAU,GAAG,IAAI,cAAc,CAAC,gBAAgB,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,gBAAgB,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/api/ft-serialization.js

@@ -0,0 +1,147 @@
+import { SerializationCore } from '../serialization/serialization-core.js';
+import { FtReader } from './ft-reader.js';
+import { FtWriter } from './ft-writer.js';
+/**
+ * Exception thrown to abort serialization from an event handler.
+ * @public
+ */
+export class FtAbortSerializationException extends Error {
+    constructor(message) {
+        super(message || 'Serialization aborted');
+        this.name = 'FtAbortSerializationException';
+    }
+}
+/**
+ * High-level API for event-driven serialization and deserialization of fielded text.
+ * Simplifies reading and writing by hooking into field and record events.
+ * @public
+ */
+export class FtSerialization {
+    static VERSION_MAJOR = SerializationCore.VersionMajor;
+    static VERSION_MINOR = SerializationCore.VersionMinor;
+    static PREFIX_SPACE_CHAR = SerializationCore.PrefixSpaceChar;
+    // Event hooks
+    onFieldHeadingReadReady = undefined;
+    onFieldHeadingWriteReady = undefined;
+    onFieldValueReadReady = undefined;
+    onFieldValueWriteReady = undefined;
+    onHeadingLineStarted = undefined;
+    onHeadingLineFinished = undefined;
+    onRecordStarted = undefined;
+    onRecordFinished = undefined;
+    onSequenceRedirected = undefined;
+    _meta;
+    _core = undefined;
+    constructor(meta) {
+        this._meta = meta;
+    }
+    //  Proxied properties from core
+    get fieldDefinitionList() {
+        return this._core?.fieldDefinitionList;
+    }
+    get fieldList() {
+        return this._core?.fieldList;
+    }
+    get substitutionList() {
+        return this._core?.substitutionList;
+    }
+    get sequenceList() {
+        return this._core?.sequenceList;
+    }
+    get sequenceInvokationList() {
+        return this._core?.sequenceInvokationList;
+    }
+    get rootSequence() {
+        return this._core?.rootSequence;
+    }
+    get rootFieldCount() {
+        return this._core?.rootFieldCount || 0;
+    }
+    get rootSequenceInvokation() {
+        return this._core?.rootSequenceInvokation;
+    }
+    get recordCount() {
+        return this._core?.recordCount || 0;
+    }
+    get tableCount() {
+        return this._core?.tableCount || 0;
+    }
+    deserialize(readerOrInput) {
+        const reader = typeof readerOrInput === 'string' ? new FtReader(this._meta, readerOrInput) : readerOrInput;
+        this.setCore(reader);
+        while (reader.read()) {
+            // Events are fired during read()
+        }
+    }
+    serialize(writerOrOutput, settings) {
+        const writer = writerOrOutput instanceof FtWriter ? writerOrOutput : new FtWriter(this._meta, writerOrOutput, settings);
+        this.setCore(writer);
+        try {
+            while (true) {
+                writer.write();
+                // The only way out is to throw FtAbortSerializationException in an event handler
+            }
+        }
+        catch (e) {
+            if (e instanceof FtAbortSerializationException) {
+                // Normal exit
+            }
+            else {
+                throw e;
+            }
+        }
+        finally {
+            writer.close();
+        }
+    }
+    setCore(core) {
+        this._core = core;
+        // Wire up event handlers
+        core.onFieldHeadingReadReady = (args) => {
+            if (this.onFieldHeadingReadReady) {
+                this.onFieldHeadingReadReady(args);
+            }
+        };
+        core.onFieldHeadingWriteReady = (args) => {
+            if (this.onFieldHeadingWriteReady) {
+                this.onFieldHeadingWriteReady(args);
+            }
+        };
+        core.onFieldValueReadReady = (args) => {
+            if (this.onFieldValueReadReady) {
+                this.onFieldValueReadReady(args);
+            }
+        };
+        core.onFieldValueWriteReady = (args) => {
+            if (this.onFieldValueWriteReady) {
+                this.onFieldValueWriteReady(args);
+            }
+        };
+        core.onHeadingLineStarted = (args) => {
+            if (this.onHeadingLineStarted) {
+                this.onHeadingLineStarted(args);
+            }
+        };
+        core.onHeadingLineFinished = (args) => {
+            if (this.onHeadingLineFinished) {
+                this.onHeadingLineFinished(args);
+            }
+        };
+        core.onRecordStarted = (args) => {
+            if (this.onRecordStarted) {
+                this.onRecordStarted(args);
+            }
+        };
+        core.onRecordFinished = (args) => {
+            if (this.onRecordFinished) {
+                this.onRecordFinished(args);
+            }
+        };
+        core.onSequenceRedirected = (args) => {
+            if (this.onSequenceRedirected) {
+                this.onSequenceRedirected(args);
+            }
+        };
+    }
+}
+//# sourceMappingURL=ft-serialization.js.map

package/dist/api/ft-serialization.js.map

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

package/dist/api/ft-writer-settings.js

@@ -0,0 +1,31 @@
+import { FtMetaSerializerOptions } from '../meta-serialization/format/meta-serializer-options.js';
+import { FtMetaReferenceType } from '../types/enums/ft-meta-reference-type.js';
+import { FtMetaSerializationFormat } from '../types/enums/ft-meta-serialization-format.js';
+/** @public */
+export var FtWriterSettings;
+(function (FtWriterSettings) {
+    FtWriterSettings.DEFAULT_DECLARED = false;
+    FtWriterSettings.DEFAULT_META_REFERENCE_TYPE = FtMetaReferenceType.None;
+    FtWriterSettings.DEFAULT_META_REFERENCE = '';
+    FtWriterSettings.DEFAULT_EMBEDDED_META_FORMAT = FtMetaSerializationFormat.XML;
+    FtWriterSettings.DEFAULT_EMBEDDED_META_EXPLICIT_INDICES = FtMetaSerializerOptions.DEFAULT_EXPLICIT_INDICES;
+    FtWriterSettings.DEFAULT_EMBEDDED_META_INDENT = FtMetaSerializerOptions.DEFAULT_INDENT;
+    FtWriterSettings.DEFAULT_EMBEDDED_META_INDENT_CHARS = FtMetaSerializerOptions.DEFAULT_INDENT_CHARS;
+    FtWriterSettings.DEFAULT_EMBEDDED_META_NEW_LINE_ON_ATTRIBUTES = FtMetaSerializerOptions.DEFAULT_NEW_LINE_ON_ATTRIBUTES;
+    function loadMetaSerializerOptions(settings, options) {
+        if (options.explicitIndices !== undefined) {
+            settings.embeddedMetaExplicitIndices = options.explicitIndices;
+        }
+        if (options.indent !== undefined) {
+            settings.embeddedMetaIndent = options.indent;
+        }
+        if (options.indentChars !== undefined) {
+            settings.embeddedMetaIndentChars = options.indentChars;
+        }
+        if (options.newLineOnAttributes !== undefined) {
+            settings.embeddedMetaNewLineOnAttributes = options.newLineOnAttributes;
+        }
+    }
+    FtWriterSettings.loadMetaSerializerOptions = loadMetaSerializerOptions;
+})(FtWriterSettings || (FtWriterSettings = {}));
+//# sourceMappingURL=ft-writer-settings.js.map

package/dist/api/ft-writer-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-writer-settings.js","sourceRoot":"","sources":["../../src/api/ft-writer-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAgD3F,cAAc;AACd,MAAM,KAAW,gBAAgB,CAwBhC;AAxBD,WAAiB,gBAAgB;IAClB,iCAAgB,GAAG,KAAK,CAAC;IACzB,4CAA2B,GAAG,mBAAmB,CAAC,IAAI,CAAC;IACvD,uCAAsB,GAAG,EAAE,CAAC;IAC5B,6CAA4B,GAAG,yBAAyB,CAAC,GAAG,CAAC;IAC7D,uDAAsC,GAAG,uBAAuB,CAAC,wBAAwB,CAAC;IAC1F,6CAA4B,GAAG,uBAAuB,CAAC,cAAc,CAAC;IACtE,mDAAkC,GAAG,uBAAuB,CAAC,oBAAoB,CAAC;IAClF,6DAA4C,GAAG,uBAAuB,CAAC,8BAA8B,CAAC;IAEnH,SAAgB,yBAAyB,CAAC,QAA0B,EAAE,OAAyC;QAC7G,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC1C,QAAQ,CAAC,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC9C,QAAQ,CAAC,+BAA+B,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACzE,CAAC;IACH,CAAC;IAbe,0CAAyB,4BAaxC,CAAA;AACH,CAAC,EAxBgB,gBAAgB,KAAhB,gBAAgB,QAwBhC"}

package/dist/api/ft-writer.js

@@ -0,0 +1,22 @@
+import { FtSerializationWriter } from '../serialization/ft-serialization-writer.js';
+/**
+ * High-level writer for fielded text files.
+ * Provides a convenient API for writing CSV and other delimited/fixed-width text.
+ * This is a thin wrapper around SerializationWriter with simpler constructors.
+ * @public
+ */
+export class FtWriter extends FtSerializationWriter {
+    /**
+     * Create a writer with metadata and output writer.
+     * @param meta - The metadata defining the file structure
+     * @param textWriter - The FtTextWriter to write to. If not provided, FtWriter will be created but not opened (you must call open() before writing).
+     * @param settings - Optional writer settings
+     */
+    constructor(meta, textWriter, settings) {
+        super(meta);
+        if (textWriter) {
+            this.open(textWriter, settings);
+        }
+    }
+}
+//# sourceMappingURL=ft-writer.js.map

package/dist/api/ft-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-writer.js","sourceRoot":"","sources":["../../src/api/ft-writer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAIpF;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,qBAAqB;IACjD;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAyB,EAAE,QAA2B;QAC9E,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF"}

package/dist/factory/ft-field-factory.js

@@ -0,0 +1,86 @@
+import { FtBooleanFieldDefinition } from '../fields/definitions/ft-boolean-field-definition.js';
+import { FtDateTimeFieldDefinition } from '../fields/definitions/ft-date-time-field-definition.js';
+import { FtDecimalFieldDefinition } from '../fields/definitions/ft-decimal-field-definition.js';
+import { FtFloatFieldDefinition } from '../fields/definitions/ft-float-field-definition.js';
+import { FtIntegerFieldDefinition } from '../fields/definitions/ft-integer-field-definition.js';
+import { FtStringFieldDefinition } from '../fields/definitions/ft-string-field-definition.js';
+import { FtBooleanField } from '../fields/instances/ft-boolean-field.js';
+import { FtDateTimeField } from '../fields/instances/ft-date-time-field.js';
+import { FtDecimalField } from '../fields/instances/ft-decimal-field.js';
+import { FtFloatField } from '../fields/instances/ft-float-field.js';
+import { FtIntegerField } from '../fields/instances/ft-integer-field.js';
+import { FtStringField } from '../fields/instances/ft-string-field.js';
+import { FtBooleanMetaField } from '../meta/fields/ft-boolean-meta-field.js';
+import { FtDateTimeMetaField } from '../meta/fields/ft-date-time-meta-field.js';
+import { FtDecimalMetaField } from '../meta/fields/ft-decimal-meta-field.js';
+import { FtFloatMetaField } from '../meta/fields/ft-float-meta-field.js';
+import { FtIntegerMetaField } from '../meta/fields/ft-integer-meta-field.js';
+import { FtStringMetaField } from '../meta/fields/ft-string-meta-field.js';
+import { FtDataType } from '../types/enums/ft-data-type.js';
+import { FtUnreachableCaseError } from '../types/errors/ft-internal-error.js';
+/**
+ * Factory for creating field instances based on their definitions.
+ * @public
+ */
+export class FtFieldFactory {
+    static createFieldDefinition(dataType, index) {
+        switch (dataType) {
+            case FtDataType.String:
+                return new FtStringFieldDefinition(index);
+            case FtDataType.Boolean:
+                return new FtBooleanFieldDefinition(index);
+            case FtDataType.Integer:
+                return new FtIntegerFieldDefinition(index);
+            case FtDataType.Float:
+                return new FtFloatFieldDefinition(index);
+            case FtDataType.Decimal:
+                return new FtDecimalFieldDefinition(index);
+            case FtDataType.DateTime:
+                return new FtDateTimeFieldDefinition(index);
+            default:
+                throw new FtUnreachableCaseError('FFCFD34499', dataType);
+        }
+    }
+    static createField(sequenceInvokation, sequenceItem) {
+        const definition = sequenceItem.fieldDefinition;
+        if (!definition) {
+            throw new Error('SequenceItem must have a field definition');
+        }
+        // Create field based on data type
+        switch (definition.dataType) {
+            case FtDataType.String:
+                return new FtStringField(sequenceInvokation, sequenceItem, definition);
+            case FtDataType.Boolean:
+                return new FtBooleanField(sequenceInvokation, sequenceItem, definition);
+            case FtDataType.Integer:
+                return new FtIntegerField(sequenceInvokation, sequenceItem, definition);
+            case FtDataType.Float:
+                return new FtFloatField(sequenceInvokation, sequenceItem, definition);
+            case FtDataType.Decimal:
+                return new FtDecimalField(sequenceInvokation, sequenceItem, definition);
+            case FtDataType.DateTime:
+                return new FtDateTimeField(sequenceInvokation, sequenceItem, definition);
+            default:
+                throw new FtUnreachableCaseError('FFCFD34499', definition.dataType);
+        }
+    }
+    static createMetaField(dataType, headingCount) {
+        switch (dataType) {
+            case FtDataType.String:
+                return new FtStringMetaField(headingCount);
+            case FtDataType.Boolean:
+                return new FtBooleanMetaField(headingCount);
+            case FtDataType.Integer:
+                return new FtIntegerMetaField(headingCount);
+            case FtDataType.Float:
+                return new FtFloatMetaField(headingCount);
+            case FtDataType.Decimal:
+                return new FtDecimalMetaField(headingCount);
+            case FtDataType.DateTime:
+                return new FtDateTimeMetaField(headingCount);
+            default:
+                throw new FtUnreachableCaseError('FFCMF34499', dataType);
+        }
+    }
+}
+//# sourceMappingURL=ft-field-factory.js.map

package/dist/factory/ft-field-factory.js.map

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

package/dist/factory/ft-meta-constructor.js

@@ -0,0 +1,16 @@
+import { FtMeta } from '../meta/ft-meta.js';
+/**
+ * Base constructor class for creating FtMeta instances.
+ * Can be extended to provide custom meta creation logic.
+ * @public
+ */
+export class FtMetaConstructor {
+    /**
+     * Create a new FtMeta instance.
+     * Override this method in derived classes to provide custom initialization.
+     */
+    createMeta() {
+        return new FtMeta();
+    }
+}
+//# sourceMappingURL=ft-meta-constructor.js.map

package/dist/factory/ft-meta-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-meta-constructor.js","sourceRoot":"","sources":["../../src/factory/ft-meta-constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;;OAGG;IACH,UAAU;QACR,OAAO,IAAI,MAAM,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/factory/ft-meta-factory.js

@@ -0,0 +1,30 @@
+import { FtMetaConstructor } from './ft-meta-constructor.js';
+/**
+ * Factory for creating FtMeta instances.
+ * Provides a global constructor that can be replaced to customize meta creation.
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export class FtMetaFactory {
+    static _constructor = new FtMetaConstructor();
+    /**
+     * Get the current meta constructor.
+     */
+    static getConstructor() {
+        return FtMetaFactory._constructor;
+    }
+    /**
+     * Set a custom meta constructor.
+     * Use this to provide custom initialization logic for all meta instances.
+     */
+    static setConstructor(value) {
+        FtMetaFactory._constructor = value;
+    }
+    /**
+     * Create a new FtMeta instance using the current constructor.
+     */
+    static createMeta() {
+        return FtMetaFactory._constructor.createMeta();
+    }
+}
+//# sourceMappingURL=ft-meta-factory.js.map

package/dist/factory/ft-meta-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-meta-factory.js","sourceRoot":"","sources":["../../src/factory/ft-meta-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,kEAAkE;AAClE,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,YAAY,GAAsB,IAAI,iBAAiB,EAAE,CAAC;IAEzE;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,KAAwB;QAC5C,aAAa,CAAC,YAAY,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,aAAa,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;IACjD,CAAC"}

package/dist/factory/ft-sequence-constructor.js

@@ -0,0 +1,11 @@
+import { FtSequence } from '../sequences/core/ft-sequence.js';
+/**
+ * Constructor for creating sequence instances.
+ * @public
+ */
+export class FtSequenceConstructor {
+    createSequence(index) {
+        return new FtSequence(index);
+    }
+}
+//# sourceMappingURL=ft-sequence-constructor.js.map

package/dist/factory/ft-sequence-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-sequence-constructor.js","sourceRoot":"","sources":["../../src/factory/ft-sequence-constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAChC,cAAc,CAAC,KAAa;QAC1B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/factory/ft-sequence-factory.js

@@ -0,0 +1,18 @@
+import { FtSequenceConstructor } from './ft-sequence-constructor.js';
+/**
+ * Factory for creating sequences.
+ * @public
+ */
+export class FtSequenceFactory {
+    static _constructor = new FtSequenceConstructor();
+    static getConstructor() {
+        return FtSequenceFactory._constructor;
+    }
+    static setConstructor(value) {
+        FtSequenceFactory._constructor = value;
+    }
+    static createSequence(index) {
+        return FtSequenceFactory._constructor.createSequence(index);
+    }
+}
+//# sourceMappingURL=ft-sequence-factory.js.map

package/dist/factory/ft-sequence-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-sequence-factory.js","sourceRoot":"","sources":["../../src/factory/ft-sequence-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAC,YAAY,GAA0B,IAAI,qBAAqB,EAAE,CAAC;IAEjF,MAAM,CAAC,cAAc;QACnB,OAAO,iBAAiB,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,KAA4B;QAChD,iBAAiB,CAAC,YAAY,GAAG,KAAK,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,KAAa;QACjC,OAAO,iBAAiB,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC"}

package/dist/factory/ft-sequence-item-constructor.js

@@ -0,0 +1,11 @@
+import { FtSequenceItem } from '../sequences/core/ft-sequence-item.js';
+/**
+ * Constructor for creating sequence item instances.
+ * @public
+ */
+export class FtSequenceItemConstructor {
+    createSequenceItem(index) {
+        return new FtSequenceItem(index);
+    }
+}
+//# sourceMappingURL=ft-sequence-item-constructor.js.map

package/dist/factory/ft-sequence-item-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-sequence-item-constructor.js","sourceRoot":"","sources":["../../src/factory/ft-sequence-item-constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IACpC,kBAAkB,CAAC,KAAa;QAC9B,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/factory/ft-sequence-item-factory.js

@@ -0,0 +1,18 @@
+import { FtSequenceItemConstructor } from './ft-sequence-item-constructor.js';
+/**
+ * Factory for creating sequence items.
+ * @public
+ */
+export class FtSequenceItemFactory {
+    static _constructor = new FtSequenceItemConstructor();
+    static getConstructor() {
+        return FtSequenceItemFactory._constructor;
+    }
+    static setConstructor(value) {
+        FtSequenceItemFactory._constructor = value;
+    }
+    static createSequenceItem(index) {
+        return FtSequenceItemFactory._constructor.createSequenceItem(index);
+    }
+}
+//# sourceMappingURL=ft-sequence-item-factory.js.map

package/dist/factory/ft-sequence-item-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-sequence-item-factory.js","sourceRoot":"","sources":["../../src/factory/ft-sequence-item-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAC,YAAY,GAA8B,IAAI,yBAAyB,EAAE,CAAC;IAEzF,MAAM,CAAC,cAAc;QACnB,OAAO,qBAAqB,CAAC,YAAY,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,KAAgC;QACpD,qBAAqB,CAAC,YAAY,GAAG,KAAK,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,KAAa;QACrC,OAAO,qBAAqB,CAAC,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC"}

package/dist/factory/ft-sequence-redirect-constructor.js

@@ -0,0 +1,13 @@
+/**
+ * Abstract base class for sequence redirect constructors.
+ * @public
+ */
+export class FtSequenceRedirectConstructor {
+    get sequenceRedirectType() {
+        return this.getSequenceRedirectType();
+    }
+    get sequenceRedirectTypeName() {
+        return this.sequenceRedirectType;
+    }
+}
+//# sourceMappingURL=ft-sequence-redirect-constructor.js.map

package/dist/factory/ft-sequence-redirect-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-sequence-redirect-constructor.js","sourceRoot":"","sources":["../../src/factory/ft-sequence-redirect-constructor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAgB,6BAA6B;IACjD,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,wBAAwB;QAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;CAIF"}