@at-flux/astroflare 1.0.3 → 1.0.4

package/README.md

@@ -1,32 +1,34 @@
 # @at-flux/astroflare
 
+[![npm version](https://img.shields.io/npm/v/@at-flux/astroflare.svg)](https://www.npmjs.com/package/@at-flux/astroflare)
+[![CI](https://github.com/at-flux/astroflare/actions/workflows/ci.yml/badge.svg)](https://github.com/at-flux/astroflare/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Reusable headless components, styles, and utilities for Astro + Tailwind v4 + Cloudflare projects.
 
 For type-safe DOM helpers, use the separate package **`@at-flux/dom`**.
 
-**There is no `@at-flux/astroflare/dom` subpath** (it is not published and must not be used). Add `@at-flux/dom` as its own dependency.
-
 ## Package entrypoints
 
-| Subpath | Contents |
-|---------|----------|
-| `@at-flux/astroflare` | **Core** — forms utilities (same as `./core`) |
-| `@at-flux/astroflare/core` | Forms; also exposes the `forms` namespace |
-| `@at-flux/astroflare/forms` | Resend email + form HTML helpers |
-| `@at-flux/astroflare/components/*` | Astro components (source) |
-| `@at-flux/astroflare/styles/*` | CSS (source) |
+| Subpath                            | Contents                                      |
+| ---------------------------------- | --------------------------------------------- |
+| `@at-flux/astroflare`              | **Core** — forms utilities (same as `./core`) |
+| `@at-flux/astroflare/core`         | Forms; also exposes the `forms` namespace     |
+| `@at-flux/astroflare/forms`        | Resend email + form HTML helpers              |
+| `@at-flux/astroflare/components/*` | Astro components (source)                     |
+| `@at-flux/astroflare/styles/*`     | CSS (source)                                  |
 
 ### Examples
 
 ```ts
 // Flat imports from core
-import { sendEmail } from '@at-flux/astroflare';
+import { sendEmail } from "@at-flux/astroflare";
 
 // Explicit subpaths
-import { renderEmailTemplate } from '@at-flux/astroflare/forms';
+import { renderEmailTemplate } from "@at-flux/astroflare/forms";
 
 // Namespaced (from core / root)
-import { forms } from '@at-flux/astroflare/core';
+import { forms } from "@at-flux/astroflare/core";
 ```
 
 ## Contents
@@ -39,7 +41,75 @@ import { forms } from '@at-flux/astroflare/core';
 - `InstagramProfileLink.astro` — Small Instagram icon + `@handle` link with safe defaults
 - `Section.astro` — Page section with optional `narrow` and `contentOnly` (inner width wrapper without outer padding)
 - `ThemeToggle.astro` — Dark/light mode toggle using `<theme-toggle>` web component
+- `IconButton.astro` — Accessible icon-only control that renders `<button>` or `<a>`
 - `ClientRouterLoadingSpinner.astro` — Loading spinner for Astro view transitions
+- `Tooltip.astro` — Lightweight hover/focus tooltip wrapper for compact metadata summaries
+- `ListSummary.astro` — Generic inline list truncation with `+N` overflow and tooltip details
+- `TagSummary.astro` — Generic deterministic tag pill list with `+N` tooltip overflow
+- `MediaProtect.astro` — Style-agnostic media wrapper that applies no-save classes with delegated drag/context-menu protection
+- `FilterPills.astro` — Tag-colored filter chips with an `all` option and active-state styling
+- `Pager.astro` — Pagination UI primitive for both browser-only and link-driven query pagination
+- `CollectionQuery.astro` — Unified collection filtering/pagination component (client mode by default; URL-driven server mode with `useServer`)
+
+#### Component props reference
+
+- `Modal.astro`: `id`, `class`, `backdropClass`, `panelClass`, `closeButtonClass`, `contentClass`
+- `ModalTrigger.astro`: `modalId`, `class`
+- `ContactModalCta.astro`: `modalId`, `label`, `variant`, `class`
+- `InstagramProfileLink.astro`: `handle`, `href`, `class`, `aria-label`
+- `Section.astro`: `id`, `class`, `narrow`, `contentOnly`
+- `ThemeToggle.astro`: `class`
+- `IconButton.astro`: `label`, `href`, `class`, `id`, passthrough attributes
+- `Tooltip.astro`: `text`, `position`, `class`, `panelClass`
+- `ListSummary.astro`: `items`, `visibleCount`, `separator`, `class`, `emptyLabel`, `overflowClass`, `tooltipPosition`, `itemCase`
+- `TagSummary.astro`: `items`, `visibleCount`, `class`, `itemClass`, `overflowClass`, `itemCase`, `colorOverrides`
+- `MediaProtect.astro`: `class`, `containerClass`, `drag`, `contextMenu`
+- `FilterPills.astro`: `items`, `includeAll`, `allLabel`, `allHref`, `active`, `itemCase`, `colorOverrides`, `class`
+- `Pager.astro`: `pageCount`, `activePage`, `items`, `class`
+- `CollectionQuery.astro`: `useServer`, `pathname`, `query`, `totalPages`, `currentPage`, `filters`, `maxPageButtons`, `filtersClass`, `pagerClass`, `perPage`, `class`
+  - when `useServer` is `true`, `pathname`, `query`, `totalPages`, and `currentPage` are required
+
+### Server Islands Pattern
+
+`CollectionQuery.astro` supports two modes:
+
+- client mode (default): static cards are filtered/paged in the browser
+- server mode (`useServer`): renders querystring links for filters + pager
+
+For server mode, mount with `server:defer` at the page callsite:
+
+```astro
+<CollectionQuery
+  useServer
+  pathname={Astro.url.pathname}
+  query={activeQuery}
+  totalPages={pageData.totalPages}
+  currentPage={currentPage}
+  filters={filters}
+  server:defer
+/>
+```
+
+The package styleguide uses the Node adapter, so the server-island pattern can be exercised there with `server:defer`.
+
+### Slot customization (headless overrides)
+
+Use named slots to replace the default filter/pager rendering:
+
+```astro
+<CollectionQuery useServer {...props}>
+  <div slot="filters">
+    <!-- your custom filter UI -->
+  </div>
+
+  <!-- default slot: your collection items -->
+  <div>...</div>
+
+  <div slot="pager">
+    <!-- your custom pager UI -->
+  </div>
+</CollectionQuery>
+```
 
 ### Styles (CSS)
 
@@ -48,6 +118,12 @@ import { forms } from '@at-flux/astroflare/core';
 - `styles/accessibility.css` — Focus styles, reduced motion, selection styling
 - `styles/scrollbar.css` — Branded scrollbar styling
 
+### Utilities
+
+- `getTagPalette(tag, options?)` — Deterministic, readable tag color assignment with optional explicit overrides
+- `formatDisplayDate(date, config?)` — Consistent card/detail date formatting with locale override support
+- `parseCollectionQuery(searchParams, options?)` + `paginateCollection(list, query)` + `buildCollectionHref(path, query, overrides?)` + `buildPageSequence(total, current, max?)` + `matchesCollectionFilters(values, filters)` — URL-driven filtering and pagination helpers (`filters` query param supports stringified JSON for multi-filter payloads)
+
 ## Usage
 
 ### Local checkout without changing package.json or lockfile
@@ -93,8 +169,8 @@ import ModalTrigger from '@at-flux/astroflare/components/ModalTrigger.astro';
 ### Styles
 
 ```css
-@import '@at-flux/astroflare/styles/prose.css';
-@import '@at-flux/astroflare/styles/no-save.css';
+@import "@at-flux/astroflare/styles/prose.css";
+@import "@at-flux/astroflare/styles/no-save.css";
 ```
 
 ## Testing
@@ -111,3 +187,11 @@ Or in `packages/astroflare`:
 ```bash
 pnpm test
 ```
+
+## Styleguide (dev-only)
+
+Use the package-local styleguide to preview all astroflare components in one place.
+
+```bash
+pnpm styleguide:dev
+```

package/dist/chunk-pbuEa-1d.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+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;
+};
+//#endregion
+export { __exportAll as t };

package/dist/core.cjs

@@ -1,142 +1,166 @@
-"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 });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_forms = require("./forms-8uIdWmMD.cjs");
+//#region src/tag-colors.ts
+const DEFAULT_OVERRIDES = {
+	shoots: "#dc3545",
+	tech: "#8a95a5",
+	ai: "#6b7b8d",
+	sites: "#7dd3c0",
+	flow: "#b367e0"
 };
-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;
+const hashStringToHue = (input) => {
+	let hash = 0;
+	for (let i = 0; i < input.length; i += 1) hash = hash * 31 + input.charCodeAt(i) >>> 0;
+	return hash % 360;
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/core.ts
-var core_exports = {};
-__export(core_exports, {
-  composeEmailAddress: () => composeEmailAddress,
-  forms: () => forms_exports,
-  generateFormResultHtml: () => generateFormResultHtml,
-  generateFormSectionHtml: () => generateFormSectionHtml,
-  renderEmailTemplate: () => renderEmailTemplate,
-  sendEmail: () => sendEmail
-});
-module.exports = __toCommonJS(core_exports);
-
-// src/forms/index.ts
-var forms_exports = {};
-__export(forms_exports, {
-  composeEmailAddress: () => composeEmailAddress,
-  generateFormResultHtml: () => generateFormResultHtml,
-  generateFormSectionHtml: () => generateFormSectionHtml,
-  renderEmailTemplate: () => renderEmailTemplate,
-  sendEmail: () => sendEmail
+const hexToRgb = (hex) => {
+	const value = hex.replace("#", "").trim();
+	if (!/^[0-9a-fA-F]{6}$/.test(value)) return null;
+	return [
+		Number.parseInt(value.slice(0, 2), 16),
+		Number.parseInt(value.slice(2, 4), 16),
+		Number.parseInt(value.slice(4, 6), 16)
+	];
+};
+const rgbToHsl = (r, g, b) => {
+	const red = r / 255;
+	const green = g / 255;
+	const blue = b / 255;
+	const max = Math.max(red, green, blue);
+	const min = Math.min(red, green, blue);
+	const delta = max - min;
+	const lightness = (max + min) / 2;
+	const saturation = delta === 0 ? 0 : delta / (1 - Math.abs(2 * lightness - 1));
+	let hue = 0;
+	if (delta !== 0) if (max === red) hue = (green - blue) / delta % 6;
+	else if (max === green) hue = (blue - red) / delta + 2;
+	else hue = (red - green) / delta + 4;
+	return [
+		Math.round((hue * 60 + 360) % 360),
+		Math.round(saturation * 100),
+		Math.round(lightness * 100)
+	];
+};
+const resolveHue = (tag, options) => {
+	const key = tag.trim().toLowerCase();
+	const color = options.overrides?.[key] ?? DEFAULT_OVERRIDES[key];
+	if (!color) return hashStringToHue(key);
+	const rgb = hexToRgb(color);
+	if (!rgb) return hashStringToHue(key);
+	return rgbToHsl(...rgb)[0];
+};
+/**
+* Build a deterministic HSL-based palette for a tag label.
+* Uses known defaults and optional overrides before falling back to hashed hue.
+*/
+const getTagPalette = (tag, options = {}) => {
+	const hue = resolveHue(tag, options);
+	return {
+		bg: `hsla(${hue} 48% 58% / 0.12)`,
+		border: `hsla(${hue} 52% 58% / 0.34)`,
+		text: `hsl(${hue} 50% 66%)`
+	};
+};
+//#endregion
+//#region src/date-format.ts
+const DEFAULT_OPTIONS = {
+	year: "numeric",
+	month: "long",
+	day: "numeric"
+};
+/**
+* Format dates consistently for cards and article metadata.
+*/
+const formatDisplayDate = (date, config = {}) => {
+	const { locale = "en-GB", options = DEFAULT_OPTIONS } = config;
+	return new Intl.DateTimeFormat(locale, options).format(new Date(date));
+};
+//#endregion
+//#region src/collection-query.ts
+const toInt = (value, fallback) => {
+	const parsed = Number.parseInt(value ?? "", 10);
+	return Number.isFinite(parsed) ? parsed : fallback;
+};
+const parseCollectionQuery = (searchParams, options = {}) => {
+	const { defaultPage = 1, defaultSize = 12, maxSize = 100 } = options;
+	const page = Math.max(1, toInt(searchParams.get("page"), defaultPage));
+	const size = Math.min(maxSize, Math.max(1, toInt(searchParams.get("size"), defaultSize)));
+	const fallbackOffset = (page - 1) * size;
+	const offset = Math.max(0, toInt(searchParams.get("offset"), fallbackOffset));
+	const rawFilters = searchParams.get("filters");
+	let filters = {};
+	if (rawFilters) try {
+		const parsed = JSON.parse(rawFilters);
+		filters = Object.fromEntries(Object.entries(parsed).filter(([, value]) => typeof value === "string").map(([key, value]) => [key, String(value)]));
+	} catch {
+		filters = {};
+	}
+	return {
+		page,
+		size,
+		offset,
+		filters
+	};
+};
+const paginateCollection = (list, query) => {
+	const totalItems = list.length;
+	const totalPages = Math.max(1, Math.ceil(totalItems / query.size));
+	const start = (Math.min(totalPages, Math.max(1, Math.floor(query.offset / query.size) + 1)) - 1) * query.size;
+	const end = start + query.size;
+	return {
+		items: list.slice(start, end),
+		totalItems,
+		totalPages,
+		start,
+		end: Math.min(end, totalItems)
+	};
+};
+const buildCollectionHref = (pathname, query, overrides = {}) => {
+	const next = {
+		...query,
+		...overrides
+	};
+	const normalizedOffset = (next.page - 1) * next.size;
+	const params = new URLSearchParams({
+		page: String(next.page),
+		size: String(next.size),
+		offset: String(next.offset ?? normalizedOffset)
+	});
+	if (Object.keys(next.filters ?? {}).length > 0) params.set("filters", JSON.stringify(next.filters));
+	return `${pathname}?${params.toString()}`;
+};
+const matchesCollectionFilters = (values, filters) => Object.entries(filters).every(([key, value]) => {
+	return (values[key] ?? []).includes(value);
 });
-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
+const buildPageSequence = (totalPages, currentPage, maxButtons = 7) => {
+	if (totalPages <= maxButtons) return Array.from({ length: totalPages }, (_, index) => index + 1);
+	const innerSlots = Math.max(1, maxButtons - 2);
+	const left = Math.max(2, currentPage - Math.floor(innerSlots / 2));
+	const right = Math.min(totalPages - 1, left + innerSlots - 1);
+	const adjustedLeft = Math.max(2, right - innerSlots + 1);
+	const sequence = [1];
+	if (adjustedLeft > 2) sequence.push("…");
+	for (let page = adjustedLeft; page <= right; page += 1) sequence.push(page);
+	if (right < totalPages - 1) sequence.push("…");
+	sequence.push(totalPages);
+	return sequence;
+};
+//#endregion
+exports.buildCollectionHref = buildCollectionHref;
+exports.buildPageSequence = buildPageSequence;
+exports.composeEmailAddress = require_forms.composeEmailAddress;
+exports.formatDisplayDate = 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 = getTagPalette;
+exports.matchesCollectionFilters = matchesCollectionFilters;
+exports.paginateCollection = paginateCollection;
+exports.parseCollectionQuery = parseCollectionQuery;
+exports.renderEmailTemplate = require_forms.renderEmailTemplate;
+exports.sendEmail = require_forms.sendEmail;

package/dist/core.d.cts

@@ -1,2 +1,59 @@
-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";
+
+//#region src/tag-colors.d.ts
+interface TagPalette {
+  /** Soft background fill for the tag surface. */
+  bg: string;
+  /** Border color paired with `bg` for tag outlines. */
+  border: string;
+  /** Foreground text color with readable contrast on `bg`. */
+  text: string;
+}
+interface TagColorOptions {
+  /** Optional explicit tag-key to hex color map (expects lowercase keys). */
+  overrides?: Record<string, string>;
+}
+/**
+ * Build a deterministic HSL-based palette for a tag label.
+ * Uses known defaults and optional overrides before falling back to hashed hue.
+ */
+declare const getTagPalette: (tag: string, options?: TagColorOptions) => TagPalette;
+//#endregion
+//#region src/date-format.d.ts
+interface DateFormatOptions {
+  /** BCP 47 locale tag used by `Intl.DateTimeFormat`. */
+  locale?: string;
+  /** Intl formatting options merged with defaults. */
+  options?: Intl.DateTimeFormatOptions;
+}
+/**
+ * Format dates consistently for cards and article metadata.
+ */
+declare const formatDisplayDate: (date: Date | string | number, config?: DateFormatOptions) => string;
+//#endregion
+//#region src/collection-query.d.ts
+interface CollectionQueryOptions {
+  defaultPage?: number;
+  defaultSize?: number;
+  maxSize?: number;
+}
+interface CollectionQueryState {
+  page: number;
+  size: number;
+  offset: number;
+  filters: Record<string, string>;
+}
+interface PaginationSlice<T> {
+  items: T[];
+  totalItems: number;
+  totalPages: number;
+  start: number;
+  end: number;
+}
+declare const parseCollectionQuery: (searchParams: URLSearchParams, options?: CollectionQueryOptions) => CollectionQueryState;
+declare const paginateCollection: <T>(list: T[], query: CollectionQueryState) => PaginationSlice<T>;
+declare const buildCollectionHref: (pathname: string, query: CollectionQueryState, overrides?: Partial<CollectionQueryState>) => string;
+declare const matchesCollectionFilters: (values: Record<string, string[]>, filters: Record<string, string>) => boolean;
+declare const buildPageSequence: (totalPages: number, currentPage: number, maxButtons?: number) => Array<number | "\u2026">;
+//#endregion
+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/core.d.ts

@@ -1,2 +1,59 @@
-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";
+
+//#region src/tag-colors.d.ts
+interface TagPalette {
+  /** Soft background fill for the tag surface. */
+  bg: string;
+  /** Border color paired with `bg` for tag outlines. */
+  border: string;
+  /** Foreground text color with readable contrast on `bg`. */
+  text: string;
+}
+interface TagColorOptions {
+  /** Optional explicit tag-key to hex color map (expects lowercase keys). */
+  overrides?: Record<string, string>;
+}
+/**
+ * Build a deterministic HSL-based palette for a tag label.
+ * Uses known defaults and optional overrides before falling back to hashed hue.
+ */
+declare const getTagPalette: (tag: string, options?: TagColorOptions) => TagPalette;
+//#endregion
+//#region src/date-format.d.ts
+interface DateFormatOptions {
+  /** BCP 47 locale tag used by `Intl.DateTimeFormat`. */
+  locale?: string;
+  /** Intl formatting options merged with defaults. */
+  options?: Intl.DateTimeFormatOptions;
+}
+/**
+ * Format dates consistently for cards and article metadata.
+ */
+declare const formatDisplayDate: (date: Date | string | number, config?: DateFormatOptions) => string;
+//#endregion
+//#region src/collection-query.d.ts
+interface CollectionQueryOptions {
+  defaultPage?: number;
+  defaultSize?: number;
+  maxSize?: number;
+}
+interface CollectionQueryState {
+  page: number;
+  size: number;
+  offset: number;
+  filters: Record<string, string>;
+}
+interface PaginationSlice<T> {
+  items: T[];
+  totalItems: number;
+  totalPages: number;
+  start: number;
+  end: number;
+}
+declare const parseCollectionQuery: (searchParams: URLSearchParams, options?: CollectionQueryOptions) => CollectionQueryState;
+declare const paginateCollection: <T>(list: T[], query: CollectionQueryState) => PaginationSlice<T>;
+declare const buildCollectionHref: (pathname: string, query: CollectionQueryState, overrides?: Partial<CollectionQueryState>) => string;
+declare const matchesCollectionFilters: (values: Record<string, string[]>, filters: Record<string, string>) => boolean;
+declare const buildPageSequence: (totalPages: number, currentPage: number, maxButtons?: number) => Array<number | "\u2026">;
+//#endregion
+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 };