@praxisui/page-builder 9.0.68-rc.3 → 10.0.0-rc.10

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@praxisui/page-builder",
3
- "version": "9.0.68-rc.3",
3
+ "version": "10.0.0-rc.10",
4
4
  "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
5
5
  "peerDependencies": {
6
6
  "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
8
8
  "@angular/forms": "^21.0.0",
9
9
  "@angular/cdk": "^21.0.0",
10
10
  "@angular/material": "^21.0.0",
11
- "@praxisui/ai": "^9.0.68-rc.3",
12
- "@praxisui/core": "^9.0.68-rc.3",
13
- "@praxisui/settings-panel": "^9.0.68-rc.3",
11
+ "@praxisui/ai": "^10.0.0-rc.10",
12
+ "@praxisui/core": "^10.0.0-rc.10",
13
+ "@praxisui/settings-panel": "^10.0.0-rc.10",
14
14
  "rxjs": "~7.8.0"
15
15
  },
16
16
  "dependencies": {
@@ -2,7 +2,7 @@ import { MatDialogRef, MatDialog } from '@angular/material/dialog';
2
2
  import * as _angular_core from '@angular/core';
3
3
  import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
4
4
  import * as _praxisui_core from '@praxisui/core';
5
- import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
5
+ import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetPagePersistenceState, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
6
6
  import * as rxjs from 'rxjs';
7
7
  import { BehaviorSubject, Observable } from 'rxjs';
8
8
  import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
@@ -475,6 +475,7 @@ type ConnectionEditorDockTab = 'json' | 'links' | 'derived' | 'export';
475
475
  type ConnectionEditorConditionPreset = 'source-present' | 'source-id-present';
476
476
  type ConnectionEditorPolicyPreset = 'stable-delivery' | 'skip-missing';
477
477
  type ConnectionEditorVisualDensity = 'guided' | 'full';
478
+ type ConnectionEditorGlobalActionPayloadSource = 'expression' | 'literal' | 'delivery';
478
479
  interface DragState {
479
480
  port: ConnectionEditorPort;
480
481
  source: ConnectionEditorPoint;
@@ -540,11 +541,13 @@ interface ConnectionEditorDockTabDefinition {
540
541
  glyph: string;
541
542
  }
542
543
  declare class ConnectionEditorComponent {
544
+ private static nextDraftDescriptionInstanceId;
543
545
  readonly stateNodeId = "__page_state__";
544
546
  protected readonly minZoom = 0.2;
545
547
  protected readonly maxZoom = 1.8;
546
548
  readonly nodeViewBox = "0 0 168 168";
547
549
  readonly canvasViewBox = "0 0 900 540";
550
+ readonly draftDescriptionIdPrefix: string;
548
551
  readonly nodeHaloPaths: string[];
549
552
  private readonly injector;
550
553
  private readonly i18n;
@@ -571,6 +574,7 @@ declare class ConnectionEditorComponent {
571
574
  readonly draftPorts: _angular_core.Signal<ConnectionEditorPort[]>;
572
575
  readonly draftSources: _angular_core.Signal<ConnectionEditorPort[]>;
573
576
  readonly draftTargets: _angular_core.Signal<ConnectionEditorPort[]>;
577
+ readonly draftEndpointsComplete: _angular_core.Signal<boolean>;
574
578
  readonly draftDiagnostics: _angular_core.Signal<_praxisui_core.DiagnosticRecord[]>;
575
579
  readonly draftDuplicate: _angular_core.Signal<boolean>;
576
580
  readonly draftExistingRoute: _angular_core.Signal<ConnectionEditorConnection | null>;
@@ -595,6 +599,8 @@ declare class ConnectionEditorComponent {
595
599
  readonly hoveredNodeId: _angular_core.WritableSignal<string | null>;
596
600
  readonly visualDensity: _angular_core.WritableSignal<ConnectionEditorVisualDensity>;
597
601
  private readonly invalidSurfaceDrafts;
602
+ /** Keeps the mounted Surface editor's local draft intact while expression is the effective source. */
603
+ private readonly surfaceOpenPayloadSnapshots;
598
604
  readonly surfaceDraftInvalid: _angular_core.WritableSignal<boolean>;
599
605
  onSurfaceDraftValidity(source: SurfaceOpenActionEditorComponent, connection: ConnectionEditorConnection, valid: boolean): void;
600
606
  readonly globalActionPayloadError: _angular_core.WritableSignal<string | null>;
@@ -958,6 +964,10 @@ declare class ConnectionEditorComponent {
958
964
  describeSource(edge: ConnectionsViewerEdge): string;
959
965
  describeTarget(edge: ConnectionsViewerEdge): string;
960
966
  globalActionPayloadText(connection: ConnectionEditorConnection): string;
967
+ globalActionPayloadSource(connection: ConnectionEditorConnection): ConnectionEditorGlobalActionPayloadSource;
968
+ globalActionPayloadExpression(connection: ConnectionEditorConnection): string;
969
+ globalActionHasStructuredPayload(connection: ConnectionEditorConnection): boolean;
970
+ useGlobalActionPayloadSource(connection: ConnectionEditorConnection, source: Extract<ConnectionEditorGlobalActionPayloadSource, 'expression' | 'literal'>): void;
961
971
  globalActionPayloadExample(connection: ConnectionEditorConnection): string;
962
972
  surfaceOpenPayloadValue(connection: ConnectionEditorConnection): SurfaceOpenPayload | null;
963
973
  surfaceOpenHostKind(connection: ConnectionEditorConnection): string;
@@ -971,6 +981,7 @@ declare class ConnectionEditorComponent {
971
981
  changeDraftPickPath(index: number, path: string): void;
972
982
  draftPortLabel(port: ConnectionEditorPort): string;
973
983
  draftEndpointLabel(id: string): string;
984
+ draftPortDescription(id: string): string;
974
985
  applyDraft(): void;
975
986
  cancelDraft(): void;
976
987
  private clearDraft;
@@ -1009,6 +1020,14 @@ declare class ConnectionEditorComponent {
1009
1020
  private scrollActiveModeIntoView;
1010
1021
  private focusDockTab;
1011
1022
  private focusEditorSurface;
1023
+ private focusNewConnectionAfterDraftCancel;
1024
+ private refreshSurfaceDraftValidity;
1025
+ private asSurfaceOpenPayload;
1026
+ hasInactiveSurfaceDraft(connection: ConnectionEditorConnection): boolean;
1027
+ private hasInvalidSurfaceDraft;
1028
+ private isSurfaceOpenLink;
1029
+ private discardSurfaceDraftState;
1030
+ private focusGlobalActionPayloadSourceAfterRender;
1012
1031
  private portQualifiedLabel;
1013
1032
  private stagePointFromEvent;
1014
1033
  private rotationAngleForNode;
@@ -1167,6 +1186,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
1167
1186
  key: string;
1168
1187
  number: number;
1169
1188
  label: string;
1189
+ widgetKey?: string;
1170
1190
  col: number;
1171
1191
  row: number;
1172
1192
  colSpan: number;
@@ -2134,7 +2154,7 @@ type BuilderCanvasLayout = {
2134
2154
  rowUnit?: string;
2135
2155
  gap?: string;
2136
2156
  autoRows?: 'fixed' | 'content';
2137
- collisionPolicy?: 'block' | 'swap';
2157
+ collisionPolicy?: 'block' | 'swap' | 'push-down';
2138
2158
  items: Record<string, BuilderCanvasItem>;
2139
2159
  };
2140
2160
  type BuilderPageDefinition = Omit<WidgetPageDefinition, 'widgets'> & {
@@ -2318,6 +2338,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2318
2338
  page?: WidgetPageDefinition | string;
2319
2339
  context?: Record<string, unknown> | null;
2320
2340
  strictValidation: boolean;
2341
+ /** Opt in to Core persistence; hosts managing their own documents leave this disabled. */
2321
2342
  autoPersist: boolean;
2322
2343
  enableCustomization: boolean;
2323
2344
  authoringCapabilities?: PageBuilderAuthoringCapabilities | null;
@@ -2345,6 +2366,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2345
2366
  canDeleteSavedPage: boolean;
2346
2367
  pageLifecycleBusy: boolean;
2347
2368
  pageLifecycleResetRevision: number | string | null;
2369
+ readonly persistenceChange: _angular_core.OutputEmitterRef<WidgetPagePersistenceState>;
2370
+ private runtimePersistenceStatus;
2348
2371
  pageChange: EventEmitter<WidgetPageDefinition>;
2349
2372
  /** Emits only explicit visual authoring operations, never runtime state changes. */
2350
2373
  readonly pageAuthoringChange: _angular_core.OutputEmitterRef<WidgetPageDefinition>;
@@ -2433,6 +2456,13 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2433
2456
  runtimePage(): WidgetPageDefinition;
2434
2457
  runtimeAuthoringCapabilities(): PageBuilderAuthoringCapabilities;
2435
2458
  builderModeLabel(): string;
2459
+ /** Governed documents and agentic previews retain their explicit host/apply lifecycle. */
2460
+ runtimeAutoPersist(): boolean;
2461
+ /** Explicitly discard the local draft and reload the current identity's saved page. */
2462
+ reloadPersistedPage(defaultPage: WidgetPageDefinition): void;
2463
+ /** Clear the current identity's saved document after storage acknowledgement. */
2464
+ resetPersistedPage(defaultPage: WidgetPageDefinition): void;
2465
+ onRuntimePersistenceChange(state: WidgetPagePersistenceState): void;
2436
2466
  onRuntimePageChange(next: WidgetPageDefinition): void;
2437
2467
  onRuntimePageAuthoringChange(next: WidgetPageDefinition): void;
2438
2468
  onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
@@ -2457,6 +2487,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2457
2487
  addWidget(selection: string | ComponentPaletteSelection): void;
2458
2488
  private layoutHintsFor;
2459
2489
  openPageSettings(): void;
2490
+ /** Retries the current persisted draft, including an intentionally empty page. */
2491
+ retryPersistedPage(): void;
2460
2492
  saveCurrentPage(): void;
2461
2493
  canSaveCurrentPage(): boolean;
2462
2494
  private evaluatePremiumReadiness;
@@ -2660,6 +2692,16 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2660
2692
  private toRecord;
2661
2693
  private resolvePreviewCompiledFormPatch;
2662
2694
  focusCanvasWidget(widgetKey: string): void;
2695
+ /**
2696
+ * Directly updates a single input on a rendered widget without recreating
2697
+ * or rerendering the canvas or sibling widgets.
2698
+ */
2699
+ setWidgetInput(widgetKey: string, inputName: string, value: unknown): boolean;
2700
+ /**
2701
+ * Directly patches multiple inputs on a rendered widget without recreating
2702
+ * or rerendering the canvas or sibling widgets.
2703
+ */
2704
+ patchWidgetInputs(widgetKey: string, inputPatch: Record<string, unknown>): boolean;
2663
2705
  private openWidgetConfiguration;
2664
2706
  private selectInsertedWidget;
2665
2707
  private deferInsertedWidgetFocus;
@@ -2667,6 +2709,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2667
2709
  private escapeAttributeValue;
2668
2710
  private parsePage;
2669
2711
  private clonePage;
2712
+ private clonePagePreservingInputs;
2713
+ private cloneInputsPreservingLiveReferences;
2670
2714
  private clearSelectedWidgetIfMissing;
2671
2715
  private defaultInputsFor;
2672
2716
  private applyWidgetIdentityDefaults;
@@ -2687,7 +2731,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
2687
2731
  authoringSourceDiagnosticText(diagnostic: UiCompositionAuthoringSourceDiagnostic): string;
2688
2732
  tx(key: string, fallback: string): string;
2689
2733
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
2690
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringVoiceInputMode": { "alias": "agenticAuthoringVoiceInputMode"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "authoringDocument": { "alias": "authoringDocument"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "pageAuthoringChange": "pageAuthoringChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
2734
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringVoiceInputMode": { "alias": "agenticAuthoringVoiceInputMode"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "authoringDocument": { "alias": "authoringDocument"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "persistenceChange": "persistenceChange"; "pageChange": "pageChange"; "pageAuthoringChange": "pageAuthoringChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
2691
2735
  }
2692
2736
 
2693
2737
  /** Metadata for Praxis Page Builder component */
@@ -2695,5 +2739,19 @@ declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
2695
2739
  /** Provider para auto-registrar metadados do componente Page Builder. */
2696
2740
  declare function providePraxisPageBuilderMetadata(): Provider;
2697
2741
 
2698
- export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
2742
+ /**
2743
+ * Type guard that verifies if an item is a canonical ComponentDocMeta.
2744
+ */
2745
+ declare function isComponentDocMeta(value: unknown): value is ComponentDocMeta;
2746
+ /**
2747
+ * Convenient provider factory for registering widgets in the Page Builder host.
2748
+ *
2749
+ * Accepts a list of either Angular `Provider` entries (such as `providePraxisListMetadata()`)
2750
+ * or direct `ComponentDocMeta` definitions (such as `PRAXIS_LIST_COMPONENT_METADATA`).
2751
+ * Any `ComponentDocMeta` passed will be automatically registered with the
2752
+ * `ComponentMetadataRegistry` during environment initialization.
2753
+ */
2754
+ declare function providePraxisPageBuilderWidgets(widgets?: Array<Provider | ComponentDocMeta>): Provider[];
2755
+
2756
+ export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
2699
2757
  export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionAuthoringSourceDiagnostic, UiCompositionAuthoringSourceDiagnosticCode, UiCompositionAuthoringSourceVerification, UiCompositionAuthoringSourceVerificationContext, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanAuthoringSource, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectCase, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };