Type Declarations ​

This section only covers the public types defined by @silver-formily/react itself, and how it consumes types from other packages on the React side.

If a type already belongs to @silver-formily/core, @silver-formily/path, @silver-formily/validator or @silver-formily/json-schema, the original declaration is not duplicated here; instead, a stable entry point and a link are provided.

When to import from @silver-formily/react ​

• The type directly involves React components, component mappings, scope objects or recursive rendering configuration.
• What you are describing is the props of a React component, not the Core field model itself.
• You need to stay consistent with React components such as SchemaField, RecursionField and ExpressionScope.

Type Map ​

React-specific Types ​

Fields and Contexts ​

• JSXComponent: the React-side component type constraint, keyof React.JSX.IntrinsicElements or a component constructor.
• IProviderProps: the props of FormProvider, with required form and optional children.
• IFormSpyProps: the props of FormConsumer, where children is (form: Form) => React.ReactNode.
• RenderPropsChildren<Payload>: the children of field components, either a render function (field, form) => ReactNode or a plain ReactNode.
• DecoratorContent: decorator content (for x-decorator-content), either plain content or a named prop map.
• IFieldProps<D, C>: field component props; extends Core's IFieldFactoryProps with the React-semantic children, decoratorContent, decorator and component.
• IVoidFieldProps<D, C>: the VoidField component props, sourced similarly to IFieldProps.
• IExpressionScopeProps / IRecordScopeProps / IRecordsScopeProps: the props of ExpressionScope, RecordScope and RecordsScope.

Component Mapping and State Mapping ​

• IComponentMapper<T>: converts one component into another, commonly used in adapters like connect.
• IStateMapper<Props>: maps field state to component props, either with an object mapping or a function mapping.

Schema Rendering ​

• SchemaReactComponents: the component registry of SchemaField, whose keys are the component names referenced in the schema.
• ISchemaFieldReactFactoryOptions: the React configuration entry of createSchemaField, mainly components and scope.
• ISchemaFieldProps: the SchemaField component props.
• ISchemaMapper / ISchemaFilter: map or filter schema nodes during recursive rendering.
• IRecursionFieldProps: the RecursionField component props, where basePath comes from the path system.
• ISchemaMarkupFieldProps / ISchemaTypeFieldProps: the Markup Schema field protocol, preserving React component mapping capabilities.

Helper Generics ​

• KeyOfReactComponent<T>: excludes static keys like contextTypes and displayName from a component object.
• ReactComponentPath<T>: extracts the usable string keys from a component mapping object.
• ReactComponentPropsByPathValue<T, P>: infers a component's props from its key.
• Path<T> / PathValue<T, P>: generics for deep object paths and value lookup.
• ReactChild: deprecated compatibility alias React.ReactElement | string | number; use React.ReactNode in new code.

Types Not Covered Here ​

• Field model, form model, Field, GeneralField, Form: see the Formily Core documentation and Form.
• Path system, FormPathPattern: see the Path documentation.
• Validation rules, Validator, FieldValidator: see the Validator documentation.
• Schema protocol, Schema, ISchema, SchemaKey: see the JSON Schema documentation.

Import Recommendations ​

import type {
  IFieldProps,
  IRecursionFieldProps,
  ISchemaFieldProps,
  SchemaReactComponents,
} from '@silver-formily/react'

If you just want to reuse the underlying models, import them directly from the source packages, which makes the type origins clearer:

import type { Form, GeneralField } from '@silver-formily/core'
import type { ISchema } from '@silver-formily/json-schema'
import type { Pattern } from '@silver-formily/path'
import type { Validator } from '@silver-formily/validator'

Additional public types ​

• ConnectedComponent<T>: the return type of connect, preserving ref types and custom statics.
• ISchemaFieldOptionContext: { components: SchemaReactComponents }; this compatibility type is exported, but SchemaOptionsContext actually uses ISchemaFieldReactFactoryOptions.
• ObjectKey: string | number | boolean | symbol.

Path<T> is a TypeScript utility, not the runtime Path class from @silver-formily/path. The React entry does not re-export JSON Schema APIs, reactive-react hooks, or IObserverProps / IObserverOptions; only observer and Observer are re-exported from reactive-react. Internal ReactiveField, useAttach, and the portal render helper are not public entry exports.