bsmnt 0.10.0 → 0.12.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/image-sizes.ts

@@ -0,0 +1,72 @@
+/** Mirrors the theme's `--breakpoint-*` scale, which clears Tailwind's defaults. */
+export const BASEMENT_BREAKPOINTS = {
+  mobile: 640,
+  tablet: 768,
+  "tablet-lg": 1024,
+  desktop: 1440,
+  "desktop-large": 1920,
+} as const
+
+export type BreakpointMap = Readonly<Record<string, number>>
+
+/** Mirrors the element's variants: `grid-cols-1 tablet:grid-cols-2` → `{ base: 1, tablet: 2 }`. */
+export type ByBreakpoint<
+  T,
+  B extends BreakpointMap = typeof BASEMENT_BREAKPOINTS,
+> = { base: T } & Partial<Record<Extract<keyof B, string>, T>>
+
+function columnWidth(columns: number): string {
+  return `${Math.round(100 / columns)}vw`
+}
+
+/**
+ * Widest first, since `sizes` takes the first matching condition and the last
+ * entry must be bare. `min-width` matches the Tailwind variant's boundary; a
+ * `max-width: <next> - 1` one would leave a fractional-pixel gap.
+ */
+function toSizes(
+  base: string,
+  overrides: Readonly<Record<string, string | undefined>>,
+  scale: BreakpointMap
+): string {
+  const conditions: string[] = []
+
+  for (const [name, min] of Object.entries(scale).sort(
+    ([, a], [, b]) => b - a
+  )) {
+    const value = overrides[name]
+    if (value !== undefined) {
+      conditions.push(`(min-width: ${min}px) ${value}`)
+    }
+  }
+
+  return [...conditions, base].join(", ")
+}
+
+/** Builds `sizes` from the CSS length the image renders at per breakpoint. */
+export function buildImageSizes<
+  B extends BreakpointMap = typeof BASEMENT_BREAKPOINTS,
+>(widths: ByBreakpoint<string, B>, breakpoints?: B): string {
+  const { base, ...overrides } = widths
+  return toSizes(base, overrides, breakpoints ?? BASEMENT_BREAKPOINTS)
+}
+
+/**
+ * Builds `sizes` from a grid's column count per breakpoint. Rounded: `sizes`
+ * only steers which srcset candidate the browser picks, and gaps make the real
+ * column narrower than `100 / N` anyway.
+ */
+export function buildGridImageSizes<
+  B extends BreakpointMap = typeof BASEMENT_BREAKPOINTS,
+>(columns: ByBreakpoint<number, B>, breakpoints?: B): string {
+  const { base, ...overrides } = columns
+  const widths: Record<string, string> = {}
+
+  for (const [name, count] of Object.entries(overrides)) {
+    if (count !== undefined) {
+      widths[name] = columnWidth(count)
+    }
+  }
+
+  return toSizes(columnWidth(base), widths, breakpoints ?? BASEMENT_BREAKPOINTS)
+}

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,177 @@
+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: {
+    remotePatterns: [
+      {
+        protocol: "https",
+        hostname: "cdn.sanity.io",
+      },
+    ],
+    minimumCacheTTL: 60 * 60 * 24 * 30, // 30 days
+    qualities: [75, 90, 100],
+    formats: ["image/avif", "image/webp"],
+    deviceSizes: [
+      640, 750, 828, 1080, 1200, 1320, 1620, 1920, 2048, 2560, 3024, 3456, 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/.biome/plugins/no-fill-without-sizes.grit

@@ -0,0 +1,11 @@
+language js
+
+or {
+	`<Image $attrs />`,
+	`<SanityImage $attrs />`
+} as $image where {
+	$attrs <: contains `fill`,
+	! $attrs <: contains `fill={false}`,
+	! $attrs <: contains or { `sizes`, `mobileSize`, `desktopSize` },
+	register_diagnostic(span=$image, message="A `fill` image has no intrinsic width, so without `sizes` the browser assumes 100vw and requests the largest candidate. Pass `sizes`, or `mobileSize`/`desktopSize`.", severity="error")
+}

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

@@ -56,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