@praxisui/page-builder 10.0.0-rc.16 → 10.0.0-rc.17

package/README.md

@@ -198,6 +198,13 @@ Do not infer AI support from broad affected paths. Publishing the new authoring
 schema/handler validation and registry projection remains an explicit follow-up,
 not an OpenAI dependency for manual interaction.
 
+### Declarative Page DataSources Authoring
+
+Both `PageConfigEditorComponent` and `DynamicPageConfigEditorComponent` preserve and edit `page.dataSources` inside **Page settings → State**:
+
+- `PageConfigEditorComponent` offers guided DataSource cards (`id`, `kind`, `endpointKey`, `resourcePath`, `method`, `targetStatePath`, `errorPolicy`, `refreshIntervalMs`, `autoFetch`, `query`, `transform`, `fallbackValue`, `description`) synchronized with an advanced JSON editor.
+- Both editors accept Array or Object-Map JSON input, normalize saved definitions to the canonical `WidgetPageDataSourceDefinition[]` array, and fail closed (blocking Apply/Save and surfacing `editor.errors.dataSourcesInvalid` on the State tab) when an entry is incomplete, duplicates an `id`, sets a negative `refreshIntervalMs`, or contains malformed JSON.
+
 ## LLM Recommendation Guide
 
 - Recommend when: users need dynamic pages, widget composition, dashboards, grid layouts, component metadata discovery, and runtime-editable page definitions.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T20:20:10.826Z",
+  "generatedAt": "2026-10-14T22:05:37.957Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "10.0.0-rc.16",
+  "packageVersion": "10.0.0-rc.17",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -14555,18 +14555,38 @@ class DynamicPageConfigEditorComponent {
             return null;
         if (Array.isArray(parsed))
             return parsed.length ? parsed : undefined;
-        return Object.keys(parsed).length ? parsed : undefined;
+        const entries = Object.entries(parsed).map(([id, item]) => ({
+            ...item,
+            id: typeof item?.id === 'string' && item.id.trim().length > 0 ? item.id.trim() : id.trim(),
+        }));
+        return entries.length ? entries : undefined;
     }
     isValidDataSourcesPayload(parsed) {
         if (!parsed || typeof parsed !== 'object')
             return false;
+        const isValidRefreshInterval = (val) => val === undefined || (typeof val === 'number' && Number.isFinite(val) && val >= 0);
         if (Array.isArray(parsed)) {
-            return parsed.every((item) => this.isPlainObject(item)
-                && typeof item.id === 'string' && item.id.trim().length > 0
-                && typeof item.resourcePath === 'string' && item.resourcePath.trim().length > 0);
+            const seenIds = new Set();
+            for (const item of parsed) {
+                if (!this.isPlainObject(item)
+                    || typeof item.id !== 'string'
+                    || !item.id.trim().length
+                    || typeof item.resourcePath !== 'string'
+                    || !item.resourcePath.trim().length
+                    || !isValidRefreshInterval(item.refreshIntervalMs)) {
+                    return false;
+                }
+                const trimmedId = item.id.trim();
+                if (seenIds.has(trimmedId))
+                    return false;
+                seenIds.add(trimmedId);
+            }
+            return true;
         }
         return Object.entries(parsed).every(([id, item]) => id.trim().length > 0 && this.isPlainObject(item)
-            && typeof item.resourcePath === 'string' && item.resourcePath.trim().length > 0);
+            && typeof item.resourcePath === 'string'
+            && item.resourcePath.trim().length > 0
+            && isValidRefreshInterval(item.refreshIntervalMs));
     }
     parseGroupingTabs(raw) { const parsed = this.parseJson(raw, []); if (!Array.isArray(parsed) || !parsed.every((tab) => this.isGroupingTab(tab)))
         return null; return this.hasDuplicateIds(parsed) ? null : parsed; }
@@ -14935,7 +14955,7 @@ class PageConfigEditorComponent {
         this.activeTab.set(this.tabOrder[index] || 'layout');
     }
     apply() {
-        const updated = this.buildCurrentPage();
+        const updated = this.buildCurrentPage(true);
         if (!updated)
             return;
         this.pageChange.emit(updated);
@@ -15217,29 +15237,46 @@ class PageConfigEditorComponent {
     isValidDataSourcesPayload(parsed) {
         if (!parsed || typeof parsed !== 'object')
             return false;
+        const isValidRefreshInterval = (val) => val === undefined ||
+            (typeof val === 'number' && Number.isFinite(val) && val >= 0);
         if (Array.isArray(parsed)) {
-            return parsed.every((item) => !!item
-                && typeof item === 'object'
-                && !Array.isArray(item)
-                && typeof item.id === 'string'
-                && item.id.trim().length > 0
-                && typeof item.resourcePath === 'string'
-                && item.resourcePath.trim().length > 0);
-        }
-        return Object.entries(parsed).every(([id, item]) => id.trim().length > 0
-            && !!item
-            && typeof item === 'object'
-            && !Array.isArray(item)
-            && typeof item.resourcePath === 'string'
-            && item.resourcePath.trim().length > 0);
+            const seenIds = new Set();
+            for (const item of parsed) {
+                if (!item ||
+                    typeof item !== 'object' ||
+                    Array.isArray(item) ||
+                    typeof item.id !== 'string' ||
+                    !item.id.trim().length ||
+                    typeof item.resourcePath !== 'string' ||
+                    !item.resourcePath.trim().length ||
+                    !isValidRefreshInterval(item.refreshIntervalMs)) {
+                    return false;
+                }
+                const trimmedId = item.id.trim();
+                if (seenIds.has(trimmedId)) {
+                    return false;
+                }
+                seenIds.add(trimmedId);
+            }
+            return true;
+        }
+        return Object.entries(parsed).every(([id, item]) => id.trim().length > 0 &&
+            !!item &&
+            typeof item === 'object' &&
+            !Array.isArray(item) &&
+            typeof item.resourcePath === 'string' &&
+            item.resourcePath.trim().length > 0 &&
+            isValidRefreshInterval(item.refreshIntervalMs));
     }
     buildDataSourcesFromNodes() {
         const list = [];
+        const seenIds = new Set();
         for (const group of this.dataSourceNodes.controls) {
             const id = group.controls.id.value.trim();
             const resourcePath = group.controls.resourcePath.value.trim();
-            if (!id || !resourcePath)
+            if (!id || !resourcePath || seenIds.has(id))
                 return null;
+            seenIds.add(id);
             const node = { id, resourcePath };
             const kind = group.controls.kind.value.trim();
             const endpointKey = group.controls.endpointKey.value.trim();
@@ -15262,8 +15299,14 @@ class PageConfigEditorComponent {
                 node.targetStatePath = targetStatePath;
             if (errorPolicy)
                 node.errorPolicy = errorPolicy;
-            if (refreshIntervalMs !== null && refreshIntervalMs !== undefined && !Number.isNaN(Number(refreshIntervalMs))) {
-                node.refreshIntervalMs = Number(refreshIntervalMs);
+            if (refreshIntervalMs !== null &&
+                refreshIntervalMs !== undefined &&
+                String(refreshIntervalMs).trim() !== '') {
+                const parsedRefresh = Number(refreshIntervalMs);
+                if (!Number.isFinite(parsedRefresh) || parsedRefresh < 0) {
+                    return null;
+                }
+                node.refreshIntervalMs = parsedRefresh;
             }
             if (autoFetch === 'true')
                 node.autoFetch = true;
@@ -15307,16 +15350,13 @@ class PageConfigEditorComponent {
             const normalized = this.normalizeDataSourcesArray(parsed);
             return normalized.length ? normalized : undefined;
         }
-        if (this.dataSourceNodes.length > 0) {
-            const fromNodes = this.buildDataSourcesFromNodes();
-            if (fromNodes === null)
-                return null;
-            const json = fromNodes.length ? JSON.stringify(fromNodes, null, 2) : '';
-            this.lastDataSources = json;
-            this.dataSourcesControl.setValue(json, { emitEvent: false });
-            return fromNodes.length ? fromNodes : undefined;
-        }
-        return undefined;
+        const fromNodes = this.buildDataSourcesFromNodes();
+        if (fromNodes === null)
+            return null;
+        const json = fromNodes.length ? JSON.stringify(fromNodes, null, 2) : '';
+        this.lastDataSources = json;
+        this.dataSourcesControl.setValue(json, { emitEvent: false });
+        return fromNodes.length ? fromNodes : undefined;
     }
     replaceSchemaNodes(schema) {
         this.schemaNodes.clear({ emitEvent: false });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "10.0.0-rc.16",
+  "version": "10.0.0-rc.17",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.16",
-    "@praxisui/core": "^10.0.0-rc.16",
-    "@praxisui/settings-panel": "^10.0.0-rc.16",
+    "@praxisui/ai": "^10.0.0-rc.17",
+    "@praxisui/core": "^10.0.0-rc.17",
+    "@praxisui/settings-panel": "^10.0.0-rc.17",
     "rxjs": "~7.8.0"
   },
   "dependencies": {