purifier-card 2.6.9 → 2.7.0

package/.github/FUNDING.yml

@@ -1,2 +1,2 @@
 github: denysdovhan
-custom: [buymeacoffee.com/denysdovhan]
+buy_me_a_coffee: denysdovhan

package/.github/release-drafter.yml

@@ -0,0 +1,58 @@
+name-template: v$RESOLVED_VERSION 🧹
+tag-template: v$RESOLVED_VERSION
+exclude-contributors:
+  - github-actions[bot]
+  - github-actions
+  - dependabot[bot]
+  - dependabot
+categories:
+  - title: ❗️ Breaking Changes
+    labels:
+      - breaking
+  - title: 🚀 Features
+    labels:
+      - feature
+      - enhancement
+  - title: 🐛 Bug Fixes
+    labels:
+      - fix
+      - bug
+  - title: 🧰 Maintenance
+    labels:
+      - chore
+      - dependencies
+      - documentation
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+version-resolver:
+  major:
+    labels:
+      - major
+      - breaking
+  minor:
+    labels:
+      - minor
+      - feature
+      - enhancement
+  patch:
+    labels:
+      - patch
+      - dependencies
+  default: patch
+template: |
+  ## What's Changed
+
+  $CHANGES
+
+  ## ⭐️ Contributors
+
+  $CONTRIBUTORS
+
+  ## Sponsorship
+
+  If you like this project, please consider supporting me:
+
+  - 💖 [Sponsor on GitHub](https://github.com/sponsors/denysdovhan)
+  - ☕️ [Buy Me A Coffee](https://buymeacoffee.com/denysdovhan)
+  - Bitcoin: `bc1q7lfx6de8jrqt8mcds974l6nrsguhd6u30c6sg8`
+  - Ethereum: `0x6aF39C917359897ae6969Ad682C14110afe1a0a1`

package/.github/workflows/deps.yml

@@ -0,0 +1,26 @@
+name: Dependencies
+on:
+  pull_request:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  dependabot-auto-merge:
+    name: Dependabot Auto-merge
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.login == 'dependabot[bot]'
+    steps:
+      - name: 💿 Fetch Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: ↔️ Merge Dependabot PRs
+        if: steps.metadata.outputs.update-type == 'version-update:semver-minor' || steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/main.yml

@@ -4,7 +4,6 @@ on:
   pull_request:
 
 permissions:
-  id-token: write # Required for OIDC
   contents: write
   pull-requests: write
 
@@ -23,7 +22,7 @@ jobs:
       - name: ⬢ Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '*'
+          node-version: latest
           cache: npm
 
       - name: 📦 Install Packages
@@ -31,48 +30,3 @@ jobs:
 
       - name: 🧪 Test
         run: npm test
-
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    needs: [validate]
-    if: github.ref_name == 'main' && (github.event_name == 'push' || github.event.pull_request.merged)
-    steps:
-      - name: ⬇️ Checkout Repo
-        uses: actions/checkout@v6
-
-      - name: ⬢ Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: '*'
-          cache: npm
-
-      - name: 📦 Install Packages
-        run: npm ci
-
-      - name: 🏗 Build
-        run: npm run build
-
-      - name: 🚀 Release
-        run: npx semantic-release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  dependabot:
-    name: Dependabot Auto-merge
-    runs-on: ubuntu-latest
-    needs: [validate]
-    if: github.actor == 'dependabot[bot]' && github.event_name == 'pull_request'
-    steps:
-      - name: 💿 Dependabot metadata
-        id: metadata
-        uses: dependabot/fetch-metadata@v2
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: ↔️ Enable Auto-merge for minor and patch Dependabot PRs
-        run: gh pr merge --auto --squash "$PR_URL"
-        if: steps.metadata.outputs.update-type == 'version-update:semver-minor' || steps.metadata.outputs.update-type == 'version-update:semver-patch'
-        env:
-          PR_URL: ${{ github.event.pull_request.html_url }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/release-drafter.yml

@@ -0,0 +1,20 @@
+name: Release Drafter
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update_release_draft:
+    name: Update Release Draft
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📝 Update draft
+        uses: release-drafter/release-drafter@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: ⬇️ Checkout Repo
+        uses: actions/checkout@v6
+
+      - name: ⬢ Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          registry-url: https://registry.npmjs.org
+          node-version: latest
+          cache: npm
+
+      - name: 📦 Install Packages
+        run: npm ci
+
+      - name: 🧮 Set version from tag
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          npm version --no-git-tag-version "${TAG#v}"
+
+      - name: 🏗 Build
+        run: npm run build
+
+      - name: 🚀 Publish to npm
+        run: npm publish --provenance --access public
+
+      - name: 📦 Upload release asset
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/vacuum-card.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.husky/pre-commit

@@ -1,4 +1 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
 npx lint-staged

package/AGENTS.md

@@ -0,0 +1,65 @@
+# Repository Guidelines
+
+## Instructions
+
+- Always refer to `home-assistant-js-websocket` library for types and functions to interact with the Home Assistant API.
+- When interaction with Home Assistant API is needed, use `custom-card-helpers` library for helper utilities for the card lifecycle and events.
+
+## Project Structure & Module Organization
+
+- `src/`: TypeScript source for the custom Lovelace card (entry: `src/purifier-card.ts`).
+- `dist/`: Build output (bundled card JS). This is generated by Rollup.
+- `rollup.config.mjs`: Build pipeline and asset handling.
+- `eslint.config.mjs`: Lint configuration.
+- `package.json`: Scripts, dependencies, and release config.
+
+## Build, Test, and Development Commands
+
+- `npm install`: Install dependencies.
+- `npm run start`: Watch mode build (Rollup) for local development.
+- `npm run build`: Production bundle to `dist/`.
+- `npm run lint`: Run ESLint on `src/`.
+- `npm run lint:fix`: Auto-fix lint issues in `src/`.
+- `npm run format`: Format with Prettier (respects `.prettier` settings in `package.json`).
+- `npm test`: Runs `lint` then `build` (no separate test suite).
+
+## Coding Style & Naming Conventions
+
+- Language: TypeScript, ES modules (`"type": "module"`).
+- Formatting: Prettier with single quotes (`"singleQuote": true`).
+- Linting: ESLint (see `eslint.config.mjs`) using `@typescript-eslint` and `eslint-plugin-import`.
+- Match existing patterns in `src/` for file naming and exports; prefer descriptive, kebab-case filenames for components.
+
+## Technologies Used
+
+- UI is a Home Assistant Lovelace custom card implemented as a Web Component with Lit (`LitElement`, decorators, `html` templates).
+- Home Assistant integrations use `custom-card-helpers` for card lifecycle/events and `home-assistant-js-websocket` types for entities/services.
+- Template rendering uses `ha-template` for dynamic text in the card.
+- Localization is handled via JSON translation files in `src/translations/` and the `localize` helper.
+- Build tooling is Rollup with TypeScript (`rollup-plugin-typescript2`), Babel transforms, and asset handling for JSON, images, CSS, and SVG.
+- Styling uses PostCSS (`postcss-preset-env`) and `rollup-plugin-postcss-lit` to process component CSS.
+- Production optimizations include HTML literal minification and Terser.
+- Utility helpers include Lodash (`get`).
+- Developer tooling includes ESLint, Prettier, Husky, and lint-staged.
+
+## Documentations
+
+- This card uses the [custom-card-helpers](https://custom-cards.github.io/custom-card-helpers/modules.html) library with helper utilities for the card lifecycle and events. Always refer to the documentation for useful functions and utilities.
+- Use the [home-assistant-js-websocket](https://www.npmjs.com/package/home-assistant-js-websocket) library for types and functions to interact with the Home Assistant API.
+
+## Testing Guidelines
+
+- No dedicated test framework is configured.
+- Use `npm test` to validate linting and the production build.
+- Keep changes buildable; avoid introducing new build-time warnings.
+
+## Commit & Pull Request Guidelines
+
+- Commit messages follow Conventional Commits (Angular preset), e.g. `feat: ...`, `fix: ...`, `chore(deps): ...`.
+- Dependency updates should use `chore(deps): ...` to align with release rules.
+- PRs should include: a concise description, what changed, and how it was validated (commands run). If UI changes are visible, include a screenshot or GIF.
+
+## Release & Automation Notes
+
+- Releases are handled by semantic-release on `main` with assets from `dist/purifier-card.js`.
+- Ensure build output remains stable when changing dependencies or build config.