From afd68b0a982d1efe690ca24ab0145e2e4069de6c Mon Sep 17 00:00:00 2001
From: Davide Angelocola <davide.angelocola@gmail.com>
Date: Fri, 26 Jun 2026 18:09:34 +0200
Subject: [PATCH] feat: zstd-platform as an empty convenience jar
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Change zstd-platform from pom to jar packaging: an ordinary (empty) jar
artifact that transitively pulls the bindings plus all six native
libraries. Clients add a single normal dependency — no <type>pom</type>.

- zstd-platform: packaging pom -> jar (empty/sources/javadoc jars attach
  via the parent's maven-jar-plugin executions, Central-ready)
- parent + bom dependencyManagement: drop <type>pom</type>
- README + tutorial: drop <type>pom</type> from the usage snippets

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md             |  1 -
 bom/pom.xml           |  1 -
 docs/tutorial.md      |  1 -
 pom.xml               |  1 -
 zstd-platform/pom.xml | 15 +++++++++------
 5 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 8f10689..de4a7e0 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,6 @@ The docs follow the [Diátaxis](https://diataxis.fr) framework:
   <groupId>io.github.dfa1.zstd</groupId>
   <artifactId>zstd-platform</artifactId>
   <version>0.2</version>
-  <type>pom</type>
 </dependency>
 ```
 
diff --git a/bom/pom.xml b/bom/pom.xml
index bc6a81f..b385153 100644
--- a/bom/pom.xml
+++ b/bom/pom.xml
@@ -25,7 +25,6 @@
 				<groupId>io.github.dfa1.zstd</groupId>
 				<artifactId>zstd-platform</artifactId>
 				<version>${project.version}</version>
-				<type>pom</type>
 			</dependency>
 			<dependency>
 				<groupId>io.github.dfa1.zstd</groupId>
diff --git a/docs/tutorial.md b/docs/tutorial.md
index 399b871..580a663 100644
--- a/docs/tutorial.md
+++ b/docs/tutorial.md
@@ -15,7 +15,6 @@ runs on any OS/arch:
   <groupId>io.github.dfa1.zstd</groupId>
   <artifactId>zstd-platform</artifactId>
   <version>0.2</version>
-  <type>pom</type>
 </dependency>
 ```
 
diff --git a/pom.xml b/pom.xml
index e83f275..d25edac 100644
--- a/pom.xml
+++ b/pom.xml
@@ -97,7 +97,6 @@
 				<groupId>io.github.dfa1.zstd</groupId>
 				<artifactId>zstd-platform</artifactId>
 				<version>${project.version}</version>
-				<type>pom</type>
 			</dependency>
 			<dependency>
 				<groupId>io.github.dfa1.zstd</groupId>
diff --git a/zstd-platform/pom.xml b/zstd-platform/pom.xml
index 83a73c4..9b2b571 100644
--- a/zstd-platform/pom.xml
+++ b/zstd-platform/pom.xml
@@ -12,13 +12,16 @@
 	<artifactId>zstd-platform</artifactId>
 	<name>zstd-platform</name>
 	<description>zstd-java bindings bundled with every platform's native library</description>
-	<packaging>pom</packaging>
+	<!-- Empty convenience jar (no sources of its own): a single, ordinary jar
+	     dependency that transitively pulls everything. jar packaging (not pom) so
+	     clients can add it like any normal artifact. -->
+	<packaging>jar</packaging>
 
-	<!-- Convenience aggregator: one dependency pulls the bindings plus all six
-	     native libraries, so a build runs on any OS/arch without choosing a
-	     classifier. Costs ~3.8 MB of natives (five unused per platform); for a
-	     known single target depend on zstd + the one zstd-native-<classifier>
-	     directly. Versions come from the parent's dependencyManagement. -->
+	<!-- One dependency pulls the bindings plus all six native libraries, so a
+	     build runs on any OS/arch without choosing a classifier. Costs ~3.8 MB of
+	     natives (five unused per platform); for a known single target depend on
+	     zstd + the one zstd-native-<classifier> directly. Versions come from the
+	     parent's dependencyManagement. -->
 	<dependencies>
 		<dependency>
 			<groupId>io.github.dfa1.zstd</groupId>