@praxisui/rich-content 9.0.0-beta.2 → 9.0.0-beta.20

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/rich-content",
-  "version": "9.0.0-beta.2",
+  "version": "9.0.0-beta.20",
   "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.0-beta.2",
+    "@praxisui/core": "^9.0.0-beta.20",
     "@angular/forms": "^21.0.0",
     "rxjs": "~7.8.0"
   },
@@ -13,10 +13,17 @@
     "tslib": "^2.3.0"
   },
   "sideEffects": false,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codexrodrigues/praxis-ui-angular.git"
-  },
+  "homepage": "https://praxisui.dev/docs/components",
+  "keywords": [
+    "angular",
+    "praxisui",
+    "praxis",
+    "rich-content",
+    "semantic-blocks",
+    "page-builder",
+    "metadata-driven",
+    "authoring"
+  ],
   "module": "fesm2022/praxisui-rich-content.mjs",
   "typings": "types/praxisui-rich-content.d.ts",
   "exports": {
@@ -26,7 +33,10 @@
     ".": {
       "types": "./types/praxisui-rich-content.d.ts",
       "default": "./fesm2022/praxisui-rich-content.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

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

@@ -1,11 +1,12 @@
 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, RichCollapsibleCardNode, RichFormLauncherNode, RichDisclosureNode, RichAccordionNode, RichAccordionItem, RichMediaBlockNode, RichTimelineNode, RichTimelineItem, RichTextNode, RichBadgeNode, RichIconNode, 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, 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 * as _praxisui_rich_content from '@praxisui/rich-content';
 import { BehaviorSubject } from 'rxjs';
 
 type RenderableNode = RichPrimitiveNode | RichPresetReferenceNode;
 declare class PraxisRichContent {
+    private readonly i18n;
     private readonly jsonLogic;
     private readonly presetRegistry;
     readonly document: _angular_core.InputSignal<RichContentDocument>;
@@ -21,6 +22,7 @@ declare class PraxisRichContent {
     isNodeVisible(node: RichBlockNode): boolean;
     resolveNodeClasses(node: RichBlockNode): string[];
     resolveNodeStyles(node: RichBlockNode): Record<string, string | number>;
+    resolveNodeStyleValue(node: RichBlockNode, name: string): string | number | null;
     resolveText(node: Extract<RichPresenterNode, {
         type: 'text';
     }>): string;
@@ -164,11 +166,25 @@ declare class PraxisRichContent {
     onRelatedRecordClick(node: RichRelatedRecordNode): void;
     isLookupCardDisabled(node: RichLookupCardNode): boolean;
     onLookupCardClick(node: RichLookupCardNode): void;
+    tx(key: string, fallback: string): string;
     resolveActionCardTitle(node: RichActionCardNode): string | null;
     resolveActionCardSubtitle(node: RichActionCardNode): string | null;
     resolveActionCardMessage(node: RichActionCardNode): string | null;
     resolveActionCardMeta(node: RichActionCardNode): string | null;
     resolveActionCardCtaLabel(node: RichActionCardNode): string;
+    resolveDecisionPackageTitle(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageSubtitle(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageSummary(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageStatus(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageOwner(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackagePolicySource(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageVersion(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageRisk(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageLastReviewed(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageConfidence(node: RichDecisionPackageNode): string | null;
+    resolveDecisionPackageEvidence(node: RichDecisionPackageNode): RichDecisionPackageEvidence[];
+    resolveDecisionPackageEvidenceLabel(item: RichDecisionPackageEvidence): string;
+    resolveDecisionPackageEvidenceSource(item: RichDecisionPackageEvidence): string | null;
     isActionCardDisabled(node: RichActionCardNode): boolean;
     onActionCardClick(node: RichActionCardNode): void;
     resolveCollapsibleCardTitle(node: RichCollapsibleCardNode): string | null;
@@ -201,8 +217,17 @@ declare class PraxisRichContent {
     resolveTimelineOrder(node: RichTimelineNode): string;
     resolveTimelineConnectorVariant(node: RichTimelineNode): string;
     resolveTimelineMarkerVariant(node: RichTimelineNode): string;
+    resolveTimelineEmphasis(node: RichTimelineNode): string;
+    resolveTimelineDensity(node: RichTimelineNode): string;
+    resolveTimelineTextAppearance(node: RichTimelineNode): string;
     resolveTimelineClasses(node: RichTimelineNode): string[];
+    resolveTimelineNodeMarkerColor(node: RichTimelineNode): string | null;
+    resolveTimelineNodeConnectorColor(node: RichTimelineNode): string | null;
     resolveTimelineItemClasses(node: RichTimelineNode, item: RichTimelineItem): string[];
+    resolveTimelineItemId(item: RichTimelineItem): string | null;
+    resolveTimelineItemMarkerColor(item: RichTimelineItem): string | null;
+    resolveTimelineItemConnectorColor(item: RichTimelineItem): string | null;
+    resolveTimelineItemConnectorVariant(item: RichTimelineItem): string | null;
     resolveTimelineItemTitle(item: RichTimelineItem): string | null;
     resolveTimelineItemSubtitle(item: RichTimelineItem): string | null;
     resolveTimelineItemMeta(item: RichTimelineItem): string | null;
@@ -245,13 +270,20 @@ interface RichContentValidationResult {
 declare function validateRichContentDocument(value: unknown): RichContentValidationResult;
 declare function isValidRichContentDocument(value: unknown): value is RichContentDocument;
 
-type EditableTopLevelNode = RichTextNode | RichBadgeNode | RichIconNode | RichImageNode | RichLinkNode | RichMetricNode | RichProgressNode | RichActionButtonNode | RichComposeNode | RichCardNode | RichCalloutNode | RichCtaGroupNode | RichKeyValueListNode | RichPropertySheetNode | RichStatGroupNode | RichTabsNode | RichEmptyStateNode | RichRecordSummaryNode | RichLookupResultNode | RichLookupCardNode | RichRelatedRecordNode | RichActionCardNode | RichFormLauncherNode | RichCollapsibleCardNode | RichDisclosureNode | RichAccordionNode | RichMediaBlockNode | RichTimelineNode | RichPresetReferenceNode;
+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 EditableTopLevelNodeType = EditableTopLevelNode['type'];
 type EditablePresenterNode = RichPresenterNode;
 type EditablePresenterNodeType = EditablePresenterNode['type'];
 type EditableCardContentNodeType = EditablePresenterNodeType | 'compose';
 
 type EditableTimelineItemField = 'title' | 'titleExpr' | 'subtitle' | 'subtitleExpr' | 'meta' | 'metaExpr' | 'opposite' | 'oppositeExpr' | 'icon' | 'iconExpr' | 'badge' | 'badgeExpr' | 'markerColor' | 'markerStyle' | 'connectorColor' | 'connectorVariant';
+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 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];
+type DocumentContextField = 'scopes' | 'aliases';
 interface PraxisRichContentEditorInputs {
     document?: RichContentDocument | null;
     layout?: 'block' | 'inline';
@@ -270,9 +302,10 @@ 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" | "metric" | "progress" | "actionButton" | "compose" | "card" | "callout" | "ctaGroup" | "keyValueList" | "propertySheet" | "statGroup" | "tabs" | "emptyState" | "recordSummary" | "lookupResult" | "lookupCard" | "relatedRecord" | "actionCard" | "formLauncher" | "collapsibleCard" | "disclosure" | "accordion" | "mediaBlock" | "timeline" | "preset")[];
+    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 presenterNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "avatar" | "metric" | "progress" | "actionButton")[];
     readonly cardContentNodeTypes: EditableCardContentNodeType[];
+    readonly advancedJsonOnlyNodeFields: readonly ["bindings", "disabledWhen", "loadWhen", "classWhen", "styleWhen"];
     readonly presetOptions: _praxisui_rich_content.RichBlockPresetDefinition[];
     documentJson: string;
     layout: 'block' | 'inline';
@@ -284,8 +317,13 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     validationIssues: RichContentValidationIssue[];
     nodeCount: number;
     nodeTypeSummary: string;
+    selectedNodeIndex: number;
+    activeEditorPanel: RichContentEditorPanel;
+    advancedRulesOpen: boolean;
+    advancedJsonFieldErrors: Record<string, string>;
     private initialInputs;
     private pendingRemoval;
+    private advancedJsonFieldDrafts;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
     getSettingsValue(): PraxisRichContentEditorValue | null;
@@ -295,6 +333,10 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     onDocumentJsonChange(): void;
     tx(key: string, fallback: string): string;
     useEmptyDocument(): void;
+    selectTopLevelNode(index: number): void;
+    selectEditorPanel(panel: RichContentEditorPanel): void;
+    openAdvancedRules(): void;
+    onAdvancedRulesToggle(event: Event): void;
     addTopLevelNode(): void;
     removeTopLevelNode(index: number): void;
     moveTopLevelNode(index: number, delta: number): void;
@@ -314,6 +356,14 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     getCardContentNodes(index: number): Array<RichPresenterNode | RichComposeNode>;
     getCardMediaField(index: number, field: string): string;
     setCardMediaField(index: number, field: string, value: string): void;
+    getCardInteractionField(index: number, field: string): string;
+    setCardInteractionField(index: number, field: string, value: string): void;
+    getCardInteractionBooleanField(index: number, field: string): boolean;
+    setCardInteractionBooleanField(index: number, field: string, value: boolean): void;
+    getCardInteractionActionField(index: number, field: 'actionId' | 'payloadExpr' | 'availabilityExpr' | 'confirmMessage'): string;
+    setCardInteractionActionField(index: number, field: 'actionId' | 'payloadExpr' | 'availabilityExpr' | 'confirmMessage', value: string): void;
+    getCardAccessibilityField(index: number, field: string): string;
+    setCardAccessibilityField(index: number, field: string, value: string): void;
     addCardSlotNode(index: number, slot: 'header' | 'footer' | 'aside'): void;
     addCardSlotNodeOfType(index: number, slot: 'header' | 'footer' | 'aside', type: EditablePresenterNodeType): void;
     setCardSlotStringField(index: number, slot: 'header' | 'footer' | 'aside', itemIndex: number, field: string, value: string): void;
@@ -363,13 +413,36 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     getTabsItems(index: number): Array<RichTabsNode['items'][number]>;
     addTabsItem(index: number): void;
     removeTabsItem(index: number, itemIndex: number): void;
-    getTabsItemField(index: number, itemIndex: number, field: 'id' | 'label' | 'icon' | 'badge'): string;
-    setTabsItemField(index: number, itemIndex: number, field: 'id' | 'label' | 'icon' | 'badge', value: string): void;
+    getTabsItemField(index: number, itemIndex: number, field: 'id' | 'label' | 'labelExpr' | 'icon' | 'badge' | 'badgeExpr' | 'capabilityMode'): string;
+    setTabsItemField(index: number, itemIndex: number, field: 'id' | 'label' | 'labelExpr' | 'icon' | 'badge' | 'badgeExpr' | 'capabilityMode', value: string): void;
+    getTabsItemCapabilityList(index: number, itemIndex: number): string;
+    setTabsItemCapabilityList(index: number, itemIndex: number, value: string): void;
+    getTabsItemVisibleWhenPath(index: number, itemIndex: number): string;
+    getTabsItemVisibleWhenValue(index: number, itemIndex: number): string;
+    setTabsItemVisibleWhenPath(index: number, itemIndex: number, path: string): void;
+    setTabsItemVisibleWhenValue(index: number, itemIndex: number, value: string): void;
+    private setTabsItemSimpleVisibleWhen;
     getActionCardSecondaryActions(index: number): RichActionButtonNode[];
     addActionCardSecondaryAction(index: number): void;
     addActionCardSecondaryActionPreset(index: number, preset: 'primary' | 'secondary'): void;
     setActionCardSecondaryActionField(index: number, actionIndex: number, field: string, value: string): void;
     confirmActionCardSecondaryActionRemoval(index: number, actionIndex: number): void;
+    setDecisionPackageField(index: number, field: DecisionPackageStringField, value: string): void;
+    getDecisionPackageEvidence(index: number): DecisionPackageEvidence[];
+    addDecisionPackageEvidence(index: number): void;
+    getDecisionPackageEvidenceField(index: number, evidenceIndex: number, field: DecisionPackageEvidenceField): string;
+    setDecisionPackageEvidenceField(index: number, evidenceIndex: number, field: DecisionPackageEvidenceField, value: string): void;
+    removeDecisionPackageEvidence(index: number, evidenceIndex: number): void;
+    getDecisionPackagePrimaryAction(index: number): RichActionButtonNode | null;
+    addDecisionPackagePrimaryAction(index: number): void;
+    addDecisionPackagePrimaryActionPreset(index: number, preset: 'primary' | 'secondary'): void;
+    setDecisionPackagePrimaryActionField(index: number, field: string, value: string): void;
+    removeDecisionPackagePrimaryAction(index: number): void;
+    getDecisionPackageSecondaryActions(index: number): RichActionButtonNode[];
+    addDecisionPackageSecondaryAction(index: number): void;
+    addDecisionPackageSecondaryActionPreset(index: number, preset: 'primary' | 'secondary'): void;
+    setDecisionPackageSecondaryActionField(index: number, actionIndex: number, field: string, value: string): void;
+    confirmDecisionPackageSecondaryActionRemoval(index: number, actionIndex: number): void;
     getFormLauncherActionField(index: number, field: 'actionId' | 'payloadExpr' | 'availabilityExpr' | 'confirmMessage'): string;
     setFormLauncherActionField(index: number, field: 'actionId' | 'payloadExpr' | 'availabilityExpr' | 'confirmMessage', value: string): void;
     getFormLauncherSecondaryActions(index: number): RichActionButtonNode[];
@@ -396,6 +469,26 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     getFirstStyleValue(node: RichBlockNode): string;
     setFirstStyleName(index: number, propertyName: string): void;
     setFirstStyleValue(index: number, propertyValue: string): void;
+    hasDocumentContext(): boolean;
+    getDocumentContextScopes(): string;
+    setDocumentContextScopes(value: string): void;
+    getDocumentContextAliasesValue(): string;
+    setDocumentContextAliases(value: string): void;
+    getDocumentContextFieldError(field: DocumentContextField): string;
+    getDocumentContextAliasesPlaceholder(): string;
+    getAdvancedJsonOnlyFields(node: RichBlockNode): string[];
+    getAdvancedJsonFieldValue(index: number, node: RichBlockNode, field: AdvancedJsonOnlyNodeField): string;
+    setAdvancedJsonField(index: number, field: AdvancedJsonOnlyNodeField, value: string): void;
+    getAdvancedJsonFieldError(index: number, field: AdvancedJsonOnlyNodeField): string;
+    getAdvancedJsonFieldPlaceholder(field: AdvancedJsonOnlyNodeField): string;
+    private getAdvancedJsonFieldKey;
+    private getDocumentContextFieldKey;
+    private updateDocumentContext;
+    private setAdvancedJsonFieldInvalid;
+    private clearAdvancedJsonFieldState;
+    private hasAdvancedJsonFieldErrors;
+    private isAdvancedJsonFieldShapeValid;
+    private getAdvancedJsonFieldShapeError;
     requestTopLevelNodeRemoval(index: number): void;
     confirmTopLevelNodeRemoval(index: number): void;
     requestNestedRemoval(scope: string, index: number): void;
@@ -425,6 +518,8 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     getPresetSelection(node: RichBlockNode): string;
     getPresetOptionValue(ref: CorePresetRef): string;
     getIssueMessages(path: string): string[];
+    getIssueCount(path: string): number;
+    getSelectedNodeIssueCount(): number;
     isEditableNodeType(type: string): type is EditableTopLevelNodeType;
     private isPresenterNodeType;
     private load;
@@ -434,6 +529,7 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     private createDefaultNode;
     private getDefaultPresetRef;
     private ensureCardNode;
+    private pruneEmptyCardInteraction;
     private ensureCardSlotNodes;
     private ensureCardContentNodes;
     private ensureCardActions;
@@ -451,11 +547,14 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     private ensureTabsNode;
     private ensureFormLauncherNode;
     private ensureActionCardNode;
+    private ensureDecisionPackageNode;
+    private ensureDecisionPackageEvidence;
     private ensureNodeActions;
     private ensureFormLauncherSecondaryActions;
     private ensureLookupCardSecondaryActions;
     private ensureRelatedRecordSecondaryActions;
     private ensureActionCardSecondaryActions;
+    private ensureDecisionPackageSecondaryActions;
     private ensureAccordionNode;
     private ensureAccordionItemActions;
     private setActionNodeField;
@@ -463,6 +562,7 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     private ensureTimelineNode;
     private parseDocument;
     private setInvalidState;
+    private reconcileSelectedNodeIndex;
     private updateDocumentOverview;
     private matchesInitialState;
     private cloneInputs;