@praxisui/rich-content 8.0.0-beta.20 → 8.0.0-beta.22

package/README.md

@@ -79,6 +79,12 @@ style declaration can be edited visually. Advanced JSON remains available for
 less common nested fields and deep structures, but it is no longer the only
 authoring path.
 
+Runtime conditional metadata is governed by the shared JSON Logic contract:
+`visibleWhen` and `loadWhen` gate rendering, `disabledWhen` disables interactive
+surfaces, and `classWhen`/`styleWhen` apply declarative visual state. Invalid
+visibility/loading/style rules fail closed by not rendering or not applying the
+rule; invalid `disabledWhen` fails safe by disabling the action surface.
+
 The editor receives the widget input envelope and returns the same canonical
 shape expected by the runtime:
 
@@ -140,7 +146,9 @@ platform surfaces:
 `recordSummary`, `statGroup`, `tabs`, `lookupResult`, `lookupCard`, `relatedRecord`, `actionCard`, `collapsibleCard`,
   `disclosure` and `accordion`
 - interactive buttons through `actionButton`, mediated by
-  `hostCapabilities.dispatchAction(...)`
+  `hostCapabilities.dispatchAction(...)`; when `action.confirmMessage` is
+  present, runtime first calls `hostCapabilities.confirmAction(...)` and fails
+  closed without dispatch if the host does not confirm
 - governed action surfaces such as `lookupCard`, `relatedRecord`, `actionCard` and `formLauncher`, which keep
   the document canonical while delegating execution to host capabilities
 - capability-gated visibility through `requiresCapabilities` and

package/fesm2022/praxisui-rich-content.mjs

@@ -134,10 +134,13 @@ class PraxisRichContent {
         if (!this.supportsRequiredCapabilities(node)) {
             return false;
         }
-        if (!node.visibleWhen) {
-            return true;
+        if (node.visibleWhen && !this.evaluateRule(node.visibleWhen, false)) {
+            return false;
+        }
+        if (node.loadWhen && !this.evaluateRule(node.loadWhen, false)) {
+            return false;
         }
-        return !!this.jsonLogic.evaluate(node.visibleWhen, this.buildEvaluationContext());
+        return true;
     }
     resolveNodeClasses(node) {
         const classes = new Set();
@@ -145,7 +148,7 @@ class PraxisRichContent {
             classes.add(node.className);
         }
         for (const rule of node.classWhen ?? []) {
-            if (this.jsonLogic.evaluate(rule.expr, this.buildEvaluationContext())) {
+            if (this.evaluateRule(rule.expr, false)) {
                 classes.add(rule.className);
             }
         }
@@ -154,7 +157,7 @@ class PraxisRichContent {
     resolveNodeStyles(node) {
         const styles = { ...(node.style ?? {}) };
         for (const rule of node.styleWhen ?? []) {
-            if (this.jsonLogic.evaluate(rule.expr, this.buildEvaluationContext())) {
+            if (this.evaluateRule(rule.expr, false)) {
                 Object.assign(styles, rule.style);
             }
         }
@@ -297,7 +300,7 @@ class PraxisRichContent {
             return false;
         }
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         const action = node.interaction?.action;
         if (!action) {
@@ -354,17 +357,33 @@ class PraxisRichContent {
         if (!action) {
             return;
         }
-        const payload = action.payloadExpr != null
+        void this.dispatchRichAction(action);
+    }
+    resolveActionPayload(action) {
+        return action.payloadExpr != null
             ? this.resolveStructuredValue(action.payloadExpr)
             : action.payload;
-        void this.hostCapabilities()?.dispatchAction?.(action.actionId, payload);
+    }
+    async dispatchRichAction(action, payload = this.resolveActionPayload(action)) {
+        const host = this.hostCapabilities();
+        if (action.confirmMessage) {
+            const confirmed = await host?.confirmAction?.({
+                actionId: action.actionId,
+                message: action.confirmMessage,
+                payload,
+            });
+            if (!confirmed) {
+                return;
+            }
+        }
+        await host?.dispatchAction?.(action.actionId, payload);
     }
     resolveActionButtonLabel(node) {
         return this.resolveValue(node.labelExpr) ?? node.label ?? node.action.actionId;
     }
     isActionButtonDisabled(node) {
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         const actionId = node.action.actionId;
         const host = this.hostCapabilities();
@@ -380,10 +399,7 @@ class PraxisRichContent {
         if (this.isActionButtonDisabled(node)) {
             return;
         }
-        const payload = node.action.payloadExpr != null
-            ? this.resolveStructuredValue(node.action.payloadExpr)
-            : node.action.payload;
-        void this.hostCapabilities()?.dispatchAction?.(node.action.actionId, payload);
+        void this.dispatchRichAction(node.action);
     }
     resolveCalloutTitle(node) {
         return this.resolveValue(node.titleExpr) ?? node.title ?? null;
@@ -481,7 +497,7 @@ class PraxisRichContent {
         if (!item.disabledWhen) {
             return false;
         }
-        return !!this.jsonLogic.evaluate(item.disabledWhen, this.buildEvaluationContext());
+        return this.evaluateRule(item.disabledWhen, true);
     }
     isTabsItemActive(node, item, index, items) {
         return this.resolveTabsItemKey(item, index) === this.resolveActiveTabsItemKey(node, items);
@@ -622,7 +638,7 @@ class PraxisRichContent {
             return false;
         }
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         if (node.action.availabilityExpr) {
             return !this.resolveBooleanExpression(node.action.availabilityExpr);
@@ -634,14 +650,11 @@ class PraxisRichContent {
         if (!node.action || this.isRelatedRecordDisabled(node)) {
             return;
         }
-        const payload = node.action.payloadExpr != null
-            ? this.resolveStructuredValue(node.action.payloadExpr)
-            : node.action.payload;
-        void this.hostCapabilities()?.dispatchAction?.(node.action.actionId, payload);
+        void this.dispatchRichAction(node.action);
     }
     isLookupCardDisabled(node) {
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         if (node.action.availabilityExpr) {
             return !this.resolveBooleanExpression(node.action.availabilityExpr);
@@ -653,10 +666,7 @@ class PraxisRichContent {
         if (this.isLookupCardDisabled(node)) {
             return;
         }
-        const payload = node.action.payloadExpr != null
-            ? this.resolveStructuredValue(node.action.payloadExpr)
-            : node.action.payload;
-        void this.hostCapabilities()?.dispatchAction?.(node.action.actionId, payload);
+        void this.dispatchRichAction(node.action);
     }
     resolveActionCardTitle(node) {
         return this.resolveValue(node.titleExpr) ?? node.title ?? null;
@@ -675,7 +685,7 @@ class PraxisRichContent {
     }
     isActionCardDisabled(node) {
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         if (node.action.availabilityExpr) {
             return !this.resolveBooleanExpression(node.action.availabilityExpr);
@@ -687,10 +697,7 @@ class PraxisRichContent {
         if (this.isActionCardDisabled(node)) {
             return;
         }
-        const payload = node.action.payloadExpr != null
-            ? this.resolveStructuredValue(node.action.payloadExpr)
-            : node.action.payload;
-        void this.hostCapabilities()?.dispatchAction?.(node.action.actionId, payload);
+        void this.dispatchRichAction(node.action);
     }
     resolveCollapsibleCardTitle(node) {
         return this.resolveValue(node.titleExpr) ?? node.title ?? null;
@@ -718,7 +725,7 @@ class PraxisRichContent {
     }
     isFormLauncherDisabled(node) {
         if (node.disabledWhen) {
-            return !!this.jsonLogic.evaluate(node.disabledWhen, this.buildEvaluationContext());
+            return this.evaluateRule(node.disabledWhen, true);
         }
         if (node.action.availabilityExpr) {
             return !this.resolveBooleanExpression(node.action.availabilityExpr);
@@ -738,7 +745,7 @@ class PraxisRichContent {
         const payload = resolvedPayload && typeof resolvedPayload === 'object'
             ? { formId: node.formId, ...resolvedPayload }
             : { formId: node.formId, payload: resolvedPayload };
-        void this.hostCapabilities()?.dispatchAction?.(node.action.actionId, payload);
+        void this.dispatchRichAction(node.action, payload);
     }
     resolveDisclosureTitle(node) {
         return this.resolveValue(node.titleExpr) ?? node.title ?? null;
@@ -964,8 +971,16 @@ class PraxisRichContent {
     }
     isTabsItemVisible(item) {
         return (this.supportsItemRequiredCapabilities(item) &&
-            (!item.visibleWhen ||
-                !!this.jsonLogic.evaluate(item.visibleWhen, this.buildEvaluationContext())));
+            (!item.visibleWhen || this.evaluateRule(item.visibleWhen, false)) &&
+            (!item.loadWhen || this.evaluateRule(item.loadWhen, false)));
+    }
+    evaluateRule(expression, fallback) {
+        try {
+            return !!this.jsonLogic.evaluate(expression, this.buildEvaluationContext());
+        }
+        catch {
+            return fallback;
+        }
     }
     supportsItemRequiredCapabilities(item) {
         const required = item.requiresCapabilities;
@@ -14950,8 +14965,9 @@ const RICH_CONTENT_AI_CAPABILITIES = {
         'Use document como input principal quando o componente for hospedado pelo page-builder.',
         'O documento deve usar kind "praxis.rich-content" e version "1.0.0".',
         'Nodes de rich content representam apresentacao/documento rico; nao substituem field controls de dynamic-fields.',
-        'visibleWhen, classWhen e styleWhen usam Json Logic canonico, nao string DSL.',
+        'visibleWhen, disabledWhen, loadWhen, classWhen e styleWhen usam Json Logic canonico, nao string DSL.',
         'hostCapabilities e reservado para mediacao governada de preset/action/embed; nao serializar funcoes arbitrarias em contratos publicos.',
+        'action.confirmMessage exige hostCapabilities.confirmAction em runtime; sem confirmacao governada do host a action falha fechada e nao faz dispatch.',
         'Use actionButton quando a action precisar ser mediada pelo host; action.actionId e o identificador canonico do fluxo.',
         'requiresCapabilities e capabilityMode permitem gating declarativo por snapshot de capability do host, sem inventar DSL local.',
         'Quando praxis-rich-content for hospedado por praxis-dynamic-page ou praxis-dynamic-form, hostCapabilities permanece runtime-only e nao pertence ao JSON persistido.',
@@ -14972,6 +14988,8 @@ const RICH_CONTENT_AI_CAPABILITIES = {
         { path: 'document.nodes[].className', category: 'richNode', valueKind: 'string', description: 'Classe CSS declarativa aplicada ao node.' },
         { path: 'document.nodes[].style', category: 'richNode', valueKind: 'object', description: 'Estilos inline declarativos simples para o node.' },
         { path: 'document.nodes[].visibleWhen', category: 'richRules', valueKind: 'expression', description: 'Regra Json Logic que controla visibilidade do node.' },
+        { path: 'document.nodes[].disabledWhen', category: 'richRules', valueKind: 'expression', description: 'Regra Json Logic que desabilita superficies interativas do node em modo fail-safe.' },
+        { path: 'document.nodes[].loadWhen', category: 'richRules', valueKind: 'expression', description: 'Regra Json Logic que controla se o node deve ser carregado/renderizado.' },
         { path: 'document.nodes[].requiresCapabilities', category: 'richHost', valueKind: 'array', description: 'Lista de capability ids exigidos para renderizar o node.' },
         { path: 'document.nodes[].capabilityMode', category: 'richHost', valueKind: 'enum', allowedValues: ['all', 'any'], description: 'Controla se todas ou qualquer capability exigida deve estar presente.' },
         { path: 'document.nodes[].classWhen', category: 'richRules', valueKind: 'array', description: 'Lista de regras Json Logic que aplicam classes.' },
@@ -15100,6 +15118,7 @@ const RICH_CONTENT_AI_CAPABILITIES = {
         { path: 'rootClassName', category: 'richContent', valueKind: 'string', description: 'Classe aplicada ao root do renderer.' },
         { path: 'hostCapabilities', category: 'richHost', valueKind: 'object', description: 'Capacidades mediadas pelo host. Nao usar funcoes serializadas em JSON publico.' },
         { path: 'hostCapabilities.dispatchAction', category: 'richHost', valueKind: 'object', description: 'Canal runtime-only para dispatch de actionId no host.' },
+        { path: 'hostCapabilities.confirmAction', category: 'richHost', valueKind: 'object', description: 'Canal runtime-only para confirmar actions com confirmMessage antes do dispatch.' },
         { path: 'hostCapabilities.hasCapability', category: 'richHost', valueKind: 'object', description: 'Canal runtime-only para gating por capability no host.' },
         { path: 'hostCapabilities.isActionAvailable', category: 'richHost', valueKind: 'object', description: 'Canal runtime-only para disponibilidade de actions mediadas pelo host.' },
     ],
@@ -15249,6 +15268,10 @@ const blockPatchSchema = {
         className: { type: 'string' },
         style: { type: 'object' },
         visibleWhen: { type: 'object' },
+        disabledWhen: { type: 'object' },
+        loadWhen: { type: 'object' },
+        classWhen: { type: 'array', items: { type: 'object' } },
+        styleWhen: { type: 'array', items: { type: 'object' } },
         requiresCapabilities: { type: 'array', items: { type: 'string' } },
         capabilityMode: { enum: ['all', 'any'] },
         text: { type: 'string' },
@@ -15348,7 +15371,7 @@ const PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST = {
         { name: 'document', type: 'RichContentDocument | null', description: 'Canonical praxis.rich-content document rendered by the component.' },
         { name: 'nodes', type: 'RichBlockNode[] | null', description: 'Direct node list used only when the host controls the document envelope.' },
         { name: 'context', type: 'JsonLogicDataRecord | null', description: 'External context used by expression paths and Json Logic rules.' },
-        { name: 'hostCapabilities', type: 'RichBlockHostCapabilities | null', description: 'Host-mediated preset, action, data and embed capabilities; functions are not serialized in public contracts.' },
+        { name: 'hostCapabilities', type: 'RichBlockHostCapabilities | null', description: 'Host-mediated preset, action, action confirmation, data and embed capabilities; functions are not serialized in public contracts.' },
         { name: 'layout', type: "'block' | 'inline'", allowedValues: ['block', 'inline'], description: 'Renderer layout mode.' },
         { name: 'rootClassName', type: 'string', description: 'CSS class applied to the renderer root.' },
     ],
@@ -15430,6 +15453,10 @@ const PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST = {
                 'document.nodes[].className',
                 'document.nodes[].style',
                 'document.nodes[].visibleWhen',
+                'document.nodes[].disabledWhen',
+                'document.nodes[].loadWhen',
+                'document.nodes[].classWhen',
+                'document.nodes[].styleWhen',
                 'document.nodes[].requiresCapabilities',
                 'document.nodes[].capabilityMode',
                 'document.nodes[].text',
@@ -15599,12 +15626,12 @@ const PRAXIS_RICH_CONTENT_AUTHORING_MANIFEST = {
             scope: 'templating',
             targetKind: 'metadata',
             target: { kind: 'metadata', resolver: 'rich-block-by-id-or-index', ambiguityPolicy: 'fail', required: true },
-            inputSchema: { type: 'object', minProperties: 1, properties: { blockId: { type: 'string' }, testId: { type: 'string' }, className: { type: 'string' }, visibleWhen: { type: 'object' }, style: { type: 'object' }, requiresCapabilities: { type: 'array', items: { type: 'string' } }, capabilityMode: { enum: ['all', 'any'] } } },
+            inputSchema: { type: 'object', minProperties: 1, properties: { blockId: { type: 'string' }, testId: { type: 'string' }, className: { type: 'string' }, visibleWhen: { type: 'object' }, disabledWhen: { type: 'object' }, loadWhen: { type: 'object' }, classWhen: { type: 'array', items: { type: 'object' } }, styleWhen: { type: 'array', items: { type: 'object' } }, style: { type: 'object' }, requiresCapabilities: { type: 'array', items: { type: 'string' } }, capabilityMode: { enum: ['all', 'any'] } } },
             effects: [{ kind: 'merge-by-key', path: 'document.nodes[]', key: 'id' }],
             destructive: false,
             requiresConfirmation: false,
             validators: ['block-exists', 'class-name-safe', 'visible-when-json-logic', 'unsafe-style-rejected', 'document-shape-canonical', 'editor-runtime-round-trip'],
-            affectedPaths: ['document.nodes[].testId', 'document.nodes[].className', 'document.nodes[].visibleWhen', 'document.nodes[].style', 'document.nodes[].requiresCapabilities', 'document.nodes[].capabilityMode'],
+            affectedPaths: ['document.nodes[].testId', 'document.nodes[].className', 'document.nodes[].visibleWhen', 'document.nodes[].disabledWhen', 'document.nodes[].loadWhen', 'document.nodes[].classWhen', 'document.nodes[].styleWhen', 'document.nodes[].style', 'document.nodes[].requiresCapabilities', 'document.nodes[].capabilityMode'],
             submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'target-block-exists'],
         },

package/index.d.ts

@@ -85,6 +85,8 @@ declare class PraxisRichContent {
     onCardSurfaceKeydown(node: RichCardNode, event: KeyboardEvent): void;
     private shouldDispatchCardInteraction;
     private dispatchCardInteraction;
+    private resolveActionPayload;
+    private dispatchRichAction;
     resolveActionButtonLabel(node: RichActionButtonNode): string;
     isActionButtonDisabled(node: RichActionButtonNode): boolean;
     onActionButtonClick(node: RichActionButtonNode): void;
@@ -220,6 +222,7 @@ declare class PraxisRichContent {
     private resolveBooleanExpression;
     private supportsRequiredCapabilities;
     private isTabsItemVisible;
+    private evaluateRule;
     private supportsItemRequiredCapabilities;
     private resolveActiveTabsItemKey;
     private resolveTabsItemKey;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@praxisui/rich-content",
-  "version": "8.0.0-beta.20",
+  "version": "8.0.0-beta.22",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",
-    "@praxisui/core": "^8.0.0-beta.20",
+    "@praxisui/core": "^8.0.0-beta.22",
     "@angular/forms": "^20.3.0",
     "rxjs": "~7.8.0"
   },