1.2.1

Release 1.2.1 – Changelog Summary

Version 1.2.1 is a documentation and example quality update that refines the “Copy to clipboard” utilities and improves clarity across demo pages. These changes make the examples easier to understand, reuse, and extend without affecting core functionality.

• Improved Copy-to-Clipboard Utility
  Simplified the helper logic by switching from data-code-block attributes to id-based selectors.
  Reduces complexity and makes the example code easier to follow and customize.

• Support for Multiple Code Blocks in Examples
  Enhanced the example scripts to dynamically handle multiple copy targets via data-copy-target.
  Allows each example section to provide independent, reliable copy-to-clipboard behavior.

• Example Markup Cleanup
  Refactored HTML structures and class names (e.g., copy-button) to be more consistent and readable.
  Improves maintainability and reduces confusion when adapting examples.

• Documentation Version Alignment
  Updated README files and CDN snippets to reference version 1.2.1.
  Ensures installation instructions always match the latest release.

Compatibility: Backward compatible

---

Full Changelog: 1.2.0...1.2.1

1.2.0

Release 1.2.0 – Changelog Summary

Version 1.2.0 introduces full AJAX-powered data loading with extensive configuration options, significantly expanding AvalynxSelect for dynamic, server-driven datasets. It also enhances localization, examples, and CI tooling, making the component more powerful for real-world, data-heavy applications.

• Comprehensive AJAX Data Source Support
  Added built-in AJAX loading with debouncing, minimum input length, paging, and custom request/response mapping hooks.
  Enables scalable selects backed by remote APIs without manual wiring.

• Prefetch & Default Value Resolution
  Implemented automatic prefetching and resolving of default values via AJAX (including custom resolveByValue).
  Allows seamless pre-selection even when options are loaded dynamically.

• Expanded Configuration Options
  New options such as showActive, maxItemsToShow, and a full ajax configuration object with headers, mapping, and pagination controls.
  Provides fine-grained control over rendering behavior and remote data integration.

• Enhanced Language Customization
  Added new language keys (loading, noResults, error, typeMore, idleHint) and reordered initialization for clarity.
  Improves UX feedback and simplifies internationalization.

• Improved Rendering & Filtering Logic
  Refined dropdown rendering pipeline to support dynamic datasets, empty states, and active-item handling consistently.
  Ensures predictable behavior across static and AJAX-driven selects.

• New AJAX Examples & Demo Backends
  Added multiple example pages, copy-to-clipboard helpers, and PHP demo endpoints (including slow-response simulation).
  Helps users quickly understand real-world AJAX integration patterns.

• Documentation Expansion (EN + DE)
  Added German README and extended English docs to cover AJAX usage and new configuration options.
  Makes advanced features easier to adopt and discover.

• CI, Coverage & Dependency Updates
  Introduced GitHub Actions with coverage reporting and updated Jest/Babel toolchain versions.
  Improves reliability and maintains high test quality for future changes.

Compatibility: Backward compatible

---

Full Changelog: 1.1.1...1.2.0

1.1.1

Release 1.1.1 – Changelog Summary

This release improves robustness, enhances example clarity, and updates documentation links. It introduces safer parameter handling and clearer examples for developers working with disabled or default-value selects.

• Improved Parameter Validation
  Added null and type checks for options and language parameters.
  Prevents runtime errors and ensures consistent behavior across all initialization cases.

• Enhanced Example Clarity
  Removed default value configuration from the #disabled-select example for simplicity.
  Makes example behavior more predictable and easier to understand.

• New Example Links in README
  Added “Disabled select” and “Default value select” examples to the README.
  Helps users quickly find relevant usage scenarios and learn best practices.

• Fixed Incorrect Example Links
  Corrected URLs for “Default value select” to point to the proper example page.
  Ensures that documentation links accurately reflect available demos.

• Version Alignment and CDN Update
  Updated all version headers and CDN references to 1.1.1.
  Keeps documentation and example pages in sync with the current release.

Compatibility: Backward compatible

---

Full Changelog: 1.1.0...1.1.1

1.1.0

Release 1.1.0 – Changelog Summary

This release adds first-class support for disabled states and default values, improves search robustness, and greatly expands test coverage. Docs, examples, and build tooling were refreshed to make adoption seamless.

• New Disabled State Support
  Initialize a select as disabled (or mirror the native disabled attribute) and prevent interaction at the custom button level.
  Improves accessibility and avoids accidental changes in read-only contexts.

• Default Value on Init
  New defaultValue option (and data-default-value support) preselects an item during initialization, with sensible precedence.
  Reduces boilerplate and ensures the UI reflects intended defaults immediately.

• Safer Initialization & Template Handling
  Skips empty selects, rebuilds the internal template reliably, and guards event handlers when disabled.
  Increases stability across edge cases and dynamic DOM scenarios.

• Search Robustness & UX
  Live search normalizes whitespace, respects caseSensitive, and can keep the active item visible.
  Produces more intuitive filtering and cleaner lists for end users.

• Public API Enhancements
  Added enable()/disable() and refined value getter/setter to reset or select reliably.
  Makes programmatic control straightforward for app logic and tests.

• Examples & README Updates
  New examples for Disabled select and Default value; CDN snippets now reference @1.1.0.
  Shortens time-to-value with copy-pasteable demos.

• Expanded Jest Test Suite
  Comprehensive tests now cover init paths, options, live search, selection, API methods, and disabled/default flows.
  Boosts confidence and prevents regressions.

• Dev Container Modernization
  Dockerfile updated to PHP 8.3, adds Node 18 + Yarn for local builds.
  Smooths contributor setup and aligns with current tooling.

Compatibility: Backward compatible.

---

Full Changelog: 1.0.0...1.1.0

1.0.0

Release 1.0.0 – Changelog Summary

Polish and packaging release focused on documentation, example cleanup, and distribution details. A small example-format fix and clearer install paths make getting started smoother.

• Version Bump to 1.0.0
  Project metadata and headers updated to 1.0.0 across source and dist files.
  Clarifies stability and aligns CDN consumption.

• Docs & Examples Refresh
  README and example pages updated to reference @1.0.0.
  Reduces confusion and ensures copy-paste snippets work out of the box.

• Symfony AssetComposer Instructions
  Added install guidance for Symfony AssetComposer.
  Streamlines integration for Symfony users via a single Twig helper.

• CDN Snippet Update
  jsDelivr examples now point to the 1.0.0 build.
  Guarantees you load the latest stable artifacts.

• Example Indentation Fix
  Harmonized indentation in the JavaScript example.
  Improves readability and consistency for newcomers.

• Changelog File Removal
  Removed CHANGELOG.md from the repo; use GitHub compare for history.
  Encourages a single source of truth for release diffs.

Compatibility: Backward compatible.

---

Full Changelog: 0.0.2...1.0.0

0.0.2

Release 0.0.2 – Changelog Summary

Focused on quality-of-life improvements: responsive sizing, new event callbacks, and documentation/examples to make integration smoother. Includes minor fixes and cleanup to keep the package lean.

• Template Rename
  The base template id changed to avalynx-select-template for clarity and future-proofing.
  Helps avoid clashes with other components.

• Responsive Dropdown Width
  The dropdown now auto-sizes to the trigger button and updates on window resize.
  Ensures consistent, polished layouts across breakpoints.

• Event Callbacks (onChange, onLoaded)
  Added onChange and onLoaded options for easy hooks into user interactions and init lifecycle.
  Enables straightforward integration with app logic and analytics.

• Duplicate ID Fix
  Resolved a duplicate id issue in generated elements.
  Prevents accessibility and DOM-selection pitfalls.

• ESM & Build Flow Enhancements
  ESM handling adjusted and a lightweight build script added.
  Improves module consumption and makes local builds predictable.

• Assets Manifest
  Introduced assetscomposer.json enumerating dist and dev files.
  Simplifies asset management in consuming pipelines.

• Docs & Examples Refresh
  README updated (CDN bump to 0.0.2) and new examples added (responsive design, event listeners).
  Shortens the path from install to success with copy-pasteable demos.

• Test Suite Updates
  Tests now import from built artifacts and verify filtering/selection behavior more robustly.
  Increases confidence in production usage.

• Repository Hygiene
  .gitignore tweaks and vendor cleanup (e.g., removing an unused package-lock.json).
  Reduces noise and accidental dependency drift.

Compatibility: Backward compatible.

---

Full Changelog: 0.0.1...0.0.2

0.0.1

Full Changelog: https://github.com/avalynx/avalynx-select/commits/0.0.1