@storyblok/schema 0.1.0-alpha.0

package/dist/helpers/define-block.d.mts

@@ -0,0 +1,62 @@
+import { ComponentCreate, ComponentUpdate } from "../generated/mapi/_internal.gen.mjs";
+import { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord } from "../generated/types/block.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+
+//#region src/helpers/define-block.d.ts
+declare const BLOCK_DEFAULTS: {
+  id: number;
+  created_at: string;
+  updated_at: string;
+  is_root: boolean;
+  is_nestable: boolean;
+  component_group_uuid: null;
+};
+/** Fields that have safe defaults and may be omitted from block input. */
+type BlockOptional = keyof typeof BLOCK_DEFAULTS;
+type BlockInput<TName extends string = string, TInputSchema extends BlockSchemaInput = BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {
+  name: TName;
+  schema: TInputSchema;
+  is_root?: TIsRoot;
+  is_nestable?: TIsNestable;
+  component_group_uuid?: TComponentGroupUuid;
+} & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>>;
+type DefinedBlock<TName extends string, TBlockSchema, TIsRoot extends boolean, TIsNestable extends boolean, TComponentGroupUuid extends string | null> = Prettify<Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {
+  name: TName;
+  schema: TBlockSchema;
+  is_root: TIsRoot;
+  is_nestable: TIsNestable;
+  component_group_uuid: TComponentGroupUuid;
+}>;
+/**
+ * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire
+ * shape). The user-facing input is an ordered array of `defineField` calls;
+ * the array index becomes the field's `pos` in the returned map. Throws if
+ * two fields share the same `name`.
+ *
+ * @example
+ * const pageBlock = defineBlock({
+ *   name: 'page',
+ *   is_root: true,
+ *   schema: [
+ *     defineField('headline', { type: 'text', required: true }),
+ *   ],
+ * });
+ */
+declare function defineBlock<TName extends string, const TInputSchema extends BlockSchemaInput, TIsRoot extends boolean = false, TIsNestable extends boolean = true, TComponentGroupUuid extends string | null = null>(block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;
+/**
+ * Defines a block creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineBlockCreate({ name: 'page', schema: { ... } });
+ */
+declare const defineBlockCreate: (block: ComponentCreate) => ComponentCreate;
+/**
+ * Defines a block update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineBlockUpdate({ display_name: 'Page' });
+ */
+declare const defineBlockUpdate: (block: ComponentUpdate) => ComponentUpdate;
+//#endregion
+export { defineBlock, defineBlockCreate, defineBlockUpdate };
+//# sourceMappingURL=define-block.d.mts.map

package/dist/helpers/define-block.mjs

@@ -0,0 +1,48 @@
+//#region src/helpers/define-block.ts
+const BLOCK_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: "",
+	is_root: false,
+	is_nestable: true,
+	component_group_uuid: null
+};
+function defineBlock(block) {
+	const inputSchema = Array.isArray(block?.schema) ? block.schema : [];
+	const seen = /* @__PURE__ */ new Set();
+	const schemaRecord = {};
+	inputSchema.forEach((field, index) => {
+		const name = field?.name;
+		if (typeof name !== "string") return;
+		if (seen.has(name)) throw new Error(`defineBlock: duplicate field name "${name}" in block "${block?.name ?? ""}"`);
+		seen.add(name);
+		const { name: _name, ...rest } = field;
+		schemaRecord[name] = {
+			...rest,
+			pos: index
+		};
+	});
+	return {
+		...BLOCK_DEFAULTS,
+		...block,
+		schema: schemaRecord
+	};
+}
+/**
+* Defines a block creation payload for the MAPI.
+*
+* @example
+* const payload = defineBlockCreate({ name: 'page', schema: { ... } });
+*/
+const defineBlockCreate = (block) => block;
+/**
+* Defines a block update payload for the MAPI.
+*
+* @example
+* const payload = defineBlockUpdate({ display_name: 'Page' });
+*/
+const defineBlockUpdate = (block) => block;
+
+//#endregion
+export { defineBlock, defineBlockCreate, defineBlockUpdate };
+//# sourceMappingURL=define-block.mjs.map

package/dist/helpers/define-block.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-block.mjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockSchema,\n  BlockSchemaInput,\n  ComponentCreate,\n  ComponentUpdate,\n  NestableBlock,\n  RootBlock,\n  SchemaArrayToRecord,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockSchema, BlockSchemaInput, NestableBlock, RootBlock, SchemaArrayToRecord };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\n  component_group_uuid: null,\n};\n\n/** Fields that have safe defaults and may be omitted from block input. */\ntype BlockOptional = keyof typeof BLOCK_DEFAULTS;\n\ntype BlockInput<\n  TName extends string = string,\n  TInputSchema extends BlockSchemaInput = BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid' | BlockOptional> & {\n    name: TName;\n    schema: TInputSchema;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n    component_group_uuid?: TComponentGroupUuid;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable' | 'component_group_uuid'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TBlockSchema,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n  TComponentGroupUuid extends string | null,\n> = Prettify<\n  Omit<Block, 'name' | 'schema' | 'is_root' | 'is_nestable' | 'component_group_uuid'> & {\n    name: TName;\n    schema: TBlockSchema;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n    component_group_uuid: TComponentGroupUuid;\n  }\n>;\n\n/**\n * Returns a {@link Block} with object-shape `schema` (matches the MAPI wire\n * shape). The user-facing input is an ordered array of `defineField` calls;\n * the array index becomes the field's `pos` in the returned map. Throws if\n * two fields share the same `name`.\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   schema: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TInputSchema extends BlockSchemaInput,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n  TComponentGroupUuid extends string | null = null,\n>(\n  block: BlockInput<TName, TInputSchema, TIsRoot, TIsNestable, TComponentGroupUuid>,\n): DefinedBlock<TName, SchemaArrayToRecord<TInputSchema>, TIsRoot, TIsNestable, TComponentGroupUuid>;\n\nexport function defineBlock(block: any) {\n  const inputSchema = Array.isArray(block?.schema) ? block.schema : [];\n  const seen = new Set<string>();\n  const schemaRecord: Record<string, unknown> = {};\n  inputSchema.forEach((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name !== 'string') {\n      return;\n    }\n    if (seen.has(name)) {\n      throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n    }\n    seen.add(name);\n    const { name: _name, ...rest } = field;\n    schemaRecord[name] = { ...rest, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, schema: schemaRecord };\n}\n\n/**\n * Defines a block creation payload for the MAPI.\n *\n * @example\n * const payload = defineBlockCreate({ name: 'page', schema: { ... } });\n */\nexport const defineBlockCreate = (block: ComponentCreate): ComponentCreate => block;\n\n/**\n * Defines a block update payload for the MAPI.\n *\n * @example\n * const payload = defineBlockUpdate({ display_name: 'Page' });\n */\nexport const defineBlockUpdate = (block: ComponentUpdate): ComponentUpdate => block;\n"],"mappings":";AAcA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACb,sBAAsB;CACvB;AA8DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,eAAwC,EAAE;AAChD,aAAY,SAAS,OAAY,UAAkB;EACjD,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,OAAK,IAAI,KAAK;EACd,MAAM,EAAE,MAAM,OAAO,GAAG,SAAS;AACjC,eAAa,QAAQ;GAAE,GAAG;GAAM,KAAK;GAAO;GAC5C;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO,QAAQ;EAAc;;;;;;;;AAS9D,MAAa,qBAAqB,UAA4C;;;;;;;AAQ9E,MAAa,qBAAqB,UAA4C"}

package/dist/helpers/define-datasource-entry.cjs

@@ -0,0 +1,47 @@
+
+//#region src/helpers/define-datasource-entry.ts
+const DATASOURCE_ENTRY_DEFAULTS = {
+	id: 1,
+	value: "",
+	dimension_value: null
+};
+function defineDatasourceEntry(datasourceEntry) {
+	return {
+		...DATASOURCE_ENTRY_DEFAULTS,
+		...datasourceEntry
+	};
+}
+/**
+* Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.
+* Requires `datasource_id` to identify which datasource the entry belongs to.
+*
+* @example
+* const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });
+*/
+const defineMapiDatasourceEntry = (entry) => ({
+	...DATASOURCE_ENTRY_DEFAULTS,
+	...entry,
+	value: entry.value ?? DATASOURCE_ENTRY_DEFAULTS.value,
+	dimension_value: entry.dimension_value ?? DATASOURCE_ENTRY_DEFAULTS.dimension_value
+});
+/**
+* Defines a datasource entry creation payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });
+*/
+const defineDatasourceEntryCreate = (entry) => entry;
+/**
+* Defines a datasource entry update payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });
+*/
+const defineDatasourceEntryUpdate = (entry) => entry;
+
+//#endregion
+exports.defineDatasourceEntry = defineDatasourceEntry;
+exports.defineDatasourceEntryCreate = defineDatasourceEntryCreate;
+exports.defineDatasourceEntryUpdate = defineDatasourceEntryUpdate;
+exports.defineMapiDatasourceEntry = defineMapiDatasourceEntry;
+//# sourceMappingURL=define-datasource-entry.cjs.map

package/dist/helpers/define-datasource-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-datasource-entry.cjs","names":[],"sources":["../../src/helpers/define-datasource-entry.ts"],"sourcesContent":["import type { DatasourceEntry as CapiDatasourceEntry } from '../generated/capi/types.gen';\nimport type { DatasourceEntryCreate, DatasourceEntryUpdate, MapiDatasourceEntry as MapiDatasourceEntryGenerated } from '../generated/mapi/types.gen';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_ENTRY_DEFAULTS = {\n  id: 1,\n  value: '',\n  dimension_value: null,\n};\n\nexport type DatasourceEntry = CapiDatasourceEntry;\nexport type MapiDatasourceEntry = MapiDatasourceEntryGenerated;\nexport type { DatasourceEntryCreate, DatasourceEntryUpdate };\n\ntype DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;\n\ntype DatasourceEntryInput = Prettify<\n  Omit<CapiDatasourceEntry, DatasourceEntryOptional>\n  & Partial<Pick<CapiDatasourceEntry, DatasourceEntryOptional>>\n>;\n\ntype MapiDatasourceEntryInput = { name: string } & Partial<Omit<MapiDatasourceEntryGenerated, 'name'>>;\n\n/**\n * Returns a full {@link DatasourceEntry} (CDN shape) with all fields populated.\n *\n * @example\n * const entry = defineDatasourceEntry({ name: 'red', value: '#ff0000' });\n */\nexport function defineDatasourceEntry(datasourceEntry: DatasourceEntryInput): DatasourceEntry;\n\nexport function defineDatasourceEntry(datasourceEntry: any) {\n  return { ...DATASOURCE_ENTRY_DEFAULTS, ...datasourceEntry };\n}\n\n/**\n * Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.\n * Requires `datasource_id` to identify which datasource the entry belongs to.\n *\n * @example\n * const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });\n */\nexport const defineMapiDatasourceEntry = (entry: MapiDatasourceEntryInput): MapiDatasourceEntry => ({\n  ...DATASOURCE_ENTRY_DEFAULTS,\n  ...entry,\n  value: entry.value ?? DATASOURCE_ENTRY_DEFAULTS.value,\n  dimension_value: entry.dimension_value ?? DATASOURCE_ENTRY_DEFAULTS.dimension_value,\n});\n\n/**\n * Defines a datasource entry creation payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });\n */\nexport const defineDatasourceEntryCreate = (entry: DatasourceEntryCreate): DatasourceEntryCreate => entry;\n\n/**\n * Defines a datasource entry update payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });\n */\nexport const defineDatasourceEntryUpdate = (entry: DatasourceEntryUpdate): DatasourceEntryUpdate => entry;\n"],"mappings":";;AAIA,MAAM,4BAA4B;CAChC,IAAI;CACJ,OAAO;CACP,iBAAiB;CAClB;AAuBD,SAAgB,sBAAsB,iBAAsB;AAC1D,QAAO;EAAE,GAAG;EAA2B,GAAG;EAAiB;;;;;;;;;AAU7D,MAAa,6BAA6B,WAA0D;CAClG,GAAG;CACH,GAAG;CACH,OAAO,MAAM,SAAS,0BAA0B;CAChD,iBAAiB,MAAM,mBAAmB,0BAA0B;CACrE;;;;;;;AAQD,MAAa,+BAA+B,UAAwD;;;;;;;AAQpG,MAAa,+BAA+B,UAAwD"}

package/dist/helpers/define-datasource-entry.d.cts

@@ -0,0 +1,49 @@
+import { Prettify } from "../utils/prettify.cjs";
+import { DatasourceEntry as DatasourceEntry$1 } from "../generated/capi/types.gen.cjs";
+import { DatasourceEntryCreate, DatasourceEntryUpdate, MapiDatasourceEntry as MapiDatasourceEntry$1 } from "../generated/mapi/types.gen.cjs";
+
+//#region src/helpers/define-datasource-entry.d.ts
+declare const DATASOURCE_ENTRY_DEFAULTS: {
+  id: number;
+  value: string;
+  dimension_value: null;
+};
+type DatasourceEntry = DatasourceEntry$1;
+type MapiDatasourceEntry = MapiDatasourceEntry$1;
+type DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;
+type DatasourceEntryInput = Prettify<Omit<DatasourceEntry$1, DatasourceEntryOptional> & Partial<Pick<DatasourceEntry$1, DatasourceEntryOptional>>>;
+type MapiDatasourceEntryInput = {
+  name: string;
+} & Partial<Omit<MapiDatasourceEntry$1, 'name'>>;
+/**
+ * Returns a full {@link DatasourceEntry} (CDN shape) with all fields populated.
+ *
+ * @example
+ * const entry = defineDatasourceEntry({ name: 'red', value: '#ff0000' });
+ */
+declare function defineDatasourceEntry(datasourceEntry: DatasourceEntryInput): DatasourceEntry;
+/**
+ * Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.
+ * Requires `datasource_id` to identify which datasource the entry belongs to.
+ *
+ * @example
+ * const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });
+ */
+declare const defineMapiDatasourceEntry: (entry: MapiDatasourceEntryInput) => MapiDatasourceEntry;
+/**
+ * Defines a datasource entry creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });
+ */
+declare const defineDatasourceEntryCreate: (entry: DatasourceEntryCreate) => DatasourceEntryCreate;
+/**
+ * Defines a datasource entry update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });
+ */
+declare const defineDatasourceEntryUpdate: (entry: DatasourceEntryUpdate) => DatasourceEntryUpdate;
+//#endregion
+export { DatasourceEntry, MapiDatasourceEntry, defineDatasourceEntry, defineDatasourceEntryCreate, defineDatasourceEntryUpdate, defineMapiDatasourceEntry };
+//# sourceMappingURL=define-datasource-entry.d.cts.map

package/dist/helpers/define-datasource-entry.d.mts

@@ -0,0 +1,49 @@
+import { Prettify } from "../utils/prettify.mjs";
+import { DatasourceEntry as DatasourceEntry$1 } from "../generated/capi/types.gen.mjs";
+import { DatasourceEntryCreate, DatasourceEntryUpdate, MapiDatasourceEntry as MapiDatasourceEntry$1 } from "../generated/mapi/types.gen.mjs";
+
+//#region src/helpers/define-datasource-entry.d.ts
+declare const DATASOURCE_ENTRY_DEFAULTS: {
+  id: number;
+  value: string;
+  dimension_value: null;
+};
+type DatasourceEntry = DatasourceEntry$1;
+type MapiDatasourceEntry = MapiDatasourceEntry$1;
+type DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;
+type DatasourceEntryInput = Prettify<Omit<DatasourceEntry$1, DatasourceEntryOptional> & Partial<Pick<DatasourceEntry$1, DatasourceEntryOptional>>>;
+type MapiDatasourceEntryInput = {
+  name: string;
+} & Partial<Omit<MapiDatasourceEntry$1, 'name'>>;
+/**
+ * Returns a full {@link DatasourceEntry} (CDN shape) with all fields populated.
+ *
+ * @example
+ * const entry = defineDatasourceEntry({ name: 'red', value: '#ff0000' });
+ */
+declare function defineDatasourceEntry(datasourceEntry: DatasourceEntryInput): DatasourceEntry;
+/**
+ * Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.
+ * Requires `datasource_id` to identify which datasource the entry belongs to.
+ *
+ * @example
+ * const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });
+ */
+declare const defineMapiDatasourceEntry: (entry: MapiDatasourceEntryInput) => MapiDatasourceEntry;
+/**
+ * Defines a datasource entry creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });
+ */
+declare const defineDatasourceEntryCreate: (entry: DatasourceEntryCreate) => DatasourceEntryCreate;
+/**
+ * Defines a datasource entry update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });
+ */
+declare const defineDatasourceEntryUpdate: (entry: DatasourceEntryUpdate) => DatasourceEntryUpdate;
+//#endregion
+export { DatasourceEntry, MapiDatasourceEntry, defineDatasourceEntry, defineDatasourceEntryCreate, defineDatasourceEntryUpdate, defineMapiDatasourceEntry };
+//# sourceMappingURL=define-datasource-entry.d.mts.map

package/dist/helpers/define-datasource-entry.mjs

@@ -0,0 +1,43 @@
+//#region src/helpers/define-datasource-entry.ts
+const DATASOURCE_ENTRY_DEFAULTS = {
+	id: 1,
+	value: "",
+	dimension_value: null
+};
+function defineDatasourceEntry(datasourceEntry) {
+	return {
+		...DATASOURCE_ENTRY_DEFAULTS,
+		...datasourceEntry
+	};
+}
+/**
+* Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.
+* Requires `datasource_id` to identify which datasource the entry belongs to.
+*
+* @example
+* const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });
+*/
+const defineMapiDatasourceEntry = (entry) => ({
+	...DATASOURCE_ENTRY_DEFAULTS,
+	...entry,
+	value: entry.value ?? DATASOURCE_ENTRY_DEFAULTS.value,
+	dimension_value: entry.dimension_value ?? DATASOURCE_ENTRY_DEFAULTS.dimension_value
+});
+/**
+* Defines a datasource entry creation payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });
+*/
+const defineDatasourceEntryCreate = (entry) => entry;
+/**
+* Defines a datasource entry update payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });
+*/
+const defineDatasourceEntryUpdate = (entry) => entry;
+
+//#endregion
+export { defineDatasourceEntry, defineDatasourceEntryCreate, defineDatasourceEntryUpdate, defineMapiDatasourceEntry };
+//# sourceMappingURL=define-datasource-entry.mjs.map

package/dist/helpers/define-datasource-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-datasource-entry.mjs","names":[],"sources":["../../src/helpers/define-datasource-entry.ts"],"sourcesContent":["import type { DatasourceEntry as CapiDatasourceEntry } from '../generated/capi/types.gen';\nimport type { DatasourceEntryCreate, DatasourceEntryUpdate, MapiDatasourceEntry as MapiDatasourceEntryGenerated } from '../generated/mapi/types.gen';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_ENTRY_DEFAULTS = {\n  id: 1,\n  value: '',\n  dimension_value: null,\n};\n\nexport type DatasourceEntry = CapiDatasourceEntry;\nexport type MapiDatasourceEntry = MapiDatasourceEntryGenerated;\nexport type { DatasourceEntryCreate, DatasourceEntryUpdate };\n\ntype DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;\n\ntype DatasourceEntryInput = Prettify<\n  Omit<CapiDatasourceEntry, DatasourceEntryOptional>\n  & Partial<Pick<CapiDatasourceEntry, DatasourceEntryOptional>>\n>;\n\ntype MapiDatasourceEntryInput = { name: string } & Partial<Omit<MapiDatasourceEntryGenerated, 'name'>>;\n\n/**\n * Returns a full {@link DatasourceEntry} (CDN shape) with all fields populated.\n *\n * @example\n * const entry = defineDatasourceEntry({ name: 'red', value: '#ff0000' });\n */\nexport function defineDatasourceEntry(datasourceEntry: DatasourceEntryInput): DatasourceEntry;\n\nexport function defineDatasourceEntry(datasourceEntry: any) {\n  return { ...DATASOURCE_ENTRY_DEFAULTS, ...datasourceEntry };\n}\n\n/**\n * Returns a full {@link MapiDatasourceEntry} (MAPI shape) with all fields populated.\n * Requires `datasource_id` to identify which datasource the entry belongs to.\n *\n * @example\n * const entry = defineMapiDatasourceEntry({ name: 'red', datasource_id: 42 });\n */\nexport const defineMapiDatasourceEntry = (entry: MapiDatasourceEntryInput): MapiDatasourceEntry => ({\n  ...DATASOURCE_ENTRY_DEFAULTS,\n  ...entry,\n  value: entry.value ?? DATASOURCE_ENTRY_DEFAULTS.value,\n  dimension_value: entry.dimension_value ?? DATASOURCE_ENTRY_DEFAULTS.dimension_value,\n});\n\n/**\n * Defines a datasource entry creation payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceEntryCreate({ name: 'red', value: '#ff0000', datasource_id: 42 });\n */\nexport const defineDatasourceEntryCreate = (entry: DatasourceEntryCreate): DatasourceEntryCreate => entry;\n\n/**\n * Defines a datasource entry update payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceEntryUpdate({ value: '#ff0000' });\n */\nexport const defineDatasourceEntryUpdate = (entry: DatasourceEntryUpdate): DatasourceEntryUpdate => entry;\n"],"mappings":";AAIA,MAAM,4BAA4B;CAChC,IAAI;CACJ,OAAO;CACP,iBAAiB;CAClB;AAuBD,SAAgB,sBAAsB,iBAAsB;AAC1D,QAAO;EAAE,GAAG;EAA2B,GAAG;EAAiB;;;;;;;;;AAU7D,MAAa,6BAA6B,WAA0D;CAClG,GAAG;CACH,GAAG;CACH,OAAO,MAAM,SAAS,0BAA0B;CAChD,iBAAiB,MAAM,mBAAmB,0BAA0B;CACrE;;;;;;;AAQD,MAAa,+BAA+B,UAAwD;;;;;;;AAQpG,MAAa,+BAA+B,UAAwD"}

package/dist/helpers/define-datasource.cjs

@@ -0,0 +1,34 @@
+
+//#region src/helpers/define-datasource.ts
+const DATASOURCE_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: "",
+	dimensions: []
+};
+function defineDatasource(datasource) {
+	return {
+		...DATASOURCE_DEFAULTS,
+		...datasource
+	};
+}
+/**
+* Defines a datasource creation payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
+*/
+const defineDatasourceCreate = (datasource) => datasource;
+/**
+* Defines a datasource update payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
+*/
+const defineDatasourceUpdate = (datasource) => datasource;
+
+//#endregion
+exports.defineDatasource = defineDatasource;
+exports.defineDatasourceCreate = defineDatasourceCreate;
+exports.defineDatasourceUpdate = defineDatasourceUpdate;
+//# sourceMappingURL=define-datasource.cjs.map

package/dist/helpers/define-datasource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-datasource.cjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource } from '../generated/capi/types.gen';\nimport type { DatasourceCreate, DatasourceUpdate } from '../generated/mapi/types.gen';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\nexport type { Datasource, DatasourceCreate, DatasourceUpdate };\n\n/** Fields that have safe defaults and may be omitted from datasource input. */\ntype DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;\n\ntype DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;\n\n/**\n * Returns a full {@link Datasource} with all fields populated. API-assigned\n * fields are optional and default to safe values.\n *\n * @example\n * const myDatasource = defineDatasource({\n *   name: 'Colors',\n *   slug: 'colors',\n * });\n */\n// Overload: provides the strict public signature for callers.\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\n\n// Implementation signature: uses a loose parameter type because\n// TypeScript requires the implementation signature to be assignable\n// to all overloads. Not visible to callers.\nexport function defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n\n/**\n * Defines a datasource creation payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });\n */\nexport const defineDatasourceCreate = (datasource: DatasourceCreate): DatasourceCreate => datasource;\n\n/**\n * Defines a datasource update payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });\n */\nexport const defineDatasourceUpdate = (datasource: DatasourceUpdate): DatasourceUpdate => datasource;\n"],"mappings":";;AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAyBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY;;;;;;;;AASlD,MAAa,0BAA0B,eAAmD;;;;;;;AAQ1F,MAAa,0BAA0B,eAAmD"}

package/dist/helpers/define-datasource.d.cts

@@ -0,0 +1,42 @@
+import { Prettify } from "../utils/prettify.cjs";
+import { Datasource } from "../generated/capi/types.gen.cjs";
+import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.cjs";
+
+//#region src/helpers/define-datasource.d.ts
+declare const DATASOURCE_DEFAULTS: {
+  id: number;
+  created_at: string;
+  updated_at: string;
+  dimensions: never[];
+};
+/** Fields that have safe defaults and may be omitted from datasource input. */
+type DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;
+type DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;
+/**
+ * Returns a full {@link Datasource} with all fields populated. API-assigned
+ * fields are optional and default to safe values.
+ *
+ * @example
+ * const myDatasource = defineDatasource({
+ *   name: 'Colors',
+ *   slug: 'colors',
+ * });
+ */
+declare function defineDatasource(datasource: DatasourceInput): Datasource;
+/**
+ * Defines a datasource creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
+ */
+declare const defineDatasourceCreate: (datasource: DatasourceCreate) => DatasourceCreate;
+/**
+ * Defines a datasource update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
+ */
+declare const defineDatasourceUpdate: (datasource: DatasourceUpdate) => DatasourceUpdate;
+//#endregion
+export { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate };
+//# sourceMappingURL=define-datasource.d.cts.map

package/dist/helpers/define-datasource.d.mts

@@ -0,0 +1,42 @@
+import { Prettify } from "../utils/prettify.mjs";
+import { Datasource } from "../generated/capi/types.gen.mjs";
+import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.mjs";
+
+//#region src/helpers/define-datasource.d.ts
+declare const DATASOURCE_DEFAULTS: {
+  id: number;
+  created_at: string;
+  updated_at: string;
+  dimensions: never[];
+};
+/** Fields that have safe defaults and may be omitted from datasource input. */
+type DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;
+type DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;
+/**
+ * Returns a full {@link Datasource} with all fields populated. API-assigned
+ * fields are optional and default to safe values.
+ *
+ * @example
+ * const myDatasource = defineDatasource({
+ *   name: 'Colors',
+ *   slug: 'colors',
+ * });
+ */
+declare function defineDatasource(datasource: DatasourceInput): Datasource;
+/**
+ * Defines a datasource creation payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
+ */
+declare const defineDatasourceCreate: (datasource: DatasourceCreate) => DatasourceCreate;
+/**
+ * Defines a datasource update payload for the MAPI.
+ *
+ * @example
+ * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
+ */
+declare const defineDatasourceUpdate: (datasource: DatasourceUpdate) => DatasourceUpdate;
+//#endregion
+export { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate };
+//# sourceMappingURL=define-datasource.d.mts.map

package/dist/helpers/define-datasource.mjs

@@ -0,0 +1,31 @@
+//#region src/helpers/define-datasource.ts
+const DATASOURCE_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: "",
+	dimensions: []
+};
+function defineDatasource(datasource) {
+	return {
+		...DATASOURCE_DEFAULTS,
+		...datasource
+	};
+}
+/**
+* Defines a datasource creation payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });
+*/
+const defineDatasourceCreate = (datasource) => datasource;
+/**
+* Defines a datasource update payload for the MAPI.
+*
+* @example
+* const payload = defineDatasourceUpdate({ name: 'Updated Colors' });
+*/
+const defineDatasourceUpdate = (datasource) => datasource;
+
+//#endregion
+export { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate };
+//# sourceMappingURL=define-datasource.mjs.map

package/dist/helpers/define-datasource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-datasource.mjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource } from '../generated/capi/types.gen';\nimport type { DatasourceCreate, DatasourceUpdate } from '../generated/mapi/types.gen';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\nexport type { Datasource, DatasourceCreate, DatasourceUpdate };\n\n/** Fields that have safe defaults and may be omitted from datasource input. */\ntype DatasourceOptional = keyof typeof DATASOURCE_DEFAULTS;\n\ntype DatasourceInput = Prettify<Omit<Datasource, DatasourceOptional> & Partial<Pick<Datasource, DatasourceOptional>>>;\n\n/**\n * Returns a full {@link Datasource} with all fields populated. API-assigned\n * fields are optional and default to safe values.\n *\n * @example\n * const myDatasource = defineDatasource({\n *   name: 'Colors',\n *   slug: 'colors',\n * });\n */\n// Overload: provides the strict public signature for callers.\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\n\n// Implementation signature: uses a loose parameter type because\n// TypeScript requires the implementation signature to be assignable\n// to all overloads. Not visible to callers.\nexport function defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n\n/**\n * Defines a datasource creation payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceCreate({ name: 'Colors', slug: 'colors' });\n */\nexport const defineDatasourceCreate = (datasource: DatasourceCreate): DatasourceCreate => datasource;\n\n/**\n * Defines a datasource update payload for the MAPI.\n *\n * @example\n * const payload = defineDatasourceUpdate({ name: 'Updated Colors' });\n */\nexport const defineDatasourceUpdate = (datasource: DatasourceUpdate): DatasourceUpdate => datasource;\n"],"mappings":";AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAyBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY;;;;;;;;AASlD,MAAa,0BAA0B,eAAmD;;;;;;;AAQ1F,MAAa,0BAA0B,eAAmD"}

package/dist/helpers/define-field.cjs

@@ -0,0 +1,17 @@
+
+//#region src/helpers/define-field.ts
+/**
+* Returns a {@link Field} stamped with the given `name`. Use inside a
+* {@link defineBlock} `schema` array — `pos` is inferred from array index.
+*
+* @example
+* defineField('headline', { type: 'text', max_length: 100, required: true });
+*/
+const defineField = (name, field) => ({
+	...field,
+	name
+});
+
+//#endregion
+exports.defineField = defineField;
+//# sourceMappingURL=define-field.cjs.map

package/dist/helpers/define-field.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-field.cjs","names":[],"sources":["../../src/helpers/define-field.ts"],"sourcesContent":["import type {\n  AssetFieldValue,\n  Field,\n  MultilinkFieldValue,\n  PluginFieldValue,\n  RichtextFieldValue,\n  TableFieldValue,\n} from '../generated/types/field';\nimport type { Block } from './define-block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Field };\n\n/** Loose variant of the generated `BlokContent` with `_uid` optional — used as the fallback for write operations when no block union is provided. */\ntype BlokContentLoose = {\n  _uid?: string;\n  component: string;\n  _editable?: string | undefined;\n} & {\n  [key: string]:\n    | string\n    | number\n    | boolean\n    | Array<string | AssetFieldValue | BlokContentLoose>\n    | AssetFieldValue\n    | MultilinkFieldValue\n    | TableFieldValue\n    | RichtextFieldValue\n    | PluginFieldValue\n    | undefined;\n};\n\n/** Keys in a schema record that have `required: true`. */\ntype RequiredFieldKeys<T> = {\n  [K in keyof T]: T[K] extends { required: true } ? K : never\n}[keyof T];\n\n/** Keys in a schema record that do NOT have `required: true`. */\ntype OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;\n\n/**\n * Builds the content object for a single block instance as returned by the\n * Storyblok Content Delivery API. Includes `_uid` (always present in API\n * responses) and respects required/optional field semantics.\n *\n * For write operations (creating/updating stories), use {@link BlockContentInput}\n * instead, which omits `_uid` since Storyblok generates it automatically.\n */\nexport type BlockContent<TBlock extends Block = Block, TBlocks = false> = TBlock extends any\n  ? { _uid: string; component: TBlock['name'] }\n  & {\n    [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks>\n  }\n  & {\n    [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null\n  }\n  : never;\n\n/**\n * Input variant of {@link BlockContent} for write operations (creating/updating\n * stories via the MAPI). `_uid` is optional — Storyblok generates it\n * automatically when omitted. Nested bloks fields also use this input variant\n * so that deeply nested blocks do not require `_uid` either.\n */\nexport type BlockContentInput<TBlock extends Block = Block, TBlocks = false> = TBlock extends any\n  ? { _uid?: string; component: TBlock['name'] }\n  & {\n    [K in RequiredFieldKeys<TBlock['schema']>]: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks>\n  }\n  & {\n    [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> | null\n  }\n  : never;\n\nexport type BlocksFieldValue<\n  TBlock extends Block = Block,\n  TBlocks = false,\n> = BlockContent<TBlock, TBlocks>[];\n\nexport type { AssetFieldValue, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue };\n\n/** Union of all valid Storyblok field type discriminants (e.g., `text`, `bloks`). */\nexport type FieldType = Field['type'];\n\n/** Maps each field type discriminant to its runtime content value type. */\ninterface FieldTypeValueMap {\n  text: string;\n  textarea: string;\n  richtext: RichtextFieldValue;\n  markdown: string;\n  number: number;\n  datetime: string;\n  boolean: boolean;\n  option: string;\n  options: string[];\n  asset: AssetFieldValue;\n  multiasset: AssetFieldValue[];\n  multilink: MultilinkFieldValue;\n  bloks: BlockContent[];\n  table: TableFieldValue;\n  section: never;\n  tab: never;\n  custom: PluginFieldValue;\n}\n\n/**\n * Checks whether a block is nestable, defaulting to `true` when\n * `is_nestable` is absent or undefined.\n */\ntype IsNestable<T> =\n  T extends { is_nestable: false } ? false\n    : T extends { is_nestable: true } ? true\n      : true; // default: nestable when is_nestable is not specified\n\ntype ApplyWhitelist<TField, TBlocks> = TField extends { component_whitelist: ReadonlyArray<infer TWhitelisted extends string> }\n  // With whitelist: filter by block name (distributive over TBlocks)\n  ? TBlocks extends { name: TWhitelisted } ? TBlocks : never\n  // No whitelist: filter by nestability (distributive over TBlocks)\n  : TBlocks extends any\n    ? IsNestable<TBlocks> extends true ? TBlocks : never\n    : never;\n\n/** Resolves a field definition to its runtime content value type (read). */\nexport type FieldValue<\n  TField extends Field = Field,\n  TBlocks = false,\n> = Prettify<\n  TField extends { type: 'bloks' }\n    // Bloks field — guard against `never` first (it satisfies `[never] extends [X]`\n    // for all X, which would incorrectly enter the typed path with empty results).\n    ? [TBlocks] extends [never]\n        ? BlockContent[]\n        : [TBlocks] extends [Block]\n            ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[]\n            : BlockContent[]\n    // No bloks field\n    : FieldTypeValueMap[TField['type']]\n>;\n\n/** Resolves a field definition to its input value type (write). Nested bloks use {@link BlockContentInput}. */\nexport type FieldValueInput<\n  TField extends Field = Field,\n  TBlocks = false,\n> = Prettify<\n  TField extends { type: 'bloks' }\n    ? [TBlocks] extends [never]\n        ? BlokContentLoose[]\n        : [TBlocks] extends [Block]\n            ? BlockContentInput<ApplyWhitelist<TField, TBlocks>, TBlocks>[]\n            : BlokContentLoose[]\n    : FieldTypeValueMap[TField['type']]\n>;\n\n/**\n * Returns a {@link Field} stamped with the given `name`. Use inside a\n * {@link defineBlock} `schema` array — `pos` is inferred from array index.\n *\n * @example\n * defineField('headline', { type: 'text', max_length: 100, required: true });\n */\nexport const defineField = <\n  const TName extends string,\n  const TField extends Field,\n>(\n  name: TName,\n  field: TField,\n): Omit<TField, 'name'> & { name: TName } => ({ ...field, name });\n"],"mappings":";;;;;;;;;AAgKA,MAAa,eAIX,MACA,WAC4C;CAAE,GAAG;CAAO;CAAM"}

package/dist/helpers/define-field.d.cts

@@ -0,0 +1,99 @@
+import { AssetFieldValue, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../generated/overlay/_internal.gen.cjs";
+import { Block } from "../generated/types/block.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+
+//#region src/helpers/define-field.d.ts
+/** Loose variant of the generated `BlokContent` with `_uid` optional — used as the fallback for write operations when no block union is provided. */
+type BlokContentLoose = {
+  _uid?: string;
+  component: string;
+  _editable?: string | undefined;
+} & {
+  [key: string]: string | number | boolean | Array<string | AssetFieldValue | BlokContentLoose> | AssetFieldValue | MultilinkFieldValue | TableFieldValue | RichtextFieldValue | PluginFieldValue | undefined;
+};
+/** Keys in a schema record that have `required: true`. */
+type RequiredFieldKeys<T> = { [K in keyof T]: T[K] extends {
+  required: true;
+} ? K : never }[keyof T];
+/** Keys in a schema record that do NOT have `required: true`. */
+type OptionalFieldKeys<T> = Exclude<keyof T, RequiredFieldKeys<T>>;
+/**
+ * Builds the content object for a single block instance as returned by the
+ * Storyblok Content Delivery API. Includes `_uid` (always present in API
+ * responses) and respects required/optional field semantics.
+ *
+ * For write operations (creating/updating stories), use {@link BlockContentInput}
+ * instead, which omits `_uid` since Storyblok generates it automatically.
+ */
+type BlockContent<TBlock extends Block = Block, TBlocks = false> = TBlock extends any ? {
+  _uid: string;
+  component: TBlock['name'];
+} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValue<NonNullable<TBlock['schema'][K]>, TBlocks> | null } : never;
+/**
+ * Input variant of {@link BlockContent} for write operations (creating/updating
+ * stories via the MAPI). `_uid` is optional — Storyblok generates it
+ * automatically when omitted. Nested bloks fields also use this input variant
+ * so that deeply nested blocks do not require `_uid` either.
+ */
+type BlockContentInput<TBlock extends Block = Block, TBlocks = false> = TBlock extends any ? {
+  _uid?: string;
+  component: TBlock['name'];
+} & { [K in RequiredFieldKeys<TBlock['schema']>]: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> } & { [K in OptionalFieldKeys<TBlock['schema']>]?: FieldValueInput<NonNullable<TBlock['schema'][K]>, TBlocks> | null } : never;
+type BlocksFieldValue<TBlock extends Block = Block, TBlocks = false> = BlockContent<TBlock, TBlocks>[];
+/** Union of all valid Storyblok field type discriminants (e.g., `text`, `bloks`). */
+type FieldType = Field['type'];
+/** Maps each field type discriminant to its runtime content value type. */
+interface FieldTypeValueMap {
+  text: string;
+  textarea: string;
+  richtext: RichtextFieldValue;
+  markdown: string;
+  number: number;
+  datetime: string;
+  boolean: boolean;
+  option: string;
+  options: string[];
+  asset: AssetFieldValue;
+  multiasset: AssetFieldValue[];
+  multilink: MultilinkFieldValue;
+  bloks: BlockContent[];
+  table: TableFieldValue;
+  section: never;
+  tab: never;
+  custom: PluginFieldValue;
+}
+/**
+ * Checks whether a block is nestable, defaulting to `true` when
+ * `is_nestable` is absent or undefined.
+ */
+type IsNestable<T> = T extends {
+  is_nestable: false;
+} ? false : T extends {
+  is_nestable: true;
+} ? true : true;
+type ApplyWhitelist<TField, TBlocks> = TField extends {
+  component_whitelist: ReadonlyArray<infer TWhitelisted extends string>;
+} ? TBlocks extends {
+  name: TWhitelisted;
+} ? TBlocks : never : 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 = false> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlockContent[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlockContent[] : FieldTypeValueMap[TField['type']]>;
+/** Resolves a field definition to its input value type (write). Nested bloks use {@link BlockContentInput}. */
+type FieldValueInput<TField extends Field = Field, TBlocks = false> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlokContentLoose[] : [TBlocks] extends [Block] ? BlockContentInput<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlokContentLoose[] : FieldTypeValueMap[TField['type']]>;
+/**
+ * Returns a {@link Field} stamped with the given `name`. Use inside a
+ * {@link defineBlock} `schema` array — `pos` is inferred from array index.
+ *
+ * @example
+ * defineField('headline', { type: 'text', max_length: 100, required: true });
+ */
+declare const defineField: <const TName extends string, const TField extends Field>(name: TName, field: TField) => Omit<TField, "name"> & {
+  name: TName;
+};
+//#endregion
+export { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput, defineField };
+//# sourceMappingURL=define-field.d.cts.map