feat: release version 4.1.0 with new bundle module and breaking changes

- Introduced `fastproto-bundle` module, aggregating core and processor for simplified dependency management.
- Removed `CodecProcessor` and `@GenerateCodec` annotation due to limited value.
- Eliminated runtime dynamic compilation, relying solely on compile-time code generation for lambda formulas.
- Restructured project into three modules: `fastproto-core`, `fastproto-processor`, and `fastproto`.
- Updated documentation to reflect changes and provide a migration guide for users upgrading from version 4.0.0.

Author: Deng-Ran

CHANGELOG-zh.md

@@ -2,6 +2,34 @@
 
 本文件用于记录本项目的所有重要变更。
 
+## [4.1.0] - 2026-01-27
+### 新增
+- **fastproto 聚合模块**：新增 `fastproto-bundle` 模块（artifactId 为 `fastproto`），聚合 core 和 processor，用户只需引用一个依赖即可获得完整功能
+- Bundle 模块集成测试，验证聚合后功能正常
+
+### 移除
+- 移除 `CodecProcessor` 和 `@GenerateCodec` 注解（功能价值有限）
+- 移除运行时动态编译功能（`FormulaBuilder` 及相关类），lambda 公式现在完全依赖编译时代码生成
+
+### 变更
+- 项目结构调整为三模块：
+  - `fastproto-core` - 核心库
+  - `fastproto-processor` - 注解处理器
+  - `fastproto` (bundle) - 聚合模块，推荐用户使用
+- 更新文档，简化依赖引用说明
+
+### 升级指南
+从 4.0.0 升级的用户，现在只需引用一个依赖：
+
+**Maven:**
+```xml
+<dependency>
+    <groupId>org.indunet</groupId>
+    <artifactId>fastproto</artifactId>
+    <version>4.1.0</version>
+</dependency>
+```
+
 ## [4.0.0] - 2026-01-26
 ### 重大变更
 - **多模块重构**：项目拆分为两个模块：

CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to this project will be documented in this file.
 
+## [4.1.0] - 2026-01-27
+### Added
+- **fastproto bundle module**: New `fastproto-bundle` module (artifactId: `fastproto`) that aggregates core and processor, allowing users to include just one dependency for full functionality
+- Integration tests for the bundle module to verify aggregated functionality
+
+### Removed
+- Removed `CodecProcessor` and `@GenerateCodec` annotation (limited practical value)
+- Removed runtime dynamic compilation (`FormulaBuilder` and related classes); lambda formulas now rely entirely on compile-time code generation
+
+### Changed
+- Project restructured into three modules:
+  - `fastproto-core` - Core library
+  - `fastproto-processor` - Annotation processor
+  - `fastproto` (bundle) - Aggregator module, recommended for users
+- Updated documentation to simplify dependency references
+
+### Migration Guide
+Users upgrading from 4.0.0 now only need one dependency:
+
+**Maven:**
+```xml
+<dependency>
+    <groupId>org.indunet</groupId>
+    <artifactId>fastproto</artifactId>
+    <version>4.1.0</version>
+</dependency>
+```
+
 ## [4.0.0] - 2026-01-26
 ### Breaking Changes
 - **Multi-module restructure**: Project split into two modules:

README-zh.md

@@ -45,15 +45,7 @@ FastProto 是一个面向 **二进制通信协议** 的高性能序列化 / 反
 <dependency>
     <groupId>org.indunet</groupId>
     <artifactId>fastproto</artifactId>
-    <version>4.0.0</version>
-</dependency>
-
-<!-- 可选：使用 lambda 公式时需要 (@DecodingFormula(lambda="...")) -->
-<dependency>
-    <groupId>org.indunet</groupId>
-    <artifactId>fastproto-processor</artifactId>
-    <version>4.0.0</version>
-    <scope>provided</scope>
+    <version>4.1.0</version>
 </dependency>
 ```
 

README.md

@@ -46,15 +46,7 @@ See the [CHANGELOG](CHANGELOG.md) for recent updates.
 <dependency>
     <groupId>org.indunet</groupId>
     <artifactId>fastproto</artifactId>
-    <version>4.0.0</version>
-</dependency>
-
-<!-- Optional: For lambda formula support (@DecodingFormula(lambda="...")) -->
-<dependency>
-    <groupId>org.indunet</groupId>
-    <artifactId>fastproto-processor</artifactId>
-    <version>4.0.0</version>
-    <scope>provided</scope>
+    <version>4.1.0</version>
 </dependency>
 ```
 

docs/android.md

@@ -11,46 +11,57 @@ This page summarizes how to use FastProto on Android.
 
 ## Lambda Formulas on Android
 
-Since version 4.0.0, FastProto provides a separate annotation processor module (`fastproto-processor`) that generates formula classes at compile time. This makes `@DecodingFormula(lambda = "...")` and `@EncodingFormula(lambda = "...")` fully compatible with Android.
+FastProto provides a separate annotation processor module (`fastproto-processor`) that generates formula classes at compile time. This makes `@DecodingFormula(lambda = "...")` and `@EncodingFormula(lambda = "...")` fully compatible with Android.
 
 ### Setup
 
+Android projects need to configure the annotation processor separately (cannot use the `fastproto` bundle directly).
+
 **Gradle (Kotlin DSL)**:
 ```kotlin
 dependencies {
-    implementation("org.indunet:fastproto:4.0.0")
-    annotationProcessor("org.indunet:fastproto-processor:4.0.0")
+    implementation("org.indunet:fastproto-core:4.1.0")
+    annotationProcessor("org.indunet:fastproto-processor:4.1.0")
 }
 
 // For Kotlin projects, use kapt instead:
-// kapt("org.indunet:fastproto-processor:4.0.0")
+// kapt("org.indunet:fastproto-processor:4.1.0")
 ```
 
 **Gradle (Groovy DSL)**:
 ```groovy
 dependencies {
-    implementation 'org.indunet:fastproto:4.0.0'
-    annotationProcessor 'org.indunet:fastproto-processor:4.0.0'
+    implementation 'org.indunet:fastproto-core:4.1.0'
+    annotationProcessor 'org.indunet:fastproto-processor:4.1.0'
 }
 ```
 
-**Maven**:
+**Maven (Android)**:
 ```xml
 <dependencies>
     <dependency>
         <groupId>org.indunet</groupId>
-        <artifactId>fastproto</artifactId>
-        <version>4.0.0</version>
+        <artifactId>fastproto-core</artifactId>
+        <version>4.1.0</version>
     </dependency>
     <dependency>
         <groupId>org.indunet</groupId>
         <artifactId>fastproto-processor</artifactId>
-        <version>4.0.0</version>
+        <version>4.1.0</version>
         <scope>provided</scope>
     </dependency>
 </dependencies>
 ```
 
+**Note:** For standard Maven/Gradle projects (non-Android), simply use the `fastproto` bundle which includes everything:
+```xml
+<dependency>
+    <groupId>org.indunet</groupId>
+    <artifactId>fastproto</artifactId>
+    <version>4.1.0</version>
+</dependency>
+```
+
 ### How It Works
 
 The annotation processor scans your code at compile time and generates `Function` implementation classes for each lambda expression. These generated classes are included in your APK and used at runtime instead of dynamic compilation.
@@ -117,6 +128,7 @@ public class SensorData {
 
 ## FAQ
 
-- **Can I use lambda formulas on Android?** Yes! Since 4.0.0, the `fastproto-processor` module generates formula classes at compile time, making lambda formulas fully compatible with Android.
+- **Can I use lambda formulas on Android?** Yes! The `fastproto-processor` module generates formula classes at compile time, making lambda formulas fully compatible with Android.
+- **Why can't I use the `fastproto` bundle on Android?** Android's build system requires explicit annotation processor configuration. The bundle works for standard Maven/Gradle projects but Android needs separate `fastproto-core` + `fastproto-processor` dependencies.
 - **Do I need the annotation processor?** If you use `@DecodingFormula(lambda = "...")` or `@EncodingFormula(lambda = "...")`, yes. If you only use class-based formulas like `@DecodingFormula(MyFormula.class)`, the annotation processor is optional.
 - **Do I need ProGuard rules?** If you rely on reflection/annotations, keep them as shown above. The generated formula classes should also be kept.

docs/formulas.md

@@ -9,7 +9,7 @@ Formulas let you convert between raw on‑wire values and engineering values. Yo
 - Decode formula: raw -> target field type
 - Encode formula: target field type -> raw
 
-> **Note:** Lambda formulas require the `fastproto-processor` module for compile-time code generation. This ensures compatibility with Android and Java 11+ JRE environments. See [Android guide](android.md) for setup details.
+> **Note:** Lambda formulas require annotation processing for compile-time code generation. The `fastproto` bundle includes this by default. For Android projects, see [Android guide](android.md) for setup details.
 
 ## Quick Steps
 
@@ -28,21 +28,22 @@ Formulas let you convert between raw on‑wire values and engineering values. Yo
   - Example: reverse the above conversion.
 
 ### Lambda vs Class
-- Lambda: `@DecodingFormula(lambda = "...")` / `@EncodingFormula(lambda = "...")` — requires `fastproto-processor` dependency
+- Lambda: `@DecodingFormula(lambda = "...")` / `@EncodingFormula(lambda = "...")` — included in `fastproto` bundle
 - Class: `@DecodingFormula(MyFunc.class)` / `@EncodingFormula(MyFunc.class)` where class implements `Function<In, Out>`
 - Precedence: Class‑based formulas win if both lambda and class are present.
 
-### Lambda Processor Setup
-To use lambda expressions, add the annotation processor:
+### Lambda Support
+Lambda expressions are supported out of the box when using the `fastproto` bundle:
 ```xml
 <dependency>
     <groupId>org.indunet</groupId>
-    <artifactId>fastproto-processor</artifactId>
-    <version>4.0.0</version>
-    <scope>provided</scope>
+    <artifactId>fastproto</artifactId>
+    <version>4.1.0</version>
 </dependency>
 ```
 
+For Android projects, see [android.md](android.md) for separate configuration.
+
 ### Lifecycle & Errors
 - Formulas are compiled/bound during graph resolve and invoked per field during decode/encode.
 - Throwing exceptions inside formulas will surface as `DecodingException` / `EncodingException` at call sites.

docs/quick-start.md

@@ -10,15 +10,20 @@ Add the dependency via Maven:
 <dependency>
     <groupId>org.indunet</groupId>
     <artifactId>fastproto</artifactId>
-    <version>4.0.0</version>
+    <version>4.1.0</version>
 </dependency>
+```
+
+This bundle includes both core library and annotation processor for lambda formula support.
 
-<!-- Optional: For lambda formula support (@DecodingFormula(lambda="...")) -->
+For Android projects or if you only need core functionality:
+
+```xml
+<!-- Core only (no lambda formula support) -->
 <dependency>
     <groupId>org.indunet</groupId>
-    <artifactId>fastproto-processor</artifactId>
-    <version>4.0.0</version>
-    <scope>provided</scope>
+    <artifactId>fastproto-core</artifactId>
+    <version>4.1.0</version>
 </dependency>
 ```
 

fastproto-bundle/pom.xml

@@ -0,0 +1,38 @@
+<?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>
+
+    <parent>
+        <groupId>org.indunet</groupId>
+        <artifactId>fastproto-parent</artifactId>
+        <version>4.1.0</version>
+    </parent>
+
+    <artifactId>fastproto</artifactId>
+    <packaging>jar</packaging>
+    <name>FastProto</name>
+    <description>FastProto all-in-one bundle including core and annotation processor</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.indunet</groupId>
+            <artifactId>fastproto-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.indunet</groupId>
+            <artifactId>fastproto-processor</artifactId>
+        </dependency>
+
+        <!-- Testing -->
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+        </dependency>
+    </dependencies>
+</project>

fastproto-bundle/src/test/java/org/indunet/fastproto/ArrayProtocol.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2019-2024 indunet.org
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.indunet.fastproto;
+
+import lombok.Data;
+import org.indunet.fastproto.annotation.Int32ArrayType;
+
+/**
+ * Protocol class with array types for testing.
+ *
+ * @author Deng Ran
+ * @since 4.1.0
+ */
+@Data
+public class ArrayProtocol {
+    @Int32ArrayType(offset = 0, length = 3)
+    private int[] values;
+}