pangea-lib 4.0.413 → 4.0.415

package/dist/types/components/PgaModal.vue.d.ts

@@ -12,13 +12,13 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     isLoading: {
         type: import('vue').PropType<boolean>;
     };
-    confirmButtons: {
-        type: import('vue').PropType<boolean>;
-    };
     width: {
         type: import('vue').PropType<Size>;
         default: string;
     };
+    confirmButtons: {
+        type: import('vue').PropType<boolean>;
+    };
     acceptText: {
         type: import('vue').PropType<StrOrFn>;
     };
@@ -43,13 +43,13 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     isLoading: {
         type: import('vue').PropType<boolean>;
     };
-    confirmButtons: {
-        type: import('vue').PropType<boolean>;
-    };
     width: {
         type: import('vue').PropType<Size>;
         default: string;
     };
+    confirmButtons: {
+        type: import('vue').PropType<boolean>;
+    };
     acceptText: {
         type: import('vue').PropType<StrOrFn>;
     };

package/dist/types/composables/index.d.ts

@@ -1,2 +1,3 @@
 export { useElementPosition } from './use-element-position.composable';
+export { useFloatingDropdown } from './use-floating-dropdown.composable';
 export { useScrollListener } from './use-scroll-listener.composable';

package/dist/types/composables/use-floating-dropdown.composable.d.ts

@@ -0,0 +1,29 @@
+import { Ref } from 'vue';
+import { Placement } from '@floating-ui/vue';
+
+type MaybeElementRef = Readonly<Ref<HTMLElement | null | undefined>>;
+interface UseFloatingDropdownOptions {
+    /** Whether the floating element is currently open. */
+    open: Readonly<Ref<boolean>>;
+    /** Preferred placement relative to the reference element. */
+    placement?: Placement;
+    /** Gap (in px) between the reference and the floating element. */
+    offset?: number;
+    /** Match the floating element width to the reference element width. */
+    matchReferenceWidth?: boolean;
+    /** Minimum max-height (in px) so the dropdown stays usable on short viewports. */
+    minMaxHeight?: number;
+    /** Padding (in px) kept from the viewport edges when flipping/shifting/sizing. */
+    viewportPadding?: number;
+}
+/**
+ * Shared positioning engine for every custom dropdown / popover in the library.
+ *
+ * Built on @floating-ui, which positions against the visual viewport and keeps
+ * the floating element glued to its reference across scroll, resize, device
+ * rotation and the iOS on-screen keyboard (via `autoUpdate`). `flip`, `shift`
+ * and `size` keep it inside the viewport on every device instead of overflowing
+ * or rendering off-screen.
+ */
+export declare function useFloatingDropdown(reference: MaybeElementRef, floating: MaybeElementRef, options: UseFloatingDropdownOptions): import('@floating-ui/vue').UseFloatingReturn;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pangea-lib",
   "description": "",
-  "version": "4.0.413",
+  "version": "4.0.415",
   "author": "Gianfranco Raselli",
   "license": "ISC",
   "homepage": "https://github.com/GianfrancoRaselli/pangea-lib#readme",
@@ -37,6 +37,7 @@
     "deploy": "node deploy.js"
   },
   "dependencies": {
+    "@floating-ui/vue": "1.1.11",
     "@lucide/vue": "1.14.0",
     "@vuelidate/core": "2.0.3",
     "@vuelidate/validators": "2.0.4",