@praxisui/crud 8.0.0-beta.17 → 8.0.0-beta.18

package/fesm2022/praxisui-crud.mjs

@@ -5290,6 +5290,12 @@ const CRUD_AI_CAPABILITIES = {
         { path: 'resource.path', category: 'resource', valueKind: 'string', description: 'Endpoint base do recurso.' },
         { path: 'resource.idField', category: 'resource', valueKind: 'string', description: 'Campo identificador do recurso.' },
         { path: 'resource.endpointKey', category: 'resource', valueKind: 'string', description: 'Chave de endpoint (ApiEndpoint).' },
+        { path: 'queryContext.meta.domainCatalog', category: 'resource', valueKind: 'object', description: 'Referencia leve para contexto semantico/governanca resolvido via Domain Catalog; nao materializa regras em FormConfig.' },
+        { path: 'queryContext.meta.domainCatalog.schemaVersion', category: 'resource', valueKind: 'string', description: 'Versao do contrato DomainCatalogContextHint usado em runtime e prompts.' },
+        { path: 'queryContext.meta.domainCatalog.resourceKey', category: 'resource', valueKind: 'string', description: 'ResourceKey semantico estavel usado para resolver vocabulario/governanca de dominio.' },
+        { path: 'queryContext.meta.domainCatalog.releaseId', category: 'resource', valueKind: 'string', description: 'Release opcional do Domain Catalog usada como fonte do contexto.' },
+        { path: 'queryContext.meta.domainCatalog.query', category: 'resource', valueKind: 'string', description: 'Probe de campo/conceito usado para buscar itens relevantes, como cpf, salario ou status.' },
+        { path: 'queryContext.meta.domainCatalog.intent', category: 'resource', valueKind: 'enum', allowedValues: ['authoring', 'explain', 'validate', 'ai-access-control'], description: 'Intencao de uso do contexto para orientar LLMs e validadores sem expor dados alem do necessario.' },
         // --- Table / Form ---
         { path: 'table', category: 'table', valueKind: 'object', description: 'TableConfig completo (usar catalogo de tabela).' },
         { path: 'form', category: 'form', valueKind: 'object', description: 'FormConfig completo (usar catalogo de formulario).' },
@@ -5450,6 +5456,20 @@ const permissionsSchema = {
         denyWhenMissingCapability: { type: 'boolean' },
     },
 };
+const domainGovernanceContextSchema = {
+    type: 'object',
+    required: ['resourceKey', 'query'],
+    properties: {
+        resourceKey: { type: 'string' },
+        releaseId: { type: 'string' },
+        query: { type: 'string' },
+        itemTypes: {
+            type: 'array',
+            items: { enum: ['governance', 'vocabulary', 'relationship'] },
+        },
+        intent: { enum: ['authoring', 'explain', 'validate', 'ai-access-control'] },
+    },
+};
 const childDelegateSchema = {
     type: 'object',
     required: ['childComponentId', 'childOperationId', 'reason'],
@@ -5486,6 +5506,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { kind: 'dialogHost', resolver: 'crud-dialog-host-defaults', description: 'Route/modal/drawer defaults consumed by CrudLauncherService and DynamicFormDialogHostComponent.' },
         { kind: 'formBinding', resolver: 'crud-action-form-contract-by-action-id', description: 'CRUD-owned form binding fields: formId, schemaUrl, submitUrl, submitMethod, params and initialValue.' },
         { kind: 'permissions', resolver: 'crud-resource-capabilities', description: 'CRUD action availability derived from resource capabilities and action permissions.' },
+        { kind: 'domainGovernanceContext', resolver: 'domain-catalog-context-by-resource-key', description: 'Read-only semantic/governance context resolved from Domain Catalog and referenced from CRUD queryContext.meta.' },
         { kind: 'childOperation', resolver: 'child-authoring-manifest-operation', description: 'Delegated form/table/dialog/settings-panel operation owned by the child component manifest.' },
     ],
     operations: [
@@ -5509,6 +5530,26 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
             submissionImpact: 'affects-remote-binding',
             preconditions: ['crud-metadata-loaded', 'api-metadata-available'],
         },
+        {
+            operationId: 'domain.governanceContext.attach',
+            title: 'Attach Domain Catalog governance context',
+            scope: 'dataBinding',
+            targetKind: 'domainGovernanceContext',
+            target: { kind: 'domainGovernanceContext', resolver: 'domain-catalog-context-by-resource-key', ambiguityPolicy: 'fail', required: true },
+            inputSchema: domainGovernanceContextSchema,
+            effects: [{ kind: 'compile-domain-patch', handler: 'crud-domain-governance-context-attach', handlerContract: {
+                        reads: ['CrudMetadata.resource', 'CrudMetadata.queryContext', 'DomainCatalogService.getGovernanceContext', 'DOMAIN_CATALOG_COMPONENT_CONTEXT_PACK', 'api_metadata'],
+                        writes: ['CrudMetadata.queryContext.meta.domainCatalog'],
+                        identityKeys: ['resourceKey', 'releaseId', 'query'],
+                        inputSchema: domainGovernanceContextSchema,
+                        failureModes: ['resource-key-missing', 'domain-catalog-release-not-found', 'governance-context-empty', 'ai-usage-forbidden'],
+                        description: 'Resolves read-only domain vocabulary/governance context and stores only a lightweight reference/probe under queryContext.meta.domainCatalog.',
+                    } }],
+            validators: ['resource-key-stable', 'domain-catalog-context-resolvable', 'domain-catalog-read-only', 'ai-usage-visibility-respected', 'no-form-config-rule-materialization'],
+            affectedPaths: ['queryContext.meta.domainCatalog'],
+            submissionImpact: 'config-only',
+            preconditions: ['crud-metadata-loaded', 'api-metadata-available', 'domain-catalog-service-available'],
+        },
         {
             operationId: 'list.surface.configure',
             title: 'Configure CRUD list surface',
@@ -5678,6 +5719,10 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { validatorId: 'resource-key-stable', level: 'error', code: 'CRUD_RESOURCE_KEY_STABLE', description: 'Resource key must remain stable for surfaces/actions/capabilities.' },
         { validatorId: 'id-field-known', level: 'error', code: 'CRUD_ID_FIELD_KNOWN', description: 'CRUD id field must exist for edit/view/delete flows.' },
         { validatorId: 'resource-capabilities-resolvable', level: 'error', code: 'CRUD_CAPABILITIES_RESOLVABLE', description: 'Resource capabilities must be resolvable before action enablement is authored.' },
+        { validatorId: 'domain-catalog-context-resolvable', level: 'error', code: 'CRUD_DOMAIN_CATALOG_CONTEXT_RESOLVABLE', description: 'Domain Catalog governance context must resolve for the resource key and requested probe before authoring uses it.' },
+        { validatorId: 'domain-catalog-read-only', level: 'error', code: 'CRUD_DOMAIN_CATALOG_READ_ONLY', description: 'Domain Catalog is read-only semantic context; CRUD may reference a probe but must not persist copied catalog rules.' },
+        { validatorId: 'ai-usage-visibility-respected', level: 'error', code: 'CRUD_AI_USAGE_VISIBILITY_RESPECTED', description: 'Authoring must respect Domain Catalog aiUsage.visibility before exposing field data, prompts or generated patches.' },
+        { validatorId: 'no-form-config-rule-materialization', level: 'error', code: 'CRUD_NO_FORM_RULE_MATERIALIZATION', description: 'Shared domain governance must not be materialized into FormConfig rules unless a backend policy explicitly authorizes it.' },
         { validatorId: 'table-child-operation-delegated', level: 'error', code: 'CRUD_TABLE_CHILD_DELEGATED', description: 'Table semantics must be delegated to praxis-table.' },
         { validatorId: 'query-context-valid', level: 'error', code: 'CRUD_QUERY_CONTEXT_VALID', description: 'Query context must be valid for the bound resource.' },
         { validatorId: 'filter-criteria-bridge-valid', level: 'warning', code: 'CRUD_FILTER_CRITERIA_BRIDGE_VALID', description: 'filterCriteria is a bridge; prefer queryContext for new remote authoring.' },
@@ -5714,6 +5759,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         'CrudMetadata is the canonical CRUD document shape.',
         'CrudAuthoringDocument wraps CrudMetadata without introducing host-local aliases.',
         'Resource path and resource key have separate semantics: path is operational, key is discovery/capability identity.',
+        'Domain Catalog context is referenced through resourceKey/release/probe and stays read-only; CRUD may attach queryContext.meta.domainCatalog but must not copy shared governance rules into FormConfig.',
         'Open mode round-trip must preserve route, formId, form contract, params, initialValue and back policy.',
         'FormConfig and FieldMetadata edits must delegate to dynamic-form or metadata-editor manifests.',
         'TableConfig edits must delegate to praxis-table; CRUD owns only shell orchestration and list surface binding.',
@@ -5722,6 +5768,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
     ],
     examples: [
         { id: 'crud-bind-funcionarios-resource', request: 'Bind this CRUD to funcionarios using id as the identifier.', operationId: 'resource.bind', target: 'resource:funcionarios', params: { resourcePath: '/funcionarios', resourceKey: 'funcionarios', idField: 'id' }, isPositive: true },
+        { id: 'crud-attach-lgpd-cpf-context', request: 'Use the Domain Catalog LGPD context for cpf before changing the employee CRUD.', operationId: 'domain.governanceContext.attach', target: 'domainCatalog:human-resources.funcionarios:cpf', params: { resourceKey: 'human-resources.funcionarios', query: 'cpf', itemTypes: ['governance'], intent: 'authoring' }, isPositive: true },
         { id: 'crud-list-query-context', request: 'Filter the list by active employees using the canonical query context.', operationId: 'list.surface.configure', target: 'listSurface', params: { queryContext: { filters: [{ field: 'active', operator: 'eq', value: true }] } }, isPositive: true },
         { id: 'crud-create-modal', request: 'Open create in a modal with the employee form.', operationId: 'surface.create.configure', target: 'action:create', params: { actionId: 'create', openMode: 'modal', formId: 'employee-create' }, isPositive: true },
         { id: 'crud-edit-route-with-id', request: 'Edit should navigate to /employees/:id and map the row id.', operationId: 'surface.edit.configure', target: 'action:edit', params: { actionId: 'edit', openMode: 'route', route: '/employees/:id/edit', params: [{ from: 'id', to: 'routeParam', name: 'id' }] }, isPositive: true },
@@ -5732,6 +5779,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { id: 'crud-delegate-form-layout', request: 'Add a new field to the create form.', operationId: 'form.childOperation.delegate', target: 'praxis-dynamic-form:field.add', params: { childComponentId: 'praxis-dynamic-form', childOperationId: 'field.add', reason: 'Form field semantics belong to dynamic-form' }, isPositive: true },
         { id: 'crud-delegate-table-column', request: 'Add a salary column to the list table.', operationId: 'form.childOperation.delegate', target: 'praxis-table:column.add', params: { childComponentId: 'praxis-table', childOperationId: 'column.add', reason: 'Table column semantics belong to praxis-table' }, isPositive: true },
         { id: 'crud-reject-local-form-rules', request: 'Put this dynamic-form validation rule directly inside CRUD.', operationId: 'form.childOperation.delegate', target: 'praxis-dynamic-form:rules.add', params: { childComponentId: 'praxis-dynamic-form', childOperationId: 'rules.add', reason: 'CRUD must not redefine FormConfig rules' }, isPositive: false },
+        { id: 'crud-reject-copy-domain-rule-to-formconfig', request: 'Copy the LGPD rule from Domain Catalog directly into the create form JSON.', operationId: 'domain.governanceContext.attach', target: 'domainCatalog:human-resources.funcionarios:cpf', params: { resourceKey: 'human-resources.funcionarios', query: 'cpf', itemTypes: ['governance'], intent: 'authoring' }, isPositive: false },
         { id: 'crud-reject-delete-without-capability', request: 'Force delete even though the backend does not expose delete capability.', operationId: 'delete.enabled.set', target: 'action:delete', params: { enabled: true, actionId: 'delete', requiresConfirmation: false }, isPositive: false },
     ],
 };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/crud",
-  "version": "8.0.0-beta.17",
+  "version": "8.0.0-beta.18",
   "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": "^8.0.0-beta.17",
-    "@praxisui/table": "^8.0.0-beta.17",
-    "@praxisui/core": "^8.0.0-beta.17",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.17",
-    "@praxisui/settings-panel": "^8.0.0-beta.17"
+    "@praxisui/dynamic-form": "^8.0.0-beta.18",
+    "@praxisui/table": "^8.0.0-beta.18",
+    "@praxisui/core": "^8.0.0-beta.18",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.18",
+    "@praxisui/settings-panel": "^8.0.0-beta.18"
   },
   "dependencies": {
     "tslib": "^2.3.0"