@base-web-kits/base-tools-ts 1.4.2 → 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.2",
+  "version": "1.4.9",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [

package/src/ts/es-toolkit/index.ts

@@ -1,199 +1,199 @@
-/**
- * re-export 全量 es-toolkit
- * 版本: 1.44.0
- * 文档: https://es-toolkit.dev/
- * 目的: 提供常用工具,收敛依赖版本
- * 导出策略: 必须使用显式命名导出, 不要使用 export *
- * 原因: 为了避免不同构建链路下出现最终入口导出表不完整的问题
- *
- * 注意: 此文件由 scripts/re-export/update-es-toolkit-exports.ts 生成, 请勿手动修改.
- * 如需更新, 请先升级es-toolkit, 然后运行: npm run update:es-toolkit
- */
-export {
-  AbortError,
-  Mutex,
-  Semaphore,
-  TimeoutError,
-  after,
-  ary,
-  assert,
-  asyncNoop,
-  at,
-  attempt,
-  attemptAsync,
-  before,
-  camelCase,
-  capitalize,
-  chunk,
-  clamp,
-  clone,
-  cloneDeep,
-  cloneDeepWith,
-  compact,
-  constantCase,
-  countBy,
-  curry,
-  curryRight,
-  debounce,
-  deburr,
-  delay,
-  difference,
-  differenceBy,
-  differenceWith,
-  drop,
-  dropRight,
-  dropRightWhile,
-  dropWhile,
-  escape,
-  escapeRegExp,
-  fill,
-  filterAsync,
-  findKey,
-  flatMap,
-  flatMapAsync,
-  flatMapDeep,
-  flatten,
-  flattenDeep,
-  flattenObject,
-  flow,
-  flowRight,
-  forEachAsync,
-  forEachRight,
-  groupBy,
-  head,
-  identity,
-  inRange,
-  initial,
-  intersection,
-  intersectionBy,
-  intersectionWith,
-  invariant,
-  invert,
-  isArrayBuffer,
-  isBlob,
-  isBoolean,
-  isBrowser,
-  isBuffer,
-  isDate,
-  isEmptyObject,
-  isEqual,
-  isEqualWith,
-  isError,
-  isFile,
-  isFunction,
-  isJSON,
-  isJSONArray,
-  isJSONObject,
-  isJSONValue,
-  isLength,
-  isMap,
-  isNil,
-  isNode,
-  isNotNil,
-  isNull,
-  isNumber,
-  isPlainObject,
-  isPrimitive,
-  isPromise,
-  isRegExp,
-  isSet,
-  isString,
-  isSubset,
-  isSubsetWith,
-  isSymbol,
-  isTypedArray,
-  isUndefined,
-  isWeakMap,
-  isWeakSet,
-  kebabCase,
-  keyBy,
-  last,
-  limitAsync,
-  lowerCase,
-  lowerFirst,
-  mapAsync,
-  mapKeys,
-  mapValues,
-  maxBy,
-  mean,
-  meanBy,
-  median,
-  medianBy,
-  memoize,
-  merge,
-  mergeWith,
-  minBy,
-  negate,
-  noop,
-  omit,
-  omitBy,
-  once,
-  orderBy,
-  pad,
-  partial,
-  partialRight,
-  partition,
-  pascalCase,
-  pick,
-  pickBy,
-  pull,
-  pullAt,
-  random,
-  randomInt,
-  range,
-  rangeRight,
-  reduceAsync,
-  remove,
-  rest,
-  retry,
-  reverseString,
-  round,
-  sample,
-  sampleSize,
-  shuffle,
-  snakeCase,
-  sortBy,
-  spread,
-  startCase,
-  sum,
-  sumBy,
-  tail,
-  take,
-  takeRight,
-  takeRightWhile,
-  takeWhile,
-  throttle,
-  timeout,
-  toCamelCaseKeys,
-  toFilled,
-  toMerged,
-  toSnakeCaseKeys,
-  trim,
-  trimEnd,
-  trimStart,
-  unary,
-  unescape,
-  union,
-  unionBy,
-  unionWith,
-  uniq,
-  uniqBy,
-  uniqWith,
-  unzip,
-  unzipWith,
-  upperCase,
-  upperFirst,
-  windowed,
-  withTimeout,
-  without,
-  words,
-  xor,
-  xorBy,
-  xorWith,
-  zip,
-  zipObject,
-  zipWith,
-} from 'es-toolkit';
-
-// 导出类型
-export type * from 'es-toolkit';
+/**
+ * re-export 全量 es-toolkit
+ * 版本: 1.44.0
+ * 文档: https://es-toolkit.dev/
+ * 目的: 提供常用工具,收敛依赖版本
+ * 导出策略: 必须使用显式命名导出, 不要使用 export *
+ * 原因: 为了避免不同构建链路下出现最终入口导出表不完整的问题
+ *
+ * 注意: 此文件由 scripts/re-export/update-es-toolkit-exports.ts 生成, 请勿手动修改.
+ * 如需更新, 请先升级es-toolkit, 然后运行: npm run update:es-toolkit
+ */
+export {
+  AbortError,
+  Mutex,
+  Semaphore,
+  TimeoutError,
+  after,
+  ary,
+  assert,
+  asyncNoop,
+  at,
+  attempt,
+  attemptAsync,
+  before,
+  camelCase,
+  capitalize,
+  chunk,
+  clamp,
+  clone,
+  cloneDeep,
+  cloneDeepWith,
+  compact,
+  constantCase,
+  countBy,
+  curry,
+  curryRight,
+  debounce,
+  deburr,
+  delay,
+  difference,
+  differenceBy,
+  differenceWith,
+  drop,
+  dropRight,
+  dropRightWhile,
+  dropWhile,
+  escape,
+  escapeRegExp,
+  fill,
+  filterAsync,
+  findKey,
+  flatMap,
+  flatMapAsync,
+  flatMapDeep,
+  flatten,
+  flattenDeep,
+  flattenObject,
+  flow,
+  flowRight,
+  forEachAsync,
+  forEachRight,
+  groupBy,
+  head,
+  identity,
+  inRange,
+  initial,
+  intersection,
+  intersectionBy,
+  intersectionWith,
+  invariant,
+  invert,
+  isArrayBuffer,
+  isBlob,
+  isBoolean,
+  isBrowser,
+  isBuffer,
+  isDate,
+  isEmptyObject,
+  isEqual,
+  isEqualWith,
+  isError,
+  isFile,
+  isFunction,
+  isJSON,
+  isJSONArray,
+  isJSONObject,
+  isJSONValue,
+  isLength,
+  isMap,
+  isNil,
+  isNode,
+  isNotNil,
+  isNull,
+  isNumber,
+  isPlainObject,
+  isPrimitive,
+  isPromise,
+  isRegExp,
+  isSet,
+  isString,
+  isSubset,
+  isSubsetWith,
+  isSymbol,
+  isTypedArray,
+  isUndefined,
+  isWeakMap,
+  isWeakSet,
+  kebabCase,
+  keyBy,
+  last,
+  limitAsync,
+  lowerCase,
+  lowerFirst,
+  mapAsync,
+  mapKeys,
+  mapValues,
+  maxBy,
+  mean,
+  meanBy,
+  median,
+  medianBy,
+  memoize,
+  merge,
+  mergeWith,
+  minBy,
+  negate,
+  noop,
+  omit,
+  omitBy,
+  once,
+  orderBy,
+  pad,
+  partial,
+  partialRight,
+  partition,
+  pascalCase,
+  pick,
+  pickBy,
+  pull,
+  pullAt,
+  random,
+  randomInt,
+  range,
+  rangeRight,
+  reduceAsync,
+  remove,
+  rest,
+  retry,
+  reverseString,
+  round,
+  sample,
+  sampleSize,
+  shuffle,
+  snakeCase,
+  sortBy,
+  spread,
+  startCase,
+  sum,
+  sumBy,
+  tail,
+  take,
+  takeRight,
+  takeRightWhile,
+  takeWhile,
+  throttle,
+  timeout,
+  toCamelCaseKeys,
+  toFilled,
+  toMerged,
+  toSnakeCaseKeys,
+  trim,
+  trimEnd,
+  trimStart,
+  unary,
+  unescape,
+  union,
+  unionBy,
+  unionWith,
+  uniq,
+  uniqBy,
+  uniqWith,
+  unzip,
+  unzipWith,
+  upperCase,
+  upperFirst,
+  windowed,
+  withTimeout,
+  without,
+  words,
+  xor,
+  xorBy,
+  xorWith,
+  zip,
+  zipObject,
+  zipWith,
+} from 'es-toolkit';
+
+// 导出类型
+export type * from 'es-toolkit';

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('/')}`;
+}