@ttt-productions/file-input 0.11.14 → 0.11.16

package/dist/types.d.ts

@@ -1,14 +1,14 @@
-import type { ClientMediaClaim, FileCategory as ContractsFileCategory, MediaKind, MediaProcessingSpec, MediaOriginSpec, SimplifiedMediaType, VideoOrientation, MediaCropSpec, UploadState } from "@ttt-productions/media-schemas";
+import type { ClientMediaClaim, FileCategory as ContractsFileCategory, MediaKind, MediaProcessingSpec, MediaOriginSpec, SimplifiedMediaType, VideoOrientation, MediaCropSpec, UploadState } from '@ttt-productions/media-schemas';
 /** FileCategory is owned by contracts. */
 export type FileCategory = ContractsFileCategory;
 export interface CropConfig {
     aspectRatio: number;
     aspectRatioDisplay?: string;
-    shape: "rect" | "round";
+    shape: 'rect' | 'round';
     outputWidth: number;
     outputHeight: number;
 }
-export type FileInputErrorCode = "invalid_type" | "too_large" | "too_long" | "orientation_mismatch" | "aspect_ratio_mismatch" | "dimensions_mismatch" | "read_failed" | "crop_failed" | "unknown";
+export type FileInputErrorCode = 'invalid_type' | 'too_large' | 'too_long' | 'orientation_mismatch' | 'aspect_ratio_mismatch' | 'dimensions_mismatch' | 'read_failed' | 'crop_failed' | 'unknown';
 export interface FileInputError {
     code: FileInputErrorCode;
     message: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ClientMediaClaim,\n  FileCategory as ContractsFileCategory,\n  MediaKind,\n  MediaProcessingSpec,\n  MediaOriginSpec,\n  SimplifiedMediaType,\n  VideoOrientation,\n  MediaCropSpec,\n  UploadState,\n} from \"@ttt-productions/media-schemas\";\n\n/** FileCategory is owned by contracts. */\nexport type FileCategory = ContractsFileCategory;\n\n\nexport interface CropConfig {\n  aspectRatio: number;\n  aspectRatioDisplay?: string;\n  shape: \"rect\" | \"round\";\n  outputWidth: number;\n  outputHeight: number;\n}\n\nexport type FileInputErrorCode =\n  | \"invalid_type\"\n  | \"too_large\"\n  | \"too_long\"\n  | \"orientation_mismatch\"\n  | \"aspect_ratio_mismatch\"\n  | \"dimensions_mismatch\"\n  | \"read_failed\"\n  | \"crop_failed\"\n  | \"unknown\";\n\nexport interface FileInputError {\n  code: FileInputErrorCode;\n  message: string;\n  details?: Record<string, unknown>;\n}\n\nexport interface FileInputChangePayload {\n  type: SimplifiedMediaType;\n  file?: File;\n  blob?: Blob;\n  previewUrl?: string;\n  revokePreviewUrl?: () => void;\n  error?: FileInputError;\n}\n\nexport interface FileInputProps {\n  acceptTypes: SimplifiedMediaType[];\n  maxSizeMB: Partial<Record<SimplifiedMediaType, number>>;\n  selectedFile?: File | null;\n\n  onChange: (payload: FileInputChangePayload) => void;\n  onError?: (error: FileInputError) => void;\n\n  disabled?: boolean;\n  isLoading?: boolean;\n  buttonLabel?: string;\n  /** Accessible name of the icon-only button that clears the selected file. Default \"Clear selected file\". */\n  clearLabel?: string;\n  className?: string;\n\n  variant?: any;\n  size?: any;\n\n  uploadProgress?: number | null;\n\n  videoMaxDurationSec?: number;\n  audioMaxDurationSec?: number;\n\n  cropConfig?: CropConfig;\n  defaultShowDetails?: boolean;\n}\n\n/** Used by MediaInput (spec-driven selection/capture/record). */\nexport interface SelectedMediaMeta {\n  kind: MediaKind;\n  mime?: string;\n  sizeBytes: number;\n  width?: number;\n  height?: number;\n  durationSec?: number;\n  orientation?: VideoOrientation;\n  aspectRatio?: number;\n}\n\nexport interface MediaInputChangePayload {\n  spec: MediaProcessingSpec;\n  file?: File;\n  previewUrl?: string;\n  meta?: SelectedMediaMeta;\n\n  /**\n   * What the user actually DID (canonical-upload-content-classification):\n   * `media-recorder` / `camera-capture` are STRONG claims (the component itself\n   * requested that capture kind — an audio recording asked for `video:false`);\n   * `file-picker` is an ADVISORY inference from browser metadata (`kind:'file'`\n   * when nothing narrower is known). Crop/normalization preserves the original\n   * claim. Untrusted context for the server — never classification authority.\n   * Present on every successful selection; absent only on the error payload.\n   */\n  claim?: ClientMediaClaim;\n\n  autoFormat?: boolean;\n  croppedBlob?: Blob;\n\n  error?: FileInputError;\n}\n\nexport interface MediaInputProps {\n  spec: MediaOriginSpec;\n  cropOverride?: MediaCropSpec;\n\n  disabled?: boolean;\n  isLoading?: boolean;\n  className?: string;\n  buttonLabel?: string;\n  /** Accessible name of the icon-only button that clears the selected file. Default \"Clear selected file\". */\n  clearLabel?: string;\n\n  /**\n   * Extra advisory notes shown in the \"Info\" affordance alongside the built-in default\n   * (\"keep your own copy — this isn't a backup/storage service\"). Every MediaInput shows that\n   * default note; pass surface-specific notes here to append to it. The Info button always renders.\n   */\n  helpNotes?: string[];\n\n  /** Phase-aware upload state. When provided, drives the upload/processing UI. */\n  uploadState?: UploadState | null;\n  /**\n   * Minimum file size (bytes) before showing a real progress bar.\n   * Files smaller than this show an indeterminate spinner during upload instead.\n   * Defaults to `DEFAULT_PROGRESS_BAR_MIN_BYTES` (512 KB) when omitted.\n   * Pass `Infinity` to always use the spinner. Pass `0` to always use the bar.\n   */\n  progressBarMinBytes?: number;\n  /** Currently selected file. Shows a semantic media label + clear button when set. */\n  selectedFile?: File | null;\n  /** Called when user clears the selected file. */\n  onClear?: () => void;\n  /**\n   * Optional cancel callback. When provided AND the upload is in 'preparing' or\n   * 'uploading' phase AND `isLoading` is true, an inline X button renders next to\n   * the status text. Click invokes onCancel — the consumer is responsible for\n   * aborting the underlying upload (e.g. via AbortController.abort()). Never\n   * renders during 'finalizing'.\n   */\n  onCancel?: () => void;\n\n  /**\n   * Optional guard fired before opening the OS picker / capture UI for ANY\n   * action (choose file, take photo, record video, record audio). Return false\n   * — or a Promise resolving to false — to abort before the picker/capture\n   * opens. Consumers use this to run a precondition (e.g. an email-verification\n   * gate) on the click, not after a file has already been selected.\n   */\n  onBeforeSelect?: () => boolean | Promise<boolean>;\n\n  onChange: (payload: MediaInputChangePayload) => void;\n}\n\n/**\n * Imperative handle exposed by {@link MediaInput} via `ref`. Additive — existing\n * ref-less usage is unaffected.\n */\nexport interface MediaInputHandle {\n  /**\n   * Programmatically open the canonical selection path, exactly as clicking the\n   * trigger button does:\n   * - exactly one enabled action → runs that action directly (choose file / photo\n   *   / record), honoring `onBeforeSelect`, validation, and crop;\n   * - multiple enabled actions → opens the existing choice dropdown.\n   *\n   * No-op while `disabled` or `isLoading`, or when no action is enabled. Must be\n   * called synchronously from a user gesture so the browser file dialog can open.\n   * It never bypasses the trigger gates (no hidden-input shortcut).\n   */\n  openSelection: () => void;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ClientMediaClaim,\n  FileCategory as ContractsFileCategory,\n  MediaKind,\n  MediaProcessingSpec,\n  MediaOriginSpec,\n  SimplifiedMediaType,\n  VideoOrientation,\n  MediaCropSpec,\n  UploadState,\n} from '@ttt-productions/media-schemas';\n\n/** FileCategory is owned by contracts. */\nexport type FileCategory = ContractsFileCategory;\n\nexport interface CropConfig {\n  aspectRatio: number;\n  aspectRatioDisplay?: string;\n  shape: 'rect' | 'round';\n  outputWidth: number;\n  outputHeight: number;\n}\n\nexport type FileInputErrorCode =\n  | 'invalid_type'\n  | 'too_large'\n  | 'too_long'\n  | 'orientation_mismatch'\n  | 'aspect_ratio_mismatch'\n  | 'dimensions_mismatch'\n  | 'read_failed'\n  | 'crop_failed'\n  | 'unknown';\n\nexport interface FileInputError {\n  code: FileInputErrorCode;\n  message: string;\n  details?: Record<string, unknown>;\n}\n\nexport interface FileInputChangePayload {\n  type: SimplifiedMediaType;\n  file?: File;\n  blob?: Blob;\n  previewUrl?: string;\n  revokePreviewUrl?: () => void;\n  error?: FileInputError;\n}\n\nexport interface FileInputProps {\n  acceptTypes: SimplifiedMediaType[];\n  maxSizeMB: Partial<Record<SimplifiedMediaType, number>>;\n  selectedFile?: File | null;\n\n  onChange: (payload: FileInputChangePayload) => void;\n  onError?: (error: FileInputError) => void;\n\n  disabled?: boolean;\n  isLoading?: boolean;\n  buttonLabel?: string;\n  /** Accessible name of the icon-only button that clears the selected file. Default \"Clear selected file\". */\n  clearLabel?: string;\n  className?: string;\n\n  variant?: any;\n  size?: any;\n\n  uploadProgress?: number | null;\n\n  videoMaxDurationSec?: number;\n  audioMaxDurationSec?: number;\n\n  cropConfig?: CropConfig;\n  defaultShowDetails?: boolean;\n}\n\n/** Used by MediaInput (spec-driven selection/capture/record). */\nexport interface SelectedMediaMeta {\n  kind: MediaKind;\n  mime?: string;\n  sizeBytes: number;\n  width?: number;\n  height?: number;\n  durationSec?: number;\n  orientation?: VideoOrientation;\n  aspectRatio?: number;\n}\n\nexport interface MediaInputChangePayload {\n  spec: MediaProcessingSpec;\n  file?: File;\n  previewUrl?: string;\n  meta?: SelectedMediaMeta;\n\n  /**\n   * What the user actually DID (canonical-upload-content-classification):\n   * `media-recorder` / `camera-capture` are STRONG claims (the component itself\n   * requested that capture kind — an audio recording asked for `video:false`);\n   * `file-picker` is an ADVISORY inference from browser metadata (`kind:'file'`\n   * when nothing narrower is known). Crop/normalization preserves the original\n   * claim. Untrusted context for the server — never classification authority.\n   * Present on every successful selection; absent only on the error payload.\n   */\n  claim?: ClientMediaClaim;\n\n  autoFormat?: boolean;\n  croppedBlob?: Blob;\n\n  error?: FileInputError;\n}\n\nexport interface MediaInputProps {\n  spec: MediaOriginSpec;\n  cropOverride?: MediaCropSpec;\n\n  disabled?: boolean;\n  isLoading?: boolean;\n  className?: string;\n  buttonLabel?: string;\n  /** Accessible name of the icon-only button that clears the selected file. Default \"Clear selected file\". */\n  clearLabel?: string;\n\n  /**\n   * Extra advisory notes shown in the \"Info\" affordance alongside the built-in default\n   * (\"keep your own copy — this isn't a backup/storage service\"). Every MediaInput shows that\n   * default note; pass surface-specific notes here to append to it. The Info button always renders.\n   */\n  helpNotes?: string[];\n\n  /** Phase-aware upload state. When provided, drives the upload/processing UI. */\n  uploadState?: UploadState | null;\n  /**\n   * Minimum file size (bytes) before showing a real progress bar.\n   * Files smaller than this show an indeterminate spinner during upload instead.\n   * Defaults to `DEFAULT_PROGRESS_BAR_MIN_BYTES` (512 KB) when omitted.\n   * Pass `Infinity` to always use the spinner. Pass `0` to always use the bar.\n   */\n  progressBarMinBytes?: number;\n  /** Currently selected file. Shows a semantic media label + clear button when set. */\n  selectedFile?: File | null;\n  /** Called when user clears the selected file. */\n  onClear?: () => void;\n  /**\n   * Optional cancel callback. When provided AND the upload is in 'preparing' or\n   * 'uploading' phase AND `isLoading` is true, an inline X button renders next to\n   * the status text. Click invokes onCancel — the consumer is responsible for\n   * aborting the underlying upload (e.g. via AbortController.abort()). Never\n   * renders during 'finalizing'.\n   */\n  onCancel?: () => void;\n\n  /**\n   * Optional guard fired before opening the OS picker / capture UI for ANY\n   * action (choose file, take photo, record video, record audio). Return false\n   * — or a Promise resolving to false — to abort before the picker/capture\n   * opens. Consumers use this to run a precondition (e.g. an email-verification\n   * gate) on the click, not after a file has already been selected.\n   */\n  onBeforeSelect?: () => boolean | Promise<boolean>;\n\n  onChange: (payload: MediaInputChangePayload) => void;\n}\n\n/**\n * Imperative handle exposed by {@link MediaInput} via `ref`. Additive — existing\n * ref-less usage is unaffected.\n */\nexport interface MediaInputHandle {\n  /**\n   * Programmatically open the canonical selection path, exactly as clicking the\n   * trigger button does:\n   * - exactly one enabled action → runs that action directly (choose file / photo\n   *   / record), honoring `onBeforeSelect`, validation, and crop;\n   * - multiple enabled actions → opens the existing choice dropdown.\n   *\n   * No-op while `disabled` or `isLoading`, or when no action is enabled. Must be\n   * called synchronously from a user gesture so the browser file dialog can open.\n   * It never bypasses the trigger gates (no hidden-input shortcut).\n   */\n  openSelection: () => void;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/file-input",
-  "version": "0.11.14",
+  "version": "0.11.16",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -31,9 +31,9 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/ui-core": "^0.11.22",
-    "@ttt-productions/media-schemas": "^0.14.9",
-    "@ttt-productions/media-viewer": "^0.10.16",
+    "@ttt-productions/ui-core": "^0.11.34",
+    "@ttt-productions/media-schemas": "^0.14.11",
+    "@ttt-productions/media-viewer": "^0.10.17",
     "react-easy-crop": "^6.2.3"
   },
   "peerDependencies": {