@cookbook/urlkit 1.0.0

package/dist/hash/validate-normalized-hash-value.d.ts

@@ -0,0 +1,5 @@
+import type { NormalizedHashDescriptor } from './contracts.js';
+export interface ValidateNormalizedHashValueOptions {
+    readonly serialized: boolean;
+}
+export declare function validateNormalizedHashValue(descriptor: NormalizedHashDescriptor<string | undefined>, input: unknown, options: ValidateNormalizedHashValueOptions): string | undefined;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export * from './url/path-constraints.js';
+export { createConstraint } from '@cookbook/pathkit/constraints';
+export type { ConstraintValidation } from '@cookbook/pathkit';
+export * from './contracts.js';
+export * from './date/contracts.js';
+export * from './errors/contracts.js';
+export * from './errors/url-kit-error.js';
+export * from './schema/array.js';
+export * from './schema/boolean.js';
+export * from './schema/contracts.js';
+export * from './schema/date-time.js';
+export * from './schema/date.js';
+export * from './schema/enum-of.js';
+export * from './schema/int.js';
+export * from './schema/number.js';
+export * from './schema/object.js';
+export * from './schema/string.js';
+export * from './url/contracts.js';
+export * from './url/create-url.js';
+export * from './search/create-search.js';
+export * from './hash/create-hash.js';

package/dist/index.js

@@ -0,0 +1,73 @@
+import { d as date, c as compileSearchSchema, a as compilePath, U as UrlKitError } from './compile-path-wQfWAzOh.js';
+export { b as boolean, e as enumOf, h as hasPathConstraint, i as int, n as number, r as registerPathConstraint, f as registerPathConstraints, s as string } from './compile-path-wQfWAzOh.js';
+export { createConstraint } from '@cookbook/pathkit/constraints';
+import { c as compileHashDescriptor, a as createUrlContract } from './create-url-contract-BYKPM9bn.js';
+export { b as array, g as getObjectSchemaShape, o as object, p as parseArrayRuntimeSchemaValue, s as serializeArrayRuntimeSchemaValue } from './create-url-contract-BYKPM9bn.js';
+import '@cookbook/pathkit/compile';
+import '@cookbook/pathkit/match';
+
+function dateTime() {
+    return date({ format: 'date-time' });
+}
+
+function compileRuntimeUrlDescriptor(descriptor, options = {}) {
+    assertRuntimeUrlDescriptor(descriptor);
+    const mode = Object.prototype.hasOwnProperty.call(descriptor, 'path') ? 'path' : 'pathless';
+    if (descriptor.search) {
+        compileSearchSchema(descriptor.search);
+    }
+    const normalized = {
+        mode,
+        pattern: mode === 'path' ? descriptor.path : undefined,
+        ...(mode === 'path' && descriptor.path !== undefined
+            ? {
+                path: compilePath(descriptor.path, {
+                    params: 'parsed',
+                    ...(options.pathConstraints ? { pathConstraints: options.pathConstraints } : {}),
+                }),
+            }
+            : {}),
+        ...(descriptor.search ? { search: descriptor.search } : {}),
+        ...(descriptor.hash ? { hash: compileHashDescriptor(descriptor.hash).descriptor } : {}),
+    };
+    return Object.freeze(normalized);
+}
+function assertRuntimeUrlDescriptor(input) {
+    if (!isRecord(input)) {
+        throw new UrlKitError('invalid-descriptor', 'Runtime URL descriptor must be an object.', {
+            path: [],
+        });
+    }
+    if (Object.prototype.hasOwnProperty.call(input, 'path') && typeof input.path !== 'string') {
+        throw new UrlKitError('invalid-descriptor', 'Runtime URL descriptor path must be a string.', {
+            path: ['path'],
+        });
+    }
+    if (Object.prototype.hasOwnProperty.call(input, 'search') &&
+        input.search !== undefined &&
+        !isRecord(input.search)) {
+        throw new UrlKitError('invalid-descriptor', 'Runtime URL descriptor search must be an object.', { path: ['search'] });
+    }
+}
+function isRecord(input) {
+    return typeof input === 'object' && input !== null && !Array.isArray(input);
+}
+
+function url(descriptor, options = {}) {
+    return createUrlContract(compileRuntimeUrlDescriptor(descriptor, options), options);
+}
+
+function search(schema, options) {
+    return url({
+        search: schema,
+    }, options);
+}
+
+function hash(schema, options) {
+    return url({
+        hash: schema,
+    }, options);
+}
+
+export { UrlKitError, date, dateTime, hash, search, url };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/schema/date-time.ts","../src/url/compile-runtime-url-descriptor.ts","../src/url/create-url.ts","../src/search/create-search.ts","../src/hash/create-hash.ts"],"sourcesContent":["import type { DateSchema } from './date.js';\nimport { date } from './date.js';\n\nexport interface DateTimeSchema extends DateSchema<'date-time'> {}\n\nexport function dateTime(): DateTimeSchema {\n  return date({ format: 'date-time' });\n}\n","import { UrlKitError } from '../errors/url-kit-error.js';\nimport { compileHashDescriptor } from '../hash/compile-hash-descriptor.js';\nimport { compileSearchSchema } from '../search/compile-search-schema.js';\nimport { compilePath } from './compile-path.js';\nimport type {\n  CreateUrlOptions,\n  NormalizedUrlDescriptor,\n  RuntimeUrlDescriptor,\n  UrlModeFromRuntimeDescriptor,\n} from './contracts.js';\n\nexport function compileRuntimeUrlDescriptor<Descriptor extends RuntimeUrlDescriptor>(\n  descriptor: Descriptor,\n  options: CreateUrlOptions = {},\n): NormalizedUrlDescriptor<UrlModeFromRuntimeDescriptor<Descriptor>> {\n  assertRuntimeUrlDescriptor(descriptor);\n\n  const mode = Object.prototype.hasOwnProperty.call(descriptor, 'path') ? 'path' : 'pathless';\n\n  if (descriptor.search) {\n    compileSearchSchema(descriptor.search);\n  }\n\n  const normalized = {\n    mode,\n    pattern: mode === 'path' ? descriptor.path : undefined,\n    ...(mode === 'path' && descriptor.path !== undefined\n      ? {\n          path: compilePath(descriptor.path, {\n            params: 'parsed',\n            ...(options.pathConstraints ? { pathConstraints: options.pathConstraints } : {}),\n          }),\n        }\n      : {}),\n    ...(descriptor.search ? { search: descriptor.search } : {}),\n    ...(descriptor.hash ? { hash: compileHashDescriptor(descriptor.hash).descriptor } : {}),\n  } as NormalizedUrlDescriptor<UrlModeFromRuntimeDescriptor<Descriptor>>;\n\n  return Object.freeze(normalized);\n}\n\nfunction assertRuntimeUrlDescriptor(input: unknown): asserts input is RuntimeUrlDescriptor {\n  if (!isRecord(input)) {\n    throw new UrlKitError('invalid-descriptor', 'Runtime URL descriptor must be an object.', {\n      path: [],\n    });\n  }\n\n  if (Object.prototype.hasOwnProperty.call(input, 'path') && typeof input.path !== 'string') {\n    throw new UrlKitError('invalid-descriptor', 'Runtime URL descriptor path must be a string.', {\n      path: ['path'],\n    });\n  }\n\n  if (\n    Object.prototype.hasOwnProperty.call(input, 'search') &&\n    input.search !== undefined &&\n    !isRecord(input.search)\n  ) {\n    throw new UrlKitError(\n      'invalid-descriptor',\n      'Runtime URL descriptor search must be an object.',\n      { path: ['search'] },\n    );\n  }\n}\n\nfunction isRecord(input: unknown): input is Record<string, unknown> {\n  return typeof input === 'object' && input !== null && !Array.isArray(input);\n}\n","import { createUrlContract } from './create-url-contract.js';\nimport { compileRuntimeUrlDescriptor } from './compile-runtime-url-descriptor.js';\nimport type {\n  CreateUrlOptions,\n  HashBuildInputFromRuntimeDescriptor,\n  HashFromRuntimeDescriptor,\n  ParamsFromRuntimeDescriptor,\n  PathnameFromRuntimeDescriptor,\n  RuntimeUrlDescriptor,\n  SearchBuildInputFromRuntimeDescriptor,\n  SearchFromRuntimeDescriptor,\n  UrlContract,\n  UrlModeFromRuntimeDescriptor,\n} from './contracts.js';\n\nexport function url<const Descriptor extends RuntimeUrlDescriptor>(\n  descriptor: Descriptor,\n  options: CreateUrlOptions = {},\n): UrlContract<\n  UrlModeFromRuntimeDescriptor<Descriptor>,\n  PathnameFromRuntimeDescriptor<Descriptor>,\n  ParamsFromRuntimeDescriptor<Descriptor>,\n  SearchFromRuntimeDescriptor<Descriptor>,\n  HashFromRuntimeDescriptor<Descriptor>,\n  SearchBuildInputFromRuntimeDescriptor<Descriptor>,\n  HashBuildInputFromRuntimeDescriptor<Descriptor>\n> {\n  return createUrlContract<\n    UrlModeFromRuntimeDescriptor<Descriptor>,\n    PathnameFromRuntimeDescriptor<Descriptor>,\n    ParamsFromRuntimeDescriptor<Descriptor>,\n    SearchFromRuntimeDescriptor<Descriptor>,\n    HashFromRuntimeDescriptor<Descriptor>,\n    SearchBuildInputFromRuntimeDescriptor<Descriptor>,\n    HashBuildInputFromRuntimeDescriptor<Descriptor>\n  >(compileRuntimeUrlDescriptor(descriptor, options), options);\n}\n","import type { EmptyParams } from '../contracts.js';\nimport { url } from '../url/create-url.js';\nimport type { CreateUrlOptions, UrlContract } from '../url/contracts.js';\nimport type {\n  InferRuntimeSearch,\n  InferRuntimeSearchBuildInput,\n  RuntimeSearchSchema,\n} from './contracts.js';\n\nexport function search<const Schema extends RuntimeSearchSchema>(\n  schema: Schema,\n  options?: CreateUrlOptions,\n): UrlContract<\n  'pathless',\n  string,\n  EmptyParams,\n  InferRuntimeSearch<Schema>,\n  undefined,\n  InferRuntimeSearchBuildInput<Schema>\n> {\n  return url(\n    {\n      search: schema,\n    },\n    options,\n  );\n}\n","import type { EmptyParams } from '../contracts.js';\nimport type { InferRuntimeSchemaValue } from '../schema/contracts.js';\nimport { url } from '../url/create-url.js';\nimport type {\n  CreateUrlOptions,\n  HashBuildInputFromRuntimeSchema,\n  UrlContract,\n} from '../url/contracts.js';\nimport type { HashSchema } from './contracts.js';\n\nexport function hash<const Schema extends HashSchema>(\n  schema: Schema,\n  options?: CreateUrlOptions,\n): UrlContract<\n  'pathless',\n  string,\n  EmptyParams,\n  EmptyParams,\n  InferRuntimeSchemaValue<Schema>,\n  EmptyParams,\n  HashBuildInputFromRuntimeSchema<Schema>\n> {\n  return url(\n    {\n      hash: schema,\n    },\n    options,\n  ) as UrlContract<\n    'pathless',\n    string,\n    EmptyParams,\n    EmptyParams,\n    InferRuntimeSchemaValue<Schema>,\n    EmptyParams,\n    HashBuildInputFromRuntimeSchema<Schema>\n  >;\n}\n"],"names":[],"mappings":"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"}

package/dist/router-runtime.d.ts

@@ -0,0 +1,12 @@
+export * from './url/path-constraints.js';
+export { createConstraint } from '@cookbook/pathkit/constraints';
+export type { ConstraintValidation } from '@cookbook/pathkit';
+export { createRouteUrlContract } from './runtime/create-route-url-contract.js';
+export type { CreateRouteUrlContractOptions } from './runtime/contracts.js';
+export { buildSearch, omitSearch, patchSearch, pickSearch, replaceSearch, } from './runtime/build-route-search.js';
+export type { BuildRouteSearchOptions, PatchRouteSearchOptions, } from './runtime/build-route-search.js';
+export { parseSearch } from './runtime/parse-route-search.js';
+export type { ParseSearchOptions } from './runtime/parse-route-search.js';
+export { buildHash } from './hash/build-hash.js';
+export { normalizeHash } from './hash/normalize-hash.js';
+export { parseHash } from './hash/parse-hash.js';

package/dist/router-runtime.js

@@ -0,0 +1,214 @@
+import { a as compilePath, c as compileSearchSchema } from './compile-path-wQfWAzOh.js';
+export { h as hasPathConstraint, r as registerPathConstraint, f as registerPathConstraints } from './compile-path-wQfWAzOh.js';
+export { createConstraint } from '@cookbook/pathkit/constraints';
+import { c as compileStaticHash, a as compileStaticSearch } from './compile-static-search-Cq3uaLe8.js';
+import { a as createUrlContract, d as buildCompiledSearch, e as buildRawSearch, f as omitRawSearch, h as parseRawSearch, i as hasSearchFieldRawValue, j as parseSearchFieldValue, k as deleteSearchFieldRawKeys, l as copyRawSearchParams, m as joinSearchStrings, n as pickRawSearch, q as parseCompiledSearch, r as readHashFragment, c as compileHashDescriptor } from './create-url-contract-BYKPM9bn.js';
+export { t as buildHash, u as parseHash } from './create-url-contract-BYKPM9bn.js';
+import '@cookbook/pathkit/compile';
+import '@cookbook/pathkit/match';
+
+function createRouteUrlContract(descriptor, options) {
+    return createUrlContract(compileRouteUrlDescriptor(descriptor, options), options);
+}
+function compileRouteUrlDescriptor(descriptor, options) {
+    const mode = Object.prototype.hasOwnProperty.call(descriptor, 'path') ? 'path' : 'pathless';
+    const paramsMode = options?.params ?? 'raw';
+    const normalized = {
+        mode,
+        pattern: mode === 'path' ? descriptor.path : undefined,
+        ...(mode === 'path' && descriptor.path !== undefined
+            ? {
+                path: compilePath(descriptor.path, {
+                    params: paramsMode,
+                    ...(options?.pathConstraints ? { pathConstraints: options.pathConstraints } : {}),
+                }),
+            }
+            : {}),
+        ...(Object.prototype.hasOwnProperty.call(descriptor, 'search')
+            ? { search: compileStaticSearch(descriptor.search ?? {}) }
+            : {}),
+        ...(Object.prototype.hasOwnProperty.call(descriptor, 'hash') && descriptor.hash !== undefined
+            ? { hash: compileStaticHash(descriptor.hash) }
+            : {}),
+    };
+    return Object.freeze(normalized);
+}
+
+function buildSchemaSearch(input = {}, schema, options = {}) {
+    return buildCompiledSearch(input, compileSearchSchema(schema), options);
+}
+
+function buildSearch$1(input = {}, options = {}) {
+    if (options.schema) {
+        return buildSchemaSearch(input, options.schema, options);
+    }
+    return buildRawSearch(input, options);
+}
+
+function omitSearch$1(current, keys) {
+    return buildRawSearch(omitRawSearch(parseRawSearch(current), keys));
+}
+
+function parsePartialSchemaSearch(rawSearch, schema, options = {}) {
+    const compiled = compileSearchSchema(schema);
+    const remainingUnknown = { ...rawSearch };
+    const search = {};
+    for (const field of compiled.fields) {
+        if (!hasSearchFieldRawValue(field, rawSearch)) {
+            continue;
+        }
+        const value = parseSearchFieldValue(field, rawSearch, options);
+        deleteSearchFieldRawKeys(field, remainingUnknown);
+        if (value !== undefined) {
+            search[field.key] = value;
+        }
+    }
+    return Object.freeze({
+        search: Object.freeze(search),
+        unknownSearch: copyRawSearchParams(remainingUnknown),
+    });
+}
+
+function patchSearch$1(current, patch, options = {}) {
+    if (options.schema) {
+        return patchSchemaSearch(current, patch, options.schema, options);
+    }
+    return patchRawSearch(current, patch, options);
+}
+function patchRawSearch(current, patch, options) {
+    const merged = { ...parseRawSearch(current) };
+    for (const [key, value] of Object.entries(patch)) {
+        if (shouldRemoveUndefined(value, options) || shouldRemoveNull(value, options)) {
+            delete merged[key];
+            continue;
+        }
+        if (value === undefined || value === null) {
+            continue;
+        }
+        merged[key] = toRawSearchValue(value);
+    }
+    return buildRawSearch(merged, options);
+}
+function patchSchemaSearch(current, patch, schema, options) {
+    const compiled = compileSearchSchema(schema);
+    const schemaKeys = compiled.keys;
+    const currentParsed = parsePartialSchemaSearch(parseRawSearch(current), schema, options);
+    const mergedSearch = { ...currentParsed.search };
+    const unknownSearch = {
+        ...copyRawSearchParams(currentParsed.unknownSearch),
+    };
+    for (const [key, value] of Object.entries(patch)) {
+        if (shouldRemoveUndefined(value, options) || shouldRemoveNull(value, options)) {
+            delete mergedSearch[key];
+            delete unknownSearch[key];
+            continue;
+        }
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (schemaKeys.has(key)) {
+            mergedSearch[key] = value;
+        }
+    }
+    return joinSearchStrings(buildSchemaSearch(mergedSearch, schema, options), buildRawSearch(unknownSearch, options));
+}
+function shouldRemoveUndefined(value, options) {
+    return value === undefined && options.removeUndefined === true;
+}
+function shouldRemoveNull(value, options) {
+    return value === null && options.removeNull === true;
+}
+function toRawSearchValue(value) {
+    if (Array.isArray(value)) {
+        return Object.freeze(value.filter(isPresent).map(String));
+    }
+    return String(value);
+}
+function isPresent(value) {
+    return value !== undefined && value !== null;
+}
+
+function pickSearch$1(current, keys) {
+    return buildRawSearch(pickRawSearch(parseRawSearch(current), keys));
+}
+
+function replaceSearch$1(_current, next, options = {}) {
+    return buildSearch$1(next, options);
+}
+
+const staticSearchCache = new WeakMap();
+function compileCachedStaticSearch(schema) {
+    const cached = staticSearchCache.get(schema);
+    if (cached) {
+        return cached;
+    }
+    const compiled = compileStaticSearch(schema);
+    staticSearchCache.set(schema, compiled);
+    return compiled;
+}
+
+function buildSearch(input = {}, options = {}) {
+    if (!options.schema) {
+        return buildSearch$1(input, options);
+    }
+    return buildSearch$1(input, {
+        ...options,
+        schema: compileCachedStaticSearch(options.schema),
+    });
+}
+function patchSearch(current, patch, options = {}) {
+    if (!options.schema) {
+        return patchSearch$1(current, patch, options);
+    }
+    return patchSearch$1(current, patch, {
+        ...options,
+        schema: compileCachedStaticSearch(options.schema),
+    });
+}
+function replaceSearch(current, next, options = {}) {
+    if (!options.schema) {
+        return replaceSearch$1(current, next, options);
+    }
+    return replaceSearch$1(current, next, {
+        ...options,
+        schema: compileCachedStaticSearch(options.schema),
+    });
+}
+function omitSearch(current, keys) {
+    return omitSearch$1(current, keys);
+}
+function pickSearch(current, keys) {
+    return pickSearch$1(current, keys);
+}
+
+function parseSearch$1(input, options) {
+    const rawSearch = parseRawSearch(input);
+    if (!options?.schema) {
+        return rawSearch;
+    }
+    return parseSchemaSearch(rawSearch, options.schema, options);
+}
+function parseSchemaSearch(rawSearch, schema, options) {
+    return parseCompiledSearch(rawSearch, compileSearchSchema(schema), options.unknownSearch ?? 'strip', options.arrayFormat ? { arrayFormat: options.arrayFormat } : {});
+}
+
+function parseSearch(input, options = {}) {
+    if (!options.schema) {
+        return parseSearch$1(input);
+    }
+    return parseSearch$1(input, {
+        schema: compileCachedStaticSearch(options.schema),
+        ...(options.unknownSearch ? { unknownSearch: options.unknownSearch } : {}),
+        ...(options.arrayFormat ? { arrayFormat: options.arrayFormat } : {}),
+    }).search;
+}
+
+function normalizeHash(input, descriptor) {
+    if (descriptor === undefined) {
+        return readHashFragment(input);
+    }
+    return compileHashDescriptor(descriptor).normalize(input);
+}
+
+export { buildSearch, createRouteUrlContract, normalizeHash, omitSearch, parseSearch, patchSearch, pickSearch, replaceSearch };
+//# sourceMappingURL=router-runtime.js.map

package/dist/router-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-runtime.js","sources":["../src/runtime/create-route-url-contract.ts","../src/search/build-schema-search.ts","../src/search/build-search.ts","../src/search/omit-search.ts","../src/search/parse-partial-schema-search.ts","../src/search/patch-search.ts","../src/search/pick-search.ts","../src/search/replace-search.ts","../src/runtime/compile-cached-static-search.ts","../src/runtime/build-route-search.ts","../src/search/parse-search.ts","../src/runtime/parse-route-search.ts","../src/hash/normalize-hash.ts"],"sourcesContent":["import { compileStaticHash } from '../static/compile-static-hash.js';\nimport { compileStaticSearch } from '../static/compile-static-search.js';\nimport type {\n  InferStaticUrlHash,\n  InferStaticUrlHashBuildInput,\n  InferStaticUrlSearch,\n  InferStaticUrlSearchBuildInput,\n  StaticUrlDescriptor,\n  StaticUrlModeFromDescriptor,\n} from '../static/contracts.js';\nimport { compilePath } from '../url/compile-path.js';\nimport { createUrlContract } from '../url/create-url-contract.js';\nimport type {\n  NormalizedUrlDescriptor,\n  ParamsFromPattern,\n  PathnameFromPattern,\n  RawParamsFromPattern,\n  UrlContract,\n} from '../url/contracts.js';\nimport type { EmptyParams } from '../contracts.js';\nimport type { CreateRouteUrlContractOptions } from './contracts.js';\n\nexport function createRouteUrlContract<\n  const Descriptor extends StaticUrlDescriptor,\n  const Options extends CreateRouteUrlContractOptions | undefined = undefined,\n>(\n  descriptor: Descriptor,\n  options?: Options,\n): UrlContract<\n  StaticUrlModeFromDescriptor<Descriptor>,\n  RoutePathnameFromDescriptor<Descriptor>,\n  RouteParamsFromDescriptor<Descriptor, Options>,\n  InferStaticUrlSearch<Descriptor>,\n  InferStaticUrlHash<Descriptor>,\n  InferStaticUrlSearchBuildInput<Descriptor>,\n  InferStaticUrlHashBuildInput<Descriptor>\n> {\n  return createUrlContract<\n    StaticUrlModeFromDescriptor<Descriptor>,\n    RoutePathnameFromDescriptor<Descriptor>,\n    RouteParamsFromDescriptor<Descriptor, Options>,\n    InferStaticUrlSearch<Descriptor>,\n    InferStaticUrlHash<Descriptor>,\n    InferStaticUrlSearchBuildInput<Descriptor>,\n    InferStaticUrlHashBuildInput<Descriptor>\n  >(compileRouteUrlDescriptor(descriptor, options), options);\n}\n\nexport type RoutePathnameFromDescriptor<Descriptor extends StaticUrlDescriptor> =\n  Descriptor extends {\n    readonly path: infer Pattern extends string;\n  }\n    ? PathnameFromPattern<Pattern>\n    : string;\n\nexport type RouteParamsFromDescriptor<\n  Descriptor extends StaticUrlDescriptor,\n  Options extends CreateRouteUrlContractOptions | undefined,\n> = Descriptor extends { readonly path: infer Pattern extends string }\n  ? RouteParamsMode<Options> extends 'parsed'\n    ? ParamsFromPattern<Pattern>\n    : RawParamsFromPattern<Pattern>\n  : EmptyParams;\n\ntype RouteParamsMode<Options extends CreateRouteUrlContractOptions | undefined> = Options extends {\n  readonly params: 'parsed';\n}\n  ? 'parsed'\n  : 'raw';\n\nfunction compileRouteUrlDescriptor<\n  Descriptor extends StaticUrlDescriptor,\n  Options extends CreateRouteUrlContractOptions | undefined,\n>(\n  descriptor: Descriptor,\n  options: Options,\n): NormalizedUrlDescriptor<StaticUrlModeFromDescriptor<Descriptor>> {\n  const mode = Object.prototype.hasOwnProperty.call(descriptor, 'path') ? 'path' : 'pathless';\n  const paramsMode = options?.params ?? 'raw';\n\n  const normalized = {\n    mode,\n    pattern: mode === 'path' ? descriptor.path : undefined,\n    ...(mode === 'path' && descriptor.path !== undefined\n      ? {\n          path: compilePath(descriptor.path, {\n            params: paramsMode,\n            ...(options?.pathConstraints ? { pathConstraints: options.pathConstraints } : {}),\n          }),\n        }\n      : {}),\n    ...(Object.prototype.hasOwnProperty.call(descriptor, 'search')\n      ? { search: compileStaticSearch(descriptor.search ?? {}) }\n      : {}),\n    ...(Object.prototype.hasOwnProperty.call(descriptor, 'hash') && descriptor.hash !== undefined\n      ? { hash: compileStaticHash(descriptor.hash) }\n      : {}),\n  } as NormalizedUrlDescriptor<StaticUrlModeFromDescriptor<Descriptor>>;\n\n  return Object.freeze(normalized);\n}\n","import type { BuildSearchOptions } from '../contracts.js';\nimport { compileSearchSchema } from './compile-search-schema.js';\nimport type { RuntimeSearchSchema } from './contracts.js';\nimport { buildCompiledSearch } from './build-compiled-search.js';\n\nexport function buildSchemaSearch(\n  input: Record<string, unknown> = {},\n  schema: RuntimeSearchSchema,\n  options: BuildSearchOptions = {},\n): string {\n  return buildCompiledSearch(input, compileSearchSchema(schema), options);\n}\n","import type { BuildSearchOptions, SearchInputArgument } from '../contracts.js';\nimport type {\n  InferRuntimeSearchBuildInput,\n  RuntimeSearchSchema,\n  SearchBuildOptions,\n} from './contracts.js';\nimport { buildRawSearch } from './build-raw-search.js';\nimport { buildSchemaSearch } from './build-schema-search.js';\n\nexport function buildSearch<const Schema extends RuntimeSearchSchema>(\n  input: SearchInputArgument<InferRuntimeSearchBuildInput<Schema>>,\n  options: SearchBuildOptions<Schema> & { readonly schema: Schema },\n): string;\nexport function buildSearch(input?: Record<string, unknown>, options?: BuildSearchOptions): string;\nexport function buildSearch(\n  input: Record<string, unknown> | undefined = {},\n  options: SearchBuildOptions<RuntimeSearchSchema> = {},\n): string {\n  if (options.schema) {\n    return buildSchemaSearch(input, options.schema, options);\n  }\n\n  return buildRawSearch(input, options);\n}\n","import { buildRawSearch } from './build-raw-search.js';\nimport { omitRawSearch } from './filter-raw-search.js';\nimport { parseRawSearch } from './parse-raw-search.js';\n\nexport function omitSearch(current: string | URLSearchParams, keys: readonly string[]): string {\n  return buildRawSearch(omitRawSearch(parseRawSearch(current), keys));\n}\n","import type {\n  RawSearchParams,\n  RawSearchValue,\n  RuntimeSearchSchema,\n  SearchParseOptions,\n} from './contracts.js';\nimport { compileSearchSchema } from './compile-search-schema.js';\nimport { copyRawSearchParams } from './copy-raw-search-params.js';\nimport { parseSearchFieldValue } from './parse-search-field-value.js';\nimport { deleteSearchFieldRawKeys } from './delete-search-field-raw-keys.js';\nimport { hasSearchFieldRawValue } from './has-search-field-raw-value.js';\n\nexport interface PartialSchemaSearchParseResult {\n  readonly search: Record<string, unknown>;\n  readonly unknownSearch: RawSearchParams;\n}\n\nexport function parsePartialSchemaSearch(\n  rawSearch: RawSearchParams,\n  schema: RuntimeSearchSchema,\n  options: SearchParseOptions = {},\n): PartialSchemaSearchParseResult {\n  const compiled = compileSearchSchema(schema);\n  const remainingUnknown = { ...rawSearch } satisfies Record<string, RawSearchValue>;\n  const search: Record<string, unknown> = {};\n\n  for (const field of compiled.fields) {\n    if (!hasSearchFieldRawValue(field, rawSearch)) {\n      continue;\n    }\n\n    const value = parseSearchFieldValue(field, rawSearch, options);\n    deleteSearchFieldRawKeys(field, remainingUnknown);\n\n    if (value !== undefined) {\n      search[field.key] = value;\n    }\n  }\n\n  return Object.freeze({\n    search: Object.freeze(search),\n    unknownSearch: copyRawSearchParams(remainingUnknown),\n  });\n}\n","import type { BuildSearchOptions, PatchSearchOptions } from '../contracts.js';\nimport type {\n  InferRuntimeSearch,\n  RawSearchValue,\n  RuntimeSearchSchema,\n  SearchPatchOptions,\n} from './contracts.js';\nimport { buildRawSearch } from './build-raw-search.js';\nimport { buildSchemaSearch } from './build-schema-search.js';\nimport { compileSearchSchema } from './compile-search-schema.js';\nimport { copyRawSearchParams } from './copy-raw-search-params.js';\nimport { joinSearchStrings } from './join-search-strings.js';\nimport { parsePartialSchemaSearch } from './parse-partial-schema-search.js';\nimport { parseRawSearch } from './parse-raw-search.js';\n\nexport function patchSearch<const Schema extends RuntimeSearchSchema>(\n  current: string | URLSearchParams,\n  patch: Partial<InferRuntimeSearch<Schema>>,\n  options: SearchPatchOptions<Schema> & { readonly schema: Schema },\n): string;\nexport function patchSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  options?: PatchSearchOptions,\n): string;\nexport function patchSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  options: SearchPatchOptions<RuntimeSearchSchema> = {},\n): string {\n  if (options.schema) {\n    return patchSchemaSearch(current, patch, options.schema, options);\n  }\n\n  return patchRawSearch(current, patch, options);\n}\n\nfunction patchRawSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  options: PatchSearchOptions,\n): string {\n  const merged: Record<string, RawSearchValue> = { ...parseRawSearch(current) };\n\n  for (const [key, value] of Object.entries(patch)) {\n    if (shouldRemoveUndefined(value, options) || shouldRemoveNull(value, options)) {\n      delete merged[key];\n      continue;\n    }\n\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    merged[key] = toRawSearchValue(value);\n  }\n\n  return buildRawSearch(merged, options);\n}\n\nfunction patchSchemaSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  schema: RuntimeSearchSchema,\n  options: SearchPatchOptions<RuntimeSearchSchema>,\n): string {\n  const compiled = compileSearchSchema(schema);\n  const schemaKeys = compiled.keys;\n  const currentParsed = parsePartialSchemaSearch(parseRawSearch(current), schema, options);\n  const mergedSearch: Record<string, unknown> = { ...currentParsed.search };\n  const unknownSearch: Record<string, RawSearchValue> = {\n    ...copyRawSearchParams(currentParsed.unknownSearch),\n  };\n\n  for (const [key, value] of Object.entries(patch)) {\n    if (shouldRemoveUndefined(value, options) || shouldRemoveNull(value, options)) {\n      delete mergedSearch[key];\n      delete unknownSearch[key];\n      continue;\n    }\n\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    if (schemaKeys.has(key)) {\n      mergedSearch[key] = value;\n    }\n  }\n\n  return joinSearchStrings(\n    buildSchemaSearch(mergedSearch, schema, options as BuildSearchOptions),\n    buildRawSearch(unknownSearch, options),\n  );\n}\n\nfunction shouldRemoveUndefined(value: unknown, options: PatchSearchOptions): boolean {\n  return value === undefined && options.removeUndefined === true;\n}\n\nfunction shouldRemoveNull(value: unknown, options: PatchSearchOptions): boolean {\n  return value === null && options.removeNull === true;\n}\n\nfunction toRawSearchValue(value: unknown): RawSearchValue {\n  if (Array.isArray(value)) {\n    return Object.freeze(value.filter(isPresent).map(String));\n  }\n\n  return String(value);\n}\n\nfunction isPresent(value: unknown): boolean {\n  return value !== undefined && value !== null;\n}\n","import { buildRawSearch } from './build-raw-search.js';\nimport { pickRawSearch } from './filter-raw-search.js';\nimport { parseRawSearch } from './parse-raw-search.js';\n\nexport function pickSearch(current: string | URLSearchParams, keys: readonly string[]): string {\n  return buildRawSearch(pickRawSearch(parseRawSearch(current), keys));\n}\n","import type {\n  InferRuntimeSearchBuildInput,\n  RuntimeSearchSchema,\n  SearchBuildOptions,\n} from './contracts.js';\nimport { buildSearch } from './build-search.js';\n\nexport function replaceSearch<const Schema extends RuntimeSearchSchema>(\n  current: string | URLSearchParams,\n  next: InferRuntimeSearchBuildInput<Schema>,\n  options: SearchBuildOptions<Schema> & { readonly schema: Schema },\n): string;\nexport function replaceSearch(\n  current: string | URLSearchParams,\n  next: Record<string, unknown>,\n  options?: SearchBuildOptions,\n): string;\nexport function replaceSearch(\n  _current: string | URLSearchParams,\n  next: object,\n  options: SearchBuildOptions = {},\n): string {\n  return buildSearch(next as Record<string, unknown>, options);\n}\n","import type { RuntimeSearchSchema } from '../search/contracts.js';\nimport { compileStaticSearch } from '../static/compile-static-search.js';\nimport type { StaticSearchDescriptor } from '../static/contracts.js';\n\nconst staticSearchCache = new WeakMap<StaticSearchDescriptor, RuntimeSearchSchema>();\n\nexport function compileCachedStaticSearch(schema: StaticSearchDescriptor): RuntimeSearchSchema {\n  const cached = staticSearchCache.get(schema);\n\n  if (cached) {\n    return cached;\n  }\n\n  const compiled = compileStaticSearch(schema);\n  staticSearchCache.set(schema, compiled);\n\n  return compiled;\n}\n","import type { BuildSearchOptions, PatchSearchOptions, SearchInputArgument } from '../contracts.js';\nimport { buildSearch as buildRuntimeSearch } from '../search/build-search.js';\nimport { omitSearch as omitRuntimeSearch } from '../search/omit-search.js';\nimport { patchSearch as patchRuntimeSearch } from '../search/patch-search.js';\nimport { pickSearch as pickRuntimeSearch } from '../search/pick-search.js';\nimport { replaceSearch as replaceRuntimeSearch } from '../search/replace-search.js';\nimport { compileCachedStaticSearch } from './compile-cached-static-search.js';\nimport type {\n  InferStaticSearch,\n  InferStaticSearchBuildInput,\n  StaticSearchDescriptor,\n} from '../static/contracts.js';\n\nexport interface BuildRouteSearchOptions<\n  SearchDescriptor = StaticSearchDescriptor,\n> extends BuildSearchOptions {\n  readonly schema?: SearchDescriptor;\n}\n\nexport interface PatchRouteSearchOptions<\n  SearchDescriptor = StaticSearchDescriptor,\n> extends PatchSearchOptions {\n  readonly schema?: SearchDescriptor;\n}\n\nexport function buildSearch<const SearchDescriptor extends StaticSearchDescriptor>(\n  input: SearchInputArgument<InferStaticSearchBuildInput<SearchDescriptor>>,\n  options: BuildRouteSearchOptions<SearchDescriptor> & { readonly schema: SearchDescriptor },\n): string;\nexport function buildSearch(input?: Record<string, unknown>, options?: BuildSearchOptions): string;\nexport function buildSearch(\n  input: Record<string, unknown> | undefined = {},\n  options: BuildRouteSearchOptions = {},\n): string {\n  if (!options.schema) {\n    return buildRuntimeSearch(input, options);\n  }\n\n  return buildRuntimeSearch(input, {\n    ...options,\n    schema: compileCachedStaticSearch(options.schema),\n  });\n}\n\nexport function patchSearch<const SearchDescriptor extends StaticSearchDescriptor>(\n  current: string | URLSearchParams,\n  patch: Partial<InferStaticSearch<SearchDescriptor>>,\n  options: PatchRouteSearchOptions<SearchDescriptor> & { readonly schema: SearchDescriptor },\n): string;\nexport function patchSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  options?: PatchSearchOptions,\n): string;\nexport function patchSearch(\n  current: string | URLSearchParams,\n  patch: Record<string, unknown>,\n  options: PatchRouteSearchOptions = {},\n): string {\n  if (!options.schema) {\n    return patchRuntimeSearch(current, patch, options);\n  }\n\n  return patchRuntimeSearch(current, patch, {\n    ...options,\n    schema: compileCachedStaticSearch(options.schema),\n  });\n}\n\nexport function replaceSearch<const SearchDescriptor extends StaticSearchDescriptor>(\n  current: string | URLSearchParams,\n  next: InferStaticSearchBuildInput<SearchDescriptor>,\n  options: BuildRouteSearchOptions<SearchDescriptor> & { readonly schema: SearchDescriptor },\n): string;\nexport function replaceSearch(\n  current: string | URLSearchParams,\n  next: Record<string, unknown>,\n  options?: BuildSearchOptions,\n): string;\nexport function replaceSearch(\n  current: string | URLSearchParams,\n  next: Record<string, unknown>,\n  options: BuildRouteSearchOptions = {},\n): string {\n  if (!options.schema) {\n    return replaceRuntimeSearch(current, next, options);\n  }\n\n  return replaceRuntimeSearch(current, next, {\n    ...options,\n    schema: compileCachedStaticSearch(options.schema),\n  });\n}\n\nexport function omitSearch(current: string | URLSearchParams, keys: readonly string[]): string {\n  return omitRuntimeSearch(current, keys);\n}\n\nexport function pickSearch(current: string | URLSearchParams, keys: readonly string[]): string {\n  return pickRuntimeSearch(current, keys);\n}\n","import type {\n  InferRuntimeSearch,\n  ParseSearchOptions,\n  RawSearchParams,\n  RuntimeSearchSchema,\n  SearchParseResult,\n} from './contracts.js';\nimport { compileSearchSchema } from './compile-search-schema.js';\nimport { parseRawSearch } from './parse-raw-search.js';\nimport { parseCompiledSearch } from './parse-compiled-search.js';\n\nexport function parseSearch(input: string | URLSearchParams): RawSearchParams;\nexport function parseSearch<const Schema extends RuntimeSearchSchema>(\n  input: string | URLSearchParams,\n  options: ParseSearchOptions<Schema> & { readonly schema: Schema },\n): SearchParseResult<InferRuntimeSearch<Schema>>;\nexport function parseSearch(\n  input: string | URLSearchParams,\n  options?: ParseSearchOptions<RuntimeSearchSchema>,\n): RawSearchParams | SearchParseResult<Record<string, unknown>> {\n  const rawSearch = parseRawSearch(input);\n\n  if (!options?.schema) {\n    return rawSearch;\n  }\n\n  return parseSchemaSearch(rawSearch, options.schema, options);\n}\n\nfunction parseSchemaSearch(\n  rawSearch: RawSearchParams,\n  schema: RuntimeSearchSchema,\n  options: ParseSearchOptions,\n): SearchParseResult<Record<string, unknown>> {\n  return parseCompiledSearch(\n    rawSearch,\n    compileSearchSchema(schema),\n    options.unknownSearch ?? 'strip',\n    options.arrayFormat ? { arrayFormat: options.arrayFormat } : {},\n  );\n}\n","import type { SearchArrayFormat, UnknownSearchBehavior } from '../contracts.js';\nimport { parseSearch as parseRuntimeSearch } from '../search/parse-search.js';\nimport type { RawSearchParams } from '../search/contracts.js';\nimport { compileCachedStaticSearch } from './compile-cached-static-search.js';\nimport type { InferStaticSearch, StaticSearchDescriptor } from '../static/contracts.js';\n\nexport interface ParseSearchOptions<SearchDescriptor = StaticSearchDescriptor> {\n  readonly schema?: SearchDescriptor;\n  readonly unknownSearch?: UnknownSearchBehavior;\n  readonly arrayFormat?: SearchArrayFormat;\n}\n\nexport function parseSearch<const SearchDescriptor extends StaticSearchDescriptor>(\n  input: string | URLSearchParams,\n  options: ParseSearchOptions<SearchDescriptor> & { readonly schema: SearchDescriptor },\n): InferStaticSearch<SearchDescriptor>;\nexport function parseSearch(\n  input: string | URLSearchParams,\n  options?: ParseSearchOptions,\n): RawSearchParams;\nexport function parseSearch(\n  input: string | URLSearchParams,\n  options: ParseSearchOptions = {},\n): RawSearchParams | Record<string, unknown> {\n  if (!options.schema) {\n    return parseRuntimeSearch(input);\n  }\n\n  return parseRuntimeSearch(input, {\n    schema: compileCachedStaticSearch(options.schema),\n    ...(options.unknownSearch ? { unknownSearch: options.unknownSearch } : {}),\n    ...(options.arrayFormat ? { arrayFormat: options.arrayFormat } : {}),\n  }).search;\n}\n","import type { HashDescriptorInput } from './contracts.js';\nimport { compileHashDescriptor } from './compile-hash-descriptor.js';\nimport { readHashFragment } from './hash-fragment.js';\n\nexport function normalizeHash(input: unknown): string | undefined;\nexport function normalizeHash(input: unknown, descriptor: HashDescriptorInput): unknown;\nexport function normalizeHash(input: unknown, descriptor?: HashDescriptorInput): unknown {\n  if (descriptor === undefined) {\n    return readHashFragment(input);\n  }\n\n  return compileHashDescriptor(descriptor).normalize(input);\n}\n"],"names":["buildSearch","omitSearch","patchSearch","pickSearch","replaceSearch","buildRuntimeSearch","patchRuntimeSearch","replaceRuntimeSearch","omitRuntimeSearch","pickRuntimeSearch","parseSearch","parseRuntimeSearch"],"mappings":"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"}

package/dist/runtime/build-route-search.d.ts

@@ -0,0 +1,22 @@
+import type { BuildSearchOptions, PatchSearchOptions, SearchInputArgument } from '../contracts.js';
+import type { InferStaticSearch, InferStaticSearchBuildInput, StaticSearchDescriptor } from '../static/contracts.js';
+export interface BuildRouteSearchOptions<SearchDescriptor = StaticSearchDescriptor> extends BuildSearchOptions {
+    readonly schema?: SearchDescriptor;
+}
+export interface PatchRouteSearchOptions<SearchDescriptor = StaticSearchDescriptor> extends PatchSearchOptions {
+    readonly schema?: SearchDescriptor;
+}
+export declare function buildSearch<const SearchDescriptor extends StaticSearchDescriptor>(input: SearchInputArgument<InferStaticSearchBuildInput<SearchDescriptor>>, options: BuildRouteSearchOptions<SearchDescriptor> & {
+    readonly schema: SearchDescriptor;
+}): string;
+export declare function buildSearch(input?: Record<string, unknown>, options?: BuildSearchOptions): string;
+export declare function patchSearch<const SearchDescriptor extends StaticSearchDescriptor>(current: string | URLSearchParams, patch: Partial<InferStaticSearch<SearchDescriptor>>, options: PatchRouteSearchOptions<SearchDescriptor> & {
+    readonly schema: SearchDescriptor;
+}): string;
+export declare function patchSearch(current: string | URLSearchParams, patch: Record<string, unknown>, options?: PatchSearchOptions): string;
+export declare function replaceSearch<const SearchDescriptor extends StaticSearchDescriptor>(current: string | URLSearchParams, next: InferStaticSearchBuildInput<SearchDescriptor>, options: BuildRouteSearchOptions<SearchDescriptor> & {
+    readonly schema: SearchDescriptor;
+}): string;
+export declare function replaceSearch(current: string | URLSearchParams, next: Record<string, unknown>, options?: BuildSearchOptions): string;
+export declare function omitSearch(current: string | URLSearchParams, keys: readonly string[]): string;
+export declare function pickSearch(current: string | URLSearchParams, keys: readonly string[]): string;

package/dist/runtime/compile-cached-static-search.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeSearchSchema } from '../search/contracts.js';
+import type { StaticSearchDescriptor } from '../static/contracts.js';
+export declare function compileCachedStaticSearch(schema: StaticSearchDescriptor): RuntimeSearchSchema;

package/dist/runtime/contracts.d.ts

@@ -0,0 +1,7 @@
+import type { PathConstraintMap, SearchArrayFormat, UnknownSearchBehavior } from '../contracts.js';
+export interface CreateRouteUrlContractOptions {
+    readonly params?: 'raw' | 'parsed';
+    readonly unknownSearch?: UnknownSearchBehavior;
+    readonly arrayFormat?: SearchArrayFormat;
+    readonly pathConstraints?: PathConstraintMap;
+}

package/dist/runtime/create-route-url-contract.d.ts

@@ -0,0 +1,15 @@
+import type { InferStaticUrlHash, InferStaticUrlHashBuildInput, InferStaticUrlSearch, InferStaticUrlSearchBuildInput, StaticUrlDescriptor, StaticUrlModeFromDescriptor } from '../static/contracts.js';
+import type { ParamsFromPattern, PathnameFromPattern, RawParamsFromPattern, UrlContract } from '../url/contracts.js';
+import type { EmptyParams } from '../contracts.js';
+import type { CreateRouteUrlContractOptions } from './contracts.js';
+export declare function createRouteUrlContract<const Descriptor extends StaticUrlDescriptor, const Options extends CreateRouteUrlContractOptions | undefined = undefined>(descriptor: Descriptor, options?: Options): UrlContract<StaticUrlModeFromDescriptor<Descriptor>, RoutePathnameFromDescriptor<Descriptor>, RouteParamsFromDescriptor<Descriptor, Options>, InferStaticUrlSearch<Descriptor>, InferStaticUrlHash<Descriptor>, InferStaticUrlSearchBuildInput<Descriptor>, InferStaticUrlHashBuildInput<Descriptor>>;
+export type RoutePathnameFromDescriptor<Descriptor extends StaticUrlDescriptor> = Descriptor extends {
+    readonly path: infer Pattern extends string;
+} ? PathnameFromPattern<Pattern> : string;
+export type RouteParamsFromDescriptor<Descriptor extends StaticUrlDescriptor, Options extends CreateRouteUrlContractOptions | undefined> = Descriptor extends {
+    readonly path: infer Pattern extends string;
+} ? RouteParamsMode<Options> extends 'parsed' ? ParamsFromPattern<Pattern> : RawParamsFromPattern<Pattern> : EmptyParams;
+type RouteParamsMode<Options extends CreateRouteUrlContractOptions | undefined> = Options extends {
+    readonly params: 'parsed';
+} ? 'parsed' : 'raw';
+export {};

package/dist/runtime/parse-route-search.d.ts

@@ -0,0 +1,12 @@
+import type { SearchArrayFormat, UnknownSearchBehavior } from '../contracts.js';
+import type { RawSearchParams } from '../search/contracts.js';
+import type { InferStaticSearch, StaticSearchDescriptor } from '../static/contracts.js';
+export interface ParseSearchOptions<SearchDescriptor = StaticSearchDescriptor> {
+    readonly schema?: SearchDescriptor;
+    readonly unknownSearch?: UnknownSearchBehavior;
+    readonly arrayFormat?: SearchArrayFormat;
+}
+export declare function parseSearch<const SearchDescriptor extends StaticSearchDescriptor>(input: string | URLSearchParams, options: ParseSearchOptions<SearchDescriptor> & {
+    readonly schema: SearchDescriptor;
+}): InferStaticSearch<SearchDescriptor>;
+export declare function parseSearch(input: string | URLSearchParams, options?: ParseSearchOptions): RawSearchParams;

package/dist/schema/array.d.ts

@@ -0,0 +1,9 @@
+import type { AnyRuntimeSchemaBuilder, InferRuntimeSchemaValue, NormalizedRuntimeSchemaDescriptor, RequiredRuntimeSchemaDescriptor, RuntimeSchemaOptions, RuntimeSchemaBuilder, RuntimeSchemaValueContext } from './contracts.js';
+export interface ArraySchemaOptions<ElementDescriptor extends NormalizedRuntimeSchemaDescriptor = NormalizedRuntimeSchemaDescriptor> extends RuntimeSchemaOptions {
+    readonly element: ElementDescriptor;
+}
+export interface ArraySchema<Schema extends AnyRuntimeSchemaBuilder> extends RuntimeSchemaBuilder<readonly Exclude<InferRuntimeSchemaValue<Schema>, undefined>[], 'array', ArraySchemaOptions, RequiredRuntimeSchemaDescriptor<'array', ArraySchemaOptions>> {
+}
+export declare function array<Schema extends AnyRuntimeSchemaBuilder>(element: Schema): ArraySchema<Schema>;
+export declare function parseArrayRuntimeSchemaValue<Schema extends AnyRuntimeSchemaBuilder>(schema: ArraySchema<Schema>, input: string | readonly string[], context: RuntimeSchemaValueContext): readonly Exclude<InferRuntimeSchemaValue<Schema>, undefined>[];
+export declare function serializeArrayRuntimeSchemaValue<Schema extends AnyRuntimeSchemaBuilder>(schema: ArraySchema<Schema>, input: unknown, context: RuntimeSchemaValueContext): readonly string[] | undefined;

package/dist/schema/boolean.d.ts

@@ -0,0 +1,4 @@
+import type { EmptyRuntimeSchemaOptions, RequiredRuntimeSchemaDescriptor, RuntimeSchemaBuilder } from './contracts.js';
+export interface BooleanSchema extends RuntimeSchemaBuilder<boolean, 'boolean', EmptyRuntimeSchemaOptions, RequiredRuntimeSchemaDescriptor<'boolean', EmptyRuntimeSchemaOptions>> {
+}
+export declare function boolean(): BooleanSchema;

package/dist/schema/compile-runtime-schema-value.d.ts

@@ -0,0 +1,6 @@
+import type { CompileRuntimeSchemaOptions, NormalizedRuntimeSchemaDescriptor, RuntimeSchemaBuilder, RuntimeSchemaCodec, RuntimeSchemaOptions } from './contracts.js';
+export interface CompiledRuntimeSchema<Value = unknown> {
+    readonly descriptor: NormalizedRuntimeSchemaDescriptor;
+    readonly codec?: RuntimeSchemaCodec<Value>;
+}
+export declare function compileRuntimeSchemaValue<Value, Kind extends string, Options extends RuntimeSchemaOptions, Descriptor extends NormalizedRuntimeSchemaDescriptor<Kind, Options>>(schema: RuntimeSchemaBuilder<Value, Kind, Options, Descriptor>, options?: CompileRuntimeSchemaOptions): CompiledRuntimeSchema<Value>;

package/dist/schema/compile-runtime-schema.d.ts

@@ -0,0 +1,2 @@
+import type { CompileRuntimeSchemaOptions, NormalizedRuntimeSchemaDescriptor, RuntimeSchemaBuilder, RuntimeSchemaOptions } from './contracts.js';
+export declare function compileRuntimeSchema<Value, Kind extends string, Options extends RuntimeSchemaOptions, Descriptor extends NormalizedRuntimeSchemaDescriptor<Kind, Options>>(schema: RuntimeSchemaBuilder<Value, Kind, Options, Descriptor>, options?: CompileRuntimeSchemaOptions): Descriptor;

package/dist/schema/contracts.d.ts

@@ -0,0 +1,87 @@
+import type { UrlKitErrorCode } from '../errors/contracts.js';
+import type { UrlKitError } from '../errors/url-kit-error.js';
+export type RuntimeSchemaPresence = 'required' | 'optional' | 'defaulted';
+export type RuntimeSchemaOptions = Readonly<Record<string, unknown>>;
+export type EmptyRuntimeSchemaOptions = Readonly<Record<never, never>>;
+export interface RuntimeDefaultValidationContext {
+    readonly kind: string;
+    readonly path: readonly string[];
+}
+export interface RuntimeSchemaValueContext {
+    readonly kind: string;
+    readonly path: readonly string[];
+    readonly errorCode: UrlKitErrorCode;
+}
+export interface RuntimeSchemaValueOptions {
+    readonly path?: readonly string[];
+    readonly errorCode?: UrlKitErrorCode;
+    readonly missingCode?: UrlKitErrorCode;
+}
+export type RuntimeDefaultValidator<Value = unknown> = (value: Value, context: RuntimeDefaultValidationContext) => void;
+export type RuntimeDescriptorValidator = (context: RuntimeDefaultValidationContext) => void;
+export interface RuntimeSchemaCodec<Value> {
+    readonly parse: (input: string, context: RuntimeSchemaValueContext) => Value;
+    readonly normalize: (input: unknown, context: RuntimeSchemaValueContext) => Value;
+    readonly serialize: (input: Value, context: RuntimeSchemaValueContext) => string;
+}
+export interface RuntimeSchemaDefinition<Kind extends string, Options extends RuntimeSchemaOptions, Value> {
+    readonly kind: Kind;
+    readonly options?: Options;
+    readonly codec?: RuntimeSchemaCodec<Value>;
+    readonly validateDefault?: RuntimeDefaultValidator<Value>;
+    readonly validateDescriptor?: RuntimeDescriptorValidator;
+}
+export interface BaseRuntimeSchemaDescriptor<Kind extends string, Options extends RuntimeSchemaOptions> {
+    readonly kind: Kind;
+    readonly presence: RuntimeSchemaPresence;
+    readonly options: Options;
+}
+export interface RequiredRuntimeSchemaDescriptor<Kind extends string = string, Options extends RuntimeSchemaOptions = RuntimeSchemaOptions> extends BaseRuntimeSchemaDescriptor<Kind, Options> {
+    readonly presence: 'required';
+}
+export interface OptionalRuntimeSchemaDescriptor<Kind extends string = string, Options extends RuntimeSchemaOptions = RuntimeSchemaOptions> extends BaseRuntimeSchemaDescriptor<Kind, Options> {
+    readonly presence: 'optional';
+}
+export interface DefaultedRuntimeSchemaDescriptor<Kind extends string = string, Options extends RuntimeSchemaOptions = RuntimeSchemaOptions, DefaultValue = unknown> extends BaseRuntimeSchemaDescriptor<Kind, Options> {
+    readonly presence: 'defaulted';
+    readonly defaultValue: DefaultValue;
+}
+export type NormalizedRuntimeSchemaDescriptor<Kind extends string = string, Options extends RuntimeSchemaOptions = RuntimeSchemaOptions, DefaultValue = unknown> = RequiredRuntimeSchemaDescriptor<Kind, Options> | OptionalRuntimeSchemaDescriptor<Kind, Options> | DefaultedRuntimeSchemaDescriptor<Kind, Options, DefaultValue>;
+export interface RuntimeSchemaInternals<Value, Kind extends string, Options extends RuntimeSchemaOptions, Descriptor extends NormalizedRuntimeSchemaDescriptor<Kind, Options>> {
+    readonly kind: Kind;
+    readonly presence: Descriptor['presence'];
+    readonly options: Options;
+    readonly defaultValue?: unknown;
+    readonly codec?: RuntimeSchemaCodec<Value>;
+    readonly validateDefault?: RuntimeDefaultValidator<Value>;
+    readonly validateDescriptor?: RuntimeDescriptorValidator;
+    readonly toDescriptor: () => Descriptor;
+}
+declare const runtimeSchemaTypeSymbol: unique symbol;
+export interface RuntimeSchemaBuilder<Value, Kind extends string = string, Options extends RuntimeSchemaOptions = RuntimeSchemaOptions, Descriptor extends NormalizedRuntimeSchemaDescriptor<Kind, Options> = NormalizedRuntimeSchemaDescriptor<Kind, Options>> {
+    readonly [runtimeSchemaTypeSymbol]?: {
+        readonly value: Value;
+        readonly kind: Kind;
+        readonly options: Options;
+        readonly descriptor: Descriptor;
+    };
+    readonly optional: () => RuntimeSchemaBuilder<Value | undefined, Kind, Options, OptionalRuntimeSchemaDescriptor<Kind, Options>>;
+    readonly required: () => RuntimeSchemaBuilder<NonNullable<Value>, Kind, Options, RequiredRuntimeSchemaDescriptor<Kind, Options>>;
+    readonly default: (value: NonNullable<Value>) => RuntimeSchemaBuilder<NonNullable<Value>, Kind, Options, DefaultedRuntimeSchemaDescriptor<Kind, Options, NonNullable<Value>>>;
+}
+export interface CompileRuntimeSchemaOptions {
+    readonly path?: readonly string[];
+}
+export type AnyRuntimeSchemaBuilder = RuntimeSchemaBuilder<any, any, any, any>;
+export type InferRuntimeSchemaValue<Schema> = Schema extends RuntimeSchemaBuilder<infer Value> ? Value : never;
+export type InferRuntimeSchemaDescriptor<Schema> = Schema extends RuntimeSchemaBuilder<any, any, any, infer Descriptor> ? Descriptor : never;
+export interface RuntimeSchemaSafeSuccess<Value> {
+    readonly success: true;
+    readonly data: Value;
+}
+export interface RuntimeSchemaSafeFailure {
+    readonly success: false;
+    readonly error: UrlKitError;
+}
+export type RuntimeSchemaSafeResult<Value> = RuntimeSchemaSafeSuccess<Value> | RuntimeSchemaSafeFailure;
+export {};

package/dist/schema/create-schema-builder.d.ts

@@ -0,0 +1,2 @@
+import type { EmptyRuntimeSchemaOptions, RequiredRuntimeSchemaDescriptor, RuntimeSchemaBuilder, RuntimeSchemaDefinition, RuntimeSchemaOptions } from './contracts.js';
+export declare function createRuntimeSchemaBuilder<Value, const Kind extends string, Options extends RuntimeSchemaOptions = EmptyRuntimeSchemaOptions>(definition: RuntimeSchemaDefinition<Kind, Options, Value>): RuntimeSchemaBuilder<Value, Kind, Options, RequiredRuntimeSchemaDescriptor<Kind, Options>>;

package/dist/schema/create-schema-value-error.d.ts

@@ -0,0 +1,3 @@
+import type { UrlKitErrorCode } from '../errors/contracts.js';
+import { UrlKitError } from '../errors/url-kit-error.js';
+export declare function createSchemaValueError(code: UrlKitErrorCode, message: string, path: readonly string[], cause?: unknown): UrlKitError;

package/dist/schema/date-time.d.ts

@@ -0,0 +1,4 @@
+import type { DateSchema } from './date.js';
+export interface DateTimeSchema extends DateSchema<'date-time'> {
+}
+export declare function dateTime(): DateTimeSchema;