@ttt-productions/file-input 0.11.16 → 0.11.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist/lib/image-utils.d.ts +0 -1
  2. package/dist/lib/image-utils.d.ts.map +1 -1
  3. package/dist/lib/image-utils.js +1 -2
  4. package/dist/lib/image-utils.js.map +1 -1
  5. package/dist/lib/infer-content-type.d.ts +0 -23
  6. package/dist/lib/infer-content-type.d.ts.map +1 -1
  7. package/dist/lib/infer-content-type.js +2 -56
  8. package/dist/lib/infer-content-type.js.map +1 -1
  9. package/dist/lib/validate-media-duration.d.ts.map +1 -1
  10. package/dist/lib/validate-media-duration.js +2 -7
  11. package/dist/lib/validate-media-duration.js.map +1 -1
  12. package/dist/lib/validate-upload-kind.d.ts +0 -34
  13. package/dist/lib/validate-upload-kind.d.ts.map +1 -1
  14. package/dist/lib/validate-upload-kind.js +0 -17
  15. package/dist/lib/validate-upload-kind.js.map +1 -1
  16. package/dist/react/components/file-input.d.ts.map +1 -1
  17. package/dist/react/components/file-input.js +0 -2
  18. package/dist/react/components/file-input.js.map +1 -1
  19. package/dist/react/components/image-cropper-modal.d.ts.map +1 -1
  20. package/dist/react/components/image-cropper-modal.js +0 -2
  21. package/dist/react/components/image-cropper-modal.js.map +1 -1
  22. package/dist/react/components/media-constraints-hint.d.ts.map +1 -1
  23. package/dist/react/components/media-constraints-hint.js +0 -1
  24. package/dist/react/components/media-constraints-hint.js.map +1 -1
  25. package/dist/react/components/media-input.d.ts.map +1 -1
  26. package/dist/react/components/media-input.js +4 -69
  27. package/dist/react/components/media-input.js.map +1 -1
  28. package/dist/react/components/photo-capture-modal.d.ts.map +1 -1
  29. package/dist/react/components/photo-capture-modal.js +1 -5
  30. package/dist/react/components/photo-capture-modal.js.map +1 -1
  31. package/dist/react/components/record-dialog.d.ts +0 -4
  32. package/dist/react/components/record-dialog.d.ts.map +1 -1
  33. package/dist/react/components/record-dialog.js +11 -88
  34. package/dist/react/components/record-dialog.js.map +1 -1
  35. package/dist/types.d.ts +0 -56
  36. package/dist/types.d.ts.map +1 -1
  37. package/dist/types.js.map +1 -1
  38. package/package.json +4 -4
package/dist/types.d.ts CHANGED
@@ -1,5 +1,4 @@
1
1
  import type { ClientMediaClaim, FileCategory as ContractsFileCategory, MediaKind, MediaProcessingSpec, MediaOriginSpec, SimplifiedMediaType, VideoOrientation, MediaCropSpec, UploadState } from '@ttt-productions/media-schemas';
2
- /** FileCategory is owned by contracts. */
3
2
  export type FileCategory = ContractsFileCategory;
4
3
  export interface CropConfig {
5
4
  aspectRatio: number;
@@ -31,7 +30,6 @@ export interface FileInputProps {
31
30
  disabled?: boolean;
32
31
  isLoading?: boolean;
33
32
  buttonLabel?: string;
34
- /** Accessible name of the icon-only button that clears the selected file. Default "Clear selected file". */
35
33
  clearLabel?: string;
36
34
  className?: string;
37
35
  variant?: any;
@@ -42,7 +40,6 @@ export interface FileInputProps {
42
40
  cropConfig?: CropConfig;
43
41
  defaultShowDetails?: boolean;
44
42
  }
45
- /** Used by MediaInput (spec-driven selection/capture/record). */
46
43
  export interface SelectedMediaMeta {
47
44
  kind: MediaKind;
48
45
  mime?: string;
@@ -58,15 +55,6 @@ export interface MediaInputChangePayload {
58
55
  file?: File;
59
56
  previewUrl?: string;
60
57
  meta?: SelectedMediaMeta;
61
- /**
62
- * What the user actually DID (canonical-upload-content-classification):
63
- * `media-recorder` / `camera-capture` are STRONG claims (the component itself
64
- * requested that capture kind — an audio recording asked for `video:false`);
65
- * `file-picker` is an ADVISORY inference from browser metadata (`kind:'file'`
66
- * when nothing narrower is known). Crop/normalization preserves the original
67
- * claim. Untrusted context for the server — never classification authority.
68
- * Present on every successful selection; absent only on the error payload.
69
- */
70
58
  claim?: ClientMediaClaim;
71
59
  autoFormat?: boolean;
72
60
  croppedBlob?: Blob;
@@ -79,61 +67,17 @@ export interface MediaInputProps {
79
67
  isLoading?: boolean;
80
68
  className?: string;
81
69
  buttonLabel?: string;
82
- /** Accessible name of the icon-only button that clears the selected file. Default "Clear selected file". */
83
70
  clearLabel?: string;
84
- /**
85
- * Extra advisory notes shown in the "Info" affordance alongside the built-in default
86
- * ("keep your own copy — this isn't a backup/storage service"). Every MediaInput shows that
87
- * default note; pass surface-specific notes here to append to it. The Info button always renders.
88
- */
89
71
  helpNotes?: string[];
90
- /** Phase-aware upload state. When provided, drives the upload/processing UI. */
91
72
  uploadState?: UploadState | null;
92
- /**
93
- * Minimum file size (bytes) before showing a real progress bar.
94
- * Files smaller than this show an indeterminate spinner during upload instead.
95
- * Defaults to `DEFAULT_PROGRESS_BAR_MIN_BYTES` (512 KB) when omitted.
96
- * Pass `Infinity` to always use the spinner. Pass `0` to always use the bar.
97
- */
98
73
  progressBarMinBytes?: number;
99
- /** Currently selected file. Shows a semantic media label + clear button when set. */
100
74
  selectedFile?: File | null;
101
- /** Called when user clears the selected file. */
102
75
  onClear?: () => void;
103
- /**
104
- * Optional cancel callback. When provided AND the upload is in 'preparing' or
105
- * 'uploading' phase AND `isLoading` is true, an inline X button renders next to
106
- * the status text. Click invokes onCancel — the consumer is responsible for
107
- * aborting the underlying upload (e.g. via AbortController.abort()). Never
108
- * renders during 'finalizing'.
109
- */
110
76
  onCancel?: () => void;
111
- /**
112
- * Optional guard fired before opening the OS picker / capture UI for ANY
113
- * action (choose file, take photo, record video, record audio). Return false
114
- * — or a Promise resolving to false — to abort before the picker/capture
115
- * opens. Consumers use this to run a precondition (e.g. an email-verification
116
- * gate) on the click, not after a file has already been selected.
117
- */
118
77
  onBeforeSelect?: () => boolean | Promise<boolean>;
119
78
  onChange: (payload: MediaInputChangePayload) => void;
120
79
  }
121
- /**
122
- * Imperative handle exposed by {@link MediaInput} via `ref`. Additive — existing
123
- * ref-less usage is unaffected.
124
- */
125
80
  export interface MediaInputHandle {
126
- /**
127
- * Programmatically open the canonical selection path, exactly as clicking the
128
- * trigger button does:
129
- * - exactly one enabled action → runs that action directly (choose file / photo
130
- * / record), honoring `onBeforeSelect`, validation, and crop;
131
- * - multiple enabled actions → opens the existing choice dropdown.
132
- *
133
- * No-op while `disabled` or `isLoading`, or when no action is enabled. Must be
134
- * called synchronously from a user gesture so the browser file dialog can open.
135
- * It never bypasses the trigger gates (no hidden-input shortcut).
136
- */
137
81
  openSelection: () => void;
138
82
  }
139
83
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js.map CHANGED
@@ -1 +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\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"]}
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\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 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\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 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 clearLabel?: string;\n\n helpNotes?: string[];\n\n uploadState?: UploadState | null;\n progressBarMinBytes?: number;\n selectedFile?: File | null;\n onClear?: () => void;\n onCancel?: () => void;\n\n onBeforeSelect?: () => boolean | Promise<boolean>;\n\n onChange: (payload: MediaInputChangePayload) => void;\n}\n\nexport interface MediaInputHandle {\n openSelection: () => void;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ttt-productions/file-input",
3
- "version": "0.11.16",
3
+ "version": "0.11.17",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -31,9 +31,9 @@
31
31
  "prepublishOnly": "npm run clean && npm run build"
32
32
  },
33
33
  "dependencies": {
34
- "@ttt-productions/ui-core": "^0.11.34",
35
- "@ttt-productions/media-schemas": "^0.14.11",
36
- "@ttt-productions/media-viewer": "^0.10.17",
34
+ "@ttt-productions/ui-core": "^0.11.35",
35
+ "@ttt-productions/media-schemas": "^0.14.12",
36
+ "@ttt-productions/media-viewer": "^0.10.19",
37
37
  "react-easy-crop": "^6.2.3"
38
38
  },
39
39
  "peerDependencies": {