@amekusa/util.js 2.0.0 → 2.1.0

package/dist/amekusa.util.br.es.js

@@ -160,7 +160,43 @@ function merge(x, y, opts = {}) {
 		return x.concat(y);
 	}
 	return y;
-}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge});/*!
+}
+
+/**
+ * Gets a property from the given object by the given string path.
+ * @param {object} obj - Object to traverse
+ * @param {string} path - Property names separated with '.'
+ * @return {any} value of the found property, or undefined if it's not found
+ */
+function dig(obj, path) {
+	path = path.split('.');
+	for (let i = 0; i < path.length; i++) {
+		let p = path[i];
+		if (typeof obj == 'object' && p in obj) obj = obj[p];
+		else return undefined;
+	}
+	return obj;
+}
+
+/**
+ * Substitutes the properties of the given data for the references in the given string.
+ * @param {string} str - String that contains references to the properties
+ * @param {object} data - Object that contains properties to replace the references
+ * @param {object} [opts] - Options
+ * @return {string} a modified `str`
+ */
+function subst(str, data, opts = {}) {
+	let {
+		modifier = null,
+		start = '{{',
+		end   = '}}',
+	} = opts;
+	let ref = new RegExp(start + '\\s*([-.\\w]+)\\s*' + end, 'g');
+	return str.replaceAll(ref, modifier
+		? (_, m1) => (modifier(dig(data, m1), m1, data) || '')
+		: (_, m1) => (dig(data, m1) || '')
+	);
+}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean,dig:dig,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge,subst:subst});/*!
  * === @amekusa/util.js/web === *
  * MIT License
  *
@@ -379,4 +415,4 @@ function hms(d, format = null) {
  */
 function iso9075(d) {
 	return ymd(d, '-') + ' ' + hms(d, ':');
-}var time=/*#__PURE__*/Object.freeze({__proto__:null,addTime:addTime,ceil:ceil,date:date,floor:floor,hms:hms,iso9075:iso9075,localize:localize,ms:ms,quantize:quantize,round:round,ymd:ymd});export{arr,clean,gen,is,isEmpty,isEmptyOrFalsey,isEmptyOrFalsy,merge,time,web};
+}var time=/*#__PURE__*/Object.freeze({__proto__:null,addTime:addTime,ceil:ceil,date:date,floor:floor,hms:hms,iso9075:iso9075,localize:localize,ms:ms,quantize:quantize,round:round,ymd:ymd});export{arr,clean,dig,gen,is,isEmpty,isEmptyOrFalsey,isEmptyOrFalsy,merge,subst,time,web};

package/dist/amekusa.util.br.es.min.js

@@ -22,7 +22,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-function e(e){return Array.isArray(e)?e:[e]}function t(e,...t){let r=typeof e;for(let n=0;n<t.length;n++){let i=t[n];if("string"==typeof i){if("array"==i){if(Array.isArray(e))return!0}else if(r==i)return!0}else if(e instanceof i)return!0}return!1}function r(e){if(Array.isArray(e))return 0==e.length;switch(typeof e){case"string":return!e;case"object":for(let t in e)return!1;return!0;case"undefined":return!0}return!1}function n(e){if(!e)return!0;if(Array.isArray(e))return 0==e.length;if("object"==typeof e)for(let t in e)return!1;return!1}const i=n;function u(e,t=8){if(t){if(Array.isArray(e)){let n=[];for(let i=0;i<e.length;i++){let o=u(e[i],t-1);r(o)||n.push(o)}return n}if("object"==typeof e){let n={};for(let i in e){let o=u(e[i],t-1);r(o)||(n[i]=o)}return n}}return e}function o(e,t,r={}){switch("recurse"in r||(r.recurse=8),Array.isArray(e)+Array.isArray(t)){case 0:if(r.recurse&&e&&t&&"object"==typeof e&&"object"==typeof t){r.recurse--;for(let n in t)e[n]=o(e[n],t[n],r);return r.recurse++,e}case 1:return t}switch(r.mergeArrays){case!0:for(let r=0;r<t.length;r++)e.includes(t[r])||e.push(t[r]);return e;case"push":return e.push(...t),e;case"concat":return e.concat(t)}return t}var a=Object.freeze({__proto__:null,arr:e,clean:u,is:t,isEmpty:r,isEmptyOrFalsey:i,isEmptyOrFalsy:n,merge:o});
+function e(e){return Array.isArray(e)?e:[e]}function t(e,...t){let r=typeof e;for(let n=0;n<t.length;n++){let i=t[n];if("string"==typeof i){if("array"==i){if(Array.isArray(e))return!0}else if(r==i)return!0}else if(e instanceof i)return!0}return!1}function r(e){if(Array.isArray(e))return 0==e.length;switch(typeof e){case"string":return!e;case"object":for(let t in e)return!1;return!0;case"undefined":return!0}return!1}function n(e){if(!e)return!0;if(Array.isArray(e))return 0==e.length;if("object"==typeof e)for(let t in e)return!1;return!1}const i=n;function u(e,t=8){if(t){if(Array.isArray(e)){let n=[];for(let i=0;i<e.length;i++){let o=u(e[i],t-1);r(o)||n.push(o)}return n}if("object"==typeof e){let n={};for(let i in e){let o=u(e[i],t-1);r(o)||(n[i]=o)}return n}}return e}function o(e,t,r={}){switch("recurse"in r||(r.recurse=8),Array.isArray(e)+Array.isArray(t)){case 0:if(r.recurse&&e&&t&&"object"==typeof e&&"object"==typeof t){r.recurse--;for(let n in t)e[n]=o(e[n],t[n],r);return r.recurse++,e}case 1:return t}switch(r.mergeArrays){case!0:for(let r=0;r<t.length;r++)e.includes(t[r])||e.push(t[r]);return e;case"push":return e.push(...t),e;case"concat":return e.concat(t)}return t}function a(e,t){t=t.split(".");for(let r=0;r<t.length;r++){let n=t[r];if("object"!=typeof e||!(n in e))return;e=e[n]}return e}function c(e,t,r={}){let{modifier:n=null,start:i="{{",end:u="}}"}=r,o=new RegExp(i+"\\s*([-.\\w]+)\\s*"+u,"g");return e.replaceAll(o,n?(e,r)=>n(a(t,r),r,t)||"":(e,r)=>a(t,r)||"")}var s=Object.freeze({__proto__:null,arr:e,clean:u,dig:a,is:t,isEmpty:r,isEmptyOrFalsey:i,isEmptyOrFalsy:n,merge:o,subst:c});
 /*!
  * === @amekusa/util.js/web === *
  * MIT License
@@ -46,7 +46,7 @@ function e(e){return Array.isArray(e)?e:[e]}function t(e,...t){let r=typeof e;fo
  * 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.
- */function c(e){return`${e}`.replace(l,g)}const s=c,f={"&":"amp",'"':"quot","'":"apos","<":"lt",">":"gt"},l=new RegExp(`["'<>]|(&(?!${Object.values(f).join("|")};))`,"g"),g=e=>`&${f[e]};`;var y=Object.freeze({__proto__:null,escHTML:c,escHtml:s});
+ */function f(e){return`${e}`.replace(p,y)}const l=f,g={"&":"amp",'"':"quot","'":"apos","<":"lt",">":"gt"},p=new RegExp(`["'<>]|(&(?!${Object.values(g).join("|")};))`,"g"),y=e=>`&${g[e]};`;var d=Object.freeze({__proto__:null,escHTML:f,escHtml:l});
 /*!
  * === @amekusa/util.js/time === *
  * MIT License
@@ -70,4 +70,4 @@ function e(e){return Array.isArray(e)?e:[e]}function t(e,...t){let r=typeof e;fo
  * 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.
- */function p(e,t,r="round"){return e.setTime(Math[r](e.getTime()/t)*t),e}function h(e,t=null){let r=[e.getFullYear().toString(),(e.getMonth()+1).toString().padStart(2,"0"),e.getDate().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.Y=r[0],t.M=r[1],t.D=r[2],t):r;default:if(!t)return r;throw"invalid type"}}function m(e,t=null){let r=[e.getHours().toString().padStart(2,"0"),e.getMinutes().toString().padStart(2,"0"),e.getSeconds().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.h=r[0],t.m=r[1],t.s=r[2],t):r;default:if(!t)return r;throw"invalid type"}}var d=Object.freeze({__proto__:null,addTime:function(e,t){return e.setTime(e.getTime()+t),e},ceil:function(e,t){return p(e,t,"ceil")},date:function(...e){return e.length&&e[0]?e[0]instanceof Date?e[0]:new Date(...e):new Date},floor:function(e,t){return p(e,t,"floor")},hms:m,iso9075:function(e){return h(e,"-")+" "+m(e,":")},localize:function(e){return e.setTime(e.getTime()-6e4*e.getTimezoneOffset()),e},ms:function(...e){if(!e.length||!e[0])return Date.now();let t=e[0];return"number"==typeof t?t:t instanceof Date?t.getTime():new Date(...e).getTime()},quantize:p,round:function(e,t){return p(e,t,"round")},ymd:h});export{e as arr,u as clean,a as gen,t as is,r as isEmpty,i as isEmptyOrFalsey,n as isEmptyOrFalsy,o as merge,d as time,y as web};
+ */function h(e,t,r="round"){return e.setTime(Math[r](e.getTime()/t)*t),e}function m(e,t=null){let r=[e.getFullYear().toString(),(e.getMonth()+1).toString().padStart(2,"0"),e.getDate().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.Y=r[0],t.M=r[1],t.D=r[2],t):r;default:if(!t)return r;throw"invalid type"}}function A(e,t=null){let r=[e.getHours().toString().padStart(2,"0"),e.getMinutes().toString().padStart(2,"0"),e.getSeconds().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.h=r[0],t.m=r[1],t.s=r[2],t):r;default:if(!t)return r;throw"invalid type"}}var j=Object.freeze({__proto__:null,addTime:function(e,t){return e.setTime(e.getTime()+t),e},ceil:function(e,t){return h(e,t,"ceil")},date:function(...e){return e.length&&e[0]?e[0]instanceof Date?e[0]:new Date(...e):new Date},floor:function(e,t){return h(e,t,"floor")},hms:A,iso9075:function(e){return m(e,"-")+" "+A(e,":")},localize:function(e){return e.setTime(e.getTime()-6e4*e.getTimezoneOffset()),e},ms:function(...e){if(!e.length||!e[0])return Date.now();let t=e[0];return"number"==typeof t?t:t instanceof Date?t.getTime():new Date(...e).getTime()},quantize:h,round:function(e,t){return h(e,t,"round")},ymd:m});export{e as arr,u as clean,a as dig,s as gen,t as is,r as isEmpty,i as isEmptyOrFalsey,n as isEmptyOrFalsy,o as merge,c as subst,j as time,d as web};

package/dist/amekusa.util.br.js

@@ -160,7 +160,43 @@ function merge(x, y, opts = {}) {
 		return x.concat(y);
 	}
 	return y;
-}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge});/*!
+}
+
+/**
+ * Gets a property from the given object by the given string path.
+ * @param {object} obj - Object to traverse
+ * @param {string} path - Property names separated with '.'
+ * @return {any} value of the found property, or undefined if it's not found
+ */
+function dig(obj, path) {
+	path = path.split('.');
+	for (let i = 0; i < path.length; i++) {
+		let p = path[i];
+		if (typeof obj == 'object' && p in obj) obj = obj[p];
+		else return undefined;
+	}
+	return obj;
+}
+
+/**
+ * Substitutes the properties of the given data for the references in the given string.
+ * @param {string} str - String that contains references to the properties
+ * @param {object} data - Object that contains properties to replace the references
+ * @param {object} [opts] - Options
+ * @return {string} a modified `str`
+ */
+function subst(str, data, opts = {}) {
+	let {
+		modifier = null,
+		start = '{{',
+		end   = '}}',
+	} = opts;
+	let ref = new RegExp(start + '\\s*([-.\\w]+)\\s*' + end, 'g');
+	return str.replaceAll(ref, modifier
+		? (_, m1) => (modifier(dig(data, m1), m1, data) || '')
+		: (_, m1) => (dig(data, m1) || '')
+	);
+}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean,dig:dig,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge,subst:subst});/*!
  * === @amekusa/util.js/web === *
  * MIT License
  *
@@ -379,4 +415,4 @@ function hms(d, format = null) {
  */
 function iso9075(d) {
 	return ymd(d, '-') + ' ' + hms(d, ':');
-}var time=/*#__PURE__*/Object.freeze({__proto__:null,addTime:addTime,ceil:ceil,date:date,floor:floor,hms:hms,iso9075:iso9075,localize:localize,ms:ms,quantize:quantize,round:round,ymd:ymd});exports.arr=arr;exports.clean=clean;exports.gen=gen;exports.is=is;exports.isEmpty=isEmpty;exports.isEmptyOrFalsey=isEmptyOrFalsey;exports.isEmptyOrFalsy=isEmptyOrFalsy;exports.merge=merge;exports.time=time;exports.web=web;return exports;})({});
+}var time=/*#__PURE__*/Object.freeze({__proto__:null,addTime:addTime,ceil:ceil,date:date,floor:floor,hms:hms,iso9075:iso9075,localize:localize,ms:ms,quantize:quantize,round:round,ymd:ymd});exports.arr=arr;exports.clean=clean;exports.dig=dig;exports.gen=gen;exports.is=is;exports.isEmpty=isEmpty;exports.isEmptyOrFalsey=isEmptyOrFalsey;exports.isEmptyOrFalsy=isEmptyOrFalsy;exports.merge=merge;exports.subst=subst;exports.time=time;exports.web=web;return exports;})({});

package/dist/amekusa.util.br.min.js

@@ -22,7 +22,7 @@ this.amekusa=this.amekusa||{},this.amekusa.util=function(e){"use strict";
  * 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.
- */function t(e){return Array.isArray(e)?e:[e]}function r(e,...t){let r=typeof e;for(let n=0;n<t.length;n++){let i=t[n];if("string"==typeof i){if("array"==i){if(Array.isArray(e))return!0}else if(r==i)return!0}else if(e instanceof i)return!0}return!1}function n(e){if(Array.isArray(e))return 0==e.length;switch(typeof e){case"string":return!e;case"object":for(let t in e)return!1;return!0;case"undefined":return!0}return!1}function i(e){if(!e)return!0;if(Array.isArray(e))return 0==e.length;if("object"==typeof e)for(let t in e)return!1;return!1}const u=i;function o(e,t=8){if(t){if(Array.isArray(e)){let r=[];for(let i=0;i<e.length;i++){let u=o(e[i],t-1);n(u)||r.push(u)}return r}if("object"==typeof e){let r={};for(let i in e){let u=o(e[i],t-1);n(u)||(r[i]=u)}return r}}return e}function a(e,t,r={}){switch("recurse"in r||(r.recurse=8),Array.isArray(e)+Array.isArray(t)){case 0:if(r.recurse&&e&&t&&"object"==typeof e&&"object"==typeof t){r.recurse--;for(let n in t)e[n]=a(e[n],t[n],r);return r.recurse++,e}case 1:return t}switch(r.mergeArrays){case!0:for(let r=0;r<t.length;r++)e.includes(t[r])||e.push(t[r]);return e;case"push":return e.push(...t),e;case"concat":return e.concat(t)}return t}var s=Object.freeze({__proto__:null,arr:t,clean:o,is:r,isEmpty:n,isEmptyOrFalsey:u,isEmptyOrFalsy:i,merge:a});
+ */function t(e){return Array.isArray(e)?e:[e]}function r(e,...t){let r=typeof e;for(let n=0;n<t.length;n++){let i=t[n];if("string"==typeof i){if("array"==i){if(Array.isArray(e))return!0}else if(r==i)return!0}else if(e instanceof i)return!0}return!1}function n(e){if(Array.isArray(e))return 0==e.length;switch(typeof e){case"string":return!e;case"object":for(let t in e)return!1;return!0;case"undefined":return!0}return!1}function i(e){if(!e)return!0;if(Array.isArray(e))return 0==e.length;if("object"==typeof e)for(let t in e)return!1;return!1}const u=i;function o(e,t=8){if(t){if(Array.isArray(e)){let r=[];for(let i=0;i<e.length;i++){let u=o(e[i],t-1);n(u)||r.push(u)}return r}if("object"==typeof e){let r={};for(let i in e){let u=o(e[i],t-1);n(u)||(r[i]=u)}return r}}return e}function s(e,t,r={}){switch("recurse"in r||(r.recurse=8),Array.isArray(e)+Array.isArray(t)){case 0:if(r.recurse&&e&&t&&"object"==typeof e&&"object"==typeof t){r.recurse--;for(let n in t)e[n]=s(e[n],t[n],r);return r.recurse++,e}case 1:return t}switch(r.mergeArrays){case!0:for(let r=0;r<t.length;r++)e.includes(t[r])||e.push(t[r]);return e;case"push":return e.push(...t),e;case"concat":return e.concat(t)}return t}function a(e,t){t=t.split(".");for(let r=0;r<t.length;r++){let n=t[r];if("object"!=typeof e||!(n in e))return;e=e[n]}return e}function c(e,t,r={}){let{modifier:n=null,start:i="{{",end:u="}}"}=r,o=new RegExp(i+"\\s*([-.\\w]+)\\s*"+u,"g");return e.replaceAll(o,n?(e,r)=>n(a(t,r),r,t)||"":(e,r)=>a(t,r)||"")}var f=Object.freeze({__proto__:null,arr:t,clean:o,dig:a,is:r,isEmpty:n,isEmptyOrFalsey:u,isEmptyOrFalsy:i,merge:s,subst:c});
 /*!
  * === @amekusa/util.js/web === *
  * MIT License
@@ -46,7 +46,7 @@ this.amekusa=this.amekusa||{},this.amekusa.util=function(e){"use strict";
  * 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.
- */function c(e){return`${e}`.replace(y,g)}const f=c,l={"&":"amp",'"':"quot","'":"apos","<":"lt",">":"gt"},y=new RegExp(`["'<>]|(&(?!${Object.values(l).join("|")};))`,"g"),g=e=>`&${l[e]};`;var p=Object.freeze({__proto__:null,escHTML:c,escHtml:f});
+ */function l(e){return`${e}`.replace(p,m)}const g=l,y={"&":"amp",'"':"quot","'":"apos","<":"lt",">":"gt"},p=new RegExp(`["'<>]|(&(?!${Object.values(y).join("|")};))`,"g"),m=e=>`&${y[e]};`;var h=Object.freeze({__proto__:null,escHTML:l,escHtml:g});
 /*!
  * === @amekusa/util.js/time === *
  * MIT License
@@ -70,4 +70,4 @@ this.amekusa=this.amekusa||{},this.amekusa.util=function(e){"use strict";
  * 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.
- */function m(e,t,r="round"){return e.setTime(Math[r](e.getTime()/t)*t),e}function h(e,t=null){let r=[e.getFullYear().toString(),(e.getMonth()+1).toString().padStart(2,"0"),e.getDate().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.Y=r[0],t.M=r[1],t.D=r[2],t):r;default:if(!t)return r;throw"invalid type"}}function d(e,t=null){let r=[e.getHours().toString().padStart(2,"0"),e.getMinutes().toString().padStart(2,"0"),e.getSeconds().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.h=r[0],t.m=r[1],t.s=r[2],t):r;default:if(!t)return r;throw"invalid type"}}var A=Object.freeze({__proto__:null,addTime:function(e,t){return e.setTime(e.getTime()+t),e},ceil:function(e,t){return m(e,t,"ceil")},date:function(...e){return e.length&&e[0]?e[0]instanceof Date?e[0]:new Date(...e):new Date},floor:function(e,t){return m(e,t,"floor")},hms:d,iso9075:function(e){return h(e,"-")+" "+d(e,":")},localize:function(e){return e.setTime(e.getTime()-6e4*e.getTimezoneOffset()),e},ms:function(...e){if(!e.length||!e[0])return Date.now();let t=e[0];return"number"==typeof t?t:t instanceof Date?t.getTime():new Date(...e).getTime()},quantize:m,round:function(e,t){return m(e,t,"round")},ymd:h});return e.arr=t,e.clean=o,e.gen=s,e.is=r,e.isEmpty=n,e.isEmptyOrFalsey=u,e.isEmptyOrFalsy=i,e.merge=a,e.time=A,e.web=p,e}({});
+ */function d(e,t,r="round"){return e.setTime(Math[r](e.getTime()/t)*t),e}function b(e,t=null){let r=[e.getFullYear().toString(),(e.getMonth()+1).toString().padStart(2,"0"),e.getDate().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.Y=r[0],t.M=r[1],t.D=r[2],t):r;default:if(!t)return r;throw"invalid type"}}function A(e,t=null){let r=[e.getHours().toString().padStart(2,"0"),e.getMinutes().toString().padStart(2,"0"),e.getSeconds().toString().padStart(2,"0")];switch(typeof t){case"string":return r.join(t);case"object":return t?(t.h=r[0],t.m=r[1],t.s=r[2],t):r;default:if(!t)return r;throw"invalid type"}}var j=Object.freeze({__proto__:null,addTime:function(e,t){return e.setTime(e.getTime()+t),e},ceil:function(e,t){return d(e,t,"ceil")},date:function(...e){return e.length&&e[0]?e[0]instanceof Date?e[0]:new Date(...e):new Date},floor:function(e,t){return d(e,t,"floor")},hms:A,iso9075:function(e){return b(e,"-")+" "+A(e,":")},localize:function(e){return e.setTime(e.getTime()-6e4*e.getTimezoneOffset()),e},ms:function(...e){if(!e.length||!e[0])return Date.now();let t=e[0];return"number"==typeof t?t:t instanceof Date?t.getTime():new Date(...e).getTime()},quantize:d,round:function(e,t){return d(e,t,"round")},ymd:b});return e.arr=t,e.clean=o,e.dig=a,e.gen=f,e.is=r,e.isEmpty=n,e.isEmptyOrFalsey=u,e.isEmptyOrFalsy=i,e.merge=s,e.subst=c,e.time=j,e.web=h,e}({});

package/dist/amekusa.util.cjs

@@ -160,7 +160,43 @@ function merge$1(x, y, opts = {}) {
 		return x.concat(y);
 	}
 	return y;
-}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean$1,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge$1});/*!
+}
+
+/**
+ * Gets a property from the given object by the given string path.
+ * @param {object} obj - Object to traverse
+ * @param {string} path - Property names separated with '.'
+ * @return {any} value of the found property, or undefined if it's not found
+ */
+function dig(obj, path) {
+	path = path.split('.');
+	for (let i = 0; i < path.length; i++) {
+		let p = path[i];
+		if (typeof obj == 'object' && p in obj) obj = obj[p];
+		else return undefined;
+	}
+	return obj;
+}
+
+/**
+ * Substitutes the properties of the given data for the references in the given string.
+ * @param {string} str - String that contains references to the properties
+ * @param {object} data - Object that contains properties to replace the references
+ * @param {object} [opts] - Options
+ * @return {string} a modified `str`
+ */
+function subst(str, data, opts = {}) {
+	let {
+		modifier = null,
+		start = '{{',
+		end   = '}}',
+	} = opts;
+	let ref = new RegExp(start + '\\s*([-.\\w]+)\\s*' + end, 'g');
+	return str.replaceAll(ref, modifier
+		? (_, m1) => (modifier(dig(data, m1), m1, data) || '')
+		: (_, m1) => (dig(data, m1) || '')
+	);
+}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean$1,dig:dig,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge$1,subst:subst});/*!
  * === @amekusa/util.js/web === *
  * MIT License
  *
@@ -478,7 +514,7 @@ function dev(set = undefined) {
 	if (set != undefined) node_process.env.NODE_ENV = set ? value : '';
 	return node_process.env.NODE_ENV == value;
 }var sh=/*#__PURE__*/Object.freeze({__proto__:null,args:args,dev:dev,exec:exec,prod:prod});/*!
- * === @amekusa/util.js/io === *
+ * === @amekusa/util.js/io/AssetImporter === *
  * MIT License
  *
  * Copyright (c) 2024 Satoshi Soma
@@ -503,6 +539,188 @@ function dev(set = undefined) {
  */
 
 /**
+ * This is for copying styles or scripts to a certain HTML directory.
+ * @author Satoshi Soma (github.com/amekusa)
+ */
+class AssetImporter {
+	/**
+	 * @param {object} config
+	 * @param {boolean} [config.minify=false] - Prefer `*.min.*` version
+	 * @param {string} config.src - Source dir to search
+	 * @param {string} config.dst - Destination dir
+	 */
+	constructor(config) {
+		this.config = Object.assign({
+			minify: false,
+			src: '', // source dir to search
+			dst: '', // destination dir
+		}, config);
+		this.queue = [];
+		this.results = {
+			script: [],
+			style:  [],
+			asset:  [],
+		};
+	}
+	/**
+	 * Adds a new item to import.
+	 * @param {string|string[]|object|object[]} newImport
+	 */
+	add(newImport) {
+		if (!Array.isArray(newImport)) newImport = [newImport];
+		for (let i = 0; i < newImport.length; i++) {
+			let item = newImport[i];
+			switch (typeof item) {
+			case 'string':
+				item = {src: item};
+				break;
+			case 'object':
+				if (Array.isArray(item)) throw `invalid type: array`;
+				break;
+			default:
+				throw `invalid type: ${typeof item}`;
+			}
+			if (!('src' in item)) throw `'src' property is missing`;
+			this.queue.push(Object.assign({
+				order: 0,
+				resolve: 'local',
+				private: false,
+			}, item));
+		}
+	}
+	/**
+	 * Resolves the location of the given file path
+	 * @param {string} file - File path
+	 * @param {string} method - Resolution method
+	 * @return {string} Resolved file path
+	 */
+	resolve(file, method) {
+		let find = [];
+		if (this.config.minify) {
+			let _ext = ext(file);
+			find.push(ext(file, '.min' + _ext));
+		}
+		find.push(file);
+		for (let i = 0; i < find.length; i++) {
+			let r;
+			switch (method) {
+			case 'module':
+				try {
+					r = require.resolve(find[i]);
+				} catch (e) {
+					if (e.code == 'MODULE_NOT_FOUND') continue;
+					throw e;
+				}
+				return r;
+			case 'local':
+				r = path.join(this.config.src, find[i]);
+				if (fs.existsSync(r)) return r;
+				break;
+			case 'local:absolute':
+			case 'local:abs':
+				r = find[i];
+				if (fs.existsSync(r)) return r;
+				break;
+			default:
+				throw `invalid resolution method: ${method}`;
+			}
+		}
+		throw `cannot resolve '${file}'`;
+	}
+	/**
+	 * Imports all items in the queue at once.
+	 */
+	import() {
+		let typeMap = {
+			'.css': 'style',
+			'.js': 'script',
+		};
+		this.queue.sort((a, b) => (Number(a.order) - Number(b.order))); // sort by order
+		while (this.queue.length) {
+			let item = this.queue.shift();
+			let {type, src} = item;
+			let url;
+
+			if (!item.resolve) { // no resolution
+				url = src;
+				if (!type) type = typeMap[ext(src)] || 'asset';
+				console.log('---- File Link ----');
+				console.log(' type:', type);
+				console.log('  src:', src);
+
+			} else { // needs resolution
+				let {dst:dstDir, as:dstFile} = item;
+				let create = item.resolve == 'create'; // needs creation?
+				if (create) {
+					if (!dstFile) throw `'as' property is required with {resolve: 'create'}`;
+				} else {
+					src = this.resolve(src, item.resolve);
+					if (!dstFile) dstFile = path.basename(src);
+				}
+				if (!type) type = typeMap[ext(dstFile)] || 'asset';
+				if (!dstDir) dstDir = type + 's';
+
+				// absolute destination
+				url = path.join(dstDir, dstFile);
+				let dst = path.join(this.config.dst, url);
+				dstDir = path.dirname(dst);
+				if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, {recursive:true});
+				if (create) {
+					fs.writeFileSync(dst, src);
+					console.log('---- File Creation ----');
+					console.log(' type:', type);
+					console.log('  dst:', dst);
+				} else {
+					fs.copyFileSync(src, dst);
+					console.log('---- File Import ----');
+					console.log(' type:', type);
+					console.log('  src:', src);
+					console.log('  dst:', dst);
+				}
+			}
+
+			if (!item.private) {
+				if (!(type in this.results)) this.results[type] = [];
+				this.results[type].push({type, url});
+			}
+		}
+	}
+	/**
+	 * Outputs HTML tags for imported items.
+	 * @param {string} [type] - Type
+	 * @return {string} HTML
+	 */
+	toHTML(type = null) {
+		let r;
+		if (type) {
+			let tmpl = templates[type];
+			if (!tmpl) return '';
+			let items = this.results[type];
+			r = new Array(items.length);
+			for (let i = 0; i < items.length; i++) {
+				r[i] = tmpl.replaceAll('%s', items[i].url || '');
+			}
+		} else {
+			let keys = Object.keys(this.results);
+			r = new Array(keys.length);
+			for (let i = 0; i < keys.length; i++) {
+				r[i] = this.toHTML(keys[i]);
+			}
+		}
+		return r.join('\n');
+	}
+}
+
+const templates = {
+	'script':
+		`<script src="%s"></script>`,
+
+	'script:module':
+		`<script type="module" src="%s"></script>`,
+
+	'style':
+		`<link rel="stylesheet" href="%s">`,
+};/**
  * Alias of `os.homedir()`.
  * @type {string}
  */
@@ -649,7 +867,7 @@ function modifyStream(fn) {
 			}
 		}
 	});
-}var io=/*#__PURE__*/Object.freeze({__proto__:null,clean:clean,copy:copy,ext:ext,find:find,home:home,modifyStream:modifyStream,untilde:untilde});const merge = Object.assign;
+}var io=/*#__PURE__*/Object.freeze({__proto__:null,AssetImporter:AssetImporter,clean:clean,copy:copy,ext:ext,find:find,home:home,modifyStream:modifyStream,untilde:untilde});const merge = Object.assign;
 
 /*!
  * === @amekusa/util.js/test === *
@@ -800,7 +1018,8 @@ function testMethod(construct, method, cases, opts = {}) {
 			// ---- instantiate ----
 			let obj;
 			if (opts.static) {
-				if ('initArgs' in c) invalid(`'initArgs' is not for static method`);
+				if ('initArgs' in c) invalid(`'initArgs' is not available for a static method`);
+				if ('prepare' in c) invalid(`'prepare' is not available for a static method`);
 				obj = construct;
 			} else {
 				let initArgs = [];
@@ -814,6 +1033,11 @@ function testMethod(construct, method, cases, opts = {}) {
 				} catch (e) {
 					obj = construct(...initArgs);
 				}
+				if ('prepare' in c) {
+					if (typeof c.prepare != 'function') invalid(`'prepare' must be a function`);
+					c.prepare(obj);
+					delete c.prepare;
+				}
 			}
 
 			// ---- call method ----
@@ -923,4 +1147,4 @@ function testInstance(construct, cases, opts = {}) {
 			}
 		}
 	});
-}var test=/*#__PURE__*/Object.freeze({__proto__:null,InvalidTest:InvalidTest,assertEqual:assertEqual,assertProps:assertProps,assertType:assertType,testFn:testFn,testInstance:testInstance,testMethod:testMethod});exports.arr=arr;exports.clean=clean$1;exports.gen=gen;exports.io=io;exports.is=is;exports.isEmpty=isEmpty;exports.isEmptyOrFalsey=isEmptyOrFalsey;exports.isEmptyOrFalsy=isEmptyOrFalsy;exports.merge=merge$1;exports.sh=sh;exports.test=test;exports.time=time;exports.web=web;
+}var test=/*#__PURE__*/Object.freeze({__proto__:null,InvalidTest:InvalidTest,assertEqual:assertEqual,assertProps:assertProps,assertType:assertType,testFn:testFn,testInstance:testInstance,testMethod:testMethod});exports.arr=arr;exports.clean=clean$1;exports.dig=dig;exports.gen=gen;exports.io=io;exports.is=is;exports.isEmpty=isEmpty;exports.isEmptyOrFalsey=isEmptyOrFalsey;exports.isEmptyOrFalsy=isEmptyOrFalsy;exports.merge=merge$1;exports.sh=sh;exports.subst=subst;exports.test=test;exports.time=time;exports.web=web;

package/dist/amekusa.util.js

@@ -1,4 +1,4 @@
-import os from'node:os';import fs from'node:fs';import*as fsp from'node:fs/promises';import path from'node:path';import {Transform}from'node:stream';import {env}from'node:process';import {exec as exec$1}from'node:child_process';import assert from'node:assert';/*!
+import os from'node:os';import fs from'node:fs';import*as fsp from'node:fs/promises';import path,{join,basename,dirname}from'node:path';import {Transform}from'node:stream';import {env}from'node:process';import {exec as exec$1}from'node:child_process';import assert from'node:assert';/*!
  * === @amekusa/util.js/gen === *
  * MIT License
  *
@@ -160,7 +160,43 @@ function merge$1(x, y, opts = {}) {
 		return x.concat(y);
 	}
 	return y;
-}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean$1,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge$1});/*!
+}
+
+/**
+ * Gets a property from the given object by the given string path.
+ * @param {object} obj - Object to traverse
+ * @param {string} path - Property names separated with '.'
+ * @return {any} value of the found property, or undefined if it's not found
+ */
+function dig(obj, path) {
+	path = path.split('.');
+	for (let i = 0; i < path.length; i++) {
+		let p = path[i];
+		if (typeof obj == 'object' && p in obj) obj = obj[p];
+		else return undefined;
+	}
+	return obj;
+}
+
+/**
+ * Substitutes the properties of the given data for the references in the given string.
+ * @param {string} str - String that contains references to the properties
+ * @param {object} data - Object that contains properties to replace the references
+ * @param {object} [opts] - Options
+ * @return {string} a modified `str`
+ */
+function subst(str, data, opts = {}) {
+	let {
+		modifier = null,
+		start = '{{',
+		end   = '}}',
+	} = opts;
+	let ref = new RegExp(start + '\\s*([-.\\w]+)\\s*' + end, 'g');
+	return str.replaceAll(ref, modifier
+		? (_, m1) => (modifier(dig(data, m1), m1, data) || '')
+		: (_, m1) => (dig(data, m1) || '')
+	);
+}var gen=/*#__PURE__*/Object.freeze({__proto__:null,arr:arr,clean:clean$1,dig:dig,is:is,isEmpty:isEmpty,isEmptyOrFalsey:isEmptyOrFalsey,isEmptyOrFalsy:isEmptyOrFalsy,merge:merge$1,subst:subst});/*!
  * === @amekusa/util.js/web === *
  * MIT License
  *
@@ -478,7 +514,7 @@ function dev(set = undefined) {
 	if (set != undefined) env.NODE_ENV = set ? value : '';
 	return env.NODE_ENV == value;
 }var sh=/*#__PURE__*/Object.freeze({__proto__:null,args:args,dev:dev,exec:exec,prod:prod});/*!
- * === @amekusa/util.js/io === *
+ * === @amekusa/util.js/io/AssetImporter === *
  * MIT License
  *
  * Copyright (c) 2024 Satoshi Soma
@@ -503,6 +539,188 @@ function dev(set = undefined) {
  */
 
 /**
+ * This is for copying styles or scripts to a certain HTML directory.
+ * @author Satoshi Soma (github.com/amekusa)
+ */
+class AssetImporter {
+	/**
+	 * @param {object} config
+	 * @param {boolean} [config.minify=false] - Prefer `*.min.*` version
+	 * @param {string} config.src - Source dir to search
+	 * @param {string} config.dst - Destination dir
+	 */
+	constructor(config) {
+		this.config = Object.assign({
+			minify: false,
+			src: '', // source dir to search
+			dst: '', // destination dir
+		}, config);
+		this.queue = [];
+		this.results = {
+			script: [],
+			style:  [],
+			asset:  [],
+		};
+	}
+	/**
+	 * Adds a new item to import.
+	 * @param {string|string[]|object|object[]} newImport
+	 */
+	add(newImport) {
+		if (!Array.isArray(newImport)) newImport = [newImport];
+		for (let i = 0; i < newImport.length; i++) {
+			let item = newImport[i];
+			switch (typeof item) {
+			case 'string':
+				item = {src: item};
+				break;
+			case 'object':
+				if (Array.isArray(item)) throw `invalid type: array`;
+				break;
+			default:
+				throw `invalid type: ${typeof item}`;
+			}
+			if (!('src' in item)) throw `'src' property is missing`;
+			this.queue.push(Object.assign({
+				order: 0,
+				resolve: 'local',
+				private: false,
+			}, item));
+		}
+	}
+	/**
+	 * Resolves the location of the given file path
+	 * @param {string} file - File path
+	 * @param {string} method - Resolution method
+	 * @return {string} Resolved file path
+	 */
+	resolve(file, method) {
+		let find = [];
+		if (this.config.minify) {
+			let _ext = ext(file);
+			find.push(ext(file, '.min' + _ext));
+		}
+		find.push(file);
+		for (let i = 0; i < find.length; i++) {
+			let r;
+			switch (method) {
+			case 'module':
+				try {
+					r = require.resolve(find[i]);
+				} catch (e) {
+					if (e.code == 'MODULE_NOT_FOUND') continue;
+					throw e;
+				}
+				return r;
+			case 'local':
+				r = join(this.config.src, find[i]);
+				if (fs.existsSync(r)) return r;
+				break;
+			case 'local:absolute':
+			case 'local:abs':
+				r = find[i];
+				if (fs.existsSync(r)) return r;
+				break;
+			default:
+				throw `invalid resolution method: ${method}`;
+			}
+		}
+		throw `cannot resolve '${file}'`;
+	}
+	/**
+	 * Imports all items in the queue at once.
+	 */
+	import() {
+		let typeMap = {
+			'.css': 'style',
+			'.js': 'script',
+		};
+		this.queue.sort((a, b) => (Number(a.order) - Number(b.order))); // sort by order
+		while (this.queue.length) {
+			let item = this.queue.shift();
+			let {type, src} = item;
+			let url;
+
+			if (!item.resolve) { // no resolution
+				url = src;
+				if (!type) type = typeMap[ext(src)] || 'asset';
+				console.log('---- File Link ----');
+				console.log(' type:', type);
+				console.log('  src:', src);
+
+			} else { // needs resolution
+				let {dst:dstDir, as:dstFile} = item;
+				let create = item.resolve == 'create'; // needs creation?
+				if (create) {
+					if (!dstFile) throw `'as' property is required with {resolve: 'create'}`;
+				} else {
+					src = this.resolve(src, item.resolve);
+					if (!dstFile) dstFile = basename(src);
+				}
+				if (!type) type = typeMap[ext(dstFile)] || 'asset';
+				if (!dstDir) dstDir = type + 's';
+
+				// absolute destination
+				url = join(dstDir, dstFile);
+				let dst = join(this.config.dst, url);
+				dstDir = dirname(dst);
+				if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, {recursive:true});
+				if (create) {
+					fs.writeFileSync(dst, src);
+					console.log('---- File Creation ----');
+					console.log(' type:', type);
+					console.log('  dst:', dst);
+				} else {
+					fs.copyFileSync(src, dst);
+					console.log('---- File Import ----');
+					console.log(' type:', type);
+					console.log('  src:', src);
+					console.log('  dst:', dst);
+				}
+			}
+
+			if (!item.private) {
+				if (!(type in this.results)) this.results[type] = [];
+				this.results[type].push({type, url});
+			}
+		}
+	}
+	/**
+	 * Outputs HTML tags for imported items.
+	 * @param {string} [type] - Type
+	 * @return {string} HTML
+	 */
+	toHTML(type = null) {
+		let r;
+		if (type) {
+			let tmpl = templates[type];
+			if (!tmpl) return '';
+			let items = this.results[type];
+			r = new Array(items.length);
+			for (let i = 0; i < items.length; i++) {
+				r[i] = tmpl.replaceAll('%s', items[i].url || '');
+			}
+		} else {
+			let keys = Object.keys(this.results);
+			r = new Array(keys.length);
+			for (let i = 0; i < keys.length; i++) {
+				r[i] = this.toHTML(keys[i]);
+			}
+		}
+		return r.join('\n');
+	}
+}
+
+const templates = {
+	'script':
+		`<script src="%s"></script>`,
+
+	'script:module':
+		`<script type="module" src="%s"></script>`,
+
+	'style':
+		`<link rel="stylesheet" href="%s">`,
+};/**
  * Alias of `os.homedir()`.
  * @type {string}
  */
@@ -649,7 +867,7 @@ function modifyStream(fn) {
 			}
 		}
 	});
-}var io=/*#__PURE__*/Object.freeze({__proto__:null,clean:clean,copy:copy,ext:ext,find:find,home:home,modifyStream:modifyStream,untilde:untilde});const merge = Object.assign;
+}var io=/*#__PURE__*/Object.freeze({__proto__:null,AssetImporter:AssetImporter,clean:clean,copy:copy,ext:ext,find:find,home:home,modifyStream:modifyStream,untilde:untilde});const merge = Object.assign;
 
 /*!
  * === @amekusa/util.js/test === *
@@ -800,7 +1018,8 @@ function testMethod(construct, method, cases, opts = {}) {
 			// ---- instantiate ----
 			let obj;
 			if (opts.static) {
-				if ('initArgs' in c) invalid(`'initArgs' is not for static method`);
+				if ('initArgs' in c) invalid(`'initArgs' is not available for a static method`);
+				if ('prepare' in c) invalid(`'prepare' is not available for a static method`);
 				obj = construct;
 			} else {
 				let initArgs = [];
@@ -814,6 +1033,11 @@ function testMethod(construct, method, cases, opts = {}) {
 				} catch (e) {
 					obj = construct(...initArgs);
 				}
+				if ('prepare' in c) {
+					if (typeof c.prepare != 'function') invalid(`'prepare' must be a function`);
+					c.prepare(obj);
+					delete c.prepare;
+				}
 			}
 
 			// ---- call method ----
@@ -923,4 +1147,4 @@ function testInstance(construct, cases, opts = {}) {
 			}
 		}
 	});
-}var test=/*#__PURE__*/Object.freeze({__proto__:null,InvalidTest:InvalidTest,assertEqual:assertEqual,assertProps:assertProps,assertType:assertType,testFn:testFn,testInstance:testInstance,testMethod:testMethod});export{arr,clean$1 as clean,gen,io,is,isEmpty,isEmptyOrFalsey,isEmptyOrFalsy,merge$1 as merge,sh,test,time,web};
+}var test=/*#__PURE__*/Object.freeze({__proto__:null,InvalidTest:InvalidTest,assertEqual:assertEqual,assertProps:assertProps,assertType:assertType,testFn:testFn,testInstance:testInstance,testMethod:testMethod});export{arr,clean$1 as clean,dig,gen,io,is,isEmpty,isEmptyOrFalsey,isEmptyOrFalsy,merge$1 as merge,sh,subst,test,time,web};

package/package.json

@@ -5,7 +5,7 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "General purpose utility for JS",
   "type": "module",
   "files": [