@at-flux/astroflare 1.0.2 → 1.0.4

package/dist/{chunk-DRYHJSYC.js → forms-8uIdWmMD.cjs}

@@ -1,53 +1,56 @@
+//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
 };
-
-// src/forms/index.ts
-var forms_exports = {};
-__export(forms_exports, {
-  composeEmailAddress: () => composeEmailAddress,
-  generateFormResultHtml: () => generateFormResultHtml,
-  generateFormSectionHtml: () => generateFormSectionHtml,
-  renderEmailTemplate: () => renderEmailTemplate,
-  sendEmail: () => sendEmail
+//#endregion
+let resend = require("resend");
+//#region src/forms/index.ts
+var forms_exports = /* @__PURE__ */ __exportAll({
+	composeEmailAddress: () => composeEmailAddress,
+	generateFormResultHtml: () => generateFormResultHtml,
+	generateFormSectionHtml: () => generateFormSectionHtml,
+	renderEmailTemplate: () => renderEmailTemplate,
+	sendEmail: () => sendEmail
 });
-import { Resend } from "resend";
 async function sendEmail(config, payload) {
-  if (config.mock) {
-    console.info("[astroflare:forms] Mock email payload", payload);
-    return { id: "mock-email-id" };
-  }
-  const resend = new Resend(config.apiKey);
-  const { data, error } = await resend.emails.send({
-    from: payload.from,
-    to: payload.to,
-    subject: payload.subject,
-    html: payload.html
-  });
-  if (error) {
-    console.error("[astroflare:forms] Resend API error", error);
-    throw new Error(`Failed to send email: ${error.message ?? "Unknown error"}`);
-  }
-  return data;
+	if (config.mock) {
+		console.info("[astroflare:forms] Mock email payload", payload);
+		return { id: "mock-email-id" };
+	}
+	const { data, error } = await new resend.Resend(config.apiKey).emails.send({
+		from: payload.from,
+		to: payload.to,
+		subject: payload.subject,
+		html: payload.html
+	});
+	if (error) {
+		console.error("[astroflare:forms] Resend API error", error);
+		throw new Error(`Failed to send email: ${error.message ?? "Unknown error"}`);
+	}
+	return data;
 }
 function composeEmailAddress(local, domain, tag) {
-  const taggedLocal = tag ? `${local}+${tag}` : local;
-  return `${taggedLocal}@${domain}`;
+	return `${tag ? `${local}+${tag}` : local}@${domain}`;
 }
 function generateFormSectionHtml(section) {
-  const itemsHtml = section.items.map((item) => {
-    const value = item.value ?? "";
-    const isHtml = /<[^>]+>/.test(value);
-    return `
+	const itemsHtml = section.items.map((item) => {
+		const value = item.value ?? "";
+		const isHtml = /<[^>]+>/.test(value);
+		return `
       <div style="margin-bottom:16px;">
         <p style="margin:0 0 4px;font-weight:600;color:#111827;">${item.key}</p>
         ${isHtml ? `<div style="margin:0;color:#111827;line-height:1.6;">${value || "Not specified"}</div>` : `<p style="margin:0;color:#111827;line-height:1.6;white-space:pre-wrap;">${value || "Not specified"}</p>`}
       </div>
     `;
-  }).join("");
-  return `
+	}).join("");
+	return `
     <section style="background:#f3f4f6;padding:16px;border-radius:8px;margin:16px 0;border:1px solid #e5e7eb;">
       <h3 style="margin:0 0 12px;color:#111827;font-size:16px;font-weight:600;">${section.title}</h3>
       <div style="color:#111827;">
@@ -57,14 +60,11 @@ function generateFormSectionHtml(section) {
   `;
 }
 function generateFormResultHtml(sections) {
-  return sections.map(generateFormSectionHtml).join("\n");
+	return sections.map(generateFormSectionHtml).join("\n");
 }
 async function renderEmailTemplate(args) {
-  const { title, contentHtml, brandName, footerText } = args;
-  const footer = footerText ?? `This message was generated by the ${brandName ?? "site"} contact form on ${(/* @__PURE__ */ new Date()).toLocaleString(
-    "en-GB"
-  )}.`;
-  return `<!DOCTYPE html>
+	const { title, contentHtml, brandName, footerText } = args;
+	return `<!DOCTYPE html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
@@ -95,7 +95,7 @@ async function renderEmailTemplate(args) {
             <tr>
               <td style="padding:16px 24px;background:#f9fafb;border-top:1px solid #e5e7eb;">
                 <p style="margin:0;color:#6b7280;font-size:12px;line-height:18px;">
-                  ${footer}
+                  ${footerText ?? `This message was generated by the ${brandName ?? "site"} contact form on ${(/* @__PURE__ */ new Date()).toLocaleString("en-GB")}.`}
                 </p>
               </td>
             </tr>
@@ -106,12 +106,40 @@ async function renderEmailTemplate(args) {
   </body>
 </html>`;
 }
-
-export {
-  sendEmail,
-  composeEmailAddress,
-  generateFormSectionHtml,
-  generateFormResultHtml,
-  renderEmailTemplate,
-  forms_exports
-};
+//#endregion
+Object.defineProperty(exports, "composeEmailAddress", {
+	enumerable: true,
+	get: function() {
+		return composeEmailAddress;
+	}
+});
+Object.defineProperty(exports, "forms_exports", {
+	enumerable: true,
+	get: function() {
+		return forms_exports;
+	}
+});
+Object.defineProperty(exports, "generateFormResultHtml", {
+	enumerable: true,
+	get: function() {
+		return generateFormResultHtml;
+	}
+});
+Object.defineProperty(exports, "generateFormSectionHtml", {
+	enumerable: true,
+	get: function() {
+		return generateFormSectionHtml;
+	}
+});
+Object.defineProperty(exports, "renderEmailTemplate", {
+	enumerable: true,
+	get: function() {
+		return renderEmailTemplate;
+	}
+});
+Object.defineProperty(exports, "sendEmail", {
+	enumerable: true,
+	get: function() {
+		return sendEmail;
+	}
+});

package/dist/index-Bk-K9aDQ.d.ts

@@ -0,0 +1,44 @@
+import { CreateEmailResponseSuccess } from "resend";
+
+//#region src/forms/index.d.ts
+declare namespace index_d_exports {
+  export { EmailPayload, FormSection, ResendConfig, composeEmailAddress, generateFormResultHtml, generateFormSectionHtml, renderEmailTemplate, sendEmail };
+}
+interface ResendConfig {
+  /**
+   * Resend API key.
+   */
+  apiKey: string;
+  /**
+   * When true, do not send real email – log to console instead.
+   * Useful for local/dev environments.
+   */
+  mock?: boolean;
+}
+interface EmailPayload {
+  from: string;
+  to: string;
+  subject: string;
+  html: string;
+}
+declare function sendEmail(config: ResendConfig, payload: EmailPayload): Promise<CreateEmailResponseSuccess | {
+  id: string;
+}>;
+declare function composeEmailAddress(local: string, domain: string, tag?: string): string;
+interface FormSection {
+  title: string;
+  items: {
+    key: string;
+    value: string;
+  }[];
+}
+declare function generateFormSectionHtml(section: FormSection): string;
+declare function generateFormResultHtml(sections: FormSection[]): string;
+declare function renderEmailTemplate(args: {
+  title: string;
+  contentHtml: string;
+  brandName?: string;
+  footerText?: string;
+}): Promise<string>;
+//#endregion
+export { generateFormResultHtml as a, renderEmailTemplate as c, composeEmailAddress as i, sendEmail as l, FormSection as n, generateFormSectionHtml as o, ResendConfig as r, index_d_exports as s, EmailPayload as t };

package/dist/index-CcH_yXr-.d.cts

@@ -0,0 +1,44 @@
+import { CreateEmailResponseSuccess } from "resend";
+
+//#region \0rolldown/runtime.js
+declare namespace index_d_exports {
+  export { EmailPayload, FormSection, ResendConfig, composeEmailAddress, generateFormResultHtml, generateFormSectionHtml, renderEmailTemplate, sendEmail };
+}
+interface ResendConfig {
+  /**
+   * Resend API key.
+   */
+  apiKey: string;
+  /**
+   * When true, do not send real email – log to console instead.
+   * Useful for local/dev environments.
+   */
+  mock?: boolean;
+}
+interface EmailPayload {
+  from: string;
+  to: string;
+  subject: string;
+  html: string;
+}
+declare function sendEmail(config: ResendConfig, payload: EmailPayload): Promise<CreateEmailResponseSuccess | {
+  id: string;
+}>;
+declare function composeEmailAddress(local: string, domain: string, tag?: string): string;
+interface FormSection {
+  title: string;
+  items: {
+    key: string;
+    value: string;
+  }[];
+}
+declare function generateFormSectionHtml(section: FormSection): string;
+declare function generateFormResultHtml(sections: FormSection[]): string;
+declare function renderEmailTemplate(args: {
+  title: string;
+  contentHtml: string;
+  brandName?: string;
+  footerText?: string;
+}): Promise<string>;
+//#endregion
+export { generateFormResultHtml as a, renderEmailTemplate as c, composeEmailAddress as i, sendEmail as l, FormSection as n, generateFormSectionHtml as o, ResendConfig as r, index_d_exports as s, EmailPayload as t };

package/dist/index.cjs

@@ -1,142 +1,21 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  composeEmailAddress: () => composeEmailAddress,
-  forms: () => forms_exports,
-  generateFormResultHtml: () => generateFormResultHtml,
-  generateFormSectionHtml: () => generateFormSectionHtml,
-  renderEmailTemplate: () => renderEmailTemplate,
-  sendEmail: () => sendEmail
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/forms/index.ts
-var forms_exports = {};
-__export(forms_exports, {
-  composeEmailAddress: () => composeEmailAddress,
-  generateFormResultHtml: () => generateFormResultHtml,
-  generateFormSectionHtml: () => generateFormSectionHtml,
-  renderEmailTemplate: () => renderEmailTemplate,
-  sendEmail: () => sendEmail
-});
-var import_resend = require("resend");
-async function sendEmail(config, payload) {
-  if (config.mock) {
-    console.info("[astroflare:forms] Mock email payload", payload);
-    return { id: "mock-email-id" };
-  }
-  const resend = new import_resend.Resend(config.apiKey);
-  const { data, error } = await resend.emails.send({
-    from: payload.from,
-    to: payload.to,
-    subject: payload.subject,
-    html: payload.html
-  });
-  if (error) {
-    console.error("[astroflare:forms] Resend API error", error);
-    throw new Error(`Failed to send email: ${error.message ?? "Unknown error"}`);
-  }
-  return data;
-}
-function composeEmailAddress(local, domain, tag) {
-  const taggedLocal = tag ? `${local}+${tag}` : local;
-  return `${taggedLocal}@${domain}`;
-}
-function generateFormSectionHtml(section) {
-  const itemsHtml = section.items.map((item) => {
-    const value = item.value ?? "";
-    const isHtml = /<[^>]+>/.test(value);
-    return `
-      <div style="margin-bottom:16px;">
-        <p style="margin:0 0 4px;font-weight:600;color:#111827;">${item.key}</p>
-        ${isHtml ? `<div style="margin:0;color:#111827;line-height:1.6;">${value || "Not specified"}</div>` : `<p style="margin:0;color:#111827;line-height:1.6;white-space:pre-wrap;">${value || "Not specified"}</p>`}
-      </div>
-    `;
-  }).join("");
-  return `
-    <section style="background:#f3f4f6;padding:16px;border-radius:8px;margin:16px 0;border:1px solid #e5e7eb;">
-      <h3 style="margin:0 0 12px;color:#111827;font-size:16px;font-weight:600;">${section.title}</h3>
-      <div style="color:#111827;">
-        ${itemsHtml}
-      </div>
-    </section>
-  `;
-}
-function generateFormResultHtml(sections) {
-  return sections.map(generateFormSectionHtml).join("\n");
-}
-async function renderEmailTemplate(args) {
-  const { title, contentHtml, brandName, footerText } = args;
-  const footer = footerText ?? `This message was generated by the ${brandName ?? "site"} contact form on ${(/* @__PURE__ */ new Date()).toLocaleString(
-    "en-GB"
-  )}.`;
-  return `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>${title}</title>
-    <meta http-equiv="x-ua-compatible" content="ie=edge">
-  </head>
-  <body style="margin:0;padding:0;background:#f3f4f6;color:#111827;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';">
-    <table role="presentation" cellpadding="0" cellspacing="0" width="100%" style="background:#f3f4f6;">
-      <tr>
-        <td align="center" style="padding:24px;">
-          <table role="presentation" cellpadding="0" cellspacing="0" width="100%" style="max-width:720px;background:#ffffff;border-radius:12px;overflow:hidden;border:1px solid #e5e7eb;">
-            <tr>
-              <td style="padding:24px 24px 16px 24px;border-bottom:1px solid #e5e7eb;">
-                <h1 style="margin:0 0 8px 0;font-size:20px;line-height:28px;color:#111827;letter-spacing:0.3px;">
-                  ${title}
-                </h1>
-                <p style="margin:0;font-size:13px;color:#6b7280;line-height:20px;">
-                  Contact form submission
-                </p>
-              </td>
-            </tr>
-            <tr>
-              <td style="padding:24px;">
-                ${contentHtml}
-              </td>
-            </tr>
-            <tr>
-              <td style="padding:16px 24px;background:#f9fafb;border-top:1px solid #e5e7eb;">
-                <p style="margin:0;color:#6b7280;font-size:12px;line-height:18px;">
-                  ${footer}
-                </p>
-              </td>
-            </tr>
-          </table>
-        </td>
-      </tr>
-    </table>
-  </body>
-</html>`;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  composeEmailAddress,
-  forms,
-  generateFormResultHtml,
-  generateFormSectionHtml,
-  renderEmailTemplate,
-  sendEmail
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_forms = require("./forms-8uIdWmMD.cjs");
+const require_core = require("./core.cjs");
+exports.buildCollectionHref = require_core.buildCollectionHref;
+exports.buildPageSequence = require_core.buildPageSequence;
+exports.composeEmailAddress = require_forms.composeEmailAddress;
+exports.formatDisplayDate = require_core.formatDisplayDate;
+Object.defineProperty(exports, "forms", {
+	enumerable: true,
+	get: function() {
+		return require_forms.forms_exports;
+	}
 });
+exports.generateFormResultHtml = require_forms.generateFormResultHtml;
+exports.generateFormSectionHtml = require_forms.generateFormSectionHtml;
+exports.getTagPalette = require_core.getTagPalette;
+exports.matchesCollectionFilters = require_core.matchesCollectionFilters;
+exports.paginateCollection = require_core.paginateCollection;
+exports.parseCollectionQuery = require_core.parseCollectionQuery;
+exports.renderEmailTemplate = require_forms.renderEmailTemplate;
+exports.sendEmail = require_forms.sendEmail;

package/dist/index.d.cts

@@ -1,2 +1,3 @@
-export { EmailPayload, FormSection, ResendConfig, composeEmailAddress, i as forms, generateFormResultHtml, generateFormSectionHtml, renderEmailTemplate, sendEmail } from './forms/index.cjs';
-import 'resend';
+import { a as generateFormResultHtml, c as renderEmailTemplate, i as composeEmailAddress, l as sendEmail, n as FormSection, o as generateFormSectionHtml, r as ResendConfig, s as index_d_exports, t as EmailPayload } from "./index-CcH_yXr-.cjs";
+import { CollectionQueryOptions, CollectionQueryState, DateFormatOptions, PaginationSlice, TagColorOptions, TagPalette, buildCollectionHref, buildPageSequence, formatDisplayDate, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery } from "./core.cjs";
+export { CollectionQueryOptions, CollectionQueryState, DateFormatOptions, EmailPayload, FormSection, PaginationSlice, ResendConfig, TagColorOptions, TagPalette, buildCollectionHref, buildPageSequence, composeEmailAddress, formatDisplayDate, index_d_exports as forms, generateFormResultHtml, generateFormSectionHtml, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery, renderEmailTemplate, sendEmail };

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export { EmailPayload, FormSection, ResendConfig, composeEmailAddress, i as forms, generateFormResultHtml, generateFormSectionHtml, renderEmailTemplate, sendEmail } from './forms/index.js';
-import 'resend';
+import { a as generateFormResultHtml, c as renderEmailTemplate, i as composeEmailAddress, l as sendEmail, n as FormSection, o as generateFormSectionHtml, r as ResendConfig, s as index_d_exports, t as EmailPayload } from "./index-Bk-K9aDQ.js";
+import { CollectionQueryOptions, CollectionQueryState, DateFormatOptions, PaginationSlice, TagColorOptions, TagPalette, buildCollectionHref, buildPageSequence, formatDisplayDate, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery } from "./core.js";
+export { CollectionQueryOptions, CollectionQueryState, DateFormatOptions, EmailPayload, FormSection, PaginationSlice, ResendConfig, TagColorOptions, TagPalette, buildCollectionHref, buildPageSequence, composeEmailAddress, formatDisplayDate, index_d_exports as forms, generateFormResultHtml, generateFormSectionHtml, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery, renderEmailTemplate, sendEmail };

package/dist/index.js

@@ -1,17 +1,3 @@
-import "./chunk-ALMPH3A2.js";
-import {
-  composeEmailAddress,
-  forms_exports,
-  generateFormResultHtml,
-  generateFormSectionHtml,
-  renderEmailTemplate,
-  sendEmail
-} from "./chunk-DRYHJSYC.js";
-export {
-  composeEmailAddress,
-  forms_exports as forms,
-  generateFormResultHtml,
-  generateFormSectionHtml,
-  renderEmailTemplate,
-  sendEmail
-};
+import { composeEmailAddress, generateFormResultHtml, generateFormSectionHtml, renderEmailTemplate, sendEmail, t as forms_exports } from "./forms/index.js";
+import { buildCollectionHref, buildPageSequence, formatDisplayDate, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery } from "./core.js";
+export { buildCollectionHref, buildPageSequence, composeEmailAddress, formatDisplayDate, forms_exports as forms, generateFormResultHtml, generateFormSectionHtml, getTagPalette, matchesCollectionFilters, paginateCollection, parseCollectionQuery, renderEmailTemplate, sendEmail };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@at-flux/astroflare",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "description": "Reusable headless components, styles, and utilities for Astro + Tailwind v4 + Cloudflare projects",
-  "author": "Taylor Siviter <taylor@siviter.xyz>",
+  "author": "atflux <dev@atflux.uk>",
   "license": "MIT",
   "keywords": [
     "astro",
@@ -55,13 +55,15 @@
   "files": [
     "dist",
     "src/components",
+    "src/runtime",
     "src/styles",
     "scripts/link-local.mjs",
     "README.md"
   ],
   "devDependencies": {
+    "@astrojs/node": "^9.5.5",
     "jsdom": "^25.0.1",
-    "tsup": "^8.0.0",
+    "tsdown": "^0.21.7",
     "typescript": "^5.0.0",
     "vitest": "^3.2.4"
   },
@@ -77,22 +79,26 @@
     }
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20.19"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/at-flux/astroflare.git"
+    "url": "git+https://github.com/at-flux/astroflare.git",
+    "directory": "packages/astroflare"
   },
   "bugs": {
     "url": "https://github.com/at-flux/astroflare/issues"
   },
-  "homepage": "https://github.com/at-flux/astroflare#readme",
+  "homepage": "https://github.com/at-flux/astroflare/tree/main/packages/astroflare",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "styleguide:dev": "astro dev --root styleguide",
+    "styleguide:build": "astro build --root styleguide",
+    "styleguide:preview": "astro preview --root styleguide",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",

package/src/components/CollectionQuery.astro

@@ -0,0 +1,107 @@
+---
+import FilterPills from "./FilterPills.astro";
+import Pager from "./Pager.astro";
+import { buildCollectionHref, buildPageSequence } from "../collection-query";
+import type { CollectionQueryProps, CollectionQueryServerProps } from "./collection-query-props";
+type Props = CollectionQueryProps;
+
+const {
+  useServer = false,
+  filters = [],
+  maxPageButtons = 7,
+  filtersClass = "mb-8",
+  pagerClass = "mt-6",
+  perPage = 9,
+  class: className = "",
+} = Astro.props;
+
+const serverProps = useServer
+  ? (Astro.props as CollectionQueryServerProps)
+  : null;
+const pathname = serverProps?.pathname ?? "";
+const query = serverProps?.query ?? { page: 1, size: 9, offset: 0, filters: {} };
+const totalPages = serverProps?.totalPages ?? 1;
+const currentPage = serverProps?.currentPage ?? 1;
+
+const activeFilters = query.filters ?? {};
+const allHref = buildCollectionHref(pathname, query, { filters: {}, page: 1, offset: 0 });
+const serverFilterItems = filters.map((option) => {
+  const nextFilters = { ...activeFilters, [option.key]: option.value };
+  return {
+    value: `${option.key}:${option.value}`,
+    label: option.label ?? option.value,
+    href: buildCollectionHref(pathname, query, { filters: nextFilters, page: 1, offset: 0 }),
+    active: activeFilters[option.key] === option.value,
+    colorKey: option.value,
+  };
+});
+const clientFilterItems = filters.map((option) => ({
+  value: option.value,
+  label: option.label ?? option.value,
+  colorKey: option.value,
+}));
+const pagerItems = buildPageSequence(totalPages, currentPage, maxPageButtons).map((item) =>
+  item === "…"
+    ? { ellipsis: true as const }
+    : {
+        page: item,
+        href: buildCollectionHref(pathname, query, { page: item, offset: (item - 1) * query.size }),
+        active: item === currentPage,
+      },
+);
+---
+
+{useServer && (
+  <>
+    <slot
+      name="filters"
+    >
+      {serverFilterItems.length > 0 && (
+        <FilterPills
+          items={serverFilterItems}
+          allHref={allHref}
+          active={Object.keys(activeFilters).length === 0 ? "all" : "__filtered__"}
+          class={filtersClass}
+        />
+      )}
+    </slot>
+    <slot />
+    <slot name="pager">
+      <Pager items={pagerItems} class={pagerClass} />
+    </slot>
+  </>
+)}
+
+{!useServer && (
+  <collection-query
+    class={className}
+    data-af-query
+    data-per-page={String(perPage)}
+    data-max-page-buttons={String(maxPageButtons)}
+  >
+    <slot
+      name="filters"
+    >
+      {clientFilterItems.length > 0 && (
+        <FilterPills
+          items={clientFilterItems}
+          active="all"
+          class={filtersClass}
+        />
+      )}
+    </slot>
+    <slot />
+    <slot name="pager">
+      <Pager class={pagerClass} />
+    </slot>
+  </collection-query>
+)}
+
+{
+  !useServer && (
+    <script>
+      import { initCollectionQueryRoots } from "../runtime/collection-query";
+      initCollectionQueryRoots();
+    </script>
+  )
+}

package/src/components/ContactModalCta.astro

@@ -4,9 +4,11 @@ import ModalTrigger from './ModalTrigger.astro';
 interface Props {
   /** Target dialog id (must match `<dialog id="…">`). */
   modalId?: string;
+  /** Visible CTA text. */
   label: string;
   /** `solid` — primary pill; `text` — tertiary link style (e.g. inline in prose). */
   variant?: 'solid' | 'text';
+  /** Classes applied to the trigger host. */
   class?: string;
 }