An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
import {isAVDateType, isAVSelectType, isAVTextType} from "./capabilities";
import type {IAVSelectedCell} from "./selectionState";
import {createAVLocationReplacement, isAVLocationEmpty} from "./locationValue";
// 编辑器按条目和原始字段验证目标,包含隐藏字段以及批量代理未携带分组标识的情况。
export const hasAVCachedCellType = (view: IAVView, rowID: string, colID: string, type: TAVCol): boolean => {
const columns = (view as IAVTable).columns || (view as IAVGallery).fields || [];
const index = columns.findIndex(column => column.id === colID && column.type === type);
const items: Array<IAVRow | IAVGalleryItem> = (view as IAVTable).rows || (view as IAVGallery).cards || [];
if (index >= 0 && items.some(item => item.id === rowID &&
!!("cells" in item ? item.cells : item.values)[index])) {
return true;
}
return view.groups?.some(group => hasAVCachedCellType(group, rowID, colID, type)) || false;
};
// 按行和字段同步已加载的数据,供后续编辑读取,不依赖选区或单元格是否已渲染。
export const updateAVCachedCellValue = (view: IAVView, rowID: string, colID: string, value: IAVCellValue) => {
const columns = (view as IAVTable).columns || (view as IAVGallery).fields || [];
const colIndex = columns.findIndex(column => column.id === colID);
const items: Array<IAVRow | IAVGalleryItem> = (view as IAVTable).rows || (view as IAVGallery).cards || [];
if (colIndex >= 0) {
items.filter(item => item.id === rowID).forEach(item => {
const cell = ("cells" in item ? item.cells : item.values)[colIndex];
if (cell) {
cell.id = value.id || "";
cell.value = cloneAVCellValueSnapshot(value);
cell.valueType = value.type;
}
});
}
view.groups?.forEach(group => updateAVCachedCellValue(group, rowID, colID, value));
};
export const getAVBlockRefSubtype = (value?: IAVCellValue): "s" | "d" => value?.block?.refSubtype === "d" ? "d" : "s";
export const createEmptyAVValue = (keyID: string, type: TAVCol, blockID?: string) => ({
type,
keyID,
blockID,
block: {id: "", content: ""},
text: {content: ""},
number: {content: 0, isNotEmpty: false, formattedContent: ""},
url: {content: ""},
phone: {content: ""},
email: {content: ""},
...(type === "location" ? {location: createAVLocationReplacement()} : {}),
template: {content: ""},
date: {isNotEmpty: false, isNotEmpty2: false},
created: {isNotEmpty: false},
updated: {isNotEmpty: false},
checkbox: {checked: false},
mSelect: [],
mAsset: [],
relation: {blockIDs: [], contents: []},
rollup: {contents: []},
} as IAVCellValue);
export const hasAVRenderTemplateResult = (value: IAVCellValue, renderTemplate?: string) =>
value.type !== "template" &&
(value.hasRenderTemplate || typeof value.renderedContent === "string" || Boolean(renderTemplate?.trim()));
export const cellValueIsEmpty = (value: IAVCellValue, useRenderedContent = false, renderTemplate?: string) => {
if (useRenderedContent && hasAVRenderTemplateResult(value, renderTemplate)) {
return !value.renderedContent;
}
if (value.type === "checkbox") {
return false;
}
if (value.type === "location") {
return isAVLocationEmpty(value.location);
}
if (isAVTextType(value.type)) {
return !value[value.type as "text"]?.content;
}
if (value.type === "number") {
return value.number ? !value.number.isNotEmpty : true;
}
if ((isAVSelectType(value.type) || value.type === "mAsset")) {
if (value[(value.type === "select" ? "mSelect" : value.type) as "mSelect"]?.length > 0) {
return false;
}
return true;
}
if (isAVDateType(value.type)) {
return !value[value.type as "date"]?.isNotEmpty &&
!value[value.type as "date"]?.isNotEmpty2;
}
if (value.type === "relation") {
if (value.relation?.blockIDs && value.relation.blockIDs.length > 0) {
return false;
}
return true;
}
if (value.type === "rollup") {
if (value.rollup?.contents && value.rollup.contents.length > 0) {
return false;
}
return true;
}
};
export const genEmptyAVCellValue = (colType: TAVCol): IAVCellValue => {
const cellValue: IAVCellValue = {
type: colType,
};
if (colType === "location") {
cellValue.location = createAVLocationReplacement();
} else if (colType === "number") {
cellValue.number = {
content: 0,
isNotEmpty: false,
};
} else if (isAVTextType(colType)) {
cellValue[colType as "text"] = {
content: "",
};
} else if (colType === "mSelect" || colType === "select") {
cellValue.mSelect = [];
} else if (colType === "mAsset") {
cellValue.mAsset = [];
} else if (isAVDateType(colType)) {
cellValue[colType as "date"] = {
content: null,
isNotEmpty: false,
content2: null,
isNotEmpty2: false,
hasEndDate: false,
isNotTime: true,
};
} else if (colType === "checkbox") {
cellValue.checkbox = {
checked: false,
};
} else if (colType === "relation") {
cellValue.relation = {
blockIDs: [],
contents: [],
};
} else if (colType === "rollup") {
cellValue.rollup = {
contents: [],
};
}
if (colType === "block") {
cellValue.isDetached = true;
}
return cellValue;
};
export const cloneAVCellValueSnapshot = (value: IAVCellValue): IAVCellValue => {
const snapshot = JSON.parse(JSON.stringify(value, (key, item) =>
["renderedContent", "hasRenderTemplate"].includes(key) ? undefined : item)) as IAVCellValue;
if ((snapshot.type === "mSelect" || snapshot.type === "select") && !snapshot.mSelect) {
snapshot.mSelect = [];
} else if (snapshot.type === "mAsset" && !snapshot.mAsset) {
snapshot.mAsset = [];
} else if (snapshot.type === "location") {
snapshot.location = createAVLocationReplacement(snapshot.location);
}
return snapshot;
};
export const createAVStableTextCell = (options: {
groupID?: string;
rowID?: string;
colID?: string;
rowIndex?: number;
colIndex?: number;
cellID?: string;
value: IAVCellValue;
}): IAVSelectedCell | undefined => {
const rowID = options.rowID || "";
const colID = options.colID || "";
if (!rowID || !colID) {
return;
}
const value = cloneAVCellValueSnapshot(options.value);
return {
groupID: options.groupID || "",
rowID,
colID,
rowIndex: options.rowIndex ?? 0,
colIndex: options.colIndex ?? -1,
cell: {
id: value.id || options.cellID || "",
color: "",
bgColor: "",
value,
valueType: "text",
},
column: {
id: colID,
type: "text",
} as IAVColumn,
};
};
export const createAVCellUpdateOperation = (options: {
valueID?: string;
avID?: string;
blockID?: string;
keyID: string;
rowID: string;
data: IAVCellValue;
}): IOperation => ({
action: "updateAttrViewCell",
id: options.valueID || "",
avID: options.avID,
...(options.blockID ? {blockID: options.blockID} : {}),
keyID: options.keyID,
rowID: options.rowID,
data: options.data,
});
export const getConvertedEmptyAVCellValue = (colType: TAVCol, value: IAVCellValue) => {
if (colType === value.type || !cellValueIsEmpty(value)) {
return;
}
return genEmptyAVCellValue(colType);
};
export const genRelationAVCellValue = (value: IAVCellValue): IAVCellValue => {
if (value.type === "block" && value.blockID) {
return {
type: "relation",
relation: {
blockIDs: [value.blockID],
contents: [value],
},
};
}
return genEmptyAVCellValue("relation");
};