@relyio/sdk 0.10.0 → 0.12.0

package/dist/schema/index.d.cts

@@ -1,6 +1,7 @@
-export { a9 as AggregateBlock, X as AllScopeConfig, F as BUILT_IN_ROLES, G as BUILT_IN_ROLE_ACTIONS, H as BuiltInRole, an as CachePolicy, ao as CachePolicyObject, C as ComponentConfig, s as ComponentDefinition, t as ComponentMetadata, u as ComponentReusabilityMetadata, v as ComponentValidationMetadata, Q as ContentTypeScopeConfig, U as ContentTypesScopeConfig, W as EntryTypeScopeConfig, a8 as FetchBlock, M as FieldVisibility, am as FilterDefinition, a7 as FullTextSearch, ae as HavingOperator, ai as IncludeDefinition, aj as IncludeRelationship, ak as IncludeSelection, aq as IncludeSubQueries, ap as IncludeSubQuery, aw as InferQueryParams, av as InferQueryResponse, I as InferSettingsGroup, q as LocaleDefinition, L as LocaleOptions, ar as Parameterizable, au as QueryCardinality, a4 as QueryConfig, a5 as QueryDefinition, as as QueryParameter, at as QueryParameterType, af as QueryScalar, a6 as QueryType, R as ROLE_ACTIONS, K as ResourcePermission, J as RoleAction, N as RoleConfig, O as RoleDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, aa as SearchBlock, al as SelectMapping, x as SettingsGroupConfig, y as SettingsGroupDefinition, z as SettingsGroupMetadata, ag as SortCondition, ah as SortDirection, T as TextDirection, a1 as ViewConfig, a2 as ViewDefinition, a0 as ViewFilter, $ as ViewFilterCondition, Y as ViewFilterOperator, _ as ViewFilterRelativeDate, Z as ViewFilterValue, V as ViewScopeConfig, ab as WhereCondition, ad as WhereOperator, ac as WhereValue, p as buildFallbackChain, r as defineComponent, k as defineLocale, a3 as defineQuery, A as defineRole, d as defineSchema, w as defineSettingsGroup, P as defineView, n as findDefaultLocale, o as getActiveLocales, E as getBuiltInRoleActions, m as getLocaleCodes, D as isBuiltInRole, l as isLocaleDefinition, B as isRoleDefinition } from '../define-schema-W-0u1Jg1.cjs';
-import { F as FieldUIConfig, a as FieldAIConfig, b as FieldRule, L as LocalizationConfig, S as ShortTextConfig, c as FieldDefinition, d as LongTextConfig, R as RichTextConfig, e as SlugConfig, U as UrlConfig, E as EmailConfig, I as IntegerConfig, D as DecimalConfig, B as BooleanConfig, f as EnumConfig, g as DateConfig, h as DateTimeConfig, i as ReferenceConfig, T as TagsConfig, A as AnyFieldDefinition, j as ListConfig, C as ComponentFieldConfig, k as AIConfig, l as AllFieldTypes, m as AssetAIConfig, n as BaseFieldConfig, o as ComponentFieldType, p as FieldType, q as ReadOnlyRule, r as RequirementRule, s as RuleCondition, t as RuleConditions, V as ValidationRule, u as VisibilityRule } from '../define-content-type-DfnTu26S.cjs';
-export { a5 as AssetTypeConfig, a6 as AssetTypeConfigWithFields, a7 as AssetTypeConfigWithFieldsets, a8 as AssetTypeConfigWithoutFields, a9 as AssetTypeDefinition, M as ContentTypeConfig, N as ContentTypeConfigWithFields, O as ContentTypeConfigWithFieldsets, P as ContentTypeDefinition, aI as ContentTypeWorkflowConfig, y as DeclaredFields, Q as EntryMetadata, v as FieldSchemaContext, w as FieldValue, x as FieldValues, K as Fieldset, ad as FileKindConfig, ar as FileScanConfig, aq as FileUploadConfig, aj as ImageExifConfig, af as ImageFitMode, ab as ImageKindConfig, ag as ImageOutputFormat, ai as ImageSourceConfig, ae as ImageTransform, ah as ImageUploadConfig, aa as InferAssetType, W as InferContentType, a3 as InferSingleton, a2 as InferSingletonContentType, X as LocalePublicationFields, _ as SingletonConfigWithFields, $ as SingletonConfigWithFieldsets, a0 as SingletonContentTypeDefinition, a1 as SingletonMetadata, G as UnresolvedComponent, z as UnresolvedEntry, ak as VariantDefinition, an as VideoCaptionsConfig, ao as VideoDownloadConfig, ac as VideoKindConfig, am as VideoPosterConfig, al as VideoUploadConfig, ap as VideoWatermarkConfig, aD as WorkflowAutoAssign, aG as WorkflowConfig, aH as WorkflowDefinition, aC as WorkflowEscalation, aE as WorkflowStageConfig, aF as WorkflowStageDefinition, a4 as defineAssetType, H as defineContentType, au as defineContentTypeWorkflow, Z as defineSingleton, Y as defineSingletonContentType, as as defineWorkflow, at as defineWorkflowStage, J as fieldset, ay as findWorkflowStage, aA as getFirstWorkflowStage, az as getNextWorkflowStage, ax as getWorkflowStageIds, aB as isFinalWorkflowStage, av as isWorkflowDefinition, aw as isWorkflowStageDefinition } from '../define-content-type-DfnTu26S.cjs';
+export { _ as AggregateBlock, H as AllScopeConfig, B as BUILT_IN_ROLES, v as BUILT_IN_ROLE_ACTIONS, w as BuiltInRole, ab as CachePolicy, ac as CachePolicyObject, D as ContentTypeScopeConfig, E as ContentTypesScopeConfig, G as EntryTypeScopeConfig, Z as FetchBlock, F as FieldVisibility, aa as FilterDefinition, Y as FullTextSearch, a3 as HavingOperator, a7 as IncludeDefinition, a8 as IncludeRelationship, ae as IncludeSubQueries, ad as IncludeSubQuery, ak as InferQueryParams, aj as InferQueryResponse, q as LocaleDefinition, L as LocaleOptions, af as Parameterizable, ai as QueryCardinality, U as QueryConfig, W as QueryDefinition, ag as QueryParameter, ah as QueryParameterType, a4 as QueryScalar, X as QueryType, R as ROLE_ACTIONS, y as ResourcePermission, x as RoleAction, z as RoleConfig, A as RoleDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, $ as SearchBlock, a9 as SelectMapping, a5 as SortCondition, a6 as SortDirection, T as TextDirection, O as ViewConfig, P as ViewDefinition, N as ViewFilter, M as ViewFilterCondition, I as ViewFilterOperator, K as ViewFilterRelativeDate, J as ViewFilterValue, V as ViewScopeConfig, a0 as WhereCondition, a2 as WhereOperator, a1 as WhereValue, p as buildFallbackChain, k as defineLocale, Q as defineQuery, r as defineRole, d as defineSchema, C as defineView, n as findDefaultLocale, o as getActiveLocales, u as getBuiltInRoleActions, m as getLocaleCodes, t as isBuiltInRole, l as isLocaleDefinition, s as isRoleDefinition } from '../define-schema-DgctHlI2.cjs';
+import { F as FieldUIConfig, a as FieldAIConfig, b as FieldRule, L as LocalizationConfig, S as ShortTextConfig, c as FieldDefinition, d as LongTextConfig, R as RichTextConfig, T as TableConfig, C as CodeConfig, e as SlugConfig, U as UrlConfig, E as EmailConfig, I as IntegerConfig, D as DecimalConfig, B as BooleanConfig, f as EnumConfig, g as DateConfig, h as DateTimeConfig, i as ReferenceConfig, j as TagsConfig, A as AnyFieldset, k as ListConfig, O as ObjectConfig, l as AIConfig, m as AnyFieldDefinition, n as AssetAIConfig, o as BaseFieldConfig, p as FieldType, q as ReadOnlyRule, r as RequirementRule, s as RuleCondition, t as RuleConditions, V as ValidationRule, u as VisibilityRule } from '../include-paths-CL4gHv6I.cjs';
+export { J as AssetReading, al as AssetTypeConfig, am as AssetTypeDefinition, G as BlockOf, N as CheckInclude, M as CheckedIncludes, P as ContentReading, a3 as ContentTypeConfig, a4 as ContentTypeDefinition, aV as ContentTypeWorkflowConfig, y as DeclaredFields, a5 as EntryMetadata, a2 as FieldMember, v as FieldSchemaContext, w as FieldValue, x as FieldValues, a1 as Fieldset, aq as FileKindConfig, aE as FileScanConfig, aD as FileUploadConfig, aw as ImageExifConfig, as as ImageFitMode, ao as ImageKindConfig, at as ImageOutputFormat, av as ImageSourceConfig, ar as ImageTransform, au as ImageUploadConfig, Q as IncludablePaths, an as InferAssetType, a6 as InferContentType, aj as InferSettingsGroup, ae as InferSingleton, ad as InferSingletonContentType, K as Keyed, a7 as LocalePublicationFields, X as ReadWith, W as Reading, ag as SettingsGroupConfig, ah as SettingsGroupDefinition, ai as SettingsGroupMetadata, Y as SettingsReading, H as ShapeValue, aa as SingletonConfig, ab as SingletonContentTypeDefinition, ac as SingletonMetadata, Z as SingletonReading, z as UnresolvedEntry, _ as UntypedReading, ax as VariantDefinition, aA as VideoCaptionsConfig, aB as VideoDownloadConfig, ap as VideoKindConfig, az as VideoPosterConfig, ay as VideoUploadConfig, aC as VideoWatermarkConfig, aQ as WorkflowAutoAssign, aT as WorkflowConfig, aU as WorkflowDefinition, aP as WorkflowEscalation, aR as WorkflowStageConfig, aS as WorkflowStageDefinition, ak as defineAssetType, $ as defineContentType, aH as defineContentTypeWorkflow, af as defineSettingsGroup, a9 as defineSingleton, a8 as defineSingletonContentType, aF as defineWorkflow, aG as defineWorkflowStage, a0 as fieldset, aL as findWorkflowStage, aN as getFirstWorkflowStage, aM as getNextWorkflowStage, aK as getWorkflowStageIds, aO as isFinalWorkflowStage, aI as isWorkflowDefinition, aJ as isWorkflowStageDefinition } from '../include-paths-CL4gHv6I.cjs';
+import '../rich-text.d-rKmpgdGd.cjs';
 
 /**
  * Field builders for defining schema fields
@@ -8,7 +9,7 @@ export { a5 as AssetTypeConfig, a6 as AssetTypeConfigWithFields, a7 as AssetType
  *
  * All builders are generic over the ID to preserve literal types for type inference. `enum`,
  * `reference` and `list` are generic over the parts of their config a read's type depends on too —
- * the option values, the targets, `multi` and the subfields — each through a type parameter with a
+ * the option values, the targets, `multi` and the list's shape — each through a type parameter with a
  * primitive or field constraint, which is what keeps a literal from widening without a `const`
  * type parameter (the package supports TypeScript 4.9, which has none).
  */
@@ -29,51 +30,73 @@ interface FieldOptions<TConfig> {
     /** Whether this field is deprecated */
     deprecated?: boolean;
 }
+/**
+ * `required`, kept as the literal it was written as, so a read's type knows which fields are always
+ * present (`schema/infer-fields.ts`, REL-1795) — through a type parameter with a primitive
+ * constraint, as `multi` is, so `true` does not widen to `boolean`.
+ */
+type RequiredAs<TRequired extends boolean> = {
+    required?: TRequired;
+};
 /**
  * Short text field (single line)
  * @example fields.shortText('title', { config: { required: true, maxLength: 200 } })
  */
-declare function shortText<TId extends string>(id: TId, options?: FieldOptions<ShortTextConfig>): FieldDefinition<TId, 'shortText', ShortTextConfig>;
+declare function shortText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ShortTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'shortText', ShortTextConfig & RequiredAs<TRequired>>;
 /**
  * Long text field (multi-line textarea)
  * @example fields.longText('description', { config: { maxLength: 5000 } })
  */
-declare function longText<TId extends string>(id: TId, options?: FieldOptions<LongTextConfig>): FieldDefinition<TId, 'longText', LongTextConfig>;
+declare function longText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<LongTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'longText', LongTextConfig & RequiredAs<TRequired>>;
+/**
+ * Rich text: the docs set of built-ins, narrowed by `structure`, `marks` and `multiline`
+ * @example fields.richText('content', { config: { structure: ['heading', 'bulletList'], marks: ['bold', 'italic', 'link'] } })
+ */
+declare function richText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<RichTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'richText', RichTextConfig & RequiredAs<TRequired>>;
+/**
+ * A table: exactly a rich-text table block's value — rows of formatted cells, an optional header row
+ * and per-cell alignment — so a comparison table on a page and a table in a doc are one thing
+ * (REL-1806). Read as `RichTextTable`; `<RichText>` and `richTextToHtml` render it.
+ * @example fields.table('comparison', { config: { required: true } })
+ */
+declare function table<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<TableConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'table', TableConfig & RequiredAs<TRequired>>;
 /**
- * Rich text field with formatting
- * @example fields.richText('content', { config: { allowedFormats: ['bold', 'italic'] } })
+ * Code with tabs: exactly a rich-text code group's value — one tab or more, each with its label,
+ * language, filename and line range (REL-1806). Read as `RichTextCodeGroup`; `<RichText>` and
+ * `richTextToHtml` render it.
+ * @example fields.code('snippet', { config: { languages: ['typescript', 'bash'], maxTabs: 4 } })
  */
-declare function richText<TId extends string>(id: TId, options?: FieldOptions<RichTextConfig>): FieldDefinition<TId, 'richText', RichTextConfig>;
+declare function code<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<CodeConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'code', CodeConfig & RequiredAs<TRequired>>;
 /**
  * Slug field (URL-friendly identifier)
  * @example fields.slug('slug', { config: { sourceField: 'title' } })
  */
-declare function slug<TId extends string>(id: TId, options?: FieldOptions<SlugConfig>): FieldDefinition<TId, 'slug', SlugConfig>;
+declare function slug<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<SlugConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'slug', SlugConfig & RequiredAs<TRequired>>;
 /**
  * URL field with validation
  * @example fields.url('website', { config: { allowedProtocols: ['https'] } })
  */
-declare function url<TId extends string>(id: TId, options?: FieldOptions<UrlConfig>): FieldDefinition<TId, 'url', UrlConfig>;
+declare function url<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<UrlConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'url', UrlConfig & RequiredAs<TRequired>>;
 /**
  * Email field with validation
  * @example fields.email('contactEmail', { config: { required: true } })
  */
-declare function email<TId extends string>(id: TId, options?: FieldOptions<EmailConfig>): FieldDefinition<TId, 'email', EmailConfig>;
+declare function email<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<EmailConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'email', EmailConfig & RequiredAs<TRequired>>;
 /**
  * Integer field
  * @example fields.integer('quantity', { config: { min: 0, max: 100 } })
  */
-declare function integer<TId extends string>(id: TId, options?: FieldOptions<IntegerConfig>): FieldDefinition<TId, 'integer', IntegerConfig>;
+declare function integer<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<IntegerConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'integer', IntegerConfig & RequiredAs<TRequired>>;
 /**
  * Decimal field with precision
  * @example fields.decimal('weight', { config: { decimalPlaces: 2, min: 0 } })
  */
-declare function decimal<TId extends string>(id: TId, options?: FieldOptions<DecimalConfig>): FieldDefinition<TId, 'decimal', DecimalConfig>;
+declare function decimal<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DecimalConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'decimal', DecimalConfig & RequiredAs<TRequired>>;
 /**
  * Boolean field (true/false toggle)
  * @example fields.boolean('isActive', { config: { defaultValue: false } })
  */
-declare function boolean<TId extends string>(id: TId, options?: FieldOptions<BooleanConfig>): FieldDefinition<TId, 'boolean', BooleanConfig>;
+declare function boolean<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<BooleanConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'boolean', BooleanConfig & RequiredAs<TRequired>>;
 /**
  * Enum field with predefined options
  * @example fields.enum('status', {
@@ -85,49 +108,72 @@ declare function boolean<TId extends string>(id: TId, options?: FieldOptions<Boo
  *   }
  * })
  */
-declare function enumField<TId extends string, TValue extends string = string, TMulti extends boolean = false>(id: TId, options?: FieldOptions<EnumConfig<TValue, TMulti>>): FieldDefinition<TId, 'enum', EnumConfig<TValue, TMulti>>;
+declare function enumField<TId extends string, TValue extends string = string, TMulti extends boolean = false, TRequired extends boolean = false>(id: TId, options?: FieldOptions<EnumConfig<TValue, TMulti> & RequiredAs<TRequired>>): FieldDefinition<TId, 'enum', EnumConfig<TValue, TMulti> & RequiredAs<TRequired>>;
 /**
  * Date field (no time)
  * @example fields.date('publishDate', { config: { minDate: '2024-01-01' } })
  */
-declare function date<TId extends string>(id: TId, options?: FieldOptions<DateConfig>): FieldDefinition<TId, 'date', DateConfig>;
+declare function date<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DateConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'date', DateConfig & RequiredAs<TRequired>>;
 /**
- * DateTime field, stored in UTC or in the author's local time
+ * DateTime field: an instant, stored and read back in UTC whatever offset it is written in.
+ * `timeZoneHandling` says whether the editor shows it in UTC or in the author's local time.
  * @example fields.dateTime('createdAt', { config: { timeZoneHandling: 'UTC' } })
  */
-declare function dateTime<TId extends string>(id: TId, options?: FieldOptions<DateTimeConfig>): FieldDefinition<TId, 'dateTime', DateTimeConfig>;
+declare function dateTime<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DateTimeConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'dateTime', DateTimeConfig & RequiredAs<TRequired>>;
 /**
  * Reference to other entries (content types or asset types)
  * @example fields.reference('category', { config: { to: 'category' } })
  * @example fields.reference('relatedItems', { config: { to: ['product', 'service'], multi: true } })
  * @example fields.reference('heroImage', { config: { to: 'productPhoto' } })
  */
-declare function reference<TId extends string, TTo extends string = string, TMulti extends boolean = false>(id: TId, options?: FieldOptions<ReferenceConfig<TTo, TMulti>>): FieldDefinition<TId, 'reference', ReferenceConfig<TTo, TMulti>>;
+declare function reference<TId extends string, TTo extends string = string, TMulti extends boolean = false, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ReferenceConfig<TTo, TMulti> & RequiredAs<TRequired>>): FieldDefinition<TId, 'reference', ReferenceConfig<TTo, TMulti> & RequiredAs<TRequired>>;
 /**
  * Tags field (array of strings with autocomplete)
  * @example fields.tags('keywords', { config: { predefinedTags: ['featured', 'sale'], maxTags: 10 } })
  */
-declare function tags<TId extends string>(id: TId, options?: FieldOptions<TagsConfig>): FieldDefinition<TId, 'tags', TagsConfig>;
+declare function tags<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<TagsConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'tags', TagsConfig & RequiredAs<TRequired>>;
 /**
- * List field (array of complex items)
+ * List field: a repeatable group of one shape. Each item holds the fields of the fieldset `of`
+ * names — usually a `fieldset()` value, declared once and passed wherever it is wanted — plus
+ * `_type` (that fieldset's id) and `_key` (its item key). Without `of`, a list of strings.
  * @example fields.list('specifications', {
  *   config: {
  *     minItems: 1,
  *     maxItems: 20,
- *     subfields: [
- *       fields.shortText('name', { config: { required: true } }),
- *       fields.shortText('value', { config: { required: true } }),
- *     ]
- *   }
+ *     of: {
+ *       id: 'spec',
+ *       displayName: 'Specification',
+ *       fields: [
+ *         fields.shortText('name', { config: { required: true } }),
+ *         fields.shortText('value', { config: { required: true } }),
+ *       ],
+ *     },
+ *   },
  * })
  */
-declare function list<TId extends string, TSubfields extends readonly AnyFieldDefinition[] = readonly []>(id: TId, options?: FieldOptions<ListConfig<TSubfields>>): FieldDefinition<TId, 'list', ListConfig<TSubfields>>;
+declare function list<TId extends string, TShape extends AnyFieldset = never, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ListConfig<TShape> & RequiredAs<TRequired>>): FieldDefinition<TId, 'list', ListConfig<TShape> & RequiredAs<TRequired>>;
 /**
- * Component field (reusable field group)
- * @example fields.component('seo', 'seoMetadata')
- * @example fields.component('seo', 'seoMetadata', { config: { required: true } })
+ * Object field: one value of a shape. It holds the fields of the fieldset `of` names — usually a
+ * `fieldset()` value, declared once and passed wherever it is wanted — plus `_type` (that
+ * fieldset's id) and `_key`. Or of one of several shapes, `_type` saying which (REL-1799).
+ * @example fields.object('seo', {
+ *   config: {
+ *     of: { id: 'seo', displayName: 'SEO', fields: [fields.shortText('metaTitle')] },
+ *   },
+ * })
+ * @example fields.object('media', {
+ *   config: {
+ *     required: true,
+ *     of: [
+ *       { id: 'screenshot', displayName: 'Screenshot', fields: [fields.reference('image', { config: { to: 'image' } })] },
+ *       { id: 'video', displayName: 'Video', fields: [fields.url('src', { config: { required: true } })] },
+ *     ],
+ *   },
+ * })
  */
-declare function component<TId extends string, TComponentId extends string>(id: TId, componentId: TComponentId, options?: FieldOptions<ComponentFieldConfig>): FieldDefinition<TId, `component(${TComponentId})`, ComponentFieldConfig>;
+declare function object<TId extends string, TShape extends AnyFieldset, TRequired extends boolean = false>(id: TId, options: Omit<FieldOptions<ObjectConfig<TShape> & RequiredAs<TRequired>>, 'config'> & {
+    config: ObjectConfig<TShape> & RequiredAs<TRequired>;
+}): FieldDefinition<TId, 'object', ObjectConfig<TShape> & RequiredAs<TRequired>>;
 
 /**
  * Field builders for defining schema fields
@@ -144,13 +190,11 @@ declare function component<TId extends string, TComponentId extends string>(id:
  */
 
 declare const fieldBuilders_AIConfig: typeof AIConfig;
-declare const fieldBuilders_AllFieldTypes: typeof AllFieldTypes;
 declare const fieldBuilders_AnyFieldDefinition: typeof AnyFieldDefinition;
 declare const fieldBuilders_AssetAIConfig: typeof AssetAIConfig;
 declare const fieldBuilders_BaseFieldConfig: typeof BaseFieldConfig;
 declare const fieldBuilders_BooleanConfig: typeof BooleanConfig;
-declare const fieldBuilders_ComponentFieldConfig: typeof ComponentFieldConfig;
-declare const fieldBuilders_ComponentFieldType: typeof ComponentFieldType;
+declare const fieldBuilders_CodeConfig: typeof CodeConfig;
 declare const fieldBuilders_DateConfig: typeof DateConfig;
 declare const fieldBuilders_DateTimeConfig: typeof DateTimeConfig;
 declare const fieldBuilders_DecimalConfig: typeof DecimalConfig;
@@ -165,6 +209,7 @@ declare const fieldBuilders_IntegerConfig: typeof IntegerConfig;
 declare const fieldBuilders_ListConfig: typeof ListConfig;
 declare const fieldBuilders_LocalizationConfig: typeof LocalizationConfig;
 declare const fieldBuilders_LongTextConfig: typeof LongTextConfig;
+declare const fieldBuilders_ObjectConfig: typeof ObjectConfig;
 declare const fieldBuilders_ReadOnlyRule: typeof ReadOnlyRule;
 declare const fieldBuilders_ReferenceConfig: typeof ReferenceConfig;
 declare const fieldBuilders_RequirementRule: typeof RequirementRule;
@@ -173,12 +218,13 @@ declare const fieldBuilders_RuleCondition: typeof RuleCondition;
 declare const fieldBuilders_RuleConditions: typeof RuleConditions;
 declare const fieldBuilders_ShortTextConfig: typeof ShortTextConfig;
 declare const fieldBuilders_SlugConfig: typeof SlugConfig;
+declare const fieldBuilders_TableConfig: typeof TableConfig;
 declare const fieldBuilders_TagsConfig: typeof TagsConfig;
 declare const fieldBuilders_UrlConfig: typeof UrlConfig;
 declare const fieldBuilders_ValidationRule: typeof ValidationRule;
 declare const fieldBuilders_VisibilityRule: typeof VisibilityRule;
 declare const fieldBuilders_boolean: typeof boolean;
-declare const fieldBuilders_component: typeof component;
+declare const fieldBuilders_code: typeof code;
 declare const fieldBuilders_date: typeof date;
 declare const fieldBuilders_dateTime: typeof dateTime;
 declare const fieldBuilders_decimal: typeof decimal;
@@ -186,14 +232,16 @@ declare const fieldBuilders_email: typeof email;
 declare const fieldBuilders_integer: typeof integer;
 declare const fieldBuilders_list: typeof list;
 declare const fieldBuilders_longText: typeof longText;
+declare const fieldBuilders_object: typeof object;
 declare const fieldBuilders_reference: typeof reference;
 declare const fieldBuilders_richText: typeof richText;
 declare const fieldBuilders_shortText: typeof shortText;
 declare const fieldBuilders_slug: typeof slug;
+declare const fieldBuilders_table: typeof table;
 declare const fieldBuilders_tags: typeof tags;
 declare const fieldBuilders_url: typeof url;
 declare namespace fieldBuilders {
-  export { fieldBuilders_AIConfig as AIConfig, fieldBuilders_AllFieldTypes as AllFieldTypes, fieldBuilders_AnyFieldDefinition as AnyFieldDefinition, fieldBuilders_AssetAIConfig as AssetAIConfig, fieldBuilders_BaseFieldConfig as BaseFieldConfig, fieldBuilders_BooleanConfig as BooleanConfig, fieldBuilders_ComponentFieldConfig as ComponentFieldConfig, fieldBuilders_ComponentFieldType as ComponentFieldType, fieldBuilders_DateConfig as DateConfig, fieldBuilders_DateTimeConfig as DateTimeConfig, fieldBuilders_DecimalConfig as DecimalConfig, fieldBuilders_EmailConfig as EmailConfig, fieldBuilders_EnumConfig as EnumConfig, fieldBuilders_FieldAIConfig as FieldAIConfig, fieldBuilders_FieldDefinition as FieldDefinition, fieldBuilders_FieldRule as FieldRule, fieldBuilders_FieldType as FieldType, fieldBuilders_FieldUIConfig as FieldUIConfig, fieldBuilders_IntegerConfig as IntegerConfig, fieldBuilders_ListConfig as ListConfig, fieldBuilders_LocalizationConfig as LocalizationConfig, fieldBuilders_LongTextConfig as LongTextConfig, fieldBuilders_ReadOnlyRule as ReadOnlyRule, fieldBuilders_ReferenceConfig as ReferenceConfig, fieldBuilders_RequirementRule as RequirementRule, fieldBuilders_RichTextConfig as RichTextConfig, fieldBuilders_RuleCondition as RuleCondition, fieldBuilders_RuleConditions as RuleConditions, fieldBuilders_ShortTextConfig as ShortTextConfig, fieldBuilders_SlugConfig as SlugConfig, fieldBuilders_TagsConfig as TagsConfig, fieldBuilders_UrlConfig as UrlConfig, fieldBuilders_ValidationRule as ValidationRule, fieldBuilders_VisibilityRule as VisibilityRule, fieldBuilders_boolean as boolean, fieldBuilders_component as component, fieldBuilders_date as date, fieldBuilders_dateTime as dateTime, fieldBuilders_decimal as decimal, fieldBuilders_email as email, enumField as enum, fieldBuilders_integer as integer, fieldBuilders_list as list, fieldBuilders_longText as longText, fieldBuilders_reference as reference, fieldBuilders_richText as richText, fieldBuilders_shortText as shortText, fieldBuilders_slug as slug, fieldBuilders_tags as tags, fieldBuilders_url as url };
+  export { fieldBuilders_AIConfig as AIConfig, fieldBuilders_AnyFieldDefinition as AnyFieldDefinition, fieldBuilders_AssetAIConfig as AssetAIConfig, fieldBuilders_BaseFieldConfig as BaseFieldConfig, fieldBuilders_BooleanConfig as BooleanConfig, fieldBuilders_CodeConfig as CodeConfig, fieldBuilders_DateConfig as DateConfig, fieldBuilders_DateTimeConfig as DateTimeConfig, fieldBuilders_DecimalConfig as DecimalConfig, fieldBuilders_EmailConfig as EmailConfig, fieldBuilders_EnumConfig as EnumConfig, fieldBuilders_FieldAIConfig as FieldAIConfig, fieldBuilders_FieldDefinition as FieldDefinition, fieldBuilders_FieldRule as FieldRule, fieldBuilders_FieldType as FieldType, fieldBuilders_FieldUIConfig as FieldUIConfig, fieldBuilders_IntegerConfig as IntegerConfig, fieldBuilders_ListConfig as ListConfig, fieldBuilders_LocalizationConfig as LocalizationConfig, fieldBuilders_LongTextConfig as LongTextConfig, fieldBuilders_ObjectConfig as ObjectConfig, fieldBuilders_ReadOnlyRule as ReadOnlyRule, fieldBuilders_ReferenceConfig as ReferenceConfig, fieldBuilders_RequirementRule as RequirementRule, fieldBuilders_RichTextConfig as RichTextConfig, fieldBuilders_RuleCondition as RuleCondition, fieldBuilders_RuleConditions as RuleConditions, fieldBuilders_ShortTextConfig as ShortTextConfig, fieldBuilders_SlugConfig as SlugConfig, fieldBuilders_TableConfig as TableConfig, fieldBuilders_TagsConfig as TagsConfig, fieldBuilders_UrlConfig as UrlConfig, fieldBuilders_ValidationRule as ValidationRule, fieldBuilders_VisibilityRule as VisibilityRule, fieldBuilders_boolean as boolean, fieldBuilders_code as code, fieldBuilders_date as date, fieldBuilders_dateTime as dateTime, fieldBuilders_decimal as decimal, fieldBuilders_email as email, enumField as enum, fieldBuilders_integer as integer, fieldBuilders_list as list, fieldBuilders_longText as longText, fieldBuilders_object as object, fieldBuilders_reference as reference, fieldBuilders_richText as richText, fieldBuilders_shortText as shortText, fieldBuilders_slug as slug, fieldBuilders_table as table, fieldBuilders_tags as tags, fieldBuilders_url as url };
 }
 
 /**
@@ -227,4 +275,4 @@ declare namespace fieldBuilders {
 
 declare const fields: typeof fieldBuilders;
 
-export { AIConfig, AllFieldTypes, AssetAIConfig, BaseFieldConfig, BooleanConfig, ComponentFieldConfig, ComponentFieldType, DateConfig, DateTimeConfig, DecimalConfig, EmailConfig, EnumConfig, FieldAIConfig, FieldDefinition, FieldRule, FieldType, FieldUIConfig, IntegerConfig, ListConfig, LocalizationConfig, LongTextConfig, ReadOnlyRule, ReferenceConfig, RequirementRule, RichTextConfig, RuleCondition, RuleConditions, ShortTextConfig, SlugConfig, TagsConfig, UrlConfig, ValidationRule, VisibilityRule, fields };
+export { AIConfig, AssetAIConfig, BaseFieldConfig, BooleanConfig, CodeConfig, DateConfig, DateTimeConfig, DecimalConfig, EmailConfig, EnumConfig, FieldAIConfig, FieldDefinition, FieldRule, FieldType, FieldUIConfig, IntegerConfig, ListConfig, LocalizationConfig, LongTextConfig, ObjectConfig, ReadOnlyRule, ReferenceConfig, RequirementRule, RichTextConfig, RuleCondition, RuleConditions, ShortTextConfig, SlugConfig, TableConfig, TagsConfig, UrlConfig, ValidationRule, VisibilityRule, fields };

package/dist/schema/index.d.ts

@@ -1,6 +1,7 @@
-export { a9 as AggregateBlock, X as AllScopeConfig, F as BUILT_IN_ROLES, G as BUILT_IN_ROLE_ACTIONS, H as BuiltInRole, an as CachePolicy, ao as CachePolicyObject, C as ComponentConfig, s as ComponentDefinition, t as ComponentMetadata, u as ComponentReusabilityMetadata, v as ComponentValidationMetadata, Q as ContentTypeScopeConfig, U as ContentTypesScopeConfig, W as EntryTypeScopeConfig, a8 as FetchBlock, M as FieldVisibility, am as FilterDefinition, a7 as FullTextSearch, ae as HavingOperator, ai as IncludeDefinition, aj as IncludeRelationship, ak as IncludeSelection, aq as IncludeSubQueries, ap as IncludeSubQuery, aw as InferQueryParams, av as InferQueryResponse, I as InferSettingsGroup, q as LocaleDefinition, L as LocaleOptions, ar as Parameterizable, au as QueryCardinality, a4 as QueryConfig, a5 as QueryDefinition, as as QueryParameter, at as QueryParameterType, af as QueryScalar, a6 as QueryType, R as ROLE_ACTIONS, K as ResourcePermission, J as RoleAction, N as RoleConfig, O as RoleDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, aa as SearchBlock, al as SelectMapping, x as SettingsGroupConfig, y as SettingsGroupDefinition, z as SettingsGroupMetadata, ag as SortCondition, ah as SortDirection, T as TextDirection, a1 as ViewConfig, a2 as ViewDefinition, a0 as ViewFilter, $ as ViewFilterCondition, Y as ViewFilterOperator, _ as ViewFilterRelativeDate, Z as ViewFilterValue, V as ViewScopeConfig, ab as WhereCondition, ad as WhereOperator, ac as WhereValue, p as buildFallbackChain, r as defineComponent, k as defineLocale, a3 as defineQuery, A as defineRole, d as defineSchema, w as defineSettingsGroup, P as defineView, n as findDefaultLocale, o as getActiveLocales, E as getBuiltInRoleActions, m as getLocaleCodes, D as isBuiltInRole, l as isLocaleDefinition, B as isRoleDefinition } from '../define-schema-rbTrXxNN.js';
-import { F as FieldUIConfig, a as FieldAIConfig, b as FieldRule, L as LocalizationConfig, S as ShortTextConfig, c as FieldDefinition, d as LongTextConfig, R as RichTextConfig, e as SlugConfig, U as UrlConfig, E as EmailConfig, I as IntegerConfig, D as DecimalConfig, B as BooleanConfig, f as EnumConfig, g as DateConfig, h as DateTimeConfig, i as ReferenceConfig, T as TagsConfig, A as AnyFieldDefinition, j as ListConfig, C as ComponentFieldConfig, k as AIConfig, l as AllFieldTypes, m as AssetAIConfig, n as BaseFieldConfig, o as ComponentFieldType, p as FieldType, q as ReadOnlyRule, r as RequirementRule, s as RuleCondition, t as RuleConditions, V as ValidationRule, u as VisibilityRule } from '../define-content-type-DfnTu26S.js';
-export { a5 as AssetTypeConfig, a6 as AssetTypeConfigWithFields, a7 as AssetTypeConfigWithFieldsets, a8 as AssetTypeConfigWithoutFields, a9 as AssetTypeDefinition, M as ContentTypeConfig, N as ContentTypeConfigWithFields, O as ContentTypeConfigWithFieldsets, P as ContentTypeDefinition, aI as ContentTypeWorkflowConfig, y as DeclaredFields, Q as EntryMetadata, v as FieldSchemaContext, w as FieldValue, x as FieldValues, K as Fieldset, ad as FileKindConfig, ar as FileScanConfig, aq as FileUploadConfig, aj as ImageExifConfig, af as ImageFitMode, ab as ImageKindConfig, ag as ImageOutputFormat, ai as ImageSourceConfig, ae as ImageTransform, ah as ImageUploadConfig, aa as InferAssetType, W as InferContentType, a3 as InferSingleton, a2 as InferSingletonContentType, X as LocalePublicationFields, _ as SingletonConfigWithFields, $ as SingletonConfigWithFieldsets, a0 as SingletonContentTypeDefinition, a1 as SingletonMetadata, G as UnresolvedComponent, z as UnresolvedEntry, ak as VariantDefinition, an as VideoCaptionsConfig, ao as VideoDownloadConfig, ac as VideoKindConfig, am as VideoPosterConfig, al as VideoUploadConfig, ap as VideoWatermarkConfig, aD as WorkflowAutoAssign, aG as WorkflowConfig, aH as WorkflowDefinition, aC as WorkflowEscalation, aE as WorkflowStageConfig, aF as WorkflowStageDefinition, a4 as defineAssetType, H as defineContentType, au as defineContentTypeWorkflow, Z as defineSingleton, Y as defineSingletonContentType, as as defineWorkflow, at as defineWorkflowStage, J as fieldset, ay as findWorkflowStage, aA as getFirstWorkflowStage, az as getNextWorkflowStage, ax as getWorkflowStageIds, aB as isFinalWorkflowStage, av as isWorkflowDefinition, aw as isWorkflowStageDefinition } from '../define-content-type-DfnTu26S.js';
+export { _ as AggregateBlock, H as AllScopeConfig, B as BUILT_IN_ROLES, v as BUILT_IN_ROLE_ACTIONS, w as BuiltInRole, ab as CachePolicy, ac as CachePolicyObject, D as ContentTypeScopeConfig, E as ContentTypesScopeConfig, G as EntryTypeScopeConfig, Z as FetchBlock, F as FieldVisibility, aa as FilterDefinition, Y as FullTextSearch, a3 as HavingOperator, a7 as IncludeDefinition, a8 as IncludeRelationship, ae as IncludeSubQueries, ad as IncludeSubQuery, ak as InferQueryParams, aj as InferQueryResponse, q as LocaleDefinition, L as LocaleOptions, af as Parameterizable, ai as QueryCardinality, U as QueryConfig, W as QueryDefinition, ag as QueryParameter, ah as QueryParameterType, a4 as QueryScalar, X as QueryType, R as ROLE_ACTIONS, y as ResourcePermission, x as RoleAction, z as RoleConfig, A as RoleDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, $ as SearchBlock, a9 as SelectMapping, a5 as SortCondition, a6 as SortDirection, T as TextDirection, O as ViewConfig, P as ViewDefinition, N as ViewFilter, M as ViewFilterCondition, I as ViewFilterOperator, K as ViewFilterRelativeDate, J as ViewFilterValue, V as ViewScopeConfig, a0 as WhereCondition, a2 as WhereOperator, a1 as WhereValue, p as buildFallbackChain, k as defineLocale, Q as defineQuery, r as defineRole, d as defineSchema, C as defineView, n as findDefaultLocale, o as getActiveLocales, u as getBuiltInRoleActions, m as getLocaleCodes, t as isBuiltInRole, l as isLocaleDefinition, s as isRoleDefinition } from '../define-schema-mrEZbY1h.js';
+import { F as FieldUIConfig, a as FieldAIConfig, b as FieldRule, L as LocalizationConfig, S as ShortTextConfig, c as FieldDefinition, d as LongTextConfig, R as RichTextConfig, T as TableConfig, C as CodeConfig, e as SlugConfig, U as UrlConfig, E as EmailConfig, I as IntegerConfig, D as DecimalConfig, B as BooleanConfig, f as EnumConfig, g as DateConfig, h as DateTimeConfig, i as ReferenceConfig, j as TagsConfig, A as AnyFieldset, k as ListConfig, O as ObjectConfig, l as AIConfig, m as AnyFieldDefinition, n as AssetAIConfig, o as BaseFieldConfig, p as FieldType, q as ReadOnlyRule, r as RequirementRule, s as RuleCondition, t as RuleConditions, V as ValidationRule, u as VisibilityRule } from '../include-paths-CrJNTsMl.js';
+export { J as AssetReading, al as AssetTypeConfig, am as AssetTypeDefinition, G as BlockOf, N as CheckInclude, M as CheckedIncludes, P as ContentReading, a3 as ContentTypeConfig, a4 as ContentTypeDefinition, aV as ContentTypeWorkflowConfig, y as DeclaredFields, a5 as EntryMetadata, a2 as FieldMember, v as FieldSchemaContext, w as FieldValue, x as FieldValues, a1 as Fieldset, aq as FileKindConfig, aE as FileScanConfig, aD as FileUploadConfig, aw as ImageExifConfig, as as ImageFitMode, ao as ImageKindConfig, at as ImageOutputFormat, av as ImageSourceConfig, ar as ImageTransform, au as ImageUploadConfig, Q as IncludablePaths, an as InferAssetType, a6 as InferContentType, aj as InferSettingsGroup, ae as InferSingleton, ad as InferSingletonContentType, K as Keyed, a7 as LocalePublicationFields, X as ReadWith, W as Reading, ag as SettingsGroupConfig, ah as SettingsGroupDefinition, ai as SettingsGroupMetadata, Y as SettingsReading, H as ShapeValue, aa as SingletonConfig, ab as SingletonContentTypeDefinition, ac as SingletonMetadata, Z as SingletonReading, z as UnresolvedEntry, _ as UntypedReading, ax as VariantDefinition, aA as VideoCaptionsConfig, aB as VideoDownloadConfig, ap as VideoKindConfig, az as VideoPosterConfig, ay as VideoUploadConfig, aC as VideoWatermarkConfig, aQ as WorkflowAutoAssign, aT as WorkflowConfig, aU as WorkflowDefinition, aP as WorkflowEscalation, aR as WorkflowStageConfig, aS as WorkflowStageDefinition, ak as defineAssetType, $ as defineContentType, aH as defineContentTypeWorkflow, af as defineSettingsGroup, a9 as defineSingleton, a8 as defineSingletonContentType, aF as defineWorkflow, aG as defineWorkflowStage, a0 as fieldset, aL as findWorkflowStage, aN as getFirstWorkflowStage, aM as getNextWorkflowStage, aK as getWorkflowStageIds, aO as isFinalWorkflowStage, aI as isWorkflowDefinition, aJ as isWorkflowStageDefinition } from '../include-paths-CrJNTsMl.js';
+import '../rich-text.d-rKmpgdGd.js';
 
 /**
  * Field builders for defining schema fields
@@ -8,7 +9,7 @@ export { a5 as AssetTypeConfig, a6 as AssetTypeConfigWithFields, a7 as AssetType
  *
  * All builders are generic over the ID to preserve literal types for type inference. `enum`,
  * `reference` and `list` are generic over the parts of their config a read's type depends on too —
- * the option values, the targets, `multi` and the subfields — each through a type parameter with a
+ * the option values, the targets, `multi` and the list's shape — each through a type parameter with a
  * primitive or field constraint, which is what keeps a literal from widening without a `const`
  * type parameter (the package supports TypeScript 4.9, which has none).
  */
@@ -29,51 +30,73 @@ interface FieldOptions<TConfig> {
     /** Whether this field is deprecated */
     deprecated?: boolean;
 }
+/**
+ * `required`, kept as the literal it was written as, so a read's type knows which fields are always
+ * present (`schema/infer-fields.ts`, REL-1795) — through a type parameter with a primitive
+ * constraint, as `multi` is, so `true` does not widen to `boolean`.
+ */
+type RequiredAs<TRequired extends boolean> = {
+    required?: TRequired;
+};
 /**
  * Short text field (single line)
  * @example fields.shortText('title', { config: { required: true, maxLength: 200 } })
  */
-declare function shortText<TId extends string>(id: TId, options?: FieldOptions<ShortTextConfig>): FieldDefinition<TId, 'shortText', ShortTextConfig>;
+declare function shortText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ShortTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'shortText', ShortTextConfig & RequiredAs<TRequired>>;
 /**
  * Long text field (multi-line textarea)
  * @example fields.longText('description', { config: { maxLength: 5000 } })
  */
-declare function longText<TId extends string>(id: TId, options?: FieldOptions<LongTextConfig>): FieldDefinition<TId, 'longText', LongTextConfig>;
+declare function longText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<LongTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'longText', LongTextConfig & RequiredAs<TRequired>>;
+/**
+ * Rich text: the docs set of built-ins, narrowed by `structure`, `marks` and `multiline`
+ * @example fields.richText('content', { config: { structure: ['heading', 'bulletList'], marks: ['bold', 'italic', 'link'] } })
+ */
+declare function richText<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<RichTextConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'richText', RichTextConfig & RequiredAs<TRequired>>;
+/**
+ * A table: exactly a rich-text table block's value — rows of formatted cells, an optional header row
+ * and per-cell alignment — so a comparison table on a page and a table in a doc are one thing
+ * (REL-1806). Read as `RichTextTable`; `<RichText>` and `richTextToHtml` render it.
+ * @example fields.table('comparison', { config: { required: true } })
+ */
+declare function table<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<TableConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'table', TableConfig & RequiredAs<TRequired>>;
 /**
- * Rich text field with formatting
- * @example fields.richText('content', { config: { allowedFormats: ['bold', 'italic'] } })
+ * Code with tabs: exactly a rich-text code group's value — one tab or more, each with its label,
+ * language, filename and line range (REL-1806). Read as `RichTextCodeGroup`; `<RichText>` and
+ * `richTextToHtml` render it.
+ * @example fields.code('snippet', { config: { languages: ['typescript', 'bash'], maxTabs: 4 } })
  */
-declare function richText<TId extends string>(id: TId, options?: FieldOptions<RichTextConfig>): FieldDefinition<TId, 'richText', RichTextConfig>;
+declare function code<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<CodeConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'code', CodeConfig & RequiredAs<TRequired>>;
 /**
  * Slug field (URL-friendly identifier)
  * @example fields.slug('slug', { config: { sourceField: 'title' } })
  */
-declare function slug<TId extends string>(id: TId, options?: FieldOptions<SlugConfig>): FieldDefinition<TId, 'slug', SlugConfig>;
+declare function slug<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<SlugConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'slug', SlugConfig & RequiredAs<TRequired>>;
 /**
  * URL field with validation
  * @example fields.url('website', { config: { allowedProtocols: ['https'] } })
  */
-declare function url<TId extends string>(id: TId, options?: FieldOptions<UrlConfig>): FieldDefinition<TId, 'url', UrlConfig>;
+declare function url<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<UrlConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'url', UrlConfig & RequiredAs<TRequired>>;
 /**
  * Email field with validation
  * @example fields.email('contactEmail', { config: { required: true } })
  */
-declare function email<TId extends string>(id: TId, options?: FieldOptions<EmailConfig>): FieldDefinition<TId, 'email', EmailConfig>;
+declare function email<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<EmailConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'email', EmailConfig & RequiredAs<TRequired>>;
 /**
  * Integer field
  * @example fields.integer('quantity', { config: { min: 0, max: 100 } })
  */
-declare function integer<TId extends string>(id: TId, options?: FieldOptions<IntegerConfig>): FieldDefinition<TId, 'integer', IntegerConfig>;
+declare function integer<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<IntegerConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'integer', IntegerConfig & RequiredAs<TRequired>>;
 /**
  * Decimal field with precision
  * @example fields.decimal('weight', { config: { decimalPlaces: 2, min: 0 } })
  */
-declare function decimal<TId extends string>(id: TId, options?: FieldOptions<DecimalConfig>): FieldDefinition<TId, 'decimal', DecimalConfig>;
+declare function decimal<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DecimalConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'decimal', DecimalConfig & RequiredAs<TRequired>>;
 /**
  * Boolean field (true/false toggle)
  * @example fields.boolean('isActive', { config: { defaultValue: false } })
  */
-declare function boolean<TId extends string>(id: TId, options?: FieldOptions<BooleanConfig>): FieldDefinition<TId, 'boolean', BooleanConfig>;
+declare function boolean<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<BooleanConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'boolean', BooleanConfig & RequiredAs<TRequired>>;
 /**
  * Enum field with predefined options
  * @example fields.enum('status', {
@@ -85,49 +108,72 @@ declare function boolean<TId extends string>(id: TId, options?: FieldOptions<Boo
  *   }
  * })
  */
-declare function enumField<TId extends string, TValue extends string = string, TMulti extends boolean = false>(id: TId, options?: FieldOptions<EnumConfig<TValue, TMulti>>): FieldDefinition<TId, 'enum', EnumConfig<TValue, TMulti>>;
+declare function enumField<TId extends string, TValue extends string = string, TMulti extends boolean = false, TRequired extends boolean = false>(id: TId, options?: FieldOptions<EnumConfig<TValue, TMulti> & RequiredAs<TRequired>>): FieldDefinition<TId, 'enum', EnumConfig<TValue, TMulti> & RequiredAs<TRequired>>;
 /**
  * Date field (no time)
  * @example fields.date('publishDate', { config: { minDate: '2024-01-01' } })
  */
-declare function date<TId extends string>(id: TId, options?: FieldOptions<DateConfig>): FieldDefinition<TId, 'date', DateConfig>;
+declare function date<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DateConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'date', DateConfig & RequiredAs<TRequired>>;
 /**
- * DateTime field, stored in UTC or in the author's local time
+ * DateTime field: an instant, stored and read back in UTC whatever offset it is written in.
+ * `timeZoneHandling` says whether the editor shows it in UTC or in the author's local time.
  * @example fields.dateTime('createdAt', { config: { timeZoneHandling: 'UTC' } })
  */
-declare function dateTime<TId extends string>(id: TId, options?: FieldOptions<DateTimeConfig>): FieldDefinition<TId, 'dateTime', DateTimeConfig>;
+declare function dateTime<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<DateTimeConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'dateTime', DateTimeConfig & RequiredAs<TRequired>>;
 /**
  * Reference to other entries (content types or asset types)
  * @example fields.reference('category', { config: { to: 'category' } })
  * @example fields.reference('relatedItems', { config: { to: ['product', 'service'], multi: true } })
  * @example fields.reference('heroImage', { config: { to: 'productPhoto' } })
  */
-declare function reference<TId extends string, TTo extends string = string, TMulti extends boolean = false>(id: TId, options?: FieldOptions<ReferenceConfig<TTo, TMulti>>): FieldDefinition<TId, 'reference', ReferenceConfig<TTo, TMulti>>;
+declare function reference<TId extends string, TTo extends string = string, TMulti extends boolean = false, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ReferenceConfig<TTo, TMulti> & RequiredAs<TRequired>>): FieldDefinition<TId, 'reference', ReferenceConfig<TTo, TMulti> & RequiredAs<TRequired>>;
 /**
  * Tags field (array of strings with autocomplete)
  * @example fields.tags('keywords', { config: { predefinedTags: ['featured', 'sale'], maxTags: 10 } })
  */
-declare function tags<TId extends string>(id: TId, options?: FieldOptions<TagsConfig>): FieldDefinition<TId, 'tags', TagsConfig>;
+declare function tags<TId extends string, TRequired extends boolean = false>(id: TId, options?: FieldOptions<TagsConfig & RequiredAs<TRequired>>): FieldDefinition<TId, 'tags', TagsConfig & RequiredAs<TRequired>>;
 /**
- * List field (array of complex items)
+ * List field: a repeatable group of one shape. Each item holds the fields of the fieldset `of`
+ * names — usually a `fieldset()` value, declared once and passed wherever it is wanted — plus
+ * `_type` (that fieldset's id) and `_key` (its item key). Without `of`, a list of strings.
  * @example fields.list('specifications', {
  *   config: {
  *     minItems: 1,
  *     maxItems: 20,
- *     subfields: [
- *       fields.shortText('name', { config: { required: true } }),
- *       fields.shortText('value', { config: { required: true } }),
- *     ]
- *   }
+ *     of: {
+ *       id: 'spec',
+ *       displayName: 'Specification',
+ *       fields: [
+ *         fields.shortText('name', { config: { required: true } }),
+ *         fields.shortText('value', { config: { required: true } }),
+ *       ],
+ *     },
+ *   },
  * })
  */
-declare function list<TId extends string, TSubfields extends readonly AnyFieldDefinition[] = readonly []>(id: TId, options?: FieldOptions<ListConfig<TSubfields>>): FieldDefinition<TId, 'list', ListConfig<TSubfields>>;
+declare function list<TId extends string, TShape extends AnyFieldset = never, TRequired extends boolean = false>(id: TId, options?: FieldOptions<ListConfig<TShape> & RequiredAs<TRequired>>): FieldDefinition<TId, 'list', ListConfig<TShape> & RequiredAs<TRequired>>;
 /**
- * Component field (reusable field group)
- * @example fields.component('seo', 'seoMetadata')
- * @example fields.component('seo', 'seoMetadata', { config: { required: true } })
+ * Object field: one value of a shape. It holds the fields of the fieldset `of` names — usually a
+ * `fieldset()` value, declared once and passed wherever it is wanted — plus `_type` (that
+ * fieldset's id) and `_key`. Or of one of several shapes, `_type` saying which (REL-1799).
+ * @example fields.object('seo', {
+ *   config: {
+ *     of: { id: 'seo', displayName: 'SEO', fields: [fields.shortText('metaTitle')] },
+ *   },
+ * })
+ * @example fields.object('media', {
+ *   config: {
+ *     required: true,
+ *     of: [
+ *       { id: 'screenshot', displayName: 'Screenshot', fields: [fields.reference('image', { config: { to: 'image' } })] },
+ *       { id: 'video', displayName: 'Video', fields: [fields.url('src', { config: { required: true } })] },
+ *     ],
+ *   },
+ * })
  */
-declare function component<TId extends string, TComponentId extends string>(id: TId, componentId: TComponentId, options?: FieldOptions<ComponentFieldConfig>): FieldDefinition<TId, `component(${TComponentId})`, ComponentFieldConfig>;
+declare function object<TId extends string, TShape extends AnyFieldset, TRequired extends boolean = false>(id: TId, options: Omit<FieldOptions<ObjectConfig<TShape> & RequiredAs<TRequired>>, 'config'> & {
+    config: ObjectConfig<TShape> & RequiredAs<TRequired>;
+}): FieldDefinition<TId, 'object', ObjectConfig<TShape> & RequiredAs<TRequired>>;
 
 /**
  * Field builders for defining schema fields
@@ -144,13 +190,11 @@ declare function component<TId extends string, TComponentId extends string>(id:
  */
 
 declare const fieldBuilders_AIConfig: typeof AIConfig;
-declare const fieldBuilders_AllFieldTypes: typeof AllFieldTypes;
 declare const fieldBuilders_AnyFieldDefinition: typeof AnyFieldDefinition;
 declare const fieldBuilders_AssetAIConfig: typeof AssetAIConfig;
 declare const fieldBuilders_BaseFieldConfig: typeof BaseFieldConfig;
 declare const fieldBuilders_BooleanConfig: typeof BooleanConfig;
-declare const fieldBuilders_ComponentFieldConfig: typeof ComponentFieldConfig;
-declare const fieldBuilders_ComponentFieldType: typeof ComponentFieldType;
+declare const fieldBuilders_CodeConfig: typeof CodeConfig;
 declare const fieldBuilders_DateConfig: typeof DateConfig;
 declare const fieldBuilders_DateTimeConfig: typeof DateTimeConfig;
 declare const fieldBuilders_DecimalConfig: typeof DecimalConfig;
@@ -165,6 +209,7 @@ declare const fieldBuilders_IntegerConfig: typeof IntegerConfig;
 declare const fieldBuilders_ListConfig: typeof ListConfig;
 declare const fieldBuilders_LocalizationConfig: typeof LocalizationConfig;
 declare const fieldBuilders_LongTextConfig: typeof LongTextConfig;
+declare const fieldBuilders_ObjectConfig: typeof ObjectConfig;
 declare const fieldBuilders_ReadOnlyRule: typeof ReadOnlyRule;
 declare const fieldBuilders_ReferenceConfig: typeof ReferenceConfig;
 declare const fieldBuilders_RequirementRule: typeof RequirementRule;
@@ -173,12 +218,13 @@ declare const fieldBuilders_RuleCondition: typeof RuleCondition;
 declare const fieldBuilders_RuleConditions: typeof RuleConditions;
 declare const fieldBuilders_ShortTextConfig: typeof ShortTextConfig;
 declare const fieldBuilders_SlugConfig: typeof SlugConfig;
+declare const fieldBuilders_TableConfig: typeof TableConfig;
 declare const fieldBuilders_TagsConfig: typeof TagsConfig;
 declare const fieldBuilders_UrlConfig: typeof UrlConfig;
 declare const fieldBuilders_ValidationRule: typeof ValidationRule;
 declare const fieldBuilders_VisibilityRule: typeof VisibilityRule;
 declare const fieldBuilders_boolean: typeof boolean;
-declare const fieldBuilders_component: typeof component;
+declare const fieldBuilders_code: typeof code;
 declare const fieldBuilders_date: typeof date;
 declare const fieldBuilders_dateTime: typeof dateTime;
 declare const fieldBuilders_decimal: typeof decimal;
@@ -186,14 +232,16 @@ declare const fieldBuilders_email: typeof email;
 declare const fieldBuilders_integer: typeof integer;
 declare const fieldBuilders_list: typeof list;
 declare const fieldBuilders_longText: typeof longText;
+declare const fieldBuilders_object: typeof object;
 declare const fieldBuilders_reference: typeof reference;
 declare const fieldBuilders_richText: typeof richText;
 declare const fieldBuilders_shortText: typeof shortText;
 declare const fieldBuilders_slug: typeof slug;
+declare const fieldBuilders_table: typeof table;
 declare const fieldBuilders_tags: typeof tags;
 declare const fieldBuilders_url: typeof url;
 declare namespace fieldBuilders {
-  export { fieldBuilders_AIConfig as AIConfig, fieldBuilders_AllFieldTypes as AllFieldTypes, fieldBuilders_AnyFieldDefinition as AnyFieldDefinition, fieldBuilders_AssetAIConfig as AssetAIConfig, fieldBuilders_BaseFieldConfig as BaseFieldConfig, fieldBuilders_BooleanConfig as BooleanConfig, fieldBuilders_ComponentFieldConfig as ComponentFieldConfig, fieldBuilders_ComponentFieldType as ComponentFieldType, fieldBuilders_DateConfig as DateConfig, fieldBuilders_DateTimeConfig as DateTimeConfig, fieldBuilders_DecimalConfig as DecimalConfig, fieldBuilders_EmailConfig as EmailConfig, fieldBuilders_EnumConfig as EnumConfig, fieldBuilders_FieldAIConfig as FieldAIConfig, fieldBuilders_FieldDefinition as FieldDefinition, fieldBuilders_FieldRule as FieldRule, fieldBuilders_FieldType as FieldType, fieldBuilders_FieldUIConfig as FieldUIConfig, fieldBuilders_IntegerConfig as IntegerConfig, fieldBuilders_ListConfig as ListConfig, fieldBuilders_LocalizationConfig as LocalizationConfig, fieldBuilders_LongTextConfig as LongTextConfig, fieldBuilders_ReadOnlyRule as ReadOnlyRule, fieldBuilders_ReferenceConfig as ReferenceConfig, fieldBuilders_RequirementRule as RequirementRule, fieldBuilders_RichTextConfig as RichTextConfig, fieldBuilders_RuleCondition as RuleCondition, fieldBuilders_RuleConditions as RuleConditions, fieldBuilders_ShortTextConfig as ShortTextConfig, fieldBuilders_SlugConfig as SlugConfig, fieldBuilders_TagsConfig as TagsConfig, fieldBuilders_UrlConfig as UrlConfig, fieldBuilders_ValidationRule as ValidationRule, fieldBuilders_VisibilityRule as VisibilityRule, fieldBuilders_boolean as boolean, fieldBuilders_component as component, fieldBuilders_date as date, fieldBuilders_dateTime as dateTime, fieldBuilders_decimal as decimal, fieldBuilders_email as email, enumField as enum, fieldBuilders_integer as integer, fieldBuilders_list as list, fieldBuilders_longText as longText, fieldBuilders_reference as reference, fieldBuilders_richText as richText, fieldBuilders_shortText as shortText, fieldBuilders_slug as slug, fieldBuilders_tags as tags, fieldBuilders_url as url };
+  export { fieldBuilders_AIConfig as AIConfig, fieldBuilders_AnyFieldDefinition as AnyFieldDefinition, fieldBuilders_AssetAIConfig as AssetAIConfig, fieldBuilders_BaseFieldConfig as BaseFieldConfig, fieldBuilders_BooleanConfig as BooleanConfig, fieldBuilders_CodeConfig as CodeConfig, fieldBuilders_DateConfig as DateConfig, fieldBuilders_DateTimeConfig as DateTimeConfig, fieldBuilders_DecimalConfig as DecimalConfig, fieldBuilders_EmailConfig as EmailConfig, fieldBuilders_EnumConfig as EnumConfig, fieldBuilders_FieldAIConfig as FieldAIConfig, fieldBuilders_FieldDefinition as FieldDefinition, fieldBuilders_FieldRule as FieldRule, fieldBuilders_FieldType as FieldType, fieldBuilders_FieldUIConfig as FieldUIConfig, fieldBuilders_IntegerConfig as IntegerConfig, fieldBuilders_ListConfig as ListConfig, fieldBuilders_LocalizationConfig as LocalizationConfig, fieldBuilders_LongTextConfig as LongTextConfig, fieldBuilders_ObjectConfig as ObjectConfig, fieldBuilders_ReadOnlyRule as ReadOnlyRule, fieldBuilders_ReferenceConfig as ReferenceConfig, fieldBuilders_RequirementRule as RequirementRule, fieldBuilders_RichTextConfig as RichTextConfig, fieldBuilders_RuleCondition as RuleCondition, fieldBuilders_RuleConditions as RuleConditions, fieldBuilders_ShortTextConfig as ShortTextConfig, fieldBuilders_SlugConfig as SlugConfig, fieldBuilders_TableConfig as TableConfig, fieldBuilders_TagsConfig as TagsConfig, fieldBuilders_UrlConfig as UrlConfig, fieldBuilders_ValidationRule as ValidationRule, fieldBuilders_VisibilityRule as VisibilityRule, fieldBuilders_boolean as boolean, fieldBuilders_code as code, fieldBuilders_date as date, fieldBuilders_dateTime as dateTime, fieldBuilders_decimal as decimal, fieldBuilders_email as email, enumField as enum, fieldBuilders_integer as integer, fieldBuilders_list as list, fieldBuilders_longText as longText, fieldBuilders_object as object, fieldBuilders_reference as reference, fieldBuilders_richText as richText, fieldBuilders_shortText as shortText, fieldBuilders_slug as slug, fieldBuilders_table as table, fieldBuilders_tags as tags, fieldBuilders_url as url };
 }
 
 /**
@@ -227,4 +275,4 @@ declare namespace fieldBuilders {
 
 declare const fields: typeof fieldBuilders;
 
-export { AIConfig, AllFieldTypes, AssetAIConfig, BaseFieldConfig, BooleanConfig, ComponentFieldConfig, ComponentFieldType, DateConfig, DateTimeConfig, DecimalConfig, EmailConfig, EnumConfig, FieldAIConfig, FieldDefinition, FieldRule, FieldType, FieldUIConfig, IntegerConfig, ListConfig, LocalizationConfig, LongTextConfig, ReadOnlyRule, ReferenceConfig, RequirementRule, RichTextConfig, RuleCondition, RuleConditions, ShortTextConfig, SlugConfig, TagsConfig, UrlConfig, ValidationRule, VisibilityRule, fields };
+export { AIConfig, AssetAIConfig, BaseFieldConfig, BooleanConfig, CodeConfig, DateConfig, DateTimeConfig, DecimalConfig, EmailConfig, EnumConfig, FieldAIConfig, FieldDefinition, FieldRule, FieldType, FieldUIConfig, IntegerConfig, ListConfig, LocalizationConfig, LongTextConfig, ObjectConfig, ReadOnlyRule, ReferenceConfig, RequirementRule, RichTextConfig, RuleCondition, RuleConditions, ShortTextConfig, SlugConfig, TableConfig, TagsConfig, UrlConfig, ValidationRule, VisibilityRule, fields };

package/dist/schema/index.js

@@ -1,4 +1,4 @@
-export { BUILT_IN_ROLES, BUILT_IN_ROLE_ACTIONS, ROLE_ACTIONS, buildFallbackChain, defineAssetType, defineComponent, defineContentType, defineContentTypeWorkflow, defineLocale, defineQuery, defineRole, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, defineView, defineWorkflow, defineWorkflowStage, fields, fieldset, findDefaultLocale, findWorkflowStage, getActiveLocales, getBuiltInRoleActions, getFirstWorkflowStage, getLocaleCodes, getNextWorkflowStage, getWorkflowStageIds, isBuiltInRole, isFinalWorkflowStage, isLocaleDefinition, isRoleDefinition, isWorkflowDefinition, isWorkflowStageDefinition } from '../chunk-IGHYC2WM.js';
+export { BUILT_IN_ROLES, BUILT_IN_ROLE_ACTIONS, ROLE_ACTIONS, buildFallbackChain, defineAssetType, defineContentType, defineContentTypeWorkflow, defineLocale, defineQuery, defineRole, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, defineView, defineWorkflow, defineWorkflowStage, fields, fieldset, findDefaultLocale, findWorkflowStage, getActiveLocales, getBuiltInRoleActions, getFirstWorkflowStage, getLocaleCodes, getNextWorkflowStage, getWorkflowStageIds, isBuiltInRole, isFinalWorkflowStage, isLocaleDefinition, isRoleDefinition, isWorkflowDefinition, isWorkflowStageDefinition } from '../chunk-POEEDYFM.js';
 import '../chunk-XQ4QHWZE.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/types/index.d.cts

@@ -1,2 +1,3 @@
-export { w as ApiResponse, B as BaseContent, t as CacheConfig, y as CacheStrategy, k as ContentQueryResult, o as ContentTypeSchema, C as CreateInput, n as CustomQuery, D as DebugConfig, E as Environment, O as FieldDefinition, p as FieldOptions, F as FieldTypeName, z as LogLevel, P as PerformanceMetrics, Q as QueryOptions, u as RealtimeConfig, r as RealtimeEvent, q as RealtimeEventType, R as RelyIOConfig, v as RequestConfig, x as RetryConfig, l as SingletonContent, j as SortOptions, s as SubscriptionOptions, U as UpdateInput, V as ValidationRule, G as ValidationViolation, h as WhereClause, g as WhereFieldCondition, i as WhereOperator, f as WhereScalar } from '../index-NnLCwSqF.cjs';
-import '../define-content-type-DfnTu26S.cjs';
+export { w as ApiResponse, B as BaseContent, t as CacheConfig, y as CacheStrategy, k as ContentQueryResult, o as ContentTypeSchema, C as CreateInput, n as CustomQuery, D as DebugConfig, E as Environment, O as FieldDefinition, p as FieldOptions, F as FieldTypeName, z as LogLevel, P as PerformanceMetrics, Q as QueryOptions, u as RealtimeConfig, r as RealtimeEvent, q as RealtimeEventType, R as RelyIOConfig, v as RequestConfig, x as RetryConfig, l as SingletonContent, j as SortOptions, s as SubscriptionOptions, U as UpdateInput, V as ValidationRule, G as ValidationViolation, h as WhereClause, g as WhereFieldCondition, i as WhereOperator, f as WhereScalar } from '../index-b-AkfTUv.cjs';
+export { R as RichTextBlock, a as RichTextCellAlignment, b as RichTextCodeBlock, c as RichTextCodeGroup, d as RichTextCodeLines, e as RichTextDivider, f as RichTextHeading, g as RichTextInline, h as RichTextLineBreak, i as RichTextLinkMark, j as RichTextList, k as RichTextListItem, l as RichTextListStyle, m as RichTextMark, n as RichTextMarkType, o as RichTextNode, p as RichTextParagraph, q as RichTextQuote, r as RichTextSpan, s as RichTextStructure, t as RichTextTable, u as RichTextTableCell, v as RichTextTableRow, w as RichTextValue } from '../rich-text.d-rKmpgdGd.cjs';
+import '../include-paths-CL4gHv6I.cjs';