@arc-js/qust 0.0.0

package/js/index.js

@@ -0,0 +1,328 @@
+const globalFunct = (function (global) {
+    'use strict';
+    const DEFAULT_OPTIONS = {
+        arrayFormat: 'bracket',
+        arraySeparator: ',',
+        skipNull: true,
+        skipEmptyString: false,
+        encode: true,
+        decode: true,
+        depth: 10
+    };
+    class Qust {
+        options;
+        constructor(options = {}) {
+            this.options = { ...DEFAULT_OPTIONS, ...options };
+        }
+        stringify(obj) {
+            if (!obj || typeof obj !== 'object') {
+                return '';
+            }
+            const parts = [];
+            this.processObject('', obj, parts, 0);
+            return parts.length > 0 ? `?${parts.join('&')}` : '';
+        }
+        parse(queryString) {
+            if (!queryString || typeof queryString !== 'string') {
+                return {};
+            }
+            const cleanString = queryString.startsWith('?')
+                ? queryString.slice(1)
+                : queryString;
+            if (!cleanString) {
+                return {};
+            }
+            const result = {};
+            const pairs = cleanString.split('&');
+            for (const pair of pairs) {
+                if (!pair)
+                    continue;
+                const [encodedKey, encodedValue] = pair.split('=');
+                if (!encodedKey)
+                    continue;
+                const key = this.options.decode
+                    ? decodeURIComponent(encodedKey)
+                    : encodedKey;
+                const value = this.options.decode && encodedValue !== undefined
+                    ? decodeURIComponent(encodedValue)
+                    : encodedValue;
+                this.setValue(result, key, value);
+            }
+            return this.transformArrays(result);
+        }
+        processObject(prefix, value, parts, depth) {
+            if (depth > this.options.depth) {
+                console.warn('Qust: Profondeur maximale atteinte, arrêt de la récursion');
+                return;
+            }
+            if (value === null || value === undefined) {
+                if (!this.options.skipNull) {
+                    parts.push(this.encodeKey(prefix));
+                }
+                return;
+            }
+            if (typeof value === 'string' && value === '' && this.options.skipEmptyString) {
+                return;
+            }
+            if (Array.isArray(value)) {
+                this.processArray(prefix, value, parts, depth + 1);
+                return;
+            }
+            if (typeof value === 'object' && !this.isPrimitive(value)) {
+                for (const [key, val] of Object.entries(value)) {
+                    const newPrefix = prefix ? `${prefix}[${key}]` : key;
+                    this.processObject(newPrefix, val, parts, depth + 1);
+                }
+                return;
+            }
+            const encodedKey = this.encodeKey(prefix);
+            const encodedValue = this.options.encode && typeof value === 'string'
+                ? encodeURIComponent(value)
+                : String(value);
+            parts.push(`${encodedKey}=${encodedValue}`);
+        }
+        processArray(prefix, array, parts, depth) {
+            if (array.length === 0)
+                return;
+            const encodedKey = this.encodeKey(prefix);
+            switch (this.options.arrayFormat) {
+                case 'comma':
+                    const values = array
+                        .map(item => this.options.encode && typeof item === 'string'
+                        ? encodeURIComponent(item)
+                        : String(item))
+                        .join(this.options.arraySeparator);
+                    parts.push(`${encodedKey}=${values}`);
+                    break;
+                case 'index':
+                    array.forEach((item, index) => {
+                        const arrayPrefix = `${prefix}[${index}]`;
+                        this.processObject(arrayPrefix, item, parts, depth);
+                    });
+                    break;
+                case 'separator':
+                    array.forEach(item => {
+                        const encodedValue = this.options.encode && typeof item === 'string'
+                            ? encodeURIComponent(item)
+                            : String(item);
+                        parts.push(`${encodedKey}=${encodedValue}`);
+                    });
+                    break;
+                case 'none':
+                    array.forEach(item => {
+                        this.processObject(prefix, item, parts, depth);
+                    });
+                    break;
+                case 'bracket':
+                default:
+                    array.forEach(item => {
+                        const arrayPrefix = `${prefix}[]`;
+                        this.processObject(arrayPrefix, item, parts, depth);
+                    });
+                    break;
+            }
+        }
+        encodeKey(key) {
+            if (!this.options.encode) {
+                return key;
+            }
+            const parts = [];
+            let currentPart = '';
+            for (let i = 0; i < key.length; i++) {
+                const char = key[i];
+                if (char === '[' || char === ']') {
+                    if (currentPart) {
+                        parts.push(encodeURIComponent(currentPart));
+                        currentPart = '';
+                    }
+                    parts.push(char);
+                }
+                else {
+                    currentPart += char;
+                }
+            }
+            if (currentPart) {
+                parts.push(encodeURIComponent(currentPart));
+            }
+            return parts.join('');
+        }
+        setValue(obj, key, value) {
+            const matches = key.match(/([^\[\]]+)|(\[\])/g);
+            if (!matches) {
+                if (value !== undefined) {
+                    obj[key] = this.parseValue(value);
+                }
+                return;
+            }
+            let current = obj;
+            for (let i = 0; i < matches.length; i++) {
+                const match = matches[i];
+                const isLast = i === matches.length - 1;
+                if (match === '[]') {
+                    if (!Array.isArray(current)) {
+                        current = [];
+                    }
+                    if (isLast) {
+                        if (!!value) {
+                            current.push(this.parseValue(value));
+                        }
+                    }
+                    else {
+                        const nextMatch = matches[i + 1];
+                        const nextIndex = parseInt(nextMatch, 10);
+                        if (!isNaN(nextIndex)) {
+                            if (current[nextIndex] === undefined) {
+                                current[nextIndex] = {};
+                            }
+                            current = current[nextIndex];
+                            i++;
+                        }
+                        else {
+                            const newObj = {};
+                            current.push(newObj);
+                            current = newObj;
+                        }
+                    }
+                }
+                else {
+                    if (isLast) {
+                        if (value !== undefined) {
+                            current[match] = this.parseValue(value);
+                        }
+                    }
+                    else {
+                        if (current[match] === undefined || typeof current[match] !== 'object') {
+                            const nextMatch = matches[i + 1];
+                            current[match] = nextMatch === '[]' ? [] : {};
+                        }
+                        current = current[match];
+                    }
+                }
+            }
+        }
+        transformArrays(obj) {
+            if (Array.isArray(obj)) {
+                return obj.map(item => typeof item === 'object' && item !== null
+                    ? this.transformArrays(item)
+                    : item);
+            }
+            if (typeof obj !== 'object' || obj === null) {
+                return obj;
+            }
+            const result = {};
+            const keys = Object.keys(obj);
+            const isArrayLike = keys.every(key => {
+                const num = parseInt(key, 10);
+                return !isNaN(num) && num >= 0 && num.toString() === key;
+            });
+            if (isArrayLike && keys.length > 0) {
+                const array = [];
+                keys.forEach(key => {
+                    const index = parseInt(key, 10);
+                    array[index] = this.transformArrays(obj[key]);
+                });
+                return array;
+            }
+            keys.forEach(key => {
+                const value = obj[key];
+                result[key] =
+                    typeof value === 'object' && value !== null
+                        ? this.transformArrays(value)
+                        : value;
+            });
+            return result;
+        }
+        parseValue(value) {
+            if (value === 'true')
+                return true;
+            if (value === 'false')
+                return false;
+            if (value === 'null')
+                return null;
+            if (value === 'undefined')
+                return undefined;
+            const num = Number(value);
+            if (!isNaN(num) && value.trim() !== '')
+                return num;
+            return value;
+        }
+        isPrimitive(value) {
+            return value === null ||
+                typeof value !== 'object' &&
+                    typeof value !== 'function';
+        }
+        setOptions(newOptions) {
+            this.options = { ...this.options, ...newOptions };
+        }
+        getOptions() {
+            return { ...this.options };
+        }
+        static exposeToGlobal() {
+            if (typeof window !== "undefined") {
+                window.Qust = Qust;
+            }
+        }
+    }
+    const qust = {
+        stringify(obj, options) {
+            return new Qust(options).stringify(obj);
+        },
+        parse(queryString, options) {
+            return new Qust(options).parse(queryString);
+        }
+    };
+    if (typeof window !== "undefined") {
+        window.Qust = Qust;
+        window.qust = qust;
+    }
+    const globalFunctModule = {
+        default: qust,
+        Qust: Qust,
+        qust: qust,
+    };
+    globalFunctModule.default = { ...(globalFunctModule?.default || {}), Qust: Qust };
+    globalFunctModule.default = { ...(globalFunctModule?.default || {}), qust: qust };
+    const __bundledModules = globalFunctModule;
+    if (typeof global !== 'undefined') {
+        global.default = qust;
+        global.Qust = Qust;
+        global.qust = qust;
+        global.__bundledModules = __bundledModules;
+    }
+    if (typeof window !== "undefined") {
+        window.default = qust;
+        window.Qust = Qust;
+        window.qust = qust;
+        window.__bundledModules = __bundledModules;
+    }
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = __bundledModules;
+        module.exports.default = qust;
+        module.exports.Qust = Qust;
+        module.exports.qust = qust;
+    }
+    if (typeof exports !== 'undefined') {
+        exports.default = qust;
+        exports.Qust = Qust;
+        exports.qust = qust;
+    }
+    return __bundledModules;
+})(typeof global !== 'undefined' ? global :
+    typeof window !== 'undefined' ? window :
+        typeof self !== 'undefined' ? self :
+            typeof globalThis !== 'undefined' ? globalThis :
+                {});
+const QustElementGF = globalFunct.Qust;
+const qustElementGF = globalFunct.qust;
+const defaultElementGF = globalFunct.default;
+export { QustElementGF as Qust, qustElementGF as qust, };
+export default defaultElementGF;
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        Qust: QustElementGF,
+        qust: qustElementGF,
+    };
+}
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports.default = globalFunct?.default;
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@arc-js/qust",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.0.0",
+  "description": "Qust est une bibliothèque TypeScript ultra-légère et performante pour la sérialisation et désérialisation d'objets en chaînes de requête (query strings). Elle offre une API simple et puissante pour manipuler les paramètres d'URL avec support des types complexes, des tableaux, des objets imbriqués et des options avancées.",
+  "main": "index.js",
+  "keywords": [],
+  "author": "INICODE <contact.inicode@gmail.com>",
+  "license": "MIT",
+  "scripts": {
+    "init": "npm init --scope=@arc-js/qust",
+    "login": "npm login"
+  },
+  "devDependencies": {},
+  "dependencies": {}
+}

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "target": "ES6",
+        "module": "commonjs",
+        "lib": ["ES2020", "DOM", "DOM.Iterable", "ESNext"],
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "declaration": false,
+        "sourceMap": false,
+        "allowSyntheticDefaultImports": true,
+        "noEmit": false,
+        
+        "strict": false,
+        "noImplicitAny": false,
+        "strictNullChecks": false,
+        "strictFunctionTypes": false,
+        "strictBindCallApply": false,
+        "strictPropertyInitialization": false,
+        "noImplicitThis": false,
+        "alwaysStrict": false
+    },
+    "include": [],
+    "exclude": [
+        "node_modules",
+        "**/*.d.ts"
+    ]
+}

package/web/qust.js

@@ -0,0 +1,326 @@
+const globalFunct = (function (global) {
+    'use strict';
+    const DEFAULT_OPTIONS = {
+        arrayFormat: 'bracket',
+        arraySeparator: ',',
+        skipNull: true,
+        skipEmptyString: false,
+        encode: true,
+        decode: true,
+        depth: 10
+    };
+    class Qust {
+        options;
+        constructor(options = {}) {
+            this.options = { ...DEFAULT_OPTIONS, ...options };
+        }
+        stringify(obj) {
+            if (!obj || typeof obj !== 'object') {
+                return '';
+            }
+            const parts = [];
+            this.processObject('', obj, parts, 0);
+            return parts.length > 0 ? `?${parts.join('&')}` : '';
+        }
+        parse(queryString) {
+            if (!queryString || typeof queryString !== 'string') {
+                return {};
+            }
+            const cleanString = queryString.startsWith('?')
+                ? queryString.slice(1)
+                : queryString;
+            if (!cleanString) {
+                return {};
+            }
+            const result = {};
+            const pairs = cleanString.split('&');
+            for (const pair of pairs) {
+                if (!pair)
+                    continue;
+                const [encodedKey, encodedValue] = pair.split('=');
+                if (!encodedKey)
+                    continue;
+                const key = this.options.decode
+                    ? decodeURIComponent(encodedKey)
+                    : encodedKey;
+                const value = this.options.decode && encodedValue !== undefined
+                    ? decodeURIComponent(encodedValue)
+                    : encodedValue;
+                this.setValue(result, key, value);
+            }
+            return this.transformArrays(result);
+        }
+        processObject(prefix, value, parts, depth) {
+            if (depth > this.options.depth) {
+                console.warn('Qust: Profondeur maximale atteinte, arrêt de la récursion');
+                return;
+            }
+            if (value === null || value === undefined) {
+                if (!this.options.skipNull) {
+                    parts.push(this.encodeKey(prefix));
+                }
+                return;
+            }
+            if (typeof value === 'string' && value === '' && this.options.skipEmptyString) {
+                return;
+            }
+            if (Array.isArray(value)) {
+                this.processArray(prefix, value, parts, depth + 1);
+                return;
+            }
+            if (typeof value === 'object' && !this.isPrimitive(value)) {
+                for (const [key, val] of Object.entries(value)) {
+                    const newPrefix = prefix ? `${prefix}[${key}]` : key;
+                    this.processObject(newPrefix, val, parts, depth + 1);
+                }
+                return;
+            }
+            const encodedKey = this.encodeKey(prefix);
+            const encodedValue = this.options.encode && typeof value === 'string'
+                ? encodeURIComponent(value)
+                : String(value);
+            parts.push(`${encodedKey}=${encodedValue}`);
+        }
+        processArray(prefix, array, parts, depth) {
+            if (array.length === 0)
+                return;
+            const encodedKey = this.encodeKey(prefix);
+            switch (this.options.arrayFormat) {
+                case 'comma':
+                    const values = array
+                        .map(item => this.options.encode && typeof item === 'string'
+                        ? encodeURIComponent(item)
+                        : String(item))
+                        .join(this.options.arraySeparator);
+                    parts.push(`${encodedKey}=${values}`);
+                    break;
+                case 'index':
+                    array.forEach((item, index) => {
+                        const arrayPrefix = `${prefix}[${index}]`;
+                        this.processObject(arrayPrefix, item, parts, depth);
+                    });
+                    break;
+                case 'separator':
+                    array.forEach(item => {
+                        const encodedValue = this.options.encode && typeof item === 'string'
+                            ? encodeURIComponent(item)
+                            : String(item);
+                        parts.push(`${encodedKey}=${encodedValue}`);
+                    });
+                    break;
+                case 'none':
+                    array.forEach(item => {
+                        this.processObject(prefix, item, parts, depth);
+                    });
+                    break;
+                case 'bracket':
+                default:
+                    array.forEach(item => {
+                        const arrayPrefix = `${prefix}[]`;
+                        this.processObject(arrayPrefix, item, parts, depth);
+                    });
+                    break;
+            }
+        }
+        encodeKey(key) {
+            if (!this.options.encode) {
+                return key;
+            }
+            const parts = [];
+            let currentPart = '';
+            for (let i = 0; i < key.length; i++) {
+                const char = key[i];
+                if (char === '[' || char === ']') {
+                    if (currentPart) {
+                        parts.push(encodeURIComponent(currentPart));
+                        currentPart = '';
+                    }
+                    parts.push(char);
+                }
+                else {
+                    currentPart += char;
+                }
+            }
+            if (currentPart) {
+                parts.push(encodeURIComponent(currentPart));
+            }
+            return parts.join('');
+        }
+        setValue(obj, key, value) {
+            const matches = key.match(/([^\[\]]+)|(\[\])/g);
+            if (!matches) {
+                if (value !== undefined) {
+                    obj[key] = this.parseValue(value);
+                }
+                return;
+            }
+            let current = obj;
+            for (let i = 0; i < matches.length; i++) {
+                const match = matches[i];
+                const isLast = i === matches.length - 1;
+                if (match === '[]') {
+                    if (!Array.isArray(current)) {
+                        current = [];
+                    }
+                    if (isLast) {
+                        if (!!value) {
+                            current.push(this.parseValue(value));
+                        }
+                    }
+                    else {
+                        const nextMatch = matches[i + 1];
+                        const nextIndex = parseInt(nextMatch, 10);
+                        if (!isNaN(nextIndex)) {
+                            if (current[nextIndex] === undefined) {
+                                current[nextIndex] = {};
+                            }
+                            current = current[nextIndex];
+                            i++;
+                        }
+                        else {
+                            const newObj = {};
+                            current.push(newObj);
+                            current = newObj;
+                        }
+                    }
+                }
+                else {
+                    if (isLast) {
+                        if (value !== undefined) {
+                            current[match] = this.parseValue(value);
+                        }
+                    }
+                    else {
+                        if (current[match] === undefined || typeof current[match] !== 'object') {
+                            const nextMatch = matches[i + 1];
+                            current[match] = nextMatch === '[]' ? [] : {};
+                        }
+                        current = current[match];
+                    }
+                }
+            }
+        }
+        transformArrays(obj) {
+            if (Array.isArray(obj)) {
+                return obj.map(item => typeof item === 'object' && item !== null
+                    ? this.transformArrays(item)
+                    : item);
+            }
+            if (typeof obj !== 'object' || obj === null) {
+                return obj;
+            }
+            const result = {};
+            const keys = Object.keys(obj);
+            const isArrayLike = keys.every(key => {
+                const num = parseInt(key, 10);
+                return !isNaN(num) && num >= 0 && num.toString() === key;
+            });
+            if (isArrayLike && keys.length > 0) {
+                const array = [];
+                keys.forEach(key => {
+                    const index = parseInt(key, 10);
+                    array[index] = this.transformArrays(obj[key]);
+                });
+                return array;
+            }
+            keys.forEach(key => {
+                const value = obj[key];
+                result[key] =
+                    typeof value === 'object' && value !== null
+                        ? this.transformArrays(value)
+                        : value;
+            });
+            return result;
+        }
+        parseValue(value) {
+            if (value === 'true')
+                return true;
+            if (value === 'false')
+                return false;
+            if (value === 'null')
+                return null;
+            if (value === 'undefined')
+                return undefined;
+            const num = Number(value);
+            if (!isNaN(num) && value.trim() !== '')
+                return num;
+            return value;
+        }
+        isPrimitive(value) {
+            return value === null ||
+                typeof value !== 'object' &&
+                    typeof value !== 'function';
+        }
+        setOptions(newOptions) {
+            this.options = { ...this.options, ...newOptions };
+        }
+        getOptions() {
+            return { ...this.options };
+        }
+        static exposeToGlobal() {
+            if (typeof window !== "undefined") {
+                window.Qust = Qust;
+            }
+        }
+    }
+    const qust = {
+        stringify(obj, options) {
+            return new Qust(options).stringify(obj);
+        },
+        parse(queryString, options) {
+            return new Qust(options).parse(queryString);
+        }
+    };
+    if (typeof window !== "undefined") {
+        window.Qust = Qust;
+        window.qust = qust;
+    }
+    const globalFunctModule = {
+        default: qust,
+        Qust: Qust,
+        qust: qust,
+    };
+    globalFunctModule.default = { ...(globalFunctModule?.default || {}), Qust: Qust };
+    globalFunctModule.default = { ...(globalFunctModule?.default || {}), qust: qust };
+    const __bundledModules = globalFunctModule;
+    if (typeof global !== 'undefined') {
+        global.default = qust;
+        global.Qust = Qust;
+        global.qust = qust;
+        global.__bundledModules = __bundledModules;
+    }
+    if (typeof window !== "undefined") {
+        window.default = qust;
+        window.Qust = Qust;
+        window.qust = qust;
+        window.__bundledModules = __bundledModules;
+    }
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = __bundledModules;
+        module.exports.default = qust;
+        module.exports.Qust = Qust;
+        module.exports.qust = qust;
+    }
+    if (typeof exports !== 'undefined') {
+        exports.default = qust;
+        exports.Qust = Qust;
+        exports.qust = qust;
+    }
+    return __bundledModules;
+})(typeof global !== 'undefined' ? global :
+    typeof window !== 'undefined' ? window :
+        typeof self !== 'undefined' ? self :
+            typeof globalThis !== 'undefined' ? globalThis :
+                {});
+const QustElementGF = globalFunct.Qust;
+const qustElementGF = globalFunct.qust;
+const defaultElementGF = globalFunct.default;
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        Qust: QustElementGF,
+        qust: qustElementGF,
+    };
+}
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports.default = globalFunct?.default;
+}