@@ -5,42 +5,24 @@ import { makeOverlaySelectable } from "atom-ide-base/commons-ui/float-pane/selec
55import { SignatureHelpRegistry , SignatureHelpProvider } from "atom-ide-base"
66
77export class SignatureHelpManager {
8- /**
9- * holds a reference to disposable items from this data tip manager
10- */
8+ /** Holds a reference to disposable items from this data tip manager */
119 subscriptions = new CompositeDisposable ( )
12- /**
13- * holds a list of registered data tip providers
14- */
10+ /** Holds a list of registered data tip providers */
1511 providerRegistry = new ProviderRegistry < SignatureHelpProvider > ( )
16- /**
17- * holds a weak reference to all watched Atom text editors
18- */
12+ /** Holds a weak reference to all watched Atom text editors */
1913 watchedEditors = new WeakSet < TextEditor > ( )
20- /**
21- * holds a reference to the current watched Atom text editor
22- */
14+ /** Holds a reference to the current watched Atom text editor */
2315 editor : TextEditor | null = null
24- /**
25- * holds a reference to the current watched Atom text editor viewbuffer
26- */
16+ /** Holds a reference to the current watched Atom text editor viewbuffer */
2717 editorView : TextEditorElement | null = null
28- /**
29- * holds a reference to all disposable items for the current watched Atom text editor
30- */
18+ /** Holds a reference to all disposable items for the current watched Atom text editor */
3119 editorSubscriptions : CompositeDisposable = new CompositeDisposable ( )
32- /**
33- * holds a reference to all disposable items for the current signature help
34- */
20+ /** Holds a reference to all disposable items for the current signature help */
3521 signatureHelpDisposables : CompositeDisposable = new CompositeDisposable ( )
36- /**
37- * config flag denoting if the signature help should be shown during typing automatically
38- */
22+ /** Config flag denoting if the signature help should be shown during typing automatically */
3923 showSignatureHelpOnTyping = false
4024
41- /**
42- * initialization routine
43- */
25+ /** Initialization routine */
4426 initialize ( ) {
4527 this . subscriptions . add (
4628 atom . workspace . observeTextEditors ( ( editor ) => {
@@ -69,9 +51,7 @@ export class SignatureHelpManager {
6951 )
7052 }
7153
72- /**
73- * dispose function to clean up any disposable references used
74- */
54+ /** Dispose function to clean up any disposable references used */
7555 dispose ( ) {
7656 this . signatureHelpDisposables . dispose ( )
7757
@@ -80,18 +60,17 @@ export class SignatureHelpManager {
8060 this . subscriptions . dispose ( )
8161 }
8262
83- /**
84- * returns the provider registry as a consumable service
85- */
63+ /** Returns the provider registry as a consumable service */
8664 get signatureHelpRegistry ( ) : SignatureHelpRegistry {
8765 return ( provider ) => {
8866 return this . providerRegistry . addProvider ( provider )
8967 }
9068 }
9169
9270 /**
93- * checks and setups an Atom Text editor instance for tracking cursor/mouse movements
94- * @param editor a valid Atom Text editor instance
71+ * Checks and setups an Atom Text editor instance for tracking cursor/mouse movements
72+ *
73+ * @param editor A valid Atom Text editor instance
9574 */
9675 watchEditor ( editor : TextEditor ) {
9776 if ( this . watchedEditors . has ( editor ) ) {
@@ -125,9 +104,9 @@ export class SignatureHelpManager {
125104 }
126105
127106 /**
128- * updates the internal references to a specific Atom Text editor instance in case
129- * it has been decided to track this instance
130- * @param editor the Atom Text editor instance to be tracked
107+ * Updates the internal references to a specific Atom Text editor instance in case it has been decided to track this instance
108+ *
109+ * @param editor The Atom Text editor instance to be tracked
131110 */
132111 updateCurrentEditor ( editor : TextEditor | null ) {
133112 if ( editor === this . editor ) {
@@ -198,9 +177,9 @@ export class SignatureHelpManager {
198177 }
199178
200179 /**
201- * @param provider
202- * @param editor
203- * @param position
180+ * @param provider
181+ * @param editor
182+ * @param position
204183 */
205184 async showSignatureHelp ( provider : SignatureHelpProvider , editor : TextEditor , position : Point ) {
206185 try {
@@ -267,11 +246,12 @@ export class SignatureHelpManager {
267246 }
268247
269248 /**
270- * mounts displays a signature help view component at a specific position in a given Atom Text editor
271- * @param editor the Atom Text editor instance to host the data tip view
272- * @param position the position on which to show the signature help view
273- * @param view the signature help component to display
274- * @return a composite object to release references at a later stage
249+ * Mounts displays a signature help view component at a specific position in a given Atom Text editor
250+ *
251+ * @param editor The Atom Text editor instance to host the data tip view
252+ * @param position The position on which to show the signature help view
253+ * @param view The signature help component to display
254+ * @returns A composite object to release references at a later stage
275255 */
276256 mountSignatureHelp ( editor : TextEditor , position : Point , view : ViewContainer ) {
277257 const element = view . element as HTMLElement
@@ -332,9 +312,7 @@ export class SignatureHelpManager {
332312 return disposables
333313 }
334314
335- /**
336- * unmounts / hides the most recent data tip view component
337- */
315+ /** Unmounts / hides the most recent data tip view component */
338316 unmountDataTip ( ) {
339317 this . signatureHelpDisposables . dispose ( )
340318 }
0 commit comments