weifuwu 0.33.4 → 0.33.6

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

@@ -13,13 +13,338 @@ import type { WfuiContext } from './types.ts';
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tag: string]: any;
+            div: HtmlDiv;
+            span: HtmlSpan;
+            p: HtmlP;
+            h1: HtmlH1;
+            h2: HtmlH2;
+            h3: HtmlH3;
+            h4: HtmlH4;
+            h5: HtmlH5;
+            h6: HtmlH6;
+            header: HtmlHeader;
+            footer: HtmlFooter;
+            nav: HtmlNav;
+            main: HtmlMain;
+            section: HtmlSection;
+            article: HtmlArticle;
+            aside: HtmlAside;
+            pre: HtmlPre;
+            blockquote: HtmlBlockquote;
+            figure: HtmlFigure;
+            address: HtmlAddress;
+            ul: HtmlUl;
+            ol: HtmlOl;
+            li: HtmlLi;
+            dl: HtmlDl;
+            dt: HtmlDt;
+            dd: HtmlDd;
+            table: HtmlTable;
+            thead: HtmlThead;
+            tbody: HtmlTbody;
+            tr: HtmlTr;
+            th: HtmlTh;
+            td: HtmlTd;
+            form: HtmlForm;
+            input: HtmlInput;
+            button: HtmlButton;
+            select: HtmlSelect;
+            option: HtmlOption;
+            textarea: HtmlTextarea;
+            label: HtmlLabel;
+            fieldset: HtmlFieldset;
+            legend: HtmlLegend;
+            img: HtmlImg;
+            video: HtmlVideo;
+            audio: HtmlAudio;
+            canvas: HtmlCanvas;
+            svg: HtmlSvg;
+            a: HtmlA;
+            link: HtmlLink;
+            strong: HtmlStrong;
+            em: HtmlEm;
+            b: HtmlB;
+            i: HtmlI;
+            u: HtmlU;
+            s: HtmlS;
+            mark: HtmlMark;
+            code: HtmlCode;
+            small: HtmlSmall;
+            sub: HtmlSub;
+            sup: HtmlSup;
+            abbr: HtmlAbbr;
+            time: HtmlTime;
+            br: HtmlBr;
+            hr: HtmlHr;
+            wbr: HtmlWbr;
+            style: HtmlStyle;
+            script: HtmlScript;
+            template: HtmlTemplate;
+            slot: HtmlSlot;
+            details: HtmlDetails;
+            summary: HtmlSummary;
+            dialog: HtmlDialog;
+            iframe: HtmlIframe;
         }
+        interface WfuiAttributes<T> {
+            class?: string | Signal<string>;
+            className?: string | Signal<string>;
+            id?: string;
+            style?: Record<string, string | undefined>;
+            title?: string;
+            lang?: string;
+            dir?: string;
+            hidden?: boolean | Signal<boolean>;
+            tabindex?: number;
+            accesskey?: string;
+            draggable?: boolean;
+            contenteditable?: boolean;
+            slot?: string;
+            spellcheck?: boolean;
+            ref?: (el: T) => void;
+            onClick?: (e: MouseEvent) => void;
+            onDblClick?: (e: MouseEvent) => void;
+            onMouseDown?: (e: MouseEvent) => void;
+            onMouseUp?: (e: MouseEvent) => void;
+            onMouseMove?: (e: MouseEvent) => void;
+            onMouseEnter?: (e: MouseEvent) => void;
+            onMouseLeave?: (e: MouseEvent) => void;
+            onKeyDown?: (e: KeyboardEvent) => void;
+            onKeyUp?: (e: KeyboardEvent) => void;
+            onKeyPress?: (e: KeyboardEvent) => void;
+            onFocus?: (e: FocusEvent) => void;
+            onBlur?: (e: FocusEvent) => void;
+            onInput?: (e: Event) => void;
+            onChange?: (e: Event) => void;
+            onSubmit?: (e: Event) => void;
+            onScroll?: (e: Event) => void;
+            onWheel?: (e: WheelEvent) => void;
+            onTouchStart?: (e: TouchEvent) => void;
+            onTouchEnd?: (e: TouchEvent) => void;
+            onTouchMove?: (e: TouchEvent) => void;
+            onLoad?: (e: Event) => void;
+            onError?: (e: Event) => void;
+            onAnimationEnd?: (e: AnimationEvent) => void;
+            onTransitionEnd?: (e: TransitionEvent) => void;
+            [data: string]: unknown;
+        }
+        type HtmlDiv = WfuiAttributes<HTMLDivElement>;
+        type HtmlSpan = WfuiAttributes<HTMLSpanElement>;
+        type HtmlP = WfuiAttributes<HTMLParagraphElement>;
+        type HtmlH1 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlH2 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlH3 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlH4 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlH5 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlH6 = WfuiAttributes<HTMLHeadingElement>;
+        type HtmlHeader = WfuiAttributes<HTMLElement>;
+        type HtmlFooter = WfuiAttributes<HTMLElement>;
+        type HtmlNav = WfuiAttributes<HTMLElement>;
+        type HtmlMain = WfuiAttributes<HTMLElement>;
+        type HtmlSection = WfuiAttributes<HTMLElement>;
+        type HtmlArticle = WfuiAttributes<HTMLElement>;
+        type HtmlAside = WfuiAttributes<HTMLElement>;
+        type HtmlPre = WfuiAttributes<HTMLPreElement>;
+        type HtmlBlockquote = WfuiAttributes<HTMLQuoteElement>;
+        type HtmlFigure = WfuiAttributes<HTMLElement>;
+        type HtmlAddress = WfuiAttributes<HTMLElement>;
+        type HtmlUl = WfuiAttributes<HTMLUListElement>;
+        type HtmlOl = WfuiAttributes<HTMLOListElement>;
+        type HtmlLi = WfuiAttributes<HTMLLIElement>;
+        type HtmlDl = WfuiAttributes<HTMLDListElement>;
+        type HtmlDt = WfuiAttributes<HTMLElement>;
+        type HtmlDd = WfuiAttributes<HTMLElement>;
+        type HtmlTable = WfuiAttributes<HTMLTableElement>;
+        type HtmlThead = WfuiAttributes<HTMLTableSectionElement>;
+        type HtmlTbody = WfuiAttributes<HTMLTableSectionElement>;
+        type HtmlTr = WfuiAttributes<HTMLTableRowElement>;
+        type HtmlTh = WfuiAttributes<HTMLTableCellElement>;
+        type HtmlTd = WfuiAttributes<HTMLTableCellElement>;
+        interface HtmlForm extends WfuiAttributes<HTMLFormElement> {
+            action?: string;
+            method?: string;
+            enctype?: string;
+            novalidate?: boolean;
+            target?: string;
+        }
+        interface HtmlInput extends WfuiAttributes<HTMLInputElement> {
+            type?: string;
+            value?: string | Signal<string>;
+            placeholder?: string;
+            checked?: boolean | Signal<boolean>;
+            disabled?: boolean | Signal<boolean>;
+            readonly?: boolean;
+            required?: boolean;
+            autofocus?: boolean;
+            autocomplete?: string;
+            name?: string;
+            min?: string | number;
+            max?: string | number;
+            step?: number;
+            pattern?: string;
+            accept?: string;
+            multiple?: boolean;
+            src?: string;
+            alt?: string;
+        }
+        interface HtmlButton extends WfuiAttributes<HTMLButtonElement> {
+            type?: 'button' | 'submit' | 'reset';
+            disabled?: boolean | Signal<boolean>;
+            name?: string;
+            value?: string;
+        }
+        interface HtmlSelect extends WfuiAttributes<HTMLSelectElement> {
+            value?: string | Signal<string>;
+            disabled?: boolean;
+            name?: string;
+            required?: boolean;
+            multiple?: boolean;
+        }
+        interface HtmlOption extends WfuiAttributes<HTMLOptionElement> {
+            value?: string;
+            selected?: boolean;
+            disabled?: boolean;
+            label?: string;
+        }
+        interface HtmlTextarea extends WfuiAttributes<HTMLTextAreaElement> {
+            value?: string | Signal<string>;
+            placeholder?: string;
+            disabled?: boolean;
+            readonly?: boolean;
+            required?: boolean;
+            rows?: number;
+            cols?: number;
+            autofocus?: boolean;
+            name?: string;
+        }
+        interface HtmlLabel extends WfuiAttributes<HTMLLabelElement> {
+            htmlFor?: string;
+        }
+        interface HtmlFieldset extends WfuiAttributes<HTMLFieldSetElement> {
+            disabled?: boolean;
+            name?: string;
+        }
+        type HtmlLegend = WfuiAttributes<HTMLLegendElement>;
+        interface HtmlA extends WfuiAttributes<HTMLAnchorElement> {
+            href?: string;
+            target?: string;
+            rel?: string;
+            download?: string;
+        }
+        interface HtmlImg extends WfuiAttributes<HTMLImageElement> {
+            src?: string | Signal<string>;
+            alt?: string;
+            width?: number | string;
+            height?: number | string;
+            loading?: 'lazy' | 'eager';
+            srcset?: string;
+            sizes?: string;
+        }
+        interface HtmlVideo extends WfuiAttributes<HTMLVideoElement> {
+            src?: string;
+            controls?: boolean;
+            autoplay?: boolean;
+            loop?: boolean;
+            muted?: boolean;
+            poster?: string;
+            width?: number | string;
+            height?: number | string;
+        }
+        interface HtmlAudio extends WfuiAttributes<HTMLAudioElement> {
+            src?: string;
+            controls?: boolean;
+            autoplay?: boolean;
+            loop?: boolean;
+            muted?: boolean;
+        }
+        type HtmlCanvas = WfuiAttributes<HTMLCanvasElement> & {
+            width?: number;
+            height?: number;
+        };
+        type HtmlSvg = WfuiAttributes<SVGSVGElement> & {
+            viewBox?: string;
+            xmlns?: string;
+            fill?: string;
+            width?: string | number;
+            height?: string | number;
+        };
+        interface HtmlLink extends WfuiAttributes<HTMLLinkElement> {
+            rel?: string;
+            href?: string;
+            type?: string;
+            media?: string;
+        }
+        interface HtmlStyle extends WfuiAttributes<HTMLStyleElement> {
+            scoped?: boolean;
+            media?: string;
+        }
+        interface HtmlScript extends WfuiAttributes<HTMLScriptElement> {
+            src?: string;
+            type?: string;
+            async?: boolean;
+            defer?: boolean;
+        }
+        type HtmlStrong = WfuiAttributes<HTMLElement>;
+        type HtmlEm = WfuiAttributes<HTMLElement>;
+        type HtmlB = WfuiAttributes<HTMLElement>;
+        type HtmlI = WfuiAttributes<HTMLElement>;
+        type HtmlU = WfuiAttributes<HTMLElement>;
+        type HtmlS = WfuiAttributes<HTMLElement>;
+        type HtmlMark = WfuiAttributes<HTMLElement>;
+        type HtmlCode = WfuiAttributes<HTMLElement>;
+        type HtmlSmall = WfuiAttributes<HTMLElement>;
+        type HtmlSub = WfuiAttributes<HTMLElement>;
+        type HtmlSup = WfuiAttributes<HTMLElement>;
+        type HtmlAbbr = WfuiAttributes<HTMLElement>;
+        type HtmlTime = WfuiAttributes<HTMLElement> & {
+            datetime?: string;
+        };
+        type HtmlBr = WfuiAttributes<HTMLBRElement>;
+        type HtmlHr = WfuiAttributes<HTMLHRElement>;
+        type HtmlWbr = WfuiAttributes<HTMLElement>;
+        type HtmlTemplate = WfuiAttributes<HTMLTemplateElement>;
+        type HtmlSlot = WfuiAttributes<HTMLSlotElement>;
+        type HtmlDetails = WfuiAttributes<HTMLDetailsElement>;
+        type HtmlSummary = WfuiAttributes<HTMLElement>;
+        type HtmlDialog = WfuiAttributes<HTMLDialogElement>;
+        type HtmlIframe = WfuiAttributes<HTMLIFrameElement> & {
+            src?: string;
+            name?: string;
+            width?: string;
+            height?: string;
+        };
     }
 }
 export declare function setCtx(ctx: WfuiContext | null): void;
 export declare function getCtx(): WfuiContext | null;
 export type Component<P = {}> = (props: P, ctx: WfuiContext) => Node;
+/**
+ * 包装第三方库为组件 — 元素挂载后执行 setup，返回函数在元素移除时自动清理。
+ *
+ * 自动创建容器元素 + 自动管理生命周期。
+ * 返回标准的 (props, ctx) => Node 组件。
+ *
+ * ```tsx
+ * const PieChart = wrap('div', (el, props: { data: any }, ctx) => {
+ *   el.style.cssText = 'width:100%;height:300px'
+ *   const chart = echarts.init(el)
+ *   chart.setOption(props.data)
+ *   effect(() => chart.setOption(props.data))
+ *   return () => chart.dispose()
+ * })
+ *
+ * const CanvasChart = wrap('canvas', (el, props, ctx) => {
+ *   const chart = new Chart(el, { type: 'line', data: props.data })
+ *   return () => chart.destroy()
+ * })
+ *
+ * // 在 JSX 中使用
+ * function Dashboard() {
+ *   return <div><PieChart data={salesData} /><CanvasChart data={trendData} /></div>
+ * }
+ * ```
+ */
+export declare function wrap<P = {}>(tagName: string, setup: (el: HTMLElement, props: P, ctx: WfuiContext) => (() => void) | void): Component<P>;
 export declare function jsx(type: string | Component, props: Record<string, unknown> | null, ...children: unknown[]): Node;
 export declare function jsxs(type: string | Component, props: Record<string, unknown> | null, ...children: unknown[]): Node;
 export declare function jsxDEV(type: string | Component, props: Record<string, unknown> | null, _key: string | null, _isStatic: boolean, _source: {
@@ -31,6 +356,42 @@ export declare function Fragment(props: Record<string, unknown> | null, ...child
  * 直接挂载 DOM（低层 API，一般用 createApp().mount()）
  */
 export declare function domMount(root: string | Element, app: Node): void;
+/**
+ * ErrorBoundary — 捕获子组件渲染时的异常。
+ *
+ * children 必须是 thunk（函数），延迟执行以便捕获错误。
+ *
+ * ```tsx
+ * <ErrorBoundary fallback={(e) => <p>出错了: {e.message}</p>}>
+ *   {() => <Dashboard />}
+ * </ErrorBoundary>
+ * ```
+ */
+export declare function ErrorBoundary({ fallback, children }: {
+    fallback: (error: Error) => Node;
+    children: () => Node;
+}, _ctx: WfuiContext): Node;
+/**
+ * Portal — 将组件渲染到父容器之外的 DOM 位置。
+ *
+ * 适用于 Modal、Dropdown、Tooltip 等需要突破 overflow / z-index 的场景。
+ *
+ * ```tsx
+ * import { createPortal } from 'weifuwu/client'
+ *
+ * function Modal({ show, children }) {
+ *   return <Show when={show}>
+ *     {createPortal(
+ *       <div class="fixed inset-0 bg-black/50 flex items-center justify-center">
+ *         {children}
+ *       </div>,
+ *       document.body
+ *     )}
+ *   </Show>
+ * }
+ * ```
+ */
+export declare function createPortal(node: Node, target: Element): Node;
 /**
  * 条件渲染 — when 为 Signal 时响应式切换
  *