@cristianmpx/react-import-sheet-headless 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,403 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type RegistryLevel = 'cell' | 'row' | 'table';
+interface RegistryEntry<T extends (...args: unknown[]) => unknown> {
+    readonly fn: T;
+    readonly type: RegistryLevel;
+}
+
+declare class Registry<T extends (...args: unknown[]) => unknown> {
+    private entries;
+    register(name: string, fn: T, options: {
+        type: RegistryLevel;
+    }): void;
+    get(name: string): RegistryEntry<T> | undefined;
+    getByType(type: RegistryLevel): Array<{
+        name: string;
+        entry: RegistryEntry<T>;
+    }>;
+    has(name: string): boolean;
+    clear(): void;
+}
+
+type SheetErrorLevel = 'error' | 'warning' | 'fatal' | 'info';
+interface SheetError {
+    readonly code: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+    readonly level?: SheetErrorLevel;
+    readonly message?: string;
+    readonly rowIndex?: number;
+    readonly cellKey?: string;
+}
+
+type ParserEngine = 'xlsx' | 'csv' | 'auto';
+
+type RawSheetCellValue = string | number | boolean | Date | null;
+interface RawSheetCell {
+    readonly key: string;
+    readonly value: RawSheetCellValue;
+}
+interface RawSheetRow {
+    readonly index: number;
+    readonly cells: readonly RawSheetCell[];
+}
+interface BaseSheet<TRow> {
+    readonly name: string;
+    readonly filesize: number;
+    readonly documentHash: string;
+    readonly rowsCount?: number;
+    readonly headersCount?: number;
+    readonly headers: readonly string[];
+    readonly rows: readonly TRow[];
+}
+interface RawParseResult {
+    readonly sheets: Readonly<Record<string, RawSheet>>;
+    readonly parserMeta?: Readonly<{
+        encoding?: string;
+        delimiter?: string;
+    }>;
+}
+type RawSheet = BaseSheet<RawSheetRow>;
+
+type FieldValueType = 'number' | 'string' | 'bool' | 'date';
+type FieldInputType = 'input' | 'checkbox';
+type ValidatorOrWithParams = string | {
+    readonly name: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+};
+interface SheetLayoutField {
+    readonly name: string;
+    readonly description?: string;
+    readonly example?: string;
+    readonly validators?: readonly ValidatorOrWithParams[];
+    readonly sanitizers?: readonly ValidatorOrWithParams[];
+    readonly transformations?: readonly ValidatorOrWithParams[];
+    readonly valueType?: FieldValueType;
+    readonly inputType?: FieldInputType;
+    readonly required?: boolean;
+}
+interface SheetLayout {
+    readonly name: string;
+    readonly version: string | number;
+    readonly description?: string;
+    readonly sheetValidators?: readonly ValidatorOrWithParams[];
+    readonly sheetSanitizers?: readonly ValidatorOrWithParams[];
+    readonly rowValidators?: readonly ValidatorOrWithParams[];
+    readonly rowSanitizers?: readonly ValidatorOrWithParams[];
+    readonly rowTransformations?: readonly ValidatorOrWithParams[];
+    readonly sheetTransformations?: readonly ValidatorOrWithParams[];
+    readonly fields: Readonly<Record<string, SheetLayoutField>>;
+}
+interface SheetLayoutRef {
+    readonly name: string;
+    readonly version: string | number;
+}
+
+interface ValidatedCell {
+    readonly key: string;
+    readonly value: unknown;
+    readonly errors: readonly SheetError[];
+}
+interface ValidatedRow {
+    readonly index: number;
+    readonly errors: readonly SheetError[];
+    readonly cells: readonly ValidatedCell[];
+}
+interface Sheet extends BaseSheet<ValidatedRow> {
+    readonly sheetLayout: SheetLayoutRef;
+    readonly mimetype?: string;
+    readonly extension?: string;
+    readonly errors: readonly SheetError[];
+}
+
+interface PipelineMetricsTimings {
+    readonly parse: number;
+    readonly sanitize: number;
+    readonly validate: number;
+    readonly transform: number;
+}
+interface PipelineMetricsPercentages {
+    readonly parse: number;
+    readonly sanitize: number;
+    readonly validate: number;
+    readonly transform: number;
+    readonly overhead?: number;
+}
+interface PipelineMetrics {
+    readonly timings: PipelineMetricsTimings;
+    readonly percentages?: PipelineMetricsPercentages;
+    readonly totalMs: number;
+    readonly isSlow: boolean;
+    readonly parseTime: string;
+    readonly sanitizeTime: string;
+    readonly validateTime: string;
+    readonly transformTime: string;
+    readonly totalTime: string;
+    readonly efficiency: string;
+    readonly rowCount: number;
+    readonly overheadMs?: number;
+}
+
+interface ChangeLogEntryCellEdit {
+    readonly type: 'cell_edit';
+    readonly rowIndex: number;
+    readonly cellKey: string;
+    readonly value: unknown;
+    readonly previousValue?: unknown;
+    readonly timestamp: number;
+}
+interface ChangeLogEntryRowRemove {
+    readonly type: 'row_remove';
+    readonly rowIndex: number;
+    readonly timestamp: number;
+}
+type ChangeLogEntry = ChangeLogEntryCellEdit | ChangeLogEntryRowRemove;
+declare function formatChangeLogAsText(entries: readonly ChangeLogEntry[]): string;
+
+interface EditCellParams {
+    readonly rowIndex: number;
+    readonly cellKey: string;
+    readonly value: unknown;
+}
+
+interface PaginatedResult<TRow> {
+    readonly page: number;
+    readonly pageSize: number;
+    readonly totalCount: number;
+    readonly totalPages: number;
+    readonly rows: readonly TRow[];
+}
+
+interface ConvertedSheetCell {
+    readonly key: string;
+    readonly value: RawSheetCellValue;
+}
+interface ConvertedSheetRow {
+    readonly index: number;
+    readonly cells: readonly ConvertedSheetCell[];
+}
+type ConvertedSheet = BaseSheet<ConvertedSheetRow>;
+
+interface SanitizedSheetCell {
+    readonly key: string;
+    readonly value: RawSheetCellValue;
+}
+interface SanitizedSheetRow {
+    readonly index: number;
+    readonly cells: readonly SanitizedSheetCell[];
+}
+type SanitizedSheet = BaseSheet<SanitizedSheetRow>;
+
+type ImporterStatus = 'idle' | 'loading' | 'parsing' | 'validating' | 'transforming' | 'success' | 'error' | 'cancelled';
+interface ConvertResultData {
+    readonly headersFound: readonly string[];
+    readonly mismatches: readonly {
+        expected: string;
+        found: string | null;
+        message?: string;
+    }[];
+    readonly columnOrder: readonly string[];
+    readonly headerToFieldMap: Readonly<Record<string, string>>;
+}
+interface ImporterState {
+    readonly file: File | null;
+    readonly rawData: RawSheet | null;
+    readonly documentHash: string | null;
+    readonly status: ImporterStatus;
+    readonly result: Sheet | null;
+    readonly convertedSheet: ConvertedSheet | null;
+    readonly sanitizedSheet: SanitizedSheet | null;
+    readonly convertResultData: ConvertResultData | null;
+    readonly metrics: PipelineMetrics | null;
+    readonly changeLog: readonly ChangeLogEntry[];
+    readonly submitDone: boolean;
+}
+declare const IMPORTER_PROGRESS_EVENT = "importer-progress";
+declare const IMPORTER_ABORTED_EVENT = "importer-aborted";
+interface ImporterProgressDetail {
+    readonly phase?: string;
+    readonly globalPercent?: number;
+    readonly localPercent?: number;
+    readonly currentRow?: number;
+    readonly totalRows?: number;
+    readonly rowsProcessed?: number;
+}
+
+interface ImporterProviderProps {
+    children: ReactNode;
+    layout?: SheetLayout | null;
+    engine?: ParserEngine | null;
+    persist?: boolean;
+    persistKey?: string;
+    onSubmit?: ((rows: Record<string, unknown>[]) => void) | null;
+    submitKeyMap?: Readonly<Record<string, string>> | null;
+}
+
+declare function ImporterProvider({ children, layout: layoutProp, engine: engineProp, persist, persistKey, onSubmit, submitKeyMap, }: ImporterProviderProps): react_jsx_runtime.JSX.Element;
+
+interface UseImporterOptions {
+    layout?: SheetLayout | null;
+    engine?: ParserEngine | null;
+}
+
+declare function useImporter(options?: UseImporterOptions): {
+    processFile: (file: File) => void;
+    registerValidator: (name: string, fn: (...args: unknown[]) => unknown, options: {
+        type: RegistryLevel;
+    }) => void;
+    registerSanitizer: (name: string, fn: (...args: unknown[]) => unknown, options: {
+        type: RegistryLevel;
+    }) => void;
+    registerTransform: (name: string, fn: (...args: unknown[]) => unknown, options: {
+        type: RegistryLevel;
+    }) => void;
+    abort: () => void;
+    metrics: PipelineMetrics | null;
+    submit: () => void;
+    canSubmit: boolean;
+    submitDone: boolean;
+};
+
+declare function useImportSheet(): {
+    startFullImport: () => Promise<RawParseResult>;
+};
+
+interface ConvertOptions {
+    readonly caseSensitive?: boolean;
+    readonly normalizer?: (header: string) => string;
+    readonly fuzzyHeaders?: boolean;
+    readonly fuzzyThreshold?: number;
+}
+
+interface ColumnMismatch {
+    readonly expected: string;
+    readonly found: string | null;
+    readonly message?: string;
+    readonly required?: boolean;
+}
+
+interface ConvertMismatchData {
+    readonly kind: 'mismatch';
+    readonly headersFound: readonly string[];
+    readonly mismatches: readonly ColumnMismatch[];
+    readonly columnOrder: readonly string[];
+    readonly headerToFieldMap: Readonly<Record<string, string>>;
+    readonly layoutError?: boolean;
+}
+
+interface ConvertResult extends ConvertMismatchData {
+    reorderColumns: (fieldNames: string[]) => void;
+    renameColumn: (fileHeader: string, layoutFieldName: string) => void;
+    applyMapping: () => ConvertResultApplyResult;
+}
+type ConvertResultApplyResult = {
+    kind: 'success';
+    sheet: ConvertedSheet;
+} | {
+    kind: 'mismatch';
+    result: ConvertMismatchData;
+};
+
+declare function useConvert(): {
+    convert: (options?: ConvertOptions) => void;
+    convertedSheet: ConvertedSheet | null;
+    convertResult: ConvertResult | null;
+};
+
+interface ConvertSuccess {
+    readonly kind: 'success';
+    readonly sheet: ConvertedSheet;
+}
+
+declare function useImporterStatus(): {
+    status: ImporterStatus;
+    progressEventTarget: EventTarget;
+};
+
+declare function useSheetData(): {
+    sheet: Sheet | null;
+    errors: SheetError[];
+    toObjects: <T>(mapRow: (row: ValidatedRow) => T) => T[];
+    toObjectsWithKeyMap: (keyMap: Readonly<Record<string, string>>) => Record<string, unknown>[];
+};
+
+interface UseSheetEditorOptions {
+    page?: number;
+    pageSize?: number;
+    debounceMs?: number;
+}
+declare function useSheetEditor(options?: UseSheetEditorOptions): {
+    sheet: Sheet | null;
+    editCell: (params: EditCellParams) => void | Promise<void>;
+    removeRow: (rowIndex: number) => void;
+    pageData: PaginatedResult<ValidatedRow>;
+    totalPages: number;
+    isReady: boolean;
+    canEdit: boolean;
+    changeLog: readonly ChangeLogEntry[];
+    changeLogAsText: string;
+};
+
+type ViewFilterMode = 'all' | 'errors-only';
+interface UseSheetViewOptions {
+    page?: number;
+    defaultPageSize?: number;
+    filterMode?: ViewFilterMode;
+}
+
+interface ExportOptions {
+    includeHeaders?: boolean;
+    csvSeparator?: string;
+    filename?: string;
+    formatDatesForExport?: boolean;
+}
+
+interface ViewCounts {
+    readonly totalRows: number;
+    readonly rowsWithErrors: number;
+    readonly totalErrors: number;
+}
+
+interface UseSheetViewReturn<TRow = ValidatedRow> {
+    sheet: Sheet | null;
+    getPaginatedResult: (page?: number, pageSize?: number) => PaginatedResult<TRow>;
+    paginatedRows: readonly TRow[];
+    page: number;
+    setPage: (page: number) => void;
+    pageSize: number;
+    totalRows: number;
+    /** 1-based page; returns slice for that page. */
+    getRows: (page: number, limit: number) => TRow[];
+    rowsWithErrors: readonly TRow[];
+    counts: ViewCounts;
+    editCell: (params: EditCellParams) => void | Promise<void>;
+    removeRow: (rowIndex: number) => void;
+    changeLog: readonly ChangeLogEntry[];
+    changeLogAsText: string;
+    exportToCSV: (options?: ExportOptions) => string | Blob | Promise<string | Blob>;
+    exportToJSON: (options?: ExportOptions) => string | Blob | Promise<string | Blob>;
+    downloadCSV: (options?: ExportOptions & {
+        filename?: string;
+    }) => void | Promise<void>;
+    downloadJSON: (options?: ExportOptions & {
+        filename?: string;
+    }) => void | Promise<void>;
+    hasRecoverableSession: boolean;
+    recoverSession: () => Promise<void>;
+    clearPersistedState: () => Promise<void>;
+}
+
+declare function useSheetView(options?: UseSheetViewOptions): UseSheetViewReturn<ValidatedRow>;
+
+declare function useImporterEventTarget(): {
+    progressEventTarget: EventTarget;
+    subscribeToProgress: (callback: (detail: ImporterProgressDetail) => void) => () => void;
+};
+declare function useImporterProgressSubscription(callback: (detail: ImporterProgressDetail) => void): void;
+
+declare function hasValidationErrors(sheet: Sheet | null): boolean;
+
+declare function getCellValue(row: ValidatedRow, key: string): unknown;
+
+export { type BaseSheet, type ChangeLogEntry, type ChangeLogEntryCellEdit, type ChangeLogEntryRowRemove, type ColumnMismatch, type ConvertMismatchData, type ConvertOptions, type ConvertResult, type ConvertResultApplyResult, type ConvertResultData, type ConvertSuccess, type ConvertedSheet, type EditCellParams, type ExportOptions, type FieldInputType, type FieldValueType, IMPORTER_ABORTED_EVENT, IMPORTER_PROGRESS_EVENT, ImporterProvider as ImportProvider, type ImporterProgressDetail, ImporterProvider, type ImporterProviderProps, type ImporterState, type ImporterStatus, type PaginatedResult, type ParserEngine, type PipelineMetrics, type PipelineMetricsPercentages, type PipelineMetricsTimings, type RawParseResult, type RawSheet, type RawSheetCell, type RawSheetCellValue, type RawSheetRow, Registry, type RegistryEntry, type RegistryLevel, type Sheet, type SheetError, type SheetErrorLevel, type SheetLayout, type SheetLayoutField, type SheetLayoutRef, type UseImporterOptions, type UseSheetViewOptions, type UseSheetViewReturn, type ValidatedCell, type ValidatedRow, type ValidatorOrWithParams, type ViewCounts, type ViewFilterMode, formatChangeLogAsText, getCellValue, hasValidationErrors, useConvert, useImportSheet, useImporter, useImporterEventTarget, useImporterProgressSubscription, useImporterStatus, useSheetData, useSheetEditor, useSheetView };

package/dist/index.js

@@ -0,0 +1,5 @@
+import{a as Q,b as he,c as ye}from"./chunk-UCBBDF6X.js";import{a as V}from"./chunk-YETPLYYC.js";import{useEffect as tt,useMemo as F,useRef as be,useState as re}from"react";var k="react-import-sheet-persist",Z="react-import-sheet-session";import{createContext as $e}from"react";var N=$e(null);var ge={file:null,rawData:null,documentHash:null,status:"idle",result:null,convertedSheet:null,sanitizedSheet:null,convertResultData:null,metrics:null,changeLog:[],submitDone:!1};import{useCallback as T,useMemo as Ge}from"react";function _(t){return t<.01&&t>=0?"0.00ms":t<1?`${(t*1e3).toFixed(2)}\u03BCs`:`${t.toFixed(2)}ms`}function ee(t,e,r){let s=t.parse+t.sanitize+t.validate+t.transform,o=s>2e3,i=`${(e>0?s/e:0).toFixed(4)}ms/row`,n;if(s>0){let u=r??0,c=s+u;n={parse:t.parse/c*100,sanitize:t.sanitize/c*100,validate:t.validate/c*100,transform:t.transform/c*100,overhead:c>0?u/c*100:0}}return{timings:{...t},percentages:n,totalMs:s,isSlow:o,parseTime:_(t.parse),sanitizeTime:_(t.sanitize),validateTime:_(t.validate),transformTime:_(t.transform),totalTime:_(s),efficiency:i,rowCount:e,...r!==void 0&&r>=0?{overheadMs:r}:{}}}function U(t){let e=[];for(let r of t)if(r.type==="cell_edit"){let s=r.previousValue!==void 0?` (previous: ${String(r.previousValue)})`:"";e.push(`Row ${r.rowIndex+1}, cell "${r.cellKey}": set to ${JSON.stringify(r.value)}${s}`)}else e.push(`Row ${r.rowIndex+1}: removed`);return e.join(`
+`)}var O="importer-progress",B="importer-aborted";import{useCallback as P}from"react";function q(t){let{setState:e,setLayoutState:r,setEngineState:s}=t,o=P(d=>{e(f=>({...f,file:d}))},[e]),a=P(d=>{e(f=>({...f,rawData:d}))},[e]),i=P(d=>{e(f=>({...f,documentHash:d}))},[e]),n=P(d=>{e(f=>({...f,status:d}))},[e]),u=P(d=>{e(f=>({...f,result:d}))},[e]),c=P(d=>{e(f=>({...f,convertedSheet:d,convertResultData:null}))},[e]),p=P(d=>{e(f=>({...f,sanitizedSheet:d}))},[e]),S=P(d=>{e(f=>({...f,convertResultData:typeof d=="function"?d(f.convertResultData):d,convertedSheet:typeof d=="function"?f.convertedSheet:null}))},[e]),l=P(d=>{e(f=>({...f,metrics:d}))},[e]),m=P(d=>{e(f=>({...f,submitDone:d}))},[e]),y=P(d=>{r(d)},[r]),x=P(d=>{s(d)},[s]);return{setLayout:y,setEngine:x,setFile:o,setRawData:a,setDocumentHash:i,setStatus:n,setResult:u,setConvertedSheet:c,setSanitizedSheet:p,setConvertResultData:S,setMetrics:l,setSubmitDone:m}}var Ye={parse:0,sanitize:0,validate:0,transform:0};function Se(t){let{setState:e,setLayoutState:r,setEngineState:s,progressEventTarget:o,validatorRegistry:a,sanitizerRegistry:i,transformRegistry:n,activeWorkerRef:u,phaseTimingsRef:c}=t,p=q({setState:e,setLayoutState:r,setEngineState:s}),S=T(h=>{o.dispatchEvent(new CustomEvent(O,{detail:h}))},[o]),l=T(h=>{u.current=h},[u]),m=T(()=>{let h=u.current;h&&(h.terminate(),u.current=null),e(R=>({...R,status:"cancelled"})),o.dispatchEvent(new CustomEvent(B))},[u,o,e]),y=T((h,R)=>{c.current={...c.current,[h]:R}},[c]),x=T(h=>{let R={...c.current},v=ee(R,h);p.setMetrics(v)},[c,p]),d=T(h=>{e(R=>({...R,changeLog:[...R.changeLog,h]}))},[e]),f=T(h=>{c.current={...Ye},e(R=>({...R,file:h,status:"loading",rawData:null,documentHash:null,result:null,convertedSheet:null,sanitizedSheet:null,convertResultData:null,metrics:null,changeLog:[],submitDone:!1}))},[c,e]),b=T((h,R,v)=>{a.register(h,R,v)},[a]),C=T((h,R,v)=>{i.register(h,R,v)},[i]),g=T((h,R,v)=>{n.register(h,R,v)},[n]);return Ge(()=>({...p,addChangeLogEntry:d,setPhaseTiming:y,finalizeMetrics:x,processFile:f,registerValidator:b,registerSanitizer:C,registerTransform:g,abort:m,dispatchProgress:S,setActiveWorker:l}),[p,d,y,x,f,b,C,g,m,S,l])}import{useCallback as Ee,useEffect as Pe,useRef as Qe,useState as Ze}from"react";function te(){return new Promise((t,e)=>{let r=indexedDB.open("react-import-sheet-db",1);r.onerror=()=>e(r.error),r.onsuccess=()=>t(r.result),r.onupgradeneeded=()=>{r.result.createObjectStore(k,{keyPath:"key"})}})}async function we(t,e){let r=await te();return new Promise((s,o)=>{let a=r.transaction(k,"readwrite"),i=a.objectStore(k),n={key:t,...e},u=i.put(n);u.onsuccess=()=>s(),u.onerror=()=>o(u.error),a.oncomplete=()=>r.close()})}async function xe(t){let e=await te();return new Promise((r,s)=>{let i=e.transaction(k,"readonly").objectStore(k).get(t);i.onsuccess=()=>{e.close();let n=i.result;if(n==null){r(null);return}let u=n.savedAt;if(Date.now()-u>6048e5){r(null);return}let{key:c,...p}=n;r(p)},i.onerror=()=>s(i.error)})}async function ve(t){let e=await te();return new Promise((r,s)=>{let o=e.transaction(k,"readwrite"),i=o.objectStore(k).delete(t);i.onsuccess=()=>r(),i.onerror=()=>s(i.error),o.oncomplete=()=>e.close()})}var et=2500;function Ce(t,e,r,s,o,a,i){let[n,u]=Ze(null),c=Qe(null);Pe(()=>{t&&xe(e).then(l=>{l&&(l.layoutVersion!=null&&i!=null&&String(l.layoutVersion)!==String(i)||u(l))})},[t,e,i]),Pe(()=>{if(!(!t||!r||!s))return c.current&&clearTimeout(c.current),c.current=setTimeout(()=>{c.current=null;let l={rawData:r,sheet:s,savedAt:Date.now(),layoutVersion:i??void 0,stateSchemaVersion:1};we(e,l).catch(()=>{})},et),()=>{c.current&&clearTimeout(c.current)}},[t,e,r,s,i]);let p=Ee(async()=>{if(!t)return;let l=n;l&&(o(l.rawData),a(l.sheet),u(null))},[t,n,o,a]),S=Ee(async()=>{t&&(await ve(e),u(null))},[t,e]);return{hasRecoverableSession:t&&n!=null,recoverSession:p,clearPersistedState:S}}import{jsx as rt}from"react/jsx-runtime";function oe({children:t,layout:e,engine:r,persist:s=!1,persistKey:o=Z,onSubmit:a=null,submitKeyMap:i=null}){let[n,u]=re(ge),[c,p]=re(e??null),[S,l]=re(r??null),m=F(()=>new EventTarget,[]),y=F(()=>new V,[]),x=F(()=>new V,[]),d=F(()=>new V,[]),f=be(null),b=be({parse:0,sanitize:0,validate:0,transform:0}),C=q({setState:u,setLayoutState:p,setEngineState:l}),g=Ce(s,o,n.rawData,n.result,C.setRawData,C.setResult,c?.version??null),h=Se({setState:u,setLayoutState:p,setEngineState:l,progressEventTarget:m,validatorRegistry:y,sanitizerRegistry:x,transformRegistry:d,activeWorkerRef:f,phaseTimingsRef:b});tt(()=>()=>{let v=f.current;v&&(v.terminate(),f.current=null)},[]);let R=F(()=>({...n,layout:c,engine:S,progressEventTarget:m,...h,onSubmit:a??null,submitKeyMap:i??null,persist:s,persistKey:o,hasRecoverableSession:g.hasRecoverableSession,recoverSession:g.recoverSession,clearPersistedState:g.clearPersistedState}),[n,c,S,m,a,i,h,s,o,g.hasRecoverableSession,g.recoverSession,g.clearPersistedState]);return rt(N.Provider,{value:R,children:t})}import{useContext as ot}from"react";function w(){let t=ot(N);if(t===null)throw new Error("useImporter must be used within an ImporterProvider");return t}import{useCallback as nt,useEffect as Te,useMemo as Ie}from"react";function A(t){return t.rows.filter(e=>e.errors.length>0)}function H(t){return t?K(t).totalErrors>0:!1}function K(t){let e=t.rows.length,r=A(t),s=t.errors.length+t.rows.reduce((o,a)=>o+a.errors.length+a.cells.reduce((i,n)=>i+n.errors.length,0),0);return{totalRows:e,rowsWithErrors:r.length,totalErrors:s}}function ne(t,e){return t.cells.find(s=>s.key===e)?.value}function se(t,e){return t.map(e)}function W(t,e){return t?t.rows.map(r=>{let s={};for(let[o,a]of Object.entries(e))s[a]=ne(r,o);return s}):[]}function st(t){return t.rows.map(e=>e.cells.reduce((r,s)=>({...r,[s.key]:s.value}),{}))}function ke(t={}){let e=w(),{layout:r,engine:s}=t;Te(()=>{r!==void 0&&e.setLayout(r)},[e,r]),Te(()=>{s!==void 0&&e.setEngine(s)},[e,s]);let o=Ie(()=>!!(e.result&&e.status==="success"&&!e.submitDone&&!H(e.result)),[e.result,e.status,e.submitDone]),a=nt(()=>{if(!e.result||e.submitDone||H(e.result)||!e.onSubmit)return;let i=e.submitKeyMap?W(e.result,e.submitKeyMap):st(e.result);e.onSubmit(i),e.setSubmitDone(!0)},[e]);return Ie(()=>({processFile:e.processFile,registerValidator:e.registerValidator,registerSanitizer:e.registerSanitizer,registerTransform:e.registerTransform,abort:e.abort,metrics:e.metrics,submit:a,canSubmit:o,submitDone:e.submitDone}),[e.processFile,e.registerValidator,e.registerSanitizer,e.registerTransform,e.abort,e.metrics,a,o,e.submitDone])}import{useCallback as ut,useEffect as ct}from"react";import{useCallback as Me,useEffect as it,useRef as at,useState as lt}from"react";import*as J from"comlink";function je(){return new URL("./parser.worker.js",import.meta.url).href}function Oe(){let{setActiveWorker:t,dispatchProgress:e}=w(),[r,s]=lt(null),o=at(null);it(()=>{let n=new Worker(je(),{type:"module"});o.current=n,t(n);let u=J.wrap(n);return queueMicrotask(()=>s(u)),()=>{n.terminate(),o.current=null,t(null)}},[t]);let a=Me(async(n,u={})=>{if(!r)throw new Error("Parser worker not ready");return r.load(n,u)},[r]),i=Me(async n=>{if(!r)throw new Error("Parser worker not ready");let u=n?J.proxy(n):void 0;return r.parseAll(u)},[r]);return{load:a,parseAll:i,dispatchProgress:e,isReady:!!r}}function Le(t){let e=Object.keys(t.sheets);return e.length===0?null:t.sheets[e[0]??""]??null}function De(){let t=w(),{load:e,parseAll:r,isReady:s}=Oe();return ct(()=>{let{file:a,status:i,engine:n}=t;!s||!a||i!=="loading"||e(a,{maxRows:10,fileName:a.name,engine:n??void 0}).then(u=>{if(!Le(u)){t.setStatus("error");return}let p=u.sheets[Object.keys(u.sheets)[0]??""];if(!p){t.setStatus("error");return}t.setRawData(p),t.setDocumentHash(p.documentHash),t.setStatus("success")}).catch(()=>{t.setStatus("error")})},[s,t.file,t.status,t.setRawData,t.setDocumentHash,t.setStatus,e]),{startFullImport:ut(()=>{let{file:a}=t;if(!a)return Promise.reject(new Error("No file loaded"));t.setStatus("loading");let i=performance.now();return r(n=>t.dispatchProgress(n)).then(n=>{let u=performance.now();if(t.setPhaseTiming("parse",u-i),!Le(n))return t.setStatus("error"),n;let p=n.sheets[Object.keys(n.sheets)[0]??""];return p?(t.setRawData(p),t.setDocumentHash(p.documentHash),t.setStatus("success"),n):(t.setStatus("error"),n)})},[t,r])}}import{useCallback as G,useMemo as Fe}from"react";function ie(t,e,r,s){let o=[...r],a=new Map;t.headers.forEach((n,u)=>a.set(n,u));let i=t.rows.map(n=>{let u=r.map(c=>{let p=s[c],S=p!=null?(()=>{let l=a.get(p);return l==null?null:n.cells[l]?.value??null})():null;return{key:c,value:S??null}});return{index:n.index,cells:u}});return{name:t.name,filesize:t.filesize,documentHash:t.documentHash,rowsCount:t.rowsCount,headersCount:t.headersCount,headers:o,rows:i}}function Ve(t){return t.trim().toLowerCase().normalize("NFD").replace(/\p{Diacritic}/gu,"")}function pt(t,e){if(t.length===0)return e.length;if(e.length===0)return t.length;let r=Array.from({length:e.length+1},(s,o)=>o);for(let s=1;s<=t.length;s++){let o=[s];for(let a=1;a<=e.length;a++){let i=t[s-1]===e[a-1]?0:1;o[a]=Math.min(o[a-1]+1,r[a]+1,r[a-1]+i)}r=o}return r[e.length]}function mt(t,e){let r=Ve(t),s=Ve(e),o=r.length>=s.length?r:s,a=r.length<s.length?r:s;if(o.length===0)return 1;let i=pt(o,a);return(o.length-i)/o.length}var dt=.8;function _e(t,e,r={}){let s=r.threshold??dt,o=[];for(let u of e)for(let c of t){let p=mt(u,c);p>=s&&o.push({key:u,header:c,score:p})}o.sort((u,c)=>c.score-u.score);let a=new Set,i=new Set,n={};for(let u of e)n[u]=null;for(let{key:u,header:c,score:p}of o)a.has(u)||i.has(c)||(n[u]=c,a.add(u),i.add(c));return e.map(u=>({key:u,matchedHeader:n[u]??null}))}function ft(t,e){let r=t.trim();return e?r:r.toLowerCase()}function ae(t,e,r={},s={}){let o=s.caseSensitive??!1,a=s.normalizer??(l=>ft(l,o)),i=Object.keys(e.fields),n=t.headers,u=new Map;for(let l of n)u.set(a(l),l);let c={},p=new Set;for(let[l,m]of Object.entries(r))i.includes(m)&&(c[m]=n.includes(l)?l:null,c[m]&&p.add(l));for(let l of i){if(c[l]!=null)continue;let m=a(l),y=u.get(m);y!=null&&!p.has(y)?(c[l]=y,p.add(y)):c[l]=null}if(s.fuzzyHeaders===!0){let l=i.filter(d=>c[d]==null),m=n.filter(d=>!p.has(d)),y=s.fuzzyThreshold??.8,x=_e(m,l,{threshold:y});for(let{key:d,matchedHeader:f}of x)f!=null&&!p.has(f)&&(c[d]=f,p.add(f))}let S=[];for(let l of i)if(c[l]==null){let x=e.fields[l]?.required!==!1;S.push({expected:l,found:null,message:`Column '${l}' not found in file`,required:x})}return{fieldToHeader:c,mismatches:S}}function $(t,e,r={},s){let o=Object.keys(e.fields),a=s?.columnOrder?.length?s.columnOrder:o,i=s?.headerToFieldMap??{},{fieldToHeader:n,mismatches:u}=ae(t,e,i,r),p=o.filter(m=>e.fields[m]?.required!==!1).every(m=>n[m]!=null);if(u.length===0||p)return{kind:"success",sheet:ie(t,e,a,n)};let l=u.some(m=>m.required===!0);return{kind:"mismatch",headersFound:[...t.headers],mismatches:u,columnOrder:[...a],headerToFieldMap:{...i},layoutError:l}}function Y(){let t=w(),{rawData:e,layout:r,convertedSheet:s,convertResultData:o,setConvertedSheet:a,setConvertResultData:i}=t,n=G(l=>{if(!e||!r)return;let m=$(e,r,l,o??void 0);m.kind==="success"?a(m.sheet):i({headersFound:m.headersFound,mismatches:m.mismatches,columnOrder:m.columnOrder,headerToFieldMap:m.headerToFieldMap})},[e,r,o,a,i]),u=G(()=>{if(!e||!r||!o)return;let l=$(e,r,{},{columnOrder:o.columnOrder,headerToFieldMap:o.headerToFieldMap});return l.kind==="success"?(a(l.sheet),{kind:"success",sheet:l.sheet}):(i({headersFound:l.headersFound,mismatches:l.mismatches,columnOrder:l.columnOrder,headerToFieldMap:l.headerToFieldMap}),{kind:"mismatch",result:l})},[e,r,o,a,i]),c=G(l=>{i(m=>m&&{...m,columnOrder:l})},[i]),p=G((l,m)=>{i(y=>y&&{...y,headerToFieldMap:{...y.headerToFieldMap,[l]:m}})},[i]),S=Fe(()=>o?{kind:"mismatch",headersFound:o.headersFound,mismatches:o.mismatches,columnOrder:[...o.columnOrder],headerToFieldMap:{...o.headerToFieldMap},reorderColumns:c,renameColumn:p,applyMapping:()=>u()??{kind:"mismatch",result:{...o,kind:"mismatch"}}}:null,[o,c,p,u]);return Fe(()=>({convert:n,convertedSheet:s,convertResult:S}),[n,s,S])}import{useMemo as ht}from"react";function Ae(){let t=w();return ht(()=>({status:t.status,progressEventTarget:t.progressEventTarget}),[t.status,t.progressEventTarget])}import{useCallback as He,useMemo as We}from"react";function ze(){let e=w().result,r=We(()=>e?[...e.errors]:[],[e]),s=He(a=>e?se(e.rows,a):[],[e]),o=He(a=>W(e,a),[e]);return We(()=>({sheet:e,errors:r,toObjects:s,toObjectsWithKeyMap:o}),[e,r,s,o])}import{useCallback as ue,useMemo as ce,useRef as wt}from"react";import{useCallback as yt,useEffect as gt,useRef as St,useState as Rt}from"react";import*as Ue from"comlink";function Ne(){return new URL("./edit.worker.js",import.meta.url).href}function Be(){let[t,e]=Rt(null),r=St(null);return gt(()=>{let o=new Worker(Ne(),{type:"module"});r.current=o;let a=Ue.wrap(o);return queueMicrotask(()=>e(a)),()=>{o.terminate(),r.current=null}},[]),{runEdit:yt(async(o,a,i,n,u,c)=>{if(!t)throw new Error("Edit worker not ready");return t.runEdit(o,a,i,n,u,c??{})},[t]),isReady:!!t}}function qe(t,e,r){return le(t.rows,e,r)}function le(t,e,r){let s=t.length,o=r<=0?0:Math.max(1,Math.ceil(s/r)),a=Math.max(1,Math.min(e,o)),i=(a-1)*r,n=Math.min(i+r,s),u=t.slice(i,n);return{page:a,pageSize:r,totalCount:s,totalPages:o,rows:u}}function X(t={}){let{result:e,setResult:r,layout:s,changeLog:o,addChangeLogEntry:a,submitDone:i}=w(),{runEdit:n,isReady:u}=Be(),c=!i,{page:p=1,pageSize:S=25,debounceMs:l}=t,m=wt(null),y=ce(()=>e?qe(e,p,S):{page:1,pageSize:S,totalCount:0,totalPages:0,rows:[]},[e,p,S]),x=y.totalPages,d=ue(g=>{if(!e||!s||i)return Promise.resolve();let h=Q(e,g.rowIndex)&&he(Q(e,g.rowIndex),g.cellKey)?.value;return n(e,s,g.rowIndex,g.cellKey,g.value).then(R=>{r(R),queueMicrotask(()=>{let v={type:"cell_edit",rowIndex:g.rowIndex,cellKey:g.cellKey,value:g.value,previousValue:h,timestamp:Date.now()};a(v)})})},[e,s,i,n,r,a]),f=ue(g=>{if(l!=null&&l>0){m.current&&clearTimeout(m.current),m.current=setTimeout(()=>{m.current=null,d(g)},l);return}return d(g)},[l,d]),b=ue(g=>{if(!e||i)return;let h=ye(e,g);r(h),queueMicrotask(()=>{let R={type:"row_remove",rowIndex:g,timestamp:Date.now()};a(R)})},[e,i,r,a]),C=ce(()=>U(o),[o]);return ce(()=>({sheet:e,editCell:f,removeRow:b,pageData:y,totalPages:x,isReady:u,canEdit:c,changeLog:o,changeLogAsText:C}),[e,f,b,y,x,u,c,o,C])}import{useCallback as D,useMemo as z,useState as Et}from"react";function Ke(t,e){return t.includes(e)||t.includes('"')||t.includes(`
+`)||t.includes("\r")?'"'+t.replace(/"/g,'""')+'"':t}function xt(t,e){return t==null?"":t instanceof Date?e?t.toLocaleString():t.toISOString():String(t)}function pe(t,e,r={}){let{includeHeaders:s=!0,csvSeparator:o=",",formatDatesForExport:a=!1}=r,i=e!=null?Object.keys(e.fields):[],n=i.length>0?i:t.rows[0]?.cells.map(p=>p.key)??t.headers.slice(),u=[];s&&n.length>0&&u.push(n.map(p=>Ke(p,o)).join(o));for(let p of t.rows){let S=n.map(l=>{let y=p.cells.find(x=>x.key===l)?.value??"";return Ke(xt(y,a),o)});u.push(S.join(o))}return"\uFEFF"+u.join(`\r
+`)}function vt(t,e){return t==null?null:t instanceof Date?e?t.toLocaleString():t.toISOString():t}function me(t,e,r={}){let{formatDatesForExport:s=!1}=r,o=t.rows.map(a=>{let i={};for(let n of a.cells)i[n.key]=vt(n.value,s);return i});return JSON.stringify(o,null,0)}function de(t={}){let{page:e=1,defaultPageSize:r=25,filterMode:s="all"}=t,[o,a]=Et(e),i=r,{sheet:n,editCell:u,removeRow:c,changeLog:p,changeLogAsText:S}=X({}),l=w(),m=z(()=>n?A(n):[],[n]),y=z(()=>s==="errors-only"?m:n?.rows??[],[s,m,n]),x=y.length,d=D((E,I)=>le(y,E??o,I??i),[o,i,y]),f=z(()=>d(o,i).rows,[d,o,i]),b=D((E,I)=>{let j=(E-1)*I;return y.slice(j,j+I)},[y]),C=z(()=>n?K(n):{totalRows:0,rowsWithErrors:0,totalErrors:0},[n]),g=D(E=>!n||!l.layout?"":pe(n,l.layout,E??{}),[n,l.layout]),h=D(E=>n?me(n,l.layout??null,E??{}):"[]",[n,l.layout]),R=D(async E=>{let I=g(E);if(!I)return;let j=new Blob([I],{type:"text/csv;charset=utf-8"}),L=URL.createObjectURL(j),M=document.createElement("a");M.href=L,M.download=(E?.filename??"export")+".csv",M.click(),URL.revokeObjectURL(L)},[g]),v=D(async E=>{let I=h(E),j=new Blob([I],{type:"application/json"}),L=URL.createObjectURL(j),M=document.createElement("a");M.href=L,M.download=(E?.filename??"export")+".json",M.click(),URL.revokeObjectURL(L)},[h]);return z(()=>({sheet:n,getPaginatedResult:d,paginatedRows:f,page:o,setPage:a,pageSize:i,totalRows:x,getRows:b,rowsWithErrors:m,counts:C,editCell:u,removeRow:c,changeLog:p,changeLogAsText:S,exportToCSV:g,exportToJSON:h,downloadCSV:R,downloadJSON:v,hasRecoverableSession:l.hasRecoverableSession,recoverSession:l.recoverSession,clearPersistedState:l.clearPersistedState}),[n,d,f,o,i,x,b,m,C,u,c,p,S,g,h,R,v,l.hasRecoverableSession,l.recoverSession,l.clearPersistedState])}import{useCallback as Pt,useEffect as Ct}from"react";function fe(){let e=w().progressEventTarget,r=Pt(s=>{let o=a=>{s(a.detail)};return e.addEventListener(O,o),()=>{e.removeEventListener(O,o)}},[e]);return{progressEventTarget:e,subscribeToProgress:r}}function Je(t){let{subscribeToProgress:e}=fe();Ct(()=>e(t),[e,t])}export{B as IMPORTER_ABORTED_EVENT,O as IMPORTER_PROGRESS_EVENT,oe as ImportProvider,oe as ImporterProvider,V as Registry,U as formatChangeLogAsText,ne as getCellValue,H as hasValidationErrors,Y as useConvert,De as useImportSheet,ke as useImporter,fe as useImporterEventTarget,Je as useImporterProgressSubscription,Ae as useImporterStatus,ze as useSheetData,X as useSheetEditor,de as useSheetView};
+//# sourceMappingURL=index.js.map