@shapio/schema 0.5.5 → 0.5.7

package/dist/index.d.ts

@@ -33,8 +33,18 @@ export declare const REFERENCE_DATA_TYPES: ReadonlySet<DataType>;
  * How a value is physically represented in the content JSON. Changing a field's type within a storage
  * family never needs a data conversion, only a validity check; across families it is a conversion.
  */
-export type StorageFamily = 'jsonString' | 'jsonNumber' | 'numericString' | 'boolean' | 'json' | 'richtext' | 'media' | 'relation' | 'component' | 'dynamiczone';
+export type StorageFamily = 'jsonString' | 'jsonStringArray' | 'jsonNumber' | 'numericString' | 'boolean' | 'json' | 'richtext' | 'media' | 'relation' | 'component' | 'dynamiczone';
 export declare const STORAGE_FAMILY: Readonly<Record<DataType, StorageFamily>>;
+/** The parts of a field that decide how its values are stored. */
+export type StoredFieldShape = {
+  type: DataType;
+  settings?: object;
+};
+/**
+ * The storage family of a field's values, from its type and settings: a multi-value enum holds an array of
+ * strings, not a string. Use this rather than `STORAGE_FAMILY[type]` wherever a field's settings are known.
+ */
+export declare const storageFamilyOf: (field: StoredFieldShape) => StorageFamily;
 //#endregion
 //#region src/types/json.d.ts
 export type JsonPrimitive = string | number | boolean | null;
@@ -797,7 +807,7 @@ export type ValidationIssue = {
   /** Set by cross-definition checks so a multi-definition apply can say which file is wrong. */
   definitionId?: string;
 };
-export type IssueCode = 'INVALID_STRUCTURE' | 'INVALID_ID' | 'DUPLICATE_ID' | 'API_KEY_INVALID' | 'API_KEY_TOO_LONG' | 'API_KEY_RESERVED_PREFIX' | 'API_KEY_RESERVED' | 'API_KEY_COLLISION' | 'PLURAL_API_KEY_SAME_AS_SINGULAR' | 'GENERATED_NAME_COLLISION' | 'INVALID_SETTINGS' | 'INVALID_RANGE' | 'INVALID_PATTERN' | 'DUPLICATE_ENUM_VALUE' | 'INVALID_ENUM_VALUE' | 'UNSUPPORTED_FLAG' | 'INVALID_DEFAULT_VALUE' | 'UNKNOWN_EDITOR' | 'INCOMPATIBLE_EDITOR' | 'INVALID_EDITOR_OPTIONS' | 'UNKNOWN_FIELD_REFERENCE' | 'INVALID_FIELD_REFERENCE' | 'DUPLICATE_GROUP' | 'UNKNOWN_REFERENCE' | 'INVALID_REFERENCE_TARGET' | 'COMPONENT_CYCLE' | 'COMPONENT_TOO_DEEP' | 'REFERENCED_DEFINITION';
+export type IssueCode = 'INVALID_STRUCTURE' | 'INVALID_TEXT' | 'INVALID_ID' | 'DUPLICATE_ID' | 'API_KEY_INVALID' | 'API_KEY_TOO_LONG' | 'API_KEY_RESERVED_PREFIX' | 'API_KEY_RESERVED' | 'API_KEY_COLLISION' | 'PLURAL_API_KEY_SAME_AS_SINGULAR' | 'GENERATED_NAME_COLLISION' | 'INVALID_SETTINGS' | 'INVALID_RANGE' | 'INVALID_PATTERN' | 'DUPLICATE_ENUM_VALUE' | 'INVALID_ENUM_VALUE' | 'UNSUPPORTED_FLAG' | 'INVALID_DEFAULT_VALUE' | 'UNKNOWN_EDITOR' | 'INCOMPATIBLE_EDITOR' | 'INVALID_EDITOR_OPTIONS' | 'UNKNOWN_FIELD_REFERENCE' | 'INVALID_FIELD_REFERENCE' | 'DUPLICATE_GROUP' | 'UNKNOWN_REFERENCE' | 'INVALID_REFERENCE_TARGET' | 'COMPONENT_CYCLE' | 'COMPONENT_TOO_DEEP' | 'REFERENCED_DEFINITION';
 export declare class SchemaValidationError extends Error {
   readonly issues: readonly ValidationIssue[];
   constructor(issues: readonly ValidationIssue[]);
@@ -939,6 +949,21 @@ export declare const findReferencingDefinitions: (definitions: readonly SchemaDe
  */
 export declare const findDependentModels: (definitions: readonly SchemaDefinition[], componentId: string) => SchemaDefinition[];
 //#endregion
+//#region src/validators/text.d.ts
+/**
+ * Text no database can store as is: PostgreSQL `text` and `jsonb` reject U+0000, and `jsonb` rejects an
+ * unpaired UTF-16 surrogate. Shapio refuses both everywhere it takes input, so every database accepts the same
+ * values (SQLite would store them).
+ */
+export declare const INVALID_TEXT_MESSAGE = "must not contain NUL characters or unpaired surrogates";
+export declare const isValidText: (text: string) => boolean;
+/**
+ * The JSON pointer (relative to `value`, `''` for the value itself) of the first string, or object key, that
+ * is not valid text; undefined when everything is. Walks arrays and plain objects; other values (numbers,
+ * buffers, dates) hold no text.
+ */
+export declare const findInvalidText: (value: unknown, path?: string) => string | undefined;
+//#endregion
 //#region src/diff/types.d.ts
 export declare const CHANGE_KINDS: readonly ["definition.added", "definition.removed", "definition.apiKey", "definition.pluralApiKey", "definition.metadata", "model.kind", "model.localized", "model.draftAndPublish", "field.added", "field.removed", "field.order", "field.apiKey", "field.metadata", "field.editor", "field.type", "field.required", "field.localized", "field.public", "field.deprecated", "field.unique", "field.filterable", "field.sortable", "field.settings"];
 export type ChangeKind = (typeof CHANGE_KINDS)[number];
@@ -982,6 +1007,8 @@ export declare const diffDefinitions: (before: SchemaDefinition | null, after: S
  * | (plus) type change of a unique field | as its type change               | + checkUnique                 |
  * | (plus) tightened validation rules    | validation                       | validateValues                |
  * | (plus) localized true→false          | conversion (destructive)         | convert                       |
+ * | (plus) localized flip of a unique field | as the flip                    | + checkUnique                 |
+ * | (plus) type change Shapio can't convert | conversion (destructive, drops) | convert (+ validate/required) |
  */
 export type ChangeCategory = 'metadata' | 'editorSwap' | 'additive' | 'requiredField' | 'validation' | 'conversion' | 'contract' | 'removal' | 'constraint' | 'index';
 /** Work that must succeed before activation. Content-touching kinds run through the content ports. */
@@ -994,8 +1021,10 @@ export type ClassifiedChange = SchemaChange & {
   breaking: boolean;
   /** Loses stored information that a schema rollback cannot restore. */
   destructive: boolean;
-  /** False for conversions Shapio cannot perform; the planner refuses them. */
+  /** False for changes Shapio cannot perform; the planner refuses them. None today; kept for future refusals. */
   supported: boolean;
+  /** A type change Shapio cannot convert: every stored value of the field is dropped (destructive). */
+  dropsValues: boolean;
   prerequisites: PrerequisiteKind[];
   cleanup: CleanupKind[];
 };
@@ -1003,6 +1032,21 @@ export type ClassifyContext = {
   before: SchemaDefinition | null;
   after: SchemaDefinition | null;
 };
+/**
+ * A type change Shapio cannot convert: the field keeps its stable ID and API ID, and every stored value is
+ * dropped. The planner (`classifyChange`) decides it from both sides' type and settings and records it as
+ * `dropsValues` on the classified change; everything downstream (conversion job, impact, review, CLI) reads
+ * that flag rather than deciding again from the type names.
+ */
+export declare const typeChangeDropsValues: (from: StoredFieldShape, to: StoredFieldShape) => boolean;
+/**
+ * A change as a stored plan step carries it: classified since 0.5.6, plain before (no drops existed then).
+ */
+export type PlannedChange = SchemaChange & {
+  dropsValues?: boolean;
+};
+/** Whether a (classified) change drops every stored value of its field; false for plans without the flag. */
+export declare const changeDropsValues: (change: PlannedChange) => boolean;
 /** Classifies one change in the context of the definitions it was diffed from. */
 export declare const classifyChange: (change: SchemaChange, context: ClassifyContext) => ClassifiedChange;
 export declare const classifyChanges: (changes: readonly SchemaChange[], context: ClassifyContext) => ClassifiedChange[];
@@ -1033,6 +1077,15 @@ export type ClassifiedLocaleChange = {
  */
 export declare const classifyLocaleChange: (kind: LocaleChangeKind, code: string) => ClassifiedLocaleChange;
 //#endregion
+//#region src/diff/uniqueLocalization.d.ts
+/**
+ * Unique fields of a model whose values move between per-locale and shared storage in this change (the field's
+ * or the model's `localized` flips). Their registry rows change key (locale ↔ `*`), and values that were unique
+ * per locale may collide once shared, so each needs a uniqueness check that rebuilds its rows. Deprecated fields
+ * are skipped: the registry does not track them.
+ */
+export declare const uniqueFieldsChangingLocalization: (before: SchemaDefinition | null, after: SchemaDefinition | null) => FieldDefinition[];
+//#endregion
 //#region src/fileFormat/canonical.d.ts
 export declare const canonicalJson: (value: unknown) => string;
 /**

package/dist/index.js

@@ -96,6 +96,11 @@ const STORAGE_FAMILY = {
 	component: "component",
 	dynamiczone: "dynamiczone"
 };
+/**
+* The storage family of a field's values, from its type and settings: a multi-value enum holds an array of
+* strings, not a string. Use this rather than `STORAGE_FAMILY[type]` wherever a field's settings are known.
+*/
+const storageFamilyOf = (field) => field.type === "enum" && field.settings?.multiple === true ? "jsonStringArray" : STORAGE_FAMILY[field.type];
 //#endregion
 //#region src/types/definitions.ts
 /**
@@ -1172,6 +1177,46 @@ const generatedNames = (definition) => {
 	return names;
 };
 //#endregion
+//#region src/validators/text.ts
+/**
+* Text no database can store as is: PostgreSQL `text` and `jsonb` reject U+0000, and `jsonb` rejects an
+* unpaired UTF-16 surrogate. Shapio refuses both everywhere it takes input, so every database accepts the same
+* values (SQLite would store them).
+*/
+const INVALID_TEXT_MESSAGE = "must not contain NUL characters or unpaired surrogates";
+const isValidText = (text) => !text.includes("\0") && text.isWellFormed();
+/**
+* Parsed JSON and querystrings; not buffers, dates or class instances. Querystring parsers build objects
+* without `Object.prototype`, either with no prototype or with an empty one that has none.
+*/
+const isPlainObject = (value) => {
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null;
+};
+const escapeSegment = (segment) => segment.replaceAll("~", "~0").replaceAll("/", "~1");
+/**
+* The JSON pointer (relative to `value`, `''` for the value itself) of the first string, or object key, that
+* is not valid text; undefined when everything is. Walks arrays and plain objects; other values (numbers,
+* buffers, dates) hold no text.
+*/
+const findInvalidText = (value, path = "") => {
+	if (typeof value === "string") return isValidText(value) ? void 0 : path;
+	if (Array.isArray(value)) {
+		for (const [index, item] of value.entries()) {
+			const found = findInvalidText(item, `${path}/${index}`);
+			if (found !== void 0) return found;
+		}
+		return;
+	}
+	if (typeof value !== "object" || value === null || !isPlainObject(value)) return;
+	for (const [key, item] of Object.entries(value)) {
+		const at = `${path}/${escapeSegment(key)}`;
+		if (!isValidText(key)) return at;
+		const found = findInvalidText(item, at);
+		if (found !== void 0) return found;
+	}
+};
+//#endregion
 //#region src/validators/typeboxIssues.ts
 /**
 * TypeBox errors as (JSON pointer, message) pairs. The `schema is false` echo that accompanies every
@@ -1445,6 +1490,8 @@ const checkPluralApiKey = (definition) => {
 /** All problems with one definition, in document order. Empty means valid on its own. */
 const validateDefinition = (definition) => {
 	const issues = [];
+	const invalidText = findInvalidText(definition);
+	if (invalidText !== void 0) issues.push(issue(invalidText, "INVALID_TEXT", INVALID_TEXT_MESSAGE));
 	if (!isStableId(definition.id)) issues.push(issue("/id", "INVALID_ID", "must be a lower-case UUID"));
 	const syntax = checkApiKeySyntax(definition.apiKey);
 	if (syntax) issues.push(issue("/apiKey", syntax.code, syntax.message));
@@ -1917,12 +1964,33 @@ const diffDefinitions = (before, after) => {
 	return changes;
 };
 //#endregion
+//#region src/diff/uniqueLocalization.ts
+/**
+* Whether a field's values are stored per locale: on a localized model only (ADR 0004). The unique registry
+* keys such a field by locale and a shared one by `*`.
+*/
+const storedPerLocale = (definition, field) => definition.kind !== "component" && definition.localized === true && field.localized === true;
+/**
+* Unique fields of a model whose values move between per-locale and shared storage in this change (the field's
+* or the model's `localized` flips). Their registry rows change key (locale ↔ `*`), and values that were unique
+* per locale may collide once shared, so each needs a uniqueness check that rebuilds its rows. Deprecated fields
+* are skipped: the registry does not track them.
+*/
+const uniqueFieldsChangingLocalization = (before, after) => {
+	if (!before || !after || after.kind === "component") return [];
+	return after.fields.filter((field) => {
+		const previous = before.fields.find((candidate) => candidate.id === field.id);
+		return previous !== void 0 && field.unique === true && !field.deprecated && storedPerLocale(before, previous) !== storedPerLocale(after, field);
+	});
+};
+//#endregion
 //#region src/diff/classify.ts
 const result = (category, extra = {}) => ({
 	category,
 	breaking: false,
 	destructive: false,
 	supported: true,
+	dropsValues: false,
 	prerequisites: [],
 	cleanup: [],
 	...extra
@@ -1972,27 +2040,67 @@ const hasTextConstraints = (field) => {
 	return settings.minLength !== void 0 || settings.maxLength !== void 0 || settings.pattern !== void 0 || settings.validate === true;
 };
 /**
+* Whether Shapio converts a cross-family type change value by value (the pairs it knows); within one storage
+* family the stored JSON stays as it is. Families come from type and settings, so a multi-value enum's
+* arrays are never taken for text.
+*/
+const convertsAcrossFamilies = (from, to) => {
+	const fromFamily = storageFamilyOf(from);
+	const toFamily = storageFamilyOf(to);
+	const numericPair = fromFamily === "jsonNumber" && toFamily === "numericString" || fromFamily === "numericString" && toFamily === "jsonNumber";
+	const toText = SCALAR_FAMILIES.has(fromFamily) && PLAIN_TEXT_TYPES.has(to.type);
+	const textToRichtext = fromFamily === "jsonString" && from.type !== "code" && to.type === "richtext";
+	const richtextToText = from.type === "richtext" && PLAIN_TEXT_TYPES.has(to.type);
+	return numericPair || toText || textToRichtext || richtextToText || fromFamily === "jsonString" && toFamily === "jsonStringArray";
+};
+/**
+* A type change Shapio cannot convert: the field keeps its stable ID and API ID, and every stored value is
+* dropped. The planner (`classifyChange`) decides it from both sides' type and settings and records it as
+* `dropsValues` on the classified change; everything downstream (conversion job, impact, review, CLI) reads
+* that flag rather than deciding again from the type names.
+*/
+const typeChangeDropsValues = (from, to) => storageFamilyOf(from) !== storageFamilyOf(to) && !convertsAcrossFamilies(from, to);
+/** Whether a (classified) change drops every stored value of its field; false for plans without the flag. */
+const changeDropsValues = (change) => change.kind === "field.type" && change.dropsValues === true;
+/** A required field whose values are dropped is backfilled from its default, else checked (no silent nulls). */
+const requiredStep = (field) => {
+	if (!field?.required) return [];
+	return [field.defaultValue !== void 0 ? "backfill" : "validateRequired"];
+};
+/**
 * A type change. Within one storage family the stored JSON stays as it is: widening is live, anything else
-* re-validates existing values. Across families Shapio converts values with a job, for the pairs it knows.
+* re-validates existing values. Across families Shapio converts values with a job, for the pairs it knows;
+* any other pair drops the values (destructive, acknowledged in the review).
 */
-const classifyTypeChange = (from, to, after) => {
+const classifyTypeChange = (from, to, previous, after) => {
 	const breaking = API_SCALAR[from] !== API_SCALAR[to] || to === "code" && from !== "code";
-	const fromFamily = STORAGE_FAMILY[from];
-	const toFamily = STORAGE_FAMILY[to];
-	if (fromFamily === toFamily) return fromFamily === "jsonString" && TEXT_TARGETS.has(to) && !hasTextConstraints(after) || from === "integer" && to === "number" || from === "biginteger" && to === "decimal" && after?.type === "decimal" && after.settings.precision === void 0 ? result("additive", { breaking }) : result("validation", {
+	const fromShape = {
+		type: from,
+		...previous ? { settings: previous.settings } : {}
+	};
+	const toShape = {
+		type: to,
+		...after ? { settings: after.settings } : {}
+	};
+	const fromFamily = storageFamilyOf(fromShape);
+	if (fromFamily === storageFamilyOf(toShape)) return fromFamily === "jsonString" && TEXT_TARGETS.has(to) && !hasTextConstraints(after) || from === "integer" && to === "number" || from === "biginteger" && to === "decimal" && after?.type === "decimal" && after.settings.precision === void 0 ? result("additive", { breaking }) : result("validation", {
 		breaking,
 		prerequisites: ["validateValues"]
 	});
-	const numericPair = fromFamily === "jsonNumber" && toFamily === "numericString" || fromFamily === "numericString" && toFamily === "jsonNumber";
-	const toText = SCALAR_FAMILIES.has(fromFamily) && PLAIN_TEXT_TYPES.has(to);
-	const textToRichtext = fromFamily === "jsonString" && from !== "code" && to === "richtext";
-	const richtextToText = from === "richtext" && PLAIN_TEXT_TYPES.has(to);
-	const supported = numericPair || toText || textToRichtext || richtextToText;
+	if (typeChangeDropsValues(fromShape, toShape)) return result("conversion", {
+		breaking,
+		destructive: true,
+		dropsValues: true,
+		prerequisites: [
+			"convert",
+			"validateValues",
+			...requiredStep(after)
+		]
+	});
 	return result("conversion", {
 		breaking,
-		supported,
-		destructive: richtextToText,
-		prerequisites: supported ? ["convert", "validateValues"] : []
+		destructive: from === "richtext" && PLAIN_TEXT_TYPES.has(to),
+		prerequisites: ["convert", "validateValues"]
 	});
 };
 const compareValues = (a, b) => {
@@ -2072,7 +2180,7 @@ const classifyFieldChange = (change, { before, after }) => {
 		case "field.editor": return result("editorSwap");
 		case "field.apiKey": return result("contract", { breaking: true });
 		case "field.type": {
-			const classification = classifyTypeChange(change.from, change.to, field);
+			const classification = classifyTypeChange(change.from, change.to, previous, field);
 			return field?.unique && previous?.unique && !classification.prerequisites.includes("checkUnique") ? {
 				...classification,
 				prerequisites: [...classification.prerequisites, "checkUnique"]
@@ -2081,12 +2189,14 @@ const classifyFieldChange = (change, { before, after }) => {
 		case "field.required":
 			if (change.to !== true) return result("additive");
 			return result("requiredField", { prerequisites: [field?.defaultValue !== void 0 ? "backfill" : "validateRequired"] });
-		case "field.localized":
+		case "field.localized": {
 			if (!(after?.kind !== "component" && after?.localized === true)) return result("metadata");
-			return change.to === true ? result("additive") : result("conversion", {
+			const checks = uniqueFieldsChangingLocalization(before, after).some((candidate) => candidate.id === change.fieldId) ? ["checkUnique"] : [];
+			return change.to === true ? result("additive", { prerequisites: checks }) : result("conversion", {
 				destructive: true,
-				prerequisites: ["convert"]
+				prerequisites: ["convert", ...checks]
 			});
+		}
 		case "field.public":
 		case "field.deprecated": {
 			const hides = change.kind === "field.public" ? change.to === false : change.to === true;
@@ -2125,12 +2235,14 @@ const classifyChange = (change, context) => {
 				prerequisites: ["validateValues"]
 			}) : result("contract", { breaking: true });
 			break;
-		case "model.localized":
-			classification = change.to === true ? result("additive") : result("conversion", {
+		case "model.localized": {
+			const checks = uniqueFieldsChangingLocalization(context.before, context.after).length > 0 ? ["checkUnique"] : [];
+			classification = change.to === true ? result("additive", { prerequisites: checks }) : result("conversion", {
 				destructive: true,
-				prerequisites: ["convert"]
+				prerequisites: ["convert", ...checks]
 			});
 			break;
+		}
 		case "model.draftAndPublish":
 			classification = change.to === true ? result("additive") : result("conversion", {
 				destructive: true,
@@ -2773,6 +2885,6 @@ const SeoDefaultsSchema = Type.Object({
 	twitterHandle: Type.Union([Type.String({ pattern: SEO_TWITTER_HANDLE_PATTERN.source }), Type.Null()])
 }, closed);
 //#endregion
-export { API_KEY_PATTERN, BIGINTEGER_PATTERN, BUILT_IN_THEME_KEYS, CANVAS_ELIGIBLE, CHANGE_KINDS, CODE_LANGUAGES, COMPONENT_TYPE_SUFFIXES, CUSTOM_EDITOR_ID_PATTERN, ComponentDefinitionInputSchema, ComponentDisplayInputSchema, DATA_TYPES, DATETIME_PATTERN, DATE_PATTERN, DECIMAL_PATTERN, DEFAULT_EDITORS, DEFAULT_SEO_KEYS, DEFINITION_KINDS, DefinitionInputSchema, EDITOR_CATALOGUE, EMPTY_SEO_DEFAULTS, ENTRY_LAYOUTS, EditorChoiceInputSchema, EnumValueSchema, FIELD_WIDTHS, FieldInputSchema, INLINE_TITLE_TYPES, LOCALE_CODE_PATTERN, LOCK_FILE_FORMAT_VERSION, LOCK_FILE_PATH, LocaleInputSchema, LockEntrySchema, LockFileError, LockFileSchema, MARK_RULES, MAX_API_KEY_LENGTH, MAX_COMPONENT_DEPTH, MAX_DESCRIPTION_LENGTH, MAX_FALLBACK_CHAIN, MAX_FIELDS_PER_DEFINITION, MAX_LABEL_LENGTH, MAX_RICHTEXT_DEPTH, MEDIA_KINDS, MODEL_KINDS, MODEL_TYPE_SUFFIXES, MUTATION_PREFIXES, ModelDefinitionInputSchema, ModelDisplayInputSchema, NODE_RULES, PLURAL_FALLBACK_SUFFIX, REFERENCE_DATA_TYPES, RELATION_CARDINALITIES, RESERVED_DEFINITION_API_KEYS, RESERVED_FIELD_API_KEYS, RESERVED_QUERY_NAMES, RESERVED_TYPE_NAMES, RICHTEXT_FORMAT, RICHTEXT_FORMAT_VERSION, SAFE_LINK_PATTERN, SCALAR_DATA_TYPES, SCHEMA_KIND_DIRECTORIES, SEO_COMPONENT_API_KEY, SEO_COMPONENT_ID, SEO_DESCRIPTION_SOFT_MAX, SEO_EDITOR_ID, SEO_FIELD_IDS, SEO_TITLE_PLACEHOLDER, SEO_TITLE_SOFT_MAX, SEO_TITLE_TEMPLATE_PATTERN, SEO_TWITTER_HANDLE_PATTERN, SETTINGS_SCHEMAS, SITES_DIRECTORY, SLUG_PATTERN, SORT_DIRECTIONS, STABLE_ID_PATTERN, STORAGE_FAMILY, STRIP_DEFAULT_COUNT, SchemaValidationError, SeoDefaultsSchema, SeoLocaleDefaultsSchema, TEXT_TITLE_FIELD_TYPES, THEME_BRAND_TOKENS, THEME_COLOUR_PATTERN, THEME_DARK_UI_PAIRS, THEME_KEY_PATTERN, THEME_SEMANTIC_TOKENS, THEME_TEXT_PAIRS, THEME_TOKENS, THEME_UI_PAIRS, THEME_VARIANTS, TIME_PATTERN, TITLE_FIELD_TYPES, UID_PATTERN, UNIQUE_CAPABLE_DATA_TYPES, applyTitleTemplate, assignIds, canonicalJson, checkApiKeySyntax, checkDefaultValue, checkThemeContrast, classifyChange, classifyChanges, classifyLocaleChange, collectionQueryName, contrastRatio, createStableId, decideSync, diffDefinitions, effectiveFormLayout, effectiveLayout, effectiveTitleField, embeddedComponentIds, entryLayoutOf, escapeHtml, findDependentModels, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isDocumentPlaceable, isEmptyRichText, isModelDefinition, isSeoField, isStableId, isValidTitleTemplate, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, resolveSeo, richTextBodyOf, richTextMediaIds, richTextPlainText, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, seoComponentDefinition, seoDefaultsForLocale, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
+export { API_KEY_PATTERN, BIGINTEGER_PATTERN, BUILT_IN_THEME_KEYS, CANVAS_ELIGIBLE, CHANGE_KINDS, CODE_LANGUAGES, COMPONENT_TYPE_SUFFIXES, CUSTOM_EDITOR_ID_PATTERN, ComponentDefinitionInputSchema, ComponentDisplayInputSchema, DATA_TYPES, DATETIME_PATTERN, DATE_PATTERN, DECIMAL_PATTERN, DEFAULT_EDITORS, DEFAULT_SEO_KEYS, DEFINITION_KINDS, DefinitionInputSchema, EDITOR_CATALOGUE, EMPTY_SEO_DEFAULTS, ENTRY_LAYOUTS, EditorChoiceInputSchema, EnumValueSchema, FIELD_WIDTHS, FieldInputSchema, INLINE_TITLE_TYPES, INVALID_TEXT_MESSAGE, LOCALE_CODE_PATTERN, LOCK_FILE_FORMAT_VERSION, LOCK_FILE_PATH, LocaleInputSchema, LockEntrySchema, LockFileError, LockFileSchema, MARK_RULES, MAX_API_KEY_LENGTH, MAX_COMPONENT_DEPTH, MAX_DESCRIPTION_LENGTH, MAX_FALLBACK_CHAIN, MAX_FIELDS_PER_DEFINITION, MAX_LABEL_LENGTH, MAX_RICHTEXT_DEPTH, MEDIA_KINDS, MODEL_KINDS, MODEL_TYPE_SUFFIXES, MUTATION_PREFIXES, ModelDefinitionInputSchema, ModelDisplayInputSchema, NODE_RULES, PLURAL_FALLBACK_SUFFIX, REFERENCE_DATA_TYPES, RELATION_CARDINALITIES, RESERVED_DEFINITION_API_KEYS, RESERVED_FIELD_API_KEYS, RESERVED_QUERY_NAMES, RESERVED_TYPE_NAMES, RICHTEXT_FORMAT, RICHTEXT_FORMAT_VERSION, SAFE_LINK_PATTERN, SCALAR_DATA_TYPES, SCHEMA_KIND_DIRECTORIES, SEO_COMPONENT_API_KEY, SEO_COMPONENT_ID, SEO_DESCRIPTION_SOFT_MAX, SEO_EDITOR_ID, SEO_FIELD_IDS, SEO_TITLE_PLACEHOLDER, SEO_TITLE_SOFT_MAX, SEO_TITLE_TEMPLATE_PATTERN, SEO_TWITTER_HANDLE_PATTERN, SETTINGS_SCHEMAS, SITES_DIRECTORY, SLUG_PATTERN, SORT_DIRECTIONS, STABLE_ID_PATTERN, STORAGE_FAMILY, STRIP_DEFAULT_COUNT, SchemaValidationError, SeoDefaultsSchema, SeoLocaleDefaultsSchema, TEXT_TITLE_FIELD_TYPES, THEME_BRAND_TOKENS, THEME_COLOUR_PATTERN, THEME_DARK_UI_PAIRS, THEME_KEY_PATTERN, THEME_SEMANTIC_TOKENS, THEME_TEXT_PAIRS, THEME_TOKENS, THEME_UI_PAIRS, THEME_VARIANTS, TIME_PATTERN, TITLE_FIELD_TYPES, UID_PATTERN, UNIQUE_CAPABLE_DATA_TYPES, applyTitleTemplate, assignIds, canonicalJson, changeDropsValues, checkApiKeySyntax, checkDefaultValue, checkThemeContrast, classifyChange, classifyChanges, classifyLocaleChange, collectionQueryName, contrastRatio, createStableId, decideSync, diffDefinitions, effectiveFormLayout, effectiveLayout, effectiveTitleField, embeddedComponentIds, entryLayoutOf, escapeHtml, findDependentModels, findInvalidText, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isDocumentPlaceable, isEmptyRichText, isModelDefinition, isSeoField, isStableId, isValidText, isValidTitleTemplate, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, resolveSeo, richTextBodyOf, richTextMediaIds, richTextPlainText, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, seoComponentDefinition, seoDefaultsForLocale, serializeDefinition, serializeLockFile, sha256, storageFamilyOf, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, typeChangeDropsValues, uniqueFieldsChangingLocalization, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
 
 //# sourceMappingURL=index.js.map