@valbuild/core 0.148.0 → 0.148.7

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @valbuild/core
 
+## 0.148.7
+
+### Patch Changes
+
+- [#906](https://github.com/valbuild/val/pull/906) [`fb2eed8`](https://github.com/valbuild/val/commit/fb2eed8b51092cc2ad5c812bdf88b528913c824a) Thanks [@freekh](https://github.com/freekh)! - `val.attrs(post, "author")` tags an element with one field of what it shows. Use it for a value Val never encodes, like an `s.keyOf` key, a date or a colour. A byline that shows the author a post points at can carry the post's `author` field, so clicking it in the Studio opens the choice of author.
+
+  On a phone, a tour step about Pages, Media, Data or Settings points at the menu button, which is where they are when the rail is not drawn.
+
+## 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.
+
 ## 0.148.0
 
 ### Patch Changes

package/dist/declarations/src/index.d.ts

@@ -35,7 +35,7 @@ import { getSource, isValModule, splitModulePath, splitModuleFilePath, resolvePa
 declare const ModuleFilePathSep = "?p=";
 export { ModuleFilePathSep };
 import { SelectorSource, getSchema } from "./selector/index.js";
-import { ModulePath, SourcePath, getValPath, isVal } from "./val/index.js";
+import { ModulePath, SourcePath, getValPath, isVal, setValPath } from "./val/index.js";
 import { createValPathOfItem } from "./selector/SelectorProxy.js";
 import { Operation } from "./patch/index.js";
 import { initSchema } from "./initSchema.js";
@@ -105,6 +105,7 @@ export { getSourcePathFromRoute, isPageRouter, routePatternOf, } from "./getSour
 export { describeSchemeRejection, isCheckableScheme, rejectScheme, schemeOf, UNSAFE_URL_SCHEMES, } from "./externalUrlSchemes.js";
 export type { ExternalUrlSchemePolicy, SchemeRejection, } from "./externalUrlSchemes.js";
 import { describeSchemeRejection, isCheckableScheme, rejectScheme, schemeOf } from "./externalUrlSchemes.js";
+import { isDebugEnabled } from "./log.js";
 export declare const FATAL_ERROR_TYPES: readonly ["no-schema", "no-source", "invalid-id", "no-module", "invalid-patch"];
 export type FatalErrorType = (typeof FATAL_ERROR_TYPES)[number];
 export declare const DEFAULT_CONTENT_HOST = "https://content.val.build";
@@ -138,6 +139,15 @@ export declare const DEFAULT_APP_HOST = "https://admin.val.build";
  */
 export declare const DEFAULT_STATIC_HOST = "https://content.val.build/v1/static";
 declare const Internal: {
+    /** Val's console output. See `log.ts` for which levels print, and when. */
+    log: {
+        error(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+        info(...args: unknown[]): void;
+        debug(...args: unknown[]): void;
+    };
+    isDebugEnabled: typeof isDebugEnabled;
+    VAL_DEBUG_STORAGE_KEY: string;
     VERSION: {
         core: string;
     };
@@ -163,6 +173,7 @@ declare const Internal: {
     };
     getSchema: typeof getSchema;
     getValPath: typeof getValPath;
+    setValPath: typeof setValPath;
     getSource: typeof getSource;
     isValModule: typeof isValModule;
     resolvePath: typeof resolvePath;

package/dist/declarations/src/log.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Val's console output, and the one place that decides what reaches it.
+ *
+ * Val runs inside someone else's app: the server in their dev server and their
+ * production logs, the Studio in their browser tab. Everything Val prints lands
+ * in a console that belongs to a developer who did not write the code printing
+ * it, so the levels are split by who the line is FOR:
+ *
+ * - `error` and `warn` are for that developer -- something broke, or something
+ *   they can fix -- and always print.
+ * - `info` and `debug` are for whoever is debugging Val, and print only when
+ *   asked for: `VAL_DEBUG=1` in the environment of a server, or
+ *   `localStorage.setItem("val:debug", "1")` in a browser. Both are read on
+ *   every call, so turning it on in a live tab needs no reload.
+ *
+ * In Node `console.debug` IS `console.log`, so a bare `console.debug` is not
+ * quiet on a server: it went to the developer's terminal on every request.
+ * That is why `no-console` is on for the packages that run in a host app, and
+ * this file is the exemption.
+ *
+ * Every line gets a `[val]` prefix, so a developer can filter Val out (or in).
+ * Arguments are otherwise passed through as they are, so an `Error` still
+ * prints with its stack.
+ */
+/** The localStorage key that turns `debug` and `info` on in a browser. */
+export declare const VAL_DEBUG_STORAGE_KEY = "val:debug";
+export declare function isDebugEnabled(): boolean;
+export declare const log: {
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+};

package/dist/declarations/src/val/index.d.ts

@@ -60,4 +60,13 @@ export type ParentPatchId = string & {
     [brand]: "ParentPatchId";
 };
 export declare function getValPath(valOrSelector: Val<Json> | Selector<Source>): SourcePath | undefined;
+/**
+ * Gives an object Val read the path it was read from, where `getValPath`
+ * finds it: the readers' (`stegaEncode`'s) half of `getValPath`, for objects,
+ * which have no text to carry a path in.
+ *
+ * Not enumerable, and a symbol: `Object.keys`, `JSON.stringify` and every walk
+ * that reads content as data still see only the content.
+ */
+export declare function setValPath(target: object, path: SourcePath): void;
 export {};

package/dist/{index-09bd1d7d.esm.js → index-52c01907.esm.js}

@@ -914,6 +914,22 @@ function getValPath(valOrSelector) {
   return valOrSelector[Path];
 }
 
+/**
+ * Gives an object Val read the path it was read from, where `getValPath`
+ * finds it: the readers' (`stegaEncode`'s) half of `getValPath`, for objects,
+ * which have no text to carry a path in.
+ *
+ * Not enumerable, and a symbol: `Object.keys`, `JSON.stringify` and every walk
+ * that reads content as data still see only the content.
+ */
+function setValPath(target, path) {
+  Object.defineProperty(target, Path, {
+    value: path,
+    enumerable: false,
+    configurable: true
+  });
+}
+
 function createValPathOfItem(
 /**
  * `ModuleFilePath` is accepted because the no-separator branch below is
@@ -2762,6 +2778,122 @@ var discriminatedUnion = function discriminatedUnion(key) {
   return new DiscriminatedUnionSchema(key, objects);
 };
 
+function _toArray(r) {
+  return _arrayWithHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableRest();
+}
+
+/**
+ * Val's console output, and the one place that decides what reaches it.
+ *
+ * Val runs inside someone else's app: the server in their dev server and their
+ * production logs, the Studio in their browser tab. Everything Val prints lands
+ * in a console that belongs to a developer who did not write the code printing
+ * it, so the levels are split by who the line is FOR:
+ *
+ * - `error` and `warn` are for that developer -- something broke, or something
+ *   they can fix -- and always print.
+ * - `info` and `debug` are for whoever is debugging Val, and print only when
+ *   asked for: `VAL_DEBUG=1` in the environment of a server, or
+ *   `localStorage.setItem("val:debug", "1")` in a browser. Both are read on
+ *   every call, so turning it on in a live tab needs no reload.
+ *
+ * In Node `console.debug` IS `console.log`, so a bare `console.debug` is not
+ * quiet on a server: it went to the developer's terminal on every request.
+ * That is why `no-console` is on for the packages that run in a host app, and
+ * this file is the exemption.
+ *
+ * Every line gets a `[val]` prefix, so a developer can filter Val out (or in).
+ * Arguments are otherwise passed through as they are, so an `Error` still
+ * prints with its stack.
+ */
+
+var PREFIX = "[val]";
+
+/** The localStorage key that turns `debug` and `info` on in a browser. */
+var VAL_DEBUG_STORAGE_KEY = "val:debug";
+function isOn(value) {
+  return value !== undefined && value !== null && value !== "" && value !== "0" && value !== "false";
+}
+function fromEnv() {
+  var _process$env;
+  // `typeof` first: a browser bundle may have no `process` at all.
+  if (typeof process === "undefined") {
+    return undefined;
+  }
+  return (_process$env = process.env) === null || _process$env === void 0 ? void 0 : _process$env.VAL_DEBUG;
+}
+function fromLocalStorage() {
+  // Not in Node, even where it has a `localStorage`: from Node 25 merely
+  // touching it without `--localstorage-file` prints a warning of its own.
+  if (!("window" in globalThis)) {
+    return undefined;
+  }
+  try {
+    var storage = Reflect.get(globalThis, "localStorage");
+    if (_typeof(storage) === "object" && storage !== null && "getItem" in storage && typeof storage.getItem === "function") {
+      var value = storage.getItem(VAL_DEBUG_STORAGE_KEY);
+      return typeof value === "string" ? value : null;
+    }
+  } catch (_unused) {
+    // A sandboxed frame or blocked site data throws on access.
+  }
+  return undefined;
+}
+function isDebugEnabled() {
+  return isOn(fromEnv()) || isOn(fromLocalStorage());
+}
+function withPrefix(args) {
+  var _args = _toArray(args),
+    first = _args[0],
+    rest = _arrayLikeToArray(_args).slice(1);
+  if (typeof first === "string") {
+    if (/^\[val\]/i.test(first)) {
+      return args;
+    }
+    return ["".concat(PREFIX, " ").concat(first)].concat(_toConsumableArray(rest));
+  }
+  return [PREFIX].concat(_toConsumableArray(args));
+}
+
+/*
+ * `console` is looked up on every call rather than captured, so a test that
+ * spies on `console.warn` after this module loaded still sees the call.
+ */
+var log = {
+  error: function error() {
+    var _console;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    (_console = console).error.apply(_console, _toConsumableArray(withPrefix(args)));
+  },
+  warn: function warn() {
+    var _console2;
+    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+      args[_key2] = arguments[_key2];
+    }
+    (_console2 = console).warn.apply(_console2, _toConsumableArray(withPrefix(args)));
+  },
+  info: function info() {
+    if (isDebugEnabled()) {
+      var _console3;
+      for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+        args[_key3] = arguments[_key3];
+      }
+      (_console3 = console).info.apply(_console3, _toConsumableArray(withPrefix(args)));
+    }
+  },
+  debug: function debug() {
+    if (isDebugEnabled()) {
+      var _console4;
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      (_console4 = console).debug.apply(_console4, _toConsumableArray(withPrefix(args)));
+    }
+  }
+};
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -5040,7 +5172,7 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
                       return hrefSchema["executeValidate"](hrefPath, node.href);
                     } else {
                       var exhaustiveCheck = hrefSchema;
-                      console.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
+                      log.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
                       return false;
                     }
                   };
@@ -15291,7 +15423,7 @@ function collectObjectRecursive(item, collector) {
     }
     return;
   } else {
-    console.warn("Unknown type encountered when hashing object", _typeof(item), item);
+    log.warn("Unknown type encountered when hashing object", _typeof(item), item);
   }
 }
 
@@ -16803,7 +16935,7 @@ function isInlineRender(container) {
 
 var corePackageJson = {
 	name: "@valbuild/core",
-	version: "0.148.0",
+	version: "0.148.7",
 	"private": false,
 	description: "Val - supercharged hard-coded content",
 	repository: {
@@ -16890,6 +17022,10 @@ var DEFAULT_APP_HOST = "https://admin.val.build";
  */
 var DEFAULT_STATIC_HOST = "https://content.val.build/v1/static";
 var Internal = {
+  /** Val's console output. See `log.ts` for which levels print, and when. */
+  log: log,
+  isDebugEnabled: isDebugEnabled,
+  VAL_DEBUG_STORAGE_KEY: VAL_DEBUG_STORAGE_KEY,
   VERSION: {
     core: corePackageJson.version
   },
@@ -16918,6 +17054,7 @@ var Internal = {
   },
   getSchema: getSchema,
   getValPath: getValPath,
+  setValPath: setValPath,
   getSource: getSource,
   isValModule: isValModule,
   resolvePath: resolvePath,

package/dist/{index-b0fa804a.cjs.dev.js → index-66258256.cjs.dev.js}

@@ -916,6 +916,22 @@ function getValPath(valOrSelector) {
   return valOrSelector[Path];
 }
 
+/**
+ * Gives an object Val read the path it was read from, where `getValPath`
+ * finds it: the readers' (`stegaEncode`'s) half of `getValPath`, for objects,
+ * which have no text to carry a path in.
+ *
+ * Not enumerable, and a symbol: `Object.keys`, `JSON.stringify` and every walk
+ * that reads content as data still see only the content.
+ */
+function setValPath(target, path) {
+  Object.defineProperty(target, Path, {
+    value: path,
+    enumerable: false,
+    configurable: true
+  });
+}
+
 function createValPathOfItem(
 /**
  * `ModuleFilePath` is accepted because the no-separator branch below is
@@ -2764,6 +2780,122 @@ var discriminatedUnion = function discriminatedUnion(key) {
   return new DiscriminatedUnionSchema(key, objects);
 };
 
+function _toArray(r) {
+  return _arrayWithHoles(r) || _iterableToArray(r) || result._unsupportedIterableToArray(r) || _nonIterableRest();
+}
+
+/**
+ * Val's console output, and the one place that decides what reaches it.
+ *
+ * Val runs inside someone else's app: the server in their dev server and their
+ * production logs, the Studio in their browser tab. Everything Val prints lands
+ * in a console that belongs to a developer who did not write the code printing
+ * it, so the levels are split by who the line is FOR:
+ *
+ * - `error` and `warn` are for that developer -- something broke, or something
+ *   they can fix -- and always print.
+ * - `info` and `debug` are for whoever is debugging Val, and print only when
+ *   asked for: `VAL_DEBUG=1` in the environment of a server, or
+ *   `localStorage.setItem("val:debug", "1")` in a browser. Both are read on
+ *   every call, so turning it on in a live tab needs no reload.
+ *
+ * In Node `console.debug` IS `console.log`, so a bare `console.debug` is not
+ * quiet on a server: it went to the developer's terminal on every request.
+ * That is why `no-console` is on for the packages that run in a host app, and
+ * this file is the exemption.
+ *
+ * Every line gets a `[val]` prefix, so a developer can filter Val out (or in).
+ * Arguments are otherwise passed through as they are, so an `Error` still
+ * prints with its stack.
+ */
+
+var PREFIX = "[val]";
+
+/** The localStorage key that turns `debug` and `info` on in a browser. */
+var VAL_DEBUG_STORAGE_KEY = "val:debug";
+function isOn(value) {
+  return value !== undefined && value !== null && value !== "" && value !== "0" && value !== "false";
+}
+function fromEnv() {
+  var _process$env;
+  // `typeof` first: a browser bundle may have no `process` at all.
+  if (typeof process === "undefined") {
+    return undefined;
+  }
+  return (_process$env = process.env) === null || _process$env === void 0 ? void 0 : _process$env.VAL_DEBUG;
+}
+function fromLocalStorage() {
+  // Not in Node, even where it has a `localStorage`: from Node 25 merely
+  // touching it without `--localstorage-file` prints a warning of its own.
+  if (!("window" in globalThis)) {
+    return undefined;
+  }
+  try {
+    var storage = Reflect.get(globalThis, "localStorage");
+    if (_typeof(storage) === "object" && storage !== null && "getItem" in storage && typeof storage.getItem === "function") {
+      var value = storage.getItem(VAL_DEBUG_STORAGE_KEY);
+      return typeof value === "string" ? value : null;
+    }
+  } catch (_unused) {
+    // A sandboxed frame or blocked site data throws on access.
+  }
+  return undefined;
+}
+function isDebugEnabled() {
+  return isOn(fromEnv()) || isOn(fromLocalStorage());
+}
+function withPrefix(args) {
+  var _args = _toArray(args),
+    first = _args[0],
+    rest = result._arrayLikeToArray(_args).slice(1);
+  if (typeof first === "string") {
+    if (/^\[val\]/i.test(first)) {
+      return args;
+    }
+    return ["".concat(PREFIX, " ").concat(first)].concat(_toConsumableArray(rest));
+  }
+  return [PREFIX].concat(_toConsumableArray(args));
+}
+
+/*
+ * `console` is looked up on every call rather than captured, so a test that
+ * spies on `console.warn` after this module loaded still sees the call.
+ */
+var log = {
+  error: function error() {
+    var _console;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    (_console = console).error.apply(_console, _toConsumableArray(withPrefix(args)));
+  },
+  warn: function warn() {
+    var _console2;
+    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+      args[_key2] = arguments[_key2];
+    }
+    (_console2 = console).warn.apply(_console2, _toConsumableArray(withPrefix(args)));
+  },
+  info: function info() {
+    if (isDebugEnabled()) {
+      var _console3;
+      for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+        args[_key3] = arguments[_key3];
+      }
+      (_console3 = console).info.apply(_console3, _toConsumableArray(withPrefix(args)));
+    }
+  },
+  debug: function debug() {
+    if (isDebugEnabled()) {
+      var _console4;
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      (_console4 = console).debug.apply(_console4, _toConsumableArray(withPrefix(args)));
+    }
+  }
+};
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -5042,7 +5174,7 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
                       return hrefSchema["executeValidate"](hrefPath, node.href);
                     } else {
                       var exhaustiveCheck = hrefSchema;
-                      console.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
+                      log.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
                       return false;
                     }
                   };
@@ -15293,7 +15425,7 @@ function collectObjectRecursive(item, collector) {
     }
     return;
   } else {
-    console.warn("Unknown type encountered when hashing object", _typeof(item), item);
+    log.warn("Unknown type encountered when hashing object", _typeof(item), item);
   }
 }
 
@@ -16805,7 +16937,7 @@ function isInlineRender(container) {
 
 var corePackageJson = {
 	name: "@valbuild/core",
-	version: "0.148.0",
+	version: "0.148.7",
 	"private": false,
 	description: "Val - supercharged hard-coded content",
 	repository: {
@@ -16892,6 +17024,10 @@ var DEFAULT_APP_HOST = "https://admin.val.build";
  */
 var DEFAULT_STATIC_HOST = "https://content.val.build/v1/static";
 var Internal = {
+  /** Val's console output. See `log.ts` for which levels print, and when. */
+  log: log,
+  isDebugEnabled: isDebugEnabled,
+  VAL_DEBUG_STORAGE_KEY: VAL_DEBUG_STORAGE_KEY,
   VERSION: {
     core: corePackageJson.version
   },
@@ -16920,6 +17056,7 @@ var Internal = {
   },
   getSchema: getSchema,
   getValPath: getValPath,
+  setValPath: setValPath,
   getSource: getSource,
   isValModule: isValModule,
   resolvePath: resolvePath,

package/dist/{index-ad3488f6.cjs.prod.js → index-dfea75c9.cjs.prod.js}

@@ -916,6 +916,22 @@ function getValPath(valOrSelector) {
   return valOrSelector[Path];
 }
 
+/**
+ * Gives an object Val read the path it was read from, where `getValPath`
+ * finds it: the readers' (`stegaEncode`'s) half of `getValPath`, for objects,
+ * which have no text to carry a path in.
+ *
+ * Not enumerable, and a symbol: `Object.keys`, `JSON.stringify` and every walk
+ * that reads content as data still see only the content.
+ */
+function setValPath(target, path) {
+  Object.defineProperty(target, Path, {
+    value: path,
+    enumerable: false,
+    configurable: true
+  });
+}
+
 function createValPathOfItem(
 /**
  * `ModuleFilePath` is accepted because the no-separator branch below is
@@ -2764,6 +2780,122 @@ var discriminatedUnion = function discriminatedUnion(key) {
   return new DiscriminatedUnionSchema(key, objects);
 };
 
+function _toArray(r) {
+  return _arrayWithHoles(r) || _iterableToArray(r) || result._unsupportedIterableToArray(r) || _nonIterableRest();
+}
+
+/**
+ * Val's console output, and the one place that decides what reaches it.
+ *
+ * Val runs inside someone else's app: the server in their dev server and their
+ * production logs, the Studio in their browser tab. Everything Val prints lands
+ * in a console that belongs to a developer who did not write the code printing
+ * it, so the levels are split by who the line is FOR:
+ *
+ * - `error` and `warn` are for that developer -- something broke, or something
+ *   they can fix -- and always print.
+ * - `info` and `debug` are for whoever is debugging Val, and print only when
+ *   asked for: `VAL_DEBUG=1` in the environment of a server, or
+ *   `localStorage.setItem("val:debug", "1")` in a browser. Both are read on
+ *   every call, so turning it on in a live tab needs no reload.
+ *
+ * In Node `console.debug` IS `console.log`, so a bare `console.debug` is not
+ * quiet on a server: it went to the developer's terminal on every request.
+ * That is why `no-console` is on for the packages that run in a host app, and
+ * this file is the exemption.
+ *
+ * Every line gets a `[val]` prefix, so a developer can filter Val out (or in).
+ * Arguments are otherwise passed through as they are, so an `Error` still
+ * prints with its stack.
+ */
+
+var PREFIX = "[val]";
+
+/** The localStorage key that turns `debug` and `info` on in a browser. */
+var VAL_DEBUG_STORAGE_KEY = "val:debug";
+function isOn(value) {
+  return value !== undefined && value !== null && value !== "" && value !== "0" && value !== "false";
+}
+function fromEnv() {
+  var _process$env;
+  // `typeof` first: a browser bundle may have no `process` at all.
+  if (typeof process === "undefined") {
+    return undefined;
+  }
+  return (_process$env = process.env) === null || _process$env === void 0 ? void 0 : _process$env.VAL_DEBUG;
+}
+function fromLocalStorage() {
+  // Not in Node, even where it has a `localStorage`: from Node 25 merely
+  // touching it without `--localstorage-file` prints a warning of its own.
+  if (!("window" in globalThis)) {
+    return undefined;
+  }
+  try {
+    var storage = Reflect.get(globalThis, "localStorage");
+    if (_typeof(storage) === "object" && storage !== null && "getItem" in storage && typeof storage.getItem === "function") {
+      var value = storage.getItem(VAL_DEBUG_STORAGE_KEY);
+      return typeof value === "string" ? value : null;
+    }
+  } catch (_unused) {
+    // A sandboxed frame or blocked site data throws on access.
+  }
+  return undefined;
+}
+function isDebugEnabled() {
+  return isOn(fromEnv()) || isOn(fromLocalStorage());
+}
+function withPrefix(args) {
+  var _args = _toArray(args),
+    first = _args[0],
+    rest = result._arrayLikeToArray(_args).slice(1);
+  if (typeof first === "string") {
+    if (/^\[val\]/i.test(first)) {
+      return args;
+    }
+    return ["".concat(PREFIX, " ").concat(first)].concat(_toConsumableArray(rest));
+  }
+  return [PREFIX].concat(_toConsumableArray(args));
+}
+
+/*
+ * `console` is looked up on every call rather than captured, so a test that
+ * spies on `console.warn` after this module loaded still sees the call.
+ */
+var log = {
+  error: function error() {
+    var _console;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    (_console = console).error.apply(_console, _toConsumableArray(withPrefix(args)));
+  },
+  warn: function warn() {
+    var _console2;
+    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+      args[_key2] = arguments[_key2];
+    }
+    (_console2 = console).warn.apply(_console2, _toConsumableArray(withPrefix(args)));
+  },
+  info: function info() {
+    if (isDebugEnabled()) {
+      var _console3;
+      for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+        args[_key3] = arguments[_key3];
+      }
+      (_console3 = console).info.apply(_console3, _toConsumableArray(withPrefix(args)));
+    }
+  },
+  debug: function debug() {
+    if (isDebugEnabled()) {
+      var _console4;
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      (_console4 = console).debug.apply(_console4, _toConsumableArray(withPrefix(args)));
+    }
+  }
+};
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -5042,7 +5174,7 @@ var RichTextSchema = /*#__PURE__*/function (_Schema) {
                       return hrefSchema["executeValidate"](hrefPath, node.href);
                     } else {
                       var exhaustiveCheck = hrefSchema;
-                      console.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
+                      log.error("Exhaustive check failed in RichText (anchor href validation)", exhaustiveCheck);
                       return false;
                     }
                   };
@@ -15293,7 +15425,7 @@ function collectObjectRecursive(item, collector) {
     }
     return;
   } else {
-    console.warn("Unknown type encountered when hashing object", _typeof(item), item);
+    log.warn("Unknown type encountered when hashing object", _typeof(item), item);
   }
 }
 
@@ -16805,7 +16937,7 @@ function isInlineRender(container) {
 
 var corePackageJson = {
 	name: "@valbuild/core",
-	version: "0.148.0",
+	version: "0.148.7",
 	"private": false,
 	description: "Val - supercharged hard-coded content",
 	repository: {
@@ -16892,6 +17024,10 @@ var DEFAULT_APP_HOST = "https://admin.val.build";
  */
 var DEFAULT_STATIC_HOST = "https://content.val.build/v1/static";
 var Internal = {
+  /** Val's console output. See `log.ts` for which levels print, and when. */
+  log: log,
+  isDebugEnabled: isDebugEnabled,
+  VAL_DEBUG_STORAGE_KEY: VAL_DEBUG_STORAGE_KEY,
   VERSION: {
     core: corePackageJson.version
   },
@@ -16920,6 +17056,7 @@ var Internal = {
   },
   getSchema: getSchema,
   getValPath: getValPath,
+  setValPath: setValPath,
   getSource: getSource,
   isValModule: isValModule,
   resolvePath: resolvePath,

package/dist/valbuild-core.cjs.dev.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-b0fa804a.cjs.dev.js');
+var dist_valbuildCore = require('./index-66258256.cjs.dev.js');
 require('./result-bb1f436e.cjs.dev.js');
 
 

package/dist/valbuild-core.cjs.prod.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-ad3488f6.cjs.prod.js');
+var dist_valbuildCore = require('./index-dfea75c9.cjs.prod.js');
 require('./result-787e35f6.cjs.prod.js');
 
 

package/dist/valbuild-core.esm.js

@@ -1,2 +1,2 @@
-export { H as ASSISTANT_SETTINGS_MAX_LENGTH, A as ArraySchema, B as BooleanSchema, a4 as CODE_LANGUAGES, a5 as COLOR_FORMATS, a3 as CodeSchema, a2 as ColorSchema, e as DEFAULT_APP_HOST, a6 as DEFAULT_COLOR_FORMAT, D as DEFAULT_CONTENT_HOST, u as DEFAULT_FONT_ACCEPT, f as DEFAULT_STATIC_HOST, o as DEFAULT_VAL_REMOTE_HOST, x as DEFAULT_VIDEO_ACCEPT, y as DEFAULT_VIDEO_RENDITIONS, z as DEFAULT_VIDEO_SEGMENT_DURATION, C as DateSchema, a7 as DateTimeSchema, ad as DiscriminatedUnionSchema, ae as EnumSchema, F as FATAL_ERROR_TYPES, v as FONT_MIME_TYPES, t as FileSchema, G as GenericSelector, r as ImageSchema, I as Internal, a8 as KeyOfSchema, af as LiteralSchema, Z as LocaleSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, ac as RichTextSchema, ab as RouteSchema, Q as SETTINGS_MODULE_CONVENTION, S as Schema, E as SettingsSchema, q as StringSchema, T as THEME_LOGO_DIRECTORY, K as THEME_RADIUS_LENGTHS, J as THEME_RADIUS_STEPS, av as UNSAFE_URL_SCHEMES, V as VAL_EXTENSION, a9 as ValViewSchema, w as VideoSchema, L as assistantAvailability, k as computeSchemaSha, j as computeSourcesSha, h as computeValModuleShas, $ as declaredKeySetOf, p as derefPatch, ar as describeSchemeRejection, ag as deserializeSchema, a1 as discriminatedUnionBranchOf, g as extractValModules, ao as getSourcePathFromRoute, n as hasMediaSchema, l as hasRemoteFileSchema, i as initVal, as as isCheckableScheme, ai as isInlineRender, ap as isPageRouter, U as isRootModuleFilePath, aa as isValViewSource, Y as localeOfValue, X as localeTagError, an as matchRoutePattern, a0 as missingDeclaredKeys, m as modules, aj as parseNextJsRoutePattern, ak as parseTanStackRoutePattern, ah as previewScope, at as rejectScheme, W as resolveSettingsModule, aq as routePatternOf, au as schemeOf, al as tanStackSegmentsOfRoutePath, am as validateUrlAgainstPattern } from './index-09bd1d7d.esm.js';
+export { H as ASSISTANT_SETTINGS_MAX_LENGTH, A as ArraySchema, B as BooleanSchema, a4 as CODE_LANGUAGES, a5 as COLOR_FORMATS, a3 as CodeSchema, a2 as ColorSchema, e as DEFAULT_APP_HOST, a6 as DEFAULT_COLOR_FORMAT, D as DEFAULT_CONTENT_HOST, u as DEFAULT_FONT_ACCEPT, f as DEFAULT_STATIC_HOST, o as DEFAULT_VAL_REMOTE_HOST, x as DEFAULT_VIDEO_ACCEPT, y as DEFAULT_VIDEO_RENDITIONS, z as DEFAULT_VIDEO_SEGMENT_DURATION, C as DateSchema, a7 as DateTimeSchema, ad as DiscriminatedUnionSchema, ae as EnumSchema, F as FATAL_ERROR_TYPES, v as FONT_MIME_TYPES, t as FileSchema, G as GenericSelector, r as ImageSchema, I as Internal, a8 as KeyOfSchema, af as LiteralSchema, Z as LocaleSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, ac as RichTextSchema, ab as RouteSchema, Q as SETTINGS_MODULE_CONVENTION, S as Schema, E as SettingsSchema, q as StringSchema, T as THEME_LOGO_DIRECTORY, K as THEME_RADIUS_LENGTHS, J as THEME_RADIUS_STEPS, av as UNSAFE_URL_SCHEMES, V as VAL_EXTENSION, a9 as ValViewSchema, w as VideoSchema, L as assistantAvailability, k as computeSchemaSha, j as computeSourcesSha, h as computeValModuleShas, $ as declaredKeySetOf, p as derefPatch, ar as describeSchemeRejection, ag as deserializeSchema, a1 as discriminatedUnionBranchOf, g as extractValModules, ao as getSourcePathFromRoute, n as hasMediaSchema, l as hasRemoteFileSchema, i as initVal, as as isCheckableScheme, ai as isInlineRender, ap as isPageRouter, U as isRootModuleFilePath, aa as isValViewSource, Y as localeOfValue, X as localeTagError, an as matchRoutePattern, a0 as missingDeclaredKeys, m as modules, aj as parseNextJsRoutePattern, ak as parseTanStackRoutePattern, ah as previewScope, at as rejectScheme, W as resolveSettingsModule, aq as routePatternOf, au as schemeOf, al as tanStackSegmentsOfRoutePath, am as validateUrlAgainstPattern } from './index-52c01907.esm.js';
 import './result-daff1cae.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/core",
-  "version": "0.148.0",
+  "version": "0.148.7",
   "private": false,
   "description": "Val - supercharged hard-coded content",
   "repository": {

package/patch/dist/valbuild-core-patch.cjs.dev.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('../../dist/index-b0fa804a.cjs.dev.js');
+var dist_valbuildCore = require('../../dist/index-66258256.cjs.dev.js');
 var result = require('../../dist/result-bb1f436e.cjs.dev.js');
 var util = require('../../dist/util-b213092b.cjs.dev.js');
 

package/patch/dist/valbuild-core-patch.cjs.prod.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('../../dist/index-ad3488f6.cjs.prod.js');
+var dist_valbuildCore = require('../../dist/index-dfea75c9.cjs.prod.js');
 var result = require('../../dist/result-787e35f6.cjs.prod.js');
 var util = require('../../dist/util-030d8a1f.cjs.prod.js');
 

package/patch/dist/valbuild-core-patch.esm.js

@@ -1,5 +1,5 @@
-import { _ as _typeof, a as _slicedToArray, P as PatchError, s as splitModuleFilePathAndModulePath, b as _createClass, c as _classCallCheck, d as _toConsumableArray } from '../../dist/index-09bd1d7d.esm.js';
-export { P as PatchError } from '../../dist/index-09bd1d7d.esm.js';
+import { _ as _typeof, a as _slicedToArray, P as PatchError, s as splitModuleFilePathAndModulePath, b as _createClass, c as _classCallCheck, d as _toConsumableArray } from '../../dist/index-52c01907.esm.js';
+export { P as PatchError } from '../../dist/index-52c01907.esm.js';
 import { f as isNonEmpty, e as err, o as ok, m as map, g as flatMap, i as isErr, h as flatMapReduce, j as filterOrElse, k as mapErr, l as map$1, n as all, p as flatten, q as allT } from '../../dist/result-daff1cae.esm.js';
 import { p as pipe } from '../../dist/util-18613e99.esm.js';