Release 2.0.2

.eslintignore

@@ -2,3 +2,4 @@
 **/node_modules/**
 **/vendor/**
 **/build/**
+**/coverage/**

.gitignore

@@ -18,6 +18,7 @@ phpstan.neon
 # Test output
 /tests/_output/*
 !/tests/_output/.gitkeep
+coverage/
 
 # OS files
 [Tt]humbs.db

.stylelintignore

@@ -1,5 +1,6 @@
 ## Ignore build and dependency directories
 /build
+/coverage
 /node_modules
 /tests
 /vendor

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [2.0.2](https://github.com/rtCamp/rt-carousel/compare/2.0.1...2.0.2) (2026-06-08)
+
+
+### Features
+
+* add accessible Carousel Counter block ([#139](https://github.com/rtCamp/rt-carousel/pull/139)) ([49fd86b](https://github.com/rtCamp/rt-carousel/commit/49fd86b))
+* add slide template picker and starter templates for carousel block ([#83](https://github.com/rtCamp/rt-carousel/pull/83)) ([dd90468](https://github.com/rtCamp/rt-carousel/commit/dd90468))
+* add Terms Query support and Terms Query carousel pattern ([#131](https://github.com/rtCamp/rt-carousel/pull/131)) ([b0cf807](https://github.com/rtCamp/rt-carousel/commit/b0cf807))
+
+
+### Maintenance
+
+* confirm compatibility with WordPress 7.0
+* update axios from 1.15.0 to 1.16.0 ([#136](https://github.com/rtCamp/rt-carousel/pull/136)) ([6073e39](https://github.com/rtCamp/rt-carousel/commit/6073e39))
+* update fast-uri from 3.1.0 to 3.1.2 ([#137](https://github.com/rtCamp/rt-carousel/pull/137)) ([4762978](https://github.com/rtCamp/rt-carousel/commit/4762978))
+* update ip-address from 10.1.0 to 10.2.0 ([#135](https://github.com/rtCamp/rt-carousel/pull/135)) ([98ddd50](https://github.com/rtCamp/rt-carousel/commit/98ddd50))
+* update postcss from 8.5.6 to 8.5.13 ([#132](https://github.com/rtCamp/rt-carousel/pull/132)) ([0093274](https://github.com/rtCamp/rt-carousel/commit/0093274))
+
+
 ## [2.0.1](https://github.com/rtCamp/rt-carousel/compare/v2.0.0...v2.0.1) (2026-05-04)
 
 

README.md

@@ -1,18 +1,23 @@
 # rtCarousel
 
+![rtCarousel banner](wp-assets/banner-1544x500.png)
+
 ![Build Status](https://github.com/rtCamp/rt-carousel/actions/workflows/release.yml/badge.svg?branch=main)
 ![Latest Release](https://img.shields.io/github/v/release/rtCamp/rt-carousel)
+![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/rt-carousel)
 
 **A modular, high-performance carousel block for WordPress, powered by the Interactivity API and Embla Carousel.**
 
+[View on WordPress.org](https://wordpress.org/plugins/rt-carousel/)
+
 Easily create dynamic, accessible, and customizable carousels for any content type—posts, testimonials, images, and more. Designed for speed, flexibility, and seamless integration with the WordPress block editor.
 
 ## Features
 
 - **Flexible Compound Block Architecture**: Mix and match any blocks inside the carousel.
 - **High Performance**: Viewport & Slide Engine powered by Embla Carousel.
 - **Interactivity API**: Reactive state management with `data-wp-interactive`.
-- **Dynamic Content**: Full support for WordPress **Query Loop** block.
+- **Dynamic Content**: Full support for WordPress **Query Loop** and **Terms Query** blocks.
 - **Accessibility**: W3C-compliant roles, labels, and keyboard navigation.
 - **RTL Support**: Built-in support for Right-to-Left languages.
 
@@ -29,7 +34,7 @@ Easily create dynamic, accessible, and customizable carousels for any content ty
 
 | Requirement | Minimum      | Recommended |
 | ----------- | ------------ | ----------- |
-| WordPress   | 6.6+         | 6.9+        |
+| WordPress   | 6.6+         | 7.0+        |
 | PHP         | 8.2+         | 8.2+        |
 | Gutenberg   | Not required | —           |
 
@@ -68,9 +73,15 @@ Yes! rtCarousel is fully compatible with Full Site Editing. You can use the caro
 
 Absolutely. Each slide is a container that accepts any WordPress block—images, paragraphs, groups, columns, and even other third-party blocks.
 
-### Does it support the Query Loop block?
+### How do I add content to an empty Carousel Viewport?
+
+Use **Add Slide** for static/manual slides, **Add Query Loop** for dynamic post slides, or **Add Terms Query** for dynamic taxonomy term slides.
+
+### Does it support the Query Loop and Terms Query blocks?
+
+Yes. Add a Query Loop or Terms Query block inside the Carousel Viewport, and each post or term becomes a slide automatically. You can also start from the bundled Query Loop Carousel or Terms Query Carousel patterns.
 
-Yes. Simply add a Query Loop block inside the Carousel Viewport, and each post in the loop becomes a slide automatically. No special configuration needed.
+Do not place Query Loop or Terms Query inside a Carousel Slide block. Their generated posts or terms are used as the carousel slides automatically; Carousel Slide is intended for static or manually created slide content.
 
 ### Is it accessible?
 

docs/USAGE.md

@@ -44,6 +44,20 @@ To create a specialized carousel (e.g., testimonials only), set the `allowedSlid
 
 ---
 
+## Adding Content to an Empty Viewport
+
+When the **Carousel Viewport** is empty, rtCarousel shows three insertion actions:
+
+| Action | Use When |
+| :--- | :--- |
+| **Add Slide** | You want static or manually created slide content. |
+| **Add Query Loop** | You want dynamic post, page, product, or custom post type slides. |
+| **Add Terms Query** | You want dynamic category, tag, or custom taxonomy term slides. |
+
+Use **Add Query Loop** or **Add Terms Query** for dynamic content so the generated posts or terms become the carousel slides automatically. Use **Add Slide** only for static/manual slides.
+
+---
+
 ## Using Query Loop with Carousel
 
 You can create dynamic post sliders or content carousels using the WordPress Query Loop block.
@@ -55,12 +69,45 @@ You can create dynamic post sliders or content carousels using the WordPress Que
 4. Configure your query (post type, category, order, etc). **Disable** "Inherit query from template" if using on single posts/pages to avoid loop conflicts.
 5. Design your slide inside the Query Loop's **Post Template**.
 
-**Note:** Each post generated by the Query Loop becomes an individual slide. The system automatically detects `.wp-block-post-template` and forces horizontal flex row display. The `slideGap` attribute controls spacing.
+**Important:** Do not wrap Query Loop in a Carousel Slide block. Each post generated by the Query Loop becomes an individual carousel slide, so the Query Loop block must be placed directly inside the Carousel Viewport. The Carousel Slide block is for static or manually created slides.
+
+**Note:** The system automatically detects `.wp-block-post-template` and forces horizontal flex row display. The `slideGap` attribute controls spacing.
+
+You can also start from the bundled **rtCarousel: Query Loop Carousel** pattern.
+
+---
+
+## Using Terms Query with Carousel
+
+You can create dynamic taxonomy sliders using the WordPress Terms Query block (`core/terms-query`). This supports categories, tags, and custom taxonomies.
+
+### Setup Steps
+1. Add the **Carousel** block to your page.
+2. Select the inner **Carousel Viewport** block.
+3. Insert a **Terms Query** block directly inside the Viewport, not inside a Carousel Slide.
+4. Configure the taxonomy, order, visibility, and included terms in the Terms Query settings.
+5. Design your slide inside the Terms Query's **Term Template**.
+
+**Important:** Do not wrap Terms Query in a Carousel Slide block. Each term generated by the Terms Query becomes an individual carousel slide, so the Terms Query block must be placed directly inside the Carousel Viewport. The Carousel Slide block is for static or manually created slides.
+
+**Note:** The system automatically detects `.wp-block-term-template` and applies the same carousel layout behavior used for Query Loop. The `slideGap` attribute controls spacing.
+
+You can also start from the bundled **rtCarousel: Terms Query Carousel** pattern.
 
 ### Block Selection Guide
 
 | Use Case | Recommended Block |
 | :--- | :--- |
 | Dynamic Content (Posts, Pages, Products, Custom Post Types) | Query Loop (`core/query`) |
+| Dynamic Taxonomy Content (Categories, Tags, Custom Taxonomies) | Terms Query (`core/terms-query`) |
 | Static Content (Hero Slider, Logo Showcase, Manual Testimonials) | Carousel Slide (`rt-carousel/carousel-slide`) |
 | Mixed Content (Slide 1 is a Video, Slide 2 is Text) | Carousel Slide (`rt-carousel/carousel-slide`) |
+
+### Terms Query Selection Guide
+
+| Taxonomy Use Case | Recommended Setup |
+| :--- | :--- |
+| All categories | Terms Query (`core/terms-query`) with `taxonomy: category` |
+| All tags | Terms Query (`core/terms-query`) with `taxonomy: post_tag` |
+| Custom taxonomy terms | Terms Query (`core/terms-query`) with your taxonomy slug |
+| Hand-picked static term cards | Carousel Slide (`rt-carousel/carousel-slide`) |

examples/patterns/terms-query.php

@@ -0,0 +1,46 @@
+<?php
+/**
+ * Title: rtCarousel: Terms Query Carousel
+ * Slug: rt-carousel/terms-query-carousel
+ * Categories: rt-carousel
+ * Description: A carousel block containing a Terms Query displaying taxonomy terms (categories, tags, custom taxonomies) as slides.
+ */
+
+// Exit if accessed directly.
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+?>
+
+<!-- wp:rt-carousel/carousel {"ariaLabel":"rtCarousel: Terms Query Carousel","slideGap":16,"metadata":{"name":"rtCarousel: Terms Query Carousel","categories":["rt-carousel"],"patternName":"rt-carousel/terms-query-carousel"},"align":"wide","className":"wp-block-carousel-carousel is-style-columns-3"} -->
+<div class="wp-block-rt-carousel-carousel alignwide rt-carousel wp-block-carousel-carousel is-style-columns-3" role="region" aria-roledescription="carousel" aria-label="rtCarousel: Terms Query Carousel" dir="ltr" data-axis="x" data-wp-interactive="rt-carousel/carousel" data-wp-context="{&quot;options&quot;:{&quot;loop&quot;:false,&quot;dragFree&quot;:false,&quot;align&quot;:&quot;start&quot;,&quot;containScroll&quot;:&quot;trimSnaps&quot;,&quot;direction&quot;:&quot;ltr&quot;,&quot;axis&quot;:&quot;x&quot;,&quot;slidesToScroll&quot;:1},&quot;autoplay&quot;:false,&quot;isPlaying&quot;:false,&quot;timerIterationId&quot;:0,&quot;selectedIndex&quot;:-1,&quot;scrollSnaps&quot;:[],&quot;canScrollPrev&quot;:false,&quot;canScrollNext&quot;:false,&quot;scrollProgress&quot;:0,&quot;slideCount&quot;:0,&quot;ariaLabelPattern&quot;:&quot;Go to slide %d&quot;}" data-wp-init="callbacks.initCarousel" style="--rt-carousel-gap:16px"><!-- wp:rt-carousel/carousel-viewport {"className":"wp-block-carousel-carousel-viewport"} -->
+	<div class="wp-block-rt-carousel-carousel-viewport embla wp-block-carousel-carousel-viewport">
+		<div class="embla__container"><!-- wp:terms-query {"termQuery":{"perPage":10,"taxonomy":"category","order":"asc","orderBy":"name","include":[],"hideEmpty":false,"showNested":false,"inherit":false}} -->
+			<div class="wp-block-terms-query"><!-- wp:term-template -->
+				<!-- wp:group {"className":"is-style-section-1","style":{"spacing":{"padding":{"top":"30px","right":"30px","bottom":"30px","left":"30px"}},"border":{"radius":{"topLeft":"10px","topRight":"10px","bottomLeft":"10px","bottomRight":"10px"}},"color":{"background":"#f6f6f6"}},"layout":{"inherit":false}} -->
+				<div class="wp-block-group is-style-section-1 has-background" style="border-top-left-radius:10px;border-top-right-radius:10px;border-bottom-left-radius:10px;border-bottom-right-radius:10px;background-color:#f6f6f6;padding-top:30px;padding-right:30px;padding-bottom:30px;padding-left:30px"><!-- wp:term-name {"isLink":true,"fontSize":"x-large"} /-->
+
+					<!-- wp:term-description /-->
+
+					<!-- wp:term-count /-->
+				</div>
+				<!-- /wp:group -->
+				<!-- /wp:term-template -->
+			</div>
+			<!-- /wp:terms-query -->
+		</div>
+	</div>
+	<!-- /wp:rt-carousel/carousel-viewport -->
+
+	<!-- wp:group {"style":{"spacing":{"margin":{"top":"var:preset|spacing|30","bottom":"0"}}},"layout":{"type":"flex","flexWrap":"nowrap"}} -->
+	<div class="wp-block-group" style="margin-top:var(--wp--preset--spacing--30);margin-bottom:0"><!-- wp:rt-carousel/carousel-controls {"className":"wp-block-carousel-carousel-controls"} -->
+		<div class="wp-block-rt-carousel-carousel-controls rt-carousel-controls wp-block-carousel-carousel-controls"><button type="button" class="rt-carousel-controls__btn rt-carousel-controls__btn--prev" data-wp-on--click="actions.scrollPrev" data-wp-bind--disabled="!state.canScrollPrev" aria-label="Previous Slide"><svg class="rt-carousel-controls__icon" width="13" height="8" viewBox="0 0 13 8" fill="none" xmlns="http://www.w3.org/2000/svg">
+					<path d="M0 3.55371L3.55371 7.10742V4.26562H12.7861V2.84375H3.55371V0L0 3.55371Z" fill="#1C1C1C"></path>
+				</svg></button><button type="button" class="rt-carousel-controls__btn rt-carousel-controls__btn--next" data-wp-on--click="actions.scrollNext" data-wp-bind--disabled="!state.canScrollNext" aria-label="Next Slide"><svg class="rt-carousel-controls__icon" width="13" height="8" viewBox="0 0 13 8" fill="none" xmlns="http://www.w3.org/2000/svg">
+					<path d="M12.7861 3.55371L9.23242 7.10742V4.26562H0V2.84375H9.23242V0L12.7861 3.55371Z" fill="#1C1C1C"></path>
+				</svg></button></div>
+		<!-- /wp:rt-carousel/carousel-controls -->
+	</div>
+	<!-- /wp:group -->
+</div>
+<!-- /wp:rt-carousel/carousel -->

inc/Plugin.php

@@ -130,6 +130,7 @@ public function register_blocks(): void {
 		$blocks = [
 			'carousel',
 			'carousel/controls',
+			'carousel/counter',
 			'carousel/dots',
 			'carousel/progress',
 			'carousel/viewport',