bsmnt 0.2.10 → 0.3.0

package/src/templates/next-pagebuilder/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "next-pagebuilder",
+  "description": "Basement Next.js starter template",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "analyze": "cross-env ANALYZE=true bun run build",
+    "analyze:experimental": "next experimental-analyze",
+    "build": "next build",
+    "dev": "next dev",
+    "format": "biome format --write .",
+    "generate": "bun ./lib/scripts/generate.ts",
+    "lighthouse": "bunx @unlighthouse/cli --site http://localhost:3000",
+    "lint": "biome lint --max-diagnostics=200",
+    "lint:fix": "biome lint --write --unsafe --max-diagnostics=200",
+    "start": "next start",
+    "test": "bun test",
+    "typecheck": "tsgo --noEmit",
+    "typecheck:compare": "bun run typecheck:tsc && bun run typecheck",
+    "typecheck:tsc": "tsc --noEmit --incremental false",
+    "sanity:extract": "cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity schema extract",
+    "sanity:typegen": "bun ./lib/scripts/sanity-typegen.ts",
+    "predev": "bun run sanity:typegen",
+    "prebuild": "bun run sanity:typegen"
+  },
+  "dependencies": {
+    "@phosphor-icons/react": "^2.1.10",
+    "@portabletext/types": "^4.0.2",
+    "@sanity/asset-utils": "^2.3.0",
+    "@sanity/image-url": "^2.0.3",
+    "@sanity/table": "^2.0.1",
+    "@sanity/vision": "^5.17.1",
+    "@sanity/visual-editing": "^5.3.1",
+    "class-variance-authority": "^0.7.1",
+    "next": "16.2.3",
+    "next-sanity": "^12.1.4",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-use": "^17.6.0",
+    "sanity": "^5.17.1",
+    "sanity-plugin-media": "^4.1.1",
+    "schema-dts": "^2.0.0",
+    "tailwind-merge": "^3.5.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.8",
+    "@clack/prompts": "^1.1.0",
+    "@csstools/postcss-global-data": "^4.0.0",
+    "@next/bundle-analyzer": "16.2.1",
+    "@svgr/webpack": "^8.1.0",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/bun": "^1.3.11",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript/native-preview": "^7.0.0-dev.20260323.1",
+    "babel-plugin-react-compiler": "1.0.0",
+    "cross-env": "^10.1.0",
+    "postcss-functions": "^4.0.2",
+    "postcss-preset-env": "^11.2.0",
+    "tailwindcss": "^4.2.2",
+    "typescript": "^5.9.3"
+  },
+  "trustedDependencies": [
+    "@biomejs/biome",
+    "@tailwindcss/oxide",
+    "esbuild",
+    "sharp"
+  ]
+}

package/src/templates/next-pagebuilder/postcss.config.mjs

@@ -0,0 +1,39 @@
+/**
+ * PostCSS preset-env config
+ * @see Docs {@link https://github.com/csstools/postcss-plugins/blob/main/plugin-packs/postcss-preset-env/README.md#options}
+ * @see Features Flags {@link https://github.com/csstools/postcss-plugins/blob/main/plugin-packs/postcss-preset-env/FEATURES.md}
+ * @type {import('postcss-preset-env').pluginOptions}
+ */
+const presetEnvConfig = {
+  autoprefixer: {
+    flexbox: "no-2009",
+  },
+  stage: 3,
+  features: {
+    "custom-properties": false,
+    "custom-media-queries": true,
+    "nesting-rules": true,
+  },
+}
+
+/**
+ * PostCSS global data config
+ * Makes sure the css module files have access to these context files
+ * @see {@link https://github.com/csstools/postcss-global-data?tab=readme-ov-file#options}
+ * @type {import('@csstools/postcss-global-data').pluginOptions}
+ */
+const globalDataConfig = {
+  files: ["./lib/styles/global.css"],
+}
+
+const postcssConfig = {
+  // NOTE: Order is important
+  plugins: {
+    "@tailwindcss/postcss": {},
+    "@csstools/postcss-global-data": globalDataConfig,
+    // NOTE: This has to be last config
+    "postcss-preset-env": presetEnvConfig,
+  },
+}
+
+export default postcssConfig

package/src/templates/next-pagebuilder/proxy.ts

@@ -0,0 +1,81 @@
+import type { NextRequest } from "next/server"
+import { NextResponse } from "next/server"
+import {
+  acceptHeaderRoutes,
+  ignoredPaths,
+  mdExtensionRoutes,
+} from "@/lib/integrations/sanity/markdown-proxy.config"
+
+export function proxy(request: NextRequest) {
+  const { pathname } = request.nextUrl
+  const acceptHeader = request.headers.get("accept") || ""
+
+  if (ignoredPaths.some((p) => pathname.startsWith(p))) {
+    return NextResponse.next()
+  }
+
+  if (pathname === "/" && acceptHeader.includes("text/markdown")) {
+    const url = request.nextUrl.clone()
+    url.pathname = "/api/index.md"
+    return NextResponse.rewrite(url)
+  }
+
+  // 1. Rewrite .md extension URLs to API routes
+  //    e.g. /about.md → /api/about.md
+  for (const route of mdExtensionRoutes) {
+    const match = route.regex.exec(pathname)
+    if (match) {
+      const slug = match[1]
+      const url = request.nextUrl.clone()
+      url.pathname = route.apiPath.replace("[slug]", slug!)
+      return NextResponse.rewrite(url)
+    }
+  }
+
+  // 2. Accept: text/markdown — rewrite to markdown API route
+  if (acceptHeader.includes("text/markdown")) {
+    for (const route of acceptHeaderRoutes) {
+      const match = route.regex.exec(pathname)
+      if (match) {
+        const slug = match[1]
+        const url = request.nextUrl.clone()
+        url.pathname = route.apiPath.replace("[slug]", slug!)
+        return NextResponse.rewrite(url)
+      }
+    }
+  }
+
+  // 3. Add Link header for markdown discoverability on HTML page requests
+  const response = NextResponse.next()
+
+  if (pathname === "/") {
+    response.headers.set(
+      "Link",
+      '</index.md>; rel="alternate"; type="text/markdown"'
+    )
+    response.headers.set("Vary", "Accept")
+    return response
+  }
+
+  for (const route of acceptHeaderRoutes) {
+    const match = route.regex.exec(pathname)
+    if (match) {
+      const slug = match[1]
+      const mdUrl = route.publicPath.replace("[slug]", slug!)
+      response.headers.set(
+        "Link",
+        `<${mdUrl}>; rel="alternate"; type="text/markdown"`
+      )
+      response.headers.set("Vary", "Accept")
+      break
+    }
+  }
+
+  return response
+}
+
+export const config = {
+  matcher: [
+    "/((?!_next/static|_next/image|favicon.ico|sitemap.xml|sitemap.md|robots.txt).*)",
+  ],
+}

package/src/templates/next-pagebuilder/svg.d.ts

@@ -0,0 +1,5 @@
+declare module "*.svg" {
+  import type { FC, SVGProps } from "react"
+  const content: FC<SVGProps<SVGSVGElement>>
+  export default content
+}

package/src/templates/next-pagebuilder/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+    "useUnknownInCatchVariables": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitReturns": true,
+    "noUncheckedSideEffectImports": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noUncheckedIndexedAccess": true,
+    "plugins": [{ "name": "next" }],
+    "types": ["bun", "node"],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

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

@@ -6,6 +6,11 @@ import { fontsVariable } from "@/lib/styles/fonts";
 import AppData from "@/package.json";
 import "@/lib/styles/index.css";
 import { cn } from "@/lib/styles/cn";
+import {
+  JsonLd,
+  generateWebSiteJsonLd,
+  generateOrganizationJsonLd,
+} from "@/lib/utils/json-ld";
 
 const APP_NAME = AppData.name;
 const APP_DEFAULT_TITLE = "Basement Starter";
@@ -86,6 +91,19 @@ export default async function Layout({ children }: PropsWithChildren) {
       suppressHydrationWarning
     >
       <body>
+        <JsonLd
+          data={generateWebSiteJsonLd({
+            name: APP_DEFAULT_TITLE,
+            description: APP_DESCRIPTION,
+          })}
+        />
+        <JsonLd
+          data={generateOrganizationJsonLd({
+            name: APP_NAME,
+            logo: "/opengraph-image.jpg",
+          })}
+        />
+
         {/* Skip link for keyboard navigation accessibility */}
         <Suspense fallback={null}>
           <Link

package/src/templates/next-webgl/lib/hooks/use-device-detection.ts

@@ -1,5 +1,5 @@
 import { useEffect, useState } from "react"
-import { useMedia } from "react-use"
+import { useMedia } from "./use-media"
 
 const MOBILE_BREAKPOINT = 640
 

package/src/templates/next-webgl/lib/hooks/use-media-breakpoint.ts

@@ -1,4 +1,4 @@
-import { useMedia } from "react-use"
+import { useMedia } from "./use-media"
 
 const BREAKPOINTS = {
   "desktop-large": 1920,

package/src/templates/next-webgl/lib/hooks/use-media.ts

@@ -0,0 +1,29 @@
+import { useEffect, useState } from "react"
+
+export function useMedia(mediaQuery: string, initialValue?: boolean) {
+  const [isVerified, setIsVerified] = useState<boolean | undefined>(initialValue)
+
+  useEffect(() => {
+    if (typeof window === "undefined" || !("matchMedia" in window)) {
+      console.warn("matchMedia is not supported by your current browser")
+      return
+    }
+    const mediaQueryList = window.matchMedia(mediaQuery)
+    const changeHandler = () => setIsVerified(!!mediaQueryList.matches)
+
+    changeHandler()
+    if (typeof mediaQueryList.addEventListener === "function") {
+      mediaQueryList.addEventListener("change", changeHandler)
+      return () => {
+        mediaQueryList.removeEventListener("change", changeHandler)
+      }
+    } else if (typeof mediaQueryList.addListener === "function") {
+      mediaQueryList.addListener(changeHandler)
+      return () => {
+        mediaQueryList.removeListener(changeHandler)
+      }
+    }
+  }, [mediaQuery])
+
+  return isVerified
+}

package/src/templates/next-webgl/lib/utils/json-ld.tsx

@@ -0,0 +1,199 @@
+import type {
+  Article,
+  BreadcrumbList,
+  Organization,
+  SearchAction,
+  Thing,
+  WebPage,
+  WebSite,
+  WithContext,
+} from "schema-dts";
+
+const APP_BASE_URL = process.env.NEXT_PUBLIC_BASE_URL;
+
+function isAbsoluteUrl(value: string) {
+  return /^https?:\/\//.test(value);
+}
+
+function resolveUrl(value?: string) {
+  if (!value) return APP_BASE_URL;
+  if (isAbsoluteUrl(value)) return value;
+  if (!APP_BASE_URL) return undefined;
+
+  return new URL(value, APP_BASE_URL).toString();
+}
+
+/* -------------------------------- Component ------------------------------- */
+
+export function JsonLd<T extends Thing>({
+  data,
+}: {
+  data: WithContext<T>;
+}) {
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{
+        __html: JSON.stringify(data).replace(/</g, "\\u003c"),
+      }}
+    />
+  );
+}
+
+/* -------------------------------- Generators ------------------------------ */
+
+interface WebSiteJsonLdOptions {
+  name: string;
+  url?: string;
+  description?: string;
+  /** URL to site-wide search (e.g. "/search?q={search_term_string}") */
+  searchUrl?: string;
+}
+
+export function generateWebSiteJsonLd(
+  options: WebSiteJsonLdOptions
+): WithContext<WebSite> {
+  const { name, url, description, searchUrl } = options;
+  const resolvedUrl = resolveUrl(url);
+  const resolvedSearchUrl = resolveUrl(searchUrl);
+
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name,
+    ...(resolvedUrl && { url: resolvedUrl }),
+    ...(description && { description }),
+    ...(resolvedSearchUrl && {
+      potentialAction: {
+        "@type": "SearchAction",
+        target: resolvedSearchUrl,
+        "query-input": "required name=search_term_string",
+      } as SearchAction & { "query-input": string },
+    }),
+  };
+}
+
+interface OrganizationJsonLdOptions {
+  name: string;
+  url?: string;
+  logo?: string;
+  description?: string;
+  sameAs?: string[];
+}
+
+export function generateOrganizationJsonLd(
+  options: OrganizationJsonLdOptions
+): WithContext<Organization> {
+  const { name, url, logo, description, sameAs } = options;
+  const resolvedUrl = resolveUrl(url);
+  const resolvedLogo = resolveUrl(logo);
+
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name,
+    ...(resolvedUrl && { url: resolvedUrl }),
+    ...(resolvedLogo && { logo: resolvedLogo }),
+    ...(description && { description }),
+    ...(sameAs && { sameAs }),
+  };
+}
+
+interface WebPageJsonLdOptions {
+  title: string;
+  url?: string;
+  description?: string;
+  image?: string;
+  datePublished?: string;
+  dateModified?: string;
+}
+
+export function generateWebPageJsonLd(
+  options: WebPageJsonLdOptions
+): WithContext<WebPage> {
+  const { title, url, description, image, datePublished, dateModified } =
+    options;
+  const resolvedUrl = resolveUrl(url);
+  const resolvedImage = resolveUrl(image);
+
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebPage",
+    name: title,
+    ...(resolvedUrl && { url: resolvedUrl }),
+    ...(description && { description }),
+    ...(resolvedImage && { image: resolvedImage }),
+    ...(datePublished && { datePublished }),
+    ...(dateModified && { dateModified }),
+  };
+}
+
+interface ArticleJsonLdOptions {
+  title: string;
+  url?: string;
+  description?: string;
+  image?: string;
+  datePublished?: string;
+  dateModified?: string;
+  authorName?: string;
+  authorUrl?: string;
+}
+
+export function generateArticleJsonLd(
+  options: ArticleJsonLdOptions
+): WithContext<Article> {
+  const {
+    title,
+    url,
+    description,
+    image,
+    datePublished,
+    dateModified,
+    authorName,
+    authorUrl,
+  } = options;
+  const resolvedUrl = resolveUrl(url);
+  const resolvedImage = resolveUrl(image);
+
+  return {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    headline: title,
+    ...(resolvedUrl && { url: resolvedUrl }),
+    ...(description && { description }),
+    ...(resolvedImage && { image: resolvedImage }),
+    ...(datePublished && { datePublished }),
+    ...(dateModified && { dateModified }),
+    ...(authorName && {
+      author: {
+        "@type": "Person",
+        name: authorName,
+        ...(authorUrl && { url: authorUrl }),
+      },
+    }),
+  };
+}
+
+interface BreadcrumbItem {
+  name: string;
+  url: string;
+}
+
+export function generateBreadcrumbJsonLd(
+  items: BreadcrumbItem[]
+): WithContext<BreadcrumbList> {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((item, index) => {
+      const resolvedItemUrl = resolveUrl(item.url);
+
+      return {
+        "@type": "ListItem",
+        position: index + 1,
+        name: item.name,
+        ...(resolvedItemUrl && { item: resolvedItemUrl }),
+      };
+    }),
+  };
+}

package/src/templates/next-webgl/package.json

@@ -28,7 +28,6 @@
     "next": "^16",
     "react": "^19",
     "react-dom": "^19",
-    "react-use": "^17.6.0",
     "tailwind-merge": "^3.4.0",
     "three": "^0.182.0",
     "zod": "^4.3.6"
@@ -47,6 +46,7 @@
     "babel-plugin-react-compiler": "1.0.0",
     "cross-env": "^10.1.0",
     "postcss-preset-env": "^10.6.1",
+    "schema-dts": "^2.0.0",
     "tailwindcss": "^4",
     "typescript": "^5"
   },

package/src/templates/next-webgl/tsconfig.json

@@ -2,6 +2,7 @@
   "compilerOptions": {
     "target": "ES2023",
     "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "types": ["bun"],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,

package/plugins/no-anchor-element.grit

@@ -1,11 +0,0 @@
-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/plugins/no-relative-parent-imports.grit

@@ -1,6 +0,0 @@
-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/plugins/no-unnecessary-forwardref.grit

@@ -1,5 +0,0 @@
-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/helpers/integrate/sanity/files/lib/scripts/copy-sanity-mcp.ts

@@ -1,23 +0,0 @@
-/**
- * Cross-platform Sanity MCP setup helper
- * Copies the Cursor deeplink to clipboard on macOS/Linux/Windows
- */
-
-import { copyToClipboard } from "./utils";
-
-const link =
-	"cursor://anysphere.cursor-deeplink/mcp/install?name=Sanity&config=eyJ1cmwiOiJodHRwczovL21jcC5zYW5pdHkuaW8iLCJ0eXBlIjoiaHR0cCJ9Cg==";
-
-const copied = await copyToClipboard(link);
-
-console.log("\n🔗 Sanity MCP Setup for Cursor\n");
-
-if (copied) {
-	console.log("✅ Link copied to clipboard!");
-	console.log("   Paste it in your browser or Cursor address bar.\n");
-} else {
-	console.log("📋 Copy this link manually:\n");
-	console.log(`   ${link}\n`);
-}
-
-console.log("This will install the Sanity MCP server in Cursor.");