@phcdevworks/spectre-shell-wordpress 1.1.0

package/.devcontainer/devcontainer.json

@@ -0,0 +1,40 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/typescript-node
+{
+  "name": "Node.js & TypeScript",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:1-22-bookworm",
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "22"
+    }
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  "forwardPorts": [
+    5173,
+    4173,
+    3000
+  ],
+  // Port attributes for development servers
+  "portsAttributes": {
+    "5173": {
+      "label": "Vite Dev Server",
+      "onAutoForward": "notify"
+    },
+    "4173": {
+      "label": "Vite Preview Server",
+      "onAutoForward": "notify"
+    },
+    "3000": {
+      "label": "Application Server",
+      "onAutoForward": "notify"
+    }
+  },
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": "node --version && npm --version"
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+}

package/.gitattributes

@@ -0,0 +1,203 @@
+###############################################################################
+# Core: normalize line endings + UTF-8
+###############################################################################
+# Normalize to LF in repo; editors can show CRLF on Windows if configured
+*           text=auto eol=lf
+
+# Explicit LF for common scripts
+*.sh        text eol=lf
+*.bash      text eol=lf
+*.zsh       text eol=lf
+*.py        text eol=lf
+*.rb        text eol=lf
+*.pl        text eol=lf
+*.php       text eol=lf
+*.rs        text eol=lf
+*.go        text eol=lf
+*.java      text eol=lf
+*.kt        text eol=lf
+*.scala     text eol=lf
+*.ts        text eol=lf
+*.tsx       text eol=lf
+*.js        text eol=lf
+*.jsx       text eol=lf
+*.css       text eol=lf
+*.scss      text eol=lf
+*.less      text eol=lf
+*.md        text eol=lf
+*.yml       text eol=lf
+*.yaml      text eol=lf
+*.toml      text eol=lf
+*.json      text eol=lf
+*.sql       text eol=lf
+.env*       text eol=lf
+Dockerfile  text eol=lf
+devcontainer.json text eol=lf
+vite.config.* text eol=lf
+vitest.config.* text eol=lf
+*.gradle    text eol=lf
+
+# Windows-only scripts that expect CRLF
+*.bat       text eol=crlf
+*.cmd       text eol=crlf
+
+###############################################################################
+# Binary safety: never auto-convert line endings; avoid broken diffs
+###############################################################################
+# Images
+*.png       binary
+*.jpg       binary
+*.jpeg      binary
+*.gif       binary
+*.webp      binary
+*.tiff      binary
+*.ico       binary
+*.psd       binary
+
+# Fonts
+*.woff      binary
+*.woff2     binary
+*.ttf       binary
+*.otf       binary
+*.eot       binary
+
+# Audio / Video
+*.mp3       binary
+*.wav       binary
+*.flac      binary
+*.mp4       binary
+*.mov       binary
+*.avi       binary
+*.mkv       binary
+*.webm      binary
+
+# Archives & packages
+*.zip       binary
+*.gz        binary
+*.bz2       binary
+*.7z        binary
+*.rar       binary
+*.tar       binary
+*.tgz       binary
+*.jar       binary
+*.war       binary
+*.nupkg     binary
+*.dmg       binary
+*.iso       binary
+
+# Data / design / CAD
+*.pdf       binary
+*.ai        binary
+*.eps       binary
+*.sketch    binary
+*.fig       binary
+*.blend     binary
+*.step      binary
+*.stp       binary
+*.stl       binary
+*.glb       binary
+*.gltf      binary
+
+###############################################################################
+# Diff quality: use built-in or custom drivers (configure in .gitconfig)
+###############################################################################
+# JSON: show word-level diffs ignoring whitespace & ordering (driver required)
+*.json      text diff=json
+# Markdown: better prose diffs (driver required)
+*.md        text diff=markdown
+# Lockfiles: huge JSON—treat as text but favor minimal/word diffs
+package-lock.json text diff=lockfile
+pnpm-lock.yaml    text
+yarn.lock         text
+composer.lock     text
+Pipfile.lock      text
+Cargo.lock        text
+Gemfile.lock      text
+poetry.lock       text
+go.sum            text
+
+# Source code tweaks (drivers optional—harmless if not configured)
+*.py        text diff=python
+*.rb        text diff=ruby
+*.js        text diff=javascript
+*.ts        text diff=javascript
+*.tsx       text diff=javascript
+*.java      text diff=java
+*.kt        text diff=kotlin
+*.go        text diff=golang
+*.rs        text diff=rust
+*.css       text diff=css
+*.scss      text diff=css
+
+###############################################################################
+# Merge strategies: reduce churn on “list” files; avoid conflicts on versioned files
+###############################################################################
+# Union-merge additive files (order may vary)
+.gitignore  merge=union
+.gitattributes merge=union
+docker-compose*.yml merge=union
+
+# Keep lockfiles simple (requires `git config merge.theirs.driver true` alias)
+# Uncomment if you prefer “take theirs” on lockfile conflicts:
+# package-lock.json merge=theirs
+# yarn.lock         merge=theirs
+# pnpm-lock.yaml    merge=theirs
+# Cargo.lock        merge=theirs
+# go.sum            merge=theirs
+
+###############################################################################
+# Git LFS (optional): uncomment if you use LFS; keep large binaries out of Git
+###############################################################################
+# Filter typical large assets via LFS (requires git-lfs installed)
+# *.psd      filter=lfs diff=lfs merge=lfs -text
+# *.ai       filter=lfs diff=lfs merge=lfs -text
+# *.pdf      filter=lfs diff=lfs merge=lfs -text
+# *.mp4      filter=lfs diff=lfs merge=lfs -text
+# *.zip      filter=lfs diff=lfs merge=lfs -text
+# *.glb      filter=lfs diff=lfs merge=lfs -text
+# Design files lockable to avoid parallel edits
+# *.psd      lockable
+# *.ai       lockable
+# *.fig      lockable
+# *.sketch   lockable
+
+###############################################################################
+# Exports: keep release/source archives lean (git archive / GitHub “Download ZIP”)
+###############################################################################
+# Ignore dev-only files on export
+.gitattributes export-ignore
+.gitignore    export-ignore
+.gitmodules   export-ignore
+.github/      export-ignore
+.githooks/    export-ignore
+.gitlab/      export-ignore
+.vscode/      export-ignore
+.idea/        export-ignore
+.editorconfig export-ignore
+*.code-workspace export-ignore
+# Tests, examples, docs (toggle to taste)
+# /tests/     export-ignore
+# /examples/  export-ignore
+# /docs/      export-ignore
+# Tooling
+/.devcontainer/ export-ignore
+/.docker/       export-ignore
+/scripts/       export-ignore
+node_modules/   export-ignore
+*.log           export-ignore
+
+###############################################################################
+# GitHub Linguist tuning (visual stats only—does not affect Git operations)
+###############################################################################
+# Treat vendored/generated files as such
+vendor/**                  linguist-vendored
+third_party/**             linguist-vendored
+**/dist/**                 linguist-generated
+**/build/**                linguist-generated
+**/*.min.js                linguist-generated
+**/*.min.css               linguist-generated
+# Set language for odd extensions (examples)
+*.hcl                      linguist-language=HCL
+*.tf                       linguist-language=HCL
+*.hbs                      linguist-language=Handlebars
+*.tpl                      linguist-language=Go

package/.github/FUNDING.yml

@@ -0,0 +1,6 @@
+## ❤️ Support Spectre
+
+If Spectre UI helps your workflow, consider sponsoring:
+
+- GitHub Sponsors: https://github.com/sponsors/phcdevworks
+  - Buy Me a Coffee: https://buymeacoffee.com/phcdevworks

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Create a report to help us improve
+labels: bug
+---
+
+## Description
+
+## Steps to Reproduce
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Screenshots or Logs
+
+## Environment
+
+- Version:
+- Node/NPM:
+- OS:
+
+## Additional Context

package/.github/ISSUE_TEMPLATE/docs_request.md

@@ -0,0 +1,11 @@
+---
+name: Docs request
+about: Request new or improved documentation
+labels: documentation
+---
+
+## What needs documentation
+
+## Where should it live
+
+## Additional Context

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+labels: enhancement
+---
+
+## Problem
+
+## Proposal
+
+## Alternatives Considered
+
+## Additional Context

package/.github/dependabot.yml

@@ -0,0 +1,12 @@
+# 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 more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly

package/.github/pull_request_template.md

@@ -0,0 +1,15 @@
+## Summary
+
+- [ ] Linked issue (or `N/A`)
+- [ ] Summary of changes
+- [ ] Rationale/context
+
+## Testing
+
+- [ ] `npm test`
+- [ ] `npm run build`
+- [ ] Other (describe):
+
+## Screenshots (if UI)
+
+## Notes for reviewers

package/.vscode/extensions.json

@@ -0,0 +1,31 @@
+{
+  "recommendations": [
+    // AI Assistants
+    "github.copilot",
+    "github.copilot-chat",
+    "openai.chatgpt",
+    // Code Quality & Linting
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "editorconfig.editorconfig",
+    "streetsidesoftware.code-spell-checker",
+    // TypeScript & JavaScript
+    "usernamehw.errorlens",
+    "yoavbls.pretty-ts-errors",
+    // Import Management
+    "wix.vscode-import-cost",
+    // Theming & Icons
+    "zhuangtongfa.material-theme",
+    "pkief.material-icon-theme",
+    // Git & Version Control
+    "eamodio.gitlens",
+    "mhutchie.git-graph",
+    // Testing
+    "vitest.explorer",
+    // Utilities
+    "christian-kohler.path-intellisense",
+    "zignd.html-css-class-completion",
+    "formulahendry.auto-rename-tag",
+    "bradlc.vscode-tailwindcss"
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,80 @@
+# Changelog
+
+All notable changes to this project will be documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the versioning reflects package releases.
+
+## [Unreleased]
+
+## [1.1.0] - 2026-01-30
+
+### Added
+
+- Create LICENSE ([01491e8]).
+- Add initial CHANGELOG.md following Keep a Changelog ([0754ae2]).
+
+### Changed
+
+- Rename theme folder to `spectre-theme/` and update references ([bba2b67]).
+- Restructure project and update dependencies ([a38feba]).
+- Refactor project structure into template directory ([2e7c5e4]).
+
+### Documentation
+
+- Revamp README with detailed setup and usage guide ([fe734ee]).
+
+## [1.0.0] - 2026-01-30
+
+### Added
+
+- Initial implementation of Vite WordPress theme template with TypeScript and Tailwind CSS 4 ([8704a25]).
+- Add Vite configuration with manifest-based asset loading for WordPress ([8704a25]).
+- Add Tailwind CSS 4 configuration with WordPress template paths ([8704a25]).
+- Add WordPress theme structure with `functions.php`, `header.php`, `footer.php`, and `index.php` ([8704a25]).
+- Add source files with TypeScript entry point and CSS with Tailwind imports ([8704a25]).
+- Add HMR support for development mode via Vite dev server ([8704a25]).
+- Add dev/prod mode detection via `WP_ENV` environment variable ([8704a25]).
+- Add GitHub issue templates for bug reports, feature requests, and documentation ([e005b39]).
+- Add pull request template ([e005b39]).
+- Add CONTRIBUTING.md with development workflow and guidelines ([6202054]).
+- Add CODE_OF_CONDUCT.md based on Contributor Covenant ([1fb4ab3]).
+- Add SECURITY.md with security policy and reporting guidelines ([417b4b4]).
+- Add GitHub funding configuration ([e005b39]).
+- Add VS Code workspace settings and devcontainer configuration ([4f8ddbb], [7b5b0ad]).
+
+### Changed
+
+- Rename project to Spectre Shell WordPress ([b5cf594]).
+- Update package.json with full metadata, keywords, and repository information ([e005b39]).
+- Fix TypeScript configuration to support Node.js module imports ([e005b39]).
+- Install @types/node for proper TypeScript support ([e005b39]).
+
+### Documentation
+
+- Add comprehensive README with setup instructions and customization guide ([8704a25]).
+- Add theme-specific README in `spectre-theme/` folder ([8704a25]).
+- Add source-specific README in `src/` folder ([8704a25]).
+
+[unreleased]: https://github.com/phcdevworks/spectre-shell-wordpress/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/phcdevworks/spectre-shell-wordpress/tree/v1.1.0
+[1.0.0]: https://github.com/phcdevworks/spectre-shell-wordpress/tree/v1.0.0
+[bba2b67]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/bba2b67
+[a38feba]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/a38feba
+[2e7c5e4]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/2e7c5e4
+[fe734ee]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/fe734ee
+[01491e8]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/01491e8
+[0754ae2]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/0754ae2
+[b5cf594]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/b5cf594
+[e005b39]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/e005b39
+[417b4b4]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/417b4b4
+[6202054]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/6202054
+[1fb4ab3]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/1fb4ab3
+[8704a25]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/8704a25
+[4f8ddbb]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/4f8ddbb
+[7b5b0ad]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/7b5b0ad
+[b5cf594]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/b5cf594
+[e005b39]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/e005b39
+[417b4b4]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/417b4b4
+[6202054]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/6202054
+[1fb4ab3]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/1fb4ab3
+[8704a25]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/8704a25
+[4f8ddbb]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/4f8ddbb
+[7b5b0ad]: https://github.com/phcdevworks/spectre-shell-wordpress/commit/7b5b0ad

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,80 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in the Spectre community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement via:
+
+- GitHub Issues: [spectre-shell-wordpress/issues](https://github.com/phcdevworks/spectre-shell-wordpress/issues)
+- Email: [Contact maintainers through GitHub](https://github.com/phcdevworks)
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).