@praxisui/list 9.0.17 → 9.0.18

package/README.md

@@ -91,7 +91,7 @@ In remote mode, search, sort and export share a collection toolbar above the ite
 - `config: PraxisListConfig`: list/card/tile configuration.
 - `listId: string`: required stable id for persisted configuration.
 - `componentInstanceId?: string`: disambiguates repeated instances on the same route.
-- `configPersistenceStrategy: 'local-first' | 'input-first'`: config restore precedence.
+- `configPersistenceStrategy: 'local-first' | 'input-first' | 'volatile'`: config restore precedence; `volatile` disables configuration reads and writes for ephemeral previews.
 - `queryContext?: PraxisDataQueryContext`: runtime query context projected into remote data.
 - `form?: FormGroup`: external form context for selection/form bindings.
 - `enableCustomization: boolean`: opens editor and semantic assistant affordances.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-24T20:08:13.959Z",
+  "generatedAt": "2026-08-24T23:27:32.982Z",
   "packageName": "@praxisui/list",
-  "packageVersion": "9.0.17",
+  "packageVersion": "9.0.18",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,
@@ -31,9 +31,9 @@
         },
         {
           "name": "configPersistenceStrategy",
-          "type": "'local-first' | 'input-first'",
+          "type": "'local-first' | 'input-first' | 'volatile'",
           "required": false,
-          "description": "Define se a configuração local persistida ou a configuração recebida por input tem precedência na hidratação.",
+          "description": "Define a precedência da hidratação; volatile desabilita leitura e gravação de configuração para previews efêmeros.",
           "default": "local-first"
         },
         {
@@ -8785,9 +8785,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-list\nSelector: praxis-list\nFriendly Name: Praxis List\nDescription: Lista com suporte a seleção (single/multiple), agrupamento e templates.\nLib/Package: @praxisui/list\nTags: widget, list, lista, selection, configurable\nInputs:\n  - config (PraxisListConfig)\n  - listId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first')\n  - queryContext (PraxisDataQueryContext | null)\n  - form (FormGroup)\n  - enableCustomization (boolean)\nOutputs:\n  - itemClick (ListItemEvent)\n  - actionClick (ListActionEvent)\n  - selectionChange (ListSelectionEvent)\n",
+          "content": "Component ID: praxis-list\nSelector: praxis-list\nFriendly Name: Praxis List\nDescription: Lista com suporte a seleção (single/multiple), agrupamento e templates.\nLib/Package: @praxisui/list\nTags: widget, list, lista, selection, configurable\nInputs:\n  - config (PraxisListConfig)\n  - listId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - queryContext (PraxisDataQueryContext | null)\n  - form (FormGroup)\n  - enableCustomization (boolean)\nOutputs:\n  - itemClick (ListItemEvent)\n  - actionClick (ListActionEvent)\n  - selectionChange (ListSelectionEvent)\n",
           "sourcePointer": "projects/praxis-list/src/lib/praxis-list.metadata.ts",
-          "contentHash": "2517f19d442043072650cb9fa6a34568726535c778f0a4bbbc93d0b01b5df08a",
+          "contentHash": "f589cb2341d7a23ed3df996c9d11ffb8902a62747c54cf3c16187b503ab0df9a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-list",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-list.mjs

@@ -14584,6 +14584,9 @@ class PraxisList {
         }
     }
     storageKey() {
+        if (this.configPersistenceStrategy === 'volatile') {
+            return null;
+        }
         const id = this.componentKeyId();
         return id ? `praxis-list-config-${id}` : null;
     }
@@ -15831,6 +15834,87 @@ const PRAXIS_LIST_COMPONENT_METADATA = {
         componentId: 'praxis-list',
         source: 'PRAXIS_LIST_AUTHORING_MANIFEST',
     },
+    runtimeProfiles: [
+        {
+            id: 'public-local-volatile',
+            audience: 'public-untrusted',
+            description: 'Lista efêmera com dados inline e sem efeitos externos.',
+            constraints: [
+                { path: 'config.dataSource.data', operator: 'array' },
+                { path: 'config.dataSource.resourcePath', operator: 'absent-or-empty' },
+                { path: 'configPersistenceStrategy', operator: 'equals', value: 'volatile' },
+                { path: 'enableCustomization', operator: 'not-true' },
+                { path: 'config.actions', operator: 'empty-array-or-absent' },
+                { path: 'config.expansion', operator: 'absent-or-empty' },
+                { path: 'config.export.enabled', operator: 'not-true' },
+                {
+                    path: 'config.templating.leading.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.primary.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.secondary.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.trailing.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+            ],
+            effects: [],
+        },
+        {
+            id: 'public-resource-read',
+            audience: 'public-untrusted',
+            description: 'Leitura de recurso público, condicionada a capabilities do backend.',
+            constraints: [
+                { path: 'config.dataSource.data', operator: 'absent-or-empty' },
+                { path: 'config.dataSource.resourcePath', operator: 'present' },
+                { path: 'configPersistenceStrategy', operator: 'equals', value: 'volatile' },
+                { path: 'enableCustomization', operator: 'not-true' },
+                { path: 'config.actions', operator: 'empty-array-or-absent' },
+                { path: 'config.expansion', operator: 'absent-or-empty' },
+                { path: 'config.export.enabled', operator: 'not-true' },
+                {
+                    path: 'config.templating.leading.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.primary.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.secondary.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+                {
+                    path: 'config.templating.trailing.type',
+                    operator: 'none-of',
+                    values: ['image', 'html', 'component', 'slot'],
+                },
+            ],
+            effects: [
+                {
+                    kind: 'resource-read',
+                    resourcePath: 'config.dataSource.resourcePath',
+                    operations: [
+                        { operationId: 'filter', method: 'POST', pathSuffix: 'filter', role: 'primary' },
+                        { operationId: 'all', method: 'GET', pathSuffix: 'all', role: 'fallback' },
+                    ],
+                },
+            ],
+        },
+    ],
     configEditor: {
         component: PraxisListWidgetConfigEditor,
         title: 'Configure list',
@@ -15839,7 +15923,7 @@ const PRAXIS_LIST_COMPONENT_METADATA = {
         { name: 'config', type: 'PraxisListConfig', description: 'Configuração da lista (fonte de dados, layout, seleção, templates, ações)' },
         { name: 'listId', type: 'string', description: 'Identificador da lista (obrigatório para persistência)' },
         { name: 'componentInstanceId', type: 'string', description: 'Identificador opcional para múltiplas instâncias na mesma rota' },
-        { name: 'configPersistenceStrategy', type: "'local-first' | 'input-first'", default: 'local-first', description: 'Define se a configuração local persistida ou a configuração recebida por input tem precedência na hidratação.' },
+        { name: 'configPersistenceStrategy', type: "'local-first' | 'input-first' | 'volatile'", default: 'local-first', description: 'Define a precedência da hidratação; volatile desabilita leitura e gravação de configuração para previews efêmeros.' },
         { name: 'queryContext', type: 'PraxisDataQueryContext | null', description: 'Contexto runtime declarativo para filtros, ordenação e paginação sem persistir na configuração autorada.' },
         { name: 'form', type: 'FormGroup', description: 'FormGroup opcional quando integrado a formulários' },
         { name: 'enableCustomization', type: 'boolean', description: 'Input canônico para habilitar customização runtime, editor e AI assistant' },

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "9.0.17",
+  "version": "9.0.18",
   "description": "List components and helpers for Praxis UI.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/dynamic-fields": "^9.0.17",
+    "@praxisui/dynamic-fields": "^9.0.18",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.17",
-    "@praxisui/core": "^9.0.17",
-    "@praxisui/rich-content": "^9.0.17",
-    "@praxisui/settings-panel": "^9.0.17"
+    "@praxisui/ai": "^9.0.18",
+    "@praxisui/core": "^9.0.18",
+    "@praxisui/rich-content": "^9.0.18",
+    "@praxisui/settings-panel": "^9.0.18"
   },
   "dependencies": {
     "tslib": "^2.3.0",

package/src/lib/praxis-list.json-api.md

@@ -171,6 +171,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | Binding/Path          | Type                             | Required      | Source          | Runtime normalization                                       | Notes                                                                      |
 | --------------------- | -------------------------------- | ------------- | --------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------- |
 | `config`              | `PraxisListConfig`               | Yes (logical) | component-input | convertido para `ListAuthoringDocument` antes do apply plan | Config projetada de runtime; a autoria canônica é `ListAuthoringDocument`. |
+| `configPersistenceStrategy` | `'local-first' \| 'input-first' \| 'volatile'` | No | component-input | `volatile` elimina a chave de storage | Use `volatile` em previews efêmeros que não podem ler nem gravar configuração. |
 | `listId`              | `string`                         | Yes           | component-input | component key builder                                       | Necessário para escopo de persistência.                                    |
 | `componentInstanceId` | `string \| undefined`            | No            | component-input | component key scoping                                       | Evita colisão entre instâncias da mesma lista.                             |
 | `form`                | `FormGroup \| null \| undefined` | No            | component-input | selection adapter                                           | Integra seleção com controle externo quando configurado.                   |

package/types/praxisui-list.d.ts

@@ -482,7 +482,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     config: PraxisListConfig;
     listId: string;
     componentInstanceId?: string;
-    configPersistenceStrategy: 'local-first' | 'input-first';
+    configPersistenceStrategy: 'local-first' | 'input-first' | 'volatile';
     private runtimeQueryContext?;
     set queryContext(value: PraxisDataQueryContext | null | undefined);
     get queryContext(): PraxisDataQueryContext | null | undefined;