Extensions packages, pinnable filter bar, and v3.1 release prep

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,147 @@
+name: "?? Bug Report"
+description: "Report a bug or issue with SwaggerUI.Themes or SwaggerUI.Extensions"
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting an issue! Please fill out the information below to help us investigate.
+
+  - type: dropdown
+    id: package_type
+    attributes:
+      label: "Package Type"
+      description: "Which type of package are you reporting an issue with?"
+      options:
+        - "Theme (AspNetCore.SwaggerUI.Themes)"
+        - "Theme (NSwag.AspNetCore.Themes)"
+        - "Extension (AspNetCore.SwaggerUI.Extensions)"
+        - "Extension (NSwag.AspNetCore.Extensions)"
+        - "Common (AspNetCore.Swagger.Themes.Common)"
+        - "Unsure"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: integration
+    attributes:
+      label: "Integration Framework"
+      description: "Which Swagger integration are you using?"
+      options:
+        - "Swashbuckle.AspNetCore"
+        - "NSwag.AspNetCore"
+        - "Both"
+        - "Not applicable"
+    validations:
+      required: true
+
+  - type: input
+    id: dotnet_version
+    attributes:
+      label: ".NET Version"
+      description: "Which .NET version are you using? (e.g., 8.0, 9.0, 10.0)"
+      placeholder: "e.g., 8.0"
+    validations:
+      required: true
+
+  - type: input
+    id: package_version
+    attributes:
+      label: "Package Version"
+      description: "Which version of the package are you using?"
+      placeholder: "e.g., 3.0.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: "Description"
+      description: "Clear and concise description of the bug"
+      placeholder: "What happened?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: "Steps to Reproduce"
+      description: "Step-by-step instructions to reproduce the issue"
+      placeholder: |
+        1. Configure the package with...
+        2. Navigate to...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: "Expected Behavior"
+      description: "What should happen?"
+      placeholder: "Describe the expected behavior"
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual_behavior
+    attributes:
+      label: "Actual Behavior"
+      description: "What actually happens?"
+      placeholder: "Describe what actually happens"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: browser
+    attributes:
+      label: "Browser (if UI-related)"
+      description: "Which browser are you using? (Only relevant for theme/UI issues)"
+      options:
+        - "Chrome"
+        - "Firefox"
+        - "Safari"
+        - "Edge"
+        - "Other"
+        - "Not applicable"
+
+  - type: textarea
+    id: code_snippet
+    attributes:
+      label: "Code Snippet"
+      description: "Relevant code that demonstrates the issue (optional)"
+      render: csharp
+      placeholder: |
+        // Your code here
+        app.UseSwaggerUI(Theme.Dark);
+
+  - type: textarea
+    id: error_logs
+    attributes:
+      label: "Error Logs or Stack Trace"
+      description: "Any relevant error messages or stack traces (optional)"
+      render: plain_text
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: "Screenshots"
+      description: "Screenshots showing the issue (optional, for UI-related issues)"
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: "Additional Context"
+      description: "Any other information that might be helpful"
+      placeholder: "Add any other context about the problem here"
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "Verification"
+      options:
+        - label: "I have searched existing issues and found no duplicates"
+          required: true
+        - label: "I have provided clear reproduction steps"
+          required: true
+        - label: "I have included relevant error messages or logs"

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,8 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
+contact_links:
+  - name: "❓ Ask a Question"
+    url: "https://github.com/teociaps/SwaggerUI.Themes/discussions"
+    about: "Have a question or want to discuss? Use GitHub Discussions!"
+  - name: "📚 View Documentation"
+    url: "https://github.com/teociaps/SwaggerUI.Themes/wiki"
+    about: "Check the wiki for comprehensive documentation and guides"

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,105 @@
+name: "? Feature Request"
+description: "Suggest a new feature or enhancement for SwaggerUI.Themes or SwaggerUI.Extensions"
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a feature! Please provide details to help us understand your idea.
+
+  - type: dropdown
+    id: feature_type
+    attributes:
+      label: "Feature Type"
+      description: "What category is your feature request for?"
+      options:
+        - "Theme (visual/styling enhancement)"
+        - "Extension (functional capability)"
+        - "Documentation"
+        - "Developer Experience"
+        - "Other"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: package_scope
+    attributes:
+      label: "Package Scope"
+      description: "Which packages should this feature apply to?"
+      options:
+        - "Swashbuckle only (AspNetCore.SwaggerUI.*)"
+        - "NSwag only (NSwag.AspNetCore.*)"
+        - "Both Swashbuckle and NSwag"
+        - "Common/Shared"
+        - "Not sure"
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: "Problem Statement"
+      description: "What problem does this feature solve? What is the use case?"
+      placeholder: |
+        Current situation: ...
+        Problem: ...
+        Why this matters: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: "Proposed Solution"
+      description: "Describe how you envision this feature working"
+      placeholder: |
+        Describe the ideal behavior/UI/API
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "Alternative Solutions"
+      description: "Are there any alternative approaches? (optional)"
+      placeholder: "Have you considered other ways to solve this?"
+
+  - type: textarea
+    id: example_usage
+    attributes:
+      label: "Example Usage"
+      description: "How would users interact with this feature? (optional)"
+      render: csharp
+      placeholder: |
+        // Example code showing how the feature would be used
+        app.UseSwaggerUI(Theme.Dark, c =>
+        {
+            c.MyNewFeature();
+        });
+
+  - type: textarea
+    id: design_considerations
+    attributes:
+      label: "Design Considerations"
+      description: "Any thoughts on API design, backward compatibility, or performance? (optional)"
+      placeholder: "Backward compatibility impact, performance considerations, naming suggestions, etc."
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "Verification"
+      options:
+        - label: "I have searched existing feature requests and found no duplicates"
+          required: true
+        - label: "This feature aligns with the project scope"
+          required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: "Additional Context"
+      description: "Any other information or references? (optional)"
+      placeholder: |
+        - Related issues: #123
+        - Similar features in other projects: ...
+        - References: ...

.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,67 @@
+name: "? Question/Discussion"
+description: "Ask a question or start a discussion about using the packages"
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have a question about how to use SwaggerUI.Themes or SwaggerUI.Extensions? Please ask away!
+
+  - type: dropdown
+    id: package_type
+    attributes:
+      label: "Package"
+      description: "Which package is your question about?"
+      options:
+        - "AspNetCore.SwaggerUI.Themes"
+        - "NSwag.AspNetCore.Themes"
+        - "AspNetCore.SwaggerUI.Extensions"
+        - "NSwag.AspNetCore.Extensions"
+        - "General/Not sure"
+    validations:
+      required: true
+
+  - type: input
+    id: dotnet_version
+    attributes:
+      label: ".NET Version"
+      description: "Which .NET version are you using?"
+      placeholder: "e.g., 8.0, 9.0, 10.0"
+
+  - type: input
+    id: package_version
+    attributes:
+      label: "Package Version"
+      description: "Which version of the package are you using?"
+      placeholder: "e.g., 3.0.0"
+
+  - type: textarea
+    id: question
+    attributes:
+      label: "Your Question"
+      description: "What would you like to know?"
+      placeholder: "Ask your question here..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: "Context"
+      description: "What are you trying to achieve? Include any relevant code."
+      render: csharp
+      placeholder: |
+        // Your code/setup here
+
+  - type: textarea
+    id: what_you_tried
+    attributes:
+      label: "What Have You Tried?"
+      description: "What solutions have you already attempted?"
+      placeholder: "Describe any troubleshooting steps you've already taken"
+
+  - type: textarea
+    id: additional_info
+    attributes:
+      label: "Additional Information"
+      description: "Any other details that might be helpful? (optional)"

.github/pull_request_template.md

@@ -0,0 +1,65 @@
+## Description
+
+<!-- Briefly describe your changes -->
+
+## Type of Change
+
+- [ ] ?? **Theme** (visual/styling updates)
+- [ ] ?? **Extension** (functional capability)
+- [ ] ?? **Documentation** (docs/comments only)
+- [ ] ?? **Bug Fix** (fixes an issue)
+- [ ] ?? **Refactoring** (internal improvements)
+- [ ] ?? **Tests** (test updates/additions)
+
+## Related Issue
+
+Fixes #<!-- issue number --> or Relates to #<!-- issue number -->
+
+## Package(s) Affected
+
+- [ ] AspNetCore.SwaggerUI.Themes
+- [ ] NSwag.AspNetCore.Themes
+- [ ] AspNetCore.SwaggerUI.Extensions
+- [ ] NSwag.AspNetCore.Extensions
+- [ ] AspNetCore.Swagger.Themes.Common
+
+## Testing
+
+Please describe the testing done to verify this change:
+
+<!-- Describe testing approach -->
+
+- [ ] I have built the solution (`dotnet build -c Release`)
+- [ ] I have run the test suite (`dotnet test`)
+- [ ] I have tested with relevant sample projects
+- [ ] All changes work across .NET 8, 9, and 10 (if applicable)
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have added/updated tests for my changes
+- [ ] I have updated relevant documentation (README, CONTRIBUTING, wiki, etc.)
+- [ ] My changes do not break any existing functionality
+- [ ] I have verified no new compiler warnings are introduced
+
+## Theme-Specific (if applicable)
+
+- [ ] Minified CSS/JS files have been updated
+- [ ] Minified file headers are correctly formatted (`/*Name*/...`)
+- [ ] All placeholders (e.g., `{$THEME_SWITCHER}`) are preserved in minified files
+- [ ] Theme is discoverable and testable
+
+## Extension-Specific (if applicable)
+
+- [ ] Implementation exists for both Swashbuckle and NSwag (if cross-platform)
+- [ ] Extension works independently and with other extensions
+- [ ] Tests cover the new functionality
+- [ ] Sample applications demonstrate the feature
+
+## Screenshots/Demo
+
+<!-- If applicable, add screenshots or demonstration GIFs -->
+
+## Additional Context
+
+<!-- Add any other context or notes here -->