@shapio/schema 0.3.0 → 0.4.0

package/dist/index.js

@@ -1,4 +1,5 @@
 import { _ as STABLE_ID_PATTERN, a as MAX_RICHTEXT_DEPTH, c as BIGINTEGER_PATTERN, d as DECIMAL_PATTERN, f as RICHTEXT_FORMAT, g as UID_PATTERN, h as TIME_PATTERN, i as MARK_RULES, l as DATETIME_PATTERN, m as SLUG_PATTERN, n as richTextMediaIds, o as NODE_RULES, p as RICHTEXT_FORMAT_VERSION, r as validateRichText, s as SAFE_LINK_PATTERN, t as isEmptyRichText, u as DATE_PATTERN, v as createStableId, y as isStableId } from "./validate-BQGutaBo.js";
+import { a as isValidTitleTemplate, c as SEO_COMPONENT_ID, d as SEO_FIELD_IDS, f as SEO_TITLE_PLACEHOLDER, h as SEO_TWITTER_HANDLE_PATTERN, i as applyTitleTemplate, l as SEO_DESCRIPTION_SOFT_MAX, m as SEO_TITLE_TEMPLATE_PATTERN, n as resolveSeo, o as seoDefaultsForLocale, p as SEO_TITLE_SOFT_MAX, r as EMPTY_SEO_DEFAULTS, s as SEO_COMPONENT_API_KEY, t as DEFAULT_SEO_KEYS, u as SEO_EDITOR_ID } from "./resolve-viddCEYd.js";
 import { Type } from "typebox";
 import pluralize from "pluralize";
 import { Value } from "typebox/value";
@@ -103,7 +104,7 @@ const STORAGE_FAMILY = {
 * defaulted properties may be omitted. `normalizeDefinition` turns input into the normalized types below,
 * which are what Shapio stores, hashes and diffs.
 */
-const closed$2 = { additionalProperties: false };
+const closed$3 = { additionalProperties: false };
 const MODEL_KINDS = ["collection", "singleton"];
 const DEFINITION_KINDS = [...MODEL_KINDS, "component"];
 const SORT_DIRECTIONS = ["asc", "desc"];
@@ -121,7 +122,7 @@ const EditorChoiceInputSchema = Type.Object({
 		maxLength: 128
 	}),
 	options: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
-}, closed$2);
+}, closed$3);
 const FieldInputSchema = Type.Object({
 	id: Type.Optional(Type.String()),
 	apiKey: Type.String(),
@@ -144,7 +145,7 @@ const FieldInputSchema = Type.Object({
 	/** Type-specific settings, validated against SETTINGS_SCHEMAS[type]. */
 	settings: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
 	editor: Type.Optional(EditorChoiceInputSchema)
-}, closed$2);
+}, closed$3);
 const FieldGroupSchema = Type.Object({
 	id: Type.String({
 		minLength: 1,
@@ -152,7 +153,7 @@ const FieldGroupSchema = Type.Object({
 	}),
 	label: Label,
 	fieldIds: Type.Array(Type.String())
-}, closed$2);
+}, closed$3);
 const ModelDisplayInputSchema = Type.Object({
 	/** Field whose value labels an entry in lists, pickers and relation summaries. */
 	titleFieldId: Type.Optional(Type.String()),
@@ -161,7 +162,7 @@ const ModelDisplayInputSchema = Type.Object({
 	defaultSort: Type.Optional(Type.Object({
 		fieldId: Type.String(),
 		direction: Type.Enum(SORT_DIRECTIONS)
-	}, closed$2)),
+	}, closed$3)),
 	/** Editor layout: named sections of the entry form. */
 	groups: Type.Optional(Type.Array(FieldGroupSchema)),
 	/** Fields rendered as blocks in the entry document's canvas, in order. Default: see `effectiveLayout`. */
@@ -170,11 +171,11 @@ const ModelDisplayInputSchema = Type.Object({
 	coverFieldId: Type.Optional(Type.String()),
 	/** Properties shown as chips in the document's strip. Default: the first non-empty ones. */
 	stripFieldIds: Type.Optional(Type.Array(Type.String()))
-}, closed$2);
+}, closed$3);
 const ComponentDisplayInputSchema = Type.Object({
 	titleFieldId: Type.Optional(Type.String()),
 	groups: Type.Optional(Type.Array(FieldGroupSchema))
-}, closed$2);
+}, closed$3);
 const definitionBase = {
 	id: Type.Optional(Type.String()),
 	apiKey: Type.String(),
@@ -194,7 +195,7 @@ const ModelDefinitionInputSchema = Type.Object({
 	/** Entries have separate draft and published states. Default true. */
 	draftAndPublish: Type.Optional(Type.Boolean()),
 	display: Type.Optional(ModelDisplayInputSchema)
-}, closed$2);
+}, closed$3);
 const ComponentDefinitionInputSchema = Type.Object({
 	...definitionBase,
 	kind: Type.Literal("component"),
@@ -207,7 +208,7 @@ const ComponentDefinitionInputSchema = Type.Object({
 		maxLength: 64
 	})),
 	display: Type.Optional(ComponentDisplayInputSchema)
-}, closed$2);
+}, closed$3);
 const DefinitionInputSchema = Type.Union([ModelDefinitionInputSchema, ComponentDefinitionInputSchema]);
 const isComponentDefinition = (definition) => definition.kind === "component";
 const isModelDefinition = (definition) => definition.kind !== "component";
@@ -235,7 +236,7 @@ const LocaleInputSchema = Type.Object({
 * enum values...). Each schema is closed (`additionalProperties: false`) so a typo in a hand-edited schema
 * file is reported instead of ignored. Defaults are applied by `normalizeDefinition`.
 */
-const closed$1 = { additionalProperties: false };
+const closed$2 = { additionalProperties: false };
 const NonNegativeInt = Type.Integer({ minimum: 0 });
 const pattern = (regex) => Type.String({ pattern: regex.source });
 const lengthRules = {
@@ -263,7 +264,7 @@ const EnumValueSchema = Type.Object({
 		minLength: 1,
 		maxLength: 200
 	})
-}, closed$1);
+}, closed$2);
 const SETTINGS_SCHEMAS = {
 	string: Type.Object({
 		...lengthRules,
@@ -271,20 +272,20 @@ const SETTINGS_SCHEMAS = {
 			minLength: 1,
 			maxLength: 500
 		}))
-	}, closed$1),
-	text: Type.Object(lengthRules, closed$1),
+	}, closed$2),
+	text: Type.Object(lengthRules, closed$2),
 	richtext: Type.Object({
 		formatVersion: Type.Optional(Type.Integer({ minimum: 1 })),
 		maxLength: Type.Optional(Type.Integer({ minimum: 1 }))
-	}, closed$1),
+	}, closed$2),
 	number: Type.Object({
 		min: Type.Optional(Type.Number()),
 		max: Type.Optional(Type.Number())
-	}, closed$1),
+	}, closed$2),
 	integer: Type.Object({
 		min: Type.Optional(Type.Integer()),
 		max: Type.Optional(Type.Integer())
-	}, closed$1),
+	}, closed$2),
 	decimal: Type.Object({
 		precision: Type.Optional(Type.Integer({
 			minimum: 1,
@@ -296,70 +297,74 @@ const SETTINGS_SCHEMAS = {
 		})),
 		min: Type.Optional(pattern(DECIMAL_PATTERN)),
 		max: Type.Optional(pattern(DECIMAL_PATTERN))
-	}, closed$1),
+	}, closed$2),
 	biginteger: Type.Object({
 		min: Type.Optional(pattern(BIGINTEGER_PATTERN)),
 		max: Type.Optional(pattern(BIGINTEGER_PATTERN))
-	}, closed$1),
-	boolean: Type.Object({}, closed$1),
+	}, closed$2),
+	boolean: Type.Object({}, closed$2),
 	date: Type.Object({
 		min: Type.Optional(pattern(DATE_PATTERN)),
 		max: Type.Optional(pattern(DATE_PATTERN))
-	}, closed$1),
+	}, closed$2),
 	datetime: Type.Object({
 		min: Type.Optional(pattern(DATETIME_PATTERN)),
 		max: Type.Optional(pattern(DATETIME_PATTERN))
-	}, closed$1),
+	}, closed$2),
 	time: Type.Object({
 		min: Type.Optional(pattern(TIME_PATTERN)),
 		max: Type.Optional(pattern(TIME_PATTERN))
-	}, closed$1),
+	}, closed$2),
 	enum: Type.Object({
 		values: Type.Array(EnumValueSchema, {
 			minItems: 1,
 			maxItems: 500
 		}),
 		multiple: Type.Optional(Type.Boolean())
-	}, closed$1),
-	json: Type.Object({}, closed$1),
+	}, closed$2),
+	json: Type.Object({}, closed$2),
 	slug: Type.Object({
 		...lengthRules,
 		sourceFieldId: Type.Optional(Type.String())
-	}, closed$1),
-	email: Type.Object({}, closed$1),
+	}, closed$2),
+	email: Type.Object({}, closed$2),
 	url: Type.Object({ protocols: Type.Optional(Type.Array(Type.Enum([
 		"http",
 		"https",
 		"mailto",
 		"tel"
-	]), { minItems: 1 })) }, closed$1),
-	uid: Type.Object(lengthRules, closed$1),
+	]), { minItems: 1 })) }, closed$2),
+	uid: Type.Object(lengthRules, closed$2),
 	media: Type.Object({
 		multiple: Type.Optional(Type.Boolean()),
 		allowedKinds: Type.Optional(Type.Array(Type.Enum(MEDIA_KINDS), { minItems: 1 })),
 		...countRules
-	}, closed$1),
+	}, closed$2),
 	relation: Type.Object({
 		target: Type.String(),
 		cardinality: Type.Enum(RELATION_CARDINALITIES),
 		...countRules
-	}, closed$1),
+	}, closed$2),
 	component: Type.Object({
 		component: Type.String(),
 		repeatable: Type.Optional(Type.Boolean()),
 		...countRules
-	}, closed$1),
+	}, closed$2),
 	dynamiczone: Type.Object({
 		components: Type.Array(Type.String(), {
 			minItems: 1,
 			maxItems: 100
 		}),
 		...countRules
-	}, closed$1)
+	}, closed$2)
 };
 //#endregion
+//#region src/seo/field.ts
+/** Whether a field holds the built-in SEO component (by stable ID, whatever its API ID or editor). */
+const isSeoField = (field) => field.type === "component" && field.settings.component === "f3905a00-d2a3-4c62-899a-c894bfd6cb9b" && !field.settings.repeatable;
+//#endregion
 //#region src/editors/catalogue.ts
-const closed = { additionalProperties: false };
+const closed$1 = { additionalProperties: false };
 const Placeholder = Type.Optional(Type.String({ maxLength: 200 }));
 const isMultipleEnum = (field) => field.type === "enum" && field.settings.multiple;
 const entries = [
@@ -371,7 +376,7 @@ const entries = [
 			"url",
 			"uid"
 		],
-		optionsSchema: Type.Object({ placeholder: Placeholder }, closed)
+		optionsSchema: Type.Object({ placeholder: Placeholder }, closed$1)
 	},
 	{
 		id: "textarea",
@@ -382,7 +387,7 @@ const entries = [
 				minimum: 2,
 				maximum: 40
 			}))
-		}, closed)
+		}, closed$1)
 	},
 	{
 		id: "color",
@@ -390,12 +395,12 @@ const entries = [
 		optionsSchema: Type.Object({
 			format: Type.Optional(Type.Enum(["hex", "rgb"])),
 			presets: Type.Optional(Type.Array(Type.String({ maxLength: 32 }), { maxItems: 50 }))
-		}, closed)
+		}, closed$1)
 	},
 	{
 		id: "richText",
 		dataTypes: ["richtext"],
-		optionsSchema: Type.Object({ toolbar: Type.Optional(Type.Enum(["full", "minimal"])) }, closed)
+		optionsSchema: Type.Object({ toolbar: Type.Optional(Type.Enum(["full", "minimal"])) }, closed$1)
 	},
 	{
 		id: "numberInput",
@@ -408,17 +413,17 @@ const entries = [
 		optionsSchema: Type.Object({
 			placeholder: Placeholder,
 			step: Type.Optional(Type.Number({ exclusiveMinimum: 0 }))
-		}, closed)
+		}, closed$1)
 	},
 	{
 		id: "toggle",
 		dataTypes: ["boolean"],
-		optionsSchema: Type.Object({}, closed)
+		optionsSchema: Type.Object({}, closed$1)
 	},
 	{
 		id: "checkbox",
 		dataTypes: ["boolean"],
-		optionsSchema: Type.Object({}, closed)
+		optionsSchema: Type.Object({}, closed$1)
 	},
 	{
 		id: "segmented",
@@ -426,35 +431,35 @@ const entries = [
 		optionsSchema: Type.Object({
 			trueLabel: Type.Optional(Type.String({ maxLength: 50 })),
 			falseLabel: Type.Optional(Type.String({ maxLength: 50 }))
-		}, closed),
+		}, closed$1),
 		supports: (field) => !isMultipleEnum(field)
 	},
 	{
 		id: "select",
 		dataTypes: ["enum"],
-		optionsSchema: Type.Object({ placeholder: Placeholder }, closed)
+		optionsSchema: Type.Object({ placeholder: Placeholder }, closed$1)
 	},
 	{
 		id: "radio",
 		dataTypes: ["enum"],
-		optionsSchema: Type.Object({ layout: Type.Optional(Type.Enum(["vertical", "horizontal"])) }, closed),
+		optionsSchema: Type.Object({ layout: Type.Optional(Type.Enum(["vertical", "horizontal"])) }, closed$1),
 		supports: (field) => !isMultipleEnum(field)
 	},
 	{
 		id: "checkboxGroup",
 		dataTypes: ["enum"],
-		optionsSchema: Type.Object({ layout: Type.Optional(Type.Enum(["vertical", "horizontal"])) }, closed),
+		optionsSchema: Type.Object({ layout: Type.Optional(Type.Enum(["vertical", "horizontal"])) }, closed$1),
 		supports: isMultipleEnum
 	},
 	{
 		id: "datePicker",
 		dataTypes: ["date"],
-		optionsSchema: Type.Object({}, closed)
+		optionsSchema: Type.Object({}, closed$1)
 	},
 	{
 		id: "dateTimePicker",
 		dataTypes: ["datetime"],
-		optionsSchema: Type.Object({ display: Type.Optional(Type.Enum(["local", "utc"])) }, closed)
+		optionsSchema: Type.Object({ display: Type.Optional(Type.Enum(["local", "utc"])) }, closed$1)
 	},
 	{
 		id: "timePicker",
@@ -462,12 +467,12 @@ const entries = [
 		optionsSchema: Type.Object({ stepMinutes: Type.Optional(Type.Integer({
 			minimum: 1,
 			maximum: 60
-		})) }, closed)
+		})) }, closed$1)
 	},
 	{
 		id: "slugInput",
 		dataTypes: ["slug"],
-		optionsSchema: Type.Object({ placeholder: Placeholder }, closed)
+		optionsSchema: Type.Object({ placeholder: Placeholder }, closed$1)
 	},
 	{
 		id: "jsonEditor",
@@ -475,27 +480,33 @@ const entries = [
 		optionsSchema: Type.Object({ rows: Type.Optional(Type.Integer({
 			minimum: 3,
 			maximum: 80
-		})) }, closed)
+		})) }, closed$1)
 	},
 	{
 		id: "mediaPicker",
 		dataTypes: ["media"],
-		optionsSchema: Type.Object({}, closed)
+		optionsSchema: Type.Object({}, closed$1)
 	},
 	{
 		id: "relationPicker",
 		dataTypes: ["relation"],
-		optionsSchema: Type.Object({ allowInlineCreate: Type.Optional(Type.Boolean()) }, closed)
+		optionsSchema: Type.Object({ allowInlineCreate: Type.Optional(Type.Boolean()) }, closed$1)
 	},
 	{
 		id: "componentEditor",
 		dataTypes: ["component"],
-		optionsSchema: Type.Object({ collapsed: Type.Optional(Type.Boolean()) }, closed)
+		optionsSchema: Type.Object({ collapsed: Type.Optional(Type.Boolean()) }, closed$1)
+	},
+	{
+		id: SEO_EDITOR_ID,
+		dataTypes: ["component"],
+		optionsSchema: Type.Object({}, closed$1),
+		supports: isSeoField
 	},
 	{
 		id: "dynamicZoneEditor",
 		dataTypes: ["dynamiczone"],
-		optionsSchema: Type.Object({ collapsed: Type.Optional(Type.Boolean()) }, closed)
+		optionsSchema: Type.Object({ collapsed: Type.Optional(Type.Boolean()) }, closed$1)
 	}
 ];
 const EDITOR_CATALOGUE = new Map(entries.map((entry) => [entry.id, entry]));
@@ -939,7 +950,10 @@ const RESERVED_TYPE_NAMES = [
 	"SnapshotChangeKind",
 	"SnapshotChangeLocale",
 	"SnapshotChangePage",
-	"SnapshotInfo"
+	"SnapshotInfo",
+	"SiteInfo",
+	"SiteSeoDefaults",
+	"SiteSeoLocale"
 ];
 /**
 * Model and component API keys the admin uses as static URL segments (`/content/new`,
@@ -973,7 +987,8 @@ const RESERVED_FIELD_API_KEYS = [
 const RESERVED_QUERY_NAMES = [
 	"_schemaVersion",
 	"_changes",
-	"_snapshot"
+	"_snapshot",
+	"_site"
 ];
 /** Every name a definition contributes to the GraphQL schema. */
 const generatedNames = (definition) => {
@@ -2344,6 +2359,272 @@ const plainTextToRichText = (text) => {
 	};
 };
 //#endregion
-export { API_KEY_PATTERN, BIGINTEGER_PATTERN, CANVAS_ELIGIBLE, CHANGE_KINDS, COMPONENT_TYPE_SUFFIXES, CUSTOM_EDITOR_ID_PATTERN, ComponentDefinitionInputSchema, ComponentDisplayInputSchema, DATA_TYPES, DATETIME_PATTERN, DATE_PATTERN, DECIMAL_PATTERN, DEFAULT_EDITORS, DEFINITION_KINDS, DefinitionInputSchema, EDITOR_CATALOGUE, EditorChoiceInputSchema, EnumValueSchema, 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, SETTINGS_SCHEMAS, SITES_DIRECTORY, SLUG_PATTERN, SORT_DIRECTIONS, STABLE_ID_PATTERN, STORAGE_FAMILY, STRIP_DEFAULT_COUNT, SchemaValidationError, TEXT_TITLE_FIELD_TYPES, TIME_PATTERN, TITLE_FIELD_TYPES, UID_PATTERN, UNIQUE_CAPABLE_DATA_TYPES, assignIds, canonicalJson, checkApiKeySyntax, checkDefaultValue, classifyChange, classifyChanges, classifyLocaleChange, collectionQueryName, createStableId, decideSync, diffDefinitions, effectiveLayout, effectiveTitleField, embeddedComponentIds, escapeHtml, findDependentModels, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isEmptyRichText, isModelDefinition, isStableId, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, richTextMediaIds, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
+//#region src/themes/tokens.ts
+/**
+* Admin themes (docs/plans/themes.md): a theme is a named, complete set of these tokens for a light variant, a
+* dark variant or both. One list, shared by the admin's stylesheets (and their tests) and the API, which
+* validates themes declared by extensions (`shapio.config` `themes`).
+*/
+/** The UI tokens: every theme variant sets all of them. */
+const THEME_SEMANTIC_TOKENS = [
+	"background",
+	"foreground",
+	"card",
+	"card-foreground",
+	"popover",
+	"popover-foreground",
+	"primary",
+	"primary-foreground",
+	"primary-hover",
+	"secondary",
+	"secondary-foreground",
+	"muted",
+	"muted-foreground",
+	"accent",
+	"accent-foreground",
+	"destructive",
+	"destructive-foreground",
+	"destructive-muted",
+	"success",
+	"success-muted",
+	"warning",
+	"warning-muted",
+	"info",
+	"info-muted",
+	"border",
+	"input",
+	"ring",
+	"link",
+	"overlay",
+	"sidebar",
+	"sidebar-foreground",
+	"sidebar-primary",
+	"sidebar-primary-foreground",
+	"sidebar-accent",
+	"sidebar-accent-foreground",
+	"sidebar-border",
+	"sidebar-ring"
+];
+/**
+* The logo (tile, S, letters) and the signed-out screens' brand panel. Built-in themes set them all; an
+* extension theme may leave them out and gets Shapio's for that variant.
+*/
+const THEME_BRAND_TOKENS = [
+	"brand-logo",
+	"brand-logo-foreground",
+	"brand-letters",
+	"brand-panel-from",
+	"brand-panel-to",
+	"brand-panel-foreground",
+	"brand-panel-mark"
+];
+const THEME_TOKENS = [...THEME_SEMANTIC_TOKENS, ...THEME_BRAND_TOKENS];
+const THEME_VARIANTS = ["light", "dark"];
+/** A theme key: used in `data-theme` and in CSS selectors, so deliberately narrow. */
+const THEME_KEY_PATTERN = /^[a-z][a-z0-9-]{0,40}$/;
+/** The themes the admin ships; an extension theme may not reuse these keys. */
+const BUILT_IN_THEME_KEYS = [
+	"shapio",
+	"classic",
+	"murdered-out",
+	"forest",
+	"snowed",
+	"butter"
+];
+/**
+* A token value an extension may use: a hex colour or a colour function whose arguments are numbers, units
+* and separators only (no `;`, quotes, braces or nested functions such as `url()` or `var()`), so a value
+* can never escape its declaration.
+*/
+const THEME_COLOUR_PATTERN = /^(?:#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})|(?:rgba?|hsla?|oklch|oklab)\([0-9a-z.,%\s/+-]{1,80}\))$/;
+//#endregion
+//#region src/themes/contrast.ts
+const SURFACES = [
+	"background",
+	"card",
+	"popover"
+];
+const THEME_TEXT_PAIRS = [
+	...SURFACES.map((surface) => ["foreground", surface]),
+	...[
+		...SURFACES,
+		"muted",
+		"secondary",
+		"accent",
+		"sidebar"
+	].map((surface) => ["muted-foreground", surface]),
+	["primary-foreground", "primary"],
+	["primary-foreground", "primary-hover"],
+	["secondary-foreground", "secondary"],
+	["accent-foreground", "accent"],
+	["destructive-foreground", "destructive"],
+	["destructive", "background"],
+	["destructive", "card"],
+	["success", "background"],
+	["success", "card"],
+	["success", "success-muted"],
+	["warning", "warning-muted"],
+	["warning", "card"],
+	["info", "info-muted"],
+	["info", "card"],
+	["destructive", "destructive-muted"],
+	["foreground", "muted"],
+	["link", "background"],
+	["link", "card"],
+	["sidebar-foreground", "sidebar"],
+	["sidebar-primary-foreground", "sidebar-primary"],
+	["sidebar-accent-foreground", "sidebar-accent"],
+	["sidebar-foreground", "sidebar-accent"],
+	["muted-foreground", "sidebar-accent"],
+	...[
+		"destructive",
+		"success",
+		"warning",
+		"link"
+	].flatMap((text) => [[text, "popover"], [text, "muted"]]),
+	["brand-panel-foreground", "brand-panel-from"],
+	["brand-panel-foreground", "brand-panel-to"]
+];
+const THEME_UI_PAIRS = [
+	...[
+		...SURFACES,
+		"muted",
+		"secondary"
+	].map((surface) => ["input", surface]),
+	...SURFACES.map((surface) => ["ring", surface]),
+	["ring", "muted"],
+	["ring", "accent"],
+	["primary", "background"],
+	["primary", "card"],
+	["primary", "popover"],
+	["primary", "muted"],
+	["info", "muted"],
+	["sidebar-ring", "sidebar"],
+	["sidebar-primary", "sidebar"],
+	["sidebar-primary", "sidebar-accent"]
+];
+/**
+* Dark only: control borders on the selection surface. In light, selected table rows use accent/40, which
+* passes, and other selected surfaces hold no controls.
+*/
+const THEME_DARK_UI_PAIRS = [["input", "accent"]];
+const HEX = /^#[0-9a-fA-F]{6}$/;
+const channel = (value) => {
+	const c = value / 255;
+	return c <= .03928 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
+};
+const luminance = (hex) => {
+	const [r, g, b] = [
+		1,
+		3,
+		5
+	].map((index) => channel(parseInt(hex.slice(index, index + 2), 16)));
+	return .2126 * (r ?? 0) + .7152 * (g ?? 0) + .0722 * (b ?? 0);
+};
+/** The WCAG contrast ratio of two `#rrggbb` colours. */
+const contrastRatio = (a, b) => {
+	const [high = 0, low = 0] = [luminance(a), luminance(b)].sort((x, y) => y - x);
+	return (high + .05) / (low + .05);
+};
+/** Every pair the variant must meet, with its ratio. Missing tokens report an undefined ratio. */
+const checkThemeContrast = (tokens, variant) => {
+	const uiPairs = variant === "dark" ? [...THEME_UI_PAIRS, ...THEME_DARK_UI_PAIRS] : THEME_UI_PAIRS;
+	const measure = ([foreground, background], required) => {
+		const a = tokens[foreground];
+		const b = tokens[background];
+		return {
+			foreground,
+			background,
+			required,
+			ratio: a && b && HEX.test(a) && HEX.test(b) ? contrastRatio(a, b) : void 0
+		};
+	};
+	return [...THEME_TEXT_PAIRS.map((pair) => measure(pair, 4.5)), ...uiPairs.map((pair) => measure(pair, 3))];
+};
+//#endregion
+//#region src/seo/definition.ts
+/**
+* The built-in SEO component as first created. All fields are public and none has a length limit: the 70 and
+* 160 character marks are admin-only counters (`SEO_TITLE_SOFT_MAX`), never validation.
+*/
+const seoComponentDefinition = () => normalizeDefinition({
+	id: SEO_COMPONENT_ID,
+	kind: "component",
+	apiKey: "seo",
+	label: "SEO",
+	description: "Search and social metadata: title, description, image, canonical URL and indexing.",
+	category: "Built-in",
+	icon: "search",
+	fields: [
+		{
+			id: SEO_FIELD_IDS.title,
+			apiKey: "title",
+			label: "Title",
+			type: "string"
+		},
+		{
+			id: SEO_FIELD_IDS.description,
+			apiKey: "description",
+			label: "Description",
+			type: "text"
+		},
+		{
+			id: SEO_FIELD_IDS.image,
+			apiKey: "image",
+			label: "Social image",
+			type: "media",
+			settings: {
+				multiple: false,
+				allowedKinds: ["image"]
+			}
+		},
+		{
+			id: SEO_FIELD_IDS.canonical,
+			apiKey: "canonical",
+			label: "Canonical URL",
+			type: "url",
+			settings: { protocols: ["https", "http"] }
+		},
+		{
+			id: SEO_FIELD_IDS.noindex,
+			apiKey: "noindex",
+			label: "Hide from search engines",
+			type: "boolean"
+		}
+	],
+	display: { titleFieldId: SEO_FIELD_IDS.title }
+});
+//#endregion
+//#region src/seo/defaults.ts
+const closed = { additionalProperties: false };
+/** Media asset IDs are UUIDs. */
+const ASSET_ID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+/** One locale's default texts. Every key is optional: a missing one falls back along the locale chain. */
+const SeoLocaleDefaultsSchema = Type.Object({
+	siteName: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 200
+	})),
+	titleTemplate: Type.Optional(Type.String({
+		minLength: 2,
+		maxLength: 200,
+		pattern: SEO_TITLE_TEMPLATE_PATTERN.source
+	})),
+	description: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 1e3
+	}))
+}, closed);
+/**
+* A site's SEO defaults (`sites.seo_defaults`): texts per locale code, the default social image (a public
+* image asset of the same site) and the Twitter handle for the whole site.
+*/
+const SeoDefaultsSchema = Type.Object({
+	locales: Type.Record(Type.String({ pattern: LOCALE_CODE_PATTERN.source }), SeoLocaleDefaultsSchema, { additionalProperties: false }),
+	imageId: Type.Union([Type.String({ pattern: ASSET_ID_PATTERN.source }), Type.Null()]),
+	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, 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, EditorChoiceInputSchema, EnumValueSchema, 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, effectiveLayout, effectiveTitleField, embeddedComponentIds, escapeHtml, findDependentModels, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isEmptyRichText, isModelDefinition, isSeoField, isStableId, isValidTitleTemplate, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, resolveSeo, richTextMediaIds, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, seoComponentDefinition, seoDefaultsForLocale, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
 
 //# sourceMappingURL=index.js.map