@praxisui/page-builder 10.0.0-rc.38 → 10.0.0-rc.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "10.0.0-rc.38",
+  "version": "10.0.0-rc.39",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.38",
-    "@praxisui/core": "^10.0.0-rc.38",
-    "@praxisui/settings-panel": "^10.0.0-rc.38",
+    "@praxisui/ai": "^10.0.0-rc.39",
+    "@praxisui/core": "^10.0.0-rc.39",
+    "@praxisui/settings-panel": "^10.0.0-rc.39",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -2,7 +2,7 @@ import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
-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, DiscoveredResourceOption, FieldDefinition, WidgetPageGroupingDefinition, WidgetPageDataSourceDefinition, WidgetPageDataSourceKind, WidgetPageDataSourceMethod, WidgetPageDataSourceErrorPolicy, 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, PageAuthoringDocument } from '@praxisui/core';
+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, DiscoveredResourceOption, FieldDefinition, WidgetPageGroupingDefinition, WidgetPageDataSourceDefinition, WidgetPageDataSourceKind, WidgetPageDataSourceMethod, WidgetPageDataSourceErrorPolicy, 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, PageAuthoringDocument, UiLayoutLayerClass, UiLayoutAssignmentSelector, PageDocumentDiagnostic, PageSourceReference, UiLayoutPageChildSource, UiLayoutTarget, PageCatalogEntry, NavigationGroupsAuthoringDocument, RuntimeNavigationMenuNode, PageCreationCommand, UiLayoutLifecycleHttpReceipt, PageCreationReceipt, PageCatalogReadOptions, PageCatalogResponse, UiLayoutLifecycleNotModifiedReceipt, PublishedPageReadResponse, UiLayoutDraftReceipt, UiLayoutDraftWorkspaceReceipt, UiLayoutReleaseReviewReceipt, UiLayoutReleaseHeadReceipt, UiLayoutRevisionCommand, UiLayoutRevisionCommandResult, UiLayoutAssignmentCommand, UiLayoutAssignmentCommandResult, UiLayoutFreezeReleaseCommand, UiLayoutFreezeReleaseCommandResult, UiLayoutReasonCommand, UiLayoutHeadWriteCondition, UiLayoutReleaseReferenceCommand, GovernedPagePreviewMaterialization, PageChildDocumentValidators, GovernedPagePreviewWidgetAdapters, UiLayoutLifecycleService, NavigationGroupAuthoringEntry, EffectiveUiLayoutService, PageNavigationBinding, PageNavigationBindingUpdateOptions } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
@@ -3205,5 +3205,312 @@ declare class PraxisPageCopyActionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisPageCopyActionComponent, "praxis-page-copy-action", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "canCopy": { "alias": "canCopy"; "required": false; "isSignal": true; }; }, { "copyRequested": "copyRequested"; }, never, never, true, never>;
 }
 
-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, PraxisPageCopyActionComponent, PraxisPageSaveAsComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
-export type { Capability, CapabilityCatalog, CapabilityCategory, CollectionScreenComposerConfig, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, GuidedDataSourceQueryConfig, GuidedDataSourceTransformConfig, GuidedDerivedMeasureConfig, 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, PageSaveAsAdapter, PageSaveAsRequest, PageSaveAsResult, PaletteCategory, PaletteExistingCanvasItem, QueuedPaletteItem, 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 };
+interface GovernedPageCapabilities {
+    readonly canAuthorPages: boolean;
+    readonly canSubmitForReview: boolean;
+    readonly canApproveReleases: boolean;
+    readonly canPublishReleases: boolean;
+    readonly canManageNavigationGroups: boolean;
+}
+declare const GOVERNED_PAGE_CAPABILITY_KEYS: Readonly<{
+    authorPages: "praxis.config.pages.author";
+    submitForReview: "praxis.config.pages.submit";
+    approveReleases: "praxis.config.pages.approve";
+    publishReleases: "praxis.config.pages.publish";
+    manageNavigationGroups: "praxis.config.navigation.manage";
+}>;
+/**
+ * Derives governed page capabilities from canonical server-issued capability keys.
+ * Never fabricates approval or publication authority when a capability is absent.
+ */
+declare function deriveGovernedPageCapabilities(grantedCapabilities: Iterable<string> | null | undefined): GovernedPageCapabilities;
+type GovernedPageReadResult<T> = UiLayoutLifecycleHttpReceipt<T> | UiLayoutLifecycleNotModifiedReceipt;
+interface GovernedPagePersistenceAdapter {
+    readonly mode: 'corporate';
+    createPage(command: PageCreationCommand): Promise<UiLayoutLifecycleHttpReceipt<PageCreationReceipt>>;
+    readPageByCreationKey(creationKey: string): Promise<UiLayoutLifecycleHttpReceipt<PageCreationReceipt>>;
+    readPageCatalog(options?: PageCatalogReadOptions): Promise<PageCatalogResponse>;
+    readPublishedPage(pageId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<PublishedPageReadResponse>>;
+    readDraftByCreationKey(target: UiLayoutTarget, creationKey: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutDraftReceipt>>;
+    readDraft(target: UiLayoutTarget, draftId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutDraftWorkspaceReceipt>>;
+    readReview(target: UiLayoutTarget, releaseId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutReleaseReviewReceipt>>;
+    readHead(target: UiLayoutTarget, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutReleaseHeadReceipt>>;
+    createDraft(target: UiLayoutTarget, idempotencyKey: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutDraftWorkspaceReceipt>>;
+    createRevision(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutRevisionCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutRevisionCommandResult>>;
+    createAssignment(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutAssignmentCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutAssignmentCommandResult>>;
+    freezeRelease(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutFreezeReleaseCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutFreezeReleaseCommandResult>>;
+    submit(target: UiLayoutTarget, releaseId: string, reviewEtag: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseReviewReceipt>>;
+    approve(target: UiLayoutTarget, releaseId: string, reviewEtag: string, command: UiLayoutReasonCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseReviewReceipt>>;
+    publish(target: UiLayoutTarget, condition: UiLayoutHeadWriteCondition, command: UiLayoutReleaseReferenceCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseHeadReceipt>>;
+}
+declare function createCorporateGovernedPagePersistenceAdapter(lifecycle: Pick<UiLayoutLifecycleService, 'createPage' | 'readPageByCreationKey' | 'readPageCatalog' | 'readPublishedPage' | 'readDraftByCreationKey' | 'readDraft' | 'readReview' | 'readHead' | 'createDraft' | 'createRevision' | 'createAssignment' | 'freezeRelease' | 'submit' | 'approve' | 'publish'>): GovernedPagePersistenceAdapter;
+/**
+ * Explicit local/sandbox Save-As adapter contract.
+ * Never simulates corporate review/approval/release states in the browser.
+ */
+interface GovernedPageLocalSaveAdapter extends PageSaveAsAdapter {
+    readonly mode: 'local';
+}
+declare function createLocalPageSaveAsAdapter(handler: (request: PageSaveAsRequest) => Promise<PageSaveAsResult>): GovernedPageLocalSaveAdapter;
+type GovernedPageOperationKind = 'create-page' | 'import-legacy-page' | 'save-revision' | 'assign-scope' | 'freeze-release' | 'submit-review' | 'approve-release' | 'publish-release';
+declare const LEGACY_PUBLISHED_PAGE_STORAGE_PREFIX: "published-page:";
+interface GovernedPageLegacyExportArtifact {
+    readonly schemaVersion: '1.0.0';
+    readonly kind: 'legacy-published-page-export';
+    readonly storageKey: string;
+    readonly pageId: string;
+    readonly routePath: `/pages/${string}`;
+    readonly compatible: boolean;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly rawPayload: unknown;
+}
+interface GovernedPageLegacyInspectionResult {
+    readonly storageKey: string;
+    readonly pageId: string;
+    readonly routePath: `/pages/${string}`;
+    readonly target: UiLayoutTarget;
+    readonly compatible: boolean;
+    readonly source: PageSourceReference | null;
+    readonly childSources: readonly UiLayoutPageChildSource[];
+    readonly authoringDocument: PageAuthoringDocument | null;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly exportableArtifact: GovernedPageLegacyExportArtifact;
+}
+interface GovernedPageLegacyImportRequest {
+    readonly pageId: string;
+    readonly rawPayload: unknown;
+    readonly source?: PageSourceReference;
+    readonly childSources?: readonly UiLayoutPageChildSource[];
+    readonly reason?: string;
+    readonly idempotencyKey?: string;
+}
+interface GovernedPageUncertainOperation {
+    readonly operation: GovernedPageOperationKind;
+    readonly attemptKey: string;
+    readonly creationKey?: string;
+    readonly commandRef?: string;
+    readonly draftId?: string;
+    readonly releaseId?: string;
+    readonly source?: PageSourceReference | null;
+    readonly childSources?: readonly UiLayoutPageChildSource[];
+    readonly occurredAt: string;
+}
+interface GovernedPageWorkflowError {
+    readonly code: 'CAPABILITY_DENIED' | 'CONTEXT_OBSOLETE' | 'COMMAND_OUTCOME_UNCERTAIN' | 'OPERATION_FENCED' | 'PRECONDITION_FAILED' | 'CONFLICT' | 'VALIDATION_FAILED' | 'PREVIEW_UNCERTIFIED' | 'ETAG_NOT_PROGRESSED' | 'DRAFT_NOT_LOADED' | 'RELEASE_NOT_FROZEN' | 'TRANSPORT_ERROR';
+    readonly message: string;
+    readonly diagnostics?: readonly PageDocumentDiagnostic[];
+    readonly status?: number;
+}
+interface GovernedPageWorkflowSnapshot {
+    readonly contextGeneration: number;
+    readonly contextKey: string;
+    readonly pageId: string | null;
+    readonly rootTarget: UiLayoutTarget | null;
+    readonly source: PageSourceReference | null;
+    readonly draftWorkspace: UiLayoutDraftWorkspaceReceipt | null;
+    readonly draftEtag: string | null;
+    readonly workingDocument: PageAuthoringDocument | null;
+    readonly baselineDocument: PageAuthoringDocument | null;
+    readonly publishedSnapshot: PublishedPageReadResponse | null;
+    readonly publishedEtag: string | null;
+    readonly childSources: readonly UiLayoutPageChildSource[];
+    readonly reviewReceipt: UiLayoutReleaseReviewReceipt | null;
+    readonly reviewEtag: string | null;
+    readonly headReceipt: UiLayoutReleaseHeadReceipt | null;
+    readonly headEtag: string | null;
+    readonly preview: GovernedPagePreviewMaterialization | null;
+    readonly dirty: boolean;
+    readonly busy: boolean;
+    readonly capabilities: GovernedPageCapabilities;
+    readonly fencedOperations: Readonly<Record<string, GovernedPageUncertainOperation>>;
+    readonly lastError: GovernedPageWorkflowError | null;
+}
+interface GovernedPageWorkflowControllerConfig {
+    readonly persistence: GovernedPagePersistenceAdapter;
+    readonly childValidators?: PageChildDocumentValidators;
+    readonly previewAdapters?: GovernedPagePreviewWidgetAdapters;
+    readonly initialCapabilities?: GovernedPageCapabilities;
+    readonly initialContextKey?: string;
+    readonly idGenerator?: () => string;
+}
+interface GovernedPageCreateNativeRequest {
+    readonly creationKey?: string;
+    readonly title: string;
+    readonly sourceId: string;
+    readonly revision: string;
+}
+interface GovernedPageCopyPublishedRequest {
+    readonly creationKey?: string;
+    readonly title: string;
+    readonly sourcePageId: string;
+}
+interface GovernedPageAssignmentInput {
+    readonly layerClass: UiLayoutLayerClass;
+    readonly selector: UiLayoutAssignmentSelector;
+    readonly priority?: number;
+    readonly contributionKey?: string;
+}
+interface GovernedPageSubmitOptions {
+    readonly reason?: string;
+    readonly assignment?: GovernedPageAssignmentInput;
+}
+interface GovernedPageNavigationSnapshot {
+    readonly epoch: number;
+    readonly contextKey: string;
+    readonly catalogEntries: readonly PageCatalogEntry[];
+    readonly groupsDocument: NavigationGroupsAuthoringDocument;
+    readonly menuNodes: readonly RuntimeNavigationMenuNode[];
+    readonly expandedGroupIds: readonly string[];
+    readonly loading: boolean;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly fencedAttempts: Readonly<Record<string, string>>;
+    readonly lastError: string | null;
+}
+
+declare const DEFAULT_CORPORATE_NAVIGATION_GROUPS_TARGET: UiLayoutTarget;
+interface GovernedPageNavigationControllerConfig {
+    readonly persistence: GovernedPagePersistenceAdapter;
+    readonly effectiveLayoutService?: Pick<EffectiveUiLayoutService, 'resolve'> | null;
+    readonly observeTargetDocument?: (target: UiLayoutTarget) => Observable<Record<string, unknown> | null>;
+    readonly navigationGroupsTarget?: UiLayoutTarget;
+    readonly registeredNamespace?: string;
+    readonly allowedIcons?: Iterable<string>;
+    readonly pageSize?: number;
+    readonly maxItemsPerLevel?: number;
+    readonly initialContextKey?: string;
+    readonly idGenerator?: () => string;
+}
+interface GovernedNavigationGroupPublishInput {
+    readonly entry: NavigationGroupAuthoringEntry;
+    readonly draftCreationKey?: string;
+    readonly revisionCommandRef?: string;
+    readonly assignmentCommandRef?: string;
+    readonly freezeCommandRef?: string;
+    readonly reason?: string;
+    readonly layerClass?: UiLayoutLayerClass;
+    readonly selector: UiLayoutAssignmentSelector;
+    readonly priority?: number;
+    readonly contributionKey?: string;
+}
+declare class GovernedPageNavigationController {
+    private readonly persistence;
+    private readonly observeTargetDoc?;
+    private readonly navigationGroupsTarget;
+    private readonly registeredNamespace;
+    private readonly allowedIcons;
+    private readonly pageSize;
+    private readonly maxItemsPerLevel;
+    private readonly idGenerator;
+    private epoch;
+    private contextKey;
+    private groupsSub;
+    private readonly pageSubs;
+    private readonly pageDocuments;
+    private readonly expandedGroups;
+    private readonly fencedAttempts;
+    private latestGroupsDoc;
+    private latestCatalogEntries;
+    private readonly stateSubject;
+    readonly snapshot$: Observable<GovernedPageNavigationSnapshot>;
+    constructor(config: GovernedPageNavigationControllerConfig);
+    get snapshot(): GovernedPageNavigationSnapshot;
+    setContextKey(nextContextKey: string): void;
+    invalidate(): void;
+    destroy(): void;
+    refresh(): Promise<GovernedPageNavigationSnapshot>;
+    toggleGroupExpanded(groupId: string): void;
+    clearFencedAttempt(attemptKey: string): void;
+    upsertAndPublishNavigationGroup(input: GovernedNavigationGroupPublishInput): Promise<NavigationGroupsAuthoringDocument>;
+    private readAllCatalogEntries;
+    private hydrateCatalogPages;
+    private bindGroupsObservation;
+    private bindPageObservation;
+    private reobserveGroupChildren;
+    private recomputeProjection;
+    private isStale;
+    private teardownSubscriptions;
+    private publishSnapshot;
+}
+
+declare const DEFAULT_GOVERNED_PAGE_CHILD_VALIDATORS: PageChildDocumentValidators;
+declare const DEFAULT_GOVERNED_PAGE_PREVIEW_ADAPTERS: GovernedPagePreviewWidgetAdapters;
+/**
+ * Inspects a legacy `published-page:<uuid>` payload against the closed P0 governed page profile.
+ * Validates page source, authoring document structure, and child widget sources while preserving
+ * an exportable artifact for incompatible legacy records.
+ */
+declare function inspectLegacyPublishedPagePayload(request: GovernedPageLegacyImportRequest, childValidators?: PageChildDocumentValidators): GovernedPageLegacyInspectionResult;
+declare class GovernedPageWorkflowController {
+    private readonly persistence;
+    private readonly childValidators;
+    private readonly previewAdapters;
+    private readonly idGenerator;
+    private contextGeneration;
+    private contextKey;
+    private readonly fencedOperations;
+    private readonly childSourcesByWidgetId;
+    private readonly stateSubject;
+    readonly snapshot$: Observable<GovernedPageWorkflowSnapshot>;
+    constructor(config: GovernedPageWorkflowControllerConfig);
+    get snapshot(): GovernedPageWorkflowSnapshot;
+    setCapabilities(capabilities: GovernedPageCapabilities): void;
+    /**
+     * Advances monotonic context generation on context switch (including A -> B -> A),
+     * invalidating any in-flight callbacks from previous generations.
+     */
+    setContextKey(nextContextKey: string): void;
+    destroy(): void;
+    createNativePage(request: GovernedPageCreateNativeRequest): Promise<PageCreationReceipt>;
+    copyPublishedPage(request: GovernedPageCopyPublishedRequest): Promise<PageCreationReceipt>;
+    /**
+     * Explicitly imports a compatible legacy `published-page:<uuid>` record into a governed draft
+     * preserving the `/pages/<uuid>` address (`{ componentType: 'praxis-dynamic-page', componentId: pageId }`).
+     * Never fabricates approval or publication state and never deletes legacy storage keys.
+     */
+    importLegacyPublishedPage(request: GovernedPageLegacyImportRequest): Promise<GovernedPageWorkflowSnapshot>;
+    openDraftWorkspace(pageId: string, draftId: string, options?: {
+        source?: PageSourceReference | null;
+    }): Promise<GovernedPageWorkflowSnapshot>;
+    updateWorkingDocument(nextDocument: PageAuthoringDocument): PageAuthoringDocument;
+    updatePresentation(presentation: PageAuthoringDocument['config']['presentation']): PageAuthoringDocument;
+    upsertNavigationBinding(binding: PageNavigationBinding, options?: PageNavigationBindingUpdateOptions): PageAuthoringDocument;
+    /**
+     * Updates a child widget's inputs inside the page's authoring document and
+     * records its governed child source so child widgets remain under page authorship.
+     */
+    updateChildWidgetInputs(widgetKey: string, inputs: Record<string, unknown>, childSource?: UiLayoutPageChildSource): PageAuthoringDocument;
+    buildInteractivePreview(baseContext?: Record<string, unknown>): GovernedPagePreviewMaterialization;
+    saveDraftRevision(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    assignScope(input: GovernedPageAssignmentInput): Promise<GovernedPageWorkflowSnapshot>;
+    saveAndSubmitForReview(options?: GovernedPageSubmitOptions): Promise<GovernedPageWorkflowSnapshot>;
+    approveRelease(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    publishRelease(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    approveAndPublish(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    /**
+     * Reconciles a fenced operation after an ambiguous network failure (`COMMAND_OUTCOME_UNCERTAIN`)
+     * using the canonical read endpoints before unlocking retries.
+     */
+    reconcileUncertainOperation(attemptKey: string): Promise<GovernedPageWorkflowSnapshot>;
+    /**
+     * Reloads server state after a 409 Conflict or 412 Precondition Failed response.
+     */
+    reloadAfterConflict(): Promise<GovernedPageWorkflowSnapshot>;
+    private executePageCreation;
+    private applyDraftWorkspaceReceipt;
+    private refreshPublishedAndLifecycleMetadata;
+    private requireCapability;
+    private requireWorkingDocument;
+    private requireLoadedDraft;
+    private assertNotFenced;
+    private isStale;
+    private assertActiveContext;
+    private handleOperationError;
+    private fail;
+    private isLifecycleContractErrorLike;
+    private isWorkflowError;
+    private setBusy;
+    private publishSnapshot;
+}
+
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DEFAULT_CORPORATE_NAVIGATION_GROUPS_TARGET, DEFAULT_GOVERNED_PAGE_CHILD_VALIDATORS, DEFAULT_GOVERNED_PAGE_PREVIEW_ADAPTERS, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, GOVERNED_PAGE_CAPABILITY_KEYS, GovernedPageNavigationController, GovernedPageWorkflowController, LEGACY_PUBLISHED_PAGE_STORAGE_PREFIX, 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, PraxisPageCopyActionComponent, PraxisPageSaveAsComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, createCorporateGovernedPagePersistenceAdapter, createLocalPageSaveAsAdapter, deriveGovernedPageCapabilities, getPageAiCatalog, getWidgetAiCapabilities, inspectLegacyPublishedPagePayload, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CollectionScreenComposerConfig, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, GovernedNavigationGroupPublishInput, GovernedPageAssignmentInput, GovernedPageCapabilities, GovernedPageCopyPublishedRequest, GovernedPageCreateNativeRequest, GovernedPageLegacyExportArtifact, GovernedPageLegacyImportRequest, GovernedPageLegacyInspectionResult, GovernedPageLocalSaveAdapter, GovernedPageNavigationControllerConfig, GovernedPageNavigationSnapshot, GovernedPageOperationKind, GovernedPagePersistenceAdapter, GovernedPageReadResult, GovernedPageSubmitOptions, GovernedPageUncertainOperation, GovernedPageWorkflowControllerConfig, GovernedPageWorkflowError, GovernedPageWorkflowSnapshot, GuidedDataSourceQueryConfig, GuidedDataSourceTransformConfig, GuidedDerivedMeasureConfig, 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, PageSaveAsAdapter, PageSaveAsRequest, PageSaveAsResult, PaletteCategory, PaletteExistingCanvasItem, QueuedPaletteItem, 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 };