vue-csv-exporter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hunter
+
+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

@@ -0,0 +1,396 @@
+# vue-csv-exporter
+
+[![npm version](https://img.shields.io/npm/v/vue-csv-exporter.svg)](https://www.npmjs.com/package/vue-csv-exporter)
+[![license](https://img.shields.io/npm/l/vue-csv-exporter.svg)](https://github.com/7Hunter7/vue-csv-exporter/blob/main/LICENSE)
+[![downloads](https://img.shields.io/npm/dm/vue-csv-exporter.svg)](https://www.npmjs.com/package/vue-csv-exporter)
+[![vue2](https://img.shields.io/badge/vue-2.x-brightgreen.svg)](https://vuejs.org/)
+[![vue3](https://img.shields.io/badge/vue-3.x-brightgreen.svg)](https://v3.vuejs.org/)
+
+Простой и мощный экспорт данных в CSV для Vue.js приложений. 
+**Без зависимостей**, с поддержкой кириллицы и TypeScript.
+
+## Автор
+Ivan Kalugin Телеграмм: https://t.me/Ivan_Anatolievich_Kalugin
+
+## ✨ Особенности
+
+- 🚀 **Zero dependencies** - никаких лишних библиотек
+- 📦 **Tree shaking** - используйте только то, что нужно
+- 🌍 **Кириллица** - корректное отображение в Excel
+- 🎯 **RFC 4180** - соответствие стандарту CSV
+- 🔧 **Гибкая настройка** - разделители, кавычки, BOM
+- 📱 **Браузер** - работает в любой современном браузере
+- 🎨 **Vue 2 и 3** - поддержка обеих версий
+- 📄 **TypeScript** - готовые типы
+
+## Структура файлов
+```bash
+vue-csv-exporter/
+├── src/
+│   ├── index.js          # главный файл
+│   ├── CSVGenerator.js   # ядро
+│   └── exportMixin.js    # миксин
+├── README.md
+├── LICENSE
+└── package.json
+```
+
+## 📦 Установка
+
+```bash
+npm install vue-csv-exporter
+# или
+yarn add vue-csv-exporter
+```
+
+## 🚀 Быстрый старт
+1. Как плагин (рекомендуется)
+```bash
+// main.js
+import Vue from 'vue';
+import VueCSVExporter from 'vue-csv-exporter';
+
+Vue.use(VueCSVExporter, {
+  defaultFilename: 'export.csv',
+  defaultConfig: {
+    delimiter: ';',
+    includeBOM: true
+  }
+});
+
+// В компоненте
+export default {
+  methods: {
+    async exportData() {
+      try {
+        const count = await this.$csvExport({
+          data: this.items,
+          filename: 'users.csv',
+          onStart: () => console.log('Экспорт начат'),
+          onProgress: (progress) => console.log(`Прогресс: ${progress}%`),
+          onSuccess: (count) => this.$notify.success(`Экспортировано ${count} записей`),
+          onError: (error) => this.$notify.error(error.message)
+        });
+      } catch (error) {
+        console.error('Ошибка экспорта:', error);
+      }
+    }
+  }
+};
+```
+### Как миксин
+```bash
+import { exportMixin } from 'vue-csv-exporter';
+
+export default {
+  mixins: [exportMixin],
+  data() {
+    return {
+      users: [
+        { name: 'Иван', email: 'ivan@example.com' },
+        { name: 'Мария', email: 'maria@example.com' }
+      ]
+    };
+  },
+  methods: {
+    async exportUsers() {
+      await this.exportToCSV({
+        data: this.users,
+        filename: 'users.csv',
+        config: { delimiter: ',' }
+      });
+    }
+  }
+};
+```
+
+### Как отдельный класс
+```bash
+import { CSVGenerator } from 'vue-csv-exporter';
+
+// Генерация CSV
+const data = [
+  { name: 'Иван', age: 30 },
+  { name: 'Мария', age: 25 }
+];
+
+const csv = CSVGenerator.generate(data, {
+  delimiter: ';',
+  includeBOM: true
+});
+
+// Скачивание
+CSVGenerator.download(csv, 'export.csv');
+
+// Валидация
+const validation = CSVGenerator.validateData(data);
+if (validation.isValid) {
+  console.log('Данные корректны');
+}
+```
+
+## 📊 API Reference
+
+### Плагин Vue
+
+#### Опции плагина
+
+| Параметр | Тип | По умолчанию | Обязательный | Описание |
+|----------|-----|--------------|---------------|----------|
+| `defaultFilename` | `string` | `'export.csv'` | Нет | Имя файла по умолчанию для экспорта |
+| `defaultConfig` | `Object` | `{}` | Нет | Конфигурация CSV по умолчанию (см. таблицу Конфигурация) |
+| `install` | `Function` | - | Нет | Функция установки плагина (вызывается автоматически) |
+
+#### Методы плагина (`this.$csvExport()`)
+
+| Параметр | Тип | По умолчанию | Обязательный | Описание |
+|----------|-----|--------------|---------------|----------|
+| `data` | `Array<Object>` | - | **Да** | Массив данных для экспорта |
+| `filename` | `string` | `'export.csv'` | Нет | Имя выходного CSV файла |
+| `config` | `Object` | `{}` | Нет | Конфигурация CSV (переопределяет defaultConfig) |
+| `onStart` | `Function` | `() => {}` | Нет | Колбэк перед началом экспорта |
+| `onProgress` | `Function` | `() => {}` | Нет | Колбэк прогресса (0-100) |
+| `onSuccess` | `Function` | `() => {}` | Нет | Колбэк при успешном экспорте |
+| `onError` | `Function` | `() => {}` | Нет | Колбэк при ошибке |
+
+**Возвращает:** `Promise<number>` - количество экспортированных записей
+
+**Пример:**
+```javascript
+const count = await this.$csvExport({
+  data: this.users,
+  filename: 'users.csv',
+  config: { delimiter: ',' },
+  onStart: () => this.loading = true,
+  onProgress: (p) => this.progress = p,
+  onSuccess: (count) => this.showSuccess(count),
+  onError: (error) => this.showError(error)
+});
+```
+
+---
+
+### Миксин `exportMixin`
+
+#### Данные миксина
+
+| Поле | Тип | По умолчанию | Доступ | Описание |
+|------|-----|--------------|---------|----------|
+| `isExporting` | `boolean` | `false` | Только чтение | Флаг процесса экспорта |
+| `exportProgress` | `number` | `0` | Только чтение | Прогресс экспорта (0-100) |
+
+#### Методы миксина
+
+| Метод | Параметры | Возвращает | Описание |
+|-------|-----------|------------|----------|
+| `exportToCSV(options)` | `Object` (см. таблицу методов плагина) | `Promise<number>` | Основной метод экспорта |
+| `prepareExportData(data)` | `data: Array` | `Array` | Подготовка данных (можно переопределить) |
+| `transformData(data)` | `data: Array` | `Array` | Трансформация данных (можно переопределить) |
+| `generateDefaultFilename()` | - | `string` | Генерация имени файла по умолчанию |
+
+**Пример:**
+```javascript
+import { exportMixin } from 'vue-csv-exporter';
+
+export default {
+  mixins: [exportMixin],
+  data() {
+    return {
+      items: []
+    };
+  },
+  methods: {
+    async handleExport() {
+      if (this.isExporting) return;
+      
+      await this.exportToCSV({
+        data: this.items,
+        filename: 'export.csv'
+      });
+    },
+    // Переопределение метода подготовки данных
+    prepareExportData(data) {
+      return data.filter(item => item.active);
+    }
+  }
+};
+```
+
+---
+
+### Класс `CSVGenerator`
+
+#### Статические методы
+
+| Метод | Параметры | Возвращает | Описание |
+|-------|-----------|------------|----------|
+| `generate(data, config)` | `data: Array<Object>`<br>`config: Object` | `string` | Генерация CSV строки из данных |
+| `download(csv, filename)` | `csv: string`<br>`filename: string` | `void` | Скачивание CSV файла |
+| `validateData(data)` | `data: Array` | `{ isValid: boolean, error: string }` | Валидация данных перед экспортом |
+| `sanitizeField(field)` | `field: any` | `string` | Очистка поля от опасных символов |
+| `formatRow(fields, config)` | `fields: Array`<br>`config: Object` | `string` | Форматирование строки (приватный) |
+| `formatField(field, config)` | `field: any`<br>`config: Object` | `string` | Форматирование поля (приватный) |
+
+**Пример:**
+```javascript
+import { CSVGenerator } from 'vue-csv-exporter';
+
+// Валидация
+const validation = CSVGenerator.validateData(myData);
+if (!validation.isValid) {
+  console.error(validation.error);
+  return;
+}
+
+// Генерация
+const csv = CSVGenerator.generate(myData, {
+  delimiter: ';',
+  includeBOM: true
+});
+
+// Скачивание
+CSVGenerator.download(csv, 'report.csv');
+
+// Очистка поля
+const safeString = CSVGenerator.sanitizeField("Hello;World");
+```
+
+---
+
+### Конфигурация CSV
+
+#### Параметры конфигурации
+
+| Параметр | Тип | По умолчанию | Допустимые значения | Описание |
+|----------|-----|--------------|---------------------|----------|
+| `delimiter` | `string` | `';'` | `','`, `';'`, `'\t'`, любой символ | Разделитель полей в CSV |
+| `quote` | `string` | `'"'` | `'"'`, `"'"` | Символ для экранирования полей |
+| `lineBreak` | `string` | `'\r\n'` | `'\r\n'`, `'\n'`, `'\r'` | Разделитель строк |
+| `includeBOM` | `boolean` | `true` | `true`, `false` | Добавлять BOM для кириллицы |
+| `quoteAll` | `boolean` | `false` | `true`, `false` | Всегда заключать поля в кавычки |
+| `escapeDoubleQuotes` | `boolean` | `true` | `true`, `false` | Экранировать кавычки удвоением |
+
+#### Примеры конфигурации
+
+| Сценарий | Конфигурация | Результат |
+|----------|--------------|-----------|
+| **Excel (Россия)** | `{ delimiter: ';', includeBOM: true }` | Корректное отображение кириллицы в Excel |
+| **Excel (Запад)** | `{ delimiter: ',', includeBOM: false }` | Стандартный CSV для западных версий Excel |
+| **Максимальная совместимость** | `{ quoteAll: true, delimiter: ',' }` | Все поля в кавычках, никаких проблем с спецсимволами |
+| **Google Sheets** | `{ delimiter: ',', lineBreak: '\n' }` | Оптимально для импорта в Google Sheets |
+| **Базы данных** | `{ delimiter: '\t', quoteAll: false }` | TSV формат для импорта в БД |
+
+```javascript
+// Примеры использования разных конфигураций
+const configs = {
+  // Для Excel (русский)
+  russianExcel: {
+    delimiter: ';',
+    includeBOM: true,
+    quoteAll: false
+  },
+  
+  // Для Google Sheets
+  googleSheets: {
+    delimiter: ',',
+    lineBreak: '\n',
+    includeBOM: false
+  },
+  
+  // Максимальная защита
+  safe: {
+    delimiter: ',',
+    quoteAll: true,
+    escapeDoubleQuotes: true
+  },
+  
+  // TSV формат
+  tsv: {
+    delimiter: '\t',
+    quoteAll: false
+  }
+};
+```
+
+---
+
+### События и колбэки
+
+| Колбэк | Параметры | Момент вызова | Использование |
+|--------|-----------|---------------|---------------|
+| `onStart` | - | Перед началом экспорта | Показать лоадер, заблокировать UI |
+| `onProgress` | `progress: number` (0-100) | Во время экспорта | Обновить индикатор прогресса |
+| `onSuccess` | `count: number` | После успешного экспорта | Показать уведомление об успехе |
+| `onError` | `error: Error` | При ошибке | Показать сообщение об ошибке |
+
+```javascript
+// Пример с использованием всех колбэков
+this.$csvExport({
+  data: this.largeDataset,
+  filename: 'big_export.csv',
+  
+  onStart: () => {
+    this.isExporting = true;
+    this.showProgressBar = true;
+  },
+  
+  onProgress: (progress) => {
+    this.exportProgress = progress;
+  },
+  
+  onSuccess: (count) => {
+    this.$notify.success(`Успешно экспортировано ${count} записей`);
+    this.isExporting = false;
+    this.showProgressBar = false;
+  },
+  
+  onError: (error) => {
+    this.$notify.error(`Ошибка экспорта: ${error.message}`);
+    this.isExporting = false;
+    this.showProgressBar = false;
+  }
+});
+```
+
+---
+
+### Типы данных
+
+| Тип | Описание | Пример |
+|-----|----------|--------|
+| `CSVConfig` | Объект конфигурации | `{ delimiter: ';', includeBOM: true }` |
+| `ValidationResult` | Результат валидации | `{ isValid: true, error: '' }` |
+| `ExportOptions` | Опции экспорта | `{ data: [], filename: 'file.csv' }` |
+| `ProgressCallback` | Колбэк прогресса | `(progress) => console.log(progress)` |
+| `SuccessCallback` | Колбэк успеха | `(count) => console.log(count)` |
+| `ErrorCallback` | Колбэк ошибки | `(error) => console.error(error)` |
+
+```typescript
+// TypeScript интерфейсы (для справки)
+interface CSVConfig {
+  delimiter?: string;
+  quote?: string;
+  lineBreak?: string;
+  includeBOM?: boolean;
+  quoteAll?: boolean;
+  escapeDoubleQuotes?: boolean;
+}
+
+interface ExportOptions {
+  data: Record<string, any>[];
+  filename?: string;
+  config?: CSVConfig;
+  onStart?: () => void;
+  onProgress?: (progress: number) => void;
+  onSuccess?: (count: number) => void;
+  onError?: (error: Error) => void;
+}
+
+interface ValidationResult {
+  isValid: boolean;
+  error: string;
+}
+```
+## 📄 Лицензия
+
+MIT © [Ivan Kalugin](https://github.com/7Hunter7)

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "vue-csv-exporter",
+  "version": "1.0.0",
+  "description": "Простой и надежный экспорт данных в CSV для Vue.js. Без зависимостей, с поддержкой кириллицы и TypeScript.",
+  "main": "src/index.js",
+  "module": "src/index.js",
+  "browser": "src/index.js",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 0",
+    "prepublishOnly": "echo \"Ready to publish\""
+  },
+  "keywords": [
+    "vue",
+    "csv",
+    "exporter",
+    "export",
+    "vuejs",
+    "csv-exporter",
+    "vue-csv",
+    "russian",
+    "cyrillic",
+    "browser",
+    "no-dependencies"
+  ],
+  "author": {
+    "name": "Ivan Kalugin",
+    "email": "i.am.hunter.777.ih@gmail.com",
+    "url": "https://github.com/7Hunter7"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7Hunter7/vue-csv-exporter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/7Hunter7/vue-csv-exporter/issues"
+  },
+  "homepage": "https://github.com/7Hunter7/vue-csv-exporter#readme",
+  "peerDependencies": {
+    "vue": "^2.6.0 || ^3.0.0"
+  },
+  "engines": {
+    "node": ">=12.0.0"
+  }
+}

package/src/CSVGenerator.js

@@ -0,0 +1,220 @@
+/**
+ * vue-csv-exporter
+ * Без зависимостей, нативный генератор CSV для браузера
+ * Соответствует RFC 4180
+ * @module vue-csv-exporter
+ */
+
+/**
+ * Конфигурация по умолчанию
+ * @typedef {Object} CSVConfig
+ * @property {string} delimiter - Разделитель полей (по умолчанию ';')
+ * @property {string} quote - Символ кавычек (по умолчанию '"')
+ * @property {string} lineBreak - Разделитель строк (по умолчанию '\r\n')
+ * @property {boolean} includeBOM - Добавлять BOM для кириллицы (по умолчанию true)
+ * @property {boolean} quoteAll - Всегда заключать поля в кавычки (по умолчанию false)
+ * @property {boolean} escapeDoubleQuotes - Экранировать кавычки удвоением (по умолчанию true)
+ */
+
+/**
+ * Результат валидации
+ * @typedef {Object} ValidationResult
+ * @property {boolean} isValid - Валидны ли данные
+ * @property {string} error - Сообщение об ошибке
+ */
+
+class CSVGenerator {
+  /**
+   * Конфигурация по умолчанию
+   * @type {CSVConfig}
+   */
+  static defaultConfig = {
+    delimiter: ";",
+    quote: '"',
+    lineBreak: "\r\n",
+    includeBOM: true,
+    quoteAll: false,
+    escapeDoubleQuotes: true,
+  };
+
+  /**
+   * Генерация CSV из массива объектов
+   * @param {Array<Object>} data - Массив данных для экспорта
+   * @param {CSVConfig} config - Конфигурация генерации
+   * @returns {string} CSV строка
+   * @throws {Error} Если данные некорректны
+   *
+   * @example
+   * const csv = CSVGenerator.generate([
+   *   { name: 'Иван', age: 30 },
+   *   { name: 'Мария', age: 25 }
+   * ]);
+   */
+  static generate(data, config = {}) {
+    const validation = this.validateData(data);
+    if (!validation.isValid) {
+      throw new Error(`CSV generation failed: ${validation.error}`);
+    }
+
+    const cfg = { ...this.defaultConfig, ...config };
+
+    // Получаем заголовки из первого объекта
+    const headers = Object.keys(data[0]);
+
+    // Генерируем строки CSV
+    const rows = [
+      this.formatRow(headers, cfg),
+      ...data.map((item) => this.formatRow(Object.values(item), cfg)),
+    ];
+
+    let csv = rows.join(cfg.lineBreak);
+
+    // Добавляем BOM для правильного отображения кириллицы в Excel
+    if (cfg.includeBOM) {
+      csv = "\uFEFF" + csv;
+    }
+
+    return csv;
+  }
+
+  /**
+   * Форматирование одной строки CSV
+   * @private
+   * @param {Array} fields - Поля строки
+   * @param {CSVConfig} cfg - Конфигурация
+   * @returns {string} Отформатированная строка
+   */
+  static formatRow(fields, cfg) {
+    return fields
+      .map((field) => this.formatField(field, cfg))
+      .join(cfg.delimiter);
+  }
+
+  /**
+   * Форматирование отдельного поля
+   * @private
+   * @param {*} field - Значение поля
+   * @param {CSVConfig} cfg - Конфигурация
+   * @returns {string} Отформатированное поле
+   */
+  static formatField(field, cfg) {
+    let stringField =
+      field === null || field === undefined ? "" : String(field);
+
+    const needsQuoting =
+      cfg.quoteAll ||
+      stringField.includes(cfg.delimiter) ||
+      stringField.includes(cfg.quote) ||
+      stringField.includes("\n") ||
+      stringField.includes("\r");
+
+    if (needsQuoting) {
+      if (cfg.escapeDoubleQuotes) {
+        stringField = stringField.replace(
+          new RegExp(cfg.quote, "g"),
+          cfg.quote + cfg.quote,
+        );
+      }
+      return cfg.quote + stringField + cfg.quote;
+    }
+
+    return stringField;
+  }
+
+  /**
+   * Очистка поля от потенциально опасных символов
+   * @param {*} field - Поле для очистки
+   * @returns {string} Очищенное поле
+   *
+   * @example
+   * const safe = CSVGenerator.sanitizeField("Hello;World");
+   */
+  static sanitizeField(field) {
+    if (field === null || field === undefined) return "";
+
+    return String(field)
+      .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F]/g, " ")
+      .replace(/\s+/g, " ")
+      .trim();
+  }
+
+  /**
+   * Валидация данных перед экспортом
+   * @param {Array} data - Данные для проверки
+   * @returns {ValidationResult} Результат валидации
+   *
+   * @example
+   * const result = CSVGenerator.validateData(myData);
+   * if (result.isValid) {
+   *   // экспорт
+   * }
+   */
+  static validateData(data) {
+    if (!Array.isArray(data)) {
+      return {
+        isValid: false,
+        error: "Data must be an array",
+      };
+    }
+
+    if (data.length === 0) {
+      return {
+        isValid: false,
+        error: "No data to export",
+      };
+    }
+
+    const hasInvalidItem = data.some(
+      (item) => item === null || typeof item !== "object",
+    );
+
+    if (hasInvalidItem) {
+      return {
+        isValid: false,
+        error: "Data contains invalid items",
+      };
+    }
+
+    return { isValid: true };
+  }
+
+  /**
+   * Скачивание CSV файла
+   * @param {string} csv - CSV контент
+   * @param {string} filename - Имя файла
+   * @throws {Error} Если нет данных или ошибка скачивания
+   *
+   * @example
+   * CSVGenerator.download(csv, 'export.csv');
+   */
+  static download(csv, filename) {
+    if (!csv) {
+      throw new Error("No data to download");
+    }
+
+    try {
+      const blob = new Blob([csv], {
+        type: "text/csv;charset=utf-8;",
+      });
+
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement("a");
+
+      link.setAttribute("href", url);
+      link.setAttribute("download", filename);
+      link.setAttribute("target", "_blank");
+
+      document.body.appendChild(link);
+      link.click();
+
+      setTimeout(() => {
+        document.body.removeChild(link);
+        URL.revokeObjectURL(url);
+      }, 100);
+    } catch (error) {
+      throw new Error(`Failed to download CSV: ${error.message}`);
+    }
+  }
+}
+
+export default CSVGenerator;

package/src/exportMixin.js

@@ -0,0 +1,138 @@
+/**
+ * Vue миксин для экспорта данных в CSV
+ * @module vue-csv-exporter/mixin
+ */
+
+import CSVGenerator from "./CSVGenerator";
+
+/**
+ * @mixin exportMixin
+ * @property {boolean} isExporting - Флаг процесса экспорта
+ * @property {number} exportProgress - Прогресс экспорта (0-100)
+ */
+export const exportMixin = {
+  data() {
+    return {
+      isExporting: false,
+      exportProgress: 0,
+    };
+  },
+
+  methods: {
+    /**
+     * Экспорт данных в CSV файл
+     * @param {Object} options - Опции экспорта
+     * @param {Array} options.data - Данные для экспорта
+     * @param {string} options.filename - Имя файла
+     * @param {Object} options.config - Конфигурация CSV
+     * @param {Function} options.onStart - Колбэк перед началом
+     * @param {Function} options.onProgress - Колбэк прогресса
+     * @param {Function} options.onSuccess - Колбэк успеха
+     * @param {Function} options.onError - Колбэк ошибки
+     * @returns {Promise<void>}
+     *
+     * @example
+     * this.exportToCSV({
+     *   data: this.items,
+     *   filename: 'export.csv',
+     *   onSuccess: (count) => console.log(`Exported ${count} items`)
+     * });
+     */
+    async exportToCSV({
+      data,
+      filename = this.generateDefaultFilename(),
+      config = {},
+      onStart,
+      onProgress,
+      onSuccess,
+      onError,
+    } = {}) {
+      if (this.isExporting) {
+        this.$notify?.warning?.("Export already in progress", "Please wait");
+        return;
+      }
+
+      const exportData = this.prepareExportData(data);
+      const validation = CSVGenerator.validateData(exportData);
+
+      if (!validation.isValid) {
+        const error = new Error(validation.error);
+        onError?.(error);
+        throw error;
+      }
+
+      this.isExporting = true;
+      this.exportProgress = 0;
+
+      try {
+        onStart?.();
+
+        const transformedData = this.transformData(exportData);
+        this.exportProgress = 50;
+        onProgress?.(50);
+
+        const csv = CSVGenerator.generate(transformedData, config);
+        this.exportProgress = 90;
+        onProgress?.(90);
+
+        CSVGenerator.download(csv, filename);
+        this.exportProgress = 100;
+        onProgress?.(100);
+
+        onSuccess?.(exportData.length);
+
+        return exportData.length;
+      } catch (error) {
+        onError?.(error);
+        throw error;
+      } finally {
+        setTimeout(() => {
+          this.isExporting = false;
+          this.exportProgress = 0;
+        }, 1000);
+      }
+    },
+
+    /**
+     * Подготовка данных для экспорта
+     * @protected
+     * @param {Array} data - Исходные данные
+     * @returns {Array} Подготовленные данные
+     */
+    prepareExportData(data) {
+      return data?.map?.((item) => ({ ...item })) || [];
+    },
+
+    /**
+     * Трансформация данных для CSV формата
+     * @protected
+     * @param {Array} data - Подготовленные данные
+     * @returns {Array} Трансформированные данные
+     */
+    transformData(data) {
+      return data.map((item) => {
+        const transformed = {};
+        Object.keys(item).forEach((key) => {
+          transformed[key] = CSVGenerator.sanitizeField(item[key]);
+        });
+        return transformed;
+      });
+    },
+
+    /**
+     * Генерация имени файла по умолчанию
+     * @protected
+     * @returns {string} Имя файла
+     */
+    generateDefaultFilename() {
+      const date = new Date();
+      const year = date.getFullYear();
+      const month = String(date.getMonth() + 1).padStart(2, "0");
+      const day = String(date.getDate()).padStart(2, "0");
+
+      return `export_${year}-${month}-${day}.csv`;
+    },
+  },
+};
+
+export default exportMixin;

package/src/index.js

@@ -0,0 +1,75 @@
+/**
+ * vue-csv-exporter
+ * Простой и мощный экспорт данных в CSV для Vue.js приложений
+ *
+ * @module vue-csv-exporter
+ */
+
+import CSVGenerator from "./CSVGenerator";
+import exportMixin from "./exportMixin";
+
+/**
+ * Версия библиотеки
+ */
+export const VERSION = "1.0.0";
+
+/**
+ * Плагин для Vue.js
+ * @param {Vue} Vue - Конструктор Vue
+ * @param {Object} options - Опции плагина
+ *
+ * @example
+ * import Vue from 'vue';
+ * import VueCSVExporter from 'vue-csv-exporter';
+ *
+ * Vue.use(VueCSVExporter, {
+ *   defaultFilename: 'export.csv',
+ *   defaultConfig: { delimiter: ';' }
+ * });
+ */
+export function install(Vue, options = {}) {
+  if (install.installed) return;
+  install.installed = true;
+
+  const globalMixin = {
+    data() {
+      return {
+        $csvExporter: {
+          isExporting: false,
+          exportProgress: 0,
+        },
+      };
+    },
+    methods: {
+      $exportToCSV(config) {
+        return this.$csvExport(config);
+      },
+    },
+  };
+
+  Vue.mixin(globalMixin);
+
+  Vue.prototype.$csvExport = async function ({
+    data,
+    filename = options.defaultFilename,
+    config = options.defaultConfig,
+    ...callbacks
+  }) {
+    const mixin = new Vue(exportMixin);
+    return mixin.exportToCSV({ data, filename, config, ...callbacks });
+  };
+}
+
+// Автоматическая установка в браузере
+if (typeof window !== "undefined" && window.Vue) {
+  install(window.Vue);
+}
+
+export { CSVGenerator, exportMixin };
+
+export default {
+  install,
+  CSVGenerator,
+  exportMixin,
+  VERSION,
+};