Phase7-PerfSEO: 폰트 preload 옵션 및 이미지 loading/decoding UI 연동 TDD/구현 완료

2025-11-16 04:10:52 +09:00
parent 689edeaf24
commit ed7f6189eb
5 changed files with 183 additions and 8 deletions
@@ -0,0 +1,53 @@
+import { describe, it, expect, beforeEach } from 'vitest'
+import { render, screen, fireEvent, waitFor } from '@testing-library/react'
+import { NextIntlClientProvider } from 'next-intl'
+import BuilderClientPage from '@/components/BuilderClientPage'
+
+declare global {
+  interface Window { __exportPreview?: () => { html: string } }
+}
+
+describe('BuilderClientPage 이미지 옵션 UI 연동', () => {
+  beforeEach(() => {
+    // JSDOM 환경 초기화용
+    window.__exportPreview = undefined
+  })
+
+  it('기본값으로 img에 loading="lazy" decoding="async"가 포함된다', async () => {
+    render(
+      <NextIntlClientProvider locale="en" messages={{}}>
+        <BuilderClientPage />
+      </NextIntlClientProvider>
+    )
+    // Ensure a hero section with image is present
+    const addHeroBtn = screen.getByTestId('btn-add-hero')
+    addHeroBtn.click()
+    expect(typeof window.__exportPreview).toBe('function')
+    await waitFor(() => {
+      const out = window.__exportPreview!()
+      expect(out.html).toContain('loading="lazy"')
+      expect(out.html).toContain('decoding="async"')
+    })
+  })
+
+  it('UI에서 eager/sync로 변경 시 preview HTML에 반영된다', async () => {
+    render(
+      <NextIntlClientProvider locale="en" messages={{}}>
+        <BuilderClientPage />
+      </NextIntlClientProvider>
+    )
+    const addHeroBtn = screen.getByTestId('btn-add-hero')
+    addHeroBtn.click()
+    const loadingSelect = screen.getByLabelText('Image Loading') as HTMLSelectElement
+    const decodingSelect = screen.getByLabelText('Image Decoding') as HTMLSelectElement
+
+    fireEvent.change(loadingSelect, { target: { value: 'eager' } })
+    fireEvent.change(decodingSelect, { target: { value: 'sync' } })
+
+    await waitFor(() => {
+      const out = window.__exportPreview!()
+      expect(out.html).toContain('loading="eager"')
+      expect(out.html).toContain('decoding="sync"')
+    })
+  })
+})
@@ -61,6 +61,9 @@ export default function BuilderClientPage() {
  const [assetPathStrategy, setAssetPathStrategy] = useState<'flat' | 'grouped'>('flat')
  // Font optimization: allow toggling Google Fonts preconnect links in exported HTML
  const [fontPreconnect, setFontPreconnect] = useState<boolean>(true)
+  const [fontPreload, setFontPreload] = useState<boolean>(false)
+  const [imageLoading, setImageLoading] = useState<'lazy' | 'eager'>('lazy')
+  const [imageDecoding, setImageDecoding] = useState<'async' | 'sync'>('async')
  const [viewport, setViewport] = useState<'desktop' | 'mobile'>(() => {
    if (typeof window !== 'undefined') {
      try {
@@ -194,7 +197,7 @@ export default function BuilderClientPage() {
        w.__exportPreview = () => {
          try {
            // Export preview with current optimization options
-            return exportPage(pageSchema.parse(pageData), { assetManager: buildEffectiveAm(), fontPreconnect })
+            return exportPage(pageSchema.parse(pageData), { assetManager: buildEffectiveAm(), fontPreconnect, fontPreload, imageLoading, imageDecoding })
          } catch {
            const fixed: Page = {
              ...pageData,
@@ -204,12 +207,12 @@ export default function BuilderClientPage() {
                spamProtection: pageData.form?.spamProtection ?? { honeypotFieldName: '_hp', minSubmitSeconds: 2 },
              },
            }
-            return exportPage(pageSchema.parse(fixed), { assetManager: buildEffectiveAm(), fontPreconnect })
+            return exportPage(pageSchema.parse(fixed), { assetManager: buildEffectiveAm(), fontPreconnect, fontPreload, imageLoading, imageDecoding })
          }
        }
      }
    } catch {}
-  }, [pageData, am, fontPreconnect, assetPathStrategy])
+  }, [pageData, am, fontPreconnect, fontPreload, imageLoading, imageDecoding, assetPathStrategy])

  const doExport = useCallback(async () => {
    let valid = pageData as Page
@@ -237,8 +240,8 @@ export default function BuilderClientPage() {
      }
      return clone
    }
-    // Respect font optimization toggle when exporting
-    const exported = exportPage(valid, { assetManager: buildEffectiveAm(), fontPreconnect })
+    // Respect font and image optimization toggles when exporting
+    const exported = exportPage(valid, { assetManager: buildEffectiveAm(), fontPreconnect, fontPreload, imageLoading, imageDecoding })
    try {
      if (typeof window !== 'undefined') {
        const w = window as unknown as { __captureExport?: boolean; __lastExport?: { html: string; css: string; js: string } }
@@ -285,7 +288,7 @@ export default function BuilderClientPage() {
    }
    const zipBytes = await buildZip({ html: exported.html, css: exported.css, js: exported.js, assets, extras })
    download('landing.zip', zipBytes)
-  }, [pageData, am, manifestName, manifestShortName, manifestStartUrl, manifestDisplay, manifestThemeColor, robotsDisallow, sheetsMode, fontPreconnect, assetPathStrategy])
+  }, [pageData, am, manifestName, manifestShortName, manifestStartUrl, manifestDisplay, manifestThemeColor, robotsDisallow, sheetsMode, fontPreconnect, fontPreload, imageLoading, imageDecoding, assetPathStrategy])

  return (
    <div className="p-6 space-y-6">
@@ -375,6 +378,44 @@ export default function BuilderClientPage() {
                />
                <span className="text-sm">Enable font preconnect (Google Fonts)</span>
              </label>
+              <label className="flex items-center gap-2" htmlFor="ins-font-preload">
+                <input
+                  id="ins-font-preload"
+                  type="checkbox"
+                  aria-label="Font Preload"
+                  checked={fontPreload}
+                  onChange={(e) => setFontPreload(e.target.checked)}
+                />
+                <span className="text-sm">Enable font preload (Google Fonts)</span>
+              </label>
+              <div className="grid grid-cols-2 gap-2">
+                <label className="block" htmlFor="ins-image-loading">
+                  <span className="sr-only">Image Loading</span>
+                  <select
+                    id="ins-image-loading"
+                    aria-label="Image Loading"
+                    className="border rounded px-3 py-2 w-full"
+                    value={imageLoading}
+                    onChange={(e) => setImageLoading(e.target.value as 'lazy' | 'eager')}
+                  >
+                    <option value="lazy">Image Loading: lazy</option>
+                    <option value="eager">Image Loading: eager</option>
+                  </select>
+                </label>
+                <label className="block" htmlFor="ins-image-decoding">
+                  <span className="sr-only">Image Decoding</span>
+                  <select
+                    id="ins-image-decoding"
+                    aria-label="Image Decoding"
+                    className="border rounded px-3 py-2 w-full"
+                    value={imageDecoding}
+                    onChange={(e) => setImageDecoding(e.target.value as 'async' | 'sync')}
+                  >
+                    <option value="async">Image Decoding: async</option>
+                    <option value="sync">Image Decoding: sync</option>
+                  </select>
+                </label>
+              </div>
              <label className="block" htmlFor="ins-manifest-name">
                <span className="sr-only">Manifest Name</span>
                <input
@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest'
+import { exportPage, type ExportOptions } from '@/lib/exporter/html'
+import { pageSchema, type Page } from '@/lib/schema/page'
+
+function makePage(fontFamily = 'Inter'): Page {
+  return pageSchema.parse({
+    title: 'Font Preload',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily },
+    sections: [ { type: 'hero', props: { heading: 'Hello', subheading: 'World', imageUrl: 'https://img/h.png' } } ],
+    form: { actionUrl: '', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 't', description: 'd' },
+  })
+}
+
+describe('폰트 preload 옵션', () => {
+  it('옵션이 true이면 Google Fonts stylesheet preload/link를 head에 포함한다', () => {
+    const page = makePage('Inter')
+    const opts: ExportOptions = { fontPreload: true }
+    const out = exportPage(page, opts)
+    expect(out.html).toContain('rel="preload"')
+    expect(out.html).toContain('as="style"')
+    expect(out.html).toContain('fonts.googleapis.com/css2')
+    expect(out.html).toContain('family=Inter')
+    // onload print hack 포함
+    expect(out.html).toMatch(/rel=\"stylesheet\"[^>]+media=\"print\"[^>]+onload=\"this.media='all'\"/)
+  })
+
+  it('옵션이 false이면 preload/link를 포함하지 않는다', () => {
+    const page = makePage('Inter')
+    const opts: ExportOptions = { fontPreload: false }
+    const out = exportPage(page, opts)
+    expect(out.html).not.toMatch(/fonts.googleapis.com\/css2/)
+  })
+})
@@ -2,7 +2,14 @@ import type { Page, FormField } from '@/lib/schema/page'
 import type { AssetManager } from '@/lib/assets/assetManager'

 export type Exported = { html: string; css: string; js: string }
-export type ExportOptions = { assetManager?: AssetManager; fontPreconnect?: boolean; robotsMeta?: string }
+export type ExportOptions = {
+  assetManager?: AssetManager
+  fontPreconnect?: boolean
+  fontPreload?: boolean
+  robotsMeta?: string
+  imageLoading?: 'lazy' | 'eager'
+  imageDecoding?: 'async' | 'sync'
+}

 function renderFaq(section: { props: { items: Array<{ q: string; a: string }> } }) {
  const itemsRaw: Array<{ q: string; a: string }> = Array.isArray(section.props.items) ? section.props.items : []
@@ -116,6 +123,8 @@ function renderHero(section: { props: { heading: string; subheading?: string; im
  const am = opts?.assetManager
  const imageUrlRaw: string = section.props.imageUrl
  const imageUrl = am ? am.rewriteUrl(imageUrlRaw) : imageUrlRaw
+  const loading = opts?.imageLoading ?? 'lazy'
+  const decoding = opts?.imageDecoding ?? 'async'
  return `
    <section class="hero" aria-labelledby="hero-heading">
      <div class="container">
@@ -124,7 +133,7 @@ function renderHero(section: { props: { heading: string; subheading?: string; im
          ${subheading.length > 0 ? `<p>${escapeHtml(subheading)}</p>` : ''}
        </div>
        <div class="media">
-          <img src="${escapeHtml(imageUrl)}" alt="${escapeHtml(heading)}" loading="lazy" decoding="async" width="1200" height="675" />
+          <img src="${escapeHtml(imageUrl)}" alt="${escapeHtml(heading)}" loading="${escapeHtml(loading)}" decoding="${escapeHtml(decoding)}" width="1200" height="675" />
        </div>
      </div>
    </section>
@@ -252,12 +261,18 @@ function buildHead(page: Page, opts?: ExportOptions) {
  const custom = page.analytics?.customHeadHtml || ''
  const preconnect = opts?.fontPreconnect !== false
  const robotsMeta = (opts?.robotsMeta && opts.robotsMeta.trim().length > 0) ? `<meta name="robots" content="${escapeHtml(opts!.robotsMeta!)}" />` : ''
+  const fontPreload = opts?.fontPreload === true
+  const rawFamily = (page.theme?.fontFamily || '').trim()
+  const fontHref = rawFamily.length > 0 ? `https://fonts.googleapis.com/css2?family=${encodeURIComponent(rawFamily).replace(/%20/g, '+')}&display=swap` : ''
  return `
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <link rel="canonical" href="/" />
    ${preconnect ? '<link rel="preconnect" href="https://fonts.googleapis.com" />' : ''}
    ${preconnect ? '<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />' : ''}
+    ${fontPreload && fontHref ? `<link rel="preload" as="style" href="${fontHref}" />` : ''}
+    ${fontPreload && fontHref ? `<link rel="stylesheet" href="${fontHref}" media="print" onload="this.media='all'" />` : ''}
+    ${fontPreload && fontHref ? `<noscript><link rel="stylesheet" href="${fontHref}" /></noscript>` : ''}
    <link rel="manifest" href="/site.webmanifest" />
    <meta name="theme-color" content="${escapeHtml(page.theme.primaryColor)}" />
    ${robotsMeta}
@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest'
+import { exportPage, type ExportOptions } from '@/lib/exporter/html'
+import { pageSchema, type Page } from '@/lib/schema/page'
+
+function makePage(): Page {
+  return pageSchema.parse({
+    title: 'Img Perf',
+    locale: 'en',
+    theme: { primaryColor: '#2563eb', fontFamily: 'Inter' },
+    sections: [ { type: 'hero', props: { heading: 'Hello', subheading: 'World', imageUrl: 'https://img/h.png' } } ],
+    form: { actionUrl: '', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } },
+    seo: { title: 't', description: 'd' },
+  })
+}
+
+describe('이미지 loading/decoding 토글', () => {
+  it('기본은 loading="lazy", decoding="async"', () => {
+    const page = makePage()
+    const out = exportPage(page)
+    expect(out.html).toContain('loading="lazy"')
+    expect(out.html).toContain('decoding="async"')
+  })
+
+  it('옵션으로 eager/sync로 바꿀 수 있다', () => {
+    const page = makePage()
+    const opts: ExportOptions = { imageLoading: 'eager', imageDecoding: 'sync' }
+    const out = exportPage(page, opts)
+    expect(out.html).toContain('loading="eager"')
+    expect(out.html).toContain('decoding="sync"')
+  })
+})