vivth 1.5.4 → 1.5.6

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)
@@ -4723,7 +4722,7 @@ Console.log(
  * @param {string} [options.copyright]
  * @param {string} [options.tableOfContentTitle]
  * @param {number} [options.maxDebounceForGeneratingDocAndExport]
- * - default `10_000`;
+ * - default `1_000`;
  * @param {import('chokidar').ChokidarOptions} [options.chokidarOptions]
  * - ChokidarOptions;
  * @param {import('../typehints/AutoDocASOptions.mjs').AutoDocASOptions} [options.assemblyScriptOptions]
@@ -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/doc/JSautoDOC.d.mts

@@ -75,7 +75,7 @@ export class JSautoDOC implements VivthCleanup {
      * @param {string} [options.copyright]
      * @param {string} [options.tableOfContentTitle]
      * @param {number} [options.maxDebounceForGeneratingDocAndExport]
-     * - default `10_000`;
+     * - default `1_000`;
      * @param {import('chokidar').ChokidarOptions} [options.chokidarOptions]
      * - ChokidarOptions;
      * @param {import('../typehints/AutoDocASOptions.mjs').AutoDocASOptions} [options.assemblyScriptOptions]

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.4",
+  "version": "1.5.6",
   "description": "library primitives",
   "devDependencies": {
     "@types/bun": "^1.3.3",

package/src/class/Derived.mjs

@@ -41,7 +41,7 @@ export class Derived extends Signal {
 	 *
 	 * count.value++;
 	 */
-	constructor(derivedFunction, maxTimelapseBeingDebounced = undefined) {
+	constructor(derivedFunction, maxTimelapseBeingDebounced = 2_000) {
 		super(undefined);
 		new Effect(async (options) => {
 			const currentValue = await derivedFunction(

package/src/doc/JSautoDOC.mjs

@@ -106,7 +106,7 @@ export class JSautoDOC {
 	 * @param {string} [options.copyright]
 	 * @param {string} [options.tableOfContentTitle]
 	 * @param {number} [options.maxDebounceForGeneratingDocAndExport]
-	 * - default `10_000`;
+	 * - default `1_000`;
 	 * @param {import('chokidar').ChokidarOptions} [options.chokidarOptions]
 	 * - ChokidarOptions;
 	 * @param {import('../typehints/AutoDocASOptions.mjs').AutoDocASOptions} [options.assemblyScriptOptions]
@@ -148,7 +148,7 @@ export class JSautoDOC {
 		onLastGeneratedCallback = undefined,
 		tableOfContentTitle = 'exported-api-and-type-list',
 		copyright = '',
-		maxDebounceForGeneratingDocAndExport = 10_000,
+		maxDebounceForGeneratingDocAndExport = 1_000,
 		assemblyScriptOptions = undefined,
 		chokidarOptions = undefined,
 		jstsconfigs = undefined,

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);
-}