@ktjs/shared 0.22.5 → 0.22.7

package/dist/index.d.ts

@@ -40,6 +40,8 @@ declare const $isThenable: (o: any) => o is Promise<any>;
  */
 declare const $throw: (message: string) => never;
 declare const $warn: (message: string) => void;
+declare const $error: (message: string) => void;
+declare const $debug: (message: string) => void;
 
 type otherstring = string & {};
 
@@ -107,7 +109,11 @@ type ChangeTriggerField = 'value' | 'checked' | 'selected' | 'valueAsDate' | 'va
 
 type InputElementTag = 'input' | 'select' | 'textarea';
 
-declare const $isNode: (x: any) => boolean;
+declare const $isNode: (x: any) => x is ChildNode;
+/**
+ * Safe replace `oldNode` With `newNode`
+ */
+declare const $replaceNode: (oldNode: unknown, newNode: unknown) => void;
 /**
  * & Remove `bind` because it is shockingly slower than wrapper
  * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -119,7 +125,6 @@ declare const $buttonDisabledGetter: () => any;
 declare const $buttonDisabledSetter: (v: any) => void;
 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>;
 /**
  * Used for `k-model`
  */
@@ -132,6 +137,7 @@ declare const applyModel: (element: HTMLElementTagNameMap[InputElementTag], valu
  * Default empty function
  */
 declare const $emptyFn: (...args: any[]) => any;
+declare const $isSame: (a: unknown, b: unknown) => boolean;
 
 /**
  * Normalize path by joining parts and ensuring leading slash
@@ -156,5 +162,5 @@ declare const emplaceParams: (path: string, params: Record<string, string>) => s
  */
 declare const extractParams: (pattern: string, path: string) => Record<string, string> | null;
 
-export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isNode, $isThenable, $keys, $random, $throw, $toString, $warn, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, applyModel, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
+export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $debug, $define, $defines, $emptyFn, $entries, $error, $hasOwn, $is, $isArray, $isNode, $isSame, $isThenable, $keys, $random, $replaceNode, $throw, $toString, $warn, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, applyModel, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery, parseStyle };
 export type { ChangeHandler, ChangeTriggerField, HTMLTag, InputElementTag, MathMLTag, NoTextNodeTag, NonSpecialTags, SVGTag, otherstring };

package/dist/index.iife.js

@@ -41,16 +41,27 @@ var __ktjs_shared__ = (function (exports) {
     const $warn = (message) => {
         console.warn('[kt.js warn] ' + message);
     };
-
-    // String manipulation utilities
-    /**
-     * Default empty function
-     */
-    const $emptyFn = (() => true);
+    const $error = (message) => {
+        console.error('[kt.js error] ' + message);
+    };
+    const $debug = (message) => {
+        console.debug('[kt.js debug] ' + message);
+    };
 
     // DOM manipulation utilities
     // # dom natives
     const $isNode = (x) => x?.nodeType > 0;
+    /**
+     * Safe replace `oldNode` With `newNode`
+     */
+    const $replaceNode = (oldNode, newNode) => {
+        if ($isNode(oldNode) && $isNode(newNode)) {
+            if (newNode.contains(oldNode)) {
+                newNode.remove();
+            }
+            oldNode.replaceWith(newNode);
+        }
+    };
     /**
      * & Remove `bind` because it is shockingly slower than wrapper
      * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -103,16 +114,6 @@ var __ktjs_shared__ = (function (exports) {
         }
         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;
-    };
     /**
      * Used for `k-model`
      */
@@ -122,6 +123,18 @@ var __ktjs_shared__ = (function (exports) {
         element.addEventListener(eventName, () => (valueRef.value = element[propName]));
     };
 
+    // String manipulation utilities
+    /**
+     * Default empty function
+     */
+    const $emptyFn = (() => true);
+    const $isSame = (a, b) => {
+        if ($isArray(a)) {
+            return true; // always trigger an array
+        }
+        return $is(a, b);
+    };
+
     /**
      * Normalize path by joining parts and ensuring leading slash
      */
@@ -202,7 +215,7 @@ var __ktjs_shared__ = (function (exports) {
     }
 
     // Shared utilities and cached native methods for kt.js framework
-    Object.defineProperty(window, '__ktjs__', { value: '0.22.5' });
+    Object.defineProperty(window, '__ktjs__', { value: '0.22.7' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -210,17 +223,21 @@ var __ktjs_shared__ = (function (exports) {
     exports.$assign = $assign;
     exports.$buttonDisabledGetter = $buttonDisabledGetter;
     exports.$buttonDisabledSetter = $buttonDisabledSetter;
+    exports.$debug = $debug;
     exports.$define = $define;
     exports.$defines = $defines;
     exports.$emptyFn = $emptyFn;
     exports.$entries = $entries;
+    exports.$error = $error;
     exports.$hasOwn = $hasOwn;
     exports.$is = $is;
     exports.$isArray = $isArray;
     exports.$isNode = $isNode;
+    exports.$isSame = $isSame;
     exports.$isThenable = $isThenable;
     exports.$keys = $keys;
     exports.$random = $random;
+    exports.$replaceNode = $replaceNode;
     exports.$throw = $throw;
     exports.$toString = $toString;
     exports.$warn = $warn;
@@ -231,7 +248,6 @@ var __ktjs_shared__ = (function (exports) {
     exports.buildQuery = buildQuery;
     exports.emplaceParams = emplaceParams;
     exports.extractParams = extractParams;
-    exports.generateHandler = generateHandler;
     exports.normalizePath = normalizePath;
     exports.parseQuery = parseQuery;
     exports.parseStyle = parseStyle;

package/dist/index.legacy.js

@@ -41,17 +41,28 @@ var __ktjs_shared__ = (function (exports) {
     var $warn = function (message) {
         console.warn('[kt.js warn] ' + message);
     };
-
-    // String manipulation utilities
-    /**
-     * Default empty function
-     */
-    var $emptyFn = (function () { return true; });
+    var $error = function (message) {
+        console.error('[kt.js error] ' + message);
+    };
+    var $debug = function (message) {
+        console.debug('[kt.js debug] ' + message);
+    };
 
     // DOM manipulation utilities
     var _a;
     // # dom natives
     var $isNode = function (x) { return (x === null || x === void 0 ? void 0 : x.nodeType) > 0; };
+    /**
+     * Safe replace `oldNode` With `newNode`
+     */
+    var $replaceNode = function (oldNode, newNode) {
+        if ($isNode(oldNode) && $isNode(newNode)) {
+            if (newNode.contains(oldNode)) {
+                newNode.remove();
+            }
+            oldNode.replaceWith(newNode);
+        }
+    };
     /**
      * & Remove `bind` because it is shockingly slower than wrapper
      * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -109,16 +120,6 @@ var __ktjs_shared__ = (function (exports) {
         }
         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;
-    };
     /**
      * Used for `k-model`
      */
@@ -128,6 +129,18 @@ var __ktjs_shared__ = (function (exports) {
         element.addEventListener(eventName, function () { return (valueRef.value = element[propName]); });
     };
 
+    // String manipulation utilities
+    /**
+     * Default empty function
+     */
+    var $emptyFn = (function () { return true; });
+    var $isSame = function (a, b) {
+        if ($isArray(a)) {
+            return true; // always trigger an array
+        }
+        return $is(a, b);
+    };
+
     /**
      * Normalize path by joining parts and ensuring leading slash
      */
@@ -213,7 +226,7 @@ var __ktjs_shared__ = (function (exports) {
     }
 
     // Shared utilities and cached native methods for kt.js framework
-    Object.defineProperty(window, '__ktjs__', { value: '0.22.5' });
+    Object.defineProperty(window, '__ktjs__', { value: '0.22.7' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -221,17 +234,21 @@ var __ktjs_shared__ = (function (exports) {
     exports.$assign = $assign;
     exports.$buttonDisabledGetter = $buttonDisabledGetter;
     exports.$buttonDisabledSetter = $buttonDisabledSetter;
+    exports.$debug = $debug;
     exports.$define = $define;
     exports.$defines = $defines;
     exports.$emptyFn = $emptyFn;
     exports.$entries = $entries;
+    exports.$error = $error;
     exports.$hasOwn = $hasOwn;
     exports.$is = $is;
     exports.$isArray = $isArray;
     exports.$isNode = $isNode;
+    exports.$isSame = $isSame;
     exports.$isThenable = $isThenable;
     exports.$keys = $keys;
     exports.$random = $random;
+    exports.$replaceNode = $replaceNode;
     exports.$throw = $throw;
     exports.$toString = $toString;
     exports.$warn = $warn;
@@ -242,7 +259,6 @@ var __ktjs_shared__ = (function (exports) {
     exports.buildQuery = buildQuery;
     exports.emplaceParams = emplaceParams;
     exports.extractParams = extractParams;
-    exports.generateHandler = generateHandler;
     exports.normalizePath = normalizePath;
     exports.parseQuery = parseQuery;
     exports.parseStyle = parseStyle;

package/dist/index.mjs

@@ -38,16 +38,27 @@ const $throw = (message) => {
 const $warn = (message) => {
     console.warn('[kt.js warn] ' + message);
 };
-
-// String manipulation utilities
-/**
- * Default empty function
- */
-const $emptyFn = (() => true);
+const $error = (message) => {
+    console.error('[kt.js error] ' + message);
+};
+const $debug = (message) => {
+    console.debug('[kt.js debug] ' + message);
+};
 
 // DOM manipulation utilities
 // # dom natives
 const $isNode = (x) => x?.nodeType > 0;
+/**
+ * Safe replace `oldNode` With `newNode`
+ */
+const $replaceNode = (oldNode, newNode) => {
+    if ($isNode(oldNode) && $isNode(newNode)) {
+        if (newNode.contains(oldNode)) {
+            newNode.remove();
+        }
+        oldNode.replaceWith(newNode);
+    }
+};
 /**
  * & Remove `bind` because it is shockingly slower than wrapper
  * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -100,16 +111,6 @@ const parseStyle = (style) => {
     }
     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;
-};
 /**
  * Used for `k-model`
  */
@@ -119,6 +120,18 @@ const applyModel = (element, valueRef, propName, eventName) => {
     element.addEventListener(eventName, () => (valueRef.value = element[propName]));
 };
 
+// String manipulation utilities
+/**
+ * Default empty function
+ */
+const $emptyFn = (() => true);
+const $isSame = (a, b) => {
+    if ($isArray(a)) {
+        return true; // always trigger an array
+    }
+    return $is(a, b);
+};
+
 /**
  * Normalize path by joining parts and ensuring leading slash
  */
@@ -199,6 +212,6 @@ if (typeof Symbol === 'undefined') {
 }
 
 // Shared utilities and cached native methods for kt.js framework
-Object.defineProperty(window, '__ktjs__', { value: '0.22.5' });
+Object.defineProperty(window, '__ktjs__', { value: '0.22.7' });
 
-export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isNode, $isThenable, $keys, $random, $throw, $toString, $warn, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, applyModel, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
+export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $debug, $define, $defines, $emptyFn, $entries, $error, $hasOwn, $is, $isArray, $isNode, $isSame, $isThenable, $keys, $random, $replaceNode, $throw, $toString, $warn, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, applyModel, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery, parseStyle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktjs/shared",
-  "version": "0.22.5",
+  "version": "0.22.7",
   "description": "Shared utilities and cached native methods for kt.js framework",
   "type": "module",
   "module": "./dist/index.mjs",