260907_01_ENH: 에디터 이미지맵 보존 및 SMS 미리보기 문구 지원

This commit is contained in:
2026-09-07 14:28:31 +09:00
parent b36893610f
commit b6ed23fa88
9 changed files with 416 additions and 17 deletions

View File

@@ -0,0 +1,218 @@
"use client";
import DOMPurify, { type DOMPurify as DOMPurifyInstance } from "dompurify";
import type { KriEditorWysiwygCompatibility } from "@/components/kri-editor";
const EMAIL_ALLOWED_ATTRIBUTES = {
a: ["href", "title", "style", "target", "rel"],
area: ["shape", "coords", "href", "alt", "title", "target"],
b: ["style"],
blockquote: ["cite"],
col: ["span", "width"],
colgroup: ["span", "width"],
div: ["style", "align"],
img: ["src", "width", "height", "alt", "title", "align", "style", "loading", "usemap"],
map: ["name", "id"],
mark: ["style", "data-color"],
ol: ["start", "type"],
p: ["style"],
q: ["cite"],
qrcode: ["src", "width", "height", "alt"],
span: ["style"],
table: ["summary", "width", "height", "style", "cellpadding", "cellspacing", "border", "align", "bgcolor", "role"],
tbody: ["style", "align", "valign"],
td: ["abbr", "axis", "colspan", "rowspan", "width", "height", "style", "align", "valign", "bgcolor"],
th: ["abbr", "axis", "colspan", "rowspan", "scope", "width", "height", "style", "align", "valign", "bgcolor"],
tr: ["style", "align", "valign", "bgcolor", "height"],
ul: ["type"],
} as const;
export const EMAIL_ALLOWED_TAGS = [
"a", "area", "b", "blockquote", "br", "caption", "cite", "code", "col", "colgroup", "dd", "div", "dl", "dt",
"em", "h1", "h2", "h3", "h4", "h5", "h6", "i", "img", "li", "map", "mark", "ol", "p", "pre", "q", "qrcode",
"small", "span", "strike", "strong", "sub", "sup", "table", "tbody", "td", "tfoot", "th", "thead", "tr", "u", "ul",
] as const;
const TAGS_WITHOUT_ATTRIBUTES = new Set(
EMAIL_ALLOWED_TAGS.filter((tag) => !(tag in EMAIL_ALLOWED_ATTRIBUTES)),
);
const ALLOWED_TAG_SET = new Set<string>(EMAIL_ALLOWED_TAGS);
const ALLOWED_ATTRIBUTE_SET = new Set<string>(Object.values(EMAIL_ALLOWED_ATTRIBUTES).flat());
const ALLOWED_PROTOCOLS: Record<string, ReadonlySet<string>> = {
"a.href": new Set(["http", "https", "mailto", "tel", "ftp"]),
"area.href": new Set(["http", "https", "mailto", "tel"]),
"img.src": new Set(["http", "https"]),
"blockquote.cite": new Set(["http", "https"]),
"q.cite": new Set(["http", "https"]),
};
const WYSIWYG_ATTRIBUTES: Record<string, ReadonlySet<string>> = {
a: new Set(["href", "target", "rel", "class"]),
area: new Set(EMAIL_ALLOWED_ATTRIBUTES.area),
div: new Set(["style", "class"]),
img: new Set([...EMAIL_ALLOWED_ATTRIBUTES.img, "class", "data-kri-image"]),
map: new Set(EMAIL_ALLOWED_ATTRIBUTES.map),
mark: new Set(EMAIL_ALLOWED_ATTRIBUTES.mark),
ol: new Set(["start"]),
p: new Set(["style"]),
qrcode: new Set(EMAIL_ALLOWED_ATTRIBUTES.qrcode),
span: new Set(["style"]),
td: new Set(["colspan", "rowspan"]),
th: new Set(["colspan", "rowspan"]),
};
const WYSIWYG_TAGS = new Set([
"a", "area", "b", "br", "div", "em", "i", "img", "li", "map", "mark", "ol", "p", "qrcode", "span", "strong",
"table", "tbody", "td", "th", "tr", "u", "ul",
]);
const WYSIWYG_SPAN_STYLE_PROPERTIES = new Set(["color", "font-family", "font-size"]);
const WYSIWYG_PARAGRAPH_STYLE_PROPERTIES = new Set(["text-align"]);
function resolvePurifier(): DOMPurifyInstance | null {
if (typeof window === "undefined") return null;
if (typeof DOMPurify.sanitize === "function") return DOMPurify;
return DOMPurify(window);
}
function parseHtml(html: string): HTMLTemplateElement | null {
if (typeof document === "undefined") return null;
const template = document.createElement("template");
template.innerHTML = html;
return template;
}
function allowedAttributesFor(tagName: string): ReadonlySet<string> {
if (TAGS_WITHOUT_ATTRIBUTES.has(tagName as typeof EMAIL_ALLOWED_TAGS[number])) return new Set();
return new Set((EMAIL_ALLOWED_ATTRIBUTES as Record<string, readonly string[]>)[tagName] ?? []);
}
function hasAllowedProtocol(tagName: string, attributeName: string, value: string): boolean {
const protocols = ALLOWED_PROTOCOLS[`${tagName}.${attributeName}`];
if (!protocols) return true;
const match = /^([a-z][a-z\d+.-]*):/i.exec(value.trim());
return Boolean(match && protocols.has(match[1].toLowerCase()));
}
function styleProperties(value: string): Set<string> {
return new Set(
value.split(";")
.map((declaration) => declaration.split(":", 1)[0]?.trim().toLowerCase())
.filter((property): property is string => Boolean(property)),
);
}
function isWysiwygStyleCompatible(tagName: string, value: string): boolean {
if (tagName === "div" || tagName === "img" || tagName === "mark") return true;
const supported = tagName === "span"
? WYSIWYG_SPAN_STYLE_PROPERTIES
: tagName === "p" ? WYSIWYG_PARAGRAPH_STYLE_PROPERTIES : null;
return Boolean(supported && [...styleProperties(value)].every((property) => supported.has(property)));
}
function summarizeIssues(issues: readonly string[]): string {
const unique = [...new Set(issues)];
const visible = unique.slice(0, 3).join(", ");
const suffix = unique.length > 3 ? ` 외 ${unique.length - 3}개` : "";
return `${visible}${suffix} 항목은 WYSIWYG에서 손실될 수 있어 HTML 모드로 유지됩니다.`;
}
export function getEmailWysiwygCompatibility(html: string): KriEditorWysiwygCompatibility {
const template = parseHtml(html);
const issues: string[] = [];
if (!template) {
const tags = [...html.matchAll(/<\/?\s*([a-z][\w-]*)\b/gi)].map((match) => match[1].toLowerCase());
for (const tagName of tags) {
if (!WYSIWYG_TAGS.has(tagName)) issues.push(`<${tagName}>`);
}
} else {
for (const element of Array.from(template.content.querySelectorAll("*"))) {
const tagName = element.tagName.toLowerCase();
if (!WYSIWYG_TAGS.has(tagName)) {
issues.push(`<${tagName}>`);
continue;
}
const supportedAttributes = WYSIWYG_ATTRIBUTES[tagName] ?? new Set<string>();
for (const attribute of Array.from(element.attributes)) {
const attributeName = attribute.name.toLowerCase();
if (!supportedAttributes.has(attributeName)) {
issues.push(`<${tagName}>의 ${attributeName}`);
} else if (attributeName === "style" && !isWysiwygStyleCompatible(tagName, attribute.value)) {
issues.push(`<${tagName}>의 일부 style`);
}
}
if (tagName === "area" && element.parentElement?.tagName.toLowerCase() !== "map") {
issues.push("<map> 밖의 <area>");
}
}
}
return issues.length > 0
? { compatible: false, reason: summarizeIssues(issues) }
: { compatible: true };
}
function isEditorDecoration(tagName: string, attributeName: string, value: string): boolean {
if (tagName === "a" && attributeName === "class" && value === "kri-editor-link") return true;
if (tagName !== "img") return false;
return (attributeName === "class" && value === "max-w-full h-auto")
|| (attributeName === "data-kri-image" && value === "true");
}
export function getEmailHtmlPolicyIssues(html: string): string[] {
const template = parseHtml(html);
if (!template) return [];
const issues: string[] = [];
for (const element of Array.from(template.content.querySelectorAll("*"))) {
const tagName = element.tagName.toLowerCase();
if (!ALLOWED_TAG_SET.has(tagName)) {
issues.push(`<${tagName}> 태그`);
continue;
}
const allowedAttributes = allowedAttributesFor(tagName);
for (const attribute of Array.from(element.attributes)) {
const attributeName = attribute.name.toLowerCase();
if (isEditorDecoration(tagName, attributeName, attribute.value)) continue;
if (!allowedAttributes.has(attributeName)) {
issues.push(`<${tagName}>의 ${attributeName} 속성`);
} else if (!hasAllowedProtocol(tagName, attributeName, attribute.value)) {
issues.push(`<${tagName}>의 ${attributeName} URL`);
}
}
}
return [...new Set(issues)];
}
export function sanitizeEmailHtml(html: string): string {
if (!html) return "";
const purifier = resolvePurifier();
if (!purifier) return html.replace(/<[^>]*>/g, "");
const sanitized = purifier.sanitize(html, {
ALLOWED_TAGS: [...EMAIL_ALLOWED_TAGS],
ALLOWED_ATTR: [...ALLOWED_ATTRIBUTE_SET],
ALLOW_DATA_ATTR: false,
});
const template = parseHtml(sanitized);
if (!template) return "";
for (const element of Array.from(template.content.querySelectorAll("*"))) {
const tagName = element.tagName.toLowerCase();
const allowedAttributes = allowedAttributesFor(tagName);
for (const attribute of Array.from(element.attributes)) {
const attributeName = attribute.name.toLowerCase();
if (!allowedAttributes.has(attributeName) || !hasAllowedProtocol(tagName, attributeName, attribute.value)) {
element.removeAttribute(attribute.name);
}
}
}
return template.innerHTML.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, "").trim();
}