Bumped version to 4.1.4

fabiospampinato · Aug 5, 2019 · 269a842 · 269a842
1 parent ecfbdc3
commit 269a842
Show file tree

Hide file tree

Showing 5 changed files with 30 additions and 19 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,10 @@
+### Version 4.1.4
+- $.fn.get: improved types
+- TypeScript: made types a little more forgiving
+- TypeScript: improved collections index signature
+- TypeScript: improved support for props/methods available only in specific HTML nodes
+- Added a guide for extending Cash
+
 ### Version 4.1.3
 - Ensuring Cash can be bundled correctly via WebPack
 - $.fn.toggle: ensuring each element is toggled independently

diff --git a/README.md b/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.3/cash.min.js) or [jsDelivr](https://cdn.jsdelivr.net/npm/[email protected].3/dist/cash.min.js) and use it like this:
+Get Cash from [CloudFlare](https://cdnjs.cloudflare.com/ajax/libs/cash/4.1.4/cash.min.js) or [jsDelivr](https://cdn.jsdelivr.net/npm/[email protected].4/dist/cash.min.js) and use it like this:
 
 ```html
-<script src="https://cdnjs.cloudflare.com/ajax/libs/cash/4.1.3/cash.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/cash/4.1.4/cash.min.js"></script>
 <script>
   $(function () {
     $('html').addClass ( 'dom-loaded' );

diff --git a/dist/cash.d.ts b/dist/cash.d.ts
@@ -1,8 +1,8 @@
 interface Cash {
-    [index: number]: EleLoose;
+    [index: number]: EleLoose | undefined;
     length: number;
-    splice(start: number, deleteCount?: number): Ele[];
-    splice(start: number, deleteCount: number, ...items: Ele[]): Ele[];
+    splice(start: number, deleteCount?: number): EleLoose[];
+    splice(start: number, deleteCount: number, ...items: Ele[]): EleLoose[];
 }
 interface CashStatic {
     fn: Cash;
@@ -11,8 +11,10 @@ declare type plainObject = {
     [index: string]: any;
 };
 declare type falsy = undefined | null | false | 0 | '';
-declare type Ele = Window | Document | HTMLElement | Element | Node;
-declare type EleLoose = Window & Document & HTMLElement & Element & Node;
+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;
@@ -26,8 +28,8 @@ declare class Cash {
 }
 declare const cash: ((selector?: Selector, context?: Element | HTMLElement | Document | Cash) => Cash) & CashStatic;
 interface Cash {
-    get(): Ele[];
-    get(index: number): Ele;
+    get(): EleLoose[];
+    get(index: number): EleLoose | undefined;
 }
 interface Cash {
     eq(index: number): Cash;
@@ -304,4 +306,4 @@ interface Cash {
     siblings(comparator?: Comparator): Cash;
 }
 export default cash;
-export { Cash, Ele as Element, Selector, Comparator, Context };
+export { Cash, CashStatic, Ele as Element, Selector, Comparator, Context };
diff --git a/dist/cash.ts b/dist/cash.ts
@@ -1,9 +1,9 @@
 
 interface Cash {
-  [index: number]: EleLoose,
+  [index: number]: EleLoose | undefined,
   length: number,
-  splice ( start: number, deleteCount?: number ): Ele[],
-  splice ( start: number, deleteCount: number, ...items: Ele[] ): Ele[]
+  splice ( start: number, deleteCount?: number ): EleLoose[],
+  splice ( start: number, deleteCount: number, ...items: Ele[] ): EleLoose[]
 }
 
 interface CashStatic {
@@ -13,8 +13,10 @@ interface CashStatic {
 type plainObject = { [index: string]: any };
 type falsy = undefined | null | false | 0 | '';
 
-type Ele = Window | Document | HTMLElement | Element | Node;
-type EleLoose = Window & Document & HTMLElement & Element & Node; //UGLY: Trick to remove some kind-of useless type errors //URL: https://github.com/kenwheeler/cash/issues/278
+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;
+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;
+type Ele = Window | Document | EleHTML | Element | Node;
+type EleLoose = Window & Document & EleHTMLLoose & Element & Node; //UGLY: Trick to remove some kind-of useless type errors //URL: https://github.com/kenwheeler/cash/issues/278
 type Selector = falsy | string | Function | HTMLCollection | NodeList | Ele | Ele[] | ArrayLike<Ele> | Cash;
 type Comparator = string | Ele | Cash | (( this: Ele, index: number, ele: Ele ) => boolean);
 type Context = Document | HTMLElement | Element;
@@ -118,8 +120,8 @@ if ( typeof Symbol === 'function' ) {
 // @require core/variables.ts
 
 interface Cash {
-  get (): Ele[];
-  get ( index: number ): Ele;
+  get (): EleLoose[];
+  get ( index: number ): EleLoose | undefined;
 }
 
 Cash.prototype.get = function ( this: Cash, index?: number ) {
@@ -2517,4 +2519,4 @@ Cash.prototype.siblings = function ( this: Cash, comparator?: Comparator ) {
 // @require ./cash.ts
 
 export default cash;
-export { Cash, Ele as Element, Selector, Comparator, Context };
+export {Cash, CashStatic, Ele as Element, Selector, Comparator, Context};
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cash-dom",
   "description": "An absurdly small jQuery alternative for modern browsers.",
-  "version": "4.1.3",
+  "version": "4.1.4",
   "license": "MIT",
   "browser": "./dist/cash.js",
   "main": "./dist/cash.js",