@malko/l.js 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <2012-2023> Jonathan Gotti <jgotti at jgotti dot org >
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# l.js is another simple/tiny javascript/css loader
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmalko%2Fl.js.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmalko%2Fl.js?ref=badge_shield)
+
+
+## features
+- compatible with all ECMASCRIPT 5.1 browsers (Warning for old users this is a breaking change on supporting long time deprecated browsers)
+- parallel script / css loading
+- callback after script loading (css support callback too but are executed imediately)
+- tiny only 2ko uglifyed, less than 1.1ko gziped (at least for latest revision)
+- may load in order to preserve dependencies
+- support aliases for simpler calling
+- on demand loading
+- only one script tag required
+- clear syntax (to use not in the source code :) )
+- successive load of same file will load it once but execute all callbacks associated
+- can dumbly check already inserted tags at load time
+- may use a fallback url on error (only for js files and with error events compatible browsers)
+- may register error handlers (only for js files and with error events compatible browsers)
+- can load javascripts modules
+
+## examples
+
+### loading ljs and another libs with one single tag
+```html
+<script src="l.js">
+	ljs.load('myLib.js',function(){ /* your callback here */});
+</script>
+```
+or using jsdeliver CDN:
+```html
+<script src="https://cdn.jsdelivr.net/gh/malko/l.js@latest/l.min.js">
+	ljs.load('myLib.js',function(){ /* your callback here */});
+</script>
+```
+
+> If you're looking for the npm package, you should search for l.js-loader
+> ```npm install @malko/l.js```
+
+### loading some scripts in parallel others in order
+```html
+<script src="l.js">
+	ljs
+		.load('myLib.js')
+		.load('myRequiredLib.js','myDependentLib.js',function(){ /* your callback here */})
+	;
+</script>
+```
+second load will be executed in parallel of first load but myDependentLib.js won't load before myRequireLib.js is loaded
+
+```html
+<script src="l.js">
+	ljs.load(['myLib.js','myRequiredLib.js'],'myDependentLib.js',function(){ /* your callback here */});
+</script>
+```
+this will load myLib.js and myRequiredLib.js in parrallel and wait for them before loading myDependentLib.js
+
+
+### using some aliases for simpler loading
+```html
+<script src="l.js?checkLoaded"> // <- adding checkLoaded to the url will dumbly check already inserted script/link tags
+	ljs
+		.addAliases({
+			jQuery:'http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js#jqueryId' // <- script tag will have attribute id=jqueryId
+			,ui:[
+				'jQuery'
+				,'https://ajax.googleapis.com/ajax/libs/jqueryui/1.8.18/jquery-ui.min.js'
+				,'myUITheme.css'
+			]
+		})
+		.load('ui',function(){
+			/* work with both jquery and jquery-ui here */
+		})
+	;
+</script>
+```
+
+### define a fallback url
+l.js also support a fallback url for javascript files in case you want to try to get the resource from another location on loading failure
+You can define this fallback url parameter like you define ids. The difference is you will prefix with **#=** instead of # alone
+```html
+<script src="l.js">
+	ljs.load('http://domain.com/myLib.js#=/myfallback.js#myid',function(){
+		/*
+			generated script tag will have myid as id and will try to load /myfallback.js if it fail to load http://domain.com/myLib.js
+		*/
+	});
+</script>
+```
+
+### register an error handler
+```html
+<script src="l.js">
+	ljs
+		.load('missingFile.js',function(){ /* your callback here */})
+		.onError(function(url) {
+			console.log('error loading', url); // <- will print "error loading missingFile.js"
+		})
+	;
+</script>
+```
+
+### load a js module
+As a default l.js load js scripts with their type attribute set to `text/javascript`. To set type to `module` instead, simply prefix the url with `module:`
+
+```html
+<script src="l.js">
+    ljs.load('module:myModuleLib.js',function(){ /* your callback here */});
+</script>
+```
+
+this piece of code is dual licensed under MIT / GPL
+Hope this help, code review, suggestions, bug reports are welcome and appreciated.
+
+
+## License
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmalko%2Fl.js.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmalko%2Fl.js?ref=badge_large)

package/l.min.js

@@ -0,0 +1,2 @@
+//https://github.com/malko/l.js v0.2.2 MIT license ©Jonathan Gotti
+!function(e,l){function a(e,n){return e instanceof(n||Array)}function u(e,n,r){var t,o=c.createElement(e);for(t in r&&(o[s]?o[f]=function(){"loaded"!==o[s]&&"complete"!==o[s]||(o[f]=null,r())}:o.onload=r),n)n[t]&&(o[t]=n[t]);p.appendChild(o)}var c=document,n="getElementsByTagName",i="length",s="readyState",f="onreadystatechange",d="script",p=c[n]("head")[0]||c.documentElement,h={},r=c[n](d),t=r[r[i]-1],o=t.innerHTML.replace(/^\s+|\s+$/g,"");if(!e.ljs){function m(e){var o={};return o.u=e.replace(/(^module:)|#(=)?([^#]*)?/g,function(e,n,r,t){return o[n?"m":r?"f":"i"]=!!n||t,""}),o}var v=t.src.match(/checkLoaded/)?1:0,y={},g=[],j={aliases:h,loadjs:function(n,r){function t(e){for(var n=0,r=g.length;n<r;n++)g[n](e)}var e,o,a,c=m(n),i=c.m?"module":"text/javascript";return n=c.u,!0===y[n]?r&&r():y[n]!==l?r&&(y[n]=(e=y[n],o=r,function(){e&&e(),o&&o()})):(y[n]=(a=r,function(){y[n]=!0,a&&a()}),r=function(){y[n]()},u(d,{type:i,src:n,id:c.i,onerror:function(e){t(n);e=e.currentTarget;e.parentNode.removeChild(e),u(d,{type:i,src:c.f,id:c.i,onerror:function(){t(c.f)}},r)}},r)),j},loadcss:function(e,n){var r=m(e);return e=r.u,y[e]||u("link",{type:"text/css",rel:"stylesheet",href:e,id:r.i}),y[e]=!0,n&&n(),j},load:function(){var e=arguments,n=e[i];return 1===n&&a(e[0],Function)?e[0]():function(e,n,r){var t;if(h&&h[n])return t=h[n].slice(0),a(t)||(t=[t]),r&&t.push(r),e.load.apply(e,t);if(a(n)){for(var o=n[i];o--;)e.load(n[o]);return r&&n.push(r),e.load.apply(e,n)}n.match(/\.css\b/)?e.loadcss(n,r):e.loadjs(n,r)}(j,e[0],n<=1?l:function(){j.load.apply(j,[].slice.call(e,1))}),j},addAliases:function(e){for(var n in e)h[n]=a(e[n])?e[n].slice(0):e[n];return j},onError:function(e){return g.push(e),j}};if(v){for(var A,E,T=0,b=r[i];T<b;T++)(E=r[T].getAttribute("src"))&&(y[E.replace(/#.*$/,"")]=!0);for(T=0,b=(A=c[n]("link"))[i];T<b;T++)"stylesheet"!==A[T].rel&&"text/css"!==A[T].type||(y[A[T].getAttribute("href").replace(/#.*$/,"")]=!0)}e.ljs=j}t.src&&o&&u(d,{innerHTML:o})}(window);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@malko/l.js",
+  "version": "0.2.2",
+  "description": "another simple/tiny javascript/css loader",
+  "files": [
+    "l.min.js"
+  ],
+  "main": "l.min.js",
+  "keywords": [
+    "loader",
+    "script",
+    "css",
+    "js",
+    "load",
+    "async",
+    "dynamic import",
+    "import",
+    "require"
+  ],
+  "author": "Jonathan Gotti <jgotti at jgotti dot org>",
+  "license": "MIT",
+  "devDependencies": {
+    "uglify-js": "^3.17.4"
+  },
+  "scripts": {
+    "build": "echo \"//https://github.com/malko/l.js v$npm_package_version MIT license ©Jonathan Gotti\" > l.min.js && uglifyjs l.js -m -c >> l.min.js && cat l.min.js | gzip > l.min.js.gz && ls -lh"
+  }
+}