@burdenoff/fe-libs 2026.521.4 → 2026.521.6

package/dist/shared/providers/AppShellProvider.js

@@ -17,30 +17,30 @@ import { FeatureFlagProvider as g } from "../feature-flags/FeatureFlagProvider.j
 import "../../shared-feature-flags.js";
 import { GlobalUiProvider as _ } from "./shell/GlobalUiProvider.js";
 import { ShellUiProvider as v } from "./shell/ShellUiProvider.js";
-import { ContextManagerProvider as y } from "./shell/ContextManagerProvider.js";
-import { AuthTokenProvider as ee } from "./shell/AuthTokenProvider.js";
-import { MultiGatewayProvider as te } from "./shell/MultiGatewayProvider.js";
-import { G as b, j as x, w as S } from "../../node_modules/web-vitals/dist/web-vitals.js";
-import { ProfileI18nBridge as C } from "./shell/ProfileI18nBridge.js";
-import { ProfileGeographyBridge as w } from "./shell/ProfileGeographyBridge.js";
-import { AppShellContextProvider as T } from "./shell/AppShellContext.js";
+import { ContextManagerProvider as ee } from "./shell/ContextManagerProvider.js";
+import { AuthTokenProvider as y } from "./shell/AuthTokenProvider.js";
+import { MultiGatewayProvider as b } from "./shell/MultiGatewayProvider.js";
+import { G as x, j as S, w as C } from "../../node_modules/web-vitals/dist/web-vitals.js";
+import { ProfileI18nBridge as w } from "./shell/ProfileI18nBridge.js";
+import { ProfileGeographyBridge as T } from "./shell/ProfileGeographyBridge.js";
+import { AppShellContextProvider as te } from "./shell/AppShellContext.js";
 import { DevtoolsSink as E } from "../events/sinks/DevtoolsSink.js";
 import { BroadcastChannelSink as D } from "../events/sinks/BroadcastChannelSink.js";
 import { BackendAuditSink as O } from "../events/sinks/BackendAuditSink.js";
 import { RybbitSink as k } from "../events/sinks/RybbitSink.js";
 import { OtelBrowserSink as A } from "../events/sinks/OtelBrowserSink.js";
-import { EventBusProvider as j, useEventBus as M } from "../../shared-events.js";
+import { EventBusProvider as ne, useEventBus as j } from "../../shared-events.js";
 import "../../shared-logger.js";
-import { useReferralAttribution as N } from "../hooks/useReferralAttribution.js";
-import { TourPlayerProvider as P } from "../tours/TourPlayerProvider.js";
-import { ToursProvider as F, useToursContext as I } from "../tours/ToursContext.js";
-import { TourInitializer as L } from "../tours/TourInitializer.js";
+import { useReferralAttribution as M } from "../hooks/useReferralAttribution.js";
+import { TourPlayerProvider as N } from "../tours/TourPlayerProvider.js";
+import { ToursProvider as P, useToursContext as F } from "../tours/ToursContext.js";
+import { TourInitializer as I } from "../tours/TourInitializer.js";
 import "../../shared-tours.js";
-import { Suspense as R, useCallback as z, useEffect as B, useMemo as V, useRef as H } from "react";
-import { Fragment as U, jsx as W, jsxs as G } from "react/jsx-runtime";
-import { BrowserRouter as ne, useLocation as K } from "react-router-dom";
-import { Toaster as q } from "sonner";
-import { QueryClient as re, QueryClientProvider as ie } from "@tanstack/react-query";
+import { Suspense as L, useCallback as R, useEffect as z, useMemo as B, useRef as V } from "react";
+import { Fragment as H, jsx as U, jsxs as W } from "react/jsx-runtime";
+import { BrowserRouter as re, useLocation as G } from "react-router-dom";
+import { Toaster as K } from "sonner";
+import { QueryClient as ie, QueryClientProvider as q } from "@tanstack/react-query";
 //#region src/shared/providers/AppShellProvider.tsx
 var J = {
 	bigconsole: {
@@ -61,11 +61,26 @@ var J = {
 	},
 	vibecontrols: { prod: "8a46449d9c07" },
 	workspaces: { prod: "da0c142f4b2e" }
-};
-function Y(e) {
+}, Y = [
+	"nav.route.changed",
+	"auth.signed_in",
+	"auth.signed_out",
+	"support.ticket.created",
+	"support.ticket.closed",
+	"support.ticket.reopened",
+	"support.kb.article_rated",
+	"conversations.conversation.created",
+	"conversations.conversation.archived",
+	"notification.item.opened",
+	"notification.preference.updated",
+	"notification.admin.sent",
+	"notification.template.saved",
+	"notification.schedule.updated"
+];
+function X(e) {
 	return e === "prod" || e === "production" ? "prod" : e === "alpha" || e === "staging" ? "alpha" : "dev";
 }
-function X(e, t) {
+function Z(e, t) {
 	return e.VITE_DISABLE_ANALYTICS === "true" ? !1 : e.VITE_ENABLE_ANALYTICS === "true" || e.PROD || t !== "dev" ? !0 : e.VITE_ENABLE_ANALYTICS !== "false";
 }
 function ae() {
@@ -77,8 +92,8 @@ function ae() {
 		SSR: !1
 	};
 }
-function Z(e, t) {
-	let n = Y(t.VITE_DEPLOY_ENV ?? t.MODE), r = X(t, n), i = J[e], a = n === "prod" ? i?.prod : i?.nonProd, o = t.VITE_RYBBIT_SITE_ID || a, s = t.VITE_BACKEND_AUDIT_ENDPOINT || (t.PROD ? "/api/fe-events" : void 0);
+function Q(e, t) {
+	let n = X(t.VITE_DEPLOY_ENV ?? t.MODE), r = Z(t, n), i = J[e], a = n === "prod" ? i?.prod : i?.nonProd, o = t.VITE_RYBBIT_SITE_ID || a, s = t.VITE_BACKEND_AUDIT_ENDPOINT || (t.PROD ? "/api/fe-events" : void 0);
 	return {
 		enabled: r,
 		appVersion: t.VITE_APP_VERSION || "0.0.0",
@@ -89,6 +104,7 @@ function Z(e, t) {
 			enabled: r && !!o,
 			siteId: o,
 			scriptUrl: t.VITE_RYBBIT_SCRIPT_URL,
+			allowlist: Y,
 			identifyOn: "auth.signed_in",
 			rename: { "nav.route.changed": "pageview" }
 		},
@@ -103,16 +119,16 @@ function Z(e, t) {
 		}
 	};
 }
-function Q({ children: e, enablePWA: t, toasterPosition: n, productName: r, brandInitial: i }) {
-	let { trackProgress: a, recordStepCompletion: o, trackEvent: s } = I(), c = z((e, t) => e.steps?.[t], []);
-	return /* @__PURE__ */ G(P, {
-		onTourStart: z((e) => {
+function $({ children: e, enablePWA: t, toasterPosition: n, productName: r, brandInitial: i }) {
+	let { trackProgress: a, recordStepCompletion: o, trackEvent: s } = F(), c = R((e, t) => e.steps?.[t], []);
+	return /* @__PURE__ */ W(N, {
+		onTourStart: R((e) => {
 			a(e.id, "started"), s("TOUR_STARTED", e.id);
 		}, [s, a]),
-		onTourComplete: z((e) => {
+		onTourComplete: R((e) => {
 			a(e.id, "completed"), s("TOUR_COMPLETED", e.id);
 		}, [s, a]),
-		onTourSkip: z((e, t) => {
+		onTourSkip: R((e, t) => {
 			let n = c(e, t);
 			a(e.id, "skipped"), s("TOUR_SKIPPED", e.id, {
 				stepId: n?.id,
@@ -123,14 +139,14 @@ function Q({ children: e, enablePWA: t, toasterPosition: n, productName: r, bran
 			s,
 			a
 		]),
-		onStepChange: z((e, t) => {
+		onStepChange: R((e, t) => {
 			let n = c(e, t);
 			n && s("STEP_VIEWED", e.id, {
 				stepId: n.id,
 				stepOrder: n.stepOrder
 			});
 		}, [c, s]),
-		onStepComplete: z((e, t) => {
+		onStepComplete: R((e, t) => {
 			let n = c(e, t);
 			n && (o(e.id, n.id), s("STEP_COMPLETED", e.id, {
 				stepId: n.id,
@@ -142,16 +158,16 @@ function Q({ children: e, enablePWA: t, toasterPosition: n, productName: r, bran
 			s
 		]),
 		children: [
-			/* @__PURE__ */ W(L, {}),
+			/* @__PURE__ */ U(I, {}),
 			e,
-			/* @__PURE__ */ W(q, {
+			/* @__PURE__ */ U(K, {
 				position: n,
 				richColors: !0,
 				closeButton: !0
 			}),
-			t && /* @__PURE__ */ W(R, {
+			t && /* @__PURE__ */ U(L, {
 				fallback: null,
-				children: /* @__PURE__ */ W(p, {
+				children: /* @__PURE__ */ U(p, {
 					productName: r,
 					brandInitial: i
 				})
@@ -160,17 +176,17 @@ function Q({ children: e, enablePWA: t, toasterPosition: n, productName: r, bran
 	});
 }
 function oe({ children: e, i18nProductId: t, fallbackTranslations: n, defaultBrand: r, productName: i, brandInitial: a, enablePWA: o, toasterPosition: s }) {
-	let c = K();
-	N();
-	let l = c.pathname.startsWith("/auth/") || c.pathname.startsWith("/devportal") || c.pathname.startsWith("/organizations") || c.pathname.startsWith("/workspaces"), d = /* @__PURE__ */ W(w, { children: /* @__PURE__ */ W(h, { children: /* @__PURE__ */ W(g, {
+	let c = G();
+	M();
+	let l = c.pathname.startsWith("/auth/") || c.pathname.startsWith("/devportal") || c.pathname.startsWith("/organizations") || c.pathname.startsWith("/workspaces"), d = /* @__PURE__ */ U(T, { children: /* @__PURE__ */ U(h, { children: /* @__PURE__ */ U(g, {
 		workspaceId: null,
 		gateway: "global",
 		defaultEnabled: !0,
-		children: /* @__PURE__ */ W(_, { children: /* @__PURE__ */ W(v, { children: /* @__PURE__ */ W(f, {
+		children: /* @__PURE__ */ U(_, { children: /* @__PURE__ */ U(v, { children: /* @__PURE__ */ U(f, {
 			fallback: null,
-			children: /* @__PURE__ */ W(F, {
+			children: /* @__PURE__ */ U(P, {
 				disabled: l,
-				children: /* @__PURE__ */ W(Q, {
+				children: /* @__PURE__ */ U($, {
 					enablePWA: o,
 					toasterPosition: s,
 					productName: i,
@@ -180,9 +196,9 @@ function oe({ children: e, i18nProductId: t, fallbackTranslations: n, defaultBra
 			})
 		}) }) })
 	}) }) });
-	return /* @__PURE__ */ G(u, {
+	return /* @__PURE__ */ W(u, {
 		defaultBrand: r,
-		children: [/* @__PURE__ */ W($, {}), l ? /* @__PURE__ */ W(m, {
+		children: [/* @__PURE__ */ U(se, {}), l ? /* @__PURE__ */ U(m, {
 			defaultLocale: "en",
 			translations: n ?? {
 				en: {},
@@ -196,16 +212,16 @@ function oe({ children: e, i18nProductId: t, fallbackTranslations: n, defaultBra
 			},
 			showChildrenWhileLoading: !0,
 			children: d
-		}) : /* @__PURE__ */ W(C, {
+		}) : /* @__PURE__ */ U(w, {
 			i18nProductId: t,
 			fallbackTranslations: n,
 			children: d
 		})]
 	});
 }
-function $() {
-	let e = K();
-	return B(() => {
+function se() {
+	let e = G();
+	return z(() => {
 		e.hash || requestAnimationFrame(() => {
 			window.scrollTo({
 				top: 0,
@@ -223,7 +239,7 @@ function $() {
 		e.hash
 	]), null;
 }
-function se(e) {
+function ce(e) {
 	if (e instanceof Error) return e.message;
 	if (typeof e == "string") return e;
 	try {
@@ -232,9 +248,9 @@ function se(e) {
 		return String(e);
 	}
 }
-function ce() {
-	let e = M(), t = K(), n = H(void 0), r = H(void 0);
-	return B(() => {
+function le() {
+	let e = j(), t = G(), n = V(void 0), r = V(void 0);
+	return z(() => {
 		let i = `${t.pathname}${t.search}${t.hash}`;
 		r.current !== i && (e.emit("nav.route.changed", {
 			pathname: t.pathname,
@@ -248,7 +264,7 @@ function ce() {
 		t.hash,
 		t.pathname,
 		t.search
-	]), B(() => {
+	]), z(() => {
 		let t = (t) => {
 			e.emit("error.runtime.caught", {
 				message: t.message || "Runtime error",
@@ -258,27 +274,27 @@ function ce() {
 				errorName: t.error instanceof Error ? t.error.name : void 0
 			});
 		}, n = (t) => {
-			e.emit("error.unhandledrejection", { reason: se(t.reason) });
+			e.emit("error.unhandledrejection", { reason: ce(t.reason) });
 		};
 		return window.addEventListener("error", t), window.addEventListener("unhandledrejection", n), () => {
 			window.removeEventListener("error", t), window.removeEventListener("unhandledrejection", n);
 		};
-	}, [e]), B(() => {
-		b((t) => {
+	}, [e]), z(() => {
+		x((t) => {
 			e.emit("perf.lcp.measured", {
 				metric: "LCP",
 				value: t.value,
 				id: t.id,
 				rating: t.rating
 			});
-		}), S((t) => {
+		}), C((t) => {
 			e.emit("perf.cls.measured", {
 				metric: "CLS",
 				value: t.value,
 				id: t.id,
 				rating: t.rating
 			});
-		}), x((t) => {
+		}), S((t) => {
 			e.emit("perf.inp.measured", {
 				metric: "INP",
 				value: t.value,
@@ -288,27 +304,27 @@ function ce() {
 		});
 	}, [e]), null;
 }
-function le({ config: e, productSlug: t }) {
-	return /* @__PURE__ */ G(U, { children: [/* @__PURE__ */ W(ce, {}), e.enabled === !1 ? null : /* @__PURE__ */ G(U, { children: [
-		e.devtools ? /* @__PURE__ */ W(E, { enabled: !0 }) : null,
-		e.broadcast === !1 ? null : /* @__PURE__ */ W(D, {}),
-		e.backendAudit?.enabled && e.backendAudit.endpoint ? /* @__PURE__ */ W(O, { endpoint: e.backendAudit.endpoint }) : null,
-		e.rybbit?.enabled && e.rybbit.siteId ? /* @__PURE__ */ W(k, {
+function ue({ config: e, productSlug: t }) {
+	return /* @__PURE__ */ W(H, { children: [/* @__PURE__ */ U(le, {}), e.enabled === !1 ? null : /* @__PURE__ */ W(H, { children: [
+		e.devtools ? /* @__PURE__ */ U(E, { enabled: !0 }) : null,
+		e.broadcast === !1 ? null : /* @__PURE__ */ U(D, {}),
+		e.backendAudit?.enabled && e.backendAudit.endpoint ? /* @__PURE__ */ U(O, { endpoint: e.backendAudit.endpoint }) : null,
+		e.rybbit?.enabled && e.rybbit.siteId ? /* @__PURE__ */ U(k, {
 			siteId: e.rybbit.siteId,
 			scriptUrl: e.rybbit.scriptUrl,
 			allowlist: e.rybbit.allowlist,
 			identifyOn: e.rybbit.identifyOn,
 			rename: e.rybbit.rename
 		}) : null,
-		e.otel?.enabled && e.otel.endpoint ? /* @__PURE__ */ W(A, {
+		e.otel?.enabled && e.otel.endpoint ? /* @__PURE__ */ U(A, {
 			endpoint: e.otel.endpoint,
 			serviceName: e.otel.serviceName ?? `${t}-app`,
 			flushInterval: e.otel.flushInterval
 		}) : null
 	] })] });
 }
-function ue({ config: u, children: p, clearAuthStore: m }) {
-	let { productName: h, productSlug: g = h.toLowerCase().replace(/\s+/g, ""), tagline: _ = "", domain: v, i18nProductId: b, gatewayUrls: x, authBridge: S, defaultBrand: C = "default", enablePWA: w = !0, brandInitial: E = h.charAt(0), defaultGateway: D = "workspace", enableSubscriptions: O = !0, fallbackTranslations: k, queryClientOptions: A, toasterPosition: M = "bottom-right", observability: N } = u, P = N ?? Z(g, ae()), F = V(() => ({
+function de({ config: u, children: p, clearAuthStore: m }) {
+	let { productName: h, productSlug: g = h.toLowerCase().replace(/\s+/g, ""), tagline: _ = "", domain: v, i18nProductId: x, gatewayUrls: S, authBridge: C, defaultBrand: w = "default", enablePWA: T = !0, brandInitial: E = h.charAt(0), defaultGateway: D = "workspace", enableSubscriptions: O = !0, fallbackTranslations: k, queryClientOptions: A, toasterPosition: j = "bottom-right", observability: M } = u, N = M ?? Q(g, ae()), P = B(() => ({
 		productName: h,
 		productSlug: g,
 		brandInitial: E,
@@ -320,7 +336,7 @@ function ue({ config: u, children: p, clearAuthStore: m }) {
 		E,
 		_,
 		v
-	]), I = H(!1), L = H(!1), R = H(null), U = H(!!S?.url), K = z(() => {
+	]), F = V(!1), I = V(!1), L = V(null), H = V(!!C?.url), G = R(() => {
 		if ((() => {
 			try {
 				let e = sessionStorage.getItem("bf-active-profile");
@@ -330,61 +346,61 @@ function ue({ config: u, children: p, clearAuthStore: m }) {
 			} catch {
 				return !1;
 			}
-		})() || U.current || I.current) return;
-		I.current = !0, i(m);
+		})() || H.current || F.current) return;
+		F.current = !0, i(m);
 		let t = `${window.location.pathname}${window.location.search}`, n = `/auth/login?reason=session-expired&returnTo=${encodeURIComponent(t)}`, r = /^\/vibecontrols\/(share|deck)\//.test(window.location.pathname);
 		if (window.location.pathname.startsWith("/auth/") || e(window.location.pathname) || r) {
-			I.current = !1;
+			F.current = !1;
 			return;
 		}
 		window.location.replace(n);
-	}, [m]), q = V(() => ({
-		globalBaseUrl: x.globalBaseUrl,
-		isRefreshing: L,
-		refreshPromise: R
-	}), [x.globalBaseUrl]), J = z(async () => r(q), [q]), Y = z(async () => {
-		window.location.pathname.startsWith("/auth/") || await J() || K();
-	}, [J, K]), X = z(async (e) => {
-		a(e) ? await J() || K() : console.error("[Network] Backend unreachable:", e.message);
-	}, [J, K]), Q = z(() => t("organization"), []), $ = V(() => new re({ defaultOptions: { queries: {
+	}, [m]), K = B(() => ({
+		globalBaseUrl: S.globalBaseUrl,
+		isRefreshing: I,
+		refreshPromise: L
+	}), [S.globalBaseUrl]), J = R(async () => r(K), [K]), Y = R(async () => {
+		window.location.pathname.startsWith("/auth/") || await J() || G();
+	}, [J, G]), X = R(async (e) => {
+		a(e) ? await J() || G() : console.error("[Network] Backend unreachable:", e.message);
+	}, [J, G]), Z = R(() => t("organization"), []), $ = B(() => new ie({ defaultOptions: { queries: {
 		staleTime: A?.staleTime ?? 300 * 1e3,
 		retry: A?.retry ?? 1,
 		refetchOnWindowFocus: A?.refetchOnWindowFocus ?? !1
 	} } }), [A]);
-	return B(() => {
+	return z(() => {
 		let e = c.getInstance();
 		e.getLogger("shell") || e.getLogger("shell").addTransport(new l());
-	}, []), /* @__PURE__ */ W(T, {
-		value: F,
-		children: /* @__PURE__ */ W(j, {
+	}, []), /* @__PURE__ */ U(te, {
+		value: P,
+		children: /* @__PURE__ */ U(ne, {
 			appName: g,
-			appVersion: P.appVersion,
-			appEnv: P.appEnv,
+			appVersion: N.appVersion,
+			appEnv: N.appEnv,
 			sourceMfe: g,
-			children: /* @__PURE__ */ W(f, {
+			children: /* @__PURE__ */ U(f, {
 				FallbackComponent: d,
-				children: /* @__PURE__ */ G(ne, { children: [/* @__PURE__ */ W(le, {
-					config: P,
+				children: /* @__PURE__ */ W(re, { children: [/* @__PURE__ */ U(ue, {
+					config: N,
 					productSlug: g
-				}), /* @__PURE__ */ W(ie, {
+				}), /* @__PURE__ */ U(q, {
 					client: $,
-					children: /* @__PURE__ */ W(ee, { children: /* @__PURE__ */ W(te, {
-						workspaceBaseUrl: x.workspaceBaseUrl,
-						globalBaseUrl: x.globalBaseUrl,
-						organizationId: Q,
+					children: /* @__PURE__ */ U(y, { children: /* @__PURE__ */ U(b, {
+						workspaceBaseUrl: S.workspaceBaseUrl,
+						globalBaseUrl: S.globalBaseUrl,
+						organizationId: Z,
 						defaultGateway: D,
 						enableSubscriptions: O,
 						onAuthError: Y,
 						onNetworkError: X,
 						onRefreshToken: J,
-						children: /* @__PURE__ */ W(o, {
-							bridgeUrl: S?.url,
-							bridgeAllowedOrigins: S?.allowedOrigins,
-							bridgeDebug: S?.debug,
+						children: /* @__PURE__ */ U(o, {
+							bridgeUrl: C?.url,
+							bridgeAllowedOrigins: C?.allowedOrigins,
+							bridgeDebug: C?.debug,
 							onRefreshToken: async (e) => {
 								let t = await n({
 									gateway: "global",
-									baseUrl: x.globalBaseUrl,
+									baseUrl: S.globalBaseUrl,
 									authToken: "",
 									query: "mutation RefreshToken($token: String!) {\n                      refreshToken(token: $token) {\n                        accessToken\n                        refreshToken\n                        expiresIn\n                      }\n                    }",
 									variables: { token: e }
@@ -398,24 +414,24 @@ function ue({ config: u, children: p, clearAuthStore: m }) {
 								};
 							},
 							onBridgeReady: () => {
-								U.current = !1;
+								H.current = !1;
 							},
 							onSessionExpiringSoon: () => {
 								console.warn("[Auth] Session will expire in 5 minutes");
 							},
 							onTokenExpired: () => {
-								K();
+								G();
 							},
-							children: /* @__PURE__ */ W(s, {
+							children: /* @__PURE__ */ U(s, {
 								syncToUrl: !0,
-								children: /* @__PURE__ */ W(y, { children: /* @__PURE__ */ W(oe, {
-									i18nProductId: b,
+								children: /* @__PURE__ */ U(ee, { children: /* @__PURE__ */ U(oe, {
+									i18nProductId: x,
 									fallbackTranslations: k,
-									defaultBrand: C,
+									defaultBrand: w,
 									productName: h,
 									brandInitial: E,
-									enablePWA: w,
-									toasterPosition: M,
+									enablePWA: T,
+									toasterPosition: j,
 									children: p
 								}) })
 							})
@@ -427,4 +443,4 @@ function ue({ config: u, children: p, clearAuthStore: m }) {
 	});
 }
 //#endregion
-export { ue as AppShellProvider, Z as resolveAppShellObservabilityConfig };
+export { de as AppShellProvider, Q as resolveAppShellObservabilityConfig };

package/dist/storage/SaveToFilesButton.d.ts

@@ -0,0 +1,55 @@
+import { SavedFile } from './useSaveToFiles';
+/** Two shapes — pick one based on where the bytes come from. */
+export type SaveToFilesSource = {
+    kind: 'blob';
+    /**
+     * Producer thunk. Returning `null` cleanly aborts the save (e.g. user
+     * cancelled a downstream confirm). Producers MAY override the filename
+     * and mime type at runtime (useful when the bytes carry metadata only
+     * known after a slow GraphQL call resolves).
+     */
+    getBlob: () => Promise<{
+        blob: Blob;
+        filename?: string;
+        mimeType?: string;
+    } | null>;
+    /** Default filename — used by the browser-download path. */
+    filename: string;
+    /** Default MIME type — used by the browser-download path. */
+    mimeType: string;
+} | {
+    kind: 'sandbox-artifact';
+    sandboxId: string;
+    sessionId: string;
+    /** Artifact path inside the sandbox session. */
+    path: string;
+    /** Optional override; otherwise the sandbox's reported filename wins. */
+    filename?: string;
+};
+interface Props {
+    source: SaveToFilesSource;
+    /**
+     * Pre-selected destination folder path. The dialog will lazily create
+     * missing ancestors via `ensureFolderByPath` on submit. The user can edit
+     * the path in the dialog.
+     */
+    defaultFolderPath?: string;
+    /**
+     * Browser-download action. Called when the user clicks the primary button.
+     * SaveToFilesButton does not implement the download itself — callers may
+     * have specialised tracking, anti-flood, or transformation logic.
+     */
+    onDownload: () => void | Promise<void>;
+    /** Called after a successful Save to Files. */
+    onSaved?: (file: SavedFile) => void;
+    /** Primary button label. Default "Download". */
+    label?: string;
+    disabled?: boolean;
+    /** ARIA-style test ID prefix; defaults to `save-to-files`. */
+    testId?: string;
+    /** Pass-through className for the outer wrapper. */
+    className?: string;
+}
+export declare function SaveToFilesButton({ source, defaultFolderPath, onDownload, onSaved, label, disabled, testId, className, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SaveToFilesButton.d.ts.map

package/dist/storage/SaveToFilesButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaveToFilesButton.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesButton.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpF,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,UAAU,KAAK;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,KAAkB,EAClB,QAAQ,EACR,MAAwB,EACxB,SAAS,GACV,EAAE,KAAK,2CAsDP"}

package/dist/storage/SaveToFilesButton.js

@@ -0,0 +1,56 @@
+import { Button as e } from "../ui/button.js";
+import { DropdownMenu as t, DropdownMenuContent as n, DropdownMenuItem as r, DropdownMenuTrigger as i } from "../ui/dropdown-menu.js";
+import { SaveToFilesDialog as a } from "./SaveToFilesDialog.js";
+import { useState as o } from "react";
+import { Download as s, FolderInput as c } from "lucide-react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/storage/SaveToFilesButton.tsx
+function f(e) {
+	return e.kind === "blob" ? e.filename : e.filename ?? e.path.split("/").filter(Boolean).pop() ?? "artifact";
+}
+function p({ source: p, defaultFolderPath: m, onDownload: h, onSaved: g, label: _ = "Download", disabled: v, testId: y = "save-to-files", className: b }) {
+	let [x, S] = o(!1), C = f(p);
+	return /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ d("div", {
+		className: `inline-flex items-center ${b ?? ""}`,
+		children: [/* @__PURE__ */ d(e, {
+			variant: "outline",
+			size: "sm",
+			disabled: v,
+			onClick: () => void h(),
+			"data-testid": `${y}-download`,
+			className: "rounded-r-none",
+			children: [/* @__PURE__ */ u(s, { className: "mr-1.5 h-3.5 w-3.5" }), _]
+		}), /* @__PURE__ */ d(t, { children: [/* @__PURE__ */ u(i, {
+			asChild: !0,
+			children: /* @__PURE__ */ u(e, {
+				variant: "outline",
+				size: "sm",
+				disabled: v,
+				"aria-label": "More save actions",
+				"data-testid": `${y}-menu`,
+				className: "rounded-l-none border-l-0 px-2",
+				children: "▾"
+			})
+		}), /* @__PURE__ */ d(n, {
+			align: "end",
+			children: [/* @__PURE__ */ d(r, {
+				onSelect: () => void h(),
+				"data-testid": `${y}-menu-download`,
+				children: [/* @__PURE__ */ u(s, { className: "mr-2 h-3.5 w-3.5" }), "Download"]
+			}), /* @__PURE__ */ d(r, {
+				onSelect: () => S(!0),
+				"data-testid": `${y}-menu-save`,
+				children: [/* @__PURE__ */ u(c, { className: "mr-2 h-3.5 w-3.5" }), "Save to Files…"]
+			})]
+		})] })]
+	}), /* @__PURE__ */ u(a, {
+		open: x,
+		onOpenChange: S,
+		source: p,
+		defaultFolderPath: m,
+		filename: C,
+		onSaved: g
+	})] });
+}
+//#endregion
+export { p as SaveToFilesButton };

package/dist/storage/SaveToFilesDialog.d.ts

@@ -0,0 +1,13 @@
+import { SaveToFilesSource } from './SaveToFilesButton';
+import { SavedFile } from './useSaveToFiles';
+interface Props {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    source: SaveToFilesSource;
+    defaultFolderPath?: string;
+    filename: string;
+    onSaved?: (file: SavedFile) => void;
+}
+export declare function SaveToFilesDialog({ open, onOpenChange, source, defaultFolderPath, filename, onSaved }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SaveToFilesDialog.d.ts.map

package/dist/storage/SaveToFilesDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaveToFilesDialog.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesDialog.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,2CAqF5G"}