@zio.dev/zio-blocks 0.0.55 → 0.0.56

package/guides/async-getting-started.md

@@ -28,7 +28,7 @@ By the end of this tutorial, you will be able to:
 To add the async module to your project, include this dependency in your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-async" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-async" % "0.0.56"
 ```
 
 Then bring the full DSL into scope at the top of each file you use it from:

package/guides/query-dsl-extending.md

@@ -52,7 +52,7 @@ None of these can be expressed with `SchemaExpr` alone. You could generate the S
 This guide builds on [Part 1: Expressions](./query-dsl-reified-optics.md) and [Part 2: SQL Generation](./query-dsl-sql.md). You should be comfortable building `SchemaExpr` values and translating them to SQL.
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
 ```scala

package/guides/query-dsl-fluent-builder.md

@@ -57,7 +57,7 @@ In this guide, we solve both problems: bridge extensions eliminate `.toExpr`, an
 This guide builds on [Part 1: Expressions](./query-dsl-reified-optics.md), [Part 2: SQL Generation](./query-dsl-sql.md), and [Part 3: Extending the Expression Language](./query-dsl-extending.md).
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
 ## Domain Setup

package/guides/query-dsl-reified-optics.md

@@ -43,7 +43,7 @@ In this guide, we'll solve this by using ZIO Blocks' `SchemaExpr` and reified op
 Add the ZIO Blocks Schema dependency:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
 ```scala

package/guides/query-dsl-sql.md

@@ -43,7 +43,7 @@ This is fragile, repetitive, and vulnerable to SQL injection. Every new query sh
 This guide builds on [Part 1: Expressions](./query-dsl-reified-optics.md). You should be comfortable building `SchemaExpr` values with optic operators (`===`, `>`, `&&`, etc.).
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
 ```scala

package/guides/telemetry-guide.md

@@ -11,16 +11,16 @@ If you're looking for API signatures and quick copy-paste snippets, the [Telemet
 
 ```scala
 // Core: logging, tracing, metrics
-libraryDependencies += "dev.zio" %% "zio-blocks-telemetry" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-telemetry" % "0.0.56"
 
 // OTLP JSON export over HTTP (JVM only)
-libraryDependencies += "dev.zio" %% "zio-blocks-telemetry-otel" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-telemetry-otel" % "0.0.56"
 ```
 
 The core module also cross-builds for Scala.js:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-telemetry" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-telemetry" % "0.0.56"
 ```
 
 ---

package/guides/zio-schema-migration.md

@@ -38,13 +38,13 @@ libraryDependencies += "dev.zio" %% "zio-schema-avro"       % "1.x.x"
 **After (ZIO Blocks Schema):**
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema"            % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema"            % "0.0.56"
 // Optional codec modules:
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro"       % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift"     % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson"       % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon"       % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro"       % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift"     % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson"       % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon"       % "0.0.56"
 ```
 
 Key points:

package/index.md

@@ -27,7 +27,7 @@ Add a block and use it. Nothing else to wire up—no runtime to install, no effe
 type to adopt:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
 ```scala
@@ -57,7 +57,7 @@ Every block is published under the `dev.zio` organization. Most cross-build for
 adopt Scala 3 on your timeline, not ours. The handful of modules that are narrower
 say so in their own row.
 
-### Schema & Serialization
+### Meta Programming
 
 JSON support is built into `zio-blocks-schema`; the modules below add further formats.
 
@@ -72,33 +72,33 @@ JSON support is built into `zio-blocks-schema`; the modules below add further fo
 | [TOON Codec](./reference/schema/built-in-codecs/toon.md) | `zio-blocks-schema-toon` | JVM · JS | 2.13 · 3.x | Token-oriented notation 30–60% smaller than JSON, tuned for LLM prompts |
 | [XML Codec](./reference/schema/built-in-codecs/xml.md) | `zio-blocks-schema-xml` | JVM · JS | 2.13 · 3.x | Zero-dependency XML serialization with fluent navigation and patching |
 | [YAML Codec](./reference/schema/built-in-codecs/yaml.md) | `zio-blocks-schema-yaml` | JVM · JS | 2.13 · 3.x | Human-readable YAML serialization with JSON interop |
+| [TypeId](./reference/typeid.md) | `zio-blocks-typeid` | JVM · JS | 2.13 · 3.x | Compile-time type identity with rich metadata |
+
+### Resource Management
 
-### Core Data Types
+All of these ship in `zio-blocks-scope`.
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
-| [Chunk](./reference/chunk.md) | `zio-blocks-chunk` | JVM · JS | 2.13 · 3.x | High-performance immutable indexed sequences with zero-boxing builders |
-| [Maybe](./reference/maybe.md) | `zio-blocks-maybe` | JVM · JS | 2.13 · 3.x | Low-allocation optional values backed by `null` |
-| [Combinators](./reference/combinators.md) | `zio-blocks-combinators` | JVM · JS | 2.13 · 3.x | Compile-time composition and decomposition of tuples, eithers, and unions |
-| [TypeId](./reference/typeid.md) | `zio-blocks-typeid` | JVM · JS | 2.13 · 3.x | Compile-time type identity with rich metadata |
-| [Context](./reference/context.md) | `zio-blocks-context` | JVM · JS | 2.13 · 3.x | Type-indexed heterogeneous collections |
-| [MediaType](./reference/media-type.md) | `zio-blocks-mediatype` | JVM · JS | 2.13 · 3.x | Type-safe IANA media types with 2,600+ predefined types |
+| [Scope](./reference/resource-management/index.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Compile-time safe resource boundaries that keep values from escaping their lifetime |
+| [Resource](./reference/resource-management/resource.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Lazy recipes that pair acquisition with finalization, composable with `map`, `flatMap`, and `zip` |
+| [Unscoped](./reference/resource-management/unscoped.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Marker typeclass for plain data that can safely leave a scope |
+| [DeferHandle](./reference/resource-management/defer-handle.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Handle returned by `Scope.defer` for cancelling a registered finalizer |
+| [Finalizer](./reference/resource-management/finalizer.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Minimal capability interface for registering cleanup actions |
+| [Finalization](./reference/resource-management/finalization.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Result of running a scope's finalizers, including any cleanup errors |
 
-### Concurrency & Streaming
+### Dependency Injection
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
-| [Async](./reference/async.md) | `zio-blocks-async` | JVM · JS | 2.13 · 3.x | Zero-allocation asynchronous effect type with direct-style `await` |
-| [Streams](./reference/streams/index.md) | `zio-blocks-streams` | JVM · JS | 2.13 · 3.x | Pull-based streaming with typed errors, zero boxing, and synchronous or asynchronous execution |
-| [Ring Buffer](./reference/ringbuffer/index.mdx) | `zio-blocks-ringbuffer` | JVM · JS | 2.13 · 3.x | Lock-free bounded ring buffers (SPSC, SPMC, MPSC, MPMC) |
-| [Mux](./reference/mux.mdx) | `zio-blocks-mux` | JVM · JS | 2.13 · 3.x | Thread-safe multiplexer for HTTP/2, QUIC, and WebSocket-style protocols |
+| [Wire](./reference/resource-management/wire.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Compile-time safe recipes for constructing a service and its dependencies |
+| [Context](./reference/context.md) | `zio-blocks-context` | JVM · JS | 2.13 · 3.x | Type-indexed heterogeneous collections |
 
-### Resources & Configuration
+### Configuration & Feature Flags
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
-| [Scope](./reference/resource-management/index.md) | `zio-blocks-scope` | JVM · JS | 2.13 · 3.x | Compile-time safe resource management and dependency injection |
-| [Config](./reference/config/index.md) | `zio-blocks-config` | JVM · JS | 2.13 · 3.x | Typed configuration loading, feature flags, and rollout rules |
+| [Configuration](./reference/config/index.md) | `zio-blocks-config` | JVM · JS | 2.13 · 3.x | Typed configuration loading, feature flags, and rollout rules |
 | [Config YAML](./reference/config/formats.md) | `zio-blocks-config-yaml` | JVM · JS | 2.13 · 3.x | YAML source adapter for `ConfigSource` |
 | [Config JSON](./reference/config/formats.md) | `zio-blocks-config-json` | JVM · JS | 2.13 · 3.x | JSON source adapter for `ConfigSource` |
 | [Config HOCON](./reference/config/formats.md) | `zio-blocks-config-hocon` | JVM · JS | 2.13 · 3.x | HOCON source adapter for `ConfigSource` |
@@ -107,35 +107,59 @@ JSON support is built into `zio-blocks-schema`; the modules below add further fo
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
+| [MediaType](./reference/media-type.md) | `zio-blocks-mediatype` | JVM · JS | 2.13 · 3.x | Type-safe IANA media types with 2,600+ predefined types |
 | [HTTP Model](./reference/http-model/index.md) | `zio-blocks-http-model` | JVM · JS | 2.13 · 3.x | Pure HTTP data model with URL parsing, headers, cookies, and forms |
 | [HTTP Model Schema](./reference/http-model/schema.md) | `zio-blocks-http-model-schema` | JVM · JS | 2.13 · 3.x | Schema-based typed access to the HTTP model |
 | [Endpoint](./reference/endpoint/index.md) | `zio-blocks-endpoint` | JVM · JS | 2.13 · 3.x | Type-safe HTTP endpoint descriptors with composable codecs and typed auth |
-| [HTML](./reference/html.md) | `zio-blocks-html` | JVM · JS | 2.13 · 3.x | Type-safe HTML templating with XSS protection |
-| [HTMX](./reference/htmx/index.md) | `zio-blocks-http-htmx` | JVM · JS | 3.x | Typed HTMX DSL for compile-time-checked HTMX attributes |
-| [Datastar](./reference/datastar/index.md) | `zio-blocks-datastar` | JVM · JS | 3.x | Typed Datastar attribute and signal DSL, plus the SSE events that patch a live page |
 | [OpenAPI](./reference/openapi.md) | `zio-blocks-openapi` | JVM · JS | 2.13 · 3.x | Type-safe OpenAPI 3.1 specification generation and rendering |
 | [JWT](./reference/jwt.md) | `zio-blocks-jwt` | JVM · JS | 2.13 · 3.x | Zero-dependency JWT signing and verification with HMAC, RSA, ECDSA and EdDSA support |
+| [HTML](./reference/html.md) | `zio-blocks-html` | JVM · JS | 2.13 · 3.x | Type-safe HTML templating with XSS protection |
+| [Datastar](./reference/datastar/index.md) | `zio-blocks-datastar` | JVM · JS | 3.x | Typed Datastar attribute and signal DSL, plus the SSE events that patch a live page |
+| [HTMX](./reference/htmx/index.md) | `zio-blocks-http-htmx` | JVM · JS | 3.x | Typed HTMX DSL for compile-time-checked HTMX attributes |
 
-### Persistence
+### Data Types
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
-| [SQL](./reference/sql/index.md) | `zio-blocks-sql` | JVM · JS | 3.x | Type-safe JDBC wrapper with schema-derived codecs and a CRUD repository |
-| [SQL — ZIO](./reference/sql-zio.md) | `zio-blocks-sql-zio` | JVM | 3.x | ZIO integration with `ZIO.attemptBlocking` and `ZLayer` |
-| [Projection](./reference/projection.md) | `zio-blocks-projection` | JVM | 3.x | Event-sourced projections with per-entity SQLite storage |
+| [Chunk](./reference/chunk.md) | `zio-blocks-chunk` | JVM · JS | 2.13 · 3.x | High-performance immutable indexed sequences with zero-boxing builders |
+| [Maybe](./reference/maybe.md) | `zio-blocks-maybe` | JVM · JS | 2.13 · 3.x | Low-allocation optional values backed by `null` |
+| [Combinators](./reference/combinators.md) | `zio-blocks-combinators` | JVM · JS | 2.13 · 3.x | Compile-time composition and decomposition of tuples, eithers, and unions |
+
+### Concurrency
+
+| Block | Artifact | Platform | Scala | Description |
+|-------|----------|----------|-------|-------------|
+| [Async](./reference/async.md) | `zio-blocks-async` | JVM · JS | 2.13 · 3.x | Zero-allocation asynchronous effect type with direct-style `await` |
+| [Mux](./reference/mux.mdx) | `zio-blocks-mux` | JVM · JS | 2.13 · 3.x | Thread-safe multiplexer for HTTP/2, QUIC, and WebSocket-style protocols |
+| [RingBuffer](./reference/ringbuffer/index.mdx) | `zio-blocks-ringbuffer` | JVM · JS | 2.13 · 3.x | Lock-free bounded ring buffers (SPSC, SPMC, MPSC, MPMC) |
+
+### Streams
 
-### Observability
+| Block | Artifact | Platform | Scala | Description |
+|-------|----------|----------|-------|-------------|
+| [Streams](./reference/streams/index.md) | `zio-blocks-streams` | JVM · JS | 2.13 · 3.x | Pull-based streaming with typed errors, zero boxing, and synchronous or asynchronous execution |
+
+### Telemetry
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
 | [Telemetry](./reference/telemetry/index.md) | `zio-blocks-telemetry` | JVM · JS | 2.13 · 3.x | Zero-dependency OpenTelemetry-aligned tracing, logging, and metrics |
 | [OTLP Export](./reference/telemetry/otel/index.md) | `zio-blocks-telemetry-otel` | JVM | 2.13 · 3.x | OTLP exporters bridging telemetry signals to an OpenTelemetry collector |
 
+### Persistence
+
+| Block | Artifact | Platform | Scala | Description |
+|-------|----------|----------|-------|-------------|
+| [SQL Module](./reference/sql/index.md) | `zio-blocks-sql` | JVM · JS | 3.x | Type-safe JDBC wrapper with schema-derived codecs and a CRUD repository |
+| [ZIO Integration](./reference/sql-zio.md) | `zio-blocks-sql-zio` | JVM | 3.x | ZIO integration with `ZIO.attemptBlocking` and `ZLayer` |
+| [Data Migration](./reference/data-migration.md) | `zio-blocks-data-migration` | JVM · JS | 3.x | Typed, online database schema migrations in three execution models, with no hand-written SQL |
+| [Projection](./reference/projection.md) | `zio-blocks-projection` | JVM | 3.x | Event-sourced projections with per-entity SQLite storage |
+
 ### Tooling & Codegen
 
 | Block | Artifact | Platform | Scala | Description |
 |-------|----------|----------|-------|-------------|
-| [Codegen](./reference/codegen/index.md) | `zio-blocks-codegen` | JVM | 2.13 · 3.x | Generic Scala code generation IR and emitter |
+| [Code Generation](./reference/codegen/index.md) | `zio-blocks-codegen` | JVM | 2.13 · 3.x | Generic Scala code generation IR and emitter |
 | [Docs](./reference/docs.md) | `zio-blocks-markdown` | JVM · JS | 2.13 · 3.x | GitHub Flavored Markdown parsing, rendering, and programmatic construction |
 | [Smithy](./reference/smithy.md) | `zio-blocks-smithy` | JVM | 2.13 · 3.x | Smithy IDL parser and AST library for API modeling |
 
@@ -185,10 +209,10 @@ val thriftCodec  = Schema[Person].derive(ThriftFormat)      // Thrift
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.56"
 ```
 
-See the [Schema & Serialization](#schema--serialization) rows above for the optional format modules.
+See the [Meta Programming](#meta-programming) rows above for the optional format modules.
 
 ### Example
 
@@ -277,7 +301,7 @@ Scope.global.scoped { scope =>
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.56"
 ```
 
 ### Example
@@ -307,7 +331,7 @@ Scope.global.scoped { scope =>
 ### Learn More
 
 - [Compile-Time Resource Safety with Scope](./guides/compile-time-resource-safety-with-scope.md) — the step-by-step tutorial, from basic resource management through dependency injection
-- [Resource Management & DI reference](./reference/resource-management/index.md) — `Scope`, `Resource`, `Wire`, `Unscoped`, and finalization order
+- [Resource Management reference](./reference/resource-management/index.md) — `Scope`, `Resource`, `Wire`, `Unscoped`, and finalization order
 
 ---
 
@@ -349,7 +373,7 @@ val computed: Int =
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-async" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-async" % "0.0.56"
 ```
 
 ### Example
@@ -414,10 +438,10 @@ val frag = sql"SELECT * FROM user WHERE email = ${"alice@example.com"}"
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-sql" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-sql" % "0.0.56"
 
 // Optional ZIO integration
-libraryDependencies += "dev.zio" %% "zio-blocks-sql-zio" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-sql-zio" % "0.0.56"
 ```
 
 ### Example
@@ -488,7 +512,7 @@ large enough to have several pages start from an overview:
   - [Schema Evolution](./reference/schema/schema-evolution/index.md) - one-way and bidirectional type-safe conversions
 - [Telemetry](./reference/telemetry/index.md) - tracing, logging, metrics, and OTLP export
 - [SQL](./reference/sql/index.md) - codecs, fragments, tables, repositories, transactors, and dialects
-- [Resource Management & DI](./reference/resource-management/index.md) - `Scope`, `Resource`, `Wire`, `Unscoped`, and finalization
+- [Resource Management](./reference/resource-management/index.md) - `Scope`, `Resource`, `Wire`, `Unscoped`, and finalization
 - [Streams](./reference/streams/index.md) - `Stream`, `Pipeline`, `Sink`, and the low-level readers and writers
 - [Endpoint](./reference/endpoint/index.md) - endpoint descriptors, HTTP codecs, route patterns, and typed auth
 - [HTTP Model](./reference/http-model/index.md) - the pure HTTP data model and its schema-based typed access

package/package.json

@@ -2,7 +2,7 @@
   "name": "@zio.dev/zio-blocks",
   "description": "ZIO Blocks Documentation",
   "license": "Apache-2.0",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "repository": {
     "url": "https://github.com/zio/zio-blocks"
   }

package/reference/async.md

@@ -39,13 +39,13 @@ The type is aimed at infrastructure-level code: places that need a first-class a
 Add the module to your build:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-async" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-async" % "0.0.56"
 ```
 
 In a cross-built project, use `%%%` so the same line resolves for both JVM and Scala.js:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-async" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-async" % "0.0.56"
 ```
 
 The module publishes for JVM and Scala.js, on Scala 2.13 and Scala 3. That single coordinate is all you add: it brings `zio-blocks-combinators` with it, along with `dotty-cps-async` on Scala 3 or `scala-reflect` on Scala 2, both of which power the direct-style rewrite.

package/reference/chunk.md

@@ -86,13 +86,13 @@ The practical result is that Chunk gives you a sequence type that's genuinely ef
 Chunk is available in the core `zio-blocks` library:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-chunk" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-chunk" % "0.0.56"
 ```
 
 For Scala.js support:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-chunk" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-chunk" % "0.0.56"
 ```
 
 Supports Scala 2.13.x and 3.x.
@@ -489,7 +489,7 @@ import zio.blocks.chunk.Chunk
 import java.util.Arrays
 
 val javaIter = Arrays.asList(1, 2, 3).iterator()
-// javaIter: Iterator[Int] = java.util.Arrays$ArrayItr@1633b83e
+// javaIter: Iterator[Int] = java.util.Arrays$ArrayItr@2bb97c7f
 val chunk = Chunk.fromJavaIterator(javaIter)
 // chunk: Chunk[Int] = IndexedSeq(1, 2, 3)
 ```

package/reference/codegen/index.md

@@ -81,7 +81,7 @@ OpenAPI → Scala    Smithy → Scala    Protobuf → Scala    JSON Schema → S
 Add the library to your project:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-codegen" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-codegen" % "0.0.56"
 ```
 
 Supported Scala versions: 2.13.x and 3.x

package/reference/combinators.md

@@ -29,13 +29,13 @@ All typeclasses are derived automatically via compile-time resolution and provid
 Add the following to your `build.sbt`:
 
 ```sbt
-libraryDependencies += "dev.zio" %% "zio-blocks-combinators" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-combinators" % "0.0.56"
 ```
 
 For cross-platform projects (Scala.js):
 
 ```sbt
-libraryDependencies += "dev.zio" %%% "zio-blocks-combinators" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-combinators" % "0.0.56"
 ```
 
 Supported platforms:
@@ -286,7 +286,7 @@ import zio.blocks.combinators.Eithers
 val e = summon[Eithers.Eithers[Int, String]]
 // e: Eithers[Int, String] {
   type Out >: Either[Int, String] <: Either[Int, String]
-} = zio.blocks.combinators.Eithers$Eithers$AtomicInstance@533b9d04
+} = zio.blocks.combinators.Eithers$Eithers$AtomicInstance@60379196
 val input = Left(42): Either[Int, String]
 // input: Either[Int, String] = Left(42)
 e.separate(e.combine(input))
@@ -379,7 +379,7 @@ import zio.blocks.combinators.Unions
 val u = summon[Unions.Unions.WithOut[Int, String, Int | String]]
 // u: Unions[Int, String] {
   type Out >: Int | String <: Int | String
-} = zio.blocks.combinators.Unions$Unions$UnionInstance@17919b2f
+} = zio.blocks.combinators.Unions$Unions$UnionInstance@65686c52
 u.separate(42: Int | String)
 // res14: Either[Int, String] = Left(42)
 u.separate("hello": Int | String)

package/reference/config/config-source.md

@@ -62,7 +62,7 @@ An absent key yields `Maybe.absent` rather than throwing or returning `null`:
 
 ```scala
 source.get("db.user")
-// res1: Maybe[SourceValue[String]] = zio.blocks.maybe.Absent$@16d4dcbe
+// res1: Maybe[SourceValue[String]] = zio.blocks.maybe.Absent$@53f42f8c
 ```
 
 `ConfigSource.MapSource` is the underlying case class, so you can pattern match on it or construct it directly when you want the concrete type rather than the trait.
@@ -363,7 +363,7 @@ loaded.provenanceOf("port")
 //   rawValue = "5432"
 // )
 loaded.provenanceOf("nonexistent")
-// res21: Maybe[Provenance] = zio.blocks.maybe.Absent$@16d4dcbe
+// res21: Maybe[Provenance] = zio.blocks.maybe.Absent$@53f42f8c
 ```
 
 ### Dumping Configuration

package/reference/config/formats.md

@@ -51,7 +51,7 @@ Writing `tag: null` to unset a value from a lower-priority layer does not work.
 `config-yaml` reads YAML through the `zio-blocks-schema-yaml` reader:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-config-yaml" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-yaml" % "0.0.56"
 ```
 
 Importing the adapter package makes the constructor available on the `ConfigSource` companion:
@@ -117,7 +117,7 @@ Non-scalar mapping keys are skipped rather than rejected, since a dotted key nam
 `config-json` reads JSON through the `zio-blocks-schema-json` parser:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-config-json" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-json" % "0.0.56"
 ```
 
 The import and the constructor mirror the YAML adapter:
@@ -160,7 +160,7 @@ A malformed document yields `ConfigError.InvalidValue` with a 100-character exce
 `config-hocon` has its own parser with no external dependency, and it is the only adapter that supports substitutions and includes:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-config-hocon" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-hocon" % "0.0.56"
 ```
 
 ### Parsing a String

package/reference/config/index.md

@@ -1,7 +1,7 @@
 ---
 id: index
-title: "Config"
-sidebar_label: "Config"
+title: "Configuration & Feature Flags"
+sidebar_label: "Configuration & Feature Flags"
 ---
 
 `zio.blocks.config` loads typed configuration from string-keyed sources, tracks where every resolved value came from, and evaluates feature flags with percentage-based rollouts. The module is synchronous and zero-dependency. Core types: `ConfigSource`, `ConfigDecoder`, `ConfigError`, `Provenance`, `FlagSource`, `StaticFlag`, `DynamicFlag`, `Rollout`. The shapes at the center of the module:
@@ -43,21 +43,21 @@ Most configuration libraries make you choose between two unpleasant options: a s
 The core module provides sources, decoding, and flags:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-config" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-config" % "0.0.56"
 ```
 
 Each file format is a separate artifact, so you depend only on the ones you use:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-config-yaml"  % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-config-json"  % "0.0.55"
-libraryDependencies += "dev.zio" %% "zio-blocks-config-hocon" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-yaml"  % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-json"  % "0.0.56"
+libraryDependencies += "dev.zio" %% "zio-blocks-config-hocon" % "0.0.56"
 ```
 
 For Scala.js, use `%%%` instead of `%%`:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-config" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-config" % "0.0.56"
 ```
 
 Supported Scala versions: 2.13.x and 3.x.

package/reference/config/rollout.md

@@ -141,7 +141,7 @@ Five methods cover parsing, evaluation, and diagnostics. `Rollout.select` is the
 Rollout.select("on@prod/50%; off", "prod", 10)
 // res9: Maybe[String] = "on"
 Rollout.select("@@@not-valid", "prod", 10)
-// res10: Maybe[String] = zio.blocks.maybe.Absent$@16d4dcbe
+// res10: Maybe[String] = zio.blocks.maybe.Absent$@53f42f8c
 ```
 
 Because a parse failure is indistinguishable from a non-match, use `Rollout.select` only where a malformed expression should behave as "no decision". Parse explicitly when you need to know.

package/reference/context.md

@@ -116,7 +116,7 @@ val config = ctx.get[Config]  // Compile-time proof it exists
 Add the ZIO Blocks Context module to your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-context" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-context" % "0.0.56"
 ```
 
 ## Construction

package/reference/data-migration.md

@@ -1,6 +1,6 @@
 ---
 id: data-migration
-title: "SQL Data Migration"
+title: "Data Migration"
 ---
 
 The `zio.blocks.data.migration` module provides three execution models for evolving database schemas online. It builds on [`Migration[A, B]`](./schema/migration.md) for the typed row transformation and [`Repo[E, ID]`](./sql/index.md) for database access. No hand-written SQL, no XML, no Liquibase-style migration files.

package/reference/datastar/index.md

@@ -41,13 +41,13 @@ This module closes each of those:
 Add the module to your build:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-datastar" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-datastar" % "0.0.56"
 ```
 
 For Scala.js, use `%%%` instead of `%%`:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-datastar" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-datastar" % "0.0.56"
 ```
 
 Supported Scala versions: 2.13.x and 3.x.

package/reference/datastar.md

@@ -9,10 +9,10 @@ title: "Datastar"
 
 ```scala
 // JVM
-libraryDependencies += "dev.zio" %% "zio-blocks-datastar" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-datastar" % "0.0.56"
 
 // Scala.js
-libraryDependencies += "dev.zio" %%% "zio-blocks-datastar" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-datastar" % "0.0.56"
 ```
 
 ## Signals

package/reference/docs.md

@@ -41,13 +41,13 @@ Markdown is the de facto standard for documentation, READMEs, and formatted text
 Add the dependency to your `build.sbt`:
 
 ```sbt
-libraryDependencies += "dev.zio" %% "zio-blocks-markdown" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-markdown" % "0.0.56"
 ```
 
 For Scala.js, use the cross-build syntax:
 
 ```sbt
-libraryDependencies += "dev.zio" %%% "zio-blocks-markdown" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-markdown" % "0.0.56"
 ```
 
 Supported Scala versions: 2.13.x and 3.x

package/reference/endpoint/endpoint.md

@@ -1,5 +1,6 @@
 ---
 id: endpoint
+slug: /reference/endpoint/endpoint
 title: "Endpoint"
 ---
 

package/reference/endpoint/index.md

@@ -41,18 +41,18 @@ The endpoint module is a cross-platform library (JVM + Scala.js). Add the depend
 
 **JVM (Scala 3.x):**
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-endpoint" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-endpoint" % "0.0.56"
 ```
 
 **Scala.js (Scala 3.x):**
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-endpoint" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-endpoint" % "0.0.56"
 ```
 
 **For Scala 3.7+**, the module name is rewritten to `zio-blocks-next-endpoint`:
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-next-endpoint" % "0.0.55"  // JVM
-libraryDependencies += "dev.zio" %%% "zio-blocks-next-endpoint" % "0.0.55" // Scala.js
+libraryDependencies += "dev.zio" %% "zio-blocks-next-endpoint" % "0.0.56"  // JVM
+libraryDependencies += "dev.zio" %%% "zio-blocks-next-endpoint" % "0.0.56" // Scala.js
 ```
 
 Supported Scala versions: 3.x (Scala 3 only — the endpoint module uses Scala 3-only DSL and macro code).

package/reference/html.md

@@ -77,13 +77,13 @@ Template engines with runtime parsing add overhead and complexity:
 Add to `build.sbt`:
 
 ```
-libraryDependencies += "dev.zio" %% "zio-blocks-html" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-html" % "0.0.56"
 ```
 
 For Scala.js projects, use `%%%`:
 
 ```
-libraryDependencies += "dev.zio" %%% "zio-blocks-html" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-html" % "0.0.56"
 ```
 
 Supported Scala versions: 2.13.x and 3.x

package/reference/htmx/index.md

@@ -52,10 +52,10 @@ Add the HTMX module to your project dependencies:
 
 ```scala
 // JVM
-libraryDependencies += "dev.zio" %% "zio-blocks-http-htmx" % "0.0.55"
+libraryDependencies += "dev.zio" %% "zio-blocks-http-htmx" % "0.0.56"
 
 // Scala.js
-libraryDependencies += "dev.zio" %%% "zio-blocks-http-htmx" % "0.0.55"
+libraryDependencies += "dev.zio" %%% "zio-blocks-http-htmx" % "0.0.56"
 ```
 
 Supported Scala versions: Scala 3.x. The module is cross-compiled for JVM and Scala.js.