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

package/dist/helpers/schema-type.d.cts

@@ -1,7 +1,15 @@
-import { Block } from "../generated/types/block.cjs";
 import { Datasource } from "./define-datasource.cjs";
+import { FieldPlugin } from "./define-field-plugin.cjs";
+import { SchemaConfig } from "./define-schema.cjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/helpers/schema-type.d.ts
+/**
+ * Derives a `fieldType → validator output` map from a `fieldPlugins` record.
+ * Record keys are cosmetic labels; the map is keyed by each plugin's
+ * `fieldType`. Resolves to `{}` when no plugins are registered.
+ */
+type FieldPluginMap<TPlugins> = TPlugins extends Record<string, FieldPlugin> ? { [K in keyof TPlugins as TPlugins[K]['fieldType']]: StandardSchemaV1.InferOutput<TPlugins[K]['value']> } : Record<never, never>;
 /**
  * Derives a schema types interface from a schema object.
  *
@@ -12,24 +20,24 @@ import { Datasource } from "./define-datasource.cjs";
  *
  * @example
  * ```ts
+ * import { defineSchema } from '@storyblok/schema';
  * import type { Schema as InferSchema } from '@storyblok/schema';
  *
- * export const schema = {
+ * export const schema = defineSchema({
  *   blocks: { pageBlock, heroBlock },
  *   datasources: { colorsDatasource },
- * };
+ *   fieldPlugins: { storyblokColorField },
+ * });
  *
  * export type Schema = InferSchema<typeof schema>;
  * export type Blocks = Schema['blocks'];
- * export type Datasources = Schema['datasources'];
+ * export type FieldPlugins = Schema['fieldPlugins'];
  * ```
  */
-interface Schema<T extends {
-  blocks: Record<string, Block>;
-  datasources?: Record<string, Datasource>;
-}> {
+interface Schema<T extends SchemaConfig> {
   blocks: T['blocks'][keyof T['blocks']];
   datasources: T['datasources'] extends Record<string, Datasource> ? T['datasources'][keyof T['datasources']] : never;
+  fieldPlugins: FieldPluginMap<T['fieldPlugins']>;
 }
 //#endregion
 export { Schema };

package/dist/helpers/schema-type.d.mts

@@ -1,7 +1,15 @@
-import { Block } from "../generated/types/block.mjs";
 import { Datasource } from "./define-datasource.mjs";
+import { FieldPlugin } from "./define-field-plugin.mjs";
+import { SchemaConfig } from "./define-schema.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/helpers/schema-type.d.ts
+/**
+ * Derives a `fieldType → validator output` map from a `fieldPlugins` record.
+ * Record keys are cosmetic labels; the map is keyed by each plugin's
+ * `fieldType`. Resolves to `{}` when no plugins are registered.
+ */
+type FieldPluginMap<TPlugins> = TPlugins extends Record<string, FieldPlugin> ? { [K in keyof TPlugins as TPlugins[K]['fieldType']]: StandardSchemaV1.InferOutput<TPlugins[K]['value']> } : Record<never, never>;
 /**
  * Derives a schema types interface from a schema object.
  *
@@ -12,24 +20,24 @@ import { Datasource } from "./define-datasource.mjs";
  *
  * @example
  * ```ts
+ * import { defineSchema } from '@storyblok/schema';
  * import type { Schema as InferSchema } from '@storyblok/schema';
  *
- * export const schema = {
+ * export const schema = defineSchema({
  *   blocks: { pageBlock, heroBlock },
  *   datasources: { colorsDatasource },
- * };
+ *   fieldPlugins: { storyblokColorField },
+ * });
  *
  * export type Schema = InferSchema<typeof schema>;
  * export type Blocks = Schema['blocks'];
- * export type Datasources = Schema['datasources'];
+ * export type FieldPlugins = Schema['fieldPlugins'];
  * ```
  */
-interface Schema<T extends {
-  blocks: Record<string, Block>;
-  datasources?: Record<string, Datasource>;
-}> {
+interface Schema<T extends SchemaConfig> {
   blocks: T['blocks'][keyof T['blocks']];
   datasources: T['datasources'] extends Record<string, Datasource> ? T['datasources'][keyof T['datasources']] : never;
+  fieldPlugins: FieldPluginMap<T['fieldPlugins']>;
 }
 //#endregion
 export { Schema };

package/dist/index.cjs

@@ -2,6 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_define_block = require('./helpers/define-block.cjs');
 const require_define_datasource = require('./helpers/define-datasource.cjs');
 const require_define_field = require('./helpers/define-field.cjs');
+const require_define_field_plugin = require('./helpers/define-field-plugin.cjs');
+const require_define_schema = require('./helpers/define-schema.cjs');
 const require_validate_story = require('./validators/validate-story.cjs');
 const require_create_story_validator = require('./validators/create-story-validator.cjs');
 const require_validate_schema = require('./validators/validate-schema.cjs');
@@ -10,5 +12,7 @@ exports.createStoryValidator = require_create_story_validator.createStoryValidat
 exports.defineBlock = require_define_block.defineBlock;
 exports.defineDatasource = require_define_datasource.defineDatasource;
 exports.defineField = require_define_field.defineField;
+exports.defineFieldPlugin = require_define_field_plugin.defineFieldPlugin;
+exports.defineSchema = require_define_schema.defineSchema;
 exports.validateSchema = require_validate_schema.validateSchema;
 exports.validateStory = require_validate_story.validateStory;

package/dist/index.d.cts

@@ -6,9 +6,11 @@ import { Story } from "./generated/types/story.cjs";
 import { defineBlock } from "./helpers/define-block.cjs";
 import { Datasource, defineDatasource } from "./helpers/define-datasource.cjs";
 import { DefinedField, FieldInput, defineField } from "./helpers/define-field.cjs";
+import { FieldPlugin, defineFieldPlugin } from "./helpers/define-field-plugin.cjs";
+import { defineSchema } from "./helpers/define-schema.cjs";
 import { Schema } from "./helpers/schema-type.cjs";
 import { createStoryValidator } from "./validators/create-story-validator.cjs";
 import { ValidationIssue, ValidationResult, ValidationSeverity } from "./validators/types.cjs";
 import { validateSchema } from "./validators/validate-schema.cjs";
 import { validateStory } from "./validators/validate-story.cjs";
-export { type AssetFieldValue, type Block, type BlockContent, type BlockContentInput, type BlockFields, type BlocksFieldValue, type Datasource, type DefinedField, type Field, type FieldInput, type FieldType, type FieldValue, type FieldValueInput, type MapiStory, type MultilinkFieldValue, type NestableBlock, type PluginFieldValue, type RichtextFieldValue, type RootBlock, type Schema, type Story, type TableFieldValue, type ValidationIssue, type ValidationResult, type ValidationSeverity, createStoryValidator, defineBlock, defineDatasource, defineField, validateSchema, validateStory };
+export { type AssetFieldValue, type Block, type BlockContent, type BlockContentInput, type BlockFields, type BlocksFieldValue, type Datasource, type DefinedField, type Field, type FieldInput, type FieldPlugin, type FieldType, type FieldValue, type FieldValueInput, type MapiStory, type MultilinkFieldValue, type NestableBlock, type PluginFieldValue, type RichtextFieldValue, type RootBlock, type Schema, type Story, type TableFieldValue, type ValidationIssue, type ValidationResult, type ValidationSeverity, createStoryValidator, defineBlock, defineDatasource, defineField, defineFieldPlugin, defineSchema, validateSchema, validateStory };

package/dist/index.d.mts

@@ -6,9 +6,11 @@ import { Story } from "./generated/types/story.mjs";
 import { defineBlock } from "./helpers/define-block.mjs";
 import { Datasource, defineDatasource } from "./helpers/define-datasource.mjs";
 import { DefinedField, FieldInput, defineField } from "./helpers/define-field.mjs";
+import { FieldPlugin, defineFieldPlugin } from "./helpers/define-field-plugin.mjs";
+import { defineSchema } from "./helpers/define-schema.mjs";
 import { Schema } from "./helpers/schema-type.mjs";
 import { createStoryValidator } from "./validators/create-story-validator.mjs";
 import { ValidationIssue, ValidationResult, ValidationSeverity } from "./validators/types.mjs";
 import { validateSchema } from "./validators/validate-schema.mjs";
 import { validateStory } from "./validators/validate-story.mjs";
-export { type AssetFieldValue, type Block, type BlockContent, type BlockContentInput, type BlockFields, type BlocksFieldValue, type Datasource, type DefinedField, type Field, type FieldInput, type FieldType, type FieldValue, type FieldValueInput, type MapiStory, type MultilinkFieldValue, type NestableBlock, type PluginFieldValue, type RichtextFieldValue, type RootBlock, type Schema, type Story, type TableFieldValue, type ValidationIssue, type ValidationResult, type ValidationSeverity, createStoryValidator, defineBlock, defineDatasource, defineField, validateSchema, validateStory };
+export { type AssetFieldValue, type Block, type BlockContent, type BlockContentInput, type BlockFields, type BlocksFieldValue, type Datasource, type DefinedField, type Field, type FieldInput, type FieldPlugin, type FieldType, type FieldValue, type FieldValueInput, type MapiStory, type MultilinkFieldValue, type NestableBlock, type PluginFieldValue, type RichtextFieldValue, type RootBlock, type Schema, type Story, type TableFieldValue, type ValidationIssue, type ValidationResult, type ValidationSeverity, createStoryValidator, defineBlock, defineDatasource, defineField, defineFieldPlugin, defineSchema, validateSchema, validateStory };

package/dist/index.mjs

@@ -1,8 +1,10 @@
 import { defineBlock } from "./helpers/define-block.mjs";
 import { defineDatasource } from "./helpers/define-datasource.mjs";
 import { defineField } from "./helpers/define-field.mjs";
+import { defineFieldPlugin } from "./helpers/define-field-plugin.mjs";
+import { defineSchema } from "./helpers/define-schema.mjs";
 import { validateStory } from "./validators/validate-story.mjs";
 import { createStoryValidator } from "./validators/create-story-validator.mjs";
 import { validateSchema } from "./validators/validate-schema.mjs";
 
-export { createStoryValidator, defineBlock, defineDatasource, defineField, validateSchema, validateStory };
+export { createStoryValidator, defineBlock, defineDatasource, defineField, defineFieldPlugin, defineSchema, validateSchema, validateStory };

package/dist/validators/internal-schemas.mjs

@@ -1,3 +1,3 @@
-import { zAssetFieldValue, zMultilinkFieldValue, zPluginFieldValue, zRichtextFieldValue, zTableFieldValue } from "../generated/overlay/zod.gen.mjs";
+import { zAssetFieldValue, zMultilinkFieldValue, zRichtextFieldValue, zTableFieldValue } from "../generated/overlay/zod.gen.mjs";
 
 export {  };

package/dist/validators/shapes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"shapes.cjs","names":[],"sources":["../../src/validators/shapes.ts"],"sourcesContent":["import type { FieldType } from '../generated/types/field';\n\nexport { isRecord } from '../utils/is-record';\n\n/**\n * Loose structural views of the content-shape definitions, used internally by\n * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is\n * structurally assignable to these, but they also tolerate the plain objects a\n * validator may receive at runtime.\n */\n\n/** A single field within a block's `fields` array. */\nexport interface SchemaFieldLike {\n  name: string;\n  type: FieldType;\n  required?: boolean;\n  /** Normalized block-name references for `bloks` fields. */\n  allow?: readonly string[];\n  /** Normalized datasource slug for option/options fields. */\n  datasource?: string;\n  // Value constraints enforced by `validateStory` (all optional).\n  /** `text`/`textarea`/`markdown`: maximum string length. */\n  max_length?: number;\n  /** `text`/`textarea`: legacy alias for `max_length`. */\n  maxlength?: number;\n  /** `text`/`textarea`: minimum string length. */\n  minlength?: number;\n  /** `number`: inclusive lower bound. */\n  min_value?: number;\n  /** `number`: inclusive upper bound. */\n  max_value?: number;\n  /** `number`: maximum number of fractional digits. */\n  decimals?: number;\n  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */\n  steps?: number;\n  /** `bloks`: minimum number of nested blocks. */\n  minimum?: number;\n  /** `bloks`: maximum number of nested blocks. */\n  maximum?: number;\n  /** `multiasset`: minimum number of assets. */\n  minimum_entries?: number;\n  /** `multiasset`: maximum number of assets. */\n  maximum_entries?: number;\n  /** `options`: minimum number of selected options (stored as a string). */\n  min_options?: string;\n  /** `options`: maximum number of selected options (stored as a string). */\n  max_options?: string;\n}\n\n/** A block definition (`defineBlock` result). */\nexport interface SchemaBlockLike {\n  name: string;\n  fields?: readonly SchemaFieldLike[];\n}\n\n/** A datasource definition (`defineDatasource` result). */\nexport interface SchemaDatasourceLike {\n  slug?: string;\n}\n\n/** The schema object accepted by the validators: blocks (required) and datasources (optional). */\nexport interface SchemaLike {\n  blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];\n  datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];\n}\n\n/** Normalizes a record-or-array of entities to an array of values. */\nexport function toValues<T>(input: Record<string, T> | readonly T[] | undefined): T[] {\n  if (!input) {\n    return [];\n  }\n  return Array.isArray(input) ? [...input] : Object.values(input as Record<string, T>);\n}\n"],"mappings":";;;;AAmEA,SAAgB,SAAY,OAA0D;AACpF,KAAI,CAAC,MACH,QAAO,EAAE;AAEX,QAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,OAAO,OAAO,MAA2B"}
+{"version":3,"file":"shapes.cjs","names":[],"sources":["../../src/validators/shapes.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { FieldType } from '../generated/types/field';\n\nexport { isRecord } from '../utils/is-record';\n\n/**\n * Loose structural views of the content-shape definitions, used internally by\n * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is\n * structurally assignable to these, but they also tolerate the plain objects a\n * validator may receive at runtime.\n */\n\n/** A single field within a block's `fields` array. */\nexport interface SchemaFieldLike {\n  name: string;\n  type: FieldType;\n  /** `custom`: the field plugin discriminant, matched against registered `fieldPlugins`. */\n  field_type?: string;\n  required?: boolean;\n  /** Normalized block-name references for `bloks` fields. */\n  allow?: readonly string[];\n  /** Normalized datasource slug for option/options fields. */\n  datasource?: string;\n  // Value constraints enforced by `validateStory` (all optional).\n  /** `text`/`textarea`/`markdown`: maximum string length. */\n  max_length?: number;\n  /** `text`/`textarea`: legacy alias for `max_length`. */\n  maxlength?: number;\n  /** `text`/`textarea`: minimum string length. */\n  minlength?: number;\n  /** `number`: inclusive lower bound. */\n  min_value?: number;\n  /** `number`: inclusive upper bound. */\n  max_value?: number;\n  /** `number`: maximum number of fractional digits. */\n  decimals?: number;\n  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */\n  steps?: number;\n  /** `bloks`: minimum number of nested blocks. */\n  minimum?: number;\n  /** `bloks`: maximum number of nested blocks. */\n  maximum?: number;\n  /** `multiasset`: minimum number of assets. */\n  minimum_entries?: number;\n  /** `multiasset`: maximum number of assets. */\n  maximum_entries?: number;\n  /** `options`: minimum number of selected options (stored as a string). */\n  min_options?: string;\n  /** `options`: maximum number of selected options (stored as a string). */\n  max_options?: string;\n}\n\n/** A block definition (`defineBlock` result). */\nexport interface SchemaBlockLike {\n  name: string;\n  fields?: readonly SchemaFieldLike[];\n}\n\n/** A datasource definition (`defineDatasource` result). */\nexport interface SchemaDatasourceLike {\n  slug?: string;\n}\n\n/** A field plugin registration (`defineFieldPlugin` result). */\nexport interface FieldPluginLike {\n  fieldType: string;\n  value: StandardSchemaV1;\n}\n\n/** The schema object accepted by the validators: blocks (required), datasources and field plugins (optional). */\nexport interface SchemaLike {\n  blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];\n  datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];\n  fieldPlugins?: Record<string, FieldPluginLike> | readonly FieldPluginLike[];\n}\n\n/** Normalizes a record-or-array of entities to an array of values. */\nexport function toValues<T>(input: Record<string, T> | readonly T[] | undefined): T[] {\n  if (!input) {\n    return [];\n  }\n  return Array.isArray(input) ? [...input] : Object.values(input as Record<string, T>);\n}\n"],"mappings":";;;;AA6EA,SAAgB,SAAY,OAA0D;AACpF,KAAI,CAAC,MACH,QAAO,EAAE;AAEX,QAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,OAAO,OAAO,MAA2B"}

package/dist/validators/shapes.d.cts

@@ -1,4 +1,5 @@
 import { FieldType } from "../generated/types/field.cjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/validators/shapes.d.ts
 /**
@@ -11,6 +12,8 @@ import { FieldType } from "../generated/types/field.cjs";
 interface SchemaFieldLike {
   name: string;
   type: FieldType;
+  /** `custom`: the field plugin discriminant, matched against registered `fieldPlugins`. */
+  field_type?: string;
   required?: boolean;
   /** Normalized block-name references for `bloks` fields. */
   allow?: readonly string[];
@@ -52,10 +55,16 @@ interface SchemaBlockLike {
 interface SchemaDatasourceLike {
   slug?: string;
 }
-/** The schema object accepted by the validators: blocks (required) and datasources (optional). */
+/** A field plugin registration (`defineFieldPlugin` result). */
+interface FieldPluginLike {
+  fieldType: string;
+  value: StandardSchemaV1;
+}
+/** The schema object accepted by the validators: blocks (required), datasources and field plugins (optional). */
 interface SchemaLike {
   blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];
   datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];
+  fieldPlugins?: Record<string, FieldPluginLike> | readonly FieldPluginLike[];
 }
 //#endregion
 export { SchemaBlockLike, SchemaLike };

package/dist/validators/shapes.d.mts

@@ -1,4 +1,5 @@
 import { FieldType } from "../generated/types/field.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/validators/shapes.d.ts
 /**
@@ -11,6 +12,8 @@ import { FieldType } from "../generated/types/field.mjs";
 interface SchemaFieldLike {
   name: string;
   type: FieldType;
+  /** `custom`: the field plugin discriminant, matched against registered `fieldPlugins`. */
+  field_type?: string;
   required?: boolean;
   /** Normalized block-name references for `bloks` fields. */
   allow?: readonly string[];
@@ -52,10 +55,16 @@ interface SchemaBlockLike {
 interface SchemaDatasourceLike {
   slug?: string;
 }
-/** The schema object accepted by the validators: blocks (required) and datasources (optional). */
+/** A field plugin registration (`defineFieldPlugin` result). */
+interface FieldPluginLike {
+  fieldType: string;
+  value: StandardSchemaV1;
+}
+/** The schema object accepted by the validators: blocks (required), datasources and field plugins (optional). */
 interface SchemaLike {
   blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];
   datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];
+  fieldPlugins?: Record<string, FieldPluginLike> | readonly FieldPluginLike[];
 }
 //#endregion
 export { SchemaBlockLike, SchemaLike };

package/dist/validators/shapes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shapes.mjs","names":[],"sources":["../../src/validators/shapes.ts"],"sourcesContent":["import type { FieldType } from '../generated/types/field';\n\nexport { isRecord } from '../utils/is-record';\n\n/**\n * Loose structural views of the content-shape definitions, used internally by\n * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is\n * structurally assignable to these, but they also tolerate the plain objects a\n * validator may receive at runtime.\n */\n\n/** A single field within a block's `fields` array. */\nexport interface SchemaFieldLike {\n  name: string;\n  type: FieldType;\n  required?: boolean;\n  /** Normalized block-name references for `bloks` fields. */\n  allow?: readonly string[];\n  /** Normalized datasource slug for option/options fields. */\n  datasource?: string;\n  // Value constraints enforced by `validateStory` (all optional).\n  /** `text`/`textarea`/`markdown`: maximum string length. */\n  max_length?: number;\n  /** `text`/`textarea`: legacy alias for `max_length`. */\n  maxlength?: number;\n  /** `text`/`textarea`: minimum string length. */\n  minlength?: number;\n  /** `number`: inclusive lower bound. */\n  min_value?: number;\n  /** `number`: inclusive upper bound. */\n  max_value?: number;\n  /** `number`: maximum number of fractional digits. */\n  decimals?: number;\n  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */\n  steps?: number;\n  /** `bloks`: minimum number of nested blocks. */\n  minimum?: number;\n  /** `bloks`: maximum number of nested blocks. */\n  maximum?: number;\n  /** `multiasset`: minimum number of assets. */\n  minimum_entries?: number;\n  /** `multiasset`: maximum number of assets. */\n  maximum_entries?: number;\n  /** `options`: minimum number of selected options (stored as a string). */\n  min_options?: string;\n  /** `options`: maximum number of selected options (stored as a string). */\n  max_options?: string;\n}\n\n/** A block definition (`defineBlock` result). */\nexport interface SchemaBlockLike {\n  name: string;\n  fields?: readonly SchemaFieldLike[];\n}\n\n/** A datasource definition (`defineDatasource` result). */\nexport interface SchemaDatasourceLike {\n  slug?: string;\n}\n\n/** The schema object accepted by the validators: blocks (required) and datasources (optional). */\nexport interface SchemaLike {\n  blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];\n  datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];\n}\n\n/** Normalizes a record-or-array of entities to an array of values. */\nexport function toValues<T>(input: Record<string, T> | readonly T[] | undefined): T[] {\n  if (!input) {\n    return [];\n  }\n  return Array.isArray(input) ? [...input] : Object.values(input as Record<string, T>);\n}\n"],"mappings":";;;;AAmEA,SAAgB,SAAY,OAA0D;AACpF,KAAI,CAAC,MACH,QAAO,EAAE;AAEX,QAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,OAAO,OAAO,MAA2B"}
+{"version":3,"file":"shapes.mjs","names":[],"sources":["../../src/validators/shapes.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { FieldType } from '../generated/types/field';\n\nexport { isRecord } from '../utils/is-record';\n\n/**\n * Loose structural views of the content-shape definitions, used internally by\n * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is\n * structurally assignable to these, but they also tolerate the plain objects a\n * validator may receive at runtime.\n */\n\n/** A single field within a block's `fields` array. */\nexport interface SchemaFieldLike {\n  name: string;\n  type: FieldType;\n  /** `custom`: the field plugin discriminant, matched against registered `fieldPlugins`. */\n  field_type?: string;\n  required?: boolean;\n  /** Normalized block-name references for `bloks` fields. */\n  allow?: readonly string[];\n  /** Normalized datasource slug for option/options fields. */\n  datasource?: string;\n  // Value constraints enforced by `validateStory` (all optional).\n  /** `text`/`textarea`/`markdown`: maximum string length. */\n  max_length?: number;\n  /** `text`/`textarea`: legacy alias for `max_length`. */\n  maxlength?: number;\n  /** `text`/`textarea`: minimum string length. */\n  minlength?: number;\n  /** `number`: inclusive lower bound. */\n  min_value?: number;\n  /** `number`: inclusive upper bound. */\n  max_value?: number;\n  /** `number`: maximum number of fractional digits. */\n  decimals?: number;\n  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */\n  steps?: number;\n  /** `bloks`: minimum number of nested blocks. */\n  minimum?: number;\n  /** `bloks`: maximum number of nested blocks. */\n  maximum?: number;\n  /** `multiasset`: minimum number of assets. */\n  minimum_entries?: number;\n  /** `multiasset`: maximum number of assets. */\n  maximum_entries?: number;\n  /** `options`: minimum number of selected options (stored as a string). */\n  min_options?: string;\n  /** `options`: maximum number of selected options (stored as a string). */\n  max_options?: string;\n}\n\n/** A block definition (`defineBlock` result). */\nexport interface SchemaBlockLike {\n  name: string;\n  fields?: readonly SchemaFieldLike[];\n}\n\n/** A datasource definition (`defineDatasource` result). */\nexport interface SchemaDatasourceLike {\n  slug?: string;\n}\n\n/** A field plugin registration (`defineFieldPlugin` result). */\nexport interface FieldPluginLike {\n  fieldType: string;\n  value: StandardSchemaV1;\n}\n\n/** The schema object accepted by the validators: blocks (required), datasources and field plugins (optional). */\nexport interface SchemaLike {\n  blocks: Record<string, SchemaBlockLike> | readonly SchemaBlockLike[];\n  datasources?: Record<string, SchemaDatasourceLike> | readonly SchemaDatasourceLike[];\n  fieldPlugins?: Record<string, FieldPluginLike> | readonly FieldPluginLike[];\n}\n\n/** Normalizes a record-or-array of entities to an array of values. */\nexport function toValues<T>(input: Record<string, T> | readonly T[] | undefined): T[] {\n  if (!input) {\n    return [];\n  }\n  return Array.isArray(input) ? [...input] : Object.values(input as Record<string, T>);\n}\n"],"mappings":";;;;AA6EA,SAAgB,SAAY,OAA0D;AACpF,KAAI,CAAC,MACH,QAAO,EAAE;AAEX,QAAO,MAAM,QAAQ,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,OAAO,OAAO,MAA2B"}

package/dist/validators/validate-schema.cjs

@@ -6,7 +6,8 @@ const require_shapes = require('./shapes.cjs');
 * Validates a schema definition without throwing. Checks structural identity
 * (duplicate block names, field names, and datasource slugs) and cross-references
 * (every `allow` entry resolves to a defined block; every field `datasource`
-* resolves to a defined datasource).
+* resolves to a defined datasource; every `custom` field's `field_type`
+* resolves to a registered field plugin).
 *
 * @example
 * const result = validateSchema({ blocks: { hero }, datasources: { colors } });
@@ -16,6 +17,12 @@ function validateSchema(schema) {
 	const issues = [];
 	const blocks = require_shapes.toValues(schema.blocks);
 	const datasources = require_shapes.toValues(schema.datasources);
+	const fieldPlugins = require_shapes.toValues(schema.fieldPlugins);
+	const fieldPluginTypes = /* @__PURE__ */ new Set();
+	for (const plugin of fieldPlugins) {
+		const fieldType = plugin?.fieldType;
+		if (typeof fieldType === "string") fieldPluginTypes.add(fieldType);
+	}
 	const datasourceSlugs = /* @__PURE__ */ new Set();
 	for (const datasource of datasources) {
 		const slug = datasource?.slug;
@@ -112,6 +119,19 @@ function validateSchema(schema) {
 				entity: `block:${blockName}`,
 				message: `Field "${fieldName}" references unknown datasource "${datasource}".`
 			});
+			const fieldType = field.field_type;
+			if (field.type === "custom" && typeof fieldType === "string" && !fieldPluginTypes.has(fieldType)) issues.push({
+				severity: "error",
+				code: "unresolved_field_plugin",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"field_type"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" references unregistered field plugin "${fieldType}".`
+			});
 		}
 	}
 	return {

package/dist/validators/validate-schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validate-schema.cjs","names":["toValues","isRecord"],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,eAAe,QAAsC;CACnE,MAAM,SAA4B,EAAE;CACpC,MAAM,SAASA,wBAAS,OAAO,OAAO;CACtC,MAAM,cAAcA,wBAAS,OAAO,YAAY;CAEhD,MAAM,kCAAkB,IAAI,KAAa;AACzC,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,OAAO,YAAY;AACzB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,gBAAgB,IAAI,KAAK,CAC3B,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,eAAe,KAAK;GAC3B,QAAQ,cAAc;GACtB,SAAS,8BAA8B,KAAK;GAC7C,CAAC;AAEJ,kBAAgB,IAAI,KAAK;;CAG3B,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,WAAW,IAAI,KAAK,CACtB,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,UAAU,KAAK;GACtB,QAAQ,SAAS;GACjB,SAAS,yBAAyB,KAAK;GACxC,CAAC;AAEJ,aAAW,IAAI,KAAK;;AAKtB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,YAAY,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO;EACjE,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,SAAS,OAAO,UAAU,EAAE;AAClC,OAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS;GAClD,MAAM,QAAQ,OAAO;AAGrB,OAAI,CAACC,2BAAS,MAAM,EAAE;AACpB,WAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAM;KAClC,QAAQ,SAAS;KACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;KACzD,CAAC;AACF;;GAEF,MAAM,YAAY,MAAM;AACxB,OAAI,OAAO,cAAc,UAAU;AACjC,QAAI,WAAW,IAAI,UAAU,CAC3B,QAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAU;KACtC,QAAQ,SAAS;KACjB,SAAS,yBAAyB,UAAU,cAAc,UAAU;KACrE,CAAC;AAEJ,eAAW,IAAI,UAAU;SAGzB,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW;KAAM;IAClC,QAAQ,SAAS;IACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;IACzD,CAAC;AAGJ,QAAK,MAAM,WAAW,MAAM,SAAS,EAAE,CACrC,KAAI,OAAO,YAAY,YAAY,CAAC,WAAW,IAAI,QAAQ,CACzD,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAQ;IACrD,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,0BAA0B,QAAQ;IAChE,CAAC;GAIN,MAAM,aAAa,MAAM;AACzB,OAAI,OAAO,eAAe,YAAY,CAAC,gBAAgB,IAAI,WAAW,CACpE,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAa;IAC1D,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,mCAAmC,WAAW;IAC5E,CAAC;;;AAKR,QAAO;EAAE,IAAI,OAAO,OAAM,UAAS,MAAM,aAAa,QAAQ;EAAE;EAAQ"}
+{"version":3,"file":"validate-schema.cjs","names":["toValues","isRecord"],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource; every `custom` field's `field_type`\n * resolves to a registered field plugin).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n  const fieldPlugins = toValues(schema.fieldPlugins);\n\n  const fieldPluginTypes = new Set<string>();\n  for (const plugin of fieldPlugins) {\n    const fieldType = plugin?.fieldType;\n    if (typeof fieldType === 'string') {\n      fieldPluginTypes.add(fieldType);\n    }\n  }\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n\n      const fieldType = field.field_type;\n      if (field.type === 'custom' && typeof fieldType === 'string' && !fieldPluginTypes.has(fieldType)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_field_plugin',\n          path: ['blocks', blockName, fieldName ?? '', 'field_type'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unregistered field plugin \"${fieldType}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":"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"}

package/dist/validators/validate-schema.d.cts

@@ -6,7 +6,8 @@ import { ValidationResult } from "./types.cjs";
  * Validates a schema definition without throwing. Checks structural identity
  * (duplicate block names, field names, and datasource slugs) and cross-references
  * (every `allow` entry resolves to a defined block; every field `datasource`
- * resolves to a defined datasource).
+ * resolves to a defined datasource; every `custom` field's `field_type`
+ * resolves to a registered field plugin).
  *
  * @example
  * const result = validateSchema({ blocks: { hero }, datasources: { colors } });

package/dist/validators/validate-schema.d.mts

@@ -6,7 +6,8 @@ import { ValidationResult } from "./types.mjs";
  * Validates a schema definition without throwing. Checks structural identity
  * (duplicate block names, field names, and datasource slugs) and cross-references
  * (every `allow` entry resolves to a defined block; every field `datasource`
- * resolves to a defined datasource).
+ * resolves to a defined datasource; every `custom` field's `field_type`
+ * resolves to a registered field plugin).
  *
  * @example
  * const result = validateSchema({ blocks: { hero }, datasources: { colors } });

package/dist/validators/validate-schema.mjs

@@ -6,7 +6,8 @@ import { toValues } from "./shapes.mjs";
 * Validates a schema definition without throwing. Checks structural identity
 * (duplicate block names, field names, and datasource slugs) and cross-references
 * (every `allow` entry resolves to a defined block; every field `datasource`
-* resolves to a defined datasource).
+* resolves to a defined datasource; every `custom` field's `field_type`
+* resolves to a registered field plugin).
 *
 * @example
 * const result = validateSchema({ blocks: { hero }, datasources: { colors } });
@@ -16,6 +17,12 @@ function validateSchema(schema) {
 	const issues = [];
 	const blocks = toValues(schema.blocks);
 	const datasources = toValues(schema.datasources);
+	const fieldPlugins = toValues(schema.fieldPlugins);
+	const fieldPluginTypes = /* @__PURE__ */ new Set();
+	for (const plugin of fieldPlugins) {
+		const fieldType = plugin?.fieldType;
+		if (typeof fieldType === "string") fieldPluginTypes.add(fieldType);
+	}
 	const datasourceSlugs = /* @__PURE__ */ new Set();
 	for (const datasource of datasources) {
 		const slug = datasource?.slug;
@@ -112,6 +119,19 @@ function validateSchema(schema) {
 				entity: `block:${blockName}`,
 				message: `Field "${fieldName}" references unknown datasource "${datasource}".`
 			});
+			const fieldType = field.field_type;
+			if (field.type === "custom" && typeof fieldType === "string" && !fieldPluginTypes.has(fieldType)) issues.push({
+				severity: "error",
+				code: "unresolved_field_plugin",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"field_type"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" references unregistered field plugin "${fieldType}".`
+			});
 		}
 	}
 	return {

package/dist/validators/validate-schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validate-schema.mjs","names":[],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,eAAe,QAAsC;CACnE,MAAM,SAA4B,EAAE;CACpC,MAAM,SAAS,SAAS,OAAO,OAAO;CACtC,MAAM,cAAc,SAAS,OAAO,YAAY;CAEhD,MAAM,kCAAkB,IAAI,KAAa;AACzC,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,OAAO,YAAY;AACzB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,gBAAgB,IAAI,KAAK,CAC3B,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,eAAe,KAAK;GAC3B,QAAQ,cAAc;GACtB,SAAS,8BAA8B,KAAK;GAC7C,CAAC;AAEJ,kBAAgB,IAAI,KAAK;;CAG3B,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,WAAW,IAAI,KAAK,CACtB,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,UAAU,KAAK;GACtB,QAAQ,SAAS;GACjB,SAAS,yBAAyB,KAAK;GACxC,CAAC;AAEJ,aAAW,IAAI,KAAK;;AAKtB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,YAAY,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO;EACjE,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,SAAS,OAAO,UAAU,EAAE;AAClC,OAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS;GAClD,MAAM,QAAQ,OAAO;AAGrB,OAAI,CAAC,SAAS,MAAM,EAAE;AACpB,WAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAM;KAClC,QAAQ,SAAS;KACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;KACzD,CAAC;AACF;;GAEF,MAAM,YAAY,MAAM;AACxB,OAAI,OAAO,cAAc,UAAU;AACjC,QAAI,WAAW,IAAI,UAAU,CAC3B,QAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAU;KACtC,QAAQ,SAAS;KACjB,SAAS,yBAAyB,UAAU,cAAc,UAAU;KACrE,CAAC;AAEJ,eAAW,IAAI,UAAU;SAGzB,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW;KAAM;IAClC,QAAQ,SAAS;IACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;IACzD,CAAC;AAGJ,QAAK,MAAM,WAAW,MAAM,SAAS,EAAE,CACrC,KAAI,OAAO,YAAY,YAAY,CAAC,WAAW,IAAI,QAAQ,CACzD,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAQ;IACrD,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,0BAA0B,QAAQ;IAChE,CAAC;GAIN,MAAM,aAAa,MAAM;AACzB,OAAI,OAAO,eAAe,YAAY,CAAC,gBAAgB,IAAI,WAAW,CACpE,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAa;IAC1D,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,mCAAmC,WAAW;IAC5E,CAAC;;;AAKR,QAAO;EAAE,IAAI,OAAO,OAAM,UAAS,MAAM,aAAa,QAAQ;EAAE;EAAQ"}
+{"version":3,"file":"validate-schema.mjs","names":[],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource; every `custom` field's `field_type`\n * resolves to a registered field plugin).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n  const fieldPlugins = toValues(schema.fieldPlugins);\n\n  const fieldPluginTypes = new Set<string>();\n  for (const plugin of fieldPlugins) {\n    const fieldType = plugin?.fieldType;\n    if (typeof fieldType === 'string') {\n      fieldPluginTypes.add(fieldType);\n    }\n  }\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n\n      const fieldType = field.field_type;\n      if (field.type === 'custom' && typeof fieldType === 'string' && !fieldPluginTypes.has(fieldType)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_field_plugin',\n          path: ['blocks', blockName, fieldName ?? '', 'field_type'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unregistered field plugin \"${fieldType}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":"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"}

package/dist/validators/validate-story.cjs

@@ -1,7 +1,9 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_is_record = require('../utils/is-record.cjs');
 const require_shapes = require('./shapes.cjs');
 const require_zod_gen = require('../generated/overlay/zod.gen.cjs');
 require('./internal-schemas.cjs');
+let zod = require("zod");
 
 //#region src/validators/validate-story.ts
 /** Field-content keys that are not user-defined fields. */
@@ -10,10 +12,29 @@ const RESERVED_KEYS = new Set([
 	"component",
 	"_editable"
 ]);
+/**
+* Relaxed plugin envelope used by the `custom` case. Mirrors the generated
+* `zPluginFieldValue` but relaxes `_uid` from a UUID to a plain string, matching
+* the CMS, which persists arbitrary `_uid` strings. Kept local so a codegen
+* regenerate cannot revert it.
+*/
+const zPluginEnvelope = zod.z.object({
+	plugin: zod.z.string(),
+	_uid: zod.z.optional(zod.z.string())
+});
 /** Maps a Standard Schema validator to a {@link ValidationIssue} reporter at `path`. */
 function checkValue(schema, value, path, entity, issues) {
 	const result = schema["~standard"].validate(value);
-	if (result instanceof Promise) return;
+	if (result instanceof Promise) {
+		issues.push({
+			severity: "error",
+			code: "async_validator_unsupported",
+			path,
+			entity,
+			message: "Field plugin validator is asynchronous; validateStory runs synchronously and cannot await it."
+		});
+		return;
+	}
 	if (result.issues) for (const issue of result.issues) {
 		const issuePath = (issue.path ?? []).map((segment) => typeof segment === "object" && segment !== null ? String(segment.key) : segment);
 		issues.push({
@@ -25,7 +46,7 @@ function checkValue(schema, value, path, entity, issues) {
 		});
 	}
 }
-function validateFieldValue(field, value, blocksByName, path, entity, issues) {
+function validateFieldValue(field, value, blocksByName, fieldPluginsByType, path, entity, issues) {
 	switch (field.type) {
 		case "asset":
 			checkValue(require_zod_gen.zAssetFieldValue, value, path, entity, issues);
@@ -46,11 +67,17 @@ function validateFieldValue(field, value, blocksByName, path, entity, issues) {
 			break;
 		case "richtext":
 			checkValue(require_zod_gen.zRichtextFieldValue, value, path, entity, issues);
-			validateRichtextBloks(value, blocksByName, path, issues);
+			validateRichtextBloks(value, blocksByName, fieldPluginsByType, path, issues);
 			break;
-		case "custom":
-			checkValue(require_zod_gen.zPluginFieldValue, value, path, entity, issues);
+		case "custom": {
+			checkValue(zPluginEnvelope, value, path, entity, issues);
+			const validator = field.field_type ? fieldPluginsByType.get(field.field_type) : void 0;
+			if (validator && require_is_record.isRecord(value)) {
+				const { plugin: _plugin, _uid, ...pluginValue } = value;
+				checkValue(validator, pluginValue, path, entity, issues);
+			}
 			break;
+		}
 		case "bloks":
 			if (!Array.isArray(value)) {
 				pushTypeIssue(value, "array", path, entity, issues);
@@ -69,7 +96,7 @@ function validateFieldValue(field, value, blocksByName, path, entity, issues) {
 					entity,
 					message: `Component "${item.component}" is not allowed in field "${field.name}"; allowed: ${field.allow.join(", ")}.`
 				});
-				validateBlokContent(item, blocksByName, [...path, index], issues);
+				validateBlokContent(item, blocksByName, fieldPluginsByType, [...path, index], issues);
 			});
 			break;
 		case "text":
@@ -165,11 +192,11 @@ function pushTypeIssue(value, expected, path, entity, issues) {
 	});
 }
 /** Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`). */
-function validateRichtextBloks(value, blocksByName, path, issues) {
+function validateRichtextBloks(value, blocksByName, fieldPluginsByType, path, issues) {
 	if (!require_is_record.isRecord(value) || !Array.isArray(value.content)) return;
 	value.content.forEach((node, index) => {
 		if (!require_is_record.isRecord(node)) return;
-		if (node.type === "blok" && require_is_record.isRecord(node.attrs) && Array.isArray(node.attrs.body)) node.attrs.body.forEach((blok, blokIndex) => validateBlokContent(blok, blocksByName, [
+		if (node.type === "blok" && require_is_record.isRecord(node.attrs) && Array.isArray(node.attrs.body)) node.attrs.body.forEach((blok, blokIndex) => validateBlokContent(blok, blocksByName, fieldPluginsByType, [
 			...path,
 			"content",
 			index,
@@ -177,7 +204,7 @@ function validateRichtextBloks(value, blocksByName, path, issues) {
 			"body",
 			blokIndex
 		], issues));
-		else if (Array.isArray(node.content)) validateRichtextBloks(node, blocksByName, [
+		else if (Array.isArray(node.content)) validateRichtextBloks(node, blocksByName, fieldPluginsByType, [
 			...path,
 			"content",
 			index
@@ -185,7 +212,7 @@ function validateRichtextBloks(value, blocksByName, path, issues) {
 	});
 }
 /** Validates a single blok content object against its component definition. */
-function validateBlokContent(content, blocksByName, path, issues) {
+function validateBlokContent(content, blocksByName, fieldPluginsByType, path, issues) {
 	if (!require_is_record.isRecord(content)) {
 		issues.push({
 			severity: "error",
@@ -230,7 +257,7 @@ function validateBlokContent(content, blocksByName, path, issues) {
 			});
 			continue;
 		}
-		validateFieldValue(field, value, blocksByName, [...path, field.name], entity, issues);
+		validateFieldValue(field, value, blocksByName, fieldPluginsByType, [...path, field.name], entity, issues);
 	}
 }
 /**
@@ -245,7 +272,8 @@ function validateBlokContent(content, blocksByName, path, issues) {
 function validateStory(story, schema) {
 	const issues = [];
 	const blocksByName = new Map(require_shapes.toValues(schema.blocks).map((block) => [block.name, block]));
-	validateBlokContent(require_is_record.isRecord(story) ? story.content : void 0, blocksByName, ["content"], issues);
+	const fieldPluginsByType = new Map(require_shapes.toValues(schema.fieldPlugins).map((plugin) => [plugin.fieldType, plugin.value]));
+	validateBlokContent(require_is_record.isRecord(story) ? story.content : void 0, blocksByName, fieldPluginsByType, ["content"], issues);
 	return {
 		ok: issues.every((issue) => issue.severity !== "error"),
 		issues