CSV Viewer

1"use client";
2 
3import * as React from "react";
4 
5import { useKeyedMountEffect } from "@/hooks/use-keyed-mount-effect";
6import type { CsvDialect, CsvTable } from "@/lib/csv";
7import {
8  createViewerResource,
9  type ViewerResource,
10} from "@/lib/viewer-resource";
11 
12import {
13  CsvViewerFrame,
14  CsvViewerHeader,
15  csvViewerStatusNode,
16} from "./csv-viewer-chrome";
17import {
18  csvViewerDownloadActions,
19  defaultCsvDownloadName,
20} from "./csv-viewer-download";
21import { CsvGrid, type CsvGridHandle } from "./csv-viewer-grid";
22import {
23  csvViewerExportFileName,
24  csvViewerSortResetKey,
25  isCsvDocumentSource,
26  resolveCsvViewerDialect,
27  type CsvDocumentSource,
28  type CsvTableSource,
29  type CsvViewerSource,
30} from "./csv-viewer-resource";
31import { useCsvResourceState, type CsvCellAddress } from "./csv-viewer-state";
32import type { CsvViewerHandle, CsvViewerProps } from "./csv-viewer-types";
33import {
34  useViewerControlsRegistration,
35  type ViewerControlsState,
36} from "./viewer-controls";
37import { joinEffectKey } from "@/lib/effect-key";
38 
39export type {
40  CsvScrollOptions,
41  CsvViewerHandle,
42  CsvViewerProps,
43} from "./csv-viewer-types";
44 
45export type CsvResourceContentProps = Omit<CsvViewerProps, "source"> & {
46  resource?: ViewerResource | null;
47  source?: CsvViewerSource;
48};
49type CsvResourceContentInternalProps = CsvResourceContentProps & {
50  frame?: boolean;
51};
52 
53export type CsvViewerProviderProps = {
54  children: React.ReactNode;
55  resource: ViewerResource;
56};
57 
58export type CsvViewerGridProps = Omit<CsvResourceContentProps, "resource">;
59 
60export const CsvViewer = React.forwardRef<CsvViewerHandle, CsvViewerProps>(
61  function CsvViewer({ source, ...props }, ref) {
62    const resource = React.useMemo<ViewerResource | null>(
63      () =>
64        source && isCsvDocumentSource(source)
65          ? createViewerResource(source)
66          : null,
67      [source],
68    );
69    return (
70      <CsvResourceContent
71        {...props}
72        frame
73        ref={ref}
74        resource={resource}
75        source={source}
76      />
77    );
78  },
79);
80 
81const CsvViewerResourceContext = React.createContext<ViewerResource | null>(
82  null,
83);
84 
85export function CsvViewerProvider({
86  children,
87  resource,
88}: CsvViewerProviderProps) {
89  return (
90    <CsvViewerResourceContext.Provider value={resource}>
91      {children}
92    </CsvViewerResourceContext.Provider>
93  );
94}
95 
96function useCsvViewerResource(): ViewerResource {
97  const resource = React.useContext(CsvViewerResourceContext);
98  if (!resource) {
99// … truncated