@valbuild/core 0.97.0 → 0.97.4

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

@@ -0,0 +1,27 @@
+import { ValModules } from "./modules.js";
+import type { Schema, SerializedSchema } from "./schema/index.js";
+import { SelectorSource } from "./selector/index.js";
+import { Source } from "./source/index.js";
+import { ModuleFilePath } from "./val/index.js";
+export type ExtractedModuleError = {
+    message: string;
+    path?: ModuleFilePath;
+};
+export type ExtractedValModules = {
+    sources: Record<ModuleFilePath, Source>;
+    schemas: Record<ModuleFilePath, Schema<SelectorSource>>;
+    serializedSchemas: Record<ModuleFilePath, SerializedSchema>;
+    baseSha: string;
+    schemaSha: string;
+    sourcesSha: string;
+    configSha: string;
+    moduleErrors: ExtractedModuleError[];
+};
+/**
+ * Extracts schemas and sources from a ValModules registry and computes the
+ * deterministic SHAs that the server and client both use to detect changes.
+ *
+ * Used by ValOps on the server and by ValSyncEngine on the client so the
+ * hash algorithm has a single source of truth.
+ */
+export declare function extractValModules(valModules: ValModules): Promise<ExtractedValModules>;

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

@@ -1,5 +1,6 @@
 export { initVal, type ConfigDirectory } from "./initVal.js";
 export { modules, type ValModules } from "./modules.js";
+export { extractValModules, type ExtractedValModules, type ExtractedModuleError, } from "./extractValModules.js";
 export type { InitVal, ValConfig, ValConstructor, ContentConstructor, } from "./initVal.js";
 export { Schema, type SerializedSchema, type SelectorOfSchema } from "./schema/index.js";
 export type { ImageMetadata } from "./schema/image.js";

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

@@ -285,7 +285,7 @@ export declare function initSchema(): {
     datetime: (options?: Record<string, never>) => import("./schema/datetime.js").DateTimeSchema<import("./schema/string.js").RawString>;
     route: <T extends string>(options?: Record<string, never>) => import("./schema/route.js").RouteSchema<T>;
     router: typeof router;
-    images: <Accept extends `image/${string}`>(options: import("./schema/images.js").ImagesOptions<Accept>) => import("./schema/record.js").RecordSchema<import("./schema/object.js").ObjectSchema<{
+    images: <Accept extends `image/${string}`>(options?: import("./schema/images.js").ImagesOptions<Accept>) => import("./schema/record.js").RecordSchema<import("./schema/object.js").ObjectSchema<{
         width: import("./schema/number.js").NumberSchema<number>;
         height: import("./schema/number.js").NumberSchema<number>;
         mimeType: import("./schema/string.js").StringSchema<string>;

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

@@ -13,7 +13,7 @@ export type ContentConstructor = {
 export type ValConstructor = {
     unstable_getPath: typeof getPath;
 };
-export type ConfigDirectory = `/public/val`;
+export type ConfigDirectory = `/public` | `/public/${string}`;
 export type ValConfig = {
     project?: string;
     root?: string;

package/dist/declarations/src/remote/splitRemoteRef.d.ts

@@ -6,7 +6,7 @@ export declare function splitRemoteRef(ref: string): {
     version: string;
     validationHash: string;
     fileHash: string;
-    filePath: `public/val/${string}`;
+    filePath: `public/${string}`;
 } | {
     status: "error";
     error: string;

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

@@ -14,8 +14,9 @@ export type AltSchema = StringSchema<string> | StringSchema<string | null> | Rec
 export type ImagesOptions<Accept extends `image/${string}`> = {
     /**
      * The accepted mime type pattern. Must be an image type (e.g., "image/png", "image/webp", "image/*")
+     * @default "image/*"
      */
-    accept: Accept;
+    accept?: Accept;
     /**
      * The directory where images should be stored.
      * Must start with "/public" (e.g., "/public/val/images")
@@ -64,6 +65,9 @@ type ImagesItemSrc = {
 /**
  * Define a collection of images.
  *
+ * All options are optional: `s.images()` accepts any image type (`"image/*"`) in
+ * the default `/public/val` directory, with nullable alt text and remote disabled.
+ *
  * @example
  * ```typescript
  * const schema = s.images({
@@ -81,5 +85,5 @@ type ImagesItemSrc = {
  * });
  * ```
  */
-export declare const images: <Accept extends `image/${string}`>(options: ImagesOptions<Accept>) => RecordSchema<ObjectSchema<ImagesItemProps, ImagesItemSrc>, Schema<string>, Record<string, ImagesEntryMetadata>>;
+export declare const images: <Accept extends `image/${string}`>(options?: ImagesOptions<Accept>) => RecordSchema<ObjectSchema<ImagesItemProps, ImagesItemSrc>, Schema<string>, Record<string, ImagesEntryMetadata>>;
 export {};

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

@@ -45,6 +45,8 @@ export declare class RecordSchema<T extends Schema<SelectorSource>, K extends Sc
     validate(validationFunction: (src: Src) => false | string): RecordSchema<T, K, Src>;
     protected executeValidate(path: SourcePath, src: Src): ValidationErrors;
     private isRemoteUrl;
+    /** Marks the validation errors reported at `path` as key errors (in place). */
+    private markKeyErrorsAtPath;
     private validateMediaKey;
     private validateMediaEntry;
     private validateMediaMimeType;

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

@@ -5,6 +5,6 @@ export type FileSelector<Metadata extends FileMetadata | undefined> = GenericSel
     url: string;
 }> & {
     readonly url: UnknownSelector<string>;
-} & Metadata extends undefined ? {} : Metadata extends Source ? {
+} & (Metadata extends undefined ? {} : Metadata extends Source ? {
     readonly metadata: UnknownSelector<Metadata>;
-} : {};
+} : {});

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

@@ -23,7 +23,6 @@ export type SelectorSource = SourcePrimitive | undefined | readonly SelectorSour
  * @internal
  */
 export declare const GetSchema: unique symbol;
-/**
 /**
  * @internal
  */

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

@@ -22,7 +22,7 @@ export type FileSource<Metadata extends FileMetadata | undefined = FileMetadata
 export declare const initFile: (config?: ValConfig) => {
     <Metadata extends {
         readonly [key: string]: Json;
-    }>(ref: `${"/public/val"}/${string}`, metadata: Metadata): FileSource<Metadata>;
-    (ref: `${"/public/val"}/${string}`, metadata?: undefined): FileSource<undefined>;
+    }>(ref: `${import("../initVal.js").ConfigDirectory}/${string}`, metadata: Metadata): FileSource<Metadata>;
+    (ref: `${import("../initVal.js").ConfigDirectory}/${string}`, metadata?: undefined): FileSource<undefined>;
 };
 export declare function isFile(obj: unknown): obj is FileSource;

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

@@ -14,6 +14,6 @@ export type ImageSource<Metadata extends ImageMetadata | undefined = ImageMetada
     readonly patch_id?: string;
 };
 export declare const initImage: (config?: ValConfig) => {
-    (ref: `${"/public/val"}/${string}`, metadata: ImageMetadata): ImageSource<ImageMetadata>;
-    (ref: `${"/public/val"}/${string}`, metadata?: undefined): ImageSource<undefined>;
+    (ref: `${import("../initVal.js").ConfigDirectory}/${string}`, metadata: ImageMetadata): ImageSource<ImageMetadata>;
+    (ref: `${import("../initVal.js").ConfigDirectory}/${string}`, metadata?: undefined): ImageSource<undefined>;
 };

package/dist/declarations/src/source/remote.d.ts

@@ -12,12 +12,12 @@ export type RemoteSource<Metadata extends FileMetadata | undefined = FileMetadat
     readonly patch_id?: string;
 };
 export declare const initRemote: (config?: ValConfig) => <Metadata extends FileMetadata | ImageMetadata>(ref: RemoteRef, metadata?: Metadata) => RemoteSource<Metadata>;
-export type RemoteRef = `${string}/file/p/${string}/v/${string}/h/${string}/f/${string}/p/public/val/${string}`;
+export type RemoteRef = `${string}/file/p/${string}/b/${string}/v/${string}/h/${string}/f/${string}/p/public/${string}`;
 export declare function createRemoteRef(remoteHost: string, { publicProjectId, coreVersion, validationHash, fileHash, filePath, bucket, }: {
     publicProjectId: string;
     coreVersion: string;
     validationHash: string;
     fileHash: string;
-    filePath: `public/val/${string}`;
+    filePath: `public/${string}`;
     bucket: string;
 }): RemoteRef;