style(JSONEditor): add AGPL-3.0 license header, clean imports & refine Banner UI

* Added full GNU Affero General Public License v3 header at the top of `JSONEditor.js`.
* Removed unused `IconCode` and `IconRefresh` imports to eliminate dead code.
* Set `closeIcon={null}` and applied `!rounded-md` class for `Banner`, improving visual consistency and preventing unintended dismissal.
* Normalized whitespace and line-breaks for better readability and lint compliance.
This commit is contained in:
t0ng7u
2025-08-09 14:08:28 +08:00
parent ae22ba593a
commit a5cbef1a61

View File

@@ -1,3 +1,22 @@
/*
Copyright (C) 2025 QuantumNous
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
For commercial licensing, please contact support@quantumnous.com
*/
import React, { useState, useEffect, useCallback, useMemo } from 'react'; import React, { useState, useEffect, useCallback, useMemo } from 'react';
import { useTranslation } from 'react-i18next'; import { useTranslation } from 'react-i18next';
import { import {
@@ -18,15 +37,19 @@ import {
Tooltip, Tooltip,
} from '@douyinfe/semi-ui'; } from '@douyinfe/semi-ui';
import { import {
IconCode,
IconPlus, IconPlus,
IconDelete, IconDelete,
IconRefresh,
IconAlertTriangle, IconAlertTriangle,
} from '@douyinfe/semi-icons'; } from '@douyinfe/semi-icons';
const { Text } = Typography; const { Text } = Typography;
// 唯一 ID 生成器,确保在组件生命周期内稳定且递增
const generateUniqueId = (() => {
let counter = 0;
return () => `kv_${counter++}`;
})();
const JSONEditor = ({ const JSONEditor = ({
value = '', value = '',
onChange, onChange,
@@ -46,13 +69,20 @@ const JSONEditor = ({
const { t } = useTranslation(); const { t } = useTranslation();
// 将对象转换为键值对数组包含唯一ID // 将对象转换为键值对数组包含唯一ID
const objectToKeyValueArray = useCallback((obj) => { const objectToKeyValueArray = useCallback((obj, prevPairs = []) => {
if (!obj || typeof obj !== 'object') return []; if (!obj || typeof obj !== 'object') return [];
return Object.entries(obj).map(([key, value], index) => ({
id: `${Date.now()}_${index}_${Math.random()}`, // 唯一ID const entries = Object.entries(obj);
key, return entries.map(([key, value], index) => {
value // 如果上一次转换后同位置的键一致,则沿用其 id保持 React key 稳定
})); const prev = prevPairs[index];
const shouldReuseId = prev && prev.key === key;
return {
id: shouldReuseId ? prev.id : generateUniqueId(),
key,
value,
};
});
}, []); }, []);
// 将键值对数组转换为对象(重复键时后面的会覆盖前面的) // 将键值对数组转换为对象(重复键时后面的会覆盖前面的)
@@ -102,14 +132,14 @@ const JSONEditor = ({
} }
return 'visual'; return 'visual';
}); });
const [jsonError, setJsonError] = useState(''); const [jsonError, setJsonError] = useState('');
// 计算重复的键 // 计算重复的键
const duplicateKeys = useMemo(() => { const duplicateKeys = useMemo(() => {
const keyCount = {}; const keyCount = {};
const duplicates = new Set(); const duplicates = new Set();
keyValuePairs.forEach(pair => { keyValuePairs.forEach(pair => {
if (pair.key) { if (pair.key) {
keyCount[pair.key] = (keyCount[pair.key] || 0) + 1; keyCount[pair.key] = (keyCount[pair.key] || 0) + 1;
@@ -118,7 +148,7 @@ const JSONEditor = ({
} }
} }
}); });
return duplicates; return duplicates;
}, [keyValuePairs]); }, [keyValuePairs]);
@@ -131,11 +161,11 @@ const JSONEditor = ({
} else if (typeof value === 'object' && value !== null) { } else if (typeof value === 'object' && value !== null) {
parsed = value; parsed = value;
} }
// 只在外部值真正改变时更新,避免循环更新 // 只在外部值真正改变时更新,避免循环更新
const currentObj = keyValueArrayToObject(keyValuePairs); const currentObj = keyValueArrayToObject(keyValuePairs);
if (JSON.stringify(parsed) !== JSON.stringify(currentObj)) { if (JSON.stringify(parsed) !== JSON.stringify(currentObj)) {
setKeyValuePairs(objectToKeyValueArray(parsed)); setKeyValuePairs(objectToKeyValueArray(parsed, keyValuePairs));
} }
setJsonError(''); setJsonError('');
} catch (error) { } catch (error) {
@@ -158,7 +188,7 @@ const JSONEditor = ({
setKeyValuePairs(newPairs); setKeyValuePairs(newPairs);
const jsonObject = keyValueArrayToObject(newPairs); const jsonObject = keyValueArrayToObject(newPairs);
const jsonString = Object.keys(jsonObject).length === 0 ? '' : JSON.stringify(jsonObject, null, 2); const jsonString = Object.keys(jsonObject).length === 0 ? '' : JSON.stringify(jsonObject, null, 2);
setJsonError(''); setJsonError('');
// 通过formApi设置值 // 通过formApi设置值
@@ -175,7 +205,7 @@ const JSONEditor = ({
if (newValue && newValue.trim()) { if (newValue && newValue.trim()) {
try { try {
const parsed = JSON.parse(newValue); const parsed = JSON.parse(newValue);
setKeyValuePairs(objectToKeyValueArray(parsed)); setKeyValuePairs(objectToKeyValueArray(parsed, keyValuePairs));
setJsonError(''); setJsonError('');
onChange?.(newValue); onChange?.(newValue);
} catch (error) { } catch (error) {
@@ -186,7 +216,7 @@ const JSONEditor = ({
setJsonError(''); setJsonError('');
onChange?.(''); onChange?.('');
} }
}, [onChange, objectToKeyValueArray]); }, [onChange, objectToKeyValueArray, keyValuePairs]);
// 切换编辑模式 // 切换编辑模式
const toggleEditMode = useCallback(() => { const toggleEditMode = useCallback(() => {
@@ -204,7 +234,7 @@ const JSONEditor = ({
} else if (typeof value === 'object' && value !== null) { } else if (typeof value === 'object' && value !== null) {
parsed = value; parsed = value;
} }
setKeyValuePairs(objectToKeyValueArray(parsed)); setKeyValuePairs(objectToKeyValueArray(parsed, keyValuePairs));
setJsonError(''); setJsonError('');
setEditMode('visual'); setEditMode('visual');
} catch (error) { } catch (error) {
@@ -225,7 +255,7 @@ const JSONEditor = ({
newKey = `field_${counter}`; newKey = `field_${counter}`;
} }
newPairs.push({ newPairs.push({
id: `${Date.now()}_${Math.random()}`, id: generateUniqueId(),
key: newKey, key: newKey,
value: '' value: ''
}); });
@@ -240,7 +270,7 @@ const JSONEditor = ({
// 更新键名 // 更新键名
const updateKey = useCallback((id, newKey) => { const updateKey = useCallback((id, newKey) => {
const newPairs = keyValuePairs.map(pair => const newPairs = keyValuePairs.map(pair =>
pair.id === id ? { ...pair, key: newKey } : pair pair.id === id ? { ...pair, key: newKey } : pair
); );
handleVisualChange(newPairs); handleVisualChange(newPairs);
@@ -264,11 +294,11 @@ const JSONEditor = ({
} }
setManualText(templateString); setManualText(templateString);
setKeyValuePairs(objectToKeyValueArray(template)); setKeyValuePairs(objectToKeyValueArray(template, keyValuePairs));
onChange?.(templateString); onChange?.(templateString);
setJsonError(''); setJsonError('');
} }
}, [template, onChange, formApi, field, objectToKeyValueArray]); }, [template, onChange, formApi, field, objectToKeyValueArray, keyValuePairs]);
// 渲染值输入控件(支持嵌套) // 渲染值输入控件(支持嵌套)
const renderValueInput = (pairId, value) => { const renderValueInput = (pairId, value) => {
@@ -327,7 +357,7 @@ const JSONEditor = ({
let convertedValue = newValue; let convertedValue = newValue;
if (newValue === 'true') convertedValue = true; if (newValue === 'true') convertedValue = true;
else if (newValue === 'false') convertedValue = false; else if (newValue === 'false') convertedValue = false;
else if (!isNaN(newValue) && newValue !== '' && newValue !== '0') { else if (!isNaN(newValue) && newValue !== '') {
const num = Number(newValue); const num = Number(newValue);
// 检查是否为整数 // 检查是否为整数
if (Number.isInteger(num)) { if (Number.isInteger(num)) {
@@ -373,9 +403,9 @@ const JSONEditor = ({
{keyValuePairs.map((pair, index) => { {keyValuePairs.map((pair, index) => {
const isDuplicate = duplicateKeys.has(pair.key); const isDuplicate = duplicateKeys.has(pair.key);
const isLastDuplicate = isDuplicate && const isLastDuplicate = isDuplicate &&
keyValuePairs.slice(index + 1).every(p => p.key !== pair.key); keyValuePairs.slice(index + 1).every(p => p.key !== pair.key);
return ( return (
<Row key={pair.id} gutter={8} align="middle"> <Row key={pair.id} gutter={8} align="middle">
<Col span={6}> <Col span={6}>
@@ -389,14 +419,14 @@ const JSONEditor = ({
{isDuplicate && ( {isDuplicate && (
<Tooltip <Tooltip
content={ content={
isLastDuplicate isLastDuplicate
? t('这是重复键中的最后一个,其值将被使用') ? t('这是重复键中的最后一个,其值将被使用')
: t('重复的键名,此值将被后面的同名键覆盖') : t('重复的键名,此值将被后面的同名键覆盖')
} }
> >
<IconAlertTriangle <IconAlertTriangle
className="absolute right-2 top-1/2 transform -translate-y-1/2" className="absolute right-2 top-1/2 transform -translate-y-1/2"
style={{ style={{
color: isLastDuplicate ? '#ff7d00' : '#faad14', color: isLastDuplicate ? '#ff7d00' : '#faad14',
fontSize: '14px' fontSize: '14px'
}} }}
@@ -471,7 +501,7 @@ const JSONEditor = ({
updateValue(defaultPair.id, value); updateValue(defaultPair.id, value);
} else { } else {
const newPairs = [...keyValuePairs, { const newPairs = [...keyValuePairs, {
id: `${Date.now()}_${Math.random()}`, id: generateUniqueId(),
key: 'default', key: 'default',
value: value value: value
}]; }];