@mateosuarezdev/flash 0.0.1

package/dist/jsx-dev-runtime-BfTCjShK.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+let o = 0;
+const r = () => o++;
+let l = null;
+function d(n) {
+  l = n;
+}
+function u() {
+  return l;
+}
+function i(n, e, t) {
+  return {
+    type: n,
+    kind: "VNode",
+    props: e,
+    key: t,
+    children: e.children,
+    _id: r(),
+    _onMountCallbacks: [],
+    _onUnmountCallbacks: [],
+    _onBeforeExitCallbacks: [],
+    _element: null,
+    _parent: null,
+    _renderedChildren: [],
+    _lifecycleState: "mounting"
+  };
+}
+function c(n, e, t) {
+  return {
+    type: n,
+    kind: "IntrinsicVNode",
+    props: e,
+    key: t,
+    _id: r(),
+    _dom: void 0,
+    // DOM created lazily during render
+    _parent: null,
+    _renderedChildren: [],
+    _onMountCallbacks: [],
+    _onUnmountCallbacks: [],
+    _onBeforeExitCallbacks: [],
+    _lifecycleState: "mounting"
+  };
+}
+const a = Symbol("fragment");
+function s(n, e, t) {
+  return n === a ? e?.children : typeof n == "function" ? i(n, e ?? {}, t) : c(n, e ?? {}, t);
+}
+export {
+  a as F,
+  l as c,
+  u as g,
+  s as j,
+  r as n,
+  d as s
+};

package/dist/jsx-dev-runtime-D4XANMVW.cjs

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+"use strict";let d=0;const r=()=>d++;exports.currentVNode=null;function l(n){exports.currentVNode=n}function u(){return exports.currentVNode}function c(n,e,t){return{type:n,kind:"VNode",props:e,key:t,children:e.children,_id:r(),_onMountCallbacks:[],_onUnmountCallbacks:[],_onBeforeExitCallbacks:[],_element:null,_parent:null,_renderedChildren:[],_lifecycleState:"mounting"}}function i(n,e,t){return{type:n,kind:"IntrinsicVNode",props:e,key:t,_id:r(),_dom:void 0,_parent:null,_renderedChildren:[],_onMountCallbacks:[],_onUnmountCallbacks:[],_onBeforeExitCallbacks:[],_lifecycleState:"mounting"}}const o=Symbol("fragment");function a(n,e,t){return n===o?e?.children:typeof n=="function"?c(n,e??{},t):i(n,e??{},t)}exports.Fragment=o;exports.getCurrentVNode=u;exports.jsx=a;exports.newVNodeId=r;exports.setCurrentVNode=l;

package/dist/jsx-dev-runtime.cjs

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./jsx-dev-runtime-D4XANMVW.cjs");exports.Fragment=e.Fragment;exports.jsx=e.jsx;exports.jsxDEV=e.jsx;exports.jsxs=e.jsx;

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+declare class CancelToken {
+    private _cancelled;
+    private _cancelCallbacks;
+    get cancelled(): boolean;
+    cancel(): void;
+    onCancel(callback: () => void): void;
+    throwIfCancelled(): void;
+}
+
+declare type Child = IntrinsicVNode | VNode | ReactiveVNode | Text | string | number | boolean | null | undefined | (() => Child);
+
+declare type Children = Child | Children[];
+
+declare type ComponentFunction<P = Props> = (props: P) => Child;
+
+export declare const Fragment: unique symbol;
+
+declare interface IntrinsicVNode {
+    type: string;
+    kind: "IntrinsicVNode";
+    props: Props;
+    key?: Key;
+    _id: number;
+    _dom?: HTMLElement | SVGElement;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _onMountCallbacks: (() => void)[];
+    _onUnmountCallbacks: (() => void)[];
+    _onBeforeExitCallbacks: ((token: CancelToken) => void | Promise<void>)[];
+    _lifecycleState?: "mounting" | "mounted" | "exiting" | "exited";
+}
+
+declare function jsx(type: string | ComponentFunction | symbol, props: Props | null, key: string): Children;
+export { jsx }
+export { jsx as jsxDEV }
+export { jsx as jsxs }
+
+declare type Key = string | number;
+
+declare interface Props {
+    children?: Children;
+    ref?: (element: HTMLElement | SVGElement) => void;
+    key?: string | number;
+    [key: string]: any;
+}
+
+declare interface ReactiveVNode {
+    type: "reactive";
+    kind: "ReactiveVNode";
+    fn: () => Child;
+    _id: number;
+    _dispose: VoidFunction | null;
+    _currentChild: VNode | IntrinsicVNode | ReactiveVNode | null;
+    _currentDom: Node | null;
+    _placeholder: Comment | null;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _listState?: {
+        items: any[];
+    };
+}
+
+declare interface VNode {
+    type: ComponentFunction;
+    kind: "VNode";
+    props: Props;
+    children: Children;
+    key?: Key;
+    _id: number;
+    _onMountCallbacks: (() => void)[];
+    _onUnmountCallbacks: (() => void)[];
+    _onBeforeExitCallbacks: ((token: CancelToken) => void | Promise<void>)[];
+    _element: Node | null;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _lifecycleState?: "mounting" | "mounted" | "exiting" | "exited";
+    _contextMap?: Map<Symbol, any>;
+}
+
+export { }

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+import { F as a, j as x, j as r, j as e } from "./jsx-dev-runtime-BfTCjShK.js";
+export {
+  a as Fragment,
+  x as jsx,
+  r as jsxDEV,
+  e as jsxs
+};

package/dist/jsx-runtime.cjs

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./jsx-dev-runtime-D4XANMVW.cjs");exports.Fragment=e.Fragment;exports.jsx=e.jsx;exports.jsxDEV=e.jsx;exports.jsxs=e.jsx;

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+declare class CancelToken {
+    private _cancelled;
+    private _cancelCallbacks;
+    get cancelled(): boolean;
+    cancel(): void;
+    onCancel(callback: () => void): void;
+    throwIfCancelled(): void;
+}
+
+declare type Child = IntrinsicVNode | VNode | ReactiveVNode | Text | string | number | boolean | null | undefined | (() => Child);
+
+declare type Children = Child | Children[];
+
+declare type ComponentFunction<P = Props> = (props: P) => Child;
+
+export declare const Fragment: unique symbol;
+
+declare interface IntrinsicVNode {
+    type: string;
+    kind: "IntrinsicVNode";
+    props: Props;
+    key?: Key;
+    _id: number;
+    _dom?: HTMLElement | SVGElement;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _onMountCallbacks: (() => void)[];
+    _onUnmountCallbacks: (() => void)[];
+    _onBeforeExitCallbacks: ((token: CancelToken) => void | Promise<void>)[];
+    _lifecycleState?: "mounting" | "mounted" | "exiting" | "exited";
+}
+
+declare function jsx(type: string | ComponentFunction | symbol, props: Props | null, key: string): Children;
+export { jsx }
+export { jsx as jsxDEV }
+export { jsx as jsxs }
+
+declare type Key = string | number;
+
+declare interface Props {
+    children?: Children;
+    ref?: (element: HTMLElement | SVGElement) => void;
+    key?: string | number;
+    [key: string]: any;
+}
+
+declare interface ReactiveVNode {
+    type: "reactive";
+    kind: "ReactiveVNode";
+    fn: () => Child;
+    _id: number;
+    _dispose: VoidFunction | null;
+    _currentChild: VNode | IntrinsicVNode | ReactiveVNode | null;
+    _currentDom: Node | null;
+    _placeholder: Comment | null;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _listState?: {
+        items: any[];
+    };
+}
+
+declare interface VNode {
+    type: ComponentFunction;
+    kind: "VNode";
+    props: Props;
+    children: Children;
+    key?: Key;
+    _id: number;
+    _onMountCallbacks: (() => void)[];
+    _onUnmountCallbacks: (() => void)[];
+    _onBeforeExitCallbacks: ((token: CancelToken) => void | Promise<void>)[];
+    _element: Node | null;
+    _parent: VNode | ReactiveVNode | IntrinsicVNode | null;
+    _renderedChildren: (VNode | ReactiveVNode | IntrinsicVNode)[];
+    _lifecycleState?: "mounting" | "mounted" | "exiting" | "exited";
+    _contextMap?: Map<Symbol, any>;
+}
+
+export { }

package/dist/jsx-runtime.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+import { F as a, j as x, j as r, j as e } from "./jsx-dev-runtime-BfTCjShK.js";
+export {
+  a as Fragment,
+  x as jsx,
+  r as jsxDEV,
+  e as jsxs
+};

package/dist/server.cjs

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("node:fs/promises"),m=require("node:path");function b(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function v(t){return t.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}const A=new Set(["area","base","br","col","embed","hr","img","input","link","meta","source","track","wbr"]);function E(t){return/^on[A-Z]/.test(t)}function w(t){return Object.entries(t).map(([r,o])=>`${r.replace(/[A-Z]/g,n=>`-${n.toLowerCase()}`)}:${o}`).join(";")}function D(t,r=!0){const o=Object.entries(t).filter(([e,n])=>!(n==null||r&&e==="children"||E(e))).map(([e,n])=>(e==="className"&&(e="class"),e==="style"&&typeof n=="object"&&(n=w(n)),typeof n=="boolean"?n?e:"":`${e}="${v(String(n))}"`)).filter(Boolean).join(" ");return o?` ${o}`:""}function $(t){return t?Array.isArray(t)?t:[t]:[]}function j(t){return t&&typeof t.then=="function"}function h(t,r){return`<div id="${t}" data-server-component="suspended" data-component-name="${r}">Loading...</div>`}const a=new Map;let f=0;function H(t){return a.clear(),f=0,s(t)}async function T(t){a.clear(),f=0;let r=s(t);for(;a.size>0;){console.log(`🔄 Resolving ${a.size} async components in parallel...`);const o=Array.from(a.entries());a.clear();const e=await Promise.allSettled(o.map(([n,{promise:i}])=>i));for(let n=0;n<o.length;n++){const i=o[n];if(!i)continue;const[l,{componentName:c,errorFallback:u}]=i,p=e[n];if(!p)continue;const y=h(l,c);if(p.status==="fulfilled")try{console.log(`✅ Resolved: ${c} (${l})`);const d=s(p.value);r=r.replace(y,d)}catch(d){console.error(`❌ Error rendering ${c}:`,d);const S=u?s(typeof u=="function"?u(d):u):`<div class="error">Error rendering ${c}</div>`;r=r.replace(y,S)}else{console.error(`❌ Error resolving ${c}:`,p.reason);const d=u?s(typeof u=="function"?u(p.reason):u):`<div class="error">Error loading ${c}</div>`;r=r.replace(y,d)}}}return console.log("✅ All async components resolved!"),r}async function*P(t){for(a.clear(),f=0,yield s(t);a.size>0;){const o=Array.from(a.entries());a.clear();const e=o.map(async([n,{promise:i}])=>{try{const l=await i,c=s(l);return`<script>
+            (function() {
+              const el = document.getElementById('${n}');
+              if (el) {
+                el.outerHTML = \`${c.replace(/`/g,"\\`").replace(/\$/g,"\\$")}\`;
+              }
+            })();
+          <\/script>`}catch{return`<script>
+            (function() {
+              const el = document.getElementById('${n}');
+              if (el) {
+                el.innerHTML = '<div class="error">Error loading component</div>';
+              }
+            })();
+          <\/script>`}});for(const n of e)yield await n}}function s(t){if(typeof t=="function"){const e=t();return Array.isArray(e)?`<!--reactive-list-->${e.map(i=>s(i)).join("")}`:s(e)}if(typeof t=="string")return b(t);if(typeof t=="number")return String(t);if(!t||typeof t!="object")return"";const{type:r,props:o}=t;if(r===Symbol.for("jsx.fragment"))return $(o.children).map(n=>s(n)).join("");if(typeof r=="string"&&r==="suspended"){const e=t,n=`async-${f++}`;return console.log(`⏳ Suspending: ${e._componentName} (${n})`),a.set(n,{id:n,promise:e.promise,componentName:e._componentName,errorFallback:e.errorFallback}),h(n,e._componentName)}if(typeof r=="function"){const e=r(o);if(j(e)){const n=`async-${f++}`,i=r.name||"AsyncComponent";return console.warn(`⚠️ DEPRECATED: Direct async component "${i}" detected. Please use suspend() HOF instead for better type safety and custom fallbacks.
+Example: const ${i} = suspend(async (props) => { ... }, <Loading />, <Error />);`),console.log(`⏳ Suspending: ${i} (${n})`),a.set(n,{id:n,promise:e,componentName:i}),h(n,i)}return s(e)}if(typeof r=="string"){const e=D(o);if(A.has(r))return`<${r}${e} />`;const i=$(o.children).map(l=>{if(typeof l=="function"){const c=l();return Array.isArray(c)?`<!--reactive-list-->${c.map(p=>s(p)).join("")}`:`<!--reactive-->${s(c)}`}return s(l)}).join("");return r==="html"?`<!DOCTYPE html>
+<html${e}>${i}</html>`:`<${r}${e}>${i}</${r}>`}return""}class C{cacheDir;useDirectoryStructure;constructor(r={}){this.cacheDir=r.cacheDir||"./cache/html",this.useDirectoryStructure=r.useDirectoryStructure??!1}async save(r,o){const e=this.getFilepath(r);return await g.mkdir(m.dirname(e),{recursive:!0}),await Bun.write(e,o),console.log(`✅ Pre-rendered: ${r} → ${e}`),e}async load(r){const o=this.getFilepath(r),e=Bun.file(o);return await e.exists()?e:null}async clear(){await g.rm(this.cacheDir,{recursive:!0,force:!0}),await g.mkdir(this.cacheDir,{recursive:!0}),console.log("🗑️ Cache cleared")}async exists(r){const o=this.getFilepath(r);return await Bun.file(o).exists()}getFilepath(r){const o=r.replace(/^\/+|\/+$/g,"");if(this.useDirectoryStructure)return o===""?m.join(this.cacheDir,"index.html"):m.join(this.cacheDir,o,"index.html");{const e=o===""?"index.html":`${o.replace(/\//g,"-")}.html`;return m.join(this.cacheDir,e)}}}exports.PreRenderer=C;exports.renderToStream=P;exports.renderToString=H;exports.renderToStringAsync=T;

package/dist/server.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+/**
+ * Usage
+ * const prerenderer = new PreRenderer()
+ */
+export declare class PreRenderer {
+    private cacheDir;
+    private useDirectoryStructure;
+    constructor(options?: PreRenderOptions);
+    save(pathname: string, html: string): Promise<string>;
+    load(pathname: string): Promise<Bun.BunFile | null>;
+    clear(): Promise<void>;
+    exists(pathname: string): Promise<boolean>;
+    private getFilepath;
+}
+
+declare interface PreRenderOptions {
+    cacheDir?: string;
+    useDirectoryStructure?: boolean;
+}
+
+/**
+ * 3. renderToStream - Stream HTML with placeholders, then stream updates
+ * Use for: Dynamic content, personalized pages, better perceived performance
+ */
+export declare function renderToStream(element: ServerChildren): AsyncGenerator<string>;
+
+/**
+ * 1. renderToString - Synchronous only (no async support)
+ * Use for: Pure sync components, or client first
+ */
+export declare function renderToString(element: ServerChildren): string;
+
+/**
+ * 2. renderToStringAsync - Wait for all async components, then return complete HTML
+ * Use for: Pre-rendering, caching, SSG, SEO
+ */
+export declare function renderToStringAsync(element: ServerChildren): Promise<string>;
+
+declare type ServerChildren = ServerJSXElement | string | number | (() => ServerChildren);
+
+declare interface ServerJSXElement {
+    type: string | Function | symbol;
+    props: {
+        children?: ServerChildren[];
+        [key: string]: any;
+    };
+    key?: string | number;
+}
+
+export { }

package/dist/server.js

@@ -0,0 +1,224 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+import { mkdir as g, rm as b } from "node:fs/promises";
+import { dirname as v, join as y } from "node:path";
+function A(t) {
+  return t.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function E(t) {
+  return t.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+const w = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "wbr"
+]);
+function D(t) {
+  return /^on[A-Z]/.test(t);
+}
+function H(t) {
+  return Object.entries(t).map(([r, o]) => `${r.replace(/[A-Z]/g, (n) => `-${n.toLowerCase()}`)}:${o}`).join(";");
+}
+function j(t, r = !0) {
+  const o = Object.entries(t).filter(([e, n]) => !(n == null || r && e === "children" || D(e))).map(([e, n]) => (e === "className" && (e = "class"), e === "style" && typeof n == "object" && (n = H(n)), typeof n == "boolean" ? n ? e : "" : `${e}="${E(String(n))}"`)).filter(Boolean).join(" ");
+  return o ? ` ${o}` : "";
+}
+function $(t) {
+  return t ? Array.isArray(t) ? t : [t] : [];
+}
+function P(t) {
+  return t && typeof t.then == "function";
+}
+function h(t, r) {
+  return `<div id="${t}" data-server-component="suspended" data-component-name="${r}">Loading...</div>`;
+}
+const a = /* @__PURE__ */ new Map();
+let d = 0;
+function N(t) {
+  return a.clear(), d = 0, c(t);
+}
+async function T(t) {
+  a.clear(), d = 0;
+  let r = c(t);
+  for (; a.size > 0; ) {
+    console.log(
+      `🔄 Resolving ${a.size} async components in parallel...`
+    );
+    const o = Array.from(a.entries());
+    a.clear();
+    const e = await Promise.allSettled(
+      o.map(([n, { promise: i }]) => i)
+    );
+    for (let n = 0; n < o.length; n++) {
+      const i = o[n];
+      if (!i) continue;
+      const [l, { componentName: s, errorFallback: u }] = i, p = e[n];
+      if (!p) continue;
+      const m = h(l, s);
+      if (p.status === "fulfilled")
+        try {
+          console.log(`✅ Resolved: ${s} (${l})`);
+          const f = c(p.value);
+          r = r.replace(m, f);
+        } catch (f) {
+          console.error(`❌ Error rendering ${s}:`, f);
+          const S = u ? c(
+            typeof u == "function" ? u(f) : u
+          ) : `<div class="error">Error rendering ${s}</div>`;
+          r = r.replace(m, S);
+        }
+      else {
+        console.error(`❌ Error resolving ${s}:`, p.reason);
+        const f = u ? c(
+          typeof u == "function" ? u(p.reason) : u
+        ) : `<div class="error">Error loading ${s}</div>`;
+        r = r.replace(m, f);
+      }
+    }
+  }
+  return console.log("✅ All async components resolved!"), r;
+}
+async function* F(t) {
+  for (a.clear(), d = 0, yield c(t); a.size > 0; ) {
+    const o = Array.from(a.entries());
+    a.clear();
+    const e = o.map(
+      async ([n, { promise: i }]) => {
+        try {
+          const l = await i, s = c(l);
+          return `<script>
+            (function() {
+              const el = document.getElementById('${n}');
+              if (el) {
+                el.outerHTML = \`${s.replace(/`/g, "\\`").replace(/\$/g, "\\$")}\`;
+              }
+            })();
+          <\/script>`;
+        } catch {
+          return `<script>
+            (function() {
+              const el = document.getElementById('${n}');
+              if (el) {
+                el.innerHTML = '<div class="error">Error loading component</div>';
+              }
+            })();
+          <\/script>`;
+        }
+      }
+    );
+    for (const n of e)
+      yield await n;
+  }
+}
+function c(t) {
+  if (typeof t == "function") {
+    const e = t();
+    return Array.isArray(e) ? `<!--reactive-list-->${e.map((i) => c(i)).join("")}` : c(e);
+  }
+  if (typeof t == "string")
+    return A(t);
+  if (typeof t == "number")
+    return String(t);
+  if (!t || typeof t != "object")
+    return "";
+  const { type: r, props: o } = t;
+  if (r === Symbol.for("jsx.fragment"))
+    return $(o.children).map((n) => c(n)).join("");
+  if (typeof r == "string" && r === "suspended") {
+    const e = t, n = `async-${d++}`;
+    return console.log(
+      `⏳ Suspending: ${e._componentName} (${n})`
+    ), a.set(n, {
+      id: n,
+      promise: e.promise,
+      componentName: e._componentName,
+      errorFallback: e.errorFallback
+      // Store custom error fallback
+    }), h(n, e._componentName);
+  }
+  if (typeof r == "function") {
+    const e = r(o);
+    if (P(e)) {
+      const n = `async-${d++}`, i = r.name || "AsyncComponent";
+      return console.warn(
+        `⚠️ DEPRECATED: Direct async component "${i}" detected. Please use suspend() HOF instead for better type safety and custom fallbacks.
+Example: const ${i} = suspend(async (props) => { ... }, <Loading />, <Error />);`
+      ), console.log(`⏳ Suspending: ${i} (${n})`), a.set(n, {
+        id: n,
+        promise: e,
+        componentName: i
+      }), h(n, i);
+    }
+    return c(e);
+  }
+  if (typeof r == "string") {
+    const e = j(o);
+    if (w.has(r))
+      return `<${r}${e} />`;
+    const i = $(o.children).map((l) => {
+      if (typeof l == "function") {
+        const s = l();
+        return Array.isArray(s) ? `<!--reactive-list-->${s.map((p) => c(p)).join("")}` : `<!--reactive-->${c(s)}`;
+      }
+      return c(l);
+    }).join("");
+    return r === "html" ? `<!DOCTYPE html>
+<html${e}>${i}</html>` : `<${r}${e}>${i}</${r}>`;
+  }
+  return "";
+}
+class z {
+  cacheDir;
+  useDirectoryStructure;
+  constructor(r = {}) {
+    this.cacheDir = r.cacheDir || "./cache/html", this.useDirectoryStructure = r.useDirectoryStructure ?? !1;
+  }
+  async save(r, o) {
+    const e = this.getFilepath(r);
+    return await g(v(e), { recursive: !0 }), await Bun.write(e, o), console.log(`✅ Pre-rendered: ${r} → ${e}`), e;
+  }
+  async load(r) {
+    const o = this.getFilepath(r), e = Bun.file(o);
+    return await e.exists() ? e : null;
+  }
+  async clear() {
+    await b(this.cacheDir, { recursive: !0, force: !0 }), await g(this.cacheDir, { recursive: !0 }), console.log("🗑️ Cache cleared");
+  }
+  async exists(r) {
+    const o = this.getFilepath(r);
+    return await Bun.file(o).exists();
+  }
+  getFilepath(r) {
+    const o = r.replace(/^\/+|\/+$/g, "");
+    if (this.useDirectoryStructure)
+      return o === "" ? y(this.cacheDir, "index.html") : y(this.cacheDir, o, "index.html");
+    {
+      const e = o === "" ? "index.html" : `${o.replace(/\//g, "-")}.html`;
+      return y(this.cacheDir, e);
+    }
+  }
+}
+export {
+  z as PreRenderer,
+  F as renderToStream,
+  N as renderToString,
+  T as renderToStringAsync
+};

package/dist/utils.cjs

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e){return new Promise(t=>{setTimeout(t,e)})}exports.sleep=o;

package/dist/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+export declare function sleep(ms: number): Promise<void>;
+
+export { }

package/dist/utils.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Flash
+ * Copyright (c) 2025 Mateo Suarez. All rights reserved.
+ *
+ * Free to use in your own personal or commercial applications and projects.
+ * Unauthorized copying, modification, or distribution is strictly prohibited.
+ * See LICENSE file for full terms.
+ */
+
+function n(e) {
+  return new Promise((t) => {
+    setTimeout(t, e);
+  });
+}
+export {
+  n as sleep
+};