Release Notes

Version 2.0.0 - Major Feature Release

Release Date: October 8, 2025
Author: Kamran Gasimov
Company: Deirvlon Technologies

🎉 Overview

Select Relations JS v2.0.0 represents a major milestone in the library's evolution. This release introduces powerful new logical operators and expression evaluation capabilities while maintaining 100% backward compatibility with all v1.x implementations.

⭐ What's New

1. OR Logic Operator (`|`)

You can now create conditions where any one of multiple criteria can be met, not just all of them.

Syntax:

<option data-pr="country:usa|country:canada">Available in USA or Canada</option>

Use Cases:

Products available in multiple regions
Features accessible to multiple user types
Services offered across different categories

Example:

<select id="service" data-sf-parent="region">
  <option value="express" data-pr="region:north|region:south">
    Express Delivery (North or South regions)
  </option>
  <option value="premium" data-pr="region:north|region:south|region:east">
    Premium Service (Available in 3 regions)
  </option>
</select>

2. Parenthesis Grouping (`()`)

Build complex nested conditions with explicit control over evaluation order.

Syntax:

<option data-pr="(country:usa&state:ca)|(country:canada&province:on)">
  Complex Condition
</option>

Use Cases:

Multi-criteria product filtering
Complex business rules
Conditional feature availability
Premium membership overrides

Example:

<select id="shipping" data-sf-parent="country,membership">
  <option value="overnight" data-pr="(country:usa&membership:premium)|country:canada">
    Overnight (Premium USA members or all Canada)
  </option>
</select>

3. Enhanced Expression Evaluator

Complete rewrite of the condition evaluation engine with:

Recursive parenthesis resolution - Handles nested grouping to any depth
Proper operator precedence - AND before OR, like standard logic
Optimized parsing - Faster evaluation of complex conditions
Better error handling - Gracefully handles malformed expressions

Operator Precedence:

() Parentheses (highest priority)
& AND operator
| OR operator (lowest priority)

4. Improved Code Architecture

Refactored Functions:

evaluateRelation() - Main entry point for condition evaluation
evaluateSimpleExpression() - Handles OR/AND logic without parentheses
evaluateCondition() - Evaluates single conditions (selectId:values)

Benefits:

More maintainable codebase
Easier to extend with new features
Better performance on complex expressions
Clearer separation of concerns

🔄 Breaking Changes

None! Version 2.0.0 is 100% backward compatible with v1.x.

All existing implementations will continue to work without any modifications. The new features are purely additive.

📊 Comparison: v1.x vs v2.0.0

Feature	v1.1.4	v2.0.0
AND Logic (&)	✅	✅
OR Logic (\|)	❌	✅
Parenthesis Grouping	❌	✅
Multiple Values	✅	✅
Checkbox Support	✅	✅
Multi-Parent	✅	✅
Select2 Integration	✅	✅
Auto-Reset	✅	✅
Operator Precedence	N/A	✅
Nested Conditions	❌	✅

💡 Usage Examples

Simple OR

<!-- v1.x: Not possible -->
<!-- v2.0.0: Easy! -->
<option data-pr="category:electronics|category:computers">
  Available in Electronics or Computers
</option>

Complex Business Logic

<!-- v1.x: Would require multiple options or JavaScript -->
<!-- v2.0.0: Single elegant condition -->
<option data-pr="(status:active&plan:premium)|(status:trial&feature:enabled)">
  Premium features or trial with feature flag
</option>

Mixed AND/OR Logic

<!-- v1.x: Not possible -->
<!-- v2.0.0: Intuitive syntax -->
<option data-pr="country:usa&(state:ca|state:ny|state:tx)">
  USA only, but available in CA, NY, or TX
</option>

Premium Override Pattern

<!-- v1.x: Would need separate options -->
<!-- v2.0.0: Single condition with override -->
<option data-pr="(country:usa&subscription:basic)|membership:premium">
  USA Basic subscribers OR any Premium member
</option>

🚀 Performance Improvements

30% faster evaluation of simple conditions
Optimized recursive parsing for complex expressions
Reduced DOM queries through better caching
Smarter update logic prevents unnecessary re-evaluations

🐛 Bug Fixes

Fixed in v2.0.0:

Issue #47: Reset function now properly handles Select2 elements with null values
Issue #52: Improved handling of undefined parent elements
Issue #58: Better whitespace handling in condition strings
Issue #63: Fixed edge case where disabled options weren't properly hidden
Performance: Reduced redundant filtering on cold start

🔧 Technical Changes

New Functions:

evaluateRelation(relationData)           // Main evaluator with parenthesis support
evaluateSimpleExpression(expression)     // Handles AND/OR without parentheses
evaluateCondition(condition)             // Evaluates single condition

Modified Functions:

updateFiltering(select, restart)         // Now uses evaluateRelation()

Unchanged Functions:

initializeFiltering()                    // No changes
resetParentSelects()                     // No changes

📦 Migration Guide

From v1.1.4 to v2.0.0

Step 1: Update the script source

<!-- Old -->
<script src="select-relations-v1.1.4.js"></script>
<!-- New -->

<script src="select-relations-v2.0.0.js"></script>

Step 2: Test your existing implementation

All v1.x syntax continues to work
No code changes required

Step 3: (Optional) Enhance with new features

Add OR logic where applicable
Use grouping for complex conditions
Simplify multiple similar options

Example Migration:

Before (v1.x):

<option data-pr="country:usa&state:ca">California</option>
<option data-pr="country:usa&state:ny">New York</option>
<option data-pr="country:canada&province:on">Ontario</option>

After (v2.0.0) - Consolidated:

<option data-pr="(country:usa&state:ca)|(country:usa&state:ny)|(country:canada&province:on)">
  Available Regions
</option>

Or even better:

<option data-pr="country:usa&(state:ca|state:ny)|country:canada&province:on">
  Available Regions
</option>

🎯 Use Case Scenarios

E-commerce

<!-- Dynamic shipping based on location and membership -->
<option data-pr="(country:usa&weight:0,5)|(membership:premium&weight:0,10)">
  Free Shipping
</option>

SaaS Platforms

<!-- Feature availability based on plan or trial status -->
<option data-pr="(plan:pro|plan:enterprise)|(trial:active&feature_flag:enabled)">
  Advanced Analytics
</option>

Multi-Region Applications

<!-- Services available in specific region combinations -->
<option data-pr="(region:eu&gdpr:compliant)|(region:us&ccpa:compliant)">
  Data Processing Service
</option>

Configuration Wizards

<!-- Complex product configurations -->
<option data-pr="(type:laptop&brand:apple)|(type:desktop&brand:dell|brand:hp)">
  Windows Compatible Software
</option>

📚 Documentation Updates

NEW: Comprehensive syntax guide for OR and grouping
NEW: 15+ real-world examples
UPDATED: API reference with new functions
UPDATED: Performance optimization guide
NEW: Operator precedence explanation
NEW: Complex condition patterns and best practices

🔮 Future Roadmap (v2.1.0+)

Planned features for upcoming releases:

NOT operator (!) for negation logic
Regular expression support for value matching
Custom operators API
Condition templates/macros
Visual condition builder tool
TypeScript definitions
React/Vue component wrappers

🙏 Acknowledgments

Special thanks to our community contributors:

Beta Testers: 15+ developers who tested v2.0.0-beta
Feature Requests: Community members who requested OR logic (#12, #28, #45)
Bug Reports: Users who identified edge cases in v1.x

📞 Support

Documentation: https://deirvlon.github.io/select-relations
Issues: https://github.com/deirvlon/select-relations/issues
Email: support@deirvlon.com
Discord: https://discord.gg/deirvlon

📄 License

MIT License - See LICENSE file for details.

Download: select-relations-v2.0.0.js
Changelog: CHANGELOG.md
Documentation: README.md

Version History

v2.0.0 (Oct 8, 2025) - OR logic, parenthesis grouping, enhanced evaluator
v1.1.4 (Apr 12, 2025) - Bug fixes and performance improvements
v1.1.0 (Feb 15, 2025) - Select2 integration improvements
v1.0.0 (Apr 9, 2024) - Initial release

# Release Notes

Version 2.0.0 - Major Feature Release

Release Date: October 8, 2025
Author: Kamran Gasimov
Company: Deirvlon Technologies

🎉 Overview

⭐ What's New

1. OR Logic Operator (`|`)

You can now create conditions where any one of multiple criteria can be met, not just all of them.

Syntax:

<option data-pr="country:usa|country:canada">Available in USA or Canada</option>

Use Cases:

Products available in multiple regions
Features accessible to multiple user types
Services offered across different categories

Example:

<select id="service" data-sf-parent="region">
  <option value="express" data-pr="region:north|region:south">
    Express Delivery (North or South regions)
  </option>
  <option value="premium" data-pr="region:north|region:south|region:east">
    Premium Service (Available in 3 regions)
  </option>
</select>

2. Parenthesis Grouping (`()`)

Build complex nested conditions with explicit control over evaluation order.

Syntax:

<option data-pr="(country:usa&state:ca)|(country:canada&province:on)">
  Complex Condition
</option>

Use Cases:

Multi-criteria product filtering
Complex business rules
Conditional feature availability
Premium membership overrides

Example:

<select id="shipping" data-sf-parent="country,membership">
  <option value="overnight" data-pr="(country:usa&membership:premium)|country:canada">
    Overnight (Premium USA members or all Canada)
  </option>
</select>

3. Enhanced Expression Evaluator

Complete rewrite of the condition evaluation engine with:

Recursive parenthesis resolution - Handles nested grouping to any depth
Proper operator precedence - AND before OR, like standard logic
Optimized parsing - Faster evaluation of complex conditions
Better error handling - Gracefully handles malformed expressions

Operator Precedence:

() Parentheses (highest priority)
& AND operator
| OR operator (lowest priority)

4. Improved Code Architecture

Refactored Functions:

evaluateRelation() - Main entry point for condition evaluation
evaluateSimpleExpression() - Handles OR/AND logic without parentheses
evaluateCondition() - Evaluates single conditions (selectId:values)

Benefits:

More maintainable codebase
Easier to extend with new features
Better performance on complex expressions
Clearer separation of concerns

🔄 Breaking Changes

None! Version 2.0.0 is 100% backward compatible with v1.x.

All existing implementations will continue to work without any modifications. The new features are purely additive.

📊 Comparison: v1.x vs v2.0.0

Feature	v1.1.4	v2.0.0
AND Logic (`&`)	✅	✅
OR Logic (`\|`)	❌	✅
Parenthesis Grouping	❌	✅
Multiple Values	✅	✅
Checkbox Support	✅	✅
Multi-Parent	✅	✅
Select2 Integration	✅	✅
Auto-Reset	✅	✅
Operator Precedence	N/A	✅
Nested Conditions	❌	✅

💡 Usage Examples

Simple OR

<!-- v1.x: Not possible -->
<!-- v2.0.0: Easy! -->
<option data-pr="category:electronics|category:computers">
  Available in Electronics or Computers
</option>

Complex Business Logic

<!-- v1.x: Would require multiple options or JavaScript -->
<!-- v2.0.0: Single elegant condition -->
<option data-pr="(status:active&plan:premium)|(status:trial&feature:enabled)">
  Premium features or trial with feature flag
</option>

Mixed AND/OR Logic

<!-- v1.x: Not possible -->
<!-- v2.0.0: Intuitive syntax -->
<option data-pr="country:usa&(state:ca|state:ny|state:tx)">
  USA only, but available in CA, NY, or TX
</option>

Premium Override Pattern

<!-- v1.x: Would need separate options -->
<!-- v2.0.0: Single condition with override -->
<option data-pr="(country:usa&subscription:basic)|membership:premium">
  USA Basic subscribers OR any Premium member
</option>

🚀 Performance Improvements

30% faster evaluation of simple conditions
Optimized recursive parsing for complex expressions
Reduced DOM queries through better caching
Smarter update logic prevents unnecessary re-evaluations

🐛 Bug Fixes

Fixed in v2.0.0:

Issue #47: Reset function now properly handles Select2 elements with null values
Issue #52: Improved handling of undefined parent elements
Issue #58: Better whitespace handling in condition strings
Issue #63: Fixed edge case where disabled options weren't properly hidden
Performance: Reduced redundant filtering on cold start

🔧 Technical Changes

New Functions:

evaluateRelation(relationData)           // Main evaluator with parenthesis support
evaluateSimpleExpression(expression)     // Handles AND/OR without parentheses
evaluateCondition(condition)             // Evaluates single condition

Modified Functions:

updateFiltering(select, restart)         // Now uses evaluateRelation()

Unchanged Functions:

initializeFiltering()                    // No changes
resetParentSelects()                     // No changes

📦 Migration Guide

From v1.1.4 to v2.0.0

Step 1: Update the script source

<!-- Old -->
<script src="select-relations-v1.1.4.js"></script>

<!-- New -->
<script src="select-relations-v2.0.0.js"></script>

Step 2: Test your existing implementation

All v1.x syntax continues to work
No code changes required

Step 3: (Optional) Enhance with new features

Add OR logic where applicable
Use grouping for complex conditions
Simplify multiple similar options

Example Migration:

Before (v1.x):

<option data-pr="country:usa&state:ca">California</option>
<option data-pr="country:usa&state:ny">New York</option>
<option data-pr="country:canada&province:on">Ontario</option>

After (v2.0.0) - Consolidated:

<option data-pr="(country:usa&state:ca)|(country:usa&state:ny)|(country:canada&province:on)">
  Available Regions
</option>

Or even better:

<option data-pr="country:usa&(state:ca|state:ny)|country:canada&province:on">
  Available Regions
</option>

🎯 Use Case Scenarios

E-commerce

<!-- Dynamic shipping based on location and membership -->
<option data-pr="(country:usa&weight:0,5)|(membership:premium&weight:0,10)">
  Free Shipping
</option>

SaaS Platforms

<!-- Feature availability based on plan or trial status -->
<option data-pr="(plan:pro|plan:enterprise)|(trial:active&feature_flag:enabled)">
  Advanced Analytics
</option>

Multi-Region Applications

<!-- Services available in specific region combinations -->
<option data-pr="(region:eu&gdpr:compliant)|(region:us&ccpa:compliant)">
  Data Processing Service
</option>

Configuration Wizards

<!-- Complex product configurations -->
<option data-pr="(type:laptop&brand:apple)|(type:desktop&brand:dell|brand:hp)">
  Windows Compatible Software
</option>

📚 Documentation Updates

NEW: Comprehensive syntax guide for OR and grouping
NEW: 15+ real-world examples
UPDATED: API reference with new functions
UPDATED: Performance optimization guide
NEW: Operator precedence explanation
NEW: Complex condition patterns and best practices

🔮 Future Roadmap (v2.1.0+)

Planned features for upcoming releases:

NOT operator (!) for negation logic
Regular expression support for value matching
Custom operators API
Condition templates/macros
Visual condition builder tool
TypeScript definitions
React/Vue component wrappers

🙏 Acknowledgments

Special thanks to our community contributors:

Beta Testers: 15+ developers who tested v2.0.0-beta
Feature Requests: Community members who requested OR logic (#12, #28, #45)
Bug Reports: Users who identified edge cases in v1.x

📞 Support

Documentation: https://deirvlon.github.io/select-relations
Issues: https://github.com/deirvlon/select-relations/issues
Email: support@deirvlon.com

📄 License

MIT License - See LICENSE file for details.

Download: [select-relations-v2.0.0.js](https://deirvlon.github.io/select-relations/select-relations.js)
Changelog: CHANGELOG.md
Documentation: README.md

Version History

v2.0.0 (Oct 8, 2025) - OR logic, parenthesis grouping, enhanced evaluator
v1.1.4 (Apr 12, 2025) - Bug fixes and performance improvements
v1.1.0 (Feb 15, 2025) - Select2 integration improvements
v1.0.0 (Apr 9, 2024) - Initial release

Full Changelog: https://github.com/deirvlon/select-relations/commits/v2.0.0

Select Relations JS v2.0.0

Release Notes

Version 2.0.0 - Major Feature Release

🎉 Overview

⭐ What's New

1. OR Logic Operator (|)

2. Parenthesis Grouping (())

3. Enhanced Expression Evaluator

4. Improved Code Architecture

🔄 Breaking Changes

📊 Comparison: v1.x vs v2.0.0

💡 Usage Examples

Simple OR

Complex Business Logic

Mixed AND/OR Logic

Premium Override Pattern

🚀 Performance Improvements

🐛 Bug Fixes

Fixed in v2.0.0:

🔧 Technical Changes

New Functions:

Modified Functions:

Unchanged Functions:

📦 Migration Guide

From v1.1.4 to v2.0.0

Example Migration:

🎯 Use Case Scenarios

E-commerce

SaaS Platforms

Multi-Region Applications

Configuration Wizards

📚 Documentation Updates

🔮 Future Roadmap (v2.1.0+)

🙏 Acknowledgments

📞 Support

📄 License

Version History

Version 2.0.0 - Major Feature Release

🎉 Overview

⭐ What's New

1. OR Logic Operator (|)

2. Parenthesis Grouping (())

3. Enhanced Expression Evaluator

4. Improved Code Architecture

🔄 Breaking Changes

📊 Comparison: v1.x vs v2.0.0

💡 Usage Examples

Simple OR

Complex Business Logic

Mixed AND/OR Logic

Premium Override Pattern

🚀 Performance Improvements

🐛 Bug Fixes

Fixed in v2.0.0:

🔧 Technical Changes

New Functions:

Modified Functions:

Unchanged Functions:

📦 Migration Guide

From v1.1.4 to v2.0.0

Example Migration:

🎯 Use Case Scenarios

E-commerce

SaaS Platforms

Multi-Region Applications

Configuration Wizards

📚 Documentation Updates

🔮 Future Roadmap (v2.1.0+)

🙏 Acknowledgments

📞 Support

📄 License

Version History

Uh oh!

1. OR Logic Operator (`|`)

2. Parenthesis Grouping (`()`)

1. OR Logic Operator (`|`)

2. Parenthesis Grouping (`()`)