feat(js): add includeIgnoredAssetFiles option and per-asset includeIgnoredFiles (#31813)

## Summary

Adds support for including files that are ignored by `.gitignore` and
`.nxignore` when copying assets in @nx/js executors.

### Changes Made

- **Global option**: Added `includeIgnoredAssetFiles` option to
@nx/js:tsc and @nx/js:swc executors
- **Per-asset option**: Added `includeIgnoredFiles` option to
`AssetGlob` interface for granular control
- **Precedence logic**: Per-asset `includeIgnoredFiles` takes precedence
over global `includeIgnoredAssetFiles`
- **Updated all implementations**: Modified `CopyAssetsHandler`, batch
processing, and utility functions

### Usage Examples

**Global level** - include ignored files for all assets:
```json
{
  "executor": "@nx/js:tsc",
  "options": {
    "includeIgnoredAssetFiles": true,
    "assets": ["src/assets"]
  }
}
```

**Per-asset level** - include ignored files for specific asset patterns:
```json
{
  "executor": "@nx/js:tsc",
  "options": {
    "assets": [
      {
        "glob": "**/*",
        "input": "src/assets",
        "output": "assets",
        "includeIgnoredFiles": true
      }
    ]
  }
}
```

### Test Plan

- [x] TypeScript compilation passes
- [x] All existing tests pass
- [x] Documentation updated automatically
- [x] Both TSC and SWC executors support the new options

###
Fixes: [20309](#20309)

🤖 Generated with [Claude Code](https://claude.ai/code)

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com>
Co-authored-by: Craigory Coppola <AgentEnder@users.noreply.github.com>
Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
(cherry picked from commit fc8f9a9)

Author: 4 people

docs/generated/packages/js/executors/swc.json

@@ -74,6 +74,11 @@
                 "output": {
                   "type": "string",
                   "description": "Absolute path within the output."
+                },
+                "includeIgnoredFiles": {
+                  "type": "boolean",
+                  "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+                  "default": false
                 }
               },
               "additionalProperties": false,
@@ -135,6 +140,11 @@
         "type": "boolean",
         "description": "Remove leading directory from output (e.g. src). See: https://swc.rs/docs/usage/cli#--strip-leading-paths",
         "default": false
+      },
+      "includeIgnoredAssetFiles": {
+        "type": "boolean",
+        "description": "Include files that are ignored by .gitignore and .nxignore when copying assets. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+        "default": false
       }
     },
     "required": ["main", "outputPath", "tsConfig"],
@@ -160,6 +170,11 @@
               "output": {
                 "type": "string",
                 "description": "Absolute path within the output."
+              },
+              "includeIgnoredFiles": {
+                "type": "boolean",
+                "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+                "default": false
               }
             },
             "additionalProperties": false,

docs/generated/packages/js/executors/tsc.json

@@ -77,6 +77,11 @@
                 "output": {
                   "type": "string",
                   "description": "Absolute path within the output."
+                },
+                "includeIgnoredFiles": {
+                  "type": "boolean",
+                  "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+                  "default": false
                 }
               },
               "additionalProperties": false,
@@ -140,6 +145,11 @@
         "type": "boolean",
         "description": "Generate package.json file in the output folder.",
         "default": true
+      },
+      "includeIgnoredAssetFiles": {
+        "type": "boolean",
+        "description": "Include files that are ignored by .gitignore and .nxignore when copying assets. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+        "default": false
       }
     },
     "required": ["main", "outputPath", "tsConfig"],
@@ -165,6 +175,11 @@
               "output": {
                 "type": "string",
                 "description": "Absolute path within the output."
+              },
+              "includeIgnoredFiles": {
+                "type": "boolean",
+                "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+                "default": false
               }
             },
             "additionalProperties": false,

packages/js/src/executors/swc/schema.json

@@ -118,6 +118,11 @@
       "type": "boolean",
       "description": "Remove leading directory from output (e.g. src). See: https://swc.rs/docs/usage/cli#--strip-leading-paths",
       "default": false
+    },
+    "includeIgnoredAssetFiles": {
+      "type": "boolean",
+      "description": "Include files that are ignored by .gitignore and .nxignore when copying assets. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+      "default": false
     }
   },
   "required": ["main", "outputPath", "tsConfig"],
@@ -145,6 +150,11 @@
             "output": {
               "type": "string",
               "description": "Absolute path within the output."
+            },
+            "includeIgnoredFiles": {
+              "type": "boolean",
+              "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+              "default": false
             }
           },
           "additionalProperties": false,

packages/js/src/executors/tsc/lib/batch/build-task-info-per-tsconfig-map.ts

@@ -91,6 +91,7 @@ function createTaskInfo(
     rootDir: context.root,
     outputDir: taskOptions.outputPath,
     assets: taskOptions.assets,
+    includeIgnoredFiles: taskOptions.includeIgnoredAssetFiles,
   });
 
   const {

packages/js/src/executors/tsc/schema.json

@@ -111,6 +111,11 @@
       "type": "boolean",
       "description": "Generate package.json file in the output folder.",
       "default": true
+    },
+    "includeIgnoredAssetFiles": {
+      "type": "boolean",
+      "description": "Include files that are ignored by .gitignore and .nxignore when copying assets. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+      "default": false
     }
   },
   "required": ["main", "outputPath", "tsConfig"],
@@ -138,6 +143,11 @@
             "output": {
               "type": "string",
               "description": "Absolute path within the output."
+            },
+            "includeIgnoredFiles": {
+              "type": "boolean",
+              "description": "Include files that are ignored by .gitignore and .nxignore for this specific asset pattern. WARNING: Ignored files are not automatically considered when calculating the task hash. To ensure Nx tracks these files for caching, add them to your target's inputs using 'dependentTasksOutputs' or 'runtime' configuration.",
+              "default": false
             }
           },
           "additionalProperties": false,

packages/js/src/executors/tsc/tsc.impl.ts

@@ -92,6 +92,7 @@ export async function* tscExecutor(
     rootDir: context.root,
     outputDir: _options.outputPath,
     assets: _options.assets,
+    includeIgnoredFiles: _options.includeIgnoredAssetFiles,
   });
 
   const tsCompilationOptions = createTypeScriptCompilationOptions(

packages/js/src/utils/assets/assets.ts

@@ -9,6 +9,7 @@ export type AssetGlob = FileInputOutput & {
   glob: string;
   ignore?: string[];
   dot?: boolean;
+  includeIgnoredFiles?: boolean;
 };
 
 export function assetGlobsToFiles(