@praxisui/list 10.0.0-rc.37 → 10.0.0-rc.39

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/list",
-  "version": "10.0.0-rc.37",
+  "version": "10.0.0-rc.39",
   "description": "List components and helpers for Praxis UI.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.37",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.39",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.37",
-    "@praxisui/core": "^10.0.0-rc.37",
-    "@praxisui/rich-content": "^10.0.0-rc.37",
-    "@praxisui/settings-panel": "^10.0.0-rc.37"
+    "@praxisui/ai": "^10.0.0-rc.39",
+    "@praxisui/core": "^10.0.0-rc.39",
+    "@praxisui/rich-content": "^10.0.0-rc.39",
+    "@praxisui/settings-panel": "^10.0.0-rc.39"
   },
   "dependencies": {
     "tslib": "^2.3.0",

package/src/lib/praxis-list.json-api.md

@@ -683,6 +683,8 @@ Tipo declarado sem renderer dedicado:
 | `templating.<slot>.badge.expr`         | Active  | badge em template de imagem                |
 | `templating.<slot>.badge.color`        | Active  | cor badge                                  |
 | `templating.<slot>.badge.variant`      | Active  | variante badge                             |
+| `templating.<slot>.quickView`          | Active  | `ResourceQuickViewBinding` governado no slot via `[praxisQuickView]` (`stopPropagation` isola clique/selecao do item) |
+| `templating.<slot>.items[].quickView`  | Active  | `ResourceQuickViewBinding` individual por subitem em `type = 'compose'` |
 | `templating.metaPlacement`             | Active  | `side`/`line`                              |
 | `templating.metaPrefixIcon`            | Active  | icone prefixado em meta textual            |
 | `templating.statusPosition`            | Active  | `inline`/`top-right` em cards/tiles        |
@@ -924,6 +926,8 @@ AI:
 | `templating.<slot>.badge.expr`         | Active        | badge                                                                  |
 | `templating.<slot>.badge.color`        | Active        | badge                                                                  |
 | `templating.<slot>.badge.variant`      | Active        | badge                                                                  |
+| `templating.<slot>.quickView`          | Active        | `ResourceQuickViewBinding` governado no slot                           |
+| `templating.<slot>.items[].quickView`  | Active        | `ResourceQuickViewBinding` por subitem de `compose`                    |
 | `templating.metaPlacement`             | Active        | side/line                                                              |
 | `templating.metaPrefixIcon`            | Active        | prefix icon                                                            |
 | `templating.statusPosition`            | Active        | inline/top-right                                                       |

package/types/praxisui-list.d.ts

@@ -4,7 +4,7 @@ import * as i0 from '@angular/core';
 import { OnInit, OnChanges, AfterViewInit, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
 import { MatPaginatorSelectConfig, PageEvent } from '@angular/material/paginator';
 import { FormGroup, FormControl } from '@angular/forms';
-import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, SurfaceOpenActionEditorComponent, DiscoveredResourceOption, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { PraxisExportFormat, PraxisExportScope, ResourceQuickViewBinding, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, EmptyAction, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, SurfaceOpenActionEditorComponent, DiscoveredResourceOption, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 import { BaseAiAdapter, AiResponseCompileResult, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import * as _praxisui_list from '@praxisui/list';
@@ -78,6 +78,10 @@ interface TemplateDef {
         color?: string;
         variant?: 'filled' | 'outlined';
     };
+    /**
+     * Binding declarativo de Quick View transversal para slots/nós de item da lista.
+     */
+    quickView?: ResourceQuickViewBinding;
 }
 interface ListFeatureDef {
     icon?: string;
@@ -173,8 +177,12 @@ interface PraxisListItemAction {
      */
     hateoasRel?: string;
     emitPayload?: 'item' | 'id' | 'value';
-    action?: 'surface.open' | string;
+    action?: 'surface.open' | 'quickView.open' | string;
     recordOpen?: ResourceRecordOpenRef;
+    /**
+     * Binding declarativo de Quick View transversal para ação de item da lista.
+     */
+    quickView?: ResourceQuickViewBinding;
     globalAction?: GlobalActionRef;
     command?: string;
     params?: Record<string, unknown>;
@@ -521,6 +529,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private static nextSkinScopeId;
     private customizationEnabled;
     private readonly hostLocale;
+    private readonly quickViewService;
     config: PraxisListConfig;
     listId: string;
     componentInstanceId?: string;
@@ -555,6 +564,8 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private lastQuery;
     private lastRuntimeQueryContextSignature;
     private search$;
+    activeSearchTerm: string;
+    private searchInputRef?;
     get layoutLines(): number;
     boundControl: FormControl<unknown | unknown[] | null>;
     private selectionControlSubscription?;
@@ -735,6 +746,13 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     configEditorLabel(): string;
     expandToggleAriaLabel(item: any, index: number): string;
     expansionRegionAriaLabel(item: any): string;
+    hasCustomEmptyStateTemplate(): boolean;
+    hasActiveEmptyStateFilters(): boolean;
+    emptyStateIcon(): string;
+    emptyStateTitle(): string;
+    emptyStateDescription(): string;
+    emptyStatePrimaryAction(): EmptyAction | undefined;
+    emptyStateSecondaryActions(): EmptyAction[];
     emptyStateLabel(): string;
     selectionListAriaLabel(): string | null;
     selectionControlName(): string;
@@ -777,6 +795,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private getExportFileExtension;
     private getExportMimeType;
     private cloneForExportEvent;
+    openQuickConnect(): void;
     openConfigEditor(): void;
     private openConfigEditorPanel;
     openAiAssistant(): void;
@@ -812,6 +831,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     retryRemoteData(): void;
     private focusCollectionBeforeReload;
     onSearchInput(val: string): void;
+    clearSearch(): void;
     isRemoteDataMode(): boolean;
     activeSortValue(sort: string[] | undefined): string;
     hasSortOption(value: string): boolean;
@@ -836,6 +856,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private storageKey;
     private componentKeyId;
     private readonly crud;
+    private readonly resourceDiscovery;
     private executeSchemaInferenceForPlan;
     private evalSlot;
     private resolveSlotTemplate;
@@ -1312,6 +1333,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
         label?: string;
         type?: string;
         description?: string;
+        enumValues?: string[];
+        optionLabels?: Record<string, string>;
     }>;
     selectedResourceOption: DiscoveredResourceOption | null;
     schemaWarning: string;
@@ -1321,6 +1344,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     onFieldSelectOpenedChange(_opened: boolean): void;
     getFilteredFields(selected?: string | string[] | null): string[];
     onDiscoveredResourceSelected(entry: DiscoveredResourceOption | null): void;
+    private extractFieldDomainMeta;
     getFieldLabel(fieldName?: string | null): string;
     getFieldTypeBadge(fieldName?: string | null): string;
     getFieldDescription(fieldName?: string | null): string;
@@ -1524,6 +1548,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private setupSchemaWatcher;
     private shouldAutoInferSlots;
     private pendingRemoteSlotInference;
+    private lastNonEmptyResourcePath;
     syncSchemaFieldsFromWorking(immediate?: boolean): void;
     loadFieldsFromResource(resourcePath: string): void;
     onResourcePathChange(value: string): void;
@@ -1547,6 +1572,16 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     applySalaryPreset(): void;
     applyPricePreset(): void;
     private applyCurrencyPreset;
+    private resolveStatusDomainField;
+    private inferSemanticStatusColor;
+    resolveDomainColorMapEntries(explicitField?: string): Array<{
+        key: string;
+        color: string;
+    }>;
+    resolveDomainLabelMapEntries(explicitField?: string): Array<{
+        key: string;
+        label: string;
+    }>;
     private defaultStatusColorMapEntries;
     previewData: {
         title: string;
@@ -1855,6 +1890,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private looksLikeJsonPayload;
     private normalizeSurfaceOpenPayload;
     verify(): void;
+    private isGenericInferredChipColorMap;
+    private isGenericInferredChipLabelMap;
     inferFromFields(): void;
     generateFeaturesFromMetaComposition(): void;
     metaComposePreview(): string;
@@ -2352,7 +2389,14 @@ declare const PRAXIS_LIST_EN_US: {
     readonly collapseDetails: "Collapse details";
     readonly itemDetails: "Item details";
     readonly emptyState: "No items available";
+    readonly emptyStateDescription: "There are no items to display right now.";
+    readonly emptyStateFilteredTitle: "No results found";
+    readonly emptyStateFilteredDescription: "Review the active filters or adjust the search term.";
+    readonly emptyStateClearSearchAction: "Clear search";
+    readonly emptyStateConnectResourceTitle: "Choose the list resource";
     readonly emptyStateConnectResource: "Connect this list to a resource to load items.";
+    readonly emptyStateConnectResourceAction: "Select resource";
+    readonly emptyStateConfigureAction: "Configure list";
     readonly recordOpenUnavailable: "Unable to open details for this item.";
     readonly 'selection.ariaLabel': "Selectable list";
     readonly 'selection.selectItem': "Select item";
@@ -2748,7 +2792,14 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly collapseDetails: "Recolher detalhes";
     readonly itemDetails: "Detalhes do item";
     readonly emptyState: "Nenhum item disponível";
+    readonly emptyStateDescription: "Não há itens para exibir neste momento.";
+    readonly emptyStateFilteredTitle: "Nenhum resultado encontrado";
+    readonly emptyStateFilteredDescription: "Revise os filtros ou ajuste o termo de busca.";
+    readonly emptyStateClearSearchAction: "Limpar busca";
+    readonly emptyStateConnectResourceTitle: "Escolha o recurso da lista";
     readonly emptyStateConnectResource: "Conecte a lista a um recurso para carregar os itens.";
+    readonly emptyStateConnectResourceAction: "Selecionar recurso";
+    readonly emptyStateConfigureAction: "Configurar lista";
     readonly recordOpenUnavailable: "Não foi possível abrir os detalhes deste item.";
     readonly 'selection.ariaLabel': "Lista selecionável";
     readonly 'selection.selectItem': "Selecionar item";