CHANGELOG.md

Changelog

4.x

4.13.x

4.13.7

• Prevent treating components with tag params being treated as implicit components. #1149

4.13.6

• Prevent mutating component input when using a single spread attribute with repeated @tags. #1142
• Fix for include tag hydration when transcluded. #1143

4.13.5

• Add additional reference to fragment nodes which resolves an issue with IE. #1130

4.13.4

• Remove Object.assign calls in the browser. #1120

4.13.3

• Propagate errors to express automatically with the res.marko api. #1119
• Support multi line import statments. #1118

4.13.2

• Allow discovering tags where the template name matches the directory name #1117:

components/
  tag-name/
    tag-name.marko
    tag-name.style.css

4.13.1

• Remove es2015 features from runtime. #1115

4.13.0

PR #1094

Introducing HTMLFragment

• Updates the diffing algorithm to use an HTMLFragment node as an abstraction rather than keeping track of startNode and endNode all throughout the diffing algorithm.
• Uses the HTMLFragment for the <${dynamic}> tag and <include> tags to preserve server-rendered content for which the renderBody is not available in the browser.

Changes to keys

• Component ids are based on the resulting parent tree (not the owner tree). This means we cannot rely on the ids in the global lookup, so component key/refs are now also stored on the component instance.
• Autokeyed elements are now stored on the parent rather than the owner. User assigned key/refs are still stored on the owner component. Because of this, user assigned keys are now prefixed to differentiate them from autokeys. This also has the benefit that assigning numeric keys can no longer conflict with the autokeys.
• Static node trees are now only auto assigned a key for the top-level node (instead of all nodes). This is because:
  • When updating, only the top-level node is considered.
  • When static nodes are hoisted out of the render method, they are not associated with the owner component

Changes to Hydration

• Server comment starting markers now have the component's key serialized so the component can be attached to its owner
• Server comment markers no longer have the id on the closing marker, it is stack based.
• Normalize differences between hydration and client-rendering, so post mount the DOM looks the same regardless of whether a component was server or client rendered.

4.12.x

4.12.4

• Don't render invalid attribute names on the server #1103

4.12.3

• Removes extra parenthesis in output javascript for expressions that Marko does not understand.

4.12.2

• Fixes automatic keying of elements/components in for() attribute loops

4.12.1

• Fix #1022 - transcluded keys don't match, stateful component not preserved #1086

4.12.0

• Tag params #1076
• Style arrays #1082
• Fix #1075 - cannot compile dynamic tag at root with user key #1081
• Fix #1078 - mutating spread attributes #1080

4.11.x

4.11.5

• Add fallback location for compile-time deprecation warnings

4.11.4

• Fixes an issue with scoped attributes automatically setting keys in a problematic way #1069
• Fixes #1059 and #1052 - Cannot read property 'nextSibling' of null

4.11.3

• Fixes #952
• Fixes automatic keying of elements/components in <for> loops

4.11.2

• Fixes another regression in the <${dynamic}> tag where dashed-case attributes were being converted to camelCase when rendering html elements.

4.11.1

• Fixes a regression in <${dynamic}> tags for object/array class/style attributes:

  $ const style = { color:'blue' };
  <${tagName} style=style/>

• Allows dynamic attributes defined using ...spread to include object/array class/style #933:

  $ const attrs = { style:{ color:'blue' } };
  <tag ...attrs/>

• Fixes issue where object/array class/style attributes could not be used with ...spread #1007:

  $ const attrs = {};
  <tag class=["oops"] ...attrs/>

4.11.0

• Implement #880: <${dynamic}> tag
• <include> should be considered deprecated. Formal deprecation warning to come.

4.10.x

4.10.1

• Fix issue with calling require('marko/components').init(components) multiple times.

4.10.0

• Fix #1049 Fix documentation urls on the website.

4.9.x

4.9.7

• Fix #1038 Legacy compatibility dirty check returning false positives.

4.9.6

• Fix #1008 Spread attribute now supports functions (..attrs()) #1029

4.9.5

• Fix onBeforeUpdate timing for legacy component layer #1027

4.9.4

• Fix breaking older browsers with es6 object shorthand notation bc0e91d5

4.9.3

• Fix import-var compilation when there are no explicit attributes #1002

4.9.2

• Fixes collisions with multiple Marko runtimes on the same page. #1019
• Switch to using prettier and eslint. #1016

4.9.1

• Fixes an issue with keyed elements not getting properly removed. #1013

4.9.0

• Fixes related to hydration, split components, and the legacy compatibility layer #1010

• Fix paths for vdom dependencies #1011

4.8.x

4.8.0

• Add once-[event] directive #990

• Improve testing setup #989

4.7.x

4.7.5

• Update docs for advanced attribute definition #968

• Improve error message for async rendering #958

4.7.4

• Make jQuery optional for legacy components #951

4.7.3

• Prevent onRender running on the server for legacy widgets

4.7.2

• Fixes #946 - don't put legacy init code in a separate lasso bundle

• Fixes allowing conditionally binding to different roots in a legacy widget #944

4.7.1

• Fix issue with multiple top level elements being removed twice. #940

4.7.0

• Add jQuery legacy compatibility layer support #937

• Reorganize Marko tests #934

• Switch to using jsdom in test suite #935

• Decouple component hydration from Lasso #929

4.6.x

4.6.0

• Fixes #914 and #920 - Resolves top-level component bugs

• Setup marko.load() to prefer precompiled templates from marko-cli

• Various compiler changes to improve marko-migrate

• Fixes #916 - Add Marko debug mode. Adds babel plugin to remove and statically evaluate 'MARKO_DEBUG' literals for adding deprecation warnings and hints for the runtime without a performance penalty for production builds.

4.5.x

4.5.6

• Fixes #909 - Fix condition preventing bubbling DOM events from properly being attached to a component.

4.5.5

• Add 10 Awesome Marko Features article to documentation

4.5.4

• Fixes #904 - The loop status variable is not compiling when the equal sign is padded in spacing

4.5.3

• Fixes #903 - Special unicode chars (\u2028 and \u2029) need to be escaped if within script tag

4.5.2

• Fixes #899 - Keyed element could be incorrectly removed after DOM diffing/patching in case of HTML element mismatch for elements with the same key. PR #900

4.5.1

• Fixes #893 - Keyed element could be incorrectly removed after DOM diffing/patching in case of HTML element mismatch for elements with the same key. PR #894 by @westtrade

4.5.0

Summary of changes across all beta releases for the 4.5.0 release:

• Fixes #886 - Write component initialization code when async out and all of its nested async outs finish
• Fixes #854 - Make every .marko file a UI component (PR #855)
• Added support for the :scoped modifier on attributes and deprecated :key:

<label for:scoped="name">Name</label>
<input id:scoped="name" value="Frank"/>

• Fixes #817 - Support dynamic root elements
• Marko no longer attaches id attributes to elements for purposes of keyed matching
  • Keyed elements are maintained in an internal, per-component lookup
• Keys are now assigned to all custom tags and HTML elements at compile-time to improve reliability and performance of DOM diffing
• Optimized internal bookkeeping required during rendering a UI component tree (no more UI component stack)
• DOM diffing/patching changes:
  • Significant performance improvements
  • morphdom is now UI component-aware

4.5.0-beta.3

• Fixes #854 - Make every .marko file a UI component (PR #855)

4.5.0-beta.2

• Add ids for any key when component.elId/getElId is used as an attribute value
• Use indexOf instead of includes to support Node 4
• [docs] Fixes #841 - docs/components.md refers to deprecated "data" variable #842

4.5.0-beta.1

• Add back (legacy) support for component.elId + key in template
• Fixes #837 - Update esprima to the latest to support async/await and ES2017 inside of components. (PR #839)
• Fixes key/scope for attributes that have dashes in the name

4.5.0-beta.0

• Fixes #817 - Support dynamic root elements
• Marko no longer attaches id attributes to elements for purposes of keyed matching
  • Keyed elements are maintained in an internal, per-component lookup
• Keys are now assigned to all custom tags and HTML elements at compile-time to improve reliability and performance of DOM diffing
• Optimized internal bookkeeping required during rendering a UI component tree (no more UI component stack)
• DOM diffing/patching changes:
  • Significant performance improvements
  • morphdom is now UI component-aware

4.4.x

4.4.28

• fix undefined reference error in Component.js
• Increase mocha timeout to avoid CI build's failing #821

4.4.27

• Add ability to update globals by setting new input.
• [docs] Remove uneeded command from installation docs
• [docs] Update installing.md

4.4.26

• Add better interop for importing modules with default exports #803

4.4.25

• Fixes #778 - Fix Marko compiler generating incorrect path for requires on Windows.

4.4.24

• [docs] Update installing.md

4.4.23

• Fixes #796 - Fix events for event targets that are SVGElementInstance types in IE11.
• Used shortcut for escapeAtTags;
• Added escapeAtTags options in order to render <@tags> as they are;
• simplify a condition judgement in components-jquery
• Fixes #790 - Class tag should not allow nested body content.
• Update compile/index.js test description
• Update handleRootNodes.js #747
• [docs] Fix reference to lifecycle section in docs.

4.4.22

• Fixes #784 - Fix compiled preserve-attrs path.
• [testing] Fix express tests #779
• [docs] Update webpack.md

4.4.21

• Updated description in package.json

4.4.20

• update bindComponentVar to use dynamic location
• updating location of bindComponent helper

4.4.19

• [testing] Fix key suffix test assertions.
• Address key suffix feedback. Additional tests.
• [morphdom] Removed bad and unhelpful optimization to avoid infinite loops
• [morphdom] Ensure onBeforeNodeDiscarded is only called once by looking to see if the node is still attached.
• [morphdom] Infinite loop fix in morphdom
• Fixes #761 - component.elId() does not work on the server
• Fixes #755 - Allow diffing of HTML, head, and body. #756
• [docs] Updated component docs
• [docs] Use relative link for image
• [testing] User default npm version for each Node.js version

4.4.18

• Fixes #749 #690 - Do not rely on root node having an ID on rerender and properly handle style root nodes.

4.4.17

• Put package (browser.json) deps before others and parent deps before child deps #750
• [docs] Fix typo in redux.md
• [docs] Add redux document to structure.json
• [docs] Add doc describing how to use Redux with Marko.

4.4.16

• Fix duplicate body variable

4.4.15

• Fixes #739 - Should not attempt to check instanceof of type Map if it does not exist in the browser.
• Added build scripts

4.4.14

• Fixes issue with renderToString not rendering text nodes

4.4.13

• Fixes #721 - Add a Code of Conduct
• Fixes #655 - Implement renderToString in the browser.

4.4.12

• Fixes #695 - Always ignore unrecognized tags for XML files when using the compiler.
• Fixes #705 - Throw error when the root HTML element is a component and has a dynamic id attribute.
• [testing] Additional test for root node with dynamic id of a component with a component.js file.

4.4.11

• Fixes #728 - Do not use module keyword because webpack compiles it to a custom object.
• Fixes #719 - Support Express 4 and Express 5.
• fixes #658 by removing empty style blocks #715
• fixes #688 - add reference to browser.json in meta dependencies
• [docs] Fix broken link
• [docs] Fix Marko syntax in docs causing compilation errors on the website.
• [docs] Change pixels to percent in doc images.
• [testing] Purge express cache so that express tests both use correct module versions.

4.4.9

• Revert "Fixes #705 - Throw error when the root HTML element has a dynamic id …"
• [testing] Only run Node 4, 6, & 8 in travis

4.4.8

• [docs] Clean up why-is-marko-fast.md
• [docs] Clean up marko-vs-react.md

4.4.7

• Add silent option to browser-refresh and hot-reload
• Check id attribute for Literal. Update error message to include error page.
• Fixes #705 - Throw error when the root HTML element has a dynamic id attribute.
• [docs] Clean up components.md
• [docs] Fix typo in webpack.md
• [testing] give extra time for test timing out in travis
• [testing] run tests on node 8
• [testing] ignore test-dist from coverage

4.4.6

• Fixes #693 - [SSR] Improved handling of top-level UI components with renderBody func
• Switching to using prepublish with npm@5

4.4.3

• Use parent module to require express patch #701
• [docs] Reference app should point to "marko-lasso" because "ui-components-playground" does not contain lasso
• [docs] Add articles section to docs.

4.4.2

• Build fixes related to compiler

4.4.0

• Improve no-update-if condition check
• Compatibility improvements for Try Online
• Code size reduction
• Introduced src/ and dist/ folders for optimized production builds
• Fixes #695 - Default to ignoring unrecognized tags for XML files.

4.3.x

4.3.1

• Add basic test for ensuring that res.marko returns a promise.
• enable res.marko can catch a error safe

4.3.0

• [compiler] Added more control over how attributes are targeted to props
• Don't add root markers to tags that don't produce output
• [docs] Added docs for Marko + Huncwot integration
• [AST] Added node.removeChildren()
• Extend marko globals with defaults

4.3.0-beta.4

• Fixes #673 - Circular dependency is causing problems with Webpack

4.3.0-beta.3

• Changes related to #670 - Globals must be serialized earlier to allow early mount of UI components in
• [docs] Improved docs for SSR

4.3.0-beta.2

• Fixes for #670 - Add support for serialized globals and retain globals on re-render

4.2.x

4.2.8

• Bug: Fixes #661 - Component initialization code may end up in the wrong place
• Bug: Fixes #668 - Declarative event listeners are now allowed on the <include> tag

4.2.7

• Bug: Fixes #650 - The tag "await" does not support attribute "unless"
• Improvements to legacy state

4.2.6

• Bug: Fixes #654 - Bug: components implementing a key attribute break in Marko v4
• Improvements to legacy compatibility layer

4.2.5

• Improved support for UI components implemented using native JavaScript class in a separate file
• Improved how legacy layout tags are handled by Marko v4

4.2.4

• Bug: Fixes #653 - Event handlers are no longer bound in edge case

4.2.3

• Bug: Fixes #649 - New line always added to textarea and other elements for single line/delimited HTML blocks

4.2.2

• Bug: Fixes #648 - Style attribute object and lengths not handled properly

4.2.1

• Bug: Fixed #644 - Attribute not rendered by Marko is not preserved if component first rendered on the server
• [Performance] Escaping is not needed for the data-marko attribute

4.2.0

• Bug: Fixed #629 - VDOM: Rendering unescaped HTML produces non-functioning HTML input controls
• Bug: Fixed #634 - writeInitComponentsCode is not a function
• Enhancement: Added support to allow improved precompiling of templates
• Enhancement: Fixed #636 - Add error when macro with duplicate name is found
• Performance: Optimized diffing/patching to avoid indexing entire tree to find keyed elements
• Performance: Optimized how event handlers are attached to VDOM nodes (separated from attributes)

4.1.x

4.1.3

• Bug: Fixed losing cursor position in Edge (see morphdom PR #100 by @zastavnitskiy)
• Bug: Ignore xmlns attributes when virtualizing real DOM nodes (needed when inserting an HTML string when rendering to a VDOM)

4.1.2

• Bug: Fixed #623 - Uncaught TypeError: toEl.$__hasAttribute is not a function
• Bug: Fixed #619 - Deprecated constructor() for UI component classes

4.1.1

• Added "use strict"; to restore Node.js compatibility for Node.js v4 and v5

4.1.0

• Bug: Fixes #611 - Component IDs are not being assigned correctly when intermediate non-component is rendered
• Performance: SVG namespaced elements are now resolved determined at compile-time
• Performance: Merged in morphdom and optimized for Marko
• Performance: Optimized diffing/patching of elements with only simple attributes in the following set: class, id and style

4.0.x

4.0.1

• Bug: Fixes #612 - Compile error when class method has empty return
• Bug: Fixes #604 - no-update attributes error when first rendered on the server
• Bug: Fixes #608 - Component losing renderBody input on a particular redraw
• Enhancement: Fixes #606 - named single-file component doesn't work

4.0.0

• Marko v4! Release Announcement

3.x

3.13.x

3.13.2

• Fixed [#478](TagLookup fails when merging taglibs) - TagLookup fails when merging taglibs

3.13.1

• Fixes #465

3.13.0

3.12.x

3.12.0

• Added warnings for using render methods when you want string output (Pull Request #450 by @mlrawlings)

3.11.x

3.11.8

• Fixes #382 - Local variable for tag should have prefix or suffix to avoid conflict

3.11.7

• Fixes #381 - $global broken when using template.stream()

3.11.6

• Internal change: AsyncWriter → AsyncStream

3.11.5

• (no changes)

3.11.4

• Update to async-writer@2

3.11.3

• Silently ignore errors when parsing tag definition code inlined in JavaScript

3.11.2

• Fixed #318 - Use compiler options passed to require hook to configure marko globally

require("marko/node-require").install({
  compilerOptions: {
    writeToDisk: false
  }
});

3.11.1

• Fixed #370 - HTML characters in loop separator string should not be escaped

3.11.0

• Introduced the <include-html(path)> tag for including static HTML:

<include-html('./foo.html')>

3.10.x

3.10.1

• Fixed #44 - Webpack compatibility fixes. Also see marko-loader (A marko loader for webpack)

3.10.0

• Fixed #357 - Deprecate empty/notEmpty in Marko v3

3.9.x

3.9.4

• Fixed #355 - status-var/separator options not handled when looping over properties
• Fixed #354 - regular expressions used in attribute values are not being handled correctly
• Fixed #353 - body-only-if attribute does not work with custom tags (only HTML tags)

3.9.3

• Upgraded to raptor-util@^2

3.9.2

• Fixed #327 - alt attribute with empty string should be allowed (Pull Request #350 by @mlrawlings)

3.9.1

• Fixed #348 - exclude all *.orig and other files from published npm package

3.9.0

• Fixed #231 - Allow <assign count++>
• Fixed #345 - Whitespace preservation now applies to all deeply nested text nodes
• Fixed #344 - Introduced defineRenderer for Marko
• Docs: Added docs for excluding directories from taglib discovery (@mlrawlings)
• Docs: Added docs for component autodiscovery (@mlrawlings)
• Docs: Added docs for passing a data object to a custom tag

3.8.x

3.8.1

• Fixed #342 - await:finish event not emitted for async fragments with client reorder and that complete synchronously

3.8.0

• Fixed #329 - Add autodiscover of components/ directory (Pull Request #338 by @mlrawlings)

3.7.x

3.7.4

• Fixed #339 - Tag transformers are not being applied to tags with a dynamic tag name (fixes #146 for Marko Components)

3.7.3

• Fixed #332 and #333 - Correct values for literalUndefined and literalFalse in the Builder API @bkuri
• Fixed #336 - Upgraded to latest version of minimatch

3.7.2

• Fixed #328 - Improve error reporting when taglib/tag definition fails to load
• Additional change to disable escaping for dynamic Text nodes added to body of <script> tag to fix issue #326

3.7.1

• Improved escaping within the <script> tag to fix issue #322. Special HTML characters will no longer be escaped within the context of the <script> tag since browsers do not decode HTML entities within the <script> tag. Instead, only the ending </script> tag sequence is escaped using JavaScript string escaping sequences.

3.7.0

• Made change to make configuration a true singleton shared across all instances of marko loaded at runtime (commit)

3.6.x

3.6.2

• Improved support for hot reloading by automatically disabling assumeUpToDate if hot reload is enabled. (Pull Request #320 by @ianvonholt)

3.6.1

• Fixed a bug that was causing transforms to be run on detached nodes. This was manifesting itself in the <async-fragment> to <await> transform if an if() attribute was present (or other core attributes that end up wrapping the tag it is defined on).

3.6.0

• Introduced a new and simpler <await> tag that should be used instead of the now deprecated <async-fragment> tag (see deprecation details below) (Pull Request #312 by @mlrawlings)

Deprecations

• Deprecated the <async-fragment var="<var>" data-provider=<data-provider>> tag in favor of the <await(<var> from <data-provider>)> tag:

OLD:

<async-fragment var="userInfo" data-provider=data.userInfoPromise>
    Hello ${userInfo.name}!
</async-fragment>

NEW:

<await(userInfo from data.userInfoPromise)>
    Hello ${userInfo.name}!
</await>

The <await> tag supports all of the attributes of the previous <async-fragment> tag except for var and data-provider:

<await(userInfo from data.userInfoPromise) name="userInfo" timeout=10000 client-reorder>
    Hello ${userInfo.name}!
</await>

Finally, the nested tags for providing content for the placeholder, error and timeout messages have been renamed accordingly:

<await(userInfo from data.userInfoPromise) client-reorder>
    <await-placeholder>
        This is alternate content while the async fragment is loading.
    </await-placeholder>
    <await-timeout>
        A timeout has occurred!
    </await-timeout>
    <await-error>
        A error has occurred!
    </await-error>

    Hello ${userInfo.name}!
</await>

3.5.x

3.5.1

• Fixes #316 - Autocomplete for tags is not updated when tag files updated despite clearing cache. This improves the autocomplete-marko plugin for Atom.
• Fixes #314 - Remove hyphens from include props
• Deprecated:
  • Properties passed in using the <include> tag should not be access using hyphens.

For example, given the following template:

<include("./include-target.marko") first-name='Jane'/>

The first-name data should be accessed using the firstName property:

var firstName = input.firstName;
// NOT: var firstName = input['first-name'];

3.5.0

• Added functionality to exclude specific directory or package from taglib finder (Pull Request #309 by @oxala)

3.4.x

3.4.9

• Fixed [marko-js#307] - Marko concise syntax, with multiple class names (Pull Request #308 by @mlrawlings)

3.4.8

• Added support for an "enum" attribute value

3.4.7

• Async fragment improvements (Pull Request #305 by @mlrawlings)
  • Adds additional event info (finished/timedout) to the data emitted from tags.
  • Ensures that renderBody() is not called again if the fragment has already finished (timed out).
  • Fixes npm run test-async
  • Removes a redundant async-fragment timeout related test

3.4.6

• Updated autocomplete information

3.4.5

• Fixes #304 - async-fragment-tag-transformer.js being loaded by PhantomJS
• Updated taglibs with additional information to support tooling
• Added Michael Rawlings as a maintainer

3.4.4

• Fixes #303 - addStaticVar is not generating unique variable names correctly

3.4.3

• Improved validation for macros (@mlrawlings, PR #300)
• Added code coverage reporting (@mlrawlings, PR #301)

3.4.2

• Improved error reporting in cases when code generation fails (@mlrawlings)

3.4.1

• Additional tweaks for #298 - Always emit correct events for async fragments

3.4.0

• Fixes #298 - Always emit correct events for async fragments
• Updated docs

3.3.x

3.3.0

• Include async fragment name in the asyncFragmentFinish events (@kprakasam)

3.2.x

3.2.0

• Fixes #286 - Add res.marko(templateData) for use with Express (@mlrawlings)

3.1.x

3.1.9

• Fixes #288 - Provide API for discovering custom tags and attributes for autocomplete/tooling purposes
• Documentation improvements

3.1.8

• Fixes #280 - Switch from jsonminify to strip-json-comments
• Updated docs for Koa and Hapi
• Additional tests for Node.js v6

3.1.7

• Fixes #274 - marko-compiler-options tag is not properly ended when using raw parsing (for prettyprint)

3.1.6

• Fixes #268 - this.write is not a function for empty ArrayExpression

3.1.5

• Fixes #262 - node-require module removes .marko extension from filenames in compiled code

3.1.4

• Fixes #267 - Shorthand CSS class name cannot be combined with object/array class names

3.1.3

• Fixed #266 - Hot reloading fails if original template is deleted

3.1.2

• Fixed error reporting when using compiler.parseRaw()
• Added test for #262

3.1.1

• Improved whitespace removal for text nodes directly below the root

3.1.0

• Fixes #254 - Allow preserve whitespace to be enabled at the global level

3.0.x

3.0.7

• Fixes #240 - Always trim start and end of template (even if preserveWhitespace is true)
• Fixes #260 - Circular custom tags causes infinite recursion when writeToDisk is set to false
• Minor internal cleanup

3.0.6

• Don't wrap exception in parseJavaScript if error object was not created by Esprima

3.0.5

• Fixes #257 - Placeholders don't render for out-of-order async fragments

3.0.4

• Fixes #256 - Convert attributes to title case if no attributes are declared for a custom tag
• Use <noscript> for out-of-order async fragment placeholders

3.0.3

• Make renderSync behave if no context was supplied (PR #250 by @jsumners)

3.0.2

• Store tagDef with HtmlElement node (needed for pretty printing)

3.0.1

• Docs: Fixed minor issues in docs
• Reintroduced support for the MARKO_CLEAN environment variable: MARK_CLEAN=true node server.js

3.0.0

• See: What's New in Marko v3

2.x

2.8.x

2.8.4

• Fixes circular dependency issue between runtime/index.js and hot-reload/index.js

2.8.3

• Fixes circular dependency issue between runtime/index.js and hot-reload/index.js

2.8.2

• Fixes #203 - Incorrect behavior when attrs is used on a standard HTML tag with a tag def

2.8.1

• Fixes #202 - Pass along options to compiler when loading a template

2.8.0

• Added support for automatically discovering taglibs from installed packages that are scoped. (PR #183 by @tropperstyle)

2.8.3

• Fixes circular dependency issue between hot-reload/index.js and runtime/index.js

2.7.x

2.7.31

• Fixes #167 - Nested tags only work one level deep

2.7.30

• docs: don't exclude docs in .npmignore

2.7.29

• Fixes #161 - Nested tags with no body content are not handled correctly

2.7.28

• Fixes #140 - Also de-dupe cached taglibs in finder

2.7.27

• Make loading template from String template source easier:

var template = marko.load(templatePath, "Hello $!{data.name}!");

NOTE: Loading directly from source only works on the server

See Pull Request #153

2.7.26

• Use shorter relative paths in error messages

2.7.25

• Fixes #150 - Provide option to prevent writing compiled templates to disk. Example usage:

require("marko/compiler").defaultOptions.writeToDisk = false;

NOTE: If you disable writing compiled templates to disk then it will be a little harder to debug errors in templates on the server since the stack trace will refer to a file that has not been written to disk.

For a more complete list of compiler options please see: http://markojs.com/docs/marko/javascript-api/#defaultoptions

2.7.24

• Fixes #140 - De-dupe taglibs by module name
• Documentation: Miscellaneous changes

2.7.23

• Fixed a typo for rendererFunc in helpers.js (commit: 0205a47f04911f34ca4d458970d710f81a143987)

2.7.22

• New language feature: unless support added

2.7.21

• Automatically enable hot-reload and browser-refresh if launched using browser-refresh

2.7.20

• Documentation: Miscellaneous changes

2.7.19

• Fixes #137 - adds support for dynamic HTML tag names

2.7.18

• Improvement: Better resolving of tag renderer
• Compiler: Fix to make compiler work in the browser

2.7.17

• Fixes #135 Allow "attrs" attribute on custom tags

2.7.16

• Improved handling of imports
• Better handling of loading taglibs with circular dependencies

2.7.15

• Handle circular taglib imports

2.7.14

• Fixes #131 - Recursively handle taglib imports

2.7.13

• Added a .npmignore file
• Fixed licensing header in source
• Documentation: improved docs for input.renderBody()
• Documentation: Miscellaneous changes

2.7.12

• Fixes #122 Don't allow invalid attributes when using shorthand
• Fixes #122 Typo in hasAttributes
• Fixes #127 - Make sure all possible input files are accounted for when checking if a compiled template is up-to-date
• Use browser.json files instead of optimizer.json files
• Documentation: Improved docs for async taglib
• Documentation: Added empty() and notEmpty() helpers to the readme
• Added Martin Aberer as a maintainer
• Documentation: Miscellaneous changes

2.7.11

• New logo!

2.7.10

• Fixes #118 Better error when parsing JSON file for tag
• Testing: More test cases related to empty attributes
• Documentation: Clarification for the Node.js require extension
• Documentation: doc reference for getLength() of loop status-var
• Documentation: Added reference to sublime-marko under the tools section.

2.7.9

• Fixes #109 - Allow compiler.createNode('div')
• Fixes #108 - Improve how the MARKO_CLEAN env variable is handled

2.7.8

• Minor documentation changes

2.7.7

• Allow .html extension for layouts (Fix for marko-js-archive/marko-layout#2)

2.7.6

• Make require('marko/node-require').install() a noop in the browser

2.7.5

• Improvement: Allow template-data to be combined with other attributes on the <include> tag
• Documentation: Fixes #98 - docs for <include template-data="...">

2.7.4

• Fixes #96 - Allow relative, dynamic include paths

2.7.3

• Internal change: Additional test cases added for using promises with async fragments

2.7.2

• Fixes #73 - Prevent same taglib from being loaded multiple times

2.7.1

• Fixes #88 - Assign global data to the correct out

2.7.0

• Fixes #27 - IE conditional comments (e.g., <!--[if lt IE 9]><div><![endif]-->) are automatically preserved. Previously, all HTML comments were stripped out when loading a template. For example:
• Added support for <compiler-options comments="preserve"/> to enable comments to preserved in a template. For example:

<compiler-options comments="preserve"/>
Hello
<!--This comment should be preserved-->
World

Output:

Hello
<!--This comment should be preserved-->
World

2.6.x

2.6.0

• Performance improvements
  • 'use strict';
  • Optimized render code paths
• Code cleanup
• Compatibility fixes for Node.js 0.12
  • Bad: fs.readFile(path, 'utf8')
  • Good: fs.readFile(path, {encoding: 'utf8'})

2.5.x

2.5.0

• Fixes #78 - Custom Node.js require extension for Marko template files. Example usage:

// Install the Node.js require extension in your application's main script (server-side only)
require("marko/node-require").install();

// Now you can require `*.marko` files just like any other JavaScript module
var template = require("./hello.marko");
var html = template.renderSync({ name: "Frank" });

• Compiled templates now export a loaded Template instance. In the previous version of marko, compiled templates exported a function that could be used to create a loaded Template instance.

2.4.x

2.4.3

• Fixes edge case: More precise regular expression for decoding HTML entities

2.4.2

• Internal: Fixes #75 Always assign the tag property to custom tag nodes

2.4.1

• Improvement to allow taglibs to be imported from other taglibs (commit)

2.4.0

• Added support for short-hand tags and attributes

Old marko-taglib.json:

{
  "tags": {
    "my-hello": {
      "renderer": "./hello-renderer",
      "attributes": {
        "name": "string"
      }
    }
  }
}

Short-hand marko-taglib.json:

{
  "<my-hello>": {
    "renderer": "./hello-renderer",
    "@name": "string"
  }
}

• Fixes #61 Simplify parent/child relationships

Marko now supports custom tags in the following format: <parent_tag.nested_tag>

Example usage:

<ui-tabs orientation="horizontal">
    <ui-tabs.tab title="Home">
        Content for Home
    </ui-tabs.tab>
    <ui-tabs.tab title="Profile">
        Content for Profile
    </ui-tabs.tab>
    <ui-tabs.tab title="Messages">
        Content for Messages
    </ui-tabs.tab>
</ui-tabs>

ui-tabs/marko-tag.json

{
  "@orientation": "string",
  "@tabs <tab>[]": {
    "@title": "string"
  }
}

ui-tabs/renderer.js

var template = require("marko").load(require.resolve("./template.marko"));

exports.renderer = function(input, out) {
  var tabs = input.tabs;

  // Tabs will be in the following form:
  // [
  //     {
  //         title: 'Home',
  //         renderBody: function(out) { ... }
  //     },
  //     {
  //         title: 'Profile',
  //         renderBody: function(out) { ... }
  //     },
  //     {
  //         title: 'Messages',
  //         renderBody: function(out) { ... }
  //     }
  // ]
  console.log(tabs.length); // Output: 3

  template.render(
    {
      tabs: tabs
    },
    out
  );
};

ui-tabs/template.marko

<div class="tabs">
    <ul class="nav nav-tabs">
        <li class="tab" for="tab in data.tabs">
            <a href="#${tab.title}">
                ${tab.title}
            </a>
        </li>
    </ul>
    <div class="tab-content">
        <div class="tab-pane" for="tab in data.tabs">
            <invoke function="tab.renderBody(out)"/>
        </div>
    </div>
</div>

2.3.x

2.3.2

Fixes #66 - Allow circular dependencies when loading templates

2.3.1

• Testing framework changes
• Fixes #65 - Generated variable name is an empty string in some cases

2.3.0

• Fixes #53 Merge c-input with attr props

2.2.x

2.2.2

Fixes #60 Don't replace special operators for body functions

2.2.1

• Fixes #58 Added support for MARKO_CLEAN env variable (force recompile of all loaded templates). Example usage:

MARKO_CLEAN=true node run.js

• Code formatting: add spaces in var code

2.2.0

• Fixes #51 Allow body content to be mapped to a String input property
• Fixes #52 Remove JavaScript comments from JSON taglib files before parsing

2.1.x

2.1.6

• Fixes #50 Initialize the loader after the runtime is fully initialized

2.1.5

• Fixes #50 Ensure that all instances of marko have hot-reload and browser-refresh enabled

2.1.4

• Allowing complex var names (i.e. LHS) for the <assign> tag.

2.1.3

• Minor change: Slight improvement to code to resolve tag handler

2.1.2

• Minor change: Improve how renderer is resolved

2.1.1

• Fixes #48 name in marko-tag.json should override default name given during discovery

2.1.0

• Fixes #47 - Added support for "taglib-imports"

2.0.x

2.0.12

• Fixes #31 - Add support for providing prefix when scanning for tags
• Allow "code" to be a function that lazily evaluates to a code string during code generation

2.0.11

• Added method for custom node compilers to get access to the escapeXml function at runtime

2.0.10

• Fixes #39 - Added missing return when using hot-reload

2.0.9

• Fixed bad publish

2.0.8

• Better merging of tags when loading and merging taglibs

2.0.7

• Changes to avoid problems associated with the same taglib being found multiple times in the search path

2.0.6

• renderBody function is only added if tag has children

2.0.5

• Fixed #36 - Don't use invokeBody() in the cache taglib

2.0.4

• ❗ Fixed #36 - Deprecated - When using <include> with body content, nested body content is now passed in as String property named body. Old behavior: nested content would be passed in as a Function property named invokeBody that would return the String value of the nested content. invokeBody() has been deprecated.

2.0.3

• Fixed #36 - Don't use invokeBody() in test code and the HTML comments tag

2.0.2

• ❗ Fixed #36 - Deprecated input.invokeBody() in favor of input.renderBody(out)
• Fixed #37 - Duplicate input property for custom tag renderers

2.0.1

• Fixed #35 - Added support for <compiler-options>. Example:

<compiler-options whitespace="preserve" />
A
B
C

2.0.0

• Dynamic attributes for scanned tags without a tag will have dashes removed by default.
  • ❗ When using tags-dir to discover tags that do not have a marko-tag.json, the previous behavior was to allow all attributes and to use the actual attribute name as the input property name. For example, when using <hello first-name="John">, first name would need to be read in as input['first-name']. This was changed such that the first name property should now be read in as input.firstName (dashes removed and converted to camel case)
• Changes to allow UI component to be put into a single JS file:
  • Updated taglib directory scanner to use index.js if found. New search order:
    1. renderer.js (use renderer.js if it exists)
    2. index.js (use index.js if it exists and assume it exports a renderer or render property)
    3. template.marko (use the template as the renderer if no renderer.js or index.js)
  • ❗ Changes to the taglib directory scanner could break existing code. Specifically, if a UI component directory had an index.js file and a template.marko file then in in marko@<2 the template.marko file would have been selected as the renderer. In marko@2.x, the index.js will be selected as the tag renderer.
• ❗ Removed support for mapping a tag renderer to a module with a process method
• Removed sub-module marko/renderer that exports raptor-renderer

1.x

1.6.x

1.6.1

• Added back code to allow the new marko runtime to load templates compiled by an earlier compiler that used module.exports

1.6.0

• Fixed #32. Switched from module.exports = function create(__helpers) { ... } to exports.create = function(__helpers) { ... } to avoid circular dependency problems

1.5.x

1.5.8

• Added support for adding "static" code to the top of a compiled template (helpful for initializing variables or running code once).

1.5.7

• Added sub-module marko/renderer that exports raptor-renderer

1.5.6

• Changes to avoid unoptimized code in V8

1.5.5

• Handle case where template was loaded before hot-reload was enabled

1.5.4

• Added support for $global in renderSync