@zio.dev/zio-blocks 0.0.51 → 0.0.55

package/reference/resource-management/resource.md

@@ -36,13 +36,13 @@ Without Resources, managing complex initialization and cleanup is tedious and er
 Add the ZIO Blocks Scope module to your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.51"
+libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.55"
 ```
 
 For cross-platform (Scala.js):
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-scope" % "0.0.51"
+libraryDependencies += "dev.zio" %%% "zio-blocks-scope" % "0.0.55"
 ```
 
 Supported Scala versions: 2.13.x and 3.x.
@@ -730,22 +730,6 @@ cd zio-blocks
 This example demonstrates creating and automatically cleaning up temporary files using Resource's lifecycle management. It shows how Resource ensures files are closed even if exceptions occur:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/TempFileHandlingExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -843,22 +827,6 @@ sbt "scope-examples/runMain scope.examples.tempFileHandlingExample"
 This example demonstrates the acquire-release pattern using Resource to manage database connections. It shows proper connection initialization and guaranteed cleanup:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/DatabaseConnectionExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -996,22 +964,6 @@ sbt "scope-examples/runMain scope.examples.runDatabaseExample"
 This example demonstrates Resource.shared to create a singleton logger instance that is automatically cleaned up only when the last service releases it. Shows reference counting in action:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/CachingSharedLoggerExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1163,22 +1115,6 @@ sbt "scope-examples/runMain scope.examples.runCachingExample"
 This example demonstrates using Resource.shared for a database connection pool—an expensive resource that should exist exactly once. Shows how multiple services safely share the same pool instance with automatic cleanup:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/ConnectionPoolExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1336,22 +1272,6 @@ sbt "scope-examples/runMain scope.examples.connectionPoolExample"
 This example demonstrates combining Resource with transaction boundaries. Shows how to manage resources (connections, transactions) that must be coordinated across scopes with proper rollback on failure:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/TransactionBoundaryExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1504,22 +1424,6 @@ sbt "scope-examples/runMain scope.examples.runTransactionBoundaryExample"
 This example demonstrates Resource.from macro to automatically build a complex dependency graph with multiple services. Shows automatic wiring of constructor dependencies and cleanup in correct LIFO order:
 
 ```scala title="scope-examples/src/main/scala/scope/examples/LayeredWebServiceExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._

package/reference/resource-management/scope.md

@@ -55,7 +55,7 @@ If you've used `try/finally`, `Using`, or ZIO's `Scope`, this is the same proble
 Add the following dependency to your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.51"
+libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.55"
 ```
 
 Supported Scala versions: **2.13.x** and **3.x**.
@@ -1096,22 +1096,6 @@ cd zio-blocks
 This example demonstrates how to allocate a database connection within a scope, ensure proper cleanup, and handle the connection's lifecycle safely.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/DatabaseConnectionExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1247,22 +1231,6 @@ sbt "scope-examples/runMain runDatabaseExample"
 This example demonstrates allocating multiple connections from a pool within the same scope and ensuring all are cleaned up correctly.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/ConnectionPoolExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1418,22 +1386,6 @@ sbt "scope-examples/runMain scope.examples.connectionPoolExample"
 This example shows how to allocate temporary file resources and ensure they are automatically cleaned up when the scope closes, even if errors occur.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/TempFileHandlingExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1529,22 +1481,6 @@ sbt "scope-examples/runMain scope.examples.tempFileHandlingExample"
 This example demonstrates managing database transactions within a scope, showing how to handle commit and rollback operations correctly.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/TransactionBoundaryExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1695,22 +1631,6 @@ sbt "scope-examples/runMain scope.examples.runTransactionBoundaryExample"
 This example shows how to build an HTTP client pipeline with interceptors for logging, authentication, and error handling, all managed within a scope.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/HttpClientPipelineExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1834,22 +1754,6 @@ sbt "scope-examples/runMain scope.examples.httpClientPipelineExample"
 This example demonstrates allocating a logger once at the top level and sharing it across multiple services, ensuring it is properly closed when the application shuts down.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/CachingSharedLoggerExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -1999,22 +1903,6 @@ sbt "scope-examples/runMain scope.examples.runCachingExample"
 This example shows how to build a multi-layered web service using Scope for dependency injection, allocating services at different layers and passing them down through child scopes.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/LayeredWebServiceExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2135,22 +2023,6 @@ sbt "scope-examples/runMain scope.examples.layeredWebServiceExample"
 This example demonstrates loading configuration from a file within a scope, ensuring the file handle is properly closed when no longer needed.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/ConfigReaderExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2279,22 +2151,6 @@ sbt "scope-examples/runMain scope.examples.runConfigReaderExample"
 This example shows how to build a plugin system that discovers and loads plugins dynamically, managing their lifecycle with scopes.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/PluginArchitectureExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2422,22 +2278,6 @@ sbt "scope-examples/runMain scope.examples.pluginArchitectureExample"
 This example demonstrates how Scope enforces thread ownership, preventing cross-thread scope misuse and illustrating the difference between owned and unowned scopes.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/ThreadOwnershipExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2607,22 +2447,6 @@ sbt "scope-examples/runMain runThreadOwnershipExample"
 This example shows how to detect and handle circular dependencies in resource management, illustrating how scopes help prevent subtle bugs in complex dependency graphs.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/CircularDependencyDemoExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2746,22 +2570,6 @@ sbt "scope-examples/runMain scope.examples.circularDependencyDemoExample"
 This example demonstrates how to integrate Scope with legacy libraries that don't natively support resource management, using wrapper resources and the `leak` escape hatch when necessary.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/LegacyLibraryInteropExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._
@@ -2888,22 +2696,6 @@ sbt "scope-examples/runMain scope.examples.legacyLibraryInteropExample"
 This example shows how to use Scope to manage test fixtures and resources in integration tests, ensuring automatic cleanup between test runs and proper resource finalization.
 
 ```scala title="scope-examples/src/main/scala/scope/examples/IntegrationTestHarnessExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 scope.examples
 
 import zio.blocks.scope._

package/reference/resource-management/wire.md

@@ -92,13 +92,13 @@ Scope.global.scoped { scope =>
 Add the following dependency to your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.51"
+libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.55"
 ```
 
 For cross-platform (Scala.js):
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-scope" % "0.0.51"
+libraryDependencies += "dev.zio" %%% "zio-blocks-scope" % "0.0.55"
 ```
 
 Supported Scala versions: 2.13.x and 3.x.
@@ -505,6 +505,8 @@ When `Resource.from` composes wires, it respects the sharing strategy:
 
 The macro detects cycles, duplicate providers, and missing dependencies at compile time.
 
+The `AppConfig` leaf above is hardcoded, which is rarely what a real graph wants. `Config.wire[A]` produces a `Wire.Shared[ConfigSource, A]` that decodes `A` from an injected `ConfigSource`, so configuration becomes a node in the graph rather than something resolved before it — see [Config](../config/index.md).
+
 ## Comparison with Alternatives
 
 | Feature | Wire | Manual Passing | Service Locator |
@@ -531,22 +533,6 @@ cd zio-blocks
 Basic wire construction demonstrates how to create and use `Wire` for dependency injection. View the example source code:
 
 ```scala title="scope-examples/src/main/scala/wire/WireBasicExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 wire
 
 import zio.blocks.scope._
@@ -650,22 +636,6 @@ sbt "scope-examples/runMain wire.wireBasicExample"
 Comparing shared vs unique semantics shows how shared wires reuse the same instance across dependents, while unique wires create fresh instances. View the example:
 
 ```scala title="scope-examples/src/main/scala/wire/WireSharedUniqueExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 wire
 
 import zio.blocks.scope._
@@ -771,22 +741,6 @@ sbt "scope-examples/runMain wire.wireSharedUniqueExample"
 Manual wire construction demonstrates how to use `fromFunction` for custom construction logic. View the example:
 
 ```scala title="scope-examples/src/main/scala/wire/WireFromFunctionExample.scala" 
-/*
- * Copyright 2024-2026 John A. De Goes and the ZIO Contributors
- *
- * 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 wire
 
 import zio.blocks.scope._

package/reference/ringbuffer/advanced.mdx

@@ -64,7 +64,7 @@ Batching reduces per-element synchronization costs.
 
 When multiple workers consume from the same queue, use `MpmcRingBuffer`. Each worker calls `MpmcRingBuffer#take` to grab the next item atomically:
 
-```scala mdoc:compile-only
+```scala
 import zio.blocks.ringbuffer.MpmcRingBuffer
 
 case class Task(id: Int, work: String)

package/reference/ringbuffer/index.mdx

@@ -48,7 +48,7 @@ Building low-latency systems — trading platforms, game engines, real-time even
 
 A naive approach is to pre-allocate a large `Array[A]` and manually manage head/tail indices. This code shows a simplified single-threaded version:
 
-```scala mdoc:compile-only
+```scala
 class SimpleRingBuffer {
   // WARNING: Mutable state (vars) demonstrated here to show the problem;
   // this is NOT how ring buffers actually solve concurrency.
@@ -124,13 +124,13 @@ RingBuffer is ideal when you control both producer and consumer thread counts an
 Add the ZIO Blocks Ring Buffer module to your `build.sbt`:
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-ringbuffer" % "@VERSION@"
+libraryDependencies += "dev.zio" %% "zio-blocks-ringbuffer" % "0.0.55"
 ```
 
 For Scala.js cross-platform support:
 
 ```scala
-libraryDependencies += "dev.zio" %%% "zio-blocks-ringbuffer" % "@VERSION@"
+libraryDependencies += "dev.zio" %%% "zio-blocks-ringbuffer" % "0.0.55"
 ```
 
 ## Implementations

package/reference/ringbuffer/mpmc.mdx

@@ -92,7 +92,7 @@ Creates a new MPMC ring buffer with the given capacity. The capacity must be a p
 
 To create an MPMC buffer:
 
-```scala mdoc:compile-only
+```scala
 import zio.blocks.ringbuffer.MpmcRingBuffer
 
 val rb = MpmcRingBuffer[String](128)
@@ -138,10 +138,44 @@ All four implementations provide the same method signatures: `size`, `isEmpty`,
 
 For workloads with multiple producers and consumers, use `MpmcRingBuffer`. This example demonstrates how multiple workers coordinate to process tasks from a shared queue.
 
-```scala mdoc:passthrough
-import docs.SourceFile
+```scala title="zio-blocks-examples/src/main/scala/ringbuffer/MpmcExample.scala" 
+package ringbuffer
 
-SourceFile.print("zio-blocks-examples/src/main/scala/ringbuffer/MpmcExample.scala")
+import zio.blocks.ringbuffer.MpmcRingBuffer
+import java.util.concurrent.{CountDownLatch, Thread}
+import java.util.concurrent.atomic.AtomicInteger
+
+object MpmcExample extends App {
+  val buffer = MpmcRingBuffer[String](32)
+  val processed = new AtomicInteger(0)
+  val latch = new CountDownLatch(2)
+
+  val producers = (0 until 2).map { id =>
+    new Thread(() => {
+      for (i <- 1 to 5) {
+        buffer.offer(s"task-$id-$i")
+      }
+    })
+  }
+
+  val consumers = (0 until 2).map { _ =>
+    new Thread(() => {
+      while (processed.get() < 10) {
+        val task = buffer.take()
+        if (task ne null) {
+          println(s"Worker processing: $task")
+          processed.incrementAndGet()
+        }
+      }
+      latch.countDown()
+    })
+  }
+
+  (producers ++ consumers).foreach(_.start())
+  producers.foreach(_.join())
+  latch.await()
+  println("All tasks completed")
+}
 ```
 
 ([source](https://github.com/zio/zio-blocks/blob/main/zio-blocks-examples/src/main/scala/ringbuffer/MpmcExample.scala))