@praxisui/page-builder 9.0.27 → 9.0.28

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
@@ -73,6 +73,8 @@ The persisted document remains `WidgetPageDefinition` from `@praxisui/core`. Pag
73
73
  - `context`: runtime context shared with widgets and composition links
74
74
  - `enableCustomization`: enables builder and child authoring affordances; when `false`, the same
75
75
  runtime remains mounted in presentation mode without editing chrome
76
+ - `authoringCapabilities`: optional host-only `PageBuilderAuthoringCapabilities` grant that limits
77
+ the authoring operations exposed by the builder while keeping the runtime mounted
76
78
  - `pageIdentity`: persistence identity used by governed config flows
77
79
  - `componentInstanceId`: stable component instance id
78
80
  - `componentPaletteAllowedWidgetIds`, `componentPaletteAllowedWidgetTags`, `componentPaletteAllowedPresetIds`
@@ -80,6 +82,39 @@ The persisted document remains `WidgetPageDefinition` from `@praxisui/core`. Pag
80
82
  - `agenticAuthoringIncludeLlmDiagnostics`, `agenticAuthoringEnableStreaming`, `agenticAuthoringContextHints`
81
83
  - `showPageLifecycleActions`, `canDeleteSavedPage`, `pageLifecycleBusy`
82
84
 
85
+ All omitted `authoringCapabilities` entries remain enabled for backward compatibility. The grant is
86
+ never written to `WidgetPageDefinition` and does not authorize AI operations; manifests, backend
87
+ policy, target resolution and validation remain authoritative.
88
+
89
+ For example, a host that should expose only canvas and shell-identity authoring can declare:
90
+
91
+ ```ts
92
+ import type { PageBuilderAuthoringCapabilities } from '@praxisui/page-builder';
93
+
94
+ readonly presentationAuthoring: PageBuilderAuthoringCapabilities = {
95
+ canvas: true,
96
+ pageSettings: false,
97
+ widgetShell: {
98
+ identity: true,
99
+ appearance: false,
100
+ actions: false,
101
+ pagePreset: false,
102
+ },
103
+ widgetInputs: false,
104
+ widgetRemoval: false,
105
+ childCustomization: false,
106
+ insertWidgets: false,
107
+ connections: false,
108
+ save: false,
109
+ preview: true,
110
+ agentic: false,
111
+ pageLifecycle: false,
112
+ };
113
+ ```
114
+
115
+ Bind the grant with `[authoringCapabilities]="presentationAuthoring"`. Use
116
+ `[enableCustomization]="false"` when no authoring affordance should be exposed at all.
117
+
83
118
  It emits:
84
119
 
85
120
  - `pageChange`: updated `WidgetPageDefinition`