@praxisui/files-upload 1.0.0-beta.5 → 1.0.0-beta.53

package/README.md

@@ -1,5 +1,53 @@
+---
+title: "Files Upload"
+slug: "files-upload-overview"
+description: "Visao geral do @praxisui/files-upload com upload direto ou presign, validacoes, i18n, persistencia de configuracao e integracao com backend Praxis."
+doc_type: "reference"
+document_kind: "component-overview"
+component: "files-upload"
+category: "components"
+audience:
+  - "frontend"
+  - "host"
+  - "architect"
+level: "intermediate"
+status: "active"
+owner: "praxis-ui"
+tags:
+  - "files-upload"
+  - "upload"
+  - "presign"
+  - "validation"
+  - "i18n"
+order: 37
+icon: "upload"
+toc: true
+sidebar: true
+search_boost: 0.95
+reading_time: 11
+estimated_setup_time: 20
+version: "1.0"
+related_docs:
+  - "host-files-upload-integration"
+  - "consumer-integration-quickstart"
+  - "host-integration-guide"
+keywords:
+  - "praxis files upload"
+  - "presigned upload"
+  - "upload config"
+  - "bulk upload"
+last_updated: "2026-03-07"
+---
+
 # Praxis Files Upload
 
+## 🔰 Exemplos / Quickstart
+
+Para ver esta biblioteca em funcionamento em uma aplicação completa, utilize o projeto de exemplo (Quickstart):
+
+- Repositório: https://github.com/codexrodrigues/praxis-ui-quickstart
+- O Quickstart demonstra a integração das bibliotecas `@praxisui/*` em um app Angular, incluindo instalação, configuração e uso em telas reais.
+
 Components and services for integrating file uploads with the Praxis backend. Configuration is provided as JSON and can be edited at runtime through the Settings Panel.
 
 ## Component Overview
@@ -9,7 +57,8 @@ Main component selector: `praxis-files-upload`
 Inputs
 - `config: FilesUploadConfig | null` UI/limits/options for the upload flow.
 - `baseUrl?: string` Required to enable uploads (backend base URL for files API).
-- `componentId: string` Persistence key suffix for local config (default: `default`).
+- `filesUploadId: string` Required identifier for config persistence.
+- `componentInstanceId?: string` Optional instance key when rendering multiple uploads in the same route.
 - `displayMode: 'full' | 'compact'` Controls UI density and overlays (default: `full`).
 
 Outputs
@@ -32,7 +81,7 @@ import { PraxisFilesUpload, FilesUploadConfig, FileMetadata } from "@praxisui/fi
 @Component({
   standalone: true,
   imports: [PraxisFilesUpload],
-  template: `<praxis-files-upload [config]="config" (uploadSuccess)="onSuccess($event)"></praxis-files-upload>`,
+  template: `<praxis-files-upload filesUploadId="docs-upload" [config]="config" (uploadSuccess)="onSuccess($event)"></praxis-files-upload>`,
 })
 export class DemoComponent {
   config: FilesUploadConfig = {
@@ -123,7 +172,7 @@ providing the `FILES_UPLOAD_ERROR_MESSAGES` injection token:
 
 ## Configuration persistence
 
-The configuration editor stores settings in `CONFIG_STORAGE` with fallback to `localStorage`, using the key `files-upload-config:<componentId>`.
+The configuration editor stores settings in `ASYNC_CONFIG_STORAGE`, using the key `files-upload-config:<component_id>`. Provide an async storage implementation (for example, `LocalStorageAsyncAdapter` for local persistence or `ApiConfigStorage` for remote persistence).
 
 ## Internationalização