feat: expose predicate quantifier input (#15)

README.md

@@ -324,7 +324,8 @@ jobs:
     runs-on: ubuntu-latest
     # Required permissions
     permissions:
-      pull-requests: read
+      contents: read      # required by actions/checkout
+      pull-requests: read # required by dorny/paths-filter
     steps:
     - uses: actions/checkout@v4
     - uses: dorny/paths-filter@v3

action.yml

@@ -47,9 +47,19 @@ inputs:
   predicate-quantifier:
     description: |
       Optional parameter to override the default behavior of file matching algorithm.
-      By default, files that match at least one pattern defined by the filters will be included.
-      This parameter allows overriding the "at least one" behavior so that all patterns must match.
-      Supported values are 'some' and 'every'.
+      By default files that match at least one pattern defined by the filters will be included.
+      This parameter allows to override the "at least one pattern" behavior to make it so that
+      all of the patterns have to match or otherwise the file is excluded.
+      An example scenario where this is useful if you would like to match all
+      .ts files in a sub-directory but not .md files.
+      The filters below will match markdown files despite the exclusion syntax UNLESS
+      you specify 'every' as the predicate-quantifier parameter. When you do that,
+      it will only match the .ts files in the subdirectory as expected.
+
+      backend:
+       - 'pkg/a/b/c/**'
+       - '!**/*.jpeg'
+       - '!**/*.md'
     required: false
     default: 'some'
 outputs: