handlebars.js/release-notes.md

Release Notes

Development

• #602 - Handle zero uniformly between mustache conditionals and the if helper (@artiee)
• #535 - Fix for probably JIT error under Safari. (@sorentwo)
• #537 - Add CommonJS and AMD loader support (@spikebrehm)
• #544 - Push travis builds to build server (@fivetanley)

Compatibility notes:

• The project now includes separate artifacts for AMD, CommonJS, and global objects.
  • AMD: Users may load the bundled handlebars.amd.js or handlebars.runtime.amd.js files or load individual modules directly. AMD users should also note that the handlebars object is exposed via the default field on the imported object. This gist provides some discussion of possible compatibility shims.
  • CommonJS/Node: Node loading occurs as normal via require
  • Globals: The handlebars.js and handlebars.runtime.js files should behave in the same manner as the v1.0.12 / 1.0.0 release.
• Context-stored helpers are now always passed the options hash. Previously no-argument helpers did not have this argument.

Commits

v1.0.12 / 1.0.0 - May 31 2013

• #515 - Add node require extensions support (@jjclark1982)
• #517 - Fix amd precompiler output with directories (@blessenm)
• #433 - Add support for unicode ids
• #469 - Add support for ? in ids
• #534 - Protect from object prototype modifications
• #519 - Fix partials with . name (@jamesgorrie)
• #519 - Allow ID or strings in partial names
• #437 - Require matching brace counts in escaped expressions
• Merge passed partials and helpers with global namespace values
• Add support for complex ids in @data references
• Docs updates

Compatibility notes:

• The parser is now stricter on {{{, requiring that the end token be }}}. Templates that do not follow this convention should add the additional brace value.
• Code that relies on global the namespace being muted when custom helpers or partials are passed will need to explicitly pass an undefined value for any helpers that should not be available.
• The compiler version has changed. Precompiled templates with 1.0.12 or higher must use the 1.0.0 or higher runtime.

Commits

v1.0.11 / 1.0.0-rc4 - May 13 2013

• #458 - Fix ./foo syntax (@jpfiset)
• #460 - Allow : in unescaped identifers (@jpfiset)
• #471 - Create release notes (These!)
• #456 - Allow escaping of \\
• #211 - Fix exception in escapeExpression
• #375 - Escape unicode newlines
• #461 - Do not fail when compiling ""
• #302 - Fix sanity check in knownHelpersOnly mode
• #369 - Allow registration of multiple helpers and partial by passing definition object
• Add bower package declaration (@DevinClark)
• Add NuSpec package declaration (@MikeMayer)
• Handle empty context in with (@thejohnfreeman)
• Support custom template extensions in CLI (@matteoagosti)
• Fix Rhino support (@broady)
• Include contexts in string mode (@leshill)
• Return precompiled scripts when compiling to AMD (@JamesMaroney)
• Docs updates (@iangreenleaf, @gilesbowkett, @utkarsh2012)
• Fix toString handling under IE and browserify (@tommydudebreaux)
• Add program metadata

Commits

v1.0.10 - Node - Feb 27 2013

• #428 - Fix incorrect rendering of nested programs
• Fix exception message (@tricknotes)
• Added negative number literal support
• Concert library to single IIFE
• Add handlebars-source gemspec (@machty)

Commits

v1.0.9 - Node - Feb 15 2013

• Added Handlebars.create API in node module for sandboxed instances (@tommydudebreaux)

Commits

1.0.0-rc3 - Browser - Feb 14 2013

• Prevent use of this or .. in illogical place (@leshill)
• Allow AST passing for parse/compile/precompile (@machty)
• Optimize generated output by inlining statements where possible
• Check compiler version when evaluating templates
• Package browser dist in npm package

Commits

Prior Versions

When upgrading from the Handlebars 0.9 series, be aware that the signature for passing custom helpers or partials to templates has changed.

Instead of:

template(context, helpers, partials, [data])

Use:

template(context, {helpers: helpers, partials: partials, data: data})