@ntlab/ntjs-repo 3.0.0

package/JQuery/PostErrorHelper.js

@@ -0,0 +1,266 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2023-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { ScriptRepository, ScriptManager } = require('@ntlab/ntjs');
+const JQuery = ScriptManager.require('JQuery');
+
+/**
+ * JQuery/PostErrorHelper script repository.
+ */
+class PostErrorHelper extends JQuery {
+
+    initialize() {
+        this.name = 'PostErrorHelper';
+        this.position = ScriptRepository.POSITION_FIRST;
+        this.addDependencies(['JQuery', 'JQuery/ScrollTo']);
+    }
+
+    getScript() {
+        const err = 'Error';
+        return `
+$.errformat = {REPLACE: 0, INPLACE: 1, ASLIST: 2};
+$.errhelper = function(container, options) {
+    const helper = {
+        container: null,
+        errorContainer: null,
+        errorFormat: $.errformat.ASLIST,
+        requiredSelector: '.required',
+        errClass: null,
+        parentSelector: null,
+        parentClass: 'error',
+        listClass: 'error_list',
+        toggleClass: null,
+        inplace: null,
+        focused: null,
+        visibilityUseClass: false,
+        getError(err, fmt, sep) {
+            let error = '';
+            if (!Array.isArray(err)) {
+                err = [err];
+            }
+            err.forEach(e => {
+                if (error.length && sep) {
+                    error = error + sep;
+                }
+                e = Array.isArray(e) ? e.join(': ') : e;
+                if (fmt) {
+                    error = error + $.util.template(fmt, {error: e});
+                } else {
+                    error = error + e;
+                }
+            });
+            return error;
+        },
+        doShow(el, show = true) {
+            const self = this;
+            if (self.visibilityUseClass && self.toggleClass) {
+                if (show) {
+                    el.removeClass(self.toggleClass);
+                } else {
+                    el.addClass(self.toggleClass);
+                }
+            } else {
+                if (show) {
+                    el.show();
+                } else {
+                    el.hide();
+                }
+            }
+        },
+        showError(el) {
+            const self = this;
+            self.doShow(el, true);
+            if (self.toggleClass) {
+                el.removeClass(self.toggleClass);
+                el.parents().removeClass(self.toggleClass);
+            }
+        },
+        addErrorClass(el) {
+            const self = this;
+            if (self.errClass) {
+                if (el.is('input[type="hidden"]')) {
+                    el = el.siblings('input');
+                }
+                el.addClass(self.errClass);
+            }
+        },
+        addError(err, el, errtype) {
+            const self = this;
+            errtype = errtype ? errtype : $.errformat.REPLACE;
+            if (Array.isArray(el)) {
+                el.forEach(function(x) {
+                    self.showError(x);
+                });
+                el = el[el.length - 1];
+            }
+            let error;
+            switch (errtype) {
+                case $.errformat.REPLACE:
+                    error = self.getError(err, null, ', ');
+                    if (error.length) {
+                        el.html(error);
+                        self.addErrorClass(el);
+                        self.showError(el);
+                    }
+                    break;
+                case $.errformat.INPLACE:
+                    error = self.getError(err, null, ', ');
+                    if (typeof self.inplace === 'function') {
+                        let iel = self.inplace(el, error);
+                        self.addErrorClass(iel);
+                        self.showError(iel);
+                    }
+                    break;
+                case $.errformat.ASLIST:
+                    error = self.getError(err, '<li>%error%</li>');
+                    let ul = el.find('ul.' + self.listClass);
+                    if (ul.length) {
+                        ul.append(error);
+                    } else {
+                        $('<ul class="' + self.listClass + '">' + error + '</ul>').appendTo(el);
+                    }
+                    self.addErrorClass(el);
+                    self.showError(el);
+                    break;
+            }
+        },
+        handleError(err) {
+            let handled = false;
+            // reference self using variable
+            if (Array.isArray(err)) {
+                const el = $('#' + err[0]);
+                // check if error element is exist
+                if (el.length) {
+                    handled = true;
+                    helper.addError(err[1], helper.errorFormat === $.errformat.ASLIST ? el.parent() : el, helper.errorFormat);
+                    if (helper.parentClass) {
+                        if (helper.parentSelector) {
+                            el.parents(helper.parentSelector).addClass(helper.parentClass).show();
+                        } else {
+                            el.parent().addClass(helper.parentClass).show();
+                        }
+                    }
+                    if (helper.focused === null) {
+                        if (el.is('input[type="hidden"]')) {
+                            helper.focused = el.siblings('input');
+                        } else {
+                            helper.focused = el;
+                        }
+                    }
+                } else {
+                    err = err[0] + ': ' + err[1];
+                }
+            }
+            if (!handled) {
+                // error message shown in container
+                if (helper.errorContainer) {
+                    helper.addError(err, helper.errorContainer, helper.errorFormat);
+                } else {
+                    if ($.ntdlg) {
+                        $.ntdlg.message('dlgerr', '$err', err, $.ntdlg.ICON_ERROR);
+                    } else {
+                        alert(err);
+                    }
+                }
+            }
+        },
+        focusError() {
+            const self = this;
+            if (self.focused != null) {
+                $.scrollto(self.focused);
+                self.focused.focus();
+            }
+        },
+        resetError() {
+            const self = this;
+            self.focused = null;
+            if (self.container) {
+                if (self.listClass) {
+                    self.container.find('.' + self.listClass).remove();
+                }
+                if (self.errClass) {
+                    self.container.find('.' + self.errClass).removeClass(self.errClass);
+                }
+                if (self.parentClass) {
+                    if (self.parentSelector) {
+                        self.container.find(self.parentSelector).removeClass(self.parentClass);
+                    } else {
+                        self.container.find('.' + self.parentClass).removeClass(self.parentClass);
+                    }
+                }
+            }
+            if (self.errorContainer) {
+                if (Array.isArray(self.errorContainer)) {
+                    self.doShow(self.errorContainer[0], false);
+                } else {
+                    self.doShow(self.errorContainer, false);
+                }
+            }
+            if (typeof self.onErrReset === 'function') {
+                self.onErrReset(self);
+            }
+        }
+    }
+    helper.container = container;
+    options = options ? options : {};
+    $.util.applyProp(['errorContainer', 'errorFormat', 'requiredSelector', 'parentSelector', 'parentClass',
+        'errClass', 'listClass', 'toggleClass', 'visibilityUseClass', 'inplace', 'onErrReset'], options, helper);
+    if (typeof helper.errorContainer === 'string' && helper.container) {
+        let p = helper.container;
+        const containers = helper.errorContainer.split(' ');
+        const items = [];
+        while (true) {
+            if (containers.length === 0) {
+                break;
+            }
+            const selector = containers.shift();
+            const el = p.find(selector);
+            if (el.length) {
+                p = el;
+                items.push(el);
+            } else {
+                break;
+            }
+        }
+        if (items.length) {
+            if (items.length > 1) {
+                helper.errorContainer = items;
+            } else {
+                helper.errorContainer = items[0];
+            }
+        } else {
+            delete helper.errorContainer;
+        }
+    }
+    return helper;
+}
+`;
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+module.exports = PostErrorHelper;

package/JQuery/PostHandler.js

@@ -0,0 +1,78 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2023-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { ScriptRepository, ScriptManager } = require('@ntlab/ntjs');
+const JQuery = ScriptManager.require('JQuery');
+
+/**
+ * JQuery/PostHandler script repository.
+ */
+class PostHandler extends JQuery {
+
+    initialize() {
+        this.name = 'PostHandler';
+        this.position = ScriptRepository.POSITION_FIRST;
+        this.addDependencies(['JQuery', 'JQuery/PostErrorHelper']);
+    }
+
+    getScript() {
+        return `
+$.extend({
+    handlePostData(data, errhelper, success_cb, error_cb) {
+        $.postErr = null;
+        const json = typeof(data) === 'object' ? data : $.parseJSON(data);
+        if (json.success) {
+            if (typeof success_cb === 'function') {
+                success_cb(json);
+            }
+        } else {
+            if (json.error) {
+                if (!Array.isArray(json.error)) {
+                    json.error = [json.error];
+                }
+                json.error.forEach(err => {
+                    errhelper.handleError(err);
+                });
+            }
+            if (typeof error_cb === 'function') {
+                error_cb(json);
+            }
+        }
+    },
+    urlPost(url, callback, errhelper) {
+        errhelper = errhelper ? errhelper : $.errhelper();
+        $.post(url).done(function(data) {
+            $.handlePostData(data, errhelper, callback);
+        });
+    }
+});
+`;
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+module.exports = PostHandler;

package/JQuery/ScrollTo.js

@@ -0,0 +1,63 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2023-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { ScriptRepository, ScriptManager } = require('@ntlab/ntjs');
+const JQuery = ScriptManager.require('JQuery');
+
+/**
+ * JQuery/ScrollTo script repository.
+ */
+class ScrollTo extends JQuery {
+
+    initialize() {
+        this.name = 'ScrollTo';
+        this.position = ScriptRepository.POSITION_MIDDLE;
+        this.addDependencies(['JQuery']);
+    }
+
+    getScript() {
+        return `
+$.scrollto = function(el) {
+    if (typeof el === 'string') {
+        el = $(el);
+    }
+    if (el.length) {
+        const top = el.offset().top;
+        const w = $(window);
+        const t = w.scrollTop();
+        const h = w.height();
+        if (top < t || top > t + h) {
+            const ptop = parseInt($(document.body).css('padding-top'));
+            w.scrollTop(top - ptop);
+        }
+    }
+}`;
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+module.exports = ScrollTo;

package/JQuery/Util.js

@@ -0,0 +1,112 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2018-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { ScriptRepository, ScriptManager } = require('@ntlab/ntjs');
+const JQuery = ScriptManager.require('JQuery');
+
+/**
+ * JQuery/Util script repository.
+ */
+class Util extends JQuery {
+
+    initialize() {
+        this.name = 'Util';
+        this.position = ScriptRepository.POSITION_FIRST;
+        this.addDependencies(['JQuery', 'JQuery/Define']);
+    }
+    
+    getScript() {
+        return `
+$.define('util', {
+    template(tmpl, replaces) {
+        for (const n in replaces) {
+            const re = new RegExp('%' + n + '%', 'g');
+            tmpl = tmpl.replace(re, replaces[n]);
+        }
+        return tmpl;
+    },
+    copyProp(prop, src, dest, remove) {
+        if (src[prop] !== undefined) {
+            dest[prop] = src[prop];
+            if (remove) {
+                delete src[prop];
+            }
+        }
+    },
+    applyProp(props, src, dest, remove) {
+        const self = this;
+        if (src && dest) {
+            if (typeof props === 'object') {
+                if (Array.isArray(props)) {
+                    for (let i = 0; i < props.length; i++) {
+                        const prop = props[i];
+                        self.copyProp(prop, src, dest, remove);
+                    }
+                } else {
+                    for (const prop in props) {
+                        self.copyProp(prop, src, dest, remove);
+                    }
+                }
+            }
+        }
+    },
+    bindEvent(el, event, handlers) {
+        if (typeof handlers[event] === 'function') {
+            el.on(event, handlers[event]);
+        }
+    },
+    applyEvent(el, events, handlers) {
+        const self = this;
+        if (typeof events === 'object') {
+            if (Array.isArray(events)) {
+                for (let i = 0; i < events.length; i++) {
+                    const event = events[i];
+                    self.bindEvent(el, event, handlers);
+                }
+            } else {
+                for (event in events) {
+                    self.bindEvent(el, event, handlers);
+                }
+            }
+        }
+    },
+    dump(o, p) {
+        if (typeof o === 'object') {
+            for (const a in o) {
+                $.util.dump(o[a], (p !== undefined ? p + '.' : '') + a);
+            }
+        } else {
+            alert((p !== undefined ? p + ' = ' : '') + o);
+        }
+    }
+});
+`;
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+module.exports = Util;

package/JQuery/index.js

@@ -0,0 +1,71 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2018-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { Script, ScriptAsset } = require('@ntlab/ntjs');
+const debug = require('debug')('script:JQuery');
+
+/**
+ * JQuery script repository.
+ */
+class JQuery extends Script {
+
+    constructor() {
+        super('JQuery', 'jquery');
+    }
+
+    initialize() {
+        this.assetPath = this.repository;
+        this.addAsset(ScriptAsset.JAVASCRIPT, 'jquery.min');
+    }
+
+    initRepository(repository) {
+        if (JQuery.getOption('xhr')) {
+            debug('Init repository for XHR');
+            repository.wrapSize = 2;
+            repository.wrapper = `
+(function($) {
+    (function loader(f) {
+        if (document.ntloader && !document.ntloader.isScriptLoaded()) {
+            setTimeout(function() {
+                loader(f);
+            }, 100);
+        } else {
+            f($);
+        }
+    })(function($) {%s});
+})(jQuery);`;
+        } else {
+            debug('Init repository for normal request');
+            repository.wrapSize = 1;
+            repository.wrapper = `
+(function($) {%s})(jQuery);`;
+        }
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+module.exports = JQuery;

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018-2025 Toha <tohenk@yahoo.com>
+
+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/Popper.js

@@ -0,0 +1,65 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2023-2025 Toha <tohenk@yahoo.com>
+ *
+ * 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.
+ */
+
+const { Script, ScriptAsset } = require('@ntlab/ntjs');
+
+class Popper extends Script {
+
+    initialize() {
+        this.name = 'Popper';
+        this.assetPath = 'popper.js';
+        this.version = version;
+        const versions = [Popper.UMD, Popper.ESM, Popper.CJS];
+        if (versions.indexOf(this.version) >= 0) {
+            this.getAsset().setPath(ScriptAsset.JAVASCRIPT, this.version);
+        } else {
+            throw new Error(`Popper version not supported %{this.version}`);
+        }
+        this.addAsset(ScriptAsset.JAVASCRIPT, 'popper.min');
+    }
+
+    static get UMD() {
+        return 'umd';
+    }
+
+    static get ESM() {
+        return 'esm';
+    }
+
+    static get CJS() {
+        return 'cjs';
+    }
+
+    static setVersion(v) {
+        version = v;
+    }
+
+    static instance() {
+        return new this();
+    }
+}
+
+let version = Popper.UMD;
+
+module.exports = Popper;

package/README.md

@@ -0,0 +1,3 @@
+# NODE-NTJS Script Repository
+
+A collection of NODE-NTJS scripts.