zcw-shared 1.23.0 → 1.25.0

package/dist/functions/dom/computePosition.d.ts

@@ -0,0 +1,6 @@
+import type { Placement } from '../../../types/placement';
+import type { Rect, Coords } from '../../../types/geometry';
+export declare function computePosition(placement: Placement, reference: Rect, floating: {
+    width: number;
+    height: number;
+}, scrollOffset: Coords): Coords;

package/dist/functions/dom/computePosition.js

@@ -0,0 +1,49 @@
+import { getBasePlacement } from './getBasePlacement';
+import { getAlignment } from './getAlignment';
+export function computePosition(placement, reference, floating, scrollOffset) {
+    const basePlacement = getBasePlacement(placement);
+    const alignment = getAlignment(placement);
+    let x = reference.x;
+    let y = reference.y;
+    switch (basePlacement) {
+        case 'top':
+            x = x + reference.width / 2 - floating.width / 2;
+            y = reference.y - floating.height;
+            break;
+        case 'bottom':
+            x = x + reference.width / 2 - floating.width / 2;
+            y = reference.y + reference.height;
+            break;
+        case 'left':
+            x = x - floating.width;
+            y = y + reference.height / 2 - floating.height / 2;
+            break;
+        case 'right':
+            x = x + reference.width;
+            y = y + reference.height / 2 - floating.height / 2;
+            break;
+    }
+    if (alignment) {
+        if (basePlacement === 'top' || basePlacement === 'bottom') {
+            if (alignment === 'start') {
+                x = reference.x;
+            }
+            else if (alignment === 'end') {
+                x = reference.x + reference.width - floating.width;
+            }
+        }
+        else {
+            if (alignment === 'start') {
+                y = reference.y;
+            }
+            else if (alignment === 'end') {
+                y = reference.y + reference.height - floating.height;
+            }
+        }
+    }
+    return {
+        x: x + scrollOffset.x,
+        y: y + scrollOffset.y,
+    };
+}
+//# sourceMappingURL=computePosition.js.map

package/dist/functions/dom/computePosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computePosition.js","sourceRoot":"","sources":["../../../src/functions/dom/computePosition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA0B7C,MAAM,UAAU,eAAe,CAC7B,SAAoB,EACpB,SAAe,EACf,QAA2C,EAC3C,YAAoB;IAEpB,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAGzC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;IACnB,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;IAGnB,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,KAAK;YACR,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAA;YAChD,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAA;YACjC,MAAK;QACP,KAAK,QAAQ;YACX,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAA;YAChD,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAA;YAClC,MAAK;QACP,KAAK,MAAM;YACT,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAA;YACtB,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAClD,MAAK;QACP,KAAK,OAAO;YACV,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAA;YACvB,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAClD,MAAK;IACT,CAAC;IAGD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,aAAa,KAAK,KAAK,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAE1D,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC1B,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;YACjB,CAAC;iBAAM,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC/B,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;YACpD,CAAC;QACH,CAAC;aAAM,CAAC;YAEN,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC1B,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;YACjB,CAAC;iBAAM,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC/B,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAGD,OAAO;QACL,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC;QACrB,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC;KACtB,CAAA;AACH,CAAC"}

package/dist/functions/dom/getAlignment.d.ts

@@ -0,0 +1,2 @@
+import type { Placement, Alignment } from '../../../types/placement';
+export declare function getAlignment(placement: Placement): Alignment | null;

package/dist/functions/dom/getAlignment.js

@@ -0,0 +1,5 @@
+export function getAlignment(placement) {
+    const parts = placement.split('-');
+    return parts.length > 1 ? parts[1] : null;
+}
+//# sourceMappingURL=getAlignment.js.map

package/dist/functions/dom/getAlignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAlignment.js","sourceRoot":"","sources":["../../../src/functions/dom/getAlignment.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAe,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC"}

package/dist/functions/dom/getBasePlacement.d.ts

@@ -0,0 +1,2 @@
+import type { Placement, BasePlacement } from '../../../types/placement';
+export declare function getBasePlacement(placement: Placement): BasePlacement;

package/dist/functions/dom/getBasePlacement.js

@@ -0,0 +1,4 @@
+export function getBasePlacement(placement) {
+    return placement.split('-')[0];
+}
+//# sourceMappingURL=getBasePlacement.js.map

package/dist/functions/dom/getBasePlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBasePlacement.js","sourceRoot":"","sources":["../../../src/functions/dom/getBasePlacement.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAkB,CAAA;AACjD,CAAC"}

package/dist/functions/dom/getCrossAxisFlip.d.ts

@@ -0,0 +1,2 @@
+import type { Placement } from '../../../types/placement';
+export declare function getCrossAxisFlip(placement: Placement): Placement;

package/dist/functions/dom/getCrossAxisFlip.js

@@ -0,0 +1,11 @@
+import { getBasePlacement } from './getBasePlacement';
+import { getAlignment } from './getAlignment';
+export function getCrossAxisFlip(placement) {
+    const basePlacement = getBasePlacement(placement);
+    const alignment = getAlignment(placement);
+    if (!alignment)
+        return placement;
+    const newAlignment = alignment === 'start' ? 'end' : 'start';
+    return `${basePlacement}-${newAlignment}`;
+}
+//# sourceMappingURL=getCrossAxisFlip.js.map

package/dist/functions/dom/getCrossAxisFlip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCrossAxisFlip.js","sourceRoot":"","sources":["../../../src/functions/dom/getCrossAxisFlip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAmB7C,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAEzC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAEhC,MAAM,YAAY,GAAc,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;IACvE,OAAO,GAAG,aAAa,IAAI,YAAY,EAAe,CAAA;AACxD,CAAC"}

package/dist/functions/dom/getFlipPlacements.d.ts

@@ -0,0 +1,2 @@
+import type { Placement } from '../../../types/placement';
+export declare function getFlipPlacements(placement: Placement): Placement[];

package/dist/functions/dom/getFlipPlacements.js

@@ -0,0 +1,13 @@
+import { getBasePlacement } from './getBasePlacement';
+import { getAlignment } from './getAlignment';
+export function getFlipPlacements(placement) {
+    const basePlacement = getBasePlacement(placement);
+    const alignment = getAlignment(placement);
+    const allBasePlacements = ['top', 'right', 'bottom', 'left'];
+    const otherBasePlacements = allBasePlacements.filter(p => p !== basePlacement);
+    if (!alignment) {
+        return otherBasePlacements;
+    }
+    return otherBasePlacements.map(base => `${base}-${alignment}`);
+}
+//# sourceMappingURL=getFlipPlacements.js.map

package/dist/functions/dom/getFlipPlacements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFlipPlacements.js","sourceRoot":"","sources":["../../../src/functions/dom/getFlipPlacements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAiB7C,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAEzC,MAAM,iBAAiB,GAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7E,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,CAAA;IAE9E,IAAI,CAAC,SAAS,EAAE,CAAC;QAEf,OAAO,mBAAkC,CAAA;IAC3C,CAAC;IAGD,OAAO,mBAAmB,CAAC,GAAG,CAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,SAAS,EAAe,CAC5C,CAAA;AACH,CAAC"}

package/dist/functions/dom/getMainAxisFlip.d.ts

@@ -0,0 +1,2 @@
+import type { Placement } from '../../../types/placement';
+export declare function getMainAxisFlip(placement: Placement): Placement;

package/dist/functions/dom/getMainAxisFlip.js

@@ -0,0 +1,17 @@
+import { getBasePlacement } from './getBasePlacement';
+import { getAlignment } from './getAlignment';
+export function getMainAxisFlip(placement) {
+    const basePlacement = getBasePlacement(placement);
+    const alignment = getAlignment(placement);
+    const flips = {
+        top: 'bottom',
+        bottom: 'top',
+        left: 'right',
+        right: 'left',
+    };
+    const flippedBase = flips[basePlacement];
+    return alignment
+        ? `${flippedBase}-${alignment}`
+        : flippedBase;
+}
+//# sourceMappingURL=getMainAxisFlip.js.map

package/dist/functions/dom/getMainAxisFlip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMainAxisFlip.js","sourceRoot":"","sources":["../../../src/functions/dom/getMainAxisFlip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAkB7C,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAEzC,MAAM,KAAK,GAAyC;QAClD,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,MAAM;KACd,CAAA;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAA;IACxC,OAAO,SAAS;QACd,CAAC,CAAE,GAAG,WAAW,IAAI,SAAS,EAAgB;QAC9C,CAAC,CAAE,WAAyB,CAAA;AAChC,CAAC"}

package/dist/functions/dom/isValidPlacement.d.ts

@@ -0,0 +1,2 @@
+import type { Placement } from '../../../types/placement';
+export declare function isValidPlacement(placement: string): placement is Placement;

package/dist/functions/dom/isValidPlacement.js

@@ -0,0 +1,16 @@
+export function isValidPlacement(placement) {
+    const validBasePlacements = ['top', 'right', 'bottom', 'left'];
+    const validAlignments = ['start', 'end'];
+    const parts = placement.split('-');
+    if (parts.length > 2 || parts.length === 0) {
+        return false;
+    }
+    if (!validBasePlacements.includes(parts[0])) {
+        return false;
+    }
+    if (parts.length === 2 && !validAlignments.includes(parts[1])) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=isValidPlacement.js.map

package/dist/functions/dom/isValidPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidPlacement.js","sourceRoot":"","sources":["../../../src/functions/dom/isValidPlacement.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,mBAAmB,GAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC/E,MAAM,eAAe,GAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAGrD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAA;IACd,CAAC;IAGD,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAkB,CAAC,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAA;IACd,CAAC;IAGD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAc,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/vue-hooks/dom/useAutoUpdate.d.ts

@@ -0,0 +1,19 @@
+import type { UnwrapRef } from '../../../references/vue.d';
+import type { VueCompositionAPI } from '../../../types/vue.d';
+import type { CreateThrottledEventListenerDeps } from '../../functions/dom/createThrottledEventListener';
+export interface StateData {
+    visible: boolean;
+}
+export type State = UnwrapRef<StateData>;
+export interface UseAutoUpdateDeps extends CreateThrottledEventListenerDeps {
+    watch: VueCompositionAPI['watch'];
+}
+export interface UseAutoUpdateOptions {
+    state: State;
+    update: () => void;
+    throttleMs?: number;
+}
+export interface UseAutoUpdateReturn {
+    destroy: () => void;
+}
+export declare function useAutoUpdate(options: UseAutoUpdateOptions, deps: UseAutoUpdateDeps): UseAutoUpdateReturn;

package/dist/vue-hooks/dom/useAutoUpdate.js

@@ -0,0 +1,41 @@
+import { createThrottledEventListener } from '../../functions/dom/createThrottledEventListener';
+export function useAutoUpdate(options, deps) {
+    const { state, update, throttleMs = 0 } = options;
+    let resizeCleanup = null;
+    let scrollCleanup = null;
+    const stopAutoUpdateWatch = deps.watch(() => state.visible, (visible) => {
+        if (visible) {
+            if (!resizeCleanup) {
+                resizeCleanup = createThrottledEventListener('resize', update, throttleMs, deps);
+            }
+            if (!scrollCleanup) {
+                scrollCleanup = createThrottledEventListener('scroll', update, throttleMs, deps);
+            }
+        }
+        else {
+            if (resizeCleanup) {
+                resizeCleanup();
+                resizeCleanup = null;
+            }
+            if (scrollCleanup) {
+                scrollCleanup();
+                scrollCleanup = null;
+            }
+        }
+    }, { immediate: true });
+    const destroy = () => {
+        try {
+            stopAutoUpdateWatch();
+            resizeCleanup?.();
+            scrollCleanup?.();
+        }
+        finally {
+            resizeCleanup = null;
+            scrollCleanup = null;
+        }
+    };
+    return {
+        destroy,
+    };
+}
+//# sourceMappingURL=useAutoUpdate.js.map

package/dist/vue-hooks/dom/useAutoUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoUpdate.js","sourceRoot":"","sources":["../../../src/vue-hooks/dom/useAutoUpdate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAA;AA8E/F,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,IAAuB;IAEvB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,GAAG,OAAO,CAAA;IAEjD,IAAI,aAAa,GAAwB,IAAI,CAAA;IAC7C,IAAI,aAAa,GAAwB,IAAI,CAAA;IAG7C,MAAM,mBAAmB,GAAoB,IAAI,CAAC,KAAM,CACtD,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EACnB,CAAC,OAAO,EAAE,EAAE;QACV,IAAI,OAAO,EAAE,CAAC;YAEZ,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;YAClF,CAAC;YACD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;YAClF,CAAC;QACH,CAAC;aAAM,CAAC;YAEN,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,EAAE,CAAA;gBACf,aAAa,GAAG,IAAI,CAAA;YACtB,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,EAAE,CAAA;gBACf,aAAa,GAAG,IAAI,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC,EACD,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IAED,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC;YACH,mBAAmB,EAAE,CAAA;YACrB,aAAa,EAAE,EAAE,CAAA;YACjB,aAAa,EAAE,EAAE,CAAA;QACnB,CAAC;gBAAS,CAAC;YACT,aAAa,GAAG,IAAI,CAAA;YACpB,aAAa,GAAG,IAAI,CAAA;QACtB,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,OAAO;KACR,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.23.0",
+  "version": "1.25.0",
   "files": [
     "references",
     "dist",
@@ -119,12 +119,19 @@
     "./functions/design-tokens/generateVariables": "./dist/functions/design-tokens/generateVariables.js",
     "./functions/design-tokens/mixColors": "./dist/functions/design-tokens/mixColors.js",
     "./functions/design-tokens/parseDesignTokens": "./dist/functions/design-tokens/parseDesignTokens.js",
+    "./functions/dom/computePosition": "./dist/functions/dom/computePosition.js",
     "./functions/dom/createThrottledEventListener": "./dist/functions/dom/createThrottledEventListener.js",
     "./functions/dom/demonstrateResourceLoading": "./dist/functions/dom/demonstrateResourceLoading.js",
     "./functions/dom/detectOverflow": "./dist/functions/dom/detectOverflow.js",
+    "./functions/dom/getAlignment": "./dist/functions/dom/getAlignment.js",
+    "./functions/dom/getBasePlacement": "./dist/functions/dom/getBasePlacement.js",
+    "./functions/dom/getCrossAxisFlip": "./dist/functions/dom/getCrossAxisFlip.js",
     "./functions/dom/getElementRect": "./dist/functions/dom/getElementRect.js",
+    "./functions/dom/getFlipPlacements": "./dist/functions/dom/getFlipPlacements.js",
+    "./functions/dom/getMainAxisFlip": "./dist/functions/dom/getMainAxisFlip.js",
     "./functions/dom/getRelativePosition": "./dist/functions/dom/getRelativePosition.js",
     "./functions/dom/getViewportRect": "./dist/functions/dom/getViewportRect.js",
+    "./functions/dom/isValidPlacement": "./dist/functions/dom/isValidPlacement.js",
     "./functions/file/formatFileSize": "./dist/functions/file/formatFileSize.js",
     "./functions/file/getFileExtension": "./dist/functions/file/getFileExtension.js",
     "./functions/functional/compose": "./dist/functions/functional/compose.js",
@@ -258,6 +265,7 @@
     "./vue-hooks/browser/useScreenWakeLock": "./dist/vue-hooks/browser/useScreenWakeLock.js",
     "./vue-hooks/browser/useShare": "./dist/vue-hooks/browser/useShare.js",
     "./vue-hooks/browser/useVibration": "./dist/vue-hooks/browser/useVibration.js",
+    "./vue-hooks/dom/useAutoUpdate": "./dist/vue-hooks/dom/useAutoUpdate.js",
     "./vue-hooks/dom/useClickOutside": "./dist/vue-hooks/dom/useClickOutside.js",
     "./vue-hooks/dom/useDraggable": "./dist/vue-hooks/dom/useDraggable.js",
     "./vue-hooks/dom/useEventListener": "./dist/vue-hooks/dom/useEventListener.js",
@@ -285,6 +293,7 @@
     "./types/color": "./types/color.d.ts",
     "./types/design-system": "./types/design-system.d.ts",
     "./types/geometry": "./types/geometry.d.ts",
+    "./types/placement": "./types/placement.d.ts",
     "./types/platform": "./types/platform.d.ts",
     "./types/reactive": "./types/reactive.d.ts",
     "./types/semver": "./types/semver.d.ts",

package/types/placement.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 基础定位方向类型
+ */
+export type BasePlacement = 'top' | 'right' | 'bottom' | 'left'
+
+/**
+ * 对齐方式类型
+ */
+export type Alignment = 'start' | 'end'
+
+/**
+ * 弹出层位置类型
+ */
+export type Placement = BasePlacement | `${BasePlacement}-${Alignment}`
+

package/types/vue.d.ts

@@ -1,5 +1,5 @@
 import type { ColorReference } from './design-system.d'
-import type { Ref, InjectionKey } from '../references/vue.d'
+import type { Ref, InjectionKey, WatchStopHandle } from '../references/vue.d'
 
 /**
  * Vue Composition API 通用接口
@@ -19,7 +19,7 @@ export interface VueCompositionAPI {
   /** 注入依赖 */
   inject?: <T>(key: InjectionKey<T> | string, defaultValue?: T) => T | undefined
   /** 监听响应式数据变化 */
-  watch?: (source: any, callback: () => void, options?: { deep?: boolean; flush?: string }) => void
+  watch?: <T>(source: (() => T) | Ref<T>, callback: (newValue: T, oldValue: T) => void, options?: { deep?: boolean; flush?: string; immediate?: boolean }) => WatchStopHandle
 }
 
 /**