@praxisui/page-builder 9.0.0-beta.4 → 9.0.0-beta.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -26,7 +26,7 @@ npm i @praxisui/page-builder@latest
26
26
  Peer dependencies:
27
27
 
28
28
  - `@angular/common`, `@angular/core`, `@angular/forms`, `@angular/cdk`, `@angular/material` `^21.0.0`
29
- - `@praxisui/ai`, `@praxisui/core`, `@praxisui/settings-panel` `^9.0.0-beta.4`
29
+ - `@praxisui/ai`, `@praxisui/core`, `@praxisui/settings-panel` `^9.0.0-beta.12`
30
30
  - `rxjs` `~7.8.0`
31
31
 
32
32
  ## Quick Start
@@ -115,6 +115,20 @@ const page: WidgetPageDefinition = {
115
115
 
116
116
  Use the same canonical `composition.links` contract for widget-to-widget links, nested component ports through `nestedPath`, and global actions through `to.kind = "global-action"`.
117
117
 
118
+ ## Connection Editor
119
+
120
+ The visual connection editor is an authoring surface over the saved `composition.links` document. It does not create a parallel graph DSL.
121
+
122
+ Current capabilities include:
123
+
124
+ - inspecting persisted links, endpoints, intent, condition, transform and policy;
125
+ - highlighting widget, state and global-action flows in the same graph;
126
+ - creating assisted links only between known endpoints;
127
+ - suggesting canonical table row selection to form detail wiring with a `payload.row.id` projection when the existing ports support that flow;
128
+ - explaining nested component ports by showing the `nestedPath` while preserving the top-level widget as the canonical endpoint owner.
129
+
130
+ For nested components, keep `ref.widget` pointed at the top-level host widget and describe the internal target with `ref.nestedPath`. The editor should make that ownership visible instead of flattening child widgets into a second page-level widget namespace.
131
+
118
132
  ## Settings Panel Bridge
119
133
 
120
134
  Register the Settings Panel bridge when the host must open page, shell, and component config editors in a side panel.
@@ -133,6 +147,15 @@ providers: [
133
147
 
134
148
  Component input editors belong to the component owner. Page Builder discovers `ComponentDocMeta.configEditor` and hosts the published editor instead of redefining table, form, chart, list, upload, stepper, tab, expansion, CRUD, or rich-content configuration locally.
135
149
 
150
+ ## Page Settings Presets
151
+
152
+ Page settings expose the canonical layout and theme preset catalogs from `@praxisui/core`.
153
+
154
+ - `layoutPreset` selects the structural page template, including default grouping, slot expectations, responsive policy, and a recommended theme.
155
+ - `themePreset` is optional. When omitted, the runtime inherits the selected layout preset's `defaultThemePreset`.
156
+ - Pin `themePreset` only when the page must intentionally diverge from future layout-preset defaults or when governance requires an explicit visual decision in the saved document.
157
+ - Canvas item positions remain explicit page state. Presets guide layout, grouping, slot intent, and theme inheritance; they do not silently rewrite existing widget geometry.
158
+
136
159
  ## AI Authoring
137
160
 
138
161
  Register widget capability catalogs so the assistant can reason about component inputs and supported operations.