@ktjs/shared 0.23.17 → 0.23.19

package/dist/index.d.ts

@@ -1,199 +1,161 @@
-export declare const $append: typeof originAppend;
-
-/**
- * & Remove `bind` because it is shockingly slower than wrapper
- * & `window.document` is safe because it is not configurable and its setter is undefined
- */
-export declare const $appendChild: <T extends Node>(node: T) => T;
-
-/**
- * Used for `k-model`
- */
-export declare const $applyModel: (element: HTMLElementTagNameMap[InputElementTag], valueRef: {
-    value: unknown;
-    addOnChange: (fn: (newValue: unknown) => void) => void;
-}, propName: "value" | "checked", eventName: "change" | "input") => void;
-
-export declare const $ArrayFrom: {
-    <T>(arrayLike: ArrayLike<T>): T[];
-    <T, U>(arrayLike: ArrayLike<T>, mapfn: (v: T, k: number) => U, thisArg?: any): U[];
-    <T>(iterable: Iterable<T> | ArrayLike<T>): T[];
-    <T, U>(iterable: Iterable<T> | ArrayLike<T>, mapfn: (v: T, k: number) => U, thisArg?: any): U[];
-};
-
-export declare const $assign: {
-    <T extends {}, U>(target: T, source: U): T & U;
-    <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
-    <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
-    (target: object, ...sources: any[]): any;
-};
-
-export declare const $buttonDisabledGetter: () => any;
-
-export declare const $buttonDisabledSetter: (v: any) => void;
-
-export declare const $define: <T>(o: T, p: PropertyKey, attributes: PropertyDescriptor & ThisType<any>) => T;
-
-export declare const $defines: <T>(o: T, properties: PropertyDescriptorMap & ThisType<any>) => T;
-
-export declare const $emptyArray: any[];
-
-/**
- * Default empty function
- */
-export declare const $emptyFn: (...args: any[]) => any;
-
-export declare const $emptyObject: any;
-
-export declare const $entries: <T>(o: T) => Array<[keyof T, T[keyof T]]>;
-
-/**
- * Safe and quick forEach implementation that works with array-like objects and handles sparse arrays.
- */
-export declare const $forEach: (array: unknown[], callback: (item: unknown, index: number, array: unknown[]) => void) => void;
-
-/**
- * Async version of $forEach that allows for asynchronous callbacks. It processes items sequentially, awaiting each callback before moving to the next.
- */
-export declare const $forEachAsync: (array: unknown[], callback: (item: unknown, index: number, array: unknown[]) => void) => Promise<void>;
-
-export declare const $hasOwn: (v: PropertyKey) => boolean;
-
-export declare const $is: (value1: any, value2: any) => boolean;
-
-export declare const $isArray: (arg: any) => arg is any[];
-
-export declare const $isNode: (x: any) => x is ChildNode;
-
-export declare const $isSame: (a: unknown, b: unknown) => boolean;
-
-export declare const $isThenable: (o: any) => o is Promise<any>;
-
-export declare const $keys: <T>(o: T) => Array<keyof T>;
-
-export declare const $parseStyle: (style: unknown) => string;
-
-export declare const $random: () => number;
-
-/**
- * Safe replace `oldNode` With `newNode`
- */
-export declare const $replaceNode: (oldNode: unknown, newNode: unknown) => void;
-
-export declare const $toString: () => string;
-
-/**
- * Build query string from object
- */
-export declare const buildQuery: (query: Record<string, string>) => string;
-
-export declare type ChangeHandler<T = string> = (value: T, ...args: any[]) => void;
-
-/**
- * These fields of HTMLElement can trigger `change`.
- */
-export declare type ChangeTriggerField = 'value' | 'checked' | 'selected' | 'valueAsDate' | 'valueAsNumber';
-
-/**
- * Substitute params into path pattern
- * @example '/user/:id' + {id: '123'} => '/user/123'
- */
-export 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'}
- */
-export declare const extractParams: (pattern: string, path: string) => Record<string, string> | null;
-
-export declare type HTMLJSXTag = HTMLTag | ((props?: any) => HTMLElement) | ((props?: any) => Promise<HTMLElement>);
-
-/**
- * Normal HTML tags like `div`, `span`, `a`, etc.
- */
-export declare type HTMLTag = keyof HTMLElementTagNameMap;
-
-export declare type InputElementTag = 'input' | 'select' | 'textarea';
-
-export declare type JSXTag = HTMLJSXTag | SVGJSXTag | MathMLJSXTag;
-
-export declare interface KTReactiveLike<T = unknown> {
-    isKT: true;
-    value: T;
-    addOnChange(fn: (newValue: T, oldValue: T) => void): void;
-    removeOnChange?(fn: (newValue: T, oldValue: T) => void): boolean;
-}
-
-export declare type MathMLJSXTag = HTMLTag | ((props?: any) => MathMLElement) | ((props?: any) => Promise<MathMLElement>);
-
-export declare type MathMLTag = keyof MathMLElementTagNameMap;
-
-/**
- * Get the tags that makes HTMLElementTagNameMap[tag] = HTMLElement
- */
-export declare type NonSpecialTags = {
-    [K in keyof HTMLElementTagNameMap]: HTMLElement extends HTMLElementTagNameMap[K] ? K : never;
-}[keyof HTMLElementTagNameMap];
-
-/**
- * Normalize path by joining parts and ensuring leading slash
- */
-export declare const normalizePath: (...paths: string[]) => string;
-
-/**
- * This is tested on 15 browsers (most popular ones)
- * - appending a text node to these tags takes no effect.
- *   - No effect means `innerText` does not include the text in the text node.
- * @see {@link src/core/h/no-text-node.ts}
- */
-export declare type NoTextNodeTag =
-| 'area'
-| 'audio'
-| 'base'
-| 'basefont'
-| 'br'
-| 'canvas'
-| 'datalist'
-| 'details'
-| 'dialog'
-| 'frameset'
-| 'head'
-| 'iframe'
-| 'img'
-| 'input'
-| 'link'
-| 'meta'
-| 'meter'
-| 'noembed'
-| 'noframes'
-| 'noscript'
-| 'optgroup'
-| 'param'
-| 'progress'
-| 'rp'
-| 'select'
-| 'style'
-| 'template'
-| 'textarea'
-| 'title'
-| 'video'
-| 'wbr'
-| 'embed'
-| 'frame'
-| 'keygen'
-| 'option';
-
-declare const originAppend: (...nodes: (Node | string)[]) => void;
-
-export declare type otherstring = string & {};
-
-/**
- * Parse query string into object
- */
-export declare const parseQuery: (queryString: string) => Record<string, string>;
-
-export declare type SVGJSXTag = HTMLTag | ((props?: any) => SVGElement) | ((props?: any) => Promise<SVGElement>);
-
-export declare type SVGTag = keyof SVGElementTagNameMap;
-
-export { }
+declare const $isArray: (arg: any) => arg is any[];
+declare const $ArrayFrom: {
+    <T>(arrayLike: ArrayLike<T>): T[];
+    <T, U>(arrayLike: ArrayLike<T>, mapfn: (v: T, k: number) => U, thisArg?: any): U[];
+    <T>(iterable: Iterable<T> | ArrayLike<T>): T[];
+    <T, U>(iterable: Iterable<T> | ArrayLike<T>, mapfn: (v: T, k: number) => U, thisArg?: any): U[];
+};
+declare const $is: (value1: any, value2: any) => boolean;
+declare const $assign: {
+    <T extends {}, U>(target: T, source: U): T & U;
+    <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
+    <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+    (target: object, ...sources: any[]): any;
+};
+declare const $hasOwn: (v: PropertyKey) => boolean;
+declare const $toString: () => string;
+declare const $keys: <T>(o: T) => Array<keyof T>;
+declare const $defines: <T>(o: T, properties: PropertyDescriptorMap & ThisType<any>) => T;
+declare const $define: <T>(o: T, p: PropertyKey, attributes: PropertyDescriptor & ThisType<any>) => T;
+declare const $entries: <T>(o: T) => Array<[keyof T, T[keyof T]]>;
+declare const $random: () => number;
+declare const $isThenable: (o: any) => o is Promise<any>;
+
+type otherstring = string & {};
+
+/**
+ * Normal HTML tags like `div`, `span`, `a`, etc.
+ */
+type HTMLTag = keyof HTMLElementTagNameMap;
+type SVGTag = keyof SVGElementTagNameMap;
+type MathMLTag = keyof MathMLElementTagNameMap;
+
+type HTMLJSXTag = HTMLTag | ((props?: any) => HTMLElement) | ((props?: any) => Promise<HTMLElement>);
+type SVGJSXTag = HTMLTag | ((props?: any) => SVGElement) | ((props?: any) => Promise<SVGElement>);
+type MathMLJSXTag = HTMLTag | ((props?: any) => MathMLElement) | ((props?: any) => Promise<MathMLElement>);
+type JSXTag = HTMLJSXTag | SVGJSXTag | MathMLJSXTag;
+
+/**
+ * Get the tags that makes HTMLElementTagNameMap[tag] = HTMLElement
+ */
+type NonSpecialTags = {
+  [K in keyof HTMLElementTagNameMap]: HTMLElement extends HTMLElementTagNameMap[K] ? K : never;
+}[keyof HTMLElementTagNameMap];
+
+/**
+ * This is tested on 15 browsers (most popular ones)
+ * - appending a text node to these tags takes no effect.
+ *   - No effect means `innerText` does not include the text in the text node.
+ * @see {@link src/core/h/no-text-node.ts}
+ */
+type NoTextNodeTag =
+  | 'area'
+  | 'audio'
+  | 'base'
+  | 'basefont'
+  | 'br'
+  | 'canvas'
+  | 'datalist'
+  | 'details'
+  | 'dialog'
+  | 'frameset'
+  | 'head'
+  | 'iframe'
+  | 'img'
+  | 'input'
+  | 'link'
+  | 'meta'
+  | 'meter'
+  | 'noembed'
+  | 'noframes'
+  | 'noscript'
+  | 'optgroup'
+  | 'param'
+  | 'progress'
+  | 'rp'
+  | 'select'
+  | 'style'
+  | 'template'
+  | 'textarea'
+  | 'title'
+  | 'video'
+  | 'wbr'
+  | 'embed'
+  | 'frame'
+  | 'keygen'
+  | 'option';
+
+/**
+ * These fields of HTMLElement can trigger `change`.
+ */
+type ChangeTriggerField = 'value' | 'checked' | 'selected' | 'valueAsDate' | 'valueAsNumber';
+
+type InputElementTag = 'input' | 'select' | 'textarea';
+
+declare const $isNode: (x: any) => x is ChildNode;
+/**
+ * Safe replace `oldNode` With `newNode`
+ * - This function is not used everywhere. Because there is no need to check every time.
+ */
+declare const $replaceNode: (oldNode: unknown, newNode: unknown) => void;
+declare const $parseStyle: (style: unknown) => string;
+type ChangeHandler<T = string> = (value: T, ...args: any[]) => void;
+/**
+ * Used for `k-model`
+ */
+declare const $applyModel: (element: HTMLElementTagNameMap[InputElementTag], valueRef: {
+    value: unknown;
+    addOnChange: (fn: (newValue: unknown) => void) => void;
+}, propName: "value" | "checked", eventName: "change" | "input") => void;
+
+/**
+ * Default empty function
+ */
+declare const $emptyFn: (...args: any[]) => any;
+declare const $emptyArray: any[];
+declare const $emptyObject: any;
+/**
+ * SameValueZero comparison, similar to `Object.is` but treats `+0 === -0`
+ */
+declare const $SameValueZero: (x: unknown, y: unknown) => boolean;
+/**
+ * Safe and quick forEach implementation that works with array-like objects and handles sparse arrays.
+ */
+declare const $forEach: (array: unknown[], callback: (item: unknown, index: number, array: unknown[]) => void) => void;
+/**
+ * Async version of $forEach that allows for asynchronous callbacks. It processes items sequentially, awaiting each callback before moving to the next.
+ */
+declare const $forEachAsync: (array: unknown[], callback: (item: unknown, index: number, array: unknown[]) => void) => Promise<void>;
+
+/**
+ * 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;
+
+interface KTReactiveLike<T = unknown> {
+  isKT: true;
+  value: T;
+  addOnChange(fn: (newValue: T, oldValue: T) => void): void;
+  removeOnChange?(fn: (newValue: T, oldValue: T) => void): boolean;
+}
+
+export { $ArrayFrom, $SameValueZero, $applyModel, $assign, $define, $defines, $emptyArray, $emptyFn, $emptyObject, $entries, $forEach, $forEachAsync, $hasOwn, $is, $isArray, $isNode, $isThenable, $keys, $parseStyle, $random, $replaceNode, $toString, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
+export type { ChangeHandler, ChangeTriggerField, HTMLJSXTag, HTMLTag, InputElementTag, JSXTag, KTReactiveLike, MathMLJSXTag, MathMLTag, NoTextNodeTag, NonSpecialTags, SVGJSXTag, SVGTag, otherstring };

package/dist/index.mjs

@@ -1,3 +1,4 @@
+// Cached native methods for performance optimization
 const $isArray = Array.isArray;
 const $ArrayFrom = Array.from;
 const $is = Object.is;
@@ -9,152 +10,166 @@ const $defines = Object.defineProperties;
 const $define = Object.defineProperty;
 const $entries = Object.entries;
 const $random = Math.random;
-const $isThenable = (o) => typeof o?.then === "function";
+const $isThenable = (o) => typeof o?.then === 'function';
 
-if (typeof Symbol === "undefined") {
-  window.Symbol = function Symbol2(description) {
-    return `@@SYMBOL_${description || ""}_${$random().toString(36).slice(2)}`;
-  };
+if (typeof Symbol === 'undefined') {
+    window.Symbol = function Symbol(description) {
+        return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;
+    };
 }
 
+// DOM manipulation utilities
+// # dom natives
 const $isNode = (x) => x?.nodeType > 0;
+/**
+ * Safe replace `oldNode` With `newNode`
+ * - This function is not used everywhere. Because there is no need to check every time.
+ */
 const $replaceNode = (oldNode, newNode) => {
-  if ($isNode(oldNode) && $isNode(newNode)) {
-    if (newNode.contains(oldNode)) {
-      newNode.remove();
-    }
-    oldNode.replaceWith(newNode);
-  }
-};
-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);
+    if ($isNode(oldNode) && $isNode(newNode)) {
+        if (newNode.contains(oldNode)) {
+            newNode.remove();
         }
-      }
-      $appendChild.call(this, fragment);
+        oldNode.replaceWith(newNode);
     }
-  }
-);
-const { get: $buttonDisabledGetter, set: $buttonDisabledSetter } = Object.getOwnPropertyDescriptor(
-  HTMLButtonElement.prototype,
-  "disabled"
-);
+};
+// # DOM utilities
+// Same as it is in @ktjs/core
 const $parseStyle = (style) => {
-  if (!style) {
-    return "";
-  }
-  if (typeof style === "string") {
-    return style;
-  }
-  if (style && typeof style === "object") {
-    if (style.isKT) {
-      return $parseStyle(style.value);
+    if (!style) {
+        return '';
+    }
+    if (typeof style === 'string') {
+        return style;
     }
-    return $entries(style).map((entry) => {
-      const cssKey = entry[0].replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
-      return `${cssKey}:${entry[1]}`;
-    }).join(";");
-  }
-  return "";
+    // already !style === false
+    if (typeof style === 'object') {
+        if (style.isKT) {
+            return $parseStyle(style.value);
+        }
+        return $entries(style)
+            .map((entry) => {
+            const cssKey = entry[0].replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+            return `${cssKey}:${entry[1]}`;
+        })
+            .join(';');
+    }
+    return '';
 };
+/**
+ * Used for `k-model`
+ */
 const $applyModel = (element, valueRef, propName, eventName) => {
-  element[propName] = valueRef.value;
-  valueRef.addOnChange((newValue) => element[propName] = newValue);
-  element.addEventListener(eventName, () => valueRef.value = element[propName]);
+    element[propName] = valueRef.value; // initialize
+    valueRef.addOnChange((newValue) => (element[propName] = newValue));
+    element.addEventListener(eventName, () => (valueRef.value = element[propName]));
 };
 
+// String manipulation utilities
+/**
+ * Default empty function
+ */
 const $emptyFn = (() => true);
 const $emptyArray = [];
-const $emptyObject = /* @__PURE__ */ Object.create(null);
-const $isSame = (a, b) => {
-  if ($isArray(a)) {
-    return true;
-  }
-  return $is(a, b);
-};
+const $emptyObject = Object.create(null);
+/**
+ * SameValueZero comparison, similar to `Object.is` but treats `+0 === -0`
+ */
+const $SameValueZero = (x, y) => (x !== x && y !== y) || x === y;
+/**
+ * Safe and quick forEach implementation that works with array-like objects and handles sparse arrays.
+ */
 const $forEach = (array, callback) => {
-  const len = array.length;
-  for (let i = 0; i < len; i++) {
-    callback(array[i], i, array);
-  }
+    const len = array.length;
+    for (let i = 0; i < len; i++) {
+        callback(array[i], i, array);
+    }
 };
+/**
+ * Async version of $forEach that allows for asynchronous callbacks. It processes items sequentially, awaiting each callback before moving to the next.
+ */
 const $forEachAsync = async (array, callback) => {
-  const len = array.length;
-  for (let i = 0; i < len; i++) {
-    await callback(array[i], i, array);
-  }
+    const len = array.length;
+    for (let i = 0; i < len; i++) {
+        await callback(array[i], i, array);
+    }
 };
 
+/**
+ * Normalize path by joining parts and ensuring leading slash
+ */
 const normalizePath = (...paths) => {
-  const p = paths.map((p2) => p2.split("/")).flat().filter(Boolean);
-  return "/" + p.join("/");
+    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) : "";
+    const query = {};
+    if (!queryString || queryString === '?') {
+        return query;
     }
-  }
-  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}`;
+    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;
+    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;
+    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;
+    return params;
 };
 
-Object.defineProperty(window, "__ktjs__", { value: "0.23.17" });
+// incase that symbol is not supported
+Object.defineProperty(window, '__ktjs__', { value: '0.23.19' });
 
-export { $ArrayFrom, $append, $appendChild, $applyModel, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyArray, $emptyFn, $emptyObject, $entries, $forEach, $forEachAsync, $hasOwn, $is, $isArray, $isNode, $isSame, $isThenable, $keys, $parseStyle, $random, $replaceNode, $toString, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
+export { $ArrayFrom, $SameValueZero, $applyModel, $assign, $define, $defines, $emptyArray, $emptyFn, $emptyObject, $entries, $forEach, $forEachAsync, $hasOwn, $is, $isArray, $isNode, $isThenable, $keys, $parseStyle, $random, $replaceNode, $toString, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/utils/native.ts","../src/misc/symbol-polyfill.ts","../src/utils/dom.ts","../src/utils/misc.ts","../src/utils/url.ts","../src/index.ts"],"sourcesContent":["// Cached native methods for performance optimization\n\nexport const $isArray = Array.isArray;\nexport const $ArrayFrom = Array.from;\n\nexport const $is = Object.is;\nexport const $assign = Object.assign;\nexport const $hasOwn = Object.prototype.hasOwnProperty;\nexport const $toString = Object.prototype.toString;\n\nexport const $keys = Object.keys as <T>(o: T) => Array<keyof T>;\nexport const $defines = Object.defineProperties;\nexport const $define = Object.defineProperty;\nexport const $entries = Object.entries as <T>(o: T) => Array<[keyof T, T[keyof T]]>;\n\nexport const $random = Math.random;\n\nexport const $isThenable = (o: any): o is Promise<any> => typeof o?.then === 'function';\n","import { $random } from '../utils/native.js';\n\nexport {};\nif (typeof Symbol === 'undefined') {\n  (window as any).Symbol = function Symbol(description?: string) {\n    return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;\n  };\n}\n","// DOM manipulation utilities\n\nimport type { KTReactiveLike } from '../types/misc.js';\nimport type { InputElementTag } from '../types/global.js';\nimport { $entries } from './native.js';\n\n// # dom natives\n\nexport const $isNode = (x: any): x is ChildNode => x?.nodeType > 0;\n\n/**\n * Safe replace `oldNode` With `newNode`\n * - This function is not used everywhere. Because there is no need to check every time.\n */\nexport const $replaceNode = (oldNode: unknown, newNode: unknown) => {\n  if ($isNode(oldNode) && $isNode(newNode)) {\n    if (newNode.contains(oldNode)) {\n      newNode.remove();\n    }\n    oldNode.replaceWith(newNode);\n  }\n};\n\n// # DOM utilities\n\n// Same as it is in @ktjs/core\nexport const $parseStyle = (style: unknown): string => {\n  if (!style) {\n    return '';\n  }\n  if (typeof style === 'string') {\n    return style;\n  }\n\n  // already !style === false\n  if (typeof style === 'object') {\n    if ((style as KTReactiveLike).isKT) {\n      return $parseStyle((style as KTReactiveLike).value);\n    }\n\n    return $entries(style)\n      .map((entry: [string, string]) => {\n        const cssKey = entry[0].replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);\n        return `${cssKey}:${entry[1]}`;\n      })\n      .join(';');\n  }\n  return '';\n};\n\nexport type ChangeHandler<T = string> = (value: T, ...args: any[]) => void;\n\n/**\n * Used for `k-model`\n */\nexport const $applyModel = (\n  element: HTMLElementTagNameMap[InputElementTag],\n  valueRef: { value: unknown; addOnChange: (fn: (newValue: unknown) => void) => void },\n  propName: 'value' | 'checked',\n  eventName: 'change' | 'input',\n) => {\n  (element as any)[propName] = valueRef.value; // initialize\n  valueRef.addOnChange((newValue) => ((element as any)[propName] = newValue));\n  element.addEventListener(eventName, () => (valueRef.value = (element as any)[propName]));\n};\n","// String manipulation utilities\n\nimport { $is, $isArray } from './native.js';\n\n/**\n * Default empty function\n */\nexport const $emptyFn = (() => true) as (...args: any[]) => any;\nexport const $emptyArray: any[] = [];\nexport const $emptyObject = Object.create(null);\n\n/**\n * SameValueZero comparison, similar to `Object.is` but treats `+0 === -0`\n */\nexport const $SameValueZero = (x: unknown, y: unknown): boolean => (x !== x && y !== y) || x === y;\n\n/**\n * Safe and quick forEach implementation that works with array-like objects and handles sparse arrays.\n */\nexport const $forEach = (\n  array: unknown[],\n  callback: (item: unknown, index: number, array: unknown[]) => void,\n): void => {\n  const len = array.length;\n  for (let i = 0; i < len; i++) {\n    callback(array[i], i, array);\n  }\n};\n\n/**\n * Async version of $forEach that allows for asynchronous callbacks. It processes items sequentially, awaiting each callback before moving to the next.\n */\nexport const $forEachAsync = async (\n  array: unknown[],\n  callback: (item: unknown, index: number, array: unknown[]) => void,\n): Promise<void> => {\n  const len = array.length;\n  for (let i = 0; i < len; i++) {\n    await callback(array[i], i, array);\n  }\n};\n","/**\n * Normalize path by joining parts and ensuring leading slash\n */\nexport const normalizePath = (...paths: string[]) => {\n  const p = paths\n    .map((p) => p.split('/'))\n    .flat()\n    .filter(Boolean);\n  return '/' + p.join('/');\n};\n\n/**\n * Parse query string into object\n */\nexport const parseQuery = (queryString: string): Record<string, string> => {\n  const query: Record<string, string> = {};\n  if (!queryString || queryString === '?') {\n    return query;\n  }\n\n  const params = queryString.replace(/^\\?/, '').split('&');\n  for (const param of params) {\n    const [key, value] = param.split('=');\n    if (key) {\n      query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';\n    }\n  }\n  return query;\n};\n\n/**\n * Build query string from object\n */\nexport const buildQuery = (query: Record<string, string>): string => {\n  const keys = Object.keys(query);\n  if (keys.length === 0) return '';\n\n  const params = keys.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(query[key])}`).join('&');\n  return `?${params}`;\n};\n\n/**\n * Substitute params into path pattern\n * @example '/user/:id' + {id: '123'} => '/user/123'\n */\nexport const emplaceParams = (path: string, params: Record<string, string>): string => {\n  let result = path;\n  for (const key in params) {\n    result = result.replace(`:${key}`, params[key]);\n  }\n  return result;\n};\n\n/**\n * Extract dynamic params from path using pattern\n * @example pattern: '/user/:id', path: '/user/123' => {id: '123'}\n */\nexport const extractParams = (pattern: string, path: string): Record<string, string> | null => {\n  const params: Record<string, string> = {};\n  const patternParts = pattern.split('/');\n  const pathParts = path.split('/');\n\n  if (patternParts.length !== pathParts.length) {\n    return null;\n  }\n\n  for (let i = 0; i < patternParts.length; i++) {\n    const patternPart = patternParts[i];\n    const pathPart = pathParts[i];\n\n    if (patternPart.startsWith(':')) {\n      const paramName = patternPart.slice(1);\n      params[paramName] = pathPart;\n    } else if (patternPart !== pathPart) {\n      return null;\n    }\n  }\n\n  return params;\n};\n","// incase that symbol is not supported\nimport './misc/symbol-polyfill.js';\n\nexport * from './misc/comment.js';\nexport * from './utils/native.js';\nexport * from './utils/dom.js';\nexport * from './utils/misc.js';\nexport * from './utils/url.js';\n\nexport type * from './types/global.js';\nexport type * from './types/misc.js';\n\nObject.defineProperty(window, '__ktjs__', { value: '__VERSION__' });\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@ktjs/shared",
-  "version": "0.23.17",
+  "version": "0.23.19",
   "description": "Shared utilities and cached native methods for kt.js framework",
+  "description_zh": "kt.js 框架的共享工具与原生方法缓存。",
   "type": "module",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",