@mitre/hdf-utilities 3.0.0 → 3.1.0-rc.1

package/LICENSE.md

@@ -0,0 +1,55 @@
+# License
+
+Copyright © 2025 The MITRE Corporation.
+
+Approved for Public Release; Distribution Unlimited. Case Number 18-3678.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may
+not use this file except in compliance with the License. You may obtain a
+copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations
+under the License.
+
+## Redistribution Terms
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+- Redistributions of source code must retain the above copyright/digital
+  rights legend, this list of conditions and the following Notice.
+- Redistributions in binary form must reproduce the above
+  copyright/digital rights legend, this list of conditions and the
+  following Notice in the documentation and/or other materials provided
+  with the distribution.
+- Neither the name of The MITRE Corporation nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+## Notice
+
+The MITRE Corporation grants permission to reproduce, distribute, modify, and
+otherwise use this software to the extent permitted by the licensed terms
+provided in the LICENSE file included with this project.
+
+This software was produced by The MITRE Corporation for the U.S. Government
+under contract. As such the U.S. Government has certain use and data
+rights in this software. No use other than those granted to the U.S.
+Government, or to those acting on behalf of the U.S. Government, under
+these contract arrangements is authorized without the express written
+permission of The MITRE Corporation.
+
+Some files in this codebase were generated by generative AI, under the
+direction and review of The MITRE Corporation employees, for the purpose of
+development efficiency. All AI-generated code functionality was validated
+by standard quality and assurance testing.
+
+For further information, please contact The MITRE Corporation,
+Contracts Management Office, 7515 Colshire Drive, McLean, VA 22102-7539,
+(703) 983-6000.

package/dist/csv/index.d.ts

@@ -1,29 +1,25 @@
-/**
- * CSV parsing and generation utilities using d3-dsv
- *
- * SECURITY WARNING: CSV files opened in Excel/LibreOffice may execute formulas.
- * Use sanitization options when exporting data that may contain user-controlled content.
- */
-export { extractColumn as extractCsvColumn, findRows as findCsvRows, } from '../object/index.js';
+import { extractColumn, findRows } from "../object/index.js";
+
+//#region src/csv/index.d.ts
 /**
  * Options for parsing CSV
  */
-export interface CsvParseOptions {
-    header?: boolean;
-    skipEmptyLines?: boolean;
-    transformHeader?: (header: string, index: number) => string;
-    dynamicTyping?: boolean;
-    delimiter?: string;
-    maxSize?: number;
+interface CsvParseOptions {
+  header?: boolean;
+  skipEmptyLines?: boolean;
+  transformHeader?: (header: string, index: number) => string;
+  dynamicTyping?: boolean;
+  delimiter?: string;
+  maxSize?: number;
 }
 /**
  * Options for building CSV
  */
-export interface CsvBuildOptions {
-    header?: boolean;
-    newline?: string;
-    skipEmptyLines?: boolean;
-    delimiter?: string;
+interface CsvBuildOptions {
+  header?: boolean;
+  newline?: string;
+  skipEmptyLines?: boolean;
+  delimiter?: string;
 }
 /**
  * Parse CSV string into array of objects with headers as keys
@@ -32,7 +28,7 @@ export interface CsvBuildOptions {
  * @returns Array of objects representing rows
  * @throws Error if parsing fails
  */
-export declare function parseCsv<T = Record<string, unknown>>(csv: string, options?: Partial<CsvParseOptions>): T[];
+declare function parseCsv<T = Record<string, unknown>>(csv: string, options?: Partial<CsvParseOptions>): T[];
 /**
  * Parse CSV string into array of arrays without treating first row as headers
  * @param csv - CSV string to parse
@@ -40,7 +36,7 @@ export declare function parseCsv<T = Record<string, unknown>>(csv: string, optio
  * @returns Array of arrays representing rows
  * @throws Error if parsing fails
  */
-export declare function parseCsvArray(csv: string, options?: Partial<CsvParseOptions>): string[][];
+declare function parseCsvArray(csv: string, options?: Partial<CsvParseOptions>): string[][];
 /**
  * Build CSV string from array of objects
  *
@@ -51,8 +47,8 @@ export declare function parseCsvArray(csv: string, options?: Partial<CsvParseOpt
  * @param options - Optional build configuration and sanitize flag
  * @returns CSV string
  */
-export declare function buildCsv<T = Record<string, unknown>>(data: T[], options?: Partial<CsvBuildOptions> & {
-    sanitize?: boolean;
+declare function buildCsv<T = Record<string, unknown>>(data: T[], options?: Partial<CsvBuildOptions> & {
+  sanitize?: boolean;
 }): string;
 /**
  * Build CSV string from array of arrays
@@ -64,15 +60,15 @@ export declare function buildCsv<T = Record<string, unknown>>(data: T[], options
  * @param options - Optional build configuration and sanitize flag
  * @returns CSV string
  */
-export declare function buildCsvArray(data: string[][], options?: Partial<CsvBuildOptions> & {
-    sanitize?: boolean;
+declare function buildCsvArray(data: string[][], options?: Partial<CsvBuildOptions> & {
+  sanitize?: boolean;
 }): string;
 /**
  * Validate CSV format
  * @param csv - CSV string to validate
  * @returns True if valid CSV, false otherwise
  */
-export declare function isValidCsv(csv: string): boolean;
+declare function isValidCsv(csv: string): boolean;
 /**
  * Sanitize a single CSV value to prevent formula injection
  *
@@ -82,19 +78,21 @@ export declare function isValidCsv(csv: string): boolean;
  * @param value - Value to sanitize
  * @returns Sanitized value
  */
-export declare function sanitizeCsvValue(value: unknown): string;
+declare function sanitizeCsvValue(value: unknown): string;
 /**
  * Sanitize all values in an array to prevent formula injection
  *
  * @param values - Array of values to sanitize
  * @returns Array with sanitized values
  */
-export declare function sanitizeCsvArray(values: unknown[]): string[];
+declare function sanitizeCsvArray(values: unknown[]): string[];
 /**
  * Sanitize all values in an object to prevent formula injection
  *
  * @param obj - Object with values to sanitize
  * @returns New object with sanitized values
  */
-export declare function sanitizeCsvObject<T extends Record<string, unknown>>(obj: T): Record<string, string>;
+declare function sanitizeCsvObject<T extends Record<string, unknown>>(obj: T): Record<string, string>;
+//#endregion
+export { CsvBuildOptions, CsvParseOptions, buildCsv, buildCsvArray, extractColumn as extractCsvColumn, findRows as findCsvRows, isValidCsv, parseCsv, parseCsvArray, sanitizeCsvArray, sanitizeCsvObject, sanitizeCsvValue };
 //# sourceMappingURL=index.d.ts.map

package/dist/csv/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/csv/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,aAAa,IAAI,gBAAgB,EACjC,QAAQ,IAAI,WAAW,GACxB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,CAAC,EAAE,CA2CL;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,MAAM,EAAE,EAAE,CAoBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,MAAM,CA8BR;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,MAAM,CAmBR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAe/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,CAAC,GACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/csv/index.ts"],"mappings":";;;;;;UAiBiB,eAAA;EACf,MAAA;EACA,cAAA;EACA,eAAA,IAAmB,MAAA,UAAgB,KAAA;EACnC,aAAA;EACA,SAAA;EACA,OAAA;AAAA;;;;UAMe,eAAA;EACf,MAAA;EACA,OAAA;EACA,cAAA;EACA,SAAA;AAAA;AAwEF;;;;;;;AAAA,iBAAgB,QAAA,KAAa,MAAA,kBAAA,CAC3B,GAAA,UACA,OAAA,GAAU,OAAA,CAAQ,eAAA,IACjB,CAAA;;;;;;;;iBAoDa,aAAA,CACd,GAAA,UACA,OAAA,GAAU,OAAA,CAAQ,eAAA;;;AAFpB;;;;;;;;iBAmCgB,QAAA,KAAa,MAAA,kBAAA,CAC3B,IAAA,EAAM,CAAA,IACN,OAAA,GAAU,OAAA,CAAQ,eAAA;EAAqB,QAAA;AAAA;;;;;;;;;;;iBA2CzB,aAAA,CACd,IAAA,cACA,OAAA,GAAU,OAAA,CAAQ,eAAA;EAAqB,QAAA;AAAA;;;;;;iBA2BzB,UAAA,CAAW,GAAA;;;;;;;;;;iBA0BX,gBAAA,CAAiB,KAAA;AA1BjC;;;;;AA0BA;AA1BA,iBAyCgB,gBAAA,CAAiB,MAAA;;;;AAAjC;;;iBAUgB,iBAAA,WAA4B,MAAA,kBAAA,CAC1C,GAAA,EAAK,CAAA,GACJ,MAAA"}

package/dist/csv/index.js

@@ -1,251 +1,212 @@
+import { extractColumn, findRows } from "../object/index.js";
+import { dsvFormat } from "d3-dsv";
+//#region src/csv/index.ts
 /**
- * CSV parsing and generation utilities using d3-dsv
- *
- * SECURITY WARNING: CSV files opened in Excel/LibreOffice may execute formulas.
- * Use sanitization options when exporting data that may contain user-controlled content.
- */
-import { dsvFormat } from 'd3-dsv';
-export { extractColumn as extractCsvColumn, findRows as findCsvRows, } from '../object/index.js';
+* CSV parsing and generation utilities using d3-dsv
+*
+* SECURITY WARNING: CSV files opened in Excel/LibreOffice may execute formulas.
+* Use sanitization options when exporting data that may contain user-controlled content.
+*/
 /**
- * Default options for parsing CSV with headers
- */
+* Default options for parsing CSV with headers
+*/
 const DEFAULT_PARSE_OPTIONS = {
-    header: true,
-    skipEmptyLines: true,
-    transformHeader: undefined,
-    dynamicTyping: false,
+	header: true,
+	skipEmptyLines: true,
+	transformHeader: void 0,
+	dynamicTyping: false
 };
 /**
- * Default options for parsing CSV without headers
- */
+* Default options for parsing CSV without headers
+*/
 const DEFAULT_PARSE_ARRAY_OPTIONS = {
-    header: false,
-    skipEmptyLines: true,
-    dynamicTyping: false,
+	header: false,
+	skipEmptyLines: true,
+	dynamicTyping: false
 };
 /**
- * Default options for building CSV
- */
+* Default options for building CSV
+*/
 const DEFAULT_BUILD_OPTIONS = {
-    header: true,
-    newline: '\n',
-    skipEmptyLines: true,
+	header: true,
+	newline: "\n",
+	skipEmptyLines: true
 };
 /**
- * Validate CSV quoting — throws if unclosed quotes are found
- */
+* Validate CSV quoting — throws if unclosed quotes are found
+*/
 function validateQuoting(csv) {
-    let inQuotes = false;
-    let row = 0;
-    for (let i = 0; i < csv.length; i++) {
-        if (csv[i] === '"') {
-            if (inQuotes && i + 1 < csv.length && csv[i + 1] === '"') {
-                i++; // skip escaped quote ""
-            }
-            else {
-                inQuotes = !inQuotes;
-            }
-        }
-        else if (csv[i] === '\n' && !inQuotes) {
-            row++;
-        }
-    }
-    if (inQuotes) {
-        throw new Error(`CSV parsing failed: Row ${row}: Unclosed quote`);
-    }
+	let inQuotes = false;
+	let row = 0;
+	for (let i = 0; i < csv.length; i++) if (csv[i] === "\"") if (inQuotes && i + 1 < csv.length && csv[i + 1] === "\"") i++;
+	else inQuotes = !inQuotes;
+	else if (csv[i] === "\n" && !inQuotes) row++;
+	if (inQuotes) throw new Error(`CSV parsing failed: Row ${row}: Unclosed quote`);
 }
 /**
- * Convert string value to number or boolean when appropriate
- */
+* Convert string value to number or boolean when appropriate
+*/
 function dynamicTypeConvert(value) {
-    if (value === '')
-        return value;
-    if (value === 'true')
-        return true;
-    if (value === 'false')
-        return false;
-    const num = Number(value);
-    if (!isNaN(num) && value.trim() !== '')
-        return num;
-    return value;
+	if (value === "") return value;
+	if (value === "true") return true;
+	if (value === "false") return false;
+	const num = Number(value);
+	if (!isNaN(num) && value.trim() !== "") return num;
+	return value;
 }
 /**
- * Parse CSV string into array of objects with headers as keys
- * @param csv - CSV string to parse
- * @param options - Optional parse configuration
- * @returns Array of objects representing rows
- * @throws Error if parsing fails
- */
-export function parseCsv(csv, options) {
-    if (options?.maxSize !== undefined && csv.length > options.maxSize) {
-        throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
-    }
-    const opts = { ...DEFAULT_PARSE_OPTIONS, ...options };
-    const trimmed = csv.trim();
-    validateQuoting(trimmed);
-    const dsv = dsvFormat(opts.delimiter ?? ',');
-    const parsed = dsv.parse(trimmed);
-    const { columns } = parsed;
-    // Pre-compute transformed headers
-    const headers = opts.transformHeader
-        ? columns.map((col, i) => opts.transformHeader(col, i))
-        : columns;
-    let rows = parsed.map((row) => {
-        const obj = {};
-        columns.forEach((col, i) => {
-            let value = row[col] ?? '';
-            if (opts.dynamicTyping && typeof value === 'string') {
-                value = dynamicTypeConvert(value);
-            }
-            const key = headers[i];
-            if (key !== undefined) {
-                obj[key] = value;
-            }
-        });
-        return obj;
-    });
-    if (opts.skipEmptyLines) {
-        rows = rows.filter((row) => Object.values(row).some((v) => v !== '' && v !== null && v !== undefined));
-    }
-    return rows;
+* Parse CSV string into array of objects with headers as keys
+* @param csv - CSV string to parse
+* @param options - Optional parse configuration
+* @returns Array of objects representing rows
+* @throws Error if parsing fails
+*/
+function parseCsv(csv, options) {
+	if (options?.maxSize !== void 0 && csv.length > options.maxSize) throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
+	const opts = {
+		...DEFAULT_PARSE_OPTIONS,
+		...options
+	};
+	const trimmed = csv.trim();
+	validateQuoting(trimmed);
+	const parsed = dsvFormat(opts.delimiter ?? ",").parse(trimmed);
+	const { columns } = parsed;
+	const headers = opts.transformHeader ? columns.map((col, i) => opts.transformHeader(col, i)) : columns;
+	let rows = parsed.map((row) => {
+		const obj = {};
+		columns.forEach((col, i) => {
+			let value = row[col] ?? "";
+			if (opts.dynamicTyping && typeof value === "string") value = dynamicTypeConvert(value);
+			const key = headers[i];
+			if (key !== void 0) obj[key] = value;
+		});
+		return obj;
+	});
+	if (opts.skipEmptyLines) rows = rows.filter((row) => Object.values(row).some((v) => v !== "" && v !== null && v !== void 0));
+	return rows;
 }
 /**
- * Parse CSV string into array of arrays without treating first row as headers
- * @param csv - CSV string to parse
- * @param options - Optional parse configuration
- * @returns Array of arrays representing rows
- * @throws Error if parsing fails
- */
-export function parseCsvArray(csv, options) {
-    if (options?.maxSize !== undefined && csv.length > options.maxSize) {
-        throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
-    }
-    const opts = { ...DEFAULT_PARSE_ARRAY_OPTIONS, ...options };
-    const trimmed = csv.trim();
-    validateQuoting(trimmed);
-    const dsv = dsvFormat(opts.delimiter ?? ',');
-    let rows = dsv.parseRows(trimmed);
-    if (opts.skipEmptyLines) {
-        rows = rows.filter((row) => !(row.length === 1 && row[0] === ''));
-    }
-    return rows;
+* Parse CSV string into array of arrays without treating first row as headers
+* @param csv - CSV string to parse
+* @param options - Optional parse configuration
+* @returns Array of arrays representing rows
+* @throws Error if parsing fails
+*/
+function parseCsvArray(csv, options) {
+	if (options?.maxSize !== void 0 && csv.length > options.maxSize) throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
+	const opts = {
+		...DEFAULT_PARSE_ARRAY_OPTIONS,
+		...options
+	};
+	const trimmed = csv.trim();
+	validateQuoting(trimmed);
+	let rows = dsvFormat(opts.delimiter ?? ",").parseRows(trimmed);
+	if (opts.skipEmptyLines) rows = rows.filter((row) => !(row.length === 1 && row[0] === ""));
+	return rows;
 }
 /**
- * Build CSV string from array of objects
- *
- * SECURITY: Set sanitize=true when data may contain user-controlled content
- * to prevent CSV formula injection attacks in Excel/LibreOffice.
- *
- * @param data - Array of objects to convert to CSV
- * @param options - Optional build configuration and sanitize flag
- * @returns CSV string
- */
-export function buildCsv(data, options) {
-    const { sanitize, ...buildOpts } = options || {};
-    const opts = { ...DEFAULT_BUILD_OPTIONS, ...buildOpts };
-    if (data.length === 0)
-        return '';
-    let processedData = data;
-    if (sanitize) {
-        processedData = data.map((row) => sanitizeCsvObject(row));
-    }
-    const dsv = dsvFormat(opts.delimiter ?? ',');
-    let result;
-    if (opts.header === false) {
-        const rows = processedData.map((row) => Object.values(row).map(String));
-        result = dsv.formatRows(rows);
-    }
-    else {
-        result = dsv.format(processedData);
-    }
-    if (opts.newline && opts.newline !== '\n') {
-        result = result.replace(/\n/g, opts.newline);
-    }
-    return result;
+* Build CSV string from array of objects
+*
+* SECURITY: Set sanitize=true when data may contain user-controlled content
+* to prevent CSV formula injection attacks in Excel/LibreOffice.
+*
+* @param data - Array of objects to convert to CSV
+* @param options - Optional build configuration and sanitize flag
+* @returns CSV string
+*/
+function buildCsv(data, options) {
+	const { sanitize, ...buildOpts } = options || {};
+	const opts = {
+		...DEFAULT_BUILD_OPTIONS,
+		...buildOpts
+	};
+	if (data.length === 0) return "";
+	let processedData = data;
+	if (sanitize) processedData = data.map((row) => sanitizeCsvObject(row));
+	const dsv = dsvFormat(opts.delimiter ?? ",");
+	let result;
+	if (opts.header === false) {
+		const rows = processedData.map((row) => Object.values(row).map(String));
+		result = dsv.formatRows(rows);
+	} else result = dsv.format(processedData);
+	if (opts.newline && opts.newline !== "\n") result = result.replace(/\n/g, opts.newline);
+	return result;
 }
 /**
- * Build CSV string from array of arrays
- *
- * SECURITY: Set sanitize=true when data may contain user-controlled content
- * to prevent CSV formula injection attacks in Excel/LibreOffice.
- *
- * @param data - Array of arrays to convert to CSV
- * @param options - Optional build configuration and sanitize flag
- * @returns CSV string
- */
-export function buildCsvArray(data, options) {
-    const { sanitize, ...buildOpts } = options || {};
-    const opts = { ...DEFAULT_BUILD_OPTIONS, header: false, ...buildOpts };
-    if (data.length === 0)
-        return '';
-    let processedData = data;
-    if (sanitize) {
-        processedData = data.map((row) => sanitizeCsvArray(row));
-    }
-    const dsv = dsvFormat(opts.delimiter ?? ',');
-    let result = dsv.formatRows(processedData);
-    if (opts.newline && opts.newline !== '\n') {
-        result = result.replace(/\n/g, opts.newline);
-    }
-    return result;
+* Build CSV string from array of arrays
+*
+* SECURITY: Set sanitize=true when data may contain user-controlled content
+* to prevent CSV formula injection attacks in Excel/LibreOffice.
+*
+* @param data - Array of arrays to convert to CSV
+* @param options - Optional build configuration and sanitize flag
+* @returns CSV string
+*/
+function buildCsvArray(data, options) {
+	const { sanitize, ...buildOpts } = options || {};
+	const opts = {
+		...DEFAULT_BUILD_OPTIONS,
+		header: false,
+		...buildOpts
+	};
+	if (data.length === 0) return "";
+	let processedData = data;
+	if (sanitize) processedData = data.map((row) => sanitizeCsvArray(row));
+	let result = dsvFormat(opts.delimiter ?? ",").formatRows(processedData);
+	if (opts.newline && opts.newline !== "\n") result = result.replace(/\n/g, opts.newline);
+	return result;
 }
 /**
- * Validate CSV format
- * @param csv - CSV string to validate
- * @returns True if valid CSV, false otherwise
- */
-export function isValidCsv(csv) {
-    if (!csv || csv.trim().length === 0)
-        return false;
-    const trimmed = csv.trim();
-    // CSV must have at least one delimiter (comma) to be considered CSV structure
-    if (!trimmed.includes(','))
-        return false;
-    try {
-        validateQuoting(trimmed);
-    }
-    catch {
-        return false;
-    }
-    return true;
+* Validate CSV format
+* @param csv - CSV string to validate
+* @returns True if valid CSV, false otherwise
+*/
+function isValidCsv(csv) {
+	if (!csv || csv.trim().length === 0) return false;
+	const trimmed = csv.trim();
+	if (!trimmed.includes(",")) return false;
+	try {
+		validateQuoting(trimmed);
+	} catch {
+		return false;
+	}
+	return true;
 }
 /**
- * Sanitize a single CSV value to prevent formula injection
- *
- * Prefixes values starting with =, +, -, @, |, or % with a single quote
- * to prevent Excel/LibreOffice from interpreting them as formulas.
- *
- * @param value - Value to sanitize
- * @returns Sanitized value
- */
-export function sanitizeCsvValue(value) {
-    const str = String(value);
-    // Check if string starts with formula trigger characters
-    if (/^[=+\-@|%]/.test(str)) {
-        return `'${str}`;
-    }
-    return str;
+* Sanitize a single CSV value to prevent formula injection
+*
+* Prefixes values starting with =, +, -, @, |, or % with a single quote
+* to prevent Excel/LibreOffice from interpreting them as formulas.
+*
+* @param value - Value to sanitize
+* @returns Sanitized value
+*/
+function sanitizeCsvValue(value) {
+	const str = String(value);
+	if (/^[=+\-@|%]/.test(str)) return `'${str}`;
+	return str;
 }
 /**
- * Sanitize all values in an array to prevent formula injection
- *
- * @param values - Array of values to sanitize
- * @returns Array with sanitized values
- */
-export function sanitizeCsvArray(values) {
-    return values.map(sanitizeCsvValue);
+* Sanitize all values in an array to prevent formula injection
+*
+* @param values - Array of values to sanitize
+* @returns Array with sanitized values
+*/
+function sanitizeCsvArray(values) {
+	return values.map(sanitizeCsvValue);
 }
 /**
- * Sanitize all values in an object to prevent formula injection
- *
- * @param obj - Object with values to sanitize
- * @returns New object with sanitized values
- */
-export function sanitizeCsvObject(obj) {
-    const sanitized = {};
-    for (const [key, value] of Object.entries(obj)) {
-        sanitized[key] = sanitizeCsvValue(value);
-    }
-    return sanitized;
+* Sanitize all values in an object to prevent formula injection
+*
+* @param obj - Object with values to sanitize
+* @returns New object with sanitized values
+*/
+function sanitizeCsvObject(obj) {
+	const sanitized = {};
+	for (const [key, value] of Object.entries(obj)) sanitized[key] = sanitizeCsvValue(value);
+	return sanitized;
 }
+//#endregion
+export { buildCsv, buildCsvArray, extractColumn as extractCsvColumn, findRows as findCsvRows, isValidCsv, parseCsv, parseCsvArray, sanitizeCsvArray, sanitizeCsvObject, sanitizeCsvValue };
+
 //# sourceMappingURL=index.js.map