@nextrap/nte-nav 1.2.0 → 2.0.1

package/CHANGELOG.md

@@ -1,586 +1,3 @@
-## 1.2.0 (2025-12-05)
+## 2.0.1 (2026-09-09)
 
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.29 (2025-09-12)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.28 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.27 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.26 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.25 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.24 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.23 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.22 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.21 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.20 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.19 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.18 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.17 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.16 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.15 (2025-09-11)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.14 (2025-08-28)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.13 (2025-08-28)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.12 (2025-08-28)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.11 (2025-08-24)
-
-### 🧱 Updated Dependencies
-
-- Updated style-reset to 1.0.0
-- Updated style-base to 1.1.11
-- Updated nte-offcanvas to 1.0.16
-
-## 1.1.10 (2025-08-13)
-
-### 🩹 Fixes
-
-- do not re-export lit via nt-framework ([12ac05f](https://github.com/nextrap/nextrap-monorepo/commit/12ac05f))
-
-### ❤️ Thank You
-
-- Enzo Volkmann @evolkmann
-
-## 1.1.9 (2025-08-01)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.15
-
-## 1.1.8 (2025-08-01)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.7 (2025-08-01)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.14
-
-## 1.1.6 (2025-08-01)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.5 (2025-07-31)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.13
-
-## 1.1.4 (2025-07-31)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.3 (2025-07-31)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.10
-- Updated nte-offcanvas to 1.0.12
-
-## 1.1.2 (2025-07-31)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.11
-
-## 1.1.1 (2025-07-31)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.1.0 (2025-07-31)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.25 (2025-07-24)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.9
-- Updated nte-offcanvas to 1.0.10
-
-## 1.0.24 (2025-07-24)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.8
-- Updated nte-offcanvas to 1.0.9
-
-## 1.0.23 (2025-07-24)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.7
-- Updated nte-offcanvas to 1.0.8
-
-## 1.0.22 (2025-07-24)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.6
-- Updated nte-offcanvas to 1.0.7
-
-## 1.0.21 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.20 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.1.7
-
-## 1.0.19 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.18 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.1.6
-
-## 1.0.17 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.16 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.6
-
-## 1.0.15 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.14 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.1.5
-
-## 1.0.13 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 1.1.1
-- Updated nte-offcanvas to 1.0.5
-- Updated nte-burger to 1.1.4
-
-## 1.0.12 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.11 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.4
-
-## 1.0.10 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 1.1.0
-- Updated nte-offcanvas to 1.0.3
-- Updated nte-burger to 1.1.3
-
-## 1.0.9 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.1.2
-
-## 1.0.8 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 1.0.0
-- Updated nte-offcanvas to 1.0.2
-- Updated nte-burger to 1.1.1
-
-## 1.0.7 (2025-07-23)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.1.0
-
-## 1.0.6 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.5 (2025-07-23)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.4 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 1.0.3 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.1
-
-## 1.0.2 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.0.1
-
-## 1.0.1 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-# 1.0.0 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.48 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 1.0.0
-
-## 0.2.47 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 1.0.0
-
-## 0.2.46 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.25
-
-## 0.2.45 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.44 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.43 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.42 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 0.0.3
-- Updated nte-offcanvas to 0.0.24
-- Updated nte-burger to 0.1.3
-
-## 0.2.41 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.40 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 0.0.2
-- Updated nte-offcanvas to 0.0.23
-- Updated nte-burger to 0.1.2
-
-## 0.2.39 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.38 (2025-07-22)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.22
-
-## 0.2.37 (2025-07-22)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.36 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.35 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.5
-- Updated nte-offcanvas to 0.0.21
-
-## 0.2.34 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.20
-
-## 0.2.33 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.32 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 0.1.1
-
-## 0.2.31 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 0.1.0
-
-## 0.2.30 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.29 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.19
-
-## 0.2.28 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.4
-- Updated nte-offcanvas to 0.0.18
-
-## 0.2.27 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.3
-- Updated nte-offcanvas to 0.0.17
-
-## 0.2.26 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.2
-- Updated nte-offcanvas to 0.0.16
-
-## 0.2.25 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.24 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.15
-
-## 0.2.23 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.22 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.1
-- Updated nte-offcanvas to 0.0.14
-
-## 0.2.21 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.1.0
-- Updated nte-offcanvas to 0.0.13
-
-## 0.2.20 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.0.3
-- Updated nte-offcanvas to 0.0.12
-
-## 0.2.19 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.0.2
-- Updated nte-offcanvas to 0.0.11
-
-## 0.2.18 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.17 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.10
-
-## 0.2.16 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.9
-
-## 0.2.15 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.0.1
-- Updated nte-offcanvas to 0.0.8
-
-## 0.2.14 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 1.0.0
-- Updated nte-offcanvas to 0.0.7
-
-## 0.2.13 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-base to 0.0.2
-- Updated nte-offcanvas to 0.0.6
-
-## 0.2.12 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.11 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.10 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.9 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.8 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.5
-
-## 0.2.7 (2025-07-21)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.6 (2025-07-21)
-
-### 🧱 Updated Dependencies
-
-- Updated style-reset to 0.1.1
-- Updated nte-offcanvas to 0.0.4
-
-## 0.2.5 (2025-07-16)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.0.3
-
-## 0.3.5 (2025-07-15)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.2.2
-
-## 0.3.4 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.3.3 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.3.2 (2025-07-15)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-offcanvas to 0.2.1
-
-## 0.3.1 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.3.0 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.2.0 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.1.1 (2025-07-15)
-
-### 🧱 Updated Dependencies
-
-- Updated nte-burger to 0.1.0
-
-## 0.1.0 (2025-07-15)
-
-This was a version bump only for nte-nav to align it with other projects, there were no code changes.
-
-## 0.0.3 (2025-07-15)
-
-### 🧱 Updated Dependencies
-
-- Updated nt-framework to 0.1.0
-- Updated nte-offcanvas to 0.0.2
-- Updated nte-burger to 0.0.2
+This was a version bump only for nte-nav to align it with other projects, there were no code changes.

package/README.md

@@ -1,3 +1,112 @@
-# nte-nav
+# @nextrap/nte-nav
 
-A navigation element.
+Working draft for the future Nextrap navigation component. The existing `@nextrap/nte-nav` package remains unchanged; a future navbar is explicitly out of scope.
+
+## Import
+
+```ts
+import '@nextrap/nte-nav';
+```
+
+```scss
+@use '@nextrap/nte-nav' as nav;
+
+header nte-nav.style-default {
+  @include nav.default-style();
+  @include nav.horizontal();
+  @include nav.size-medium();
+}
+
+aside nte-nav.style-default {
+  @include nav.sub-navigation();
+  @include nav.vertical();
+}
+```
+
+`SetDefaultStyleMixin` adds `style-default` when no other `style-*` class is present. The component's Shadow DOM only contains functional layout, disclosure, positioning and transition CSS. Visual styling is supplied by the public mixins.
+
+## Basic API
+
+```html
+<nte-nav aria-label="Hauptnavigation">
+  <nte-nav-item submenu-popover>
+    <svg slot="icon" aria-hidden="true"><!-- … --></svg>
+    Leistungen
+
+    <nte-nav-item href="/leistungen/beratung">Beratung</nte-nav-item>
+    <nte-nav-item href="/leistungen/entwicklung">Entwicklung</nte-nav-item>
+  </nte-nav-item>
+
+  <nte-nav-item href="/ueber-uns" current="page">Über uns</nte-nav-item>
+</nte-nav>
+```
+
+Direct nested `nte-nav-item` children are automatically assigned to the private `submenu` slot. Consumer markup no longer contains a `ul/li/ul` tree. Each item owns its anchor, disclosure control, submenu container and CSS positioning inside its Shadow DOM.
+
+Parents with children are non-linking disclosures by default: omit `href` and the complete visible label toggles the submenu. Add `href` only when the parent page is a real destination of its own; the component then keeps the link and disclosure as two separate keyboard-focusable controls.
+
+## Attributes
+
+### `nte-nav`
+
+| Attribute | Type | Purpose |
+|---|---|---|
+| `aria-label` | string | Accessible name forwarded to the internal `nav` landmark. Recommended whenever multiple navigation landmarks exist. |
+
+### `nte-nav-item`
+
+| Attribute | Type | Purpose |
+|---|---|---|
+| `href` | string | Renders the item's internal anchor. If omitted on an item with children, the label itself becomes the disclosure button. |
+| `target` | string | Forwarded to the internal anchor. |
+| `rel` | string | Forwarded to the internal anchor. |
+| `download` | string | Forwarded to the internal anchor. |
+| `current` | ARIA current token | Forwarded as `aria-current` to the internal anchor. |
+| `--order` | CSS custom property | Sets the host's Flexbox `order`. Use sparingly because visual order does not change DOM or keyboard order. |
+| `submenu-popover` | boolean attribute | Manually renders nested items as declarative Popover markup for horizontal navigation. Omit for vertical inline `details`/`summary`. |
+| `submenu-label` | string | Prefix for the submenu disclosure's accessible name. Default: `Untermenü`. |
+
+## Slots
+
+| Component | Slot | Purpose |
+|---|---|---|
+| `nte-nav` | default | Top-level `nte-nav-item` elements. |
+| `nte-nav-item` | default | Visible rich-text label. |
+| `nte-nav-item` | `icon` | Optional icon rendered in the dedicated `icon` part. Decorative SVGs should use `aria-hidden="true"`. |
+| `nte-nav-item` | `submenu` | Internal target slot for nested items. Direct nested `nte-nav-item` elements are assigned automatically. |
+
+## Parts
+
+- `nte-nav`: `nav`, `list`
+- `nte-nav-item`: `item`, `details`, `link`, `text`, `disclosure`, `toggle`, `icon`, `label`, `indicator`, `submenu`, `submenu-inner`
+
+## Public mixins
+
+- `default-style()` – full default visual baseline
+- `main-navigation()` – complete, large main-navigation variant
+- `sub-navigation()` – complete, compact sub-navigation variant
+- `horizontal($justify, $gap)` – horizontal functional orientation
+- `vertical($gap)` – vertical functional orientation
+- `responsive($breakpoint, $horizontal-justify)` – vertical below and horizontal above a breakpoint
+- `size-small()`, `size-medium()`, `size-large()` – size presets that only set component variables
+
+## Orientation and native disclosure
+
+This is ordinary website navigation, not an application menu. It intentionally uses a `nav` landmark, list/listitem semantics, links and disclosure buttons rather than ARIA `menu`/`menubar` roles.
+
+Submenus are selected manually per item. The Shadow DOM CSS consumes orientation variables from the mixins; the markup variant is controlled by the public `submenu-popover` attribute:
+
+- For `horizontal()`, add `submenu-popover` to parent items with nested items. The component renders a native `<button popovertarget="submenu">` and `<div id="submenu" popover="auto">`, so the browser handles the Popover declaratively.
+- For `vertical()`, omit `submenu-popover`. The component renders native `details` / `summary`; the submenu stays in normal document flow, animates downwards and is indented as part of the navigation path.
+- `responsive()` changes only CSS orientation. With nested submenus and no JavaScript, the integration must manually add/remove `submenu-popover` or choose one authored variant.
+
+The optional icon slot is observed by `nextrap_element({ slotVisibility: true })`. Empty icon slots receive `.slot-empty` and are hidden entirely by the component CSS.
+
+## Deliberately deferred
+
+- Navbar, sticky header and brand layout
+- Burger/offcanvas content transfer from the legacy package
+- Optional arrow-key navigation beyond normal Tab/Shift+Tab behavior
+- Public imperative `showSubmenu()` / `hideSubmenu()` methods
+- SPA-router adapters and prefetch behavior
+- Public imperative `showSubmenu()` / `hideSubmenu()` methods beyond the internal Popover synchronization

package/index.d.ts

@@ -1,4 +1,2 @@
-export * from './lib/nte-nav';
-export * from './lib/nte-navbar';
-export * from './lib/nte-navbar-line';
-export * from './components/nte-nav-brand-relocator/nte-nav-brand-relocator';
+export * from './src/components/nte-nav/nte-nav';
+export * from './src/components/nte-nav-item/nte-nav-item';