bsmnt 0.3.2 → 0.4.0

package/src/helpers/integrate/sanity/files/lib/integrations/sanity/queries.ts

@@ -64,3 +64,45 @@ export const ARTICLE_BY_ID_QUERY = defineQuery(`
     _updatedAt
   }
 `);
+
+export const PAGE_QUERY = defineQuery(`
+  *[_type == "example" && slug.current == $slug][0] {
+    _id,
+    title,
+    slug,
+    hero,
+    ${richTextWithLinks},
+    features,
+    tags,
+    metadata,
+    publishedAt,
+    _updatedAt
+  }
+`);
+
+export const SITEMAP_ARTICLES_QUERY = defineQuery(`
+  *[_type == "article" && defined(slug.current)] {
+    title,
+    slug,
+    _updatedAt,
+    "noIndex": metadata.noIndex
+  }
+`);
+
+export const SITEMAP_PAGES_QUERY = defineQuery(`
+  *[_type == "example" && defined(slug.current)] {
+    title,
+    slug,
+    _updatedAt,
+    "noIndex": metadata.noIndex
+  }
+`);
+
+export const ALL_PAGES_QUERY = defineQuery(`
+  *[_type == "example" && defined(slug.current)] | order(publishedAt desc) {
+    slug,
+    _updatedAt,
+    "noIndex": metadata.noIndex
+  }
+`);
+

package/src/helpers/integrate/sanity/files/lib/integrations/sanity/sitemap.ts

@@ -0,0 +1,90 @@
+import { client } from "./client";
+import { SITEMAP_ARTICLES_QUERY, SITEMAP_PAGES_QUERY } from "./queries";
+
+export interface SitemapEntry {
+	loc: string;
+	lastmod: string;
+	changefreq: string;
+	priority: number;
+}
+
+interface SitemapDocument {
+	slug?: {
+		current?: string | null;
+	} | null;
+	_updatedAt: string;
+	noIndex?: boolean | null;
+}
+
+/**
+ * Fetch all published articles as sitemap entries.
+ * Excludes articles with metadata.noIndex set to true.
+ */
+async function getArticleEntries(baseUrl: string): Promise<SitemapEntry[]> {
+	if (!client) return [];
+
+	try {
+		const articles =
+			(await client.fetch(SITEMAP_ARTICLES_QUERY)) as SitemapDocument[] | null;
+
+		if (!articles) return [];
+
+		return articles
+			.filter((article) => article.slug?.current && !article.noIndex)
+			.map((article) => ({
+				loc: `${baseUrl}/blog/${article.slug!.current!}`,
+				lastmod: new Date(article._updatedAt).toISOString(),
+				changefreq: "weekly",
+				priority: 0.7,
+			}));
+	} catch (error) {
+		console.error("Error fetching article sitemap entries:", error);
+		return [];
+	}
+}
+
+/**
+ * Fetch all published CMS pages as sitemap entries.
+ * Supports nested slugs and excludes metadata.noIndex pages.
+ */
+async function getPageEntries(baseUrl: string): Promise<SitemapEntry[]> {
+	if (!client) return [];
+
+	try {
+		const pages =
+			(await client.fetch(SITEMAP_PAGES_QUERY)) as SitemapDocument[] | null;
+
+		if (!pages) return [];
+
+		return pages
+			.filter((page) => page.slug?.current && !page.noIndex)
+			.map((page) => ({
+				loc: `${baseUrl}/${page.slug!.current!}`,
+				lastmod: new Date(page._updatedAt).toISOString(),
+				changefreq: "monthly",
+				priority: 0.8,
+			}));
+	} catch (error) {
+		console.error("Error fetching page sitemap entries:", error);
+		return [];
+	}
+}
+
+/**
+ * Fetch all CMS-managed sitemap entries across all collections.
+ *
+ * To add a new collection, create a getter function (e.g. getPageEntries)
+ * and include it in the Promise.all below.
+ */
+export async function getCMSSitemapEntries(
+	baseUrl: string,
+): Promise<SitemapEntry[]> {
+	const entries = await Promise.all([
+		getArticleEntries(baseUrl),
+		getPageEntries(baseUrl),
+		// Add more collections here as needed:
+		// getProjectEntries(baseUrl),
+	]);
+
+	return entries.flat();
+}

package/src/helpers/integrate/sanity/files/lib/utils/metadata.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
 /**
  * Metadata Generation Utilities
@@ -26,8 +27,7 @@ interface GenerateMetadataOptions {
 	authors?: string[];
 }
 
-const APP_BASE_URL =
-	process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 /**
  * Generate complete metadata object for pages

package/src/helpers/integrate/sanity/files/lib/utils/url.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolves the application base URL from environment variables.
+ *
+ * Priority:
+ * 1. NEXT_PUBLIC_BASE_URL  - explicit override (custom domains)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel (production domain)
+ * 3. VERCEL_URL - auto-set by Vercel (preview/branch deploys)
+ * 4. localhost fallback
+ */
+export function getBaseUrl(): string {
+	if (process.env.NEXT_PUBLIC_BASE_URL)
+		return process.env.NEXT_PUBLIC_BASE_URL;
+	if (process.env.VERCEL_PROJECT_PRODUCTION_URL)
+		return `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`;
+	if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`;
+	return "http://localhost:3000";
+}
+
+export function getPageUrl(baseUrl: string, slug: string | null): string {
+	if (!slug) return baseUrl;
+	const path = slug.startsWith("/") ? slug : `/${slug}`;
+	return `${baseUrl.replace(/\/$/, "")}${path}`;
+}

package/src/templates/next-default/.env.example

@@ -13,9 +13,9 @@
 # CORE (Recommended)
 # ============================================
 
-# Base URL for your site (used for SEO, canonical URLs, etc.)
-# Development: http://localhost:3000
-# Production: https://your-domain.com
+# Base URL (sitemaps, OG tags, canonical URLs)
+# On Vercel: auto-detected if unset. Set explicitly for custom domains.
+# Local: http://localhost:3000
 NEXT_PUBLIC_BASE_URL="http://localhost:3000"
 
 # Draft mode secret for preview functionality

package/src/templates/next-default/app/layout.tsx

@@ -5,6 +5,7 @@ import { Link } from "@/components/ui/link";
 import AppData from "@/package.json";
 import "@/lib/styles/global.css";
 import { cn } from "@/lib/styles/cn";
+import { getBaseUrl } from "@/lib/utils/url";
 import {
   JsonLd,
   generateWebSiteJsonLd,
@@ -15,8 +16,7 @@ const APP_NAME = AppData.name;
 const APP_DEFAULT_TITLE = "Basement Starter";
 const APP_TITLE_TEMPLATE = "%s - Basement Starter";
 const APP_DESCRIPTION = AppData.description;
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 const geist = Geist({
   subsets: ["latin"],

package/src/templates/next-default/app/robots.ts

@@ -1,7 +1,7 @@
 import type { MetadataRoute } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 export default function robots(): MetadataRoute.Robots {
   return {

package/src/templates/next-default/app/sitemap.xml/route.ts

@@ -0,0 +1,51 @@
+import { getBaseUrl } from "@/lib/utils/url";
+
+const BASE_URL = getBaseUrl();
+
+export const dynamic = "force-dynamic";
+
+interface SitemapEntry {
+	loc: string;
+	lastmod: string;
+	changefreq: string;
+	priority: number;
+}
+
+function toXml(entries: SitemapEntry[]): string {
+	const urls = entries
+		.map(
+			(entry) => `
+  <url>
+    <loc>${entry.loc}</loc>
+    <lastmod>${entry.lastmod}</lastmod>
+    <changefreq>${entry.changefreq}</changefreq>
+    <priority>${entry.priority}</priority>
+  </url>`,
+		)
+		.join("");
+
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${urls}
+</urlset>`;
+}
+
+function getStaticEntries(): SitemapEntry[] {
+	return [
+		{
+			loc: BASE_URL,
+			lastmod: new Date().toISOString(),
+			changefreq: "daily",
+			priority: 1,
+		},
+	];
+}
+
+export async function GET() {
+	const entries: SitemapEntry[] = getStaticEntries();
+
+	return new Response(toXml(entries), {
+		headers: {
+			"Content-Type": "application/xml",
+		},
+	});
+}

package/src/templates/next-default/lib/utils/metadata.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
 /**
  * Metadata Generation Utilities
@@ -26,8 +27,7 @@ interface GenerateMetadataOptions {
   authors?: string[];
 }
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 /**
  * Generate complete metadata object for pages

package/src/templates/next-default/lib/utils/url.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the application base URL from environment variables.
+ *
+ * Priority:
+ * 1. NEXT_PUBLIC_BASE_URL  - explicit override (custom domains)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel (production domain)
+ * 3. VERCEL_URL - auto-set by Vercel (preview/branch deploys)
+ * 4. localhost fallback
+ */
+export function getBaseUrl(): string {
+  if (process.env.NEXT_PUBLIC_BASE_URL) return process.env.NEXT_PUBLIC_BASE_URL;
+  if (process.env.VERCEL_PROJECT_PRODUCTION_URL)
+    return `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`;
+  if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`;
+  return "http://localhost:3000";
+}

package/src/templates/next-experiments/.env.example

@@ -13,9 +13,9 @@
 # CORE (Recommended)
 # ============================================
 
-# Base URL for your site (used for SEO, canonical URLs, etc.)
-# Development: http://localhost:3000
-# Production: https://your-domain.com
+# Base URL (sitemaps, OG tags, canonical URLs)
+# On Vercel: auto-detected if unset. Set explicitly for custom domains.
+# Local: http://localhost:3000
 NEXT_PUBLIC_BASE_URL="http://localhost:3000"
 
 # Draft mode secret for preview functionality

package/src/templates/next-experiments/app/layout.tsx

@@ -5,6 +5,7 @@ import { Link } from "@/components/ui/link";
 import AppData from "@/package.json";
 import "@/lib/styles/global.css";
 import { cn } from "@/lib/styles/cn";
+import { getBaseUrl } from "@/lib/utils/url";
 import {
   JsonLd,
   generateWebSiteJsonLd,
@@ -15,8 +16,7 @@ const APP_NAME = AppData.name;
 const APP_DEFAULT_TITLE = "Basement Starter";
 const APP_TITLE_TEMPLATE = "%s - Basement Starter";
 const APP_DESCRIPTION = AppData.description;
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 const geist = Geist({
   subsets: ["latin"],

package/src/templates/next-experiments/app/robots.ts

@@ -1,8 +1,5 @@
 import type { MetadataRoute } from "next";
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
-
 export default function robots(): MetadataRoute.Robots {
   return {
     rules: {
@@ -10,6 +7,5 @@ export default function robots(): MetadataRoute.Robots {
       allow: "/",
       disallow: [],
     },
-    sitemap: `${APP_BASE_URL}/sitemap.xml`,
   };
 }

package/src/templates/next-experiments/lib/utils/metadata.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
 /**
  * Metadata Generation Utilities
@@ -26,8 +27,7 @@ interface GenerateMetadataOptions {
   authors?: string[];
 }
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 /**
  * Generate complete metadata object for pages

package/src/templates/next-experiments/lib/utils/url.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the application base URL from environment variables.
+ *
+ * Priority:
+ * 1. NEXT_PUBLIC_BASE_URL  - explicit override (custom domains)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel (production domain)
+ * 3. VERCEL_URL - auto-set by Vercel (preview/branch deploys)
+ * 4. localhost fallback
+ */
+export function getBaseUrl(): string {
+  if (process.env.NEXT_PUBLIC_BASE_URL) return process.env.NEXT_PUBLIC_BASE_URL;
+  if (process.env.VERCEL_PROJECT_PRODUCTION_URL)
+    return `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`;
+  if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`;
+  return "http://localhost:3000";
+}

package/src/templates/next-pagebuilder/.biome/plugins/README.md

@@ -0,0 +1,21 @@
+## Plugins
+
+### 1. `no-anchor-element.grit`
+Enforces using Next.js `<Link>` component instead of HTML `<a>` elements.
+
+### 2. `no-unnecessary-forwardref.grit`
+Checks for unnecessary `forwardRef` usage in React 19 with the compiler.
+
+### 3. `no-relative-parent-imports.grit`
+Forbids relative parent imports (`../`) and encourages alias imports (`@/`).
+
+## Plugin Configuration
+
+The plugins are configured in `biome.json`:
+```json
+"plugins": [
+  "./biome-plugins/no-anchor-element.grit",
+  "./biome-plugins/no-unnecessary-forwardref.grit",
+  "./biome-plugins/no-relative-parent-imports.grit"
+]
+``` 

package/src/templates/next-pagebuilder/.biome/plugins/no-anchor-element.grit

@@ -0,0 +1,12 @@
+language js;
+
+`<a $attrs>$content</a>` as $anchor where {
+    !$anchor <: within `if ($condition) { return ($jsx) }` where {
+        $condition <: contains or { `isExternal`, `isExternalSSR` }
+    },
+    register_diagnostic(
+        span = $anchor,
+        message = "Use custom Link component instead of <a> element. The Link component handles both internal and external links automatically.",
+        severity = "error"
+    )
+} 

package/src/templates/next-pagebuilder/.biome/plugins/no-relative-parent-imports.grit

@@ -0,0 +1,10 @@
+language js;
+
+`import $imports from $source` as $import where {
+    $source <: r"['\"]\.\.\/\.\.\/.*['\"]",
+    register_diagnostic(
+        span = $import,
+        message = "Use alias imports (~/dir/) instead of deep relative imports (../../). Single level imports (../) are allowed for colocated files.",
+        severity = "error"
+    )
+} 

package/src/templates/next-pagebuilder/.biome/plugins/no-unnecessary-forwardref.grit

@@ -0,0 +1,9 @@
+language js;
+
+`forwardRef($func)` as $ref where {
+    register_diagnostic(
+        span = $ref,
+        message = "forwardRef is unnecessary in React 19 with the compiler",
+        severity = "warning"
+    )
+} 

package/src/templates/next-webgl/.env.example

@@ -13,9 +13,9 @@
 # CORE (Recommended)
 # ============================================
 
-# Base URL for your site (used for SEO, canonical URLs, etc.)
-# Development: http://localhost:3000
-# Production: https://your-domain.com
+# Base URL (sitemaps, OG tags, canonical URLs)
+# On Vercel: auto-detected if unset. Set explicitly for custom domains.
+# Local: http://localhost:3000
 NEXT_PUBLIC_BASE_URL="http://localhost:3000"
 
 # Draft mode secret for preview functionality

package/src/templates/next-webgl/app/layout.tsx

@@ -5,6 +5,7 @@ import { Link } from "@/components/ui/link";
 import AppData from "@/package.json";
 import "@/lib/styles/global.css";
 import { cn } from "@/lib/styles/cn";
+import { getBaseUrl } from "@/lib/utils/url";
 import {
   JsonLd,
   generateWebSiteJsonLd,
@@ -15,8 +16,7 @@ const APP_NAME = AppData.name;
 const APP_DEFAULT_TITLE = "Basement Starter";
 const APP_TITLE_TEMPLATE = "%s - Basement Starter";
 const APP_DESCRIPTION = AppData.description;
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 const geist = Geist({
   subsets: ["latin"],

package/src/templates/next-webgl/app/robots.ts

@@ -1,7 +1,7 @@
 import type { MetadataRoute } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 export default function robots(): MetadataRoute.Robots {
   return {

package/src/templates/next-webgl/app/sitemap.xml/route.ts

@@ -0,0 +1,51 @@
+import { getBaseUrl } from "@/lib/utils/url";
+
+const BASE_URL = getBaseUrl();
+
+export const dynamic = "force-dynamic";
+
+interface SitemapEntry {
+	loc: string;
+	lastmod: string;
+	changefreq: string;
+	priority: number;
+}
+
+function toXml(entries: SitemapEntry[]): string {
+	const urls = entries
+		.map(
+			(entry) => `
+  <url>
+    <loc>${entry.loc}</loc>
+    <lastmod>${entry.lastmod}</lastmod>
+    <changefreq>${entry.changefreq}</changefreq>
+    <priority>${entry.priority}</priority>
+  </url>`,
+		)
+		.join("");
+
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${urls}
+</urlset>`;
+}
+
+function getStaticEntries(): SitemapEntry[] {
+	return [
+		{
+			loc: BASE_URL,
+			lastmod: new Date().toISOString(),
+			changefreq: "daily",
+			priority: 1,
+		},
+	];
+}
+
+export async function GET() {
+	const entries: SitemapEntry[] = getStaticEntries();
+
+	return new Response(toXml(entries), {
+		headers: {
+			"Content-Type": "application/xml",
+		},
+	});
+}

package/src/templates/next-webgl/lib/utils/metadata.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { getBaseUrl } from "@/lib/utils/url";
 
 /**
  * Metadata Generation Utilities
@@ -26,8 +27,7 @@ interface GenerateMetadataOptions {
   authors?: string[];
 }
 
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
+const APP_BASE_URL = getBaseUrl();
 
 /**
  * Generate complete metadata object for pages

package/src/templates/next-webgl/lib/utils/url.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the application base URL from environment variables.
+ *
+ * Priority:
+ * 1. NEXT_PUBLIC_BASE_URL  - explicit override (custom domains)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel (production domain)
+ * 3. VERCEL_URL - auto-set by Vercel (preview/branch deploys)
+ * 4. localhost fallback
+ */
+export function getBaseUrl(): string {
+  if (process.env.NEXT_PUBLIC_BASE_URL) return process.env.NEXT_PUBLIC_BASE_URL;
+  if (process.env.VERCEL_PROJECT_PRODUCTION_URL)
+    return `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`;
+  if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`;
+  return "http://localhost:3000";
+}

package/src/helpers/integrate/sanity/files/app/sitemap.ts

@@ -1,61 +0,0 @@
-import type { MetadataRoute } from "next";
-import { isSanityConfigured } from "@/lib/integrations/check-integration";
-
-const APP_BASE_URL =
-	process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
-
-export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
-	const baseRoutes: MetadataRoute.Sitemap = [
-		{
-			url: APP_BASE_URL,
-			lastModified: new Date(),
-			changeFrequency: "daily",
-			priority: 1,
-		},
-	];
-
-	// Only fetch Sanity articles if Sanity is configured
-	if (isSanityConfigured()) {
-		try {
-			const sanityModule = await import("@/lib/integrations/sanity/client");
-			const sanityGroq = await import("next-sanity");
-
-			const client = sanityModule?.client;
-			const groq = sanityGroq?.groq;
-
-			// Skip if client is null (shouldn't happen since we check isSanityConfigured)
-			if (!(client && groq)) return baseRoutes;
-
-			type SanityDocument = {
-				slug: { current: string };
-				_updatedAt: string;
-				metadata?: { noIndex?: boolean };
-			};
-
-			const articles = (await client.fetch(
-				groq`*[_type == "article" && defined(slug.current)] {
-          slug,
-          _updatedAt,
-          metadata
-        }`,
-			)) as SanityDocument[];
-
-			// Add articles to sitemap (exclude noIndex articles)
-			const articleEntries: MetadataRoute.Sitemap = articles
-				.filter((article: SanityDocument) => !article.metadata?.noIndex)
-				.map((article: SanityDocument) => ({
-					url: `${APP_BASE_URL}/blog/${article.slug.current}`,
-					lastModified: new Date(article._updatedAt),
-					changeFrequency: "weekly" as const,
-					priority: 0.7,
-				}));
-
-			return [...baseRoutes, ...articleEntries];
-		} catch (error) {
-			console.error("Error generating sitemap from Sanity:", error);
-			return baseRoutes;
-		}
-	}
-
-	return baseRoutes;
-}

package/src/templates/next-default/app/sitemap.ts

@@ -1,16 +0,0 @@
-import type { MetadataRoute } from "next";
-
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
-
-export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
-  const baseRoutes: MetadataRoute.Sitemap = [
-    {
-      url: APP_BASE_URL,
-      lastModified: new Date(),
-      changeFrequency: "daily",
-      priority: 1,
-    },
-  ];
-  return baseRoutes;
-}

package/src/templates/next-experiments/app/sitemap.ts

@@ -1,16 +0,0 @@
-import type { MetadataRoute } from "next";
-
-const APP_BASE_URL =
-  process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
-
-export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
-  const baseRoutes: MetadataRoute.Sitemap = [
-    {
-      url: APP_BASE_URL,
-      lastModified: new Date(),
-      changeFrequency: "daily",
-      priority: 1,
-    },
-  ];
-  return baseRoutes;
-}