@valbuild/core 0.82.0 → 0.84.0

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

@@ -52,7 +52,8 @@ export { type SerializedRichTextSchema, RichTextSchema, } from "./schema/richtex
 export { type SerializedUnionSchema, UnionSchema, type SerializedStringUnionSchema, type SerializedObjectUnionSchema, } from "./schema/union.js";
 export { type SerializedLiteralSchema, LiteralSchema } from "./schema/literal.js";
 export { deserializeSchema } from "./schema/deserialize.js";
-export { type ListRecordPreview, type ListArrayPreview, type ReifiedPreview, } from "./preview.js";
+export { type ListRecordRender, type ListArrayRender, type ReifiedRender, } from "./render.js";
+export type { ValRouter, RouteValidationError } from "./router.js";
 export declare const FATAL_ERROR_TYPES: readonly ["no-schema", "no-source", "invalid-id", "no-module", "invalid-patch"];
 export type FatalErrorType = (typeof FATAL_ERROR_TYPES)[number];
 export declare const DEFAULT_CONTENT_HOST = "https://content.val.build";
@@ -70,6 +71,7 @@ declare const Internal: {
     safeResolvePath: typeof safeResolvePath;
     splitModuleFilePathAndModulePath: typeof splitModuleFilePathAndModulePath;
     joinModuleFilePathAndModulePath: typeof joinModuleFilePathAndModulePath;
+    nextAppRouter: import("./router.js").ValRouter;
     remote: {
         createRemoteRef: typeof createRemoteRef;
         getValidationBasis: typeof getValidationBasis;

package/dist/declarations/src/{preview.d.ts → render.d.ts}

@@ -4,7 +4,7 @@ import { SelectorSource } from "./selector/index.js";
 import { ImageSource } from "./source/image.js";
 import { RemoteSource } from "./source/remote.js";
 import { ModuleFilePath, SourcePath } from "./val/index.js";
-export type ListRecordPreview = {
+export type ListRecordRender = {
     layout: "list";
     parent: "record";
     items: [
@@ -16,7 +16,7 @@ export type ListRecordPreview = {
         }
     ][];
 };
-export type ListArrayPreview = {
+export type ListArrayRender = {
     layout: "list";
     parent: "array";
     items: {
@@ -25,7 +25,7 @@ export type ListArrayPreview = {
         image?: ImageSource | RemoteSource<ImageMetadata> | null;
     }[];
 };
-type PreviewTypes = ListRecordPreview | ListArrayPreview;
+type RenderTypes = ListRecordRender | ListArrayRender;
 type WithStatus<T> = {
     status: "error";
     message: string;
@@ -36,6 +36,6 @@ type WithStatus<T> = {
     status: "success";
     data: T;
 };
-export type ReifiedPreview = Record<SourcePath | ModuleFilePath, WithStatus<PreviewTypes>>;
-export type PreviewSelector<T extends Schema<SelectorSource>> = T extends Schema<infer S> ? S : never;
+export type ReifiedRender = Record<SourcePath | ModuleFilePath, WithStatus<RenderTypes>>;
+export type RenderSelector<T extends Schema<SelectorSource>> = T extends Schema<infer S> ? S : never;
 export {};

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

@@ -0,0 +1,24 @@
+import { ModuleFilePath } from "./val/index.js";
+export type RouteValidationError = {
+    error: {
+        message: string;
+        urlPath: string;
+        expectedPath: string | null;
+    };
+};
+export declare const nextAppRouter: ValRouter;
+/**
+ * Parse Next.js route pattern from file path
+ * Support multiple Next.js app directory structures:
+ * - /app/blogs/[blog]/page.val.ts -> ["blogs", "[blog]"]
+ * - /src/app/blogs/[blog]/page.val.ts -> ["blogs", "[blog]"]
+ * - /pages/blogs/[blog].tsx -> ["blogs", "[blog]"] (Pages Router)
+ * - /app/(group)/blogs/[blog]/page.val.ts -> ["blogs", "[blog]"] (with groups)
+ * - /app/(.)feed/page.val.ts -> ["feed"] (interception route)
+ * - /app/(..)(dashboard)/feed/page.val.ts -> ["feed"] (interception route)
+ */
+export declare function parseNextJsRoutePattern(moduleFilePath: string): string[];
+export interface ValRouter {
+    getRouterId(): string;
+    validate(moduleFilePath: ModuleFilePath, urlPaths: string[]): RouteValidationError[];
+}

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

@@ -1,5 +1,5 @@
 import { Schema, SchemaAssertResult, SelectorOfSchema, SerializedSchema } from "./index.js";
-import { PreviewSelector, ReifiedPreview } from "../preview.js";
+import { RenderSelector, ReifiedRender } from "../render.js";
 import { SelectorSource } from "../selector/index.js";
 import { ImageSource } from "../source/image.js";
 import { ModuleFilePath, SourcePath } from "../val/index.js";
@@ -20,12 +20,12 @@ export declare class ArraySchema<T extends Schema<SelectorSource>, Src extends S
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): ArraySchema<T, Src | null>;
     protected executeSerialize(): SerializedArraySchema;
-    private previewInput;
-    protected executePreview(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedPreview;
-    preview(input: {
+    private renderInput;
+    protected executeRender(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedRender;
+    render(input: {
         layout: "list";
-        prepare: (input: {
-            val: PreviewSelector<T>;
+        select: (input: {
+            val: RenderSelector<T>;
         }) => {
             title: string;
             subtitle?: string | null;

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 export type SerializedBooleanSchema = {
@@ -16,6 +16,6 @@ export declare class BooleanSchema<Src extends boolean | null> extends Schema<Sr
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): BooleanSchema<Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const boolean: () => BooleanSchema<boolean>;

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SourcePath } from "../val/index.js";
 import { RawString } from "./string.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
@@ -37,7 +37,7 @@ export declare class DateSchema<Src extends string | null> extends Schema<Src> {
     to(to: string): DateSchema<Src>;
     nullable(): DateSchema<Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const date: (options?: Record<string, never>) => DateSchema<RawString>;
 export {};

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

@@ -4,7 +4,7 @@ import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema }
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 import { RemoteSource } from "../index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 export type FileOptions = {
     accept?: string;
 };
@@ -30,7 +30,7 @@ export declare class FileSchema<Src extends FileSource<FileMetadata | undefined>
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): FileSchema<Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const file: (options?: FileOptions) => FileSchema<FileSource<FileMetadata>>;
 export declare function convertFileSource<Metadata extends {

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

@@ -5,7 +5,7 @@ import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 import { FileMetadata } from "../index.js";
 import { RemoteSource } from "../source/remote.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 export type ImageOptions = {
     ext?: ["jpg"] | ["webp"];
     directory?: string;
@@ -40,6 +40,6 @@ export declare class ImageSchema<Src extends FileSource<ImageMetadata | undefine
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): ImageSchema<Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const image: (options?: ImageOptions) => ImageSchema<ImageSource>;

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

@@ -16,7 +16,7 @@ import { SerializedDateSchema } from "./date.js";
 import { ValidationError, ValidationErrors } from "./validation/ValidationError.js";
 import { FileSource } from "../source/file.js";
 import { GenericRichTextSourceNode, RichTextSource } from "../source/richtext.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 export type SerializedSchema = SerializedStringSchema | SerializedLiteralSchema | SerializedBooleanSchema | SerializedNumberSchema | SerializedObjectSchema | SerializedArraySchema | SerializedUnionSchema | SerializedRichTextSchema | SerializedRecordSchema | SerializedKeyOfSchema | SerializedFileSchema | SerializedDateSchema | SerializedImageSchema;
 type Primitives = number | string | boolean | null | FileSource;
 export type AssertError = {
@@ -40,11 +40,15 @@ export type SchemaAssertResult<Src extends SelectorSource> = {
     success: false;
     errors: Record<SourcePath, AssertError[]>;
 };
-export type CustomValidateFunction<Src extends SelectorSource> = (src: Src) => false | string;
+export type CustomValidateFunction<Src extends SelectorSource> = (src: Src, ctx: {
+    path: SourcePath;
+}) => false | string;
 export declare abstract class Schema<Src extends SelectorSource> {
     /** Validate the value of source content */
     protected abstract executeValidate(path: SourcePath, src: Src): ValidationErrors;
-    protected executeCustomValidateFunctions(src: Src, customValidateFunctions: CustomValidateFunction<Src>[]): ValidationError[];
+    protected executeCustomValidateFunctions(src: Src, customValidateFunctions: CustomValidateFunction<Src>[], ctx: {
+        path: SourcePath;
+    }): ValidationError[];
     /**
      * Check if the **root** **type** of source is correct.
      *
@@ -63,7 +67,7 @@ export declare abstract class Schema<Src extends SelectorSource> {
     protected abstract executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     abstract nullable(): Schema<Src | null>;
     protected abstract executeSerialize(): SerializedSchema;
-    protected abstract executePreview(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedPreview;
+    protected abstract executeRender(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedRender;
     /** MUTATES! since internal and perf sensitive */
     protected appendValidationError(current: ValidationErrors, path: SourcePath, message: string, value: unknown, schemaError?: boolean): ValidationErrors;
 }

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

@@ -5,28 +5,36 @@ import { Source, SourceObject } from "../source/index.js";
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 import { RawString } from "./string.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 export type SerializedKeyOfSchema = {
     type: "keyOf";
     path: SourcePath;
-    schema: SerializedSchema;
+    schema?: SerializedRefSchema | undefined;
     opt: boolean;
     values: "string" | string[];
     customValidate?: boolean;
 };
+type SerializedRefSchema = {
+    type: "object";
+    keys: string[];
+    opt?: boolean | undefined;
+} | {
+    type: "record";
+    opt?: boolean | undefined;
+};
 type KeyOfSelector<Sel extends GenericSelector<SourceObject>> = Sel extends GenericSelector<infer S> ? S extends readonly Source[] ? number : S extends SourceObject ? string extends keyof S ? RawString : keyof S : S extends Record<string, Source> ? RawString : never : never;
 export declare class KeyOfSchema<Sel extends GenericSelector<SourceObject>, Src extends KeyOfSelector<Sel> | null> extends Schema<Src> {
     private readonly schema?;
     private readonly sourcePath?;
     private readonly opt;
     private readonly customValidateFunctions;
-    constructor(schema?: SerializedSchema | undefined, sourcePath?: SourcePath | undefined, opt?: boolean, customValidateFunctions?: CustomValidateFunction<Src>[]);
+    constructor(schema?: SerializedRefSchema | undefined, sourcePath?: SourcePath | undefined, opt?: boolean, customValidateFunctions?: CustomValidateFunction<Src>[]);
     validate(validationFunction: (src: Src) => false | string): KeyOfSchema<Sel, Src>;
     protected executeValidate(path: SourcePath, src: Src): ValidationErrors;
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): KeyOfSchema<Sel, Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const keyOf: <Src extends GenericSelector<SourceObject, undefined> & ValModuleBrand>(valModule: Src) => KeyOfSchema<Src, KeyOfSelector<Src>>;
 export {};

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 export type SerializedLiteralSchema = {
@@ -18,6 +18,6 @@ export declare class LiteralSchema<Src extends string | null> extends Schema<Src
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): LiteralSchema<Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const literal: <T extends string>(value: T) => LiteralSchema<T>;

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 type NumberOptions = {
@@ -24,7 +24,7 @@ export declare class NumberSchema<Src extends number | null> extends Schema<Src>
     max(max: number): NumberSchema<Src>;
     min(min: number): NumberSchema<Src>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const number: (options?: NumberOptions) => NumberSchema<number>;
 export {};

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SelectorOfSchema, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SelectorSource } from "../selector/index.js";
 import { ModuleFilePath, SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
@@ -40,7 +40,7 @@ export declare class ObjectSchema<Props extends ObjectSchemaProps, Src extends O
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): ObjectSchema<Props, Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedPreview;
+    protected executeRender(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedRender;
 }
 export declare const object: <Props extends ObjectSchemaProps>(schema: Props) => ObjectSchema<Props, ObjectSchemaSrcOf<Props>>;
 export {};

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

@@ -1,5 +1,6 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SelectorOfSchema, SerializedSchema } from "./index.js";
-import { PreviewSelector, ReifiedPreview } from "../preview.js";
+import { RenderSelector, ReifiedRender } from "../render.js";
+import { ValRouter } from "../router.js";
 import { SelectorSource } from "../selector/index.js";
 import { ImageSource } from "../source/image.js";
 import { RemoteSource } from "../source/remote.js";
@@ -10,25 +11,29 @@ export type SerializedRecordSchema = {
     type: "record";
     item: SerializedSchema;
     opt: boolean;
+    router?: string;
     customValidate?: boolean;
 };
 export declare class RecordSchema<T extends Schema<SelectorSource>, Src extends Record<string, SelectorOfSchema<T>> | null> extends Schema<Src> {
     private readonly item;
     private readonly opt;
     private readonly customValidateFunctions;
-    constructor(item: T, opt?: boolean, customValidateFunctions?: CustomValidateFunction<Src>[]);
+    private readonly currentRouter;
+    constructor(item: T, opt?: boolean, customValidateFunctions?: CustomValidateFunction<Src>[], currentRouter?: ValRouter | null);
     validate(validationFunction: (src: Src) => false | string): RecordSchema<T, Src>;
     protected executeValidate(path: SourcePath, src: Src): ValidationErrors;
     protected executeAssert(path: SourcePath, src: unknown): SchemaAssertResult<Src>;
     nullable(): RecordSchema<T, Src | null>;
-    executeSerialize(): SerializedRecordSchema;
-    private previewInput;
-    protected executePreview(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedPreview;
-    preview(input: {
+    router(router: ValRouter): RecordSchema<T, Src>;
+    private getRouterValidations;
+    protected executeSerialize(): SerializedRecordSchema;
+    private renderInput;
+    protected executeRender(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedRender;
+    render(input: {
         layout: "list";
-        prepare: (input: {
+        select: (input: {
             key: string;
-            val: PreviewSelector<T>;
+            val: RenderSelector<T>;
         }) => {
             title: string;
             subtitle?: string | null;

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { ImageSource } from "../source/image.js";
 import { RichTextSource, RichTextOptions, SerializedRichTextOptions } from "../source/richtext.js";
 import { SourcePath } from "../val/index.js";
@@ -29,7 +29,7 @@ export declare class RichTextSchema<O extends RichTextOptions, Src extends RichT
     private recursiveAssert;
     nullable(): RichTextSchema<O, Src | null>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const richtext: <O extends Partial<{
     style: Partial<{

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

@@ -1,5 +1,5 @@
 import { Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SourcePath } from "../val/index.js";
 import { ValidationErrors } from "./validation/ValidationError.js";
 type StringOptions = {
@@ -51,7 +51,7 @@ export declare class StringSchema<Src extends string | null> extends Schema<Src>
     nullable(): StringSchema<Src | null>;
     raw(): StringSchema<Src extends null ? RawString | null : RawString>;
     protected executeSerialize(): SerializedSchema;
-    protected executePreview(): ReifiedPreview;
+    protected executeRender(): ReifiedRender;
 }
 export declare const string: <T extends string>(options?: Record<string, never>) => StringSchema<T>;
 export {};

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

@@ -1,5 +1,5 @@
 import { CustomValidateFunction, Schema, SchemaAssertResult, SerializedSchema } from "./index.js";
-import { ReifiedPreview } from "../preview.js";
+import { ReifiedRender } from "../render.js";
 import { SelectorSource } from "../selector/index.js";
 import { SourceObject } from "../source/index.js";
 import { ModuleFilePath, SourcePath } from "../val/index.js";
@@ -37,7 +37,7 @@ export declare class UnionSchema<Key extends string | Schema<string>, T extends
     nullable(): UnionSchema<Key, T, Src | null>;
     protected executeSerialize(): SerializedSchema;
     constructor(key: Key, items: T, opt?: boolean, customValidateFunctions?: CustomValidateFunction<Src>[]);
-    protected executePreview(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedPreview;
+    protected executeRender(sourcePath: SourcePath | ModuleFilePath, src: Src): ReifiedRender;
 }
 export declare const union: <Key extends string | Schema<string>, T extends Schema<Key extends string ? {
     [x: string]: import("../source/index.js").Source;