@getvitops/astro 0.8.0 → 1.0.0

package/dist/index.d.mts

@@ -1,7 +1,173 @@
-import { Format } from "@getvitops/generator";
+import { LegalOutput, StylesheetFormat } from "@getvitops/generator";
 import { AstroIntegration } from "astro";
 export * from "@getvitops/utils";
 
+//#region src/seo.d.ts
+/**
+ * The `<Seo />` resolution layer — site-level defaults merged with per-page props
+ * into the exact tags to emit.
+ *
+ * Kept separate from `Seo.astro` deliberately. The component this replaces
+ * (`SEO.astro`, deleted in c949cae) fused resolution with markup, which is why it
+ * was never unit-tested and why its title handling drifted: it computed a title
+ * for `og:title` but left `<title>` to the layout, so the two could disagree.
+ * Everything decidable lives here and is asserted in `seo.test.ts`; the component
+ * only renders what this returns.
+ */
+/** Twitter card types, per <https://developer.x.com/en/docs/twitter-for-websites/cards>. */
+type SeoTwitterCard = 'summary' | 'summary_large_image' | 'app' | 'player';
+/** Open Graph object types this component knows how to describe. */
+type SeoOgType = 'website' | 'article' | 'profile';
+/**
+ * Site-level SEO defaults, passed to `getvitops({ seo })` and baked into the
+ * `virtual:getvitops/head` module. Per-page `<Seo />` props override these.
+ *
+ * The vocabulary mirrors the site-config schema's `seo` block
+ * (`@getvitops/generator`, `src/site.ts`) so a `SiteConfig` → these adapter would
+ * be a flat field map — but it is not imported from there. This is the
+ * integration's own option surface, and it must stay JSON-serialisable: it is
+ * `JSON.stringify`d into the virtual module, so no functions, no `URL`s, no dates.
+ */
+interface GetvitopsSeoOptions {
+  /** `og:site_name`, and the `<title>` when a page passes none. */
+  siteName?: string;
+  /**
+   * Page-title pattern; `%s` is the page's own title. e.g. `'%s · Acme'`.
+   *
+   * Skipped when a page's title already equals `siteName` — a homepage titled
+   * "Acme" emits `Acme`, not `Acme · Acme` — and never applied to `defaultTitle`.
+   */
+  titleTemplate?: string;
+  /** `<title>` for pages that pass none. Used verbatim — the template is not applied. */
+  defaultTitle?: string;
+  /** `<meta name="description">` for pages that pass none. */
+  defaultDescription?: string;
+  /** Site-wide robots directive, e.g. `'index,follow,max-image-preview:large'`. */
+  robots?: string;
+  /** Google Search Console verification token. */
+  googleSiteVerification?: string;
+  /** Bing Webmaster Tools verification token. */
+  bingSiteVerification?: string;
+  openGraph?: {
+    /** Default `og:type` (default `'website'`). */type?: SeoOgType; /** `og:locale`. Written either way — `en-CA` and `en_CA` both emit `en_CA`. */
+    locale?: string; /** Additional locales the same content exists in → `og:locale:alternate`. */
+    localeAlternates?: string[]; /** Fallback share image. Relative URLs resolve against `site`. */
+    image?: {
+      url: string;
+      alt?: string;
+      width?: number;
+      height?: number;
+      type?: string;
+    };
+  };
+  twitter?: {
+    /** Card type when no image resolves (default `'summary'`). */card?: SeoTwitterCard; /** The site's own handle, `@acme`. */
+    site?: string; /** Default author handle, `@ada`. */
+    creator?: string;
+  };
+}
+/** Per-page `<Seo />` props. Everything is optional; defaults fill the gaps. */
+interface SeoProps {
+  /** Page title, before `titleTemplate` is applied. */
+  title?: string;
+  description?: string;
+  /** Overrides the computed canonical. Relative values resolve against `site`. */
+  canonical?: string;
+  /** Overrides `og:site_name` and the title fallback. */
+  siteName?: string;
+  /** Share image for this page. Relative URLs resolve against `site`. */
+  image?: string;
+  imageAlt?: string;
+  imageWidth?: number;
+  imageHeight?: number;
+  /** MIME type of the share image, e.g. `'image/png'`. */
+  imageType?: string;
+  noindex?: boolean;
+  nofollow?: boolean;
+  noarchive?: boolean;
+  nocache?: boolean;
+  /** Extra robots directives, e.g. `'max-snippet:-1'`. Appended to the composed value. */
+  robotsExtras?: string;
+  /** Full robots override. Wins over the flags above and the site default. */
+  robots?: string;
+  /** `og:type` for this page (default: the site default, else `'website'`). */
+  type?: SeoOgType;
+  /** Emitted only when `type` is `'article'`. */
+  article?: {
+    publishedTime?: string;
+    modifiedTime?: string;
+    expirationTime?: string;
+    authors?: string[];
+    section?: string;
+    tags?: string[];
+  };
+  /** `og:locale` for this page. */
+  locale?: string;
+  /** Twitter author handle for this page, `@ada`. */
+  twitterCreator?: string;
+  /**
+   * Translations of *this* page, as `<link rel="alternate" hreflang>`.
+   *
+   * Explicit only, and it must include the current page. Nothing is inferred:
+   * the deleted component derived alternates from the site's locale list and
+   * pointed every one of them at that locale's homepage, so every page on the
+   * site claimed the homepage as its translation. Only the page knows its own
+   * translated URLs. Pass `hreflang: 'x-default'` for the fallback entry.
+   */
+  alternates?: {
+    hreflang: string;
+    href: string;
+  }[];
+}
+/** A `<meta property>` tag (Open Graph uses `property`, not `name`). */
+interface SeoPropertyTag {
+  property: string;
+  content: string;
+}
+/** A `<meta name>` tag. */
+interface SeoNameTag {
+  name: string;
+  content: string;
+}
+/** Everything `<Seo />` renders, already decided. `null` means "emit nothing". */
+interface ResolvedSeo {
+  title: string | null;
+  description: string | null;
+  canonical: string | null;
+  robots: string | null;
+  openGraph: SeoPropertyTag[];
+  twitter: SeoNameTag[];
+  verification: SeoNameTag[];
+  alternates: {
+    hreflang: string;
+    href: string;
+  }[];
+}
+/** Render context supplied by the component from `Astro`. */
+interface SeoContext {
+  /**
+   * The deployed origin — `Astro.site`, or `config.site` via the virtual module.
+   *
+   * `undefined` when neither is set, and then every absolute-URL tag is dropped
+   * rather than being derived from the request. `astro-seo` falls back to
+   * `Astro.url` here; on a static build that is `http://localhost:4321`, which
+   * would bake a localhost canonical into production HTML.
+   */
+  site?: URL | undefined;
+  /** `Astro.url.pathname` — already includes `base`. */
+  pathname: string;
+  /** `Astro.url.search`, if the canonical should keep the query string. */
+  search?: string;
+}
+/**
+ * Merges site defaults with page props into the final tag set.
+ *
+ * Pure — no `Astro`, no filesystem, no config lookup. Everything it needs comes
+ * through its three arguments, which is what makes it testable and what keeps the
+ * package free of the consumer-global coupling that sank the previous site model.
+ */
+declare function resolveSeo(defaults: GetvitopsSeoOptions, props: SeoProps, ctx: SeoContext): ResolvedSeo;
+//#endregion
 //#region src/integration.d.ts
 interface GetvitopsFaviconOptions {
   /** Source SVG or PNG. */
@@ -16,8 +182,13 @@ interface GetvitopsFaviconOptions {
 interface GetvitopsCssOptions {
   /** Path to design-system.json (default 'design-system.json'). */
   input?: string;
-  /** Output format (default 'tailwind'). */
-  format?: Format;
+  /**
+   * Output format (default 'tailwind'). Narrower than the generator's `Format`
+   * on purpose: this option exists to produce a stylesheet to inject, and the
+   * `design` format emits only `DESIGN.md`. Run that one via the CLI
+   * (`vitops generate --format design --out .`).
+   */
+  format?: StylesheetFormat;
   /** Directory the generated CSS is written to (default 'src/styles'). */
   out?: string;
   /**
@@ -29,6 +200,79 @@ interface GetvitopsCssOptions {
    */
   inject?: boolean;
 }
+interface GetvitopsLegalOptions {
+  /** Path to the site config (JSON) the documents are rendered from. */
+  input: string;
+  /**
+   * Where to write them (default 'src/content/legal'). The default is a content
+   * collection: the documents are markdown, and a collection is what lets a page
+   * render one through your own layout rather than the integration injecting a
+   * route (which nothing in this package does).
+   */
+  out?: string;
+  /** Output format (default 'md'). */
+  format?: LegalOutput;
+  /** Environment whose A/B variant applies (default 'production'). */
+  siteEnv?: string;
+}
+/** `changefreq`, mirroring @astrojs/sitemap's `ChangeFreq`. */
+type GetvitopsSitemapChangeFreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+/** One sitemap entry, mirroring @astrojs/sitemap's `SitemapItem`. */
+interface GetvitopsSitemapEntry {
+  url: string;
+  lastmod?: string;
+  changefreq?: GetvitopsSitemapChangeFreq;
+  priority?: number;
+  /** Alternate-language variants. `lang` is required, as upstream requires it. */
+  links?: {
+    lang: string;
+    hreflang?: string;
+    url: string;
+  }[];
+}
+/**
+ * Forwarded verbatim to `@astrojs/sitemap`. Deliberately a hand-written subset of
+ * its `SitemapOptions` rather than a re-export: aliasing would put an
+ * `import … from '@astrojs/sitemap'` — and, transitively via `SitemapItem`, from
+ * `sitemap` — into this package's published .d.mts, which cannot resolve for the
+ * consumers who don't install the optional peer. Worse, `skipLibCheck` (on by
+ * default via astro's base tsconfig) *suppresses* that error, silently degrading
+ * the option to `any` instead of failing loudly.
+ *
+ * Need something not listed here (e.g. `chunks`)? Add `sitemap()` to your own
+ * `integrations` array — getvitops detects it and leaves yours in charge.
+ */
+interface GetvitopsSitemapOptions {
+  /** Keep a page out of the sitemap. Receives the page's full absolute URL. */
+  filter?: (page: string) => boolean;
+  /** Absolute URLs of pages Astro doesn't build but the site serves. */
+  customPages?: string[];
+  /** Absolute URLs of externally-generated sitemaps to list in the index. */
+  customSitemaps?: string[];
+  /** Max entries per file before it splits (default 45000). */
+  entryLimit?: number;
+  /** Filename prefix (default 'sitemap' → `sitemap-index.xml`). */
+  filenameBase?: string;
+  changefreq?: GetvitopsSitemapChangeFreq;
+  lastmod?: Date;
+  priority?: number;
+  /** Per-entry rewrite; return `undefined` to drop the entry. */
+  serialize?: (item: GetvitopsSitemapEntry) => GetvitopsSitemapEntry | Promise<GetvitopsSitemapEntry | undefined> | undefined;
+  /** Emit `<xhtml:link rel="alternate">` for localised routes. */
+  i18n?: {
+    defaultLocale: string;
+    locales: Record<string, string>;
+  };
+  /** XSL stylesheet to prettify the XML (path relative to `site`, or absolute URL). */
+  xslURL?: string;
+  /** XML namespaces to exclude (all included by default). */
+  namespaces?: {
+    news?: boolean;
+    xhtml?: boolean;
+    image?: boolean;
+    video?: boolean;
+  };
+}
 interface GetvitopsOptions {
   favicon?: GetvitopsFaviconOptions;
   /** Copy + link the web-component bundles (default true). */
@@ -47,8 +291,44 @@ interface GetvitopsOptions {
    * dev server, so on a static build that button simply isn't rendered.
    */
   editor?: boolean;
+  /**
+   * Render the site's legal documents (privacy policy, terms, cookie notice)
+   * from a site config, and re-render when it changes. Off unless provided.
+   *
+   * Requires `css`, which is what registers the Vite plugin that runs the
+   * generation — without it the documents would be written once and never
+   * refresh. Not using `css`? Run `vitops legal` from the CLI instead; it is the
+   * same renderer and works in any stack.
+   */
+  legal?: GetvitopsLegalOptions;
+  /**
+   * Emit `sitemap-index.xml` + `sitemap-0.xml` via `@astrojs/sitemap`, and link it
+   * from `<Head />`. Off unless provided; `true` uses its defaults.
+   *
+   * Needs `@astrojs/sitemap` (an optional peer — install it yourself) and the
+   * `site` astro.config option, since a sitemap lists absolute URLs.
+   *
+   * Skipped with a warning when `emdash()` is registered — EmDash serves its own
+   * database-driven `/sitemap.xml` — and deferred to when you already list
+   * `@astrojs/sitemap` yourself. Note it enumerates **prerendered** routes only,
+   * so on-demand pages of an `output: 'server'` site are not listed.
+   */
+  sitemap?: boolean | GetvitopsSitemapOptions;
+  /**
+   * Site-level defaults for `<Seo />` (`@getvitops/astro/Seo.astro`) — site name,
+   * title template, Open Graph + Twitter defaults, verification tokens. Off unless
+   * provided; per-page props override every field.
+   *
+   * Needs the `site` astro.config option for canonical and `og:url`; without it
+   * `<Seo />` omits every absolute-URL tag rather than deriving one from the
+   * request, and this warns at build time.
+   *
+   * On an EmDash site prefer `<EmDashHead>`, which covers the same tags from the
+   * CMS — using both double-emits them.
+   */
+  seo?: GetvitopsSeoOptions;
 }
 declare function getvitops(opts?: GetvitopsOptions): AstroIntegration;
 //#endregion
-export { type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsOptions, getvitops as default };
+export { type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsOptions, type GetvitopsSeoOptions, type GetvitopsSitemapChangeFreq, type GetvitopsSitemapEntry, type GetvitopsSitemapOptions, type ResolvedSeo, type SeoContext, type SeoNameTag, type SeoOgType, type SeoPropertyTag, type SeoProps, type SeoTwitterCard, getvitops as default, resolveSeo };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/integration.ts"],"mappings":";;;;;UAuBiB,uBAAA;;EAEf,MAAA;EACA,YAAA;EAHe;EAKf,IAAA;;EAEA,UAAA;EACA,eAAA;AAAA;AAAA,UAGe,mBAAA;EAJf;EAMA,KAAA;EALe;EAOf,MAAA,GAAS,MAAM;EAJA;EAMf,GAAA;;;;;;;;EAQA,MAAA;AAAA;AAAA,UAGe,gBAAA;EACf,OAAA,GAAU,uBAAA;;EAEV,aAAA;EAFA;EAIA,GAAA,GAAM,mBAAmB;EAFzB;;;;;AAcM;AACP;;;;;EADC,MAAA;AAAA;AAAA,iBA2BsB,SAAA,CAAU,IAAA,GAAM,gBAAA,GAAwB,gBAAgB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/seo.ts","../src/integration.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -3,7 +3,6 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { faviconLinks, generateFavicons, writeFaviconManifest } from "@getvitops/utils";
 import vitops from "@getvitops/vite";
-import tailwindcss from "@tailwindcss/vite";
 
 export * from "@getvitops/utils"
 
@@ -39,6 +38,11 @@ function getvitops(opts = {}) {
 			const webComponents = opts.webComponents !== false;
 			const editor = opts.editor === true;
 			if (editor && !opts.css) logger.warn("editor: true needs a `css` config — it reads design-manifest.json.");
+			if (opts.legal && !opts.css) logger.warn("legal: needs a `css` config — the generation runs in the Vite plugin that `css` registers. Run `npx vitops legal` instead if you do not use `css`.");
+			if (opts.seo) {
+				if (!config.site) logger.warn("seo: needs the `site` astro.config option (your deployed URL) — without it <Seo /> omits canonical, og:url and any relative og:image rather than guessing an origin.");
+				if (config.integrations.some((i) => i.name === "emdash")) logger.warn("seo: emdash() is registered, and its <EmDashHead> emits the same title/description/canonical/og tags from the CMS. Use one or the other — rendering both duplicates every tag.");
+			}
 			const hasManifest = !!(opts.favicon?.name && opts.favicon?.themeColor);
 			let hasSvg = false;
 			if (opts.favicon) {
@@ -74,6 +78,26 @@ function getvitops(opts = {}) {
 					logger.info("copied web-component bundles → public/vitops/");
 				} else logger.warn(`@getvitops/core dist not found (${coreDist}); run build:core. Skipping WC copy.`);
 			}
+			let sitemapHref = null;
+			if (opts.sitemap) {
+				const registered = config.integrations.map((i) => i.name);
+				if (registered.includes("@astrojs/sitemap")) logger.info("sitemap: @astrojs/sitemap is already in your integrations — leaving yours in charge.");
+				else if (registered.includes("emdash")) logger.warn("sitemap: emdash() already serves /sitemap.xml from the database, which also covers on-demand pages a static sitemap cannot. Skipping — drop the `sitemap` option, or add @astrojs/sitemap to `integrations` yourself to run both.");
+				else if (!config.site) logger.warn("sitemap: needs the `site` astro.config option (your deployed URL) — a sitemap lists absolute URLs. Skipping.");
+				else {
+					let sitemap;
+					try {
+						({default: sitemap} = await import("@astrojs/sitemap"));
+					} catch {
+						throw new Error("[getvitops] sitemap requires `@astrojs/sitemap` in your devDependencies — install it, or drop the `sitemap` option.");
+					}
+					if (config.output === "server") logger.warn("sitemap: output: 'server' — @astrojs/sitemap lists prerendered routes only, so on-demand pages are left out. Add `export const prerender = true` to the pages you want indexed, or list them in `sitemap.customPages`.");
+					const sitemapOpts = opts.sitemap === true ? void 0 : opts.sitemap;
+					updateConfig({ integrations: [sitemap(sitemapOpts)] });
+					sitemapHref = `/${sitemapOpts?.filenameBase ?? "sitemap"}-index.xml`;
+					logger.info(`sitemap registered → ${sitemapHref.slice(1)}`);
+				}
+			}
 			updateConfig({ vite: { plugins: [virtualHeadPlugin({
 				favicons: !!opts.favicon,
 				faviconLinks: opts.favicon ? faviconLinks({
@@ -83,18 +107,31 @@ function getvitops(opts = {}) {
 				themeColor: opts.favicon?.themeColor ?? null,
 				webComponents,
 				wcBase: "/vitops",
-				editor
+				editor,
+				sitemap: sitemapHref,
+				site: config.site ?? null,
+				seo: opts.seo ?? {}
 			})] } });
 			if (opts.css) {
 				const format = opts.css.format ?? "tailwind";
+				if (format === "design") throw new Error("[getvitops] css.format: 'design' emits only DESIGN.md, not a stylesheet. Run `npx vitops generate --format design --out .` for that file, and set css.format to 'tailwind' | 'css' | 'bricks' here.");
 				const out = opts.css.out ?? "src/styles";
 				const plugins = [vitops({
 					input: opts.css.input ?? "design-system.json",
 					format,
 					out,
-					...editor ? { editorManifestDir: publicDir } : {}
+					...editor ? { editorManifestDir: publicDir } : {},
+					...opts.legal ? { legal: opts.legal } : {}
 				})];
-				if (format === "tailwind") plugins.push(...tailwindcss());
+				if (format === "tailwind") {
+					let tailwindcss;
+					try {
+						({default: tailwindcss} = await import("@tailwindcss/vite"));
+					} catch {
+						throw new Error("[getvitops] css.format: 'tailwind' requires `tailwindcss` and `@tailwindcss/vite` in your devDependencies — install them, or switch to css.format: 'css' for the standalone bundle.");
+					}
+					plugins.push(...tailwindcss());
+				}
 				updateConfig({ vite: { plugins } });
 				const cssFile = format === "tailwind" ? "tailwind.css" : "styles.css";
 				if (opts.css.inject !== false) {
@@ -108,5 +145,124 @@ function getvitops(opts = {}) {
 }
 
 //#endregion
-export { getvitops as default };
+//#region src/seo.ts
+/** `en-CA` → `en_CA`; Open Graph wants the underscore form. */
+const ogLocale = (locale) => locale.replace("-", "_");
+/**
+* Absolute URLs pass through; relative ones resolve against `site`, or are
+* dropped when there is no `site` to resolve them against. A relative `og:image`
+* or canonical is worse than none — crawlers resolve it against whatever origin
+* served the page.
+*/
+function absolute(url, site) {
+	if (!url) return null;
+	try {
+		return new URL(url).href;
+	} catch {
+		return site ? new URL(url, site).href : null;
+	}
+}
+/** Composes the robots directive, or null when nothing meaningful was asked for. */
+function resolveRobots(props, defaults) {
+	if (props.robots) return props.robots;
+	const { noindex, nofollow, noarchive, nocache, robotsExtras } = props;
+	if (noindex || nofollow || noarchive || nocache || robotsExtras) return [
+		noindex ? "noindex" : "index",
+		nofollow ? "nofollow" : "follow",
+		...noarchive ? ["noarchive"] : [],
+		...nocache ? ["nocache"] : [],
+		...robotsExtras ? [robotsExtras] : []
+	].join(", ");
+	return defaults.robots ?? null;
+}
+/**
+* Merges site defaults with page props into the final tag set.
+*
+* Pure — no `Astro`, no filesystem, no config lookup. Everything it needs comes
+* through its three arguments, which is what makes it testable and what keeps the
+* package free of the consumer-global coupling that sank the previous site model.
+*/
+function resolveSeo(defaults, props, ctx) {
+	const { site } = ctx;
+	const siteName = props.siteName ?? defaults.siteName ?? null;
+	const templated = props.title && defaults.titleTemplate && props.title !== siteName;
+	const title = props.title ? templated ? String(defaults.titleTemplate).replaceAll("%s", props.title) : props.title : defaults.defaultTitle ?? siteName;
+	const description = props.description ?? defaults.defaultDescription ?? null;
+	const canonical = props.canonical ? absolute(props.canonical, site) : site ? new URL(ctx.pathname + (ctx.search ?? ""), site).href : null;
+	const image = absolute(props.image, site) ?? absolute(defaults.openGraph?.image?.url, site);
+	const usingDefaultImage = !props.image;
+	const defaultImage = defaults.openGraph?.image;
+	const imageAlt = props.imageAlt ?? (usingDefaultImage ? defaultImage?.alt : void 0);
+	const imageWidth = props.imageWidth ?? (usingDefaultImage ? defaultImage?.width : void 0);
+	const imageHeight = props.imageHeight ?? (usingDefaultImage ? defaultImage?.height : void 0);
+	const imageType = props.imageType ?? (usingDefaultImage ? defaultImage?.type : void 0);
+	const type = props.type ?? defaults.openGraph?.type ?? "website";
+	const locale = props.locale ?? defaults.openGraph?.locale;
+	const openGraph = [];
+	const og = (property, content) => {
+		if (content !== null && content !== void 0 && content !== "") openGraph.push({
+			property,
+			content: String(content)
+		});
+	};
+	og("og:type", type);
+	og("og:title", title);
+	og("og:description", description);
+	og("og:url", canonical);
+	og("og:site_name", siteName);
+	og("og:locale", locale ? ogLocale(locale) : null);
+	for (const alt of defaults.openGraph?.localeAlternates ?? []) og("og:locale:alternate", ogLocale(alt));
+	og("og:image", image);
+	if (image) {
+		og("og:image:alt", imageAlt);
+		og("og:image:width", imageWidth);
+		og("og:image:height", imageHeight);
+		og("og:image:type", imageType);
+	}
+	if (type === "article" && props.article) {
+		const a = props.article;
+		og("article:published_time", a.publishedTime);
+		og("article:modified_time", a.modifiedTime);
+		og("article:expiration_time", a.expirationTime);
+		for (const author of a.authors ?? []) og("article:author", author);
+		og("article:section", a.section);
+		for (const tag of a.tags ?? []) og("article:tag", tag);
+	}
+	const twitter = [];
+	const tw = (name, content) => {
+		if (content) twitter.push({
+			name,
+			content
+		});
+	};
+	tw("twitter:card", image ? "summary_large_image" : defaults.twitter?.card ?? "summary");
+	tw("twitter:site", defaults.twitter?.site);
+	tw("twitter:creator", props.twitterCreator ?? defaults.twitter?.creator);
+	tw("twitter:title", title);
+	tw("twitter:description", description);
+	tw("twitter:image", image);
+	tw("twitter:image:alt", image ? imageAlt : null);
+	const verification = [];
+	if (defaults.googleSiteVerification) verification.push({
+		name: "google-site-verification",
+		content: defaults.googleSiteVerification
+	});
+	if (defaults.bingSiteVerification) verification.push({
+		name: "msvalidate.01",
+		content: defaults.bingSiteVerification
+	});
+	return {
+		title,
+		description,
+		canonical,
+		robots: resolveRobots(props, defaults),
+		openGraph,
+		twitter,
+		verification,
+		alternates: props.alternates ?? []
+	};
+}
+
+//#endregion
+export { getvitops as default, resolveSeo };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/integration.ts"],"sourcesContent":["/**\n * @getvitops/astro — the Astro integration. One entry wires the design system's\n * `<head>` contributions into a consumer site:\n *   - favicons + PWA manifest (generated into public/),\n *   - the web-component runtime bundles (copied into public/vitops/),\n *   - (opt-in) the design-system CSS, generated + auto-injected (no manual import).\n * The `<Head />` component (shipped alongside) renders the tags, reading resolved\n * config from the `virtual:getvitops/head` module this integration provides.\n */\nimport { cpSync, existsSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Format } from '@getvitops/generator';\nimport {\n  type FaviconLink,\n  faviconLinks,\n  generateFavicons,\n  writeFaviconManifest,\n} from '@getvitops/utils';\nimport vitops from '@getvitops/vite';\nimport tailwindcss from '@tailwindcss/vite';\nimport type { AstroIntegration } from 'astro';\n\nexport interface GetvitopsFaviconOptions {\n  /** Source SVG or PNG. */\n  source: string;\n  lowResSource?: string;\n  /** App name → enables `site.webmanifest`. */\n  name?: string;\n  /** PWA theme color (also `<meta name=\"theme-color\">`). */\n  themeColor?: string;\n  backgroundColor?: string;\n}\n\nexport interface GetvitopsCssOptions {\n  /** Path to design-system.json (default 'design-system.json'). */\n  input?: string;\n  /** Output format (default 'tailwind'). */\n  format?: Format;\n  /** Directory the generated CSS is written to (default 'src/styles'). */\n  out?: string;\n  /**\n   * Auto-inject the generated stylesheet into every SSR page (default true).\n   * Set false when other integrations add routes that must not inherit the\n   * design system (e.g. EmDash's `/_emdash/admin`) — then import the generated\n   * file (`<out>/tailwind.css` or `<out>/styles.css`) from your site layout so\n   * only your own pages (and previews rendered through them) are styled.\n   */\n  inject?: boolean;\n}\n\nexport interface GetvitopsOptions {\n  favicon?: GetvitopsFaviconOptions;\n  /** Copy + link the web-component bundles (default true). */\n  webComponents?: boolean;\n  /** Generate + auto-inject the design-system CSS. Off unless provided. */\n  css?: GetvitopsCssOptions;\n  /**\n   * Ship the live theme editor (default false).\n   *\n   * Copies `editor.js` into `public/vitops/`, loads it from `<Head />`, and mirrors\n   * the generated `design-manifest.json` next to it so `<wc-theme-editor>` resolves\n   * its default `/vitops/design-manifest.json`. Requires `css` (the manifest is a\n   * `css`-format output) — place the `<wc-theme-editor>` tag in your layout yourself.\n   *\n   * Editing is live on any deploy; **saving back** to `design-system.json` needs the\n   * dev server, so on a static build that button simply isn't rendered.\n   */\n  editor?: boolean;\n}\n\ninterface HeadData {\n  favicons: boolean;\n  faviconLinks: FaviconLink[];\n  themeColor: string | null;\n  webComponents: boolean;\n  wcBase: string;\n  editor: boolean;\n}\n\nconst VIRTUAL_ID = 'virtual:getvitops/head';\nconst RESOLVED_ID = `\\0${VIRTUAL_ID}`;\n\nfunction virtualHeadPlugin(data: HeadData) {\n  return {\n    name: '@getvitops/astro:virtual-head',\n    resolveId(id: string) {\n      return id === VIRTUAL_ID ? RESOLVED_ID : null;\n    },\n    load(id: string) {\n      return id === RESOLVED_ID ? `export default ${JSON.stringify(data)};` : null;\n    },\n  };\n}\n\nexport default function getvitops(opts: GetvitopsOptions = {}): AstroIntegration {\n  return {\n    name: '@getvitops/astro',\n    hooks: {\n      'astro:config:setup': async ({ config, updateConfig, injectScript, logger }) => {\n        const root = fileURLToPath(config.root);\n        const publicDir = fileURLToPath(config.publicDir);\n        const webComponents = opts.webComponents !== false;\n        const editor = opts.editor === true;\n        if (editor && !opts.css)\n          logger.warn('editor: true needs a `css` config — it reads design-manifest.json.');\n        const hasManifest = !!(opts.favicon?.name && opts.favicon?.themeColor);\n        let hasSvg = false;\n\n        // 1. Favicons + manifest → public/\n        if (opts.favicon) {\n          const source = resolve(root, opts.favicon.source);\n          hasSvg = source.endsWith('.svg');\n          await generateFavicons({\n            source,\n            outputDir: publicDir,\n            ...(opts.favicon.lowResSource\n              ? { lowResSource: resolve(root, opts.favicon.lowResSource) }\n              : {}),\n          });\n          if (opts.favicon.name && opts.favicon.themeColor) {\n            await writeFaviconManifest(publicDir, {\n              name: opts.favicon.name,\n              themeColor: opts.favicon.themeColor,\n              ...(opts.favicon.backgroundColor\n                ? { backgroundColor: opts.favicon.backgroundColor }\n                : {}),\n            });\n          }\n          logger.info('generated favicons + manifest → public/');\n        }\n\n        // 2. Web-component bundles → public/vitops/\n        if (webComponents) {\n          const corePkg = fileURLToPath(import.meta.resolve('@getvitops/core/package.json'));\n          const coreDist = join(dirname(corePkg), 'dist');\n          const dest = join(publicDir, 'vitops');\n          if (existsSync(coreDist)) {\n            const bundles = ['polyfills.js', 'deferred.js', 'elements.js', 'polyfills'];\n            if (editor) bundles.push('editor.js');\n            for (const f of bundles) {\n              const src = join(coreDist, f);\n              if (existsSync(src)) cpSync(src, join(dest, f), { recursive: true });\n            }\n            logger.info('copied web-component bundles → public/vitops/');\n          } else {\n            logger.warn(\n              `@getvitops/core dist not found (${coreDist}); run build:core. Skipping WC copy.`,\n            );\n          }\n        }\n\n        // 3. Virtual head module for <Head/>\n        updateConfig({\n          vite: {\n            plugins: [\n              virtualHeadPlugin({\n                favicons: !!opts.favicon,\n                faviconLinks: opts.favicon ? faviconLinks({ hasSvg, manifest: hasManifest }) : [],\n                themeColor: opts.favicon?.themeColor ?? null,\n                webComponents,\n                wcBase: '/vitops',\n                editor,\n              }),\n            ],\n          },\n        });\n\n        // 4. CSS — generate + compile + auto-inject (consumer imports nothing).\n        if (opts.css) {\n          const format: Format = opts.css.format ?? 'tailwind';\n          const out = opts.css.out ?? 'src/styles';\n          const plugins = [\n            vitops({\n              input: opts.css.input ?? 'design-system.json',\n              format,\n              out,\n              // Mirrored inside the generate pass so the served copy can never be\n              // missing on a cold start or stale after a config edit.\n              ...(editor ? { editorManifestDir: publicDir } : {}),\n            }),\n          ];\n          // tailwindcss() is typed against a newer vite than @getvitops/vite's\n          // peer; the Plugin shapes are structurally compatible at runtime\n          // (Astro forwards them verbatim), so bridge the two type identities.\n          if (format === 'tailwind') plugins.push(...(tailwindcss() as unknown as typeof plugins));\n          updateConfig({ vite: { plugins } });\n          const cssFile = format === 'tailwind' ? 'tailwind.css' : 'styles.css';\n          if (opts.css.inject !== false) {\n            const cssPath = resolve(root, out, cssFile);\n            injectScript('page-ssr', `import ${JSON.stringify(cssPath)};`);\n            logger.info(`design-system CSS (${format}) auto-injected from ${out}/${cssFile}`);\n          } else {\n            logger.info(\n              `design-system CSS (${format}) generated at ${out}/${cssFile} (inject: false — import it from your layout)`,\n            );\n          }\n        }\n      },\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/integration.ts","../src/seo.ts"],"sourcesContent":["/**\n * @getvitops/astro — the Astro integration. One entry wires the design system's\n * `<head>` contributions into a consumer site:\n *   - favicons + PWA manifest (generated into public/),\n *   - the web-component runtime bundles (copied into public/vitops/),\n *   - (opt-in) the design-system CSS, generated + auto-injected (no manual import).\n * The `<Head />` component (shipped alongside) renders the tags, reading resolved\n * config from the `virtual:getvitops/head` module this integration provides.\n */\nimport { cpSync, existsSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { LegalOutput, StylesheetFormat } from '@getvitops/generator';\nimport {\n  type FaviconLink,\n  faviconLinks,\n  generateFavicons,\n  writeFaviconManifest,\n} from '@getvitops/utils';\nimport vitops from '@getvitops/vite';\nimport type { AstroIntegration } from 'astro';\nimport type { GetvitopsSeoOptions } from './seo.ts';\n\nexport interface GetvitopsFaviconOptions {\n  /** Source SVG or PNG. */\n  source: string;\n  lowResSource?: string;\n  /** App name → enables `site.webmanifest`. */\n  name?: string;\n  /** PWA theme color (also `<meta name=\"theme-color\">`). */\n  themeColor?: string;\n  backgroundColor?: string;\n}\n\nexport interface GetvitopsCssOptions {\n  /** Path to design-system.json (default 'design-system.json'). */\n  input?: string;\n  /**\n   * Output format (default 'tailwind'). Narrower than the generator's `Format`\n   * on purpose: this option exists to produce a stylesheet to inject, and the\n   * `design` format emits only `DESIGN.md`. Run that one via the CLI\n   * (`vitops generate --format design --out .`).\n   */\n  format?: StylesheetFormat;\n  /** Directory the generated CSS is written to (default 'src/styles'). */\n  out?: string;\n  /**\n   * Auto-inject the generated stylesheet into every SSR page (default true).\n   * Set false when other integrations add routes that must not inherit the\n   * design system (e.g. EmDash's `/_emdash/admin`) — then import the generated\n   * file (`<out>/tailwind.css` or `<out>/styles.css`) from your site layout so\n   * only your own pages (and previews rendered through them) are styled.\n   */\n  inject?: boolean;\n}\n\nexport interface GetvitopsLegalOptions {\n  /** Path to the site config (JSON) the documents are rendered from. */\n  input: string;\n  /**\n   * Where to write them (default 'src/content/legal'). The default is a content\n   * collection: the documents are markdown, and a collection is what lets a page\n   * render one through your own layout rather than the integration injecting a\n   * route (which nothing in this package does).\n   */\n  out?: string;\n  /** Output format (default 'md'). */\n  format?: LegalOutput;\n  /** Environment whose A/B variant applies (default 'production'). */\n  siteEnv?: string;\n}\n\n/** `changefreq`, mirroring @astrojs/sitemap's `ChangeFreq`. */\nexport type GetvitopsSitemapChangeFreq =\n  | 'always'\n  | 'hourly'\n  | 'daily'\n  | 'weekly'\n  | 'monthly'\n  | 'yearly'\n  | 'never';\n\n/** One sitemap entry, mirroring @astrojs/sitemap's `SitemapItem`. */\nexport interface GetvitopsSitemapEntry {\n  url: string;\n  lastmod?: string;\n  changefreq?: GetvitopsSitemapChangeFreq;\n  priority?: number;\n  /** Alternate-language variants. `lang` is required, as upstream requires it. */\n  links?: { lang: string; hreflang?: string; url: string }[];\n}\n\n/**\n * Forwarded verbatim to `@astrojs/sitemap`. Deliberately a hand-written subset of\n * its `SitemapOptions` rather than a re-export: aliasing would put an\n * `import … from '@astrojs/sitemap'` — and, transitively via `SitemapItem`, from\n * `sitemap` — into this package's published .d.mts, which cannot resolve for the\n * consumers who don't install the optional peer. Worse, `skipLibCheck` (on by\n * default via astro's base tsconfig) *suppresses* that error, silently degrading\n * the option to `any` instead of failing loudly.\n *\n * Need something not listed here (e.g. `chunks`)? Add `sitemap()` to your own\n * `integrations` array — getvitops detects it and leaves yours in charge.\n */\nexport interface GetvitopsSitemapOptions {\n  /** Keep a page out of the sitemap. Receives the page's full absolute URL. */\n  filter?: (page: string) => boolean;\n  /** Absolute URLs of pages Astro doesn't build but the site serves. */\n  customPages?: string[];\n  /** Absolute URLs of externally-generated sitemaps to list in the index. */\n  customSitemaps?: string[];\n  /** Max entries per file before it splits (default 45000). */\n  entryLimit?: number;\n  /** Filename prefix (default 'sitemap' → `sitemap-index.xml`). */\n  filenameBase?: string;\n  changefreq?: GetvitopsSitemapChangeFreq;\n  lastmod?: Date;\n  priority?: number;\n  /** Per-entry rewrite; return `undefined` to drop the entry. */\n  serialize?: (\n    item: GetvitopsSitemapEntry,\n  ) => GetvitopsSitemapEntry | Promise<GetvitopsSitemapEntry | undefined> | undefined;\n  /** Emit `<xhtml:link rel=\"alternate\">` for localised routes. */\n  i18n?: { defaultLocale: string; locales: Record<string, string> };\n  /** XSL stylesheet to prettify the XML (path relative to `site`, or absolute URL). */\n  xslURL?: string;\n  /** XML namespaces to exclude (all included by default). */\n  namespaces?: { news?: boolean; xhtml?: boolean; image?: boolean; video?: boolean };\n}\n\nexport interface GetvitopsOptions {\n  favicon?: GetvitopsFaviconOptions;\n  /** Copy + link the web-component bundles (default true). */\n  webComponents?: boolean;\n  /** Generate + auto-inject the design-system CSS. Off unless provided. */\n  css?: GetvitopsCssOptions;\n  /**\n   * Ship the live theme editor (default false).\n   *\n   * Copies `editor.js` into `public/vitops/`, loads it from `<Head />`, and mirrors\n   * the generated `design-manifest.json` next to it so `<wc-theme-editor>` resolves\n   * its default `/vitops/design-manifest.json`. Requires `css` (the manifest is a\n   * `css`-format output) — place the `<wc-theme-editor>` tag in your layout yourself.\n   *\n   * Editing is live on any deploy; **saving back** to `design-system.json` needs the\n   * dev server, so on a static build that button simply isn't rendered.\n   */\n  editor?: boolean;\n  /**\n   * Render the site's legal documents (privacy policy, terms, cookie notice)\n   * from a site config, and re-render when it changes. Off unless provided.\n   *\n   * Requires `css`, which is what registers the Vite plugin that runs the\n   * generation — without it the documents would be written once and never\n   * refresh. Not using `css`? Run `vitops legal` from the CLI instead; it is the\n   * same renderer and works in any stack.\n   */\n  legal?: GetvitopsLegalOptions;\n  /**\n   * Emit `sitemap-index.xml` + `sitemap-0.xml` via `@astrojs/sitemap`, and link it\n   * from `<Head />`. Off unless provided; `true` uses its defaults.\n   *\n   * Needs `@astrojs/sitemap` (an optional peer — install it yourself) and the\n   * `site` astro.config option, since a sitemap lists absolute URLs.\n   *\n   * Skipped with a warning when `emdash()` is registered — EmDash serves its own\n   * database-driven `/sitemap.xml` — and deferred to when you already list\n   * `@astrojs/sitemap` yourself. Note it enumerates **prerendered** routes only,\n   * so on-demand pages of an `output: 'server'` site are not listed.\n   */\n  sitemap?: boolean | GetvitopsSitemapOptions;\n  /**\n   * Site-level defaults for `<Seo />` (`@getvitops/astro/Seo.astro`) — site name,\n   * title template, Open Graph + Twitter defaults, verification tokens. Off unless\n   * provided; per-page props override every field.\n   *\n   * Needs the `site` astro.config option for canonical and `og:url`; without it\n   * `<Seo />` omits every absolute-URL tag rather than deriving one from the\n   * request, and this warns at build time.\n   *\n   * On an EmDash site prefer `<EmDashHead>`, which covers the same tags from the\n   * CMS — using both double-emits them.\n   */\n  seo?: GetvitopsSeoOptions;\n}\n\n/**\n * Serialised into the virtual module with `JSON.stringify`, so every field here\n * must be JSON-representable — no functions. (That is why the sitemap's *href*\n * lives here and its options, which carry `filter`/`serialize`, do not.)\n */\ninterface HeadData {\n  favicons: boolean;\n  faviconLinks: FaviconLink[];\n  themeColor: string | null;\n  webComponents: boolean;\n  wcBase: string;\n  editor: boolean;\n  /** `<link rel=\"sitemap\">` target, or null when no sitemap was registered. */\n  sitemap: string | null;\n  /** `config.site`, so `<Seo />` has a canonical base even without `Astro.site`. */\n  site: string | null;\n  /** Site-level `<Seo />` defaults. Function-free, hence serialisable. */\n  seo: GetvitopsSeoOptions;\n}\n\nconst VIRTUAL_ID = 'virtual:getvitops/head';\nconst RESOLVED_ID = `\\0${VIRTUAL_ID}`;\n\nfunction virtualHeadPlugin(data: HeadData) {\n  return {\n    name: '@getvitops/astro:virtual-head',\n    resolveId(id: string) {\n      return id === VIRTUAL_ID ? RESOLVED_ID : null;\n    },\n    load(id: string) {\n      return id === RESOLVED_ID ? `export default ${JSON.stringify(data)};` : null;\n    },\n  };\n}\n\nexport default function getvitops(opts: GetvitopsOptions = {}): AstroIntegration {\n  return {\n    name: '@getvitops/astro',\n    hooks: {\n      'astro:config:setup': async ({ config, updateConfig, injectScript, logger }) => {\n        const root = fileURLToPath(config.root);\n        const publicDir = fileURLToPath(config.publicDir);\n        const webComponents = opts.webComponents !== false;\n        const editor = opts.editor === true;\n        if (editor && !opts.css)\n          logger.warn('editor: true needs a `css` config — it reads design-manifest.json.');\n        if (opts.legal && !opts.css)\n          logger.warn(\n            'legal: needs a `css` config — the generation runs in the Vite plugin that `css` ' +\n              'registers. Run `npx vitops legal` instead if you do not use `css`.',\n          );\n        if (opts.seo) {\n          // Warn once here rather than letting every page silently drop its\n          // canonical — a missing absolute URL is invisible in the output.\n          if (!config.site)\n            logger.warn(\n              'seo: needs the `site` astro.config option (your deployed URL) — without it <Seo /> ' +\n                'omits canonical, og:url and any relative og:image rather than guessing an origin.',\n            );\n          if (config.integrations.some((i) => i.name === 'emdash'))\n            logger.warn(\n              'seo: emdash() is registered, and its <EmDashHead> emits the same title/description/' +\n                'canonical/og tags from the CMS. Use one or the other — rendering both duplicates ' +\n                'every tag.',\n            );\n        }\n        const hasManifest = !!(opts.favicon?.name && opts.favicon?.themeColor);\n        let hasSvg = false;\n\n        // 1. Favicons + manifest → public/\n        if (opts.favicon) {\n          const source = resolve(root, opts.favicon.source);\n          hasSvg = source.endsWith('.svg');\n          await generateFavicons({\n            source,\n            outputDir: publicDir,\n            ...(opts.favicon.lowResSource\n              ? { lowResSource: resolve(root, opts.favicon.lowResSource) }\n              : {}),\n          });\n          if (opts.favicon.name && opts.favicon.themeColor) {\n            await writeFaviconManifest(publicDir, {\n              name: opts.favicon.name,\n              themeColor: opts.favicon.themeColor,\n              ...(opts.favicon.backgroundColor\n                ? { backgroundColor: opts.favicon.backgroundColor }\n                : {}),\n            });\n          }\n          logger.info('generated favicons + manifest → public/');\n        }\n\n        // 2. Web-component bundles → public/vitops/\n        if (webComponents) {\n          const corePkg = fileURLToPath(import.meta.resolve('@getvitops/core/package.json'));\n          const coreDist = join(dirname(corePkg), 'dist');\n          const dest = join(publicDir, 'vitops');\n          if (existsSync(coreDist)) {\n            const bundles = ['polyfills.js', 'deferred.js', 'elements.js', 'polyfills'];\n            if (editor) bundles.push('editor.js');\n            for (const f of bundles) {\n              const src = join(coreDist, f);\n              if (existsSync(src)) cpSync(src, join(dest, f), { recursive: true });\n            }\n            logger.info('copied web-component bundles → public/vitops/');\n          } else {\n            logger.warn(\n              `@getvitops/core dist not found (${coreDist}); run build:core. Skipping WC copy.`,\n            );\n          }\n        }\n\n        // 3. Sitemap — opt-in, delegated to the official @astrojs/sitemap.\n        //\n        // Registered through updateConfig rather than imported at module scope,\n        // because the package is an optional peer. Astro core has no\n        // addIntegration() (that is Starlight's plugin API), but appending here is\n        // supported: runHookConfigSetup re-reads `integrations.length` each\n        // iteration and assigns the merged array back onto the settings, and\n        // @astrojs/sitemap declares no `astro:config:setup` hook at all — only\n        // config:done / routes:resolved / build:done, which all run afterwards.\n        //\n        // Runs before the virtual head module so <Head /> can link the result.\n        let sitemapHref: string | null = null;\n        if (opts.sitemap) {\n          const registered = config.integrations.map((i) => i.name);\n          if (registered.includes('@astrojs/sitemap')) {\n            logger.info(\n              'sitemap: @astrojs/sitemap is already in your integrations — leaving yours in charge.',\n            );\n          } else if (registered.includes('emdash')) {\n            logger.warn(\n              'sitemap: emdash() already serves /sitemap.xml from the database, which also covers ' +\n                'on-demand pages a static sitemap cannot. Skipping — drop the `sitemap` option, or ' +\n                'add @astrojs/sitemap to `integrations` yourself to run both.',\n            );\n          } else if (!config.site) {\n            logger.warn(\n              'sitemap: needs the `site` astro.config option (your deployed URL) — a sitemap lists ' +\n                'absolute URLs. Skipping.',\n            );\n          } else {\n            // Optional peer, loaded the same way as @tailwindcss/vite below.\n            //\n            // The import is cast because the option surface here is this package's\n            // narrowed mirror, not @astrojs/sitemap's own `SitemapOptions`: the two\n            // disagree on `serialize`'s entry type (upstream's `changefreq` is the\n            // `EnumChangefreq` enum, ours the string union a consumer actually\n            // wants to write). The shapes are identical at runtime — the value is\n            // forwarded verbatim. Cast the module rather than widening the local to\n            // `(o?: unknown)`, which is the wrong variance: a target accepting\n            // `unknown` promises to accept *any* argument, which upstream doesn't.\n            type SitemapFactory = (o?: GetvitopsSitemapOptions) => AstroIntegration;\n            let sitemap: SitemapFactory;\n            try {\n              ({ default: sitemap } = (await import('@astrojs/sitemap')) as unknown as {\n                default: SitemapFactory;\n              });\n            } catch {\n              throw new Error(\n                '[getvitops] sitemap requires `@astrojs/sitemap` in your devDependencies — ' +\n                  'install it, or drop the `sitemap` option.',\n              );\n            }\n            if (config.output === 'server')\n              logger.warn(\n                \"sitemap: output: 'server' — @astrojs/sitemap lists prerendered routes only, so \" +\n                  'on-demand pages are left out. Add `export const prerender = true` to the pages ' +\n                  'you want indexed, or list them in `sitemap.customPages`.',\n              );\n            const sitemapOpts = opts.sitemap === true ? undefined : opts.sitemap;\n            updateConfig({ integrations: [sitemap(sitemapOpts)] });\n            sitemapHref = `/${sitemapOpts?.filenameBase ?? 'sitemap'}-index.xml`;\n            logger.info(`sitemap registered → ${sitemapHref.slice(1)}`);\n          }\n        }\n\n        // 4. Virtual head module for <Head/>\n        updateConfig({\n          vite: {\n            plugins: [\n              virtualHeadPlugin({\n                favicons: !!opts.favicon,\n                faviconLinks: opts.favicon ? faviconLinks({ hasSvg, manifest: hasManifest }) : [],\n                themeColor: opts.favicon?.themeColor ?? null,\n                webComponents,\n                wcBase: '/vitops',\n                editor,\n                sitemap: sitemapHref,\n                site: config.site ?? null,\n                seo: opts.seo ?? {},\n              }),\n            ],\n          },\n        });\n\n        // 5. CSS — generate + compile + auto-inject (consumer imports nothing).\n        if (opts.css) {\n          const format: StylesheetFormat = opts.css.format ?? 'tailwind';\n          // Typed out above, but a plain-JS config reaches here unchecked and\n          // would otherwise fail late with an unresolvable `styles.css` import.\n          if ((format as string) === 'design')\n            throw new Error(\n              \"[getvitops] css.format: 'design' emits only DESIGN.md, not a stylesheet. \" +\n                'Run `npx vitops generate --format design --out .` for that file, and set ' +\n                \"css.format to 'tailwind' | 'css' | 'bricks' here.\",\n            );\n          const out = opts.css.out ?? 'src/styles';\n          const plugins = [\n            vitops({\n              input: opts.css.input ?? 'design-system.json',\n              format,\n              out,\n              // Mirrored inside the generate pass so the served copy can never be\n              // missing on a cold start or stale after a config edit.\n              ...(editor ? { editorManifestDir: publicDir } : {}),\n              // Same reasoning: inside the pass, so the documents track the site\n              // config in dev instead of going stale after the first build.\n              ...(opts.legal ? { legal: opts.legal } : {}),\n            }),\n          ];\n          // Tailwind is an optional peer — only the `tailwind` format needs it,\n          // so it's loaded here rather than imported at module scope. (The\n          // plugin is typed against a newer vite than @getvitops/vite's peer;\n          // the Plugin shapes are structurally compatible at runtime — Astro\n          // forwards them verbatim — so bridge the two type identities.)\n          if (format === 'tailwind') {\n            let tailwindcss: () => unknown[];\n            try {\n              ({ default: tailwindcss } = await import('@tailwindcss/vite'));\n            } catch {\n              throw new Error(\n                \"[getvitops] css.format: 'tailwind' requires `tailwindcss` and `@tailwindcss/vite` \" +\n                  'in your devDependencies — install them, or switch to css.format: ' +\n                  \"'css' for the standalone bundle.\",\n              );\n            }\n            plugins.push(...(tailwindcss() as unknown as typeof plugins));\n          }\n          updateConfig({ vite: { plugins } });\n          const cssFile = format === 'tailwind' ? 'tailwind.css' : 'styles.css';\n          if (opts.css.inject !== false) {\n            const cssPath = resolve(root, out, cssFile);\n            injectScript('page-ssr', `import ${JSON.stringify(cssPath)};`);\n            logger.info(`design-system CSS (${format}) auto-injected from ${out}/${cssFile}`);\n          } else {\n            logger.info(\n              `design-system CSS (${format}) generated at ${out}/${cssFile} (inject: false — import it from your layout)`,\n            );\n          }\n        }\n      },\n    },\n  };\n}\n","/**\n * The `<Seo />` resolution layer — site-level defaults merged with per-page props\n * into the exact tags to emit.\n *\n * Kept separate from `Seo.astro` deliberately. The component this replaces\n * (`SEO.astro`, deleted in c949cae) fused resolution with markup, which is why it\n * was never unit-tested and why its title handling drifted: it computed a title\n * for `og:title` but left `<title>` to the layout, so the two could disagree.\n * Everything decidable lives here and is asserted in `seo.test.ts`; the component\n * only renders what this returns.\n */\n\n/** Twitter card types, per <https://developer.x.com/en/docs/twitter-for-websites/cards>. */\nexport type SeoTwitterCard = 'summary' | 'summary_large_image' | 'app' | 'player';\n\n/** Open Graph object types this component knows how to describe. */\nexport type SeoOgType = 'website' | 'article' | 'profile';\n\n/**\n * Site-level SEO defaults, passed to `getvitops({ seo })` and baked into the\n * `virtual:getvitops/head` module. Per-page `<Seo />` props override these.\n *\n * The vocabulary mirrors the site-config schema's `seo` block\n * (`@getvitops/generator`, `src/site.ts`) so a `SiteConfig` → these adapter would\n * be a flat field map — but it is not imported from there. This is the\n * integration's own option surface, and it must stay JSON-serialisable: it is\n * `JSON.stringify`d into the virtual module, so no functions, no `URL`s, no dates.\n */\nexport interface GetvitopsSeoOptions {\n  /** `og:site_name`, and the `<title>` when a page passes none. */\n  siteName?: string;\n  /**\n   * Page-title pattern; `%s` is the page's own title. e.g. `'%s · Acme'`.\n   *\n   * Skipped when a page's title already equals `siteName` — a homepage titled\n   * \"Acme\" emits `Acme`, not `Acme · Acme` — and never applied to `defaultTitle`.\n   */\n  titleTemplate?: string;\n  /** `<title>` for pages that pass none. Used verbatim — the template is not applied. */\n  defaultTitle?: string;\n  /** `<meta name=\"description\">` for pages that pass none. */\n  defaultDescription?: string;\n  /** Site-wide robots directive, e.g. `'index,follow,max-image-preview:large'`. */\n  robots?: string;\n  /** Google Search Console verification token. */\n  googleSiteVerification?: string;\n  /** Bing Webmaster Tools verification token. */\n  bingSiteVerification?: string;\n  openGraph?: {\n    /** Default `og:type` (default `'website'`). */\n    type?: SeoOgType;\n    /** `og:locale`. Written either way — `en-CA` and `en_CA` both emit `en_CA`. */\n    locale?: string;\n    /** Additional locales the same content exists in → `og:locale:alternate`. */\n    localeAlternates?: string[];\n    /** Fallback share image. Relative URLs resolve against `site`. */\n    image?: { url: string; alt?: string; width?: number; height?: number; type?: string };\n  };\n  twitter?: {\n    /** Card type when no image resolves (default `'summary'`). */\n    card?: SeoTwitterCard;\n    /** The site's own handle, `@acme`. */\n    site?: string;\n    /** Default author handle, `@ada`. */\n    creator?: string;\n  };\n}\n\n/** Per-page `<Seo />` props. Everything is optional; defaults fill the gaps. */\nexport interface SeoProps {\n  /** Page title, before `titleTemplate` is applied. */\n  title?: string;\n  description?: string;\n  /** Overrides the computed canonical. Relative values resolve against `site`. */\n  canonical?: string;\n  /** Overrides `og:site_name` and the title fallback. */\n  siteName?: string;\n  /** Share image for this page. Relative URLs resolve against `site`. */\n  image?: string;\n  imageAlt?: string;\n  imageWidth?: number;\n  imageHeight?: number;\n  /** MIME type of the share image, e.g. `'image/png'`. */\n  imageType?: string;\n  noindex?: boolean;\n  nofollow?: boolean;\n  noarchive?: boolean;\n  nocache?: boolean;\n  /** Extra robots directives, e.g. `'max-snippet:-1'`. Appended to the composed value. */\n  robotsExtras?: string;\n  /** Full robots override. Wins over the flags above and the site default. */\n  robots?: string;\n  /** `og:type` for this page (default: the site default, else `'website'`). */\n  type?: SeoOgType;\n  /** Emitted only when `type` is `'article'`. */\n  article?: {\n    publishedTime?: string;\n    modifiedTime?: string;\n    expirationTime?: string;\n    authors?: string[];\n    section?: string;\n    tags?: string[];\n  };\n  /** `og:locale` for this page. */\n  locale?: string;\n  /** Twitter author handle for this page, `@ada`. */\n  twitterCreator?: string;\n  /**\n   * Translations of *this* page, as `<link rel=\"alternate\" hreflang>`.\n   *\n   * Explicit only, and it must include the current page. Nothing is inferred:\n   * the deleted component derived alternates from the site's locale list and\n   * pointed every one of them at that locale's homepage, so every page on the\n   * site claimed the homepage as its translation. Only the page knows its own\n   * translated URLs. Pass `hreflang: 'x-default'` for the fallback entry.\n   */\n  alternates?: { hreflang: string; href: string }[];\n}\n\n/** A `<meta property>` tag (Open Graph uses `property`, not `name`). */\nexport interface SeoPropertyTag {\n  property: string;\n  content: string;\n}\n\n/** A `<meta name>` tag. */\nexport interface SeoNameTag {\n  name: string;\n  content: string;\n}\n\n/** Everything `<Seo />` renders, already decided. `null` means \"emit nothing\". */\nexport interface ResolvedSeo {\n  title: string | null;\n  description: string | null;\n  canonical: string | null;\n  robots: string | null;\n  openGraph: SeoPropertyTag[];\n  twitter: SeoNameTag[];\n  verification: SeoNameTag[];\n  alternates: { hreflang: string; href: string }[];\n}\n\n/** Render context supplied by the component from `Astro`. */\nexport interface SeoContext {\n  /**\n   * The deployed origin — `Astro.site`, or `config.site` via the virtual module.\n   *\n   * `undefined` when neither is set, and then every absolute-URL tag is dropped\n   * rather than being derived from the request. `astro-seo` falls back to\n   * `Astro.url` here; on a static build that is `http://localhost:4321`, which\n   * would bake a localhost canonical into production HTML.\n   */\n  site?: URL | undefined;\n  /** `Astro.url.pathname` — already includes `base`. */\n  pathname: string;\n  /** `Astro.url.search`, if the canonical should keep the query string. */\n  search?: string;\n}\n\n/** `en-CA` → `en_CA`; Open Graph wants the underscore form. */\nconst ogLocale = (locale: string) => locale.replace('-', '_');\n\n/**\n * Absolute URLs pass through; relative ones resolve against `site`, or are\n * dropped when there is no `site` to resolve them against. A relative `og:image`\n * or canonical is worse than none — crawlers resolve it against whatever origin\n * served the page.\n */\nfunction absolute(url: string | undefined, site: URL | undefined): string | null {\n  if (!url) return null;\n  try {\n    return new URL(url).href;\n  } catch {\n    return site ? new URL(url, site).href : null;\n  }\n}\n\n/** Composes the robots directive, or null when nothing meaningful was asked for. */\nfunction resolveRobots(props: SeoProps, defaults: GetvitopsSeoOptions): string | null {\n  if (props.robots) return props.robots;\n  const { noindex, nofollow, noarchive, nocache, robotsExtras } = props;\n  if (noindex || nofollow || noarchive || nocache || robotsExtras) {\n    return [\n      noindex ? 'noindex' : 'index',\n      nofollow ? 'nofollow' : 'follow',\n      ...(noarchive ? ['noarchive'] : []),\n      ...(nocache ? ['nocache'] : []),\n      ...(robotsExtras ? [robotsExtras] : []),\n    ].join(', ');\n  }\n  // No explicit default either: emit nothing. `index, follow` is what crawlers\n  // already assume, so stating it adds bytes and no meaning.\n  return defaults.robots ?? null;\n}\n\n/**\n * Merges site defaults with page props into the final tag set.\n *\n * Pure — no `Astro`, no filesystem, no config lookup. Everything it needs comes\n * through its three arguments, which is what makes it testable and what keeps the\n * package free of the consumer-global coupling that sank the previous site model.\n */\nexport function resolveSeo(\n  defaults: GetvitopsSeoOptions,\n  props: SeoProps,\n  ctx: SeoContext,\n): ResolvedSeo {\n  const { site } = ctx;\n  const siteName = props.siteName ?? defaults.siteName ?? null;\n\n  // The template applies to a page's own title only, and only when that title\n  // isn't already the site name. Two ways to get \"Acme · Acme\" otherwise: running\n  // it over `defaultTitle`, and a homepage whose own title happens to equal the\n  // site name — which is the common case, not an edge case.\n  const templated = props.title && defaults.titleTemplate && props.title !== siteName;\n  const title = props.title\n    ? templated\n      ? String(defaults.titleTemplate).replaceAll('%s', props.title)\n      : props.title\n    : (defaults.defaultTitle ?? siteName);\n\n  const description = props.description ?? defaults.defaultDescription ?? null;\n\n  const canonical = props.canonical\n    ? absolute(props.canonical, site)\n    : site\n      ? new URL(ctx.pathname + (ctx.search ?? ''), site).href\n      : null;\n\n  const image = absolute(props.image, site) ?? absolute(defaults.openGraph?.image?.url, site);\n  // Only inherit the default image's metadata when the page didn't bring its own\n  // image — otherwise a page's image would carry the default's alt text.\n  const usingDefaultImage = !props.image;\n  const defaultImage = defaults.openGraph?.image;\n  const imageAlt = props.imageAlt ?? (usingDefaultImage ? defaultImage?.alt : undefined);\n  const imageWidth = props.imageWidth ?? (usingDefaultImage ? defaultImage?.width : undefined);\n  const imageHeight = props.imageHeight ?? (usingDefaultImage ? defaultImage?.height : undefined);\n  const imageType = props.imageType ?? (usingDefaultImage ? defaultImage?.type : undefined);\n\n  const type = props.type ?? defaults.openGraph?.type ?? 'website';\n  const locale = props.locale ?? defaults.openGraph?.locale;\n\n  const openGraph: SeoPropertyTag[] = [];\n  const og = (property: string, content: string | number | null | undefined) => {\n    if (content !== null && content !== undefined && content !== '')\n      openGraph.push({ property, content: String(content) });\n  };\n\n  og('og:type', type);\n  og('og:title', title);\n  og('og:description', description);\n  og('og:url', canonical);\n  og('og:site_name', siteName);\n  og('og:locale', locale ? ogLocale(locale) : null);\n  for (const alt of defaults.openGraph?.localeAlternates ?? [])\n    og('og:locale:alternate', ogLocale(alt));\n  og('og:image', image);\n  if (image) {\n    og('og:image:alt', imageAlt);\n    og('og:image:width', imageWidth);\n    og('og:image:height', imageHeight);\n    og('og:image:type', imageType);\n  }\n  if (type === 'article' && props.article) {\n    const a = props.article;\n    og('article:published_time', a.publishedTime);\n    og('article:modified_time', a.modifiedTime);\n    og('article:expiration_time', a.expirationTime);\n    for (const author of a.authors ?? []) og('article:author', author);\n    og('article:section', a.section);\n    for (const tag of a.tags ?? []) og('article:tag', tag);\n  }\n\n  const twitter: SeoNameTag[] = [];\n  const tw = (name: string, content: string | null | undefined) => {\n    if (content) twitter.push({ name, content });\n  };\n  // A card with a large image is only honoured if there *is* an image.\n  tw('twitter:card', image ? 'summary_large_image' : (defaults.twitter?.card ?? 'summary'));\n  tw('twitter:site', defaults.twitter?.site);\n  tw('twitter:creator', props.twitterCreator ?? defaults.twitter?.creator);\n  tw('twitter:title', title);\n  tw('twitter:description', description);\n  tw('twitter:image', image);\n  tw('twitter:image:alt', image ? imageAlt : null);\n\n  const verification: SeoNameTag[] = [];\n  if (defaults.googleSiteVerification)\n    verification.push({\n      name: 'google-site-verification',\n      content: defaults.googleSiteVerification,\n    });\n  if (defaults.bingSiteVerification)\n    verification.push({ name: 'msvalidate.01', content: defaults.bingSiteVerification });\n\n  return {\n    title,\n    description,\n    canonical,\n    robots: resolveRobots(props, defaults),\n    openGraph,\n    twitter,\n    verification,\n    alternates: props.alternates ?? [],\n  };\n}\n"],"mappings":"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"}