@valbuild/core 0.88.0 → 0.89.0

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

@@ -48,6 +48,7 @@ export { type SerializedImageSchema, ImageSchema } from "./schema/image.js";
 export { type SerializedFileSchema, FileSchema } from "./schema/file.js";
 export { type SerializedDateSchema, DateSchema } from "./schema/date.js";
 export { type SerializedKeyOfSchema, KeyOfSchema } from "./schema/keyOf.js";
+export { type SerializedRouteSchema, RouteSchema } from "./schema/route.js";
 export { type SerializedRichTextSchema, RichTextSchema, } from "./schema/richtext.js";
 export { type SerializedUnionSchema, UnionSchema, type SerializedStringUnionSchema, type SerializedObjectUnionSchema, } from "./schema/union.js";
 export { type SerializedLiteralSchema, LiteralSchema } from "./schema/literal.js";

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

@@ -11,6 +11,8 @@ import { keyOf } from "./schema/keyOf.js";
 import { record } from "./schema/record.js";
 import { file } from "./schema/file.js";
 import { date } from "./schema/date.js";
+import { route } from "./schema/route.js";
+import { router } from "./schema/router.js";
 export type InitSchema = {
     /**
      * Define a string.
@@ -156,6 +158,43 @@ export type InitSchema = {
      *
      */
     readonly date: typeof date;
+    /**
+     * Define a string that references a route path in your application.
+     *
+     * To create router pages you can use the s.router() function.
+     *
+     * @example
+     * ```typescript
+     * const schema = s.route();
+     * export default c.define("/example.val.ts", schema, "/a-page-slug");
+     * ```
+     */
+    readonly route: typeof route;
+    /**
+     * Create a page router.
+     * Each key is the path of the page.
+     *
+     * The router will be used to validate the paths of the pages.
+     *
+     * If you need to link to these pages you can use the s.route() to reference page paths.
+     *
+     * @example Next.js App Router
+     * ```typescript
+     * import { s, c, nextAppRouter } from "../val.config";
+     * const schema = s.object({
+     *   title: s.string(),
+     * });
+     * export default c.define("/app/[slug]/page.val.ts", s.router(nextAppRouter, schema), {
+     *   "/a-page-slug": { title: "First Page" },
+     *   "/another-page-slug": { title: "Second Page" },
+     * });
+     * ```
+     *
+     * @param router - The router configuration (e.g., nextAppRouter)
+     * @param schema - The schema for each route item
+     * @returns A RecordSchema configured as a router
+     */
+    readonly router: typeof router;
 };
 export declare function initSchema(): {
     string: <T extends string>(options?: Record<string, never> | undefined) => import("./schema/string.js").StringSchema<T>;
@@ -214,4 +253,6 @@ export declare function initSchema(): {
     record: typeof record;
     file: (options?: import("./schema/file.js").FileOptions | undefined) => import("./schema/file.js").FileSchema<import("./index.js").FileSource<import("./schema/file.js").FileMetadata>>;
     date: (options?: Record<string, never> | undefined) => import("./schema/date.js").DateSchema<import("./schema/string.js").RawString>;
+    route: <T_3 extends string>(options?: Record<string, never> | undefined) => import("./schema/route.js").RouteSchema<T_3>;
+    router: typeof router;
 };

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

@@ -13,11 +13,12 @@ import { SerializedRichTextSchema } from "./richtext.js";
 import { RawString, SerializedStringSchema } from "./string.js";
 import { SerializedUnionSchema } from "./union.js";
 import { SerializedDateSchema } from "./date.js";
+import { SerializedRouteSchema } from "./route.js";
 import { ValidationError, ValidationErrors } from "./validation/ValidationError.js";
 import { FileSource } from "../source/file.js";
 import { GenericRichTextSourceNode, RichTextSource } from "../source/richtext.js";
 import { ReifiedRender } from "../render.js";
-export type SerializedSchema = SerializedStringSchema | SerializedLiteralSchema | SerializedBooleanSchema | SerializedNumberSchema | SerializedObjectSchema | SerializedArraySchema | SerializedUnionSchema | SerializedRichTextSchema | SerializedRecordSchema | SerializedKeyOfSchema | SerializedFileSchema | SerializedDateSchema | SerializedImageSchema;
+export type SerializedSchema = SerializedStringSchema | SerializedLiteralSchema | SerializedBooleanSchema | SerializedNumberSchema | SerializedObjectSchema | SerializedArraySchema | SerializedUnionSchema | SerializedRichTextSchema | SerializedRecordSchema | SerializedKeyOfSchema | SerializedFileSchema | SerializedDateSchema | SerializedRouteSchema | SerializedImageSchema;
 type Primitives = number | string | boolean | null | FileSource;
 export type AssertError = {
     message: string;

package/dist/declarations/src/schema/route.d.ts

@@ -0,0 +1,64 @@
+import { Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
+import { SourcePath } from "../val/index.js";
+import { ReifiedRender } from "../render.js";
+import { ValidationErrors } from "./validation/ValidationError.js";
+type RouteOptions = {
+    include?: RegExp;
+    exclude?: RegExp;
+};
+export type SerializedRouteSchema = {
+    type: "route";
+    options?: {
+        include?: {
+            source: string;
+            flags: string;
+        };
+        exclude?: {
+            source: string;
+            flags: string;
+        };
+        customValidate?: boolean;
+    };
+    opt: boolean;
+    customValidate?: boolean;
+};
+export declare class RouteSchema<Src extends string | null> extends Schema<Src> {
+    private readonly options?;
+    private readonly opt;
+    private readonly customValidateFunctions;
+    constructor(options?: RouteOptions | undefined, opt?: boolean, customValidateFunctions?: ((src: Src) => false | string)[]);
+    /**
+     * Specify a pattern for which routes are allowed.
+     *
+     * Semantics:
+     * - If only include is set: route must match include pattern
+     * - If only exclude is set: route must NOT match exclude pattern
+     * - If both are set: route must match include AND must NOT match exclude
+     *
+     * @example
+     * s.route().include(/^\/(home|about|contact)$/)  // Only these specific routes
+     * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+     */
+    include(pattern: RegExp): RouteSchema<Src>;
+    /**
+     * Specify a pattern for which routes should be excluded.
+     *
+     * Semantics:
+     * - If only include is set: route must match include pattern
+     * - If only exclude is set: route must NOT match exclude pattern
+     * - If both are set: route must match include AND must NOT match exclude
+     *
+     * @example
+     * s.route().exclude(/^\/admin/)  // Exclude all admin routes
+     * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+     */
+    exclude(pattern: RegExp): RouteSchema<Src>;
+    validate(validationFunction: (src: Src) => false | string): RouteSchema<Src>;
+    protected executeValidate(path: SourcePath, src: Src): ValidationErrors;
+    protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
+    nullable(): RouteSchema<Src | null>;
+    protected executeSerialize(): SerializedSchema;
+    protected executeRender(): ReifiedRender;
+}
+export declare const route: <T extends string>(options?: Record<string, never>) => RouteSchema<T>;
+export {};

package/dist/declarations/src/schema/router.d.ts

@@ -0,0 +1,5 @@
+import { Schema, SelectorOfSchema } from "./index.js";
+import { ValRouter } from "../router.js";
+import { SelectorSource } from "../selector/index.js";
+import { RecordSchema } from "./record.js";
+export declare function router<T extends Schema<SelectorSource>, Src extends Record<string, SelectorOfSchema<T>>>(router: ValRouter, item: T): RecordSchema<T, Schema<string>, Src>;

package/dist/declarations/src/schema/validation/ValidationFix.d.ts

@@ -1,2 +1,2 @@
-export declare const ValidationFix: readonly ["image:change-extension", "image:add-metadata", "image:check-metadata", "image:upload-remote", "image:download-remote", "image:check-remote", "file:change-extension", "file:add-metadata", "file:check-metadata", "file:upload-remote", "file:download-remote", "file:check-remote", "keyof:check-keys"];
+export declare const ValidationFix: readonly ["image:add-metadata", "image:check-metadata", "image:upload-remote", "image:download-remote", "image:check-remote", "file:add-metadata", "file:check-metadata", "file:upload-remote", "file:download-remote", "file:check-remote", "keyof:check-keys", "router:check-route"];
 export type ValidationFix = (typeof ValidationFix)[number];

package/dist/{index-eb1a6b1f.cjs.dev.js → index-3f815afd.cjs.dev.js}

@@ -447,8 +447,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "File did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -458,8 +457,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (accept && mimeType && !mimeType.includes("/")) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Invalid mime type format. Got: ".concat(mimeType),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (accept && mimeType && mimeType.includes("/")) {
@@ -479,8 +477,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
         if (!isValidMimeType) {
           return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
             message: "Mime type mismatch. Found '".concat(mimeType, "' but schema accepts '").concat(accept, "'"),
-            value: src,
-            fixes: ["file:change-extension", "file:check-metadata"]
+            value: src
           }]));
         }
       }
@@ -488,15 +485,13 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (!fileMimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Could not determine mime type from file extension. Got: ".concat(src[FILE_REF_PROP]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (fileMimeType !== mimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Mime type and file extension not matching. Mime type is '".concat(mimeType, "' but file extension is '").concat(fileMimeType, "'"),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (src.metadata) {
@@ -1785,8 +1780,7 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Image did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["image:change-extension", "image:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -3762,6 +3756,157 @@ var date = function date(options) {
   return new DateSchema(options);
 };
 
+var RouteSchema = /*#__PURE__*/function (_Schema) {
+  function RouteSchema(options) {
+    var _this;
+    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var customValidateFunctions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+    _classCallCheck(this, RouteSchema);
+    _this = _callSuper(this, RouteSchema);
+    _this.options = options;
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    return _this;
+  }
+
+  /**
+   * Specify a pattern for which routes are allowed.
+   *
+   * Semantics:
+   * - If only include is set: route must match include pattern
+   * - If only exclude is set: route must NOT match exclude pattern
+   * - If both are set: route must match include AND must NOT match exclude
+   *
+   * @example
+   * s.route().include(/^\/(home|about|contact)$/)  // Only these specific routes
+   * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+   */
+  _inherits(RouteSchema, _Schema);
+  return _createClass(RouteSchema, [{
+    key: "include",
+    value: function include(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        include: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+
+    /**
+     * Specify a pattern for which routes should be excluded.
+     *
+     * Semantics:
+     * - If only include is set: route must match include pattern
+     * - If only exclude is set: route must NOT match exclude pattern
+     * - If both are set: route must match include AND must NOT match exclude
+     *
+     * @example
+     * s.route().exclude(/^\/admin/)  // Exclude all admin routes
+     * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+     */
+  }, {
+    key: "exclude",
+    value: function exclude(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        exclude: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+  }, {
+    key: "validate",
+    value: function validate(validationFunction) {
+      return new RouteSchema(this.options, this.opt, this.customValidateFunctions.concat(validationFunction));
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      var _this$options, _this$options2;
+      var customValidationErrors = this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+      if (this.opt && (src === null || src === undefined)) {
+        return customValidationErrors.length > 0 ? _defineProperty({}, path, customValidationErrors) : false;
+      }
+      if (typeof src !== "string") {
+        return _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          value: src
+        }]);
+      }
+      return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
+        fixes: ["router:check-route"],
+        message: "Did not validate route (router). This error (router:check-route) should typically be processed by Val internally. Seeing this error most likely means you have a Val version mismatch.",
+        value: {
+          route: src,
+          sourcePath: path,
+          include: (_this$options = this.options) === null || _this$options === void 0 ? void 0 : _this$options.include,
+          exclude: (_this$options2 = this.options) === null || _this$options2 === void 0 ? void 0 : _this$options2.exclude
+        }
+      }]));
+    }
+  }, {
+    key: "executeAssert",
+    value: function executeAssert(path, src) {
+      if (this.opt && src === null) {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      if (typeof src === "string") {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      return {
+        success: false,
+        errors: _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          typeError: true
+        }])
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new RouteSchema(this.options, true, this.customValidateFunctions);
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      var _this$options3, _this$options4, _this$customValidateF, _this$customValidateF2;
+      return {
+        type: "route",
+        options: {
+          include: ((_this$options3 = this.options) === null || _this$options3 === void 0 ? void 0 : _this$options3.include) && {
+            source: this.options.include.source,
+            flags: this.options.include.flags
+          },
+          exclude: ((_this$options4 = this.options) === null || _this$options4 === void 0 ? void 0 : _this$options4.exclude) && {
+            source: this.options.exclude.source,
+            flags: this.options.exclude.flags
+          },
+          customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0
+        },
+        opt: this.opt,
+        customValidate: this.customValidateFunctions && ((_this$customValidateF2 = this.customValidateFunctions) === null || _this$customValidateF2 === void 0 ? void 0 : _this$customValidateF2.length) > 0
+      };
+    }
+  }, {
+    key: "executeRender",
+    value: function executeRender() {
+      return {};
+    }
+  }]);
+}(Schema);
+var route = function route(options) {
+  return new RouteSchema(options);
+};
+
+function router(router, item) {
+  var keySchema = string();
+  var recordSchema = new RecordSchema(item, false, [], router, keySchema);
+  return recordSchema;
+}
+
 // import type { F } from "ts-toolbelt";
 // import { i18n, I18n } from "./schema/future/i18n";
 // import { oneOf } from "./schema/future/oneOf";
@@ -3785,7 +3930,9 @@ function initSchema() {
     keyOf: keyOf,
     record: record,
     file: file,
-    date: date
+    date: date,
+    route: route,
+    router: router
     // i18n: i18n(locales),
   };
 }
@@ -5239,6 +5386,14 @@ function deserializeSchema(serialized) {
       return new RecordSchema(deserializeSchema(serialized.item), serialized.opt, [], null, serialized.key ? deserializeSchema(serialized.key) : null);
     case "keyOf":
       return new KeyOfSchema(serialized.schema, serialized.path, serialized.opt);
+    case "route":
+      {
+        var routeOptions = serialized.options ? {
+          include: serialized.options.include ? new RegExp(serialized.options.include.source, serialized.options.include.flags) : undefined,
+          exclude: serialized.options.exclude ? new RegExp(serialized.options.exclude.source, serialized.options.exclude.flags) : undefined
+        } : undefined;
+        return new RouteSchema(routeOptions, serialized.opt);
+      }
     case "file":
       return new FileSchema(serialized.options, serialized.opt);
     case "image":
@@ -5568,6 +5723,7 @@ exports.ObjectSchema = ObjectSchema;
 exports.PatchError = PatchError;
 exports.RecordSchema = RecordSchema;
 exports.RichTextSchema = RichTextSchema;
+exports.RouteSchema = RouteSchema;
 exports.Schema = Schema;
 exports.StringSchema = StringSchema;
 exports.UnionSchema = UnionSchema;

package/dist/{index-11591a0b.esm.js → index-52848948.esm.js}

@@ -445,8 +445,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "File did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -456,8 +455,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (accept && mimeType && !mimeType.includes("/")) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Invalid mime type format. Got: ".concat(mimeType),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (accept && mimeType && mimeType.includes("/")) {
@@ -477,8 +475,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
         if (!isValidMimeType) {
           return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
             message: "Mime type mismatch. Found '".concat(mimeType, "' but schema accepts '").concat(accept, "'"),
-            value: src,
-            fixes: ["file:change-extension", "file:check-metadata"]
+            value: src
           }]));
         }
       }
@@ -486,15 +483,13 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (!fileMimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Could not determine mime type from file extension. Got: ".concat(src[FILE_REF_PROP]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (fileMimeType !== mimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Mime type and file extension not matching. Mime type is '".concat(mimeType, "' but file extension is '").concat(fileMimeType, "'"),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (src.metadata) {
@@ -1783,8 +1778,7 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Image did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["image:change-extension", "image:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -3760,6 +3754,157 @@ var date = function date(options) {
   return new DateSchema(options);
 };
 
+var RouteSchema = /*#__PURE__*/function (_Schema) {
+  function RouteSchema(options) {
+    var _this;
+    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var customValidateFunctions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+    _classCallCheck(this, RouteSchema);
+    _this = _callSuper(this, RouteSchema);
+    _this.options = options;
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    return _this;
+  }
+
+  /**
+   * Specify a pattern for which routes are allowed.
+   *
+   * Semantics:
+   * - If only include is set: route must match include pattern
+   * - If only exclude is set: route must NOT match exclude pattern
+   * - If both are set: route must match include AND must NOT match exclude
+   *
+   * @example
+   * s.route().include(/^\/(home|about|contact)$/)  // Only these specific routes
+   * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+   */
+  _inherits(RouteSchema, _Schema);
+  return _createClass(RouteSchema, [{
+    key: "include",
+    value: function include(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        include: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+
+    /**
+     * Specify a pattern for which routes should be excluded.
+     *
+     * Semantics:
+     * - If only include is set: route must match include pattern
+     * - If only exclude is set: route must NOT match exclude pattern
+     * - If both are set: route must match include AND must NOT match exclude
+     *
+     * @example
+     * s.route().exclude(/^\/admin/)  // Exclude all admin routes
+     * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+     */
+  }, {
+    key: "exclude",
+    value: function exclude(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        exclude: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+  }, {
+    key: "validate",
+    value: function validate(validationFunction) {
+      return new RouteSchema(this.options, this.opt, this.customValidateFunctions.concat(validationFunction));
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      var _this$options, _this$options2;
+      var customValidationErrors = this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+      if (this.opt && (src === null || src === undefined)) {
+        return customValidationErrors.length > 0 ? _defineProperty({}, path, customValidationErrors) : false;
+      }
+      if (typeof src !== "string") {
+        return _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          value: src
+        }]);
+      }
+      return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
+        fixes: ["router:check-route"],
+        message: "Did not validate route (router). This error (router:check-route) should typically be processed by Val internally. Seeing this error most likely means you have a Val version mismatch.",
+        value: {
+          route: src,
+          sourcePath: path,
+          include: (_this$options = this.options) === null || _this$options === void 0 ? void 0 : _this$options.include,
+          exclude: (_this$options2 = this.options) === null || _this$options2 === void 0 ? void 0 : _this$options2.exclude
+        }
+      }]));
+    }
+  }, {
+    key: "executeAssert",
+    value: function executeAssert(path, src) {
+      if (this.opt && src === null) {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      if (typeof src === "string") {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      return {
+        success: false,
+        errors: _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          typeError: true
+        }])
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new RouteSchema(this.options, true, this.customValidateFunctions);
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      var _this$options3, _this$options4, _this$customValidateF, _this$customValidateF2;
+      return {
+        type: "route",
+        options: {
+          include: ((_this$options3 = this.options) === null || _this$options3 === void 0 ? void 0 : _this$options3.include) && {
+            source: this.options.include.source,
+            flags: this.options.include.flags
+          },
+          exclude: ((_this$options4 = this.options) === null || _this$options4 === void 0 ? void 0 : _this$options4.exclude) && {
+            source: this.options.exclude.source,
+            flags: this.options.exclude.flags
+          },
+          customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0
+        },
+        opt: this.opt,
+        customValidate: this.customValidateFunctions && ((_this$customValidateF2 = this.customValidateFunctions) === null || _this$customValidateF2 === void 0 ? void 0 : _this$customValidateF2.length) > 0
+      };
+    }
+  }, {
+    key: "executeRender",
+    value: function executeRender() {
+      return {};
+    }
+  }]);
+}(Schema);
+var route = function route(options) {
+  return new RouteSchema(options);
+};
+
+function router(router, item) {
+  var keySchema = string();
+  var recordSchema = new RecordSchema(item, false, [], router, keySchema);
+  return recordSchema;
+}
+
 // import type { F } from "ts-toolbelt";
 // import { i18n, I18n } from "./schema/future/i18n";
 // import { oneOf } from "./schema/future/oneOf";
@@ -3783,7 +3928,9 @@ function initSchema() {
     keyOf: keyOf,
     record: record,
     file: file,
-    date: date
+    date: date,
+    route: route,
+    router: router
     // i18n: i18n(locales),
   };
 }
@@ -5237,6 +5384,14 @@ function deserializeSchema(serialized) {
       return new RecordSchema(deserializeSchema(serialized.item), serialized.opt, [], null, serialized.key ? deserializeSchema(serialized.key) : null);
     case "keyOf":
       return new KeyOfSchema(serialized.schema, serialized.path, serialized.opt);
+    case "route":
+      {
+        var routeOptions = serialized.options ? {
+          include: serialized.options.include ? new RegExp(serialized.options.include.source, serialized.options.include.flags) : undefined,
+          exclude: serialized.options.exclude ? new RegExp(serialized.options.exclude.source, serialized.options.exclude.flags) : undefined
+        } : undefined;
+        return new RouteSchema(routeOptions, serialized.opt);
+      }
     case "file":
       return new FileSchema(serialized.options, serialized.opt);
     case "image":
@@ -5545,4 +5700,4 @@ function tryJsonParse(str) {
   }
 }
 
-export { ArraySchema as A, BooleanSchema as B, DEFAULT_CONTENT_HOST as D, FATAL_ERROR_TYPES as F, GenericSelector as G, Internal as I, KeyOfSchema as K, LiteralSchema as L, ModuleFilePathSep as M, NumberSchema as N, ObjectSchema as O, PatchError as P, RecordSchema as R, Schema as S, UnionSchema as U, VAL_EXTENSION as V, _typeof as _, _slicedToArray as a, _createClass as b, _classCallCheck as c, _toConsumableArray as d, DEFAULT_APP_HOST as e, DEFAULT_VAL_REMOTE_HOST as f, FILE_REF_PROP as g, FILE_REF_SUBTYPE_TAG as h, initVal as i, derefPatch as j, StringSchema as k, ImageSchema as l, modules as m, FileSchema as n, DateSchema as o, RichTextSchema as p, deserializeSchema as q, splitModuleFilePathAndModulePath as s };
+export { ArraySchema as A, BooleanSchema as B, DEFAULT_CONTENT_HOST as D, FATAL_ERROR_TYPES as F, GenericSelector as G, Internal as I, KeyOfSchema as K, LiteralSchema as L, ModuleFilePathSep as M, NumberSchema as N, ObjectSchema as O, PatchError as P, RecordSchema as R, Schema as S, UnionSchema as U, VAL_EXTENSION as V, _typeof as _, _slicedToArray as a, _createClass as b, _classCallCheck as c, _toConsumableArray as d, DEFAULT_APP_HOST as e, DEFAULT_VAL_REMOTE_HOST as f, FILE_REF_PROP as g, FILE_REF_SUBTYPE_TAG as h, initVal as i, derefPatch as j, StringSchema as k, ImageSchema as l, modules as m, FileSchema as n, DateSchema as o, RouteSchema as p, RichTextSchema as q, deserializeSchema as r, splitModuleFilePathAndModulePath as s };

package/dist/{index-34063fba.cjs.prod.js → index-55f6a997.cjs.prod.js}

@@ -447,8 +447,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "File did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -458,8 +457,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (accept && mimeType && !mimeType.includes("/")) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Invalid mime type format. Got: ".concat(mimeType),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (accept && mimeType && mimeType.includes("/")) {
@@ -479,8 +477,7 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
         if (!isValidMimeType) {
           return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
             message: "Mime type mismatch. Found '".concat(mimeType, "' but schema accepts '").concat(accept, "'"),
-            value: src,
-            fixes: ["file:change-extension", "file:check-metadata"]
+            value: src
           }]));
         }
       }
@@ -488,15 +485,13 @@ var FileSchema = /*#__PURE__*/function (_Schema) {
       if (!fileMimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Could not determine mime type from file extension. Got: ".concat(src[FILE_REF_PROP]),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (fileMimeType !== mimeType) {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Mime type and file extension not matching. Mime type is '".concat(mimeType, "' but file extension is '").concat(fileMimeType, "'"),
-          value: src,
-          fixes: ["file:change-extension", "file:check-metadata"]
+          value: src
         }]));
       }
       if (src.metadata) {
@@ -1785,8 +1780,7 @@ var ImageSchema = /*#__PURE__*/function (_Schema) {
       if (src[VAL_EXTENSION] !== "file") {
         return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
           message: "Image did not have the valid file extension type. Got: ".concat(src[VAL_EXTENSION]),
-          value: src,
-          fixes: ["image:change-extension", "image:check-metadata"]
+          value: src
         }]));
       }
       var _ref8 = this.options || {},
@@ -3762,6 +3756,157 @@ var date = function date(options) {
   return new DateSchema(options);
 };
 
+var RouteSchema = /*#__PURE__*/function (_Schema) {
+  function RouteSchema(options) {
+    var _this;
+    var opt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var customValidateFunctions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+    _classCallCheck(this, RouteSchema);
+    _this = _callSuper(this, RouteSchema);
+    _this.options = options;
+    _this.opt = opt;
+    _this.customValidateFunctions = customValidateFunctions;
+    return _this;
+  }
+
+  /**
+   * Specify a pattern for which routes are allowed.
+   *
+   * Semantics:
+   * - If only include is set: route must match include pattern
+   * - If only exclude is set: route must NOT match exclude pattern
+   * - If both are set: route must match include AND must NOT match exclude
+   *
+   * @example
+   * s.route().include(/^\/(home|about|contact)$/)  // Only these specific routes
+   * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+   */
+  _inherits(RouteSchema, _Schema);
+  return _createClass(RouteSchema, [{
+    key: "include",
+    value: function include(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        include: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+
+    /**
+     * Specify a pattern for which routes should be excluded.
+     *
+     * Semantics:
+     * - If only include is set: route must match include pattern
+     * - If only exclude is set: route must NOT match exclude pattern
+     * - If both are set: route must match include AND must NOT match exclude
+     *
+     * @example
+     * s.route().exclude(/^\/admin/)  // Exclude all admin routes
+     * s.route().include(/^\/api\//).exclude(/^\/api\/internal\//)  // API routes except internal
+     */
+  }, {
+    key: "exclude",
+    value: function exclude(pattern) {
+      return new RouteSchema(_objectSpread2(_objectSpread2({}, this.options), {}, {
+        exclude: pattern
+      }), this.opt, this.customValidateFunctions);
+    }
+  }, {
+    key: "validate",
+    value: function validate(validationFunction) {
+      return new RouteSchema(this.options, this.opt, this.customValidateFunctions.concat(validationFunction));
+    }
+  }, {
+    key: "executeValidate",
+    value: function executeValidate(path, src) {
+      var _this$options, _this$options2;
+      var customValidationErrors = this.executeCustomValidateFunctions(src, this.customValidateFunctions, {
+        path: path
+      });
+      if (this.opt && (src === null || src === undefined)) {
+        return customValidationErrors.length > 0 ? _defineProperty({}, path, customValidationErrors) : false;
+      }
+      if (typeof src !== "string") {
+        return _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          value: src
+        }]);
+      }
+      return _defineProperty({}, path, [].concat(_toConsumableArray(customValidationErrors), [{
+        fixes: ["router:check-route"],
+        message: "Did not validate route (router). This error (router:check-route) should typically be processed by Val internally. Seeing this error most likely means you have a Val version mismatch.",
+        value: {
+          route: src,
+          sourcePath: path,
+          include: (_this$options = this.options) === null || _this$options === void 0 ? void 0 : _this$options.include,
+          exclude: (_this$options2 = this.options) === null || _this$options2 === void 0 ? void 0 : _this$options2.exclude
+        }
+      }]));
+    }
+  }, {
+    key: "executeAssert",
+    value: function executeAssert(path, src) {
+      if (this.opt && src === null) {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      if (typeof src === "string") {
+        return {
+          success: true,
+          data: src
+        };
+      }
+      return {
+        success: false,
+        errors: _defineProperty({}, path, [{
+          message: "Expected 'string', got '".concat(_typeof(src), "'"),
+          typeError: true
+        }])
+      };
+    }
+  }, {
+    key: "nullable",
+    value: function nullable() {
+      return new RouteSchema(this.options, true, this.customValidateFunctions);
+    }
+  }, {
+    key: "executeSerialize",
+    value: function executeSerialize() {
+      var _this$options3, _this$options4, _this$customValidateF, _this$customValidateF2;
+      return {
+        type: "route",
+        options: {
+          include: ((_this$options3 = this.options) === null || _this$options3 === void 0 ? void 0 : _this$options3.include) && {
+            source: this.options.include.source,
+            flags: this.options.include.flags
+          },
+          exclude: ((_this$options4 = this.options) === null || _this$options4 === void 0 ? void 0 : _this$options4.exclude) && {
+            source: this.options.exclude.source,
+            flags: this.options.exclude.flags
+          },
+          customValidate: this.customValidateFunctions && ((_this$customValidateF = this.customValidateFunctions) === null || _this$customValidateF === void 0 ? void 0 : _this$customValidateF.length) > 0
+        },
+        opt: this.opt,
+        customValidate: this.customValidateFunctions && ((_this$customValidateF2 = this.customValidateFunctions) === null || _this$customValidateF2 === void 0 ? void 0 : _this$customValidateF2.length) > 0
+      };
+    }
+  }, {
+    key: "executeRender",
+    value: function executeRender() {
+      return {};
+    }
+  }]);
+}(Schema);
+var route = function route(options) {
+  return new RouteSchema(options);
+};
+
+function router(router, item) {
+  var keySchema = string();
+  var recordSchema = new RecordSchema(item, false, [], router, keySchema);
+  return recordSchema;
+}
+
 // import type { F } from "ts-toolbelt";
 // import { i18n, I18n } from "./schema/future/i18n";
 // import { oneOf } from "./schema/future/oneOf";
@@ -3785,7 +3930,9 @@ function initSchema() {
     keyOf: keyOf,
     record: record,
     file: file,
-    date: date
+    date: date,
+    route: route,
+    router: router
     // i18n: i18n(locales),
   };
 }
@@ -5239,6 +5386,14 @@ function deserializeSchema(serialized) {
       return new RecordSchema(deserializeSchema(serialized.item), serialized.opt, [], null, serialized.key ? deserializeSchema(serialized.key) : null);
     case "keyOf":
       return new KeyOfSchema(serialized.schema, serialized.path, serialized.opt);
+    case "route":
+      {
+        var routeOptions = serialized.options ? {
+          include: serialized.options.include ? new RegExp(serialized.options.include.source, serialized.options.include.flags) : undefined,
+          exclude: serialized.options.exclude ? new RegExp(serialized.options.exclude.source, serialized.options.exclude.flags) : undefined
+        } : undefined;
+        return new RouteSchema(routeOptions, serialized.opt);
+      }
     case "file":
       return new FileSchema(serialized.options, serialized.opt);
     case "image":
@@ -5568,6 +5723,7 @@ exports.ObjectSchema = ObjectSchema;
 exports.PatchError = PatchError;
 exports.RecordSchema = RecordSchema;
 exports.RichTextSchema = RichTextSchema;
+exports.RouteSchema = RouteSchema;
 exports.Schema = Schema;
 exports.StringSchema = StringSchema;
 exports.UnionSchema = UnionSchema;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-eb1a6b1f.cjs.dev.js');
+var dist_valbuildCore = require('./index-3f815afd.cjs.dev.js');
 require('./result-bb1f436e.cjs.dev.js');
 
 
@@ -27,6 +27,7 @@ exports.NumberSchema = dist_valbuildCore.NumberSchema;
 exports.ObjectSchema = dist_valbuildCore.ObjectSchema;
 exports.RecordSchema = dist_valbuildCore.RecordSchema;
 exports.RichTextSchema = dist_valbuildCore.RichTextSchema;
+exports.RouteSchema = dist_valbuildCore.RouteSchema;
 exports.Schema = dist_valbuildCore.Schema;
 exports.StringSchema = dist_valbuildCore.StringSchema;
 exports.UnionSchema = dist_valbuildCore.UnionSchema;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dist_valbuildCore = require('./index-34063fba.cjs.prod.js');
+var dist_valbuildCore = require('./index-55f6a997.cjs.prod.js');
 require('./result-787e35f6.cjs.prod.js');
 
 
@@ -27,6 +27,7 @@ exports.NumberSchema = dist_valbuildCore.NumberSchema;
 exports.ObjectSchema = dist_valbuildCore.ObjectSchema;
 exports.RecordSchema = dist_valbuildCore.RecordSchema;
 exports.RichTextSchema = dist_valbuildCore.RichTextSchema;
+exports.RouteSchema = dist_valbuildCore.RouteSchema;
 exports.Schema = dist_valbuildCore.Schema;
 exports.StringSchema = dist_valbuildCore.StringSchema;
 exports.UnionSchema = dist_valbuildCore.UnionSchema;

package/dist/valbuild-core.esm.js

@@ -1,2 +1,2 @@
-export { A as ArraySchema, B as BooleanSchema, e as DEFAULT_APP_HOST, D as DEFAULT_CONTENT_HOST, f as DEFAULT_VAL_REMOTE_HOST, o as DateSchema, F as FATAL_ERROR_TYPES, g as FILE_REF_PROP, h as FILE_REF_SUBTYPE_TAG, n as FileSchema, G as GenericSelector, l as ImageSchema, I as Internal, K as KeyOfSchema, L as LiteralSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, p as RichTextSchema, S as Schema, k as StringSchema, U as UnionSchema, V as VAL_EXTENSION, j as derefPatch, q as deserializeSchema, i as initVal, m as modules } from './index-11591a0b.esm.js';
+export { A as ArraySchema, B as BooleanSchema, e as DEFAULT_APP_HOST, D as DEFAULT_CONTENT_HOST, f as DEFAULT_VAL_REMOTE_HOST, o as DateSchema, F as FATAL_ERROR_TYPES, g as FILE_REF_PROP, h as FILE_REF_SUBTYPE_TAG, n as FileSchema, G as GenericSelector, l as ImageSchema, I as Internal, K as KeyOfSchema, L as LiteralSchema, M as ModuleFilePathSep, N as NumberSchema, O as ObjectSchema, R as RecordSchema, q as RichTextSchema, p as RouteSchema, S as Schema, k as StringSchema, U as UnionSchema, V as VAL_EXTENSION, j as derefPatch, r as deserializeSchema, i as initVal, m as modules } from './index-52848948.esm.js';
 import './result-daff1cae.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/core",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "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-eb1a6b1f.cjs.dev.js');
+var dist_valbuildCore = require('../../dist/index-3f815afd.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-34063fba.cjs.prod.js');
+var dist_valbuildCore = require('../../dist/index-55f6a997.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-11591a0b.esm.js';
-export { P as PatchError } from '../../dist/index-11591a0b.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-52848948.esm.js';
+export { P as PatchError } from '../../dist/index-52848948.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';