@ktjs/shared 0.23.6 → 0.23.10

package/dist/index.d.ts

@@ -1,3 +1,17 @@
+declare global {
+    /**
+     * Extend Comment interface to include properties for fragment handling.
+     */
+    interface Comment {
+        kisFragmentAnchor: boolean;
+        kFragmentList: Node[];
+        kredraw: () => void;
+        kchildrenRef: {
+            value: any[];
+        };
+    }
+}
+
 /**
  * Mark the attribute as SVG to handle special cases during rendering.
  */
@@ -128,6 +142,8 @@ declare const $applyModel: (element: HTMLElementTagNameMap[InputElementTag], val
  * Default empty function
  */
 declare const $emptyFn: (...args: any[]) => any;
+declare const $emptyArray: any[];
+declare const $emptyObject: any;
 declare const $isSame: (a: unknown, b: unknown) => boolean;
 /**
  * Safe and quick forEach implementation that works with array-like objects and handles sparse arrays.
@@ -173,5 +189,5 @@ declare global {
   const $debug: typeof console.debug;
 }
 
-export { $ArrayFrom, $append, $appendChild, $applyModel, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $forEach, $forEachAsync, $hasOwn, $is, $isArray, $isNode, $isSame, $isThenable, $keys, $parseStyle, $random, $replaceNode, $toString, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
+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, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
 export type { ChangeHandler, ChangeTriggerField, HTMLTag, InputElementTag, MathMLTag, NoTextNodeTag, NonSpecialTags, SVGTag, otherstring };

package/dist/index.iife.js

@@ -1,6 +1,65 @@
 var __ktjs_shared__ = (function (exports) {
     'use strict';
 
+    // Cached native methods for performance optimization
+    const $isArray = Array.isArray;
+    const $ArrayFrom = Array.from;
+    const $is = Object.is;
+    const $assign = Object.assign;
+    const $hasOwn = Object.prototype.hasOwnProperty;
+    const $toString = Object.prototype.toString;
+    const $keys = Object.keys;
+    const $defines = Object.defineProperties;
+    const $define = Object.defineProperty;
+    const $entries = Object.entries;
+    const $random = Math.random;
+    const $isThenable = (o) => typeof o?.then === 'function';
+
+    if (typeof Symbol === 'undefined') {
+        window.Symbol = function Symbol(description) {
+            return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;
+        };
+    }
+
+    // String manipulation utilities
+    /**
+     * Default empty function
+     */
+    const $emptyFn = (() => true);
+    const $emptyArray = [];
+    const $emptyObject = Object.create(null);
+    const $isSame = (a, b) => {
+        if ($isArray(a)) {
+            return true; // always trigger an array
+        }
+        return $is(a, b);
+    };
+    /**
+     * 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);
+        }
+    };
+    /**
+     * 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 $emptyChildrenRef = { value: $emptyArray };
+    // each instance shares the same empty array, but it will be replaced when used
+    Comment.prototype.kisFragmentAnchor = false;
+    Comment.prototype.kFragmentList = $emptyArray;
+    Comment.prototype.kredraw = $emptyFn;
+    Comment.prototype.kchildrenRef = $emptyChildrenRef;
+
     // Shared constants
     // Empty for now - can be extended with framework-wide constants
     /**
@@ -16,20 +75,6 @@ var __ktjs_shared__ = (function (exports) {
      */
     const DIRV_TYPE = Symbol('kt-directive-type');
 
-    // Cached native methods for performance optimization
-    const $isArray = Array.isArray;
-    const $ArrayFrom = Array.from;
-    const $is = Object.is;
-    const $assign = Object.assign;
-    const $hasOwn = Object.prototype.hasOwnProperty;
-    const $toString = Object.prototype.toString;
-    const $keys = Object.keys;
-    const $defines = Object.defineProperties;
-    const $define = Object.defineProperty;
-    const $entries = Object.entries;
-    const $random = Math.random;
-    const $isThenable = (o) => typeof o?.then === 'function';
-
     // DOM manipulation utilities
     // # dom natives
     const $isNode = (x) => x?.nodeType > 0;
@@ -109,36 +154,6 @@ 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);
-    };
-    /**
-     * 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);
-        }
-    };
-    /**
-     * 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);
-        }
-    };
-
     /**
      * Normalize path by joining parts and ensuring leading slash
      */
@@ -212,14 +227,8 @@ var __ktjs_shared__ = (function (exports) {
         return params;
     };
 
-    if (typeof Symbol === 'undefined') {
-        window.Symbol = function Symbol(description) {
-            return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;
-        };
-    }
-
-    // Shared utilities and cached native methods for kt.js framework
-    Object.defineProperty(window, '__ktjs__', { value: '0.23.6' });
+    // incase that symbol is not supported
+    Object.defineProperty(window, '__ktjs__', { value: '0.23.10' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -230,7 +239,9 @@ var __ktjs_shared__ = (function (exports) {
     exports.$buttonDisabledSetter = $buttonDisabledSetter;
     exports.$define = $define;
     exports.$defines = $defines;
+    exports.$emptyArray = $emptyArray;
     exports.$emptyFn = $emptyFn;
+    exports.$emptyObject = $emptyObject;
     exports.$entries = $entries;
     exports.$forEach = $forEach;
     exports.$forEachAsync = $forEachAsync;

package/dist/index.legacy.js

@@ -1,21 +1,6 @@
 var __ktjs_shared__ = (function (exports) {
     'use strict';
 
-    // Shared constants
-    // Empty for now - can be extended with framework-wide constants
-    /**
-     * Mark the attribute as SVG to handle special cases during rendering.
-     */
-    var SVG_ATTR_FLAG = '__kt_svg__';
-    /**
-     * Mark the attribute as MathML to handle special cases during rendering.
-     */
-    var MATHML_ATTR_FLAG = '__kt_mathml__';
-    /**
-     * Can be if, else, else-if.
-     */
-    var DIRV_TYPE = Symbol('kt-directive-type');
-
     // Cached native methods for performance optimization
     var $isArray = Array.isArray;
     var $ArrayFrom = Array.from;
@@ -30,89 +15,11 @@ var __ktjs_shared__ = (function (exports) {
     var $random = Math.random;
     var $isThenable = function (o) { return typeof (o === null || o === void 0 ? void 0 : o.then) === 'function'; };
 
-    // 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
-     */
-    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);
-            }
+    if (typeof Symbol === 'undefined') {
+        window.Symbol = function Symbol(description) {
+            return "@@SYMBOL_".concat(description || '', "_").concat($random().toString(36).slice(2));
         };
-    var $buttonDisabledGetter = (_a = Object.getOwnPropertyDescriptor(HTMLButtonElement.prototype, 'disabled'), _a.get), $buttonDisabledSetter = _a.set;
-    var $parseStyle = function (style) {
-        if (!style) {
-            return '';
-        }
-        if (typeof style === 'string') {
-            return style;
-        }
-        if (style && typeof style === 'object') {
-            if (style.isKT) {
-                return $parseStyle(style.value);
-            }
-            return $entries(style)
-                .map(function (entry) {
-                var cssKey = entry[0].replace(/[A-Z]/g, function (m) { return "-".concat(m.toLowerCase()); });
-                return "".concat(cssKey, ":").concat(entry[1]);
-            })
-                .join(';');
-        }
-        return '';
-    };
-    /**
-     * Used for `k-model`
-     */
-    var $applyModel = function (element, valueRef, propName, eventName) {
-        element[propName] = valueRef.value; // initialize
-        valueRef.addOnChange(function (newValue) { return (element[propName] = newValue); });
-        element.addEventListener(eventName, function () { return (valueRef.value = element[propName]); });
-    };
+    }
 
     /******************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -179,6 +86,8 @@ var __ktjs_shared__ = (function (exports) {
      * Default empty function
      */
     var $emptyFn = (function () { return true; });
+    var $emptyArray = [];
+    var $emptyObject = Object.create(null);
     var $isSame = function (a, b) {
         if ($isArray(a)) {
             return true; // always trigger an array
@@ -219,6 +128,112 @@ var __ktjs_shared__ = (function (exports) {
         });
     }); };
 
+    var $emptyChildrenRef = { value: $emptyArray };
+    // each instance shares the same empty array, but it will be replaced when used
+    Comment.prototype.kisFragmentAnchor = false;
+    Comment.prototype.kFragmentList = $emptyArray;
+    Comment.prototype.kredraw = $emptyFn;
+    Comment.prototype.kchildrenRef = $emptyChildrenRef;
+
+    // Shared constants
+    // Empty for now - can be extended with framework-wide constants
+    /**
+     * Mark the attribute as SVG to handle special cases during rendering.
+     */
+    var SVG_ATTR_FLAG = '__kt_svg__';
+    /**
+     * Mark the attribute as MathML to handle special cases during rendering.
+     */
+    var MATHML_ATTR_FLAG = '__kt_mathml__';
+    /**
+     * Can be if, else, else-if.
+     */
+    var DIRV_TYPE = Symbol('kt-directive-type');
+
+    // 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
+     */
+    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);
+            }
+        };
+    var $buttonDisabledGetter = (_a = Object.getOwnPropertyDescriptor(HTMLButtonElement.prototype, 'disabled'), _a.get), $buttonDisabledSetter = _a.set;
+    var $parseStyle = function (style) {
+        if (!style) {
+            return '';
+        }
+        if (typeof style === 'string') {
+            return style;
+        }
+        if (style && typeof style === 'object') {
+            if (style.isKT) {
+                return $parseStyle(style.value);
+            }
+            return $entries(style)
+                .map(function (entry) {
+                var cssKey = entry[0].replace(/[A-Z]/g, function (m) { return "-".concat(m.toLowerCase()); });
+                return "".concat(cssKey, ":").concat(entry[1]);
+            })
+                .join(';');
+        }
+        return '';
+    };
+    /**
+     * Used for `k-model`
+     */
+    var $applyModel = function (element, valueRef, propName, eventName) {
+        element[propName] = valueRef.value; // initialize
+        valueRef.addOnChange(function (newValue) { return (element[propName] = newValue); });
+        element.addEventListener(eventName, function () { return (valueRef.value = element[propName]); });
+    };
+
     /**
      * Normalize path by joining parts and ensuring leading slash
      */
@@ -297,14 +312,8 @@ var __ktjs_shared__ = (function (exports) {
         return params;
     };
 
-    if (typeof Symbol === 'undefined') {
-        window.Symbol = function Symbol(description) {
-            return "@@SYMBOL_".concat(description || '', "_").concat($random().toString(36).slice(2));
-        };
-    }
-
-    // Shared utilities and cached native methods for kt.js framework
-    Object.defineProperty(window, '__ktjs__', { value: '0.23.6' });
+    // incase that symbol is not supported
+    Object.defineProperty(window, '__ktjs__', { value: '0.23.10' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -315,7 +324,9 @@ var __ktjs_shared__ = (function (exports) {
     exports.$buttonDisabledSetter = $buttonDisabledSetter;
     exports.$define = $define;
     exports.$defines = $defines;
+    exports.$emptyArray = $emptyArray;
     exports.$emptyFn = $emptyFn;
+    exports.$emptyObject = $emptyObject;
     exports.$entries = $entries;
     exports.$forEach = $forEach;
     exports.$forEachAsync = $forEachAsync;

package/dist/index.mjs

@@ -1,3 +1,62 @@
+// Cached native methods for performance optimization
+const $isArray = Array.isArray;
+const $ArrayFrom = Array.from;
+const $is = Object.is;
+const $assign = Object.assign;
+const $hasOwn = Object.prototype.hasOwnProperty;
+const $toString = Object.prototype.toString;
+const $keys = Object.keys;
+const $defines = Object.defineProperties;
+const $define = Object.defineProperty;
+const $entries = Object.entries;
+const $random = Math.random;
+const $isThenable = (o) => typeof o?.then === 'function';
+
+if (typeof Symbol === 'undefined') {
+    window.Symbol = function Symbol(description) {
+        return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;
+    };
+}
+
+// String manipulation utilities
+/**
+ * Default empty function
+ */
+const $emptyFn = (() => true);
+const $emptyArray = [];
+const $emptyObject = Object.create(null);
+const $isSame = (a, b) => {
+    if ($isArray(a)) {
+        return true; // always trigger an array
+    }
+    return $is(a, b);
+};
+/**
+ * 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);
+    }
+};
+/**
+ * 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 $emptyChildrenRef = { value: $emptyArray };
+// each instance shares the same empty array, but it will be replaced when used
+Comment.prototype.kisFragmentAnchor = false;
+Comment.prototype.kFragmentList = $emptyArray;
+Comment.prototype.kredraw = $emptyFn;
+Comment.prototype.kchildrenRef = $emptyChildrenRef;
+
 // Shared constants
 // Empty for now - can be extended with framework-wide constants
 /**
@@ -13,20 +72,6 @@ const MATHML_ATTR_FLAG = '__kt_mathml__';
  */
 const DIRV_TYPE = Symbol('kt-directive-type');
 
-// Cached native methods for performance optimization
-const $isArray = Array.isArray;
-const $ArrayFrom = Array.from;
-const $is = Object.is;
-const $assign = Object.assign;
-const $hasOwn = Object.prototype.hasOwnProperty;
-const $toString = Object.prototype.toString;
-const $keys = Object.keys;
-const $defines = Object.defineProperties;
-const $define = Object.defineProperty;
-const $entries = Object.entries;
-const $random = Math.random;
-const $isThenable = (o) => typeof o?.then === 'function';
-
 // DOM manipulation utilities
 // # dom natives
 const $isNode = (x) => x?.nodeType > 0;
@@ -106,36 +151,6 @@ 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);
-};
-/**
- * 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);
-    }
-};
-/**
- * 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);
-    }
-};
-
 /**
  * Normalize path by joining parts and ensuring leading slash
  */
@@ -209,13 +224,7 @@ const extractParams = (pattern, path) => {
     return params;
 };
 
-if (typeof Symbol === 'undefined') {
-    window.Symbol = function Symbol(description) {
-        return `@@SYMBOL_${description || ''}_${$random().toString(36).slice(2)}`;
-    };
-}
-
-// Shared utilities and cached native methods for kt.js framework
-Object.defineProperty(window, '__ktjs__', { value: '0.23.6' });
+// incase that symbol is not supported
+Object.defineProperty(window, '__ktjs__', { value: '0.23.10' });
 
-export { $ArrayFrom, $append, $appendChild, $applyModel, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $forEach, $forEachAsync, $hasOwn, $is, $isArray, $isNode, $isSame, $isThenable, $keys, $parseStyle, $random, $replaceNode, $toString, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };
+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, DIRV_TYPE, MATHML_ATTR_FLAG, SVG_ATTR_FLAG, buildQuery, emplaceParams, extractParams, normalizePath, parseQuery };

package/package.json

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