@iris-ui-kit/vue 0.2.22 → 0.2.24

package/dist/data.d.ts

@@ -17,10 +17,14 @@ interface UseDataSource<T> extends DataSourceController<T> {
  * 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.
+ * Constructed with `immediate: false` so no fetch fires during `setup()`
+ * (SSR-safe: server rendering never runs `onMounted`); the initial load is
+ * kicked from `onMounted` when the caller's config says `immediate !== false`.
+ * The `onMounted` registration is conditional on that flag — inside a bare
+ * `effectScope` there is no component instance and Vue would warn on an
+ * unconditional registration. The controller is torn down on scope dispose
+ * (aborting any in-flight fetch), so a late response never writes back to a
+ * torn-down instance.
  */
 declare function useDataSource<T>(config: DataSourceConfig<T>): UseDataSource<T>;
 

package/dist/data.js

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

package/dist/error-boundary.cjs

@@ -59,12 +59,18 @@ var IrisErrorBoundary = vue.defineComponent({
   setup(props, { attrs, slots }) {
     const { t } = useI18n();
     const error = vue.ref(null);
+    const appContext = vue.getCurrentInstance().appContext;
     const reset = () => {
       error.value = null;
     };
-    vue.onErrorCaptured((err, _instance, info) => {
+    vue.onErrorCaptured((err, instance, info) => {
       error.value = err;
       props.onError?.(err, info);
+      try {
+        appContext.config.errorHandler?.(err, instance, info);
+      } catch (handlerError) {
+        console.error(handlerError);
+      }
       return false;
     });
     const renderDefaultFallback = () => {

package/dist/error-boundary.cjs.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/i18n/context.ts","../src/i18n/useI18n.ts","../src/error-boundary/IrisErrorBoundary.ts"],"names":["createI18n","inject","ref","onBeforeUnmount","computed","defineComponent","getCurrentInstance","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, getCurrentInstance, 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    // App-level telemetry handler (Sentry/…). Read live so a handler\n    // configured after this component's setup is still picked up.\n    const appContext = getCurrentInstance()!.appContext\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      // Vue's handleError skips its app.config.errorHandler branch when a hook\n      // returns false, so forward explicitly with the exact args Vue would\n      // have passed — (err, exposedInstance, errorInfo). Guarded so a throwing\n      // handler is logged, not rethrown: a bare call would escape containment\n      // from inside the hook and re-enter handleError with the handler's own\n      // error (Vue's own path wraps the handler in callWithErrorHandling).\n      try {\n        appContext.config.errorHandler?.(err, instance, info)\n      } catch (handlerError) {\n        console.error(handlerError)\n      }\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.js

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

package/dist/index.cjs

@@ -589,9 +589,9 @@ function useResourceController(config) {
 function useDataSource(config) {
   const controller = core.createDataSource({ ...config, immediate: false });
   const immediate = config.immediate !== false;
-  vue.onMounted(() => {
-    if (immediate) void controller.load();
-  });
+  if (immediate) {
+    vue.onMounted(() => void controller.load());
+  }
   vue.onScopeDispose(() => controller.destroy());
   const state = useStore(controller.store);
   return { ...controller, state };
@@ -3089,12 +3089,17 @@ function useUndoStack(options) {
     index: raw.index
   });
   const sync = () => {
-    state.value = {
+    const next = {
       canUndo: raw.canUndo(),
       canRedo: raw.canRedo(),
       depth: raw.depth,
       index: raw.index
     };
+    const cur = state.value;
+    if (next.canUndo === cur.canUndo && next.canRedo === cur.canRedo && next.depth === cur.depth && next.index === cur.index) {
+      return;
+    }
+    state.value = next;
   };
   const stack = trackUndoStack(raw, sync);
   const push = (snapshot) => stack.push(snapshot);
@@ -3232,12 +3237,18 @@ var IrisErrorBoundary = vue.defineComponent({
   setup(props, { attrs, slots }) {
     const { t } = useI18n();
     const error = vue.ref(null);
+    const appContext = vue.getCurrentInstance().appContext;
     const reset = () => {
       error.value = null;
     };
-    vue.onErrorCaptured((err, _instance, info) => {
+    vue.onErrorCaptured((err, instance, info) => {
       error.value = err;
       props.onError?.(err, info);
+      try {
+        appContext.config.errorHandler?.(err, instance, info);
+      } catch (handlerError) {
+        console.error(handlerError);
+      }
       return false;
     });
     const renderDefaultFallback = () => {
@@ -6345,7 +6356,10 @@ var IrisList = vue.defineComponent({
     const { state, isContent, stateKey, stateProps } = useDataState(() => ({
       loading: props.loading,
       error: props.error,
-      empty: props.items.length === 0
+      empty: props.items.length === 0,
+      // Already-loaded items stay mounted during a revalidate (SWR): a load
+      // in flight no longer replaces them with the loading/error state.
+      hasContent: props.items.length > 0
     }));
     const isEnabled = (i) => !props.items[i]?.disabled;
     const nav = core.createKeyboardNav({
@@ -6482,7 +6496,9 @@ var IrisList = vue.defineComponent({
         role: "listbox",
         "aria-label": props.ariaLabel,
         "aria-multiselectable": props.multi ? "true" : void 0,
-        "aria-busy": state.value === "loading" ? "true" : void 0,
+        // Decoupled from resolved state: signals both the initial load and
+        // an in-flight background revalidate (content stays mounted).
+        "aria-busy": props.loading ? "true" : void 0,
         "data-iris-list": "",
         onKeydown: onKeyDown,
         style: {
@@ -12059,7 +12075,10 @@ var IrisTree = vue.defineComponent({
     const { state, isContent, stateKey, stateProps } = useDataState(() => ({
       loading: props.loading,
       error: props.error,
-      empty: props.nodes.length === 0
+      empty: props.nodes.length === 0,
+      // Already-loaded nodes stay mounted during a revalidate (SWR): a load
+      // in flight no longer replaces them with the loading/error state.
+      hasContent: props.nodes.length > 0
     }));
     const lazyCache = vue.ref(/* @__PURE__ */ new Map());
     const loadingIds = vue.ref(/* @__PURE__ */ new Set());
@@ -12379,7 +12398,9 @@ var IrisTree = vue.defineComponent({
         role: "tree",
         "aria-label": props.ariaLabel ?? t("tree.label"),
         "aria-multiselectable": props.selectionMode === "multi" ? "true" : void 0,
-        "aria-busy": state.value === "loading" ? "true" : void 0,
+        // Decoupled from resolved state: signals both the initial load and
+        // an in-flight background revalidate (content stays mounted).
+        "aria-busy": props.loading ? "true" : void 0,
         "data-iris-tree": "",
         style: {
           display: "flex",
@@ -18439,14 +18460,32 @@ var IrisDashboardTemplate = vue.defineComponent({
     activeId: { type: String, default: "" },
     /** Cards to render in the main grid. Skip to use the `default` slot only. */
     cards: { type: Array, default: () => [] },
-    defaultCollapsed: { type: Boolean, default: false }
+    defaultCollapsed: { type: Boolean, default: false },
+    /**
+     * Controlled collapsed state. When unset (`undefined`), the component
+     * manages its own state seeded from `defaultCollapsed`; when set, this
+     * value takes precedence and changes are re-emitted via
+     * `update:collapsed` (`v-model:collapsed`).
+     */
+    collapsed: { type: Boolean, default: void 0 }
   },
   emits: {
     "update:activeId": (_id) => true,
     "update:collapsed": (_value) => true
   },
   setup(props, { attrs, slots, emit }) {
-    const collapsed = vue.ref(props.defaultCollapsed);
+    const isControlled = vue.computed(() => props.collapsed !== void 0);
+    const internalCollapsed = vue.ref(props.defaultCollapsed);
+    const collapsed = vue.computed(
+      () => isControlled.value ? Boolean(props.collapsed) : internalCollapsed.value
+    );
+    vue.watch(
+      () => props.collapsed,
+      (value) => {
+        if (value !== void 0) internalCollapsed.value = value;
+      },
+      { immediate: true }
+    );
     const onSelectNav = (id) => {
       emit("update:activeId", id);
     };
@@ -18468,7 +18507,7 @@ var IrisDashboardTemplate = vue.defineComponent({
         {
           collapsed: collapsed.value,
           "onUpdate:collapsed": (v) => {
-            collapsed.value = v;
+            if (!isControlled.value) internalCollapsed.value = v;
             emit("update:collapsed", v);
           },
           width: 240,
@@ -18655,6 +18694,72 @@ function handlePosition2(handle) {
   s.cursor = HANDLE_CURSORS2[handle];
   return s;
 }
+var ResizableHandle = vue.defineComponent({
+  name: "ResizableHandle",
+  props: {
+    handle: { type: String, required: true },
+    disabled: { type: Boolean, default: false },
+    keepAspect: { type: Boolean, default: false },
+    minWidth: { type: Number, default: 40 },
+    minHeight: { type: Number, default: 40 },
+    maxWidth: { type: Number, default: Infinity },
+    maxHeight: { type: Number, default: Infinity },
+    /** Stable computed ref from the parent; read only (never mutated). */
+    sizeRef: { type: Object, required: true },
+    /** Stable setup-level callbacks from the parent. */
+    onUpdate: { type: Function, required: true },
+    onResizeStart: {
+      type: Function,
+      default: void 0
+    },
+    onResizeEnd: { type: Function, default: void 0 }
+  },
+  setup(props) {
+    const handleRef = vue.ref(null);
+    let startSize = { width: 0, height: 0 };
+    let aspect = 1;
+    useDrag({
+      handle: handleRef,
+      disabled: vue.computed(() => props.disabled),
+      onStart: () => {
+        startSize = { ...props.sizeRef.value };
+        aspect = startSize.width / Math.max(1, startSize.height);
+        props.onResizeStart?.(startSize);
+      },
+      onDrag: ({ dx, dy }) => {
+        const t = props.handle.includes("top");
+        const b = props.handle.includes("bottom");
+        const l = props.handle.includes("left");
+        const r = props.handle.includes("right");
+        let nextW = startSize.width;
+        let nextH = startSize.height;
+        if (r) nextW = startSize.width + dx;
+        if (l) nextW = startSize.width - dx;
+        if (b) nextH = startSize.height + dy;
+        if (t) nextH = startSize.height - dy;
+        if (props.keepAspect && (t || b) && (l || r)) {
+          nextH = nextW / aspect;
+        }
+        nextW = Math.max(props.minWidth, Math.min(props.maxWidth, nextW));
+        nextH = Math.max(props.minHeight, Math.min(props.maxHeight, nextH));
+        props.onUpdate({ width: nextW, height: nextH });
+      },
+      onEnd: () => props.onResizeEnd?.()
+    });
+    return () => vue.h("div", {
+      ref: (el) => {
+        handleRef.value = el ?? null;
+      },
+      "data-iris-resizable-handle": props.handle,
+      style: {
+        ...handlePosition2(props.handle),
+        touchAction: "none",
+        background: "transparent",
+        zIndex: "1"
+      }
+    });
+  }
+});
 var IrisResizable = vue.defineComponent({
   name: "IrisResizable",
   inheritAttrs: false,
@@ -18687,53 +18792,8 @@ var IrisResizable = vue.defineComponent({
       if (!isControlled.value) internal.value = next;
       emit("update:size", next);
     };
-    const renderHandle = (handle) => {
-      const handleRef = vue.ref(null);
-      let startSize = { width: 0, height: 0 };
-      let aspect = 1;
-      useDrag({
-        handle: handleRef,
-        disabled: vue.computed(() => props.disabled),
-        onStart: () => {
-          startSize = { ...size.value };
-          aspect = startSize.width / Math.max(1, startSize.height);
-          emit("resizeStart", startSize);
-        },
-        onDrag: ({ dx, dy }) => {
-          const t = handle.includes("top");
-          const b = handle.includes("bottom");
-          const l = handle.includes("left");
-          const r = handle.includes("right");
-          let nextW = startSize.width;
-          let nextH = startSize.height;
-          if (r) nextW = startSize.width + dx;
-          if (l) nextW = startSize.width - dx;
-          if (b) nextH = startSize.height + dy;
-          if (t) nextH = startSize.height - dy;
-          if (props.keepAspect && (t || b) && (l || r)) {
-            nextH = nextW / aspect;
-          }
-          nextW = Math.max(props.minWidth, Math.min(props.maxWidth, nextW));
-          nextH = Math.max(props.minHeight, Math.min(props.maxHeight, nextH));
-          setSize({ width: nextW, height: nextH });
-        },
-        onEnd: () => {
-          emit("resizeEnd", size.value);
-        }
-      });
-      return vue.h("div", {
-        ref: (el) => {
-          handleRef.value = el ?? null;
-        },
-        "data-iris-resizable-handle": handle,
-        style: {
-          ...handlePosition2(handle),
-          touchAction: "none",
-          background: "transparent",
-          zIndex: "1"
-        }
-      });
-    };
+    const emitResizeStart = (s) => emit("resizeStart", s);
+    const emitResizeEnd = () => emit("resizeEnd", size.value);
     return () => vue.h(
       "div",
       {
@@ -18748,7 +18808,25 @@ var IrisResizable = vue.defineComponent({
           ...attrs.style ?? {}
         }
       },
-      [slots.default?.(), ...props.handles.map(renderHandle)]
+      [
+        slots.default?.(),
+        ...props.handles.map(
+          (handle) => vue.h(ResizableHandle, {
+            key: handle,
+            handle,
+            disabled: props.disabled,
+            keepAspect: props.keepAspect,
+            minWidth: props.minWidth,
+            minHeight: props.minHeight,
+            maxWidth: props.maxWidth,
+            maxHeight: props.maxHeight,
+            sizeRef: size,
+            onUpdate: setSize,
+            onResizeStart: emitResizeStart,
+            onResizeEnd: emitResizeEnd
+          })
+        )
+      ]
     );
   }
 });