@praxisui/core 9.0.0-beta.36 → 9.0.0-beta.38

package/ai/component-registry.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-04T01:05:24.857Z",
+  "generatedAt": "2026-07-06T01:44:02.635Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.36",
+  "packageVersion": "9.0.0-beta.38",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
-  "componentCount": 3,
+  "componentCount": 4,
   "components": {
     "praxis-domain-catalog": {
       "id": "praxis-domain-catalog",
@@ -3388,6 +3388,140 @@
         }
       ]
     },
+    "praxis-related-resource-outlet": {
+      "id": "praxis-related-resource-outlet",
+      "description": "Runtime genérico para materializar surface.relatedResource como tabela filha governada por metadata.",
+      "inputs": [
+        {
+          "name": "surfaceId",
+          "type": "string | null",
+          "required": false
+        },
+        {
+          "name": "surfaceCatalog",
+          "type": "ResourceSurfaceCatalogResponse | null",
+          "required": false
+        },
+        {
+          "name": "discoverySource",
+          "type": "ResourceLinkSource | null",
+          "required": false
+        },
+        {
+          "name": "parentLinks",
+          "type": "RestApiLinks | RestApiResponse<unknown> | null",
+          "required": false
+        },
+        {
+          "name": "apiEndpointKey",
+          "type": "ApiEndpoint | null",
+          "required": false
+        },
+        {
+          "name": "apiUrlEntry",
+          "type": "ApiUrlEntry | null",
+          "required": false
+        },
+        {
+          "name": "surface",
+          "type": "ResourceSurfaceCatalogItem | null",
+          "required": false
+        },
+        {
+          "name": "parentRecord",
+          "type": "Record<string, unknown> | null",
+          "required": false
+        },
+        {
+          "name": "parentResourceId",
+          "type": "string | number | null",
+          "required": false
+        },
+        {
+          "name": "parentResourcePath",
+          "type": "string | null",
+          "required": false
+        },
+        {
+          "name": "queryContext",
+          "type": "RelatedResourceQueryContext | null",
+          "required": false
+        },
+        {
+          "name": "mode",
+          "type": "'inline' | 'open-action'",
+          "required": false
+        },
+        {
+          "name": "state",
+          "type": "RelatedResourceResolutionState | null",
+          "required": false
+        },
+        {
+          "name": "compact",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "strictValidation",
+          "type": "boolean",
+          "required": false
+        }
+      ],
+      "outputs": [
+        {
+          "name": "surfaceOpen",
+          "type": "SurfaceOpenPayload",
+          "required": false
+        },
+        {
+          "name": "widgetEvent",
+          "type": "WidgetEventEnvelope",
+          "required": false
+        },
+        {
+          "name": "resourceEvent",
+          "type": "PraxisResourceEvent",
+          "required": false
+        }
+      ],
+      "configSchemaId": null,
+      "selector": "praxis-related-resource-outlet",
+      "friendlyName": "Related Resource Outlet",
+      "icon": "hub",
+      "tags": [
+        "resource",
+        "surface",
+        "related-resource",
+        "runtime",
+        "metadata-driven"
+      ],
+      "lib": "@praxisui/core",
+      "source": "projects/praxis-core/src/lib/surfaces/praxis-related-resource-outlet.metadata.ts",
+      "exportName": "PRAXIS_RELATED_RESOURCE_OUTLET_COMPONENT_METADATA",
+      "chunks": [
+        {
+          "chunkIndex": 0,
+          "chunkKind": "summary",
+          "content": "Component ID: praxis-related-resource-outlet\nSelector: praxis-related-resource-outlet\nFriendly Name: Related Resource Outlet\nDescription: Runtime genérico para materializar surface.relatedResource como tabela filha governada por metadata.\nLib/Package: @praxisui/core\nTags: resource, surface, related-resource, runtime, metadata-driven\nInputs:\n  - surfaceId (string | null)\n  - surfaceCatalog (ResourceSurfaceCatalogResponse | null)\n  - discoverySource (ResourceLinkSource | null)\n  - parentLinks (RestApiLinks | RestApiResponse<unknown> | null)\n  - apiEndpointKey (ApiEndpoint | null)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - surface (ResourceSurfaceCatalogItem | null)\n  - parentRecord (Record<string, unknown> | null)\n  - parentResourceId (string | number | null)\n  - parentResourcePath (string | null)\n  - queryContext (RelatedResourceQueryContext | null)\n  - mode ('inline' | 'open-action')\n  - state (RelatedResourceResolutionState | null)\n  - compact (boolean)\n  - strictValidation (boolean)\nOutputs:\n  - surfaceOpen (SurfaceOpenPayload)\n  - widgetEvent (WidgetEventEnvelope)\n  - resourceEvent (PraxisResourceEvent)\n",
+          "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/surfaces/praxis-related-resource-outlet.metadata.ts",
+          "contentHash": "116c99da68c5132d32f60a7ad56cd1ed8d5cb918111fffbae4e93eaed2097735",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-related-resource-outlet",
+          "corpusVersion": "1.0.0"
+        },
+        {
+          "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",
+          "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-related-resource-outlet.json",
+          "contentHash": "e9e842635ad7211ff2f021ebbcc1071a8a491cd5c88885525ba153a8a49223b8",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-related-resource-outlet",
+          "corpusVersion": "1.0.0"
+        }
+      ]
+    },
     "praxis-runtime-component-observation": {
       "id": "praxis-runtime-component-observation",
       "description": "Canonical runtime component observation contract for exposing active component instance grounding to agentic turns.",