Merge 51771de into bf81dc8

Author: nao1215

.golangci.yml

@@ -72,10 +72,6 @@ linters:
           - gochecknoinits
         path: filesql\.go
         source: func init\(\)
-      - linters:
-          - staticcheck
-        path: driver/.*\.go
-        text: SA1019.*deprecated.*Go 1.8
       - path: (.+)\.go$
         text: fmt.Fprintf
       - path: (.+)\.go$

CONTRIBUTING.md

@@ -70,7 +70,6 @@ filesql/
 ├── domain/          # Domain model layer
 │   ├── model/      # Domain model definitions
 │   └── repository/ # Repository interfaces
-├── driver/         # SQLite driver implementation
 ├── testdata/       # Test data files
 ├── doc/            # Documentation
 │   ├── ja/        # Japanese documentation
@@ -85,7 +84,6 @@ filesql/
 ### Directory Roles
 
 - **domain/**: Layer containing business logic and domain models. Pure Go implementation without external dependencies
-- **driver/**: SQLite driver interface and implementation. Provides database/sql compatible driver
 - **testdata/**: Sample files such as CSV, TSV, LTSV used in tests
 - **doc/**: Multi-language documentation with subdirectories for each language
 

README.md

@@ -20,6 +20,8 @@ Rather than maintaining duplicate code across both projects, we extracted the co
 - 🔍 **SQLite3 SQL Interface** - Use SQLite3's powerful SQL dialect to query your files
 - 📁 **Multiple File Formats** - Support for CSV, TSV, and LTSV files
 - 🗜️ **Compression Support** - Automatically handles .gz, .bz2, .xz, and .zst compressed files
+- 🌊 **Stream Processing** - Efficiently handles large files through streaming with configurable chunk sizes
+- 📖 **Flexible Input Sources** - Support for file paths, directories, io.Reader, and embed.FS
 - 🚀 **Zero Setup** - No database server required, everything runs in-memory
 - 🌍 **Cross-Platform** - Works seamlessly on Linux, macOS, and Windows
 - 💾 **SQLite3 Powered** - Built on the robust SQLite3 engine for reliable SQL processing
@@ -374,6 +376,39 @@ if err != nil {
 }
 ```
 
+#### Auto-Save Input Type Restrictions
+
+**Important**: Auto-save behavior depends on your input data source:
+
+- **File Paths** (`AddPath`, `AddPaths`): Supports both overwrite mode (empty string) and output directory
+  ```go
+  // ✅ Overwrite original files
+  builder.AddPath("data.csv").EnableAutoSave("")
+  
+  // ✅ Save to output directory  
+  builder.AddPath("data.csv").EnableAutoSave("./backup")
+  ```
+
+- **io.Reader** (`AddReader`): **Only supports output directory mode**
+  ```go
+  // ❌ Build error - overwrite mode not supported
+  builder.AddReader(reader, "table", model.FileTypeCSV).EnableAutoSave("")
+  
+  // ✅ Must specify output directory
+  builder.AddReader(reader, "table", model.FileTypeCSV).EnableAutoSave("./output")
+  ```
+
+- **Filesystems** (`AddFS`): **Only supports output directory mode**
+  ```go
+  // ❌ Build error - overwrite mode not supported  
+  builder.AddFS(filesystem).EnableAutoSave("")
+  
+  // ✅ Must specify output directory
+  builder.AddFS(filesystem).EnableAutoSave("./output")
+  ```
+
+This restriction exists because io.Reader and filesystem inputs don't have original file paths that can be overwritten. The builder will return an error at build time if you try to use overwrite mode with these input types.
+
 ### Manual Data Export (Alternative to Auto-Save)
 
 If you prefer manual control over when to save changes to files instead of using auto-save: