@praxisui/rich-content 9.0.68-rc.3 → 10.0.0-rc.3

package/README.md

@@ -93,6 +93,8 @@ Use the `pageHeader` semantic node for a functionality opening rather than styli
 - `relatedLinks` contains ordinary `link` nodes, never fabricated action IDs. Author real destinations and required context in the URL. The editor currently accepts registered action IDs and URLs; it does not provide a routing catalog or invent application routes.
 
 The opening owns page-wide identity and actions. Keep filters and table-specific commands in the table, and avoid duplicate actions. Blank optional regions are omitted. Existing cards remain cards; migration to a page header is explicit.
+`rootClassName` accepts only whitespace-separated CSS class tokens. The config editor blocks invalid values, and the runtime ignores an unsafe value if an untrusted document bypasses authoring validation.
+Composite hosts can apply the same policy before persistence through the exported `isSafeRichContentClassName` predicate; document content continues to use `validateRichContentDocument`.
 
 ## Page Builder Integration
 
@@ -164,7 +166,7 @@ The validator rejects unsupported document versions, unknown node types, unsafe
 
 The editor separates authoring into guided editing, preview and advanced JSON tabs. Guided editing keeps the document structure visible while document-level context (`context.scopes`, `context.aliases`) and the selected block expose focused controls. The advanced data/rule section surfaces canonical bindings and JsonLogic fields (`bindings`, `disabledWhen`, `loadWhen`, `classWhen`, `styleWhen`) as focused JSON editors, validates them before apply/save, and keeps the full document JSON synchronized. Preview renders the materialized document without mixing authoring fields, and advanced JSON remains available for diagnostics, migration and less common deep structures.
 
-The editor supports structured block authoring, nested card/timeline/action collections, preset selection, validation badges and advanced JSON for less common deep structures. Labels and validation messages use the rich-content i18n dictionary; override them with `providePraxisRichContentI18n()`.
+The editor supports structured block authoring, nested card/timeline/action collections, preset selection, validation badges and advanced JSON for less common deep structures. A card body can contain a guided `compose` block, allowing icons, labels, badges, metrics, progress and action buttons bound to several record fields to be arranged in a row or column with governed spacing and wrapping. Labels and validation messages use the rich-content i18n dictionary; override them with `providePraxisRichContentI18n()`.
 
 `PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST` describes governed AI/tooling operations for document replacement, block add/remove/order, text updates, link nodes, media blocks, timeline nodes/items, presets, metadata and sanitization policy. Rich content authoring is structured JSON, not arbitrary HTML or markdown patches.
 
@@ -185,3 +187,10 @@ Main exports include `PraxisRichContent`, `PraxisRichContentConfigEditor`, `Rich
 - Quickstart app: https://github.com/codexrodrigues/praxis-ui-quickstart
 
 Guided validation keeps an empty required title as a repairable draft, marks the title field with its semantic error, and blocks saving/unsafe preview. The title keeps a stable accessible name; errors are associated descriptions. “Invalid document” identifies schema errors, while “Invalid JSON” is reserved for JSON syntax errors.
+
+<!-- praxis-npm-catalog-links:start -->
+## Official documentation and examples
+
+- [Canonical technical overview: Overview](https://praxisui.dev/docs/components/praxis-rich-content)
+- [Praxis Angular public catalog](https://praxisui.dev/angular)
+<!-- praxis-npm-catalog-links:end -->