npm - weifuwu - Versions diffs - 0.33.0 → 0.33.2 - Mend

weifuwu 0.33.0 → 0.33.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +303 -145
package/dist/client/app.d.ts +21 -0
package/dist/client/index.d.ts +21 -0
package/dist/client/index.js +320 -0
package/dist/client/jsx-runtime.d.ts +60 -0
package/dist/client/jsx-runtime.js +320 -0
package/dist/client/router.d.ts +51 -0
package/dist/client/signal.d.ts +19 -0
package/dist/client/types.d.ts +45 -0
package/dist/index.d.ts +0 -7
package/dist/index.js +13 -925
package/dist/types.d.ts +0 -1
package/package.json +9 -42
package/dist/middleware/esbuild-dev.d.ts +0 -69
package/dist/middleware/esbuild-dev.js +0 -335
package/dist/middleware/tailwind-dev.d.ts +0 -43
package/dist/middleware/tailwind-dev.js +0 -199
package/dist/react/client.d.ts +0 -76
package/dist/react/client.js +0 -182
package/dist/react/compile.d.ts +0 -17
package/dist/react/context.d.ts +0 -2
package/dist/react/error-boundary.d.ts +0 -30
package/dist/react/hooks.d.ts +0 -6
package/dist/react/index.d.ts +0 -92
package/dist/react/index.js +0 -910
package/dist/react/types.d.ts +0 -146

package/dist/middleware/tailwind-dev.js DELETED Viewed

@@ -1,199 +0,0 @@
-// src/middleware/tailwind-dev.ts
-import { resolve } from "node:path";
-import { stat, readFile, glob } from "node:fs/promises";
-function escapeHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-function defaultErrorTemplate(errors) {
-  return `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8">
-  <title>Tailwind Build Error</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: system-ui; background: #1a1a2e; color: #e0e0e0; padding: 2rem; }
-    .overlay { position: fixed; inset: 0; display: flex; align-items: center; justify-content: center; }
-    .card { background: #16213e; border: 1px solid #06b6d4; border-radius: 12px; padding: 2rem; max-width: 800px; width: 100%; box-shadow: 0 8px 32px rgba(0,0,0,0.4); }
-    h1 { color: #06b6d4; font-size: 1.5rem; margin-bottom: 1rem; display: flex; align-items: center; gap: 0.5rem; }
-    pre { background: #0f0f23; padding: 1.5rem; border-radius: 8px; overflow: auto; font-size: 0.85rem; line-height: 1.6; white-space: pre-wrap; word-break: break-word; }
-  </style>
-</head>
-<body>
-  <div class="overlay">
-    <div class="card">
-      <h1>\u{1F3A8} Tailwind CSS Build Error</h1>
-      <pre>${escapeHtml(errors)}</pre>
-    </div>
-  </div>
-</body>
-</html>`;
-}
-var TW_CANDIDATE_RE = /[a-z][\w-]*(?::[a-z][\w-]*)*(?:-\[[^\]]*\])*(?:\/[0-9]+)?/gi;
-var CLASS_CONTEXT_RE = /(?:class(?:Name)?\s*[=:]\s*["'`]([^"'`]+)["'`]|["'`]([^"'`\n]{2,})["'`])/g;
-async function extractCandidates(patterns, root) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const pattern of patterns) {
-    const resolved = resolve(root, pattern);
-    try {
-      for await (const file of glob(resolved)) {
-        try {
-          const content = await readFile(file, "utf-8");
-          for (const m of content.matchAll(CLASS_CONTEXT_RE)) {
-            const str = m[1] ?? m[2];
-            if (!str) continue;
-            for (const c of str.matchAll(TW_CANDIDATE_RE)) {
-              seen.add(c[0]);
-            }
-          }
-        } catch {
-        }
-      }
-    } catch {
-    }
-  }
-  return [...seen];
-}
-async function collectFileMtimes(files) {
-  const map = /* @__PURE__ */ new Map();
-  await Promise.all(
-    files.map(async (f) => {
-      try {
-        const s = await stat(f);
-        map.set(f, s.mtimeMs);
-      } catch {
-      }
-    })
-  );
-  return map;
-}
-function isCacheValid(cached) {
-  return Promise.all(
-    [...cached.files].map(async ([file, mtime]) => {
-      try {
-        const s = await stat(file);
-        return s.mtimeMs === mtime;
-      } catch {
-        return false;
-      }
-    })
-  ).then((results) => results.every(Boolean));
-}
-function tailwindDev(opts) {
-  const cacheMode = opts.cache ?? "memory";
-  const errorTemplate = opts.errorTemplate ?? defaultErrorTemplate;
-  const entries = Object.entries(opts.entries).map(([p, e]) => {
-    const path = p.startsWith("/") ? p : "/" + p;
-    const config = typeof e === "string" ? { entry: e } : e;
-    return { path, config };
-  });
-  const cacheStore = /* @__PURE__ */ new Map();
-  let compileFn = null;
-  let loadError = null;
-  async function getCompile() {
-    if (compileFn) return compileFn;
-    try {
-      const mod = await import("@tailwindcss/node");
-      compileFn = mod.compile;
-      return compileFn;
-    } catch (err) {
-      loadError = `@tailwindcss/node is not installed. Run: npm install -D tailwindcss @tailwindcss/node
-${String(err)}`;
-      throw new Error(loadError, { cause: err });
-    }
-  }
-  async function compileCss(entry) {
-    const compile = await getCompile();
-    const entryAbs = resolve(entry.entry);
-    const cssSource = await readFile(entryAbs, "utf-8");
-    const baseDir = resolve(entry.entry, "..");
-    const deps = [entryAbs];
-    const result = await compile(cssSource, {
-      base: baseDir,
-      onDependency: (p) => {
-        if (!deps.includes(p)) deps.push(p);
-      }
-    });
-    const contentPatterns = entry.content ?? [];
-    for (const src of result.sources) {
-      if (!src.negated) {
-        contentPatterns.push(resolve(src.base, src.pattern));
-      }
-    }
-    let candidates = [];
-    if (contentPatterns.length > 0) {
-      candidates = await extractCandidates(contentPatterns, baseDir);
-    }
-    const css = result.build(candidates);
-    for (const pattern of contentPatterns) {
-      try {
-        for await (const file of glob(resolve(baseDir, pattern))) {
-          if (!deps.includes(file)) deps.push(file);
-        }
-      } catch {
-      }
-    }
-    const etag = `"tw-${hashCode(css)}"`;
-    return { css, etag, files: deps };
-  }
-  return async (req, ctx, next) => {
-    const url = new URL(req.url);
-    const pathname = url.pathname;
-    const matched = entries.find((e) => e.path === pathname);
-    if (!matched) return next(req, ctx);
-    const { config } = matched;
-    try {
-      if (cacheMode === "memory") {
-        const cached = cacheStore.get(pathname);
-        if (cached) {
-          const valid = await isCacheValid(cached);
-          if (valid) {
-            if (req.headers.get("if-none-match") === cached.etag) {
-              return new Response(null, { status: 304 });
-            }
-            return new Response(cached.css, {
-              headers: {
-                "Content-Type": "text/css; charset=utf-8",
-                ETag: cached.etag,
-                "Cache-Control": "no-cache"
-              }
-            });
-          }
-          cacheStore.delete(pathname);
-        }
-      }
-      const { css, etag, files } = await compileCss(config);
-      if (cacheMode === "memory") {
-        const mtimes = await collectFileMtimes(files);
-        cacheStore.set(pathname, { css, etag, files: mtimes });
-      }
-      return new Response(css, {
-        headers: {
-          "Content-Type": "text/css; charset=utf-8",
-          ETag: etag,
-          "Cache-Control": "no-cache"
-        }
-      });
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      const html = errorTemplate(message);
-      return new Response(html, {
-        status: 500,
-        headers: { "Content-Type": "text/html; charset=utf-8" }
-      });
-    }
-  };
-}
-function hashCode(s) {
-  let hash = 0;
-  for (let i = 0; i < s.length; i++) {
-    const ch = s.charCodeAt(i);
-    hash = (hash << 5) - hash + ch;
-    hash |= 0;
-  }
-  return Math.abs(hash).toString(36);
-}
-export {
-  tailwindDev
-};

package/dist/react/client.d.ts DELETED Viewed

@@ -1,76 +0,0 @@
-/**
- * Client-side entry for React hydration and SPA routing.
- *
- * Hydration:
- * ```ts
- * import { hydrate } from 'weifuwu/react/client'
- * hydrate(HomePage, { layout: PageShell })
- * ```
- *
- * Client-side router:
- * ```ts
- * import { createBrowserRouter } from 'weifuwu/react/client'
- * createBrowserRouter({
- *   layout: PageShell,
- *   routes: {
- *     '/': () => import('./pages/HomePage.tsx'),
- *     '/users/:id': () => import('./pages/UserPage.tsx'),
- *   },
- * })
- * ```
- */
-import { type ComponentType, type ReactNode } from 'react';
-export interface HydrateOptions {
-    /** Hydration target element. Default: document.getElementById('root'). */
-    container?: HTMLElement;
-    /**
-     * Layout component matching the server-side `react({ layout })` config.
-     * Must accept `{ children: ReactNode }`.
-     * When provided, wraps the page component before hydrating —
-     * producing the same tree the server rendered.
-     */
-    layout?: ComponentType<{
-        children: ReactNode;
-    }>;
-}
-/**
- * Hydrate a page component. When `layout` is provided, the hydration tree
- * matches the server-rendered structure: `<div id="root"><Layout><App /></Layout></div>`.
- */
-export declare function hydrate(App: ComponentType, opts?: HydrateOptions): void;
-export interface ClientRouterOptions {
-    /** Layout component shared across all routes. */
-    layout?: ComponentType<{
-        children: ReactNode;
-    }>;
-    /**
-     * Route map: URL pattern → lazy component loader.
-     * Patterns support `:param` segments (e.g. `/users/:id`).
-     */
-    routes: Record<string, () => Promise<Record<string, unknown>>>;
-    /**
-     * Fallback component for unmatched routes.
-     * When omitted, unmatched routes do a full page navigation.
-     */
-    fallback?: () => Promise<Record<string, unknown>>;
-    /** Target element. Default: document.getElementById('root'). */
-    container?: HTMLElement;
-}
-interface RouterHandle {
-    navigate(url: string): Promise<void>;
-    renderPath(pathname: string, isInitial: boolean, data?: Record<string, unknown>): Promise<void>;
-}
-/**
- * Initialise the client-side router.
- *
- * On the initial page load, it hydrates the matching route from the
- * server-rendered HTML.  Subsequent in-app navigations fetch fresh
- * server data and render the new page client-side.
- */
-export declare function createBrowserRouter(opts: ClientRouterOptions): RouterHandle;
-/**
- * Programmatic navigation (call from anywhere).
- * Falls back to `window.location.href = url` if the router hasn't been initialised.
- */
-export declare function navigate(url: string): void;
-export { useServerData } from './hooks.ts';

package/dist/react/client.js DELETED Viewed

@@ -1,182 +0,0 @@
-// src/react/client.ts
-import { createElement } from "react";
-import { hydrateRoot, createRoot } from "react-dom/client";
-// src/react/context.ts
-import { createContext } from "react";
-var CTX_KEY = /* @__PURE__ */ Symbol.for("weifuwu.react.ServerDataContext");
-function getServerDataContext() {
-  const globalStore = globalThis;
-  if (globalStore[CTX_KEY]) return globalStore[CTX_KEY];
-  const ctx = createContext({});
-  ctx.displayName = "ServerData";
-  globalStore[CTX_KEY] = ctx;
-  return ctx;
-}
-var ServerDataContext = getServerDataContext();
-// src/react/hooks.ts
-import { useContext } from "react";
-function useServerData() {
-  return useContext(ServerDataContext);
-}
-// src/react/client.ts
-function readInitialData() {
-  if (typeof document === "undefined") return {};
-  const el = document.getElementById("__WEIFUWU_DATA__");
-  if (el?.textContent) {
-    try {
-      return JSON.parse(el.textContent);
-    } catch {
-    }
-  }
-  return {};
-}
-async function fetchPageData(url) {
-  const res = await fetch(url);
-  const html = await res.text();
-  const match = html.match(/<script[^>]*id="__WEIFUWU_DATA__"[^>]*>([\s\S]*?)<\/script>/);
-  if (match) {
-    try {
-      return JSON.parse(match[1]);
-    } catch {
-    }
-  }
-  return {};
-}
-function compilePattern(pattern) {
-  const paramNames = [];
-  const regexStr = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/:([^/]+)/g, (_, name) => {
-    paramNames.push(name);
-    return "([^/]+)";
-  });
-  return { regex: new RegExp(`^${regexStr}$`), paramNames };
-}
-function matchRoute(pathname, routes) {
-  for (const route of routes) {
-    const m = pathname.match(route.regex);
-    if (m) {
-      const params = {};
-      route.paramNames.forEach((name, i) => {
-        params[name] = m[i + 1];
-      });
-      return { route, params };
-    }
-  }
-  return null;
-}
-function extractComponent(mod) {
-  if (mod.default && typeof mod.default === "function") return mod.default;
-  for (const val of Object.values(mod)) {
-    if (typeof val === "function") return val;
-  }
-  throw new Error("No component export found in module");
-}
-function hydrate(App, opts) {
-  const container = opts?.container ?? document.getElementById("root");
-  const data = readInitialData();
-  let element = createElement(App);
-  if (opts?.layout) {
-    element = createElement(opts.layout, { children: element });
-  }
-  hydrateRoot(
-    container,
-    createElement(ServerDataContext.Provider, { value: data }, element)
-  );
-}
-var _root = null;
-function renderPage(container, layout, Component, data, isInitial) {
-  let element = createElement(Component);
-  if (layout) {
-    element = createElement(layout, { children: element });
-  }
-  const wrapped = createElement(ServerDataContext.Provider, { value: data }, element);
-  if (isInitial) {
-    _root = hydrateRoot(container, wrapped);
-  } else {
-    if (!_root) _root = createRoot(container);
-    _root.render(wrapped);
-  }
-}
-var _router = null;
-function createBrowserRouter(opts) {
-  if (_router) return _router;
-  const container = opts.container ?? document.getElementById("root");
-  const layout = opts.layout;
-  const routes = Object.entries(opts.routes).map(([pattern, loader]) => {
-    const { regex, paramNames } = compilePattern(pattern);
-    return { pattern, regex, paramNames, loader };
-  });
-  let fallback = null;
-  if (opts.fallback) {
-    const { regex, paramNames } = compilePattern("*");
-    fallback = { pattern: "*", regex, paramNames, loader: opts.fallback };
-  }
-  async function renderPath(pathname, isInitial, data) {
-    const matched = matchRoute(pathname, routes);
-    const route = matched?.route ?? fallback;
-    if (!route) {
-      window.location.href = pathname;
-      return;
-    }
-    try {
-      const mod = await route.loader();
-      const Component = extractComponent(mod);
-      const pageData = data ?? (isInitial ? readInitialData() : await fetchPageData(pathname));
-      renderPage(container, layout, Component, pageData, isInitial);
-    } catch (err) {
-      console.error("[weifuwu] router error:", err);
-      if (fallback && route !== fallback) {
-        try {
-          const fallbackMod = await fallback.loader();
-          const FallbackComponent = extractComponent(fallbackMod);
-          renderPage(container, layout, FallbackComponent, { error: String(err) }, false);
-        } catch {
-          container.innerHTML = "<h1>Something went wrong</h1>";
-        }
-      } else {
-        container.innerHTML = "<h1>Something went wrong</h1>";
-      }
-    }
-  }
-  async function navigate2(url) {
-    const u = new URL(url, window.location.origin);
-    if (u.origin !== window.location.origin || u.pathname === window.location.pathname) {
-      return;
-    }
-    history.pushState({}, "", url);
-    scrollTo(0, 0);
-    await renderPath(u.pathname, false);
-  }
-  window.addEventListener("popstate", () => {
-    renderPath(window.location.pathname, false);
-  });
-  document.addEventListener("click", (e) => {
-    const target = e.target.closest("a");
-    if (!target) return;
-    const href = target.getAttribute("href");
-    if (!href) return;
-    const u = new URL(href, window.location.origin);
-    if (u.origin !== window.location.origin || target.hasAttribute("download") || target.target === "_blank" || target.getAttribute("rel") === "external") return;
-    e.preventDefault();
-    navigate2(href);
-  });
-  const initialData = readInitialData();
-  renderPath(window.location.pathname, true, initialData);
-  _router = { navigate: navigate2, renderPath };
-  return _router;
-}
-function navigate(url) {
-  if (_router) {
-    _router.navigate(url);
-  } else {
-    window.location.href = url;
-  }
-}
-export {
-  createBrowserRouter,
-  hydrate,
-  navigate,
-  useServerData
-};

package/dist/react/compile.d.ts DELETED Viewed

@@ -1,17 +0,0 @@
-/**
- * On-the-fly TSX compilation for ctx.render().
- *
- * Compiles .tsx files with esbuild, caches by source-content hash.
- * Externalizes react/react-dom — the framework's own instance is used.
- * Persisted to disk for fast restarts.
- */
-import type { ComponentType } from 'react';
-export declare function setReactCacheDir(dir: string): void;
-/**
- * Load a .tsx/.ts module, compiling on-the-fly with esbuild.
- * Results are:
- *  1. Cached in memory by source-content hash
- *  2. Persisted to disk ({cacheDir}/{sourceHash}.mjs) for instant restarts
- */
-export declare function loadTsxModule(entryPath: string): Promise<Record<string, unknown>>;
-export declare function loadTsxComponent(entryPath: string): Promise<ComponentType>;

package/dist/react/context.d.ts DELETED Viewed

	@@ -1,2 +0,0 @@
1	- import { type Context } from 'react';
2	- export declare const ServerDataContext: Context<Record<string, unknown>>;

package/dist/react/error-boundary.d.ts DELETED Viewed

@@ -1,30 +0,0 @@
-import { Component, type ReactNode } from 'react';
-interface ErrorBoundaryProps {
-    children: ReactNode;
-    /** Fallback UI rendered when a child component throws. */
-    fallback?: ReactNode;
-    /** Called with the error (client-side only). */
-    onError?: (error: Error) => void;
-}
-interface ErrorBoundaryState {
-    hasError: boolean;
-    error: Error | null;
-}
-/**
- * Catch render errors in child components.
- * Works during SSR (renders fallback) and client-side hydration.
- *
- * @example
- * ```tsx
- * <ErrorBoundary fallback={<p>Something went wrong</p>}>
- *   <RiskyComponent />
- * </ErrorBoundary>
- * ```
- */
-export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    state: ErrorBoundaryState;
-    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error): void;
-    render(): ReactNode;
-}
-export {};

package/dist/react/hooks.d.ts DELETED Viewed

@@ -1,6 +0,0 @@
-/**
- * Access server-loaded data in any component.
- * On the server, reads from the request-scoped ServerDataContext.
- * On the client (after hydration), reads from the same context populated by hydrate().
- */
-export declare function useServerData<T extends Record<string, unknown> = Record<string, unknown>>(): T;

package/dist/react/index.d.ts DELETED Viewed

@@ -1,92 +0,0 @@
-import { type ReactElement, type ComponentType } from 'react';
-import { type Middleware } from '../types.ts';
-import type { Router } from '../core/router.ts';
-import type { ReactOptions, ReactRouterOptions, ReactAppOptions } from './types.ts';
-/**
- * React SSR middleware — injects `ctx.render(path, opts?)`.
- *
- * Options:
- * - `layout`: Wrap every page in a shared layout component (nav, footer, etc.)
- *
- * For Tailwind CSS: use `tailwindDev` middleware.
- * For client bundles: use `esbuildDev` middleware.
- *
- * @example
- * ```ts
- * app.use(tailwindDev({ '/assets/tailwind.css': { entry: './styles/input.css' } }))
- * app.use(esbuildDev({ '/assets/client.js': { entry: './client.ts', ... } }))
- * app.use(react({ layout: './components/PageShell.tsx' }))
- * app.get('/', (_req, ctx) => ctx.render('./pages/HomePage.tsx', {
- *   stylesheets: ['/assets/tailwind.css'],
- *   bootstrapModules: ['/assets/client.js'],
- * }))
- * ```
- */
-/**
- * React SSR middleware — injects `ctx.render(path, opts?)`.
- *
- * **Lightweight mode** (no `pages`): returns middleware for `app.use()`.
- * Use with manual `app.get()` + `ctx.render()`.
- *
- * **Full mode** (has `pages`): returns a plugin for `app.plugin()`.
- * Handles routing, data loading, Tailwind, client bundle, and error pages.
- */
-export declare function react(opts?: ReactOptions): Middleware;
-export declare function react(opts: ReactAppOptions): (app: Router) => void;
-/**
- * Auto-register routes from a shared route config.
- *
- * Use a single routes file shared between server and client to eliminate duplication.
- * Routes with data dependencies use the `loaders` option — request ctx is passed
- * to the loader, which can throw `HttpError` for non-200 status codes.
- *
- * @example
- * ```ts
- * // routes.ts — shared by server and client
- * export const routes = {
- *   '/':        () => import('./pages/Home.tsx'),
- *   '/users':   () => import('./pages/Users.tsx'),
- *   '/users/:id': () => import('./pages/UserDetail.tsx'),
- * }
- *
- * // server.ts
- * import { reactRouter } from 'weifuwu/react'
- * import { routes } from './routes.ts'
- *
- * reactRouter(app, routes, {
- *   layout: './layouts/Root.tsx',
- *   stylesheets: ['/assets/tailwind.css'],
- *   bootstrapModules: ['/assets/client.js'],
- *   loaders: {
- *     '/users': async (ctx) => ({ users: await db.listUsers() }),
- *     '/users/:id': async (ctx) => {
- *       const user = await db.findUser(ctx.params.id)
- *       if (!user) throw new HttpError('Not found', 404)
- *       return { user }
- *     },
- *   },
- * })
- *
- * // client.ts — same routes config, no loaders
- * import { createBrowserRouter } from 'weifuwu/react/client'
- * import { routes } from './routes.ts'
- *
- * createBrowserRouter({ layout: Root, routes })
- * ```
- */
-export declare function reactRouter(app: Router, routes: Record<string, () => Promise<{
-    default: ComponentType;
-}>>, opts?: ReactRouterOptions): void;
-/**
- * Client-side navigation link. Renders as `<a>` on the server.
- * On the client, intercepted by `createBrowserRouter` for SPA navigation.
- */
-export declare function Link({ href, children, ...props }: {
-    href: string;
-    children: React.ReactNode;
-    [key: string]: unknown;
-}): ReactElement;
-export { ErrorBoundary } from './error-boundary.ts';
-export { useServerData } from './hooks.ts';
-export { ServerDataContext } from './context.ts';
-export type { ReactOptions, RenderOptions, ReactRouterOptions, ReactAppOptions } from './types.ts';