[platform/framework/web/crosswalk-tizen.git] /

v0.10.6  --  2015.02.02
* Fix handling of infinite values in Math.trunc
* Fix handling of getters in Object.normalizeOptions

v0.10.5  --  2015.01.20
* Add Function#toStringTokens
* Add Object.serialize and Object.unserialize
* Add String.randomUniq
* Fix Strin#camelToHyphen issue with tokens that end with digit
* Optimise Number.isInteger logic
* Improve documentation
* Configure lint scripts
* Fix spelling of LICENSE

v0.10.4  --  2014.04.30
* Assure maximum spec compliance of Array.of and Array.from (thanks @mathiasbynens)
* Improve documentations

v0.10.3  --  2014.04.29
Provide accurate iterators handling:
* Array.from improvements:
  * Assure right unicode symbols resolution when processing strings in Array.from
  * Rely on ES6 symbol shim and use native @@iterator Symbol if provided by environment
* Add methods:
  * Array.prototype.entries
  * Array.prototype.keys
  * Array.prototype.values
  * Array.prototype[@@iterator]
  * String.prototype[@@iterator]

Improve documentation

v0.10.2  --  2014.04.24
- Simplify and deprecate `isCallable`. It seems in ES5 based engines there are
  no callable objects which are `typeof obj !== 'function'`
- Update Array.from map callback signature (up to latest resolution of TC39)
- Improve documentation

v0.10.1  --  2014.04.14
Bump version for npm
(Workaround for accidental premature publish & unpublish of v0.10.0 a while ago)

v0.10.0  --  2014.04.13
Major update:
- All methods and function specified for ECMAScript 6 are now introduced as
  shims accompanied with functions through which (optionally) they can be
  implementend on native objects
- Filename convention was changed to shorter and strictly lower case names. e.g.
  `lib/String/prototype/starts-with` became `string/#/starts-with`
- Generated functions are guaranteed to have expected length
- Objects with null prototype (created via `Object.create(null)`) are widely
  supported (older version have crashed due to implied `obj.hasOwnProperty` and
  related invocations)
- Support array subclasses
- When handling lists do not limit its length to Uint32 range
- Use newly introduced `Object.eq` for strict equality in place of `Object.is`
- Iteration of Object have been improved so properties that were hidden or
  removed after iteration started are not iterated.

Additions:
- `Array.isPlainArray`
- `Array.validArray`
- `Array.prototype.concat` (as updated with ES6)
- `Array.prototype.copyWithin` (as introduced with ES6)
- `Array.prototype.fill` (as introduced with ES6)
- `Array.prototype.filter` (as updated with ES6)
- `Array.prototype.findIndex` (as introduced with ES6)
- `Array.prototype.map` (as updated with ES6)
- `Array.prototype.separate`
- `Array.prototype.slice` (as updated with ES6)
- `Array.prototype.splice` (as updated with ES6)
- `Function.prototype.copy`
- `Math.acosh` (as introduced with ES6)
- `Math.atanh` (as introduced with ES6)
- `Math.cbrt` (as introduced with ES6)
- `Math.clz32` (as introduced with ES6)
- `Math.cosh` (as introduced with ES6)
- `Math.expm1` (as introduced with ES6)
- `Math.fround` (as introduced with ES6)
- `Math.hypot` (as introduced with ES6)
- `Math.imul` (as introduced with ES6)
- `Math.log2` (as introduced with ES6)
- `Math.log10` (as introduced with ES6)
- `Math.log1p` (as introduced with ES6)
- `Math.sinh` (as introduced with ES6)
- `Math.tanh` (as introduced with ES6)
- `Math.trunc` (as introduced with ES6)
- `Number.EPSILON` (as introduced with ES6)
- `Number.MIN_SAFE_INTEGER` (as introduced with ES6)
- `Number.MAX_SAFE_INTEGER` (as introduced with ES6)
- `Number.isFinite` (as introduced with ES6)
- `Number.isInteger` (as introduced with ES6)
- `Number.isSafeInteger` (as introduced with ES6)
- `Object.create` (with fix for V8 issue which disallows prototype turn of
  objects derived from null
- `Object.eq` - Less restrictive version of `Object.is` based on SameValueZero
  algorithm
- `Object.firstKey`
- `Object.keys` (as updated with ES6)
- `Object.mixinPrototypes`
- `Object.primitiveSet`
- `Object.setPrototypeOf` (as introduced with ES6)
- `Object.validObject`
- `RegExp.escape`
- `RegExp.prototype.match` (as introduced with ES6)
- `RegExp.prototype.replace` (as introduced with ES6)
- `RegExp.prototype.search` (as introduced with ES6)
- `RegExp.prototype.split` (as introduced with ES6)
- `RegExp.prototype.sticky` (as introduced with ES6)
- `RegExp.prototype.unicode` (as introduced with ES6)
- `String.fromCodePoint` (as introduced with ES6)
- `String.raw` (as introduced with ES6)
- `String.prototype.at`
- `String.prototype.codePointAt` (as introduced with ES6)
- `String.prototype.normalize` (as introduced with ES6)
- `String.prototype.plainReplaceAll`

Removals:
- `reserved` set
- `Array.prototype.commonLeft`
- `Function.insert`
- `Function.remove`
- `Function.prototype.silent`
- `Function.prototype.wrap`
- `Object.descriptor` Move to external `d` project.
  See: https://github.com/medikoo/d
- `Object.diff`
- `Object.extendDeep`
- `Object.reduce`
- `Object.values`
- `String.prototype.trimCommonLeft`

Renames:
- `Function.i` into `Function.identity`
- `Function.k` into `Function.constant`
- `Number.toInt` into `Number.toInteger`
- `Number.toUint` into `Number.toPosInteger`
- `Object.extend` into `Object.assign` (as introduced in ES 6)
- `Object.extendProperties` into `Object.mixin`, with improved internal
  handling, so it matches temporarily specified `Object.mixin` for ECMAScript 6
- `Object.isList` into `Object.isArrayLike`
- `Object.mapToArray` into `Object.toArray` (with fixed function length)
- `Object.toPlainObject` into `Object.normalizeOptions` (as this is the real
  use case where we use this function)
- `Function.prototype.chain` into `Function.prototype.compose`
- `Function.prototype.match` into `Function.prototype.spread`
- `String.prototype.format` into `String.formatMethod`

Improvements & Fixes:
- Remove workaround for primitive values handling in object iterators
- `Array.from`: Update so it follows ES 6 spec
- `Array.prototype.compact`: filters just null and undefined values
  (not all falsies)
- `Array.prototype.eIndexOf` and `Array.prototype.eLastIndexOf`: fix position
  handling, improve internals
- `Array.prototype.find`: return undefined not null, in case of not found
  (follow ES 6)
- `Array.prototype.remove` fix function length
- `Error.custom`: simplify, Custom class case is addressed by outer
  `error-create` project -> https://github.com/medikoo/error-create
- `Error.isError` true only for Error instances (remove detection of host
  Exception objects)
- `Number.prototype.pad`: Normalize negative pad
- `Object.clear`: Handle errors same way as in `Object.assign`
- `Object.compact`: filters just null and undefined values (not all falsies)
- `Object.compare`: Take into account NaN values
- `Object.copy`: Split into `Object.copy` and `Object.copyDeep`
- `Object.isCopy`: Separate into `Object.isCopy` and `Object.isCopyDeep`, where
  `isCopyDeep` handles nested plain objects and plain arrays only
- `String.prototype.endsWith`: Adjust up to ES6 specification
- `String.prototype.repeat`: Adjust up to ES6 specification and improve algorithm
- `String.prototype.simpleReplace`: Rename into `String.prototype.plainReplace`
- `String.prototype.startsWith`: Adjust up to ES6 specification
- Update lint rules, and adjust code to that
- Update Travis CI configuration
- Remove Makefile (it's cross-env utility)

v0.9.2  --  2013.03.11
Added:
* Array.prototype.isCopy
* Array.prototype.isUniq
* Error.CustomError
* Function.validFunction
* Object.extendDeep
* Object.descriptor.binder
* Object.safeTraverse
* RegExp.validRegExp
* String.prototype.capitalize
* String.prototype.simpleReplace

Fixed:
* Fix Array.prototype.diff for sparse arrays
* Accept primitive objects as input values in Object iteration methods and
  Object.clear, Object.count, Object.diff, Object.extend,
  Object.getPropertyNames, Object.values
* Pass expected arguments to callbacks of Object.filter, Object.mapKeys,
  Object.mapToArray, Object.map
* Improve callable callback support in Object.mapToArray

v0.9.1  --  2012.09.17
* Object.reduce - reduce for hash-like collections
* Accapt any callable object as callback in Object.filter, mapKeys and map
* Convention cleanup

v0.9.0  --  2012.09.13
We're getting to real solid API

Removed:
* Function#memoize - it's grown up to be external package, to be soon published
  as 'memoizee'
* String.guid - it doesn't fit es5-ext (extensions) concept, will be provided as
  external package
# Function.arguments - obsolete
# Function.context - obsolete
# Function#flip - not readable when used, so it was never used
# Object.clone - obsolete and confusing

Added:
* String#camelToHyphen - String format convertion

Renamed:
* String#dashToCamelCase -> String#hyphenToCamel

Fixes:
* Object.isObject - Quote names in literals that match reserved keywords
  (older implementations crashed on that)
* String#repeat - Do not accept negative values (coerce them to 1)

Improvements:
* Array#remove - Accepts many arguments, we can now remove many values at once
* Object iterators (forEach, map, some) - Compare function invoked with scope
  object bound to this
* Function#curry - Algorithm cleanup
* Object.isCopy - Support for all types, not just plain objects
* Object.isPlainObject - Support for cross-frame objects
* Do not memoize any of the functions, it shouldn't be decided internally
* Remove Object.freeze calls in reserved, it's not up to convention
* Improved documentation
* Better linting (hard-core approach using both JSLint mod and JSHint)
* Optional arguments are now documented in funtions signature

v0.8.2  --  2012.06.22
Fix errors in Array's intersection and exclusion methods, related to improper
usage of contains method

v0.8.1  --  2012.06.13
Reorganized internal logic of Function.prototype.memoize. So it's more safe now
and clears cache properly. Additionally preventCache option was provided.

v0.8.0  --  2012.05.28
Again, major overhaul. Probably last experimental stuff was trashed, all API
looks more like standard extensions now.

Changes:
* Turn all Object.prototype extensions into functions and move them to Object
namespace. We learned that extending Object.prototype is bad idea in any case.
* Rename Function.prototype.curry into Function.prototype.partial. This function
  is really doing partial application while currying is slightly different
  concept.
* Convert Function.prototype.ncurry to new implementation of
  Function.prototype.curry, it now serves real curry concept additionaly it
  covers use cases for aritize and hold, which were removed.
* Rename Array's peek to last, and provide support for sparse arrays in it
* Rename Date's monthDaysCount into daysInMonth
* Simplify object iterators, now order of iteration can be configured with just
  compareFn argument (no extra byKeys option)
* Rename Object.isDuplicate to Object.isCopy
* Rename Object.isEqual to Object.is which is compatible with future 'is'
  keyword
* Function.memoize is now Function.prototype.memoize. Additionally clear cache
  functionality is added, and access to original arguments object.
* Rename validation functions: assertNotNull to validValue, assertCallable to
  validCallable. validValue was moved to Object namespace. On success they now
  return validated value instead of true, it supports better composition.
  Additionally created Date.validDate and Error.validError
* All documentation is now held in README.md not in code files.
* Move guid to String namespace. All guids now start with numbers.
* Array.generate: fill argument is now optional
* Object.toArray is now Array.from (as new ES6 specification draft suggests)
* All methods that rely on indexOf or lastIndexOf, now rely on egal (Object.is)
  versions of them (eIndexOf, eLastIndexOf)
* Turn all get* functions that returned methods into actuall methods (get*
  functionality can still be achieved with help of Function.prototype.partial).
  So: Date.getFormat is now Date.prototype.format,
  Number.getPad is now Number.prototype.pad,
  String.getFormat is now String.prototype.format,
  String.getIndent is now String.prototype.indent,
  String.getPad is now String.prototype.pad
* Refactored Object.descriptor, it is now just two functions, main one and
  main.gs, main is for describing values, and gs for describing getters and
  setters. Configuration is passed with first argument as string e.g. 'ce' for
  configurable and enumerable. If no configuration string is provided then by
  default it returns configurable and writable but not enumerable for value or
  configurable but not enumerable for getter/setter
* Function.prototype.silent now returns prepared function (it was
  expected to be fixed for 0.7)
* Reserved keywords map (reserved) is now array not hash.
* Object.merge is now Object.extend (while former Object.extend was completely
  removed) - 'extend' implies that we change object, not creating new one (as
  'merge' may imply). Similarily Object.mergeProperties was renamed to
  Object.extendProperties
* Position argument support in Array.prototype.contains and
  String.prototype.contains (so it follows ES6 specification draft)
* endPosition argument support in String.prototype.endsWith and fromPosition
  argument support in String.prototype.startsWith (so it follows ES6
  specification draft)
* Better and cleaner String.prototype.indent implementation. No default value
  for indent string argument, optional nest value (defaults to 1), remove
  nostart argument
* Correct length values for most methods (so they reflect length of similar
  methods in standard)
* Length argument is now optional in number and string pad methods.
* Improve arguments validation in general, so it adheres to standard conventions
* Fixed format of package.json

Removed methods and functions:
* Object.prototype.slice - Object is not ordered collection, so slice doesn't
  make sense.
* Function's rcurry, rncurry, s - too cumbersome for JS, not many use cases for
  that
* Function.prototype.aritize and Function.prototype.hold - same functionality
  can be achieved with new Function.prototype.curry
* Function.prototype.log - provided more generic Function.prototype.wrap for
  same use case
* getNextIdGenerator - no use case for that (String.guid should be used if
  needed)
* Object.toObject - Can be now acheived with Object(validValue(x))
* Array.prototype.someValue - no real use case (personally used once and
  case was already controversial)
* Date.prototype.duration - moved to external package
* Number.getAutoincrement - No real use case
* Object.prototype.extend, Object.prototype.override,
  Object.prototype.plainCreate, Object.prototype.plainExtend - It was probably
  too complex, same should be achieved just with Object.create,
  Object.descriptor and by saving references to super methods in local scope.
* Object.getCompareBy - Functions should be created individually for each use
  case
* Object.get, Object.getSet, Object.set, Object.unset - Not many use cases and
  same can be easily achieved with simple inline function
* String.getPrefixWith - Not real use case for something that can be easily
  achieved with '+' operator
* Object.isPrimitive - It's just negation of Object.isObject
* Number.prototype.isLess, Number.prototype.isLessOrEqual - they shouldn't be in
  Number namespace and should rather be addressed with simple inline functions.
* Number.prototype.subtract - Should rather be addressed with simple inline
  function

New methods and functions:
* Array.prototype.lastIndex - Returns last declared index in array
* String.prototype.last - last for strings
* Function.prototype.wrap - Wrap function with other, it allows to specify
  before and after behavior transform return value or prevent original function
  from being called.
* Math.sign - Returns sign of a number (already in ES6 specification draft)
* Number.toInt - Converts value to integer (already in ES6 specification draft)
* Number.isNaN - Returns true if value is NaN (already in ES6 specification
  draft)
* Number.toUint - Converts value to unsigned integer
* Number.toUint32 - Converts value to 32bit unsigned integer
* Array.prototype.eIndexOf, eLastIndexOf - Egal version (that uses Object.is) of
  standard methods (all methods that were using native indexOf or lastIndexOf
  now uses eIndexOf and elastIndexOf respectively)
* Array.of - as it's specified for ES6

Fixes:
* Fixed binarySearch so it always returns valid list index
* Object.isList - it failed on lists that are callable (e.g. NodeList in Nitro
  engine)
* Object.map now supports third argument for callback

v0.7.1  --  2012.01.05
New methods:
* Array.prototype.firstIndex - returns first valid index of array (for
        sparse arrays it may not be '0'

Improvements:
* Array.prototype.first - now returns value for index returned by firstIndex
* Object.prototype.mapToArray - can be called without callback, then array of
        key-value pairs is returned

Fixes
* Array.prototype.forEachRight, object's length read through UInt32 conversion

v0.7.0  --  2011.12.27
Major update.
Stepped back from experimental ideas and introduced more standard approach
taking example from how ES5 methods and functions are designed. One exceptions
is that, we don’t refrain from declaring methods for Object.prototype - it’s up
to developer whether how he decides to use it in his context (as function or as
method).

In general:
* Removed any method 'functionalization' and functionalize method itself.
        es5-ext declares plain methods, which can be configured to work as functions
        with call.bind(method) - see documentation.
* Removed separation of Object methods for ES5 (with descriptors) and
        ES3 (plain) - we're following ES5 idea on that, some methods are intended just
        for enumerable properties and some are for all properties, all are declared
        for Object.prototype
* Removed separation of Array generic (collected in List folder) and not generic
        methods (collected in Array folder). Now all methods are generic and are in
        Array/prototype folder. This separation also meant, that methods in Array are
        usually destructive. We don’t do that separation now, there’s generally no use
        case for destructive iterators, we should be fine with one version of each
        method, (same as ES5 is fine with  e.g. one, non destructive 'filter' method)
* Folder structure resembles tree of native ES5 Objects
* All methods are written with ES5 conventions in mind, it means that most
        methods are generic and can be run on any object. In more detail:
        ** Array.prototype and Object.prototype methods can be run on any object (any
                not null or undefined value),
        ** Date.prototype methods should be called only on Date instances.
        ** Function.prototype methods can be called on any callable objects (not
                necessarily functions)
        ** Number.prototype & String.prototype methods can be called on any value, in
                case of Number it it’ll be degraded to number, in case of string it’ll be
                degraded to string.
* Travis CI support (only for Node v0.6 branch, as v0.4 has buggy V8 version)

Improvements for existing functions and methods:
* Function.memoize (was Function.cache) is now fully generic, can operate on any
        type of arguments and it’s NaN safe (all NaN objects are considered equal)
* Method properties passed to Object.prototype.extend or
        Object.prototype.override can aside of _super optionally take prototype object
        via _proto argument
* Object iterators: forEach, mapToArray and every can now iterate in specified
        order
* pluck, invoke and other functions that return reusable functions or methods
        have now their results memoized.

New methods:
* Global: assertNotNull, getNextIdGenerator, guid, isEqual, isPrimitive,
        toObject
* Array: generate
* Array.prototype: binarySearch, clear, contains, diff, exclusion, find, first,
        forEachRight, group, indexesOf, intersection, remove, someRight, someValue
* Boolean: isBoolean
* Date: isDate
* Function: arguments, context, insert, isArguments, remove
* Function.prototype: not, silent
* Number: getAutoincrement, isNumber
* Number.prototype: isLessOrEqual, isLess, subtract
* Object: assertCallable, descriptor (functions for clean descriptors),
        getCompareBy, isCallable, isObject
* Object.prototype: clone (real clone), compact, count, diff, empty,
        getPropertyNames, get, keyOf, mapKeys, override, plainCreate, plainExtend,
        slice, some, unset
* RegExp: isRegExp
* String: getPrefixWith, isString
* String.prototype: caseInsensitiveCompare, contains, isNumeric

Renamed methods:
* Date.clone -> Date.prototype.copy
* Date.format -> Date.getFormat
* Date/day/floor -> Date.prototype.floorDay
* Date/month/floor -> Date.prototype.floorMonth
* Date/month/year -> Date.prototype.floorYear
* Function.cache -> Function.memoize
* Function.getApplyArg -> Function.prototype.match
* Function.sequence -> Function.prototype.chain
* List.findSameStartLength -> Array.prototype.commonLeft
* Number.pad -> Number.getPad
* Object/plain/clone -> Object.prototype.copy
* Object/plain/elevate -> Object.prototype.flatten
* Object/plain/same -> Object.prototype.isDuplicate
* Object/plain/setValue -> Object.getSet
* String.format -> String.getFormat
* String.indent -> String.getIndent
* String.pad -> String.getPad
* String.trimLeftStr -> String.prototype.trimCommonLeft
* Object.merge -> Object.prototype.mergeProperties
* Object/plain/pluck -> Object.prototype.get
* Array.clone is now Array.prototype.copy and can be used also on any array-like
        objects
* List.isList -> Object.isList
* List.toArray -> Object.prototype.toArray
* String/convert/dashToCamelCase -> String.prototype.dashToCamelCase

Removed methods:
* Array.compact - removed destructive version (that operated on same array), we
        have now non destructive version as Array.prototype.compact.
* Function.applyBind -> use apply.bind directly
* Function.bindBind -> use bind.bind directly
* Function.callBind -> use call.bind directly
* Fuction.clone -> no valid use case
* Function.dscope -> controversial approach, shouldn’t be considered seriously
* Function.functionalize -> It was experimental but standards are standards
* List/sort/length -> It can be easy obtained by Object.getCompareBy(‘length’)
* List.concat -> Concat’s for array-like’s makes no sense, just convert to array
        first
* List.every -> Use Array.prototype.every directly
* List.filter -> Use Array.prototype.filter directly
* List.forEach -> User Array.prototype.forEach directly
* List.isListObject -> No valid use case, do: isList(list) && (typeof list ===
        'object’)
* List.map -> Use Array.prototype.map directly
* List.reduce -> Use Array.prototype.reduce directly
* List.shiftSame -> Use Array.prototype.commonLeft and do slice
* List.slice -> Use Array.prototype.slice directly
* List.some -> Use Array.prototype.some directly
* Object.bindMethods -> it was version that considered descriptors, we have now
        Object.prototype.bindMethods which operates only on enumerable properties
* Object.every -> version that considered all properties, we have now
        Object.prototype.every which iterates only enumerables
* Object.invoke -> no use case
* Object.mergeDeep -> no use case
* Object.pluck -> no use case
* Object.same -> it considered descriptors, now there’s only Object.isDuplicate
        which compares only enumerable properties
* Object.sameType -> no use case
* Object.toDescriptor and Object.toDescriptors -> replaced by much nicer
        Object.descriptor functions
* Object/plain/link -> no use case (it was used internally only by
        Object/plain/merge)
* Object/plain/setTrue -> now easily configurable by more universal
        Object.getSet(true)
* String.trimRightStr -> Eventually String.prototype.trimCommonRight will be
        added

v0.6.3  --  2011.12.12
* Cleared npm warning for misnamed property in package.json

v0.6.2  --  2011.08.12
* Calling String.indent without scope (global scope then) now treated as calling
  it with null scope, it allows more direct invocations when using default nest
  string: indent().call(str, nest)

v0.6.1  --  2011.08.08
* Added TAD test suite to devDependencies, configured test commands.
  Tests can be run with 'make test' or 'npm test'

v0.6.0  --  2011.08.07
New methods:
* Array: clone, compact (in place)
* Date: format, duration, clone, monthDaysCount, day.floor, month.floor,
  year.floor
* Function: getApplyArg, , ncurry, rncurry, hold, cache, log
* List: findSameStartLength, shiftSame, peek, isListObject
* Number: pad
* Object: sameType, toString, mapToArray, mergeDeep, toDescriptor,
  toDescriptors, invoke
* String: startsWith, endsWith, indent, trimLeftStr, trimRightStr, pad, format

Fixed:
* Object.extend does now prototypal extend as exptected
* Object.merge now tries to overwrite only configurable properties
* Function.flip

Improved:
* Faster List.toArray
* Better global retrieval
* Functionalized all Function methods
* Renamed bindApply and bindCall to applyBind and callBind
* Removed Function.inherit (as it's unintuitive curry clone)
* Straightforward logic in Function.k
* Fixed naming of some tests files (letter case issue)
* Renamed Function.saturate into Function.lock
* String.dashToCamelCase digits support
* Strings now considered as List objects
* Improved List.compact
* Concise logic for List.concat
* Test wit TAD in clean ES5 context

v0.5.1  --  2011.07.11
* Function's bindBind, bindCall and bindApply now more versatile

v0.5.0  --  2011.07.07
* Removed Object.is and List.apply
* Renamed Object.plain.is to Object.plain.isPlainObject (keep naming convention
  consistent)
* Improved documentation

v0.4.0  --  2011.07.05
* Take most functions on Object to Object.plain to keep them away from object
  descriptors
* Object functions with ES5 standard in mind (object descriptors)

v0.3.0  --  2011.06.24
* New functions
* Consistent file naming (dash instead of camelCase)

v0.2.1  --  2011.05.28
* Renamed Functions.K and Function.S to to lowercase versions (use consistent
  naming)

v0.2.0  --  2011.05.28
* Renamed Array folder to List (as its generic functions for array-like objects)
* Added Makefile
* Added various functions

v0.1.0  --  2011.05.24
* Initial version