@verifyhash/csv-lite 0.1.0 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 <OWNER-NAME PLACEHOLDER>
+Copyright (c) 2026 verifyhash
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,12 +1,5 @@
 # csv-lite
 
-<!-- publish-prep -->
-> **TODO (owner): pick the final npm name/scope before publishing.**
-> The npm name is **not** finalized. `package.json` uses the placeholder
-> `PLACEHOLDER-csv-lite` — replace it with the real published name/scope
-> before any `npm publish`. Graduation to a package registry is a
-> **needs-human** decision, not something this project does on its own.
-
 A tiny, **zero-dependency, zero-network** Node.js library for **RFC 4180** CSV:
 parse a CSV string into rows (or objects), and turn rows back into CSV text with
 minimal, correct quoting. One CommonJS file (`index.js`), no install step, no
@@ -14,6 +7,16 @@ I/O — drop it into any project and `require` it.
 
 Spec reference: <https://www.rfc-editor.org/rfc/rfc4180>
 
+## Install
+
+```bash
+npm install @verifyhash/csv-lite
+```
+
+Published as [`@verifyhash/csv-lite`](https://www.npmjs.com/package/@verifyhash/csv-lite);
+source lives in the [verifyhash/libs](https://github.com/verifyhash/libs) monorepo.
+Zero runtime dependencies — you can also vendor the folder directly.
+
 ## Who it's for
 
 JavaScript/Node developers who need to read or write CSV correctly — quoted

package/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Type declarations for @verifyhash/csv-lite — zero-dependency RFC 4180 CSV
+ * parser and stringifier: quoted fields, embedded delimiters/newlines,
+ * doubled-quote escapes, header-object mode, custom delimiters.
+ *
+ * Streaming is out of scope: parse() takes a complete string and returns the
+ * fully materialized result. Both functions are pure and throw TypeError on
+ * invalid arguments (non-string text, multi-character or quote/newline
+ * delimiters, non-array rows, …).
+ */
+
+/** Options for parse(). */
+export interface ParseOptions {
+  /** Single-character field delimiter (default ','). May not be a quote or newline. */
+  delimiter?: string;
+  /**
+   * When true, treat the first row as a header and return an array of objects
+   * keyed by the header names (ragged rows: missing trailing cells become '').
+   */
+  header?: boolean;
+}
+
+/** Options for stringify(). */
+export interface StringifyOptions {
+  /** Single-character field delimiter (default ','). May not be a quote or newline. */
+  delimiter?: string;
+  /**
+   * When given, `rows` is treated as an array of objects; a header row of
+   * these column names is emitted first and each object is projected onto
+   * them in order.
+   */
+  columns?: string[];
+}
+
+/**
+ * Parse CSV text into rows (RFC 4180: quoted fields, "" escapes, CRLF/LF/CR
+ * record separators, one ignorable trailing newline). Every value comes back
+ * as a string — no type coercion; empty input yields []. Without
+ * { header: true } the result is a 2D array of strings.
+ */
+export function parse(
+  text: string,
+  options?: ParseOptions & { header?: false }
+): string[][];
+/** Parse with { header: true }: an array of objects keyed by the first row. */
+export function parse(
+  text: string,
+  options: ParseOptions & { header: true }
+): Array<Record<string, string>>;
+/** Parse when `header` is not statically known. */
+export function parse(
+  text: string,
+  options?: ParseOptions
+): string[][] | Array<Record<string, string>>;
+
+/**
+ * Serialize a 2D array of cell values to CSV text (LF record separators, no
+ * trailing newline). Fields are quoted only when they must be; embedded
+ * double-quotes are doubled; non-strings are coerced with String();
+ * null/undefined become empty unquoted fields.
+ */
+export function stringify(
+  rows: ReadonlyArray<ReadonlyArray<unknown>>,
+  options?: StringifyOptions & { columns?: undefined }
+): string;
+/**
+ * Serialize an array of objects to CSV text using `columns` as both the
+ * emitted header row and the projection order for each object.
+ */
+export function stringify(
+  rows: ReadonlyArray<Record<string, unknown> | null | undefined>,
+  options: StringifyOptions & { columns: string[] }
+): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verifyhash/csv-lite",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Zero-dependency RFC 4180 CSV parser and stringifier for Node.js: quoted fields, embedded delimiters/newlines, doubled-quote escapes, header-object mode, custom delimiters.",
   "keywords": [
     "csv",
@@ -14,13 +14,15 @@
     "zero-dependency"
   ],
   "main": "index.js",
+  "types": "index.d.ts",
   "scripts": {
     "test": "node test/index.test.js"
   },
   "license": "MIT",
   "files": [
     "index.js",
-    "README.md"
+    "README.md",
+    "index.d.ts"
   ],
   "publishConfig": {
     "access": "public"