Add Version 1

Author: amsul

README.md

@@ -1 +1,11 @@
-# template-literals
+# template-literals
+
+String templates using tagged template literals
+
+```js
+// Create a template
+const template = tag `hi, ${'name'}!`
+
+// Render the template
+template({ name: 'amsul' }) // 'hi, amsul!'
+```

index.js

@@ -0,0 +1,39 @@
+/**
+ * Creates a tagged template to use for interpolating values into a string.
+ * Primarily "inspired" by https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#Tagged_template_literals
+ *
+ * @example
+ * const message = tag `${0} ${'name'}!`
+ * message('Hello', { name: 'Amsul' }) // 'Hello Amsul!'
+ *
+ * @example
+ * const message = tag `It goes ${0} ${1} and back to ${0}`
+ * message('one', 'two') // 'It goes one two and back to one'
+ *
+ * @param  {String[]} strings       The array that contains the string templates.
+ * @param  {...String|Number} keys  The keys to use for interpolating values.
+ * @return {Function}               The tagged template.
+ */
+export const tag = (strings, ...keys) => (...values) => {
+
+  const dict = values[values.length - 1] || {}
+  const result = [strings[0]]
+  const getValue = createGetValue(values, dict)
+
+  keys.forEach((key, index) => {
+    const value = getValue(key)
+    result.push(value, strings[index + 1])
+  })
+
+  return result.join('')
+}
+
+const createGetValue = (values, dict) => (key) => {
+  const value = Number.isInteger(key) ? values[key] : dict[key]
+  const valueType = typeof value
+  if (valueType !== 'number' && valueType !== 'string') {
+    console.error('The value for the key %o must be a string or number: %o', key, value)
+    return ''
+  }
+  return value
+}

package.json

@@ -0,0 +1,9 @@
+{
+  "name": "template-literals",
+  "version": "1.0.0",
+  "description": "String templates using tagged template literals",
+  "main": "index.js",
+  "repository": "https://github.com/amsul/template-literals",
+  "author": "Amsul <[email protected]>",
+  "license": "MIT"
+}