@goflag/cli 0.2.0 → 0.2.1

package/README.md

@@ -492,23 +492,44 @@ console.log(report.summary); // { brokenLinks, missingTranslations, seoIssues, v
 ## Repository layout
 
 ```
-packages/cli/      @goflag/cli — the CLI (installs the `goflag` command)
+packages/cli/      @goflag/cli, the CLI (installs the `goflag` command)
+packages/next/     @goflag/next, the Next.js library (see below)
+apps/website/      goflag.tech, the landing page and the documentation
 tools/name-holder/ the bare `goflag` name on npm, a signpost to @goflag/cli
 ```
 
-That is the whole tree. `@goflag/next` (the Next.js library) and the
-documentation site are planned but deliberately absent: the workspace globs
-(`packages/*`, `apps/*`) are ready for them, and empty stubs for things that do
-not exist are how a repository accumulates code nobody calls.
+That is the whole tree. Neither `packages/next` nor `apps/**` may import from
+the CLI: the two products stay independently useful, and an ESLint rule
+enforces it rather than trusting memory.
 
-When they land, they must not import from the CLI: the two products stay
-independently useful, and an ESLint rule enforces it rather than trusting
-memory.
+## The other half: `@goflag/next`
+
+goflag tells you what is wrong. It does not tell you how to stop writing it
+wrong. [`@goflag/next`](packages/next) is a route registry for the Next.js App
+Router that produces the HTML this auditor would have nothing to say about.
+
+```ts
+export const routes = site.routes({
+  home: { path: "" },
+  docs: collection(allDocs, { path: (d) => `/docs/${d.slug}`, locale: "en" }),
+});
+
+// app/sitemap.ts
+export default () => routes.sitemap();
+```
+
+A sitemap derived separately from the metadata is two derivations of one truth,
+held in agreement by vigilance, and their disagreement is what goflag reports as
+`hreflang.sitemap-mismatch`. Projecting both from one registry makes that
+finding unrepresentable. Full documentation at
+[goflag.tech/docs/next](https://goflag.tech/docs/next), and the API reference in
+[`packages/next/README.md`](packages/next/README.md).
 
 ## Develop locally
 
-Requires pnpm `11.18.0` (pinned via `packageManager` — `corepack enable` picks
-it up). Run these from the repository root:
+Requires pnpm, pinned via `packageManager` in the root `package.json` — run
+`corepack enable` once and it picks up the right version by itself. Run these
+from the repository root:
 
 ```sh
 pnpm install

package/dist/{chunk-GFM3YN5N.js → chunk-6WOWKLXY.js}

@@ -1782,6 +1782,9 @@ function sortIssues(issues) {
 
 // src/lib/core/i18n.ts
 var BCP47_LOOSE = /^[a-z]{2,3}(-[a-z]{2}|-\d{3})?$/i;
+function localeIdentity(tag) {
+  return tag.trim().toLowerCase();
+}
 function looksLikeLocaleSegment(segment) {
   return BCP47_LOOSE.test(segment);
 }
@@ -1823,7 +1826,7 @@ function buildI18nMatrix(pages, options = {}) {
         continue;
       }
       const { route } = splitRoute(altUrl.pathname);
-      const locale = alt.isXDefault ? "x-default" : alt.hreflang;
+      const locale = alt.isXDefault ? "x-default" : localeIdentity(alt.hreflang);
       record(route || selfRoute, locale, altUrl.toString());
     }
   }
@@ -1857,14 +1860,15 @@ function reciprocityIssues(pages) {
     const url = page.fetch.finalUrl;
     const seenLocalesOnPage = /* @__PURE__ */ new Set();
     for (const alt of page.links.alternates) {
-      const locale = alt.isXDefault ? "x-default" : alt.hreflang;
+      const raw = alt.isXDefault ? "x-default" : alt.hreflang;
+      const locale = alt.isXDefault ? "x-default" : localeIdentity(alt.hreflang);
       seenLocalesOnPage.add(locale);
       if (!isValidLocale(locale)) {
         issues.push({
           code: "locale.invalid",
           url,
-          locale,
-          message: `\`hreflang="${locale}"\` is not a valid BCP 47 tag.`
+          locale: raw,
+          message: `\`hreflang="${raw}"\` is not a valid BCP 47 tag.`
         });
         continue;
       }
@@ -1923,7 +1927,7 @@ function dedupeBy(items, key) {
 function splitRoute(pathname) {
   const segments = pathname.split("/").filter(Boolean);
   if (segments.length > 0 && looksLikeLocaleSegment(segments[0])) {
-    const locale = segments[0];
+    const locale = localeIdentity(segments[0]);
     const rest = segments.slice(1).join("/");
     return { route: rest ? `/${rest}` : "/", locale };
   }
@@ -4271,4 +4275,4 @@ export {
   summarize,
   Logger
 };
-//# sourceMappingURL=chunk-GFM3YN5N.js.map
+//# sourceMappingURL=chunk-6WOWKLXY.js.map