bsmnt 0.4.1 → 0.4.2

package/src/templates/next-pagebuilder/components/page-builder/renderer.tsx

@@ -1,8 +1,8 @@
 import { ArticleContent } from "./components/article-content"
 import { ContentCollection } from "./components/content-collection"
+import type { ContentCollectionSearchParams } from "./components/content-collection/types"
 import { Description } from "./components/description"
 import { Hero } from "./components/hero"
-import type { ContentCollectionSearchParams } from "./components/content-collection/types"
 import type { PageBuilderBlock, PageBuilderBlocks } from "./types"
 
 type RendererProps = {
@@ -16,7 +16,11 @@ export function Renderer({ blocks, searchParams }: RendererProps) {
   return (
     <div className="space-y-16">
       {blocks.map((block: PageBuilderBlock) => (
-        <PageBuilderNode key={block._key} block={block} searchParams={searchParams} />
+        <PageBuilderNode
+          key={block._key}
+          block={block}
+          searchParams={searchParams}
+        />
       ))}
     </div>
   )

package/src/templates/next-pagebuilder/components/page-builder/types.ts

@@ -6,18 +6,20 @@ export type PageBuilderBlock = NonNullable<
 
 export type PageBuilderBlocks = NonNullable<PAGE_QUERY_RESULT>["pageBuilder"]
 
-export type BlogContentBlock = Extract<PageBuilderBlock, { _type: "blogContent" }>
+export type BlogContentBlock = Extract<
+  PageBuilderBlock,
+  { _type: "blogContent" }
+>
 
 export type ArticleContentProps = {
   block: BlogContentBlock
-
 }
 
 export type ArticleRelatedPost = {
-  _id: string;
-  title: string | null;
-  resolvedSlug: string | null;
+  _id: string
+  title: string | null
+  resolvedSlug: string | null
   metadata?: {
-    image?: unknown;
+    image?: unknown
   } | null
-}
+}

package/src/templates/next-pagebuilder/components/page-document/index.tsx

@@ -20,7 +20,13 @@ export const getPageSections = (
   searchParams: ContentCollectionSearchParams
 ) =>
   page.pageBuilder?.length
-    ? [<Renderer key="page-builder" blocks={page.pageBuilder} searchParams={searchParams} />]
+    ? [
+        <Renderer
+          key="page-builder"
+          blocks={page.pageBuilder}
+          searchParams={searchParams}
+        />,
+      ]
     : []
 
 const buildBreadcrumbs = (
@@ -52,7 +58,11 @@ const buildBreadcrumbs = (
   return items
 }
 
-export const PageDocument = ({ page, path, searchParams }: PageDocumentProps) => {
+export const PageDocument = ({
+  page,
+  path,
+  searchParams,
+}: PageDocumentProps) => {
   const title = stegaClean(page.title) || page.title
   const sections = getPageSections(page, searchParams)
 

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

@@ -0,0 +1,25 @@
+# Lefthook configuration for git hooks
+# Cross-platform compatible (Windows, macOS, Linux)
+# https://github.com/evilmartians/lefthook
+
+pre-commit:
+  parallel: true
+  commands:
+    biome:
+      glob: '*.{js,mjs,ts,jsx,tsx,css,scss}'
+      run: bun biome check --max-diagnostics=200 --write --unsafe {staged_files}
+      stage_fixed: true
+    typecheck:
+      glob: '*.{ts,tsx}'
+      run: bunx tsgo --noEmit --incremental false
+      stage_fixed: false
+
+post-merge:
+  commands:
+    install-deps:
+      run: bun i
+
+post-checkout:
+  commands:
+    install-deps:
+      run: '[ "{3}" = "1" ] && bun i || true'

package/src/templates/next-pagebuilder/lib/integrations/sanity/sanity.types.ts

@@ -0,0 +1,208 @@
+// Placeholder types — run `bun sanity:typegen` to regenerate from your Sanity schema.
+
+type SanityImageField = {
+  asset?: { _ref: string; _type: "reference" }
+  alt?: string
+  hotspot?: object
+  crop?: object
+}
+
+type SanitySlug = { current?: string | null } | null
+
+type SanityPageMetadata = {
+  metaTitle?: string | null
+  metaDescription?: string | null
+  og?: { image?: SanityImageField | null } | null
+  index?: boolean | null
+  title?: string | null
+  description?: string | null
+  image?: SanityImageField | null
+  noIndex?: boolean | null
+}
+
+type PageReference = {
+  _id?: string
+  _ref?: string
+  _type?: string
+  slug?: SanitySlug
+  resolvedSlug?: string | null
+  title?: string | null
+}
+
+type LinkItem = {
+  _key?: string
+  _type?: string
+  page?: PageReference | null
+  href?: string | null
+  text?: string | null
+  openInNewTab?: boolean | null
+  [key: string]: unknown
+}
+
+type NavLeafItem = {
+  _key: string
+  title?: string | null
+  link?: LinkItem | null
+}
+
+type NavColumn = {
+  _key: string
+  title?: string | null
+  link?: LinkItem | null
+  items?: NavLeafItem[] | null
+}
+
+type NavMegaMenu = {
+  columns?: NavColumn[] | null
+}
+
+type NavItem = {
+  _key: string
+  title?: string | null
+  itemType?: string | null
+  link?: LinkItem | null
+  megaMenu?: NavMegaMenu | null
+}
+
+type CtaButton = {
+  _key: string
+  label?: string | null
+  link?: LinkItem | null
+  variant?: string | null
+}
+
+type FooterLinkItem = {
+  _key: string
+  label?: string | null
+  href?: string | null
+}
+
+type FooterLinkGroup = {
+  _key: string
+  title?: string | null
+  items?: FooterLinkItem[] | null
+}
+
+type SocialLink = {
+  _key: string
+  name?: string | null
+  icon?: unknown
+  url?: string | null
+  label?: string | null
+}
+
+type BlogCategory = {
+  _id: string
+  title?: string | null
+  slug?: SanitySlug
+}
+
+type BlogAuthor = {
+  _id: string
+  name?: string | null
+  avatar?: unknown
+  role?: string | null
+}
+
+type BlogContentBlock = {
+  _type: "blogContent"
+  _key: string
+  thumbnail?: SanityImageField | null
+  categories: BlogCategory[]
+  date?: string | null
+  author?: BlogAuthor | null
+  body?: Array<{ _type: string; _key?: string; [key: string]: unknown }> | null
+  relatedPosts?: Array<{
+    _id: string
+    title: string | null
+    resolvedSlug: string | null
+    metadata?: { image?: unknown } | null
+  }> | null
+  [key: string]: unknown
+}
+
+type HeroBlock = {
+  _type: "hero"
+  _key: string
+  headline?: string | null
+  [key: string]: unknown
+}
+
+type DescriptionBlock = {
+  _type: "description"
+  _key: string
+  description?: string | null
+  [key: string]: unknown
+}
+
+type BlogCollectionBlock = {
+  _type: "blogCollection"
+  _key: string
+  subtitle?: string | null
+  [key: string]: unknown
+}
+
+type PageBuilderBlockType =
+  | BlogContentBlock
+  | HeroBlock
+  | DescriptionBlock
+  | BlogCollectionBlock
+
+type PageDocument = {
+  _id: string
+  _type: string
+  _updatedAt: string
+  title?: string | null
+  subtitle?: string | null
+  slug?: SanitySlug
+  resolvedSlug?: string | null
+  pageBuilder?: PageBuilderBlockType[] | null
+  metadata?: SanityPageMetadata | null
+  [key: string]: unknown
+}
+
+type PageSlug = {
+  title: string | null
+  slug: string | null
+  _updatedAt: string
+}
+
+type PageSitemap = {
+  title: string | null
+  slug: string | null
+  _updatedAt: string
+  noIndex: boolean
+}
+
+type PageRef = {
+  _id: string
+  title: string | null
+  slug: string | null
+}
+
+type BlogArticle = PageDocument & {
+  blogContent?: {
+    thumbnail?: SanityImageField | null
+    categories: BlogCategory[]
+    date?: string | null
+    author?: BlogAuthor | null
+  } | null
+}
+
+export type ALL_PAGE_SLUGS_QUERY_RESULT = PageSlug[]
+export type PAGE_QUERY_RESULT = PageDocument | null
+export type PAGE_SITEMAP_QUERY_RESULT = PageSitemap[]
+export type ALL_BLOG_ARTICLES_QUERY_RESULT = BlogArticle[]
+export type P_REF_PB_COMP_QUERY_RESULT = PageRef[]
+export type COMPANY_DATA_QUERY_RESULT = { socialLinks?: SocialLink[] | null } | null
+export type FOOTER_QUERY_RESULT = { links?: FooterLinkGroup[] | null } | null
+export type NAVBAR_QUERY_RESULT = {
+  logo?: {
+    url?: string | null
+    metadata?: { dimensions?: unknown } | null
+    asset?: { _id: string; url: string; metadata?: { dimensions?: unknown } | null } | null
+    [key: string]: unknown
+  } | null
+  navigationItems?: NavItem[] | null
+  ctaButtons?: CtaButton[] | null
+} | null

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

@@ -67,4 +67,3 @@ button {
   cursor: pointer;
   user-select: none;
 }
-

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

@@ -1,8 +1,6 @@
 import withBundleAnalyzer from "@next/bundle-analyzer"
 import type { NextConfig } from "next"
 
-
-
 const nextConfig: NextConfig = {
   reactStrictMode: true,
   reactCompiler: true,

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

@@ -1,5 +1,5 @@
 {
-  "name": "next-pagebuilder",
+  "name": "bsmnt-pagebuilder-starter",
   "description": "Basement Next.js starter template",
   "version": "0.1.0",
   "private": true,
@@ -9,43 +9,31 @@
     "build": "next build",
     "dev": "next dev",
     "format": "biome format --write .",
-    "generate": "bun ./lib/scripts/generate.ts",
+    "knip": "bunx knip",
+    "knip:fix": "bunx knip --fix",
     "lighthouse": "bunx @unlighthouse/cli --site http://localhost:3000",
     "lint": "biome lint --max-diagnostics=200",
-    "lint:fix": "biome lint --write --unsafe --max-diagnostics=200",
+    "lint:fix": "biome check --write --unsafe --max-diagnostics=200",
+    "prepare": "lefthook install",
     "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"
+    "update:packages": "cross-env NPM_CHECK_INSTALLER=bun bunx npm-check -u"
   },
   "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",
+    "next": "^16",
+    "react": "^19",
+    "react-dom": "^19",
     "react-use": "^17.6.0",
-    "sanity": "^5.17.1",
-    "sanity-plugin-media": "^4.1.1",
     "tailwind-merge": "^3.5.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.8",
+    "@biomejs/biome": "^2.4.14",
     "@csstools/postcss-global-data": "^4.0.0",
-    "@next/bundle-analyzer": "16.2.1",
+    "@next/bundle-analyzer": "^16.2.1",
     "@svgr/webpack": "^8.1.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@types/bun": "^1.3.11",
@@ -53,11 +41,11 @@
     "@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",
+    "babel-plugin-react-compiler": "^1.0.0",
     "cross-env": "^10.1.0",
+    "lefthook": "^1.13.0",
     "postcss-functions": "^4.0.2",
     "postcss-preset-env": "^11.2.0",
-    "schema-dts": "^2.0.0",
     "tailwindcss": "^4.2.2",
     "typescript": "^5.9.3"
   },

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

@@ -1,3 +1,29 @@
+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}
@@ -23,7 +49,7 @@ const presetEnvConfig = {
  * @type {import('@csstools/postcss-global-data').pluginOptions}
  */
 const globalDataConfig = {
-  files: ["./lib/styles/global.css"],
+  files: [path.join(projectRoot, "lib/styles/global.css")],
 }
 
 const postcssConfig = {

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

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

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

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

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

@@ -7,14 +7,10 @@
     "bradlc.vscode-tailwindcss",
     "csstools.postcss",
 
-    // GraphQL (Shopify, etc.)
-    "graphql.vscode-graphql-syntax",
-
     // Sanity CMS (GROQ syntax + validation)
     "sanity-io.vscode-sanity",
 
     // DX Enhancements
-    "yoavbls.pretty-ts-errors",
-    "waderyan.gitblame"
+    "yoavbls.pretty-ts-errors"
   ]
 }

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

@@ -82,7 +82,7 @@
     ["cn\\(([^)]*)\\)", "(?:'|\"|`)([^\"'`]*)(?:'|\"|`)"],
     ["cva\\(([^)]*)\\)", "[\"'`]([^\"'`]*).*?[\"'`]"]
   ],
-  "tailwindCSS.experimental.configFile": "./lib/styles/global.css",
+  "tailwindCSS.experimental.configFile": "./lib/styles/css/tailwind.css",
   "tailwindCSS.includeLanguages": {
     "typescriptreact": "html"
   },

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

@@ -0,0 +1,47 @@
+{
+  "format_on_save": "on",
+  "lsp": {
+    "vscode-css-language-server": {
+      "settings": {
+        "css": {
+          "lint": {
+            "unknownAtRules": "ignore"
+          }
+        }
+      }
+    }
+  },
+  "languages": {
+    "JavaScript": {
+      "language_servers": ["biome", "..."],
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TypeScript": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TSX": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "CSS": {
+      "formatter": { "language_server": { "name": "biome" } }
+    },
+    "JSON": {
+      "formatter": { "language_server": { "name": "biome" } }
+    },
+    "JSONC": {
+      "formatter": { "language_server": { "name": "biome" } }
+    }
+  }
+}

package/src/templates/next-webgl/README.md

@@ -35,16 +35,17 @@ lib/
   scripts/
   store/
   styles/
+    index.css
+    tokens.css
     global.css
+    fonts.ts
     cn.ts
   utils/
-    metadata.ts
-    portable-text-to-markdown.ts
-    json-ld.ts
 ```
 
 ## Styling
 
-- Import `@/lib/styles/global.css` once in `app/layout.tsx`.
-- `lib/styles/global.css` includes Tailwind utilities, theme tokens, and app-wide global styles.
-- `lib/styles/cn.ts` is the shared class merge helper.
+- Import `@/lib/styles/index.css` once in `app/layout.tsx`.
+- Edit `lib/styles/tokens.css` for theme variables, breakpoints, and custom Tailwind utilities.
+- Edit `lib/styles/global.css` for reset rules and app-wide global styles.
+- `lib/styles/fonts.ts` handles font variables.

package/src/templates/next-webgl/_gitignore

@@ -29,7 +29,6 @@
 # misc
 .DS_Store
 *.pem
-.cursor/scratchpad.md
 
 # debug
 npm-debug.log*
@@ -57,8 +56,7 @@ yarn-error.log*
 certificates
 
 next-env.d.ts
-# claude
-.claude
+
 
 # unlighthouse
 .unlighthouse/

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

@@ -1,40 +1,26 @@
-import type { Metadata, Viewport } from "next";
-import { Geist, Geist_Mono } from "next/font/google";
-import { type PropsWithChildren, Suspense } from "react";
-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 type { Metadata, Viewport } from "next"
+import { Geist } from "next/font/google"
+import { type PropsWithChildren, Suspense } from "react"
+import { Link } from "@/components/ui/link"
+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";
+  generateWebSiteJsonLd,
+  JsonLd,
+} from "@/lib/utils/json-ld"
 
-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 = getBaseUrl();
+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 geist = Geist({
   subsets: ["latin"],
-});
-
-const mono = Geist_Mono({
-  subsets: ["latin"],
-  display: "swap",
-  variable: "--geist-mono",
-  fallback: [
-    "ui-monospace",
-    "SFMono-Regular",
-    "Consolas",
-    "Liberation Mono",
-    "Menlo",
-    "monospace",
-  ],
-});
+})
 
 export const metadata: Metadata = {
   alternates: {
@@ -87,19 +73,19 @@ export const metadata: Metadata = {
       template: APP_TITLE_TEMPLATE,
     },
   },
-};
+}
 
 export const viewport: Viewport = {
   colorScheme: "normal",
   themeColor: "#000000",
-};
+}
 
 export default async function Layout({ children }: PropsWithChildren) {
   return (
     <html
       lang="en"
       dir="ltr"
-      className={cn(mono.variable, geist.className)}
+      className={cn(fontsVariable, geist.className)}
       // NOTE: This is due to the data-theme attribute being set which causes hydration errors
       suppressHydrationWarning
     >
@@ -130,5 +116,5 @@ export default async function Layout({ children }: PropsWithChildren) {
         {children}
       </body>
     </html>
-  );
+  )
 }