@praxisui/core 9.0.0-beta.62 → 9.0.0-beta.64

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-09T14:19:11.232Z",
+  "generatedAt": "2026-07-09T17:49:20.835Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.62",
+  "packageVersion": "9.0.0-beta.64",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -3523,9 +3523,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "recipe",
-          "content": "{\n  \"_comment\": \"Recipe para agentes usarem surface.relatedResource com o runtime canonico praxis-related-resource-outlet.\",\n  \"_comment2\": \"O filtro pai-filho deve vir de relatedResource.childParentField; nao duplique a mesma regra em composition.links quando o outlet puder resolver.\",\n  \"templateMeta\": {\n    \"registryKey\": \"praxis-related-resource-outlet\",\n    \"variantId\": \"inline-table-child-resource\",\n    \"status\": \"public-example\",\n    \"useWhen\": \"Render a related child resource from surfaceId or ResourceSurfaceCatalogItem.relatedResource without hand-writing table filters or host-specific code.\",\n    \"examplePrompts\": [\n      \"renderize recursos relacionados de uma linha selecionada\",\n      \"crie tabela filha a partir de relatedResource\",\n      \"mostrar participantes filtrados pela missao selecionada sem composition manual\"\n    ]\n  },\n  \"platformValue\": {\n    \"canonicalContract\": \"praxis-metadata-starter publishes ResourceSurfaceCatalogItem.relatedResource in the surfaces catalog.\",\n    \"angularRuntime\": \"@praxisui/core discovers the requested surface by surfaceId when needed, resolves relatedResource into a SurfaceOpenPayload and materializes praxis-table through DynamicWidgetLoader.\",\n    \"migrationValue\": \"Hosts keep only surfaceId plus parentRecord or parentResourceId in the page; parent-child filtering is declared once in metadata.\",\n    \"agentCorpus\": \"This recipe keeps surfaceId, parentResourcePath, parentResourceId and parentRecord explicit so agents do not infer relationships from labels.\"\n  },\n  \"authoringGuidance\": [\n    \"Use praxis-related-resource-outlet with surfaceId when the parent resource publishes item-level surfaces.\",\n    \"Pass surface directly only when the host already has the ResourceSurfaceCatalogItem available.\",\n    \"Pass parentRecord when the selected row is available; pass parentResourceId when only the id is available.\",\n    \"Do not repeat childParentField filters in composition.links unless the page intentionally overrides queryContext.\",\n    \"Keep availability fail-closed; permission-limited and not-found states should render as outlet states instead of empty tables.\",\n    \"Use mode=open-action when the host owns drawer/dialog orchestration; use mode=inline for embedded child tables.\"\n  ],\n  \"teaches\": [\n    \"surface.relatedResource\",\n    \"surfaceId\",\n    \"praxis-related-resource-outlet\",\n    \"related-resource.childParentField\",\n    \"related-resource.childResourcePath\",\n    \"resourceEvent\",\n    \"surfaceOpen\"\n  ],\n  \"page\": {\n    \"layout\": {\n      \"orientation\": \"columns\",\n      \"columns\": 2,\n      \"gap\": \"16px\"\n    },\n    \"widgets\": [\n      {\n        \"key\": \"missionParticipants\",\n        \"shell\": {\n          \"kind\": \"dashboard-card\",\n          \"icon\": \"hub\",\n          \"title\": \"Related participants\",\n          \"subtitle\": \"Child table resolved from surface.relatedResource\"\n        },\n        \"definition\": {\n          \"id\": \"praxis-related-resource-outlet\",\n          \"bindingOrder\": [\n            \"surfaceId\",\n            \"parentRecord\",\n            \"parentResourceId\",\n            \"parentResourcePath\",\n            \"mode\"\n          ],\n          \"inputs\": {\n            \"mode\": \"inline\",\n            \"surfaceId\": \"team\",\n            \"parentResourcePath\": \"operations/missoes\",\n            \"parentResourceId\": 1,\n            \"parentRecord\": {\n              \"id\": 1,\n              \"titulo\": \"Atlantic Shield\",\n              \"status\": \"PLANEJADA\"\n            }\n          },\n          \"outputs\": {\n            \"widgetEvent\": \"emit\",\n            \"resourceEvent\": \"emit\",\n            \"surfaceOpen\": \"emit\"\n          }\n        }\n      }\n    ]\n  }\n}\n",
+          "content": "{\n  \"_comment\": \"Recipe para agentes usarem surface.relatedResource com o runtime canonico praxis-related-resource-outlet.\",\n  \"_comment2\": \"O filtro pai-filho deve vir de relatedResource.childParentField; nao duplique a mesma regra em composition.links quando o outlet puder resolver.\",\n  \"templateMeta\": {\n    \"registryKey\": \"praxis-related-resource-outlet\",\n    \"variantId\": \"inline-table-child-resource\",\n    \"status\": \"public-example\",\n    \"useWhen\": \"Render a related child resource from surfaceId or ResourceSurfaceCatalogItem.relatedResource without hand-writing table filters or host-specific code.\",\n    \"examplePrompts\": [\n      \"renderize recursos relacionados de uma linha selecionada\",\n      \"crie tabela filha a partir de relatedResource\",\n      \"mostrar participantes filtrados pela missao selecionada sem composition manual\"\n    ]\n  },\n  \"platformValue\": {\n    \"canonicalContract\": \"praxis-metadata-starter publishes ResourceSurfaceCatalogItem.relatedResource in the surfaces catalog.\",\n    \"angularRuntime\": \"@praxisui/core discovers the requested surface by surfaceId when needed, resolves relatedResource into a SurfaceOpenPayload and materializes praxis-table through DynamicWidgetLoader.\",\n    \"migrationValue\": \"Hosts keep only surfaceId plus parentRecord or parentResourceId in the page; parent-child filtering is declared once in metadata.\",\n    \"agentCorpus\": \"This recipe keeps surfaceId, parentResourcePath, parentResourceId and parentRecord explicit so agents do not infer relationships from labels.\"\n  },\n  \"authoringGuidance\": [\n    \"Use praxis-related-resource-outlet with surfaceId when the parent resource publishes item-level surfaces.\",\n    \"Pass surface directly only when the host already has the ResourceSurfaceCatalogItem available.\",\n    \"Pass parentRecord when the selected row is available; pass parentResourceId when only the id is available.\",\n    \"Do not repeat childParentField filters in composition.links unless the page intentionally overrides queryContext.\",\n    \"Keep availability fail-closed; permission-limited and not-found states should render as outlet states instead of empty tables.\",\n    \"Omit emptyState for the default related-resource empty copy; the runtime derives contextual copy and create action from surface.relatedResource. Pass emptyState only when domain-specific wording must override the platform default.\",\n    \"Use mode=open-action when the host owns drawer/dialog orchestration; use mode=inline for embedded child tables.\"\n  ],\n  \"teaches\": [\n    \"surface.relatedResource\",\n    \"surfaceId\",\n    \"praxis-related-resource-outlet\",\n    \"related-resource.childParentField\",\n    \"related-resource.childResourcePath\",\n    \"resourceEvent\",\n    \"surfaceOpen\"\n  ],\n  \"page\": {\n    \"layout\": {\n      \"orientation\": \"columns\",\n      \"columns\": 2,\n      \"gap\": \"16px\"\n    },\n    \"widgets\": [\n      {\n        \"key\": \"missionParticipants\",\n        \"shell\": {\n          \"kind\": \"dashboard-card\",\n          \"icon\": \"hub\",\n          \"title\": \"Related participants\",\n          \"subtitle\": \"Child table resolved from surface.relatedResource\"\n        },\n        \"definition\": {\n          \"id\": \"praxis-related-resource-outlet\",\n          \"bindingOrder\": [\n            \"surfaceId\",\n            \"parentRecord\",\n            \"parentResourceId\",\n            \"parentResourcePath\",\n            \"mode\"\n          ],\n          \"inputs\": {\n            \"mode\": \"inline\",\n            \"surfaceId\": \"team\",\n            \"parentResourcePath\": \"operations/missoes\",\n            \"parentResourceId\": 1,\n            \"parentRecord\": {\n              \"id\": 1,\n              \"titulo\": \"Atlantic Shield\",\n              \"status\": \"PLANEJADA\"\n            }\n          },\n          \"outputs\": {\n            \"widgetEvent\": \"emit\",\n            \"resourceEvent\": \"emit\",\n            \"surfaceOpen\": \"emit\"\n          }\n        }\n      }\n    ]\n  }\n}\n",
           "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-related-resource-outlet.json",
-          "contentHash": "e9e842635ad7211ff2f021ebbcc1071a8a491cd5c88885525ba153a8a49223b8",
+          "contentHash": "42ae917652755ce436674353d912f7fff6548f61be3e523d940aae6983af3d1a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-related-resource-outlet",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-core.mjs

@@ -14009,7 +14009,60 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
             args: [{ providedIn: 'any' }]
         }] });
 
+const RELATED_RESOURCE_OUTLET_I18N_NAMESPACE = 'relatedResourceOutlet';
+const RELATED_RESOURCE_OUTLET_I18N_CONFIG = {
+    namespaces: {
+        [RELATED_RESOURCE_OUTLET_I18N_NAMESPACE]: {
+            'pt-BR': {
+                'state.idle.title': 'Recurso relacionado não selecionado',
+                'state.idle.description': 'Selecione uma surface relacionada para carregar os dados.',
+                'state.resolving.title': 'Resolvendo recurso relacionado',
+                'state.resolving.description': 'Validando metadados e permissões da relação.',
+                'state.loading.title': 'Carregando recurso relacionado',
+                'state.loading.description': 'Aguarde enquanto a coleção relacionada é carregada.',
+                'state.empty.title': 'Nenhuma operação de leitura publicada',
+                'state.empty.description': 'A relação existe, mas não há operação de lista ou filtro disponível.',
+                'state.permission-limited.title': 'Acesso limitado',
+                'state.permission-limited.description': 'O contexto atual não permite abrir este recurso relacionado.',
+                'state.not-found.title': 'Relação indisponível',
+                'state.not-found.description': 'Não foi possível resolver a relação ou o identificador do registro pai.',
+                'state.error.title': 'Falha ao preparar recurso relacionado',
+                'state.error.description': 'Ocorreu um erro ao preparar a superfície relacionada.',
+                'emptyState.related.title': 'Sem registros em {label}',
+                'emptyState.related.description': 'Esta coleção relacionada não possui registros para o contexto selecionado.',
+                'emptyState.related.descriptionWithAction': 'Use a ação principal para adicionar um registro relacionado quando houver informações para registrar.',
+                'emptyState.related.action.create': 'Adicionar registro',
+                'action.open': 'Abrir relacionado',
+                'status.ready': 'Recurso relacionado pronto',
+            },
+            'en-US': {
+                'state.idle.title': 'Related resource not selected',
+                'state.idle.description': 'Select a related surface to load its data.',
+                'state.resolving.title': 'Resolving related resource',
+                'state.resolving.description': 'Validating relation metadata and permissions.',
+                'state.loading.title': 'Loading related resource',
+                'state.loading.description': 'Wait while the related collection is loaded.',
+                'state.empty.title': 'No read operation published',
+                'state.empty.description': 'The relation exists, but no list or filter operation is available.',
+                'state.permission-limited.title': 'Limited access',
+                'state.permission-limited.description': 'The current context cannot open this related resource.',
+                'state.not-found.title': 'Relation unavailable',
+                'state.not-found.description': 'The relation or parent record identifier could not be resolved.',
+                'state.error.title': 'Failed to prepare related resource',
+                'state.error.description': 'An error occurred while preparing the related surface.',
+                'emptyState.related.title': 'No records in {label}',
+                'emptyState.related.description': 'This related collection has no records for the selected context.',
+                'emptyState.related.descriptionWithAction': 'Use the primary action to add a related record when there is information to capture.',
+                'emptyState.related.action.create': 'Add record',
+                'action.open': 'Open related',
+                'status.ready': 'Related resource ready',
+            },
+        },
+    },
+};
+
 class RelatedResourceSurfaceResolverService {
+    i18n = inject(PraxisI18nService, { optional: true });
     resolve(request) {
         try {
             if (!request?.surface) {
@@ -14092,7 +14145,7 @@ class RelatedResourceSurfaceResolverService {
             apiEndpointKey: request.apiEndpointKey ?? null,
             apiUrlEntry: request.apiUrlEntry ?? null,
             tableId: request.tableId || this.buildStableTableId(surface, relatedResource, parentResourceId),
-            config: this.buildTableConfig(request.tableConfig, request.emptyState),
+            config: this.buildTableConfig(surface, relatedResource, request),
             queryContext,
         };
         payload.context = {
@@ -14115,28 +14168,66 @@ class RelatedResourceSurfaceResolverService {
         };
         return payload;
     }
-    buildTableConfig(tableConfig, emptyState) {
+    buildTableConfig(surface, relatedResource, request) {
+        const tableConfig = request.tableConfig;
+        const emptyState = request.emptyState;
         const hasTableConfig = !!tableConfig && typeof tableConfig === 'object' && !Array.isArray(tableConfig);
         const hasEmptyState = !!emptyState && typeof emptyState === 'object' && !Array.isArray(emptyState);
-        if (!hasTableConfig && !hasEmptyState) {
-            return undefined;
-        }
         const base = hasTableConfig ? tableConfig : {};
-        if (!hasEmptyState) {
-            return base;
-        }
         const behavior = this.objectValue(base['behavior']);
+        const currentEmptyState = this.objectValue(behavior['emptyState']);
+        const hasCurrentEmptyState = Object.keys(currentEmptyState).length > 0;
+        const resolvedEmptyState = hasEmptyState
+            ? {
+                ...currentEmptyState,
+                ...emptyState,
+            }
+            : hasCurrentEmptyState
+                ? currentEmptyState
+                : this.buildRelatedEmptyState(surface, relatedResource, request);
+        if (!hasTableConfig && !resolvedEmptyState) {
+            return undefined;
+        }
         return {
             ...base,
             behavior: {
                 ...behavior,
-                emptyState: {
-                    ...this.objectValue(behavior['emptyState']),
-                    ...emptyState,
-                },
+                emptyState: resolvedEmptyState,
             },
         };
     }
+    buildRelatedEmptyState(surface, relatedResource, request) {
+        const label = this.trim(request.title)
+            || this.trim(surface.title)
+            || this.humanizeResourceKey(relatedResource.childResourceKey);
+        const canCreate = relatedResource.childOperations.includes('CREATE');
+        const descriptionKey = canCreate
+            ? 'emptyState.related.descriptionWithAction'
+            : 'emptyState.related.description';
+        const actions = canCreate
+            ? [
+                {
+                    label: this.t('emptyState.related.action.create', 'Adicionar registro'),
+                    action: 'create',
+                    icon: 'add',
+                    primary: true,
+                },
+            ]
+            : [];
+        return {
+            title: this.t('emptyState.related.title', 'Sem registros em {label}', { label }),
+            message: this.t(descriptionKey, canCreate
+                ? 'Use a ação principal para adicionar um registro relacionado quando houver informações para registrar.'
+                : 'Esta coleção relacionada não possui registros para o contexto selecionado.', { label }),
+            icon: this.trim(request.icon) || 'hub',
+            tone: 'neutral',
+            variant: 'inline',
+            density: 'compact',
+            alignment: 'center',
+            iconContainer: 'soft',
+            actions,
+        };
+    }
     objectValue(value) {
         return value && typeof value === 'object' && !Array.isArray(value)
             ? value
@@ -14207,6 +14298,22 @@ class RelatedResourceSurfaceResolverService {
     sanitizeStableId(value) {
         return value.replace(/[^a-zA-Z0-9._-]+/g, '-');
     }
+    humanizeResourceKey(value) {
+        const lastSegment = this.trim(value).split(/[./_-]+/).filter(Boolean).pop() || 'registros';
+        return lastSegment
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    t(key, fallback, params) {
+        if (this.i18n) {
+            return this.interpolate(this.i18n.t(key, params, fallback, RELATED_RESOURCE_OUTLET_I18N_NAMESPACE), params);
+        }
+        return this.interpolate(fallback, params);
+    }
+    interpolate(template, params) {
+        return Object.entries(params || {}).reduce((current, [name, value]) => current.replace(new RegExp(`\\{${name}\\}`, 'g'), String(value ?? '')), template);
+    }
     trim(value) {
         return typeof value === 'string' ? value.trim() : '';
     }
@@ -37417,50 +37524,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 args: ['afterWidgetLoader', { read: DynamicWidgetLoaderDirective }]
             }] } });
 
-const RELATED_RESOURCE_OUTLET_I18N_NAMESPACE = 'relatedResourceOutlet';
-const RELATED_RESOURCE_OUTLET_I18N_CONFIG = {
-    namespaces: {
-        [RELATED_RESOURCE_OUTLET_I18N_NAMESPACE]: {
-            'pt-BR': {
-                'state.idle.title': 'Recurso relacionado não selecionado',
-                'state.idle.description': 'Selecione uma surface relacionada para carregar os dados.',
-                'state.resolving.title': 'Resolvendo recurso relacionado',
-                'state.resolving.description': 'Validando metadados e permissões da relação.',
-                'state.loading.title': 'Carregando recurso relacionado',
-                'state.loading.description': 'Aguarde enquanto a coleção relacionada é carregada.',
-                'state.empty.title': 'Nenhuma operação de leitura publicada',
-                'state.empty.description': 'A relação existe, mas não há operação de lista ou filtro disponível.',
-                'state.permission-limited.title': 'Acesso limitado',
-                'state.permission-limited.description': 'O contexto atual não permite abrir este recurso relacionado.',
-                'state.not-found.title': 'Relação indisponível',
-                'state.not-found.description': 'Não foi possível resolver a relação ou o identificador do registro pai.',
-                'state.error.title': 'Falha ao preparar recurso relacionado',
-                'state.error.description': 'Ocorreu um erro ao preparar a superfície relacionada.',
-                'action.open': 'Abrir relacionado',
-                'status.ready': 'Recurso relacionado pronto',
-            },
-            'en-US': {
-                'state.idle.title': 'Related resource not selected',
-                'state.idle.description': 'Select a related surface to load its data.',
-                'state.resolving.title': 'Resolving related resource',
-                'state.resolving.description': 'Validating relation metadata and permissions.',
-                'state.loading.title': 'Loading related resource',
-                'state.loading.description': 'Wait while the related collection is loaded.',
-                'state.empty.title': 'No read operation published',
-                'state.empty.description': 'The relation exists, but no list or filter operation is available.',
-                'state.permission-limited.title': 'Limited access',
-                'state.permission-limited.description': 'The current context cannot open this related resource.',
-                'state.not-found.title': 'Relation unavailable',
-                'state.not-found.description': 'The relation or parent record identifier could not be resolved.',
-                'state.error.title': 'Failed to prepare related resource',
-                'state.error.description': 'An error occurred while preparing the related surface.',
-                'action.open': 'Open related',
-                'status.ready': 'Related resource ready',
-            },
-        },
-    },
-};
-
 class PraxisRelatedResourceOutletComponent {
     resolver = inject(RelatedResourceSurfaceResolverService);
     materializer = inject(SurfaceOpenMaterializerService);
@@ -37880,7 +37943,7 @@ const PRAXIS_RELATED_RESOURCE_OUTLET_COMPONENT_METADATA = {
         { name: 'parentResourcePath', type: 'string | null', description: 'ResourcePath do recurso pai para contexto da surface.' },
         { name: 'queryContext', type: 'RelatedResourceQueryContext | null', description: 'QueryContext base mesclado com o filtro canônico da relação filha.' },
         { name: 'tableConfig', type: 'Record<string, unknown> | null', description: 'Configuracao parcial da tabela filha materializada, mesclada ao preset canonico.' },
-        { name: 'emptyState', type: 'Record<string, unknown> | null', description: 'Atalho para behavior.emptyState da tabela filha, usado para texto, icone, tom e layout do estado vazio.' },
+        { name: 'emptyState', type: 'Record<string, unknown> | null', description: 'Override opcional para behavior.emptyState da tabela filha. Quando omitido, o outlet deriva texto, icone, layout e ação create a partir de surface.relatedResource e dos metadados da surface.' },
         { name: 'mode', type: "'inline' | 'open-action'", description: 'Renderiza a tabela filha inline ou emite payload para abertura host-mediated.', default: 'inline' },
         { name: 'state', type: 'RelatedResourceResolutionState | null', description: 'Override de estado para hosts/outlets que estejam carregando discovery remoto.' },
         { name: 'compact', type: 'boolean', description: 'Reduz densidade visual dos estados não materializados.', default: false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.0-beta.62",
+  "version": "9.0.0-beta.64",
   "description": "Core library for Praxis UI Workspace: types, tokens, services and utilities shared across @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/praxisui-core.d.ts

@@ -9741,10 +9741,12 @@ interface RelatedResourceSurfaceResolution {
     payload?: SurfaceOpenPayload;
 }
 declare class RelatedResourceSurfaceResolverService {
+    private readonly i18n;
     resolve(request: RelatedResourceSurfaceResolverRequest | null | undefined): RelatedResourceSurfaceResolution;
     state(state: RelatedResourceResolutionState, reason?: string): RelatedResourceSurfaceResolution;
     private buildPayload;
     private buildTableConfig;
+    private buildRelatedEmptyState;
     private objectValue;
     private buildQueryContext;
     private resolveParentResourceId;
@@ -9754,6 +9756,9 @@ declare class RelatedResourceSurfaceResolverService {
     private buildStableTableId;
     private normalizeResourcePath;
     private sanitizeStableId;
+    private humanizeResourceKey;
+    private t;
+    private interpolate;
     private trim;
     private clone;
     static ɵfac: i0.ɵɵFactoryDeclaration<RelatedResourceSurfaceResolverService, never>;