@ttt-productions/upload-ui 0.7.17 → 0.7.19

package/dist/react/upload/use-guarded-upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-guarded-upload.d.ts","sourceRoot":"","sources":["../../../src/react/upload/use-guarded-upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGlE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,uGAAuG;IACvG,QAAQ,EAAE,MAAM,CAAC;IACjB,qHAAqH;IACrH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,WAIf,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAAC,CA+BjD"}
+{"version":3,"file":"use-guarded-upload.d.ts","sourceRoot":"","sources":["../../../src/react/upload/use-guarded-upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGlE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,gBAAgB,WAIf,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAAC,CA+BjD"}

package/dist/react/upload/use-guarded-upload.js

@@ -1,19 +1,6 @@
 import { useCallback } from 'react';
 import { uploadFileResumable } from '@ttt-productions/upload-core/browser';
 import { useLocalUploadGuard } from '../guard/local-upload-guard-provider.js';
-/**
- * Wraps `uploadFileResumable` with the canonical local-upload guard + phase reporting.
- *
- * Every upload-capable mutation hook MUST use this helper instead of calling
- * `uploadFileResumable` directly. The helper owns:
- * - phase reporting: preparing → uploading (with percent) → finalizing
- * - beforeunload guard registration during the upload window only
- * - error safety: the guard is unregistered in a `finally` block
- *
- * The helper does NOT call `onProgress?.(null)` — callers do that from the
- * mutation's `onSuccess` and `onError` callbacks (because the upload window
- * ends when the upload completes, but the mutation may have more work after).
- */
 export function useGuardedUpload() {
     const { registerUpload, unregisterUpload } = useLocalUploadGuard();
     return useCallback(async (args) => {

package/dist/react/upload/use-guarded-upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-guarded-upload.js","sourceRoot":"","sources":["../../../src/react/upload/use-guarded-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AA6B9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEnE,OAAO,WAAW,CAChB,KAAK,EAAE,IAAuB,EAAiB,EAAE;QAC/C,MAAM,EACJ,QAAQ,EACR,UAAU,EACV,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,uBAAuB,GACxB,GAAG,IAAI,CAAC;QAET,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC;gBACxB,OAAO;gBACP,IAAI;gBACJ,IAAI;gBACJ,QAAQ;gBACR,MAAM;gBACN,GAAG,CAAC,uBAAuB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9E,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;aAC3E,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,EACD,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACnC,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { uploadFileResumable } from '@ttt-productions/upload-core/browser';\nimport type { FirebaseStorage } from 'firebase/storage';\nimport type { UploadState } from '@ttt-productions/media-schemas';\nimport { useLocalUploadGuard } from '../guard/local-upload-guard-provider.js';\n\nexport interface GuardedUploadArgs {\n  storage: FirebaseStorage;\n  path: string;\n  file: File;\n  metadata: { contentType: string };\n  /** Stable identifier for the in-flight upload (used to register/unregister the local-upload guard). */\n  uploadId: string;\n  /** Optional progress callback. Fires with preparing → uploading (with percent) → finalizing → null on completion. */\n  onProgress?: (state: UploadState | null) => void;\n  /**\n   * Optional cancellation signal. When aborted, the in-flight Storage upload\n   * is canceled and `guardedUpload` rejects with the underlying AbortError.\n   * Callers should treat AbortError as a user-initiated cancel (not a real\n   * failure) — typically by checking `error.name === 'AbortError'` in the\n   * mutation's onError and swallowing toasts/error UI for that case.\n   */\n  signal?: AbortSignal;\n  /**\n   * EXPLICIT opt-in for the NEUTRAL `application/octet-stream` content type\n   * (canonical-upload-content-classification): only for advisory picker files\n   * with unknown browser metadata, so the server byte inspector sees unknown\n   * as unknown. Threaded verbatim to `uploadFileResumable`, whose media-only\n   * default stays intact for every consumer that omits it.\n   */\n  allowNeutralContentType?: boolean;\n}\n\n/**\n * Wraps `uploadFileResumable` with the canonical local-upload guard + phase reporting.\n *\n * Every upload-capable mutation hook MUST use this helper instead of calling\n * `uploadFileResumable` directly. The helper owns:\n * - phase reporting: preparing → uploading (with percent) → finalizing\n * - beforeunload guard registration during the upload window only\n * - error safety: the guard is unregistered in a `finally` block\n *\n * The helper does NOT call `onProgress?.(null)` — callers do that from the\n * mutation's `onSuccess` and `onError` callbacks (because the upload window\n * ends when the upload completes, but the mutation may have more work after).\n */\nexport function useGuardedUpload() {\n  const { registerUpload, unregisterUpload } = useLocalUploadGuard();\n\n  return useCallback(\n    async (args: GuardedUploadArgs): Promise<void> => {\n      const {\n        uploadId,\n        onProgress,\n        storage,\n        path,\n        file,\n        metadata,\n        signal,\n        allowNeutralContentType,\n      } = args;\n\n      onProgress?.({ phase: 'preparing', percent: null });\n      registerUpload(uploadId);\n      try {\n        await uploadFileResumable({\n          storage,\n          path,\n          file,\n          metadata,\n          signal,\n          ...(allowNeutralContentType === true ? { allowNeutralContentType: true } : {}),\n          onProgress: ({ percent }) => onProgress?.({ phase: 'uploading', percent }),\n        });\n      } finally {\n        unregisterUpload(uploadId);\n      }\n      onProgress?.({ phase: 'finalizing', percent: null });\n    },\n    [registerUpload, unregisterUpload],\n  );\n}\n"]}
+{"version":3,"file":"use-guarded-upload.js","sourceRoot":"","sources":["../../../src/react/upload/use-guarded-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAa9E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEnE,OAAO,WAAW,CAChB,KAAK,EAAE,IAAuB,EAAiB,EAAE;QAC/C,MAAM,EACJ,QAAQ,EACR,UAAU,EACV,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,uBAAuB,GACxB,GAAG,IAAI,CAAC;QAET,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC;gBACxB,OAAO;gBACP,IAAI;gBACJ,IAAI;gBACJ,QAAQ;gBACR,MAAM;gBACN,GAAG,CAAC,uBAAuB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9E,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;aAC3E,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,EACD,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACnC,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { uploadFileResumable } from '@ttt-productions/upload-core/browser';\nimport type { FirebaseStorage } from 'firebase/storage';\nimport type { UploadState } from '@ttt-productions/media-schemas';\nimport { useLocalUploadGuard } from '../guard/local-upload-guard-provider.js';\n\nexport interface GuardedUploadArgs {\n  storage: FirebaseStorage;\n  path: string;\n  file: File;\n  metadata: { contentType: string };\n  uploadId: string;\n  onProgress?: (state: UploadState | null) => void;\n  signal?: AbortSignal;\n  allowNeutralContentType?: boolean;\n}\n\nexport function useGuardedUpload() {\n  const { registerUpload, unregisterUpload } = useLocalUploadGuard();\n\n  return useCallback(\n    async (args: GuardedUploadArgs): Promise<void> => {\n      const {\n        uploadId,\n        onProgress,\n        storage,\n        path,\n        file,\n        metadata,\n        signal,\n        allowNeutralContentType,\n      } = args;\n\n      onProgress?.({ phase: 'preparing', percent: null });\n      registerUpload(uploadId);\n      try {\n        await uploadFileResumable({\n          storage,\n          path,\n          file,\n          metadata,\n          signal,\n          ...(allowNeutralContentType === true ? { allowNeutralContentType: true } : {}),\n          onProgress: ({ percent }) => onProgress?.({ phase: 'uploading', percent }),\n        });\n      } finally {\n        unregisterUpload(uploadId);\n      }\n      onProgress?.({ phase: 'finalizing', percent: null });\n    },\n    [registerUpload, unregisterUpload],\n  );\n}\n"]}

package/dist/upload-display.d.ts

@@ -1,16 +1,10 @@
-/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */
 export declare function formatFileSize(bytes: number | undefined): string | null;
-/** The app's words for an upload row's time and file kind. */
 export interface UploadDisplayCopy {
-    /** Under a minute old. */
     justNow: string;
     minutesAgo: (minutes: number) => string;
     hoursAgo: (hours: number) => string;
-    /** Accepted on the previous calendar day, given the local clock time. */
     yesterdayAt: (time: string) => string;
-    /** Accepted before yesterday, given the short local date and clock time. */
     dateAt: (date: string, time: string) => string;
-    /** The file's kind, by its simplified media type; `other` for anything else. */
     fileType: {
         image: string;
         video: string;
@@ -20,19 +14,11 @@ export interface UploadDisplayCopy {
 }
 export interface UploadDisplayConfig {
     copy: UploadDisplayCopy;
-    /** How long a row's time reads as relative before it reads as a clock time. */
     relativeTimeCutoffMs: number;
-    /** Locale for the clock time and date; the runtime's own when omitted. */
     locale?: Intl.LocalesArgument;
 }
 export interface UploadDisplayFormatters {
-    /**
-     * An upload's accept time. Within the cutoff of now: just now, minutes ago, or hours ago. Older:
-     * the clock time for today, yesterday and the clock time, or the short date and the clock time —
-     * by local calendar day.
-     */
     formatUploadTimestamp: (createdAtMs: number, nowMs: number) => string;
-    /** The file's kind from its stored content type; `null` when it has none. */
     getFileTypeLabel: (contentType: string | undefined) => string | null;
 }
 export declare function createUploadDisplayFormatters(config: UploadDisplayConfig): UploadDisplayFormatters;

package/dist/upload-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-display.d.ts","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"AAKA,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,yEAAyE;IACzE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,4EAA4E;IAC5E,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtE,6EAA6E;IAC7E,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAC;CACtE;AAUD,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mBAAmB,GAC1B,uBAAuB,CA2CzB"}
+{"version":3,"file":"upload-display.d.ts","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtE,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAC;CACtE;AAUD,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mBAAmB,GAC1B,uBAAuB,CA2CzB"}

package/dist/upload-display.js

@@ -1,7 +1,4 @@
-// What an upload row shows besides its title: the file's size, its kind, and when it was accepted.
-// The mechanics are shared; every word, the relative-time cutoff and the locale are the app's.
 import { getSimplifiedMediaType } from '@ttt-productions/media-schemas';
-/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */
 export function formatFileSize(bytes) {
     if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0)
         return null;
@@ -38,8 +35,8 @@ export function createUploadDisplayFormatters(config) {
         const time = created.toLocaleTimeString(locale, { hour: 'numeric', minute: '2-digit' });
         if (sameCalendarDay(created, now))
             return time;
-        // The previous calendar day, found by stepping the date rather than subtracting 24 hours: a
-        // day that crosses a daylight-saving change is 23 or 25 hours long.
+        // Stepping the date, not subtracting 24 hours: a day that crosses a daylight-saving change is 23
+        // or 25 hours long.
         const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
         if (sameCalendarDay(created, yesterday))
             return copy.yesterdayAt(time);

package/dist/upload-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload-display.js","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"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","sourcesContent":["// What an upload row shows besides its title: the file's size, its kind, and when it was accepted.\n// The mechanics are shared; every word, the relative-time cutoff and the locale are the app's.\n\nimport { getSimplifiedMediaType } from '@ttt-productions/media-schemas';\n\n/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */\nexport function formatFileSize(bytes: number | undefined): string | null {\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0) return null;\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;\n  if (bytes < 1024 * 1024 * 1024) {\n    const mb = bytes / (1024 * 1024);\n    return `${mb < 10 ? mb.toFixed(1) : Math.round(mb)} MB`;\n  }\n  const gb = bytes / (1024 * 1024 * 1024);\n  return `${gb < 10 ? gb.toFixed(1) : Math.round(gb)} GB`;\n}\n\n/** The app's words for an upload row's time and file kind. */\nexport interface UploadDisplayCopy {\n  /** Under a minute old. */\n  justNow: string;\n  minutesAgo: (minutes: number) => string;\n  hoursAgo: (hours: number) => string;\n  /** Accepted on the previous calendar day, given the local clock time. */\n  yesterdayAt: (time: string) => string;\n  /** Accepted before yesterday, given the short local date and clock time. */\n  dateAt: (date: string, time: string) => string;\n  /** The file's kind, by its simplified media type; `other` for anything else. */\n  fileType: { image: string; video: string; audio: string; other: string };\n}\n\nexport interface UploadDisplayConfig {\n  copy: UploadDisplayCopy;\n  /** How long a row's time reads as relative before it reads as a clock time. */\n  relativeTimeCutoffMs: number;\n  /** Locale for the clock time and date; the runtime's own when omitted. */\n  locale?: Intl.LocalesArgument;\n}\n\nexport interface UploadDisplayFormatters {\n  /**\n   * An upload's accept time. Within the cutoff of now: just now, minutes ago, or hours ago. Older:\n   * the clock time for today, yesterday and the clock time, or the short date and the clock time —\n   * by local calendar day.\n   */\n  formatUploadTimestamp: (createdAtMs: number, nowMs: number) => string;\n  /** The file's kind from its stored content type; `null` when it has none. */\n  getFileTypeLabel: (contentType: string | undefined) => string | null;\n}\n\nfunction sameCalendarDay(a: Date, b: Date): boolean {\n  return (\n    a.getFullYear() === b.getFullYear() &&\n    a.getMonth() === b.getMonth() &&\n    a.getDate() === b.getDate()\n  );\n}\n\nexport function createUploadDisplayFormatters(\n  config: UploadDisplayConfig,\n): UploadDisplayFormatters {\n  const { copy, relativeTimeCutoffMs, locale } = config;\n\n  const formatUploadTimestamp = (createdAtMs: number, nowMs: number): string => {\n    const diffMs = Math.max(0, nowMs - createdAtMs);\n    if (diffMs < relativeTimeCutoffMs) {\n      if (diffMs < 60_000) return copy.justNow;\n      const minutes = Math.floor(diffMs / 60_000);\n      if (minutes < 60) return copy.minutesAgo(minutes);\n      return copy.hoursAgo(Math.floor(diffMs / 3_600_000));\n    }\n\n    const created = new Date(createdAtMs);\n    const now = new Date(nowMs);\n    const time = created.toLocaleTimeString(locale, { hour: 'numeric', minute: '2-digit' });\n    if (sameCalendarDay(created, now)) return time;\n\n    // The previous calendar day, found by stepping the date rather than subtracting 24 hours: a\n    // day that crosses a daylight-saving change is 23 or 25 hours long.\n    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);\n    if (sameCalendarDay(created, yesterday)) return copy.yesterdayAt(time);\n\n    return copy.dateAt(\n      created.toLocaleDateString(locale, { month: 'short', day: 'numeric' }),\n      time,\n    );\n  };\n\n  const getFileTypeLabel = (contentType: string | undefined): string | null => {\n    if (!contentType) return null;\n    switch (getSimplifiedMediaType(contentType)) {\n      case 'image':\n        return copy.fileType.image;\n      case 'video':\n        return copy.fileType.video;\n      case 'audio':\n        return copy.fileType.audio;\n      default:\n        return copy.fileType.other;\n    }\n  };\n\n  return { formatUploadTimestamp, getFileTypeLabel };\n}\n"]}
+{"version":3,"file":"upload-display.js","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"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","sourcesContent":["import { getSimplifiedMediaType } from '@ttt-productions/media-schemas';\n\nexport function formatFileSize(bytes: number | undefined): string | null {\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0) return null;\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;\n  if (bytes < 1024 * 1024 * 1024) {\n    const mb = bytes / (1024 * 1024);\n    return `${mb < 10 ? mb.toFixed(1) : Math.round(mb)} MB`;\n  }\n  const gb = bytes / (1024 * 1024 * 1024);\n  return `${gb < 10 ? gb.toFixed(1) : Math.round(gb)} GB`;\n}\n\nexport interface UploadDisplayCopy {\n  justNow: string;\n  minutesAgo: (minutes: number) => string;\n  hoursAgo: (hours: number) => string;\n  yesterdayAt: (time: string) => string;\n  dateAt: (date: string, time: string) => string;\n  fileType: { image: string; video: string; audio: string; other: string };\n}\n\nexport interface UploadDisplayConfig {\n  copy: UploadDisplayCopy;\n  relativeTimeCutoffMs: number;\n  locale?: Intl.LocalesArgument;\n}\n\nexport interface UploadDisplayFormatters {\n  formatUploadTimestamp: (createdAtMs: number, nowMs: number) => string;\n  getFileTypeLabel: (contentType: string | undefined) => string | null;\n}\n\nfunction sameCalendarDay(a: Date, b: Date): boolean {\n  return (\n    a.getFullYear() === b.getFullYear() &&\n    a.getMonth() === b.getMonth() &&\n    a.getDate() === b.getDate()\n  );\n}\n\nexport function createUploadDisplayFormatters(\n  config: UploadDisplayConfig,\n): UploadDisplayFormatters {\n  const { copy, relativeTimeCutoffMs, locale } = config;\n\n  const formatUploadTimestamp = (createdAtMs: number, nowMs: number): string => {\n    const diffMs = Math.max(0, nowMs - createdAtMs);\n    if (diffMs < relativeTimeCutoffMs) {\n      if (diffMs < 60_000) return copy.justNow;\n      const minutes = Math.floor(diffMs / 60_000);\n      if (minutes < 60) return copy.minutesAgo(minutes);\n      return copy.hoursAgo(Math.floor(diffMs / 3_600_000));\n    }\n\n    const created = new Date(createdAtMs);\n    const now = new Date(nowMs);\n    const time = created.toLocaleTimeString(locale, { hour: 'numeric', minute: '2-digit' });\n    if (sameCalendarDay(created, now)) return time;\n\n    // Stepping the date, not subtracting 24 hours: a day that crosses a daylight-saving change is 23\n    // or 25 hours long.\n    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);\n    if (sameCalendarDay(created, yesterday)) return copy.yesterdayAt(time);\n\n    return copy.dateAt(\n      created.toLocaleDateString(locale, { month: 'short', day: 'numeric' }),\n      time,\n    );\n  };\n\n  const getFileTypeLabel = (contentType: string | undefined): string | null => {\n    if (!contentType) return null;\n    switch (getSimplifiedMediaType(contentType)) {\n      case 'image':\n        return copy.fileType.image;\n      case 'video':\n        return copy.fileType.video;\n      case 'audio':\n        return copy.fileType.audio;\n      default:\n        return copy.fileType.other;\n    }\n  };\n\n  return { formatUploadTimestamp, getFileTypeLabel };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/upload-ui",
-  "version": "0.7.17",
+  "version": "0.7.19",
   "description": "Upload UI primitives: local upload guard provider, useGuardedUpload helper, DeferredUploadFormShell for forms that defer Firebase Storage upload until form submit.",
   "repository": {
     "type": "git",
@@ -40,13 +40,14 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/file-input": "^0.11.16",
-    "@ttt-productions/media-schemas": "^0.14.11",
-    "@ttt-productions/ui-core": "^0.11.34",
-    "@ttt-productions/upload-core": "^0.7.6"
+    "@ttt-productions/file-input": "^0.11.17",
+    "@ttt-productions/media-schemas": "^0.14.12",
+    "@ttt-productions/ui-core": "^0.11.35",
+    "@ttt-productions/upload-core": "^0.7.8"
   },
   "peerDependencies": {
-    "@tanstack/react-query": ">=5.0.0",
+    "@tanstack/react-query": ">=5.90.0",
+    "@ttt-productions/query-core": "^0.14.24",
     "firebase": ">=12.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
@@ -55,6 +56,9 @@
     "@tanstack/react-query": {
       "optional": true
     },
+    "@ttt-productions/query-core": {
+      "optional": true
+    },
     "firebase": {
       "optional": true
     },
@@ -65,6 +69,9 @@
       "optional": true
     }
   },
+  "devDependencies": {
+    "@ttt-productions/query-core": "^0.14.24"
+  },
   "author": "DJ (TTT Productions)",
   "license": "MIT"
 }