@praxisui/dynamic-form 9.0.4-rc.16 → 9.0.4-rc.17

package/README.md

@@ -251,6 +251,11 @@ Common inputs:
 - `domainRules`
 - `editorialContext`
 
+In `edit` and `view`, `resourceId` identifies the remote entity to hydrate. In
+`create`, it is contextual only (for example, the employee targeted by an
+item-scoped command) and never starts an entity read; provide command defaults
+through `initialValue`.
+
 Common outputs:
 
 - `formSubmit`, `formCancel`, `formReset`

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-03T17:53:06.824Z",
+  "generatedAt": "2026-08-03T18:09:50.161Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.4-rc.16",
+  "packageVersion": "9.0.4-rc.17",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-dynamic-form.mjs

@@ -12393,6 +12393,23 @@ class PraxisDynamicForm {
     }
     loadEntity() {
         this.debugLog('[PDF] loadEntity:start', { id: this.pendingEntityId });
+        // CREATE may still carry a resourceId when the form materializes an
+        // item-scoped command (approve, deactivate, reactivate, etc.). In that
+        // case the id belongs to the command context and must not trigger an
+        // entity read/hydration cycle. Command defaults are supplied explicitly
+        // through initialValue.
+        if (this.mode === 'create') {
+            this.entityHydrationPending = false;
+            const normalized = this.getNormalizedInitialValue();
+            if (normalized && Object.keys(this.form.controls || {}).length) {
+                this.form.patchValue(normalized, { emitEvent: false });
+            }
+            this.flushEntityHydrationState();
+            this.debugLog('[PDF] loadEntity:skipped-create-mode', {
+                id: this.pendingEntityId,
+            });
+            return;
+        }
         if (this.pendingEntityId == null) {
             this.entityHydrationPending = false;
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.4-rc.16",
+  "version": "9.0.4-rc.17",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.4-rc.16",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.16",
-    "@praxisui/metadata-editor": "^9.0.4-rc.16",
-    "@praxisui/rich-content": "^9.0.4-rc.16",
-    "@praxisui/settings-panel": "^9.0.4-rc.16",
-    "@praxisui/visual-builder": "^9.0.4-rc.16",
-    "@praxisui/core": "^9.0.4-rc.16",
+    "@praxisui/ai": "^9.0.4-rc.17",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.17",
+    "@praxisui/metadata-editor": "^9.0.4-rc.17",
+    "@praxisui/rich-content": "^9.0.4-rc.17",
+    "@praxisui/settings-panel": "^9.0.4-rc.17",
+    "@praxisui/visual-builder": "^9.0.4-rc.17",
+    "@praxisui/core": "^9.0.4-rc.17",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-dynamic-form.json-api.md

@@ -232,14 +232,16 @@ O host deve persistir `formSubmit.formData` para fluxos normais. `formSubmit.raw
 ### Input bindings
 
 `initialValue` is an active component input for host-authored or complementary
-field values. The runtime applies it as local initial state without redefining
-the canonical remote entity loaded through `resourcePath` and `resourceId`.
+field values. In `edit/view`, the runtime applies it without redefining the
+canonical remote entity loaded through `resourcePath` and `resourceId`. In
+`create`, including item-scoped command forms, it is the only supported source
+of initial values: a contextual `resourceId` never triggers entity hydration.
 
 | Binding/Path | Type | Required | Source | Runtime normalization | Notes |
 | --- | --- | --- | --- | --- | --- |
 | `config` | `FormConfig` | Conditional | component-input | `normalizeFormConfig(config)` | Contrato principal quando fornecido diretamente pelo host. |
 | `resourcePath` | `string \| undefined` | Conditional | component-input | `crud.configure(resourcePath)` | Endpoint base para schema e dados remotos. Alternativa canônica: `schemaUrl` explícito. |
-| `resourceId` | `string \| number \| undefined` | No | component-input | update `pendingEntityId` + `loadEntity()` | Carrega entidade em modo `edit/view`. |
+| `resourceId` | `string \| number \| undefined` | No | component-input | update `pendingEntityId`; hydrate only in `edit/view` | Carrega entidade em modo `edit/view`. Em `create`, pode identificar o item dono de um comando sem iniciar leitura nem bloquear os campos. |
 | `mode` | `'create' \| 'edit' \| 'view'` | No | component-input/storage | persistido em `formInputsKey` | Preferência de modo pode ser hidratada do storage. |
 | `schemaSource` | `'resource' \| 'filter'` | No | component-input | runtime branch | Seleciona caminho de obtenção de schema quando `schemaUrl` não é informado. |
 | `schemaUrl` | `string \| null \| undefined` | Conditional | component-input | parsed as `/schemas/filtered` contract | Fonte canônica explícita para inicialização schema-backed sem depender de `resourcePath`. |
@@ -569,7 +571,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | --- | --- | --- | --- | --- |
 | `config` | `FormConfig` | `{ sections: [] }` | Active | Contrato principal consumido no ciclo inteiro. `sections` é opcional somente para forms schema-driven com grounding explícito (`metadata.source='schema'`, schema metadata ou fonte runtime como `schemaUrl`/`resourcePath`); ausência de layout manual é normalizada internamente como array vazio e permite que `layoutPolicy`/schema materializem agrupamentos. |
 | `resourcePath` | `string \| undefined` | `undefined` | Active | Habilita carga de schema/dados remotos. Opcional quando `schemaUrl` explícito é fornecido. |
-| `resourceId` | `string \| number \| undefined` | `undefined` | Active | Carrega entidade no modo `edit/view`. |
+| `resourceId` | `string \| number \| undefined` | `undefined` | Active | Carrega entidade no modo `edit/view`; em `create`, funciona apenas como contexto do item e não dispara hidratação. |
 | `mode` | `'create' \| 'edit' \| 'view'` | `'create'` | Active | Governa submit, leitura e apresentacao. |
 | `schemaSource` | `'resource' \| 'filter'` | `'resource'` | Active | Seleciona origem do schema remoto. |
 | `schemaUrl` | `string \| undefined` | `undefined` | Active | Permite usar schema canonico publicado pelo backend sem heuristica local de path e pode iniciar o fluxo corporativo sem `resourcePath`. |
@@ -704,7 +706,7 @@ Validado em 2026-04-23 contra `praxis-api-quickstart` publicado no Render com
 
 #### Data mode e fluxo
 
-- `mode='create'`: cria registro, carga de entidade opcional.
+- `mode='create'`: cria registro ou materializa um comando; nunca carrega a entidade por `resourceId`, e valores iniciais devem vir de `initialValue`.
 - `mode='edit'`: carrega entidade por `resourceId` quando disponivel.
 - `mode='view'`: foco em leitura/apresentacao; actions de edicao podem ser suprimidas.