@contentrain/astro-kit 0.4.0 → 0.6.0

package/components/testimonial/Testimonial.astro

@@ -5,13 +5,15 @@
 import { tv } from 'tailwind-variants'
 import KitImage from '../_shared/KitImage.astro'
 import Section from '../_shared/Section.astro'
-import type { ImageInput } from '../_shared/types'
+import { imageOf, type ImageSource } from '../_shared/image'
 
 export interface TestimonialItem {
   quote: string
   name: string
   role?: string | undefined
-  avatar?: ImageInput | undefined
+  /** The portrait's address (or, until 0.7, an `ImageInput`). */
+  avatar?: ImageSource | undefined
+  avatarAlt?: string | undefined
 }
 
 const testimonial = tv({
@@ -57,7 +59,7 @@ const headingId = heading && id ? `${id}-title` : undefined
         <figure class={s.card()}>
           <blockquote class={s.quote()}><p>“{item.quote}”</p></blockquote>
           <figcaption class={s.person()}>
-            {item.avatar && <KitImage image={item.avatar} sizes="48px" class="size-12 shrink-0 rounded-full object-cover" />}
+            {imageOf(item.avatar, item.avatarAlt) && <KitImage image={imageOf(item.avatar, item.avatarAlt)!} sizes="48px" class="size-12 shrink-0 rounded-full object-cover" />}
             <span class="flex flex-col text-left">
               <span class={s.name()}>{item.name}</span>
               {item.role && <span class={s.role()}>{item.role}</span>}

package/components/testimonial/meta.json

@@ -7,6 +7,7 @@
   "shared": [
     "KitImage.astro",
     "Section.astro",
+    "image.ts",
     "types.ts"
   ],
   "variants": {
@@ -32,39 +33,37 @@
   "props": {
     "items": {
       "type": "array",
+      "label": "Testimonials",
       "required": true,
       "items": {
         "type": "object",
         "fields": {
           "quote": {
             "type": "text",
-            "required": true
+            "label": "Quote",
+            "required": true,
+            "description": "What the person said, in their words."
           },
           "name": {
             "type": "string",
-            "required": true
+            "label": "Name",
+            "required": true,
+            "description": "Who said it."
           },
           "role": {
-            "type": "string"
+            "type": "string",
+            "label": "Role",
+            "description": "Their role or company."
           },
           "avatar": {
-            "type": "object",
-            "fields": {
-              "src": {
-                "type": "image",
-                "required": true
-              },
-              "alt": {
-                "type": "string",
-                "required": true
-              },
-              "width": {
-                "type": "integer"
-              },
-              "height": {
-                "type": "integer"
-              }
-            }
+            "type": "image",
+            "label": "Photo",
+            "description": "Their photo."
+          },
+          "avatarAlt": {
+            "type": "string",
+            "label": "Photo description",
+            "description": "Who the photo shows; usually their name."
           }
         }
       },
@@ -72,10 +71,12 @@
     },
     "heading": {
       "type": "string",
+      "label": "Heading",
       "description": "Section heading above the quotes."
     },
     "id": {
       "type": "string",
+      "content": false,
       "description": "Anchor id of the section; the heading gets `<id>-title`."
     }
   },

package/dist/index.d.mts

@@ -18,7 +18,26 @@ type KitCategory = 'chrome' | 'section' | 'content' | 'primitive';
 type KitJs = 'none' | 'vanilla' | 'embla' | 'zag' | 'studio';
 type KitProp = FieldDef & {
   description: string;
+  /**
+   * `false`: a setting the plan or writer passes (heading level, a label from `ui:`, an anchor id), not page
+   * content. A section's page-singleton field holds only the other props, its content props.
+   */
+  content?: false;
 };
+/**
+ * A content prop's name: camelCase, a capital only to start a word (`imageAlt`, not `imageURL`), so it
+ * turns into exactly one Contentrain field name.
+ */
+declare const CONTENT_PROP_NAME: RegExp;
+/**
+ * The page-singleton field a content prop is stored in (DECISIONS §7b): the prop name in snake_case, as
+ * Contentrain field names are (`ctaLabel` → `cta_label`). The view passes each prop from its field.
+ */
+declare const contentFieldName: (prop: string) => string;
+/** The props a section's page-singleton field holds: all but the settings. */
+declare function contentProps(component: KitComponentMeta): Record<string, KitProp>;
+/** A content prop path as its page-singleton field path: every name in it through `contentFieldName`. */
+declare function contentFieldPath(path: string): string;
 interface KitVariant {
   options: string[];
   default: string;
@@ -45,6 +64,19 @@ interface KitComponentMeta {
   sources: Partial<Record<KitBuilder, string[]>>;
   /** How it meets its accessibility pattern. */
   a11y: string;
+  /**
+   * Sections only: the section's shape in a few words and the signals that show it in a source page, a
+   * closed-set label for the classifier and the migration architect (`image beside heading + text`).
+   */
+  pattern?: {
+    summary: string;
+    signals: string[];
+  };
+  /**
+   * Sections only, written by the catalog build: each content prop path (`slides[].ctaLabel`) → the
+   * page-singleton field path that holds it (`slides[].cta_label`).
+   */
+  contentFields?: Record<string, string>;
 }
 /** A catalog entry: the meta plus the files that make the component. */
 interface KitComponent extends KitComponentMeta {
@@ -103,10 +135,91 @@ interface MappingTable {
    */
   defaults?: Record<string, Record<string, string | number | boolean>>;
   rules: MappingRule[];
+  /**
+   * Section rules: what a whole section of a page (an Elementor container, a Gutenberg group or columns,
+   * a Divi section — facts `sections[]`) becomes, tried top to bottom before any element rule. The first
+   * that matches wins; a section none matches falls through to the element `rules` inside it.
+   */
+  sections?: SectionRule[];
+}
+/**
+ * A named group of a section's leaves: every leaf named `match` (and carrying `attr`) up to `max` of them.
+ * `attr` values may list alternatives with `|` (`{ header_size: 'h1|h2' }`).
+ */
+interface SectionSlot {
+  match: string | string[];
+  attr?: Record<string, string | number | boolean>;
+  /** At least this many leaves (default 0). */
+  min?: number;
+  /** At most this many (default unbounded). */
+  max?: number;
+}
+/**
+ * One section pattern. Values are the table's expressions, prefixed `@<slot> ` to read a slot's leaf
+ * (`@title attr:title`); `a || b` takes the first non-empty (builder data first, rendered markup as fallback).
+ * A slot of several leaves joins their text into a markdown prop; any other prop reads its first leaf.
+ * A value without a slot reads the section's own root (a cover's background image, a container's setting).
+ */
+interface SectionRule {
+  /** Stable id (`hero.split`, `card-grid.icon-box`): plans record `<builder>:section:<id>`; JEW chooses among them. */
+  id: string;
+  component: string;
+  variant?: Record<string, string>;
+  when?: {
+    /** Where on the page: `first` is the page's first section, `last` its last. */position?: 'first' | 'last' | 'any'; /** Column count(s) the section must have. */
+    columns?: number | number[]; /** Every leaf must fall into a slot (default true); false lets unclaimed leaves be. */
+    only?: boolean; /** `columns`: each column must match the slots on its own (a row of team members, price plans). */
+    repeat?: 'columns'; /** The section's root element(s): `core/cover`, `core/media-text` (a loose run of blocks is `run`). */
+    root?: string | string[];
+  };
+  /**
+   * Named leaf groups. Each leaf, in document order, goes to the first declared slot that matches it and
+   * still has room, so declare a specific slot (an `attr` filter) before a general one on the same element.
+   */
+  slots: Record<string, SectionSlot>;
+  props?: Record<string, string>;
+  /**
+   * Array prop filled once per `each`: a slot's leaves (`@card`), the parts a selector finds inside them
+   * (`@list figure.wp-block-image`, `@faq .elementor-accordion-item`: a gallery's images, an accordion's
+   * items), or the columns (`column`, with `repeat: 'columns'`).
+   */
+  into?: string;
+  each?: string;
+  /** One array item: relative to the leaf (`each: '@slot'`) or to the column, where `@<slot>` is that column's slot. */
+  item?: Record<string, string>;
+}
+/** A section leaf as the fact pack gives it: a builder element with its `blocks:` path. */
+interface SectionLeaf extends MappingNode {
+  path: string;
 }
+/** Where a section sits (facts `index`/`count`) and what it is (`root`: facts `root`). */
+interface SectionMeta {
+  index: number;
+  count: number;
+  root?: string | undefined;
+}
+/** Leaf paths per slot; with `repeat: 'columns'`, also per column. */
+interface SectionMatch {
+  slots: Record<string, string[]>;
+  columns?: Record<string, string[]>[];
+}
+/** The id a plan records for a section rule. */
+declare function sectionRuleId(builder: KitBuilder, rule: Pick<SectionRule, 'id'>): string;
+/**
+ * Whether a section rule fits a section, and which leaves fill which slot. `columns` are the section's
+ * columns left to right, each its leaves in document order (layout containers already opened).
+ */
+declare function matchSection(rule: SectionRule, columns: SectionLeaf[][], meta: SectionMeta, defaults?: MappingTable['defaults']): SectionMatch | null;
+/** The first section rule of a table that fits, with its match. */
+declare function classifySection(table: MappingTable, columns: SectionLeaf[][], meta: SectionMeta): {
+  rule: SectionRule;
+  match: SectionMatch;
+} | null;
+/** A section value: alternatives joined by ` || `, each an optional `@<slot> ` then a mapping value. Returns the slots it reads, or null when malformed. */
+declare function sectionValueSlots(value: string): string[] | null;
 /** Problems with a mapping table against the catalog, one line each; empty when it is sound. */
 declare function validateMapping(table: MappingTable, catalog: KitCatalog): string[];
-/** Catalog sources of a builder that no rule of its table matches. */
+/** Catalog sources of a builder that no rule of its table matches, as an element rule or a section slot. */
 declare function unmappedSources(table: MappingTable, catalog: KitCatalog): string[];
 /** Rules for an element, most specific (with `when` / qualifier) first. */
 declare function rulesFor(table: MappingTable, element: string): MappingRule[];
@@ -153,5 +266,5 @@ declare function loadMapping(builder: KitBuilder): Promise<MappingTable>;
 /** The published catalog (`catalog.json`). */
 declare function loadCatalog(): Promise<KitCatalog>;
 //#endregion
-export { BUILDER_PREFIX, CATALOG_FORMAT, CopyPlan, KIT_BUILDERS, KIT_COMPONENTS_DIR, KIT_DIR, KitBuilder, KitCatalog, KitCategory, KitComponent, KitComponentMeta, KitJs, KitProp, KitVariant, MAPPING_FORMAT, MAPPING_VALUE_PATTERN, MappingNode, MappingRule, MappingTable, attrsOf, claimMatches, componentsForSource, copyComponents, isBuilderElement, loadCatalog, loadMapping, planCopy, ruleMatches, rulesFor, unmappedSources, validateCatalog, validateMapping };
+export { BUILDER_PREFIX, CATALOG_FORMAT, CONTENT_PROP_NAME, CopyPlan, KIT_BUILDERS, KIT_COMPONENTS_DIR, KIT_DIR, KitBuilder, KitCatalog, KitCategory, KitComponent, KitComponentMeta, KitJs, KitProp, KitVariant, MAPPING_FORMAT, MAPPING_VALUE_PATTERN, MappingNode, MappingRule, MappingTable, SectionLeaf, SectionMatch, SectionMeta, SectionRule, SectionSlot, attrsOf, claimMatches, classifySection, componentsForSource, contentFieldName, contentFieldPath, contentProps, copyComponents, isBuilderElement, loadCatalog, loadMapping, matchSection, planCopy, ruleMatches, rulesFor, sectionRuleId, sectionValueSlots, unmappedSources, validateCatalog, validateMapping };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/catalog.ts","../src/mapping.ts","../src/copy.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/catalog.ts","../src/mapping.ts","../src/copy.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import { copyFile, mkdir, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { fieldDepth, sectionFieldName } from "@contentrain/types";
 //#region src/catalog.ts
 const CATALOG_FORMAT = "astro-kit-catalog@1";
 const KIT_BUILDERS = [
@@ -25,6 +26,33 @@ function isBuilderElement(builder, name) {
 	if (builder !== "gutenberg") return name.startsWith(BUILDER_PREFIX[builder]);
 	return /^[a-z0-9-]+\/[a-z0-9-]+(:[\w-]+)?$/.test(name) && !KIT_BUILDERS.some((b) => b !== "gutenberg" && name.startsWith(BUILDER_PREFIX[b]));
 }
+/**
+* A content prop's name: camelCase, a capital only to start a word (`imageAlt`, not `imageURL`), so it
+* turns into exactly one Contentrain field name.
+*/
+const CONTENT_PROP_NAME = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]+)*$/;
+/**
+* The page-singleton field a content prop is stored in (DECISIONS §7b): the prop name in snake_case, as
+* Contentrain field names are (`ctaLabel` → `cta_label`). The view passes each prop from its field.
+*/
+const contentFieldName = sectionFieldName;
+/** The props a section's page-singleton field holds: all but the settings. */
+function contentProps(component) {
+	return Object.fromEntries(Object.entries(component.props).filter(([, prop]) => prop.content !== false));
+}
+/** Fields under a field, by dotted path (`items[].imageAlt`). */
+function fieldsByPath(fields, prefix = "") {
+	const out = [];
+	for (const [name, field] of Object.entries(fields)) {
+		out.push([prefix + name, field], ...fieldsByPath(field.fields ?? {}, `${prefix}${name}.`));
+		if (typeof field.items === "object") out.push(...fieldsByPath(field.items.fields ?? {}, `${prefix}${name}[].`));
+	}
+	return out;
+}
+/** A content prop path as its page-singleton field path: every name in it through `contentFieldName`. */
+function contentFieldPath(path) {
+	return path.replace(/[A-Za-z0-9]+/g, contentFieldName);
+}
 /** Problems with a catalog, one line each; empty when it is sound. */
 function validateCatalog(catalog) {
 	const problems = [];
@@ -39,6 +67,20 @@ function validateCatalog(catalog) {
 			if (!prop.description) problems.push(`${at}: prop ${name} has no description`);
 			if (prop.type === "select" && !prop.options?.length) problems.push(`${at}: select prop ${name} has no options`);
 		}
+		if (c.category === "section") {
+			const content = contentProps(c);
+			const paths = fieldsByPath(content);
+			for (const [path, field] of paths) {
+				if (!CONTENT_PROP_NAME.test(path.split(/\.|\[\]\./).at(-1))) problems.push(`${at}: content prop ${path} must be camelCase with one capital per word (or content: false)`);
+				if (!field.label) problems.push(`${at}: content prop ${path} has no label`);
+				if (!field.description) problems.push(`${at}: content prop ${path} has no description`);
+			}
+			if (c.contentFields) {
+				const expected = Object.fromEntries(paths.map(([path]) => [path, contentFieldPath(path)]));
+				if (JSON.stringify(c.contentFields) !== JSON.stringify(expected)) problems.push(`${at}: contentFields is stale — rebuild the catalog`);
+			}
+			for (const [name, prop] of Object.entries(content)) if (1 + fieldDepth(prop) > 2) problems.push(`${at}: content prop ${name} nests objects deeper than a page singleton allows`);
+		}
 		for (const [builder, names] of Object.entries(c.sources)) {
 			const prefix = BUILDER_PREFIX[builder];
 			for (const name of names) if (!isBuilderElement(builder, name)) problems.push(`${at}: source "${name}" is not a ${builder} element (${prefix}…)`);
@@ -96,6 +138,77 @@ async function copyComponents(plan, kitRoot, siteRoot) {
 //#region src/mapping.ts
 const MAPPING_FORMAT = "astro-kit-mapping@1";
 const MAPPING_VALUE_PATTERN = /^(?:field:[\w-]+|media:[\w-]+|ref:[\w-]+\.[\w-]+|href:(?:self|[\w-]+)|term:[\w-]+|ui:[\w.-]+|const:(?:true|false|-?\d+(?:\.\d+)?|[a-z][a-z0-9_-]{0,31})|site:[\w-]+|menu:(?:primary|footer)|page:(?:base|current|total|breadcrumb)|attr:[\w.-]+|class:[\w*-]+=(?:[a-z][\w-]*)?\|(?:[a-z][\w-]*)?|(?:dom|img|link|html):[^@]*(?:@[\w-]+)?)$/;
+/** The id a plan records for a section rule. */
+function sectionRuleId(builder, rule) {
+	return `${builder}:section:${rule.id}`;
+}
+const SECTION_LAYOUT_LEAVES = new Set([
+	"elementor/spacer",
+	"elementor/divider",
+	"core/spacer",
+	"core/separator",
+	"divi/et_pb_divider"
+]);
+function slotFits(slot, leaf, defaults) {
+	if (![slot.match].flat().includes(leaf.name)) return false;
+	const attrs = attrsOf(leaf, defaults);
+	return Object.entries(slot.attr ?? {}).every(([key, want]) => String(want).split("|").includes(String(attrs[key])));
+}
+/** Assign leaves to slots in document order, each to the first declared slot with room; null when the rule does not fit. */
+function claimLeaves(rule, leaves, defaults) {
+	const claimed = Object.fromEntries(Object.keys(rule.slots).map((name) => [name, []]));
+	for (const leaf of leaves) {
+		if (SECTION_LAYOUT_LEAVES.has(leaf.name)) continue;
+		const slot = Object.entries(rule.slots).find(([name, def]) => claimed[name].length < (def.max ?? Infinity) && slotFits(def, leaf, defaults));
+		if (slot) claimed[slot[0]].push(leaf.path);
+		else if (rule.when?.only !== false) return null;
+	}
+	for (const [name, def] of Object.entries(rule.slots)) if (claimed[name].length < (def.min ?? 0)) return null;
+	return claimed;
+}
+/**
+* Whether a section rule fits a section, and which leaves fill which slot. `columns` are the section's
+* columns left to right, each its leaves in document order (layout containers already opened).
+*/
+function matchSection(rule, columns, meta, defaults) {
+	const when = rule.when ?? {};
+	if (when.root !== void 0 && !(meta.root !== void 0 && [when.root].flat().includes(meta.root))) return null;
+	if (when.position === "first" && meta.index !== 0) return null;
+	if (when.position === "last" && meta.index !== meta.count - 1) return null;
+	if (when.columns !== void 0 && ![when.columns].flat().includes(columns.length)) return null;
+	if (when.repeat === "columns") {
+		if (columns.length < 2) return null;
+		const per = columns.map((leaves) => claimLeaves(rule, leaves, defaults));
+		if (per.some((c) => !c)) return null;
+		return {
+			slots: Object.fromEntries(Object.keys(rule.slots).map((name) => [name, per.flatMap((c) => c[name])])),
+			columns: per
+		};
+	}
+	const slots = claimLeaves(rule, columns.flat(), defaults);
+	return slots && { slots };
+}
+/** The first section rule of a table that fits, with its match. */
+function classifySection(table, columns, meta) {
+	for (const rule of table.sections ?? []) {
+		const match = matchSection(rule, columns, meta, table.defaults);
+		if (match) return {
+			rule,
+			match
+		};
+	}
+	return null;
+}
+/** A section value: alternatives joined by ` || `, each an optional `@<slot> ` then a mapping value. Returns the slots it reads, or null when malformed. */
+function sectionValueSlots(value) {
+	const slots = [];
+	for (const alternative of value.split(" || ")) {
+		const m = /^(?:@([a-z][\w-]*) )?(.+)$/.exec(alternative);
+		if (!m || !MAPPING_VALUE_PATTERN.test(m[2])) return null;
+		if (m[1]) slots.push(m[1]);
+	}
+	return slots;
+}
 /** Problems with a mapping table against the catalog, one line each; empty when it is sound. */
 function validateMapping(table, catalog) {
 	const problems = [];
@@ -143,11 +256,70 @@ function validateMapping(table, catalog) {
 		const bound = new Set([...Object.keys(rule.props ?? {}), ...rule.into ? [rule.into] : Object.keys(rule.item ?? {})]);
 		for (const [prop, def] of Object.entries(c.props)) if (def.required && !bound.has(prop)) problems.push(`${at}: required prop ${c.id}.${prop} has no source`);
 	}
+	problems.push(...validateSections(table, components));
+	return problems;
+}
+function validateSections(table, components) {
+	const problems = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const rule of table.sections ?? []) {
+		const at = `${table.builder} section ${rule.id}`;
+		if (!/^[a-z][a-z0-9-]*(?:\.[a-z0-9-]+)*$/.test(rule.id)) problems.push(`${at}: id is not dotted kebab-case`);
+		if (seen.has(rule.id)) problems.push(`${at}: listed twice`);
+		seen.add(rule.id);
+		const c = components.get(rule.component);
+		if (!c) {
+			problems.push(`${at}: component ${rule.component} is not in the catalog`);
+			continue;
+		}
+		for (const [axis, value] of Object.entries(rule.variant ?? {})) if (!c.variants[axis]) problems.push(`${at}: ${c.id} has no variant axis ${axis}`);
+		else if (!c.variants[axis].options.includes(value)) problems.push(`${at}: ${c.id}.${axis} has no option ${value}`);
+		if (!Object.keys(rule.slots).length) problems.push(`${at}: no slots`);
+		for (const [name, slot] of Object.entries(rule.slots)) {
+			if (!/^[a-z][\w-]*$/.test(name)) problems.push(`${at}: slot ${name} is not an identifier`);
+			for (const element of [slot.match].flat()) if (!isBuilderElement(table.builder, element)) problems.push(`${at}: slot ${name} matches ${element}, not a ${table.builder} element`);
+			if (slot.min !== void 0 && slot.max !== void 0 && slot.min > slot.max) problems.push(`${at}: slot ${name} min > max`);
+		}
+		for (const root of [rule.when?.root ?? []].flat()) if (root !== "run" && !isBuilderElement(table.builder, root)) problems.push(`${at}: root ${root} is not a ${table.builder} element or run`);
+		if (rule.when?.repeat === "columns" && rule.each !== "column") problems.push(`${at}: repeat columns needs each: column`);
+		if (rule.each === "column" && rule.when?.repeat !== "columns") problems.push(`${at}: each column needs when.repeat columns`);
+		const readsSlots = (value, where, type, slotted) => {
+			const slots = sectionValueSlots(value);
+			if (!slots) {
+				problems.push(`${at}: ${where} = ${value} is not a section value`);
+				return;
+			}
+			if (!slotted && slots.length) problems.push(`${at}: ${where} reads a slot, but items of each ${rule.each} read their own leaf`);
+			for (const slot of slots) {
+				const def = rule.slots[slot];
+				if (!def) problems.push(`${at}: ${where} reads undeclared slot ${slot}`);
+				else if ((type === "string" || type === "text") && def.max !== 1) problems.push(`${at}: ${where} is ${type} but slot ${slot} may hold several leaves (max must be 1)`);
+			}
+		};
+		for (const [prop, value] of Object.entries(rule.props ?? {})) {
+			const def = c.props[prop];
+			if (!def) problems.push(`${at}: ${c.id} has no prop ${prop}`);
+			readsSlots(value, prop, def?.type, true);
+		}
+		if (rule.into) {
+			const target = c.props[rule.into];
+			if (!target || target.type !== "array") problems.push(`${at}: ${c.id}.${rule.into} is not an array prop`);
+			if (!rule.each) problems.push(`${at}: into ${rule.into} needs each`);
+			else if (rule.each !== "column" && !rule.slots[/^@([a-z][\w-]*)(?: \S.*)?$/.exec(rule.each)?.[1] ?? ""]) problems.push(`${at}: each ${rule.each} is not @<declared slot> [selector] or column`);
+			const fields = target && typeof target.items === "object" ? target.items.fields ?? {} : {};
+			for (const [field, value] of Object.entries(rule.item ?? {})) {
+				if (!fields[field]) problems.push(`${at}: ${c.id}.${rule.into}[] has no field ${field}`);
+				readsSlots(value, `${rule.into}[].${field}`, fields[field]?.type, rule.each === "column");
+			}
+		} else if (rule.item || rule.each) problems.push(`${at}: each/item without into`);
+		const bound = new Set([...Object.keys(rule.props ?? {}), ...rule.into ? [rule.into] : []]);
+		for (const [prop, def] of Object.entries(c.props)) if (def.required && !bound.has(prop)) problems.push(`${at}: required prop ${c.id}.${prop} has no source`);
+	}
 	return problems;
 }
-/** Catalog sources of a builder that no rule of its table matches. */
+/** Catalog sources of a builder that no rule of its table matches, as an element rule or a section slot. */
 function unmappedSources(table, catalog) {
-	const matched = new Set(table.rules.map((r) => r.match));
+	const matched = new Set([...table.rules.map((r) => r.match), ...(table.sections ?? []).flatMap((r) => Object.values(r.slots).flatMap((s) => [s.match].flat()))]);
 	const sources = catalog.components.flatMap((c) => c.sources[table.builder] ?? []);
 	return [...new Set(sources)].filter((s) => !matched.has(s)).toSorted();
 }
@@ -206,6 +378,6 @@ async function loadCatalog() {
 	return JSON.parse(await readFile(join(PACKAGE_ROOT, "catalog.json"), "utf8"));
 }
 //#endregion
-export { BUILDER_PREFIX, CATALOG_FORMAT, KIT_BUILDERS, KIT_COMPONENTS_DIR, KIT_DIR, MAPPING_FORMAT, MAPPING_VALUE_PATTERN, attrsOf, claimMatches, componentsForSource, copyComponents, isBuilderElement, loadCatalog, loadMapping, planCopy, ruleMatches, rulesFor, unmappedSources, validateCatalog, validateMapping };
+export { BUILDER_PREFIX, CATALOG_FORMAT, CONTENT_PROP_NAME, KIT_BUILDERS, KIT_COMPONENTS_DIR, KIT_DIR, MAPPING_FORMAT, MAPPING_VALUE_PATTERN, attrsOf, claimMatches, classifySection, componentsForSource, contentFieldName, contentFieldPath, contentProps, copyComponents, isBuilderElement, loadCatalog, loadMapping, matchSection, planCopy, ruleMatches, rulesFor, sectionRuleId, sectionValueSlots, unmappedSources, validateCatalog, validateMapping };
 
 //# sourceMappingURL=index.mjs.map