@rsmlamongan/user-menu 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,61 @@
+LISENSI PROPRIETARY RSML USER MENU
+
+Hak Cipta (c) 2026 Rumah Sakit Muhammadiyah Lamongan.
+Seluruh hak yang tidak diberikan secara tegas tetap dilindungi.
+
+1. Pemegang hak dan ruang lingkup
+
+"RSML" berarti Rumah Sakit Muhammadiyah Lamongan. "Perangkat Lunak"
+berarti kode, hasil build, dan dokumentasi RSML User Menu yang dibuat
+oleh atau untuk RSML. Lisensi ini bukan lisensi open source.
+
+2. Penggunaan untuk RSML
+
+RSML berhak menggunakan, memasang, menyalin, mengembangkan, memodifikasi,
+dan mengintegrasikan Perangkat Lunak dalam aplikasi yang dimiliki atau
+dioperasikan untuk RSML. Pegawai, personel, dan kontraktor yang diberi
+wewenang oleh RSML dapat menjalankan kegiatan tersebut semata-mata
+atas nama dan untuk kepentingan RSML, selama kewenangan itu berlaku.
+
+Izin tersebut mencakup pembuatan salinan untuk development, pengujian,
+build, deployment, dan pemeliharaan aplikasi RSML.
+
+3. Distribusi resmi dan pengguna aplikasi
+
+RSML dan maintainer yang diberi wewenang dapat menerbitkan Perangkat
+Lunak melalui kanal distribusi resmi, termasuk npm dan GitHub. Penyedia
+kanal tersebut diperbolehkan menyimpan, menyalin, menganalisis, dan
+mendistribusikan salinan untuk menyediakan layanan distribusi resmi
+sesuai ketentuan layanan yang disetujui RSML.
+
+RSML dapat menyertakan Perangkat Lunak dalam bundle JavaScript dan
+mengirimkannya kepada pengguna aplikasi RSML. Pengguna aplikasi diberi
+izin menjalankan salinan tersebut sebatas penggunaan aplikasi RSML.
+Izin ini tidak memberikan hak untuk memakai Perangkat Lunak dalam
+aplikasi pihak lain atau mendistribusikannya sebagai library tersendiri.
+
+4. Pembatasan untuk pihak lain
+
+Tersedianya package untuk diunduh secara publik tidak memberikan izin
+penggunaan untuk kepentingan pihak lain. Tanpa izin tertulis dari RSML,
+pihak lain tidak diperbolehkan menggunakan, memodifikasi, mengintegrasikan,
+menjual, memberikan sublisensi, atau mendistribusikan Perangkat Lunak
+maupun turunannya untuk kepentingannya sendiri atau pihak selain RSML.
+
+Pernyataan hak cipta dan lisensi harus dipertahankan pada salinan yang
+didistribusikan melalui kanal resmi. Tidak ada hak atas nama atau merek
+RSML yang diberikan oleh lisensi ini.
+
+5. Komponen pihak ketiga
+
+Lisensi ini hanya berlaku atas materi yang haknya dimiliki RSML.
+Komponen pihak ketiga tetap mengikuti hak cipta dan lisensinya
+masing-masing; lisensi ini tidak membatasi hak yang diberikan oleh
+lisensi komponen pihak ketiga tersebut.
+
+6. Jaminan dan tanggung jawab
+
+Perangkat Lunak disediakan "sebagaimana adanya", tanpa jaminan tegas
+atau tersirat sejauh diperbolehkan oleh hukum yang berlaku. Sejauh
+diperbolehkan oleh hukum yang berlaku, RSML tidak bertanggung jawab
+atas kerugian yang timbul dari penggunaan Perangkat Lunak.

package/README.md

@@ -1,3 +1,274 @@
-# Temporary Holding Version
+# RSML User Menu
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Library Vue + Vuetify untuk drawer pengguna di sisi kanan aplikasi. Pengguna dapat menyimpan halaman aktif sebagai favorit, membuka shortcut lintas aplikasi, menghapus favorit, dan menyimpan urutannya.
+
+**Status: frontend, mock persisten, dan adapter HTTP tersedia.** Backend User Menu diimplementasikan dalam source kepegawaian-api. Identitas package adalah `@rsmlamongan/user-menu@0.0.0`, dengan lisensi proprietary milik Rumah Sakit Muhammadiyah Lamongan. Pemasangan tabel, deployment/integrasi produksi, eksekusi GitHub Actions, bootstrap npm, dan publikasi OIDC belum dibuktikan.
+
+## Development lokal
+
+Gunakan Bun 1.4.2 dan Node.js `^22.18.0 || >=24.12.0`. Target peer dependencies adalah Vue `>=3.5.42 <4` dan Vuetify `>=4.2.0 <5`. Pengujian lokal menggunakan versi yang dikunci dalam `bun.lock`, bukan seluruh kemungkinan versi pada rentang tersebut. Vuetify 3 belum didukung.
+
+```bash
+bun install --frozen-lockfile
+bun run dev
+```
+
+Buka [playground](http://127.0.0.1:3000), lalu klik avatar di kanan atas. Playground menyediakan dua akun sintetis/logout, metadata halaman, tema terang/gelap, callback pengaturan, latensi, dan kegagalan operasi berikutnya. Favorit Ayu mencakup dua aplikasi; Bima mulai dengan daftar kosong.
+
+| Perintah                      | Kegunaan                                                                          |
+| ----------------------------- | --------------------------------------------------------------------------------- |
+| `bun run type-check`          | Memeriksa library, playground, dan tooling/tes.                                   |
+| `bun run lint:check`          | Oxlint dan ESLint mengikuti baseline tim.                                         |
+| `bun run format:check`        | Memeriksa format Prettier.                                                        |
+| `bun run format`              | Menerapkan format.                                                                |
+| `bun run test:unit`           | Vitest, Vue Test Utils, dan jsdom.                                                |
+| `bun run test:release`        | Guard versi/tag, checksum, registry, dan pemulihan GitHub Release dengan fixture. |
+| `bun run test:e2e`            | Chromium desktop/mobile terhadap development server.                              |
+| `bun run build`               | ESM, CSS, serta deklarasi tipe ke `dist/`.                                        |
+| `bun run build:playground`    | Aplikasi contoh ke `playground-dist/`.                                            |
+| `bun run test:e2e:production` | Chromium terhadap hasil build playground.                                         |
+| `bun run preview`             | Preview playground di `http://127.0.0.1:4173`.                                    |
+| `bun run verify:package`      | Pack, audit isi, install consumer terpisah, type-check, build, dan smoke browser. |
+
+Pasang browser untuk pengujian pada mesin baru dengan `bunx playwright install chromium`. Tes memakai data contoh dan browser context terpisah. `verify:package` membutuhkan perintah `tar`. Instalasi consumer pertama memakai cache Bun bila tersedia dan dapat mengunduh metadata atau dependency yang belum ada; instalasi kedua memakai lockfile hasilnya dalam mode frozen dan offline. Hasilnya disimpan di `.cache/`.
+
+Konfigurasi disesuaikan dari `rsml-boilerplate-web`: Bun, TypeScript, import sorting, Oxlint/ESLint, Prettier, dan pola tooling tes tim dipertahankan. Router, Pinia, HTTP client, token, dan instance Vuetify tidak dibuat oleh library.
+
+## Instalasi lokal dan rilis berikutnya
+
+Setelah build dan pemasangan Chromium, verifikasi tarball development:
+
+```bash
+bun run build
+bun run verify:package
+```
+
+Salin tarball ke aplikasi contoh, lalu pilih salah satu perintah berikut. Path ini adalah contoh lokasi tarball lokal, bukan package yang sudah tersedia di npm:
+
+```bash
+bun add --exact ./npm-package.tgz
+npm install --save-exact ./npm-package.tgz
+```
+
+Verifier menghasilkan `.cache/npm-package.tgz` dan `.cache/SHA512SUMS`. Setelah versi yang dituju benar-benar diterbitkan, instal melalui registry; `0.1.0` berikut adalah **contoh versi rilis pertama**, bukan klaim bahwa versi tersebut sudah tersedia:
+
+```bash
+bun add --exact @rsmlamongan/user-menu@0.1.0
+npm install --save-exact @rsmlamongan/user-menu@0.1.0
+```
+
+Instalasi package publik tidak memerlukan token registry; publikasi tetap hanya oleh maintainer berwenang. Setiap aplikasi memilih versi pasti dan memperbarui lockfile, build, serta deployment sendiri. Tidak ada update otomatis pada aplikasi ter-deploy.
+
+Package publik tetap dapat diunduh siapa pun. [Lisensi](LICENSE) membatasi penggunaan untuk aplikasi RSML dan personel yang bertindak atas nama RSML; penggunaan untuk kepentingan pihak lain memerlukan izin tertulis. [Panduan rilis](docs/RELEASING.md) menjelaskan akun, bootstrap satu kali, pengaturan OIDC, push tag, dan pemulihan kegagalan.
+
+## Integrasi
+
+Contoh memakai identitas package `@rsmlamongan/user-menu`, yang dapat dipasang dari tarball lokal sebelum publikasi pertama. Aplikasi sudah memiliki Vue, Vuetify beserta `vuetify/styles`, dan sesi auth sendiri. Tiga fungsi dari `./user-menu-integration` merupakan adapter yang dibuat oleh aplikasi pemakai, bukan file bawaan package.
+
+```ts
+import { createUserMenu } from "@rsmlamongan/user-menu";
+import { createMockUserMenuApi } from "@rsmlamongan/user-menu/mock";
+import "@rsmlamongan/user-menu/style.css";
+
+import { getCurrentPage, getSession, openUserSettings } from "./user-menu-integration";
+
+// Development saja. Gunakan adapter HTTP berikut untuk backend kepegawaian-api.
+const api = createMockUserMenuApi({ getSession });
+
+app.use(
+  createUserMenu({
+    appId: "inventaris",
+    getSession,
+    getCurrentPage,
+    api,
+    settings: { label: "Pengaturan pengguna", onClick: openUserSettings },
+  })
+);
+```
+
+`getSession()` harus membaca state auth reaktif dan mengembalikan `UserMenuSession | null`. `key` membedakan siklus login dan bukan token. `getCurrentPage()` menyediakan judul serta URL HTTP(S) absolut terbaru, termasuk query/hash yang layak disimpan. Pengaturan juga dapat memakai `{ label, url }`.
+
+Untuk backend, gunakan ekspor `/http` dengan HTTP client aplikasi yang sudah menangani token dan refresh:
+
+```ts
+import { createHttpUserMenuApi } from "@rsmlamongan/user-menu/http";
+
+const api = createHttpUserMenuApi({
+  baseUrl: "/api/v1", // Sesuaikan prefix proxy aplikasi.
+  request: async ({ method, url, body }) => {
+    const result = await client.request({
+      method,
+      url,
+      data: body,
+      validateStatus: () => true,
+    });
+    return { status: result.status, body: result.data };
+  },
+});
+```
+
+`client` adalah instance Axios milik aplikasi, bukan bawaan library. Pasang `api` ini pada konfigurasi plugin yang sama. Callback harus resolve juga untuk HTTP error; adapter membaca kode logis dalam envelope `RestResource`. Lihat [kontrak HTTP dan pemasangan backend](docs/API-CONTRACT.md#adapter-http).
+
+Pasang satu host di dalam `v-app` yang sudah ada dan hubungkan avatar aplikasi:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+
+import { UserMenuHost } from "@rsmlamongan/user-menu";
+
+const menuOpen = ref(false);
+</script>
+
+<template>
+  <v-app>
+    <v-app-bar>
+      <v-spacer />
+      <v-btn
+        icon
+        variant="text"
+        aria-label="Buka menu pengguna"
+        :aria-expanded="menuOpen"
+        @click="menuOpen = !menuOpen"
+      >
+        <v-avatar color="primary" size="32">U</v-avatar>
+      </v-btn>
+    </v-app-bar>
+    <v-main><!-- Konten aplikasi --></v-main>
+    <UserMenuHost v-model="menuOpen" />
+  </v-app>
+</template>
+```
+
+`v-model` boolean wajib disediakan; inisialisasikan dengan `ref(false)`. Plugin menyediakan konfigurasi melalui provide/inject. State UI dibuat privat oleh host, terisolasi antar-host/aplikasi, dan dibersihkan ketika host atau aplikasi di-unmount. Logout atau pergantian key sesi/ID pengguna menyinkronkan model ke `false`, membuang draft, dan mengabaikan respons sesi lama. API visibilitas hanya melalui model, tanpa mode kompatibilitas imperatif.
+
+Seluruh pengelolaan favorit berada di drawer. Mode edit memakai draft lokal dengan **Simpan/Batal**, hapus, drag-and-drop, serta tombol naik/turun. Kegagalan Simpan mempertahankan draft; penutupan dengan perubahan meminta konfirmasi. Selama mutasi, penutupan ditahan kecuali sesi berubah.
+
+Ketika parent mengubah model menjadi `false` tetapi penutupan ditolak, library mengoreksinya kembali ke `true` dan drawer tetap terbuka. Draft berubah menampilkan konfirmasi; **Buang perubahan** menutup dan menghasilkan `false`, sedangkan **Lanjutkan edit** mempertahankan `true`. Selama mutasi, permintaan tutup diabaikan tanpa menutup otomatis setelah mutasi selesai. Perubahan singkat `false` lalu `true` dapat terjadi; jangan menganggap setiap assignment `false` sebagai penutupan yang sudah diterima.
+
+Model awal `true` diproses setelah mounted. Tanpa sesi aktif, model dikoreksi menjadi `false` tanpa request daftar. Cleanup saat unmount tidak mengubah model parent; jika host dipasang kembali dengan model masih `true`, state baru dibuat dan daftar dimuat kembali.
+
+### Daftar dari aplikasi melalui props
+
+Gunakan prop `items` jika aplikasi sudah memuat daftar favorit sendiri:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+
+import { type Favorite, UserMenuHost } from "@rsmlamongan/user-menu";
+
+const open = ref(false);
+const menuItems = ref<Favorite[]>([]);
+// Isi menuItems dari daftar lengkap favorit milik pengguna yang sedang login.
+</script>
+
+<template>
+  <UserMenuHost v-model="open" :items="menuItems" @update:items="menuItems = $event" />
+  <!-- Penulisan setara: <UserMenuHost v-model="open" v-model:items="menuItems" /> -->
+</template>
+```
+
+- `items` berisi `Favorite[]` (array readonly juga diterima), dengan field `id`, `title`, `url`, dan `appId`. Urutan array menjadi urutan tampilan.
+- Jika `items` diberikan, termasuk `[]`, host tidak memanggil `listFavorites()`. Perubahan array maupun field item di parent diikuti secara reaktif. Tanpa prop atau ketika nilainya `undefined`, host kembali memuat melalui API.
+- Tambah/hapus/urut menggunakan callback `@create`/`@save` jika diberikan, atau adapter API pada plugin. Setelah mutasi berhasil, host memperbarui tampilannya dan mengirim **salinan daftar lengkap** melalui `update:items`. Batal, kegagalan, dan respons sesi lama tidak mengirim event ini.
+- Props tidak dimutasi. Tangkap event seperti contoh, atau gunakan `v-model:items`, agar pembukaan berikutnya memakai hasil terbaru. Dengan `:items` saja, pembukaan berikutnya kembali memakai nilai props parent.
+
+Aplikasi bertanggung jawab atas loading/error pemuatan eksternal, daftar lengkap dari sumber penyimpanan yang sama dengan adapter mutasi, serta pemisahan data per sesi. Bersihkan daftar ketika akun berubah dan abaikan respons lama pada loader parent; prop ini tidak menggantikan autentikasi atau otorisasi API. Data props divalidasi dengan aturan favorit yang sama; data tidak valid menampilkan error tanpa fallback request API.
+
+Pembaruan props saat edit mempertahankan draft, tetapi perubahan yang membuat draft tertinggal menolak Simpan sebagai konflik. Batal menampilkan daftar parent terbaru. Hasil mutasi tertunda juga tidak menimpa props yang sudah berubah; transaksi API mungkin sudah selesai sehingga parent perlu memuat ulang sumbernya.
+
+Di playground, aktifkan **Gunakan items dari aplikasi** untuk mencoba loader parent, sinkronisasi hasil mutasi, dan pemisahan akun. Sakelar default nonaktif.
+
+### Delegasi tambah dan Simpan
+
+Parent dapat menangani operasi penyimpanan sendiri melalui `@create` dan `@save`, secara independen dari sumber daftar:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+
+import {
+  type Favorite,
+  type UserMenuCreateHandler,
+  UserMenuHost,
+  type UserMenuSaveHandler,
+} from "@rsmlamongan/user-menu";
+
+import { api } from "./user-menu-integration";
+
+const open = ref(false);
+const menuItems = ref<Favorite[]>([]);
+const handleCreate: UserMenuCreateHandler = async (input) => {
+  return api.createFavorite(input);
+};
+const handleSave: UserMenuSaveHandler = async (input) => {
+  return api.saveFavoriteChanges(input);
+};
+</script>
+
+<template>
+  <UserMenuHost
+    v-model="open"
+    v-model:items="menuItems"
+    @create="handleCreate"
+    @save="handleSave"
+  />
+</template>
+```
+
+`api` di contoh adalah client milik aplikasi, bukan objek yang wajib dipasang pada plugin. Isi `menuItems` melalui loader aplikasi seperti pada bagian sebelumnya. Handler create menerima `{ title, url, appId }` dan mengembalikan `Promise<Favorite>` dengan ID baru. Handler save menerima `{ orderedIds, deletedIds }` dan mengembalikan `Promise<Favorite[]>` sesuai urutan tersimpan. **Kembalikan hasil dengan `return` dan teruskan kegagalan dengan throw/reject**; jangan menelan error atau mengubahnya menjadi hasil sukses palsu.
+
+Host menyediakan callback props `onCreate`/`onSave`, yang dapat ditulis sebagai `@create`/`@save` atau `:on-create`/`:on-save`. Library memanggil callback langsung dan menunggu Promise; kedua nama ini bukan event `$emit` biasa. Gunakan satu handler per operasi tanpa modifier seperti `.once`. Event `update:modelValue` dan `update:items` tetap event Vue biasa.
+
+| Operasi             | Prioritas                                                       |
+| ------------------- | --------------------------------------------------------------- |
+| Daftar              | `items` jika diberikan; selain itu `api.listFavorites()`.       |
+| Tambah              | `@create` jika diberikan; selain itu `api.createFavorite()`.    |
+| Simpan hapus/urutan | `@save` jika diberikan; selain itu `api.saveFavoriteChanges()`. |
+
+Handler yang gagal tidak memicu fallback ke adapter. Library tetap mengelola loading, penahanan penutupan, validasi hasil, serta form/draft ketika gagal. Provider dipilih saat operasi dimulai; mengganti atau menghapus handler tidak mengalihkan request yang sedang berjalan.
+
+Parent cukup mengembalikan hasil dan menerima pembaruan daftar melalui `update:items`/`v-model:items`. Jangan memperbarui `menuItems` di dalam handler sebelum hasil dikembalikan: perubahan props selama mutasi mengikuti pemeriksaan konflik yang sama dan hasil lama tidak akan menimpa data baru. Hasil sesi lama atau setelah unmount tidak diterapkan.
+
+Dengan `items` serta kedua handler, plugin boleh tanpa `api`:
+
+```ts
+app.use(createUserMenu({ appId: "inventaris", getSession, getCurrentPage }));
+```
+
+Plugin, sesi reaktif, dan metadata halaman tetap diperlukan. Jika adapter diberikan, bentuk `UserMenuApi` lengkap berisi tiga operasi: `listFavorites`, `createFavorite`, dan `saveFavoriteChanges`. Tanpa provider tambah/edit, kontrol terkait dinonaktifkan; jika provider save hilang saat edit, Simpan dinonaktifkan sementara Batal tetap tersedia. Tanpa sumber daftar, drawer menampilkan pesan tidak tersedia dan retry dinonaktifkan. Tidak ada timeout atau pembatalan request otomatis; Promise handler harus selesai melalui resolve/reject.
+
+Playground menyediakan **Delegasikan create/save ke parent (tanpa adapter)**, default nonaktif. Mode ini mengaktifkan daftar dari aplikasi dan menampilkan jumlah pemanggilan callback untuk pengujian latensi, kegagalan, serta pergantian akun.
+
+### Slot header dan footer
+
+Slot `header` pada `UserMenuHost` opsional dan kosong secara default: tanpa slot, tidak ada wrapper atau jarak tambahan. Library tidak menampilkan header identitas. Tombol tutup berada sejajar dengan judul **Favorit saya/Edit favorit**; nama aksesibel drawer tetap **Menu pengguna**.
+
+Slot `footer` berada di dasar drawer, di luar area scroll. Konten kustom menggantikan seluruh fallback Pengaturan. Jika footer tidak diberikan tetapi opsi plugin `settings` tersedia, library menampilkan tombol Pengaturan pada area tersebut. Tanpa keduanya, area footer tidak dirender.
+
+Footer menerima `openSettings(): Promise<void>` dan `settingsDisabled: boolean`. Gunakan keduanya untuk menjalankan callback/URL `settings` dengan pembatasan edit, operasi berlangsung, dan sesi. Slot header tidak menerima props. Consumer lama yang mengabaikan slot props tetap dapat digunakan.
+
+```vue
+<UserMenuHost v-model="menuOpen">
+  <template #footer="{ openSettings, settingsDisabled }">
+    <div class="account-actions">
+      <v-btn variant="text" :disabled="settingsDisabled" @click="openSettings">Pengaturan</v-btn>
+      <v-btn variant="text" @click="logout">Keluar</v-btn>
+    </div>
+  </template>
+</UserMenuHost>
+```
+
+`logout` merupakan callback aplikasi pemakai. Beri `account-actions` layout grid dua kolom sama lebar dengan gap 8px agar kedua tombol tetap satu baris pada desktop/mobile. Isi slot header hanya jika aplikasi memang memerlukannya. Kedua slot tersedia pada mode normal, edit, loading, dan error. Di playground, **Tampilkan contoh slot** menyediakan header opsional dan Pengaturan/Bantuan dalam satu baris.
+
+## Dokumentasi dan batas
+
+- [Panduan development](docs/DEVELOPMENT.md): tanggung jawab, lifecycle, alur UI, tooling, dan penerimaan.
+- [Kontrak API](docs/API-CONTRACT.md): model, tiga operasi adapter, error, mock, dan kebutuhan backend.
+- [Panduan rilis](docs/RELEASING.md): CI, akun maintainer, bootstrap npm, OIDC, dan penanganan kegagalan.
+- [Playground integrasi](playground/main.ts): contoh konfigurasi yang dapat dijalankan.
+
+Mock `localStorage` hanya untuk data sintetis per origin. Pemisahan ID pengguna pada mock tidak membuktikan otorisasi server atau sinkronisasi lintas origin. Backend dan adapter HTTP tersedia di source; penerapan schema dan integrasi produksi tetap perlu diverifikasi. Pipeline rilis tersedia, tetapi keberhasilan publikasi harus diverifikasi setelah pengaturan GitHub/npm selesai. Tidak ada formulir akun, editor URL, folder favorit, atau dukungan Vuetify 3.
+
+Referensi: [plugin Vue](https://vuejs.org/guide/reusability/plugins.html), [Vite Library Mode](https://vite.dev/guide/build.html#library-mode), dan [HTML Drag and Drop API](https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API).

package/dist/components/UserMenuHost.vue.d.ts

@@ -0,0 +1,33 @@
+import { type VNode } from "vue";
+import type { Favorite, UserMenuCreateHandler, UserMenuSaveHandler } from "../types.js";
+type __VLS_Props = {
+    items?: readonly Favorite[];
+    onCreate?: UserMenuCreateHandler;
+    onSave?: UserMenuSaveHandler;
+};
+type __VLS_Slots = {
+    header?(): VNode[];
+    footer?(props: {
+        openSettings: () => Promise<void>;
+        settingsDisabled: boolean;
+    }): VNode[];
+};
+type __VLS_ModelProps = {
+    modelValue: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:items": (items: Favorite[]) => any;
+    "update:modelValue": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:items"?: ((items: Favorite[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export type UserMenuErrorCode = "unauthenticated" | "invalid-input" | "duplicate" | "conflict" | "unavailable";
+export declare class UserMenuError extends Error {
+    readonly code: UserMenuErrorCode;
+    constructor(code: UserMenuErrorCode);
+}
+export declare function errorMessage(error: unknown, fallback: string): string;

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+import type { UserMenuApi } from "./types.js";
+export interface UserMenuHttpRequest {
+    method: "GET" | "POST" | "PUT";
+    url: string;
+    body?: unknown;
+}
+export interface UserMenuHttpResponse {
+    status: number;
+    body: unknown;
+}
+export interface HttpUserMenuApiOptions {
+    /** Root API v1, including any reverse-proxy prefix. */
+    baseUrl: string;
+    /** Resolve HTTP errors too; reject only for transport failures. Auth belongs to the host. */
+    request: (input: UserMenuHttpRequest) => Promise<UserMenuHttpResponse>;
+}
+export declare function createHttpUserMenuApi(options: HttpUserMenuApiOptions): UserMenuApi;

package/dist/http.js

@@ -0,0 +1,70 @@
+import { a as e, i as t, n, r, t as i } from "./validation-ZwudKvW7.js";
+//#region src/http.ts
+function a(e) {
+	return typeof e == "object" && e && !Array.isArray(e) ? e : void 0;
+}
+function o(t, n) {
+	return t === 401 ? new e("unauthenticated") : t === 400 ? new e("invalid-input") : t === 409 ? new e(Array.isArray(n?.errors) && n.errors.includes("duplicate") ? "duplicate" : "conflict") : new e("unavailable");
+}
+function s(s) {
+	let c = r(s.baseUrl).replace(/\/+$/, "");
+	if (/[?#]/.test(c) || typeof s.request != "function") throw new e("invalid-input");
+	let l = `${c}/user-menu/favorites`, u = s.request;
+	async function d(t, n, r) {
+		let i;
+		try {
+			i = await u(r === void 0 ? {
+				method: t,
+				url: l
+			} : {
+				method: t,
+				url: l,
+				body: r
+			});
+		} catch (t) {
+			throw t instanceof e ? t : new e("unavailable");
+		}
+		if (!a(i) || !Number.isInteger(i.status) || i.status < 100 || i.status > 599) throw new e("unavailable");
+		let s = a(i.body), c = a(s?.metadata);
+		if (i.status < 200 || i.status >= 300) throw o(i.status, c);
+		let d = c?.code;
+		if (typeof d != "number" || !Number.isInteger(d)) throw new e("unavailable");
+		if (d >= 400) throw o(d, c);
+		if (d !== n) throw new e("unavailable");
+		return s?.response;
+	}
+	async function f(t, r) {
+		let i = await d(t, 200, r);
+		try {
+			return n(i);
+		} catch {
+			throw new e("unavailable");
+		}
+	}
+	return {
+		listFavorites: () => f("GET"),
+		async createFavorite(n) {
+			let a = await d("POST", 201, {
+				title: r(n?.title),
+				url: t(n?.url),
+				appId: r(n?.appId)
+			});
+			try {
+				return i(a);
+			} catch {
+				throw new e("unavailable");
+			}
+		},
+		async saveFavoriteChanges(t) {
+			if (!Array.isArray(t?.orderedIds) || !Array.isArray(t?.deletedIds)) throw new e("invalid-input");
+			let n = {
+				orderedIds: [...t.orderedIds],
+				deletedIds: [...t.deletedIds]
+			};
+			for (let e of [...n.orderedIds, ...n.deletedIds]) r(e);
+			return f("PUT", n);
+		}
+	};
+}
+//#endregion
+export { s as createHttpUserMenuApi };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { UserMenuError } from "./errors.js";
+export type { UserMenuErrorCode } from "./errors.js";
+export { createUserMenu } from "./plugin.js";
+export type { CreateFavoriteInput, CurrentPage, Favorite, SaveFavoriteChangesInput, UserMenuApi, UserMenuCreateHandler, UserMenuOptions, UserMenuSaveHandler, UserMenuSession, UserMenuSettings, UserMenuUser, } from "./types.js";
+export { default as UserMenuHost } from "./components/UserMenuHost.vue";