@praxisui/core 9.0.64 → 9.0.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.64",
+  "version": "9.0.66",
   "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

@@ -7,6 +7,7 @@ import * as _praxisui_core from '@praxisui/core';
 import { ValidationErrors, ValidatorFn, AsyncValidatorFn, FormGroup, AbstractControl, FormControl } from '@angular/forms';
 import { ThemePalette, DateAdapter } from '@angular/material/core';
 import { ActivatedRoute } from '@angular/router';
+import { ConnectedPosition } from '@angular/cdk/overlay';
 import { MatDialogRef } from '@angular/material/dialog';
 
 declare class PraxisCore {
@@ -14496,6 +14497,9 @@ interface WidgetPageLayout {
     };
 }
 interface WidgetPageCanvasConstraints {
+    /** Outer widget height limits in content-row canvases; minimum defaults to 160px. */
+    minHeightPx?: number;
+    maxHeightPx?: number;
     minColSpan?: number;
     minRowSpan?: number;
     maxColSpan?: number;
@@ -14508,6 +14512,14 @@ interface WidgetPageCanvasItem {
     row: number;
     colSpan: number;
     rowSpan: number;
+    /** Independent outer size in autoRows:'content'. Omission inherits; 'auto'
+     * explicitly restores natural height in a device override. Top inset preserves
+     * the opposite edge during north resize. Fixed-row canvases retain grid sizing.
+     */
+    contentSize?: 'auto' | {
+        heightPx: number;
+        offsetTopPx?: number;
+    };
     zIndex?: number;
     constraints?: WidgetPageCanvasConstraints;
 }
@@ -14526,6 +14538,7 @@ interface WidgetPageCanvasItemOverride {
     row?: number;
     colSpan?: number;
     rowSpan?: number;
+    contentSize?: WidgetPageCanvasItem['contentSize'];
     hidden?: boolean;
     zIndex?: number;
     constraints?: WidgetPageCanvasConstraints;
@@ -16260,6 +16273,18 @@ type Appearance = WidgetShellConfig['appearance'];
 declare const BUILTIN_SHELL_PRESETS: Record<string, NonNullable<Appearance>>;
 declare class WidgetShellComponent implements OnChanges {
     private readonly i18n;
+    private readonly changeDetector;
+    private readonly destroyRef;
+    private readonly element;
+    protected readonly scrollRecovery: i0.WritableSignal<boolean>;
+    private scrollResizeObserver?;
+    private scrollMutationObserver?;
+    private scrollObservedElements;
+    private scrollObservedBody?;
+    private scrollFrame?;
+    constructor();
+    private disconnectScrollGeometry;
+    private observeScrollGeometry;
     get hostCollapsed(): boolean;
     get dragSurfaceInteractive(): boolean;
     shell?: WidgetShellConfig | null;
@@ -16276,6 +16301,7 @@ declare class WidgetShellComponent implements OnChanges {
     collapsed: boolean;
     expanded: boolean;
     fullscreen: boolean;
+    private overlayReturnFocus;
     private initializedWindowState;
     private lastWindowStateInputs?;
     ngOnChanges(changes: SimpleChanges): void;
@@ -16293,8 +16319,12 @@ declare class WidgetShellComponent implements OnChanges {
     private get mergedActions();
     onHeaderPointerDown(event: PointerEvent): void;
     onHeaderKeydown(event: KeyboardEvent): void;
+    onAuthoringDragPointerDown(event: PointerEvent): void;
+    onAuthoringDragKeydown(event: KeyboardEvent): void;
     stopIfExpanded(ev: MouseEvent): void;
     closeOverlay(): void;
+    onOverlayEscape(event: Event): void;
+    private restoreOverlayFocus;
     moreActionsLabel(): string;
     private handleWindowAction;
     private buildWindowActions;
@@ -16776,7 +16806,7 @@ interface RenderedWidgetGroup {
 type CanvasResizeHandle = 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 interface CanvasResizeHandleDefinition {
     id: CanvasResizeHandle;
-    className: string;
+    icon: string;
 }
 declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     pageCanvasHost?: ElementRef<HTMLElement>;
@@ -16820,6 +16850,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     gridAutoRows: string;
     layoutAnnouncement: string;
     readonly canvasResizeHandles: readonly CanvasResizeHandleDefinition[];
+    readonly contextualResizeHandles: CanvasResizeHandleDefinition[];
     private pageDefinition?;
     /**
      * Last canonical definition accepted from the host or published by the
@@ -16839,9 +16870,17 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private activeTabs;
     private widgetDiagnostics;
     private readonly selectedWidgetKeyState;
+    readonly selectedCanvasWidget: i0.Signal<WidgetInstance | undefined>;
     private blockedCanvasWidgetKey;
     private canvasPreviewState;
     private canvasPreviewInvalidState;
+    private resizeFeedbackState;
+    readonly resizeFeedbackOrigin: i0.WritableSignal<{
+        x: number;
+        y: number;
+    } | null>;
+    readonly resizeFeedbackPositions: ConnectedPosition[];
+    prepareResizeFeedbackOverlay(element: HTMLElement): void;
     private transientCanvasItemsState;
     private activeCanvasInteraction;
     private appliedPersisted;
@@ -16871,6 +16910,12 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private runtimeObservationRegistration;
     private readonly hostElement;
     private readonly changeDetector;
+    private static resizePopoverSequence;
+    readonly resizePopoverId: string;
+    readonly resizePopoverOrigin: i0.WritableSignal<HTMLElement | null>;
+    private resizePopoverReturnFocus;
+    private readonly projectedResizeActions;
+    readonly resizePopoverPositions: ConnectedPosition[];
     private hostResizeObserver?;
     private containerWidth?;
     private readonly widgetLoaders?;
@@ -16972,6 +17017,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     widgetContextTooltip(widget: WidgetInstance): string;
     shouldRenderWidgetContextOverlay(widget: WidgetInstance): boolean;
     widgetShellForRender(widget: WidgetInstance): WidgetShellConfig | null | undefined;
+    private widgetShellWithActions;
     private resolveWidgetDisplayName;
     private shouldProjectWidgetHeaderActions;
     private hasWidgetContextAuthoringActions;
@@ -17015,6 +17061,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private endpointReferencesWidget;
     openPageSettings(): void;
     private canInvokePageSettings;
+    private validateRenderedCanvas;
     private applyWidgetShell;
     private constrainWidgetShellResult;
     private restoreWidgetShellFields;
@@ -17032,6 +17079,8 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     onCanvasPointerMove(event: PointerEvent): void;
     onCanvasPointerUp(event: PointerEvent): void;
     onCanvasPointerCancel(event: PointerEvent): void;
+    onCanvasEscape(event: Event): void;
+    private cancelCanvasGesture;
     private resolveColumns;
     private ensurePageDefinition;
     private parsePage;
@@ -17056,6 +17105,20 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     selectWidgetFromHostEvent(widgetKey: string, event: Event): void;
     isCanvasWidgetSelected(widgetKey: string): boolean;
     isWidgetSelected(widgetKey: string): boolean;
+    canvasInteractionActive(): boolean;
+    canShowCanvasEdges(widgetKey: string): boolean;
+    contextualResizeHandle(): CanvasResizeHandle | null;
+    selectCanvasResizeTarget(event: Event): void;
+    toggleResizePopover(widgetKey: string): void;
+    focusResizePopover(overlay: HTMLElement): void;
+    closeResizePopover(restoreFocus: boolean): void;
+    onResizePopoverOutsideClick(event: MouseEvent): void;
+    onResizePopoverKeydown(event: KeyboardEvent): void;
+    resizeCloseLabel(): string;
+    resizeContextHelpLabel(): string;
+    resizePopoverGridArea(handle: CanvasResizeHandle): string;
+    onSelectedCanvasResizePointerDown(handle: CanvasResizeHandle, event: PointerEvent): void;
+    onSelectedCanvasResizeKeydown(handle: CanvasResizeHandle, event: KeyboardEvent): void;
     selectCanvasWidget(widgetKey: string): void;
     getPageSnapshot(): WidgetPageDefinition;
     isCanvasWidgetBlocked(widgetKey: string): boolean;
@@ -17072,11 +17135,17 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private startCanvasInteraction;
     private cancelCanvasInteractionForWidget;
     private isCanvasOverlayInteraction;
+    private isCanvasWidgetInOverlay;
     private currentCanvasMetrics;
+    private measureCanvasContentHeight;
+    private measureCanvasMinimumHeight;
     private currentCanvasItem;
     private resolveCanvasInteractionDelta;
     private updateCanvasItem;
-    private applyTransientPagePreview;
+    resizeFeedback(key: string): 'valid' | 'minimum' | 'blocked' | null;
+    hasResizeFeedback(): boolean;
+    resizeFeedbackLabel(state: 'valid' | 'minimum' | 'blocked'): string;
+    private updateCanvasResize;
     private resolveCanvasTarget;
     private applyCanvasDrag;
     private applyCanvasResize;
@@ -17085,6 +17154,9 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     pageSettingsLabel(): string;
     dragWidgetLabel(): string;
     resizeWidgetLabel(): string;
+    resizeAlternativeLabel(): string;
+    resizeSelectLabel(): string;
+    resizeHelpLabel(): string;
     resizeHandleLabel(handle: CanvasResizeHandle): string;
     private canvasAnnouncement;
     private blockedCanvasAnnouncement;
@@ -17117,6 +17189,10 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     groupGridColumn(group: RenderedWidgetGroup): string | null;
     widgetGridColumn(widget: RenderedWidgetInstance): string | null;
     widgetGridRow(widget: RenderedWidgetInstance): string | null;
+    widgetContentSize(widget: WidgetInstance): {
+        heightPx: number;
+        offsetTopPx: number;
+    } | null;
     widgetZIndex(widget: RenderedWidgetInstance): number | null;
     widgetClassName(widget: WidgetInstance): string;
     private mergeClassNames;