/**
|
* AI 组件草稿 → 画布数据（语义层的逆运算）
|
* <p>
|
* 与 use-designer 的 collectSchema 构成往返：collectSchema 从画布收集 {type, props}，
|
* 本模块把 {type, props} 装回画布。两者必须逐项对齐，否则「AI 生成 → 保存 → 再打开」
|
* 会掉组件或错位属性。
|
* <p>
|
* 刻意放在 core/ 而不是设计器里：它不需要 editor 实例，是纯函数，可单测，
|
* 也避免 components/ 反向依赖 #/api。
|
*/
|
import type { QualityComponentDefinition, QualityProps } from './types';
|
|
import { buildQualityContent } from './factory';
|
import { getQualityComponent } from './registry';
|
import { validateQualityProps } from './validator';
|
|
/**
|
* AI 草稿里的一个组件。
|
* <p>
|
* 结构完全扁平：没有 children。props 的 key 由前端积木清单定义，
|
* 所以这里是宽松的 Record 而不是强类型——合法 key 的权威在注册表。
|
*/
|
export interface QualityDraftComponent {
|
type?: string;
|
props?: Record<string, unknown>;
|
}
|
|
/** 被跳过的草稿组件 */
|
export interface QualityAssemblySkip {
|
type: string;
|
/** 展示名；未注册的 type 没有展示名，回退为 type 本身 */
|
label: string;
|
reason: string;
|
}
|
|
export interface QualityAssemblyResult {
|
/** 可直接交给 loadProjectData 的 GrapesJS 项目数据 */
|
grapes: Record<string, unknown>;
|
/** 识别到了但装不进画布的组件 */
|
skipped: QualityAssemblySkip[];
|
/** 装进去了、但属性不完整或不合法的组件，提示用 */
|
problems: string[];
|
}
|
|
/**
|
* 把草稿组件装配成画布数据。
|
* <p>
|
* 单个组件坏掉不影响其余：未知类型进 skipped，属性有问题的进 problems，
|
* 都不会让整批失败——AI 的产物本来就不可信，全有或全无只会让用户白等一次识别。
|
*/
|
export function assembleQualityCanvas(
|
components?: QualityDraftComponent[],
|
): QualityAssemblyResult {
|
const skipped: QualityAssemblySkip[] = [];
|
const problems: string[] = [];
|
const nodes: Record<string, unknown>[] = [];
|
|
(components ?? []).forEach((draft, index) => {
|
const position = `第 ${index + 1} 个组件`;
|
const type = draft?.type ?? '';
|
const definition = getQualityComponent(type);
|
if (!definition) {
|
skipped.push({
|
type,
|
label: type || '未命名组件',
|
reason: `${position}：类型「${type || '空'}」不在当前设计器的组件清单内，已跳过`,
|
});
|
return;
|
}
|
|
const normalized = normalizeDraftProps(definition, draft?.props);
|
normalized.problems.forEach((message) => problems.push(`${position}：${message}`));
|
|
// buildQualityContent 做的正是往返所需的四件事：defaults 打底、buildContent 生成结构、
|
// propsToAttributes 只输出声明过的 key 并字符串化、写入 data-quality-type。
|
const content = buildQualityContent(definition, normalized.props) as Record<string, unknown>;
|
// traits 不进画布数据：载入后由 restoreQualityTraits 按 data-quality-type 重建，
|
// 与「打开一份已保存的版本」走的是同一条路（traits 本来也不参与项目数据序列化）。
|
delete content.traits;
|
nodes.push(content);
|
|
validateQualityProps(definition, normalized.props).forEach((message) =>
|
problems.push(`${position}：${message}`),
|
);
|
});
|
|
return {
|
// pages 必须非空，否则 loadSchema 会走空白页兜底分支，装配好的组件全部丢掉
|
grapes: {
|
pages: [{ component: { style: { padding: '0' }, components: nodes } }],
|
},
|
skipped,
|
problems,
|
};
|
}
|
|
/**
|
* 把 AI 给的属性收敛成语义层能承载的原始值。
|
* <p>
|
* 只管一件事：值必须是 boolean / number / string。模型偶尔会把字段写成嵌套对象或数组
|
* （比如把检验项数据行整段塞进 itemsPath），这类值经 coerceFieldValue 的 String() 会变成
|
* "[object Object]" 写进画布，属性面板里显示一串乱码，还会静默盖掉默认值——所以在这里拦掉并说明。
|
* <p>
|
* 不检查 key 是否声明过：未声明的 key 由 propsToAttributes 丢弃，本来也进不了画布。
|
*/
|
function normalizeDraftProps(
|
definition: QualityComponentDefinition,
|
props?: Record<string, unknown>,
|
): { props: QualityProps; problems: string[] } {
|
const normalized: QualityProps = {};
|
const problems: string[] = [];
|
if (!props) {
|
return { props: normalized, problems };
|
}
|
definition.propertySchema.forEach((field) => {
|
const value = props[field.key];
|
// null 与 undefined 同义：模型没给值，交给 defaults 兜底
|
if (value === undefined || value === null) {
|
return;
|
}
|
if (
|
typeof value === 'boolean' ||
|
typeof value === 'number' ||
|
typeof value === 'string'
|
) {
|
normalized[field.key] = value;
|
return;
|
}
|
problems.push(
|
`${definition.label}的「${field.label}」收到的是结构化数据，语义层只承载单个值，已按默认值处理`,
|
);
|
});
|
return { props: normalized, problems };
|
}
|
