@zio.dev/zio-blocks 0.0.27 → 0.0.29

package/guides/query-dsl-extending.md

@@ -52,7 +52,7 @@ Since `SchemaExpr` is a sealed trait, you cannot add new cases to it. Instead, w
 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.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.29"
 ```
 
 ```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.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.29"
 ```
 
 ## 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.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.29"
 ```
 
 ```scala

package/guides/query-dsl-sql.md

@@ -43,7 +43,7 @@ Since `SchemaExpr` is a sealed trait, we can write a single interpreter that tra
 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.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.29"
 ```
 
 ```scala

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.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema"            % "0.0.29"
 // Optional codec modules:
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro"       % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift"     % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson"       % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon"       % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro"       % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift"     % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson"       % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon"       % "0.0.29"
 ```
 
 Key points:

package/index.md

@@ -24,6 +24,7 @@ The philosophy is simple: **use what you need, nothing more**. Each block is ind
 | **TypeId** | Compile-time type identity with rich metadata | ✅ Available |
 | **Context** | Type-indexed heterogeneous collections | ✅ Available |
 | **MediaType** | Type-safe IANA media types with 2,600+ predefined types | ✅ Available |
+| **Ring Buffer** | High-performance bounded ring buffers (SPSC, MPSC, SPMC, MPMC) | ✅ Available |
 | **Streams** | Pull-based streaming primitives | 🚧 In Development |
 
 ## Core Principles
@@ -81,14 +82,14 @@ val thriftCodec  = Schema[Person].derive(ThriftFormat)      // Thrift
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema" % "0.0.29"
 
 // Optional format modules:
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro" % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon" % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift" % "0.0.27"
-libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-avro" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-toon" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-messagepack" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-thrift" % "0.0.29"
+libraryDependencies += "dev.zio" %% "zio-blocks-schema-bson" % "0.0.29"
 ```
 
 ### Example: Optics
@@ -143,7 +144,7 @@ Chunk is designed for:
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-chunk" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-chunk" % "0.0.29"
 ```
 
 ### Example
@@ -232,7 +233,7 @@ Scope.global.scoped { scope =>
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-scope" % "0.0.29"
 ```
 
 ### Example: Basic Resource Management
@@ -335,7 +336,7 @@ Generating documentation, README files, or any Markdown content programmatically
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-docs" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-docs" % "0.0.29"
 ```
 
 ### Example
@@ -419,7 +420,7 @@ Compile-time type identity with rich metadata. TypeId captures comprehensive inf
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-typeid" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-typeid" % "0.0.29"
 ```
 
 ### Example
@@ -462,7 +463,7 @@ A type-indexed heterogeneous collection that stores values by their types with c
 ### Installation
 
 ```scala
-libraryDependencies += "dev.zio" %% "zio-blocks-context" % "0.0.27"
+libraryDependencies += "dev.zio" %% "zio-blocks-context" % "0.0.29"
 ```
 
 ### Example
@@ -494,6 +495,47 @@ val merged: Context[Config & Metrics] = ctx1 ++ ctx2
 
 ---
 
+## Ring Buffer
+
+High-performance, bounded ring buffers for inter-thread communication. Four lock-free variants cover every producer/consumer pattern (SPSC, MPSC, SPMC, MPMC).
+
+### Why Ring Buffer?
+
+Standard `java.util.concurrent` queues use node allocation (`ConcurrentLinkedQueue`) or coarse locking (`ArrayBlockingQueue`). Ring buffers avoid both:
+
+- **Zero allocation** on the hot path—pre-allocated circular array
+- **Lock-free** on the fast path—CAS or release/acquire semantics only
+- **Cache-friendly**—sequential memory access with 128-byte padding between producer/consumer fields
+
+### Key Features
+
+- **Four concurrency patterns**: SPSC, SPMC, MPSC, MPMC—pick the most constrained variant for your use case
+- **Cross-platform**: Same API on JVM and Scala.js (JS uses sequential implementations)
+
+### Installation
+
+```scala
+libraryDependencies += "dev.zio" %% "zio-blocks-ringbuffer" % "0.0.29"
+```
+
+### Example
+
+```scala
+import zio.blocks.ringbuffer._
+
+// SPSC: fastest, for dedicated producer-consumer pairs
+val spsc = SpscRingBuffer[String](1024)
+spsc.offer("hello") // true
+spsc.take()          // "hello"
+
+// MPMC: general-purpose, any number of threads
+val mpmc = MpmcRingBuffer[String](1024)
+mpmc.offer("hello") // false if full
+mpmc.take()          // null if empty
+```
+
+---
+
 ## Streams (In Development)
 
 A pull-based streaming library for composable, backpressure-aware data processing.
@@ -526,18 +568,20 @@ Each block has zero dependencies on effect systems. Use the blocks directly, or
 
 ZIO Blocks supports **Scala 2.13** and **Scala 3.x** with full source compatibility. Write your code once and compile it against either version—migrate to Scala 3 when your team is ready, not when your dependencies force you.
 
-| Platform | Schema | Chunk | Scope | Docs | TypeId | Context | Streams |
-|----------|--------|-------|-------|------|--------|---------|---------|
-| JVM | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| Scala.js | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Platform | Schema | Chunk | Scope | Docs | TypeId | Context | Ring Buffer | Streams |
+|----------|--------|-------|-------|------|--------|---------|-------------|---------|
+| JVM | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Scala.js | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 
 ## Documentation
 
 ### Core Schema Concepts
 
 - [Schema](./reference/schema.md) - Core schema definitions and derivation
+- [Allows](./reference/allows.md) - Compile-time structural grammar constraints
 - [Reflect](./reference/reflect.md) - Structural reflection API
 - [Binding](./reference/binding.md) - Runtime constructors and deconstructors
+- [BindingResolver](./reference/binding-resolver.md) - Binding lookup and schema rebinding
 - [Registers](./reference/registers.md) - Register-based primitive storage
 
 ### Optics & Navigation
@@ -546,11 +590,14 @@ ZIO Blocks supports **Scala 2.13** and **Scala 3.x** with full source compatibil
 - [SchemaExpr](./reference/schema-expr.md) - Schema-aware expressions for queries and validation
 - [Path Interpolator](./path-interpolator.md) - Type-safe path construction
 - [DynamicValue](./reference/dynamic-value.md) - Schema-less dynamic values
+- [DynamicSchema](./reference/dynamic-schema.md) - Type-erased schemas for validation and cross-process transport
 
 ### Serialization
 
 - [Codec & Format](./reference/codec.md) - Codec, Format, BinaryCodec & TextCodec
 - [JSON](./reference/json.md) - JSON codec and parsing
+- [JsonPatch](./reference/json-patch.md) - Diff and patch JSON values
+- [JsonDiffer](./reference/json-differ.md) - Compute minimal diffs between JSON values
 - [JSON Schema](./reference/json-schema.md) - JSON Schema generation and validation
 - [Formats](./reference/formats.md) - Avro, TOON, MessagePack, BSON, Thrift
 - [Extension Syntax](./reference/syntax.md) - `.toJson`, `.fromJson`, and more
@@ -560,16 +607,21 @@ ZIO Blocks supports **Scala 2.13** and **Scala 3.x** with full source compatibil
 - [Patching](./reference/patch.md) - Serializable data transformations
 - [SchemaError](./reference/schema-error.md) - Structured error type for schema operations
 - [Validation](./reference/validation.md) - Data validation and error handling
-- [Schema Evolution](./reference/schema-evolution.md) - Migration and compatibility
+- [Schema Evolution](./reference/schema-evolution/index.md) - One-way and bidirectional type-safe conversions
+  - [Into](./reference/schema-evolution/into.md) - One-way conversion with validation
+  - [As](./reference/schema-evolution/as.md) - Bidirectional round-trip conversion
 
 ### Other Blocks
 
 - [Chunk](./reference/chunk.md) - High-performance immutable sequences
-- [Scope](./scope.md) - Compile-time safe resource management and DI
+- [Scope](./reference/resource-management-di/scope.md) - Compile-time safe resource management and DI
+- [Wire](./reference/resource-management-di/wire.md) - Recipes for constructing services and dependencies
 - [TypeId](./reference/typeid.md) - Type identity and metadata
 - [Context](./reference/context.md) - Type-indexed heterogeneous collections
 - [Docs (Markdown)](./reference/docs.md) - Markdown parsing and rendering
 - [MediaType](./reference/media-type.md) - Type-safe IANA media types
+- [HTTP Model](./reference/http-model.md) - Pure HTTP data model with URL parsing, headers, cookies, and forms
+- [Ring Buffer](./ringbuffer.md) - High-performance bounded ring buffers
 
 ### Guides
 

package/package.json

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

package/path-interpolator.md

@@ -212,6 +212,65 @@ p"<café>"          // Unicode case names
 p"<A><B><C>"       // Nested variants
 ```
 
+### Schema Search
+
+Search for values matching a schema pattern anywhere in a data structure using the `#` prefix.
+
+**Nominal types:**
+
+```scala
+p"#Person"         // Find all values of type Person
+p"#User"           // Find all values of type User
+p"#Address"        // Find all values of type Address
+```
+
+**Primitive types:**
+
+```scala
+p"#string"         // Find all string values
+p"#int"            // Find all integer values
+p"#boolean"        // Find all boolean values
+p"#uuid"           // Find all UUID values
+```
+
+**Structural records:**
+
+```scala
+p"#record { name: string }"                // Find records with a string 'name' field
+p"#record { name: string, age: int }"      // Find records with both fields
+p"#record { items: list(Person) }"         // Nested schema
+```
+
+**Structural variants:**
+
+```scala
+p"#variant { Left: int, Right: string }"   // Find Either-like variants
+```
+
+**Collections:**
+
+```scala
+p"#list(string)"                           // Find lists of strings
+p"#list(Person)"                           // Find lists of Person
+p"#map(string, int)"                       // Find maps from string to int
+p"#option(Person)"                         // Find optional Person values
+```
+
+**Wildcard:**
+
+```scala
+p"#_"              // Find any value (matches everything)
+```
+
+**Combined paths with search:**
+
+```scala
+p".users#Person"               // Search for Person in users field
+p"#Person.name"                // Find all Person values, then get name
+p".items[*]#Person.email"      // Elements then search then field
+p"#list(Person)#Person"        // Chained searches
+```
+
 ## Escape Sequences
 
 String and character literals support standard escape sequences:
@@ -623,15 +682,17 @@ val same = p".users[*].email"
 |------------------------------------------------------|-------------------|
 | `DynamicOptic.root.field("name")`                    | `.name`           |
 | `DynamicOptic.root.field("address").field("street")` | `.address.street` |
-| `DynamicOptic.root.caseOf("Some")`                   | `<Some>`          |
-| `DynamicOptic.root.at(0)`                            | `[0]`             |
-| `DynamicOptic.root.atIndices(0, 2, 5)`               | `[0,2,5]`         |
-| `DynamicOptic.elements`                              | `[*]`             |
-| `DynamicOptic.root.atKey("host")`                    | `{"host"}`        |
-| `DynamicOptic.root.atKey(80)`                        | `{80}`            |
-| `DynamicOptic.mapValues`                             | `{*}`             |
-| `DynamicOptic.mapKeys`                               | `{*:}`            |
-| `DynamicOptic.wrapped`                               | `.~`              |
+| `DynamicOptic.root.caseOf("Some")`                                      | `<Some>`          |
+| `DynamicOptic.root.at(0)`                                               | `[0]`             |
+| `DynamicOptic.root.atIndices(0, 2, 5)`                                  | `[0,2,5]`         |
+| `DynamicOptic.elements`                                                 | `[*]`             |
+| `DynamicOptic.root.atKey("host")`                                       | `{"host"}`        |
+| `DynamicOptic.root.atKey(80)`                                           | `{80}`            |
+| `DynamicOptic.mapValues`                                                | `{*}`             |
+| `DynamicOptic.mapKeys`                                                  | `{*:}`            |
+| `DynamicOptic.wrapped`                                                  | `.~`              |
+| `DynamicOptic.root.searchSchema(SchemaRepr.Nominal("Person"))`          | `#Person`         |
+| `DynamicOptic.root.searchSchema(SchemaRepr.Primitive("string"))`        | `#string`         |
 
 ## Summary