@praxisui/rich-content 9.0.67 → 9.0.68-rc.0

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@praxisui/rich-content",
-  "version": "9.0.67",
+  "version": "9.0.68-rc.0",
   "description": "Rich content rendering and authoring primitives for Praxis UI surfaces, including semantic blocks and page-builder integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/core": "^9.0.67",
+    "@angular/material": "^21.0.0",
+    "@praxisui/core": "^9.0.68-rc.0",
     "@angular/forms": "^21.0.0",
     "rxjs": "~7.8.0"
   },

package/types/praxisui-rich-content.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { OnChanges, OnInit, SimpleChanges, InjectionToken, Provider } from '@angular/core';
-import { RichContentDocument, RichPrimitiveNode, RichPresetReferenceNode, JsonLogicDataRecord, RichBlockHostCapabilities, RichBlockNode, RichPresenterNode, RichComposeNode, RichCardNode, RichCardMedia, RichActionButtonNode, RichCalloutNode, RichCtaGroupNode, RichKeyValueListNode, RichKeyValueItem, RichEmptyStateNode, RichPropertySheetNode, RichPropertySheetItem, RichStatGroupNode, RichStatItem, RichTabsNode, RichTabsItem, RichRecordSummaryNode, RichRecordSummaryField, RichLookupResultNode, RichLookupResultField, RichLookupCardNode, RichRelatedRecordNode, RichActionCardNode, RichDecisionPackageNode, RichDecisionPackageEvidence, RichCollapsibleCardNode, RichFormLauncherNode, RichDisclosureNode, RichAccordionNode, RichAccordionItem, RichMediaBlockNode, RichTimelineNode, RichTimelineItem, RichTextNode, RichBadgeNode, RichIconNode, RichAvatarNode, RichImageNode, RichLinkNode, RichMetricNode, RichProgressNode, SettingsValueProvider, CorePresetRef, CorePresetDescriptor, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nService } from '@praxisui/core';
+import { RichContentDocument, RichPrimitiveNode, RichPresetReferenceNode, JsonLogicDataRecord, RichBlockHostCapabilities, RichBlockNode, RichActionButtonNode, RichPageHeaderNode, RichPresenterNode, RichComposeNode, RichCardNode, RichCardMedia, RichCalloutNode, RichCtaGroupNode, RichKeyValueListNode, RichKeyValueItem, RichEmptyStateNode, RichPropertySheetNode, RichPropertySheetItem, RichStatGroupNode, RichStatItem, RichTabsNode, RichTabsItem, RichRecordSummaryNode, RichRecordSummaryField, RichLookupResultNode, RichLookupResultField, RichLookupCardNode, RichRelatedRecordNode, RichActionCardNode, RichDecisionPackageNode, RichDecisionPackageEvidence, RichCollapsibleCardNode, RichFormLauncherNode, RichDisclosureNode, RichAccordionNode, RichAccordionItem, RichMediaBlockNode, RichTimelineNode, RichTimelineItem, RichTextNode, RichBadgeNode, RichIconNode, RichAvatarNode, RichImageNode, RichLinkNode, RichMetricNode, RichProgressNode, SettingsValueProvider, CorePresetRef, CorePresetDescriptor, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nService } from '@praxisui/core';
 import * as _praxisui_rich_content from '@praxisui/rich-content';
 import { BehaviorSubject } from 'rxjs';
 
@@ -19,6 +19,13 @@ declare class PraxisRichContent {
     private readonly runtimeNodeIds;
     private nextRuntimeNodeId;
     readonly renderableNodes: _angular_core.Signal<RenderableNode[]>;
+    visiblePageHeaderNodes<T extends RichBlockNode>(nodes?: T[]): T[];
+    resolvePageHeaderMenuLabel(action: RichActionButtonNode): string;
+    visiblePageHeaderOverflow(node: RichPageHeaderNode): RichActionButtonNode[];
+    visiblePageHeaderActions(node: RichPageHeaderNode): RichActionButtonNode[];
+    resolvePageHeaderLevel(node: RichPageHeaderNode): number;
+    resolvePageHeaderTitle(node: RichPageHeaderNode): string;
+    resolvePageHeaderSubtitle(node: RichPageHeaderNode): string;
     isNodeVisible(node: RichBlockNode): boolean;
     resolveNodeClasses(node: RichBlockNode): string[];
     resolveNodeStyles(node: RichBlockNode): Record<string, string | number>;
@@ -273,7 +280,7 @@ interface RichContentValidationResult {
 declare function validateRichContentDocument(value: unknown): RichContentValidationResult;
 declare function isValidRichContentDocument(value: unknown): value is RichContentDocument;
 
-type EditableTopLevelNode = RichTextNode | RichBadgeNode | RichIconNode | RichAvatarNode | RichImageNode | RichLinkNode | RichMetricNode | RichProgressNode | RichActionButtonNode | RichComposeNode | RichCardNode | RichCalloutNode | RichCtaGroupNode | RichKeyValueListNode | RichPropertySheetNode | RichStatGroupNode | RichTabsNode | RichEmptyStateNode | RichRecordSummaryNode | RichLookupResultNode | RichLookupCardNode | RichRelatedRecordNode | RichActionCardNode | RichDecisionPackageNode | RichFormLauncherNode | RichCollapsibleCardNode | RichDisclosureNode | RichAccordionNode | RichMediaBlockNode | RichTimelineNode | RichPresetReferenceNode;
+type EditableTopLevelNode = RichTextNode | RichBadgeNode | RichIconNode | RichAvatarNode | RichImageNode | RichLinkNode | RichMetricNode | RichProgressNode | RichActionButtonNode | RichComposeNode | RichCardNode | RichPageHeaderNode | RichCalloutNode | RichCtaGroupNode | RichKeyValueListNode | RichPropertySheetNode | RichStatGroupNode | RichTabsNode | RichEmptyStateNode | RichRecordSummaryNode | RichLookupResultNode | RichLookupCardNode | RichRelatedRecordNode | RichActionCardNode | RichDecisionPackageNode | RichFormLauncherNode | RichCollapsibleCardNode | RichDisclosureNode | RichAccordionNode | RichMediaBlockNode | RichTimelineNode | RichPresetReferenceNode;
 type EditableTopLevelNodeType = EditableTopLevelNode['type'];
 type EditablePresenterNode = RichPresenterNode;
 type EditablePresenterNodeType = EditablePresenterNode['type'];
@@ -283,6 +290,7 @@ type EditableTimelineItemField = 'title' | 'titleExpr' | 'subtitle' | 'subtitleE
 type DecisionPackageStringField = 'title' | 'titleExpr' | 'subtitle' | 'subtitleExpr' | 'summary' | 'summaryExpr' | 'status' | 'statusExpr' | 'owner' | 'ownerExpr' | 'policySource' | 'policySourceExpr' | 'version' | 'versionExpr' | 'confidenceExpr' | 'risk' | 'riskExpr' | 'lastReviewed' | 'lastReviewedExpr' | 'supersedes' | 'supersedesExpr';
 type DecisionPackageEvidence = NonNullable<RichDecisionPackageNode['evidence']>[number];
 type DecisionPackageEvidenceField = 'id' | 'label' | 'labelExpr' | 'source' | 'sourceExpr';
+type PageHeaderRegion = 'identity' | 'breadcrumbs' | 'primaryAction' | 'secondaryActions' | 'overflowActions' | 'relatedLinks';
 type RichContentEditorPanel = 'guided' | 'preview' | 'json';
 declare const ADVANCED_JSON_ONLY_NODE_FIELDS: readonly ["bindings", "disabledWhen", "loadWhen", "classWhen", "styleWhen"];
 type AdvancedJsonOnlyNodeField = (typeof ADVANCED_JSON_ONLY_NODE_FIELDS)[number];
@@ -305,7 +313,7 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     readonly isDirty$: BehaviorSubject<boolean>;
     readonly isValid$: BehaviorSubject<boolean>;
     readonly isBusy$: BehaviorSubject<boolean>;
-    readonly editableNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "avatar" | "metric" | "progress" | "actionButton" | "compose" | "card" | "callout" | "ctaGroup" | "keyValueList" | "propertySheet" | "statGroup" | "tabs" | "emptyState" | "recordSummary" | "lookupResult" | "lookupCard" | "relatedRecord" | "actionCard" | "decisionPackage" | "formLauncher" | "collapsibleCard" | "disclosure" | "accordion" | "mediaBlock" | "timeline" | "preset")[];
+    readonly editableNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "avatar" | "metric" | "progress" | "actionButton" | "compose" | "card" | "pageHeader" | "callout" | "ctaGroup" | "keyValueList" | "propertySheet" | "statGroup" | "tabs" | "emptyState" | "recordSummary" | "lookupResult" | "lookupCard" | "relatedRecord" | "actionCard" | "decisionPackage" | "formLauncher" | "collapsibleCard" | "disclosure" | "accordion" | "mediaBlock" | "timeline" | "preset")[];
     readonly presenterNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "avatar" | "metric" | "progress" | "actionButton")[];
     readonly cardContentNodeTypes: EditableCardContentNodeType[];
     readonly advancedJsonOnlyNodeFields: readonly ["bindings", "disabledWhen", "loadWhen", "classWhen", "styleWhen"];
@@ -316,6 +324,8 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     newNodeType: EditableTopLevelNodeType;
     errorMessage: string;
     valid: boolean;
+    documentSyntaxInvalid: boolean;
+    readonly editorInstanceId: string;
     parsedDocument: RichContentDocument | null;
     validationIssues: RichContentValidationIssue[];
     nodeCount: number;
@@ -531,6 +541,14 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     private syncStructuredDocumentChange;
     private createDefaultNode;
     private getDefaultPresetRef;
+    private pageHeader;
+    getPageHeaderChildren(index: number, region: PageHeaderRegion): RichPresenterNode[];
+    setPageHeaderIdentity(index: number, type: string): void;
+    addPageHeaderChild(index: number, region: PageHeaderRegion): void;
+    removePageHeaderChild(index: number, region: PageHeaderRegion, childIndex: number): void;
+    movePageHeaderChild(index: number, region: PageHeaderRegion, childIndex: number, delta: number): void;
+    setPageHeaderChildField(index: number, region: PageHeaderRegion, childIndex: number, field: string, value: string): void;
+    setPageHeaderChildNumber(index: number, region: PageHeaderRegion, childIndex: number, field: string, value: number | string | null): void;
     private ensureCardNode;
     private pruneEmptyCardInteraction;
     private ensureCardSlotNodes;