01
DROP YOUR DOC.
Upload a PDF, Word file, Markdown, or plain text. Or just paste in your content.
- LET’S TURN
+
+
GOT A DOCUMENT?
DOC2FAQ
- DOCUMENT INTELLIGENCE / PREVIEW @project.version@
-Turn long documents into clear answers.
+✳ WELCOME TO DOC2FAQ / @project.version@
+LET’S TURN
PAGES INTO ANSWERS.
Extract questions already in your document or turn ordinary sections into source-grounded FAQ suggestions. Review, edit, and export your draft.
✦ No account✦ No AI calls✦ Review before sharing
diff --git a/src/main/resources/static/retro.css b/src/main/resources/static/retro.css
new file mode 100644
index 0000000..1a5fff0
--- /dev/null
+++ b/src/main/resources/static/retro.css
@@ -0,0 +1,22 @@
+/* Concept skin. The existing Doc2FAQ browser engine and workflow stay intact. */
+:root{color-scheme:light;--bg:#f0f3f1;--surface:#fffefa;--surface2:#fff7e6;--line:#26333b;--muted:#5e6a72;--text:#202b34;--mint:#ec9179;--gold:#b76549;--danger:#a43232;font-family:'DM Sans',system-ui,sans-serif}
+html{scroll-behavior:smooth}body{background:#f0f3f1;color:var(--text)}body::before,#ambient-background{display:none!important}
+button,input,select,textarea{font-family:'DM Sans',system-ui,sans-serif}button:focus-visible,input:focus-visible,textarea:focus-visible,select:focus-visible,a:focus-visible{outline:3px solid #dc7054;outline-offset:3px}
+.app-shell{max-width:1330px;padding:0 34px}.site-header{height:92px;border-bottom:3px solid var(--line);gap:20px}.brand{font-family:'Space Grotesk',sans-serif;font-size:27px;font-weight:700;letter-spacing:-.075em;color:var(--text)}.brand-mark{background:#f9d77b;color:var(--text);border:2px solid var(--line);border-radius:8px;box-shadow:3px 3px 0 var(--line);transform:rotate(-5deg)}.brand-accent{color:#e9866d}
+.retro-nav{margin-left:auto;display:flex;gap:24px;align-items:center;font-size:12px;font-weight:900;letter-spacing:.02em}.retro-nav a{text-decoration:none}.retro-nav a:hover{text-decoration:underline;text-underline-offset:4px}.preview-pill{border:2px solid var(--line);border-radius:7px;background:#f8d77b;color:var(--text);font-size:10px;font-weight:900;box-shadow:3px 3px 0 var(--line)}.signal-dot{background:#6dc59b;box-shadow:none;border:1px solid var(--line)}
+.hero{padding:66px 0 76px;gap:70px;grid-template-columns:1.15fr .85fr}.hero .eyebrow{color:#ad634f;font-weight:900;letter-spacing:.12em;margin-bottom:17px}.hero h1{font-family:'DM Sans',sans-serif;font-size:clamp(49px,5.5vw,80px);font-weight:900;letter-spacing:-.08em;line-height:1.06;max-width:740px}.hero h1 em{color:#df806b;font-weight:900}.hero-copy{color:#54636b;font-size:16px;line-height:1.7;margin:22px 0}.hero-chips{color:#3d4e55;font-size:12px;font-weight:700}.hero-chips span{display:inline-flex;align-items:center;background:#e0e9e4;border:1px solid #b5c4bf;padding:7px 11px;border-radius:20px}
+.hero-art{border:3px solid var(--line);border-radius:12px;background:#f9d777;box-shadow:11px 12px 0 var(--line);transform:rotate(3deg);padding:25px}.art-top,.art-bottom{color:#344851}.art-skeleton{background:#d9b85f}.art-question,.art-answer{border:2px solid var(--line);border-radius:7px;background:#fffefa;color:var(--text);font-weight:700;box-shadow:3px 3px 0 #202b3423}.art-answer{background:#b4dbd0;color:var(--text)}.art-question span{background:#f9b19d;color:var(--text);border:1px solid var(--line)}.art-answer span{background:#f8e2a3;color:var(--text);border:1px solid var(--line)}.art-bottom{border-color:#9e8345}.art-bottom span:last-child{color:#344851}
+.demo-links{gap:12px;margin:0 0 18px}.demo-disclosure{color:#68737c;font-size:12px}.demo-disclosure a{color:#995f4e;text-decoration:underline}
+.workspace{border-top:3px solid var(--line);padding-top:44px}.workspace-heading{margin-bottom:27px}.workspace-heading .eyebrow{color:#a85e4a}.workspace h2{font-family:'DM Sans',sans-serif;font-size:35px;font-weight:900;letter-spacing:-.07em}.step-number{color:#67747a;font-weight:900}
+.project-toolbar{border:2px solid var(--line);border-radius:10px;background:#fbe7b9;padding:21px;gap:12px;box-shadow:4px 5px 0 var(--line)}.project-name input,.mode-select,.export-select,.result-actions input,.review-filters select,.review-status-select,.faq-edit-question,.faq-edit-answer,.download-name-field,input#search-input,textarea{background:#fffefa;color:var(--text);border:2px solid #374751;border-radius:7px}.project-name input{min-height:42px}.project-toolbar .field-label{color:#34434c}.save-work-help,.autosave-controls,.field-help{color:#66727b}.autosave-controls input,.export-options input{accent-color:#e68b73}
+.panel{border:3px solid var(--line);border-radius:12px;background:#fffefa;box-shadow:7px 8px 0 var(--line);padding:27px}.workspace-grid{gap:29px;margin-bottom:32px}.step-label{display:inline-block;background:#f5d97b;padding:6px 10px;border:2px solid var(--line);border-radius:5px;color:var(--text);font-weight:900}.panel h3{font-size:23px;font-weight:900;letter-spacing:-.055em;margin-top:14px}.panel-intro,.mode-description{color:#53636c;font-size:12px}.panel-intro code{color:#8d4f3f;background:#fcead6}.file-symbol{color:#df806b}.field-label{color:#37454d;font-weight:900}.input-meta,.source-filename{color:#66737b}textarea::placeholder{color:#8a969b}
+.button{border:2px solid var(--line);border-radius:7px;padding:11px 14px;font-weight:900;box-shadow:2px 3px 0 var(--line);transition:transform .18s,box-shadow .18s}.button:not(:disabled):hover{transform:translate(1px,1px);box-shadow:1px 2px 0 var(--line)}.button-primary{background:#f69e84;color:var(--text)}.button-primary:hover{background:#ffa98e}.button-secondary{background:#fffefa;color:var(--text)}.button-secondary:hover{background:#f4e5c5}.button-quiet{color:#7f493d;box-shadow:none;border:0;background:transparent;padding:7px 8px}.button:disabled{box-shadow:none;opacity:.44}.status{color:#59666d}.status.success{color:#247554}.status.error{color:#a43232}
+.count{color:var(--text);background:#add8ca;border:2px solid var(--line);border-radius:6px;font-weight:900}.result-actions input{color:var(--text);background:#fffefa}.result-actions input:disabled{opacity:.5}.review-toolbar .button{color:#874b3f}.export-options{color:#5e6a72}.empty-state{border:2px dashed #8c9c9d;border-radius:8px;background:#f9f8f0}.empty-icon{background:#f9d779;border:2px solid var(--line);color:var(--text);box-shadow:3px 3px 0 var(--line)}.empty-state p{color:#647179}
+.faq-editor,.faq-item{border:2px solid var(--line);border-radius:8px;background:#f5f8f5}.faq-editor-index{color:#925643;font-weight:900}.faq-editor .field-label{color:#3e4b52}.editor-action{background:#fffefa;color:var(--text);border:1px solid #374751;border-radius:5px}.editor-action:hover{background:#fce5bd}.editor-action.editor-remove{color:#ad3434}.faq-edit-question{font-weight:750}.faq-edit-answer{color:var(--text)}.faq-item p{color:#52616a;border-color:#bdc9c6}.faq-item summary::after{color:#e08b74}
+.review-filters .field-label{color:#303e47}.source-badge{color:#8d4e33}.source-details,.similar-review{border-color:#cbd4d1}.source-details summary,.similar-review summary{color:#89513f}.source-details pre,.source-viewer-content{color:#3d4c54;background:#f2f2eb}.source-viewer{background:#f4f5ec;border:2px solid var(--line)}.source-line-number{color:#78868b}.source-line-selected{background:#bdebdc;border-color:#619c86}.source-line mark{color:#244538}.download-name-field{background:#fffefa;color:var(--text);border:2px solid var(--line)}.download-name-field input{color:var(--text)}.download-name-field span{color:#925440;border-color:#a9b5b1}
+.footnote{border:2px solid var(--line);background:#e0eae3;border-radius:10px;margin:44px 0 60px}.footnote-icon{color:var(--text);border:2px solid var(--line);font-weight:900}.footnote p{color:#4f5d63}.footnote strong{color:var(--text)}.site-footer{border-top:3px solid var(--line);color:#647078;font-weight:800;padding-bottom:45px}.site-footer a{text-decoration:underline;text-underline-offset:3px}
+#export-preview{background:#fffefa;color:var(--text);border:3px solid var(--line);border-radius:12px;box-shadow:9px 10px 0 var(--line)}#export-preview::backdrop{background:#23313ab3}.preview-note{color:#526069}#preview-content{border:2px solid #d6deda}
+@media(max-width:1100px){.retro-nav{gap:12px}.preview-pill{font-size:9px}.hero{gap:35px}.panel{padding:22px}.workspace-grid{gap:21px}}
+@media(max-width:800px){.app-shell{padding:0 22px}.site-header{height:auto;min-height:89px;flex-wrap:wrap;padding:15px 0}.preview-pill{order:3;width:100%;justify-content:center}.hero{grid-template-columns:1fr;gap:40px}.hero-art{max-width:520px}.workspace-grid{grid-template-columns:1fr}.results-list{max-height:none}}
+@media(max-width:520px){.app-shell{padding:0 16px}.brand{font-size:24px}.retro-nav{font-size:10px;gap:10px}.hero{padding:52px 0}.hero h1{font-size:47px}.hero-copy{font-size:14px}.hero-art{display:none}.workspace h2{font-size:28px}.panel{padding:17px;box-shadow:4px 5px 0 var(--line)}.result-actions{display:grid;grid-template-columns:1fr 1fr}.result-actions input{grid-column:1/-1}.result-actions .export-select{grid-column:1/-1}.result-actions button{white-space:normal}.field-label{letter-spacing:.08em}.review-filters{align-items:flex-start}.review-toolbar{gap:6px}}
+@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}.button{transition:none}}
diff --git a/website/index.html b/website/index.html
new file mode 100644
index 0000000..b54f486
--- /dev/null
+++ b/website/index.html
@@ -0,0 +1,81 @@
+
+
+
+
+
+
+
+ Doc2FAQ — Make sense of every document
+
+
+
+
+
+
+
+ DOC2FAQ.
+
+ TRY THE DEMO
+
+
+
+
+
+
+
+
+
+
+ ALL YOUR ANSWERS.
+
+
+
+
+ GOT A DOCUMENT?
+
+
+
diff --git a/website/styles.css b/website/styles.css
new file mode 100644
index 0000000..6fc6c7d
--- /dev/null
+++ b/website/styles.css
@@ -0,0 +1,13 @@
+:root{--ink:#202b34;--paper:#f0f3f1;--cream:#fffcf5;--coral:#f7a088;--yellow:#f8d77b;--mint:#a8d6c8;--white:#fffefa;--border:3px solid var(--ink);font-family:'DM Sans',system-ui,sans-serif;color:var(--ink);background:var(--paper)}
+*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;overflow-x:hidden}a{color:inherit;text-decoration:none}button,input{font:inherit}a:focus-visible{outline:4px solid #b65c37;outline-offset:5px}.shell{max-width:1290px;width:calc(100% - 80px);margin-inline:auto}
+.announcement{display:flex;align-items:center;justify-content:center;gap:12px;padding:10px 16px;background:var(--ink);color:#f8faf7;font-size:12px;font-weight:700;letter-spacing:.025em;text-align:center}.live-dot{width:9px;height:9px;background:#a4e7ae;border-radius:50%;box-shadow:0 0 0 4px #a4e7ae23}.announcement-sticker{color:var(--yellow);font-weight:900;letter-spacing:.1em}
+.site-nav{height:102px;display:flex;align-items:center;justify-content:space-between;gap:26px;border-bottom:2px solid #273039}.logo{display:inline-flex;align-items:center;gap:3px;flex-shrink:0;font-family:'Space Grotesk',sans-serif;font-weight:700;font-size:29px;letter-spacing:-.07em}.logo>span:not(.logo-page){color:#e8836f}.logo .logo-period{color:var(--ink)!important}.logo-page{position:relative;display:grid;place-items:center;width:36px;height:43px;border:3px solid var(--ink);border-radius:5px 11px 5px 5px;transform:rotate(-9deg);margin-right:10px;background:var(--yellow);box-shadow:3px 3px 0 var(--ink)}.logo-page span{font-size:23px;line-height:1;transform:rotate(9deg)}.nav-links{display:flex;gap:36px;align-items:center;font-size:14px;font-weight:800}.nav-links a:hover{text-decoration:underline;text-underline-offset:5px}.nav-cta{border:var(--border);background:var(--yellow);box-shadow:4px 5px 0 var(--ink);border-radius:9px;padding:13px 19px;font-size:12px;font-weight:900;white-space:nowrap;letter-spacing:.02em;transition:transform .18s,box-shadow .18s}.nav-cta:hover{transform:translate(2px,2px);box-shadow:2px 3px 0 var(--ink)}
+.hero{position:relative;text-align:center;min-height:755px;padding-top:38px;padding-bottom:90px}.hero-inner{position:relative;z-index:1}.mascot-zone{height:224px;position:relative;width:min(100%,380px);margin:0 auto}.mascot{display:block;width:250px;height:214px;margin:0 auto;filter:drop-shadow(10px 12px 0 #b7d5cd);animation:bounce 4.6s ease-in-out infinite}.mascot-speech{position:absolute;font-size:10px;letter-spacing:.1em;font-weight:900;top:42px;right:-31px;transform:rotate(13deg);border:2px solid var(--ink);border-radius:99px;padding:8px 13px;background:var(--cream);box-shadow:3px 3px 0 var(--ink)}.sketch-star{position:absolute;color:var(--ink);font-size:40px}.star-one{top:35px;left:5px;transform:rotate(-22deg)}.star-two{right:8px;bottom:30px;color:#ec9b79;font-size:34px}.hero-eyebrow,.section-kicker{display:flex;gap:16px;justify-content:center;align-items:center;font-size:12px;font-weight:900;letter-spacing:.19em}.eyebrow-rule{display:block;width:24px;height:3px;background:var(--ink)}.hero-title{font-size:clamp(78px,13.8vw,200px);letter-spacing:-.094em;line-height:1;margin:-7px 0 0;padding-right:.08em;font-family:'Space Grotesk',sans-serif;font-weight:700;color:#f6f8f7;-webkit-text-stroke:5px var(--ink);paint-order:stroke fill;text-shadow:5px 5px 0 var(--ink),9px 9px 0 var(--ink),13px 13px 0 var(--ink)}.hero-title span{color:var(--coral)}.hero-title .period{color:var(--yellow)}.hero-lede{font-size:clamp(23px,3vw,41px);font-weight:900;letter-spacing:-.06em;margin:37px 0 9px;line-height:1.14}.hero-lede em{font-style:normal;color:#e87e66}.hero-copy{font-size:17px;line-height:1.65;max-width:710px;margin:0 auto 29px;color:#49555e}.hero-buttons{display:flex;align-items:center;justify-content:center;gap:17px;flex-wrap:wrap}.comic-button{display:inline-flex;align-items:center;justify-content:center;gap:30px;padding:17px 24px;min-height:60px;border:var(--border);border-radius:9px;font-size:13px;font-weight:900;letter-spacing:.02em;box-shadow:5px 6px 0 var(--ink);transition:transform .18s,box-shadow .18s}.comic-button:hover{transform:translate(2px,3px);box-shadow:3px 3px 0 var(--ink)}.comic-button span:last-child{font-size:23px;line-height:0}.comic-button.primary{background:var(--coral)}.comic-button.light,.comic-button.cream{background:var(--cream)}.hero-footnote{margin:27px auto 0;display:flex;align-items:center;justify-content:center;gap:12px;font-size:12px;font-weight:700;color:#59646b}.mini-check{font-size:14px;background:#9dd6c2;border:2px solid var(--ink);width:22px;height:22px;border-radius:50%;display:inline-grid;place-items:center;color:var(--ink)}.interpunct{font-weight:900}.hero-bottom-doodle{position:absolute;right:12px;bottom:19px;color:#e28f7d;letter-spacing:10px;font-size:20px;transform:rotate(18deg)}
+.how-it-works{padding:90px 0 120px;border-top:var(--border);border-bottom:var(--border);background:#fffdf6}.section-head{display:flex;align-items:end;justify-content:space-between;gap:55px;margin-bottom:43px}.section-head .section-kicker,.peek-copy .section-kicker{display:block;letter-spacing:.14em;font-size:11px;margin:0 0 18px;color:#bd5d4d}.section-head h2,.peek-copy h2{font-weight:900;letter-spacing:-.075em;line-height:1.08;font-size:clamp(42px,5.5vw,73px);margin:0}.section-head h2 span{color:#e58c72}.section-head>p{font-size:17px;line-height:1.7;color:#56626b;max-width:345px;margin:0 0 6px}.feature-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:30px}.feature-card{border:var(--border);border-radius:12px;box-shadow:8px 9px 0 var(--ink);overflow:hidden;transition:transform .23s,box-shadow .23s}.feature-card:hover{transform:translateY(-5px);box-shadow:8px 14px 0 var(--ink)}.feature-illustration{position:relative;height:226px;display:grid;place-items:center;border-bottom:var(--border)}.feature-card.pink .feature-illustration{background:#f9c4b6}.feature-card.yellow .feature-illustration{background:#f8dd8c}.feature-card.mint .feature-illustration{background:#addccf}.feature-illustration svg{width:235px;max-width:90%;height:auto;filter:drop-shadow(2px 4px 0 #202b3428)}.feature-number{position:absolute;top:16px;left:18px;border:2px solid var(--ink);padding:5px 8px;border-radius:5px;background:#fffcf5;font-size:11px;font-weight:900;box-shadow:2px 2px 0 var(--ink)}.feature-content{min-height:217px;position:relative;padding:28px 27px;background:var(--white)}.feature-content h3{font-size:22px;line-height:1.1;font-weight:900;letter-spacing:-.05em;margin:0 0 14px}.feature-content p{font-size:14px;line-height:1.65;margin:0;max-width:280px;color:#535e66}.feature-arrow{position:absolute;bottom:20px;right:21px;font-size:24px}
+.peek-section{padding-top:135px;padding-bottom:145px}.peek-top{display:flex;justify-content:space-between;align-items:center;margin:0 15px 26px}.scribble{font-size:14px;letter-spacing:.13em;font-weight:900;transform:rotate(-5deg)}.sticker{position:relative;transform:rotate(7deg);border:var(--border);border-radius:50%;width:104px;height:104px;display:grid;place-items:center;text-align:center;font-weight:900;font-size:13px;line-height:1.15;letter-spacing:.04em;background:var(--yellow);box-shadow:5px 5px 0 var(--ink)}.sticker span{position:absolute;bottom:16px;font-size:18px}.peek-grid{display:grid;grid-template-columns:.87fr 1.13fr;gap:65px;align-items:center}.peek-copy h2{font-size:clamp(42px,4.4vw,64px)}.peek-copy h2 span{color:#dc8a71}.peek-copy>p:not(.section-kicker){font-size:16px;line-height:1.75;max-width:510px;color:#56616a;margin:25px 0}.peek-copy ul{list-style:none;padding:0;margin:0 0 32px;display:grid;gap:15px;font-size:15px;font-weight:800}.peek-copy li{display:flex;align-items:center;gap:12px}.peek-copy li span{width:28px;height:28px;border:2px solid var(--ink);border-radius:50%;background:var(--mint);display:grid;place-items:center;font-weight:900}.window-wrap{position:relative;transform:rotate(2deg);padding:10px}.window-wrap:before{content:'';position:absolute;inset:40px -8px -7px 40px;background:var(--coral);border:var(--border);border-radius:16px;transform:rotate(3deg)}.window{position:relative;border:var(--border);border-radius:15px;background:var(--cream);box-shadow:12px 15px 0 var(--ink);overflow:hidden}.window-bar{height:58px;padding:0 18px;display:flex;align-items:center;justify-content:space-between;border-bottom:var(--border);background:var(--yellow);font-size:13px;font-weight:900;letter-spacing:.04em}.dots{display:flex;gap:6px}.dots span{width:12px;height:12px;border:2px solid var(--ink);background:var(--coral);border-radius:50%}.dots span:nth-child(2){background:#fff9e3}.dots span:nth-child(3){background:var(--mint)}.window-body{padding:24px;display:grid;grid-template-columns:1fr 1fr;gap:14px}.fake-panel{min-height:320px;border:2px solid var(--ink);background:#fff;padding:17px 13px;border-radius:7px;min-width:0}.fake-label{font-size:10px;font-weight:900;letter-spacing:.07em}.fake-doc{margin:25px 2px 28px}.fake-doc-line{width:82%;height:10px;background:#dfe6e4;margin-bottom:14px;border-radius:5px}.fake-doc-line.long{width:100%}.fake-doc-line.mid{width:70%}.fake-doc-line.short{width:44%}.fake-action{padding:11px 6px;text-align:center;background:var(--coral);border:2px solid var(--ink);border-radius:6px;font-size:10px;font-weight:900;box-shadow:3px 3px 0 var(--ink)}.fake-faq{display:flex;align-items:center;gap:8px;padding:15px 7px;margin-top:17px;background:#e4f5ee;border:2px solid var(--ink);border-radius:6px;font-size:10px;font-weight:800}.fake-faq.second{margin-top:8px;background:#fff4cb}.fake-faq b{font-size:20px}.fake-export{margin-top:22px;font-size:11px;font-weight:900}.fake-export span{margin-left:5px;padding:6px;background:#ecefeb;border:1px solid #cad0cc;border-radius:3px}
+.bottom-cta{background:var(--coral);border-top:var(--border);border-bottom:var(--border)}.bottom-cta-inner{min-height:475px;display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;position:relative;padding:75px 0}.bottom-cta h2{font-size:clamp(46px,6vw,88px);letter-spacing:-.08em;line-height:1.04;margin:0;font-weight:900}.bottom-cta h2 em{font-style:normal;color:#fffcf4;text-shadow:3px 3px 0 var(--ink),-2px -2px 0 var(--ink);-webkit-text-stroke:2px var(--ink);paint-order:stroke fill}.bottom-cta p{font-size:16px;margin:25px auto 32px;max-width:460px;line-height:1.6}.cta-star{position:absolute;top:65px;left:45px;font-size:57px}.cta-star.end{top:auto;left:auto;right:43px;bottom:62px;font-size:35px}.footer{display:grid;grid-template-columns:1fr 1fr;gap:30px;padding-top:62px;padding-bottom:30px}.footer>div:first-child>p{font-size:14px;color:#606d75}.footer-links{display:flex;justify-content:flex-end;gap:24px;flex-wrap:wrap;align-items:start;font-size:13px;font-weight:800;padding-top:15px}.footer-links a:hover{text-decoration:underline}.copyright{grid-column:1/-1;display:flex;justify-content:space-between;border-top:2px solid #cbd2cd;margin:38px 0 0;padding-top:20px;font-size:11px;font-weight:900;letter-spacing:.08em;color:#6b747a}.copyright span{margin-left:auto;margin-right:auto}
+@keyframes bounce{0%,100%{transform:translateY(0) rotate(-3deg)}50%{transform:translateY(-10px) rotate(1deg)}}
+@media(max-width:1050px){.shell{width:calc(100% - 48px)}.nav-links{gap:18px}.hero-title{-webkit-text-stroke:4px var(--ink)}.peek-grid{gap:30px}.feature-grid{gap:18px}.feature-content{padding:24px 19px}.feature-content h3{font-size:20px}.window-body{padding:12px;gap:9px}.fake-panel{padding:13px 9px}.fake-export span{font-size:9px}}
+@media(max-width:760px){.announcement{font-size:10px}.announcement-sticker{display:none}.site-nav{height:88px}.nav-links{display:none}.logo{font-size:24px}.nav-cta{padding:11px;font-size:10px}.hero{min-height:0;padding:36px 0 82px}.mascot-zone{height:200px}.mascot{width:216px;height:194px}.mascot-speech{right:0;top:18px;font-size:8px}.hero-title{font-size:clamp(64px,15vw,118px);-webkit-text-stroke:3px var(--ink);text-shadow:3px 3px 0 var(--ink),6px 6px 0 var(--ink),9px 9px 0 var(--ink)}.hero-lede{margin-top:32px}.hero-copy{font-size:15px}.hero-footnote{font-size:10px;gap:8px}.section-head{display:block}.section-head>p{max-width:unset;margin-top:20px}.feature-grid{grid-template-columns:1fr;max-width:480px;margin:auto;gap:30px}.feature-illustration{height:195px}.feature-content{min-height:175px}.feature-content p{max-width:90%}.how-it-works{padding:75px 0 90px}.peek-section{padding-top:75px;padding-bottom:95px}.peek-grid{grid-template-columns:1fr;gap:65px}.window-wrap{max-width:620px}.bottom-cta-inner{min-height:390px}.cta-star{top:23px;left:0}.cta-star.end{right:4px;bottom:32px}.footer{grid-template-columns:1fr}.footer-links{justify-content:flex-start;padding:0}}
+@media(max-width:480px){.shell{width:calc(100% - 34px)}.logo{font-size:21px}.logo-page{width:30px;height:35px;margin-right:6px}.nav-cta{font-size:9px;padding:9px}.hero-title{font-size:15vw}.hero-lede{font-size:23px}.hero-copy{font-size:14px}.comic-button{width:100%;min-height:55px}.hero-buttons{gap:15px}.hero-footnote{flex-wrap:wrap}.section-head h2,.peek-copy h2{font-size:43px}.feature-content h3{font-size:21px}.sticker{width:90px;height:90px;font-size:11px}.window-body{grid-template-columns:1fr}.fake-panel{min-height:200px}.fake-doc{margin:15px 0}.fake-doc-line{margin-bottom:10px}.bottom-cta h2{font-size:45px}.copyright{font-size:9px}}
+@media(prefers-reduced-motion:reduce){*,*::before,*::after{animation:none!important;scroll-behavior:auto!important;transition:none!important}}
From 9ae06b16e0113acfb1a24dea83de88a1a0340b59 Mon Sep 17 00:00:00 2001
From: OKAN TIKTAS <346542017+OKAN-SOFTWARE@users.noreply.github.com>
Date: Sun, 8 Nov 2026 07:00:34 -0500
Subject: [PATCH 2/6] =?UTF-8?q?docs(ci):=20verify=20Java=2021=E2=80=9326?=
=?UTF-8?q?=20and=20add=20v0.5.0=20design=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/ci.yml | 2 +-
CHANGELOG.md | 3 ++-
README.md | 4 +++-
docs/DESIGN-SYSTEM.md | 5 +++++
docs/RELEASING.md | 3 ++-
scripts/verify-website-build.mjs | 5 +++++
website/index.html | 16 ++++++++++++++++
website/styles.css | 5 +++--
8 files changed, 37 insertions(+), 6 deletions(-)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 09890de..8120586 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -18,7 +18,7 @@ jobs:
fail-fast: false
max-parallel: 2
matrix:
- java: ['21', '22', '23', '24', '25', '26', '27']
+ java: ['21', '22', '23', '24', '25', '26']
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0e05583..53535ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,7 +7,7 @@ All notable Doc2FAQ changes are recorded here. Version numbers follow semantic v
### Added
- Browser PDF/Word (.docx) import and paginated export with local processing, PDF page/file/text limits, bounded DOCX XML decompression, optional references, and clear unsupported-file/font errors.
- Browser-only website demo built from the shared frontend, with simplified text drafting, explicit PDF/Word limitations, homepage navigation, and text exports.
-- Approved Doc2FAQ landing page and matching browser/Java workbench theme, with original document mascot, responsive cards, reduced-motion support, and a reproducible `website-dist/` build.
+- Approved Doc2FAQ landing page and matching browser/Java workbench theme, with original document mascot, responsive illustrated cards, accessible focus styles, reduced-motion support, and a reproducible `website-dist/` build. The homepage includes a "What's new" release-notes preview, clearly labeled as unreleased.
- Source & Review user guide and current documentation for development builds, schema compatibility, and v0.5.0 release preparation.
- Read-only source viewer highlighting the selected FAQ's exact original passages, with a stacked layout on narrow screens.
- Per-FAQ Needs review / Approved status, persisted in saved projects and optional browser autosave.
@@ -19,6 +19,7 @@ All notable Doc2FAQ changes are recorded here. Version numbers follow semantic v
- Filters affect only the review list; saving, export preview, and all export formats retain every FAQ in draft order.
- Export formats now open with PDF first and Word (.docx) second; the default download name uses `.pdf`.
- GitHub Actions now uses Node 24-based checkout/setup-java actions and pins Ubuntu 24.04 to avoid runner-label migration notices.
+- The v0.5.0 release gate validates **Java 21–26** with Java 21-compatible bytecode. Java 27 is deferred, not declared incompatible: an earlier CI run failed with HTTP 504 during JDK download, before Doc2FAQ tests ran.
- Release-candidate source version is 0.5.0; v0.4.0 remains the published release until the new artifacts are validated and released.
## 0.4.0 — 2026-10-29
diff --git a/README.md b/README.md
index 26b58f9..eae7f2c 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,8 @@ Created by **Okan Tiktas** · [OKAN-SOFTWARE](https://github.com/OKAN-SOFTWARE).
## Current source: v0.5.0 release candidate — Source & Review
+The **approved Doc2FAQ design** introduces a playful, illustrated homepage and a matching responsive FAQ workbench. Visit the [product homepage](https://okantiktas.com/projects/doc2faq/) for the overview or open the [interactive browser demo](https://okantiktas.com/projects/doc2faq/demo/) to try local document import, review, and export. The new design and demo are staged for deployment; the URLs may still show the earlier version until the website changes are reviewed and published. See [the v0.5.0 release notes](CHANGELOG.md#050--unreleased-release-candidate) for the complete changes and [the design system](docs/DESIGN-SYSTEM.md) for colors, components, and accessibility choices.
+
- **Source beside answer:** select **View source beside answer** on an FAQ to highlight all of its original passages in a read-only document viewer beside the review editor on desktop (stacked on smaller screens). References still use extracted-text lines, not PDF page numbers. Manual FAQs have no automatic reference.
- **Review status:** FAQs start as **Needs review**. Mark a complete answer **Approved** after checking it. Editing its question or answer, or merging FAQs, returns it to **Needs review**. Moving an item preserves approval; Undo restores the status from before a removal or merge.
- **Search and review filters:** combine a case-insensitive question/answer search with **All statuses**, **Needs review**, or **Approved**. The summary shows visible, approved, and pending counts. **Clear filters** restores the full list. Filters never change what is saved, previewed, or exported: all FAQs remain included, and incomplete entries still block export.
@@ -60,7 +62,7 @@ For detailed changes, see [CHANGELOG.md](CHANGELOG.md). For the release checklis
## Requirements
-- To run a release download: **Java 21 or newer**. The JAR targets Java 21 bytecode; GitHub Actions checks the released JDK versions 21–27 before v0.5.0 publication. Newer future Java versions are not automatically guaranteed compatible. The JAR works on Windows, macOS, and Linux; the Windows ZIP includes `Start-Doc2FAQ.cmd` and a quick-start guide. Extract the ZIP into a new folder, stop any older Doc2FAQ process, run the launcher, and open **http://localhost:8080**. Maven and Node.js are only needed to build and test from source.
+- To run a release download: **Java 21 or newer**. The JAR targets Java 21 bytecode; v0.5.0's **required automated compatibility matrix is Java 21–26**. Java 27 is **not yet part of the verified support matrix**; this does not mean the application is known to be incompatible, only that its validation is deferred to a later release. Newer Java versions are not automatically guaranteed compatible. The JAR works on Windows, macOS, and Linux; the Windows ZIP includes `Start-Doc2FAQ.cmd` and a quick-start guide. Extract the ZIP into a new folder, stop any older Doc2FAQ process, run the launcher, and open **http://localhost:8080**. Maven and Node.js are only needed to build and test from source.
To build from source:
diff --git a/docs/DESIGN-SYSTEM.md b/docs/DESIGN-SYSTEM.md
index 9b9bfdf..100aaad 100644
--- a/docs/DESIGN-SYSTEM.md
+++ b/docs/DESIGN-SYSTEM.md
@@ -13,6 +13,11 @@ was approved by project owner Okan Tiktas for future versions of Doc2FAQ.
5. Direct workflow: import → generate/extract → review → export.
6. Real functionality first: responsive controls, visible keyboard focus,
sufficient text contrast, and reduced-motion support.
+7. A visible **What's new** area may preview unreleased changes, but must
+ distinguish the release candidate from the latest published download.
+8. Preserve the native right-click menu, text selection, keyboard shortcuts,
+ and browser developer tools. Hiding them does not protect application code
+ or document data; security checks belong on the server, where applicable.
## Palette
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
index bcc0ed8..2e200e0 100644
--- a/docs/RELEASING.md
+++ b/docs/RELEASING.md
@@ -4,7 +4,7 @@
## Validate the release candidate
-Use JDK 21+, Maven 3.6.3+, and Node.js. CI compiles the application for Java 21 and runs Java tests plus a packaged-JAR smoke check on JDKs 21 through 27. All matrix jobs must succeed before publication:
+Use JDK 21+, Maven 3.6.3+, and Node.js. CI compiles the application for Java 21 and runs Java tests plus a packaged-JAR smoke check on **JDKs 21 through 26**. All six required matrix jobs must succeed before publication. Java 27 is currently outside the verified release matrix; a previous Java 27 CI job failed while retrieving the Temurin JDK with **HTTP 504 before Maven or application tests started**. That failure does not establish an application incompatibility. Revisit Java 27 validation in a future release:
```cmd
mvn -B -ntp clean verify
@@ -34,6 +34,7 @@ GitHub Actions runs this smoke check on every push/PR. On Windows without Bash,
9. Import `TEst Data.pdf`, check the suggested `testdata-Doc2FAQ.pdf`, rename it, and verify the download. Check centered titles, PDF Lato fonts, page numbers, long answers/tokens, Unicode, and page breaks. Unsupported PDF glyphs must suggest Word. HTML must escape document markup.
10. Change source/mode, clear the document, or open another project during pending imports/drafting/exports. Old results must not replace or download current work. Check keyboard focus, mobile widths, and reduced motion.
11. Follow [WEB-DEMO.md](WEB-DEMO.md) for the separate static browser demo; verify its feature disclosure and website links. The demo cannot substitute for packaged-JAR testing.
+12. Review the [approved homepage design](DESIGN-SYSTEM.md), including responsive layouts, readable focus states, reduced-motion behavior, and the **What's new / v0.5.0 preview** release-notes area. Confirm that an unreleased candidate is not presented as a published download. Keep browser context menus and developer tools available; browser UI restrictions are not an application security control.
## Prepare v0.5.0
diff --git a/scripts/verify-website-build.mjs b/scripts/verify-website-build.mjs
index 9a45f78..fa31beb 100644
--- a/scripts/verify-website-build.mjs
+++ b/scripts/verify-website-build.mjs
@@ -11,6 +11,11 @@ const demo = await readFile(path.join(output, 'demo/index.html'), 'utf8');
assert.match(home, /href="\.\/demo\/"/, 'Homepage opens its sibling demo');
assert.match(home, /href="\.\/styles\.css"/, 'Homepage loads styles relative to subdirectory');
assert.doesNotMatch(home, /href="\/(?:demo\/|styles\.css|)"/, 'No domain-root homepage links');
+assert.match(home, /id="whats-new"/, 'Homepage includes the release notes preview');
+assert.match(home, /v0\.5\.0 PREVIEW/, 'Unreleased version is visibly labeled');
+assert.match(home, /Release candidate — not published yet/, 'Unreleased status is explicit');
+assert.match(home, /Java 21–26/, 'Homepage reflects the required compatibility matrix');
+assert.match(home, /v0\.4\.0 is still the latest published download/, 'Latest published release is identified accurately');
assert.match(demo, /href="\.\.\/"/, 'Demo navigates back to its own homepage');
assert.match(demo, /THE INTERACTIVE PLAYGROUND/, 'Demo is branded consistently');
assert.match(demo, /id="file-input"/, 'File import remains available');
diff --git a/website/index.html b/website/index.html
index b54f486..b80434e 100644
--- a/website/index.html
+++ b/website/index.html
@@ -18,6 +18,7 @@
TRY THE DEMO
@@ -74,6 +75,21 @@
+ A little less reading, a lot more understanding. TRY DOC2FAQ ✳
+
+
+
+
+ DOCUMENTS, DECODED.
+ DOC2FAQ.
+BIG DOCUMENTS. SMALL ANSWERS.
+Too many pages? Too little time? Turn PDFs, Word docs, and plain text into organized, editable FAQs. No fuss. Just the good stuff.
+ +✓ Browser-based demo • No sign-in • No AI required
+
+ THREE STEPS.
+
+ ✳ THE MAGIC (IT’S ACTUALLY CODE)
THREE STEPS.
ZERO HEADACHES.
No more scrolling through a 40-page document to find one sentence. Here’s how you go from “where do I start?” to “done!”
+
+ 02
FIND THE GOOD BITS.
Extract written Q&As or generate draft questions from your document’s sections.
03
MAKE IT YOURS.
Review every answer, tweak the wording, then export to PDF, DOCX, or more.
SNEAK PEEK ↘
+ ACTUALLY
INTERACTIVE!★
INTERACTIVE!★
YOUR NEW FAVORITE WORKSPACE
ALL YOUR ANSWERS.
ONE HAPPY PLACE.
Behind the cheerful colors is a real document-to-FAQ workflow. Search, review, edit and export without losing track of the source.
- ✓ Two drafting modes
- ✓ Approve and refine answers
- ✓ Save and resume later
- ✓ PDF and Word exports
01 / YOUR DOCUMENT
EXTRACT FAQs ↗
02 / YOUR ANSWERS
QWhat does this document cover?
AEverything you need, in one clear place.
✓Reviewed & ready to share
PDF DOCX MARKDOWN
GOT A DOCUMENT?
WE’VE GOT THIS.
A better FAQ is only a few clicks away. Take the browser demo for a spin.
TRY DOC2FAQ FOR FREEDOC2FAQ
+
+
+
+
+
+ ✳ FRESH FROM THE WORKBENCH
WHAT'S NEW?
v0.5.0 PREVIEWRelease candidate — not published yet
+
+
+ HELLO, NEW LOOK.
A cheerful illustrated homepage and a matching, mobile-friendly workbench that keeps your document front and center.
REVIEW WITH CONFIDENCE.
See source highlights, approve answers, search your draft, and reopen saved projects for another pass.
TAKE IT WITH YOU.
Import PDF and Word files in the browser demo, then export as PDF, DOCX, Markdown, JSON, or HTML.
Java 21–26 is the planned v0.5.0 test matrix. Java 27 verification will come later. v0.4.0 is still the latest published download.
READ RELEASE NOTESGOT A DOCUMENT?
WE’VE GOT THIS.
A better FAQ is only a few clicks away. Take the browser demo for a spin.
TRY DOC2FAQ FOR FREEDOC2FAQ
REVIEW WITH CONFIDENCE.
See source highlights, approve answers, search your draft, and reopen saved projects for another pass.
TAKE IT WITH YOU.
Import PDF and Word files in the browser demo, then export as PDF, DOCX, Markdown, JSON, or HTML.
REVIEW WITH CONFIDENCE.
See source highlights, approve answers, search your draft, and reopen saved projects for another pass.
TAKE IT WITH YOU.
Import PDF and Word files in the browser demo, then export as PDF, DOCX, Markdown, JSON, or HTML.
Java 21–26 is the planned v0.5.0 test matrix. Java 27 verification will come later. v0.4.0 is still the latest published download.
READ RELEASE NOTESJava 21–26 is the required v0.5.0 test matrix. Java 27 passed a separate CI run; formal support can follow later. v0.4.0 is still the latest published download.
READ RELEASE NOTESGood to know.'); const noteEnd = html.indexOf('
', noteStart) + 4; -html = html.slice(0, noteStart) + 'Browser demo. Text processing and text exports happen on your device. Nothing you paste is sent to an FAQ server. No AI is used. This simplified demo may produce different drafts from the full Java app. Source references use text lines, not PDF pages. Optional autosave stores source and drafts in this browser; use Clear saved data on shared devices. Saved projects contain the source. PDF and Word (.docx) import/export run in your browser. Scanned PDFs need OCR, which is not included. PDF export uses standard Latin fonts; choose Word for unsupported characters. Document libraries load from a CDN when needed; your document content is not uploaded.
' + html.slice(noteEnd); +html = html.slice(0, noteStart) + 'Browser demo. Text processing and text exports happen on your device. Nothing you paste is sent to an FAQ server. No AI is used. This simplified demo may produce different drafts from the full Java app. Source references use text lines, not PDF pages. Optional autosave stores source and drafts in this browser; use Clear saved data on shared devices. Saved projects contain the source. PDF and Word (.docx) import/export run in your browser. Scanned PDFs need OCR, which is not included. PDF export embeds bundled DejaVu Sans fonts for extended Unicode coverage; unsupported scripts may still require Word. Document libraries load from a CDN when needed; your document content is not uploaded.
' + html.slice(noteEnd); html = html.replace('Try the review workflow here. The latest downloadable release may have fewer features than this development demo. Compare demo and app ↗
\nLET’S TURN
PAGES INTO ANSWERS.
Save work keeps your source and edits for later. Use Download for the finished FAQ.
-
+
Autosave off
diff --git a/src/main/resources/static/retro.css b/src/main/resources/static/retro.css
index 1a5fff0..07967d7 100644
--- a/src/main/resources/static/retro.css
+++ b/src/main/resources/static/retro.css
@@ -11,6 +11,10 @@ button,input,select,textarea{font-family:'DM Sans',system-ui,sans-serif}button:f
.project-toolbar{border:2px solid var(--line);border-radius:10px;background:#fbe7b9;padding:21px;gap:12px;box-shadow:4px 5px 0 var(--line)}.project-name input,.mode-select,.export-select,.result-actions input,.review-filters select,.review-status-select,.faq-edit-question,.faq-edit-answer,.download-name-field,input#search-input,textarea{background:#fffefa;color:var(--text);border:2px solid #374751;border-radius:7px}.project-name input{min-height:42px}.project-toolbar .field-label{color:#34434c}.save-work-help,.autosave-controls,.field-help{color:#66727b}.autosave-controls input,.export-options input{accent-color:#e68b73}
.panel{border:3px solid var(--line);border-radius:12px;background:#fffefa;box-shadow:7px 8px 0 var(--line);padding:27px}.workspace-grid{gap:29px;margin-bottom:32px}.step-label{display:inline-block;background:#f5d97b;padding:6px 10px;border:2px solid var(--line);border-radius:5px;color:var(--text);font-weight:900}.panel h3{font-size:23px;font-weight:900;letter-spacing:-.055em;margin-top:14px}.panel-intro,.mode-description{color:#53636c;font-size:12px}.panel-intro code{color:#8d4f3f;background:#fcead6}.file-symbol{color:#df806b}.field-label{color:#37454d;font-weight:900}.input-meta,.source-filename{color:#66737b}textarea::placeholder{color:#8a969b}
.button{border:2px solid var(--line);border-radius:7px;padding:11px 14px;font-weight:900;box-shadow:2px 3px 0 var(--line);transition:transform .18s,box-shadow .18s}.button:not(:disabled):hover{transform:translate(1px,1px);box-shadow:1px 2px 0 var(--line)}.button-primary{background:#f69e84;color:var(--text)}.button-primary:hover{background:#ffa98e}.button-secondary{background:#fffefa;color:var(--text)}.button-secondary:hover{background:#f4e5c5}.button-quiet{color:#7f493d;box-shadow:none;border:0;background:transparent;padding:7px 8px}.button:disabled{box-shadow:none;opacity:.44}.status{color:#59666d}.status.success{color:#247554}.status.error{color:#a43232}
+/* This is a destructive browser-storage action, not a subtle text link. */
+#clear-saved-btn{display:inline-flex;align-items:center;justify-content:center;gap:10px;min-height:43px;padding:9px 15px;border:2px solid #8d3b32;border-radius:8px;background:#ffe0d9;color:#8d2f29;font-size:12px;font-weight:900;box-shadow:3px 3px 0 #8d3b32;white-space:nowrap}
+#clear-saved-btn::before{content:"✕";display:inline-grid;place-items:center;width:22px;height:22px;border-radius:50%;background:#a53932;color:#fff;font-size:13px;font-weight:900}
+#clear-saved-btn:not(:disabled):hover{background:#ffc9bd;box-shadow:2px 2px 0 #8d3b32;transform:translate(1px,1px)}
.count{color:var(--text);background:#add8ca;border:2px solid var(--line);border-radius:6px;font-weight:900}.result-actions input{color:var(--text);background:#fffefa}.result-actions input:disabled{opacity:.5}.review-toolbar .button{color:#874b3f}.export-options{color:#5e6a72}.empty-state{border:2px dashed #8c9c9d;border-radius:8px;background:#f9f8f0}.empty-icon{background:#f9d779;border:2px solid var(--line);color:var(--text);box-shadow:3px 3px 0 var(--line)}.empty-state p{color:#647179}
.faq-editor,.faq-item{border:2px solid var(--line);border-radius:8px;background:#f5f8f5}.faq-editor-index{color:#925643;font-weight:900}.faq-editor .field-label{color:#3e4b52}.editor-action{background:#fffefa;color:var(--text);border:1px solid #374751;border-radius:5px}.editor-action:hover{background:#fce5bd}.editor-action.editor-remove{color:#ad3434}.faq-edit-question{font-weight:750}.faq-edit-answer{color:var(--text)}.faq-item p{color:#52616a;border-color:#bdc9c6}.faq-item summary::after{color:#e08b74}
.review-filters .field-label{color:#303e47}.source-badge{color:#8d4e33}.source-details,.similar-review{border-color:#cbd4d1}.source-details summary,.similar-review summary{color:#89513f}.source-details pre,.source-viewer-content{color:#3d4c54;background:#f2f2eb}.source-viewer{background:#f4f5ec;border:2px solid var(--line)}.source-line-number{color:#78868b}.source-line-selected{background:#bdebdc;border-color:#619c86}.source-line mark{color:#244538}.download-name-field{background:#fffefa;color:var(--text);border:2px solid var(--line)}.download-name-field input{color:var(--text)}.download-name-field span{color:#925440;border-color:#a9b5b1}
diff --git a/src/test/js/app-state.test.cjs b/src/test/js/app-state.test.cjs
index 12a2b3c..512a9d9 100644
--- a/src/test/js/app-state.test.cjs
+++ b/src/test/js/app-state.test.cjs
@@ -6,7 +6,7 @@ const assert = require("node:assert/strict");
const tools = require("../../main/resources/static/project.js");
const script = readFileSync(path.resolve(__dirname, "../../main/resources/static/app.js"), "utf8");
-function harness(saved = new Map(), blocked = false, fetcher = null) {
+function harness(saved = new Map(), blocked = false, fetcher = null, confirmer = () => true) {
const elements = new Map();
function node(tag = "") {
return {tag, value: "", checked: false, disabled: false, children: [], handlers: {}, textContent: "",
@@ -26,7 +26,7 @@ function harness(saved = new Map(), blocked = false, fetcher = null) {
removeItem(key) { if (blocked) throw new Error("Storage blocked"); saved.delete(key); }
};
const context = {Doc2FaqProject: tools, document: {getElementById: element, createElement: node},
- FormData: class { append() {} }, localStorage: storage, setTimeout(fn) { fn(); return 1; }, clearTimeout() {}, confirm: () => true,
+ FormData: class { append() {} }, localStorage: storage, setTimeout(fn) { fn(); return 1; }, clearTimeout() {}, confirm: confirmer,
fetch: fetcher || (async () => ({ok: true, json: async () => ({items: [{question: "Where is support?", answer: "Ask the team.",
source: {section: "Support", startLine: 1, endLine: 2, excerpt: "Q: Where is support?\nA: Ask the team."}}]})}))};
vm.runInNewContext(script, context);
@@ -75,6 +75,18 @@ test("disabling autosave removes stored text and the preference", async () => {
assert.equal(app.element("faq-count").textContent, "1 ITEM");
});
+test("canceling Clear saved data preserves the browser copy and current work", async () => {
+ const app = harness(new Map(), false, null, () => false);
+ await makeDraft(app);
+ app.element("autosave-toggle").checked = true;
+ app.element("autosave-toggle").handlers.change();
+ assert.equal(app.saved.has("doc2faq.project.v1"), true);
+ app.element("clear-saved-btn").handlers.click();
+ assert.equal(app.saved.has("doc2faq.project.v1"), true);
+ assert.equal(app.saved.get("doc2faq.autosave"), "true");
+ assert.equal(app.element("faq-count").textContent, "1 ITEM");
+});
+
test("blocked storage and an invalid saved project leave the app usable", async () => {
const app = harness(new Map(), true); await makeDraft(app);
app.element("autosave-toggle").checked = true; app.element("autosave-toggle").handlers.change();
diff --git a/src/test/js/browser-documents.test.cjs b/src/test/js/browser-documents.test.cjs
index ef071fe..8878a9d 100644
--- a/src/test/js/browser-documents.test.cjs
+++ b/src/test/js/browser-documents.test.cjs
@@ -55,6 +55,38 @@ test('PDF line wrapping preserves blank lines and splits long tokens within the
assert.equal(lines.slice(0,3).join(''),'a'.repeat(51));
});
+test('PDF export embeds custom Unicode fonts and retains Turkish and phonetic characters', async () => {
+ const drawn = [], embedded = [];
+ const font = {widthOfTextAtSize: text => [...text].length * 5};
+ const page = {drawText: text => drawn.push(text)};
+ const lib = {
+ rgb: () => ({}),
+ PDFDocument: {create: async () => ({
+ setTitle() {}, setCreator() {}, setAuthor() {},
+ registerFontkit(value) { assert.equal(typeof value.create, 'function'); },
+ async embedFont(bytes, options) { embedded.push({bytes, options}); return font; },
+ addPage() { return page; }, getPages() { return [page]; },
+ async save() { return new Uint8Array([37, 80, 68, 70]); }
+ })}
+ };
+ const fonts = {fontkit: {create: () => ({hasGlyphForCodePoint: () => true})}, regular: new Uint8Array([1]), bold: new Uint8Array([2])};
+ const pdf = await tools.exportPdf({title: 'İğdır', items: [{question: 'Türkçe?', answer: 'ışık, ş, ğ, ı, →, ŋ, ʒ'}]}, lib, fonts);
+ assert.equal(pdf.type, 'application/pdf');
+ assert.equal(embedded.length, 2);
+ assert.deepEqual(embedded.map(item => [...item.bytes]), [[1], [2]]);
+ assert.ok(embedded.every(item => item.options.subset === true));
+ assert.ok(drawn.join(' ').includes('İğdır'));
+ assert.ok(drawn.join(' ').includes('ışık, ş, ğ, ı, →, ŋ, ʒ'));
+ assert.match(tools.libraries.fontkit, /fontkit@1\.1\.1/);
+});
+
+test('PDF export reports an unsupported glyph instead of silently replacing it', () => {
+ const fonts = {fontkit: {create: () => ({hasGlyphForCodePoint: point => point !== 0x6c49})}, regular: new Uint8Array([1]), bold: new Uint8Array([2])};
+ const faq = {title: 'FAQ', items: [{question: 'What?', answer: 'The character 汉 must not disappear.'}]};
+ assert.throws(() => tools.checkPdfGlyphs(faq, fonts), /“汉” \(U\+6C49\).*Choose Word/);
+ assert.doesNotThrow(() => tools.checkPdfGlyphs({title: 'FAQ', items: [{question: 'Türkçe?', answer: 'İğdır → şı'}]}, fonts));
+});
+
test('Word Heading 1 becomes a section the browser generator can draft from', () => {
const {draft} = require('../../../web-demo/engine.js');
const text = tools.headingPrefix('Heading1') + 'Services\nOnboarding guides.\n' + tools.headingPrefix('Heading2') + 'Support\nAsk the team.';
diff --git a/web-demo/THIRD-PARTY.md b/web-demo/THIRD-PARTY.md
index b0cd69f..8452cf5 100644
--- a/web-demo/THIRD-PARTY.md
+++ b/web-demo/THIRD-PARTY.md
@@ -5,7 +5,9 @@ The website lazily downloads these version-pinned scripts from jsDelivr. It send
| Library | Version | Purpose | License |
| --- | --- | --- | --- |
| [Mozilla PDF.js](https://github.com/mozilla/pdf.js) | 5.6.205 | PDF text extraction and worker | Apache-2.0 |
-| [PDF-LIB](https://github.com/Hopding/pdf-lib) | 1.17.1 | Paginated PDF creation using standard Helvetica fonts | MIT |
+| [PDF-LIB](https://github.com/Hopding/pdf-lib) | 1.17.1 | Paginated PDF creation with embedded Unicode fonts | MIT |
+| [@pdf-lib/fontkit](https://github.com/Hopding/fontkit) | 1.1.1 | Embed custom PDF fonts (loaded lazily for PDF export) | MIT |
+| [DejaVu Sans](https://dejavu-fonts.github.io/) | Distribution-provided TTF | Bundled regular and bold Unicode PDF fonts; see `fonts/LICENSE-DejaVu.txt` | Bitstream Vera / DejaVu license |
| [JSZip](https://github.com/Stuk/jszip) | 3.10.1 | Read DOCX archive entries through bounded decompression | MIT (also offered under GPLv3) |
| [docx](https://github.com/dolanmiu/docx) | 9.6.1 | Generate editable Word documents | MIT |
diff --git a/web-demo/documents.js b/web-demo/documents.js
index 16b6b13..4741564 100644
--- a/web-demo/documents.js
+++ b/web-demo/documents.js
@@ -6,6 +6,9 @@
pdf: 'https://cdn.jsdelivr.net/npm/pdfjs-dist@5.6.205/build/pdf.mjs',
worker: 'https://cdn.jsdelivr.net/npm/pdfjs-dist@5.6.205/build/pdf.worker.min.mjs',
pdfLib: 'https://cdn.jsdelivr.net/npm/pdf-lib@1.17.1/dist/pdf-lib.min.js',
+ fontkit: 'https://cdn.jsdelivr.net/npm/@pdf-lib/fontkit@1.1.1/dist/fontkit.umd.min.js',
+ pdfRegular: './fonts/DejaVuSans.ttf',
+ pdfBold: './fonts/DejaVuSans-Bold.ttf',
zip: 'https://cdn.jsdelivr.net/npm/jszip@3.10.1/dist/jszip.min.js',
docx: 'https://cdn.jsdelivr.net/npm/docx@9.6.1/dist/index.iife.js'
};
@@ -22,6 +25,16 @@
}));
return pending.get(url);
}
+ function loadFont(url) {
+ if (!pending.has(url)) pending.set(url, root.fetch(url).then(async response => {
+ if (!response.ok) throw new Error('PDF fonts could not load. Check your connection and try again.');
+ return new Uint8Array(await response.arrayBuffer());
+ }).catch(error => {
+ pending.delete(url);
+ throw new Error('PDF fonts could not load. Check your connection and try again.', {cause: error});
+ }));
+ return pending.get(url);
+ }
function validateInput(file) {
if (!file || !/\.(pdf|docx)$/i.test(file.name)) throw new Error('Choose a PDF or Word (.docx) file. Legacy .doc files are not supported.');
if (!file.size || file.size > MAX_FILE) throw new Error('PDF and DOCX files must be nonempty and no larger than 5 MB.');
@@ -159,10 +172,12 @@
}
function wrap(text, font, size, width) {
const result = [];
+ const advances = new Map();
for (const paragraph of text.replace(/\r\n?/g, '\n').split('\n')) {
let line = '', used = 0, lastSpace = -1;
for (const char of paragraph) {
- const advance = font.widthOfTextAtSize(char, size);
+ if (!advances.has(char)) advances.set(char, font.widthOfTextAtSize(char, size));
+ const advance = advances.get(char);
if (used + advance > width && line) {
if (lastSpace >= 0) { result.push(line.slice(0, lastSpace)); line = line.slice(lastSpace + 1); }
else { result.push(line); line = ''; }
@@ -174,11 +189,33 @@
}
return result;
}
- async function exportPdf(data, lib) {
+ function checkPdfGlyphs(data, fonts) {
+ const regular = fonts.fontkit.create(fonts.regular);
+ const bold = fonts.fontkit.create(fonts.bold);
+ const examined = [
+ [data.title || 'FAQ draft', bold],
+ ...data.items.flatMap(item => [[item.question, bold], [item.answer, regular], ...(data.includeSources ? [[references(item), regular]] : [])])
+ ];
+ for (const [text, face] of examined) {
+ for (const char of new Set(text)) {
+ const point = char.codePointAt(0);
+ if (point <= 32 || point === 127) continue;
+ if (!face.hasGlyphForCodePoint(point)) {
+ throw new Error(`PDF export cannot display “${char}” (U+${point.toString(16).toUpperCase()}) with the bundled font. Choose Word (.docx) to preserve it.`);
+ }
+ }
+ }
+ }
+ async function exportPdf(data, lib, fonts) {
validateExport(data);
+ checkPdfGlyphs(data, fonts);
const pdf = await lib.PDFDocument.create();
pdf.setTitle(data.title); pdf.setCreator('Doc2FAQ browser demo'); pdf.setAuthor('Doc2FAQ');
- const regular = await pdf.embedFont(lib.StandardFonts.Helvetica), bold = await pdf.embedFont(lib.StandardFonts.HelveticaBold);
+ pdf.registerFontkit(fonts.fontkit);
+ // DejaVu Sans covers Turkish, Latin Extended, IPA, symbols and quotation marks
+ // that standard PDF Helvetica/WinAnsi cannot encode. Embed only used glyphs.
+ const regular = await pdf.embedFont(fonts.regular, {subset: true});
+ const bold = await pdf.embedFont(fonts.bold, {subset: true});
const width = 595.28, height = 841.89, margin = 50, bottom = 58;
let page, y;
function newPage() { page = pdf.addPage([width, height]); y = height - margin; }
@@ -205,7 +242,7 @@
}
return new Blob([await pdf.save()], {type: 'application/pdf'});
} catch (error) {
- if (/WinAnsi|encode/i.test(error.message)) throw new Error('This PDF font cannot display a character in your text. Choose Word (.docx) to preserve it.');
+ if (/WinAnsi|encode|No glyph/i.test(error.message)) throw new Error('A character in your text is not supported by the PDF font. Choose Word (.docx) to preserve it.');
throw error;
}
}
@@ -239,13 +276,19 @@
}
if (url === '/api/faqs/export/pdf' || url === '/api/faqs/export/docx') {
const data = JSON.parse(options.body); validateExport(data);
- const blob = url.endsWith('/pdf') ? await exportPdf(data, await loadScript(libraries.pdfLib, 'PDFLib')) : await exportDocx(data, await loadScript(libraries.docx, 'docx'));
+ const blob = url.endsWith('/pdf') ? await (async () => {
+ const [lib, fontkit, regular, bold] = await Promise.all([
+ loadScript(libraries.pdfLib, 'PDFLib'), loadScript(libraries.fontkit, 'fontkit'),
+ loadFont(libraries.pdfRegular), loadFont(libraries.pdfBold)
+ ]);
+ return exportPdf(data, lib, {fontkit, regular, bold});
+ })() : await exportDocx(data, await loadScript(libraries.docx, 'docx'));
return {ok: true, blob: async () => blob};
}
throw new Error('Unsupported document operation.');
} catch (error) { return {ok: false, json: async () => ({message: error.message || 'Could not process this document.'})}; }
}
- const api = {request, validateInput, checkedText, validateZip, boundedEntry, headingPrefix, wordXmlText, extractDocx, extractPdf, validateExport, references, wrap, exportPdf, exportDocx, libraries};
+ const api = {request, validateInput, checkedText, validateZip, boundedEntry, headingPrefix, wordXmlText, extractDocx, extractPdf, validateExport, references, wrap, checkPdfGlyphs, exportPdf, exportDocx, libraries};
if (typeof module !== 'undefined' && module.exports) module.exports = api;
else root.Doc2FaqDocuments = api;
})(globalThis);
diff --git a/web-demo/fonts/DejaVuSans-Bold.ttf b/web-demo/fonts/DejaVuSans-Bold.ttf
new file mode 100644
index 0000000000000000000000000000000000000000..426812b9b0ce12f20285adf46d8acc0dd40dfba5
GIT binary patch
literal 708920
zcmeEv3!F~X`u|${_TF!M@0tC^FoS7ak|arzbWX)$=b_C=1*