vivth 1.4.9 → 1.5.0

package/dev/auto/.src.ignore

@@ -0,0 +1,25 @@
+# D:/M/fdr/web/lib/vivth/.gitignore
+# D:/M/fdr/web/lib/vivth/.npmignore
+
+/node_modules/
+
+/dev-bun/
+
+**/*.as.ts
+**/*/test/
+/test/
+/deprecated/
+/.vscode/
+
+/proof-of-concept/
+# /src/web/
+.vivth
+
+/dist/
+/generated/types/proof-of-concept/
+
+# prevent vivth unready file to be uploaded 
+-*
+*.test.*
+
+/doesnotwork/

package/dev/auto-doc.mjs

@@ -0,0 +1,137 @@
+// @ts-check
+
+import process from 'node:process';
+import { join } from 'node:path';
+/**
+ * - on working library you should import from `vivth/${platformName}`
+ * - `/dev/auto-doc.mjs` imports directly to the file, because `vivth` modify it's own exports and might throw error when some of the file `modified`/`deleted`;
+ */
+// import {
+//
+// 	SafeExit,
+// 	JSautoDOC,
+// 	FileSelfMapper,
+// 	GetModuleEsbuildPlatform,
+// CompileJS,
+// RunWatchThenCompileJSOnSafeExit,
+// } from 'vivth/node';
+// import {
+//
+// 	Paths,
+// 	Console,
+// 	ForOfSync,
+// 	TryAsync,
+// 	TracePath,
+// } from 'vivth/neutral';
+
+import { SafeExit } from '../src/class/SafeExit.mjs';
+import { JSautoDOC } from '../src/doc/JSautoDOC.mjs';
+import { FileSelfMapper } from '../src/bundler/FileSelfMapper.mjs';
+import { Paths } from '../src/class/Paths.mjs';
+import { Console } from '../src/class/Console.mjs';
+import stripJsonComments from 'strip-json-comments';
+// import { RunWatchThenCompileJSOnSafeExit } from '../src/bundler/RunWatchThenCompileJSOnSafeExit.mjs';
+// import { TryAsync } from '../src/function/TryAsync.mjs';
+// import { GetModuleEsbuildPlatform } from '../src/function/GetModuleEsbuildPlatform.mjs';
+// import { ForOfSync } from '../src/function/ForOfSync.mjs';
+// import { Console } from '../src/class/Console.mjs';
+// import { LazyFactory } from '../src/function/LazyFactory.mjs';
+// import { FactoryKey } from '../src/common/FactoryKey.mjs';
+// import { GetModuleEsbuildPlatform } from '../src/function/GetModuleEsbuildPlatform.mjs';
+
+new Paths({
+	root: process.env?.INIT_CWD ?? process.cwd(),
+});
+
+new SafeExit(
+	/**  */
+	'SIGINT',
+	'SIGTERM',
+);
+
+// const a = LazyFactory(() => {
+// 	Console.log('preparation, should only run once');
+// 	/**
+// 	 * @param {string} m
+// 	 */
+// 	return (m) => {
+// 		Console.log(m);
+// 	};
+// });
+// a('hello world');
+
+new JSautoDOC({
+	src: 'src',
+	copyright: 'this library is made and distributed under MIT license;',
+	tableOfContentTitle: 'list of exported API and typehelpers',
+	assemblyScriptOptions: {
+		ASArgv: [],
+		generateFSasarImporter: true,
+	},
+	maxDebounceForGeneratingDocAndExport: 1_000,
+});
+
+new FileSelfMapper('/dev/auto/', {
+	deleteTempFilesAfterExit: false,
+});
+
+// await RunWatchThenCompileJSOnSafeExit({
+// 	showLog: true,
+// 	source: '/test/watchrun/hi.mjs',
+// 	target: '/test/watchrun/compile-bun/',
+// 	compileJSargs: {
+// 		minifyFirst: true,
+// 		esbuildOptions: {},
+// 		compilerArguments: {
+// 			target: 'bun-win-x64',
+// 		},
+// 		encoding: 'utf-8',
+// 	},
+// });
+
+// SafeExit.instance?.addCallback(async () => {
+// 	await Promise.all(
+// 		ForOfSync(
+// 			[
+// 				'/src/bundler/FSasar.mjs',
+// 				'/src/function/TryAsync.mjs',
+// 				'/src/bundler/CompileAS.mjs',
+// 				'/src/class/Effect.mjs',
+// 				'/src/class/EventSignal.mjs',
+// 				'/src/class/ListSignal.mjs',
+// 				'/src/class/ObjectSignal.mjs',
+// 				'/src/class/LitExp.mjs',
+// 				'/src/common/Base64URL.mjs',
+// 				'/check/something/this/must/be/not/supported',
+// 			],
+// 			async (path) => {
+// 				Console.log({ path, platform: await GetModuleEsbuildPlatform(join(Paths.root, path)) });
+// 			},
+// 		)[0],
+// 	);
+// });
+
+// await TryAsync(async () => {
+// 	const result = await Promise.all(
+// 		ForOfSync(
+// 			[
+// 				'/src/bundler/FSasar.mjs',
+// 				'/src/function/TryAsync.mjs',
+// 				'/src/bundler/CompileAS.mjs',
+// 				'/src/class/Effect.mjs',
+// 				'/src/class/EventSignal.mjs',
+// 				'/src/class/ListSignal.mjs',
+// 				'/src/class/ObjectSignal.mjs',
+// 				'/src/class/LitExp.mjs',
+// 				'/src/common/Base64URL.mjs',
+// 				'/check/something/this/must/be/not/supported',
+// 			],
+// 			async (path) => {
+// 				return { path, platform: await GetModuleEsbuildPlatform(join(Paths.root, path)) };
+// 			},
+// 		)[0],
+// 	);
+// 	Console.log(result);
+// });
+
+// await SafeExit.overrideLongRunningProccess.toBeAwaitedTopLevel;

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

@@ -0,0 +1,145 @@
+export { BrowserExternals } from "../../../src/bundler/adds/BrowserExternals.mjs";
+export { CreateTransform } from "../../../src/bundler/adds/CreateTransform.mjs";
+export { LastEditedUnix } from "../../../src/bundler/adds/LastEditedUnix.mjs";
+export { NodeModuleList } from "../../../src/bundler/adds/NodeModuleList.mjs";
+export { PathFSBundles } from "../../../src/bundler/adds/PathFSBundles.mjs";
+export { PathFSDir } from "../../../src/bundler/adds/PathFSDir.mjs";
+export { PathFSFile } from "../../../src/bundler/adds/PathFSFile.mjs";
+export { ToBundledJSPlugin } from "../../../src/bundler/adds/ToBundledJSPlugin.mjs";
+export { CompileAS } from "../../../src/bundler/CompileAS.mjs";
+export { CompileJS } from "../../../src/bundler/CompileJS.mjs";
+export { CreateESPlugin } from "../../../src/bundler/CreateESPlugin.mjs";
+export { EsBundler } from "../../../src/bundler/EsBundler.mjs";
+export { FileSelfMapper } from "../../../src/bundler/FileSelfMapper.mjs";
+export { FSAnalyzer } from "../../../src/bundler/FSAnalyzer.mjs";
+export { FSasar } from "../../../src/bundler/FSasar.mjs";
+export { JSDirMapper } from "../../../src/bundler/JSDirMapper.mjs";
+export { RunWatchThenCompileJSOnSafeExit } from "../../../src/bundler/RunWatchThenCompileJSOnSafeExit.mjs";
+export { AwaitSignal } from "../../../src/class/AwaitSignal.mjs";
+export { Console } from "../../../src/class/Console.mjs";
+export { DataLog } from "../../../src/class/DataLog.mjs";
+export { Derived } from "../../../src/class/Derived.mjs";
+export { Effect } from "../../../src/class/Effect.mjs";
+export { EnvSignal } from "../../../src/class/EnvSignal.mjs";
+export { EsWatcher } from "../../../src/class/EsWatcher.mjs";
+export { EventSignal } from "../../../src/class/EventSignal.mjs";
+export { FileSafe } from "../../../src/class/FileSafe.mjs";
+export { ForEach } from "../../../src/class/ForEach.mjs";
+export { ForSignal } from "../../../src/class/ForSignal.mjs";
+export { FSDirArchWatcher } from "../../../src/class/FSDirArchWatcher.mjs";
+export { GetterSetter } from "../../../src/class/GetterSetter.mjs";
+export { JSONFileHandler } from "../../../src/class/JSONFileHandler.mjs";
+export { ListSignal } from "../../../src/class/ListSignal.mjs";
+export { LitExp } from "../../../src/class/LitExp.mjs";
+export { ObjectSignal } from "../../../src/class/ObjectSignal.mjs";
+export { Paths } from "../../../src/class/Paths.mjs";
+export { Prettivy } from "../../../src/class/Prettivy.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 { SignalCollection } from "../../../src/class/SignalCollection.mjs";
+export { WalkThrough } from "../../../src/class/WalkThrough.mjs";
+export { WorkerMainThread } from "../../../src/class/WorkerMainThread.mjs";
+export { WorkerResult } from "../../../src/class/WorkerResult.mjs";
+export { WorkerThread } from "../../../src/class/WorkerThread.mjs";
+export { Base64URL } from "../../../src/common/Base64URL.mjs";
+export { Base64URLFromFile } from "../../../src/common/Base64URLFromFile.mjs";
+export { BundledV } from "../../../src/common/BundledV.mjs";
+export { CreateStringID } from "../../../src/common/CreateStringID.mjs";
+export { EnvMode } from "../../../src/common/EnvMode.mjs";
+export { EventNameSpace } from "../../../src/common/EventNameSpace.mjs";
+export { FactoryKey } from "../../../src/common/FactoryKey.mjs";
+export { Preferrence } from "../../../src/common/Preferrence.mjs";
+export { Trace } from "../../../src/common/Trace.mjs";
+export { TracePath } from "../../../src/common/TracePath.mjs";
+export { VivthUnBundledCodeBlock } from "../../../src/common/VivthUnBundledCodeBlock.mjs";
+export { JSautoDOC } from "../../../src/doc/JSautoDOC.mjs";
+export { ClearRequireCache } from "../../../src/function/ClearRequireCache.mjs";
+export { CreateImmutable } from "../../../src/function/CreateImmutable.mjs";
+export { EventCheck } from "../../../src/function/EventCheck.mjs";
+export { EventObject } from "../../../src/function/EventObject.mjs";
+export { ForInAsync } from "../../../src/function/ForInAsync.mjs";
+export { ForInSync } from "../../../src/function/ForInSync.mjs";
+export { ForOfAsync } from "../../../src/function/ForOfAsync.mjs";
+export { ForOfSync } from "../../../src/function/ForOfSync.mjs";
+export { GetBufferFromRelativePath } from "../../../src/function/GetBufferFromRelativePath.mjs";
+export { GetFilesFromDir } from "../../../src/function/GetFilesFromDir.mjs";
+export { GetMaxFilenameLength } from "../../../src/function/GetMaxFilenameLength.mjs";
+export { GetModuleEsbuildPlatform } from "../../../src/function/GetModuleEsbuildPlatform.mjs";
+export { GetNamedImportAlias } from "../../../src/function/GetNamedImportAlias.mjs";
+export { GetRuntime } from "../../../src/function/GetRuntime.mjs";
+export { InstantiateAssemblyScript } from "../../../src/function/InstantiateAssemblyScript.mjs";
+export { IsAsync } from "../../../src/function/IsAsync.mjs";
+export { IsInstanceOf } from "../../../src/function/IsInstanceOf.mjs";
+export { IsSameFile } from "../../../src/function/IsSameFile.mjs";
+export { IsStringLooksLikeAPath } from "../../../src/function/IsStringLooksLikeAPath.mjs";
+export { IsTypeOf } from "../../../src/function/IsTypeOf.mjs";
+export { LazyFactory } from "../../../src/function/LazyFactory.mjs";
+export { MonkeyPatch } from "../../../src/function/MonkeyPatch.mjs";
+export { NewAnimationTimeline } from "../../../src/function/NewAnimationTimeline.mjs";
+export { NewChainable } from "../../../src/function/NewChainable.mjs";
+export { NewDynamicsExport } from "../../../src/function/NewDynamicsExport.mjs";
+export { NewObjectWrapper } from "../../../src/function/NewObjectWrapper.mjs";
+export { ObjectRegistrar } from "../../../src/function/ObjectRegistrar.mjs";
+export { ParseSQLFile } from "../../../src/function/ParseSQLFile.mjs";
+export { PipeAsync } from "../../../src/function/PipeAsync.mjs";
+export { PipeSync } from "../../../src/function/PipeSync.mjs";
+export { SafeImport } from "../../../src/function/SafeImport.mjs";
+export { TemplateLiteral } from "../../../src/function/TemplateLiteral.mjs";
+export { Timeout } from "../../../src/function/Timeout.mjs";
+export { Tries } from "../../../src/function/Tries.mjs";
+export { TryAsync } from "../../../src/function/TryAsync.mjs";
+export { TryNew } from "../../../src/function/TryNew.mjs";
+export { TrySync } from "../../../src/function/TrySync.mjs";
+export { TsToMjs } from "../../../src/function/TsToMjs.mjs";
+export { UniqueFSTempName } from "../../../src/function/UniqueFSTempName.mjs";
+export { VivthyNeinth } from "../../../src/neinth/VivthyNeinth.mjs";
+export { WC_createElement_bind } from "../../../src/web/bindings/WC_createElement_bind.mjs";
+export { WC_createNamedSlot } from "../../../src/web/bindings/WC_createNamedSlot.mjs";
+export { WC_litRender_bind } from "../../../src/web/bindings/WC_litRender_bind.mjs";
+export { WC_litStyleMap } from "../../../src/web/bindings/WC_litStyleMap.mjs";
+export { WC_StyleProp_bind } from "../../../src/web/bindings/WC_StyleProp_bind.mjs";
+export { BrowserDirMapper } from "../../../src/web/BrowserDirMapper.mjs";
+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 { 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";
+export { WC_loopedSiblingsRef } from "../../../src/web/signals/WC_loopedSiblingsRef.mjs";
+export { ViteAddDynamics } from "../../../src/web/ViteAddDynamics.mjs";
+export { ViteGetAllHTMLFile } from "../../../src/web/ViteGetAllHTMLFile.mjs";
+export { WC_extendsA } from "../../../src/web/WC_extendsA.mjs";
+export { WC_extendsB } from "../../../src/web/WC_extendsB.mjs";
+export type AnyButUndefined = import("../../../src/typehints/AnyButUndefined.mjs").AnyButUndefined;
+export type ArrayToKeys<T extends readonly unknown[]> = import("../../../src/typehints/ArrayToKeys.mjs").ArrayToKeys<T>;
+export type AssemblyScriptExportsType<RESULTTYPE extends Record<string, unknown>> = import("../../../src/typehints/AssemblyScriptExportsType.mjs").AssemblyScriptExportsType<RESULTTYPE>;
+export type AssemblyScriptLoaderInstantiate<RESULTTYPE extends Record<string, unknown>> = import("../../../src/typehints/AssemblyScriptLoaderInstantiate.mjs").AssemblyScriptLoaderInstantiate<RESULTTYPE>;
+export type AutoDocASOptions = import("../../../src/typehints/AutoDocASOptions.mjs").AutoDocASOptions;
+export type ChainableType<OBJ extends object> = import("../../../src/typehints/ChainableType.mjs").ChainableType<OBJ>;
+export type ComponentDecorator_Constructor<BASE extends new (...args: any[]) => HTMLElement, ATTRS extends readonly string[]> = import("../../../src/typehints/ComponentDecorator_Constructor.mjs").ComponentDecorator_Constructor<BASE, ATTRS>;
+export type ConsoleAdditionalSettingType = import("../../../src/typehints/ConsoleAdditionalSettingType.mjs").ConsoleAdditionalSettingType;
+export type Decorator<OriginalFn extends (...args: any[]) => any, DecoratorArgs extends readonly unknown[]> = import("../../../src/typehints/Decorator.mjs").Decorator<OriginalFn, DecoratorArgs>;
+export type DecoratorMonkeyPatch<OriginalFn extends (...args: any[]) => any, DecoratorArgs extends readonly unknown[]> = import("../../../src/typehints/DecoratorMonkeyPatch.mjs").DecoratorMonkeyPatch<OriginalFn, DecoratorArgs>;
+export type DevTestCB = import("../../../src/typehints/DevTestCB.mjs").DevTestCB;
+export type EnvModeType = import("../../../src/typehints/EnvModeType.mjs").EnvModeType;
+export type ExtnameType = import("../../../src/typehints/ExtnameType.mjs").ExtnameType;
+export type ListArg = import("../../../src/typehints/ListArg.mjs").ListArg;
+export type LitExpKeyType = import("../../../src/typehints/LitExpKeyType.mjs").LitExpKeyType;
+export type LitExpResultType<KEYS extends import("./../../../src/typehints/LitExpKeyType.mjs").LitExpKeyType> = import("../../../src/typehints/LitExpResultType.mjs").LitExpResultType<KEYS>;
+export type MonkeyPatchedType<ORIOBJ extends unknown> = import("../../../src/typehints/MonkeyPatchedType.mjs").MonkeyPatchedType<ORIOBJ>;
+export type MutationType = import("../../../src/typehints/MutationType.mjs").MutationType;
+export type ParametersFollowingN<METHOD extends (...args: any[]) => any, N extends number> = import("../../../src/typehints/ParametersFollowingN.mjs").ParametersFollowingN<METHOD, N>;
+export type PrefixedKeysOf<T extends unknown, Prefix extends string> = import("../../../src/typehints/PrefixedKeysOf.mjs").PrefixedKeysOf<T, Prefix>;
+export type QCBFIFOReturn = import("../../../src/typehints/QCBFIFOReturn.mjs").QCBFIFOReturn;
+export type QCBReturn = import("../../../src/typehints/QCBReturn.mjs").QCBReturn;
+export type Runtime = import("../../../src/typehints/Runtime.mjs").Runtime;
+export type SafeImportReturnType<IMPORTTARGET extends unknown> = import("../../../src/typehints/SafeImportReturnType.mjs").SafeImportReturnType<IMPORTTARGET>;
+export type StylePropRefType<STRTYPE extends string> = import("../../../src/typehints/StylePropRefType.mjs").StylePropRefType<STRTYPE>;
+export type TemplateLiteralValueHandler<INPUTTYPE extends unknown> = import("../../../src/typehints/TemplateLiteralValueHandler.mjs").TemplateLiteralValueHandler<INPUTTYPE>;
+export type VivthCleanup = import("../../../src/typehints/VivthCleanup.mjs").VivthCleanup;
+export type VLifecycleCallbacks<TAGNAME extends keyof HTMLElementTagNameMap> = import("../../../src/typehints/VLifecycleCallbacks.mjs").VLifecycleCallbacks<TAGNAME>;
+export type WC_TagName_type<TAG extends string> = import("../../../src/web/common/WC_TagName_type.mjs").WC_TagName_type<TAG>;
+export type EnsureValidTag<T extends string> = import("../../../src/web/EnsureValidTag.mjs").EnsureValidTag<T>;

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

@@ -0,0 +1,105 @@
+export { CreateESPlugin } from "../../../src/bundler/CreateESPlugin.mjs";
+export { AwaitSignal } from "../../../src/class/AwaitSignal.mjs";
+export { Console } from "../../../src/class/Console.mjs";
+export { DataLog } from "../../../src/class/DataLog.mjs";
+export { Derived } from "../../../src/class/Derived.mjs";
+export { Effect } from "../../../src/class/Effect.mjs";
+export { EnvSignal } from "../../../src/class/EnvSignal.mjs";
+export { EventSignal } from "../../../src/class/EventSignal.mjs";
+export { ForEach } from "../../../src/class/ForEach.mjs";
+export { ForSignal } from "../../../src/class/ForSignal.mjs";
+export { GetterSetter } from "../../../src/class/GetterSetter.mjs";
+export { ListSignal } from "../../../src/class/ListSignal.mjs";
+export { LitExp } from "../../../src/class/LitExp.mjs";
+export { ObjectSignal } from "../../../src/class/ObjectSignal.mjs";
+export { Paths } from "../../../src/class/Paths.mjs";
+export { QChannel } from "../../../src/class/QChannel.mjs";
+export { Signal } from "../../../src/class/Signal.mjs";
+export { SignalCollection } from "../../../src/class/SignalCollection.mjs";
+export { WalkThrough } from "../../../src/class/WalkThrough.mjs";
+export { WorkerMainThread } from "../../../src/class/WorkerMainThread.mjs";
+export { WorkerResult } from "../../../src/class/WorkerResult.mjs";
+export { WorkerThread } from "../../../src/class/WorkerThread.mjs";
+export { Base64URL } from "../../../src/common/Base64URL.mjs";
+export { BundledV } from "../../../src/common/BundledV.mjs";
+export { CreateStringID } from "../../../src/common/CreateStringID.mjs";
+export { EnvMode } from "../../../src/common/EnvMode.mjs";
+export { EventNameSpace } from "../../../src/common/EventNameSpace.mjs";
+export { FactoryKey } from "../../../src/common/FactoryKey.mjs";
+export { Preferrence } from "../../../src/common/Preferrence.mjs";
+export { Trace } from "../../../src/common/Trace.mjs";
+export { TracePath } from "../../../src/common/TracePath.mjs";
+export { VivthUnBundledCodeBlock } from "../../../src/common/VivthUnBundledCodeBlock.mjs";
+export { CreateImmutable } from "../../../src/function/CreateImmutable.mjs";
+export { EventCheck } from "../../../src/function/EventCheck.mjs";
+export { EventObject } from "../../../src/function/EventObject.mjs";
+export { ForInAsync } from "../../../src/function/ForInAsync.mjs";
+export { ForInSync } from "../../../src/function/ForInSync.mjs";
+export { ForOfAsync } from "../../../src/function/ForOfAsync.mjs";
+export { ForOfSync } from "../../../src/function/ForOfSync.mjs";
+export { GetNamedImportAlias } from "../../../src/function/GetNamedImportAlias.mjs";
+export { GetRuntime } from "../../../src/function/GetRuntime.mjs";
+export { IsAsync } from "../../../src/function/IsAsync.mjs";
+export { IsInstanceOf } from "../../../src/function/IsInstanceOf.mjs";
+export { IsSameFile } from "../../../src/function/IsSameFile.mjs";
+export { IsStringLooksLikeAPath } from "../../../src/function/IsStringLooksLikeAPath.mjs";
+export { IsTypeOf } from "../../../src/function/IsTypeOf.mjs";
+export { LazyFactory } from "../../../src/function/LazyFactory.mjs";
+export { MonkeyPatch } from "../../../src/function/MonkeyPatch.mjs";
+export { NewAnimationTimeline } from "../../../src/function/NewAnimationTimeline.mjs";
+export { NewChainable } from "../../../src/function/NewChainable.mjs";
+export { NewObjectWrapper } from "../../../src/function/NewObjectWrapper.mjs";
+export { ObjectRegistrar } from "../../../src/function/ObjectRegistrar.mjs";
+export { PipeAsync } from "../../../src/function/PipeAsync.mjs";
+export { PipeSync } from "../../../src/function/PipeSync.mjs";
+export { TemplateLiteral } from "../../../src/function/TemplateLiteral.mjs";
+export { Timeout } from "../../../src/function/Timeout.mjs";
+export { Tries } from "../../../src/function/Tries.mjs";
+export { TryAsync } from "../../../src/function/TryAsync.mjs";
+export { TryNew } from "../../../src/function/TryNew.mjs";
+export { TrySync } from "../../../src/function/TrySync.mjs";
+export { WC_createElement_bind } from "../../../src/web/bindings/WC_createElement_bind.mjs";
+export { WC_createNamedSlot } from "../../../src/web/bindings/WC_createNamedSlot.mjs";
+export { WC_litRender_bind } from "../../../src/web/bindings/WC_litRender_bind.mjs";
+export { WC_litStyleMap } from "../../../src/web/bindings/WC_litStyleMap.mjs";
+export { WC_StyleProp_bind } from "../../../src/web/bindings/WC_StyleProp_bind.mjs";
+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 { 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";
+export { WC_loopedSiblingsRef } from "../../../src/web/signals/WC_loopedSiblingsRef.mjs";
+export { WC_extendsA } from "../../../src/web/WC_extendsA.mjs";
+export { WC_extendsB } from "../../../src/web/WC_extendsB.mjs";
+export type AnyButUndefined = import("../../../src/typehints/AnyButUndefined.mjs").AnyButUndefined;
+export type ArrayToKeys<T extends readonly unknown[]> = import("../../../src/typehints/ArrayToKeys.mjs").ArrayToKeys<T>;
+export type AssemblyScriptExportsType<RESULTTYPE extends Record<string, unknown>> = import("../../../src/typehints/AssemblyScriptExportsType.mjs").AssemblyScriptExportsType<RESULTTYPE>;
+export type AssemblyScriptLoaderInstantiate<RESULTTYPE extends Record<string, unknown>> = import("../../../src/typehints/AssemblyScriptLoaderInstantiate.mjs").AssemblyScriptLoaderInstantiate<RESULTTYPE>;
+export type AutoDocASOptions = import("../../../src/typehints/AutoDocASOptions.mjs").AutoDocASOptions;
+export type ChainableType<OBJ extends object> = import("../../../src/typehints/ChainableType.mjs").ChainableType<OBJ>;
+export type ComponentDecorator_Constructor<BASE extends new (...args: any[]) => HTMLElement, ATTRS extends readonly string[]> = import("../../../src/typehints/ComponentDecorator_Constructor.mjs").ComponentDecorator_Constructor<BASE, ATTRS>;
+export type ConsoleAdditionalSettingType = import("../../../src/typehints/ConsoleAdditionalSettingType.mjs").ConsoleAdditionalSettingType;
+export type Decorator<OriginalFn extends (...args: any[]) => any, DecoratorArgs extends readonly unknown[]> = import("../../../src/typehints/Decorator.mjs").Decorator<OriginalFn, DecoratorArgs>;
+export type DecoratorMonkeyPatch<OriginalFn extends (...args: any[]) => any, DecoratorArgs extends readonly unknown[]> = import("../../../src/typehints/DecoratorMonkeyPatch.mjs").DecoratorMonkeyPatch<OriginalFn, DecoratorArgs>;
+export type DevTestCB = import("../../../src/typehints/DevTestCB.mjs").DevTestCB;
+export type EnvModeType = import("../../../src/typehints/EnvModeType.mjs").EnvModeType;
+export type ExtnameType = import("../../../src/typehints/ExtnameType.mjs").ExtnameType;
+export type ListArg = import("../../../src/typehints/ListArg.mjs").ListArg;
+export type LitExpKeyType = import("../../../src/typehints/LitExpKeyType.mjs").LitExpKeyType;
+export type LitExpResultType<KEYS extends import("./../../../src/typehints/LitExpKeyType.mjs").LitExpKeyType> = import("../../../src/typehints/LitExpResultType.mjs").LitExpResultType<KEYS>;
+export type MonkeyPatchedType<ORIOBJ extends unknown> = import("../../../src/typehints/MonkeyPatchedType.mjs").MonkeyPatchedType<ORIOBJ>;
+export type MutationType = import("../../../src/typehints/MutationType.mjs").MutationType;
+export type ParametersFollowingN<METHOD extends (...args: any[]) => any, N extends number> = import("../../../src/typehints/ParametersFollowingN.mjs").ParametersFollowingN<METHOD, N>;
+export type PrefixedKeysOf<T extends unknown, Prefix extends string> = import("../../../src/typehints/PrefixedKeysOf.mjs").PrefixedKeysOf<T, Prefix>;
+export type QCBFIFOReturn = import("../../../src/typehints/QCBFIFOReturn.mjs").QCBFIFOReturn;
+export type QCBReturn = import("../../../src/typehints/QCBReturn.mjs").QCBReturn;
+export type Runtime = import("../../../src/typehints/Runtime.mjs").Runtime;
+export type SafeImportReturnType<IMPORTTARGET extends unknown> = import("../../../src/typehints/SafeImportReturnType.mjs").SafeImportReturnType<IMPORTTARGET>;
+export type StylePropRefType<STRTYPE extends string> = import("../../../src/typehints/StylePropRefType.mjs").StylePropRefType<STRTYPE>;
+export type TemplateLiteralValueHandler<INPUTTYPE extends unknown> = import("../../../src/typehints/TemplateLiteralValueHandler.mjs").TemplateLiteralValueHandler<INPUTTYPE>;
+export type VivthCleanup = import("../../../src/typehints/VivthCleanup.mjs").VivthCleanup;
+export type VLifecycleCallbacks<TAGNAME extends keyof HTMLElementTagNameMap> = import("../../../src/typehints/VLifecycleCallbacks.mjs").VLifecycleCallbacks<TAGNAME>;
+export type WC_TagName_type<TAG extends string> = import("../../../src/web/common/WC_TagName_type.mjs").WC_TagName_type<TAG>;
+export type EnsureValidTag<T extends string> = import("../../../src/web/EnsureValidTag.mjs").EnsureValidTag<T>;

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

@@ -0,0 +1,40 @@
+export { BrowserExternals } from "../../../src/bundler/adds/BrowserExternals.mjs";
+export { CreateTransform } from "../../../src/bundler/adds/CreateTransform.mjs";
+export { LastEditedUnix } from "../../../src/bundler/adds/LastEditedUnix.mjs";
+export { NodeModuleList } from "../../../src/bundler/adds/NodeModuleList.mjs";
+export { PathFSBundles } from "../../../src/bundler/adds/PathFSBundles.mjs";
+export { PathFSDir } from "../../../src/bundler/adds/PathFSDir.mjs";
+export { PathFSFile } from "../../../src/bundler/adds/PathFSFile.mjs";
+export { ToBundledJSPlugin } from "../../../src/bundler/adds/ToBundledJSPlugin.mjs";
+export { CompileAS } from "../../../src/bundler/CompileAS.mjs";
+export { CompileJS } from "../../../src/bundler/CompileJS.mjs";
+export { EsBundler } from "../../../src/bundler/EsBundler.mjs";
+export { FileSelfMapper } from "../../../src/bundler/FileSelfMapper.mjs";
+export { FSAnalyzer } from "../../../src/bundler/FSAnalyzer.mjs";
+export { FSasar } from "../../../src/bundler/FSasar.mjs";
+export { JSDirMapper } from "../../../src/bundler/JSDirMapper.mjs";
+export { RunWatchThenCompileJSOnSafeExit } from "../../../src/bundler/RunWatchThenCompileJSOnSafeExit.mjs";
+export { EsWatcher } from "../../../src/class/EsWatcher.mjs";
+export { FileSafe } from "../../../src/class/FileSafe.mjs";
+export { FSDirArchWatcher } from "../../../src/class/FSDirArchWatcher.mjs";
+export { JSONFileHandler } from "../../../src/class/JSONFileHandler.mjs";
+export { Prettivy } from "../../../src/class/Prettivy.mjs";
+export { SafeExit } from "../../../src/class/SafeExit.mjs";
+export { Setup } from "../../../src/class/Setup.mjs";
+export { Base64URLFromFile } from "../../../src/common/Base64URLFromFile.mjs";
+export { JSautoDOC } from "../../../src/doc/JSautoDOC.mjs";
+export { ClearRequireCache } from "../../../src/function/ClearRequireCache.mjs";
+export { GetBufferFromRelativePath } from "../../../src/function/GetBufferFromRelativePath.mjs";
+export { GetFilesFromDir } from "../../../src/function/GetFilesFromDir.mjs";
+export { GetMaxFilenameLength } from "../../../src/function/GetMaxFilenameLength.mjs";
+export { GetModuleEsbuildPlatform } from "../../../src/function/GetModuleEsbuildPlatform.mjs";
+export { InstantiateAssemblyScript } from "../../../src/function/InstantiateAssemblyScript.mjs";
+export { NewDynamicsExport } from "../../../src/function/NewDynamicsExport.mjs";
+export { ParseSQLFile } from "../../../src/function/ParseSQLFile.mjs";
+export { SafeImport } from "../../../src/function/SafeImport.mjs";
+export { TsToMjs } from "../../../src/function/TsToMjs.mjs";
+export { UniqueFSTempName } from "../../../src/function/UniqueFSTempName.mjs";
+export { VivthyNeinth } from "../../../src/neinth/VivthyNeinth.mjs";
+export { BrowserDirMapper } from "../../../src/web/BrowserDirMapper.mjs";
+export { ViteAddDynamics } from "../../../src/web/ViteAddDynamics.mjs";
+export { ViteGetAllHTMLFile } from "../../../src/web/ViteGetAllHTMLFile.mjs";

package/generated/types/src/bundler/CompileAS.d.mts

@@ -0,0 +1,30 @@
+/**
+ * @description
+ * - helper to compile `AssemblyScript`;
+ * - file name should endswith `.as.ts`;
+ * >- basename that starts with `-` are excluded, and to be used as sharable library OR code management/split;
+ * - will generate:
+ * >- `${fileBaseNameNoExt}_import.mjs`: setting for import input;
+ * >>- also the only file that are editable;
+ * >- `${fileBaseNameNoExt}.d.ts`: asc generated typehint;
+ * >- `${fileBaseNameNoExt}.js`: asc generated esm binding;
+ * >- `${fileBaseNameNoExt}.wasm`: asc compiled;
+ * >- `${fileBaseNameNoExt}_ASUniversal.mjs`: able to be `JSautoDOC`ed, for universal runtime;
+ * >- `${fileBaseNameNoExt}_ASasar.mjs`: able to be `JSautoDOC`ed, use as `vivth.FSasar` binding;
+ * - generated file are on the same directory as the source, so make sure to isolate the source from other file(in a single different directory), as to not make it messy real fast;
+ * - assuming `js/tsconfig.json` should already set this following value:
+ * >- `compilerOptions.allowJs`: true;
+ * >- `compilerOptions.checkJs`: false;
+ * >- should excludes: `.js`, `.as.ts`, `.wasm`;
+ * @param {Parameters<import('assemblyscript/asc')["main"]>} args
+ * - as of `vivth@1.5.x`, `arg0` type `string[]` produce more stable results than `CompilerOptions`;
+ * @returns {ReturnType<import('assemblyscript/asc')["main"]>}
+ * @example
+ * import { CompileAS } from 'vivth/node';
+ *
+ * const { error } = await CompileAS(
+ * 	[inputABSPath, '--outFile', wasmABSPath, '--bindings', 'esm', ...ASArgv],
+ * 	ASAPIOptions
+ * );
+ */
+export function CompileAS(argv: string[] | import("assemblyscript/asc").CompilerOptions, options?: import("assemblyscript/asc").APIOptions | undefined): ReturnType<typeof import("assemblyscript/asc")["main"]>;

package/generated/types/src/bundler/CompileJS.d.mts

@@ -0,0 +1,109 @@
+/**
+ * @description
+ * - function to compile `.ts`|`.mts`|`.mjs` file, into a single executable;
+ * - also generate js representation of the `bundled` version of the target;
+ * - uses [bun](https://bun.com/docs/bundler/executables) compiler under the hood;
+ * >- it is used only as packaging/compiler agent, and doesn't necessarily supports their advanced feature, such as, assets bundling(use [`FSasar`](#fsasar) instead);
+ * >- `WorkerThread` will be converted to inline using `FSasar` too;
+ *
+ * ---
+ * ---
+ * ---
+ *
+ * - This function does not obfuscate and will not prevent decompilation. Do not embed environment variables or sensitive information inside `options.entryPoint`;
+ * - It is designed for quick binarization, allowing execution on machines without `Bun` installed;
+ * - The resulting binary will contain `FSasar` and `WorkerMainThread` target paths Buffers, which are loaded into memory at runtime. If your logic depends on the file system, use `node:fs` or `node:fs/promises` APIs and ship external files alongside the `binary` and `.asar` file (not compiled);
+ *
+ * ---
+ * ---
+ * ---
+ *
+ * @param {Object} options
+ * @param {string} options.entryPoint
+ * - need to be manually prefixed;
+ * @param {BufferEncoding} [options.encoding]
+ * - read and write encoding for the sources;
+ * - default: `utf-8`;
+ * @param {(entryPointContent:string)=>string} [options.preprocessEntryPoint]
+ * - to modify entry point before bundling;
+ * - `entryPointContent` is the original string of the entry point;
+ * - returned value then passed to `ESBundler`;
+ * @param {boolean} [options.minifyFirst]
+ * - minify the bundle before compilation;
+ * @param {Object} [options.asar]
+ * @param {Parameters<typeof import('@electron/asar')["createPackageFromFiles"]>[3]} [options.asar.InputMetadata]
+ * @param {Parameters<typeof import('@electron/asar')["createPackageFromFiles"]>[4]} [options.asar.options]
+ * @param {string} options.outDir
+ * - need manual prefix;
+ * @param {Record<string, string[]|string>} [options.bunCompilerArguments]
+ * - `key` are to used as `--keyName`;
+ * - value are the `value` of the `key`;
+ * >- `string`: will be inputed as is;
+ * >- `string[]`: will be joined with `,`;
+ * - no need to add the output/outdir, as it use the `options.outDir`;
+ * @param {ReturnType<CreateESPlugin>[]} [options.esBundlerPlugins]
+ * - plugins for `EsBundler`;
+ * @param {Parameters<typeof EsBundler>[1]} [options.esbuildOptions]
+ * - options for `EsBundler`;
+ * @param {string[]} [options.additionalCommandArgument]
+ * - argument to be passed process generator;
+ * @return {ReturnType<typeof TryAsync<{compileResult: any,
+ * commandCalled: string|undefined;
+ * compiledBinFile: string|undefined;
+ * bundledJSFile: string|undefined
+ * }>>}
+ * @example
+ * import process from 'node:process';
+ * import { join } from 'node:path';
+ *
+ * import { CompileJS, SafeExit } from 'vivth/node';
+ * import { Console, Paths } from 'vivth/neutral';
+ *
+ * new Paths({
+ * 	root: process.env.INIT_CWD ?? process.cwd(),
+ * });
+ *
+ * new SafeExit('SIGINT', 'SIGTERM');
+ *
+ * const pathRoot = Paths.root;
+ *
+ * const [,errorbun] = await CompileJS({
+ * 	entryPoint: join(pathRoot, '/dev/myEntryPoint.mjs'),
+ * 	minifyFirst: true,
+ * 	outDir: join(pathRoot, '/dev-bun/'),
+ * 	compiler: 'bun',
+ * 	compilerArguments: {
+ * 		target: 'bun-win-x64',
+ * 	},
+ * 	asar: {},
+ * 	encoding: 'utf-8',
+ * });
+ *
+ * if (errorbun) {
+ * 	Console.error({ errorbun });
+ * }
+ */
+export function CompileJS({ entryPoint, minifyFirst, encoding, outDir, asar, preprocessEntryPoint, bunCompilerArguments, esBundlerPlugins, esbuildOptions, additionalCommandArgument, }: {
+    entryPoint: string;
+    encoding?: BufferEncoding | undefined;
+    preprocessEntryPoint?: ((entryPointContent: string) => string) | undefined;
+    minifyFirst?: boolean | undefined;
+    asar?: {
+        InputMetadata?: Parameters<typeof import("@electron/asar")["createPackageFromFiles"]>[3];
+        options?: Parameters<typeof import("@electron/asar")["createPackageFromFiles"]>[4];
+    } | undefined;
+    outDir: string;
+    bunCompilerArguments?: Record<string, string | string[]> | undefined;
+    esBundlerPlugins?: import("esbuild").Plugin[] | undefined;
+    esbuildOptions?: Parameters<typeof EsBundler>[1];
+    additionalCommandArgument?: string[] | undefined;
+}): ReturnType<typeof TryAsync<{
+    compileResult: any;
+    commandCalled: string | undefined;
+    compiledBinFile: string | undefined;
+    bundledJSFile: string | undefined;
+}>>;
+export type PlatformKey = "win32" | "linux" | "darwin" | string;
+export type CreateESPlugin = typeof import("./CreateESPlugin.mjs")["CreateESPlugin"];
+import { EsBundler } from './EsBundler.mjs';
+import { TryAsync } from '../function/TryAsync.mjs';

package/{types → generated/types}/src/bundler/CreateESPlugin.d.mts

@@ -5,7 +5,7 @@
  * @param {import('esbuild').Plugin["setup"]} setup
  * @returns {import('esbuild').Plugin}
  * @example
- * import { CreateESPlugin } from 'vivth';
+ * import { CreateESPlugin } from 'vivth/neutral';
  *
  * export const pluginAddCopyRight = CreateESPlugin(
  * 	'MyCopyrightDeclaration',