@daffodil/design 0.83.0 → 0.85.0

package/hero/src/hero-theme.scss

@@ -1,37 +1,52 @@
-@use 'sass:map';
-@use '../../scss/core';
-@use '../../scss/theming';
+@use '../../scss/theming' as *;
 
 @mixin daff-hero-theme-variant($color) {
 	background: $color;
-	color: theming.daff-text-contrast($color);
+	color: daff-text-contrast($color);
 }
 
 @mixin daff-hero-theme($theme) {
-	$primary: core.daff-map-get($theme, primary);
-	$secondary: core.daff-map-get($theme, secondary);
-	$tertiary: core.daff-map-get($theme, tertiary);
-	$neutral: core.daff-map-get($theme, 'core', 'neutral');
-	$base: core.daff-map-get($theme, 'core', 'base');
-	$base-contrast: core.daff-map-get($theme, 'core', 'base-contrast');
-	$white: core.daff-map-get($theme, 'core', 'white');
-	$black: core.daff-map-get($theme, 'core', 'black');
+	$primary: daff-get-palette($theme, primary);
+	$secondary: daff-get-palette($theme, secondary);
+	$tertiary: daff-get-palette($theme, tertiary);
+	$neutral: daff-get-palette($theme, neutral);
+	$base: daff-get-base-color($theme, base);
+	$base-contrast: daff-get-base-color($theme, base-contrast);
+	$white: daff-get-base-color($theme, 'white');
+	$black: daff-get-base-color($theme, 'black');
+	$mode: daff-get-theme-mode($theme);
 
 	.daff-hero {
-		@include daff-hero-theme-variant(
-			theming.daff-illuminate($base, $neutral, 1)
-		);
+		@include light($mode) {
+			@include daff-hero-theme-variant(daff-color($neutral, 10));
 
-		&.daff-primary {
-			@include daff-hero-theme-variant(theming.daff-color($primary));
-		}
+			&.daff-primary {
+				@include daff-hero-theme-variant(daff-color($primary));
+			}
+
+			&.daff-secondary {
+				@include daff-hero-theme-variant(daff-color($secondary));
+			}
 
-		&.daff-secondary {
-			@include daff-hero-theme-variant(theming.daff-color($secondary));
+			&.daff-tertiary {
+				@include daff-hero-theme-variant(daff-color($tertiary));
+			}
 		}
 
-		&.daff-tertiary {
-			@include daff-hero-theme-variant(theming.daff-color($tertiary));
+		@include dark($mode) {
+			@include daff-hero-theme-variant(daff-color($neutral, 90));
+
+			&.daff-primary {
+				@include daff-hero-theme-variant(daff-color($primary, 60));
+			}
+
+			&.daff-secondary {
+				@include daff-hero-theme-variant(daff-color($secondary, 60));
+			}
+
+			&.daff-tertiary {
+				@include daff-hero-theme-variant(daff-color($tertiary, 60));
+			}
 		}
 
 		&.daff-theme {

package/input/README.md

@@ -0,0 +1,66 @@
+# Input
+The input component allows a native HTML input element to work with the form field component.
+
+## Overview
+The input component has the same functionality as a native HTML `<input>` element, with additional custom styling and functionality. It **cannot** be used by itself and must be contained within a [DaffFormFieldComponent](/libs/design/src/atoms/form/form-field/README.md).
+
+<design-land-example-viewer-container example="input-with-form-field"></design-land-example-viewer-container>
+
+## Usage
+
+### Within a standalone component
+To use form field in a standalone component, import `DaffInputComponent` directly into your custom component:
+
+```ts
+import { DaffInputComponent } from '@daffodil/design/input';
+
+@Component({
+  selector: 'custom-component',
+  templateUrl: './custom-component.component.html',
+  imports: [
+    DaffInputComponent,
+  ],
+})
+export class CustomComponent {}
+```
+
+### Within a module (deprecated)
+To use form field in a module, import `DaffInputModule` into your custom module:
+
+```ts
+import { NgModule } from '@angular/core';
+import { DaffInputModule } from '@daffodil/design/input';
+import { CustomComponent } from './custom.component';
+
+@NgModule({
+	declarations: [
+    CustomComponent,
+  ],
+  exports: [
+    CustomComponent,
+  ],
+  imports: [
+    DaffInputModule,
+  ],
+})
+export class CustomComponentModule { }
+```
+
+> This method is deprecated. It's recommended to update all custom components to standalone.
+
+## Examples
+
+### Disabled input
+The input in this example is disabled using the native HTML disabled attribute.
+
+<design-land-example-viewer-container example="input-disabled"></design-land-example-viewer-container>
+
+### Input with error messages
+The input in this example uses the `ReactiveFormsModule` to display errors.
+
+<design-land-example-viewer-container example="input-error"></design-land-example-viewer-container>
+
+### Input with hint
+The input in this example has a hint.
+
+<design-land-example-viewer-container example="input-hint"></design-land-example-viewer-container>

package/input/examples/examples.d.ts

@@ -1,2 +1,2 @@
-import { BasicInputComponent } from './basic-input/basic-input.component';
-export declare const INPUT_EXAMPLES: (typeof BasicInputComponent)[];
+import { InputHintComponent } from './input-hint/input-hint.component';
+export declare const INPUT_EXAMPLES: (typeof InputHintComponent)[];

package/input/examples/input-disabled/input-disabled.component.d.ts

@@ -1,5 +1,7 @@
+import { UntypedFormControl } from '@angular/forms';
 import * as i0 from "@angular/core";
 export declare class InputDisabledComponent {
+    disabled: UntypedFormControl;
     static ɵfac: i0.ɵɵFactoryDeclaration<InputDisabledComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<InputDisabledComponent, "input-disabled", never, {}, {}, never, never, true, never>;
 }

package/input/examples/input-hint/input-hint.component.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class InputHintComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<InputHintComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InputHintComponent, "input-hint", never, {}, {}, never, never, true, never>;
+}

package/input/examples/input-hint-and-error/input-hint-and-error.component.d.ts

@@ -0,0 +1,9 @@
+import { UntypedFormControl } from '@angular/forms';
+import * as i0 from "@angular/core";
+export declare class InputHintAndErrorComponent {
+    faCheck: import("@fortawesome/fontawesome-common-types").IconDefinition;
+    faXmark: import("@fortawesome/fontawesome-common-types").IconDefinition;
+    control: UntypedFormControl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InputHintAndErrorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InputHintAndErrorComponent, "input-hint-and-error", never, {}, {}, never, never, true, never>;
+}

package/input/examples/input-with-form-field/input-with-form-field.component.d.ts

@@ -1,5 +1,7 @@
 import * as i0 from "@angular/core";
 export declare class InputWithFormFieldComponent {
+    faUser: import("@fortawesome/fontawesome-common-types").IconDefinition;
+    faCircleXmark: import("@fortawesome/fontawesome-common-types").IconDefinition;
     static ɵfac: i0.ɵɵFactoryDeclaration<InputWithFormFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<InputWithFormFieldComponent, "input-with-form-field", never, {}, {}, never, never, true, never>;
 }

package/input/index.d.ts

@@ -0,0 +1 @@
+export * from './public_api';

package/{atoms/form/input → input}/input.component.d.ts

@@ -1,35 +1,31 @@
-import { ElementRef } from '@angular/core';
+import { ElementRef, OnInit } from '@angular/core';
 import { NgControl } from '@angular/forms';
-import { DaffFormFieldControl } from '../form-field/form-field-control';
+import { DaffFormFieldControl } from '@daffodil/design';
 import * as i0 from "@angular/core";
 /**
  * DaffInputComponent provides the same functionality as a native `<input>` and contains custom styling and functionality.
  */
-export declare class DaffInputComponent implements DaffFormFieldControl {
-    /**
-     * @docs-private
-     */
+export declare class DaffInputComponent extends DaffFormFieldControl<string> implements DaffFormFieldControl<string>, OnInit {
+    /** @docs-private */
     ngControl: NgControl;
     private _elementRef;
-    /**
-     * Has the form been submitted.
-     */
-    formSubmitted: boolean;
+    /** @docs-private */
+    class: boolean;
+    /** @docs-private */
+    controlType: string;
     focused: boolean;
-    /**
-     * @docs-private
-     */
+    /** @docs-private */
     focus(): void;
-    /**
-     * @docs-private
-     */
+    /** @docs-private */
     blur(): void;
     constructor(
-    /**
-     * @docs-private
-     */
+    /** @docs-private */
     ngControl: NgControl, _elementRef: ElementRef<HTMLInputElement>);
+    /** @docs-private */
+    ngOnInit(): void;
+    /** @docs-private */
     onFocus(): void;
+    get value(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffInputComponent, [{ optional: true; self: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DaffInputComponent, "input[daff-input]", never, { "formSubmitted": { "alias": "formSubmitted"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DaffInputComponent, "input[daff-input]", never, {}, {}, never, ["*"], true, never>;
 }

package/input/input.module.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./input.component";
+/**
+ * @deprecated in favor of standalone components. Deprecated in version 0.84.0. Will be removed in version 1.0.0.
+ */
+export declare class DaffInputModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DaffInputModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<DaffInputModule, never, [typeof i1.DaffInputComponent], [typeof i1.DaffInputComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<DaffInputModule>;
+}

package/list/list/list.component.d.ts

@@ -22,7 +22,7 @@ export declare class DaffListComponent {
      *
      * @docs-private
      */
-    get role(): "list" | "navigation";
+    get role(): "navigation" | "list";
     private _getHostElement;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffListComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DaffListComponent, "daff-list,daff-nav-list", never, {}, {}, never, ["*"], true, [{ directive: typeof i1.DaffArticleEncapsulatedDirective; inputs: {}; outputs: {}; }]>;

package/list/src/list-theme.scss

@@ -1,28 +1,11 @@
-@use 'sass:map';
-@use '../../scss/core';
-@use '../../scss/theming';
+@use '../../scss/theming' as *;
 
 // styleline-disable selector-class-pattern
 @mixin daff-list-theme($theme) {
-	$neutral: core.daff-map-get($theme, 'core', 'neutral');
-	$base: core.daff-map-get($theme, 'core', 'base');
-	$base-contrast: core.daff-map-get($theme, 'core', 'base-contrast');
-
-	.daff-list {
-		.daff-list-item {
-			&__content {
-				// stylelint-disable-next-line scss/selector-nest-combinators
-				*:nth-child(1) {
-					color: $base-contrast;
-				}
-
-				// stylelint-disable-next-line scss/selector-nest-combinators
-				*:nth-child(n + 2) {
-					color: theming.daff-illuminate($base-contrast, $neutral, 3);
-				}
-			}
-		}
-	}
+	$neutral: daff-get-palette($theme, neutral);
+	$base: daff-get-base-color($theme, base);
+	$base-contrast: daff-get-base-color($theme, base-contrast);
+	$mode: daff-get-theme-mode($theme);
 
 	.daff-nav-list {
 		.daff-list-item {
@@ -30,10 +13,21 @@
 				background-color: $base;
 			}
 
-			&:hover,
-			&.active {
-				&::after {
-					background-color: theming.daff-illuminate($base, $neutral, 2);
+			@include light($mode) {
+				&:hover,
+				&.active {
+					&::after {
+						background-color: rgba(daff-color($neutral, 20), 0.5);
+					}
+				}
+			}
+
+			@include dark($mode) {
+				&:hover,
+				&.active {
+					&::after {
+						background-color: rgba(daff-color($neutral, 20), 0.08);
+					}
 				}
 			}
 		}

package/loading-icon/src/loading-icon-theme.scss

@@ -1,6 +1,4 @@
-@use 'sass:map';
-@use '../../scss/core';
-@use '../../scss/theming';
+@use '../../scss/theming' as *;
 
 @mixin daff-loading-icon-light-variant($loader-color) {
 	.daff-loading-icon__loader {
@@ -23,34 +21,34 @@
 }
 
 @mixin daff-loading-icon-theme($theme) {
-	$primary: core.daff-map-get($theme, primary);
-	$secondary: core.daff-map-get($theme, secondary);
-	$tertiary: core.daff-map-get($theme, tertiary);
-	$base: core.daff-map-get($theme, 'core', 'base');
-	$base-contrast: core.daff-map-get($theme, 'core', 'base-contrast');
-	$white: core.daff-map-get($theme, 'core', 'white');
-	$black: core.daff-map-get($theme, 'core', 'black');
-	$neutral: core.daff-map-get($theme, 'core', 'neutral');
-	$type: core.daff-map-get($theme, 'core', 'type');
+	$primary: daff-get-palette($theme, primary);
+	$secondary: daff-get-palette($theme, secondary);
+	$tertiary: daff-get-palette($theme, tertiary);
+	$base: daff-get-base-color($theme, base);
+	$base-contrast: daff-get-base-color($theme, base-contrast);
+	$white: daff-get-base-color($theme, 'white');
+	$black: daff-get-base-color($theme, 'black');
+	$neutral: daff-get-palette($theme, neutral);
+	$mode: daff-get-theme-mode($theme);
 
 	.daff-loading-icon {
-		@include theming.light($type) {
+		@include light($mode) {
 			@include daff-loading-icon-light-variant(
-				theming.daff-color($neutral, 60)
+				daff-color($neutral, 60)
 			);
 
 			&.daff-primary {
-				@include daff-loading-icon-light-variant(theming.daff-color($primary));
+				@include daff-loading-icon-light-variant(daff-color($primary));
 			}
 
 			&.daff-secondary {
 				@include daff-loading-icon-light-variant(
-					theming.daff-color($secondary)
+					daff-color($secondary)
 				);
 			}
 
 			&.daff-tertiary {
-				@include daff-loading-icon-light-variant(theming.daff-color($tertiary));
+				@include daff-loading-icon-light-variant(daff-color($tertiary));
 			}
 
 			&.daff-theme {
@@ -70,19 +68,19 @@
 			}
 		}
 
-		@include theming.dark($type) {
-			@include daff-loading-icon-dark-variant(theming.daff-color($neutral, 40));
+		@include dark($mode) {
+			@include daff-loading-icon-dark-variant(daff-color($neutral, 40));
 
 			&.daff-primary {
-				@include daff-loading-icon-dark-variant(theming.daff-color($primary));
+				@include daff-loading-icon-dark-variant(daff-color($primary));
 			}
 
 			&.daff-secondary {
-				@include daff-loading-icon-dark-variant(theming.daff-color($secondary));
+				@include daff-loading-icon-dark-variant(daff-color($secondary));
 			}
 
 			&.daff-tertiary {
-				@include daff-loading-icon-dark-variant(theming.daff-color($tertiary));
+				@include daff-loading-icon-dark-variant(daff-color($tertiary));
 			}
 
 			&.daff-theme {

package/media-gallery/media-gallery/media-gallery.component.d.ts

@@ -17,10 +17,6 @@ import * as i1 from "@daffodil/design";
  */
 export declare class DaffMediaGalleryComponent implements DaffMediaGalleryRegistration {
     private skeletonDirective;
-    /**
-     * @docs-private
-     */
-    role: string;
     /**
      * The internal ID of the gallery.
      */

package/media-gallery/src/media-gallery-theme.scss

@@ -1,31 +1,29 @@
-@use 'sass:map';
-@use '../../scss/theming';
-@use '../../scss/core';
+@use '../../scss/theming' as *;
 
 @mixin daff-media-gallery-theme($theme) {
-	$neutral: core.daff-map-get($theme, 'core', 'neutral');
-	$white: core.daff-map-get($theme, 'core', 'white');
-	$type: core.daff-map-get($theme, 'core', 'type');
+	$neutral: daff-get-palette($theme, neutral);
+	$white: daff-get-base-color($theme, 'white');
+	$mode: daff-get-theme-mode($theme);
 
 	.daff-media-gallery {
 		$root: &;
 
-		@include theming.light($type) {
+		@include light($mode) {
 			.daff-thumbnail {
-				background: theming.daff-color($neutral, 20);
+				background: daff-color($neutral, 20);
 
 				&.daff-selected {
-					border: 1px solid theming.daff-color($neutral);
+					border: 1px solid daff-color($neutral);
 				}
 			}
 		}
 
-		@include theming.dark($type) {
+		@include dark($mode) {
 			.daff-thumbnail {
-				background: theming.daff-color($neutral, 70);
+				background: daff-color($neutral, 70);
 
 				&.daff-selected {
-					border: 1px solid theming.daff-color($neutral, 30);
+					border: 1px solid daff-color($neutral, 30);
 				}
 			}
 		}

package/menu/helpers/create-overlay.d.ts

@@ -1,3 +1,3 @@
 import { Overlay, OverlayConfig } from '@angular/cdk/overlay';
 import { ElementRef } from '@angular/core';
-export declare function daffMenuCreateOverlay(overlay: Overlay, element: ElementRef, config?: OverlayConfig): import("@angular/cdk/overlay").OverlayRef;
+export declare function daffMenuCreateOverlay(overlay: Overlay, element: ElementRef, config?: OverlayConfig): import("@angular/cdk/overlay-module.d-B3qEQtts").b;

package/menu/menu/menu.component.d.ts

@@ -7,12 +7,27 @@ export declare class DaffMenuComponent implements AfterContentInit, AfterViewIni
     private _ngZone;
     private _elementRef;
     private menuService;
+    /**
+     * @docs-private
+     */
     class: boolean;
+    /**
+     * @docs-private
+     */
     tabindex: number;
+    /**
+     * @docs-private
+     */
     role: string;
     private _focusTrap;
     constructor(_focusTrapFactory: ConfigurableFocusTrapFactory, _ngZone: NgZone, _elementRef: ElementRef<HTMLElement>, menuService: DaffMenuService);
+    /**
+     * @docs-private
+     */
     ngAfterContentInit(): void;
+    /**
+     * @docs-private
+     */
     ngAfterViewInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffMenuComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DaffMenuComponent, "daff-menu", never, {}, {}, never, ["[daff-menu-item]"], true, never>;

package/menu/menu-activator/menu-activator.component.d.ts

@@ -7,6 +7,9 @@ export declare class DaffMenuActivatorDirective implements OnDestroy {
     private cdRef;
     private _destroyed$;
     private _open;
+    /**
+     * @docs-private
+     */
     get openClass(): boolean;
     daffMenuActivator: Type<unknown> | TemplateRef<unknown>;
     constructor(service: DaffMenuService, viewContainerRef: ViewContainerRef, cdRef: ChangeDetectorRef);

package/menu/src/menu-theme.scss

@@ -1,25 +1,43 @@
-@use '../../scss/core';
-@use '../../scss/theming';
+@use '../../scss/theming' as *;
 
 @mixin daff-menu-theme($theme) {
-	$white: core.daff-map-get($theme, 'core', 'white');
-	$black: core.daff-map-get($theme, 'core', 'black');
-	$neutral: core.daff-map-get($theme, 'core', 'neutral');
-	$base: core.daff-map-get($theme, 'core', 'base');
-	$base-contrast: core.daff-map-get($theme, 'core', 'base-contrast');
+	$black: daff-get-base-color($theme, 'black');
+	$neutral: daff-get-palette($theme, neutral);
+	$base: daff-get-base-color($theme, base);
+	$base-contrast: daff-get-base-color($theme, base-contrast);
+	$mode: daff-get-theme-mode($theme);
 
-	.daff-menu {
-		background: $base;
-		box-shadow: 0 0 24px rgb($black, 0.12);
+	@include light($mode) {
+		.daff-menu {
+			background: $base;
+			box-shadow: 0 0 24px rgb($black, 0.12);
+		}
+
+		.daff-menu-item {
+			background: $base;
+			color: $base-contrast;
+
+			&:hover,
+			&:focus {
+				background: rgba(daff-color($neutral, 20), 0.5);
+			}
+		}
 	}
 
-	.daff-menu-item {
-		background: $base;
-		color: $base-contrast;
+	@include dark($mode) {
+		.daff-menu {
+			background: $base;
+			box-shadow: 0 0 24px rgb($black, 0.12);
+		}
+
+		.daff-menu-item {
+			background: $base;
+			color: $base-contrast;
 
-		&:hover,
-		&:focus {
-			background: theming.daff-illuminate($base, $neutral, 1);
+			&:hover,
+			&:focus {
+				background: rgba(daff-color($neutral, 20), 0.08);
+			}
 		}
 	}
 }

package/modal/modal/modal.component.d.ts

@@ -14,14 +14,23 @@ export declare class DaffModalComponent implements AfterContentInit, AfterViewIn
     /**
      * Sets a class of .daff-modal to the host element.
      */
+    /**
+     * @docs-private
+     */
     modalClass: boolean;
     /**
      * Sets the role to dialog.
      */
+    /**
+     * @docs-private
+     */
     role: string;
     /**
      * Sets aria-modal to true.
      */
+    /**
+     * @docs-private
+     */
     ariaModal: boolean;
     private _ariaLabelledBy;
     /**
@@ -29,6 +38,9 @@ export declare class DaffModalComponent implements AfterContentInit, AfterViewIn
      * {@link DaffModalTitleDirective} when it is used.
      *
      */
+    /**
+     * @docs-private
+     */
     get ariaLabelledBy(): string;
     set ariaLabelledBy(value: string);
     /**
@@ -49,13 +61,22 @@ export declare class DaffModalComponent implements AfterContentInit, AfterViewIn
     onEscape(): void;
     private _focusTrap;
     constructor(modalService: DaffModalService, _focusTrapFactory: ConfigurableFocusTrapFactory, elementRef: ElementRef<HTMLElement>, openDirective: DaffOpenableDirective);
+    /**
+     * @docs-private
+     */
     ngAfterContentInit(): void;
+    /**
+     * @docs-private
+     */
     ngAfterViewInit(): void;
     /**
      * Helper method to attach portable content to modal.
      */
     attachContent(portal: ComponentPortal<any>): any;
     /** Animation hook that controls the entrance and exit animations of the modal. */
+    /**
+     * @docs-private
+     */
     get fadeState(): string;
     /**
      * Animation event that can used to hook into when

package/modal/modal-actions/modal-actions.component.d.ts

@@ -1,5 +1,8 @@
 import * as i0 from "@angular/core";
 export declare class DaffModalActionsComponent {
+    /**
+     * @docs-private
+     */
     class: boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffModalActionsComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DaffModalActionsComponent, "daff-modal-actions", never, {}, {}, never, ["*"], true, never>;

package/modal/modal-close/modal-close.directive.d.ts

@@ -18,6 +18,9 @@ export declare class DaffModalCloseDirective {
     /**
      * Sets the button type attribute to button.
      */
+    /**
+     * @docs-private
+     */
     typeAttribute: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffModalCloseDirective, [null, { optional: true; }]>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<DaffModalCloseDirective, "button[daffModalClose]", never, {}, {}, never, never, true, never>;

package/modal/modal-content/modal-content.component.d.ts

@@ -1,5 +1,8 @@
 import * as i0 from "@angular/core";
 export declare class DaffModalContentComponent {
+    /**
+     * @docs-private
+     */
     class: boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<DaffModalContentComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DaffModalContentComponent, "daff-modal-content", never, {}, {}, never, ["*"], true, never>;