bsmnt 0.0.2 → 0.1.1

package/packages/create-basement-app/templates/webgl/next.config.ts

@@ -0,0 +1,142 @@
+import withBundleAnalyzer from "@next/bundle-analyzer"
+import type { NextConfig } from "next"
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+  reactCompiler: true,
+  typedRoutes: true,
+  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",
+      },
+    },
+  },
+  cacheComponents: true,
+  experimental: {
+    browserDebugInfoInTerminal: true,
+    optimizePackageImports: [
+      "@react-three/drei",
+      "@react-three/fiber",
+      "gsap",
+      "three",
+      "postprocessing",
+      "lenis",
+      "zustand",
+    ],
+  },
+  images: {
+    dangerouslyAllowSVG: true,
+    remotePatterns: [],
+    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 () => [
+    {
+      source: "/(.*)",
+      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=()",
+        },
+      ],
+    },
+  ],
+  redirects: async () => [
+    {
+      source: "/home",
+      destination: "/",
+      permanent: true,
+    },
+  ],
+  rewrites: async () => [
+    {
+      source: "/",
+      destination: "/home",
+    },
+  ],
+}
+
+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/packages/create-basement-app/templates/webgl/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "basement-next-starter",
+  "description": "Basement Next.js starter template",
+  "version": "0.1.0",
+  "private": true,
+  "packageManager": "bun@1.3.5",
+  "scripts": {
+    "analyze": "cross-env ANALYZE=true bun run build",
+    "analyze:experimental": "next experimental-analyze",
+    "build": "bun run setup:styles && next build",
+    "dev": "bun ./lib/scripts/dev.ts",
+    "dev:https": "bun ./lib/scripts/dev.ts --https",
+    "dev:inspect": "bun ./lib/scripts/dev.ts --inspect",
+    "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",
+    "setup:styles": "bun ./lib/styles/scripts/setup-styles.ts",
+    "start": "next start",
+    "test": "bun test",
+    "test:setup": "bun test lib/scripts/setup-project.test.ts",
+    "typecheck": "tsgo --noEmit",
+    "typecheck:compare": "bun run typecheck:tsc && bun run typecheck",
+    "typecheck:tsc": "tsc --noEmit --incremental false"
+  },
+  "dependencies": {
+    "@radix-ui/react-navigation-menu": "^1.2.5",
+    "@react-three/drei": "^11.0.0-alpha.4",
+    "@react-three/fiber": "10.0.0-alpha.2",
+    "class-variance-authority": "^0.7.1",
+    "leva": "^0.9.35",
+    "next": "16.1.4",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-use": "^17.6.0",
+    "tailwind-merge": "^3.4.0",
+    "three": "^0.182.0",
+    "zod": "^4.3.6",
+    "zustand": "^5.0.10"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "@clack/prompts": "^0.11.0",
+    "@csstools/postcss-global-data": "^3.1.0",
+    "@next/bundle-analyzer": "16.1.1",
+    "@svgr/webpack": "^8.1.0",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/bun": "^1.3.6",
+    "@types/node": "^20.19.30",
+    "@types/react": "^19.2.9",
+    "@types/react-dom": "^19.2.3",
+    "@types/three": "^0.182.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260122.3",
+    "babel-plugin-react-compiler": "1.0.0",
+    "cross-env": "^10.1.0",
+    "postcss-functions": "^4.0.2",
+    "postcss-preset-env": "^10.6.1",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3"
+  },
+  "trustedDependencies": [
+    "@biomejs/biome",
+    "@tailwindcss/oxide",
+    "esbuild",
+    "sharp"
+  ]
+}

package/packages/create-basement-app/templates/webgl/postcss.config.mjs

@@ -0,0 +1,42 @@
+import { functions } from "./lib/styles/scripts/postcss-functions.mjs"
+
+/**
+ * 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/css/root.css"],
+}
+
+const postcssConfig = {
+  // NOTE: Order is important
+  plugins: {
+    "@tailwindcss/postcss": {},
+    "@csstools/postcss-global-data": globalDataConfig,
+    "postcss-functions": { functions },
+    // NOTE: This has to be last config
+    "postcss-preset-env": presetEnvConfig,
+  },
+}
+
+export default postcssConfig

package/packages/create-basement-app/templates/webgl/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  "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"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/tasks/.last-branch

@@ -0,0 +1 @@
+BertovDev/project-restructure

package/tasks/CLAUDE.md

@@ -0,0 +1,104 @@
+# Ralph Agent Instructions
+
+You are an autonomous coding agent working on a software project.
+
+## Your Task
+
+1. Read the PRD at `prd.json` (in the same directory as this file)
+2. Read the progress log at `progress.txt` (check Codebase Patterns section first)
+3. Check you're on the correct branch from PRD `branchName`. If not, check it out or create from main.
+4. Pick the **highest priority** user story where `passes: false`
+5. Implement that single user story
+6. Run quality checks (e.g., typecheck, lint, test - use whatever your project requires)
+7. Update CLAUDE.md files if you discover reusable patterns (see below)
+8. If checks pass, commit ALL changes with message: `feat: [Story ID] - [Story Title]`
+9. Update the PRD to set `passes: true` for the completed story
+10. Append your progress to `progress.txt`
+
+## Progress Report Format
+
+APPEND to progress.txt (never replace, always append):
+```
+## [Date/Time] - [Story ID]
+- What was implemented
+- Files changed
+- **Learnings for future iterations:**
+  - Patterns discovered (e.g., "this codebase uses X for Y")
+  - Gotchas encountered (e.g., "don't forget to update Z when changing W")
+  - Useful context (e.g., "the evaluation panel is in component X")
+---
+```
+
+The learnings section is critical - it helps future iterations avoid repeating mistakes and understand the codebase better.
+
+## Consolidate Patterns
+
+If you discover a **reusable pattern** that future iterations should know, add it to the `## Codebase Patterns` section at the TOP of progress.txt (create it if it doesn't exist). This section should consolidate the most important learnings:
+
+```
+## Codebase Patterns
+- Example: Use `sql<number>` template for aggregations
+- Example: Always use `IF NOT EXISTS` for migrations
+- Example: Export types from actions.ts for UI components
+```
+
+Only add patterns that are **general and reusable**, not story-specific details.
+
+## Update CLAUDE.md Files
+
+Before committing, check if any edited files have learnings worth preserving in nearby CLAUDE.md files:
+
+1. **Identify directories with edited files** - Look at which directories you modified
+2. **Check for existing CLAUDE.md** - Look for CLAUDE.md in those directories or parent directories
+3. **Add valuable learnings** - If you discovered something future developers/agents should know:
+   - API patterns or conventions specific to that module
+   - Gotchas or non-obvious requirements
+   - Dependencies between files
+   - Testing approaches for that area
+   - Configuration or environment requirements
+
+**Examples of good CLAUDE.md additions:**
+- "When modifying X, also update Y to keep them in sync"
+- "This module uses pattern Z for all API calls"
+- "Tests require the dev server running on PORT 3000"
+- "Field names must match the template exactly"
+
+**Do NOT add:**
+- Story-specific implementation details
+- Temporary debugging notes
+- Information already in progress.txt
+
+Only update CLAUDE.md if you have **genuinely reusable knowledge** that would help future work in that directory.
+
+## Quality Requirements
+
+- ALL commits must pass your project's quality checks (typecheck, lint, test)
+- Do NOT commit broken code
+- Keep changes focused and minimal
+- Follow existing code patterns
+
+## Browser Testing (If Available)
+
+For any story that changes UI, verify it works in the browser if you have browser testing tools configured (e.g., via MCP):
+
+1. Navigate to the relevant page
+2. Verify the UI changes work as expected
+3. Take a screenshot if helpful for the progress log
+
+If no browser tools are available, note in your progress report that manual browser verification is needed.
+
+## Stop Condition
+
+After completing a user story, check if ALL stories have `passes: true`.
+
+If ALL stories are complete and passing, reply with:
+<promise>COMPLETE</promise>
+
+If there are still stories with `passes: false`, end your response normally (another iteration will pick up the next story).
+
+## Important
+
+- Work on ONE story per iteration
+- Commit frequently
+- Keep CI green
+- Read the Codebase Patterns section in progress.txt before starting

package/tasks/archive/2026-02-09-next-starter-dynamic-layers/prd.json

@@ -0,0 +1,153 @@
+{
+  "project": "basement-cli",
+  "branchName": "ralph/next-starter-dynamic-layers",
+  "description": "Replace 4 static templates with next-starter clone + dynamic technology layers to eliminate maintenance burden",
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "Create layer configuration system",
+      "description": "As a CLI maintainer, I want technology layers defined in a config file so that adding or modifying layers only requires changing one file.",
+      "acceptanceCriteria": [
+        "Add LAYER_CONFIG export to src/mergers/config.js alongside existing CMS_CONFIG",
+        "Each layer config defines: replaceFiles, additivePaths, dependencies, devDependencies",
+        "Add getLayerConfig(layer) helper function export",
+        "Config contains entries for webgl, webgpu, and experiment",
+        "webgpu is a deps-only layer (empty replaceFiles and additivePaths arrays)",
+        "webgl dependencies: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.182.0, @gsap/react ^2.0.0, @radix-ui/react-navigation-menu ^1.2.5, leva ^0.9.35, devDeps: @types/three ^0.182.0",
+        "webgpu dependencies: @react-three/fiber 10.0.0-alpha.2, @react-three/drei ^11.0.0-alpha.4, three ^0.182.0, leva ^0.9.35, lucide-react ^0.474.0, @radix-ui/react-navigation-menu ^1.2.5, devDeps: @types/three ^0.182.0",
+        "experiment dependencies: @react-three/fiber ^9.5.0, @react-three/drei ^10.7.7, three ^0.172.0, leva ^0.9.35, lucide-react ^0.474.0, @radix-ui/react-navigation-menu ^1.2.5, devDeps: @types/three ^0.182.0",
+        "Typecheck passes"
+      ],
+      "priority": 1,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-002",
+      "title": "Extract layer files from templates",
+      "description": "As a CLI maintainer, I need the unique files from each template extracted into a layers/ directory so they can be overlaid on next-starter.",
+      "acceptanceCriteria": [
+        "Create layers/webgl/app/page.tsx copied from template/webgl/app/page.tsx (the one that imports DynamicCanvas)",
+        "Create layers/webgl/components/webgl/canvas/dynamic.tsx from template/webgl/components/webgl/canvas/dynamic.tsx",
+        "Create layers/webgl/components/webgl/canvas/index.tsx from template/webgl/components/webgl/canvas/index.tsx",
+        "Create layers/webgl/components/webgl/components/scene/index.tsx from template/webgl/components/webgl/components/scene/index.tsx",
+        "Create layers/experiment/components/layout/header/index.tsx from template/experiment/components/layout/header/index.tsx",
+        "Create layers/experiment/components/layout/navigation-menu.tsx from template/experiment/components/layout/navigation-menu.tsx",
+        "Create layers/experiment/lib/constats.ts from template/experiment/lib/constats.ts",
+        "Create layers/experiment/lib/utils/cn.ts from template/experiment/lib/utils/cn.ts",
+        "Create empty layers/webgpu/ directory with a .gitkeep file",
+        "All copied files are byte-for-byte identical to their template source files",
+        "Typecheck passes"
+      ],
+      "priority": 2,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-003",
+      "title": "Implement layer injection function",
+      "description": "As the CLI system, I need to overlay layer-specific files on top of the next-starter base so that WebGL/WebGPU/Experiment projects get their unique components.",
+      "acceptanceCriteria": [
+        "Add injectLayer(targetDir, layer, spinner) function to src/mergers/index.js",
+        "Function resolves layer directory from CLI repo's layers/{type}/ path using __dirname",
+        "Function calls existing detectPathPrefix() to handle src/ directory structure",
+        "Function copies additive files from local layers/ directory (no tiged clone needed)",
+        "Function replaces files listed in replaceFiles config (overwrites base version with overwrite: true)",
+        "Function uses existing transformPath() for path prefix support",
+        "Function returns results object with replaced, copied, skipped, and failed arrays",
+        "When layer is 'default' or not found in config, function returns early with skipped result (no error)",
+        "Extend formatMergeResults() to display replaced entries with checkmark prefix",
+        "Typecheck passes"
+      ],
+      "priority": 3,
+      "passes": true,
+      "notes": "Reuses existing detectPathPrefix() and transformPath() from src/mergers/index.js. Layer files are local (no network request)."
+    },
+    {
+      "id": "US-004",
+      "title": "Change create.js to clone next-starter instead of template",
+      "description": "As a developer using the CLI, I want my project scaffolded from the latest next-starter repo so I always get the most up-to-date base.",
+      "acceptanceCriteria": [
+        "Change tiged source on line 124 of src/commands/create.js from 'github:basementstudio/basement-cli/template/${type}#${branch}' to 'github:basementstudio/next-starter#main'",
+        "Remove the BASEMENT_CLI_BRANCH env var usage for template (keep if used elsewhere)",
+        "Delete bun.lock file after clone if it exists (since dependencies will be modified)",
+        "Update download spinner text to say 'Downloading next-starter from GitHub...' instead of mentioning template type",
+        "Update error/troubleshooting message in catch block to reference basementstudio/next-starter instead of basementstudio/basement-cli/template/{type}",
+        "Typecheck passes"
+      ],
+      "priority": 4,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-005",
+      "title": "Wire layer injection into create flow",
+      "description": "As the CLI system, I need the layer injection step between template download and CMS integration so layers are applied at the right time.",
+      "acceptanceCriteria": [
+        "Add new step between template download (step 3) and CMS integration (step 3.5) in src/commands/create.js",
+        "Layer injection only runs when type !== 'default'",
+        "Import injectLayer and formatMergeResults from src/mergers/index.js",
+        "Show ora spinner with layer name during injection (e.g. 'Applying webgl layer...')",
+        "Display injection results to user using formatMergeResults",
+        "On failure, show warning (not hard error) and continue with project creation",
+        "Typecheck passes"
+      ],
+      "priority": 5,
+      "passes": true,
+      "notes": "Must run BEFORE CMS integration because layers don't modify layout.tsx, and CMS mergers need the base layout intact."
+    },
+    {
+      "id": "US-006",
+      "title": "Config-driven dependency injection in package.json hydration",
+      "description": "As the CLI system, I need package.json hydration to read layer dependencies from LAYER_CONFIG instead of being hardcoded.",
+      "acceptanceCriteria": [
+        "Import getLayerConfig from src/mergers/config.js in create.js",
+        "Read layer dependencies from LAYER_CONFIG and merge into package.json: pkg.dependencies = { ...pkg.dependencies, ...layerConfig.dependencies }",
+        "Also merge devDependencies from layer config",
+        "CMS dependency injection (Sanity/BaseHub) still works unchanged",
+        "Animation library injection (GSAP/Framer Motion) still works unchanged",
+        "Simplify package.json handling: next-starter uses package.json directly (not package.template.json), remove the rename logic",
+        "Project name still set to user-provided name, version still set to 0.1.0",
+        "Typecheck passes"
+      ],
+      "priority": 6,
+      "passes": true,
+      "notes": "next-starter uses package.json not package.template.json, so the existsSync check for package.template.json can be simplified."
+    },
+    {
+      "id": "US-007",
+      "title": "Delete template directory",
+      "description": "As a CLI maintainer, I want the template/ directory removed so there's no duplicated code to maintain.",
+      "acceptanceCriteria": [
+        "Delete template/default/ directory and all contents",
+        "Delete template/webgl/ directory and all contents",
+        "Delete template/webgpu/ directory and all contents",
+        "Delete template/experiment/ directory and all contents",
+        "Grep source code for any remaining references to 'template/' paths and remove them",
+        "Grep source code for any remaining references to 'basementstudio/basement-cli/template/' and remove them",
+        "Typecheck passes"
+      ],
+      "priority": 7,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-008",
+      "title": "End-to-end verification of all template types",
+      "description": "As a CLI maintainer, I need to verify all template + CMS + animation combinations produce working projects.",
+      "acceptanceCriteria": [
+        "Run npm link to install CLI locally",
+        "Run: basement -c test-default -d -no-cms -no-animation -claude -no-hooks — project creates successfully",
+        "Run: basement -c test-webgl -webgl -no-cms -no-animation -claude -no-hooks — project has R3F components in components/webgl/",
+        "Run: basement -c test-webgpu -webgpu -no-cms -no-animation -claude -no-hooks — project has WebGPU deps in package.json",
+        "Run: basement -c test-experiment -exp -no-cms -no-animation -claude -no-hooks — project has custom header with NavigationMenu",
+        "Run: basement -c test-sanity -webgl -sanity -gsap -claude -no-hooks — project has CMS + animation + layer deps",
+        "All generated projects pass bun install without errors",
+        "Typecheck passes"
+      ],
+      "priority": 8,
+      "passes": true,
+      "notes": "This is the final validation step. Each test project should be cleaned up after verification."
+    }
+  ]
+}