@basementstudio/shader-lab 0.1.0

package/.biome/plugins/README.md

@@ -0,0 +1,21 @@
+## Plugins
+
+### 1. `no-anchor-element.grit`
+Enforces using Next.js `<Link>` component instead of HTML `<a>` elements.
+
+### 2. `no-unnecessary-forwardref.grit`
+Checks for unnecessary `forwardRef` usage in React 19 with the compiler.
+
+### 3. `no-relative-parent-imports.grit`
+Forbids relative parent imports (`../`) and encourages alias imports (`@/`).
+
+## Plugin Configuration
+
+The plugins are configured in `biome.json`:
+```json
+"plugins": [
+  "./biome-plugins/no-anchor-element.grit",
+  "./biome-plugins/no-unnecessary-forwardref.grit",
+  "./biome-plugins/no-relative-parent-imports.grit"
+]
+``` 

package/.biome/plugins/no-anchor-element.grit

@@ -0,0 +1,12 @@
+language js;
+
+`<a $attrs>$content</a>` as $anchor where {
+    !$anchor <: within `if ($condition) { return ($jsx) }` where {
+        $condition <: contains or { `isExternal`, `isExternalSSR` }
+    },
+    register_diagnostic(
+        span = $anchor,
+        message = "Use custom Link component instead of <a> element. The Link component handles both internal and external links automatically.",
+        severity = "error"
+    )
+} 

package/.biome/plugins/no-relative-parent-imports.grit

@@ -0,0 +1,10 @@
+language js;
+
+`import $imports from $source` as $import where {
+    $source <: r"['\"]\.\.\/\.\.\/.*['\"]",
+    register_diagnostic(
+        span = $import,
+        message = "Use alias imports (~/dir/) instead of deep relative imports (../../). Single level imports (../) are allowed for colocated files.",
+        severity = "error"
+    )
+} 

package/.biome/plugins/no-unnecessary-forwardref.grit

@@ -0,0 +1,9 @@
+language js;
+
+`forwardRef($func)` as $ref where {
+    register_diagnostic(
+        span = $ref,
+        message = "forwardRef is unnecessary in React 19 with the compiler",
+        severity = "warning"
+    )
+} 

package/.changeset/README.md

@@ -0,0 +1,17 @@
+# Changesets
+
+Run `bun run changeset` in a feature branch when a package change should ship.
+
+This creates a markdown file in `.changeset` where you choose:
+
+- `patch` for fixes
+- `minor` for backward-compatible features
+- `major` for breaking changes
+
+Release flow:
+
+1. Add a changeset in the PR
+2. Merge the PR to `main`
+3. `release.yml` creates or updates the automated version PR
+4. Merge that generated PR
+5. The package is published to npm

package/.changeset/config.json

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

package/.editorconfig

@@ -0,0 +1,40 @@
+# EditorConfig helps maintain consistent coding styles across different editors
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+
+[*.{json,jsonc}]
+indent_size = 2
+
+[*.{css,scss}]
+indent_size = 2
+
+[*.{ts,tsx,js,jsx,mjs}]
+indent_size = 2
+
+[*.svg]
+insert_final_newline = false
+
+[{package.json,package-lock.json,bun.lockb}]
+indent_size = 2
+
+[.env*]
+insert_final_newline = true
+

package/.env.example

@@ -0,0 +1,81 @@
+# ============================================
+# Basement Next Starter - Environment Variables
+# ============================================
+# Copy this file to .env.local and fill in the values
+# Run: cp .env.example .env.local
+#
+# Only configure the integrations you need.
+# Remove unused sections to keep your env file clean.
+# ============================================
+
+
+# ============================================
+# CORE (Recommended)
+# ============================================
+
+# 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
+# Generate a random string: openssl rand -base64 32
+DRAFT_MODE_TOKEN=""
+
+
+# ============================================
+# SANITY CMS (Optional)
+# Headless CMS with visual editing
+# Get credentials: https://sanity.io/manage
+# Docs: https://www.sanity.io/docs
+# ============================================
+
+# Required for Sanity
+NEXT_PUBLIC_SANITY_PROJECT_ID=""
+NEXT_PUBLIC_SANITY_DATASET="production"
+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"
+
+
+# ============================================
+# SHOPIFY (Optional)
+# E-commerce platform with cart and checkout
+# Get credentials: https://shopify.dev/docs/storefronts/headless
+# ============================================
+
+# Required for Shopify
+# SHOPIFY_STORE_DOMAIN="your-store.myshopify.com"
+# SHOPIFY_STOREFRONT_ACCESS_TOKEN=""
+
+# Optional - for revalidation webhooks
+# SHOPIFY_REVALIDATION_SECRET=""
+
+# Optional - for customer accounts
+# SHOPIFY_CUSTOMER_ACCOUNT_API_CLIENT_ID=""
+# SHOPIFY_CUSTOMER_ACCOUNT_API_URL=""
+
+# ============================================
+# ANALYTICS (Optional)
+# ============================================
+
+# Google Analytics
+# NEXT_PUBLIC_GOOGLE_ANALYTICS=""
+
+# Google Tag Manager
+# NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID=""
+
+# Facebook
+# NEXT_PUBLIC_FACEBOOK_APP_ID=""
+
+
+# ============================================
+# VERCEL (Auto-populated by Vercel CLI)
+# ============================================
+
+# These are automatically set by Vercel
+# VERCEL_OIDC_TOKEN=""

package/.gitattributes

@@ -0,0 +1,19 @@
+# Git Attributes Configuration
+# This file ensures consistent line endings across all platforms
+#
+# Configuration:
+#   *           - Applies to all files in the repository
+#   text=auto   - Git automatically detects text vs binary files
+#   eol=lf      - Normalizes line endings to LF (Unix-style) for text files
+#
+# Why this matters:
+#   - Windows uses CRLF (\r\n) line endings
+#   - Unix/Linux/macOS use LF (\n) line endings
+#   - This prevents line-ending conflicts and ensures consistent diffs
+#
+# What it does:
+#   - On commit: Normalizes all text files to LF line endings
+#   - On checkout: Converts to platform-native format if needed
+#   - Prevents merge conflicts caused by line ending differences
+
+* text=auto eol=lf

package/.github/workflows/canary.yml

@@ -0,0 +1,80 @@
+name: Canary Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: canary-main
+  cancel-in-progress: true
+
+jobs:
+  canary:
+    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: Type check
+        run: bun run check
+
+      - name: Build
+        run: bun run build
+
+      - name: Configure npm for publishing
+        run: |
+          cat > ~/.npmrc <<'EOF'
+          registry=https://registry.npmjs.org/
+          access=public
+          EOF
+
+      - name: Check pending changesets
+        id: changesets
+        run: |
+          bunx changeset status --output=changeset-status.json
+          node <<'NODE'
+          const fs = require('node:fs');
+          const status = JSON.parse(fs.readFileSync('changeset-status.json', 'utf8'));
+          const releaseCount = Array.isArray(status.releases) ? status.releases.length : 0;
+          const hasReleases = releaseCount > 0;
+
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, `has_releases=${hasReleases}\n`);
+          console.log(`Found ${releaseCount} package(s) eligible for canary release.`);
+          NODE
+
+      - name: Version canary packages
+        if: steps.changesets.outputs.has_releases == 'true'
+        run: bun run version-canary
+
+      - name: Publish canary packages
+        if: steps.changesets.outputs.has_releases == 'true'
+        run: bun run release-canary
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Skip publish (no pending changesets)
+        if: steps.changesets.outputs.has_releases != 'true'
+        run: echo "No pending changesets. Skipping canary publish."

package/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+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

@@ -0,0 +1,56 @@
+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/.tldrignore

@@ -0,0 +1,84 @@
+# 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/extensions.json

@@ -0,0 +1,20 @@
+{
+  "recommendations": [
+    // Formatting & Linting
+    "biomejs.biome",
+
+    // CSS & Styling
+    "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"
+  ]
+}

package/.vscode/settings.json

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