@crewlethq/ui 0.34.2 → 0.35.0

package/dist/utils/csv.d.ts

@@ -16,3 +16,38 @@
  * "this is text". A NUMBER is never prefixed: `-3` is a value, and stays one.
  */
 export declare function toCsv(header: readonly string[], rows: readonly (readonly unknown[])[]): string;
+/** The separators `parseCsv` reads: a comma, a semicolon (a European spreadsheet's CSV) and a tab (a copied range). */
+export type CsvDelimiter = ',' | ';' | '\t';
+export interface ParseCsvOptions {
+    /** The separator. Without it, the one the first record uses most outside quotes, a comma when none. */
+    delimiter?: CsvDelimiter | undefined;
+    /** The most records read, the header included. One more is `too_many_rows` rather than a silent cut. */
+    maxRows?: number | undefined;
+}
+/** Why a text could not be read as CSV: an opened quote never closed, or more records than allowed. */
+export type CsvProblem = 'unterminated_quote' | 'too_many_rows';
+export type ParseCsvResult = {
+    ok: true;
+    rows: string[][];
+    delimiter: CsvDelimiter;
+} | {
+    ok: false;
+    problem: CsvProblem;
+    /** The 1-based line the problem starts on. */
+    line: number;
+};
+/**
+ * A CSV text as its records, each a list of field texts, as RFC 4180 reads
+ * it and as spreadsheets write it in practice: CRLF, LF or a lone CR ends a
+ * record, a quoted field may hold the separator, quotes (doubled) and line
+ * breaks, a UTF-8 byte order mark is dropped, and the blank line after the
+ * last record is not a record. A quote inside an unquoted field is kept as
+ * text. Records may differ in length; the caller decides what a short one
+ * means.
+ *
+ * IT READS BACK WHAT `toCsv` WRITES. A text field `toCsv` defused with a
+ * leading apostrophe (`'=SUM(A1)`) reads as the text it was (`=SUM(A1)`), so
+ * an export imported again is the same table. Every value stays text: the
+ * caller types it, and no value is ever evaluated.
+ */
+export declare function parseCsv(text: string, options?: ParseCsvOptions): ParseCsvResult;

package/dist/utils/index.d.ts

@@ -4,7 +4,8 @@ export type { Clipboard, ClipboardOptions, ClipboardState } from './useClipboard
 export { useOutcome } from './useOutcome.js';
 export type { Outcome, OutcomeOptions, OutcomeState } from './useOutcome.js';
 export { downloadBlob, downloadText, safeFilename, useDownload } from './useDownload.js';
-export { toCsv } from './csv.js';
+export { parseCsv, toCsv } from './csv.js';
+export type { CsvDelimiter, CsvProblem, ParseCsvOptions, ParseCsvResult } from './csv.js';
 export { ElementToPngError, elementToPng, serializeElement } from './elementToPng.js';
 export type { ElementToPngOptions, ElementToPngReason } from './elementToPng.js';
 export type { Download, DownloadState } from './useDownload.js';

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-export { ElementToPngError, elementToPng, serializeElement, toCsv } from '../chunk-UOR7TOAU.js';
+export { ElementToPngError, elementToPng, parseCsv, serializeElement, toCsv } from '../chunk-OSFA5ROT.js';
 export { downloadBlob, downloadText, safeFilename, useDownload } from '../chunk-IW55G7XG.js';
 export { useClipboard, writeClipboard } from '../chunk-STJ7QBC3.js';
 export { useOutcome } from '../chunk-DTIW4CHZ.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewlethq/ui",
-  "version": "0.34.2",
+  "version": "0.35.0",
   "description": "Crewlet shared React components built on @crewlethq/tokens and @crewlethq/icons.",
   "license": "MIT",
   "repository": {
@@ -42,8 +42,8 @@
     "clean": "rm -rf dist src/generated"
   },
   "dependencies": {
-    "@crewlethq/icons": "0.34.2",
-    "@crewlethq/tokens": "0.34.2",
+    "@crewlethq/icons": "0.35.0",
+    "@crewlethq/tokens": "0.35.0",
     "prosemirror-commands": "1.7.2",
     "prosemirror-gapcursor": "1.4.1",
     "prosemirror-history": "1.5.1",