From a08cfaa635c71c61487a34efc5b8f3ce16469a92 Mon Sep 17 00:00:00 2001
From: Cameron Little <cameron@camlittle.com>
Date: Thu, 9 Mar 2017 21:22:51 -0800
Subject: [PATCH] Add imagesloaded `once` event listener and config to ctor
 (#15091)

Documented at http://imagesloaded.desandro.com/#vanilla-javascript
---
 imagesloaded/imagesloaded-tests.ts | 12 ++++++++++--
 imagesloaded/index.d.ts            | 13 ++++++++++---
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/imagesloaded/imagesloaded-tests.ts b/imagesloaded/imagesloaded-tests.ts
index 3f5ead2831..385df7b052 100644
--- a/imagesloaded/imagesloaded-tests.ts
+++ b/imagesloaded/imagesloaded-tests.ts
@@ -1,5 +1,3 @@
-
-
 function test_ctor() {
   // element
   imagesLoaded(document.querySelector('#container'), function(instance) {
@@ -12,6 +10,14 @@ function test_ctor() {
   // multiple elements
   var posts = document.querySelectorAll('.post');
   imagesLoaded(posts, function() { console.log('all images are loaded'); });
+
+  // options
+  imagesLoaded('#container', { background: true }, function() {
+      console.log('all images are loaded');
+  });
+  imagesLoaded('#container', { background: '.item' }, function() {
+      console.log('all images are loaded');
+  });
 }
 
 function test_events_basic() {
@@ -25,6 +31,8 @@ function test_events_basic() {
   imgLoad.on('always', onAlways);
   // unbind with .off()
   imgLoad.off('always', onAlways);
+  // bind once with .once()
+  imgLoad.once('always', onAlways);
 }
 
 function test_events_full() {
diff --git a/imagesloaded/index.d.ts b/imagesloaded/index.d.ts
index 507f082367..9a48a18e19 100644
--- a/imagesloaded/index.d.ts
+++ b/imagesloaded/index.d.ts
@@ -1,9 +1,9 @@
-// Type definitions for imagesLoaded 3.1.8
+// Type definitions for imagesLoaded 4.1.1
 // Project: https://github.com/desandro/imagesloaded
-// Definitions by: Chris Charabaruk <http://github.com/coldacid>
+// Definitions by: Chris Charabaruk <https://github.com/coldacid>, Cameron Little <https://github.com/apexskier>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-///<reference types="jquery" />
+/// <reference types="jquery" />
 
 declare namespace ImagesLoaded {
   type ElementSelector = Element | NodeList | Array<Element> | string;
@@ -30,14 +30,21 @@ declare namespace ImagesLoaded {
     // event listeners
     on(event: string, listener: ImagesLoadedListener): void;
     off(event: string, listener: ImagesLoadedListener): void;
+    once(event: string, listener: ImagesLoadedListener): void;
+  }
+
+  interface ImagesLoadedOptions {
+    background: true | string;
   }
 
   interface ImagesLoadedConstructor {
     /**
      * Creates a new ImagesLoaded object with the provided callback
      * @param elem Element, NodeList, Element array, or selector string for images to watch
+     * @param options object that can tell imagesloaded to watch background images as well
      * @param callback function triggered after all images have been loaded
      */
+    (elem: ElementSelector, options: ImagesLoadedOptions, callback?: ImagesLoadedCallback): ImagesLoaded;
     (elem: ElementSelector, callback?: ImagesLoadedCallback): ImagesLoaded;
   }
 }