Add promise() schema builder

[Copilot]

@cleverbrush/schema had no way to validate Promise values or express Promise<T> in the inferred type system.

New: PromiseSchemaBuilder + promise() factory

import { promise, string, number, InferType } from '@cleverbrush/schema';

// Untyped — accepts any Promise
const anyPromise = promise();
anyPromise.validate(Promise.resolve(42));     // { valid: true }
anyPromise.validate('not a promise' as any); // { valid: false }

// Typed resolved value — via factory shorthand
const stringPromise = promise(string());
type StringPromise = InferType<typeof stringPromise>; // Promise<string>

// Or via fluent method
const numPromise = promise().hasResolvedType(number());
type NumPromise = InferType<typeof numPromise>; // Promise<number>

// All standard builder methods work
const opt = promise(string()).optional();
type Opt = InferType<typeof opt>; // Promise<string> | undefined

Changes

• PromiseSchemaBuilder.ts — new builder extending SchemaBuilder. Validates via thenable duck-typing (typeof .then === 'function'). Supports .hasResolvedType(schema) to set the resolved-value type; factory shorthand promise(schema?) as sugar. All standard methods preserved (optional, nullable, default, brand, readonly, hasType, etc.). introspect().resolvedType exposes the schema for tooling.
• PromiseSchemaBuilder.test.ts — 25 unit + type tests covering validation, optional/required, hasResolvedType, promise(schema) shorthand, immutability, and type inference.
• Exports — PromiseSchemaBuilder, promise, ExtendedPromise added to core.ts, index.ts, and extensions/index.ts. Subpath export @cleverbrush/schema/promise added to package.json and tsup.config.ts.
• README — promise() added to the API table and builder classes list; new "Promise Schemas" section with usage examples.
• Changeset — minor version bump for @cleverbrush/schema.
• Playground — schemaDeclarations.ts regenerated from build; two new examples (promise-schema, promise-typed) added to the website playground.

[Copilot]

Pull request overview

Introduces first-class Promise support to @cleverbrush/schema via a new PromiseSchemaBuilder and promise() factory, including exports, docs, tests, and playground examples.

Changes:

• Added PromiseSchemaBuilder + promise() factory with resolved-type typing via .hasResolvedType(schema) and promise(schema) shorthand.
• Integrated builder into package exports/build (tsup entry, subpath export) and updated docs/playground examples.
• Added dedicated unit + type tests and regenerated generated artifacts (playground declarations, bundle/bench metadata).

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
website/app/playground/schemaDeclarations.ts	Regenerated playground type declarations to include PromiseSchemaBuilder/promise exports.
website/app/playground/examples/index.ts	Added “Promise Schemas” playground group and two new examples.
README.md	Updated root coverage badge (generated).
libs/schema/tsup.config.ts	Added PromiseSchemaBuilder.ts to build entrypoints.
libs/schema/src/index.ts	Exported PromiseSchemaBuilder, promise, and ExtendedPromise from main entrypoint.
libs/schema/src/extensions/index.ts	Added ExtendedPromise type and exported promise from extensions entrypoint.
libs/schema/src/core.ts	Exported PromiseSchemaBuilder and promise from core.
libs/schema/src/builders/PromiseSchemaBuilder.ts	Implemented the new builder + factory and introspection support.
libs/schema/src/builders/PromiseSchemaBuilder.test.ts	Added unit + type tests for promise validation, typing, and immutability.
libs/schema/README.md	Documented promise(schema?) and added a “Promise Schemas” section + export list updates.
libs/schema/package.json	Added subpath export @cleverbrush/schema/promise.
bundle-sizes.json	Updated bundle size snapshot (generated).
bench-results.json	Updated benchmark snapshot (generated).
.changeset/add-promise-schema-builder.md	Added changeset for a minor release including usage notes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.