@shapio/schema 0.2.1 → 0.3.1

package/dist/index.d.ts

@@ -941,10 +941,37 @@ export declare const sha256: (text: string) => Promise<string>;
 /** Hash of a normalized definition's canonical serialization; recorded per model in the lock file. */
 export declare const hashDefinition: (definition: SchemaDefinition) => Promise<string>;
 //#endregion
+//#region src/fileFormat/layout.d.ts
+/**
+ * Where schema files live in a repository (plan site-schema): shared definitions in `models/` and
+ * `components/`, a site's own in `sites/<siteKey>/models/` and `sites/<siteKey>/components/`. Paths are
+ * relative to the schema directory and always use `/` (git paths); callers join them for their file system.
+ */
+export declare const SCHEMA_KIND_DIRECTORIES: readonly ["models", "components"];
+export type SchemaKindDirectory = (typeof SCHEMA_KIND_DIRECTORIES)[number];
+/** The folder that holds one directory per site key. */
+export declare const SITES_DIRECTORY = "sites";
+/** The directory of a scope's files: `''` (shared) or `sites/<siteKey>`. */
+export declare const scopeDirectory: (siteKey: string | null) => string;
+/** A definition's file path: `models/post.json`, or `sites/blog/models/post.json` for site `blog`. */
+export declare const schemaFilePath: (definition: Pick<SchemaDefinition, "kind" | "apiKey">, siteKey: string | null) => string;
+/**
+ * The scope a schema file path is in: `{ site: null }` for `models/x.json` or `components/x.json`,
+ * `{ site: key }` under `sites/<key>/`, undefined for anything else (not a schema file).
+ */
+export declare const scopeOfSchemaFilePath: (path: string) => {
+  site: string | null;
+} | undefined;
+//#endregion
 //#region src/fileFormat/lockFile.d.ts
 /** Where `shapio schema pull` keeps its record of what it pulled, relative to the project root. */
 export declare const LOCK_FILE_PATH = ".shapio/schema-lock.json";
-export declare const LOCK_FILE_FORMAT_VERSION = 1;
+/**
+ * Format 2 (per-site schemas): each entry records its scope (`site`: a site key, or null when shared) and
+ * the lock lists the sites the tree covers. Format 1 (every definition shared) still reads: its entries
+ * have no `site`, which means shared, and it covers no site. `upgradeLockFile` spells both the same way.
+ */
+export declare const LOCK_FILE_FORMAT_VERSION = 2;
 export declare const LockEntrySchema: Type.TObject<{
   kind: Type.TEnum<["collection", "singleton", "component"]>;
   apiKey: Type.TString;
@@ -952,11 +979,18 @@ export declare const LockEntrySchema: Type.TObject<{
   version: Type.TInteger;
   /** `hashDefinition` of the pulled definition; a local file with another hash has been edited. */
   hash: Type.TString;
+  /**
+   * The key of the site the definition belongs to; null (or absent, format 1) when shared. Null comes first:
+   * Fastify's Ajv coerces types, and a string branch tried first would turn null into "" (no site at all).
+   */
+  site: Type.TOptional<Type.TUnion<[Type.TNull, Type.TString]>>;
 }>;
 export declare const LockFileSchema: Type.TObject<{
-  formatVersion: Type.TLiteral<1>;
+  formatVersion: Type.TUnion<[Type.TLiteral<1>, Type.TLiteral<2>]>;
   /** The instance's global schema version at pull time (informational; the guard is per model). */
   schemaVersion: Type.TInteger;
+  /** Keys of the sites whose definitions this tree holds (format 2; absent: none, shared only). */
+  sites: Type.TOptional<Type.TArray<Type.TString>>;
   /** Keyed by definition ID. */
   definitions: Type.TRecord<"^.*$", Type.TObject<{
     kind: Type.TEnum<["collection", "singleton", "component"]>;
@@ -965,10 +999,49 @@ export declare const LockFileSchema: Type.TObject<{
     version: Type.TInteger;
     /** `hashDefinition` of the pulled definition; a local file with another hash has been edited. */
     hash: Type.TString;
+    /**
+     * The key of the site the definition belongs to; null (or absent, format 1) when shared. Null comes first:
+     * Fastify's Ajv coerces types, and a string branch tried first would turn null into "" (no site at all).
+     */
+    site: Type.TOptional<Type.TUnion<[Type.TNull, Type.TString]>>;
   }>>;
 }>;
 export type LockEntry = Static<typeof LockEntrySchema>;
 export type LockFile = Static<typeof LockFileSchema>;
+/** A lock in format 2 with every scope spelled out. */
+export type ScopedLockEntry = LockEntry & {
+  site: string | null;
+};
+export type ScopedLockFile = Omit<LockFile, 'formatVersion' | 'sites' | 'definitions'> & {
+  formatVersion: typeof LOCK_FILE_FORMAT_VERSION;
+  sites: string[];
+  definitions: Record<string, ScopedLockEntry>;
+};
+/** Format 1 or 2 → format 2: absent scopes are shared, absent sites none. */
+export declare const upgradeLockFile: (lock: LockFile) => ScopedLockFile;
+/** The lock entries one site's tree is about: the shared definitions and that site's (`siteKey`). */
+export declare const lockEntriesForSite: (lock: LockFile, siteKey: string | null) => LockFile["definitions"];
+/** A tree applies to a site when it covers no site yet (shared only, or format 1) or lists that site. */
+export declare const lockCoversSite: (lock: LockFile, siteKey: string) => boolean;
+/** `sites` plus `siteKey`, sorted and without duplicates (stable diffs in git). */
+export declare const withSiteCovered: (sites: readonly string[], siteKey: string) => string[];
+/**
+ * The lock after pulling one site's view (`shapio schema pull --site <siteKey>`): the shared entries and that
+ * site's are replaced by what was pulled, another site's entries are kept as they are (one tree can hold
+ * several sites), and the tree now covers `siteKey`. A format 1 lock upgrades first (every entry shared).
+ */
+export declare const mergePulledLock: (lock: LockFile | undefined, pulled: {
+  schemaVersion: number;
+  siteKey: string;
+  definitions: readonly ExportedDefinition[];
+}) => ScopedLockFile;
+/** One definition as `schema export` returns it, with its scope (a site key, or null when shared). */
+export type ExportedDefinition = {
+  definition: SchemaDefinition;
+  version: number;
+  hash: string;
+  site: string | null;
+};
 export declare class LockFileError extends Error {
   constructor(message: string);
 }
@@ -1078,5 +1151,62 @@ export declare const richTextToPlainText: (document: RichTextDocument) => string
 /** Plain text → a document of paragraphs (blank lines split paragraphs; single newlines are hard breaks). */
 export declare const plainTextToRichText: (text: string) => RichTextDocument;
 //#endregion
+//#region src/themes/tokens.d.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. */
+export declare const THEME_SEMANTIC_TOKENS: readonly ["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.
+ */
+export declare const THEME_BRAND_TOKENS: readonly ["brand-logo", "brand-logo-foreground", "brand-letters", "brand-panel-from", "brand-panel-to", "brand-panel-foreground", "brand-panel-mark"];
+export declare const THEME_TOKENS: readonly ["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", "brand-logo", "brand-logo-foreground", "brand-letters", "brand-panel-from", "brand-panel-to", "brand-panel-foreground", "brand-panel-mark"];
+export type ThemeToken = (typeof THEME_TOKENS)[number];
+export declare const THEME_VARIANTS: readonly ["light", "dark"];
+export type ThemeVariant = (typeof THEME_VARIANTS)[number];
+/** A theme key: used in `data-theme` and in CSS selectors, so deliberately narrow. */
+export declare const THEME_KEY_PATTERN: RegExp;
+/** The themes the admin ships; an extension theme may not reuse these keys. */
+export declare const BUILT_IN_THEME_KEYS: readonly ["shapio", "classic", "murdered-out", "snowed"];
+export type BuiltInThemeKey = (typeof BUILT_IN_THEME_KEYS)[number];
+/**
+ * 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.
+ */
+export declare const THEME_COLOUR_PATTERN: RegExp;
+//#endregion
+//#region src/themes/contrast.d.ts
+/**
+ * WCAG 2.1 AA contrast of a theme's tokens: text pairs need 4.5:1 (1.4.3); what identifies a control or the
+ * focus (input borders, unchecked switches, focus rings, primary buttons against the page) needs 3:1 (1.4.11).
+ * The admin's built-in themes are gated on this by a unit test; extension themes get warnings from
+ * `shapio extensions check`. axe checks rendered text only, not these pairs.
+ */
+export type ContrastPair = readonly [foreground: string, background: string];
+export declare const THEME_TEXT_PAIRS: readonly ContrastPair[];
+export declare const THEME_UI_PAIRS: readonly ContrastPair[];
+/**
+ * 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.
+ */
+export declare const THEME_DARK_UI_PAIRS: readonly ContrastPair[];
+/** The WCAG contrast ratio of two `#rrggbb` colours. */
+export declare const contrastRatio: (a: string, b: string) => number;
+export type ContrastCheck = {
+  foreground: string;
+  background: string;
+  /** 4.5 for text, 3 for controls. */
+  required: number;
+  /** Undefined when a value is not a `#rrggbb` colour (functions such as `oklch()` are not checked). */
+  ratio: number | undefined;
+};
+/** Every pair the variant must meet, with its ratio. Missing tokens report an undefined ratio. */
+export declare const checkThemeContrast: (tokens: Readonly<Record<string, string>>, variant: ThemeVariant) => ContrastCheck[];
+//#endregion
 export { RichTextDocument, RichTextNode, RichTextProblem, RichTextResult, isEmptyRichText, richTextMediaIds, validateRichText };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2058,25 +2058,106 @@ const sha256 = async (text) => `sha256:${toHex(await globalThis.crypto.subtle.di
 /** Hash of a normalized definition's canonical serialization; recorded per model in the lock file. */
 const hashDefinition = (definition) => sha256(serializeDefinition(definition));
 //#endregion
+//#region src/fileFormat/layout.ts
+/**
+* Where schema files live in a repository (plan site-schema): shared definitions in `models/` and
+* `components/`, a site's own in `sites/<siteKey>/models/` and `sites/<siteKey>/components/`. Paths are
+* relative to the schema directory and always use `/` (git paths); callers join them for their file system.
+*/
+const SCHEMA_KIND_DIRECTORIES = ["models", "components"];
+/** The folder that holds one directory per site key. */
+const SITES_DIRECTORY = "sites";
+const kindDirectoryOf = (definition) => definition.kind === "component" ? "components" : "models";
+/** The directory of a scope's files: `''` (shared) or `sites/<siteKey>`. */
+const scopeDirectory = (siteKey) => siteKey === null ? "" : `${SITES_DIRECTORY}/${siteKey}`;
+/** A definition's file path: `models/post.json`, or `sites/blog/models/post.json` for site `blog`. */
+const schemaFilePath = (definition, siteKey) => {
+	const file = `${kindDirectoryOf(definition)}/${definition.apiKey}.json`;
+	return siteKey === null ? file : `${scopeDirectory(siteKey)}/${file}`;
+};
+/**
+* The scope a schema file path is in: `{ site: null }` for `models/x.json` or `components/x.json`,
+* `{ site: key }` under `sites/<key>/`, undefined for anything else (not a schema file).
+*/
+const scopeOfSchemaFilePath = (path) => {
+	const parts = path.split("/").filter((part) => part.length > 0);
+	const isFile = (kind, name) => SCHEMA_KIND_DIRECTORIES.includes(kind ?? "") && (name ?? "").endsWith(".json");
+	if (parts.length === 2 && isFile(parts[0], parts[1])) return { site: null };
+	if (parts.length === 4 && parts[0] === "sites" && parts[1] && isFile(parts[2], parts[3])) return { site: parts[1] };
+};
+//#endregion
 //#region src/fileFormat/lockFile.ts
 /** Where `shapio schema pull` keeps its record of what it pulled, relative to the project root. */
 const LOCK_FILE_PATH = ".shapio/schema-lock.json";
-const LOCK_FILE_FORMAT_VERSION = 1;
+/**
+* Format 2 (per-site schemas): each entry records its scope (`site`: a site key, or null when shared) and
+* the lock lists the sites the tree covers. Format 1 (every definition shared) still reads: its entries
+* have no `site`, which means shared, and it covers no site. `upgradeLockFile` spells both the same way.
+*/
+const LOCK_FILE_FORMAT_VERSION = 2;
 const LockEntrySchema = Type.Object({
 	kind: Type.Enum(DEFINITION_KINDS),
 	apiKey: Type.String(),
 	/** The definition's per-model version on the instance when it was pulled. */
 	version: Type.Integer({ minimum: 1 }),
 	/** `hashDefinition` of the pulled definition; a local file with another hash has been edited. */
-	hash: Type.String()
+	hash: Type.String(),
+	/**
+	* The key of the site the definition belongs to; null (or absent, format 1) when shared. Null comes first:
+	* Fastify's Ajv coerces types, and a string branch tried first would turn null into "" (no site at all).
+	*/
+	site: Type.Optional(Type.Union([Type.Null(), Type.String()]))
 }, { additionalProperties: false });
 const LockFileSchema = Type.Object({
-	formatVersion: Type.Literal(1),
+	formatVersion: Type.Union([Type.Literal(1), Type.Literal(2)]),
 	/** The instance's global schema version at pull time (informational; the guard is per model). */
 	schemaVersion: Type.Integer({ minimum: 0 }),
+	/** Keys of the sites whose definitions this tree holds (format 2; absent: none, shared only). */
+	sites: Type.Optional(Type.Array(Type.String())),
 	/** Keyed by definition ID. */
 	definitions: Type.Record(Type.String(), LockEntrySchema)
 }, { additionalProperties: false });
+/** Format 1 or 2 → format 2: absent scopes are shared, absent sites none. */
+const upgradeLockFile = (lock) => ({
+	formatVersion: 2,
+	schemaVersion: lock.schemaVersion,
+	sites: [...lock.sites ?? []],
+	definitions: Object.fromEntries(Object.entries(lock.definitions).map(([id, entry]) => [id, {
+		...entry,
+		site: entry.site ?? null
+	}]))
+});
+/** The lock entries one site's tree is about: the shared definitions and that site's (`siteKey`). */
+const lockEntriesForSite = (lock, siteKey) => Object.fromEntries(Object.entries(lock.definitions).filter(([, entry]) => (entry.site ?? null) === null || entry.site === siteKey));
+/** A tree applies to a site when it covers no site yet (shared only, or format 1) or lists that site. */
+const lockCoversSite = (lock, siteKey) => {
+	const sites = lock.sites ?? [];
+	return sites.length === 0 || sites.includes(siteKey);
+};
+/** `sites` plus `siteKey`, sorted and without duplicates (stable diffs in git). */
+const withSiteCovered = (sites, siteKey) => [.../* @__PURE__ */ new Set([...sites, siteKey])].sort();
+/**
+* The lock after pulling one site's view (`shapio schema pull --site <siteKey>`): the shared entries and that
+* site's are replaced by what was pulled, another site's entries are kept as they are (one tree can hold
+* several sites), and the tree now covers `siteKey`. A format 1 lock upgrades first (every entry shared).
+*/
+const mergePulledLock = (lock, pulled) => {
+	const current = lock ? upgradeLockFile(lock) : void 0;
+	const pulledIds = new Set(pulled.definitions.map(({ definition }) => definition.id));
+	const kept = Object.entries(current?.definitions ?? {}).filter(([id, entry]) => entry.site !== null && entry.site !== pulled.siteKey && !pulledIds.has(id));
+	return {
+		formatVersion: 2,
+		schemaVersion: pulled.schemaVersion,
+		sites: withSiteCovered(current?.sites ?? [], pulled.siteKey),
+		definitions: Object.fromEntries([...kept, ...pulled.definitions.map(({ definition, version, hash, site }) => [definition.id, {
+			kind: definition.kind,
+			apiKey: definition.apiKey,
+			version,
+			hash,
+			site
+		}])])
+	};
+};
 var LockFileError = class extends Error {
 	constructor(message) {
 		super(message);
@@ -2263,6 +2344,187 @@ 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, SETTINGS_SCHEMAS, 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, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, richTextMediaIds, richTextToPlainText, routeKeyOf, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, validateDefinition, validateRichText, validateSchema, withDerivedPlural };
+//#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",
+	"snowed"
+];
+/**
+* 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
+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, 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, 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, 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, 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 };
 
 //# sourceMappingURL=index.js.map