@valbuild/shared 0.129.0 → 0.130.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @valbuild/shared
 
+## 0.130.0
+
+### Patch Changes
+
+- Updated dependencies [[`8425378`](https://github.com/valbuild/val/commit/8425378c315ea46b5d822f1130b633e0449ff1b0), [`473a185`](https://github.com/valbuild/val/commit/473a185f70351b44388f3bc1852649e2c1dbe001), [`64f0de3`](https://github.com/valbuild/val/commit/64f0de339b8621cb5a6c422dfe55cae5b2bbe2a0)]:
+  - @valbuild/core@0.130.0
+
 ## 0.129.0
 
 ### Minor Changes

package/dist/declarations/src/internal/emptyOf.d.ts

@@ -1,4 +1,5 @@
-import { SerializedSchema, Json } from "@valbuild/core";
+import { SerializedSchema } from "@valbuild/core";
+import { JSONValue } from "@valbuild/core/patch";
 /**
  * What `emptyOf` cannot read off a serialized schema.
  *
@@ -22,4 +23,16 @@ export type EmptyOfContext = {
      */
     selectedLocale?: string;
 };
-export declare function emptyOf(schema: SerializedSchema, context?: EmptyOfContext): Json;
+/**
+ * The empty value for a schema — the thing a "create this" affordance writes.
+ *
+ * Returns `JSONValue`, the MUTABLE shape, rather than `Json`. Every value here
+ * is built fresh on the way out — `Object.fromEntries`, a new array, a
+ * primitive — and none of it aliases anything a caller could then mutate out
+ * from under someone. Saying `Json` instead made the type readonly, which is
+ * a claim about sharing that is not true of anything this returns, and left
+ * every caller asserting `as JSONValue` at the point of writing a patch. A
+ * `JSONValue` is still assignable to `Json`, so a reader of the value loses
+ * nothing.
+ */
+export declare function emptyOf(schema: SerializedSchema, context?: EmptyOfContext): JSONValue;

package/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -4610,6 +4610,18 @@ function clampDateTimeString(value, options) {
  * validation then reports, rather than wrong ones.
  */
 
+/**
+ * The empty value for a schema — the thing a "create this" affordance writes.
+ *
+ * Returns `JSONValue`, the MUTABLE shape, rather than `Json`. Every value here
+ * is built fresh on the way out — `Object.fromEntries`, a new array, a
+ * primitive — and none of it aliases anything a caller could then mutate out
+ * from under someone. Saying `Json` instead made the type readonly, which is
+ * a claim about sharing that is not true of anything this returns, and left
+ * every caller asserting `as JSONValue` at the point of writing a patch. A
+ * `JSONValue` is still assignable to `Json`, so a reader of the value loses
+ * nothing.
+ */
 function emptyOf(schema, context) {
   if (schema.type === "object") {
     return Object.fromEntries(Object.keys(schema.items).map(function (key) {

package/internal/dist/valbuild-shared-internal.cjs.prod.js

@@ -4610,6 +4610,18 @@ function clampDateTimeString(value, options) {
  * validation then reports, rather than wrong ones.
  */
 
+/**
+ * The empty value for a schema — the thing a "create this" affordance writes.
+ *
+ * Returns `JSONValue`, the MUTABLE shape, rather than `Json`. Every value here
+ * is built fresh on the way out — `Object.fromEntries`, a new array, a
+ * primitive — and none of it aliases anything a caller could then mutate out
+ * from under someone. Saying `Json` instead made the type readonly, which is
+ * a claim about sharing that is not true of anything this returns, and left
+ * every caller asserting `as JSONValue` at the point of writing a patch. A
+ * `JSONValue` is still assignable to `Json`, so a reader of the value loses
+ * nothing.
+ */
 function emptyOf(schema, context) {
   if (schema.type === "object") {
     return Object.fromEntries(Object.keys(schema.items).map(function (key) {

package/internal/dist/valbuild-shared-internal.esm.js

@@ -4603,6 +4603,18 @@ function clampDateTimeString(value, options) {
  * validation then reports, rather than wrong ones.
  */
 
+/**
+ * The empty value for a schema — the thing a "create this" affordance writes.
+ *
+ * Returns `JSONValue`, the MUTABLE shape, rather than `Json`. Every value here
+ * is built fresh on the way out — `Object.fromEntries`, a new array, a
+ * primitive — and none of it aliases anything a caller could then mutate out
+ * from under someone. Saying `Json` instead made the type readonly, which is
+ * a claim about sharing that is not true of anything this returns, and left
+ * every caller asserting `as JSONValue` at the point of writing a patch. A
+ * `JSONValue` is still assignable to `Json`, so a reader of the value loses
+ * nothing.
+ */
 function emptyOf(schema, context) {
   if (schema.type === "object") {
     return Object.fromEntries(Object.keys(schema.items).map(function (key) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.129.0",
+  "version": "0.130.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
@@ -37,7 +37,7 @@
     "flexsearch": "^0.8.212",
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.129.0"
+    "@valbuild/core": "0.130.0"
   },
   "files": [
     "CHANGELOG.md",