vivth 1.2.3 → 1.3.0

package/README.src.md

@@ -31,8 +31,12 @@ npm i vivth
 
 ## versions:
 
-- `1.0.0+:b`:
+- `1.0.0+:beta`:
+
   > - beta release;
   > - checking edge cases;
   > - stable API, the exposed API access are highly unlikely to changes, only the underlying code
   >   might changes for improving performance;
+
+- `1.3.x:beta`:
+  > - type should now fully fixed, even with strict ts check;

package/bun.lock

@@ -4,8 +4,10 @@
     "": {
       "name": "vivth",
       "dependencies": {
+        "@types/mime-types": "^3.0.1",
         "chokidar": "^4.0.3",
         "esbuild": "^0.25.9",
+        "i": "^0.3.7",
         "mime-types": "^3.0.1",
         "pkg": "^5.8.1",
       },
@@ -95,6 +97,8 @@
 
     "@types/bun": ["@types/bun@1.2.21", "", { "dependencies": { "bun-types": "1.2.21" } }, "sha512-NiDnvEqmbfQ6dmZ3EeUO577s4P5bf4HCTXtI6trMc6f6RzirY5IrF3aIookuSpyslFzrnvv2lmEWv5HyC1X79A=="],
 
+    "@types/mime-types": ["@types/mime-types@3.0.1", "", {}, "sha512-xRMsfuQbnRq1Ef+C+RKaENOxXX87Ygl38W1vDfPHRku02TgQr+Qd8iivLtAMcR0KF5/29xlnFihkTlbqFrGOVQ=="],
+
     "@types/node": ["@types/node@22.13.5", "", { "dependencies": { "undici-types": "~6.20.0" } }, "sha512-+lTU0PxZXn0Dr1NBtC7Y8cR21AJr87dLLU953CWA6pMxxv/UDc7jYAY90upcrie1nRcD6XNG5HOYEDtgW5TxAg=="],
 
     "@types/react": ["@types/react@19.1.12", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-cMoR+FoAf/Jyq6+Df2/Z41jISvGZZ2eTlnsaJRptmZ76Caldwy1odD4xTr/gNV9VLj0AWgg/nmkevIyUfIIq5w=="],
@@ -189,6 +193,8 @@
 
     "https-proxy-agent": ["https-proxy-agent@5.0.1", "", { "dependencies": { "agent-base": "6", "debug": "4" } }, "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA=="],
 
+    "i": ["i@0.3.7", "", {}, "sha512-FYz4wlXgkQwIPqhzC5TdNMLSE5+GS1IIDJZY/1ZiEPCT2S3COUVZeT5OW4BmW4r5LHLQuOosSwsvnroG9GR59Q=="],
+
     "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
 
     "ignore": ["ignore@5.3.2", "", {}, "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g=="],

package/index.mjs

@@ -6,11 +6,12 @@
  * this library is made and distributed under MIT license;
  */
 
+export { CompileJS } from './src/bundler/CompileJS.mjs';
 export { CreateESPlugin } from './src/bundler/CreateESPlugin.mjs';
 export { EsBundler } from './src/bundler/EsBundler.mjs';
 export { FSInline } from './src/bundler/FSInline.mjs';
 export { FSInlineAnalyzer } from './src/bundler/FSInlineAnalyzer.mjs';
-export { CompileJS } from './src/bundler/CompileJS.mjs';
+export { Console } from './src/class/Console.mjs';
 export { Derived } from './src/class/Derived.mjs';
 export { Effect } from './src/class/Effect.mjs';
 export { EnvSignal } from './src/class/EnvSignal.mjs';
@@ -18,29 +19,28 @@ export { EventSignal } from './src/class/EventSignal.mjs';
 export { FileSafe } from './src/class/FileSafe.mjs';
 export { ListDerived } from './src/class/ListDerived.mjs';
 export { ListSignal } from './src/class/ListSignal.mjs';
+export { LitExp } from './src/class/LitExp.mjs';
 export { Paths } from './src/class/Paths.mjs';
 export { QChannel } from './src/class/QChannel.mjs';
 export { SafeExit } from './src/class/SafeExit.mjs';
 export { Setup } from './src/class/Setup.mjs';
 export { Signal } from './src/class/Signal.mjs';
 export { WorkerMainThread } from './src/class/WorkerMainThread.mjs';
-export { Console } from './src/class/Console.mjs';
+export { Base64URL } from './src/common/Base64URL.mjs';
 export { Base64URLFromFile } from './src/common/Base64URLFromFile.mjs';
 export { EventNameSpace } from './src/common/EventNameSpace.mjs';
 export { JSautoDOC } from './src/doc/JSautoDOC.mjs';
-export { LitExp } from './src/class/LitExp.mjs';
+export { CreateImmutable } from './src/function/CreateImmutable.mjs';
 export { EventCheck } from './src/function/EventCheck.mjs';
 export { EventObject } from './src/function/EventObject.mjs';
-export { IsAsync } from './src/function/IsAsync.mjs';
 export { GetRuntime } from './src/function/GetRuntime.mjs';
+export { IsAsync } from './src/function/IsAsync.mjs';
 export { LazyFactory } from './src/function/LazyFactory.mjs';
 export { Timeout } from './src/function/Timeout.mjs';
 export { Try } from './src/function/Try.mjs';
 export { TryAsync } from './src/function/TryAsync.mjs';
 export { TrySync } from './src/function/TrySync.mjs';
 export { TsToMjs } from './src/function/TsToMjs.mjs';
-export { Base64URL } from './src/common/Base64URL.mjs';
-export { CreateImmutable } from './src/function/CreateImmutable.mjs';
 export { WorkerResult } from './src/class/WorkerResult.mjs';
 export { WorkerThread } from './src/class/WorkerThread.mjs';
 export { ToBundledJSPlugin } from './src/bundler/adds/ToBundledJSPlugin.mjs';
@@ -59,6 +59,10 @@ export { ToBundledJSPlugin } from './src/bundler/adds/ToBundledJSPlugin.mjs';
 /**
  * @typedef {import('./src/types/LitExpKeyType.mjs').LitExpKeyType} LitExpKeyType
  */
+/**
+ * @template {import('./src/types/LitExpKeyType.mjs').LitExpKeyType} KEYS
+ * @typedef {import('./src/types/LitExpResultType.mjs').LitExpResultType<KEYS>} LitExpResultType
+ */
 /**
  * @typedef {import('./src/types/MutationType.mjs').MutationType} MutationType
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vivth",
-	"version": "1.2.3",
+	"version": "1.3.0",
 	"description": "library primitives",
 	"main": "index.mjs",
 	"types": "./types/index.d.mts",
@@ -10,8 +10,10 @@
 		"typescript": "^5.9.2"
 	},
 	"dependencies": {
+		"@types/mime-types": "^3.0.1",
 		"chokidar": "^4.0.3",
 		"esbuild": "^0.25.9",
+		"i": "^0.3.7",
 		"mime-types": "^3.0.1",
 		"pkg": "^5.8.1"
 	},

package/src/bundler/CompileJS.mjs

@@ -16,7 +16,10 @@ import { FSInlineAnalyzer } from './FSInlineAnalyzer.mjs';
  * @typedef {import('./CreateESPlugin.mjs')["CreateESPlugin"]} CreateESPlugin
  */
 
-let binaryExtension = undefined;
+/**
+ * @type {string|undefined}
+ */
+let binaryExtension;
 
 /**
  * @param {Record<string, string[]|string>} compilerOptions
@@ -27,7 +30,7 @@ const generateFlagsValue = (compilerOptions) => {
 	for (const flag in compilerOptions) {
 		const value = compilerOptions[flag];
 		options.push(`--${flag}`);
-		if (!Array.isArray(value)) {
+		if (Array.isArray(value) === false) {
 			if (value) {
 				options.push(value);
 			}
@@ -43,7 +46,7 @@ const generateFlagsValue = (compilerOptions) => {
  * @returns {string} extension including dot (e.g. '.exe', '')
  */
 const getBinaryExtension = () => {
-	if (!binaryExtension) {
+	if (binaryExtension === undefined) {
 		switch (platform()) {
 			case 'win32':
 				binaryExtension = '.exe';
@@ -100,10 +103,10 @@ const getBinaryExtension = () => {
  * - no need to add the output/outdir, as it use the `options.outDir`;
  * @param {ReturnType<CreateESPlugin>[]} [options.esBundlerPlugins]
  * - plugins for `EsBundler`;
- * @return {ReturnType<TryAsync<{compileResult:Promise<any>,
- * commandCalled: string;
- * compiledBinFile: string;
- * bundledJSFile:string
+ * @return {ReturnType<typeof TryAsync<{compileResult:Promise<any>|undefined,
+ * commandCalled: string|undefined;
+ * compiledBinFile: string|undefined;
+ * bundledJSFile:string|undefined
  * }>>}
  * @example
  * import { join } from 'node:path';
@@ -139,7 +142,7 @@ export async function CompileJS({
 	encoding = 'utf-8',
 	outDir,
 	compiler = undefined,
-	compilerArguments = undefined,
+	compilerArguments = {},
 	esBundlerPlugins = [],
 }) {
 	return await TryAsync(async () => {

package/src/bundler/EsBundler.mjs

@@ -41,7 +41,9 @@ export async function EsBundler(
 	esbuildOptions = {}
 ) {
 	return await TryAsync(async () => {
-		/** @type {Parameters<build>[0]['stdin']['loader']} */
+		/**
+		 * @type {import('esbuild').StdinOptions["loader"]}
+		 */
 		let loader;
 		switch (extension) {
 			case '.mts':
@@ -84,7 +86,7 @@ export async function EsBundler(
 			Console.warn(result.warnings.map((w) => w.text).join('\n'));
 		}
 		const resString = result.outputFiles?.[0]?.text;
-		if (!resString) {
+		if (resString === undefined) {
 			return '';
 		}
 		return resString;

package/src/bundler/FSInline.mjs

@@ -26,6 +26,9 @@ export class FSInline {
 	 */
 	static vivthFSInlineFile = async (filePathFromProject) => {
 		filePathFromProject = Paths.normalizesForRoot(filePathFromProject);
+		if (Paths.root === undefined) {
+			return Buffer.from([]);
+		}
 		const fullAbsolutePath = join(Paths.root, filePathFromProject);
 		return Buffer.from(await readFile(fullAbsolutePath));
 	};

package/src/bundler/FSInlineAnalyzer.mjs

@@ -15,9 +15,10 @@ import { EsBundler } from './EsBundler.mjs';
  */
 const hydrateRegex = (str) => {
 	const match = str.match(/^\/(.*)\/([a-z]*)$/);
-	if (!match) throw new Error('Invalid regex string format');
-
-	const [, pattern, flags] = match;
+	if (match === null) {
+		throw new Error('Invalid regex string format');
+	}
+	const [, pattern = '', flags] = match;
 	return new RegExp(pattern, flags);
 };
 
@@ -70,6 +71,7 @@ export class FSInlineAnalyzer {
 			const templateFile = literalFile`${'FSInline'}${'method'}${'path'}${'closing'}`;
 			const templateWorker = literalWorker`${'ref'}${'method'}${'path'}${'closing'}`;
 			const templateDir = literalDir`${'FSInline'}${'method'}${'path'}${'methodClosing'}${'rule'}${'functionClosing'}`;
+
 			const [resultMatchingFile, errorMatchingFile] = templateFile.evaluate.matchedAllAndGrouped(
 				content,
 				{
@@ -95,15 +97,26 @@ export class FSInlineAnalyzer {
 			const {
 				result: { named: namedFile },
 			} = resultMatchingFile;
+			if (Paths.root === undefined) {
+				throw new Error('Path.root undefined');
+			}
 			for (let i = 0; i < namedFile.length; i++) {
-				const { path } = namedFile[i];
+				const res = namedFile[i];
+				if (res === undefined) {
+					continue;
+				}
+				const { path } = res;
 				FSInline.vivthFSInlinelists[path] = Buffer.from(await readFile(join(Paths.root, path)));
 			}
 			const {
 				result: { named: namedWorker },
 			} = resultMatchingWorker;
 			for (let i = 0; i < namedWorker.length; i++) {
-				const { path } = namedWorker[i];
+				const res = namedWorker[i];
+				if (res === undefined) {
+					continue;
+				}
+				const { path } = res;
 				const fullPath = join(Paths.root, path);
 				const content = await readFile(fullPath, { encoding: 'utf-8' });
 				const [contentBundled, errorBundled] = await EsBundler(
@@ -134,11 +147,19 @@ export class FSInlineAnalyzer {
 				result: { named: namedDir },
 			} = resultMatchingDir;
 			for (let i = 0; i < namedDir.length; i++) {
-				let { path, rule } = namedDir[i];
+				const res = namedDir[i];
+				if (res === undefined) {
+					continue;
+				}
+				let { path, rule } = res;
 				rule = rule.trim();
 				const results = await FSInlineAnalyzer.#dir(join(Paths.root, path), hydrateRegex(rule));
 				for (let j = 0; j < results.length; j++) {
-					const { path, buffer } = results[j];
+					const res = results[j];
+					if (res === undefined) {
+						continue;
+					}
+					const { path, buffer } = res;
 					if (path in FSInline.vivthFSInlinelists) {
 						continue;
 					}
@@ -169,6 +190,9 @@ export class FSInlineAnalyzer {
 		 * @returns {Promise<void>}
 		 */
 		const walk = async (current) => {
+			if (Paths.root === undefined) {
+				return;
+			}
 			const entries = await readdir(current, {
 				recursive: false,
 				withFileTypes: true,

package/src/bundler/FSInlineBundled.mjs

@@ -12,7 +12,11 @@ export class FSInline {
 	 */
 	static vivthFSInlineFile = async (filePathFromProject) => {
 		filePathFromProject = Paths.normalizesForRoot(filePathFromProject);
-		return Buffer.from(FSInline.vivthFSInlinelists[filePathFromProject]);
+		const bufferStored = FSInline.vivthFSInlinelists[filePathFromProject];
+		if (bufferStored === undefined) {
+			return Buffer.from([]);
+		}
+		return Buffer.from(bufferStored);
 	};
 	/**
 	 * @param {string} dirPathFromProject

package/src/bundler/adds/ToBundledJSPlugin.mjs

@@ -25,7 +25,7 @@ export function ToBundledJSPlugin(includedInPath) {
 			const filePath = args.path;
 			const fileExt = extname(filePath);
 			/**
-			 * @type {'js'|'ts'}
+			 * @type {'js'|'ts'|undefined}
 			 */
 			let loader;
 			switch (fileExt) {
@@ -36,12 +36,11 @@ export function ToBundledJSPlugin(includedInPath) {
 				case '.mjs':
 				case '.cjs':
 				case '.js':
-				default:
 					loader = 'js';
 					break;
 			}
 			const originalContent = (await readFile(filePath)).toString('utf-8');
-			if (!loader) {
+			if (loader === undefined) {
 				return {
 					contents: originalContent,
 					loader,
@@ -61,7 +60,7 @@ export function ToBundledJSPlugin(includedInPath) {
 				`${realRef}${fileExt}`
 			);
 			const isExist = await exists(runtimeFile);
-			if (!isExist) {
+			if (isExist === false) {
 				return {
 					contents: originalContent,
 					loader,

package/src/class/Console.mjs

@@ -43,7 +43,9 @@ export class Console {
 	 * 	hello: 'world!!',
 	 * });
 	 */
-	static log = (data) => Console.#call('🟢', 'log', data);
+	static log = (data) => {
+		return Console.#call('🟢', 'log', data);
+	};
 	/**
 	 * @description
 	 * @param {any} data
@@ -55,7 +57,9 @@ export class Console {
 	 * 	hello: 'world!!',
 	 * });
 	 */
-	static info = (data) => Console.#call('🔵', 'info', data);
+	static info = (data) => {
+		return Console.#call('🔵', 'info', data);
+	};
 	/**
 	 * @description
 	 * @param {any} data
@@ -67,7 +71,9 @@ export class Console {
 	 * 	hello: 'world!!',
 	 * });
 	 */
-	static warn = (data) => Console.#call('🟠', 'warn', data);
+	static warn = (data) => {
+		return Console.#call('🟠', 'warn', data);
+	};
 	/**
 	 * @description
 	 * @param {any} data
@@ -79,5 +85,7 @@ export class Console {
 	 * 	hello: 'world!!',
 	 * });
 	 */
-	static error = (data) => Console.#call('🔴', 'error', data);
+	static error = (data) => {
+		return Console.#call('🔴', 'error', data);
+	};
 }

package/src/class/Derived.mjs

@@ -17,7 +17,7 @@ export class Derived extends Signal {
 	 * @description
 	 * - Derived used [Signal](#signal) and [Effect](#effect) under the hood;
 	 * @param {(effectInstanceOptions:Omit<Effect["options"] &
-	 * Derived["options"], unwrapLazy>) =>
+	 * Derived<VALUE>["options"], unwrapLazy>) =>
 	 * Promise<VALUE>} derivedFunction
 	 * @example
 	 * import { Signal, Derived } from  'vivth';
@@ -36,6 +36,7 @@ export class Derived extends Signal {
 	 * count.value++;
 	 */
 	constructor(derivedFunction) {
+		// @ts-expect-error
 		super(undefined);
 		const derived_instanceOptions = this.options;
 		new Effect(async (options) => {
@@ -89,7 +90,9 @@ export class Derived extends Signal {
 	 * @description
 	 * - the most recent value of the instance
 	 * - can be turn into reactive with Effect or Derived instantiation;
+	 * - initial value are always `undefined`, make sure to put a check before consuming(inside an `Effect`);
 	 * @returns {VALUE}
+	 * @override
 	 */
 	get value() {
 		return super.value;
@@ -100,6 +103,7 @@ export class Derived extends Signal {
 	 * - it's value should always be determined by it's own `derivedFunction`;
 	 * @private
 	 * @type {VALUE}
+	 * @override
 	 */
 	set value(newValue) {
 		Console.warn({

package/src/class/Effect.mjs

@@ -69,9 +69,9 @@ export class Effect {
 			 * @instance options
 			 * @description
 			 * - normally it's passed as argument to constructor, however it is also accessible from `options` property;
-			 * @template {Signal} SIGNAL
-			 * @param {SIGNAL} signal
-			 * @returns {SIGNAL}
+			 * @template V
+			 * @param {Signal<V>} signal
+			 * @returns {Signal<V>}
 			 * @example
 			 * import { Effect } from 'vivth';
 			 *
@@ -81,7 +81,7 @@ export class Effect {
 			 * effect.options.subscribe(signalInstance);
 			 */
 			subscribe: (signal) => {
-				if (!(signal instanceof Signal)) {
+				if (signal instanceof Signal === false) {
 					// @ts-expect-error
 					signal = signal[unwrapLazy]();
 				}
@@ -136,7 +136,7 @@ export class Effect {
 	/**
 	 * @type {Object}
 	 */
-	#current;
+	#current = {};
 	/**
 	 * @param {Omit<Effect["options"], typeof unwrapLazy>} effectInstance
 	 * @returns {Promise<void>}
@@ -158,7 +158,7 @@ export class Effect {
 		TryAsync(async () => {
 			await this.#effect(this.options[unwrapLazy]());
 		}).then(([, error]) => {
-			if (!error) {
+			if (error === undefined) {
 				return;
 			}
 			Console.error(error);

package/src/class/EnvSignal.mjs

@@ -7,7 +7,6 @@ import { Signal } from './Signal.mjs';
 
 /**
  * @description
- * - non browser API;
  * - uses [Signal](#signal) and [Derived](#derived) under the hood;
  * @template VALUE
  */
@@ -19,16 +18,10 @@ export class EnvSignal {
 	 */
 	constructor(initialValue) {
 		this.#proxyConst = LazyFactory(() => new Signal(initialValue));
-		let isRun = false;
 		this.env = LazyFactory(
 			() =>
 				new Derived(async ({ subscribe }) => {
-					const derived = subscribe(this.#proxyConst).value;
-					if (!isRun) {
-						isRun = true;
-						return initialValue;
-					}
-					return derived;
+					return subscribe(this.#proxyConst).value;
 				})
 		);
 	}

package/src/class/EventSignal.mjs

@@ -21,7 +21,7 @@ export class EventSignal {
 	/**
 	 * @description
 	 * - `Map` of `EventSignal`, using the `stringName` of the `EventSignal_instance` as `key`;
-	 * @type {Map<string, EventSignal>}
+	 * @type {Map<string, EventSignal<any>>}
 	 */
 	static map = new Map();
 	/**
@@ -35,22 +35,23 @@ export class EventSignal {
 	 * >- the `Promise` nature is to prevent race condition on creating the instance;
 	 * @param {string} stringName
 	 * @param {IsListSignal} [isList_]
-	 * @returns {Promise<EventSignal>}
+	 * @returns {Promise<EventSignal<any>>}
 	 * @example
 	 * import { EventSignal } from 'vivth';
 	 *
 	 * const myEventSignal = await EventSignal.get('dataEvent');
 	 */
-	static async get(stringName, isList_ = false) {
+	static get = async (stringName, isList_ = false) => {
 		const { resume } = await EventSignal.#qChannelEventSignal.key(stringName);
 		const mapped = EventSignal.map;
-		if (!mapped.has(stringName)) {
+		if (mapped.has(stringName) === false) {
 			let instance = new EventSignal(stringName, isList_);
 			mapped.set(stringName, instance);
 		}
 		resume();
+		// @ts-expect-error
 		return mapped.get(stringName);
-	}
+	};
 	/**
 	 * @private
 	 * @param {string} name
@@ -74,7 +75,7 @@ export class EventSignal {
 	 * - is [Signal](#signal) or [ListSignal](#listsignal) instance, depending on the `isList` argument;
 	 * - if needed to pass along the messages, it can be used as `dispatcher` and `listener` at the same time;
 	 * - is `lazily` created;
-	 * @type {Signal|ListSignal}
+	 * @type {Signal<any>|ListSignal<any>}
 	 * @example
 	 * import { EventSignal, Effect, Console } from 'vivth';
 	 *
@@ -98,7 +99,7 @@ export class EventSignal {
 	 * - is [Derived](#derived) or [ListDerived](#listderived) instance, depending on the `isList` argument;
 	 * - can be used as listener when passed down value shouldn't be modified manually;
 	 * - is `lazily` created along with `dispatch`, if `listen` is accessed first, then `dispatch` will also be created automatically;
-	 * @type {Derived|ListDerived}
+	 * @type {Derived<any>|ListDerived<any>}
 	 * @example
 	 * import { EventSignal, Effect, Console } from 'vivth';
 	 *

package/src/class/FileSafe.mjs

@@ -109,7 +109,7 @@ export class FileSafe {
 	 * - also returning promise of result & error as value;
 	 * @param {Parameters<mkdir>[0]} outDir
 	 * - absolute path
-	 * @returns {ReturnType<typeof TryAsync<string>>}
+	 * @returns {ReturnType<typeof TryAsync<string|undefined>>}
 	 * @example
 	 * import { join } from 'node:path';
 	 * import { FileSafe, Paths } from 'vivth';

package/src/class/ListSignal.mjs

@@ -22,8 +22,10 @@ export class ListSignal extends Signal {
 	 * @param {unknown} value - The value to validate.
 	 * @returns {value is Array<Record<string, string>>} True if the first item is a valid string record or array is empty.
 	 */
-	static isValid = (value) => {
-		if (!Array.isArray(value)) return false;
+	static isValid(value) {
+		if (Array.isArray(value) === false) {
+			return false;
+		}
 		const first = value[0];
 		if (first === undefined) {
 			// allow empty array
@@ -37,7 +39,7 @@ export class ListSignal extends Signal {
 				([key, val]) => typeof key === 'string' && typeof val === 'string'
 			)
 		);
-	};
+	}
 	/**
 	 * @description
 	 * - usefull for `loops`;
@@ -57,6 +59,7 @@ export class ListSignal extends Signal {
 	 * @description
 	 * - reference to original inputed `value`;
 	 * @returns {LISTARG[]}
+	 * @override
 	 */
 	get value() {
 		return super.value;
@@ -66,6 +69,7 @@ export class ListSignal extends Signal {
 	 * - you cannot mannually set`value` `ListSignal_instance`;
 	 * @private
 	 * @type {LISTARG[]}
+	 * @override
 	 */
 	set value(_) {
 		Console.error('`List.value` `setter` are not available outside the class or instance');
@@ -158,7 +162,7 @@ export class ListSignal extends Signal {
 			 */
 			splice: (start, deleteCount, ...listArg) => {
 				const end = start + deleteCount - 1;
-				if (!this.#checkLength('splice', end)) {
+				if (this.#checkLength('splice', end) === false) {
 					return;
 				}
 				super.value.splice(start, deleteCount, ...listArg);
@@ -173,9 +177,13 @@ export class ListSignal extends Signal {
 			 * @returns {void}
 			 */
 			swap: (indexA, indexB) => {
-				if (!this.#checkLength('swap', indexA) || !this.#checkLength('swap', indexB)) {
+				if (
+					this.#checkLength('swap', indexA) === false ||
+					this.#checkLength('swap', indexB) === false
+				) {
 					return;
 				}
+				// @ts-expect-error
 				[super.value[indexA], super.value[indexB]] = [super.value[indexB], super.value[indexA]];
 				this.subscribers.notify();
 			},
@@ -188,15 +196,15 @@ export class ListSignal extends Signal {
 			 * @returns {void}
 			 */
 			modify: (index, listArg) => {
-				if (!this.#checkLength('modify', index)) {
+				if (this.#checkLength('modify', index) === false) {
 					return;
 				}
 				for (const key in listArg) {
 					const listArgKey = listArg[key];
-					if (!listArgKey) {
-						continue;
+					if (listArgKey) {
+						// @ts-expect-error
+						super.value[index][key] = listArgKey;
 					}
-					super.value[index][key] = listArgKey;
 				}
 				this.subscribers.notify();
 			},
@@ -208,7 +216,7 @@ export class ListSignal extends Signal {
 			 * @returns {void}
 			 */
 			remove: (index) => {
-				if (!this.#checkLength('remove', index)) {
+				if (this.#checkLength('remove', index) === false) {
 					return;
 				}
 				this.arrayMethods.splice(index, 1);