@fluixi/core 1.0.0-alpha.100

package/dist/src/lib/plugins/route-scanner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module @fluixi/core/plugins/route-scanner
+ *
+ * Scans a routes directory and builds a route tree following SolidStart conventions.
+ * Pure utility, no bundler dependency.
+ */
+export interface ScannedRoute {
+    /** Relative file path from routes dir: 'users/[id].tsx' */
+    filePath: string;
+    /** URL segment for this route: ':id', 'about', '' (index) */
+    urlSegment: string;
+    /** Full URL path: '/users/:id' */
+    urlPath: string;
+    /** Whether this is a layout file (layout.tsx) */
+    isLayout: boolean;
+    /** Whether this is an index file (index.tsx) */
+    isIndex: boolean;
+    /** Whether this has dynamic params ([id]) */
+    isDynamic: boolean;
+    /** Whether this is a catch-all ([...rest]) */
+    isCatchAll: boolean;
+    /** Whether the parent directory is a route group ((name)) */
+    isGroup: boolean;
+    /** Nested child routes */
+    children: ScannedRoute[];
+    parentUrlPath: string;
+    /** Whether this route file exports a `routeData` function */
+    hasRouteData: boolean;
+}
+export interface ScanOptions {
+    /** File extensions to include */
+    extensions?: string[];
+}
+/**
+ * Scan a routes directory and return a tree of ScannedRoute nodes.
+ */
+export declare function scanRoutes(routesDir: string, options?: ScanOptions): ScannedRoute[];
+//# sourceMappingURL=route-scanner.d.ts.map

package/dist/src/lib/plugins/route-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-scanner.d.ts","sourceRoot":"","sources":["../../../../src/lib/plugins/route-scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAQD;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,YAAY,EAAE,CAShB"}

package/dist/src/lib/plugins/route-scanner.js

@@ -0,0 +1,215 @@
+/**
+ * @module @fluixi/core/plugins/route-scanner
+ *
+ * Scans a routes directory and builds a route tree following SolidStart conventions.
+ * Pure utility, no bundler dependency.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_EXTENSIONS = ['.tsx', '.ts', '.jsx', '.js'];
+// ============================================================================
+// SCANNING
+// ============================================================================
+/**
+ * Scan a routes directory and return a tree of ScannedRoute nodes.
+ */
+export function scanRoutes(routesDir, options = {}) {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const absDir = path.resolve(routesDir);
+    if (!fs.existsSync(absDir)) {
+        return [];
+    }
+    return scanDirectory(absDir, absDir, '', extensions);
+}
+function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    const routes = [];
+    const layoutRoute = null;
+    // Separate files and directories
+    const files = [];
+    const dirs = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            dirs.push(entry);
+        }
+        else if (entry.isFile() && hasValidExtension(entry.name, extensions)) {
+            files.push(entry);
+        }
+    }
+    // Find layout file first
+    let layout;
+    const nonLayoutFiles = [];
+    for (const file of files) {
+        const baseName = stripExtension(file.name);
+        if (baseName === 'layout') {
+            layout = buildFileRoute(file.name, dir, rootDir, parentUrlPath, true);
+        }
+        else {
+            nonLayoutFiles.push(file);
+        }
+    }
+    // Build routes for non-layout files
+    const fileRoutes = [];
+    for (const file of nonLayoutFiles) {
+        fileRoutes.push(buildFileRoute(file.name, dir, rootDir, parentUrlPath, false));
+    }
+    // Build routes for subdirectories
+    const dirRoutes = [];
+    for (const d of dirs) {
+        const dirName = d.name;
+        const isGroup = isRouteGroup(dirName);
+        const segment = isGroup ? '' : dirNameToSegment(dirName);
+        const childUrlPath = segment
+            ? joinUrlPath(parentUrlPath, segment)
+            : parentUrlPath;
+        const children = scanDirectory(path.join(dir, dirName), rootDir, childUrlPath, extensions);
+        if (isGroup) {
+            // Route groups: children are flattened to parent level
+            dirRoutes.push(...children);
+        }
+        else {
+            // Regular directory: becomes a nested route
+            // If there's a DIRECT layout in the children (urlPath matches this dir's path),
+            // it becomes the parent route. We must not pick up layouts from deeper descendants
+            // (e.g. campaigns/[id]/workspace/layout.tsx must not be the layout for campaigns/).
+            const childLayout = children.find((c) => c.isLayout && c.urlPath === childUrlPath);
+            const childNonLayout = children.filter((c) => !c.isLayout || c.urlPath !== childUrlPath);
+            if (childLayout) {
+                // Preserve children from recursive scan, add any non-layout siblings
+                childLayout.children = [...childLayout.children, ...childNonLayout];
+                dirRoutes.push(childLayout);
+            }
+            else if (childNonLayout.length > 0) {
+                // No layout, just add children with their full paths
+                dirRoutes.push(...childNonLayout);
+            }
+        }
+    }
+    // Combine: if there's a layout at this level, nest everything under it
+    if (layout) {
+        layout.children = [...fileRoutes, ...dirRoutes];
+        routes.push(layout);
+    }
+    else {
+        routes.push(...fileRoutes, ...dirRoutes);
+    }
+    // Sort: static routes first, then dynamic, then catch-all
+    return sortRoutes(routes);
+}
+// ============================================================================
+// ROUTE BUILDING
+// ============================================================================
+function buildFileRoute(fileName, dir, rootDir, parentUrlPath, isLayout) {
+    const baseName = stripExtension(fileName);
+    const filePath = path.relative(rootDir, path.join(dir, fileName));
+    const isIndex = baseName === 'index';
+    const isCatchAll = baseName.startsWith('[...');
+    const isDynamic = !isCatchAll && baseName.startsWith('[') && baseName.endsWith(']');
+    let urlSegment;
+    if (isLayout) {
+        urlSegment = '';
+    }
+    else if (isIndex) {
+        urlSegment = '/';
+    }
+    else if (isCatchAll) {
+        // [...rest] -> *rest
+        const paramName = baseName.slice(4, -1); // remove '[...' and ']'
+        urlSegment = `*${paramName}`;
+    }
+    else if (isDynamic) {
+        // [id] -> :id
+        const paramName = baseName.slice(1, -1); // remove '[' and ']'
+        urlSegment = `:${paramName}`;
+    }
+    else {
+        urlSegment = baseName;
+    }
+    const urlPath = isLayout
+        ? parentUrlPath || '/'
+        : isIndex
+            ? parentUrlPath || '/'
+            : joinUrlPath(parentUrlPath, urlSegment);
+    // Detect if the file exports a `routeData` function (static analysis at scan time)
+    const absoluteFilePath = path.join(dir, fileName);
+    let hasRouteData = false;
+    try {
+        const content = fs.readFileSync(absoluteFilePath, 'utf-8');
+        hasRouteData = /export\s+(const|function|async\s+function)\s+routeData\b/.test(content);
+    }
+    catch {
+        // If file can't be read, assume no routeData
+    }
+    return {
+        filePath: filePath.replace(/\\/g, '/'), // normalize to forward slashes
+        urlSegment,
+        urlPath,
+        isLayout,
+        isIndex,
+        isDynamic,
+        isCatchAll,
+        isGroup: false,
+        children: [],
+        parentUrlPath,
+        hasRouteData,
+        rootDir,
+        dir
+    };
+}
+// ============================================================================
+// UTILITIES
+// ============================================================================
+function hasValidExtension(fileName, extensions) {
+    return extensions.some((ext) => fileName.endsWith(ext));
+}
+function stripExtension(fileName) {
+    const lastDot = fileName.lastIndexOf('.');
+    return lastDot > 0 ? fileName.slice(0, lastDot) : fileName;
+}
+function isRouteGroup(dirName) {
+    return dirName.startsWith('(') && dirName.endsWith(')');
+}
+/** Convert a directory name to its URL segment, matching the same rules as file names. */
+function dirNameToSegment(dirName) {
+    if (dirName.startsWith('[...') && dirName.endsWith(']')) {
+        return '*' + dirName.slice(4, -1); // [...rest] -> *rest
+    }
+    if (dirName.startsWith('[') && dirName.endsWith(']')) {
+        return ':' + dirName.slice(1, -1); // [id] -> :id
+    }
+    return dirName;
+}
+function joinUrlPath(parent, segment) {
+    const base = parent.endsWith('/') ? parent : parent + '/';
+    return base + segment;
+}
+/**
+ * Sort routes by specificity: static > dynamic > catch-all.
+ * Index routes come before non-index at the same level.
+ */
+function sortRoutes(routes) {
+    return routes.sort((a, b) => {
+        // Layouts first (they wrap children)
+        if (a.isLayout && !b.isLayout)
+            return -1;
+        if (!a.isLayout && b.isLayout)
+            return 1;
+        // Index routes before others
+        if (a.isIndex && !b.isIndex)
+            return -1;
+        if (!a.isIndex && b.isIndex)
+            return 1;
+        // Static before dynamic
+        if (!a.isDynamic && !a.isCatchAll && (b.isDynamic || b.isCatchAll))
+            return -1;
+        if ((a.isDynamic || a.isCatchAll) && !b.isDynamic && !b.isCatchAll)
+            return 1;
+        // Dynamic before catch-all
+        if (a.isDynamic && b.isCatchAll)
+            return -1;
+        if (a.isCatchAll && b.isDynamic)
+            return 1;
+        // Alphabetical fallback
+        return a.urlSegment.localeCompare(b.urlSegment);
+    });
+}

package/dist/src/lib/plugins/route-scanner.mjs

@@ -0,0 +1,158 @@
+// src/lib/plugins/route-scanner.ts
+import * as fs from "fs";
+import * as path from "path";
+var DEFAULT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
+function scanRoutes(routesDir, options = {}) {
+  const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+  const absDir = path.resolve(routesDir);
+  if (!fs.existsSync(absDir)) {
+    return [];
+  }
+  return scanDirectory(absDir, absDir, "", extensions);
+}
+function scanDirectory(dir, rootDir, parentUrlPath, extensions) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const routes = [];
+  const layoutRoute = null;
+  const files = [];
+  const dirs = [];
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      dirs.push(entry);
+    } else if (entry.isFile() && hasValidExtension(entry.name, extensions)) {
+      files.push(entry);
+    }
+  }
+  let layout;
+  const nonLayoutFiles = [];
+  for (const file of files) {
+    const baseName = stripExtension(file.name);
+    if (baseName === "layout") {
+      layout = buildFileRoute(file.name, dir, rootDir, parentUrlPath, true);
+    } else {
+      nonLayoutFiles.push(file);
+    }
+  }
+  const fileRoutes = [];
+  for (const file of nonLayoutFiles) {
+    fileRoutes.push(
+      buildFileRoute(file.name, dir, rootDir, parentUrlPath, false)
+    );
+  }
+  const dirRoutes = [];
+  for (const d of dirs) {
+    const dirName = d.name;
+    const isGroup = isRouteGroup(dirName);
+    const segment = isGroup ? "" : dirNameToSegment(dirName);
+    const childUrlPath = segment ? joinUrlPath(parentUrlPath, segment) : parentUrlPath;
+    const children = scanDirectory(
+      path.join(dir, dirName),
+      rootDir,
+      childUrlPath,
+      extensions
+    );
+    if (isGroup) {
+      dirRoutes.push(...children);
+    } else {
+      const childLayout = children.find((c) => c.isLayout && c.urlPath === childUrlPath);
+      const childNonLayout = children.filter((c) => !c.isLayout || c.urlPath !== childUrlPath);
+      if (childLayout) {
+        childLayout.children = [...childLayout.children, ...childNonLayout];
+        dirRoutes.push(childLayout);
+      } else if (childNonLayout.length > 0) {
+        dirRoutes.push(...childNonLayout);
+      }
+    }
+  }
+  if (layout) {
+    layout.children = [...fileRoutes, ...dirRoutes];
+    routes.push(layout);
+  } else {
+    routes.push(...fileRoutes, ...dirRoutes);
+  }
+  return sortRoutes(routes);
+}
+function buildFileRoute(fileName, dir, rootDir, parentUrlPath, isLayout) {
+  const baseName = stripExtension(fileName);
+  const filePath = path.relative(rootDir, path.join(dir, fileName));
+  const isIndex = baseName === "index";
+  const isCatchAll = baseName.startsWith("[...");
+  const isDynamic = !isCatchAll && baseName.startsWith("[") && baseName.endsWith("]");
+  let urlSegment;
+  if (isLayout) {
+    urlSegment = "";
+  } else if (isIndex) {
+    urlSegment = "/";
+  } else if (isCatchAll) {
+    const paramName = baseName.slice(4, -1);
+    urlSegment = `*${paramName}`;
+  } else if (isDynamic) {
+    const paramName = baseName.slice(1, -1);
+    urlSegment = `:${paramName}`;
+  } else {
+    urlSegment = baseName;
+  }
+  const urlPath = isLayout ? parentUrlPath || "/" : isIndex ? parentUrlPath || "/" : joinUrlPath(parentUrlPath, urlSegment);
+  const absoluteFilePath = path.join(dir, fileName);
+  let hasRouteData = false;
+  try {
+    const content = fs.readFileSync(absoluteFilePath, "utf-8");
+    hasRouteData = /export\s+(const|function|async\s+function)\s+routeData\b/.test(content);
+  } catch {
+  }
+  return {
+    filePath: filePath.replace(/\\/g, "/"),
+    // normalize to forward slashes
+    urlSegment,
+    urlPath,
+    isLayout,
+    isIndex,
+    isDynamic,
+    isCatchAll,
+    isGroup: false,
+    children: [],
+    parentUrlPath,
+    hasRouteData,
+    rootDir,
+    dir
+  };
+}
+function hasValidExtension(fileName, extensions) {
+  return extensions.some((ext) => fileName.endsWith(ext));
+}
+function stripExtension(fileName) {
+  const lastDot = fileName.lastIndexOf(".");
+  return lastDot > 0 ? fileName.slice(0, lastDot) : fileName;
+}
+function isRouteGroup(dirName) {
+  return dirName.startsWith("(") && dirName.endsWith(")");
+}
+function dirNameToSegment(dirName) {
+  if (dirName.startsWith("[...") && dirName.endsWith("]")) {
+    return "*" + dirName.slice(4, -1);
+  }
+  if (dirName.startsWith("[") && dirName.endsWith("]")) {
+    return ":" + dirName.slice(1, -1);
+  }
+  return dirName;
+}
+function joinUrlPath(parent, segment) {
+  const base = parent.endsWith("/") ? parent : parent + "/";
+  return base + segment;
+}
+function sortRoutes(routes) {
+  return routes.sort((a, b) => {
+    if (a.isLayout && !b.isLayout) return -1;
+    if (!a.isLayout && b.isLayout) return 1;
+    if (a.isIndex && !b.isIndex) return -1;
+    if (!a.isIndex && b.isIndex) return 1;
+    if (!a.isDynamic && !a.isCatchAll && (b.isDynamic || b.isCatchAll)) return -1;
+    if ((a.isDynamic || a.isCatchAll) && !b.isDynamic && !b.isCatchAll) return 1;
+    if (a.isDynamic && b.isCatchAll) return -1;
+    if (a.isCatchAll && b.isDynamic) return 1;
+    return a.urlSegment.localeCompare(b.urlSegment);
+  });
+}
+export {
+  scanRoutes
+};

package/dist/src/lib/plugins/vite.cjs

@@ -0,0 +1,27 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/plugins/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  createVitePlugin: () => import_vite_plugin.createVitePlugin,
+  fluixi: () => import_vite_plugin.fluixi
+});
+module.exports = __toCommonJS(vite_exports);
+var import_vite_plugin = require("@fluixi/vite-plugin");

package/dist/src/lib/plugins/vite.d.ts

@@ -0,0 +1,3 @@
+export { fluixi, createVitePlugin } from '@fluixi/vite-plugin';
+export type { FluixiViteOptions } from '@fluixi/vite-plugin';
+//# sourceMappingURL=vite.d.ts.map

package/dist/src/lib/plugins/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../../../src/lib/plugins/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/lib/plugins/vite.js

@@ -0,0 +1 @@
+export { fluixi, createVitePlugin } from '@fluixi/vite-plugin';

package/dist/src/lib/plugins/vite.mjs

@@ -0,0 +1,6 @@
+// src/lib/plugins/vite.ts
+import { fluixi, createVitePlugin } from "@fluixi/vite-plugin";
+export {
+  createVitePlugin,
+  fluixi
+};

package/dist/src/lib/render/await.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/render/await.ts
+var await_exports = {};
+__export(await_exports, {
+  Await: () => Await
+});
+module.exports = __toCommonJS(await_exports);
+var import_signal = require("@fluixi/reactive/signal");
+function Await(props) {
+  const fetcher = () => {
+    const v = props.value;
+    return typeof v === "function" ? v() : v;
+  };
+  const [data] = (0, import_signal.createResource)(fetcher);
+  return () => {
+    if (data.loading) return props.fallback;
+    const child = props.children;
+    return typeof child === "function" ? child(data()) : child;
+  };
+}

package/dist/src/lib/render/await.d.ts

@@ -0,0 +1,26 @@
+export interface AwaitProps<T> {
+    value: Promise<T> | (() => Promise<T>);
+    fallback?: unknown;
+    /** Render prop called with the resolved value (or plain children). */
+    children?: ((value: T) => unknown) | unknown;
+}
+/**
+ * Render the result of a promise, with a fallback while it is pending.
+ *
+ * `value` may be a promise or a function returning one. Pass a function when the promise
+ * should be created by the component rather than by whoever wrote the tag, which is what
+ * keeps a re-render from firing the request again.
+ *
+ * `children` is either a render prop called with the resolved value, or plain children
+ * that ignore it.
+ *
+ * @example
+ * ```ts
+ * html`
+ *   <${Await} value=${() => fetchUser(id)} fallback=${html`<p>loading...</p>`}>
+ *     ${(user) => html`<h1>${user.name}</h1>`}
+ *   </${Await}>`;
+ * ```
+ */
+export declare function Await<T>(props: AwaitProps<T>): () => unknown;
+//# sourceMappingURL=await.d.ts.map

package/dist/src/lib/render/await.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"await.d.ts","sourceRoot":"","sources":["../../../../src/lib/render/await.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAW5D"}

package/dist/src/lib/render/await.js

@@ -0,0 +1,45 @@
+/**
+ * `<Await value=${promise}>`: resolve a promise and render its value.
+ *
+ * A thin, Suspense-free helper for the common "await one promise" case:
+ *
+ *   <Await value=${fetchUser(id)} fallback=${html`<p>loading...</p>`}>
+ *     ${(user) => html`<span>${user.name}</span>`}
+ *   </Await>
+ *
+ * `value` is a promise (or a function returning one). While pending it renders
+ * `fallback`; once resolved it calls the render-prop child with the value. The
+ * resource read is guarded by `.loading`, so it never throws/suspends.
+ */
+import { createResource } from '@fluixi/reactive/signal';
+/**
+ * Render the result of a promise, with a fallback while it is pending.
+ *
+ * `value` may be a promise or a function returning one. Pass a function when the promise
+ * should be created by the component rather than by whoever wrote the tag, which is what
+ * keeps a re-render from firing the request again.
+ *
+ * `children` is either a render prop called with the resolved value, or plain children
+ * that ignore it.
+ *
+ * @example
+ * ```ts
+ * html`
+ *   <${Await} value=${() => fetchUser(id)} fallback=${html`<p>loading...</p>`}>
+ *     ${(user) => html`<h1>${user.name}</h1>`}
+ *   </${Await}>`;
+ * ```
+ */
+export function Await(props) {
+    const fetcher = () => {
+        const v = props.value;
+        return typeof v === 'function' ? v() : v;
+    };
+    const [data] = createResource(fetcher);
+    return () => {
+        if (data.loading)
+            return props.fallback;
+        const child = props.children;
+        return typeof child === 'function' ? child(data()) : child;
+    };
+}

package/dist/src/lib/render/await.mjs

@@ -0,0 +1,17 @@
+// src/lib/render/await.ts
+import { createResource } from "@fluixi/reactive/signal";
+function Await(props) {
+  const fetcher = () => {
+    const v = props.value;
+    return typeof v === "function" ? v() : v;
+  };
+  const [data] = createResource(fetcher);
+  return () => {
+    if (data.loading) return props.fallback;
+    const child = props.children;
+    return typeof child === "function" ? child(data()) : child;
+  };
+}
+export {
+  Await
+};