@cparkerwebm/webmonterey 1.1.0 → 1.2.0

package/src/includes/webmonterey/webmaster/webmaster.ts

@@ -0,0 +1,89 @@
+/*
+ * The webmaster credit, in ONE place.
+ *
+ * Two surfaces render it and they cannot share a component: the site footer is an .astro
+ * component, and transactional email is a string with inline styles (email clients strip <style>
+ * blocks). Without this module the wording exists twice, and the next time it changes one copy
+ * gets missed.
+ *
+ * WHERE THE FOOTER LINK GOES CHANGED. It used to leave the client's site for webmonterey.com. Now
+ * it goes to the site's OWN /webmaster page - indexable, in the sitemap, rendered with the site's
+ * chrome - and THAT page carries the one outbound link. Three things that buys: the visitor stays
+ * on the client's site; every client site has a page that says who to call when something is
+ * wrong; and the outbound link sits on a real page with real copy, which is a backlink rather
+ * than a footer credit. The email footer keeps the outbound link, because an email cannot
+ * usefully point at a page on the site it is about.
+ *
+ * utm_content is ALWAYS the production domain from webmonterey.json, never the host the page is
+ * served from - a preview build still reports the client's own domain, so staging traffic does
+ * not fragment the attribution. It is written with underscores (`example_com`): a dot makes the
+ * value look like a hostname, and analytics UIs read it as one rather than as the label it is.
+ *
+ * THE AGENCY'S IDENTITY IS HERE TOO, for the webmaster page's structured data. It is the one
+ * place in the package that names the agency, deliberately: the credit is the package saying who
+ * built the framework, which a public package is allowed to do, and keeping it in one module
+ * means a change to the name, the address or a profile is one edit.
+ */
+
+/** The credit wording. Rendered verbatim on the site and in email. */
+export const CREDIT_TEXT = 'Powered by WebMonterey';
+
+/** The page every site has. Fixed - the footer, the sitemap and the doctor all rely on it. */
+export const WEBMASTER_PATH = '/webmaster';
+
+/** The share image the webmaster page carries, served from the package by the integration. */
+export const WEBMASTER_OG_PATH = '/webmaster/og.png';
+
+/**
+ * The agency, as the webmaster page's structured data describes it. The `@id` is the same
+ * entity webmonterey.com declares for itself, so every client page points at one organization
+ * rather than a hundred copies of it.
+ */
+export const AGENCY = {
+  id: 'https://webmonterey.com/#organization',
+  name: 'WebMonterey',
+  url: 'https://webmonterey.com/',
+  description:
+    'A webmaster maintenance service in Monterey, California: design, build, hosting, security and ongoing care for small-business websites.',
+  address: { addressLocality: 'Monterey', addressRegion: 'CA', addressCountry: 'US' },
+  sameAs: [
+    /* The Google Business Profile, by its Knowledge Graph id - the stable form of the share link. */
+    'https://www.google.com/search?kgmid=/g/11nvks0plt',
+    'https://www.linkedin.com/company/webmonterey',
+    'https://www.facebook.com/webmonterey',
+    'https://www.youtube.com/@webmonterey',
+    'https://www.pinterest.com/webmonterey',
+    'https://github.com/webmonterey',
+    'https://www.crunchbase.com/organization/webmonterey',
+    'https://www.alignable.com/monterey-ca/webmonterey',
+    'https://www.yelp.com/biz/webmonterey-monterey',
+  ],
+} as const;
+
+/**
+ * Which surface the click came from. Kept separate from utm_content so the report can tell a
+ * page click from an email click without splitting it per client.
+ */
+export type CreditMedium = 'website' | 'email';
+
+/**
+ * The client's domain as a UTM label rather than as a domain. Dots only - the value is
+ * otherwise left exactly as webmonterey.json wrote it, so what lands in the report is still
+ * recognizably the site it came from.
+ */
+export function contentTag(domain: string): string {
+  return domain.replace(/\./g, '_');
+}
+
+/** The attributed link to the agency for one client site. */
+export function creditUrl(domain: string, medium: CreditMedium = 'website'): string {
+  const params = new URLSearchParams({
+    utm_source: 'client',
+    utm_medium: medium,
+    utm_campaign: 'webmaster',
+    /* See the note above: a dot here is a link waiting to be made out of the query string. */
+    utm_content: contentTag(domain),
+  });
+
+  return `${AGENCY.url}?${params}`;
+}

package/src/integration/index.ts

@@ -24,8 +24,9 @@
 import type { AstroIntegration } from 'astro';
 import sitemap from '@astrojs/sitemap';
 
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 import { compileToCss } from '../design/compile.ts';
 import { imageSize } from './image-size.ts';
@@ -67,9 +68,27 @@ export interface WebmontereyOptions {
    * Set false for a site publishing a sitemap another way, rather than having two disagree.
    */
   sitemap?: boolean;
+  /**
+   * Serve `/webmaster` and its share image. Default true.
+   *
+   * The page every site has: who built it, who to call. The footer credit links to it. A client
+   * who will not have it sets this false and the credit then has nowhere to point - so the
+   * footer should drop the credit too, and the agreement should say so.
+   */
+  webmaster?: boolean;
+  /**
+   * The branch Workers Builds deploys to production. Default `main`.
+   *
+   * Every other branch is a PREVIEW, and a preview build is different on purpose: every page is
+   * noindex, there is no sitemap, robots.txt disallows everything, and Google Tag Manager does
+   * not load - so a client's review link can never be indexed, and clicking around it never
+   * lands in their analytics. Detected from WORKERS_CI_BRANCH, which Workers Builds injects.
+   */
+  productionBranch?: string;
 }
 
 const VIRTUAL = {
+  build: 'virtual:webm/build',
   site: 'virtual:webm/site',
   design: 'virtual:webm/design',
   tokens: 'virtual:webm/tokens.css',
@@ -78,8 +97,18 @@ const VIRTUAL = {
   custom: 'virtual:webm/custom',
   shareImage: 'virtual:webm/share-image',
   icons: 'virtual:webm/icons',
+  webmasterOg: 'virtual:webm/webmaster-og',
 } as const;
 
+/*
+ * THE WEBMASTER PAGE'S SHARE IMAGE, read here and not in the endpoint that serves it. The
+ * Cloudflare adapter builds server modules for the workerd target, where `import.meta.url` is
+ * not a file URL, so a `new URL('../assets/...', import.meta.url)` inside a route throws
+ * "Invalid URL string" at prerender. This integration runs in Node at config time, where the
+ * path is real; the bytes travel to the endpoint as base64 through a virtual module.
+ */
+const WEBMASTER_OG = fileURLToPath(new URL('../assets/opengraph-webmaster.png', import.meta.url));
+
 /** Vite resolves virtual ids to a `\0`-prefixed form so other plugins leave them alone. */
 const resolved = (id: string) => `\0${id}`;
 
@@ -103,6 +132,17 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
         const app = appEnabled(files.site);
         const appPath = resolveAppPath(files.site);
 
+        /*
+         * BRANCH PREVIEW OR PRODUCTION. Workers Builds injects WORKERS_CI_BRANCH; anything that
+         * is not the production branch is a preview. A local build has no branch and is treated
+         * as production, which is what `npm run preview` and the e2e need. See the option.
+         */
+        const branch = process.env.WORKERS_CI_BRANCH ?? null;
+        const preview = branch !== null && branch !== (options.productionBranch ?? 'main');
+        if (preview) {
+          logger.info(`branch "${branch}" is a preview: noindex, no sitemap, no analytics`);
+        }
+
         /*
          * Editing either config file must rebuild. Without this a palette change in design.json
          * shows nothing until the dev server is restarted, which reads as the compiler being
@@ -157,7 +197,7 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
           output: 'static',
 
           integrations:
-            site && options.sitemap !== false
+            site && !preview && options.sitemap !== false
               ? [
                   sitemap({
                     filter: (page) => {
@@ -214,6 +254,8 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
                 },
                 load(id: string) {
                   switch (id) {
+                    case resolved(VIRTUAL.build):
+                      return `export default ${JSON.stringify({ preview, branch })};`;
                     case resolved(VIRTUAL.site):
                       return `export default ${JSON.stringify(files.site)};`;
                     case resolved(VIRTUAL.design):
@@ -235,7 +277,7 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
                        * both tags - the scrapers all measure the image themselves anyway, so
                        * saying nothing beats saying something wrong.
                        */
-                      const size = imageSize(join(root, 'public/open-graph.png'));
+                      const size = imageSize(join(root, 'public/opengraph.png'));
                       return `export default ${JSON.stringify(size)};`;
                     }
                     case resolved(VIRTUAL.icons): {
@@ -283,6 +325,12 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
                     }
                     case resolved(VIRTUAL.forms):
                       return `export const FORMS = ${JSON.stringify(loadForms(root))};`;
+                    case resolved(VIRTUAL.webmasterOg):
+                      /* Bytes and the REAL size, so the page never declares dimensions the file does not have. */
+                      return `export default ${JSON.stringify({
+                        base64: readFileSync(WEBMASTER_OG, 'base64'),
+                        ...(imageSize(WEBMASTER_OG) ?? { width: null, height: null }),
+                      })};`;
                     case resolved(VIRTUAL.registry):
                       /*
                        * Re-exported from the client repo, because every visible component lives
@@ -357,6 +405,21 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
           injectRoute({ pattern: '/webm', entrypoint: '@cparkerwebm/webmonterey/pages/webm' });
         }
 
+        /*
+         * THE WEBMASTER PAGE, and its share image served from the package. Indexable and in the
+         * sitemap - the footer credit links here rather than off the site. See pages/webmaster.
+         */
+        if (options.webmaster !== false) {
+          injectRoute({
+            pattern: '/webmaster',
+            entrypoint: '@cparkerwebm/webmonterey/pages/webmaster',
+          });
+          injectRoute({
+            pattern: '/webmaster/og.png',
+            entrypoint: '@cparkerwebm/webmonterey/pages/webmaster-og',
+          });
+        }
+
         /*
          * THE WEB APP'S PUBLIC PATH. Only when the site has switched the app on AND named a path
          * other than the folder - with the default there is nothing to rewrite, and a middleware

package/src/integration/virtual.d.ts

@@ -4,6 +4,15 @@
  * These do not exist on disk. Each resolves at build time to something in the CLIENT repo, which
  * a package cannot import relatively - see includes/webmonterey/config.ts.
  */
+/**
+ * What this build is FOR. `preview` is true on any Workers Builds branch other than the
+ * production one - every page noindex, no sitemap, no analytics. A local build is not a preview.
+ */
+declare module 'virtual:webm/build' {
+  const build: { preview: boolean; branch: string | null };
+  export default build;
+}
+
 declare module 'virtual:webm/site' {
   import type { SiteConfig } from '../includes/webmonterey/config.ts';
   const config: SiteConfig;
@@ -28,8 +37,14 @@ declare module 'virtual:webm/icons' {
 /** The client's own stylesheet - src/styles/custom/. Side-effect import only. */
 declare module 'virtual:webm/custom';
 
+/** The webmaster page's share image - bytes as base64 and its measured size - from the package. */
+declare module 'virtual:webm/webmaster-og' {
+  const image: { base64: string; width: number | null; height: number | null };
+  export default image;
+}
+
 /**
- * The real pixel size of `public/open-graph.png`, measured at build time, or null when there is
+ * The real pixel size of `public/opengraph.png`, measured at build time, or null when there is
  * no readable file there. Nothing else can check it: public/ is copied verbatim.
  */
 declare module 'virtual:webm/share-image' {

package/src/layouts/base.astro

@@ -35,6 +35,7 @@ import {
 import { header, footer, panels, structuredData } from 'virtual:webm/registry';
 import measuredShareImage from 'virtual:webm/share-image';
 import icons from 'virtual:webm/icons';
+import build from 'virtual:webm/build';
 
 /*
  * Site-wide plumbing, wired in once here rather than per page.
@@ -96,7 +97,7 @@ interface Props {
    */
   noindex?: boolean;
   /**
-   * The social share image, as a path under `public/`. Defaults to `/open-graph.png`.
+   * The social share image, as a path under `public/`. Defaults to `/opengraph.png`.
    *
    * MUST be a public/ path, never an imported asset run through `getImage`. On a prerendered
    * route `getImage` returns a built `/_astro/…` file, but on a `prerender = false` route
@@ -109,7 +110,7 @@ interface Props {
   /*
    * Dimensions of `shareImage`, in pixels. THEY MUST TRAVEL WITH IT.
    *
-   * These default to the size of the shipped `public/open-graph.png`. Files in public/ are
+   * These default to the size of the shipped `public/opengraph.png`. Files in public/ are
    * copied verbatim and never processed, so nothing can measure the real image at build time
    * and nothing will warn when these stop matching — a client dropping in a differently sized
    * card image silently publishes false dimensions. Found exactly that way: a live site
@@ -143,6 +144,13 @@ interface Props {
    * consistent state rather than an unset one.
    */
   analytics?: boolean;
+  /**
+   * Render the site's `structuredData` component. Default true.
+   *
+   * Set false on a route that emits its own graph through the `head` slot - the package's
+   * /webmaster page does, about the agency - so two nodes never claim the same page `@id`.
+   */
+  structuredData?: boolean;
   /**
    * The back-to-top control. Default true.
    *
@@ -157,10 +165,10 @@ const {
   title,
   description,
   brandTitle = brandTitles,
-  noindex = false,
-  shareImage = '/open-graph.png',
+  noindex: noindexProp = false,
+  shareImage = '/opengraph.png',
   /*
-   * MEASURED, not assumed. Both default to the real size of public/open-graph.png, read from the
+   * MEASURED, not assumed. Both default to the real size of public/opengraph.png, read from the
    * file's own header at build time - so replacing the card art cannot leave the tags describing
    * the old one, which is what happened on every generation-2 site.
    *
@@ -170,9 +178,21 @@ const {
   shareImageWidth = measuredShareImage?.width ?? null,
   shareImageHeight = measuredShareImage?.height ?? null,
   analytics = true,
+  structuredData: renderStructuredData = true,
   scrollTop = true,
 } = Astro.props;
 
+/*
+ * A BRANCH PREVIEW IS NOINDEX, EVERY PAGE. The review link a client gets is a public workers.dev
+ * URL, and a search engine that finds one indexes a duplicate of the site under the wrong
+ * hostname. noindex also suppresses the canonical and og:url below, so the preview sends one
+ * signal rather than "do not index me" beside "my real address is over there". GTM is skipped on
+ * a preview for the same reason in the other direction: a client clicking through their review
+ * link must not show up in their own analytics.
+ */
+const noindex = noindexProp || build.preview;
+const analyticsOn = analytics && !build.preview;
+
 /*
  * Canonical URL. Only emitted once `site` is derived from `domain` in webmonterey.json.
  * Astro.site is undefined until then, and a canonical pointing at localhost is worse than none.
@@ -264,7 +284,7 @@ const StructuredData = structuredData;
 
     <!-- FIRST. Sets consent state and Consent Mode defaults before any third party loads. -->
     <ConsentInit />
-    {analytics && gtmId && <TagManager id={gtmId} />}
+    {analyticsOn && gtmId && <TagManager id={gtmId} />}
 
     {
       /*
@@ -351,7 +371,7 @@ const StructuredData = structuredData;
     */
     }
     {
-      StructuredData && !noindex && (
+      StructuredData && renderStructuredData && !noindex && (
         <StructuredData title={title} description={description} image={shareImageUrl} />
       )
     }
@@ -363,7 +383,7 @@ const StructuredData = structuredData;
     <a class="webm-skip-link" href="#webm-main">Skip to content</a>
 
     <!-- GTM's noscript iframe must be the first thing in <body>. -->
-    {analytics && gtmId && <TagManager id={gtmId} noscript />}
+    {analyticsOn && gtmId && <TagManager id={gtmId} noscript />}
 
     <slot name="header">{Header && <Header />}</slot>
 

package/src/package.test.ts

@@ -86,6 +86,26 @@ test('every directory the code reads out of the package is published', () => {
   }
 });
 
+test('the webmaster share image is a share-card shape, and is what the seed ships too', async () => {
+  /*
+   * og:image:width/height on the webmaster page are MEASURED from this file by the integration,
+   * so any size works - but a crawler crops to roughly 1.91:1 and wants at least 1200 wide, and
+   * an image outside that gets letterboxed or rejected. The same artwork is the default share
+   * image a client site starts with, so the two must not drift apart.
+   */
+  const { imageSize } = await import('./integration/image-size.ts');
+  const size = imageSize(join(ROOT, 'src/assets/opengraph-webmaster.png'));
+  assert.ok(size, 'src/assets/opengraph-webmaster.png is not a readable PNG/JPEG/GIF');
+  assert.ok(size.width >= 1200, `at least 1200 wide, got ${size.width}`);
+  const ratio = size.width / size.height;
+  assert.ok(Math.abs(ratio - 1.91) < 0.03, `share cards are ~1.91:1, got ${ratio.toFixed(2)}`);
+  assert.equal(
+    readFileSync(join(ROOT, 'src/assets/opengraph-webmaster.png'), 'base64'),
+    readFileSync(join(ROOT, 'template/public/opengraph.png'), 'base64'),
+    'the seed share image and the webmaster image are the same artwork',
+  );
+});
+
 test('the package does not depend on itself', () => {
   /*
    * IT DID, AND IT SHIPPED. package.json carried

package/src/pages/robots.txt.ts

@@ -21,8 +21,20 @@
  * before concluding the file has been overwritten.
  */
 import type { APIRoute } from 'astro';
+import build from 'virtual:webm/build';
 
 export const GET: APIRoute = ({ site }) => {
+  /*
+   * A BRANCH PREVIEW DISALLOWS EVERYTHING. Every page on a preview is already noindex; this is
+   * the belt to that brace, and it is the one place Disallow is right - there is nothing on a
+   * preview a crawler should ever fetch, and no noindex tag it needs to see.
+   */
+  if (build.preview) {
+    return new Response('User-agent: *\nDisallow: /\n', {
+      headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+    });
+  }
+
   const lines = ['User-agent: *', 'Allow: /'];
 
   /*

package/src/pages/webmaster-og.png.ts

@@ -0,0 +1,31 @@
+/*
+ * /webmaster/og.png - the webmaster page's share image, served FROM THE PACKAGE.
+ *
+ * public/ is copied verbatim from the site root and the package cannot add to it; a file seeded
+ * there is written once and never refreshed. This endpoint serves the image out of the package
+ * instead, so it is same-origin on every site, needs nothing in the client's repo, and a
+ * redesign reaches every site on `npm update`. Prerendered, so the deployed result is a plain
+ * static file.
+ *
+ * The bytes arrive through a virtual module rather than a file read: the Cloudflare adapter
+ * builds routes for the workerd target, where `import.meta.url` is not a file URL and a
+ * relative `new URL()` throws at prerender. The integration reads the file in Node and inlines
+ * it. See integration/index.ts.
+ *
+ * The page reads the image's measured size from the same module, so og:image:width and height
+ * are always the file's own.
+ */
+import type { APIRoute } from 'astro';
+import image from 'virtual:webm/webmaster-og';
+
+export const prerender = true;
+
+export const GET: APIRoute = () => {
+  const bytes = Uint8Array.from(atob(image.base64), (c) => c.charCodeAt(0));
+  return new Response(bytes, {
+    headers: {
+      'Content-Type': 'image/png',
+      'Cache-Control': 'public, max-age=86400',
+    },
+  });
+};

package/src/pages/webmaster.astro

@@ -0,0 +1,121 @@
+---
+/*
+ * /webmaster - the page every site has, saying who built it and who to call.
+ *
+ * Injected by the integration on every site (with a `webmaster: false` off switch), rendered
+ * through the site's own layout so it carries the client's header, footer and tokens. INDEXABLE
+ * and in the sitemap, on purpose: the footer credit links here rather than off the site, and this
+ * page carries the one outbound link to the agency - a followed link on a real page with real
+ * copy, which is a backlink rather than a footer decoration. It is also the answer to "something
+ * is wrong with the website, who do I contact?" on the site itself.
+ *
+ * Every word is overridable through `copy.webmaster` in webmonterey.json, like everything else
+ * the package puts in front of a visitor.
+ *
+ * ITS OWN STRUCTURED DATA, and the site's is switched off for this route. The graph here is about
+ * the agency - a WebPage whose subject is the agency's Organization, using the same `@id` the
+ * agency's own site declares, so every client page points at one entity rather than a hundred
+ * copies. The site's structuredData component would also emit a WebPage for this URL, and two
+ * nodes claiming the same `@id` is worse than one.
+ *
+ * The share image is served from the package at /webmaster/og.png, so a redesign reaches every
+ * site on `npm update` and nothing has to be seeded into public/. Its og:image dimensions are
+ * measured from the file by the integration, never typed in.
+ */
+import Base from '../layouts/base.astro';
+import { copy } from '../includes/webmonterey/copy.ts';
+import {
+  AGENCY,
+  creditUrl,
+  WEBMASTER_OG_PATH,
+} from '../includes/webmonterey/webmaster/webmaster.ts';
+import { domain, hasDomain } from '../includes/webmonterey/site.ts';
+import { compact, renderJsonLd } from '../includes/webmonterey/structured-data/nodes.ts';
+import { pageHeader } from 'virtual:webm/registry';
+import ogImage from 'virtual:webm/webmaster-og';
+import build from 'virtual:webm/build';
+
+const PageHeader = pageHeader;
+const text = copy.webmaster;
+const agencyHref = hasDomain ? creditUrl(domain, 'website') : AGENCY.url;
+
+/*
+ * The graph needs a real origin for stable @id values, which is the same gate the canonical tag
+ * and the site's own structured data use. Until `domain` is set there is no page @id to claim.
+ */
+let jsonLd: string | null = null;
+/* No graph on a preview: the page is noindex there and an @id on a workers.dev host is noise. */
+if (Astro.site && !build.preview) {
+  const url = new URL(Astro.url.pathname, Astro.site).href;
+  jsonLd = renderJsonLd([
+    compact({
+      '@type': 'WebPage',
+      '@id': `${url}#webpage`,
+      url,
+      name: text.title,
+      description: text.description,
+      isPartOf: { '@id': new URL('#website', Astro.site).href },
+      about: { '@id': AGENCY.id },
+      inLanguage: 'en',
+    }),
+    compact({
+      '@type': 'ProfessionalService',
+      '@id': AGENCY.id,
+      name: AGENCY.name,
+      url: AGENCY.url,
+      description: AGENCY.description,
+      address: { '@type': 'PostalAddress', ...AGENCY.address },
+      sameAs: [...AGENCY.sameAs],
+    }),
+  ]);
+}
+---
+
+<Base
+  title={text.title}
+  description={text.description}
+  shareImage={WEBMASTER_OG_PATH}
+  shareImageWidth={ogImage.width}
+  shareImageHeight={ogImage.height}
+  structuredData={false}
+>
+  <Fragment slot="head">
+    {jsonLd && <script type="application/ld+json" set:html={jsonLd} />}
+  </Fragment>
+
+  {
+    /*
+     * The site's page header if it declares one, so this page looks like every other page on the
+     * site; the router's plain <h1> otherwise. Same fallback the block router uses.
+     */
+    PageHeader ? (
+      <PageHeader title={text.title} description={text.description} />
+    ) : (
+      <section class="webm-section" data-space="sm">
+        <div class="webm-container" data-width="text">
+          <h1>{text.title}</h1>
+        </div>
+      </section>
+    )
+  }
+
+  <section class="webm-section" data-space="lg">
+    <div class="webm-container" data-width="text">
+      <div class="webm-stack">
+        {
+          /*
+           * The agency is named as a link in the first paragraph - the one outbound link on the
+           * site, followed, with the UTM parameters. Opens in a new tab because it leaves the
+           * site; noopener without noreferrer, because the referrer is the attribution.
+           */
+        }
+        <p>
+          {text.intro.before}
+          <a href={agencyHref} target="_blank" rel="noopener">{AGENCY.name}</a>
+          {text.intro.after}
+        </p>
+        {text.body.map((paragraph) => <p>{paragraph}</p>)}
+      </div>
+    </div>
+  </section>
+</Base>

package/template/scripts/test-hooks.mjs

@@ -5,7 +5,7 @@
  * would otherwise force a choice between "no tests" and "rewrite every import in the app to
  * suit the test runner". The app wins that argument, so the adaptation lives here.
  *
- *   1. EXTENSIONLESS RELATIVE IMPORTS — `from '../credits/credit'`. Node ESM requires the
+ *   1. EXTENSIONLESS RELATIVE IMPORTS — `from '../webmaster/webmaster'`. Node ESM requires the
  *      extension; bundlers resolve it. The resolve hook appends `.ts` when the bare specifier
  *      does not resolve but the `.ts` file exists.
  *

package/src/includes/webmonterey/credits/Credit.astro

@@ -1,80 +0,0 @@
----
-/*
- * The WebMonterey agency credit. Goes in the site footer.
- *
- *   <Credit />   ->   Powered by WebMonterey
- *
- * The wording and the UTM-tagged link both come from credit.ts, which the email footer also
- * imports — the two surfaces must say the same thing, and email cannot reuse this component
- * (scoped CSS does not survive an email client).
- */
-import { CREDIT_TEXT, creditUrl } from './credit.ts';
-import { domain, hasDomain } from '../site.ts';
-
-interface Props {
-  class?: string;
-}
-
-const { class: className } = Astro.props;
-
-// Fail loudly at build rather than emit a credit link pointing at a placeholder.
-if (!hasDomain) {
-  throw new Error(
-    '[webm] webmonterey.json "domain" is still CHANGEME. Set the production domain - the ' +
-      'agency credit link uses it for utm_content attribution.',
-  );
-}
-
-const href = creditUrl(domain, 'website');
----
-
-<p class:list={['webm-credit', className]}>
-  {
-    /*
-    OPENS IN A NEW TAB, and `target` is the half that was missing.
-
-    This element carried `rel="noopener"` and no `target`, which does nothing at all - noopener
-    only means anything alongside a target - and the credit navigated away from the client's site
-    in the same tab. Verified broken on live client sites before this was fixed.
-
-    `noopener` stays: without it the opened page gets a `window.opener` handle back into this one.
-    Deliberately NOT `noreferrer` - the referrer is the attribution, and stripping it would leave
-    only the utm_content.
-
-    The visually-hidden note is not decoration. A link that moves the user to another tab without
-    saying so is a semantics bug, and semantics are correctness rather than styling. The email
-    footer deliberately does NOT carry it - the hiding technique needs a stylesheet, and email
-    clients strip those. See emails/footer.ts.
-
-    NO `title` ATTRIBUTE, and that is the correct state rather than an omission. `title` is not
-    reliably announced by screen readers, is unreachable by keyboard and touch entirely, and
-    either duplicates the link text or competes with it for the accessible name. The link text
-    plus the hidden note IS the accessible name.
-  */
-  }
-  <a href={href} target="_blank" rel="noopener">
-    {CREDIT_TEXT}<span class="webm-visually-hidden"> (opens in a new tab)</span>
-  </a>
-</p>
-
-<style>
-  @layer webm.components.core {
-    .webm-credit {
-      font-size: var(--webm-font-size-xs);
-      color: var(--webm-text-muted);
-    }
-
-    /*
-     * Underline at the text's own color. An underline in --webm-border-subtle is ~1.3:1 on
-     * white — effectively invisible, leaving nothing to mark the link as clickable.
-     */
-    .webm-credit a {
-      color: inherit;
-      text-decoration-color: currentColor;
-    }
-
-    .webm-credit a:hover {
-      color: var(--webm-link-hover);
-    }
-  }
-</style>