@praxisui/list 9.0.10 → 9.0.11

package/README.md

@@ -107,7 +107,7 @@ In remote mode, search, sort and export share a collection toolbar above the ite
 - Selection supports `none`, `single` and `multiple`, with return modes `value`, `item` or `id`.
 - Item actions can emit local events or delegate to `GlobalActionService`; collection export uses the shared `@praxisui/core` contract for `csv`, `json`, `excel`, `pdf` and `print`.
 - In `cards` and `tiles`, item activation and secondary item actions are separate keyboard targets. Hosts should preserve this composite interaction model instead of nesting action buttons inside the item activation surface.
-- A governed `actions[].recordOpen` resolves the identity declared by the backend against the current-principal resource and contextual surface catalogs before executing `surface.open`; it never derives the target from the displayed label or from `item.id`.
+- A governed `actions[].recordOpen` resolves the identity declared by the backend against the current-principal resource and contextual surface catalogs before executing `surface.open`; it never derives the target from the displayed label or from `item.id`. This path requires the host's canonical `API_URL` configuration, resolved only when the action runs; local lists do not acquire a backend dependency merely by rendering the component.
 
 ## Known Runtime Boundaries
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-21T13:43:24.944Z",
+  "generatedAt": "2026-08-21T14:58:36.316Z",
   "packageName": "@praxisui/list",
-  "packageVersion": "9.0.10",
+  "packageVersion": "9.0.11",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-list.mjs

@@ -7,7 +7,7 @@ import * as i3 from '@angular/material/list';
 import { MatListModule } from '@angular/material/list';
 import * as i4 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
-import { resolveValuePresentation, LoggerService, GenericCrudService, toTitleCase, PraxisIconDirective, providePraxisI18n, PraxisI18nService, PraxisIconButtonComponent, validateGlobalActionRefs, IconPickerService, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, SurfaceOpenActionEditorComponent, PRAXIS_I18N_CONFIG, providePraxisI18nConfig, SURFACE_OPEN_I18N_CONFIG, deepMerge, ASYNC_CONFIG_STORAGE, ComponentKeyService, PraxisJsonLogicService, PraxisCollectionExportService, ResourceRecordOpenService, GlobalActionService, GLOBAL_DIALOG_SERVICE, ResourceRecordOpenError, assertPraxisCollectionExportArtifact, normalizePraxisDataQueryContext, ComponentMetadataRegistry, API_URL, LocalStorageAsyncAdapter, LocalStorageConfigService } from '@praxisui/core';
+import { resolveValuePresentation, LoggerService, GenericCrudService, toTitleCase, PraxisIconDirective, providePraxisI18n, PraxisI18nService, PraxisIconButtonComponent, validateGlobalActionRefs, IconPickerService, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, SurfaceOpenActionEditorComponent, PRAXIS_I18N_CONFIG, providePraxisI18nConfig, SURFACE_OPEN_I18N_CONFIG, deepMerge, ASYNC_CONFIG_STORAGE, ComponentKeyService, PraxisJsonLogicService, PraxisCollectionExportService, GlobalActionService, GLOBAL_DIALOG_SERVICE, ResourceRecordOpenError, ResourceRecordOpenService, assertPraxisCollectionExportArtifact, normalizePraxisDataQueryContext, ComponentMetadataRegistry, API_URL, LocalStorageAsyncAdapter, LocalStorageConfigService } from '@praxisui/core';
 import * as i5 from '@angular/material/chips';
 import { MatChipsModule } from '@angular/material/chips';
 import { MatDividerModule } from '@angular/material/divider';
@@ -12642,7 +12642,6 @@ class PraxisList {
     jsonLogic = inject(PraxisJsonLogicService);
     i18n = inject(PraxisI18nService);
     collectionExport = inject(PraxisCollectionExportService);
-    recordOpenResolver = inject(ResourceRecordOpenService);
     paginatorIntl = inject(MatPaginatorIntl);
     snackBar = inject(MatSnackBar);
     aiApi = inject(AiBackendApiService);
@@ -13701,7 +13700,11 @@ class PraxisList {
         if (!this.globalActions) {
             throw new Error('GlobalActionService is unavailable for surface.open.');
         }
-        const resolution = await firstValueFrom(this.recordOpenResolver.resolve(reference, item));
+        // Discovery belongs to the governed record-open path, not to list
+        // construction. Resolve it only when that intent is executed so local
+        // collections remain usable in hosts that do not configure API_URL.
+        const recordOpenResolver = this.resolveRecordOpenService();
+        const resolution = await firstValueFrom(recordOpenResolver.resolve(reference, item));
         const result = await this.globalActions.executeRef({ actionId: 'surface.open', payload: resolution.payload }, {
             sourceId: this.listId,
             output: 'actionClick',
@@ -13719,6 +13722,9 @@ class PraxisList {
                 'The surface.open executor rejected the resolved payload.');
         }
     }
+    resolveRecordOpenService() {
+        return this.injector.get(ResourceRecordOpenService);
+    }
     reportRecordOpenFailure(actionId, reference, error) {
         const failureCode = error instanceof ResourceRecordOpenError
             ? error.code

package/package.json

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

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

@@ -192,19 +192,21 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `ASYNC_CONFIG_STORAGE`              | bidirectional   | `loadConfig/saveConfig`             | fail-open    | Persistência de configuração por `listId`/instância.                 |
 | `SettingsPanelService`              | bidirectional   | `open(...).applied$/saved$`         | fail-open    | Canal de edição runtime para `PraxisListConfigEditor`.               |
 | `GlobalActionService`               | outbound action | `executeRef(globalAction, context)` | fail-soft    | Opcional; ausência gera warning e segue fluxo local.                 |
+| `ResourceRecordOpenService`         | outbound query  | `resolve(reference, record)`        | fail-closed  | Resolvido sob demanda apenas para `actions[].recordOpen`.            |
 | `GLOBAL_DIALOG_SERVICE`             | bidirectional   | confirmação de ação                 | fail-open    | Opcional; sem serviço, ação segue sem modal central.                 |
 | `PRAXIS_COLLECTION_EXPORT_PROVIDER` | outbound export | `exportCollection(request)`         | fail-fast    | Necessário para escopos remotos `filtered/all` e formatos avançados. |
 
 ### Host/runtime dependencies
 
-| Dependency             | Required | Environment          | Purpose              | Notes                                                             |
-| ---------------------- | -------- | -------------------- | -------------------- | ----------------------------------------------------------------- |
-| `ListDataService`      | Yes      | browser/dev/prod/ssr | fluxo de dados       | Stream de itens, seção, loading e paginação.                      |
-| `ListSkinService`      | Yes      | browser/dev/prod     | skin runtime         | Gera classes/estilos sanitizados por instância.                   |
-| `ASYNC_CONFIG_STORAGE` | Yes      | browser/dev/prod     | persistência         | Salva e restaura config de lista.                                 |
-| `SettingsPanelService` | Yes      | browser/dev/prod     | editor runtime       | Abre editor de configuração com preview/apply/save.               |
-| `GenericCrudService`   | Optional | browser/dev/prod     | inferência de schema | Usado para inferência de templating quando `resourcePath` existe. |
-| `ComponentKeyService`  | Yes      | browser/dev/prod/ssr | chave de escopo      | Determina namespace de persistência e isolamento.                 |
+| Dependency             | Required    | Environment          | Purpose              | Notes                                                                                 |
+| ---------------------- | ----------- | -------------------- | -------------------- | ------------------------------------------------------------------------------------- |
+| `ListDataService`      | Yes         | browser/dev/prod/ssr | fluxo de dados       | Stream de itens, seção, loading e paginação.                                          |
+| `ListSkinService`      | Yes         | browser/dev/prod     | skin runtime         | Gera classes/estilos sanitizados por instância.                                       |
+| `ASYNC_CONFIG_STORAGE` | Yes         | browser/dev/prod     | persistência         | Salva e restaura config de lista.                                                     |
+| `SettingsPanelService` | Yes         | browser/dev/prod     | editor runtime       | Abre editor de configuração com preview/apply/save.                                   |
+| `GenericCrudService`   | Optional    | browser/dev/prod     | inferência de schema | Usado para inferência de templating quando `resourcePath` existe.                     |
+| `API_URL`              | Conditional | browser/dev/prod     | discovery governado  | Exigido somente ao executar `actions[].recordOpen`; listas locais renderizam sem ele. |
+| `ComponentKeyService`  | Yes         | browser/dev/prod/ssr | chave de escopo      | Determina namespace de persistência e isolamento.                                     |
 
 ## Coverage matrix
 

package/types/praxisui-list.d.ts

@@ -534,7 +534,6 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private readonly jsonLogic;
     private readonly i18n;
     private readonly collectionExport;
-    private readonly recordOpenResolver;
     private readonly paginatorIntl;
     private readonly snackBar;
     private readonly aiApi;
@@ -691,6 +690,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     isResourceConnectionMissing(): boolean;
     onActionClick(ev: MouseEvent, actionId: string, item: any, index: number): Promise<void>;
     private executeRecordOpenAction;
+    private resolveRecordOpenService;
     private reportRecordOpenFailure;
     private resolveActionPayload;
     private resolveTemplate;