@praxisui/core 9.0.0-beta.35 → 9.0.0-beta.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/ai/component-registry.json +107 -3
  2. package/fesm2022/praxisui-core.mjs +621 -10
  3. package/package.json +1 -1
  4. package/types/praxisui-core.d.ts +151 -3
package/ai/component-registry.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "generatedAt": "2026-07-03T17:45:06.072Z",
3
+ "generatedAt": "2026-07-06T00:01:30.215Z",
4
4
  "packageName": "@praxisui/core",
5
- "packageVersion": "9.0.0-beta.35",
5
+ "packageVersion": "9.0.0-beta.37",
6
6
  "sourceRegistry": "praxis-component-registry-ingestion",
7
7
  "sourceRegistryVersion": "1.0.0",
8
- "componentCount": 3,
8
+ "componentCount": 4,
9
9
  "components": {
10
10
  "praxis-domain-catalog": {
11
11
  "id": "praxis-domain-catalog",
@@ -3388,6 +3388,110 @@
3388
3388
  }
3389
3389
  ]
3390
3390
  },
3391
+ "praxis-related-resource-outlet": {
3392
+ "id": "praxis-related-resource-outlet",
3393
+ "description": "Runtime genérico para materializar surface.relatedResource como tabela filha governada por metadata.",
3394
+ "inputs": [
3395
+ {
3396
+ "name": "surface",
3397
+ "type": "ResourceSurfaceCatalogItem | null",
3398
+ "required": false
3399
+ },
3400
+ {
3401
+ "name": "parentRecord",
3402
+ "type": "Record<string, unknown> | null",
3403
+ "required": false
3404
+ },
3405
+ {
3406
+ "name": "parentResourceId",
3407
+ "type": "string | number | null",
3408
+ "required": false
3409
+ },
3410
+ {
3411
+ "name": "parentResourcePath",
3412
+ "type": "string | null",
3413
+ "required": false
3414
+ },
3415
+ {
3416
+ "name": "queryContext",
3417
+ "type": "RelatedResourceQueryContext | null",
3418
+ "required": false
3419
+ },
3420
+ {
3421
+ "name": "mode",
3422
+ "type": "'inline' | 'open-action'",
3423
+ "required": false
3424
+ },
3425
+ {
3426
+ "name": "state",
3427
+ "type": "RelatedResourceResolutionState | null",
3428
+ "required": false
3429
+ },
3430
+ {
3431
+ "name": "compact",
3432
+ "type": "boolean",
3433
+ "required": false
3434
+ },
3435
+ {
3436
+ "name": "strictValidation",
3437
+ "type": "boolean",
3438
+ "required": false
3439
+ }
3440
+ ],
3441
+ "outputs": [
3442
+ {
3443
+ "name": "surfaceOpen",
3444
+ "type": "SurfaceOpenPayload",
3445
+ "required": false
3446
+ },
3447
+ {
3448
+ "name": "widgetEvent",
3449
+ "type": "WidgetEventEnvelope",
3450
+ "required": false
3451
+ },
3452
+ {
3453
+ "name": "resourceEvent",
3454
+ "type": "PraxisResourceEvent",
3455
+ "required": false
3456
+ }
3457
+ ],
3458
+ "configSchemaId": null,
3459
+ "selector": "praxis-related-resource-outlet",
3460
+ "friendlyName": "Related Resource Outlet",
3461
+ "icon": "hub",
3462
+ "tags": [
3463
+ "resource",
3464
+ "surface",
3465
+ "related-resource",
3466
+ "runtime",
3467
+ "metadata-driven"
3468
+ ],
3469
+ "lib": "@praxisui/core",
3470
+ "source": "projects/praxis-core/src/lib/surfaces/praxis-related-resource-outlet.metadata.ts",
3471
+ "exportName": "PRAXIS_RELATED_RESOURCE_OUTLET_COMPONENT_METADATA",
3472
+ "chunks": [
3473
+ {
3474
+ "chunkIndex": 0,
3475
+ "chunkKind": "summary",
3476
+ "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 - 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",
3477
+ "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/surfaces/praxis-related-resource-outlet.metadata.ts",
3478
+ "contentHash": "e70544431cec6448df159ac05ec1a8ab672b70cf9c60fd76fd01ab849f18d48d",
3479
+ "sourceKind": "component_definition",
3480
+ "sourceId": "praxis-related-resource-outlet",
3481
+ "corpusVersion": "1.0.0"
3482
+ },
3483
+ {
3484
+ "chunkIndex": 1,
3485
+ "chunkKind": "recipe",
3486
+ "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 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 resolves relatedResource into a SurfaceOpenPayload and materializes praxis-table through DynamicWidgetLoader.\",\n \"migrationValue\": \"Hosts keep only parentRecord or parentResourceId in the page; parent-child filtering is declared once in metadata.\",\n \"agentCorpus\": \"This recipe keeps parentResourceKey, childResourceKey, childResourcePath and childParentField explicit so agents do not infer relationships from labels.\"\n },\n \"authoringGuidance\": [\n \"Use praxis-related-resource-outlet when a catalog surface already includes relatedResource.\",\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 \"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 \"surface\",\n \"parentRecord\",\n \"parentResourcePath\",\n \"mode\"\n ],\n \"inputs\": {\n \"mode\": \"inline\",\n \"parentResourcePath\": \"operations/missoes\",\n \"parentRecord\": {\n \"id\": 1,\n \"titulo\": \"Atlantic Shield\",\n \"status\": \"PLANEJADA\"\n },\n \"surface\": {\n \"id\": \"team\",\n \"resourceKey\": \"operations.missoes\",\n \"kind\": \"READ_PROJECTION\",\n \"scope\": \"ITEM\",\n \"title\": \"Equipe da missão\",\n \"description\": \"Lista participantes, papéis e resultados associados à missão\",\n \"operationId\": \"getTeam\",\n \"path\": \"/api/operations/missoes/{id}/team\",\n \"method\": \"GET\",\n \"schemaId\": \"missao-team-response\",\n \"schemaUrl\": \"/schemas/filtered?path=%2Fapi%2Foperations%2Fmissoes%2F%7Bid%7D%2Fteam&operation=get&schemaType=response\",\n \"responseCardinality\": \"COLLECTION\",\n \"availability\": {\n \"allowed\": true,\n \"metadata\": {}\n },\n \"order\": 50,\n \"tags\": [\n \"mission\",\n \"team\",\n \"read-projection\",\n \"related-resource\"\n ],\n \"relatedResource\": {\n \"parentResourceKey\": \"operations.missoes\",\n \"parentIdPathVariable\": \"id\",\n \"childResourceKey\": \"operations.missao-participantes\",\n \"childResourcePath\": \"/api/operations/missao-participantes\",\n \"childParentField\": \"missaoId\",\n \"selectable\": true,\n \"selectionKeyField\": \"id\",\n \"childOperations\": [\n \"FILTER\",\n \"LIST\",\n \"CREATE\",\n \"UPDATE\",\n \"DELETE\"\n ]\n }\n }\n },\n \"outputs\": {\n \"widgetEvent\": \"emit\",\n \"resourceEvent\": \"emit\",\n \"surfaceOpen\": \"emit\"\n }\n }\n }\n ]\n }\n}\n",
3487
+ "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-related-resource-outlet.json",
3488
+ "contentHash": "e1c32c7df8fe6f70e0987eacb3215f61ba4170ed2f2059fe3b4113c9d3e9db29",
3489
+ "sourceKind": "component_definition",
3490
+ "sourceId": "praxis-related-resource-outlet",
3491
+ "corpusVersion": "1.0.0"
3492
+ }
3493
+ ]
3494
+ },
3391
3495
  "praxis-runtime-component-observation": {
3392
3496
  "id": "praxis-runtime-component-observation",
3393
3497
  "description": "Canonical runtime component observation contract for exposing active component instance grounding to agentic turns.",