@storyblok/management-api-client 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/generated/mapi/types-aliased.gen.d.cts

@@ -141,6 +141,176 @@ type Component = {
     [key: string]: unknown;
   } | null;
 };
+type ComponentCreate = {
+  /**
+   * Name of the component
+   */
+  name: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string;
+  /**
+   * Component description
+   */
+  description?: string;
+  /**
+   * Preview template HTML
+   */
+  preview_tmpl?: string;
+  /**
+   * Component image URL
+   */
+  image?: string;
+  /**
+   * Field used for preview
+   */
+  preview_field?: string;
+  /**
+   * Whether this component can be used as a root component
+   */
+  is_root?: boolean;
+  /**
+   * Whether this component can be nested inside other components
+   */
+  is_nestable?: boolean;
+  /**
+   * Default preset ID
+   */
+  preset_id?: number;
+  /**
+   * UUID
+   */
+  component_group_uuid?: string;
+  /**
+   * Component color for UI display
+   */
+  color?: string;
+  /**
+   * Component icon name
+   */
+  icon?: string;
+  /**
+   * Asset preview URL for content type
+   */
+  content_type_asset_preview?: string;
+  /**
+   * List of internal tag IDs
+   */
+  internal_tag_ids?: Array<number>;
+  /**
+   * Component field schema definition
+   */
+  schema?: {
+    [key: string]: {
+      type?: 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group';
+      /**
+       * Human-readable field name
+       */
+      display_name?: string;
+      /**
+       * Whether this field is required
+       */
+      required?: boolean;
+      /**
+       * Whether this field is translatable
+       */
+      translatable?: boolean;
+      [key: string]: unknown | 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group' | string | boolean | undefined;
+    };
+  };
+  /**
+   * Component metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+type ComponentUpdate = {
+  /**
+   * Name of the component
+   */
+  name?: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string;
+  /**
+   * Component description
+   */
+  description?: string;
+  /**
+   * Preview template HTML
+   */
+  preview_tmpl?: string;
+  /**
+   * Component image URL
+   */
+  image?: string;
+  /**
+   * Field used for preview
+   */
+  preview_field?: string;
+  /**
+   * Whether this component can be used as a root component
+   */
+  is_root?: boolean;
+  /**
+   * Whether this component can be nested inside other components
+   */
+  is_nestable?: boolean;
+  /**
+   * Default preset ID
+   */
+  preset_id?: number;
+  /**
+   * UUID
+   */
+  component_group_uuid?: string;
+  /**
+   * Component color for UI display
+   */
+  color?: string;
+  /**
+   * Component icon name
+   */
+  icon?: string;
+  /**
+   * Asset preview URL for content type
+   */
+  content_type_asset_preview?: string;
+  /**
+   * List of internal tag IDs
+   */
+  internal_tag_ids?: Array<number>;
+  /**
+   * Component field schema definition
+   */
+  schema?: {
+    [key: string]: {
+      type?: 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group';
+      /**
+       * Human-readable field name
+       */
+      display_name?: string;
+      /**
+       * Whether this field is required
+       */
+      required?: boolean;
+      /**
+       * Whether this field is translatable
+       */
+      translatable?: boolean;
+      [key: string]: unknown | 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group' | string | boolean | undefined;
+    };
+  };
+  /**
+   * Component metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
 type Asset = {
   /**
    * Id of the asset.
@@ -1424,5 +1594,5 @@ type SpaceRole = {
   blocked_asset_folder_ids: Array<number>;
 };
 //#endregion
-export { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, Component, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate };
+export { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, Component, ComponentCreate, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, ComponentUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate };
 //# sourceMappingURL=types-aliased.gen.d.cts.map

package/dist/generated/mapi/types-aliased.gen.d.mts

@@ -141,6 +141,176 @@ type Component = {
     [key: string]: unknown;
   } | null;
 };
+type ComponentCreate = {
+  /**
+   * Name of the component
+   */
+  name: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string;
+  /**
+   * Component description
+   */
+  description?: string;
+  /**
+   * Preview template HTML
+   */
+  preview_tmpl?: string;
+  /**
+   * Component image URL
+   */
+  image?: string;
+  /**
+   * Field used for preview
+   */
+  preview_field?: string;
+  /**
+   * Whether this component can be used as a root component
+   */
+  is_root?: boolean;
+  /**
+   * Whether this component can be nested inside other components
+   */
+  is_nestable?: boolean;
+  /**
+   * Default preset ID
+   */
+  preset_id?: number;
+  /**
+   * UUID
+   */
+  component_group_uuid?: string;
+  /**
+   * Component color for UI display
+   */
+  color?: string;
+  /**
+   * Component icon name
+   */
+  icon?: string;
+  /**
+   * Asset preview URL for content type
+   */
+  content_type_asset_preview?: string;
+  /**
+   * List of internal tag IDs
+   */
+  internal_tag_ids?: Array<number>;
+  /**
+   * Component field schema definition
+   */
+  schema?: {
+    [key: string]: {
+      type?: 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group';
+      /**
+       * Human-readable field name
+       */
+      display_name?: string;
+      /**
+       * Whether this field is required
+       */
+      required?: boolean;
+      /**
+       * Whether this field is translatable
+       */
+      translatable?: boolean;
+      [key: string]: unknown | 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group' | string | boolean | undefined;
+    };
+  };
+  /**
+   * Component metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+type ComponentUpdate = {
+  /**
+   * Name of the component
+   */
+  name?: string;
+  /**
+   * Human-readable display name
+   */
+  display_name?: string;
+  /**
+   * Component description
+   */
+  description?: string;
+  /**
+   * Preview template HTML
+   */
+  preview_tmpl?: string;
+  /**
+   * Component image URL
+   */
+  image?: string;
+  /**
+   * Field used for preview
+   */
+  preview_field?: string;
+  /**
+   * Whether this component can be used as a root component
+   */
+  is_root?: boolean;
+  /**
+   * Whether this component can be nested inside other components
+   */
+  is_nestable?: boolean;
+  /**
+   * Default preset ID
+   */
+  preset_id?: number;
+  /**
+   * UUID
+   */
+  component_group_uuid?: string;
+  /**
+   * Component color for UI display
+   */
+  color?: string;
+  /**
+   * Component icon name
+   */
+  icon?: string;
+  /**
+   * Asset preview URL for content type
+   */
+  content_type_asset_preview?: string;
+  /**
+   * List of internal tag IDs
+   */
+  internal_tag_ids?: Array<number>;
+  /**
+   * Component field schema definition
+   */
+  schema?: {
+    [key: string]: {
+      type?: 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group';
+      /**
+       * Human-readable field name
+       */
+      display_name?: string;
+      /**
+       * Whether this field is required
+       */
+      required?: boolean;
+      /**
+       * Whether this field is translatable
+       */
+      translatable?: boolean;
+      [key: string]: unknown | 'bloks' | 'text' | 'textarea' | 'richtext' | 'markdown' | 'number' | 'datetime' | 'boolean' | 'options' | 'option' | 'asset' | 'multiasset' | 'multilink' | 'table' | 'section' | 'commerce' | 'custom' | 'image' | 'file' | 'tab' | 'link' | 'group' | string | boolean | undefined;
+    };
+  };
+  /**
+   * Component metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
 type Asset = {
   /**
    * Id of the asset.
@@ -1424,5 +1594,5 @@ type SpaceRole = {
   blocked_asset_folder_ids: Array<number>;
 };
 //#endregion
-export { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, Component, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate };
+export { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, Component, ComponentCreate, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, ComponentUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate };
 //# sourceMappingURL=types-aliased.gen.d.mts.map

package/dist/generated/types/block.d.cts

@@ -1,20 +1,39 @@
 import { Component } from "../mapi/types-aliased.gen.cjs";
-import { ComponentCreate, ComponentUpdate } from "../mapi/_internal.gen.cjs";
 import { Field } from "../overlay/_internal.gen.cjs";
 import { Override } from "./_utils.cjs";
 
 //#region src/generated/types/block.d.ts
-/** Wire form: the MAPI object map keyed by field name. This is what `defineBlock` returns. */
-type BlockSchema = Record<string, Field & {
+/**
+ * Ordered array of named fields — the content-shape DSL form `defineBlock`
+ * accepts and returns. A field's position in the array sets the order it appears
+ * in the editor (mapped to the wire `pos` on push).
+ */
+type BlockFields = ReadonlyArray<Field & {
+  name: string;
+  pos?: number;
   required?: boolean;
 }>;
-/** A Storyblok block. */
-type Block<TName extends string = string, TBlockSchema extends BlockSchema = BlockSchema, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean, TComponentGroupUuid extends string | null = string | null> = Override<Component, {
+/**
+ * A Storyblok block: a named, ordered set of content fields. Uses the
+ * content-shape DSL `fields` array rather than the MAPI wire `schema` record.
+ */
+type Block<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean> = Override<Omit<Component, 'schema' | 'component_group_uuid'>, {
   name: TName;
-  schema: TBlockSchema;
+  fields: TFields;
   is_root?: TIsRoot;
   is_nestable?: TIsNestable;
-  component_group_uuid?: TComponentGroupUuid;
+  /**
+   * Escape hatch for pinning this block to a Storyblok UI-managed component
+   * group by UUID. Component groups are normally maintained in code via the
+   * schema directory layout; set this only if you intentionally manage groups
+   * in the Storyblok UI, and fill in the group UUID yourself. When set,
+   * `schema push` diffs it and sends it to the Management API; when omitted,
+   * the block's remote group is left untouched.
+   *
+   * @deprecated Prefer maintaining component groups in code through the
+   * directory layout.
+   */
+  component_group_uuid?: string | null;
 }>;
 /**
  * A root {@link Block} (`is_root: true`). Given a union of blocks, narrows to
@@ -26,5 +45,5 @@ type RootBlock<T extends Block = Block & {
   is_root: true;
 }>;
 //#endregion
-export { Block, RootBlock };
+export { Block, BlockFields, RootBlock };
 //# sourceMappingURL=block.d.cts.map

package/dist/generated/types/block.d.mts

@@ -1,20 +1,39 @@
 import { Component } from "../mapi/types-aliased.gen.mjs";
-import { ComponentCreate, ComponentUpdate } from "../mapi/_internal.gen.mjs";
 import { Field } from "../overlay/_internal.gen.mjs";
 import { Override } from "./_utils.mjs";
 
 //#region src/generated/types/block.d.ts
-/** Wire form: the MAPI object map keyed by field name. This is what `defineBlock` returns. */
-type BlockSchema = Record<string, Field & {
+/**
+ * Ordered array of named fields — the content-shape DSL form `defineBlock`
+ * accepts and returns. A field's position in the array sets the order it appears
+ * in the editor (mapped to the wire `pos` on push).
+ */
+type BlockFields = ReadonlyArray<Field & {
+  name: string;
+  pos?: number;
   required?: boolean;
 }>;
-/** A Storyblok block. */
-type Block<TName extends string = string, TBlockSchema extends BlockSchema = BlockSchema, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean, TComponentGroupUuid extends string | null = string | null> = Override<Component, {
+/**
+ * A Storyblok block: a named, ordered set of content fields. Uses the
+ * content-shape DSL `fields` array rather than the MAPI wire `schema` record.
+ */
+type Block<TName extends string = string, TFields extends BlockFields = BlockFields, TIsRoot extends boolean = boolean, TIsNestable extends boolean = boolean> = Override<Omit<Component, 'schema' | 'component_group_uuid'>, {
   name: TName;
-  schema: TBlockSchema;
+  fields: TFields;
   is_root?: TIsRoot;
   is_nestable?: TIsNestable;
-  component_group_uuid?: TComponentGroupUuid;
+  /**
+   * Escape hatch for pinning this block to a Storyblok UI-managed component
+   * group by UUID. Component groups are normally maintained in code via the
+   * schema directory layout; set this only if you intentionally manage groups
+   * in the Storyblok UI, and fill in the group UUID yourself. When set,
+   * `schema push` diffs it and sends it to the Management API; when omitted,
+   * the block's remote group is left untouched.
+   *
+   * @deprecated Prefer maintaining component groups in code through the
+   * directory layout.
+   */
+  component_group_uuid?: string | null;
 }>;
 /**
  * A root {@link Block} (`is_root: true`). Given a union of blocks, narrows to
@@ -26,5 +45,5 @@ type RootBlock<T extends Block = Block & {
   is_root: true;
 }>;
 //#endregion
-export { Block, RootBlock };
+export { Block, BlockFields, RootBlock };
 //# sourceMappingURL=block.d.mts.map

package/dist/generated/types/field.d.cts

@@ -1,6 +1,6 @@
 import { AssetFieldValue, BlockContentBase, BlockContentInputBase, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../overlay/_internal.gen.cjs";
 import { Prettify } from "./_utils.cjs";
-import { Block } from "./block.cjs";
+import { Block, BlockFields } from "./block.cjs";
 
 //#region src/generated/types/field.d.ts
 /**
@@ -11,27 +11,39 @@ import { Block } from "./block.cjs";
 type NoBlocks = false;
 /** True when `T` is the un-narrowed base `Block` (i.e. no specific block was supplied). */
 type IsBaseBlock<T> = [Block] extends [T] ? true : false;
-type RequiredFieldKeys<T> = { [K in keyof T]: T[K] extends {
+/**
+ * Maps a block's ordered `fields` array to its read content object, splitting
+ * required (`required: true`) from optional fields. Each `F` is a member of the
+ * field union, so it provably satisfies `FieldValue`'s `Field` constraint.
+ */
+type ContentFields<TFields extends BlockFields, TBlocks> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValue<F, TBlocks> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValue<F, TBlocks> | null }>;
+/** Input (write) variant of {@link ContentFields}, resolving each field via {@link FieldValueInput}. */
+type ContentFieldsInput<TFields extends BlockFields, TBlocks> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValueInput<F, TBlocks> } & { [F in TFields[number] as F extends {
   required: true;
-} ? K : never }[keyof T];
-type OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;
+} ? never : F['name']]?: FieldValueInput<F, TBlocks> | null }>;
 /**
  * Content object for a single block instance as returned by the Storyblok
  * Content Delivery API. Without a `TBlock` argument, this is the loose
  * runtime shape (any block, `_editable` optional). With a schema-typed
- * `TBlock`, fields are narrowed per the block's schema.
+ * `TBlock`, fields are narrowed per the block's `fields`.
  */
 type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
   _uid: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFields<TBlock['fields'], TBlocks>> : never;
 /** Input variant of {@link BlockContent} for write operations (creating/updating stories via the MAPI). `_uid` is optional. */
 type BlockContentInput<TBlock extends Block = Block, TBlocks = NoBlocks> = IsBaseBlock<TBlock> extends true ? BlockContentInputBase : TBlock extends any ? Prettify<{
   _uid?: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFieldsInput<TBlock['fields'], TBlocks>> : never;
 type BlocksFieldValue<TBlock extends Block = Block, TBlocks = NoBlocks> = BlockContent<TBlock, TBlocks>[];
 interface FieldTypeValueMap {
   text: string;
@@ -57,19 +69,19 @@ type IsNestable<T> = T extends {
 } ? false : T extends {
   is_nestable: true;
 } ? true : true;
-type ApplyWhitelist<TField, TBlocks> = TField extends {
-  component_whitelist: ReadonlyArray<infer TWhitelisted extends string>;
+type ApplyAllow<TField, TBlocks> = TField extends {
+  allow: ReadonlyArray<infer TAllowed extends string>;
 } ? Extract<TBlocks, {
-  name: TWhitelisted;
+  name: TAllowed;
 }> : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
 /** Resolves a field definition to its runtime content value type (read). */
 type FieldValue<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
 /** Resolves a field definition to its input value type (write). */
 type FieldValueInput<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
 //#endregion
 export { BlockContent, BlockContentInput, BlocksFieldValue };
 //# sourceMappingURL=field.d.cts.map

package/dist/generated/types/field.d.mts

@@ -1,6 +1,6 @@
 import { AssetFieldValue, BlockContentBase, BlockContentInputBase, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../overlay/_internal.gen.mjs";
 import { Prettify } from "./_utils.mjs";
-import { Block } from "./block.mjs";
+import { Block, BlockFields } from "./block.mjs";
 
 //#region src/generated/types/field.d.ts
 /**
@@ -11,27 +11,39 @@ import { Block } from "./block.mjs";
 type NoBlocks = false;
 /** True when `T` is the un-narrowed base `Block` (i.e. no specific block was supplied). */
 type IsBaseBlock<T> = [Block] extends [T] ? true : false;
-type RequiredFieldKeys<T> = { [K in keyof T]: T[K] extends {
+/**
+ * Maps a block's ordered `fields` array to its read content object, splitting
+ * required (`required: true`) from optional fields. Each `F` is a member of the
+ * field union, so it provably satisfies `FieldValue`'s `Field` constraint.
+ */
+type ContentFields<TFields extends BlockFields, TBlocks> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValue<F, TBlocks> } & { [F in TFields[number] as F extends {
+  required: true;
+} ? never : F['name']]?: FieldValue<F, TBlocks> | null }>;
+/** Input (write) variant of {@link ContentFields}, resolving each field via {@link FieldValueInput}. */
+type ContentFieldsInput<TFields extends BlockFields, TBlocks> = Prettify<{ [F in TFields[number] as F extends {
+  required: true;
+} ? F['name'] : never]: FieldValueInput<F, TBlocks> } & { [F in TFields[number] as F extends {
   required: true;
-} ? K : never }[keyof T];
-type OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;
+} ? never : F['name']]?: FieldValueInput<F, TBlocks> | null }>;
 /**
  * Content object for a single block instance as returned by the Storyblok
  * Content Delivery API. Without a `TBlock` argument, this is the loose
  * runtime shape (any block, `_editable` optional). With a schema-typed
- * `TBlock`, fields are narrowed per the block's schema.
+ * `TBlock`, fields are narrowed per the block's `fields`.
  */
 type BlockContent<TBlock extends Block = Block, TBlocks = NoBlocks> = IsBaseBlock<TBlock> extends true ? BlockContentBase : TBlock extends any ? Prettify<{
   _uid: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFields<TBlock['fields'], TBlocks>> : never;
 /** Input variant of {@link BlockContent} for write operations (creating/updating stories via the MAPI). `_uid` is optional. */
 type BlockContentInput<TBlock extends Block = Block, TBlocks = NoBlocks> = IsBaseBlock<TBlock> extends true ? BlockContentInputBase : TBlock extends any ? Prettify<{
   _uid?: string;
   component: TBlock['name'];
   _editable?: string;
-} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> | null }> : never;
+} & ContentFieldsInput<TBlock['fields'], TBlocks>> : never;
 type BlocksFieldValue<TBlock extends Block = Block, TBlocks = NoBlocks> = BlockContent<TBlock, TBlocks>[];
 interface FieldTypeValueMap {
   text: string;
@@ -57,19 +69,19 @@ type IsNestable<T> = T extends {
 } ? false : T extends {
   is_nestable: true;
 } ? true : true;
-type ApplyWhitelist<TField, TBlocks> = TField extends {
-  component_whitelist: ReadonlyArray<infer TWhitelisted extends string>;
+type ApplyAllow<TField, TBlocks> = TField extends {
+  allow: ReadonlyArray<infer TAllowed extends string>;
 } ? Extract<TBlocks, {
-  name: TWhitelisted;
+  name: TAllowed;
 }> : TBlocks extends any ? IsNestable<TBlocks> extends true ? TBlocks : never : never;
 /** Resolves a field definition to its runtime content value type (read). */
 type FieldValue<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentBase[] : [TBlocks] extends [Block] ? BlockContent<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentBase[] : FieldTypeValueMap[TField['type']]>;
 /** Resolves a field definition to its input value type (write). */
 type FieldValueInput<TField extends Field = Field, TBlocks = NoBlocks> = Prettify<TField extends {
   type: 'bloks';
-} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
+} ? [TBlocks] extends [never] ? BlockContentInputBase[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyAllow<TField, TBlocks>, TBlocks>[] : BlockContentInputBase[] : FieldTypeValueMap[TField['type']]>;
 //#endregion
 export { BlockContent, BlockContentInput, BlocksFieldValue };
 //# sourceMappingURL=field.d.mts.map

package/dist/index.d.cts

@@ -1,9 +1,8 @@
 import { AssetUpdateRequest, CreateAsset, SpaceDetail } from "./generated/mapi/types.gen.cjs";
-import { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate } from "./generated/mapi/types-aliased.gen.cjs";
+import { Asset, AssetCreate, AssetFolder, AssetFolderCreate, AssetFolderUpdate, AssetUpdate, Component, ComponentCreate, ComponentFolder, ComponentFolderCreate, ComponentFolderUpdate, ComponentUpdate, DatasourceCreate, DatasourceUpdate, InternalTag, InternalTagCreate, InternalTagUpdate, MapiDatasource, MapiDatasourceEntry, Preset, PresetCreate, PresetUpdate, Space, SpaceCreate, SpaceUpdate, StoryLocalizedPath, StoryTranslatedSlug, User, UserUpdate } from "./generated/mapi/types-aliased.gen.cjs";
 import { AssetCreate as AssetCreate$1, AssetListQuery } from "./resources/assets.cjs";
-import { ComponentCreate, ComponentUpdate } from "./generated/mapi/_internal.gen.cjs";
 import { AssetFieldValue, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "./generated/overlay/_internal.gen.cjs";
-import { Block, RootBlock } from "./generated/types/block.cjs";
+import { RootBlock } from "./generated/types/block.cjs";
 import { ApiErrorBody, ClientError } from "./error.cjs";
 import { RateLimitConfig } from "./utils/rate-limit.cjs";
 import { BlockContent, BlockContentInput, BlocksFieldValue } from "./generated/types/field.cjs";
@@ -12,4 +11,4 @@ import { StoryListQuery } from "./resources/stories.cjs";
 import { ApiResponse, FetchOptions, HttpRequestOptions, ManagementApiClient, ManagementApiClientConfig, MapiResourceDeps, RequestConfigOverrides, createManagementApiClient } from "./client.cjs";
 import { SpaceCreateQuery } from "./resources/spaces.cjs";
 import { normalizeAssetUrl } from "./utils/normalize-asset-url.cjs";
-export { type ApiErrorBody, type ApiResponse, type Asset, type AssetCreate, type AssetFieldValue, type AssetFolder, type AssetFolderCreate, type AssetFolderUpdate, type AssetListQuery, type AssetUpdate, type AssetUpdateRequest, type AssetCreate$1 as AssetUploadRequest, type BlockContent as BlokContent, type BlockContentInput as BlokContentInput, type BlocksFieldValue as BloksFieldValue, ClientError, type Block as Component, type ComponentCreate, type ComponentFolder, type ComponentFolderCreate, type ComponentFolderUpdate, type ComponentUpdate, type MapiDatasource as Datasource, type DatasourceCreate, type MapiDatasourceEntry as DatasourceEntry, type DatasourceUpdate, type FetchOptions, type Field, type HttpRequestOptions, type InternalTag, type InternalTagCreate, type InternalTagUpdate, type ManagementApiClient, type ManagementApiClientConfig, type MapiResourceDeps, type MultilinkFieldValue, type PluginFieldValue, type Preset, type PresetCreate, type PresetUpdate, type RateLimitConfig, type RequestConfigOverrides, type RichtextFieldValue, type RootBlock as RootComponents, type CreateAsset as SignedResponseObject, type Space, type SpaceCreate, type SpaceCreateQuery, type SpaceDetail, type SpaceUpdate, type MapiStory as Story, type StoryCreate, type StoryListQuery, type StoryLocalizedPath, type StoryTranslatedSlug, type StoryUpdate, type TableFieldValue, type User, type UserUpdate, createManagementApiClient, normalizeAssetUrl };
+export { type ApiErrorBody, type ApiResponse, type Asset, type AssetCreate, type AssetFieldValue, type AssetFolder, type AssetFolderCreate, type AssetFolderUpdate, type AssetListQuery, type AssetUpdate, type AssetUpdateRequest, type AssetCreate$1 as AssetUploadRequest, type BlockContent as BlokContent, type BlockContentInput as BlokContentInput, type BlocksFieldValue as BloksFieldValue, ClientError, type Component, type ComponentCreate, type ComponentFolder, type ComponentFolderCreate, type ComponentFolderUpdate, type ComponentUpdate, type MapiDatasource as Datasource, type DatasourceCreate, type MapiDatasourceEntry as DatasourceEntry, type DatasourceUpdate, type FetchOptions, type Field, type HttpRequestOptions, type InternalTag, type InternalTagCreate, type InternalTagUpdate, type ManagementApiClient, type ManagementApiClientConfig, type MapiResourceDeps, type MultilinkFieldValue, type PluginFieldValue, type Preset, type PresetCreate, type PresetUpdate, type RateLimitConfig, type RequestConfigOverrides, type RichtextFieldValue, type RootBlock as RootComponents, type CreateAsset as SignedResponseObject, type Space, type SpaceCreate, type SpaceCreateQuery, type SpaceDetail, type SpaceUpdate, type MapiStory as Story, type StoryCreate, type StoryListQuery, type StoryLocalizedPath, type StoryTranslatedSlug, type StoryUpdate, type TableFieldValue, type User, type UserUpdate, createManagementApiClient, normalizeAssetUrl };