@winccoa-tools-pack/npm-winccoa-core 0.1.0-9176c0d

package/dist/utils/winccoa-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-components.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAEpE"}

package/dist/utils/winccoa-localization.d.ts

@@ -0,0 +1,7 @@
+/** Translatess given 'text' string into current user langauge
+ *
+ * TODO: implement localizations
+ *
+ */
+export declare function tr(text: string): string;
+//# sourceMappingURL=winccoa-localization.d.ts.map

package/dist/utils/winccoa-localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-localization.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-localization.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,UAE9B"}

package/dist/utils/winccoa-logging.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=winccoa-logging.d.ts.map

package/dist/utils/winccoa-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-logging.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-logging.ts"],"names":[],"mappings":""}

package/dist/utils/winccoa-paths.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WinCC OA Installation Path Utilities
+ * Handles platform-specific path discovery and component path resolution
+ *
+ * PERFORMANCE OPTIMIZATION:
+ * This module implements aggressive caching to minimize expensive file system
+ * and Windows registry operations. Cached values persist for the lifetime of
+ * the extension.
+ *
+ * IMPORTANT: If WinCC OA is installed or removed while VS Code is running,
+ * the extension must be reloaded (or VS Code restarted) to detect the changes.
+ * This is an acceptable trade-off for the significant performance improvement.
+ *
+ * Cache Strategy:
+ * - Installation paths are cached per version in cachedWinCCOAInstallationPathByVersion
+ * - Available versions list is cached once in cachedAvailableWinCCOAVersions
+ * - Both caches persist until extension reload/restart
+ *
+ * @author mPokornyETM
+ * @performance Caching reduces registry queries and file system operations by ~95%
+ */
+/**
+ * Finds the WinCC OA installation path for a given version
+ *
+ * CACHED: This function caches results per version. First lookup for each version
+ * performs registry query (Windows) or file system check (Linux). Subsequent
+ * lookups return cached value immediately.
+ *
+ * @param version - WinCC OA version (e.g., "3.20", "3.21")
+ * @returns Installation path or null if not found
+ * @performance First call per version: ~50-100ms, subsequent calls: <1ms
+ */
+export declare function getWinCCOAInstallationPathByVersion(version: string): string | null;
+/**
+ * Gets available WinCC OA versions installed on the system
+ *
+ * CACHED: This function caches its result on first call. Subsequent calls
+ * return the cached value immediately without any file system or registry access.
+ *
+ * @returns Array of version strings sorted from highest to lowest
+ * @performance First call: ~100-200ms, subsequent calls: <1ms
+ */
+export declare function getAvailableWinCCOAVersions(): string[];
+/**
+ * Gets available WinCC OA versions on Windows
+ * @returns Array of version strings sorted from highest to lowest
+ */
+export declare function getWindowsAvailableVersions(): string[];
+//# sourceMappingURL=winccoa-paths.d.ts.map

package/dist/utils/winccoa-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-paths.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAiBH;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBlF;AA2DD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAetD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAwBtD"}

package/dist/utils/winccoa-project-environment.d.ts

@@ -0,0 +1,34 @@
+import { ProjEnvProject } from '../types/project/ProjEnvProject';
+/**
+ * Finds and returns the ProjEnvProject instance for a given file or folder path
+ * by checking all registered projects.
+ * @param selectedPath - The file or folder path to check
+ * @returns ProjEnvProject instance if found, undefined otherwise
+ */
+export declare function getProjectByProjectPath(selectedPath: string): Promise<ProjEnvProject | undefined>;
+/**
+ * Return a list of all registered projects.
+ * Creates ProjEnvProject instances from the Windows registry entries.
+ */
+export declare function getRegisteredProjects(): Promise<ProjEnvProject[]>;
+/**Returns all running projects locate on the locale host
+ */
+export declare function getRunningProjects(): Promise<ProjEnvProject[]>;
+/**Returns all runnable projects locate on the locale host*/
+export declare function getRunnableProjects(): Promise<ProjEnvProject[]>;
+/**Returns all current projects locate on the locale host.
+ * A current project is the one that is currently active in WinCC OA.
+ * Note: per WinCC OA, there can be only one current project at a time.
+ * However, this function returns an array because you can have multiple WinCC OA installations
+ */
+export declare function getCurrentProjects(): Promise<ProjEnvProject[]>;
+/** Export default object with all functions */
+declare const _default: {
+    getRegisteredProjects: typeof getRegisteredProjects;
+    getRunningProjects: typeof getRunningProjects;
+    getRunnableProjects: typeof getRunnableProjects;
+    getCurrentProjects: typeof getCurrentProjects;
+    getProjectByProjectPath: typeof getProjectByProjectPath;
+};
+export default _default;
+//# sourceMappingURL=winccoa-project-environment.d.ts.map

package/dist/utils/winccoa-project-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-project-environment.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-project-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;;;;GAKG;AACH,wBAAsB,uBAAuB,CACzC,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAIrC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAyBvE;AAED;GACG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpE;AAED,4DAA4D;AAC5D,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAErE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAEpE;AAED,+CAA+C;;;;;;;;AAC/C,wBAME"}

package/dist/utils/winccoa-version-info.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WinCC OA Version Information Utilities
+ * Handles version string parsing and comparison
+ *
+ * @author mPokornyETM
+ */
+/**
+ * Parses a version string to a comparable number
+ * Format: major.minor.patch (patch is optional)
+ * @param version - Version string like "3.19" or "3.19.1"
+ * @returns Numeric representation for comparison (e.g., "3.19" -> 30190, "3.19.1" -> 319001)
+ */
+export declare function parseVersionString(version: string): number;
+//# sourceMappingURL=winccoa-version-info.d.ts.map

package/dist/utils/winccoa-version-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winccoa-version-info.d.ts","sourceRoot":"","sources":["../../src/utils/winccoa-version-info.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@winccoa-tools-pack/npm-winccoa-core",
+  "version": "0.1.0-9176c0d",
+  "author": "winccoa-tools-pack",
+  "license": "MIT",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./utils/*": {
+      "import": "./dist/esm/utils/*.js",
+      "require": "./dist/cjs/utils/*.js",
+      "types": "./dist/utils/*.d.ts"
+    },
+    "./types/*": {
+      "import": "./dist/esm/types/*.js",
+      "require": "./dist/cjs/types/*.js",
+      "types": "./dist/types/*.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build:types": "tsc -p tsconfig.build.types.json",
+    "build:cjs": "tsc -p tsconfig.build.cjs.json",
+    "build:esm": "tsc -p tsconfig.build.esm.json",
+    "build": "npm run build:types && npm run build:cjs && npm run build:esm",
+    "compile": "tsc --build",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "lint:md": "markdownlint \"**/*.md\" --ignore node_modules",
+    "lint:md:fix": "markdownlint \"**/*.md\" --ignore node_modules --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "style-check": "npm run lint && npm run format:check && npm run lint:md",
+    "style-fix": "npm run lint:fix && npm run format && npm run lint:md:fix",
+    "test": "npm run style-check && npm run build && npm run test:unit",
+    "test:unit": "node --import tsx scripts/run-node-tests.ts test/unit",
+    "test:integration": "node --import tsx scripts/run-node-tests.ts test/integration",
+    "ci:integration": "npm ci && npm run build && npm run test:integration"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.0.6",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^17.0.0",
+    "markdownlint": "^0.40.0",
+    "markdownlint-cli": "^0.47.0",
+    "prettier": "^3.8.0",
+    "ts-node": "^10.9.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.2.0",
+    "typescript-eslint": "^8.53.0"
+  },
+  "config": {
+    "winccoaImage": "mpokornyetm/winccoa-tools-pack-npm-winccoa-core:npm-winccoa-core"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}