* Ensure `updateChargeStatsDisplay` reliably updates charges and full charge display.
* Fix interval handling: clear previous intervals and reset variable to `null`.
* Inline full charge display logic, defaulting to `--:--:--` when not available.
Benefits:
* Charge stats now update consistently without missing ticks.
* Interval management is safer, preventing multiple overlapping timers.
Note:
* Full stats partial update logic is now fully integrated; previous issue of UI flicker or missed updates is resolved.
- Replace `currentCharges` with `displayCharges` for UI representation.
- Introduce `preciseCurrentCharges` to track fractional charge values.
- Update logic in `resetEdgeTracking`, `maybeNotifyChargesReached`, and related functions to use `displayCharges`.
- Modify `updateFullChargeDisplay` to calculate and use `preciseCurrentCharges` and `displayCharges`.
- Refactor `getRemainingMsToThreshold` into `getMsToTargetCharges` for clarity and precision.
- Replace `startChargesThresholdTicker` and `updateChargesThresholdUI` with a unified `updateChargesThresholdUI` function.
- Update HTML templates and dynamic UI updates to reflect `displayCharges`.
Benefits:
- Improves accuracy by distinguishing between displayed and precise charge values.
- Simplifies charge-related logic and reduces redundant calculations.
- Enhances readability and maintainability of charge tracking and UI updates.
Note:
- Ensure all dependent modules correctly handle the new `displayCharges` and `preciseCurrentCharges` fields.
- Introduce conditions to determine whether to call the API based on forced refresh, first check, or elapsed time.
- Add randomization for update intervals between 60s and 90s to stagger API requests.
- Preserve existing behavior of updating charges, cooldown, and max charges when API is called.
- Clear and reset the interval for `updateFullChargeDisplay` only when necessary.
Benefits:
- Reduces server load by avoiding frequent unnecessary API calls.
- Improves efficiency by introducing randomized update intervals.
- Maintains backward compatibility with existing functionality.
Note:
- Ensure `WPlaceService.getCharges()` continues to return valid data under new conditions.
- Replace `wplace-random-batch-input` and `wplace-block-size-input` classes with `wplace-settings-number-input`.
- Update CSS to consolidate styles under `wplace-settings-number-input`.
- Refactor theme variables for background and border colors to use explicit hex values, fixing visibility issue in light theme.
- Remove redundant `.wplace-block-size-input` styles.
Benefits:
- Number inputs are now correctly visible in all themes, including light.
- Reduces duplication in CSS by consolidating input styles.
- Improves consistency across input elements in the UI.
- Enhances clarity of theme variable usage with explicit naming.
Note:
- Ensure all components previously using `wplace-random-batch-input` or `wplace-block-size-input` are tested for visual consistency.
- Replace manual creation of multiple `<link>` elements with `appendLinkOnce` function.
- Add a utility function `appendLinkOnce` to ensure stylesheets are not added multiple times.
- Use `appendLinkOnce` for Font Awesome, Google Fonts, and external CSS links.
- Pass additional attributes (e.g., `data-*`) as an optional parameter to `appendLinkOnce`.
Benefits:
- Prevents potential issues caused by duplicate stylesheets.
- Reduces code duplication for creating and appending `<link>` elements.
- Improves maintainability and readability of the code.
Note:
- All future `<link>` additions should use `appendLinkOnce` to avoid similar bugs.
- Activate CSS variable settings for theming in `Auto-Image.js`.
- Update dropdown class from `wplace-selector` to `wplace-settings-select`.
- Remove inline styles from the "Apply Settings" button.
- Delete obsolete `.wplace-selector` CSS rules from `auto-image-styles.css`.
Benefits:
- Ensures consistent theming across components.
- Simplifies styling management.
- Improves maintainability by removing inline styles.
Note:
- Update dependent components to use the new `wplace-settings-select` class.
- Replace CamelCase animation names with kebab-case (e.g., `slideIn` → `slide-in`).
- Update theme class names to remove double hyphens (e.g., `wp-place-theme--classic` → `wp-place-theme-classic`).
- Standardize color syntax to use modern `rgb()` format with percentage-based alpha values.
- Replace long-form hex colors with shorthand where applicable (e.g., `#ffffff` → `#fff`).
- Simplify redundant or theme-specific styles and consolidate them into single rules.
- Modularize theme-specific styling comments and ensure consistent naming conventions.
- Refactor media queries, gradients, and keyframe animations for improved readability and performance.
- Add missing button hover styles and subtle text shadow for improved contrast.
- Introduce pixel-blinking animation and neon glow effects for the neon theme.
- Optimize slider, shadow, and text variants for consistency and maintainability.
Benefits:
- Improves consistency and readability across CSS and JavaScript files.
- Enhances maintainability by modularizing theme-specific styles and adopting modern syntax.
- Reduces redundancy and file size by eliminating unused or repetitive rules.
- Aligns with modern CSS standards for better compatibility and performance.
Note:
- Ensure all theme files are updated in the `feat-external-lang` branch to avoid broken imports.
- Verify browser compatibility for `rgb` with alpha values and RGB hex alpha syntax if targeting older environments.
- Test for unintended visual changes due to removed CSS variables or consolidated rules.
- Replace old notification toggle structure with a new settings toggle structure for pixel filters.
- Add detailed descriptions for each pixel filter option (white, transparent, unavailable).
- Standardize the styling of toggle titles and descriptions using theme-based colors.
- Introduce a flexbox layout for pixel filter controls to improve spacing and alignment.
- Update language file keys and values for clarity and consistency.
- Add console logs and user alerts for toggle state changes to enhance feedback.
- Ensure toggle states are synchronized with the application state on initialization.
Benefits:
- Improves usability by providing clear descriptions for each option.
- Enhances visual consistency with theme-based styling.
- Simplifies maintenance with a unified toggle structure.
Note:
- Ensure all themes define `text` and `highlight` properties to avoid fallback styling issues.
- Replace `dynamicSleep` implementation with adaptive interval logic.
- Simplify error handling and button state management in `startPainting`.
- Update charges threshold logic to use `dynamicSleep` with inline checks.
- Add early exit for overlay tiles not loaded scenario.
Benefits:
- Reduces unnecessary polling by dynamically adjusting sleep intervals.
- Improves clarity and maintainability of painting flow.
- Ensures proper UI state updates based on stop flag and thresholds.
- Move coordinate generation defaults (mode, direction, snake pattern, block size) and theme settings to CONFIG object.
- Replace hardcoded values with references to CONFIG for consistency across coordinate mode, direction, snake pattern, block width, and height.
- Add `paintUnavailablePixels` toggle to replace `strictSkipUnavailable` functionality and introduce a new "Paint Unavailable" toggle in the UI.
- Refactor `updateCoordinateUI` function to accept parameters explicitly, move it to `Utils`, and dynamically toggle UI controls based on mode.
- Standardize checkbox and slider styles by replacing inline ternary operators and `.wplace-blue-marble-checkbox` with cleaner logic and reusable `.wplace-settings-checkbox`.
- Introduce new CSS class `.wplace-pixel-filter-controls` for pixel filter UI.
- Update migration and theme selection logic to use CONFIG defaults and `CONFIG.THEMES` for backward compatibility.
- Remove redundant inline conditional checks for default values in settings initialization.
Benefits:
- Improves maintainability by centralizing configuration settings and default values in CONFIG.
- Reduces duplication of hardcoded values and UI update logic across the codebase.
- Enhances flexibility for future UI updates, theme changes, and clarity of painting logic.
- Aligns checkbox styling with reusable classes for consistency.
Note:
- Ensure CONFIG is properly initialized and all themes define required CONFIG properties to avoid runtime errors.
* Move previously hardcoded `strictSkipUnavailable` variable into component state
* Add detailed comments explaining color mapping and eligibility logic
* Verify existing logic remains correct through local testing
Benefits:
* Improves code readability and maintainability
* Prepares for future UI integration of `strictSkipUnavailable` setting
Note:
* No new functionality added; behavior remains unchanged
- Fix charge counter inconsistencies between Status block and Stats section.
- Implement rounding with a 0.95 threshold instead of always flooring.
- Prevent Stats counter from showing -1 when painting reaches the last pixel.
- Ensure Status UI updates correctly during painting progress (instead of being stuck on "Starting painting").
- Refactor charge calculation code for clarity and maintainability.
- Standardize dynamic sleep interval handling with a minimum threshold of 100ms.
Benefits:
- Accurate and consistent charge display across UI components.
- More reliable progress updates during painting.
- Cleaner, more maintainable codebase.
- Replace cryptic or untranslated comments with clear, descriptive English explanations.
- Standardize comment formatting for consistency across the codebase.
- Clarify logic in migration checks for version upgrades.
- Improve descriptions for cache size limiting and color matching logic.
Benefits:
- Enhances code readability and maintainability.
- Reduces confusion for developers unfamiliar with the original comments.
- Provides better context for complex logic blocks.
- Updated `noChargesThreshold` status message to use `Math.floor(current)` instead of raw `current`.
- Ensures displayed charge count is always an integer in the Status block.
Benefits:
- Prevents confusing non-integer values in the UI.
- Improves readability and consistency of charge status display.
- Update the title in `en.json` to "Auto-Image".
- Standardize button labels for upload and resize actions.
- Add new translation keys: "colorsUpdated", "overlayTilesNotLoaded", "paintingBatchFailed",
"paintingPixelCheckFailed", "paintingFinalBatchFailed", and "fullChargeIn".
- Refine messages for clarity, such as updating "noColorsFound" and "noChargesThreshold".
- Improve error and progress messages for better user understanding.
Benefits:
- Provides more descriptive and user-friendly translations.
- Enhances consistency across UI elements.
- Supports additional scenarios with new translations.
Note:
- Ensure all new keys are properly integrated into the application logic.
- Replace inline styles for turnstile title with a CSS class (`wplace-turnstile-title`).
- Add buttons for clearing ignored pixels (`clearIgnoredBtn`) and inverting masks (`invertMaskBtn`).
- Introduce a helper text (`resize-shortcut-help`) for keyboard shortcuts.
Benefits:
- Improves maintainability by using CSS classes instead of inline styles.
- Provides additional functionality for mask management and user guidance.
- Add entries for Node modules, NPM/Yarn lock files, and Prettier/ESLint configs.
- Include staged changes file and IDE-specific directory (.idea/) in ignored paths.
Benefits:
- Reduces noise in version control by excluding generated and environment-specific files.
- Improves consistency across developer environments.
- Replace inline styles with reusable CSS classes for better maintainability.
- Standardize toggle, select, and input components under consistent naming conventions (`wplace-settings-*`).
- Extract icon styling into dedicated CSS rules for consistency.
- Introduce grid layout for block size controls to improve responsiveness.
- Remove redundant styles and consolidate common patterns into shared classes.
Benefits:
- Improves code readability and reduces duplication.
- Enhances theming support by centralizing style definitions.
- Simplifies future updates to the settings UI structure.
Note:
- Ensure all theme variables (`--wplace-*`) are correctly defined in the respective theme files.
* Consolidated multi-line comments into single-line comments where appropriate to reduce clutter.
* Simplified and clarified inline comments for better code readability and maintainability.
* Refactored sitekey detection logic to use a reusable `trySitekey` function, reducing redundancy and improving maintainability.
* Enhanced fallback logic in `detectSitekey` to handle edge cases more effectively.
* Updated token generation logic to prioritize reusing pre-generated or cached tokens, optimizing performance.
* Added detailed debug logs for Turnstile token capture, token generation, validation processes, and pixel comparison.
* Improved formatting of complex log messages, dynamic strings, and template literals for better readability and debugging.
* Reworked how available colors are extracted and validated to ensure proper handling of edge cases.
* Added checks for null or insufficient color data during upload, improving error feedback to users.
* Enhanced skipped pixel tracking by restructuring logic for transparency, white pixels, and unavailable colors.
* Refactored batch processing to handle region changes more efficiently and log progress accurately.
* Updated color extraction logic to handle scenarios where no color elements are found.
* Simplified and standardized checkbox, select, slider, and toggle rendering for settings UI.
* Ensured proper alignment and spacing in multi-line template literals for themes, languages, and other dropdowns.
* Fixed minor typos, inconsistencies, and formatting issues across multiple modules.
These changes improve maintainability, debugging visibility, and robustness of pixel/color processing while enhancing overall user experience without altering core functionality.
* Refactored tile range calculation into a reusable `Utils.calculateTileRange` method.
* Added retry logic with exponential backoff in `getTilePixelColor` to handle transient bitmap read errors.
* Introduced `waitForTiles` method to ensure all required tiles are loaded before painting.
* Improved error messages for painting failures, including tile loading and pixel read errors.
* Fixed potential infinite loop in tile processing by adding timeout handling.
* Updated color resolution logic to use `availableColors` parameter name for clarity.
* Enhanced debugging logs for transparency checks and tile loading.
* Fixed diffCount calculation to correctly reflect newCount minus oldCount.
* Updated `updateStats` call to remove unnecessary parameter.
* Improved error logging with `console.error` for unexpected exceptions during image processing.
* Enhanced user feedback with additional `updateUI` calls for error states such as batch failures and tile load issues.
* Added debug logging to better track pixel painting decisions, comparing current and target colors.
* Introduced stop-checks in painting process when critical errors occur, ensuring proper UI updates and state management.
* Refined skipped pixel reporting to include unavailable colors and improved log clarity.
These changes make the overlay painting process more robust by ensuring reliable tile loading, correct pixel comparison, and accurate stats. Error handling and debugging are significantly improved, making failures easier to detect, diagnose, and recover from.
* Implemented `resolveColor` to improve color matching with exact matches, white threshold handling, and chroma penalty adjustments.
* Enhanced `extractAvailableColors` to parse RGB values robustly and skip invalid color elements with warnings.
* Refactored progress data management with `buildPaintedMapPacked`, `buildProgressData`, and `migrateProgress` for better organization and version handling.
* Added migration logic to support progress data from versions 1.x, 2.0, and 2.1 to 2.2.
* Improved error handling and logging during progress saving and loading operations.
* Updated progress file structure to include additional state details like coordinate modes, block dimensions, and painted map packing.
* Refactored progress migration to use a unified `Utils.migrateProgress`, reducing redundancy and improving maintainability.
* Simplified color matching by moving inline functions to utilities for readability and reusability.
* Enhanced `updateStats` with optional `isManualRefresh` for granular UI updates and alerts.
* Added utility functions `getRemainingMsToThreshold`, `startChargesThresholdTicker`, and `updateChargesThresholdUI` to modularize charge-related logic.
* Added coordinate generation logic supporting various modes, directions, and block configurations.
* Fixed potential issues with color filtering and invalid cache management.
* Ensured alerts and notifications are displayed correctly when colors or thresholds change.
* Simplified coordinate generation logic, removing redundant code and improving readability.
* Introduced `flushPixelBatch` for modular batch pixel processing.
* Added detailed pixel eligibility checks in `processImage` to ensure valid pixels are processed.
* Configurable transparency thresholds and strict color availability checks for flexibility.
* Improved error handling for unsupported modes and directions.
* Refactored pixel processing for readability and maintainability.
* Consolidated batch flushing logic and simplified batch size calculations.
* Enhanced logging with debug information for pixel eligibility, existing colors, and batch processing.
* Added safeguards to clear intervals and prevent memory leaks during state cleanup.
These changes improve color resolution accuracy, progress tracking, coordinate generation flexibility, and pixel processing robustness, while making the codebase more modular, maintainable, and easier to debug.
* Enabled PAINTING\_SPEED\_ENABLED by default to improve painting performance.
* Disabled desktop notifications by default to reduce interruptions.
* Lowered overlay opacity from 0.6 to 0.2 for better visibility.
* Commented out theme variable assignments for future cleanup or removal.
* Added new state properties for coordinate generation (coordinateMode, coordinateDirection, etc.) to support advanced painting strategies.
* Introduced dynamicSleep utility for more efficient sleep handling during cooldowns.
* Added msToTimeText utility to format time durations in a human-readable way.
* Implemented migration logic to version 2.2 for backward compatibility with saved progress data.
* Enhanced saveProgress and loadProgress methods to include new coordinate generation settings.
* Improved error handling in getCharges to provide default values when API calls fail.
* Refactored notification messages for better clarity and consistency.
* Added multiple coordinate generation modes including rows, columns, circle-out, circle-in, blocks, and shuffle-blocks.
* Implemented UI controls for selecting generation modes, setting block sizes, toggling snake patterns, and choosing directions.
* Enhanced settings panel with collapsible sections and improved styling for better user experience.
* Added dynamic visibility logic to show/hide relevant controls based on the selected generation mode.
* Integrated state management to persist user preferences for generation modes, directions, snake pattern toggling, and block dimensions.
* Improved logging and user feedback with success alerts when changing coordinate-related settings.
* Implemented functionality to track full charge progress using a dynamic timer.
* Displays remaining time until full charge in the UI, updating every second.
* Ensures charges are calculated accurately based on elapsed time and cooldown intervals.
* Added support for pausing and resuming charge updates when the user interacts with the system.
* Improved UI feedback for charge-related information, including current charges and full charge status.
* Refactored the pixel batch processing logic to improve readability and maintainability.
* Introduced a generateCoordinates function to handle coordinate generation for various modes (rows, columns, circle-out, etc.).
* Added support for configurable block-based painting modes (blocks and shuffle-blocks) with customizable block dimensions.
* Improved logic for handling region transitions during batch painting.
* Updated delay calculations for batch processing to better align with painting speed settings.
* Enhanced transparency and white pixel skipping logic with customizable thresholds.
* Added detailed logging for debugging and monitoring purposes.
* Ensured proper cleanup of intervals and state updates when stopping or pausing painting.
* Refactored pixel painting logic to include smarter batch processing.
* Added checks to skip already painted pixels, reducing redundant operations.
* Improved batch size calculation and handling, ensuring batches are sent optimally.
* Enhanced error handling for failed batches, preventing infinite loops in case of persistent failures.
* Introduced dynamic sleep functionality during cooldown periods to optimize resource usage.
* Updated UI interactions to reflect batch progress and cooldown states more accurately.
* Added new coordinate mode and direction settings for greater flexibility in pixel painting.
These changes improve the bot's configurability, performance, maintainability, and user experience while ensuring backward compatibility with existing progress data, accurate charge tracking, and efficient pixel painting across multiple modes.
Updated CSS variables for button border-radius across themes and adjusted layout spacing for sections and settings footer.
* Introduced `--wplace-btn-radius` for consistent button rounding in all themes.
* Reduced margins and padding for `.wplace-section` and `.wplace-status-section` for tighter layout.
* Added collapsible section behavior with arrow rotation and hidden controls.
* Made settings footer sticky with proper background and padding.
* Minor spacing and formatting fixes for better visual alignment.
* Set up a linter for local use only; changes are not pushed to the branch.
* Reformatted project files according to local linter rules.
* Improves local code consistency and readability without affecting the shared codebase.
- Add a bug report template with sections for describing the bug, expected behavior, reproduction steps, and system information.
- Add a feature request template with sections for problem description, proposed solution, alternatives, and additional context.
- Add a pull request template with fields for summary, related issues, change type, checklist, and additional notes.
- Configure issue templates to disable blank issues and provide a link to community support on Discord.
Benefits:
- Standardize issue reporting to improve clarity and consistency.
- Guide contributors in providing necessary details for bug reports and feature requests.
- Streamline pull request submissions by prompting key information.
- Reduce ambiguity in contributions and improve collaboration efficiency.
MiraclePatrickLumowa