@aurodesignsystem/auro-formkit 2.1.0-beta.5 → 2.1.0-beta.6

package/components/combobox/dist/registered.js

@@ -3341,12 +3341,17 @@ class AuroDropdown extends LitElement {
     this.disabled = false;
     this.error = false;
     this.inset = false;
-    this.placement = 'bottom-start';
     this.rounded = false;
     this.tabIndex = 0;
     this.noToggle = false;
     this.labeled = true;
 
+    // floaterConfig
+    this.placement = 'bottom-start';
+    this.offset = 0;
+    this.noFlip = false;
+    this.autoPlacement = false;
+
     /**
      * @private
      */
@@ -3367,16 +3372,6 @@ class AuroDropdown extends LitElement {
      */
     this.floater = new AuroFloatingUI();
 
-    /**
-     * @private
-     */
-    this.floaterConfig = {
-      placement: 'bottom-start',
-      flip: true,
-      autoPlacement: false,
-      offset: 0,
-    };
-
     /**
      * Generate unique names for dependency components.
      */
@@ -3398,6 +3393,18 @@ class AuroDropdown extends LitElement {
     this.helpTextTag = versioning.generateTag('auro-formkit-dropdown-helptext', helpTextVersion$1, AuroHelpText$1);
   }
 
+  /**
+   * @ignore
+   */
+  get floaterConfig() {
+    return {
+      placement: this.placement,
+      flip: !this.noFlip,
+      autoPlacement: this.autoPlacement,
+      offset: this.offset,
+    };
+  }
+
   /**
    * Public method to hide the dropdown.
    * @returns {void}
@@ -3418,6 +3425,15 @@ class AuroDropdown extends LitElement {
   static get properties() {
     return {
 
+      /**
+       * If declared, bib's position will be automatically calculated where to appear.
+       * @default false
+       */
+      autoPlacement: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * If declared, applies a border around the trigger slot.
        */
@@ -3502,7 +3518,7 @@ class AuroDropdown extends LitElement {
        */
       isBibFullscreen: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       },
 
       /**
@@ -3545,6 +3561,16 @@ class AuroDropdown extends LitElement {
         reflect: true
       },
 
+      /**
+       * If declared, the bib will NOT flip to an alternate position
+       * when there isn't enough space in the specified `placement`.
+       * @default false
+       */
+      noFlip: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * If declared, the dropdown will not hide when moving focus outside the element.
        */
@@ -3561,16 +3587,32 @@ class AuroDropdown extends LitElement {
         reflect: true
       },
 
+      /**
+       * Gap between the trigger element and bib.
+       * @default 0
+       */
+      offset: {
+        type: Number,
+        reflect: true
+      },
+
       onSlotChange: {
         type: Function,
         reflect: false
       },
 
       /**
-       * @private
+       * Position where the bib should appear relative to the trigger.
+       * Accepted values:
+       * "top" | "right" | "bottom" | "left" |
+       * "bottom-start" | "top-start" | "top-end" |
+       * "right-start" | "right-end" | "bottom-end" |
+       * "left-start" | "left-end"
+       * @default bottom-start
        */
       placement: {
-        type: String
+        type: String,
+        reflect: true
       },
 
       /**
@@ -11572,11 +11614,11 @@ class AuroBibtemplate extends LitElement {
     return {
       isFullscreen: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       },
       large: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       }
     };
   }
@@ -11825,6 +11867,12 @@ class AuroCombobox extends LitElement {
 
     this.isHiddenWhileLoading = false;
 
+    // floaterConfig
+    this.placement = 'bottom-start';
+    this.offset = 0;
+    this.noFlip = false;
+    this.autoPlacement = false;
+
     const versioning = new AuroDependencyVersioning$4();
 
     this.dropdownTag = versioning.generateTag('auro-formkit-checkbox-dropdown', dropdownVersion, AuroDropdown);
@@ -11841,12 +11889,21 @@ class AuroCombobox extends LitElement {
 
       /**
        * An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete="off"` is supported.
+       * @default false
        */
       autocomplete: {
         type: String,
         reflect: true
       },
 
+      /**
+       * If declared, bib's position will be automatically calculated where to appear.
+       */
+      autoPlacement: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * When attribute is present auro-menu will apply checkmarks to selected options.
        */
@@ -11879,6 +11936,16 @@ class AuroCombobox extends LitElement {
         reflect: true
       },
 
+      /**
+       * If declared, the bib will NOT flip to an alternate position
+       * when there isn't enough space in the specified `placement`.
+       * @default false
+       */
+      noFlip: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * If set, disables auto-validation on blur.
        */
@@ -11886,6 +11953,15 @@ class AuroCombobox extends LitElement {
         type: Boolean
       },
 
+      /**
+       * Gap between the trigger element and bib.
+       * @default 0
+       */
+      offset: {
+        type: Number,
+        reflect: true
+      },
+
       /**
        * Specifies the current selected option.
        */
@@ -11895,6 +11971,20 @@ class AuroCombobox extends LitElement {
         hasChanged: arrayOrUndefinedHasChanged
       },
 
+      /**
+       * Position where the bib should appear relative to the trigger.
+       * Accepted values:
+       * "top" | "right" | "bottom" | "left" |
+       * "bottom-start" | "top-start" | "top-end" |
+       * "right-start" | "right-end" | "bottom-end" |
+       * "left-start" | "left-end"
+       * @default bottom-start
+       */
+      placement: {
+        type: String,
+        reflect: true
+      },
+
       /**
        * Populates the `required` attribute on the input. Used for client-side validation.
        */
@@ -12662,6 +12752,10 @@ class AuroCombobox extends LitElement {
           .fullscreenBreakpoint="${this.fullscreenBreakpoint}"
           ?disabled="${this.disabled}"
           ?error="${this.validity !== undefined && this.validity !== 'valid'}"
+          .placement="${this.placement}"
+          .offset="${this.offset}"
+          ?autoPlacement="${this.autoPlacement}"
+          ?noFlip="${this.noFlip}"
           disableEventShow>
           <${this.inputTag}
             slot="trigger"

package/components/counter/README.md

@@ -110,7 +110,7 @@ The use of any Auro custom element has a dependency on the [Auro Design Tokens](
 In cases where the project is not able to process JS assets, there are pre-processed assets available for use. Legacy browsers such as IE11 are no longer supported.
 
 ```html
-<script type="module "src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-formkit@2.1.0-beta.4/auro-counter/+esm"></script>
+<script type="module "src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-formkit@2.1.0-beta.5/auro-counter/+esm"></script>
 ```
 <!-- AURO-GENERATED-CONTENT:END -->
 

package/components/counter/demo/api.md

@@ -38,16 +38,20 @@
 
 ## Properties
 
-| Property                  | Attribute                 | Type      | Default     | Description                                      |
-|---------------------------|---------------------------|-----------|-------------|--------------------------------------------------|
-| [fullscreenBreakpoint](#fullscreenBreakpoint)    | `fullscreenBreakpoint`    | `string`  | "sm"        | Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile.<br />When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint. |
-| [isDropdown](#isDropdown)              | `isDropdown`              | `boolean` | false       | Indicates if the counter group is displayed as a dropdown. |
-| [largeFullscreenHeadline](#largeFullscreenHeadline) | `largeFullscreenHeadline` | `boolean` |             | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600 |
-| [max](#max)                     | `max`                     | `number`  | "undefined" | The maximum value allowed for the whole group of counters. |
-| [min](#min)                     | `min`                     | `number`  | "undefined" | The minimum value allowed for the whole group of counters. |
-| [total](#total)                   | `total`                   | `number`  | "undefined" | The total value of the counters.                 |
-| [validity](#validity)                | `validity`                | `string`  | "undefined" | Reflects the validity state.                     |
-| [value](#value)                   | `value`                   | `object`  | "undefined" | The current individual values of the nested counters. |
+| Property                  | Attribute                 | Type      | Default        | Description                                      |
+|---------------------------|---------------------------|-----------|----------------|--------------------------------------------------|
+| [autoPlacement](#autoPlacement)           | `autoPlacement`           | `boolean` | "false"        | If declared, bib's position will be automatically calculated where to appear. |
+| [fullscreenBreakpoint](#fullscreenBreakpoint)    | `fullscreenBreakpoint`    | `string`  | "sm"           | Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile.<br />When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint. |
+| [isDropdown](#isDropdown)              | `isDropdown`              | `boolean` | false          | Indicates if the counter group is displayed as a dropdown. |
+| [largeFullscreenHeadline](#largeFullscreenHeadline) | `largeFullscreenHeadline` | `boolean` |                | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600 |
+| [max](#max)                     | `max`                     | `number`  | "undefined"    | The maximum value allowed for the whole group of counters. |
+| [min](#min)                     | `min`                     | `number`  | "undefined"    | The minimum value allowed for the whole group of counters. |
+| [noFlip](#noFlip)                  | `noFlip`                  | `boolean` | "false"        | If declared, the bib will NOT flip to an alternate position<br />when there isn't enough space in the specified `placement`. |
+| [offset](#offset)                  | `offset`                  | `number`  | "0"            | Gap between the trigger element and bib.         |
+| [placement](#placement)               | `placement`               | `string`  | "bottom-start" | Position where the bib should appear relative to the trigger.<br />Accepted values:<br />"top" \| "right" \| "bottom" \| "left" \|<br />"bottom-start" \| "top-start" \| "top-end" \|<br />"right-start" \| "right-end" \| "bottom-end" \|<br />"left-start" \| "left-end" |
+| [total](#total)                   | `total`                   | `number`  | "undefined"    | The total value of the counters.                 |
+| [validity](#validity)                | `validity`                | `string`  | "undefined"    | Reflects the validity state.                     |
+| [value](#value)                   | `value`                   | `object`  | "undefined"    | The current individual values of the nested counters. |
 
 ## Methods
 
@@ -389,6 +393,105 @@ You can also individually set the max or min value for each counter in a group.
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
 
+### Customized bib position
+The bib position can be customized with `placement`, `offset`, `flip`, `autoPlacement` attributes.
+
+- `placement` specifies the preferred position where the bib should appear relative to the trigger.
+- `offset` sets the distance between the trigger and the bib.
+- When `autoPlacement` is enabled, smart positioning logic is applied to determine the best placement for the bib. If all sides have sufficient space, the bib will appear in the position specified by `placement`.
+- Unless `noFlip` is enabled, if there isn't enough space for the preferred `placement`, the bib will automatically flip to an alternative position.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/floaterConfig.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/floaterConfig.html -->
+  <div style="width: 350px">
+    <auro-counter-group isDropdown offset="20" placement="bottom-end">
+      <div slot="bib.fullscreen.headline">Passengers</div>
+      <div slot="label">bottome-end bib with 20px offset</div>
+      <auro-counter>
+        Adults
+        <span slot="description">18 years or older</span>
+      </auro-counter>
+      <auro-counter>
+        Children
+        <span slot="description">2-17 years</span>
+      </auro-counter>
+    </auro-counter-group>
+    <auro-counter-group isDropdown offset="20" placement="bottom-end" noFlip>
+      <div slot="bib.fullscreen.headline">Passengers</div>
+      <div slot="label">bottome-end bib with 20px offset and noFlip</div>
+      <auro-counter>
+        Adults
+        <span slot="description">18 years or older</span>
+      </auro-counter>
+      <auro-counter>
+        Children
+        <span slot="description">2-17 years</span>
+      </auro-counter>
+    </auro-counter-group>
+    <auro-counter-group isDropdown offset="20" placement="right" noFlip autoPlacement>
+      <div slot="bib.fullscreen.headline">Passengers</div>
+      <div slot="label">right bib with 20px offset, noFlip and autoPlacement</div>
+      <auro-counter>
+        Adults
+        <span slot="description">18 years or older</span>
+      </auro-counter>
+      <auro-counter>
+        Children
+        <span slot="description">2-17 years</span>
+      </auro-counter>
+    </auro-counter-group>
+  </div>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/floaterConfig.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/floaterConfig.html -->
+
+```html
+<div style="width: 350px">
+  <auro-counter-group isDropdown offset="20" placement="bottom-end">
+    <div slot="bib.fullscreen.headline">Passengers</div>
+    <div slot="label">bottome-end bib with 20px offset</div>
+    <auro-counter>
+      Adults
+      <span slot="description">18 years or older</span>
+    </auro-counter>
+    <auro-counter>
+      Children
+      <span slot="description">2-17 years</span>
+    </auro-counter>
+  </auro-counter-group>
+  <auro-counter-group isDropdown offset="20" placement="bottom-end" noFlip>
+    <div slot="bib.fullscreen.headline">Passengers</div>
+    <div slot="label">bottome-end bib with 20px offset and noFlip</div>
+    <auro-counter>
+      Adults
+      <span slot="description">18 years or older</span>
+    </auro-counter>
+    <auro-counter>
+      Children
+      <span slot="description">2-17 years</span>
+    </auro-counter>
+  </auro-counter-group>
+  <auro-counter-group isDropdown offset="20" placement="right" noFlip autoPlacement>
+    <div slot="bib.fullscreen.headline">Passengers</div>
+    <div slot="label">right bib with 20px offset, noFlip and autoPlacement</div>
+    <auro-counter>
+      Adults
+      <span slot="description">18 years or older</span>
+    </auro-counter>
+    <auro-counter>
+      Children
+      <span slot="description">2-17 years</span>
+    </auro-counter>
+  </auro-counter-group>
+</div>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
 ### Dropdown with fullscreen bib
 
 You can make the dropdown open in fullscreen at a specific breakpoint by setting `fullscreenBreakpoint`.

package/components/counter/demo/api.min.js

@@ -4867,12 +4867,17 @@ class AuroDropdown extends r {
     this.disabled = false;
     this.error = false;
     this.inset = false;
-    this.placement = 'bottom-start';
     this.rounded = false;
     this.tabIndex = 0;
     this.noToggle = false;
     this.labeled = true;
 
+    // floaterConfig
+    this.placement = 'bottom-start';
+    this.offset = 0;
+    this.noFlip = false;
+    this.autoPlacement = false;
+
     /**
      * @private
      */
@@ -4893,16 +4898,6 @@ class AuroDropdown extends r {
      */
     this.floater = new AuroFloatingUI();
 
-    /**
-     * @private
-     */
-    this.floaterConfig = {
-      placement: 'bottom-start',
-      flip: true,
-      autoPlacement: false,
-      offset: 0,
-    };
-
     /**
      * Generate unique names for dependency components.
      */
@@ -4924,6 +4919,18 @@ class AuroDropdown extends r {
     this.helpTextTag = versioning.generateTag('auro-formkit-dropdown-helptext', helpTextVersion, AuroHelpText);
   }
 
+  /**
+   * @ignore
+   */
+  get floaterConfig() {
+    return {
+      placement: this.placement,
+      flip: !this.noFlip,
+      autoPlacement: this.autoPlacement,
+      offset: this.offset,
+    };
+  }
+
   /**
    * Public method to hide the dropdown.
    * @returns {void}
@@ -4944,6 +4951,15 @@ class AuroDropdown extends r {
   static get properties() {
     return {
 
+      /**
+       * If declared, bib's position will be automatically calculated where to appear.
+       * @default false
+       */
+      autoPlacement: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * If declared, applies a border around the trigger slot.
        */
@@ -5028,7 +5044,7 @@ class AuroDropdown extends r {
        */
       isBibFullscreen: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       },
 
       /**
@@ -5071,6 +5087,16 @@ class AuroDropdown extends r {
         reflect: true
       },
 
+      /**
+       * If declared, the bib will NOT flip to an alternate position
+       * when there isn't enough space in the specified `placement`.
+       * @default false
+       */
+      noFlip: {
+        type: Boolean,
+        reflect: true
+      },
+
       /**
        * If declared, the dropdown will not hide when moving focus outside the element.
        */
@@ -5087,16 +5113,32 @@ class AuroDropdown extends r {
         reflect: true
       },
 
+      /**
+       * Gap between the trigger element and bib.
+       * @default 0
+       */
+      offset: {
+        type: Number,
+        reflect: true
+      },
+
       onSlotChange: {
         type: Function,
         reflect: false
       },
 
       /**
-       * @private
+       * Position where the bib should appear relative to the trigger.
+       * Accepted values:
+       * "top" | "right" | "bottom" | "left" |
+       * "bottom-start" | "top-start" | "top-end" |
+       * "right-start" | "right-end" | "bottom-end" |
+       * "left-start" | "left-end"
+       * @default bottom-start
        */
       placement: {
-        type: String
+        type: String,
+        reflect: true
       },
 
       /**
@@ -6263,11 +6305,11 @@ class AuroBibtemplate extends r {
     return {
       isFullscreen: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       },
       large: {
         type: Boolean,
-        reflect: true,
+        reflect: true
       }
     };
   }
@@ -6481,6 +6523,25 @@ class AuroCounterGroup extends r {
   static get properties() {
     return {
 
+      /**
+       * If declared, bib's position will be automatically calculated where to appear.
+       * @default false
+       */
+      autoPlacement: {
+        type: Boolean,
+        reflect: true
+      },
+
+      /**
+       * Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile.
+       * When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint.
+       * @default sm
+       */
+      fullscreenBreakpoint: {
+        type: String,
+        reflect: true
+      },
+
       /**
        * Indicates if the counter group is displayed as a dropdown.
        */
@@ -6505,45 +6566,68 @@ class AuroCounterGroup extends r {
       },
 
       /**
-       * Reflects the validity state.
+       * If declared, make bib.fullscreen.headline in HeadingDisplay.
+       * Otherwise, Heading 600
        */
-      validity: {
-        type: String,
-        reflect: true,
+      largeFullscreenHeadline: {
+        type: Boolean,
+        reflect: true
       },
 
       /**
-       * The total value of the counters.
+       * If declared, the bib will NOT flip to an alternate position
+       * when there isn't enough space in the specified `placement`.
+       * @default false
        */
-      total: {
-        type: Number,
+      noFlip: {
+        type: Boolean,
+        reflect: true
       },
 
       /**
-       * The current individual values of the nested counters.
+       * Gap between the trigger element and bib.
+       * @default 0
        */
-      value: {
-        type: Object,
+      offset: {
+        type: Number,
+        reflect: true
       },
 
       /**
-       * If declared, make bib.fullscreen.headline in HeadingDisplay.
-       * Otherwise, Heading 600
+       * Position where the bib should appear relative to the trigger.
+       * Accepted values:
+       * "top" | "right" | "bottom" | "left" |
+       * "bottom-start" | "top-start" | "top-end" |
+       * "right-start" | "right-end" | "bottom-end" |
+       * "left-start" | "left-end"
+       * @default bottom-start
        */
-      largeFullscreenHeadline: {
-        type: Boolean,
+      placement: {
+        type: String,
         reflect: true
       },
 
       /**
-       * Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile.
-       * When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint.
-       * @default sm
+       * The total value of the counters.
        */
-      fullscreenBreakpoint: {
+      total: {
+        type: Number,
+      },
+
+      /**
+       * Reflects the validity state.
+       */
+      validity: {
         type: String,
-        reflect: true
-      }
+        reflect: true,
+      },
+
+      /**
+       * The current individual values of the nested counters.
+       */
+      value: {
+        type: Object,
+      },
     };
   }
 
@@ -6786,7 +6870,12 @@ class AuroCounterGroup extends r {
   render() {
     return u`
     ${this.isDropdown
-      ? u`<${this.dropdownTag} common chevron fullscreenBreakpoint="${this.fullscreenBreakpoint}">
+      ? u`<${this.dropdownTag} common chevron
+        .fullscreenBreakpoint="${this.fullscreenBreakpoint}"
+        .placement="${this.placement}"
+        .offset="${this.offset}"
+        ?autoPlacement="${this.autoPlacement}"
+        ?noFlip="${this.noFlip}">
         <div slot="trigger"><slot name="valueText">
           ${this.counters && Array.from(this.counters).map((counter, index) => `${counter.value} ${counter.defaultSlot}${index !== this.counters.length - 1 ? ', ' : ''}`)}
         </slot></div>