@ktjs/core 0.14.6 → 0.15.1

package/dist/index.legacy.js

@@ -68,17 +68,11 @@ var __ktjs_core__ = (function (exports) {
 
     var defaultHandler = function (element, key, value) { return element.setAttribute(key, value); };
     function attrIsObject(element, attr) {
-        // & deal k-if first
-        if ('k-if' in attr) {
-            if (!attr['k-if']) {
-                return false;
-            }
-        }
         var classValue = attr.class;
-        var style = attr.style;
         if (classValue !== undefined) {
             element.className = classValue;
         }
+        var style = attr.style;
         if (style) {
             if (typeof style === 'string') {
                 element.setAttribute('style', style);
@@ -90,39 +84,31 @@ var __ktjs_core__ = (function (exports) {
             }
         }
         for (var key in attr) {
-            if (key === 'class' || key === 'style' || key === 'k-if') {
+            if (key === 'class' || key === 'style' || key === 'children' || key === 'k-if' || key === 'ref') {
                 continue;
             }
             var o = attr[key];
-            // force register on:xxx as an event handler
-            // !if o is not valid, the throwing job will be done by `on`, not kt.js
             // # special handling for kt.js specific events
             var ktEvent = ktEventHandlers[key];
             if (ktEvent) {
                 ktEvent(element, o);
-                continue;
             }
-            // # normal event handler
-            if (key.startsWith('on:')) {
+            // normal event handler
+            else if (key.startsWith('on:')) {
                 element.addEventListener(key.slice(3), o); // chop off the `@`
-                continue;
-            }
-            if (typeof o === 'function') {
-                (handlers[key] || defaultHandler)(element, key, o());
             }
+            // normal attributes
             else {
                 (handlers[key] || defaultHandler)(element, key, o);
             }
         }
-        return true;
     }
     function applyAttr(element, attr) {
-        if (typeof attr === 'string') {
-            element.className = attr;
-            return true;
+        if (typeof attr === 'object' && attr !== null) {
+            attrIsObject(element, attr);
         }
-        else if (typeof attr === 'object' && attr !== null) {
-            return attrIsObject(element, attr);
+        else if (typeof attr === 'string') {
+            element.className = attr;
         }
         else {
             throw new Error('kt.js: attr must be an object/string.');
@@ -243,7 +229,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.14.6 (Last Update: 2026.01.17 11:35:33.824)
+     * @version 0.15.1 (Last Update: 2026.01.25 13:09:33.161)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -259,10 +245,7 @@ var __ktjs_core__ = (function (exports) {
         // * start creating the element
         var element = document.createElement(tag);
         // * Handle content
-        var kif = applyAttr(element, attr);
-        if (!kif) {
-            return document.createComment('k-if');
-        }
+        applyAttr(element, attr);
         applyContent(element, content);
         return element;
     });
@@ -300,62 +283,49 @@ var __ktjs_core__ = (function (exports) {
         return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
     };
 
+    /**
+     * Reference to the created HTML element.
+     * - can alse be used to store normal values, but it is not reactive.
+     * @param value mostly an HTMLElement
+     */
+    function ref(value) {
+        return { value: value, isKT: true };
+    }
+
+    var dummyRef = { value: null };
+    // todo 是否进一步削减h函数的分支，比如去掉string为attr的情况
     /**
      * @param tag html tag or function component
      * @param props properties/attributes
      */
     function jsx(tag, props) {
-        var _a;
+        var _a, _b;
         if (props === void 0) { props = {}; }
-        var ref = ((_a = props.ref) === null || _a === void 0 ? void 0 : _a.isKT) ? props.ref : null;
-        if (ref) {
-            delete props.ref;
+        var ref = ((_a = props.ref) === null || _a === void 0 ? void 0 : _a.isKT) ? props.ref : dummyRef;
+        var el;
+        var redraw = function (newProps) {
+            props = newProps ? __assign(__assign({}, props), newProps) : props;
+            var old = el;
+            el = jsx(tag, props);
+            old.replaceWith(el);
+            return el;
+        };
+        if ('k-if' in props && !props['k-if']) {
+            el = document.createComment('k-if');
+            ref.value = el;
+            el.redraw = redraw;
+            return el;
         }
         // Handle function components
         if (typeof tag === 'function') {
-            var el_1 = tag(props);
-            if (!el_1.redraw) {
-                el_1.redraw = function (newProps) {
-                    props = newProps ? __assign(__assign({}, props), newProps) : props;
-                    // $ same as below
-                    var old = el_1;
-                    el_1 = tag(props);
-                    el_1.redraw = old.redraw; // inherit redraw
-                    if (ref) {
-                        ref.value = el_1;
-                    }
-                    old.replaceWith(el_1);
-                    return el_1;
-                };
-            }
-            if (ref) {
-                ref.value = el_1;
-            }
-            return el_1;
+            el = tag(props);
         }
         else {
-            // & deal children here
-            var children_1 = props.children;
-            delete props.children;
-            var el_2 = h(tag, props, children_1);
-            if (ref) {
-                ref.value = el_2;
-            }
-            el_2.redraw = function (newProps, newChildren) {
-                props = newProps ? __assign(__assign({}, props), newProps) : props;
-                children_1 = (newChildren !== null && newChildren !== void 0 ? newChildren : children_1);
-                // $ same as above
-                var old = el_2;
-                el_2 = h(tag, props, children_1);
-                el_2.redraw = old.redraw; // inherit redraw
-                if (ref) {
-                    ref.value = el_2;
-                }
-                old.replaceWith(el_2);
-                return el_2;
-            };
-            return el_2;
+            el = h(tag, props, props.children);
         }
+        (_b = el.redraw) !== null && _b !== void 0 ? _b : (el.redraw = redraw);
+        ref.value = el;
+        return el;
     }
     /**
      * Fragment support - returns an array of children
@@ -408,33 +378,51 @@ var __ktjs_core__ = (function (exports) {
      *    let aa = 10;
      *    // ...
      *    // aa might be changed
-     *    return createRedrawable(() => <div>{aa}</div>);
+     *    return createRedrawableNoref(() => <div>{aa}</div>);
      * }
      * ```
      * Then the returned element has a `redraw` method to redraw itself with new values.
-     * @param creator
+     * @param creator a simple creator function that returns an element
      * @returns created element
      */
-    function createRedrawable(creator) {
-        var element = creator();
+    function createRedrawableNoref(creator) {
+        var el = creator();
         var redraw = function () {
-            var old = element;
-            element = creator();
-            old.replaceWith(element);
-            element.redraw = redraw;
-            return element;
+            var old = el;
+            el = creator();
+            old.replaceWith(el);
+            el.redraw = redraw;
+            return el;
         };
-        element.redraw = redraw;
-        return element;
+        el.redraw = redraw;
+        return el;
     }
-
     /**
-     * Reference to the created HTML element.
-     * - can alse be used to store normal values, but it is not reactive.
-     * @param value mostly an HTMLElement
+     * A helper to create redrawable elements
+     * ```tsx
+     * export function MyComponent() {
+     *    let aa = 10;
+     *    // ...
+     *    // aa might be changed
+     *    return createRedrawable(() => <div>{aa}</div>);
+     * }
+     * ```
+     * Then the returned element has a `redraw` method to redraw itself with new values.
+     * @param creator a simple creator function that returns an element
+     * @returns created element's ref
      */
-    function ref(value) {
-        return { value: value, isKT: true };
+    function createRedrawable(creator) {
+        var elRef = ref();
+        elRef.value = creator();
+        var redraw = function () {
+            var old = elRef.value;
+            elRef.value = creator();
+            old.replaceWith(elRef.value);
+            elRef.value.redraw = redraw;
+            return elRef.value;
+        };
+        elRef.value.redraw = redraw;
+        return elRef;
     }
 
     function KTAsync(props) {
@@ -454,6 +442,7 @@ var __ktjs_core__ = (function (exports) {
     exports.KTAsync = KTAsync;
     exports.createElement = h;
     exports.createRedrawable = createRedrawable;
+    exports.createRedrawableNoref = createRedrawableNoref;
     exports.h = h;
     exports.jsx = jsx;
     exports.jsxDEV = jsxDEV;

package/dist/index.mjs

@@ -53,17 +53,11 @@ const ktEventHandlers = {
 
 const defaultHandler = (element, key, value) => element.setAttribute(key, value);
 function attrIsObject(element, attr) {
-    // & deal k-if first
-    if ('k-if' in attr) {
-        if (!attr['k-if']) {
-            return false;
-        }
-    }
     const classValue = attr.class;
-    const style = attr.style;
     if (classValue !== undefined) {
         element.className = classValue;
     }
+    const style = attr.style;
     if (style) {
         if (typeof style === 'string') {
             element.setAttribute('style', style);
@@ -75,39 +69,31 @@ function attrIsObject(element, attr) {
         }
     }
     for (const key in attr) {
-        if (key === 'class' || key === 'style' || key === 'k-if') {
+        if (key === 'class' || key === 'style' || key === 'children' || key === 'k-if' || key === 'ref') {
             continue;
         }
         const o = attr[key];
-        // force register on:xxx as an event handler
-        // !if o is not valid, the throwing job will be done by `on`, not kt.js
         // # special handling for kt.js specific events
         const ktEvent = ktEventHandlers[key];
         if (ktEvent) {
             ktEvent(element, o);
-            continue;
         }
-        // # normal event handler
-        if (key.startsWith('on:')) {
+        // normal event handler
+        else if (key.startsWith('on:')) {
             element.addEventListener(key.slice(3), o); // chop off the `@`
-            continue;
-        }
-        if (typeof o === 'function') {
-            (handlers[key] || defaultHandler)(element, key, o());
         }
+        // normal attributes
         else {
             (handlers[key] || defaultHandler)(element, key, o);
         }
     }
-    return true;
 }
 function applyAttr(element, attr) {
-    if (typeof attr === 'string') {
-        element.className = attr;
-        return true;
+    if (typeof attr === 'object' && attr !== null) {
+        attrIsObject(element, attr);
     }
-    else if (typeof attr === 'object' && attr !== null) {
-        return attrIsObject(element, attr);
+    else if (typeof attr === 'string') {
+        element.className = attr;
     }
     else {
         throw new Error('kt.js: attr must be an object/string.');
@@ -215,7 +201,7 @@ function applyContent(element, content) {
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.14.6 (Last Update: 2026.01.17 11:35:33.824)
+ * @version 0.15.1 (Last Update: 2026.01.25 13:09:33.161)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -229,68 +215,52 @@ const h = ((tag, attr = '', content = '') => {
     // * start creating the element
     const element = document.createElement(tag);
     // * Handle content
-    const kif = applyAttr(element, attr);
-    if (!kif) {
-        return document.createComment('k-if');
-    }
+    applyAttr(element, attr);
     applyContent(element, content);
     return element;
 });
 
+/**
+ * Reference to the created HTML element.
+ * - can alse be used to store normal values, but it is not reactive.
+ * @param value mostly an HTMLElement
+ */
+function ref(value) {
+    return { value: value, isKT: true };
+}
+
+const dummyRef = { value: null };
+// todo 是否进一步削减h函数的分支，比如去掉string为attr的情况
 /**
  * @param tag html tag or function component
  * @param props properties/attributes
  */
 function jsx(tag, props = {}) {
-    const ref = props.ref?.isKT ? props.ref : null;
-    if (ref) {
-        delete props.ref;
+    const ref = props.ref?.isKT ? props.ref : dummyRef;
+    let el;
+    const redraw = (newProps) => {
+        props = newProps ? { ...props, ...newProps } : props;
+        const old = el;
+        el = jsx(tag, props);
+        old.replaceWith(el);
+        return el;
+    };
+    if ('k-if' in props && !props['k-if']) {
+        el = document.createComment('k-if');
+        ref.value = el;
+        el.redraw = redraw;
+        return el;
     }
     // Handle function components
     if (typeof tag === 'function') {
-        let el = tag(props);
-        if (!el.redraw) {
-            el.redraw = (newProps) => {
-                props = newProps ? { ...props, ...newProps } : props;
-                // $ same as below
-                const old = el;
-                el = tag(props);
-                el.redraw = old.redraw; // inherit redraw
-                if (ref) {
-                    ref.value = el;
-                }
-                old.replaceWith(el);
-                return el;
-            };
-        }
-        if (ref) {
-            ref.value = el;
-        }
-        return el;
+        el = tag(props);
     }
     else {
-        // & deal children here
-        let children = props.children;
-        delete props.children;
-        let el = h(tag, props, children);
-        if (ref) {
-            ref.value = el;
-        }
-        el.redraw = (newProps, newChildren) => {
-            props = newProps ? { ...props, ...newProps } : props;
-            children = (newChildren ?? children);
-            // $ same as above
-            const old = el;
-            el = h(tag, props, children);
-            el.redraw = old.redraw; // inherit redraw
-            if (ref) {
-                ref.value = el;
-            }
-            old.replaceWith(el);
-            return el;
-        };
-        return el;
+        el = h(tag, props, props.children);
     }
+    el.redraw ??= redraw;
+    ref.value = el;
+    return el;
 }
 /**
  * Fragment support - returns an array of children
@@ -339,33 +309,51 @@ const jsxs = jsx;
  *    let aa = 10;
  *    // ...
  *    // aa might be changed
- *    return createRedrawable(() => <div>{aa}</div>);
+ *    return createRedrawableNoref(() => <div>{aa}</div>);
  * }
  * ```
  * Then the returned element has a `redraw` method to redraw itself with new values.
- * @param creator
+ * @param creator a simple creator function that returns an element
  * @returns created element
  */
-function createRedrawable(creator) {
-    let element = creator();
+function createRedrawableNoref(creator) {
+    let el = creator();
     const redraw = () => {
-        const old = element;
-        element = creator();
-        old.replaceWith(element);
-        element.redraw = redraw;
-        return element;
+        const old = el;
+        el = creator();
+        old.replaceWith(el);
+        el.redraw = redraw;
+        return el;
     };
-    element.redraw = redraw;
-    return element;
+    el.redraw = redraw;
+    return el;
 }
-
 /**
- * Reference to the created HTML element.
- * - can alse be used to store normal values, but it is not reactive.
- * @param value mostly an HTMLElement
+ * A helper to create redrawable elements
+ * ```tsx
+ * export function MyComponent() {
+ *    let aa = 10;
+ *    // ...
+ *    // aa might be changed
+ *    return createRedrawable(() => <div>{aa}</div>);
+ * }
+ * ```
+ * Then the returned element has a `redraw` method to redraw itself with new values.
+ * @param creator a simple creator function that returns an element
+ * @returns created element's ref
  */
-function ref(value) {
-    return { value: value, isKT: true };
+function createRedrawable(creator) {
+    const elRef = ref();
+    elRef.value = creator();
+    const redraw = () => {
+        const old = elRef.value;
+        elRef.value = creator();
+        old.replaceWith(elRef.value);
+        elRef.value.redraw = redraw;
+        return elRef.value;
+    };
+    elRef.value.redraw = redraw;
+    return elRef;
 }
 
 function KTAsync(props) {
@@ -380,4 +368,4 @@ function KTAsync(props) {
     return comp;
 }
 
-export { Fragment, KTAsync, h as createElement, createRedrawable, h, jsx, jsxDEV, jsxs, ref };
+export { Fragment, KTAsync, h as createElement, createRedrawable, createRedrawableNoref, h, jsx, jsxDEV, jsxs, ref };

package/dist/jsx/index.d.ts

@@ -16,12 +16,12 @@ interface KTRef<T> {
  */
 declare function ref<T = HTMLElement>(value?: T): KTRef<T>;
 
-type KTHTMLElement = HTMLElement & {
+type KTHTMLElement<El extends HTMLElement = HTMLElement> = El & {
   /**
    * Automically generate a redraw function if it is not provided
    * @param props
    */
-  redraw: (props?: KTAttribute, children?: KTRawContent) => KTHTMLElement;
+  redraw: (props?: KTAttribute, ...args: any[]) => KTHTMLElement;
 };
 
 declare global {
@@ -139,7 +139,7 @@ type H = (<T extends HTMLTag>(tag: T, attr?: KTRawAttr, content?: KTRawContent)
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.14.6 (Last Update: 2026.01.17 11:35:33.824)
+ * @version 0.15.1 (Last Update: 2026.01.25 13:09:33.161)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -178,14 +178,29 @@ declare const jsxs: typeof jsx;
  *    let aa = 10;
  *    // ...
  *    // aa might be changed
- *    return createRedrawable(() => <div>{aa}</div>);
+ *    return createRedrawableNoref(() => <div>{aa}</div>);
  * }
  * ```
  * Then the returned element has a `redraw` method to redraw itself with new values.
- * @param creator
+ * @param creator a simple creator function that returns an element
  * @returns created element
  */
-declare function createRedrawable(creator: () => KTHTMLElement): KTHTMLElement;
+declare function createRedrawableNoref(creator: () => KTHTMLElement): KTHTMLElement;
+/**
+ * A helper to create redrawable elements
+ * ```tsx
+ * export function MyComponent() {
+ *    let aa = 10;
+ *    // ...
+ *    // aa might be changed
+ *    return createRedrawable(() => <div>{aa}</div>);
+ * }
+ * ```
+ * Then the returned element has a `redraw` method to redraw itself with new values.
+ * @param creator a simple creator function that returns an element
+ * @returns created element's ref
+ */
+declare function createRedrawable(creator: () => KTHTMLElement): KTRef<KTHTMLElement>;
 
-export { Fragment, h as createElement, createRedrawable, jsx, jsxDEV, jsxs, ref };
+export { Fragment, h as createElement, createRedrawable, createRedrawableNoref, jsx, jsxDEV, jsxs, ref };
 export type { KTHTMLElement, KTRef };