@praxisui/crud 3.0.0-beta.9 → 4.0.0-beta.0

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as _praxisui_core from '@praxisui/core';
-import { ApiEndpoint, TableConfig, FormConfig, BackConfig, RowAction, ToolbarAction, LoadingState, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import { ApiEndpoint, TableConfig, PraxisDataQueryContext, FormConfig, BackConfig, RowAction, ToolbarAction, ResourceActionCatalogItem, LoadingState, RestApiLinks, ApiUrlEntry, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 export { BackConfig } from '@praxisui/core';
 import * as i0 from '@angular/core';
 import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider } from '@angular/core';
@@ -61,6 +61,8 @@ interface CrudMetadata {
     resource?: CrudResource;
     data?: any[] | null;
     table: TableConfig;
+    queryContext?: PraxisDataQueryContext | null;
+    filterCriteria?: Record<string, unknown> | null;
     form?: FormConfig;
     defaults?: CrudDefaults;
     actions?: CrudAction[];
@@ -82,17 +84,31 @@ interface CrudMetadataAssertionOptions {
 }
 declare function assertCrudMetadata(meta: CrudMetadata, options?: CrudMetadataAssertionOptions): void;
 
+type CrudActionRuntimeEvent = {
+    actionConfig?: ResourceActionCatalogItem | null;
+};
+type CrudContextAction = {
+    action: string;
+    label?: string;
+    formId?: string;
+    route?: string;
+    openMode?: 'modal' | 'drawer' | 'route';
+};
+type CrudContextValue = {
+    tableId: string;
+    componentKeyId?: string;
+    resourcePath?: string;
+    endpointKey?: ApiEndpoint;
+    defaults?: CrudMetadata['defaults'];
+    actions?: CrudContextAction[];
+    idField?: string;
+};
 declare class PraxisCrudComponent implements OnChanges {
-    /** JSON inline ou chave/URL resolvida pelo MetadataResolver */
     metadata: CrudMetadata | string;
-    /** Identificador obrigatório do CRUD (base para tabela/formulário) */
     crudId: string;
-    /** Identificador opcional para instâncias múltiplas */
     componentInstanceId?: string;
     context?: Record<string, unknown>;
-    /** Encaminha o modo de edição de layout para a tabela interna */
     enableCustomization: boolean;
-    /** CTA: usado pelo Builder para abrir configuração de metadados quando vazio */
     configureRequested: EventEmitter<void>;
     afterOpen: EventEmitter<{
         mode: FormOpenMode;
@@ -107,73 +123,97 @@ declare class PraxisCrudComponent implements OnChanges {
         id: string | number;
     }>;
     error: EventEmitter<unknown>;
-    /**
-     * Emits the live PraxisTable configuration snapshot after runtime hydration or
-     * metadata refreshes. This reflects the effective table state in memory,
-     * deduplicated by structural JSON equality, and is intended for external hosts
-     * that need to mirror the table editor/runtime state.
-     */
     tableRuntimeConfigChange: EventEmitter<_praxisui_core.TableConfigModern>;
     resolvedMetadata: CrudMetadata;
-    /** Configuração efetiva da tabela com melhorias automáticas (ex.: botão Adicionar). */
     effectiveTableConfig?: TableConfig;
-    /** Config passado ao PraxisTable — sempre definido (fallback seguro). */
     tableConfigForBinding: TableConfig;
+    tableQueryContext: Record<string, unknown> | null;
+    tableFilterCriteria: Record<string, unknown>;
+    tableCrudContext?: CrudContextValue;
     private readonly launcher;
     private readonly destroyRef;
+    private readonly cdr;
     private table;
     private readonly storage;
     private readonly snack;
+    private readonly i18n;
+    private readonly resourceDiscovery;
+    private readonly actionOpenAdapter;
+    private readonly surfaceOpenAdapter;
     private readonly global;
+    private readonly surfaceService;
     private readonly componentKeys;
     private readonly route;
     private warnedMissingId;
     private lastEmittedTableRuntimeConfigJson;
-    /**
-     * Stable CRUD context passed to PraxisTable.
-     * Previously this was created via a getter, producing a new object each CD tick
-     * and causing excessive re-renders. Now we compute it only when metadata changes.
-     */
-    tableCrudContext?: {
-        tableId: string;
-        componentKeyId?: string;
-        resourcePath?: string;
-        defaults?: any;
-        actions?: Array<{
-            action: string;
-            label?: string;
-            formId?: string;
-            route?: string;
-            openMode?: 'modal' | 'drawer' | 'route';
-        }>;
-    };
+    private lastAssignedTableConfigJson;
+    private lastAssignedTableCrudContextJson;
+    private lastAppliedResourceIdentity;
+    private tableCollectionLinks;
+    private collectionCapabilities;
+    private collectionCapabilitiesRequestHref;
+    private collectionCapabilitiesResolvedHref;
+    private collectionCapabilitiesRequestSeq;
     onResetPreferences(): void;
     ngOnChanges(changes: SimpleChanges): void;
-    onAction(action: string, row?: Record<string, unknown>): Promise<void>;
-    private refreshTable;
+    onAction(action: string, row?: Record<string, unknown>, runtimeEvent?: CrudActionRuntimeEvent): Promise<void>;
     getCurrentTableConfigSnapshot(): TableConfig | null;
     onTableMetadataChange(): void;
     onTableLoadingStateChange(state: LoadingState): void;
-    private emitTableRuntimeConfigSnapshot;
+    onCollectionLinksChange(links: RestApiLinks | null | undefined): void;
     resolveResourcePath(meta?: CrudMetadata): string;
-    resolveLocalData(meta?: CrudMetadata): any[] | null;
-    resolveTableData(meta?: CrudMetadata): any[] | null;
+    resolveLocalData(meta?: CrudMetadata): unknown[] | null;
+    resolveTableData(meta?: CrudMetadata): unknown[] | null;
     shouldRenderTable(meta?: CrudMetadata): boolean;
-    private getIdField;
+    getEmptyStateTitle(): string;
+    getEmptyStateDescription(): string;
+    getEmptyStatePrimaryAction(): string;
     onConfigureRequested(): void;
-    /**
-     * Constrói uma configuração de tabela efetiva a partir dos metadados,
-     * adicionando automaticamente a ação de "Adicionar" na toolbar quando aplicável.
-     * - Evita duplicidade se a toolbar já tiver ação equivalente.
-     * - Garante visibilidade da toolbar quando a ação é injetada.
-     */
+    private refreshTable;
+    private emitTableRuntimeConfigSnapshot;
+    private applyResolvedCrudState;
+    private assignTableConfigForBinding;
+    private assignTableCrudContext;
+    private safeSerialize;
+    private syncRuntimeBindings;
+    private resolveQueryContext;
+    private resolveFilterCriteria;
+    private tryOpenDiscoveredCrudSurface;
+    private resolveDiscoveredSurfaceCatalog;
+    private tryOpenDiscoveredWorkflowAction;
+    private resolveDiscoveredActionCatalog;
+    private selectDiscoveredWorkflowAction;
+    private resolveProvidedWorkflowAction;
+    private selectSurfaceForCrudAction;
+    private getPreferredSurfaceIdsForCrudAction;
+    private isDiscoveryManagedCrudAction;
+    private isWritableCrudSurface;
+    private isReadableCrudSurface;
+    private resolveRowResourceId;
+    private mapSurfacePresentationToCrudMode;
+    private handleDiscoveredSurfaceResult;
     private buildEffectiveTableConfig;
-    /** Heurística leve para identificar ações do tipo "adicionar/criar" */
     private isAddLike;
-    /** Builds a stable CRUD context object for PraxisTable based on metadata. */
     private buildTableCrudContext;
+    private resolveCreateToolbarAction;
+    private resolveContextCrudActions;
+    private resolveCollectionWorkflowCrudActions;
+    private resolveCollectionWorkflowToolbarActions;
+    private supportsCreateCapability;
+    private supportsViewCapability;
+    private supportsEditCapability;
+    private supportsDeleteCapability;
+    private hasCanonicalOperation;
+    private resolveCollectionCapabilitiesHref;
+    private resolveCrudResourceIdentity;
+    private buildDiscoveryOptions;
+    private resolveDiscoveryApiEntry;
+    private isRecord;
+    private getIdField;
     private componentKeyId;
     private warnMissingId;
+    private getCrudActionLabel;
+    private tx;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisCrudComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisCrudComponent, "praxis-crud", never, { "metadata": { "alias": "metadata"; "required": true; }; "crudId": { "alias": "crudId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "context": { "alias": "context"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; }, never, never, true, never>;
 }
@@ -221,6 +261,11 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     private destroyRef;
     resourcePath?: string;
     resourceId?: string | number;
+    schemaUrl?: string | null;
+    submitUrl?: string | null;
+    submitMethod?: string | null;
+    apiEndpointKey?: ApiEndpoint | string | null;
+    apiUrlEntry?: ApiUrlEntry | null;
     mode: 'create' | 'edit' | 'view';
     backConfig?: BackConfig;
     private idField;

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/crud",
-  "version": "3.0.0-beta.9",
+  "version": "4.0.0-beta.0",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
     "@angular/core": "^20.1.0",
-    "@praxisui/dynamic-form": "^3.0.0-beta.9",
-    "@praxisui/table": "^3.0.0-beta.9",
-    "@praxisui/core": "^3.0.0-beta.9",
-    "@praxisui/dynamic-fields": "^3.0.0-beta.9",
-    "@praxisui/settings-panel": "^3.0.0-beta.9"
+    "@praxisui/dynamic-form": "^4.0.0-beta.0",
+    "@praxisui/table": "^4.0.0-beta.0",
+    "@praxisui/core": "^4.0.0-beta.0",
+    "@praxisui/dynamic-fields": "^4.0.0-beta.0",
+    "@praxisui/settings-panel": "^4.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"