@servicemind.tis/angular-image-and-file-picker 1.0.1 → 1.0.3

package/README.md

@@ -28,10 +28,14 @@ npm install @servicemind.tis/angular-image-and-file-picker
 
 ### Peer Dependencies
 
+All of these are declared as peer dependencies and must be installed alongside the library:
+
 ```bash
-npm install @angular/material @angular/cdk
+npm install @angular/material @angular/cdk ngx-extended-pdf-viewer angularx-qrcode
 ```
 
+`ngx-extended-pdf-viewer` powers the PDF preview and `angularx-qrcode` renders the pairing QR code for upload-from-phone. Both are required even if you don't use those features, because the library's NgModule imports them.
+
 ---
 
 ## 🧩 Module Setup
@@ -82,17 +86,50 @@ This is the main component that allows users to upload and preview files.
 
 ### ✅ Inputs
 
-| Input         | Type                | Description |
-|---------------|---------------------|-------------|
-| `urlConfig`   | `UrlConfig`         | API endpoints for upload, attach, delete |
-| `entityType`  | `string`            | Type of the associated entity |
-| `disabled`    | `boolean`           | Disable upload actions |
-| `viewType`    | `'card'`            | View format |
-| `options`     | `UploadOptions`     | Visual and functional configurations |
-| `accept`      | `string`            | Allowed file types (e.g., `.jpg,.png`) |
-| `label`       | `string`            | Upload label |
-| `data`        | `any[]`             | Existing file data to render |
-| `dialogConfig`| `DialogConfig`      | Custom confirmation dialog settings |
+`urlConfig` is the only required input — it is declared `@Input({ required: true })`.
+
+| Input | Type | Default | Description |
+|---|---|---|---|
+| `urlConfig` | `UrlConfig` | — | **Required.** API endpoints for upload, attach and delete |
+| `entityType` | `string` | — | Type of the associated entity |
+| `entityId` | `any` | — | Id of the associated entity |
+| `type` | `'image' \| 'file'` | `'image'` | What the picker accepts |
+| `viewType` | `'card' \| 'list' \| 'compact'` | `'card'` | Layout of the previews |
+| `label` | `string \| null` | `null` | Upload label |
+| `hint` | `string \| null` | `null` | Hint text below the control |
+| `data` | `any` | — | Existing files to render |
+| `accept` | `string` | `''` | Allowed file types, e.g. `.jpg,.png` |
+| `isValidateMimeType` | `boolean` | `true` | Validate the real MIME type, not just the extension |
+| `disabled` | `boolean` | `false` | Disable upload actions |
+| `required` | `boolean` | `false` | Show the required indicator |
+| `selectedId` | `any` | `null` | Pre-select a file by id |
+| `options` | `OptionConfig \| null` | `null` | Visual and functional configuration |
+| `previewOnly` | `boolean` | `false` | Render previews with no upload affordance |
+| `previewInFlex` | `boolean` | `false` | Lay previews out with flex instead of grid |
+| `imageItemClass` | `string` | `''` | Extra classes on each preview tile |
+| `isAddUploadedFileInLastNode` | `boolean` | `false` | Append new uploads instead of prepending |
+| `isEnableDeleteConfirmation` | `boolean` | `true` | Confirm before deleting |
+| `deleteConfirmationMsg` | `string` | — | Override the confirmation text |
+| `isEnableCapture` | `boolean` | `false` | Offer camera capture |
+| `dialogConfig` | `DialogConfig` | — | Confirmation dialog labels and sizing |
+| `enableDragNDropForUpload` | `boolean` | `false` | Accept files dropped onto the control |
+| `enableDragNDrop` | `boolean` | `false` | Allow reordering previews by dragging |
+| `isShowImageSequence` | `boolean` | `false` | Show the ordering index on each preview |
+| `editTagButtonWhenDisabled` | `boolean` | `false` | Keep the tag button active while disabled |
+| `showDeleteButtonWhenDisabled` | `boolean` | `false` | Keep the delete button visible while disabled |
+| `remoteUploadConfig` | `AngularRemoteUploadConfig \| null` | `null` | Enables upload-from-phone via QR pairing |
+
+### 📡 Outputs
+
+| Output | Emits | Description |
+|---|---|---|
+| `onFileSelect` | `any` | A file was chosen, before upload starts |
+| `uploadInProgress` | — | Upload started |
+| `onUploaded` | — | Upload finished |
+| `onFileRemoved` | `any` | A file was removed |
+| `onError` | — | Upload or validation failed |
+| `onRemoteUpload` | `AngularRemoteUploadEvent` | Progress of a phone-paired remote upload |
+| `dataSequenceChange` | `any` | Preview order changed via drag and drop |
 
 ---
 
@@ -190,8 +227,11 @@ bootstrapApplication(AppComponent, {
 
 The component uses Angular Material — ensure a theme is included:
 
-```scss
-@import "~@angular/material/prebuilt-themes/indigo-pink.css";
+```json
+"styles": [
+  "@angular/material/prebuilt-themes/azure-blue.css",
+  "src/styles.scss"
+]
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicemind.tis/angular-image-and-file-picker",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Angular image and file upload component with drag-and-drop, pre-signed URL uploads, client-side compression, camera capture, and built-in preview for images, PDFs, video, and Excel.",
   "keywords": [
     "angular",