diff --git a/README.md b/README.md
index 2efff98..cb3dd5b 100644
--- a/README.md
+++ b/README.md
@@ -51,15 +51,23 @@ The Builder can export a production-ready ZIP that contains:
- Name, Short Name, Start URL, Display (dropdown), Theme Color (HEX only)
- Robots
- Disallow lines (textarea). Each line becomes a `Disallow:` rule.
+ - Robots Meta: ` ` value (e.g. `noindex, nofollow`). Empty disables the tag.
- Google Sheets Template Mode
- Auto: include when `form.actionUrl` is empty
- Include: always include
- Exclude: never include
+- Font Optimization
+ - Preconnect: toggle inclusion of Google Fonts preconnect links.
+ - Preload: preload & load Google Fonts stylesheet with `media="print" onload` pattern.
+- Image Options
+ - Loading: `lazy` (default) or `eager` for ` `
+ - Decoding: `async` (default) or `sync` for ` `
### site.webmanifest and robots.txt
- `site.webmanifest` is derived from page data; Export Options can override fields.
- `robots.txt` defaults to a permissive header and adds `Disallow` lines from UI.
+- `meta name="robots"` can be injected via Export Options and is written in `
`.
### Asset paths and grouping
diff --git a/components/BuilderClientPage.imageOptions.test.tsx b/components/BuilderClientPage.imageOptions.test.tsx
new file mode 100644
index 0000000..3784257
--- /dev/null
+++ b/components/BuilderClientPage.imageOptions.test.tsx
@@ -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(
+
+
+
+ )
+ // 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(
+
+
+
+ )
+ 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"')
+ })
+ })
+})
diff --git a/components/BuilderClientPage.robotsMeta.test.tsx b/components/BuilderClientPage.robotsMeta.test.tsx
new file mode 100644
index 0000000..e851703
--- /dev/null
+++ b/components/BuilderClientPage.robotsMeta.test.tsx
@@ -0,0 +1,49 @@
+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 robots meta UI 연동', () => {
+ beforeEach(() => {
+ window.__exportPreview = undefined
+ })
+
+ it('기본값에서는 robots meta가 존재하지 않는다', async () => {
+ render(
+
+
+
+ )
+ // Hero 추가(렌더 내용 명확화)
+ const addHeroBtn = screen.getByTestId('btn-add-hero')
+ addHeroBtn.click()
+
+ expect(typeof window.__exportPreview).toBe('function')
+ await waitFor(() => {
+ const out = window.__exportPreview!()
+ expect(out.html).not.toContain(' {
+ render(
+
+
+
+ )
+ const addHeroBtn = screen.getByTestId('btn-add-hero')
+ addHeroBtn.click()
+
+ const robotsInput = screen.getByLabelText('Robots Meta') as HTMLInputElement
+ fireEvent.change(robotsInput, { target: { value: 'noindex, nofollow' } })
+
+ await waitFor(() => {
+ const out = window.__exportPreview!()
+ expect(out.html).toContain(' ('')
const [manifestThemeColor, setManifestThemeColor] = useState('')
const [robotsDisallow, setRobotsDisallow] = useState('')
+ const [robotsMeta, setRobotsMeta] = useState('')
const [sheetsMode, setSheetsMode] = useState<'auto' | 'include' | 'exclude'>('auto')
const [assetPathStrategy, setAssetPathStrategy] = useState<'flat' | 'grouped'>('flat')
// Font optimization: allow toggling Google Fonts preconnect links in exported HTML
const [fontPreconnect, setFontPreconnect] = useState(true)
+ const [fontPreload, setFontPreload] = useState(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 +198,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, robotsMeta: robotsMeta.trim() || undefined })
} catch {
const fixed: Page = {
...pageData,
@@ -204,12 +208,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, robotsMeta: robotsMeta.trim() || undefined })
}
}
}
} catch {}
- }, [pageData, am, fontPreconnect, assetPathStrategy])
+ }, [pageData, am, fontPreconnect, fontPreload, imageLoading, imageDecoding, robotsMeta, assetPathStrategy])
const doExport = useCallback(async () => {
let valid = pageData as Page
@@ -237,8 +241,8 @@ export default function BuilderClientPage() {
}
return clone
}
- // Respect font optimization toggle when exporting
- const exported = exportPage(valid, { assetManager: buildEffectiveAm(), fontPreconnect })
+ // Respect font, image, robots meta optimization toggles when exporting
+ const exported = exportPage(valid, { assetManager: buildEffectiveAm(), fontPreconnect, fontPreload, imageLoading, imageDecoding, robotsMeta: robotsMeta.trim() || undefined })
try {
if (typeof window !== 'undefined') {
const w = window as unknown as { __captureExport?: boolean; __lastExport?: { html: string; css: string; js: string } }
@@ -285,7 +289,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, robotsMeta, assetPathStrategy])
return (
@@ -375,6 +379,44 @@ export default function BuilderClientPage() {
/>
Enable font preconnect (Google Fonts)
+
+ setFontPreload(e.target.checked)}
+ />
+ Enable font preload (Google Fonts)
+
+
+
+ Image Loading
+ setImageLoading(e.target.value as 'lazy' | 'eager')}
+ >
+ Image Loading: lazy
+ Image Loading: eager
+
+
+
+ Image Decoding
+ setImageDecoding(e.target.value as 'async' | 'sync')}
+ >
+ Image Decoding: async
+ Image Decoding: sync
+
+
+
Manifest Name
+
+ Robots Meta
+ setRobotsMeta(e.target.value)}
+ placeholder="noindex, nofollow"
+ />
+
Google Sheets Template Mode
{
+ 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/)
+ })
+})
diff --git a/lib/exporter/html.ts b/lib/exporter/html.ts
index 14c1932..69409c1 100644
--- a/lib/exporter/html.ts
+++ b/lib/exporter/html.ts
@@ -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 }
+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 `
@@ -124,7 +133,7 @@ function renderHero(section: { props: { heading: string; subheading?: string; im
${subheading.length > 0 ? `
${escapeHtml(subheading)}
` : ''}
@@ -251,14 +260,22 @@ 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) ? ` ` : ''
+ 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 `
${preconnect ? ' ' : ''}
${preconnect ? ' ' : ''}
+ ${fontPreload && fontHref ? ` ` : ''}
+ ${fontPreload && fontHref ? ` ` : ''}
+ ${fontPreload && fontHref ? ` ` : ''}
+ ${robotsMeta}
${escapeHtml(page.seo.title)}
diff --git a/lib/exporter/image.loading.toggle.test.ts b/lib/exporter/image.loading.toggle.test.ts
new file mode 100644
index 0000000..022b892
--- /dev/null
+++ b/lib/exporter/image.loading.toggle.test.ts
@@ -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"')
+ })
+})
diff --git a/lib/exporter/robots.meta.tag.test.ts b/lib/exporter/robots.meta.tag.test.ts
new file mode 100644
index 0000000..ca44dd3
--- /dev/null
+++ b/lib/exporter/robots.meta.tag.test.ts
@@ -0,0 +1,29 @@
+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: 'Meta Robots',
+ 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('meta robots', () => {
+ it('기본적으로 head에 robots 메타가 없다', () => {
+ const page = makePage()
+ const out = exportPage(page)
+ expect(out.html).not.toContain(' {
+ const page = makePage()
+ const opts: ExportOptions = { robotsMeta: 'noindex,nofollow' }
+ const out = exportPage(page, opts)
+ expect(out.html).toContain(' ')
+ })
+})