Repository: glhd/linen
Branch: main
Commit: b427bdb64f1e
Files: 44
Total size: 74.2 KB

Directory structure:
gitextract_gpyxuo6q/

├── .gitattributes
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   └── workflows/
│       ├── php-cs-fixer.yml
│       ├── phpunit.yml
│       └── update-changelog.yml
├── .gitignore
├── .idea/
│   ├── .gitignore
│   ├── blade.xml
│   ├── inspectionProfiles/
│   │   └── Project_Default.xml
│   ├── laravel-idea.xml
│   ├── linen.iml
│   ├── modules.xml
│   ├── php-test-framework.xml
│   ├── php.xml
│   └── vcs.xml
├── .php-cs-fixer.dist.php
├── CHANGELOG.md
├── LICENSE
├── README.md
├── composer.json
├── config/
│   └── linen.php
├── ide.json
├── phpunit.xml.dist
├── src/
│   ├── CsvReader.php
│   ├── CsvWriter.php
│   ├── ExcelReader.php
│   ├── ExcelWriter.php
│   ├── Facades/
│   │   ├── .gitkeep
│   │   └── Linen.php
│   ├── Reader.php
│   ├── Support/
│   │   ├── FileTypeHelper.php
│   │   └── WriteIterator.php
│   ├── Writer.php
│   └── helpers.php
└── tests/
    ├── Feature/
    │   ├── CsvReaderTest.php
    │   ├── CsvWriterTest.php
    │   ├── ExcelReaderTest.php
    │   ├── ExcelWriterTest.php
    │   └── FacadeTest.php
    ├── TestCase.php
    └── fixtures/
        ├── basic.csv
        ├── basic.xlsx
        └── more-columns-than-headers.csv

================================================
FILE CONTENTS
================================================

================================================
FILE: .gitattributes
================================================
# This file was generated by the lean package validator (http://git.io/lean-package-validator).

* text=auto eol=lf

.codeclimate.yml export-ignore
.gitattributes export-ignore
.github/ export-ignore
.gitignore export-ignore
.idea/ export-ignore
.php-cs-fixer.dist.php export-ignore
CHANGELOG.md export-ignore
LICENSE export-ignore
phpunit.xml.dist export-ignore
README.md export-ignore
tests/ export-ignore


================================================
FILE: .github/ISSUE_TEMPLATE/bug_report.md
================================================
---
name: Bug report
about: Create a report to help us improve
title: ''
labels: bug
assignees: ''

---

**Describe the bug**
A clear and concise description of what the bug is.

**What version does this affect?**
 - Laravel Version: [e.g. 10.0.0]
 - Package Version: [e.g. 1.5.0]

**To Reproduce**
Steps to reproduce the behavior:

**Expected behavior**
A clear and concise description of what you expected to happen.

**Additional context**
Add any other context about the problem here.


================================================
FILE: .github/ISSUE_TEMPLATE/feature_request.md
================================================
---
name: Feature request
about: Suggest a new feature idea or improvement
title: ''
labels: enhancement
assignees: ''

---

**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

**Describe the solution you'd like**
A clear and concise description of what you want to happen.

**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.

**Additional context**
Add any other context or screenshots about the feature request here.


================================================
FILE: .github/workflows/php-cs-fixer.yml
================================================
name: Code Style

on: [ pull_request, push ]

jobs:
  coverage:
    runs-on: ubuntu-latest

    name: Run code style checks

    steps:
      - name: Checkout code
        uses: actions/checkout@v5

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: 8.3
          extensions: dom, curl, libxml, mbstring, zip, pcntl, bcmath, intl, iconv
          coverage: none
          
      - name: Get composer cache directory
        id: composer-cache
        run: |
          echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT

      - name: Cache dependencies
        uses: actions/cache@v5
        with:
          path: ${{ steps.composer-cache.outputs.dir }}
          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
          restore-keys: |
            ${{ runner.os }}-composer-

      - name: Install dependencies
        env:
          COMPOSER_DISCARD_CHANGES: true
        run: composer require --no-progress --no-interaction --prefer-dist --update-with-all-dependencies "laravel/framework:12.*"

      - name: Run PHP CS Fixer
        run: ./vendor/bin/php-cs-fixer fix --diff --dry-run


================================================
FILE: .github/workflows/phpunit.yml
================================================
name: PHPUnit

on:
  push:
  pull_request:
  schedule:
    - cron: '0 14 * * 3' # Run Wednesdays at 2pm EST

jobs:
  php-tests:
    runs-on: ubuntu-latest

    strategy:
      matrix:
        php: [ 8.1, 8.2, 8.3, 8.4, 8.5 ]
        laravel: [ 13.*, 12.*, 11.*, 10.* ]
        dependency-version: [ stable, lowest ]
        exclude:
          - { laravel: 13.*, php: 8.2 }
          - { laravel: 13.*, php: 8.1 }
          - { laravel: 12.*, php: 8.1 }
          - { laravel: 11.*, php: 8.5 }
          - { laravel: 11.*, php: 8.1 }
          - { laravel: 10.*, php: 8.5 }
          - { laravel: 10.*, php: 8.4 }
          
    timeout-minutes: 10

    name: "${{ matrix.php }} / ${{ matrix.laravel }} (${{ matrix.dependency-version }})"

    steps:
      - name: Checkout code
        uses: actions/checkout@v5

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php }}
          extensions: dom, curl, libxml, mbstring, zip, pcntl, bcmath, intl, iconv
          tools: composer:v2

      - name: Register composer cache directory
        id: composer-cache
        run: |
          echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT  

      - name: Cache dependencies
        uses: actions/cache@v5
        with:
          path: ${{ steps.composer-cache.outputs.dir }}
          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
          restore-keys: |
            ${{ runner.os }}-composer-

      - name: Install dependencies
        run: |
          composer require --no-interaction --prefer-dist --prefer-${{ matrix.dependency-version }} --update-with-all-dependencies "laravel/framework:${{ matrix.laravel }}"

      - name: Execute tests
        run: vendor/bin/phpunit


================================================
FILE: .github/workflows/update-changelog.yml
================================================
name: Update Changelog

on:
  release:
    types: [ published ]

jobs:
  update-publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
        with:
          repository: ${{ github.event.repository.full_name }}
          ref: 'main'

      - name: Update changelog
        uses: thomaseizinger/keep-a-changelog-new-release@v2
        with:
          version: ${{ github.event.release.tag_name }}

      - name: Commit changelog back to repo
        uses: EndBug/add-and-commit@v9
        with:
          add: 'CHANGELOG.md'
          message: ${{ github.event.release.tag_name }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}


================================================
FILE: .gitignore
================================================
vendor/
composer.phar
composer.lock
phpunit.xml
.phpunit.result.cache
.php_cs.cache
.php-cs-fixer.cache
.env

.DS_Store
.phpstorm.meta.php
_ide_helper.php

node_modules
mix-manifest.json
yarn-error.log


================================================
FILE: .idea/.gitignore
================================================
# Default ignored files
/shelf/
/workspace.xml
# Datasource local storage ignored files
/dataSources/
/dataSources.local.xml
# Editor-based HTTP Client requests
/httpRequests/

laravel-idea-personal.xml

================================================
FILE: .idea/blade.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="BladeInjectionConfiguration" default="false">
    <directives>
      <data directive="@append" />
      <data directive="@auth" injection="true" prefix="&lt;?php if(auth()-&gt;guard(" suffix=")-&gt;check()): ?&gt;" />
      <data directive="@aware" injection="true" prefix="&lt;?php $attributes = $attributes-&gt;exceptProps(" suffix="); ?&gt;" />
      <data directive="@break" injection="true" prefix="&lt;?php if(" suffix=") break; ?&gt;" />
      <data directive="@can" injection="true" prefix="&lt;?php if (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;check(" suffix=")): ?&gt;" />
      <data directive="@canany" injection="true" prefix="&lt;?php if (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;any(" suffix=")): ?&gt;" />
      <data directive="@cannot" injection="true" prefix="&lt;?php if (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;denies(" suffix=")): ?&gt;" />
      <data directive="@case" injection="true" prefix="&lt;?php case (" suffix="): ?&gt;" />
      <data directive="@checked" injection="true" prefix="&lt;?php if(" suffix=") {echo 'checked';}?&gt;" />
      <data directive="@choice" injection="true" prefix="&lt;?php echo app('translator')-&gt;choice(" suffix="); ?&gt;" />
      <data directive="@class" injection="true" prefix="class=&quot;&lt;?php echo \Illuminate\Support\Arr::toCssClasses(" suffix=")?&gt;&quot;" />
      <data directive="@component" injection="true" prefix="&lt;?php $__env-&gt;startComponent(" suffix="); ?&gt;" />
      <data directive="@componentfirst" injection="true" prefix="&lt;?php $__env-&gt;startComponentFirst(" suffix="); ?&gt;" />
      <data directive="@continue" injection="true" prefix="&lt;?php if(" suffix=") continue; ?&gt;" />
      <data directive="@csrf" />
      <data directive="@dd" injection="true" prefix="&lt;?php dd(" suffix="); ?&gt;" />
      <data directive="@default" />
      <data directive="@disabled" injection="true" prefix="&lt;?php if(" suffix=") {echo 'disabled';}?&gt;" />
      <data directive="@dump" injection="true" prefix="&lt;?php dump(" suffix="); ?&gt;" />
      <data directive="@each" injection="true" prefix="&lt;?php echo $__env-&gt;renderEach(" suffix="); ?&gt;" />
      <data directive="@else" />
      <data directive="@elseauth" injection="true" prefix="&lt;?php elseif(auth()-&gt;guard(" suffix=")-&gt;check()): ?&gt;" />
      <data directive="@elsecan" injection="true" prefix="&lt;?php elseif (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;check(" suffix=")): ?&gt;" />
      <data directive="@elsecanany" injection="true" prefix="&lt;?php elseif (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;any(" suffix=")): ?&gt;" />
      <data directive="@elsecannot" injection="true" prefix="&lt;?php elseif (app(\Illuminate\Contracts\Auth\Access\Gate::class)-&gt;denies(" suffix=")): ?&gt;" />
      <data directive="@elseguest" injection="true" prefix="&lt;?php elseif(auth()-&gt;guard(" suffix=")-&gt;guest()): ?&gt;" />
      <data directive="@elseif" injection="true" prefix="&lt;?php elseif(" suffix="): ?&gt;" />
      <data directive="@empty" injection="true" prefix="&lt;?php if(empty(" suffix=")): ?&gt;" />
      <data directive="@endauth" />
      <data directive="@endcan" />
      <data directive="@endcanany" />
      <data directive="@endcannot" />
      <data directive="@endcomponent" />
      <data directive="@endcomponentClass" />
      <data directive="@endcomponentfirst" />
      <data directive="@endempty" />
      <data directive="@endenv" />
      <data directive="@enderror" />
      <data directive="@endfor" />
      <data directive="@endforeach" />
      <data directive="@endforelse" />
      <data directive="@endguest" />
      <data directive="@endif" />
      <data directive="@endisset" />
      <data directive="@endlang" />
      <data directive="@endonce" />
      <data directive="@endphp" />
      <data directive="@endprepend" />
      <data directive="@endproduction" />
      <data directive="@endpush" />
      <data directive="@endsection" />
      <data directive="@endsession" />
      <data directive="@endslot" />
      <data directive="@endswitch" />
      <data directive="@endunless" />
      <data directive="@endverbatim" />
      <data directive="@endwhile" />
      <data directive="@env" injection="true" prefix="&lt;?php if(app()-&gt;environment(" suffix=")): ?&gt;" />
      <data directive="@error" injection="true" prefix="&lt;?php $__errorArgs = [" suffix="];&#10;$__bag = $errors-&gt;getBag($__errorArgs[1] ?? 'default');&#10;if ($__bag-&gt;has($__errorArgs[0])) :&#10;if (isset($message)) { $__messageOriginal = $message; }&#10;$message = $__bag-&gt;first($__errorArgs[0]); ?&gt;" />
      <data directive="@extends" injection="true" prefix="&lt;?php echo $__env-&gt;make(" suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path']))-&gt;render(); ?&gt;" />
      <data directive="@extendsfirst" injection="true" prefix="&lt;?php echo $__env-&gt;first(" suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path']))-&gt;render(); ?&gt;" />
      <data directive="@for" injection="true" prefix="&lt;?php for(" suffix="): ?&gt;" />
      <data directive="@foreach" injection="true" prefix="&lt;?php foreach(" suffix="): ?&gt;" />
      <data directive="@forelse" injection="true" prefix="&lt;?php foreach(" suffix="): ?&gt;" />
      <data directive="@guest" injection="true" prefix="&lt;?php if(auth()-&gt;guard(" suffix=")-&gt;guest()): ?&gt;" />
      <data directive="@hasSection" injection="true" prefix="&lt;?php if (! empty(trim($__env-&gt;yieldContent(" suffix=")))): ?&gt;" />
      <data directive="@if" injection="true" prefix="&lt;?php if(" suffix="): ?&gt;" />
      <data directive="@include" injection="true" prefix="&lt;?php echo $__env-&gt;make(" suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path']))-&gt;render(); ?&gt;" />
      <data directive="@includeFirst" injection="true" prefix="&lt;?php echo $__env-&gt;first(" suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path']))-&gt;render(); ?&gt;" />
      <data directive="@includeUnless" injection="true" prefix="&lt;?php echo $__env-&gt;renderWhen(! " suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path'])); ?&gt;" />
      <data directive="@includeWhen" injection="true" prefix="&lt;?php echo $__env-&gt;renderWhen(" suffix=", \Illuminate\Support\Arr::except(get_defined_vars(), ['__data', '__path'])); ?&gt;" />
      <data directive="@isset" injection="true" prefix="&lt;?php if(isset(" suffix=")): ?&gt;" />
      <data directive="@js" injection="true" prefix="&lt;?php _bladeDirective(" suffix="); ?&gt;" />
      <data directive="@json" injection="true" prefix="&lt;?php echo json_encode(" suffix=") ?&gt;" />
      <data directive="@lang" injection="true" prefix="&lt;?php echo app('translator')-&gt;get(" suffix="); ?&gt;" />
      <data directive="@measure" />
      <data directive="@method" injection="true" prefix="&lt;?php echo method_field(" suffix="); ?&gt;" />
      <data directive="@once" />
      <data directive="@overwrite" />
      <data directive="@parent" />
      <data directive="@php" injection="true" prefix="&lt;?php (" suffix="); ?&gt;" />
      <data directive="@prepend" injection="true" prefix="&lt;?php $__env-&gt;startPrepend(" suffix="); ?&gt;" />
      <data directive="@production" />
      <data directive="@props" injection="true" prefix="&lt;?php $attributes = $attributes-&gt;exceptProps(" suffix="); ?&gt;" />
      <data directive="@push" injection="true" prefix="&lt;?php $__env-&gt;startPush(" suffix="); ?&gt;" />
      <data directive="@ray" injection="true" prefix="&lt;?php ray(" suffix="); ?&gt;" />
      <data directive="@section" injection="true" prefix="&lt;?php $__env-&gt;startSection(" suffix="); ?&gt;" />
      <data directive="@sectionMissing" injection="true" prefix="&lt;?php if (empty(trim($__env-&gt;yieldContent(" suffix=")))): ?&gt;" />
      <data directive="@selected" injection="true" prefix="&lt;?php if(" suffix=") {echo 'selected';}?&gt;" />
      <data directive="@session" injection="true" prefix="&lt;?php $value = session()-&gt;get(" suffix=")?&gt;&quot;" />
      <data directive="@show" />
      <data directive="@slot" injection="true" prefix="&lt;?php $__env-&gt;slot(" suffix="); ?&gt;" />
      <data directive="@stack" injection="true" prefix="&lt;?php echo $__env-&gt;yieldPushContent(" suffix="); ?&gt;" />
      <data directive="@stop" />
      <data directive="@style" injection="true" prefix="class=&quot;&lt;?php echo \Illuminate\Support\Arr::toCssStyles(" suffix=")?&gt;&quot;" />
      <data directive="@switch" injection="true" prefix="&lt;?php switch(" suffix="): ?&gt;" />
      <data directive="@unless" injection="true" prefix="&lt;?php if (! (" suffix=")): ?&gt;" />
      <data directive="@unset" injection="true" prefix="&lt;?php unset(" suffix="); ?&gt;" />
      <data directive="@verbatim" />
      <data directive="@vite" injection="true" prefix="&lt;?php echo vite_func(" suffix="); ?&gt;" />
      <data directive="@viteReactRefresh" />
      <data directive="@while" injection="true" prefix="&lt;?php while(" suffix="): ?&gt;" />
      <data directive="@xray" />
      <data directive="@yield" injection="true" prefix="&lt;?php echo $__env-&gt;yieldContent(" suffix="); ?&gt;" />
    </directives>
  </component>
</project>

================================================
FILE: .idea/inspectionProfiles/Project_Default.xml
================================================
<component name="InspectionProjectProfileManager">
  <profile version="1.0">
    <option name="myName" value="Project Default" />
    <inspection_tool class="ForgottenDebugOutputInspection" enabled="true" level="ERROR" enabled_by_default="true">
      <option name="configuration">
        <list>
          <option value="\Codeception\Util\Debug::debug" />
          <option value="\Codeception\Util\Debug::pause" />
          <option value="\Doctrine\Common\Util\Debug::dump" />
          <option value="\Doctrine\Common\Util\Debug::export" />
          <option value="\Illuminate\Support\Debug\Dumper::dump" />
          <option value="\Symfony\Component\Debug\Debug::enable" />
          <option value="\Symfony\Component\Debug\DebugClassLoader::enable" />
          <option value="\Symfony\Component\Debug\ErrorHandler::register" />
          <option value="\Symfony\Component\Debug\ExceptionHandler::register" />
          <option value="\TYPO3\CMS\Core\Utility\DebugUtility::debug" />
          <option value="\Zend\Debug\Debug::dump" />
          <option value="\Zend\Di\Display\Console::export" />
          <option value="dd" />
          <option value="debug_print_backtrace" />
          <option value="debug_zval_dump" />
          <option value="dpm" />
          <option value="dpq" />
          <option value="dsm" />
          <option value="dump" />
          <option value="dvm" />
          <option value="error_log" />
          <option value="kpr" />
          <option value="phpinfo" />
          <option value="print_r" />
          <option value="var_dump" />
          <option value="var_export" />
          <option value="wp_die" />
          <option value="xdebug_break" />
          <option value="xdebug_call_class" />
          <option value="xdebug_call_file" />
          <option value="xdebug_call_function" />
          <option value="xdebug_call_line" />
          <option value="xdebug_code_coverage_started" />
          <option value="xdebug_debug_zval" />
          <option value="xdebug_debug_zval_stdout" />
          <option value="xdebug_dump_superglobals" />
          <option value="xdebug_enable" />
          <option value="xdebug_get_code_coverage" />
          <option value="xdebug_get_collected_errors" />
          <option value="xdebug_get_declared_vars" />
          <option value="xdebug_get_function_stack" />
          <option value="xdebug_get_headers" />
          <option value="xdebug_get_monitored_functions" />
          <option value="xdebug_get_profiler_filename" />
          <option value="xdebug_get_stack_depth" />
          <option value="xdebug_get_tracefile_name" />
          <option value="xdebug_is_enabled" />
          <option value="xdebug_memory_usage" />
          <option value="xdebug_peak_memory_usage" />
          <option value="xdebug_print_function_stack" />
          <option value="xdebug_start_code_coverage" />
          <option value="xdebug_start_error_collection" />
          <option value="xdebug_start_function_monitor" />
          <option value="xdebug_start_trace" />
          <option value="xdebug_stop_code_coverage" />
          <option value="xdebug_stop_error_collection" />
          <option value="xdebug_stop_function_monitor" />
          <option value="xdebug_stop_trace" />
          <option value="xdebug_time_index" />
          <option value="xdebug_var_dump" />
        </list>
      </option>
      <option name="migratedIntoUserSpace" value="true" />
    </inspection_tool>
    <inspection_tool class="PhpCSFixerValidationInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
    <inspection_tool class="PhpUnhandledExceptionInspection" enabled="false" level="WEAK WARNING" enabled_by_default="false" />
    <inspection_tool class="SecurityAdvisoriesInspection" enabled="false" level="WARNING" enabled_by_default="false">
      <option name="optionConfiguration">
        <list>
          <option value="barryvdh/laravel-debugbar" />
          <option value="behat/behat" />
          <option value="brianium/paratest" />
          <option value="codeception/codeception" />
          <option value="codedungeon/phpunit-result-printer" />
          <option value="composer/composer" />
          <option value="doctrine/coding-standard" />
          <option value="filp/whoops" />
          <option value="friendsofphp/php-cs-fixer" />
          <option value="humbug/humbug" />
          <option value="infection/infection" />
          <option value="jakub-onderka/php-parallel-lint" />
          <option value="johnkary/phpunit-speedtrap" />
          <option value="kalessil/production-dependencies-guard" />
          <option value="mikey179/vfsStream" />
          <option value="mockery/mockery" />
          <option value="mybuilder/phpunit-accelerator" />
          <option value="orchestra/testbench" />
          <option value="pdepend/pdepend" />
          <option value="phan/phan" />
          <option value="phing/phing" />
          <option value="phpcompatibility/php-compatibility" />
          <option value="phpmd/phpmd" />
          <option value="phpro/grumphp" />
          <option value="phpspec/phpspec" />
          <option value="phpspec/prophecy" />
          <option value="phpstan/phpstan" />
          <option value="phpunit/phpunit" />
          <option value="povils/phpmnd" />
          <option value="roave/security-advisories" />
          <option value="satooshi/php-coveralls" />
          <option value="sebastian/phpcpd" />
          <option value="slevomat/coding-standard" />
          <option value="spatie/phpunit-watcher" />
          <option value="squizlabs/php_codesniffer" />
          <option value="sstalle/php7cc" />
          <option value="symfony/debug" />
          <option value="symfony/maker-bundle" />
          <option value="symfony/phpunit-bridge" />
          <option value="symfony/var-dumper" />
          <option value="vimeo/psalm" />
          <option value="wimg/php-compatibility" />
          <option value="wp-coding-standards/wpcs" />
          <option value="yiisoft/yii2-coding-standards" />
          <option value="yiisoft/yii2-debug" />
          <option value="yiisoft/yii2-gii" />
          <option value="zendframework/zend-coding-standard" />
          <option value="zendframework/zend-debug" />
          <option value="zendframework/zend-test" />
        </list>
      </option>
    </inspection_tool>
  </profile>
</component>

================================================
FILE: .idea/laravel-idea.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="InertiaPackage">
    <option name="directoryPaths">
      <list />
    </option>
  </component>
  <component name="LaravelIdeaMainSettings">
    <option name="appDirectory" value="src" />
    <option name="frameworkFound" value="true" />
  </component>
</project>

================================================
FILE: .idea/linen.iml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<module type="WEB_MODULE" version="4">
  <component name="NewModuleRootManager">
    <content url="file://$MODULE_DIR$">
      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" packagePrefix="Glhd\Linen\" />
      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" />
      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" packagePrefix="Glhd\Linen\Tests\" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/php-parser" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nette/schema" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nette/utils" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/brick/math" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/voku/portable-ascii" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/opis/closure" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-factory" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/simple-cache" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/log" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/container" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-message" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/event-dispatcher" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/cache" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/composer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/php-cs-fixer/diff" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofphp/php-cs-fixer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/swiftmailer/swiftmailer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/psr7" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/resource-operations" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/exporter" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/environment" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/graham-campbell/result-type" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-docblock" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/type-resolver" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-common" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/dragonmantank/cron-expression" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/tijsverkoyen/css-to-inline-styles" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/complexity" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-reflector" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-enumerator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/global-state" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/comparator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/ralouphie/getallheaders" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpoption/phpoption" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/testbench-core" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/cli-parser" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/version" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/type" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/lines-of-code" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/recursion-context" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/diff" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/inflector" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/lexer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/testbench" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/hamcrest/hamcrest-php" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/fakerphp/faker" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/instantiator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/annotations" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/theseer/tokenizer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-grapheme" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-mbstring" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/console" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/process" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/error-handler" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-foundation" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/finder" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher-contracts" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/css-selector" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-normalizer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-idn" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/options-resolver" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/filesystem" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/var-dumper" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/service-contracts" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/routing" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/deprecation-contracts" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/string" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mime" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/yaml" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-kernel" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/stopwatch" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-file-iterator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-invoker" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-code-coverage" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation-contracts" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/translation" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php81" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-ctype" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php80" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php73" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/mockery/mockery" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/serializable-closure" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/framework" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/egulias/email-validator" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/dflydev/dot-access-data" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/vlucas/phpdotenv" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-text-template" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/phpunit" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-timer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phpspec/prophecy" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/version" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/manifest" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/deep-copy" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/monolog/monolog" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/config" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/mime-type-detection" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/ramsey/uuid" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/ramsey/collection" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/pimple/pimple" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nesbot/carbon" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/commonmark" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/flysystem" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/_laravel_idea" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/carbonphp/carbon-doctrine-types" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/clue/ndjson-react" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/evenement/evenement" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/fidry/cpu-core-counter" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/filp/whoops" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/fruitcake/php-cors" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/uri-template" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/prompts" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/tinker" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/flysystem-local" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nunomaduro/collision" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/nunomaduro/termwind" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/openspout/openspout" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/canvas" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/canvas-core" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/workbench" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/clock" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psy/psysh" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/cache" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/child-process" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/dns" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/event-loop" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/promise" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/socket" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/react/stream" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/mailer" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php83" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-uuid" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/uid" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/guzzle" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/promises" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/pail" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/uri" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/league/uri-interfaces" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/sidekick" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/http-client" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/staabm/side-effects-detector" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/clock" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php84" />
      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php85" />
    </content>
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
</module>

================================================
FILE: .idea/modules.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="ProjectModuleManager">
    <modules>
      <module fileurl="file://$PROJECT_DIR$/.idea/linen.iml" filepath="$PROJECT_DIR$/.idea/linen.iml" />
    </modules>
  </component>
</project>

================================================
FILE: .idea/php-test-framework.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="PhpTestFrameworkVersionCache">
    <tools_cache>
      <tool tool_name="PHPUnit">
        <cache>
          <versions>
            <info id="Local/Users/inxilpro/Development/open-source/linen/vendor/autoload.php" version="10.5.28" />
            <info id="Local/vendor/autoload.php" version="10.5.28" />
          </versions>
        </cache>
      </tool>
    </tools_cache>
  </component>
</project>

================================================
FILE: .idea/php.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="MessDetectorOptionsConfiguration">
    <option name="transferred" value="true" />
  </component>
  <component name="PHPCSFixerOptionsConfiguration">
    <option name="codingStandard" value="Custom" />
    <option name="rulesetPath" value="$PROJECT_DIR$/.php-cs-fixer.dist.php" />
    <option name="transferred" value="true" />
  </component>
  <component name="PHPCodeSnifferOptionsConfiguration">
    <option name="highlightLevel" value="WARNING" />
    <option name="transferred" value="true" />
  </component>
  <component name="PhpCSFixer">
    <phpcsfixer_settings>
      <PhpCSFixerConfiguration tool_path="$PROJECT_DIR$/vendor/bin/php-cs-fixer" />
    </phpcsfixer_settings>
  </component>
  <component name="PhpIncludePathManager">
    <include_path>
      <path value="$PROJECT_DIR$/vendor/nikic/php-parser" />
      <path value="$PROJECT_DIR$/vendor/nette/schema" />
      <path value="$PROJECT_DIR$/vendor/nette/utils" />
      <path value="$PROJECT_DIR$/vendor/brick/math" />
      <path value="$PROJECT_DIR$/vendor/voku/portable-ascii" />
      <path value="$PROJECT_DIR$/vendor/opis/closure" />
      <path value="$PROJECT_DIR$/vendor/psr/http-factory" />
      <path value="$PROJECT_DIR$/vendor/psr/simple-cache" />
      <path value="$PROJECT_DIR$/vendor/psr/log" />
      <path value="$PROJECT_DIR$/vendor/psr/container" />
      <path value="$PROJECT_DIR$/vendor/psr/http-message" />
      <path value="$PROJECT_DIR$/vendor/psr/event-dispatcher" />
      <path value="$PROJECT_DIR$/vendor/psr/cache" />
      <path value="$PROJECT_DIR$/vendor/composer" />
      <path value="$PROJECT_DIR$/vendor/php-cs-fixer/diff" />
      <path value="$PROJECT_DIR$/vendor/friendsofphp/php-cs-fixer" />
      <path value="$PROJECT_DIR$/vendor/swiftmailer/swiftmailer" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/psr7" />
      <path value="$PROJECT_DIR$/vendor/sebastian/resource-operations" />
      <path value="$PROJECT_DIR$/vendor/sebastian/exporter" />
      <path value="$PROJECT_DIR$/vendor/sebastian/environment" />
      <path value="$PROJECT_DIR$/vendor/graham-campbell/result-type" />
      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-docblock" />
      <path value="$PROJECT_DIR$/vendor/phpdocumentor/type-resolver" />
      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-common" />
      <path value="$PROJECT_DIR$/vendor/dragonmantank/cron-expression" />
      <path value="$PROJECT_DIR$/vendor/tijsverkoyen/css-to-inline-styles" />
      <path value="$PROJECT_DIR$/vendor/sebastian/complexity" />
      <path value="$PROJECT_DIR$/vendor/sebastian/object-reflector" />
      <path value="$PROJECT_DIR$/vendor/sebastian/object-enumerator" />
      <path value="$PROJECT_DIR$/vendor/sebastian/global-state" />
      <path value="$PROJECT_DIR$/vendor/sebastian/comparator" />
      <path value="$PROJECT_DIR$/vendor/ralouphie/getallheaders" />
      <path value="$PROJECT_DIR$/vendor/phpoption/phpoption" />
      <path value="$PROJECT_DIR$/vendor/orchestra/testbench-core" />
      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit" />
      <path value="$PROJECT_DIR$/vendor/sebastian/cli-parser" />
      <path value="$PROJECT_DIR$/vendor/sebastian/version" />
      <path value="$PROJECT_DIR$/vendor/sebastian/type" />
      <path value="$PROJECT_DIR$/vendor/sebastian/lines-of-code" />
      <path value="$PROJECT_DIR$/vendor/sebastian/recursion-context" />
      <path value="$PROJECT_DIR$/vendor/sebastian/diff" />
      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
      <path value="$PROJECT_DIR$/vendor/doctrine/inflector" />
      <path value="$PROJECT_DIR$/vendor/doctrine/lexer" />
      <path value="$PROJECT_DIR$/vendor/orchestra/testbench" />
      <path value="$PROJECT_DIR$/vendor/hamcrest/hamcrest-php" />
      <path value="$PROJECT_DIR$/vendor/fakerphp/faker" />
      <path value="$PROJECT_DIR$/vendor/doctrine/instantiator" />
      <path value="$PROJECT_DIR$/vendor/doctrine/annotations" />
      <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-grapheme" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-mbstring" />
      <path value="$PROJECT_DIR$/vendor/symfony/console" />
      <path value="$PROJECT_DIR$/vendor/symfony/process" />
      <path value="$PROJECT_DIR$/vendor/symfony/error-handler" />
      <path value="$PROJECT_DIR$/vendor/symfony/http-foundation" />
      <path value="$PROJECT_DIR$/vendor/symfony/finder" />
      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher-contracts" />
      <path value="$PROJECT_DIR$/vendor/symfony/css-selector" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-normalizer" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-idn" />
      <path value="$PROJECT_DIR$/vendor/symfony/options-resolver" />
      <path value="$PROJECT_DIR$/vendor/symfony/filesystem" />
      <path value="$PROJECT_DIR$/vendor/symfony/var-dumper" />
      <path value="$PROJECT_DIR$/vendor/symfony/service-contracts" />
      <path value="$PROJECT_DIR$/vendor/symfony/routing" />
      <path value="$PROJECT_DIR$/vendor/symfony/deprecation-contracts" />
      <path value="$PROJECT_DIR$/vendor/symfony/string" />
      <path value="$PROJECT_DIR$/vendor/symfony/mime" />
      <path value="$PROJECT_DIR$/vendor/symfony/yaml" />
      <path value="$PROJECT_DIR$/vendor/symfony/http-kernel" />
      <path value="$PROJECT_DIR$/vendor/symfony/stopwatch" />
      <path value="$PROJECT_DIR$/vendor/phpunit/php-file-iterator" />
      <path value="$PROJECT_DIR$/vendor/phpunit/php-invoker" />
      <path value="$PROJECT_DIR$/vendor/phpunit/php-code-coverage" />
      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher" />
      <path value="$PROJECT_DIR$/vendor/symfony/translation-contracts" />
      <path value="$PROJECT_DIR$/vendor/symfony/translation" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php81" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-ctype" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php80" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php73" />
      <path value="$PROJECT_DIR$/vendor/mockery/mockery" />
      <path value="$PROJECT_DIR$/vendor/laravel/serializable-closure" />
      <path value="$PROJECT_DIR$/vendor/laravel/framework" />
      <path value="$PROJECT_DIR$/vendor/egulias/email-validator" />
      <path value="$PROJECT_DIR$/vendor/dflydev/dot-access-data" />
      <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
      <path value="$PROJECT_DIR$/vendor/phpunit/php-text-template" />
      <path value="$PROJECT_DIR$/vendor/phpunit/phpunit" />
      <path value="$PROJECT_DIR$/vendor/phpunit/php-timer" />
      <path value="$PROJECT_DIR$/vendor/phpspec/prophecy" />
      <path value="$PROJECT_DIR$/vendor/phar-io/version" />
      <path value="$PROJECT_DIR$/vendor/phar-io/manifest" />
      <path value="$PROJECT_DIR$/vendor/myclabs/deep-copy" />
      <path value="$PROJECT_DIR$/vendor/monolog/monolog" />
      <path value="$PROJECT_DIR$/vendor/league/config" />
      <path value="$PROJECT_DIR$/vendor/league/mime-type-detection" />
      <path value="$PROJECT_DIR$/vendor/ramsey/uuid" />
      <path value="$PROJECT_DIR$/vendor/ramsey/collection" />
      <path value="$PROJECT_DIR$/vendor/pimple/pimple" />
      <path value="$PROJECT_DIR$/vendor/nesbot/carbon" />
      <path value="$PROJECT_DIR$/vendor/league/commonmark" />
      <path value="$PROJECT_DIR$/vendor/league/flysystem" />
      <path value="$PROJECT_DIR$/vendor/carbonphp/carbon-doctrine-types" />
      <path value="$PROJECT_DIR$/vendor/league/flysystem-local" />
      <path value="$PROJECT_DIR$/vendor/laravel/prompts" />
      <path value="$PROJECT_DIR$/vendor/clue/ndjson-react" />
      <path value="$PROJECT_DIR$/vendor/laravel/tinker" />
      <path value="$PROJECT_DIR$/vendor/orchestra/canvas" />
      <path value="$PROJECT_DIR$/vendor/orchestra/workbench" />
      <path value="$PROJECT_DIR$/vendor/orchestra/canvas-core" />
      <path value="$PROJECT_DIR$/vendor/filp/whoops" />
      <path value="$PROJECT_DIR$/vendor/evenement/evenement" />
      <path value="$PROJECT_DIR$/vendor/fruitcake/php-cors" />
      <path value="$PROJECT_DIR$/vendor/psr/clock" />
      <path value="$PROJECT_DIR$/vendor/psy/psysh" />
      <path value="$PROJECT_DIR$/vendor/fidry/cpu-core-counter" />
      <path value="$PROJECT_DIR$/vendor/react/stream" />
      <path value="$PROJECT_DIR$/vendor/react/promise" />
      <path value="$PROJECT_DIR$/vendor/react/socket" />
      <path value="$PROJECT_DIR$/vendor/react/dns" />
      <path value="$PROJECT_DIR$/vendor/react/cache" />
      <path value="$PROJECT_DIR$/vendor/react/event-loop" />
      <path value="$PROJECT_DIR$/vendor/react/child-process" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php83" />
      <path value="$PROJECT_DIR$/vendor/symfony/mailer" />
      <path value="$PROJECT_DIR$/vendor/symfony/uid" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-uuid" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/uri-template" />
      <path value="$PROJECT_DIR$/vendor/nunomaduro/termwind" />
      <path value="$PROJECT_DIR$/vendor/nunomaduro/collision" />
      <path value="$PROJECT_DIR$/vendor/openspout/openspout" />
      <path value="$PROJECT_DIR$/vendor/_laravel_idea" />
      <path value="$PROJECT_DIR$/vendor/psr/http-client" />
      <path value="$PROJECT_DIR$/vendor/orchestra/sidekick" />
      <path value="$PROJECT_DIR$/vendor/staabm/side-effects-detector" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php85" />
      <path value="$PROJECT_DIR$/vendor/symfony/clock" />
      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php84" />
      <path value="$PROJECT_DIR$/vendor/league/uri" />
      <path value="$PROJECT_DIR$/vendor/league/uri-interfaces" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/guzzle" />
      <path value="$PROJECT_DIR$/vendor/laravel/pail" />
      <path value="$PROJECT_DIR$/vendor/guzzlehttp/promises" />
    </include_path>
  </component>
  <component name="PhpProjectSharedConfiguration" php_language_level="8.1">
    <option name="suggestChangeDefaultLanguageLevel" value="false" />
  </component>
  <component name="PhpStan">
    <PhpStan_settings>
      <PhpStanConfiguration tool_path="$PROJECT_DIR$/vendor/bin/phpstan" />
    </PhpStan_settings>
  </component>
  <component name="PhpStanOptionsConfiguration">
    <option name="transferred" value="true" />
  </component>
  <component name="PhpUnit">
    <phpunit_settings>
      <PhpUnitSettings configuration_file_path="$PROJECT_DIR$/phpunit.xml.dist" custom_loader_path="$PROJECT_DIR$/vendor/autoload.php" use_configuration_file="true" />
    </phpunit_settings>
  </component>
  <component name="PsalmOptionsConfiguration">
    <option name="transferred" value="true" />
  </component>
</project>

================================================
FILE: .idea/vcs.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
  <component name="VcsDirectoryMappings">
    <mapping directory="$PROJECT_DIR$" vcs="Git" />
  </component>
</project>

================================================
FILE: .php-cs-fixer.dist.php
================================================
<?php

require_once __DIR__.'/vendor/autoload.php';

return (new PhpCsFixer\Config())
	->setRiskyAllowed(true)
	->setIndent("\t")
	->setLineEnding("\n")
	->setRules([
		'@PSR2' => true,
		'function_declaration' => [
			'closure_function_spacing' => 'none',
			'closure_fn_spacing' => 'none',
		],
		'ordered_imports' => [
			'sort_algorithm' => 'alpha',
		],
		'array_indentation' => true,
		'braces' => [
			'allow_single_line_closure' => true,
		],
		'no_break_comment' => false,
		'return_type_declaration' => [
			'space_before' => 'none',
		],
		'blank_line_after_opening_tag' => true,
		'compact_nullable_typehint' => true,
		'cast_spaces' => true,
		'concat_space' => [
			'spacing' => 'none',
		],
		'declare_equal_normalize' => [
			'space' => 'none',
		],
		'function_typehint_space' => true,
		'new_with_braces' => true,
		'method_argument_space' => true,
		'no_empty_statement' => true,
		'no_empty_comment' => true,
		'no_empty_phpdoc' => true,
		'no_extra_blank_lines' => [
			'tokens' => [
				'extra',
				'use',
				'use_trait',
				'return',
			],
		],
		'no_leading_import_slash' => true,
		'no_leading_namespace_whitespace' => true,
		'no_blank_lines_after_class_opening' => true,
		'no_blank_lines_after_phpdoc' => true,
		'no_whitespace_in_blank_line' => false,
		'no_whitespace_before_comma_in_array' => true,
		'no_useless_else' => true,
		'no_useless_return' => true,
		'single_trait_insert_per_statement' => true,
		'psr_autoloading' => true,
		'dir_constant' => true,
		'single_line_comment_style' => [
			'comment_types' => ['hash'],
		],
		'include' => true,
		'is_null' => true,
		'linebreak_after_opening_tag' => true,
		'lowercase_cast' => true,
		'lowercase_static_reference' => true,
		'magic_constant_casing' => true,
		'magic_method_casing' => true,
		'class_attributes_separation' => [
			// TODO: This can be reverted when https://github.com/FriendsOfPHP/PHP-CS-Fixer/pull/5869 is merged
			'elements' => ['const' => 'one', 'method' => 'one', 'property' => 'one'],
		],
		'modernize_types_casting' => true,
		'native_function_casing' => true,
		'native_function_type_declaration_casing' => true,
		'no_alias_functions' => true,
		'no_multiline_whitespace_around_double_arrow' => true,
		'multiline_whitespace_before_semicolons' => true,
		'no_short_bool_cast' => true,
		'no_unused_imports' => true,
		'no_php4_constructor' => true,
		'no_singleline_whitespace_before_semicolons' => true,
		'no_spaces_around_offset' => true,
		'no_trailing_comma_in_list_call' => true,
		'no_trailing_comma_in_singleline_array' => true,
		'normalize_index_brace' => true,
		'object_operator_without_whitespace' => true,
		'phpdoc_annotation_without_dot' => true,
		'phpdoc_indent' => true,
		'phpdoc_no_package' => true,
		'phpdoc_no_access' => true,
		'phpdoc_no_useless_inheritdoc' => true,
		'phpdoc_single_line_var_spacing' => true,
		'phpdoc_trim' => true,
		'phpdoc_types' => true,
		'semicolon_after_instruction' => true,
		'array_syntax' => [
			'syntax' => 'short',
		],
		'list_syntax' => [
			'syntax' => 'short',
		],
		'short_scalar_cast' => true,
		'single_blank_line_before_namespace' => true,
		'single_quote' => true,
		'standardize_not_equals' => true,
		'ternary_operator_spaces' => true,
		'whitespace_after_comma_in_array' => true,
		'not_operator_with_successor_space' => true,
		'trailing_comma_in_multiline' => true,
		'trim_array_spaces' => true,
		'binary_operator_spaces' => true,
		'unary_operator_spaces' => true,
		'php_unit_method_casing' => [
			'case' => 'snake_case',
		],
		'php_unit_test_annotation' => [
			'style' => 'prefix',
		],
	])
	->setFinder(
		PhpCsFixer\Finder::create()
			->exclude('.circleci')
			->exclude('bin')
			->exclude('node_modules')
			->exclude('vendor')
			->notPath('.phpstorm.meta.php')
			->notPath('_ide_helper.php')
			->notPath('artisan')
			->in(__DIR__)
	);


================================================
FILE: CHANGELOG.md
================================================
# Changelog

All notable changes will be documented in this file following the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) 
format. This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.1.0] - 2026-03-23

## [0.0.4] - 2025-11-11

## [0.0.3] - 2025-07-16

## [0.0.2] - 2024-08-02

## [0.0.1] - 2024-07-25

## [0.0.1]

# Keep a Changelog Syntax

-   `Added` for new features.
-   `Changed` for changes in existing functionality.
-   `Deprecated` for soon-to-be removed features.
-   `Removed` for now removed features.
-   `Fixed` for any bug fixes. 
-   `Security` in case of vulnerabilities.

[Unreleased]: https://github.com/glhd/linen/compare/0.1.0...HEAD

[0.1.0]: https://github.com/glhd/linen/compare/0.0.4...0.1.0

[0.0.4]: https://github.com/glhd/linen/compare/0.0.3...0.0.4

[0.0.3]: https://github.com/glhd/linen/compare/0.0.2...0.0.3

[0.0.2]: https://github.com/glhd/linen/compare/0.0.1...0.0.2

[0.0.1]: https://github.com/glhd/linen/compare/0.0.1...0.0.1

[0.0.1]: https://github.com/glhd/linen/compare/0.0.1...0.0.1


================================================
FILE: LICENSE
================================================
MIT License

Copyright (c) 2024 Galahad, Inc.

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.


================================================
FILE: README.md
================================================
<div style="float: right;">
	<a href="https://github.com/glhd/linen/actions" target="_blank">
		<img 
			src="https://github.com/glhd/linen/workflows/PHPUnit/badge.svg" 
			alt="Build Status" 
		/>
	</a>
	<a href="https://packagist.org/packages/glhd/linen" target="_blank">
        <img 
            src="https://poser.pugx.org/glhd/linen/v/stable" 
            alt="Latest Stable Release" 
        />
	</a>
	<a href="./LICENSE" target="_blank">
        <img 
            src="https://poser.pugx.org/glhd/linen/license" 
            alt="MIT Licensed" 
        />
    </a>
    <a href="https://bsky.app/profile/cmorrell.com" target="_blank">
        <img 
            src="https://img.shields.io/bluesky/followers/cmorrell.com" 
            alt="Follow @cmorrell.com on bsky" 
        />
    </a>
</div>

<h1>
    <img src="art/linen.png" height="147" alt="Linen" />
</h1>

Linen is a lightweight spreadsheet utility for Laravel. It's a simple wrapper for 
[openspout](https://github.com/openspout/openspout) with some data normalization conveniences.

## Installation

```shell
composer require glhd/linen
```

## Usage

To read a spreadsheet:

```php
foreach (Linen::read('path/to/your.xlsx') as $row) {
    // $row is a collection, keyed by the headers in snake_case
}
```

To write a spreadsheet:

```php
// $data can be any iterable/Enumerable/etc
$path = Linen::write($data, 'path/to/your.xlsx');
```


================================================
FILE: composer.json
================================================
{
  "name": "glhd/linen",
  "description": "",
  "keywords": [
    "laravel"
  ],
  "authors": [
    {
      "name": "Chris Morrell",
      "homepage": "http://www.cmorrell.com"
    }
  ],
  "type": "library",
  "license": "MIT",
  "require": {
    "illuminate/support": "^10|^11|^12|^13|dev-master",
    "ext-json": "*",
    "openspout/openspout": "^4.24"
  },
  "require-dev": {
    "orchestra/testbench": "^8.37|^9.17|^10.11|^11.0|^12.x-dev",
    "friendsofphp/php-cs-fixer": "^3.94",
    "mockery/mockery": "^1.6",
    "phpunit/phpunit": "^10.5|^11.5|^12.5|^13.0"
  },
  "autoload": {
    "psr-4": {
      "Glhd\\Linen\\": "src/"
    },
    "files": [
      "src/helpers.php"
    ]
  },
  "autoload-dev": {
    "classmap": [
      "tests/TestCase.php"
    ],
    "psr-4": {
      "Glhd\\Linen\\Tests\\": "tests/"
    }
  },
  "scripts": {
    "fix-style": "vendor/bin/php-cs-fixer fix",
    "check-style": "vendor/bin/php-cs-fixer fix --diff --dry-run"
  },
  "extra": {
    "laravel": {
      "providers": []
    }
  },
  "minimum-stability": "dev",
  "prefer-stable": true
}


================================================
FILE: config/linen.php
================================================
<?php

return [
	/*
	|--------------------------------------------------------------------------
	| Section
	|--------------------------------------------------------------------------
	|
	| Description
	|
	*/
];


================================================
FILE: ide.json
================================================
{
    "$schema": "https://laravel-ide.com/schema/laravel-ide-v2.json",
    "completions": [
        {
            "complete": "directoryFiles",
            "options": {
                "directory": "tests/fixtures"
            },
            "condition": [
                {
                    "methodNames": [
                        "fixture"
                    ],
                    "parameters": [
                        1
                    ]
                }
            ]
        }
    ]
}


================================================
FILE: phpunit.xml.dist
================================================
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         colors="true"
>
  <testsuites>
    <testsuite name="Tests">
      <directory>./tests</directory>
    </testsuite>
  </testsuites>
  <source>
    <include>
      <directory>./src</directory>
    </include>
  </source>
  <php>
    <env name="APP_ENV" value="testing"/>
    <env name="APP_KEY" value="base64:tfsezwCu4ZRixRLA/+yL/qoouX++Q3lPAPOAbtnBCG8="/>
    <env name="BCRYPT_ROUNDS" value="4"/>
    <env name="CACHE_DRIVER" value="array"/>
    <env name="SESSION_DRIVER" value="array"/>
    <env name="QUEUE_DRIVER" value="sync"/>
    <env name="MAIL_DRIVER" value="array"/>
    <env name="DB_CONNECTION" value="testing"/>
    <env name="TERMINAL_EMULATOR" value="JetBrains-JediTerm" />
  </php>
</phpunit>


================================================
FILE: src/CsvReader.php
================================================
<?php

namespace Glhd\Linen;

use OpenSpout\Common\Entity\Cell;
use OpenSpout\Reader\ReaderInterface;

class CsvReader extends Reader
{
	protected function reader(): ReaderInterface
	{
		return new \OpenSpout\Reader\CSV\Reader();
	}
	
	protected function castCell(Cell $cell): mixed
	{
		$value = $cell->getValue();
		
		return match (true) {
			is_numeric($value) => (float) $value == (int) $value ? (int) $value : (float) $value,
			'' === $value => null,
			default => $value,
		};
	}
}


================================================
FILE: src/CsvWriter.php
================================================
<?php

namespace Glhd\Linen;

use Closure;
use Glhd\Linen\Support\WriteIterator;
use OpenSpout\Writer\CSV as OpenSpout;
use OpenSpout\Writer\WriterInterface;

class CsvWriter extends Writer
{
	protected string $delimiter = ',';
	
	protected string $enclosure = '"';
	
	protected bool $bom = true;
	
	protected bool $empty_new_line = false;
	
	public function withDelimiter(string $delimiter): static
	{
		$this->delimiter = $delimiter;
		
		return $this;
	}
	
	public function withEnclosure(string $enclosure): static
	{
		$this->enclosure = $enclosure;
		
		return $this;
	}
	
	public function withoutBom(): static
	{
		$this->bom = false;
		
		return $this;
	}
	
	public function withEmptyNewLineAtEndOfFile(): static
	{
		$this->empty_new_line = true;
		
		return $this;
	}
	
	public function withoutEmptyNewLineAtEndOfFile(): static
	{
		$this->empty_new_line = false;
		
		return $this;
	}
	
	public function getIterator(?string $path = null): WriteIterator
	{
		$path ??= tempnam_with_cleanup();
		
		return new WriteIterator(
			path: $path,
			generator: $this->rows(),
			writer: $this->writer(),
			cleanup: $this->cleanupCallback(),
		);
	}
	
	protected function writer(): WriterInterface
	{
		$options = new OpenSpout\Options();
		$options->FIELD_DELIMITER = $this->delimiter;
		$options->FIELD_ENCLOSURE = $this->enclosure;
		$options->SHOULD_ADD_BOM = $this->bom;
		
		return new OpenSpout\Writer($options);
	}
	
	protected function cleanupCallback(): ?Closure
	{
		if (! $this->empty_new_line) {
			return fn($path) => file_put_contents($path, rtrim(file_get_contents($path), PHP_EOL));
		}
		
		return null;
	}
}


================================================
FILE: src/ExcelReader.php
================================================
<?php

namespace Glhd\Linen;

use Carbon\CarbonImmutable;
use OpenSpout\Common\Entity\Cell;
use OpenSpout\Reader\ReaderInterface;

class ExcelReader extends Reader
{
	protected function reader(): ReaderInterface
	{
		return new \OpenSpout\Reader\XLSX\Reader();
	}
	
	protected function castCell(Cell $cell): mixed
	{
		if ($cell instanceof Cell\DateTimeCell) {
			return CarbonImmutable::createFromInterface($cell->getValue());
		}
		
		if ($cell instanceof Cell\EmptyCell) {
			return null;
		}
		
		return parent::castCell($cell);
	}
}


================================================
FILE: src/ExcelWriter.php
================================================
<?php

namespace Glhd\Linen;

use OpenSpout\Writer\WriterInterface;
use OpenSpout\Writer\XLSX as OpenSpout;

class ExcelWriter extends Writer
{
	protected function writer(): WriterInterface
	{
		return new OpenSpout\Writer(new OpenSpout\Options());
	}
}


================================================
FILE: src/Facades/.gitkeep
================================================


================================================
FILE: src/Facades/Linen.php
================================================
<?php

namespace Glhd\Linen\Facades;

use Glhd\Linen\Support\FileTypeHelper;
use Illuminate\Support\Facades\Facade;

class Linen extends Facade
{
	protected static function getFacadeAccessor()
	{
		return FileTypeHelper::class;
	}
}


================================================
FILE: src/Reader.php
================================================
<?php

namespace Glhd\Linen;

use Illuminate\Support\Collection;
use Illuminate\Support\LazyCollection;
use Illuminate\Support\Str;
use IteratorAggregate;
use OpenSpout\Common\Entity\Cell;
use OpenSpout\Common\Entity\Row;
use OpenSpout\Reader\ReaderInterface;
use Traversable;
use UnexpectedValueException;

/** @extends IteratorAggregate<int, Collection> */
abstract class Reader implements IteratorAggregate
{
	public static function from(string $path): static
	{
		return new static($path);
	}
	
	public static function read(string $path): LazyCollection
	{
		return static::from($path)->collect();
	}
	
	public function __construct(
		protected string $path,
	) {
	}
	
	public function getIterator(): Traversable
	{
		return $this->collect();
	}
	
	public function collect(): LazyCollection
	{
		return new LazyCollection(function() {
			$reader = $this->reader();
			$reader->open($this->path);
			
			try {
				foreach ($reader->getSheetIterator() as $sheet) {
					$columns = 0;
					$keys = null;
					
					foreach ($sheet->getRowIterator() as $row) {
						/** @var \OpenSpout\Common\Entity\Row $row */
						if (null === $keys) {
							$keys = array_map($this->headerToKey(...), $row->toArray());
							$columns = count($keys);
							continue;
						}
						
						$data = $this->castRow($row);
						$data_columns = count($data);
						
						if ($columns < $data_columns) {
							foreach (range(1, $data_columns) as $index => $column) {
								$keys[$index] ??= "column{$column}";
							}
							$columns = count($keys);
						}
						
						if ($columns > $data_columns) {
							$data = array_merge($data, array_fill(0, $columns - $data_columns, null));
						}
						
						yield Collection::make(array_combine($keys, $data));
					}
				}
			} finally {
				$reader->close();
			}
		});
	}
	
	abstract protected function reader(): ReaderInterface;
	
	protected function castRow(Row $data): array
	{
		return array_map($this->castCell(...), $data->getCells());
	}
	
	protected function castCell(Cell $cell): mixed
	{
		return $cell->getValue();
	}
	
	protected function headerToKey(string $value): string
	{
		return Str::snake(strtolower($value));
	}
}


================================================
FILE: src/Support/FileTypeHelper.php
================================================
<?php

namespace Glhd\Linen\Support;

use Generator;
use Glhd\Linen\CsvReader;
use Glhd\Linen\CsvWriter;
use Glhd\Linen\ExcelReader;
use Glhd\Linen\ExcelWriter;
use Glhd\Linen\Reader;
use Illuminate\Contracts\Database\Query\Builder;
use Illuminate\Support\Enumerable;
use InvalidArgumentException;
use Symfony\Component\Mime\MimeTypes;

class FileTypeHelper
{
	public function read(string $path): Reader
	{
		$mime = MimeTypes::getDefault()->guessMimeType($path);
		
		return match ($mime) {
			'application/msexcel',
			'application/x-msexcel',
			'zz-application/zz-winassoc-xls',
			'application/vnd.ms-excel',
			'application/vnd.ms-excel.sheet.binary.macroenabled.12',
			'application/vnd.ms-excel.sheet.macroenabled.12',
			'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
			'application/vnd.openxmlformats-officedocument.spreadsheetml.template' => ExcelReader::from($path),
			'application/csv',
			'text/csv',
			'text/csv-schema',
			'text/x-comma-separated-values',
			'text/x-csv',
			'text/plain' => CsvReader::from($path),
			default => throw new InvalidArgumentException("Unable to infer file type for '{$path}'"),
		};
	}
	
	public function write(array|Enumerable|Generator|Builder $data, string $path): string
	{
		$extension = pathinfo($path, PATHINFO_EXTENSION);
		
		$writer = match ($extension) {
			'xlsx', 'xls' => ExcelWriter::for($data),
			'csv' => CsvWriter::for($data),
			default => throw new InvalidArgumentException("Unable to infer file type for '{$path}'"),
		};
		
		return $writer->write($path);
	}
}


================================================
FILE: src/Support/WriteIterator.php
================================================
<?php

namespace Glhd\Linen\Support;

use Closure;
use Generator;
use Iterator;
use OpenSpout\Common\Entity\Row;
use OpenSpout\Writer\WriterInterface;

class WriteIterator implements Iterator
{
	protected int $written = 0;
	
	protected bool $open = false;
	
	protected bool $pending = false;
	
	public function __construct(
		public readonly string $path,
		protected Generator $generator,
		protected WriterInterface $writer,
		protected ?Closure $cleanup = null,
	) {
	}
	
	public function drain(): string
	{
		if (! $this->open) {
			$this->rewind();
		}
		
		while ($this->valid()) {
			$this->writeCurrentRow();
			$this->next();
		}
		
		return $this->path;
	}
	
	public function rewind(): void
	{
		$this->written = 0;
		$this->pending = true;
		
		$this->generator->rewind();
		
		$this->openWriter();
	}
	
	public function key(): mixed
	{
		return $this->generator->key();
	}
	
	/**
	 * To prevent unintended memory issues, we're only going to return the write count
	 * from the iterator. The iterator is just for handling progress/stepping, and not
	 * for accessing the underlying data.
	 *
	 * @return int
	 */
	public function current(): int
	{
		$this->writeCurrentRow();
		
		return $this->written;
	}
	
	public function next(): void
	{
		if (! $this->open) {
			return;
		}
		
		$this->generator->next();
		
		$this->pending = true;
	}
	
	public function valid(): bool
	{
		if (! $valid = $this->generator->valid()) {
			$this->closeWriter();
		}
		
		return $valid;
	}
	
	public function __destruct()
	{
		$this->closeWriter();
	}
	
	protected function openWriter(): void
	{
		if (! $this->open) {
			$this->writer->openToFile($this->path);
			$this->open = true;
		}
	}
	
	protected function writeCurrentRow(): void
	{
		if ($this->pending) {
			$this->writer->addRow(
				Row::fromValues($this->generator->current()->toArray())
			);
			
			$this->written++;
			$this->pending = false;
		}
	}
	
	protected function closeWriter(): void
	{
		if ($this->open) {
			$this->writer->close();
			
			if ($this->cleanup) {
				call_user_func($this->cleanup, $this->path);
			}
			
			$this->open = false;
		}
	}
}


================================================
FILE: src/Writer.php
================================================
<?php

namespace Glhd\Linen;

use Closure;
use Generator;
use Glhd\Linen\Support\WriteIterator;
use Illuminate\Contracts\Database\Query\Builder;
use Illuminate\Http\File;
use Illuminate\Support\Collection;
use Illuminate\Support\Enumerable;
use Illuminate\Support\LazyCollection;
use Illuminate\Support\Str;
use OpenSpout\Writer\WriterInterface;

abstract class Writer
{
	protected bool $headers = true;
	
	protected Closure $header_formatter;
	
	public static function for(array|Enumerable|Closure|Builder $data): static
	{
		return new static($data);
	}
	
	public function __construct(
		protected array|Enumerable|Closure|Builder $data,
	) {
		$this->header_formatter = Str::headline(...);
	}
	
	public function withoutHeaders(): static
	{
		$this->headers = false;
		
		return $this;
	}
	
	public function withHeaderFormatter(Closure $header_formatter): static
	{
		$this->header_formatter = $header_formatter;
		
		return $this;
	}
	
	public function withOriginalKeysAsHeaders(): static
	{
		return $this->withHeaderFormatter(static fn($key) => $key);
	}
	
	public function getIterator(?string $path = null): WriteIterator
	{
		$path ??= tempnam_with_cleanup();
		
		return new WriteIterator($path, $this->rows(), $this->writer());
	}
	
	public function write(string $path): string
	{
		return $this->getIterator($path)->drain();
	}
	
	public function writeToHttpFile(): File
	{
		return new File($this->writeToTemporaryFile());
	}
	
	public function writeToTemporaryFile(): string
	{
		return $this->write(tempnam_with_cleanup());
	}
	
	abstract protected function writer(): WriterInterface;
	
	/** @return Generator<Collection> */
	protected function rows(): Generator
	{
		$source = match (true) {
			$this->data instanceof Closure => LazyCollection::make($this->data),
			is_array($this->data) => Collection::make($this->data),
			$this->data instanceof Builder => $this->data->lazyById(),
			default => $this->data,
		};
		
		$needs_headers = $this->headers;
		
		foreach ($source as $row) {
			$row = Collection::make($row);
			
			if ($needs_headers) {
				$needs_headers = false;
				yield $row->keys()->map($this->header_formatter);
			}
			
			yield $row;
		}
	}
}


================================================
FILE: src/helpers.php
================================================
<?php

namespace Glhd\Linen;

use Illuminate\Support\Facades\App;

function tempnam_with_cleanup(): string
{
	$path = tempnam(sys_get_temp_dir(), 'glhd-linen-data');
	
	App::terminating(static fn() => @unlink($path));
	
	return $path;
}


================================================
FILE: tests/Feature/CsvReaderTest.php
================================================
<?php

namespace Glhd\Linen\Tests\Feature;

use Glhd\Linen\CsvReader;
use Glhd\Linen\Tests\TestCase;

class CsvReaderTest extends TestCase
{
	public function test_it_can_read_a_basic_csv_file_as_an_iterator(): void
	{
		$reader = CsvReader::from($this->fixture('basic.csv'));
		
		foreach ($reader as $index => $row) {
			$this->assertSame(match ($index) {
				0 => ['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
				1 => ['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
			}, $row->toArray());
		}
	}
	
	public function test_it_can_read_a_basic_csv_file_as_a_collection(): void
	{
		$collection = CsvReader::from($this->fixture('basic.csv'))->collect();
		
		foreach ($collection as $index => $row) {
			$this->assertSame(match ($index) {
				0 => ['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
				1 => ['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
			}, $row->toArray());
		}
	}
	
	public function test_if_headers_are_missing_column_numbers_are_used_as_keys(): void
	{
		$collection = CsvReader::from($this->fixture('more-columns-than-headers.csv'))->collect();
		
		foreach ($collection as $index => $row) {
			$this->assertSame(match ($index) {
				0 => ['user_id' => 1, 'name' => 'Chris', 'column3' => null, 'column4' => 40.2, 'column5' => null, 'column6' => null, 'column7' => null],
				1 => ['user_id' => 10, 'name' => 'Bogdan', 'column3' => 'not null', 'column4' => -37, 'column5' => null, 'column6' => null, 'column7' => null],
			}, $row->toArray());
		}
	}
}


================================================
FILE: tests/Feature/CsvWriterTest.php
================================================
<?php

namespace Feature;

use Glhd\Linen\CsvWriter;
use Glhd\Linen\Tests\TestCase;
use function Glhd\Linen\tempnam_with_cleanup;

class CsvWriterTest extends TestCase
{
	public function test_it_can_write_to_a_csv(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$path = CsvWriter::for($data)->writeToTemporaryFile();
		
		$written = file_get_contents($path);
		$expected = <<<CSV
		"User Id",Name,Nullable,Number
		1,Chris,,40.2
		10,Bogdan,"not null",-37
		CSV;
		
		$this->assertSame($expected, $written);
	}
	
	public function test_it_can_write_to_a_csv_with_a_new_line_at_end(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$path = CsvWriter::for($data)->withEmptyNewLineAtEndOfFile()->writeToTemporaryFile();
		
		$written = file_get_contents($path);
		$expected = <<<CSV
		"User Id",Name,Nullable,Number
		1,Chris,,40.2
		10,Bogdan,"not null",-37
		
		CSV;
		
		$this->assertSame($expected, $written);
	}
	
	public function test_it_can_write_with_an_iterator(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris'],
			['user_id' => 10, 'name' => 'Skyler'],
		];
		
		$iterator = CsvWriter::for($data)->getIterator(tempnam_with_cleanup());
		
		// Iterator returns [original key] => [rows written]
		$this->assertEquals(
			[0 => 1, 1 => 2, 2 => 3],
			iterator_to_array($iterator)
		);
		
		$written = file_get_contents($iterator->path);
		$expected = <<<CSV
		"User Id",Name
		1,Chris
		10,Skyler
		CSV;
		
		$this->assertSame($expected, $written);
	}
}


================================================
FILE: tests/Feature/ExcelReaderTest.php
================================================
<?php

namespace Feature;

use Glhd\Linen\ExcelReader;
use Glhd\Linen\Tests\TestCase;

class ExcelReaderTest extends TestCase
{
	public function test_it_can_read_a_basic_excel_file_as_an_iterator(): void
	{
		$reader = ExcelReader::from($this->fixture('basic.xlsx'));
		
		foreach ($reader as $index => $row) {
			if (0 === $index) {
				$this->assertEquals(1, $row['user_id']);
				$this->assertEquals('Chris', $row['name']);
				$this->assertEquals('2024-07-25', $row['date']->format('Y-m-d'));
				$this->assertEquals(40.20, $row['number']);
			} elseif (1 === $index) {
				$this->assertEquals(10, $row['user_id']);
				$this->assertEquals('Bogdan', $row['name']);
				$this->assertEquals('2024-07-20', $row['date']->format('Y-m-d'));
				$this->assertEquals(-37.0, $row['number']);
			}
		}
	}
	
	public function test_it_can_read_a_basic_excel_file_as_a_collection(): void
	{
		$collection = ExcelReader::from($this->fixture('basic.xlsx'))->collect();
		
		foreach ($collection as $index => $row) {
			if (0 === $index) {
				$this->assertEquals(1, $row['user_id']);
				$this->assertEquals('Chris', $row['name']);
				$this->assertEquals('2024-07-25', $row['date']->format('Y-m-d'));
				$this->assertEquals(40.20, $row['number']);
			} elseif (1 === $index) {
				$this->assertEquals(10, $row['user_id']);
				$this->assertEquals('Bogdan', $row['name']);
				$this->assertEquals('2024-07-20', $row['date']->format('Y-m-d'));
				$this->assertEquals(-37.0, $row['number']);
			}
		}
	}
}


================================================
FILE: tests/Feature/ExcelWriterTest.php
================================================
<?php

namespace Feature;

use Glhd\Linen\ExcelReader;
use Glhd\Linen\ExcelWriter;
use Glhd\Linen\Tests\TestCase;

class ExcelWriterTest extends TestCase
{
	public function test_it_can_write_to_an_excel_file(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$tempfile = ExcelWriter::for($data)->writeToTemporaryFile();
		
		$read = ExcelReader::read($tempfile)->toArray();
		
		$this->assertSame($data, $read);
	}
	
	public function test_it_can_write_to_an_excel_file_with_iterator(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$iterator = ExcelWriter::for($data)->getIterator();
		
		$this->assertEquals(
			[0 => 1, 1 => 2, 2 => 3],
			iterator_to_array($iterator),
		);
		
		$read = ExcelReader::read($iterator->path)->toArray();
		
		$this->assertSame($data, $read);
	}
}


================================================
FILE: tests/Feature/FacadeTest.php
================================================
<?php

namespace Feature;

use Glhd\Linen\ExcelReader;
use Glhd\Linen\Facades\Linen;
use Glhd\Linen\Tests\TestCase;

class FacadeTest extends TestCase
{
	public function test_it_can_read_a_basic_csv_file_via_the_facade(): void
	{
		$read = Linen::read($this->fixture('basic.csv'));
		
		foreach ($read as $index => $row) {
			$this->assertSame(match ($index) {
				0 => ['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
				1 => ['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
			}, $row->toArray());
		}
	}
	
	public function test_it_can_read_a_basic_excel_file_via_the_facade(): void
	{
		$read = Linen::read($this->fixture('basic.xlsx'));
		
		foreach ($read as $index => $row) {
			if (0 === $index) {
				$this->assertEquals(1, $row['user_id']);
				$this->assertEquals('Chris', $row['name']);
				$this->assertEquals('2024-07-25', $row['date']->format('Y-m-d'));
				$this->assertEquals(40.20, $row['number']);
			} elseif (1 === $index) {
				$this->assertEquals(10, $row['user_id']);
				$this->assertEquals('Bogdan', $row['name']);
				$this->assertEquals('2024-07-20', $row['date']->format('Y-m-d'));
				$this->assertEquals(-37.0, $row['number']);
			}
		}
	}
	
	public function test_it_can_write_a_basic_csv_file_via_the_facade(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$path = tempnam(sys_get_temp_dir(), 'glhd-linen-data').'.csv';
		
		$written = file_get_contents(Linen::write($data, $path));
		$expected = <<<CSV
		"User Id",Name,Nullable,Number
		1,Chris,,40.2
		10,Bogdan,"not null",-37
		CSV;
		
		$this->assertSame($expected, $written);
		
		unlink($path);
	}
	
	public function test_it_can_write_a_basic_excel_file_via_the_facade(): void
	{
		$data = [
			['user_id' => 1, 'name' => 'Chris', 'nullable' => null, 'number' => 40.2],
			['user_id' => 10, 'name' => 'Bogdan', 'nullable' => 'not null', 'number' => -37],
		];
		
		$path = tempnam(sys_get_temp_dir(), 'glhd-linen-data').'.xlsx';
		
		Linen::write($data, $path);
		
		$read = ExcelReader::read($path)->toArray();
		
		$this->assertSame($data, $read);
		
		@unlink($path);
	}
}


================================================
FILE: tests/TestCase.php
================================================
<?php

namespace Glhd\Linen\Tests;

use Orchestra\Testbench\TestCase as Orchestra;

abstract class TestCase extends Orchestra
{
	protected function fixture(string $filename): string
	{
		return __DIR__.'/fixtures/'.$filename;
	}
	
	protected function getPackageProviders($app)
	{
		return [];
	}
	
	protected function getPackageAliases($app)
	{
		return [];
	}
	
	protected function getApplicationTimezone($app)
	{
		return 'America/New_York';
	}
}


================================================
FILE: tests/fixtures/basic.csv
================================================
User ID,Name,Nullable,Number
1,Chris,,40.2
10,Bogdan,"not null",-37


================================================
FILE: tests/fixtures/more-columns-than-headers.csv
================================================
User ID,Name
1,Chris,,40.2,,,
10,Bogdan,"not null",-37