feat: initial library setup with docusaurus and changesets

Author: codeBelt

.changeset/config.json

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

.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc

@@ -0,0 +1 @@
+../../CLAUDE.md

.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - run: bun run lint
+      - run: bun run test
+      - run: bun run typecheck
+      - run: bun run build

.github/workflows/docs.yml

@@ -0,0 +1,33 @@
+name: Deploy Docs
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'website/**'
+      - 'README.md'
+
+permissions:
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: cd website && bun install --frozen-lockfile
+      - run: cd website && bun run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/build
+
+  deploy:
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/deploy-pages@v4
+        id: deployment

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+on:
+  push:
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write # Required for OIDC
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install --frozen-lockfile
+      - run: bun run build
+      - uses: changesets/action@v1
+        with:
+          version: bun run changeset:version
+          publish: bun run changeset:publish
+          commit: "chore: release"
+          title: "chore: release"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,39 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+# Docusaurus
+website/build
+website/.docusaurus
+website/.cache-loader

CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing to @codebelt/classy-store
+
+## Development Setup
+
+1. Install [Bun](https://bun.sh).
+2. Clone the repository.
+3. Run `bun install`.
+
+## Workflow
+
+- **Dev**: `bun run dev` (watch mode)
+- **Test**: `bun run test`
+- **Lint**: `bun run lint`
+- **Docs**: `bun run docs:dev`
+
+## Releasing
+
+We use [Changesets](https://github.com/changesets/changesets) to manage versioning and changelogs.
+
+### 1. Create a Changeset
+
+When you make changes that should be released, run:
+
+```bash
+bun run changeset:add
+```
+
+Follow the prompts to select the package and bump type (patch, minor, major). This creates a file in `.changeset/`. Commit this file with your PR.
+
+### 2. Automated Release
+
+When your PR is merged to `main`:
+1. The **Release** GitHub Action will create a "Version Packages" PR.
+2. When you merge that PR, the action will automatically publish the new version to npm and update the CHANGELOG.
+
+### 3. Pre-releases
+
+To enter pre-release mode (e.g., beta):
+
+```bash
+bun run prerelease:enter beta
+bun run changeset:version
+bun run changeset:publish
+```
+
+To exit:
+```bash
+bun run prerelease:exit
+```

README.md

@@ -0,0 +1,48 @@
+# @codebelt/classy-store
+
+**Class-based reactive state management for React.**
+
+[![npm version](https://img.shields.io/npm/v/@codebelt/classy-store.svg)](https://www.npmjs.com/package/@codebelt/classy-store)
+[![CI](https://github.com/codebelt/classy-store/actions/workflows/ci.yml/badge.svg)](https://github.com/codebelt/classy-store/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@codebelt/classy-store.svg)](https://github.com/codebelt/classy-store/blob/main/LICENSE)
+
+## 📚 Documentation
+
+Visit the **[Documentation Website](https://codebelt.github.io/classy-store/)** for tutorials, API reference, and examples.
+
+## 🚀 Features
+
+- **Class-Based**: Define state and logic using standard ES6 classes.
+- **Reactive**: Automatic reactivity using Proxies.
+- **React Integration**: Seamless integration with React 18+ hooks.
+- **TypeScript**: Written in TypeScript with first-class type support.
+
+## 📦 Installation
+
+```bash
+npm install @codebelt/classy-store
+# or
+bun add @codebelt/classy-store
+```
+
+## 🛠️ Development
+
+This project uses [Bun](https://bun.sh) for development.
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+bun run test
+
+# Run build
+bun run build
+
+# Start docs website locally
+bun run docs:dev
+```
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on how to contribute and the release workflow.

biome.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.15/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": [
+      "**",
+      "!node_modules",
+      "!.next",
+      "!dist",
+      "!build",
+      "!**/_generated",
+      "!coverage"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "bracketSpacing": false
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noImplicitBoolean": "error",
+        "noInferrableTypes": "error",
+        "noParameterAssign": "error",
+        "noUnusedTemplateLiteral": "error",
+        "noUselessElse": "error",
+        "useAsConstAssertion": "error",
+        "useConsistentCurlyBraces": {
+          "level": "error",
+          "fix": "safe",
+          "options": {}
+        },
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
+        "useNumberNamespace": "error",
+        "useSelfClosingElements": "error",
+        "useSingleVarDeclarator": "error"
+      },
+      "correctness": {
+        "noUnusedImports": {
+          "level": "error",
+          "fix": "safe",
+          "options": {}
+        },
+        "noChildrenProp": {
+          "level": "off"
+        }
+      },
+      "suspicious": {
+        "noUnknownAtRules": "off"
+      }
+    },
+    "domains": {
+      "next": "recommended",
+      "react": "recommended"
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single"
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/styles.css"],
+      "linter": {
+        "rules": {
+          "complexity": {
+            "noImportantStyles": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["**/CodeBlock.tsx"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noArrayIndexKey": "off"
+          }
+        }
+      }
+    }
+  ],
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}