@andesine/ui 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 0.4.0
+
+First release. The version follows the other Andesine packages.
+
+- Add the package structure and the `@andesine/ui/solid` export.
+- Add `NavigationTree`, `TableOfContents`, `MobileNavigation`, `Breadcrumbs`, and
+  `Pagination`.
+- Add `Tabs` with shared selection, and `createClipboard`.
+- Add `createSearch` and `createListNavigation`.
+- Add `createAnswer` for streamed answers with follow-ups and cancellation.
+- Add `createPageActions` to copy the page link or its Markdown.
+- Add `createSearchPalette`, `createPageScrollbar`, `createScrollEdges`,
+  `createScrollMemory`, `createTabIndicator`, `createTableOfContentsGuide`, and
+  the match helpers `splitMatches`, `matchesQuery`, and `getMatchPreview`.
+- `NavigationTree` saves the expanded groups of each page, reads them before
+  hydration, and has `defaultDepth`. Its root has `data-storage-key`, which the
+  `@andesine/pages` restore script uses.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vrite, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @andesine/ui
+
+Headless documentation components for Andesine Pages. The components supply
+structure, state, keyboard and focus behavior, and ARIA attributes. They supply
+no styles.
+
+> **Unstable.** The components follow the needs of the Andesine Pages template, and
+> their API can change in any 0.x release. Pin the exact version.
+
+## Exports
+
+| Export               | Contents             |
+| -------------------- | -------------------- |
+| `@andesine/ui/solid` | Solid.js components. |
+
+## Components
+
+| Component              | Behavior                                                                                                                                       |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `NavigationTree`       | Page links and groups. Link activation does not expand a group. Expanded groups persist in session storage, shared by trees with the same key. |
+| `TableOfContents`      | Heading links. Tracks the current heading and the headings in view, and moves focus after a click.                                             |
+| `MobileNavigation`     | A `<details>` menu that is modal while open, and works without JavaScript.                                                                     |
+| `Breadcrumbs`          | Ancestor links.                                                                                                                                |
+| `Tabs`                 | Ark UI tabs. Tabs with the same `syncKey` share their selection.                                                                               |
+| `createClipboard`      | Copies text and reports success or failure for a short time.                                                                                   |
+| `createSearch`         | Debounced search. A new query cancels the previous request, and only the latest response updates the results.                                  |
+| `createListNavigation` | Arrow, Home, End, and Enter keys for a list, e.g. from a combobox input.                                                                       |
+| `Pagination`           | Previous and next links.                                                                                                                       |
+
+The table of contents reads the document's `scroll-padding-top` as the height of
+sticky headers.
+
+Each component part renders `data-scope` and `data-part` attributes. State is in
+`data-*` and ARIA attributes. Use these attributes to style the parts.
+
+## Build
+
+```sh
+pnpm build --filter=@andesine/ui
+```
+
+The Solid export has 4 conditions: `solid` (JSX source for Solid-aware bundlers),
+`browser`, `node`, and `types`.