lilact 0.26.16 → 0.27.1

package/src/run.jsx

@@ -29,7 +29,7 @@
 */
 /*
 Lilact
-Copyright (C) 2024-2026 Arash Kazemi
+Copyright (C) 2024-2026 Arash Kazemi <contact.arash.kazemi@gmail.com>
 BSD-2-Clause
 */
 
@@ -39,94 +39,71 @@ import { LAZY } from "./symbols.jsx";
 import { injectGlobal } from "@emotion/css";
 
 function joinPaths(basePath, relativePath) {
-  const isAbsolute = relativePath.startsWith("/");
-  const stack = [];
-
-  const parts = (isAbsolute ? "" : basePath)
+  const absolute = relativePath.startsWith("/");
+  const parts = (absolute ? "" : basePath)
     .split("/")
     .filter(Boolean);
 
-  for (const part of parts) {
-    stack.push(part);
-  }
-
-  if (!basePath.endsWith("/")) {
-    stack.pop();
-  }
+  if (!absolute && !basePath.endsWith("/")) parts.pop();
 
   for (const part of relativePath.split("/")) {
-    if (part === "" || part === ".") continue;
-
-    if (part === "..") {
-      if (stack.length > 0) stack.pop();
-    } else {
-      stack.push(part);
-    }
+    if (!part || part === ".") continue;
+    if (part === "..") parts.pop();
+    else parts.push(part);
   }
 
-  return `${isAbsolute ? "/" : ""}${stack.join("/")}`;
+  return `${absolute ? "/" : ""}${parts.join("/")}`;
 }
 
-function asError(value, fallbackMessage = "Unknown error") {
+function asError(value, fallback = "Unknown error") {
   if (value instanceof Error) return value;
+  if (value?.error instanceof Error) return value.error;
 
-  if (value && typeof value === "object") {
-    if (value.error instanceof Error) return value.error;
-
-    const error = new Error(
-      value.message == null ? fallbackMessage : String(value.message)
-    );
+  const error = new Error(
+    value?.message == null ? fallback : String(value.message)
+  );
 
+  if (value && typeof value === "object") {
     if (value.name) error.name = value.name;
-
-    if (value.stack) {
-      Object.defineProperty(error, "stack", {
-        value: value.stack,
-        configurable: true,
-      });
-    }
+    if (value.stack) error.stack = value.stack;
 
     for (const key of Object.keys(value)) {
       if (!(key in error)) error[key] = value[key];
     }
-
-    return error;
   }
 
-  return new Error(
-    value == null ? fallbackMessage : String(value)
-  );
+  return error;
 }
 
-function attachPath(error, path) {
-  const result = asError(error);
+/*
+ * The first module that catches an error owns its source location.
+ * Parent modules must never replace it.
+ */
+function markSource(value, path) {
+  const error = asError(value);
 
-  if (result.fileName == null) result.fileName = path;
+  if (!error.lilact_source) {
+    error.lilact_source = { path };
+  }
 
-  return result;
+  return error;
 }
 
-function reportRuntimeError(error, path) {
-  const withPath = attachPath(error, path);
+function report(value, path) {
+  const error = markSource(value, path);
+
+  if (error.isTraced) return error;
 
-  /*
-   * lilact.jsx may expose traceError on the public namespace. Avoid a
-   * static import here because errors.jsx already imports run.jsx.
-   */
   if (typeof Lilact.traceError === "function") {
-    return Lilact.traceError(withPath, path);
+    return Lilact.traceError(error, path);
   }
 
-  Lilact.error = withPath;
-  return withPath;
+  Lilact.error = error;
+  return error;
 }
 
-/** @ignore */
 export const required_scripts = {};
 
-/**
- * Transpiles and evaluates one JSX module.
- */
 export function run(
   jsx,
   path = `InlineJSX-${++Lilact.eval_num}`,
@@ -135,21 +112,17 @@ export function run(
     isModule = true,
   } = {}
 ) {
-  const mappings = [];
+
 
   const module = {
-    mappings,
-    isInline,
-    isModule,
     path,
     code: String(jsx),
+    mappings: [],
     exports: {},
+    isInline,
+    isModule,
   };
 
-  /*
-   * Register the module before transpiling. This makes the original source
-   * available if transpilation or evaluation fails.
-   */
   required_scripts[path] = module;
 
   let processed;
@@ -157,136 +130,130 @@ export function run(
   try {
     processed = Lilact.transpileJSX(String(jsx), {
       path,
-      mappings,
+      mappings: module.mappings,
       factory: "createComponent",
       appendSourcemap: false,
       injectTraceLabels: true,
       produceCJS: true,
       blocks_info: Lilact.blocks_info,
     });
-  } catch (error) {
-    const parserError = attachPath(error, path);
-    parserError.sourcePhase = "transpile";
-    module.error = parserError;
-    Lilact.error = parserError;
-    throw parserError;
+  } catch (value) {
+    const error = asError(value);
+    error.fileName ??= path;
+    error.sourcePhase = "transpile";
+    module.error = error;
+    Lilact.error = error;
+    throw error;
   }
 
-  if (typeof DEBUG !== "undefined" && DEBUG) {
-    module.processed = processed;
+  if (typeof Lilact.scanBlockLabels === "function") {
+    Lilact.scanBlockLabels(processed, path);
   }
 
   /*
-   * The sourceURL must be the final source directive in the evaluated
-   * program. Browsers use it differently, but this format works for the
-   * common eval stack formats.
-   */
-  processed = `${processed}\n//# sourceURL=eval:/${path}`;
-
-  /*
-   * Register block labels using the exact processed source that will be
-   * evaluated.
+   * sourceURL helps when the browser includes eval locations in its stack.
+   * It is not used as the authoritative source; the catch block below is.
    */
-  if (typeof Lilact.scanBlockLabels === "function") {
-    Lilact.scanBlockLabels(processed, path);
-  }
+  processed += `\n//# sourceURL=eval:/${path}`;
 
   try {
     globalThis.Lilact = Lilact;
     globalThis.createComponent = Lilact.createComponent;
     globalThis.Fragment = Lilact.Fragment;
 
+    const result = eval(processed);
+
+    return isEmpty(module.exports)
+      ? result
+      : module.exports;
+  } catch (value) {
     /*
-     * This must remain a direct eval. Indirect eval changes the scope and
-     * breaks the module runtime.
+     * This catch executes in the module whose eval failed, including
+     * generated-JavaScript syntax errors. Therefore path is authoritative.
      */
-    const result = eval(processed);
+    const error = report(value, path);
 
-    if (!isEmpty(module.exports)) {
-      return module.exports;
-    }
+    error.sourcePhase ??= "runtime";
+    module.error = error;
 
-    return result;
-  } catch (error) {
-    const runtimeError = reportRuntimeError(error, path);
-    runtimeError.sourcePhase = "runtime";
-    module.error = runtimeError;
-    throw runtimeError;
+    throw error;
   }
 }
 
-/**
- * Synchronously or asynchronously loads a JSX, JavaScript, or CSS resource.
- */
 export function require(path) {
-  let forceUpdate;
-  let checkExport;
-  let requirer;
-  let isLazy;
+  let options = {};
 
   if (
     arguments.length === 2 &&
     arguments[1] &&
     typeof arguments[1] === "object"
   ) {
-    forceUpdate = arguments[1].forceUpdate;
-    checkExport = arguments[1].checkExport;
-    requirer = arguments[1].requirer;
-    isLazy = arguments[1].isLazy;
+    options = arguments[1];
   }
 
+
   if (Lilact.importObjectPaths?.[path]) {
     return Lilact.importObjectPaths[path];
   }
 
-  if (required_scripts[path] && !forceUpdate) {
+
+  const loadAsync =
+    Boolean(Lilact[LAZY]) ||
+    Boolean(options.isLazy);
+
+
+  if (options.requirer?.path) {
+    path = joinPaths(options.requirer.path, path);
+  }
+
+  if (required_scripts[path] && !options.forceUpdate && !loadAsync) {
     return required_scripts[path].exports;
   }
 
-  if (path[0] === "#") {
+  if (path.startsWith("#")) {
     const element = document.getElementById(path.slice(1));
 
     if (!element) {
-      const error = new Error(
-        `Required element not found (${path})`
+      throw report(
+        new Error(`Required element not found (${path})`),
+        path
       );
-      error.fileName = path;
-      throw error;
     }
 
     return run(element.textContent || "", path);
   }
 
-  if (requirer?.path) {
-    path = joinPaths(requirer.path, path);
-  }
-
-  const loadAsync =
-    Boolean(Lilact?.[LAZY]) || Boolean(isLazy);
-
   if (loadAsync) {
     Lilact[LAZY] = false;
 
     let request = Lilact.resolver?.(path);
 
-    if (request === undefined || request === null) {
-      request = fetch(path).then((response) => {
-        if (!response.ok) {
-          const error = new Error(
-            `Unable to load ${path}: HTTP ${response.status}`
-          );
-          error.fileName = path;
-          throw error;
-        }
-
-        return response.text();
-      });
-    } else {
+    if (request == null) {
+
+	  if (required_scripts[path] && !options.forceUpdate) {
+	      request = Promise.resolve(required_scripts[path].code);
+	  }
+	  else {
+	      request = fetch(path).then(response => {
+	        if (!response.ok) {
+	          throw report(
+	            new Error(
+	              `Unable to load ${path}: HTTP ${response.status}`
+	            ),
+	            path
+	          );
+	        }
+
+	        return response.text();
+	      });
+	  }
+    } 
+    else {
       request = Promise.resolve(request);
     }
 
     return request
-      .then((source) => {
+      .then(source => {
         if (path.endsWith(".css")) {
           injectGlobal(String(source));
           return;
@@ -297,18 +264,17 @@ export function require(path) {
           isModule: true,
         });
       })
-      .then((result) => {
-        if (path.endsWith(".css")) return result;
-        return result?.default ?? result;
-      })
-      .catch((error) => {
-        throw reportRuntimeError(error, path);
+      .then(result =>
+          result?.default ?? result
+      )
+      .catch(error => {
+        throw report(error, path);
       });
   }
 
   const resolved = Lilact.resolver?.(path);
 
-  if (resolved !== undefined && resolved !== null) {
+  if (resolved != null) {
     if (path.endsWith(".css")) {
       injectGlobal(String(resolved));
       return;
@@ -325,8 +291,8 @@ export function require(path) {
   try {
     request.open("GET", path, false);
     request.send(null);
-  } catch (error) {
-    throw reportRuntimeError(error, path);
+  } catch (value) {
+    throw report(value, path);
   }
 
   if (request.status >= 200 && request.status < 300) {
@@ -341,16 +307,12 @@ export function require(path) {
     });
   }
 
-  const error = new Error(
-    `Unable to load ${path}: HTTP ${request.status || 0}`
+  throw report(
+    new Error(`Unable to load ${path}: HTTP ${request.status || 0}`),
+    path
   );
-  error.fileName = path;
-  throw error;
 }
 
-/**
- * Enables async, code-split component loading.
- */
 export function lazy(factory) {
   let status = "pending";
   let result;
@@ -366,11 +328,11 @@ export function lazy(factory) {
 
   if (Lilact.isThenable(result)) {
     result.then(
-      (module) => {
+      value => {
         status = "success";
-        result = module;
+        result = value;
       },
-      (error) => {
+      error => {
         status = "error";
         result = error;
       }
@@ -390,18 +352,18 @@ export function lazy(factory) {
   return LazyComponent;
 }
 
-function scanScriptTagsWithType() {
+function scriptTags() {
   return Array.from(
     document.querySelectorAll('script[type="text/jsx"]')
-  ).map((element) => ({
+  ).map(element => ({
     src: element.getAttribute("src"),
     content: element.textContent || "",
   }));
 }
 
-export function runScripts() {
-  for (const script of scanScriptTagsWithType()) {
-    if (script.src) require(script.src);
+export async function runScripts() {
+  for (const script of scriptTags()) {
+    if (script.src) await require(script.src);
     if (script.content) run(script.content);
   }
 }

package/docs/functions/errors.mapLocation.html

@@ -1 +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>mapLocation | 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/errors.html">errors</a></li><li><a href="" aria-current="page">mapLocation</a></li></ul><h1>Function mapLocation</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="maplocation"><span class="tsd-kind-call-signature">mapLocation</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">mappings</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-parameter">generatedLine</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-parameter">generatedColumn</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> <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> <span class="tsd-kind-property">line</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span> <span class="tsd-signature-symbol">}</span><a href="#maplocation" 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-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">mappings</span>: <span class="tsd-signature-type">any</span></span></li><li><span><span class="tsd-kind-parameter">generatedLine</span>: <span class="tsd-signature-type">any</span></span></li><li><span><span class="tsd-kind-parameter">generatedColumn</span>: <span class="tsd-signature-type">any</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-symbol">{</span> <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> <span class="tsd-kind-property">line</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">any</span> <span class="tsd-signature-symbol">}</span></h4><aside class="tsd-sources"><ul><li>Defined in errors.jsx:180</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>