@valbuild/shared 0.148.0 → 0.148.3

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # @valbuild/shared
 
+## 0.148.3
+
+### Patch Changes
+
+- [#881](https://github.com/valbuild/val/pull/881) [`0139436`](https://github.com/valbuild/val/commit/0139436426142d91cbb29ec6c696dfb86f34ab9d) Thanks [@freekh](https://github.com/freekh)! - The content analytics script. With analytics on (it is off by default, and turned on in a hosted project's settings), a TanStack site counts which content each visitor's page **rendered** and which they actually **viewed** (at least half on screen for a second), and sends it to `/api/val/analytics`.
+
+  - No cookies, no storage, no visitor IDs. Each page view also says where it came from (the referring site's host and any `utm_source` / `utm_medium` / `utm_campaign`) and whether it was a phone, tablet or desktop.
+  - A page is sent as its route's pattern (`/posts/$postId`), never its address, so a path that holds something about one visitor (an order number, a token) is never stored. `startValAnalytics` takes this as `routeFor`; `ValProvider` passes TanStack's matched route.
+  - Editors are never counted: nothing is sent in draft mode, in the Studio, with Val enabled, or at a proposal's address, and nothing from automated browsers. A page the browser prerenders counts nothing until it is shown.
+  - The script is the new `@valbuild/react/analytics` entry, loaded only for visitors of a site with analytics on, after the page has hydrated. It imports nothing else from Val.
+  - Storing the counts and showing them is part of Val's hosting, which takes these beacons before they reach the site. Anywhere else, `/api/val/analytics` checks each beacon and stores nothing; in local development, with `VAL_DEBUG=1`, it logs a line per beacon, so you can see it working.
+  - `ValProvider`'s Studio check now matches `/val` and what is below it only, not every route starting with those letters (`/values`). The same fix is in `@valbuild/next`.
+
+- [#896](https://github.com/valbuild/val/pull/896) [`5eff8a0`](https://github.com/valbuild/val/commit/5eff8a055a4ef50d476797c28f9c3e50deb73c89) Thanks [@freekh](https://github.com/freekh)! - A demo's tour can now be written by the site: `<ValApp demo={{ tour }}>`, with each step as data (`ValDemoTourStep`), so what it says changes with the site rather than with a Val release.
+
+  It is drawn as a ring around what a step is about, with nothing dimmed and the Studio usable underneath, and a step can move on by itself once the visitor has done what it asks:
+
+  ```ts
+  const tour: ValDemoTourStep[] = [
+    {
+      id: "click",
+      title: "This is Val",
+      body: "Click the heading on the page.",
+      target: "canvas",
+      page: HEADING, // outlined on the page
+      moveOn: { open: HEADING },
+    },
+    {
+      id: "type",
+      title: "Change a word",
+      body: "The page changes as you type.",
+      field: HEADING, // ringed wherever the field is shown
+      moveOn: {
+        edit: true,
+        path: HEADING,
+        value: "Coffee, roasted this weekend",
+      },
+    },
+  ];
+  ```
+
+  A step that moves on has **Do it for me**, which does it the way the Studio would, and **Skip**. On a phone the card is a sheet along the bottom. The Studio's own tour is unchanged.
+
+## 0.148.2
+
+### Patch Changes
+
+- [#889](https://github.com/valbuild/val/pull/889) [`dc7c8cc`](https://github.com/valbuild/val/commit/dc7c8ccd82f643e662d00225fabec411b5d39e3a) Thanks [@freekh](https://github.com/freekh)! - Val is quieter in your app's console. Errors and warnings you can act on still
+  print, now prefixed with `[val]` so you can filter them. Val's own debug
+  output, which used to reach your terminal and browser console, is now off by
+  default. That includes the `Invalid JWT` line that printed on every request
+  with an expired session cookie, the "verifying draft mode" and polling notices,
+  and the Studio's sync and WebSocket chatter.
+
+  To turn the debug output back on, for example when reporting a bug:
+
+  - on the server, set `VAL_DEBUG=1`
+  - in the browser, run `localStorage.setItem("val:debug", "1")` in the console.
+    It takes effect immediately, with no reload. Remove the key to turn it off
+    again.
+
+- Updated dependencies [[`dc7c8cc`](https://github.com/valbuild/val/commit/dc7c8ccd82f643e662d00225fabec411b5d39e3a)]:
+  - @valbuild/core@0.148.2
+
 ## 0.148.0
 
 ### Patch Changes

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-f6254b32.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-a7f2cc6d.cjs.dev.js');
 require('@valbuild/core');
 
 

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-109be3b8.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-40d76bf8.cjs.prod.js');
 require('@valbuild/core');
 
 

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

@@ -1,2 +1,2 @@
-export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-c70ea145.esm.js';
+export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-cd006a36.esm.js';
 import '@valbuild/core';

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

@@ -45,6 +45,27 @@ type CookieValue = EnableCookieValue | {
  * this. Shared so client and server agree on the limit.
  */
 export declare const JSON_ENTRIES_BATCH_MAX = 100;
+export declare const AnalyticsBeacon: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    route: z.ZodString;
+    cv: z.ZodOptional<z.ZodString>;
+    view: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodOptional<z.ZodString>;
+        utm: z.ZodOptional<z.ZodObject<{
+            source: z.ZodOptional<z.ZodString>;
+            medium: z.ZodOptional<z.ZodString>;
+            campaign: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        device: z.ZodEnum<{
+            phone: "phone";
+            tablet: "tablet";
+            desktop: "desktop";
+        }>;
+    }, z.core.$strip>>;
+    rendered: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    viewed: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AnalyticsBeacon = z.infer<typeof AnalyticsBeacon>;
 export declare const Api: {
     "/draft/enable": {
         GET: {
@@ -98,6 +119,24 @@ export declare const Api: {
             }, z.core.$strip>]>;
         };
     };
+    "/analytics": {
+        POST: {
+            req: {
+                body: z.ZodUnknown;
+            };
+            res: z.ZodUnion<readonly [z.ZodObject<{
+                status: z.ZodLiteral<200>;
+                json: z.ZodObject<{
+                    counted: z.ZodBoolean;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<400>;
+                json: z.ZodObject<{
+                    message: z.ZodString;
+                }, z.core.$strip>;
+            }, z.core.$strip>]>;
+        };
+    };
     "/draft/stat": {
         GET: {
             req: {

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

@@ -23,6 +23,82 @@ export type ValDemoRuntime = {
      * refuses uploads before sending anything, and says why.
      */
     uploads: boolean;
+    /**
+     * The tour the site wrote, in place of the Studio's own demo tour. See
+     * `ValDemoTourStep`. Absent: the Studio's.
+     */
+    tour?: ValDemoTourStep[];
+};
+/**
+ * What the site starts the demo with: `<ValApp demo={{ tour }}>`.
+ *
+ * `demo` alone (`true`) is the same with nothing given.
+ */
+export type ValDemoOptions = {
+    tour?: ValDemoTourStep[];
+};
+/**
+ * A control of the Studio's a step can point at.
+ *
+ * The `data-val-tour` markers the Studio puts on them. One that is not on
+ * screen (the rail on a phone) leaves the card on its own, so a step's words
+ * must work without the arrow: never "this button here".
+ */
+export type ValDemoTourTarget = "canvas" | "pages" | "media" | "data" | "review" | "preview" | "publish" | "ai" | "locale" | "demo" | "utility";
+/** A panel a step opens, so what it is about is on screen behind the card. */
+export type ValDemoTourPanel = "pages" | "media" | "data" | "settings" | "ai";
+/**
+ * What moves a step on by itself. A step without one has Next.
+ *
+ * Each is something the visitor does, because doing it is the lesson, and
+ * each has a "Do it for me" that does it the way the Studio would:
+ *
+ * - `open`: a field at or below this source path is opened -- by clicking it
+ *   on the page, or anywhere else. Do it for me opens it.
+ * - `edit`: a change is made. Do it for me writes `value` at `path`; without
+ *   them, it is offered nowhere and the step waits for the visitor.
+ * - `panel`: that panel is opened. Do it for me opens it.
+ * - `locale`: the language shown is changed. Do it for me picks the next one.
+ */
+export type ValDemoTourMoveOn = {
+    open: string;
+} | {
+    edit: true;
+    path?: string;
+    value?: string;
+} | {
+    panel: ValDemoTourPanel;
+} | {
+    locale: true;
+};
+/**
+ * One stop of the demo's tour, as the site writes it.
+ *
+ * Data rather than components, so the tour can be rewritten -- and tried on
+ * people -- without a Val release: the Studio draws it, the site says what it
+ * says. Written for someone who has never seen Val.
+ */
+export type ValDemoTourStep = {
+    /** Stable, so a test can name a step without matching its words. */
+    id: string;
+    title: string;
+    body: string;
+    /** The control this step is about. */
+    target?: ValDemoTourTarget;
+    /**
+     * A field this step is about, as a source path: ringed wherever the Studio
+     * shows it -- the page's fields, or the module open in the editor. Takes
+     * precedence over `target`, which is what is ringed when the field is not
+     * on screen.
+     */
+    field?: string;
+    /**
+     * A place on the page this step is about, as a source path: the page
+     * outlines it and brings it into view.
+     */
+    page?: string;
+    panel?: ValDemoTourPanel;
+    moveOn?: ValDemoTourMoveOn;
 };
 declare global {
     var __VAL_DEMO__: ValDemoRuntime | undefined;

package/dist/{getSitemapTree-109be3b8.cjs.prod.js → getSitemapTree-40d76bf8.cjs.prod.js}

@@ -388,7 +388,7 @@ function getPageRouterSitemapTree(srcFolder, paths) {
           moduleFilePathS = path.moduleFilePath;
         var moduleFilePath = moduleFilePathS;
         if (!urlPath.startsWith("/")) {
-          console.error("urlPath must start with /: ".concat(urlPath));
+          core.Internal.log.error("urlPath must start with /: ".concat(urlPath));
           return 0; // continue
         }
         var pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);

package/dist/{getSitemapTree-f6254b32.cjs.dev.js → getSitemapTree-a7f2cc6d.cjs.dev.js}

@@ -388,7 +388,7 @@ function getPageRouterSitemapTree(srcFolder, paths) {
           moduleFilePathS = path.moduleFilePath;
         var moduleFilePath = moduleFilePathS;
         if (!urlPath.startsWith("/")) {
-          console.error("urlPath must start with /: ".concat(urlPath));
+          core.Internal.log.error("urlPath must start with /: ".concat(urlPath));
           return 0; // continue
         }
         var pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);

package/dist/{getSitemapTree-c70ea145.esm.js → getSitemapTree-cd006a36.esm.js}

@@ -386,7 +386,7 @@ function getPageRouterSitemapTree(srcFolder, paths) {
           moduleFilePathS = path.moduleFilePath;
         var moduleFilePath = moduleFilePathS;
         if (!urlPath.startsWith("/")) {
-          console.error("urlPath must start with /: ".concat(urlPath));
+          Internal.log.error("urlPath must start with /: ".concat(urlPath));
           return 0; // continue
         }
         var pattern = getPatternFromModuleFilePath(moduleFilePath, srcFolder);

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-f6254b32.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-a7f2cc6d.cjs.dev.js');
 var core = require('@valbuild/core');
 var zod = require('zod');
 var zodValidationError = require('zod-validation-error');
@@ -266,17 +266,17 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
         if (remoteRef) {
           noParamsUrl = decodeURIComponent(remoteRef);
         } else {
-          console.error("Remote image URL does not contain ref: " + url);
+          core.Internal.log.error("Remote image URL does not contain ref: " + url);
         }
       } else if (noParamsUrl.startsWith("/api/val/files/public")) {
         noParamsUrl = noParamsUrl.slice("/api/val/files".length);
       } else {
-        console.error("Patched image URL does not start with /api/val/files: " + url);
+        core.Internal.log.error("Patched image URL does not start with /api/val/files: " + url);
       }
     } else if (core.Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
-      console.error("Unpatched image URL starts with /public: " + url);
+      core.Internal.log.error("Unpatched image URL starts with /public: " + url);
     }
     var tag = {
       tag: "img",
@@ -1782,6 +1782,48 @@ var onlyOneIntQueryParam = onlyOneStringQueryParam.refine(function (arg) {
  * this. Shared so client and server agree on the limit.
  */
 var JSON_ENTRIES_BATCH_MAX = 100;
+
+/**
+ * Content analytics, wire format version 1: the beacon the browser script
+ * (`@valbuild/react/analytics`) sends to `POST /api/val/analytics`. Its
+ * `AnalyticsBeacon` type is written by hand there, because that code is on
+ * every visitor's page and must not load zod; `analytics/beacon.test.ts` in
+ * `@valbuild/react` checks that what it builds parses here.
+ */
+/*
+ * The limits the browser script keeps to (`MAX_*` in
+ * `@valbuild/react/analytics`'s `beacon.ts`, which cannot import this). The
+ * endpoint takes anyone's POST, so it checks what it is sent rather than
+ * trusting the sender; `beacon.test.ts` builds beacons at the limits and
+ * parses them here.
+ */
+var MAX_ANALYTICS_PATHS_PER_BEACON = 200;
+var AnalyticsPaths = zod.z.record(zod.z.string().max(512), zod.z.array(zod.z.string().max(1024)).max(MAX_ANALYTICS_PATHS_PER_BEACON));
+var countAnalyticsPaths = function countAnalyticsPaths(paths) {
+  return Object.values(paths).reduce(function (n, list) {
+    return n + list.length;
+  }, 0);
+};
+var AnalyticsBeacon = zod.z.object({
+  v: zod.z.literal(1),
+  route: zod.z.string().max(512),
+  cv: zod.z.string().max(128).optional(),
+  view: zod.z.object({
+    ref: zod.z.string().max(253).optional(),
+    utm: zod.z.object({
+      source: zod.z.string().max(100).optional(),
+      medium: zod.z.string().max(100).optional(),
+      campaign: zod.z.string().max(100).optional()
+    }).optional(),
+    device: zod.z["enum"](["phone", "tablet", "desktop"])
+  }).optional(),
+  rendered: AnalyticsPaths,
+  viewed: AnalyticsPaths
+}).refine(function (beacon) {
+  return countAnalyticsPaths(beacon.rendered) + countAnalyticsPaths(beacon.viewed) <= MAX_ANALYTICS_PATHS_PER_BEACON;
+}, {
+  message: "At most ".concat(MAX_ANALYTICS_PATHS_PER_BEACON, " paths a beacon")
+});
 var Api = {
   "/draft/enable": {
     GET: {
@@ -1827,6 +1869,27 @@ var Api = {
       })])
     }
   },
+  "/analytics": {
+    POST: {
+      // Parsed by the handler rather than here, so a beacon of a version this
+      // server does not know is ignored instead of refused.
+      req: {
+        body: zod.z.unknown()
+      },
+      res: zod.z.union([
+      // `counted` is false wherever nothing stores the counts -- every
+      // server but the hosted platform's, for now.
+      zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          counted: zod.z["boolean"]()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(400),
+        json: GenericError
+      })])
+    }
+  },
   "/draft/stat": {
     GET: {
       req: {
@@ -3928,7 +3991,7 @@ var createValClient = function createValClient(host, config, options) {
               _context2.n = 2;
               break;
             }
-            console.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
+            core.Internal.log.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
               path: path,
               method: method,
               body: anyReq.body,
@@ -4006,7 +4069,7 @@ var createValClient = function createValClient(host, config, options) {
                         _context.n = 4;
                         break;
                       }
-                      console.error("Server responded with an error", json);
+                      core.Internal.log.error("Server responded with an error", json);
                       message = getErrorMessageFromUnknownJson(json, "Unknown error");
                       return _context.a(2, {
                         status: 500,
@@ -4093,6 +4156,44 @@ function isRetryable(error) {
  * modules. See `docs/plans/demo-mode.md`.
  */
 
+/**
+ * What the site starts the demo with: `<ValApp demo={{ tour }}>`.
+ *
+ * `demo` alone (`true`) is the same with nothing given.
+ */
+
+/**
+ * A control of the Studio's a step can point at.
+ *
+ * The `data-val-tour` markers the Studio puts on them. One that is not on
+ * screen (the rail on a phone) leaves the card on its own, so a step's words
+ * must work without the arrow: never "this button here".
+ */
+
+/** A panel a step opens, so what it is about is on screen behind the card. */
+
+/**
+ * What moves a step on by itself. A step without one has Next.
+ *
+ * Each is something the visitor does, because doing it is the lesson, and
+ * each has a "Do it for me" that does it the way the Studio would:
+ *
+ * - `open`: a field at or below this source path is opened -- by clicking it
+ *   on the page, or anywhere else. Do it for me opens it.
+ * - `edit`: a change is made. Do it for me writes `value` at `path`; without
+ *   them, it is offered nowhere and the step waits for the visitor.
+ * - `panel`: that panel is opened. Do it for me opens it.
+ * - `locale`: the language shown is changed. Do it for me picks the next one.
+ */
+
+/**
+ * One stop of the demo's tour, as the site writes it.
+ *
+ * Data rather than components, so the tour can be rewritten -- and tried on
+ * people -- without a Val release: the Studio draws it, the site says what it
+ * says. Written for someone who has never seen Val.
+ */
+
 /*
  * A global `var` rather than a `Window` member: this package is compiled
  * without the DOM's types, and a `var` in global scope is also a property of
@@ -4631,14 +4732,14 @@ function filterRoutesByPatterns(routes, includePattern, excludePattern) {
     try {
       includeRegex = new RegExp(includePattern.source, includePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+      core.Internal.log.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
     }
   }
   if (excludePattern) {
     try {
       excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+      core.Internal.log.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
     }
   }
   return routes.filter(function (route) {
@@ -8360,7 +8461,7 @@ function schemaTypesOfPath(schema, patchPath) {
       } else {
         var _unreachable = current;
         var unknownType = _unreachable.type;
-        console.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
+        core.Internal.log.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
         return new Set([unknownType]);
       }
     }
@@ -8699,9 +8800,9 @@ var PatchSets = /*#__PURE__*/function () {
       } catch (e) {
         // We might be in this situation if the schema changes, etc etc:
         if (e instanceof Error) {
-          console.error("Could not resolve path while creating patch set", e.message);
+          core.Internal.log.error("Could not resolve path while creating patch set", e.message);
         } else {
-          console.error("Could not resolve path while creating patch set", e);
+          core.Internal.log.error("Could not resolve path while creating patch set", e);
         }
         // "terminate" the entire module file path (i.e. all patches are their own patch set)
         this.insertPath(moduleFilePath, [], patchId, createdAt, author, op.op, [schema.type], op.path);
@@ -8943,6 +9044,7 @@ exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
 exports.withValCanvasParam = getSitemapTree.withValCanvasParam;
 exports.AA_LARGE = AA_LARGE;
 exports.AA_TEXT = AA_TEXT;
+exports.AnalyticsBeacon = AnalyticsBeacon;
 exports.Api = Api;
 exports.BRAND_CONTRAST_PAIRS = BRAND_CONTRAST_PAIRS;
 exports.BinaryFileRef = BinaryFileRef;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-109be3b8.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-40d76bf8.cjs.prod.js');
 var core = require('@valbuild/core');
 var zod = require('zod');
 var zodValidationError = require('zod-validation-error');
@@ -266,17 +266,17 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
         if (remoteRef) {
           noParamsUrl = decodeURIComponent(remoteRef);
         } else {
-          console.error("Remote image URL does not contain ref: " + url);
+          core.Internal.log.error("Remote image URL does not contain ref: " + url);
         }
       } else if (noParamsUrl.startsWith("/api/val/files/public")) {
         noParamsUrl = noParamsUrl.slice("/api/val/files".length);
       } else {
-        console.error("Patched image URL does not start with /api/val/files: " + url);
+        core.Internal.log.error("Patched image URL does not start with /api/val/files: " + url);
       }
     } else if (core.Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
-      console.error("Unpatched image URL starts with /public: " + url);
+      core.Internal.log.error("Unpatched image URL starts with /public: " + url);
     }
     var tag = {
       tag: "img",
@@ -1782,6 +1782,48 @@ var onlyOneIntQueryParam = onlyOneStringQueryParam.refine(function (arg) {
  * this. Shared so client and server agree on the limit.
  */
 var JSON_ENTRIES_BATCH_MAX = 100;
+
+/**
+ * Content analytics, wire format version 1: the beacon the browser script
+ * (`@valbuild/react/analytics`) sends to `POST /api/val/analytics`. Its
+ * `AnalyticsBeacon` type is written by hand there, because that code is on
+ * every visitor's page and must not load zod; `analytics/beacon.test.ts` in
+ * `@valbuild/react` checks that what it builds parses here.
+ */
+/*
+ * The limits the browser script keeps to (`MAX_*` in
+ * `@valbuild/react/analytics`'s `beacon.ts`, which cannot import this). The
+ * endpoint takes anyone's POST, so it checks what it is sent rather than
+ * trusting the sender; `beacon.test.ts` builds beacons at the limits and
+ * parses them here.
+ */
+var MAX_ANALYTICS_PATHS_PER_BEACON = 200;
+var AnalyticsPaths = zod.z.record(zod.z.string().max(512), zod.z.array(zod.z.string().max(1024)).max(MAX_ANALYTICS_PATHS_PER_BEACON));
+var countAnalyticsPaths = function countAnalyticsPaths(paths) {
+  return Object.values(paths).reduce(function (n, list) {
+    return n + list.length;
+  }, 0);
+};
+var AnalyticsBeacon = zod.z.object({
+  v: zod.z.literal(1),
+  route: zod.z.string().max(512),
+  cv: zod.z.string().max(128).optional(),
+  view: zod.z.object({
+    ref: zod.z.string().max(253).optional(),
+    utm: zod.z.object({
+      source: zod.z.string().max(100).optional(),
+      medium: zod.z.string().max(100).optional(),
+      campaign: zod.z.string().max(100).optional()
+    }).optional(),
+    device: zod.z["enum"](["phone", "tablet", "desktop"])
+  }).optional(),
+  rendered: AnalyticsPaths,
+  viewed: AnalyticsPaths
+}).refine(function (beacon) {
+  return countAnalyticsPaths(beacon.rendered) + countAnalyticsPaths(beacon.viewed) <= MAX_ANALYTICS_PATHS_PER_BEACON;
+}, {
+  message: "At most ".concat(MAX_ANALYTICS_PATHS_PER_BEACON, " paths a beacon")
+});
 var Api = {
   "/draft/enable": {
     GET: {
@@ -1827,6 +1869,27 @@ var Api = {
       })])
     }
   },
+  "/analytics": {
+    POST: {
+      // Parsed by the handler rather than here, so a beacon of a version this
+      // server does not know is ignored instead of refused.
+      req: {
+        body: zod.z.unknown()
+      },
+      res: zod.z.union([
+      // `counted` is false wherever nothing stores the counts -- every
+      // server but the hosted platform's, for now.
+      zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          counted: zod.z["boolean"]()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(400),
+        json: GenericError
+      })])
+    }
+  },
   "/draft/stat": {
     GET: {
       req: {
@@ -3928,7 +3991,7 @@ var createValClient = function createValClient(host, config, options) {
               _context2.n = 2;
               break;
             }
-            console.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
+            core.Internal.log.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
               path: path,
               method: method,
               body: anyReq.body,
@@ -4006,7 +4069,7 @@ var createValClient = function createValClient(host, config, options) {
                         _context.n = 4;
                         break;
                       }
-                      console.error("Server responded with an error", json);
+                      core.Internal.log.error("Server responded with an error", json);
                       message = getErrorMessageFromUnknownJson(json, "Unknown error");
                       return _context.a(2, {
                         status: 500,
@@ -4093,6 +4156,44 @@ function isRetryable(error) {
  * modules. See `docs/plans/demo-mode.md`.
  */
 
+/**
+ * What the site starts the demo with: `<ValApp demo={{ tour }}>`.
+ *
+ * `demo` alone (`true`) is the same with nothing given.
+ */
+
+/**
+ * A control of the Studio's a step can point at.
+ *
+ * The `data-val-tour` markers the Studio puts on them. One that is not on
+ * screen (the rail on a phone) leaves the card on its own, so a step's words
+ * must work without the arrow: never "this button here".
+ */
+
+/** A panel a step opens, so what it is about is on screen behind the card. */
+
+/**
+ * What moves a step on by itself. A step without one has Next.
+ *
+ * Each is something the visitor does, because doing it is the lesson, and
+ * each has a "Do it for me" that does it the way the Studio would:
+ *
+ * - `open`: a field at or below this source path is opened -- by clicking it
+ *   on the page, or anywhere else. Do it for me opens it.
+ * - `edit`: a change is made. Do it for me writes `value` at `path`; without
+ *   them, it is offered nowhere and the step waits for the visitor.
+ * - `panel`: that panel is opened. Do it for me opens it.
+ * - `locale`: the language shown is changed. Do it for me picks the next one.
+ */
+
+/**
+ * One stop of the demo's tour, as the site writes it.
+ *
+ * Data rather than components, so the tour can be rewritten -- and tried on
+ * people -- without a Val release: the Studio draws it, the site says what it
+ * says. Written for someone who has never seen Val.
+ */
+
 /*
  * A global `var` rather than a `Window` member: this package is compiled
  * without the DOM's types, and a `var` in global scope is also a property of
@@ -4631,14 +4732,14 @@ function filterRoutesByPatterns(routes, includePattern, excludePattern) {
     try {
       includeRegex = new RegExp(includePattern.source, includePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+      core.Internal.log.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
     }
   }
   if (excludePattern) {
     try {
       excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+      core.Internal.log.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
     }
   }
   return routes.filter(function (route) {
@@ -8360,7 +8461,7 @@ function schemaTypesOfPath(schema, patchPath) {
       } else {
         var _unreachable = current;
         var unknownType = _unreachable.type;
-        console.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
+        core.Internal.log.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
         return new Set([unknownType]);
       }
     }
@@ -8699,9 +8800,9 @@ var PatchSets = /*#__PURE__*/function () {
       } catch (e) {
         // We might be in this situation if the schema changes, etc etc:
         if (e instanceof Error) {
-          console.error("Could not resolve path while creating patch set", e.message);
+          core.Internal.log.error("Could not resolve path while creating patch set", e.message);
         } else {
-          console.error("Could not resolve path while creating patch set", e);
+          core.Internal.log.error("Could not resolve path while creating patch set", e);
         }
         // "terminate" the entire module file path (i.e. all patches are their own patch set)
         this.insertPath(moduleFilePath, [], patchId, createdAt, author, op.op, [schema.type], op.path);
@@ -8943,6 +9044,7 @@ exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
 exports.withValCanvasParam = getSitemapTree.withValCanvasParam;
 exports.AA_LARGE = AA_LARGE;
 exports.AA_TEXT = AA_TEXT;
+exports.AnalyticsBeacon = AnalyticsBeacon;
 exports.Api = Api;
 exports.BRAND_CONTRAST_PAIRS = BRAND_CONTRAST_PAIRS;
 exports.BinaryFileRef = BinaryFileRef;

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

@@ -1,5 +1,5 @@
-import { _ as _createForOfIteratorHelper, q as _objectSpread2, r as _arrayLikeToArray, s as _unsupportedIterableToArray, t as _typeof, u as _defineProperty, v as _toPropertyKey } from '../../dist/getSitemapTree-c70ea145.esm.js';
-export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-c70ea145.esm.js';
+import { _ as _createForOfIteratorHelper, q as _objectSpread2, r as _arrayLikeToArray, s as _unsupportedIterableToArray, t as _typeof, u as _defineProperty, v as _toPropertyKey } from '../../dist/getSitemapTree-cd006a36.esm.js';
+export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-cd006a36.esm.js';
 import { Internal, CODE_LANGUAGES, resolveSettingsModule, missingDeclaredKeys, localeOfValue, discriminatedUnionBranchOf, routePatternOf, matchRoutePattern, DEFAULT_COLOR_FORMAT, declaredKeySetOf } from '@valbuild/core';
 import { z } from 'zod';
 import { fromError } from 'zod-validation-error';
@@ -259,17 +259,17 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
         if (remoteRef) {
           noParamsUrl = decodeURIComponent(remoteRef);
         } else {
-          console.error("Remote image URL does not contain ref: " + url);
+          Internal.log.error("Remote image URL does not contain ref: " + url);
         }
       } else if (noParamsUrl.startsWith("/api/val/files/public")) {
         noParamsUrl = noParamsUrl.slice("/api/val/files".length);
       } else {
-        console.error("Patched image URL does not start with /api/val/files: " + url);
+        Internal.log.error("Patched image URL does not start with /api/val/files: " + url);
       }
     } else if (Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
-      console.error("Unpatched image URL starts with /public: " + url);
+      Internal.log.error("Unpatched image URL starts with /public: " + url);
     }
     var tag = {
       tag: "img",
@@ -1775,6 +1775,48 @@ var onlyOneIntQueryParam = onlyOneStringQueryParam.refine(function (arg) {
  * this. Shared so client and server agree on the limit.
  */
 var JSON_ENTRIES_BATCH_MAX = 100;
+
+/**
+ * Content analytics, wire format version 1: the beacon the browser script
+ * (`@valbuild/react/analytics`) sends to `POST /api/val/analytics`. Its
+ * `AnalyticsBeacon` type is written by hand there, because that code is on
+ * every visitor's page and must not load zod; `analytics/beacon.test.ts` in
+ * `@valbuild/react` checks that what it builds parses here.
+ */
+/*
+ * The limits the browser script keeps to (`MAX_*` in
+ * `@valbuild/react/analytics`'s `beacon.ts`, which cannot import this). The
+ * endpoint takes anyone's POST, so it checks what it is sent rather than
+ * trusting the sender; `beacon.test.ts` builds beacons at the limits and
+ * parses them here.
+ */
+var MAX_ANALYTICS_PATHS_PER_BEACON = 200;
+var AnalyticsPaths = z.record(z.string().max(512), z.array(z.string().max(1024)).max(MAX_ANALYTICS_PATHS_PER_BEACON));
+var countAnalyticsPaths = function countAnalyticsPaths(paths) {
+  return Object.values(paths).reduce(function (n, list) {
+    return n + list.length;
+  }, 0);
+};
+var AnalyticsBeacon = z.object({
+  v: z.literal(1),
+  route: z.string().max(512),
+  cv: z.string().max(128).optional(),
+  view: z.object({
+    ref: z.string().max(253).optional(),
+    utm: z.object({
+      source: z.string().max(100).optional(),
+      medium: z.string().max(100).optional(),
+      campaign: z.string().max(100).optional()
+    }).optional(),
+    device: z["enum"](["phone", "tablet", "desktop"])
+  }).optional(),
+  rendered: AnalyticsPaths,
+  viewed: AnalyticsPaths
+}).refine(function (beacon) {
+  return countAnalyticsPaths(beacon.rendered) + countAnalyticsPaths(beacon.viewed) <= MAX_ANALYTICS_PATHS_PER_BEACON;
+}, {
+  message: "At most ".concat(MAX_ANALYTICS_PATHS_PER_BEACON, " paths a beacon")
+});
 var Api = {
   "/draft/enable": {
     GET: {
@@ -1820,6 +1862,27 @@ var Api = {
       })])
     }
   },
+  "/analytics": {
+    POST: {
+      // Parsed by the handler rather than here, so a beacon of a version this
+      // server does not know is ignored instead of refused.
+      req: {
+        body: z.unknown()
+      },
+      res: z.union([
+      // `counted` is false wherever nothing stores the counts -- every
+      // server but the hosted platform's, for now.
+      z.object({
+        status: z.literal(200),
+        json: z.object({
+          counted: z["boolean"]()
+        })
+      }), z.object({
+        status: z.literal(400),
+        json: GenericError
+      })])
+    }
+  },
   "/draft/stat": {
     GET: {
       req: {
@@ -3921,7 +3984,7 @@ var createValClient = function createValClient(host, config, options) {
               _context2.n = 2;
               break;
             }
-            console.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
+            Internal.log.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
               path: path,
               method: method,
               body: anyReq.body,
@@ -3999,7 +4062,7 @@ var createValClient = function createValClient(host, config, options) {
                         _context.n = 4;
                         break;
                       }
-                      console.error("Server responded with an error", json);
+                      Internal.log.error("Server responded with an error", json);
                       message = getErrorMessageFromUnknownJson(json, "Unknown error");
                       return _context.a(2, {
                         status: 500,
@@ -4086,6 +4149,44 @@ function isRetryable(error) {
  * modules. See `docs/plans/demo-mode.md`.
  */
 
+/**
+ * What the site starts the demo with: `<ValApp demo={{ tour }}>`.
+ *
+ * `demo` alone (`true`) is the same with nothing given.
+ */
+
+/**
+ * A control of the Studio's a step can point at.
+ *
+ * The `data-val-tour` markers the Studio puts on them. One that is not on
+ * screen (the rail on a phone) leaves the card on its own, so a step's words
+ * must work without the arrow: never "this button here".
+ */
+
+/** A panel a step opens, so what it is about is on screen behind the card. */
+
+/**
+ * What moves a step on by itself. A step without one has Next.
+ *
+ * Each is something the visitor does, because doing it is the lesson, and
+ * each has a "Do it for me" that does it the way the Studio would:
+ *
+ * - `open`: a field at or below this source path is opened -- by clicking it
+ *   on the page, or anywhere else. Do it for me opens it.
+ * - `edit`: a change is made. Do it for me writes `value` at `path`; without
+ *   them, it is offered nowhere and the step waits for the visitor.
+ * - `panel`: that panel is opened. Do it for me opens it.
+ * - `locale`: the language shown is changed. Do it for me picks the next one.
+ */
+
+/**
+ * One stop of the demo's tour, as the site writes it.
+ *
+ * Data rather than components, so the tour can be rewritten -- and tried on
+ * people -- without a Val release: the Studio draws it, the site says what it
+ * says. Written for someone who has never seen Val.
+ */
+
 /*
  * A global `var` rather than a `Window` member: this package is compiled
  * without the DOM's types, and a `var` in global scope is also a property of
@@ -4624,14 +4725,14 @@ function filterRoutesByPatterns(routes, includePattern, excludePattern) {
     try {
       includeRegex = new RegExp(includePattern.source, includePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+      Internal.log.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
     }
   }
   if (excludePattern) {
     try {
       excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+      Internal.log.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
     }
   }
   return routes.filter(function (route) {
@@ -8353,7 +8454,7 @@ function schemaTypesOfPath(schema, patchPath) {
       } else {
         var _unreachable = current;
         var unknownType = _unreachable.type;
-        console.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
+        Internal.log.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
         return new Set([unknownType]);
       }
     }
@@ -8692,9 +8793,9 @@ var PatchSets = /*#__PURE__*/function () {
       } catch (e) {
         // We might be in this situation if the schema changes, etc etc:
         if (e instanceof Error) {
-          console.error("Could not resolve path while creating patch set", e.message);
+          Internal.log.error("Could not resolve path while creating patch set", e.message);
         } else {
-          console.error("Could not resolve path while creating patch set", e);
+          Internal.log.error("Could not resolve path while creating patch set", e);
         }
         // "terminate" the entire module file path (i.e. all patches are their own patch set)
         this.insertPath(moduleFilePath, [], patchId, createdAt, author, op.op, [schema.type], op.path);
@@ -8915,4 +9016,4 @@ function schemaErrorsOf(schema, moduleFilePath, source) {
   return errors;
 }
 
-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, PatchId, PatchJSON, PatchSets, PlanRefusalError, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, STUDIO_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, WASM_ENCODED_MIME_TYPES, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, enumLocaleTag, explainIncompatible, fallbackMimeType, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, getValDemo, indexModule, isInsidePatchSetPath, isLocaleSchema, isMimeTypeAccepted, isRemoteSchema, isRepairedOnSave, isSchemaSourceFixError, isSkippedSource, isStudioFix, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, localeMeantBy, 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, schemaErrorsOf, schemaTypesOfPath, selectionClosure, shouldEncodeWithWasm, sideFiles, sideSource, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };
+export { AA_LARGE, AA_TEXT, AnalyticsBeacon, 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, PatchId, PatchJSON, PatchSets, PlanRefusalError, PublishProtocolError, RAMP_STEPS, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, RestoreVerdict, RichTextOptions, SCHEMA_SOURCE_FIXES, STUDIO_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, WASM_ENCODED_MIME_TYPES, accentRamp, buildDuplicatePatch, buildEmptyAtPathPatch, buildFileRefValue, buildImageGalleryPatch, buildRemoveImageGalleryEntryPatch, buildSearchIndex, chainHeadOf, checkCompatibility, chooseEncoded, concatModulePath, contrastRatio, createRegExpFromPattern, createSearchIndex, createValClient, declaredLocales, describeContainerAtPath, emptyOf, enumLocaleTag, explainIncompatible, fallbackMimeType, filterBlockingValidationErrors, filterRoutesByPatterns, findSimilar, fitWithin, flattenRichText, forEachRichTextImage, getErrorMessageFromUnknownJson, getFilenameFromRef, getInlineImgInfo, getKeyOfRecordAt, getRefParts, getRoutesOf, getRoutesWithModulePaths, getSourceAt, getValDemo, indexModule, isInsidePatchSetPath, isLocaleSchema, isMimeTypeAccepted, isRemoteSchema, isRepairedOnSave, isSchemaSourceFixError, isSkippedSource, isStudioFix, joinSharedChanges, keyOfRecordPath, levenshtein, localeAt, localeMeantBy, 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, schemaErrorsOf, schemaTypesOfPath, selectionClosure, shouldEncodeWithWasm, sideFiles, sideSource, sourcePathOfChild, themeCustomProperties, toolNames, traverseSchemaSource, urlOf, validateRoutePatterns, withExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.148.0",
+  "version": "0.148.3",
   "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.148.0"
+    "@valbuild/core": "0.148.2"
   },
   "files": [
     "CHANGELOG.md",