54 KiB
JavaScript Reference Documentation
This document provides a comprehensive reference for all methods, variables, and configurations in static/js/script.js (935 lines). It is designed for agent systems to understand and interact with the e621tagger frontend.
File Overview
| Attribute | Value |
|---|---|
| Location | static/js/script.js |
| Lines | 935 |
| Framework | Vanilla JavaScript |
| Purpose | Frontend UI functionality |
| Dependencies | Hammer.js (touch events), escapeHtml/sanitizeHtml/XSS protection |
File Structure Flow
script.js (935 lines)
├── 1. Constants (27-45) - Configuration values
├── 2. State Variables (47-68) - Runtime application state
├── 3. DOM Cached (2-25) - DOM element references
├── 4. preloadCreatures (70-73) - Preload easter egg images
├── 5. loadSettings (75-109) - Load from localStorage
├── 6. saveSettings (111-116) - Save to localStorage
├── 7. UI Functions (118-195) - Theme, notifications, popups
├── 8. XSS Protection (240-294) - escapeHtml, sanitizeHtml, parseDText
├── 9. Tag Functions (395-623) - Handle, display, filter tags
├── 10. Copy Functions (444-520) - Clipboard, format conversion
├── 11. File Handling (627-706) - Drag/drop, preview, validation
├── 12. Fullscreen Image (194-235) - Fullscreen modal functions
├── 13. Help Modal (745-765) - Help modal functions
├── 14. initHammer (772-870) - Hammer.js touch setup
├── 15. Event Listeners (872-915) - Attach all listeners
└── 16. Final Init (917-935) - Final setup
1. Constants
const MAX_FILE_SIZE = 20 * 1024 * 1024; // 20MB
const ALLOWED_MAX_TAGS = [50, 75, 100, 150, 200, 300];
const ratingTags = new Set(['safe', 'questionable', 'explicit']);
const creaturePaths = [
'/static/icons/egg/f1.png', '/static/icons/egg/f2.png', '/static/icons/egg/f3.png',
'/static/icons/egg/f4.png', '/static/icons/egg/f5.png', '/static/icons/egg/f6.png',
'/static/icons/egg/f7.png', '/static/icons/egg/f8.png', '/static/icons/egg/f9.png'
];
const copyCategoryOrder = ['Copyright', 'Character', 'Species', 'Meta', 'General', 'Lore'];
const displayCategoryOrder = [
'General', 'Artist', 'Contributor', 'Copyright', 'Character', 'Species',
'Invalid', 'Meta',
'Accessories, Items, Clothing', 'Actions, Positions, State',
'Body Features', 'Effects, Fluids', 'Fetishes, Specifics, Interactions',
'Genders, Demographics', 'Locations, Backgrounds, Setting',
'Poses, Scenarios, Situations', 'Style, Perspective',
'Text, Symbols, UI, Vocalization', 'Other',
'Body Color', 'Lore'
];
const tagDescriptionCache = new Map(); // Cache for e621 wiki tag descriptions
| Constant | Value | Description |
|---|---|---|
MAX_FILE_SIZE |
20MB | Maximum upload file size |
ALLOWED_MAX_TAGS |
[50,75,100,150,200,300] | Valid top_k values |
ratingTags |
{safe, questionable, explicit} | Rating tag names |
creaturePaths |
9 image paths | Easter egg creature images |
copyCategoryOrder |
6 categories | e621 category order for copy action (100-111 merged into General) |
displayCategoryOrder |
21 categories | Visual order for site display (Body Color and Lore at bottom) |
tagDescriptionCache |
Map | Caches wiki descriptions to reduce API calls |
2. State Variables
let allTags = []; // Tag predictions from API
let currentFormat = 'e621'; // 'e621' for danbooru format, any other for PostyBirb
let savedFormat = 'e621'; // 'e621' for danbooru format, any other for PostyBirb
let allThreshold = 0.60; // Lower threshold (include)
let confidentThreshold = 0.70; // Upper threshold (confident)
let currentTheme = 'system'; // 'system', 'light', 'dark'
let activePreset = 'standard'; // 'conservative'/'standard'/'liberal'/'custom'
let addedTags = new Set(); // User-added tags
let removedTags = new Set(); // User-removed tags
let hiddenCategories = new Set(); // Session-hidden categories (per upload, non-persistent)
let alwaysHiddenCategories = new Set(); // Persisted hidden categories (localStorage)
let maxTags = 200; // Max tags to request
let autoMetaTagSet = new Set(); // Auto-detected meta tags
let perTagAutoDisable = new Set(); // Per-tag auto disable
let currentPopup = null; // Active popup DOM element
let activePopupTagElement = null; // Popup trigger element
let pressBlockTap = false; // Press event blocking flag
let fullscreenImageModal = null; // Fullscreen modal DOM element
let isFullscreenActive = false; // Fullscreen modal state
| Variable | Type | Default | Description |
|---|---|---|---|
allTags |
Array | [] | Tag predictions from API |
currentFormat |
string | 'e621' | Runtime output format |
savedFormat |
string | 'e621' | Persisted default format |
allThreshold |
float | 0.60 | Include threshold |
confidentThreshold |
float | 0.70 | High confidence threshold |
currentTheme |
string | 'system' | UI theme |
activePreset |
string | 'standard' | Threshold preset |
addedTags |
Set | - | User-added tags |
removedTags |
Set | - | User-removed tags |
hiddenCategories |
Set | - | Session-only hidden categories (per upload, non-persistent) |
alwaysHiddenCategories |
Set | - | Persistently hidden categories from localStorage |
maxTags |
int | 200 | API top_k parameter |
autoMetaTagSet |
Set | - | Auto meta tags |
perTagAutoDisable |
Set | - | Disabled auto tags |
addCurrentYearTag |
boolean | true | Whether to include current year meta tag |
Threshold Presets
const presets = {
conservative: { all: 0.70, confident: 0.80 },
standard: { all: 0.60, confident: 0.70 },
liberal: { all: 0.50, confident: 0.60 }
};
| Preset | allThreshold | confidentThreshold |
|---|---|---|
| conservative | 0.70 | 0.80 |
| standard | 0.60 | 0.70 |
| liberal | 0.50 | 0.60 |
| custom | user-defined | user-defined |
3. DOM Cached Elements
| Variable | Element ID / Selector | Usage |
|---|---|---|
dropZone |
dropZone |
File upload area |
fileInput |
fileInput |
Hidden file input |
uploadContent |
uploadContent |
Upload prompt text |
results |
results |
Results container |
resultsContent |
resultsContent |
Tags display area |
notificationContainer |
notification-container |
Toast notifications |
categoriesContainer |
categoriesContainer |
Category tag groups |
ratingDisplay |
ratingDisplay |
Rating badge |
copyGlobalAll |
copyGlobalAll |
Copy all button |
copyGlobalConfident |
copyGlobalConfident |
Copy confident button |
settingsToggle |
settingsToggle |
Settings toggle button |
settingsMenu |
settingsMenu |
Settings panel |
closeSettings |
closeSettings |
Close settings button |
presetBtns |
.preset-btn |
Threshold preset buttons |
customPanel |
customThresholdsPanel |
Custom thresholds panel |
customAllInput |
customAll |
Custom all threshold input |
customConfidentInput |
customConfident |
Custom confident threshold input |
applyCustom |
applyCustom |
Apply custom button |
resetBtn |
resetSettings |
Reset button |
eggContainer |
eggContainer |
Easter egg container |
eggCreature |
eggCreature |
Easter egg image |
helpBtn |
helpThresholdsBtn |
Help button |
helpModal |
helpModal |
Help modal |
closeHelpModalBtn |
.close-help-modal |
Close help modal button |
yearTagToggle |
yearTagToggle |
Year switch checkbox (Apple-style) |
4. Settings Functions
preloadCreatures()
Preloads easter egg creature images for instant display.
function preloadCreatures() {
creaturePaths.forEach(path => { new Image().src = path; });
}
preloadCreatures(); // Called at initialization
loadSettings()
Loads persisted settings from localStorage.
function loadSettings() {
const saved = localStorage.getItem('e621tagger-settings');
if (saved) {
try {
const settings = JSON.parse(saved);
allThreshold = settings.allThreshold ?? 0.60;
confidentThreshold = settings.confidentThreshold ?? 0.70;
savedFormat = settings.defaultFormat ?? 'e621';
currentFormat = savedFormat;
currentTheme = settings.theme ?? 'system';
activePreset = settings.activePreset ?? 'standard';
maxTags = settings.maxTags ?? 200;
if (!ALLOWED_MAX_TAGS.includes(maxTags)) maxTags = 200;
alwaysHiddenCategories = new Set(settings.alwaysHiddenCategories || []);
addCurrentYearTag = settings.addCurrentYearTag ?? true;
document.querySelectorAll('#themeToggle .theme-option').forEach(btn => {
btn.classList.toggle('active', btn.dataset.value === currentTheme);
});
document.querySelectorAll('#maxTagsToggle .max-tag-option').forEach(btn => {
btn.classList.toggle('active', btn.dataset.value === String(maxTags));
});
const yearTagToggle = document.getElementById('yearTagToggle');
if (yearTagToggle) yearTagToggle.checked = addCurrentYearTag;
updateTheme(currentTheme);
updateThresholdUI();
} catch (e) {
console.warn('Failed to load settings', e);
}
} else {
activePreset = 'standard';
maxTags = 200;
updateThresholdUI();
}
}
IMPORTANT: LocalStorage key is e621tagger-settings as a JSON string.
| localStorage Key | State Variable |
|---|---|
| allThreshold | allThreshold |
| confidentThreshold | confidentThreshold |
| defaultFormat | savedFormat, currentFormat |
| theme | currentTheme |
| activePreset | activePreset |
| maxTags | maxTags |
| alwaysHiddenCategories | alwaysHiddenCategories |
| addCurrentYearTag | addCurrentYearTag |
saveSettings()
Persists settings to localStorage.
function saveSettings() {
localStorage.setItem('e621tagger-settings', JSON.stringify({
allThreshold, confidentThreshold, defaultFormat: savedFormat,
theme: currentTheme, activePreset, maxTags,
alwaysHiddenCategories: [...alwaysHiddenCategories],
addCurrentYearTag
}));
}
updateTheme(theme)
Applies theme class to document body.
function updateTheme(theme) {
currentTheme = theme;
document.body.classList.remove('theme-light', 'theme-dark');
if (theme === 'light') document.body.classList.add('theme-light');
else if (theme === 'dark') document.body.classList.add('theme-dark');
}
toggleSettings(show)
Shows or hides the settings panel.
function toggleSettings(show) {
settingsMenu.classList.toggle('show', show);
settingsToggle.classList.toggle('open', show);
if (show) positionSettingsMenu();
}
function positionSettingsMenu() {
const toggleRect = settingsToggle.getBoundingClientRect();
const containerRect = document.querySelector('.container').getBoundingClientRect();
settingsMenu.style.left = (toggleRect.left - containerRect.left) + 'px';
settingsMenu.style.top = (toggleRect.bottom - containerRect.top + 5) + 'px';
}
updateThresholdUI()
Updates UI to reflect current threshold state.
function updateThresholdUI() {
presetBtns.forEach(btn => {
btn.classList.toggle('active', btn.dataset.preset === activePreset);
});
customPanel.classList.toggle('open', activePreset === 'custom');
customAllInput.value = allThreshold.toFixed(2);
customConfidentInput.value = confidentThreshold.toFixed(2);
}
updateLocalFormatUI()
Updates format toggle UI.
function updateLocalFormatUI() {
document.querySelectorAll('#resultsFormatToggle .format-option').forEach(btn => {
btn.classList.toggle('active', btn.dataset.value === currentFormat);
});
}
5. XSS Protection Functions
escapeHtml(unsafe)
Escapes HTML entities for safe display.
function escapeHtml(unsafe) {
if (!unsafe) return '';
return unsafe.replace(/[&<>"']/g, m => m === '&' ? '&' : m === '<' ? '<' : m === '>' ? '>' : m === '"' ? '"' : ''');
}
sanitizeHtml(html)
Removes dangerous HTML (event handlers, javascript:).
function sanitizeHtml(html) {
if (!html) return '';
const dangerousAttrs = /\s+(on\w+|style\s*=\s*["']?(?:javascript:|expression\()[^"']*)/gi;
let previous;
do {
previous = html;
html = html.replace(/<(?!\/?(?:strong|em|u|sup|span|br)\b)[^>]*>/gi, (match) => {
return match.replace(/</g, '<').replace(/>/g, '>');
});
} while (html !== previous);
do {
previous = html;
html = html.replace(dangerousAttrs, '');
} while (html !== previous);
return html;
}
parseDText(dtext)
Parses e621 wiki DText markup to HTML.
function parseDText(dtext) {
if (!dtext) return '';
let text = escapeHtml(dtext.slice(0, 1000));
text = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
text = text.replace(/thumb\s+#\d+\s*/g, '');
text = text.replace(/\[section[^\]]*\]([\s\S]*?)\[\/section\]/g, '$1');
text = text.replace(/\[quote[^\]]*\]([\s\S]*?)\[\/quote\]/g, '$1');
text = text.replace(/\[table[^\]]*\]([\s\S]*?)\[\/table\]/g, '$1');
text = text.replace(/\[s\]([\s\S]*?)\[\/s\]/g, '$1');
text = text.replace(/\[color=([^\]]+)\]([\s\S]*?)\[\/color\]/g, '<span style="color: var(--confident-bg);">$2</span>');
text = text.replace(/"([^"]+)"\s*:\s*(\S+)/g, (match, linkText) => `<span style="color: var(--confident-bg);">${linkText}</span>`);
text = text.replace(/\[\[([^\]|]+)\|([^\]]+)\]\]/g, (match, target, display) => `<span style="color: var(--confident-bg);">${display}</span>`);
text = text.replace(/\[\[([^\]]+)\]\]/g, (match, p1) => `<span style="color: var(--confident-bg);">${p1}</span>`);
let lines = text.split('\n');
let processedLines = [];
for (let line of lines) {
let trimmed = line;
const headerMatch = trimmed.match(/^\s*h([1-6])(?:\.?\s*)(.*)$/i);
if (headerMatch) trimmed = `<strong style="color: var(--confident-bg);">${headerMatch[2]}</strong>`;
else trimmed = trimmed.replace(/^(\*+)\s+/, '');
if (trimmed.trim() !== '') processedLines.push(trimmed);
}
text = processedLines.join('\n');
text = text.replace(/\[b\]([\s\S]*?)\[\/b\]/g, '<strong>$1</strong>');
text = text.replace(/\[i\]([\s\S]*?)\[\/i\]/g, '<em>$1</em>');
text = text.replace(/\[u\]([\s\S]*?)\[\/u\]/g, '<u>$1</u>');
text = text.replace(/\[sup\]([\s\S]*?)\[\/sup\]/g, '<sup>$1</sup>');
text = text.replace(/\n/g, '<br>');
text = text.replace(/(<br>){3,}/g, '<br><br>');
text = text.replace(/^(<br>)+/, '').replace(/(<br>)+$/, '');
if (dtext.length > 1000) text += '…';
return text;
}
6. Notification Functions
showNotification(message, type, duration)
Shows a toast notification.
function showNotification(message, type = 'error', duration = 3000) {
const notification = document.createElement('div');
notification.className = `notification ${type}`;
notification.textContent = message;
notificationContainer.appendChild(notification);
setTimeout(() => {
notification.style.animation = 'slideOut 0.3s ease forwards';
setTimeout(() => notification.remove(), 300);
}, duration);
}
| Type | CSS Class | Duration |
|---|---|---|
| error | .notification.error | 3000ms |
| success | .notification.success | 3000ms |
| info | .notification.info | 5000ms |
7. Tag Popup Functions
fetchTagDescription(tagName)
Fetches tag description from e621 wiki API.
async function fetchTagDescription(tagName) {
if (tagDescriptionCache.has(tagName)) return tagDescriptionCache.get(tagName);
const url = `https://e621.net/wiki_pages.json?search[title]=${encodeURIComponent(tagName)}&limit=1`;
try {
const response = await fetch(url, { headers: { 'User-Agent': 'e621tagger/1.0 (https://tagger.fenrir784.app)' } });
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
if (data && data.length) {
const wiki = data[0];
const result = { exists: true, title: wiki.title || tagName, body: wiki.body || 'No description available.' };
tagDescriptionCache.set(tagName, result);
return result;
} else {
const result = { exists: false, title: tagName, body: 'No description found on e621.' };
tagDescriptionCache.set(tagName, result);
return result;
}
} catch (err) {
console.warn(`Failed to fetch description for ${tagName}:`, err);
return { exists: false, title: tagName, body: 'Failed to load description. Please check your internet connection.' };
}
}
IMPORTANT: Uses /wiki_pages.json endpoint, NOT autocomplete.json.
showTagPopup(tagObj, targetElement)
Shows tag details popup with description.
function showTagPopup(tagObj, targetElement) {
if (currentPopup && activePopupTagElement === targetElement) return;
if (currentPopup) closePopup();
activePopupTagElement = targetElement;
const tagName = tagObj.tag;
const popup = document.createElement('div');
popup.className = 'tag-popup';
const wikiUrl = `https://e621.net/wiki_pages?title=${encodeURIComponent(tagName)}`;
popup.innerHTML = `
<div class="tag-popup-header">
<button class="tag-popup-copy-btn" title="Copy tag name">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"/><rect x="8" y="2" width="8" height="4" rx="1" ry="1"/></svg>
</button>
<a href="${wikiUrl}" target="_blank" rel="noopener noreferrer" style="display: flex; align-items: center; gap: 8px; text-decoration: none; color: var(--confident-bg);">
<span>${escapeHtml(tagName)}</span>
<span style="color: var(--low-text); font-size: 0.7rem; text-decoration: underline;">read more</span>
</a>
<button class="close-popup">✕</button>
</div>
<div class="tag-popup-content"><div class="tag-popup-loading">Loading description...</div></div>
`;
document.body.appendChild(popup);
currentPopup = popup;
const rect = targetElement.getBoundingClientRect();
const viewportWidth = window.innerWidth;
const viewportHeight = window.innerHeight;
popup.style.visibility = 'hidden';
popup.style.position = 'absolute';
const popupRect = popup.getBoundingClientRect();
popup.style.visibility = '';
let top = rect.bottom + 8;
let left = rect.left + (rect.width / 2) - (popupRect.width / 2);
if (top + popupRect.height > viewportHeight - 10) top = rect.top - popupRect.height - 8;
left = Math.max(10, Math.min(left, viewportWidth - popupRect.width - 10));
popup.style.top = `${top + window.scrollY}px`;
popup.style.left = `${left + window.scrollX}px`;
const closeBtn = popup.querySelector('.close-popup');
closeBtn.addEventListener('click', () => closePopup());
const copyBtn = popup.querySelector('.tag-popup-copy-btn');
copyBtn.addEventListener('click', async (e) => {
e.stopPropagation();
if (copyBtn._copyTimeout) clearTimeout(copyBtn._copyTimeout);
try {
if (navigator.clipboard && navigator.clipboard.writeText) {
await navigator.clipboard.writeText(tagName);
} else {
const ta = document.createElement('textarea');
ta.value = tagName;
ta.style.position = 'fixed';
ta.style.opacity = '0';
document.body.appendChild(ta);
ta.select();
document.execCommand('copy');
document.body.removeChild(ta);
}
copyBtn.classList.add('copied');
copyBtn._copyTimeout = setTimeout(() => copyBtn.classList.remove('copied'), 1000);
} catch {}
});
fetchTagDescription(tagName).then(desc => {
const content = popup.querySelector('.tag-popup-content');
if (desc.exists) content.innerHTML = `<div class="tag-popup-text">${sanitizeHtml(parseDText(desc.body))}</div>`;
else content.innerHTML = `<div class="tag-popup-error">${escapeHtml(desc.body)}</div>`;
}).catch(() => {
popup.querySelector('.tag-popup-content').innerHTML = '<div class="tag-popup-error">Failed to load description.</div>';
});
}
closePopup()
Closes the active tag popup.
function closePopup() {
if (currentPopup) {
currentPopup.remove();
currentPopup = null;
}
activePopupTagElement = null;
}
8. Tag Handling Functions
handleTagClick(tagObj)
Handles tag click to toggle include/exclude state.
function handleTagClick(tagObj) {
if (pressBlockTap) return;
const tag = tagObj.tag;
const prob = tagObj.prob;
const isConfident = prob >= confidentThreshold;
const isAll = prob >= allThreshold;
const wasAdded = addedTags.has(tag);
const wasRemoved = removedTags.has(tag);
if (isConfident) {
if (!wasAdded && !wasRemoved) removedTags.add(tag);
else if (wasRemoved) removedTags.delete(tag);
else if (wasAdded) addedTags.delete(tag);
} else if (isAll) {
if (!wasAdded && !wasRemoved) addedTags.add(tag);
else if (wasAdded) { addedTags.delete(tag); removedTags.add(tag); }
else if (wasRemoved) removedTags.delete(tag);
} else {
if (!wasAdded && !wasRemoved) addedTags.add(tag);
else if (wasAdded) addedTags.delete(tag);
else if (wasRemoved) removedTags.delete(tag);
}
document.querySelectorAll(`.tag[data-tag="${tag}"]`).forEach(el => updateTagElement(el, tagObj));
refreshTagClasses();
}
| Current State | isConfident | isAll | Action |
|---|---|---|---|
| None | yes | - | Add to removedTags |
| None | - | yes | Add to addedTags |
| None | no | no | Add to addedTags |
| addedTags | yes | - | Remove from addedTags |
| addedTags | no | yes | Move to removedTags |
| removedTags | any | - | Remove from removedTags |
updateTagElement(el, tagObj)
Updates a single tag element's data-level attribute while preserving data-original-level.
function updateTagElement(el, tagObj) {
const origLevel = el.dataset.originalLevel;
el.removeAttribute('data-level');
if (addedTags.has(tagObj.tag)) {
el.setAttribute('data-level', 'added');
if (origLevel) el.setAttribute('data-original-level', origLevel);
} else if (removedTags.has(tagObj.tag)) {
el.setAttribute('data-level', 'removed');
if (origLevel) el.setAttribute('data-original-level', origLevel);
}
}
refreshTagClasses()
Refreshes all tag elements' data-level attributes when thresholds change. Updates data-original-level to reflect current baseline so that manual toggles afterward preserve bold correctly.
function refreshTagClasses() {
document.querySelectorAll('.tag').forEach(el => {
const tagName = el.dataset.tag;
const tagObj = allTags.find(t => t.tag === tagName);
if (!tagObj) return;
el.removeAttribute('data-level');
if (addedTags.has(tagName)) {
el.setAttribute('data-level', 'added');
} else if (removedTags.has(tagName)) {
el.setAttribute('data-level', 'removed');
} else if (tagObj.prob >= confidentThreshold) {
el.setAttribute('data-level', 'confident');
el.setAttribute('data-original-level', 'confident');
} else if (tagObj.prob >= allThreshold) {
el.setAttribute('data-level', 'all');
el.setAttribute('data-original-level', 'all');
}
});
}
isTagIncluded(tagObj, threshold)
Determines if a tag should be included in output.
function isTagIncluded(tagObj, threshold) {
if (perTagAutoDisable.has(tagObj.tag)) return false;
const tag = tagObj.tag;
if (removedTags.has(tag)) return false;
if (addedTags.has(tag)) return true;
return tagObj.prob >= threshold;
}
filterTags(threshold)
Filters tags by probability threshold and excludes tags from hidden categories.
function filterTags(threshold) {
return allTags.filter(t => !ratingTags.has(t.tag) && !hiddenCategories.has(t.category) && isTagIncluded(t, threshold));
}
displayTags(tags)
Main tag rendering function - creates DOM elements.
function displayTags(tags) {
let rating = null;
const nonRatingTags = [];
tags.forEach(t => {
if (ratingTags.has(t.tag)) {
if (!rating || t.prob > rating.prob) rating = t;
} else nonRatingTags.push(t);
});
if (rating) {
ratingDisplay.textContent = `Rating: ${rating.tag}`;
ratingDisplay.className = 'rating-display ' + rating.tag;
ratingDisplay.style.display = 'inline-block';
} else ratingDisplay.style.display = 'none';
const grouped = {};
nonRatingTags.sort((a, b) => b.prob - a.prob);
nonRatingTags.forEach(item => {
const cat = item.category || 'Other';
if (!grouped[cat]) grouped[cat] = [];
grouped[cat].push(item);
});
categoriesContainer.innerHTML = '';
Object.keys(grouped).sort((a, b) => {
const aAlways = alwaysHiddenCategories.has(a);
const bAlways = alwaysHiddenCategories.has(b);
if (aAlways && !bAlways) return 1;
if (!aAlways && bAlways) return -1;
const ia = displayCategoryOrder.indexOf(a);
const ib = displayCategoryOrder.indexOf(b);
if (ia !== -1 && ib !== -1) return ia - ib;
if (ia !== -1) return -1;
if (ib !== -1) return 1;
return a.localeCompare(b);
}).forEach(cat => {
const catTags = grouped[cat];
const isHidden = hiddenCategories.has(cat);
const isAlways = alwaysHiddenCategories.has(cat);
const catDiv = document.createElement('div');
catDiv.className = 'category-block' + (isHidden ? ' category-hidden' : '');
catDiv.innerHTML = `
<div class="category-header">
<span class="category-name">${escapeHtml(cat)}</span>
<div class="category-header-actions">
<span class="category-always-hide${isAlways ? ' active' : ''}" style="display: ${isHidden ? 'inline' : 'none'}">Always hide</span>
<button class="category-toggle-btn">${isHidden ? '✓' : '✕'}</button>
</div>
</div>
<div class="category-tags"></div>
`;
const tagsContainer = catDiv.querySelector('.category-tags');
catTags.forEach(item => {
const tagEl = document.createElement('span');
tagEl.className = 'tag';
tagEl.setAttribute('data-tag', item.tag);
tagEl.textContent = item.tag;
if (addedTags.has(item.tag)) {
tagEl.setAttribute('data-level', 'added');
} else if (removedTags.has(item.tag)) {
tagEl.setAttribute('data-level', 'removed');
} else if (item.prob >= confidentThreshold) {
tagEl.setAttribute('data-level', 'confident');
tagEl.setAttribute('data-original-level', 'confident');
} else if (item.prob >= allThreshold) {
tagEl.setAttribute('data-level', 'all');
tagEl.setAttribute('data-original-level', 'all');
}
attachTagEvents(tagEl, item);
tagsContainer.appendChild(tagEl);
});
const toggleBtn = catDiv.querySelector('.category-toggle-btn');
toggleBtn.addEventListener('click', (e) => {
e.stopPropagation();
if (hiddenCategories.has(cat)) {
hiddenCategories.delete(cat);
catDiv.classList.remove('category-hidden');
toggleBtn.textContent = '✕';
alwaysHideEl.style.display = 'none';
} else {
hiddenCategories.add(cat);
catDiv.classList.add('category-hidden');
toggleBtn.textContent = '✓';
alwaysHideEl.style.display = 'inline';
}
});
const alwaysHideEl = catDiv.querySelector('.category-always-hide');
alwaysHideEl.addEventListener('click', (e) => {
e.stopPropagation();
if (alwaysHiddenCategories.has(cat)) {
alwaysHiddenCategories.delete(cat);
alwaysHideEl.classList.remove('active');
} else {
alwaysHiddenCategories.add(cat);
hiddenCategories.add(cat);
catDiv.classList.add('category-hidden');
toggleBtn.textContent = '✓';
alwaysHideEl.style.display = 'inline';
alwaysHideEl.classList.add('active');
}
saveSettings();
});
categoriesContainer.appendChild(catDiv);
});
}
Category Toggle Functions
The toggle button (✕/✓) and "Always hide" text are rendered inside each .category-header by displayTags().
Toggle Button Handler
The toggle and always-hide logic is handled inline within displayTags() via direct addEventListener calls on the rendered elements:
Toggle button (✕/✓):
toggleBtn.addEventListener('click', (e) => {
e.stopPropagation();
if (hiddenCategories.has(cat)) {
hiddenCategories.delete(cat);
catDiv.classList.remove('category-hidden');
toggleBtn.textContent = '✕';
alwaysHideEl.style.display = 'none';
} else {
hiddenCategories.add(cat);
catDiv.classList.add('category-hidden');
toggleBtn.textContent = '✓';
alwaysHideEl.style.display = 'inline';
}
});
Always hide text:
alwaysHideEl.addEventListener('click', (e) => {
e.stopPropagation();
if (alwaysHiddenCategories.has(cat)) {
alwaysHiddenCategories.delete(cat);
alwaysHideEl.classList.remove('active');
} else {
alwaysHiddenCategories.add(cat);
hiddenCategories.add(cat);
catDiv.classList.add('category-hidden');
toggleBtn.textContent = '✓';
alwaysHideEl.style.display = 'inline';
alwaysHideEl.classList.add('active');
}
saveSettings();
});
displayTags Integration
displayTags() renders each .category-header with a .category-header-actions flex container on the right side containing:
- A
.category-toggle-btn(✕ when visible, ✓ when hidden) - A
.category-always-hidespan (only present when category is hidden; gets.activeclass and purple underline when persisted)
The function determines isHidden and isAlways state per category on each render call. The .category-block receives .category-hidden class when isHidden is true. Tags inside hidden blocks are made non-interactive via CSS pointer-events: none.
State Flow
uploadImage() → hiddenCategories = new Set(alwaysHiddenCategories) → displayTags()
↓
Click ✕ → hiddenCategories.add(cat) → DOM: add class, ✓, show always-hide
↓
Click ✓ → hiddenCategories.delete(cat) → DOM: remove class, ✕, hide always-hide
↓
Always hide click → toggles alwaysHiddenCategories, saves → DOM: add/remove .active class
9. Tag States (CSS data-level)
IMPORTANT: Tags use data-level attribute, NOT CSS classes.
Tag bold font is preserved when manually adding/removing tags by storing original confidence level in data-original-level attribute. This allows CSS to keep bold font for tags that were originally confident even after threshold changes or manual state toggles.
// Setting data-level attribute
el.setAttribute('data-level', 'confident'); // High confidence
el.setAttribute('data-level', 'all'); // Above all threshold
el.setAttribute('data-level', 'added'); // User added
el.setAttribute('data-level', 'removed'); // User removed
// Preserving original level for bold font
el.setAttribute('data-original-level', 'confident'); // Preserve bold when manually toggling
el.setAttribute('data-original-level', 'all'); // Preserve normal weight
| data-level | Condition | CSS Variable |
|---|---|---|
| confident | prob >= confidentThreshold | --confident-bg (purple) |
| all | prob >= allThreshold | --all-bg (blue) |
| added | addedTags.has(tag) | --added-bg (green) |
| removed | removedTags.has(tag) | --removed-bg (red) |
| (none) | Below allThreshold | --low-bg (gray) |
| data-original-level | CSS Effect |
|---|---|
| confident | font-weight: 600 (bold) |
| all | font-weight: 400 (normal) |
10. Copy Functions
formatTags(tags)
Formats tags for clipboard output.
function formatTags(tags) {
if (currentFormat === 'e621') {
const grouped = {};
tags.forEach(t => {
let cat = t.category || 'Other';
if (cat === 'Body Color') cat = 'General';
else if (cat === 'Accessories, Items, Clothing') cat = 'General';
else if (cat === 'Actions, Positions, State') cat = 'General';
else if (cat === 'Body Features') cat = 'General';
else if (cat === 'Effects, Fluids') cat = 'General';
else if (cat === 'Fetishes, Specifics, Interactions') cat = 'General';
else if (cat === 'Genders, Demographics') cat = 'General';
else if (cat === 'Locations, Backgrounds, Setting') cat = 'General';
else if (cat === 'Poses, Scenarios, Situations') cat = 'General';
else if (cat === 'Style, Perspective') cat = 'General';
else if (cat === 'Text, Symbols, UI, Vocalization') cat = 'General';
else if (cat === 'Other') cat = 'General';
if (!grouped[cat]) grouped[cat] = [];
grouped[cat].push(t.tag);
});
const sortedCats = Object.keys(grouped).sort((a, b) => {
const ia = copyCategoryOrder.indexOf(a);
const ib = copyCategoryOrder.indexOf(b);
if (ia !== -1 && ib !== -1) return ia - ib;
if (ia !== -1) return -1;
if (ib !== -1) return 1;
return a.localeCompare(b);
});
return sortedCats.map(cat => grouped[cat].join(' ')).join('\n');
} else {
return tags.map(t => t.tag.replace(/_/g, ' ')).join(', ');
}
}
| Format | Internal Value | Separator | Example Output |
|---|---|---|---|
| e621 | 'e621' (danbooru) |
space | female anthro solo (per line) |
| PostyBirb | any other value | comma | female, anthro, solo |
copyToClipboard(text, count, format, btn)
Copies text to clipboard with auto-meta tags.
async function copyToClipboard(text, count, format, btn) {
if (navigator.clipboard && navigator.clipboard.writeText) {
try {
let finalText = text;
if (autoMetaTagSet && autoMetaTagSet.size > 0) {
const extras = [];
autoMetaTagSet.forEach(t => {
if (perTagAutoDisable.has(t)) return;
if (text.includes(t) || text.includes(t.replace(/_/g, ' '))) return;
extras.push(t);
});
if (extras.length > 0) {
const joiner = (format === 'e621') ? ' ' : ', ';
finalText = finalText ? finalText + (joiner) + extras.join(joiner) : extras.join(joiner);
}
}
await navigator.clipboard.writeText(finalText);
showCopySuccess(btn, count, format);
} catch { fallbackCopy(text, btn, count, format); }
} else { fallbackCopy(text, btn, count, format); }
}
fallbackCopy(text, btn, count, format)
Fallback clipboard copy for older browsers.
function fallbackCopy(text, btn, count, format) {
const textarea = document.createElement('textarea');
textarea.value = text;
textarea.style.position = 'fixed';
textarea.style.opacity = '0';
document.body.appendChild(textarea);
textarea.select();
try {
if (document.execCommand('copy')) showCopySuccess(btn, count, format);
else showNotification('Unable to copy.', 'error');
} catch { showNotification('Copy failed.', 'error'); }
document.body.removeChild(textarea);
}
showCopySuccess(btn, count, format)
Shows copy success state on button.
function showCopySuccess(btn, count, format) {
if (btn._copyTimeout) clearTimeout(btn._copyTimeout);
btn.classList.add('copied');
const displayName = format === 'e621' ? 'e621' : 'PostyBirb';
showNotification(`📋 Copied ${count} ${count === 1 ? 'tag' : 'tags'} • ${displayName}`, 'success');
btn._copyTimeout = setTimeout(() => btn.classList.remove('copied'), 1000);
}
11. File Handling Functions
handleFiles(files)
Processes uploaded files.
function handleFiles(files) {
if (files.length === 0) return;
const file = files[0];
if (!file.type.startsWith('image/')) { showNotification('Please select an image file.', 'error'); return; }
if (file.size > MAX_FILE_SIZE) { showNotification(`File too large. Maximum size is ${MAX_FILE_SIZE / (1024*1024)}MB.`, 'error'); return; }
uploadImage(file);
}
showPreview(file)
Shows image preview and fetches tags.
function showPreview(file) {
const existingImg = dropZone.querySelector('img');
if (existingImg) existingImg.remove();
uploadContent.style.display = 'none';
const img = document.createElement('img');
img.src = URL.createObjectURL(file);
img.alt = 'Preview';
img.onload = function() {
img.width = img.naturalWidth;
img.height = img.naturalHeight;
};
dropZone.appendChild(img);
dropZone.classList.add('has-image');
}
uploadImage(file)
Uploads image to API and processes response.
async function uploadImage(file) {
showPreview(file);
dropZone.classList.add('uploading');
const wasVisible = results.classList.contains('visible');
if (wasVisible) await hideResults();
const formData = new FormData();
formData.append('image', file);
formData.append('top_k', maxTags.toString());
try {
const response = await fetch('/predict', { method: 'POST', body: formData });
if (!response.ok) {
let errorMsg = 'Server error. Please try again later.';
try { const data = await response.json(); errorMsg = data.error || errorMsg; } catch (e) {}
throw new Error(errorMsg);
}
const data = await response.json();
if (data.success) {
const baseTags = data.tags || [];
const autoMeta = data.auto_meta || [];
const merged = baseTags.slice();
const currentYearTag = String(new Date().getFullYear());
autoMeta.forEach(t => {
if (!merged.find(x => x.tag === t)) {
if (t === currentYearTag && !addCurrentYearTag) return;
merged.push({ tag: t, prob: 1.0, category: 'Meta' });
}
});
allTags = merged;
autoMetaTagSet = new Set(autoMeta);
addedTags.clear();
removedTags.clear();
hiddenCategories = new Set(alwaysHiddenCategories); // Re-apply persistent hidden
currentFormat = savedFormat;
updateLocalFormatUI();
displayTags(allTags);
await showResults();
} else showNotification(data.error || 'Failed to generate tags.', 'error');
} catch (err) { showNotification(err.message || 'Network error. Please try again.', 'error'); }
finally { dropZone.classList.remove('uploading'); }
}
12. Fullscreen Image Functions
State Variables
let fullscreenImageModal = null; // Modal DOM element (dynamically created)
let isFullscreenActive = false; // Current state
createFullscreenModal()
Creates the fullscreen modal DOM element dynamically. Called on first use.
function createFullscreenModal() {
const modal = document.createElement('div');
modal.id = 'fullscreenImageModal';
modal.className = 'fullscreen-image-modal';
modal.innerHTML = `
<div class="fullscreen-image-modal-overlay"></div>
<div class="fullscreen-image-container" id="fullscreenImageContainer">
<img class="fullscreen-image" id="fullscreenImage" alt="Fullscreen preview">
</div>
`;
document.body.appendChild(modal);
modal.addEventListener('click', hideFullscreenImage);
return modal;
}
showFullscreenImage(src)
Shows the fullscreen modal with the provided image source.
function showFullscreenImage(src) {
if (!fullscreenImageModal) {
fullscreenImageModal = createFullscreenModal();
}
fullscreenImageModal.style.display = 'flex';
const img = document.getElementById('fullscreenImage');
img.src = src;
document.body.classList.add('modal-open');
requestAnimationFrame(() => fullscreenImageModal.classList.add('show'));
isFullscreenActive = true;
}
hideFullscreenImage()
Hides the fullscreen modal and resets state. Uses transition cleanup to properly hide the modal after fade animation completes.
function hideFullscreenImage() {
if (!fullscreenImageModal) return;
fullscreenImageModal.classList.remove('show');
const cleanup = () => {
if (!fullscreenImageModal.classList.contains('show')) {
fullscreenImageModal.style.display = 'none';
document.body.classList.remove('modal-open');
}
fullscreenImageModal.removeEventListener('transitionend', cleanup);
};
fullscreenImageModal.addEventListener('transitionend', cleanup, { once: true });
isFullscreenActive = false;
}
Keyboard Shortcuts
Note: Uses
e.codefor layout-independent key detection (works on all keyboard layouts).
| Key | Action |
|---|---|
F (or KeyF position) |
Toggle fullscreen (open/close) |
ESC |
Close fullscreen |
Modal Click
Clicking anywhere within the fullscreen modal (overlay or image) closes it.
LocalStorage
None - fullscreen state is ephemeral and not persisted.
13. Help Modal Functions
openHelpModal()
function openHelpModal() {
if (settingsMenu.classList.contains('show')) toggleSettings(false);
helpModal.style.display = 'flex';
document.body.classList.add('modal-open');
requestAnimationFrame(() => helpModal.classList.add('show'));
}
closeHelpModal()
function closeHelpModal() {
helpModal.classList.remove('show');
const cleanup = () => {
if (!helpModal.classList.contains('show')) {
helpModal.style.display = 'none';
document.body.classList.remove('modal-open');
}
helpModal.removeEventListener('transitionend', cleanup);
};
helpModal.addEventListener('transitionend', cleanup, { once: true });
setTimeout(() => {
if (helpModal.style.display === 'flex') cleanup();
}, 500);
}
14. Hammer.js Setup Functions
attachHammerTap(element, handler)
Attaches Hammer.js tap event handler.
function attachHammerTap(element, handler) {
const hammer = new Hammer(element);
hammer.on('tap', handler);
}
initHammer()
Initializes Hammer.js for all interactive elements.
function initHammer() {
attachHammerTap(dropZone, () => fileInput.click());
attachHammerTap(eggContainer, () => {
const isOpen = eggContainer.classList.contains('open');
if (!isOpen) {
const randomIndex = Math.floor(Math.random() * creaturePaths.length);
eggCreature.src = creaturePaths[randomIndex];
}
eggContainer.classList.toggle('open');
});
attachHammerTap(settingsToggle, (e) => {
settingsToggle.classList.add('pressed');
setTimeout(() => { settingsToggle.classList.remove('pressed'); }, 100);
toggleSettings(!settingsMenu.classList.contains('show'));
});
attachHammerTap(closeSettings, () => toggleSettings(false));
attachHammerTap(applyCustom, () => {
const all = parseFloat(customAllInput.value);
const conf = parseFloat(customConfidentInput.value);
if (isNaN(all) || isNaN(conf) || all < 0 || all > 1 || conf < 0 || conf > 1) {
showNotification('Please enter valid numbers between 0 and 1.', 'error');
return;
}
allThreshold = all; confidentThreshold = conf;
activePreset = 'custom';
applyThresholds();
});
attachHammerTap(resetBtn, () => {
allThreshold = 0.60; confidentThreshold = 0.70; savedFormat = 'e621';
currentFormat = savedFormat; currentTheme = 'system'; activePreset = 'standard'; maxTags = 200;
alwaysHiddenCategories.clear();
hiddenCategories.clear();
document.querySelectorAll('#themeToggle .theme-option').forEach(btn => {
btn.classList.toggle('active', btn.dataset.value === 'system');
});
document.querySelectorAll('#maxTagsToggle .max-tag-option').forEach(btn => {
btn.classList.toggle('active', btn.dataset.value === '200');
});
updateTheme('system');
applyThresholds();
saveSettings();
if (allTags.length) displayTags(allTags);
});
presetBtns.forEach(btn => {
attachHammerTap(btn, () => {
const preset = btn.dataset.preset;
if (preset === 'custom') {
activePreset = 'custom';
updateThresholdUI();
saveSettings();
return;
}
activePreset = preset;
switch (preset) {
case 'conservative': allThreshold = 0.70; confidentThreshold = 0.80; break;
case 'standard': allThreshold = 0.60; confidentThreshold = 0.70; break;
case 'liberal': allThreshold = 0.50; confidentThreshold = 0.60; break;
}
customAllInput.value = allThreshold.toFixed(2);
customConfidentInput.value = confidentThreshold.toFixed(2);
applyThresholds();
});
});
document.querySelectorAll('#themeToggle .theme-option').forEach(btn => {
attachHammerTap(btn, () => {
document.querySelectorAll('#themeToggle .theme-option').forEach(b => b.classList.remove('active'));
btn.classList.add('active');
currentTheme = btn.dataset.value;
updateTheme(currentTheme);
saveSettings();
});
});
document.querySelectorAll('#defaultFormatToggle .format-option').forEach(btn => {
attachHammerTap(btn, () => {
document.querySelectorAll('#defaultFormatToggle .format-option').forEach(b => b.classList.remove('active'));
btn.classList.add('active');
savedFormat = btn.dataset.value;
currentFormat = savedFormat;
saveSettings();
});
});
document.querySelectorAll('#resultsFormatToggle .format-option').forEach(btn => {
attachHammerTap(btn, () => {
document.querySelectorAll('#resultsFormatToggle .format-option').forEach(b => b.classList.remove('active'));
btn.classList.add('active');
currentFormat = btn.dataset.value;
});
});
document.querySelectorAll('#maxTagsToggle .max-tag-option').forEach(btn => {
attachHammerTap(btn, () => {
document.querySelectorAll('#maxTagsToggle .max-tag-option').forEach(b => b.classList.remove('active'));
btn.classList.add('active');
maxTags = parseInt(btn.dataset.value);
saveSettings();
});
});
const yearTagToggle = document.getElementById('yearTagToggle');
if (yearTagToggle) {
yearTagToggle.addEventListener('change', () => {
addCurrentYearTag = yearTagToggle.checked;
const currentYearTag = String(new Date().getFullYear());
if (addCurrentYearTag) {
perTagAutoDisable.delete(currentYearTag);
} else {
perTagAutoDisable.add(currentYearTag);
}
saveSettings();
});
}
}
15. Results Display Functions
hideResults()
Hides results container with animation.
async function hideResults() {
if (!results.classList.contains('visible')) return Promise.resolve();
results.classList.remove('visible');
return new Promise(resolve => {
const onTransitionEnd = () => { results.style.display = 'none'; results.removeEventListener('transitionend', onTransitionEnd); resolve(); };
results.addEventListener('transitionend', onTransitionEnd, { once: true });
});
}
showResults()
Shows results container.
async function showResults() {
if (results.classList.contains('visible')) return Promise.resolve();
results.style.display = 'block';
results.offsetHeight;
results.classList.add('visible');
return Promise.resolve();
}
applyThresholds()
Applies threshold settings and re-renders.
function applyThresholds() {
if (allTags.length) {
refreshTagClasses();
}
updateThresholdUI();
saveSettings();
}
16. Event Listeners
File Input Events
// Prevent defaults
['dragenter', 'dragover', 'dragleave', 'drop'].forEach(eventName => dropZone.addEventListener(eventName, preventDefaults, false));
['dragenter', 'dragover'].forEach(eventName => dropZone.addEventListener(eventName, () => dropZone.classList.add('dragover'), false));
['dragleave', 'drop'].forEach(eventName => dropZone.addEventListener(eventName, () => dropZone.classList.remove('dragover'), false));
dropZone.addEventListener('drop', (e) => { const dt = e.dataTransfer; const files = dt.files; if (files.length) handleFiles(files); });
fileInput.addEventListener('change', () => handleFiles(fileInput.files));
document.addEventListener('paste', (e) => {
const items = e.clipboardData?.items;
if (!items) return;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item.type.startsWith('image/')) {
const file = item.getAsFile();
if (file) { handleFiles([file]); e.preventDefault(); break; }
}
}
});
document.addEventListener('click', (e) => {
if (currentPopup && !currentPopup.contains(e.target) && (!activePopupTagElement || !activePopupTagElement.contains(e.target))) closePopup();
if (!settingsMenu.contains(e.target) && !settingsToggle.contains(e.target)) toggleSettings(false);
if (helpModal && helpModal.style.display === 'flex') {
const modalContent = helpModal.querySelector('.help-modal-content');
if (e.target === helpModal || (helpModal.contains(e.target) && modalContent && !modalContent.contains(e.target))) closeHelpModal();
}
});
window.addEventListener('resize', () => {
if (settingsMenu.classList.contains('show')) positionSettingsMenu();
});
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape') {
if (helpModal && helpModal.style.display === 'flex') closeHelpModal();
if (settingsMenu.classList.contains('show')) toggleSettings(false);
if (isFullscreenActive) hideFullscreenImage();
}
if (e.code === 'KeyF' && !e.ctrlKey && !e.metaKey) {
if (isFullscreenActive) {
hideFullscreenImage();
} else {
const currentImg = dropZone.querySelector('img');
if (currentImg && currentImg.src) {
showFullscreenImage(currentImg.src);
}
}
}
});
if (helpBtn && helpModal) {
helpBtn.addEventListener('click', (e) => { e.stopPropagation(); openHelpModal(); });
if (closeHelpModalBtn) closeHelpModalBtn.addEventListener('click', closeHelpModal);
}
if ('serviceWorker' in navigator) {
navigator.serviceWorker.addEventListener('message', event => {
if (event.data && event.data.action === 'offline') {
showNotification('You are offline. Check your network connection.', 'info', 5000);
}
});
}
17. Final Initialization
results.style.display = 'none';
loadSettings();
initHammer();
setupGlobalCopyButton(copyGlobalConfident, () => confidentThreshold);
setupGlobalCopyButton(copyGlobalAll, () => allThreshold);
18. API Reference
/predict Endpoint
| Method | Path | Purpose |
|---|---|---|
| POST | /predict | Tag image |
Request Format
POST /predict
Content-Type: multipart/form-data
image: <File>
top_k: <number> (optional, default 200)
Response Format
{
"success": true,
"tags": [
{ "tag": "string", "prob": 0.0-1.0, "category": "string" }
],
"auto_meta": ["string"]
}
API Response Structure
| Field | Type | Description |
|---|---|---|
| success | boolean | Success status |
| tags | array | Tag predictions |
| tags[].tag | string | Tag name |
| tags[].prob | float | Probability (0-1) |
| tags[].category | string | e621 category |
| auto_meta | array | Auto-detected tags |
19. Quick Reference for Agents
LocalStorage
| Key | Type | Description |
|---|---|---|
| e621tagger-settings | JSON | All persisted settings |
IMPORTANT: The key is e621tagger-settings (single JSON key), NOT individual keys.
Error Handling
| Error | Message |
|---|---|
| Not an image | "Please select an image file." |
| File too large | "File too large. Maximum size is 20MB." |
| API error | Shows result.error |
Tag States
| data-level | CSS Variable | Color |
|---|---|---|
| confident | --confident-bg | Purple |
| all | --all-bg | Blue |
| added | --added-bg | Green |
| removed | --removed-bg | Red |
| (none) | --low-bg | Gray |
HTML Element IDs
| ID | Element |
|---|---|
| dropZone | File drop area |
| fileInput | Hidden file input |
| results | Results container |
| categoriesContainer | Category tags |
| ratingDisplay | Rating badges |
| settingsMenu | Settings panel |
| helpModal | Help overlay |
| notification-container | Toast container |