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

package/dist/validators/validate-story.mjs

@@ -2,6 +2,7 @@ import { isRecord } from "../utils/is-record.mjs";
 import { toValues } from "./shapes.mjs";
 import { zAssetFieldValue, zMultilinkFieldValue, zRichtextFieldValue, zTableFieldValue } from "../generated/overlay/zod.gen.mjs";
 import "./internal-schemas.mjs";
+import { slugifyFolderPath } from "../utils/slugify-folder-path.mjs";
 import { z } from "zod";
 
 //#region src/validators/validate-story.ts
@@ -66,7 +67,7 @@ function validateFieldValue(field, value, blocksByName, fieldPluginsByType, path
 			break;
 		case "richtext":
 			checkValue(zRichtextFieldValue, value, path, entity, issues);
-			validateRichtextBloks(value, blocksByName, fieldPluginsByType, path, issues);
+			validateRichtextBloks(value, field, blocksByName, fieldPluginsByType, path, entity, issues);
 			break;
 		case "custom": {
 			checkValue(zPluginEnvelope, value, path, entity, issues);
@@ -84,17 +85,7 @@ function validateFieldValue(field, value, blocksByName, fieldPluginsByType, path
 			}
 			checkCount(value.length, field.minimum, field.maximum, "block(s)", path, entity, issues);
 			value.forEach((item, index) => {
-				if (field.allow && field.allow.length > 0 && isRecord(item) && typeof item.component === "string" && !field.allow.includes(item.component)) issues.push({
-					severity: "error",
-					code: "disallowed_component",
-					path: [
-						...path,
-						index,
-						"component"
-					],
-					entity,
-					message: `Component "${item.component}" is not allowed in field "${field.name}"; allowed: ${field.allow.join(", ")}.`
-				});
+				checkComponentAllowed(field, item, [...path, index], blocksByName, entity, issues);
 				validateBlokContent(item, blocksByName, fieldPluginsByType, [...path, index], issues);
 			});
 			break;
@@ -141,6 +132,42 @@ function validateFieldValue(field, value, blocksByName, fieldPluginsByType, path
 			break;
 	}
 }
+/**
+* Enforces a field's `allow` list for one embedded blok. Shared by the `bloks`
+* case and the richtext walk so both apply the same rule: `mapFieldToWire`
+* pushes folder/name `allow` as an editor/API restriction on *both* field types,
+* so validation must reject the same components the editor and API would.
+*
+* `itemPath` is the path to the blok item (its index); the reported issue points
+* at that item's `component` key. A component is allowed when it is named
+* directly in `allow` or its block sits in (or under) an allowed folder — both
+* sides canonicalized to slug space so a folder referenced two ways (a
+* `defineFolder` ref vs. a string shorthand with different casing/separators)
+* matches the way the CLI/editor group it.
+*/
+function checkComponentAllowed(field, item, itemPath, blocksByName, entity, issues) {
+	const allowEntries = field.allow ?? [];
+	if (allowEntries.length === 0 || !isRecord(item) || typeof item.component !== "string") return;
+	const blockNamesAllowed = allowEntries.filter((entry) => typeof entry === "string");
+	const folderPathsAllowed = allowEntries.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.folder === "string");
+	const itemBlockFolder = blocksByName.get(item.component)?.folder;
+	const allowedByName = blockNamesAllowed.includes(item.component);
+	const itemFolderSlug = typeof itemBlockFolder === "string" ? slugifyFolderPath(itemBlockFolder) : void 0;
+	const allowedByFolder = itemFolderSlug !== void 0 && folderPathsAllowed.some(({ folder }) => {
+		const allowedSlug = slugifyFolderPath(folder);
+		return itemFolderSlug === allowedSlug || itemFolderSlug.startsWith(`${allowedSlug}/`);
+	});
+	if (!allowedByName && !allowedByFolder) {
+		const allowedList = allowEntries.map((entry) => typeof entry === "string" ? entry : `folder:${entry.folder}`).join(", ");
+		issues.push({
+			severity: "error",
+			code: "disallowed_component",
+			path: [...itemPath, "component"],
+			entity,
+			message: `Component "${item.component}" is not allowed in field "${field.name}"; allowed: ${allowedList}.`
+		});
+	}
+}
 /** Reports a constraint (bound/length/count) violation as an error issue. */
 function pushConstraint(message, path, entity, issues) {
 	issues.push({
@@ -190,24 +217,33 @@ function pushTypeIssue(value, expected, path, entity, issues) {
 		message: `Expected ${expected}, received ${value === null ? "null" : typeof value}.`
 	});
 }
-/** Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`). */
-function validateRichtextBloks(value, blocksByName, fieldPluginsByType, path, issues) {
+/**
+* Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`).
+* `field` is the owning richtext field: each embedded blok is checked against its
+* `allow` list ({@link checkComponentAllowed}), matching the group/name
+* restriction `mapFieldToWire` pushes for richtext fields.
+*/
+function validateRichtextBloks(value, field, blocksByName, fieldPluginsByType, path, entity, issues) {
 	if (!isRecord(value) || !Array.isArray(value.content)) return;
 	value.content.forEach((node, index) => {
 		if (!isRecord(node)) return;
-		if (node.type === "blok" && isRecord(node.attrs) && Array.isArray(node.attrs.body)) node.attrs.body.forEach((blok, blokIndex) => validateBlokContent(blok, blocksByName, fieldPluginsByType, [
-			...path,
-			"content",
-			index,
-			"attrs",
-			"body",
-			blokIndex
-		], issues));
-		else if (Array.isArray(node.content)) validateRichtextBloks(node, blocksByName, fieldPluginsByType, [
+		if (node.type === "blok" && isRecord(node.attrs) && Array.isArray(node.attrs.body)) node.attrs.body.forEach((blok, blokIndex) => {
+			const blokPath = [
+				...path,
+				"content",
+				index,
+				"attrs",
+				"body",
+				blokIndex
+			];
+			checkComponentAllowed(field, blok, blokPath, blocksByName, entity, issues);
+			validateBlokContent(blok, blocksByName, fieldPluginsByType, blokPath, issues);
+		});
+		else if (Array.isArray(node.content)) validateRichtextBloks(node, field, blocksByName, fieldPluginsByType, [
 			...path,
 			"content",
 			index
-		], issues);
+		], entity, issues);
 	});
 }
 /** Validates a single blok content object against its component definition. */

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

@@ -1 +1 @@
-{"version":3,"file":"validate-story.mjs","names":[],"sources":["../../src/validators/validate-story.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { SchemaBlockLike, SchemaFieldLike, SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport {\n  zAssetFieldValue,\n  zMultilinkFieldValue,\n  zRichtextFieldValue,\n  zTableFieldValue,\n} from './internal-schemas';\nimport { isRecord, toValues } from './shapes';\n\n/** Field-content keys that are not user-defined fields. */\nconst RESERVED_KEYS = new Set(['_uid', 'component', '_editable']);\n\n/**\n * Relaxed plugin envelope used by the `custom` case. Mirrors the generated\n * `zPluginFieldValue` but relaxes `_uid` from a UUID to a plain string, matching\n * the CMS, which persists arbitrary `_uid` strings. Kept local so a codegen\n * regenerate cannot revert it.\n */\nconst zPluginEnvelope = z.object({ plugin: z.string(), _uid: z.optional(z.string()) });\n\n/** Maps a Standard Schema validator to a {@link ValidationIssue} reporter at `path`. */\nfunction checkValue(\n  schema: StandardSchemaV1,\n  value: unknown,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const result = schema['~standard'].validate(value);\n  // `validateStory` is synchronous. The internal Zod schemas never return a\n  // thenable, but a registered field plugin may ship an async validator — which\n  // cannot be awaited here. Surface it as an error instead of silently passing,\n  // which would report a false `ok: true`.\n  if (result instanceof Promise) {\n    issues.push({\n      severity: 'error',\n      code: 'async_validator_unsupported',\n      path,\n      entity,\n      message: 'Field plugin validator is asynchronous; validateStory runs synchronously and cannot await it.',\n    });\n    return;\n  }\n  if (result.issues) {\n    for (const issue of result.issues) {\n      const issuePath = (issue.path ?? []).map(segment =>\n        (typeof segment === 'object' && segment !== null ? String(segment.key) : (segment as string | number)),\n      );\n      issues.push({\n        severity: 'error',\n        code: 'invalid_value',\n        path: [...path, ...issuePath],\n        entity,\n        message: issue.message,\n      });\n    }\n  }\n}\n\nfunction validateFieldValue(\n  field: SchemaFieldLike,\n  value: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  switch (field.type) {\n    case 'asset':\n      checkValue(zAssetFieldValue, value, path, entity, issues);\n      break;\n    case 'multiasset':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      value.forEach((item, index) => checkValue(zAssetFieldValue, item, [...path, index], entity, issues));\n      checkCount(value.length, field.minimum_entries, field.maximum_entries, 'asset(s)', path, entity, issues);\n      break;\n    case 'multilink':\n      checkValue(zMultilinkFieldValue, value, path, entity, issues);\n      break;\n    case 'table':\n      checkValue(zTableFieldValue, value, path, entity, issues);\n      break;\n    case 'richtext':\n      checkValue(zRichtextFieldValue, value, path, entity, issues);\n      validateRichtextBloks(value, blocksByName, fieldPluginsByType, path, issues);\n      break;\n    case 'custom': {\n      checkValue(zPluginEnvelope, value, path, entity, issues);\n      const validator = field.field_type ? fieldPluginsByType.get(field.field_type) : undefined;\n      if (validator && isRecord(value)) {\n        // Envelope keys sit alongside the plugin's own keys; strip them so the\n        // plugin validator sees only its value. Sibling keys keep issue paths\n        // accurate (an issue at ['color'] maps to [...path, 'color']).\n        const { plugin: _plugin, _uid, ...pluginValue } = value;\n        checkValue(validator, pluginValue, path, entity, issues);\n      }\n      break;\n    }\n    case 'bloks':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, field.minimum, field.maximum, 'block(s)', path, entity, issues);\n      value.forEach((item, index) => {\n        if (\n          field.allow && field.allow.length > 0\n          && isRecord(item) && typeof item.component === 'string'\n          && !field.allow.includes(item.component)\n        ) {\n          issues.push({\n            severity: 'error',\n            code: 'disallowed_component',\n            path: [...path, index, 'component'],\n            entity,\n            message: `Component \"${item.component}\" is not allowed in field \"${field.name}\"; allowed: ${field.allow.join(', ')}.`,\n          });\n        }\n        validateBlokContent(item, blocksByName, fieldPluginsByType, [...path, index], issues);\n      });\n      break;\n    case 'text':\n    case 'textarea':\n    case 'markdown':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n        break;\n      }\n      checkStringLength(field, value, path, entity, issues);\n      break;\n    case 'option':\n    case 'datetime':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n      }\n      break;\n    case 'number':\n      if (typeof value !== 'number') {\n        pushTypeIssue(value, 'number', path, entity, issues);\n        break;\n      }\n      if (field.min_value != null && value < field.min_value) {\n        pushConstraint(`Value ${value} is below the minimum of ${field.min_value}.`, path, entity, issues);\n      }\n      if (field.max_value != null && value > field.max_value) {\n        pushConstraint(`Value ${value} exceeds the maximum of ${field.max_value}.`, path, entity, issues);\n      }\n      if (field.decimals != null && decimalPlaces(value) > field.decimals) {\n        pushConstraint(`Value ${value} has more than ${field.decimals} decimal place(s).`, path, entity, issues);\n      }\n      if (field.steps != null && field.steps > 0 && !isMultipleOf(value, field.steps, field.min_value ?? 0)) {\n        const base = field.min_value ?? 0;\n        pushConstraint(\n          `Value ${value} is not a multiple of the step ${field.steps}${base ? ` (offset from ${base})` : ''}.`,\n          path,\n          entity,\n          issues,\n        );\n      }\n      break;\n    case 'boolean':\n      if (typeof value !== 'boolean') {\n        pushTypeIssue(value, 'boolean', path, entity, issues);\n      }\n      break;\n    case 'options':\n      if (!Array.isArray(value) || value.some(item => typeof item !== 'string')) {\n        pushTypeIssue(value, 'string[]', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, toCount(field.min_options), toCount(field.max_options), 'option(s)', path, entity, issues);\n      break;\n    case 'section':\n    case 'tab':\n      // Layout-only field types carry no content value.\n      break;\n    default:\n      // Exhaustiveness guard: when a new `FieldType` is added, this fails to\n      // compile until the field type is handled (or explicitly skipped) above.\n      field.type satisfies never;\n      break;\n  }\n}\n\n/** Reports a constraint (bound/length/count) violation as an error issue. */\nfunction pushConstraint(\n  message: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({ severity: 'error', code: 'constraint_violation', path, entity, message });\n}\n\n/** Checks an array length against optional inclusive `min`/`max` bounds. */\nfunction checkCount(\n  length: number,\n  min: number | undefined,\n  max: number | undefined,\n  noun: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  if (min != null && length < min) {\n    pushConstraint(`Expected at least ${min} ${noun}, received ${length}.`, path, entity, issues);\n  }\n  if (max != null && length > max) {\n    pushConstraint(`Expected at most ${max} ${noun}, received ${length}.`, path, entity, issues);\n  }\n}\n\n/** Checks a string against optional `max_length`/`maxlength` and `minlength` bounds. */\nfunction checkStringLength(\n  field: SchemaFieldLike,\n  value: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const max = field.max_length ?? field.maxlength;\n  if (max != null && value.length > max) {\n    pushConstraint(`Text length ${value.length} exceeds the maximum of ${max}.`, path, entity, issues);\n  }\n  if (field.minlength != null && value.length < field.minlength) {\n    pushConstraint(`Text length ${value.length} is below the minimum of ${field.minlength}.`, path, entity, issues);\n  }\n}\n\n/** Counts a number's fractional digits, handling exponential notation (e.g. `1e-7` → 7). */\nfunction decimalPlaces(value: number): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n  const text = String(value).toLowerCase();\n  const [mantissa, exponent] = text.split('e');\n  const fractionDigits = mantissa.includes('.') ? mantissa.split('.')[1].length : 0;\n  // A negative exponent (e.g. `1e-7`) adds that many fractional digits.\n  return exponent ? Math.max(0, fractionDigits - Number(exponent)) : fractionDigits;\n}\n\n/** Whether `value` lands on a `step` increment offset from `base`, with float tolerance. */\nfunction isMultipleOf(value: number, step: number, base: number): boolean {\n  const ratio = (value - base) / step;\n  const tolerance = 1e-9 * Math.max(1, Math.abs(ratio));\n  return Math.abs(ratio - Math.round(ratio)) <= tolerance;\n}\n\n/** Parses a numeric constraint stored as a string (e.g. `min_options`). Empty/non-numeric → undefined. */\nfunction toCount(value: string | undefined): number | undefined {\n  if (value == null || value === '') {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction pushTypeIssue(\n  value: unknown,\n  expected: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({\n    severity: 'error',\n    code: 'invalid_value',\n    path,\n    entity,\n    message: `Expected ${expected}, received ${value === null ? 'null' : typeof value}.`,\n  });\n}\n\n/** Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`). */\nfunction validateRichtextBloks(\n  value: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(value) || !Array.isArray(value.content)) {\n    return;\n  }\n  value.content.forEach((node, index) => {\n    if (!isRecord(node)) {\n      return;\n    }\n    if (node.type === 'blok' && isRecord(node.attrs) && Array.isArray(node.attrs.body)) {\n      node.attrs.body.forEach((blok, blokIndex) =>\n        validateBlokContent(blok, blocksByName, fieldPluginsByType, [...path, 'content', index, 'attrs', 'body', blokIndex], issues),\n      );\n    }\n    else if (Array.isArray(node.content)) {\n      // Recurse into nested marks/nodes that may themselves embed bloks.\n      validateRichtextBloks(node, blocksByName, fieldPluginsByType, [...path, 'content', index], issues);\n    }\n  });\n}\n\n/** Validates a single blok content object against its component definition. */\nfunction validateBlokContent(\n  content: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(content)) {\n    issues.push({\n      severity: 'error',\n      code: 'invalid_content',\n      path,\n      entity: 'story',\n      message: 'Expected a block content object.',\n    });\n    return;\n  }\n\n  const component = content.component;\n  const block = typeof component === 'string' ? blocksByName.get(component) : undefined;\n  if (!block) {\n    issues.push({\n      severity: 'error',\n      code: 'unknown_component',\n      path: [...path, 'component'],\n      entity: 'story',\n      message: `Unknown component \"${String(component)}\".`,\n    });\n    return;\n  }\n\n  const entity = `block:${block.name}`;\n  const fields = block.fields ?? [];\n  const fieldsByName = new Map(fields.map(field => [field.name, field]));\n\n  for (const key of Object.keys(content)) {\n    if (!RESERVED_KEYS.has(key) && !fieldsByName.has(key)) {\n      issues.push({\n        severity: 'warning',\n        code: 'unknown_field',\n        path: [...path, key],\n        entity,\n        message: `Unknown field \"${key}\" on component \"${block.name}\".`,\n      });\n    }\n  }\n\n  for (const field of fields) {\n    const value = content[field.name];\n    if (value === undefined || value === null) {\n      if (field.required) {\n        issues.push({\n          severity: 'error',\n          code: 'missing_required_field',\n          path: [...path, field.name],\n          entity,\n          message: `Missing required field \"${field.name}\" on component \"${block.name}\".`,\n        });\n      }\n      continue;\n    }\n    validateFieldValue(field, value, blocksByName, fieldPluginsByType, [...path, field.name], entity, issues);\n  }\n}\n\n/**\n * Validates a story's content against a schema without throwing. Reports unknown\n * components (error), unknown fields (warning), missing required fields (error),\n * and invalid field-value shapes (error), recursing into nested `bloks` and\n * richtext-embedded bloks.\n *\n * @example\n * const result = validateStory(story, { blocks: { page, hero } });\n */\nexport function validateStory(story: unknown, schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocksByName = new Map(toValues(schema.blocks).map(block => [block.name, block]));\n  const fieldPluginsByType = new Map(\n    toValues(schema.fieldPlugins).map(plugin => [plugin.fieldType, plugin.value]),\n  );\n  const content = isRecord(story) ? story.content : undefined;\n  validateBlokContent(content, blocksByName, fieldPluginsByType, ['content'], issues);\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":"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"}
+{"version":3,"file":"validate-story.mjs","names":[],"sources":["../../src/validators/validate-story.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { SchemaBlockLike, SchemaFieldLike, SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport {\n  zAssetFieldValue,\n  zMultilinkFieldValue,\n  zRichtextFieldValue,\n  zTableFieldValue,\n} from './internal-schemas';\nimport { isRecord, toValues } from './shapes';\nimport { slugifyFolderPath } from '../utils/slugify-folder-path';\n\n/** Field-content keys that are not user-defined fields. */\nconst RESERVED_KEYS = new Set(['_uid', 'component', '_editable']);\n\n/**\n * Relaxed plugin envelope used by the `custom` case. Mirrors the generated\n * `zPluginFieldValue` but relaxes `_uid` from a UUID to a plain string, matching\n * the CMS, which persists arbitrary `_uid` strings. Kept local so a codegen\n * regenerate cannot revert it.\n */\nconst zPluginEnvelope = z.object({ plugin: z.string(), _uid: z.optional(z.string()) });\n\n/** Maps a Standard Schema validator to a {@link ValidationIssue} reporter at `path`. */\nfunction checkValue(\n  schema: StandardSchemaV1,\n  value: unknown,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const result = schema['~standard'].validate(value);\n  // `validateStory` is synchronous. The internal Zod schemas never return a\n  // thenable, but a registered field plugin may ship an async validator — which\n  // cannot be awaited here. Surface it as an error instead of silently passing,\n  // which would report a false `ok: true`.\n  if (result instanceof Promise) {\n    issues.push({\n      severity: 'error',\n      code: 'async_validator_unsupported',\n      path,\n      entity,\n      message: 'Field plugin validator is asynchronous; validateStory runs synchronously and cannot await it.',\n    });\n    return;\n  }\n  if (result.issues) {\n    for (const issue of result.issues) {\n      const issuePath = (issue.path ?? []).map(segment =>\n        (typeof segment === 'object' && segment !== null ? String(segment.key) : (segment as string | number)),\n      );\n      issues.push({\n        severity: 'error',\n        code: 'invalid_value',\n        path: [...path, ...issuePath],\n        entity,\n        message: issue.message,\n      });\n    }\n  }\n}\n\nfunction validateFieldValue(\n  field: SchemaFieldLike,\n  value: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  switch (field.type) {\n    case 'asset':\n      checkValue(zAssetFieldValue, value, path, entity, issues);\n      break;\n    case 'multiasset':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      value.forEach((item, index) => checkValue(zAssetFieldValue, item, [...path, index], entity, issues));\n      checkCount(value.length, field.minimum_entries, field.maximum_entries, 'asset(s)', path, entity, issues);\n      break;\n    case 'multilink':\n      checkValue(zMultilinkFieldValue, value, path, entity, issues);\n      break;\n    case 'table':\n      checkValue(zTableFieldValue, value, path, entity, issues);\n      break;\n    case 'richtext':\n      checkValue(zRichtextFieldValue, value, path, entity, issues);\n      validateRichtextBloks(value, field, blocksByName, fieldPluginsByType, path, entity, issues);\n      break;\n    case 'custom': {\n      checkValue(zPluginEnvelope, value, path, entity, issues);\n      const validator = field.field_type ? fieldPluginsByType.get(field.field_type) : undefined;\n      if (validator && isRecord(value)) {\n        // Envelope keys sit alongside the plugin's own keys; strip them so the\n        // plugin validator sees only its value. Sibling keys keep issue paths\n        // accurate (an issue at ['color'] maps to [...path, 'color']).\n        const { plugin: _plugin, _uid, ...pluginValue } = value;\n        checkValue(validator, pluginValue, path, entity, issues);\n      }\n      break;\n    }\n    case 'bloks':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, field.minimum, field.maximum, 'block(s)', path, entity, issues);\n      value.forEach((item, index) => {\n        checkComponentAllowed(field, item, [...path, index], blocksByName, entity, issues);\n        validateBlokContent(item, blocksByName, fieldPluginsByType, [...path, index], issues);\n      });\n      break;\n    case 'text':\n    case 'textarea':\n    case 'markdown':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n        break;\n      }\n      checkStringLength(field, value, path, entity, issues);\n      break;\n    case 'option':\n    case 'datetime':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n      }\n      break;\n    case 'number':\n      if (typeof value !== 'number') {\n        pushTypeIssue(value, 'number', path, entity, issues);\n        break;\n      }\n      if (field.min_value != null && value < field.min_value) {\n        pushConstraint(`Value ${value} is below the minimum of ${field.min_value}.`, path, entity, issues);\n      }\n      if (field.max_value != null && value > field.max_value) {\n        pushConstraint(`Value ${value} exceeds the maximum of ${field.max_value}.`, path, entity, issues);\n      }\n      if (field.decimals != null && decimalPlaces(value) > field.decimals) {\n        pushConstraint(`Value ${value} has more than ${field.decimals} decimal place(s).`, path, entity, issues);\n      }\n      if (field.steps != null && field.steps > 0 && !isMultipleOf(value, field.steps, field.min_value ?? 0)) {\n        const base = field.min_value ?? 0;\n        pushConstraint(\n          `Value ${value} is not a multiple of the step ${field.steps}${base ? ` (offset from ${base})` : ''}.`,\n          path,\n          entity,\n          issues,\n        );\n      }\n      break;\n    case 'boolean':\n      if (typeof value !== 'boolean') {\n        pushTypeIssue(value, 'boolean', path, entity, issues);\n      }\n      break;\n    case 'options':\n      if (!Array.isArray(value) || value.some(item => typeof item !== 'string')) {\n        pushTypeIssue(value, 'string[]', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, toCount(field.min_options), toCount(field.max_options), 'option(s)', path, entity, issues);\n      break;\n    case 'section':\n    case 'tab':\n      // Layout-only field types carry no content value.\n      break;\n    default:\n      // Exhaustiveness guard: when a new `FieldType` is added, this fails to\n      // compile until the field type is handled (or explicitly skipped) above.\n      field.type satisfies never;\n      break;\n  }\n}\n\n/**\n * Enforces a field's `allow` list for one embedded blok. Shared by the `bloks`\n * case and the richtext walk so both apply the same rule: `mapFieldToWire`\n * pushes folder/name `allow` as an editor/API restriction on *both* field types,\n * so validation must reject the same components the editor and API would.\n *\n * `itemPath` is the path to the blok item (its index); the reported issue points\n * at that item's `component` key. A component is allowed when it is named\n * directly in `allow` or its block sits in (or under) an allowed folder — both\n * sides canonicalized to slug space so a folder referenced two ways (a\n * `defineFolder` ref vs. a string shorthand with different casing/separators)\n * matches the way the CLI/editor group it.\n */\nfunction checkComponentAllowed(\n  field: SchemaFieldLike,\n  item: unknown,\n  itemPath: (string | number)[],\n  blocksByName: Map<string, SchemaBlockLike>,\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const allowEntries = field.allow ?? [];\n  if (allowEntries.length === 0 || !isRecord(item) || typeof item.component !== 'string') {\n    return;\n  }\n  const blockNamesAllowed = allowEntries.filter((entry): entry is string => typeof entry === 'string');\n  const folderPathsAllowed = allowEntries.filter(\n    (entry): entry is { folder: string } =>\n      typeof entry === 'object' && entry !== null && typeof entry.folder === 'string',\n  );\n  const itemBlock = blocksByName.get(item.component);\n  const itemBlockFolder = itemBlock?.folder;\n  const allowedByName = blockNamesAllowed.includes(item.component);\n  const itemFolderSlug = typeof itemBlockFolder === 'string' ? slugifyFolderPath(itemBlockFolder) : undefined;\n  const allowedByFolder = itemFolderSlug !== undefined\n    && folderPathsAllowed.some(({ folder }) => {\n      const allowedSlug = slugifyFolderPath(folder);\n      return itemFolderSlug === allowedSlug || itemFolderSlug.startsWith(`${allowedSlug}/`);\n    });\n  if (!allowedByName && !allowedByFolder) {\n    const allowedList = allowEntries\n      .map(entry => (typeof entry === 'string' ? entry : `folder:${entry.folder}`))\n      .join(', ');\n    issues.push({\n      severity: 'error',\n      code: 'disallowed_component',\n      path: [...itemPath, 'component'],\n      entity,\n      message: `Component \"${item.component}\" is not allowed in field \"${field.name}\"; allowed: ${allowedList}.`,\n    });\n  }\n}\n\n/** Reports a constraint (bound/length/count) violation as an error issue. */\nfunction pushConstraint(\n  message: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({ severity: 'error', code: 'constraint_violation', path, entity, message });\n}\n\n/** Checks an array length against optional inclusive `min`/`max` bounds. */\nfunction checkCount(\n  length: number,\n  min: number | undefined,\n  max: number | undefined,\n  noun: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  if (min != null && length < min) {\n    pushConstraint(`Expected at least ${min} ${noun}, received ${length}.`, path, entity, issues);\n  }\n  if (max != null && length > max) {\n    pushConstraint(`Expected at most ${max} ${noun}, received ${length}.`, path, entity, issues);\n  }\n}\n\n/** Checks a string against optional `max_length`/`maxlength` and `minlength` bounds. */\nfunction checkStringLength(\n  field: SchemaFieldLike,\n  value: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const max = field.max_length ?? field.maxlength;\n  if (max != null && value.length > max) {\n    pushConstraint(`Text length ${value.length} exceeds the maximum of ${max}.`, path, entity, issues);\n  }\n  if (field.minlength != null && value.length < field.minlength) {\n    pushConstraint(`Text length ${value.length} is below the minimum of ${field.minlength}.`, path, entity, issues);\n  }\n}\n\n/** Counts a number's fractional digits, handling exponential notation (e.g. `1e-7` → 7). */\nfunction decimalPlaces(value: number): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n  const text = String(value).toLowerCase();\n  const [mantissa, exponent] = text.split('e');\n  const fractionDigits = mantissa.includes('.') ? mantissa.split('.')[1].length : 0;\n  // A negative exponent (e.g. `1e-7`) adds that many fractional digits.\n  return exponent ? Math.max(0, fractionDigits - Number(exponent)) : fractionDigits;\n}\n\n/** Whether `value` lands on a `step` increment offset from `base`, with float tolerance. */\nfunction isMultipleOf(value: number, step: number, base: number): boolean {\n  const ratio = (value - base) / step;\n  const tolerance = 1e-9 * Math.max(1, Math.abs(ratio));\n  return Math.abs(ratio - Math.round(ratio)) <= tolerance;\n}\n\n/** Parses a numeric constraint stored as a string (e.g. `min_options`). Empty/non-numeric → undefined. */\nfunction toCount(value: string | undefined): number | undefined {\n  if (value == null || value === '') {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction pushTypeIssue(\n  value: unknown,\n  expected: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({\n    severity: 'error',\n    code: 'invalid_value',\n    path,\n    entity,\n    message: `Expected ${expected}, received ${value === null ? 'null' : typeof value}.`,\n  });\n}\n\n/**\n * Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`).\n * `field` is the owning richtext field: each embedded blok is checked against its\n * `allow` list ({@link checkComponentAllowed}), matching the group/name\n * restriction `mapFieldToWire` pushes for richtext fields.\n */\nfunction validateRichtextBloks(\n  value: unknown,\n  field: SchemaFieldLike,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(value) || !Array.isArray(value.content)) {\n    return;\n  }\n  value.content.forEach((node, index) => {\n    if (!isRecord(node)) {\n      return;\n    }\n    if (node.type === 'blok' && isRecord(node.attrs) && Array.isArray(node.attrs.body)) {\n      node.attrs.body.forEach((blok, blokIndex) => {\n        const blokPath = [...path, 'content', index, 'attrs', 'body', blokIndex];\n        checkComponentAllowed(field, blok, blokPath, blocksByName, entity, issues);\n        validateBlokContent(blok, blocksByName, fieldPluginsByType, blokPath, issues);\n      });\n    }\n    else if (Array.isArray(node.content)) {\n      // Recurse into nested marks/nodes that may themselves embed bloks.\n      validateRichtextBloks(node, field, blocksByName, fieldPluginsByType, [...path, 'content', index], entity, issues);\n    }\n  });\n}\n\n/** Validates a single blok content object against its component definition. */\nfunction validateBlokContent(\n  content: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  fieldPluginsByType: Map<string, StandardSchemaV1>,\n  path: (string | number)[],\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(content)) {\n    issues.push({\n      severity: 'error',\n      code: 'invalid_content',\n      path,\n      entity: 'story',\n      message: 'Expected a block content object.',\n    });\n    return;\n  }\n\n  const component = content.component;\n  const block = typeof component === 'string' ? blocksByName.get(component) : undefined;\n  if (!block) {\n    issues.push({\n      severity: 'error',\n      code: 'unknown_component',\n      path: [...path, 'component'],\n      entity: 'story',\n      message: `Unknown component \"${String(component)}\".`,\n    });\n    return;\n  }\n\n  const entity = `block:${block.name}`;\n  const fields = block.fields ?? [];\n  const fieldsByName = new Map(fields.map(field => [field.name, field]));\n\n  for (const key of Object.keys(content)) {\n    if (!RESERVED_KEYS.has(key) && !fieldsByName.has(key)) {\n      issues.push({\n        severity: 'warning',\n        code: 'unknown_field',\n        path: [...path, key],\n        entity,\n        message: `Unknown field \"${key}\" on component \"${block.name}\".`,\n      });\n    }\n  }\n\n  for (const field of fields) {\n    const value = content[field.name];\n    if (value === undefined || value === null) {\n      if (field.required) {\n        issues.push({\n          severity: 'error',\n          code: 'missing_required_field',\n          path: [...path, field.name],\n          entity,\n          message: `Missing required field \"${field.name}\" on component \"${block.name}\".`,\n        });\n      }\n      continue;\n    }\n    validateFieldValue(field, value, blocksByName, fieldPluginsByType, [...path, field.name], entity, issues);\n  }\n}\n\n/**\n * Validates a story's content against a schema without throwing. Reports unknown\n * components (error), unknown fields (warning), missing required fields (error),\n * and invalid field-value shapes (error), recursing into nested `bloks` and\n * richtext-embedded bloks.\n *\n * @example\n * const result = validateStory(story, { blocks: { page, hero } });\n */\nexport function validateStory(story: unknown, schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocksByName = new Map(toValues(schema.blocks).map(block => [block.name, block]));\n  const fieldPluginsByType = new Map(\n    toValues(schema.fieldPlugins).map(plugin => [plugin.fieldType, plugin.value]),\n  );\n  const content = isRecord(story) ? story.content : undefined;\n  validateBlokContent(content, blocksByName, fieldPluginsByType, ['content'], issues);\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":";;;;;;;;;AAcA,MAAM,gBAAgB,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAY,CAAC;;;;;;;AAQjE,MAAM,kBAAkB,EAAE,OAAO;CAAE,QAAQ,EAAE,QAAQ;CAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;CAAE,CAAC;;AAGtF,SAAS,WACP,QACA,OACA,MACA,QACA,QACM;CACN,MAAM,SAAS,OAAO,aAAa,SAAS,MAAM;AAKlD,KAAI,kBAAkB,SAAS;AAC7B,SAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN;GACA;GACA,SAAS;GACV,CAAC;AACF;;AAEF,KAAI,OAAO,OACT,MAAK,MAAM,SAAS,OAAO,QAAQ;EACjC,MAAM,aAAa,MAAM,QAAQ,EAAE,EAAE,KAAI,YACtC,OAAO,YAAY,YAAY,YAAY,OAAO,OAAO,QAAQ,IAAI,GAAI,QAC3E;AACD,SAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,GAAG,MAAM,GAAG,UAAU;GAC7B;GACA,SAAS,MAAM;GAChB,CAAC;;;AAKR,SAAS,mBACP,OACA,OACA,cACA,oBACA,MACA,QACA,QACM;AACN,SAAQ,MAAM,MAAd;EACE,KAAK;AACH,cAAW,kBAAkB,OAAO,MAAM,QAAQ,OAAO;AACzD;EACF,KAAK;AACH,OAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,kBAAc,OAAO,SAAS,MAAM,QAAQ,OAAO;AACnD;;AAEF,SAAM,SAAS,MAAM,UAAU,WAAW,kBAAkB,MAAM,CAAC,GAAG,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC;AACpG,cAAW,MAAM,QAAQ,MAAM,iBAAiB,MAAM,iBAAiB,YAAY,MAAM,QAAQ,OAAO;AACxG;EACF,KAAK;AACH,cAAW,sBAAsB,OAAO,MAAM,QAAQ,OAAO;AAC7D;EACF,KAAK;AACH,cAAW,kBAAkB,OAAO,MAAM,QAAQ,OAAO;AACzD;EACF,KAAK;AACH,cAAW,qBAAqB,OAAO,MAAM,QAAQ,OAAO;AAC5D,yBAAsB,OAAO,OAAO,cAAc,oBAAoB,MAAM,QAAQ,OAAO;AAC3F;EACF,KAAK,UAAU;AACb,cAAW,iBAAiB,OAAO,MAAM,QAAQ,OAAO;GACxD,MAAM,YAAY,MAAM,aAAa,mBAAmB,IAAI,MAAM,WAAW,GAAG;AAChF,OAAI,aAAa,SAAS,MAAM,EAAE;IAIhC,MAAM,EAAE,QAAQ,SAAS,MAAM,GAAG,gBAAgB;AAClD,eAAW,WAAW,aAAa,MAAM,QAAQ,OAAO;;AAE1D;;EAEF,KAAK;AACH,OAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,kBAAc,OAAO,SAAS,MAAM,QAAQ,OAAO;AACnD;;AAEF,cAAW,MAAM,QAAQ,MAAM,SAAS,MAAM,SAAS,YAAY,MAAM,QAAQ,OAAO;AACxF,SAAM,SAAS,MAAM,UAAU;AAC7B,0BAAsB,OAAO,MAAM,CAAC,GAAG,MAAM,MAAM,EAAE,cAAc,QAAQ,OAAO;AAClF,wBAAoB,MAAM,cAAc,oBAAoB,CAAC,GAAG,MAAM,MAAM,EAAE,OAAO;KACrF;AACF;EACF,KAAK;EACL,KAAK;EACL,KAAK;AACH,OAAI,OAAO,UAAU,UAAU;AAC7B,kBAAc,OAAO,UAAU,MAAM,QAAQ,OAAO;AACpD;;AAEF,qBAAkB,OAAO,OAAO,MAAM,QAAQ,OAAO;AACrD;EACF,KAAK;EACL,KAAK;AACH,OAAI,OAAO,UAAU,SACnB,eAAc,OAAO,UAAU,MAAM,QAAQ,OAAO;AAEtD;EACF,KAAK;AACH,OAAI,OAAO,UAAU,UAAU;AAC7B,kBAAc,OAAO,UAAU,MAAM,QAAQ,OAAO;AACpD;;AAEF,OAAI,MAAM,aAAa,QAAQ,QAAQ,MAAM,UAC3C,gBAAe,SAAS,MAAM,2BAA2B,MAAM,UAAU,IAAI,MAAM,QAAQ,OAAO;AAEpG,OAAI,MAAM,aAAa,QAAQ,QAAQ,MAAM,UAC3C,gBAAe,SAAS,MAAM,0BAA0B,MAAM,UAAU,IAAI,MAAM,QAAQ,OAAO;AAEnG,OAAI,MAAM,YAAY,QAAQ,cAAc,MAAM,GAAG,MAAM,SACzD,gBAAe,SAAS,MAAM,iBAAiB,MAAM,SAAS,qBAAqB,MAAM,QAAQ,OAAO;AAE1G,OAAI,MAAM,SAAS,QAAQ,MAAM,QAAQ,KAAK,CAAC,aAAa,OAAO,MAAM,OAAO,MAAM,aAAa,EAAE,EAAE;IACrG,MAAM,OAAO,MAAM,aAAa;AAChC,mBACE,SAAS,MAAM,iCAAiC,MAAM,QAAQ,OAAO,iBAAiB,KAAK,KAAK,GAAG,IACnG,MACA,QACA,OACD;;AAEH;EACF,KAAK;AACH,OAAI,OAAO,UAAU,UACnB,eAAc,OAAO,WAAW,MAAM,QAAQ,OAAO;AAEvD;EACF,KAAK;AACH,OAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,MAAK,SAAQ,OAAO,SAAS,SAAS,EAAE;AACzE,kBAAc,OAAO,YAAY,MAAM,QAAQ,OAAO;AACtD;;AAEF,cAAW,MAAM,QAAQ,QAAQ,MAAM,YAAY,EAAE,QAAQ,MAAM,YAAY,EAAE,aAAa,MAAM,QAAQ,OAAO;AACnH;EACF,KAAK;EACL,KAAK,MAEH;EACF;AAGE,SAAM;AACN;;;;;;;;;;;;;;;;AAiBN,SAAS,sBACP,OACA,MACA,UACA,cACA,QACA,QACM;CACN,MAAM,eAAe,MAAM,SAAS,EAAE;AACtC,KAAI,aAAa,WAAW,KAAK,CAAC,SAAS,KAAK,IAAI,OAAO,KAAK,cAAc,SAC5E;CAEF,MAAM,oBAAoB,aAAa,QAAQ,UAA2B,OAAO,UAAU,SAAS;CACpG,MAAM,qBAAqB,aAAa,QACrC,UACC,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAO,MAAM,WAAW,SAC1E;CAED,MAAM,kBADY,aAAa,IAAI,KAAK,UAAU,EACf;CACnC,MAAM,gBAAgB,kBAAkB,SAAS,KAAK,UAAU;CAChE,MAAM,iBAAiB,OAAO,oBAAoB,WAAW,kBAAkB,gBAAgB,GAAG;CAClG,MAAM,kBAAkB,mBAAmB,UACtC,mBAAmB,MAAM,EAAE,aAAa;EACzC,MAAM,cAAc,kBAAkB,OAAO;AAC7C,SAAO,mBAAmB,eAAe,eAAe,WAAW,GAAG,YAAY,GAAG;GACrF;AACJ,KAAI,CAAC,iBAAiB,CAAC,iBAAiB;EACtC,MAAM,cAAc,aACjB,KAAI,UAAU,OAAO,UAAU,WAAW,QAAQ,UAAU,MAAM,SAAU,CAC5E,KAAK,KAAK;AACb,SAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,GAAG,UAAU,YAAY;GAChC;GACA,SAAS,cAAc,KAAK,UAAU,6BAA6B,MAAM,KAAK,cAAc,YAAY;GACzG,CAAC;;;;AAKN,SAAS,eACP,SACA,MACA,QACA,QACM;AACN,QAAO,KAAK;EAAE,UAAU;EAAS,MAAM;EAAwB;EAAM;EAAQ;EAAS,CAAC;;;AAIzF,SAAS,WACP,QACA,KACA,KACA,MACA,MACA,QACA,QACM;AACN,KAAI,OAAO,QAAQ,SAAS,IAC1B,gBAAe,qBAAqB,IAAI,GAAG,KAAK,aAAa,OAAO,IAAI,MAAM,QAAQ,OAAO;AAE/F,KAAI,OAAO,QAAQ,SAAS,IAC1B,gBAAe,oBAAoB,IAAI,GAAG,KAAK,aAAa,OAAO,IAAI,MAAM,QAAQ,OAAO;;;AAKhG,SAAS,kBACP,OACA,OACA,MACA,QACA,QACM;CACN,MAAM,MAAM,MAAM,cAAc,MAAM;AACtC,KAAI,OAAO,QAAQ,MAAM,SAAS,IAChC,gBAAe,eAAe,MAAM,OAAO,0BAA0B,IAAI,IAAI,MAAM,QAAQ,OAAO;AAEpG,KAAI,MAAM,aAAa,QAAQ,MAAM,SAAS,MAAM,UAClD,gBAAe,eAAe,MAAM,OAAO,2BAA2B,MAAM,UAAU,IAAI,MAAM,QAAQ,OAAO;;;AAKnH,SAAS,cAAc,OAAuB;AAC5C,KAAI,CAAC,OAAO,SAAS,MAAM,CACzB,QAAO;CAGT,MAAM,CAAC,UAAU,YADJ,OAAO,MAAM,CAAC,aAAa,CACN,MAAM,IAAI;CAC5C,MAAM,iBAAiB,SAAS,SAAS,IAAI,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG,SAAS;AAEhF,QAAO,WAAW,KAAK,IAAI,GAAG,iBAAiB,OAAO,SAAS,CAAC,GAAG;;;AAIrE,SAAS,aAAa,OAAe,MAAc,MAAuB;CACxE,MAAM,SAAS,QAAQ,QAAQ;CAC/B,MAAM,YAAY,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,CAAC;AACrD,QAAO,KAAK,IAAI,QAAQ,KAAK,MAAM,MAAM,CAAC,IAAI;;;AAIhD,SAAS,QAAQ,OAA+C;AAC9D,KAAI,SAAS,QAAQ,UAAU,GAC7B;CAEF,MAAM,SAAS,OAAO,MAAM;AAC5B,QAAO,OAAO,SAAS,OAAO,GAAG,SAAS;;AAG5C,SAAS,cACP,OACA,UACA,MACA,QACA,QACM;AACN,QAAO,KAAK;EACV,UAAU;EACV,MAAM;EACN;EACA;EACA,SAAS,YAAY,SAAS,aAAa,UAAU,OAAO,SAAS,OAAO,MAAM;EACnF,CAAC;;;;;;;;AASJ,SAAS,sBACP,OACA,OACA,cACA,oBACA,MACA,QACA,QACM;AACN,KAAI,CAAC,SAAS,MAAM,IAAI,CAAC,MAAM,QAAQ,MAAM,QAAQ,CACnD;AAEF,OAAM,QAAQ,SAAS,MAAM,UAAU;AACrC,MAAI,CAAC,SAAS,KAAK,CACjB;AAEF,MAAI,KAAK,SAAS,UAAU,SAAS,KAAK,MAAM,IAAI,MAAM,QAAQ,KAAK,MAAM,KAAK,CAChF,MAAK,MAAM,KAAK,SAAS,MAAM,cAAc;GAC3C,MAAM,WAAW;IAAC,GAAG;IAAM;IAAW;IAAO;IAAS;IAAQ;IAAU;AACxE,yBAAsB,OAAO,MAAM,UAAU,cAAc,QAAQ,OAAO;AAC1E,uBAAoB,MAAM,cAAc,oBAAoB,UAAU,OAAO;IAC7E;WAEK,MAAM,QAAQ,KAAK,QAAQ,CAElC,uBAAsB,MAAM,OAAO,cAAc,oBAAoB;GAAC,GAAG;GAAM;GAAW;GAAM,EAAE,QAAQ,OAAO;GAEnH;;;AAIJ,SAAS,oBACP,SACA,cACA,oBACA,MACA,QACM;AACN,KAAI,CAAC,SAAS,QAAQ,EAAE;AACtB,SAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN;GACA,QAAQ;GACR,SAAS;GACV,CAAC;AACF;;CAGF,MAAM,YAAY,QAAQ;CAC1B,MAAM,QAAQ,OAAO,cAAc,WAAW,aAAa,IAAI,UAAU,GAAG;AAC5E,KAAI,CAAC,OAAO;AACV,SAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,GAAG,MAAM,YAAY;GAC5B,QAAQ;GACR,SAAS,sBAAsB,OAAO,UAAU,CAAC;GAClD,CAAC;AACF;;CAGF,MAAM,SAAS,SAAS,MAAM;CAC9B,MAAM,SAAS,MAAM,UAAU,EAAE;CACjC,MAAM,eAAe,IAAI,IAAI,OAAO,KAAI,UAAS,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC;AAEtE,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,CAAC,cAAc,IAAI,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CACnD,QAAO,KAAK;EACV,UAAU;EACV,MAAM;EACN,MAAM,CAAC,GAAG,MAAM,IAAI;EACpB;EACA,SAAS,kBAAkB,IAAI,kBAAkB,MAAM,KAAK;EAC7D,CAAC;AAIN,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,QAAQ,QAAQ,MAAM;AAC5B,MAAI,UAAU,UAAa,UAAU,MAAM;AACzC,OAAI,MAAM,SACR,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM,CAAC,GAAG,MAAM,MAAM,KAAK;IAC3B;IACA,SAAS,2BAA2B,MAAM,KAAK,kBAAkB,MAAM,KAAK;IAC7E,CAAC;AAEJ;;AAEF,qBAAmB,OAAO,OAAO,cAAc,oBAAoB,CAAC,GAAG,MAAM,MAAM,KAAK,EAAE,QAAQ,OAAO;;;;;;;;;;;;AAa7G,SAAgB,cAAc,OAAgB,QAAsC;CAClF,MAAM,SAA4B,EAAE;CACpC,MAAM,eAAe,IAAI,IAAI,SAAS,OAAO,OAAO,CAAC,KAAI,UAAS,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC;CACvF,MAAM,qBAAqB,IAAI,IAC7B,SAAS,OAAO,aAAa,CAAC,KAAI,WAAU,CAAC,OAAO,WAAW,OAAO,MAAM,CAAC,CAC9E;AAED,qBADgB,SAAS,MAAM,GAAG,MAAM,UAAU,QACrB,cAAc,oBAAoB,CAAC,UAAU,EAAE,OAAO;AACnF,QAAO;EAAE,IAAI,OAAO,OAAM,UAAS,MAAM,aAAa,QAAQ;EAAE;EAAQ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@storyblok/schema",
   "type": "module",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Storyblok schema types and helpers",
   "license": "MIT",
   "homepage": "https://github.com/storyblok/monoblok/tree/main/packages/schema#readme",