@base-web-kits/base-tools-ts 1.4.8 → 1.4.9

package/dist/url/index.d.ts

@@ -1,5 +1,6 @@
 export * from './file';
 export * from './oss';
 export * from './param';
+export * from './path';
 export * from './qn';
 //# sourceMappingURL=index.d.ts.map

package/dist/url/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/url/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts/url/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC"}

package/dist/url/path/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 拼接 URL 路径，并清理各部分交界处多余的斜杠。
+ *
+ * 空字符串、`null` 和 `undefined` 会被忽略；协议中的 `://` 以及第一个有效参数
+ * 开头的 `/` 会被保留。该函数仅用于拼接路径，不负责解析查询参数或哈希片段。
+ *
+ * @param parts URL 或路径片段
+ * @returns 拼接后的 URL 路径；没有有效片段时返回空字符串
+ * @example
+ * joinUrlPath('https://a.com/', '/images/', '/avatar.png');
+ * // 'https://a.com/images/avatar.png'
+ *
+ * joinUrlPath('', '/images/', null, 'avatar.png');
+ * // '/images/avatar.png'
+ */
+export declare function joinUrlPath(...parts: Array<string | null | undefined>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/url/path/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ts/url/path/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,UAarE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-ts",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [

package/src/ts/url/index.ts

@@ -1,4 +1,5 @@
 export * from './file';
-export * from './oss';
-export * from './param';
-export * from './qn';
+export * from './oss';
+export * from './param';
+export * from './path';
+export * from './qn';

package/src/ts/url/path/index.ts

@@ -0,0 +1,29 @@
+/**
+ * 拼接 URL 路径，并清理各部分交界处多余的斜杠。
+ *
+ * 空字符串、`null` 和 `undefined` 会被忽略；协议中的 `://` 以及第一个有效参数
+ * 开头的 `/` 会被保留。该函数仅用于拼接路径，不负责解析查询参数或哈希片段。
+ *
+ * @param parts URL 或路径片段
+ * @returns 拼接后的 URL 路径；没有有效片段时返回空字符串
+ * @example
+ * joinUrlPath('https://a.com/', '/images/', '/avatar.png');
+ * // 'https://a.com/images/avatar.png'
+ *
+ * joinUrlPath('', '/images/', null, 'avatar.png');
+ * // '/images/avatar.png'
+ */
+export function joinUrlPath(...parts: Array<string | null | undefined>) {
+  const values = parts.filter((part): part is string => !!part);
+  if (!values.length) return '';
+
+  const [first, ...rest] = values;
+  const normalizedFirst = first.replace(/\/+$/, '');
+  const normalizedRest = rest.map((part) => part.replace(/^\/+|\/+$/g, '')).filter(Boolean);
+
+  if (!normalizedRest.length) {
+    return normalizedFirst || (first.startsWith('/') ? '/' : '');
+  }
+
+  return `${normalizedFirst}/${normalizedRest.join('/')}`;
+}