@valbuild/shared 0.87.5 → 0.89.0

package/README.md

@@ -1,23 +1,9 @@
-# Shared types and utils
+# Val Shared
 
-This package contains internal Val types and utils that are shared between other packages.
+This package contains Val's shared types and utilities used across different runtimes and packages.
 
-Since Val has many runtimes (node, browser, QuickJS) and is bundled in different ways and executed different modes (client, SSR, RSC), we need to be careful about how code is bundled. This package gives us an extra place to put code that is shared between all platforms, but that can be run in all runtimes and bundlers.
+NOTE: do not use this directly, use the package corresponding to your meta-framework (e.g. Next) instead.
 
-## What is goes into this package?
+## Contributors
 
-Generally speaking, code that are shared between other packages belongs in this package. Specifically:
-
-- Types and utility functions that does **NOT** belong in core because they:
-  1. is not required to execute Val files; or
-  1. have dependency on a lib
-- Types and utility functions that does **NOT** semantically belong in any other package. Examples:
-  1. parser tools
-  1. API layer
-
-See the rules to what does NOT belong in this package below.
-
-## What **DOES NOT** go into this package?
-
-- Any function / type that depends on a UI framework, even transitively (React, ProseMirror, NextJS, Vite...).
-- Any function that cannot execute both on server-side and client-side.
+This package provides cross-platform types and utilities that work in all runtimes (node, browser, QuickJS) and bundlers, including API layer types, parser tools, and shared validation logic.

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

@@ -3098,17 +3098,17 @@ export declare const Api: {
                             message: z.ZodString;
                             value: z.ZodOptional<z.ZodUnknown>;
                             fatal: z.ZodOptional<z.ZodBoolean>;
-                            fixes: z.ZodOptional<z.ZodArray<z.ZodType<"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", z.ZodTypeDef, "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">, "many">>;
+                            fixes: z.ZodOptional<z.ZodArray<z.ZodType<"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", z.ZodTypeDef, "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">, "many">>;
                         }, "strip", z.ZodTypeAny, {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }, {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }>, "many">>>;
                     }, "strip", z.ZodTypeAny, {
                         patches?: {
@@ -3124,7 +3124,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }, {
                         patches?: {
@@ -3140,7 +3140,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }>>;
                 }, "strip", z.ZodTypeAny, {
@@ -3160,7 +3160,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }>>;
                 }, {
@@ -3180,7 +3180,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }>;
                 }>;
@@ -3203,7 +3203,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }>>;
                 };
@@ -3226,7 +3226,7 @@ export declare const Api: {
                             message: string;
                             value?: unknown;
                             fatal?: boolean | undefined;
-                            fixes?: ("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")[] | undefined;
+                            fixes?: ("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")[] | undefined;
                         }[]> | undefined;
                     }>;
                 };

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

@@ -11,3 +11,4 @@ export * from "./zod/ValDeployment.js";
 export * from "./getSitemapTree.js";
 export * from "./parseRoutePattern.js";
 export * from "./getNextAppRouterSourceFolder.js";
+export * from "./routeValidation.js";

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

@@ -0,0 +1,24 @@
+/**
+ * Shared route validation utilities
+ */
+export type SerializedRegExpPattern = {
+    source: string;
+    flags: string;
+};
+/**
+ * Filter routes by include/exclude patterns
+ */
+export declare function filterRoutesByPatterns(routes: string[], includePattern?: SerializedRegExpPattern, excludePattern?: SerializedRegExpPattern): string[];
+/**
+ * Validate a single route against include/exclude patterns
+ */
+export declare function validateRoutePatterns(route: string, includePattern?: SerializedRegExpPattern, excludePattern?: SerializedRegExpPattern): {
+    valid: true;
+} | {
+    valid: false;
+    message: string;
+};
+/**
+ * Create RegExp from pattern (with error handling)
+ */
+export declare function createRegExpFromPattern(pattern: SerializedRegExpPattern): RegExp | null;

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

@@ -1 +1,2 @@
 export declare const VAL_CONFIG_SESSION_STORAGE_KEY = "val-config";
+export declare const VAL_THEME_SESSION_STORAGE_KEY = "val-theme";

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

@@ -1131,7 +1131,23 @@ var SerializedDateSchema = zod.z.object({
   type: zod.z.literal("date"),
   opt: zod.z["boolean"]()
 });
-var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
+var SerializedRouteSchema = zod.z.object({
+  type: zod.z.literal("route"),
+  options: zod.z.object({
+    include: zod.z.object({
+      source: zod.z.string(),
+      flags: zod.z.string()
+    }).optional(),
+    exclude: zod.z.object({
+      source: zod.z.string(),
+      flags: zod.z.string()
+    }).optional(),
+    customValidate: zod.z["boolean"]().optional()
+  }).optional(),
+  opt: zod.z["boolean"](),
+  customValidate: zod.z["boolean"]().optional()
+});
+var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
 
 var ValCommit = zod.z.object({
   commitSha: zod.z.string(),
@@ -1163,7 +1179,7 @@ var ValConfig = zod.z.object({
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:change-extension"), zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("file:change-extension"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("keyof:check-keys")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -2214,6 +2230,7 @@ var urlOf = function urlOf() {
 };
 
 var VAL_CONFIG_SESSION_STORAGE_KEY = "val-config";
+var VAL_THEME_SESSION_STORAGE_KEY = "val-theme";
 
 var SharedValConfig = zod.z.object({
   contentHostUrl: zod.z.string().optional(),
@@ -2409,6 +2426,112 @@ function getNextAppRouterSourceFolder(moduleFilePath) {
   return null;
 }
 
+/**
+ * Shared route validation utilities
+ */
+
+/**
+ * Filter routes by include/exclude patterns
+ */
+function filterRoutesByPatterns(routes, includePattern, excludePattern) {
+  // Validate patterns upfront and warn about issues
+  var includeRegex = null;
+  var excludeRegex = null;
+  if (includePattern) {
+    try {
+      includeRegex = new RegExp(includePattern.source, includePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+    }
+  }
+  if (excludePattern) {
+    try {
+      excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+    }
+  }
+  return routes.filter(function (route) {
+    // Check include pattern
+    if (includePattern) {
+      if (!includeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (!includeRegex.test(route)) {
+        return false;
+      }
+    }
+
+    // Check exclude pattern
+    if (excludePattern) {
+      if (!excludeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (excludeRegex.test(route)) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+
+/**
+ * Validate a single route against include/exclude patterns
+ */
+function validateRoutePatterns(route, includePattern, excludePattern) {
+  // Validate include pattern
+  if (includePattern) {
+    try {
+      var regex = new RegExp(includePattern.source, includePattern.flags);
+      if (!regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' does not match include pattern: /").concat(includePattern.source, "/").concat(includePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid include pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+
+  // Validate exclude pattern
+  if (excludePattern) {
+    try {
+      var _regex = new RegExp(excludePattern.source, excludePattern.flags);
+      if (_regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' matches exclude pattern: /").concat(excludePattern.source, "/").concat(excludePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid exclude pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+  return {
+    valid: true
+  };
+}
+
+/**
+ * Create RegExp from pattern (with error handling)
+ */
+function createRegExpFromPattern(pattern) {
+  try {
+    return new RegExp(pattern.source, pattern.flags);
+  } catch (_unused) {
+    return null;
+  }
+}
+
 exports.Api = Api;
 exports.ParentRef = ParentRef$1;
 exports.Patch = Patch;
@@ -2431,9 +2554,12 @@ exports.VAL_CONFIG_SESSION_STORAGE_KEY = VAL_CONFIG_SESSION_STORAGE_KEY;
 exports.VAL_ENABLE_COOKIE_NAME = VAL_ENABLE_COOKIE_NAME;
 exports.VAL_SESSION_COOKIE = VAL_SESSION_COOKIE;
 exports.VAL_STATE_COOKIE = VAL_STATE_COOKIE;
+exports.VAL_THEME_SESSION_STORAGE_KEY = VAL_THEME_SESSION_STORAGE_KEY;
 exports.ValCommit = ValCommit;
 exports.ValDeployment = ValDeployment;
+exports.createRegExpFromPattern = createRegExpFromPattern;
 exports.createValClient = createValClient;
+exports.filterRoutesByPatterns = filterRoutesByPatterns;
 exports.getNextAppRouterSitemapTree = getNextAppRouterSitemapTree;
 exports.getNextAppRouterSourceFolder = getNextAppRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getPatternFromModuleFilePath;
@@ -2441,3 +2567,4 @@ exports.parseRoutePattern = parseRoutePattern;
 exports.remirrorToRichTextSource = remirrorToRichTextSource;
 exports.richTextToRemirror = richTextToRemirror;
 exports.urlOf = urlOf;
+exports.validateRoutePatterns = validateRoutePatterns;

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

@@ -1131,7 +1131,23 @@ var SerializedDateSchema = zod.z.object({
   type: zod.z.literal("date"),
   opt: zod.z["boolean"]()
 });
-var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
+var SerializedRouteSchema = zod.z.object({
+  type: zod.z.literal("route"),
+  options: zod.z.object({
+    include: zod.z.object({
+      source: zod.z.string(),
+      flags: zod.z.string()
+    }).optional(),
+    exclude: zod.z.object({
+      source: zod.z.string(),
+      flags: zod.z.string()
+    }).optional(),
+    customValidate: zod.z["boolean"]().optional()
+  }).optional(),
+  opt: zod.z["boolean"](),
+  customValidate: zod.z["boolean"]().optional()
+});
+var SerializedSchema = zod.z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
 
 var ValCommit = zod.z.object({
   commitSha: zod.z.string(),
@@ -1163,7 +1179,7 @@ var ValConfig = zod.z.object({
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:change-extension"), zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("file:change-extension"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("keyof:check-keys")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("router:check-route")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -2214,6 +2230,7 @@ var urlOf = function urlOf() {
 };
 
 var VAL_CONFIG_SESSION_STORAGE_KEY = "val-config";
+var VAL_THEME_SESSION_STORAGE_KEY = "val-theme";
 
 var SharedValConfig = zod.z.object({
   contentHostUrl: zod.z.string().optional(),
@@ -2409,6 +2426,112 @@ function getNextAppRouterSourceFolder(moduleFilePath) {
   return null;
 }
 
+/**
+ * Shared route validation utilities
+ */
+
+/**
+ * Filter routes by include/exclude patterns
+ */
+function filterRoutesByPatterns(routes, includePattern, excludePattern) {
+  // Validate patterns upfront and warn about issues
+  var includeRegex = null;
+  var excludeRegex = null;
+  if (includePattern) {
+    try {
+      includeRegex = new RegExp(includePattern.source, includePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+    }
+  }
+  if (excludePattern) {
+    try {
+      excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+    }
+  }
+  return routes.filter(function (route) {
+    // Check include pattern
+    if (includePattern) {
+      if (!includeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (!includeRegex.test(route)) {
+        return false;
+      }
+    }
+
+    // Check exclude pattern
+    if (excludePattern) {
+      if (!excludeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (excludeRegex.test(route)) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+
+/**
+ * Validate a single route against include/exclude patterns
+ */
+function validateRoutePatterns(route, includePattern, excludePattern) {
+  // Validate include pattern
+  if (includePattern) {
+    try {
+      var regex = new RegExp(includePattern.source, includePattern.flags);
+      if (!regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' does not match include pattern: /").concat(includePattern.source, "/").concat(includePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid include pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+
+  // Validate exclude pattern
+  if (excludePattern) {
+    try {
+      var _regex = new RegExp(excludePattern.source, excludePattern.flags);
+      if (_regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' matches exclude pattern: /").concat(excludePattern.source, "/").concat(excludePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid exclude pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+  return {
+    valid: true
+  };
+}
+
+/**
+ * Create RegExp from pattern (with error handling)
+ */
+function createRegExpFromPattern(pattern) {
+  try {
+    return new RegExp(pattern.source, pattern.flags);
+  } catch (_unused) {
+    return null;
+  }
+}
+
 exports.Api = Api;
 exports.ParentRef = ParentRef$1;
 exports.Patch = Patch;
@@ -2431,9 +2554,12 @@ exports.VAL_CONFIG_SESSION_STORAGE_KEY = VAL_CONFIG_SESSION_STORAGE_KEY;
 exports.VAL_ENABLE_COOKIE_NAME = VAL_ENABLE_COOKIE_NAME;
 exports.VAL_SESSION_COOKIE = VAL_SESSION_COOKIE;
 exports.VAL_STATE_COOKIE = VAL_STATE_COOKIE;
+exports.VAL_THEME_SESSION_STORAGE_KEY = VAL_THEME_SESSION_STORAGE_KEY;
 exports.ValCommit = ValCommit;
 exports.ValDeployment = ValDeployment;
+exports.createRegExpFromPattern = createRegExpFromPattern;
 exports.createValClient = createValClient;
+exports.filterRoutesByPatterns = filterRoutesByPatterns;
 exports.getNextAppRouterSitemapTree = getNextAppRouterSitemapTree;
 exports.getNextAppRouterSourceFolder = getNextAppRouterSourceFolder;
 exports.getPatternFromModuleFilePath = getPatternFromModuleFilePath;
@@ -2441,3 +2567,4 @@ exports.parseRoutePattern = parseRoutePattern;
 exports.remirrorToRichTextSource = remirrorToRichTextSource;
 exports.richTextToRemirror = richTextToRemirror;
 exports.urlOf = urlOf;
+exports.validateRoutePatterns = validateRoutePatterns;

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

@@ -1127,7 +1127,23 @@ var SerializedDateSchema = z.object({
   type: z.literal("date"),
   opt: z["boolean"]()
 });
-var SerializedSchema = z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
+var SerializedRouteSchema = z.object({
+  type: z.literal("route"),
+  options: z.object({
+    include: z.object({
+      source: z.string(),
+      flags: z.string()
+    }).optional(),
+    exclude: z.object({
+      source: z.string(),
+      flags: z.string()
+    }).optional(),
+    customValidate: z["boolean"]().optional()
+  }).optional(),
+  opt: z["boolean"](),
+  customValidate: z["boolean"]().optional()
+});
+var SerializedSchema = z.union([SerializedStringSchema, SerializedLiteralSchema, SerializedBooleanSchema, SerializedNumberSchema, SerializedObjectSchema, SerializedArraySchema, SerializedUnionSchema, SerializedRichTextSchema, SerializedRecordSchema, SerializedKeyOfSchema, SerializedRouteSchema, SerializedFileSchema, SerializedDateSchema, SerializedImageSchema]);
 
 var ValCommit = z.object({
   commitSha: z.string(),
@@ -1159,7 +1175,7 @@ var ValConfig = z.object({
   gitCommit: z.string().optional(),
   gitBranch: z.string().optional()
 });
-var ValidationFixZ = z.union([z.literal("image:change-extension"), z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("file:change-extension"), z.literal("file:add-metadata"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("keyof:check-keys")]);
+var ValidationFixZ = z.union([z.literal("image:add-metadata"), z.literal("image:check-metadata"), z.literal("image:check-remote"), z.literal("image:upload-remote"), z.literal("image:download-remote"), z.literal("file:add-metadata"), z.literal("file:check-metadata"), z.literal("file:check-remote"), z.literal("file:upload-remote"), z.literal("file:download-remote"), z.literal("keyof:check-keys"), z.literal("router:check-route")]);
 var ValidationError = z.object({
   message: z.string(),
   value: z.unknown().optional(),
@@ -2210,6 +2226,7 @@ var urlOf = function urlOf() {
 };
 
 var VAL_CONFIG_SESSION_STORAGE_KEY = "val-config";
+var VAL_THEME_SESSION_STORAGE_KEY = "val-theme";
 
 var SharedValConfig = z.object({
   contentHostUrl: z.string().optional(),
@@ -2405,4 +2422,110 @@ function getNextAppRouterSourceFolder(moduleFilePath) {
   return null;
 }
 
-export { Api, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchId, PatchJSON, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, SharedValConfig, VAL_CONFIG_SESSION_STORAGE_KEY, VAL_ENABLE_COOKIE_NAME, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, ValCommit, ValDeployment, createValClient, getNextAppRouterSitemapTree, getNextAppRouterSourceFolder, getPatternFromModuleFilePath, parseRoutePattern, remirrorToRichTextSource, richTextToRemirror, urlOf };
+/**
+ * Shared route validation utilities
+ */
+
+/**
+ * Filter routes by include/exclude patterns
+ */
+function filterRoutesByPatterns(routes, includePattern, excludePattern) {
+  // Validate patterns upfront and warn about issues
+  var includeRegex = null;
+  var excludeRegex = null;
+  if (includePattern) {
+    try {
+      includeRegex = new RegExp(includePattern.source, includePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+    }
+  }
+  if (excludePattern) {
+    try {
+      excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
+    } catch (e) {
+      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+    }
+  }
+  return routes.filter(function (route) {
+    // Check include pattern
+    if (includePattern) {
+      if (!includeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (!includeRegex.test(route)) {
+        return false;
+      }
+    }
+
+    // Check exclude pattern
+    if (excludePattern) {
+      if (!excludeRegex) {
+        // Pattern creation failed, filter out this route
+        return false;
+      }
+      if (excludeRegex.test(route)) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+
+/**
+ * Validate a single route against include/exclude patterns
+ */
+function validateRoutePatterns(route, includePattern, excludePattern) {
+  // Validate include pattern
+  if (includePattern) {
+    try {
+      var regex = new RegExp(includePattern.source, includePattern.flags);
+      if (!regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' does not match include pattern: /").concat(includePattern.source, "/").concat(includePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid include pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+
+  // Validate exclude pattern
+  if (excludePattern) {
+    try {
+      var _regex = new RegExp(excludePattern.source, excludePattern.flags);
+      if (_regex.test(route)) {
+        return {
+          valid: false,
+          message: "Route '".concat(route, "' matches exclude pattern: /").concat(excludePattern.source, "/").concat(excludePattern.flags)
+        };
+      }
+    } catch (e) {
+      return {
+        valid: false,
+        message: "Invalid exclude pattern: ".concat(e instanceof Error ? e.message : String(e))
+      };
+    }
+  }
+  return {
+    valid: true
+  };
+}
+
+/**
+ * Create RegExp from pattern (with error handling)
+ */
+function createRegExpFromPattern(pattern) {
+  try {
+    return new RegExp(pattern.source, pattern.flags);
+  } catch (_unused) {
+    return null;
+  }
+}
+
+export { Api, ParentRef$1 as ParentRef, Patch, PatchBlock, PatchId, PatchJSON, RemirrorBr, RemirrorBulletList, RemirrorHeading, RemirrorImage, RemirrorJSON, RemirrorLinkMark, RemirrorListItem, RemirrorOrderedList, RemirrorParagraph, RemirrorText, RemirrorTextMark, SharedValConfig, VAL_CONFIG_SESSION_STORAGE_KEY, VAL_ENABLE_COOKIE_NAME, VAL_SESSION_COOKIE, VAL_STATE_COOKIE, VAL_THEME_SESSION_STORAGE_KEY, ValCommit, ValDeployment, createRegExpFromPattern, createValClient, filterRoutesByPatterns, getNextAppRouterSitemapTree, getNextAppRouterSourceFolder, getPatternFromModuleFilePath, parseRoutePattern, remirrorToRichTextSource, richTextToRemirror, urlOf, validateRoutePatterns };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.87.5",
+  "version": "0.89.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
     "type": "git",
-    "url": "https://github.com/valbuild/val.git"
+    "url": "git+https://github.com/valbuild/val.git"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -33,7 +33,7 @@
     "exports": true
   },
   "dependencies": {
-    "@valbuild/core": "~0.87.5",
+    "@valbuild/core": "~0.89.0",
     "zod": "^3.22.4",
     "zod-validation-error": "^3.3.0"
   },