@daffodil/design 0.92.3 → 0.93.1

package/{tree/index.d.ts → types/daffodil-design-tree.d.ts}

@@ -193,6 +193,8 @@ declare class DaffTreeItemDirective {
     /**
      * Accessibility property, notifying users about whether
      * or not the tree item is open.
+     *
+     * @docs-private
      */
     protected readonly ariaExpanded: _angular_core.Signal<"true" | "false">;
     constructor();

package/{youtube-player/index.d.ts → types/daffodil-design-youtube-player.d.ts}

@@ -4,12 +4,24 @@ import { SafeUrl, DomSanitizer, SafeStyle } from '@angular/platform-browser';
 
 declare class DaffYoutubePlayerComponent implements OnInit {
     private sanitizer;
+    /**
+     * The URL of the YouTube video.
+     */
     src: SafeUrl;
+    /**
+     * The title of the YouTube video.
+     */
     title: string;
     private _width;
+    /**
+     * The width of the player.
+     */
     get width(): number;
     set width(value: number);
     private _height;
+    /**
+     * The height of the player.
+     */
     get height(): number;
     set height(value: number);
     constructor(sanitizer: DomSanitizer);
@@ -17,6 +29,9 @@ declare class DaffYoutubePlayerComponent implements OnInit {
      * @docs-private
      */
     ngOnInit(): void;
+    /**
+     * @docs-private
+     */
     get _aspectRatio(): SafeStyle;
     /**
      * @docs-private

package/{index.d.ts → types/daffodil-design.d.ts}

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnChanges, OnInit, SimpleChanges, InjectionToken, Type, EventEmitter, ChangeDetectorRef, OnDestroy, ElementRef, Renderer2 } from '@angular/core';
+import { OnChanges, OnInit, SimpleChanges, InjectionToken, Type, Signal, EventEmitter, ChangeDetectorRef, OnDestroy, ElementRef, Renderer2 } from '@angular/core';
 import { BreakpointObserver, BreakpointState } from '@angular/cdk/layout';
 import { Observable } from 'rxjs';
 import { DaffPersistenceService } from '@daffodil/core';
@@ -316,6 +316,8 @@ interface DaffTextAlignable {
  */
 type DaffTextAlignment = 'left' | 'center' | 'right';
 /**
+ * @deprecated Deprecated in version 0.93.0. Will be removed in version 0.96.0.
+ *
  * This enum will be removed from the public api in v1.0.0.
  */
 declare enum DaffTextAlignmentEnum {
@@ -443,7 +445,7 @@ declare class DaffArticleEncapsulatedDirective {
 declare enum DaffTheme {
     Light = "light",
     Dark = "dark",
-    None = "none"
+    System = "system"
 }
 
 /**
@@ -496,6 +498,11 @@ declare class DaffThemingService {
      * Get the current theme.
      */
     getTheme(): Observable<DaffTheme>;
+    /**
+     * Get the user's stored theme preference. Emits `DaffTheme.System` when no
+     * preference is stored and the theme follows the operating system.
+     */
+    getThemePreference(): Observable<DaffTheme>;
     /**
      * Set the theme to dark mode.
      */
@@ -505,9 +512,9 @@ declare class DaffThemingService {
      */
     lightMode(): void;
     /**
-     * Switch between themes.
+     * Follow the operating system's theme preference by clearing any stored theme.
      */
-    switchTheme(): void;
+    systemMode(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffThemingService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DaffThemingService>;
 }
@@ -565,23 +572,25 @@ declare class DaffFocusStackService {
 }
 
 /**
- * Interfaces that gives a component the ability to customize sizing for component specific UI.
+ * @deprecated Deprecated in version 0.92.1. Will be removed in version 1.0.0.
  */
 interface DaffSizable<T extends DaffSizeAllType> {
     size: T;
 }
-/**
- * The possible types that can be passed to a component that implements DaffSizable
- */
 type DaffSizeXSmallType = 'xs';
 type DaffSizeSmallType = 'sm';
 type DaffSizeMediumType = 'md';
 type DaffSizeLargeType = 'lg';
 type DaffSizeXLargeType = 'xl';
 /**
- * The a type representing all available sizes.
+ * All available sizes.
  */
 type DaffSizeAllType = DaffSizeXSmallType | DaffSizeSmallType | DaffSizeMediumType | DaffSizeLargeType | DaffSizeXLargeType;
+/**
+ * @deprecated Deprecated in version 0.93.0. Will be removed in version 0.96.0.
+ *
+ * This enum will be removed from the public api in v1.0.0.
+ */
 declare enum DaffSizableEnum {
     XSmall = "xs",
     Small = "sm",
@@ -591,68 +600,15 @@ declare enum DaffSizableEnum {
 }
 
 /**
- * `DaffSizableDirective` allows for dynamic sizing of a component by setting
- * CSS classes based on the specified size.
- *
- * @example Implementing it as an attribute directive
- *
- * ```html
- * <div daffSizable [size]="small">Sized content</div>
- * ```
- * In this example, the `daff-small` class is applied to the `div` element, allowing you to
- * use the class to style the `div`.
- *
- * @example Implementing it as an Angular host directive
- *
- * ```ts
- * @Component({
- *  standalone: true,
- *  selector: 'custom-component',
- *  template: 'custom-component.html',
- *  hostDirectives: [
- *    {
- *      directive: DaffSizableDirective,
- *      inputs: ['size'],
- *    },
- *  ],
- * })
- * export class CustomComponent { }
- * ```
- *
- * ```scss
- * :host {
- *  &.daff-sm {
- *    width: 24px;
- *  }
- *
- *  &.daff-md {
- *    width: 32px;
- *  }
- * }
- * ```
- *
- * The directive applies the following CSS classes to the component based on the size:
- *
- * - `daff-xs`: Applied when the size is `xs`.
- * - `daff-sm`: Applied when the size is `sm`.
- * - `daff-md`: Applied when the size is `md`.
- * - `daff-lg`: Applied when the size is `lg`.
- * - `daff-xl`: Applied when the size is `xl`.
+ * `DaffSizableDirective` enforces consistent use of sizes across components.
  */
-declare class DaffSizableDirective<T extends DaffSizeAllType> implements DaffSizable<T>, OnChanges, OnInit {
+declare class DaffSizableDirective<T extends DaffSizeAllType> implements OnChanges, OnInit {
     /**
      * The size of the component.
      */
     size: T;
     /**
      * Sets a default size.
-     *
-     * @example
-     * ```ts
-     * constructor(private sizableDirective: DaffSizableDirective) {
-     *  this.sizableDirective.defaultSize = 'md';
-     * }
-     * ```
      */
     defaultSize: T;
     /**
@@ -672,7 +628,7 @@ declare class DaffSizableDirective<T extends DaffSizeAllType> implements DaffSiz
  */
 interface DaffOpenable {
     /** Whether a component is open or not */
-    open: boolean;
+    open: Signal<boolean>;
     /** Reveal the component */
     reveal: () => void;
     /** Hide the component */
@@ -728,7 +684,7 @@ interface DaffOpenable {
  */
 declare class DaffOpenableDirective implements DaffOpenable, OnChanges {
     /** Controls whether the component is open. */
-    open: boolean;
+    open: i0.ModelSignal<boolean>;
     private _setOpen;
     /** Whether or not a component should handle state
      *
@@ -761,7 +717,7 @@ declare class DaffOpenableDirective implements DaffOpenable, OnChanges {
      */
     ngOnChanges(changes: SimpleChanges): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffOpenableDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DaffOpenableDirective, "[daffOpenable]", never, { "open": { "alias": "open"; "required": false; }; }, { "toggled": "toggled"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DaffOpenableDirective, "[daffOpenable]", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "toggled": "toggled"; }, never, never, true, never>;
 }
 
 /**
@@ -777,6 +733,8 @@ interface DaffOrientable {
  */
 type DaffOrientation = 'horizontal' | 'vertical';
 /**
+ * @deprecated Deprecated in version 0.93.0. Will be removed in version 0.96.0.
+ *
  * This enum will be removed from the public api in v1.0.0.
  */
 declare enum DaffOrientationEnum {

package/tag/index.d.ts

@@ -1,71 +0,0 @@
-import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
-import * as i0 from '@angular/core';
-import { EventEmitter } from '@angular/core';
-import * as i1 from '@daffodil/design';
-import { DaffSizableDirective, DaffSizeSmallType, DaffSizeMediumType, DaffSizeLargeType, DaffPrefixDirective } from '@daffodil/design';
-
-/**
- * The size types that the DaffTagComponent can implement.
- */
-type DaffTagSize = DaffSizeSmallType | DaffSizeMediumType | DaffSizeLargeType;
-declare class DaffTagSizableDirective extends DaffSizableDirective<DaffTagSize> {
-    static ɵfac: i0.ɵɵFactoryDeclaration<DaffTagSizableDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DaffTagSizableDirective, never, never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Contains the tag content: checkmark icon, label, and delete button.
- *
- * @example
- * ```html
- *  <daff-tag [dismissible]="true" (closeTag)="onCloseTag()">
- *    <fa-icon daffPrefix [icon]="faCircleCheck"></fa-icon>
- *    <div>Label</div>
- *  </daff-tag>
- * ```
- */
-declare class DaffTagComponent {
-    private size;
-    /**
-     * @docs-private
-     */
-    faTimes: _fortawesome_fontawesome_common_types.IconDefinition;
-    /**
-     * @docs-private
-     */
-    _prefix: DaffPrefixDirective;
-    private _disabled;
-    /**
-     * The disabled state of the tag.
-     */
-    get disabled(): any;
-    set disabled(value: any);
-    private _dismissible;
-    /** Whether the tag can be dismissed by the user.
-     * Displays a close icon if `true`.
-     */
-    get dismissible(): any;
-    set dismissible(value: any);
-    /**
-     * Emits when the tag is closed.
-     */
-    closeTag: EventEmitter<void>;
-    /**
-     * @docs-private
-     *
-     * Internal handler for the close icon click.
-     */
-    onCloseTag(event: Event): void;
-    constructor(size: DaffTagSizableDirective);
-    static ɵfac: i0.ɵɵFactoryDeclaration<DaffTagComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DaffTagComponent, "daff-tag", never, { "disabled": { "alias": "disabled"; "required": false; }; "dismissible": { "alias": "dismissible"; "required": false; }; }, { "closeTag": "closeTag"; }, ["_prefix"], ["[daffPrefix]", "*"], true, [{ directive: typeof i1.DaffArticleEncapsulatedDirective; inputs: {}; outputs: {}; }, { directive: typeof DaffTagSizableDirective; inputs: { "size": "size"; }; outputs: {}; }, { directive: typeof i1.DaffColorableDirective; inputs: { "color": "color"; }; outputs: {}; }, { directive: typeof i1.DaffStatusableDirective; inputs: { "status": "status"; }; outputs: {}; }]>;
-}
-
-/**
- * @docs-private
- *
- * `DAFF_TAG_COMPONENTS` imports all the available components and directives.
- */
-declare const DAFF_TAG_COMPONENTS: readonly [typeof DaffTagComponent, typeof DaffTagSizableDirective, typeof DaffPrefixDirective];
-
-export { DAFF_TAG_COMPONENTS, DaffTagComponent, DaffTagSizableDirective };