Bumped version to 5.0.0

Author: fabiospampinato

CHANGELOG.md

@@ -1,3 +1,15 @@
+### Version 5.0.0
+- Dropped support for IE10
+- $.fn.hasClass: ensuring it always returns a boolean
+- $.fn.off: accepting also an events map as its only argument
+- $.fn.show|toggle: restoring custom display values
+- $.fn.before|after|append|prepend|insertBefore|insertAfter|appendTo|prependTo: ensuring multiple nodes are inserted in the correct order
+- Ensuring attached events never get forgotten
+- Ensuring script tags are executed even if they have a “src” attribute, and without using `eval`
+- Ensuring the order of event namespaces doesn’t matter
+- Squeezed some more bytes out of the bundle (~4%) and improved code style consistency
+- Squeezed some more bytes out of the bundle (~1.5%), bringing back the minified and gzipped size below 5kb
+
 ### Version 4.1.5
 - $.fn.val: ensuring it works with “input[type=file][multiple]” elements
 - Migration guide: mentioning how $.fn.data stores values

README.md

@@ -30,10 +30,10 @@ If you're migrating from jQuery be sure to read our [migration guide](https://gi
 
 ## Usage
 
-Get Cash from [CloudFlare](https://cdnjs.cloudflare.com/ajax/libs/cash/4.1.5/cash.min.js) or [jsDelivr](https://cdn.jsdelivr.net/npm/cash-dom@4.1.5/dist/cash.min.js) and use it like this:
+Get Cash from [CloudFlare](https://cdnjs.cloudflare.com/ajax/libs/cash/5.0.0/cash.min.js) or [jsDelivr](https://cdn.jsdelivr.net/npm/cash-dom@5.0.0/dist/cash.min.js) and use it like this:
 
 ```html
-<script src="https://cdnjs.cloudflare.com/ajax/libs/cash/4.1.5/cash.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/cash/5.0.0/cash.min.js"></script>
 <script>
   $(function () {
     $('html').addClass ( 'dom-loaded' );

dist/cash.d.ts

@@ -1,3 +1,8 @@
+interface Event {
+    namespace: string;
+    data: any;
+    ___cd?: boolean;
+}
 interface Cash {
     [index: number]: EleLoose | undefined;
     length: number;
@@ -7,17 +12,14 @@ interface Cash {
 interface CashStatic {
     fn: Cash;
 }
-declare type plainObject = {
-    [index: string]: any;
-};
 declare type falsy = undefined | null | false | 0 | '';
 declare type EleHTML = HTMLElement | HTMLAnchorElement | HTMLAppletElement | HTMLAreaElement | HTMLAudioElement | HTMLBRElement | HTMLBaseElement | HTMLBaseFontElement | HTMLBodyElement | HTMLButtonElement | HTMLCanvasElement | HTMLDListElement | HTMLDataElement | HTMLDataListElement | HTMLDetailsElement | HTMLDialogElement | HTMLDirectoryElement | HTMLDivElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFontElement | HTMLFormElement | HTMLFrameElement | HTMLFrameSetElement | HTMLHRElement | HTMLHeadElement | HTMLHeadingElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLInputElement | HTMLLIElement | HTMLLabelElement | HTMLLegendElement | HTMLLinkElement | HTMLMapElement | HTMLMarqueeElement | HTMLMediaElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLModElement | HTMLOListElement | HTMLObjectElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOrSVGElement | HTMLOutputElement | HTMLParagraphElement | HTMLParamElement | HTMLPictureElement | HTMLPreElement | HTMLProgressElement | HTMLQuoteElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSourceElement | HTMLSpanElement | HTMLStyleElement | HTMLTableCaptionElement | HTMLTableCellElement | HTMLTableColElement | HTMLTableDataCellElement | HTMLTableElement | HTMLTableHeaderCellElement | HTMLTableRowElement | HTMLTableSectionElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTitleElement | HTMLTrackElement | HTMLUListElement | HTMLUnknownElement | HTMLVideoElement;
 declare type EleHTMLLoose = HTMLElement & HTMLAnchorElement & HTMLAppletElement & HTMLAreaElement & HTMLAudioElement & HTMLBRElement & HTMLBaseElement & HTMLBaseFontElement & HTMLBodyElement & HTMLButtonElement & HTMLCanvasElement & HTMLDListElement & HTMLDataElement & HTMLDataListElement & HTMLDetailsElement & HTMLDialogElement & HTMLDirectoryElement & HTMLDivElement & HTMLEmbedElement & HTMLFieldSetElement & HTMLFontElement & HTMLFormElement & HTMLFrameElement & HTMLFrameSetElement & HTMLHRElement & HTMLHeadElement & HTMLHeadingElement & HTMLHtmlElement & HTMLIFrameElement & HTMLImageElement & HTMLInputElement & HTMLLIElement & HTMLLabelElement & HTMLLegendElement & HTMLLinkElement & HTMLMapElement & HTMLMarqueeElement & HTMLMediaElement & HTMLMenuElement & HTMLMetaElement & HTMLMeterElement & HTMLModElement & HTMLOListElement & HTMLObjectElement & HTMLOptGroupElement & HTMLOptionElement & HTMLOrSVGElement & HTMLOutputElement & HTMLParagraphElement & HTMLParamElement & HTMLPictureElement & HTMLPreElement & HTMLProgressElement & HTMLQuoteElement & HTMLScriptElement & HTMLSelectElement & HTMLSlotElement & HTMLSourceElement & HTMLSpanElement & HTMLStyleElement & HTMLTableCaptionElement & HTMLTableCellElement & HTMLTableColElement & HTMLTableDataCellElement & HTMLTableElement & HTMLTableHeaderCellElement & HTMLTableRowElement & HTMLTableSectionElement & HTMLTemplateElement & HTMLTextAreaElement & HTMLTimeElement & HTMLTitleElement & HTMLTrackElement & HTMLUListElement & HTMLUnknownElement & HTMLVideoElement;
 declare type Ele = Window | Document | EleHTML | Element | Node;
 declare type EleLoose = Window & Document & EleHTMLLoose & Element & Node;
 declare type Selector = falsy | string | Function | HTMLCollection | NodeList | Ele | Ele[] | ArrayLike<Ele> | Cash;
-declare type Comparator = string | Ele | Cash | ((this: Ele, index: number, ele: Ele) => boolean);
-declare type Context = Document | HTMLElement | Element;
+declare type Comparator = string | Ele | Cash | ((this: EleLoose, index: number, ele: EleLoose) => boolean);
+declare type Context = Document | EleHTML | Element;
 declare type EventCallback = {
     (event: any, data?: any): any;
     guid?: number;
@@ -26,20 +28,7 @@ declare class Cash {
     constructor(selector?: Selector, context?: Context | Cash);
     init(selector?: Selector, context?: Context | Cash): Cash;
 }
-declare const cash: ((selector?: Selector, context?: Element | HTMLElement | Document | Cash) => Cash) & CashStatic;
-interface Cash {
-    get(): EleLoose[];
-    get(index: number): EleLoose | undefined;
-}
-interface Cash {
-    eq(index: number): Cash;
-}
-interface Cash {
-    first(): Cash;
-}
-interface Cash {
-    last(): Cash;
-}
+declare const cash: ((selector?: Selector, context?: Element | HTMLMediaElement | HTMLElement | HTMLOrSVGElement | HTMLCanvasElement | HTMLImageElement | HTMLVideoElement | Document | HTMLAnchorElement | HTMLAppletElement | HTMLScriptElement | HTMLEmbedElement | HTMLFormElement | HTMLHeadElement | HTMLAreaElement | HTMLObjectElement | HTMLLinkElement | HTMLTrackElement | HTMLProgressElement | HTMLAudioElement | HTMLBaseElement | HTMLBaseFontElement | HTMLQuoteElement | HTMLBodyElement | HTMLBRElement | HTMLButtonElement | HTMLTableCaptionElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDirectoryElement | HTMLDivElement | HTMLDListElement | HTMLFieldSetElement | HTMLFontElement | HTMLFrameElement | HTMLFrameSetElement | HTMLHeadingElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLInputElement | HTMLLabelElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMarqueeElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLParagraphElement | HTMLParamElement | HTMLPictureElement | HTMLPreElement | HTMLSelectElement | HTMLSlotElement | HTMLSourceElement | HTMLSpanElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableDataCellElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTableHeaderCellElement | HTMLTimeElement | HTMLTitleElement | HTMLTableRowElement | HTMLUListElement | HTMLUnknownElement | Cash) => Cash) & CashStatic;
 declare type MapCallback<T> = (this: T, index: number, ele: T) => Ele;
 interface Cash {
     map(callback: MapCallback<EleLoose>): Cash;
@@ -60,12 +49,12 @@ interface Cash {
 interface Cash {
     removeProp(prop: string): this;
 }
-interface Cash {
-    extend(plugins: plainObject): this;
-}
 interface CashStatic {
     extend(target: any, ...objs: any[]): any;
 }
+interface Cash {
+    extend(plugins: Record<any, any>): this;
+}
 interface CashStatic {
     guid: number;
 }
@@ -82,10 +71,23 @@ interface CashStatic {
 interface Cash {
     prop(prop: string): any;
     prop(prop: string, value: any): this;
-    prop(props: plainObject): this;
+    prop(props: Record<string, any>): this;
+}
+interface Cash {
+    get(): EleLoose[];
+    get(index: number): EleLoose | undefined;
+}
+interface Cash {
+    eq(index: number): Cash;
+}
+interface Cash {
+    first(): Cash;
+}
+interface Cash {
+    last(): Cash;
 }
 interface Cash {
-    filter(comparator: Comparator): Cash;
+    filter(comparator?: Comparator): Cash;
 }
 interface Cash {
     hasClass(cls: string): boolean;
@@ -97,7 +99,7 @@ interface Cash {
     attr(): undefined;
     attr(attrs: string): string | null;
     attr(attrs: string, value: string): this;
-    attr(attrs: plainObject): this;
+    attr(attrs: Record<string, string>): this;
 }
 interface Cash {
     toggleClass(classes: string, force?: boolean): this;
@@ -119,29 +121,27 @@ interface CashStatic {
 }
 interface Cash {
     css(prop: string): string | undefined;
-    css(prop: string, value: string): this;
-    css(props: plainObject): this;
+    css(prop: string, value: number | string): this;
+    css(props: Record<string, number | string>): this;
 }
 interface Cash {
-    data(): plainObject | undefined;
+    data(): Record<string, any> | undefined;
     data(name: string): any;
     data(name: string, value: any): this;
-    data(datas: plainObject): this;
+    data(datas: Record<string, any>): this;
 }
 interface Cash {
     innerWidth(): number | undefined;
     innerHeight(): number | undefined;
+    outerWidth(includeMargins?: boolean): number;
+    outerHeight(includeMargins?: boolean): number;
 }
 interface Cash {
     width(): number;
     width(value: number | string): this;
     height(): number;
     height(value: number | string): this;
 }
-interface Cash {
-    outerWidth(includeMargins?: boolean): number;
-    outerHeight(includeMargins?: boolean): number;
-}
 interface Cash {
     toggle(force?: boolean): this;
 }
@@ -154,16 +154,17 @@ interface Cash {
 interface Cash {
     off(): this;
     off(events: string): this;
+    off(events: Record<string, EventCallback>): this;
     off(events: string, callback: EventCallback): this;
     off(events: string, selector: string, callback: EventCallback): this;
 }
 interface Cash {
-    on(events: plainObject): this;
+    on(events: Record<string, EventCallback>): this;
     on(events: string, callback: EventCallback, _one?: boolean): this;
     on(events: string, selector: string | EventCallback, callback: EventCallback, _one?: boolean): this;
 }
 interface Cash {
-    one(events: plainObject): this;
+    one(events: Record<string, EventCallback>): this;
     one(events: string, callback: EventCallback): this;
     one(events: string, selector: string | EventCallback, callback: EventCallback): this;
 }
@@ -187,7 +188,7 @@ interface Cash {
     detach(): this;
 }
 interface CashStatic {
-    parseHTML(html: string): Ele[];
+    parseHTML(html: string): EleLoose[];
 }
 interface Cash {
     empty(): this;
@@ -230,24 +231,24 @@ interface Cash {
 interface Cash {
     find(selector: string): Cash;
 }
+interface Cash {
+    after(...selectors: Selector[]): this;
+}
 interface Cash {
     append(...selectors: Selector[]): this;
 }
 interface Cash {
     appendTo(selector: Selector): this;
 }
 interface Cash {
-    insertAfter(selector: Selector): this;
+    before(...selectors: Selector[]): this;
 }
 interface Cash {
-    after(...selectors: Selector[]): this;
+    insertAfter(selector: Selector): this;
 }
 interface Cash {
     insertBefore(selector: Selector): this;
 }
-interface Cash {
-    before(...selectors: Selector[]): this;
-}
 interface Cash {
     prepend(...selectors: Selector[]): this;
 }
@@ -270,10 +271,10 @@ interface Cash {
     wrapInner(selector?: Selector): this;
 }
 interface Cash {
-    has(selector: string | HTMLElement): Cash;
+    has(selector: string | Node): Cash;
 }
 interface Cash {
-    is(comparator: Comparator): boolean;
+    is(comparator?: Comparator): boolean;
 }
 interface Cash {
     next(comparator?: Comparator, _all?: boolean): Cash;
@@ -282,7 +283,7 @@ interface Cash {
     nextAll(comparator?: Comparator): Cash;
 }
 interface Cash {
-    not(comparator: Comparator): Cash;
+    not(comparator?: Comparator): Cash;
 }
 interface Cash {
     parent(comparator?: Comparator): Cash;
@@ -291,7 +292,7 @@ interface Cash {
     index(selector?: Selector): number;
 }
 interface Cash {
-    closest(comparator: Comparator): Cash;
+    closest(comparator?: Comparator): Cash;
 }
 interface Cash {
     parents(comparator?: Comparator): Cash;