bojuvue 0.2.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Scott Kirvan
+
+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,287 @@
+# BojuVue 보주뷰 [![starline](https://raw.githubusercontent.com/ScottKirvan/BojuVue/refs/heads/starlines/ScottKirvan/BojuVue/starline.svg)](https://github.com/qoomon/starlines)
+<div align="center">
+
+  <img src="assets/media/logo.jpg" alt="logo" width="200" height="auto" />
+    <h1><a href="https://github.com/ScottKirvan/BojuVue">ScottKirvan/BojuVue</a></h1>
+  <h3>Shared Vue 3 components, with VitePress-aware builds</h3>
+  
+  
+<!-- Badges -->
+<p>
+  <a href="https://github.com/ScottKirvan/BojuVue/graphs/contributors">
+    <img src="https://img.shields.io/github/contributors/ScottKirvan/BojuVue" alt="contributors" />
+  </a>
+  <a href="https://github.com/ScottKirvan/BojuVue/commits/main">
+    <img src="https://img.shields.io/github/last-commit/ScottKirvan/BojuVue" alt="last update" />
+  </a>
+  <a href="https://github.com/ScottKirvan/BojuVue/network/members">
+    <img src="https://img.shields.io/github/forks/ScottKirvan/BojuVue" alt="forks" />
+  </a>
+  <a href="https://github.com/ScottKirvan/BojuVue/stargazers">
+    <img src="https://img.shields.io/github/stars/ScottKirvan/BojuVue" alt="stars" />
+  </a>
+  <a href="https://github.com/ScottKirvan/BojuVue/issues/">
+    <img src="https://img.shields.io/github/issues/ScottKirvan/BojuVue" alt="open issues" />
+  </a>
+  <a href="https://github.com/ScottKirvan/BojuVue/blob/main/LICENSE.md">
+    <img src="https://img.shields.io/github/license/ScottKirvan/BojuVue.svg" alt="license" />
+  </a>
+  <a href="https://discord.gg/TN6XJSNK5Y">
+    <!--<img src="https://img.shields.io/discord/704680098577514527?style=flat-square&label=%F0%9F%92%AC%20discord&color=00ACD7">-->
+    <img src="https://img.shields.io/discord/1052011377415438346?style=flat-square&label=discord&color=00ACD7">
+  </a>
+</p>
+   
+<h4>
+    <a href="https://scottkirvan.github.io/BojuVue/">Documentation</a>
+  <span> · </span>
+    <a href="https://github.com/ScottKirvan/BojuVue/issues/new?template=bug_report.md">Report Bug</a>
+  <span> · </span>
+    <a href="https://github.com/ScottKirvan/BojuVue/issues/new?template=feature_request.md">Request Feature</a>
+  </h4>
+</div>
+
+**BojuVue** is a Vue 3 component library published to npm as [`@scottkirvan/bojuvue`](https://www.npmjs.com/package/@scottkirvan/bojuvue). It exists so that VitePress sites — this author's homepage blog and several local documentation sites — can share one set of landing-page and UX components instead of duplicating them per repo. Update this repo, bump the version, publish, and every consuming site can pull in the update with `npm update`.
+
+Branches
+--------
+`main` is the [deployed](https://ScottKirvan.github.io/BojuVue/) branch.  The repo doesn't currently contain any other historic or dev branches.
+
+Repo Layout
+-----------
+```
+BojuVue
+├───.github
+│   ├───gitignore-templates      # .gitignore templates for other stacks (not used by this repo's own Node build)
+│   ├───release-please           # Release-Please config — automated version bumps + CHANGELOG from Conventional Commits
+│   └───workflows                # CI (test + build), docs deploy, release, pre-release staging
+├───assets
+│   └───media                    # Logo
+├───docs                         # VitePress site — consumer-facing docs, deployed to GitHub Pages
+├───notes
+│   ├───dev                      # Design specs and working notes for this repo's own contributors
+│   ├───CHANGELOG.md             # Auto-generated by Release-Please
+│   ├───TODO.md
+│   └───VERSION.md
+├───src                          # Library source — see Architecture below
+├───CLAUDE.md                    # AI agent context
+├───CODE_OF_CONDUCT.md           # Community guidelines
+├───CONTRIBUTING.md              # Contribution guidelines
+├───LICENSE.md                   # MIT License
+└───README.md                    # This file
+```
+
+Issue and PR templates aren't in this repo's own `.github/` — they're inherited from
+the `ScottKirvan/.github` org repo via GitHub's community health file fallback.
+
+Table of Contents
+-----------------
+- [Branches](#branches)
+- [Repo Layout](#repo-layout)
+- [Features](#features)
+- [Architecture](#architecture)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Adding a new component](#adding-a-new-component)
+- [Contributions / Contact](#contributions--contact)
+- [Credits](#credits)
+
+Features
+--------
+- Vue 3 + TypeScript components, built as an ES module via Vite library mode
+- `vue` is a peer dependency, so consuming sites use their own Vue instance — no duplicate copies, no broken reactivity
+- Every component is exported from one entry point (`src/index.ts`), so consuming a new component is a one-line import change
+- The `docs/` VitePress site imports directly from `src/index.ts`/`src/vitepress.ts` and registers every exported component globally, so new components can be previewed live in a real VitePress site without publishing or `npm link`
+- Some components (currently `BVPlatformButton`) ship as **two fully independent builds behind two import paths**: a generic implementation at `@scottkirvan/bojuvue`, with zero dependency on `vitepress`, and a VitePress-specific implementation at `@scottkirvan/bojuvue/vitepress`, same component name, resolving anything VitePress-specific for you. Neither component imports or renders the other — the import path is what disambiguates them. `vitepress` is an *optional* peer dependency — installing the package alone never requires it; only importing from the `/vitepress` path does.
+
+Architecture
+------------
+The bit that shapes everything else in this repo: **the generic build must have zero
+dependency on `vitepress`, anywhere in its module graph.** Everything below exists to
+make that hold under a real bundler, not just in theory.
+
+**Two entry points, two physical files.** `vite.config.ts` builds library mode with two
+separate entries — `src/index.ts` → `dist/bojuvue.js` (published as `.`) and
+`src/vitepress.ts` → `dist/vitepress.js` (published as `./vitepress`). `src/vitepress.ts`
+re-exports everything `src/index.ts` has, plus its own VitePress-specific component
+implementations, under the same names. This has to be two genuinely separate output
+files, not two exports of one bundle — if both compiled into a single file, importing
+only the generic path would still execute a top-level `import 'vitepress'` somewhere in
+it. Verify this invariant after touching anything under `src/` by building and grepping
+the output:
+```sh
+npm run build
+grep -r vitepress dist/bojuvue.js   # should print nothing
+```
+
+**Two independent implementations per VitePress-aware component.** A component that
+needs anything VitePress-specific (site data, the router, VitePress's own `VPButton`)
+doesn't take a runtime "VitePress mode" flag — it gets two fully independent
+implementations sharing one exported name, disambiguated by import path:
+`src/ComponentName.vue` (plain props, no `vitepress` import, exported from
+`src/index.ts`) and `src/vitepress/ComponentName.vue` (calls whatever VitePress
+composables it needs itself, exported from `src/vitepress.ts`). Neither imports or
+renders the other. `BVPlatformButton` is the worked example — see
+`src/BVPlatformButton.vue` and `src/vitepress/BVPlatformButton.vue`. Logic genuinely
+shared between the two (e.g. manifest-fetch orchestration) lives in a plain utility
+module both call independently — see `src/useManifestFetch.ts` — not in one component
+owning the other's rendering.
+
+**Prop types stay inline in `defineProps<T>()`.** `@vue/compiler-sfc` resolving a
+`defineProps<T>()` type imported from another module needs the `typescript` package
+loadable from wherever the `.vue` file is compiled — which breaks under `docs/`'s
+cross-directory source build (next point) whenever the repo root's `node_modules` isn't
+present. Keep the type written out inline in the macro itself. A type used only for a
+public, non-macro export (`BVPlatformButtonProps` in `src/BVPlatformButton.types.ts`,
+for instance) is fine to keep in its own file — the constraint is specifically about the
+`defineProps<T>()` type position.
+
+**Real logic lives outside the `.vue` file.** Components with real logic — detection,
+data-shaping, anything beyond pure rendering — extract that logic into a plain `.ts`
+module (`src/platform.ts` next to `BVPlatformButton.vue`) rather than keeping it inline
+in `<script setup>`. Much easier to unit test a plain function than to mount a component
+or mock Vue-specific APIs to exercise the same branch.
+
+**`docs/` previews live source, not the published package.** `docs/` is a separate,
+independently-installed VitePress project. `docs/.vitepress/theme/index.ts` imports
+directly from `../../../src/vitepress` — this repo's own VitePress-entry *source* — and
+registers every export globally, so a new component shows up in a real VitePress site
+the moment you write it (`npm run docs:dev`), no publish or `npm link` needed. That
+import crosses a directory boundary `docs/`'s own dependency resolution doesn't know
+about: files under repo-root `src/` still `import 'vue'`/`import 'vitepress'`
+themselves, which would otherwise resolve relative to `src/`'s own location. A scoped
+Vite plugin in `docs/.vitepress/config.mts` fixes this by redirecting any such import,
+when the importing file is physically under repo-root `src/`, through Vite's normal
+resolver as if it came from inside `docs/` instead. Verify a change here by temporarily
+renaming the repo root's `node_modules` out of the way and confirming `npm run
+docs:build` (from `docs/`) still succeeds — `docs/`'s deploy job never installs the repo
+root's dependencies, so this has to work without them.
+
+**Typechecking and build.** `npm run build` runs `vue-tsc -b` (typecheck, via composite
+TypeScript project references) then `vite build` (emits `dist/`). There's no separate
+typecheck-only script — `vue-tsc -b --noEmit` isn't valid with composite project
+references, so `build` is the only way to typecheck the library.
+
+Installation
+------------
+```
+npm install @scottkirvan/bojuvue
+```
+
+Usage
+-----
+Register components however you already register components in your app:
+
+```ts
+// main.ts (or wherever you create your Vue app)
+import { createApp } from 'vue'
+import { BVPlatformButton, SomeComponent } from '@scottkirvan/bojuvue'
+import App from './App.vue'
+
+const app = createApp(App)
+app.component('BVPlatformButton', BVPlatformButton)
+app.component('SomeComponent', SomeComponent)
+app.mount('#app')
+```
+
+Building a VitePress site? Register the same way from `enhanceApp` in
+`.vitepress/theme/index.ts` instead of `main.ts`, and prefer importing from
+`@scottkirvan/bojuvue/vitepress` for any component with a VitePress-aware build (see
+Features above):
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import { BVPlatformButton } from '@scottkirvan/bojuvue/vitepress'
+import { SomeComponent } from '@scottkirvan/bojuvue'
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    app.component('BVPlatformButton', BVPlatformButton)
+    app.component('SomeComponent', SomeComponent)
+  },
+}
+```
+
+Then use it in any `.md` page. Update later with `npm update`.
+
+See the **[component reference](https://scottkirvan.github.io/BojuVue/components/)**
+for every available component's props and a usage example — including, per component,
+which import path(s) it's available from.
+
+Adding a new component
+-----------------------
+Read [Architecture](#architecture) first if you haven't — the steps below assume you
+know why some components have two implementations and why prop types stay inline.
+
+**A component with no VitePress-specific needs:**
+
+1. Write the `.vue` file under `src/` (e.g. `src/YourComponent.vue`) — standard SFC:
+   `<script setup lang="ts">` for props/logic, `<template>` for markup, `<style
+   scoped>` for CSS scoped to that component alone.
+2. Make configurable text/behavior actual props, not hardcoded strings —
+   `defineProps<{...}>()` with `withDefaults(...)` for sensible fallbacks. Keep the prop
+   type written inline in the macro.
+3. Extract any real logic (detection, data-shaping) into a plain `.ts` module next to
+   the component, and write unit tests for it (see `src/platform.ts` /
+   `src/platform.test.ts`).
+4. Add one line to `src/index.ts`: `export { default as YourComponent } from
+   './YourComponent.vue'`.
+5. Preview it: `npm run docs:dev` (from `docs/`), then use `<YourComponent />` anywhere
+   in a `.md` file — it's registered globally in this repo's own `docs/` theme, so no
+   import is needed there.
+6. Add a reference page at `docs/components/your-component.md` (props table + usage
+   example — copy the structure of an existing page) and link it from
+   `docs/components/index.md` and the sidebar in `docs/.vitepress/config.mts`.
+7. `npm run build` at the repo root to confirm the library itself still builds clean,
+   and `npm test` to run the unit suite.
+
+**A component that needs something VitePress-specific** (worked example:
+`BVPlatformButton`) gets two fully independent implementations instead of one file:
+
+1. The framework-agnostic logic and markup goes in `src/YourComponent.vue` — plain
+   props in (including anything the VitePress-specific implementation would otherwise
+   read from a VitePress composable — e.g. a `base` prop standing in for
+   `useData().site.value.base`, resolved by that other implementation itself, not read
+   directly here). No `vitepress` import anywhere in this file.
+2. `src/vitepress/YourComponent.vue` calls whatever VitePress composables it needs
+   itself and implements its own rendering. It does not import or render
+   `src/YourComponent.vue`. Any logic genuinely shared between the two (like fetch
+   orchestration — see `useManifestFetch`) lives in a plain utility module both call
+   independently, not in one component owning the other's rendering.
+3. `src/index.ts` exports the generic implementation; `src/vitepress.ts` re-exports
+   everything `src/index.ts` has, plus exports the VitePress-specific implementation —
+   both under the same name, `YourComponent`. The import path is what disambiguates
+   them.
+4. Preview via `docs/.vitepress/theme/index.ts`, which registers from `src/vitepress.ts`
+   (the superset) — this exercises both the VitePress-specific implementation and
+   everything re-exported from the generic one.
+5. `npm run build` must still produce two separate physical files (check
+   `vite.config.ts`'s `build.lib.entry`), and the generic build's output file must
+   contain zero reference to `vitepress` — grep for it directly after any build that
+   touches this component (see [Architecture](#architecture)).
+6. Add the reference page and sidebar entry as in step 6 above, and document both import
+   paths on that page — see `docs/components/platform-button.md` for the pattern.
+
+**Before opening a pull request:** `npm test` and `npm run build` both pass; tests exist
+for anything with real logic; every failure and edge path has a deliberate, documented
+user-visible behavior; the reference page documents every prop's default and whether
+it's required, and calls out anything deliberately not supported, with why. See
+`CLAUDE.md` for the full set of engineering conventions this project holds
+contributions to.
+
+Contributions / Contact
+-----------------------
+- Please [file an issue](https://github.com/ScottKirvan/BojuVue/issues/new), or [grab a fork](https://github.com/ScottKirvan/BojuVue/fork), hack away, and submit a [pull request](https://github.com/ScottKirvan/BojuVue/pulls).
+- Contact me at [linkedin.com/in/scottkirvan/](https://www.linkedin.com/in/scottkirvan/)
+- You can also contact me at my [discord](https://discord.gg/TN6XJSNK5Y) server, I'm cptvideo.
+
+Credits
+-------
+**BojuVue** — Copyright (c) 2026 [Scott Kirvan](https://github.com/ScottKirvan). [MIT License](LICENSE.md).
+
+Scaffolded from [ScooterGitTemplate](https://github.com/ScottKirvan/ScooterGitTemplate).
+
+Project Link:  [BojuVue](https://github.com/ScottKirvan/BojuVue)  
+[CHANGELOG](notes/CHANGELOG.md)  
+[TODO](notes/TODO.md)

package/dist/BVButton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/BVButton.types.d.ts

@@ -0,0 +1,9 @@
+export interface BVButtonProps {
+    text: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    tag?: string;
+}

package/dist/BVButton.vue.d.ts

@@ -0,0 +1,15 @@
+type __VLS_Props = {
+    text: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    tag?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "medium" | "big";
+    theme: "brand" | "alt" | "sponsor";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/BVIconButton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/BVIconButton.types.d.ts

@@ -0,0 +1,11 @@
+export interface BVIconButtonProps {
+    text?: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    tag?: string;
+    icon?: string;
+    label?: string;
+}

package/dist/BVIconButton.vue.d.ts

@@ -0,0 +1,17 @@
+type __VLS_Props = {
+    text?: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    tag?: string;
+    icon?: string;
+    label?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "medium" | "big";
+    theme: "brand" | "alt" | "sponsor";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/BVMoreButton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/BVMoreButton.types.d.ts

@@ -0,0 +1,15 @@
+export interface BVMoreButtonItem {
+    label: string;
+    href: string;
+    icon?: string;
+    target?: string;
+    rel?: string;
+}
+export interface BVMoreButtonProps {
+    items: BVMoreButtonItem[];
+    icon?: string;
+    text?: string;
+    label?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+}

package/dist/BVMoreButton.vue.d.ts

@@ -0,0 +1,20 @@
+type __VLS_Props = {
+    items: {
+        label: string;
+        href: string;
+        icon?: string;
+        target?: string;
+        rel?: string;
+    }[];
+    icon?: string;
+    text?: string;
+    label?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    text: string;
+    label: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/BVPlatformButton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/BVPlatformButton.types.d.ts

@@ -0,0 +1,10 @@
+export interface BVPlatformButtonProps {
+    manifestUrl?: string;
+    fallbackHref?: string;
+    fallbackLabel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    target?: string;
+    rel?: string;
+    icon?: string;
+}

package/dist/BVPlatformButton.vue.d.ts

@@ -0,0 +1,17 @@
+type __VLS_Props = {
+    manifestUrl?: string;
+    fallbackHref?: string;
+    fallbackLabel?: string;
+    size?: 'medium' | 'big';
+    theme?: 'brand' | 'alt' | 'sponsor';
+    target?: string;
+    rel?: string;
+    icon?: string;
+    base?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    base: string;
+    manifestUrl: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/bojuvue.css

@@ -0,0 +1,2 @@
+.bv-button[data-v-8e3f769d]{text-align:center;white-space:nowrap;border:1px solid #0000;font-weight:600;text-decoration:none;transition:color .25s,border-color .25s,background-color .25s;display:inline-block}.bv-button[data-v-8e3f769d]:active{transition:color .1s,border-color .1s,background-color .1s}.bv-button.medium[data-v-8e3f769d]{border-radius:20px;padding:0 20px;font-size:14px;line-height:38px}.bv-button.big[data-v-8e3f769d]{border-radius:24px;padding:0 24px;font-size:16px;line-height:46px}.bv-button.brand[data-v-8e3f769d]{border-color:var(--vp-button-brand-border,#3c8772);color:var(--vp-button-brand-text,#fff);background-color:var(--vp-button-brand-bg,#3c8772)}.bv-button.brand[data-v-8e3f769d]:hover{border-color:var(--vp-button-brand-hover-border,#359469);color:var(--vp-button-brand-hover-text,#fff);background-color:var(--vp-button-brand-hover-bg,#359469)}.bv-button.brand[data-v-8e3f769d]:active{border-color:var(--vp-button-brand-active-border,#2b8760);color:var(--vp-button-brand-active-text,#fff);background-color:var(--vp-button-brand-active-bg,#2b8760)}.bv-button.alt[data-v-8e3f769d]{border-color:var(--vp-button-alt-border,transparent);color:var(--vp-button-alt-text,#3c3c43);background-color:var(--vp-button-alt-bg,#f2f2f3)}.bv-button.alt[data-v-8e3f769d]:hover{border-color:var(--vp-button-alt-hover-border,transparent);color:var(--vp-button-alt-hover-text,#3c3c43);background-color:var(--vp-button-alt-hover-bg,#e6e6e7)}.bv-button.alt[data-v-8e3f769d]:active{border-color:var(--vp-button-alt-active-border,transparent);color:var(--vp-button-alt-active-text,#3c3c43);background-color:var(--vp-button-alt-active-bg,#dcdcdd)}.bv-button.sponsor[data-v-8e3f769d]{border-color:var(--vp-button-sponsor-border,transparent);color:var(--vp-button-sponsor-text,#d5389c);background-color:var(--vp-button-sponsor-bg,transparent)}.bv-button.sponsor[data-v-8e3f769d]:hover{border-color:var(--vp-button-sponsor-hover-border,#d5389c);color:var(--vp-button-sponsor-hover-text,#d5389c);background-color:var(--vp-button-sponsor-hover-bg,transparent)}.bv-button.sponsor[data-v-8e3f769d]:active{border-color:var(--vp-button-sponsor-active-border,#d5389c);color:var(--vp-button-sponsor-active-text,#d5389c);background-color:var(--vp-button-sponsor-active-bg,transparent)}.bv-icon-button[data-v-6c0ea7e4]{align-items:center;display:inline-flex;position:relative}.bv-icon-button-icon[data-v-6c0ea7e4]{pointer-events:none;justify-content:center;align-items:center;display:inline-flex;position:absolute}.bv-icon-button-icon[data-v-6c0ea7e4] svg{width:1em;height:1em}.bv-icon-button.icon-only .bv-icon-button-icon[data-v-6c0ea7e4]{inset:0}.bv-icon-button.has-icon .bv-icon-button-icon[data-v-6c0ea7e4]{top:50%;transform:translateY(-50%)}.bv-icon-button.has-icon.medium .bv-icon-button-icon[data-v-6c0ea7e4]{font-size:14px;left:20px}.bv-icon-button.has-icon.big .bv-icon-button-icon[data-v-6c0ea7e4]{font-size:16px;left:24px}[data-v-6c0ea7e4] .bv-button.icon-only{padding:0;line-height:1}[data-v-6c0ea7e4] .bv-button.icon-only.medium{width:38px;height:38px}[data-v-6c0ea7e4] .bv-button.icon-only.big{width:46px;height:46px}[data-v-6c0ea7e4] .bv-button.has-icon.medium{padding-left:calc(26px + 1em)}[data-v-6c0ea7e4] .bv-button.has-icon.big{padding-left:calc(30px + 1em)}.bv-more-button[data-v-f229a206]{display:inline-flex;position:relative}.bv-more-button-panel[data-v-f229a206]{z-index:100;border:1px solid var(--vp-c-divider,#e2e2e3);background-color:var(--vp-c-bg-elv,#fff);min-width:180px;box-shadow:var(--vp-shadow-3,0 12px 32px #0000002e);border-radius:8px;flex-direction:column;padding:4px;display:flex;position:fixed}.bv-more-button-item[data-v-f229a206]{color:var(--vp-c-text-1,#3c3c43);white-space:nowrap;border-radius:6px;align-items:center;gap:8px;padding:8px 12px;font-size:14px;text-decoration:none;display:flex}.bv-more-button-item[data-v-f229a206]:hover,.bv-more-button-item[data-v-f229a206]:focus-visible{background-color:var(--vp-c-default-soft,#f2f2f3);outline:none}.bv-more-button-item-icon[data-v-f229a206] svg{width:1em;height:1em}.VPButton[data-v-7730de16]{text-decoration:none}.bv-icon-button[data-v-27cc1a4c]{align-items:center;display:inline-flex;position:relative}.bv-icon-button-icon[data-v-27cc1a4c]{pointer-events:none;justify-content:center;align-items:center;display:inline-flex;position:absolute}.bv-icon-button-icon[data-v-27cc1a4c] svg{width:1em;height:1em}.bv-icon-button.icon-only .bv-icon-button-icon[data-v-27cc1a4c]{inset:0}.bv-icon-button.has-icon .bv-icon-button-icon[data-v-27cc1a4c]{top:50%;transform:translateY(-50%)}.bv-icon-button.has-icon.medium .bv-icon-button-icon[data-v-27cc1a4c]{font-size:14px;left:20px}.bv-icon-button.has-icon.big .bv-icon-button-icon[data-v-27cc1a4c]{font-size:16px;left:24px}[data-v-27cc1a4c] .bv-button.icon-only{padding:0;line-height:1}[data-v-27cc1a4c] .bv-button.icon-only.medium{width:38px;height:38px}[data-v-27cc1a4c] .bv-button.icon-only.big{width:46px;height:46px}[data-v-27cc1a4c] .VPButton.has-icon.medium{padding-left:calc(26px + 1em)}[data-v-27cc1a4c] .VPButton.has-icon.big{padding-left:calc(30px + 1em)}.bv-more-button[data-v-e689232f]{display:inline-flex;position:relative}.bv-more-button-panel[data-v-e689232f]{z-index:100;border:1px solid var(--vp-c-divider);background-color:var(--vp-c-bg-elv);min-width:180px;box-shadow:var(--vp-shadow-3);border-radius:8px;flex-direction:column;padding:4px;display:flex;position:fixed}.bv-more-button-item[data-v-e689232f]{color:var(--vp-c-text-1);white-space:nowrap;border-radius:6px;align-items:center;gap:8px;padding:8px 12px;font-size:14px;text-decoration:none;display:flex}.bv-more-button-item[data-v-e689232f]:hover,.bv-more-button-item[data-v-e689232f]:focus-visible{background-color:var(--vp-c-default-soft);outline:none}.bv-more-button-item-icon[data-v-e689232f] svg{width:1em;height:1em}
+/*$vite$:1*/

package/dist/bojuvue.js

@@ -0,0 +1,174 @@
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./useMoreButtonMenu-BdAgqGZv.js";
+import { Fragment as l, computed as u, createBlock as d, createCommentVNode as f, createElementBlock as p, createTextVNode as m, createVNode as h, defineComponent as g, mergeProps as _, normalizeClass as v, normalizeStyle as y, onMounted as b, openBlock as x, ref as S, renderList as C, toDisplayString as w, unref as T } from "vue";
+//#region src/BVIconButton.vue?vue&type=script&setup=true&lang.ts
+var E = ["innerHTML"], D = /*#__PURE__*/ t(/* @__PURE__ */ g({
+	inheritAttrs: !1,
+	__name: "BVIconButton",
+	props: {
+		text: {},
+		href: {},
+		target: {},
+		rel: {},
+		size: { default: "medium" },
+		theme: { default: "brand" },
+		tag: {},
+		icon: {},
+		label: {}
+	},
+	setup(e) {
+		let t = e, n = u(() => !t.text);
+		return (t, r) => (x(), p("span", { class: v(["bv-icon-button", [e.size, {
+			"icon-only": n.value,
+			"has-icon": !!e.icon && !n.value
+		}]]) }, [h(s, _(t.$attrs, {
+			class: ["bv-icon-button-target", {
+				"icon-only": n.value,
+				"has-icon": !!e.icon && !n.value
+			}],
+			text: e.text ?? "",
+			href: e.href,
+			target: e.target,
+			rel: e.rel,
+			size: e.size,
+			theme: e.theme,
+			tag: e.tag,
+			"aria-label": n.value ? e.label : void 0
+		}), null, 16, [
+			"class",
+			"text",
+			"href",
+			"target",
+			"rel",
+			"size",
+			"theme",
+			"tag",
+			"aria-label"
+		]), e.icon ? (x(), p("span", {
+			key: 0,
+			class: "bv-icon-button-icon",
+			innerHTML: e.icon
+		}, null, 8, E)) : f("", !0)], 2));
+	}
+}), [["__scopeId", "data-v-6c0ea7e4"]]), O = /* @__PURE__ */ g({
+	__name: "BVPlatformButton",
+	props: {
+		manifestUrl: { default: "platformButton.json" },
+		fallbackHref: {},
+		fallbackLabel: {},
+		size: {},
+		theme: {},
+		target: {},
+		rel: {},
+		icon: {},
+		base: { default: "" }
+	},
+	setup(t) {
+		let r = t, o = S(null), { manifest: s } = i(() => a(r.base, r.manifestUrl));
+		b(() => {
+			o.value = n(typeof navigator > "u" ? void 0 : navigator);
+		});
+		let c = u(() => e(o.value, s.value, {
+			fallbackHref: r.fallbackHref,
+			fallbackLabel: r.fallbackLabel
+		}));
+		return (e, n) => c.value ? (x(), d(D, {
+			key: 0,
+			tag: "a",
+			text: c.value.label,
+			href: c.value.href,
+			target: t.target,
+			rel: t.rel,
+			size: t.size,
+			theme: t.theme,
+			icon: t.icon
+		}, null, 8, [
+			"text",
+			"href",
+			"target",
+			"rel",
+			"size",
+			"theme",
+			"icon"
+		])) : f("", !0);
+	}
+}), k = [
+	"href",
+	"target",
+	"rel"
+], A = ["innerHTML"], j = "<svg viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"currentColor\" aria-hidden=\"true\"><circle cx=\"5\" cy=\"12\" r=\"2\"/><circle cx=\"12\" cy=\"12\" r=\"2\"/><circle cx=\"19\" cy=\"12\" r=\"2\"/></svg>", M = /*#__PURE__*/ t(/* @__PURE__ */ g({
+	__name: "BVMoreButton",
+	props: {
+		items: {},
+		icon: {},
+		text: { default: "More..." },
+		label: { default: "More options" },
+		size: {},
+		theme: {}
+	},
+	setup(e) {
+		let t = e, n = u(() => t.icon ?? (t.text ? null : j)), i = S(null), a = S(null), o = S(null), { open: s, panelLeft: d, panelTop: g, setItemRef: _, toggleMenu: v, onTriggerKeydown: b, onMenuKeydown: E } = c({
+			itemCount: () => t.items.length,
+			rootEl: i,
+			iconButtonEl: a,
+			panelEl: o
+		});
+		function O(e) {
+			return e.target ?? (r(e.href) ? "_blank" : void 0);
+		}
+		function M(e) {
+			return e.rel ?? (r(e.href) ? "noreferrer" : void 0);
+		}
+		return (t, r) => (x(), p("span", {
+			ref_key: "rootEl",
+			ref: i,
+			class: "bv-more-button"
+		}, [h(D, {
+			ref_key: "iconButtonEl",
+			ref: a,
+			text: e.text,
+			icon: n.value ?? void 0,
+			size: e.size,
+			theme: e.theme,
+			label: e.text ? void 0 : e.label,
+			"aria-haspopup": "menu",
+			"aria-expanded": T(s),
+			onClick: T(v),
+			onKeydown: T(b)
+		}, null, 8, [
+			"text",
+			"icon",
+			"size",
+			"theme",
+			"label",
+			"aria-expanded",
+			"onClick",
+			"onKeydown"
+		]), T(s) ? (x(), p("div", {
+			key: 0,
+			ref_key: "panelEl",
+			ref: o,
+			class: "bv-more-button-panel",
+			role: "menu",
+			style: y({
+				left: `${T(d)}px`,
+				top: `${T(g)}px`
+			}),
+			onKeydown: r[0] ||= (...e) => T(E) && T(E)(...e)
+		}, [(x(!0), p(l, null, C(e.items, (e, t) => (x(), p("a", {
+			key: e.href,
+			ref_for: !0,
+			ref: (e) => T(_)(e, t),
+			role: "menuitem",
+			class: "bv-more-button-item",
+			href: e.href,
+			target: O(e),
+			rel: M(e)
+		}, [e.icon ? (x(), p("span", {
+			key: 0,
+			class: "bv-more-button-item-icon",
+			innerHTML: e.icon
+		}, null, 8, A)) : f("", !0), m(" " + w(e.label), 1)], 8, k))), 128))], 36)) : f("", !0)], 512));
+	}
+}), [["__scopeId", "data-v-f229a206"]]);
+//#endregion
+export { s as BVButton, D as BVIconButton, M as BVMoreButton, O as BVPlatformButton, o as defaultLabels, n as detectPlatform, e as resolveDownload, a as resolveManifestUrl };

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { default as BVButton } from './BVButton.vue';
+export type { BVButtonProps } from './BVButton.types';
+export { default as BVIconButton } from './BVIconButton.vue';
+export type { BVIconButtonProps } from './BVIconButton.types';
+export { default as BVPlatformButton } from './BVPlatformButton.vue';
+export { detectPlatform, resolveDownload, resolveManifestUrl, defaultLabels } from './platform';
+export type { BVPlatformManifest, BVPlatformEntry, BVPlatformId } from './platform';
+export type { BVPlatformButtonProps } from './BVPlatformButton.types';
+export { default as BVMoreButton } from './BVMoreButton.vue';
+export type { BVMoreButtonItem, BVMoreButtonProps } from './BVMoreButton.types';

package/dist/moreButtonMenu.d.ts

@@ -0,0 +1,9 @@
+export interface MenuPlacementInput {
+    triggerLeft: number;
+    triggerRight: number;
+    panelWidth: number;
+    viewportWidth: number;
+}
+export declare function computeMenuPanelLeft({ triggerLeft, triggerRight, panelWidth, viewportWidth, }: MenuPlacementInput): number;
+export type MenuStepKey = 'ArrowDown' | 'ArrowUp' | 'Home' | 'End';
+export declare function stepMenuIndex(key: MenuStepKey, currentIndex: number, itemCount: number): number;