@praxisui/page-builder 10.0.0-rc.25 → 10.0.0-rc.26

package/package.json

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

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

@@ -344,7 +344,7 @@ interface ConnectionEditorNode {
     states: ConnectionEditorPort[];
 }
 type ConnectionEditorDiagnosticSeverity = 'error' | 'warning';
-type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared' | 'feedback-cycle-unguarded' | 'feedback-cycle-guarded';
+type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared' | 'feedback-cycle-unguarded' | 'feedback-cycle-guarded' | 'competing-query-owner';
 interface ConnectionEditorDiagnostic {
     code: ConnectionEditorDiagnosticCode;
     severity: ConnectionEditorDiagnosticSeverity;
@@ -1094,6 +1094,47 @@ declare class CanvasConstraintEditorModel {
     private resolveFriendlyWidgetTitle;
 }
 
+interface GuidedDataSourceQueryConfig {
+    mode: 'group-by' | 'timeseries' | 'collection';
+    groupByField?: string;
+    metricField?: string;
+    metricOp?: 'count' | 'sum' | 'avg' | 'min' | 'max';
+    period?: 'day' | 'week' | 'month' | 'year';
+    pageSize?: number;
+}
+interface GuidedDataSourceTransformConfig {
+    kind: 'group-by-map' | 'timeseries-last' | 'path';
+    path?: string;
+    mappingsText?: string;
+    totalField?: string;
+    weightedAverageField?: string;
+    weightedAverageDecimals?: number;
+    ratioTargetField?: string;
+    ratioNumeratorField?: string;
+    ratioDenominatorField?: string;
+    ratioScale?: number;
+    ratioDecimals?: number;
+}
+interface GuidedDerivedMeasureConfig {
+    targetPath: string;
+    kind: 'ratio-percent' | 'weighted-average' | 'format-value' | 'template';
+    numeratorPath?: string;
+    denominatorPath?: string;
+    sourcePath?: string;
+    decimals?: number;
+    format?: 'percent' | 'number' | 'currency';
+    templateExpression?: string;
+}
+interface CollectionScreenComposerConfig {
+    resourcePath: string;
+    title: string;
+    groupByField: string;
+    includeHeader: boolean;
+    includeIndicators: boolean;
+    filterMode: 'table-integrated' | 'external-filter-bar';
+    collectionKind: 'table' | 'list';
+    detailSurface: 'none' | 'drawer' | 'modal';
+}
 type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state' | 'limits';
 type DeviceKey = 'desktop' | 'tablet' | 'mobile';
 type GroupingNodeGroup$1 = FormGroup<{
@@ -1274,6 +1315,8 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private readonly injectedData;
     readonly isHostedInSettingsPanel: boolean;
     private readonly i18n;
+    private readonly dataSourceRuntime;
+    private readonly stateRuntime;
     private pageInput;
     private snapshot;
     readonly stackedDevices: Set<DeviceKey>;
@@ -1283,6 +1326,27 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private guidedDataSourcesInvalid;
     private renderedCandidate;
     private renderedValidationFingerprint;
+    private stagedWidgets;
+    private stagedComposition;
+    readonly composerResourcePathControl: FormControl<string>;
+    readonly composerTitleControl: FormControl<string>;
+    readonly composerGroupFieldControl: FormControl<string>;
+    readonly composerIncludeHeaderControl: FormControl<boolean>;
+    readonly composerIncludeIndicatorsControl: FormControl<boolean>;
+    readonly composerFilterModeControl: FormControl<"table-integrated" | "external-filter-bar">;
+    readonly composerCollectionKindControl: FormControl<"table" | "list">;
+    readonly composerDetailSurfaceControl: FormControl<"none" | "modal" | "drawer">;
+    readonly composerMessage: WritableSignal<string>;
+    readonly binderTokenControl: FormControl<string>;
+    readonly binderWidgetControl: FormControl<string>;
+    readonly binderInputPathControl: FormControl<string>;
+    readonly binderMessage: WritableSignal<string>;
+    readonly derivedPathControl: FormControl<string>;
+    readonly derivedKindControl: FormControl<"template" | "format-value" | "ratio-percent" | "weighted-average">;
+    readonly derivedNumeratorControl: FormControl<string>;
+    readonly derivedDenominatorControl: FormControl<string>;
+    readonly derivedFormatControl: FormControl<"number" | "boolean" | "integer" | "percent" | "currency">;
+    readonly derivedDecimalsControl: FormControl<number>;
     private readonly tabOrder;
     constructor();
     ngOnInit(): void;
@@ -1327,6 +1391,58 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     addDataSourceNode(seed?: Partial<WidgetPageDataSourceDefinition>): void;
     removeDataSourceNode(index: number): void;
     dataSourceLabel(index: number): string;
+    applyGuidedDataSourceQuery(index: number, config: GuidedDataSourceQueryConfig): void;
+    applyGuidedDataSourceTransform(index: number, config: GuidedDataSourceTransformConfig): void;
+    getDataSourcePreview(index: number): {
+        status: 'ok' | 'error';
+        sourceKind: 'live' | 'sample';
+        value?: unknown;
+        formattedJson?: string;
+        error?: string;
+        tokens: string[];
+    };
+    addGuidedDerivedMeasure(config?: Partial<GuidedDerivedMeasureConfig>): boolean;
+    getDerivedStatePreview(): {
+        entries: Array<{
+            key: string;
+            value: unknown;
+            formattedValue: string;
+            token: string;
+        }>;
+        diagnostics: string[];
+    };
+    availableStateBindingTokens(): string[];
+    bindablePageWidgets(): Array<{
+        key: string;
+        title: string;
+        componentId: string;
+    }>;
+    bindStateTokenToWidget(widgetKey?: string, inputPath?: string, stateToken?: string): boolean;
+    currentWidgetStateBindings(): Array<{
+        widgetKey: string;
+        widgetTitle: string;
+        inputPath: string;
+        token: string;
+    }>;
+    composeCollectionScreen(overrides?: Partial<CollectionScreenComposerConfig>): WidgetPageDefinition | null;
+    quickCanvasWidgets(): Array<{
+        key: string;
+        label: string;
+        col: number;
+        row: number;
+        colSpan: number;
+        rowSpan: number;
+    }>;
+    setWidgetCanvasSpan(widgetKey: string, colSpan: number, rowSpan?: number): void;
+    duplicateFilterOwners(): Array<{
+        tableKey: string;
+        tableTitle: string;
+        externalSourceKeys: string[];
+        linkIds: string[];
+    }>;
+    consolidateFilterOwnership(tableKey: string, mode: 'keep-table-toolbar' | 'keep-external-link'): void;
+    private resolveWidgetTitle;
+    private isFilterLinkTargetingWidget;
     layoutPresetSummary(preset: LayoutPresetEntry): string;
     slotsSummary(preset: LayoutPresetEntry): string;
     requiredSlotsSummary(preset: LayoutPresetEntry): string;
@@ -1351,6 +1467,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private buildDataSourcesFromNodes;
     private syncDataSourcesJsonFromNodes;
     private syncDataSourceNodesFromJson;
+    private inferPageResourcePath;
     private hydrate;
     private replaceGroupingNodes;
     private buildCurrentPage;
@@ -1363,6 +1480,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private invalidate;
     private refreshPanelState;
     get layoutPresetOptions(): WidgetPageDefinition['layoutPresetOptions'];
+    private effectivePageInput;
     private currentPageInput;
     private parsePage;
     private parseJson;
@@ -1389,6 +1507,12 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private applyShellPresetToContext;
     private lookupPresetLabel;
     private defaultCanvas;
+    private parseKeyValuePairs;
+    private buildSamplePayloadForDataSource;
+    private collectStateTokensForValue;
+    private assignNestedValue;
+    private collectWidgetBindingsRecursive;
+    private humanizeResourceTitle;
     private clone;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, { "page": { "alias": "page"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "pagePreset": { "alias": "pagePreset"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
@@ -2833,4 +2957,4 @@ declare function isComponentDocMeta(value: unknown): value is ComponentDocMeta;
 declare function providePraxisPageBuilderWidgets(widgets?: Array<Provider | ComponentDocMeta>): 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, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
-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, UiCompositionAuthoringSourceDiagnostic, UiCompositionAuthoringSourceDiagnosticCode, UiCompositionAuthoringSourceVerification, UiCompositionAuthoringSourceVerificationContext, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanAuthoringSource, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectCase, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CollectionScreenComposerConfig, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, GuidedDataSourceQueryConfig, GuidedDataSourceTransformConfig, GuidedDerivedMeasureConfig, 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, UiCompositionAuthoringSourceDiagnostic, UiCompositionAuthoringSourceDiagnosticCode, UiCompositionAuthoringSourceVerification, UiCompositionAuthoringSourceVerificationContext, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanAuthoringSource, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectCase, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };