Initial Commit

.eslintrc.js

@@ -0,0 +1,17 @@
+module.exports = {
+    parser: "@typescript-eslint/parser",
+    parserOptions: {
+        ecmaVersion: 2020, // Allows for the parsing of modern ECMAScript features
+        sourceType: "module" // Allows for the use of imports
+    },
+    extends: [
+        "plugin:@typescript-eslint/recommended"
+    ],
+    rules: {
+      // Place to specify ESLint rules. Can be used to overwrite rules specified from the extended configs
+      // e.g. "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-unused-vars": "warn",
+      //"@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-explicit-any": "error",
+    }
+};

.gitattributes

@@ -0,0 +1,32 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# correct GitHub "Languages" detection behavior.
+# without this, GitHub reports the repository as an HTML application.
+.github/** linguist-documentation
+.vscode/** linguist-documentation
+config/** linguist-documentation
+scripts/** linguist-documentation
+*.bat linguist-detectable=false
+*.yaml linguist-detectable=false
+*.txt linguist-detectable=false
+
+# handle files with specified extensions as described.
+*.doc    diff=astextplain
+*.DOC    diff=astextplain
+*.docx   diff=astextplain
+*.DOCX   diff=astextplain
+*.dot    diff=astextplain
+*.DOT    diff=astextplain
+*.pdf    diff=astextplain
+*.PDF    diff=astextplain
+*.rtf    diff=astextplain
+*.RTF    diff=astextplain
+*.jpg    binary
+*.png    binary
+*.gif    binary
+*.csproj text=auto merge=union 
+*.vbproj text=auto merge=union 
+*.fsproj text=auto merge=union 
+*.dbproj text=auto merge=union 
+*.sln    -text merge=union

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [thlucas1]
+custom: ['https://www.buymeacoffee.com/thlucas1']

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,57 @@
+---
+name: "Bug report"
+description: "Report a bug with the card"
+labels: ["bug"]
+body:
+- type: markdown
+  attributes:
+    value: Before you open a new issue, search through the existing issues to see if others have had the same problem; also make sure you are running the latest version of Home Assistant.
+- type: textarea
+  attributes:
+    label: "System Health details"
+    description: "Paste the data from the System Health card in Home Assistant (https://www.home-assistant.io/more-info/system-health#github-issues)"
+  validations:
+    required: true
+- type: checkboxes
+  attributes:
+    label: Checklist
+    options:
+      - label: I am running the latest version of Home Assistant for my installation.
+        required: true
+      - label: I am running the latest version of the card.
+        required: true
+      - label: I have filled out the issue template to the best of my ability.
+        required: true
+      - label: This issue only contains 1 issue (if you have multiple issues, open one issue for each issue).
+        required: true
+      - label: This issue is not a duplicate issue of any [previous issues](https://github.com/thlucas1/spotifyplus_card/issues?q=is%3Aissue+label%3A%22Bug%22+).
+        required: true
+- type: textarea
+  attributes:
+    label: "Describe the issue"
+    description: "A clear and concise description of what the issue is."
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Reproduction Steps
+    description: "Without steps to reproduce, it will be hard to fix. It is very important that you fill out this part. Issues without it will be closed."
+    value: |
+      1.
+      2.
+      3.
+      ...
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: "Debug / Console Logs"
+    description: "To enable debug logs check this https://www.home-assistant.io/integrations/logger/, this **needs** to include _everything_ from startup of Home Assistant to the point where you encounter the issue.  You can also include browser console / developer tool logs here as well."
+    render: text
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Diagnostics Dump (optional)"
+    description: "Drag the diagnostics dump file here. (see https://www.home-assistant.io/integrations/diagnostics/ for info)"

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,47 @@
+---
+name: "Feature request"
+description: "Suggest an idea for this project"
+labels: ["Feature+Request"]
+body:
+- type: markdown
+  attributes:
+    value: Before you open a new feature request, search through the existing feature requests to see if others have had the same idea.
+- type: checkboxes
+  attributes:
+    label: Checklist
+    options:
+      - label: I have filled out the template to the best of my ability.
+        required: true
+      - label: This only contains 1 feature request (if you have multiple feature requests, open one feature request for each feature request).
+        required: true
+      - label: This issue is not a duplicate feature request of [previous feature requests](https://github.com/thlucas1/spotifyplus_card/issues?q=is%3Aissue+label%3A%22Feature+Request%22+).
+        required: true
+
+- type: textarea
+  attributes:
+    label: "Is your feature request related to a problem? Please describe."
+    description: "A clear and concise description of what the problem is."
+    placeholder: "I'm always frustrated when [...]"
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Describe the solution you'd like"
+    description: "A clear and concise description of what you want to happen."
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Describe alternatives you've considered"
+    description: "A clear and concise description of any alternative solutions or features you've considered."
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Additional context"
+    description: "Add any other context or screenshots about the feature request here."
+  validations:
+    required: true

.github/dependabot.yml

@@ -0,0 +1,15 @@
+# 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/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "monthly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"

.github/workflows/build.yml

@@ -0,0 +1,22 @@
+name: 'Build'
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build:
+    name: "Build Plugin"
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Repository checkout"
+        uses: "actions/checkout@v4"
+
+      - name: "NPM Build"
+        run: |
+          npm install
+          npm run buildgithub

.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: "Release"
+
+on:
+  release:
+    types:
+      - "published"
+
+permissions: {}
+
+jobs:
+  release:
+    name: "Prepare Release"
+    runs-on: "ubuntu-latest"
+    permissions:
+      contents: write
+    steps:
+      - name: "Repository checkout"
+        uses: "actions/checkout@v4"
+
+      - name: "NPM Build Plugin"
+        run: |
+          cd "${{ github.workspace }}"
+          npm install
+          npm run buildgithub
+
+      - name: "Upload Files to Release"
+        uses: softprops/[email protected]
+        with:
+          files: "${{ github.workspace }}/dist/spotifyplus-card.js"
+
+      # plugin file(s) will be placed in the following Home Assistant configuration directory 
+      # location once it is installed via HACS:
+      # "/config/www/community/ha_spotifyplus_card/spotifyplus-card.js"

.github/workflows/validate.yml

@@ -0,0 +1,25 @@
+name: "Validate"
+
+on:
+  push:
+    branches:
+      - "main"
+  pull_request:
+    branches:
+      - "main"
+  schedule:
+    - cron: "25 23 * * *"
+  workflow_dispatch:
+
+jobs:
+  validate-hacs: # https://github.com/hacs/action
+    name: "HACS Validation"
+    runs-on: "ubuntu-latest"
+    steps:
+        - name: "Checkout the repository"
+          uses: "actions/checkout@main"
+
+        - name: "Run HACS validation"
+          uses: "hacs/action@main"
+          with:
+            category: "plugin"

.gitignore

@@ -0,0 +1,21 @@
+# artifacts
+/build/
+/dist/
+.DS_Store
+
+# Visual Studio 2022 configuration.
+/.vs/
+/obj/
+/bin/
+
+# NPM
+/node_modules/
+
+# GIT support files to ignore.
+/Git*.cmd
+
+# Local project files and folders to ignore.
+/dist/Build.bat
+/developer_notes.txt
+/New_Release_Instructions.txt
+/data/

.prettierrc.js

@@ -0,0 +1,7 @@
+module.exports = {
+    semi: true,
+    trailingComma: 'all',
+    singleQuote: true,
+    printWidth: 120,
+    tabWidth: 2,
+};

.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+
+
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Launch Program",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${file}"
+        }
+    ]
+}

CHANGELOG.md

@@ -0,0 +1,13 @@
+## Change Log
+
+All notable changes to this project are listed here.  
+
+Change are listed in reverse chronological order (newest to oldest).  
+
+<span class="changelog">
+
+###### [ 1.0.0 ] - 2024/08/25
+
+  * Version 1 initial release.
+
+</span>

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 - 2024  Todd Lucas @thlucas1
+
+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.