jsbox-cview 1.5.21 → 1.5.23

package/utils/path.ts

@@ -1,6 +1,6 @@
 // 用于处理路径的工具函数
 
-function _splitProtocol(path: string): [string, string]{
+function _splitProtocol(path: string): [string, string] {
   const regex = /^\w+:\/\//;
   const result = regex.exec(path);
   if (result) {
@@ -20,7 +20,7 @@ function _normalize(path: string): string {
   return protocol + remainingPath.replace(/\/{2,}/g, "/");
 }
 
-export function split(path: string): [string, string]{
+export function split(path: string): [string, string] {
   path = _normalize(path);
   const [protocol, remainingPath] = _splitProtocol(path);
   const lastIndex = remainingPath.lastIndexOf("/");
@@ -31,12 +31,12 @@ export function split(path: string): [string, string]{
   } else {
     return [
       protocol + remainingPath.slice(0, lastIndex),
-      remainingPath.slice(lastIndex + 1)
+      remainingPath.slice(lastIndex + 1),
     ];
   }
 }
 
-export function dirname(path: string): string{
+export function dirname(path: string): string {
   return split(path)[0];
 }
 
@@ -44,7 +44,7 @@ export function basename(path: string): string {
   return split(path)[1];
 }
 
-export function extname(path: string): string{
+export function extname(path: string): string {
   const _basename = basename(path);
   if (!_basename) return "";
   const components = _basename.split(".");
@@ -65,7 +65,7 @@ export function join(...args: string[]): string {
         return part.trim().replace(/(^[/]*|[/]*$)/g, "");
       }
     })
-    .filter(x => x.length)
+    .filter((x) => x.length)
     .join("/");
 }
 
@@ -82,19 +82,19 @@ function _getAttributes(path: string): {
   return attributesOfItemAtPath.jsValue();
 }
 
-export function getCreationDate(path: string): number{
+export function getCreationDate(path: string): number {
   const { NSFileCreationDate } = _getAttributes(path);
   if (!NSFileCreationDate) return 0;
   return NSFileCreationDate.getTime();
 }
 
-export function getModificationDate(path: string): number{
+export function getModificationDate(path: string): number {
   const { NSFileModificationDate } = _getAttributes(path);
   if (!NSFileModificationDate) return 0;
   return NSFileModificationDate.getTime();
 }
 
-export function getFileSize(path: string): number{
+export function getFileSize(path: string): number {
   const { NSFileSize } = _getAttributes(path);
   return NSFileSize || 0;
 }

package/utils/rect.ts

@@ -1,6 +1,10 @@
 // 用于处理矩形的工具函数
 
-// When called without arguments, return the center of the rectangle. When a Point is passed as an argument, the rectangle’s x and y values are adjusted, so that the new center of the rectangle is p.
+/**
+ * When called without arguments, return the center of the rectangle.
+ * When a Point is passed as an argument, the rectangle’s x and y values
+ * are adjusted, so that the new center of the rectangle is p.
+ */
 export function center(rect: JBRect, point?: JBPoint): JBPoint {
   const { x = 0, y = 0, width: w, height: h } = rect;
   if (!point) return $point(x + w / 2, y + h / 2);
@@ -10,28 +14,40 @@ export function center(rect: JBRect, point?: JBPoint): JBPoint {
   return point;
 }
 
-// Return true if the given point lies within the bounds of the rectangle, false otherwise.
+/**
+ * Return true if the given point lies within the bounds of the rectangle,
+ * false otherwise.
+ */
 export function containsPoint(rect: JBRect, point: JBPoint): boolean {
   const { x, y, width: w, height: h } = rect;
   const { x: px, y: py } = point;
   return x <= px && px <= x + w && y <= py && py <= y + h;
 }
 
-// Return true if the given rectangle lies entirely within the bounds of this rectangle, false otherwise.
+/**
+ * Return true if the given rectangle lies entirely within the bounds of
+ * this rectangle, false otherwise.
+ */
 export function containsRect(rect: JBRect, otherRect: JBRect): boolean {
   const { x, y, width: w, height: h } = rect;
   const { x: x1, y: y1, width: w1, height: h1 } = otherRect;
   return x <= x1 && y <= y1 && x1 + w1 <= x + w && y1 + h1 <= y + h;
 }
 
-// Return true if this rectangle intersects with the other rectangle, false otherwise.
+/**
+ * Return true if this rectangle intersects with the other rectangle,
+ * false otherwise.
+ */
 export function intersects(rect: JBRect, otherRect: JBRect): boolean {
   const { x, y, width: w, height: h } = rect;
   const { x: x1, y: y1, width: w1, height: h1 } = otherRect;
   return x < x1 + w1 && x1 < x + w && y < y1 + h1 && y1 < y + h;
 }
 
-// Return a $rect that corresponds to the intersection of this rectangle with the other one.
+/**
+ * Return a $rect that corresponds to the intersection of this rectangle with
+ * the other one.
+ */
 export function intersection(rect: JBRect, otherRect: JBRect): JBRect {
   const { x, y, width: w, height: h } = rect;
   const { x: x1, y: y1, width: w1, height: h1 } = otherRect;
@@ -42,7 +58,9 @@ export function intersection(rect: JBRect, otherRect: JBRect): JBRect {
   return $rect(nx, ny, nw, nh);
 }
 
-// Return the smallest $rect that encloses both rectangles.
+/**
+ * Return the smallest $rect that encloses both rectangles.
+ */
 export function union(rect: JBRect, otherRect: JBRect): JBRect {
   const { x, y, width: w, height: h } = rect;
   const { x: x1, y: y1, width: w1, height: h1 } = otherRect;
@@ -52,14 +70,19 @@ export function union(rect: JBRect, otherRect: JBRect): JBRect {
   const nh = Math.max(y + h, y1 + h1) - ny;
   return $rect(nx, ny, nw, nh);
 }
-// Equivalent to $rect(r.x + x, r.y + y, r.w, r.h)
+
+/**
+ * Equivalent to $rect(r.x + x, r.y + y, r.w, r.h)
+ */
 export function translate(rect: JBRect, point: JBPoint): JBRect {
   const { x, y, width, height } = rect;
   const { x: x1, y: y1 } = point;
   return $rect(x + x1, y + y1, width, height);
 }
 
-// Return a $rect that is adjusted by the given edge insets.
+/**
+ * Return a $rect that is adjusted by the given edge insets.
+ */
 export function inset(rect: JBRect, insets: JBInsets): JBRect {
   const { x, y, width, height } = rect;
   const { top, left, bottom, right } = insets;

package/utils/uitools.ts

@@ -1,15 +1,19 @@
 // 用于UI相关的工具函数
 
-// 立即获得window size
+/**
+ * 立即获得window size
+ */
 export function getWindowSize(): JBSize {
   const window = $objc("UIWindow").$keyWindow().jsValue();
   return window.size;
 }
 
-// 获取单行字符串应有的宽度
-// 默认额外添加3 inset
+/**
+ * 获取单行字符串应有的宽度
+ * 默认额外添加3 inset
+ */
 export function getTextWidth(
-  text: string, 
+  text: string,
   { font = $font(17), inset = 3 } = {}
 ): number {
   return (
@@ -18,17 +22,19 @@ export function getTextWidth(
         text,
         width: 10000,
         font,
-        lineSpacing: 0
+        lineSpacing: 0,
       }).width
     ) + inset
   );
 }
 
-// 获取字符串指定宽度后应有的高度
-// 默认额外添加3 inset
+/**
+ * 获取字符串指定宽度后应有的高度
+ * 默认额外添加3 inset
+ */
 export function getTextHeight(
   text: string,
-  { width = 300, font = $font(17), inset = 3 } = {}
+  { width = 300, font = $font(17), inset = 3, lineSpacing = 0 } = {}
 ): number {
   return (
     Math.ceil(
@@ -36,14 +42,16 @@ export function getTextHeight(
         text,
         width,
         font,
-        lineSpacing: 0
+        lineSpacing,
       }).height
     ) + inset
   );
 }
 
-// 计算某个view在某个上级view（若不指定则为UIWindow）上的绝对frame
-// 此方法不考虑旋转变形等特殊情况
+/**
+ * 计算某个view在某个上级view（若不指定则为UIWindow）上的绝对frame
+ * 此方法不考虑旋转变形等特殊情况
+ */
 export function absoluteFrame(view: AllUIView, endView?: AllUIView): JBRect {
   const frame = view.frame;
   let superView = view.super;
@@ -62,40 +70,42 @@ export const layerCommonOptions = {
     shadowRadius: 0,
     shadowOpacity: 0,
     shadowOffset: $size(0, 0),
-    shadowColor: $color("clear")
+    shadowColor: $color("clear"),
   },
   roundedShadow: {
     cornerRadius: 12,
     shadowRadius: 10,
     shadowOpacity: 1,
     shadowOffset: $size(0, 0),
-    shadowColor: $color("black")
+    shadowColor: $color("black"),
   },
   textShadow: {
     cornerRadius: 0,
     shadowRadius: 1.2,
     shadowOpacity: 1,
     shadowOffset: $size(0, 1),
-    shadowColor: $color("black")
+    shadowColor: $color("black"),
   },
   circleViewShadow: {
     cornerRadius: 25,
     shadowRadius: 3,
     shadowOpacity: 0.6,
     shadowOffset: $size(0, 3),
-    shadowColor: $color("black")
+    shadowColor: $color("black"),
   },
   toastShadows: {
     cornerRadius: 15,
     shadowRadius: 8,
     shadowOpacity: 0.35,
     shadowOffset: $size(0, 0),
-    shadowColor: $color("black")
-  }
+    shadowColor: $color("black"),
+  },
 };
 
-// 在layout中使用
-// 所应用的view不可以指定radius和clipTobounds，否则无效
+/**
+ * 在layout中使用
+ * 所应用的view不可以指定radius和clipTobounds，否则无效
+ */
 export function setLayer(
   view: AllUIView,
   {
@@ -103,7 +113,7 @@ export function setLayer(
     shadowRadius = 0,
     shadowOpacity = 0,
     shadowOffset = $size(0, 0),
-    shadowColor = $color("clear")
+    shadowColor = $color("clear"),
   } = {}
 ): void {
   const layer = view.ocValue().invoke("layer");
@@ -113,5 +123,3 @@ export function setLayer(
   layer.invoke("setShadowOffset", shadowOffset);
   layer.invoke("setShadowColor", shadowColor.ocValue().invoke("CGColor"));
 }
-
-