@pisell/materials 6.9.4 → 6.9.5

package/es/components/pisellUrl/utils/urlHelper.js

@@ -0,0 +1,141 @@
+/**
+ * URL 辅助函数
+ */
+
+/**
+ * 规范化 URL（补全协议）
+ * @param url URL 地址
+ * @param defaultProtocol 默认协议
+ * @returns 规范化后的 URL
+ * 
+ * @example
+ * normalizeUrl('example.com', 'https://') // 'https://example.com'
+ * normalizeUrl('http://example.com', 'https://') // 'http://example.com'
+ */
+export function normalizeUrl(url) {
+  var defaultProtocol = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'https://';
+  if (!url) return '';
+  var trimmedUrl = url.trim();
+
+  // 已有协议，直接返回
+  if (/^[a-z]+:\/\//i.test(trimmedUrl)) {
+    return trimmedUrl;
+  }
+
+  // 无协议，添加默认协议
+  return defaultProtocol + trimmedUrl;
+}
+
+/**
+ * 智能补全协议（识别 localhost）
+ * @param url URL 地址
+ * @returns 规范化后的 URL
+ * 
+ * @example
+ * smartNormalizeUrl('localhost:3000') // 'http://localhost:3000'
+ * smartNormalizeUrl('example.com') // 'https://example.com'
+ */
+export function smartNormalizeUrl(url) {
+  if (!url) return '';
+  var trimmedUrl = url.trim();
+
+  // 已有协议
+  if (/^[a-z]+:\/\//i.test(trimmedUrl)) {
+    return trimmedUrl;
+  }
+
+  // localhost 或本地 IP 使用 http
+  if (trimmedUrl.startsWith('localhost') || trimmedUrl.startsWith('127.0.0.1') || trimmedUrl.startsWith('192.168.') || trimmedUrl.startsWith('10.0.') || trimmedUrl.startsWith('172.')) {
+    return 'http://' + trimmedUrl;
+  }
+
+  // 其他使用 https
+  return 'https://' + trimmedUrl;
+}
+
+/**
+ * 提取域名
+ * @param url URL 地址
+ * @returns 域名
+ * 
+ * @example
+ * extractDomain('https://www.example.com/path') // 'www.example.com'
+ */
+export function extractDomain(url) {
+  try {
+    var normalizedUrl = url.startsWith('http') ? url : 'https://' + url;
+    var urlObj = new URL(normalizedUrl);
+    return urlObj.hostname;
+  } catch (_unused) {
+    return url;
+  }
+}
+
+/**
+ * 处理链接跳转（安全性保障）
+ * @param url URL 地址
+ * @param openInNewWindow 是否新窗口打开
+ * @param defaultProtocol 默认协议
+ * 
+ * @example
+ * handleUrlClick('example.com', true, 'https://')
+ */
+export function handleUrlClick(url) {
+  var openInNewWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  var defaultProtocol = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'https://';
+  if (!url) return;
+
+  // 规范化 URL（补全协议）
+  var normalizedUrl = normalizeUrl(url, defaultProtocol);
+
+  // 验证 URL
+  try {
+    new URL(normalizedUrl);
+  } catch (_unused2) {
+    console.warn('Invalid URL:', normalizedUrl);
+    return;
+  }
+  if (openInNewWindow) {
+    // 新窗口打开（添加安全性）
+    window.open(normalizedUrl, '_blank', 'noopener,noreferrer');
+  } else {
+    // 当前窗口打开
+    window.location.href = normalizedUrl;
+  }
+}
+
+/**
+ * 检测是否为安全链接（HTTPS）
+ * @param url URL 地址
+ * @returns 是否为 HTTPS
+ * 
+ * @example
+ * isSecureUrl('https://example.com') // true
+ * isSecureUrl('http://example.com') // false
+ */
+export function isSecureUrl(url) {
+  return url.startsWith('https://');
+}
+
+/**
+ * 提取 URL 参数
+ * @param url URL 地址
+ * @returns 参数对象
+ * 
+ * @example
+ * extractUrlParams('https://example.com?foo=bar&baz=qux')
+ * // { foo: 'bar', baz: 'qux' }
+ */
+export function extractUrlParams(url) {
+  try {
+    var normalizedUrl = url.startsWith('http') ? url : 'https://' + url;
+    var urlObj = new URL(normalizedUrl);
+    var params = {};
+    urlObj.searchParams.forEach(function (value, key) {
+      params[key] = value;
+    });
+    return params;
+  } catch (_unused3) {
+    return {};
+  }
+}

package/es/components/pisellUrl/utils/urlValidator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * URL 校验工具函数
+ */
+/**
+ * URL 格式校验（使用 URL 构造函数）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('invalid-url') // false
+ */
+export declare function validateUrl(url: string): boolean;
+/**
+ * URL 正则校验（备选方法）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ */
+export declare function validateUrlByRegex(url: string): boolean;
+/**
+ * 解析 URL 各部分
+ * @param url URL 地址
+ * @returns URL 各部分或 null
+ *
+ * @example
+ * parseUrl('https://example.com:8080/path?key=value#hash')
+ * // { protocol: 'https', host: 'example.com', port: '8080', ... }
+ */
+export declare function parseUrl(url: string): {
+    protocol: string;
+    host: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+} | null;
+/**
+ * 协议白名单校验
+ * @param url URL 地址
+ * @param allowedProtocols 允许的协议列表
+ * @returns 校验结果
+ */
+export declare function validateUrlProtocol(url: string, allowedProtocols: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

package/es/components/pisellUrl/utils/urlValidator.js

@@ -0,0 +1,83 @@
+/**
+ * URL 校验工具函数
+ */
+
+/**
+ * URL 格式校验（使用 URL 构造函数）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ * 
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('invalid-url') // false
+ */
+export function validateUrl(url) {
+  if (!url) return true; // 空值不校验，由 required 处理
+
+  try {
+    new URL(url);
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+/**
+ * URL 正则校验（备选方法）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ */
+export function validateUrlByRegex(url) {
+  if (!url) return true;
+  var STRICT_URL_REGEX = /^(https?:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)$/;
+  return STRICT_URL_REGEX.test(url);
+}
+
+/**
+ * 解析 URL 各部分
+ * @param url URL 地址
+ * @returns URL 各部分或 null
+ * 
+ * @example
+ * parseUrl('https://example.com:8080/path?key=value#hash')
+ * // { protocol: 'https', host: 'example.com', port: '8080', ... }
+ */
+export function parseUrl(url) {
+  try {
+    var urlObj = new URL(url);
+    return {
+      protocol: urlObj.protocol.replace(':', ''),
+      host: urlObj.hostname,
+      port: urlObj.port,
+      pathname: urlObj.pathname,
+      search: urlObj.search,
+      hash: urlObj.hash
+    };
+  } catch (_unused) {
+    return null;
+  }
+}
+
+/**
+ * 协议白名单校验
+ * @param url URL 地址
+ * @param allowedProtocols 允许的协议列表
+ * @returns 校验结果
+ */
+export function validateUrlProtocol(url, allowedProtocols) {
+  var errors = [];
+  var parts = parseUrl(url);
+  if (!parts) {
+    return {
+      isValid: true,
+      errors: errors
+    };
+  }
+  if (parts.protocol && !allowedProtocols.includes(parts.protocol)) {
+    errors.push("\u53EA\u5141\u8BB8\u4EE5\u4E0B\u534F\u8BAE\uFF1A".concat(allowedProtocols.join(', ')));
+  }
+  return {
+    isValid: errors.length === 0,
+    errors: errors
+  };
+}

package/es/components/table/Table/fields/index.d.ts

@@ -197,12 +197,12 @@ export declare const fieldList: ({
     field_icon: string;
     field_name: string;
     field_type: string;
-    default_value: string;
+    default_value: boolean;
 } | {
     field_icon: string;
     field_name: string;
     field_type: string;
-    default_value: boolean;
+    default_value: string;
 } | {
     field_icon: string;
     field_name: string;

package/es/components/table/Table/utils.d.ts

@@ -155,7 +155,7 @@ export declare const getSettingKeyArrByMode: ({ filter, columnSetting, dataSourc
     sort?: SortType | undefined;
     mode: "" | "localStorage" | "remote";
     currentViewMode: ModeType;
-}) => ("order_by" | "group_by" | "filters" | "column_setting" | "view_mode" | "filter_setting" | "gallery_setting")[];
+}) => ("filters" | "column_setting" | "gallery_setting" | "order_by" | "group_by" | "view_mode" | "filter_setting")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};