@ktjs/core 0.28.1 → 0.28.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { otherstring, HTMLTag, SVGTag, MathMLTag } from '@ktjs/shared';
 export { HTMLTag, InputElementTag, MathMLTag, SVGTag } from '@ktjs/shared';
 
-declare class KTComputed<T> {
+declare class KTComputed<T> implements KTReactive<T> {
     /**
      * Indicates that this is a KTRef instance
      */
@@ -20,7 +20,7 @@ declare class KTComputed<T> {
     /**
      * Computed values are derived from dependencies and should not be mutated manually.
      */
-    mutate<R = void>(_mutator?: (value: T) => R): void;
+    mutate<R = void>(): R;
     /**
      * Register a callback when the value changes
      * @param callback (newValue, oldValue) => xxx
@@ -58,13 +58,6 @@ declare const toReactive: <T>(value: T | KTReactive<T>, onChange?: ReactiveChang
  * Extracts the value from a KTReactive, or returns the value directly if it's not reactive.
  */
 declare function dereactive<T = JSX.Element>(value: T | KTReactive<T>): T;
-type KTReactify<T> = T extends boolean ? KTReactive<boolean> : T extends any ? KTReactive<T> : never;
-type KTReactifyObject<T extends object> = {
-    [K in keyof T]: KTReactify<T[K]>;
-};
-type KTReactifyProps<T extends object> = {
-    [K in keyof T]: KTReactify<Exclude<T[K], undefined>> | T[K];
-};
 
 declare const enum KTReactiveType {
     REF = 1,
@@ -112,7 +105,18 @@ declare class KTReactive<T> {
   removeOnChange(callback: ReactiveChangeHandler<T>): void;
 }
 
-declare class KTRef<T> {
+// & Shockingly, If T is boolean, KTReactify<T> becomes KTReactive<true> | KTReactive<false>. It causes @ktjs/mui that disabledRefs not assignable.
+type KTReactify<T> = T extends boolean ? KTReactive<boolean> : T extends any ? KTReactive<T> : never;
+
+type KTReactifyObject<T extends object> = {
+  [K in keyof T]: KTReactify<T[K]>;
+};
+
+type KTReactifyProps<T extends object> = {
+  [K in keyof T]: KTReactify<Exclude<T[K], undefined>> | T[K];
+};
+
+declare class KTRef<T> implements KTReactive<T> {
     /**
      * Indicates that this is a KTRef instance
      */
@@ -303,7 +307,7 @@ type KTComponent = (
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -1408,7 +1412,7 @@ declare global {
       view: SVGAttributesMap['view'];
     }
 
-    type IntrinsicAttributes = {
+    interface IntrinsicAttributes {
       /**
        * Make a reference to the created element
        */
@@ -1432,7 +1436,7 @@ declare global {
        */
       'k-html'?: any;
       children?: KTRawContent;
-    };
+    }
 
     interface ElementChildrenAttribute {
       children: {};

package/dist/index.iife.js

@@ -536,8 +536,9 @@ var __ktjs_core__ = (function (exports) {
         /**
          * Computed values are derived from dependencies and should not be mutated manually.
          */
-        mutate(_mutator) {
+        mutate() {
             console.warn('[kt.js warn]','KTComputed.mutate: computed is derived automatically; manual mutate is ignored. Use notify() instead');
+            return this._value;
         }
         /**
          * Register a callback when the value changes
@@ -676,7 +677,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+     * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -784,7 +785,7 @@ var __ktjs_core__ = (function (exports) {
     function convertChildrenToElements(children) {
         const elements = [];
         const processChild = (child) => {
-            if (child == null || child === false || child === true) {
+            if (child === undefined || child === null || child === false || child === true) {
                 // Ignore null, undefined, false, true
                 return;
             }

package/dist/index.legacy.js

@@ -539,8 +539,9 @@ var __ktjs_core__ = (function (exports) {
         /**
          * Computed values are derived from dependencies and should not be mutated manually.
          */
-        KTComputed.prototype.mutate = function (_mutator) {
+        KTComputed.prototype.mutate = function () {
             console.warn('[kt.js warn]','KTComputed.mutate: computed is derived automatically; manual mutate is ignored. Use notify() instead');
+            return this._value;
         };
         /**
          * Register a callback when the value changes
@@ -680,7 +681,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+     * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -788,7 +789,7 @@ var __ktjs_core__ = (function (exports) {
     function convertChildrenToElements(children) {
         var elements = [];
         var processChild = function (child) {
-            if (child == null || child === false || child === true) {
+            if (child === undefined || child === null || child === false || child === true) {
                 // Ignore null, undefined, false, true
                 return;
             }

package/dist/index.mjs

@@ -533,8 +533,9 @@ class KTComputed {
     /**
      * Computed values are derived from dependencies and should not be mutated manually.
      */
-    mutate(_mutator) {
+    mutate() {
         console.warn('[kt.js warn]','KTComputed.mutate: computed is derived automatically; manual mutate is ignored. Use notify() instead');
+        return this._value;
     }
     /**
      * Register a callback when the value changes
@@ -673,7 +674,7 @@ let creator = htmlCreator;
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -781,7 +782,7 @@ function Fragment$1(props) {
 function convertChildrenToElements(children) {
     const elements = [];
     const processChild = (child) => {
-        if (child == null || child === false || child === true) {
+        if (child === undefined || child === null || child === false || child === true) {
             // Ignore null, undefined, false, true
             return;
         }

package/dist/jsx/index.d.ts

@@ -1,10 +1,5 @@
 import { otherstring, HTMLTag, SVGTag, MathMLTag } from '@ktjs/shared';
 
-type KTReactify<T> = T extends boolean ? KTReactive<boolean> : T extends any ? KTReactive<T> : never;
-type KTReactifyProps<T extends object> = {
-    [K in keyof T]: KTReactify<Exclude<T[K], undefined>> | T[K];
-};
-
 declare const enum KTReactiveType {
     REF = 1,
     COMPUTED = 2
@@ -48,7 +43,14 @@ declare class KTReactive<T> {
   removeOnChange(callback: ReactiveChangeHandler<T>): void;
 }
 
-declare class KTRef<T> {
+// & Shockingly, If T is boolean, KTReactify<T> becomes KTReactive<true> | KTReactive<false>. It causes @ktjs/mui that disabledRefs not assignable.
+type KTReactify<T> = T extends boolean ? KTReactive<boolean> : T extends any ? KTReactive<T> : never;
+
+type KTReactifyProps<T extends object> = {
+  [K in keyof T]: KTReactify<Exclude<T[K], undefined>> | T[K];
+};
+
+declare class KTRef<T> implements KTReactive<T> {
     /**
      * Indicates that this is a KTRef instance
      */
@@ -189,7 +191,7 @@ type KTAttribute = KTBaseAttribute & KTPrefixedEventAttribute;
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -1294,7 +1296,7 @@ declare global {
       view: SVGAttributesMap['view'];
     }
 
-    type IntrinsicAttributes = {
+    interface IntrinsicAttributes {
       /**
        * Make a reference to the created element
        */
@@ -1318,7 +1320,7 @@ declare global {
        */
       'k-html'?: any;
       children?: KTRawContent;
-    };
+    }
 
     interface ElementChildrenAttribute {
       children: {};

package/dist/jsx/index.mjs

@@ -443,7 +443,7 @@ let creator = htmlCreator;
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -551,7 +551,7 @@ function Fragment$1(props) {
 function convertChildrenToElements(children) {
     const elements = [];
     const processChild = (child) => {
-        if (child == null || child === false || child === true) {
+        if (child === undefined || child === null || child === false || child === true) {
             // Ignore null, undefined, false, true
             return;
         }

package/dist/jsx/jsx-runtime.d.ts

@@ -7,7 +7,43 @@ declare const enum KTReactiveType {
 
 type ReactiveChangeHandler<T> = (newValue: T, oldValue: T) => void;
 
-declare class KTRef<T> {
+declare class KTReactive<T> {
+  /**
+   * Indicates that this is a KTRef instance
+   */
+  isKT: boolean;
+
+  ktType: KTReactiveType;
+
+  /**
+   * If new value and old value are both nodes, the old one will be replaced in the DOM
+   */
+  get value();
+  set value(newValue: T);
+
+  /**
+   * Force all listeners to run even when reference identity has not changed.
+   * Useful for in-place array/object mutations.
+   */
+  notify(): void;
+
+  /**
+   * Mutate current value in-place and notify listeners once.
+   *
+   * @example
+   * const items = ref<number[]>([1, 2]);
+   * items.mutate((list) => list.push(3));
+   */
+  mutate<R = void>(mutator: (currentValue: T) => R): R;
+  /**
+   * Register a callback when the value changes
+   * @param callback (newValue, oldValue) => xxx
+   */
+  addOnChange(callback: ReactiveChangeHandler<T>): void;
+  removeOnChange(callback: ReactiveChangeHandler<T>): void;
+}
+
+declare class KTRef<T> implements KTReactive<T> {
     /**
      * Indicates that this is a KTRef instance
      */
@@ -148,7 +184,7 @@ type KTAttribute = KTBaseAttribute & KTPrefixedEventAttribute;
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!

package/dist/jsx/jsx-runtime.mjs

@@ -443,7 +443,7 @@ let creator = htmlCreator;
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.28.1 (Last Update: 2026.02.10 11:23:01.128)
+ * @version 0.28.2 (Last Update: 2026.02.10 14:46:21.243)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -551,7 +551,7 @@ function Fragment$1(props) {
 function convertChildrenToElements(children) {
     const elements = [];
     const processChild = (child) => {
-        if (child == null || child === false || child === true) {
+        if (child === undefined || child === null || child === false || child === true) {
             // Ignore null, undefined, false, true
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktjs/core",
-  "version": "0.28.1",
+  "version": "0.28.2",
   "description": "Core functionality for kt.js - DOM manipulation utilities with JSX/TSX support",
   "type": "module",
   "module": "./dist/index.mjs",