@deot/helper-route 1.0.1

package/README.md

@@ -0,0 +1,92 @@
+# @deot/helper-route
+
+### `Route` 
+
+```js
+import * as Route from "@deot/helper-route";
+
+// or
+import { Route } from "@deot/helper";
+```
+
+---
+
+#### `merge`
+
+`Route.merge(route: object, options: object)`
+
+基于规则构建新的url
+
++ **route**: 路由规则
++ **options**: 可配置参数
+
+*rule:* 规则:
++ **path**: *string, string[]* 路径
++ **query**: *object* 参数
+
+**示例**
+```js
+Route.merge({
+	// path: '/home',
+	path: ['/', 'home'],
+	query: { name: 'wya-team' }
+});
+```
+
+---
+
+#### `parse`
+
+`Route.parse(url: string, options: object)`
+
+解析当前路由 -> `{ query: {}, path: [] }`
+
++ **url**: 路径，默认值：当前路由
++ **options**: 可配置参数
+
+**示例**
+```js
+Route.parse();
+```
+
+---
+
+#### `get`
+
+`Route.get(key: string, url: string, options: object)`
+
+设置版本号
+
++ **key**: 参数键值
++ **url**: 路径，默认值：当前路由
++ **options**: 可配置参数
+
+**示例**
+```javascript
+Route.get('name');
+```
+
+### 约定
+
+```
+let url = `?a=${encodeURIComponent('&')}`; // '?a=%26'
+
+decodeURIComponent(url); // a=&
+
+encodeURIComponent(url); // '%3Fa%3D%2526'
+```
+
+- 期望： `{ a: '&' }`
+- 实际： `{ a: '' }`
+
+为了避免该情况，内部对`url`不直接`decodeURIComponent`, 仅当对值进行`decodeURIComponent`. 所以`%3Fa%3D%2526`是无效的; 
+
+`merge`调用时，`value`的值会被`decodeURIComponent`
+
+```js
+get('a', '?a=%26'); // &
+
+merge({ query: { a: '&' } }); // ?a=%26
+
+parse('?a=%26'); // query.a === '&' (true)
+```

package/dist/index.cjs.js

@@ -0,0 +1,72 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const helperUtils = require('@deot/helper-utils');
+
+const get = (key, url, options) => {
+  const options$ = {
+    parse: helperUtils.flattenJSONParse,
+    ...typeof url === "object" ? url : { url },
+    ...options
+  };
+  const url$ = options$.url || (typeof window === "undefined" ? "" : window.location.search);
+  const match = url$.substring(url$.indexOf("?") + 1).match(new RegExp("(^|&)" + key + "=([^&]*)"));
+  let value = match != null ? match[2] : null;
+  if (value === null)
+    return null;
+  value = helperUtils.flattenDecodeURIComponent(value);
+  return typeof options$.parse === "function" ? options$.parse(value) : value;
+};
+
+const merge = (route) => {
+  const {
+    origin = "",
+    path = "",
+    query
+  } = route;
+  let result = origin;
+  result += path instanceof Array ? path.length ? `/${path.join("/")}` : "" : path;
+  let queryArr = [];
+  for (let key in query) {
+    if (query[key] || query[key] === false || query[key] === 0) {
+      let v = helperUtils.flattenDecodeURIComponent(query[key]);
+      queryArr = [
+        ...queryArr,
+        `${key}=${encodeURIComponent(v)}`
+      ];
+    }
+  }
+  if (queryArr.length > 0) {
+    result += (result.indexOf("?") > -1 ? "&" : "?") + queryArr.join("&");
+  }
+  return result;
+};
+
+const parse = (url, options) => {
+  const options$ = {
+    parse: helperUtils.flattenJSONParse,
+    ...typeof url === "object" ? url : { url },
+    ...options
+  };
+  const url$ = options$.url || (typeof window === "undefined" ? "" : `${window.location.pathname}${window.location.search}`);
+  const [prefix, search] = url$.split("?");
+  const query = {};
+  if (search) {
+    Array.from(search.match(/[^?=&]+=[^&]*/g) || []).forEach((v) => {
+      let [key, value] = v.split("=");
+      value = helperUtils.flattenDecodeURIComponent(value);
+      query[key] = typeof options$.parse === "function" ? options$.parse(value) : value;
+    });
+  }
+  const sIndex = prefix.indexOf("/");
+  return {
+    origin: (sIndex !== -1 ? prefix.slice(0, sIndex) : prefix) || "",
+    path: prefix.slice(sIndex),
+    query
+  };
+};
+
+exports.get = get;
+exports.merge = merge;
+exports.parse = parse;

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export declare const get: (key: string, url?: string | GetOptions, options?: GetOptions) => any;
+
+declare interface GetOptions {
+    url?: string;
+    parse?: boolean | ((v: string) => any);
+}
+
+export declare const merge: (route: Route) => string;
+
+export declare const parse: (url?: string | ParseOptions, options?: ParseOptions) => {
+    origin: string;
+    path: string;
+    query: {
+        [key: string]: any;
+    };
+};
+
+declare interface ParseOptions {
+    url?: string;
+    parse?: boolean | ((v: string) => any);
+}
+
+declare interface Route {
+    origin?: string;
+    path?: string | string[];
+    query?: {
+        [key: string]: any;
+    };
+}
+
+export { }

package/dist/index.es.js

@@ -0,0 +1,66 @@
+import { flattenJSONParse, flattenDecodeURIComponent } from '@deot/helper-utils';
+
+const get = (key, url, options) => {
+  const options$ = {
+    parse: flattenJSONParse,
+    ...typeof url === "object" ? url : { url },
+    ...options
+  };
+  const url$ = options$.url || (typeof window === "undefined" ? "" : window.location.search);
+  const match = url$.substring(url$.indexOf("?") + 1).match(new RegExp("(^|&)" + key + "=([^&]*)"));
+  let value = match != null ? match[2] : null;
+  if (value === null)
+    return null;
+  value = flattenDecodeURIComponent(value);
+  return typeof options$.parse === "function" ? options$.parse(value) : value;
+};
+
+const merge = (route) => {
+  const {
+    origin = "",
+    path = "",
+    query
+  } = route;
+  let result = origin;
+  result += path instanceof Array ? path.length ? `/${path.join("/")}` : "" : path;
+  let queryArr = [];
+  for (let key in query) {
+    if (query[key] || query[key] === false || query[key] === 0) {
+      let v = flattenDecodeURIComponent(query[key]);
+      queryArr = [
+        ...queryArr,
+        `${key}=${encodeURIComponent(v)}`
+      ];
+    }
+  }
+  if (queryArr.length > 0) {
+    result += (result.indexOf("?") > -1 ? "&" : "?") + queryArr.join("&");
+  }
+  return result;
+};
+
+const parse = (url, options) => {
+  const options$ = {
+    parse: flattenJSONParse,
+    ...typeof url === "object" ? url : { url },
+    ...options
+  };
+  const url$ = options$.url || (typeof window === "undefined" ? "" : `${window.location.pathname}${window.location.search}`);
+  const [prefix, search] = url$.split("?");
+  const query = {};
+  if (search) {
+    Array.from(search.match(/[^?=&]+=[^&]*/g) || []).forEach((v) => {
+      let [key, value] = v.split("=");
+      value = flattenDecodeURIComponent(value);
+      query[key] = typeof options$.parse === "function" ? options$.parse(value) : value;
+    });
+  }
+  const sIndex = prefix.indexOf("/");
+  return {
+    origin: (sIndex !== -1 ? prefix.slice(0, sIndex) : prefix) || "",
+    path: prefix.slice(sIndex),
+    query
+  };
+};
+
+export { get, merge, parse };

package/dist/index.iife.js

@@ -0,0 +1,125 @@
+var HelperRoute = (function (exports) {
+  'use strict';
+
+  const flattenDecodeURIComponent = (value) => {
+    let need = true;
+    let safeCount = 1;
+    let parseValue = value;
+    while (need) {
+      if (safeCount > 1e3) {
+        throw new Error(value);
+      }
+      try {
+        let next = decodeURIComponent(parseValue);
+        if (parseValue === next) {
+          need = false;
+        }
+        parseValue = next;
+      } catch {
+        need = false;
+      }
+      safeCount++;
+    }
+    return parseValue;
+  };
+
+  const flattenJSONParse = (value) => {
+    if (value === null)
+      return null;
+    let regex = /^\d+$/;
+    if (regex.test(value) && value.length >= 16 && +value > Number.MAX_SAFE_INTEGER) {
+      return value;
+    }
+    let need = true;
+    let safeCount = 1;
+    let parseValue = value;
+    while (need) {
+      if (safeCount > 10) {
+        throw new Error(value);
+      }
+      try {
+        let next = JSON.parse(parseValue);
+        if (parseValue === next) {
+          need = false;
+        }
+        parseValue = next;
+      } catch {
+        need = false;
+      }
+      safeCount++;
+    }
+    return parseValue;
+  };
+
+  const get = (key, url, options) => {
+    const options$ = {
+      parse: flattenJSONParse,
+      ...typeof url === "object" ? url : { url },
+      ...options
+    };
+    const url$ = options$.url || (typeof window === "undefined" ? "" : window.location.search);
+    const match = url$.substring(url$.indexOf("?") + 1).match(new RegExp("(^|&)" + key + "=([^&]*)"));
+    let value = match != null ? match[2] : null;
+    if (value === null)
+      return null;
+    value = flattenDecodeURIComponent(value);
+    return typeof options$.parse === "function" ? options$.parse(value) : value;
+  };
+
+  const merge = (route) => {
+    const {
+      origin = "",
+      path = "",
+      query
+    } = route;
+    let result = origin;
+    result += path instanceof Array ? path.length ? `/${path.join("/")}` : "" : path;
+    let queryArr = [];
+    for (let key in query) {
+      if (query[key] || query[key] === false || query[key] === 0) {
+        let v = flattenDecodeURIComponent(query[key]);
+        queryArr = [
+          ...queryArr,
+          `${key}=${encodeURIComponent(v)}`
+        ];
+      }
+    }
+    if (queryArr.length > 0) {
+      result += (result.indexOf("?") > -1 ? "&" : "?") + queryArr.join("&");
+    }
+    return result;
+  };
+
+  const parse = (url, options) => {
+    const options$ = {
+      parse: flattenJSONParse,
+      ...typeof url === "object" ? url : { url },
+      ...options
+    };
+    const url$ = options$.url || (typeof window === "undefined" ? "" : `${window.location.pathname}${window.location.search}`);
+    const [prefix, search] = url$.split("?");
+    const query = {};
+    if (search) {
+      Array.from(search.match(/[^?=&]+=[^&]*/g) || []).forEach((v) => {
+        let [key, value] = v.split("=");
+        value = flattenDecodeURIComponent(value);
+        query[key] = typeof options$.parse === "function" ? options$.parse(value) : value;
+      });
+    }
+    const sIndex = prefix.indexOf("/");
+    return {
+      origin: (sIndex !== -1 ? prefix.slice(0, sIndex) : prefix) || "",
+      path: prefix.slice(sIndex),
+      query
+    };
+  };
+
+  exports.get = get;
+  exports.merge = merge;
+  exports.parse = parse;
+
+  Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+  return exports;
+
+})({});

package/dist/index.umd.js

@@ -0,0 +1,126 @@
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define(['exports'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.HelperRoute = {}));
+})(this, (function (exports) { 'use strict';
+
+  const flattenDecodeURIComponent = (value) => {
+    let need = true;
+    let safeCount = 1;
+    let parseValue = value;
+    while (need) {
+      if (safeCount > 1e3) {
+        throw new Error(value);
+      }
+      try {
+        let next = decodeURIComponent(parseValue);
+        if (parseValue === next) {
+          need = false;
+        }
+        parseValue = next;
+      } catch {
+        need = false;
+      }
+      safeCount++;
+    }
+    return parseValue;
+  };
+
+  const flattenJSONParse = (value) => {
+    if (value === null)
+      return null;
+    let regex = /^\d+$/;
+    if (regex.test(value) && value.length >= 16 && +value > Number.MAX_SAFE_INTEGER) {
+      return value;
+    }
+    let need = true;
+    let safeCount = 1;
+    let parseValue = value;
+    while (need) {
+      if (safeCount > 10) {
+        throw new Error(value);
+      }
+      try {
+        let next = JSON.parse(parseValue);
+        if (parseValue === next) {
+          need = false;
+        }
+        parseValue = next;
+      } catch {
+        need = false;
+      }
+      safeCount++;
+    }
+    return parseValue;
+  };
+
+  const get = (key, url, options) => {
+    const options$ = {
+      parse: flattenJSONParse,
+      ...typeof url === "object" ? url : { url },
+      ...options
+    };
+    const url$ = options$.url || (typeof window === "undefined" ? "" : window.location.search);
+    const match = url$.substring(url$.indexOf("?") + 1).match(new RegExp("(^|&)" + key + "=([^&]*)"));
+    let value = match != null ? match[2] : null;
+    if (value === null)
+      return null;
+    value = flattenDecodeURIComponent(value);
+    return typeof options$.parse === "function" ? options$.parse(value) : value;
+  };
+
+  const merge = (route) => {
+    const {
+      origin = "",
+      path = "",
+      query
+    } = route;
+    let result = origin;
+    result += path instanceof Array ? path.length ? `/${path.join("/")}` : "" : path;
+    let queryArr = [];
+    for (let key in query) {
+      if (query[key] || query[key] === false || query[key] === 0) {
+        let v = flattenDecodeURIComponent(query[key]);
+        queryArr = [
+          ...queryArr,
+          `${key}=${encodeURIComponent(v)}`
+        ];
+      }
+    }
+    if (queryArr.length > 0) {
+      result += (result.indexOf("?") > -1 ? "&" : "?") + queryArr.join("&");
+    }
+    return result;
+  };
+
+  const parse = (url, options) => {
+    const options$ = {
+      parse: flattenJSONParse,
+      ...typeof url === "object" ? url : { url },
+      ...options
+    };
+    const url$ = options$.url || (typeof window === "undefined" ? "" : `${window.location.pathname}${window.location.search}`);
+    const [prefix, search] = url$.split("?");
+    const query = {};
+    if (search) {
+      Array.from(search.match(/[^?=&]+=[^&]*/g) || []).forEach((v) => {
+        let [key, value] = v.split("=");
+        value = flattenDecodeURIComponent(value);
+        query[key] = typeof options$.parse === "function" ? options$.parse(value) : value;
+      });
+    }
+    const sIndex = prefix.indexOf("/");
+    return {
+      origin: (sIndex !== -1 ? prefix.slice(0, sIndex) : prefix) || "",
+      path: prefix.slice(sIndex),
+      query
+    };
+  };
+
+  exports.get = get;
+  exports.merge = merge;
+  exports.parse = parse;
+
+  Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+}));

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@deot/helper-route",
+  "version": "1.0.1",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deot/helper-utils": "^1.0.1"
+  }
+}