@praxisui/page-builder 9.0.58 → 9.0.60

package/README.md

@@ -324,6 +324,16 @@ Every official local apply of a `UiCompositionPlan` now runs a fail-closed prefl
 
 `preflightUiCompositionPlan(plan, targetRegistry)` is exported by `@praxisui/page-builder` for official Dynamic Page hosts that compile plans outside `DynamicPageBuilderComponent`. Those hosts must inject their runtime `ComponentMetadataRegistry`; omitting it fails closed with `UI_COMPOSITION_TARGET_REGISTRY_REQUIRED`.
 
+Resource-backed compositions must then run the exported asynchronous
+`preflightUiCompositionPlanResources(...)`, or inject
+`UiCompositionResourcePreflightService` in an Angular host. Component owners declare
+the finite filter field source on the output port and map each `query-context` input
+to its resource operation through `runtimeProfiles`. The service resolves canonical
+request schemas from `/schemas/filtered`, verifies the concrete operation path and
+proves that every declared source field is accepted by both the source filter and
+every connected consumer request. Missing evidence, undeclared operations, path
+divergence and incompatible fields block the Dynamic Page before mount or persistence.
+
 Workspace contributors can exercise this path in the reference host at
 `/dynamic-page-lab`. Its **Certificação do UiCompositionPlan** station displays
 the compact plan, registry-aware preflight, compiled `WidgetPageDefinition`, real
@@ -337,15 +347,17 @@ kind, unguarded feedback, incomplete master-detail layout and a stale governed
 template hash. The browser proof for the related-resource scenario requires a real
 parent selection, the relationship filter and visible child columns/data derived
 from the remote schema; request success alone is insufficient. The same route's
-People Operations dashboard is authored as a 9-widget/10-binding plan and proves
+People Operations dashboard is authored as a 9-widget/11-binding plan and proves
 filter and governed decision propagation through the compiled graph. The lab also
 executes deterministic runtime reset, verifies JSON persistence invariants for
 every applicable scenario, and invokes the real Page Builder save output before
 reopening the rich People Operations page. Corrupted executable transforms and
 legacy `page.connections` remain Core/page-ingress adversarials because neither is
 a valid `UiCompositionPlan` input; the lab does not duplicate those boundary
-validators. The governed Config Starter + Quickstart gate remains tracked in
-issue #430; issue #431 closed the former global-action source limitation.
+validators. The lab now proves the governed Config Starter + Quickstart
+save/reload/delete transaction with strong ETag semantics; issue #430 still tracks
+approval/publication and the remaining archetype-quality gates. Issue #431 closed
+the former global-action source limitation.
 
 For multi-consumer interaction state, author one `event -> state` binding and
 project `state -> component-port` to each consumer. A direct event delivery is

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-03T03:04:37.933Z",
+  "generatedAt": "2026-09-04T15:26:31.194Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.58",
+  "packageVersion": "9.0.60",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -7,7 +7,7 @@ import { MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 import * as i2$1 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
 import * as i2$2 from '@praxisui/core';
-import { PraxisIconDirective, providePraxisI18n, BUILTIN_SHELL_PRESETS, PraxisIconButtonComponent, PraxisI18nService, GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, PRAXIS_GLOBAL_ACTION_CATALOG, SurfaceOpenActionEditorComponent, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, NestedWidgetConfigAccessor, CompositionValidatorService, deepMerge, generateId, ComponentMetadataRegistry, ObservabilityDashboardService, PraxisRuntimeComponentObservationRegistryService, domainKnowledgeTimelineToRichContentDocument, DomainRuleService, DomainKnowledgeService, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR } from '@praxisui/core';
+import { PraxisIconDirective, providePraxisI18n, BUILTIN_SHELL_PRESETS, PraxisIconButtonComponent, PraxisI18nService, GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, PRAXIS_GLOBAL_ACTION_CATALOG, SurfaceOpenActionEditorComponent, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, NestedWidgetConfigAccessor, CompositionValidatorService, ComponentMetadataRegistry, ResourceDiscoveryService, ComponentRuntimeProfileService, buildApiUrl, deepMerge, generateId, ObservabilityDashboardService, PraxisRuntimeComponentObservationRegistryService, domainKnowledgeTimelineToRichContentDocument, DomainRuleService, DomainKnowledgeService, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR } from '@praxisui/core';
 import * as i3 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import * as i3$1 from '@angular/material/form-field';
@@ -24,7 +24,7 @@ import * as i6 from '@angular/material/divider';
 import { MatDividerModule } from '@angular/material/divider';
 import * as i6$1 from '@angular/material/select';
 import { MatSelectModule } from '@angular/material/select';
-import { BehaviorSubject, merge, timeout, map, catchError, throwError, from, firstValueFrom, share, concatMap, of, timer, takeUntil, Subject, tap, filter, take } from 'rxjs';
+import { BehaviorSubject, merge, timeout, map, catchError, throwError, firstValueFrom, from, share, concatMap, of, timer, takeUntil, Subject, tap, filter, take } from 'rxjs';
 import { SETTINGS_PANEL_DATA } from '@praxisui/settings-panel';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { CdkTrapFocus } from '@angular/cdk/a11y';
@@ -15977,6 +15977,347 @@ function createAuthoringDiagnostic(id, code, message, path, blocking, stage) {
     };
 }
 
+/**
+ * Async, fail-closed resource conformance layered after the synchronous
+ * compiler/registry preflight. It fetches schema evidence but never persists it
+ * into the page definition.
+ */
+async function preflightUiCompositionPlanResources(plan, registry, resolveSchema) {
+    const structural = preflightUiCompositionPlan(plan, registry);
+    if (!structural.valid)
+        return structural;
+    const diagnostics = await attestResourceQueries(structural.page.widgets, structural.page.composition?.links ?? [], registry, resolveSchema);
+    const allDiagnostics = [...structural.diagnostics, ...diagnostics];
+    const blocking = allDiagnostics.some(isBlockingDiagnostic);
+    return blocking
+        ? { valid: false, page: null, diagnostics: allDiagnostics }
+        : { valid: true, page: structural.page, diagnostics: allDiagnostics };
+}
+/** Official HTTP-backed resource conformance service for Dynamic Page hosts. */
+class UiCompositionResourcePreflightService {
+    registry = inject(ComponentMetadataRegistry);
+    discovery = inject(ResourceDiscoveryService);
+    preflight(plan, registry = this.registry) {
+        return preflightUiCompositionPlanResources(plan, registry, (request) => this.resolveSchema(request));
+    }
+    async resolveSchema(request) {
+        const apiUrlEntry = request.apiUrlEntry ?? this.discovery.resolveApiEntry();
+        const expectedOperationPath = resolveOperationPath(request.resourcePath, request.pathSuffix, apiUrlEntry);
+        const operationPath = request.pathInput
+            ? normalizeAbsoluteOrRootPath(request.pathInput)
+            : expectedOperationPath;
+        if (operationPath !== expectedOperationPath) {
+            return { schema: null, operationPath, expectedOperationPath };
+        }
+        const query = new URLSearchParams({
+            path: operationPath,
+            operation: request.method.toLowerCase(),
+            schemaType: 'request',
+            includeInternalSchemas: 'true',
+        });
+        const schema = await firstValueFrom(this.discovery.getSchemaByUrl(`/schemas/filtered?${query.toString()}`, { apiUrlEntry }));
+        return { schema, operationPath, expectedOperationPath };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: UiCompositionResourcePreflightService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: UiCompositionResourcePreflightService, providedIn: 'any' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: UiCompositionResourcePreflightService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'any' }]
+        }] });
+async function attestResourceQueries(widgets, links, registry, resolveSchema) {
+    const diagnostics = [];
+    const widgetsByKey = new Map(widgets.map((widget) => [widget.key, widget]));
+    const profiles = new ComponentRuntimeProfileService();
+    const schemaCache = new Map();
+    for (const link of links) {
+        if (link.to.kind !== 'component-port' || link.to.ref.direction !== 'input')
+            continue;
+        const targetWidget = widgetsByKey.get(link.to.ref.widget);
+        if (!targetWidget)
+            continue;
+        const sources = traceResourceFieldSources(link.from, links, widgetsByKey, registry, new Set());
+        if (!sources.length)
+            continue;
+        const targetMetadata = registry.get(targetWidget.definition.id);
+        if (!targetMetadata)
+            continue;
+        const targetPortId = link.to.ref.port;
+        const targetPort = targetMetadata.ports?.find((port) => port.id === targetPortId && port.direction === 'input');
+        if (targetPort?.semanticKind !== 'query-context')
+            continue;
+        const profileResolution = profiles.resolve(targetMetadata, targetWidget.definition.inputs);
+        if (!profileResolution.match) {
+            diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_QUERY_TARGET_PROFILE_MISMATCH', `Widget "${targetWidget.key}" has no owner-authored runtime profile matching its resource-query inputs.`, link, targetWidget.key, { componentId: targetWidget.definition.id }));
+            continue;
+        }
+        const operations = queryContextOperations(profileResolution.match.profile.effects, link.to.ref.port);
+        if (!operations.length) {
+            diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_QUERY_TARGET_OPERATION_UNDECLARED', `Widget "${targetWidget.key}" does not declare how port "${link.to.ref.port}" reaches a resource request.`, link, targetWidget.key, {
+                componentId: targetWidget.definition.id,
+                runtimeProfileId: profileResolution.match.profile.id,
+                portId: link.to.ref.port,
+            }));
+            continue;
+        }
+        for (const source of sources) {
+            const fields = readDeclaredFields(profiles, source.widget.definition.inputs, source.descriptor.fieldPaths);
+            if (!fields.length) {
+                diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_QUERY_FIELD_SET_UNRESOLVED', `Widget "${source.widget.key}" does not expose a finite declared field set for resource-query conformance.`, link, source.widget.key, { componentId: source.widget.definition.id, portId: source.port.id }));
+                continue;
+            }
+            const sourceRequest = sourceSchemaRequest(source, profiles);
+            if (!sourceRequest) {
+                diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_QUERY_SOURCE_PATH_UNRESOLVED', `Widget "${source.widget.key}" does not resolve the resource path declared by port "${source.port.id}".`, link, source.widget.key, { componentId: source.widget.definition.id, portId: source.port.id }));
+                continue;
+            }
+            await validateFieldsAgainstSchema(fields, sourceRequest, 'SOURCE', link, diagnostics, resolveSchema, schemaCache);
+            for (const { effect, operation } of operations) {
+                const targetRequest = targetSchemaRequest(targetWidget, effect, operation, profiles);
+                if (!targetRequest) {
+                    diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_QUERY_TARGET_PATH_UNRESOLVED', `Widget "${targetWidget.key}" does not resolve the resource operation declared for "${operation.operationId}".`, link, targetWidget.key, { componentId: targetWidget.definition.id, operationId: operation.operationId }));
+                    continue;
+                }
+                await validateFieldsAgainstSchema(fields, targetRequest, 'TARGET', link, diagnostics, resolveSchema, schemaCache);
+            }
+        }
+    }
+    return diagnostics;
+}
+function traceResourceFieldSources(endpoint, links, widgetsByKey, registry, visited) {
+    if (endpoint.kind === 'component-port' && endpoint.ref.direction === 'output') {
+        const widget = widgetsByKey.get(endpoint.ref.widget);
+        const metadata = widget ? registry.get(widget.definition.id) : undefined;
+        const port = metadata?.ports?.find((candidate) => candidate.id === endpoint.ref.port && candidate.direction === 'output');
+        return widget && metadata && port?.resourceQueryFieldSource
+            ? [{ widget, metadata, port, descriptor: port.resourceQueryFieldSource }]
+            : [];
+    }
+    if (endpoint.kind !== 'state')
+        return [];
+    const stateKey = `${endpoint.ref.layer ?? 'values'}:${endpoint.ref.path}`;
+    if (visited.has(stateKey))
+        return [];
+    const nextVisited = new Set(visited).add(stateKey);
+    return links
+        .filter((candidate) => candidate.to.kind === 'state'
+        && candidate.to.ref.path === endpoint.ref.path
+        && (candidate.to.ref.layer ?? 'values') === (endpoint.ref.layer ?? 'values'))
+        .flatMap((candidate) => traceResourceFieldSources(candidate.from, links, widgetsByKey, registry, nextVisited));
+}
+function queryContextOperations(effects, portId) {
+    return effects.flatMap((effect) => effect.kind === 'resource-read'
+        ? effect.operations
+            .filter((operation) => operation.queryContext?.portId === portId)
+            .map((operation) => ({ effect, operation }))
+        : []);
+}
+function sourceSchemaRequest(source, profiles) {
+    const inputs = source.widget.definition.inputs ?? {};
+    const resourcePath = readSingleString(profiles, inputs, source.descriptor.resourcePath);
+    if (!resourcePath)
+        return null;
+    return {
+        widgetKey: source.widget.key,
+        componentId: source.widget.definition.id,
+        operationId: source.descriptor.schemaOperation.operationId,
+        method: source.descriptor.schemaOperation.method,
+        resourcePath,
+        pathSuffix: source.descriptor.schemaOperation.pathSuffix,
+        requestFieldPath: source.descriptor.schemaOperation.requestFieldPath ?? '$',
+        apiUrlEntry: readApiUrlEntry(profiles, inputs, source.descriptor.apiUrlEntry),
+    };
+}
+function targetSchemaRequest(widget, effect, operation, profiles) {
+    const inputs = widget.definition.inputs ?? {};
+    const resourcePath = readSingleString(profiles, inputs, effect.resourcePath);
+    if (!resourcePath)
+        return null;
+    const pathInput = operation.pathInput
+        ? readSingleString(profiles, inputs, operation.pathInput)
+        : undefined;
+    if (operation.pathInput && !pathInput)
+        return null;
+    return {
+        widgetKey: widget.key,
+        componentId: widget.definition.id,
+        operationId: operation.operationId,
+        method: operation.method,
+        resourcePath,
+        pathSuffix: operation.pathSuffix,
+        pathInput,
+        requestFieldPath: operation.queryContext?.requestFieldPath ?? '$',
+        apiUrlEntry: readApiUrlEntry(profiles, inputs, effect.apiUrlEntry),
+    };
+}
+async function validateFieldsAgainstSchema(fields, request, side, link, diagnostics, resolveSchema, cache) {
+    const cacheKey = JSON.stringify(request);
+    let resolution;
+    try {
+        let pending = cache.get(cacheKey);
+        if (!pending) {
+            pending = resolveSchema(request);
+            cache.set(cacheKey, pending);
+        }
+        resolution = await pending;
+    }
+    catch (error) {
+        diagnostics.push(resourceDiagnostic(`UI_COMPOSITION_RESOURCE_QUERY_${side}_SCHEMA_UNAVAILABLE`, `Request schema for "${request.operationId}" could not be resolved.`, link, request.widgetKey, {
+            componentId: request.componentId,
+            operationId: request.operationId,
+            error: error instanceof Error ? error.message : String(error),
+        }));
+        return;
+    }
+    if (resolution.operationPath !== resolution.expectedOperationPath) {
+        diagnostics.push(resourceDiagnostic('UI_COMPOSITION_RESOURCE_OPERATION_PATH_MISMATCH', `Operation path "${resolution.operationPath}" escapes the owner-declared resource path "${resolution.expectedOperationPath}".`, link, request.widgetKey, {
+            componentId: request.componentId,
+            operationId: request.operationId,
+            operationPath: resolution.operationPath,
+            expectedOperationPath: resolution.expectedOperationPath,
+        }));
+        return;
+    }
+    const allowedFields = schemaPropertiesAtPath(resolution.schema, request.requestFieldPath);
+    if (!allowedFields) {
+        diagnostics.push(resourceDiagnostic(`UI_COMPOSITION_RESOURCE_QUERY_${side}_FIELD_CONTAINER_UNRESOLVED`, `Request schema "${request.operationId}" does not expose properties at "${request.requestFieldPath}".`, link, request.widgetKey, {
+            componentId: request.componentId,
+            operationId: request.operationId,
+            requestFieldPath: request.requestFieldPath,
+            operationPath: resolution.operationPath,
+        }));
+        return;
+    }
+    const missingFields = fields.filter((field) => !allowedFields.has(field));
+    if (!missingFields.length)
+        return;
+    diagnostics.push(resourceDiagnostic(`UI_COMPOSITION_RESOURCE_QUERY_FIELD_NOT_IN_${side}_SCHEMA`, `Fields [${missingFields.join(', ')}] are not accepted by "${request.operationId}" at "${request.requestFieldPath}".`, link, request.widgetKey, {
+        componentId: request.componentId,
+        operationId: request.operationId,
+        operationPath: resolution.operationPath,
+        requestFieldPath: request.requestFieldPath,
+        missingFields,
+        allowedFields: [...allowedFields].sort(),
+    }));
+}
+function readDeclaredFields(profiles, inputs, paths) {
+    const fields = paths.flatMap((path) => profiles.readPathValues(inputs ?? {}, path).flatMap(flattenStrings));
+    return [...new Set(fields.map((field) => field.trim()).filter(Boolean))].sort();
+}
+function flattenStrings(value) {
+    if (typeof value === 'string')
+        return [value];
+    return Array.isArray(value) ? value.flatMap(flattenStrings) : [];
+}
+function readSingleString(profiles, inputs, path) {
+    const values = profiles.readPathValues(inputs, path)
+        .filter((value) => typeof value === 'string')
+        .map((value) => value.trim())
+        .filter(Boolean);
+    return values.length === 1 ? values[0] : undefined;
+}
+function readApiUrlEntry(profiles, inputs, path) {
+    if (!path)
+        return undefined;
+    const values = profiles.readPathValues(inputs, path);
+    const value = values.length === 1 ? values[0] : undefined;
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function schemaPropertiesAtPath(schema, path) {
+    const root = asRecord(schema);
+    if (!root)
+        return null;
+    let node = dereference(root, root);
+    const segments = path === '$'
+        ? []
+        : path.split('.').map((segment) => segment.trim()).filter(Boolean);
+    for (const segment of segments) {
+        const properties = mergedProperties(node, root);
+        node = properties ? dereference(asRecord(properties[segment]), root) : null;
+        if (!node)
+            return null;
+    }
+    const properties = mergedProperties(node, root);
+    return properties ? new Set(Object.keys(properties)) : null;
+}
+function mergedProperties(node, root) {
+    if (!node)
+        return null;
+    const direct = asRecord(node['properties']) ?? {};
+    const inherited = Array.isArray(node['allOf'])
+        ? node['allOf'].reduce((acc, candidate) => {
+            const resolved = dereference(asRecord(candidate), root);
+            return { ...acc, ...(resolved ? mergedProperties(resolved, root) ?? {} : {}) };
+        }, {})
+        : {};
+    const merged = { ...inherited, ...direct };
+    return Object.keys(merged).length ? merged : null;
+}
+function dereference(node, root) {
+    const ref = typeof node?.['$ref'] === 'string' ? node['$ref'] : '';
+    if (!ref.startsWith('#/'))
+        return node;
+    const resolved = ref.slice(2).split('/').reduce((value, segment) => {
+        const record = asRecord(value);
+        return record?.[segment.replace(/~1/g, '/').replace(/~0/g, '~')];
+    }, root);
+    return asRecord(resolved);
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function resolveOperationPath(resourcePath, pathSuffix, apiUrlEntry) {
+    const resource = normalizeAbsoluteOrRootPath(resourcePath);
+    const base = normalizeAbsoluteOrRootPath(buildApiUrl(apiUrlEntry));
+    const baseSegments = segments(base);
+    const resourceSegments = segments(resource);
+    const rootRelative = resourcePath.trim().startsWith('/')
+        || /^https?:\/\//i.test(resourcePath.trim());
+    const alreadyPrefixed = baseSegments.length > 0
+        && baseSegments.every((segment, index) => resourceSegments[index] === segment);
+    const combined = rootRelative || alreadyPrefixed
+        ? resourceSegments
+        : [...baseSegments, ...resourceSegments];
+    return `/${[...combined, ...segments(pathSuffix)].join('/')}`;
+}
+function normalizeAbsoluteOrRootPath(value) {
+    const normalized = String(value || '').trim();
+    if (/^https?:\/\//i.test(normalized)) {
+        return new URL(normalized).pathname.replace(/\/+$/, '') || '/';
+    }
+    return `/${segments(normalized).join('/')}`;
+}
+function segments(value) {
+    return String(value || '').split('/').map((item) => item.trim()).filter(Boolean);
+}
+function resourceDiagnostic(code, message, link, widgetKey, details) {
+    return {
+        id: `ui-composition-resource:${link.id}:${widgetKey}:${code}`,
+        code,
+        severity: 'error',
+        phase: 'page-lint',
+        message,
+        summary: message,
+        subject: { kind: 'link', linkId: link.id, widgetKey },
+        details: {
+            provenance: 'ui-composition-resource-preflight',
+            stage: 'resource-schema-conformance',
+            ...details,
+        },
+        source: 'authoring',
+        blocking: true,
+        createdAt: new Date().toISOString(),
+    };
+}
+function isBlockingDiagnostic(diagnostic) {
+    return diagnostic.blocking !== false
+        && (diagnostic.severity === 'error' || diagnostic.severity === 'fatal');
+}
+
 const RUNTIME_AUTHORING_METADATA_INPUTS = [
     'schemaVerification',
     'schemaEvidenceSource',
@@ -26840,4 +27181,4 @@ function providePraxisPageBuilderMetadata() {
  * Generated bundle index. Do not edit.
  */
 
-export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan };
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.58",
+  "version": "9.0.60",
   "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": "^9.0.58",
-    "@praxisui/core": "^9.0.58",
-    "@praxisui/settings-panel": "^9.0.58",
+    "@praxisui/ai": "^9.0.60",
+    "@praxisui/core": "^9.0.60",
+    "@praxisui/settings-panel": "^9.0.60",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -1,7 +1,7 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
-import { ComponentDocMeta, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, DynamicWidgetPageComponent, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
@@ -1813,6 +1813,39 @@ type UiCompositionPlanPreflightResult = {
  */
 declare function preflightUiCompositionPlan(plan: UiCompositionPlan, registry: NestedPortCatalogRegistry | undefined, validator?: CompositionValidatorService): UiCompositionPlanPreflightResult;
 
+interface UiCompositionResourceSchemaRequest {
+    widgetKey: string;
+    componentId: string;
+    operationId: string;
+    method: 'GET' | 'POST';
+    resourcePath: string;
+    pathSuffix: string;
+    pathInput?: string;
+    requestFieldPath: string;
+    apiUrlEntry?: ApiUrlEntry;
+}
+interface UiCompositionResourceSchemaResolution {
+    schema: unknown;
+    operationPath: string;
+    expectedOperationPath: string;
+}
+type UiCompositionResourceSchemaResolver = (request: UiCompositionResourceSchemaRequest) => Promise<UiCompositionResourceSchemaResolution>;
+/**
+ * Async, fail-closed resource conformance layered after the synchronous
+ * compiler/registry preflight. It fetches schema evidence but never persists it
+ * into the page definition.
+ */
+declare function preflightUiCompositionPlanResources(plan: UiCompositionPlan, registry: ComponentMetadataRegistry, resolveSchema: UiCompositionResourceSchemaResolver): Promise<UiCompositionPlanPreflightResult>;
+/** Official HTTP-backed resource conformance service for Dynamic Page hosts. */
+declare class UiCompositionResourcePreflightService {
+    private readonly registry;
+    private readonly discovery;
+    preflight(plan: UiCompositionPlan, registry?: ComponentMetadataRegistry): Promise<UiCompositionPlanPreflightResult>;
+    private resolveSchema;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiCompositionResourcePreflightService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<UiCompositionResourcePreflightService>;
+}
+
 type PageBuilderGovernedContinuationFamily = 'shared-rule' | 'project-knowledge';
 type PageBuilderGovernedContinuationActionKind = 'open_definition' | 'simulate' | 'approve' | 'reject' | 'publish' | 'materialize' | 'validate_enforcement' | 'create_knowledge_change_set' | 'validate_knowledge_change_set' | 'apply_knowledge_change_set' | 'open_timeline';
 type PageBuilderGovernedContinuationBlockedReason = 'busy' | 'missing_handoff' | 'missing_authoring_target' | 'missing_definition' | 'definition_already_available' | 'missing_materialization' | 'missing_project_knowledge_audit' | 'missing_project_knowledge_candidate' | 'change_set_already_available' | 'missing_change_set' | 'validation_required' | 'validation_already_valid' | 'approval_required' | 'already_applied' | 'timeline_unavailable' | 'timeline_contract_unwired';
@@ -2279,5 +2312,5 @@ declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
 /** Provider para auto-registrar metadados do componente Page Builder. */
 declare function providePraxisPageBuilderMetadata(): Provider;
 
-export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan };
-export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, ValueKind };
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan };
+export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };