@finsys/core 4.0.0 → 4.1.0

package/dist/index.d.cts

@@ -416,16 +416,34 @@ declare enum FileFieldTableType {
  *   observedAt  — ISO wall-clock of the extraction run
  *   sourceRunId — the extraction run/job id that wrote it
  *   origin      — "extracted" (a real {value,confidence} leaf) vs "derived"
- *                 (computed / no-confidence path). A "derived" field must render
- *                 as "no confidence available", never a fabricated low score.
+ *                 (computed / no-confidence path) vs "manual" (SYS-2806, a
+ *                 lender-entered correction, committed once its edit overlay
+ *                 is approved). A "derived" field must render as "no
+ *                 confidence available", never a fabricated low score; a
+ *                 "manual" field must render as an edit indicator, not a
+ *                 confidence dot — confidence is always null for it too.
  */
+/**
+ * Canonical origin values, single source of truth (Gemini-review finding:
+ * avoids duplicating the literal strings between the type and the runtime
+ * guard) -- mirrors the IhsStatus/IHS_VALID_STATUSES pattern in
+ * ihs-status.ts.
+ */
+declare const IHS_FIELD_ORIGINS: readonly ["extracted", "derived", "manual"];
+type IhsFieldOrigin = (typeof IHS_FIELD_ORIGINS)[number];
 interface IhsFieldProvenance {
     source: string;
     confidence: number | null;
     observedAt: string;
     sourceRunId: string | null;
-    origin: 'extracted' | 'derived';
+    origin: IhsFieldOrigin;
 }
+/**
+ * Type guard: narrows an unknown value to `IhsFieldOrigin` iff it is one of
+ * the three canonical origin strings. `origin` was previously validated
+ * only by the TS union — this is the first runtime check.
+ */
+declare function isValidIhsFieldOrigin(origin: unknown): origin is IhsFieldOrigin;
 interface FileFieldTableItem {
     displayName: string;
     timePeriods: string[];
@@ -449,6 +467,22 @@ interface FileFieldTableData {
     items: FileFieldTableItem[];
     hasData: boolean;
 }
+/**
+ * One sibling-table row as finsys-api's `docInstanceStorageService` writes
+ * it (SYS-2842) -- the unbounded counterpart to a T{n}-suffixed wide-table
+ * slot. `instanceKey` is the real, collision-free per-document key;
+ * `sourceLabel` is a human label when the doc type has one (e.g. a bank
+ * name); `timePeriod` is the same descriptive value column the legacy
+ * T{n} scheme used, kept for period-labeling and legacy provenance lookup
+ * (SYS-2886 Phase 5) -- no longer the row's key. Metric fields are the
+ * category's own base (unsuffixed) column names.
+ */
+interface InstanceRow {
+    instanceKey: string;
+    sourceLabel?: string | null;
+    timePeriod?: string | null;
+    [metricKey: string]: unknown;
+}
 /**
  * Per-document File metadata attached by finsys-api `getIhsDetailsById` as the
  * `documentMetadata` sibling map (SYS-2765), keyed by the document's raw stored
@@ -530,6 +564,31 @@ declare function groupColumnsByTimePeriod(columnNames: string[]): Record<string,
 declare function groupFieldsByPattern(fields: FieldData[]): Record<string, FieldData[]>;
 declare function getGroupDisplayNames(): Record<string, string>;
 declare function buildFileFieldTables(ihsData: Record<string, unknown>, fieldProvenance?: Record<string, IhsFieldProvenance>): Record<string, FileFieldTableData>;
+/**
+ * Groups instance rows by base metric name -- the unbounded analog of
+ * groupColumnsByTimePeriod. `baseColumnNames` is the category's base
+ * (unsuffixed) field list; each returned group maps instance column
+ * label -> that metric's value on that row. Labels are disambiguated
+ * (see instanceColumnLabels) so two rows can never collide into the
+ * same key.
+ */
+declare function groupColumnsByInstance(baseColumnNames: string[], instanceRows: InstanceRow[]): Record<string, Record<string, unknown>>;
+/**
+ * Explicit base-column declaration for a category with NO catalog `file`
+ * spec -- e.g. invoice (SYS-2842 Phase 3), which was deliberately never
+ * registered in form-field-base-specs.json because getDocumentTypeGroups()
+ * is shared with resolveExtractionStatus, which assumes a category's wide-
+ * table columns exist to check "is this populated" against -- invoice has
+ * none (sibling-table only, no wideTableMirror). Registering it there would
+ * silently break resolveExtractionStatus's invoice status reporting. This
+ * override lets a category be instance-rendered without entering that
+ * shared registry at all.
+ */
+interface CategorySpec {
+    displayName: string;
+    baseColumnNames: string[];
+}
+declare function buildFileFieldTablesFromInstances(instancesByCategory?: Record<string, InstanceRow[]>, fieldProvenance?: Record<string, IhsFieldProvenance>, categoryOverrides?: Record<string, CategorySpec>): Record<string, FileFieldTableData>;
 /** IHS doc-field key → human label (the fields that become document sections). */
 declare function getDocDisplayNames(): Record<string, string>;
 /** Doc types eligible for extraction (re-extract / view-JSON). */
@@ -652,11 +711,19 @@ declare function assertDocumentType(id: string): string;
  * Lender rejection is not represented by a distinct status: when a lender
  * rejects an application, finsys-api transitions the record back to
  * `APPLICATION_FINALIZED` from `LENDER_EVALUATION`.
+ *
+ * `EditingApplication` (SYS-2806) is a lender-scoped detour off
+ * `LenderEvaluation` for manually editing extracted field values — not
+ * reachable from `ApplicationFinalized`. A lender toggles into it and back
+ * out to `LenderEvaluation`; it never appears on a record no lender has
+ * claimed. See finsys-api's `updateIhsStatusByLender` for the transition
+ * guard.
  */
 declare enum IhsStatus {
     CreatingApplication = "CREATING_APPLICATION",
     ApplicationFinalized = "APPLICATION_FINALIZED",
     LenderEvaluation = "LENDER_EVALUATION",
+    EditingApplication = "EDITING_APPLICATION",
     Approved = "APPROVED",
     LouDelivered = "LOU_DELIVERED",
     AwaitingDisbursement = "AWAITING_DISBURSEMENT",
@@ -1392,4 +1459,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 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 ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceValue, 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, 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, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, 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 ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, 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 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 };

package/dist/index.d.ts

@@ -416,16 +416,34 @@ declare enum FileFieldTableType {
  *   observedAt  — ISO wall-clock of the extraction run
  *   sourceRunId — the extraction run/job id that wrote it
  *   origin      — "extracted" (a real {value,confidence} leaf) vs "derived"
- *                 (computed / no-confidence path). A "derived" field must render
- *                 as "no confidence available", never a fabricated low score.
+ *                 (computed / no-confidence path) vs "manual" (SYS-2806, a
+ *                 lender-entered correction, committed once its edit overlay
+ *                 is approved). A "derived" field must render as "no
+ *                 confidence available", never a fabricated low score; a
+ *                 "manual" field must render as an edit indicator, not a
+ *                 confidence dot — confidence is always null for it too.
  */
+/**
+ * Canonical origin values, single source of truth (Gemini-review finding:
+ * avoids duplicating the literal strings between the type and the runtime
+ * guard) -- mirrors the IhsStatus/IHS_VALID_STATUSES pattern in
+ * ihs-status.ts.
+ */
+declare const IHS_FIELD_ORIGINS: readonly ["extracted", "derived", "manual"];
+type IhsFieldOrigin = (typeof IHS_FIELD_ORIGINS)[number];
 interface IhsFieldProvenance {
     source: string;
     confidence: number | null;
     observedAt: string;
     sourceRunId: string | null;
-    origin: 'extracted' | 'derived';
+    origin: IhsFieldOrigin;
 }
+/**
+ * Type guard: narrows an unknown value to `IhsFieldOrigin` iff it is one of
+ * the three canonical origin strings. `origin` was previously validated
+ * only by the TS union — this is the first runtime check.
+ */
+declare function isValidIhsFieldOrigin(origin: unknown): origin is IhsFieldOrigin;
 interface FileFieldTableItem {
     displayName: string;
     timePeriods: string[];
@@ -449,6 +467,22 @@ interface FileFieldTableData {
     items: FileFieldTableItem[];
     hasData: boolean;
 }
+/**
+ * One sibling-table row as finsys-api's `docInstanceStorageService` writes
+ * it (SYS-2842) -- the unbounded counterpart to a T{n}-suffixed wide-table
+ * slot. `instanceKey` is the real, collision-free per-document key;
+ * `sourceLabel` is a human label when the doc type has one (e.g. a bank
+ * name); `timePeriod` is the same descriptive value column the legacy
+ * T{n} scheme used, kept for period-labeling and legacy provenance lookup
+ * (SYS-2886 Phase 5) -- no longer the row's key. Metric fields are the
+ * category's own base (unsuffixed) column names.
+ */
+interface InstanceRow {
+    instanceKey: string;
+    sourceLabel?: string | null;
+    timePeriod?: string | null;
+    [metricKey: string]: unknown;
+}
 /**
  * Per-document File metadata attached by finsys-api `getIhsDetailsById` as the
  * `documentMetadata` sibling map (SYS-2765), keyed by the document's raw stored
@@ -530,6 +564,31 @@ declare function groupColumnsByTimePeriod(columnNames: string[]): Record<string,
 declare function groupFieldsByPattern(fields: FieldData[]): Record<string, FieldData[]>;
 declare function getGroupDisplayNames(): Record<string, string>;
 declare function buildFileFieldTables(ihsData: Record<string, unknown>, fieldProvenance?: Record<string, IhsFieldProvenance>): Record<string, FileFieldTableData>;
+/**
+ * Groups instance rows by base metric name -- the unbounded analog of
+ * groupColumnsByTimePeriod. `baseColumnNames` is the category's base
+ * (unsuffixed) field list; each returned group maps instance column
+ * label -> that metric's value on that row. Labels are disambiguated
+ * (see instanceColumnLabels) so two rows can never collide into the
+ * same key.
+ */
+declare function groupColumnsByInstance(baseColumnNames: string[], instanceRows: InstanceRow[]): Record<string, Record<string, unknown>>;
+/**
+ * Explicit base-column declaration for a category with NO catalog `file`
+ * spec -- e.g. invoice (SYS-2842 Phase 3), which was deliberately never
+ * registered in form-field-base-specs.json because getDocumentTypeGroups()
+ * is shared with resolveExtractionStatus, which assumes a category's wide-
+ * table columns exist to check "is this populated" against -- invoice has
+ * none (sibling-table only, no wideTableMirror). Registering it there would
+ * silently break resolveExtractionStatus's invoice status reporting. This
+ * override lets a category be instance-rendered without entering that
+ * shared registry at all.
+ */
+interface CategorySpec {
+    displayName: string;
+    baseColumnNames: string[];
+}
+declare function buildFileFieldTablesFromInstances(instancesByCategory?: Record<string, InstanceRow[]>, fieldProvenance?: Record<string, IhsFieldProvenance>, categoryOverrides?: Record<string, CategorySpec>): Record<string, FileFieldTableData>;
 /** IHS doc-field key → human label (the fields that become document sections). */
 declare function getDocDisplayNames(): Record<string, string>;
 /** Doc types eligible for extraction (re-extract / view-JSON). */
@@ -652,11 +711,19 @@ declare function assertDocumentType(id: string): string;
  * Lender rejection is not represented by a distinct status: when a lender
  * rejects an application, finsys-api transitions the record back to
  * `APPLICATION_FINALIZED` from `LENDER_EVALUATION`.
+ *
+ * `EditingApplication` (SYS-2806) is a lender-scoped detour off
+ * `LenderEvaluation` for manually editing extracted field values — not
+ * reachable from `ApplicationFinalized`. A lender toggles into it and back
+ * out to `LenderEvaluation`; it never appears on a record no lender has
+ * claimed. See finsys-api's `updateIhsStatusByLender` for the transition
+ * guard.
  */
 declare enum IhsStatus {
     CreatingApplication = "CREATING_APPLICATION",
     ApplicationFinalized = "APPLICATION_FINALIZED",
     LenderEvaluation = "LENDER_EVALUATION",
+    EditingApplication = "EDITING_APPLICATION",
     Approved = "APPROVED",
     LouDelivered = "LOU_DELIVERED",
     AwaitingDisbursement = "AWAITING_DISBURSEMENT",
@@ -1392,4 +1459,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 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 ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceValue, 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, 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, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, 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 ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, 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 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 };

package/dist/index.js

@@ -9200,6 +9200,10 @@ var FileFieldTableType = /* @__PURE__ */ ((FileFieldTableType2) => {
   FileFieldTableType2["KEY_VALUE"] = "keyValue";
   return FileFieldTableType2;
 })(FileFieldTableType || {});
+var IHS_FIELD_ORIGINS = ["extracted", "derived", "manual"];
+function isValidIhsFieldOrigin(origin) {
+  return typeof origin === "string" && IHS_FIELD_ORIGINS.includes(origin);
+}
 
 // src/document-types.ts
 var cached = null;
@@ -9597,6 +9601,124 @@ function buildFileFieldTables(ihsData, fieldProvenance) {
   }
   return tables;
 }
+function instanceColumnLabel(row) {
+  const period = row.timePeriod || row.instanceKey;
+  return row.sourceLabel ? `${period} \xB7 ${row.sourceLabel}` : period;
+}
+function instanceColumnLabels(rows) {
+  const seenCounts = /* @__PURE__ */ new Map();
+  return rows.map((row) => {
+    const raw = instanceColumnLabel(row);
+    const occurrence = (seenCounts.get(raw) ?? 0) + 1;
+    seenCounts.set(raw, occurrence);
+    return occurrence === 1 ? raw : `${raw} (${occurrence})`;
+  });
+}
+function groupColumnsByInstance(baseColumnNames, instanceRows) {
+  const groups = {};
+  for (const baseName of baseColumnNames) {
+    groups[baseName] = {};
+  }
+  if (!instanceRows?.length) return groups;
+  const labels = instanceColumnLabels(instanceRows);
+  instanceRows.forEach((row, i) => {
+    const label = labels[i];
+    for (const baseName of baseColumnNames) {
+      if (Object.prototype.hasOwnProperty.call(row, baseName)) {
+        groups[baseName][label] = row[baseName];
+      }
+    }
+  });
+  return groups;
+}
+function buildInstanceTable(groupName, baseNames, groupDisplayName, instanceRows, fieldProvenance) {
+  const columnGroups = groupColumnsByInstance(baseNames, instanceRows);
+  const instanceLabels = instanceColumnLabels(instanceRows);
+  const items = [];
+  for (const [baseName, labelMap] of Object.entries(columnGroups)) {
+    const hasAny = Object.values(labelMap).some((v) => v !== null && v !== void 0 && v !== "");
+    if (!hasAny) continue;
+    const numeric = isNumericField(baseName);
+    const data = {};
+    const formattedData = {};
+    const confidence = {};
+    const provenance = {};
+    for (const [i, row] of instanceRows.entries()) {
+      const label = instanceLabels[i];
+      const value = labelMap[label] ?? null;
+      data[label] = value;
+      formattedData[label] = formatValue(value, numeric);
+      const legacyKey = row.timePeriod ? `${baseName}${row.timePeriod}` : void 0;
+      const prov = legacyKey ? fieldProvenance?.[legacyKey] : void 0;
+      if (prov) {
+        provenance[label] = prov;
+        if (prov.origin === "extracted" && typeof prov.confidence === "number" && !Number.isNaN(prov.confidence)) {
+          confidence[label] = prov.confidence;
+        }
+      }
+    }
+    items.push({
+      displayName: getDisplayName(baseName),
+      timePeriods: instanceLabels,
+      data,
+      formattedData,
+      type: "timeSeries" /* TIME_SERIES */,
+      isNumeric: numeric,
+      ...Object.keys(confidence).length ? { confidence } : {},
+      ...Object.keys(provenance).length ? { provenance } : {}
+    });
+  }
+  const hasData = items.some(
+    (item) => Object.values(item.data).some((v) => v !== null && v !== void 0 && v !== "")
+  );
+  if (!items.length || !hasData) return null;
+  return {
+    name: groupName,
+    displayName: groupDisplayName,
+    type: "timeSeries" /* TIME_SERIES */,
+    items,
+    hasData
+  };
+}
+function buildFileFieldTablesFromInstances(instancesByCategory = {}, fieldProvenance, categoryOverrides) {
+  const specs = getBaseFieldSpecs();
+  const fileFields = specs.filter((f) => f.type === "file" && f.ihs_column_names?.length);
+  const grouped = groupFieldsByPattern(fileFields);
+  const tables = {};
+  for (const [groupName, fields] of Object.entries(grouped)) {
+    const instanceRows = instancesByCategory[groupName];
+    if (!instanceRows?.length) continue;
+    const baseNames = /* @__PURE__ */ new Set();
+    for (const field of fields) {
+      for (const col of field.ihs_column_names ?? []) {
+        baseNames.add(col.replace(TIME_PERIOD_REGEX, ""));
+      }
+    }
+    const groupDisplayName = getGroupDisplayNames()[groupName] || fields[0]?.displayName || getDisplayName(groupName);
+    const table = buildInstanceTable(
+      groupName,
+      [...baseNames],
+      groupDisplayName,
+      instanceRows,
+      fieldProvenance
+    );
+    if (table) tables[groupName] = table;
+  }
+  for (const [groupName, spec] of Object.entries(categoryOverrides ?? {})) {
+    if (Object.prototype.hasOwnProperty.call(tables, groupName)) continue;
+    const instanceRows = instancesByCategory[groupName];
+    if (!instanceRows?.length) continue;
+    const table = buildInstanceTable(
+      groupName,
+      spec.baseColumnNames,
+      spec.displayName,
+      instanceRows,
+      fieldProvenance
+    );
+    if (table) tables[groupName] = table;
+  }
+  return tables;
+}
 var DOC_DISPLAY_NAMES = {
   bankStatements: "Bank Statements",
   financialStatements: "Financial Statements",
@@ -9849,6 +9971,7 @@ var IhsStatus = /* @__PURE__ */ ((IhsStatus2) => {
   IhsStatus2["CreatingApplication"] = "CREATING_APPLICATION";
   IhsStatus2["ApplicationFinalized"] = "APPLICATION_FINALIZED";
   IhsStatus2["LenderEvaluation"] = "LENDER_EVALUATION";
+  IhsStatus2["EditingApplication"] = "EDITING_APPLICATION";
   IhsStatus2["Approved"] = "APPROVED";
   IhsStatus2["LouDelivered"] = "LOU_DELIVERED";
   IhsStatus2["AwaitingDisbursement"] = "AWAITING_DISBURSEMENT";
@@ -9862,6 +9985,7 @@ var IHS_VALID_STATUSES = [
   "CREATING_APPLICATION" /* CreatingApplication */,
   "APPLICATION_FINALIZED" /* ApplicationFinalized */,
   "LENDER_EVALUATION" /* LenderEvaluation */,
+  "EDITING_APPLICATION" /* EditingApplication */,
   "APPROVED" /* Approved */,
   "LOU_DELIVERED" /* LouDelivered */,
   "AWAITING_DISBURSEMENT" /* AwaitingDisbursement */,
@@ -10627,6 +10751,7 @@ export {
   FormFieldValidator,
   FormSpec,
   IHS_FAILURE_STATUSES,
+  IHS_FIELD_ORIGINS,
   IHS_TERMINAL_STATUSES,
   IHS_VALID_STATUSES,
   IhsStatus,
@@ -10639,6 +10764,7 @@ export {
   assertDocumentType,
   buildDocumentRows,
   buildFileFieldTables,
+  buildFileFieldTablesFromInstances,
   categoryFieldsOf,
   categoryForField,
   categorySchemaOf,
@@ -10665,6 +10791,7 @@ export {
   getReuploadableDocTypes,
   getStepDefaultValues,
   getStepSchema,
+  groupColumnsByInstance,
   groupColumnsByTimePeriod,
   groupDetailsByCategory,
   groupFieldsByCategory,
@@ -10673,6 +10800,7 @@ export {
   isDocumentType,
   isFailureIhsStatus,
   isTerminalIhsStatus,
+  isValidIhsFieldOrigin,
   isValidIhsStatus,
   parseFileField,
   processIhsDetails,