@praxisui/files-upload 9.0.0-beta.11 → 9.0.0-beta.13

package/ai/component-registry.json

@@ -0,0 +1,1776 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedAt": "2026-06-22T22:56:44.148Z",
+  "packageName": "@praxisui/files-upload",
+  "packageVersion": "9.0.0-beta.13",
+  "sourceRegistry": "praxis-component-registry-ingestion",
+  "sourceRegistryVersion": "1.0.0",
+  "componentCount": 1,
+  "components": {
+    "praxis-files-upload": {
+      "id": "praxis-files-upload",
+      "description": "Componente para upload de arquivos com suporte a configuracao dinamica, eventos e integracao com backend.",
+      "inputs": [
+        {
+          "name": "config",
+          "type": "FilesUploadConfig",
+          "required": false
+        },
+        {
+          "name": "filesUploadId",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "componentInstanceId",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "baseUrl",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "displayMode",
+          "type": "'full' | 'compact'",
+          "required": false
+        },
+        {
+          "name": "context",
+          "type": "Record<string, unknown>",
+          "required": false
+        },
+        {
+          "name": "enableCustomization",
+          "type": "boolean",
+          "required": false
+        }
+      ],
+      "outputs": [
+        {
+          "name": "uploadSuccess",
+          "type": "FileMetadata",
+          "required": false
+        },
+        {
+          "name": "bulkComplete",
+          "type": "BulkUploadResponseData",
+          "required": false
+        },
+        {
+          "name": "error",
+          "type": "ErrorResponse",
+          "required": false
+        },
+        {
+          "name": "rateLimited",
+          "type": "RateLimitInfo",
+          "required": false
+        },
+        {
+          "name": "uploadStart",
+          "type": "UploadStartEvent",
+          "required": false
+        },
+        {
+          "name": "uploadProgress",
+          "type": "UploadProgressEvent",
+          "required": false
+        },
+        {
+          "name": "retry",
+          "type": "BulkUploadFileResult",
+          "required": false
+        },
+        {
+          "name": "download",
+          "type": "BulkUploadFileResult",
+          "required": false
+        },
+        {
+          "name": "copyLink",
+          "type": "BulkUploadFileResult",
+          "required": false
+        },
+        {
+          "name": "detailsOpened",
+          "type": "BulkUploadFileResult",
+          "required": false
+        },
+        {
+          "name": "detailsClosed",
+          "type": "BulkUploadFileResult",
+          "required": false
+        },
+        {
+          "name": "pendingStateChange",
+          "type": "PendingFilesState",
+          "required": false
+        },
+        {
+          "name": "readinessChange",
+          "type": "FilesUploadReadinessEvent",
+          "required": false
+        },
+        {
+          "name": "proximityChange",
+          "type": "boolean",
+          "required": false
+        }
+      ],
+      "configSchemaId": null,
+      "selector": "praxis-files-upload",
+      "friendlyName": "Praxis Files Upload",
+      "icon": "upload_file",
+      "tags": [
+        "files",
+        "upload",
+        "widget",
+        "configurable"
+      ],
+      "lib": "@praxisui/files-upload",
+      "source": "projects/praxis-files-upload/src/lib/praxis-files-upload.metadata.ts",
+      "exportName": "PRAXIS_FILES_UPLOAD_COMPONENT_METADATA",
+      "componentCapabilities": [
+        {
+          "path": "strategy",
+          "category": "strategy",
+          "valueKind": "enum",
+          "allowedValues": [
+            "direct",
+            "presign",
+            "auto"
+          ],
+          "description": "Upload strategy."
+        },
+        {
+          "path": "ui",
+          "category": "ui",
+          "valueKind": "object",
+          "description": "UI configuration."
+        },
+        {
+          "path": "ui.showDropzone",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Show drag-and-drop dropzone."
+        },
+        {
+          "path": "ui.accept",
+          "category": "ui",
+          "valueKind": "array",
+          "description": "Accept attribute hints (extensions or mime types)."
+        },
+        {
+          "path": "ui.accept[]",
+          "category": "ui",
+          "valueKind": "string",
+          "description": "Single accept entry."
+        },
+        {
+          "path": "ui.dense",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Dense layout."
+        },
+        {
+          "path": "ui.showConflictPolicySelector",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Show conflict policy selector."
+        },
+        {
+          "path": "ui.showMetadataForm",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Show metadata form for each file."
+        },
+        {
+          "path": "ui.showProgress",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Show progress UI."
+        },
+        {
+          "path": "ui.manualUpload",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Require manual start for uploads."
+        },
+        {
+          "path": "ui.dropzone",
+          "category": "ui",
+          "valueKind": "object",
+          "description": "Dropzone interaction options."
+        },
+        {
+          "path": "ui.dropzone.expandOnDragProximity",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Expand dropzone on drag proximity."
+        },
+        {
+          "path": "ui.dropzone.proximityPx",
+          "category": "ui",
+          "valueKind": "number",
+          "description": "Proximity radius in pixels."
+        },
+        {
+          "path": "ui.dropzone.expandMode",
+          "category": "ui",
+          "valueKind": "enum",
+          "allowedValues": [
+            "overlay",
+            "inline"
+          ],
+          "description": "Dropzone expansion mode."
+        },
+        {
+          "path": "ui.dropzone.expandHeight",
+          "category": "ui",
+          "valueKind": "number",
+          "description": "Expanded height (px)."
+        },
+        {
+          "path": "ui.dropzone.expandDebounceMs",
+          "category": "ui",
+          "valueKind": "number",
+          "description": "Drag debounce (ms)."
+        },
+        {
+          "path": "ui.list",
+          "category": "ui",
+          "valueKind": "object",
+          "description": "Uploaded files list options."
+        },
+        {
+          "path": "ui.list.collapseAfter",
+          "category": "ui",
+          "valueKind": "number",
+          "description": "Collapse list after N items."
+        },
+        {
+          "path": "ui.list.detailsMode",
+          "category": "ui",
+          "valueKind": "enum",
+          "allowedValues": [
+            "card",
+            "sidesheet",
+            "auto"
+          ],
+          "description": "Details panel mode."
+        },
+        {
+          "path": "ui.list.detailsMaxWidth",
+          "category": "ui",
+          "valueKind": "number",
+          "description": "Details panel max width (px)."
+        },
+        {
+          "path": "ui.list.detailsShowTechnical",
+          "category": "ui",
+          "valueKind": "boolean",
+          "description": "Show technical details by default."
+        },
+        {
+          "path": "ui.list.detailsFields",
+          "category": "ui",
+          "valueKind": "array",
+          "description": "Allowed metadata fields to display."
+        },
+        {
+          "path": "ui.list.detailsFields[]",
+          "category": "ui",
+          "valueKind": "string",
+          "description": "Single metadata field name."
+        },
+        {
+          "path": "ui.list.detailsAnchor",
+          "category": "ui",
+          "valueKind": "enum",
+          "allowedValues": [
+            "item",
+            "field"
+          ],
+          "description": "Details overlay anchor."
+        },
+        {
+          "path": "limits",
+          "category": "limits",
+          "valueKind": "object",
+          "description": "Upload limits."
+        },
+        {
+          "path": "limits.maxFileSizeBytes",
+          "category": "limits",
+          "valueKind": "number",
+          "description": "Max file size (bytes)."
+        },
+        {
+          "path": "limits.maxFilesPerBulk",
+          "category": "limits",
+          "valueKind": "number",
+          "description": "Max files per bulk upload."
+        },
+        {
+          "path": "limits.maxBulkSizeBytes",
+          "category": "limits",
+          "valueKind": "number",
+          "description": "Max bulk size (bytes)."
+        },
+        {
+          "path": "options",
+          "category": "options",
+          "valueKind": "object",
+          "description": "Backend options sent as JSON."
+        },
+        {
+          "path": "options.defaultConflictPolicy",
+          "category": "options",
+          "valueKind": "enum",
+          "allowedValues": [
+            "ERROR",
+            "SKIP",
+            "OVERWRITE",
+            "MAKE_UNIQUE",
+            "RENAME"
+          ],
+          "description": "Default conflict policy."
+        },
+        {
+          "path": "options.strictValidation",
+          "category": "options",
+          "valueKind": "boolean",
+          "description": "Strict backend validation."
+        },
+        {
+          "path": "options.maxUploadSizeMb",
+          "category": "options",
+          "valueKind": "number",
+          "description": "Max upload size in MB."
+        },
+        {
+          "path": "options.allowedExtensions",
+          "category": "options",
+          "valueKind": "array",
+          "description": "Allowed file extensions."
+        },
+        {
+          "path": "options.allowedExtensions[]",
+          "category": "options",
+          "valueKind": "string",
+          "description": "Single extension (e.g., pdf)."
+        },
+        {
+          "path": "options.acceptMimeTypes",
+          "category": "options",
+          "valueKind": "array",
+          "description": "Allowed mime types."
+        },
+        {
+          "path": "options.acceptMimeTypes[]",
+          "category": "options",
+          "valueKind": "string",
+          "description": "Single mime type."
+        },
+        {
+          "path": "options.targetDirectory",
+          "category": "options",
+          "valueKind": "string",
+          "description": "Target directory on backend."
+        },
+        {
+          "path": "options.enableVirusScanning",
+          "category": "options",
+          "valueKind": "boolean",
+          "description": "Enable virus scanning."
+        },
+        {
+          "path": "bulk",
+          "category": "bulk",
+          "valueKind": "object",
+          "description": "Bulk upload tuning."
+        },
+        {
+          "path": "bulk.failFast",
+          "category": "bulk",
+          "valueKind": "boolean",
+          "description": "Abort on first error."
+        },
+        {
+          "path": "bulk.parallelUploads",
+          "category": "bulk",
+          "valueKind": "number",
+          "description": "Parallel uploads count."
+        },
+        {
+          "path": "bulk.retryCount",
+          "category": "bulk",
+          "valueKind": "number",
+          "description": "Retry count."
+        },
+        {
+          "path": "bulk.retryBackoffMs",
+          "category": "bulk",
+          "valueKind": "number",
+          "description": "Retry backoff (ms)."
+        },
+        {
+          "path": "quotas",
+          "category": "quotas",
+          "valueKind": "object",
+          "description": "Quota UX behavior."
+        },
+        {
+          "path": "quotas.showQuotaWarnings",
+          "category": "quotas",
+          "valueKind": "boolean",
+          "description": "Show quota warnings."
+        },
+        {
+          "path": "quotas.blockOnExceed",
+          "category": "quotas",
+          "valueKind": "boolean",
+          "description": "Block uploads when exceeded."
+        },
+        {
+          "path": "rateLimit",
+          "category": "rateLimit",
+          "valueKind": "object",
+          "description": "429 handling."
+        },
+        {
+          "path": "rateLimit.autoRetryOn429",
+          "category": "rateLimit",
+          "valueKind": "boolean",
+          "description": "Auto retry on 429."
+        },
+        {
+          "path": "rateLimit.showBannerOn429",
+          "category": "rateLimit",
+          "valueKind": "boolean",
+          "description": "Show rate limit banner."
+        },
+        {
+          "path": "rateLimit.maxAutoRetry",
+          "category": "rateLimit",
+          "valueKind": "number",
+          "description": "Max auto retry attempts."
+        },
+        {
+          "path": "rateLimit.baseBackoffMs",
+          "category": "rateLimit",
+          "valueKind": "number",
+          "description": "Base backoff (ms)."
+        },
+        {
+          "path": "headers",
+          "category": "headers",
+          "valueKind": "object",
+          "description": "Header mapping for backend."
+        },
+        {
+          "path": "headers.tenantHeader",
+          "category": "headers",
+          "valueKind": "string",
+          "description": "Tenant header name."
+        },
+        {
+          "path": "headers.userHeader",
+          "category": "headers",
+          "valueKind": "string",
+          "description": "User header name."
+        },
+        {
+          "path": "messages",
+          "category": "messages",
+          "valueKind": "object",
+          "description": "User-facing text overrides."
+        },
+        {
+          "path": "messages.successSingle",
+          "category": "messages",
+          "valueKind": "string",
+          "description": "Single upload success message."
+        },
+        {
+          "path": "messages.successBulk",
+          "category": "messages",
+          "valueKind": "string",
+          "description": "Bulk upload success message."
+        },
+        {
+          "path": "messages.errors",
+          "category": "messages",
+          "valueKind": "object",
+          "description": "Error message map."
+        },
+        {
+          "path": "messages.errors.[code]",
+          "category": "messages",
+          "valueKind": "string",
+          "description": "Message for a specific error code."
+        }
+      ],
+      "componentCapabilityNotes": [
+        "limits.maxFileSizeBytes and limits.maxBulkSizeBytes are bytes (e.g., 10485760 for 10MB).",
+        "options.allowedExtensions is enforced by backend validation; ui.accept is only a client hint.",
+        "Use options.defaultConflictPolicy to control name collisions on upload."
+      ],
+      "componentContext": {
+        "version": "v1",
+        "optionsByPath": {
+          "strategy": {
+            "mode": "enum",
+            "options": [
+              {
+                "value": "direct",
+                "label": "Direct"
+              },
+              {
+                "value": "presign",
+                "label": "Presign"
+              },
+              {
+                "value": "auto",
+                "label": "Auto"
+              }
+            ]
+          },
+          "ui.dropzone.expandMode": {
+            "mode": "enum",
+            "options": [
+              {
+                "value": "overlay",
+                "label": "Overlay"
+              },
+              {
+                "value": "inline",
+                "label": "Inline"
+              }
+            ]
+          },
+          "ui.list.detailsMode": {
+            "mode": "enum",
+            "options": [
+              {
+                "value": "card",
+                "label": "Card"
+              },
+              {
+                "value": "sidesheet",
+                "label": "Side sheet"
+              },
+              {
+                "value": "auto",
+                "label": "Auto"
+              }
+            ]
+          },
+          "ui.list.detailsAnchor": {
+            "mode": "enum",
+            "options": [
+              {
+                "value": "item",
+                "label": "Item"
+              },
+              {
+                "value": "field",
+                "label": "Field"
+              }
+            ]
+          },
+          "options.defaultConflictPolicy": {
+            "mode": "enum",
+            "options": [
+              {
+                "value": "ERROR",
+                "label": "Error"
+              },
+              {
+                "value": "SKIP",
+                "label": "Skip"
+              },
+              {
+                "value": "OVERWRITE",
+                "label": "Overwrite"
+              },
+              {
+                "value": "MAKE_UNIQUE",
+                "label": "Make unique"
+              },
+              {
+                "value": "RENAME",
+                "label": "Rename"
+              }
+            ]
+          }
+        },
+        "actionCatalog": [
+          {
+            "id": "strategy.set",
+            "intentExamples": [
+              "strategy",
+              "upload strategy"
+            ],
+            "patchTemplate": {
+              "strategy": "{{value}}"
+            }
+          },
+          {
+            "id": "ui.showDropzone.enable",
+            "intentExamples": [
+              "show dropzone",
+              "enable dropzone"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "showDropzone": true
+              }
+            }
+          },
+          {
+            "id": "ui.showDropzone.disable",
+            "intentExamples": [
+              "hide dropzone",
+              "disable dropzone"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "showDropzone": false
+              }
+            }
+          },
+          {
+            "id": "ui.manualUpload.enable",
+            "intentExamples": [
+              "manual upload",
+              "upload button"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "manualUpload": true
+              }
+            }
+          },
+          {
+            "id": "ui.manualUpload.disable",
+            "intentExamples": [
+              "auto upload",
+              "instant upload"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "manualUpload": false
+              }
+            }
+          },
+          {
+            "id": "ui.showProgress.enable",
+            "intentExamples": [
+              "show progress",
+              "progress bar"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "showProgress": true
+              }
+            }
+          },
+          {
+            "id": "ui.showProgress.disable",
+            "intentExamples": [
+              "hide progress",
+              "no progress"
+            ],
+            "patchTemplate": {
+              "ui": {
+                "showProgress": false
+              }
+            }
+          },
+          {
+            "id": "limits.maxFileSizeBytes.set",
+            "intentExamples": [
+              "max file size",
+              "size limit"
+            ],
+            "patchTemplate": {
+              "limits": {
+                "maxFileSizeBytes": "{{value}}"
+              }
+            }
+          },
+          {
+            "id": "limits.maxFilesPerBulk.set",
+            "intentExamples": [
+              "max files",
+              "files per upload"
+            ],
+            "patchTemplate": {
+              "limits": {
+                "maxFilesPerBulk": "{{value}}"
+              }
+            }
+          },
+          {
+            "id": "options.defaultConflictPolicy.set",
+            "intentExamples": [
+              "conflict policy",
+              "overwrite",
+              "rename"
+            ],
+            "patchTemplate": {
+              "options": {
+                "defaultConflictPolicy": "{{value}}"
+              }
+            }
+          },
+          {
+            "id": "options.allowedExtensions.add",
+            "intentExamples": [
+              "allowed extensions",
+              "extensions",
+              "file types"
+            ],
+            "patchTemplate": {
+              "options": {
+                "allowedExtensions": [
+                  "{{value}}"
+                ]
+              }
+            }
+          }
+        ],
+        "fieldResolvers": {},
+        "hints": [
+          "limits.maxFileSizeBytes expects bytes (e.g., 10485760 for 10MB).",
+          "Use options.allowedExtensions for backend validation and ui.accept for input hints."
+        ]
+      },
+      "authoringManifest": {
+        "schemaVersion": "1.0.0",
+        "componentId": "praxis-files-upload",
+        "ownerPackage": "@praxisui/files-upload",
+        "configSchemaId": "FilesUploadConfig",
+        "manifestVersion": "1.0.0",
+        "runtimeInputs": [
+          {
+            "name": "config",
+            "type": "FilesUploadConfig",
+            "description": "Upload strategy, UI, limits, backend options, bulk execution, quota/rate feedback, headers and messages."
+          },
+          {
+            "name": "filesUploadId",
+            "type": "string",
+            "description": "Stable upload id used for config persistence and telemetry correlation."
+          },
+          {
+            "name": "componentInstanceId",
+            "type": "string",
+            "description": "Optional instance discriminator when the same upload id appears more than once."
+          },
+          {
+            "name": "baseUrl",
+            "type": "string",
+            "description": "Canonical files API base URL. Direct upload uses baseUrl/upload, bulk uses baseUrl/bulk and presign uses baseUrl/upload/presign."
+          },
+          {
+            "name": "displayMode",
+            "type": "'full' | 'compact'",
+            "allowedValues": [
+              "full",
+              "compact"
+            ],
+            "description": "Runtime display mode input."
+          },
+          {
+            "name": "context",
+            "type": "Record<string, unknown>",
+            "description": "Host context available to metadata and event consumers."
+          },
+          {
+            "name": "enableCustomization",
+            "type": "boolean",
+            "description": "Enables the Settings Panel configuration editor."
+          }
+        ],
+        "editableTargets": [
+          {
+            "kind": "acceptedTypes",
+            "resolver": "files-accept-list",
+            "description": "Allowed file extensions and MIME types projected to ui.accept, options.allowedExtensions and options.acceptMimeTypes."
+          },
+          {
+            "kind": "sizeLimit",
+            "resolver": "max-file-size-policy",
+            "description": "Maximum single-file size in limits.maxFileSizeBytes and backend-facing options.maxUploadSizeMb."
+          },
+          {
+            "kind": "fileCountLimit",
+            "resolver": "max-files-per-bulk-policy",
+            "description": "Maximum number of files accepted in a bulk selection."
+          },
+          {
+            "kind": "presignEndpoint",
+            "resolver": "files-api-base-url-presign-contract",
+            "description": "Presign operation endpoint derived from baseUrl + /upload/presign; arbitrary per-operation URLs are not accepted."
+          },
+          {
+            "kind": "uploadEndpoint",
+            "resolver": "files-api-base-url-upload-contract",
+            "description": "Direct and bulk upload endpoints derived from baseUrl + /upload and /bulk."
+          },
+          {
+            "kind": "securityPolicy",
+            "resolver": "upload-security-policy",
+            "description": "Strict validation, virus scanning, conflict policy, target directory, quotas, rate limit and contextual headers."
+          },
+          {
+            "kind": "errorMessages",
+            "resolver": "upload-error-code-message",
+            "description": "Host-provided message overrides under messages.errors keyed by backend error code."
+          },
+          {
+            "kind": "display",
+            "resolver": "files-upload-display-mode-and-ui",
+            "description": "Runtime displayMode plus non-backend visual UI flags."
+          }
+        ],
+        "operations": [
+          {
+            "operationId": "accept.types.set",
+            "title": "Set accepted file types",
+            "scope": "global",
+            "targetKind": "acceptedTypes",
+            "target": {
+              "kind": "acceptedTypes",
+              "resolver": "files-accept-list",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "accept"
+              ],
+              "properties": {
+                "accept": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "allowedExtensions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "acceptMimeTypes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "set-value",
+                "path": "ui.accept"
+              },
+              {
+                "kind": "set-value",
+                "path": "options.allowedExtensions"
+              },
+              {
+                "kind": "set-value",
+                "path": "options.acceptMimeTypes"
+              }
+            ],
+            "destructive": false,
+            "requiresConfirmation": false,
+            "validators": [
+              "file-type-list-explicit",
+              "file-type-entry-valid",
+              "backend-accept-options-consistent",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "ui.accept",
+              "options.allowedExtensions",
+              "options.acceptMimeTypes"
+            ],
+            "submissionImpact": "affects-submission",
+            "preconditions": [
+              "config-initialized"
+            ]
+          },
+          {
+            "operationId": "limit.fileSize.set",
+            "title": "Set max file size",
+            "scope": "global",
+            "targetKind": "sizeLimit",
+            "target": {
+              "kind": "sizeLimit",
+              "resolver": "max-file-size-policy",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "maxFileSizeBytes"
+              ],
+              "properties": {
+                "maxFileSizeBytes": {
+                  "type": "number"
+                },
+                "maxUploadSizeMb": {
+                  "type": "number"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "set-value",
+                "path": "limits.maxFileSizeBytes"
+              },
+              {
+                "kind": "set-value",
+                "path": "options.maxUploadSizeMb"
+              }
+            ],
+            "destructive": false,
+            "requiresConfirmation": false,
+            "validators": [
+              "size-limit-numeric",
+              "size-limit-within-platform-policy",
+              "size-limit-client-backend-consistent",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "limits.maxFileSizeBytes",
+              "options.maxUploadSizeMb"
+            ],
+            "submissionImpact": "affects-submission",
+            "preconditions": [
+              "config-initialized"
+            ]
+          },
+          {
+            "operationId": "limit.fileCount.set",
+            "title": "Set max file count",
+            "scope": "global",
+            "targetKind": "fileCountLimit",
+            "target": {
+              "kind": "fileCountLimit",
+              "resolver": "max-files-per-bulk-policy",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "maxFilesPerBulk"
+              ],
+              "properties": {
+                "maxFilesPerBulk": {
+                  "type": "number"
+                },
+                "maxBulkSizeBytes": {
+                  "type": "number"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "set-value",
+                "path": "limits.maxFilesPerBulk"
+              },
+              {
+                "kind": "set-value",
+                "path": "limits.maxBulkSizeBytes"
+              }
+            ],
+            "destructive": false,
+            "requiresConfirmation": false,
+            "validators": [
+              "file-count-limit-numeric",
+              "bulk-size-limit-numeric",
+              "bulk-limit-within-platform-policy",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "limits.maxFilesPerBulk",
+              "limits.maxBulkSizeBytes"
+            ],
+            "submissionImpact": "affects-submission",
+            "preconditions": [
+              "config-initialized"
+            ]
+          },
+          {
+            "operationId": "endpoint.presign.set",
+            "title": "Set presign endpoint",
+            "scope": "global",
+            "targetKind": "presignEndpoint",
+            "target": {
+              "kind": "presignEndpoint",
+              "resolver": "files-api-base-url-presign-contract",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "baseUrl"
+              ],
+              "properties": {
+                "baseUrl": {
+                  "type": "string"
+                },
+                "strategy": {
+                  "enum": [
+                    "direct",
+                    "presign",
+                    "auto"
+                  ]
+                },
+                "allowCrossOriginPresignedTarget": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "compile-domain-patch",
+                "handler": "files-upload-presign-base-url",
+                "handlerContract": {
+                  "reads": [
+                    "baseUrl",
+                    "strategy"
+                  ],
+                  "writes": [
+                    "baseUrl",
+                    "strategy"
+                  ],
+                  "identityKeys": [
+                    "baseUrl"
+                  ],
+                  "inputSchema": {
+                    "type": "object",
+                    "required": [
+                      "baseUrl"
+                    ],
+                    "properties": {
+                      "baseUrl": {
+                        "type": "string"
+                      },
+                      "strategy": {
+                        "enum": [
+                          "direct",
+                          "presign",
+                          "auto"
+                        ]
+                      },
+                      "allowCrossOriginPresignedTarget": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "failureModes": [
+                    "unsafe-url",
+                    "non-praxis-backend-surface",
+                    "presign-path-override",
+                    "cross-origin-presigned-fields-leak"
+                  ],
+                  "description": "Validates the files API base URL and preserves the canonical POST baseUrl/upload/presign?filename=... contract; arbitrary presign URLs are rejected."
+                }
+              }
+            ],
+            "destructive": true,
+            "requiresConfirmation": true,
+            "validators": [
+              "endpoint-url-safe",
+              "endpoint-uses-praxis-backend-surface",
+              "presign-endpoint-fixed-contract",
+              "presign-cross-origin-fields-safe",
+              "security-change-confirmed"
+            ],
+            "affectedPaths": [
+              "baseUrl",
+              "strategy"
+            ],
+            "submissionImpact": "affects-remote-binding",
+            "preconditions": [
+              "config-initialized",
+              "confirmation-collected"
+            ]
+          },
+          {
+            "operationId": "endpoint.upload.set",
+            "title": "Set upload endpoint",
+            "scope": "global",
+            "targetKind": "uploadEndpoint",
+            "target": {
+              "kind": "uploadEndpoint",
+              "resolver": "files-api-base-url-upload-contract",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "baseUrl"
+              ],
+              "properties": {
+                "baseUrl": {
+                  "type": "string"
+                },
+                "strategy": {
+                  "enum": [
+                    "direct",
+                    "presign",
+                    "auto"
+                  ]
+                },
+                "allowCrossOriginPresignedTarget": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "compile-domain-patch",
+                "handler": "files-upload-direct-base-url",
+                "handlerContract": {
+                  "reads": [
+                    "baseUrl",
+                    "strategy"
+                  ],
+                  "writes": [
+                    "baseUrl",
+                    "strategy"
+                  ],
+                  "identityKeys": [
+                    "baseUrl"
+                  ],
+                  "inputSchema": {
+                    "type": "object",
+                    "required": [
+                      "baseUrl"
+                    ],
+                    "properties": {
+                      "baseUrl": {
+                        "type": "string"
+                      },
+                      "strategy": {
+                        "enum": [
+                          "direct",
+                          "presign",
+                          "auto"
+                        ]
+                      },
+                      "allowCrossOriginPresignedTarget": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  "failureModes": [
+                    "unsafe-url",
+                    "non-praxis-backend-surface",
+                    "upload-path-override",
+                    "bulk-path-override"
+                  ],
+                  "description": "Validates the files API base URL and preserves the canonical POST baseUrl/upload and POST baseUrl/bulk contracts."
+                }
+              }
+            ],
+            "destructive": true,
+            "requiresConfirmation": true,
+            "validators": [
+              "endpoint-url-safe",
+              "endpoint-uses-praxis-backend-surface",
+              "upload-endpoint-fixed-contract",
+              "bulk-endpoint-fixed-contract",
+              "security-change-confirmed"
+            ],
+            "affectedPaths": [
+              "baseUrl",
+              "strategy"
+            ],
+            "submissionImpact": "affects-remote-binding",
+            "preconditions": [
+              "config-initialized",
+              "confirmation-collected"
+            ]
+          },
+          {
+            "operationId": "security.policy.set",
+            "title": "Set upload security policy",
+            "scope": "global",
+            "targetKind": "securityPolicy",
+            "target": {
+              "kind": "securityPolicy",
+              "resolver": "upload-security-policy",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "properties": {
+                "strictValidation": {
+                  "type": "boolean"
+                },
+                "enableVirusScanning": {
+                  "type": "boolean"
+                },
+                "defaultConflictPolicy": {
+                  "enum": [
+                    "ERROR",
+                    "SKIP",
+                    "OVERWRITE",
+                    "MAKE_UNIQUE",
+                    "RENAME"
+                  ]
+                },
+                "targetDirectory": {
+                  "type": "string"
+                },
+                "showQuotaWarnings": {
+                  "type": "boolean"
+                },
+                "blockOnExceed": {
+                  "type": "boolean"
+                },
+                "autoRetryOn429": {
+                  "type": "boolean"
+                },
+                "showBannerOn429": {
+                  "type": "boolean"
+                },
+                "maxAutoRetry": {
+                  "type": "number"
+                },
+                "baseBackoffMs": {
+                  "type": "number"
+                },
+                "tenantHeader": {
+                  "type": "string"
+                },
+                "userHeader": {
+                  "type": "string"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "merge-object",
+                "path": "options"
+              },
+              {
+                "kind": "merge-object",
+                "path": "quotas"
+              },
+              {
+                "kind": "merge-object",
+                "path": "rateLimit"
+              },
+              {
+                "kind": "merge-object",
+                "path": "headers"
+              }
+            ],
+            "destructive": true,
+            "requiresConfirmation": true,
+            "validators": [
+              "security-change-confirmed",
+              "security-policy-compatible",
+              "target-directory-safe",
+              "conflict-policy-valid",
+              "quota-rate-policy-valid",
+              "header-names-safe",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "options.strictValidation",
+              "options.enableVirusScanning",
+              "options.defaultConflictPolicy",
+              "options.targetDirectory",
+              "quotas",
+              "rateLimit",
+              "headers"
+            ],
+            "submissionImpact": "config-only",
+            "preconditions": [
+              "config-initialized",
+              "confirmation-collected"
+            ]
+          },
+          {
+            "operationId": "message.error.set",
+            "title": "Set error message override",
+            "scope": "global",
+            "targetKind": "errorMessages",
+            "target": {
+              "kind": "errorMessages",
+              "resolver": "upload-error-code-message",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "required": [
+                "code",
+                "message"
+              ],
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "merge-object",
+                "path": "messages.errors"
+              }
+            ],
+            "destructive": false,
+            "requiresConfirmation": false,
+            "validators": [
+              "error-code-known",
+              "error-message-i18n-compatible",
+              "message-not-empty",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "messages.errors"
+            ],
+            "submissionImpact": "config-only",
+            "preconditions": [
+              "config-initialized"
+            ]
+          },
+          {
+            "operationId": "display.mode.set",
+            "title": "Set display mode",
+            "scope": "global",
+            "targetKind": "display",
+            "target": {
+              "kind": "display",
+              "resolver": "files-upload-display-mode-and-ui",
+              "ambiguityPolicy": "fail",
+              "required": false
+            },
+            "inputSchema": {
+              "type": "object",
+              "properties": {
+                "displayMode": {
+                  "enum": [
+                    "full",
+                    "compact"
+                  ]
+                },
+                "dense": {
+                  "type": "boolean"
+                },
+                "showDropzone": {
+                  "type": "boolean"
+                },
+                "showProgress": {
+                  "type": "boolean"
+                },
+                "manualUpload": {
+                  "type": "boolean"
+                },
+                "showMetadataForm": {
+                  "type": "boolean"
+                },
+                "showConflictPolicySelector": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "effects": [
+              {
+                "kind": "set-value",
+                "path": "displayMode"
+              },
+              {
+                "kind": "merge-object",
+                "path": "ui"
+              }
+            ],
+            "destructive": false,
+            "requiresConfirmation": false,
+            "validators": [
+              "display-mode-valid",
+              "display-ui-compatible",
+              "editor-runtime-round-trip"
+            ],
+            "affectedPaths": [
+              "displayMode",
+              "ui.dense",
+              "ui.showDropzone",
+              "ui.showProgress",
+              "ui.manualUpload",
+              "ui.showMetadataForm",
+              "ui.showConflictPolicySelector"
+            ],
+            "submissionImpact": "visual-only",
+            "preconditions": [
+              "config-initialized"
+            ]
+          }
+        ],
+        "validators": [
+          {
+            "validatorId": "file-type-list-explicit",
+            "level": "error",
+            "code": "PFU001",
+            "description": "Accepted type edits must provide a non-empty explicit list and may not rely on wildcard-only policy."
+          },
+          {
+            "validatorId": "file-type-entry-valid",
+            "level": "error",
+            "code": "PFU002",
+            "description": "Each accepted type must be a valid extension, exact MIME type or controlled subtype wildcard."
+          },
+          {
+            "validatorId": "backend-accept-options-consistent",
+            "level": "error",
+            "code": "PFU003",
+            "description": "ui.accept hints must remain consistent with options.allowedExtensions and options.acceptMimeTypes when backend validation is configured."
+          },
+          {
+            "validatorId": "size-limit-numeric",
+            "level": "error",
+            "code": "PFU004",
+            "description": "Single file size limits must be positive numeric byte and MB values."
+          },
+          {
+            "validatorId": "size-limit-within-platform-policy",
+            "level": "error",
+            "code": "PFU005",
+            "description": "Single file size limits must not exceed the platform upload policy for the selected backend surface."
+          },
+          {
+            "validatorId": "size-limit-client-backend-consistent",
+            "level": "error",
+            "code": "PFU006",
+            "description": "limits.maxFileSizeBytes and options.maxUploadSizeMb must describe the same effective maximum when both are present."
+          },
+          {
+            "validatorId": "file-count-limit-numeric",
+            "level": "error",
+            "code": "PFU007",
+            "description": "Bulk file count limits must be positive integers."
+          },
+          {
+            "validatorId": "bulk-size-limit-numeric",
+            "level": "error",
+            "code": "PFU008",
+            "description": "Bulk size limits must be positive numeric byte values when provided."
+          },
+          {
+            "validatorId": "bulk-limit-within-platform-policy",
+            "level": "error",
+            "code": "PFU009",
+            "description": "Bulk count and aggregate size limits must not exceed backend batch policy."
+          },
+          {
+            "validatorId": "endpoint-url-safe",
+            "level": "error",
+            "code": "PFU010",
+            "description": "Endpoint edits must use a safe absolute or approved relative baseUrl and reject javascript:, data:, credentials-in-URL and path traversal."
+          },
+          {
+            "validatorId": "endpoint-uses-praxis-backend-surface",
+            "level": "error",
+            "code": "PFU011",
+            "description": "Endpoint edits must resolve to the approved Praxis files backend surface for the host environment."
+          },
+          {
+            "validatorId": "presign-endpoint-fixed-contract",
+            "level": "error",
+            "code": "PFU012",
+            "description": "Presign authoring may change baseUrl but must preserve POST baseUrl/upload/presign?filename=... as the runtime contract."
+          },
+          {
+            "validatorId": "upload-endpoint-fixed-contract",
+            "level": "error",
+            "code": "PFU013",
+            "description": "Direct upload authoring may change baseUrl but must preserve POST baseUrl/upload as the runtime contract."
+          },
+          {
+            "validatorId": "bulk-endpoint-fixed-contract",
+            "level": "error",
+            "code": "PFU014",
+            "description": "Bulk upload authoring may change baseUrl but must preserve POST baseUrl/bulk as the runtime contract."
+          },
+          {
+            "validatorId": "presign-cross-origin-fields-safe",
+            "level": "error",
+            "code": "PFU015",
+            "description": "Cross-origin presigned upload targets must not receive Praxis metadata/options fields unless explicitly approved by the presign response contract."
+          },
+          {
+            "validatorId": "security-change-confirmed",
+            "level": "error",
+            "code": "PFU016",
+            "description": "Endpoint and security policy edits require explicit confirmation before patch compilation."
+          },
+          {
+            "validatorId": "security-policy-compatible",
+            "level": "error",
+            "code": "PFU017",
+            "description": "Strict validation, virus scanning, conflict policy, target directory, quota and rate-limit settings must be compatible with backend effective config."
+          },
+          {
+            "validatorId": "target-directory-safe",
+            "level": "error",
+            "code": "PFU018",
+            "description": "Target directory values must be normalized backend paths and must reject traversal or absolute filesystem paths."
+          },
+          {
+            "validatorId": "conflict-policy-valid",
+            "level": "error",
+            "code": "PFU019",
+            "description": "Default conflict policy must be one of ERROR, SKIP, OVERWRITE, MAKE_UNIQUE or RENAME."
+          },
+          {
+            "validatorId": "quota-rate-policy-valid",
+            "level": "error",
+            "code": "PFU020",
+            "description": "Quota and rate-limit UX settings must use non-negative retry counts/backoffs and cannot silently bypass backend enforcement."
+          },
+          {
+            "validatorId": "header-names-safe",
+            "level": "warning",
+            "code": "PFU021",
+            "description": "Contextual header names must be explicit HTTP token names and must not override authorization, cookie or content-type headers."
+          },
+          {
+            "validatorId": "error-code-known",
+            "level": "warning",
+            "code": "PFU022",
+            "description": "Error message overrides should target known backend error catalog codes or documented host-specific extensions."
+          },
+          {
+            "validatorId": "error-message-i18n-compatible",
+            "level": "warning",
+            "code": "PFU023",
+            "description": "User-facing error messages must remain compatible with the host i18n/editor flow and not expose raw technical exception text."
+          },
+          {
+            "validatorId": "message-not-empty",
+            "level": "error",
+            "code": "PFU024",
+            "description": "Error message overrides must be non-empty user-facing text."
+          },
+          {
+            "validatorId": "display-mode-valid",
+            "level": "error",
+            "code": "PFU025",
+            "description": "Display mode must be full or compact."
+          },
+          {
+            "validatorId": "display-ui-compatible",
+            "level": "warning",
+            "code": "PFU026",
+            "description": "Display changes must keep progress, manual upload and metadata form affordances reachable for the selected mode."
+          },
+          {
+            "validatorId": "editor-runtime-round-trip",
+            "level": "error",
+            "code": "PFU027",
+            "description": "Settings Panel editor, AI adapter snapshot and runtime inputs must round-trip config, baseUrl and displayMode without changing upload behavior."
+          }
+        ],
+        "roundTripRequirements": [
+          "Accepted type authoring must keep UI hints and backend-facing validation options aligned; ui.accept alone is not the canonical server policy.",
+          "Endpoint authoring changes only the canonical files API baseUrl and strategy; direct, bulk and presign paths remain fixed by FilesApiClient.",
+          "Security-affecting edits require confirmation and must round-trip through Settings Panel persistence without weakening strict validation, virus scanning, quota or rate-limit policy by omission.",
+          "Error message overrides remain keyed by backend error catalog code and must stay user-facing/i18n-compatible.",
+          "Display authoring may change displayMode and UI flags, but must not mutate backend options or upload submission payload."
+        ],
+        "examples": [
+          {
+            "id": "accept-pdf-images",
+            "request": "Accept only PDF and image uploads.",
+            "operationId": "accept.types.set",
+            "params": {
+              "accept": [
+                "application/pdf",
+                "image/*"
+              ],
+              "allowedExtensions": [
+                "pdf",
+                "png",
+                "jpg",
+                "jpeg"
+              ],
+              "acceptMimeTypes": [
+                "application/pdf",
+                "image/png",
+                "image/jpeg"
+              ]
+            },
+            "isPositive": true
+          },
+          {
+            "id": "max-five-mb",
+            "request": "Limit each file to 5 MB.",
+            "operationId": "limit.fileSize.set",
+            "params": {
+              "maxFileSizeBytes": 5242880,
+              "maxUploadSizeMb": 5
+            },
+            "isPositive": true
+          },
+          {
+            "id": "max-three-files",
+            "request": "Allow at most three files per upload batch.",
+            "operationId": "limit.fileCount.set",
+            "params": {
+              "maxFilesPerBulk": 3
+            },
+            "isPositive": true
+          },
+          {
+            "id": "set-presign-base-url",
+            "request": "Use the official files API for presigned uploads.",
+            "operationId": "endpoint.presign.set",
+            "params": {
+              "baseUrl": "https://api.praxis.example/files",
+              "strategy": "presign"
+            },
+            "isPositive": true
+          },
+          {
+            "id": "set-direct-base-url",
+            "request": "Use the official files API for direct uploads.",
+            "operationId": "endpoint.upload.set",
+            "params": {
+              "baseUrl": "https://api.praxis.example/files",
+              "strategy": "direct"
+            },
+            "isPositive": true
+          },
+          {
+            "id": "reject-unsafe-endpoint",
+            "request": "Set upload endpoint to javascript:alert(1).",
+            "operationId": "endpoint.upload.set",
+            "params": {
+              "baseUrl": "javascript:alert(1)",
+              "strategy": "direct"
+            },
+            "isPositive": false
+          },
+          {
+            "id": "tighten-security-policy",
+            "request": "Enable strict validation and virus scanning for uploads.",
+            "operationId": "security.policy.set",
+            "params": {
+              "strictValidation": true,
+              "enableVirusScanning": true,
+              "defaultConflictPolicy": "ERROR"
+            },
+            "isPositive": true
+          },
+          {
+            "id": "reject-unconfirmed-security-policy",
+            "request": "Disable strict validation without confirmation.",
+            "operationId": "security.policy.set",
+            "params": {
+              "strictValidation": false,
+              "enableVirusScanning": false
+            },
+            "isPositive": false
+          },
+          {
+            "id": "quota-message",
+            "request": "Show a friendly message when quota is exceeded.",
+            "operationId": "message.error.set",
+            "params": {
+              "code": "QUOTA_EXCEEDED",
+              "message": "Upload quota reached for this period."
+            },
+            "isPositive": true
+          },
+          {
+            "id": "compact-display",
+            "request": "Use compact upload display and keep progress visible.",
+            "operationId": "display.mode.set",
+            "params": {
+              "displayMode": "compact",
+              "dense": true,
+              "showProgress": true
+            },
+            "isPositive": true
+          }
+        ]
+      },
+      "chunks": [
+        {
+          "chunkIndex": 0,
+          "chunkKind": "summary",
+          "content": "Component ID: praxis-files-upload\nSelector: praxis-files-upload\nFriendly Name: Praxis Files Upload\nDescription: Componente para upload de arquivos com suporte a configuracao dinamica, eventos e integracao com backend.\nLib/Package: @praxisui/files-upload\nTags: files, upload, widget, configurable\nInputs:\n  - config (FilesUploadConfig)\n  - filesUploadId (string)\n  - componentInstanceId (string)\n  - baseUrl (string)\n  - displayMode ('full' | 'compact')\n  - context (Record<string, unknown>)\n  - enableCustomization (boolean)\nOutputs:\n  - uploadSuccess (FileMetadata)\n  - bulkComplete (BulkUploadResponseData)\n  - error (ErrorResponse)\n  - rateLimited (RateLimitInfo)\n  - uploadStart (UploadStartEvent)\n  - uploadProgress (UploadProgressEvent)\n  - retry (BulkUploadFileResult)\n  - download (BulkUploadFileResult)\n  - copyLink (BulkUploadFileResult)\n  - detailsOpened (BulkUploadFileResult)\n  - detailsClosed (BulkUploadFileResult)\n  - pendingStateChange (PendingFilesState)\n  - readinessChange (FilesUploadReadinessEvent)\n  - proximityChange (boolean)\n",
+          "sourcePointer": "praxis-ui-angular/projects/praxis-files-upload/src/lib/praxis-files-upload.metadata.ts",
+          "contentHash": "ac9de9f88b3b6c41731da2106436647af09e3f2e469e8df223afeb1d30de9c8e",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-files-upload",
+          "corpusVersion": "1.0.0"
+        },
+        {
+          "chunkIndex": 1,
+          "chunkKind": "capabilities",
+          "content": "Component Capabilities:\n  - Path: strategy\n    Category: strategy\n    Kind: enum\n    Description: Upload strategy.\n  - Path: ui\n    Category: ui\n    Kind: object\n    Description: UI configuration.\n  - Path: ui.showDropzone\n    Category: ui\n    Kind: boolean\n    Description: Show drag-and-drop dropzone.\n  - Path: ui.accept\n    Category: ui\n    Kind: array\n    Description: Accept attribute hints (extensions or mime types).\n  - Path: ui.accept[]\n    Category: ui\n    Kind: string\n    Description: Single accept entry.\n  - Path: ui.dense\n    Category: ui\n    Kind: boolean\n    Description: Dense layout.\n  - Path: ui.showConflictPolicySelector\n    Category: ui\n    Kind: boolean\n    Description: Show conflict policy selector.\n  - Path: ui.showMetadataForm\n    Category: ui\n    Kind: boolean\n    Description: Show metadata form for each file.\n  - Path: ui.showProgress\n    Category: ui\n    Kind: boolean\n    Description: Show progress UI.\n  - Path: ui.manualUpload\n    Category: ui\n    Kind: boolean\n    Description: Require manual start for uploads.\n  - Path: ui.dropzone\n    Category: ui\n    Kind: object\n    Description: Dropzone interaction options.\n  - Path: ui.dropzone.expandOnDragProximity\n    Category: ui\n    Kind: boolean\n    Description: Expand dropzone on drag proximity.\n  - Path: ui.dropzone.proximityPx\n    Category: ui\n    Kind: number\n    Description: Proximity radius in pixels.\n  - Path: ui.dropzone.expandMode\n    Category: ui\n    Kind: enum\n    Description: Dropzone expansion mode.\n  - Path: ui.dropzone.expandHeight\n    Category: ui\n    Kind: number\n    Description: Expanded height (px).\n  - Path: ui.dropzone.expandDebounceMs\n    Category: ui\n    Kind: number\n    Description: Drag debounce (ms).\n  - Path: ui.list\n    Category: ui\n    Kind: object\n    Description: Uploaded files list options.\n  - Path: ui.list.collapseAfter\n    Category: ui\n    Kind: number\n    Description: Collapse list after N items.\n  - Path: ui.list.detailsMode\n    Category: ui\n    Kind: enum\n    Description: Details panel mode.\n  - Path: ui.list.detailsMaxWidth\n    Category: ui\n    Kind: number\n    Description: Details panel max width (px).\n  - Path: ui.list.detailsShowTechnical\n    Category: ui\n    Kind: boolean\n    Description: Show technical details by default.\n  - Path: ui.list.detailsFields\n    Category: ui\n    Kind: array\n    Description: Allowed metadata fields to display.\n  - Path: ui.list.detailsFields[]\n    Category: ui\n    Kind: string\n    Description: Single metadata field name.\n  - Path: ui.list.detailsAnchor\n    Category: ui\n    Kind: enum\n    Description: Details overlay anchor.\n  - Path: limits\n    Category: limits\n    Kind: object\n    Description: Upload limits.\n  - Path: limits.maxFileSizeBytes\n    Category: limits\n    Kind: number\n    Description: Max file size (bytes).\n  - Path: limits.maxFilesPerBulk\n    Category: limits\n    Kind: number\n    Description: Max files per bulk upload.\n  - Path: limits.maxBulkSizeBytes\n    Category: limits\n    Kind: number\n    Description: Max bulk size (bytes).\n  - Path: options\n    Category: options\n    Kind: object\n    Description: Backend options sent as JSON.\n  - Path: options.defaultConflictPolicy\n    Category: options\n    Kind: enum\n    Description: Default conflict policy.\n  - Path: options.strictValidation\n    Category: options\n    Kind: boolean\n    Description: Strict backend validation.\n  - Path: options.maxUploadSizeMb\n    Category: options\n    Kind: number\n    Description: Max upload size in MB.\n  - Path: options.allowedExtensions\n    Category: options\n    Kind: array\n    Description: Allowed file extensions.\n  - Path: options.allowedExtensions[]\n    Category: options\n    Kind: string\n    Description: Single extension (e.g., pdf).\n  - Path: options.acceptMimeTypes\n    Category: options\n    Kind: array\n    Description: Allowed mime types.\n  - Path: options.acceptMimeTypes[]\n    Category: options\n    Kind: string\n    Description: Single mime type.\n  - Path: options.targetDirectory\n    Category: options\n    Kind: string\n    Description: Target directory on backend.\n  - Path: options.enableVirusScanning\n    Category: options\n    Kind: boolean\n    Description: Enable virus scanning.\n  - Path: bulk\n    Category: bulk\n    Kind: object\n    Description: Bulk upload tuning.\n  - Path: bulk.failFast\n    Category: bulk\n    Kind: boolean\n    Description: Abort on first error.\n  - Path: bulk.parallelUploads\n    Category: bulk\n    Kind: number\n    Description: Parallel uploads count.\n  - Path: bulk.retryCount\n    Category: bulk\n    Kind: number\n    Description: Retry count.\n  - Path: bulk.retryBackoffMs\n    Category: bulk\n    Kind: number\n    Description: Retry backoff (ms).\n  - Path: quotas\n    Category: quotas\n    Kind: object\n    Description: Quota UX behavior.\n  - Path: quotas.showQuotaWarnings\n    Category: quotas\n    Kind: boolean\n    Description: Show quota warnings.\n  - Path: quotas.blockOnExceed\n    Category: quotas\n    Kind: boolean\n    Description: Block uploads when exceeded.\n  - Path: rateLimit\n    Category: rateLimit\n    Kind: object\n    Description: 429 handling.\n  - Path: rateLimit.autoRetryOn429\n    Category: rateLimit\n    Kind: boolean\n    Description: Auto retry on 429.\n  - Path: rateLimit.showBannerOn429\n    Category: rateLimit\n    Kind: boolean\n    Description: Show rate limit banner.\n  - Path: rateLimit.maxAutoRetry\n    Category: rateLimit\n    Kind: number\n    Description: Max auto retry attempts.\n  - Path: rateLimit.baseBackoffMs\n    Category: rateLimit\n    Kind: number\n    Description: Base backoff (ms).\n  - Path: headers\n    Category: headers\n    Kind: object\n    Description: Header mapping for backend.\n  - Path: headers.tenantHeader\n    Category: headers\n    Kind: string\n    Description: Tenant header name.\n  - Path: headers.userHeader\n    Category: headers\n    Kind: string\n    Description: User header name.\n  - Path: messages\n    Category: messages\n    Kind: object\n    Description: User-facing text overrides.\n  - Path: messages.successSingle\n    Category: messages\n    Kind: string\n    Description: Single upload success message.\n  - Path: messages.successBulk\n    Category: messages\n    Kind: string\n    Description: Bulk upload success message.\n  - Path: messages.errors\n    Category: messages\n    Kind: object\n    Description: Error message map.\n  - Path: messages.errors.[code]\n    Category: messages\n    Kind: string\n    Description: Message for a specific error code.\nCapability Notes:\n  - limits.maxFileSizeBytes and limits.maxBulkSizeBytes are bytes (e.g., 10485760 for 10MB).\n  - options.allowedExtensions is enforced by backend validation; ui.accept is only a client hint.\n  - Use options.defaultConflictPolicy to control name collisions on upload.\n",
+          "sourcePointer": "praxis-ui-angular/projects/praxis-files-upload/src/lib/ai/files-upload-ai-capabilities.ts",
+          "contentHash": "c66760435308ecfd846ae8a2d1ef17f6d264d4e6615e00a6595fd527c536bfb5",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-files-upload",
+          "corpusVersion": "1.0.0"
+        },
+        {
+          "chunkIndex": 2,
+          "chunkKind": "authoring_manifest",
+          "content": "{\n  \"schemaVersion\": \"1.0.0\",\n  \"componentId\": \"praxis-files-upload\",\n  \"ownerPackage\": \"@praxisui/files-upload\",\n  \"configSchemaId\": \"FilesUploadConfig\",\n  \"manifestVersion\": \"1.0.0\",\n  \"runtimeInputs\": [\n    {\n      \"name\": \"config\",\n      \"type\": \"FilesUploadConfig\",\n      \"description\": \"Upload strategy, UI, limits, backend options, bulk execution, quota/rate feedback, headers and messages.\"\n    },\n    {\n      \"name\": \"filesUploadId\",\n      \"type\": \"string\",\n      \"description\": \"Stable upload id used for config persistence and telemetry correlation.\"\n    },\n    {\n      \"name\": \"componentInstanceId\",\n      \"type\": \"string\",\n      \"description\": \"Optional instance discriminator when the same upload id appears more than once.\"\n    },\n    {\n      \"name\": \"baseUrl\",\n      \"type\": \"string\",\n      \"description\": \"Canonical files API base URL. Direct upload uses baseUrl/upload, bulk uses baseUrl/bulk and presign uses baseUrl/upload/presign.\"\n    },\n    {\n      \"name\": \"displayMode\",\n      \"type\": \"'full' | 'compact'\",\n      \"allowedValues\": [\n        \"full\",\n        \"compact\"\n      ],\n      \"description\": \"Runtime display mode input.\"\n    },\n    {\n      \"name\": \"context\",\n      \"type\": \"Record<string, unknown>\",\n      \"description\": \"Host context available to metadata and event consumers.\"\n    },\n    {\n      \"name\": \"enableCustomization\",\n      \"type\": \"boolean\",\n      \"description\": \"Enables the Settings Panel configuration editor.\"\n    }\n  ],\n  \"editableTargets\": [\n    {\n      \"kind\": \"acceptedTypes\",\n      \"resolver\": \"files-accept-list\",\n      \"description\": \"Allowed file extensions and MIME types projected to ui.accept, options.allowedExtensions and options.acceptMimeTypes.\"\n    },\n    {\n      \"kind\": \"sizeLimit\",\n      \"resolver\": \"max-file-size-policy\",\n      \"description\": \"Maximum single-file size in limits.maxFileSizeBytes and backend-facing options.maxUploadSizeMb.\"\n    },\n    {\n      \"kind\": \"fileCountLimit\",\n      \"resolver\": \"max-files-per-bulk-policy\",\n      \"description\": \"Maximum number of files accepted in a bulk selection.\"\n    },\n    {\n      \"kind\": \"presignEndpoint\",\n      \"resolver\": \"files-api-base-url-presign-contract\",\n      \"description\": \"Presign operation endpoint derived from baseUrl + /upload/presign; arbitrary per-operation URLs are not accepted.\"\n    },\n    {\n      \"kind\": \"uploadEndpoint\",\n      \"resolver\": \"files-api-base-url-upload-contract\",\n      \"description\": \"Direct and bulk upload endpoints derived from baseUrl + /upload and /bulk.\"\n    },\n    {\n      \"kind\": \"securityPolicy\",\n      \"resolver\": \"upload-security-policy\",\n      \"description\": \"Strict validation, virus scanning, conflict policy, target directory, quotas, rate limit and contextual headers.\"\n    },\n    {\n      \"kind\": \"errorMessages\",\n      \"resolver\": \"upload-error-code-message\",\n      \"description\": \"Host-provided message overrides under messages.errors keyed by backend error code.\"\n    },\n    {\n      \"kind\": \"display\",\n      \"resolver\": \"files-upload-display-mode-and-ui\",\n      \"description\": \"Runtime displayMode plus non-backend visual UI flags.\"\n    }\n  ],\n  \"operations\": [\n    {\n      \"operationId\": \"accept.types.set\",\n      \"title\": \"Set accepted file types\",\n      \"scope\": \"global\",\n      \"targetKind\": \"acceptedTypes\",\n      \"target\": {\n        \"kind\": \"acceptedTypes\",\n        \"resolver\": \"files-accept-list\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"accept\"\n        ],\n        \"properties\": {\n          \"accept\": {\n            \"type\": \"array\",\n            \"items\": {\n              \"type\": \"string\"\n            }\n          },\n          \"allowedExtensions\": {\n            \"type\": \"array\",\n            \"items\": {\n              \"type\": \"string\"\n            }\n          },\n          \"acceptMimeTypes\": {\n            \"type\": \"array\",\n            \"items\": {\n              \"type\": \"string\"\n            }\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"ui.accept\"\n        },\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"options.allowedExtensions\"\n        },\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"options.acceptMimeTypes\"\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"file-type-list-explicit\",\n        \"file-type-entry-valid\",\n        \"backend-accept-options-consistent\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"ui.accept\",\n        \"options.allowedExtensions\",\n        \"options.acceptMimeTypes\"\n      ],\n      \"submissionImpact\": \"affects-submission\",\n      \"preconditions\": [\n        \"config-initialized\"\n      ]\n    },\n    {\n      \"operationId\": \"limit.fileSize.set\",\n      \"title\": \"Set max file size\",\n      \"scope\": \"global\",\n      \"targetKind\": \"sizeLimit\",\n      \"target\": {\n        \"kind\": \"sizeLimit\",\n        \"resolver\": \"max-file-size-policy\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"maxFileSizeBytes\"\n        ],\n        \"properties\": {\n          \"maxFileSizeBytes\": {\n            \"type\": \"number\"\n          },\n          \"maxUploadSizeMb\": {\n            \"type\": \"number\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"limits.maxFileSizeBytes\"\n        },\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"options.maxUploadSizeMb\"\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"size-limit-numeric\",\n        \"size-limit-within-platform-policy\",\n        \"size-limit-client-backend-consistent\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"limits.maxFileSizeBytes\",\n        \"options.maxUploadSizeMb\"\n      ],\n      \"submissionImpact\": \"affects-submission\",\n      \"preconditions\": [\n        \"config-initialized\"\n      ]\n    },\n    {\n      \"operationId\": \"limit.fileCount.set\",\n      \"title\": \"Set max file count\",\n      \"scope\": \"global\",\n      \"targetKind\": \"fileCountLimit\",\n      \"target\": {\n        \"kind\": \"fileCountLimit\",\n        \"resolver\": \"max-files-per-bulk-policy\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"maxFilesPerBulk\"\n        ],\n        \"properties\": {\n          \"maxFilesPerBulk\": {\n            \"type\": \"number\"\n          },\n          \"maxBulkSizeBytes\": {\n            \"type\": \"number\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"limits.maxFilesPerBulk\"\n        },\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"limits.maxBulkSizeBytes\"\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"file-count-limit-numeric\",\n        \"bulk-size-limit-numeric\",\n        \"bulk-limit-within-platform-policy\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"limits.maxFilesPerBulk\",\n        \"limits.maxBulkSizeBytes\"\n      ],\n      \"submissionImpact\": \"affects-submission\",\n      \"preconditions\": [\n        \"config-initialized\"\n      ]\n    },\n    {\n      \"operationId\": \"endpoint.presign.set\",\n      \"title\": \"Set presign endpoint\",\n      \"scope\": \"global\",\n      \"targetKind\": \"presignEndpoint\",\n      \"target\": {\n        \"kind\": \"presignEndpoint\",\n        \"resolver\": \"files-api-base-url-presign-contract\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"baseUrl\"\n        ],\n        \"properties\": {\n          \"baseUrl\": {\n            \"type\": \"string\"\n          },\n          \"strategy\": {\n            \"enum\": [\n              \"direct\",\n              \"presign\",\n              \"auto\"\n            ]\n          },\n          \"allowCrossOriginPresignedTarget\": {\n            \"type\": \"boolean\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"compile-domain-patch\",\n          \"handler\": \"files-upload-presign-base-url\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"baseUrl\",\n              \"strategy\"\n            ],\n            \"writes\": [\n              \"baseUrl\",\n              \"strategy\"\n            ],\n            \"identityKeys\": [\n              \"baseUrl\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"baseUrl\"\n              ],\n              \"properties\": {\n                \"baseUrl\": {\n                  \"type\": \"string\"\n                },\n                \"strategy\": {\n                  \"enum\": [\n                    \"direct\",\n                    \"presign\",\n                    \"auto\"\n                  ]\n                },\n                \"allowCrossOriginPresignedTarget\": {\n                  \"type\": \"boolean\"\n                }\n              }\n            },\n            \"failureModes\": [\n              \"unsafe-url\",\n              \"non-praxis-backend-surface\",\n              \"presign-path-override\",\n              \"cross-origin-presigned-fields-leak\"\n            ],\n            \"description\": \"Validates the files API base URL and preserves the canonical POST baseUrl/upload/presign?filename=... contract; arbitrary presign URLs are rejected.\"\n          }\n        }\n      ],\n      \"destructive\": true,\n      \"requiresConfirmation\": true,\n      \"validators\": [\n        \"endpoint-url-safe\",\n        \"endpoint-uses-praxis-backend-surface\",\n        \"presign-endpoint-fixed-contract\",\n        \"presign-cross-origin-fields-safe\",\n        \"security-change-confirmed\"\n      ],\n      \"affectedPaths\": [\n        \"baseUrl\",\n        \"strategy\"\n      ],\n      \"submissionImpact\": \"affects-remote-binding\",\n      \"preconditions\": [\n        \"config-initialized\",\n        \"confirmation-collected\"\n      ]\n    },\n    {\n      \"operationId\": \"endpoint.upload.set\",\n      \"title\": \"Set upload endpoint\",\n      \"scope\": \"global\",\n      \"targetKind\": \"uploadEndpoint\",\n      \"target\": {\n        \"kind\": \"uploadEndpoint\",\n        \"resolver\": \"files-api-base-url-upload-contract\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"baseUrl\"\n        ],\n        \"properties\": {\n          \"baseUrl\": {\n            \"type\": \"string\"\n          },\n          \"strategy\": {\n            \"enum\": [\n              \"direct\",\n              \"presign\",\n              \"auto\"\n            ]\n          },\n          \"allowCrossOriginPresignedTarget\": {\n            \"type\": \"boolean\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"compile-domain-patch\",\n          \"handler\": \"files-upload-direct-base-url\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"baseUrl\",\n              \"strategy\"\n            ],\n            \"writes\": [\n              \"baseUrl\",\n              \"strategy\"\n            ],\n            \"identityKeys\": [\n              \"baseUrl\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"baseUrl\"\n              ],\n              \"properties\": {\n                \"baseUrl\": {\n                  \"type\": \"string\"\n                },\n                \"strategy\": {\n                  \"enum\": [\n                    \"direct\",\n                    \"presign\",\n                    \"auto\"\n                  ]\n                },\n                \"allowCrossOriginPresignedTarget\": {\n                  \"type\": \"boolean\"\n                }\n              }\n            },\n            \"failureModes\": [\n              \"unsafe-url\",\n              \"non-praxis-backend-surface\",\n              \"upload-path-override\",\n              \"bulk-path-override\"\n            ],\n            \"description\": \"Validates the files API base URL and preserves the canonical POST baseUrl/upload and POST baseUrl/bulk contracts.\"\n          }\n        }\n      ],\n      \"destructive\": true,\n      \"requiresConfirmation\": true,\n      \"validators\": [\n        \"endpoint-url-safe\",\n        \"endpoint-uses-praxis-backend-surface\",\n        \"upload-endpoint-fixed-contract\",\n        \"bulk-endpoint-fixed-contract\",\n        \"security-change-confirmed\"\n      ],\n      \"affectedPaths\": [\n        \"baseUrl\",\n        \"strategy\"\n      ],\n      \"submissionImpact\": \"affects-remote-binding\",\n      \"preconditions\": [\n        \"config-initialized\",\n        \"confirmation-collected\"\n      ]\n    },\n    {\n      \"operationId\": \"security.policy.set\",\n      \"title\": \"Set upload security policy\",\n      \"scope\": \"global\",\n      \"targetKind\": \"securityPolicy\",\n      \"target\": {\n        \"kind\": \"securityPolicy\",\n        \"resolver\": \"upload-security-policy\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"strictValidation\": {\n            \"type\": \"boolean\"\n          },\n          \"enableVirusScanning\": {\n            \"type\": \"boolean\"\n          },\n          \"defaultConflictPolicy\": {\n            \"enum\": [\n              \"ERROR\",\n              \"SKIP\",\n              \"OVERWRITE\",\n              \"MAKE_UNIQUE\",\n              \"RENAME\"\n            ]\n          },\n          \"targetDirectory\": {\n            \"type\": \"string\"\n          },\n          \"showQuotaWarnings\": {\n            \"type\": \"boolean\"\n          },\n          \"blockOnExceed\": {\n            \"type\": \"boolean\"\n          },\n          \"autoRetryOn429\": {\n            \"type\": \"boolean\"\n          },\n          \"showBannerOn429\": {\n            \"type\": \"boolean\"\n          },\n          \"maxAutoRetry\": {\n            \"type\": \"number\"\n          },\n          \"baseBackoffMs\": {\n            \"type\": \"number\"\n          },\n          \"tenantHeader\": {\n            \"type\": \"string\"\n          },\n          \"userHeader\": {\n            \"type\": \"string\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"options\"\n        },\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"quotas\"\n        },\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"rateLimit\"\n        },\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"headers\"\n        }\n      ],\n      \"destructive\": true,\n      \"requiresConfirmation\": true,\n      \"validators\": [\n        \"security-change-confirmed\",\n        \"security-policy-compatible\",\n        \"target-directory-safe\",\n        \"conflict-policy-valid\",\n        \"quota-rate-policy-valid\",\n        \"header-names-safe\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"options.strictValidation\",\n        \"options.enableVirusScanning\",\n        \"options.defaultConflictPolicy\",\n        \"options.targetDirectory\",\n        \"quotas\",\n        \"rateLimit\",\n        \"headers\"\n      ],\n      \"submissionImpact\": \"config-only\",\n      \"preconditions\": [\n        \"config-initialized\",\n        \"confirmation-collected\"\n      ]\n    },\n    {\n      \"operationId\": \"message.error.set\",\n      \"title\": \"Set error message override\",\n      \"scope\": \"global\",\n      \"targetKind\": \"errorMessages\",\n      \"target\": {\n        \"kind\": \"errorMessages\",\n        \"resolver\": \"upload-error-code-message\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"code\",\n          \"message\"\n        ],\n        \"properties\": {\n          \"code\": {\n            \"type\": \"string\"\n          },\n          \"message\": {\n            \"type\": \"string\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"messages.errors\"\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"error-code-known\",\n        \"error-message-i18n-compatible\",\n        \"message-not-empty\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"messages.errors\"\n      ],\n      \"submissionImpact\": \"config-only\",\n      \"preconditions\": [\n        \"config-initialized\"\n      ]\n    },\n    {\n      \"operationId\": \"display.mode.set\",\n      \"title\": \"Set display mode\",\n      \"scope\": \"global\",\n      \"targetKind\": \"display\",\n      \"target\": {\n        \"kind\": \"display\",\n        \"resolver\": \"files-upload-display-mode-and-ui\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"displayMode\": {\n            \"enum\": [\n              \"full\",\n              \"compact\"\n            ]\n          },\n          \"dense\": {\n            \"type\": \"boolean\"\n          },\n          \"showDropzone\": {\n            \"type\": \"boolean\"\n          },\n          \"showProgress\": {\n            \"type\": \"boolean\"\n          },\n          \"manualUpload\": {\n            \"type\": \"boolean\"\n          },\n          \"showMetadataForm\": {\n            \"type\": \"boolean\"\n          },\n          \"showConflictPolicySelector\": {\n            \"type\": \"boolean\"\n          }\n        }\n      },\n      \"effects\": [\n        {\n          \"kind\": \"set-value\",\n          \"path\": \"displayMode\"\n        },\n        {\n          \"kind\": \"merge-object\",\n          \"path\": \"ui\"\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"display-mode-valid\",\n        \"display-ui-compatible\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"displayMode\",\n        \"ui.dense\",\n        \"ui.showDropzone\",\n        \"ui.showProgress\",\n        \"ui.manualUpload\",\n        \"ui.showMetadataForm\",\n        \"ui.showConflictPolicySelector\"\n      ],\n      \"submissionImpact\": \"visual-only\",\n      \"preconditions\": [\n        \"config-initialized\"\n      ]\n    }\n  ],\n  \"validators\": [\n    {\n      \"validatorId\": \"file-type-list-explicit\",\n      \"level\": \"error\",\n      \"code\": \"PFU001\",\n      \"description\": \"Accepted type edits must provide a non-empty explicit list and may not rely on wildcard-only policy.\"\n    },\n    {\n      \"validatorId\": \"file-type-entry-valid\",\n      \"level\": \"error\",\n      \"code\": \"PFU002\",\n      \"description\": \"Each accepted type must be a valid extension, exact MIME type or controlled subtype wildcard.\"\n    },\n    {\n      \"validatorId\": \"backend-accept-options-consistent\",\n      \"level\": \"error\",\n      \"code\": \"PFU003\",\n      \"description\": \"ui.accept hints must remain consistent with options.allowedExtensions and options.acceptMimeTypes when backend validation is configured.\"\n    },\n    {\n      \"validatorId\": \"size-limit-numeric\",\n      \"level\": \"error\",\n      \"code\": \"PFU004\",\n      \"description\": \"Single file size limits must be positive numeric byte and MB values.\"\n    },\n    {\n      \"validatorId\": \"size-limit-within-platform-policy\",\n      \"level\": \"error\",\n      \"code\": \"PFU005\",\n      \"description\": \"Single file size limits must not exceed the platform upload policy for the selected backend surface.\"\n    },\n    {\n      \"validatorId\": \"size-limit-client-backend-consistent\",\n      \"level\": \"error\",\n      \"code\": \"PFU006\",\n      \"description\": \"limits.maxFileSizeBytes and options.maxUploadSizeMb must describe the same effective maximum when both are present.\"\n    },\n    {\n      \"validatorId\": \"file-count-limit-numeric\",\n      \"level\": \"error\",\n      \"code\": \"PFU007\",\n      \"description\": \"Bulk file count limits must be positive integers.\"\n    },\n    {\n      \"validatorId\": \"bulk-size-limit-numeric\",\n      \"level\": \"error\",\n      \"code\": \"PFU008\",\n      \"description\": \"Bulk size limits must be positive numeric byte values when provided.\"\n    },\n    {\n      \"validatorId\": \"bulk-limit-within-platform-policy\",\n      \"level\": \"error\",\n      \"code\": \"PFU009\",\n      \"description\": \"Bulk count and aggregate size limits must not exceed backend batch policy.\"\n    },\n    {\n      \"validatorId\": \"endpoint-url-safe\",\n      \"level\": \"error\",\n      \"code\": \"PFU010\",\n      \"description\": \"Endpoint edits must use a safe absolute or approved relative baseUrl and reject javascript:, data:, credentials-in-URL and path traversal.\"\n    },\n    {\n      \"validatorId\": \"endpoint-uses-praxis-backend-surface\",\n      \"level\": \"error\",\n      \"code\": \"PFU011\",\n      \"description\": \"Endpoint edits must resolve to the approved Praxis files backend surface for the host environment.\"\n    },\n    {\n      \"validatorId\": \"presign-endpoint-fixed-contract\",\n      \"level\": \"error\",\n      \"code\": \"PFU012\",\n      \"description\": \"Presign authoring may change baseUrl but must preserve POST baseUrl/upload/presign?filename=... as the runtime contract.\"\n    },\n    {\n      \"validatorId\": \"upload-endpoint-fixed-contract\",\n      \"level\": \"error\",\n      \"code\": \"PFU013\",\n      \"description\": \"Direct upload authoring may change baseUrl but must preserve POST baseUrl/upload as the runtime contract.\"\n    },\n    {\n      \"validatorId\": \"bulk-endpoint-fixed-contract\",\n      \"level\": \"error\",\n      \"code\": \"PFU014\",\n      \"description\": \"Bulk upload authoring may change baseUrl but must preserve POST baseUrl/bulk as the runtime contract.\"\n    },\n    {\n      \"validatorId\": \"presign-cross-origin-fields-safe\",\n      \"level\": \"error\",\n      \"code\": \"PFU015\",\n      \"description\": \"Cross-origin presigned upload targets must not receive Praxis metadata/options fields unless explicitly approved by the presign response contract.\"\n    },\n    {\n      \"validatorId\": \"security-change-confirmed\",\n      \"level\": \"error\",\n      \"code\": \"PFU016\",\n      \"description\": \"Endpoint and security policy edits require explicit confirmation before patch compilation.\"\n    },\n    {\n      \"validatorId\": \"security-policy-compatible\",\n      \"level\": \"error\",\n      \"code\": \"PFU017\",\n      \"description\": \"Strict validation, virus scanning, conflict policy, target directory, quota and rate-limit settings must be compatible with backend effective config.\"\n    },\n    {\n      \"validatorId\": \"target-directory-safe\",\n      \"level\": \"error\",\n      \"code\": \"PFU018\",\n      \"description\": \"Target directory values must be normalized backend paths and must reject traversal or absolute filesystem paths.\"\n    },\n    {\n      \"validatorId\": \"conflict-policy-valid\",\n      \"level\": \"error\",\n      \"code\": \"PFU019\",\n      \"description\": \"Default conflict policy must be one of ERROR, SKIP, OVERWRITE, MAKE_UNIQUE or RENAME.\"\n    },\n    {\n      \"validatorId\": \"quota-rate-policy-valid\",\n      \"level\": \"error\",\n      \"code\": \"PFU020\",\n      \"description\": \"Quota and rate-limit UX settings must use non-negative retry counts/backoffs and cannot silently bypass backend enforcement.\"\n    },\n    {\n      \"validatorId\": \"header-names-safe\",\n      \"level\": \"warning\",\n      \"code\": \"PFU021\",\n      \"description\": \"Contextual header names must be explicit HTTP token names and must not override authorization, cookie or content-type headers.\"\n    },\n    {\n      \"validatorId\": \"error-code-known\",\n      \"level\": \"warning\",\n      \"code\": \"PFU022\",\n      \"description\": \"Error message overrides should target known backend error catalog codes or documented host-specific extensions.\"\n    },\n    {\n      \"validatorId\": \"error-message-i18n-compatible\",\n      \"level\": \"warning\",\n      \"code\": \"PFU023\",\n      \"description\": \"User-facing error messages must remain compatible with the host i18n/editor flow and not expose raw technical exception text.\"\n    },\n    {\n      \"validatorId\": \"message-not-empty\",\n      \"level\": \"error\",\n      \"code\": \"PFU024\",\n      \"description\": \"Error message overrides must be non-empty user-facing text.\"\n    },\n    {\n      \"validatorId\": \"display-mode-valid\",\n      \"level\": \"error\",\n      \"code\": \"PFU025\",\n      \"description\": \"Display mode must be full or compact.\"\n    },\n    {\n      \"validatorId\": \"display-ui-compatible\",\n      \"level\": \"warning\",\n      \"code\": \"PFU026\",\n      \"description\": \"Display changes must keep progress, manual upload and metadata form affordances reachable for the selected mode.\"\n    },\n    {\n      \"validatorId\": \"editor-runtime-round-trip\",\n      \"level\": \"error\",\n      \"code\": \"PFU027\",\n      \"description\": \"Settings Panel editor, AI adapter snapshot and runtime inputs must round-trip config, baseUrl and displayMode without changing upload behavior.\"\n    }\n  ],\n  \"roundTripRequirements\": [\n    \"Accepted type authoring must keep UI hints and backend-facing validation options aligned; ui.accept alone is not the canonical server policy.\",\n    \"Endpoint authoring changes only the canonical files API baseUrl and strategy; direct, bulk and presign paths remain fixed by FilesApiClient.\",\n    \"Security-affecting edits require confirmation and must round-trip through Settings Panel persistence without weakening strict validation, virus scanning, quota or rate-limit policy by omission.\",\n    \"Error message overrides remain keyed by backend error catalog code and must stay user-facing/i18n-compatible.\",\n    \"Display authoring may change displayMode and UI flags, but must not mutate backend options or upload submission payload.\"\n  ],\n  \"examples\": [\n    {\n      \"id\": \"accept-pdf-images\",\n      \"request\": \"Accept only PDF and image uploads.\",\n      \"operationId\": \"accept.types.set\",\n      \"params\": {\n        \"accept\": [\n          \"application/pdf\",\n          \"image/*\"\n        ],\n        \"allowedExtensions\": [\n          \"pdf\",\n          \"png\",\n          \"jpg\",\n          \"jpeg\"\n        ],\n        \"acceptMimeTypes\": [\n          \"application/pdf\",\n          \"image/png\",\n          \"image/jpeg\"\n        ]\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"max-five-mb\",\n      \"request\": \"Limit each file to 5 MB.\",\n      \"operationId\": \"limit.fileSize.set\",\n      \"params\": {\n        \"maxFileSizeBytes\": 5242880,\n        \"maxUploadSizeMb\": 5\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"max-three-files\",\n      \"request\": \"Allow at most three files per upload batch.\",\n      \"operationId\": \"limit.fileCount.set\",\n      \"params\": {\n        \"maxFilesPerBulk\": 3\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"set-presign-base-url\",\n      \"request\": \"Use the official files API for presigned uploads.\",\n      \"operationId\": \"endpoint.presign.set\",\n      \"params\": {\n        \"baseUrl\": \"https://api.praxis.example/files\",\n        \"strategy\": \"presign\"\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"set-direct-base-url\",\n      \"request\": \"Use the official files API for direct uploads.\",\n      \"operationId\": \"endpoint.upload.set\",\n      \"params\": {\n        \"baseUrl\": \"https://api.praxis.example/files\",\n        \"strategy\": \"direct\"\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"reject-unsafe-endpoint\",\n      \"request\": \"Set upload endpoint to javascript:alert(1).\",\n      \"operationId\": \"endpoint.upload.set\",\n      \"params\": {\n        \"baseUrl\": \"javascript:alert(1)\",\n        \"strategy\": \"direct\"\n      },\n      \"isPositive\": false\n    },\n    {\n      \"id\": \"tighten-security-policy\",\n      \"request\": \"Enable strict validation and virus scanning for uploads.\",\n      \"operationId\": \"security.policy.set\",\n      \"params\": {\n        \"strictValidation\": true,\n        \"enableVirusScanning\": true,\n        \"defaultConflictPolicy\": \"ERROR\"\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"reject-unconfirmed-security-policy\",\n      \"request\": \"Disable strict validation without confirmation.\",\n      \"operationId\": \"security.policy.set\",\n      \"params\": {\n        \"strictValidation\": false,\n        \"enableVirusScanning\": false\n      },\n      \"isPositive\": false\n    },\n    {\n      \"id\": \"quota-message\",\n      \"request\": \"Show a friendly message when quota is exceeded.\",\n      \"operationId\": \"message.error.set\",\n      \"params\": {\n        \"code\": \"QUOTA_EXCEEDED\",\n        \"message\": \"Upload quota reached for this period.\"\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"compact-display\",\n      \"request\": \"Use compact upload display and keep progress visible.\",\n      \"operationId\": \"display.mode.set\",\n      \"params\": {\n        \"displayMode\": \"compact\",\n        \"dense\": true,\n        \"showProgress\": true\n      },\n      \"isPositive\": true\n    }\n  ]\n}",
+          "sourcePointer": "praxis-ui-angular/projects/praxis-files-upload/src/lib/ai/praxis-files-upload-authoring-manifest.ts",
+          "contentHash": "b9d1c1169ded284421d4a18e3b6227cc963b1aaa8a19d1ebd02cf61280ffbc68",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-files-upload",
+          "corpusVersion": "1.0.0"
+        },
+        {
+          "chunkIndex": 3,
+          "chunkKind": "context_pack",
+          "content": "{\n  \"componentContext\": {\n    \"version\": \"v1\",\n    \"optionsByPath\": {\n      \"strategy\": {\n        \"mode\": \"enum\",\n        \"options\": [\n          {\n            \"value\": \"direct\",\n            \"label\": \"Direct\"\n          },\n          {\n            \"value\": \"presign\",\n            \"label\": \"Presign\"\n          },\n          {\n            \"value\": \"auto\",\n            \"label\": \"Auto\"\n          }\n        ]\n      },\n      \"ui.dropzone.expandMode\": {\n        \"mode\": \"enum\",\n        \"options\": [\n          {\n            \"value\": \"overlay\",\n            \"label\": \"Overlay\"\n          },\n          {\n            \"value\": \"inline\",\n            \"label\": \"Inline\"\n          }\n        ]\n      },\n      \"ui.list.detailsMode\": {\n        \"mode\": \"enum\",\n        \"options\": [\n          {\n            \"value\": \"card\",\n            \"label\": \"Card\"\n          },\n          {\n            \"value\": \"sidesheet\",\n            \"label\": \"Side sheet\"\n          },\n          {\n            \"value\": \"auto\",\n            \"label\": \"Auto\"\n          }\n        ]\n      },\n      \"ui.list.detailsAnchor\": {\n        \"mode\": \"enum\",\n        \"options\": [\n          {\n            \"value\": \"item\",\n            \"label\": \"Item\"\n          },\n          {\n            \"value\": \"field\",\n            \"label\": \"Field\"\n          }\n        ]\n      },\n      \"options.defaultConflictPolicy\": {\n        \"mode\": \"enum\",\n        \"options\": [\n          {\n            \"value\": \"ERROR\",\n            \"label\": \"Error\"\n          },\n          {\n            \"value\": \"SKIP\",\n            \"label\": \"Skip\"\n          },\n          {\n            \"value\": \"OVERWRITE\",\n            \"label\": \"Overwrite\"\n          },\n          {\n            \"value\": \"MAKE_UNIQUE\",\n            \"label\": \"Make unique\"\n          },\n          {\n            \"value\": \"RENAME\",\n            \"label\": \"Rename\"\n          }\n        ]\n      }\n    },\n    \"actionCatalog\": [\n      {\n        \"id\": \"strategy.set\",\n        \"intentExamples\": [\n          \"strategy\",\n          \"upload strategy\"\n        ],\n        \"patchTemplate\": {\n          \"strategy\": \"{{value}}\"\n        }\n      },\n      {\n        \"id\": \"ui.showDropzone.enable\",\n        \"intentExamples\": [\n          \"show dropzone\",\n          \"enable dropzone\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"showDropzone\": true\n          }\n        }\n      },\n      {\n        \"id\": \"ui.showDropzone.disable\",\n        \"intentExamples\": [\n          \"hide dropzone\",\n          \"disable dropzone\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"showDropzone\": false\n          }\n        }\n      },\n      {\n        \"id\": \"ui.manualUpload.enable\",\n        \"intentExamples\": [\n          \"manual upload\",\n          \"upload button\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"manualUpload\": true\n          }\n        }\n      },\n      {\n        \"id\": \"ui.manualUpload.disable\",\n        \"intentExamples\": [\n          \"auto upload\",\n          \"instant upload\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"manualUpload\": false\n          }\n        }\n      },\n      {\n        \"id\": \"ui.showProgress.enable\",\n        \"intentExamples\": [\n          \"show progress\",\n          \"progress bar\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"showProgress\": true\n          }\n        }\n      },\n      {\n        \"id\": \"ui.showProgress.disable\",\n        \"intentExamples\": [\n          \"hide progress\",\n          \"no progress\"\n        ],\n        \"patchTemplate\": {\n          \"ui\": {\n            \"showProgress\": false\n          }\n        }\n      },\n      {\n        \"id\": \"limits.maxFileSizeBytes.set\",\n        \"intentExamples\": [\n          \"max file size\",\n          \"size limit\"\n        ],\n        \"patchTemplate\": {\n          \"limits\": {\n            \"maxFileSizeBytes\": \"{{value}}\"\n          }\n        }\n      },\n      {\n        \"id\": \"limits.maxFilesPerBulk.set\",\n        \"intentExamples\": [\n          \"max files\",\n          \"files per upload\"\n        ],\n        \"patchTemplate\": {\n          \"limits\": {\n            \"maxFilesPerBulk\": \"{{value}}\"\n          }\n        }\n      },\n      {\n        \"id\": \"options.defaultConflictPolicy.set\",\n        \"intentExamples\": [\n          \"conflict policy\",\n          \"overwrite\",\n          \"rename\"\n        ],\n        \"patchTemplate\": {\n          \"options\": {\n            \"defaultConflictPolicy\": \"{{value}}\"\n          }\n        }\n      },\n      {\n        \"id\": \"options.allowedExtensions.add\",\n        \"intentExamples\": [\n          \"allowed extensions\",\n          \"extensions\",\n          \"file types\"\n        ],\n        \"patchTemplate\": {\n          \"options\": {\n            \"allowedExtensions\": [\n              \"{{value}}\"\n            ]\n          }\n        }\n      }\n    ],\n    \"fieldResolvers\": {},\n    \"hints\": [\n      \"limits.maxFileSizeBytes expects bytes (e.g., 10485760 for 10MB).\",\n      \"Use options.allowedExtensions for backend validation and ui.accept for input hints.\"\n    ]\n  }\n}",
+          "sourcePointer": "praxis-ui-angular/projects/praxis-files-upload/src/lib/ai/files-upload-context-pack.ts",
+          "contentHash": "5ffa84516ca618908b0795e584de1b6adc21e3072cd1ad5dafa241ff07b184e5",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-files-upload",
+          "corpusVersion": "1.0.0"
+        },
+        {
+          "chunkIndex": 4,
+          "chunkKind": "recipe",
+          "content": "{\n  \"_comment\": \"Recipe for advanced file upload configuration with Praxis Files Upload.\",\n  \"templateMeta\": {\n    \"registryKey\": \"praxis-files-upload\",\n    \"variantId\": \"base\",\n    \"useWhen\": \"Base files upload configuration aligned with the current @praxisui/files-upload contract.\",\n    \"examplePrompts\": [\n      \"configure file upload limits\",\n      \"set allowed file types for upload\",\n      \"create an evidence upload flow with metadata and validation\"\n    ]\n  },\n  \"config\": {\n    \"strategy\": \"direct\",\n    \"ui\": {\n      \"showDropzone\": true,\n      \"accept\": [\"application/pdf\", \"image/png\", \"image/jpeg\", \".pdf\", \".png\", \".jpg\"],\n      \"dense\": false,\n      \"showConflictPolicySelector\": true,\n      \"showMetadataForm\": true,\n      \"showProgress\": true,\n      \"manualUpload\": true,\n      \"dropzone\": {\n        \"expandOnDragProximity\": true,\n        \"proximityPx\": 96,\n        \"expandMode\": \"inline\",\n        \"expandHeight\": 180,\n        \"expandDebounceMs\": 120\n      },\n      \"list\": {\n        \"collapseAfter\": 4,\n        \"detailsMode\": \"card\",\n        \"detailsShowTechnical\": true,\n        \"detailsFields\": [\"id\", \"fileName\", \"contentType\", \"fileSize\", \"uploadedAt\", \"scanStatus\"]\n      }\n    },\n    \"limits\": {\n      \"maxFileSizeBytes\": 10485760,\n      \"maxFilesPerBulk\": 6,\n      \"maxBulkSizeBytes\": 52428800\n    },\n    \"options\": {\n      \"defaultConflictPolicy\": \"MAKE_UNIQUE\",\n      \"strictValidation\": true,\n      \"maxUploadSizeMb\": 10,\n      \"allowedExtensions\": [\"pdf\", \"png\", \"jpg\", \"jpeg\"],\n      \"acceptMimeTypes\": [\"application/pdf\", \"image/png\", \"image/jpeg\"],\n      \"targetDirectory\": \"mission-evidence\",\n      \"enableVirusScanning\": true\n    },\n    \"bulk\": {\n      \"failFast\": false,\n      \"parallelUploads\": 2,\n      \"retryCount\": 2,\n      \"retryBackoffMs\": 600\n    },\n    \"quotas\": {\n      \"showQuotaWarnings\": true,\n      \"blockOnExceed\": true\n    },\n    \"rateLimit\": {\n      \"autoRetryOn429\": true,\n      \"showBannerOn429\": true,\n      \"maxAutoRetry\": 2,\n      \"baseBackoffMs\": 1000\n    },\n    \"headers\": {\n      \"tenantHeader\": \"X-Tenant-Id\",\n      \"userHeader\": \"X-User-Id\"\n    },\n    \"messages\": {\n      \"successSingle\": \"Evidence uploaded and ready for review.\",\n      \"successBulk\": \"Evidence batch processed.\",\n      \"errors\": {\n        \"QUOTA_EXCEEDED\": \"Evidence quota reached.\",\n        \"TIPO_ARQUIVO_INVALIDO\": \"Only PDF, PNG and JPEG files are accepted.\",\n        \"FILE_TOO_LARGE\": \"File exceeds the configured size limit.\"\n      }\n    }\n  }\n}\n",
+          "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-files-upload.json",
+          "contentHash": "0571f31320873a9c01859005967efcd5e15c08ddb12dfb020e8003a90d52f7c4",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-files-upload",
+          "corpusVersion": "1.0.0"
+        }
+      ]
+    }
+  },
+  "note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis."
+}