vivth 1.5.3 → 1.5.5

package/README.md

@@ -198,7 +198,6 @@ npm i vivth
 - [neutral.E](#e)
 - [neutral.NewStyleSheetAsync](#newstylesheetasync)
 - [neutral.NewStyleSheetSync](#newstylesheetsync)
-- [neutral.WC_DefineCustomElement](#wc_definecustomelement)
 - [neutral.WC_TagName_type](#wc_tagname_type)
 - [neutral.EnsureValidTag](#ensurevalidtag)
 - [neutral.IsInViewPortSignal](#isinviewportsignal)
@@ -3924,9 +3923,9 @@ f.forInSignals((key, signal) => {
 
 #### reference: `WalkThrough`
 
-- collection of static `methods` to walktrhough things, instead of regular looping;
-- usefull to iterator that might be modified during iteration;
-- mostlikely to be less performant, but with better result clarity;
+- collection of static `methods` to walkthrough things, instead of regular looping;
+- useful for iterators that might be modified during iteration;
+- most likely to be less performant, but with better result clarity;
 
 #### reference: `WalkThrough.set`
 
@@ -3936,7 +3935,7 @@ f.forInSignals((key, signal) => {
 /**
  * @template VAL
  * @param {Set<VAL>} setInstance
- * @param {(value:VAL)=>void} callback
+ * @param {(value: VAL) => void} callback
  * @returns {void}
  */
 ```
@@ -3958,7 +3957,7 @@ WalkThrough.set(setOfSomething, (value) => {
 /**
  * @template KEY, VAL
  * @param {Map<KEY, VAL>} mapInstance
- * @param {(res:[key: KEY, value: VAL]) => void} callback
+ * @param {(entry: [key: KEY, value: VAL]) => void} callback
  * @returns {void}
  */
 ```
@@ -3980,7 +3979,7 @@ WalkThrough.map(mapOfSomething, ([key, value]) => {
 /**
  * @template VAL
  * @param {VAL[]} arrayInstance
- * @param {(res:[value: VAL, index: number]) => void} callback
+ * @param {(entry: [index: number, value: VAL]) => void} callback
  * @returns {void}
  */
 ```
@@ -3989,7 +3988,7 @@ WalkThrough.map(mapOfSomething, ([key, value]) => {
 
 ```js
 import { WalkThrough } from "vivth/neutral";
-WalkThrough.array(arrayOfSomething, ([value, index]) => {
+WalkThrough.array(arrayOfSomething, ([index, value]) => {
   // code
 });
 ```
@@ -7100,43 +7099,6 @@ text.nodeValue = "hello world";
 
 ---
 
-<h2 id="wc_definecustomelement">neutral.WC_DefineCustomElement</h2>
-
-#### reference: `WC_DefineCustomElement`
-
-- helper funtion for wecomponent instantiator;
-- it uses WC_createElement_bind, which uses `lit-html`;
-- alternatively, if you want to create a baseline component that are not to be , you can just
-
-```js
-/**
- * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
- * @template {{
- * 	class?:string;
- * 	style?:string;
- *  observedAttributes?: readonly string[];
- *  namedSlots?: readonly string[];
- * 	props?: Record<string, keyof TypeMap|(new (...args:any[])=>any)>;
- * }} STANDARD
- * @template {(BASE_CONSTRUCTOR) & {
- * 	tagName: string;
- * 	extendIsValue: string;
- * 	observedAttributes?: STANDARD["observedAttributes"];
- * 	namedSlots?: STANDARD["namedSlots"];
- * 	props?: STANDARD["props"];
- * }} CREATEARGS
- * @template {string} TAG
- * @param {WC_TagName_type<TAG>} tagName
- * @param {CREATEARGS} classRef
- * @param {ElementDefinitionOptions} elementDefinitionOptions
- * @returns {ReturnType<typeof WC_createElement_bind<CREATEARGS>>}
- */
-```
-
-\*) <sub>[go to list of exported API and typehelpers](#list-of-exported-api-and-typehelpers)</sub>
-
----
-
 <h2 id="wc_tagname_type">neutral.WC_TagName_type</h2>
 
 - jsdoc types:
@@ -7399,7 +7361,7 @@ text.nodeValue = "hello world";
 }
 ```
 
-- By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+- By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
 
 ```js
 /**
@@ -7475,9 +7437,7 @@ text.nodeValue = "hello world";
 
 ```js
  export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- 	static create = WC_DefineCustomElement('my-webcomponent', this);
- 	// you can skip the defining with WC_DefineCustomElement if the class are meant to be extended abstract;
- 	// or if you want to opt out from using `lit-html` template;
+ 	static create = this.define('my-webcomponent', this);
  }
 ```
 
@@ -7574,8 +7534,8 @@ text.nodeValue = "hello world";
 #### reference: `WC_extendsB`
 
 - Generates a base class for Web Component definitions.
-- Note: This generator does not support `connectedMoveCallback`.
-  For the needs of opting in to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsB](#wc_extendsb) instead.
+- Note: This generator have `connectedMoveCallback`.
+  For the needs of opting out to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsA](#wc_extendsa) instead.
 - This class relies heavily on complex type inference which can cause issues, during declaration file generation. To avoid "circular type" errors or build failures, set the following in your `tsconfig.json`:
 
 ```json
@@ -7586,7 +7546,7 @@ text.nodeValue = "hello world";
 }
 ```
 
-- By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+- By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
 
 ```js
 /**
@@ -7664,9 +7624,7 @@ text.nodeValue = "hello world";
 
 ```js
  export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- 	static create = WC_DefineCustomElement('my-webcomponent', this);
- 	// you can skip the defining if the class are meant to be extended abstract;
- 	// or if you want to opt out from using `lit-html` template;
+ 	static create = this.define('my-webcomponent', this);
  }
 ```
 

package/generated/types/generated/vivth/exports/all.d.mts

@@ -105,7 +105,6 @@ export { CSS } from "../../../src/web/common/CSS.mjs";
 export { E } from "../../../src/web/common/E.mjs";
 export { NewStyleSheetAsync } from "../../../src/web/common/NewStyleSheetAsync.mjs";
 export { NewStyleSheetSync } from "../../../src/web/common/NewStyleSheetSync.mjs";
-export { WC_DefineCustomElement } from "../../../src/web/common/WC_DefineCustomElement.mjs";
 export { IsInViewPortSignal } from "../../../src/web/signals/IsInViewPortSignal.mjs";
 export { ObserverSignal } from "../../../src/web/signals/ObserverSignal.mjs";
 export { WC_litRef } from "../../../src/web/signals/WC_litRef.mjs";

package/generated/types/generated/vivth/exports/neutral.d.mts

@@ -67,7 +67,6 @@ export { CSS } from "../../../src/web/common/CSS.mjs";
 export { E } from "../../../src/web/common/E.mjs";
 export { NewStyleSheetAsync } from "../../../src/web/common/NewStyleSheetAsync.mjs";
 export { NewStyleSheetSync } from "../../../src/web/common/NewStyleSheetSync.mjs";
-export { WC_DefineCustomElement } from "../../../src/web/common/WC_DefineCustomElement.mjs";
 export { IsInViewPortSignal } from "../../../src/web/signals/IsInViewPortSignal.mjs";
 export { ObserverSignal } from "../../../src/web/signals/ObserverSignal.mjs";
 export { WC_litRef } from "../../../src/web/signals/WC_litRef.mjs";

package/generated/types/src/class/WalkThrough.d.mts

@@ -1,28 +1,29 @@
 /**
  * @description
- * - collection of static `methods` to walktrhough things, instead of regular looping;
- * - usefull to iterator that might be modified during iteration;
- * - mostlikely to be less performant, but with better result clarity;
+ * - collection of static `methods` to walkthrough things, instead of regular looping;
+ * - useful for iterators that might be modified during iteration;
+ * - most likely to be less performant, but with better result clarity;
  */
 export class WalkThrough {
     /**
-     * @param {Iterator<any, any, any>} iterator
-     * @param {(...any:any[])=>void} callback
+     * @template T
+     * @param {Iterator<T, any, any>} iterator
+     * @param {(value: T) => void} callback
      * @returns {void}
      */
-    static #handler: (iterator: Iterator<any, any, any>, callback: (...any: any[]) => void) => void;
+    static #handler<T>(iterator: Iterator<T, any, any>, callback: (value: T) => void): void;
     /**
      * @description
      * - method helper to WalkThrough `Set`;
      * @template VAL
      * @param {Set<VAL>} setInstance
-     * @param {(value:VAL)=>void} callback
+     * @param {(value: VAL) => void} callback
      * @returns {void}
      * @example
      * import { WalkThrough } from 'vivth/neutral';
      *
      * WalkThrough.set(setOfSomething, (value) => {
-     * 	// code
+     * // code
      * })
      */
     static set<VAL>(setInstance: Set<VAL>, callback: (value: VAL) => void): void;
@@ -31,29 +32,29 @@ export class WalkThrough {
      * - method helper to WalkThrough `Map`;
      * @template KEY, VAL
      * @param {Map<KEY, VAL>} mapInstance
-     * @param {(res:[key: KEY, value: VAL]) => void} callback
+     * @param {(entry: [key: KEY, value: VAL]) => void} callback
      * @returns {void}
      * @example
      * import { WalkThrough } from 'vivth/neutral';
      *
      * WalkThrough.map(mapOfSomething, ([key, value]) => {
-     * 	// code
+     * // code
      * })
      */
-    static map<KEY, VAL>(mapInstance: Map<KEY, VAL>, callback: (res: [key: KEY, value: VAL]) => void): void;
+    static map<KEY, VAL>(mapInstance: Map<KEY, VAL>, callback: (entry: [key: KEY, value: VAL]) => void): void;
     /**
      * @description
      * - method helper to WalkThrough `Array`;
      * @template VAL
      * @param {VAL[]} arrayInstance
-     * @param {(res:[value: VAL, index: number]) => void} callback
+     * @param {(entry: [index: number, value: VAL]) => void} callback
      * @returns {void}
      * @example
      * import { WalkThrough } from 'vivth/neutral';
      *
-     * WalkThrough.array(arrayOfSomething, ([value, index]) => {
-     * 	// code
+     * WalkThrough.array(arrayOfSomething, ([index, value]) => {
+     * // code
      * })
      */
-    static array<VAL>(arrayInstance: VAL[], callback: (res: [value: VAL, index: number]) => void): void;
+    static array<VAL>(arrayInstance: VAL[], callback: (entry: [index: number, value: VAL]) => void): void;
 }

package/generated/types/src/web/WC_extendsA.d.mts

@@ -18,7 +18,7 @@
  * 	}
  * }
  * ```
- * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+ * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
  * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
  * @template {{
  * 	class?:string;
@@ -86,9 +86,7 @@
  * @returns {RET}
  * @example
  * export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- * 	static create = WC_DefineCustomElement('my-webcomponent', this);
- * 	// you can skip the defining with WC_DefineCustomElement if the class are meant to be extended abstract;
- * 	// or if you want to opt out from using `lit-html` template;
+ * 	static create = this.define('my-webcomponent', this);
  * }
  */
 export function WC_extendsA<BASE_CONSTRUCTOR extends new (...args: any[]) => HTMLElement, STANDARD extends {

package/generated/types/src/web/WC_extendsB.d.mts

@@ -8,8 +8,8 @@
 /**
  * @description
  * - Generates a base class for Web Component definitions.
- * - Note: This generator does not support `connectedMoveCallback`.
- * For the needs of opting in to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsB](#wc_extendsb) instead.
+ * - Note: This generator have `connectedMoveCallback`.
+ * For the needs of opting out to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsA](#wc_extendsa) instead.
  * - This class relies heavily on complex type inference which can cause issues, during declaration file generation. To avoid "circular type" errors or build failures, set the following in your `tsconfig.json`:
  * ```json
  * {
@@ -18,7 +18,7 @@
  * 	}
  * }
  * ```
- * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+ * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
  * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
  * @template {{
  * 	class?:string;
@@ -88,9 +88,7 @@
  * @returns {RET}
  * @example
  * export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- * 	static create = WC_DefineCustomElement('my-webcomponent', this);
- * 	// you can skip the defining if the class are meant to be extended abstract;
- * 	// or if you want to opt out from using `lit-html` template;
+ * 	static create = this.define('my-webcomponent', this);
  * }
  */
 export function WC_extendsB<BASE_CONSTRUCTOR extends new (...args: any[]) => HTMLElement, STANDARD extends {

package/generated/vivth/exports/all.mjs

@@ -215,7 +215,6 @@ export { CSS } from '../../../src/web/common/CSS.mjs';
 export { E } from '../../../src/web/common/E.mjs';
 export { NewStyleSheetAsync } from '../../../src/web/common/NewStyleSheetAsync.mjs';
 export { NewStyleSheetSync } from '../../../src/web/common/NewStyleSheetSync.mjs';
-export { WC_DefineCustomElement } from '../../../src/web/common/WC_DefineCustomElement.mjs';
 /**
  * @template {string} TAG
  * @typedef {import('../../../src/web/common/WC_TagName_type.mjs').WC_TagName_type<TAG>} WC_TagName_type

package/generated/vivth/exports/neutral.mjs

@@ -177,7 +177,6 @@ export { CSS } from '../../../src/web/common/CSS.mjs';
 export { E } from '../../../src/web/common/E.mjs';
 export { NewStyleSheetAsync } from '../../../src/web/common/NewStyleSheetAsync.mjs';
 export { NewStyleSheetSync } from '../../../src/web/common/NewStyleSheetSync.mjs';
-export { WC_DefineCustomElement } from '../../../src/web/common/WC_DefineCustomElement.mjs';
 /**
  * @template {string} TAG
  * @typedef {import('../../../src/web/common/WC_TagName_type.mjs').WC_TagName_type<TAG>} WC_TagName_type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vivth",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "description": "library primitives",
   "devDependencies": {
     "@types/bun": "^1.3.3",

package/src/class/WalkThrough.mjs

@@ -2,72 +2,77 @@
 
 /**
  * @description
- * - collection of static `methods` to walktrhough things, instead of regular looping;
- * - usefull to iterator that might be modified during iteration;
- * - mostlikely to be less performant, but with better result clarity;
+ * - collection of static `methods` to walkthrough things, instead of regular looping;
+ * - useful for iterators that might be modified during iteration;
+ * - most likely to be less performant, but with better result clarity;
  */
 export class WalkThrough {
 	/**
-	 * @param {Iterator<any, any, any>} iterator
-	 * @param {(...any:any[])=>void} callback
+	 * @template T
+	 * @param {Iterator<T, any, any>} iterator
+	 * @param {(value: T) => void} callback
 	 * @returns {void}
 	 */
-	static #handler = (iterator, callback) => {
+	static #handler(iterator, callback) {
 		let result = iterator.next();
 		while (!result.done) {
 			callback(result.value);
 			result = iterator.next();
 		}
-	};
+	}
+
 	/**
 	 * @description
 	 * - method helper to WalkThrough `Set`;
 	 * @template VAL
 	 * @param {Set<VAL>} setInstance
-	 * @param {(value:VAL)=>void} callback
+	 * @param {(value: VAL) => void} callback
 	 * @returns {void}
 	 * @example
 	 * import { WalkThrough } from 'vivth/neutral';
 	 *
 	 * WalkThrough.set(setOfSomething, (value) => {
-	 * 	// code
+	 * // code
 	 * })
 	 */
 	static set(setInstance, callback) {
 		WalkThrough.#handler(setInstance.values(), callback);
 	}
+
 	/**
 	 * @description
 	 * - method helper to WalkThrough `Map`;
 	 * @template KEY, VAL
 	 * @param {Map<KEY, VAL>} mapInstance
-	 * @param {(res:[key: KEY, value: VAL]) => void} callback
+	 * @param {(entry: [key: KEY, value: VAL]) => void} callback
 	 * @returns {void}
 	 * @example
 	 * import { WalkThrough } from 'vivth/neutral';
 	 *
 	 * WalkThrough.map(mapOfSomething, ([key, value]) => {
-	 * 	// code
+	 * // code
 	 * })
 	 */
 	static map(mapInstance, callback) {
 		WalkThrough.#handler(mapInstance.entries(), callback);
 	}
+
 	/**
 	 * @description
 	 * - method helper to WalkThrough `Array`;
 	 * @template VAL
 	 * @param {VAL[]} arrayInstance
-	 * @param {(res:[value: VAL, index: number]) => void} callback
+	 * @param {(entry: [index: number, value: VAL]) => void} callback
 	 * @returns {void}
 	 * @example
 	 * import { WalkThrough } from 'vivth/neutral';
 	 *
-	 * WalkThrough.array(arrayOfSomething, ([value, index]) => {
-	 * 	// code
+	 * WalkThrough.array(arrayOfSomething, ([index, value]) => {
+	 * // code
 	 * })
 	 */
 	static array(arrayInstance, callback) {
-		WalkThrough.#handler(arrayInstance.values(), callback);
+		// Changed .values() to .entries() to match your [index, value] requirement
+		WalkThrough.#handler(arrayInstance.entries(), callback);
 	}
 }

package/src/web/WC_extendsA.mjs

@@ -3,7 +3,7 @@
 // import { Signal } from '../class/Signal.mjs';
 import { WalkThrough } from '../class/WalkThrough.mjs';
 import { ForInSync } from '../function/ForInSync.mjs';
-import { ForOfSync } from '../function/ForOfSync.mjs';
+// import { ForOfSync } from '../function/ForOfSync.mjs';
 import { IsTypeOf } from '../function/IsTypeOf.mjs';
 import { WC_createElement_bind } from './bindings/WC_createElement_bind.mjs';
 import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
@@ -28,7 +28,7 @@ import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
  * 	}
  * }
  * ```
- * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+ * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
  * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
  * @template {{
  * 	class?:string;
@@ -96,9 +96,7 @@ import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
  * @returns {RET}
  * @example
  * export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- * 	static create = WC_DefineCustomElement('my-webcomponent', this);
- * 	// you can skip the defining with WC_DefineCustomElement if the class are meant to be extended abstract;
- * 	// or if you want to opt out from using `lit-html` template;
+ * 	static create = this.define('my-webcomponent', this);
  * }
  */
 export function WC_extendsA(Base, staticMember = /** @type {any} */ ({})) {
@@ -212,9 +210,6 @@ export function WC_extendsA(Base, staticMember = /** @type {any} */ ({})) {
 				this.setAttribute('style', style);
 			}
 			WalkThrough.set(this.#setOfConnected, (cb) => cb());
-			ForOfSync(observedAttributes, (key) => {
-				this.attributeChangedCallback(key, null, this.getAttribute(key));
-			});
 		}
 
 		/**

package/src/web/WC_extendsB.mjs

@@ -2,7 +2,7 @@
 
 import { WalkThrough } from '../class/WalkThrough.mjs';
 import { ForInSync } from '../function/ForInSync.mjs';
-import { ForOfSync } from '../function/ForOfSync.mjs';
+// import { ForOfSync } from '../function/ForOfSync.mjs';
 import { IsTypeOf } from '../function/IsTypeOf.mjs';
 import { WC_createElement_bind } from './bindings/WC_createElement_bind.mjs';
 import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
@@ -14,11 +14,12 @@ import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
 /**
  * @typedef {typeof import('../function/IsTypeOf.mjs').TypeMap} TypeMap
  */
+
 /**
  * @description
  * - Generates a base class for Web Component definitions.
- * - Note: This generator does not support `connectedMoveCallback`.
- * For the needs of opting in to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsB](#wc_extendsb) instead.
+ * - Note: This generator have `connectedMoveCallback`.
+ * For the needs of opting out to [connectedMoveCallback](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) functionality, use [WC_extendsA](#wc_extendsa) instead.
  * - This class relies heavily on complex type inference which can cause issues, during declaration file generation. To avoid "circular type" errors or build failures, set the following in your `tsconfig.json`:
  * ```json
  * {
@@ -27,7 +28,7 @@ import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
  * 	}
  * }
  * ```
- * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this factory;
+ * - By disabling `declaration`, you prevent the TypeScript compiler from attempting to resolve and export the complex recursive type definitions generated by this generator;
  * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
  * @template {{
  * 	class?:string;
@@ -97,9 +98,7 @@ import { WC_createNamedSlot } from './bindings/WC_createNamedSlot.mjs';
  * @returns {RET}
  * @example
  * export MyWebComponent extends WC_extendsA(HTMLElement, {...options}){
- * 	static create = WC_DefineCustomElement('my-webcomponent', this);
- * 	// you can skip the defining if the class are meant to be extended abstract;
- * 	// or if you want to opt out from using `lit-html` template;
+ * 	static create = this.define('my-webcomponent', this);
  * }
  */
 export function WC_extendsB(Base, staticMember = /** @type {any} */ ({})) {
@@ -225,9 +224,6 @@ export function WC_extendsB(Base, staticMember = /** @type {any} */ ({})) {
 				this.setAttribute('style', style);
 			}
 			WalkThrough.set(this.#setOfConnected, (cb) => cb());
-			ForOfSync(observedAttributes, (key) => {
-				this.attributeChangedCallback(key, null, this.getAttribute(key));
-			});
 		}
 		/**
 		 * @protected

package/src/web/common/WC_DefineCustomElement.mjs

@@ -1,46 +0,0 @@
-// @ts-check
-
-import { WC_createElement_bind } from '../bindings/WC_createElement_bind.mjs';
-
-/**
- * @import {WC_TagName_type} from '../common/WC_TagName_type.mjs'
- */
-/**
- * @typedef {typeof import('../../function/IsTypeOf.mjs').TypeMap} TypeMap
- */
-/**
- * @description
- * - helper funtion for wecomponent instantiator;
- * - it uses WC_createElement_bind, which uses `lit-html`;
- * - alternatively, if you want to create a baseline component that are not to be , you can just
- * @template {new (...args: any[]) => HTMLElement} BASE_CONSTRUCTOR
- * @template {{
- * 	class?:string;
- * 	style?:string;
- *  observedAttributes?: readonly string[];
- *  namedSlots?: readonly string[];
- * 	props?: Record<string, keyof TypeMap|(new (...args:any[])=>any)>;
- * }} STANDARD
- * @template {(BASE_CONSTRUCTOR) & {
- * 	tagName: string;
- * 	extendIsValue: string;
- * 	observedAttributes?: STANDARD["observedAttributes"];
- * 	namedSlots?: STANDARD["namedSlots"];
- * 	props?: STANDARD["props"];
- * }} CREATEARGS
- * @template {string} TAG
- * @param {WC_TagName_type<TAG>} tagName
- * @param {CREATEARGS} classRef
- * @param {ElementDefinitionOptions} elementDefinitionOptions
- * @returns {ReturnType<typeof WC_createElement_bind<CREATEARGS>>}
- */
-export function WC_DefineCustomElement(tagName, classRef, elementDefinitionOptions) {
-	if (elementDefinitionOptions && elementDefinitionOptions.extends) {
-		classRef.tagName = elementDefinitionOptions.extends;
-		classRef.extendIsValue = tagName;
-	} else {
-		classRef.tagName = tagName;
-	}
-	customElements.define(tagName, classRef, elementDefinitionOptions);
-	return WC_createElement_bind(classRef);
-}