feat: annotation relevant lsp package (#535)

* feat: new annotation lsp package

* feat: commit just to trigger rebuild

* fix: yarn lock file fix

* fix: yarn install fix

* feat: lsp diagnostics enhancement and coverage fix

* fix: coverage fix

* fix: failing linter tests and other improvements

* fix: diagnostics improvement, other corrections

* fix: webpack bundling for module loader

* feat: diagnostics improvement, partial refactoring

* fix: code clean up

* fix: work on pr comments

* feat: i18n support

* feat: manual testcases

* fix: work on PR comments

* fix: pr comments

* fix: fe module marked as private

BREAKING CHANGE: introduce context by pr #523

Co-authored-by: Klaus Keller <klaus.keller@sap.com>

Author: vadson71

.vscode/launch.json

@@ -51,6 +51,28 @@
       "internalConsoleOptions": "neverOpen",
       "disableOptimisticBPs": true,
       "cwd": "${workspaceFolder}/packages/context"
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "fe: run current file",
+      "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
+      "args": ["${fileBasenameNoExtension}"],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "disableOptimisticBPs": true,
+      "cwd": "${workspaceFolder}/packages/fe"
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "semantic-model: run current file",
+      "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
+      "args": ["${fileBasenameNoExtension}"],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "disableOptimisticBPs": true,
+      "cwd": "${workspaceFolder}/packages/semantic-model"
     }
   ]
 }

package.json

@@ -40,7 +40,7 @@
     "@types/deep-equal-in-any-order": "1.0.1",
     "@types/fs-extra": "9.0.11",
     "@types/klaw-sync": "6.0.0",
-    "@types/lodash": "4.14.168",
+    "@types/lodash": "4.14.166",
     "@types/mocha": "9.1.1",
     "@types/rimraf": "3.0.0",
     "@types/sinon": "9.0.10",
@@ -58,6 +58,7 @@
     "fs-extra": "10.1.0",
     "glob": "7.1.6",
     "husky": "8.0.1",
+    "i18next": "19.0.2",
     "klaw-sync": "6.0.0",
     "lerna": "6.0.3",
     "lint-staged": "10.5.3",

packages/context/api.d.ts

@@ -15,6 +15,7 @@ export {
   reactOnXmlFileChange,
   reactOnPackageJson,
   cache,
+  DEFAULT_I18N_NAMESPACE,
 } from "./src/api";
 
 export type {

packages/context/package.json

@@ -33,7 +33,7 @@
   "devDependencies": {
     "@sap-ux/vocabularies-types": "0.6.8",
     "@types/js-yaml": "4.0.5",
-    "@types/lodash": "4.14.166",
+    "@types/lodash": "4.14.168",
     "@types/node-fetch": "2.5.10",
     "@types/semver": "7.3.12",
     "@ui5-language-assistant/semantic-model-types": "3.3.1",

packages/context/src/api.ts

@@ -46,3 +46,5 @@ export async function getContext(
   const customViewId = await getCustomViewId(documentPath);
   return { manifestDetails, yamlDetails, ui5Model, services, customViewId };
 }
+
+export const DEFAULT_I18N_NAMESPACE = "translation";

packages/context/src/fetch.ts

@@ -1,13 +1,38 @@
-// eslint-disable-next-line  @typescript-eslint/no-explicit-any
-const importDynamic = new Function("modulePath", "return import(modulePath)");
-// eslint-disable-next-line  @typescript-eslint/no-explicit-any
-const nodeFetch = async (...args: any[]) => {
-  const module = await importDynamic("node-fetch");
-  return module.default(...args);
-};
-import { RequestInfo, RequestInit, Response } from "node-fetch";
-import HttpsProxyAgent from "https-proxy-agent";
 import { getProxyForUrl } from "proxy-from-env";
+import HttpsProxyAgent from "https-proxy-agent";
+import { RequestInfo, RequestInit, Response } from "node-fetch";
+
+export type FetcherType = (
+  url: RequestInfo,
+  init?: RequestInit | undefined
+) => Promise<Response>;
+
+/**
+ * Promise which prepares dynamic node fetcher function and holds it within once resolved
+ */
+const nodeFetchCached = new Promise<FetcherType>((done, reject) => {
+  (async () => {
+    let nodeFetch: FetcherType;
+    try {
+      // this should work when bundled
+      nodeFetch = (await import("node-fetch")).default;
+    } catch (e) {
+      // trying to load dynamically
+      const importDynamic = new Function(
+        "modulePath",
+        "return import(modulePath)"
+      );
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      nodeFetch = async (...args: any[]) => {
+        const module = await importDynamic("node-fetch");
+        return module.default(...args);
+      };
+    }
+    return nodeFetch;
+  })()
+    .then((result) => done(result))
+    .catch((error) => reject(error));
+});
 
 /**
  * Wrapper for the node-fetch API to utilize a proxy if needed
@@ -28,6 +53,8 @@ export default async function fetch(
       agent: HttpsProxyAgent(proxy),
     });
   }
-  // call the node-fetch API
+
+  // call the cached node-fetch API
+  const nodeFetch = await nodeFetchCached;
   return nodeFetch(url, init);
 }

packages/fe/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

packages/fe/CONTRIBUTING.md

@@ -0,0 +1,4 @@
+# Contribution Guide
+
+This package does not have any unique development flows.
+Please see the top level [Contribution Guide](../../CONTRIBUTING.md).

packages/fe/README.md

@@ -0,0 +1,32 @@
+[![npm (scoped)](https://img.shields.io/npm/v/@ui5-language-assistant/context.svg)](https://www.npmjs.com/package/@ui5-language-assistant/fe)
+
+# @ui5-language-assistant/fe
+
+UI5 language assistant extension with LSP for annotation-relevant building blocks
+
+## Installation
+
+With npm:
+
+- `npm install @ui5-language-assistant/fe`
+
+With Yarn:
+
+- `yarn add @ui5-language-assistant/fe`
+
+## Usage
+
+This package only exposes programmatic APIs, import the package and use the exported APIs
+defined in [api.d.ts](./api.d.ts).
+
+## Support
+
+Please open [issues](https://github.com/SAP/ui5-language-assistant/issues) on github.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## Licensing
+
+Copyright 2022 SAP SE. Please see our [LICENSE](../../LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/SAP/ui5-language-assistant).

packages/fe/api.d.ts

@@ -0,0 +1,34 @@
+import type {
+  BaseUI5XMLViewIssue,
+  UI5ValidatorsConfig,
+} from "@ui5-language-assistant/xml-views-validation";
+import type { Context } from "@ui5-language-assistant/context";
+import type {
+  TextDocumentPositionParams,
+  CompletionItem,
+} from "vscode-languageserver-protocol";
+import type { CstNode, IToken } from "chevrotain";
+import type { XMLDocument } from "@xml-tools/ast";
+import type { TextDocument } from "vscode-languageserver-textdocument";
+import type { Settings } from "@ui5-language-assistant/settings";
+import type { AnnotationIssue } from "./src/types/issues";
+
+export type { AnnotationIssue } from "./src/types/issues";
+
+export declare const defaultValidators: UI5ValidatorsConfig<AnnotationIssue>;
+
+export function getCompletionItems(opts: {
+  context: Context;
+  textDocumentPosition: TextDocumentPositionParams;
+  document: TextDocument;
+  documentSettings: Settings;
+  cst: CstNode;
+  tokenVector: IToken[];
+  ast: XMLDocument;
+}): CompletionItem[];
+
+export function isAnnotationIssue<T extends BaseUI5XMLViewIssue>(
+  issue: AnnotationIssue | T
+): issue is AnnotationIssue;
+
+export function initI18n(i18nInstance: i18n): void;