@ktjs/shared 0.19.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kasukabe tsumugi
+
+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/dist/index.d.ts

@@ -0,0 +1,50 @@
+declare const $isArray: (arg: any) => arg is any[];
+declare const $hasOwn: (v: PropertyKey) => boolean;
+declare const $keys: <T>(o: T) => Array<keyof T>;
+declare const $defines: <T>(o: T, properties: PropertyDescriptorMap & ThisType<any>) => T;
+declare const $entries: <T>(o: T) => Array<[keyof T, T[keyof T]]>;
+declare const $isThenable: (o: any) => o is Promise<any>;
+
+declare const $throw: (message: string) => never;
+
+/**
+ * & Remove `bind` because it is shockingly slower than wrapper
+ * & `window.document` is safe because it is not configurable and its setter is undefined
+ */
+declare const $appendChild: <T extends Node>(node: T) => T;
+declare const originAppend: (...nodes: (Node | string)[]) => void;
+declare const $append: typeof originAppend;
+declare const parseStyle: (style: string | Partial<CSSStyleDeclaration> | undefined) => string;
+type ChangeHandler<T = string> = (value: T, ...args: any[]) => void;
+declare const generateHandler: <T = string>(props: any, key: string) => ChangeHandler<T>;
+
+/**
+ * Default empty function
+ */
+declare const $emptyFn: (...args: any[]) => any;
+
+/**
+ * Normalize path by joining parts and ensuring leading slash
+ */
+declare const normalizePath: (...paths: string[]) => string;
+/**
+ * Parse query string into object
+ */
+declare const parseQuery: (queryString: string) => Record<string, string>;
+/**
+ * Build query string from object
+ */
+declare const buildQuery: (query: Record<string, string>) => string;
+/**
+ * Substitute params into path pattern
+ * @example '/user/:id' + {id: '123'} => '/user/123'
+ */
+declare const emplaceParams: (path: string, params: Record<string, string>) => string;
+/**
+ * Extract dynamic params from path using pattern
+ * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+ */
+declare const extractParams: (pattern: string, path: string) => Record<string, string> | null;
+
+export { $append, $appendChild, $defines, $emptyFn, $entries, $hasOwn, $isArray, $isThenable, $keys, $throw, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
+export type { ChangeHandler };

package/dist/index.iife.js

@@ -0,0 +1,183 @@
+var __ktjs_shared__ = (function (exports) {
+    'use strict';
+
+    // Cached native methods for performance optimization
+    const $isArray = Array.isArray;
+    const $hasOwn = Object.prototype.hasOwnProperty;
+    const $keys = Object.keys;
+    const $defines = Object.defineProperties;
+    const $entries = Object.entries;
+    const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
+
+    // Error handling utilities
+    const $throw = (message) => {
+        throw new Error('@ktjs/shared: ' + message);
+    };
+
+    // String manipulation utilities
+    /**
+     * Default empty function
+     */
+    const $emptyFn = (() => true);
+
+    // DOM manipulation utilities
+    /**
+     * & Remove `bind` because it is shockingly slower than wrapper
+     * & `window.document` is safe because it is not configurable and its setter is undefined
+     */
+    const $appendChild = HTMLElement.prototype.appendChild;
+    const originAppend = HTMLElement.prototype.append;
+    const $append = // for ie 9/10/11
+     typeof originAppend === 'function'
+        ? originAppend
+        : function (...nodes) {
+            if (nodes.length < 50) {
+                for (let i = 0; i < nodes.length; i++) {
+                    const node = nodes[i];
+                    if (typeof node === 'string') {
+                        $appendChild.call(this, document.createTextNode(node));
+                    }
+                    else {
+                        $appendChild.call(this, node);
+                    }
+                }
+            }
+            else {
+                const fragment = document.createDocumentFragment();
+                for (let i = 0; i < nodes.length; i++) {
+                    const node = nodes[i];
+                    if (typeof node === 'string') {
+                        $appendChild.call(fragment, document.createTextNode(node));
+                    }
+                    else {
+                        $appendChild.call(fragment, node);
+                    }
+                }
+                $appendChild.call(this, fragment);
+            }
+        };
+    // Style parsing utilities
+    const parseStyle = (style) => {
+        if (typeof style === 'string') {
+            return style;
+        }
+        if (style && typeof style === 'object') {
+            return Object.entries(style)
+                .map(([key, value]) => {
+                // Convert camelCase to kebab-case
+                const cssKey = key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+                return `${cssKey}: ${value}`;
+            })
+                .join('; ');
+        }
+        return '';
+    };
+    const generateHandler = (props, key) => {
+        const handler = props[key];
+        if (typeof handler === 'function') {
+            return handler;
+        }
+        else if (handler && typeof handler === 'object' && handler.isKT) {
+            return (value) => (handler.value = value);
+        }
+        return $emptyFn;
+    };
+
+    /**
+     * Normalize path by joining parts and ensuring leading slash
+     */
+    const normalizePath = (...paths) => {
+        const p = paths
+            .map((p) => p.split('/'))
+            .flat()
+            .filter(Boolean);
+        return '/' + p.join('/');
+    };
+    /**
+     * Parse query string into object
+     */
+    const parseQuery = (queryString) => {
+        const query = {};
+        if (!queryString || queryString === '?') {
+            return query;
+        }
+        const params = queryString.replace(/^\?/, '').split('&');
+        for (const param of params) {
+            const [key, value] = param.split('=');
+            if (key) {
+                query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+            }
+        }
+        return query;
+    };
+    /**
+     * Build query string from object
+     */
+    const buildQuery = (query) => {
+        const keys = Object.keys(query);
+        if (keys.length === 0)
+            return '';
+        const params = keys.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`).join('&');
+        return `?${params}`;
+    };
+    /**
+     * Substitute params into path pattern
+     * @example '/user/:id' + {id: '123'} => '/user/123'
+     */
+    const emplaceParams = (path, params) => {
+        let result = path;
+        for (const key in params) {
+            result = result.replace(`:${key}`, params[key]);
+        }
+        return result;
+    };
+    /**
+     * Extract dynamic params from path using pattern
+     * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+     */
+    const extractParams = (pattern, path) => {
+        const params = {};
+        const patternParts = pattern.split('/');
+        const pathParts = path.split('/');
+        if (patternParts.length !== pathParts.length) {
+            return null;
+        }
+        for (let i = 0; i < patternParts.length; i++) {
+            const patternPart = patternParts[i];
+            const pathPart = pathParts[i];
+            if (patternPart.startsWith(':')) {
+                const paramName = patternPart.slice(1);
+                params[paramName] = pathPart;
+            }
+            else if (patternPart !== pathPart) {
+                return null;
+            }
+        }
+        return params;
+    };
+
+    // Shared utilities and cached native methods for kt.js framework
+    // Re-export all utilities
+    Object.defineProperty(window, '@ktjs/shared', { value: '0.19.0' });
+
+    exports.$append = $append;
+    exports.$appendChild = $appendChild;
+    exports.$defines = $defines;
+    exports.$emptyFn = $emptyFn;
+    exports.$entries = $entries;
+    exports.$hasOwn = $hasOwn;
+    exports.$isArray = $isArray;
+    exports.$isThenable = $isThenable;
+    exports.$keys = $keys;
+    exports.$throw = $throw;
+    exports.buildQuery = buildQuery;
+    exports.emplaceParams = emplaceParams;
+    exports.extractParams = extractParams;
+    exports.generateHandler = generateHandler;
+    exports.normalizePath = normalizePath;
+    exports.parseQuery = parseQuery;
+    exports.parseStyle = parseStyle;
+
+    return exports;
+
+})({});

package/dist/index.legacy.js

@@ -0,0 +1,195 @@
+var __ktjs_shared__ = (function (exports) {
+    'use strict';
+
+    // Cached native methods for performance optimization
+    var $isArray = Array.isArray;
+    var $hasOwn = Object.prototype.hasOwnProperty;
+    var $keys = Object.keys;
+    var $defines = Object.defineProperties;
+    var $entries = Object.entries;
+    var $isThenable = function (o) {
+        return typeof o === 'object' && o !== null && typeof o.then === 'function';
+    };
+
+    // Error handling utilities
+    var $throw = function (message) {
+        throw new Error('@ktjs/shared: ' + message);
+    };
+
+    // String manipulation utilities
+    /**
+     * Default empty function
+     */
+    var $emptyFn = (function () { return true; });
+
+    // DOM manipulation utilities
+    /**
+     * & Remove `bind` because it is shockingly slower than wrapper
+     * & `window.document` is safe because it is not configurable and its setter is undefined
+     */
+    var $appendChild = HTMLElement.prototype.appendChild;
+    var originAppend = HTMLElement.prototype.append;
+    var $append = // for ie 9/10/11
+     typeof originAppend === 'function'
+        ? originAppend
+        : function () {
+            var nodes = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                nodes[_i] = arguments[_i];
+            }
+            if (nodes.length < 50) {
+                for (var i = 0; i < nodes.length; i++) {
+                    var node = nodes[i];
+                    if (typeof node === 'string') {
+                        $appendChild.call(this, document.createTextNode(node));
+                    }
+                    else {
+                        $appendChild.call(this, node);
+                    }
+                }
+            }
+            else {
+                var fragment = document.createDocumentFragment();
+                for (var i = 0; i < nodes.length; i++) {
+                    var node = nodes[i];
+                    if (typeof node === 'string') {
+                        $appendChild.call(fragment, document.createTextNode(node));
+                    }
+                    else {
+                        $appendChild.call(fragment, node);
+                    }
+                }
+                $appendChild.call(this, fragment);
+            }
+        };
+    // Style parsing utilities
+    var parseStyle = function (style) {
+        if (typeof style === 'string') {
+            return style;
+        }
+        if (style && typeof style === 'object') {
+            return Object.entries(style)
+                .map(function (_a) {
+                var key = _a[0], value = _a[1];
+                // Convert camelCase to kebab-case
+                var cssKey = key.replace(/[A-Z]/g, function (m) { return "-".concat(m.toLowerCase()); });
+                return "".concat(cssKey, ": ").concat(value);
+            })
+                .join('; ');
+        }
+        return '';
+    };
+    var generateHandler = function (props, key) {
+        var handler = props[key];
+        if (typeof handler === 'function') {
+            return handler;
+        }
+        else if (handler && typeof handler === 'object' && handler.isKT) {
+            return function (value) { return (handler.value = value); };
+        }
+        return $emptyFn;
+    };
+
+    /**
+     * Normalize path by joining parts and ensuring leading slash
+     */
+    var normalizePath = function () {
+        var paths = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            paths[_i] = arguments[_i];
+        }
+        var p = paths
+            .map(function (p) { return p.split('/'); })
+            .flat()
+            .filter(Boolean);
+        return '/' + p.join('/');
+    };
+    /**
+     * Parse query string into object
+     */
+    var parseQuery = function (queryString) {
+        var query = {};
+        if (!queryString || queryString === '?') {
+            return query;
+        }
+        var params = queryString.replace(/^\?/, '').split('&');
+        for (var _i = 0, params_1 = params; _i < params_1.length; _i++) {
+            var param = params_1[_i];
+            var _a = param.split('='), key = _a[0], value = _a[1];
+            if (key) {
+                query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+            }
+        }
+        return query;
+    };
+    /**
+     * Build query string from object
+     */
+    var buildQuery = function (query) {
+        var keys = Object.keys(query);
+        if (keys.length === 0)
+            return '';
+        var params = keys.map(function (key) { return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(query[key])); }).join('&');
+        return "?".concat(params);
+    };
+    /**
+     * Substitute params into path pattern
+     * @example '/user/:id' + {id: '123'} => '/user/123'
+     */
+    var emplaceParams = function (path, params) {
+        var result = path;
+        for (var key in params) {
+            result = result.replace(":".concat(key), params[key]);
+        }
+        return result;
+    };
+    /**
+     * Extract dynamic params from path using pattern
+     * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+     */
+    var extractParams = function (pattern, path) {
+        var params = {};
+        var patternParts = pattern.split('/');
+        var pathParts = path.split('/');
+        if (patternParts.length !== pathParts.length) {
+            return null;
+        }
+        for (var i = 0; i < patternParts.length; i++) {
+            var patternPart = patternParts[i];
+            var pathPart = pathParts[i];
+            if (patternPart.startsWith(':')) {
+                var paramName = patternPart.slice(1);
+                params[paramName] = pathPart;
+            }
+            else if (patternPart !== pathPart) {
+                return null;
+            }
+        }
+        return params;
+    };
+
+    // Shared utilities and cached native methods for kt.js framework
+    // Re-export all utilities
+    Object.defineProperty(window, '@ktjs/shared', { value: '0.19.0' });
+
+    exports.$append = $append;
+    exports.$appendChild = $appendChild;
+    exports.$defines = $defines;
+    exports.$emptyFn = $emptyFn;
+    exports.$entries = $entries;
+    exports.$hasOwn = $hasOwn;
+    exports.$isArray = $isArray;
+    exports.$isThenable = $isThenable;
+    exports.$keys = $keys;
+    exports.$throw = $throw;
+    exports.buildQuery = buildQuery;
+    exports.emplaceParams = emplaceParams;
+    exports.extractParams = extractParams;
+    exports.generateHandler = generateHandler;
+    exports.normalizePath = normalizePath;
+    exports.parseQuery = parseQuery;
+    exports.parseStyle = parseStyle;
+
+    return exports;
+
+})({});

package/dist/index.mjs

@@ -0,0 +1,160 @@
+// Cached native methods for performance optimization
+const $isArray = Array.isArray;
+const $hasOwn = Object.prototype.hasOwnProperty;
+const $keys = Object.keys;
+const $defines = Object.defineProperties;
+const $entries = Object.entries;
+const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
+
+// Error handling utilities
+const $throw = (message) => {
+    throw new Error('@ktjs/shared: ' + message);
+};
+
+// String manipulation utilities
+/**
+ * Default empty function
+ */
+const $emptyFn = (() => true);
+
+// DOM manipulation utilities
+/**
+ * & Remove `bind` because it is shockingly slower than wrapper
+ * & `window.document` is safe because it is not configurable and its setter is undefined
+ */
+const $appendChild = HTMLElement.prototype.appendChild;
+const originAppend = HTMLElement.prototype.append;
+const $append = // for ie 9/10/11
+ typeof originAppend === 'function'
+    ? originAppend
+    : function (...nodes) {
+        if (nodes.length < 50) {
+            for (let i = 0; i < nodes.length; i++) {
+                const node = nodes[i];
+                if (typeof node === 'string') {
+                    $appendChild.call(this, document.createTextNode(node));
+                }
+                else {
+                    $appendChild.call(this, node);
+                }
+            }
+        }
+        else {
+            const fragment = document.createDocumentFragment();
+            for (let i = 0; i < nodes.length; i++) {
+                const node = nodes[i];
+                if (typeof node === 'string') {
+                    $appendChild.call(fragment, document.createTextNode(node));
+                }
+                else {
+                    $appendChild.call(fragment, node);
+                }
+            }
+            $appendChild.call(this, fragment);
+        }
+    };
+// Style parsing utilities
+const parseStyle = (style) => {
+    if (typeof style === 'string') {
+        return style;
+    }
+    if (style && typeof style === 'object') {
+        return Object.entries(style)
+            .map(([key, value]) => {
+            // Convert camelCase to kebab-case
+            const cssKey = key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+            return `${cssKey}: ${value}`;
+        })
+            .join('; ');
+    }
+    return '';
+};
+const generateHandler = (props, key) => {
+    const handler = props[key];
+    if (typeof handler === 'function') {
+        return handler;
+    }
+    else if (handler && typeof handler === 'object' && handler.isKT) {
+        return (value) => (handler.value = value);
+    }
+    return $emptyFn;
+};
+
+/**
+ * Normalize path by joining parts and ensuring leading slash
+ */
+const normalizePath = (...paths) => {
+    const p = paths
+        .map((p) => p.split('/'))
+        .flat()
+        .filter(Boolean);
+    return '/' + p.join('/');
+};
+/**
+ * Parse query string into object
+ */
+const parseQuery = (queryString) => {
+    const query = {};
+    if (!queryString || queryString === '?') {
+        return query;
+    }
+    const params = queryString.replace(/^\?/, '').split('&');
+    for (const param of params) {
+        const [key, value] = param.split('=');
+        if (key) {
+            query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+        }
+    }
+    return query;
+};
+/**
+ * Build query string from object
+ */
+const buildQuery = (query) => {
+    const keys = Object.keys(query);
+    if (keys.length === 0)
+        return '';
+    const params = keys.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`).join('&');
+    return `?${params}`;
+};
+/**
+ * Substitute params into path pattern
+ * @example '/user/:id' + {id: '123'} => '/user/123'
+ */
+const emplaceParams = (path, params) => {
+    let result = path;
+    for (const key in params) {
+        result = result.replace(`:${key}`, params[key]);
+    }
+    return result;
+};
+/**
+ * Extract dynamic params from path using pattern
+ * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}
+ */
+const extractParams = (pattern, path) => {
+    const params = {};
+    const patternParts = pattern.split('/');
+    const pathParts = path.split('/');
+    if (patternParts.length !== pathParts.length) {
+        return null;
+    }
+    for (let i = 0; i < patternParts.length; i++) {
+        const patternPart = patternParts[i];
+        const pathPart = pathParts[i];
+        if (patternPart.startsWith(':')) {
+            const paramName = patternPart.slice(1);
+            params[paramName] = pathPart;
+        }
+        else if (patternPart !== pathPart) {
+            return null;
+        }
+    }
+    return params;
+};
+
+// Shared utilities and cached native methods for kt.js framework
+// Re-export all utilities
+Object.defineProperty(window, '@ktjs/shared', { value: '0.19.0' });
+
+export { $append, $appendChild, $defines, $emptyFn, $entries, $hasOwn, $isArray, $isThenable, $keys, $throw, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@ktjs/shared",
+  "version": "0.19.0",
+  "description": "Shared utilities and cached native methods for kt.js framework",
+  "type": "module",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "utilities",
+    "shared",
+    "framework",
+    "web",
+    "tools"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Kasukabe Tsumugi",
+    "email": "futami16237@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baendlorel/kt.js",
+    "directory": "packages/shared"
+  },
+  "scripts": {
+    "build": "rollup -c rollup.config.mjs",
+    "dev": "rollup -c rollup.config.mjs -w"
+  }
+}