@anguless/angulux 22.5.3 → 22.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anguless/angulux",
3
- "version": "22.5.3",
3
+ "version": "22.6.0",
4
4
  "description": "Angular 22 UI component library — a curated community fork of the last MIT release of PrimeNG.",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -219,10 +219,18 @@ declare class Dialog extends BaseComponent<DialogPassThrough> implements OnInit,
219
219
  */
220
220
  minY: number;
221
221
  /**
222
- * When enabled, first focusable element receives focus on show.
222
+ * When enabled, focus moves into the dialog on show: to the `initialFocus` target, else an element
223
+ * marked `autofocus` in the content, else the first focusable element.
223
224
  * @group Props
224
225
  */
225
226
  focusOnShow: boolean;
227
+ /**
228
+ * Names the element that receives focus when the dialog opens: a CSS selector matched inside the
229
+ * dialog. Use it when the first field is not the one to type into, or when a lint rule forbids the
230
+ * `autofocus` attribute. Applies with `focusOnShow`.
231
+ * @group Props
232
+ */
233
+ initialFocus: string | undefined;
226
234
  /**
227
235
  * Whether the dialog can be displayed full screen.
228
236
  * @group Props
@@ -477,6 +485,12 @@ declare class Dialog extends BaseComponent<DialogPassThrough> implements OnInit,
477
485
  getAriaLabelledBy(): string | null;
478
486
  parseDurationToMilliseconds(durationString: string): number | undefined;
479
487
  _focus(focusParentElement?: HTMLElement): boolean;
488
+ /**
489
+ * The element the app named (`initialFocus`), else one marked `autofocus` in the content (#187).
490
+ * The dialog still renders hidden when the enter timer fires on a slow machine, so focus is
491
+ * retried each frame until it lands, for at most about a second.
492
+ */
493
+ private _focusNamed;
480
494
  focus(focusParentElement?: HTMLElement): void;
481
495
  close(event: Event): void;
482
496
  enableModality(): void;
@@ -515,7 +529,7 @@ declare class Dialog extends BaseComponent<DialogPassThrough> implements OnInit,
515
529
  onDestroy(): void;
516
530
  get dataP(): string | undefined;
517
531
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<Dialog, never>;
518
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<Dialog, "agl-dialog", never, { "hostName": { "alias": "hostName"; "required": false; }; "header": { "alias": "header"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "contentStyle": { "alias": "contentStyle"; "required": false; }; "contentStyleClass": { "alias": "contentStyleClass"; "required": false; }; "modal": { "alias": "modal"; "required": false; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; "breakpoints": { "alias": "breakpoints"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "maskStyleClass": { "alias": "maskStyleClass"; "required": false; }; "maskStyle": { "alias": "maskStyle"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "blockScroll": { "alias": "blockScroll"; "required": false; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "minX": { "alias": "minX"; "required": false; }; "minY": { "alias": "minY"; "required": false; }; "focusOnShow": { "alias": "focusOnShow"; "required": false; }; "maximizable": { "alias": "maximizable"; "required": false; }; "keepInViewport": { "alias": "keepInViewport"; "required": false; }; "focusTrap": { "alias": "focusTrap"; "required": false; }; "transitionOptions": { "alias": "transitionOptions"; "required": false; }; "maskMotionOptions": { "alias": "maskMotionOptions"; "required": false; "isSignal": true; }; "motionOptions": { "alias": "motionOptions"; "required": false; "isSignal": true; }; "closeIcon": { "alias": "closeIcon"; "required": false; }; "closeAriaLabel": { "alias": "closeAriaLabel"; "required": false; }; "closeTabindex": { "alias": "closeTabindex"; "required": false; }; "minimizeIcon": { "alias": "minimizeIcon"; "required": false; }; "maximizeIcon": { "alias": "maximizeIcon"; "required": false; }; "closeButtonProps": { "alias": "closeButtonProps"; "required": false; }; "maximizeButtonProps": { "alias": "maximizeButtonProps"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "style": { "alias": "style"; "required": false; }; "position": { "alias": "position"; "required": false; }; "role": { "alias": "role"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "headerTemplate": { "alias": "content"; "required": false; }; "contentTemplate": { "alias": "contentTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "closeIconTemplate": { "alias": "closeIconTemplate"; "required": false; }; "maximizeIconTemplate": { "alias": "maximizeIconTemplate"; "required": false; }; "minimizeIconTemplate": { "alias": "minimizeIconTemplate"; "required": false; }; "headlessTemplate": { "alias": "headlessTemplate"; "required": false; }; }, { "onShow": "onShow"; "onHide": "onHide"; "visibleChange": "visibleChange"; "onResizeInit": "onResizeInit"; "onResizeEnd": "onResizeEnd"; "onDragEnd": "onDragEnd"; "onMaximize": "onMaximize"; }, ["_headerTemplate", "_contentTemplate", "_footerTemplate", "_closeiconTemplate", "_maximizeiconTemplate", "_minimizeiconTemplate", "_headlessTemplate"], ["*"], true, [{ directive: typeof i1.Bind; inputs: {}; outputs: {}; }]>;
532
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<Dialog, "agl-dialog", never, { "hostName": { "alias": "hostName"; "required": false; }; "header": { "alias": "header"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "contentStyle": { "alias": "contentStyle"; "required": false; }; "contentStyleClass": { "alias": "contentStyleClass"; "required": false; }; "modal": { "alias": "modal"; "required": false; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; "breakpoints": { "alias": "breakpoints"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "maskStyleClass": { "alias": "maskStyleClass"; "required": false; }; "maskStyle": { "alias": "maskStyle"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "blockScroll": { "alias": "blockScroll"; "required": false; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "minX": { "alias": "minX"; "required": false; }; "minY": { "alias": "minY"; "required": false; }; "focusOnShow": { "alias": "focusOnShow"; "required": false; }; "initialFocus": { "alias": "initialFocus"; "required": false; }; "maximizable": { "alias": "maximizable"; "required": false; }; "keepInViewport": { "alias": "keepInViewport"; "required": false; }; "focusTrap": { "alias": "focusTrap"; "required": false; }; "transitionOptions": { "alias": "transitionOptions"; "required": false; }; "maskMotionOptions": { "alias": "maskMotionOptions"; "required": false; "isSignal": true; }; "motionOptions": { "alias": "motionOptions"; "required": false; "isSignal": true; }; "closeIcon": { "alias": "closeIcon"; "required": false; }; "closeAriaLabel": { "alias": "closeAriaLabel"; "required": false; }; "closeTabindex": { "alias": "closeTabindex"; "required": false; }; "minimizeIcon": { "alias": "minimizeIcon"; "required": false; }; "maximizeIcon": { "alias": "maximizeIcon"; "required": false; }; "closeButtonProps": { "alias": "closeButtonProps"; "required": false; }; "maximizeButtonProps": { "alias": "maximizeButtonProps"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "style": { "alias": "style"; "required": false; }; "position": { "alias": "position"; "required": false; }; "role": { "alias": "role"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "headerTemplate": { "alias": "content"; "required": false; }; "contentTemplate": { "alias": "contentTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "closeIconTemplate": { "alias": "closeIconTemplate"; "required": false; }; "maximizeIconTemplate": { "alias": "maximizeIconTemplate"; "required": false; }; "minimizeIconTemplate": { "alias": "minimizeIconTemplate"; "required": false; }; "headlessTemplate": { "alias": "headlessTemplate"; "required": false; }; }, { "onShow": "onShow"; "onHide": "onHide"; "visibleChange": "visibleChange"; "onResizeInit": "onResizeInit"; "onResizeEnd": "onResizeEnd"; "onDragEnd": "onDragEnd"; "onMaximize": "onMaximize"; }, ["_headerTemplate", "_contentTemplate", "_footerTemplate", "_closeiconTemplate", "_maximizeiconTemplate", "_minimizeiconTemplate", "_headlessTemplate"], ["*"], true, [{ directive: typeof i1.Bind; inputs: {}; outputs: {}; }]>;
519
533
  static ngAcceptInputType_draggable: unknown;
520
534
  static ngAcceptInputType_resizable: unknown;
521
535
  static ngAcceptInputType_modal: unknown;
@@ -88,10 +88,17 @@ declare class Popover extends BaseComponent<PopoverPassThrough> {
88
88
  */
89
89
  baseZIndex: number;
90
90
  /**
91
- * When enabled, first button receives focus on show.
91
+ * When enabled, focus moves into the panel on show: to the `initialFocus` target, else an element
92
+ * marked `autofocus`, else the first focusable element.
92
93
  * @group Props
93
94
  */
94
95
  focusOnShow: boolean;
96
+ /**
97
+ * Names the element that receives focus when the panel opens: a CSS selector matched inside the
98
+ * panel. Applies with `focusOnShow`.
99
+ * @group Props
100
+ */
101
+ initialFocus: string | undefined;
95
102
  /**
96
103
  * Transition options of the show animation.
97
104
  * @group Props
@@ -174,6 +181,13 @@ declare class Popover extends BaseComponent<PopoverPassThrough> {
174
181
  * @group Method
175
182
  */
176
183
  hide(): void;
184
+ /**
185
+ * Focus inside the panel would fall to <body> once the panel is removed (#188): since focusOnShow
186
+ * moves focus into the panel, Esc or a row that closes the popover left a keyboard user nowhere.
187
+ * Hand focus back to the element the popover was opened from, before the panel goes, and only
188
+ * when focus is still inside it: a click that already moved focus elsewhere is left alone.
189
+ */
190
+ private restoreFocusToTarget;
177
191
  onCloseClick(event: MouseEvent): void;
178
192
  onEscapeKeydown(_event: KeyboardEvent): void;
179
193
  onWindowResize(): void;
@@ -184,7 +198,7 @@ declare class Popover extends BaseComponent<PopoverPassThrough> {
184
198
  onContainerDestroy(): void;
185
199
  onDestroy(): void;
186
200
  static ɵfac: i0.ɵɵFactoryDeclaration<Popover, never>;
187
- static ɵcmp: i0.ɵɵComponentDeclaration<Popover, "agl-popover", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "dismissable": { "alias": "dismissable"; "required": false; }; "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "ariaCloseLabel": { "alias": "ariaCloseLabel"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "focusOnShow": { "alias": "focusOnShow"; "required": false; }; "showTransitionOptions": { "alias": "showTransitionOptions"; "required": false; }; "hideTransitionOptions": { "alias": "hideTransitionOptions"; "required": false; }; "motionOptions": { "alias": "motionOptions"; "required": false; "isSignal": true; }; }, { "onShow": "onShow"; "onHide": "onHide"; }, ["contentTemplate"], ["*"], true, [{ directive: typeof i1.Bind; inputs: {}; outputs: {}; }]>;
201
+ static ɵcmp: i0.ɵɵComponentDeclaration<Popover, "agl-popover", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "dismissable": { "alias": "dismissable"; "required": false; }; "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "ariaCloseLabel": { "alias": "ariaCloseLabel"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "focusOnShow": { "alias": "focusOnShow"; "required": false; }; "initialFocus": { "alias": "initialFocus"; "required": false; }; "showTransitionOptions": { "alias": "showTransitionOptions"; "required": false; }; "hideTransitionOptions": { "alias": "hideTransitionOptions"; "required": false; }; "motionOptions": { "alias": "motionOptions"; "required": false; "isSignal": true; }; }, { "onShow": "onShow"; "onHide": "onHide"; }, ["contentTemplate"], ["*"], true, [{ directive: typeof i1.Bind; inputs: {}; outputs: {}; }]>;
188
202
  static ngAcceptInputType_dismissable: unknown;
189
203
  static ngAcceptInputType_autoZIndex: unknown;
190
204
  static ngAcceptInputType_baseZIndex: unknown;
@@ -239,6 +239,13 @@ declare class Tooltip extends BaseComponent<TooltipPassThroughOptions> {
239
239
  left: any;
240
240
  top: any;
241
241
  };
242
+ /**
243
+ * The box a right-positioned tooltip measures. On a component host (`agl-*`) that is the
244
+ * component's own root (`.p-component`), not the host element, whose box can be wider (a block
245
+ * host around an inline root). The host is used when it is itself the root, or when no root is
246
+ * found inside it. The prefix tested here was still `P-` after the rename, so this branch never
247
+ * ran and every component host measured the host element (#173).
248
+ */
242
249
  private get activeElement();
243
250
  alignRight(): void;
244
251
  alignLeft(): void;