papercraft 0.27 → 0.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd2f4f4d1ebc2cfc5718079d68c9393b3d95def9c02b057107425ddd5b45eaf3
-  data.tar.gz: f3f82f29227e22e5e31b0d685bcab211ebbef0ecf8a4433d251cb1f204875cf7
+  metadata.gz: eccca55a3b242b80413bad0c851619062d66c1b68eaa9f2e4a13ca9e4beefddf
+  data.tar.gz: a5cf234c36fe286a94d6607bc30e13a24568396f6fe78b2f0e22870618e97941
 SHA512:
-  metadata.gz: 7389861bea04a92e06ce1a53a682ef3b4db1bf975bb7f5e63cef0ed6c1a4ebb4b92920a0bb4ea04eba24dc72b41c70ba8fac0d8aa605a2b5a720d7860198b7e0
-  data.tar.gz: 2a617260deef291c56cd0c3fc1b275d47dd1dc95bdeeafc69289d630260480e49126c29f0ec77c177fd6c1032c633ba2568be1ffb767e13f91e51b5a9c298831
+  metadata.gz: 003a30933c7d7557a346ce02bcc54169427389db2e488ee5516b68b9e99d74f2b5f0464db4e327c1c3064bc7cbfe0df9c4ef0df6322b61a467f14f30a83b415c
+  data.tar.gz: cc8d7e819fdefc04a5ffb1966d707d6fb7e533bc0c8f6d3fc39191749c4733593850a4cb046648c010c2ae4daae6fbaa6980b806a1ab61d9746481dc63fd8ecf

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.28 2023-03-11
+
+- Add `HTML#import_map`, `HTML#js_module` methods
+
 ## 0.27 2023-01-19
 
 - Fix rendering of HTML void element tags

data/lib/papercraft/html.rb

@@ -71,7 +71,47 @@ module Papercraft
         @buffer << '></script>'
       end
     end
+
+    # Returns a versioned URL for the given file spec.
+    #
+    # @param href [String] relative file path
+    # @param root_path [String] root path for file
+    # @param root_url [String] root URL
+    # @return [String] versioned URL
+    def versioned_file_href(href, root_path, root_url = '')
+      fn = File.join(root_path, href)
+      version = File.stat(fn).mtime.to_i rescue 0
+      "#{root_url}/#{href}?v=#{version}"
+    end  
   
+    # Emits an import map scrit tag. If a hash is given, emits the hash as is.
+    # If a string is given, searches for all *.js files under the given path,
+    # and emits an import map including all found files, with versioned URLs.
+    #
+    # @param root_path [String, Hash] root path or hash
+    # @param root_url [String] root URL to construct URLs against
+    # @return [void]
+    def import_map(root_path, root_url = '')
+      if root_path.is_a?(Hash)
+        script(root_path.to_json, type: 'importmap')
+      else
+        map = Dir["#{root_path}/*.js"].sort.each_with_object({}) do |fn, h|
+          name = File.basename(fn)
+          m = fn.match(/\/([^\/]+)\.js$/)
+          h[m[1]] = versioned_file_href(name, root_path, root_url)
+        end
+        script(map.to_json, type: 'importmap')
+      end
+    end
+
+    # Emits a script tag with type attribute set to module.
+    #
+    # @param code [String] JS code
+    # @return [void]
+    def js_module(code)
+      script code, type: 'module'
+    end
+
     # Converts and emits the given markdown. Papercraft uses
     # [Kramdown](https://github.com/gettalong/kramdown/) to do the Markdown to
     # HTML conversion. Optional Kramdown settings can be provided in order to

data/lib/papercraft/tags.rb

@@ -198,7 +198,6 @@ module Papercraft
       tag = sym.to_s
       if tag =~ /^[A-Z]/ && (Object.const_defined?(tag))
         define_const_tag_method(tag)
-        # return send(tag, *args, **opts)
       else
         define_tag_method(tag)
       end

data/lib/papercraft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Papercraft
-  VERSION = '0.27'
+  VERSION = '0.28'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: papercraft
 version: !ruby/object:Gem::Version
-  version: '0.27'
+  version: '0.28'
 platform: ruby
 authors:
 - Sharon Rosner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-19 00:00:00.000000000 Z
+date: 2023-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: escape_utils