@praxisui/crud 10.0.0-rc.20 → 10.0.0-rc.21

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-15T03:52:00.118Z",
+  "generatedAt": "2026-10-15T04:35:19.773Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "10.0.0-rc.20",
+  "packageVersion": "10.0.0-rc.21",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-crud.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { inject, DestroyRef, signal, HostListener, ViewChild, Inject, ViewEncapsulation, Component, EventEmitter, ChangeDetectorRef, Output, Input, ChangeDetectionStrategy, Injectable, InjectionToken, input, ElementRef, computed, effect, output, Injector, booleanAttribute, Optional, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { inject, DestroyRef, signal, HostListener, ViewChild, Inject, ViewEncapsulation, Component, EventEmitter, ChangeDetectorRef, Output, Input, ChangeDetectionStrategy, Injectable, InjectionToken, input, ElementRef, computed, linkedSignal, effect, output, Injector, booleanAttribute, Optional, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { HttpClient } from '@angular/common/http';
 import { Router, ActivatedRoute, RouterLink } from '@angular/router';
@@ -7,7 +7,7 @@ import { MatSnackBar } from '@angular/material/snack-bar';
 import { firstValueFrom, BehaviorSubject, Subscription } from 'rxjs';
 import { take, filter } from 'rxjs/operators';
 import * as i2$1 from '@praxisui/core';
-import { PraxisBulkClientService, generateBulkIdempotencyKey, API_URL, SafeExpressionEvaluator, buildApiUrl, ASYNC_CONFIG_STORAGE, GlobalConfigService, CrudOperationResolutionService, LoggerService, SurfaceNavigationError, fillUndefined, GenericCrudService, SETTINGS_PANEL_DATA, PraxisI18nService, buildBaseColumnFromDef, PraxisIconDirective, providePraxisI18nConfig, createDefaultTableConfig, PraxisWidgetEventBus, EnterpriseRuntimeContextService, GLOBAL_SURFACE_SERVICE, SurfaceOutletRegistryService, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, composeHeadersWithVersion, normalizeSurfaceOperationContext, translateUnavailableWorkflowMessage, isSurfaceNavigationError, translateSurfaceNavigationRejected, normalizeUnknownError, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, SURFACE_DRAWER_REF, SURFACE_DRAWER_CONTENT_DATA, PraxisIconButtonComponent, PraxisResourceIdentityComponent, ComponentMetadataRegistry, PraxisCustomizationModeService } from '@praxisui/core';
+import { PraxisBulkClientService, generateBulkIdempotencyKey, API_URL, SafeExpressionEvaluator, buildApiUrl, ASYNC_CONFIG_STORAGE, GlobalConfigService, CrudOperationResolutionService, LoggerService, SurfaceNavigationError, fillUndefined, GenericCrudService, SETTINGS_PANEL_DATA, PraxisI18nService, buildBaseColumnFromDef, PraxisIconDirective, providePraxisI18nConfig, SchemaNormalizerService, createDefaultTableConfig, PraxisWidgetEventBus, EnterpriseRuntimeContextService, GLOBAL_SURFACE_SERVICE, SurfaceOutletRegistryService, ComponentKeyService, ResourceDiscoveryService, ResourceActionOpenAdapterService, ResourceSurfaceOpenAdapterService, composeHeadersWithVersion, normalizeSurfaceOperationContext, translateUnavailableWorkflowMessage, isSurfaceNavigationError, translateSurfaceNavigationRejected, normalizeUnknownError, EmptyStateCardComponent, RESOURCE_DISCOVERY_I18N_CONFIG, SURFACE_DRAWER_REF, SURFACE_DRAWER_CONTENT_DATA, PraxisIconButtonComponent, PraxisResourceIdentityComponent, ComponentMetadataRegistry, PraxisCustomizationModeService } from '@praxisui/core';
 export { createDynamicRecord, extractRecordId, isDynamicDataRecord, resolveDataField } from '@praxisui/core';
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
@@ -4971,9 +4971,17 @@ class CrudMetadataEditorComponent {
     lastExternalSignature = null;
     lastLoadedResourceSignature = '';
     schemaSub;
+    schemaScopeSignature = null;
+    schemaGeneration = 0;
+    destroyed = false;
     effectiveCrudId = computed(() => this.crudIdInput() || this.injectedData?.crudId || null, ...(ngDevMode ? [{ debugName: "effectiveCrudId" }] : /* istanbul ignore next */ []));
     isReadonly = computed(() => !!(this.readonlyInput() || this.injectedData?.readonly), ...(ngDevMode ? [{ debugName: "isReadonly" }] : /* istanbul ignore next */ []));
     providedEffectiveTableConfig = computed(() => this.effectiveTableConfigInput() || this.injectedData?.effectiveTableConfig || null, ...(ngDevMode ? [{ debugName: "providedEffectiveTableConfig" }] : /* istanbul ignore next */ []));
+    providedSnapshotOwner = linkedSignal({ ...(ngDevMode ? { debugName: "providedSnapshotOwner" } : /* istanbul ignore next */ {}), source: () => ({
+            snapshot: this.providedEffectiveTableConfig(),
+            resourceIdentity: this.resourceSchemaIdentity(parseLegacyOrCrudDocument(this.resolveExternalSeed()).metadata),
+        }),
+        computation: (source, previous) => previous && source.snapshot === previous.source.snapshot ? previous.value : source });
     diagnostics = computed(() => validateCrudAuthoringDocument(this.currentDocument(), { requireCanonicalActions: true }), ...(ngDevMode ? [{ debugName: "diagnostics" }] : /* istanbul ignore next */ []));
     errorCount = computed(() => this.diagnostics().filter((issue) => issue.level === 'error').length, ...(ngDevMode ? [{ debugName: "errorCount" }] : /* istanbul ignore next */ []));
     warningCount = computed(() => this.diagnostics().filter((issue) => issue.level !== 'error').length, ...(ngDevMode ? [{ debugName: "warningCount" }] : /* istanbul ignore next */ []));
@@ -4988,20 +4996,16 @@ class CrudMetadataEditorComponent {
     resourcePath = computed(() => this.currentDocument().metadata.resource?.path || '', ...(ngDevMode ? [{ debugName: "resourcePath" }] : /* istanbul ignore next */ []));
     resourceIdField = computed(() => String(this.currentDocument().metadata.resource?.idField ?? ''), ...(ngDevMode ? [{ debugName: "resourceIdField" }] : /* istanbul ignore next */ []));
     resourceEndpointKey = computed(() => String(this.currentDocument().metadata.resource?.endpointKey ?? ''), ...(ngDevMode ? [{ debugName: "resourceEndpointKey" }] : /* istanbul ignore next */ []));
-    resourceChangedSinceInit = computed(() => {
-        const initialResource = this.initialDocument().metadata.resource;
-        const currentResource = this.currentDocument().metadata.resource;
-        return (String(initialResource?.path || '').trim() !== String(currentResource?.path || '').trim() ||
-            String(initialResource?.endpointKey || '').trim() !==
-                String(currentResource?.endpointKey || '').trim());
-    }, ...(ngDevMode ? [{ debugName: "resourceChangedSinceInit" }] : /* istanbul ignore next */ []));
+    resourceChangedSinceInit = computed(() => this.resourceSchemaIdentity(this.initialDocument().metadata) !==
+        this.resourceSchemaIdentity(this.currentDocument().metadata), ...(ngDevMode ? [{ debugName: "resourceChangedSinceInit" }] : /* istanbul ignore next */ []));
     authoredTableColumns = computed(() => {
         const raw = this.currentDocument().metadata.table?.columns;
         return Array.isArray(raw) ? raw : [];
     }, ...(ngDevMode ? [{ debugName: "authoredTableColumns" }] : /* istanbul ignore next */ []));
     resolvedInheritedColumns = computed(() => {
-        if (!this.resourceChangedSinceInit()) {
-            const runtimeColumns = this.providedEffectiveTableConfig()?.columns;
+        const provided = this.providedSnapshotOwner();
+        if (provided.resourceIdentity === this.resourceSchemaIdentity(this.currentDocument().metadata)) {
+            const runtimeColumns = provided.snapshot?.columns;
             if (Array.isArray(runtimeColumns) && runtimeColumns.length > 0) {
                 return runtimeColumns;
             }
@@ -5157,6 +5161,9 @@ class CrudMetadataEditorComponent {
             const parsed = parseLegacyOrCrudDocument(seed);
             this.initialDocument.set(parsed);
             this.currentDocument.set(parsed);
+            // Observe the supplied snapshot with its external resource, before local edits.
+            this.providedSnapshotOwner();
+            this.synchronizeSchemaScope();
             this.kpiFilterJsonDrafts.set({});
             this.quickFilterExpressionDrafts.set({});
             this.syncState();
@@ -5165,13 +5172,10 @@ class CrudMetadataEditorComponent {
             const path = this.resourcePath().trim();
             const endpointKey = this.resourceEndpointKey().trim();
             const apiUrlEntry = this.currentDocument().metadata.resource?.apiUrlEntry ?? null;
-            const signature = `${path}|${endpointKey}|${JSON.stringify(apiUrlEntry)}`;
-            if (!path) {
-                this.lastLoadedResourceSignature = '';
-                this.schemaResolvedColumnsSignal.set([]);
-                this.schemaResolvedFilterFieldsSignal.set([]);
+            const signature = this.resourceSchemaIdentity(this.currentDocument().metadata);
+            this.synchronizeSchemaScope();
+            if (!path)
                 return;
-            }
             if (signature === this.lastLoadedResourceSignature) {
                 return;
             }
@@ -5179,7 +5183,8 @@ class CrudMetadataEditorComponent {
             this.loadResourceSchemaColumns(path, endpointKey || undefined, apiUrlEntry);
         });
         this.destroyRef.onDestroy(() => {
-            this.schemaSub?.unsubscribe();
+            this.destroyed = true;
+            this.invalidateSchemaScope();
         });
     }
     getSettingsValue() {
@@ -5190,6 +5195,7 @@ class CrudMetadataEditorComponent {
     }
     reset() {
         this.currentDocument.set(this.initialDocument());
+        this.synchronizeSchemaScope();
         this.initialValueDrafts.set({});
         this.kpiFilterJsonDrafts.set({});
         this.quickFilterExpressionDrafts.set({});
@@ -6681,43 +6687,81 @@ class CrudMetadataEditorComponent {
             };
         });
     }
-    loadResourceSchemaColumns(resourcePath, endpointKey, apiUrlEntry) {
-        if (!this.crudService || typeof this.crudService.configure !== 'function') {
+    resourceSchemaIdentity(metadata) {
+        const resource = metadata.resource;
+        return JSON.stringify([
+            String(resource?.path ?? '').trim(),
+            String(resource?.endpointKey ?? '').trim(),
+            resource?.apiUrlEntry ?? null,
+        ]);
+    }
+    synchronizeSchemaScope() {
+        const signature = this.resourceSchemaIdentity(this.currentDocument().metadata);
+        if (signature === this.schemaScopeSignature)
             return;
-        }
+        this.invalidateSchemaScope();
+        this.schemaScopeSignature = signature;
+    }
+    invalidateSchemaScope() {
+        ++this.schemaGeneration;
         this.schemaSub?.unsubscribe();
+        this.schemaSub = undefined;
+        this.lastLoadedResourceSignature = '';
+        this.schemaResolvedColumnsSignal.set([]);
+        this.schemaResolvedFilterFieldsSignal.set([]);
+        this.isBusy$.next(false);
+    }
+    loadResourceSchemaColumns(resourcePath, endpointKey, apiUrlEntry) {
+        if (!this.crudService)
+            return;
+        const generation = this.schemaGeneration;
+        const signature = this.resourceSchemaIdentity(this.currentDocument().metadata);
+        const externalSignature = () => this.resourceSchemaIdentity(parseLegacyOrCrudDocument(this.resolveExternalSeed()).metadata);
+        const requestExternalSignature = externalSignature();
+        const isCurrent = () => {
+            const external = externalSignature();
+            return !this.destroyed && generation === this.schemaGeneration &&
+                signature === this.resourceSchemaIdentity(this.currentDocument().metadata) &&
+                // An editorial seed update or owner echo of the edited resource keeps this read.
+                (external === requestExternalSignature || external === signature);
+        };
+        this.isBusy$.next(true);
         try {
             this.crudService.configure(resourcePath, {
                 endpointKey: endpointKey,
                 apiUrlEntry: apiUrlEntry ?? undefined,
             });
-            const schema$ = this.crudService.getSchema?.();
-            if (!schema$ || typeof schema$.subscribe !== 'function') {
-                return;
-            }
-            this.schemaSub = schema$.subscribe({
+            this.schemaSub = this.crudService.getSchema().subscribe({
                 next: (fields) => {
-                    if (!Array.isArray(fields) || fields.length === 0) {
+                    if (!isCurrent())
                         return;
-                    }
-                    const projected = fields
+                    const resolved = Array.isArray(fields) ? fields : [];
+                    this.schemaResolvedColumnsSignal.set(resolved
                         .filter((field) => !field.tableHidden && !field.hidden)
-                        .map((field) => buildBaseColumnFromDef(field));
-                    this.schemaResolvedColumnsSignal.set(projected);
-                    this.schemaResolvedFilterFieldsSignal.set(fields
+                        .map((field) => buildBaseColumnFromDef(field)));
+                    this.schemaResolvedFilterFieldsSignal.set(resolved
                         .filter((field) => !!String(field?.name || '').trim())
                         .map((field) => ({
                         field: String(field.name).trim(),
                         header: String(field.label || field.name).trim(),
                     })));
+                    this.isBusy$.next(false);
                 },
                 error: () => {
-                    // Non-blocking fallback when schema endpoint is unavailable in isolated unit tests
+                    if (!isCurrent())
+                        return;
+                    this.schemaResolvedColumnsSignal.set([]);
+                    this.schemaResolvedFilterFieldsSignal.set([]);
+                    this.isBusy$.next(false);
                 },
+                complete: () => { if (isCurrent())
+                    this.isBusy$.next(false); },
             });
         }
         catch {
-            // Ignore schema resolution errors in isolated test environments without HttpClient
+            // An unavailable reader must not preserve another resource's inferred fields.
+            if (isCurrent())
+                this.isBusy$.next(false);
         }
     }
     patchAction(actionName, patcher) {
@@ -6743,6 +6787,7 @@ class CrudMetadataEditorComponent {
             metadata: updater(this.currentDocument().metadata),
         });
         this.currentDocument.set(next);
+        this.synchronizeSchemaScope();
         this.syncState();
     }
     buildPayload() {
@@ -6763,9 +6808,9 @@ class CrudMetadataEditorComponent {
     syncState() {
         const currentSignature = JSON.stringify(serializeCrudAuthoringDocument(this.currentDocument()));
         const initialSignature = JSON.stringify(serializeCrudAuthoringDocument(this.initialDocument()));
-        this.isDirty$.next(currentSignature !== initialSignature);
-        const hasErrorDiagnostics = this.diagnostics().some((issue) => issue.level === 'error');
         const hasInvalidKpiJson = Object.keys(this.kpiFilterJsonDrafts()).length > 0;
+        this.isDirty$.next(currentSignature !== initialSignature || hasInvalidKpiJson);
+        const hasErrorDiagnostics = this.diagnostics().some((issue) => issue.level === 'error');
         this.isValid$.next(!hasErrorDiagnostics && !hasInvalidKpiJson);
     }
     tx(key, fallback) {
@@ -6839,7 +6884,20 @@ class CrudMetadataEditorComponent {
         }[section];
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: CrudMetadataEditorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: CrudMetadataEditorComponent, isStandalone: true, selector: "praxis-crud-metadata-editor", inputs: { documentInput: { classPropertyName: "documentInput", publicName: "document", isSignal: true, isRequired: false, transformFunction: null }, metadataInput: { classPropertyName: "metadataInput", publicName: "metadata", isSignal: true, isRequired: false, transformFunction: null }, crudIdInput: { classPropertyName: "crudIdInput", publicName: "crudId", isSignal: true, isRequired: false, transformFunction: null }, readonlyInput: { classPropertyName: "readonlyInput", publicName: "readonly", isSignal: true, isRequired: false, transformFunction: null }, effectiveTableConfigInput: { classPropertyName: "effectiveTableConfigInput", publicName: "effectiveTableConfig", isSignal: true, isRequired: false, transformFunction: null } }, providers: [providePraxisI18nConfig(PRAXIS_CRUD_AUTHORING_I18N_CONFIG)], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: CrudMetadataEditorComponent, isStandalone: true, selector: "praxis-crud-metadata-editor", inputs: { documentInput: { classPropertyName: "documentInput", publicName: "document", isSignal: true, isRequired: false, transformFunction: null }, metadataInput: { classPropertyName: "metadataInput", publicName: "metadata", isSignal: true, isRequired: false, transformFunction: null }, crudIdInput: { classPropertyName: "crudIdInput", publicName: "crudId", isSignal: true, isRequired: false, transformFunction: null }, readonlyInput: { classPropertyName: "readonlyInput", publicName: "readonly", isSignal: true, isRequired: false, transformFunction: null }, effectiveTableConfigInput: { classPropertyName: "effectiveTableConfigInput", publicName: "effectiveTableConfig", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            providePraxisI18nConfig(PRAXIS_CRUD_AUTHORING_I18N_CONFIG),
+            {
+                provide: GenericCrudService,
+                useFactory: () => {
+                    const http = inject(HttpClient, { optional: true });
+                    const apiUrl = inject(API_URL, { optional: true });
+                    // Offline authoring has no transport; a configured editor owns its mutable reader.
+                    if (http === null || apiUrl === null)
+                        return null;
+                    return new GenericCrudService(http, inject(SchemaNormalizerService), inject(GlobalConfigService), apiUrl);
+                },
+            },
+        ], ngImport: i0, template: `
     <section class="editor-shell" data-testid="crud-metadata-editor">
       <header class="editor-header">
         <div>
@@ -7998,7 +8056,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         PraxisIconDirective,
                         PraxisKpiBandComponent,
                         PraxisTableInlineAuthoringEditorComponent,
-                    ], providers: [providePraxisI18nConfig(PRAXIS_CRUD_AUTHORING_I18N_CONFIG)], template: `
+                    ], providers: [
+                        providePraxisI18nConfig(PRAXIS_CRUD_AUTHORING_I18N_CONFIG),
+                        {
+                            provide: GenericCrudService,
+                            useFactory: () => {
+                                const http = inject(HttpClient, { optional: true });
+                                const apiUrl = inject(API_URL, { optional: true });
+                                // Offline authoring has no transport; a configured editor owns its mutable reader.
+                                if (http === null || apiUrl === null)
+                                    return null;
+                                return new GenericCrudService(http, inject(SchemaNormalizerService), inject(GlobalConfigService), apiUrl);
+                            },
+                        },
+                    ], template: `
     <section class="editor-shell" data-testid="crud-metadata-editor">
       <header class="editor-header">
         <div>

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "10.0.0-rc.20",
+  "version": "10.0.0-rc.21",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/dynamic-form": "^10.0.0-rc.20",
-    "@praxisui/table": "^10.0.0-rc.20",
-    "@praxisui/core": "^10.0.0-rc.20",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.20",
-    "@praxisui/settings-panel": "^10.0.0-rc.20",
+    "@praxisui/dynamic-form": "^10.0.0-rc.21",
+    "@praxisui/table": "^10.0.0-rc.21",
+    "@praxisui/core": "^10.0.0-rc.21",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.21",
+    "@praxisui/settings-panel": "^10.0.0-rc.21",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.20",
+    "@praxisui/ai": "^10.0.0-rc.21",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud.d.ts

@@ -800,9 +800,13 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     private lastExternalSignature;
     private lastLoadedResourceSignature;
     private schemaSub?;
+    private schemaScopeSignature;
+    private schemaGeneration;
+    private destroyed;
     readonly effectiveCrudId: _angular_core.Signal<string | null>;
     readonly isReadonly: _angular_core.Signal<boolean>;
     readonly providedEffectiveTableConfig: _angular_core.Signal<_praxisui_core.TableConfigModern | null>;
+    private readonly providedSnapshotOwner;
     readonly diagnostics: _angular_core.Signal<_praxisui_crud.CrudEditorDiagnostic[]>;
     readonly errorCount: _angular_core.Signal<number>;
     readonly warningCount: _angular_core.Signal<number>;
@@ -994,6 +998,9 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     private clearKpiFilterJsonDraft;
     private updateFilterBar;
     private patchQuickFilter;
+    private resourceSchemaIdentity;
+    private synchronizeSchemaScope;
+    private invalidateSchemaScope;
     private loadResourceSchemaColumns;
     private patchAction;
     private updateMetadata;