@lion/ui 0.21.0 → 0.21.1-menu-system.0

package/docs/components/tooltip/api-table.md

@@ -16,26 +16,47 @@ eleventyNavigation:
 
 ### Fields
 
-| Name              | Privacy   | Type                     | Default         | Description                                                                                                                                | Inherited From |
-| ----------------- | --------- | ------------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
-| `hasArrow`        | public    | `boolean`                | `false`         | Whether an arrow should be displayed                                                                                                       | ArrowMixin     |
-| `invokerRelation` | public    | `'label'\|'description'` | `'description'` | Decides whether the tooltip invoker text should be considered a description
(sets aria-describedby) or a label (sets aria-labelledby). |                |
-| `_arrowNode`      | protected |                          |                 |                                                                                                                                            | ArrowMixin     |
+| Name                         | Privacy   | Type                     | Default         | Description                                                                                                                                                                                                                                                                                                                                                                                               | Inherited From |
+| ---------------------------- | --------- | ------------------------ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `config`                     | public    | `Partial<OverlayConfig>` | `{}`            | Configure the many options of the \`OverlayController\`                                                                                                                                                                                                                                                                                                                                                   | OverlayMixin   |
+| `hasArrow`                   | public    | `boolean`                | `false`         | Whether an arrow should be displayed                                                                                                                                                                                                                                                                                                                                                                      |                |
+| `invokerRelation`            | public    | `'label'\|'description'` | `'description'` | Decides whether the tooltip invoker text should be considered a description&#xA;(sets aria-describedby) or a label (sets aria-labelledby).                                                                                                                                                                                                                                                                |                |
+| `opened`                     | public    | `boolean`                | `false`         | If you add the opened attribute a dialog will be opened on page load. The invoker can be left out&#xA;in case the user does not need to be able to reopen the dialog.                                                                                                                                                                                                                                     | OverlayMixin   |
+| `_overlayBackdropNode`       | protected |                          |                 |                                                                                                                                                                                                                                                                                                                                                                                                           | OverlayMixin   |
+| `_overlayContentNode`        | protected |                          |                 |                                                                                                                                                                                                                                                                                                                                                                                                           | OverlayMixin   |
+| `_overlayContentWrapperNode` | protected |                          |                 |                                                                                                                                                                                                                                                                                                                                                                                                           | OverlayMixin   |
+| `_overlayInvokerNode`        | protected |                          |                 | The node that opens/closes this overlay.&#xA;&#xA;Resolved in a stable, declarative way (independent of the exact DOM order)&#xA;by looking, in order, for:&#xA;1\. a child with \`\[slot="invoker"]\`&#xA;2\. any element in the same root that opts in via \`\[data-invoker]\` and&#xA;   references this host by id (\`for="\<id>"\`)&#xA;3\. a preceding sibling that opts in via \`\[data-invoker]\` | OverlayMixin   |
+| `_overlayReferenceNode`      | protected |                          |                 |                                                                                                                                                                                                                                                                                                                                                                                                           | OverlayMixin   |
 
 ### Methods
 
-| Name                    | Privacy   | Description                                                                                                                 | Parameters                                         | Return                   | Inherited From |
-| ----------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------ | -------------- |
-| `_arrowNodeTemplate`    | protected |                                                                                                                             |                                                    |                          | ArrowMixin     |
-| `_arrowTemplate`        | protected |                                                                                                                             |                                                    |                          | ArrowMixin     |
-| `_defineOverlayConfig`  | protected | Overrides arrow and keepTogether modifier to be enabled,&#xA;and adds onCreate and onUpdate hooks to sync from popper state |                                                    | `OverlayConfig`          | ArrowMixin     |
-| `_getPopperArrowConfig` | protected |                                                                                                                             | `popperConfigToExtendFrom: Partial<PopperOptions>` | `Partial<PopperOptions>` | ArrowMixin     |
+| Name                               | Privacy   | Description                                                                                                                                                                                                                                                                                                                | Parameters                                                                                                   | Return              | Inherited From |
+| ---------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------- | -------------- |
+| `close`                            | public    | Hides the overlay                                                                                                                                                                                                                                                                                                          |                                                                                                              |                     | OverlayMixin   |
+| `open`                             | public    | Shows the overlay                                                                                                                                                                                                                                                                                                          |                                                                                                              |                     | OverlayMixin   |
+| `repositionOverlay`                | public    | Sometimes it's needed to recompute Popper position of an overlay, for instance when we have&#xA;an opened combobox and the surrounding context changes (the space consumed by the textbox&#xA;increases vertically)                                                                                                        |                                                                                                              |                     | OverlayMixin   |
+| `toggle`                           | public    | Toggles the overlay                                                                                                                                                                                                                                                                                                        |                                                                                                              |                     | OverlayMixin   |
+| `_defineOverlay`                   | protected |                                                                                                                                                                                                                                                                                                                            | `{ contentNode, invokerNode, referenceNode, backdropNode, contentWrapperNode }, config: DefineOverlayConfig` | `OverlayController` | OverlayMixin   |
+| `_defineOverlayConfig`             | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              | `OverlayConfig`     | OverlayMixin   |
+| `_getInvokerNode`                  | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              | `Element\|null`     | OverlayMixin   |
+| `_isPermanentlyDisconnected`       | protected | When we're moving around in dom, disconnectedCallback gets called.&#xA;Before we decide to teardown, let's wait to see if we were not just moving nodes around.                                                                                                                                                            |                                                                                                              | `Promise<boolean>`  | OverlayMixin   |
+| `_setOpenedWithoutPropertyEffects` | protected | When the opened state is changed by an Application Developer,cthe OverlayController is&#xA;requested to show/hide. It might happen that this request is not honoured&#xA;(intercepted in before-hide for instance), so that we need to sync the controller state&#xA;to this webcomponent again, preventing eternal loops. | `newOpened: boolean`                                                                                         |                     | OverlayMixin   |
+| `_setupOpenCloseListeners`         | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              |                     | OverlayMixin   |
+| `_setupOverlayCtrl`                | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              |                     | OverlayMixin   |
+| `_teardownOpenCloseListeners`      | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              |                     | OverlayMixin   |
+| `_teardownOverlayCtrl`             | protected |                                                                                                                                                                                                                                                                                                                            |                                                                                                              |                     | OverlayMixin   |
+
+### Events
+
+| Name             | Type          | Description | Inherited From |
+| ---------------- | ------------- | ----------- | -------------- |
+| `opened-changed` | `CustomEvent` |             | OverlayMixin   |
 
 ### Attributes
 
 | Name               | Field           | Inherited From |
 | ------------------ | --------------- | -------------- |
 | `invoker-relation` | invokerRelation |                |
-| `has-arrow`        | hasArrow        | ArrowMixin     |
+| `opened`           | opened          | OverlayMixin   |
 
 <hr/>

package/docs/fundamentals/index.md

@@ -9,11 +9,11 @@ Here you find more details about what we offer.
 
 Let's see what each section describes.
 
-1. [Systems](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/systems/core/overview.md) <br>
+1. [Systems](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/systems/core/overview.md) <br>
    These are the fundamental systems that power all of our components.
-2. [Tools](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/tools/helpers/overview.md) <br>
+2. [Tools](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/tools/helpers/overview.md) <br>
    Frontend Tools useful for web development but are not visual and therefore are not components.
-3. [Node Tools](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/node-tools/babel-plugin-extend-docs/overview.md) <br>
+3. [Node Tools](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/node-tools/babel-plugin-extend-docs/overview.md) <br>
    Node tools to analyse the code and for extending the documentation.
-4. [Rationales](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/rationales/side-effects.md) <br>
+4. [Rationales](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/rationales/side-effects.md) <br>
    The reasoning behind some of our decisions.

package/docs/fundamentals/node-tools/publish-docs/overview.md

@@ -44,7 +44,7 @@ For a Mono Repository
    ```md
    # My Pkg
 
-   [=> See Source <=](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/docs/deep/dir/overview.md)
+   [=> See Source <=](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/docs/deep/dir/overview.md)
    ```
 
 ## CLI flags
@@ -74,7 +74,7 @@ Bring the `overview.md` in a docs folder along.
 👉 `packages/[my-package]/docs/overview.md`
 
 ```md
-[=> See Source <=](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/docs/deep/dir/overview.md)
+[=> See Source <=](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/docs/deep/dir/overview.md)
 ```
 
 Add a `use-cases.md`
@@ -82,7 +82,7 @@ Add a `use-cases.md`
 👉 `packages/[my-package]/docs/use-cases.md`
 
 ```md
-[=> See Source <=](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/docs/deep/dir/use-cases.md)
+[=> See Source <=](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/docs/deep/dir/use-cases.md)
 ```
 
 So you will end up with something like this in your package.

package/docs/fundamentals/node-tools/rocket-preset-extend-lion-docs/overview.md

@@ -20,7 +20,7 @@ To do this automatically you can use this preset for [rocket](https://rocket.mod
 
 ## Features
 
-- Import lion documentation and adjust it using [remark-extend](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/node-tools/remark-extend/overview.md)
+- Import lion documentation and adjust it using [remark-extend](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/node-tools/remark-extend/overview.md)
 - Renames named imports and all it's usage
 - Adjusts import paths
 - Replace tags in template literals
@@ -51,7 +51,7 @@ export default {
 
 ## Reusing documentation
 
-To take an existing documentation you can "import" it using [remark-extend](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/node-tools/remark-extend/overview.md).
+To take an existing documentation you can "import" it using [remark-extend](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/node-tools/remark-extend/overview.md).
 
 As an example you can create `docs/components/tabs/overview.md`.
 

package/docs/fundamentals/rationales/TypeScript.md

@@ -51,26 +51,13 @@ Lion uses [package.json export maps](https://nodejs.org/api/packages.html#export
 
 The export map works by defining explicit entry points for each package, mapping import paths to their actual file locations. For types, this means that when you import `@lion/ui/button.js`, TypeScript knows to look for the corresponding type definitions in the `dist-types` directory.
 
-## Type Correction for JSDoc
+## Type correction for JSDoc (no longer needed)
 
-Since we use JSDoc for typing instead of native TypeScript files, we encounter some challenges during the type definition generation process. The TypeScript compiler sometimes produces inconsistent import statements when processing JSDoc annotations, particularly for Lit imports.
+Because Lion types its JavaScript with JSDoc rather than `.ts` files, older TypeScript
+versions emitted declaration paths that were not portable: `lit-element/lit-element.js`
+where the declaration really came from `lit`, and internal `node_modules/@open-wc/...`
+references that no consumer could resolve.
 
-We have a post-build script (`types-correct-after-build.js`) that addresses these issues:
-
-### Import Normalization
-
-The script ensures consistency in Lit imports by converting:
-
-- JSDoc-generated imports: `import { LitElement } from "lit-element/lit-element.js"`
-- To standardized imports: `import { LitElement } from "lit"`
-
-This prevents type incompatibility issues where the same class imported through different paths isn't recognized as the same type by TypeScript (see [TypeScript issue #51622](https://github.com/microsoft/TypeScript/issues/51622)).
-
-### External Dependency Path Correction
-
-The script also "unresolves" paths that reference external node_modules, particularly for scoped elements:
-
-- From: `"../../../node_modules/@open-wc/scoped-elements/types.js"`
-- To: `"@open-wc/scoped-elements/lit-element.js"`
-
-These corrections ensure that generated type definitions work correctly in consuming projects, where the resolved local paths would break since they reference locations outside the bundled package.
+A post-build script (`scripts/types-correct-after-build.js`) rewrote those paths after
+every build. **TypeScript 7 emits the correct specifiers itself**, so that script has been
+deleted: the `types` target in `packages/ui` is now a plain `tsc --build`.

package/docs/fundamentals/rationales/accessibility.md

@@ -37,4 +37,4 @@ Internally, we delegate all intricacies involved in managing light dom to SlotMi
 SlotMixin automatically mediates between light dom provided by the user ('public slots') and light dom provided by the component author ('private slots').
 Also, SlotMixin allows to hook into the reactive update loop of LitElement (automatically rerendering on property changes) and it automatically respects
 the scoped registry belonging to the shadow root.
-More details about SlotMixin can be found in the [SlotMixin documentation](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/systems/core/SlotMixin.md)
+More details about SlotMixin can be found in the [SlotMixin documentation](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/systems/core/SlotMixin.md)

package/docs/fundamentals/systems/core/SlotMixin.md

@@ -165,4 +165,4 @@ This will make sure that the slot provided by the user always takes precedence a
 
 ### Default slot
 
-As can be seen in the example of [SlotFunctionResults](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/systems/core/#slotfunctionresults), '' can be used to add content to the default slot
+As can be seen in the example of [SlotFunctionResults](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/systems/core/#slotfunctionresults), '' can be used to add content to the default slot

package/docs/fundamentals/systems/core/overview.md

@@ -28,7 +28,7 @@ import { LitElement, html, render } from 'lit-element';
 
 ## Features
 
-- [function to deduplicate mixins (dedupeMixin)](https://github.com/ing-bank/lion/blob/5c228561a361a8ed95aabcacf735f87fb2746a5f/docs/fundamentals/systems/core/#deduping-of-mixins)
+- [function to deduplicate mixins (dedupeMixin)](https://github.com/ing-bank/lion/blob/7f56e68987f13e6c536ea8f5d771f222a9f94a17/docs/fundamentals/systems/core/#deduping-of-mixins)
 - Mixin to handle disabled (DisabledMixin)
 - Mixin to handle disabled AND tabIndex (DisabledWithTabIndexMixin)
 - Mixin to manage auto-generated needed slot elements in light dom (SlotMixin)