@zio.dev/zio-blocks 0.0.29 → 0.0.31

package/reference/type-class-derivation.md

@@ -15,7 +15,7 @@ Consider a typical application with 50 domain types that needs 4 type classes (J
 
 Each instance requires understanding both the type's structure and the type class's semantics, then correctly implementing encoding, decoding, or whatever operation is required. This quickly becomes unmanageable as the codebase grows.
 
-Assume we have a simple `JsonCodec` type class for JSON serialization and deserialization:
+Assume we have a simple `JsonTC` type class for JSON serialization and deserialization:
 
 ```scala
 import zio.blocks.schema.json._
@@ -28,7 +28,7 @@ case class ParseError(details: String)
 case class DecodeError(details: String, path: String) 
   extends JsonError(s"Decode Error at '$path': $details")
 
-trait JsonCodec[A] {
+trait JsonTC[A] {
   def encode(a: A): Json
   def decode(j: Json): Either[JsonError, A]
 }
@@ -40,8 +40,8 @@ A single manual codec for a simple type like `Person` looks like the following c
 case class Person(name: String, age: Int)
 
 object Person {
-  implicit val personCodec: JsonCodec[Person] =
-    new JsonCodec[Person] {
+  implicit val personCodec: JsonTC[Person] =
+    new JsonTC[Person] {
       def encode(c: Person): Json = Json.obj(
         "name" -> Json.str(c.name),
         "age"  -> Json.number(c.age)
@@ -132,11 +132,11 @@ case class Schema[A](reflect: Reflect.Bound[A]) {
 }
 ```
 
-It takes a `Deriver[TC]` as a parameter and returns a type class instance of type `TC[A]`. For example, in the following code snippet, we derive a `JsonBinaryCodec[Person]` instance for the `Person` case class using the `JsonBinaryCodecDeriver`:
+It takes a `Deriver[TC]` as a parameter and returns a type class instance of type `TC[A]`. For example, in the following code snippet, we derive a `JsonCodec[Person]` instance for the `Person` case class using the `JsonCodecDeriver`:
 
 ```scala
 import zio.blocks.schema._
-import zio.blocks.schema.json.JsonBinaryCodecDeriver
+import zio.blocks.schema.json.JsonCodecDeriver
 
 case class Person(name: String, age: Int)
 
@@ -144,8 +144,7 @@ object Person {
   implicit val schema: Schema[Person] = Schema.derived[Person]
 }
 
-val jsonCodec: JsonBinaryCodec[Person] =
-  Person.schema.derive(JsonBinaryCodecDeriver)
+val jsonCodec: JsonCodec[Person] = Person.schema.derive(JsonCodecDeriver)
 
 val result: Either[SchemaError, Person] = 
   jsonCodec.decode(
@@ -1456,7 +1455,7 @@ Now we can use the derived `Gen[Person]` instance to generate random `Person` va
 
 ```scala
 val random = new Random(42) // Seeded for reproducible output
-// random: Random = scala.util.Random@1d1d8934
+// random: Random = scala.util.Random@76e55e4e
 
 Person.gen.generate(random)
 // res14: Person = Person(name = "p", age = -1360544799)
@@ -1831,8 +1830,8 @@ object User extends CompanionOptics[User] {
 Now we can derive a JSON codec with custom modifiers, renaming fields and marking one as transient, without changing the schema itself:
 
 ```scala
-val jsonCodec: JsonBinaryCodec[User] = User.schema
-  .deriving(JsonBinaryCodecDeriver)
+val jsonCodec: JsonCodec[User] = User.schema
+  .deriving(JsonCodecDeriver)
   .modifier(User.name, Modifier.rename("full_name"))
   .modifier(User.email, Modifier.alias("mail"))
   .modifier(User.internalScore, Modifier.transient())
@@ -1861,8 +1860,8 @@ new String(jsonCodec.encode(user), "UTF-8")
 The `modifier` method with `TypeId` allows you to add a `Modifier.Reflect` to all schema nodes of a given type. This is useful for attaching format-specific configuration metadata to all occurrences of a type:
 
 ```scala
-val jsonCodec: JsonBinaryCodec[User] = User.schema
-  .deriving(JsonBinaryCodecDeriver)
+val jsonCodec: JsonCodec[User] = User.schema
+  .deriving(JsonCodecDeriver)
   .modifier(TypeId.of[User], Modifier.config("json", "camelCase"))
   .modifier(User.internalScore, Modifier.transient())
   .derive
@@ -1873,8 +1872,8 @@ val jsonCodec: JsonBinaryCodec[User] = User.schema
 The `modifier` method with `TypeId` and `termName` allows you to add a `Modifier.Term` to a specific field or case identified by name inside a parent type identified by its `TypeId`. This is useful when you want to target a specific term without constructing an optic for it. The `typeId` refers to the parent record/variant type that owns the term. If no term with the given name exists in the parent type, the modifier is silently ignored:
 
 ```scala
-val jsonCodec: JsonBinaryCodec[User] = User.schema
-  .deriving(JsonBinaryCodecDeriver)
+val jsonCodec: JsonCodec[User] = User.schema
+  .deriving(JsonCodecDeriver)
   .modifier(User.schema.reflect.typeId, "name", Modifier.rename("full_name"))
   .modifier(User.schema.reflect.typeId, "internalScore", Modifier.transient())
   .derive

package/ringbuffer.md

@@ -25,7 +25,7 @@ All variants expose `offer` (returns `false` if full) and `take` (returns `null`
 ## Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-ringbuffer" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-ringbuffer" % "0.0.31"
 ```
 
 ---

package/sidebars.js

@@ -42,11 +42,15 @@ const sidebars = {
          {
            type: "category",
            label: "Resource Management & DI",
-           link: { type: "doc", id: "reference/resource-management-di/index" },
+           link: { type: "doc", id: "reference/resource-management/index" },
            items: [
-             "reference/resource-management-di/resource",
-             "reference/resource-management-di/scope",
-             "reference/resource-management-di/wire",
+             "reference/resource-management/scope",
+             "reference/resource-management/resource",
+             "reference/resource-management/wire",
+             "reference/resource-management/unscoped",
+             "reference/resource-management/defer-handle",
+             "reference/resource-management/finalizer",
+             "reference/resource-management/finalization",
            ]
          },
          "reference/combinators",
@@ -66,6 +70,7 @@ const sidebars = {
       type: "category",
       label: "Guides",
       items: [
+        "guides/compile-time-resource-safety-with-scope",
         "guides/zio-schema-migration",
         "guides/query-dsl-reified-optics",
         "guides/query-dsl-sql",

package/undocumented-report.md

@@ -59,7 +59,7 @@ These are core public API types that users interact with directly. Each needs a
 **schema module — JSON subsystem:**
 - [ ] **`Keyable`** — Type class for JSON key support. Referenced in 5 files. **Scope: new section in json.md**. Source: `schema/shared/src/main/scala/zio/blocks/schema/json/Keyable.scala`
 - [ ] **`NameMapper`** (`CamelCase`, `KebabCase`, `PascalCase`) — Public field name transformations. **Scope: new section in json.md**. Source: `schema/shared/src/main/scala/zio/blocks/schema/json/NameMapper.scala`
-- [ ] **`JsonBinaryCodecError`** — Custom exception for JSON codec errors. Referenced in 7 files. **Scope: brief section in json.md**. Source: `schema/shared/src/main/scala/zio/blocks/schema/json/JsonBinaryCodecError.scala`
+- [ ] **`JsonCodecError`** — Custom exception for JSON codec errors. Referenced in 7 files. **Scope: brief section in json.md**. Source: `schema/shared/src/main/scala/zio/blocks/schema/json/JsonCodecError.scala`
 
 **typeid module:**
 - [ ] **`TypeRepr`** — Central type representation (24 subtypes: ThisType, TypeLambda, Singleton, Repeated, etc.). Referenced across 4-8 files each. **Scope: new section in typeid.md**. Source: `typeid/shared/src/main/scala/zio/blocks/typeid/TypeRepr.scala`