ajturner

benstoltz

dbouwman

dmfenton

mjuniper

patrickarlt

rsteilberg

rweber.esri

tomwayson

akharris

jordantsanz

adlib

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

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

- point package.module at rollup esm bundle

- 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.4 - Mon Dec 02 2019 11:41:55 GMT-0800 (Pacific Standard Time)

* adlib - v3.0.4 - Mon May 04 2020 13:40:38 GMT-0700 (Pacific Daylight 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.4 - Mon Dec 02 2019 11:41:53 GMT-0800 (Pacific Standard Time)

* adlib - v3.0.4 - Mon May 04 2020 13:40:36 GMT-0700 (Pacific Daylight 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/prod.js && 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",

    "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.

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,2 +5,6 @@ # Change Log

		## 3.0.5
		### Fixed
		- point package.module at rollup esm bundle

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

		/**
		* adlib - v3.0.4 - Mon Dec 02 2019 11:41:55 GMT-0800 (Pacific Standard Time)
		* Copyright (c) 2017-2019 Dave Bouwman / Esri
		* adlib - v3.0.4 - Mon May 04 2020 13:40:38 GMT-0700 (Pacific Daylight Time)
		* Copyright (c) 2017-2020 Dave Bouwman / Esri
		* Apache-2.0
		@@ -5,0 +5,0 @@ */

		/**
		* adlib - v3.0.4 - Mon Dec 02 2019 11:41:53 GMT-0800 (Pacific Standard Time)
		* Copyright (c) 2017-2019 Dave Bouwman / Esri
		* adlib - v3.0.4 - Mon May 04 2020 13:40:36 GMT-0700 (Pacific Daylight Time)
		* Copyright (c) 2017-2020 Dave Bouwman / Esri
		* Apache-2.0
		@@ -5,0 +5,0 @@ */

		{
		"name": "adlib",
		"version": "3.0.4",
		"version": "3.0.5",
		"description": "Templating for deep JSON object graphs",
		"main": "dist/adlib.js",
		"module": "lib/index.js",
		"module": "dist/adlib.esm.js",
		"unpkg": "dist/adlib.umd.js",
		@@ -17,3 +17,3 @@ "files": [
		"build": "rollup -c profiles/dev.js",
		"build:release": "rollup -c profiles/umd.js && rollup -c profiles/prod.js && 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",
		"test": "node test/duct.js",
		@@ -20,0 +20,0 @@ "test:compiled": "mocha test/*.spec.js",

		@@ -404,6 +404,6 @@ # adlib
		```
		git add .
		git add CHANGELOG.md
		yarn test && yarn run build:release
		npm version -f [ major \| minor \| patch ]
		git push --tags
		yarn run build:release
		git push origin master --tags
		npm publish
		@@ -410,0 +410,0 @@ ```

Fixed alerts

Improved metrics

Worsened metrics