bsmnt 0.2.11 → 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/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.");

package/src/helpers/integrate/sanity/files/lib/scripts/generate-page.ts

@@ -1,297 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Generate Page Module
- *
- * Generates new pages with pre-configured templates through interactive prompts.
- * Used by the unified generator: `bun run generate`
- *
- * Cross-platform compatible (Windows, macOS, Linux)
- */
-
-import * as p from "@clack/prompts";
-import { createDir } from "./utils";
-
-interface PageOptions {
-	webgl?: boolean;
-	sanity?: boolean;
-	theme?: string;
-	css?: boolean;
-}
-
-export interface PageConfig {
-	name: string;
-	options: PageOptions;
-}
-
-/**
- * Interactive prompts for page configuration
- */
-export const promptPageConfig = async (): Promise<PageConfig> => {
-	const name = await p.text({
-		message: "What should the page be called?",
-		placeholder: "about, contact, products",
-		validate: (value) => {
-			if (!value) return "Page name is required";
-			if (!/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(value)) {
-				return "Page name must start with a letter and contain only letters, numbers, hyphens, and underscores";
-			}
-			return undefined;
-		},
-	});
-
-	if (p.isCancel(name)) {
-		p.cancel("Page generation cancelled");
-		process.exit(0);
-	}
-
-	const theme = await p.select({
-		message: "Choose a theme for the page",
-		options: [
-			{ value: "dark", label: "Dark (default)", hint: "Standard dark theme" },
-			{ value: "light", label: "Light", hint: "Light theme" },
-			{ value: "red", label: "Red", hint: "Red accent theme" },
-		],
-		initialValue: "dark",
-	});
-
-	if (p.isCancel(theme)) {
-		p.cancel("Page generation cancelled");
-		process.exit(0);
-	}
-
-	const integrations = await p.multiselect({
-		message: "Which integrations should this page use?",
-		options: [
-			{ value: "webgl", label: "WebGL Canvas", hint: "Enable 3D graphics" },
-			{ value: "sanity", label: "Sanity CMS", hint: "Content management" },
-		],
-		required: false,
-	});
-
-	if (p.isCancel(integrations)) {
-		p.cancel("Page generation cancelled");
-		process.exit(0);
-	}
-
-	const includeCss = await p.confirm({
-		message: "Include a CSS module file?",
-		initialValue: false,
-	});
-
-	if (p.isCancel(includeCss)) {
-		p.cancel("Page generation cancelled");
-		process.exit(0);
-	}
-
-	return {
-		name,
-		options: {
-			theme,
-			webgl: integrations.includes("webgl"),
-			sanity: integrations.includes("sanity"),
-			css: includeCss,
-		},
-	};
-};
-
-/**
- * Generate page.tsx content
- */
-const generatePageContent = (
-	pageName: string,
-	options: PageOptions,
-): string => {
-	const { webgl, sanity, theme = "dark" } = options;
-
-	// Capitalize first letter for title
-	const title = pageName.charAt(0).toUpperCase() + pageName.slice(1);
-
-	// Build imports
-	const imports: string[] = [];
-	imports.push(`import type { Metadata } from 'next'`);
-	imports.push(`import { Wrapper } from '@/components/layout/wrapper'`);
-
-	// Integration-specific imports
-	if (sanity) {
-		imports.push(
-			`import { NotConfigured } from '@/components/ui/not-configured'`,
-		);
-	}
-
-	if (sanity) {
-		imports.push(
-			`import { isSanityConfigured } from '@/lib/integrations/check-integration'`,
-		);
-		// sanityFetch and generateSanityMetadata are available for use:
-		// import { sanityFetch } from 'next-sanity/live'
-		// import { generateSanityMetadata } from '@/lib/utils/metadata'
-	}
-
-	// Build wrapper props
-	const wrapperProps: string[] = [`theme="${theme}"`];
-	if (webgl) {
-		wrapperProps.push("webgl");
-	}
-
-	// Build component body based on integrations
-	let componentBody: string;
-
-	if (sanity) {
-		// Sanity only
-		componentBody = `  // Show setup instructions if Sanity is not configured
-  if (!isSanityConfigured()) {
-    return (
-      <Wrapper theme="${theme}">
-        <NotConfigured integration="Sanity" />
-      </Wrapper>
-    )
-  }
-
-  // TODO: Create a GROQ query for this page's content type
-  // const { data } = await sanityFetch({
-  //   query: yourQuery,
-  //   params: { slug: '${pageName}' },
-  // })
-
-  return (
-    <Wrapper ${wrapperProps.join(" ")}>
-      <section className="dr-py-100">
-        <div className="container">
-          <h1>${title}</h1>
-          {/* Your content here */}
-          {/* Fetch data from Sanity using a custom query */}
-        </div>
-      </section>
-    </Wrapper>
-  )`;
-	} else {
-		// No integrations
-		componentBody = `  return (
-    <Wrapper ${wrapperProps.join(" ")}>
-      <section className="dr-py-100">
-        <div className="container">
-          <h1>${title}</h1>
-          {/* Your content here */}
-        </div>
-      </section>
-    </Wrapper>
-  )`;
-	}
-
-	// Build metadata export
-	let metadataExport: string;
-	if (sanity) {
-		metadataExport = `
-export async function generateMetadata(): Promise<Metadata> {
-  if (!isSanityConfigured()) {
-    return {
-      title: '${title}',
-      description: '${title} page description',
-    }
-  }
-
-  // TODO: Fetch metadata from Sanity using a custom query
-  // const { data } = await sanityFetch({
-  //   query: yourQuery,
-  //   params: { slug: '${pageName}' },
-  // })
-
-  return {
-    title: '${title}',
-    description: '${title} page description',
-  }
-}`;
-	} else {
-		metadataExport = `
-export const metadata: Metadata = {
-  title: '${title}',
-  description: '${title} page description',
-}`;
-	}
-
-	// Determine if component should be async
-	const isAsync = sanity;
-
-	return `${imports.join("\n")}
-${metadataExport}
-
-export default ${isAsync ? "async " : ""}function ${title}Page() {
-${componentBody}
-}
-`;
-};
-
-/**
- * Create page files and directories
- */
-export const createPage = async (
-	pageName: string,
-	options: PageOptions,
-): Promise<void> => {
-	const s = p.spinner();
-
-	try {
-		// Create directory structure
-		const pageDir = `app/${pageName}`;
-		const componentsDir = `${pageDir}/_components`;
-
-		s.start(`Creating page structure for "${pageName}"`);
-
-		// Create main page directory (cross-platform)
-		await createDir(pageDir);
-
-		// Create _components subdirectory (cross-platform)
-		await createDir(componentsDir);
-
-		// Create .gitkeep in _components
-		await Bun.write(`${componentsDir}/.gitkeep`, "");
-
-		// Generate and write page.tsx
-		const pageContent = generatePageContent(pageName, options);
-		await Bun.write(`${pageDir}/page.tsx`, pageContent);
-
-		// Create CSS module if requested
-		if (options.css) {
-			const cssContent = `/* ${pageName}.module.css */
-
-.container {
-  /* Add your styles here */
-}
-`;
-			await Bun.write(`${pageDir}/${pageName}.module.css`, cssContent);
-		}
-
-		s.stop(`Page "${pageName}" generated successfully!`);
-
-		// Show what was created
-		p.log.success(`Generated files:`);
-		p.log.message(`  📄 ${pageDir}/page.tsx`);
-		p.log.message(`  📁 ${componentsDir}/`);
-		if (options.css) {
-			p.log.message(`  🎨 ${pageDir}/${pageName}.module.css`);
-		}
-
-		// Build next steps message
-		const nextSteps = [`1. Customize ${pageDir}/page.tsx`];
-
-		if (options.sanity) {
-			nextSteps.push(
-				`2. Create a "${pageName}" page in Sanity Studio at /studio`,
-			);
-		}
-
-		nextSteps.push(
-			`${nextSteps.length + 1}. Add components to ${componentsDir}/`,
-		);
-		nextSteps.push(
-			`${nextSteps.length + 1}. Visit /${pageName} to see your page`,
-		);
-
-		p.note(`Next steps:\n  ${nextSteps.join("\n  ")}`);
-	} catch (error) {
-		s.stop(`Failed to generate page "${pageName}"`);
-		throw error;
-	}
-};
-
-// Export functions for use by unified generate script