@aurodesignsystem/auro-formkit 1.6.0-beta.4

package/components/dropdown/.turbo/turbo-build.log

@@ -0,0 +1,206 @@
+
+> @auro-formkit/auro-dropdown@3.0.0 build
+> run-s build:version build:sass bundler build:docs types
+
+
+> @auro-formkit/auro-dropdown@3.0.0 build:version
+> node ./src/scripts/version.mjs
+
+Found package.json at: /home/runner/work/auro-formkit/auro-formkit/node_modules/@aurodesignsystem/auro-icon/package.json
+Writing version file to: ./src/iconVersion.js
+Successfully wrote version file for @aurodesignsystem/auro-icon
+
+> @auro-formkit/auro-dropdown@3.0.0 build:sass
+> sass --no-source-map --load-path=../../node_modules "./src/styles/:./src/styles/"
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+   ╷
+10 │ @import "@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables";
+   │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   ╵
+    src/styles/bibColors.scss 10:9  root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+   ╷
+10 │ @import "@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables";
+   │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   ╵
+    src/styles/bibStyles.scss 10:9  root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+  ╷
+6 │ @import '@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables';
+  │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  ╵
+    src/styles/color.scss 6:9  root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+   ╷
+10 │ @import "@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables";
+   │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   ╵
+    src/styles/style.scss 10:9  root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+   ╷
+11 │ @import '@aurodesignsystem/webcorestylesheets/src/breakpoints';
+   │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   ╵
+    src/styles/style.scss 11:9  root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+  ╷
+6 │ @import './libSupport/deprecated';
+  │         ^^^^^^^^^^^^^^^^^^^^^^^^^
+  ╵
+    @aurodesignsystem/webcorestylesheets/src/_breakpoints.scss 6:9  @import
+    src/styles/style.scss 11:9                                      root stylesheet
+
+DEPRECATION WARNING: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.
+
+More info and automated migrator: https://sass-lang.com/d/import
+
+  ╷
+1 │ @import '@aurodesignsystem/design-tokens/dist/tokens/SCSSVariables';
+  │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  ╵
+    src/styles/tokens.scss 1:9  root stylesheet
+
+
+> @auro-formkit/auro-dropdown@3.0.0 bundler
+> rollup -c node:@auro-formkit/config/rollup
+
+
+./src/index.js → dist...
+created dist in 1.3s
+
+./demo/index.js → ./demo/...
+created ./demo/ in 928ms
+
+./demo/api.js → ./demo/...
+created ./demo/ in 783ms
+
+> @auro-formkit/auro-dropdown@3.0.0 build:docs
+> wca analyze 'scripts/wca/*.js' --outFiles docs/api.md; node ../../packages/build-tools/src/docProcessor.mjs --component dropdown
+
+Web Component Analyzer analyzing 1 file...
+Retrieving latest "/home/runner/work/auro-formkit/auro-formkit/components/dropdown/docTemplates/README.md" file...
+✔ /README.md Updated
+ Transforms run
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/browserSupport.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentInstall_esm.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/designTokens.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentImportDescription.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentImport.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/bundleInstallDescription.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/bundleUseModBrowsers.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/developmentDescription.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/localhost.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/api.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/testing.md 
+  ⁕ REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/bundles.md 
+  ⁕ FILE:src=./docs/partials/description.md 
+  ⁕ FILE:src=./docs/partials/readmeAddlInfo.md 
+  ⁕ FILE:src=./docs/partials/useCases.md 
+  ⁕ CODE:src=./apiExamples/basic.html 
+  ⁕ CODE:src=./apiExamples/basic.html 
+
+✔ /demo/index.md Updated
+ Transforms run
+  ⁕ FILE:src=./../docs/partials/description.md 
+  ⁕ FILE:src=./../docs/partials/useCases.md 
+  ⁕ FILE:src=./../apiExamples/common.html 
+  ⁕ FILE:src=./../apiExamples/commonLabelledby.html 
+  ⁕ FILE:src=./../apiExamples/commonSlot.html 
+  ⁕ FILE:src=./../apiExamples/widerPopover.html 
+  ⁕ FILE:src=./../apiExamples/commonMatchWidth.html 
+  ⁕ FILE:src=./../apiExamples/custom.html 
+  ⁕ CODE:src=./../apiExamples/common.html 
+  ⁕ CODE:src=./../apiExamples/commonLabelledby.html 
+  ⁕ CODE:src=./../apiExamples/commonSlot.html 
+  ⁕ CODE:src=./../apiExamples/widerPopover.html 
+  ⁕ CODE:src=./../apiExamples/commonMatchWidth.html 
+  ⁕ CODE:src=./../apiExamples/custom.html 
+
+✔ /demo/api.md Updated
+ Transforms run
+  ⁕ FILE:src=./../docs/api.md 
+  ⁕ FILE:src=./../apiExamples/basic.html 
+  ⁕ FILE:src=./../apiExamples/basicIcon.html 
+  ⁕ FILE:src=./../apiExamples/basicButton.html 
+  ⁕ FILE:src=./../apiExamples/basicInput.html 
+  ⁕ FILE:src=./../apiExamples/bordered.html 
+  ⁕ FILE:src=./../apiExamples/chevron.html 
+  ⁕ FILE:src=./../apiExamples/chevronIcon.html 
+  ⁕ FILE:src=./../apiExamples/chevronButton.html 
+  ⁕ FILE:src=./../apiExamples/chevronInput.html 
+  ⁕ FILE:src=./../apiExamples/disabled.html 
+  ⁕ FILE:src=./../apiExamples/disabledAll.html 
+  ⁕ FILE:src=./../apiExamples/error.html 
+  ⁕ FILE:src=./../apiExamples/errorBordered.html 
+  ⁕ FILE:src=./../apiExamples/inset.html 
+  ⁕ FILE:src=./../apiExamples/insetBordered.html 
+  ⁕ FILE:src=./../apiExamples/rounded.html 
+  ⁕ FILE:src=./../apiExamples/noToggle.html 
+  ⁕ FILE:src=./../apiExamples/customDimensions300.html 
+  ⁕ FILE:src=./../apiExamples/label.html 
+  ⁕ FILE:src=./../apiExamples/helpText.html 
+  ⁕ FILE:src=./../apiExamples/helpTextError.html 
+  ⁕ FILE:src=./../apiExamples/programmaticallyShow.html 
+  ⁕ FILE:src=./../apiExamples/programmaticallyHide.html 
+  ⁕ FILE:src=./../apiExamples/customDimensions100.html 
+  ⁕ FILE:src=./../apiExamples/truncatedText.html 
+  ⁕ FILE:src=./../apiExamples/inDialog.html 
+  ⁕ CODE:src=./../apiExamples/basic.html 
+  ⁕ CODE:src=./../apiExamples/basicIcon.html 
+  ⁕ CODE:src=./../apiExamples/basicButton.html 
+  ⁕ CODE:src=./../apiExamples/basicInput.html 
+  ⁕ CODE:src=./../apiExamples/bordered.html 
+  ⁕ CODE:src=./../apiExamples/chevron.html 
+  ⁕ CODE:src=./../apiExamples/chevronIcon.html 
+  ⁕ CODE:src=./../apiExamples/chevronButton.html 
+  ⁕ CODE:src=./../apiExamples/chevronInput.html 
+  ⁕ CODE:src=./../apiExamples/disabled.html 
+  ⁕ CODE:src=./../apiExamples/disabledAll.html 
+  ⁕ CODE:src=./../apiExamples/error.html 
+  ⁕ CODE:src=./../apiExamples/errorBordered.html 
+  ⁕ CODE:src=./../apiExamples/inset.html 
+  ⁕ CODE:src=./../apiExamples/insetBordered.html 
+  ⁕ CODE:src=./../apiExamples/rounded.html 
+  ⁕ CODE:src=./../apiExamples/noToggle.html 
+  ⁕ CODE:src=./../apiExamples/customDimensions300.html 
+  ⁕ CODE:src=./../apiExamples/label.html 
+  ⁕ CODE:src=./../apiExamples/helpText.html 
+  ⁕ CODE:src=./../apiExamples/helpTextError.html 
+  ⁕ CODE:src=./../apiExamples/programmaticallyShow.html 
+  ⁕ CODE:src=./../apiExamples/programmaticallyShow.js 
+  ⁕ CODE:src=./../apiExamples/programmaticallyHide.html 
+  ⁕ CODE:src=./../apiExamples/customDimensions100.html 
+  ⁕ CODE:src=./../apiExamples/truncatedText.html 
+  ⁕ CODE:src=./../apiExamples/inDialog.html 
+  ⁕ CODE:src=./../apiExamples/inDialog.js 
+  ⁕ CODE:src=./../src/styles/tokens.scss 
+
+Docs processed successfully for dropdown
+
+> @auro-formkit/auro-dropdown@3.0.0 types
+> tsc --project tsconfig.json
+

package/components/dropdown/.turbo/turbo-bundler.log

@@ -0,0 +1,13 @@
+
+> @auro-formkit/auro-dropdown@3.0.0 bundler
+> rollup -c node:@auro-formkit/config/rollup
+
+
+./src/index.js → dist...
+created dist in 1.1s
+
+./demo/index.js → ./demo/...
+created ./demo/ in 900ms
+
+./demo/api.js → ./demo/...
+created ./demo/ in 704ms

package/components/dropdown/.turbo/turbo-postCss$colon$component.log

@@ -0,0 +1,5 @@
+
+> @auro-formkit/auro-dropdown@3.0.0 postCss:component
+> node ../../node_modules/@aurodesignsystem/auro-library/scripts/build/postCss.mjs
+
+Unable to scan directory: Error: ENOENT: no such file or directory, scandir '/home/runner/work/auro-formkit/auro-formkit/node_modules/@aurodesignsystem/auro-library/scripts/src'

package/components/dropdown/.turbo/turbo-sass$colon$render.log

@@ -0,0 +1,34 @@
+
+> @auro-formkit/auro-dropdown@3.0.0 sass:render
+> sass-render --load-path=../../node_modules 'src/**/*.css' -t ../../node_modules/@aurodesignsystem/auro-library/scripts/build/staticStyles-template.js
+
+Rendering src/styles/bibColors.css...
+Rendering src/styles/bibStyles.css...
+Rendering src/styles/color.css...
+Rendering src/styles/style.css...
+Rendering src/styles/tokens.css...
+DEPRECATION WARNING: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.
+
+More info: https://sass-lang.com/d/legacy-js-api
+
+DEPRECATION WARNING: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.
+
+More info: https://sass-lang.com/d/legacy-js-api
+
+DEPRECATION WARNING: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.
+
+More info: https://sass-lang.com/d/legacy-js-api
+
+DEPRECATION WARNING: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.
+
+More info: https://sass-lang.com/d/legacy-js-api
+
+DEPRECATION WARNING: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.
+
+More info: https://sass-lang.com/d/legacy-js-api
+
+Complete!
+Complete!
+Complete!
+Complete!
+Complete!

package/components/dropdown/.turbo/turbo-types.log

@@ -0,0 +1,4 @@
+
+> @auro-formkit/auro-dropdown@3.0.0 types
+> tsc --project tsconfig.json
+

package/components/dropdown/README.md

@@ -0,0 +1,188 @@
+<!--
+The README.md file is a compiled document. No edits should be made directly to this file.
+
+README.md is created by running `npm run build:docs`.
+
+This file is generated based on a template fetched from
+`https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/README_updated_paths.md`
+and copied to `./componentDocs/README.md` each time the the docs are compiled.
+
+The following sections are editable by making changes to the following files:
+
+| SECTION                | DESCRIPTION                                       | FILE LOCATION                       |
+|------------------------|---------------------------------------------------|-------------------------------------|
+| Description            | Description of the component                      | `./docs/partials/description.md`    |
+| Use Cases              | Examples for when to use this component           | `./docs/partials/useCases.md`       |
+| Additional Information | For use to add any component specific information | `./docs/partials/readmeAddlInfo.md` |
+| Component Example Code | HTML sample code of the components use            | `./apiExamples/basic.html`          |
+-->
+
+# Formkit/auro-dropdown
+
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/description.md) -->
+<!-- The below content is automatically added from ./docs/partials/description.md -->
+The `auro-dropdown` component is a trigger and dropdown element combination intended to be used with dropdown content that is interactive. `auro-dropdown` is content agnostic and any valid HTML can be placed in either the trigger or the dropdown.
+
+_Note: if the dropdown content in your implementation is not interactive (e.g. a tooltip) [auro-popover](http://auro.alaskaair.com/components/auro/popover) may better serve your needs._
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/readmeAddlInfo.md) -->
+<!-- The below content is automatically added from ./docs/partials/readmeAddlInfo.md -->
+<!-- AURO-GENERATED-CONTENT This file is to be used for any additional content that should be included in the README.md which is specific to this component. -->
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## UI development browser support
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/browserSupport.md) -->
+For the most up to date information on [UI development browser support](https://auro.alaskaair.com/support/browsersSupport)
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## Install
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentInstall_esm.md) -->
+[![Build Status](https://img.shields.io/github/actions/workflow/status/AlaskaAirlines/-formkit/-formkit/auro-dropdown/testPublish.yml?style=for-the-badge)](https://github.com/AlaskaAirlines/-formkit/-formkit/auro-dropdown/actions/workflows/testPublish.yml)
+[![See it on NPM!](https://img.shields.io/npm/v/@auro-formkit/-formkit/-formkit/auro-dropdown?style=for-the-badge&color=orange)](https://www.npmjs.com/package/@auro-formkit/-formkit/-formkit/auro-dropdown)
+[![License](https://img.shields.io/npm/l/@auro-formkit/-formkit/-formkit/auro-dropdown?color=blue&style=for-the-badge)](https://www.apache.org/licenses/LICENSE-2.0)
+![ESM supported](https://img.shields.io/badge/ESM-compatible-FFE900?style=for-the-badge)
+
+```shell
+$ npm i @auro-formkit/-formkit/-formkit/auro-dropdown
+```
+
+Installing as a direct, dev or peer dependency is up to the user installing the package. If you are unsure as to what type of dependency you should use, consider reading this [stack overflow](https://stackoverflow.com/questions/18875674/whats-the-difference-between-dependencies-devdependencies-and-peerdependencies) answer.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Design Token CSS Custom Property dependency
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/designTokens.md) -->
+The use of any Auro custom element has a dependency on the [Auro Design Tokens](https://auro.alaskaair.com/getting-started/developers/design-tokens).
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Define dependency in project component
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentImportDescription.md) -->
+Defining the component dependency within each component that is using the `<-formkit/-formkit/auro-dropdown>` component.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentImport.md) -->
+
+```js
+import "@auro-formkit/-formkit/-formkit/auro-dropdown";
+```
+
+<!-- AURO-GENERATED-CONTENT:END -->
+**Reference component in HTML**
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./apiExamples/basic.html) -->
+<!-- The below code snippet is automatically added from ./apiExamples/basic.html -->
+
+```html
+<auro-dropdown aria-label="custom label">
+  Lorem ipsum solar
+  <div slot="trigger">
+    Trigger
+  </div>
+</auro-dropdown>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## Install bundled assets from CDN
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/bundleInstallDescription.md) -->
+In cases where the project is not able to process JS assets, there are pre-processed assets available for use. See -- `-formkit/-formkit/auro-dropdown__bundled.js` for modern browsers. Legacy browsers such as IE11 are no longer supported.
+
+**WARNING!** When installing into your application environment, DO NOT use `@latest` for the requested version. Risks include unknown MAJOR version releases and instant adoption of any new features and possible bugs without developer knowledge. The `@latest` wildcard should NEVER be used for production customer-facing applications. You have been warned.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Bundle example code
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/bundleUseModBrowsers.md) -->
+
+```html
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@4.9.2/dist/tokens/CSSCustomProperties.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@5.1.2/dist/bundled/essentials.css" />
+<script src="https://cdn.jsdelivr.net/npm/@auro-formkit/-formkit/-formkit/auro-dropdown@3.0.0/dist/-formkit/-formkit/auro-dropdown__bundled.js" type="module"></script>
+```
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## auro-formkit/auro-dropdown use cases
+
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/useCases.md) -->
+<!-- The below content is automatically added from ./docs/partials/useCases.md -->
+The `auro-dropdown` element should be used in situations where users may:
+
+* interact with an element to get clarification on content offering
+* provide definition to iconic imagery
+* when interactive help is required
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## API Code Examples
+
+### Default auro-formkit/auro-dropdown
+
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./apiExamples/basic.html) -->
+<!-- The below code snippet is automatically added from ./apiExamples/basic.html -->
+
+```html
+<auro-dropdown aria-label="custom label">
+  Lorem ipsum solar
+  <div slot="trigger">
+    Trigger
+  </div>
+</auro-dropdown>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## Development
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/developmentDescription.md) -->
+In order to develop against this project, if you are not part of the core team, you will be required to fork the project prior to submitting a pull request.
+
+Please be sure to review the [contribution guidelines](https://auro.alaskaair.com/contributing) for this project. Please make sure to **pay special attention** to the **conventional commits** section of the document.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Start development environment
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/localhost.md) -->
+Once the project has been cloned to your local resource and you have installed all the dependencies you will need to open a shell session to run the **dev server**.
+
+```shell
+$ npm run dev
+```
+
+Open [localhost:8000](http://localhost:8000/)
+
+If running separate sessions is preferred, please run the following commands in individual terminal shells.
+
+```shell
+$ npm run build:watch
+
+$ npm run serve
+```
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### API generation
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/api.md) -->
+The custom element API file is generated in the build and committed back to the repo with a version change. If the API doc has changed without a version change, author's are to run `npm run build:api` to generate the doc and commit to version control.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Testing
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/testing.md) -->
+Automated tests are required for every Auro component. See `.\test\-formkit/-formkit/auro-dropdown.test.js` for the tests for this component. Run `npm test` to run the tests and check code coverage. Tests must pass and meet a certain coverage threshold to commit. See [the testing documentation](https://auro.alaskaair.com/support/tests) for more details.
+
+<!-- AURO-GENERATED-CONTENT:END -->
+
+### Bundled assets
+
+<!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/development/bundles.md) -->
+Bundled assets are only generated in the remote and not merged back to this repo. To review and/or test a bundled asset locally, run `$ npm run bundler` to generate assets.
+
+<!-- AURO-GENERATED-CONTENT:END -->

package/components/dropdown/demo/api.html

@@ -0,0 +1,53 @@
+<!--
+  Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
+  See LICENSE in the project root for license information.
+
+  HTML in this document is standardized and NOT to be edited.
+  All demo code should be added/edited in ./demo/index.md
+
+  With the exception of adding custom elements if needed for the demo.
+
+  ----------------------- DO NOT EDIT -----------------------------
+
+-->
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Auro Web Component Generator | auro-dropdown custom element</title>
+    <link
+      rel="stylesheet"
+      type="text/css"
+      href="https://cdn.jsdelivr.net/npm/prismjs@1.24.1/themes/prism.css"
+    />
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/tokens/CSSCustomProperties.css">
+    <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/demoWrapper.css" />
+    <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/elementDemoStyles.css" />
+  </head>
+  <body class="auro-markdown">
+    <main></main>
+
+    <script type="module">
+      import 'https://cdn.jsdelivr.net/npm/marked@latest/marked.min.js';
+      import 'https://cdn.jsdelivr.net/npm/prismjs@latest/prism.js';
+      fetch('./api.md')
+        .then((response) => response.text())
+        .then((text) => {
+          const rawHtml = marked.parse(text);
+          document.querySelector('main').innerHTML = rawHtml;
+          Prism.highlightAll();
+        })
+    </script>
+    <script type="module">
+      import { initExamples } from "./api.min.js";
+
+      initExamples();
+    </script>
+    <!-- If additional elements are needed for the demo, add them here. -->
+    <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-accordion@latest/dist/auro-accordion__bundled.js" type="module"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-button@latest/dist/auro-button__bundled.js" type="module"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-dialog@latest/dist/auro-dialog__bundled.js" type="module"></script>
+  </body>
+</html>

package/components/dropdown/demo/api.js

@@ -0,0 +1,21 @@
+/* eslint-disable jsdoc/require-jsdoc, no-magic-numbers */
+import { showExample } from './../apiExamples/programmaticallyShow.js';
+import { hideExample } from './../apiExamples/programmaticallyHide.js';
+import { inDialogExample } from '../apiExamples/inDialog.js';
+import '../src/index.js';
+
+export function initExamples(initialCount = 0) {
+  try {
+    // javascript example function calls to be added here upon creation to test examples
+    showExample();
+    hideExample();
+    inDialogExample();
+  } catch (err) {
+    if (initialCount <= 20) {
+      // setTimeout handles issue where content is sometimes loaded after the functions get called
+      setTimeout(() => {
+        initExamples(initialCount + 1);
+      }, 100);
+    }
+  }
+}