Safe-DS · lars-reimann · Apr 15, 2024 · Apr 15, 2024 · Apr 15, 2024 · Apr 15, 2024
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` InvertibleTableTransformer {#safeds.data.tabular.transformation.InvertibleTableTransformer data-toc-label='InvertibleTableTransformer'}
 
 A `TableTransformer` that can also undo the learned transformation after it has been applied.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` TableTransformer {#safeds.data.tabular.transformation.TableTransformer data-toc-label='TableTransformer'}
 
 Learn a transformation for a set of columns in a `Table` and transform another `Table` with the same columns.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` ColumnType {#safeds.data.tabular.typing.ColumnType data-toc-label='ColumnType'}
 
 Abstract base class for column types.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Schema {#safeds.data.tabular.typing.Schema data-toc-label='Schema'}
 
 Store column names and corresponding data types for a `Table` or `Row`.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Any {#safeds.lang.Any data-toc-label='Any'}
 
 The common superclass of all classes.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Boolean {#safeds.lang.Boolean data-toc-label='Boolean'}
 
 A truth value.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Float {#safeds.lang.Float data-toc-label='Float'}
 
 A floating-point number.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Int {#safeds.lang.Int data-toc-label='Int'}
 
 An integer.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` List {#safeds.lang.List data-toc-label='List'}
 
 A list of elements.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Map {#safeds.lang.Map data-toc-label='Map'}
 
 A map of keys to values.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Nothing {#safeds.lang.Nothing data-toc-label='Nothing'}
 
 The common subclass of all classes.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Number {#safeds.lang.Number data-toc-label='Number'}
 
 A number.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` String {#safeds.lang.String data-toc-label='String'}
 
 Some text.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Classifier {#safeds.ml.classical.classification.Classifier data-toc-label='Classifier'}
 
 Abstract base class for all classifiers.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` Regressor {#safeds.ml.classical.regression.Regressor data-toc-label='Regressor'}
 
 Abstract base class for all regressors.

@@ -27,6 +27,7 @@ import {
     SdsTypeParameter,
 } from '../generated/ast.js';
 import {
+    Class,
     getClassMembers,
     getColumns,
     getEnumVariants,
@@ -441,7 +442,9 @@ export class SafeDsMarkdownGenerator {
     }
 
     private renderPreamble(node: SdsDeclaration, state: DetailsState, kind: string, keyword: string = kind): string {
-        let result = this.renderHeading(node, state, keyword) + '\n';
+        let result = this.renderFrontMatter(node);
+
+        result += this.renderHeading(node, state, keyword) + '\n';
 
         const deprecationWarning = this.renderDeprecationWarning(node, kind);
         if (deprecationWarning) {
@@ -455,6 +458,14 @@ export class SafeDsMarkdownGenerator {
         return result;
     }
 
+    private renderFrontMatter(node: SdsDeclaration): string {
+        if (isSdsClass(node) && Class.isOnlyForTyping(node)) {
+            return `---\nsearch:\n  boost: 0.5\n---\n\n`;
+        }
+
+        return '';
+    }
+
     private renderHeading(node: SdsDeclaration, state: DetailsState, keyword: string): string {
         let result = '#'.repeat(Math.min(state.level, 6));
         result += this.renderMaturity(node);

@@ -102,6 +102,15 @@ export namespace Argument {
     };
 }
 
+export namespace Class {
+    /**
+     * Checks whether the class is only for typing, i.e. whether it has no constructor and no static members.
+     */
+    export const isOnlyForTyping = (node: SdsClass | undefined): boolean => {
+        return isSdsClass(node) && !node.parameterList && !getClassMembers(node).some((it) => isStatic(it));
+    };
+}
+
 export namespace Enum {
     export const isConstant = (node: SdsEnum | undefined): boolean => {
         return Boolean(node) && getEnumVariants(node).every((it) => EnumVariant.isConstant(it));

@@ -18,7 +18,7 @@ import {
     SdsPipeline,
     SdsSchema,
 } from '../generated/ast.js';
-import { getPackageName } from '../helpers/nodeProperties.js';
+import { Class, getPackageName } from '../helpers/nodeProperties.js';
 import { isInPipelineFile, isInStubFile } from '../helpers/fileExtensions.js';
 import { classTypeParameterIsUsedInCorrectPosition } from '../validation/other/declarations/typeParameters.js';
 
@@ -63,7 +63,11 @@ export class SafeDsCompletionProvider extends DefaultCompletionProvider {
                 );
             }
         } else if (isSdsReference(refInfo.container)) {
-            return !this.illegalNodeTypesForReferences.has(description.type);
+            if (this.illegalNodeTypesForReferences.has(description.type)) {
+                return false;
+            } else if (isSdsClass(description.node) && Class.isOnlyForTyping(description.node)) {
+                return false;
+            }
         }
 
         return true;

@@ -252,6 +252,23 @@ describe('SafeDsCompletionProvider', async () => {
                     shouldNotContain: ['g2'],
                 },
             },
+            {
+                testName: 'reference (class only for typing)',
+                code: `
+                    class MyClass1
+                    class MyClass2()
+                    class MyClass3 {
+                        static attr myAttribute: Int
+                    }
+
+                    pipeline myPipeline {
+                        <|>
+                `,
+                expectedLabels: {
+                    shouldContain: ['MyClass2', 'MyClass3'],
+                    shouldNotContain: ['MyClass1'],
+                },
+            },
             {
                 testName: 'type arguments (no prefix)',
                 code: `

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # :warning:{ title="Deprecated" } `#!sds abstract class` MyClass1 {#tests.generation.markdown.classes.deprecated.MyClass1 data-toc-label='MyClass1'}
 
 !!! warning "Deprecated"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass1 {#tests.generation.markdown.classes.documented.MyClass1 data-toc-label='MyClass1'}
 
 Description of MyClass1.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass3 {#tests.generation.markdown.classes.documented.MyClass3 data-toc-label='MyClass3'}
 
 Description of MyClass3.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass5 {#tests.generation.markdown.classes.documented.MyClass5 data-toc-label='MyClass5'}
 
 Description of MyClass5.

@@ -84,6 +84,11 @@ Description of myFunction2.
     @Pure static fun myFunction2()
     ```
 
+---
+search:
+  boost: 0.5
+---
+
 ## `#!sds abstract class` MyClass7 {#tests.generation.markdown.classes.documented.MyClass6.MyClass7 data-toc-label='MyClass7'}
 
 Description of MyClass7.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass7 {#tests.generation.markdown.classes.documented.MyClass7 data-toc-label='MyClass7'}
 
 Description of MyClass7.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass8 {#tests.generation.markdown.classes.documented.MyClass8 data-toc-label='MyClass8'}
 
 Description of MyClass8.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # :test_tube:{ title="Experimental" } `#!sds abstract class` MyClass1 {#tests.generation.markdown.classes.experimental.MyClass1 data-toc-label='MyClass1'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass1 {#tests.generation.markdown.classes.undocumented.MyClass1 data-toc-label='MyClass1'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass3 {#tests.generation.markdown.classes.undocumented.MyClass3 data-toc-label='MyClass3'}
 
 **Type parameters:**

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass5 {#tests.generation.markdown.classes.undocumented.MyClass5 data-toc-label='MyClass5'}
 
 **Parent type:** [`MyClass1`][tests.generation.markdown.classes.undocumented.MyClass1]

@@ -41,6 +41,11 @@
     @Pure static fun myFunction2()
     ```
 
+---
+search:
+  boost: 0.5
+---
+
 ## `#!sds abstract class` MyClass7 {#tests.generation.markdown.classes.undocumented.MyClass6.MyClass7 data-toc-label='MyClass7'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass7 {#tests.generation.markdown.classes.undocumented.MyClass7 data-toc-label='MyClass7'}
 
 Description of MyClass7.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass1 {#tests.generation.markdown.enums.documented.MyClass1 data-toc-label='MyClass1'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass1 {#tests.generation.markdown.functions.documented.MyClass1 data-toc-label='MyClass1'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass2 {#tests.generation.markdown.linkTag.MyClass2 data-toc-label='MyClass2'}
 
 ??? quote "Stub code in `main.sdsstub`"

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass1 {#tests.generation.markdown.multiline.MyClass1 data-toc-label='MyClass1'}
 
 Description of MyClass1.

@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.5
+---
+
 # `#!sds abstract class` MyClass {#tests.generation.markdown.schemas.documented.MyClass data-toc-label='MyClass'}
 
 ??? quote "Stub code in `main.sdsstub`"