bsmnt 0.9.0 → 0.11.0

package/src/templates/next-pagebuilder-cache/lib/scripts/setup-ci-secrets.ts

@@ -0,0 +1,117 @@
+/**
+ * Push CI environment to GitHub Actions for this repository.
+ *
+ * Reads values from `.env.local` and sets them on the current repo via the
+ * GitHub CLI (`gh`), matching the `build` step in `.github/workflows/ci.yml`:
+ * the public Sanity project ID and dataset become repository *variables*, and
+ * the read token becomes a *secret*.
+ *
+ * Run once the repo exists on GitHub:  `bun run ci:secrets`
+ * Requires the GitHub CLI, authenticated (`gh auth login`).
+ */
+import { execFileSync } from "node:child_process"
+import { existsSync, readFileSync } from "node:fs"
+import path from "node:path"
+
+const ENV_FILE = ".env.local"
+
+/** Public config — stored as GitHub Actions repository variables. */
+const VARIABLES = [
+  "NEXT_PUBLIC_SANITY_PROJECT_ID",
+  "NEXT_PUBLIC_SANITY_DATASET",
+] as const
+
+/** Sensitive config — stored as GitHub Actions secrets. */
+const SECRETS = ["SANITY_API_READ_TOKEN"] as const
+
+function parseEnvFile(file: string): Record<string, string> {
+  const env: Record<string, string> = {}
+  if (!existsSync(file)) return env
+
+  for (const rawLine of readFileSync(file, "utf8").split("\n")) {
+    const line = rawLine.trim()
+    if (!line || line.startsWith("#")) continue
+
+    const eq = line.indexOf("=")
+    if (eq === -1) continue
+
+    const key = line.slice(0, eq).trim()
+    let value = line.slice(eq + 1).trim()
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1)
+    }
+    env[key] = value
+  }
+
+  return env
+}
+
+function ensureGitHubRepo(): void {
+  try {
+    execFileSync("gh", ["--version"], { stdio: "pipe" })
+  } catch {
+    console.error(
+      "✖ GitHub CLI (gh) not found. Install it: https://cli.github.com",
+    )
+    process.exit(1)
+  }
+
+  try {
+    execFileSync("gh", ["repo", "view", "--json", "nameWithOwner"], {
+      stdio: "pipe",
+    })
+  } catch {
+    console.error("✖ No GitHub repository detected for this directory.")
+    console.error(
+      "  Create and push the repo first (e.g. `gh repo create`), then re-run.",
+    )
+    process.exit(1)
+  }
+}
+
+ensureGitHubRepo()
+
+const env = parseEnvFile(path.resolve(ENV_FILE))
+let pushed = 0
+let skipped = 0
+
+for (const name of VARIABLES) {
+  const value = env[name] ?? process.env[name]
+  if (!value) {
+    console.info(`- ${name}: not found in ${ENV_FILE}, skipping`)
+    skipped++
+    continue
+  }
+  // Public value — safe to pass on the command line.
+  execFileSync("gh", ["variable", "set", name, "--body", value], {
+    stdio: "pipe",
+  })
+  console.info(`✓ variable  ${name}`)
+  pushed++
+}
+
+for (const name of SECRETS) {
+  const value = env[name] ?? process.env[name]
+  if (!value) {
+    console.info(`- ${name}: not found in ${ENV_FILE}, skipping`)
+    skipped++
+    continue
+  }
+  // Sensitive — pipe via stdin so the token never appears in the process args.
+  execFileSync("gh", ["secret", "set", name], { input: value, stdio: "pipe" })
+  console.info(`✓ secret    ${name}`)
+  pushed++
+}
+
+if (pushed === 0) {
+  console.info(
+    `\nNothing to sync. Add your Sanity values to ${ENV_FILE} (or run Sanity setup) first.`,
+  )
+} else {
+  console.info(
+    `\nDone — ${String(pushed)} value(s) pushed to GitHub Actions${skipped ? `, ${String(skipped)} skipped` : ""}.`,
+  )
+}

package/src/templates/next-pagebuilder-cache/lib/styles/cn.ts

@@ -0,0 +1,5 @@
+import { cx } from "class-variance-authority"
+import type { ClassValue } from "class-variance-authority/types"
+import { twMerge } from "tailwind-merge"
+
+export const cn = (...inputs: ClassValue[]) => twMerge(cx(inputs))

package/src/templates/next-pagebuilder-cache/lib/styles/global.css

@@ -0,0 +1,69 @@
+@import "tailwindcss";
+
+@theme {
+  --breakpoint-*: initial;
+  --breakpoint-desktop-large: 1920px;
+  --breakpoint-desktop: 1440px;
+  --breakpoint-tablet-lg: 1024px;
+  --breakpoint-tablet: 768px;
+  --breakpoint-mobile: 640px;
+
+  --color-*: initial;
+  --color-primary: #ffffff;
+  --color-secondary: #000000;
+  --color-contrast: #ff4d00;
+  --color-black: #000000;
+  --color-white: #ffffff;
+  --color-orange: #ff4d00;
+  --color-blue: #487cff;
+  --color-green: #00ff9b;
+  --color-violet: #f101a5;
+  --color-pink: #ff73a6;
+  --color-gray: #666666;
+
+  /* gray */
+  --color-gray-50: #f5f5f5;
+  --color-gray-100: #e0e0e0;
+  --color-gray-200: #c2c2c2;
+  --color-gray-300: #a3a3a3;
+  --color-gray-400: #858585;
+  --color-gray-500: #666666;
+  --color-gray-600: #4d4d4d;
+  --color-gray-700: #333333;
+  --color-gray-800: #1a1a1a;
+}
+
+@theme inline {
+  --font-geist: var(--font-geist-variable);
+}
+
+html {
+  --scrollbar-gutter: 0px;
+  scrollbar-gutter: stable;
+}
+
+body {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+
+  @apply flex flex-col bg-primary text-secondary overscroll-none min-h-svh;
+}
+
+*:focus-visible {
+  outline: 2px solid var(--color-contrast);
+  @apply outline-2 outline-contrast;
+}
+
+img {
+  -webkit-touch-callout: none;
+  -webkit-user-select: none;
+  -moz-user-select: none;
+  -ms-user-select: none;
+  -o-user-select: none;
+  user-select: none;
+}
+
+button {
+  cursor: pointer;
+  user-select: none;
+}

package/src/templates/next-pagebuilder-cache/lib/utils/base-url.ts

@@ -0,0 +1,17 @@
+/**
+ * Centralized base URL resolution.
+ *
+ * Priority:
+ * 1. NEXT_PUBLIC_BASE_URL (explicit production URL)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL (Vercel production domain)
+ * 3. VERCEL_URL (Vercel preview/deployment URL)
+ * 4. http://localhost:3000 (local development)
+ */
+export const getBaseUrl = () =>
+  process.env.NEXT_PUBLIC_BASE_URL ||
+  (process.env.VERCEL_PROJECT_PRODUCTION_URL
+    ? `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`
+    : undefined) ||
+  (process.env.VERCEL_URL
+    ? `https://${process.env.VERCEL_URL}`
+    : "http://localhost:3000")

package/src/templates/next-pagebuilder-cache/lib/utils/format-date.ts

@@ -0,0 +1,8 @@
+const options: Intl.DateTimeFormatOptions = {
+  year: "numeric",
+  month: "long",
+  day: "numeric",
+}
+
+export const formatDate = (date: Date | string | number) =>
+  new Date(date).toLocaleDateString("en-US", options)

package/src/templates/next-pagebuilder-cache/lib/utils/slug-tag.ts

@@ -0,0 +1,6 @@
+export const getSlugTag = (slug: string | null | undefined) => {
+  const normalizedSlug = slug?.replace(/^\/+|\/+$/g, "") ?? ""
+  const lastSlugSegment = normalizedSlug.split("/").filter(Boolean).at(-1)
+
+  return lastSlugSegment ?? "homepage"
+}

package/src/templates/next-pagebuilder-cache/next.config.ts

@@ -0,0 +1,176 @@
+import withBundleAnalyzer from "@next/bundle-analyzer"
+import type { NextConfig } from "next"
+import { sanity } from "next-sanity/live/cache-life"
+
+const nextConfig: NextConfig = {
+  cacheComponents: true,
+  // Publishes invalidate by tag, so the window is long. `expire` is pinned
+  // because the `sanity` profile omits it and Next's fallback is unbounded.
+  cacheLife: { default: { ...sanity, expire: sanity.revalidate } },
+  reactStrictMode: true,
+  reactCompiler: true,
+  typedRoutes: true,
+  // Bundle the committed encrypted env files so instrumentation.ts can decrypt
+  // them at runtime. `.env.keys` is never listed; missing files are skipped.
+  outputFileTracingIncludes: {
+    "/**": ["./.env", "./.env.production", "./.env.preview"],
+  },
+  turbopack: {
+    rules: {
+      "*.svg": {
+        loaders: [
+          {
+            loader: "@svgr/webpack",
+            options: {
+              memo: true,
+              dimensions: false,
+              svgoConfig: {
+                multipass: true,
+                plugins: [
+                  "removeDimensions",
+                  "removeOffCanvasPaths",
+                  "reusePaths",
+                  "removeElementsByAttr",
+                  "removeStyleElement",
+                  "removeScriptElement",
+                  "prefixIds",
+                  "cleanupIds",
+                  {
+                    name: "cleanupNumericValues",
+                    params: {
+                      floatPrecision: 1,
+                    },
+                  },
+                  {
+                    name: "convertPathData",
+                    params: {
+                      floatPrecision: 1,
+                    },
+                  },
+                  {
+                    name: "convertTransform",
+                    params: {
+                      floatPrecision: 1,
+                    },
+                  },
+                  {
+                    name: "cleanupListOfValues",
+                    params: {
+                      floatPrecision: 1,
+                    },
+                  },
+                ],
+              },
+            },
+          },
+        ],
+        as: "*.js",
+      },
+    },
+  },
+  logging: {
+    browserToTerminal: true,
+  },
+  experimental: {
+    optimizePackageImports: [
+      "@react-three/drei",
+      "@react-three/fiber",
+      "gsap",
+      "three",
+      "postprocessing",
+      "lenis",
+    ],
+  },
+  images: {
+    dangerouslyAllowSVG: true,
+    remotePatterns: [
+      {
+        protocol: "https",
+        hostname: "cdn.sanity.io",
+      },
+    ],
+    minimumCacheTTL: 60 * 60 * 24 * 30, // 30 days
+    qualities: [90],
+    formats: ["image/avif", "image/webp"],
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
+  },
+  headers: async () => [
+    {
+      // Excludes /studio* — must stay mutually exclusive with the rule below.
+      source: "/((?!studio(?:/|$)).*)",
+      headers: [
+        {
+          key: "X-Content-Type-Options",
+          value: "nosniff",
+        },
+        {
+          key: "Content-Security-Policy",
+          value: "frame-ancestors 'self';",
+        },
+        {
+          key: "X-Frame-Options",
+          value: "SAMEORIGIN",
+        },
+        {
+          key: "X-XSS-Protection",
+          value: "1; mode=block",
+        },
+        {
+          key: "X-DNS-Prefetch-Control",
+          value: "on",
+        },
+        {
+          key: "Strict-Transport-Security",
+          value: "max-age=63072000; includeSubDomains; preload",
+        },
+        {
+          key: "Permissions-Policy",
+          value: "camera=(), microphone=(), geolocation=()",
+        },
+      ],
+    },
+    {
+      // X-Frame-Options can't allow a third-party origin, and Next can't unset
+      // it from another rule — the iframe needs it absent, not overridden.
+      source: "/studio/:path*",
+      headers: [
+        {
+          key: "X-Content-Type-Options",
+          value: "nosniff",
+        },
+        {
+          key: "Content-Security-Policy",
+          value: "frame-ancestors 'self' https://*.sanity.io;",
+        },
+        {
+          key: "X-XSS-Protection",
+          value: "1; mode=block",
+        },
+        {
+          key: "X-DNS-Prefetch-Control",
+          value: "on",
+        },
+        {
+          key: "Strict-Transport-Security",
+          value: "max-age=63072000; includeSubDomains; preload",
+        },
+        {
+          key: "Permissions-Policy",
+          value: "camera=(), microphone=(), geolocation=()",
+        },
+      ],
+    },
+  ],
+}
+
+const bundleAnalyzerPlugin = withBundleAnalyzer({
+  enabled: process.env.ANALYZE === "true",
+})
+
+const NextApp = () => {
+  const plugins = [bundleAnalyzerPlugin]
+  return plugins.reduce((config, plugin) => plugin(config), nextConfig)
+}
+
+export default NextApp

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

@@ -0,0 +1,62 @@
+{
+  "name": "bsmnt-pagebuilder-cache-starter",
+  "description": "Basement Next.js starter template (Cache Components)",
+  "version": "0.1.0",
+  "private": true,
+  "packageManager": "bun@1.3.14",
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "analyze": "cross-env ANALYZE=true bun run build",
+    "analyze:experimental": "next experimental-analyze",
+    "build": "next build",
+    "ci:secrets": "bun ./lib/scripts/setup-ci-secrets.ts",
+    "dev": "next dev",
+    "format": "biome format --write .",
+    "knip": "knip",
+    "knip:fix": "knip --fix",
+    "lighthouse": "bunx @unlighthouse/cli --site http://localhost:3000",
+    "lint": "biome lint --max-diagnostics=200",
+    "lint:fix": "biome check --write --unsafe --max-diagnostics=200",
+    "prepare": "lefthook install",
+    "start": "next start",
+    "typecheck": "tsc --noEmit",
+    "update:packages": "cross-env NPM_CHECK_INSTALLER=bun bunx npm-check -u"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1",
+    "next": "^16.3.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-use": "^17.6.0",
+    "tailwind-merge": "^3.5.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
+    "@csstools/postcss-global-data": "^4.0.0",
+    "@next/bundle-analyzer": "^16.3.0",
+    "@svgr/webpack": "^8.1.0",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/bun": "^1.3.11",
+    "@types/node": "^24.13.1",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "cross-env": "^10.1.0",
+    "knip": "^6.16.1",
+    "lefthook": "^1.13.0",
+    "postcss-functions": "^4.0.2",
+    "postcss-preset-env": "^11.2.0",
+    "tailwindcss": "^4.2.2",
+    "typescript": "^7.0.2"
+  },
+  "trustedDependencies": [
+    "@biomejs/biome",
+    "@tailwindcss/oxide",
+    "esbuild",
+    "sharp"
+  ],
+  "browserslist": "extends @sanity/browserslist-config"
+}

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

@@ -0,0 +1,65 @@
+import { existsSync } from "node:fs"
+import { fileURLToPath } from "node:url"
+import path from "node:path"
+
+// Turbopack evaluates this from .next/, sanity CLI from lib/integrations/sanity/.
+// Walk up from both candidates until we find the project root.
+const TARGET = "lib/styles/global.css"
+
+function findRoot(...candidates) {
+  for (const start of candidates) {
+    let dir = start
+    while (true) {
+      if (existsSync(path.join(dir, TARGET))) return dir
+      const parent = path.dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+  }
+  return process.cwd()
+}
+
+const projectRoot = findRoot(
+  path.dirname(fileURLToPath(import.meta.url)),
+  process.cwd(),
+)
+
+/**
+ * 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: [path.join(projectRoot, "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-cache/svg.d.ts

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

package/src/templates/next-pagebuilder-cache/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/.env.example

@@ -32,6 +32,8 @@
 # Base URL for your site (used for SEO, canonical URLs, etc.)
 # Development: http://localhost:3000
 # Production: https://your-domain.com
+# Inlined at build time — scope this to the Production environment only in
+# Vercel so Preview deployments fall through to VERCEL_PROJECT_PRODUCTION_URL.
 NEXT_PUBLIC_BASE_URL=""
 
 # Draft mode secret for preview functionality
@@ -54,8 +56,8 @@ NEXT_PUBLIC_SANITY_API_READ_TOKEN=""
 # Optional - for server-side mutations and visual editing
 # SANITY_PRIVATE_TOKEN=""
 
-# Optional - API version (defaults to 2024-03-15)
-# NEXT_PUBLIC_SANITY_API_VERSION="2024-03-15"
+# Optional - API version (defaults to 2025-02-19, the floor for Content Releases)
+# NEXT_PUBLIC_SANITY_API_VERSION="2025-02-19"
 
 
 # ============================================

package/src/templates/next-webgl/.github/workflows/ci.yml

@@ -41,7 +41,7 @@ jobs:
         run: bun install --frozen-lockfile
 
       - name: Type check
-        run: bun run typecheck:compare
+        run: bun run typecheck
 
       - name: Lint
         run: bun run lint

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

@@ -58,7 +58,6 @@
 
   // General
   "files.eol": "\n",
-  // "typescript.experimental.useTsgo": true, // Disabled: tsgo doesn't support Next.js plugin
   "javascript.suggest.autoImports": true,
   // Disable Prettier to prevent silent formatter conflicts
   "prettier.enable": false,
@@ -90,7 +89,6 @@
 
   // TypeScript
   "typescript.suggest.autoImports": true,
-  "typescript.tsdk": "node_modules/typescript/lib",
 
   // Editor labels (fixed for .tsx files)
   "workbench.editor.customLabels.patterns": {

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

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

package/src/templates/next-webgl/components/ui/image/index.tsx

@@ -9,8 +9,7 @@
 import cn from "clsx"
 import NextImage, { type ImageProps as NextImageProps } from "next/image"
 import type { CSSProperties, Ref } from "react"
-
-const DESKTOP_BREAKPOINT = 1440
+import { buildImageSizes } from "@/lib/utils/image-sizes"
 
 /**
  * Enhanced Image component props extending Next.js Image.
@@ -167,8 +166,7 @@ export function Image({
 }: ImageProps) {
   // Generate responsive sizes if not provided
   const finalSizes =
-    sizes ||
-    `(max-width: ${DESKTOP_BREAKPOINT}px) ${mobileSize}, ${desktopSize}`
+    sizes || buildImageSizes({ base: mobileSize, desktop: desktopSize })
 
   // Early return after hooks
   if (!src) return null

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

@@ -19,5 +19,5 @@
     "zustand"
   ],
   "ignoreBinaries": ["op", "gh", "vercel"],
-  "ignoreFiles": [".agents/**", ".claude/**", "hooks/**"]
+  "ignoreFiles": [".agents/**", ".claude/**", "hooks/**", "lib/integrations/hubspot/**"]
 }

package/src/templates/next-webgl/lefthook.yml

@@ -11,7 +11,7 @@ pre-commit:
       stage_fixed: true
     typecheck:
       glob: '*.{ts,tsx}'
-      run: bunx tsgo --noEmit --incremental false
+      run: bunx tsc --noEmit --incremental false
       stage_fixed: false
 
 post-merge: