@verbb/plugin-kit-react 1.0.9 → 2.0.0

package/dist/fault/AppFaultProvider.d.ts

@@ -0,0 +1,43 @@
+import { ReactNode } from 'react';
+import { AppFaultContext, AppFaultKind, AppFaultRecord } from './types.js';
+type RecordFaultInput = {
+    kind: AppFaultKind;
+    message: string;
+    stack?: string;
+    tagName?: string;
+    fatal?: boolean;
+};
+export type AppFaultProviderProps = AppFaultContext & {
+    children: ReactNode;
+    /** When false, skip the main-thread watchdog (useful in tests). */
+    enableWatchdog?: boolean;
+    /** Labels for the fault UI — pass translated strings from the host app. */
+    labels?: {
+        fatalTitle?: string;
+        fatalMessage?: string;
+        stuckTitle?: string;
+        stuckMessage?: string;
+    };
+};
+type AppFaultContextValue = {
+    faults: AppFaultRecord[];
+    hasFatalFault: boolean;
+    isStuck: boolean;
+    recordFault: (input: RecordFaultInput) => void;
+    resetUi: () => void;
+    reload: () => void;
+    clearFaults: () => void;
+    dismissStuck: () => void;
+};
+export declare function AppFaultProvider({ children, meta, onResetUi, onReload, enableWatchdog, labels, }: AppFaultProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAppFault(): AppFaultContextValue;
+/** Optional hook — returns null outside a provider (for chrome mounted in separate portals). */
+export declare function useAppFaultOptional(): AppFaultContextValue | null;
+export type ResetUiButtonProps = {
+    className?: string;
+    label?: string;
+};
+/** Always-reachable overlay recovery — mount in builder chrome, not inside dialogs. */
+export declare function ResetUiButton({ className, label }: ResetUiButtonProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=AppFaultProvider.d.ts.map

package/dist/fault/AppFaultProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppFaultProvider.d.ts","sourceRoot":"","sources":["../../src/fault/AppFaultProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGhF,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IAClD,QAAQ,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,MAAM,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACL,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAOF,wBAAgB,gBAAgB,CAAC,EAC7B,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,cAAqB,EACrB,MAAM,GACT,EAAE,qBAAqB,2CA0MvB;AAED,wBAAgB,WAAW,IAAI,oBAAoB,CAQlD;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,IAAI,CAEjE;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,KAAkB,EAAE,EAAE,kBAAkB,kDAYlF"}

package/dist/fault/AppFaultProvider.js

@@ -0,0 +1,192 @@
+import { AppFaultBoundary } from "./AppFaultBoundary.js";
+import { FaultFallback } from "./FaultFallback.js";
+import { isIgnorableGlobalError } from "./isIgnorableGlobalError.js";
+import { useUiWatchdog } from "./useUiWatchdog.js";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { recoverOverlays } from "@verbb/plugin-kit-web/plugin-kit";
+//#region src/fault/AppFaultProvider.tsx
+var AppFaultReactContext = createContext(null);
+var faultKey = (input) => `${input.kind}:${input.tagName ?? ""}:${input.message.split("\n")[0]}`;
+function AppFaultProvider({ children, meta, onResetUi, onReload, enableWatchdog = true, labels }) {
+	const [faults, setFaults] = useState([]);
+	const [hasFatalFault, setHasFatalFault] = useState(false);
+	const [isStuck, setIsStuck] = useState(false);
+	const seenRef = useRef(/* @__PURE__ */ new Map());
+	const recordFault = useCallback((input) => {
+		const key = faultKey(input);
+		const count = (seenRef.current.get(key) ?? 0) + 1;
+		seenRef.current.set(key, count);
+		const record = {
+			kind: input.kind,
+			message: input.message,
+			stack: input.stack,
+			tagName: input.tagName,
+			timestamp: Date.now(),
+			count
+		};
+		setFaults((prev) => {
+			return [record, ...prev.filter((item) => faultKey(item) !== key)].slice(0, 8);
+		});
+		if (input.fatal !== false && (input.kind === "react" || input.kind === "global")) setHasFatalFault(true);
+	}, []);
+	const resetUi = useCallback(() => {
+		const { actions, diagnostic } = recoverOverlays();
+		console.info("[plugin-kit] overlay recovery:", actions.join(", "), diagnostic.report);
+		onResetUi?.();
+		setIsStuck(false);
+		setHasFatalFault(false);
+		setFaults([]);
+		seenRef.current.clear();
+	}, [onResetUi]);
+	const reload = useCallback(() => {
+		if (onReload) {
+			onReload();
+			return;
+		}
+		window.location.reload();
+	}, [onReload]);
+	const clearFaults = useCallback(() => {
+		setHasFatalFault(false);
+		setFaults([]);
+		seenRef.current.clear();
+	}, []);
+	const dismissStuck = useCallback(() => {
+		setIsStuck(false);
+	}, []);
+	useEffect(() => {
+		const onResetShortcut = (event) => {
+			if (!((event.ctrlKey || event.metaKey) && event.shiftKey && (event.key === "U" || event.key === "u"))) return;
+			event.preventDefault();
+			resetUi();
+		};
+		window.addEventListener("keydown", onResetShortcut, true);
+		return () => {
+			window.removeEventListener("keydown", onResetShortcut, true);
+		};
+	}, [resetUi]);
+	useEffect(() => {
+		const onError = (event) => {
+			if (isIgnorableGlobalError(event.message, event.error)) return;
+			recordFault({
+				kind: "global",
+				message: event.message || event.error?.message || "Unknown error",
+				stack: event.error?.stack,
+				fatal: true
+			});
+		};
+		const onRejection = (event) => {
+			const reason = event.reason;
+			const message = reason?.message ?? String(event.reason);
+			if (isIgnorableGlobalError(message, reason)) return;
+			recordFault({
+				kind: "rejection",
+				message,
+				stack: reason?.stack,
+				fatal: false
+			});
+		};
+		const onPkError = (event) => {
+			const detail = event.detail;
+			recordFault({
+				kind: "pk-error",
+				tagName: detail?.tagName,
+				message: detail?.message ?? "Web component error",
+				stack: detail?.stack,
+				fatal: false
+			});
+		};
+		window.addEventListener("error", onError);
+		window.addEventListener("unhandledrejection", onRejection);
+		window.addEventListener("pk-error", onPkError);
+		return () => {
+			window.removeEventListener("error", onError);
+			window.removeEventListener("unhandledrejection", onRejection);
+			window.removeEventListener("pk-error", onPkError);
+		};
+	}, [recordFault]);
+	useUiWatchdog({
+		enabled: enableWatchdog && !hasFatalFault,
+		onStall: () => {
+			setIsStuck(true);
+			recordFault({
+				kind: "watchdog",
+				message: "The builder stopped responding.",
+				fatal: false
+			});
+		}
+	});
+	const value = useMemo(() => ({
+		faults,
+		hasFatalFault,
+		isStuck,
+		recordFault,
+		resetUi,
+		reload,
+		clearFaults,
+		dismissStuck
+	}), [
+		faults,
+		hasFatalFault,
+		isStuck,
+		recordFault,
+		resetUi,
+		reload,
+		clearFaults,
+		dismissStuck
+	]);
+	return /* @__PURE__ */ jsx(AppFaultReactContext.Provider, {
+		value,
+		children: /* @__PURE__ */ jsx(AppFaultBoundary, {
+			onFault: (fault) => recordFault({
+				...fault,
+				fatal: true
+			}),
+			children: hasFatalFault ? /* @__PURE__ */ jsx(FaultFallback, {
+				title: labels?.fatalTitle,
+				message: labels?.fatalMessage,
+				faults,
+				meta,
+				onReload: reload,
+				onResetUi: resetUi
+			}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [isStuck ? /* @__PURE__ */ jsx("div", {
+				className: "mb-3",
+				children: /* @__PURE__ */ jsx(FaultFallback, {
+					compact: true,
+					title: labels?.stuckTitle ?? "Builder became unresponsive",
+					message: labels?.stuckMessage ?? "The page may still scroll but clicks might not work. Reset UI to close stuck overlays, or reload if the problem continues.",
+					faults,
+					meta,
+					onReload: reload,
+					onResetUi: resetUi,
+					onDismiss: dismissStuck
+				})
+			}) : null, children] })
+		})
+	});
+}
+function useAppFault() {
+	const ctx = useContext(AppFaultReactContext);
+	if (!ctx) throw new Error("useAppFault must be used within AppFaultProvider");
+	return ctx;
+}
+/** Optional hook — returns null outside a provider (for chrome mounted in separate portals). */
+function useAppFaultOptional() {
+	return useContext(AppFaultReactContext);
+}
+/** Always-reachable overlay recovery — mount in builder chrome, not inside dialogs. */
+function ResetUiButton({ className, label = "Reset UI" }) {
+	const fault = useAppFaultOptional();
+	if (!fault) return null;
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		className,
+		onClick: fault.resetUi,
+		title: "Close stuck dialogs and overlays",
+		children: label
+	});
+}
+//#endregion
+export { AppFaultProvider, ResetUiButton, useAppFault, useAppFaultOptional };
+
+//# sourceMappingURL=AppFaultProvider.js.map

package/dist/fault/AppFaultProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppFaultProvider.js","names":[],"sources":["../../src/fault/AppFaultProvider.tsx"],"sourcesContent":["import {\n    createContext,\n    useCallback,\n    useContext,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n    type ReactNode,\n} from 'react';\nimport { recoverOverlays } from '@verbb/plugin-kit-web/plugin-kit';\n\nimport { AppFaultBoundary } from './AppFaultBoundary.js';\nimport { FaultFallback } from './FaultFallback.js';\nimport { isIgnorableGlobalError } from './isIgnorableGlobalError.js';\nimport type { AppFaultContext, AppFaultKind, AppFaultRecord } from './types.js';\nimport { useUiWatchdog } from './useUiWatchdog.js';\n\ntype RecordFaultInput = {\n    kind: AppFaultKind;\n    message: string;\n    stack?: string;\n    tagName?: string;\n    fatal?: boolean;\n};\n\nexport type AppFaultProviderProps = AppFaultContext & {\n    children: ReactNode;\n    /** When false, skip the main-thread watchdog (useful in tests). */\n    enableWatchdog?: boolean;\n    /** Labels for the fault UI — pass translated strings from the host app. */\n    labels?: {\n        fatalTitle?: string;\n        fatalMessage?: string;\n        stuckTitle?: string;\n        stuckMessage?: string;\n    };\n};\n\ntype AppFaultContextValue = {\n    faults: AppFaultRecord[];\n    hasFatalFault: boolean;\n    isStuck: boolean;\n    recordFault: (input: RecordFaultInput) => void;\n    resetUi: () => void;\n    reload: () => void;\n    clearFaults: () => void;\n    dismissStuck: () => void;\n};\n\nconst AppFaultReactContext = createContext<AppFaultContextValue | null>(null);\n\nconst faultKey = (input: RecordFaultInput): string =>\n    `${input.kind}:${input.tagName ?? ''}:${input.message.split('\\n')[0]}`;\n\nexport function AppFaultProvider({\n    children,\n    meta,\n    onResetUi,\n    onReload,\n    enableWatchdog = true,\n    labels,\n}: AppFaultProviderProps) {\n    const [faults, setFaults] = useState<AppFaultRecord[]>([]);\n    const [hasFatalFault, setHasFatalFault] = useState(false);\n    const [isStuck, setIsStuck] = useState(false);\n    const seenRef = useRef(new Map<string, number>());\n\n    const recordFault = useCallback((input: RecordFaultInput) => {\n        const key = faultKey(input);\n        const count = (seenRef.current.get(key) ?? 0) + 1;\n        seenRef.current.set(key, count);\n\n        const record: AppFaultRecord = {\n            kind: input.kind,\n            message: input.message,\n            stack: input.stack,\n            tagName: input.tagName,\n            timestamp: Date.now(),\n            count,\n        };\n\n        setFaults((prev) => {\n            const withoutDup = prev.filter((item) => faultKey(item) !== key);\n            return [record, ...withoutDup].slice(0, 8);\n        });\n\n        if (input.fatal !== false && (input.kind === 'react' || input.kind === 'global')) {\n            setHasFatalFault(true);\n        }\n    }, []);\n\n    const resetUi = useCallback(() => {\n        const { actions, diagnostic } = recoverOverlays();\n        console.info('[plugin-kit] overlay recovery:', actions.join(', '), diagnostic.report);\n        onResetUi?.();\n        setIsStuck(false);\n        setHasFatalFault(false);\n        setFaults([]);\n        seenRef.current.clear();\n    }, [onResetUi]);\n\n    const reload = useCallback(() => {\n        if (onReload) {\n            onReload();\n            return;\n        }\n\n        window.location.reload();\n    }, [onReload]);\n\n    const clearFaults = useCallback(() => {\n        setHasFatalFault(false);\n        setFaults([]);\n        seenRef.current.clear();\n    }, []);\n\n    const dismissStuck = useCallback(() => {\n        setIsStuck(false);\n    }, []);\n\n    useEffect(() => {\n        const onResetShortcut = (event: KeyboardEvent) => {\n            const combo =\n                (event.ctrlKey || event.metaKey) && event.shiftKey && (event.key === 'U' || event.key === 'u');\n\n            if (!combo) {\n                return;\n            }\n\n            event.preventDefault();\n            resetUi();\n        };\n\n        window.addEventListener('keydown', onResetShortcut, true);\n\n        return () => {\n            window.removeEventListener('keydown', onResetShortcut, true);\n        };\n    }, [resetUi]);\n\n    useEffect(() => {\n        const onError = (event: ErrorEvent) => {\n            if (isIgnorableGlobalError(event.message, event.error)) {\n                return;\n            }\n\n            recordFault({\n                kind: 'global',\n                message: event.message || event.error?.message || 'Unknown error',\n                stack: event.error?.stack,\n                fatal: true,\n            });\n        };\n\n        const onRejection = (event: PromiseRejectionEvent) => {\n            const reason = event.reason as Error | undefined;\n            const message = reason?.message ?? String(event.reason);\n\n            if (isIgnorableGlobalError(message, reason)) {\n                return;\n            }\n\n            recordFault({\n                kind: 'rejection',\n                message,\n                stack: reason?.stack,\n                fatal: false,\n            });\n        };\n\n        const onPkError = (event: Event) => {\n            const detail = (event as CustomEvent<{ tagName?: string; message?: string; stack?: string }>).detail;\n\n            recordFault({\n                kind: 'pk-error',\n                tagName: detail?.tagName,\n                message: detail?.message ?? 'Web component error',\n                stack: detail?.stack,\n                fatal: false,\n            });\n        };\n\n        window.addEventListener('error', onError);\n        window.addEventListener('unhandledrejection', onRejection);\n        window.addEventListener('pk-error', onPkError);\n\n        return () => {\n            window.removeEventListener('error', onError);\n            window.removeEventListener('unhandledrejection', onRejection);\n            window.removeEventListener('pk-error', onPkError);\n        };\n    }, [recordFault]);\n\n    useUiWatchdog({\n        enabled: enableWatchdog && !hasFatalFault,\n        onStall: () => {\n            setIsStuck(true);\n            recordFault({\n                kind: 'watchdog',\n                message: 'The builder stopped responding.',\n                fatal: false,\n            });\n        },\n    });\n\n    const value = useMemo<AppFaultContextValue>(\n        () => ({\n            faults,\n            hasFatalFault,\n            isStuck,\n            recordFault,\n            resetUi,\n            reload,\n            clearFaults,\n            dismissStuck,\n        }),\n        [faults, hasFatalFault, isStuck, recordFault, resetUi, reload, clearFaults, dismissStuck],\n    );\n\n    return (\n        <AppFaultReactContext.Provider value={value}>\n            <AppFaultBoundary\n                onFault={(fault) =>\n                    recordFault({\n                        ...fault,\n                        fatal: true,\n                    })\n                }\n            >\n                {hasFatalFault ? (\n                    <FaultFallback\n                        title={labels?.fatalTitle}\n                        message={labels?.fatalMessage}\n                        faults={faults}\n                        meta={meta}\n                        onReload={reload}\n                        onResetUi={resetUi}\n                    />\n                ) : (\n                    <>\n                        {isStuck ? (\n                            <div className=\"mb-3\">\n                                <FaultFallback\n                                    compact\n                                    title={labels?.stuckTitle ?? 'Builder became unresponsive'}\n                                    message={\n                                        labels?.stuckMessage ??\n                                        'The page may still scroll but clicks might not work. Reset UI to close stuck overlays, or reload if the problem continues.'\n                                    }\n                                    faults={faults}\n                                    meta={meta}\n                                    onReload={reload}\n                                    onResetUi={resetUi}\n                                    onDismiss={dismissStuck}\n                                />\n                            </div>\n                        ) : null}\n                        {children}\n                    </>\n                )}\n            </AppFaultBoundary>\n        </AppFaultReactContext.Provider>\n    );\n}\n\nexport function useAppFault(): AppFaultContextValue {\n    const ctx = useContext(AppFaultReactContext);\n\n    if (!ctx) {\n        throw new Error('useAppFault must be used within AppFaultProvider');\n    }\n\n    return ctx;\n}\n\n/** Optional hook — returns null outside a provider (for chrome mounted in separate portals). */\nexport function useAppFaultOptional(): AppFaultContextValue | null {\n    return useContext(AppFaultReactContext);\n}\n\nexport type ResetUiButtonProps = {\n    className?: string;\n    label?: string;\n};\n\n/** Always-reachable overlay recovery — mount in builder chrome, not inside dialogs. */\nexport function ResetUiButton({ className, label = 'Reset UI' }: ResetUiButtonProps) {\n    const fault = useAppFaultOptional();\n\n    if (!fault) {\n        return null;\n    }\n\n    return (\n        <button type=\"button\" className={className} onClick={fault.resetUi} title=\"Close stuck dialogs and overlays\">\n            {label}\n        </button>\n    );\n}\n"],"mappings":"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"}

package/dist/fault/FaultFallback.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+import { AppFaultRecord } from './types.js';
+export type FaultFallbackProps = {
+    title?: string;
+    message?: string;
+    faults: AppFaultRecord[];
+    meta?: Record<string, unknown>;
+    onReload: () => void;
+    onResetUi?: () => void;
+    onDismiss?: () => void;
+    /** When true, show inline banner styling instead of full-panel takeover. */
+    compact?: boolean;
+    children?: ReactNode;
+};
+export declare function FaultFallback({ title, message, faults, meta, onReload, onResetUi, onDismiss, compact, children, }: FaultFallbackProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FaultFallback.d.ts.map

package/dist/fault/FaultFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaultFallback.d.ts","sourceRoot":"","sources":["../../src/fault/FaultFallback.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB,CAAC;AAQF,wBAAgB,aAAa,CAAC,EAC1B,KAA8B,EAC9B,OAAuG,EACvG,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,OAAe,EACf,QAAQ,GACX,EAAE,kBAAkB,2CAgDpB"}

package/dist/fault/FaultFallback.js

@@ -0,0 +1,67 @@
+import { buildSupportBundle } from "./buildSupportBundle.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/fault/FaultFallback.tsx
+var btnClass = "inline-flex items-center justify-center rounded-md border border-black/10 bg-white px-3 py-1.5 text-sm font-medium text-gray-800 shadow-sm hover:bg-gray-50 disabled:opacity-50";
+var btnPrimaryClass = "inline-flex items-center justify-center rounded-md border border-transparent bg-[#0d78f2] px-3 py-1.5 text-sm font-medium text-white shadow-sm hover:bg-[#0b6ad9] disabled:opacity-50";
+function FaultFallback({ title = "Something went wrong", message = "The builder hit an unexpected error. You can try resetting the UI or reloading the builder.", faults, meta, onReload, onResetUi, onDismiss, compact = false, children }) {
+	const copyDetails = async () => {
+		const text = buildSupportBundle(faults, meta);
+		try {
+			await navigator.clipboard.writeText(text);
+		} catch {
+			console.warn("[plugin-kit] support bundle:\n", text);
+		}
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: compact ? "rounded-lg border border-amber-300 bg-amber-50 p-4 text-sm text-amber-950" : "rounded-lg border border-red-200 bg-red-50 p-6 text-sm text-red-900",
+		role: "alert",
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "font-semibold",
+				children: title
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "mt-2 text-[13px] leading-relaxed opacity-90",
+				children: message
+			}),
+			children,
+			/* @__PURE__ */ jsxs("div", {
+				className: "mt-4 flex flex-wrap gap-2",
+				children: [
+					onResetUi ? /* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: btnClass,
+						onClick: onResetUi,
+						children: "Reset UI"
+					}) : null,
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: btnPrimaryClass,
+						onClick: onReload,
+						children: "Reload builder"
+					}),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: btnClass,
+						onClick: () => void copyDetails(),
+						children: "Copy details for support"
+					}),
+					onDismiss ? /* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: btnClass,
+						onClick: onDismiss,
+						children: "Dismiss"
+					}) : null
+				]
+			}),
+			!compact && faults[0]?.message ? /* @__PURE__ */ jsx("pre", {
+				className: "mt-4 max-h-40 overflow-auto rounded border border-red-200/60 bg-white/70 p-3 text-xs text-red-800",
+				children: faults[0].message
+			}) : null
+		]
+	});
+}
+//#endregion
+export { FaultFallback };
+
+//# sourceMappingURL=FaultFallback.js.map

package/dist/fault/FaultFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaultFallback.js","names":[],"sources":["../../src/fault/FaultFallback.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport { buildSupportBundle } from './buildSupportBundle.js';\nimport type { AppFaultRecord } from './types.js';\n\nexport type FaultFallbackProps = {\n    title?: string;\n    message?: string;\n    faults: AppFaultRecord[];\n    meta?: Record<string, unknown>;\n    onReload: () => void;\n    onResetUi?: () => void;\n    onDismiss?: () => void;\n    /** When true, show inline banner styling instead of full-panel takeover. */\n    compact?: boolean;\n    children?: ReactNode;\n};\n\nconst btnClass =\n    'inline-flex items-center justify-center rounded-md border border-black/10 bg-white px-3 py-1.5 text-sm font-medium text-gray-800 shadow-sm hover:bg-gray-50 disabled:opacity-50';\n\nconst btnPrimaryClass =\n    'inline-flex items-center justify-center rounded-md border border-transparent bg-[#0d78f2] px-3 py-1.5 text-sm font-medium text-white shadow-sm hover:bg-[#0b6ad9] disabled:opacity-50';\n\nexport function FaultFallback({\n    title = 'Something went wrong',\n    message = 'The builder hit an unexpected error. You can try resetting the UI or reloading the builder.',\n    faults,\n    meta,\n    onReload,\n    onResetUi,\n    onDismiss,\n    compact = false,\n    children,\n}: FaultFallbackProps) {\n    const copyDetails = async () => {\n        const text = buildSupportBundle(faults, meta);\n\n        try {\n            await navigator.clipboard.writeText(text);\n        } catch {\n            console.warn('[plugin-kit] support bundle:\\n', text);\n        }\n    };\n\n    const shellClass = compact\n        ? 'rounded-lg border border-amber-300 bg-amber-50 p-4 text-sm text-amber-950'\n        : 'rounded-lg border border-red-200 bg-red-50 p-6 text-sm text-red-900';\n\n    return (\n        <div className={shellClass} role=\"alert\">\n            <div className=\"font-semibold\">{title}</div>\n            <p className=\"mt-2 text-[13px] leading-relaxed opacity-90\">{message}</p>\n\n            {children}\n\n            <div className=\"mt-4 flex flex-wrap gap-2\">\n                {onResetUi ? (\n                    <button type=\"button\" className={btnClass} onClick={onResetUi}>\n                        Reset UI\n                    </button>\n                ) : null}\n                <button type=\"button\" className={btnPrimaryClass} onClick={onReload}>\n                    Reload builder\n                </button>\n                <button type=\"button\" className={btnClass} onClick={() => void copyDetails()}>\n                    Copy details for support\n                </button>\n                {onDismiss ? (\n                    <button type=\"button\" className={btnClass} onClick={onDismiss}>\n                        Dismiss\n                    </button>\n                ) : null}\n            </div>\n\n            {!compact && faults[0]?.message ? (\n                <pre className=\"mt-4 max-h-40 overflow-auto rounded border border-red-200/60 bg-white/70 p-3 text-xs text-red-800\">\n                    {faults[0].message}\n                </pre>\n            ) : null}\n        </div>\n    );\n}\n"],"mappings":";;;AAkBA,IAAM,WACF;AAEJ,IAAM,kBACF;AAEJ,SAAgB,cAAc,EAC1B,QAAQ,wBACR,UAAU,+FACV,QACA,MACA,UACA,WACA,WACA,UAAU,OACV,YACmB;CACnB,MAAM,cAAc,YAAY;EAC5B,MAAM,OAAO,mBAAmB,QAAQ,KAAK;AAE7C,MAAI;AACA,SAAM,UAAU,UAAU,UAAU,KAAK;UACrC;AACJ,WAAQ,KAAK,kCAAkC,KAAK;;;AAQ5D,QACI,qBAAC,OAAD;EAAK,WALU,UACb,8EACA;EAG0B,MAAK;YAAjC;GACI,oBAAC,OAAD;IAAK,WAAU;cAAiB;IAAY,CAAA;GAC5C,oBAAC,KAAD;IAAG,WAAU;cAA+C;IAAY,CAAA;GAEvE;GAED,qBAAC,OAAD;IAAK,WAAU;cAAf;KACK,YACG,oBAAC,UAAD;MAAQ,MAAK;MAAS,WAAW;MAAU,SAAS;gBAAW;MAEtD,CAAA,GACT;KACJ,oBAAC,UAAD;MAAQ,MAAK;MAAS,WAAW;MAAiB,SAAS;gBAAU;MAE5D,CAAA;KACT,oBAAC,UAAD;MAAQ,MAAK;MAAS,WAAW;MAAU,eAAe,KAAK,aAAa;gBAAE;MAErE,CAAA;KACR,YACG,oBAAC,UAAD;MAAQ,MAAK;MAAS,WAAW;MAAU,SAAS;gBAAW;MAEtD,CAAA,GACT;KACF;;GAEL,CAAC,WAAW,OAAO,IAAI,UACpB,oBAAC,OAAD;IAAK,WAAU;cACV,OAAO,GAAG;IACT,CAAA,GACN;GACF"}

package/dist/fault/buildSupportBundle.d.ts

@@ -0,0 +1,3 @@
+import { AppFaultRecord } from './types.js';
+export declare const buildSupportBundle: (faults: AppFaultRecord[], meta?: Record<string, unknown>) => string;
+//# sourceMappingURL=buildSupportBundle.d.ts.map

package/dist/fault/buildSupportBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSupportBundle.d.ts","sourceRoot":"","sources":["../../src/fault/buildSupportBundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,GAC3B,QAAQ,cAAc,EAAE,EACxB,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,MAiBF,CAAC"}

package/dist/fault/buildSupportBundle.js

@@ -0,0 +1,22 @@
+//#region src/fault/buildSupportBundle.ts
+var buildSupportBundle = (faults, meta) => {
+	const payload = {
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "",
+		url: typeof location !== "undefined" ? location.href : "",
+		meta: meta ?? {},
+		faults: faults.map((fault) => ({
+			kind: fault.kind,
+			message: fault.message,
+			stack: fault.stack,
+			tagName: fault.tagName,
+			timestamp: new Date(fault.timestamp).toISOString(),
+			count: fault.count
+		}))
+	};
+	return JSON.stringify(payload, null, 2);
+};
+//#endregion
+export { buildSupportBundle };
+
+//# sourceMappingURL=buildSupportBundle.js.map

package/dist/fault/buildSupportBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSupportBundle.js","names":[],"sources":["../../src/fault/buildSupportBundle.ts"],"sourcesContent":["import type { AppFaultRecord } from './types.js';\n\nexport const buildSupportBundle = (\n    faults: AppFaultRecord[],\n    meta?: Record<string, unknown>,\n): string => {\n    const payload = {\n        timestamp: new Date().toISOString(),\n        userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : '',\n        url: typeof location !== 'undefined' ? location.href : '',\n        meta: meta ?? {},\n        faults: faults.map((fault) => ({\n            kind: fault.kind,\n            message: fault.message,\n            stack: fault.stack,\n            tagName: fault.tagName,\n            timestamp: new Date(fault.timestamp).toISOString(),\n            count: fault.count,\n        })),\n    };\n\n    return JSON.stringify(payload, null, 2);\n};\n"],"mappings":";AAEA,IAAa,sBACT,QACA,SACS;CACT,MAAM,UAAU;EACZ,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,WAAW,OAAO,cAAc,cAAc,UAAU,YAAY;EACpE,KAAK,OAAO,aAAa,cAAc,SAAS,OAAO;EACvD,MAAM,QAAQ,EAAE;EAChB,QAAQ,OAAO,KAAK,WAAW;GAC3B,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,OAAO,MAAM;GACb,SAAS,MAAM;GACf,WAAW,IAAI,KAAK,MAAM,UAAU,CAAC,aAAa;GAClD,OAAO,MAAM;GAChB,EAAE;EACN;AAED,QAAO,KAAK,UAAU,SAAS,MAAM,EAAE"}

package/dist/fault/index.d.ts

@@ -0,0 +1,8 @@
+export { AppFaultBoundary } from './AppFaultBoundary.js';
+export { AppFaultProvider, ResetUiButton, useAppFault, useAppFaultOptional, type AppFaultProviderProps, type ResetUiButtonProps, } from './AppFaultProvider.js';
+export { buildSupportBundle } from './buildSupportBundle.js';
+export { FaultFallback, type FaultFallbackProps } from './FaultFallback.js';
+export { isIgnorableGlobalError } from './isIgnorableGlobalError.js';
+export { useUiWatchdog, type UiWatchdogOptions } from './useUiWatchdog.js';
+export type { AppFaultContext, AppFaultKind, AppFaultRecord } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fault/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fault/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/fault/index.js

@@ -0,0 +1,7 @@
+import { AppFaultBoundary } from "./AppFaultBoundary.js";
+import { buildSupportBundle } from "./buildSupportBundle.js";
+import { FaultFallback } from "./FaultFallback.js";
+import { isIgnorableGlobalError } from "./isIgnorableGlobalError.js";
+import { useUiWatchdog } from "./useUiWatchdog.js";
+import { AppFaultProvider, ResetUiButton, useAppFault, useAppFaultOptional } from "./AppFaultProvider.js";
+export { AppFaultBoundary, AppFaultProvider, FaultFallback, ResetUiButton, buildSupportBundle, isIgnorableGlobalError, useAppFault, useAppFaultOptional, useUiWatchdog };

package/dist/fault/isIgnorableGlobalError.d.ts

@@ -0,0 +1,3 @@
+/** Errors that should not escalate to the app fault UI. */
+export declare const isIgnorableGlobalError: (message: string, error?: Error) => boolean;
+//# sourceMappingURL=isIgnorableGlobalError.d.ts.map

package/dist/fault/isIgnorableGlobalError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isIgnorableGlobalError.d.ts","sourceRoot":"","sources":["../../src/fault/isIgnorableGlobalError.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,KAAG,OAoBvE,CAAC"}

package/dist/fault/isIgnorableGlobalError.js

@@ -0,0 +1,14 @@
+//#region src/fault/isIgnorableGlobalError.ts
+/** Errors that should not escalate to the app fault UI. */
+var isIgnorableGlobalError = (message, error) => {
+	const text = `${message}\n${error?.message ?? ""}`.toLowerCase();
+	if (text.includes("resizeobserver loop")) return true;
+	if (text.includes("aborted") && text.includes("fetch")) return true;
+	if (text.includes("networkerror") && text.includes("fetch")) return true;
+	if (text.includes("loading chunk") && text.includes("failed")) return false;
+	return false;
+};
+//#endregion
+export { isIgnorableGlobalError };
+
+//# sourceMappingURL=isIgnorableGlobalError.js.map

package/dist/fault/isIgnorableGlobalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isIgnorableGlobalError.js","names":[],"sources":["../../src/fault/isIgnorableGlobalError.ts"],"sourcesContent":["/** Errors that should not escalate to the app fault UI. */\nexport const isIgnorableGlobalError = (message: string, error?: Error): boolean => {\n    const text = `${message}\\n${error?.message ?? ''}`.toLowerCase();\n\n    if (text.includes('resizeobserver loop')) {\n        return true;\n    }\n\n    if (text.includes('aborted') && text.includes('fetch')) {\n        return true;\n    }\n\n    if (text.includes('networkerror') && text.includes('fetch')) {\n        return true;\n    }\n\n    if (text.includes('loading chunk') && text.includes('failed')) {\n        return false;\n    }\n\n    return false;\n};\n"],"mappings":";;AACA,IAAa,0BAA0B,SAAiB,UAA2B;CAC/E,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,WAAW,KAAK,aAAa;AAEhE,KAAI,KAAK,SAAS,sBAAsB,CACpC,QAAO;AAGX,KAAI,KAAK,SAAS,UAAU,IAAI,KAAK,SAAS,QAAQ,CAClD,QAAO;AAGX,KAAI,KAAK,SAAS,eAAe,IAAI,KAAK,SAAS,QAAQ,CACvD,QAAO;AAGX,KAAI,KAAK,SAAS,gBAAgB,IAAI,KAAK,SAAS,SAAS,CACzD,QAAO;AAGX,QAAO"}

package/dist/fault/types.d.ts

@@ -0,0 +1,18 @@
+export type AppFaultKind = 'react' | 'global' | 'rejection' | 'pk-error' | 'watchdog' | 'overlay';
+export type AppFaultRecord = {
+    kind: AppFaultKind;
+    message: string;
+    stack?: string;
+    tagName?: string;
+    timestamp: number;
+    count: number;
+};
+export type AppFaultContext = {
+    /** App-specific metadata included in support bundles (menu id, site id, etc.). */
+    meta?: Record<string, unknown>;
+    /** Called after overlay recovery — reset dialog/menu React state. */
+    onResetUi?: () => void;
+    /** Soft reload — remount builder without full page navigation when provided. */
+    onReload?: () => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/fault/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fault/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAElG,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC"}

package/dist/fault/useUiWatchdog.d.ts

@@ -0,0 +1,13 @@
+export type UiWatchdogOptions = {
+    /** Milliseconds without a heartbeat tick before reporting stuck UI. */
+    stallMs?: number;
+    /** When false, the watchdog is paused (e.g. app fault screen already shown). */
+    enabled?: boolean;
+    onStall: () => void;
+};
+/**
+ * Detects main-thread stalls via rAF heartbeat. Does not recover — callers show
+ * a banner or escalate to the fault UI.
+ */
+export declare const useUiWatchdog: ({ stallMs, enabled, onStall, }: UiWatchdogOptions) => void;
+//# sourceMappingURL=useUiWatchdog.d.ts.map

package/dist/fault/useUiWatchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUiWatchdog.d.ts","sourceRoot":"","sources":["../../src/fault/useUiWatchdog.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,gCAI3B,iBAAiB,KAAG,IAyCtB,CAAC"}

package/dist/fault/useUiWatchdog.js

@@ -0,0 +1,38 @@
+import { useEffect, useRef } from "react";
+//#region src/fault/useUiWatchdog.ts
+/**
+* Detects main-thread stalls via rAF heartbeat. Does not recover — callers show
+* a banner or escalate to the fault UI.
+*/
+var useUiWatchdog = ({ stallMs = 3e3, enabled = true, onStall }) => {
+	const lastTickRef = useRef(performance.now());
+	const firedRef = useRef(false);
+	const onStallRef = useRef(onStall);
+	onStallRef.current = onStall;
+	useEffect(() => {
+		if (!enabled) return;
+		firedRef.current = false;
+		lastTickRef.current = performance.now();
+		let rafId = 0;
+		const tick = () => {
+			lastTickRef.current = performance.now();
+			rafId = window.requestAnimationFrame(tick);
+		};
+		rafId = window.requestAnimationFrame(tick);
+		const intervalId = window.setInterval(() => {
+			if (firedRef.current) return;
+			if (performance.now() - lastTickRef.current >= stallMs) {
+				firedRef.current = true;
+				onStallRef.current();
+			}
+		}, Math.min(500, stallMs / 2));
+		return () => {
+			window.cancelAnimationFrame(rafId);
+			window.clearInterval(intervalId);
+		};
+	}, [enabled, stallMs]);
+};
+//#endregion
+export { useUiWatchdog };
+
+//# sourceMappingURL=useUiWatchdog.js.map

package/dist/fault/useUiWatchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUiWatchdog.js","names":[],"sources":["../../src/fault/useUiWatchdog.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nexport type UiWatchdogOptions = {\n    /** Milliseconds without a heartbeat tick before reporting stuck UI. */\n    stallMs?: number;\n    /** When false, the watchdog is paused (e.g. app fault screen already shown). */\n    enabled?: boolean;\n    onStall: () => void;\n};\n\n/**\n * Detects main-thread stalls via rAF heartbeat. Does not recover — callers show\n * a banner or escalate to the fault UI.\n */\nexport const useUiWatchdog = ({\n    stallMs = 3000,\n    enabled = true,\n    onStall,\n}: UiWatchdogOptions): void => {\n    const lastTickRef = useRef(performance.now());\n    const firedRef = useRef(false);\n    const onStallRef = useRef(onStall);\n    onStallRef.current = onStall;\n\n    useEffect(() => {\n        if (!enabled) {\n            return;\n        }\n\n        firedRef.current = false;\n        lastTickRef.current = performance.now();\n\n        let rafId = 0;\n\n        const tick = () => {\n            lastTickRef.current = performance.now();\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n\n        const intervalId = window.setInterval(() => {\n            if (firedRef.current) {\n                return;\n            }\n\n            const elapsed = performance.now() - lastTickRef.current;\n\n            if (elapsed >= stallMs) {\n                firedRef.current = true;\n                onStallRef.current();\n            }\n        }, Math.min(500, stallMs / 2));\n\n        return () => {\n            window.cancelAnimationFrame(rafId);\n            window.clearInterval(intervalId);\n        };\n    }, [enabled, stallMs]);\n};\n"],"mappings":";;;;;;AAcA,IAAa,iBAAiB,EAC1B,UAAU,KACV,UAAU,MACV,cAC2B;CAC3B,MAAM,cAAc,OAAO,YAAY,KAAK,CAAC;CAC7C,MAAM,WAAW,OAAO,MAAM;CAC9B,MAAM,aAAa,OAAO,QAAQ;AAClC,YAAW,UAAU;AAErB,iBAAgB;AACZ,MAAI,CAAC,QACD;AAGJ,WAAS,UAAU;AACnB,cAAY,UAAU,YAAY,KAAK;EAEvC,IAAI,QAAQ;EAEZ,MAAM,aAAa;AACf,eAAY,UAAU,YAAY,KAAK;AACvC,WAAQ,OAAO,sBAAsB,KAAK;;AAG9C,UAAQ,OAAO,sBAAsB,KAAK;EAE1C,MAAM,aAAa,OAAO,kBAAkB;AACxC,OAAI,SAAS,QACT;AAKJ,OAFgB,YAAY,KAAK,GAAG,YAAY,WAEjC,SAAS;AACpB,aAAS,UAAU;AACnB,eAAW,SAAS;;KAEzB,KAAK,IAAI,KAAK,UAAU,EAAE,CAAC;AAE9B,eAAa;AACT,UAAO,qBAAqB,MAAM;AAClC,UAAO,cAAc,WAAW;;IAErC,CAAC,SAAS,QAAQ,CAAC"}

package/dist/forms/Field.d.ts

@@ -1,38 +1,26 @@
-import { ComponentProps, ReactNode } from 'react';
-import { Label } from '../components';
-import { Slot } from '../components/Slot';
-type FieldContextValue = {
-    id: string;
-    name: string;
-    errors: string[];
-};
-declare const InlineFieldErrorVisibilityContext: import('react').Context<boolean>;
-declare const useFieldContext: () => FieldContextValue;
-type FieldRootProps = ComponentProps<'div'> & {
-    name: string;
-    errors?: string[];
-};
-declare const FieldRoot: ({ name, errors, className, ...props }: FieldRootProps) => import("react/jsx-runtime").JSX.Element;
-declare const FieldHeader: ({ className, ...props }: ComponentProps<"div">) => import("react/jsx-runtime").JSX.Element;
-declare const FieldLabel: ({ className, ...props }: ComponentProps<typeof Label>) => import("react/jsx-runtime").JSX.Element;
-declare const FieldInstructions: ({ className, children, ...props }: ComponentProps<"p">) => import("react/jsx-runtime").JSX.Element;
-type FieldControlProps = Omit<ComponentProps<typeof Slot>, 'className'> & {
-    className?: string;
-};
-declare const FieldControl: ({ className, ...props }: FieldControlProps) => import("react/jsx-runtime").JSX.Element;
-declare const FieldErrors: ({ className, ...props }: ComponentProps<"ul">) => import("react/jsx-runtime").JSX.Element | null;
-type FieldLayoutProps = ComponentProps<'div'> & {
+import { default as React, ReactNode } from 'react';
+export type FieldLayoutProps = {
     name: string;
     label?: string;
     instructions?: string;
-    headerEnd?: ReactNode;
-    required?: boolean;
     warning?: string;
-    errors?: string[];
-    withControl?: boolean;
-    showInlineErrors?: boolean;
+    tip?: string;
+    required?: boolean;
     translatable?: boolean;
+    errors?: string[];
+    headerEnd?: ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: ReactNode;
 };
-declare const FieldLayout: ({ name, label, instructions, headerEnd, required, warning, errors, withControl, showInlineErrors, translatable, className, children, ...props }: FieldLayoutProps) => import("react/jsx-runtime").JSX.Element;
-export { FieldRoot, FieldHeader, FieldLabel, FieldInstructions, FieldControl, FieldErrors, FieldLayout, InlineFieldErrorVisibilityContext, useFieldContext, };
+/**
+ * Schema-form field shell. Delegates label / instructions / errors / warning / tip /
+ * required / translatable rendering to the `<pk-field>` web component, so there is no
+ * Tailwind or per-framework styling in this facade — only tokens + shadow-DOM CSS.
+ *
+ * Do not force `width: auto` on unlabeled shells here — composite controls (conditions
+ * tables, etc.) need full width. FieldWrap clusters shrink nested hosts via
+ * `[data-pk-field-wrap-controls] pk-field` in `style.css`.
+ */
+export declare const FieldLayout: ({ name, label, instructions, warning, tip, required, translatable, errors, headerEnd, className, style, children, }: FieldLayoutProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Field.d.ts.map

package/dist/forms/Field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/forms/Field.tsx"],"names":[],"mappings":"AAAA,OAAO,EAC+B,KAAK,cAAc,EAAE,KAAK,SAAS,EACxE,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,EAAY,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAC;AAQ/D,KAAK,iBAAiB,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAGF,QAAA,MAAM,iCAAiC,kCAA+B,CAAC;AAEvE,QAAA,MAAM,eAAe,yBAMpB,CAAC;AAEF,KAAK,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,SAAS,GAAI,uCAEhB,cAAc,4CAWhB,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,yBAAyB,cAAc,CAAC,KAAK,CAAC,4CAIlE,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,yBAAyB,cAAc,CAAC,OAAO,KAAK,CAAC,4CAWxE,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,mCAAmC,cAAc,CAAC,GAAG,CAAC,4CA0BhF,CAAC;AAEF,KAAK,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,EAAE,WAAW,CAAC,GAAG;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,yBAAyB,iBAAiB,4CAe/D,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,yBAAyB,cAAc,CAAC,IAAI,CAAC,mDAsBjE,CAAC;AAEF,KAAK,gBAAgB,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,iJAclB,gBAAgB,4CAqElB,CAAC;AAEF,OAAO,EACH,SAAS,EACT,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iCAAiC,EACjC,eAAe,GAClB,CAAC"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/forms/Field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,qHAazB,gBAAgB,4CAkBlB,CAAC"}