@bagelink/vue 1.16.0 → 1.17.6

package/dist/types/BagelForm.d.ts

@@ -98,6 +98,10 @@ export interface UploadInputValueObject {
     src?: string;
 }
 export interface UploadInputProps extends BagelInputShellProps {
+    /** Opt-in stable reference output; defaults to legacy path-key behavior. */
+    assetMode?: boolean;
+    /** Asset delivery policy. Defaults to protected; website/media fields use public. */
+    assetVisibility?: import('../assets').AssetVisibility;
     id?: string;
     name?: string;
     label?: string;
@@ -106,7 +110,7 @@ export interface UploadInputProps extends BagelInputShellProps {
      * Path-key string(s). Legacy/migrated records may also provide an image object
      * (e.g. `{ imageURL, imageName, extension, altText }`); it is normalized internally.
      */
-    modelValue?: string | string[] | UploadInputValueObject | (string | UploadInputValueObject)[];
+    modelValue?: string | string[] | UploadInputValueObject | import('../assets').AssetReference | (string | UploadInputValueObject | import('../assets').AssetReference)[];
     /** Optional upload handler. When omitted, the shared file-storage uploader is used. */
     upload?: (file: File) => Promise<string>;
     width?: string;

package/dist/types/BagelForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BagelForm.d.ts","sourceRoot":"","sources":["../../src/types/BagelForm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BagelForm.d.ts","sourceRoot":"","sources":["../../src/types/BagelForm.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/vue",
   "type": "module",
-  "version": "1.16.0",
+  "version": "1.17.6",
   "description": "Bagel core sdk packages",
   "author": {
     "name": "Bagel Studio",

package/src/assetTransport.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, it, vi } from 'vitest'
+import { configureAssetClient, createAssetHttpTransport, type AssetFetch } from './assetTransport'
+import { createAssetClient } from './assets'
+import type { ApiTransport } from '@bagelink/sdk'
+import { createApp, ref } from 'vue'
+
+const session = { asset_id: 'a', upload_id: 'u', status: 'ready' }
+const json = (value: unknown, status = 200) => new Response(JSON.stringify(value), { status })
+const signal = () => new AbortController().signal
+
+describe('asset REST transport', () => {
+	it('starts a session and sends unchanged raw bytes, returning the public id', async () => {
+		const fetcher = vi.fn<AssetFetch>().mockResolvedValueOnce(json(session)).mockResolvedValueOnce(json(session))
+		const transport = createAssetHttpTransport({ baseURL: 'https://api.example/api', fetch: fetcher })
+		const file = new File(['original'], 'test.heic')
+		expect(await transport.upload(file, signal())).toEqual({ asset_id: 'a' })
+		expect(String(fetcher.mock.calls[0]![0])).toBe('https://api.example/api/assets/uploads')
+		expect(fetcher.mock.calls[0]![1]?.body).toBe('{"name":"test.heic"}')
+		expect(fetcher.mock.calls[1]![1]?.body).toBe(file)
+		expect(new Headers(fetcher.mock.calls[1]![1]?.headers).get('Content-Type')).toBe('application/octet-stream')
+	})
+
+	it('fails closed for rejected completion and HTTP errors', async () => {
+		const fetcher = vi.fn<AssetFetch>().mockResolvedValueOnce(json(session))
+			.mockResolvedValueOnce(json({ ...session, status: 'rejected' })).mockResolvedValueOnce(json({}, 403))
+		const transport = createAssetHttpTransport({ baseURL: 'https://api.example', fetch: fetcher })
+		await expect(transport.upload(new File(['x'], 'x'), signal())).rejects.toThrow('not ready')
+		await expect(transport.upload(new File(['x'], 'x'), signal())).rejects.toThrow('(403)')
+	})
+
+	it('does not PUT if session creation fails', async () => {
+		const fetcher = vi.fn<AssetFetch>().mockResolvedValueOnce(json({}, 503))
+		const transport = createAssetHttpTransport({ baseURL: 'https://api.example', fetch: fetcher })
+		await expect(transport.upload(new File(['x'], 'x'), signal())).rejects.toThrow('(503)')
+		expect(fetcher).toHaveBeenCalledTimes(1)
+	})
+
+	it('configureAssetClient provides a client that builds public URLs', () => {
+		const transport = { axios: { defaults: { baseURL: 'https://api.example/api' }, request: vi.fn() } } as unknown as ApiTransport
+		const assets = configureAssetClient({ transport, deliveryBaseUrl: 'https://cdn.bgl.dev/auctentic' })
+		expect(assets.client.assetUrl({ asset_id: 'a' })).toBe('https://cdn.bgl.dev/auctentic/a')
+		expect(assets.client.assetUrl({ asset_id: 'a' }, 'website')).toBe('https://cdn.bgl.dev/auctentic/a?fmt=webp')
+		expect(assets.client.assetUrl({ asset_id: 'a' }, 'social')).toBe('https://cdn.bgl.dev/auctentic/a?w=1200&h=630&fmt=jpeg&fit=cover')
+	})
+
+	it('clears in-flight uploads on session change', async () => {
+		let requestSignal: AbortSignal | null | undefined
+		const fetcher = vi.fn<AssetFetch>((config: any) => {
+			requestSignal = config?.signal
+			return new Promise((_resolve, reject) => requestSignal?.addEventListener('abort', () => reject(requestSignal?.reason))
+			)
+		})
+		const transport = { axios: { defaults: { baseURL: 'https://api.example' }, request: fetcher } } as unknown as ApiTransport
+		const sessionKey = ref('a')
+		const assets = configureAssetClient({ transport, deliveryBaseUrl: 'https://cdn.bgl.dev/auctentic', sessionKey })
+		createApp({}).use(assets)
+		const promise = assets.client.upload(new File(['x'], 'x'))
+		sessionKey.value = 'b'
+		await expect(promise).rejects.toMatchObject({ name: 'AbortError' })
+		expect(requestSignal?.aborted).toBe(true)
+	})
+})
+
+describe('asset client upload cancellation', () => {
+	it('does not complete after clearSession', async () => {
+		let finish!: (response: Response) => void
+		const fetcher = vi.fn<AssetFetch>().mockImplementationOnce(() => new Promise(resolve => { finish = resolve }))
+		const client = createAssetClient(createAssetHttpTransport({ baseURL: 'https://api.example', fetch: fetcher }), 'https://cdn.bgl.dev/auctentic')
+		const promise = client.upload(new File(['x'], 'x'))
+		client.clearSession()
+		finish(json(session))
+		await expect(promise).rejects.toMatchObject({ name: 'AbortError' })
+		expect(fetcher).toHaveBeenCalledTimes(1)
+	})
+})

package/src/assetTransport.ts

@@ -0,0 +1,98 @@
+import { createAssetClient, ASSET_CLIENT_KEY, type AssetTransport } from './assets'
+import type { ApiTransport } from '@bagelink/sdk'
+import { watch, toValue, type App, type MaybeRefOrGetter } from 'vue'
+
+export type AssetFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
+
+export interface AssetHttpOptions {
+	/** Absolute API base, optionally with a path prefix. */
+	baseURL: string
+	headers?: () => HeadersInit
+	fetch?: AssetFetch
+	credentials?: RequestCredentials
+	/** Reuse the app's authenticated axios instance, including tenant interceptors. */
+	apiTransport?: ApiTransport
+}
+
+interface UploadResponse {
+	asset_id: string
+	upload_id: string
+	status: string
+}
+
+/** Concrete REST adapter. Public-by-default: upload only; display is a client-built URL. */
+export function createAssetHttpTransport(options: AssetHttpOptions): AssetTransport {
+	const base = new URL(options.baseURL.endsWith('/') ? options.baseURL : `${options.baseURL}/`)
+	if (!['http:', 'https:'].includes(base.protocol) || base.username || base.password) throw new Error('Invalid API base')
+	const request = options.fetch ?? globalThis.fetch
+	async function send<T>(path: string, init: RequestInit, signal: AbortSignal): Promise<T> {
+		signal.throwIfAborted()
+		const headers = new Headers(options.headers?.())
+		new Headers(init.headers).forEach((value, key) => headers.set(key, value))
+		if (options.apiTransport) {
+			const requestHeaders: Record<string, string> = {}
+			headers.forEach((value, key) => { requestHeaders[key] = value })
+			const response = await options.apiTransport.axios.request<T>({
+				url: `assets/${path}`, method: init.method, data: init.body,
+				headers: requestHeaders, signal,
+			})
+			signal.throwIfAborted()
+			return response.data
+		}
+		const response = await request(new URL(`assets/${path}`, base), {
+			...init, headers, signal, credentials: options.credentials ?? 'include', cache: 'no-store', redirect: 'error',
+		})
+		signal.throwIfAborted()
+		if (!response.ok) throw new Error(`Asset request failed (${response.status})`)
+		return await response.json() as T
+	}
+	return {
+		async upload(file, signal, uploadOptions) {
+			const started = await send<UploadResponse>('uploads', {
+				method: 'POST',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify({
+					name: file.name,
+					visibility: uploadOptions?.visibility ?? 'protected',
+				}),
+			}, signal)
+			if (!started.upload_id || !started.asset_id) throw new Error('Invalid upload session')
+			const completed = await send<UploadResponse>(`uploads/${encodeURIComponent(started.upload_id)}`, {
+				method: 'PUT', headers: { 'Content-Type': 'application/octet-stream' }, body: file,
+			}, signal)
+			if (completed.status !== 'ready' || completed.asset_id !== started.asset_id) {
+				throw new Error('Asset upload is not ready')
+			}
+			return { asset_id: completed.asset_id }
+		},
+	}
+}
+
+export interface ConfigureAssetClientOptions {
+	transport: ApiTransport
+	/** Public CDN base, e.g. `https://cdn.bgl.dev/auctentic`. Used to build asset URLs. */
+	deliveryBaseUrl: string
+	/** Identity + tenant key; must change on logout and account/tenant switch. */
+	sessionKey?: MaybeRefOrGetter<string | undefined>
+}
+
+/** Vue plugin; provides the asset client and clears uploads on session change. */
+export function configureAssetClient(options: ConfigureAssetClientOptions) {
+	const baseURL = options.transport.axios.defaults.baseURL
+	if (!baseURL) throw new Error('Asset transport needs an API baseURL')
+	const transport = createAssetHttpTransport({
+		baseURL: new URL(baseURL, typeof location === 'undefined' ? undefined : location.origin).href,
+		apiTransport: options.transport,
+	})
+	const client = createAssetClient(transport, options.deliveryBaseUrl)
+	return {
+		client,
+		install(app: App) {
+			app.provide(ASSET_CLIENT_KEY, client)
+			const stop = options.sessionKey
+				? watch(() => toValue(options.sessionKey), () => client.clearSession(), { flush: 'sync' })
+				: undefined
+			app.onUnmount(() => { stop?.(); client.clearSession() })
+		},
+	}
+}

package/src/assets.test.ts

@@ -0,0 +1,82 @@
+// @vitest-environment happy-dom
+import { describe, expect, it, vi } from 'vitest'
+import { createAssetClient, ASSET_CLIENT_KEY, useAssetDelivery, useAssetUpload, type AssetTransport } from './assets'
+import { mount } from '@vue/test-utils'
+import { defineComponent, nextTick } from 'vue'
+
+const BASE = 'https://cdn.bgl.dev/auctentic'
+
+function makeClient(upload?: AssetTransport['upload']) {
+	const transport = { upload: upload ?? (async () => ({ asset_id: 'a' })) }
+	return createAssetClient(transport, BASE)
+}
+
+describe('asset client', () => {
+	it('builds deterministic public URLs per purpose', () => {
+		const client = makeClient()
+		expect(client.assetUrl({ asset_id: 'a' })).toBe(`${BASE}/a`)
+		expect(client.assetUrl({ asset_id: 'a' }, 'original')).toBe(`${BASE}/a`)
+		expect(client.assetUrl({ asset_id: 'a' }, 'website')).toBe(`${BASE}/a?fmt=webp`)
+		expect(client.assetUrl({ asset_id: 'a' }, 'social')).toBe(`${BASE}/a?w=1200&h=630&fmt=jpeg&fit=cover`)
+	})
+
+	it('upload returns only the public id (version is ignored)', async () => {
+		const upload = vi.fn<AssetTransport['upload']>(async () => ({ asset_id: 'a', version_id: 'v1' }))
+		const client = makeClient(upload)
+		await expect(client.upload(new File(['x'], 'x'))).resolves.toEqual({ asset_id: 'a' })
+	})
+
+	it('clearSession aborts in-flight uploads and bumps revision', async () => {
+		const upload = vi.fn<AssetTransport['upload']>((_f, signal) => new Promise((_resolve, reject) => {
+			signal.addEventListener('abort', () => reject(new DOMException('x', 'AbortError')))
+		}))
+		const client = makeClient(upload)
+		const before = client.revision
+		const promise = client.upload(new File(['x'], 'x'))
+		client.clearSession()
+		await expect(promise).rejects.toMatchObject({ name: 'AbortError' })
+		expect(client.revision).toBe(before + 1)
+	})
+})
+
+describe('useAssetDelivery (public URL resolution)', () => {
+	it('resolves an asset reference to its public URL without a network call', async () => {
+		const client = makeClient()
+		let state!: ReturnType<typeof useAssetDelivery>
+		mount(defineComponent({
+			setup() { state = useAssetDelivery(() => ({ asset_id: 'a', representation: 'preview' })); return () => null },
+		}), { global: { provide: { [ASSET_CLIENT_KEY as symbol]: client } } })
+		await nextTick()
+		expect(state.url.value).toBe(`${BASE}/a?fmt=webp`)
+		expect(state.error.value).toBe(false)
+	})
+
+	it('sets error when no client is provided', async () => {
+		let state!: ReturnType<typeof useAssetDelivery>
+		mount(defineComponent({
+			setup() { state = useAssetDelivery(() => ({ asset_id: 'a' })); return () => null },
+		}))
+		await nextTick()
+		expect(state.url.value).toBeUndefined()
+		expect(state.error.value).toBe(true)
+	})
+})
+
+describe('useAssetUpload', () => {
+	it('rejects when no client is injected', async () => {
+		let upload!: ReturnType<typeof useAssetUpload>['upload']
+		mount(defineComponent({
+			setup() { upload = useAssetUpload().upload; return () => null },
+		}))
+		await expect(upload(new File(['x'], 'x'))).rejects.toThrow('Asset client is not configured')
+	})
+
+	it('uploads and returns the public reference', async () => {
+		const client = makeClient()
+		let upload!: ReturnType<typeof useAssetUpload>['upload']
+		mount(defineComponent({
+			setup() { upload = useAssetUpload().upload; return () => null },
+		}), { global: { provide: { [ASSET_CLIENT_KEY as symbol]: client } } })
+		await expect(upload(new File(['x'], 'x'))).resolves.toEqual({ asset_id: 'a' })
+	})
+})

package/src/assets.ts

@@ -0,0 +1,162 @@
+import { inject, onScopeDispose, ref, toValue, watch, type InjectionKey, type MaybeRefOrGetter } from 'vue'
+
+/**
+ * Persist this reference, never a delivery URL. Assets are public-by-default;
+ * the id alone addresses the bytes. ``version_id`` is accepted for backward
+ * compatibility with callers that still emit it, but it is ignored: it no
+ * longer selects a version and never appears in a URL.
+ */
+export interface AssetReference {
+	asset_id: string
+	version_id?: string
+}
+
+export type AssetVisibility = 'protected' | 'public'
+
+export interface AssetUploadOptions {
+	/** Protected is the safe default. Website/media callers must opt into public. */
+	visibility?: AssetVisibility
+}
+
+/** Display purpose → on-demand transform query params (mirrors common/blox). */
+export type AssetPurpose = 'original' | 'preview' | 'thumbnail' | 'website' | 'social'
+
+const PURPOSE_PARAMS: Record<AssetPurpose, string> = {
+	original: '',
+	preview: 'fmt=webp',
+	thumbnail: 'fmt=webp&w=256',
+	website: 'fmt=webp',
+	social: 'w=1200&h=630&fmt=jpeg&fit=cover',
+}
+
+/** A display intent: a pinned asset plus an optional purpose/preset. */
+export interface AssetDeliveryRequest extends AssetReference {
+	representation?: AssetPurpose
+}
+
+/** Separate facade: generated SDK namespaces remain unchanged. */
+export interface AssetTransport {
+	upload(file: File, signal: AbortSignal, options?: AssetUploadOptions): Promise<AssetReference>
+}
+
+export interface AssetClient {
+	/** Upload original bytes; protected unless the caller explicitly opts into public. */
+	upload(file: File, signal?: AbortSignal, options?: AssetUploadOptions): Promise<AssetReference>
+	/** Build the public CDN URL for a reference + optional purpose. */
+	assetUrl(reference: AssetReference, purpose?: AssetPurpose): string
+	/** Abort in-flight uploads (logout / tenant / account switch). */
+	clearSession(): void
+	/** Monotonic counter bumped on clearSession; watchers can subscribe. */
+	revision: number
+}
+
+const abortError = () => new DOMException('Asset request cancelled', 'AbortError')
+
+/** App/session scoped; no persistent storage or delivery cache (URLs are public). */
+export function createAssetClient(
+	transport: AssetTransport,
+	deliveryBaseUrl: string,
+): AssetClient {
+	const controllers = new Set<AbortController>()
+	let revision = 0
+
+	function assetUrl(reference: AssetReference, purpose: AssetPurpose = 'original'): string {
+		const query = PURPOSE_PARAMS[purpose] ?? ''
+		const base = deliveryBaseUrl.replace(/\/+$/, '')
+		return query ? `${base}/${reference.asset_id}?${query}` : `${base}/${reference.asset_id}`
+	}
+
+	return {
+		get revision() { return revision },
+		assetUrl,
+		async upload(file: File, signal?: AbortSignal, options?: AssetUploadOptions): Promise<AssetReference> {
+			const controller = new AbortController()
+			const abort = () => controller.abort()
+			signal?.addEventListener('abort', abort, { once: true })
+			controllers.add(controller)
+			try {
+				if (signal?.aborted) controller.abort()
+				if (controller.signal.aborted) throw abortError()
+				const reference = await transport.upload(file, controller.signal, options)
+				if (controller.signal.aborted) throw abortError()
+				return { asset_id: reference.asset_id }
+			} finally {
+				controllers.delete(controller)
+				signal?.removeEventListener('abort', abort)
+			}
+		},
+		clearSession() {
+			for (const controller of controllers) controller.abort()
+			controllers.clear()
+			revision++
+		},
+	}
+}
+
+export const ASSET_CLIENT_KEY: InjectionKey<AssetClient> = Symbol('bagel:assets')
+
+/** Opt-in upload state; original bytes are handed unchanged to the transport. */
+export function useAssetUpload() {
+	const client = inject(ASSET_CLIENT_KEY, undefined)
+	const uploading = ref(false)
+	const reference = ref<AssetReference>()
+	let controller: AbortController | undefined
+	let generation = 0
+	function cancel() {
+		generation++
+		controller?.abort()
+		uploading.value = false
+		reference.value = undefined
+	}
+	async function upload(file: File, options?: AssetUploadOptions): Promise<AssetReference> {
+		cancel()
+		if (!client) throw new Error('Asset client is not configured')
+		const current = generation
+		controller = new AbortController()
+		uploading.value = true
+		try {
+			const result = await client.upload(file, controller.signal, options)
+			if (current !== generation) throw abortError()
+			reference.value = result
+			return result
+		} finally {
+			if (current === generation) uploading.value = false
+		}
+	}
+	const stop = client ? watch(() => client.revision, cancel, { flush: 'sync' }) : undefined
+	onScopeDispose(() => { cancel(); stop?.() })
+	return { upload, cancel, uploading, reference }
+}
+
+/**
+ * Resolve an asset reference to a public display URL. Public-by-default means
+ * no server round-trip and no expiry: the URL is deterministic from the asset id.
+ */
+export function useAssetUrl(source: MaybeRefOrGetter<AssetDeliveryRequest | undefined>) {
+	const client = inject(ASSET_CLIENT_KEY, undefined)
+	const url = ref<string>()
+	const error = ref(false)
+
+	watch(() => {
+		const reference = toValue(source)
+		return reference ? `${reference.asset_id}:${reference.representation ?? 'original'}` : ''
+	}, () => {
+		const reference = toValue(source)
+		if (!reference) { url.value = undefined; error.value = false; return }
+		if (!client) { url.value = undefined; error.value = true; return }
+		url.value = client.assetUrl(reference, reference.representation)
+		error.value = false
+	}, { immediate: true })
+
+	return { url, error }
+}
+
+/**
+ * @deprecated Backward-compatible alias for ``useAssetUrl``. Public assets have
+ * no expiry, so the returned URL never needs refreshing; ``onError`` is a no-op
+ * retry hook kept for callers that expected the old grant-refresh contract.
+ */
+export function useAssetDelivery(source: MaybeRefOrGetter<AssetDeliveryRequest | undefined>) {
+	const { url, error } = useAssetUrl(source)
+	return { url, error, onError: () => { error.value = true } }
+}

package/src/components/ContextMenu.vue

@@ -0,0 +1,113 @@
+<script setup lang="ts">
+import type { VirtualElement } from '@floating-ui/dom'
+import type { AlignedPlacement, AnchorPoint, DropdownItem } from './Dropdown.types'
+import { computed, ref, useSlots } from 'vue'
+import Dropdown from './Dropdown.vue'
+
+defineOptions({ inheritAttrs: false, name: 'BglContextMenu' })
+
+const props = withDefaults(defineProps<{
+	/** Declarative menu items. */
+	items?: DropdownItem[]
+	/** Optional header title shown at the top of the context menu. */
+	title?: string
+	/** Explicit viewport anchor `{ x, y, width?, height? }` for controlled mode. */
+	anchorPoint?: AnchorPoint | null
+	/** External reference element or VirtualElement. */
+	referenceEl?: Element | VirtualElement | null
+	placement?: AlignedPlacement
+	popupClass?: string
+	autoHide?: boolean
+	disabled?: boolean
+}>(), {
+	placement: 'bottom-start',
+	autoHide: true,
+	disabled: false,
+})
+
+const emit = defineEmits<{
+	show: []
+	hide: []
+	select: [value: string | number | DropdownItem, item: DropdownItem]
+}>()
+
+const shown = defineModel('shown', { type: Boolean, default: false })
+const slots = useSlots()
+const dropdownRef = ref<InstanceType<typeof Dropdown> | null>(null)
+const internalPoint = ref<AnchorPoint>({ x: 0, y: 0 })
+
+const hasTargetSlot = computed(() => Boolean(slots.target))
+const effectiveAnchorPoint = computed<AnchorPoint | null>(() => {
+	if (props.anchorPoint) return props.anchorPoint
+	if (props.referenceEl) return null
+	return internalPoint.value
+})
+
+const effectiveItems = computed<DropdownItem[]>(() => {
+	if (!props.items?.length) return []
+	if (props.title) {
+		return [{ header: props.title }, ...props.items]
+	}
+	return props.items
+})
+
+function openAt(target: AnchorPoint | MouseEvent) {
+	if (props.disabled) return
+	if ('clientX' in target && 'clientY' in target) {
+		internalPoint.value = { x: target.clientX, y: target.clientY, width: 0, height: 0 }
+	} else {
+		internalPoint.value = { ...target }
+	}
+	dropdownRef.value?.openAt(internalPoint.value)
+}
+
+function onTargetContextMenu(e: MouseEvent) {
+	if (props.disabled) return
+	e.preventDefault()
+	openAt(e)
+}
+
+function show() {
+	dropdownRef.value?.show()
+}
+
+function hide() {
+	dropdownRef.value?.hide()
+}
+
+defineExpose({ openAt, show, hide, shown })
+</script>
+
+<template>
+	<div
+		v-if="hasTargetSlot"
+		v-bind="$attrs"
+		style="display: contents"
+		@contextmenu="onTargetContextMenu"
+	>
+		<slot name="target" :open-at="openAt" :hide="hide" :shown="shown" />
+	</div>
+
+	<Dropdown
+		ref="dropdownRef"
+		v-model:shown="shown"
+		:anchor-point="effectiveAnchorPoint"
+		:reference-el="referenceEl"
+		:placement="placement"
+		:items="effectiveItems"
+		:popup-class="popupClass"
+		:auto-hide="autoHide"
+		:disabled="disabled"
+		:triggers="[]"
+		@show="emit('show')"
+		@hide="emit('hide')"
+		@select="(val, item) => emit('select', val, item)"
+	>
+		<template #default="slotProps">
+			<div v-if="title && !effectiveItems.length" class="px-05 py-025 txt11 semi opacity-5 uppercase">
+				{{ title }}
+			</div>
+			<slot v-bind="slotProps" />
+		</template>
+	</Dropdown>
+</template>

package/src/components/Dropdown.types.ts

@@ -0,0 +1,27 @@
+import type { IconType, ThemeType } from '../types'
+
+export type Side = 'top' | 'right' | 'bottom' | 'left'
+export type Alignment = 'start' | 'end'
+export type AlignedPlacement = 'auto' | Side | `${Side}-${Alignment}`
+export type TriggerEvent = 'click' | 'hover'
+
+export interface AnchorPoint {
+	x: number
+	y: number
+	width?: number
+	height?: number
+}
+
+export interface DropdownItem {
+	label?: string
+	value?: string | number
+	icon?: IconType
+	color?: ThemeType
+	danger?: boolean
+	disabled?: boolean
+	active?: boolean
+	divider?: boolean
+	header?: string
+	class?: string
+	action?: () => void
+}