@ktjs/core 0.14.2 → 0.14.4

package/dist/index.d.ts

@@ -43,16 +43,8 @@ declare global {
   }
 }
 
-type KTAvailableContent =
-  | KTRef<any>
-  | HTMLElement
-  | Element
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | (KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined)[];
+type SingleContent = KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined;
+type KTAvailableContent = SingleContent | SingleContent[] | SingleContent[][];
 type KTRawContent = KTAvailableContent | Promise<KTAvailableContent>;
 type KTRawAttr = KTAttribute | string;
 type KTRawContents = KTAvailableContent;
@@ -143,7 +135,7 @@ type KTComponent = (
     ref?: KTRef<KTHTMLElement>;
     children?: KTRawContent;
   } & KTAttribute &
-    any
+    any,
 ) => KTHTMLElement | Promise<KTHTMLElement> | any;
 
 type HTML<T extends HTMLTag & otherstring> = T extends HTMLTag ? HTMLElementTagNameMap[T] : HTMLElement;
@@ -161,7 +153,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.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -193,6 +185,22 @@ declare const jsxDEV: typeof jsx;
  */
 declare const jsxs: typeof jsx;
 
+/**
+ * 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
+ * @returns created element
+ */
+declare function createRedrawable(creator: () => KTHTMLElement): KTHTMLElement;
+
 /**
  * Extract component props type (excluding ref and children)
  */
@@ -204,5 +212,5 @@ declare function KTAsync<T extends KTComponent>(props: {
     children?: KTRawContent;
 } & ExtractComponentProps<T>): KTHTMLElement;
 
-export { Fragment, KTAsync, h as createElement, h, jsx, jsxDEV, jsxs, ref };
+export { Fragment, KTAsync, h as createElement, createRedrawable, h, jsx, jsxDEV, jsxs, ref };
 export type { EventHandler, HTMLTag, KTAttribute, KTHTMLElement, KTRawAttr, KTRawContent, KTRawContents, KTRef };

package/dist/index.iife.js

@@ -223,7 +223,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.14.2 (Last Update: 2026.01.16 22:23:59.363)
+     * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -340,6 +340,32 @@ var __ktjs_core__ = (function (exports) {
      * This is called when using jsx: "react-jsx" or "react-jsxdev"
      */
     const jsxs = jsx;
+    /**
+     * 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
+     * @returns created element
+     */
+    function createRedrawable(creator) {
+        let element = creator();
+        const redraw = () => {
+            const old = element;
+            element = creator();
+            old.replaceWith(element);
+            element.redraw = redraw;
+            return element;
+        };
+        element.redraw = redraw;
+        return element;
+    }
 
     /**
      * Reference to the created HTML element.
@@ -365,6 +391,7 @@ var __ktjs_core__ = (function (exports) {
     exports.Fragment = Fragment;
     exports.KTAsync = KTAsync;
     exports.createElement = h;
+    exports.createRedrawable = createRedrawable;
     exports.h = h;
     exports.jsx = jsx;
     exports.jsxDEV = jsxDEV;

package/dist/index.legacy.js

@@ -248,7 +248,7 @@ var __ktjs_core__ = (function (exports) {
      * ## About
      * @package @ktjs/core
      * @author Kasukabe Tsumugi <futami16237@gmail.com>
-     * @version 0.14.2 (Last Update: 2026.01.16 22:23:59.363)
+     * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
      * @license MIT
      * @link https://github.com/baendlorel/kt.js
      * @link https://baendlorel.github.io/ Welcome to my site!
@@ -406,6 +406,32 @@ var __ktjs_core__ = (function (exports) {
      * This is called when using jsx: "react-jsx" or "react-jsxdev"
      */
     var jsxs = jsx;
+    /**
+     * 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
+     * @returns created element
+     */
+    function createRedrawable(creator) {
+        var element = creator();
+        var redraw = function () {
+            var old = element;
+            element = creator();
+            old.replaceWith(element);
+            element.redraw = redraw;
+            return element;
+        };
+        element.redraw = redraw;
+        return element;
+    }
 
     /**
      * Reference to the created HTML element.
@@ -432,6 +458,7 @@ var __ktjs_core__ = (function (exports) {
     exports.Fragment = Fragment;
     exports.KTAsync = KTAsync;
     exports.createElement = h;
+    exports.createRedrawable = createRedrawable;
     exports.h = h;
     exports.jsx = jsx;
     exports.jsxDEV = jsxDEV;

package/dist/index.mjs

@@ -220,7 +220,7 @@ function applyContent(element, content) {
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.14.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -337,6 +337,32 @@ const jsxDEV = (...args) => {
  * This is called when using jsx: "react-jsx" or "react-jsxdev"
  */
 const jsxs = jsx;
+/**
+ * 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
+ * @returns created element
+ */
+function createRedrawable(creator) {
+    let element = creator();
+    const redraw = () => {
+        const old = element;
+        element = creator();
+        old.replaceWith(element);
+        element.redraw = redraw;
+        return element;
+    };
+    element.redraw = redraw;
+    return element;
+}
 
 /**
  * Reference to the created HTML element.
@@ -359,4 +385,4 @@ function KTAsync(props) {
     return comp;
 }
 
-export { Fragment, KTAsync, h as createElement, h, jsx, jsxDEV, jsxs, ref };
+export { Fragment, KTAsync, h as createElement, createRedrawable, h, jsx, jsxDEV, jsxs, ref };

package/dist/jsx/index.d.ts

@@ -43,16 +43,8 @@ declare global {
   }
 }
 
-type KTAvailableContent =
-  | KTRef<any>
-  | HTMLElement
-  | Element
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | (KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined)[];
+type SingleContent = KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined;
+type KTAvailableContent = SingleContent | SingleContent[] | SingleContent[][];
 type KTRawContent = KTAvailableContent | Promise<KTAvailableContent>;
 type KTRawAttr = KTAttribute | string;
 
@@ -147,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.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -179,5 +171,21 @@ declare const jsxDEV: typeof jsx;
  */
 declare const jsxs: typeof jsx;
 
-export { Fragment, h as createElement, jsx, jsxDEV, jsxs, ref };
+/**
+ * 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
+ * @returns created element
+ */
+declare function createRedrawable(creator: () => KTHTMLElement): KTHTMLElement;
+
+export { Fragment, h as createElement, createRedrawable, jsx, jsxDEV, jsxs, ref };
 export type { KTHTMLElement, KTRef };

package/dist/jsx/index.mjs

@@ -220,7 +220,7 @@ function applyContent(element, content) {
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.14.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!
@@ -337,6 +337,32 @@ const jsxDEV = (...args) => {
  * This is called when using jsx: "react-jsx" or "react-jsxdev"
  */
 const jsxs = jsx;
+/**
+ * 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
+ * @returns created element
+ */
+function createRedrawable(creator) {
+    let element = creator();
+    const redraw = () => {
+        const old = element;
+        element = creator();
+        old.replaceWith(element);
+        element.redraw = redraw;
+        return element;
+    };
+    element.redraw = redraw;
+    return element;
+}
 
 /**
  * Reference to the created HTML element.
@@ -347,4 +373,4 @@ function ref(value) {
     return { value: value, isKT: true };
 }
 
-export { Fragment, h as createElement, jsx, jsxDEV, jsxs, ref };
+export { Fragment, h as createElement, createRedrawable, jsx, jsxDEV, jsxs, ref };

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

@@ -37,16 +37,8 @@ declare global {
   }
 }
 
-type KTAvailableContent =
-  | KTRef<any>
-  | HTMLElement
-  | Element
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | (KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined)[];
+type SingleContent = KTRef<any> | HTMLElement | Element | string | number | boolean | null | undefined;
+type KTAvailableContent = SingleContent | SingleContent[] | SingleContent[][];
 type KTRawContent = KTAvailableContent | Promise<KTAvailableContent>;
 type KTRawAttr = KTAttribute | string;
 
@@ -141,7 +133,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.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!

package/dist/jsx/jsx-runtime.mjs

@@ -220,7 +220,7 @@ function applyContent(element, content) {
  * ## About
  * @package @ktjs/core
  * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 0.14.2 (Last Update: 2026.01.16 22:23:59.363)
+ * @version 0.14.4 (Last Update: 2026.01.17 08:54:29.476)
  * @license MIT
  * @link https://github.com/baendlorel/kt.js
  * @link https://baendlorel.github.io/ Welcome to my site!

package/package.json

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