@contentrain/astro-kit 0.1.0

package/components/slider/meta.json

@@ -0,0 +1,32 @@
+{
+  "id": "slider",
+  "name": "Slider",
+  "description": "A carousel of images with optional title, text and button per slide. Without JavaScript it is a snapping horizontal scroller; Embla adds paging, arrows and dots.",
+  "category": "section",
+  "uses": [],
+  "shared": ["Button.astro", "KitImage.astro", "types.ts"],
+  "variants": {
+    "perView": { "options": ["1", "2", "3"], "default": "1", "description": "Slides visible at once on wide screens." },
+    "aspect": { "options": ["wide", "standard", "square"], "default": "wide", "description": "Image aspect ratio: 21:9, 3:2 or 1:1." },
+    "caption": { "options": ["below", "overlay"], "default": "overlay", "description": "Caption under the image, or over its lower edge on a gradient." }
+  },
+  "props": {
+    "slides": { "type": "array", "required": true, "items": { "type": "object", "fields": { "image": { "type": "object", "required": true, "fields": { "src": { "type": "image", "required": true }, "alt": { "type": "string", "required": true }, "width": { "type": "integer" }, "height": { "type": "integer" } } }, "title": { "type": "string" }, "text": { "type": "text" }, "action": { "type": "object", "fields": { "label": { "type": "string", "required": true }, "href": { "type": "url", "required": true }, "newTab": { "type": "boolean" }, "style": { "type": "select", "options": ["primary", "secondary", "ghost"] } } } } }, "description": "Slides; image is an ImageInput, action an ActionInput." },
+    "label": { "type": "string", "required": true, "description": "Accessible name of the carousel." },
+    "prevLabel": { "type": "string", "description": "ui-strings slider.prev." },
+    "nextLabel": { "type": "string", "description": "ui-strings slider.next." },
+    "slideLabel": { "type": "string", "description": "ui-strings slider.slide." },
+    "ofLabel": { "type": "string", "description": "ui-strings slider.of." },
+    "loop": { "type": "boolean", "default": false, "description": "Wrap from the last slide to the first." }
+  },
+  "slots": {},
+  "js": "embla",
+  "dependencies": { "embla-carousel": "^8.6.0" },
+  "sources": {
+    "gutenberg": ["core/gallery:carousel"],
+    "elementor": ["elementor/image-carousel", "elementor/slides", "elementor/media-carousel"],
+    "divi": ["divi/et_pb_slider", "divi/et_pb_fullwidth_slider", "divi/et_pb_post_slider"],
+    "classic": ["classic/revslider", "classic/metaslider", "classic/smart-slider"]
+  },
+  "a11y": "WAI-ARIA carousel pattern: a labelled region with aria-roledescription=carousel, slides as labelled groups ('Slide 2 of 5'), labelled previous/next buttons disabled at the ends, and dot buttons marking the current slide. No autoplay; with prefers-reduced-motion slides change without animation. Without JavaScript every slide is reachable by scrolling."
+}

package/components/tabs/Tabs.astro

@@ -0,0 +1,101 @@
+---
+// Tabbed panels with the WAI-ARIA tabs pattern (arrow keys, Home/End,
+// roving focus) from Zag.js. Without script every panel shows, one after the
+// other under its own title — nothing is ever unreachable; the script turns
+// the same markup into tabs.
+import { tv } from 'tailwind-variants'
+import Section from '../_shared/Section.astro'
+
+export interface TabItem {
+  label: string
+  /** The panel as HTML (the rich text the tab came with). */
+  content: string
+}
+
+const tabs = tv({
+  slots: {
+    heading: 'mb-8 text-2xl font-bold tracking-tight text-balance md:text-3xl',
+    root: 'group/tabs flex flex-col gap-6',
+    list: 'hidden gap-1 group-data-[ready]/tabs:flex',
+    trigger: 'cursor-pointer rounded-md px-4 py-2 text-sm font-medium whitespace-nowrap opacity-75 transition hover:opacity-100 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent data-[selected]:opacity-100',
+    panel: 'prose-site prose max-w-none text-current',
+    title: 'mb-3 text-lg font-semibold group-data-[ready]/tabs:sr-only',
+  },
+  variants: {
+    style: {
+      underline: { list: 'border-b border-line', trigger: '-mb-px rounded-none border-b-2 border-transparent data-[selected]:border-accent' },
+      pills: { trigger: 'data-[selected]:bg-accent data-[selected]:text-accent-ink' },
+    },
+    orientation: {
+      horizontal: { list: 'overflow-x-auto' },
+      vertical: { root: 'md:data-[ready]:flex-row md:data-[ready]:items-start md:data-[ready]:gap-10', list: 'md:w-56 md:shrink-0 md:flex-col', trigger: 'text-left' },
+    },
+    tone: { default: {}, muted: {}, inverse: { panel: 'prose-invert' }, accent: { panel: 'prose-invert', trigger: 'opacity-100' } },
+  },
+  compoundVariants: [
+    { style: 'underline', orientation: 'vertical', class: { list: 'md:border-b-0 md:border-l', trigger: 'md:mb-0 md:-ml-px md:border-b-0 md:border-l-2' } },
+  ],
+  defaultVariants: { style: 'underline', orientation: 'horizontal', tone: 'default' },
+})
+
+interface Props {
+  items: TabItem[]
+  heading?: string | undefined
+  /** Accessible name of the tab list when there is no heading. */
+  label?: string | undefined
+  style?: 'underline' | 'pills' | undefined
+  orientation?: 'horizontal' | 'vertical' | undefined
+  tone?: 'default' | 'muted' | 'inverse' | 'accent' | undefined
+  id?: string | undefined
+}
+
+const { items, heading, label, style, orientation = 'horizontal', tone, id = 'tabs' } = Astro.props
+const s = tabs({ style, orientation, tone })
+const headingId = heading ? `${id}-title` : undefined
+const value = (i: number) => `tab-${i + 1}`
+---
+{items.length > 0 && (
+  <Section tone={tone} spacing="md" id={id} aria-labelledby={headingId}>
+    {heading && <h2 id={headingId} class={s.heading()}>{heading}</h2>}
+    <div class={s.root()} data-kit-tabs={id} data-orientation={orientation} data-label={label ?? heading ?? undefined}>
+      <div class={s.list()} data-part="list">
+        {items.map((item, i) => <button type="button" class={s.trigger()} data-part="trigger" data-value={value(i)}>{item.label}</button>)}
+      </div>
+      {items.map((item, i) => (
+        <div data-part="content" data-value={value(i)} class="min-w-0 flex-1">
+          <h3 class={s.title()}>{item.label}</h3>
+          <div class={s.panel()} set:html={item.content} />
+        </div>
+      ))}
+    </div>
+  </Section>
+)}
+
+<script>
+  import * as tabs from '@zag-js/tabs'
+  import { normalizeProps, spreadProps, VanillaMachine } from '@zag-js/vanilla'
+
+  for (const root of document.querySelectorAll<HTMLElement>('[data-kit-tabs]')) {
+    const list = root.querySelector<HTMLElement>('[data-part="list"]')
+    const triggers = [...root.querySelectorAll<HTMLElement>('[data-part="trigger"]')]
+    const contents = [...root.querySelectorAll<HTMLElement>('[data-part="content"]')]
+    if (!list || triggers.length === 0) continue
+    const machine = new VanillaMachine(tabs.machine, {
+      id: root.dataset.kitTabs ?? 'tabs',
+      defaultValue: triggers[0]!.dataset.value ?? null,
+      orientation: root.dataset.orientation === 'vertical' ? 'vertical' : 'horizontal',
+    })
+    const render = () => {
+      const api = tabs.connect(machine.service, normalizeProps)
+      spreadProps(root, api.getRootProps())
+      spreadProps(list, { ...api.getListProps(), ...(root.dataset.label ? { 'aria-label': root.dataset.label } : {}) })
+      for (const trigger of triggers) spreadProps(trigger, api.getTriggerProps({ value: trigger.dataset.value! }))
+      for (const content of contents) spreadProps(content, api.getContentProps({ value: content.dataset.value! }))
+    }
+    machine.subscribe(render)
+    machine.start()
+    render()
+    // Tabs only once they work: before this, every panel shows under its own title.
+    root.dataset.ready = ''
+  }
+</script>

package/components/tabs/fixtures.json

@@ -0,0 +1,37 @@
+[
+  {
+    "name": "underline",
+    "props": {
+      "heading": "Getting there",
+      "id": "getting-there",
+      "items": [
+        { "label": "By train", "content": "<p>The night train from Madrid arrives at 7:40. Book a couchette a month ahead in summer.</p>" },
+        { "label": "By air", "content": "<p>The airport is 20 minutes from the centre by metro (line red).</p>" },
+        { "label": "By car", "content": "<p>Parking in the old town is expensive; use the park-and-ride at <strong>Campo Grande</strong>.</p>" }
+      ]
+    }
+  },
+  {
+    "name": "pills-vertical-muted",
+    "props": {
+      "style": "pills",
+      "orientation": "vertical",
+      "tone": "muted",
+      "label": "Seasons",
+      "id": "seasons",
+      "items": [
+        { "label": "Spring", "content": "<p>Mild, green, and the best light for photographs.</p>" },
+        { "label": "Summer", "content": "<p>Hot and busy; start early and rest at midday.</p>" },
+        { "label": "Autumn", "content": "<p>Harvest festivals and warm sea.</p>" }
+      ]
+    }
+  },
+  {
+    "name": "underline-inverse",
+    "props": { "tone": "inverse", "label": "Plans", "id": "plans", "items": [{ "label": "Free", "content": "<p>The newsletter and every guide.</p>" }, { "label": "Member", "content": "<p>Plus the seasonal print issue.</p>" }] }
+  },
+  {
+    "name": "pills-accent",
+    "props": { "style": "pills", "tone": "accent", "label": "Formats", "id": "formats", "items": [{ "label": "Online", "content": "<p>Read on the site.</p>" }, { "label": "Print", "content": "<p>Delivered each season.</p>" }] }
+  }
+]

package/components/tabs/meta.json

@@ -0,0 +1,28 @@
+{
+  "id": "tabs",
+  "name": "Tabs",
+  "description": "Tabbed panels with the WAI-ARIA tabs pattern from Zag.js (arrow keys, Home/End, roving focus). Without script every panel shows in turn under its own title, so no content is ever hidden from a reader or a crawler.",
+  "category": "content",
+  "uses": [],
+  "shared": ["Section.astro"],
+  "variants": {
+    "style": { "options": ["underline", "pills"], "default": "underline", "description": "underline: a rule under the list, the selected tab underlined in accent. pills: the selected tab filled with accent." },
+    "orientation": { "options": ["horizontal", "vertical"], "default": "horizontal", "description": "vertical: the tab list beside the panel on wide screens (Elementor vertical tabs)." },
+    "tone": { "options": ["default", "muted", "inverse", "accent"], "default": "default", "description": "Section background." }
+  },
+  "props": {
+    "items": { "type": "array", "required": true, "items": { "type": "object", "fields": { "label": { "type": "string", "required": true }, "content": { "type": "richtext", "required": true } } }, "description": "Tabs in order (Elementor tabs tab_title/tab_content, Divi tab title + content)." },
+    "heading": { "type": "string", "description": "Section heading; also names the tab list." },
+    "label": { "type": "string", "description": "Accessible name of the tab list when there is no heading." },
+    "id": { "type": "string", "description": "Section id, unique per page: the tabs machine and its element ids derive from it." }
+  },
+  "slots": {},
+  "js": "zag",
+  "dependencies": { "@zag-js/tabs": "^1.44.0", "@zag-js/vanilla": "^1.44.0" },
+  "sources": {
+    "elementor": ["elementor/tabs", "elementor/nested-tabs"],
+    "divi": ["divi/et_pb_tabs"],
+    "classic": ["classic/tabs"]
+  },
+  "a11y": "Zag.js tabs: role=tablist/tab/tabpanel with aria-selected, aria-controls and aria-labelledby; arrow keys (per orientation), Home and End move between tabs. Before the script runs every panel is visible with its own h3 title; after, the titles become screen-reader-only and the tabs label the panels."
+}

package/components/testimonial/Testimonial.astro

@@ -0,0 +1,70 @@
+---
+// What people say: one large quote, or several as cards. Each is a <figure>
+// with the quote and who said it. A rotating carousel of quotes is the
+// slider's job; this one shows them all.
+import { tv } from 'tailwind-variants'
+import KitImage from '../_shared/KitImage.astro'
+import Section from '../_shared/Section.astro'
+import type { ImageInput } from '../_shared/types'
+
+export interface TestimonialItem {
+  quote: string
+  name: string
+  role?: string | undefined
+  avatar?: ImageInput | undefined
+}
+
+const testimonial = tv({
+  slots: {
+    heading: 'mb-10 text-2xl font-bold tracking-tight text-balance md:text-3xl',
+    list: 'grid gap-6',
+    card: 'flex h-full flex-col gap-6',
+    quote: 'text-pretty',
+    person: 'mt-auto flex items-center gap-3 not-italic',
+    name: 'font-semibold',
+    role: 'text-sm opacity-75',
+  },
+  variants: {
+    layout: {
+      single: { heading: 'text-center', list: 'mx-auto max-w-3xl', card: 'items-center text-center', quote: 'text-2xl leading-snug font-medium md:text-3xl', person: 'mt-0' },
+      grid: { list: 'md:grid-cols-2 lg:grid-cols-3', card: 'rounded-card border border-line p-6', quote: 'text-base' },
+    },
+    tone: { default: {}, muted: { card: 'bg-surface' }, inverse: { card: 'border-surface/20' }, accent: { card: 'border-accent-ink/30', role: 'opacity-100' } },
+  },
+  compoundVariants: [
+    { layout: 'grid', tone: 'muted', class: { card: 'border-transparent text-ink' } },
+  ],
+  defaultVariants: { layout: 'grid', tone: 'default' },
+})
+
+interface Props {
+  items: TestimonialItem[]
+  heading?: string | undefined
+  layout?: 'single' | 'grid' | undefined
+  tone?: 'default' | 'muted' | 'inverse' | 'accent' | undefined
+  id?: string | undefined
+}
+
+const { items, heading, layout, tone, id } = Astro.props
+const s = testimonial({ layout, tone })
+const headingId = heading && id ? `${id}-title` : undefined
+---
+{items.length > 0 && (
+  <Section tone={tone} spacing="md" id={id} aria-labelledby={headingId}>
+    {heading && <h2 id={headingId} class={s.heading()}>{heading}</h2>}
+    <div class={s.list()}>
+      {items.map(item => (
+        <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" />}
+            <span class="flex flex-col text-left">
+              <span class={s.name()}>{item.name}</span>
+              {item.role && <span class={s.role()}>{item.role}</span>}
+            </span>
+          </figcaption>
+        </figure>
+      ))}
+    </div>
+  </Section>
+)}

package/components/testimonial/fixtures.json

@@ -0,0 +1,26 @@
+[
+  {
+    "name": "grid",
+    "props": {
+      "heading": "What readers say",
+      "id": "readers",
+      "items": [
+        { "quote": "The only travel site I read to the end. Every guide feels written by someone who stayed.", "name": "Ayşe Demir", "role": "Reader since 2019", "avatar": { "src": "/kit-fixtures/avatar-1.svg", "alt": "", "width": 96, "height": 96 } },
+        { "quote": "Their Lisbon guide saved our trip.", "name": "Tom Becker", "avatar": { "src": "/kit-fixtures/avatar-2.svg", "alt": "", "width": 96, "height": 96 } },
+        { "quote": "Honest, slow, and beautifully photographed. I recommend it to every friend who asks where to go next.", "name": "Mei Tanaka", "role": "Photographer", "avatar": { "src": "/kit-fixtures/avatar-3.svg", "alt": "", "width": 96, "height": 96 } }
+      ]
+    }
+  },
+  {
+    "name": "single-muted",
+    "props": { "layout": "single", "tone": "muted", "items": [{ "quote": "A journal that made me want to travel less, and better.", "name": "Ayşe Demir", "role": "Editor, Slow Places", "avatar": { "src": "/kit-fixtures/avatar-1.svg", "alt": "", "width": 96, "height": 96 } }] }
+  },
+  {
+    "name": "grid-inverse",
+    "props": { "tone": "inverse", "items": [{ "quote": "Clear, kind and useful.", "name": "Tom Becker" }, { "quote": "Finally, guides without a hundred ads.", "name": "Mei Tanaka", "role": "Reader" }] }
+  },
+  {
+    "name": "single-accent",
+    "props": { "layout": "single", "tone": "accent", "items": [{ "quote": "Worth every minute.", "name": "Jonas Weber" }] }
+  }
+]

package/components/testimonial/meta.json

@@ -0,0 +1,97 @@
+{
+  "id": "testimonial",
+  "name": "Testimonial",
+  "description": "Quotes from customers or readers with who said them: one large quote, or several as cards. Every quote is shown; rotating quotes are the slider's job.",
+  "category": "section",
+  "uses": [],
+  "shared": [
+    "KitImage.astro",
+    "Section.astro",
+    "types.ts"
+  ],
+  "variants": {
+    "layout": {
+      "options": [
+        "single",
+        "grid"
+      ],
+      "default": "grid",
+      "description": "single: one large centred quote (the first item stands alone; more items stack). grid: cards, up to three per row."
+    },
+    "tone": {
+      "options": [
+        "default",
+        "muted",
+        "inverse",
+        "accent"
+      ],
+      "default": "default",
+      "description": "Section background."
+    }
+  },
+  "props": {
+    "items": {
+      "type": "array",
+      "required": true,
+      "items": {
+        "type": "object",
+        "fields": {
+          "quote": {
+            "type": "text",
+            "required": true
+          },
+          "name": {
+            "type": "string",
+            "required": true
+          },
+          "role": {
+            "type": "string"
+          },
+          "avatar": {
+            "type": "object",
+            "fields": {
+              "src": {
+                "type": "image",
+                "required": true
+              },
+              "alt": {
+                "type": "string",
+                "required": true
+              },
+              "width": {
+                "type": "integer"
+              },
+              "height": {
+                "type": "integer"
+              }
+            }
+          }
+        }
+      },
+      "description": "The quotes (Elementor testimonial content/name/job/image, Divi testimonial body/author/job_title/portrait_url)."
+    },
+    "heading": {
+      "type": "string",
+      "description": "Section heading above the quotes."
+    },
+    "id": {
+      "type": "string",
+      "description": "Anchor id of the section; the heading gets `<id>-title`."
+    }
+  },
+  "slots": {},
+  "js": "none",
+  "dependencies": {},
+  "sources": {
+    "elementor": [
+      "elementor/testimonial"
+    ],
+    "divi": [
+      "divi/et_pb_testimonial"
+    ],
+    "classic": [
+      "classic/testimonial"
+    ]
+  },
+  "a11y": "Each quote is a <figure> whose <figcaption> names the speaker; the text is in a <blockquote>. Avatars are decorative when their alt is empty. The section is labelled by its heading when it has one."
+}

package/dist/index.d.mts

@@ -0,0 +1,150 @@
+import { FieldDef } from "@contentrain/types";
+
+//#region src/catalog.d.ts
+declare const CATALOG_FORMAT = "astro-kit-catalog@1";
+/** The WordPress builders whose elements a component is fed from. */
+type KitBuilder = 'gutenberg' | 'elementor' | 'divi' | 'classic';
+declare const KIT_BUILDERS: readonly KitBuilder[];
+/** Element-name prefix per builder, as `facts.json` names elements (`core/cover`, `elementor/heading`, `divi/et_pb_blurb`). */
+declare const BUILDER_PREFIX: Record<KitBuilder, string>;
+/**
+ * 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.
+ */
+declare function isBuilderElement(builder: KitBuilder, name: string): boolean;
+type KitCategory = 'chrome' | 'section' | 'content' | 'primitive';
+/** Client JavaScript a component ships: none, Embla (carousel), Zag.js (accessible widget) or the Studio runtime. */
+type KitJs = 'none' | 'embla' | 'zag' | 'studio';
+type KitProp = FieldDef & {
+  description: string;
+};
+interface KitVariant {
+  options: string[];
+  default: string;
+  description: string;
+}
+/** One component as written in `components/<id>/meta.json`. */
+interface KitComponentMeta {
+  id: string;
+  name: string;
+  description: string;
+  category: KitCategory;
+  /** Kit components this one renders. */
+  uses: string[];
+  /** Files it imports from `components/_shared/`. */
+  shared: string[];
+  variants: Record<string, KitVariant>;
+  props: Record<string, KitProp>;
+  /** Named slots → what goes in them. `default` is the unnamed slot. */
+  slots: Record<string, string>;
+  js: KitJs;
+  /** npm packages the site needs for this component, name → range. */
+  dependencies: Record<string, string>;
+  /** Builder elements this component replaces, by builder — what the mapping tables map from. */
+  sources: Partial<Record<KitBuilder, string[]>>;
+  /** How it meets its accessibility pattern. */
+  a11y: string;
+}
+/** A catalog entry: the meta plus the files that make the component. */
+interface KitComponent extends KitComponentMeta {
+  /** Paths relative to `components/<id>/`. */
+  files: string[];
+}
+interface KitCatalog {
+  format: typeof CATALOG_FORMAT;
+  /** Design tokens (Tailwind @theme names) the components read; the site must define them. */
+  tokens: string[];
+  /** npm packages every kit component needs. */
+  dependencies: Record<string, string>;
+  components: KitComponent[];
+}
+/** Problems with a catalog, one line each; empty when it is sound. */
+declare function validateCatalog(catalog: KitCatalog): string[];
+/** Components that replace a builder element, e.g. `core/cover` → hero. */
+declare function componentsForSource(catalog: KitCatalog, element: string): KitComponent[];
+//#endregion
+//#region src/mapping.d.ts
+declare const MAPPING_FORMAT = "astro-kit-mapping@1";
+declare const MAPPING_VALUE_PATTERN: RegExp;
+interface MappingRule {
+  /** Builder element, as the fact pack names it; a `:qualifier` narrows it (`core/template-part:header`). */
+  match: string;
+  /** Extra conditions on the element. */
+  when?: {
+    attr?: Record<string, string | number | boolean>;
+    class?: string;
+  };
+  /** Kit component id. */
+  component: string;
+  variant?: Record<string, string>;
+  /** Content the element lists rather than holds: one component per entry of the collection (`collection:posts`). */
+  bind?: `collection:${string}`;
+  /** Consecutive sibling matches form one component (a row of Elementor icon boxes is one card grid). */
+  group?: 'siblings';
+  props?: Record<string, string>;
+  /** Array prop filled from repeated parts of the element (`each`) or the grouped siblings / bound entries. */
+  into?: string;
+  /** Selector of the repeated parts inside the element, for `into`. */
+  each?: string;
+  /** Props of one repeated part / sibling / entry, with sources relative to it. */
+  item?: Record<string, string>;
+}
+interface MappingTable {
+  format: typeof MAPPING_FORMAT;
+  builder: KitBuilder;
+  /** Bumped on any rule change: plans record the version they applied. */
+  version: string;
+  /** What an element no rule covers becomes when no decision is made: rich text. */
+  fallback: 'prose';
+  rules: MappingRule[];
+}
+/** 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. */
+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[];
+/** A builder element as the fact pack gives it (`FactBlock`): name, attributes, children. */
+interface MappingNode {
+  name: string;
+  attrs?: Record<string, unknown>;
+  children?: MappingNode[];
+}
+/** Whether a rule's `match` (with an optional `:qualifier`) and `when.attr` fit an element. */
+declare function ruleMatches(rule: MappingRule, node: MappingNode): boolean;
+/**
+ * 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.
+ */
+declare function claimMatches(nodes: MappingNode[], table: MappingTable, path?: string): {
+  path: string;
+  node: MappingNode;
+  rule: MappingRule;
+}[];
+//#endregion
+//#region src/copy.d.ts
+/** Where kit files land in a site, relative to the site root. */
+declare const KIT_DIR = "src/components/kit";
+interface CopyPlan {
+  /** Components copied, the requested ones and everything they render, sorted. */
+  components: string[];
+  /** Site-relative destination → path relative to the kit's `components/` directory. */
+  files: Record<string, string>;
+  /** npm packages the site needs, name → range. */
+  dependencies: Record<string, string>;
+}
+declare function planCopy(catalog: KitCatalog, ids: readonly string[]): CopyPlan;
+/** Carry out a plan: `kitRoot` is the kit's `components/` directory, `siteRoot` the site. */
+declare function copyComponents(plan: CopyPlan, kitRoot: string, siteRoot: string): Promise<void>;
+//#endregion
+//#region src/index.d.ts
+/** The kit's `components/` directory — the source `copyComponents` copies from. */
+declare const KIT_COMPONENTS_DIR: string;
+/** A builder's mapping table (`mapping/<builder>.json`). */
+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, claimMatches, componentsForSource, copyComponents, isBuilderElement, loadCatalog, loadMapping, planCopy, ruleMatches, rulesFor, unmappedSources, validateCatalog, validateMapping };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/catalog.ts","../src/mapping.ts","../src/copy.ts","../src/index.ts"],"mappings":";;;cAWa,cAAA;;KAGD,UAAA;AAAA,cACC,YAAA,WAAuB,UAAA;;cAGvB,cAAA,EAAgB,MAAA,CAAO,UAAA;;AAJpC;;;;iBAgBgB,gBAAA,CAAiB,OAAA,EAAS,UAAA,EAAY,IAAA;AAAA,KAK1C,WAAA;;KAGA,KAAA;AAAA,KAEA,OAAA,GAAU,QAAA;EAAa,WAAA;AAAA;AAAA,UAElB,UAAA;EACf,OAAA;EACA,OAAA;EACA,WAAA;AAAA;;UAIe,gBAAA;EACf,EAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA,EAAU,WAAA;EAvBsD;EAyBhE,IAAA;EApBU;EAsBV,MAAA;EACA,QAAA,EAAU,MAAA,SAAe,UAAA;EACzB,KAAA,EAAO,MAAA,SAAe,OAAA;EAxBD;EA0BrB,KAAA,EAAO,MAAA;EACP,EAAA,EAAI,KAAA;;EAEJ,YAAA,EAAc,MAAA;EA1BC;EA4Bf,OAAA,EAAS,OAAA,CAAQ,MAAA,CAAO,UAAA;EA1BP;EA4BjB,IAAA;AAAA;;UAIe,YAAA,SAAqB,gBAAA;EA9BX;EAgCzB,KAAA;AAAA;AAAA,UAGe,UAAA;EACf,MAAA,SAAe,cAAA;EAjCf;EAmCA,MAAA;EAnCW;EAqCX,YAAA,EAAc,MAAA;EACd,UAAA,EAAY,YAAA;AAAA;;iBAIE,eAAA,CAAgB,OAAA,EAAS,UAAA;;iBA6BzB,mBAAA,CAAoB,OAAA,EAAS,UAAA,EAAY,OAAA,WAAkB,YAAA;;;cC5F9D,cAAA;AAAA,cAEA,qBAAA,EAAqB,MAAA;AAAA,UAEjB,WAAA;EDjBU;ECmBzB,KAAA;EDnByB;ECqBzB,IAAA;IAAS,IAAA,GAAO,MAAA;IAA2C,KAAA;EAAA;EDlBvC;ECoBpB,SAAA;EACA,OAAA,GAAU,MAAA;EDpBoF;ECsB9F,IAAA;EDtBkC;ECwBlC,KAAA;EACA,KAAA,GAAQ,MAAA;EDjBT;ECmBC,IAAA;EDxB2B;EC0B3B,IAAA;EDdc;ECgBd,IAAA,GAAO,MAAA;AAAA;AAAA,UAGQ,YAAA;EACf,MAAA,SAAe,cAAA;EACf,OAAA,EAAS,UAAA;EDrB2C;ECuBpD,OAAA;EDvBgE;ECyBhE,QAAA;EACA,KAAA,EAAO,WAAA;AAAA;;iBAIO,eAAA,CAAgB,KAAA,EAAO,YAAA,EAAc,OAAA,EAAS,UAAA;ADtB9D;AAAA,iBC+DgB,eAAA,CAAgB,KAAA,EAAO,YAAA,EAAc,OAAA,EAAS,UAAA;;iBAO9C,QAAA,CAAS,KAAA,EAAO,YAAA,EAAc,OAAA,WAAkB,WAAA;;UAO/C,WAAA;EACf,IAAA;EACA,KAAA,GAAQ,MAAA;EACR,QAAA,GAAW,WAAA;AAAA;AD5Eb;AAAA,iBCgFgB,WAAA,CAAY,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,WAAA;;;;;iBAerC,YAAA,CAAa,KAAA,EAAO,WAAA,IAAe,KAAA,EAAO,YAAA,EAAc,IAAA;EAAe,IAAA;EAAc,IAAA,EAAM,WAAA;EAAa,IAAA,EAAM,WAAA;AAAA;;;;cC9HjH,OAAA;AAAA,UAEI,QAAA;EFFU;EEIzB,UAAA;EFJyB;EEMzB,KAAA,EAAO,MAAA;EFHG;EEKV,YAAA,EAAc,MAAA;AAAA;AAAA,iBAGA,QAAA,CAAS,OAAA,EAAS,UAAA,EAAY,GAAA,sBAAyB,QAAA;;iBAwBjD,cAAA,CAAe,IAAA,EAAM,QAAA,EAAU,OAAA,UAAiB,QAAA,WAAmB,OAAA;;;;cCjC5E,kBAAA;;iBAGS,WAAA,CAAY,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,YAAA;;iBAK1C,WAAA,CAAA,GAAe,OAAA,CAAQ,UAAA"}