bsmnt 0.1.2 → 0.2.0

package/package.json

@@ -1,21 +1,31 @@
 {
 	"name": "bsmnt",
-	"version": "0.1.2",
+	"version": "0.2.0",
+	"packageManager": "bun@1.2.20",
 	"description": "CLI to scaffold basement projects and add integrations",
 	"type": "module",
 	"bin": {
-		"bsmnt": "./bin/index.js"
+		"bsmnt": "./index.js"
 	},
+	"main": "./dist/index.js",
+	"files": [
+		"dist",
+		"index.js",
+		"src/templates",
+		"src/template-hooks",
+		"plugins"
+	],
 	"scripts": {
-		"build": "bun pm pack --dry-run --ignore-scripts",
-		"check": "for f in $(rg --files bin src -g '*.js'); do node --check \"$f\"; done",
+		"build": "tsc",
+		"check": "tsc --noEmit",
+		"dev": "tsx src/index.ts",
 		"lint": "biome check .",
 		"lint:fix": "biome check --write .",
-		"test": "echo \"Error: no test specified\" && exit 1",
 		"changeset": "changeset",
 		"version-packages": "changeset version",
 		"release": "changeset publish",
-		"prepublishOnly": "bun run build"
+		"prepublishOnly": "bun run build",
+		"default": "turbo run dev --filter=basement-next-starter"
 	},
 	"keywords": [
 		"webgpu",
@@ -27,18 +37,21 @@
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"chalk": "^5.6.2",
-		"dotenv": "^17.2.3",
+		"commander": "^13.1.0",
 		"fs-extra": "^11.3.3",
-		"inquirer": "^9.3.8",
 		"ora": "^9.1.0",
 		"picocolors": "^1.1.1",
-		"prompts": "^2.4.2",
-		"tiged": "^2.12.7"
+		"prompts": "^2.4.2"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.14",
 		"@changesets/changelog-github": "^0.5.2",
-		"@changesets/cli": "^2.29.8"
+		"@changesets/cli": "^2.29.8",
+		"@types/fs-extra": "^11.0.4",
+		"@types/node": "^25.2.3",
+		"@types/prompts": "^2.4.9",
+		"tsx": "^4.19.0",
+		"turbo": "^2.5.0",
+		"typescript": "^5.8.0"
 	}
 }

package/{packages/create-basement-app/templates/experiment → src/templates/next-experiments}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "basement-next-starter",
+  "name": "basement-next-starter-experiments",
   "description": "Basement Next.js starter template",
   "version": "0.1.0",
   "private": true,

package/src/templates/next-webgl/lib/renderer.ts

@@ -0,0 +1,7 @@
+/**
+ * Renderer configuration
+ *
+ * When true, forces the WebGL renderer (stable, wide compatibility).
+ * When false, uses the WebGPU renderer (next-gen, better performance).
+ */
+export const FORCE_WEBGL = true

package/{packages/create-basement-app/templates/webgl → src/templates/next-webgl}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "basement-next-starter",
+  "name": "basement-next-starter-webgl",
   "description": "Basement Next.js starter template",
   "version": "0.1.0",
   "private": true,

package/.changeset/README.md

@@ -1,10 +0,0 @@
-# Changesets
-
-Create a changeset in feature branches before merging:
-
-```bash
-bun run changeset
-```
-
-On merge to `main`, GitHub Actions opens or updates a release PR with version/changelog changes.
-Merging that release PR publishes to npm via Trusted Publishing.

package/.changeset/config.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
-  "changelog": [
-    "@changesets/changelog-github",
-    {
-      "repo": "basementstudio/basement-cli"
-    }
-  ],
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}

package/.github/workflows/ci.yml

@@ -1,37 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    branches:
-      - main
-  push:
-    branches:
-      - main
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Type check
-        run: bun run check
-
-      - name: Build
-        run: bun run build
-
-      - name: Ensure changeset exists for PR changes
-        if: github.event_name == 'pull_request'
-        run: bunx changeset status --since=origin/${{ github.base_ref }}

package/.github/workflows/release.yml

@@ -1,56 +0,0 @@
-name: Version and Release
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  pull-requests: write
-  id-token: write
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Setup Node for npm publishing
-        uses: actions/setup-node@v4
-        with:
-          node-version: 24
-
-      - name: Use npm 11.6.2
-        run: npm i -g npm@11.6.2
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Configure npm for publishing
-        run: |
-          cat > ~/.npmrc <<'EOF'
-          registry=https://registry.npmjs.org/
-          access=public
-          EOF
-
-      - name: Version packages or publish
-        uses: changesets/action@v1
-        with:
-          version: bun run version-packages
-          publish: bun run release
-          createGithubReleases: true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.tldr/cache/call_graph.json

@@ -1,7 +0,0 @@
-{
-  "edges": [],
-  "languages": [
-    "typescript"
-  ],
-  "timestamp": 1769018359.8225532
-}

package/.tldr/languages.json

@@ -1,6 +0,0 @@
-{
-  "languages": [
-    "typescript"
-  ],
-  "timestamp": 1769018359.822764
-}

package/.tldr/status

@@ -1 +0,0 @@
-stopped

package/.tldrignore

@@ -1,84 +0,0 @@
-# TLDR ignore patterns (gitignore syntax)
-# Auto-generated - review and customize for your project
-# Docs: https://git-scm.com/docs/gitignore
-
-# ===================
-# Dependencies
-# ===================
-node_modules/
-.venv/
-venv/
-env/
-__pycache__/
-.tox/
-.nox/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-vendor/
-Pods/
-
-# ===================
-# Build outputs
-# ===================
-dist/
-build/
-out/
-target/
-*.egg-info/
-*.whl
-*.pyc
-*.pyo
-
-# ===================
-# Binary/large files
-# ===================
-*.so
-*.dylib
-*.dll
-*.exe
-*.bin
-*.o
-*.a
-*.lib
-
-# ===================
-# IDE/editors
-# ===================
-.idea/
-.vscode/
-*.swp
-*.swo
-*~
-
-# ===================
-# Security (always exclude)
-# ===================
-.env
-.env.*
-*.pem
-*.key
-*.p12
-*.pfx
-credentials.*
-secrets.*
-
-# ===================
-# Version control
-# ===================
-.git/
-.hg/
-.svn/
-
-# ===================
-# OS files
-# ===================
-.DS_Store
-Thumbs.db
-
-# ===================
-# Project-specific
-# Add your custom patterns below
-# ===================
-# large_test_fixtures/
-# data/

package/.vscode/settings.json

@@ -1,98 +0,0 @@
-{
-  // Formatting
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "biomejs.biome",
-  "editor.codeActionsOnSave": {
-    "source.fixAll.biome": "always",
-    "source.organizeImports.biome": "always"
-  },
-
-  // TypeScript
-  "typescript.suggest.autoImports": true,
-  "typescript.preferences.importModuleSpecifier": "non-relative",
-  "typescript.tsdk": "node_modules/typescript/lib",
-  // "typescript.experimental.useTsgo": true, // Disabled: tsgo doesn't support Next.js plugin
-  "javascript.suggest.autoImports": true,
-
-  // Editor labels (fixed for .tsx files)
-  "workbench.editor.customLabels.patterns": {
-    "**/app/**/page.tsx": "${dirname(1)}/${dirname} <page>",
-    "**/app/**/layout.tsx": "${dirname(1)}/${dirname} <layout>",
-    "**/app/api/**/route.ts": "${dirname(1)}/${dirname} <route>",
-    "**/components/**/index.tsx": "${dirname} <component>"
-  },
-
-  // File associations
-  "files.associations": {
-    "*.json": "jsonc"
-  },
-
-  // CSS (Tailwind v4)
-  "css.lint.validProperties": ["user-drag"],
-  "css.lint.unknownAtRules": "ignore",
-  "tailwindCSS.experimental.configFile": "./lib/styles/css/tailwind.css",
-  "tailwindCSS.includeLanguages": {
-    "typescriptreact": "html"
-  },
-  "tailwindCSS.classFunctions": ["cn", "cva", "twMerge", "cx"],
-  "tailwindCSS.classAttributes": [
-    "class",
-    "className",
-    ".*ClassName",
-    ".*Styles"
-  ],
-  "tailwindCSS.experimental.classRegex": [
-    ["cn\\(([^)]*)\\)", "(?:'|\"|`)([^\"'`]*)(?:'|\"|`)"],
-    ["cva\\(([^)]*)\\)", "[\"'`]([^\"'`]*).*?[\"'`]"]
-  ],
-
-  // Search exclusions (performance)
-  "search.exclude": {
-    "**/node_modules": true,
-    "**/.next": true,
-    "**/bun.lock": true,
-    "**/.vercel": true,
-    "**/lib/integrations/sanity/sanity.types.ts": true
-  },
-
-  // Language-specific formatters
-  "[css]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-
-  // General
-  "files.eol": "\n",
-  "workbench.editorAssociations": {
-    "*.svg": "default"
-  },
-  "colorize.languages": [
-    "javascript",
-    "typescript",
-    "css",
-    "scss",
-    "less",
-    "html",
-    "json",
-    "yaml",
-    "markdown",
-    "glsl"
-  ]
-}

package/CHANGELOG.md

@@ -1,68 +0,0 @@
-# @basementstudio/cli
-
-## 0.1.2
-
-### Patch Changes
-
-- [#40](https://github.com/basementstudio/basement-cli/pull/40) [`bf969b1`](https://github.com/basementstudio/basement-cli/commit/bf969b1908fc8bfc0bcca0b1de24721c1de9c992) Thanks [@BertovDev](https://github.com/BertovDev)! - Fix bunx compatibility by aligning bin name with package name
-
-## 0.1.1
-
-### Patch Changes
-
-- [#39](https://github.com/basementstudio/basement-cli/pull/39) [`43a5857`](https://github.com/basementstudio/basement-cli/commit/43a5857a33350e344494d85c70a2400ac038695c) Thanks [@BertovDev](https://github.com/BertovDev)! - Add WebGPU template support
-
-- [#33](https://github.com/basementstudio/basement-cli/pull/33) [`9bef7ca`](https://github.com/basementstudio/basement-cli/commit/9bef7ca91ba7fa5928263c76adcc9f6bf77c3143) Thanks [@BertovDev](https://github.com/BertovDev)! - Remove BaseHub CMS integration. BaseHub was a stub that was never fully implemented. Sanity remains as the only CMS option.
-
-- [#36](https://github.com/basementstudio/basement-cli/pull/36) [`ffa1407`](https://github.com/basementstudio/basement-cli/commit/ffa1407c299a50dbf27c4472e3e8d89bf66ed4fa) Thanks [@mustache-dev](https://github.com/mustache-dev)! - One r3f canvas for webgl-webgpu avoids redundancy
-
-## 0.1.0
-
-### Minor Changes
-
-- [#29](https://github.com/basementstudio/basement-cli/pull/29) [`e30588e`](https://github.com/basementstudio/basement-cli/commit/e30588e8609835add7314cbbfc4453ca6d47c195) Thanks [@BertovDev](https://github.com/BertovDev)! - Restructure project into a bun workspaces monorepo with two packages: @basementstudio/cli and @basementstudio/create-basement-app.
-
-  Split CLI entry point and commands into packages/cli
-
-  Move template scaffolding, mergers, integrations, hooks, and plugins into packages/create-basement-app
-
-  Replace remote tiged template downloads with local standalone templates (default, webgl, webgpu, experiment)
-
-  Move Sanity and BaseHub integration files locally with declarative config manifests (config.js)
-
-  Centralize animation and hook dependency configs in create-basement-app/src/configs/
-
-  Update CI workflow and changeset config for workspace publishing
-
-  Remove old root-level bin/, src/, layers/, and dead
-  code
-
-## 0.0.2
-
-### Patch Changes
-
-- [#27](https://github.com/basementstudio/basement-cli/pull/27) [`3c4844f`](https://github.com/basementstudio/basement-cli/commit/3c4844f4e8de13a7618e655badc9be96a39bd059) Thanks [@valebearzotti](https://github.com/valebearzotti)! - Test changeset to validate the release PR and publish workflow flow after 0.0.1.
-
-## 0.0.1
-
-### Patch Changes
-
-- [#24](https://github.com/basementstudio/basement-cli/pull/24) [`378fa57`](https://github.com/basementstudio/basement-cli/commit/378fa579a5b4ee1ad5364090fff10d7fb3acecd6) Thanks [@valebearzotti](https://github.com/valebearzotti)! - Rename package to bsmnt and trigger first patch release to 0.0.1.
-
-## 0.2.3
-
-### Patch Changes
-
-- [#22](https://github.com/basementstudio/basement-cli/pull/22) [`56ab8fe`](https://github.com/basementstudio/basement-cli/commit/56ab8fe4e1bbbfb014887719ba308af26e1a7c1c) Thanks [@valebearzotti](https://github.com/valebearzotti)! - Test changeset to trigger automated patch version bump flow.
-
-## 0.2.2
-
-### Patch Changes
-
-- [#14](https://github.com/basementstudio/basement-cli/pull/14) [`c3e43db`](https://github.com/basementstudio/basement-cli/commit/c3e43db93e417b46ffc6dbe9d7120a5600a1bf08) Thanks [@valebearzotti](https://github.com/valebearzotti)! - Retry npm release after fixing trusted publisher workflow configuration.
-
-## 0.2.1
-
-### Patch Changes
-
-- [#12](https://github.com/basementstudio/basement-cli/pull/12) [`9af1be7`](https://github.com/basementstudio/basement-cli/commit/9af1be7701eeea3d1843cacdce52e144954aac0d) Thanks [@valebearzotti](https://github.com/valebearzotti)! - Set up automated npm releases with Changesets and GitHub Actions.

package/CLAUDE.md

@@ -1,156 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is **basement**, a CLI tool that scaffolds Next.js projects with AI agent integration. It creates projects from templates (Default, WebGL, WebGPU, Experiment) and optionally injects CMS integrations (Sanity) and animation libraries (GSAP, Framer Motion).
-
-## Commands
-
-### CLI Development
-```bash
-cd packages/cli && npm link   # Install CLI locally for testing
-basement                      # Run the CLI
-```
-
-### Generated Project Commands
-Projects created by this CLI use these commands:
-```bash
-bun dev               # Start dev server with Turbopack
-bun build             # Build for production
-bun lint              # Run Biome linter
-bun lint:fix          # Auto-fix linting issues
-bun typecheck         # Type check with tsgo
-bun generate          # Scaffold components/hooks
-bun analyze           # Bundle size analysis
-```
-
-Sanity-specific (when Sanity CMS is selected):
-```bash
-bun sanity:extract    # Extract Sanity schema
-bun sanity:typegen    # Generate TS types from Sanity schema
-```
-
-## Architecture
-
-This project is a **bun workspaces monorepo** with two packages:
-
-```
-basement-starter-cli/
-├── packages/
-│   ├── cli/                              # @basementstudio/cli
-│   │   ├── bin/index.js                  # CLI entry point (basement command)
-│   │   └── src/commands/
-│   │       ├── create.js                 # Main project creation logic
-│   │       ├── add-integration.js        # Add CMS to existing projects
-│   │       ├── worktree.js               # Git worktree management
-│   │       └── setup-sanity.js           # Sanity project provisioning
-│   └── create-basement-app/              # @basementstudio/create-basement-app
-│       ├── src/
-│       │   ├── index.js                  # Barrel exports (public API)
-│       │   ├── mergers/                  # File merge logic (layout, sitemap, config)
-│       │   └── configs/animations.js     # Animation dependency configs
-│       ├── templates/                    # Standalone project templates
-│       │   ├── default/                  # Next.js 16 + React 19 + Tailwind v4
-│       │   ├── webgl/                    # + React Three Fiber + Three.js
-│       │   ├── webgpu/                   # + R3F WebGPU renderer (alpha)
-│       │   └── experiment/               # + Creative coding navigation UI
-│       ├── integrations/                 # CMS integration files + config manifests
-│       │   └── sanity/                   # Sanity files, mergers, config.js
-│       ├── template-hooks/               # Reusable React hooks + config.js
-│       └── plugins/                      # Biome linting rules (Grit patterns)
-├── .changeset/                           # Changeset config for versioning
-├── .github/workflows/release.yml         # CI: publish both packages to npm
-├── biome.json                            # Shared Biome config (root-level)
-└── package.json                          # Workspace root (private, no runtime deps)
-```
-
-### CLI Flow (packages/cli/src/commands/create.js)
-1. **Prompts**: Collect project name, template type, CMS, animation library, agent preference, hooks
-2. **Template Copy**: Copy standalone template from `create-basement-app/templates/{type}/` (instant, no network)
-3. **Integration Injection**: Merge CMS files from local `create-basement-app/integrations/{cms}/files/`
-4. **Package Hydration**: Inject CMS deps, animation deps, hook deps, and scripts (all from config manifests)
-5. **Agent Skills**: Install AI agent skills via `bunx skills add`
-6. **Hooks**: Copy selected hooks from `create-basement-app/template-hooks/`
-
-## Generated Project Stack
-
-Projects created by this CLI use:
-- **Next.js 16+** with App Router, Turbopack, Cache Components
-- **React 19+** with React Compiler (no manual useMemo/useCallback needed)
-- **TypeScript** strict mode with `noUncheckedIndexedAccess`
-- **Tailwind CSS v4** (CSS-first configuration)
-- **Biome** for linting/formatting
-- **Zustand** for state management
-- **Bun** as runtime/package manager
-
-## Key Guidelines from Cursor Rules
-
-### React Compiler
-React Compiler is enabled - do NOT use `useMemo`, `useCallback`, or `React.memo`. Exception: use `useRef` for object instantiation to prevent infinite loops.
-
-```tsx
-// ❌ DON'T
-const instance = new SomeClass()
-
-// ✅ DO
-const instanceRef = useRef<SomeClass | null>(null)
-if (!instanceRef.current) instanceRef.current = new SomeClass()
-```
-
-### React 19 Features
-- `<Activity />` - Defer off-screen component updates (tabs, carousels, WebGL scenes)
-- `useEffectEvent` - Separate event logic from effect dependencies
-- `cacheSignal()` - Auto-abort signal for server component data fetching
-- Refs as regular props (no forwardRef needed)
-
-### Image Components
-- Use `@/components/ui/image` for standard images (not `next/image` directly)
-- For WebGL: use `@/lib/webgl/components/image`
-
-### CSS Modules
-Import as `s`, use `cn` from `@/styles/cn` for className conditionals:
-```tsx
-import s from './component.module.css'
-import { cn } from '@/styles/cn'
-```
-
-### Custom PostCSS Functions
-- `tovw(pixels)` - Convert to viewport width
-- `torem(pixels)` - Convert to rem
-- `columns(n)` - Width based on grid columns
-
-### Sanity CMS
-- All files in `/lib/integrations/sanity/`
-- Use `defineType`, `defineField`, `defineArrayMember` for schemas
-- GROQ queries use `SCREAMING_SNAKE_CASE`, wrap with `defineQuery`
-- Use `sanityFetch` (includes `cacheSignal()` automatically)
-- Visual editing: add `data-sanity` attributes
-- Nested layouts (e.g. `app/studio/layout.tsx`) must NOT render `<html>` or `<body>` tags — the root layout already provides them. Just return `children`.
-- Studio route guard: site chrome (nav, skip link, footer) is wrapped in `<SanityStudioGuard>` — a `"use client"` component using `useSelectedLayoutSegment()` that returns `null` on `/studio` routes. This prevents layout duplication in the Sanity Presentation tool.
-
-### Next.js Dynamic Rendering Rules
-**NEVER call `headers()`, `cookies()`, `draftMode()`, or `searchParams` in root layouts** — these trigger "uncached data / Runtime data accessed outside `<Suspense>`" errors that block the entire page. Instead:
-- For route detection in layouts: use `useSelectedLayoutSegment()` in a `"use client"` wrapper component
-- For draft mode / visual editing: extract into an async server component wrapped in its own `<Suspense>` boundary (see `components/sanity/visual-editing.tsx`)
-- Root layouts should have ZERO dynamic function calls — encapsulate all dynamic behavior in child components with proper Suspense boundaries
-
-### Integration File Sources
-- **Templates** (`packages/create-basement-app/templates/`) are standalone, complete Next.js projects (no layer overlay needed)
-- **CMS integrations** (`packages/create-basement-app/integrations/`) are LOCAL files with config manifests — no remote GitHub cloning
-- **Config manifests** (`config.js` in each integration) declare deps, scripts, additivePaths, and mergeFiles
-- Files that need to exist in generated projects but aren't in the integration directory must be **generated inline by the merger** (e.g., `SanityStudioGuard` component is written by `layout-merger.js`)
-
-### Debug Components
-Always gate debug UI (not auto-removed in production):
-```tsx
-{process.env.NODE_ENV === 'development' && <Stats />}
-```
-
-## Biome Plugins
-
-Custom linting rules in `packages/create-basement-app/plugins/`:
-- `no-anchor-element.grit` - Enforce Next.js `<Link>` over `<a>`
-- `no-unnecessary-forwardref.grit` - Prevent forwardRef with React 19
-- `no-relative-parent-imports.grit` - Enforce `@/` alias imports