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

package/dist/index.mjs

@@ -1,17 +1,10 @@
-import { defineMapiStory, defineStory, defineStoryCreate, defineStoryUpdate } from "./helpers/define-story.mjs";
-import { createStoryHelpers } from "./helpers/create-story-helpers.mjs";
-import { defineAssetCreate, defineAssetUpdate, defineMapiAsset } from "./helpers/define-asset.mjs";
-import { defineAssetFolder, defineAssetFolderCreate, defineAssetFolderUpdate } from "./helpers/define-asset-folder.mjs";
-import { defineBlock, defineBlockCreate, defineBlockUpdate } from "./helpers/define-block.mjs";
-import { defineBlockFolder, defineBlockFolderCreate, defineBlockFolderUpdate } from "./helpers/define-block-folder.mjs";
-import { defineDatasource, defineDatasourceCreate, defineDatasourceUpdate } from "./helpers/define-datasource.mjs";
-import { defineDatasourceEntry, defineDatasourceEntryCreate, defineDatasourceEntryUpdate, defineMapiDatasourceEntry } from "./helpers/define-datasource-entry.mjs";
+import { defineBlock } from "./helpers/define-block.mjs";
+import { defineDatasource } from "./helpers/define-datasource.mjs";
 import { defineField } from "./helpers/define-field.mjs";
-import { defineInternalTag, defineInternalTagCreate, defineInternalTagUpdate } from "./helpers/define-internal-tag.mjs";
-import { defineLink } from "./helpers/define-link.mjs";
-import { definePreset, definePresetCreate, definePresetUpdate } from "./helpers/define-preset.mjs";
-import { defineSpace, defineSpaceCreate, defineSpaceUpdate } from "./helpers/define-space.mjs";
-import { defineTag } from "./helpers/define-tag.mjs";
-import { defineUser, defineUserUpdate } from "./helpers/define-user.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 { createStoryHelpers, defineAssetCreate, defineAssetFolder, defineAssetFolderCreate, defineAssetFolderUpdate, defineAssetUpdate, defineBlock, defineBlockCreate, defineBlockFolder, defineBlockFolderCreate, defineBlockFolderUpdate, defineBlockUpdate, defineDatasource, defineDatasourceCreate, defineDatasourceEntry, defineDatasourceEntryCreate, defineDatasourceEntryUpdate, defineDatasourceUpdate, defineField, defineInternalTag, defineInternalTagCreate, defineInternalTagUpdate, defineLink, defineMapiAsset, defineMapiDatasourceEntry, defineMapiStory, definePreset, definePresetCreate, definePresetUpdate, defineSpace, defineSpaceCreate, defineSpaceUpdate, defineStory, defineStoryCreate, defineStoryUpdate, defineTag, defineUser, defineUserUpdate };
+export { createStoryValidator, defineBlock, defineDatasource, defineField, defineFieldPlugin, defineSchema, validateSchema, validateStory };

package/dist/utils/is-record.cjs

@@ -0,0 +1,10 @@
+
+//#region src/utils/is-record.ts
+/** Type guard for a plain object (record). */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+//#endregion
+exports.isRecord = isRecord;
+//# sourceMappingURL=is-record.cjs.map

package/dist/utils/is-record.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.cjs","names":[],"sources":["../../src/utils/is-record.ts"],"sourcesContent":["/** Type guard for a plain object (record). */\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":";;;AACA,SAAgB,SAAS,OAAkD;AACzE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}

package/dist/utils/is-record.mjs

@@ -0,0 +1,9 @@
+//#region src/utils/is-record.ts
+/** Type guard for a plain object (record). */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+//#endregion
+export { isRecord };
+//# sourceMappingURL=is-record.mjs.map

package/dist/utils/is-record.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.mjs","names":[],"sources":["../../src/utils/is-record.ts"],"sourcesContent":["/** Type guard for a plain object (record). */\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":";;AACA,SAAgB,SAAS,OAAkD;AACzE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}

package/dist/validators/create-story-validator.cjs

@@ -0,0 +1,37 @@
+const require_is_record = require('../utils/is-record.cjs');
+const require_validate_story = require('./validate-story.cjs');
+
+//#region src/validators/create-story-validator.ts
+/**
+* Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)
+* validator, so a story for `rootBlock` composes with any Standard Schema
+* tooling (e.g. as a tRPC input or a form resolver). The root content
+* `component` is asserted to match `rootBlock.name`.
+*
+* @example
+* const validator = createStoryValidator(page, schema);
+* const result = validator['~standard'].validate(story);
+*/
+function createStoryValidator(rootBlock, schema) {
+	return { "~standard": {
+		version: 1,
+		vendor: "storyblok-schema",
+		validate(value) {
+			const issues = require_validate_story.validateStory(value, schema).issues.filter((issue) => issue.severity === "error").map((issue) => ({
+				message: issue.message,
+				path: issue.path
+			}));
+			const content = require_is_record.isRecord(value) ? value.content : void 0;
+			const component = require_is_record.isRecord(content) ? content.component : void 0;
+			if (component !== void 0 && component !== rootBlock.name) issues.push({
+				message: `Expected root component "${rootBlock.name}", received "${String(component)}".`,
+				path: ["content", "component"]
+			});
+			return issues.length > 0 ? { issues } : { value };
+		}
+	} };
+}
+
+//#endregion
+exports.createStoryValidator = createStoryValidator;
+//# sourceMappingURL=create-story-validator.cjs.map

package/dist/validators/create-story-validator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-story-validator.cjs","names":["validateStory","isRecord"],"sources":["../../src/validators/create-story-validator.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { SchemaBlockLike, SchemaLike } from './shapes';\nimport { isRecord } from './shapes';\nimport { validateStory } from './validate-story';\n\n/**\n * Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)\n * validator, so a story for `rootBlock` composes with any Standard Schema\n * tooling (e.g. as a tRPC input or a form resolver). The root content\n * `component` is asserted to match `rootBlock.name`.\n *\n * @example\n * const validator = createStoryValidator(page, schema);\n * const result = validator['~standard'].validate(story);\n */\nexport function createStoryValidator(\n  rootBlock: SchemaBlockLike,\n  schema: SchemaLike,\n): StandardSchemaV1<unknown, unknown> {\n  return {\n    '~standard': {\n      version: 1,\n      vendor: 'storyblok-schema',\n      validate(value) {\n        const result = validateStory(value, schema);\n        const issues = result.issues\n          .filter(issue => issue.severity === 'error')\n          .map(issue => ({ message: issue.message, path: issue.path }));\n\n        const content = isRecord(value) ? value.content : undefined;\n        const component = isRecord(content) ? content.component : undefined;\n        if (component !== undefined && component !== rootBlock.name) {\n          issues.push({\n            message: `Expected root component \"${rootBlock.name}\", received \"${String(component)}\".`,\n            path: ['content', 'component'],\n          });\n        }\n\n        return issues.length > 0 ? { issues } : { value };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,qBACd,WACA,QACoC;AACpC,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,SAAS,OAAO;GAEd,MAAM,SADSA,qCAAc,OAAO,OAAO,CACrB,OACnB,QAAO,UAAS,MAAM,aAAa,QAAQ,CAC3C,KAAI,WAAU;IAAE,SAAS,MAAM;IAAS,MAAM,MAAM;IAAM,EAAE;GAE/D,MAAM,UAAUC,2BAAS,MAAM,GAAG,MAAM,UAAU;GAClD,MAAM,YAAYA,2BAAS,QAAQ,GAAG,QAAQ,YAAY;AAC1D,OAAI,cAAc,UAAa,cAAc,UAAU,KACrD,QAAO,KAAK;IACV,SAAS,4BAA4B,UAAU,KAAK,eAAe,OAAO,UAAU,CAAC;IACrF,MAAM,CAAC,WAAW,YAAY;IAC/B,CAAC;AAGJ,UAAO,OAAO,SAAS,IAAI,EAAE,QAAQ,GAAG,EAAE,OAAO;;EAEpD,EACF"}

package/dist/validators/create-story-validator.d.cts

@@ -0,0 +1,18 @@
+import { SchemaBlockLike, SchemaLike } from "./shapes.cjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/validators/create-story-validator.d.ts
+/**
+ * Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)
+ * validator, so a story for `rootBlock` composes with any Standard Schema
+ * tooling (e.g. as a tRPC input or a form resolver). The root content
+ * `component` is asserted to match `rootBlock.name`.
+ *
+ * @example
+ * const validator = createStoryValidator(page, schema);
+ * const result = validator['~standard'].validate(story);
+ */
+declare function createStoryValidator(rootBlock: SchemaBlockLike, schema: SchemaLike): StandardSchemaV1<unknown, unknown>;
+//#endregion
+export { createStoryValidator };
+//# sourceMappingURL=create-story-validator.d.cts.map

package/dist/validators/create-story-validator.d.mts

@@ -0,0 +1,18 @@
+import { SchemaBlockLike, SchemaLike } from "./shapes.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/validators/create-story-validator.d.ts
+/**
+ * Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)
+ * validator, so a story for `rootBlock` composes with any Standard Schema
+ * tooling (e.g. as a tRPC input or a form resolver). The root content
+ * `component` is asserted to match `rootBlock.name`.
+ *
+ * @example
+ * const validator = createStoryValidator(page, schema);
+ * const result = validator['~standard'].validate(story);
+ */
+declare function createStoryValidator(rootBlock: SchemaBlockLike, schema: SchemaLike): StandardSchemaV1<unknown, unknown>;
+//#endregion
+export { createStoryValidator };
+//# sourceMappingURL=create-story-validator.d.mts.map

package/dist/validators/create-story-validator.mjs

@@ -0,0 +1,37 @@
+import { isRecord } from "../utils/is-record.mjs";
+import { validateStory } from "./validate-story.mjs";
+
+//#region src/validators/create-story-validator.ts
+/**
+* Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)
+* validator, so a story for `rootBlock` composes with any Standard Schema
+* tooling (e.g. as a tRPC input or a form resolver). The root content
+* `component` is asserted to match `rootBlock.name`.
+*
+* @example
+* const validator = createStoryValidator(page, schema);
+* const result = validator['~standard'].validate(story);
+*/
+function createStoryValidator(rootBlock, schema) {
+	return { "~standard": {
+		version: 1,
+		vendor: "storyblok-schema",
+		validate(value) {
+			const issues = validateStory(value, schema).issues.filter((issue) => issue.severity === "error").map((issue) => ({
+				message: issue.message,
+				path: issue.path
+			}));
+			const content = isRecord(value) ? value.content : void 0;
+			const component = isRecord(content) ? content.component : void 0;
+			if (component !== void 0 && component !== rootBlock.name) issues.push({
+				message: `Expected root component "${rootBlock.name}", received "${String(component)}".`,
+				path: ["content", "component"]
+			});
+			return issues.length > 0 ? { issues } : { value };
+		}
+	} };
+}
+
+//#endregion
+export { createStoryValidator };
+//# sourceMappingURL=create-story-validator.mjs.map

package/dist/validators/create-story-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-story-validator.mjs","names":[],"sources":["../../src/validators/create-story-validator.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { SchemaBlockLike, SchemaLike } from './shapes';\nimport { isRecord } from './shapes';\nimport { validateStory } from './validate-story';\n\n/**\n * Wraps {@link validateStory} as a [Standard Schema](https://standardschema.dev)\n * validator, so a story for `rootBlock` composes with any Standard Schema\n * tooling (e.g. as a tRPC input or a form resolver). The root content\n * `component` is asserted to match `rootBlock.name`.\n *\n * @example\n * const validator = createStoryValidator(page, schema);\n * const result = validator['~standard'].validate(story);\n */\nexport function createStoryValidator(\n  rootBlock: SchemaBlockLike,\n  schema: SchemaLike,\n): StandardSchemaV1<unknown, unknown> {\n  return {\n    '~standard': {\n      version: 1,\n      vendor: 'storyblok-schema',\n      validate(value) {\n        const result = validateStory(value, schema);\n        const issues = result.issues\n          .filter(issue => issue.severity === 'error')\n          .map(issue => ({ message: issue.message, path: issue.path }));\n\n        const content = isRecord(value) ? value.content : undefined;\n        const component = isRecord(content) ? content.component : undefined;\n        if (component !== undefined && component !== rootBlock.name) {\n          issues.push({\n            message: `Expected root component \"${rootBlock.name}\", received \"${String(component)}\".`,\n            path: ['content', 'component'],\n          });\n        }\n\n        return issues.length > 0 ? { issues } : { value };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,qBACd,WACA,QACoC;AACpC,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,SAAS,OAAO;GAEd,MAAM,SADS,cAAc,OAAO,OAAO,CACrB,OACnB,QAAO,UAAS,MAAM,aAAa,QAAQ,CAC3C,KAAI,WAAU;IAAE,SAAS,MAAM;IAAS,MAAM,MAAM;IAAM,EAAE;GAE/D,MAAM,UAAU,SAAS,MAAM,GAAG,MAAM,UAAU;GAClD,MAAM,YAAY,SAAS,QAAQ,GAAG,QAAQ,YAAY;AAC1D,OAAI,cAAc,UAAa,cAAc,UAAU,KACrD,QAAO,KAAK;IACV,SAAS,4BAA4B,UAAU,KAAK,eAAe,OAAO,UAAU,CAAC;IACrF,MAAM,CAAC,WAAW,YAAY;IAC/B,CAAC;AAGJ,UAAO,OAAO,SAAS,IAAI,EAAE,QAAQ,GAAG,EAAE,OAAO;;EAEpD,EACF"}

package/dist/validators/internal-schemas.cjs

@@ -0,0 +1 @@
+const require_zod_gen = require('../generated/overlay/zod.gen.cjs');

package/dist/validators/internal-schemas.mjs

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

package/dist/validators/shapes.cjs

@@ -0,0 +1,12 @@
+const require_is_record = require('../utils/is-record.cjs');
+
+//#region src/validators/shapes.ts
+/** Normalizes a record-or-array of entities to an array of values. */
+function toValues(input) {
+	if (!input) return [];
+	return Array.isArray(input) ? [...input] : Object.values(input);
+}
+
+//#endregion
+exports.toValues = toValues;
+//# sourceMappingURL=shapes.cjs.map

package/dist/validators/shapes.cjs.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,71 @@
+import { FieldType } from "../generated/types/field.cjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/validators/shapes.d.ts
+/**
+ * Loose structural views of the content-shape definitions, used internally by
+ * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is
+ * structurally assignable to these, but they also tolerate the plain objects a
+ * validator may receive at runtime.
+ */
+/** A single field within a block's `fields` array. */
+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[];
+  /** Normalized datasource slug for option/options fields. */
+  datasource?: string;
+  /** `text`/`textarea`/`markdown`: maximum string length. */
+  max_length?: number;
+  /** `text`/`textarea`: legacy alias for `max_length`. */
+  maxlength?: number;
+  /** `text`/`textarea`: minimum string length. */
+  minlength?: number;
+  /** `number`: inclusive lower bound. */
+  min_value?: number;
+  /** `number`: inclusive upper bound. */
+  max_value?: number;
+  /** `number`: maximum number of fractional digits. */
+  decimals?: number;
+  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */
+  steps?: number;
+  /** `bloks`: minimum number of nested blocks. */
+  minimum?: number;
+  /** `bloks`: maximum number of nested blocks. */
+  maximum?: number;
+  /** `multiasset`: minimum number of assets. */
+  minimum_entries?: number;
+  /** `multiasset`: maximum number of assets. */
+  maximum_entries?: number;
+  /** `options`: minimum number of selected options (stored as a string). */
+  min_options?: string;
+  /** `options`: maximum number of selected options (stored as a string). */
+  max_options?: string;
+}
+/** A block definition (`defineBlock` result). */
+interface SchemaBlockLike {
+  name: string;
+  fields?: readonly SchemaFieldLike[];
+}
+/** A datasource definition (`defineDatasource` result). */
+interface SchemaDatasourceLike {
+  slug?: string;
+}
+/** 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 };
+//# sourceMappingURL=shapes.d.cts.map

package/dist/validators/shapes.d.mts

@@ -0,0 +1,71 @@
+import { FieldType } from "../generated/types/field.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/validators/shapes.d.ts
+/**
+ * Loose structural views of the content-shape definitions, used internally by
+ * the validators. A real `Block` / `Datasource` (from the `define*` helpers) is
+ * structurally assignable to these, but they also tolerate the plain objects a
+ * validator may receive at runtime.
+ */
+/** A single field within a block's `fields` array. */
+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[];
+  /** Normalized datasource slug for option/options fields. */
+  datasource?: string;
+  /** `text`/`textarea`/`markdown`: maximum string length. */
+  max_length?: number;
+  /** `text`/`textarea`: legacy alias for `max_length`. */
+  maxlength?: number;
+  /** `text`/`textarea`: minimum string length. */
+  minlength?: number;
+  /** `number`: inclusive lower bound. */
+  min_value?: number;
+  /** `number`: inclusive upper bound. */
+  max_value?: number;
+  /** `number`: maximum number of fractional digits. */
+  decimals?: number;
+  /** `number`: the value must be a multiple of this step (offset from `min_value`, else 0). */
+  steps?: number;
+  /** `bloks`: minimum number of nested blocks. */
+  minimum?: number;
+  /** `bloks`: maximum number of nested blocks. */
+  maximum?: number;
+  /** `multiasset`: minimum number of assets. */
+  minimum_entries?: number;
+  /** `multiasset`: maximum number of assets. */
+  maximum_entries?: number;
+  /** `options`: minimum number of selected options (stored as a string). */
+  min_options?: string;
+  /** `options`: maximum number of selected options (stored as a string). */
+  max_options?: string;
+}
+/** A block definition (`defineBlock` result). */
+interface SchemaBlockLike {
+  name: string;
+  fields?: readonly SchemaFieldLike[];
+}
+/** A datasource definition (`defineDatasource` result). */
+interface SchemaDatasourceLike {
+  slug?: string;
+}
+/** 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 };
+//# sourceMappingURL=shapes.d.mts.map

package/dist/validators/shapes.mjs

@@ -0,0 +1,12 @@
+import { isRecord } from "../utils/is-record.mjs";
+
+//#region src/validators/shapes.ts
+/** Normalizes a record-or-array of entities to an array of values. */
+function toValues(input) {
+	if (!input) return [];
+	return Array.isArray(input) ? [...input] : Object.values(input);
+}
+
+//#endregion
+export { toValues };
+//# sourceMappingURL=shapes.mjs.map

package/dist/validators/shapes.mjs.map

@@ -0,0 +1 @@
+{"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/types.d.cts

@@ -0,0 +1,25 @@
+//#region src/validators/types.d.ts
+/** Severity of a {@link ValidationIssue}. `error` fails validation; `warning` does not. */
+type ValidationSeverity = 'error' | 'warning';
+/** A single problem found by a validator. */
+interface ValidationIssue {
+  /** `error` fails validation; `warning` is advisory. */
+  severity: ValidationSeverity;
+  /** Stable machine-readable identifier, e.g. `unknown_component`, `invalid_value`. */
+  code: string;
+  /** Location of the problem as a path of keys/indices into the validated input. */
+  path: (string | number)[];
+  /** The entity the issue concerns, e.g. `schema`, `story`, `block:hero`, `datasource:colors`. */
+  entity: string;
+  /** Human-readable description. */
+  message: string;
+}
+/** The non-throwing result returned by {@link validateSchema} and {@link validateStory}. */
+interface ValidationResult {
+  /** `true` when there are no `error`-severity issues (warnings are allowed). */
+  ok: boolean;
+  issues: ValidationIssue[];
+}
+//#endregion
+export { ValidationIssue, ValidationResult, ValidationSeverity };
+//# sourceMappingURL=types.d.cts.map

package/dist/validators/types.d.mts

@@ -0,0 +1,25 @@
+//#region src/validators/types.d.ts
+/** Severity of a {@link ValidationIssue}. `error` fails validation; `warning` does not. */
+type ValidationSeverity = 'error' | 'warning';
+/** A single problem found by a validator. */
+interface ValidationIssue {
+  /** `error` fails validation; `warning` is advisory. */
+  severity: ValidationSeverity;
+  /** Stable machine-readable identifier, e.g. `unknown_component`, `invalid_value`. */
+  code: string;
+  /** Location of the problem as a path of keys/indices into the validated input. */
+  path: (string | number)[];
+  /** The entity the issue concerns, e.g. `schema`, `story`, `block:hero`, `datasource:colors`. */
+  entity: string;
+  /** Human-readable description. */
+  message: string;
+}
+/** The non-throwing result returned by {@link validateSchema} and {@link validateStory}. */
+interface ValidationResult {
+  /** `true` when there are no `error`-severity issues (warnings are allowed). */
+  ok: boolean;
+  issues: ValidationIssue[];
+}
+//#endregion
+export { ValidationIssue, ValidationResult, ValidationSeverity };
+//# sourceMappingURL=types.d.mts.map

package/dist/validators/validate-schema.cjs

@@ -0,0 +1,145 @@
+const require_is_record = require('../utils/is-record.cjs');
+const require_shapes = require('./shapes.cjs');
+
+//#region src/validators/validate-schema.ts
+/**
+* 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; every `custom` field's `field_type`
+* resolves to a registered field plugin).
+*
+* @example
+* const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+* if (!result.ok) console.error(result.issues);
+*/
+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;
+		if (typeof slug !== "string") continue;
+		if (datasourceSlugs.has(slug)) issues.push({
+			severity: "error",
+			code: "duplicate_datasource_slug",
+			path: ["datasources", slug],
+			entity: `datasource:${slug}`,
+			message: `Duplicate datasource slug "${slug}".`
+		});
+		datasourceSlugs.add(slug);
+	}
+	const blockNames = /* @__PURE__ */ new Set();
+	for (const block of blocks) {
+		const name = block?.name;
+		if (typeof name !== "string") continue;
+		if (blockNames.has(name)) issues.push({
+			severity: "error",
+			code: "duplicate_block_name",
+			path: ["blocks", name],
+			entity: `block:${name}`,
+			message: `Duplicate block name "${name}".`
+		});
+		blockNames.add(name);
+	}
+	for (const block of blocks) {
+		const blockName = typeof block?.name === "string" ? block.name : "";
+		const fieldNames = /* @__PURE__ */ new Set();
+		const fields = block?.fields ?? [];
+		for (let index = 0; index < fields.length; index++) {
+			const field = fields[index];
+			if (!require_is_record.isRecord(field)) {
+				issues.push({
+					severity: "error",
+					code: "invalid_field",
+					path: [
+						"blocks",
+						blockName,
+						index
+					],
+					entity: `block:${blockName}`,
+					message: `Field at index ${index} in block "${blockName}" is not an object.`
+				});
+				continue;
+			}
+			const fieldName = field.name;
+			if (typeof fieldName === "string") {
+				if (fieldNames.has(fieldName)) issues.push({
+					severity: "error",
+					code: "duplicate_field_name",
+					path: [
+						"blocks",
+						blockName,
+						fieldName
+					],
+					entity: `block:${blockName}`,
+					message: `Duplicate field name "${fieldName}" in block "${blockName}".`
+				});
+				fieldNames.add(fieldName);
+			} else issues.push({
+				severity: "error",
+				code: "missing_field_name",
+				path: [
+					"blocks",
+					blockName,
+					index
+				],
+				entity: `block:${blockName}`,
+				message: `Field at index ${index} in block "${blockName}" is missing a string "name".`
+			});
+			for (const allowed of field.allow ?? []) if (typeof allowed === "string" && !blockNames.has(allowed)) issues.push({
+				severity: "error",
+				code: "unresolved_allow",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"allow"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" allows unknown block "${allowed}".`
+			});
+			const datasource = field.datasource;
+			if (typeof datasource === "string" && !datasourceSlugs.has(datasource)) issues.push({
+				severity: "error",
+				code: "unresolved_datasource",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"datasource"
+				],
+				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 {
+		ok: issues.every((issue) => issue.severity !== "error"),
+		issues
+	};
+}
+
+//#endregion
+exports.validateSchema = validateSchema;
+//# sourceMappingURL=validate-schema.cjs.map

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

@@ -0,0 +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; 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

@@ -0,0 +1,19 @@
+import { SchemaLike } from "./shapes.cjs";
+import { ValidationResult } from "./types.cjs";
+
+//#region src/validators/validate-schema.d.ts
+/**
+ * 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; every `custom` field's `field_type`
+ * resolves to a registered field plugin).
+ *
+ * @example
+ * const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+ * if (!result.ok) console.error(result.issues);
+ */
+declare function validateSchema(schema: SchemaLike): ValidationResult;
+//#endregion
+export { validateSchema };
+//# sourceMappingURL=validate-schema.d.cts.map