@besaitech/ng-design-system 0.0.81 → 0.0.82

package/index.d.ts

@@ -1664,7 +1664,8 @@ declare class SdsMenu implements OnDestroy {
     /** An action was activated. */
     readonly select: _angular_core.OutputEmitterRef<SdsMenuAction>;
     protected readonly projectedTrigger: _angular_core.Signal<SdsMenuTrigger | undefined>;
-    private panelEl;
+    /** Body-appending, positioning, follow-on-scroll and teardown — see SdsOverlayPanel. */
+    private readonly overlay;
     /** Which item gets focus when the panel opens: 'first' | 'last' | 'none'. */
     private focusOnOpen;
     private typeBuffer;
@@ -1691,11 +1692,6 @@ declare class SdsMenu implements OnDestroy {
     private focusItemAt;
     protected activate(entry: SdsMenuAction, event?: Event): void;
     protected onDocumentClick(event: MouseEvent): void;
-    private readonly reflow;
-    private listening;
-    private addReflowListeners;
-    private removeReflowListeners;
-    private position;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsMenu, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsMenu, "sds-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "triggerIcon": { "alias": "triggerIcon"; "required": false; "isSignal": true; }; "triggerText": { "alias": "triggerText"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "keepOpen": { "alias": "keepOpen"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "select": "select"; }, ["projectedTrigger"], ["[sdsMenuTrigger]"], true, never>;
 }
@@ -2412,8 +2408,8 @@ declare class SdsDatePicker implements ControlValueAccessor, OnDestroy {
     private readonly cvaDisabled;
     private readonly calendar;
     private readonly trigger;
-    /** The overlay panel, relocated to document.body while open. */
-    private panelEl;
+    /** Body-appending, positioning, follow-on-scroll and teardown — see SdsOverlayPanel. */
+    private readonly overlay;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly displayValue: _angular_core.Signal<string>;
     /** Whether the clear button is shown (affects the field's right padding). */
@@ -2445,11 +2441,6 @@ declare class SdsDatePicker implements ControlValueAccessor, OnDestroy {
      */
     protected onPanelKeydown(event: KeyboardEvent): void;
     protected onDocumentClick(event: MouseEvent): void;
-    private readonly reflow;
-    private listening;
-    private addReflowListeners;
-    private removeReflowListeners;
-    private positionPanel;
     ngOnDestroy(): void;
     private setValue;
     private onChange;
@@ -2686,8 +2677,8 @@ declare class SdsDateRangePicker implements OnDestroy {
     protected readonly pendingEnd: _angular_core.WritableSignal<Date | null>;
     private readonly calendar;
     private readonly trigger;
-    /** The overlay panel, relocated to document.body while open. */
-    private panelEl;
+    /** Body-appending, positioning, follow-on-scroll and teardown — see SdsOverlayPanel. */
+    private readonly overlay;
     /** Id of the preset the current value equals, or `null` (no value, or a custom range). */
     readonly activePresetId: _angular_core.Signal<string | null>;
     protected readonly pendingPresetId: _angular_core.Signal<string | null>;
@@ -2719,11 +2710,6 @@ declare class SdsDateRangePicker implements OnDestroy {
      */
     protected onPanelKeydown(event: KeyboardEvent): void;
     protected onDocumentClick(event: MouseEvent): void;
-    private readonly reflow;
-    private listening;
-    private addReflowListeners;
-    private removeReflowListeners;
-    private positionPanel;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsDateRangePicker, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsDateRangePicker, "sds-date-range-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxDays": { "alias": "maxDays"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; "presetsLabel": { "alias": "presetsLabel"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "endLabel": { "alias": "endLabel"; "required": false; "isSignal": true; }; "applyLabel": { "alias": "applyLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "calendarLabel": { "alias": "calendarLabel"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "presetSelect": "presetSelect"; }, never, never, true, never>;
@@ -3148,6 +3134,17 @@ interface SdsPanelOptions {
     /** Open upwards when there is room, instead of the default "below unless it does not fit". */
     prefer?: SdsPanelDirection;
 }
+/** What the DOM half takes: the arithmetic's options, plus what only the element can do. */
+interface SdsOverlayOptions extends SdsPanelOptions {
+    /**
+     * Tie the panel's width to the trigger's.
+     *
+     * <p>`'min'` for a panel that may grow — a select's longest option should not be truncated by
+     * the width of its own field. `'exact'` for one that must not: an address suggestion list wider
+     * than the input it hangs off stops reading as part of the field.
+     */
+    width?: 'min' | 'exact';
+}
 interface SdsRect {
     top: number;
     bottom: number;
@@ -3188,10 +3185,17 @@ declare class SdsOverlayPanel {
     private listening;
     private readonly reflow;
     /** Attach (or re-attach) the panel to the body and start following the trigger. */
-    attach(trigger: HTMLElement, panel: HTMLElement, options?: SdsPanelOptions & {
-        matchTriggerWidth?: boolean;
-    }): void;
+    attach(trigger: HTMLElement, panel: HTMLElement, options?: SdsOverlayOptions): void;
     reposition(): void;
+    /**
+     * The live panel element, or null while closed.
+     *
+     * <p>Read-only on purpose. A component that needs to reach inside the panel — to focus a row, to
+     * trap Tab, to read its options — asks here rather than keeping its own field. A second
+     * reference is how the autocomplete came to remove the panel through a `viewChild` that Angular
+     * had already cleared, which is the bug this class exists to make unrepeatable.
+     */
+    get element(): HTMLElement | null;
     /** Does the panel contain this node? For "did the click land outside" checks. */
     contains(node: Node | null): boolean;
     /** Stop following, and remove the panel from the body. Safe to call more than once. */
@@ -3723,7 +3727,8 @@ declare class SdsAddressAutocomplete implements ControlValueAccessor, OnDestroy
     private seq;
     private timer?;
     private destroyed;
-    private panelEl;
+    /** Body-appending, positioning, follow-on-scroll and teardown — see SdsOverlayPanel. */
+    private readonly overlay;
     protected readonly fieldId: _angular_core.Signal<string>;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly pill: _angular_core.Signal<boolean>;
@@ -3766,13 +3771,15 @@ declare class SdsAddressAutocomplete implements ControlValueAccessor, OnDestroy
     private activate;
     protected onKeydown(event: KeyboardEvent): void;
     private scrollHighlightedIntoView;
+    /**
+     * Keep the body-appended panel in step with whether it should be shown at all.
+     *
+     * <p>Driven from `afterEveryRender`, so it runs on every change and must be cheap and idempotent
+     * — attaching once, then repositioning while it stays open.
+     */
+    private syncPanel;
     /** Close the overlay (a no-op `inline`, where the rows are always shown). */
     close(): void;
-    private readonly reflow;
-    private listening;
-    private syncPanel;
-    private detachPanel;
-    private positionPanel;
     protected onDocumentClick(event: MouseEvent): void;
     ngOnDestroy(): void;
     private onChange;
@@ -5615,7 +5622,7 @@ interface SdsLanguageOption {
  * disclosure mechanics (closes on outside click, on Escape, and on selection, restoring focus to the trigger),
  * and the same panel styling and open animation — so the three top-bar controls read as one set.
  *
- * The panel is appended to `document.body` while open and positioned against the trigger (like sds-select),
+ * The panel is appended to `document.body` while open and placed by `SdsOverlayPanel` (like sds-select),
  * so a clipping ancestor — a bar with `overflow:hidden`, or a `glass` bar whose `backdrop-filter` is a
  * containing block — can never cut it off or paint over it. It repositions on scroll/resize and is removed
  * on close. Accessibility follows the APG select-only combobox: focus stays on the trigger, and Arrow/Home/
@@ -5656,7 +5663,8 @@ declare class SdsLanguageSwitcher implements OnDestroy {
     readonly openChange: _angular_core.OutputEmitterRef<boolean>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly highlightedIndex: _angular_core.WritableSignal<number>;
-    private panelEl;
+    /** Body-appending, positioning, follow-on-scroll and teardown — see SdsOverlayPanel. */
+    private readonly overlay;
     /** Normalise the mixed `languages` input to `{ code, label }`, defaulting the label to the code. */
     protected readonly options: _angular_core.Signal<SdsLanguageOption[]>;
     /**
@@ -5680,11 +5688,6 @@ declare class SdsLanguageSwitcher implements OnDestroy {
     private highlight;
     private chooseHighlighted;
     private scrollHighlightedIntoView;
-    private readonly reflow;
-    private listening;
-    private addReflowListeners;
-    private removeReflowListeners;
-    private positionPanel;
     ngOnDestroy(): void;
     private readonly onBrand;
     protected readonly triggerClass: _angular_core.Signal<"text-white/85 hover:bg-white/10 hover:text-white focus-visible:ring-white/40" | "bg-muted text-ink-soft hover:bg-brand-50 hover:text-brand-600 focus-visible:ring-brand-500/40">;
@@ -5854,4 +5857,4 @@ declare const SDS_CHART_CONFIG: InjectionToken<SdsChartConfig>;
 declare function provideSdsCharts(config: SdsChartConfig): Provider;
 
 export { SDS_ALLERGENS, SDS_ALLERGEN_ICONS, SDS_ALLERGEN_LABELS_EN, SDS_CHART_CONFIG, SDS_CHART_LABELS_EN, SDS_ICONS, SDS_PHONE_COUNTRIES, SDS_THEME_STORAGE_KEY, SDS_UI_PREF_LANG_PARAM, SDS_UI_PREF_THEME_PARAM, SdsAccordion, SdsAccordionContent, SdsAccordionHeader, SdsAccordionPanel, SdsAccordionStore, SdsAddressAutocomplete, SdsAddressExtra, SdsAllergenIcon, SdsAutocomplete, SdsAvatar, SdsBadge, SdsBulkBar, SdsButton, SdsCalendar, SdsCard, SdsCheckbox, SdsChecklistRow, SdsChip, SdsChipGroup, SdsDatePicker, SdsDateRangePicker, SdsEnvBanner, SdsFileDrop, SdsFormActions, SdsIcon, SdsImageCropper, SdsInput, SdsInputNumber, SdsLanguageSwitcher, SdsLocalizedInput, SdsMenu, SdsMenuItem, SdsMenuTrigger, SdsMultiSelect, SdsNavGroup, SdsNavItem, SdsOtpInput, SdsOverlayPanel, SdsPaginator, SdsPhoneInput, SdsRadio, SdsRangeCalendar, SdsScore, SdsSearchCommand, SdsSegmented, SdsSelect, SdsSelectEmpty, SdsSelectFooter, SdsSelectOption, SdsSeverity, SdsShell, SdsSidebar, SdsSortableHandle, SdsSortableItem, SdsSortableList, SdsStatusTile, SdsTab, SdsTabList, SdsTabPanel, SdsTabPanels, SdsTable, SdsTableCell, SdsTableEmpty, SdsTableHeader, SdsTableRowExpansion, SdsTabs, SdsTabsStore, SdsTextarea, SdsThemeService, SdsThemeToggle, SdsTimeInput, SdsToastHost, SdsToastService, SdsToggleSwitch, SdsTopbar, SdsTriStateChip, SdsUserMenu, SidebarStore, addDays, addMonths, addMonthsKeepDay, appendUiPrefs, diffInDays, formatDateRange, formatDdMmYyyy, formatHhMm, isOutOfRange, isSameDay, isSameRange, isSdsThemeMode, isoDay, pad2, placePanel, provideSdsCharts, readUiPrefs, sdsFileMatchesAccept, sdsFormatBytes, sdsFormatNational, sdsLastDays, sdsLastMonths, sdsMatchDialCode, sdsNormalizeSignificant, startOfDay, startOfMonth, stripUiPrefs };
-export type { SdsAccordionActive, SdsAccordionValue, SdsAddressAutocompleteAppearance, SdsAddressAutocompleteShape, SdsAddressAutocompleteSize, SdsAddressExtraContext, SdsAddressExtraPosition, SdsAddressLocateFn, SdsAddressSearchFn, SdsAddressSuggestion, SdsAllergen, SdsAutocompleteDisplay, SdsAutocompleteSearchFn, SdsAutocompleteSize, SdsAvatarShape, SdsAvatarStatus, SdsBadgeSize, SdsBadgeVariant, SdsBulkBarPosition, SdsButtonShape, SdsButtonSize, SdsButtonVariant, SdsCardVariant, SdsChartConfig, SdsChartLabels, SdsCheckboxSize, SdsChecklistStatus, SdsChipOption, SdsChipSize, SdsCropRect, SdsDatePickerSize, SdsDateRange, SdsDateRangePickerSize, SdsDateRangePreset, SdsEnvBannerEnv, SdsFileDropAppearance, SdsFileRejection, SdsFileRejectionReason, SdsFormActionsPosition, SdsIconName, SdsIconSize, SdsImageCropperBlobOptions, SdsImageCropperShape, SdsInputAppearance, SdsInputNumberAppearance, SdsInputNumberButtonLayout, SdsInputNumberCurrencyDisplay, SdsInputNumberMode, SdsInputNumberSize, SdsInputShape, SdsInputSize, SdsInputType, SdsKpiChangeText, SdsLanguageOption, SdsLanguageSwitcherAlign, SdsLanguageSwitcherAppearance, SdsLanguageSwitcherDirection, SdsLocalizedInputSize, SdsLocalizedValue, SdsMenuAction, SdsMenuAlign, SdsMenuEntry, SdsMenuItemTone, SdsMenuSeparator, SdsMultiSelectDisplay, SdsMultiSelectSize, SdsNavItemBadgeTone, SdsOtpInputSize, SdsPaginatorSize, SdsPaginatorState, SdsPanelAlign, SdsPanelDirection, SdsPanelOptions, SdsPhoneCountry, SdsPhoneInputSize, SdsPhoneValue, SdsRadioSize, SdsRect, SdsScoreSize, SdsScoreTier, SdsScoreVariant, SdsSearchAppearance, SdsSearchItem, SdsSegmentedOption, SdsSegmentedSize, SdsSelectAppearance, SdsSelectEmptyContext, SdsSelectFooterContext, SdsSelectOptionContext, SdsSelectSize, SdsSeverityLevel, SdsSeveritySize, SdsSeverityVariant, SdsShellBackground, SdsSidebarAppearance, SdsSize, SdsSortOrder, SdsSortableAppearance, SdsSortableItemContext, SdsSortableReorderEvent, SdsSparklineSummaryText, SdsStatusTileState, SdsTabValue, SdsTableCellCommitEvent, SdsTableCellContext, SdsTableCellErrors, SdsTableColumn, SdsTableEditTrigger, SdsTableEditor, SdsTableEmptyContext, SdsTableHeaderContext, SdsTableLazyEvent, SdsTableRowExpansionContext, SdsTableSelectOption, SdsTableSize, SdsTableSortEvent, SdsTabsVariant, SdsTextareaAppearance, SdsTextareaResize, SdsTextareaSize, SdsTheme, SdsThemeMode, SdsThemeToggleAppearance, SdsTimeInputAppearance, SdsTimeInputSize, SdsToast, SdsToastKind, SdsToggleSwitchSize, SdsTopbarAppearance, SdsTrendDirection, SdsTriState, SdsTriStateChipSize, SdsUiPrefs, SdsUserMenuAlign, SdsUserMenuAppearance };
+export type { SdsAccordionActive, SdsAccordionValue, SdsAddressAutocompleteAppearance, SdsAddressAutocompleteShape, SdsAddressAutocompleteSize, SdsAddressExtraContext, SdsAddressExtraPosition, SdsAddressLocateFn, SdsAddressSearchFn, SdsAddressSuggestion, SdsAllergen, SdsAutocompleteDisplay, SdsAutocompleteSearchFn, SdsAutocompleteSize, SdsAvatarShape, SdsAvatarStatus, SdsBadgeSize, SdsBadgeVariant, SdsBulkBarPosition, SdsButtonShape, SdsButtonSize, SdsButtonVariant, SdsCardVariant, SdsChartConfig, SdsChartLabels, SdsCheckboxSize, SdsChecklistStatus, SdsChipOption, SdsChipSize, SdsCropRect, SdsDatePickerSize, SdsDateRange, SdsDateRangePickerSize, SdsDateRangePreset, SdsEnvBannerEnv, SdsFileDropAppearance, SdsFileRejection, SdsFileRejectionReason, SdsFormActionsPosition, SdsIconName, SdsIconSize, SdsImageCropperBlobOptions, SdsImageCropperShape, SdsInputAppearance, SdsInputNumberAppearance, SdsInputNumberButtonLayout, SdsInputNumberCurrencyDisplay, SdsInputNumberMode, SdsInputNumberSize, SdsInputShape, SdsInputSize, SdsInputType, SdsKpiChangeText, SdsLanguageOption, SdsLanguageSwitcherAlign, SdsLanguageSwitcherAppearance, SdsLanguageSwitcherDirection, SdsLocalizedInputSize, SdsLocalizedValue, SdsMenuAction, SdsMenuAlign, SdsMenuEntry, SdsMenuItemTone, SdsMenuSeparator, SdsMultiSelectDisplay, SdsMultiSelectSize, SdsNavItemBadgeTone, SdsOtpInputSize, SdsOverlayOptions, SdsPaginatorSize, SdsPaginatorState, SdsPanelAlign, SdsPanelDirection, SdsPanelOptions, SdsPhoneCountry, SdsPhoneInputSize, SdsPhoneValue, SdsRadioSize, SdsRect, SdsScoreSize, SdsScoreTier, SdsScoreVariant, SdsSearchAppearance, SdsSearchItem, SdsSegmentedOption, SdsSegmentedSize, SdsSelectAppearance, SdsSelectEmptyContext, SdsSelectFooterContext, SdsSelectOptionContext, SdsSelectSize, SdsSeverityLevel, SdsSeveritySize, SdsSeverityVariant, SdsShellBackground, SdsSidebarAppearance, SdsSize, SdsSortOrder, SdsSortableAppearance, SdsSortableItemContext, SdsSortableReorderEvent, SdsSparklineSummaryText, SdsStatusTileState, SdsTabValue, SdsTableCellCommitEvent, SdsTableCellContext, SdsTableCellErrors, SdsTableColumn, SdsTableEditTrigger, SdsTableEditor, SdsTableEmptyContext, SdsTableHeaderContext, SdsTableLazyEvent, SdsTableRowExpansionContext, SdsTableSelectOption, SdsTableSize, SdsTableSortEvent, SdsTabsVariant, SdsTextareaAppearance, SdsTextareaResize, SdsTextareaSize, SdsTheme, SdsThemeMode, SdsThemeToggleAppearance, SdsTimeInputAppearance, SdsTimeInputSize, SdsToast, SdsToastKind, SdsToggleSwitchSize, SdsTopbarAppearance, SdsTrendDirection, SdsTriState, SdsTriStateChipSize, SdsUiPrefs, SdsUserMenuAlign, SdsUserMenuAppearance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besaitech/ng-design-system",
-  "version": "0.0.81",
+  "version": "0.0.82",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"