@praxisui/list 10.0.0-rc.3 → 10.0.0-rc.31

package/README.md

@@ -116,8 +116,9 @@ configured adapter; an in-memory adapter does not imply remote persistence.
 ## Configuration Highlights
 
 - Layout variants: `list`, `cards`, `tiles`.
-- Runtime-active layout fields include `lines`, `dividers`, `groupBy`, `pageSize`, `density` and `model`.
-- Templating slots include `leading`, `primary`, `secondary`, `meta`, `trailing`, `features`, `sectionHeader` and `emptyState`.
+- Runtime-active layout fields include `lines`, `dividers`, `groupBy`, `pageSize`, `density`, `model`, `cardColumns` (`'auto' | 1 | 2 | 3 | 4`), `cardMinWidth` and `cardMinHeight`.
+- Templating slots include `leading`, `primary`, `secondary`, `meta`, `trailing`, `features`, `sectionHeader` and `emptyState`, with `templating.statusPosition` (`'inline' | 'top-right'`) for card/tile status badges.
+- Item style rules (`rules.itemStyles[]`) support semantic `tone` (`'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'muted'`), materializing M3 token classes (`.pdx-list-item--<tone>`) without requiring raw CSS.
 - Leading images delegated to Rich Content stay within their reserved track and retain their aspect ratio. Skin overrides are rendered in an instance-scoped style element, using the supplied CSP nonce; updates replace that element's content and destruction removes it. Appearance presets wrap within narrow editors.
 - In `layout.rowLayout`, canonical semantic slots keep the configured desktop grid and reflow into ordered, non-overlapping rows at narrow viewports; extended operational slots stack without requiring host CSS.
 - Template expressions use `${item.field}`. Currency/date/number templates can use config i18n defaults.
@@ -148,10 +149,37 @@ Its validity is combined with raw JSON and document/query validation; visiting
 another tab preserves the text, and Reset discards it explicitly. See
 [Surface consumer validation](../praxis-core/docs/surface-draft-consumers-validation-2026-09-08.md).
 
+## Page Builder Integration & Insertion Presets
+
+`@praxisui/list` integrates directly with the visual palette of `@praxisui/page-builder`. Register its canonical metadata during app bootstrap:
+
+```ts
+import { providePraxisListMetadata } from '@praxisui/list';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    providePraxisListMetadata(),
+  ],
+};
+```
+
+When opened in the Page Builder, the component palette discovers `praxis-list` and exposes three structured canonical insertion presets (`PRAXIS_LIST_INSERTION_PRESETS`), enabling 1-click drag-and-drop authoring:
+
+1. **Feed operacional (`operational-feed`)**: Real-time event and alert stream featuring `pill-soft` skin, status icons, timestamp metadata, and contextual severity chips.
+2. **Catálogo com avatares (`avatar-catalog`)**: Executive personnel or asset card directory with `elevated` skin, single selection, avatar/photo icons, role/department secondary text, and status badges.
+3. **Lista financeira de saldos (`financial-metrics`)**: Corporate balance and liquidity overview with `glass` skin, category subtitles, and formatted currency metric blocks.
+
+Each preset preconfigures `configPersistenceStrategy: 'input-first'` and `enableCustomization: true`, and supplies representative starter data for immediate visual verification on the canvas.
+
+In the visual editor (`Data` tab), the data source summary displays the active resolution mode (**Local / sample data**, **Remote resource (API)**, or **No data source configured**). When a preset or authored list includes `dataSource.data`, those local rows take precedence over `dataSource.resourcePath`. Clicking **Use remote resource (remove local data)** clears `dataSource.data` so the configured `resourcePath` becomes active and loads its schema fields; during the same editing session, **Restore local data** can recover the stashed sample rows before saving, while **Reset** reverts the editor to its initial configuration snapshot.
+
 ## Public API Snapshot
 
 The root `@praxisui/list` entrypoint exports `PraxisList`, `PraxisListConfig`, list data services, templating/rich-content/selection adapters, metadata provider, list i18n helpers, AI capabilities, `PRAXIS_LIST_AUTHORING_MANIFEST` and `PraxisListDocPageComponent`. It also preserves the public editor classes `PraxisListConfigEditor` and `PraxisListWidgetConfigEditor`, and the types `PraxisListWidgetEditorInputs` and `PraxisListWidgetEditorValue`. Hosts can import these names directly from `@praxisui/list`; generic authoring hosts should resolve the configured editor through component metadata.
 
+Compact list, card and tile presenters delegated to `PraxisRichContent` use its existing `layout="inline"`: row slots, leading/primary/secondary content, metadata, trailing/status badges and features retain their intrinsic content width. Empty-state regions, section headers and rich-content expansion documents keep block rendering. Keep this distinction in the canonical List renderer; do not compensate with consumer CSS or remove Rich Content document containment. A rendered badge label needs a nonzero visible box: DOM text alone does not prove that a compact presenter is readable. Validate these compositions in their real desktop and narrow Dialog/list hosts.
+
+
 ## Official Links
 
 - Documentation: https://praxisui.dev/components/list

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-07T02:07:06.204Z",
+  "generatedAt": "2026-10-16T17:45:27.774Z",
   "packageName": "@praxisui/list",
-  "packageVersion": "10.0.0-rc.3",
+  "packageVersion": "10.0.0-rc.31",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,
@@ -488,6 +488,241 @@
         "componentId": "praxis-list",
         "source": "PRAXIS_LIST_AUTHORING_MANIFEST"
       },
+      "insertionPresets": [
+        {
+          "id": "operational-feed",
+          "label": "Feed operacional",
+          "description": "Feed de alertas e eventos em tempo real com status, timestamp e chips contextuais.",
+          "icon": "notifications_active",
+          "inputs": {
+            "configPersistenceStrategy": "input-first",
+            "enableCustomization": true,
+            "config": {
+              "id": "operational-feed-list",
+              "layout": {
+                "variant": "list",
+                "density": "comfortable",
+                "dividers": "between"
+              },
+              "skin": {
+                "type": "pill-soft"
+              },
+              "templating": {
+                "leading": {
+                  "type": "icon",
+                  "expr": "${item.icon}"
+                },
+                "primary": {
+                  "type": "text",
+                  "expr": "${item.title}"
+                },
+                "secondary": {
+                  "type": "text",
+                  "expr": "${item.timestamp} · ${item.source}"
+                },
+                "trailing": {
+                  "type": "chip",
+                  "expr": "${item.severity}",
+                  "variant": "filled"
+                }
+              },
+              "dataSource": {
+                "data": [
+                  {
+                    "id": "evt-101",
+                    "title": "Anomalia detectada em perímetro de segurança",
+                    "timestamp": "10:42",
+                    "source": "Sentinela Delta",
+                    "severity": "Crítica",
+                    "icon": "warning"
+                  },
+                  {
+                    "id": "evt-102",
+                    "title": "Sobrecarga de energia no reator auxiliar",
+                    "timestamp": "10:15",
+                    "source": "Subestação Sul",
+                    "severity": "Atenção",
+                    "icon": "bolt"
+                  },
+                  {
+                    "id": "evt-103",
+                    "title": "Sincronização de nós táticos concluída",
+                    "timestamp": "09:50",
+                    "source": "Comunicação Central",
+                    "severity": "Informativo",
+                    "icon": "info"
+                  }
+                ]
+              }
+            }
+          },
+          "shell": {
+            "kind": "dashboard-card",
+            "title": "Feed de Alertas",
+            "appearance": {
+              "body": {
+                "padding": "12px"
+              }
+            }
+          }
+        },
+        {
+          "id": "avatar-catalog",
+          "label": "Catálogo com avatares",
+          "description": "Lista executiva de integrantes ou ativos com foto/avatar, cargo, departamento e badges.",
+          "icon": "badge",
+          "inputs": {
+            "configPersistenceStrategy": "input-first",
+            "enableCustomization": true,
+            "config": {
+              "id": "avatar-catalog-list",
+              "layout": {
+                "variant": "cards",
+                "density": "comfortable",
+                "lines": 2
+              },
+              "skin": {
+                "type": "elevated"
+              },
+              "selection": {
+                "mode": "single",
+                "return": "item"
+              },
+              "templating": {
+                "leading": {
+                  "type": "icon",
+                  "expr": "account_circle"
+                },
+                "primary": {
+                  "type": "text",
+                  "expr": "${item.name}"
+                },
+                "secondary": {
+                  "type": "text",
+                  "expr": "${item.role} · ${item.department}"
+                },
+                "meta": {
+                  "type": "chip",
+                  "expr": "${item.status}",
+                  "variant": "outlined"
+                }
+              },
+              "dataSource": {
+                "data": [
+                  {
+                    "id": "emp-01",
+                    "name": "Ana Silva",
+                    "role": "Coordenadora de Projetos",
+                    "department": "Operações",
+                    "status": "Ativo"
+                  },
+                  {
+                    "id": "emp-02",
+                    "name": "Carlos Mendes",
+                    "role": "Analista de Sistemas",
+                    "department": "Tecnologia",
+                    "status": "Em Atendimento"
+                  },
+                  {
+                    "id": "emp-03",
+                    "name": "Mariana Costa",
+                    "role": "Especialista em Logística",
+                    "department": "Suprimentos",
+                    "status": "Disponível"
+                  }
+                ]
+              }
+            }
+          },
+          "shell": {
+            "kind": "dashboard-card",
+            "title": "Catálogo de Integrantes",
+            "appearance": {
+              "body": {
+                "padding": "12px"
+              }
+            }
+          }
+        },
+        {
+          "id": "financial-metrics",
+          "label": "Lista financeira de saldos",
+          "description": "Visão executiva de contas, saldos e limites com formatação monetária e indicadores.",
+          "icon": "account_balance_wallet",
+          "inputs": {
+            "configPersistenceStrategy": "input-first",
+            "enableCustomization": true,
+            "config": {
+              "id": "financial-metrics-list",
+              "layout": {
+                "variant": "tiles",
+                "density": "comfortable"
+              },
+              "skin": {
+                "type": "glass"
+              },
+              "templating": {
+                "leading": {
+                  "type": "icon",
+                  "expr": "account_balance_wallet"
+                },
+                "primary": {
+                  "type": "text",
+                  "expr": "${item.accountName}"
+                },
+                "secondary": {
+                  "type": "text",
+                  "expr": "${item.category} · Conta ${item.accountNumber}"
+                },
+                "trailing": {
+                  "type": "metric",
+                  "props": {
+                    "metric": {
+                      "valueExpr": "${item.balance}",
+                      "tone": "primary",
+                      "layout": "value-only"
+                    }
+                  }
+                }
+              },
+              "dataSource": {
+                "data": [
+                  {
+                    "id": "acc-01",
+                    "accountName": "Fundo Operacional Alfa",
+                    "category": "Operações",
+                    "accountNumber": "4482-1",
+                    "balance": "R$ 1.450.000,00"
+                  },
+                  {
+                    "id": "acc-02",
+                    "accountName": "Reserva Estratégica de Emergência",
+                    "category": "Tesouraria",
+                    "accountNumber": "9920-5",
+                    "balance": "R$ 820.000,00"
+                  },
+                  {
+                    "id": "acc-03",
+                    "accountName": "Folha de Prontidão e Benefícios",
+                    "category": "Recursos Humanos",
+                    "accountNumber": "3310-8",
+                    "balance": "R$ 390.000,00"
+                  }
+                ]
+              }
+            }
+          },
+          "shell": {
+            "kind": "dashboard-card",
+            "title": "Saldos e Disponibilidades",
+            "appearance": {
+              "body": {
+                "padding": "12px"
+              }
+            }
+          }
+        }
+      ],
       "source": "projects/praxis-list/src/lib/praxis-list.metadata.ts",
       "exportName": "PRAXIS_LIST_COMPONENT_METADATA",
       "componentCapabilities": [
@@ -9066,9 +9301,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' | 'volatile')\n  - queryContext (PraxisDataQueryContext | null)\n  - form (FormGroup)\n  - enableCustomization (boolean)\nOutputs:\n  - configPatchChange ({ inputPatch: { config: PraxisListConfig } })\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  - configPatchChange ({ inputPatch: { config: PraxisListConfig } })\n  - itemClick (ListItemEvent)\n  - actionClick (ListActionEvent)\n  - selectionChange (ListSelectionEvent)\nInsertion Presets:\n  - operational-feed: Feed operacional - Feed de alertas e eventos em tempo real com status, timestamp e chips contextuais.\n  - avatar-catalog: Catálogo com avatares - Lista executiva de integrantes ou ativos com foto/avatar, cargo, departamento e badges.\n  - financial-metrics: Lista financeira de saldos - Visão executiva de contas, saldos e limites com formatação monetária e indicadores.\n",
           "sourcePointer": "projects/praxis-list/src/lib/praxis-list.metadata.ts",
-          "contentHash": "edfe4ebebb53222fa9c50c8dfce03f969d98f8efb5068b074dc51df5fb864e4a",
+          "contentHash": "c57e358dddfd21ae247e6b7e37f3c671eef5278d9ca14a21124a293e030e9e69",
           "sourceKind": "component_definition",
           "sourceId": "praxis-list",
           "corpusVersion": "1.0.0"