@lion/ui 0.16.1 → 0.17.0-menu-system.1

package/docs/guides/how-to/create-a-custom-field.md

@@ -87,9 +87,9 @@ if (!customElements.get('dummy-slider')) {
 }
 ```
 
-Custom Fields can be created in just a few steps. All you need is an interaction element (like for instance a slider, a listbox or a combobox) and connect it to the [LionField](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/components/input/overview.md).
+Custom Fields can be created in just a few steps. All you need is an interaction element (like for instance a slider, a listbox or a combobox) and connect it to the [LionField](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/components/input/overview.md).
 
-> In case you want to extend a native element, follow [Extend a native Input](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/extend-a-native-input.md).
+> In case you want to extend a native element, follow [Extend a native Input](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/extend-a-native-input.md).
 
 ## A) an interaction element
 
@@ -138,7 +138,7 @@ export const createAnInteractiveElement = () => {
 ## B) your LionField extension
 
 Now we want to integrate the slider in our form system to enrich the user interface, get
-validation support and all other [benefits of LionField](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/components/input/overview.md).
+validation support and all other [benefits of LionField](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/components/input/overview.md).
 We start by creating a component `<slider-field>` that extends from `LionField`.
 Then we follow the steps below:
 
@@ -151,7 +151,7 @@ Then we follow the steps below:
 
   The `user-input-changed` event is listened to by the FormatMixin: it should be regarded as the
   equivalent of the `input` event of the platform, but for custom built interaction elements.
-  You now synchronized [modelValue](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/fundamentals/systems/form/model-value.md), which can be regarded as
+  You now synchronized [modelValue](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/fundamentals/systems/form/model-value.md), which can be regarded as
   the glue to integrate all other functionality like parsing/formatting/serializing, validating,
   tracking interaction states etc.
 
@@ -159,7 +159,7 @@ Then we follow the steps below:
 > because those properties will lose their reactivity (they won't be considered anymore in the
 > update loop of LitElement).
 > Whenever a .modelValue/.formattedValue/.serializedValue needs to be computed, use
-> [parser/formatter/serializer](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/fundamentals/systems/form/formatting-and-parsing.md)
+> [parser/formatter/serializer](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/fundamentals/systems/form/formatting-and-parsing.md)
 
 Implement with the following code:
 

package/docs/guides/how-to/create-a-form.md

@@ -39,7 +39,7 @@ Large or complex forms might need to be split up into multiple files. This compo
 
 In the latter case: make sure that your components don't have a shadow root. This can be achieved by rendering into Light DOM. The form registration mechanism relies on light dom by design: as soon as you do start to use shadow roots, you will notice that your form components won't register themselves anymore to their parents.
 
-> Today, rendering to light dom is the only way to [stay accessible](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/fundamentals/rationales/accessibility.md#shadow-roots-and-accessibility).
+> Today, rendering to light dom is the only way to [stay accessible](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/fundamentals/rationales/accessibility.md#shadow-roots-and-accessibility).
 
 ### Example of a component that renders into Light DOM
 
@@ -86,7 +86,7 @@ Extending form components is not recommended for Application Developers: it shou
 This team will add the styling and default configuration needed to make it fit the particular Design System.
 
 With the toolbox provided by the team that creates your Design System, you should be able to build all your forms. Only if you have a really good reason, look into
-[exceptional cases](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/#exceptional-cases) below.
+[exceptional cases](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/#exceptional-cases) below.
 
 ### Exceptional cases
 
@@ -94,8 +94,8 @@ If the form component you need is still missing, you have two options:
 
 - is it a generic primitive that should be part of Lion? Request it in [Lion discussions](https://github.com/ing-bank/lion/discussions)
 - is it a non generic component that is unique to your app?
-  - follow [create a custom field](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/create-a-custom-field.md)
-  - follow [extend a native input](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/extend-a-native-input.md)
+  - follow [create a custom field](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/create-a-custom-field.md)
+  - follow [extend a native input](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/extend-a-native-input.md)
 
 It's also possible to extend other components, like LionListbox or LionCombobox. You need to be aware that you're building on top of protected apis.
 Changing/overriding functionality is only recommended if the source code in `form-core` is fully understood.

package/docs/guides/how-to/extend-a-native-input.md

@@ -23,9 +23,9 @@ import '../../fundamentals/systems/form/assets/h-output.js';
 loadDefaultFeedbackMessages();
 ```
 
-Input fields can be created by extending [LionInput](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/components/input/overview.md).
+Input fields can be created by extending [LionInput](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/components/input/overview.md).
 
-> In case you want to wrap a custom form element, follow [Create a custom Field](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/create-a-custom-field.md).
+> In case you want to wrap a custom form element, follow [Create a custom Field](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/create-a-custom-field.md).
 
 For this tutorial, we create an input that wraps native `input[type=datetime-local]`.
 This is as simple as adding a type:

package/docs/guides/how-to/index.md

@@ -9,3 +9,17 @@ eleventyNavigation:
 ---
 
 # How To
+
+Welcome to the How To section. Here you'll find practical, step-by-step guides for common tasks when working with Lion Web Components.
+
+Whether you're just getting started with Lion, building your first form, extending existing components, or creating custom fields, this section provides clear instructions and best practices to help you succeed. Each guide is designed to walk you through the process with real-world examples and code samples.
+
+**Browse the guides below to:**
+
+- Set up your development environment and get started with Lion
+- Learn how to create accessible and well-structured forms
+- Discover how to extend native input components
+- Build custom form fields tailored to your needs
+- Follow proven patterns and best practices used by the Lion community
+
+If you can't find what you're looking for, check out our [Fundamentals](../../fundamentals/) section for deeper conceptual knowledge, or visit our [Components](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/components) documentation for detailed API references.

package/docs/guides/index.md

@@ -22,9 +22,9 @@ Developers consuming our web components inside an application (not extending the
 `Application Developers` are only allowed to interact with `public` properties and methods.
 Can be abbreviated as `AD`. Sometimes also called `Consuming Developer`.
 
-- [Definitions and Terms](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/definitions-and-terms.md)
-- [Styling](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/styling.md)
-- [Scoped Elements](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/scoped-elements.md)
+- [Definitions and Terms](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/definitions-and-terms.md)
+- [Styling](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/styling.md)
+- [Scoped Elements](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/scoped-elements.md)
 
 ## Extending Developer
 
@@ -32,13 +32,13 @@ Developers extending our web components, for instance: `class MaterialInput exte
 
 Especially for subclassers we have some extra documentation:
 
-- [Subclasser APIs](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/subclasser-apis.md)
-- [Extend documentation](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/blog/extending-documentation.md)
+- [Subclasser APIs](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/subclasser-apis.md)
+- [Extend documentation](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/blog/extending-documentation.md)
 
 ## How To
 
 Next to that we have some specific "How To" documentations.
 
-- [Get started](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/get-started.md)
-- [Create a custom field](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/create-a-custom-field.md)
-- [Extend a native input](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/how-to/extend-a-native-input.md)
+- [Get started](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/get-started.md)
+- [Create a custom field](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/create-a-custom-field.md)
+- [Extend a native input](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/how-to/extend-a-native-input.md)

package/docs/guides/principles/index.md

@@ -22,9 +22,9 @@ Developers consuming our web components inside an application (not extending the
 `Application Developers` are only allowed to interact with `public` properties and methods.
 Can be abbreviated as `AD`. Sometimes also called `Consuming Developer`.
 
-- [Definitions and Terms](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/definitions-and-terms.md)
-- [Styling](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/styling.md)
-- [Scoped Elements](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/scoped-elements.md)
+- [Definitions and Terms](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/definitions-and-terms.md)
+- [Styling](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/styling.md)
+- [Scoped Elements](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/scoped-elements.md)
 
 ## Extending Developer
 
@@ -32,5 +32,5 @@ Developers extending our web components, for instance: `class MaterialInput exte
 
 Especially for subclassers we have some extra documentation:
 
-- [Subclasser APIs](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/subclasser-apis.md)
-- [Extend documentation](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/blog/extending-documentation.md)
+- [Subclasser APIs](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/subclasser-apis.md)
+- [Extend documentation](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/blog/extending-documentation.md)

package/docs/guides/principles/styling.md

@@ -23,7 +23,6 @@ Functional styling can be divided into defaults for `basic layout` and `accessib
 Examples for both categories can be found below:
 
 - Basic layout examples:
-
   - A dropdown menu has `position: absolute;`.
   - A lion-button might behave as an `display: inline-block;` element.
   - A suffix attached to an input is horizontally positioned (instead of vertically stacked).
@@ -31,7 +30,7 @@ Examples for both categories can be found below:
 - Accessibility examples:
   - Content (for instance a caption in a table) can be `visually hidden`: it will be
     readable by screen readers, but invisible for end users.
-  - When an html table is used, we allow [subclassers](https://github.com/ing-bank/lion/blob/e45f5c198ccac32dc5c3fd5db6a9fc9fc3595c35/docs/guides/principles/subclasser-apis.md) to override the display property (`table-cell`) to `flex`. By putting the proper accessible roles (`role="cell"`) in the markup, we guarantee our markup stays accessible.
+  - When an html table is used, we allow [subclassers](https://github.com/ing-bank/lion/blob/800791cbc9a0c2191fd0ab6d934aa09eb012356c/docs/guides/principles/subclasser-apis.md) to override the display property (`table-cell`) to `flex`. By putting the proper accessible roles (`role="cell"`) in the markup, we guarantee our markup stays accessible.
 
 Although Lion components try to stay as unbiased as possible with regard to styling, defaults will be needed. In these cases we try to follow the platform as much as possible. If the platform doesn't provide defaults, the largest common denominator across existing UI systems is taken as a lead.
 

package/exports/collapsible.js

@@ -1 +1,2 @@
 export { LionCollapsible } from '../components/collapsible/src/LionCollapsible.js';
+// export { DisclosureMixin } from '../components/collapsible/src/DisclosureMixin.js';

package/exports/define/lion-item.js

@@ -0,0 +1,3 @@
+import { LionItem } from '../menu.js';
+
+customElements.define('lion-item', LionItem);

package/exports/define/lion-menu-overlay.js

@@ -0,0 +1,3 @@
+import { LionMenuOverlay } from '../menu.js';
+
+customElements.define('lion-menu-overlay', LionMenuOverlay);

package/exports/define/lion-menu.js

@@ -0,0 +1,3 @@
+import { LionMenu } from '../menu.js';
+
+customElements.define('lion-menu', LionMenu);

package/exports/define/lion-navigation-bar.js

@@ -0,0 +1,3 @@
+import { LionNavigationBar } from '../navigation-bar.js';
+
+customElements.define('lion-navigation-bar', LionNavigationBar);

package/exports/define/lion-toolbar.js

@@ -0,0 +1,3 @@
+import { LionToolbar } from '../menu.js';
+
+customElements.define('lion-toolbar', LionToolbar);

package/exports/define/lion-tree.js

@@ -0,0 +1,3 @@
+import { LionTree } from '../menu.js';
+
+customElements.define('lion-tree', LionTree);

package/exports/menu.js

@@ -0,0 +1,6 @@
+export { LionMenu } from '../components/menu/src/LionMenu.js';
+export { LionMenuOverlay } from '../components/menu/src/LionMenuOverlay.js';
+export { LionTree } from '../components/menu/src/LionTree.js';
+export { LionToolbar } from '../components/menu/src/LionToolbar.js';
+export { LionItem, LionMenuitem } from '../components/menu/src/InteractiveListMixin.js';
+export { LionMenuHybrid } from '../components/menu/src/LionMenuHybrid.js';

package/exports/navigation-bar.js

@@ -0,0 +1 @@
+export { LionNavigationBar } from '../components/navigation-bar/src/LionNavigationBar.js';

package/exports/overlays.js

@@ -8,6 +8,8 @@ export { withBottomSheetConfig } from '../components/overlays/src/configurations
 export { withModalDialogConfig } from '../components/overlays/src/configurations/withModalDialogConfig.js';
 export { withDropdownConfig } from '../components/overlays/src/configurations/withDropdownConfig.js';
 export { withTooltipConfig } from '../components/overlays/src/configurations/withTooltipConfig.js';
+export { withClickInteraction } from '../components/overlays/src/configurations/visibility-trigger-partials/withClickInteraction.js';
+export { withHoverInteraction } from '../components/overlays/src/configurations/visibility-trigger-partials/withHoverInteraction.js';
 
 export { deepContains } from '../components/overlays/src/utils/deep-contains.js';
 // re-export via this entrypoint for backwards compatibility
@@ -19,3 +21,7 @@ export {
 } from '../components/overlays/src/utils/inert-siblings.js';
 
 export { overlays } from '../components/overlays/src/singleton.js';
+
+/**
+ * @typedef {import('../components/overlays/types/OverlayConfig.js').OverlayConfig} OverlayConfig
+ */

package/exports/types/overlays.ts

@@ -1,4 +1,5 @@
 export { OverlayConfig } from '../../components/overlays/types/OverlayConfig.js';
+export { OverlayPhase } from '../../components/overlays/types/OverlayConfig.js';
 export { ViewportConfig } from '../../components/overlays/types/OverlayConfig.js';
 export { ViewportPlacement } from '../../components/overlays/types/OverlayConfig.js';
 export { DefineOverlayConfig } from '../../components/overlays/types/OverlayMixinTypes.js';

package/menu.js

@@ -0,0 +1,6 @@
+export { LionMenu } from './components/menu/src/LionMenu.js';
+export { LionMenuOverlay } from './components/menu/src/LionMenuOverlay.js';
+export { LionTree } from './components/menu/src/LionTree.js';
+export { LionToolbar } from './components/menu/src/LionToolbar.js';
+export { LionItem, LionMenuitem } from './components/menu/src/InteractiveListMixin.js';
+export { LionMenuHybrid } from './components/menu/src/LionMenuHybrid.js';

package/navigation-bar.js

@@ -0,0 +1 @@
+export { LionNavigationBar } from './components/navigation-bar/src/LionNavigationBar.js';

package/overlays.js

@@ -6,6 +6,8 @@ export { withBottomSheetConfig } from './components/overlays/src/configurations/
 export { withModalDialogConfig } from './components/overlays/src/configurations/withModalDialogConfig.js';
 export { withDropdownConfig } from './components/overlays/src/configurations/withDropdownConfig.js';
 export { withTooltipConfig } from './components/overlays/src/configurations/withTooltipConfig.js';
+export { withClickInteraction } from './components/overlays/src/configurations/visibility-trigger-partials/withClickInteraction.js';
+export { withHoverInteraction } from './components/overlays/src/configurations/visibility-trigger-partials/withHoverInteraction.js';
 export { deepContains } from './components/overlays/src/utils/deep-contains.js';
 // re-export via this entrypoint for backwards compatibility
 export { getDeepActiveElement } from './components/core/src/getDeepActiveElement.js';
@@ -15,3 +17,7 @@ export {
   setSiblingsInert,
 } from './components/overlays/src/utils/inert-siblings.js';
 export { overlays } from './components/overlays/src/singleton.js';
+
+/**
+ * @typedef {import('../components/overlays/types/OverlayConfig.js').OverlayConfig} OverlayConfig
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lion/ui",
-  "version": "0.16.1",
+  "version": "0.17.0-menu-system.1",
   "description": "A package of extendable web components",
   "license": "MIT",
   "author": "ing-bank",