@ktjs/core 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -16,6 +16,33 @@ interface KTRef<T> {
  */
 declare function ref<T = HTMLElement>(value?: T): KTRef<T>;
 
+type KTHTMLElement = HTMLElement & {
+  /**
+   * Automically generate a redraw function if it is not provided
+   * @param props
+   */
+  redraw: (props?: KTAttribute, children?: KTRawContent) => void;
+};
+
+declare global {
+  namespace JSX {
+    type Element = KTHTMLElement;
+
+    interface IntrinsicElements {
+      [tag: string]: KTAttribute & { children?: KTRawContent };
+    }
+
+    // interface IntrinsicAttributes {
+    //   key?: string | number;
+    // }
+    type IntrinsicAttributes = KTAttribute;
+
+    interface ElementChildrenAttribute {
+      children: {};
+    }
+  }
+}
+
 type KTAvailableContent =
   | KTRef<any>
   | HTMLElement
@@ -42,6 +69,7 @@ interface KTBaseAttribute {
   [k: string]: any;
 
   ref?: KTRef<HTMLElement>;
+  'k-if'?: any;
 
   id?: string;
   class?: string;
@@ -98,15 +126,25 @@ type KTPrefixedEventHandlers = {
   [EventName in keyof HTMLElementEventMap as `on:${EventName}`]?: (ev: HTMLElementEventMap[EventName]) => void;
 };
 
-type KTAttribute = KTBaseAttribute & KTPrefixedEventHandlers;
+type KTSpecialEventHandlers = {
+  'on:ktchange'?: (value: string) => void;
+  'ontrim:ktchange'?: (value: string) => void;
+  'on:ktchangenumber'?: (value: number) => void;
+
+  'on:ktinput'?: (value: string) => void;
+  'ontrim:ktinput'?: (value: string) => void;
+  'on:ktinputnumber'?: (value: number) => void;
+};
+
+type KTAttribute = KTBaseAttribute & KTPrefixedEventHandlers & KTSpecialEventHandlers;
 
 type KTComponent = (
   props: {
-    ref?: KTRef<HTMLElement>;
+    ref?: KTRef<KTHTMLElement>;
     children?: KTRawContent;
   } & KTAttribute &
     any
-) => HTMLElement | Promise<HTMLElement>;
+) => KTHTMLElement | Promise<KTHTMLElement> | any;
 
 type HTML<T extends HTMLTag & otherstring> = T extends HTMLTag ? HTMLElementTagNameMap[T] : HTMLElement;
 type H = (<T extends HTMLTag>(tag: T, attr?: KTRawAttr, content?: KTRawContent) => HTML<T>) & {
@@ -123,7 +161,7 @@ type H = (<T extends HTMLTag>(tag: T, attr?: KTRawAttr, content?: KTRawContent)
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.13.0 (Last Update: 2026.01.15 16:05:51.084)
+ * @version 0.14.0 (Last Update: 2026.01.16 20:08:50.505)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -132,33 +170,6 @@ type H = (<T extends HTMLTag>(tag: T, attr?: KTRawAttr, content?: KTRawContent)
  */
 declare const h: H;
 
-type KTHTMLElement = HTMLElement & {
-  /**
-   * Automically generate a redraw function if it is not provided
-   * @param props
-   */
-  redraw: (props?: KTAttribute, children?: KTRawContent) => void;
-};
-
-declare global {
-  namespace JSX {
-    type Element = KTHTMLElement;
-
-    interface IntrinsicElements {
-      [tag: string]: KTAttribute & { children?: KTRawContent };
-    }
-
-    // interface IntrinsicAttributes {
-    //   key?: string | number;
-    // }
-    type IntrinsicAttributes = KTAttribute;
-
-    interface ElementChildrenAttribute {
-      children: {};
-    }
-  }
-}
-
 type JSXTag = HTMLTag | ((props?: any) => HTMLElement) | ((props?: any) => Promise<HTMLElement>) | ((props?: any) => KTHTMLElement) | ((props?: any) => Promise<KTHTMLElement>);
 /**
  * @param tag html tag or function component
@@ -187,11 +198,11 @@ declare const jsxs: typeof jsx;
  */
 type ExtractComponentProps<T> = T extends (props: infer P) => any ? Omit<P, 'ref' | 'children'> : {};
 declare function KTAsync<T extends KTComponent>(props: {
-    ref?: KTRef<HTMLElement>;
-    skeleton?: HTMLElement;
+    ref?: KTRef<KTHTMLElement>;
+    skeleton?: KTHTMLElement;
     component: T;
     children?: KTRawContent;
-} & ExtractComponentProps<T>): HTMLElement;
+} & ExtractComponentProps<T>): KTHTMLElement;
 
 export { Fragment, KTAsync, h as createElement, h, jsx, jsxDEV, jsxs, ref };
 export type { EventHandler, HTMLTag, KTAttribute, KTHTMLElement, KTRawAttr, KTRawContent, KTRawContents, KTRef };

package/dist/index.iife.js

@@ -5,68 +5,22 @@ var __ktjs_core__ = (function (exports) {
         throw new Error('kt.js: ' + message);
     };
 
-    /**
-     * & 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'
-        ? function (...args) {
-            return originAppend.apply(this, args);
-        }
-        : 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);
-            }
-        };
-
-    const $isArray = Array.isArray;
-    const $keys = Object.keys;
-    const emptyPromiseHandler = () => ({});
-    if (typeof Promise === 'undefined') {
-        window.Promise = { resolve: emptyPromiseHandler, reject: emptyPromiseHandler };
-    }
-    const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
-
-    function booleanHandler(element, key, value) {
+    const booleanHandler = (element, key, value) => {
         if (key in element) {
             element[key] = !!value;
         }
         else {
             element.setAttribute(key, value);
         }
-    }
-    function valueHandler(element, key, value) {
+    };
+    const valueHandler = (element, key, value) => {
         if (key in element) {
             element[key] = value;
         }
         else {
             element.setAttribute(key, value);
         }
-    }
+    };
     // Attribute handlers map for optimized lookup
     const handlers = {
         checked: booleanHandler,
@@ -89,14 +43,25 @@ var __ktjs_core__ = (function (exports) {
         muted: booleanHandler,
         defer: booleanHandler,
         async: booleanHandler,
-        hidden: function (element, _key, value) {
-            element.hidden = !!value;
-        },
+        hidden: (element, _key, value) => (element.hidden = !!value),
     };
-    const defaultHandler = function (element, key, value) {
-        return element.setAttribute(key, value);
+    const ktEventHandlers = {
+        'on:ktchange': (element, handler) => element.addEventListener('change', () => handler(element.value)),
+        'ontrim:ktchange': (element, handler) => element.addEventListener('change', () => handler(element.value.trim())),
+        'on:ktchangenumber': (element, handler) => element.addEventListener('change', () => handler(Number(element.value))),
+        'on:ktinput': (element, handler) => element.addEventListener('input', () => handler(element.value)),
+        'ontrim:ktinput': (element, handler) => element.addEventListener('input', () => handler(element.value.trim())),
+        'on:ktinputnumber': (element, handler) => element.addEventListener('input', () => handler(Number(element.value))),
     };
+
+    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) {
@@ -114,12 +79,17 @@ var __ktjs_core__ = (function (exports) {
             }
             delete attr.style;
         }
-        const keys = $keys(attr);
-        for (let i = keys.length - 1; i >= 0; i--) {
-            const key = keys[i];
+        for (const key in attr) {
             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:')) {
                 element.addEventListener(key.slice(3), o); // chop off the `@`
                 continue;
@@ -137,19 +107,66 @@ var __ktjs_core__ = (function (exports) {
         if (style !== undefined) {
             attr.style = style;
         }
+        return true;
     }
     function applyAttr(element, attr) {
         if (typeof attr === 'string') {
             element.className = attr;
+            return true;
         }
         else if (typeof attr === 'object' && attr !== null) {
-            attrIsObject(element, attr);
+            return attrIsObject(element, attr);
         }
         else {
-            $throw('attr must be an object/string.');
+            throw new Error('kt.js: attr must be an object/string.');
         }
     }
 
+    /**
+     * & 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'
+        ? function (...args) {
+            return originAppend.apply(this, args);
+        }
+        : 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);
+            }
+        };
+
+    const $isArray = Array.isArray;
+    const emptyPromiseHandler = () => ({});
+    if (typeof Promise === 'undefined') {
+        window.Promise = { resolve: emptyPromiseHandler, reject: emptyPromiseHandler };
+    }
+    const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
+
     function apdSingle(element, c) {
         // & JSX should ignore false, undefined, and null
         if (c === false || c === undefined || c === null) {
@@ -206,7 +223,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.13.0 (Last Update: 2026.01.15 16:05:51.084)
+     * @version 0.14.0 (Last Update: 2026.01.16 20:08:50.505)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -220,7 +237,10 @@ var __ktjs_core__ = (function (exports) {
         // * start creating the element
         const element = document.createElement(tag);
         // * Handle content
-        applyAttr(element, attr);
+        const kif = applyAttr(element, attr);
+        if (!kif) {
+            return document.createComment('k-if');
+        }
         applyContent(element, content);
         return element;
     });

package/dist/index.legacy.js

@@ -5,78 +5,22 @@ var __ktjs_core__ = (function (exports) {
         throw new Error('kt.js: ' + message);
     };
 
-    /**
-     * & 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'
-        ? function () {
-            var args = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                args[_i] = arguments[_i];
-            }
-            return originAppend.apply(this, args);
-        }
-        : 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 $isArray = Array.isArray;
-    var $keys = Object.keys;
-    var emptyPromiseHandler = function () { return ({}); };
-    if (typeof Promise === 'undefined') {
-        window.Promise = { resolve: emptyPromiseHandler, reject: emptyPromiseHandler };
-    }
-    var $isThenable = function (o) {
-        return typeof o === 'object' && o !== null && typeof o.then === 'function';
-    };
-
-    function booleanHandler(element, key, value) {
+    var booleanHandler = function (element, key, value) {
         if (key in element) {
             element[key] = !!value;
         }
         else {
             element.setAttribute(key, value);
         }
-    }
-    function valueHandler(element, key, value) {
+    };
+    var valueHandler = function (element, key, value) {
         if (key in element) {
             element[key] = value;
         }
         else {
             element.setAttribute(key, value);
         }
-    }
+    };
     // Attribute handlers map for optimized lookup
     var handlers = {
         checked: booleanHandler,
@@ -99,14 +43,37 @@ var __ktjs_core__ = (function (exports) {
         muted: booleanHandler,
         defer: booleanHandler,
         async: booleanHandler,
-        hidden: function (element, _key, value) {
-            element.hidden = !!value;
-        },
+        hidden: function (element, _key, value) { return (element.hidden = !!value); },
     };
-    var defaultHandler = function (element, key, value) {
-        return element.setAttribute(key, value);
+    var ktEventHandlers = {
+        'on:ktchange': function (element, handler) {
+            return element.addEventListener('change', function () { return handler(element.value); });
+        },
+        'ontrim:ktchange': function (element, handler) {
+            return element.addEventListener('change', function () { return handler(element.value.trim()); });
+        },
+        'on:ktchangenumber': function (element, handler) {
+            return element.addEventListener('change', function () { return handler(Number(element.value)); });
+        },
+        'on:ktinput': function (element, handler) {
+            return element.addEventListener('input', function () { return handler(element.value); });
+        },
+        'ontrim:ktinput': function (element, handler) {
+            return element.addEventListener('input', function () { return handler(element.value.trim()); });
+        },
+        'on:ktinputnumber': function (element, handler) {
+            return element.addEventListener('input', function () { return handler(Number(element.value)); });
+        },
     };
+
+    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) {
@@ -124,12 +91,17 @@ var __ktjs_core__ = (function (exports) {
             }
             delete attr.style;
         }
-        var keys = $keys(attr);
-        for (var i = keys.length - 1; i >= 0; i--) {
-            var key = keys[i];
+        for (var key in attr) {
             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:')) {
                 element.addEventListener(key.slice(3), o); // chop off the `@`
                 continue;
@@ -147,19 +119,76 @@ var __ktjs_core__ = (function (exports) {
         if (style !== undefined) {
             attr.style = style;
         }
+        return true;
     }
     function applyAttr(element, attr) {
         if (typeof attr === 'string') {
             element.className = attr;
+            return true;
         }
         else if (typeof attr === 'object' && attr !== null) {
-            attrIsObject(element, attr);
+            return attrIsObject(element, attr);
         }
         else {
-            $throw('attr must be an object/string.');
+            throw new Error('kt.js: attr must be an object/string.');
         }
     }
 
+    /**
+     * & 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'
+        ? function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            return originAppend.apply(this, args);
+        }
+        : 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 $isArray = Array.isArray;
+    var emptyPromiseHandler = function () { return ({}); };
+    if (typeof Promise === 'undefined') {
+        window.Promise = { resolve: emptyPromiseHandler, reject: emptyPromiseHandler };
+    }
+    var $isThenable = function (o) {
+        return typeof o === 'object' && o !== null && typeof o.then === 'function';
+    };
+
     function apdSingle(element, c) {
         // & JSX should ignore false, undefined, and null
         if (c === false || c === undefined || c === null) {
@@ -219,7 +248,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.13.0 (Last Update: 2026.01.15 16:05:51.084)
+     * @version 0.14.0 (Last Update: 2026.01.16 20:08:50.505)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -235,7 +264,10 @@ var __ktjs_core__ = (function (exports) {
         // * start creating the element
         var element = document.createElement(tag);
         // * Handle content
-        applyAttr(element, attr);
+        var kif = applyAttr(element, attr);
+        if (!kif) {
+            return document.createComment('k-if');
+        }
         applyContent(element, content);
         return element;
     });