schema-components 1.29.0 → 2.0.0

package/dist/renderer-OaOz-n6-.d.mts

@@ -1,185 +0,0 @@
-import { E as StringConstraints, f as FileConstraints, j as WalkedField, t as ArrayConstraints, w as SchemaMeta, x as ObjectConstraints, y as NumberConstraints } from "./types-C2Ay1FEh.mjs";
-
-//#region src/core/renderer.d.ts
-/**
- * Flat intersection of all constraint types.
- * Used in renderer props where the render function receives the union
- * but knows (by resolver key) which subset applies.
- *
- * The walker's discriminated WalkedField enforces type-correct constraints
- * at construction time; the renderer consumes them as this flat type.
- */
-type AllConstraints = StringConstraints & NumberConstraints & ArrayConstraints & ObjectConstraints & FileConstraints;
-/**
- * Properties available on every schema field, regardless of rendering target.
- * Both React and HTML renderers receive these.
- *
- * Per-type schema data — enum values, object fields, array element schema,
- * union options, record key/value types, tuple `prefixItems`, conditional
- * if/then/else clauses, negation `negated`, recursive `refTarget`, literal
- * values — lives on the discriminated `tree`. Renderers narrow on
- * `tree.type` and read from the matching variant; there are no duplicate
- * sibling fields on these props.
- */
-interface BaseFieldProps {
-  /** Current field value. */
-  value: unknown;
-  /** Whether to render as read-only display. */
-  readOnly: boolean;
-  /** Whether to render as an empty input. */
-  writeOnly: boolean;
-  /** Schema metadata for this field. */
-  meta: SchemaMeta;
-  /** Constraints from schema checks. */
-  constraints: AllConstraints;
-  /** Dot-separated path from root (e.g. "address.city"). */
-  path: string;
-  /** Example values from the schema's `examples` keyword. */
-  examples?: unknown[];
-  /** Walked field tree for recursive rendering. */
-  tree: WalkedField;
-}
-/**
- * Props for React render functions. Extends BaseFieldProps with:
- * - `onChange` — callback to propagate value changes back to state
- * - `renderChild` — recursively renders a child field, threading onChange
- */
-interface RenderProps extends BaseFieldProps {
-  /** Callback to update the field value. */
-  onChange: (value: unknown) => void;
-  /**
-   * Render a child field. Theme adapters call this to recursively render
-   * nested structures (object fields, array elements, union options).
-   * The resolver and rendering context are already wired in.
-   *
-   * @param tree - The walked field tree for the child
-   * @param value - The child's current value
-   * @param onChange - Callback receiving the child's next value
-   * @param pathSuffix - Path segment from the parent (e.g. "city",
-   *   "[0]"). Joined to the parent's path with a dot, or substituted
-   *   when the parent acts as a transparent wrapper (union options).
-   *   Required for every container — without it children inherit no
-   *   path and `inputId()` will throw.
-   */
-  renderChild: (tree: WalkedField, value: unknown, onChange: (v: unknown) => void, pathSuffix?: string) => unknown;
-}
-/**
- * Props for HTML render functions. Extends BaseFieldProps with:
- * - `renderChild` — recursively renders a child field to HTML string
- *
- * No `onChange` — HTML rendering is pure output with no event handling.
- */
-interface HtmlRenderProps extends BaseFieldProps {
-  /**
-   * Render a child field to an HTML string. Theme adapters call this
-   * to recursively render nested structures.
-   *
-   * @param tree - The walked field tree for the child
-   * @param value - The child's current value
-   * @param pathSuffix - Path segment from the parent (e.g. "city",
-   *   "[0]"). When omitted, the child's description is used as fallback.
-   */
-  renderChild: (tree: WalkedField, value: unknown, pathSuffix?: string) => string;
-}
-/**
- * Build the `RenderProps` object handed to a resolver render function or a
- * widget. Used by both the server-side `<SchemaView>` (which has no
- * `onChange`) and the client-side `<SchemaComponent>` (which threads an
- * `onChange` callback).
- *
- * When `onChange` is `undefined` the caller is rendering in read-only mode:
- * a noop `onChange` is wired up, `readOnly` is forced to `true`, and
- * `writeOnly` is forced to `false`. Otherwise the editability is taken
- * from `tree.editability`.
- */
-declare function buildRenderProps(tree: WalkedField, value: unknown, onChange: ((next: unknown) => void) | undefined, renderChild: RenderProps["renderChild"], path: string): RenderProps;
-/**
- * Signature for a React render function attached to a
- * {@link ComponentResolver}. Receives the per-field {@link RenderProps}
- * built by the walker and returns any ReactNode-compatible value.
- */
-type RenderFunction = (props: RenderProps) => unknown;
-/**
- * Theme adapter — maps every schema field type to its React renderer.
- * Unset keys fall back to the headless resolver. Pass to
- * `SchemaProvider` (or `SchemaView.resolver`) to drive every
- * schema-driven render with a specific theme.
- */
-interface ComponentResolver {
-  string?: RenderFunction;
-  number?: RenderFunction;
-  boolean?: RenderFunction;
-  null?: RenderFunction;
-  enum?: RenderFunction;
-  object?: RenderFunction;
-  array?: RenderFunction;
-  tuple?: RenderFunction;
-  record?: RenderFunction;
-  union?: RenderFunction;
-  discriminatedUnion?: RenderFunction;
-  conditional?: RenderFunction;
-  negation?: RenderFunction;
-  recursive?: RenderFunction;
-  literal?: RenderFunction;
-  file?: RenderFunction;
-  never?: RenderFunction;
-  unknown?: RenderFunction;
-}
-/** An HTML render function returns a string. */
-type HtmlRenderFunction = (props: HtmlRenderProps) => string;
-/**
- * HTML resolver — maps schema types to HTML string renderers.
- * Structurally mirrors ComponentResolver but produces strings.
- */
-interface HtmlResolver {
-  string?: HtmlRenderFunction;
-  number?: HtmlRenderFunction;
-  boolean?: HtmlRenderFunction;
-  null?: HtmlRenderFunction;
-  enum?: HtmlRenderFunction;
-  object?: HtmlRenderFunction;
-  array?: HtmlRenderFunction;
-  tuple?: HtmlRenderFunction;
-  record?: HtmlRenderFunction;
-  union?: HtmlRenderFunction;
-  discriminatedUnion?: HtmlRenderFunction;
-  conditional?: HtmlRenderFunction;
-  negation?: HtmlRenderFunction;
-  recursive?: HtmlRenderFunction;
-  literal?: HtmlRenderFunction;
-  file?: HtmlRenderFunction;
-  never?: HtmlRenderFunction;
-  unknown?: HtmlRenderFunction;
-}
-/**
- * Canonical list of resolver keys, one per {@link WalkedField} variant.
- * Iterated by the resolver merge helpers so adding a new key here is the
- * single point of change when a new field variant is introduced.
- */
-declare const RESOLVER_KEYS: readonly ["string", "number", "boolean", "null", "enum", "object", "array", "tuple", "record", "union", "discriminatedUnion", "conditional", "negation", "literal", "file", "never", "unknown"];
-type ResolverKey = (typeof RESOLVER_KEYS)[number];
-/**
- * Map a schema type to the resolver key that handles it.
- * Every WalkedField variant has a direct resolver key — exhaustive switch
- * ensures new variants surface as a type error rather than silently
- * falling through to "unknown".
- */
-declare function typeToKey(type: WalkedField["type"]): ResolverKey;
-/**
- * Look up the render function for a schema type in a ComponentResolver.
- */
-declare function getRenderFunction(type: WalkedField["type"], resolver: ComponentResolver): RenderFunction | undefined;
-/**
- * Look up the render function for a schema type in an HtmlResolver.
- */
-declare function getHtmlRenderFn(type: WalkedField["type"], resolver: HtmlResolver): HtmlRenderFunction | undefined;
-/**
- * Merge two ComponentResolvers — user values take priority, fallback fills gaps.
- */
-declare function mergeResolvers(user: ComponentResolver, fallback: ComponentResolver): ComponentResolver;
-/**
- * Merge two HtmlResolvers — user values take priority, fallback fills gaps.
- */
-declare function mergeHtmlResolvers(user: HtmlResolver, fallback: HtmlResolver): HtmlResolver;
-//#endregion
-export { HtmlRenderProps as a, RenderFunction as c, getHtmlRenderFn as d, getRenderFunction as f, typeToKey as h, HtmlRenderFunction as i, RenderProps as l, mergeResolvers as m, BaseFieldProps as n, HtmlResolver as o, mergeHtmlResolvers as p, ComponentResolver as r, RESOLVER_KEYS as s, AllConstraints as t, buildRenderProps as u };