@rastr/export-csv 0.0.0-stage → 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ondřej Synek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @rastr/export-csv
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CSV export of a Rastr grid without dependencies: the grid's whole current result (filter, search,
+sort — not just the page) with the visible columns in their order.
+
+- UTF-8 with a BOM, so Excel reads diacritics; lines end with CRLF.
+- Separator by locale: `;` where the locale writes decimal commas (`cs`), `,` otherwise.
+- Numbers without thousands separators, with the locale's decimal separator, in full precision.
+- `date` → `yyyy-MM-dd`, `datetime` → `yyyy-MM-dd HH:mm` in local time (Excel reads ISO in any locale).
+- Booleans, lookups and columns with a `format` function → the grid's text.
+- Text starting with `=`, `+`, `-`, `@`, tab or CR gets a leading `'` (CSV injection); numbers are
+  never changed. Fields with the separator, quotes, line breaks or edge spaces are quoted.
+
+```ts
+createGrid(el, {
+  store,
+  columns,
+  export: { fileName: 'Objednavky', formats: { xlsx: () => import('@rastr/export-xlsx'), csv: () => import('@rastr/export-csv') } },
+});
+```
+
+`buildCsv(exportColumns(store, columns, locale, messages), rows, locale)` builds the text without
+the grid's toolbar.

package/dist/index.cjs

@@ -0,0 +1,118 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CSV_MIME: () => CSV_MIME,
+  DEFAULT_MAX_ROWS: () => DEFAULT_MAX_ROWS,
+  buildCsv: () => buildCsv,
+  csvSeparator: () => csvSeparator,
+  exportGrid: () => exportGrid,
+  extension: () => extension,
+  format: () => format,
+  toCsvField: () => toCsvField,
+  toCsvValue: () => toCsvValue
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/csv.ts
+var import_grid = require("@rastr/grid");
+var DEFAULT_MAX_ROWS = 1e5;
+var CSV_MIME = "text/csv;charset=utf-8";
+var ROWS_PER_BATCH = 2e3;
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})/;
+var FORMULA_START = /^[=+\-@\t\r]/;
+var pad = (value) => String(value).padStart(2, "0");
+function csvSeparator(locale) {
+  const decimal = new Intl.NumberFormat(locale).formatToParts(1.5).find((part) => part.type === "decimal")?.value;
+  return decimal === "," ? ";" : ",";
+}
+function decimalSeparator(locale) {
+  return new Intl.NumberFormat(locale).formatToParts(1.5).find((part) => part.type === "decimal")?.value ?? ".";
+}
+function toCsvField(value, separator) {
+  const needsQuotes = value.includes(separator) || /["\r\n]/.test(value) || value !== value.trim();
+  return needsQuotes ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function localDate(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+function toCsvValue(row, column, locale) {
+  const value = column.value(row);
+  if (value === null || value === void 0 || value === "") return "";
+  if (column.kind === "number" && typeof value === "number" && Number.isFinite(value)) {
+    return String(value).replace(".", decimalSeparator(locale));
+  }
+  if (column.kind === "date") {
+    const match = typeof value === "string" ? ISO_DATE.exec(value) : null;
+    if (match) return `${match[1]}-${match[2]}-${match[3]}`;
+    const date = localDate(value);
+    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+  }
+  if (column.kind === "datetime") {
+    const date = localDate(value);
+    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+  }
+  const text = column.text(row);
+  return FORMULA_START.test(text) ? `'${text}` : text;
+}
+function buildCsv(columns, rows, locale) {
+  return `\uFEFF${headerLine(columns, csvSeparator(locale))}${rowLines(columns, rows, locale)}`;
+}
+function headerLine(columns, separator) {
+  return `${columns.map((c) => toCsvField(c.caption, separator)).join(separator)}\r
+`;
+}
+function rowLines(columns, rows, locale) {
+  const separator = csvSeparator(locale);
+  let text = "";
+  for (const row of rows) text += `${columns.map((c) => toCsvField(toCsvValue(row, c, locale), separator)).join(separator)}\r
+`;
+  return text;
+}
+var yieldToEventLoop = () => new Promise((resolve) => setTimeout(resolve, 0));
+async function exportGrid(store, columns, options = {}) {
+  const locale = options.locale ?? "cs";
+  const messages = (0, import_grid.resolveMessages)(locale, options.messages);
+  const visible = (0, import_grid.exportColumns)(store, columns, locale, messages);
+  const rows = await (0, import_grid.loadExportRows)(store, options.maxRows ?? DEFAULT_MAX_ROWS);
+  const parts = [`\uFEFF${headerLine(visible, csvSeparator(locale))}`];
+  for (let start = 0; start < rows.length; start += ROWS_PER_BATCH) {
+    parts.push(rowLines(visible, rows.slice(start, start + ROWS_PER_BATCH), locale));
+    await yieldToEventLoop();
+  }
+  return new Blob(parts, { type: CSV_MIME });
+}
+var format = "csv";
+var extension = "csv";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CSV_MIME,
+  DEFAULT_MAX_ROWS,
+  buildCsv,
+  csvSeparator,
+  exportGrid,
+  extension,
+  format,
+  toCsvField,
+  toCsvValue
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/csv.ts"],"sourcesContent":["export { buildCsv, CSV_MIME, csvSeparator, DEFAULT_MAX_ROWS, exportGrid, extension, format, toCsvField, toCsvValue } from './csv';\n","import type { GridStore } from '@rastr/core';\nimport { exportColumns, loadExportRows, resolveMessages } from '@rastr/grid';\nimport type { ExportColumn, ExportRunOptions, GridColumn, Messages } from '@rastr/grid';\n\nexport const DEFAULT_MAX_ROWS: number = 100_000;\nexport const CSV_MIME: string = 'text/csv;charset=utf-8';\nconst ROWS_PER_BATCH: number = 2000;\nconst ISO_DATE: RegExp = /^(\\d{4})-(\\d{2})-(\\d{2})/;\n/** Text starting with these is read as a formula by spreadsheet apps (OWASP CSV injection). */\nconst FORMULA_START: RegExp = /^[=+\\-@\\t\\r]/;\n\nconst pad = (value: number): string => String(value).padStart(2, '0');\n\n/** ';' where the locale writes decimal commas (Excel's list separator there), otherwise ','. */\nexport function csvSeparator(locale: string): ';' | ',' {\n  const decimal: string | undefined = new Intl.NumberFormat(locale).formatToParts(1.5).find(part => part.type === 'decimal')?.value;\n  return decimal === ',' ? ';' : ',';\n}\n\nfunction decimalSeparator(locale: string): string {\n  return new Intl.NumberFormat(locale).formatToParts(1.5).find(part => part.type === 'decimal')?.value ?? '.';\n}\n\n/** Quotes a field when it contains the separator, a quote, a line break or edge spaces. */\nexport function toCsvField(value: string, separator: string): string {\n  const needsQuotes: boolean = value.includes(separator) || /[\"\\r\\n]/.test(value) || value !== value.trim();\n  return needsQuotes ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n}\n\nfunction localDate(value: unknown): Date | null {\n  const date: Date = value instanceof Date ? value : new Date(value as string | number);\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/** One cell as CSV text (unquoted): typed values in a locale-neutral form, the rest as the grid's text. */\nexport function toCsvValue<TRow>(row: TRow, column: ExportColumn<TRow>, locale: string): string {\n  const value: unknown = column.value(row);\n  if (value === null || value === undefined || value === '') return '';\n  if (column.kind === 'number' && typeof value === 'number' && Number.isFinite(value)) {\n    // Full precision, no grouping; the decimal separator Excel expects in this locale.\n    return String(value).replace('.', decimalSeparator(locale));\n  }\n  if (column.kind === 'date') {\n    const match: RegExpExecArray | null = typeof value === 'string' ? ISO_DATE.exec(value) : null;\n    if (match) return `${match[1]}-${match[2]}-${match[3]}`;\n    const date: Date | null = localDate(value);\n    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;\n  }\n  if (column.kind === 'datetime') {\n    const date: Date | null = localDate(value);\n    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;\n  }\n  const text: string = column.text(row);\n  return FORMULA_START.test(text) ? `'${text}` : text;\n}\n\n/** BOM (so Excel reads UTF-8), header of captions, one line per row, CRLF line ends. */\nexport function buildCsv<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string {\n  return `\\uFEFF${headerLine(columns, csvSeparator(locale))}${rowLines(columns, rows, locale)}`;\n}\n\nfunction headerLine<TRow>(columns: readonly ExportColumn<TRow>[], separator: string): string {\n  return `${columns.map(c => toCsvField(c.caption, separator)).join(separator)}\\r\\n`;\n}\n\nfunction rowLines<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string {\n  const separator: string = csvSeparator(locale);\n  let text: string = '';\n  for (const row of rows) text += `${columns.map(c => toCsvField(toCsvValue(row, c, locale), separator)).join(separator)}\\r\\n`;\n  return text;\n}\n\nconst yieldToEventLoop = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));\n\n/** Exports the grid's current result (filter, search, sort; not the page) with the visible columns. */\nexport async function exportGrid<TRow>(store: GridStore<TRow>, columns: readonly GridColumn<TRow>[], options: Partial<ExportRunOptions> = {}): Promise<Blob> {\n  const locale: string = options.locale ?? 'cs';\n  const messages: Messages = resolveMessages(locale, options.messages);\n  const visible: ExportColumn<TRow>[] = exportColumns(store, columns, locale, messages);\n  const rows: TRow[] = await loadExportRows(store, options.maxRows ?? DEFAULT_MAX_ROWS);\n  const parts: string[] = [`\\uFEFF${headerLine(visible, csvSeparator(locale))}`];\n  for (let start: number = 0; start < rows.length; start += ROWS_PER_BATCH) {\n    parts.push(rowLines(visible, rows.slice(start, start + ROWS_PER_BATCH), locale));\n    await yieldToEventLoop();\n  }\n  return new Blob(parts, { type: CSV_MIME });\n}\n\n/** ExportModule identity for the grid's export menu. */\nexport const format = 'csv' as const;\nexport const extension: string = 'csv';\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import { GridStore } from '@rastr/core';
+import { ExportColumn, GridColumn, ExportRunOptions } from '@rastr/grid';
+
+declare const DEFAULT_MAX_ROWS: number;
+declare const CSV_MIME: string;
+/** ';' where the locale writes decimal commas (Excel's list separator there), otherwise ','. */
+declare function csvSeparator(locale: string): ';' | ',';
+/** Quotes a field when it contains the separator, a quote, a line break or edge spaces. */
+declare function toCsvField(value: string, separator: string): string;
+/** One cell as CSV text (unquoted): typed values in a locale-neutral form, the rest as the grid's text. */
+declare function toCsvValue<TRow>(row: TRow, column: ExportColumn<TRow>, locale: string): string;
+/** BOM (so Excel reads UTF-8), header of captions, one line per row, CRLF line ends. */
+declare function buildCsv<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string;
+/** Exports the grid's current result (filter, search, sort; not the page) with the visible columns. */
+declare function exportGrid<TRow>(store: GridStore<TRow>, columns: readonly GridColumn<TRow>[], options?: Partial<ExportRunOptions>): Promise<Blob>;
+/** ExportModule identity for the grid's export menu. */
+declare const format: "csv";
+declare const extension: string;
+
+export { CSV_MIME, DEFAULT_MAX_ROWS, buildCsv, csvSeparator, exportGrid, extension, format, toCsvField, toCsvValue };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { GridStore } from '@rastr/core';
+import { ExportColumn, GridColumn, ExportRunOptions } from '@rastr/grid';
+
+declare const DEFAULT_MAX_ROWS: number;
+declare const CSV_MIME: string;
+/** ';' where the locale writes decimal commas (Excel's list separator there), otherwise ','. */
+declare function csvSeparator(locale: string): ';' | ',';
+/** Quotes a field when it contains the separator, a quote, a line break or edge spaces. */
+declare function toCsvField(value: string, separator: string): string;
+/** One cell as CSV text (unquoted): typed values in a locale-neutral form, the rest as the grid's text. */
+declare function toCsvValue<TRow>(row: TRow, column: ExportColumn<TRow>, locale: string): string;
+/** BOM (so Excel reads UTF-8), header of captions, one line per row, CRLF line ends. */
+declare function buildCsv<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string;
+/** Exports the grid's current result (filter, search, sort; not the page) with the visible columns. */
+declare function exportGrid<TRow>(store: GridStore<TRow>, columns: readonly GridColumn<TRow>[], options?: Partial<ExportRunOptions>): Promise<Blob>;
+/** ExportModule identity for the grid's export menu. */
+declare const format: "csv";
+declare const extension: string;
+
+export { CSV_MIME, DEFAULT_MAX_ROWS, buildCsv, csvSeparator, exportGrid, extension, format, toCsvField, toCsvValue };

package/dist/index.js

@@ -0,0 +1,83 @@
+// src/csv.ts
+import { exportColumns, loadExportRows, resolveMessages } from "@rastr/grid";
+var DEFAULT_MAX_ROWS = 1e5;
+var CSV_MIME = "text/csv;charset=utf-8";
+var ROWS_PER_BATCH = 2e3;
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})/;
+var FORMULA_START = /^[=+\-@\t\r]/;
+var pad = (value) => String(value).padStart(2, "0");
+function csvSeparator(locale) {
+  const decimal = new Intl.NumberFormat(locale).formatToParts(1.5).find((part) => part.type === "decimal")?.value;
+  return decimal === "," ? ";" : ",";
+}
+function decimalSeparator(locale) {
+  return new Intl.NumberFormat(locale).formatToParts(1.5).find((part) => part.type === "decimal")?.value ?? ".";
+}
+function toCsvField(value, separator) {
+  const needsQuotes = value.includes(separator) || /["\r\n]/.test(value) || value !== value.trim();
+  return needsQuotes ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function localDate(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+function toCsvValue(row, column, locale) {
+  const value = column.value(row);
+  if (value === null || value === void 0 || value === "") return "";
+  if (column.kind === "number" && typeof value === "number" && Number.isFinite(value)) {
+    return String(value).replace(".", decimalSeparator(locale));
+  }
+  if (column.kind === "date") {
+    const match = typeof value === "string" ? ISO_DATE.exec(value) : null;
+    if (match) return `${match[1]}-${match[2]}-${match[3]}`;
+    const date = localDate(value);
+    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+  }
+  if (column.kind === "datetime") {
+    const date = localDate(value);
+    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+  }
+  const text = column.text(row);
+  return FORMULA_START.test(text) ? `'${text}` : text;
+}
+function buildCsv(columns, rows, locale) {
+  return `\uFEFF${headerLine(columns, csvSeparator(locale))}${rowLines(columns, rows, locale)}`;
+}
+function headerLine(columns, separator) {
+  return `${columns.map((c) => toCsvField(c.caption, separator)).join(separator)}\r
+`;
+}
+function rowLines(columns, rows, locale) {
+  const separator = csvSeparator(locale);
+  let text = "";
+  for (const row of rows) text += `${columns.map((c) => toCsvField(toCsvValue(row, c, locale), separator)).join(separator)}\r
+`;
+  return text;
+}
+var yieldToEventLoop = () => new Promise((resolve) => setTimeout(resolve, 0));
+async function exportGrid(store, columns, options = {}) {
+  const locale = options.locale ?? "cs";
+  const messages = resolveMessages(locale, options.messages);
+  const visible = exportColumns(store, columns, locale, messages);
+  const rows = await loadExportRows(store, options.maxRows ?? DEFAULT_MAX_ROWS);
+  const parts = [`\uFEFF${headerLine(visible, csvSeparator(locale))}`];
+  for (let start = 0; start < rows.length; start += ROWS_PER_BATCH) {
+    parts.push(rowLines(visible, rows.slice(start, start + ROWS_PER_BATCH), locale));
+    await yieldToEventLoop();
+  }
+  return new Blob(parts, { type: CSV_MIME });
+}
+var format = "csv";
+var extension = "csv";
+export {
+  CSV_MIME,
+  DEFAULT_MAX_ROWS,
+  buildCsv,
+  csvSeparator,
+  exportGrid,
+  extension,
+  format,
+  toCsvField,
+  toCsvValue
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/csv.ts"],"sourcesContent":["import type { GridStore } from '@rastr/core';\nimport { exportColumns, loadExportRows, resolveMessages } from '@rastr/grid';\nimport type { ExportColumn, ExportRunOptions, GridColumn, Messages } from '@rastr/grid';\n\nexport const DEFAULT_MAX_ROWS: number = 100_000;\nexport const CSV_MIME: string = 'text/csv;charset=utf-8';\nconst ROWS_PER_BATCH: number = 2000;\nconst ISO_DATE: RegExp = /^(\\d{4})-(\\d{2})-(\\d{2})/;\n/** Text starting with these is read as a formula by spreadsheet apps (OWASP CSV injection). */\nconst FORMULA_START: RegExp = /^[=+\\-@\\t\\r]/;\n\nconst pad = (value: number): string => String(value).padStart(2, '0');\n\n/** ';' where the locale writes decimal commas (Excel's list separator there), otherwise ','. */\nexport function csvSeparator(locale: string): ';' | ',' {\n  const decimal: string | undefined = new Intl.NumberFormat(locale).formatToParts(1.5).find(part => part.type === 'decimal')?.value;\n  return decimal === ',' ? ';' : ',';\n}\n\nfunction decimalSeparator(locale: string): string {\n  return new Intl.NumberFormat(locale).formatToParts(1.5).find(part => part.type === 'decimal')?.value ?? '.';\n}\n\n/** Quotes a field when it contains the separator, a quote, a line break or edge spaces. */\nexport function toCsvField(value: string, separator: string): string {\n  const needsQuotes: boolean = value.includes(separator) || /[\"\\r\\n]/.test(value) || value !== value.trim();\n  return needsQuotes ? `\"${value.replace(/\"/g, '\"\"')}\"` : value;\n}\n\nfunction localDate(value: unknown): Date | null {\n  const date: Date = value instanceof Date ? value : new Date(value as string | number);\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/** One cell as CSV text (unquoted): typed values in a locale-neutral form, the rest as the grid's text. */\nexport function toCsvValue<TRow>(row: TRow, column: ExportColumn<TRow>, locale: string): string {\n  const value: unknown = column.value(row);\n  if (value === null || value === undefined || value === '') return '';\n  if (column.kind === 'number' && typeof value === 'number' && Number.isFinite(value)) {\n    // Full precision, no grouping; the decimal separator Excel expects in this locale.\n    return String(value).replace('.', decimalSeparator(locale));\n  }\n  if (column.kind === 'date') {\n    const match: RegExpExecArray | null = typeof value === 'string' ? ISO_DATE.exec(value) : null;\n    if (match) return `${match[1]}-${match[2]}-${match[3]}`;\n    const date: Date | null = localDate(value);\n    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;\n  }\n  if (column.kind === 'datetime') {\n    const date: Date | null = localDate(value);\n    if (date) return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;\n  }\n  const text: string = column.text(row);\n  return FORMULA_START.test(text) ? `'${text}` : text;\n}\n\n/** BOM (so Excel reads UTF-8), header of captions, one line per row, CRLF line ends. */\nexport function buildCsv<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string {\n  return `\\uFEFF${headerLine(columns, csvSeparator(locale))}${rowLines(columns, rows, locale)}`;\n}\n\nfunction headerLine<TRow>(columns: readonly ExportColumn<TRow>[], separator: string): string {\n  return `${columns.map(c => toCsvField(c.caption, separator)).join(separator)}\\r\\n`;\n}\n\nfunction rowLines<TRow>(columns: readonly ExportColumn<TRow>[], rows: readonly TRow[], locale: string): string {\n  const separator: string = csvSeparator(locale);\n  let text: string = '';\n  for (const row of rows) text += `${columns.map(c => toCsvField(toCsvValue(row, c, locale), separator)).join(separator)}\\r\\n`;\n  return text;\n}\n\nconst yieldToEventLoop = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));\n\n/** Exports the grid's current result (filter, search, sort; not the page) with the visible columns. */\nexport async function exportGrid<TRow>(store: GridStore<TRow>, columns: readonly GridColumn<TRow>[], options: Partial<ExportRunOptions> = {}): Promise<Blob> {\n  const locale: string = options.locale ?? 'cs';\n  const messages: Messages = resolveMessages(locale, options.messages);\n  const visible: ExportColumn<TRow>[] = exportColumns(store, columns, locale, messages);\n  const rows: TRow[] = await loadExportRows(store, options.maxRows ?? DEFAULT_MAX_ROWS);\n  const parts: string[] = [`\\uFEFF${headerLine(visible, csvSeparator(locale))}`];\n  for (let start: number = 0; start < rows.length; start += ROWS_PER_BATCH) {\n    parts.push(rowLines(visible, rows.slice(start, start + ROWS_PER_BATCH), locale));\n    await yieldToEventLoop();\n  }\n  return new Blob(parts, { type: CSV_MIME });\n}\n\n/** ExportModule identity for the grid's export menu. */\nexport const format = 'csv' as const;\nexport const extension: string = 'csv';\n"],"mappings":";AACA,SAAS,eAAe,gBAAgB,uBAAuB;AAGxD,IAAM,mBAA2B;AACjC,IAAM,WAAmB;AAChC,IAAM,iBAAyB;AAC/B,IAAM,WAAmB;AAEzB,IAAM,gBAAwB;AAE9B,IAAM,MAAM,CAAC,UAA0B,OAAO,KAAK,EAAE,SAAS,GAAG,GAAG;AAG7D,SAAS,aAAa,QAA2B;AACtD,QAAM,UAA8B,IAAI,KAAK,aAAa,MAAM,EAAE,cAAc,GAAG,EAAE,KAAK,UAAQ,KAAK,SAAS,SAAS,GAAG;AAC5H,SAAO,YAAY,MAAM,MAAM;AACjC;AAEA,SAAS,iBAAiB,QAAwB;AAChD,SAAO,IAAI,KAAK,aAAa,MAAM,EAAE,cAAc,GAAG,EAAE,KAAK,UAAQ,KAAK,SAAS,SAAS,GAAG,SAAS;AAC1G;AAGO,SAAS,WAAW,OAAe,WAA2B;AACnE,QAAM,cAAuB,MAAM,SAAS,SAAS,KAAK,UAAU,KAAK,KAAK,KAAK,UAAU,MAAM,KAAK;AACxG,SAAO,cAAc,IAAI,MAAM,QAAQ,MAAM,IAAI,CAAC,MAAM;AAC1D;AAEA,SAAS,UAAU,OAA6B;AAC9C,QAAM,OAAa,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAwB;AACpF,SAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,OAAO;AAC/C;AAGO,SAAS,WAAiB,KAAW,QAA4B,QAAwB;AAC9F,QAAM,QAAiB,OAAO,MAAM,GAAG;AACvC,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,GAAI,QAAO;AAClE,MAAI,OAAO,SAAS,YAAY,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG;AAEnF,WAAO,OAAO,KAAK,EAAE,QAAQ,KAAK,iBAAiB,MAAM,CAAC;AAAA,EAC5D;AACA,MAAI,OAAO,SAAS,QAAQ;AAC1B,UAAM,QAAgC,OAAO,UAAU,WAAW,SAAS,KAAK,KAAK,IAAI;AACzF,QAAI,MAAO,QAAO,GAAG,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AACrD,UAAM,OAAoB,UAAU,KAAK;AACzC,QAAI,KAAM,QAAO,GAAG,KAAK,YAAY,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC;AAAA,EAC3F;AACA,MAAI,OAAO,SAAS,YAAY;AAC9B,UAAM,OAAoB,UAAU,KAAK;AACzC,QAAI,KAAM,QAAO,GAAG,KAAK,YAAY,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC;AAAA,EAC7I;AACA,QAAM,OAAe,OAAO,KAAK,GAAG;AACpC,SAAO,cAAc,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK;AACjD;AAGO,SAAS,SAAe,SAAwC,MAAuB,QAAwB;AACpH,SAAO,SAAS,WAAW,SAAS,aAAa,MAAM,CAAC,CAAC,GAAG,SAAS,SAAS,MAAM,MAAM,CAAC;AAC7F;AAEA,SAAS,WAAiB,SAAwC,WAA2B;AAC3F,SAAO,GAAG,QAAQ,IAAI,OAAK,WAAW,EAAE,SAAS,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC;AAAA;AAC9E;AAEA,SAAS,SAAe,SAAwC,MAAuB,QAAwB;AAC7G,QAAM,YAAoB,aAAa,MAAM;AAC7C,MAAI,OAAe;AACnB,aAAW,OAAO,KAAM,SAAQ,GAAG,QAAQ,IAAI,OAAK,WAAW,WAAW,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC;AAAA;AACtH,SAAO;AACT;AAEA,IAAM,mBAAmB,MAAqB,IAAI,QAAQ,aAAW,WAAW,SAAS,CAAC,CAAC;AAG3F,eAAsB,WAAiB,OAAwB,SAAsC,UAAqC,CAAC,GAAkB;AAC3J,QAAM,SAAiB,QAAQ,UAAU;AACzC,QAAM,WAAqB,gBAAgB,QAAQ,QAAQ,QAAQ;AACnE,QAAM,UAAgC,cAAc,OAAO,SAAS,QAAQ,QAAQ;AACpF,QAAM,OAAe,MAAM,eAAe,OAAO,QAAQ,WAAW,gBAAgB;AACpF,QAAM,QAAkB,CAAC,SAAS,WAAW,SAAS,aAAa,MAAM,CAAC,CAAC,EAAE;AAC7E,WAAS,QAAgB,GAAG,QAAQ,KAAK,QAAQ,SAAS,gBAAgB;AACxE,UAAM,KAAK,SAAS,SAAS,KAAK,MAAM,OAAO,QAAQ,cAAc,GAAG,MAAM,CAAC;AAC/E,UAAM,iBAAiB;AAAA,EACzB;AACA,SAAO,IAAI,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAC3C;AAGO,IAAM,SAAS;AACf,IAAM,YAAoB;","names":[]}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@rastr/export-csv",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-beta.1",
+  "description": "CSV export of a Rastr grid without runtime dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@rastr/core": "0.1.0-beta.1",
+    "@rastr/grid": "0.1.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "jsdom": "^25",
+    "tsup": "^8",
+    "vitest": "^2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src test",
+    "typecheck": "tsc --noEmit"
+  }
 }