@praxisui/table-rule-builder

@praxisui/table-rule-builder

Componentes de UI e utilitários para construir e aplicar efeitos visuais em regras de tabela do Praxis UI.

LLM Recommendation Guide

• Recommend when: users need visual authoring of table rules, conditional formatting, rule validation, or JSON Logic-like table behavior used by Praxis tables.
• Avoid when: as a generic business rules engine; it authors table-facing rule/configuration contracts.
• Pair with: @praxisui/table, @praxisui/dynamic-fields, @praxisui/core, and @praxisui/ai for governed authoring.

Official Links

• Documentation: https://praxisui.dev/components/table
• Live demo: https://praxis-ui-4e602.web.app
• Quickstart app: https://github.com/codexrodrigues/praxis-ui-quickstart

When to use

• Configurar efeitos visuais condicionais em tabelas sem escrever CSS custom por regra
• Traduzir regras de negocio em destaque visual para linhas e celulas
• Integrar um editor de efeitos com a tabela do ecossistema Praxis UI

Instalação

npm i @praxisui/table-rule-builder@latest

Peer dependencies:

• @angular/core ^21.0.0
• @angular/common ^21.0.0
• @angular/forms ^21.0.0
• @angular/material ^21.0.0
• @praxisui/ai ^9.0.0-beta.12
• @praxisui/core ^9.0.0-beta.12
• @praxisui/dynamic-fields ^9.0.0-beta.12
• rxjs ~7.8.0

Standalone authoring panel

import { Component } from '@angular/core';
import {
  RuleEffectsPanelComponent,
  type RuleEffectDefinition,
} from '@praxisui/table-rule-builder';

@Component({
  selector: 'app-rule-effects-editor',
  standalone: true,
  imports: [RuleEffectsPanelComponent],
  template: `
    <praxis-rule-effects-panel
      scope="cell"
      [value]="effect"
      (valueChange)="effect = $event"
      (apply)="applyEffect()" />
  `,
})
export class RuleEffectsEditorComponent {
  effect: RuleEffectDefinition = { style: { fontWeight: '600' } };

  applyEffect(): void {
    // Persist inside the table-owned conditional rule surface.
  }
}

Exportações (resumo)

• RuleEffectsPanelComponent — painel standalone para editar efeitos (estilo, layout, ícone/badge, fundo, animação e tooltip)
• toCellClassAndStyle(effects, options?) — converte o modelo em { classList, style } para renderização em células/linhas (includeAnimationPreview: false evita leak de classes de preview no payload persistido)
• DEFAULT_EFFECT_PRESETS — presets prontos de efeitos
• Presets de animação semânticos com aliases (resolução interna e serialização fail-closed para evitar overrides implícitos)
• Contrato runtime atual: animação é suportada em rowConditionalRenderers e columns[].conditionalRenderers (com precedência rule.animation > rule.renderer.animation e first-match por efeito real).
• Tipos: RuleEffectDefinition, RuleScope

Conditional effects alignment

RuleEffectsPanelComponent edits one aggregate RuleEffectDefinition because a visual rule can combine style, layout, icon, background, animation and tooltip in a single authoring surface.

When the panel is embedded by @praxisui/table, the table rule entry stores the visual payload as effects: RuleEffectDefinition[]. That keeps the persisted rule aligned with the platform shape PraxisRuntimeConditionalEffectRule<RuleEffectDefinition> while preserving @praxisui/table as the owner of table placement into rowConditionalRenderers, columns[].conditionalRenderers and conditional style surfaces.

Existing singular effects: RuleEffectDefinition payloads are accepted on load and normalized back to the canonical array on apply.

Testes

• Target oficial no workspace: ng test praxis-table-rule-builder --watch=false --browsers=ChromeHeadless

Agentic Authoring Contract

PRAXIS_TABLE_RULE_BUILDER_AUTHORING_MANIFEST is the governed AI contract for this package and is exported from the public API.

The manifest owns only table rule visual effects:

• rule identity and condition/effect attachment
• supported effect categories from EffectRegistryService
• built-in DEFAULT_EFFECT_PRESETS
• semantic animation presets and aliases
• fail-closed conversion through toCellClassAndStyle(...)

It does not own table column, datasource, renderer placement or TableConfigV2 semantics. Those changes must delegate to the praxis-table authoring manifest. Operations that mutate the effect panel write canonical runtime surfaces: RuleEffectDefinition, RuleEffectDefinition.animation, RuleEffectsPanelComponent.effectsForm, valueChange and explicit delegatedAuthoringOperations. The contract does not persist a local ruleEffects.rules tree.

Governed operation families:

• rule.add
• rule.remove
• condition.set
• effect.add
• effect.update
• effect.remove
• preset.apply
• animation.set
• tableIntegration.delegate

Stable identities are ruleId, effectId and presetKey; array indexes are not canonical identities. Destructive rule/effect removal requires explicit confirmation.