pudui 0.0.0

package/dist/hydration-markers-DdjOvH6g.mjs

@@ -0,0 +1,218 @@
+//#region src/core/attributes.ts
+const childlessElementNames = " area base br col embed hr img input link meta param source track wbr ";
+/**
+* Checks whether an HTML element must not render child content.
+*
+* @param name Element tag name.
+* @returns `true` for void HTML elements such as `br`, `img`, and `input`.
+*/
+function isChildlessElement(name) {
+	return childlessElementNames.includes(" " + name + " ");
+}
+/**
+* Reads trusted inner HTML from intrinsic element props.
+*
+* @param props Element props to inspect.
+* @returns Trusted HTML string, or `undefined` when none was provided.
+*/
+function readDangerouslySetInnerHTML(props) {
+	return props.dangerouslySetInnerHTML?.__html;
+}
+/**
+* Converts JSX prop names to DOM attribute names.
+*
+* @param name JSX prop name.
+* @returns Serialized attribute name.
+*/
+function attributeName(name) {
+	return name === "className" ? "class" : name === "htmlFor" ? "for" : name;
+}
+/**
+* Validates a CSS property name before serialization.
+*
+* @param name CSS property name.
+*/
+function validateStyleName(name) {
+	if (name === "" || hasAsciiControl(name) || /[\s:;{}]/u.test(name)) throw new TypeError(`Bad CSS name: ${name}`);
+}
+/**
+* Validates a CSS property value before serialization.
+*
+* @param value CSS property value.
+*/
+function validateStyleValue(value) {
+	if (hasAsciiControl(value) || /[;{}]/u.test(value)) throw new TypeError("Bad CSS value.");
+}
+/**
+* Converts primitive prop values to attribute strings.
+*
+* @param value Value to serialize.
+* @returns Attribute text for primitive values, otherwise `undefined`.
+*/
+function serializeAttributeValue(value) {
+	if (isPrimitiveValue(value)) return String(value);
+}
+/**
+* Checks whether a value renders as primitive text.
+*
+* @param value Value to inspect.
+* @returns `true` for strings, numbers, and bigints.
+*/
+function isPrimitiveValue(value) {
+	const valueType = typeof value;
+	return valueType === "string" || valueType === "number" || valueType === "bigint";
+}
+/**
+* Converts camel-case CSS names to kebab-case.
+*
+* @param value Name to convert.
+* @returns Kebab-case name.
+*/
+function toKebabCase(value) {
+	return value.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
+}
+/**
+* Validates an element or attribute name before serialization.
+*
+* @param name Markup name to validate.
+* @param kind Name kind used in error messages.
+*/
+function validateMarkupName(name, kind) {
+	if (name === "" || hasAsciiControl(name) || /[\s"'<>/=]/u.test(name)) throw new TypeError(`Bad ${kind}: ${name}`);
+}
+function hasAsciiControl(value) {
+	for (let index = 0; index < value.length; index++) {
+		const code = value.charCodeAt(index);
+		if (code <= 31 || code === 127) return true;
+	}
+	return false;
+}
+//#endregion
+//#region src/hydration-markers.ts
+/**
+* Serializes hydration metadata into an HTML comment.
+*
+* @param index Boundary metadata index.
+* @param json JSON metadata payload.
+* @returns HTML comment string.
+*/
+function serializeHydrateMetaComment(index, json) {
+	return `<!--m:${index}:${escapeCommentJson(json)}-->`;
+}
+/**
+* Serializes a hydration boundary start marker.
+*
+* @param index Boundary metadata index.
+* @param json JSON props payload.
+* @returns HTML comment string.
+*/
+function serializeHydrateStartComment(index, json) {
+	return `<!--h:${index}:${escapeCommentJson(json)}-->`;
+}
+/**
+* Serializes a hydration boundary end marker.
+*
+* @returns HTML comment string.
+*/
+function serializeHydrateEndComment() {
+	return "<!--/h-->";
+}
+/**
+* Serializes a raw HTML boundary start marker.
+*
+* @returns HTML comment string.
+*/
+function serializeRawStartComment() {
+	return "<!--r-->";
+}
+/**
+* Serializes a raw HTML boundary end marker.
+*
+* @returns HTML comment string.
+*/
+function serializeRawEndComment() {
+	return "<!--/r-->";
+}
+/**
+* Checks whether comment data is a hydration metadata marker.
+*
+* @param data Comment data.
+* @returns `true` for hydration metadata markers.
+*/
+function isHydrateMetaCommentData(data) {
+	return data.startsWith("m:");
+}
+/**
+* Checks whether comment data starts a hydration boundary.
+*
+* @param data Comment data.
+* @returns `true` for hydration start markers.
+*/
+function isHydrateStartCommentData(data) {
+	return data.startsWith("h:");
+}
+/**
+* Checks whether comment data ends a hydration boundary.
+*
+* @param data Comment data.
+* @returns `true` for hydration end markers.
+*/
+function isHydrateEndCommentData(data) {
+	return data === "/h";
+}
+/**
+* Checks whether comment data starts a raw HTML boundary.
+*
+* @param data Comment data.
+* @returns `true` for raw start markers.
+*/
+function isRawStartCommentData(data) {
+	return data === "r";
+}
+/**
+* Checks whether comment data ends a raw HTML boundary.
+*
+* @param data Comment data.
+* @returns `true` for raw end markers.
+*/
+function isRawEndCommentData(data) {
+	return data === "/r";
+}
+/**
+* Parses hydration metadata comment data.
+*
+* @param data Comment data without `<!--` and `-->`.
+* @returns Parsed metadata, or `undefined` when the data is not a metadata marker.
+*/
+function parseHydrateMetaCommentData(data) {
+	return parseMarker(data, "m:", "v");
+}
+/**
+* Parses hydration boundary start comment data.
+*
+* @param data Comment data without `<!--` and `-->`.
+* @returns Parsed boundary start metadata, or `undefined` when the data is not a start marker.
+*/
+function parseHydrateStartCommentData(data) {
+	return parseMarker(data, "h:", "p");
+}
+function parseMarker(data, prefix, key) {
+	if (!data.startsWith(prefix)) return;
+	const split = data.indexOf(":", prefix.length);
+	if (split < 0) return;
+	const value = JSON.parse(data.slice(split + 1));
+	if (key === "p" && Array.isArray(value) && value.length === 2 && (value[1] === null || typeof value[1] === "string" || typeof value[1] === "number")) return {
+		i: +data.slice(prefix.length, split),
+		k: value[1] ?? void 0,
+		p: value[0]
+	};
+	return {
+		i: +data.slice(prefix.length, split),
+		[key]: value
+	};
+}
+function escapeCommentJson(value) {
+	return value.replaceAll("<", "\\u003c").replaceAll("--", "\\u002d\\u002d");
+}
+//#endregion
+export { serializeAttributeValue as _, isRawStartCommentData as a, validateStyleName as b, serializeHydrateEndComment as c, serializeRawEndComment as d, serializeRawStartComment as f, readDangerouslySetInnerHTML as g, isPrimitiveValue as h, isRawEndCommentData as i, serializeHydrateMetaComment as l, isChildlessElement as m, isHydrateMetaCommentData as n, parseHydrateMetaCommentData as o, attributeName as p, isHydrateStartCommentData as r, parseHydrateStartCommentData as s, isHydrateEndCommentData as t, serializeHydrateStartComment as u, toKebabCase as v, validateStyleValue as x, validateMarkupName as y };

package/dist/index.d.mts

@@ -0,0 +1,109 @@
+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, g as PreloadMetadata, 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/client.d.ts
+/**
+ * Event listener callback type used by browser integrations.
+ */
+type EventHandler<EventType extends Event = Event> = (event: EventType) => void;
+/**
+ * Resolves the DOM event type associated with an event name.
+ *
+ * Known HTML, SVG, MathML, document, and window event names resolve to their
+ * matching event object type. Unknown names fall back to `Event`.
+ */
+type EventForName<Name extends string> = Name extends keyof HTMLElementEventMap ? HTMLElementEventMap[Name] : Name extends keyof SVGElementEventMap ? SVGElementEventMap[Name] : Name extends keyof MathMLElementEventMap ? MathMLElementEventMap[Name] : Name extends keyof DocumentEventMap ? DocumentEventMap[Name] : Name extends keyof WindowEventMap ? WindowEventMap[Name] : Event;
+/**
+ * Loads a component factory for a server-rendered hydration boundary.
+ *
+ * The `meta` value is generated by the `hydrate()` macro transform and is
+ * usually consumed by `pudui/vite-runtime`.
+ */
+type HydrateLoad = (meta: unknown) => ComponentFactory | Promise<ComponentFactory>;
+/**
+ * Options for hydrating server-rendered Pudui markup in the browser.
+ */
+type HydrateOptions = {
+  /**
+   * Resolves the component factory for a hydration boundary.
+   */
+  load: HydrateLoad;
+};
+/**
+ * A mounted browser root returned by {@link render} or {@link hydrate}.
+ */
+type HydrationRoot = {
+  /**
+   * Replaces the root child and patches the DOM.
+   *
+   * @param child Next child tree to render.
+   */
+  rerender(child: Child): void;
+  /**
+   * Removes rendered content and releases component subscriptions and refs.
+   */
+  unmount(): void;
+};
+/**
+ * Creates a ref that wires a DOM event listener to an element.
+ *
+ * Each time the event fires, the previous handler invocation for that element
+ * is aborted and the new invocation receives a fresh `AbortSignal`. This makes
+ * async event handlers straightforward to cancel during rapid input.
+ *
+ * @param type DOM event name to listen for.
+ * @param handler Callback invoked for each event with a cancellation signal.
+ * @param options Options passed to `addEventListener`.
+ * @returns A ref callback that installs and removes the listener.
+ *
+ * @example
+ * ```tsx
+ * <button
+ *   ref={event("click", async (_event, signal) => {
+ *     await save({ signal });
+ *   })}
+ * >
+ *   Save
+ * </button>
+ * ```
+ */
+declare function event<Name extends string>(type: Name, handler: (event: EventForName<Name>, signal: AbortSignal) => void, options?: boolean | AddEventListenerOptions): RefCallback;
+/**
+ * Mounts a child tree into a DOM container.
+ *
+ * The container's existing children are replaced on the initial render. Later
+ * calls to `rerender()` patch the DOM in place when possible.
+ *
+ * @param child Child tree to render.
+ * @param container DOM element or fragment to own.
+ * @returns A root controller for rerendering or unmounting.
+ *
+ * @example
+ * ```tsx
+ * import { render } from "pudui";
+ *
+ * const root = render(<main>Hello</main>, document.body);
+ * root.rerender(<main>Updated</main>);
+ * ```
+ */
+declare function render(child: Child, container: Element | DocumentFragment): HydrationRoot;
+/**
+ * Hydrates server-rendered Pudui boundaries in a document or element.
+ *
+ * The root scans for hydration comments emitted by `renderToString()` and uses
+ * `options.load` to import component factories when a boundary becomes active.
+ *
+ * @param root Document, element, or fragment containing server-rendered markup.
+ * @param options Hydration loader options.
+ * @returns A root controller for rerendering or unmounting.
+ *
+ * @example
+ * ```tsx
+ * import { hydrate } from "pudui";
+ * import { load } from "pudui/vite-runtime";
+ *
+ * hydrate(document, { load });
+ * ```
+ */
+declare function hydrate(root: Document | DocumentFragment | Element, options: HydrateOptions): HydrationRoot;
+//#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, type EventForName, type EventHandler, Fragment, type HydrateLoad, type HydrateOptions, type HydrationRoot, type IntrinsicElementProps, type IntrinsicElementsByTagName, type Key, type MountCallback, type PreloadMetadata, type PreloadResolver, type PrimitiveChild, Raw, type RawChild, type RawProps, type RefCallback, type RefCleanup, type RefValue, type RenderableType, type StyleValue, type UpdateCallback, type VNode, createElement, event, hydrate, isComponent, isVNode, jsx, jsx as jsxs, jsxDEV, render };