@valbuild/shared 0.144.9 → 0.145.1

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @valbuild/shared
 
+## 0.145.1
+
+### Patch Changes
+
+- [#860](https://github.com/valbuild/val/pull/860) [`a45f595`](https://github.com/valbuild/val/commit/a45f595a5e20b009d4110bbef8ebdc08b2d731d7) Thanks [@freekh](https://github.com/freekh)! - `val publish` and the Studio now tell Val Build which version of the platform's React and TanStack a build was made against. If the platform is updated while a build is running — a project's CI can take several minutes — that build is no longer published onto a platform it was never checked against: the publish stops with a message saying the platform was updated and to build again, and the next build is checked against what it will run on. A build published with `val publish --artifacts` was made elsewhere and does not say, and publishes as before.
+
+## 0.145.0
+
+### Minor Changes
+
+- [#859](https://github.com/valbuild/val/pull/859) [`f085be0`](https://github.com/valbuild/val/commit/f085be0eb5bdc195e9d8cdb15dd5f8acfdabe23c) Thanks [@freekh](https://github.com/freekh)! - An edit Val Build refuses to save because of the project's plan — the Free plan's 1,000 changes a week are used, or a Hosted trial has ended — is now kept in the Studio instead of being reverted.
+
+  - `PUT /patches` answers such a save with a `403` of type `plan-refused`, carrying Val Build's reason and fix as data and which patches of the request it did save. It used to answer `400 patch-error`, which the Studio reads as a bad patch and drops.
+  - The Studio keeps the refused edits and any made after them, shows the plan notice with **Upgrade** or **Add a card** beside it, and saves them by itself once the plan allows it: as soon as Val Build says editing is open again (an owner added a card, the week moved on), and otherwise by trying again now and then. A publish or a restore that meets held edits says why, in Val Build's words, instead of suggesting the connection.
+  - The MCP write tools answer a refused write as `forbidden`, with Val Build's sentence, instead of `internal`.
+
+### Patch Changes
+
+- [#851](https://github.com/valbuild/val/pull/851) [`b6cb939`](https://github.com/valbuild/val/commit/b6cb9395d8bdcd5182e9c6ba84f5284930de2fa5) Thanks [@freekh](https://github.com/freekh)! - New `s.int()` for whole numbers, `.step()` on `s.int()` and `s.number()`, and a slider for both:
+
+  ```ts
+  s.object({
+    columns: s.int().min(1).max(6),
+    opacity: s
+      .int()
+      .min(0)
+      .max(100)
+      .step(5)
+      .render({ as: "slider", min: 0, max: 100 }),
+    lineHeight: s.number().render({ as: "slider", min: 1, max: 2, step: 0.1 }),
+  });
+  ```
+
+  - `.min()`, `.max()` and `.step()` are rules the validator checks. A step is counted from `min`, or from 0 when there is none.
+  - `.render({ as: "slider", min, max, step? })` is how the field is edited: a slider, with a box beside it for typing an exact value. `min` and `max` are required. The slider's step defaults to the schema's `.step()`, then to 1.
+  - The slider can only produce values the schema accepts. A slider outside `.min()`/`.max()`, with a step that is not a multiple of `.step()`, or with decimals on an `s.int()` throws where the schema is defined.
+  - A value outside the slider's range is still valid content. The field says it is out of the slider's reach and offers "Set to" the nearest stop. A value that breaks a rule offers "Round to" the nearest allowed value.
+  - Fixed: `.min(0)` and `.max(0)` on `s.number()` were ignored.
+  - A new item of a number schema starts at the nearest allowed value instead of `0`, so `s.int().min(1)` starts at 1.
+
+- Updated dependencies [[`b6cb939`](https://github.com/valbuild/val/commit/b6cb9395d8bdcd5182e9c6ba84f5284930de2fa5)]:
+  - @valbuild/core@0.145.0
+
 ## 0.144.9
 
 ### Patch Changes

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

@@ -1,6 +1,21 @@
 import { z } from "zod";
 import { type ModuleFilePath } from "@valbuild/core";
 declare const ModuleFilePath: z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, 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.
+ */
+export declare const PlanRefusalError: z.ZodObject<{
+    code: z.ZodString;
+    fix: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    billingUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PlanRefusalErrorT = z.infer<typeof PlanRefusalError>;
 /**
  * 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
@@ -818,6 +833,28 @@ export declare const Api: {
                         }, z.core.$strip>;
                     }, z.core.$strip>>>;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<403>;
+                json: z.ZodObject<{
+                    type: z.ZodLiteral<"plan-refused">;
+                    message: z.ZodString;
+                    error: z.ZodObject<{
+                        code: z.ZodString;
+                        fix: z.ZodOptional<z.ZodString>;
+                        until: z.ZodOptional<z.ZodString>;
+                        billingUrl: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>;
+                    newPatchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+                    parentRef: z.ZodUnion<readonly [z.ZodObject<{
+                        type: z.ZodLiteral<"head">;
+                        headBaseSha: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"patch">;
+                        patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
+                    }, z.core.$strip>]>;
+                    patchGroupId: z.ZodOptional<z.ZodString>;
+                    headVersion: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 status: z.ZodLiteral<200>;
                 json: z.ZodObject<{
@@ -1057,7 +1094,7 @@ export declare const Api: {
                 status: z.ZodLiteral<200>;
                 json: z.ZodObject<{
                     schemaSha: z.ZodString;
-                    schemas: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+                    schemas: z.ZodRecord<z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>;
                 }, z.core.$strip>;
             }, z.core.$strip>]>;
         };
@@ -1489,7 +1526,7 @@ export declare const Api: {
                     }, 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<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, 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>>>;
                         changedPaths: z.ZodArray<z.ZodString>;
                         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1609,7 +1646,7 @@ export declare const Api: {
                     moduleFilePath: z.ZodString;
                     module: z.ZodNullable<z.ZodObject<{
                         source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
-                        schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, 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>>>;
                         changedPaths: z.ZodArray<z.ZodString>;
                         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/declarations/src/internal/publish/contentApi.d.ts

@@ -50,9 +50,11 @@ export type ContentPublishApi = {
      *
      * ## What is deliberately not here
      *
-     * No loader URL, no `vendorRev`, no `x-platform-project`. This service holds
-     * the operator relationship with the build platform and calls it; a publisher
-     * talks to this API and nothing else. The one exception is the presigned
+     * No loader URL, no `x-platform-project`. This service holds the operator
+     * relationship with the build platform and calls it; a publisher talks to
+     * this API and nothing else. A publisher does say which base layer it built
+     * against (`baseRev` below) -- a fact about its build, which this service
+     * forwards -- but never addresses the platform itself. The one exception is the presigned
      * upload URL, which points at object storage -- bytes do not travel through
      * here.
      *
@@ -73,6 +75,18 @@ export type ContentPublishApi = {
                 branch: string | null;
                 /** Which dependency layer this was built against, sent or not. */
                 layerRev: string | null;
+                /**
+                 * Which BASE layer -- the platform's React and TanStack -- this was
+                 * built against: `base.rev` of the build target the build used.
+                 *
+                 * Content forwards it to the build platform as the build's own, and
+                 * the platform refuses a new build whose base layer it no longer
+                 * serves: one deployed while the build ran, which the build's layer
+                 * was never checked against. Left out when it is not known -- a build
+                 * made elsewhere and published with `--artifacts` -- which publishes
+                 * as every build did before.
+                 */
+                baseRev?: string | null;
                 /**
                  * Whether the app links its own CSS.
                  *

package/dist/declarations/src/internal/publish/protocol.d.ts

@@ -88,6 +88,11 @@ declare const buildTargetResponse: z.ZodObject<{
             flightServer: z.ZodString;
             serverFnBase: z.ZodString;
         }, z.core.$strip>;
+        pins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        exports: z.ZodOptional<z.ZodObject<{
+            worker: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+            browser: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     project: z.ZodObject<{
         rev: z.ZodNullable<z.ZodString>;
@@ -177,6 +182,11 @@ declare const updateTargetResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 flightServer: z.ZodString;
                 serverFnBase: z.ZodString;
             }, z.core.$strip>;
+            pins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            exports: z.ZodOptional<z.ZodObject<{
+                worker: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+                browser: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         project: z.ZodObject<{
             rev: z.ZodNullable<z.ZodString>;

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

@@ -65,7 +65,7 @@ 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<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, 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>>>;
     changedPaths: z.ZodArray<z.ZodString>;
     failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -110,7 +110,7 @@ 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<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, 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>>>;
         changedPaths: z.ZodArray<z.ZodString>;
         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{

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
@@ -2625,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({
@@ -5569,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
@@ -5611,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") {
@@ -7809,7 +7861,20 @@ var buildTargetResponse = zod.z.object({
       rscRuntimePath: zod.z.string(),
       flightServer: zod.z.string(),
       serverFnBase: zod.z.string()
-    })
+    }),
+    /*
+     * What the base layer is built from and what its chunks export, which
+     * `val publish` checks a project's layer against (`BuildTarget.base` in
+     * @valbuild/tanstack-build). Declared, because `z.object` DROPS a key it
+     * does not name: left out, they never reached the build, and every
+     * publish skipped both checks while saying the platform had not sent them.
+     * Optional, for a platform that predates them.
+     */
+    pins: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+    exports: zod.z.object({
+      worker: zod.z.record(zod.z.string(), zod.z.array(zod.z.string())),
+      browser: zod.z.record(zod.z.string(), zod.z.array(zod.z.string()))
+    }).optional()
   }),
   project: zod.z.object({
     rev: zod.z.string().nullable(),
@@ -8069,6 +8134,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
@@ -2625,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({
@@ -5569,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
@@ -5611,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") {
@@ -7809,7 +7861,20 @@ var buildTargetResponse = zod.z.object({
       rscRuntimePath: zod.z.string(),
       flightServer: zod.z.string(),
       serverFnBase: zod.z.string()
-    })
+    }),
+    /*
+     * What the base layer is built from and what its chunks export, which
+     * `val publish` checks a project's layer against (`BuildTarget.base` in
+     * @valbuild/tanstack-build). Declared, because `z.object` DROPS a key it
+     * does not name: left out, they never reached the build, and every
+     * publish skipped both checks while saying the platform had not sent them.
+     * Optional, for a platform that predates them.
+     */
+    pins: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+    exports: zod.z.object({
+      worker: zod.z.record(zod.z.string(), zod.z.array(zod.z.string())),
+      browser: zod.z.record(zod.z.string(), zod.z.array(zod.z.string()))
+    }).optional()
   }),
   project: zod.z.object({
     rev: zod.z.string().nullable(),
@@ -8069,6 +8134,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
@@ -2618,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({
@@ -5562,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
@@ -5604,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") {
@@ -7802,7 +7854,20 @@ var buildTargetResponse = z.object({
       rscRuntimePath: z.string(),
       flightServer: z.string(),
       serverFnBase: z.string()
-    })
+    }),
+    /*
+     * What the base layer is built from and what its chunks export, which
+     * `val publish` checks a project's layer against (`BuildTarget.base` in
+     * @valbuild/tanstack-build). Declared, because `z.object` DROPS a key it
+     * does not name: left out, they never reached the build, and every
+     * publish skipped both checks while saying the platform had not sent them.
+     * Optional, for a platform that predates them.
+     */
+    pins: z.record(z.string(), z.string()).optional(),
+    exports: z.object({
+      worker: z.record(z.string(), z.array(z.string())),
+      browser: z.record(z.string(), z.array(z.string()))
+    }).optional()
   }),
   project: z.object({
     rev: z.string().nullable(),
@@ -8016,4 +8081,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.9",
+  "version": "0.145.1",
   "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",