@zio.dev/zio-blocks 0.0.32 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/guides/compile-time-resource-safety-with-scope.md +16 -17
  2. package/guides/getting-started-with-mux.md +1507 -0
  3. package/guides/query-dsl-extending.md +161 -102
  4. package/guides/query-dsl-fluent-builder.md +217 -157
  5. package/guides/query-dsl-reified-optics.md +12 -10
  6. package/guides/query-dsl-sql.md +246 -165
  7. package/guides/telemetry-guide.md +1069 -0
  8. package/guides/zio-schema-migration.md +29 -22
  9. package/index.md +293 -51
  10. package/package.json +1 -1
  11. package/plans/config-follow-up-prs.md +188 -0
  12. package/plans/config-pr-assessment-roadmap.md +310 -0
  13. package/reference/MuxDataFlow.jsx +250 -0
  14. package/reference/async.md +651 -0
  15. package/reference/chunk.md +3533 -308
  16. package/reference/codegen/case-class.md +436 -0
  17. package/reference/codegen/emitter-config.md +383 -0
  18. package/reference/codegen/examples.md +664 -0
  19. package/reference/codegen/field.md +316 -0
  20. package/reference/codegen/index.md +317 -0
  21. package/reference/codegen/scala-emitter.md +392 -0
  22. package/reference/codegen/scala-file.md +276 -0
  23. package/reference/codegen/sealed-trait.md +408 -0
  24. package/reference/codegen/type-definition.md +340 -0
  25. package/reference/codegen/type-ref.md +201 -0
  26. package/reference/combinators.md +347 -117
  27. package/reference/config.md +158 -0
  28. package/reference/context.md +4 -4
  29. package/reference/datastar.md +346 -0
  30. package/reference/docs.md +1461 -345
  31. package/reference/endpoint/auth-type.md +146 -0
  32. package/reference/endpoint/endpoint.md +297 -0
  33. package/reference/endpoint/http-codec.md +249 -0
  34. package/reference/endpoint/index.md +825 -0
  35. package/reference/endpoint/path-codec.md +237 -0
  36. package/reference/endpoint/route-pattern.md +196 -0
  37. package/reference/endpoint/route-tree.md +111 -0
  38. package/reference/endpoint/segment-codec.md +212 -0
  39. package/reference/html.md +1120 -0
  40. package/reference/htmx/attribute-values.md +359 -0
  41. package/reference/htmx/hx-encoding.md +111 -0
  42. package/reference/htmx/hx-params.md +204 -0
  43. package/reference/htmx/hx-swap.md +276 -0
  44. package/reference/htmx/hx-sync.md +251 -0
  45. package/reference/htmx/hx-target.md +314 -0
  46. package/reference/htmx/hx-trigger.md +457 -0
  47. package/reference/htmx/hx-url-update.md +239 -0
  48. package/reference/htmx/index.md +855 -0
  49. package/reference/http-model/index.md +47 -0
  50. package/reference/http-model/model.md +1481 -0
  51. package/reference/http-model/schema.md +747 -0
  52. package/reference/maybe.md +826 -0
  53. package/reference/media-type.md +2 -2
  54. package/reference/mux.mdx +823 -0
  55. package/reference/openapi.md +1351 -0
  56. package/reference/resource-management/defer-handle.md +1 -1
  57. package/reference/resource-management/resource.md +31 -2
  58. package/reference/resource-management/scope.md +28 -12
  59. package/reference/resource-management/wire.md +3 -7
  60. package/reference/ringbuffer/MpmcDiagram.jsx +717 -0
  61. package/reference/ringbuffer/MpscDiagram.jsx +618 -0
  62. package/reference/ringbuffer/SpmcDiagram.jsx +680 -0
  63. package/reference/ringbuffer/SpscDiagram.jsx +677 -0
  64. package/reference/ringbuffer/advanced.mdx +109 -0
  65. package/reference/ringbuffer/index.mdx +145 -0
  66. package/reference/ringbuffer/mpmc.mdx +151 -0
  67. package/reference/ringbuffer/mpsc.mdx +132 -0
  68. package/reference/ringbuffer/spmc.mdx +108 -0
  69. package/reference/ringbuffer/spsc.mdx +344 -0
  70. package/reference/{allows.md → schema/allows.md} +4 -4
  71. package/reference/{binding-resolver.md → schema/binding-resolver.md} +1 -1
  72. package/reference/{binding.md → schema/binding.md} +2 -3
  73. package/reference/schema/built-in-codecs/avro.md +451 -0
  74. package/reference/schema/built-in-codecs/bson.md +480 -0
  75. package/reference/schema/built-in-codecs/csv.md +564 -0
  76. package/reference/schema/built-in-codecs/index.md +77 -0
  77. package/reference/schema/built-in-codecs/json/index.md +295 -0
  78. package/reference/schema/built-in-codecs/json/json-config.md +217 -0
  79. package/reference/{json-patch.md → schema/built-in-codecs/json/json-patch.md} +3 -3
  80. package/reference/{json-schema.md → schema/built-in-codecs/json/json-schema.md} +14 -47
  81. package/reference/schema/built-in-codecs/json/json-selection.md +322 -0
  82. package/reference/{json.md → schema/built-in-codecs/json/json.md} +32 -64
  83. package/reference/schema/built-in-codecs/messagepack.md +508 -0
  84. package/reference/schema/built-in-codecs/thrift.md +433 -0
  85. package/reference/schema/built-in-codecs/toon.md +1078 -0
  86. package/reference/{xml.md → schema/built-in-codecs/xml.md} +34 -192
  87. package/reference/schema/built-in-codecs/yaml.md +552 -0
  88. package/reference/{codec.md → schema/codec.md} +10 -10
  89. package/reference/{dynamic-optic.md → schema/dynamic-optic.md} +151 -5
  90. package/reference/{dynamic-schema.md → schema/dynamic-schema.md} +8 -8
  91. package/reference/schema/format.md +92 -0
  92. package/reference/schema/index.md +50 -0
  93. package/reference/schema/migration.md +297 -0
  94. package/reference/{modifier.md → schema/modifier.md} +58 -7
  95. package/reference/{optics.md → schema/optics.md} +2 -2
  96. package/reference/{patch.md → schema/patch.md} +1 -1
  97. package/{path-interpolator.md → reference/schema/path-interpolator.md} +165 -72
  98. package/reference/{schema-evolution → schema/schema-evolution}/as.md +5 -5
  99. package/reference/{schema-evolution → schema/schema-evolution}/index.md +2 -2
  100. package/reference/{schema-evolution → schema/schema-evolution}/into.md +3 -3
  101. package/reference/{schema-expr.md → schema/schema-expr.md} +110 -175
  102. package/reference/{schema.md → schema/schema.md} +13 -1
  103. package/reference/{structural-types.md → schema/structural-types.md} +1 -1
  104. package/reference/{type-class-derivation.md → schema/type-class-derivation.md} +63 -1
  105. package/reference/smithy.md +533 -0
  106. package/reference/sql/db-codec-deriver.md +71 -0
  107. package/reference/sql/db-codec.md +687 -0
  108. package/reference/sql/db-con.md +271 -0
  109. package/reference/sql/db-connection.md +153 -0
  110. package/reference/sql/db-param-writer.md +77 -0
  111. package/reference/sql/db-param.md +66 -0
  112. package/reference/sql/db-result-reader.md +146 -0
  113. package/reference/sql/db-tx.md +82 -0
  114. package/reference/sql/db-value.md +41 -0
  115. package/reference/sql/ddl.md +85 -0
  116. package/reference/sql/frag.md +254 -0
  117. package/reference/sql/index.md +341 -0
  118. package/reference/sql/repo.md +600 -0
  119. package/reference/sql/sql-dialect.md +73 -0
  120. package/reference/sql/sql-logger.md +62 -0
  121. package/reference/sql/sql-name-mapper.md +70 -0
  122. package/reference/sql/table-metadata.md +134 -0
  123. package/reference/sql/table.md +448 -0
  124. package/reference/sql/transactor-zio.md +399 -0
  125. package/reference/sql/transactor.md +353 -0
  126. package/reference/sql-zio.md +112 -0
  127. package/reference/streams/concurrent-operators.md +106 -0
  128. package/reference/streams/index.md +653 -0
  129. package/reference/streams/pipeline.md +718 -0
  130. package/reference/streams/reader.md +1284 -0
  131. package/reference/streams/scala-2-compatibility.md +55 -0
  132. package/reference/streams/sink.md +1426 -0
  133. package/reference/streams/stream.md +2526 -0
  134. package/reference/streams/writer.md +1045 -0
  135. package/reference/streams/zero-boxing.md +275 -0
  136. package/reference/telemetry.md +693 -0
  137. package/reference/typeid.md +2922 -583
  138. package/sidebars.js +238 -43
  139. package/superpowers/plans/2026-03-19-docs-critique-subagent.md +407 -0
  140. package/superpowers/specs/2026-03-19-docs-critique-subagent-design.md +222 -0
  141. package/reference/formats.md +0 -694
  142. package/reference/http-model.md +0 -1716
  143. package/reference/streams.md +0 -989
  144. package/ringbuffer.md +0 -249
  145. /package/reference/{json-differ.md → schema/built-in-codecs/json/json-differ.md} +0 -0
  146. /package/reference/{dynamic-value.md → schema/dynamic-value.md} +0 -0
  147. /package/reference/{lazy.md → schema/lazy.md} +0 -0
  148. /package/reference/{reflect.md → schema/reflect.md} +0 -0
  149. /package/reference/{registers.md → schema/registers.md} +0 -0
  150. /package/reference/{schema-error.md → schema/schema-error.md} +0 -0
  151. /package/reference/{syntax.md → schema/syntax.md} +0 -0
  152. /package/reference/{validation.md → schema/validation.md} +0 -0
package/sidebars.js CHANGED
@@ -6,38 +6,111 @@ const sidebars = {
6
6
  collapsed: false,
7
7
  link: { type: "doc", id: "index" },
8
8
  items: [
9
- "reference/schema",
10
- "reference/allows",
11
- "reference/reflect",
12
- "reference/binding",
13
- "reference/binding-resolver",
14
- "reference/registers",
15
- "reference/typeid",
16
- "reference/modifier",
17
- "reference/dynamic-value",
18
- "reference/dynamic-schema",
19
- "reference/lazy",
20
- "reference/structural-types",
21
- "reference/optics",
22
- "reference/patch",
23
- "reference/schema-expr",
24
- "reference/dynamic-optic",
25
- "reference/type-class-derivation",
26
- "reference/codec",
27
- "reference/formats",
28
- "path-interpolator",
29
- "reference/chunk",
30
- "reference/schema-error",
31
- "reference/validation",
32
9
  {
33
10
  type: "category",
34
- label: "Schema Evolution",
35
- link: { type: "doc", id: "reference/schema-evolution/index" },
11
+ label: "Schema",
12
+ link: { type: "doc", id: "reference/schema/index" },
36
13
  items: [
37
- "reference/schema-evolution/into",
38
- "reference/schema-evolution/as",
14
+ {
15
+ type: "category",
16
+ label: "Core Type System",
17
+ collapsed: false,
18
+ items: [
19
+ "reference/schema/schema",
20
+ "reference/schema/reflect",
21
+ "reference/schema/binding",
22
+ "reference/schema/registers",
23
+ "reference/schema/binding-resolver",
24
+ "reference/schema/modifier",
25
+ "reference/schema/structural-types",
26
+ ]
27
+ },
28
+ {
29
+ type: "category",
30
+ label: "Dynamic Values",
31
+ collapsed: false,
32
+ items: [
33
+ "reference/schema/dynamic-value",
34
+ "reference/schema/dynamic-schema",
35
+ ]
36
+ },
37
+ {
38
+ type: "category",
39
+ label: "Reflective Optics",
40
+ collapsed: false,
41
+ items: [
42
+ "reference/schema/optics",
43
+ "reference/schema/dynamic-optic",
44
+ "reference/schema/path-interpolator",
45
+ "reference/schema/schema-expr",
46
+ "reference/schema/patch",
47
+ ]
48
+ },
49
+ {
50
+ type: "category",
51
+ label: "Serialization",
52
+ collapsed: false,
53
+ items: [
54
+ "reference/schema/type-class-derivation",
55
+ "reference/schema/codec",
56
+ "reference/schema/format",
57
+ "reference/schema/lazy",
58
+ ]
59
+ },
60
+ {
61
+ type: "category",
62
+ label: "Built-in Formats and Codecs",
63
+ link: { type: "doc", id: "reference/schema/built-in-codecs/index" },
64
+ collapsed: false,
65
+ items: [
66
+ {
67
+ type: "category",
68
+ label: "JSON Codec",
69
+ link: { type: "doc", id: "reference/schema/built-in-codecs/json/index" },
70
+ collapsed: false,
71
+ items: [
72
+ "reference/schema/built-in-codecs/json/json",
73
+ "reference/schema/built-in-codecs/json/json-config",
74
+ "reference/schema/built-in-codecs/json/json-patch",
75
+ "reference/schema/built-in-codecs/json/json-differ",
76
+ "reference/schema/built-in-codecs/json/json-selection",
77
+ "reference/schema/built-in-codecs/json/json-schema",
78
+ ]
79
+ },
80
+ "reference/schema/built-in-codecs/avro",
81
+ "reference/schema/built-in-codecs/bson",
82
+ "reference/schema/built-in-codecs/csv",
83
+ "reference/schema/built-in-codecs/messagepack",
84
+ "reference/schema/built-in-codecs/thrift",
85
+ "reference/schema/built-in-codecs/toon",
86
+ "reference/schema/built-in-codecs/xml",
87
+ "reference/schema/built-in-codecs/yaml",
88
+ ]
89
+ },
90
+ {
91
+ type: "category",
92
+ label: "Validation & Errors",
93
+ collapsed: false,
94
+ items: [
95
+ "reference/schema/validation",
96
+ "reference/schema/schema-error",
97
+ "reference/schema/allows",
98
+ ]
99
+ },
100
+ {
101
+ type: "category",
102
+ label: "Schema Evolution",
103
+ link: { type: "doc", id: "reference/schema/schema-evolution/index" },
104
+ items: [
105
+ "reference/schema/schema-evolution/into",
106
+ "reference/schema/schema-evolution/as",
107
+ "reference/schema/migration",
108
+ ]
109
+ },
110
+ "reference/schema/syntax",
39
111
  ]
40
112
  },
113
+ "reference/typeid",
41
114
  "reference/context",
42
115
  {
43
116
  type: "category",
@@ -52,30 +125,152 @@ const sidebars = {
52
125
  "reference/resource-management/finalizer",
53
126
  "reference/resource-management/finalization",
54
127
  ]
128
+ },
129
+ "reference/combinators",
130
+ "reference/docs",
131
+ "reference/config",
132
+ "reference/media-type",
133
+ {
134
+ type: "category",
135
+ label: "Code Generation",
136
+ link: { type: "doc", id: "reference/codegen/index" },
137
+ items: [
138
+ "reference/codegen/scala-file",
139
+ "reference/codegen/type-definition",
140
+ "reference/codegen/case-class",
141
+ "reference/codegen/sealed-trait",
142
+ "reference/codegen/field",
143
+ "reference/codegen/type-ref",
144
+ "reference/codegen/scala-emitter",
145
+ "reference/codegen/emitter-config",
146
+ "reference/codegen/examples",
147
+ ]
55
148
  },
56
- "reference/combinators",
57
- "reference/docs",
58
- "reference/json",
59
- "reference/json-patch",
60
- "reference/json-differ",
61
- "reference/json-schema",
62
- "reference/xml",
63
- "reference/syntax",
64
- "reference/media-type",
65
- "reference/http-model",
66
- "ringbuffer",
67
- ]
68
- },
149
+ {
150
+ type: "category",
151
+ label: "ZIO Blocks HTTP Model",
152
+ link: { type: "doc", id: "reference/http-model/index" },
153
+ items: [
154
+ "reference/http-model/model",
155
+ "reference/http-model/schema",
156
+ ]
157
+ },
158
+ {
159
+ type: "category",
160
+ label: "ZIO Blocks Endpoint",
161
+ link: { type: "doc", id: "reference/endpoint/index" },
162
+ items: [
163
+ "reference/endpoint/endpoint",
164
+ "reference/endpoint/http-codec",
165
+ "reference/endpoint/route-pattern",
166
+ "reference/endpoint/path-codec",
167
+ "reference/endpoint/segment-codec",
168
+ "reference/endpoint/auth-type",
169
+ "reference/endpoint/route-tree",
170
+ ]
171
+ },
172
+ "reference/chunk",
173
+ "reference/maybe",
174
+ "reference/mux",
175
+ "reference/async",
176
+ {
177
+ type: "category",
178
+ label: "RingBuffer",
179
+ link: { type: "doc", id: "reference/ringbuffer/index" },
180
+ items: [
181
+ "reference/ringbuffer/spsc",
182
+ "reference/ringbuffer/spmc",
183
+ "reference/ringbuffer/mpsc",
184
+ "reference/ringbuffer/mpmc",
185
+ "reference/ringbuffer/advanced",
186
+ ]
187
+ },
188
+ "reference/html",
189
+ "reference/smithy",
190
+ "reference/datastar",
191
+ {
192
+ type: "category",
193
+ label: "HTMX",
194
+ link: { type: "doc", id: "reference/htmx/index" },
195
+ items: [
196
+ "reference/htmx/hx-swap",
197
+ "reference/htmx/hx-trigger",
198
+ "reference/htmx/hx-target",
199
+ "reference/htmx/hx-params",
200
+ "reference/htmx/hx-url-update",
201
+ "reference/htmx/hx-encoding",
202
+ "reference/htmx/hx-sync",
203
+ "reference/htmx/attribute-values",
204
+ ]
205
+ },
206
+ {
207
+ type: "category",
208
+ label: "Streams",
209
+ link: { type: "doc", id: "reference/streams/index" },
210
+ items: [
211
+ "reference/streams/stream",
212
+ "reference/streams/pipeline",
213
+ "reference/streams/sink",
214
+ "reference/streams/reader",
215
+ "reference/streams/writer",
216
+ "reference/streams/concurrent-operators",
217
+ "reference/streams/zero-boxing",
218
+ ]
219
+ },
220
+ {
221
+ type: "category",
222
+ label: "SQL",
223
+ link: { type: "doc", id: "reference/sql/index" },
224
+ items: [
225
+ {
226
+ type: "category",
227
+ label: "Core Types",
228
+ collapsed: false,
229
+ items: [
230
+ "reference/sql/db-codec",
231
+ "reference/sql/frag",
232
+ "reference/sql/table",
233
+ "reference/sql/repo",
234
+ "reference/sql/transactor",
235
+ "reference/sql/db-con",
236
+ "reference/sql/db-tx",
237
+ ],
238
+ },
239
+ {
240
+ type: "category",
241
+ label: "Supporting Types",
242
+ collapsed: false,
243
+ items: [
244
+ "reference/sql/db-value",
245
+ "reference/sql/db-param",
246
+ "reference/sql/sql-dialect",
247
+ "reference/sql/sql-logger",
248
+ "reference/sql/sql-name-mapper",
249
+ "reference/sql/table-metadata",
250
+ "reference/sql/ddl",
251
+ "reference/sql/db-connection",
252
+ "reference/sql/db-result-reader",
253
+ "reference/sql/db-param-writer",
254
+ "reference/sql/db-codec-deriver",
255
+ "reference/sql/transactor-zio",
256
+ ],
257
+ },
258
+ ],
259
+ },
260
+ "reference/sql-zio",
261
+ ]
262
+ },
69
263
  {
70
264
  type: "category",
71
265
  label: "Guides",
72
266
  items: [
73
267
  "guides/compile-time-resource-safety-with-scope",
74
- "guides/zio-schema-migration",
75
- "guides/query-dsl-reified-optics",
76
- "guides/query-dsl-sql",
268
+ "guides/getting-started-with-mux",
77
269
  "guides/query-dsl-extending",
78
270
  "guides/query-dsl-fluent-builder",
271
+ "guides/query-dsl-reified-optics",
272
+ "guides/query-dsl-sql",
273
+ "guides/zio-schema-migration",
79
274
  ]
80
275
  }
81
276
  ]