spoko-design-system 0.9.6 → 1.0.0

package/.astro/content.d.ts

@@ -205,6 +205,6 @@ declare module 'astro:content' {
 		LiveContentConfig['collections'][C]['loader']
 	>;
 
-	export type ContentConfig = typeof import("./../src/content.config.mjs");
+	export type ContentConfig = typeof import("../src/content.config.mjs");
 	export type LiveContentConfig = never;
 }

package/.astro/settings.json

@@ -1,5 +1,5 @@
-{
-	"_variables": {
-		"lastUpdateCheck": 1757938917015
-	}
+{
+	"_variables": {
+		"lastUpdateCheck": 1757938917015
+	}
 }

package/.astro/types.d.ts

@@ -1 +1,2 @@
-/// <reference types="astro/client" />
+/// <reference types="astro/client" />
+/// <reference path="content.d.ts" />

package/.github/dependabot.yml

@@ -1,11 +1,11 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  - package-ecosystem: "" # See documentation for possible values
-    directory: "/" # Location of package manifests
-    schedule:
-      interval: "weekly"
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

package/.github/todo.yml

@@ -1,3 +1,3 @@
-              - name: todo-issue
-                uses: DerJuulsn/todo-issue@v1.1.4
-            
+              - name: todo-issue
+                uses: DerJuulsn/todo-issue@v1.1.4
+            

package/.github/workflows/deploy.yml

@@ -1,40 +1,40 @@
-name: Deploy to GitHub Pages
-
-on:
-  # Trigger the workflow every time you push to the `main` branch
-  # Using a different branch name? Replace `main` with your branch’s name
-  push:
-    branches: [ ma ]
-  # Allows you to run this workflow manually from the Actions tab on GitHub.
-  workflow_dispatch:
-
-# Allow this job to clone the repo and create a page deployment
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout your repository using git
-        uses: actions/checkout@v4
-      - name: Install, build, and upload your site
-        uses: withastro/action@v3
-        with:
-            pnpm@latest
-          # path: . # The root location of your Astro project inside the repository. (optional)
-          # node-version: 18 # The specific version of Node that should be used to build your site. Defaults to 18. (optional)
-          # package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
-
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
+name: Deploy to GitHub Pages
+
+on:
+  # Trigger the workflow every time you push to the `main` branch
+  # Using a different branch name? Replace `main` with your branch’s name
+  push:
+    branches: [ ma ]
+  # Allows you to run this workflow manually from the Actions tab on GitHub.
+  workflow_dispatch:
+
+# Allow this job to clone the repo and create a page deployment
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout your repository using git
+        uses: actions/checkout@v4
+      - name: Install, build, and upload your site
+        uses: withastro/action@v3
+        with:
+            pnpm@latest
+          # path: . # The root location of your Astro project inside the repository. (optional)
+          # node-version: 18 # The specific version of Node that should be used to build your site. Defaults to 18. (optional)
+          # package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
         uses: actions/deploy-pages@v4

package/.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+      - next
+      - beta
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.16.1
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build package
+        run: pnpm run build
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: pnpm exec semantic-release

package/.releaserc.json

@@ -0,0 +1,93 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "next",
+      "prerelease": true
+    },
+    {
+      "name": "beta",
+      "prerelease": true
+    }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    [
+      "@semantic-release/npm",
+      {
+        "npmPublish": true,
+        "tarballDir": "dist"
+      }
+    ],
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "package.json",
+          "CHANGELOG.md"
+        ],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ],
+  "preset": "conventionalcommits",
+  "parserOpts": {
+    "noteKeywords": [
+      "BREAKING CHANGE",
+      "BREAKING CHANGES"
+    ]
+  },
+  "writerOpts": {
+    "commitsSort": [
+      "subject",
+      "scope"
+    ]
+  },
+  "analyzeCommits": {
+    "releaseRules": [
+      {
+        "type": "feat",
+        "release": "minor"
+      },
+      {
+        "type": "fix",
+        "release": "patch"
+      },
+      {
+        "type": "perf",
+        "release": "patch"
+      },
+      {
+        "type": "refactor",
+        "release": "patch"
+      },
+      {
+        "type": "style",
+        "release": "patch"
+      },
+      {
+        "type": "docs",
+        "release": "patch"
+      },
+      {
+        "type": "test",
+        "release": false
+      },
+      {
+        "type": "ci",
+        "release": false
+      },
+      {
+        "type": "chore",
+        "release": false
+      },
+      {
+        "scope": "BREAKING CHANGE",
+        "release": "major"
+      }
+    ]
+  }
+}

package/.stackblitzrc

@@ -1,6 +1,6 @@
-{
-  "startCommand": "npm start",
-  "env": {
-    "ENABLE_CJS_IMPORTS": true
-  }
+{
+  "startCommand": "npm start",
+  "env": {
+    "ENABLE_CJS_IMPORTS": true
+  }
 }

package/.vscode/extensions.json

@@ -1,5 +1,5 @@
-{
-  "recommendations": ["astro-build.astro-vscode"],
-  "unwantedRecommendations": [],
-  "lokalise.i18n-ally"
-}
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": [],
+  "lokalise.i18n-ally"
+}

package/.vscode/launch.json

@@ -1,11 +1,11 @@
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "command": "./node_modules/.bin/astro dev",
-      "name": "Development server",
-      "request": "launch",
-      "type": "node-terminal"
-    }
-  ]
-}
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

package/.vscode/settings.json

@@ -1,6 +1,6 @@
-{
-    "i18n-ally.sourceLanguage": "en",
-    "i18n-ally.keystyle": "nested",
-    "i18n-ally.localesPaths": "public/locales",
-    "i18n-ally.sortKeys": true,
+{
+    "i18n-ally.sourceLanguage": "en",
+    "i18n-ally.keystyle": "nested",
+    "i18n-ally.localesPaths": "public/locales",
+    "i18n-ally.sortKeys": true,
 }

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+## 1.0.0 (2025-09-23)
+
+### Features
+
+* add automated semantic-release with HandDrive component improvements ([dd5f138](https://github.com/polo-blue/sds/commit/dd5f138636d90b3d0932c67c51afd39e42fab35a))
+
+### Bug Fixes
+
+* add missing conventional-changelog-conventionalcommits dependency ([ad4f47b](https://github.com/polo-blue/sds/commit/ad4f47b47f5de6f684bdbea84a839f5d5642cb62))
+* add updated pnpm-lock.yaml for semantic-release dependencies ([9ac21c9](https://github.com/polo-blue/sds/commit/9ac21c9150f8cfc997767d7c302a999d92b2fb01))
+* correct semantic-release version and update lockfile ([dbee5ef](https://github.com/polo-blue/sds/commit/dbee5efbadcfc4dde616ca163ff496ecffd3f15a))
+* update pnpm version in GitHub Actions to match package.json ([2b25473](https://github.com/polo-blue/sds/commit/2b25473148265e85660209ba457a0aea0c190dcd))

package/CONTRIBUTING.md

@@ -0,0 +1,183 @@
+# Contributing to Spoko Design System
+
+## 🚀 Automated Release Process
+
+This project uses **semantic-release** for fully automated version management and package publishing.
+
+### How It Works
+
+1. **Conventional Commits** - All commits must follow the conventional commit format
+2. **Automated Versioning** - Version bumps are determined automatically from commit messages
+3. **Automated Publishing** - Packages are published to npm automatically on main branch
+4. **Changelog Generation** - CHANGELOG.md is automatically updated with each release
+
+### Commit Message Format
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) specification:
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+#### Commit Types
+
+| Type | Description | Version Bump |
+|------|-------------|--------------|
+| `feat` | New feature | **MINOR** (0.1.0) |
+| `fix` | Bug fix | **PATCH** (0.0.1) |
+| `perf` | Performance improvement | **PATCH** (0.0.1) |
+| `refactor` | Code refactoring | **PATCH** (0.0.1) |
+| `style` | Code style changes | **PATCH** (0.0.1) |
+| `docs` | Documentation changes | **PATCH** (0.0.1) |
+| `test` | Test changes | **No release** |
+| `ci` | CI/CD changes | **No release** |
+| `chore` | Maintenance tasks | **No release** |
+
+#### Breaking Changes
+
+For **MAJOR** version bumps, include `BREAKING CHANGE:` in the commit footer:
+
+```
+feat!: remove deprecated HandDrive numeric API
+
+BREAKING CHANGE: HandDrive component now only accepts 'lhd' | 'rhd' strings instead of numbers
+```
+
+### Examples
+
+#### ✅ Good Commit Messages
+
+```bash
+# New component (minor release)
+feat(components): add Button component with variants
+
+# Bug fix (patch release)
+fix(HandDrive): handle null values correctly
+
+# Breaking change (major release)
+feat!: update HandDrive API to use strings
+
+BREAKING CHANGE: handDrive prop now accepts 'lhd' | 'rhd' instead of 1 | 2
+
+# Documentation update (patch release)
+docs: update HandDrive component examples
+
+# No release
+test: add HandDrive component tests
+chore: update dependencies
+```
+
+#### ❌ Bad Commit Messages
+
+```bash
+# Too vague
+fix: bug fix
+
+# No conventional format
+Updated the HandDrive component
+
+# Missing type
+add new button component
+```
+
+### Release Branches
+
+| Branch | Purpose | Release Type |
+|--------|---------|--------------|
+| `main` | Production releases | **Stable** |
+| `next` | Next major version | **Pre-release** |
+| `beta` | Beta features | **Pre-release** |
+
+### Workflow
+
+1. **Create Feature Branch**
+   ```bash
+   git checkout -b feat/new-component
+   ```
+
+2. **Make Changes & Commit**
+   ```bash
+   git add .
+   git commit -m "feat(components): add NewComponent with TypeScript support"
+   ```
+
+3. **Push & Create PR**
+   ```bash
+   git push origin feat/new-component
+   # Create PR to main branch
+   ```
+
+4. **Merge to Main**
+   - Once PR is approved and merged to `main`
+   - GitHub Actions will automatically:
+     - Analyze commit messages
+     - Determine version bump
+     - Update package.json
+     - Generate CHANGELOG.md
+     - Create GitHub release
+     - Publish to npm
+
+### Manual Release (if needed)
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run semantic-release locally
+pnpm run semantic-release
+```
+
+### Setup Requirements
+
+#### GitHub Repository Secrets
+
+Add these secrets to your GitHub repository settings:
+
+1. **NPM_TOKEN** - npm authentication token
+   ```bash
+   # Create npm token
+   npm login
+   npm token create --access=public
+   ```
+
+2. **GITHUB_TOKEN** - Automatically provided by GitHub Actions
+
+#### npm Authentication
+
+Make sure your npm account has publish access to the `spoko-design-system` package.
+
+### Version History
+
+All releases are automatically documented in:
+- [CHANGELOG.md](./CHANGELOG.md) - Detailed changelog
+- [GitHub Releases](https://github.com/polo-blue/sds/releases) - Release notes
+- [npm Versions](https://www.npmjs.com/package/spoko-design-system?activeTab=versions) - Published versions
+
+### Troubleshooting
+
+#### Release Didn't Trigger
+- Check commit message follows conventional format
+- Ensure commit was pushed to `main` branch
+- Check GitHub Actions logs
+
+#### Release Failed
+- Check NPM_TOKEN is valid and has publish permissions
+- Verify package.json version is correct
+- Check for breaking changes in dependencies
+
+#### Skip Release
+Add `[skip ci]` to commit message to skip release:
+```bash
+git commit -m "docs: update README [skip ci]"
+```
+
+## 📦 Package Information
+
+- **Current Version**: ![npm version](https://img.shields.io/npm/v/spoko-design-system)
+- **Downloads**: ![npm downloads](https://img.shields.io/npm/dm/spoko-design-system)
+- **License**: MIT
+- **Repository**: https://github.com/polo-blue/sds

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Jordi Enric Roig Ramis
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Jordi Enric Roig Ramis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.