lilact 0.0.0

package/src/transition.jsx

@@ -0,0 +1,244 @@
+/*
+
+	Lilact
+	Copyright (C) 2024-2026 Arash Kazemi <contact.arash.kazemi@gmail.com>
+	All rights reserved.
+
+	BSD-2-Clause
+
+	Redistribution and use in source and binary forms, with or without
+	modification, are permitted provided that the following conditions are met:
+
+	* Redistributions of source code must retain the above copyright
+		notice, this list of conditions and the following disclaimer.
+	* Redistributions in binary form must reproduce the above copyright
+		notice, this list of conditions and the following disclaimer in the
+		documentation and/or other materials provided with the distribution.
+
+	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+	AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+	IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+	ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+	DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+	(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+	LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+	ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+	(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+	THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+*/
+
+ʔ defineSymbols ( "LILACT", [ "CORE", "COMPONENT", "CHILD_CLASS_ADDENDUM" ] ) ʔ
+
+/* States */
+const UNMOUNTED = "unmounted";
+const EXITED = "exited";
+const ENTERING = "entering";
+const ENTERED = "entered";
+const EXITING = "exiting";
+
+import {setTimeout, clearTimeout} from "./timers.jsx"
+import {Children} from "./misc.jsx"
+import {useEffect} from "./hooks.jsx"
+
+/**
+ * Transition component that manages enter/exit lifecycle and calls callbacks based on state changes.
+ *
+ * @param props - Component props.
+ * @param props.in - Boolean/flag indicating whether the component should be entered/shown.
+ * @param [props.timeout=defaultTransitionTimeout] - Duration (or durations) for the transition.
+ * @param [props.mountOnEnter=false] - If true, mount the child only when entering.
+ * @param [props.unmountOnExit=false] - If true, unmount the child after exiting.
+ * @param [props.appear=false] - If true, run the enter transition on initial mount.
+ * @param props.onEnter - Called when entering begins.
+ * @param props.onEntering - Called while the component is entering.
+ * @param props.onEntered - Called when entering completes.
+ * @param props.onExit - Called when exiting begins.
+ * @param props.onExiting - Called while the component is exiting.
+ * @param props.onExited - Called when exiting completes.
+ * @param props.children - Render prop receiving transition state/props.
+ */
+export function Transition({
+	in: inProp,
+	timeout = Lilact.defaultTransitionTimeout,
+	mountOnEnter = false,
+	unmountOnExit = false,
+	appear = false,
+	onEnter,
+	onEntering,
+	onEntered,
+	onExit,
+	onExiting,
+	onExited,
+	children,
+
+	// this is underscored to prevent accidental setting by the user.
+	// i added it to the Transition itself to simplify the implementation,
+	// but the user should use CSSTransition itself.
+	_classNames: classNames
+}) {
+	this[CORE].is_mounted ??= !mountOnEnter || inProp || appear;
+	this[CORE].is_appeared ??= inProp;
+	this[CORE].timer ??= null;
+
+	if(!this.state) {
+		if (!this[CORE].is_mounted) this.state = UNMOUNTED;
+		if (inProp) {
+			this.state = appear && !this[CORE].is_appeared ? ENTERING : ENTERED;
+		}
+		this.state = EXITED;
+	}
+
+	useEffect(() => {
+		return () => clearTimeout(this[CORE].timer);
+	}, []);
+
+	useEffect(() => {
+		if (!this[CORE].is_appeared && appear && this.state === ENTERING && inProp) {
+			onEnter?.();
+			requestAnimationFrame(() => {
+				onEntering?.(!this[CORE].is_appeared);
+				clearTimeout(this[CORE].timer);
+				this[CORE].timer = setTimeout(() => {
+					this.setState(ENTERED);
+					this[CORE].is_appeared = true;
+					onEntered?.(!this[CORE].is_appeared);
+				}, timeout);
+			});
+		}
+	}, []);
+
+	useEffect(() => {
+		if (inProp) {
+			this[CORE].is_mounted = true;
+			// If we are already entering/entered, no-op
+			if (this.state === ENTERING || this.state === ENTERED) return;
+
+			onEnter?.(!this[CORE].is_appeared);
+			this.setState(ENTERING, () => {
+				onEntering?.(!this[CORE].is_appeared);
+				clearTimeout(this[CORE].timer);
+				this[CORE].timer = setTimeout(() => {
+					this.setState(ENTERED);
+					this[CORE].is_appeared = true;
+					onEntered?.();
+				}, timeout);
+			});
+		} 
+		else {
+			if (this.state === UNMOUNTED || this.state === EXITING || this.state === EXITED) return;
+
+			onExit?.();
+			this.setState(EXITING, () => {
+				onExiting?.();
+				clearTimeout(this[CORE].timer);
+				this[CORE].timer = setTimeout(() => {
+					this.setState(EXITED);
+					onExited?.();
+					if (unmountOnExit) {
+						this[CORE].is_mounted = false;
+						this.setState(UNMOUNTED);
+					}
+				}, timeout);
+			});
+		}
+	}, [inProp, timeout]);
+
+	if (!this[CORE].is_mounted) return null;
+
+	if(classNames) {
+		if (this.state === ENTERING) {
+			if(this[CORE].is_appeared)
+				this[CORE][CHILD_CLASS_ADDENDUM] = classNames.appearActive;
+			else
+				this[CORE][CHILD_CLASS_ADDENDUM] = classNames.enterActive;
+		}
+		else if (this.state === ENTERED) {
+			if(this[CORE].is_appeared)
+				this[CORE][CHILD_CLASS_ADDENDUM] = classNames.appearDone;
+			else
+				this[CORE][CHILD_CLASS_ADDENDUM] = classNames.enterDone;
+		}
+		else if (this.state === EXITING) this[CORE][CHILD_CLASS_ADDENDUM] = classNames.exitActive;
+		else if (this.state === EXITED) this[CORE][CHILD_CLASS_ADDENDUM] = classNames.exitDone;
+	}
+	return children;
+}
+
+
+/**
+ * CSSTransition component that extends Transition by applying CSS class names during enter/exit phases.
+ *
+ * Lilact accepts multiple children for CSSTransition. This has the benefit
+ * of receiving single events on multiple animated components.
+ *
+ * @param props - Component props.
+ * @param props.in - Boolean/flag indicating whether the component should be entered/shown.
+ * @param [props.timeout=defaultTransitionTimeout] - Duration (or durations) for the transition.
+ * @param [props.classNames="fade"] - Base CSS class name(s) used for the transition states.
+ * @param [props.mountOnEnter=false] - If true, mount the child only when entering.
+ * @param [props.unmountOnExit=false] - If true, unmount the child after exiting.
+ * @param [props.appear=false] - If true, run the enter transition on initial mount.
+ * @param props.children - Render prop receiving transition state/props.
+ * @param props.onEnter - Called when entering begins.
+ * @param props.onEntering - Called while the component is entering.
+ * @param props.onEntered - Called when entering completes.
+ * @param props.onExit - Called when exiting begins.
+ * @param props.onExiting - Called while the component is exiting.
+ * @param props.onExited - Called when exiting completes.
+ */
+export function CSSTransition({
+	in: inProp,
+	timeout = defaultTransitionTimeout,
+	classNames = "fade",
+	mountOnEnter = false,
+	unmountOnExit = false,
+	appear = false,
+	children,
+	onEnter, onEntering, onEntered, 
+	onExit, onExiting, onExited,
+}) {
+
+	if(typeof(classNames)==='string') {
+		classNames = {
+			appear: `${classNames}-enter ${classNames}-appear`,
+			appearActive: `${classNames}-enter-active ${classNames}-appear-active`,
+			appearDone: `${classNames}-enter-done ${classNames}-appear-done`,
+			enter: `${classNames}-enter`,
+			enterActive: `${classNames}-enter-active`,
+			enterDone: `${classNames}-enter-done`,
+			exit: `${classNames}-exit`,
+			exitActive: `${classNames}-exit-active`,
+			exitDone: `${classNames}-exit-done`,
+		};
+	}		
+	return (
+		<Transition
+			in={inProp}
+			timeout={timeout}
+			mountOnEnter={mountOnEnter}
+			unmountOnExit={unmountOnExit}
+			appear={appear}
+			onEnter={onEnter}
+			onEntering={onEntering}
+			onEntered={onEntered}
+			onExit={onExit}
+			onExiting={onExiting}
+			onExited={onExited}
+			_classNames={classNames}
+		>
+			{children}
+		</Transition>
+		);
+}
+
+/**
+ * Lilact doesn't need TransitionGroup, so it is the same as a fragment.
+ * In Lilact all the transitions and timeouts are automatically grouped.
+ * 
+ * The only missing feature here is the childFactory. I may add it in
+ * the future, but there are simple workarounds for that. 
+ */
+export function TransitionGroup({ children }) {
+	return children;
+}

package/src/vlq.js

@@ -0,0 +1,94 @@
+// Fork of https://github.com/Rich-Harris/vlq
+// Adapted from murzwin.com/base64vlq.html by Alexander Pavlov.
+// License: MIT
+
+/** @type {Record<string, number>} */
+let char_to_integer = {};
+
+/** @type {Record<number, string>} */
+let integer_to_char = {};
+
+'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/='
+	.split('')
+	.forEach(function (char, i) {
+		char_to_integer[char] = i;
+		integer_to_char[i] = char;
+	});
+
+/** @param {string} string */
+export function decode(string) {
+	/** @type {number[]} */
+	let result = [];
+
+	let shift = 0;
+	let value = 0;
+
+	for (let i = 0; i < string.length; i += 1) {
+		let integer = char_to_integer[string[i]];
+
+		if (integer === undefined) {
+			throw new Error('Invalid character (' + string[i] + ')');
+		}
+
+		const has_continuation_bit = integer & 32;
+
+		integer &= 31;
+		value += integer << shift;
+
+		if (has_continuation_bit) {
+			shift += 5;
+		} else {
+			const should_negate = value & 1;
+			value >>>= 1;
+
+			if (should_negate) {
+				result.push(value === 0 ? -0x80000000 : -value);
+			} else {
+				result.push(value);
+			}
+
+			// reset
+			value = shift = 0;
+		}
+	}
+
+	return result;
+}
+
+/** @param {number | number[]} value */
+export function encode(...value) {
+	if (typeof value === 'number') {
+		return encode_integer(value);
+	}
+
+	let result = '';
+	for (let i = 0; i < value.length; i += 1) {
+		result += encode_integer(value[i]);
+	}
+
+	return result;
+}
+
+/** @param {number} num */
+function encode_integer(num) {
+	let result = '';
+
+	if (num < 0) {
+		num = (-num << 1) | 1;
+	} else {
+		num <<= 1;
+	}
+
+	do {
+		let clamped = num & 31;
+		num >>>= 5;
+
+		if (num > 0) {
+			clamped |= 32;
+		}
+
+		result += integer_to_char[clamped];
+	} while (num > 0);
+
+	return result;
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": false
+  },
+  "include": [
+    ".tmp/**/*.js"
+  ],
+  "exclude": [
+    "**/node_modules",
+    "**/dist",
+    "**/build",
+    "**/src"
+  ]
+}

package/typedoc.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": false,
+    "maxNodeModuleJsDepth": 0,
+    "skipLibCheck": true,
+  },
+  "name": "Lilact",
+  "entryPoints": [
+    ".tmp/router.js",
+    ".tmp/accessories.js",
+    ".tmp/components.js",
+    // ".tmp/events.js",
+    ".tmp/hooks.js",
+    ".tmp/misc.js",
+    ".tmp/run.js",
+    ".tmp/jsx.js",
+    ".tmp/redux.js",
+    ".tmp/timers.js",
+    ".tmp/transition.js",
+    // ".tmp/lilact.js"
+  ],
+}

package/webpack.config.js

@@ -0,0 +1,196 @@
+/*
+
+Lilact
+Copyright (C) 2024-2025 Arash Kazemi <contact.arash.kazemi@gmail.com>
+All rights reserved.
+
+BSD-2-Clause
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+*/
+
+import path from 'path'
+
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+import fs from 'fs';
+import 'webpack';
+
+
+
+export default (env, argv) => {
+
+	const mode = argv.mode || 'development';
+	
+	const __filename = fileURLToPath(import.meta.url);
+	const __dirname = dirname(__filename);
+
+	const filename = `lilact.${mode}${mode==="development"?"":".min"}.js`;
+
+	return {
+		entry: './src/lilact.jsx',
+		mode,
+		devtool: 'source-map',
+
+		optimization: {
+		    concatenateModules: true,      // scope hoisting
+		    // runtimeChunk: 'single',       // centralize runtime helpers
+		    // splitChunks: {
+		    //   chunks: 'all',
+		    //   cacheGroups: {
+		    //     vendors: {
+		    //       test: /[\\/]node_modules[\\/]/,
+		    //       name: 'vendors',
+		    //       chunks: 'all',
+		    //     },
+		    //   },
+		    // },
+		    moduleIds: 'deterministic',   // smaller stable ids (or 'hashed')
+			minimize: mode === 'production',
+		},
+		experiments: {    
+			outputModule: true           // enable module output  
+		},
+		ignoreWarnings: [{
+			module: /jsx\.js/, // to silent the warning for requiring fs in jsx.js 
+			message: /Module not found/,
+		}],
+		output: {
+			filename,
+			path: path.resolve(__dirname, 'dist'),
+			library: {      type: 'module'             // important: emit an ES module   
+		    },
+		},
+		resolve: {
+			// alias: {      
+			// 	"react-is": false, 
+			// },
+			fallback: {
+				// buffer: req.resolve('buffer/'),
+			}
+		},
+		module: {
+			rules: [{
+					test: /\.js$/, // for the preprocessor
+					exclude: /node_modules/,
+					use: [{
+						loader: './src/loader.cjs',
+						options: {
+							mode
+						}
+					}]
+				},
+				{
+					test: /\.jsx$/,
+					exclude: /node_modules/,
+					use: [{
+						loader: './src/loader.cjs',
+						options: {
+							mode
+						}
+					}]
+				}
+			]
+		},
+		plugins: [{
+				apply: (compiler) => {
+					compiler.hooks.done.tap('license-plugin', (compilation) => {
+						fs.readFile('./dist/' + filename, 'utf8', function(err, jssc) {
+
+							let out =
+								`/*
+
+Lilact
+Copyright (C) 2024-2025 Arash Kazemi <contact.arash.kazemi@gmail.com>
+All rights reserved.
+
+BSD-2-Clause
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+--------------------------------------------------------------------------------
+
+Lilact also includes the following libraries accessible as members of 
+the Lilact object:
+
+@emotion/css:
+Copyright (c) Emotion team and other contributors
+MIT License
+
+prop-types:
+Copyright (c) 2013-present, Facebook, Inc.
+MIT License
+
+redux:
+Copyright (c) 2015-present Dan Abramov
+MIT License
+
+
+* MIT License Notice:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+--------------------------------------------------------------------------------
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+*/
+${jssc}`;
+
+							fs.writeFile('./dist/' + filename, out, {}, function() {});
+							fs.writeFile('./root/' + filename, out, {}, function() {});
+						});
+
+					});
+				}
+			},
+			//new webpack.ProvidePlugin({
+			//Buffer: ['buffer', 'Buffer'],
+			//   })
+		]
+	}
+};