CHANGELOG.md

For TODO between alpha and release, see knockout#1

🎩 Beta-1 (ongoing)

• (observable) When supported, observable.length will now be undefined (was 0 before), and observableArray.length will now be the length of the wrapped array
• (observableArraty) observableArray is now iterable (has a Symbol.iterator property)
• (utils) Several array utilities use native functions now (arrayPushAll, arrayFilter, arrayGetDistinctValues, arrayFirst, arrayIndexOf)
• (various) forward-ports per #5
• (components) Warn with custom-element names that cannot be used with custom elements re. #43 & knockout/knockout#1603
• (event binding) Add object-based event handler e.g. event.click: { handler: fn, once: true, capture: true, bubble: false, passive: false}. Also, bubbling can be prevented with event.click: {bubble: false } re #32
• (event binding) Add throttle and debounce parameters
• The throttle and debounce utilities now pass arguments to the target functions
• (components) Allow Component-specific binding handlers from component.prototype.getBindingHandler
• (components) Issue a warning if ignoreCustomElementWarning is not passed to a component registration and the component name is not usable for custom elements.
• (observable) Removed then from observable.fn because it'll likely cause a lot of confusing issues with implicit unwrapping from async functions.
• (observable) Add ko.proxy and related functions ko.proxy.peek(obj, prop), ko.proxy.isProxied(obj), ko.proxy.getObservable(obj, prop).

🚚 Alpha-4a (8 Nov 2017)

• (build) Change the tko export to global.ko for backwards compatibility (instead of global.tko).

🚜 Alpha-4 (8 Nov 2017)

• (components) Add ko.Component, an abstract base class that simplifies the Component creation and registration API (see tko.utils.component/src/ComponentABC.js)
• (with binding) Fix dependency count for function-arguments [knockout/knockout#2285]
• (options) Allow importing ko in node
• (components) Add getBindingHandler(key) to use binding handlers local to a component
• (docs) Add /tko.io with structure for building and deploying documentation website
• (npm) Publishing all packages as 4.0.0-alpha4

🏰 Alpha-3 (30 June 2017)

• (build) Compiles to dist/ko.js (via Babel)
• (build) The dist/tko.js (that exported tko) has been deprecated/removed
• (internal) Add the ES6 LifeCycle class (see tko.lifecycle)
• (binding handlers) Add new-style ES6 Binding Handler class (see custom-bindings documentation and tko.bind/src/BindingHandler.js), descended from the LifeCycle class
• (lifecycle) Fix error with event handler type
• (provider) Add & document the Provider base class
• (subscribable) Add the once, then, when, yet, and next functions
• (parser) Fix early-out for logical (&& / ||) operators
• (binding) ko.applyBindings now returns a Promise that resolves when bindings are completed
• (attr) Support namespaced attributes with attr binding #27
• (options) Add the options.Promise, so users can use a their own or a safe Promise variant of A+/Promises (defaults to window.Promise)
• (attribute-interpolation) Fix interpolation of styles attribute (e.g. style="color: {{color}}") in the AttributeMustacheProvider, by adding attributesBindingMap parameter.

🐋 Alpha-2 (3 May 2017)

• (API) Expose dependencyDetection.ignore as ignoreDependencies
• (foreach binding) When using the as parameter, the $data remains unchanged (i.e. the context inside a foreach is no longer a "child" context, but an extension of the current context); this deprecates the noContext parameter
• (foreach binding) Expose the conditional on the domData for use by the else binding (when the array is empty, the else binding will be rendered)
• (foreach binding) Expose $list inside the foreach
• (foreach binding) Allow noIndex as a peer binding parameter (e.g. foreach: items, noIndex: true)
• (bind) String errors on binding are now propagated
• (provider) Fix dereferencing of namespaced items e.g. attr.title: ${v}
• (parser) Fix unary negation
• (foreach) Preserve focus when items are deleted and re-added (i.e. moved) in the same animation frame.
• (observable array) Incorporate 3.4 fix for memory leak
• (parser) Fix array values not being unwrapped/called e.g. data-bind="x: [f(), observable, 1 + 6, a ${x} c]"
• (parser) Fix interpretation of unicode characters as identifiers / variables

🏹 Alpha-1 (20 Dec 2016)

• Fix negation operator (-) application - integers/floats e.g. -1 work, as well as variables -x and expressions -(x + y)

• Use tko.binding.foreach for the foreach binding (based on brianmhunt/knockout-fast-foreach)

• Add each as an alias of foreach

• Parser

  • Correct behaviour with dereferencing members of expressions (e.g. (x || y).z or (abc || {x: null})['x'])
  • Fix canonical (() => ...) lambdas
  • Support C & C++ style comments (knockout/knockout#1524)
  • Fix filter/or ambiguity on pipe |
  • Raise an error with anonymous functions
  • Fix && and || operator precedence

• Updated Rollup - changes order of compilation, smaller output

• Fix issue with first rendering of an elseif binding

• Make the template binding expose a conditional for else-binding

• Expose ko.dependencyDetection

• Make sure obj.x uses this of obj where x is a function (e.g. click: model.onClick has this of model)

• Ensure obj.x only uses obj as this when x is a prototypal method (and not just a value)

• Honour explicit references to this (as $data)

• Ensure bindings with multiple filters work as expected

• If available, use a WeakMap for DOM node data (resolves knockout/knockout#2141)

• Fix filters not separated by whitespace (e.g. value|filter1|filter2)

🐚 Alpha-0 (9 Nov 2016)

The following are short-hands for the changes from Knockout 3.4(.1).

• various new options

• rewritten as ES6 in multiple packages, so it can be mixed/matched

  • e.g. observables are usable independently from knockout/tko.observable

• rewritten data-bind parser

  • add "naked" => lambdas (even in legacy browsers e.g. data-bind='click: => was_clicked(true)'
  • inline functions are no longer supported (e.g. data-bind='click: function (){...}' will fail)
  • Can be used with Content-Security-Policy unsafe-eval
  • No longer uses with statements
  • No longer uses eval/new Function
  • support template literals (``) in bindings (even in legacy browsers)
  • == and === use === for comparison (same for != and !==); fuzzy equality ~== / ~!= for the evil twins
  • add the @ prefix operator that calls/unwrap functions (i.e. obs()() is the same as @obs)

• incorporate punches {{ }} and {{{}}} text and attribute interpolation

• utils

  • utils.domNodeDisposal is now exposed as domNodeDisposal
  • arguments to setHtml that are functions are called (not just observables)
  • cleanExternalData now exposed in domNodeDisposal.otherNodeCleanerFunctions

• error handling

  • onError no longer throws if overloaded; default function is to re-throw.
  • error is thrown when an extender is not found

• bindings

  • add <!-- else --> inside the if binding, and add an else binding (following the brianmhunt/knockout-else plugin)
  • add hidden binding (knockout/knockut#2103)
  • using binding in tko.binding.core
  • html binding in virtual elements (from punches)
  • punches-like value|filter filtering
  • incorporate punches namespacing i.e. data-bind='event.click: => thing(true)' is equivalent to data-bind='event: {click: => thing(true)}'

• bindng handler updates

  • the valueAccessor passed to a binding handler is now callable, the first argument being a 'setter' of the object property or observable (this replaces twoWayBinding)
  • allowVirtualElements can now be set with a property on a bindingHandler

• Updated preprocessor API

• Deprecated

  • Template binding options are deprecated
  • expressionWriting (twoWayBinding)
  • ‘.’ in binding handler names
  • jsonExpressionRewriting (expressionRewriting)
  • form parsing
  • bind shim
  • ko.utils.parseJson
  • getFormFields
  • fieldsIncludedWithJsonPost
  • postJson