@storyblok/schema 1.0.0-alpha.0

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

@@ -0,0 +1,41 @@
+
+//#region src/helpers/define-datasource-entry.ts
+const DATASOURCE_ENTRY_DEFAULTS = { id: 1 };
+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
+});
+/**
+* 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/types';\nimport type { DatasourceEntryCreate, DatasourceEntryUpdate, DatasourceEntry as MapiDatasourceEntryGenerated } from '../generated/mapi-types';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_ENTRY_DEFAULTS = {\n  id: 1,\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; datasource_id: number } & Partial<Omit<MapiDatasourceEntryGenerated, 'name' | 'datasource_id'>>;\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});\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,EAChC,IAAI,GACL;AAuBD,SAAgB,sBAAsB,iBAAsB;AAC1D,QAAO;EAAE,GAAG;EAA2B,GAAG;EAAiB;;;;;;;;;AAU7D,MAAa,6BAA6B,WAA0D;CAClG,GAAG;CACH,GAAG;CACJ;;;;;;;AAQD,MAAa,+BAA+B,UAAwD;;;;;;;AAQpG,MAAa,+BAA+B,UAAwD"}

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

@@ -0,0 +1,48 @@
+import { DatasourceEntry as DatasourceEntry$1 } from "../generated/types.cjs";
+import { DatasourceEntry as DatasourceEntry$2, DatasourceEntryCreate, DatasourceEntryUpdate } from "../generated/mapi-types.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+
+//#region src/helpers/define-datasource-entry.d.ts
+declare const DATASOURCE_ENTRY_DEFAULTS: {
+  id: number;
+};
+type DatasourceEntry = DatasourceEntry$1;
+type MapiDatasourceEntry = DatasourceEntry$2;
+type DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;
+type DatasourceEntryInput = Prettify<Omit<DatasourceEntry$1, DatasourceEntryOptional> & Partial<Pick<DatasourceEntry$1, DatasourceEntryOptional>>>;
+type MapiDatasourceEntryInput = {
+  name: string;
+  datasource_id: number;
+} & Partial<Omit<DatasourceEntry$2, 'name' | 'datasource_id'>>;
+/**
+ * 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,48 @@
+import { DatasourceEntry as DatasourceEntry$1 } from "../generated/types.mjs";
+import { DatasourceEntry as DatasourceEntry$2, DatasourceEntryCreate, DatasourceEntryUpdate } from "../generated/mapi-types.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+
+//#region src/helpers/define-datasource-entry.d.ts
+declare const DATASOURCE_ENTRY_DEFAULTS: {
+  id: number;
+};
+type DatasourceEntry = DatasourceEntry$1;
+type MapiDatasourceEntry = DatasourceEntry$2;
+type DatasourceEntryOptional = keyof typeof DATASOURCE_ENTRY_DEFAULTS;
+type DatasourceEntryInput = Prettify<Omit<DatasourceEntry$1, DatasourceEntryOptional> & Partial<Pick<DatasourceEntry$1, DatasourceEntryOptional>>>;
+type MapiDatasourceEntryInput = {
+  name: string;
+  datasource_id: number;
+} & Partial<Omit<DatasourceEntry$2, 'name' | 'datasource_id'>>;
+/**
+ * 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,37 @@
+//#region src/helpers/define-datasource-entry.ts
+const DATASOURCE_ENTRY_DEFAULTS = { id: 1 };
+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
+});
+/**
+* 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/types';\nimport type { DatasourceEntryCreate, DatasourceEntryUpdate, DatasourceEntry as MapiDatasourceEntryGenerated } from '../generated/mapi-types';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_ENTRY_DEFAULTS = {\n  id: 1,\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; datasource_id: number } & Partial<Omit<MapiDatasourceEntryGenerated, 'name' | 'datasource_id'>>;\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});\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,EAChC,IAAI,GACL;AAuBD,SAAgB,sBAAsB,iBAAsB;AAC1D,QAAO;EAAE,GAAG;EAA2B,GAAG;EAAiB;;;;;;;;;AAU7D,MAAa,6BAA6B,WAA0D;CAClG,GAAG;CACH,GAAG;CACJ;;;;;;;AAQD,MAAa,+BAA+B,UAAwD;;;;;;;AAQpG,MAAa,+BAA+B,UAAwD"}

package/dist/helpers/define-datasource.cjs

@@ -0,0 +1,33 @@
+
+//#region src/helpers/define-datasource.ts
+const DATASOURCE_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: ""
+};
+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/types';\nimport type { DatasourceCreate, DatasourceUpdate } from '../generated/mapi-types';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\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;CACb;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,41 @@
+import { Datasource } from "../generated/types.cjs";
+import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi-types.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+
+//#region src/helpers/define-datasource.d.ts
+declare const DATASOURCE_DEFAULTS: {
+  id: number;
+  created_at: string;
+  updated_at: string;
+};
+/** 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,41 @@
+import { Datasource } from "../generated/types.mjs";
+import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi-types.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+
+//#region src/helpers/define-datasource.d.ts
+declare const DATASOURCE_DEFAULTS: {
+  id: number;
+  created_at: string;
+  updated_at: string;
+};
+/** 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,30 @@
+//#region src/helpers/define-datasource.ts
+const DATASOURCE_DEFAULTS = {
+	id: 1,
+	created_at: "",
+	updated_at: ""
+};
+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/types';\nimport type { DatasourceCreate, DatasourceUpdate } from '../generated/mapi-types';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\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;CACb;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  ComponentSchemaField as Field,\n} from '../generated/mapi-types';\nimport type {\n  AssetFieldValue,\n  BlokContent as BlokContentGenerated,\n  MultilinkFieldValue,\n  PluginFieldValue,\n  RichtextFieldValue,\n  TableFieldValue,\n} from '../generated/types';\nimport type { Block } from './define-block';\nimport type { Prettify } from '../utils/prettify';\n\nexport { 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: BlokContentGenerated[];\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        ? BlokContentGenerated[]\n        : [TBlocks] extends [Block]\n            ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[]\n            : BlokContentGenerated[]\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":";;;;;;;;;AAmKA,MAAa,eAIX,MACA,WAC4C;CAAE,GAAG;CAAO;CAAM"}

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

@@ -0,0 +1,100 @@
+import { AssetFieldValue, BlokContent, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../generated/types.cjs";
+import { ComponentSchemaField } from "../generated/mapi-types.cjs";
+import { Prettify } from "../utils/prettify.cjs";
+import { Block } from "./define-block.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 = ComponentSchemaField['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: BlokContent[];
+  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 ComponentSchemaField = ComponentSchemaField, TBlocks = false> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlokContent[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlokContent[] : FieldTypeValueMap[TField['type']]>;
+/** Resolves a field definition to its input value type (write). Nested bloks use {@link BlockContentInput}. */
+type FieldValueInput<TField extends ComponentSchemaField = ComponentSchemaField, 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 ComponentSchemaField>(name: TName, field: TField) => Omit<TField, "name"> & {
+  name: TName;
+};
+//#endregion
+export { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput, defineField };
+//# sourceMappingURL=define-field.d.cts.map

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

@@ -0,0 +1,100 @@
+import { AssetFieldValue, BlokContent, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../generated/types.mjs";
+import { ComponentSchemaField } from "../generated/mapi-types.mjs";
+import { Prettify } from "../utils/prettify.mjs";
+import { Block } from "./define-block.mjs";
+
+//#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 = ComponentSchemaField['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: BlokContent[];
+  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 ComponentSchemaField = ComponentSchemaField, TBlocks = false> = Prettify<TField extends {
+  type: 'bloks';
+} ? [TBlocks] extends [never] ? BlokContent[] : [TBlocks] extends [Block] ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[] : BlokContent[] : FieldTypeValueMap[TField['type']]>;
+/** Resolves a field definition to its input value type (write). Nested bloks use {@link BlockContentInput}. */
+type FieldValueInput<TField extends ComponentSchemaField = ComponentSchemaField, 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 ComponentSchemaField>(name: TName, field: TField) => Omit<TField, "name"> & {
+  name: TName;
+};
+//#endregion
+export { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput, defineField };
+//# sourceMappingURL=define-field.d.mts.map

package/dist/helpers/define-field.mjs

@@ -0,0 +1,16 @@
+//#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
+export { defineField };
+//# sourceMappingURL=define-field.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-field.mjs","names":[],"sources":["../../src/helpers/define-field.ts"],"sourcesContent":["import type {\n  ComponentSchemaField as Field,\n} from '../generated/mapi-types';\nimport type {\n  AssetFieldValue,\n  BlokContent as BlokContentGenerated,\n  MultilinkFieldValue,\n  PluginFieldValue,\n  RichtextFieldValue,\n  TableFieldValue,\n} from '../generated/types';\nimport type { Block } from './define-block';\nimport type { Prettify } from '../utils/prettify';\n\nexport { 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: BlokContentGenerated[];\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        ? BlokContentGenerated[]\n        : [TBlocks] extends [Block]\n            ? BlockContent<ApplyWhitelist<TField, TBlocks>, TBlocks>[]\n            : BlokContentGenerated[]\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":";;;;;;;;AAmKA,MAAa,eAIX,MACA,WAC4C;CAAE,GAAG;CAAO;CAAM"}