@iris-ui-kit/vue 0.1.0

package/dist/data.d.ts

@@ -0,0 +1,46 @@
+import { ShallowRef, ComputedRef } from 'vue';
+import { DataSourceController, DataSourceState, DataSourceConfig, createGroupedView, DataViewColumn, GroupedViewState, GroupedViewConfig } from '@iris-ui-kit/core';
+export { DataSourceConfig, DataSourceController, DataSourceMode, DataSourceMutateOptions, DataSourceQuery, DataSourceState, GroupedViewConfig, GroupedViewState, GroupedViewStore, RowMutateOptions, createClientDataSource, createDataSource, createGroupedView } from '@iris-ui-kit/core';
+
+interface UseDataSource<T> extends DataSourceController<T> {
+    /**
+     * The live data-source state as a reactive ref: rows, total, page/pageSize,
+     * sort/multiSort, filters/filterRules, loading/loadingMore, hasMore,
+     * selectedKeys, and the per-row pendingRows/rowErrors.
+     */
+    state: ShallowRef<DataSourceState<T>>;
+}
+/**
+ * Vue bridge over the framework-agnostic {@link createDataSource} — the unified
+ * data engine (paged/infinite + multi-sort + typed filters + selection +
+ * per-row + optimistic mutate). Creates the controller once in `setup()`,
+ * mirrors its store into a reactive ref, and returns the controller plus its
+ * live `state`. A thin bridge — all logic lives in `@iris-ui-kit/core`.
+ *
+ * Constructed with `immediate: false` so no fetch fires during `setup()`; the
+ * initial load is kicked from `onMounted` and the controller is torn down on
+ * scope dispose (aborting any in-flight request) so a late response never
+ * writes back to a torn-down instance.
+ */
+declare function useDataSource<T>(config: DataSourceConfig<T>): UseDataSource<T>;
+
+interface UseGroupedView<Row, K = string> {
+    store: ReturnType<typeof createGroupedView<Row, K>>['store'];
+    setRows: (rows: readonly Row[], columns?: readonly DataViewColumn<Row>[]) => void;
+    toggleGroup: (key: K) => void;
+    expandGroup: (key: K) => void;
+    collapseGroup: (key: K) => void;
+    expandAll: () => void;
+    collapseAll: () => void;
+    /** Reactive live grouped-view state. */
+    state: ComputedRef<GroupedViewState<Row, K>>;
+    setConfig: (partial: Partial<GroupedViewConfig<Row, K>>) => void;
+}
+/**
+ * Vue bridge over the framework-agnostic {@link createGroupedView}.
+ * Creates the controller once, subscribes its store to a reactive ref,
+ * and returns the controller plus a computed `state`.
+ */
+declare function useGroupedView<Row, K = string>(config: GroupedViewConfig<Row, K>): UseGroupedView<Row, K>;
+
+export { type UseDataSource, type UseGroupedView, useDataSource, useGroupedView };

package/dist/data.js

@@ -0,0 +1,4 @@
+export { createClientDataSource, createDataSource, createGroupedView, useDataSource, useGroupedView } from './chunk-7IOJADZC.js';
+import './chunk-75GSYEJS.js';
+//# sourceMappingURL=data.js.map
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"data.js"}

package/dist/error-boundary.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+var vue = require('vue');
+var core = require('@iris-ui-kit/core');
+
+// src/error-boundary/IrisErrorBoundary.ts
+
+// src/i18n/context.ts
+var I18nInjectionKey = /* @__PURE__ */ Symbol("IrisI18n");
+var fallbackI18n = null;
+function getFallback() {
+  if (fallbackI18n === null) fallbackI18n = core.createI18n();
+  return fallbackI18n;
+}
+function useI18n() {
+  const i18n = vue.inject(I18nInjectionKey, null) ?? getFallback();
+  const state = vue.ref(i18n.getState());
+  const unsubscribe = i18n.subscribe((next) => {
+    state.value = next;
+  });
+  vue.onBeforeUnmount(unsubscribe);
+  return {
+    locale: vue.computed(() => state.value.locale),
+    t: (key, params) => {
+      void state.value.locale;
+      return i18n.t(key, params);
+    },
+    formatDate: (value, options) => {
+      void state.value.locale;
+      return i18n.formatDate(value, options);
+    },
+    formatNumber: (value, options) => {
+      void state.value.locale;
+      return i18n.formatNumber(value, options);
+    },
+    formatRelativeTime: (value, unit, options) => {
+      void state.value.locale;
+      return i18n.formatRelativeTime(value, unit, options);
+    },
+    setLocale: i18n.setLocale,
+    setMessages: i18n.setMessages
+  };
+}
+
+// src/error-boundary/IrisErrorBoundary.ts
+var IrisErrorBoundary = vue.defineComponent({
+  name: "IrisErrorBoundary",
+  inheritAttrs: false,
+  props: {
+    fallback: {
+      type: Function,
+      default: void 0
+    },
+    onError: {
+      type: Function,
+      default: void 0
+    }
+  },
+  setup(props, { attrs, slots }) {
+    const { t } = useI18n();
+    const error = vue.ref(null);
+    const reset = () => {
+      error.value = null;
+    };
+    vue.onErrorCaptured((err, _instance, info) => {
+      error.value = err;
+      props.onError?.(err, info);
+      return false;
+    });
+    const renderDefaultFallback = () => {
+      const message = error.value instanceof Error && error.value.message ? error.value.message : t("errorBoundary.message");
+      return vue.h(
+        "div",
+        {
+          ...attrs,
+          "data-iris-error-boundary": "",
+          role: "alert",
+          style: {
+            padding: "16px",
+            border: "1px solid var(--iris-danger)",
+            borderRadius: "var(--iris-radius-md, 6px)",
+            color: "var(--iris-danger)",
+            ...attrs.style ?? {}
+          }
+        },
+        [
+          vue.h("div", { "data-iris-error-boundary-message": "" }, message),
+          vue.h(
+            "button",
+            {
+              type: "button",
+              "data-iris-error-boundary-retry": "",
+              onClick: reset
+            },
+            t("errorBoundary.retry")
+          )
+        ]
+      );
+    };
+    return () => {
+      if (error.value !== null) {
+        const custom = slots.fallback ?? props.fallback;
+        if (custom) {
+          return custom({ error: error.value, reset });
+        }
+        return renderDefaultFallback();
+      }
+      return slots.default?.();
+    };
+  }
+});
+
+exports.IrisErrorBoundary = IrisErrorBoundary;
+//# sourceMappingURL=error-boundary.cjs.map
+//# sourceMappingURL=error-boundary.cjs.map

package/dist/error-boundary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n/context.ts","../src/i18n/useI18n.ts","../src/error-boundary/IrisErrorBoundary.ts"],"names":["createI18n","inject","ref","onBeforeUnmount","computed","defineComponent","onErrorCaptured","h"],"mappings":"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","file":"error-boundary.cjs","sourcesContent":["import { type InjectionKey } from 'vue'\nimport type { I18n } from '@iris-ui-kit/core'\n\n/** Injection key carrying the active {@link I18n} instance to `useI18n`. */\nexport const I18nInjectionKey: InjectionKey<I18n> = Symbol('IrisI18n')\n","import { computed, inject, onBeforeUnmount, ref, type ComputedRef, type Ref } from 'vue'\nimport { createI18n, type I18n, type I18nState } from '@iris-ui-kit/core'\nimport { I18nInjectionKey } from './context'\n\nexport interface UseI18nReturn {\n  locale: ComputedRef<string>\n  t: I18n['t']\n  formatDate: I18n['formatDate']\n  formatNumber: I18n['formatNumber']\n  formatRelativeTime: I18n['formatRelativeTime']\n  setLocale: I18n['setLocale']\n  setMessages: I18n['setMessages']\n}\n\n// Shared fallback so components can call `useI18n()` without an enclosing\n// provider — they get English defaults rather than throwing.\nlet fallbackI18n: I18n | null = null\nfunction getFallback(): I18n {\n  if (fallbackI18n === null) fallbackI18n = createI18n()\n  return fallbackI18n\n}\n\n/**\n * Reactive access to the active locale + translation/formatting helpers.\n * Works with or without an `<IrisI18nProvider>` (falls back to English\n * defaults). `t` / formatters read the live locale at call time, and `locale`\n * is a reactive ref so templates re-render on change.\n */\nexport function useI18n(): UseI18nReturn {\n  const i18n = inject(I18nInjectionKey, null) ?? getFallback()\n  const state = ref(i18n.getState()) as Ref<I18nState>\n  const unsubscribe = i18n.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\n\n  return {\n    locale: computed(() => state.value.locale),\n    t: (key, params) => {\n      void state.value.locale\n      return i18n.t(key, params)\n    },\n    formatDate: (value, options) => {\n      void state.value.locale\n      return i18n.formatDate(value, options)\n    },\n    formatNumber: (value, options) => {\n      void state.value.locale\n      return i18n.formatNumber(value, options)\n    },\n    formatRelativeTime: (value, unit, options) => {\n      void state.value.locale\n      return i18n.formatRelativeTime(value, unit, options)\n    },\n    setLocale: i18n.setLocale,\n    setMessages: i18n.setMessages,\n  }\n}\n","import { defineComponent, h, onErrorCaptured, ref, type PropType, type VNode } from 'vue'\nimport { useI18n } from '../i18n'\n\n/** Render-customization payload handed to the `#fallback` slot / `fallback` prop. */\nexport interface IrisErrorBoundaryFallbackProps {\n  /** The error caught while rendering the guarded subtree. */\n  error: unknown\n  /** Clears the error and re-attempts rendering the children. */\n  reset: () => void\n}\n\n/** Public prop surface of {@link IrisErrorBoundary}. */\nexport interface IrisErrorBoundaryProps {\n  /**\n   * Custom fallback renderer. Receives `{ error, reset }` and returns the\n   * fallback UI. A `#fallback` scoped slot takes precedence when both are given.\n   * When neither is supplied the themed DEFAULT fallback renders.\n   */\n  fallback?: (props: IrisErrorBoundaryFallbackProps) => VNode | VNode[] | string\n  /** Invoked with the caught error (and Vue's error-info string) for logging. */\n  onError?: (error: unknown, info?: string) => void\n}\n\n/**\n * IrisErrorBoundary: catches errors thrown while rendering its guarded subtree\n * (default slot), switches to a fallback, and exposes `reset()` to clear the\n * error and re-attempt rendering. Catching does NOT rethrow — a single broken\n * subtree no longer crashes the whole tree.\n *\n * Customize via a `#fallback` scoped slot or the `fallback` prop, each receiving\n * `{ error, reset }`. Without either, a themed, accessible (`role=\"alert\"`)\n * default fallback shows the error message + a retry button, i18n'd through\n * `useI18n()` (English defaults without a provider).\n */\nexport const IrisErrorBoundary = defineComponent({\n  name: 'IrisErrorBoundary',\n  inheritAttrs: false,\n  props: {\n    fallback: {\n      type: Function as PropType<IrisErrorBoundaryProps['fallback']>,\n      default: undefined,\n    },\n    onError: {\n      type: Function as PropType<IrisErrorBoundaryProps['onError']>,\n      default: undefined,\n    },\n  },\n  setup(props, { attrs, slots }) {\n    const { t } = useI18n()\n    const error = ref<unknown>(null)\n\n    const reset = () => {\n      error.value = null\n    }\n\n    onErrorCaptured((err, _instance, info) => {\n      error.value = err\n      props.onError?.(err, info)\n      // Stop further propagation so the error does not crash the parent tree.\n      return false\n    })\n\n    const renderDefaultFallback = (): VNode => {\n      const message =\n        error.value instanceof Error && error.value.message\n          ? error.value.message\n          : t('errorBoundary.message')\n\n      return h(\n        'div',\n        {\n          ...attrs,\n          'data-iris-error-boundary': '',\n          role: 'alert',\n          style: {\n            padding: '16px',\n            border: '1px solid var(--iris-danger)',\n            borderRadius: 'var(--iris-radius-md, 6px)',\n            color: 'var(--iris-danger)',\n            ...((attrs.style as Record<string, string> | undefined) ?? {}),\n          },\n        },\n        [\n          h('div', { 'data-iris-error-boundary-message': '' }, message),\n          h(\n            'button',\n            {\n              type: 'button',\n              'data-iris-error-boundary-retry': '',\n              onClick: reset,\n            },\n            t('errorBoundary.retry'),\n          ),\n        ],\n      )\n    }\n\n    return () => {\n      if (error.value !== null) {\n        const custom = slots.fallback ?? props.fallback\n        if (custom) {\n          return custom({ error: error.value, reset })\n        }\n        return renderDefaultFallback()\n      }\n      return slots.default?.()\n    }\n  },\n})\n"]}

package/dist/error-boundary.d.cts

@@ -0,0 +1,60 @@
+import * as vue from 'vue';
+import { PropType, VNode } from 'vue';
+
+/** Render-customization payload handed to the `#fallback` slot / `fallback` prop. */
+interface IrisErrorBoundaryFallbackProps {
+    /** The error caught while rendering the guarded subtree. */
+    error: unknown;
+    /** Clears the error and re-attempts rendering the children. */
+    reset: () => void;
+}
+/** Public prop surface of {@link IrisErrorBoundary}. */
+interface IrisErrorBoundaryProps {
+    /**
+     * Custom fallback renderer. Receives `{ error, reset }` and returns the
+     * fallback UI. A `#fallback` scoped slot takes precedence when both are given.
+     * When neither is supplied the themed DEFAULT fallback renders.
+     */
+    fallback?: (props: IrisErrorBoundaryFallbackProps) => VNode | VNode[] | string;
+    /** Invoked with the caught error (and Vue's error-info string) for logging. */
+    onError?: (error: unknown, info?: string) => void;
+}
+/**
+ * IrisErrorBoundary: catches errors thrown while rendering its guarded subtree
+ * (default slot), switches to a fallback, and exposes `reset()` to clear the
+ * error and re-attempt rendering. Catching does NOT rethrow — a single broken
+ * subtree no longer crashes the whole tree.
+ *
+ * Customize via a `#fallback` scoped slot or the `fallback` prop, each receiving
+ * `{ error, reset }`. Without either, a themed, accessible (`role="alert"`)
+ * default fallback shows the error message + a retry button, i18n'd through
+ * `useI18n()` (English defaults without a provider).
+ */
+declare const IrisErrorBoundary: vue.DefineComponent<vue.ExtractPropTypes<{
+    fallback: {
+        type: PropType<IrisErrorBoundaryProps["fallback"]>;
+        default: undefined;
+    };
+    onError: {
+        type: PropType<IrisErrorBoundaryProps["onError"]>;
+        default: undefined;
+    };
+}>, () => string | VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}> | VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    fallback: {
+        type: PropType<IrisErrorBoundaryProps["fallback"]>;
+        default: undefined;
+    };
+    onError: {
+        type: PropType<IrisErrorBoundaryProps["onError"]>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    onError: ((error: unknown, info?: string) => void) | undefined;
+    fallback: ((props: IrisErrorBoundaryFallbackProps) => VNode | VNode[] | string) | undefined;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { IrisErrorBoundary, type IrisErrorBoundaryFallbackProps, type IrisErrorBoundaryProps };

package/dist/error-boundary.d.ts

@@ -0,0 +1,60 @@
+import * as vue from 'vue';
+import { PropType, VNode } from 'vue';
+
+/** Render-customization payload handed to the `#fallback` slot / `fallback` prop. */
+interface IrisErrorBoundaryFallbackProps {
+    /** The error caught while rendering the guarded subtree. */
+    error: unknown;
+    /** Clears the error and re-attempts rendering the children. */
+    reset: () => void;
+}
+/** Public prop surface of {@link IrisErrorBoundary}. */
+interface IrisErrorBoundaryProps {
+    /**
+     * Custom fallback renderer. Receives `{ error, reset }` and returns the
+     * fallback UI. A `#fallback` scoped slot takes precedence when both are given.
+     * When neither is supplied the themed DEFAULT fallback renders.
+     */
+    fallback?: (props: IrisErrorBoundaryFallbackProps) => VNode | VNode[] | string;
+    /** Invoked with the caught error (and Vue's error-info string) for logging. */
+    onError?: (error: unknown, info?: string) => void;
+}
+/**
+ * IrisErrorBoundary: catches errors thrown while rendering its guarded subtree
+ * (default slot), switches to a fallback, and exposes `reset()` to clear the
+ * error and re-attempt rendering. Catching does NOT rethrow — a single broken
+ * subtree no longer crashes the whole tree.
+ *
+ * Customize via a `#fallback` scoped slot or the `fallback` prop, each receiving
+ * `{ error, reset }`. Without either, a themed, accessible (`role="alert"`)
+ * default fallback shows the error message + a retry button, i18n'd through
+ * `useI18n()` (English defaults without a provider).
+ */
+declare const IrisErrorBoundary: vue.DefineComponent<vue.ExtractPropTypes<{
+    fallback: {
+        type: PropType<IrisErrorBoundaryProps["fallback"]>;
+        default: undefined;
+    };
+    onError: {
+        type: PropType<IrisErrorBoundaryProps["onError"]>;
+        default: undefined;
+    };
+}>, () => string | VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}> | VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    fallback: {
+        type: PropType<IrisErrorBoundaryProps["fallback"]>;
+        default: undefined;
+    };
+    onError: {
+        type: PropType<IrisErrorBoundaryProps["onError"]>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    onError: ((error: unknown, info?: string) => void) | undefined;
+    fallback: ((props: IrisErrorBoundaryFallbackProps) => VNode | VNode[] | string) | undefined;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { IrisErrorBoundary, type IrisErrorBoundaryFallbackProps, type IrisErrorBoundaryProps };

package/dist/error-boundary.js

@@ -0,0 +1,4 @@
+export { IrisErrorBoundary } from './chunk-PPYNXNGZ.js';
+import './chunk-TCAXRWT6.js';
+//# sourceMappingURL=error-boundary.js.map
+//# sourceMappingURL=error-boundary.js.map

package/dist/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"error-boundary.js"}

package/dist/floating.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+var vue = require('vue');
+var dom = require('@floating-ui/dom');
+
+// src/primitives/floating/useFloating.ts
+function useFloating(options) {
+  const x = vue.ref(0);
+  const y = vue.ref(0);
+  const strategy = vue.ref(options.strategy ?? "absolute");
+  const finalPlacement = vue.ref(options.placement ?? "bottom");
+  const arrowX = vue.ref();
+  const arrowY = vue.ref();
+  const middleware = vue.shallowRef([]);
+  rebuildMiddleware();
+  function rebuildMiddleware() {
+    const mw = [];
+    if (options.offset !== void 0) mw.push(dom.offset(options.offset));
+    if (options.flip !== false) mw.push(dom.flip());
+    if (options.shift !== false) mw.push(dom.shift({ padding: 8 }));
+    if (options.size) {
+      const padding = typeof options.size === "number" ? options.size : 8;
+      mw.push(
+        dom.size({
+          padding,
+          apply({ availableWidth, availableHeight, elements }) {
+            Object.assign(elements.floating.style, {
+              maxWidth: `${Math.max(0, Math.floor(availableWidth))}px`,
+              maxHeight: `${Math.max(0, Math.floor(availableHeight))}px`
+            });
+          }
+        })
+      );
+    }
+    if (options.arrow?.value) mw.push(dom.arrow({ element: options.arrow.value }));
+    if (options.middleware) mw.push(...options.middleware);
+    middleware.value = mw;
+  }
+  let cleanupAutoUpdate = null;
+  let epoch = 0;
+  async function update() {
+    const a = options.anchor.value;
+    const f = options.floating.value;
+    if (!a || !f) return;
+    rebuildMiddleware();
+    const token = ++epoch;
+    const result = await dom.computePosition(a, f, {
+      placement: options.placement ?? "bottom",
+      strategy: strategy.value,
+      middleware: middleware.value
+    });
+    if (token !== epoch) return;
+    x.value = result.x;
+    y.value = result.y;
+    finalPlacement.value = result.placement;
+    const arrowData = result.middlewareData.arrow;
+    arrowX.value = arrowData?.x;
+    arrowY.value = arrowData?.y;
+  }
+  vue.watch(
+    [options.open, options.anchor, options.floating],
+    ([isOpen, anchorEl, floatingEl]) => {
+      cleanupAutoUpdate?.();
+      cleanupAutoUpdate = null;
+      epoch++;
+      if (isOpen && anchorEl && floatingEl) {
+        cleanupAutoUpdate = dom.autoUpdate(anchorEl, floatingEl, () => {
+          void update();
+        });
+      }
+    },
+    { flush: "post", immediate: true }
+  );
+  vue.onScopeDispose(() => {
+    cleanupAutoUpdate?.();
+    cleanupAutoUpdate = null;
+    epoch++;
+  });
+  const OPPOSITE = {
+    top: "bottom",
+    bottom: "top",
+    left: "right",
+    right: "left"
+  };
+  const arrowSide = vue.computed(
+    () => OPPOSITE[finalPlacement.value.split("-")[0]]
+  );
+  const floatingStyles = vue.computed(() => ({
+    position: strategy.value,
+    top: "0",
+    left: "0",
+    transform: `translate3d(${Math.round(x.value)}px, ${Math.round(y.value)}px, 0)`,
+    width: "max-content"
+  }));
+  return { x, y, strategy, finalPlacement, floatingStyles, update, arrowX, arrowY, arrowSide };
+}
+function useDismiss(options) {
+  const escape = options.escape !== false;
+  const outsidePointerDown = options.outsidePointerDown !== false;
+  const isExcluded = (target) => {
+    if (!target || !(target instanceof Node)) return false;
+    for (const r of options.exclude) {
+      const el = r.value;
+      if (!el) continue;
+      if (el === target || el.contains(target)) return true;
+    }
+    return false;
+  };
+  const onPointerDown = (event) => {
+    if (!options.enabled.value) return;
+    if (isExcluded(event.target)) return;
+    options.onDismiss();
+  };
+  const onKeyDown = (event) => {
+    if (!options.enabled.value) return;
+    if (event.key === "Escape") {
+      event.stopPropagation();
+      options.onDismiss();
+    }
+  };
+  const attach = () => {
+    if (typeof document === "undefined") return;
+    if (outsidePointerDown) {
+      document.addEventListener("pointerdown", onPointerDown, true);
+    }
+    if (escape) {
+      document.addEventListener("keydown", onKeyDown);
+    }
+  };
+  const detach = () => {
+    if (typeof document === "undefined") return;
+    document.removeEventListener("pointerdown", onPointerDown, true);
+    document.removeEventListener("keydown", onKeyDown);
+  };
+  vue.watch(
+    options.enabled,
+    (enabled) => {
+      detach();
+      if (enabled) attach();
+    },
+    { immediate: true, flush: "post" }
+  );
+  vue.onScopeDispose(detach);
+}
+
+exports.useDismiss = useDismiss;
+exports.useFloating = useFloating;
+//# sourceMappingURL=floating.cjs.map
+//# sourceMappingURL=floating.cjs.map

package/dist/floating.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/floating/useFloating.ts","../src/primitives/floating/useDismiss.ts"],"names":["ref","shallowRef","offsetMiddleware","flipMiddleware","shiftMiddleware","sizeMiddleware","arrowMiddleware","computePosition","watch","autoUpdate","onScopeDispose","computed"],"mappings":"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","file":"floating.cjs","sourcesContent":["import { computed, onScopeDispose, ref, shallowRef, watch, type ComputedRef, type Ref } from 'vue'\nimport {\n  autoUpdate,\n  computePosition,\n  arrow as arrowMiddleware,\n  flip as flipMiddleware,\n  offset as offsetMiddleware,\n  shift as shiftMiddleware,\n  size as sizeMiddleware,\n  type Middleware,\n  type Placement,\n  type Strategy,\n} from '@floating-ui/dom'\n\nexport interface UseFloatingOptions {\n  /** Element the floating panel is positioned relative to. */\n  anchor: Ref<HTMLElement | null | undefined>\n  /** The floating element itself. */\n  floating: Ref<HTMLElement | null | undefined>\n  /** Whether the floating element is visible. Controls `autoUpdate` lifecycle. */\n  open: Ref<boolean>\n  /** Default placement. Floating UI may flip it if `flip` is true. */\n  placement?: Placement\n  /** CSS position strategy. */\n  strategy?: Strategy\n  /** Pixel offset between anchor and floating element. */\n  offset?: number\n  /** Flip to the opposite side when the requested side overflows. Default `true`. */\n  flip?: boolean\n  /** Shift along the cross-axis to stay in view. Default `true`. */\n  shift?: boolean\n  /**\n   * Constrain the floating element to the available viewport space — sets\n   * `maxWidth`/`maxHeight` (minus 8px padding) on it so a long dropdown/popover\n   * never overflows the screen (pair with `overflow:auto` for scroll). Off by\n   * default. Pass a number to override the viewport padding.\n   */\n  size?: boolean | number\n  /** Extra Floating UI middleware to append. */\n  middleware?: Middleware[]\n  /**\n   * Optional ref to an arrow element inside the floating panel. When provided,\n   * `arrowX`, `arrowY`, and `arrowSide` in the return value are populated.\n   */\n  arrow?: Ref<HTMLElement | null | undefined>\n}\n\nexport interface UseFloatingReturn {\n  /** Computed x coordinate (px). */\n  x: Ref<number>\n  /** Computed y coordinate (px). */\n  y: Ref<number>\n  /** Final strategy (echo of input). */\n  strategy: Ref<Strategy>\n  /** Final placement, possibly flipped from the input placement. */\n  finalPlacement: Ref<Placement>\n  /** Ready-to-bind inline style object for the floating element. */\n  floatingStyles: ComputedRef<Record<string, string>>\n  /** Trigger a manual recompute. Usually not needed — `autoUpdate` handles scrolling/resizing. */\n  update: () => Promise<void>\n  /** Arrow x offset (px). Present when `arrow` option is set. */\n  arrowX: Ref<number | undefined>\n  /** Arrow y offset (px). Present when `arrow` option is set. */\n  arrowY: Ref<number | undefined>\n  /**\n   * Side of the floating element the arrow is on.\n   * E.g. `'bottom'` placement → `'top'` (arrow at top pointing up).\n   */\n  arrowSide: ComputedRef<'top' | 'right' | 'bottom' | 'left' | undefined>\n}\n\n/**\n * Reactive Floating UI integration. Subscribes `autoUpdate` whenever\n * `open === true` and both refs are populated; tears it down on close,\n * unmount, or ref clearing. Returns `floatingStyles` ready to be spread onto\n * the floating element.\n *\n * Pure positioning — does NOT render anything, does NOT manage focus,\n * does NOT handle dismiss behavior. Those concerns live in the consuming\n * primitive (Popover, Tooltip, Dialog, Menu, ...).\n *\n * @example\n *   const triggerEl = ref<HTMLElement | null>(null)\n *   const contentEl = ref<HTMLElement | null>(null)\n *   const open = ref(false)\n *   const { floatingStyles } = useFloating({\n *     anchor: triggerEl,\n *     floating: contentEl,\n *     open,\n *     placement: 'bottom-start',\n *     offset: 8,\n *   })\n */\nexport function useFloating(options: UseFloatingOptions): UseFloatingReturn {\n  const x = ref(0)\n  const y = ref(0)\n  const strategy = ref<Strategy>(options.strategy ?? 'absolute')\n  const finalPlacement = ref<Placement>(options.placement ?? 'bottom')\n  const arrowX = ref<number | undefined>()\n  const arrowY = ref<number | undefined>()\n\n  const middleware = shallowRef<Middleware[]>([])\n  rebuildMiddleware()\n\n  function rebuildMiddleware() {\n    const mw: Middleware[] = []\n    if (options.offset !== undefined) mw.push(offsetMiddleware(options.offset))\n    if (options.flip !== false) mw.push(flipMiddleware())\n    if (options.shift !== false) mw.push(shiftMiddleware({ padding: 8 }))\n    if (options.size) {\n      const padding = typeof options.size === 'number' ? options.size : 8\n      mw.push(\n        sizeMiddleware({\n          padding,\n          apply({ availableWidth, availableHeight, elements }) {\n            Object.assign(elements.floating.style, {\n              maxWidth: `${Math.max(0, Math.floor(availableWidth))}px`,\n              maxHeight: `${Math.max(0, Math.floor(availableHeight))}px`,\n            })\n          },\n        }),\n      )\n    }\n    if (options.arrow?.value) mw.push(arrowMiddleware({ element: options.arrow.value }))\n    if (options.middleware) mw.push(...options.middleware)\n    middleware.value = mw\n  }\n\n  let cleanupAutoUpdate: (() => void) | null = null\n  // Monotonic token bumped on every new positioning cycle and on teardown, so a\n  // computePosition() that resolves after the panel closed/re-opened (or after a\n  // newer update started) drops its result instead of applying stale coords.\n  let epoch = 0\n\n  async function update() {\n    const a = options.anchor.value\n    const f = options.floating.value\n    if (!a || !f) return\n    rebuildMiddleware()\n    const token = ++epoch\n    const result = await computePosition(a, f, {\n      placement: options.placement ?? 'bottom',\n      strategy: strategy.value,\n      middleware: middleware.value,\n    })\n    if (token !== epoch) return\n    x.value = result.x\n    y.value = result.y\n    finalPlacement.value = result.placement\n    const arrowData = result.middlewareData.arrow as { x?: number; y?: number } | undefined\n    arrowX.value = arrowData?.x\n    arrowY.value = arrowData?.y\n  }\n\n  watch(\n    [options.open, options.anchor, options.floating],\n    ([isOpen, anchorEl, floatingEl]) => {\n      cleanupAutoUpdate?.()\n      cleanupAutoUpdate = null\n      epoch++\n      if (isOpen && anchorEl && floatingEl) {\n        cleanupAutoUpdate = autoUpdate(anchorEl, floatingEl, () => {\n          void update()\n        })\n      }\n    },\n    { flush: 'post', immediate: true },\n  )\n\n  onScopeDispose(() => {\n    cleanupAutoUpdate?.()\n    cleanupAutoUpdate = null\n    epoch++\n  })\n\n  const OPPOSITE: Record<string, 'top' | 'right' | 'bottom' | 'left'> = {\n    top: 'bottom',\n    bottom: 'top',\n    left: 'right',\n    right: 'left',\n  }\n  const arrowSide = computed(\n    () =>\n      OPPOSITE[finalPlacement.value.split('-')[0]] as\n        | 'top'\n        | 'right'\n        | 'bottom'\n        | 'left'\n        | undefined,\n  )\n\n  const floatingStyles = computed<Record<string, string>>(() => ({\n    position: strategy.value,\n    top: '0',\n    left: '0',\n    transform: `translate3d(${Math.round(x.value)}px, ${Math.round(y.value)}px, 0)`,\n    width: 'max-content',\n  }))\n\n  return { x, y, strategy, finalPlacement, floatingStyles, update, arrowX, arrowY, arrowSide }\n}\n","import { onScopeDispose, watch, type Ref } from 'vue'\n\nexport interface UseDismissOptions {\n  /** While true, the dismiss listeners are active. */\n  enabled: Ref<boolean>\n  /** Elements that, if clicked, should NOT trigger dismiss (typically trigger + content). */\n  exclude: Array<Ref<HTMLElement | null | undefined>>\n  /** Called when the user attempts to dismiss the surface. */\n  onDismiss: () => void\n  /** Close on Escape key. Default `true`. */\n  escape?: boolean\n  /** Close on pointerdown outside the excluded elements. Default `true`. */\n  outsidePointerDown?: boolean\n}\n\n/**\n * Listen for the universal \"dismiss\" gestures: Escape key and outside\n * pointer-down. Used by Popover / Dialog / Menu / Combobox. Tooltip does\n * NOT use this — it dismisses on mouseleave/blur instead.\n *\n * Listeners are attached to `document` only while `enabled` is true, and\n * removed on disable / unmount. SSR-safe (no-op without `document`).\n */\nexport function useDismiss(options: UseDismissOptions): void {\n  const escape = options.escape !== false\n  const outsidePointerDown = options.outsidePointerDown !== false\n\n  const isExcluded = (target: EventTarget | null): boolean => {\n    if (!target || !(target instanceof Node)) return false\n    for (const r of options.exclude) {\n      const el = r.value\n      if (!el) continue\n      if (el === target || el.contains(target)) return true\n    }\n    return false\n  }\n\n  const onPointerDown = (event: PointerEvent) => {\n    if (!options.enabled.value) return\n    if (isExcluded(event.target)) return\n    options.onDismiss()\n  }\n\n  const onKeyDown = (event: KeyboardEvent) => {\n    if (!options.enabled.value) return\n    if (event.key === 'Escape') {\n      event.stopPropagation()\n      options.onDismiss()\n    }\n  }\n\n  const attach = () => {\n    if (typeof document === 'undefined') return\n    if (outsidePointerDown) {\n      document.addEventListener('pointerdown', onPointerDown, true)\n    }\n    if (escape) {\n      document.addEventListener('keydown', onKeyDown)\n    }\n  }\n\n  const detach = () => {\n    if (typeof document === 'undefined') return\n    document.removeEventListener('pointerdown', onPointerDown, true)\n    document.removeEventListener('keydown', onKeyDown)\n  }\n\n  watch(\n    options.enabled,\n    (enabled) => {\n      detach()\n      if (enabled) attach()\n    },\n    { immediate: true, flush: 'post' },\n  )\n\n  onScopeDispose(detach)\n}\n"]}

package/dist/floating.d.cts

@@ -0,0 +1,106 @@
+import { Ref, ComputedRef } from 'vue';
+import { Placement, Strategy, Middleware } from '@floating-ui/dom';
+export { Middleware, Strategy } from '@floating-ui/dom';
+
+interface UseFloatingOptions {
+    /** Element the floating panel is positioned relative to. */
+    anchor: Ref<HTMLElement | null | undefined>;
+    /** The floating element itself. */
+    floating: Ref<HTMLElement | null | undefined>;
+    /** Whether the floating element is visible. Controls `autoUpdate` lifecycle. */
+    open: Ref<boolean>;
+    /** Default placement. Floating UI may flip it if `flip` is true. */
+    placement?: Placement;
+    /** CSS position strategy. */
+    strategy?: Strategy;
+    /** Pixel offset between anchor and floating element. */
+    offset?: number;
+    /** Flip to the opposite side when the requested side overflows. Default `true`. */
+    flip?: boolean;
+    /** Shift along the cross-axis to stay in view. Default `true`. */
+    shift?: boolean;
+    /**
+     * Constrain the floating element to the available viewport space — sets
+     * `maxWidth`/`maxHeight` (minus 8px padding) on it so a long dropdown/popover
+     * never overflows the screen (pair with `overflow:auto` for scroll). Off by
+     * default. Pass a number to override the viewport padding.
+     */
+    size?: boolean | number;
+    /** Extra Floating UI middleware to append. */
+    middleware?: Middleware[];
+    /**
+     * Optional ref to an arrow element inside the floating panel. When provided,
+     * `arrowX`, `arrowY`, and `arrowSide` in the return value are populated.
+     */
+    arrow?: Ref<HTMLElement | null | undefined>;
+}
+interface UseFloatingReturn {
+    /** Computed x coordinate (px). */
+    x: Ref<number>;
+    /** Computed y coordinate (px). */
+    y: Ref<number>;
+    /** Final strategy (echo of input). */
+    strategy: Ref<Strategy>;
+    /** Final placement, possibly flipped from the input placement. */
+    finalPlacement: Ref<Placement>;
+    /** Ready-to-bind inline style object for the floating element. */
+    floatingStyles: ComputedRef<Record<string, string>>;
+    /** Trigger a manual recompute. Usually not needed — `autoUpdate` handles scrolling/resizing. */
+    update: () => Promise<void>;
+    /** Arrow x offset (px). Present when `arrow` option is set. */
+    arrowX: Ref<number | undefined>;
+    /** Arrow y offset (px). Present when `arrow` option is set. */
+    arrowY: Ref<number | undefined>;
+    /**
+     * Side of the floating element the arrow is on.
+     * E.g. `'bottom'` placement → `'top'` (arrow at top pointing up).
+     */
+    arrowSide: ComputedRef<'top' | 'right' | 'bottom' | 'left' | undefined>;
+}
+/**
+ * Reactive Floating UI integration. Subscribes `autoUpdate` whenever
+ * `open === true` and both refs are populated; tears it down on close,
+ * unmount, or ref clearing. Returns `floatingStyles` ready to be spread onto
+ * the floating element.
+ *
+ * Pure positioning — does NOT render anything, does NOT manage focus,
+ * does NOT handle dismiss behavior. Those concerns live in the consuming
+ * primitive (Popover, Tooltip, Dialog, Menu, ...).
+ *
+ * @example
+ *   const triggerEl = ref<HTMLElement | null>(null)
+ *   const contentEl = ref<HTMLElement | null>(null)
+ *   const open = ref(false)
+ *   const { floatingStyles } = useFloating({
+ *     anchor: triggerEl,
+ *     floating: contentEl,
+ *     open,
+ *     placement: 'bottom-start',
+ *     offset: 8,
+ *   })
+ */
+declare function useFloating(options: UseFloatingOptions): UseFloatingReturn;
+
+interface UseDismissOptions {
+    /** While true, the dismiss listeners are active. */
+    enabled: Ref<boolean>;
+    /** Elements that, if clicked, should NOT trigger dismiss (typically trigger + content). */
+    exclude: Array<Ref<HTMLElement | null | undefined>>;
+    /** Called when the user attempts to dismiss the surface. */
+    onDismiss: () => void;
+    /** Close on Escape key. Default `true`. */
+    escape?: boolean;
+    /** Close on pointerdown outside the excluded elements. Default `true`. */
+    outsidePointerDown?: boolean;
+}
+/**
+ * Listen for the universal "dismiss" gestures: Escape key and outside
+ * pointer-down. Used by Popover / Dialog / Menu / Combobox. Tooltip does
+ * NOT use this — it dismisses on mouseleave/blur instead.
+ *
+ * Listeners are attached to `document` only while `enabled` is true, and
+ * removed on disable / unmount. SSR-safe (no-op without `document`).
+ */
+declare function useDismiss(options: UseDismissOptions): void;
+
+export { type UseDismissOptions, type UseFloatingOptions, type UseFloatingReturn, useDismiss, useFloating };