RubyGems - importmap-rails - Versions diffs - 0.3.2 → 0.4.1 - Mend

importmap-rails 0.3.2 → 0.4.1

Files changed (15) hide show

checksums.yaml +4 -4
data/README.md +36 -17
data/app/assets/javascripts/es-module-shims.js +1 -1
data/app/assets/javascripts/{es-module-shims@0.12.6.js → es-module-shims@0.12.8.js} +49 -9
data/lib/importmap/commands.rb +24 -0
data/lib/importmap/engine.rb +4 -7
data/lib/importmap/map.rb +26 -13
data/lib/importmap/pinner.rb +32 -0
data/lib/importmap/reloader.rb +1 -1
data/lib/importmap/version.rb +1 -1
data/lib/install/bin/importmap +4 -0
data/lib/install/config/importmap.rb +20 -0
data/lib/install/install.rb +5 -21
data/lib/tasks/importmap_tasks.rake +6 -0
metadata +25 -7

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4edb628879c46f984d95884b643013077f408a899a1633f7007ef3274393b65
-  data.tar.gz: 627f45fe257131d3432d1f2cf210eb0fd133e286c293b101cfaf5b5a77840a47
+  metadata.gz: 3e7f034e1cb0febd2ab7dfd1b1422fd2b717368ea4e64e86a49ac2d92ba0db7c
+  data.tar.gz: 20a6b4114ccf1ee891f2ad255e70f50f8135421d6f1f1eeb68b6f73cd44d165a
 SHA512:
-  metadata.gz: cd44cdb515fed52817f75d453e274846979e9649e997bd4b2b67689a6761b294c33fdf1b7a9909042da0da2b99d11cbb1ad1a626519a2f528aa4cab5b61869ae
-  data.tar.gz: 301873edf08bb1c486dcdbebe65afbe5b3ff2d43fd9a78c51b9791e07152ae0742e93fcfd92fb936e2ce97adacc3e9ff3f6d2b3eacd15683e153e1c8d457997d
+  metadata.gz: 3eb40a5e05dd1541dcc53f69bb4610469a847f3a1a69591af02e002fb435627ef1b7173685a94db22936c6c50c5f5d2abcc3ea97508d3a06462ac80eb4354292
+  data.tar.gz: abe96793497d1ebedf3d0fc4a6ca4c8abe69f4e087a5df835a86dbc95c5c9ac13246aefa06ca92bdcd97d4647aa83cdccc4b9f69b27304c96bec074456236c11

data/README.md CHANGED Viewed

@@ -22,32 +22,53 @@ Note: In order to use JavaScript from Rails frameworks like Action Cable, Action
 The import map is configured programmatically through the `Rails.application.config.importmap` assignment, which by default is setup in `config/importmap.rb` after running the installer. This file is automatically reloaded in development upon changes, but note that you must restart the server if you remove pins and need them gone from the rendered importmap or list of preloads.
-This programmatically configured import map is inlined in the `<head>` of your application layout using `<%= javascript_importmap_tags %>`, which will setup the JSON configuration inside a `<script type="importmap">` tag. After that, the [es-module-shim](https://github.com/guybedford/es-module-shims) is loaded, and then finally the application entrypoint is imported via `<script type="module">import "application"</script>`. That logical entrypoint, `application`, is mapped in the importmap script tag to the file `app/assets/javascripts/application.js`, which is copied and digested by the asset pipeline.
+This programmatically configured import map is inlined in the `<head>` of your application layout using `<%= javascript_importmap_tags %>`, which will setup the JSON configuration inside a `<script type="importmap">` tag. After that, the [es-module-shim](https://github.com/guybedford/es-module-shims) is loaded, and then finally the application entrypoint is imported via `<script type="module">import "application"</script>`. That logical entrypoint, `application`, is mapped in the importmap script tag to the file `app/javascript/application.js`, which is copied and digested by the asset pipeline.
-It's in `app/assets/javascripts/application.js` you setup your application by importing any of the modules that have been defined in the import map. You can use the full ESM functionality of importing any particular export of the modules or everything.
+It's in `app/javascript/application.js` you setup your application by importing any of the modules that have been defined in the import map. You can use the full ESM functionality of importing any particular export of the modules or everything.
 It makes sense to use logical names that match the package names used by NPM, such that if you later want to start transpiling or bundling your code, you'll not have to change any module imports.
-## Use with Skypack (and other CDNs)
+## Using node modules via JavaScript CDNs
-Instead of mapping JavaScript modules to files in your application's path, you can also reference them directly from JavaScript CDNs like Skypack. Simply add them to the `config/importmap.rb` with the URL instead of the local path:
+Importmap for Rails is designed to be used with JavaScript CDNs for your node package dependencies. The CDNs provide pre-compiled distribution versions ready to use, and offer a fast, efficient way of serving them.
-```ruby
-Rails.application.config.importmap.draw do
-  pin "trix", to: "https://cdn.skypack.dev/trix"
-  pin "md5", to: "https://cdn.skypack.dev/md5"
-end
+You can use the `./bin/importmap` command that's added as part of the install to pin additional packages to your import map. This command uses an API from [JSPM.org](https://jspm.org) to resolve your package dependencies most efficiently, and then add the pins to your `config/importmap.rb` file. It can resolve these dependencies from JSPM itself, but also from other CDNs, like [unpkg.com](https://unpkg.com), [jsdelivr.com](https://www.jsdelivr.com), [skypack.dev](https://www.skypack.dev), etc.
+It works like so:
+```bash
+./bin/importmap pin react react-dom
+Pinned 'react' to https://ga.jspm.io/npm:react@17.0.2/index.js
+Pinned 'react-dom' to https://ga.jspm.io/npm:react-dom@17.0.2/index.js
+Pinned 'object-assign' to https://ga.jspm.io/npm:object-assign@4.1.1/index.js
+Pinned 'scheduler' to https://ga.jspm.io/npm:scheduler@0.20.2/index.js
+./bin/importmap json
+{
+  "imports": {
+    "application": "/application.js",
+    "react": "https://ga.jspm.io/npm:react@17.0.2/index.js",
+    "react-dom": "https://ga.jspm.io/npm:react-dom@17.0.2/index.js",
+    "object-assign": "https://ga.jspm.io/npm:object-assign@4.1.1/index.js",
+    "scheduler": "https://ga.jspm.io/npm:scheduler@0.20.2/index.js"
+  }
+}
 ```
+As you can see, the two packages react and react-dom resolve to a total of four dependencies, when resolved via the jspm default.
 Now you can use these in your application.js entrypoint like you would any other module:
 ```js
-import "trix"
-import md5 from "md5"
-console.log(md5("Hash it out"))
+import React from "react"
+import ReactDOM from "react-dom"
 ```
+Run `./bin/importmap` to see more options.
 ## Preloading pinned modules
@@ -57,16 +78,14 @@ Example:
 ```ruby
 # config/importmap.rb
-Rails.application.config.importmap.draw do
-  pin "trix", to: "https://cdn.skypack.dev/trix"
-  pin "md5", to: "https://cdn.skypack.dev/md5", preload: false
-end
+pin "@github/hotkey", to: "https://ga.jspm.io/npm:@github/hotkey@1.4.4/dist/index.js"
+pin "md5", to: "https://cdn.jsdelivr.net/npm/md5@2.3.0/md5.js", preload: false
 # app/views/layouts/application.html.erb
 <%= javascript_importmap_tags %>
 # will include the following link before the importmap is setup:
-<link rel="modulepreload" href="https://cdn.skypack.dev/trix">
+<link rel="modulepreload" href="https://ga.jspm.io/npm:@github/hotkey@1.4.4/dist/index.js">
 ...
 ```

data/app/assets/javascripts/es-module-shims.js CHANGED Viewed

	@@ -1 +1 @@
1	- //= require ./es-module-shims@0.12.6.js
1	+ //= require ./es-module-shims@0.12.8.js

data/app/assets/javascripts/{es-module-shims@0.12.6.js → es-module-shims@0.12.8.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-/* ES Module Shims 0.12.6 */
+/* ES Module Shims 0.12.8 */
 (function () {
   // Bail on all shimming for Chrome until https://github.com/guybedford/es-module-shims/issues/150
   if (navigator.userAgent.match("Chrome")) return
@@ -271,7 +271,7 @@
   let waitingForImportMapsInterval;
   let firstTopLevelProcess = true;
-  async function topLevelLoad (url, fetchOpts, source, nativelyLoaded) {
+  async function topLevelLoad (url, fetchOpts, source, nativelyLoaded, lastStaticLoadPromise) {
     // no need to even fetch if we have feature support
     await featureDetectionPromise;
     if (waitingForImportMapsInterval > 0) {
@@ -285,7 +285,7 @@
     await importMapPromise;
     // early analysis opt-out
     if (nativelyLoaded && supportsDynamicImport && supportsImportMeta && supportsImportMaps && supportsJsonAssertions && supportsCssAssertions && !importMapSrcOrLazy) {
-      // dont reexec inline for polyfills -> just return null
+      // dont reexec inline for polyfills -> just return null (since no module id for executed inline module scripts)
       return source && nativelyLoaded ? null : dynamicImport(source ? createBlob(source) : url);
     }
     await init;
@@ -294,17 +294,30 @@
     await loadAll(load, seen);
     lastLoad = undefined;
     resolveDeps(load, seen);
+    await lastStaticLoadPromise;
     if (source && !shimMode && !load.n) {
+      if (lastStaticLoadPromise) {
+        didExecForReadyPromise = true;
+        if (domContentLoaded)
+          didExecForDomContentLoaded = true;
+      }
       const module = dynamicImport(createBlob(source));
       if (shouldRevokeBlobURLs) revokeObjectURLs(Object.keys(seen));
       return module;
     }
     const module = await dynamicImport(load.b);
+    if (lastStaticLoadPromise && (!nativelyLoaded || load.b !== load.u)) {
+      didExecForReadyPromise = true;
+      if (domContentLoaded)
+        didExecForDomContentLoaded = true;
+    }
     // if the top-level load is a shell, run its update function
     if (load.s) {
       (await dynamicImport(load.s)).u$_(module);
     }
     if (shouldRevokeBlobURLs) revokeObjectURLs(Object.keys(seen));
+    // when tla is supported, this should return the tla promise as an actual handle
+    // so readystate can still correspond to the sync subgraph exec completions
     return module;
   }
@@ -354,6 +367,7 @@
   const skip = esmsInitOptions.skip || /^https?:\/\/(cdn\.skypack\.dev|jspm\.dev)\//;
   const onerror = esmsInitOptions.onerror || ((e) => { throw e; });
   const shouldRevokeBlobURLs = esmsInitOptions.revokeBlobURLs;
+  const noLoadEventRetriggers = esmsInitOptions.noLoadEventRetriggers;
   function urlJsString (url) {
     return `'${url.replace(/'/g, "\\'")}'`;
@@ -550,7 +564,7 @@
     return load;
   }
-  async function processScripts () {
+  function processScripts () {
     if (waitingForImportMapsInterval > 0 && document.readyState !== 'loading') {
       clearTimeout(waitingForImportMapsInterval);
       waitingForImportMapsInterval = 0;
@@ -558,7 +572,7 @@
     for (const link of document.querySelectorAll('link[rel="modulepreload"]'))
       processPreload(link);
     for (const script of document.querySelectorAll('script[type="module-shim"],script[type="importmap-shim"],script[type="module"],script[type="importmap"]'))
-      await processScript(script);
+      processScript(script);
   }
   function getFetchOpts (script) {
@@ -576,12 +590,29 @@
     return fetchOpts;
   }
-  async function processScript (script, dynamic) {
+  let staticLoadCnt = 0;
+  let didExecForReadyPromise = false;
+  let didExecForDomContentLoaded = false;
+  let lastStaticLoadPromise = Promise.resolve();
+  let domContentLoaded = false;
+  document.addEventListener('DOMContentLoaded', () => domContentLoaded = true);
+  function staticLoadCheck () {
+    staticLoadCnt--;
+    if (staticLoadCnt === 0 && !noLoadEventRetriggers) {
+      if (didExecForDomContentLoaded)
+        document.dispatchEvent(new Event('DOMContentLoaded'));
+      if (didExecForReadyPromise && document.readyState === 'complete')
+        document.dispatchEvent(new Event('readystatechange'));
+    }
+  }
+  function processScript (script, dynamic) {
     if (script.ep) // ep marker = script processed
       return;
     const shim = script.type.endsWith('-shim');
     if (shim) shimMode = true;
-    const type = shim ? script.type.slice(0, -5) : script.type;
+    const type = shimMode ? script.type.slice(0, -5) : script.type;
+    // dont process module scripts in shim mode or noshim module scripts in polyfill mode
     if (!shim && shimMode || script.getAttribute('noshim') !== null)
       return;
     // empty inline scripts sometimes show before domready
@@ -589,7 +620,14 @@
       return;
     script.ep = true;
     if (type === 'module') {
-      await topLevelLoad(script.src || `${baseUrl}?${id++}`, getFetchOpts(script), !script.src && script.innerHTML, !shim).catch(onerror);
+      const isReadyScript = document.readyState !== 'complete';
+      if (isReadyScript) staticLoadCnt++;
+      const p = topLevelLoad(script.src || `${baseUrl}?${id++}`, getFetchOpts(script), !script.src && script.innerHTML, !shimMode, isReadyScript && lastStaticLoadPromise);
+      p.catch(onerror);
+      if (isReadyScript) {
+        lastStaticLoadPromise = p.catch(staticLoadCheck);
+        p.then(staticLoadCheck);
+      }
     }
     else if (type === 'importmap') {
       importMapPromise = importMapPromise.then(async () => {
@@ -605,6 +643,8 @@
     if (link.ep) // ep marker = processed
       return;
     link.ep = true;
+    if (fetchCache[link.href])
+      return;
     fetchCache[link.href] = doFetch(link.href, getFetchOpts(link));
   }
@@ -655,4 +695,4 @@
     waitingForImportMapsInterval = setInterval(processScripts, 20);
   }
-}());
+}());

data/lib/importmap/commands.rb ADDED Viewed

@@ -0,0 +1,24 @@
+require "thor"
+require "importmap/pinner"
+class Importmap::Commands < Thor
+  desc "pin [*PACKAGES]", "Pin new packages"
+  option :env, type: :string, aliases: :e, default: "production"
+  option :from, type: :string, aliases: :f, default: "jspm"
+  def pin(*packages)
+    if imports = Importmap::Pinner.new.pin(*packages, env: options[:env], from: options[:from])
+      imports.each do |package, url|
+        puts "Pinned '#{package}' to #{url}"
+      end
+    else
+      puts "Couldn't find any packages in #{packages.inspect} on #{options[:provider]}"
+    end
+  end
+  desc "json", "Show the full importmap in json"
+  def json
+    puts Rails.application.config.importmap.to_json(resolver: ActionController::Base.helpers)
+  end
+end
+Importmap::Commands.start(ARGV)

data/lib/importmap/engine.rb CHANGED Viewed

@@ -2,19 +2,16 @@ require "importmap/map"
 module Importmap
   class Engine < ::Rails::Engine
-    config.importmap = Importmap::Map.new
+    config.importmap = Importmap::Map.new.draw("config/importmap.rb")
     config.autoload_once_paths = %W( #{root}/app/helpers )
     initializer "importmap.reloader" do |app|
       app.config.paths.add "config/importmap.rb"
-      reloader = Importmap::Reloader.new
-      reloader.execute
-      app.reloaders << reloader
-      app.reloader.to_run do
+      Importmap::Reloader.new.tap do |reloader|
         reloader.execute
+        app.reloaders << reloader
+        app.reloader.to_run { reloader.execute }
       end
     end

data/lib/importmap/map.rb CHANGED Viewed

@@ -1,17 +1,30 @@
+require "pathname"
 class Importmap::Map
-  attr_reader :files, :directories
+  attr_reader :packages, :directories
   attr_accessor :cached
   def initialize
-    @files, @directories = {}, {}
+    @packages, @directories = {}, {}
   end
-  def draw(&block)
-    instance_eval(&block)
+  def draw(path = nil, &block)
+    if path
+      begin
+        instance_eval(File.read(path))
+      rescue Exception => e
+        Rails.logger.error "Unable to parse import map from #{path}: #{e.message}"
+        raise "Unable to parse import map from #{path}: #{e.message}"
+      end
+    else
+      instance_eval(&block)
+    end
+    self
   end
   def pin(name, to: nil, preload: true)
-    @files[name] = MappedFile.new(name: name, path: to || "#{name}.js", preload: preload)
+    @packages[name] = MappedFile.new(name: name, path: to || "#{name}.js", preload: preload)
   end
   def pin_all_from(dir, under: nil, to: nil, preload: true)
@@ -20,19 +33,19 @@ class Importmap::Map
   def preloaded_module_paths(resolver:)
     cache_as(:preloaded_module_paths) do
-      resolve_asset_paths(expanded_preloading_files_and_directories, resolver: resolver).values
+      resolve_asset_paths(expanded_preloading_packages_and_directories, resolver: resolver).values
     end
   end
   def to_json(resolver:)
     cache_as(:json) do
-      { "imports" => resolve_asset_paths(expanded_files_and_directories, resolver: resolver) }.to_json
+      JSON.pretty_generate({ "imports" => resolve_asset_paths(expanded_packages_and_directories, resolver: resolver) })
     end
   end
   private
-    MappedFile = Struct.new(:name, :path, :preload, keyword_init: true)
     MappedDir  = Struct.new(:dir, :path, :under, :preload, keyword_init: true)
+    MappedFile = Struct.new(:name, :path, :preload, keyword_init: true)
     def cache_as(name)
       if (cached && result = instance_variable_get("@cached_#{name}"))
@@ -53,12 +66,12 @@ class Importmap::Map
       end.compact
     end
-    def expanded_preloading_files_and_directories
-      expanded_files_and_directories.select { |name, mapping| mapping.preload }
+    def expanded_preloading_packages_and_directories
+      expanded_packages_and_directories.select { |name, mapping| mapping.preload }
     end
-    def expanded_files_and_directories
-      @files.dup.tap { |expanded| expand_directories_into expanded }
+    def expanded_packages_and_directories
+      @packages.dup.tap { |expanded| expand_directories_into expanded }
     end
     def expand_directories_into(paths)
@@ -80,7 +93,7 @@ class Importmap::Map
     end
     def module_path_from(filename, mapping)
-      [ mapping.path || mapping.under, filename.to_s ].join("/")
+      [ mapping.path || mapping.under, filename.to_s ].compact.join("/")
     end
     def find_javascript_files_in_tree(path)

data/lib/importmap/pinner.rb ADDED Viewed

@@ -0,0 +1,32 @@
+require "httparty"
+class Importmap::Pinner
+  include HTTParty
+  base_uri "https://api.jspm.io"
+  def pin(*packages, env: "production", from: "jspm")
+    fetch_imports(*packages, env: env, provider: from)&.tap do |imports|
+      imports.each do |package, url|
+        append_to_importmap package, url
+      end
+    end
+  end
+  private
+    def append_to_importmap(package, url)
+      Rails.root.join("config/importmap.rb").open("a") do |config|
+        config.puts %(pin "#{package}", to: "#{url}")
+      end
+    end
+    def fetch_imports(*packages, env:, provider:)
+      response = self.class.post("/generate", body: {
+        "install"      => Array(packages),
+        "flattenScope" => true,
+        "env"          => [ "browser", "module", env ],
+        "provider"     => provider.to_s
+      }.to_json)
+      response.dig("map", "imports")
+    end
+end

data/lib/importmap/reloader.rb CHANGED Viewed

@@ -2,7 +2,7 @@ class Importmap::Reloader
   delegate :execute_if_updated, :execute, :updated?, to: :updater
   def reload!
-    import_map_paths.each { |path| load path }
+    import_map_paths.each { |path| config.importmap.draw(path) }
   end
   private

data/lib/importmap/version.rb CHANGED Viewed

@@ -1,3 +1,3 @@
 module Importmap
-  VERSION = "0.3.2"
+  VERSION = "0.4.1"
 end

data/lib/install/bin/importmap ADDED Viewed

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require_relative "../config/application"
+require "importmap/commands"

data/lib/install/config/importmap.rb ADDED Viewed

@@ -0,0 +1,20 @@
+# Use Action Cable channels (remember to import "@rails/actionable" in your application.js)
+# pin "@rails/actioncable", to: "actioncable.esm.js"
+# pin_all_from "app/javascript/channels", under: "channels"
+# Use direct uploads for Active Storage (remember to import "@rails/activestorage" in your application.js)
+# pin "@rails/activestorage", to: "activestorage.esm.js"
+# Pin vendored modules by first adding the following to app/assets/config/manifest.js:
+# //= link_tree ../../../vendor/assets/javascripts .js
+# pin_all_from "vendor/assets/javascripts"
+# JavaScript CDN provider. Also available: :jsdelivr, :esmsh, :unpkg, :skypack
+provider :jspm
+# Use NPM libraries from CDN
+# pin "local-time", version: "2.1.0", file: "app/assets/javascripts/local-time.js"
+# pin "vue", version: "2.6.14", file: "dist/vue.esm.browser.js", from: :jsdelivr
+# pin "d3", version: "7.0.1", file: "?bundle", from: :esmsh
+pin "application"

data/lib/install/install.rb CHANGED Viewed

@@ -10,10 +10,7 @@ end
 say "Create application.js module as entrypoint"
 create_file Rails.root.join("app/javascript/application.js") do <<-JS
-// Configure your import map in config/importmap.rb
-// import "@rails/actioncable"
-// import "@rails/activestorage"
+// Configure your import map in config/importmap.rb. Read more: https://github.com/rails/importmap-rails
 JS
 end
@@ -21,21 +18,8 @@ say "Ensure JavaScript files are in the asset pipeline manifest"
 append_to_file Rails.root.join("app/assets/config/manifest.js"), %(//= link_tree ../../javascript .js\n)
 say "Configure importmap paths in config/importmap.rb"
-create_file Rails.root.join("config/importmap.rb") do <<-RUBY
-Rails.application.config.importmap.draw do
-  pin "application"
-  # Use libraries available via the asset pipeline (locally or via gems).
-  # pin "@rails/actioncable", to: "actioncable.esm.js"
-  # pin "@rails/activestorage", to: "activestorage.esm.js"
-  # Use libraries directly from JavaScript CDNs (see https://www.skypack.dev, https://esm.sh, https://www.jsdelivr.com/esm)
-  # pin "vue", to: "https://cdn.jsdelivr.net/npm/vue@2.6.14/dist/vue.esm.browser.js"
-  # pin "d3", to: "https://esm.sh/d3?bundle"
+copy_file "#{__dir__}/config/importmap.rb", "config/importmap.rb"
-  # Pin vendored modules by first adding the following to app/assets/config/manifest.js:
-  # //= link_tree ../../../vendor/assets/javascripts .js
-  # pin_all_from "vendor/assets/javascripts"
-end
-RUBY
-end
+say "Copying binstub"
+copy_file "#{__dir__}/bin/importmap", "bin/importmap"
+chmod "bin", 0755 & ~File.umask, verbose: false

data/lib/tasks/importmap_tasks.rake CHANGED Viewed

@@ -3,4 +3,10 @@ namespace :importmap do
   task :install do
     system "#{RbConfig.ruby} ./bin/rails app:template LOCATION=#{File.expand_path("../install/install.rb",  __dir__)}"
   end
+  desc "Show the importmap"
+  task :pins do
+    require Rails.root.join("config/environment")
+    puts Rails.application.config.importmap.to_json(resolver: ActionController::Base.helpers)
+  end
 end

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: importmap-rails
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.1
 platform: ruby
 authors:
 - David Heinemeier Hansson
-autorequire:
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-23 00:00:00.000000000 Z
+date: 2021-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -24,7 +24,21 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 6.0.0
-description:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.16'
+description:
 email: david@loudthinking.com
 executables: []
 extensions: []
@@ -34,13 +48,17 @@ files:
 - README.md
 - Rakefile
 - app/assets/javascripts/es-module-shims.js
-- app/assets/javascripts/es-module-shims@0.12.6.js
+- app/assets/javascripts/es-module-shims@0.12.8.js
 - app/helpers/importmap/importmap_tags_helper.rb
 - lib/importmap-rails.rb
+- lib/importmap/commands.rb
 - lib/importmap/engine.rb
 - lib/importmap/map.rb
+- lib/importmap/pinner.rb
 - lib/importmap/reloader.rb
 - lib/importmap/version.rb
+- lib/install/bin/importmap
+- lib/install/config/importmap.rb
 - lib/install/install.rb
 - lib/shim.js
 - lib/tasks/importmap_tasks.rake
@@ -50,7 +68,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/rails/importmap-rails
   source_code_uri: https://github.com/rails/importmap-rails
-post_install_message:
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -66,7 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.4
-signing_key:
+signing_key:
 specification_version: 4
 summary: Use ESM with importmap to manage modern JavaScript in Rails without transpiling
   or bundling.