@ktjs/shared 0.20.2 → 0.22.2

package/dist/index.d.ts

@@ -20,9 +20,79 @@ declare const $define: <T>(o: T, p: PropertyKey, attributes: PropertyDescriptor
 declare const $entries: <T>(o: T) => Array<[keyof T, T[keyof T]]>;
 declare const $isThenable: (o: any) => o is Promise<any>;
 
+/**
+ * * Actually, these functions will be replaced as they are by @rollup/plugin-replace
+ * @see ./.scripts/replace.mjs
+ */
 declare const $throw: (message: string) => never;
+declare const $warn: (message: string) => void;
+
+type otherstring = string & {};
+
+/**
+ * Normal HTML tags like `div`, `span`, `a`, etc.
+ */
+type HTMLTag = keyof HTMLElementTagNameMap;
+type SVGTag = keyof SVGElementTagNameMap;
+type MathMLTag = keyof MathMLElementTagNameMap;
+
+/**
+ * Get the tags that makes HTMLElementTagNameMap[tag] = HTMLElement
+ */
+type NonSpecialTags = {
+  [K in keyof HTMLElementTagNameMap]: HTMLElement extends HTMLElementTagNameMap[K] ? K : never;
+}[keyof HTMLElementTagNameMap];
+
+/**
+ * This is tested on 15 browsers (most popular ones)
+ * - appending a text node to these tags takes no effect.
+ *   - No effect means `innerText` does not include the text in the text node.
+ * @see {@link src/core/h/no-text-node.ts}
+ */
+type NoTextNodeTag =
+  | 'area'
+  | 'audio'
+  | 'base'
+  | 'basefont'
+  | 'br'
+  | 'canvas'
+  | 'datalist'
+  | 'details'
+  | 'dialog'
+  | 'frameset'
+  | 'head'
+  | 'iframe'
+  | 'img'
+  | 'input'
+  | 'link'
+  | 'meta'
+  | 'meter'
+  | 'noembed'
+  | 'noframes'
+  | 'noscript'
+  | 'optgroup'
+  | 'param'
+  | 'progress'
+  | 'rp'
+  | 'select'
+  | 'style'
+  | 'template'
+  | 'textarea'
+  | 'title'
+  | 'video'
+  | 'wbr'
+  | 'embed'
+  | 'frame'
+  | 'keygen'
+  | 'option';
+
+/**
+ * These fields of HTMLElement can trigger `change`.
+ */
+type ChangeTriggerField = 'value' | 'checked' | 'selected' | 'valueAsDate' | 'valueAsNumber';
+
+type InputElementTag = 'input' | 'select' | 'textarea';
 
-declare const $replaceWith: (...nodes: (Node | string)[]) => void;
 /**
  * & Remove `bind` because it is shockingly slower than wrapper
  * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -35,6 +105,13 @@ declare const $buttonDisabledSetter: (v: any) => void;
 declare const parseStyle: (style: string | Partial<CSSStyleDeclaration> | undefined) => string;
 type ChangeHandler<T = string> = (value: T, ...args: any[]) => void;
 declare const generateHandler: <T = string>(props: any, key: string) => ChangeHandler<T>;
+/**
+ * Used for `k-model`
+ */
+declare const applyModel: (element: HTMLElementTagNameMap[InputElementTag], valueRef: {
+    value: unknown;
+    addOnChange: (fn: (newValue: unknown) => void) => void;
+}, propName: "value" | "checked", eventName: "change" | "input") => void;
 
 /**
  * Default empty function
@@ -64,5 +141,5 @@ declare const emplaceParams: (path: string, params: Record<string, string>) => s
  */
 declare const extractParams: (pattern: string, path: string) => Record<string, string> | null;
 
-export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isThenable, $keys, $replaceWith, $throw, $toString, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
-export type { ChangeHandler };
+export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isThenable, $keys, $throw, $toString, $warn, applyModel, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
+export type { ChangeHandler, ChangeTriggerField, HTMLTag, InputElementTag, MathMLTag, NoTextNodeTag, NonSpecialTags, SVGTag, otherstring };

package/dist/index.iife.js

@@ -15,8 +15,15 @@ var __ktjs_shared__ = (function (exports) {
     const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
 
     // Error handling utilities
+    /**
+     * * Actually, these functions will be replaced as they are by @rollup/plugin-replace
+     * @see ./.scripts/replace.mjs
+     */
     const $throw = (message) => {
-        throw new Error('@ktjs/shared: ' + message);
+        throw new Error('[kt.js error]' + message);
+    };
+    const $warn = (message) => {
+        console.warn('[kt.js warn] ' + message);
     };
 
     // String manipulation utilities
@@ -27,7 +34,6 @@ var __ktjs_shared__ = (function (exports) {
 
     // DOM manipulation utilities
     // # dom natives
-    const $replaceWith = Element.prototype.replaceWith;
     /**
      * & Remove `bind` because it is shockingly slower than wrapper
      * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -90,6 +96,14 @@ var __ktjs_shared__ = (function (exports) {
         }
         return $emptyFn;
     };
+    /**
+     * Used for `k-model`
+     */
+    const applyModel = (element, valueRef, propName, eventName) => {
+        element[propName] = valueRef.value; // initialize
+        valueRef.addOnChange((newValue) => (element[propName] = newValue));
+        element.addEventListener(eventName, () => (valueRef.value = element[propName]));
+    };
 
     /**
      * Normalize path by joining parts and ensuring leading slash
@@ -166,7 +180,7 @@ var __ktjs_shared__ = (function (exports) {
 
     // Shared utilities and cached native methods for kt.js framework
     // Re-export all utilities
-    Object.defineProperty(window, '@ktjs/shared', { value: '0.20.2' });
+    Object.defineProperty(window, '__ktjs__', { value: '0.22.2' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -183,9 +197,10 @@ var __ktjs_shared__ = (function (exports) {
     exports.$isArray = $isArray;
     exports.$isThenable = $isThenable;
     exports.$keys = $keys;
-    exports.$replaceWith = $replaceWith;
     exports.$throw = $throw;
     exports.$toString = $toString;
+    exports.$warn = $warn;
+    exports.applyModel = applyModel;
     exports.buildQuery = buildQuery;
     exports.emplaceParams = emplaceParams;
     exports.extractParams = extractParams;

package/dist/index.legacy.js

@@ -17,8 +17,15 @@ var __ktjs_shared__ = (function (exports) {
     };
 
     // Error handling utilities
+    /**
+     * * Actually, these functions will be replaced as they are by @rollup/plugin-replace
+     * @see ./.scripts/replace.mjs
+     */
     var $throw = function (message) {
-        throw new Error('@ktjs/shared: ' + message);
+        throw new Error('[kt.js error]' + message);
+    };
+    var $warn = function (message) {
+        console.warn('[kt.js warn] ' + message);
     };
 
     // String manipulation utilities
@@ -30,7 +37,6 @@ var __ktjs_shared__ = (function (exports) {
     // DOM manipulation utilities
     var _a;
     // # dom natives
-    var $replaceWith = Element.prototype.replaceWith;
     /**
      * & Remove `bind` because it is shockingly slower than wrapper
      * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -98,6 +104,14 @@ var __ktjs_shared__ = (function (exports) {
         }
         return $emptyFn;
     };
+    /**
+     * 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
@@ -179,7 +193,7 @@ var __ktjs_shared__ = (function (exports) {
 
     // Shared utilities and cached native methods for kt.js framework
     // Re-export all utilities
-    Object.defineProperty(window, '@ktjs/shared', { value: '0.20.2' });
+    Object.defineProperty(window, '__ktjs__', { value: '0.22.2' });
 
     exports.$ArrayFrom = $ArrayFrom;
     exports.$append = $append;
@@ -196,9 +210,10 @@ var __ktjs_shared__ = (function (exports) {
     exports.$isArray = $isArray;
     exports.$isThenable = $isThenable;
     exports.$keys = $keys;
-    exports.$replaceWith = $replaceWith;
     exports.$throw = $throw;
     exports.$toString = $toString;
+    exports.$warn = $warn;
+    exports.applyModel = applyModel;
     exports.buildQuery = buildQuery;
     exports.emplaceParams = emplaceParams;
     exports.extractParams = extractParams;

package/dist/index.mjs

@@ -12,8 +12,15 @@ const $entries = Object.entries;
 const $isThenable = (o) => typeof o === 'object' && o !== null && typeof o.then === 'function';
 
 // Error handling utilities
+/**
+ * * Actually, these functions will be replaced as they are by @rollup/plugin-replace
+ * @see ./.scripts/replace.mjs
+ */
 const $throw = (message) => {
-    throw new Error('@ktjs/shared: ' + message);
+    throw new Error('[kt.js error]' + message);
+};
+const $warn = (message) => {
+    console.warn('[kt.js warn] ' + message);
 };
 
 // String manipulation utilities
@@ -24,7 +31,6 @@ const $emptyFn = (() => true);
 
 // DOM manipulation utilities
 // # dom natives
-const $replaceWith = Element.prototype.replaceWith;
 /**
  * & Remove `bind` because it is shockingly slower than wrapper
  * & `window.document` is safe because it is not configurable and its setter is undefined
@@ -87,6 +93,14 @@ const generateHandler = (props, key) => {
     }
     return $emptyFn;
 };
+/**
+ * Used for `k-model`
+ */
+const applyModel = (element, valueRef, propName, eventName) => {
+    element[propName] = valueRef.value; // initialize
+    valueRef.addOnChange((newValue) => (element[propName] = newValue));
+    element.addEventListener(eventName, () => (valueRef.value = element[propName]));
+};
 
 /**
  * Normalize path by joining parts and ensuring leading slash
@@ -163,6 +177,6 @@ const extractParams = (pattern, path) => {
 
 // Shared utilities and cached native methods for kt.js framework
 // Re-export all utilities
-Object.defineProperty(window, '@ktjs/shared', { value: '0.20.2' });
+Object.defineProperty(window, '__ktjs__', { value: '0.22.2' });
 
-export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isThenable, $keys, $replaceWith, $throw, $toString, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };
+export { $ArrayFrom, $append, $appendChild, $assign, $buttonDisabledGetter, $buttonDisabledSetter, $define, $defines, $emptyFn, $entries, $hasOwn, $is, $isArray, $isThenable, $keys, $throw, $toString, $warn, applyModel, buildQuery, emplaceParams, extractParams, generateHandler, normalizePath, parseQuery, parseStyle };

package/package.json

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