├── CHANGELOG.md
├── LICENSE.md
├── README.md
├── bin
└── importmap
├── composer.json
├── config
└── importmap.php
├── rector.php
├── resources
└── views
│ ├── .gitkeep
│ └── components
│ └── tags.blade.php
├── src
├── Actions
│ ├── FixJsImportPaths.php
│ └── ReplaceOrAppendTags.php
├── AssetResolver.php
├── Commands
│ ├── AuditCommand.php
│ ├── ClearCacheCommand.php
│ ├── InstallCommand.php
│ ├── JsonCommand.php
│ ├── OptimizeCommand.php
│ ├── OutdatedCommand.php
│ ├── PackagesCommand.php
│ ├── PinCommand.php
│ ├── UnpinCommand.php
│ └── UpdateCommand.php
├── Events
│ └── FailedToFixImportStatement.php
├── Exceptions
│ ├── FailedToFixImportStatementException.php
│ └── ImportmapException.php
├── Facades
│ └── Importmap.php
├── FileDigest.php
├── Importmap.php
├── ImportmapLaravelServiceProvider.php
├── Manifest.php
├── MappedDirectory.php
├── MappedFile.php
├── Npm.php
├── OutdatedPackage.php
├── PackageVersion.php
├── Packager.php
└── VulnerablePackage.php
└── stubs
├── js
└── app.js
├── jsconfig.json
└── routes
└── importmap.php
/CHANGELOG.md:
--------------------------------------------------------------------------------
1 | # Changelog
2 |
3 | All notable changes to `importmap-laravel` will be documented in this file.
4 |
5 | ## 2.4.0 - 2025-03-02
6 |
7 | ### What's Changed
8 |
9 | * Laravel 12.x Compatibility by @laravel-shift in https://github.com/tonysm/importmap-laravel/pull/59
10 |
11 | **Full Changelog**: https://github.com/tonysm/importmap-laravel/compare/2.3.2...2.4.0
12 |
13 | ## 2.3.1 - 2024-03-13
14 |
15 | ### What's Changed
16 |
17 | - Skip adding the `
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in
13 | all copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 | THE SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
7 |
8 |
10 |
11 |
13 |
14 |
15 | ## Introduction
16 |
17 | Use ESM with importmap to manage modern JavaScript in Laravel without transpiling or bundling.
18 |
19 | ### Inspiration
20 |
21 | This package was inspired by the [Importmap Rails](https://github.com/rails/importmap-rails) gem. Some pieces of this README were copied straight from there and adapted to the Laravel version.
22 |
23 | ### How does it work?
24 |
25 | [Import maps](https://github.com/WICG/import-maps) lets you import JavaScript modules directly from the browser using logical names that map to versioned/digested files. So you can [build modern JavaScript applications using JavaScript libraries made for ES modules (ESM) without the need for transpiling or bundling](https://world.hey.com/dhh/modern-web-apps-without-javascript-bundling-or-transpiling-a20f2755). This frees you from needing Webpack, Yarn, npm, or any other part of the JavaScript toolchain.
26 |
27 | With this approach, you'll ship many small JavaScript files instead of one big JavaScript file. Thanks to HTTP/2 that no longer carries a material performance penalty during the initial transport, and offers substantial benefits over the long run due to better caching dynamics. Whereas before any change to any JavaScript file included in your big bundle would invalidate the cache for the whole bundle, now only the cache for that single file is invalidated.
28 |
29 | [Import maps are supported natively in all major, modern browsers](https://caniuse.com/?search=importmap). If you need to work with legacy browsers without native support, you may want to explore using [the shim available](https://github.com/guybedford/es-module-shims).
30 |
31 | ## Installation
32 |
33 | You can install the package via Composer:
34 |
35 | ```bash
36 | composer require tonysm/importmap-laravel
37 | ```
38 |
39 | The package has an `install` command that you may run to replace the default Laravel scaffold with one to use importmap:
40 |
41 | ```bash
42 | php artisan importmap:install
43 | ```
44 |
45 | Next, we need to add the following component to our view or layout file:
46 |
47 | ```blade
48 | 
6 |
7 |
8 | 
