@praxisui/rich-content 8.0.0-beta.1 → 8.0.0-beta.12

package/index.d.ts

@@ -1,6 +1,7 @@
 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, RichMediaBlockNode, RichTimelineNode, RichTimelineItem, SettingsValueProvider, CorePresetDescriptor, CorePresetRef, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nService } from '@praxisui/core';
+import { RichContentDocument, RichPrimitiveNode, RichPresetReferenceNode, JsonLogicDataRecord, RichBlockHostCapabilities, RichBlockNode, RichPresenterNode, RichComposeNode, RichCardNode, RichMediaBlockNode, RichTimelineNode, RichTimelineItem, RichTextNode, RichBadgeNode, RichIconNode, RichImageNode, RichLinkNode, RichMetricNode, RichProgressNode, SettingsValueProvider, CorePresetRef, CorePresetDescriptor, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, ComponentAuthoringManifest, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nService } from '@praxisui/core';
+import * as _praxisui_rich_content from '@praxisui/rich-content';
 import { BehaviorSubject } from 'rxjs';
 
 type RenderableNode = RichPrimitiveNode | RichPresetReferenceNode;
@@ -26,6 +27,12 @@ declare class PraxisRichContent {
     resolveImageAlt(node: Extract<RichPresenterNode, {
         type: 'image';
     }>): string;
+    resolveLinkLabel(node: Extract<RichPresenterNode, {
+        type: 'link';
+    }>): string;
+    resolveLinkRel(node: Extract<RichPresenterNode, {
+        type: 'link';
+    }>): string | null;
     resolveBadgeLabel(node: Extract<RichPresenterNode, {
         type: 'badge';
     }>): string;
@@ -66,6 +73,9 @@ declare class PraxisRichContent {
     resolveTimelineItemIcon(item: RichTimelineItem): string | null;
     resolveTimelineItemBadge(item: RichTimelineItem): string | null;
     resolvePresetNodes(node: RichPresetReferenceNode): RenderableNode[] | null;
+    private expandPresetReference;
+    private resolvePresetDocument;
+    private getPresetKey;
     private buildEvaluationContext;
     private resolveValue;
     private getByPath;
@@ -74,6 +84,24 @@ declare class PraxisRichContent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisRichContent, "praxis-rich-content", never, { "document": { "alias": "document"; "required": false; "isSignal": true; }; "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "hostCapabilities": { "alias": "hostCapabilities"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "rootClassName": { "alias": "rootClassName"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+interface RichContentValidationIssue {
+    path: string;
+    messageKey: string;
+    fallback: string;
+}
+interface RichContentValidationResult {
+    valid: boolean;
+    issues: RichContentValidationIssue[];
+}
+declare function validateRichContentDocument(value: unknown): RichContentValidationResult;
+declare function isValidRichContentDocument(value: unknown): value is RichContentDocument;
+
+type EditableTopLevelNode = RichTextNode | RichBadgeNode | RichIconNode | RichImageNode | RichLinkNode | RichMetricNode | RichProgressNode | RichComposeNode | RichCardNode | RichMediaBlockNode | RichTimelineNode | RichPresetReferenceNode;
+type EditableTopLevelNodeType = EditableTopLevelNode['type'];
+type EditablePresenterNode = RichPresenterNode;
+type EditablePresenterNodeType = EditablePresenterNode['type'];
+type EditableCardContentNodeType = EditablePresenterNodeType | 'compose';
+
 interface PraxisRichContentEditorInputs {
     document?: RichContentDocument | null;
     layout?: 'block' | 'inline';
@@ -86,17 +114,28 @@ interface PraxisRichContentEditorValue {
 declare class PraxisRichContentConfigEditor implements SettingsValueProvider, OnChanges, OnInit {
     private readonly cdr;
     private readonly i18n;
+    private readonly presetRegistry;
     private readonly injectedData;
     inputs: PraxisRichContentEditorInputs | null;
     readonly isDirty$: BehaviorSubject<boolean>;
     readonly isValid$: BehaviorSubject<boolean>;
     readonly isBusy$: BehaviorSubject<boolean>;
+    readonly editableNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "metric" | "progress" | "compose" | "card" | "mediaBlock" | "timeline" | "preset")[];
+    readonly presenterNodeTypes: ("text" | "icon" | "image" | "link" | "badge" | "avatar" | "metric" | "progress")[];
+    readonly cardContentNodeTypes: EditableCardContentNodeType[];
+    readonly presetOptions: _praxisui_rich_content.RichBlockPresetDefinition[];
     documentJson: string;
     layout: 'block' | 'inline';
     rootClassName: string;
+    newNodeType: EditableTopLevelNodeType;
     errorMessage: string;
     valid: boolean;
+    parsedDocument: RichContentDocument | null;
+    validationIssues: RichContentValidationIssue[];
+    nodeCount: number;
+    nodeTypeSummary: string;
     private initialInputs;
+    private pendingRemoval;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
     getSettingsValue(): PraxisRichContentEditorValue | null;
@@ -106,9 +145,67 @@ declare class PraxisRichContentConfigEditor implements SettingsValueProvider, On
     onDocumentJsonChange(): void;
     tx(key: string, fallback: string): string;
     useEmptyDocument(): void;
+    addTopLevelNode(): void;
+    removeTopLevelNode(index: number): void;
+    moveTopLevelNode(index: number, delta: number): void;
+    changeTopLevelNodeType(index: number, nextType: EditableTopLevelNodeType): void;
+    getStringField(node: RichBlockNode, field: string): string;
+    setStringField(index: number, field: string, value: string): void;
+    getNumberField(node: RichBlockNode, field: string): number | null;
+    setNumberField(index: number, field: string, value: number | string | null): void;
+    getVisibleWhenPath(node: RichBlockNode): string;
+    getVisibleWhenValue(node: RichBlockNode): string;
+    setVisibleWhenPath(index: number, path: string): void;
+    setVisibleWhenValue(index: number, value: string): void;
+    getFirstStyleName(node: RichBlockNode): string;
+    getFirstStyleValue(node: RichBlockNode): string;
+    setFirstStyleName(index: number, propertyName: string): void;
+    setFirstStyleValue(index: number, propertyValue: string): void;
+    requestTopLevelNodeRemoval(index: number): void;
+    confirmTopLevelNodeRemoval(index: number): void;
+    requestNestedRemoval(scope: string, index: number): void;
+    cancelRemoval(): void;
+    isRemovalPending(scope: string, index: number): boolean;
+    addCardContentNode(cardIndex: number): void;
+    setCardContentStringField(cardIndex: number, contentIndex: number, field: string, value: string): void;
+    setCardContentNumberField(cardIndex: number, contentIndex: number, field: string, value: number | string | null): void;
+    changeCardContentType(cardIndex: number, contentIndex: number, type: EditablePresenterNodeType): void;
+    confirmCardContentRemoval(cardIndex: number, contentIndex: number): void;
+    addComposeItem(composeIndex: number): void;
+    setComposeItemStringField(composeIndex: number, itemIndex: number, field: string, value: string): void;
+    setComposeItemNumberField(composeIndex: number, itemIndex: number, field: string, value: number | string | null): void;
+    changeComposeItemType(composeIndex: number, itemIndex: number, type: EditablePresenterNodeType): void;
+    confirmComposeItemRemoval(composeIndex: number, itemIndex: number): void;
+    isPresenterNode(node: RichBlockNode): node is RichPresenterNode;
+    isCardContentEditable(type: string): type is EditablePresenterNodeType;
+    setMediaBlockAvatarField(index: number, field: string, value: string): void;
+    getMediaBlockAvatarField(index: number, field: string): string;
+    setMediaBlockTextField(index: number, field: 'title' | 'subtitle', value: string): void;
+    getMediaBlockTextField(index: number, field: 'title' | 'subtitle'): string;
+    addTimelineItem(index: number): void;
+    setTimelineItemField(index: number, itemIndex: number, field: keyof RichTimelineItem, value: string): void;
+    getTimelineItemField(index: number, itemIndex: number, field: keyof RichTimelineItem): string;
+    confirmTimelineItemRemoval(index: number, itemIndex: number): void;
+    setPresetSelection(index: number, optionValue: string): void;
+    getPresetSelection(node: RichBlockNode): string;
+    getPresetOptionValue(ref: CorePresetRef): string;
+    getIssueMessages(path: string): string[];
+    isEditableNodeType(type: string): type is EditableTopLevelNodeType;
+    private isPresenterNodeType;
     private load;
     private normalizeInputs;
+    private ensureEditableDocument;
+    private syncStructuredDocumentChange;
+    private createDefaultNode;
+    private getDefaultPresetRef;
+    private ensureCardNode;
+    private ensureComposeNode;
+    private ensureMediaBlockNode;
+    private ensureMediaBlockAvatar;
+    private ensureTimelineNode;
     private parseDocument;
+    private setInvalidState;
+    private updateDocumentOverview;
     private matchesInitialState;
     private cloneInputs;
     private cloneValue;
@@ -153,6 +250,8 @@ interface RichContentCapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const RICH_CONTENT_AI_CAPABILITIES: RichContentCapabilityCatalog;
 
+declare const PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
 interface PraxisRichContentI18nOptions {
     locale?: string;
     fallbackLocale?: string;
@@ -162,5 +261,5 @@ declare function createPraxisRichContentI18nConfig(options?: PraxisRichContentI1
 declare function providePraxisRichContentI18n(options?: PraxisRichContentI18nOptions): _angular_core.Provider[];
 declare function resolvePraxisRichContentText(i18n: PraxisI18nService, key: string, fallback: string): string;
 
-export { PRAXIS_RICH_BLOCK_PRESETS, PRAXIS_RICH_CONTENT_COMPONENT_METADATA, PraxisRichContent, PraxisRichContentConfigEditor, RICH_CONTENT_AI_CAPABILITIES, RichContentPresetRegistryService, createPraxisRichContentI18nConfig, providePraxisRichContentI18n, providePraxisRichContentMetadata, resolvePraxisRichContentText };
-export type { PraxisRichContentEditorInputs, PraxisRichContentEditorValue, PraxisRichContentI18nOptions, RichBlockPresetDefinition, RichContentCapability, RichContentCapabilityCatalog, RichContentCapabilityCategory, RichContentValueKind };
+export { PRAXIS_RICH_BLOCK_PRESETS, PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST, PRAXIS_RICH_CONTENT_COMPONENT_METADATA, PraxisRichContent, PraxisRichContentConfigEditor, RICH_CONTENT_AI_CAPABILITIES, RichContentPresetRegistryService, createPraxisRichContentI18nConfig, isValidRichContentDocument, providePraxisRichContentI18n, providePraxisRichContentMetadata, resolvePraxisRichContentText, validateRichContentDocument };
+export type { PraxisRichContentEditorInputs, PraxisRichContentEditorValue, PraxisRichContentI18nOptions, RichBlockPresetDefinition, RichContentCapability, RichContentCapabilityCatalog, RichContentCapabilityCategory, RichContentValidationIssue, RichContentValidationResult, RichContentValueKind };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@praxisui/rich-content",
-  "version": "8.0.0-beta.1",
+  "version": "8.0.0-beta.12",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",
-    "@praxisui/core": "^8.0.0-beta.1"
+    "@praxisui/core": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0"