@praxisui/core 9.0.0-beta.40 → 9.0.0-beta.41

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-06T15:31:28.393Z",
+  "generatedAt": "2026-07-06T18:00:15.329Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.0-beta.40",
+  "packageVersion": "9.0.0-beta.41",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,

package/fesm2022/praxisui-core.mjs

@@ -13960,7 +13960,7 @@ class SurfaceOpenMaterializerService {
                 };
             }
             const schemaFields = await this.resolveSchemaFields(payload, discoveryOptions);
-            return this.materializeArrayAsTable(payload, collectionData, schemaFields, resourceId, readUrl);
+            return this.materializeArrayProjection(payload, collectionData, schemaFields, resourceId, readUrl);
         }
         if (responseCardinality === 'COLLECTION' || responseCardinality === 'PAGE') {
             return {
@@ -14133,6 +14133,86 @@ class SurfaceOpenMaterializerService {
             return [];
         }
     }
+    materializeArrayProjection(payload, data, fields, resourceId, readUrl) {
+        if (this.hasRelatedChildWriteOperations(payload)) {
+            return this.materializeArrayAsCrud(payload, data, fields, resourceId, readUrl);
+        }
+        return this.materializeArrayAsTable(payload, data, fields, resourceId, readUrl);
+    }
+    materializeArrayAsCrud(payload, data, fields, resourceId, readUrl) {
+        const previousInputs = payload.widget.inputs || {};
+        const surfaceId = this.stableSurfaceId(payload);
+        const relatedResource = this.resolveRelatedResource(payload);
+        const schemaResourcePath = this.normalizeResourcePath(relatedResource?.childResourcePath || this.resolveSurfacePath(payload));
+        const resourcePath = this.normalizeResourcePath(readUrl);
+        const tableConfig = this.buildLocalTableConfig(fields, data, payload);
+        const operations = this.resolveRelatedChildOperations(payload);
+        const actions = this.buildRelatedCrudActions(payload, operations);
+        return {
+            ...payload,
+            widget: {
+                ...payload.widget,
+                id: 'praxis-crud',
+                bindingOrder: [
+                    'crudId',
+                    'componentInstanceId',
+                    'metadata',
+                    'context',
+                    'enableCustomization',
+                ],
+                outputs: {
+                    afterOpen: 'emit',
+                    afterClose: 'emit',
+                    afterSave: 'emit',
+                    afterDelete: 'emit',
+                    rowClick: 'emit',
+                    selectionChange: 'emit',
+                    error: 'emit',
+                },
+                inputs: {
+                    crudId: String(previousInputs['tableId'] || surfaceId),
+                    componentInstanceId: `${surfaceId}.${resourceId}`,
+                    metadata: {
+                        component: 'praxis-crud',
+                        resource: {
+                            path: resourcePath,
+                            schemaPath: schemaResourcePath || null,
+                            idField: this.resolveRelatedSelectionKeyField(payload),
+                            endpointKey: previousInputs['apiEndpointKey'] ?? undefined,
+                            apiUrlEntry: previousInputs['apiUrlEntry'] ?? undefined,
+                        },
+                        data,
+                        table: tableConfig,
+                        queryContext: previousInputs['queryContext'] ?? payload.context?.['queryContext'] ?? null,
+                        defaults: {
+                            openMode: 'drawer',
+                            modal: {
+                                width: 'min(720px, 100vw)',
+                                maxWidth: '100vw',
+                                height: '100vh',
+                                position: 'end',
+                            },
+                        },
+                        actions,
+                    },
+                    context: {
+                        ...(payload.context || {}),
+                        materialization: {
+                            ...payload.context?.['materialization'],
+                            relatedResourceCrud: true,
+                        },
+                    },
+                    enableCustomization: previousInputs['enableCustomization'] ?? true,
+                },
+            },
+            context: this.mergeMaterializationContext(payload, {
+                readUrl,
+                dataShape: 'array',
+                recordCount: data.length,
+                presentation: 'materialized-crud',
+            }),
+        };
+    }
     materializeArrayAsTable(payload, data, fields, resourceId, readUrl) {
         const previousInputs = payload.widget.inputs || {};
         const tableInputOverrides = this.projectTableInputs(previousInputs);
@@ -14169,7 +14249,7 @@ class SurfaceOpenMaterializerService {
                     subtitle: payload.subtitle,
                     icon: payload.icon,
                     data,
-                    config: this.buildLocalTableConfig(fields, data),
+                    config: this.buildLocalTableConfig(fields, data, payload),
                     enableCustomization: previousInputs['enableCustomization'] ?? true,
                 },
             },
@@ -14245,7 +14325,7 @@ class SurfaceOpenMaterializerService {
         ]);
         return Object.fromEntries(Object.entries(inputs).filter(([key]) => supported.has(key)));
     }
-    buildLocalTableConfig(fields, data) {
+    buildLocalTableConfig(fields, data, payload) {
         const schemaColumns = fields
             .filter((field) => !field.hidden && !field.tableHidden && !!field.name)
             .map((field) => ({
@@ -14258,8 +14338,30 @@ class SurfaceOpenMaterializerService {
         const fallbackColumns = schemaColumns.length
             ? []
             : this.inferColumnsFromData(data);
+        const childOperations = this.resolveRelatedChildOperations(payload);
+        const relatedActions = this.buildRelatedCrudActions(payload, childOperations);
+        const toolbarActions = relatedActions
+            .filter((action) => action['action'] === 'create')
+            .map((action) => ({ ...action, variant: 'raised' }));
+        const bulkActions = relatedActions
+            .filter((action) => action['action'] === 'edit' || action['action'] === 'delete');
         return {
             columns: schemaColumns.length ? schemaColumns : fallbackColumns,
+            toolbar: toolbarActions.length
+                ? {
+                    visible: true,
+                    actions: toolbarActions,
+                }
+                : undefined,
+            actions: bulkActions.length
+                ? {
+                    bulk: {
+                        enabled: true,
+                        position: 'toolbar',
+                        actions: bulkActions,
+                    },
+                }
+                : undefined,
             behavior: {
                 localDataMode: { enabled: true },
                 pagination: { enabled: true, pageSize: 10 },
@@ -14271,6 +14373,109 @@ class SurfaceOpenMaterializerService {
             },
         };
     }
+    buildRelatedCrudActions(payload, operations) {
+        const noun = this.resolveRelatedActionNoun(payload);
+        const actions = [];
+        if (operations.has('CREATE')) {
+            actions.push({
+                id: 'create',
+                action: 'create',
+                label: `Novo ${noun}`,
+                icon: 'add',
+                color: 'primary',
+                type: 'button',
+                openMode: 'drawer',
+            });
+        }
+        if (operations.has('UPDATE')) {
+            actions.push({
+                id: 'edit',
+                action: 'edit',
+                label: `Editar ${noun}`,
+                icon: 'edit',
+                color: 'primary',
+                type: 'button',
+                openMode: 'drawer',
+            });
+        }
+        if (operations.has('DELETE')) {
+            actions.push({
+                id: 'delete',
+                action: 'delete',
+                label: `Apagar ${noun}`,
+                icon: 'delete',
+                color: 'warn',
+                type: 'button',
+                openMode: 'drawer',
+                requiresConfirmation: true,
+            });
+        }
+        return actions;
+    }
+    hasRelatedChildWriteOperations(payload) {
+        const operations = this.resolveRelatedChildOperations(payload);
+        return operations.has('CREATE') || operations.has('UPDATE') || operations.has('DELETE');
+    }
+    resolveRelatedChildOperations(payload) {
+        const relatedResource = this.resolveRelatedResource(payload);
+        const operations = Array.isArray(relatedResource?.childOperations)
+            ? relatedResource.childOperations
+            : [];
+        return new Set(operations
+            .map((operation) => String(operation || '').trim().toUpperCase())
+            .filter(Boolean));
+    }
+    resolveRelatedResource(payload) {
+        const relatedResource = payload.context?.['relatedResource'];
+        return relatedResource;
+    }
+    resolveRelatedSelectionKeyField(payload) {
+        const relatedResource = this.resolveRelatedResource(payload);
+        const field = String(relatedResource?.selectionKeyField || '').trim();
+        return field || 'id';
+    }
+    resolveSurfacePath(payload) {
+        const surface = payload.context?.['surface'];
+        return String(surface?.['path'] || '').trim();
+    }
+    normalizeResourcePath(value) {
+        const raw = String(value || '').trim();
+        if (!raw)
+            return '';
+        if (/^https?:\/\//i.test(raw)) {
+            try {
+                return new URL(raw).pathname.replace(/\/+$/, '');
+            }
+            catch {
+                return '';
+            }
+        }
+        return raw.replace(/\/+$/, '');
+    }
+    resolveRelatedActionNoun(payload) {
+        const source = [
+            payload.title,
+            payload.context?.['surface']?.['title'],
+            this.resolveRelatedResource(payload)?.childResourcePath,
+        ]
+            .map((value) => String(value || '').trim())
+            .find(Boolean) || '';
+        const normalized = source
+            .normalize('NFD')
+            .replace(/[\u0300-\u036f]/g, '')
+            .toLowerCase();
+        if (/\b(documentos?|documents?)\b/.test(normalized)) {
+            return 'documento';
+        }
+        const firstToken = normalized
+            .split(/[^a-z0-9]+/)
+            .filter(Boolean)
+            .find((token) => !['de', 'da', 'do', 'das', 'dos', 'legal', 'legais'].includes(token));
+        if (firstToken && firstToken.length > 3) {
+            return firstToken.endsWith('s') ? firstToken.slice(0, -1) : firstToken;
+        }
+        return 'item';
+    }
     inferColumnsFromData(data) {
         const first = data.find((item) => item && typeof item === 'object' && !Array.isArray(item));
         if (!first || typeof first !== 'object')
@@ -14359,6 +14564,7 @@ class CrudOperationResolutionService {
             throw new Error('CrudOperationResolutionService requires resourcePath.');
         }
         const resourcePath = this.resolveCanonicalResourcePath(request, metadataResourcePath);
+        const schemaResourcePath = this.resolveCanonicalSchemaResourcePath(request, resourcePath);
         const diagnostics = [];
         const resolutionOptions = this.toDiscoveryOptions(request);
         if (this.hasExplicitContract(request)) {
@@ -14393,9 +14599,9 @@ class CrudOperationResolutionService {
                 visible: this.isAvailable(operationCapability),
                 enabled: this.isAvailable(operationCapability),
                 availability: operationCapability?.availability ?? null,
-                schemaUrl: this.resolveCanonicalSchemaUrl(operation, resourcePath, preferredMethod, resolutionOptions),
+                schemaUrl: this.resolveCanonicalSchemaUrl(operation, schemaResourcePath, preferredMethod, resolutionOptions),
                 responseSchemaUrl: operation === 'view'
-                    ? this.resolveCanonicalSchemaUrl('view', resourcePath, preferredMethod, resolutionOptions)
+                    ? this.resolveCanonicalSchemaUrl('view', schemaResourcePath, preferredMethod, resolutionOptions)
                     : null,
                 submitUrl: linkResolution.href,
                 submitMethod: operation === 'view'
@@ -14407,6 +14613,7 @@ class CrudOperationResolutionService {
         return this.buildConventionResolution({
             operation,
             resourcePath,
+            schemaResourcePath,
             resourceId: request.resourceId ?? null,
             diagnostics,
             resolutionOptions,
@@ -14468,7 +14675,7 @@ class CrudOperationResolutionService {
         };
     }
     buildConventionResolution(params) {
-        const { operation, resourcePath, resourceId, diagnostics, resolutionOptions, capability, preferredMethod, scope } = params;
+        const { operation, resourcePath, schemaResourcePath, resourceId, diagnostics, resolutionOptions, capability, preferredMethod, scope } = params;
         const submitUrl = this.resolveConventionSubmitUrl(operation, resourcePath, resourceId, diagnostics, resolutionOptions);
         return {
             operation,
@@ -14480,9 +14687,9 @@ class CrudOperationResolutionService {
             visible: this.isAvailable(capability),
             enabled: this.isAvailable(capability),
             availability: capability?.availability ?? null,
-            schemaUrl: this.resolveCanonicalSchemaUrl(operation, resourcePath, preferredMethod, resolutionOptions),
+            schemaUrl: this.resolveCanonicalSchemaUrl(operation, schemaResourcePath, preferredMethod, resolutionOptions),
             responseSchemaUrl: operation === 'view'
-                ? this.resolveCanonicalSchemaUrl('view', resourcePath, preferredMethod, resolutionOptions)
+                ? this.resolveCanonicalSchemaUrl('view', schemaResourcePath, preferredMethod, resolutionOptions)
                 : null,
             submitUrl,
             submitMethod: operation === 'view' ? preferredMethod : preferredMethod?.toLowerCase() ?? null,
@@ -14656,7 +14863,9 @@ class CrudOperationResolutionService {
         }
         try {
             const resolved = this.discovery.resolveHref(normalized, options);
-            const pathname = new URL(resolved).pathname.replace(/\/+/g, '/').replace(/\/+$/, '');
+            const pathname = decodeURIComponent(new URL(resolved).pathname)
+                .replace(/\/+/g, '/')
+                .replace(/\/+$/, '');
             return pathname || (normalized.startsWith('/') ? normalized : `/${normalized}`);
         }
         catch {
@@ -14670,6 +14879,10 @@ class CrudOperationResolutionService {
         }
         return fallbackResourcePath;
     }
+    resolveCanonicalSchemaResourcePath(request, fallbackResourcePath) {
+        const explicitSchemaPath = this.normalizeResourcePath(request.schemaResourcePath || '');
+        return explicitSchemaPath || fallbackResourcePath;
+    }
     toDiscoveryOptions(request) {
         if (!request.endpointKey && !request.apiUrlEntry) {
             return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.0-beta.40",
+  "version": "9.0.0-beta.41",
   "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

@@ -9759,11 +9759,21 @@ declare class SurfaceOpenMaterializerService {
     private resolveResourceId;
     private resolveItemReadUrl;
     private resolveSchemaFields;
+    private materializeArrayProjection;
+    private materializeArrayAsCrud;
     private materializeArrayAsTable;
     private ensureCollectionTableSelectionContract;
     private ensureTableSelectionConfig;
     private projectTableInputs;
     private buildLocalTableConfig;
+    private buildRelatedCrudActions;
+    private hasRelatedChildWriteOperations;
+    private resolveRelatedChildOperations;
+    private resolveRelatedResource;
+    private resolveRelatedSelectionKeyField;
+    private resolveSurfacePath;
+    private normalizeResourcePath;
+    private resolveRelatedActionNoun;
     private inferColumnsFromData;
     private extractCollectionData;
     private mergeMaterializationContext;
@@ -9801,6 +9811,7 @@ interface ResolvedCrudOperation {
 interface ResolveCrudOperationRequest {
     operation: ResourceCrudOperationId;
     resourcePath: string;
+    schemaResourcePath?: string | null;
     resourceId?: string | number | null;
     explicit?: ExplicitCrudResolutionContract | null;
 }
@@ -9838,6 +9849,7 @@ declare class CrudOperationResolutionService {
     private normalizeResourcePath;
     private resolveSchemaResourcePath;
     private resolveCanonicalResourcePath;
+    private resolveCanonicalSchemaResourcePath;
     private toDiscoveryOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<CrudOperationResolutionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CrudOperationResolutionService>;