eyjs 8.0.1 → 8.1.1

package/changelog.md

@@ -1,193 +1,260 @@
-# Changelog
-
-## [8.0.1] - 2025-12-02
-### Added
- - separate `.delegate` method that perform event delegation specific events handling
- - new `.once` method to add single-time-executable events!
-
-### Changed
- - `.on` third parameter now accepts handler properties now!
- 
-## [7.3.0] - 2025-11-18
-### Added
- - introducing `.has` a cheap check for certain elements
- 
-### Fixed
- - Docs are enhanced for some methods
- - Anti `null` procedure to avoids extra errors
-
-## [7.2.6] - 2025-11-16
-### Added
- - `.trigger` now accepts either event name or actual Event Object!
- - `.getctx` for getting canvas context.
- - `.remove` can directly find and remove a sub element!
-
-### Fixed
- - `.find` returning sometimes Array sometimes Element make no sense! so now it only returns an array or null!
- - `.click()` `.focus()` & `.blur()` and some other don't work! Fixed!
-
-## [7.1.7] - 2025-11-06
-### Added
- - `.after` and `.before` now either append or return the element lies after/next or before/previous.
-
-## [7.1.4] - 2025-10-14
-
-### Fixed
- - some properties inside `attr` are not being applied.
- 
-## [7.1.3] - 2025-10-07
-
-### Fixed
- - `.childlen` attribute not working, fixed.
- - `.after` `.before` functions don't work with EyeElement, fixed.
-
-## [7.1.1] - 2025-10-01
-
-### Changed
- - `.append` function only affect first selected element, also fixed to accept multiple selected element using `e` function.
- - functions now only affect first selected element in general.
- - library had been re-structured better.
-
-### Added
- - `e` our dear library now accepts arrays of elements like `e([HTMLDivElement, HTMLSpanElement, HTMLInputElement...])`
- - `.css` function may accept only numbers for properties such as `width` `height` `left` `top`...
-
-## [7.0.0] - 2025-09-01
-### Changed
- - the function now may return null for not found selectors, instead of empty eye element.
-
-### Added
- - new param `clone` in `.parent` function that allows you to append a clone of the element!
-
-## [6.2.0] - 2025-08-25
-
-### Changed
- - `.each` function can be interrupted from inside by returning false in the function.
-
-### Added
- - new `.eachChild` function to loop through selected elements children, also can be interupted by returning false.
-
-## [6.1.2] - 2025-08-17
-### Changed
- - added more delegation events `dblclick`, `pointerevents` & more `mouseevents`...
-
-### Added
- - new `position` function, to find element position within parent element
-
-## [6.0.2] - 2025-08-01
-### Changed
- - Better documentation for `.find` function
-
-### Fixed
- - when using `.class` to add simple classes the first character of each class get trimmed, Fixed.
-
-## [6.0.1] - 2025-07-30
-### Changed
- - `EyeElement` is also exported to help you better document your code using VSDocs
-
-### Fixed
- - using `.class("class1/class2")` shows error undefined variable v1 or v2, Fixed!
-
-## [6.0.0] - 2025-07-30
-### Changed
- - Library name changed to `eyjs`
- - main function name changed to `e` instead of `eye`
- - `after` `before` function now accepts both HTMLElement & EyeElement
-
-### Added
- - new `childlen` attribute to get children length
- - new `rAttr` function to remove attribute of an element
- - new `client` function to access client attributes such as "clientWidth" "clientLeft" ..
- - `.append` now also accepts new possible `pos` options `first`|`afterbegin` `last`|`beforeend`
-
-### Fixed
- - fixed error when using `.animate` function
-
-## [5.0.0] - 2025-07-21
-### Changed
- - library now uses ES6 class definition.
- - `.find` function `multiple` parameter is removed, also it return an HTMLElement instead of EyeElement, and an array if many selectors were found.
- - cloning a new model will return EyeElement instead of HTMLDivElement.
-
-## [4.0.4] - 2025-07-18
-### Changed
-
- - the libarary behavior changed now, instead of created element by directly puting them as `eye("div")`, now you do `eye("<div>")` instead for all elements ofc.
- - library now uses ES6.
- - `.animate` function now can return a direct animation object if selection is single.
-
-## [3.4.1] - 2025-07-16
-### Changed
- - `.pointer` function only effect the first element of a collection
- - better commentation and params definition
-
-## [3.4.0] - 2025-07-16
-### Added
- - new `.after` function 
- - new `.before` function 
- - new `.animate` function 
-
-## [3.3.4] - 2025-07-11
-### Fixed
- - error when using `.data`, fixed!
-
-## [3.3.2] - 2025-07-10
-### Fixed
-
- - fixed `.html` `.text` and `.val` to accept empty strings two!
-
-## [3.3.0] - 2025-07-009
-### Added
- - new `.redefine` function that redefine how to set/get or use `.text` and `.val` in general
-
-### Fixed
- - Accessing children length is now possible using empty/parameterless call of `.child`
-
-## [3.2.0] - 2025-07-08
-### Added
- - new `.serialize` function for form elements, check out [READM.md](./readme.md) for tutorial
-
-### Fixed
- - PROBLEM: `.append` function not accepting EyeElement as parameter(only accept pure HTMLElements), now accepts both.
- - PROBLEM: `.replaceWith` also accepts HTMLElements only, fixed to accept Eye elements too.
- - PROBLEM: `.is` only accepts HTMLElement, fixed to accept EyeElement too.
-
-## [3.1.1] - 2025-07-07
-### Added
- - function `val` added for supporting inputs manipulation
- - function `child` added for child selection
-
-### Fixed
- - function `css` now accept empty string value to remove style!
-
-## [3.0.1] - 2025-07-04
-### Added
- - new `.append` function with flexible `pos` to expand wide range of opportunities
- - new `.replaceWith` function
- - new `.parent` set/get function
- - new `.is` to compare nodes with flexible `check`
- - new `.each` to run multi selected elements
- - new `.off` function to remove event listeners
- - new `.trigger` function to ease controlling events
- - new `.find` function to find sub elements with `multiple` wild card parameter
- - new `.clone` function to clone current node
- - new `.compute` function to get element computed style declaration or DOMRect box
- - new `.pointer` function to unleash the PointerLock API and pointerCapture features 
-
-### Changed
- - a better modern core wrapper.
- - library now support processing multiple selection at once.
- - `.on` function now support targeted callbacks for event delegation.
- - `.data` function no more use dataset, rather it uses RAM.
- - `.attr` support setting to dataset using data-...
- - main function `eye` now support multi selection with [optional] "!" at the end of the selector to perform first occurence only.
-
-## [2.1.1] - 2025-07-01
-**Breaking News!**
-
-we've added a new feature in our little library!
-
-### Added
- - introducing a new feature `model`, where you can create models and use them multiple times around your code, without having to create the whole shit over and over, similar to react components but with less muli-files headache(check out readme.md to more tutorial of how to use).
-
- - `class` attribute now can accept a string concatenation of classes beside an array of them, so instead of `eye("div",{ class: ["class1","class2"]})` you can do `eye("div",{ class: "class1 class2" })`.
+# Changelog
+
+## [8.1.1] - 2026-01-19
+
+### Fixed
+
+- `attr` `html` `css` `text` return current EyeElement when attribute request is empty on the element, now it does returns null/undefined/""(empty string)
+
+### Changed
+
+- `delegate` method signature has better scope over surrounding entities, calling `this` inside the callback will reference the clicked element HTMLElement, second parameter of the callback is reference to the EyeElement representation of the clicked element while the third of the element parent first initialized with.
+
+## [8.0.1] - 2025-12-02
+
+### Added
+
+- separate `.delegate` method that perform event delegation specific events handling
+- new `.once` method to add single-time-executable events!
+
+### Changed
+
+- `.on` third parameter now accepts handler properties now!
+
+## [7.3.0] - 2025-11-18
+
+### Added
+
+- introducing `.has` a cheap check for certain elements
+
+### Fixed
+
+- Docs are enhanced for some methods
+- Anti `null` procedure to avoids extra errors
+
+## [7.2.6] - 2025-11-16
+
+### Added
+
+- `.trigger` now accepts either event name or actual Event Object!
+- `.getctx` for getting canvas context.
+- `.remove` can directly find and remove a sub element!
+
+### Fixed
+
+- `.find` returning sometimes Array sometimes Element make no sense! so now it only returns an array or null!
+- `.click()` `.focus()` & `.blur()` and some other don't work! Fixed!
+
+## [7.1.7] - 2025-11-06
+
+### Added
+
+- `.after` and `.before` now either append or return the element lies after/next or before/previous.
+
+## [7.1.4] - 2025-10-14
+
+### Fixed
+
+- some properties inside `attr` are not being applied.
+
+## [7.1.3] - 2025-10-07
+
+### Fixed
+
+- `.childlen` attribute not working, fixed.
+- `.after` `.before` functions don't work with EyeElement, fixed.
+
+## [7.1.1] - 2025-10-01
+
+### Changed
+
+- `.append` function only affect first selected element, also fixed to accept multiple selected element using `e` function.
+- functions now only affect first selected element in general.
+- library had been re-structured better.
+
+### Added
+
+- `e` our dear library now accepts arrays of elements like `e([HTMLDivElement, HTMLSpanElement, HTMLInputElement...])`
+- `.css` function may accept only numbers for properties such as `width` `height` `left` `top`...
+
+## [7.0.0] - 2025-09-01
+
+### Changed
+
+- the function now may return null for not found selectors, instead of empty eye element.
+
+### Added
+
+- new param `clone` in `.parent` function that allows you to append a clone of the element!
+
+## [6.2.0] - 2025-08-25
+
+### Changed
+
+- `.each` function can be interrupted from inside by returning false in the function.
+
+### Added
+
+- new `.eachChild` function to loop through selected elements children, also can be interupted by returning false.
+
+## [6.1.2] - 2025-08-17
+
+### Changed
+
+- added more delegation events `dblclick`, `pointerevents` & more `mouseevents`...
+
+### Added
+
+- new `position` function, to find element position within parent element
+
+## [6.0.2] - 2025-08-01
+
+### Changed
+
+- Better documentation for `.find` function
+
+### Fixed
+
+- when using `.class` to add simple classes the first character of each class get trimmed, Fixed.
+
+## [6.0.1] - 2025-07-30
+
+### Changed
+
+- `EyeElement` is also exported to help you better document your code using VSDocs
+
+### Fixed
+
+- using `.class("class1/class2")` shows error undefined variable v1 or v2, Fixed!
+
+## [6.0.0] - 2025-07-30
+
+### Changed
+
+- Library name changed to `eyjs`
+- main function name changed to `e` instead of `eye`
+- `after` `before` function now accepts both HTMLElement & EyeElement
+
+### Added
+
+- new `childlen` attribute to get children length
+- new `rAttr` function to remove attribute of an element
+- new `client` function to access client attributes such as "clientWidth" "clientLeft" ..
+- `.append` now also accepts new possible `pos` options `first`|`afterbegin` `last`|`beforeend`
+
+### Fixed
+
+- fixed error when using `.animate` function
+
+## [5.0.0] - 2025-07-21
+
+### Changed
+
+- library now uses ES6 class definition.
+- `.find` function `multiple` parameter is removed, also it return an HTMLElement instead of EyeElement, and an array if many selectors were found.
+- cloning a new model will return EyeElement instead of HTMLDivElement.
+
+## [4.0.4] - 2025-07-18
+
+### Changed
+
+- the libarary behavior changed now, instead of created element by directly puting them as `eye("div")`, now you do `eye("<div>")` instead for all elements ofc.
+- library now uses ES6.
+- `.animate` function now can return a direct animation object if selection is single.
+
+## [3.4.1] - 2025-07-16
+
+### Changed
+
+- `.pointer` function only effect the first element of a collection
+- better commentation and params definition
+
+## [3.4.0] - 2025-07-16
+
+### Added
+
+- new `.after` function
+- new `.before` function
+- new `.animate` function
+
+## [3.3.4] - 2025-07-11
+
+### Fixed
+
+- error when using `.data`, fixed!
+
+## [3.3.2] - 2025-07-10
+
+### Fixed
+
+- fixed `.html` `.text` and `.val` to accept empty strings two!
+
+## [3.3.0] - 2025-07-009
+
+### Added
+
+- new `.redefine` function that redefine how to set/get or use `.text` and `.val` in general
+
+### Fixed
+
+- Accessing children length is now possible using empty/parameterless call of `.child`
+
+## [3.2.0] - 2025-07-08
+
+### Added
+
+- new `.serialize` function for form elements, check out [READM.md](./readme.md) for tutorial
+
+### Fixed
+
+- PROBLEM: `.append` function not accepting EyeElement as parameter(only accept pure HTMLElements), now accepts both.
+- PROBLEM: `.replaceWith` also accepts HTMLElements only, fixed to accept Eye elements too.
+- PROBLEM: `.is` only accepts HTMLElement, fixed to accept EyeElement too.
+
+## [3.1.1] - 2025-07-07
+
+### Added
+
+- function `val` added for supporting inputs manipulation
+- function `child` added for child selection
+
+### Fixed
+
+- function `css` now accept empty string value to remove style!
+
+## [3.0.1] - 2025-07-04
+
+### Added
+
+- new `.append` function with flexible `pos` to expand wide range of opportunities
+- new `.replaceWith` function
+- new `.parent` set/get function
+- new `.is` to compare nodes with flexible `check`
+- new `.each` to run multi selected elements
+- new `.off` function to remove event listeners
+- new `.trigger` function to ease controlling events
+- new `.find` function to find sub elements with `multiple` wild card parameter
+- new `.clone` function to clone current node
+- new `.compute` function to get element computed style declaration or DOMRect box
+- new `.pointer` function to unleash the PointerLock API and pointerCapture features
+
+### Changed
+
+- a better modern core wrapper.
+- library now support processing multiple selection at once.
+- `.on` function now support targeted callbacks for event delegation.
+- `.data` function no more use dataset, rather it uses RAM.
+- `.attr` support setting to dataset using data-...
+- main function `eye` now support multi selection with [optional] "!" at the end of the selector to perform first occurence only.
+
+## [2.1.1] - 2025-07-01
+
+**Breaking News!**
+
+we've added a new feature in our little library!
+
+### Added
+
+- introducing a new feature `model`, where you can create models and use them multiple times around your code, without having to create the whole shit over and over, similar to react components but with less muli-files headache(check out readme.md to more tutorial of how to use).
+
+- `class` attribute now can accept a string concatenation of classes beside an array of them, so instead of `eye("div",{ class: ["class1","class2"]})` you can do `eye("div",{ class: "class1 class2" })`.