@finsys/core 4.4.0 → 4.6.0

package/dist/index.d.cts

@@ -974,6 +974,11 @@ type CanonicalFieldValues = Partial<Record<CanonicalFieldName, CanonicalFieldVal
  * MUST be stable across re-extractions so the storage layer can
  * replace-in-place rather than accumulating duplicates. Conventions:
  *   - For periodic data: encode the period (`'2026-Q1'`, `'2026-03'`)
+   * NOTE (SYS-3002): that is the multi-INSTANCE axis — one snapshot per
+   * instance. Do NOT encode a within-document period into the instance
+   * key; period-scoped values belong in `periods` (contractual 1-based
+   * positions). The two axes compose: instance = which document/snapshot,
+   * period = which declared position within it.
  *   - For per-line data: encode the line id (`'msisdn-60123456789'`,
  *     `'card-last4-1234'`)
  *   - For natively single-instance adapters: use the empty string `''`
@@ -1014,6 +1019,62 @@ interface AdapterExtraction {
      * matching IhsFieldProvenance.origin semantics).
      */
     readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
+    /**
+     * SYS-3002: per-period value sets for adapters whose category
+     * declares a period axis (see `AdapterManifest.periods`). Each entry
+     * carries the values for ONE contractual position; `position` is
+     * 1-based — period1 is the first declared period, there is no
+     * period0.
+     *
+     * An instance carrying `periods` uses them for period-scoped fields,
+     * while the instance-level `values` above remains the home for
+     * period-less (singleton / instance-scoped) fields. Instances of
+     * single-period adapters (no `periods` on the manifest) omit this
+     * entirely and keep everything in `values` — the existing flat path
+     * is unchanged and remains the single-period path.
+     *
+     * Periods are scoped WITHIN this instance: this instance's period1
+     * and another instance's period1 are unrelated data points.
+     */
+    readonly periods?: ReadonlyArray<PeriodValues>;
+}
+/**
+ * SYS-3002: one period's value set within an AdapterExtraction
+ * instance. Identity is `position` — the 1-based index into the
+ * manifest's declared `periods` array — never the dates: declared
+ * positions may overlap, nest, vary in length, or be staggered (e.g.
+ * period1 = an annual table, periods 2–5 = the four quarters
+ * overlapping it), so dates cannot identify a period and recency
+ * ordering across positions is meaningless.
+ */
+interface PeriodValues {
+    /**
+     * 1-based contractual position into the manifest's `periods`
+     * declaration. MUST be >= 1 — period1 is the first declared period;
+     * there is no period0. This IS the period's identity.
+     */
+    readonly position: number;
+    /**
+     * ISO-8601 date the period starts — display/temporal metadata only,
+     * NEVER identity.
+     */
+    readonly start?: string;
+    /**
+     * ISO-8601 date the period ends — display/temporal metadata only,
+     * NEVER identity.
+     */
+    readonly end?: string;
+    /**
+     * The canonical field values for this period, same shape as the
+     * instance-level `values`.
+     */
+    readonly values: CanonicalFieldValues;
+    /**
+     * Optional per-field extraction confidence for this period's values,
+     * same semantics as the instance-level `confidence` (0..1 keyed by
+     * canonical field name; `null` marks a derived/computed value).
+     */
+    readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
 }
 /**
  * Allowed value shapes for canonical fields. Per-field type narrowing
@@ -1036,8 +1097,8 @@ type CanonicalFieldValue = number | string | boolean | null;
  * stay assignment-compatible. A telco adapter that needs an MSISDN
  * declares it once at the interface level:
  *
- *     interface CelcomExt { msisdn: string }
- *     const celcomTelco: SourceAdapter<CelcomExt> = {
+ *     interface TelcoPartnerExt { msisdn: string }
+ *     const telcoAdapter: SourceAdapter<TelcoPartnerExt> = {
  *       async fetch(identity) {
  *         identity.msisdn  // string  (typed via E)
  *         identity.ic      // string  (core)
@@ -1051,7 +1112,7 @@ type CanonicalFieldValue = number | string | boolean | null;
 interface SourceAdapter<E extends Record<string, unknown> = {}> {
     /**
      * Globally unique id for this adapter instance. By convention:
-     * `<vendor>-<category-short>-v<n>` — e.g. `celcom-telco-v1`. Vendor
+     * `<vendor>-<category-short>-v<n>` — e.g. `example-telco-v1`. Vendor
      * names appear here in deployment-specific code, NEVER in
      * finsys-core. The id is what the registry uses to dedupe + what
      * provenance records pin to.
@@ -1188,10 +1249,10 @@ interface SourceAdapter<E extends Record<string, unknown> = {}> {
  *
  * Narrowing example (the ergonomics win this type is designed to deliver):
  *
- *     interface CelcomExt { msisdn: string; accountRef: string }
+ *     interface TelcoPartnerExt { msisdn: string; accountRef: string }
  *
  *     // declare adapter with the extension shape baked in:
- *     const celcom: SourceAdapter<CelcomExt> = {
+ *     const telcoAdapter: SourceAdapter<TelcoPartnerExt> = {
  *       async fetch(identity) {
  *         identity.ic        // string
  *         identity.msisdn    // string  (NOT unknown — narrowed by E)
@@ -1373,7 +1434,7 @@ interface AdapterManifest {
     readonly manifestVersion: 1;
     /**
      * Globally unique adapter id. Conventional pattern:
-     * `<vendor>-<category-short>-v<n>` (e.g. `celcom-telco-v1`). The id is
+     * `<vendor>-<category-short>-v<n>` (e.g. `example-telco-v1`). The id is
      * what `SourceAdapter#id` returns + what provenance records pin to.
      */
     readonly id: string;
@@ -1501,6 +1562,41 @@ interface AdapterManifest {
      * not producing the field.
      */
     readonly fieldAuthorizations?: Readonly<Partial<Record<CanonicalFieldName, FieldAuthorization>>>;
+    /**
+     * SYS-3002: ordered period declarations — the contract for the
+     * period axis of this adapter's category.
+     *
+     * The period axis is ordered BY CONTRACT: `periodN` is a POSITIONAL
+     * identifier into this array. Numbering is 1-BASED — period1 is the
+     * FIRST declared period (array index 0); there is no period0.
+     * Position is the period's IDENTITY: two extractions' period1 values
+     * are comparable because they occupy the same contractual slot, not
+     * because their dates match.
+     *
+     * Declared positions may overlap, nest, vary in length, or be
+     * staggered — e.g. period1 = an annual table, periods 2–5 = the four
+     * quarters overlapping it. The declaration makes no statement about
+     * dates; each extraction-time period carries its own dated metadata
+     * (see `PeriodValues.start`/`end`) for display and temporal
+     * reasoning, never for identity. Periods are scoped WITHIN one
+     * instance: one document's period1 and another document's period1
+     * are unrelated data points.
+     *
+     * ABSENT means the single-period convention: the adapter's output
+     * has exactly one implicit period, and instance-level `values` is
+     * that period's value set. Single-period categories (bank
+     * statements, EPF, payslips) never need to declare. Non-empty when
+     * present — declaring zero periods would contradict the implicit
+     * single-period convention, so the schema requires at least one
+     * entry.
+     *
+     * The motivating consumer is financial statements — one document
+     * carries period1 (its current fiscal year) plus period2 (its prior
+     * comparative year) — but any implementation type may declare
+     * periods: the axis is a property of the contract, not of how the
+     * adapter is implemented.
+     */
+    readonly periods?: ReadonlyArray<PeriodDeclaration>;
     /**
      * Optional free-form notes — useful for partner-side documentation
      * (where to find the adapter's source, who owns it, what version of
@@ -1508,6 +1604,22 @@ interface AdapterManifest {
      */
     readonly notes?: string;
 }
+/**
+ * SYS-3002: one declared period on the adapter's period axis. See
+ * {@link AdapterManifest.periods} for the positional (1-based) identity
+ * semantics — the entry's position in the `periods` array IS the
+ * period's identity; the entry itself only labels the role.
+ */
+interface PeriodDeclaration {
+    /**
+     * Human role label for the position, e.g. "Current fiscal year",
+     * "Prior comparative year". Rendered in operator UIs; carries no
+     * identity semantics.
+     */
+    readonly name: string;
+    /** Optional longer description of what this position holds. */
+    readonly description?: string;
+}
 /**
  * SYS-2503: one field's authorization gate. See
  * {@link AdapterManifest.fieldAuthorizations} for semantics.
@@ -1628,4 +1740,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };

package/dist/index.d.ts

@@ -974,6 +974,11 @@ type CanonicalFieldValues = Partial<Record<CanonicalFieldName, CanonicalFieldVal
  * MUST be stable across re-extractions so the storage layer can
  * replace-in-place rather than accumulating duplicates. Conventions:
  *   - For periodic data: encode the period (`'2026-Q1'`, `'2026-03'`)
+   * NOTE (SYS-3002): that is the multi-INSTANCE axis — one snapshot per
+   * instance. Do NOT encode a within-document period into the instance
+   * key; period-scoped values belong in `periods` (contractual 1-based
+   * positions). The two axes compose: instance = which document/snapshot,
+   * period = which declared position within it.
  *   - For per-line data: encode the line id (`'msisdn-60123456789'`,
  *     `'card-last4-1234'`)
  *   - For natively single-instance adapters: use the empty string `''`
@@ -1014,6 +1019,62 @@ interface AdapterExtraction {
      * matching IhsFieldProvenance.origin semantics).
      */
     readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
+    /**
+     * SYS-3002: per-period value sets for adapters whose category
+     * declares a period axis (see `AdapterManifest.periods`). Each entry
+     * carries the values for ONE contractual position; `position` is
+     * 1-based — period1 is the first declared period, there is no
+     * period0.
+     *
+     * An instance carrying `periods` uses them for period-scoped fields,
+     * while the instance-level `values` above remains the home for
+     * period-less (singleton / instance-scoped) fields. Instances of
+     * single-period adapters (no `periods` on the manifest) omit this
+     * entirely and keep everything in `values` — the existing flat path
+     * is unchanged and remains the single-period path.
+     *
+     * Periods are scoped WITHIN this instance: this instance's period1
+     * and another instance's period1 are unrelated data points.
+     */
+    readonly periods?: ReadonlyArray<PeriodValues>;
+}
+/**
+ * SYS-3002: one period's value set within an AdapterExtraction
+ * instance. Identity is `position` — the 1-based index into the
+ * manifest's declared `periods` array — never the dates: declared
+ * positions may overlap, nest, vary in length, or be staggered (e.g.
+ * period1 = an annual table, periods 2–5 = the four quarters
+ * overlapping it), so dates cannot identify a period and recency
+ * ordering across positions is meaningless.
+ */
+interface PeriodValues {
+    /**
+     * 1-based contractual position into the manifest's `periods`
+     * declaration. MUST be >= 1 — period1 is the first declared period;
+     * there is no period0. This IS the period's identity.
+     */
+    readonly position: number;
+    /**
+     * ISO-8601 date the period starts — display/temporal metadata only,
+     * NEVER identity.
+     */
+    readonly start?: string;
+    /**
+     * ISO-8601 date the period ends — display/temporal metadata only,
+     * NEVER identity.
+     */
+    readonly end?: string;
+    /**
+     * The canonical field values for this period, same shape as the
+     * instance-level `values`.
+     */
+    readonly values: CanonicalFieldValues;
+    /**
+     * Optional per-field extraction confidence for this period's values,
+     * same semantics as the instance-level `confidence` (0..1 keyed by
+     * canonical field name; `null` marks a derived/computed value).
+     */
+    readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
 }
 /**
  * Allowed value shapes for canonical fields. Per-field type narrowing
@@ -1036,8 +1097,8 @@ type CanonicalFieldValue = number | string | boolean | null;
  * stay assignment-compatible. A telco adapter that needs an MSISDN
  * declares it once at the interface level:
  *
- *     interface CelcomExt { msisdn: string }
- *     const celcomTelco: SourceAdapter<CelcomExt> = {
+ *     interface TelcoPartnerExt { msisdn: string }
+ *     const telcoAdapter: SourceAdapter<TelcoPartnerExt> = {
  *       async fetch(identity) {
  *         identity.msisdn  // string  (typed via E)
  *         identity.ic      // string  (core)
@@ -1051,7 +1112,7 @@ type CanonicalFieldValue = number | string | boolean | null;
 interface SourceAdapter<E extends Record<string, unknown> = {}> {
     /**
      * Globally unique id for this adapter instance. By convention:
-     * `<vendor>-<category-short>-v<n>` — e.g. `celcom-telco-v1`. Vendor
+     * `<vendor>-<category-short>-v<n>` — e.g. `example-telco-v1`. Vendor
      * names appear here in deployment-specific code, NEVER in
      * finsys-core. The id is what the registry uses to dedupe + what
      * provenance records pin to.
@@ -1188,10 +1249,10 @@ interface SourceAdapter<E extends Record<string, unknown> = {}> {
  *
  * Narrowing example (the ergonomics win this type is designed to deliver):
  *
- *     interface CelcomExt { msisdn: string; accountRef: string }
+ *     interface TelcoPartnerExt { msisdn: string; accountRef: string }
  *
  *     // declare adapter with the extension shape baked in:
- *     const celcom: SourceAdapter<CelcomExt> = {
+ *     const telcoAdapter: SourceAdapter<TelcoPartnerExt> = {
  *       async fetch(identity) {
  *         identity.ic        // string
  *         identity.msisdn    // string  (NOT unknown — narrowed by E)
@@ -1373,7 +1434,7 @@ interface AdapterManifest {
     readonly manifestVersion: 1;
     /**
      * Globally unique adapter id. Conventional pattern:
-     * `<vendor>-<category-short>-v<n>` (e.g. `celcom-telco-v1`). The id is
+     * `<vendor>-<category-short>-v<n>` (e.g. `example-telco-v1`). The id is
      * what `SourceAdapter#id` returns + what provenance records pin to.
      */
     readonly id: string;
@@ -1501,6 +1562,41 @@ interface AdapterManifest {
      * not producing the field.
      */
     readonly fieldAuthorizations?: Readonly<Partial<Record<CanonicalFieldName, FieldAuthorization>>>;
+    /**
+     * SYS-3002: ordered period declarations — the contract for the
+     * period axis of this adapter's category.
+     *
+     * The period axis is ordered BY CONTRACT: `periodN` is a POSITIONAL
+     * identifier into this array. Numbering is 1-BASED — period1 is the
+     * FIRST declared period (array index 0); there is no period0.
+     * Position is the period's IDENTITY: two extractions' period1 values
+     * are comparable because they occupy the same contractual slot, not
+     * because their dates match.
+     *
+     * Declared positions may overlap, nest, vary in length, or be
+     * staggered — e.g. period1 = an annual table, periods 2–5 = the four
+     * quarters overlapping it. The declaration makes no statement about
+     * dates; each extraction-time period carries its own dated metadata
+     * (see `PeriodValues.start`/`end`) for display and temporal
+     * reasoning, never for identity. Periods are scoped WITHIN one
+     * instance: one document's period1 and another document's period1
+     * are unrelated data points.
+     *
+     * ABSENT means the single-period convention: the adapter's output
+     * has exactly one implicit period, and instance-level `values` is
+     * that period's value set. Single-period categories (bank
+     * statements, EPF, payslips) never need to declare. Non-empty when
+     * present — declaring zero periods would contradict the implicit
+     * single-period convention, so the schema requires at least one
+     * entry.
+     *
+     * The motivating consumer is financial statements — one document
+     * carries period1 (its current fiscal year) plus period2 (its prior
+     * comparative year) — but any implementation type may declare
+     * periods: the axis is a property of the contract, not of how the
+     * adapter is implemented.
+     */
+    readonly periods?: ReadonlyArray<PeriodDeclaration>;
     /**
      * Optional free-form notes — useful for partner-side documentation
      * (where to find the adapter's source, who owns it, what version of
@@ -1508,6 +1604,22 @@ interface AdapterManifest {
      */
     readonly notes?: string;
 }
+/**
+ * SYS-3002: one declared period on the adapter's period axis. See
+ * {@link AdapterManifest.periods} for the positional (1-based) identity
+ * semantics — the entry's position in the `periods` array IS the
+ * period's identity; the entry itself only labels the role.
+ */
+interface PeriodDeclaration {
+    /**
+     * Human role label for the position, e.g. "Current fiscal year",
+     * "Prior comparative year". Rendered in operator UIs; carries no
+     * identity semantics.
+     */
+    readonly name: string;
+    /** Optional longer description of what this position holds. */
+    readonly description?: string;
+}
 /**
  * SYS-2503: one field's authorization gate. See
  * {@link AdapterManifest.fieldAuthorizations} for semantics.
@@ -1628,4 +1740,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };