chore(deps): upgrade deps and API doc

Author: cmagee

.projen/deps.json

@@ -3,8 +3,8 @@ const project = new awscdk.AwsCdkConstructLibrary({
   author: 'Cameron Magee',
   authorAddress: '[email protected]',
   copyrightOwner: 'Amazon.com, Inc. or its affiliates. All Rights Reserved.',
-  cdkVersion: '2.1.0',
-  constructsVersion: '10.0.5',
+  cdkVersion: '2.59.0',
+  constructsVersion: '10.1.215',
   defaultReleaseBranch: 'main',
   name: 'cdk-image-pipeline',
   repositoryUrl: 'https://github.com/aws-samples/cdk-image-pipeline.git',
@@ -17,7 +17,7 @@ const project = new awscdk.AwsCdkConstructLibrary({
   license: 'MIT-0',
   pullRequestTemplateContents: ['# Fixes', ' ', ' ', 'By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.'],
   releaseToNpm: true,
-  devDeps: ['@types/prettier@2.6.0'],
+  devDeps: ['@types/prettier@2.7.2'],
 });
 
 project.addPeerDeps('aws-cdk-lib');

.projenrc.js

@@ -62,7 +62,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="cdk-image-pipeline.ImagePipeline.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="cdk-image-pipeline.ImagePipeline.isConstruct"></a>
 
 ```typescript
 import { ImagePipeline } from 'cdk-image-pipeline'
@@ -72,6 +72,20 @@ ImagePipeline.isConstruct(x: any)
 
 Checks if `x` is a construct.
 
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
 ###### `x`<sup>Required</sup> <a name="x" id="cdk-image-pipeline.ImagePipeline.isConstruct.parameter.x"></a>
 
 - *Type:* any