winduum 1.2.0-next.4 → 1.2.0-next.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winduum",
-  "version": "1.2.0-next.4",
+  "version": "1.2.0-next.6",
   "type": "module",
   "types": "types/index.d.ts",
   "main": "plugin/index.cjs",

package/src/components/popover/index.d.ts

@@ -0,0 +1,15 @@
+import { FlipOptions, Middleware, OffsetOptions, Placement, ShiftOptions } from "@floating-ui/dom";
+
+export interface ShowPopoverOptions {
+    visibleClass?: string
+    compute?: boolean
+    placement?: Placement
+    middleware?: Array<Middleware | null | undefined | false>
+    offset?: OffsetOptions
+    flip?: FlipOptions
+    shift?: ShiftOptions
+}
+
+export function showPopover(element: HTMLElement | Element, options?: ShowPopoverOptions): Promise<void>
+export function hidePopover(element: HTMLElement | Element): Promise<void>
+export function togglePopover(element: HTMLElement | Element, options?: ShowPopoverOptions): Promise<void>

package/src/components/popover/index.js

@@ -1,36 +1,51 @@
 import { animationsFinished } from '../../common.js'
 
-export const computePopover = async (element, popover, options) => {
+/**
+ * @param {HTMLElement | Element} element
+ * @param {HTMLElement | Element} popoverElement
+ * @param {import("./").ShowPopoverOptions} options
+ * @returns Promise<void>
+ */
+export const computePopover = async (element, popoverElement, options) => {
     const { computePosition, flip, shift, offset } = await import('@floating-ui/dom')
 
-    popover.classList.remove(popover._placement)
+    popoverElement.classList.remove(popoverElement._placement)
 
-    popover.style.minWidth = `${element.offsetWidth / 16}rem`
+    popoverElement.style.minWidth = `${element.offsetWidth / 16}rem`
 
-    await computePosition(element, popover, {
+    await computePosition(element, popoverElement, {
         placement: options?.placement,
-        middleware: options?.middleware ?? [offset(12 ?? options?.offset), flip(), shift({ padding: 8, ...options?.shift })]
+        middleware: options?.middleware ?? [offset(12 ?? options?.offset), flip(options?.flip), shift({ padding: 8, ...options?.shift })]
     }).then(({ x, y, placement }) => {
-        Object.assign(popover.style, {
+        Object.assign(popoverElement.style, {
             inset: `${y}px auto auto ${x}px`
         })
 
-        popover._placement = placement
-        popover.classList.add(popover._placement, options?.visibleClass ?? 'in')
+        popoverElement._placement = placement
+        popoverElement.classList.add(popoverElement._placement, options?.visibleClass ?? 'in')
     })
 }
 
-export const closePopover = async (element) => {
+/**
+ * @param {HTMLElement | Element} element - The HTML content to insert into the dialog.
+ * @returns Promise<void>
+ */
+export const hidePopover = async (element) => {
     const popoverElement = document.getElementById(element.getAttribute('popovertarget'))
 
     popoverElement.classList.remove('in')
     await animationsFinished(popoverElement)
-    popoverElement?._cleanup()
+    popoverElement._cleanup && popoverElement._cleanup()
     popoverElement.hidePopover && popoverElement.hidePopover()
 
-    element.ariaExpanded = false
+    element.ariaExpanded = 'false'
 }
 
+/**
+ * @param {HTMLElement | Element} element
+ * @param {import("./").ShowPopoverOptions} options
+ * @returns Promise<void>
+ */
 export const showPopover = async (element, options) => {
     options = {
         visibleClass: 'in',
@@ -42,7 +57,7 @@ export const showPopover = async (element, options) => {
 
     const popoverElement = document.getElementById(element.getAttribute('popovertarget'))
 
-    element.ariaExpanded = true
+    element.ariaExpanded = 'true'
 
     if (!element.ariaHasPopup) (element.ariaHasPopup = 'dialog')
     if (!popoverElement.role) (popoverElement.role = element.ariaHasPopup)
@@ -61,10 +76,15 @@ export const showPopover = async (element, options) => {
     )
 }
 
+/**
+ * @param {HTMLElement | Element} element
+ * @param {import("./").ShowPopoverOptions} options
+ * @returns Promise<void>
+ */
 export const togglePopover = async (element, options) => {
     if (element.ariaExpanded !== 'true') {
         await showPopover(element, options)
     } else {
-        await closePopover(element)
+        await hidePopover(element)
     }
 }

package/types/index.d.ts

@@ -22,7 +22,7 @@ declare module 'winduum' {
 
 	export const defaultConfig: PluginOptions
 
-	export default function createPlugin(userConfig: PluginOptions): Plugin
+	export default function createPlugin(userConfig?: PluginOptions): Plugin
 }
 
 declare module 'winduum/src/components/carousel' {
@@ -92,10 +92,6 @@ declare module 'winduum/src/components/details' {
 }
 
 declare module 'winduum/src/components/dialog' {
-	export interface DialogElement extends HTMLDialogElement {
-		_dialogHasEvents: boolean
-	}
-
 	export interface DefaultOptions {
 		remove?: boolean | null
 		closable?: boolean | null
@@ -118,7 +114,7 @@ declare module 'winduum/src/components/dialog' {
 	export const defaultOptions: DefaultOptions
 	export function dialogSelector(selector: string): HTMLDialogElement
 	export function dismissDialog(element: HTMLDialogElement, options?: DefaultOptions): Promise<void>
-	export function showDialog(element: DialogElement, options?: DefaultOptions): Promise<void>
+	export function showDialog(element: HTMLDialogElement, options?: DefaultOptions): Promise<void>
 	export function closeDialog(element: HTMLDialogElement, options?: DefaultOptions): Promise<void>
 	export function insertDialog(content: string, options?: InsertDialogOptions): Promise<void>
 	export function fetchDialog({ url, insert }: FetchDialogOptions): Promise<void>
@@ -211,6 +207,23 @@ declare module 'winduum/src/components/toaster' {
 	export function closeToaster(element: HTMLElement, options?: CloseToastOptions): Promise<void>
 }
 
+declare module 'winduum/src/components/popover' {
+	import type { FlipOptions, Middleware, OffsetOptions, Placement, ShiftOptions } from '@floating-ui/dom';
+	export interface ShowPopoverOptions {
+		visibleClass?: string
+		compute?: boolean
+		placement?: Placement
+		middleware?: Array<Middleware | null | undefined | false>
+		offset?: OffsetOptions
+		flip?: FlipOptions
+		shift?: ShiftOptions
+	}
+
+	export function showPopover(element: HTMLElement | Element, options?: ShowPopoverOptions): Promise<void>
+	export function hidePopover(element: HTMLElement | Element): Promise<void>
+	export function togglePopover(element: HTMLElement | Element, options?: ShowPopoverOptions): Promise<void>
+}
+
 declare module 'winduum/src/ui/range' {
 	export interface SetTrackPropertyOptions {
 		element: HTMLElement | Element

package/types/index.d.ts.map

@@ -27,7 +27,6 @@
 		"showDetails",
 		"closeDetails",
 		"toggleDetails",
-		"DialogElement",
 		"InsertDialogOptions",
 		"FetchDialogOptions",
 		"dialogSelector",
@@ -54,6 +53,10 @@
 		"insertToaster",
 		"insertToast",
 		"closeToaster",
+		"ShowPopoverOptions",
+		"showPopover",
+		"hidePopover",
+		"togglePopover",
 		"SetTrackPropertyOptions",
 		"SetValueOptions",
 		"SetOutputOptions",
@@ -73,6 +76,7 @@
 		"../src/components/form/index.d.ts",
 		"../src/components/tabs/index.d.ts",
 		"../src/components/toaster/index.d.ts",
+		"../src/components/popover/index.d.ts",
 		"../src/ui/range/index.d.ts",
 		"../src/utilities/ripple/index.d.ts",
 		"../src/utilities/swap/index.d.ts"
@@ -89,7 +93,8 @@
 		null,
 		null,
 		null,
+		null,
 		null
 	],
-	"mappings": ";;kBAEiBA,aAAaA;;;;;;;;;;;;;;;;;;;;cAoBjBC,aAAaA;;;;;;kBCtBTC,sBAAsBA;;;;;;;;kBAQtBC,yBAAyBA;;;;;;kBAMzBC,qBAAqBA;;;;;;;;kBAQrBC,uBAAuBA;;;;;kBAKvBC,mBAAmBA;;;;iBAIpBC,UAAUA;iBACVC,UAAUA;iBACVC,QAAQA;iBACRC,YAAYA;iBACZC,eAAeA;iBACfC,cAAcA;iBACdC,kBAAkBA;iBAClBC,gBAAgBA;iBAChBC,YAAYA;;;;kBCvCXC,kBAAkBA;;;;;iBAKnBC,WAAWA;iBACXC,eAAeA;iBACfC,YAAYA;;;;kBCPXC,cAAcA;;;;;cAKlBC,cAAcA;iBACXC,WAAWA;iBACXC,YAAYA;iBACZC,aAAaA;;;;kBCRZC,aAAaA;;;;kBAIbL,cAAcA;;;;;;;kBAOdM,mBAAmBA;;;;;;;kBAOnBC,kBAAkBA;;;;;cAKtBN,cAAcA;iBACXO,cAAcA;iBACdC,aAAaA;iBACbC,UAAUA;iBACVC,WAAWA;iBACXC,YAAYA;iBACZC,WAAWA;;;;kBC7BVC,mBAAmBA;;;;;;;;;;iBAUpBC,UAAUA;iBACVC,WAAWA;iBACXC,YAAYA;;;;kBCZXC,mBAAmBA;;;;;;kBAMnBC,oBAAoBA;;;;;;;;;;;;;;;;;;iBAkBrBC,YAAYA;iBACZC,aAAaA;;;;;;;;;iBCpBbC,SAASA;;;;kBCLRC,gBAAgBA;;;;;;;kBAOhBC,iBAAiBA;;;;;kBAKjBC,oBAAoBA;;;;kBAIpBC,kBAAkBA;;;;;;;;;iBASnBC,UAAUA;iBACVC,SAASA;iBACTC,aAAaA;iBACbC,WAAWA;iBACXC,YAAYA;;;;kBC7BXC,uBAAuBA;;;;;;kBAMvBC,eAAeA;;;;;kBAKfC,gBAAgBA;;;;;iBAKjBC,gBAAgBA;iBAChBC,QAAQA;iBACRC,cAAcA;;;;iBClBdC,UAAUA;;;;iBCAVC,UAAUA"
+	"mappings": ";;kBAEiBA,aAAaA;;;;;;;;;;;;;;;;;;;;cAoBjBC,aAAaA;;;;;;kBCtBTC,sBAAsBA;;;;;;;;kBAQtBC,yBAAyBA;;;;;;kBAMzBC,qBAAqBA;;;;;;;;kBAQrBC,uBAAuBA;;;;;kBAKvBC,mBAAmBA;;;;iBAIpBC,UAAUA;iBACVC,UAAUA;iBACVC,QAAQA;iBACRC,YAAYA;iBACZC,eAAeA;iBACfC,cAAcA;iBACdC,kBAAkBA;iBAClBC,gBAAgBA;iBAChBC,YAAYA;;;;kBCvCXC,kBAAkBA;;;;;iBAKnBC,WAAWA;iBACXC,eAAeA;iBACfC,YAAYA;;;;kBCPXC,cAAcA;;;;;cAKlBC,cAAcA;iBACXC,WAAWA;iBACXC,YAAYA;iBACZC,aAAaA;;;;kBCRZJ,cAAcA;;;;;;;kBAOdK,mBAAmBA;;;;;;;kBAOnBC,kBAAkBA;;;;;cAKtBL,cAAcA;iBACXM,cAAcA;iBACdC,aAAaA;iBACbC,UAAUA;iBACVC,WAAWA;iBACXC,YAAYA;iBACZC,WAAWA;;;;kBCzBVC,mBAAmBA;;;;;;;;;;iBAUpBC,UAAUA;iBACVC,WAAWA;iBACXC,YAAYA;;;;kBCZXC,mBAAmBA;;;;;;kBAMnBC,oBAAoBA;;;;;;;;;;;;;;;;;;iBAkBrBC,YAAYA;iBACZC,aAAaA;;;;;;;;;iBCpBbC,SAASA;;;;kBCLRC,gBAAgBA;;;;;;;kBAOhBC,iBAAiBA;;;;;kBAKjBC,oBAAoBA;;;;kBAIpBC,kBAAkBA;;;;;;;;;iBASnBC,UAAUA;iBACVC,SAASA;iBACTC,aAAaA;iBACbC,WAAWA;iBACXC,YAAYA;;;;;kBC3BXC,kBAAkBA;;;;;;;;;;iBAUnBC,WAAWA;iBACXC,WAAWA;iBACXC,aAAaA;;;;kBCdZC,uBAAuBA;;;;;;kBAMvBC,eAAeA;;;;;kBAKfC,gBAAgBA;;;;;iBAKjBC,gBAAgBA;iBAChBC,QAAQA;iBACRC,cAAcA;;;;iBClBdC,UAAUA;;;;iBCAVC,UAAUA"
 }