zcw-shared 1.23.0 → 1.24.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.23.0",
+  "version": "1.24.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",
@@ -285,6 +292,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}`
+