@daloyjs/core 1.0.0-beta.6 → 1.0.0-rc.0

package/dist/multipart.d.ts

@@ -114,6 +114,7 @@ export type UploadedFile = Blob & {
  * emit `format: binary`/`byte` accordingly.
  */
 export interface FileFieldSchema<Output = UploadedFile> extends StandardSchemaV1<unknown, Output> {
+    /** Resolved {@link FileFieldOptions} (with `format` defaulted) stamped on the schema for OpenAPI generation. */
     readonly [FILE_FIELD_MARKER]: Required<Pick<FileFieldOptions, "format">> & FileFieldOptions;
 }
 /**
@@ -122,13 +123,26 @@ export interface FileFieldSchema<Output = UploadedFile> extends StandardSchemaV1
  * Use inside a `multipartObject({...})` body schema, or directly inside any
  * Standard-Schema-compatible object schema (Zod, Valibot, ...). DaloyJS
  * keeps the underlying `File` reference so handlers can stream the body.
+ *
+ * @param options - Field constraints with `optional: true`; `null`/`undefined` values pass through.
+ * @returns A {@link FileFieldSchema} whose output may be `null`/`undefined`.
  */
 export declare function fileField(options: FileFieldOptions & {
     optional: true;
 }): FileFieldSchema<UploadedFile | null | undefined>;
-/** Validator for a required single uploaded `File`/`Blob` field. */
+/**
+ * Validator for a required single uploaded `File`/`Blob` field.
+ *
+ * @param options - Field constraints (`maxBytes`, `accept`, `filename`, `magicBytes`, ...).
+ * @returns A {@link FileFieldSchema} that rejects missing or non-file values.
+ */
 export declare function fileField(options?: FileFieldOptions): FileFieldSchema<UploadedFile>;
-/** Type-only check used by the OpenAPI generator. */
+/**
+ * Type-only check used by the OpenAPI generator.
+ *
+ * @param s - Candidate value to test for the `FILE_FIELD_MARKER` key.
+ * @returns `true` when `s` is a {@link fileField}-produced schema.
+ */
 export declare function isFileFieldSchema(s: unknown): s is FileFieldSchema;
 /** Options for {@link multipartObject}. */
 export interface MultipartObjectOptions {
@@ -154,15 +168,38 @@ interface MultipartSchema<S extends MultipartShape> extends StandardSchemaV1<Rec
  * body. Each entry in `shape` validates one form field by name. File fields
  * should use {@link fileField}; non-file fields can use any Standard-Schema
  * validator (`z.string()`, `v.number()`, ...).
+ *
+ * @param shape - Record mapping form-field names to per-field validators.
+ * @param options - `strict: true` rejects undeclared extra fields. Defaults
+ *   to `{ strict: false }` (extras pass through unvalidated).
+ * @returns A marker-carrying schema the OpenAPI generator renders as
+ *   `multipart/form-data`; validation issues are prefixed with the field name.
  */
 export declare function multipartObject<S extends MultipartShape>(shape: S, options?: MultipartObjectOptions): MultipartSchema<S>;
-/** Type-only check used by the OpenAPI generator and request-body parser. */
+/**
+ * Type-only check used by the OpenAPI generator and request-body parser.
+ *
+ * @param s - Candidate value to test for the `MULTIPART_SCHEMA_MARKER` key.
+ * @returns `true` when `s` is a {@link multipartObject}-produced schema.
+ */
 export declare function isMultipartObjectSchema(s: unknown): s is MultipartSchema<MultipartShape>;
-/** Internal: pull the multipart shape so the OpenAPI generator can walk it. */
+/**
+ * Internal: pull the multipart shape so the OpenAPI generator can walk it.
+ *
+ * @param s - Candidate schema value.
+ * @returns The `{ shape, strict }` config stored under the multipart marker,
+ *   or `undefined` when `s` is not a {@link multipartObject} schema.
+ */
 export declare function getMultipartShape(s: unknown): {
     shape: MultipartShape;
     strict: boolean;
 } | undefined;
-/** Internal: read the file-field options used for OpenAPI documentation. */
+/**
+ * Internal: read the file-field options used for OpenAPI documentation.
+ *
+ * @param s - Candidate schema value.
+ * @returns The resolved {@link FileFieldOptions} stored under the file-field
+ *   marker, or `undefined` when `s` is not a {@link fileField} schema.
+ */
 export declare function getFileFieldOptions(s: unknown): (Required<Pick<FileFieldOptions, "format">> & FileFieldOptions) | undefined;
 export {};

package/dist/multipart.js

@@ -233,7 +233,15 @@ async function verifyMagicBytes(file, signatures) {
     }
     return undefined;
 }
-/** Shared implementation for the `fileField` overloads above. */
+/**
+ * Shared implementation for the `fileField` overloads above.
+ *
+ * @param options - Field constraints; `format` defaults to `"binary"`, and
+ *   the scriptable-image guard defaults to on whenever `magicBytes` is set.
+ * @returns The marker-carrying {@link FileFieldSchema} validator.
+ * @throws Error at construction when `magicBytes` config is malformed (bad
+ *   offset, empty/out-of-range bytes, or `true` without a sniffable `accept`).
+ */
 export function fileField(options = {}) {
     const opts = {
         ...options,
@@ -312,7 +320,12 @@ export function fileField(options = {}) {
     };
     return schema;
 }
-/** Type-only check used by the OpenAPI generator. */
+/**
+ * Type-only check used by the OpenAPI generator.
+ *
+ * @param s - Candidate value to test for the `FILE_FIELD_MARKER` key.
+ * @returns `true` when `s` is a {@link fileField}-produced schema.
+ */
 export function isFileFieldSchema(s) {
     return !!s && typeof s === "object" && FILE_FIELD_MARKER in s;
 }
@@ -321,6 +334,12 @@ export function isFileFieldSchema(s) {
  * body. Each entry in `shape` validates one form field by name. File fields
  * should use {@link fileField}; non-file fields can use any Standard-Schema
  * validator (`z.string()`, `v.number()`, ...).
+ *
+ * @param shape - Record mapping form-field names to per-field validators.
+ * @param options - `strict: true` rejects undeclared extra fields. Defaults
+ *   to `{ strict: false }` (extras pass through unvalidated).
+ * @returns A marker-carrying schema the OpenAPI generator renders as
+ *   `multipart/form-data`; validation issues are prefixed with the field name.
  */
 export function multipartObject(shape, options = {}) {
     const strict = options.strict ?? false;
@@ -368,17 +387,34 @@ export function multipartObject(shape, options = {}) {
     };
     return schema;
 }
-/** Type-only check used by the OpenAPI generator and request-body parser. */
+/**
+ * Type-only check used by the OpenAPI generator and request-body parser.
+ *
+ * @param s - Candidate value to test for the `MULTIPART_SCHEMA_MARKER` key.
+ * @returns `true` when `s` is a {@link multipartObject}-produced schema.
+ */
 export function isMultipartObjectSchema(s) {
     return !!s && typeof s === "object" && MULTIPART_SCHEMA_MARKER in s;
 }
-/** Internal: pull the multipart shape so the OpenAPI generator can walk it. */
+/**
+ * Internal: pull the multipart shape so the OpenAPI generator can walk it.
+ *
+ * @param s - Candidate schema value.
+ * @returns The `{ shape, strict }` config stored under the multipart marker,
+ *   or `undefined` when `s` is not a {@link multipartObject} schema.
+ */
 export function getMultipartShape(s) {
     if (!isMultipartObjectSchema(s))
         return undefined;
     return s[MULTIPART_SCHEMA_MARKER];
 }
-/** Internal: read the file-field options used for OpenAPI documentation. */
+/**
+ * Internal: read the file-field options used for OpenAPI documentation.
+ *
+ * @param s - Candidate schema value.
+ * @returns The resolved {@link FileFieldOptions} stored under the file-field
+ *   marker, or `undefined` when `s` is not a {@link fileField} schema.
+ */
 export function getFileFieldOptions(s) {
     if (!isFileFieldSchema(s))
         return undefined;

package/dist/openapi.d.ts

@@ -38,14 +38,23 @@ export interface SecuritySchemeMap {
  * (no execution path on the producer side).
  */
 export interface WebhookDefinition {
+    /** HTTP method the producer uses when delivering the webhook. */
     method: HttpMethod;
+    /** Stable operation id for codegen. Omitted from the document when unset. */
     operationId?: string;
+    /** Short one-line summary shown in docs UIs. */
     summary?: string;
+    /** Longer CommonMark description of the webhook operation. */
     description?: string;
+    /** Tags used to group the operation in docs UIs. */
     tags?: string[];
+    /** Mark the webhook operation as deprecated in the document. */
     deprecated?: boolean;
+    /** Request schemas (body, headers, ...) the producer sends. Same shape as route `request`. */
     request?: RequestSchemas;
+    /** Map of status code to response schema the consumer is expected to return. */
     responses: ResponsesMap;
+    /** Security requirement(s) documented on the webhook operation (e.g. a signature scheme). */
     auth?: AuthSpec;
     /**
      * Optional OpenAPI 3.1 callbacks attached to this webhook operation.
@@ -112,16 +121,13 @@ export interface OpenAPIOptions {
  */
 export declare function generateOpenAPI(app: App, options: OpenAPIOptions): Record<string, unknown>;
 /**
- * Serialize an OpenAPI document (or any JSON-safe object) as YAML 1.2.
- *
- * Pure function with no runtime dependency. Output is the canonical form
- * consumed by Swagger UI's `/swagger.yaml` style endpoints.
+ * Serialize an OpenAPI document (from {@link generateOpenAPI}) — or any
+ * JSON-safe object — to YAML 1.2 using a minimal built-in emitter. Pure
+ * transform with no runtime dependency; output is the form consumed by
+ * `/swagger.yaml`-style endpoints and build-time artifacts.
  *
+ * @param doc - JSON-safe object to serialize (typically the generated document).
+ * @returns The YAML text, without a leading newline.
  * @since 0.13.1
  */
-/**
- * Serialize an OpenAPI document (from {@link generateOpenAPI}) to YAML using a
- * minimal built-in emitter. No external dependencies; suitable for build-time
- * artifacts. Reads/writes nothing; pure transform.
- */
 export declare function openapiToYAML(doc: Record<string, unknown>): string;

package/dist/openapi.js

@@ -485,18 +485,15 @@ function yamlEmit(value, indent) {
     return ` ${yamlScalar(value)}\n`;
 }
 /**
- * Serialize an OpenAPI document (or any JSON-safe object) as YAML 1.2.
- *
- * Pure function with no runtime dependency. Output is the canonical form
- * consumed by Swagger UI's `/swagger.yaml` style endpoints.
+ * Serialize an OpenAPI document (from {@link generateOpenAPI}) — or any
+ * JSON-safe object — to YAML 1.2 using a minimal built-in emitter. Pure
+ * transform with no runtime dependency; output is the form consumed by
+ * `/swagger.yaml`-style endpoints and build-time artifacts.
  *
+ * @param doc - JSON-safe object to serialize (typically the generated document).
+ * @returns The YAML text, without a leading newline.
  * @since 0.13.1
  */
-/**
- * Serialize an OpenAPI document (from {@link generateOpenAPI}) to YAML using a
- * minimal built-in emitter. No external dependencies; suitable for build-time
- * artifacts. Reads/writes nothing; pure transform.
- */
 export function openapiToYAML(doc) {
     const result = yamlEmit(doc, "");
     return result.startsWith("\n") ? result.slice(1) : result;

package/dist/rate-limit-redis.d.ts

@@ -50,10 +50,12 @@ import type { RateLimitStore } from "./middleware.js";
  * required by the bundled script.
  */
 export interface RedisCommands {
+    /** Run a Lua script atomically with the given `KEYS` / `ARGV` and return the raw Redis reply. */
     eval(script: string, keys: string[], args: string[]): Promise<unknown>;
 }
 /** Options accepted by {@link redisRateLimitStore}. */
 export interface RedisRateLimitStoreOptions {
+    /** Redis transport (see {@link ioredisAdapter} / {@link nodeRedisAdapter} for common clients). */
     client: RedisCommands;
     /**
      * Optional namespace prefix for every Redis key. Defaults to `"daloy:rl:"`.
@@ -83,6 +85,11 @@ export interface RedisRateLimitStoreOptions {
  * abuse-sensitive limiters in front of auth, password-reset, or other
  * credential endpoints, pass `onError: () => "fail-closed"` so a Redis
  * outage rejects rather than silently disables the limit.
+ *
+ * @param opts - Redis client, key prefix, and error policy; see
+ *   {@link RedisRateLimitStoreOptions}.
+ * @returns A {@link RateLimitStore} whose `hit()` atomically increments the
+ *   windowed counter in Redis and reports `{ count, resetMs }`.
  */
 export declare function redisRateLimitStore(opts: RedisRateLimitStoreOptions): RateLimitStore;
 /**
@@ -90,19 +97,31 @@ export declare function redisRateLimitStore(opts: RedisRateLimitStoreOptions): R
  * takes `(script, numKeys, ...keysAndArgs)` is used.
  */
 export interface IoredisLike {
+    /** ioredis-style `EVAL`: script, number of keys, then keys and args flattened. */
     eval(script: string, numKeys: number, ...keysAndArgs: string[]): Promise<unknown>;
 }
-/** Wrap an [`ioredis`](https://github.com/redis/ioredis) client. */
+/**
+ * Wrap an [`ioredis`](https://github.com/redis/ioredis) client.
+ *
+ * @param client - Connected ioredis instance (only its `eval` is used).
+ * @returns A {@link RedisCommands} transport for {@link redisRateLimitStore}.
+ */
 export declare function ioredisAdapter(client: IoredisLike): RedisCommands;
 /**
  * Shape of a `node-redis` v4+ client we care about. The v4 `eval` takes an
  * options object instead of variadic arguments.
  */
 export interface NodeRedisLike {
+    /** node-redis v4+ `EVAL`: script plus a `{ keys, arguments }` options object. */
     eval(script: string, options: {
         keys: string[];
         arguments: string[];
     }): Promise<unknown>;
 }
-/** Wrap a [`node-redis`](https://github.com/redis/node-redis) v4+ client. */
+/**
+ * Wrap a [`node-redis`](https://github.com/redis/node-redis) v4+ client.
+ *
+ * @param client - Connected node-redis v4+ instance (only its `eval` is used).
+ * @returns A {@link RedisCommands} transport for {@link redisRateLimitStore}.
+ */
 export declare function nodeRedisAdapter(client: NodeRedisLike): RedisCommands;

package/dist/rate-limit-redis.js

@@ -84,6 +84,11 @@ function toNumber(value) {
  * abuse-sensitive limiters in front of auth, password-reset, or other
  * credential endpoints, pass `onError: () => "fail-closed"` so a Redis
  * outage rejects rather than silently disables the limit.
+ *
+ * @param opts - Redis client, key prefix, and error policy; see
+ *   {@link RedisRateLimitStoreOptions}.
+ * @returns A {@link RateLimitStore} whose `hit()` atomically increments the
+ *   windowed counter in Redis and reports `{ count, resetMs }`.
  */
 export function redisRateLimitStore(opts) {
     const prefix = opts.prefix ?? "daloy:rl:";
@@ -106,7 +111,12 @@ export function redisRateLimitStore(opts) {
         },
     };
 }
-/** Wrap an [`ioredis`](https://github.com/redis/ioredis) client. */
+/**
+ * Wrap an [`ioredis`](https://github.com/redis/ioredis) client.
+ *
+ * @param client - Connected ioredis instance (only its `eval` is used).
+ * @returns A {@link RedisCommands} transport for {@link redisRateLimitStore}.
+ */
 export function ioredisAdapter(client) {
     return {
         eval(script, keys, args) {
@@ -114,7 +124,12 @@ export function ioredisAdapter(client) {
         },
     };
 }
-/** Wrap a [`node-redis`](https://github.com/redis/node-redis) v4+ client. */
+/**
+ * Wrap a [`node-redis`](https://github.com/redis/node-redis) v4+ client.
+ *
+ * @param client - Connected node-redis v4+ instance (only its `eval` is used).
+ * @returns A {@link RedisCommands} transport for {@link redisRateLimitStore}.
+ */
 export function nodeRedisAdapter(client) {
     return {
         eval(script, keys, args) {

package/dist/safe-redirect.d.ts

@@ -47,7 +47,9 @@
 export type SafeRedirectBlockReason = "empty-target" | "invalid-control-characters" | "protocol-relative" | "backslash-path" | "path-not-allowed" | "origin-not-allowed" | "scheme-not-allowed" | "parse-failed";
 /** Thrown when {@link safeRedirect} refuses a candidate URL and no `fallback` is configured. */
 export declare class OpenRedirectBlockedError extends Error {
+    /** Machine-readable {@link SafeRedirectBlockReason} explaining the refusal. */
     readonly reason: SafeRedirectBlockReason;
+    /** The candidate URL that was refused, verbatim. */
     readonly target: string;
     constructor(reason: SafeRedirectBlockReason, target: string);
 }
@@ -88,6 +90,10 @@ export interface SafeRedirectOptions {
  *
  * @param target - User-supplied URL candidate (path or absolute URL).
  * @param options - Allowlist + response configuration.
+ * @returns A redirect `Response` (default `303`) with `Location` set to the
+ *   validated target (or the `fallback`) and `Cache-Control: no-store`.
+ * @throws {TypeError} for a non-redirect `status` or malformed
+ *   `allowedPaths` / `allowedOrigins` / `fallback` entries.
  *
  * @since 0.35.0
  */

package/dist/safe-redirect.js

@@ -45,7 +45,9 @@
  */
 /** Thrown when {@link safeRedirect} refuses a candidate URL and no `fallback` is configured. */
 export class OpenRedirectBlockedError extends Error {
+    /** Machine-readable {@link SafeRedirectBlockReason} explaining the refusal. */
     reason;
+    /** The candidate URL that was refused, verbatim. */
     target;
     constructor(reason, target) {
         super(`safeRedirect: refused redirect (${reason})`);
@@ -148,6 +150,10 @@ function hasEncodedProtocolRelativePrefix(value) {
  *
  * @param target - User-supplied URL candidate (path or absolute URL).
  * @param options - Allowlist + response configuration.
+ * @returns A redirect `Response` (default `303`) with `Location` set to the
+ *   validated target (or the `fallback`) and `Cache-Control: no-store`.
+ * @throws {TypeError} for a non-redirect `status` or malformed
+ *   `allowedPaths` / `allowedOrigins` / `fallback` entries.
  *
  * @since 0.35.0
  */

package/dist/sbom.cdx.json

@@ -1,15 +1,15 @@
 {
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:a88e3a69-b278-5771-a67e-40fb774e004e",
+  "serialNumber": "urn:uuid:e297e402-67fc-54e1-a292-02441ebb5d71",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-07-01T22:47:12.881Z",
+    "timestamp": "2026-07-03T11:51:00.910Z",
     "tools": [
       {
         "vendor": "DaloyJS",
         "name": "daloy-generate-sbom",
-        "version": "1.0.0-beta.6"
+        "version": "1.0.0-rc.0"
       }
     ],
     "authors": [
@@ -19,11 +19,11 @@
     ],
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/@daloyjs/core@1.0.0-beta.6",
+      "bom-ref": "pkg:npm/@daloyjs/core@1.0.0-rc.0",
       "name": "@daloyjs/core",
-      "version": "1.0.0-beta.6",
+      "version": "1.0.0-rc.0",
       "description": "DaloyJS is a runtime-portable, contract-first TypeScript web framework with built-in OpenAPI (Hey API), typed client generation, large-scale maintainability, and security-first defaults. Hono-grade portability, Elysia-grade DX, FastAPI-grade docs, Fastify-grade ops — distributed via pnpm.",
-      "purl": "pkg:npm/@daloyjs/core@1.0.0-beta.6",
+      "purl": "pkg:npm/@daloyjs/core@1.0.0-rc.0",
       "licenses": [
         {
           "license": {
@@ -46,9 +46,9 @@
         }
       ],
       "swid": {
-        "tagId": "swidtag--daloyjs-core-1.0.0-beta.6",
+        "tagId": "swidtag--daloyjs-core-1.0.0-rc.0",
         "name": "@daloyjs/core",
-        "version": "1.0.0-beta.6",
+        "version": "1.0.0-rc.0",
         "tagVersion": 0,
         "patch": false
       }
@@ -57,7 +57,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "pkg:npm/@daloyjs/core@1.0.0-beta.6",
+      "ref": "pkg:npm/@daloyjs/core@1.0.0-rc.0",
       "dependsOn": []
     }
   ]

package/dist/sbom.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@daloyjs/core-1.0.0-beta.6",
-  "documentNamespace": "https://github.com/daloyjs/daloy/sbom/@daloyjs/core-1.0.0-beta.6-a88e3a69-b278-5771-a67e-40fb774e004e",
+  "name": "@daloyjs/core-1.0.0-rc.0",
+  "documentNamespace": "https://github.com/daloyjs/daloy/sbom/@daloyjs/core-1.0.0-rc.0-e297e402-67fc-54e1-a292-02441ebb5d71",
   "creationInfo": {
-    "created": "2026-07-01T22:47:12.881Z",
+    "created": "2026-07-03T11:51:00.910Z",
     "creators": [
       "Tool: daloy-generate-sbom",
       "Organization: DaloyJS"
@@ -16,7 +16,7 @@
     {
       "SPDXID": "SPDXRef-Package--daloyjs-core",
       "name": "@daloyjs/core",
-      "versionInfo": "1.0.0-beta.6",
+      "versionInfo": "1.0.0-rc.0",
       "downloadLocation": "https://github.com/daloyjs/daloy",
       "filesAnalyzed": false,
       "licenseConcluded": "MIT",
@@ -27,7 +27,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/@daloyjs/core@1.0.0-beta.6"
+          "referenceLocator": "pkg:npm/@daloyjs/core@1.0.0-rc.0"
         }
       ]
     }

package/dist/scheduler.d.ts

@@ -57,9 +57,13 @@ export declare class CronParseError extends Error {
  * @since 0.37.0
  */
 export interface SchedulerLogger {
+    /** Log at debug level (task definitions as they are registered). */
     debug(obj: object | string, msg?: string): void;
+    /** Log at info level (scheduler started / stopped lifecycle events). */
     info(obj: object | string, msg?: string): void;
+    /** Log at warn level (overrun-skipped runs, stop grace-period timeouts). */
     warn(obj: object | string, msg?: string): void;
+    /** Log at error level (a task handler threw or rejected). */
     error(obj: object | string, msg?: string): void;
 }
 /**

package/dist/schema.d.ts

@@ -7,35 +7,60 @@
  * `~standard`. No vendor lock-in.
  */
 export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema contract object every compatible validator exposes. */
     readonly "~standard": StandardSchemaV1.Props<Input, Output>;
 }
 export declare namespace StandardSchemaV1 {
+    /**
+     * The `~standard` contract exposed by a Standard Schema validator: spec
+     * version, vendor tag, and the vendor-neutral `validate` entry point.
+     */
     interface Props<Input = unknown, Output = Input> {
+        /** Spec version implemented by the validator. Always `1`. */
         readonly version: 1;
+        /** Name of the validator library (e.g. `"zod"`, `"valibot"`). */
         readonly vendor: string;
+        /** Validates a value; may be sync or async. Returns `{ value }` on success or `{ issues }` on failure. */
         readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /** Type-only carrier for {@link InferInput}/{@link InferOutput}; never populated at runtime. */
         readonly types?: Types<Input, Output>;
     }
+    /** Outcome of {@link Props.validate}: a {@link SuccessResult} or a {@link FailureResult}. */
     type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** Successful validation: the parsed/coerced output value and no issues. */
     interface SuccessResult<Output> {
+        /** The validated (and possibly transformed) output value. */
         readonly value: Output;
+        /** Always `undefined` on success; lets `result.issues` discriminate the union. */
         readonly issues?: undefined;
     }
+    /** Failed validation: one or more {@link Issue}s and no output value. */
     interface FailureResult {
+        /** The validation problems found; always non-empty on failure. */
         readonly issues: ReadonlyArray<Issue>;
     }
+    /** One validation problem reported by a validator. */
     interface Issue {
+        /** Human-readable description of the problem. */
         readonly message: string;
+        /** Location of the problem as a key path from the root; omitted for root-level issues. */
         readonly path?: ReadonlyArray<PropertyKey | PathSegment>;
     }
+    /** Object-wrapped path entry used by validators that attach extra metadata to path keys. */
     interface PathSegment {
+        /** The property key this segment addresses. */
         readonly key: PropertyKey;
     }
+    /** Type-level input/output carrier referenced by {@link Props.types}; runtime value is never read. */
     interface Types<Input, Output> {
+        /** The type accepted by the validator before parsing/coercion. */
         readonly input: Input;
+        /** The type produced by the validator after parsing/coercion. */
         readonly output: Output;
     }
+    /** Infers the input (pre-validation) type of a Standard Schema validator. */
     type InferInput<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["input"];
+    /** Infers the output (post-validation) type of a Standard Schema validator. */
     type InferOutput<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["output"];
 }
 /**