mirror of
				https://github.com/cp6/my-idlers.git
				synced 2025-10-31 06:19:09 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			650 lines
		
	
	
	
		
			27 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			650 lines
		
	
	
	
		
			27 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
| For recent changelog see CHANGELOG.md
 | ||
| 
 | ||
| -----
 | ||
| 
 | ||
| v0.10.15  --  2017.03.20
 | ||
| * Fix Object.isValue (it was actually isNotValue)
 | ||
| 
 | ||
| v0.10.14  --  2017.03.15
 | ||
| * Object.isValue util
 | ||
| 
 | ||
| v0.10.13  --  2017.03.13
 | ||
| * Introduce JSON.safeStringify
 | ||
| * Improve message handling in error/custom
 | ||
| * Fix Array#concat shim
 | ||
| * Improve Array#flatten algorithm so it's stack trace friendly
 | ||
| * Make Object.isObject ES3 compatible
 | ||
| 
 | ||
| v0.10.12  --  2016.07.01
 | ||
| * Ensure symbols are copied in Object.mixin
 | ||
| * Prevent RangeError errors in array#flatten
 | ||
| * Do not validate invalidate dates in validDate
 | ||
| 
 | ||
| v0.10.11  --  2015.12.18
 | ||
| * Ensure that check for implementation of RegExp flags doesn't crash in V8 (thanks @mathiasbynens)
 | ||
| 
 | ||
| v0.10.10  --  2015.12.11
 | ||
| * Add Object.isNumberValue util
 | ||
| 
 | ||
| v0.10.9  --  2015.12.01
 | ||
| * Add Object.ensureNaturalNumber and Object.ensureNaturalNumberValue
 | ||
| 
 | ||
| v0.10.8  --  2015.10.02
 | ||
| * Add Number.isNatural
 | ||
| * Add Object.find and Object.findKey
 | ||
| * Support arrays in Object.copyDeep
 | ||
| * Fix iteration issue in forEachRight and someRight
 | ||
| * Fix detection of native sinh
 | ||
| * Depend on es6-symbol v3
 | ||
| 
 | ||
| v0.10.7  --  2015.04.22
 | ||
| * New utlitities. They're convention differs from v0.10, as they were supposed to land in v1.
 | ||
|   Still they're non breaking and start the conventions to be used in v1
 | ||
|   * Object.validateArrayLike
 | ||
|   * Object.validateArrayLikeObject
 | ||
|   * Object.validateStringifiable
 | ||
|   * Object.validateStringifiableValue
 | ||
|   * Universal utilities for array-like/iterable objects
 | ||
|     * Iterable.is
 | ||
|     * Iterable.validate
 | ||
|     * Iterable.validateObject
 | ||
|     * Iterable.forEach
 | ||
| * Fix camelToHyphen resolution, it must be absolutely reversable by hyphenToCamel
 | ||
| * Fix calculations of large numbers in Math.tanh
 | ||
| * Fix algorithm of Math.sinh
 | ||
| * Fix indexes to not use real symbols
 | ||
| * Fix length of String.fromCodePoint
 | ||
| * Fix tests of Array#copyWithin
 | ||
| * Update Travis CI configuration
 | ||
| 
 | ||
| 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
 |