@valbuild/shared 0.144.5 → 0.145.0

package/dist/declarations/src/internal/server/types.d.ts

@@ -1,7 +1,7 @@
 import { Json } from "@valbuild/core";
-export declare const VAL_SESSION_COOKIE: "val_session";
-export declare const VAL_STATE_COOKIE: "val_state";
-export declare const VAL_ENABLE_COOKIE_NAME: "val_enable";
+export declare const VAL_SESSION_COOKIE: any;
+export declare const VAL_STATE_COOKIE: any;
+export declare const VAL_ENABLE_COOKIE_NAME: any;
 export type VAL_SESSION_COOKIE = typeof VAL_SESSION_COOKIE;
 export type VAL_STATE_COOKIE = typeof VAL_STATE_COOKIE;
 export type VAL_ENABLE_COOKIE_NAME = typeof VAL_ENABLE_COOKIE_NAME;

package/dist/declarations/src/internal/zod/History.d.ts

@@ -65,8 +65,8 @@ export declare const BinaryFileRef: z.ZodObject<{
 export type BinaryFileRef = z.infer<typeof BinaryFileRef>;
 export declare const HistoricalModule: z.ZodObject<{
     source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
-    schema: z.ZodNullable<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>;
-    patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+    schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+    patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
     changedPaths: z.ZodArray<z.ZodString>;
     failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"commit-not-found">;
@@ -110,8 +110,8 @@ export declare const HistoricalPatchSet: z.ZodObject<{
     }, z.core.$strip>;
     modules: z.ZodRecord<z.ZodString, z.ZodObject<{
         source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
-        schema: z.ZodNullable<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>;
-        patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+        schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+        patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
         changedPaths: z.ZodArray<z.ZodString>;
         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"commit-not-found">;
@@ -139,7 +139,7 @@ export declare const HistoricalPatchSet: z.ZodObject<{
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>>;
     patches: z.ZodArray<z.ZodObject<{
-        patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
+        patchId: z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>;
         moduleFilePath: z.ZodString;
         patch: z.ZodUnknown;
         authorId: z.ZodNullable<z.ZodString>;

package/dist/declarations/src/internal/zod/Patch.d.ts

@@ -1,5 +1,4 @@
 import type { JSONValue as JSONValueT, PatchJSON as PatchJSONT, PatchBlock as PatchBlockT, ParentRef as ParentRefT } from "@valbuild/core/patch";
-import type { PatchId as PatchIdT } from "@valbuild/core";
 import { z } from "zod";
 /**
  * JSON, recursively — the shape of a Source over the wire.

package/dist/declarations/src/internal/zod/SerializedSchema.d.ts

@@ -83,7 +83,7 @@ export declare const SerializedSettingsSchema: z.ZodType<SerializedSettingsSchem
  */
 export declare const SerializedValViewSchema: z.ZodObject<{
     type: z.ZodLiteral<"view">;
-    moduleFilePath: z.ZodType<import("@valbuild/core").ModuleFilePath, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").ModuleFilePath, unknown>>;
+    moduleFilePath: z.ZodType<ModuleFilePathT, unknown, z.core.$ZodTypeInternals<ModuleFilePathT, unknown>>;
     opt: z.ZodLiteral<false>;
     readonly: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;

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

@@ -1086,8 +1086,8 @@ var _excluded = ["directory"];
 
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
-// Only array, record and keyOf carry one, and `{ as: "inline" }` is all it
-// says. A stale `render` on any other schema is stripped here, harmlessly.
+// Array, record and keyOf carry `{ as: "inline" }`; number carries
+// `{ as: "slider", ... }`. A stale `render` on any other schema is stripped here, harmlessly.
 // NB: these z.objects STRIP unknown keys, so a render variant that is not
 // declared here is silently dropped in transit — add it here when it is added
 // to `render.ts`.
@@ -1095,6 +1095,13 @@ var InlineRender = zod.z.object({
   as: zod.z.literal("inline")
 });
 var FieldRender = InlineRender.optional();
+// The other render, and the only one a leaf takes: `s.number()` / `s.int()`.
+var NumberRender = zod.z.object({
+  as: zod.z.literal("slider"),
+  min: zod.z.number(),
+  max: zod.z.number(),
+  step: zod.z.number().optional()
+}).optional();
 
 /**
  * The fields EVERY serialized schema carries, in one place.
@@ -1154,8 +1161,11 @@ var SerializedNumberSchema = zod.z.object(getSitemapTree._objectSpread2(getSitem
   type: zod.z.literal("number"),
   options: zod.z.object({
     max: zod.z.number().optional(),
-    min: zod.z.number().optional()
+    min: zod.z.number().optional(),
+    integer: zod.z["boolean"]().optional(),
+    step: zod.z.number().optional()
   }).optional(),
+  render: NumberRender,
   opt: zod.z["boolean"]()
 }));
 var SerializedObjectSchema = zod.z.lazy(function () {
@@ -1628,7 +1638,22 @@ var notFoundResponse = zod.z.object({
 var GenericError = zod.z.object({
   message: zod.z.string()
 });
-
+/**
+ * Why Val Build refused a write for the project's plan, as data: the `error` of
+ * its 403 (`refusalError` in valbuild/home's `billing/projectLimits.ts`).
+ *
+ * Every field but `code` is optional and every field is a plain string, so a
+ * newer Val Build that adds a code or a fix still parses: the Studio says an
+ * unknown one with Billing beside it rather than failing to read the answer.
+ */
+var PlanRefusalError = zod.z.object({
+  code: zod.z.string(),
+  fix: zod.z.string().optional(),
+  /** When it lifts by itself, as an ISO time, if it does. */
+  until: zod.z.string().optional(),
+  /** The organization's Billing in Val Build. */
+  billingUrl: zod.z.string().optional()
+});
 /**
  * The header a request to `/admin/proxy` must carry. A cross-site form or
  * `<img>` cannot set a custom header, so without it the proxy cannot be driven
@@ -2156,7 +2181,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: zod.z.string().optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
@@ -2286,7 +2317,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: zod.z.string().optional()
         })])
       })])
     }
@@ -2613,6 +2650,29 @@ var Api = {
             error: GenericError
           })))
         })
+      }),
+      /*
+       * Val Build refused the write for the project's plan: the Free week's
+       * changes are used, or a trial is over. Not the 400 above, because the
+       * patches are fine -- they are kept, and saved once the plan allows.
+       * `message` is Val Build's own sentence and `error` the same as data,
+       * so the Studio can put the fix beside it.
+       *
+       * The patches of the batch BEFORE the refused one were saved (the Free
+       * week can run out mid-batch), so this carries what a 200 does about
+       * them: the client marks those saved and keeps the rest.
+       */
+      zod.z.object({
+        status: zod.z.literal(403),
+        json: zod.z.object({
+          type: zod.z.literal("plan-refused"),
+          message: zod.z.string(),
+          error: PlanRefusalError,
+          newPatchIds: zod.z.array(PatchId),
+          parentRef: ParentRef,
+          patchGroupId: zod.z.string().optional(),
+          headVersion: zod.z.number().optional()
+        })
       }), zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -5557,7 +5617,11 @@ function emptyOf(schema, context) {
   } else if (schema.type === "boolean") {
     return false;
   } else if (schema.type === "number") {
-    return 0;
+    var _Internal$number$near, _schema$options;
+    // 0, unless the schema rules it out: an `s.int().min(1)` starts at 1
+    // rather than as an error. `null` means the schema allows nothing at all,
+    // which validation will say; 0 is as good a start as any for that.
+    return (_Internal$number$near = core.Internal.number.nearestAllowedNumber(0, (_schema$options = schema.options) !== null && _schema$options !== void 0 ? _schema$options : {})) !== null && _Internal$number$near !== void 0 ? _Internal$number$near : 0;
   } else if (schema.type === "keyOf") {
     if (schema.values === "string") {
       return ""; // TODO: figure out this: user code might very well fail in this case
@@ -5599,14 +5663,14 @@ function emptyOf(schema, context) {
   } else if (schema.type === "dateTime") {
     return clampDateTimeString(new Date().toISOString(), schema.options);
   } else if (schema.type === "color") {
-    var _schema$options$forma, _schema$options;
+    var _schema$options$forma, _schema$options2;
     // Mid grey: visible against both a light and a dark canvas
     return core.Internal.color.formatColor({
       r: 128,
       g: 128,
       b: 128,
       a: 1
-    }, (_schema$options$forma = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : core.DEFAULT_COLOR_FORMAT);
+    }, (_schema$options$forma = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : core.DEFAULT_COLOR_FORMAT);
   } else if (schema.type === "code") {
     return ""; // An empty editor: no language has a sensible starting snippet
   } else if (schema.type === "view") {
@@ -8057,6 +8121,7 @@ exports.PatchBlock = PatchBlock;
 exports.PatchGroup = PatchGroup;
 exports.PatchId = PatchId;
 exports.PatchJSON = PatchJSON;
+exports.PlanRefusalError = PlanRefusalError;
 exports.PublishProtocolError = PublishProtocolError;
 exports.RAMP_STEPS = RAMP_STEPS;
 exports.RemirrorBr = RemirrorBr;

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

@@ -1086,8 +1086,8 @@ var _excluded = ["directory"];
 
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
-// Only array, record and keyOf carry one, and `{ as: "inline" }` is all it
-// says. A stale `render` on any other schema is stripped here, harmlessly.
+// Array, record and keyOf carry `{ as: "inline" }`; number carries
+// `{ as: "slider", ... }`. A stale `render` on any other schema is stripped here, harmlessly.
 // NB: these z.objects STRIP unknown keys, so a render variant that is not
 // declared here is silently dropped in transit — add it here when it is added
 // to `render.ts`.
@@ -1095,6 +1095,13 @@ var InlineRender = zod.z.object({
   as: zod.z.literal("inline")
 });
 var FieldRender = InlineRender.optional();
+// The other render, and the only one a leaf takes: `s.number()` / `s.int()`.
+var NumberRender = zod.z.object({
+  as: zod.z.literal("slider"),
+  min: zod.z.number(),
+  max: zod.z.number(),
+  step: zod.z.number().optional()
+}).optional();
 
 /**
  * The fields EVERY serialized schema carries, in one place.
@@ -1154,8 +1161,11 @@ var SerializedNumberSchema = zod.z.object(getSitemapTree._objectSpread2(getSitem
   type: zod.z.literal("number"),
   options: zod.z.object({
     max: zod.z.number().optional(),
-    min: zod.z.number().optional()
+    min: zod.z.number().optional(),
+    integer: zod.z["boolean"]().optional(),
+    step: zod.z.number().optional()
   }).optional(),
+  render: NumberRender,
   opt: zod.z["boolean"]()
 }));
 var SerializedObjectSchema = zod.z.lazy(function () {
@@ -1628,7 +1638,22 @@ var notFoundResponse = zod.z.object({
 var GenericError = zod.z.object({
   message: zod.z.string()
 });
-
+/**
+ * Why Val Build refused a write for the project's plan, as data: the `error` of
+ * its 403 (`refusalError` in valbuild/home's `billing/projectLimits.ts`).
+ *
+ * Every field but `code` is optional and every field is a plain string, so a
+ * newer Val Build that adds a code or a fix still parses: the Studio says an
+ * unknown one with Billing beside it rather than failing to read the answer.
+ */
+var PlanRefusalError = zod.z.object({
+  code: zod.z.string(),
+  fix: zod.z.string().optional(),
+  /** When it lifts by itself, as an ISO time, if it does. */
+  until: zod.z.string().optional(),
+  /** The organization's Billing in Val Build. */
+  billingUrl: zod.z.string().optional()
+});
 /**
  * The header a request to `/admin/proxy` must carry. A cross-site form or
  * `<img>` cannot set a custom header, so without it the proxy cannot be driven
@@ -2156,7 +2181,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: zod.z.string().optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
@@ -2286,7 +2317,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: zod.z.string().optional()
         })])
       })])
     }
@@ -2613,6 +2650,29 @@ var Api = {
             error: GenericError
           })))
         })
+      }),
+      /*
+       * Val Build refused the write for the project's plan: the Free week's
+       * changes are used, or a trial is over. Not the 400 above, because the
+       * patches are fine -- they are kept, and saved once the plan allows.
+       * `message` is Val Build's own sentence and `error` the same as data,
+       * so the Studio can put the fix beside it.
+       *
+       * The patches of the batch BEFORE the refused one were saved (the Free
+       * week can run out mid-batch), so this carries what a 200 does about
+       * them: the client marks those saved and keeps the rest.
+       */
+      zod.z.object({
+        status: zod.z.literal(403),
+        json: zod.z.object({
+          type: zod.z.literal("plan-refused"),
+          message: zod.z.string(),
+          error: PlanRefusalError,
+          newPatchIds: zod.z.array(PatchId),
+          parentRef: ParentRef,
+          patchGroupId: zod.z.string().optional(),
+          headVersion: zod.z.number().optional()
+        })
       }), zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -5557,7 +5617,11 @@ function emptyOf(schema, context) {
   } else if (schema.type === "boolean") {
     return false;
   } else if (schema.type === "number") {
-    return 0;
+    var _Internal$number$near, _schema$options;
+    // 0, unless the schema rules it out: an `s.int().min(1)` starts at 1
+    // rather than as an error. `null` means the schema allows nothing at all,
+    // which validation will say; 0 is as good a start as any for that.
+    return (_Internal$number$near = core.Internal.number.nearestAllowedNumber(0, (_schema$options = schema.options) !== null && _schema$options !== void 0 ? _schema$options : {})) !== null && _Internal$number$near !== void 0 ? _Internal$number$near : 0;
   } else if (schema.type === "keyOf") {
     if (schema.values === "string") {
       return ""; // TODO: figure out this: user code might very well fail in this case
@@ -5599,14 +5663,14 @@ function emptyOf(schema, context) {
   } else if (schema.type === "dateTime") {
     return clampDateTimeString(new Date().toISOString(), schema.options);
   } else if (schema.type === "color") {
-    var _schema$options$forma, _schema$options;
+    var _schema$options$forma, _schema$options2;
     // Mid grey: visible against both a light and a dark canvas
     return core.Internal.color.formatColor({
       r: 128,
       g: 128,
       b: 128,
       a: 1
-    }, (_schema$options$forma = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : core.DEFAULT_COLOR_FORMAT);
+    }, (_schema$options$forma = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : core.DEFAULT_COLOR_FORMAT);
   } else if (schema.type === "code") {
     return ""; // An empty editor: no language has a sensible starting snippet
   } else if (schema.type === "view") {
@@ -8057,6 +8121,7 @@ exports.PatchBlock = PatchBlock;
 exports.PatchGroup = PatchGroup;
 exports.PatchId = PatchId;
 exports.PatchJSON = PatchJSON;
+exports.PlanRefusalError = PlanRefusalError;
 exports.PublishProtocolError = PublishProtocolError;
 exports.RAMP_STEPS = RAMP_STEPS;
 exports.RemirrorBr = RemirrorBr;

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

@@ -1079,8 +1079,8 @@ var _excluded = ["directory"];
 
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
-// Only array, record and keyOf carry one, and `{ as: "inline" }` is all it
-// says. A stale `render` on any other schema is stripped here, harmlessly.
+// Array, record and keyOf carry `{ as: "inline" }`; number carries
+// `{ as: "slider", ... }`. A stale `render` on any other schema is stripped here, harmlessly.
 // NB: these z.objects STRIP unknown keys, so a render variant that is not
 // declared here is silently dropped in transit — add it here when it is added
 // to `render.ts`.
@@ -1088,6 +1088,13 @@ var InlineRender = z.object({
   as: z.literal("inline")
 });
 var FieldRender = InlineRender.optional();
+// The other render, and the only one a leaf takes: `s.number()` / `s.int()`.
+var NumberRender = z.object({
+  as: z.literal("slider"),
+  min: z.number(),
+  max: z.number(),
+  step: z.number().optional()
+}).optional();
 
 /**
  * The fields EVERY serialized schema carries, in one place.
@@ -1147,8 +1154,11 @@ var SerializedNumberSchema = z.object(_objectSpread2(_objectSpread2({}, commonSc
   type: z.literal("number"),
   options: z.object({
     max: z.number().optional(),
-    min: z.number().optional()
+    min: z.number().optional(),
+    integer: z["boolean"]().optional(),
+    step: z.number().optional()
   }).optional(),
+  render: NumberRender,
   opt: z["boolean"]()
 }));
 var SerializedObjectSchema = z.lazy(function () {
@@ -1621,7 +1631,22 @@ var notFoundResponse = z.object({
 var GenericError = z.object({
   message: z.string()
 });
-
+/**
+ * Why Val Build refused a write for the project's plan, as data: the `error` of
+ * its 403 (`refusalError` in valbuild/home's `billing/projectLimits.ts`).
+ *
+ * Every field but `code` is optional and every field is a plain string, so a
+ * newer Val Build that adds a code or a fix still parses: the Studio says an
+ * unknown one with Billing beside it rather than failing to read the answer.
+ */
+var PlanRefusalError = z.object({
+  code: z.string(),
+  fix: z.string().optional(),
+  /** When it lifts by itself, as an ISO time, if it does. */
+  until: z.string().optional(),
+  /** The organization's Billing in Val Build. */
+  billingUrl: z.string().optional()
+});
 /**
  * The header a request to `/admin/proxy` must carry. A cross-site form or
  * `<img>` cannot set a custom header, so without it the proxy cannot be driven
@@ -2149,7 +2174,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: z.string().optional()
         }), z.object({
           type: z.literal("use-websocket"),
           url: z.string(),
@@ -2279,7 +2310,13 @@ var Api = {
            * on the site. What the Studio's switcher says it is in, and
            * where its Save goes (valbuild/home `docs/proposals.md`).
            */
-          proposal: StatProposal.optional()
+          proposal: StatProposal.optional(),
+          /**
+           * The branch History lists: the proposal's in a proposal, else
+           * the git mirror's or the one content reports for the project.
+           * Absent where there is no history to show.
+           */
+          historyBranch: z.string().optional()
         })])
       })])
     }
@@ -2606,6 +2643,29 @@ var Api = {
             error: GenericError
           })))
         })
+      }),
+      /*
+       * Val Build refused the write for the project's plan: the Free week's
+       * changes are used, or a trial is over. Not the 400 above, because the
+       * patches are fine -- they are kept, and saved once the plan allows.
+       * `message` is Val Build's own sentence and `error` the same as data,
+       * so the Studio can put the fix beside it.
+       *
+       * The patches of the batch BEFORE the refused one were saved (the Free
+       * week can run out mid-batch), so this carries what a 200 does about
+       * them: the client marks those saved and keeps the rest.
+       */
+      z.object({
+        status: z.literal(403),
+        json: z.object({
+          type: z.literal("plan-refused"),
+          message: z.string(),
+          error: PlanRefusalError,
+          newPatchIds: z.array(PatchId),
+          parentRef: ParentRef,
+          patchGroupId: z.string().optional(),
+          headVersion: z.number().optional()
+        })
       }), z.object({
         status: z.literal(200),
         json: z.object({
@@ -5550,7 +5610,11 @@ function emptyOf(schema, context) {
   } else if (schema.type === "boolean") {
     return false;
   } else if (schema.type === "number") {
-    return 0;
+    var _Internal$number$near, _schema$options;
+    // 0, unless the schema rules it out: an `s.int().min(1)` starts at 1
+    // rather than as an error. `null` means the schema allows nothing at all,
+    // which validation will say; 0 is as good a start as any for that.
+    return (_Internal$number$near = Internal.number.nearestAllowedNumber(0, (_schema$options = schema.options) !== null && _schema$options !== void 0 ? _schema$options : {})) !== null && _Internal$number$near !== void 0 ? _Internal$number$near : 0;
   } else if (schema.type === "keyOf") {
     if (schema.values === "string") {
       return ""; // TODO: figure out this: user code might very well fail in this case
@@ -5592,14 +5656,14 @@ function emptyOf(schema, context) {
   } else if (schema.type === "dateTime") {
     return clampDateTimeString(new Date().toISOString(), schema.options);
   } else if (schema.type === "color") {
-    var _schema$options$forma, _schema$options;
+    var _schema$options$forma, _schema$options2;
     // Mid grey: visible against both a light and a dark canvas
     return Internal.color.formatColor({
       r: 128,
       g: 128,
       b: 128,
       a: 1
-    }, (_schema$options$forma = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : DEFAULT_COLOR_FORMAT);
+    }, (_schema$options$forma = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.format) !== null && _schema$options$forma !== void 0 ? _schema$options$forma : DEFAULT_COLOR_FORMAT);
   } else if (schema.type === "code") {
     return ""; // An empty editor: no language has a sensible starting snippet
   } else if (schema.type === "view") {
@@ -8004,4 +8068,4 @@ function parse(schema, body, call) {
   return parsed.data;
 }
 
-export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSchemaSourceFixError, isSkippedSource, keyOfRecordPath, levenshtein, localeAt, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };
+export { AA_LARGE, AA_TEXT, Api, BRAND_CONTRAST_PAIRS, BinaryFileRef, CodeOptions, ColorOptions, DEFAULT_ERROR_MESSAGE, DateOptions, ENCODE_DEFAULTS, ENCODE_MIME_TYPE_OF, FileOptions, HistoricalCommit, HistoricalModule, HistoricalPatchSet, HistoryError, ImageEncodeOption, ImageOptions, JSONValue, JSON_ENTRIES_BATCH_MAX, ModuleComparison, NEVER_ENCODED, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchGroup, PatchId, PatchJSON, PlanRefusalError, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, SerializedArraySchema, SerializedBooleanSchema, SerializedCodeSchema, SerializedColorSchema, SerializedDateSchema, SerializedDateTimeSchema, SerializedDiscriminatedUnionSchema, SerializedEnumSchema, SerializedFileSchema, SerializedImageSchema, SerializedKeyOfSchema, SerializedLiteralSchema, SerializedLocaleSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedRecordSchema, SerializedRichTextSchema, SerializedRouteSchema, SerializedSchema, SerializedSettingsSchema, SerializedStringSchema, SerializedValViewSchema, SerializedVideoSchema, SharedValConfig, VAL_ENABLE_COOKIE_NAME, VAL_GREEN_RAMP, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_STUDIO_HEADER, ValCommit, ValDeployment, VideoOptions, VideoStreamOption, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, explainIncompatible, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, indexModule, isMimeTypeAccepted, isRemoteSchema, isSchemaSourceFixError, isSkippedSource, keyOfRecordPath, levenshtein, localeAt, memoizePerRequest, newestCommitSha, parseArtifacts, parseBuildTarget, parseCancel, parseDeclare, parseDiscard, parseJob, parseNewestCiRun, parsePress, parseProblems, parseProjectSource, parsePromote, parsePublishToken, parseRenew, parseRequestStatus, parseStatus, parseUpdateTarget, parseVerify, partitionValidationErrors, performSearch, relativeLuminance, remirrorToRichTextSource, removeModule, resolveEncodeSettings, resolvePairGround, resolveSchemaSourceFixForError, resolveSchemaSourceFixes, resolveSerializedSchemaAtPath, richTextImageSchema, richTextToRemirror, safeParsePatch, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.144.5",
+  "version": "0.145.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.144.0"
+    "@valbuild/core": "0.145.0"
   },
   "files": [
     "CHANGELOG.md",