sori.studio/lib/markdown-image.js

/** @type {RegExp} 이미지 마크다운 한 줄 */
const IMAGE_MARKDOWN_LINE_RE = /^!\[(.*?)\]\((\S+?)(?:\s+"((?:[^"\\]|\\.)*)")?\)(?:\{width=(regular|wide|full)\})?$/

/**
 * 캡션 문자열 이스케이프 해제
 * @param {string} value - 이스케이프된 캡션
 * @returns {string} 캡션
 */
const unescapeImageCaption = (value) => String(value || '').replace(/\\"/g, '"')

/**
 * 캡션 문자열 이스케이프
 * @param {string} value - 캡션
 * @returns {string} 이스케이프된 캡션
 */
const escapeImageCaption = (value) => String(value || '').replace(/"/g, '\\"')

/**
 * URL에서 기본 대체 텍스트(파일명) 추출
 * @param {string} url - 이미지 URL
 * @returns {string} 파일명 기반 라벨
 */
export const getImageDefaultAltLabel = (url) => {
  const raw = String(url || '').trim()

  if (!raw) {
    return ''
  }

  try {
    const pathname = new URL(raw, 'https://sori.studio').pathname
    return decodeURIComponent(pathname.split('/').filter(Boolean).pop() || '')
  } catch {
    const withoutQuery = raw.split('?')[0].split('#')[0]
    return decodeURIComponent(withoutQuery.split('/').filter(Boolean).pop() || '')
  }
}

/**
 * 이미지 마크다운 한 줄 파싱
 * @param {string} line - 마크다운 줄
 * @returns {{ url: string, width: string, caption: string, useAlt: boolean }|null}
 */
export const parseImageMarkdownLine = (line) => {
  const match = String(line || '').trim().match(IMAGE_MARKDOWN_LINE_RE)

  if (!match) {
    return null
  }

  const url = match[2] || ''
  const altBracket = (match[1] || '').trim()
  const quotedCaption = unescapeImageCaption(match[3])
  const filenameAlt = getImageDefaultAltLabel(url)
  /** 대괄호 안 문자열이 URL 파일명과 같을 때만 파일명 대체 텍스트 모드 */
  const useAlt = altBracket !== '' && altBracket === filenameAlt

  return {
    url,
    /** `![](url "캡션")` 따옴표 캡션만 편집 필드에 반영 */
    caption: quotedCaption,
    /** 레거시 `![표시문구](url)` — 캡션 따옴표 없을 때 미리보기용 */
    legacyBracketLabel: !quotedCaption && altBracket && !useAlt ? altBracket : '',
    width: match[4] || 'regular',
    useAlt
  }
}

/**
 * 이미지 마크다운 한 줄 생성
 * @param {{ url: string, caption?: string, width?: string, useAlt?: boolean }} image - 이미지 정보
 * @returns {string} 마크다운 줄
 */
export const serializeImageMarkdown = (image) => {
  const url = String(image.url || '').trim()

  if (!url) {
    return ''
  }

  const alt = image.useAlt === true ? getImageDefaultAltLabel(url) : ''
  const caption = String(image.caption ?? '').trim()
  const titlePart = caption ? ` "${escapeImageCaption(caption)}"` : ''
  const width = image.width && image.width !== 'regular' ? `{width=${image.width}}` : ''

  return `![${alt}](${url}${titlePart})${width}`
}

/**
 * 공개 렌더용 img alt 텍스트
 * @param {{ url?: string, useAlt?: boolean }} image - 이미지 정보
 * @returns {string} alt 속성값
 */
export const getImageAltAttribute = (image) => {
  if (!image?.useAlt) {
    return ''
  }

  return getImageDefaultAltLabel(image.url)
}

/**
 * 공개 렌더용 캡션(표시용 figcaption)
 * @param {{ caption?: string }} image - 이미지 정보
 * @returns {string} 캡션
 */
export const getImageCaption = (image) => {
  const caption = String(image?.caption || '').trim()

  if (caption) {
    return caption
  }

  if (image?.useAlt) {
    return ''
  }

  return String(image?.legacyBracketLabel || '').trim()
}