lilact 0.4.0 → 0.5.1

package/src/pane.jsx

@@ -8,16 +8,59 @@ const clamp = (n, min, max) => {
 };
 
 /**
- * ResizablePane
+ * A split-pane container with a draggable splitter, supporting both horizontal and vertical layouts.
  *
- * Features:
- * - Supports "horizontal" (left/top size affects width) and "vertical" (affects height)
- * - Initial position via props.position
- * - Methods to set mode and position via ref:
- *     ref.current.setMode(mode)
- *     ref.current.setPosition(position)
- * - Callback when size changes via onSizeChange
- * - Children are rendered in two separate containers (no portals)
+ * The pane can be either:
+ * - **Controlled** via the `position` prop (number between `min` and `max`), or
+ * - **Uncontrolled** via `defaultPosition` (used as the initial position).
+ *
+ * Layout behavior:
+ * - `mode="horizontal"`: the `position` controls the width of the **left** pane.
+ * - `mode="vertical"`: the `position` controls the height of the **top** pane.
+ *
+ * Ref API:
+ * - Exposes imperative methods on `ref.current`:
+ *   - `getMode()` to get the current mode
+ *   - `setMode(mode)` to switch between `"horizontal"` and `"vertical"`
+ *   - `getPosition()` to get the current splitter position
+ *   - `setPosition(position)` to update the splitter position
+ *
+ * Events:
+ * - Calls `onSizeChange(position)` whenever the pane size/position changes (e.g., via dragging).
+ *
+ * Rendering:
+ * - Renders `children` into two separate containers (no portals).
+ *
+ * @param mode - Split direction: `"horizontal"` or `"vertical"`. Defaults to `"horizontal"`.
+ * @param position - Controlled splitter position. Normalized value within `[min, max]`.
+ * If provided, the component uses this value instead of internal state.
+ * @param defaultPosition - Initial splitter position for uncontrolled usage. Defaults to `0.5`.
+ * @param min - Minimum allowed position. Defaults to `0.1`.
+ * @param max - Maximum allowed position. Defaults to `0.9`.
+ * @param splitterSize - Thickness of the draggable splitter in pixels. Defaults to `8`.
+ * @param onSizeChange - Callback invoked when the position changes. Receives the new normalized position.
+ * @param style - Optional root container styles.
+ * @param className - Optional root container CSS class.
+ * @param leftPaneStyle - Optional styles applied to the left pane (or top pane in vertical mode).
+ * @param rightPaneStyle - Optional styles applied to the right pane (or bottom pane in vertical mode).
+ * @param splitterStyle - Optional styles applied to the splitter element.
+ * @param children - React children to be rendered into the two pane containers.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<ResizablePaneHandle>(null);
+ *
+ * <ResizablePane
+ *   ref={ref}
+ *   mode="horizontal"
+ *   defaultPosition={0.5}
+ *   min={0.1}
+ *   max={0.9}
+ *   onSizeChange={(pos) => console.log(pos)}
+ * >
+ *   <div /> <div />
+ * </ResizablePane>
+ * ```
  */
 export const ResizablePane = forwardRef(function ResizablePane(
   {

package/src/run.jsx

@@ -50,12 +50,19 @@ import Lilact from './lilact.jsx';
  */
 export function run(jsx, path=`<string input ${++Lilact.eval_num}>`, is_inline=true)
 {
-	if(Lilact.checkTraceErrors) Lilact.checkTraceErrors;
-
 	const mappings = [];
-
+	const module = {};
 	let processed;
 
+	Lilact.required_scripts[path] = { 	
+		mappings,
+		module,
+		is_inline,
+		path,
+		code: jsx,
+	};
+
+
 	try {
 		processed = Lilact.transpileJSX( jsx,
 		{
@@ -63,37 +70,23 @@ export function run(jsx, path=`<string input ${++Lilact.eval_num}>`, is_inline=t
 			mappings,
 			factory: "Lilact.createComponent",
 			append_sourcemap: !is_inline,
-			wrap_all: false
+			blocks_info: Lilact.blocks_info,
+
+			injectTraceLabels: true,
 		} );
 	}
 	catch(e) {
-		e.lilact_trace = path;
+		//e = Lilact.traceError(e);
+		Lilact.error = e;
 		throw e;
 	}
 
-	// the separation of module property is to create the required object even on error
-
-	const module = {};
-
-	Lilact.transpilerConfig.required[path] = { 	
-		mappings,
-		processed,
-		module,
-		is_inline,
-		path,
-		code: jsx
-	};
 
+ʔ if(DEBUG) {
+		Lilact.required_scripts[path].processed = processed;
+ʔ }		
 	
-	Lilact.scanFunctionLabels(processed, path);
-
-	Lilact.transpilerConfig.func_labels[path] = {
-		path,
-		row: 0,
-		col: 0,
-		label: "<EXEC>",
-		required: Lilact.transpilerConfig.required[path]
-	}
+	Lilact.scanBlockLabels(processed, path);
 
 	try {
 		globalThis.Lilact = Lilact;
@@ -103,7 +96,7 @@ export function run(jsx, path=`<string input ${++Lilact.eval_num}>`, is_inline=t
 		return res;
 	}
 	catch(e) {
-		e.lilact_trace = path;
+		e = Lilact.traceError(e);
 		throw e;
 	}
 }
@@ -220,74 +213,6 @@ export function lazy(factory) {
 	return LazyComponent;
 }
 
-/**
- * Debug tool to get the Lilact traced location of an error. It can also produce some block based stack trace 
- * if `Lilact.transpilerConfig.enableLabelStack` is set to `true` before loading the script. This is `false`
- * by default for efficiency.
- *
- * @returns A new object that includes `path`, `row`, `col`, `msg`, `name`, and optional `stack`. 
- * The exception itself is stored as `err`.
- */
-export function traceError(err)
-{
-	const loc = Lilact.getErrorLocation(err);
-
-	const obj = {
-		path: err.fileName,
-		label: null,
-		
-		row: loc[0],
-		col: loc[1],
-
-		msg: err.message,
-		name: err.name,
-
-		stack: null,
-		err: err
-	};		
-
-
-	if(err.lilact_trace!==undefined) {
-
-		// to be able to trace, we assume that all of the scripts are running inside lilact.
-		// if not, the error is returned unchanged and stack and label would remain null.
-
-		let mps;
-		let blk;
-		if(typeof(err.lilact_trace)==='string') {
-			blk = Lilact.func_labels[err.lilact_trace];
-			mps = blk.required.mappings;
-		}
-		else if(typeof(err.lilact_trace)==='object') {
-			blk = Lilact.func_labels[err.lilact_trace[0]];
-			mps = blk.mappings;
-		}
-
-		obj.path = blk.path;
-		obj.label = blk.label;
-
-		[obj.row, obj.col] = Lilact.mapLocation(mps, obj.row,obj.col);
-
-		//const rm = Lilact.func_labels[func_num].required;
-
-		// Lilact.onError( err.message,
-		// 				rm.path,
-		// 				Lilact.func_labels[func_num].label,
-		// 				...Lilact.mapLocation(...loc,mps),
-		// 				Lilact.call_stack.map(
-		// 					(x)=>({ path: Lilact.func_labels[x].path,
-		// 							label: Lilact.func_labels[x].label,
-		// 							row: Lilact.func_labels[x].row
-		// 						})
-		// 				),	err );
-
-		
-	}
-
-	return obj;
-	
-}
-
 function scanScriptTagsWithType() {
 	const scripts = Array.from(
 		document.querySelectorAll('script[type="text/jsx"]')
@@ -320,4 +245,5 @@ export function runScripts()
 		if(s.src) Lilact.require(s.src);
 		if(s.content) Lilact.run(s.content);
 	}
-}
+}
+

package/typedoc.json

@@ -10,6 +10,8 @@
     ".tmp/router.js",
     ".tmp/accessories.js",
     ".tmp/components.js",
+    ".tmp/errors.js",
+    ".tmp/pane.js",
     // ".tmp/events.js",
     ".tmp/hooks.js",
     ".tmp/misc.js",

package/docs/functions/run.traceError.html

@@ -1,6 +0,0 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>traceError | Lilact</title><meta name="description" content="Documentation for Lilact"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">Lilact</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/run.html">run</a></li><li><a href="" aria-current="page">traceError</a></li></ul><h1>Function traceError</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="traceerror"><span class="tsd-kind-call-signature">traceError</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">err</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">{</span><br/>    <span class="tsd-kind-property">col</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">err</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">label</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">msg</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">name</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">path</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">row</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">stack</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">;</span><br/><span class="tsd-signature-symbol">}</span><a href="#traceerror" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>Debug tool to get the Lilact traced location of an error. It can also produce some block based stack trace
-if <code>Lilact.transpilerConfig.enableLabelStack</code> is set to <code>true</code> before loading the script. This is <code>false</code>
-by default for efficiency.</p>
-</div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">err</span>: <span class="tsd-signature-type">any</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-symbol">{</span><br/>    <span class="tsd-kind-property">col</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">err</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">label</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">msg</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">name</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">path</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">row</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">;</span><br/>    <span class="tsd-kind-property">stack</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">;</span><br/><span class="tsd-signature-symbol">}</span></h4><p>A new object that includes <code>path</code>, <code>row</code>, <code>col</code>, <code>msg</code>, <code>name</code>, and optional <code>stack</code>.
-The exception itself is stored as <code>err</code>.</p>
-<aside class="tsd-sources"><ul><li>Defined in run.js:231</li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">Lilact</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>