Files
2026-08-29 11:08:02 +03:00

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-hide span (only present when category is hidden; gets .active class 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.code for 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