@valbuild/shared 0.127.0 → 0.128.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @valbuild/shared
 
+## 0.128.0
+
+### Patch Changes
+
+- Updated dependencies [[`8b52b33`](https://github.com/valbuild/val/commit/8b52b33e1f629f14f66cc71dcc7cf415d210c7d4), [`362fb49`](https://github.com/valbuild/val/commit/362fb49f30d2b04c4ff78d54dca2bf5ad978a05c), [`c595799`](https://github.com/valbuild/val/commit/c59579977a436ec530c6c69f2b340ab9829d97ab)]:
+  - @valbuild/core@0.128.0
+
 ## 0.127.0
 
 ### Minor Changes

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

@@ -1,2 +1,2 @@
-export { 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, g as getNextAppRouterSourceFolder, l as getPageRouterSitemapTree, j as getPageRouterSourceFolder, m as getPatternFromModuleFilePath, h as getTanStackRouterSourceFolder, k as isTanStackRoutesFolder, f as isValCanvasFrame, i as isValCanvasPageMessage, e as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-a6cb37cb.esm.js';
+export { 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, g as getNextAppRouterSourceFolder, l as getPageRouterSitemapTree, j as getPageRouterSourceFolder, m as getPatternFromModuleFilePath, h as getTanStackRouterSourceFolder, k as isTanStackRoutesFolder, f as isValCanvasFrame, i as isValCanvasPageMessage, e as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-6777bdfa.esm.js';
 import '@valbuild/core';

package/dist/declarations/src/internal/aiTools/aiImageToolPatches.d.ts

@@ -40,7 +40,7 @@ export type ResolveResult = {
  * Walks `schema` along `path`, returning a structured result:
  * - `leaf`: walked the full path; resolved schema at the end.
  * - `richtext`: hit a richtext mid-walk; richtext is the resolved schema.
- * - `gallery-traversed`: hit an `s.images()` record and walked past it (i.e. the
+ * - `gallery-traversed`: hit an `s.imageset()` record and walked past it (i.e. the
  *   path tries to address an entry inside the gallery — a clue the AI should
  *   have used the gallery tool instead).
  * - `unresolved`: the path could not be walked.

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

@@ -14,8 +14,8 @@ export declare const ImageEncodeOption: z.ZodUnion<readonly [z.ZodLiteral<false>
     maxWidth: z.ZodOptional<z.ZodNumber>;
     maxHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>]>;
-export declare const ImageOptions: z.ZodObject<{
-    directory: z.ZodOptional<z.ZodString>;
+export declare const ImageOptions: z.ZodPreprocess<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
     accept: z.ZodOptional<z.ZodString>;
     encode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
         type: z.ZodLiteral<"webp">;
@@ -23,7 +23,7 @@ export declare const ImageOptions: z.ZodObject<{
         maxWidth: z.ZodOptional<z.ZodNumber>;
         maxHeight: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>]>>;
-}, z.core.$strip>;
+}, z.core.$strip>>;
 export declare const SerializedImageSchema: z.ZodType<SerializedImageSchemaT>;
 export declare const RichTextOptions: z.ZodType<SerializedRichTextOptionsT>;
 export declare const SerializedRichTextSchema: z.ZodType<SerializedRichTextSchemaT>;

package/dist/{getSitemapTree-a6cb37cb.esm.js → getSitemapTree-6777bdfa.esm.js}

@@ -428,4 +428,4 @@ function getPatternFromModuleFilePath(moduleFilePath, srcFolder) {
   .replace("/page.val.ts", "").replace("/page.val.js", "");
 }
 
-export { VAL_CONFIG_SESSION_STORAGE_KEY as V, _createForOfIteratorHelper as _, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, isValCanvasStudioMessage as e, isValCanvasFrame as f, getNextAppRouterSourceFolder as g, getTanStackRouterSourceFolder as h, isValCanvasPageMessage as i, getPageRouterSourceFolder as j, isTanStackRoutesFolder as k, getPageRouterSitemapTree as l, getPatternFromModuleFilePath as m, _objectSpread2 as n, _arrayLikeToArray as o, parseRoutePattern as p, _unsupportedIterableToArray as q, _defineProperty as r, _typeof as s, withValCanvasParam as w };
+export { VAL_CONFIG_SESSION_STORAGE_KEY as V, _createForOfIteratorHelper as _, VAL_THEME_SESSION_STORAGE_KEY as a, VAL_AI_SESSION_STORAGE_KEY as b, VAL_CANVAS_PARAM as c, VAL_CANVAS_MESSAGE as d, isValCanvasStudioMessage as e, isValCanvasFrame as f, getNextAppRouterSourceFolder as g, getTanStackRouterSourceFolder as h, isValCanvasPageMessage as i, getPageRouterSourceFolder as j, isTanStackRoutesFolder as k, getPageRouterSitemapTree as l, getPatternFromModuleFilePath as m, _objectSpread2 as n, _arrayLikeToArray as o, parseRoutePattern as p, _unsupportedIterableToArray as q, _typeof as r, _defineProperty as s, withValCanvasParam as w };

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

@@ -897,10 +897,34 @@ var PatchBlock = zod.z.object({
   parentRef: ParentRef$1
 });
 
+function _objectWithoutPropertiesLoose(r, e) {
+  if (null == r) return {};
+  var t = {};
+  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
+    if (-1 !== e.indexOf(n)) continue;
+    t[n] = r[n];
+  }
+  return t;
+}
+
+function _objectWithoutProperties(e, t) {
+  if (null == e) return {};
+  var o,
+    r,
+    i = _objectWithoutPropertiesLoose(e, t);
+  if (Object.getOwnPropertySymbols) {
+    var n = Object.getOwnPropertySymbols(e);
+    for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
+  }
+  return i;
+}
+
 var SourcePath = zod.z.string().transform(function (path) {
   return path;
 });
 
+var _excluded = ["directory"];
+
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
 // Every field can carry `{ as: "inline" }`, and that is all a render says.
@@ -1008,11 +1032,35 @@ var ImageEncodeOption = zod.z.union([zod.z.literal(false), zod.z.object({
   maxWidth: zod.z.number().optional(),
   maxHeight: zod.z.number().optional()
 })]);
-var ImageOptions = zod.z.object({
-  directory: zod.z.string().optional(),
+/**
+ * Accept the pre-rename `directory` key and read it as `dir`.
+ *
+ * Serialized schemas are not only computed from live code: a commit record
+ * stores the schema each module was under (`StoredModuleVersion`), and the
+ * history view parses those back. Commits made before `directory` became `dir`
+ * therefore still carry the old key, and dropping it would show a historical
+ * gallery with no directory at all — silently, since the rest of the schema
+ * parses fine.
+ *
+ * Only fills `dir` when it is absent, so a schema carrying both (which should
+ * not happen) keeps the current key.
+ */
+var readLegacyDirectoryAsDir = function readLegacyDirectoryAsDir(value) {
+  if (!value || getSitemapTree._typeof(value) !== "object" || Array.isArray(value) || !("directory" in value) || "dir" in value) {
+    return value;
+  }
+  var _ref = value,
+    directory = _ref.directory,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, rest), {}, {
+    dir: directory
+  });
+};
+var ImageOptions = zod.z.preprocess(readLegacyDirectoryAsDir, zod.z.object({
+  dir: zod.z.string().optional(),
   accept: zod.z.string().optional(),
   encode: ImageEncodeOption.optional()
-});
+}));
 var SerializedImageSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
   type: zod.z.literal("image"),
   options: ImageOptions.optional(),
@@ -1051,7 +1099,7 @@ var SerializedRichTextSchema = zod.z.object(getSitemapTree._objectSpread2(getSit
   opt: zod.z["boolean"]()
 }));
 var SerializedRecordSchema = zod.z.lazy(function () {
-  return zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
+  return zod.z.preprocess(readLegacyDirectoryAsDir, zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
     type: zod.z.literal("record"),
     item: SerializedSchema,
     opt: zod.z["boolean"](),
@@ -1059,12 +1107,12 @@ var SerializedRecordSchema = zod.z.lazy(function () {
     mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images")]).optional(),
     // Optional legacy gallery metadata
     accept: zod.z.string().optional(),
-    directory: zod.z.string().optional(),
+    dir: zod.z.string().optional(),
     remote: zod.z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.any())).optional()
-  })).passthrough();
+  })).passthrough());
 });
 var SerializedKeyOfSchema = zod.z.lazy(function () {
   return zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
@@ -4704,7 +4752,7 @@ function getSourceAt(source, path) {
  * Walks `schema` along `path`, returning a structured result:
  * - `leaf`: walked the full path; resolved schema at the end.
  * - `richtext`: hit a richtext mid-walk; richtext is the resolved schema.
- * - `gallery-traversed`: hit an `s.images()` record and walked past it (i.e. the
+ * - `gallery-traversed`: hit an `s.imageset()` record and walked past it (i.e. the
  *   path tries to address an entry inside the gallery — a clue the AI should
  *   have used the gallery tool instead).
  * - `unresolved`: the path could not be walked.
@@ -4835,7 +4883,7 @@ function buildImageGalleryPatch(args, moduleSchema) {
     op: "add",
     path: [args.filePath],
     value: getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, args.metadata), {}, {
-      // `alt` is a REQUIRED field of a gallery entry (`s.images()` gives it a
+      // `alt` is a REQUIRED field of a gallery entry (`s.imageset()` gives it a
       // nullable string schema), so an entry written without one is invalid
       // the moment it lands — and the caller that had no alt to give is the
       // common case, not the odd one. Null is what the Studio's own upload
@@ -4898,10 +4946,10 @@ function buildRemoveImageGalleryEntryPatch(args, moduleSchema, moduleSource) {
 var GALLERY_REDIRECT = {
   kind: "wrong-tool",
   suggestedTool: "add_session_image_to_gallery",
-  reason: "Destination is a media gallery (s.images() / s.files()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
+  reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.images()` / `s.files()` record: a gallery, not an ordinary record. */
+/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }

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

@@ -897,10 +897,34 @@ var PatchBlock = zod.z.object({
   parentRef: ParentRef$1
 });
 
+function _objectWithoutPropertiesLoose(r, e) {
+  if (null == r) return {};
+  var t = {};
+  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
+    if (-1 !== e.indexOf(n)) continue;
+    t[n] = r[n];
+  }
+  return t;
+}
+
+function _objectWithoutProperties(e, t) {
+  if (null == e) return {};
+  var o,
+    r,
+    i = _objectWithoutPropertiesLoose(e, t);
+  if (Object.getOwnPropertySymbols) {
+    var n = Object.getOwnPropertySymbols(e);
+    for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
+  }
+  return i;
+}
+
 var SourcePath = zod.z.string().transform(function (path) {
   return path;
 });
 
+var _excluded = ["directory"];
+
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
 // Every field can carry `{ as: "inline" }`, and that is all a render says.
@@ -1008,11 +1032,35 @@ var ImageEncodeOption = zod.z.union([zod.z.literal(false), zod.z.object({
   maxWidth: zod.z.number().optional(),
   maxHeight: zod.z.number().optional()
 })]);
-var ImageOptions = zod.z.object({
-  directory: zod.z.string().optional(),
+/**
+ * Accept the pre-rename `directory` key and read it as `dir`.
+ *
+ * Serialized schemas are not only computed from live code: a commit record
+ * stores the schema each module was under (`StoredModuleVersion`), and the
+ * history view parses those back. Commits made before `directory` became `dir`
+ * therefore still carry the old key, and dropping it would show a historical
+ * gallery with no directory at all — silently, since the rest of the schema
+ * parses fine.
+ *
+ * Only fills `dir` when it is absent, so a schema carrying both (which should
+ * not happen) keeps the current key.
+ */
+var readLegacyDirectoryAsDir = function readLegacyDirectoryAsDir(value) {
+  if (!value || getSitemapTree._typeof(value) !== "object" || Array.isArray(value) || !("directory" in value) || "dir" in value) {
+    return value;
+  }
+  var _ref = value,
+    directory = _ref.directory,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, rest), {}, {
+    dir: directory
+  });
+};
+var ImageOptions = zod.z.preprocess(readLegacyDirectoryAsDir, zod.z.object({
+  dir: zod.z.string().optional(),
   accept: zod.z.string().optional(),
   encode: ImageEncodeOption.optional()
-});
+}));
 var SerializedImageSchema = zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
   type: zod.z.literal("image"),
   options: ImageOptions.optional(),
@@ -1051,7 +1099,7 @@ var SerializedRichTextSchema = zod.z.object(getSitemapTree._objectSpread2(getSit
   opt: zod.z["boolean"]()
 }));
 var SerializedRecordSchema = zod.z.lazy(function () {
-  return zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
+  return zod.z.preprocess(readLegacyDirectoryAsDir, zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
     type: zod.z.literal("record"),
     item: SerializedSchema,
     opt: zod.z["boolean"](),
@@ -1059,12 +1107,12 @@ var SerializedRecordSchema = zod.z.lazy(function () {
     mediaType: zod.z.union([zod.z.literal("files"), zod.z.literal("images")]).optional(),
     // Optional legacy gallery metadata
     accept: zod.z.string().optional(),
-    directory: zod.z.string().optional(),
+    dir: zod.z.string().optional(),
     remote: zod.z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.any())).optional()
-  })).passthrough();
+  })).passthrough());
 });
 var SerializedKeyOfSchema = zod.z.lazy(function () {
   return zod.z.object(getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, commonSchemaFields), {}, {
@@ -4704,7 +4752,7 @@ function getSourceAt(source, path) {
  * Walks `schema` along `path`, returning a structured result:
  * - `leaf`: walked the full path; resolved schema at the end.
  * - `richtext`: hit a richtext mid-walk; richtext is the resolved schema.
- * - `gallery-traversed`: hit an `s.images()` record and walked past it (i.e. the
+ * - `gallery-traversed`: hit an `s.imageset()` record and walked past it (i.e. the
  *   path tries to address an entry inside the gallery — a clue the AI should
  *   have used the gallery tool instead).
  * - `unresolved`: the path could not be walked.
@@ -4835,7 +4883,7 @@ function buildImageGalleryPatch(args, moduleSchema) {
     op: "add",
     path: [args.filePath],
     value: getSitemapTree._objectSpread2(getSitemapTree._objectSpread2({}, args.metadata), {}, {
-      // `alt` is a REQUIRED field of a gallery entry (`s.images()` gives it a
+      // `alt` is a REQUIRED field of a gallery entry (`s.imageset()` gives it a
       // nullable string schema), so an entry written without one is invalid
       // the moment it lands — and the caller that had no alt to give is the
       // common case, not the odd one. Null is what the Studio's own upload
@@ -4898,10 +4946,10 @@ function buildRemoveImageGalleryEntryPatch(args, moduleSchema, moduleSource) {
 var GALLERY_REDIRECT = {
   kind: "wrong-tool",
   suggestedTool: "add_session_image_to_gallery",
-  reason: "Destination is a media gallery (s.images() / s.files()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
+  reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.images()` / `s.files()` record: a gallery, not an ordinary record. */
+/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }

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

@@ -1,6 +1,6 @@
 import { Internal, CODE_LANGUAGES, resolveSettingsModule, missingDeclaredKeys, localeOfValue, discriminatedUnionBranchOf, DEFAULT_COLOR_FORMAT, declaredKeySetOf } from '@valbuild/core';
-import { _ as _createForOfIteratorHelper, n as _objectSpread2, o as _arrayLikeToArray, q as _unsupportedIterableToArray, r as _defineProperty, s as _typeof } from '../../dist/getSitemapTree-a6cb37cb.esm.js';
-export { 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, g as getNextAppRouterSourceFolder, l as getPageRouterSitemapTree, j as getPageRouterSourceFolder, m as getPatternFromModuleFilePath, h as getTanStackRouterSourceFolder, k as isTanStackRoutesFolder, f as isValCanvasFrame, i as isValCanvasPageMessage, e as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-a6cb37cb.esm.js';
+import { _ as _createForOfIteratorHelper, n as _objectSpread2, o as _arrayLikeToArray, q as _unsupportedIterableToArray, r as _typeof, s as _defineProperty } from '../../dist/getSitemapTree-6777bdfa.esm.js';
+export { 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, g as getNextAppRouterSourceFolder, l as getPageRouterSitemapTree, j as getPageRouterSourceFolder, m as getPatternFromModuleFilePath, h as getTanStackRouterSourceFolder, k as isTanStackRoutesFolder, f as isValCanvasFrame, i as isValCanvasPageMessage, e as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-6777bdfa.esm.js';
 import { z } from 'zod';
 import { fromError } from 'zod-validation-error';
 import FlexSearch from 'flexsearch';
@@ -890,10 +890,34 @@ var PatchBlock = z.object({
   parentRef: ParentRef$1
 });
 
+function _objectWithoutPropertiesLoose(r, e) {
+  if (null == r) return {};
+  var t = {};
+  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
+    if (-1 !== e.indexOf(n)) continue;
+    t[n] = r[n];
+  }
+  return t;
+}
+
+function _objectWithoutProperties(e, t) {
+  if (null == e) return {};
+  var o,
+    r,
+    i = _objectWithoutPropertiesLoose(e, t);
+  if (Object.getOwnPropertySymbols) {
+    var n = Object.getOwnPropertySymbols(e);
+    for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
+  }
+  return i;
+}
+
 var SourcePath = z.string().transform(function (path) {
   return path;
 });
 
+var _excluded = ["directory"];
+
 // A render is static config, so unlike a `preview` it travels WHOLE — this
 // is the field the editor reads the layout from. See `core/src/render.ts`.
 // Every field can carry `{ as: "inline" }`, and that is all a render says.
@@ -1001,11 +1025,35 @@ var ImageEncodeOption = z.union([z.literal(false), z.object({
   maxWidth: z.number().optional(),
   maxHeight: z.number().optional()
 })]);
-var ImageOptions = z.object({
-  directory: z.string().optional(),
+/**
+ * Accept the pre-rename `directory` key and read it as `dir`.
+ *
+ * Serialized schemas are not only computed from live code: a commit record
+ * stores the schema each module was under (`StoredModuleVersion`), and the
+ * history view parses those back. Commits made before `directory` became `dir`
+ * therefore still carry the old key, and dropping it would show a historical
+ * gallery with no directory at all — silently, since the rest of the schema
+ * parses fine.
+ *
+ * Only fills `dir` when it is absent, so a schema carrying both (which should
+ * not happen) keeps the current key.
+ */
+var readLegacyDirectoryAsDir = function readLegacyDirectoryAsDir(value) {
+  if (!value || _typeof(value) !== "object" || Array.isArray(value) || !("directory" in value) || "dir" in value) {
+    return value;
+  }
+  var _ref = value,
+    directory = _ref.directory,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return _objectSpread2(_objectSpread2({}, rest), {}, {
+    dir: directory
+  });
+};
+var ImageOptions = z.preprocess(readLegacyDirectoryAsDir, z.object({
+  dir: z.string().optional(),
   accept: z.string().optional(),
   encode: ImageEncodeOption.optional()
-});
+}));
 var SerializedImageSchema = z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
   type: z.literal("image"),
   options: ImageOptions.optional(),
@@ -1044,7 +1092,7 @@ var SerializedRichTextSchema = z.object(_objectSpread2(_objectSpread2({}, common
   opt: z["boolean"]()
 }));
 var SerializedRecordSchema = z.lazy(function () {
-  return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
+  return z.preprocess(readLegacyDirectoryAsDir, z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
     type: z.literal("record"),
     item: SerializedSchema,
     opt: z["boolean"](),
@@ -1052,12 +1100,12 @@ var SerializedRecordSchema = z.lazy(function () {
     mediaType: z.union([z.literal("files"), z.literal("images")]).optional(),
     // Optional legacy gallery metadata
     accept: z.string().optional(),
-    directory: z.string().optional(),
+    dir: z.string().optional(),
     remote: z["boolean"]().optional(),
     encode: ImageEncodeOption.optional(),
     alt: SerializedSchema.optional(),
     moduleMetadata: z.record(z.string(), z.record(z.string(), z.any())).optional()
-  })).passthrough();
+  })).passthrough());
 });
 var SerializedKeyOfSchema = z.lazy(function () {
   return z.object(_objectSpread2(_objectSpread2({}, commonSchemaFields), {}, {
@@ -4697,7 +4745,7 @@ function getSourceAt(source, path) {
  * Walks `schema` along `path`, returning a structured result:
  * - `leaf`: walked the full path; resolved schema at the end.
  * - `richtext`: hit a richtext mid-walk; richtext is the resolved schema.
- * - `gallery-traversed`: hit an `s.images()` record and walked past it (i.e. the
+ * - `gallery-traversed`: hit an `s.imageset()` record and walked past it (i.e. the
  *   path tries to address an entry inside the gallery — a clue the AI should
  *   have used the gallery tool instead).
  * - `unresolved`: the path could not be walked.
@@ -4828,7 +4876,7 @@ function buildImageGalleryPatch(args, moduleSchema) {
     op: "add",
     path: [args.filePath],
     value: _objectSpread2(_objectSpread2({}, args.metadata), {}, {
-      // `alt` is a REQUIRED field of a gallery entry (`s.images()` gives it a
+      // `alt` is a REQUIRED field of a gallery entry (`s.imageset()` gives it a
       // nullable string schema), so an entry written without one is invalid
       // the moment it lands — and the caller that had no alt to give is the
       // common case, not the odd one. Null is what the Studio's own upload
@@ -4891,10 +4939,10 @@ function buildRemoveImageGalleryEntryPatch(args, moduleSchema, moduleSource) {
 var GALLERY_REDIRECT = {
   kind: "wrong-tool",
   suggestedTool: "add_session_image_to_gallery",
-  reason: "Destination is a media gallery (s.images() / s.files()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
+  reason: "Destination is a media gallery (s.imageset() / s.fileset()). Gallery entries are keyed by file path and carry a file on disk, so they cannot be created with a plain patch. Use add_session_image_to_gallery."
 };
 
-/** An `s.images()` / `s.files()` record: a gallery, not an ordinary record. */
+/** An `s.imageset()` / `s.fileset()` record: a gallery, not an ordinary record. */
 function isGallery(schema) {
   return schema.type === "record" && schema.mediaType !== undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.127.0",
+  "version": "0.128.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
@@ -37,7 +37,7 @@
     "flexsearch": "^0.8.212",
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.127.0"
+    "@valbuild/core": "0.128.0"
   },
   "files": [
     "CHANGELOG.md",