Serbroda · Serbroda · Mar 20, 2026 · Oct 17, 2017 · Oct 18, 2017 · Oct 18, 2017
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, 'feature/**' ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+          cache: maven
+
+      - name: Build and test
+        run: ./mvnw clean verify
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: target/surefire-reports/
diff --git a/.gitignore b/.gitignore
@@ -198,17 +198,4 @@ buildNumber.properties
 # Project-level settings
 /.tgitconfig
 
-### Web ###
-*.asp
-*.cer
-*.csr
-*.css
-*.htm
-*.html
-*.js
-*.jsp
-*.php
-*.rss
-*.xhtml
-
 # End of https://www.gitignore.io/api/web,git,java,maven,eclipse,tortoisegit,intellij+all,intellij+iml
diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties
@@ -1 +1 @@
-distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.0/apache-maven-3.5.0-bin.zip
+distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
diff --git a/.travis.yml b/.travis.yml
diff --git a/README.md b/README.md
@@ -1,19 +1,24 @@
 Thymeleaf Component Dialect
 ===========================
 
-[![Build Status](https://travis-ci.org/Serbroda/thymeleaf-component-dialect.svg?branch=develop)](https://travis-ci.org/Serbroda/thymeleaf-component-dialect)
+[![CI](https://github.com/Serbroda/thymeleaf-component-dialect/actions/workflows/ci.yml/badge.svg)](https://github.com/Serbroda/thymeleaf-component-dialect/actions/workflows/ci.yml)
 [![jitpack](https://jitpack.io/v/Serbroda/thymeleaf-component-dialect.svg)](https://jitpack.io/#Serbroda/thymeleaf-component-dialect)
-[![license](https://img.shields.io/github/license/Serbroda/thymeleaf-component-dialect.svg)](https://github.com/Serbroda/thymeleaf-component-dialect/blob/master/LICENSE.txt)
+[![license](https://img.shields.io/github/license/Serbroda/thymeleaf-component-dialect.svg)](https://github.com/Serbroda/thymeleaf-component-dialect/blob/main/LICENSE.txt)
 
+A dialect for creating reusable Thymeleaf components, similar to React or Vue components.
 
-A dialect for creating reusable thymeleaf components.
+Requirements
+------
+
+- Java 17+
+- Thymeleaf 3.1+
 
 Installation
 ------
 
 Add the jitpack repository.
 
-```html
+```xml
 <repositories>
     <repository>
         <id>jitpack.io</id>
@@ -24,7 +29,7 @@ Add the jitpack repository.
 
 Add the dependency (for all available versions see [https://jitpack.io/#Serbroda/thymeleaf-component-dialect](https://jitpack.io/#Serbroda/thymeleaf-component-dialect)).
 
-```html
+```xml
 <dependency>
     <groupId>com.github.Serbroda</groupId>
     <artifactId>thymeleaf-component-dialect</artifactId>
@@ -47,8 +52,6 @@ public ComponentDialect componentDialect() {
 Usage
 -----
 
-For detailed configurations have a look at the [demo project](https://github.com/Serbroda/thymeleaf-component-dialect-demo).
-
 ### Create a thymeleaf component
 
 Thymeleaf components uses the standard `th:fragment` attribute to register components. Just create a fragment with a `<tc:content/>` tag which will be replaced with specific contents.
@@ -66,13 +69,13 @@ Thymeleaf components uses the standard `th:fragment` attribute to register compo
 
 ### Use the component
 
-Add the namespace `xmlns:tc="http://www.morphbit.com/thymeleaf/component"` and use the component in your application.
+Add the namespace `xmlns:tc="https://github.com/Serbroda/thymeleaf-component-dialect"` and use the component in your application.
 
 ```html
 <!DOCTYPE html>
 <html 
     xmlns:th="http://www.thymeleaf.org" 
-    xmlns:tc="http://www.morphbit.com/thymeleaf/component">
+    xmlns:tc="https://github.com/Serbroda/thymeleaf-component-dialect">
 <head>
 </head>
 <body>
@@ -92,10 +95,35 @@ Add the namespace `xmlns:tc="http://www.morphbit.com/thymeleaf/component"` and u
         <b>A title</b>
     </div>
     <div class="panel-body">
-
         <h1>Hello world</h1>
         <p>This is my first thymeleaf component</p>
-
     </div>
 </div>
-```
+```
+
+### The `tc:once` Attribute
+
+Use `tc:once` to ensure an element (e.g. a script tag) is only rendered once, even if the component is used multiple times on the same page:
+
+```html
+<div th:fragment="my-widget">
+    <button>Click me</button>
+    <script tc:once="my-widget-script">
+        // This script will only be included once
+    </script>
+</div>
+```
+
+Contributing
+------
+
+Contributions are welcome! Feel free to open an [issue](https://github.com/Serbroda/thymeleaf-component-dialect/issues) or submit a [pull request](https://github.com/Serbroda/thymeleaf-component-dialect/pulls).
+
+Before submitting a PR, please make sure:
+- All tests pass: `./mvnw clean verify`
+- Code is formatted: `./mvnw spotless:apply`
+
+License
+------
+
+This project is licensed under the [Apache License, Version 2.0](LICENSE.txt).
diff --git a/pom.xml b/pom.xml
@@ -1,47 +1,97 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <modelVersion>4.0.0</modelVersion>
-
-    <groupId>de.morphbit</groupId>
-    <artifactId>thymeleaf-component-dialect</artifactId>
-    <version>0.0.3-alpha</version>
-    <packaging>jar</packaging>
-
-    <name>thymeleaf-component-dialect</name>
-    <description>Thymeleaf Layout Dialect</description>
-
-    <properties>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
-        <java.version>1.8</java.version>
-        <maven.compiler.source>1.8</maven.compiler.source>
-        <maven.compiler.target>1.8</maven.compiler.target>
-    </properties>
-
-    <dependencies>
-        <dependency>
-            <groupId>org.thymeleaf</groupId>
-            <artifactId>thymeleaf</artifactId>
-            <version>3.0.7.RELEASE</version>
-        </dependency>
-    </dependencies>
-
-    <build>
-        <plugins>
-            <plugin>
-                <inherited>true</inherited>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-                <version>3.0.1</version>
-                <executions>
-                    <execution>
-                        <id>attach-sources</id>
-                        <goals>
-                            <goal>jar-no-fork</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-        </plugins>
-    </build>
-</project>
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>de.morphbit</groupId>
+    <artifactId>thymeleaf-component-dialect</artifactId>
+    <version>0.1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <name>thymeleaf-component-dialect</name>
+    <description>A Thymeleaf dialect for creating reusable components</description>
+
+    <licenses>
+        <license>
+            <name>Apache License, Version 2.0</name>
+            <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+        </license>
+    </licenses>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <java.version>17</java.version>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.thymeleaf</groupId>
+            <artifactId>thymeleaf</artifactId>
+            <version>3.1.3.RELEASE</version>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>5.11.4</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
+                <configuration>
+                    <source>17</source>
+                    <target>17</target>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>3.5.2</version>
+            </plugin>
+            <plugin>
+                <groupId>com.diffplug.spotless</groupId>
+                <artifactId>spotless-maven-plugin</artifactId>
+                <version>2.44.3</version>
+                <configuration>
+                    <java>
+                        <eclipse>
+                            <version>4.33</version>
+                        </eclipse>
+                        <removeUnusedImports/>
+                        <importOrder/>
+                    </java>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>spotless-check</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <inherited>true</inherited>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-source-plugin</artifactId>
+                <version>3.3.1</version>
+                <executions>
+                    <execution>
+                        <id>attach-sources</id>
+                        <goals>
+                            <goal>jar-no-fork</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/src/main/java/de/morphbit/thymeleaf/dialect/ComponentDialect.java b/src/main/java/de/morphbit/thymeleaf/dialect/ComponentDialect.java
@@ -16,19 +16,17 @@
 
 package de.morphbit.thymeleaf.dialect;
 
+import de.morphbit.thymeleaf.model.ThymeleafComponent;
+import de.morphbit.thymeleaf.parser.IThymeleafComponentParser;
+import de.morphbit.thymeleaf.processor.ComponentNamedElementProcessor;
+import de.morphbit.thymeleaf.processor.OnceAttributeTagProcessor;
 import java.util.ArrayList;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
-
 import org.thymeleaf.dialect.AbstractProcessorDialect;
 import org.thymeleaf.processor.IProcessor;
 
-import de.morphbit.thymeleaf.model.ThymeleafComponent;
-import de.morphbit.thymeleaf.parser.IThymeleafComponentParser;
-import de.morphbit.thymeleaf.processor.ComponentNamedElementProcessor;
-import de.morphbit.thymeleaf.processor.OnceAttributeTagProcessor;
-
 /**
  * A dialect for creating reusable composite components with thymeleaf
  * 
@@ -73,14 +71,14 @@ public Set<IProcessor> getProcessors(String dialectPrefix) {
 
 		if (this.components != null) {
 			for (ThymeleafComponent comp : this.components) {
-				processors.add(new ComponentNamedElementProcessor(dialectPrefix,
-				    comp.getName(), comp.getFragmentTemplate()));
+				processors.add(
+						new ComponentNamedElementProcessor(dialectPrefix, comp.getName(), comp.getFragmentTemplate()));
 			}
 		}
 
 		for (ThymeleafComponent comp : parseComponents()) {
-			processors.add(new ComponentNamedElementProcessor(dialectPrefix,
-			    comp.getName(), comp.getFragmentTemplate()));
+			processors
+					.add(new ComponentNamedElementProcessor(dialectPrefix, comp.getName(), comp.getFragmentTemplate()));
 		}
 
 		return processors;

diff --git a/src/main/java/de/morphbit/thymeleaf/exception/ComponentDialectException.java b/src/main/java/de/morphbit/thymeleaf/exception/ComponentDialectException.java
@@ -0,0 +1,12 @@
+package de.morphbit.thymeleaf.exception;
+
+public class ComponentDialectException extends RuntimeException {
+
+	public ComponentDialectException(String message) {
+		super(message);
+	}
+
+	public ComponentDialectException(String message, Throwable cause) {
+		super(message, cause);
+	}
+}
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.0/apache-maven-3.5.0-bin.zip
		distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip