@datocms/cma-client 5.1.2 → 5.1.4

package/dist/esm/index.d.ts

@@ -10,6 +10,8 @@ export * from './utilities/fieldValue';
 export * from './utilities/id';
 export * from './utilities/recursiveBlocks';
 export * from './utilities/schemaRepository';
+export * from './utilities/itemDefinition';
+export * from './fieldTypes';
 export type { ApiTypes, RawApiTypes };
 export type { ApiTypes as SchemaTypes, RawApiTypes as SimpleSchemaTypes };
 import type * as ApiTypes from './generated/ApiTypes';

package/dist/esm/index.js

@@ -9,4 +9,6 @@ export * from './utilities/fieldValue';
 export * from './utilities/id';
 export * from './utilities/recursiveBlocks';
 export * from './utilities/schemaRepository';
+export * from './utilities/itemDefinition';
+export * from './fieldTypes';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

package/dist/esm/utilities/buildBlockRecord.d.ts

@@ -1,32 +1,6 @@
+import type { NewBlockInARequest } from '../fieldTypes';
 import type * as ApiTypes from '../generated/ApiTypes';
-import type * as RawApiTypes from '../generated/RawApiTypes';
-export declare function buildBlockRecord(body: ApiTypes.ItemUpdateSchema): {
-    type: "item";
-    id: string;
-    attributes?: {
-        [k: string]: unknown;
-    } | undefined;
-    meta?: {
-        created_at?: string | undefined;
-        updated_at?: string | undefined;
-        published_at?: string | null | undefined;
-        first_published_at?: string | null | undefined;
-        publication_scheduled_at?: string | null | undefined;
-        unpublishing_scheduled_at?: string | null | undefined;
-        status?: "published" | "draft" | "updated" | null | undefined;
-        is_valid?: boolean | undefined;
-        current_version?: string | undefined;
-        is_current_version_valid?: boolean | null | undefined;
-        is_published_version_valid?: boolean | null | undefined;
-        stage?: string | null | undefined;
-        has_children?: boolean | null | undefined;
-    } | undefined;
-    relationships?: {
-        item_type?: {
-            data: RawApiTypes.ItemTypeData;
-        } | undefined;
-        creator?: {
-            data: RawApiTypes.UserData | RawApiTypes.SsoUserData | RawApiTypes.AccessTokenData | RawApiTypes.AccountData | RawApiTypes.OrganizationData;
-        } | undefined;
-    } | undefined;
-};
+import type { ItemTypeDefinition, ItemTypeDefinitionToItemDefinitionAsRequest } from './itemDefinition';
+type NoInfer<T> = [T][T extends any ? 0 : never];
+export declare function buildBlockRecord<D extends ItemTypeDefinition = ItemTypeDefinition>(body: ApiTypes.ItemUpdateSchema<ItemTypeDefinitionToItemDefinitionAsRequest<NoInfer<D>>>): NewBlockInARequest<ItemTypeDefinitionToItemDefinitionAsRequest<NoInfer<D>>>;
+export {};

package/dist/esm/utilities/buildBlockRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,IAA+B;IAC9D,OAAO,KAAK,CAAC,oBAAoB,CAA+B,IAAI,EAAE;QACpE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;AACV,CAAC"}
+{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAQ9C,MAAM,UAAU,gBAAgB,CAG9B,IAEC;IAED,OAAO,KAAK,CAAC,oBAAoB,CAI9B,IAAI,EAAE;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;AACV,CAAC"}

package/dist/esm/utilities/fieldValue.d.ts

@@ -7,7 +7,7 @@ import type * as RawApiTypes from '../generated/RawApiTypes';
  * for various locales structured as an object, such as
  * `{ "en": "Hello", "it": "Ciao" }`
  */
-export type LocalizedFieldValue = Record<string, unknown>;
+export type LocalizedFieldValue<T = unknown> = Record<string, T>;
 /**
  * Determines whether a DatoCMS field is localized or not.
  *

package/dist/esm/utilities/itemDefinition.d.ts

@@ -0,0 +1,74 @@
+import type { BooleanFieldValue, ColorFieldValue, DateFieldValue, DateTimeFieldValue, FileFieldValue, FloatFieldValue, GalleryFieldValue, IntegerFieldValue, JsonFieldValue, LatLonFieldValue, LinkFieldValue, LinksFieldValue, RichTextFieldValue, RichTextFieldValueAsRequest, RichTextFieldValueWithNestedBlocks, SeoFieldValue, SingleBlockFieldValue, SingleBlockFieldValueAsRequest, SingleBlockFieldValueWithNestedBlocks, SlugFieldValue, StringFieldValue, StructuredTextFieldValue, StructuredTextFieldValueAsRequest, StructuredTextFieldValueWithNestedBlocks, TextFieldValue, VideoFieldValue } from '../fieldTypes';
+import type { LocalizedFieldValue } from './fieldValue';
+/** Base field definition */
+type BaseFieldDefinition<Type extends string> = {
+    type: Type;
+    localized?: boolean;
+};
+type RichTextFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'rich_text'> & {
+    blocks: AllowedBlocks;
+};
+type SingleBlockFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'single_block'> & {
+    blocks: AllowedBlocks;
+};
+type StructuredTextFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition, AllowedInlineBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'structured_text'> & {
+    blocks: AllowedBlocks;
+    inline_blocks: AllowedInlineBlocks;
+};
+/** Field definition union */
+export type FieldDefinition = BaseFieldDefinition<'boolean' | 'color' | 'date' | 'date_time' | 'file' | 'float' | 'gallery' | 'integer' | 'json' | 'lat_lon' | 'link' | 'links' | 'seo' | 'slug' | 'string' | 'text' | 'video' | 'unknown'> | RichTextFieldDefinition | SingleBlockFieldDefinition | StructuredTextFieldDefinition;
+/** Item type definition */
+export type ItemTypeDefinition<ItemTypeId extends string = string, FieldDefinitions extends Record<string, FieldDefinition> = {}> = {
+    itemTypeId: ItemTypeId;
+    fields: FieldDefinitions;
+};
+/** Item definition */
+export type ItemDefinition<ItemTypeId extends string = string, FieldValues extends Record<string, unknown> = Record<string, unknown>> = {
+    itemTypeId: ItemTypeId;
+    fields: FieldValues;
+};
+/** Standard field values */
+type FieldTypeToValue = {
+    boolean: BooleanFieldValue;
+    color: ColorFieldValue;
+    date: DateFieldValue;
+    date_time: DateTimeFieldValue;
+    file: FileFieldValue;
+    float: FloatFieldValue;
+    gallery: GalleryFieldValue;
+    integer: IntegerFieldValue;
+    json: JsonFieldValue;
+    lat_lon: LatLonFieldValue;
+    link: LinkFieldValue;
+    links: LinksFieldValue;
+    rich_text: RichTextFieldValue;
+    seo: SeoFieldValue;
+    single_block: SingleBlockFieldValue;
+    slug: SlugFieldValue;
+    string: StringFieldValue;
+    structured_text: StructuredTextFieldValue;
+    text: TextFieldValue;
+    video: VideoFieldValue;
+    unknown: unknown;
+};
+/** Localized wrapper */
+type LocalizeIfNeeded<T extends FieldDefinition, Value> = T extends {
+    localized: true;
+} ? LocalizedFieldValue<Value> : Value;
+/** Standard mapping */
+type FieldDefinitionToFieldValue<T extends FieldDefinition> = LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+/** AsRequest mapping (block fields become generic over allowed blocks) */
+type FieldDefinitionToFieldValueAsRequest<T extends FieldDefinition> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>, ItemTypeDefinitionToItemDefinitionAsRequest<I>>> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+type FieldDefinitionToFieldValueWithNestedBlocks<T extends FieldDefinition> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>, ItemTypeDefinitionToItemDefinitionWithNestedBlocks<I>>> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+/** Transformers */
+export type ItemTypeDefinitionToItemDefinition<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], {
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValue<T['fields'][K]> : never;
+}> : never;
+export type ItemTypeDefinitionToItemDefinitionAsRequest<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], Partial<{
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValueAsRequest<T['fields'][K]> : never;
+}>> : never;
+export type ItemTypeDefinitionToItemDefinitionWithNestedBlocks<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], {
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValueWithNestedBlocks<T['fields'][K]> : never;
+}> : never;
+export type UnknownField = Record<string, unknown>;
+export {};

package/dist/esm/utilities/itemDefinition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=itemDefinition.js.map

package/dist/esm/utilities/itemDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemDefinition.js","sourceRoot":"","sources":["../../../src/utilities/itemDefinition.ts"],"names":[],"mappings":""}

package/dist/types/fieldTypes/boolean.d.ts

@@ -1,7 +1,9 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { BooleanEditorConfiguration } from './appearance/boolean';
 import type { BooleanRadioGroupEditorConfiguration } from './appearance/boolean_radio_group';
 export type BooleanFieldValue = boolean | null;
 export declare function isBooleanFieldValue(value: unknown): value is BooleanFieldValue;
+export declare function isLocalizedBooleanFieldValue(value: unknown): value is LocalizedFieldValue<BooleanFieldValue>;
 export type BooleanFieldValidators = Record<string, never>;
 export type BooleanFieldAppearance = {
     editor: 'boolean';

package/dist/types/fieldTypes/color.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { ColorPickerEditorConfiguration } from './appearance/color_picker';
 import type { RequiredValidator } from './validators/required';
 export type ColorFieldValue = {
@@ -7,6 +8,7 @@ export type ColorFieldValue = {
     alpha: number;
 } | null;
 export declare function isColorFieldValue(value: unknown): value is ColorFieldValue;
+export declare function isLocalizedColorFieldValue(value: unknown): value is LocalizedFieldValue<ColorFieldValue>;
 export type ColorFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/date.d.ts

@@ -1,8 +1,10 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { DatePickerEditorConfiguration } from './appearance/date_picker';
 import type { DateRangeValidator } from './validators/date_range';
 import type { RequiredValidator } from './validators/required';
 export type DateFieldValue = string | null;
 export declare function isDateFieldValue(value: unknown): value is DateFieldValue;
+export declare function isLocalizedDateFieldValue(value: unknown): value is LocalizedFieldValue<DateFieldValue>;
 export type DateFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/date_time.d.ts

@@ -1,8 +1,10 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { DateTimePickerEditorConfiguration } from './appearance/date_time_picker';
 import type { DateTimeRangeValidator } from './validators/date_time_range';
 import type { RequiredValidator } from './validators/required';
 export type DateTimeFieldValue = string | null;
 export declare function isDateTimeFieldValue(value: unknown): value is DateTimeFieldValue;
+export declare function isLocalizedDateTimeFieldValue(value: unknown): value is LocalizedFieldValue<DateTimeFieldValue>;
 export type DateTimeFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/file.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { FileEditorConfiguration } from './appearance/file';
 import type { ExtensionValidator } from './validators/extension';
 import type { FileSizeValidator } from './validators/file_size';
@@ -16,6 +17,7 @@ export type FileFieldValue = {
     } | null;
 } | null;
 export declare function isFileFieldValue(value: unknown): value is FileFieldValue;
+export declare function isLocalizedFileFieldValue(value: unknown): value is LocalizedFieldValue<FileFieldValue>;
 export type FileFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/float.d.ts

@@ -1,8 +1,10 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { FloatEditorConfiguration } from './appearance/float';
 import type { NumberRangeValidator } from './validators/number_range';
 import type { RequiredValidator } from './validators/required';
 export type FloatFieldValue = number | null;
 export declare function isFloatFieldValue(value: unknown): value is FloatFieldValue;
+export declare function isLocalizedFloatFieldValue(value: unknown): value is LocalizedFieldValue<FloatFieldValue>;
 export type FloatFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/gallery.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { GalleryEditorConfiguration } from './appearance/gallery';
 import type { ExtensionValidator } from './validators/extension';
 import type { FileSizeValidator } from './validators/file_size';
@@ -16,6 +17,7 @@ export type GalleryFieldValue = Array<{
     } | null;
 }> | null;
 export declare function isGalleryFieldValue(value: unknown): value is GalleryFieldValue;
+export declare function isLocalizedGalleryFieldValue(value: unknown): value is LocalizedFieldValue<GalleryFieldValue>;
 export type GalleryFieldValidators = {
     /** Only accept a number of items within the specified range */
     size?: SizeValidator;

package/dist/types/fieldTypes/integer.d.ts

@@ -1,8 +1,10 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { IntegerEditorConfiguration } from './appearance/integer';
 import type { NumberRangeValidator } from './validators/number_range';
 import type { RequiredValidator } from './validators/required';
 export type IntegerFieldValue = number | null;
 export declare function isIntegerFieldValue(value: unknown): value is IntegerFieldValue;
+export declare function isLocalizedIntegerFieldValue(value: unknown): value is LocalizedFieldValue<IntegerFieldValue>;
 export type IntegerFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/json.d.ts

@@ -1,9 +1,11 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { JsonEditorConfiguration } from './appearance/json';
 import type { StringCheckboxGroupEditorConfiguration } from './appearance/string_checkbox_group';
 import type { StringMultiSelectEditorConfiguration } from './appearance/string_multi_select';
 import type { RequiredValidator } from './validators/required';
 export type JsonFieldValue = string | null;
 export declare function isJsonFieldValue(value: unknown): value is JsonFieldValue;
+export declare function isLocalizedJsonFieldValue(value: unknown): value is LocalizedFieldValue<JsonFieldValue>;
 export type JsonFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/lat_lon.d.ts

@@ -1,15 +1,17 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { MapEditorConfiguration } from './appearance/map';
 import type { RequiredValidator } from './validators/required';
-export type LocationFieldValue = {
+export type LatLonFieldValue = {
     latitude: number;
     longitude: number;
 } | null;
-export declare function isLocationFieldValue(value: unknown): value is LocationFieldValue;
-export type LocationFieldValidators = {
+export declare function isLatLonFieldValue(value: unknown): value is LatLonFieldValue;
+export declare function isLocalizedLatLonFieldValue(value: unknown): value is LocalizedFieldValue<LatLonFieldValue>;
+export type LatLonFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;
 };
-export type LocationFieldAppearance = {
+export type LatLonFieldAppearance = {
     editor: 'map';
     parameters: MapEditorConfiguration;
 } | {

package/dist/types/fieldTypes/link.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { LinkEmbedEditorConfiguration } from './appearance/link_embed';
 import type { LinkSelectEditorConfiguration } from './appearance/link_select';
 import type { ItemItemTypeValidator } from './validators/item_item_type';
@@ -5,6 +6,7 @@ import type { RequiredValidator } from './validators/required';
 import type { UniqueValidator } from './validators/unique';
 export type LinkFieldValue = string | null;
 export declare function isLinkFieldValue(value: unknown): value is LinkFieldValue;
+export declare function isLocalizedLinkFieldValue(value: unknown): value is LocalizedFieldValue<LinkFieldValue>;
 export type LinkFieldValidators = {
     /** Only accept references to records of the specified models */
     item_item_type: ItemItemTypeValidator;

package/dist/types/fieldTypes/links.d.ts

@@ -1,9 +1,11 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { LinksEmbedEditorConfiguration } from './appearance/links_embed';
 import type { LinksSelectEditorConfiguration } from './appearance/links_select';
 import type { ItemsItemTypeValidator } from './validators/items_item_type';
 import type { SizeValidator } from './validators/size';
 export type LinksFieldValue = string[] | null;
 export declare function isLinksFieldValue(value: unknown): value is LinksFieldValue;
+export declare function isLocalizedLinksFieldValue(value: unknown): value is LocalizedFieldValue<LinksFieldValue>;
 export type LinksFieldValidators = {
     /** Only accept references to records of the specified models */
     items_item_type: ItemsItemTypeValidator;

package/dist/types/fieldTypes/rich_text.d.ts

@@ -1,5 +1,10 @@
 import type * as RawApiTypes from '../generated/RawApiTypes';
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
+import type { RichTextEditorConfiguration } from './appearance/rich_text';
 import { type BlockItemInARequest } from './single_block';
+import type { RichTextBlocksValidator } from './validators/rich_text_blocks';
+import type { SizeValidator } from './validators/size';
 /**
  * MODULAR CONTENT FIELD TYPE SYSTEM FOR DATOCMS
  *
@@ -29,7 +34,7 @@ import { type BlockItemInARequest } from './single_block';
 /**
  * Basic Modular Content field value - array of string block IDs (lightweight references)
  */
-export type RichTextFieldValue = string[] | null;
+export type RichTextFieldValue = string[];
 /**
  * =============================================================================
  * REQUEST VARIANT - Type for sending data TO the DatoCMS API
@@ -46,7 +51,7 @@ export type RichTextFieldValue = string[] | null;
  * - RawApiTypes.Item: Full block object with ID (for updates)
  * - Omit<RawApiTypes.Item, 'id'>: Block object without ID (for creation)
  */
-export type RichTextFieldValueAsRequest = BlockItemInARequest[] | null;
+export type RichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition> = BlockItemInARequest<D>[] | null;
 /**
  * =============================================================================
  * NESTED VARIANT - Type for API responses with ?nested=true parameter
@@ -59,7 +64,7 @@ export type RichTextFieldValueAsRequest = BlockItemInARequest[] | null;
 /**
  * Modular Content field value with nested blocks - array of fully populated block objects
  */
-export type RichTextFieldValueWithNestedBlocks = RawApiTypes.Item[] | null;
+export type RichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D>[];
 /**
  * =============================================================================
  * TYPE GUARDS - Runtime validation functions
@@ -70,19 +75,19 @@ export type RichTextFieldValueWithNestedBlocks = RawApiTypes.Item[] | null;
  * Checks for array structure and ensures all blocks are string references.
  */
 export declare function isRichTextFieldValue(value: unknown): value is RichTextFieldValue;
+export declare function isLocalizedRichTextFieldValue(value: unknown): value is LocalizedFieldValue<RichTextFieldValue>;
 /**
  * Type guard for Modular Content field values in API request format.
  * Allows blocks as string IDs, full objects with IDs, or objects without IDs.
  */
-export declare function isRichTextFieldValueAsRequest(value: unknown): value is RichTextFieldValueAsRequest;
+export declare function isRichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is RichTextFieldValueAsRequest<D>;
+export declare function isLocalizedRichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<RichTextFieldValueAsRequest<D>>;
 /**
  * Type guard for Modular Content field values with nested blocks (?nested=true format).
  * Ensures all blocks are full RawApiTypes.Item objects with complete data.
  */
-export declare function isRichTextFieldValueWithNestedBlocks(value: unknown): value is RichTextFieldValueWithNestedBlocks;
-import type { RichTextEditorConfiguration } from './appearance/rich_text';
-import type { RichTextBlocksValidator } from './validators/rich_text_blocks';
-import type { SizeValidator } from './validators/size';
+export declare function isRichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is RichTextFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedRichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<RichTextFieldValueWithNestedBlocks<D>>;
 export type RichTextFieldValidators = {
     /** Only accept references to block records of the specified block models */
     rich_text_blocks: RichTextBlocksValidator;

package/dist/types/fieldTypes/seo.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { SeoEditorConfiguration } from './appearance/seo';
 import type { DescriptionLengthValidator } from './validators/description_length';
 import type { FileSizeValidator } from './validators/file_size';
@@ -13,6 +14,7 @@ export type SeoFieldValue = {
     no_index?: boolean;
 } | null;
 export declare function isSeoFieldValue(value: unknown): value is SeoFieldValue;
+export declare function isLocalizedSeoFieldValue(value: unknown): value is LocalizedFieldValue<SeoFieldValue>;
 export type SeoFieldValidators = {
     /** SEO field has to specify one or more properties, or it won't be valid */
     required_seo_fields?: RequiredSeoFieldsValidator;

package/dist/types/fieldTypes/single_block.d.ts

@@ -1,4 +1,6 @@
 import type * as RawApiTypes from '../generated/RawApiTypes';
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
 import type { FramedSingleBlockEditorConfiguration } from './appearance/framed_single_block';
 import type { FramelessSingleBlockEditorConfiguration } from './appearance/frameless_single_block';
 import type { RequiredValidator } from './validators/required';
@@ -44,11 +46,11 @@ export type SingleBlockFieldValue = string | null;
  * - Omit ID for new blocks being created
  */
 /** Represents an existing block in a CMA request */
-export type UnchangedBlockInARequest = string;
+export type UnchangedBlockInARequest<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D>['id'];
 /** Represents a block we want to update in a CMA request */
-export type UpdatedBlockInARequest = OptionalFields<RawApiTypes.Item, 'meta'>;
+export type UpdatedBlockInARequest<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'meta'>;
 /** Represents a new block to create in a CMA request */
-export type NewBlockInARequest = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>;
+export type NewBlockInARequest<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'id' | 'meta'>;
 /**
  * Union type representing the different ways a block can be specified in API requests:
  * - string: Just the block ID (to keep existing blocks unchanged)
@@ -57,14 +59,14 @@ export type NewBlockInARequest = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>
  *
  * Also, 'meta' can always be omitted
  */
-export type BlockItemInARequest = UnchangedBlockInARequest | UpdatedBlockInARequest | NewBlockInARequest;
+export type BlockItemInARequest<D extends ItemDefinition = ItemDefinition> = UnchangedBlockInARequest | UpdatedBlockInARequest<D> | NewBlockInARequest<D>;
 /**
  * Single Block field value for API requests - allows flexible block representations:
  * - string: Just the block ID (to keep existing blocks unchanged)
  * - Full block object with ID (to update an existing block)
  * - Block object without ID (to create a new block)
  */
-export type SingleBlockFieldValueAsRequest = BlockItemInARequest | null;
+export type SingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition> = BlockItemInARequest<D> | null;
 /**
  * =============================================================================
  * NESTED VARIANT - Type for API responses with ?nested=true parameter
@@ -77,7 +79,7 @@ export type SingleBlockFieldValueAsRequest = BlockItemInARequest | null;
 /**
  * Single Block field value with nested block - fully populated block object
  */
-export type SingleBlockFieldValueWithNestedBlocks = RawApiTypes.Item | null;
+export type SingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D> | null;
 /**
  * =============================================================================
  * SHARED UTILITY FUNCTIONS
@@ -88,16 +90,16 @@ export type SingleBlockFieldValueWithNestedBlocks = RawApiTypes.Item | null;
  * Validates if the input is a valid item (either block or record) ID
  */
 export declare function isItemId(input: unknown): input is string;
-export type ItemWithOptionalIdAndMeta = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>;
+export type ItemWithOptionalIdAndMeta<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'id' | 'meta'>;
 /**
  * Validates if the input is a RawApiTypes.Item object (with optional `id` and `meta`)
  */
-export declare function isItemWithOptionalIdAndMeta(block: unknown): block is ItemWithOptionalIdAndMeta;
-export type ItemWithOptionalMeta = OptionalFields<RawApiTypes.Item, 'meta'>;
+export declare function isItemWithOptionalIdAndMeta<D extends ItemDefinition = ItemDefinition>(block: unknown): block is ItemWithOptionalIdAndMeta<D>;
+export type ItemWithOptionalMeta<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'meta'>;
 /**
  * Validates if the input is a a complete RawApiTypes.Item object with optional `meta`
  */
-export declare function isItemWithOptionalMeta(block: unknown): block is ItemWithOptionalMeta;
+export declare function isItemWithOptionalMeta<D extends ItemDefinition = ItemDefinition>(block: unknown): block is ItemWithOptionalMeta<D>;
 /**
  * =============================================================================
  * TYPE GUARDS - Runtime validation functions
@@ -108,16 +110,19 @@ export declare function isItemWithOptionalMeta(block: unknown): block is ItemWit
  * Checks for string structure and ensures block is a string reference.
  */
 export declare function isSingleBlockFieldValue(value: unknown): value is SingleBlockFieldValue;
+export declare function isLocalizedSingleBlockFieldValue(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValue>;
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.
  */
-export declare function isSingleBlockFieldValueAsRequest(value: unknown): value is SingleBlockFieldValueAsRequest;
+export declare function isSingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is SingleBlockFieldValueAsRequest<D>;
+export declare function isLocalizedSingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueAsRequest<D>>;
 /**
  * Type guard for Single Block field values with nested blocks (?nested=true format).
  * Ensures block is a full RawApiTypes.Item object with complete data.
  */
-export declare function isSingleBlockFieldValueWithNestedBlocks(value: unknown): value is SingleBlockFieldValueWithNestedBlocks;
+export declare function isSingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is SingleBlockFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedSingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueWithNestedBlocks<D>>;
 export type SingleBlockFieldValidators = {
     /** Only accept references to block records of the specified block models */
     single_block_blocks: SingleBlockBlocksValidator;

package/dist/types/fieldTypes/slug.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { SlugEditorConfiguration } from './appearance/slug';
 import type { LengthValidator } from './validators/length';
 import type { RequiredValidator } from './validators/required';
@@ -5,6 +6,7 @@ import type { SlugFormatValidator } from './validators/slug_format';
 import type { SlugTitleFieldValidator } from './validators/slug_title_field';
 export type SlugFieldValue = string | null;
 export declare function isSlugFieldValue(value: unknown): value is SlugFieldValue;
+export declare function isLocalizedSlugFieldValue(value: unknown): value is LocalizedFieldValue<SlugFieldValue>;
 export type SlugFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/string.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { SingleLineEditorConfiguration } from './appearance/single_line';
 import type { StringRadioGroupEditorConfiguration } from './appearance/string_radio_group';
 import type { StringSelectEditorConfiguration } from './appearance/string_select';
@@ -8,6 +9,7 @@ import type { RequiredValidator } from './validators/required';
 import type { UniqueValidator } from './validators/unique';
 export type StringFieldValue = string | null;
 export declare function isStringFieldValue(value: unknown): value is StringFieldValue;
+export declare function isLocalizedStringFieldValue(value: unknown): value is LocalizedFieldValue<StringFieldValue>;
 export type StringFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;

package/dist/types/fieldTypes/structured_text.d.ts

@@ -1,5 +1,7 @@
 import { type Block, type Document, type InlineBlock } from 'datocms-structured-text-utils';
 import type * as RawApiTypes from '../generated/RawApiTypes';
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
 import type { StructuredTextEditorConfiguration } from './appearance/structured_text';
 import { type BlockItemInARequest } from './single_block';
 import type { LengthValidator } from './validators/length';
@@ -38,15 +40,15 @@ import type { StructuredTextLinksValidator } from './validators/structured_text_
 /**
  * Variant of 'block' structured text node for API requests
  */
-export type BlockAsRequest = Block<BlockItemInARequest>;
+export type BlockAsRequest<D extends ItemDefinition = ItemDefinition> = Block<BlockItemInARequest<D>>;
 /**
  * Variant of 'inlineBlock' structured text node for API requests
  */
-export type InlineBlockAsRequest = InlineBlock<BlockItemInARequest>;
+export type InlineBlockAsRequest<D extends ItemDefinition = ItemDefinition> = InlineBlock<BlockItemInARequest<D>>;
 /**
  * Variant of Structured Text document for API requests
  */
-export type DocumentAsRequest = Document<BlockItemInARequest>;
+export type DocumentAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = Document<BlockItemInARequest<BlockItemDefinition>, BlockItemInARequest<InlineBlockItemDefinition>>;
 /**
  * =============================================================================
  * NESTED VARIANTS - Types for API responses with ?nested=true parameter
@@ -59,15 +61,15 @@ export type DocumentAsRequest = Document<BlockItemInARequest>;
 /**
  * Variant of 'block' structured text node for ?nested=true API responses
  */
-export type BlockWithNestedBlocks = Block<RawApiTypes.Item>;
+export type BlockWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = Block<RawApiTypes.Item<D>>;
 /**
  * Variant of 'inlineBlock' structured text node for ?nested=true API responses
  */
-export type InlineBlockWithNestedBlocks = InlineBlock<RawApiTypes.Item>;
+export type InlineBlockWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = InlineBlock<RawApiTypes.Item<D>>;
 /**
  * Variant of Structured Text document for ?nested=true API responses
  */
-export type DocumentWithNestedBlocks = Document<RawApiTypes.Item>;
+export type DocumentWithNestedBlocks<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = Document<RawApiTypes.Item<BlockItemDefinition>, RawApiTypes.Item<InlineBlockItemDefinition>>;
 /**
  * =============================================================================
  * MAIN APPLICATION TYPES
@@ -78,23 +80,26 @@ export type DocumentWithNestedBlocks = Document<RawApiTypes.Item>;
  * Can be null (empty field) or a document with blocks as string IDs
  */
 export type StructuredTextFieldValue = Document | null;
-export type StructuredTextFieldValueAsRequest = DocumentAsRequest | null;
-export type StructuredTextFieldValueWithNestedBlocks = DocumentWithNestedBlocks | null;
+export type StructuredTextFieldValueAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = DocumentAsRequest<BlockItemDefinition, InlineBlockItemDefinition> | null;
+export type StructuredTextFieldValueWithNestedBlocks<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = DocumentWithNestedBlocks<BlockItemDefinition, InlineBlockItemDefinition> | null;
 /**
  * Type guard for basic structured text field values (blocks as string IDs only).
  * Checks for the expected structure and ensures all block/inlineBlock nodes have string IDs.
  */
 export declare function isStructuredTextFieldValue(value: unknown): value is StructuredTextFieldValue;
+export declare function isLocalizedStructuredTextFieldValue(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValue>;
 /**
  * Type guard for structured text field values in API request format.
  * Allows blocks as string IDs, full objects with IDs, or objects without IDs.
  */
-export declare function isStructuredTextFieldValueAsRequest(value: unknown): value is StructuredTextFieldValueAsRequest;
+export declare function isStructuredTextFieldValueAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition>(value: unknown): value is StructuredTextFieldValueAsRequest<BlockItemDefinition, InlineBlockItemDefinition>;
+export declare function isLocalizedStructuredTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueAsRequest<D>>;
 /**
  * Type guard for structured text field values with nested blocks (?nested=true format).
  * Ensures all block/inlineBlock nodes have full RawApiTypes.Item objects.
  */
-export declare function isStructuredTextFieldValueWithNestedBlocks(value: unknown): value is StructuredTextFieldValueWithNestedBlocks;
+export declare function isStructuredTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is StructuredTextFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedStructuredTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueWithNestedBlocks<D>>;
 export type StructuredTextFieldValidators = {
     /** Only accept references to block records of the specified block models */
     structured_text_blocks: StructuredTextBlocksValidator;

package/dist/types/fieldTypes/text.d.ts

@@ -1,3 +1,4 @@
+import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { MarkdownEditorConfiguration } from './appearance/markdown';
 import type { TextareaEditorConfiguration } from './appearance/textarea';
 import type { WysiwygEditorConfiguration } from './appearance/wysiwyg';
@@ -7,6 +8,7 @@ import type { RequiredValidator } from './validators/required';
 import type { SanitizationValidator } from './validators/sanitization';
 export type TextFieldValue = string | null;
 export declare function isTextFieldValue(value: unknown): value is TextFieldValue;
+export declare function isLocalizedTextFieldValue(value: unknown): value is LocalizedFieldValue<TextFieldValue>;
 export type TextFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;