@storyblok/schema 0.1.0-alpha.0 → 0.1.0-alpha.2

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

@@ -1 +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"}
+{"version":3,"file":"define-block.mjs","names":[],"sources":["../../src/helpers/define-block.ts"],"sourcesContent":["import type {\n  Block,\n  BlockFields,\n  NestableBlock,\n  RootBlock,\n} from '../generated/types/block';\nimport type { Prettify } from '../utils/prettify';\n\nexport type { Block, BlockFields, NestableBlock, RootBlock };\n\nconst BLOCK_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  is_root: false,\n  is_nestable: true,\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  TFields extends BlockFields = BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable' | BlockOptional> & {\n    name: TName;\n    fields: TFields;\n    is_root?: TIsRoot;\n    is_nestable?: TIsNestable;\n  } & Partial<Pick<Block, Exclude<BlockOptional, 'is_root' | 'is_nestable'>>>\n>;\n\ntype DefinedBlock<\n  TName extends string,\n  TFields extends BlockFields,\n  TIsRoot extends boolean,\n  TIsNestable extends boolean,\n> = Prettify<\n  Omit<Block, 'name' | 'fields' | 'is_root' | 'is_nestable'> & {\n    name: TName;\n    fields: TFields;\n    is_root: TIsRoot;\n    is_nestable: TIsNestable;\n  }\n>;\n\n/**\n * Returns a {@link Block} content-shape definition. The user-facing input is an\n * ordered array of `defineField` calls under `fields`; the array index becomes\n * each field's `pos`. A thin, strongly-typed helper — it does not map to the\n * MAPI wire shape (the CLI owns the DSL→wire mapping). Throws only on duplicate\n * field names (a programming error).\n *\n * @example\n * const pageBlock = defineBlock({\n *   name: 'page',\n *   is_root: true,\n *   fields: [\n *     defineField('headline', { type: 'text', required: true }),\n *   ],\n * });\n */\nexport function defineBlock<\n  TName extends string,\n  const TFields extends BlockFields,\n  TIsRoot extends boolean = false,\n  TIsNestable extends boolean = true,\n>(\n  block: BlockInput<TName, TFields, TIsRoot, TIsNestable>,\n): DefinedBlock<TName, TFields, TIsRoot, TIsNestable>;\n\nexport function defineBlock(block: any) {\n  const inputFields = Array.isArray(block?.fields) ? block.fields : [];\n  const seen = new Set<string>();\n  const fields = inputFields.map((field: any, index: number) => {\n    const name = field?.name;\n    if (typeof name === 'string') {\n      if (seen.has(name)) {\n        throw new Error(`defineBlock: duplicate field name \"${name}\" in block \"${block?.name ?? ''}\"`);\n      }\n      seen.add(name);\n    }\n    return { ...field, pos: index };\n  });\n  return { ...BLOCK_DEFAULTS, ...block, fields };\n}\n"],"mappings":";AAUA,MAAM,iBAAiB;CACrB,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,aAAa;CACd;AA0DD,SAAgB,YAAY,OAAY;CACtC,MAAM,cAAc,MAAM,QAAQ,OAAO,OAAO,GAAG,MAAM,SAAS,EAAE;CACpE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAAS,YAAY,KAAK,OAAY,UAAkB;EAC5D,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,UAAU;AAC5B,OAAI,KAAK,IAAI,KAAK,CAChB,OAAM,IAAI,MAAM,sCAAsC,KAAK,cAAc,OAAO,QAAQ,GAAG,GAAG;AAEhG,QAAK,IAAI,KAAK;;AAEhB,SAAO;GAAE,GAAG;GAAO,KAAK;GAAO;GAC/B;AACF,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAO;EAAQ"}

package/dist/helpers/define-datasource.cjs

@@ -12,23 +12,7 @@ function defineDatasource(datasource) {
 		...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

@@ -1 +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"}
+{"version":3,"file":"define-datasource.cjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource as DatasourceGenerated } from '../generated/capi/types.gen';\nimport type { Override } from '../generated/types/_utils';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\n/**\n * A Storyblok datasource content shape. Carries the datasource definition only\n * (`name`, `slug`, dimensions). Entry values are content authored by editors,\n * not part of the schema, so they are neither modelled nor pushed here.\n */\nexport type Datasource = Override<DatasourceGenerated, { slug: string }>;\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 {@link Datasource} content-shape definition. A thin, strongly-typed\n * helper — it does not validate or throw.\n *\n * @example\n * const colors = defineDatasource({ name: 'Colors', slug: 'colors' });\n */\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\nexport function defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n"],"mappings":";;AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAsBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY"}

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

@@ -1,6 +1,6 @@
+import { Override } from "../generated/types/_utils.cjs";
 import { Prettify } from "../utils/prettify.cjs";
-import { Datasource } from "../generated/capi/types.gen.cjs";
-import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.cjs";
+import { Datasource as Datasource$1 } from "../generated/capi/types.gen.cjs";
 
 //#region src/helpers/define-datasource.d.ts
 declare const DATASOURCE_DEFAULTS: {
@@ -9,34 +9,25 @@ declare const DATASOURCE_DEFAULTS: {
   updated_at: string;
   dimensions: never[];
 };
+/**
+ * A Storyblok datasource content shape. Carries the datasource definition only
+ * (`name`, `slug`, dimensions). Entry values are content authored by editors,
+ * not part of the schema, so they are neither modelled nor pushed here.
+ */
+type Datasource = Override<Datasource$1, {
+  slug: 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.
+ * Returns a {@link Datasource} content-shape definition. A thin, strongly-typed
+ * helper — it does not validate or throw.
  *
  * @example
- * const myDatasource = defineDatasource({
- *   name: 'Colors',
- *   slug: 'colors',
- * });
+ * const colors = 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 };
+export { Datasource, defineDatasource };
 //# sourceMappingURL=define-datasource.d.cts.map

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

@@ -1,6 +1,6 @@
+import { Override } from "../generated/types/_utils.mjs";
 import { Prettify } from "../utils/prettify.mjs";
-import { Datasource } from "../generated/capi/types.gen.mjs";
-import { DatasourceCreate, DatasourceUpdate } from "../generated/mapi/types.gen.mjs";
+import { Datasource as Datasource$1 } from "../generated/capi/types.gen.mjs";
 
 //#region src/helpers/define-datasource.d.ts
 declare const DATASOURCE_DEFAULTS: {
@@ -9,34 +9,25 @@ declare const DATASOURCE_DEFAULTS: {
   updated_at: string;
   dimensions: never[];
 };
+/**
+ * A Storyblok datasource content shape. Carries the datasource definition only
+ * (`name`, `slug`, dimensions). Entry values are content authored by editors,
+ * not part of the schema, so they are neither modelled nor pushed here.
+ */
+type Datasource = Override<Datasource$1, {
+  slug: 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.
+ * Returns a {@link Datasource} content-shape definition. A thin, strongly-typed
+ * helper — it does not validate or throw.
  *
  * @example
- * const myDatasource = defineDatasource({
- *   name: 'Colors',
- *   slug: 'colors',
- * });
+ * const colors = 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 };
+export { Datasource, defineDatasource };
 //# sourceMappingURL=define-datasource.d.mts.map

package/dist/helpers/define-datasource.mjs

@@ -11,21 +11,7 @@ function defineDatasource(datasource) {
 		...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 };
+export { defineDatasource };
 //# sourceMappingURL=define-datasource.mjs.map

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

@@ -1 +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"}
+{"version":3,"file":"define-datasource.mjs","names":[],"sources":["../../src/helpers/define-datasource.ts"],"sourcesContent":["import type { Datasource as DatasourceGenerated } from '../generated/capi/types.gen';\nimport type { Override } from '../generated/types/_utils';\nimport type { Prettify } from '../utils/prettify';\n\nconst DATASOURCE_DEFAULTS = {\n  id: 1,\n  created_at: '',\n  updated_at: '',\n  dimensions: [],\n};\n\n/**\n * A Storyblok datasource content shape. Carries the datasource definition only\n * (`name`, `slug`, dimensions). Entry values are content authored by editors,\n * not part of the schema, so they are neither modelled nor pushed here.\n */\nexport type Datasource = Override<DatasourceGenerated, { slug: string }>;\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 {@link Datasource} content-shape definition. A thin, strongly-typed\n * helper — it does not validate or throw.\n *\n * @example\n * const colors = defineDatasource({ name: 'Colors', slug: 'colors' });\n */\nexport function defineDatasource(datasource: DatasourceInput): Datasource;\nexport function defineDatasource(datasource: any) {\n  return { ...DATASOURCE_DEFAULTS, ...datasource };\n}\n"],"mappings":";AAIA,MAAM,sBAAsB;CAC1B,IAAI;CACJ,YAAY;CACZ,YAAY;CACZ,YAAY,EAAE;CACf;AAsBD,SAAgB,iBAAiB,YAAiB;AAChD,QAAO;EAAE,GAAG;EAAqB,GAAG;EAAY"}

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

@@ -0,0 +1,21 @@
+
+//#region src/helpers/define-field-plugin.ts
+/**
+* Declares a custom field plugin: both the `fieldType` literal and the value
+* type infer from the single argument. `value` accepts any Standard Schema
+* validator (Zod, Valibot, ArkType, or hand-written) and is retained for
+* runtime use. A thin, strongly-typed identity helper — it does not validate.
+*
+* @example
+* const colorPicker = defineFieldPlugin({
+*   fieldType: 'my-custom-color-picker',
+*   value: z.object({ color: z.string(), alpha: z.number() }),
+* });
+*/
+function defineFieldPlugin(config) {
+	return config;
+}
+
+//#endregion
+exports.defineFieldPlugin = defineFieldPlugin;
+//# sourceMappingURL=define-field-plugin.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-field-plugin.cjs","names":[],"sources":["../../src/helpers/define-field-plugin.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Binds a Storyblok custom field `field_type` to a\n * [Standard Schema](https://standardschema.dev) validator. The validator (`S`,\n * retained on `value`) supplies both the static value type\n * (`StandardSchemaV1.InferOutput<S>`) and a runtime handle, so a single\n * declaration serves types and (future) runtime validation.\n */\nexport interface FieldPlugin<\n  F extends string = string,\n  S extends StandardSchemaV1 = StandardSchemaV1,\n> {\n  fieldType: F;\n  value: S;\n}\n\n/**\n * Declares a custom field plugin: both the `fieldType` literal and the value\n * type infer from the single argument. `value` accepts any Standard Schema\n * validator (Zod, Valibot, ArkType, or hand-written) and is retained for\n * runtime use. A thin, strongly-typed identity helper — it does not validate.\n *\n * @example\n * const colorPicker = defineFieldPlugin({\n *   fieldType: 'my-custom-color-picker',\n *   value: z.object({ color: z.string(), alpha: z.number() }),\n * });\n */\nexport function defineFieldPlugin<\n  const F extends string,\n  S extends StandardSchemaV1,\n>(config: { fieldType: F; value: S }): FieldPlugin<F, S> {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BA,SAAgB,kBAGd,QAAuD;AACvD,QAAO"}

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

@@ -0,0 +1,33 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/helpers/define-field-plugin.d.ts
+/**
+ * Binds a Storyblok custom field `field_type` to a
+ * [Standard Schema](https://standardschema.dev) validator. The validator (`S`,
+ * retained on `value`) supplies both the static value type
+ * (`StandardSchemaV1.InferOutput<S>`) and a runtime handle, so a single
+ * declaration serves types and (future) runtime validation.
+ */
+interface FieldPlugin<F extends string = string, S extends StandardSchemaV1 = StandardSchemaV1> {
+  fieldType: F;
+  value: S;
+}
+/**
+ * Declares a custom field plugin: both the `fieldType` literal and the value
+ * type infer from the single argument. `value` accepts any Standard Schema
+ * validator (Zod, Valibot, ArkType, or hand-written) and is retained for
+ * runtime use. A thin, strongly-typed identity helper — it does not validate.
+ *
+ * @example
+ * const colorPicker = defineFieldPlugin({
+ *   fieldType: 'my-custom-color-picker',
+ *   value: z.object({ color: z.string(), alpha: z.number() }),
+ * });
+ */
+declare function defineFieldPlugin<const F extends string, S extends StandardSchemaV1>(config: {
+  fieldType: F;
+  value: S;
+}): FieldPlugin<F, S>;
+//#endregion
+export { FieldPlugin, defineFieldPlugin };
+//# sourceMappingURL=define-field-plugin.d.cts.map

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

@@ -0,0 +1,33 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/helpers/define-field-plugin.d.ts
+/**
+ * Binds a Storyblok custom field `field_type` to a
+ * [Standard Schema](https://standardschema.dev) validator. The validator (`S`,
+ * retained on `value`) supplies both the static value type
+ * (`StandardSchemaV1.InferOutput<S>`) and a runtime handle, so a single
+ * declaration serves types and (future) runtime validation.
+ */
+interface FieldPlugin<F extends string = string, S extends StandardSchemaV1 = StandardSchemaV1> {
+  fieldType: F;
+  value: S;
+}
+/**
+ * Declares a custom field plugin: both the `fieldType` literal and the value
+ * type infer from the single argument. `value` accepts any Standard Schema
+ * validator (Zod, Valibot, ArkType, or hand-written) and is retained for
+ * runtime use. A thin, strongly-typed identity helper — it does not validate.
+ *
+ * @example
+ * const colorPicker = defineFieldPlugin({
+ *   fieldType: 'my-custom-color-picker',
+ *   value: z.object({ color: z.string(), alpha: z.number() }),
+ * });
+ */
+declare function defineFieldPlugin<const F extends string, S extends StandardSchemaV1>(config: {
+  fieldType: F;
+  value: S;
+}): FieldPlugin<F, S>;
+//#endregion
+export { FieldPlugin, defineFieldPlugin };
+//# sourceMappingURL=define-field-plugin.d.mts.map

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

@@ -0,0 +1,20 @@
+//#region src/helpers/define-field-plugin.ts
+/**
+* Declares a custom field plugin: both the `fieldType` literal and the value
+* type infer from the single argument. `value` accepts any Standard Schema
+* validator (Zod, Valibot, ArkType, or hand-written) and is retained for
+* runtime use. A thin, strongly-typed identity helper — it does not validate.
+*
+* @example
+* const colorPicker = defineFieldPlugin({
+*   fieldType: 'my-custom-color-picker',
+*   value: z.object({ color: z.string(), alpha: z.number() }),
+* });
+*/
+function defineFieldPlugin(config) {
+	return config;
+}
+
+//#endregion
+export { defineFieldPlugin };
+//# sourceMappingURL=define-field-plugin.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-field-plugin.mjs","names":[],"sources":["../../src/helpers/define-field-plugin.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Binds a Storyblok custom field `field_type` to a\n * [Standard Schema](https://standardschema.dev) validator. The validator (`S`,\n * retained on `value`) supplies both the static value type\n * (`StandardSchemaV1.InferOutput<S>`) and a runtime handle, so a single\n * declaration serves types and (future) runtime validation.\n */\nexport interface FieldPlugin<\n  F extends string = string,\n  S extends StandardSchemaV1 = StandardSchemaV1,\n> {\n  fieldType: F;\n  value: S;\n}\n\n/**\n * Declares a custom field plugin: both the `fieldType` literal and the value\n * type infer from the single argument. `value` accepts any Standard Schema\n * validator (Zod, Valibot, ArkType, or hand-written) and is retained for\n * runtime use. A thin, strongly-typed identity helper — it does not validate.\n *\n * @example\n * const colorPicker = defineFieldPlugin({\n *   fieldType: 'my-custom-color-picker',\n *   value: z.object({ color: z.string(), alpha: z.number() }),\n * });\n */\nexport function defineFieldPlugin<\n  const F extends string,\n  S extends StandardSchemaV1,\n>(config: { fieldType: F; value: S }): FieldPlugin<F, S> {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;AA6BA,SAAgB,kBAGd,QAAuD;AACvD,QAAO"}

package/dist/helpers/define-field.cjs

@@ -1,16 +1,16 @@
+const require_is_record = require('../utils/is-record.cjs');
 
 //#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
-});
+function defineField(name, field) {
+	const { allow, datasource, ...rest } = field;
+	const normalized = {
+		...rest,
+		name
+	};
+	if (allow !== void 0) normalized.allow = (Array.isArray(allow) ? allow : [allow]).map((ref) => typeof ref === "string" ? ref : require_is_record.isRecord(ref) ? ref.name : void 0);
+	if (datasource !== void 0) normalized.datasource = typeof datasource === "string" ? datasource : require_is_record.isRecord(datasource) ? datasource.slug : void 0;
+	return normalized;
+}
 
 //#endregion
 exports.defineField = defineField;

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

@@ -1 +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"}
+{"version":3,"file":"define-field.cjs","names":["isRecord"],"sources":["../../src/helpers/define-field.ts"],"sourcesContent":["import type {\n  AssetFieldValue,\n  BlockContent,\n  BlockContentInput,\n  BlocksFieldValue,\n  Field,\n  FieldType,\n  FieldValue,\n  FieldValueInput,\n  MultilinkFieldValue,\n  PluginFieldValue,\n  RichtextFieldValue,\n  TableFieldValue,\n} from '../generated/types/field';\nimport type { Prettify } from '../utils/prettify';\nimport { isRecord } from '../utils/is-record';\n\nexport type {\n  AssetFieldValue,\n  BlockContent,\n  BlockContentInput,\n  BlocksFieldValue,\n  Field,\n  FieldType,\n  FieldValue,\n  FieldValueInput,\n  MultilinkFieldValue,\n  PluginFieldValue,\n  RichtextFieldValue,\n  TableFieldValue,\n};\n\n/** A block reference for `allow`: a defined block object or its name. */\ntype AllowRef = string | { name: string };\n/** A datasource reference for `datasource`: a defined datasource object or its slug. */\ntype DatasourceRef = string | { slug: string };\n\ntype NameOf<T> = T extends string ? T : T extends { name: infer N extends string } ? N : never;\ntype SlugOf<T> = T extends string ? T : T extends { slug: infer S extends string } ? S : never;\n\n/** Normalizes an `allow` input (ref, name, or array thereof) to a tuple of block-name strings. */\ntype NormalizeAllow<T> = T extends readonly any[]\n  ? { [I in keyof T]: NameOf<T[I]> }\n  : readonly [NameOf<T>];\n\n/**\n * Field config accepted by {@link defineField}: the content-shape field plus the\n * DSL reference keys. `allow` replaces the wire `component_whitelist`; `datasource`\n * holds the datasource ref/slug (the wire `source` selector still passes through).\n */\nexport type FieldInput = Field & {\n  allow?: AllowRef | readonly AllowRef[];\n  datasource?: DatasourceRef;\n  required?: boolean;\n};\n\n/** Result of {@link defineField}: the field stamped with `name`, with refs normalized to strings. */\nexport type DefinedField<TName extends string, TField extends FieldInput> = Prettify<\n  Omit<TField, 'allow' | 'datasource' | 'name'>\n  & { name: TName }\n  & (TField extends { allow: infer A } ? { allow: NormalizeAllow<A> } : unknown)\n  & (TField extends { datasource: infer D } ? { datasource: SlugOf<D> } : unknown)\n>;\n\n/**\n * Returns a {@link Field} stamped with the given `name`, normalizing reference\n * keys to strings so everything downstream sees plain names/slugs. A thin,\n * strongly-typed identity helper — it does not validate or throw.\n *\n * Use inside a {@link defineBlock} `fields` array — `pos` is injected from the\n * array index by `defineBlock`.\n *\n * @example\n * defineField('headline', { type: 'text', max_length: 100, required: true });\n * defineField('body', { type: 'bloks', allow: [heroBlock, 'teaser'] });\n * defineField('theme', { type: 'option', source: 'internal', datasource: colors });\n */\nexport function defineField<\n  const TName extends string,\n  const TField extends FieldInput,\n>(name: TName, field: TField): DefinedField<TName, TField>;\nexport function defineField(name: string, field: Record<string, unknown>): Record<string, unknown> {\n  const { allow, datasource, ...rest } = field;\n  const normalized: Record<string, unknown> = { ...rest, name };\n  if (allow !== undefined) {\n    const refs = Array.isArray(allow) ? allow : [allow];\n    normalized.allow = refs.map(ref => (typeof ref === 'string' ? ref : isRecord(ref) ? ref.name : undefined));\n  }\n  if (datasource !== undefined) {\n    normalized.datasource = typeof datasource === 'string' ? datasource : isRecord(datasource) ? datasource.slug : undefined;\n  }\n  return normalized;\n}\n"],"mappings":";;;AAiFA,SAAgB,YAAY,MAAc,OAAyD;CACjG,MAAM,EAAE,OAAO,YAAY,GAAG,SAAS;CACvC,MAAM,aAAsC;EAAE,GAAG;EAAM;EAAM;AAC7D,KAAI,UAAU,OAEZ,YAAW,SADE,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EAC3B,KAAI,QAAQ,OAAO,QAAQ,WAAW,MAAMA,2BAAS,IAAI,GAAG,IAAI,OAAO,OAAW;AAE5G,KAAI,eAAe,OACjB,YAAW,aAAa,OAAO,eAAe,WAAW,aAAaA,2BAAS,WAAW,GAAG,WAAW,OAAO;AAEjH,QAAO"}

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

@@ -1,99 +1,60 @@
 import { AssetFieldValue, Field, MultilinkFieldValue, PluginFieldValue, RichtextFieldValue, TableFieldValue } from "../generated/overlay/_internal.gen.cjs";
-import { Block } from "../generated/types/block.cjs";
+import { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput } from "../generated/types/field.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;
+/** A block reference for `allow`: a defined block object or its name. */
+type AllowRef = string | {
+  name: string;
 };
-/** 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;
-}
+/** A datasource reference for `datasource`: a defined datasource object or its slug. */
+type DatasourceRef = string | {
+  slug: string;
+};
+type NameOf<T> = T extends string ? T : T extends {
+  name: infer N extends string;
+} ? N : never;
+type SlugOf<T> = T extends string ? T : T extends {
+  slug: infer S extends string;
+} ? S : never;
+/** Normalizes an `allow` input (ref, name, or array thereof) to a tuple of block-name strings. */
+type NormalizeAllow<T> = T extends readonly any[] ? { [I in keyof T]: NameOf<T[I]> } : readonly [NameOf<T>];
 /**
- * Checks whether a block is nestable, defaulting to `true` when
- * `is_nestable` is absent or undefined.
+ * Field config accepted by {@link defineField}: the content-shape field plus the
+ * DSL reference keys. `allow` replaces the wire `component_whitelist`; `datasource`
+ * holds the datasource ref/slug (the wire `source` selector still passes through).
  */
-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']]>;
+type FieldInput = Field & {
+  allow?: AllowRef | readonly AllowRef[];
+  datasource?: DatasourceRef;
+  required?: boolean;
+};
+/** Result of {@link defineField}: the field stamped with `name`, with refs normalized to strings. */
+type DefinedField<TName extends string, TField extends FieldInput> = Prettify<Omit<TField, 'allow' | 'datasource' | 'name'> & {
+  name: TName;
+} & (TField extends {
+  allow: infer A;
+} ? {
+  allow: NormalizeAllow<A>;
+} : unknown) & (TField extends {
+  datasource: infer D;
+} ? {
+  datasource: SlugOf<D>;
+} : unknown)>;
 /**
- * Returns a {@link Field} stamped with the given `name`. Use inside a
- * {@link defineBlock} `schema` array — `pos` is inferred from array index.
+ * Returns a {@link Field} stamped with the given `name`, normalizing reference
+ * keys to strings so everything downstream sees plain names/slugs. A thin,
+ * strongly-typed identity helper — it does not validate or throw.
+ *
+ * Use inside a {@link defineBlock} `fields` array — `pos` is injected from the
+ * array index by `defineBlock`.
  *
  * @example
  * defineField('headline', { type: 'text', max_length: 100, required: true });
+ * defineField('body', { type: 'bloks', allow: [heroBlock, 'teaser'] });
+ * defineField('theme', { type: 'option', source: 'internal', datasource: colors });
  */
-declare const defineField: <const TName extends string, const TField extends Field>(name: TName, field: TField) => Omit<TField, "name"> & {
-  name: TName;
-};
+declare function defineField<const TName extends string, const TField extends FieldInput>(name: TName, field: TField): DefinedField<TName, TField>;
 //#endregion
-export { BlockContent, BlockContentInput, BlocksFieldValue, FieldType, FieldValue, FieldValueInput, defineField };
+export { DefinedField, FieldInput, defineField };
 //# sourceMappingURL=define-field.d.cts.map