@contentrain/astro-kit 0.1.0

package/dist/index.mjs

@@ -0,0 +1,199 @@
+import { copyFile, mkdir, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/catalog.ts
+const CATALOG_FORMAT = "astro-kit-catalog@1";
+const KIT_BUILDERS = [
+	"gutenberg",
+	"elementor",
+	"divi",
+	"classic"
+];
+/** Element-name prefix per builder, as `facts.json` names elements (`core/cover`, `elementor/heading`, `divi/et_pb_blurb`). */
+const BUILDER_PREFIX = {
+	gutenberg: "core/",
+	elementor: "elementor/",
+	divi: "divi/",
+	classic: "classic/"
+};
+/**
+* Whether an element name belongs to a builder. Gutenberg blocks are namespaced by their plugin
+* (`core/cover`, `yoast-seo/breadcrumbs`, `uagb/container`), so any `<ns>/<name>` that is not another
+* builder's is a Gutenberg block.
+*/
+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]));
+}
+/** Problems with a catalog, one line each; empty when it is sound. */
+function validateCatalog(catalog) {
+	const problems = [];
+	const ids = new Set(catalog.components.map((c) => c.id));
+	for (const c of catalog.components) {
+		const at = `component ${c.id}`;
+		if (!/^[a-z][a-z0-9-]*$/.test(c.id)) problems.push(`${at}: id must be kebab-case`);
+		if (!c.files.length) problems.push(`${at}: no files`);
+		for (const used of c.uses) if (!ids.has(used)) problems.push(`${at}: uses unknown component "${used}"`);
+		for (const [axis, variant] of Object.entries(c.variants)) if (!variant.options.includes(variant.default)) problems.push(`${at}: variant ${axis} default "${variant.default}" is not an option`);
+		for (const [name, prop] of Object.entries(c.props)) {
+			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`);
+		}
+		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}…)`);
+		}
+	}
+	const seen = /* @__PURE__ */ new Set();
+	for (const c of catalog.components) {
+		if (seen.has(c.id)) problems.push(`component ${c.id}: listed twice`);
+		seen.add(c.id);
+	}
+	return problems;
+}
+/** Components that replace a builder element, e.g. `core/cover` → hero. */
+function componentsForSource(catalog, element) {
+	return catalog.components.filter((c) => Object.values(c.sources).some((names) => names?.includes(element)));
+}
+//#endregion
+//#region src/copy.ts
+/** Where kit files land in a site, relative to the site root. */
+const KIT_DIR = "src/components/kit";
+function planCopy(catalog, ids) {
+	const byId = new Map(catalog.components.map((c) => [c.id, c]));
+	const wanted = /* @__PURE__ */ new Set();
+	const visit = (id) => {
+		if (wanted.has(id)) return;
+		const component = byId.get(id);
+		if (!component) throw new Error(`astro-kit has no component "${id}". Known: ${[...byId.keys()].join(", ")}.`);
+		wanted.add(id);
+		for (const used of component.uses) visit(used);
+	};
+	for (const id of ids) visit(id);
+	const files = {};
+	const dependencies = { ...catalog.dependencies };
+	for (const id of [...wanted].toSorted()) {
+		const component = byId.get(id);
+		for (const file of component.files) files[`${KIT_DIR}/${id}/${file}`] = `${id}/${file}`;
+		for (const file of component.shared) files[`${KIT_DIR}/_shared/${file}`] = `_shared/${file}`;
+		Object.assign(dependencies, component.dependencies);
+	}
+	return {
+		components: [...wanted].toSorted(),
+		files,
+		dependencies
+	};
+}
+/** Carry out a plan: `kitRoot` is the kit's `components/` directory, `siteRoot` the site. */
+async function copyComponents(plan, kitRoot, siteRoot) {
+	await Promise.all(Object.entries(plan.files).map(async ([dest, source]) => {
+		const target = join(siteRoot, dest);
+		await mkdir(dirname(target), { recursive: true });
+		await copyFile(join(kitRoot, source), target);
+	}));
+}
+//#endregion
+//#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.-]+|(?:dom|img|link|html):[^@]*(?:@[\w-]+)?)$/;
+/** Problems with a mapping table against the catalog, one line each; empty when it is sound. */
+function validateMapping(table, catalog) {
+	const problems = [];
+	if (table.format !== "astro-kit-mapping@1") problems.push(`format is not ${MAPPING_FORMAT}`);
+	if (!KIT_BUILDERS.includes(table.builder)) problems.push(`unknown builder ${table.builder}`);
+	if (!/^\d+$/.test(table.version)) problems.push("version is not an integer string");
+	const components = new Map(catalog.components.map((c) => [c.id, c]));
+	const seen = /* @__PURE__ */ new Set();
+	for (const rule of table.rules) {
+		const at = `${table.builder} ${rule.match}${rule.when ? " (when)" : ""}`;
+		const key = `${rule.match}|${JSON.stringify(rule.when ?? {})}`;
+		if (seen.has(key)) problems.push(`${at}: matched twice`);
+		seen.add(key);
+		if (!isBuilderElement(table.builder, rule.match)) problems.push(`${at}: not a ${table.builder} element`);
+		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}`);
+		for (const [prop, value] of Object.entries({
+			...rule.props,
+			...rule.into ? {} : rule.item
+		})) {
+			if (!c.props[prop]) problems.push(`${at}: ${c.id} has no prop ${prop}`);
+			if (!MAPPING_VALUE_PATTERN.test(value)) problems.push(`${at}: ${prop} = ${value} is not a mapping value`);
+		}
+		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`);
+			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}`);
+				if (!MAPPING_VALUE_PATTERN.test(value)) problems.push(`${at}: ${rule.into}[].${field} = ${value} is not a mapping value`);
+			}
+			if (!rule.each && !rule.group && !rule.bind) problems.push(`${at}: into ${rule.into} needs each, group or bind to say what repeats`);
+		}
+		if (rule.item && !rule.into && !rule.bind) problems.push(`${at}: item without into or bind`);
+		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`);
+	}
+	return problems;
+}
+/** Catalog sources of a builder that no rule of its table matches. */
+function unmappedSources(table, catalog) {
+	const matched = new Set(table.rules.map((r) => r.match));
+	const sources = catalog.components.flatMap((c) => c.sources[table.builder] ?? []);
+	return [...new Set(sources)].filter((s) => !matched.has(s)).toSorted();
+}
+/** Rules for an element, most specific (with `when` / qualifier) first. */
+function rulesFor(table, element) {
+	return table.rules.filter((r) => r.match === element || r.match.split(":")[0] === element).toSorted((a, b) => Number(!!b.when || b.match.includes(":")) - Number(!!a.when || a.match.includes(":")));
+}
+/** Whether a rule's `match` (with an optional `:qualifier`) and `when.attr` fit an element. */
+function ruleMatches(rule, node) {
+	const [name, qualifier] = rule.match.split(":");
+	if (name !== node.name) return false;
+	const attrs = node.attrs ?? {};
+	if (qualifier && ![
+		attrs.area,
+		attrs.slug,
+		attrs.tagName,
+		attrs.qualifier
+	].includes(qualifier)) return false;
+	for (const [key, value] of Object.entries(rule.when?.attr ?? {})) if (attrs[key] !== value) return false;
+	if (rule.when?.class && !String(attrs.className ?? attrs.classes ?? "").split(/\s+/).includes(rule.when.class)) return false;
+	return true;
+}
+/**
+* Apply a table to a tree: the outermost matching element owns its whole subtree, and nothing inside
+* it is matched again — a header template part holding the site title and logo is one header, not three.
+*/
+function claimMatches(nodes, table, path = "0") {
+	return nodes.flatMap((node, i) => {
+		const at = `${path}.${i}`;
+		const rule = rulesFor(table, node.name).find((r) => ruleMatches(r, node));
+		return rule ? [{
+			path: at,
+			node,
+			rule
+		}] : claimMatches(node.children ?? [], table, at);
+	});
+}
+//#endregion
+//#region src/index.ts
+const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+/** The kit's `components/` directory — the source `copyComponents` copies from. */
+const KIT_COMPONENTS_DIR = join(PACKAGE_ROOT, "components");
+/** A builder's mapping table (`mapping/<builder>.json`). */
+async function loadMapping(builder) {
+	return JSON.parse(await readFile(join(PACKAGE_ROOT, "mapping", `${builder}.json`), "utf8"));
+}
+/** The published catalog (`catalog.json`). */
+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, claimMatches, componentsForSource, copyComponents, isBuilderElement, loadCatalog, loadMapping, planCopy, ruleMatches, rulesFor, unmappedSources, validateCatalog, validateMapping };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/catalog.ts","../src/copy.ts","../src/mapping.ts","../src/index.ts"],"sourcesContent":["// The kit catalog: what each component is, what it takes, how it varies and\n// which WordPress builder elements it stands in for. Machine-readable, so the\n// migration writer chooses components by querying it instead of reading\n// source, and the builder mapping tables (mapping/*.json) are checked against\n// it.\n//\n// Props are described with Contentrain's own `FieldDef`, so a model field and\n// the prop it feeds are compared type to type.\n\nimport type { FieldDef } from '@contentrain/types'\n\nexport const CATALOG_FORMAT = 'astro-kit-catalog@1'\n\n/** The WordPress builders whose elements a component is fed from. */\nexport type KitBuilder = 'gutenberg' | 'elementor' | 'divi' | 'classic'\nexport const KIT_BUILDERS: readonly KitBuilder[] = ['gutenberg', 'elementor', 'divi', 'classic']\n\n/** Element-name prefix per builder, as `facts.json` names elements (`core/cover`, `elementor/heading`, `divi/et_pb_blurb`). */\nexport const BUILDER_PREFIX: Record<KitBuilder, string> = {\n  gutenberg: 'core/',\n  elementor: 'elementor/',\n  divi: 'divi/',\n  classic: 'classic/',\n}\n\n/**\n * Whether an element name belongs to a builder. Gutenberg blocks are namespaced by their plugin\n * (`core/cover`, `yoast-seo/breadcrumbs`, `uagb/container`), so any `<ns>/<name>` that is not another\n * builder's is a Gutenberg block.\n */\nexport function isBuilderElement(builder: KitBuilder, name: string): boolean {\n  if (builder !== 'gutenberg') return name.startsWith(BUILDER_PREFIX[builder])\n  return /^[a-z0-9-]+\\/[a-z0-9-]+(:[\\w-]+)?$/.test(name) && !KIT_BUILDERS.some(b => b !== 'gutenberg' && name.startsWith(BUILDER_PREFIX[b]))\n}\n\nexport type KitCategory = 'chrome' | 'section' | 'content' | 'primitive'\n\n/** Client JavaScript a component ships: none, Embla (carousel), Zag.js (accessible widget) or the Studio runtime. */\nexport type KitJs = 'none' | 'embla' | 'zag' | 'studio'\n\nexport type KitProp = FieldDef & { description: string }\n\nexport interface KitVariant {\n  options: string[]\n  default: string\n  description: string\n}\n\n/** One component as written in `components/<id>/meta.json`. */\nexport interface KitComponentMeta {\n  id: string\n  name: string\n  description: string\n  category: KitCategory\n  /** Kit components this one renders. */\n  uses: string[]\n  /** Files it imports from `components/_shared/`. */\n  shared: string[]\n  variants: Record<string, KitVariant>\n  props: Record<string, KitProp>\n  /** Named slots → what goes in them. `default` is the unnamed slot. */\n  slots: Record<string, string>\n  js: KitJs\n  /** npm packages the site needs for this component, name → range. */\n  dependencies: Record<string, string>\n  /** Builder elements this component replaces, by builder — what the mapping tables map from. */\n  sources: Partial<Record<KitBuilder, string[]>>\n  /** How it meets its accessibility pattern. */\n  a11y: string\n}\n\n/** A catalog entry: the meta plus the files that make the component. */\nexport interface KitComponent extends KitComponentMeta {\n  /** Paths relative to `components/<id>/`. */\n  files: string[]\n}\n\nexport interface KitCatalog {\n  format: typeof CATALOG_FORMAT\n  /** Design tokens (Tailwind @theme names) the components read; the site must define them. */\n  tokens: string[]\n  /** npm packages every kit component needs. */\n  dependencies: Record<string, string>\n  components: KitComponent[]\n}\n\n/** Problems with a catalog, one line each; empty when it is sound. */\nexport function validateCatalog(catalog: KitCatalog): string[] {\n  const problems: string[] = []\n  const ids = new Set(catalog.components.map(c => c.id))\n  for (const c of catalog.components) {\n    const at = `component ${c.id}`\n    if (!/^[a-z][a-z0-9-]*$/.test(c.id)) problems.push(`${at}: id must be kebab-case`)\n    if (!c.files.length) problems.push(`${at}: no files`)\n    for (const used of c.uses) if (!ids.has(used)) problems.push(`${at}: uses unknown component \"${used}\"`)\n    for (const [axis, variant] of Object.entries(c.variants)) {\n      if (!variant.options.includes(variant.default)) problems.push(`${at}: variant ${axis} default \"${variant.default}\" is not an option`)\n    }\n    for (const [name, prop] of Object.entries(c.props)) {\n      if (!prop.description) problems.push(`${at}: prop ${name} has no description`)\n      if (prop.type === 'select' && !prop.options?.length) problems.push(`${at}: select prop ${name} has no options`)\n    }\n    for (const [builder, names] of Object.entries(c.sources) as Array<[KitBuilder, string[]]>) {\n      const prefix = BUILDER_PREFIX[builder]\n      for (const name of names) if (!isBuilderElement(builder, name)) problems.push(`${at}: source \"${name}\" is not a ${builder} element (${prefix}…)`)\n    }\n  }\n  const seen = new Set<string>()\n  for (const c of catalog.components) {\n    if (seen.has(c.id)) problems.push(`component ${c.id}: listed twice`)\n    seen.add(c.id)\n  }\n  return problems\n}\n\n/** Components that replace a builder element, e.g. `core/cover` → hero. */\nexport function componentsForSource(catalog: KitCatalog, element: string): KitComponent[] {\n  return catalog.components.filter(c => Object.values(c.sources).some(names => names?.includes(element)))\n}\n","// Copying components into a site — the shadcn model: the site owns the\n// source, there is no runtime dependency on this package. A component is\n// copied with every kit component it renders and every shared file it\n// imports, under `src/components/kit/`, keeping the relative layout its\n// imports expect.\n\nimport { copyFile, mkdir } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport type { KitCatalog } from './catalog.js'\n\n/** Where kit files land in a site, relative to the site root. */\nexport const KIT_DIR = 'src/components/kit'\n\nexport interface CopyPlan {\n  /** Components copied, the requested ones and everything they render, sorted. */\n  components: string[]\n  /** Site-relative destination → path relative to the kit's `components/` directory. */\n  files: Record<string, string>\n  /** npm packages the site needs, name → range. */\n  dependencies: Record<string, string>\n}\n\nexport function planCopy(catalog: KitCatalog, ids: readonly string[]): CopyPlan {\n  const byId = new Map(catalog.components.map(c => [c.id, c]))\n  const wanted = new Set<string>()\n  const visit = (id: string) => {\n    if (wanted.has(id)) return\n    const component = byId.get(id)\n    if (!component) throw new Error(`astro-kit has no component \"${id}\". Known: ${[...byId.keys()].join(', ')}.`)\n    wanted.add(id)\n    for (const used of component.uses) visit(used)\n  }\n  for (const id of ids) visit(id)\n\n  const files: Record<string, string> = {}\n  const dependencies: Record<string, string> = { ...catalog.dependencies }\n  for (const id of [...wanted].toSorted()) {\n    const component = byId.get(id)!\n    for (const file of component.files) files[`${KIT_DIR}/${id}/${file}`] = `${id}/${file}`\n    for (const file of component.shared) files[`${KIT_DIR}/_shared/${file}`] = `_shared/${file}`\n    Object.assign(dependencies, component.dependencies)\n  }\n  return { components: [...wanted].toSorted(), files, dependencies }\n}\n\n/** Carry out a plan: `kitRoot` is the kit's `components/` directory, `siteRoot` the site. */\nexport async function copyComponents(plan: CopyPlan, kitRoot: string, siteRoot: string): Promise<void> {\n  await Promise.all(Object.entries(plan.files).map(async ([dest, source]) => {\n    const target = join(siteRoot, dest)\n    await mkdir(dirname(target), { recursive: true })\n    await copyFile(join(kitRoot, source), target)\n  }))\n}\n","// Builder mapping tables: which kit component a WordPress builder element\n// becomes, and where each of its props comes from. One versioned table per\n// builder (`mapping/<builder>.json`), written once and applied\n// deterministically to every site — the migration model is asked only about\n// elements no rule covers (Migrate's `unmapped_element` decision).\n//\n// A prop's source is one expression from a small closed set. The first six are\n// the project plan's values (`@contentrain/types` `PlanValue`) and bind\n// content; the rest read the builder element itself or the page it is on:\n//\n//   field:<name> · media:<field> · ref:<field>.<field> · href:self|<field> · term:<field> · ui:<key> · const:<value>\n//   site:<field>          a field of the `site` singleton (`site:title`, `site:logo`)\n//   menu:primary|footer   the menu the starter shows in that area\n//   page:<value>          what the route knows: `page:base`, `page:current`, `page:total`, `page:breadcrumb`\n//   attr:<name>           a builder attribute (block attribute, Elementor setting, Divi shortcode attribute)\n//   dom:<selector>        text of the first match inside the element (empty selector: the element)\n//   dom:<selector>@<attr> an attribute of it (`dom:a@href`)\n//   img:<selector>        an image as the kit's `ImageInput` (src, alt, width, height)\n//   link:<selector>       a link as `{ label, href }`\n//   html:<selector>       inner markup, kept as Markdown (rich text)\n\nimport type { KitBuilder, KitCatalog, KitComponent } from './catalog.js'\nimport { isBuilderElement, KIT_BUILDERS } from './catalog.js'\n\nexport const MAPPING_FORMAT = 'astro-kit-mapping@1'\n\nexport 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.-]+|(?:dom|img|link|html):[^@]*(?:@[\\w-]+)?)$/\n\nexport interface MappingRule {\n  /** Builder element, as the fact pack names it; a `:qualifier` narrows it (`core/template-part:header`). */\n  match: string\n  /** Extra conditions on the element. */\n  when?: { attr?: Record<string, string | number | boolean>, class?: string }\n  /** Kit component id. */\n  component: string\n  variant?: Record<string, string>\n  /** Content the element lists rather than holds: one component per entry of the collection (`collection:posts`). */\n  bind?: `collection:${string}`\n  /** Consecutive sibling matches form one component (a row of Elementor icon boxes is one card grid). */\n  group?: 'siblings'\n  props?: Record<string, string>\n  /** Array prop filled from repeated parts of the element (`each`) or the grouped siblings / bound entries. */\n  into?: string\n  /** Selector of the repeated parts inside the element, for `into`. */\n  each?: string\n  /** Props of one repeated part / sibling / entry, with sources relative to it. */\n  item?: Record<string, string>\n}\n\nexport interface MappingTable {\n  format: typeof MAPPING_FORMAT\n  builder: KitBuilder\n  /** Bumped on any rule change: plans record the version they applied. */\n  version: string\n  /** What an element no rule covers becomes when no decision is made: rich text. */\n  fallback: 'prose'\n  rules: MappingRule[]\n}\n\n/** Problems with a mapping table against the catalog, one line each; empty when it is sound. */\nexport function validateMapping(table: MappingTable, catalog: KitCatalog): string[] {\n  const problems: string[] = []\n  if (table.format !== MAPPING_FORMAT) problems.push(`format is not ${MAPPING_FORMAT}`)\n  if (!KIT_BUILDERS.includes(table.builder)) problems.push(`unknown builder ${table.builder}`)\n  if (!/^\\d+$/.test(table.version)) problems.push('version is not an integer string')\n  const components = new Map(catalog.components.map(c => [c.id, c]))\n  const seen = new Set<string>()\n  for (const rule of table.rules) {\n    const at = `${table.builder} ${rule.match}${rule.when ? ' (when)' : ''}`\n    const key = `${rule.match}|${JSON.stringify(rule.when ?? {})}`\n    if (seen.has(key)) problems.push(`${at}: matched twice`)\n    seen.add(key)\n    if (!isBuilderElement(table.builder, rule.match)) problems.push(`${at}: not a ${table.builder} element`)\n    const c = components.get(rule.component)\n    if (!c) { problems.push(`${at}: component ${rule.component} is not in the catalog`); continue }\n    for (const [axis, value] of Object.entries(rule.variant ?? {})) {\n      if (!c.variants[axis]) problems.push(`${at}: ${c.id} has no variant axis ${axis}`)\n      else if (!c.variants[axis]!.options.includes(value)) problems.push(`${at}: ${c.id}.${axis} has no option ${value}`)\n    }\n    for (const [prop, value] of Object.entries({ ...rule.props, ...(rule.into ? {} : rule.item) })) {\n      if (!c.props[prop]) problems.push(`${at}: ${c.id} has no prop ${prop}`)\n      if (!MAPPING_VALUE_PATTERN.test(value)) problems.push(`${at}: ${prop} = ${value} is not a mapping value`)\n    }\n    if (rule.into) {\n      const target = c.props[rule.into]\n      if (!target || target.type !== 'array') problems.push(`${at}: ${c.id}.${rule.into} is not an array prop`)\n      const fields = target && typeof target.items === 'object' ? target.items.fields ?? {} : {}\n      for (const [field, value] of Object.entries(rule.item ?? {})) {\n        if (!fields[field]) problems.push(`${at}: ${c.id}.${rule.into}[] has no field ${field}`)\n        if (!MAPPING_VALUE_PATTERN.test(value)) problems.push(`${at}: ${rule.into}[].${field} = ${value} is not a mapping value`)\n      }\n      if (!rule.each && !rule.group && !rule.bind) problems.push(`${at}: into ${rule.into} needs each, group or bind to say what repeats`)\n    }\n    if (rule.item && !rule.into && !rule.bind) problems.push(`${at}: item without into or bind`)\n    const bound = new Set([...Object.keys(rule.props ?? {}), ...(rule.into ? [rule.into] : Object.keys(rule.item ?? {}))])\n    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`)\n  }\n  return problems\n}\n\n/** Catalog sources of a builder that no rule of its table matches. */\nexport function unmappedSources(table: MappingTable, catalog: KitCatalog): string[] {\n  const matched = new Set(table.rules.map(r => r.match))\n  const sources = catalog.components.flatMap((c: KitComponent) => c.sources[table.builder] ?? [])\n  return [...new Set(sources)].filter(s => !matched.has(s)).toSorted()\n}\n\n/** Rules for an element, most specific (with `when` / qualifier) first. */\nexport function rulesFor(table: MappingTable, element: string): MappingRule[] {\n  return table.rules\n    .filter(r => r.match === element || r.match.split(':')[0] === element)\n    .toSorted((a, b) => Number(!!b.when || b.match.includes(':')) - Number(!!a.when || a.match.includes(':')))\n}\n\n/** A builder element as the fact pack gives it (`FactBlock`): name, attributes, children. */\nexport interface MappingNode {\n  name: string\n  attrs?: Record<string, unknown>\n  children?: MappingNode[]\n}\n\n/** Whether a rule's `match` (with an optional `:qualifier`) and `when.attr` fit an element. */\nexport function ruleMatches(rule: MappingRule, node: MappingNode): boolean {\n  const [name, qualifier] = rule.match.split(':')\n  if (name !== node.name) return false\n  const attrs = node.attrs ?? {}\n  // A qualifier names the element's role: a template part's area or slug, or a sub-part the fact pack marks.\n  if (qualifier && ![attrs.area, attrs.slug, attrs.tagName, attrs.qualifier].includes(qualifier)) return false\n  for (const [key, value] of Object.entries(rule.when?.attr ?? {})) if (attrs[key] !== value) return false\n  if (rule.when?.class && !String(attrs.className ?? attrs.classes ?? '').split(/\\s+/).includes(rule.when.class)) return false\n  return true\n}\n\n/**\n * Apply a table to a tree: the outermost matching element owns its whole subtree, and nothing inside\n * it is matched again — a header template part holding the site title and logo is one header, not three.\n */\nexport function claimMatches(nodes: MappingNode[], table: MappingTable, path = '0'): { path: string, node: MappingNode, rule: MappingRule }[] {\n  return nodes.flatMap((node, i) => {\n    const at = `${path}.${i}`\n    const rule = rulesFor(table, node.name).find(r => ruleMatches(r, node))\n    return rule ? [{ path: at, node, rule }] : claimMatches(node.children ?? [], table, at)\n  })\n}\n","import { readFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { KitBuilder, KitCatalog } from './catalog.js'\nimport type { MappingTable } from './mapping.js'\n\nexport * from './catalog.js'\nexport * from './copy.js'\nexport * from './mapping.js'\n\nconst PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')\n\n/** The kit's `components/` directory — the source `copyComponents` copies from. */\nexport const KIT_COMPONENTS_DIR = join(PACKAGE_ROOT, 'components')\n\n/** A builder's mapping table (`mapping/<builder>.json`). */\nexport async function loadMapping(builder: KitBuilder): Promise<MappingTable> {\n  return JSON.parse(await readFile(join(PACKAGE_ROOT, 'mapping', `${builder}.json`), 'utf8')) as MappingTable\n}\n\n/** The published catalog (`catalog.json`). */\nexport async function loadCatalog(): Promise<KitCatalog> {\n  return JSON.parse(await readFile(join(PACKAGE_ROOT, 'catalog.json'), 'utf8')) as KitCatalog\n}\n"],"mappings":"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"}

package/mapping/classic.json

@@ -0,0 +1,261 @@
+{
+  "format": "astro-kit-mapping@1",
+  "builder": "classic",
+  "version": "3",
+  "fallback": "prose",
+  "rules": [
+    {
+      "match": "classic/header",
+      "component": "header",
+      "props": {
+        "siteName": "site:title",
+        "logo": "site:logo",
+        "items": "menu:primary",
+        "navLabel": "ui:nav.label",
+        "menuLabel": "ui:nav.menu",
+        "closeLabel": "ui:nav.close"
+      }
+    },
+    {
+      "match": "classic/nav-menu",
+      "component": "nav",
+      "props": {
+        "items": "menu:primary",
+        "label": "ui:nav.label",
+        "menuLabel": "ui:nav.menu",
+        "closeLabel": "ui:nav.close"
+      }
+    },
+    {
+      "match": "classic/footer",
+      "component": "footer",
+      "props": {
+        "siteName": "site:title",
+        "tagline": "site:description",
+        "links": "menu:footer",
+        "copyright": "ui:footer.copyright",
+        "navLabel": "ui:footer.nav"
+      }
+    },
+    {
+      "match": "classic/widget-area",
+      "component": "footer",
+      "props": {
+        "siteName": "site:title"
+      },
+      "into": "columns",
+      "each": ".widget",
+      "item": {
+        "title": "dom:.widget-title,h2,h3"
+      }
+    },
+    {
+      "match": "classic/archive-item",
+      "component": "post-card",
+      "bind": "collection:posts",
+      "item": {
+        "title": "field:title",
+        "href": "href:self",
+        "excerpt": "field:excerpt",
+        "date": "field:date",
+        "image": "media:featured_image",
+        "author": "ref:author.name",
+        "category": "term:categories"
+      }
+    },
+    {
+      "match": "classic/pagination",
+      "component": "pagination",
+      "props": {
+        "base": "page:base",
+        "current": "page:current",
+        "total": "page:total",
+        "label": "ui:pagination.label",
+        "prevLabel": "ui:pagination.prev",
+        "nextLabel": "ui:pagination.next",
+        "pageLabel": "ui:pagination.page"
+      }
+    },
+    {
+      "match": "classic/yoast-breadcrumb",
+      "component": "breadcrumb",
+      "props": {
+        "items": "page:breadcrumb",
+        "current": "field:title",
+        "label": "ui:breadcrumb.label"
+      }
+    },
+    {
+      "match": "classic/rank-math-breadcrumb",
+      "component": "breadcrumb",
+      "props": {
+        "items": "page:breadcrumb",
+        "current": "field:title",
+        "label": "ui:breadcrumb.label"
+      }
+    },
+    {
+      "match": "classic/revslider",
+      "component": "slider",
+      "props": {
+        "label": "ui:slider.label",
+        "prevLabel": "ui:slider.prev",
+        "nextLabel": "ui:slider.next",
+        "slideLabel": "ui:slider.slide",
+        "ofLabel": "ui:slider.of"
+      },
+      "into": "slides",
+      "each": "rs-slide, .tp-revslider-slidesli",
+      "item": {
+        "image": "img:img",
+        "title": "dom:rs-layer"
+      }
+    },
+    {
+      "match": "classic/metaslider",
+      "component": "slider",
+      "props": {
+        "label": "ui:slider.label",
+        "prevLabel": "ui:slider.prev",
+        "nextLabel": "ui:slider.next",
+        "slideLabel": "ui:slider.slide",
+        "ofLabel": "ui:slider.of"
+      },
+      "into": "slides",
+      "each": ".slides > li",
+      "item": {
+        "image": "img:img",
+        "text": "dom:.caption"
+      }
+    },
+    {
+      "match": "classic/smart-slider",
+      "component": "slider",
+      "props": {
+        "label": "ui:slider.label",
+        "prevLabel": "ui:slider.prev",
+        "nextLabel": "ui:slider.next",
+        "slideLabel": "ui:slider.slide",
+        "ofLabel": "ui:slider.of"
+      },
+      "into": "slides",
+      "each": ".n2-ss-slide",
+      "item": {
+        "image": "img:img",
+        "title": "dom:.n2-ss-item-content"
+      }
+    },
+    {
+      "match": "classic/hero",
+      "component": "hero",
+      "props": {
+        "heading": "dom:h1,h2",
+        "lead": "dom:p",
+        "image": "img:img"
+      },
+      "into": "actions",
+      "each": "a.button,a.btn,.wp-block-button__link",
+      "item": {
+        "label": "dom:",
+        "href": "dom:@href"
+      }
+    },
+    {
+      "match": "classic/cta",
+      "component": "cta",
+      "props": {
+        "heading": "dom:h2,h3",
+        "body": "dom:p"
+      },
+      "into": "actions",
+      "each": "a",
+      "item": {
+        "label": "dom:",
+        "href": "dom:@href"
+      }
+    },
+    {
+      "match": "classic/faq",
+      "component": "faq",
+      "into": "items",
+      "each": "details, .faq-item",
+      "item": {
+        "question": "dom:summary, .faq-question",
+        "answer": "html:.faq-answer, :scope > :not(summary)"
+      }
+    },
+    {
+      "match": "classic/tabs",
+      "component": "tabs",
+      "into": "items",
+      "each": "[role=tab]",
+      "item": {
+        "label": "dom:",
+        "content": "html:[role=tabpanel]"
+      }
+    },
+    {
+      "match": "classic/testimonial",
+      "component": "testimonial",
+      "group": "siblings",
+      "into": "items",
+      "item": {
+        "quote": "dom:blockquote, .testimonial-text",
+        "name": "dom:cite, .testimonial-name",
+        "avatar": "img:img"
+      }
+    },
+    {
+      "match": "classic/gallery",
+      "component": "gallery",
+      "props": {
+        "closeLabel": "ui:gallery.close"
+      },
+      "into": "items",
+      "each": ".gallery-item",
+      "item": {
+        "image": "img:img",
+        "caption": "dom:.gallery-caption, .wp-caption-text"
+      }
+    },
+    {
+      "match": "classic/contact-form-7",
+      "component": "contact-form",
+      "props": {
+        "model": "const:contact",
+        "heading": "dom:h2,h3"
+      }
+    },
+    {
+      "match": "classic/wpforms",
+      "component": "contact-form",
+      "props": {
+        "model": "const:contact",
+        "heading": "dom:h2,h3"
+      }
+    },
+    {
+      "match": "classic/gravityforms",
+      "component": "contact-form",
+      "props": {
+        "model": "const:contact",
+        "heading": "dom:h2,h3"
+      }
+    },
+    {
+      "match": "classic/ninja-forms",
+      "component": "contact-form",
+      "props": {
+        "model": "const:contact",
+        "heading": "dom:h2,h3"
+      }
+    },
+    {
+      "match": "classic/the-content",
+      "component": "prose",
+      "props": {
+        "html": "html:"
+      }
+    }
+  ]
+}