lib/importmap/map.rb
require "pathname" require "active_support/evented_file_update_checker" class Importmap::Map attr_reader :packages, :directories def initialize @packages, @directories = {}, {} end def draw(path = nil, &block) if path && File.exist?(path) begin instance_eval(File.read(path), path.to_s) 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 elsif block_given? instance_eval(&block) end self end def pin(name, to: nil, preload: true) clear_cache @packages[name] = MappedFile.new(name: name, path: to || "#{name}.js", preload: preload) end def pin_all_from(dir, under: nil, to: nil, preload: true) clear_cache @directories[dir] = MappedDir.new(dir: dir, under: under, path: to, preload: preload) end def preloaded_module_paths(resolver:) cache_as(:preloaded_module_paths) do resolve_asset_paths(expanded_preloading_packages_and_directories, resolver: resolver).values end end def to_json(resolver:) cache_as(:json) do JSON.pretty_generate({ "imports" => resolve_asset_paths(expanded_packages_and_directories, resolver: resolver) }) end end # Returns a SHA1 digest of the import map json that can be used as a part of a page etag to # ensure that a html cache is invalidated when the import map is changed. # # Example: # # class ApplicationController < ActionController::Base # etag { Rails.application.importmap.digest(resolver: helpers) if request.format&.html? } # end def digest(resolver:) Digest::SHA1.hexdigest(to_json(resolver: resolver).to_s) end # Returns an instance ActiveSupport::EventedFileUpdateChecker configured to clear the cache of the map # when the directories passed on initialization via `watches:` have changes. This is used in development # and test to ensure the map caches are reset when javascript files are changed. def cache_sweeper(watches: nil) if watches @cache_sweeper = ActiveSupport::EventedFileUpdateChecker.new([], Array(watches).collect { |dir| [ dir, "js"] }.to_h) do clear_cache end else @cache_sweeper end end private MappedDir = Struct.new(:dir, :path, :under, :preload, keyword_init: true) MappedFile = Struct.new(:name, :path, :preload, keyword_init: true) def cache_as(name) if result = instance_variable_get("@cached_#{name}") result else instance_variable_set("@cached_#{name}", yield) end end def clear_cache @cached_json = nil @cached_preloaded_module_paths = nil end def resolve_asset_paths(paths, resolver:) paths.transform_values do |mapping| begin resolver.asset_path(mapping.path) rescue Sprockets::Rails::Helper::AssetNotFound Rails.logger.warn "Importmap skipped missing path: #{mapping.path}" nil end end.compact end def expanded_preloading_packages_and_directories expanded_packages_and_directories.select { |name, mapping| mapping.preload } end def expanded_packages_and_directories @packages.dup.tap { |expanded| expand_directories_into expanded } end def expand_directories_into(paths) @directories.values.each do |mapping| if (absolute_path = absolute_root_of(mapping.dir)).exist? find_javascript_files_in_tree(absolute_path).each do |filename| module_filename = filename.relative_path_from(absolute_path) module_name = module_name_from(module_filename, mapping) module_path = module_path_from(module_filename, mapping) paths[module_name] = MappedFile.new(name: module_name, path: module_path, preload: mapping.preload) end end end end def module_name_from(filename, mapping) [ mapping.under, filename.to_s.remove(filename.extname).remove(/\/?index$/).presence ].compact.join("/") end def module_path_from(filename, mapping) [ mapping.path || mapping.under, filename.to_s ].compact.join("/") end def find_javascript_files_in_tree(path) Dir[path.join("**/*.js{,m}")].collect { |file| Pathname.new(file) }.select(&:file?) end def absolute_root_of(path) (pathname = Pathname.new(path)).absolute? ? pathname : Rails.root.join(path) end end