ajturner

benstoltz

dbouwman

dmfenton

mjuniper

patrickarlt

rsteilberg

rweber.esri

tomwayson

akharris

jordantsanz

adlib

geemike

All notable changes to this project will be documented in this file.

This project adheres to [Semantic Versioning](http://semver.org/).

- ensure an `undefined` param does not prevent further interpolations in the same string

- fix typo in build:release script causing missing esm dist

var settings = { person: { name: 'larry'}};

  chk:  '{{person.name}}<br />{{person.age}}<br />{{person.name}}

// > 'larry<br />{{person.age}}<br />larry 

- did not know 3.0.2 was released... bump again?

- perform a deep object clone of `transforms` so that the object passed in is not modified

- initial value of the transform param is `undefined` instead of `null` so that the `level` arg is properly set to 0 for `optionalTransform`

- correctly interpolate values that are empty strings

- this library no longer mixes default and named [exports](https://rollupjs.org/guide/en#exporting).

Since `adlib` is the namespace for _all_ the functions we export, this means that UMD consumers will now call `adlib.adlib()`.

- changed regex pattern and added `trim` so that handlebars contents can include whitespace that will get ignored

- adlib.listDependencies function to list all variables in a template

- upgraded build/test dependencies to eliminate possible vulnerabilities with `growl < 1.10.0`

- allow more chars in templates - now allows for `{{{foo.bar||http://s.com/123/_(foo)_/ウォ/🏹.?b=c&d=f}}}`

- we had a regression where `{{{obj.val}}}` was not coming out as `{TheValue}` which means info window templating was broken. Also Regex--

- support for `default` values like `Hello my name is {{obj.name||Slim Shady}}`. If `obj.name` is undefined, the default value is used.

- ability to specify a hierarchy of possible values in order of preference in a template, e.g. `this dataset was last modified {{metadata.some.nested.timestamp||item.modified}}`

- removed lodash depencencies. Public API remains the same, and all existing tests pass. Should be a drop-in replacement, but bumped to 2.0.0 because we removed the deps which others may be using indirectly.

- falsey values were being incorrectly omitted from arrays - i.e. `[255,0,0,155]` would return as `[255,155]`

- renamed `profiles/dev.js` --> `profiles/umd.js` as it's actually doing umd builds

- `/docs/js` folder that contains simple homepage & current build - mainly for use prototyping stuff in jsbin

- transform fn signature changed to `fn(key, value, settings)`

- removed need to key|value specifier in the template `{{<key>:<transformFnName>}}`

* adlib - v3.0.6 - Wed Oct 28 2020 11:15:57 GMT-0600 (Mountain Daylight Time)

* adlib - v3.0.6 - Thu Dec 17 2020 17:08:10 GMT-0800 (Pacific Standard Time)

  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :

  typeof define === 'function' && define.amd ? define(['exports'], factory) :

  (global = global || self, factory(global.adlib = {}));

}(this, function (exports) { 'use strict';

     Licensed under the Apache License, Version 2.0 (the "License");

     you may not use this file except in compliance with the License.

     You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software

     distributed under the License is distributed on an "AS IS" BASIS,

     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

     See the License for the specific language governing permissions and

   * Return the value of a deep property, using a path.

  var getWithDefault = function (obj, path, defaultValue) {

    if ( defaultValue === void 0 ) defaultValue = undefined;

    .reduce(function (o, p) { return o ? o[p] : defaultValue; }, obj);

   * Simply Map over the props of an object

    var newObject = keys.reduce(function(acc, currentKey) {

      // console.log(`   acc: ${JSON.stringify(acc)} curKey: ${currentKey}`);

      acc[currentKey] = fn(obj[currentKey], currentKey, obj);

    // console.info(`  output: ${JSON.stringify(newObject)}`);

  var isDate = function (v) { return v instanceof Date; };

  var isFunction = function (v) { return typeof v === 'function'; };

  var isObject = function (v) { return typeof v === 'object'; };

  var isRegExp = function (v) { return v instanceof RegExp; };

  function deepMapValues(object, callback, propertyPath) {

      return object.map(deepMapValuesIteratee);

    else if(object && isObject(object) && !isDate(object) && !isRegExp(object) && !isFunction(object)){

      return Object.assign({}, object, mapValues(object, deepMapValuesIteratee));

      var output = callback(object, propertyPath);

    function deepMapValuesIteratee(value, key){

      var valuePath = propertyPath ? propertyPath + '.' + key : key;

      return deepMapValues(value, callback, valuePath);

* adlib - v3.0.6 - Wed Oct 28 2020 11:15:55 GMT-0600 (Mountain Daylight Time)

* adlib - v3.0.6 - Thu Dec 17 2020 17:08:08 GMT-0800 (Pacific Standard Time)

  "description": "Templating for deep JSON object graphs",

    "start": "npm run build && concurrently \"watch 'npm run build' lib\" \"mocha -w\"",

    "build": "rollup -c profiles/dev.js",

    "build:release": "rollup -c profiles/umd.js && rollup -c profiles/umd.js && rollup -c profiles/prod.js && rollup -c profiles/dev.js",

    "build:release": "yarn run clean && rollup -c profiles/umd.js && rollup -c profiles/esm.js && rollup -c profiles/prod.js && rollup -c profiles/dev.js",

    "test:compiled": "mocha test/*.spec.js",

    "chk": "yarn test && yarn build:release && yarn test:compiled"

    "url": "git+https://github.com/Esri/adlib.git"

    "url": "https://github.com/Esri/adlib/issues"

  "homepage": "https://arcgis.github.io/ember-arcgis-adlib-service",

    "babel-plugin-transform-es2015-destructuring": "^6.23.0",

    "babel-plugin-transform-es2015-function-name": "^6.24.1",

    "babel-plugin-transform-es2015-parameters": "^6.24.1",

    "babel-preset-es2015-rollup": "^3.0.0",

    "eslint-config-semistandard": "~12.0.1",

    "rollup-plugin-node-resolve": "^5.2.0",

[![build status][travis-img]][travis-url]

[![apache licensed](https://img.shields.io/badge/license-Apache-green.svg?style=flat-square)](https://raw.githubusercontent.com/Esri/adlib/master/LICENSE)

[npm-img]: https://img.shields.io/npm/v/adlib.svg?style=flat-square

[npm-url]: https://www.npmjs.com/package/adlib

[travis-img]: https://img.shields.io/travis/Esri/adlib/master.svg?style=flat-square

[travis-url]: https://travis-ci.org/Esri/adlib

> A JavaScript library for interpolating property values in JSON Objects.

The [ArcGIS Hub](https://hub.arcgis.com) team uses adlib to build Web Maps, Hub Sites, Hub Pages and other newly created ArcGIS Online content using customer [Open Data](https://hub.arcgis.com/pages/open-data) on the fly.

To get a feel for how adlib works, check out this [Live Demo](https://arcgis.github.io/ember-arcgis-adlib-service/)!

import { adlib, listDependencies }  from 'adlib'

adlib(template, settings) // renders an adlib template

listDependencies(template) // list all dependecies of an adlib template

This package is distributed as a [UMD](https://github.com/umdjs/umd) module and can also be used in AMD based systems or as a global under the `adlib` namespace.

TypeScript definitions are available from [DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/adlib):

const result = adlib(template, settings);

**Note** Adlib does not mutate the template, it returns a new object that contains copies of the template properties with interpolations applied. This allows the template to be used multiple times in succession with different settings hashes.

Gets a list of all variables your template depends upon

const template = 'Injuries: {{CRASHID}}<br />On Scene: {{ISREPORTONSCENE}}'

const deps = adlib.listDependencies(template); // CRASHID, ISREPORTONSCENE

Within the template, the value of any property can be described using `{{obj.prop}}`.

If the `obj.prop` "path" in the settings object is a string, that string value is assigned to the value.

A property of a template can have a value like `'The {{thing.animal}} was {{thing.color}}'`. When combined with a settings object that has the appropriate values, this will result in `The fox was brown`.

  value: 'The {{thing.animal}} was {{thing.color}}'

If the interpolated value is an object, it is returned. This allow us to graft trees of json together.

Update the CHANGELOG w/ release content and then run these commands:

First, get the latest code and update dependencies.

Then, make sure the `version` in `package.json` is the same as what's released (you can check against `npm view` if unsure).

Next, update the CHANGELOG w/ release content and then run these commands:

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

> http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

A copy of the license is available in the repository's [LICENSE](./LICENSE) file.

		@@ -5,20 +5,6 @@ # Change Log


		## 3.0.6
		### Fixed
		- ensure an `undefined` param does not prevent further interpolations in the same string
		- fix typo in build:release script causing missing esm dist

		```js
		var settings = { person: { name: 'larry'}};
		var tmpl = {
		chk: '{{person.name}}<br />{{person.age}}<br />{{person.name}}
		};

		adlib(tmpl, settings);
		// > 'larry<br />{{person.age}}<br />larry
		```

		## 3.0.5
		-- sorry no notes

		## 3.0.4
		@@ -25,0 +11,0 @@ ### Changed

		/**
		* adlib - v3.0.6 - Wed Oct 28 2020 11:15:57 GMT-0600 (Mountain Daylight Time)
		* adlib - v3.0.6 - Thu Dec 17 2020 17:08:10 GMT-0800 (Pacific Standard Time)
		* Copyright (c) 2017-2020 Dave Bouwman / Esri
		@@ -4,0 +4,0 @@ * Apache-2.0

		/**
		* adlib - v3.0.6 - Wed Oct 28 2020 11:15:55 GMT-0600 (Mountain Daylight Time)
		* adlib - v3.0.6 - Thu Dec 17 2020 17:08:08 GMT-0800 (Pacific Standard Time)
		* Copyright (c) 2017-2020 Dave Bouwman / Esri
		@@ -4,0 +4,0 @@ * Apache-2.0

		{
		"name": "adlib",
		"version": "3.0.6",
		"version": "3.0.7",
		"description": "Templating for deep JSON object graphs",
		@@ -17,3 +17,3 @@ "main": "dist/adlib.js",
		"build": "rollup -c profiles/dev.js",
		"build:release": "rollup -c profiles/umd.js && rollup -c profiles/umd.js && rollup -c profiles/prod.js && rollup -c profiles/dev.js",
		"build:release": "yarn run clean && rollup -c profiles/umd.js && rollup -c profiles/esm.js && rollup -c profiles/prod.js && rollup -c profiles/dev.js",
		"test": "node test/duct.js",
		@@ -20,0 +20,0 @@ "test:compiled": "mocha test/*.spec.js",

		@@ -401,6 +401,15 @@ # adlib

		Update the CHANGELOG w/ release content and then run these commands:
		First, get the latest code and update dependencies.

		```
		git add CHANGELOG.md
		git pull master --tags
		yarn
		```

		Then, make sure the `version` in `package.json` is the same as what's released (you can check against `npm view` if unsure).

		Next, update the CHANGELOG w/ release content and then run these commands:

		```
		git add .
		yarn test && yarn run build:release
		@@ -407,0 +416,0 @@ npm version -f [ major \| minor \| patch ]

Improved metrics