pudui 0.0.0

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

@@ -0,0 +1,36 @@
+import { A as Fragment, F as jsxDEV, c as ComponentPropsFor, f as IntrinsicElementProps, n as Child, p as IntrinsicElementsByTagName } from "./core-Cypb6mR9.mjs";
+
+//#region src/jsx-dev-runtime.d.ts
+/**
+ * JSX types for the development Pudui JSX runtime.
+ */
+declare namespace JSX {
+  /**
+   * Any value that can be returned from JSX.
+   */
+  type Element = Child;
+  /**
+   * Configures JSX children to use the `children` prop.
+   */
+  interface ElementChildrenAttribute {
+    children: unknown;
+  }
+  /**
+   * Props available on every JSX element.
+   */
+  interface IntrinsicAttributes {
+    key?: string | number;
+  }
+  /**
+   * Infers component props for JSX tags.
+   */
+  type LibraryManagedAttributes<ComponentType, Props> = ComponentPropsFor<ComponentType, Props>;
+  /**
+   * Built-in element props for HTML, SVG, MathML, and custom elements.
+   */
+  interface IntrinsicElements extends IntrinsicElementsByTagName {
+    [elementName: string]: IntrinsicElementProps<any>;
+  }
+}
+//#endregion
+export { Fragment, JSX, jsxDEV };

package/dist/jsx-dev-runtime.mjs

@@ -0,0 +1,2 @@
+import { c as jsxDEV, t as Fragment } from "./vnode-Lr-Tpypk.mjs";
+export { Fragment, jsxDEV };

package/dist/jsx-runtime.d.mts

@@ -0,0 +1,36 @@
+import { A as Fragment, P as jsx, c as ComponentPropsFor, f as IntrinsicElementProps, n as Child, p as IntrinsicElementsByTagName } from "./core-Cypb6mR9.mjs";
+
+//#region src/jsx-runtime.d.ts
+/**
+ * JSX types for the automatic Pudui JSX runtime.
+ */
+declare namespace JSX {
+  /**
+   * Any value that can be returned from JSX.
+   */
+  type Element = Child;
+  /**
+   * Configures JSX children to use the `children` prop.
+   */
+  interface ElementChildrenAttribute {
+    children: unknown;
+  }
+  /**
+   * Props available on every JSX element.
+   */
+  interface IntrinsicAttributes {
+    key?: string | number;
+  }
+  /**
+   * Infers component props for JSX tags.
+   */
+  type LibraryManagedAttributes<ComponentType, Props> = ComponentPropsFor<ComponentType, Props>;
+  /**
+   * Built-in element props for HTML, SVG, MathML, and custom elements.
+   */
+  interface IntrinsicElements extends IntrinsicElementsByTagName {
+    [elementName: string]: IntrinsicElementProps<any>;
+  }
+}
+//#endregion
+export { Fragment, JSX, jsx, jsx as jsxs };

package/dist/jsx-runtime.mjs

@@ -0,0 +1,2 @@
+import { s as jsx, t as Fragment } from "./vnode-Lr-Tpypk.mjs";
+export { Fragment, jsx, jsx as jsxs };

package/dist/macros.d.mts

@@ -0,0 +1,43 @@
+//#region src/macros.d.ts
+/**
+ * Marks a component as a browser-hydrated boundary.
+ *
+ * This function is a compile-time macro. It must be called from a component's
+ * `hydrate` option and requires the Pudui Vite plugin to replace it during
+ * development and builds.
+ *
+ * @returns This macro never returns at runtime because it is replaced by the Vite plugin.
+ *
+ * @example
+ * ```tsx
+ * import { Component } from "pudui";
+ * import { hydrate } from "pudui/macros";
+ *
+ * export function SearchBox() {
+ *   return new Component({
+ *     hydrate: hydrate(),
+ *     render: () => <input type="search" />,
+ *   });
+ * }
+ * ```
+ */
+declare function hydrate(): never;
+/**
+ * Returns the browser entry metadata for the current server module.
+ *
+ * This function is a compile-time macro. It requires the Pudui Vite plugin and
+ * is primarily used by framework integrations that need to emit the browser
+ * entry, dependency module URLs, and stylesheet URLs for the current route.
+ *
+ * @returns A tuple of browser entry URL, dependency URLs, and stylesheet URLs after transformation.
+ *
+ * @example
+ * ```tsx
+ * import { entry } from "pudui/macros";
+ *
+ * const [entryUrl, dependencies, styles] = entry();
+ * ```
+ */
+declare function entry(): readonly [entry: string, dependencies: string[], styles: string[]];
+//#endregion
+export { entry, hydrate };

package/dist/macros.mjs

@@ -0,0 +1,47 @@
+//#region src/macros.ts
+/**
+* Marks a component as a browser-hydrated boundary.
+*
+* This function is a compile-time macro. It must be called from a component's
+* `hydrate` option and requires the Pudui Vite plugin to replace it during
+* development and builds.
+*
+* @returns This macro never returns at runtime because it is replaced by the Vite plugin.
+*
+* @example
+* ```tsx
+* import { Component } from "pudui";
+* import { hydrate } from "pudui/macros";
+*
+* export function SearchBox() {
+*   return new Component({
+*     hydrate: hydrate(),
+*     render: () => <input type="search" />,
+*   });
+* }
+* ```
+*/
+function hydrate() {
+	throw new Error("hydrate() requires vite plugin.");
+}
+/**
+* Returns the browser entry metadata for the current server module.
+*
+* This function is a compile-time macro. It requires the Pudui Vite plugin and
+* is primarily used by framework integrations that need to emit the browser
+* entry, dependency module URLs, and stylesheet URLs for the current route.
+*
+* @returns A tuple of browser entry URL, dependency URLs, and stylesheet URLs after transformation.
+*
+* @example
+* ```tsx
+* import { entry } from "pudui/macros";
+*
+* const [entryUrl, dependencies, styles] = entry();
+* ```
+*/
+function entry() {
+	throw new Error("entry() requires vite plugin.");
+}
+//#endregion
+export { entry, hydrate };

package/dist/server.d.mts

@@ -0,0 +1,55 @@
+import { A as Fragment, C as RefValue, D as VNode, E as UpdateCallback, F as jsxDEV, M as createElement, N as isVNode, O as Component, P as jsx, S as RefCleanup, T as StyleValue, _ as PreloadResolver, a as ComponentFactoryWithoutProps, b as RawProps, c as ComponentPropsFor, d as EmptyChild, f as IntrinsicElementProps, h as MountCallback, i as ComponentFactoryWithProps, j as Raw, k as isComponent, l as DangerouslySetInnerHTML, m as Key, n as Child, o as ComponentInstance, p as IntrinsicElementsByTagName, r as ComponentFactory, s as ComponentOptions, t as AnyProps, u as ElementType, v as PrimitiveChild, w as RenderableType, x as RefCallback, y as RawChild } from "./core-Cypb6mR9.mjs";
+
+//#region src/server.d.ts
+/**
+ * Options for rendering Pudui children to an HTML string.
+ */
+type RenderToStringOptions = {
+  /**
+   * Resolves hydration metadata into module and style preload links.
+   */
+  preload?: PreloadResolver;
+  /**
+   * Props to apply when rendering an existing component instance.
+   */
+  props?: AnyProps;
+};
+/**
+ * Renders a Pudui child tree to an HTML string.
+ *
+ * Synchronous components are rendered immediately. Use
+ * {@link renderToStringAsync} when component render functions may return async
+ * children that need to be awaited by user code before rendering.
+ *
+ * @param child Child tree or component instance to render.
+ * @param propsOrOptions Props for a component instance, or render options.
+ * @returns Escaped HTML for the child tree.
+ *
+ * @example
+ * ```tsx
+ * import { renderToString } from "pudui/server";
+ *
+ * const html = renderToString(<main class="page">Hello</main>);
+ * ```
+ */
+declare function renderToString(child: Child, propsOrOptions?: AnyProps | RenderToStringOptions): string;
+/**
+ * Renders a Pudui child tree to an HTML string while awaiting async work.
+ *
+ * This has the same output shape as {@link renderToString}, but awaits async
+ * component rendering paths before returning the final HTML.
+ *
+ * @param child Child tree or component instance to render.
+ * @param propsOrOptions Props for a component instance, or render options.
+ * @returns Escaped HTML for the child tree.
+ *
+ * @example
+ * ```tsx
+ * import { renderToStringAsync } from "pudui/server";
+ *
+ * const html = await renderToStringAsync(<Document url={request.url} />);
+ * ```
+ */
+declare function renderToStringAsync(child: Child, propsOrOptions?: AnyProps | RenderToStringOptions): Promise<string>;
+//#endregion
+export { type AnyProps, type Child, Component, type ComponentFactory, type ComponentFactoryWithProps, type ComponentFactoryWithoutProps, type ComponentInstance, type ComponentOptions, type ComponentPropsFor, type DangerouslySetInnerHTML, type ElementType, type EmptyChild, Fragment, type IntrinsicElementProps, type IntrinsicElementsByTagName, type Key, type MountCallback, type PrimitiveChild, Raw, type RawChild, type RawProps, type RefCallback, type RefCleanup, type RefValue, RenderToStringOptions, type RenderableType, type StyleValue, type UpdateCallback, type VNode, createElement, isComponent, isVNode, jsx, jsx as jsxs, jsxDEV, renderToString, renderToStringAsync };

package/dist/server.mjs

@@ -0,0 +1,223 @@
+import { a as isHostVNode, c as jsxDEV, d as normalizeChildren, f as readRawChildHtml, i as isComponentVNode, n as Raw, o as isVNode, r as createElement, s as jsx, t as Fragment, u as isRawChild } from "./vnode-Lr-Tpypk.mjs";
+import { _ as serializeAttributeValue, b as validateStyleName, c as serializeHydrateEndComment, d as serializeRawEndComment, f as serializeRawStartComment, g as readDangerouslySetInnerHTML, l as serializeHydrateMetaComment, m as isChildlessElement, p as attributeName, u as serializeHydrateStartComment, v as toKebabCase, x as validateStyleValue, y as validateMarkupName } from "./hydration-markers-DdjOvH6g.mjs";
+import { a as isComponent, c as readComponentProps, d as resolveComponent, f as setComponentProps, i as finishComponentRender, l as renderComponentErrorOutput, n as beginComponentRender, s as readComponentHydrateMeta, t as Component, u as renderComponentOutput } from "./component-D3kwgmef.mjs";
+//#region src/server.ts
+/**
+* Renders a Pudui child tree to an HTML string.
+*
+* Synchronous components are rendered immediately. Use
+* {@link renderToStringAsync} when component render functions may return async
+* children that need to be awaited by user code before rendering.
+*
+* @param child Child tree or component instance to render.
+* @param propsOrOptions Props for a component instance, or render options.
+* @returns Escaped HTML for the child tree.
+*
+* @example
+* ```tsx
+* import { renderToString } from "pudui/server";
+*
+* const html = renderToString(<main class="page">Hello</main>);
+* ```
+*/
+function renderToString(child, propsOrOptions) {
+	const options = renderToStringOptions(child, propsOrOptions);
+	const props = options === propsOrOptions ? options.props : propsOrOptions;
+	if (isComponent(child) && props !== void 0) setComponentProps(child, props);
+	return childToString(child, void 0, createRenderToStringContext(options));
+}
+/**
+* Renders a Pudui child tree to an HTML string while awaiting async work.
+*
+* This has the same output shape as {@link renderToString}, but awaits async
+* component rendering paths before returning the final HTML.
+*
+* @param child Child tree or component instance to render.
+* @param propsOrOptions Props for a component instance, or render options.
+* @returns Escaped HTML for the child tree.
+*
+* @example
+* ```tsx
+* import { renderToStringAsync } from "pudui/server";
+*
+* const html = await renderToStringAsync(<Document url={request.url} />);
+* ```
+*/
+async function renderToStringAsync(child, propsOrOptions) {
+	const options = renderToStringOptions(child, propsOrOptions);
+	const props = options === propsOrOptions ? options.props : propsOrOptions;
+	if (isComponent(child) && props !== void 0) setComponentProps(child, props);
+	return childToStringAsync(child, void 0, createRenderToStringContext(options));
+}
+function renderToStringOptions(child, propsOrOptions) {
+	if (propsOrOptions !== void 0 && (!isComponent(child) || "props" in propsOrOptions) && ("preload" in propsOrOptions || "props" in propsOrOptions)) return propsOrOptions;
+	return {};
+}
+function createRenderToStringContext(options) {
+	return {
+		emittedHydrateMetaIds: /* @__PURE__ */ new Set(),
+		emittedModulePreloads: /* @__PURE__ */ new Set(),
+		emittedStylePreloads: /* @__PURE__ */ new Set(),
+		hydrateMetaIds: /* @__PURE__ */ new Map(),
+		nextHydrateId: 1,
+		preload: options.preload
+	};
+}
+function childToString(child, owner, context, key) {
+	if (child === false || child === true || child === null || child === void 0) return "";
+	if (typeof child === "string" || typeof child === "number" || typeof child === "bigint") return escapeText(String(child));
+	if (isRawChild(child)) return rawToString(child);
+	if (Array.isArray(child)) return normalizeChildren(child).map((nestedChild) => childToString(nestedChild, owner, context)).join("");
+	if (isComponent(child)) {
+		beginComponentRender(child);
+		try {
+			let renderedChild;
+			try {
+				renderedChild = childToString(renderComponentOutput(child), child, context);
+			} catch (reason) {
+				beginComponentRender(child);
+				renderedChild = childToString(renderComponentErrorOutput(child, reason), child, context);
+			}
+			return wrapHydratedComponent(child, renderedChild, context, key);
+		} finally {
+			finishComponentRender(child);
+		}
+	}
+	if (isVNode(child)) {
+		if (isComponentVNode(child)) return childToString(resolveComponent(child, owner), owner, context, child.key);
+		if (isHostVNode(child)) return elementToString(child, owner, context);
+	}
+	return "";
+}
+async function childToStringAsync(child, owner, context, key) {
+	if (child === false || child === true || child === null || child === void 0) return "";
+	if (typeof child === "string" || typeof child === "number" || typeof child === "bigint") return escapeText(String(child));
+	if (isRawChild(child)) return rawToString(child);
+	if (Array.isArray(child)) {
+		const renderedChildren = [];
+		for (const nestedChild of normalizeChildren(child)) renderedChildren.push(await childToStringAsync(nestedChild, owner, context));
+		return renderedChildren.join("");
+	}
+	if (isComponent(child)) {
+		beginComponentRender(child);
+		try {
+			let renderedChild;
+			try {
+				renderedChild = await childToStringAsync(renderComponentOutput(child), child, context);
+			} catch (reason) {
+				beginComponentRender(child);
+				renderedChild = await childToStringAsync(renderComponentErrorOutput(child, reason), child, context);
+			}
+			return wrapHydratedComponent(child, renderedChild, context, key);
+		} finally {
+			finishComponentRender(child);
+		}
+	}
+	if (isVNode(child)) {
+		if (isComponentVNode(child)) return childToStringAsync(resolveComponent(child, owner), owner, context, child.key);
+		if (isHostVNode(child)) return elementToStringAsync(child, owner, context);
+	}
+	return "";
+}
+function rawToString(raw) {
+	return `${serializeRawStartComment()}${readRawChildHtml(raw)}${serializeRawEndComment()}`;
+}
+function wrapHydratedComponent(component, renderedChild, context, key) {
+	const hydrateMeta = readComponentHydrateMeta(component);
+	if (hydrateMeta === void 0) return renderedChild;
+	const hydrateMetaJson = serializeHydrateJson(hydrateMeta);
+	let id = context.hydrateMetaIds.get(hydrateMetaJson);
+	if (id === void 0) {
+		id = context.nextHydrateId++;
+		context.hydrateMetaIds.set(hydrateMetaJson, id);
+	}
+	let output = "";
+	output += preloadsToString(hydrateMeta, context);
+	if (!context.emittedHydrateMetaIds.has(id)) {
+		context.emittedHydrateMetaIds.add(id);
+		output += serializeHydrateMetaComment(id, hydrateMetaJson);
+	}
+	const props = readComponentProps(component);
+	const propsJson = serializeHydrateJson(key === void 0 ? props : [props, key], { skipChildren: true });
+	return `${output}${serializeHydrateStartComment(id, propsJson)}${renderedChild}${serializeHydrateEndComment()}`;
+}
+function preloadsToString(meta, context) {
+	const preload = context.preload?.(meta);
+	if (preload === void 0 || preload === null) return "";
+	let output = "";
+	for (const href of preload.modulePreloads ?? []) {
+		if (context.emittedModulePreloads.has(href)) continue;
+		context.emittedModulePreloads.add(href);
+		output += `<link rel="modulepreload" href="${escapeAttribute(href)}">`;
+	}
+	for (const href of preload.stylePreloads ?? []) {
+		if (context.emittedStylePreloads.has(href)) continue;
+		context.emittedStylePreloads.add(href);
+		output += `<link rel="stylesheet" href="${escapeAttribute(href)}">`;
+	}
+	return output;
+}
+function elementToString(vnode, owner, context) {
+	const tagName = vnode.type;
+	const attributes = propsToAttributes(vnode.props);
+	if (isChildlessElement(tagName)) return `<${tagName}${attributes}>`;
+	return `<${tagName}${attributes}>${readDangerouslySetInnerHTML(vnode.props) ?? childToString(vnode.props.children, owner, context)}</${tagName}>`;
+}
+async function elementToStringAsync(vnode, owner, context) {
+	const tagName = vnode.type;
+	const attributes = propsToAttributes(vnode.props);
+	if (isChildlessElement(tagName)) return `<${tagName}${attributes}>`;
+	return `<${tagName}${attributes}>${readDangerouslySetInnerHTML(vnode.props) ?? await childToStringAsync(vnode.props.children, owner, context)}</${tagName}>`;
+}
+function serializeHydrateJson(value, options) {
+	const json = JSON.stringify(value, (key, nestedValue) => {
+		if (options?.skipChildren && key === "children" || key === "key" || key === "ref" || key.startsWith("on") || typeof nestedValue === "function" || typeof nestedValue === "symbol" || typeof nestedValue === "undefined") return;
+		if (typeof nestedValue === "bigint") return String(nestedValue);
+		return nestedValue;
+	});
+	if (json === void 0) throw new TypeError("Hydration values must be JSON serializable.");
+	return json;
+}
+function propsToAttributes(props) {
+	let attributes = "";
+	for (const [rawName, value] of Object.entries(props)) {
+		if (shouldSkipAttribute(rawName, value)) continue;
+		const name = attributeName(rawName);
+		validateMarkupName(name, "attribute");
+		if (name === "style") {
+			const serializedStyle = serializeStyle(value);
+			if (serializedStyle) attributes += ` style="${escapeAttribute(serializedStyle)}"`;
+			continue;
+		}
+		if (value === true) attributes += ` ${name}`;
+		else {
+			const attributeValue = serializeAttributeValue(value);
+			if (attributeValue !== void 0) attributes += ` ${name}="${escapeAttribute(attributeValue)}"`;
+		}
+	}
+	return attributes;
+}
+function shouldSkipAttribute(name, value) {
+	return name === "children" || name === "dangerouslySetInnerHTML" || name === "key" || name === "ref" || name.startsWith("on") || value === false || value === null || value === void 0;
+}
+function serializeStyle(style) {
+	if (!isStyleObject(style)) throw new TypeError("Style prop must be an object.");
+	return Object.entries(style).filter((entry) => entry[1] !== null && entry[1] !== void 0 && entry[1] !== "").map(([name, value]) => {
+		const propertyName = toKebabCase(name);
+		const propertyValue = String(value);
+		validateStyleName(propertyName);
+		validateStyleValue(propertyValue);
+		return `${propertyName}: ${propertyValue}`;
+	}).join("; ");
+}
+function isStyleObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function escapeText(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeAttribute(value) {
+	return escapeText(value).replaceAll("\"", "&quot;");
+}
+//#endregion
+export { Component, Fragment, Raw, createElement, isComponent, isVNode, jsx, jsx as jsxs, jsxDEV, renderToString, renderToStringAsync };