@guildofgleks/ui 21.7.2 → 21.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildofgleks/ui",
-  "version": "21.7.2",
+  "version": "21.8.0",
   "engines": {
     "node": ">=20.19.0"
   },

package/types/guildofgleks-ui.d.ts

@@ -6,6 +6,12 @@ import * as _angular_platform_browser from '@angular/platform-browser';
 
 type GogSize = 'xsm' | 'sm' | 'md' | 'lg' | 'slg';
 type GogVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+/**
+ * The `aria-haspopup` values that make sense on a button, matching the ARIA 1.2 enumeration.
+ * `true` is a synonym for `'menu'` in the spec; prefer the specific value, since a screen
+ * reader announces it ("has menu", "has dialog").
+ */
+type GogAriaHasPopup = boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
 /**
  * How a surface paints itself, shared by `gog-card` and `gog-panel` so the two agree:
  * - `'outlined'` — a border, no shadow. The quietest, and right for a grid of many.
@@ -144,6 +150,35 @@ declare class ButtonComponent {
      * Use this input instead, especially for icon-only buttons.
      */
     ariaLabel: _angular_core.InputSignal<string | null>;
+    /**
+     * State and relationship attributes, forwarded to the native `<button>` for the same reason
+     * `ariaLabel` is: this component hides the real button, so an `[attr.aria-*]` written on
+     * `<gog-button>` lands on the custom element — which has no role — and reaches nothing.
+     * It fails silently, with no error and no visible difference.
+     *
+     * `null` (the default) omits the attribute. `false` is **not** the same as `null` here and is
+     * deliberately forwarded: a toggle button in its off state has to say `aria-pressed="false"`,
+     * because a button with no `aria-pressed` at all is not a toggle button — it is a button that
+     * does something, and a screen reader will describe it as one.
+     *
+     * ```html
+     * <gog-button [ariaPressed]="isRtl()" (gogClick)="toggle()">Mirror</gog-button>
+     *
+     * <gog-button [ariaExpanded]="isOpen()" ariaControls="filters" ariaHasPopup="dialog">
+     *   Filters
+     * </gog-button>
+     * ```
+     *
+     * The `[gogButton]` directive needs none of this: it styles an element the consumer owns, so
+     * `aria-pressed` written there already lands where it should.
+     */
+    ariaPressed: _angular_core.InputSignal<boolean | "mixed" | null>;
+    /** See `ariaPressed`. `false` renders `aria-expanded="false"`; `null` omits the attribute. */
+    ariaExpanded: _angular_core.InputSignal<boolean | null>;
+    /** Id of the element this button controls — pairs with `ariaExpanded`. See `ariaPressed`. */
+    ariaControls: _angular_core.InputSignal<string | null>;
+    /** What this button opens, if anything. See `ariaPressed`. */
+    ariaHasPopup: _angular_core.InputSignal<GogAriaHasPopup | null>;
     gogClick: _angular_core.OutputEmitterRef<MouseEvent>;
     /** Fully non-interactive: excluded from tab order via the native `disabled` attribute. */
     protected isNativeDisabled: _angular_core.Signal<boolean>;
@@ -166,7 +201,7 @@ declare class ButtonComponent {
     constructor();
     protected onClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "gog-button", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "ripple": { "alias": "ripple"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "gogClick": "gogClick"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "gog-button", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "ripple": { "alias": "ripple"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaPressed": { "alias": "ariaPressed"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; }, { "gogClick": "gogClick"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -4351,7 +4386,11 @@ interface GogGlobalConfig {
         hideDelay?: number;
         position?: GogTooltipPosition;
     };
-    /** Applies to `gog-inputfield`, `gog-select`, `gog-multiselect` and `gog-textarea`. */
+    /**
+     * Applies to `gog-inputfield`, `gog-textarea`, `gog-select`, `gog-multiselect`,
+     * `gog-autocomplete` and `gog-datepicker` — every field that can float a label. All six read
+     * it through the same `GogFloatLabelState`, three of them via `GogDropdownBase`.
+     */
     floatLabel?: {
         variant?: GogFloatLabelVariant;
         /**
@@ -4366,32 +4405,55 @@ interface GogGlobalConfig {
      * literally every one of them: a compact app writes `size="sm"` everywhere, and a
      * Reactive-Forms app writes `errorDisplay="auto"` on every field.
      *
-     * - `size` applies to `gog-button`, `gog-inputfield`, `gog-textarea`, `gog-select`,
-     *   `gog-multiselect`, `gog-checkbox` and `gog-radio-group`. Deliberately **not** to
-     *   `gog-table`, `gog-accordion` or `gog-paginator` (whose `size` means row/layout density
-     *   and whose defaults differ), nor to `gog-spinner`, `gog-skeleton`, `gog-tag` or
+     * - `size` applies to `gog-button` and `[gogButton]`, `gog-button-toggle-group`,
+     *   `gog-checkbox`, `gog-toggle`, `gog-radio-group`, `gog-inputfield`, `gog-textarea`,
+     *   `gog-select`, `gog-multiselect`, `gog-autocomplete` and `gog-datepicker`. Deliberately
+     *   **not** to `gog-table`, `gog-accordion` or `gog-paginator` (whose `size` means row/layout
+     *   density and whose defaults differ), nor to `gog-spinner`, `gog-skeleton`, `gog-tag` or
      *   `gog-chip` (sized to fit whatever they sit next to, not to a form's density).
      * - `errorDisplay` applies to every control that renders a validation message:
-     *   `gog-inputfield`, `gog-textarea`, `gog-select`, `gog-multiselect`, `gog-radio-group`
-     *   and `gog-slider`.
+     *   `gog-inputfield`, `gog-textarea`, `gog-select`, `gog-multiselect`, `gog-autocomplete`,
+     *   `gog-datepicker`, `gog-radio-group` and `gog-slider`.
      *
      * A component's own built-in default still applies when this is unset, so setting `size`
      * here does not flatten the different defaults those excluded components have.
+     *
+     * **When you add a reader, add it here — and note that "reader" is not the same as "names
+     * the field".** These lists were wrong for four keys until 2026-09-02, always in the same
+     * direction and for the same reason: `gog-select`, `gog-multiselect` and `gog-autocomplete`
+     * resolve `size`/`errorDisplay`/`clearable`/`floatLabel` inside `GogDropdownBase`, and
+     * `gog-datepicker` composes the same state classes directly, so none of the four contains the
+     * `globalConfig.control?.…` expression that a grep for readers finds. Nor does the resolved
+     * value always reach a template by name — `size` arrives as a computed class (`sizeClass`,
+     * `panelSizeClass`) and `dropdown.direction` is consumed by placement code, so "is the
+     * computed referenced in the component's HTML?" answers *no* for components that genuinely
+     * honour the key. Trace the shared state classes, not just the components.
      */
     control?: {
         size?: GogSize;
         errorDisplay?: GogErrorDisplay;
         /**
-         * Whether `gog-inputfield`, `gog-textarea`, `gog-select` and `gog-multiselect` offer a
-         * clear button. The button only ever appears once the control actually has something to
-         * clear, so switching this on app-wide adds no permanent chrome.
+         * Whether `gog-inputfield`, `gog-textarea`, `gog-select`, `gog-multiselect`,
+         * `gog-autocomplete` and `gog-datepicker` offer a clear button — every control that
+         * composes `GogClearableState`. The button only ever appears once the control actually has
+         * something to clear, so switching this on app-wide adds no permanent chrome.
          *
          * Component defaults are `false`, except `gog-multiselect`, which had a clear button
          * before this input existed and keeps it.
          */
         clearable?: boolean;
     };
-    /** Applies to `gog-select` and `gog-multiselect`. */
+    /**
+     * Applies per field rather than per component, which is why this is not one sentence:
+     *
+     * - `appendToBody` and `direction` reach `gog-select`, `gog-multiselect`,
+     *   `gog-autocomplete` (all three through `GogDropdownBase`) and `gog-datepicker`, which
+     *   resolves the same pair itself.
+     * - `filter` and `filterPosition` reach `gog-select` and `gog-multiselect` only.
+     *   `gog-autocomplete` inherits both inputs from the same base class and renders no filter
+     *   box for them — its own text field *is* the filter, so a second search box inside the
+     *   panel would be a duplicate. Setting these does nothing to an autocomplete.
+     */
     dropdown?: {
         /**
          * Whether the panel is rendered into `<body>` instead of inline. Worth setting app-wide
@@ -4761,4 +4823,4 @@ declare const GOG_ICONS: InjectionToken<Readonly<Record<string, string>>>;
 declare function provideGogIcons(icons: Readonly<Record<string, string>>): Provider;
 
 export { AccordionComponent, AutocompleteComponent, ButtonComponent, ButtonToggleGroupComponent, CalendarComponent, CardComponent, CheckboxComponent, ChipComponent, CollapsibleComponent, ConfirmationDialogComponent, DIALOG_DATA, DIALOG_REF, DatepickerComponent, DialogComponent, DialogService, DividerComponent, GOG_CONFIG, GOG_DEPRECATIONS, GOG_ICONS, GOG_TABS_STATE, GOG_TOKEN_GROUPS, GogAccordionChevronDirective, GogAccordionContentDirective, GogAccordionHeaderDirective, GogBadgeDirective, GogButtonDirective, GogButtonToggleOptionDirective, GogCardFooterDirective, GogCardHeaderDirective, GogCardLinkDirective, GogCardMediaDirective, GogCheckboxIconDirective, GogCollapsibleContentDirective, GogCollapsibleTriggerDirective, GogColumn, GogColumnBodyDirective, GogColumnHeaderDirective, GogDropdownBase, GogDropdownChevronDirective, GogDropdownOptionDirective, GogFloatLabelState, GogInputAddonEndDirective, GogInputAddonStartDirective, GogMenuItemDirective, GogMenuTriggerDirective, GogMultiselectClearIconDirective, GogPanelFooterDirective, GogPanelHeaderDirective, GogRippleDirective, GogTabContentDirective, GogTabHeaderDirective, GogTagIconDirective, GogTooltipDirective, ICON_DEFS, IconComponent, InputfieldComponent, MenuComponent, MultiselectComponent, PaginatorComponent, PanelComponent, ProgressbarComponent, RadioGroupComponent, ScrollComponent, SelectComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SpinnerOverlayComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, ThemeService, ToastComponent, ToastContainerComponent, ToastService, ToggleComponent, addDays, addMonths, addYears, buildMonthGrid, clampDate, copyTimeOnto, daysInMonth, defaultCompare, formatDate, getByPath, isAfterDay, isBeforeDay, isInRange, isSameDay, isSameMonth, isSameOptionValue, isWithinBounds, localeFirstDayOfWeek, monthNames, parseDate, provideGogConfig, provideGogIcons, readOption, resolveConfigured, startOfDay, weekdayNames, withTime };
-export type { ConfirmDialogData, DialogConfig, DialogHandle, DialogRef, GogAccordionChevronContext, GogAccordionHeaderContext, GogAccordionItem, GogAccordionToggleEvent, GogBadgePosition, GogBuiltinIconName, GogButtonToggleAppearance, GogButtonToggleOptionContext, GogCalendarDay, GogColumnBodyContext, GogColumnHeaderContext, GogDateRange, GogDateSelectionMode, GogDatepickerValue, GogDeprecation, GogDeprecationKind, GogDividerVariant, GogDropdownDirection, GogDropdownFilterPosition, GogDropdownOption, GogDropdownOptionContext, GogFloatLabelVariant, GogGlobalConfig, GogHourFormat, GogIconName, GogInputMode, GogInputType, GogOptionAccessor, GogOrientation, GogPaginatorRangeMode, GogProgressbarMode, GogProgressbarVariant, GogRadioOption, GogScrollAxis, GogScrollMetrics, GogScrollOverscrollBehavior, GogScrollSize, GogSize, GogSkeletonAnimation, GogSkeletonShape, GogSliderOrientation, GogSliderRange, GogSpinnerVariant, GogSurfaceVariant, GogTabHeaderContext, GogTableRowClickEvent, GogTableSelectionMode, GogTableSortEvent, GogTabsAlign, GogTabsState, GogTagShape, GogTagVariant, GogTextareaResize, GogTokenGroup, GogTokenLayer, GogTokenName, GogTooltipPosition, GogTooltipSide, GogVariant, OpenDialog, SortDirection, Toast, ToastAction, ToastConfig, ToastPosition, ToastType };
+export type { ConfirmDialogData, DialogConfig, DialogHandle, DialogRef, GogAccordionChevronContext, GogAccordionHeaderContext, GogAccordionItem, GogAccordionToggleEvent, GogAriaHasPopup, GogBadgePosition, GogBuiltinIconName, GogButtonToggleAppearance, GogButtonToggleOptionContext, GogCalendarDay, GogColumnBodyContext, GogColumnHeaderContext, GogDateRange, GogDateSelectionMode, GogDatepickerValue, GogDeprecation, GogDeprecationKind, GogDividerVariant, GogDropdownDirection, GogDropdownFilterPosition, GogDropdownOption, GogDropdownOptionContext, GogFloatLabelVariant, GogGlobalConfig, GogHourFormat, GogIconName, GogInputMode, GogInputType, GogOptionAccessor, GogOrientation, GogPaginatorRangeMode, GogProgressbarMode, GogProgressbarVariant, GogRadioOption, GogScrollAxis, GogScrollMetrics, GogScrollOverscrollBehavior, GogScrollSize, GogSize, GogSkeletonAnimation, GogSkeletonShape, GogSliderOrientation, GogSliderRange, GogSpinnerVariant, GogSurfaceVariant, GogTabHeaderContext, GogTableRowClickEvent, GogTableSelectionMode, GogTableSortEvent, GogTabsAlign, GogTabsState, GogTagShape, GogTagVariant, GogTextareaResize, GogTokenGroup, GogTokenLayer, GogTokenName, GogTooltipPosition, GogTooltipSide, GogVariant, OpenDialog, SortDirection, Toast, ToastAction, ToastConfig, ToastPosition, ToastType };