@fundamental-ngx/core 0.64.2-rc.0 → 0.64.2-rc.2

package/schematics/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-schematics",
-  "version": "0.64.2-rc.0",
+  "version": "0.64.2-rc.2",
   "types": "./ng-add/index.d.ts",
   "main": "./ng-add/index.js",
   "type": "commonjs"

package/types/fundamental-ngx-core-button.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { ElementRef, InjectionToken } from '@angular/core';
+import { ElementRef, OnInit, InjectionToken } from '@angular/core';
 import { BooleanInput } from '@angular/cdk/coercion';
 import { HasElementRef } from '@fundamental-ngx/cdk/utils';
 import { IconFont } from '@fundamental-ngx/core/icon';
@@ -103,6 +103,20 @@ declare class BaseButton implements HasElementRef, ButtonModel {
      * auto-generate a description from their type if not provided.
      */
     readonly ariaDescription: _angular_core.InputSignal<string | null | undefined>;
+    /**
+     * Override the default type description for special button types.
+     * Provides a custom description for screen readers.
+     * If not provided, defaults to the i18n-translated type description.
+     */
+    readonly ariaTypeDescription: _angular_core.InputSignal<string | null | undefined>;
+    /**
+     * Custom aria-describedby value.
+     * When provided, bypasses the component's auto-generated aria-describedby
+     * (which references the hidden description spans) and uses this value directly.
+     * Use this when you need to reference external elements as the description source.
+     * Native aria-describedby attributes are captured automatically via ngOnInit.
+     */
+    readonly ariaDescribedBy: _angular_core.InputSignal<string | null | undefined>;
     /** @hidden */
     readonly elementRef: ElementRef<any>;
     /**
@@ -231,7 +245,7 @@ declare class BaseButton implements HasElementRef, ButtonModel {
      */
     isToggled(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseButton, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseButton, never, never, { "toggled": { "alias": "toggled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "glyphPosition": { "alias": "glyphPosition"; "required": false; "isSignal": true; }; "glyph": { "alias": "glyph"; "required": false; "isSignal": true; }; "glyphFont": { "alias": "glyphFont"; "required": false; "isSignal": true; }; "fdType": { "alias": "fdType"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "fdMenu": { "alias": "fdMenu"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaDisabled": { "alias": "aria-disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescription": { "alias": "ariaDescription"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseButton, never, never, { "toggled": { "alias": "toggled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "glyphPosition": { "alias": "glyphPosition"; "required": false; "isSignal": true; }; "glyph": { "alias": "glyph"; "required": false; "isSignal": true; }; "glyphFont": { "alias": "glyphFont"; "required": false; "isSignal": true; }; "fdType": { "alias": "fdType"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "fdMenu": { "alias": "fdMenu"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaDisabled": { "alias": "aria-disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescription": { "alias": "ariaDescription"; "required": false; "isSignal": true; }; "ariaTypeDescription": { "alias": "ariaTypeDescription"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare const badgeEnabledButtonTypes: ButtonType[];
@@ -285,7 +299,7 @@ declare class ButtonBadgeDirective implements HasElementRef {
  * <a fd-button label="Button Text"></a>
  * ```
  */
-declare class ButtonComponent extends BaseButton implements HasElementRef {
+declare class ButtonComponent extends BaseButton implements HasElementRef, OnInit {
     /** Button ID - default value is provided if not set  */
     readonly id: _angular_core.InputSignal<string>;
     /** @hidden */
@@ -293,15 +307,41 @@ declare class ButtonComponent extends BaseButton implements HasElementRef {
     /** @hidden */
     protected readonly contentDensityObserver: ContentDensityObserver;
     /**
-     * Calculate aria-label attribute
+     * Check if button has a special type (emphasized, positive, negative, attention)
      * @hidden
      */
-    protected readonly buttonArialabel: _angular_core.Signal<string | null | undefined>;
+    protected readonly isSpecialButtonType: _angular_core.Signal<boolean>;
     /**
-     * Calculate aria-description attribute
+     * Calculate aria-describedby attribute value.
+     * If the user explicitly provides aria-describedby (via input or native attribute),
+     * that value is used as-is. Otherwise, auto-generates IDs referencing hidden description spans.
+     * Returns null if no descriptions apply (attribute not set).
      * @hidden
      */
-    protected readonly buttonAriaDescription: _angular_core.Signal<string | null | undefined>;
+    protected readonly ariaDescribedby: _angular_core.Signal<string | null>;
+    /**
+     * Native aria-describedby attribute read from the DOM element.
+     * Captured once during init; signals user intent to manage describedby manually.
+     * @hidden
+     */
+    protected readonly nativeAriaDescribedBy: _angular_core.WritableSignal<string | null>;
+    /**
+     * Effective aria description: explicit input takes precedence over native attribute.
+     * Prioritizes ariaDescription input, falls back to native attribute.
+     * Empty string from ariaDescription is preserved (clears description).
+     * @hidden
+     */
+    protected readonly effectiveAriaDescription: _angular_core.Signal<string | null>;
+    /**
+     * Translated aria description for the current special button type, or null if not special.
+     * @hidden
+     */
+    protected readonly defaultButtonTypeDescription: _angular_core.Signal<string>;
+    /**
+     * Calculate aria-label attribute
+     * @hidden
+     */
+    protected readonly buttonArialabel: _angular_core.Signal<string | null | undefined>;
     /**
      * Computed CSS classes for the button.
      * Built as a string to avoid array allocation overhead.
@@ -320,8 +360,25 @@ declare class ButtonComponent extends BaseButton implements HasElementRef {
      * @hidden
      */
     private readonly _nativeAriaLabel;
+    /**
+     * Native aria-description attribute read from the DOM element.
+     * Captured once after render for use in aria-description computation.
+     * @hidden
+     */
+    private readonly _nativeAriaDescription;
+    /** @hidden Resolves per-key translation signals */
+    private readonly _translate;
+    /** @hidden Translated aria descriptions for each special button type */
+    private readonly _typeDescriptions;
     /** @hidden */
     constructor();
+    /**
+     * Capture native aria-label and aria-description attributes during initialization.
+     * Runs during ngOnInit to ensure attributes are captured before rendering the template.
+     * The native aria-description is removed from the DOM after capture to prevent
+     * duplicate accessibility attributes (ACC-264.1).
+     */
+    ngOnInit(): void;
     /** Forces the focus outline around the button, which is not default behavior in Safari. */
     protected clicked(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;