handlebarsjs 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4962fdcc88f1a68831b1907b713aa3f8996ca23dee96da1d970545a2875c0b44
-  data.tar.gz: 3eaa1ec0405fc12467286ac2e0db49af24269f7fe589e0365ce16439b43799c3
+  metadata.gz: d738c40219cfaa348afd07afcb59bc572ea7ee40d2cb35f5b28f7b9273e05e01
+  data.tar.gz: 65f1494627bc268671e240d1d133a73dd79ccbdfdbbb3f0eb38baa19831cff47
 SHA512:
-  metadata.gz: a5aa1c58ae7e8de87949843cd3b6d90abcc04928c55a97181fca747b64aa7e2e53af87c16ee89c05112136dc8723b521caf1058948476ce7c38db46030d6a6b9
-  data.tar.gz: f50f5ad4daff693c4c9b0ef2f3756f2073b952165178831ac0e7361986021d0d54e100aae0647fc66aa7dd58d0173dd5639901c842349a61df5ce57025525830
+  metadata.gz: 0a720a3372be65f40f4e43450c480b416679366011eda8e3d6fc9dc479ddbbcc05d11a3f408fed14d9da7c615cea72d890afffc9c142a2e31f18c8ab5e606d30
+  data.tar.gz: 46c659bce100021e60775a1b1b25faeb399cdc6caf8747dee1778eef395be16aa20f2bd0c5a3f1ee45a86044b320ba919117ae52f13ccd85a9fa325542e82acf

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.7.0](https://github.com/klueless-io/handlebarsjs/compare/v0.6.3...v0.7.0) (2022-07-15)
+
+
+### Features
+
+* add alias support ([ae81c61](https://github.com/klueless-io/handlebarsjs/commit/ae81c61d569dd44e9ae50832f69a0f29d30e9523))
+
 ## [0.6.3](https://github.com/klueless-io/handlebarsjs/compare/v0.6.2...v0.6.3) (2022-07-14)
 
 

data/lib/_.rb

@@ -31,3 +31,4 @@ require_relative 'handlebarsjs/helpers/inflection/pluralize'
 require_relative 'handlebarsjs/helpers/inflection/pluralize_number'
 require_relative 'handlebarsjs/helpers/inflection/pluralize_number_word'
 require_relative 'handlebarsjs/helpers/inflection/singularize'
+require_relative 'handlebarsjs/helpers/misc/safe'

data/lib/handlebarsjs/base_helper.rb

@@ -4,20 +4,27 @@ module Handlebarsjs
   # Extend base helper for each of your custom handlebars-helpers
   class BaseHelper
     attr_reader :cmdlet
+    attr_reader :safe
+    attr_reader :parameter_names
 
     # Preferred way to register the internal command is via register_cmdlet
     # but you can also register the command directly in the initializer and
     # that can be handy if you use a custom configured cmdlet
-    def initialize(cmdlet = nil)
-      @cmdlet = cmdlet
-      @cmdlet = self.class.cmdlet.new if @cmdlet.nil? && self.class.cmdlet
+    def initialize(cmdlet = nil, safe: nil, parameter_names: nil)
+      initialize_cmdlet(cmdlet)
+      initialize_safe(safe)
+      initialize_parameter_names(parameter_names)
     end
 
     class << self
       attr_reader :cmdlet
+      attr_reader :safe
+      attr_reader :parameter_names
 
-      def register_cmdlet(cmdlet)
+      def register_cmdlet(cmdlet, safe: false, parameter_names: [])
         @cmdlet = cmdlet
+        @safe = safe
+        @parameter_names = parameter_names
       end
     end
 
@@ -33,5 +40,24 @@ module Handlebarsjs
     def to_proc
       ->(value, _opts) { wrapper(cmdlet.call(value)) }
     end
+
+    private
+
+    def initialize_cmdlet(cmdlet)
+      @cmdlet = cmdlet
+      @cmdlet = self.class.cmdlet.new if @cmdlet.nil? && self.class.cmdlet
+    end
+
+    def initialize_safe(safe)
+      @safe = safe
+      @safe = self.class.safe if @safe.nil? && self.class.safe
+      @safe = false if @safe.nil?
+    end
+
+    def initialize_parameter_names(parameter_names)
+      @parameter_names = parameter_names
+      @parameter_names = self.class.parameter_names if parameter_names.nil? && self.class.parameter_names
+      @parameter_names = [] if @parameter_names.nil?
+    end
   end
 end

data/lib/handlebarsjs/handlebars.rb

@@ -10,6 +10,24 @@ module Handlebarsjs
       add_configured_helpers
     end
 
+    class << self
+      def register_helper_script(name)
+        <<-JAVASCRIPT
+          Handlebars.registerHelper('#{name}', ruby_#{name})
+        JAVASCRIPT
+      end
+
+      def register_safe_string_helper_script(name, parameter_names)
+        parameters = (parameter_names + ['_opts']).join(', ')
+
+        <<-JAVASCRIPT
+          Handlebars.registerHelper('#{name}', function (#{parameters}) {
+            return new Handlebars.SafeString(ruby_#{name}(#{parameters}));
+          })
+        JAVASCRIPT
+      end
+    end
+
     def process_template(template, options = {})
       # TODO: process template function may be improved with some type of caching
       context.call('process_template', template, options)

data/lib/handlebarsjs/handlebars_configuration.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Handlebarsjs
-  # handlebars.handlebars_snapshot.add_helper(helper_name, helper)
-  # Structure for storing Cmdlet configuration
+  # Configuration data such has helpers for handlebarsjs
   class HandlebarsConfiguration
     include KLog::Logging
 

data/lib/handlebarsjs/handlebars_configuration_defaults.rb

@@ -8,6 +8,7 @@ module Handlebarsjs
       add_case_defaults
       add_comparison_defaults
       add_inflection_defaults
+      add_misc_defaults
     end
 
     def add_array_defaults
@@ -31,7 +32,7 @@ module Handlebarsjs
         config.handlebars.helper(:lower, Handlebarsjs::Helpers::Case::Lower.new, aliases: %i[lowercase downcase])
         config.handlebars.helper(:slash, Handlebarsjs::Helpers::Case::Slash.new, aliases: %i[forward_slash slash_forward])
         config.handlebars.helper(:snake, Handlebarsjs::Helpers::Case::Snake.new)
-        config.handlebars.helper(:title, Handlebarsjs::Helpers::Case::Title.new)
+        config.handlebars.helper(:title, Handlebarsjs::Helpers::Case::Title.new, aliases: %i[titleize])
         config.handlebars.helper(:upper, Handlebarsjs::Helpers::Case::Upper.new, aliases: %i[upcase uppercase])
       end
     end
@@ -60,5 +61,11 @@ module Handlebarsjs
         config.handlebars.helper(:singularize, Handlebarsjs::Helpers::Inflection::Singularize.new)
       end
     end
+
+    def add_misc_defaults
+      KConfig.configure do |config|
+        config.handlebars.helper(:safe, Handlebarsjs::Helpers::Misc::Safe.new)
+      end
+    end
   end
 end

data/lib/handlebarsjs/handlebars_snapshot.rb

@@ -25,10 +25,23 @@ module Handlebarsjs
     end
 
     def add_helper(name, helper)
-      return add_helper_entry(name, callback: helper) if helper.is_a?(Proc)
-      return add_helper_entry(name, helper: helper, callback: helper.to_proc) if helper.respond_to?(:to_proc)
+      add_helper_entry(
+        name: name,
+        helper: helper,
+        callback: helper.to_proc,
+        safe: helper.safe,
+        parameters: helper.parameter_names
+      )
+    end
 
-      raise Handlebarsjs::Error, 'helper must be a callback or implement to_proc method' if callback.nil?
+    def add_callback(name, callback, safe, parameters)
+      add_helper_entry(
+        name: name,
+        helper: nil,
+        callback: callback,
+        safe: safe,
+        parameters: parameters
+      )
     end
 
     def register_helper(name)
@@ -43,18 +56,16 @@ module Handlebarsjs
       @snapshot ||= MiniRacer::Snapshot.new(script)
     end
 
-    # rubocop:disable Style/DocumentDynamicEvalDefinition
     def new_context
       context = MiniRacer::Context.new(snapshot: snapshot)
 
-      helpers.each do |helper|
-        context.attach("ruby_#{helper[:name]}", helper[:callback])
-        context.eval("Handlebars.registerHelper('#{helper[:name]}', ruby_#{helper[:name]})")
+      helpers.each do |helper_entry|
+        attach_ruby(context, helper_entry)
+        eval_register_helper(context, helper_entry)
       end
 
       context
     end
-    # rubocop:enable Style/DocumentDynamicEvalDefinition
 
     # not currently used
     def dirty?
@@ -66,6 +77,19 @@ module Handlebarsjs
       log.structure(data)
     end
 
+    def debug_register_scripts
+      register_scripts = helpers.map do |helper|
+        # Handlebarsjs::Handlebars.register_safe_string_helper_script(
+        #   helper[:name]
+        # )
+        # helper[:helper].build_register_helper_script(
+        #   helper[:name],
+        #   safe: helper[:safe]
+        # )
+      end
+      puts register_scripts.join("\n")
+    end
+
     private
 
     def add_script(name, type, script: nil, path: nil)
@@ -76,12 +100,18 @@ module Handlebarsjs
       add_script_item(name, type, script, path)
     end
 
-    def add_helper_entry(name, helper: nil, callback: nil)
-      @helpers << {
-        name: name,
-        helper: helper,
-        callback: callback
+    def add_helper_entry(**args)
+      entry = {
+        name: args[:name],
+        helper: args[:helper],
+        callback: args[:callback],
+        safe: args[:safe],
+        parameters: args[:parameters]
       }
+
+      @helpers << entry
+
+      entry
     end
 
     def add_script_item(name, type, script, path = nil)
@@ -93,5 +123,29 @@ module Handlebarsjs
         path: path
       }
     end
+
+    # This context should be on handlebars, not snapshot (I THINK)
+    def attach_ruby(context, helper_entry)
+      name = helper_entry[:name]
+      callback = helper_entry[:callback]
+
+      context.attach("ruby_#{name}", callback)
+    end
+
+    def eval_register_helper(context, helper_entry)
+      script = if helper_entry[:safe]
+                 Handlebarsjs::Handlebars.register_safe_string_helper_script(helper_entry[:name], helper_entry[:parameters])
+               else
+                 Handlebarsjs::Handlebars.register_helper_script(helper_entry[:name])
+               end
+
+      context.eval(script)
+    end
+
+    def build_register_helper_script(helper_entry)
+      return Handlebarsjs::Handlebars.register_safe_string_helper_script(helper_entry[:name], helper_entry[:parameters]) if helper_entry[:safe]
+
+      Handlebarsjs::Handlebars.register_helper_script(helper_entry[:name])
+    end
   end
 end

data/lib/handlebarsjs/helpers/misc/safe.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Handlebarsjs
+  module Helpers
+    # Miscellaneous cmdlets
+    module Misc
+      # Safe: pass through the value with <> and single and double quotes left as is
+      class Safe < Handlebarsjs::BaseHelper
+        register_cmdlet(Cmdlet::Misc::Safe, safe: true, parameter_names: [:value])
+
+        def to_proc
+          ->(value, _opts) { wrapper(cmdlet.call(value)) }
+        end
+      end
+    end
+  end
+end

data/lib/handlebarsjs/javascript/handlebars-4.7.7.js

@@ -314,6 +314,23 @@ return /******/ (function(modules) { // webpackBootstrap
 	  logger: _logger2['default'],
 	  log: _logger2['default'].log,
 
+
+    // Handlebars.registerHelper('encodeMyString',function(inputData){
+    //   return new Handlebars.SafeString(inputData);
+    // });
+    // safeStringHelper: safeStringHelper(name, fn)
+
+    // How do I write a callback function to wrap a callback function in javascript
+    // registerSafeHelper: function registerSafeHelper(name, fn) {
+    //   new_function: function(fn) {
+    //     return function(context, options) {
+    //       return new Handlebars.SafeString(fn(context, options)); "<hello />"
+    //     };
+    //   }
+    //   registerHelper(name, new_function)
+    // },
+
+
 	  registerHelper: function registerHelper(name, fn) {
 	    if (_utils.toString.call(name) === objectType) {
 	      if (fn) {

data/lib/handlebarsjs/javascript/handlebars-helpers.js

@@ -1,3 +1,12 @@
 Handlebars.registerHelper('loud', function (input) {
   return input.toUpperCase()
-})
+})
+
+Handlebars.registerHelper('allow_html', function (some_html) {
+  return new Handlebars.SafeString(some_html);
+})
+
+// Handlebars.registerHelper('i_am_safe_xxx', function (some_html) {
+//   some_html = "doe some thing"
+//   return new Handlebars.SafeString(some_html);
+// })

data/lib/handlebarsjs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Handlebarsjs
-  VERSION = '0.7.0'
+  VERSION = '0.8.0'
 end

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "handlebarsjs",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "handlebarsjs",
-      "version": "0.7.0",
+      "version": "0.8.0",
       "devDependencies": {
         "@klueless-js/semantic-release-rubygem": "github:klueless-js/semantic-release-rubygem",
         "@semantic-release/changelog": "^6.0.1",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handlebarsjs",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "handlebarsjs GEM wraps the handlebars.js library and provides ruby/javascript interoperability",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handlebarsjs
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-07-15 00:00:00.000000000 Z
+date: 2022-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cmdlet
@@ -128,6 +128,7 @@ files:
 - lib/handlebarsjs/helpers/inflection/pluralize_number.rb
 - lib/handlebarsjs/helpers/inflection/pluralize_number_word.rb
 - lib/handlebarsjs/helpers/inflection/singularize.rb
+- lib/handlebarsjs/helpers/misc/safe.rb
 - lib/handlebarsjs/javascript.rb
 - lib/handlebarsjs/javascript/handlebars-4.7.7.js
 - lib/handlebarsjs/javascript/handlebars-api.js