@ttt-productions/upload-ui 0.7.17 → 0.7.18

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,4 +1,2 @@
-// Server-safe entry: no React. React code lives at `@ttt-productions/upload-ui/react/guard`,
-// `/react/upload`, and `/react/tray`.
 export { formatFileSize, createUploadDisplayFormatters } from './upload-display.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["// Server-safe entry: no React. React code lives at `@ttt-productions/upload-ui/react/guard`,\n// `/react/upload`, and `/react/tray`.\nexport { formatFileSize, createUploadDisplayFormatters } from './upload-display.js';\nexport type {\n  UploadDisplayCopy,\n  UploadDisplayConfig,\n  UploadDisplayFormatters,\n} from './upload-display.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export { formatFileSize, createUploadDisplayFormatters } from './upload-display.js';\nexport type {\n  UploadDisplayCopy,\n  UploadDisplayConfig,\n  UploadDisplayFormatters,\n} from './upload-display.js';\n"]}

package/dist/react/guard/guarded-link.d.ts

@@ -1,33 +1,6 @@
-/**
- * Render-prop link wrapper that guards navigation while an upload or unsaved
- * work is registered. The consumer owns the actual navigator component (Next.js Link,
- * React Router Link, plain anchor, etc.) — this wrapper only injects the
- * onClick interceptor.
- *
- * Why render-prop and not `as={Link}`? Polymorphic `as` props create
- * notoriously bad TypeScript inference and force the wrapper to forward all
- * link-specific props. Render-prop keeps the consumer in full control of the
- * link API, costs one extra wrapper closure, and keeps upload-ui agnostic of
- * Next.js / React Router / etc.
- *
- * Design note: the design spec lists `<GuardedNavigationButton>` as a second
- * component. We deliberately don't ship it — buttons that navigate use
- * `useGuardedNavigation()` directly in one line. A second component would
- * split the same surface for no payoff.
- *
- * Usage:
- *
- *     <GuardedLink renderLink={({ onClick, children }) => (
- *       <Link href="/your/destination" onClick={onClick}>{children}</Link>
- *     )}>
- *       View all uploads →
- *     </GuardedLink>
- */
 import type { MouseEvent, ReactNode } from 'react';
 export interface GuardedLinkRenderArgs {
-    /** Click handler the consumer MUST attach to its underlying link element. */
     onClick: (event: MouseEvent<HTMLElement>) => void;
-    /** The children passed to `<GuardedLink>` — forward them to the link. */
     children: ReactNode;
 }
 export interface GuardedLinkProps {

package/dist/react/guard/guarded-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guarded-link.d.ts","sourceRoot":"","sources":["../../../src/react/guard/guarded-link.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAClD,yEAAyE;IACzE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,SAAS,CAAC;CACxD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAWlD"}
+{"version":3,"file":"guarded-link.d.ts","sourceRoot":"","sources":["../../../src/react/guard/guarded-link.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,SAAS,CAAC;CACxD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAWlD"}

package/dist/react/guard/guarded-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"guarded-link.js","sourceRoot":"","sources":["../../../src/react/guard/guarded-link.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA6Bb,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAcvE,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAG,CAAC,KAA8B,EAAE,EAAE;QACjD,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,4BAAG,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAI,CAAC;AAClD,CAAC","sourcesContent":["'use client';\n\n/**\n * Render-prop link wrapper that guards navigation while an upload or unsaved\n * work is registered. The consumer owns the actual navigator component (Next.js Link,\n * React Router Link, plain anchor, etc.) — this wrapper only injects the\n * onClick interceptor.\n *\n * Why render-prop and not `as={Link}`? Polymorphic `as` props create\n * notoriously bad TypeScript inference and force the wrapper to forward all\n * link-specific props. Render-prop keeps the consumer in full control of the\n * link API, costs one extra wrapper closure, and keeps upload-ui agnostic of\n * Next.js / React Router / etc.\n *\n * Design note: the design spec lists `<GuardedNavigationButton>` as a second\n * component. We deliberately don't ship it — buttons that navigate use\n * `useGuardedNavigation()` directly in one line. A second component would\n * split the same surface for no payoff.\n *\n * Usage:\n *\n *     <GuardedLink renderLink={({ onClick, children }) => (\n *       <Link href=\"/your/destination\" onClick={onClick}>{children}</Link>\n *     )}>\n *       View all uploads →\n *     </GuardedLink>\n */\n\nimport type { MouseEvent, ReactNode } from 'react';\nimport { useLocalUploadGuard } from './local-upload-guard-provider.js';\n\nexport interface GuardedLinkRenderArgs {\n  /** Click handler the consumer MUST attach to its underlying link element. */\n  onClick: (event: MouseEvent<HTMLElement>) => void;\n  /** The children passed to `<GuardedLink>` — forward them to the link. */\n  children: ReactNode;\n}\n\nexport interface GuardedLinkProps {\n  children: ReactNode;\n  renderLink: (args: GuardedLinkRenderArgs) => ReactNode;\n}\n\nexport function GuardedLink(props: GuardedLinkProps) {\n  const { children, renderLink } = props;\n  const { confirmNavigation } = useLocalUploadGuard();\n\n  const onClick = (event: MouseEvent<HTMLElement>) => {\n    if (!confirmNavigation()) {\n      event.preventDefault();\n    }\n  };\n\n  return <>{renderLink({ onClick, children })}</>;\n}\n"]}
+{"version":3,"file":"guarded-link.js","sourceRoot":"","sources":["../../../src/react/guard/guarded-link.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAYvE,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAG,CAAC,KAA8B,EAAE,EAAE;QACjD,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,4BAAG,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAI,CAAC;AAClD,CAAC","sourcesContent":["'use client';\n\nimport type { MouseEvent, ReactNode } from 'react';\nimport { useLocalUploadGuard } from './local-upload-guard-provider.js';\n\nexport interface GuardedLinkRenderArgs {\n  onClick: (event: MouseEvent<HTMLElement>) => void;\n  children: ReactNode;\n}\n\nexport interface GuardedLinkProps {\n  children: ReactNode;\n  renderLink: (args: GuardedLinkRenderArgs) => ReactNode;\n}\n\nexport function GuardedLink(props: GuardedLinkProps) {\n  const { children, renderLink } = props;\n  const { confirmNavigation } = useLocalUploadGuard();\n\n  const onClick = (event: MouseEvent<HTMLElement>) => {\n    if (!confirmNavigation()) {\n      event.preventDefault();\n    }\n  };\n\n  return <>{renderLink({ onClick, children })}</>;\n}\n"]}

package/dist/react/guard/local-upload-guard-provider.d.ts

@@ -1,110 +1,29 @@
-/**
- * The navigation and leave guard: warns before the user leaves while work that leaving would lose
- * is registered — a LOCAL byte upload in flight, or an editor's unsaved input.
- *
- * Uploads: phases `preparing` and `uploading` only. `finalizing` and backend `pendingMedia`
- * processing are safe to leave (the bytes are already in Storage), so they are not registered.
- * Unsaved work: an editor registers while it holds input its user has not saved, and unregisters
- * when the input is saved, discarded, or the editor unmounts.
- *
- * While anything is registered the provider installs ONE `beforeunload` listener (tab close,
- * reload, full-page navigation), and `confirmNavigation()` asks before an in-app navigation. It is
- * the one leave guard: an editor never installs its own `beforeunload` handler (FRONTEND-207).
- *
- * Consumers register with a stable id per piece of work; registering a registered id, or
- * unregistering an absent one, is a no-op. Uploads and unsaved work are counted separately, so the
- * same id may be both.
- */
 import { type ReactNode } from 'react';
 export interface ConfirmNavigationOptions {
-    /**
-     * The caller leaves through a FULL-PAGE navigation (`location.assign` /
-     * `location.replace`) once this returns true. The provider then lets that
-     * navigation's next `beforeunload` pass without the browser's own
-     * "Leave site?" prompt, because the user has just answered this one. Soft
-     * (in-app router) navigations never pass it: they fire no `beforeunload`.
-     */
     fullPageNavigation?: boolean;
 }
 interface LocalUploadGuardContextValue {
-    /** Registered local uploads. */
     activeUploadCount: number;
-    /** Registered pieces of unsaved work. */
     unsavedWorkCount: number;
-    /** Everything the guard warns about: uploads plus unsaved work. Zero means leaving asks nothing. */
     guardedWorkCount: number;
     registerUpload: (id: string) => void;
     unregisterUpload: (id: string) => void;
     registerUnsavedWork: (id: string) => void;
     unregisterUnsavedWork: (id: string) => void;
-    /** Returns true iff an upload or unsaved work is currently registered. Pure read. */
     shouldConfirmNavigation: () => boolean;
-    /**
-     * Shows a confirm() dialog with the message for what is registered and returns the user's
-     * choice. Safe to call when nothing is registered — returns true without prompting.
-     *
-     * With `{ fullPageNavigation: true }` and a result of true (confirmed, or nothing registered),
-     * arms a ONE-SHOT bypass: the next `beforeunload` is not prevented, so a confirmed full-page
-     * navigation does not prompt twice. A declined confirm never arms it; the bypass is cleared when
-     * it is consumed, when new work (an upload or unsaved work) registers, and on `pageshow` (a
-     * back/forward-cache return).
-     */
     confirmNavigation: (options?: ConfirmNavigationOptions) => boolean;
 }
 export interface LocalUploadGuardProviderProps {
-    /**
-     * Message the browser is given when the user closes the tab, reloads, or leaves the page while
-     * work is registered. Modern browsers show their own generic dialog and ignore it; when omitted,
-     * the default for what is registered is used.
-     */
     beforeUnloadMessage?: string;
-    /** `confirmNavigation()`'s message while an upload is in progress (and no unsaved work). */
     navigationConfirmMessage?: string;
-    /** `confirmNavigation()`'s message while unsaved work is registered (and no upload). */
     unsavedWorkConfirmMessage?: string;
-    /** `confirmNavigation()`'s message while both an upload and unsaved work are registered. */
     uploadAndUnsavedWorkConfirmMessage?: string;
     children: ReactNode;
 }
 export declare function LocalUploadGuardProvider(props: LocalUploadGuardProviderProps): import("react").JSX.Element;
-/**
- * Low-level accessor for the guard context. Throws if used outside a
- * `LocalUploadGuardProvider`. Most consumers should use `useLocalUploadGuard`
- * (the public re-export below) instead.
- */
 export declare function useLocalUploadGuardContext(): LocalUploadGuardContextValue;
-/**
- * Optional accessor: returns the guard context, or `null` when rendered
- * outside a `LocalUploadGuardProvider`. For package components (e.g. the
- * chat composer registering an in-flight send) that must degrade gracefully
- * in consumers that don't mount the provider, instead of throwing.
- */
 export declare function useOptionalLocalUploadGuard(): LocalUploadGuardContextValue | null;
-/**
- * Public hook for the navigation and leave guard.
- *
- * Typical usage in an upload flow:
- *
- *     const { registerUpload, unregisterUpload } = useLocalUploadGuard();
- *     useEffect(() => {
- *       if (phase === 'preparing' || phase === 'uploading') {
- *         registerUpload(uploadId);
- *         return () => unregisterUpload(uploadId);
- *       }
- *     }, [phase, uploadId, registerUpload, unregisterUpload]);
- *
- * An editor holding input uses `useUnsavedWorkGuard(hasUnsavedWork)` instead.
- */
 export declare function useLocalUploadGuard(): LocalUploadGuardContextValue;
-/**
- * Registers the calling editor's unsaved input with the leave guard while `hasUnsavedWork` is
- * true, and unregisters it when that turns false or the editor unmounts. While registered, closing
- * the tab, reloading, a full-page navigation, and every guarded in-app navigation ask first.
- * Throws outside a `LocalUploadGuardProvider`.
- *
- * Returns `release`, which unregisters at once: an editor that saves and then navigates in the
- * same handler calls it after the save, because its dirty flag clears only on the next render.
- */
 export declare function useUnsavedWorkGuard(hasUnsavedWork: boolean): {
     release: () => void;
 };

package/dist/react/guard/local-upload-guard-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-upload-guard-provider.d.ts","sourceRoot":"","sources":["../../../src/react/guard/local-upload-guard-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,4BAA4B;IACpC,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,qFAAqF;IACrF,uBAAuB,EAAE,MAAM,OAAO,CAAC;IACvC;;;;;;;;;OASG;IACH,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC;CACpE;AAID,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4FAA4F;IAC5F,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wFAAwF;IACxF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4FAA4F;IAC5F,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAoCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,+BAkH5E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,4BAA4B,CAMzE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAEjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAUpF"}
+{"version":3,"file":"local-upload-guard-provider.d.ts","sourceRoot":"","sources":["../../../src/react/guard/local-upload-guard-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,4BAA4B;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,uBAAuB,EAAE,MAAM,OAAO,CAAC;IACvC,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC;CACpE;AAID,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAoCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,+BA6G5E;AAED,wBAAgB,0BAA0B,IAAI,4BAA4B,CAMzE;AAED,wBAAgB,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAEjF;AAED,wBAAgB,mBAAmB,IAAI,4BAA4B,CAElE;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAUpF"}

package/dist/react/guard/local-upload-guard-provider.js

@@ -1,22 +1,5 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * The navigation and leave guard: warns before the user leaves while work that leaving would lose
- * is registered — a LOCAL byte upload in flight, or an editor's unsaved input.
- *
- * Uploads: phases `preparing` and `uploading` only. `finalizing` and backend `pendingMedia`
- * processing are safe to leave (the bytes are already in Storage), so they are not registered.
- * Unsaved work: an editor registers while it holds input its user has not saved, and unregisters
- * when the input is saved, discarded, or the editor unmounts.
- *
- * While anything is registered the provider installs ONE `beforeunload` listener (tab close,
- * reload, full-page navigation), and `confirmNavigation()` asks before an in-app navigation. It is
- * the one leave guard: an editor never installs its own `beforeunload` handler (FRONTEND-207).
- *
- * Consumers register with a stable id per piece of work; registering a registered id, or
- * unregistering an absent one, is a no-op. Uploads and unsaved work are counted separately, so the
- * same id may be both.
- */
 import { createContext, useCallback, useContext, useEffect, useId, useMemo, useRef, useState, } from 'react';
 const LocalUploadGuardContext = createContext(undefined);
 const DEFAULT_NAVIGATION_CONFIRM_MESSAGE = 'An upload is currently in progress. If you leave this page, the upload will be canceled. Continue?';
@@ -44,9 +27,7 @@ function useRegistry(onRegister) {
 }
 export function LocalUploadGuardProvider(props) {
     const { children, beforeUnloadMessage, navigationConfirmMessage = DEFAULT_NAVIGATION_CONFIRM_MESSAGE, unsavedWorkConfirmMessage = DEFAULT_UNSAVED_WORK_CONFIRM_MESSAGE, uploadAndUnsavedWorkConfirmMessage = DEFAULT_UPLOAD_AND_UNSAVED_WORK_CONFIRM_MESSAGE, } = props;
-    // One-shot: the user already confirmed the full-page navigation now unloading.
     const bypassNextUnloadRef = useRef(false);
-    // Also run when work registers: work that starts after a confirmation was not covered by it.
     const clearBypass = useCallback(() => {
         bypassNextUnloadRef.current = false;
     }, []);
@@ -56,7 +37,6 @@ export function LocalUploadGuardProvider(props) {
     const unsavedWorkIdsRef = unsavedWork.idsRef;
     const guardedWorkCount = uploads.count + unsavedWork.count;
     const hasGuardedWork = guardedWorkCount > 0;
-    // Read at the moment of asking, so a message always matches what is registered right then.
     const confirmMessage = useCallback(() => {
         const uploading = uploadIdsRef.current.size > 0;
         const unsaved = unsavedWorkIdsRef.current.size > 0;
@@ -79,8 +59,7 @@ export function LocalUploadGuardProvider(props) {
                 return;
             }
             event.preventDefault();
-            // Modern browsers may ignore the custom string and show their own generic confirmation;
-            // what matters is that leaving is warned, not the exact text.
+            // Modern browsers may ignore the custom string and show their own generic confirmation.
             event.returnValue =
                 beforeUnloadMessage ??
                     (uploadIdsRef.current.size > 0
@@ -93,8 +72,8 @@ export function LocalUploadGuardProvider(props) {
             window.removeEventListener('beforeunload', handleBeforeUnload);
         };
     }, [hasGuardedWork, beforeUnloadMessage, uploadIdsRef]);
-    // A back/forward-cache return re-shows this page without reloading it: an
-    // armed bypass from the navigation that left must never outlive that navigation.
+    // A back/forward-cache return re-shows this page without reloading it, so an armed bypass must not
+    // outlive the navigation that left.
     useEffect(() => {
         window.addEventListener('pageshow', clearBypass);
         return () => {
@@ -103,7 +82,6 @@ export function LocalUploadGuardProvider(props) {
     }, [clearBypass]);
     const shouldConfirmNavigation = useCallback(() => uploadIdsRef.current.size > 0 || unsavedWorkIdsRef.current.size > 0, [uploadIdsRef, unsavedWorkIdsRef]);
     const confirmNavigation = useCallback((options) => {
-        // SSR / non-browser safety: if `window` isn't available, default to allow.
         if (typeof window === 'undefined')
             return true;
         const proceed = !shouldConfirmNavigation() || window.confirm(confirmMessage());
@@ -134,11 +112,6 @@ export function LocalUploadGuardProvider(props) {
     ]);
     return (_jsx(LocalUploadGuardContext.Provider, { value: value, children: children }));
 }
-/**
- * Low-level accessor for the guard context. Throws if used outside a
- * `LocalUploadGuardProvider`. Most consumers should use `useLocalUploadGuard`
- * (the public re-export below) instead.
- */
 export function useLocalUploadGuardContext() {
     const ctx = useContext(LocalUploadGuardContext);
     if (ctx === undefined) {
@@ -146,42 +119,12 @@ export function useLocalUploadGuardContext() {
     }
     return ctx;
 }
-/**
- * Optional accessor: returns the guard context, or `null` when rendered
- * outside a `LocalUploadGuardProvider`. For package components (e.g. the
- * chat composer registering an in-flight send) that must degrade gracefully
- * in consumers that don't mount the provider, instead of throwing.
- */
 export function useOptionalLocalUploadGuard() {
     return useContext(LocalUploadGuardContext) ?? null;
 }
-/**
- * Public hook for the navigation and leave guard.
- *
- * Typical usage in an upload flow:
- *
- *     const { registerUpload, unregisterUpload } = useLocalUploadGuard();
- *     useEffect(() => {
- *       if (phase === 'preparing' || phase === 'uploading') {
- *         registerUpload(uploadId);
- *         return () => unregisterUpload(uploadId);
- *       }
- *     }, [phase, uploadId, registerUpload, unregisterUpload]);
- *
- * An editor holding input uses `useUnsavedWorkGuard(hasUnsavedWork)` instead.
- */
 export function useLocalUploadGuard() {
     return useLocalUploadGuardContext();
 }
-/**
- * Registers the calling editor's unsaved input with the leave guard while `hasUnsavedWork` is
- * true, and unregisters it when that turns false or the editor unmounts. While registered, closing
- * the tab, reloading, a full-page navigation, and every guarded in-app navigation ask first.
- * Throws outside a `LocalUploadGuardProvider`.
- *
- * Returns `release`, which unregisters at once: an editor that saves and then navigates in the
- * same handler calls it after the save, because its dirty flag clears only on the next render.
- */
 export function useUnsavedWorkGuard(hasUnsavedWork) {
     const { registerUnsavedWork, unregisterUnsavedWork } = useLocalUploadGuardContext();
     const id = useId();

package/dist/react/guard/local-upload-guard-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-upload-guard-provider.js","sourceRoot":"","sources":["../../../src/react/guard/local-upload-guard-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\n/**\n * The navigation and leave guard: warns before the user leaves while work that leaving would lose\n * is registered — a LOCAL byte upload in flight, or an editor's unsaved input.\n *\n * Uploads: phases `preparing` and `uploading` only. `finalizing` and backend `pendingMedia`\n * processing are safe to leave (the bytes are already in Storage), so they are not registered.\n * Unsaved work: an editor registers while it holds input its user has not saved, and unregisters\n * when the input is saved, discarded, or the editor unmounts.\n *\n * While anything is registered the provider installs ONE `beforeunload` listener (tab close,\n * reload, full-page navigation), and `confirmNavigation()` asks before an in-app navigation. It is\n * the one leave guard: an editor never installs its own `beforeunload` handler (FRONTEND-207).\n *\n * Consumers register with a stable id per piece of work; registering a registered id, or\n * unregistering an absent one, is a no-op. Uploads and unsaved work are counted separately, so the\n * same id may be both.\n */\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\n\nexport interface ConfirmNavigationOptions {\n  /**\n   * The caller leaves through a FULL-PAGE navigation (`location.assign` /\n   * `location.replace`) once this returns true. The provider then lets that\n   * navigation's next `beforeunload` pass without the browser's own\n   * \"Leave site?\" prompt, because the user has just answered this one. Soft\n   * (in-app router) navigations never pass it: they fire no `beforeunload`.\n   */\n  fullPageNavigation?: boolean;\n}\n\ninterface LocalUploadGuardContextValue {\n  /** Registered local uploads. */\n  activeUploadCount: number;\n  /** Registered pieces of unsaved work. */\n  unsavedWorkCount: number;\n  /** Everything the guard warns about: uploads plus unsaved work. Zero means leaving asks nothing. */\n  guardedWorkCount: number;\n  registerUpload: (id: string) => void;\n  unregisterUpload: (id: string) => void;\n  registerUnsavedWork: (id: string) => void;\n  unregisterUnsavedWork: (id: string) => void;\n  /** Returns true iff an upload or unsaved work is currently registered. Pure read. */\n  shouldConfirmNavigation: () => boolean;\n  /**\n   * Shows a confirm() dialog with the message for what is registered and returns the user's\n   * choice. Safe to call when nothing is registered — returns true without prompting.\n   *\n   * With `{ fullPageNavigation: true }` and a result of true (confirmed, or nothing registered),\n   * arms a ONE-SHOT bypass: the next `beforeunload` is not prevented, so a confirmed full-page\n   * navigation does not prompt twice. A declined confirm never arms it; the bypass is cleared when\n   * it is consumed, when new work (an upload or unsaved work) registers, and on `pageshow` (a\n   * back/forward-cache return).\n   */\n  confirmNavigation: (options?: ConfirmNavigationOptions) => boolean;\n}\n\nconst LocalUploadGuardContext = createContext<LocalUploadGuardContextValue | undefined>(undefined);\n\nexport interface LocalUploadGuardProviderProps {\n  /**\n   * Message the browser is given when the user closes the tab, reloads, or leaves the page while\n   * work is registered. Modern browsers show their own generic dialog and ignore it; when omitted,\n   * the default for what is registered is used.\n   */\n  beforeUnloadMessage?: string;\n  /** `confirmNavigation()`'s message while an upload is in progress (and no unsaved work). */\n  navigationConfirmMessage?: string;\n  /** `confirmNavigation()`'s message while unsaved work is registered (and no upload). */\n  unsavedWorkConfirmMessage?: string;\n  /** `confirmNavigation()`'s message while both an upload and unsaved work are registered. */\n  uploadAndUnsavedWorkConfirmMessage?: string;\n  children: ReactNode;\n}\n\nconst DEFAULT_NAVIGATION_CONFIRM_MESSAGE =\n  'An upload is currently in progress. If you leave this page, the upload will be canceled. Continue?';\nconst DEFAULT_UNSAVED_WORK_CONFIRM_MESSAGE =\n  'You have unsaved changes. If you leave this page, they will be lost. Continue?';\nconst DEFAULT_UPLOAD_AND_UNSAVED_WORK_CONFIRM_MESSAGE =\n  'An upload is in progress and you have unsaved changes. If you leave this page, the upload will be canceled and your changes will be lost. Continue?';\nconst DEFAULT_UPLOAD_BEFORE_UNLOAD_MESSAGE =\n  'File upload in progress. Are you sure you want to leave and end the file upload?';\nconst DEFAULT_UNSAVED_WORK_BEFORE_UNLOAD_MESSAGE =\n  'You have unsaved changes. Are you sure you want to leave and lose them?';\n\nfunction useRegistry(onRegister: () => void) {\n  const idsRef = useRef<Set<string>>(new Set());\n  const [count, setCount] = useState(0);\n\n  const register = useCallback(\n    (id: string) => {\n      if (idsRef.current.has(id)) return;\n      onRegister();\n      idsRef.current.add(id);\n      setCount(idsRef.current.size);\n    },\n    [onRegister],\n  );\n\n  const unregister = useCallback((id: string) => {\n    if (!idsRef.current.has(id)) return;\n    idsRef.current.delete(id);\n    setCount(idsRef.current.size);\n  }, []);\n\n  return { idsRef, count, register, unregister };\n}\n\nexport function LocalUploadGuardProvider(props: LocalUploadGuardProviderProps) {\n  const {\n    children,\n    beforeUnloadMessage,\n    navigationConfirmMessage = DEFAULT_NAVIGATION_CONFIRM_MESSAGE,\n    unsavedWorkConfirmMessage = DEFAULT_UNSAVED_WORK_CONFIRM_MESSAGE,\n    uploadAndUnsavedWorkConfirmMessage = DEFAULT_UPLOAD_AND_UNSAVED_WORK_CONFIRM_MESSAGE,\n  } = props;\n  // One-shot: the user already confirmed the full-page navigation now unloading.\n  const bypassNextUnloadRef = useRef(false);\n  // Also run when work registers: work that starts after a confirmation was not covered by it.\n  const clearBypass = useCallback(() => {\n    bypassNextUnloadRef.current = false;\n  }, []);\n\n  const uploads = useRegistry(clearBypass);\n  const unsavedWork = useRegistry(clearBypass);\n  const uploadIdsRef = uploads.idsRef;\n  const unsavedWorkIdsRef = unsavedWork.idsRef;\n  const guardedWorkCount = uploads.count + unsavedWork.count;\n  const hasGuardedWork = guardedWorkCount > 0;\n\n  // Read at the moment of asking, so a message always matches what is registered right then.\n  const confirmMessage = useCallback((): string => {\n    const uploading = uploadIdsRef.current.size > 0;\n    const unsaved = unsavedWorkIdsRef.current.size > 0;\n    if (uploading && unsaved) return uploadAndUnsavedWorkConfirmMessage;\n    return uploading ? navigationConfirmMessage : unsavedWorkConfirmMessage;\n  }, [\n    uploadIdsRef,\n    unsavedWorkIdsRef,\n    navigationConfirmMessage,\n    unsavedWorkConfirmMessage,\n    uploadAndUnsavedWorkConfirmMessage,\n  ]);\n\n  useEffect(() => {\n    if (!hasGuardedWork) return;\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent) => {\n      if (bypassNextUnloadRef.current) {\n        bypassNextUnloadRef.current = false;\n        return;\n      }\n      event.preventDefault();\n      // Modern browsers may ignore the custom string and show their own generic confirmation;\n      // what matters is that leaving is warned, not the exact text.\n      event.returnValue =\n        beforeUnloadMessage ??\n        (uploadIdsRef.current.size > 0\n          ? DEFAULT_UPLOAD_BEFORE_UNLOAD_MESSAGE\n          : DEFAULT_UNSAVED_WORK_BEFORE_UNLOAD_MESSAGE);\n      return event.returnValue;\n    };\n\n    window.addEventListener('beforeunload', handleBeforeUnload);\n    return () => {\n      window.removeEventListener('beforeunload', handleBeforeUnload);\n    };\n  }, [hasGuardedWork, beforeUnloadMessage, uploadIdsRef]);\n\n  // A back/forward-cache return re-shows this page without reloading it: an\n  // armed bypass from the navigation that left must never outlive that navigation.\n  useEffect(() => {\n    window.addEventListener('pageshow', clearBypass);\n    return () => {\n      window.removeEventListener('pageshow', clearBypass);\n    };\n  }, [clearBypass]);\n\n  const shouldConfirmNavigation = useCallback(\n    () => uploadIdsRef.current.size > 0 || unsavedWorkIdsRef.current.size > 0,\n    [uploadIdsRef, unsavedWorkIdsRef],\n  );\n\n  const confirmNavigation = useCallback(\n    (options?: ConfirmNavigationOptions): boolean => {\n      // SSR / non-browser safety: if `window` isn't available, default to allow.\n      if (typeof window === 'undefined') return true;\n      const proceed = !shouldConfirmNavigation() || window.confirm(confirmMessage());\n      if (proceed && options?.fullPageNavigation) bypassNextUnloadRef.current = true;\n      return proceed;\n    },\n    [shouldConfirmNavigation, confirmMessage],\n  );\n\n  const value = useMemo<LocalUploadGuardContextValue>(\n    () => ({\n      activeUploadCount: uploads.count,\n      unsavedWorkCount: unsavedWork.count,\n      guardedWorkCount,\n      registerUpload: uploads.register,\n      unregisterUpload: uploads.unregister,\n      registerUnsavedWork: unsavedWork.register,\n      unregisterUnsavedWork: unsavedWork.unregister,\n      shouldConfirmNavigation,\n      confirmNavigation,\n    }),\n    [\n      uploads.count,\n      uploads.register,\n      uploads.unregister,\n      unsavedWork.count,\n      unsavedWork.register,\n      unsavedWork.unregister,\n      guardedWorkCount,\n      shouldConfirmNavigation,\n      confirmNavigation,\n    ],\n  );\n\n  return (\n    <LocalUploadGuardContext.Provider value={value}>{children}</LocalUploadGuardContext.Provider>\n  );\n}\n\n/**\n * Low-level accessor for the guard context. Throws if used outside a\n * `LocalUploadGuardProvider`. Most consumers should use `useLocalUploadGuard`\n * (the public re-export below) instead.\n */\nexport function useLocalUploadGuardContext(): LocalUploadGuardContextValue {\n  const ctx = useContext(LocalUploadGuardContext);\n  if (ctx === undefined) {\n    throw new Error('useLocalUploadGuard must be used within LocalUploadGuardProvider');\n  }\n  return ctx;\n}\n\n/**\n * Optional accessor: returns the guard context, or `null` when rendered\n * outside a `LocalUploadGuardProvider`. For package components (e.g. the\n * chat composer registering an in-flight send) that must degrade gracefully\n * in consumers that don't mount the provider, instead of throwing.\n */\nexport function useOptionalLocalUploadGuard(): LocalUploadGuardContextValue | null {\n  return useContext(LocalUploadGuardContext) ?? null;\n}\n\n/**\n * Public hook for the navigation and leave guard.\n *\n * Typical usage in an upload flow:\n *\n *     const { registerUpload, unregisterUpload } = useLocalUploadGuard();\n *     useEffect(() => {\n *       if (phase === 'preparing' || phase === 'uploading') {\n *         registerUpload(uploadId);\n *         return () => unregisterUpload(uploadId);\n *       }\n *     }, [phase, uploadId, registerUpload, unregisterUpload]);\n *\n * An editor holding input uses `useUnsavedWorkGuard(hasUnsavedWork)` instead.\n */\nexport function useLocalUploadGuard(): LocalUploadGuardContextValue {\n  return useLocalUploadGuardContext();\n}\n\n/**\n * Registers the calling editor's unsaved input with the leave guard while `hasUnsavedWork` is\n * true, and unregisters it when that turns false or the editor unmounts. While registered, closing\n * the tab, reloading, a full-page navigation, and every guarded in-app navigation ask first.\n * Throws outside a `LocalUploadGuardProvider`.\n *\n * Returns `release`, which unregisters at once: an editor that saves and then navigates in the\n * same handler calls it after the save, because its dirty flag clears only on the next render.\n */\nexport function useUnsavedWorkGuard(hasUnsavedWork: boolean): { release: () => void } {\n  const { registerUnsavedWork, unregisterUnsavedWork } = useLocalUploadGuardContext();\n  const id = useId();\n  useEffect(() => {\n    if (!hasUnsavedWork) return;\n    registerUnsavedWork(id);\n    return () => unregisterUnsavedWork(id);\n  }, [hasUnsavedWork, id, registerUnsavedWork, unregisterUnsavedWork]);\n  const release = useCallback(() => unregisterUnsavedWork(id), [id, unregisterUnsavedWork]);\n  return useMemo(() => ({ release }), [release]);\n}\n"]}
+{"version":3,"file":"local-upload-guard-provider.js","sourceRoot":"","sources":["../../../src/react/guard/local-upload-guard-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\n\nexport interface ConfirmNavigationOptions {\n  fullPageNavigation?: boolean;\n}\n\ninterface LocalUploadGuardContextValue {\n  activeUploadCount: number;\n  unsavedWorkCount: number;\n  guardedWorkCount: number;\n  registerUpload: (id: string) => void;\n  unregisterUpload: (id: string) => void;\n  registerUnsavedWork: (id: string) => void;\n  unregisterUnsavedWork: (id: string) => void;\n  shouldConfirmNavigation: () => boolean;\n  confirmNavigation: (options?: ConfirmNavigationOptions) => boolean;\n}\n\nconst LocalUploadGuardContext = createContext<LocalUploadGuardContextValue | undefined>(undefined);\n\nexport interface LocalUploadGuardProviderProps {\n  beforeUnloadMessage?: string;\n  navigationConfirmMessage?: string;\n  unsavedWorkConfirmMessage?: string;\n  uploadAndUnsavedWorkConfirmMessage?: string;\n  children: ReactNode;\n}\n\nconst DEFAULT_NAVIGATION_CONFIRM_MESSAGE =\n  'An upload is currently in progress. If you leave this page, the upload will be canceled. Continue?';\nconst DEFAULT_UNSAVED_WORK_CONFIRM_MESSAGE =\n  'You have unsaved changes. If you leave this page, they will be lost. Continue?';\nconst DEFAULT_UPLOAD_AND_UNSAVED_WORK_CONFIRM_MESSAGE =\n  'An upload is in progress and you have unsaved changes. If you leave this page, the upload will be canceled and your changes will be lost. Continue?';\nconst DEFAULT_UPLOAD_BEFORE_UNLOAD_MESSAGE =\n  'File upload in progress. Are you sure you want to leave and end the file upload?';\nconst DEFAULT_UNSAVED_WORK_BEFORE_UNLOAD_MESSAGE =\n  'You have unsaved changes. Are you sure you want to leave and lose them?';\n\nfunction useRegistry(onRegister: () => void) {\n  const idsRef = useRef<Set<string>>(new Set());\n  const [count, setCount] = useState(0);\n\n  const register = useCallback(\n    (id: string) => {\n      if (idsRef.current.has(id)) return;\n      onRegister();\n      idsRef.current.add(id);\n      setCount(idsRef.current.size);\n    },\n    [onRegister],\n  );\n\n  const unregister = useCallback((id: string) => {\n    if (!idsRef.current.has(id)) return;\n    idsRef.current.delete(id);\n    setCount(idsRef.current.size);\n  }, []);\n\n  return { idsRef, count, register, unregister };\n}\n\nexport function LocalUploadGuardProvider(props: LocalUploadGuardProviderProps) {\n  const {\n    children,\n    beforeUnloadMessage,\n    navigationConfirmMessage = DEFAULT_NAVIGATION_CONFIRM_MESSAGE,\n    unsavedWorkConfirmMessage = DEFAULT_UNSAVED_WORK_CONFIRM_MESSAGE,\n    uploadAndUnsavedWorkConfirmMessage = DEFAULT_UPLOAD_AND_UNSAVED_WORK_CONFIRM_MESSAGE,\n  } = props;\n  const bypassNextUnloadRef = useRef(false);\n  const clearBypass = useCallback(() => {\n    bypassNextUnloadRef.current = false;\n  }, []);\n\n  const uploads = useRegistry(clearBypass);\n  const unsavedWork = useRegistry(clearBypass);\n  const uploadIdsRef = uploads.idsRef;\n  const unsavedWorkIdsRef = unsavedWork.idsRef;\n  const guardedWorkCount = uploads.count + unsavedWork.count;\n  const hasGuardedWork = guardedWorkCount > 0;\n\n  const confirmMessage = useCallback((): string => {\n    const uploading = uploadIdsRef.current.size > 0;\n    const unsaved = unsavedWorkIdsRef.current.size > 0;\n    if (uploading && unsaved) return uploadAndUnsavedWorkConfirmMessage;\n    return uploading ? navigationConfirmMessage : unsavedWorkConfirmMessage;\n  }, [\n    uploadIdsRef,\n    unsavedWorkIdsRef,\n    navigationConfirmMessage,\n    unsavedWorkConfirmMessage,\n    uploadAndUnsavedWorkConfirmMessage,\n  ]);\n\n  useEffect(() => {\n    if (!hasGuardedWork) return;\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent) => {\n      if (bypassNextUnloadRef.current) {\n        bypassNextUnloadRef.current = false;\n        return;\n      }\n      event.preventDefault();\n      // Modern browsers may ignore the custom string and show their own generic confirmation.\n      event.returnValue =\n        beforeUnloadMessage ??\n        (uploadIdsRef.current.size > 0\n          ? DEFAULT_UPLOAD_BEFORE_UNLOAD_MESSAGE\n          : DEFAULT_UNSAVED_WORK_BEFORE_UNLOAD_MESSAGE);\n      return event.returnValue;\n    };\n\n    window.addEventListener('beforeunload', handleBeforeUnload);\n    return () => {\n      window.removeEventListener('beforeunload', handleBeforeUnload);\n    };\n  }, [hasGuardedWork, beforeUnloadMessage, uploadIdsRef]);\n\n  // A back/forward-cache return re-shows this page without reloading it, so an armed bypass must not\n  // outlive the navigation that left.\n  useEffect(() => {\n    window.addEventListener('pageshow', clearBypass);\n    return () => {\n      window.removeEventListener('pageshow', clearBypass);\n    };\n  }, [clearBypass]);\n\n  const shouldConfirmNavigation = useCallback(\n    () => uploadIdsRef.current.size > 0 || unsavedWorkIdsRef.current.size > 0,\n    [uploadIdsRef, unsavedWorkIdsRef],\n  );\n\n  const confirmNavigation = useCallback(\n    (options?: ConfirmNavigationOptions): boolean => {\n      if (typeof window === 'undefined') return true;\n      const proceed = !shouldConfirmNavigation() || window.confirm(confirmMessage());\n      if (proceed && options?.fullPageNavigation) bypassNextUnloadRef.current = true;\n      return proceed;\n    },\n    [shouldConfirmNavigation, confirmMessage],\n  );\n\n  const value = useMemo<LocalUploadGuardContextValue>(\n    () => ({\n      activeUploadCount: uploads.count,\n      unsavedWorkCount: unsavedWork.count,\n      guardedWorkCount,\n      registerUpload: uploads.register,\n      unregisterUpload: uploads.unregister,\n      registerUnsavedWork: unsavedWork.register,\n      unregisterUnsavedWork: unsavedWork.unregister,\n      shouldConfirmNavigation,\n      confirmNavigation,\n    }),\n    [\n      uploads.count,\n      uploads.register,\n      uploads.unregister,\n      unsavedWork.count,\n      unsavedWork.register,\n      unsavedWork.unregister,\n      guardedWorkCount,\n      shouldConfirmNavigation,\n      confirmNavigation,\n    ],\n  );\n\n  return (\n    <LocalUploadGuardContext.Provider value={value}>{children}</LocalUploadGuardContext.Provider>\n  );\n}\n\nexport function useLocalUploadGuardContext(): LocalUploadGuardContextValue {\n  const ctx = useContext(LocalUploadGuardContext);\n  if (ctx === undefined) {\n    throw new Error('useLocalUploadGuard must be used within LocalUploadGuardProvider');\n  }\n  return ctx;\n}\n\nexport function useOptionalLocalUploadGuard(): LocalUploadGuardContextValue | null {\n  return useContext(LocalUploadGuardContext) ?? null;\n}\n\nexport function useLocalUploadGuard(): LocalUploadGuardContextValue {\n  return useLocalUploadGuardContext();\n}\n\nexport function useUnsavedWorkGuard(hasUnsavedWork: boolean): { release: () => void } {\n  const { registerUnsavedWork, unregisterUnsavedWork } = useLocalUploadGuardContext();\n  const id = useId();\n  useEffect(() => {\n    if (!hasUnsavedWork) return;\n    registerUnsavedWork(id);\n    return () => unregisterUnsavedWork(id);\n  }, [hasUnsavedWork, id, registerUnsavedWork, unregisterUnsavedWork]);\n  const release = useCallback(() => unregisterUnsavedWork(id), [id, unregisterUnsavedWork]);\n  return useMemo(() => ({ release }), [release]);\n}\n"]}

package/dist/react/guard/use-guarded-navigation.d.ts

@@ -1,10 +1,3 @@
 import { type ConfirmNavigationOptions } from './local-upload-guard-provider.js';
-/**
- * Returns a callable that wraps a navigation action. Calling the returned
- * function with `performNavigation` either invokes it immediately (when
- * nothing is registered) or shows a confirmation prompt; if the user confirms,
- * `performNavigation` is invoked. `options` passes through to
- * `confirmNavigation()`.
- */
 export declare function useGuardedNavigation(): (performNavigation: () => void, options?: ConfirmNavigationOptions) => void;
 //# sourceMappingURL=use-guarded-navigation.d.ts.map

package/dist/react/guard/use-guarded-navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-guarded-navigation.d.ts","sourceRoot":"","sources":["../../../src/react/guard/use-guarded-navigation.ts"],"names":[],"mappings":"AAyBA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,CACtC,iBAAiB,EAAE,MAAM,IAAI,EAC7B,OAAO,CAAC,EAAE,wBAAwB,KAC/B,IAAI,CAUR"}
+{"version":3,"file":"use-guarded-navigation.d.ts","sourceRoot":"","sources":["../../../src/react/guard/use-guarded-navigation.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAE1C,wBAAgB,oBAAoB,IAAI,CACtC,iBAAiB,EAAE,MAAM,IAAI,EAC7B,OAAO,CAAC,EAAE,wBAAwB,KAC/B,IAAI,CAUR"}

package/dist/react/guard/use-guarded-navigation.js

@@ -1,34 +1,6 @@
 'use client';
-/**
- * Wraps a navigation action so it prompts the user while an upload or unsaved
- * work is registered. Returns a function that takes the consumer's actual navigation
- * call and either runs it immediately (nothing registered) or shows a confirm()
- * dialog first.
- *
- * Designed to be framework-agnostic — the consumer supplies the navigator
- * (Next.js router.push, React Router navigate, plain location.assign, etc.).
- * A FULL-PAGE navigator (`location.assign` / `location.replace`) passes
- * `{ fullPageNavigation: true }`, so the unload that follows a confirmed
- * navigation does not raise the browser's own "Leave site?" as a second prompt
- * (see `ConfirmNavigationOptions`). Router navigations pass nothing.
- *
- * Typical use inside a button:
- *
- *     const guardedNav = useGuardedNavigation();
- *     <Button onClick={() => guardedNav(() => router.push('/somewhere'))}>Go</Button>
- *     <Button onClick={() => guardedNav(() => location.assign(url), { fullPageNavigation: true })}>Leave</Button>
- *
- * For links, use the `<GuardedLink>` render-prop wrapper.
- */
 import { useCallback } from 'react';
 import { useLocalUploadGuard, } from './local-upload-guard-provider.js';
-/**
- * Returns a callable that wraps a navigation action. Calling the returned
- * function with `performNavigation` either invokes it immediately (when
- * nothing is registered) or shows a confirmation prompt; if the user confirms,
- * `performNavigation` is invoked. `options` passes through to
- * `confirmNavigation()`.
- */
 export function useGuardedNavigation() {
     const { confirmNavigation } = useLocalUploadGuard();
     return useCallback((performNavigation, options) => {

package/dist/react/guard/use-guarded-navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-guarded-navigation.js","sourceRoot":"","sources":["../../../src/react/guard/use-guarded-navigation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,mBAAmB,GAEpB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAIlC,MAAM,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACpD,OAAO,WAAW,CAChB,CAAC,iBAA6B,EAAE,OAAkC,EAAE,EAAE;QACpE,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,iBAAiB,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,iBAAiB,CAAC,CACpB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\n/**\n * Wraps a navigation action so it prompts the user while an upload or unsaved\n * work is registered. Returns a function that takes the consumer's actual navigation\n * call and either runs it immediately (nothing registered) or shows a confirm()\n * dialog first.\n *\n * Designed to be framework-agnostic — the consumer supplies the navigator\n * (Next.js router.push, React Router navigate, plain location.assign, etc.).\n * A FULL-PAGE navigator (`location.assign` / `location.replace`) passes\n * `{ fullPageNavigation: true }`, so the unload that follows a confirmed\n * navigation does not raise the browser's own \"Leave site?\" as a second prompt\n * (see `ConfirmNavigationOptions`). Router navigations pass nothing.\n *\n * Typical use inside a button:\n *\n *     const guardedNav = useGuardedNavigation();\n *     <Button onClick={() => guardedNav(() => router.push('/somewhere'))}>Go</Button>\n *     <Button onClick={() => guardedNav(() => location.assign(url), { fullPageNavigation: true })}>Leave</Button>\n *\n * For links, use the `<GuardedLink>` render-prop wrapper.\n */\n\nimport { useCallback } from 'react';\nimport {\n  useLocalUploadGuard,\n  type ConfirmNavigationOptions,\n} from './local-upload-guard-provider.js';\n\n/**\n * Returns a callable that wraps a navigation action. Calling the returned\n * function with `performNavigation` either invokes it immediately (when\n * nothing is registered) or shows a confirmation prompt; if the user confirms,\n * `performNavigation` is invoked. `options` passes through to\n * `confirmNavigation()`.\n */\nexport function useGuardedNavigation(): (\n  performNavigation: () => void,\n  options?: ConfirmNavigationOptions,\n) => void {\n  const { confirmNavigation } = useLocalUploadGuard();\n  return useCallback(\n    (performNavigation: () => void, options?: ConfirmNavigationOptions) => {\n      if (confirmNavigation(options)) {\n        performNavigation();\n      }\n    },\n    [confirmNavigation],\n  );\n}\n"]}
+{"version":3,"file":"use-guarded-navigation.js","sourceRoot":"","sources":["../../../src/react/guard/use-guarded-navigation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,mBAAmB,GAEpB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,UAAU,oBAAoB;IAIlC,MAAM,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACpD,OAAO,WAAW,CAChB,CAAC,iBAA6B,EAAE,OAAkC,EAAE,EAAE;QACpE,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,iBAAiB,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,iBAAiB,CAAC,CACpB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { useCallback } from 'react';\nimport {\n  useLocalUploadGuard,\n  type ConfirmNavigationOptions,\n} from './local-upload-guard-provider.js';\n\nexport function useGuardedNavigation(): (\n  performNavigation: () => void,\n  options?: ConfirmNavigationOptions,\n) => void {\n  const { confirmNavigation } = useLocalUploadGuard();\n  return useCallback(\n    (performNavigation: () => void, options?: ConfirmNavigationOptions) => {\n      if (confirmNavigation(options)) {\n        performNavigation();\n      }\n    },\n    [confirmNavigation],\n  );\n}\n"]}