Merge branch 'main' into feat/brightness-example

.github/.cspell/dart_dictionary.txt

@@ -6,3 +6,4 @@ dartdocs # plural of dartdoc
 endtemplate # Use @endtemplate to close a @template block in dartdoc
 pubspec # dependency and configuration file of every Dart project
 typedefs # plural of typedef
+writeln # StringBuffer.writeln

.github/.cspell/flame_dictionary.txt

@@ -20,6 +20,7 @@ spineboy # Name of a famous character used as an example for Spine https://en.es
 spineboys # Plural of spineboy
 Spritecow # A handy tool for locating sprites within a spritesheet http://www.spritecow.com/
 Supabase # Supabase, one of our sponsors https://supabase.com/
+texturepacker # a packed spritesheet format
 Tilemap # What tile maps are called within Tiled
 vantablack # brand name for a famous super-black ink known as the darkest ever made
 Weasley # Ron Weasley, a character from the book Harry Potter

.github/.cspell/gamedev_dictionary.txt

@@ -6,7 +6,6 @@ AHSV # alpha hue saturation value
 antialiasing # set of techniques to combat the problems of aliasing
 ARGB # alpha red green blue
 arities # plural of arity
-arity # number of parameters a function takes
 autofocus # auto focus event
 backgrounded # moving the app to the background
 backgrounding # moving the app to the background
@@ -19,7 +18,6 @@ blockquote # HTML tag
 broadphase # common division of collision detection between broad and narrow phases
 cathetus # the non-hypotenuse sides of a right triangle
 clusterized # past tense of clusterize
-consts # plural of const (constant)
 easings # Easing functions specify the rate of change of a parameter over time
 fullscreen # mode in which a program or app occupies the entire screen with no borders
 goldens # test files used as reference for Golden Tests
@@ -46,9 +44,9 @@ raycasts # plural of raycast
 raytrace # act of raytracing
 raytracing # rendering techniques that calculates light rays as straight lines
 rects # plural of rect
-refactorings # plural of refactoring
 respawned # past tense of respawn
 respawn # when the player character dies and is brought back after some time and penalties
+retarget # to direct (something) toward a different target
 RGBA # red green blue alpha
 RGBO # red green blue opacity
 rrect # rounded rect

.github/.cspell/people_usernames.txt

@@ -4,6 +4,8 @@ bluefireteam # github.com/bluefireteam
 erayzesen # erayzesen.itch.io
 erickzanardo # github.com/erickzanardo 
 feroult # github.com/feroult 
+fröber # github.com/Brixto
+gnarhard # github.com/gnarhard
 Klingsbo # github.com/spydon
 luanpotter # github.com/luanpotter
 Lukas # github.com/spydon
@@ -13,5 +15,6 @@ subosito # github.com/subosito
 spydon # github.com/spydon
 stpasha # github.com/stpasha
 tavian # tavianator.com
+videon # github.com/markvideon
 wolfenrain # github.com/wolfenrain
 xaha # github.com/xvrh

.github/.cspell/words_dictionary.txt

@@ -2,16 +2,13 @@
 bloodlust
 collidable
 collidables
-composability
-discoverability
 draggables
 focusable
 gamepad
 gamepads
 gameplay
 gapless
 grayscale
-highscore
 hoverable
 hoverables
 inactives
@@ -30,11 +27,10 @@ proxying
 ptero # short for pterodactyl
 rebalance
 redeclaration
+refreshable
 renderable
 rescan
 tappable
 tappables
 toolset
 underutilize
-unproject
-unscale

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,82 @@
+name: Bug Report
+description: You are creating a Game with Flame but you are noticing some strange behavior, that it throws an unexpected exception, or that it is not working according to the specifications.
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        When reporting a bug, please read this complete template and fill in all the questions in order to get a better response!
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Tell us, what happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expectation
+    attributes:
+      label: What do you expect?
+      description: Also tell us, what behavior did you expect? 
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: How can we reproduce this?
+      description: Thougougly explain how to reproduce the bug.
+
+  - type: textarea
+    id: steps-to-fix
+    attributes:
+      label: What steps should take to fix this?
+      description: If possible please report steps based on the example from this plugin! 
+
+  - type: textarea
+    id: example-changes
+    attributes:
+      label: Do have an example of where the bug occurs?
+      description: If you can make a minimal reproducible example it is incredibly helpful, the simplest way is to share a link from https://zapp.run, you can start from https://zapp.run/edit/flame where all dependencies are already set up.
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: If you have any debug / error logging, please fill it here within the code block below
+      render: shell
+
+  - type: textarea
+    attributes:
+      label: Execute in a terminal and put output into the code block below
+      value: 'Output of: flutter doctor -v'
+
+  - type: dropdown
+    id: affected-platforms
+    attributes:
+      label: Affected platforms
+      multiple: true
+      options:
+        - All
+        - Android
+        - iOS
+        - Linux
+        - macOS
+        - Windows
+        - Web
+    validations:
+      required: true
+
+  - type: textarea
+    id: other-information
+    attributes:
+      label: Other information
+      description: Do you have any other useful information about this bug report? Please write it down here
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Are you interested in working on a PR for this?
+      options:
+        - label: I want to work on this

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
   - name: I have some questions about Flame.
     url: https://stackoverflow.com/tags/flame

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature request
+description: Suggest a new feature for Flame.
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        When suggesting a feature, please read this complete form and fill in all the questions in order to get a better response!
+  - type: textarea
+    id: problem-to-solve
+    attributes:
+      label: Problem to solve
+      description: Which problem would be solved with this feature?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: What do you propose as a solution? Add as much information as you can!
+    validations:
+      required: true
+  - type: textarea
+    id: more-information
+    attributes:
+      label: More information
+      description: Do you have any other useful information about this feature report? Please write it down here. Possible helpful information are references to other sites/repositories.
+  - type: checkboxes
+    id: other
+    attributes:
+      label: Other
+      options:
+        - label: Are you interested in working on a PR for this? 

.github/ISSUE_TEMPLATE/improvement_suggestion.yml

@@ -0,0 +1,38 @@
+name: Improvement suggestion
+description: Something in Flame can be improved.
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        When suggesting an improvement, please read this complete form and fill in all the questions in order to get a better response!
+  - type: textarea
+    id: area-to-improve
+    attributes:
+      label: What could be improved
+      description: What part of the code/functionality could be improved?
+    validations:
+      required: true
+  - type: textarea
+    id: why
+    attributes:
+      label: Why should this be improved
+      description: Why is this necessary to be improved?
+    validations:
+      required: true
+  - type: textarea
+    id: risks
+    attributes:
+      label: Risks
+      description: Are there any risks in improving this? Will the API change? Will other functionality change?
+  - type: textarea
+    id: more-information
+    attributes:
+      label: More information
+      description: Do you have any other useful information about this feature report? Please write it down here. Possible helpful information are references to other sites/repositories.
+  - type: checkboxes
+    id: other
+    attributes:
+      label: Other
+      options:
+        - label: Are you interested in working on a PR for this? 

.github/pull_request_template.md

@@ -1,8 +1,13 @@
+<!-- Exclude from commit message -->
 <!--
 The title of your PR on the line above should start with a [Conventional Commit] prefix
 (`fix:`, `feat:`, `docs:`, `test:`, `chore:`, `refactor:`, `perf:`, `build:`, `ci:`,
 `style:`, `revert:`). This title will later become an entry in the [CHANGELOG], so please
 make sure that it summarizes the PR adequately.
+
+Don't remove the "exclude from commit message" comments below. They are used to prevent
+the PR description template from being included in the git log.
+Only change the "Replace this text" parts.
 -->
 
 # Description
@@ -12,8 +17,10 @@ If you're modifying existing behavior, describe the existing behavior, how this
 and what motivated the change. If this is a breaking change, specify explicitly which APIs were
 changed.
 -->
+<!-- End of exclude from commit message -->
+Replace this text.
 
-
+<!-- Exclude from commit message -->
 ## Checklist
 <!--
 Before you create this PR confirm that it meets all requirements listed below by checking the
@@ -42,8 +49,10 @@ instructions" section below.
 ### Migration instructions
 
 If the PR is breaking, uncomment this header and add instructions for how to migrate from the
-currently released version to the new proposed way.
+currently released version in-between the two following tags:
 -->
+<!-- End of exclude from commit message -->
+<!-- Exclude from commit message -->
 
 ## Related Issues
 <!--
@@ -56,3 +65,4 @@ Closes #1234
 [Contributor Guide]: https://github.com/flame-engine/flame/blob/main/CONTRIBUTING.md
 [Conventional Commit]: https://conventionalcommits.org
 [CHANGELOG]: https://github.com/flame-engine/flame/blob/main/CHANGELOG.md
+<!-- End of exclude from commit message -->