@valbuild/cli 0.140.0 → 0.141.0

package/CHANGELOG.md

@@ -1,5 +1,85 @@
 # @valbuild/cli
 
+## 0.141.0
+
+### Minor Changes
+
+- [#802](https://github.com/valbuild/val/pull/802) [`199e214`](https://github.com/valbuild/val/commit/199e21471d98806fb34c579cb876560078c928b9) Thanks [@freekh](https://github.com/freekh)! - New: `files: { remote: true }` in `val.config.ts` stores every image, file and video on Val's remote content host.
+
+  ```ts
+  const { s, c, val, config } = initVal({
+    project: "myorg/myproject",
+    files: { remote: true },
+  });
+  ```
+
+  With it, `s.image()`, `s.file()`, `s.video()`, `s.imageset()`, `s.fileset()`, `s.videoset()` and `s.richtext({ img: true })` behave as though `.remote()` had been written on them. Images already in the project are reported as `image:upload-remote` until they are uploaded; `npx val validate --fix` does that.
+
+  **Required in the Val app.** A project running there (`VAL_ENV=app`) refuses to start without it, with an error that says what to add, and `val publish` refuses before it builds.
+
+  **Breaking:** `files.directory` has been removed from `val.config.ts`. Local files that have no `dir` of their own are stored in `/public/val`, which was the default.
+
+- [#779](https://github.com/valbuild/val/pull/779) [`ba3f330`](https://github.com/valbuild/val/commit/ba3f3300a3dd8649e154097cdfca3b64db209d89) Thanks [@freekh](https://github.com/freekh)! - New: `s.video()`, for mp4/WebM files and HLS streams.
+
+  ```ts
+  const schema = s.object({
+    intro: s.video({ stream: { type: "hls" } }),
+  });
+  ```
+
+  - **Upload and play in the Studio.** A video field shows a player, the file's size and length, and progress while it uploads.
+  - **HLS streaming without a video service.** With `stream: { type: "hls" }`, the Studio converts an upload to an HLS stream in the editor's browser before it uploads it. It makes one H.264 rendition per height (1080p, 720p and 480p by default, and never larger than the upload) and stores them as a folder of files next to your other uploads. Nothing is installed in your app for this: the converter ships inside the Studio and is only downloaded when someone uploads to a streaming field. A browser that can't convert (no WebCodecs, or a non-https address) uploads the original file and says so.
+  - **Poster:** pause on a frame and choose "Use current frame". The frame is saved as an image, and `posterTime` records where it was taken.
+  - **Start and end:** play part of a video without cutting the file.
+  - **Focal point:** marks what must stay in frame when the page crops the video.
+  - **Description:** text for people who can't see the video.
+  - **Captions:** one WebVTT file per language. `.srt` files are converted on upload.
+  - **`<ValVideo>`** in `@valbuild/next` and `@valbuild/tanstack` renders all of the above and is click-to-edit. For HLS in browsers that can't play it natively, pass `hls={() => import("hls.js")}`. It is only loaded when it's needed.
+  - **Rename** a video in the Studio. An HLS stream is renamed as a whole: every playlist and segment moves to the new folder.
+  - `npx val validate --fix` fills in `mimeType`, `width`, `height` and `duration` for a hand-written `.mp4`, `.mov`, `.webm`, `.mkv` or HLS video, on disk or on Val Remote. A remote video is not downloaded: only its headers are read, usually in one to three small requests.
+  - `.remote()` works for videos. `npx val validate --fix` moves a video to Val Remote, or back into the project, together with its poster, captions and every file of an HLS stream.
+
+  A video value always has a `mimeType`: it is how a page knows whether it has an `.mp4` or an `.m3u8`.
+
+  New: `s.videoset()`, a collection of videos, like `s.imageset()` for images.
+
+  ```ts
+  const videosVal = c.define(
+    "/content/videos.val.ts",
+    s.videoset({ dir: "/public/val/videos", stream: { type: "hls" } }),
+    {},
+  );
+  const schema = s.object({ intro: s.video(videosVal) });
+  ```
+
+  - **Upload once, set it up once, use anywhere.** A set's entry holds what is true of the file (its type, size and length) and, as defaults, a description, poster, start and end, focal point and captions. A field that picks from the set (`s.video(videosVal)`) gets all of those, and can override any of them on its own. For example, the same clip can open one page at 0:02 and every other page where the set says.
+  - **Media in the Studio.** A set is listed under Media and opens as a gallery of videos, with each video's poster as its thumbnail. Hovering a video previews it, and the selected video plays in a real player (HLS streams too) beside the poster, times, focal point and captions you edit for it. You can upload into the set (with `stream`, uploads become HLS streams, and each upload gets a poster), rename a video, and delete a video that nothing uses. Renaming a video updates every field that uses it. An HLS stream is one entry, and renaming or deleting it moves or removes all of its files.
+  - **Picking.** A set-backed field picks from the set, or uploads into it. Each value the set provides is marked "From gallery · Override", and once overridden, "Overridden · Use gallery's".
+  - `useVal` and `fetchVal` fill in what the set holds (`mimeType`, `width`, `height`, `duration`, and every default the field does not override), so `<ValVideo>` works the same either way.
+  - `.remote()` works for sets. `npx val validate --fix` fills in missing metadata for an entry, adds untracked videos found in the set's directory, and moves a set's videos to Val Remote.
+
+  Image and file galleries use the same new gallery layout: a grid or list of entries, with the selected one open in a panel beside it.
+
+  - An `s.imageset()` entry can hold a default focal point, as well as its description. An `s.image(galleryVal)` field shows both, and can override either.
+  - Fixed: outside draft mode, `useVal` and `fetchVal` now fill a gallery-backed image or file from its gallery (dimensions, mime type, description). Before, a published page got only the `path`.
+
+### Patch Changes
+
+- Updated dependencies [[`199e214`](https://github.com/valbuild/val/commit/199e21471d98806fb34c579cb876560078c928b9), [`ba3f330`](https://github.com/valbuild/val/commit/ba3f3300a3dd8649e154097cdfca3b64db209d89)]:
+  - @valbuild/core@0.141.0
+  - @valbuild/server@0.141.0
+  - @valbuild/shared@0.141.0
+  - @valbuild/language-server@0.141.0
+
+## 0.140.2
+
+### Patch Changes
+
+- Updated dependencies [[`df1e5f5`](https://github.com/valbuild/val/commit/df1e5f5f94391f25c71839cc476a51198b90db4d)]:
+  - @valbuild/server@0.140.2
+  - @valbuild/shared@0.140.2
+  - @valbuild/language-server@0.140.2
+
 ## 0.140.0
 
 ### Patch Changes

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

@@ -359,6 +359,18 @@ async function* runValidation({
                 }, !!fix, sourcePath, v, remoteFiles, valModule.source, valModule.schema);
                 if (fix && fixPatch !== null && fixPatch !== void 0 && fixPatch.patch && (fixPatch === null || fixPatch === void 0 ? void 0 : fixPatch.patch.length) > 0) {
                   await service.patch(moduleFilePath, fixPatch.patch);
+                  // A fix that renames something other modules name (a video
+                  // set's key) rewrites them too, and only once its own patch
+                  // is in: a reference to a key that was never renamed is the
+                  // one thing worse than a stale one.
+                  for (const other of result.otherModulePatches ?? []) {
+                    await service.patch(other.moduleFilePath, other.patch);
+                    yield {
+                      type: "fix-applied",
+                      file: other.moduleFilePath.slice(1),
+                      sourcePath: other.moduleFilePath
+                    };
+                  }
                   fixedErrors += 1;
                   yield {
                     type: "fix-applied",
@@ -975,11 +987,10 @@ async function watchAndValidate(projectRoot, runOnce) {
 async function listUnusedFiles({
   root
 }) {
-  var _valConfigFile$files;
   const projectRoot = root ? path__default["default"].resolve(root) : process.cwd();
-  const valConfigFile = await server.findAndEvalValConfigFile(projectRoot);
-  // Strip the leading "/" so it is relative to the project root (e.g. "public/val").
-  const managedDir = ((valConfigFile === null || valConfigFile === void 0 || (_valConfigFile$files = valConfigFile.files) === null || _valConfigFile$files === void 0 ? void 0 : _valConfigFile$files.directory) ?? "/public/val").replace(/^\//, "");
+
+  // Relative to the project root.
+  const managedDir = "public/val";
   const service = await server.createService(projectRoot);
   const registered = new Set(service.getModuleFilePaths());
   const valFiles = await fastGlob.glob("**/*.val.{js,ts}", {
@@ -996,6 +1007,54 @@ async function listUnusedFiles({
     const valModule = await service.get(moduleId, "", {
       validate: true
     });
+    // A video is found by walking the source, not by its validation errors:
+    // unlike an image, a video with all its metadata reports none, so the
+    // errors below would call every finished video unused. And a video names
+    // more than its `path` — a poster, caption tracks, and a stream's
+    // playlists and segments — which `filesOfVideo` is the one answer to.
+    if (valModule.source !== undefined && valModule.schema) {
+      internal.traverseSchemaSource(valModule.source, valModule.schema, moduleId, ({
+        source,
+        schema
+      }) => {
+        if (schema.type !== "video") {
+          return;
+        }
+        for (const ref of server.filesOfVideo(source, {
+          projectRoot
+        })) {
+          if (!core.Internal.isRemoteMediaPath(ref)) {
+            filesUsedByVal.push(path__default["default"].join(projectRoot, ...ref.split("/")));
+          }
+        }
+      });
+    }
+    // A media collection (`s.imageset()`, `s.fileset()`, `s.videoset()`) is
+    // keyed by its files, and an entry that is fine reports no error either —
+    // so, as for a video, they are found by walking the source. A video set's
+    // stream holds every playlist and segment its master names, and an entry
+    // its default poster and captions.
+    if (valModule.source !== undefined && valModule.schema) {
+      forEachMediaCollection(valModule.source, valModule.schema, (entries, mediaType) => {
+        for (const [key, entry] of Object.entries(entries)) {
+          const refs = mediaType === "videos" ?
+          // The entry's poster and captions are its own files too.
+          server.filesOfVideo(isObject(entry) ? {
+            ...entry,
+            path: key
+          } : {
+            path: key
+          }, {
+            projectRoot
+          }) : [key];
+          for (const ref of refs) {
+            if (!core.Internal.isRemoteMediaPath(ref)) {
+              filesUsedByVal.push(path__default["default"].join(projectRoot, ...ref.split("/")));
+            }
+          }
+        }
+      });
+    }
     // TODO: not sure using validation is the best way to do this, but it works currently.
     if (valModule.errors) {
       if (valModule.errors.validation) {
@@ -1040,6 +1099,44 @@ async function listUnusedFiles({
 function isFileRef(value) {
   return !!value && typeof value === "object" && "path" in value && typeof value.path === "string";
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/**
+ * Every media collection in a module's source, with its entries.
+ *
+ * `traverseSchemaSource` visits leaves, and a collection is a record whose
+ * KEYS are what matters, so it never shows up there.
+ */
+function forEachMediaCollection(source, schema, visit) {
+  if (schema.type === "record") {
+    if (!isObject(source)) {
+      return;
+    }
+    if (schema.mediaType) {
+      visit(source, schema.mediaType);
+      return;
+    }
+    for (const value of Object.values(source)) {
+      forEachMediaCollection(value, schema.item, visit);
+    }
+  } else if (schema.type === "object") {
+    if (!isObject(source)) {
+      return;
+    }
+    for (const [key, item] of Object.entries(schema.items)) {
+      forEachMediaCollection(source[key], item, visit);
+    }
+  } else if (schema.type === "array") {
+    if (!Array.isArray(source)) {
+      return;
+    }
+    for (const value of source) {
+      forEachMediaCollection(value, schema.item, visit);
+    }
+  }
+}
 
 /**
  * The versions of the Val packages this project has installed.
@@ -1220,7 +1317,6 @@ async function lsp() {
 
 class DebugContextError extends Error {}
 async function createDebugContext(options) {
-  var _config$files;
   const projectRoot = options.root ? path__default["default"].resolve(options.root) : process.cwd();
   if (!fs__default$1["default"].existsSync(projectRoot)) {
     throw new DebugContextError(`Project root does not exist: ${projectRoot}`);
@@ -1231,7 +1327,7 @@ async function createDebugContext(options) {
   }
   const valModules = server.loadValModules(projectRoot);
   const contentUrl = process.env.VAL_CONTENT_URL || core.DEFAULT_CONTENT_HOST;
-  const filesDirectory = ((_config$files = config.files) === null || _config$files === void 0 ? void 0 : _config$files.directory) ?? "/public/val";
+  const filesDirectory = "/public/val";
   const project = config.project || process.env.VAL_PROJECT || null;
   const git = await server.safeReadGit(projectRoot);
   const branch = options.branch || config.gitBranch || process.env.VAL_GIT_BRANCH || git.branch || null;
@@ -1321,7 +1417,8 @@ function readAuth(projectRoot) {
  * Starts from the modules the pending patches touch and closes over the
  * cross-module references a schema can hold:
  *  - `keyOf` points at another module through its `path` (a SourcePath)
- *  - `image`/`file` point at a gallery module through `referencedModule`
+ *  - `image`/`file`/`video` point at a gallery (or video set) module through
+ *    `referencedModule`
  *  - route validation cross-references *every* router module, so if any
  *    included module has a route or router we need all of them
  */
@@ -1410,6 +1507,7 @@ function collectSchemaReferences(schema) {
         break;
       case "file":
       case "image":
+      case "video":
         if (node.referencedModule) {
           refs.referencedModules.push(node.referencedModule);
         }
@@ -3113,7 +3211,39 @@ async function runPublish(options) {
   if (git.status === "error") {
     return git;
   }
-  const config = await server.findAndEvalValConfigFile(root).catch(() => null);
+  const read = await server.findAndEvalValConfigFile(root).then(config => ({
+    config,
+    error: null
+  }), error => ({
+    config: null,
+    error
+  }));
+  const config = read.config;
+  /*
+   * The Val app stores all media remotely, and the deployed server refuses to
+   * start for a project that does not say so. Refused here too, so that a
+   * developer who removes `files: { remote: true }` finds out from this
+   * command -- not from the site, after the build has gone out.
+   *
+   * A config that cannot be read is refused as well when this builds the
+   * checkout, because the commonest way to lose the setting is to shorten
+   * `initVal({ files: { remote: true } })` to `initVal()`, which exports no
+   * config at all. Skipping the check then would be skipping it exactly when
+   * it was needed.
+   *
+   * A directory of artifacts built elsewhere is the exception: it may have no
+   * config beside it, or none this machine can evaluate, and the server's own
+   * check still stands there.
+   */
+  const refusal = remoteFilesRefusal(read, {
+    building: !prebuilt
+  });
+  if (refusal !== null) {
+    return {
+      status: "error",
+      message: refusal
+    };
+  }
   const project = (config === null || config === void 0 ? void 0 : config.project) ?? env.VAL_PROJECT ?? null;
   const credential = await resolvePublishCredential({
     root,
@@ -3671,6 +3801,24 @@ function formatBytes(bytes) {
   }
   return `${value.toFixed(1)} ${units[unit]}`;
 }
+/**
+ * Why this project cannot be published to the Val app as its media is
+ * configured, or null when it can. See the call site.
+ */
+function remoteFilesRefusal(read, {
+  building
+}) {
+  if (read.config !== null) {
+    var _read$config$files;
+    return ((_read$config$files = read.config.files) === null || _read$config$files === void 0 ? void 0 : _read$config$files.remote) === true ? null : server.APP_MODE_REQUIRES_REMOTE_FILES;
+  }
+  if (!building) return null;
+  if (read.error !== null) {
+    const reason = read.error instanceof Error ? read.error.message : String(read.error);
+    return `${server.APP_MODE_REQUIRES_REMOTE_FILES}\n\nval.config.ts could not be read, so this could not be checked: ${reason}`;
+  }
+  return `${server.APP_MODE_REQUIRES_REMOTE_FILES}\n\nThere is no val.config.ts (or val.config.js) in this project to say it.`;
+}
 
 /**
  * `val publish` - a built project in, a live site out.
@@ -3976,7 +4124,7 @@ async function main() {
 
       Command: list-unused-files
       Description: EXPERIMENTAL.
-        List files that are in the configured files directory (files.directory, default public/val) but not in use by any Val module.
+        List files that are in the configured files directory (public/val) but not in use by any Val module.
         This is useful for cleaning up unused files.
       Options:
         --root [root], -r [root] Set project root directory (default process.cwd())

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

@@ -359,6 +359,18 @@ async function* runValidation({
                 }, !!fix, sourcePath, v, remoteFiles, valModule.source, valModule.schema);
                 if (fix && fixPatch !== null && fixPatch !== void 0 && fixPatch.patch && (fixPatch === null || fixPatch === void 0 ? void 0 : fixPatch.patch.length) > 0) {
                   await service.patch(moduleFilePath, fixPatch.patch);
+                  // A fix that renames something other modules name (a video
+                  // set's key) rewrites them too, and only once its own patch
+                  // is in: a reference to a key that was never renamed is the
+                  // one thing worse than a stale one.
+                  for (const other of result.otherModulePatches ?? []) {
+                    await service.patch(other.moduleFilePath, other.patch);
+                    yield {
+                      type: "fix-applied",
+                      file: other.moduleFilePath.slice(1),
+                      sourcePath: other.moduleFilePath
+                    };
+                  }
                   fixedErrors += 1;
                   yield {
                     type: "fix-applied",
@@ -975,11 +987,10 @@ async function watchAndValidate(projectRoot, runOnce) {
 async function listUnusedFiles({
   root
 }) {
-  var _valConfigFile$files;
   const projectRoot = root ? path__default["default"].resolve(root) : process.cwd();
-  const valConfigFile = await server.findAndEvalValConfigFile(projectRoot);
-  // Strip the leading "/" so it is relative to the project root (e.g. "public/val").
-  const managedDir = ((valConfigFile === null || valConfigFile === void 0 || (_valConfigFile$files = valConfigFile.files) === null || _valConfigFile$files === void 0 ? void 0 : _valConfigFile$files.directory) ?? "/public/val").replace(/^\//, "");
+
+  // Relative to the project root.
+  const managedDir = "public/val";
   const service = await server.createService(projectRoot);
   const registered = new Set(service.getModuleFilePaths());
   const valFiles = await fastGlob.glob("**/*.val.{js,ts}", {
@@ -996,6 +1007,54 @@ async function listUnusedFiles({
     const valModule = await service.get(moduleId, "", {
       validate: true
     });
+    // A video is found by walking the source, not by its validation errors:
+    // unlike an image, a video with all its metadata reports none, so the
+    // errors below would call every finished video unused. And a video names
+    // more than its `path` — a poster, caption tracks, and a stream's
+    // playlists and segments — which `filesOfVideo` is the one answer to.
+    if (valModule.source !== undefined && valModule.schema) {
+      internal.traverseSchemaSource(valModule.source, valModule.schema, moduleId, ({
+        source,
+        schema
+      }) => {
+        if (schema.type !== "video") {
+          return;
+        }
+        for (const ref of server.filesOfVideo(source, {
+          projectRoot
+        })) {
+          if (!core.Internal.isRemoteMediaPath(ref)) {
+            filesUsedByVal.push(path__default["default"].join(projectRoot, ...ref.split("/")));
+          }
+        }
+      });
+    }
+    // A media collection (`s.imageset()`, `s.fileset()`, `s.videoset()`) is
+    // keyed by its files, and an entry that is fine reports no error either —
+    // so, as for a video, they are found by walking the source. A video set's
+    // stream holds every playlist and segment its master names, and an entry
+    // its default poster and captions.
+    if (valModule.source !== undefined && valModule.schema) {
+      forEachMediaCollection(valModule.source, valModule.schema, (entries, mediaType) => {
+        for (const [key, entry] of Object.entries(entries)) {
+          const refs = mediaType === "videos" ?
+          // The entry's poster and captions are its own files too.
+          server.filesOfVideo(isObject(entry) ? {
+            ...entry,
+            path: key
+          } : {
+            path: key
+          }, {
+            projectRoot
+          }) : [key];
+          for (const ref of refs) {
+            if (!core.Internal.isRemoteMediaPath(ref)) {
+              filesUsedByVal.push(path__default["default"].join(projectRoot, ...ref.split("/")));
+            }
+          }
+        }
+      });
+    }
     // TODO: not sure using validation is the best way to do this, but it works currently.
     if (valModule.errors) {
       if (valModule.errors.validation) {
@@ -1040,6 +1099,44 @@ async function listUnusedFiles({
 function isFileRef(value) {
   return !!value && typeof value === "object" && "path" in value && typeof value.path === "string";
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/**
+ * Every media collection in a module's source, with its entries.
+ *
+ * `traverseSchemaSource` visits leaves, and a collection is a record whose
+ * KEYS are what matters, so it never shows up there.
+ */
+function forEachMediaCollection(source, schema, visit) {
+  if (schema.type === "record") {
+    if (!isObject(source)) {
+      return;
+    }
+    if (schema.mediaType) {
+      visit(source, schema.mediaType);
+      return;
+    }
+    for (const value of Object.values(source)) {
+      forEachMediaCollection(value, schema.item, visit);
+    }
+  } else if (schema.type === "object") {
+    if (!isObject(source)) {
+      return;
+    }
+    for (const [key, item] of Object.entries(schema.items)) {
+      forEachMediaCollection(source[key], item, visit);
+    }
+  } else if (schema.type === "array") {
+    if (!Array.isArray(source)) {
+      return;
+    }
+    for (const value of source) {
+      forEachMediaCollection(value, schema.item, visit);
+    }
+  }
+}
 
 /**
  * The versions of the Val packages this project has installed.
@@ -1220,7 +1317,6 @@ async function lsp() {
 
 class DebugContextError extends Error {}
 async function createDebugContext(options) {
-  var _config$files;
   const projectRoot = options.root ? path__default["default"].resolve(options.root) : process.cwd();
   if (!fs__default$1["default"].existsSync(projectRoot)) {
     throw new DebugContextError(`Project root does not exist: ${projectRoot}`);
@@ -1231,7 +1327,7 @@ async function createDebugContext(options) {
   }
   const valModules = server.loadValModules(projectRoot);
   const contentUrl = process.env.VAL_CONTENT_URL || core.DEFAULT_CONTENT_HOST;
-  const filesDirectory = ((_config$files = config.files) === null || _config$files === void 0 ? void 0 : _config$files.directory) ?? "/public/val";
+  const filesDirectory = "/public/val";
   const project = config.project || process.env.VAL_PROJECT || null;
   const git = await server.safeReadGit(projectRoot);
   const branch = options.branch || config.gitBranch || process.env.VAL_GIT_BRANCH || git.branch || null;
@@ -1321,7 +1417,8 @@ function readAuth(projectRoot) {
  * Starts from the modules the pending patches touch and closes over the
  * cross-module references a schema can hold:
  *  - `keyOf` points at another module through its `path` (a SourcePath)
- *  - `image`/`file` point at a gallery module through `referencedModule`
+ *  - `image`/`file`/`video` point at a gallery (or video set) module through
+ *    `referencedModule`
  *  - route validation cross-references *every* router module, so if any
  *    included module has a route or router we need all of them
  */
@@ -1410,6 +1507,7 @@ function collectSchemaReferences(schema) {
         break;
       case "file":
       case "image":
+      case "video":
         if (node.referencedModule) {
           refs.referencedModules.push(node.referencedModule);
         }
@@ -3113,7 +3211,39 @@ async function runPublish(options) {
   if (git.status === "error") {
     return git;
   }
-  const config = await server.findAndEvalValConfigFile(root).catch(() => null);
+  const read = await server.findAndEvalValConfigFile(root).then(config => ({
+    config,
+    error: null
+  }), error => ({
+    config: null,
+    error
+  }));
+  const config = read.config;
+  /*
+   * The Val app stores all media remotely, and the deployed server refuses to
+   * start for a project that does not say so. Refused here too, so that a
+   * developer who removes `files: { remote: true }` finds out from this
+   * command -- not from the site, after the build has gone out.
+   *
+   * A config that cannot be read is refused as well when this builds the
+   * checkout, because the commonest way to lose the setting is to shorten
+   * `initVal({ files: { remote: true } })` to `initVal()`, which exports no
+   * config at all. Skipping the check then would be skipping it exactly when
+   * it was needed.
+   *
+   * A directory of artifacts built elsewhere is the exception: it may have no
+   * config beside it, or none this machine can evaluate, and the server's own
+   * check still stands there.
+   */
+  const refusal = remoteFilesRefusal(read, {
+    building: !prebuilt
+  });
+  if (refusal !== null) {
+    return {
+      status: "error",
+      message: refusal
+    };
+  }
   const project = (config === null || config === void 0 ? void 0 : config.project) ?? env.VAL_PROJECT ?? null;
   const credential = await resolvePublishCredential({
     root,
@@ -3671,6 +3801,24 @@ function formatBytes(bytes) {
   }
   return `${value.toFixed(1)} ${units[unit]}`;
 }
+/**
+ * Why this project cannot be published to the Val app as its media is
+ * configured, or null when it can. See the call site.
+ */
+function remoteFilesRefusal(read, {
+  building
+}) {
+  if (read.config !== null) {
+    var _read$config$files;
+    return ((_read$config$files = read.config.files) === null || _read$config$files === void 0 ? void 0 : _read$config$files.remote) === true ? null : server.APP_MODE_REQUIRES_REMOTE_FILES;
+  }
+  if (!building) return null;
+  if (read.error !== null) {
+    const reason = read.error instanceof Error ? read.error.message : String(read.error);
+    return `${server.APP_MODE_REQUIRES_REMOTE_FILES}\n\nval.config.ts could not be read, so this could not be checked: ${reason}`;
+  }
+  return `${server.APP_MODE_REQUIRES_REMOTE_FILES}\n\nThere is no val.config.ts (or val.config.js) in this project to say it.`;
+}
 
 /**
  * `val publish` - a built project in, a live site out.
@@ -3976,7 +4124,7 @@ async function main() {
 
       Command: list-unused-files
       Description: EXPERIMENTAL.
-        List files that are in the configured files directory (files.directory, default public/val) but not in use by any Val module.
+        List files that are in the configured files directory (public/val) but not in use by any Val module.
         This is useful for cleaning up unused files.
       Options:
         --root [root], -r [root] Set project root directory (default process.cwd())