powerbi-visuals-tools 5.1.0 → 5.2.0-beta.1

package/Changelog.md

@@ -2,6 +2,9 @@
 
 This page contains information about changes to the PowerBI Visual Tools (pbiviz).
 
+## 5.2.0
+* Integrated PAC validation
+
 ## 5.1.0
 * New flag `--skip-api` to skip verifying api version. It might produce different errors in visual, so use it only in some specific cases (ex. installing something during the build process brakes packages managed by monorepo managers).
 * New flag `--all-locales` to disable optimization using localization loader. It's recommended not to use this flag because all locales take a huge amount of package size. If you need just a few of them follow [this guide](https://learn.microsoft.com/en-us/power-bi/developer/visuals/localization?tabs=English#step-5---add-a-resources-file-for-each-language). In this case, only declared in stringResources locales will be added to your visual package.

package/bin/pbiviz.js

@@ -97,4 +97,4 @@ pbiviz
         CommandManager.package(options, rootPath);
     });
 
-program.parse(process.argv);
+program.parse(process.argv);

package/certs/PowerBICustomVisualTest_private.key

@@ -1,28 +1,28 @@
 -----BEGIN PRIVATE KEY-----
-MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDEKuHsNka9n8H9
-28W1ARv0lBkZYfQMxNK7IOSWopNp+l2w13ns3/Uz6IMB7iRqSCR8i8p0vQHatZP+
-0o8QY2NkMgaRiXlSH48GxmaRfhdTaPv0r2WTB7jibl3c5xEunjL3cvO2F8qVh+8S
-SybpY2v4RCqHCAg2o2ZyAkXJk+Rkh/TIOcmQzbQk8SLkuFIPBAXObS8SxZ03/VXJ
-x+5iYYqC28TJAkHh8ZSknpkIRCDfV5RzRkwWXvP70aY0Mm1T7rETBh9yDlThZbg5
-9WWYcyqZUn0PgNmM/VWwAYWD16/X832BFYFMbFrANv8CFchtZ58aLcAd9hXarpVT
-2UxFQpOPAgMBAAECggEADMGTyA4jfX3frzKqYZcn3+NS2oFceF7C1qOl7wcKuk/V
-5dkCjF0Sjy87IwCpt4uSFn3p9WYRB82E89jHWtPLs8lDqhUcIYinKVP0ztiPNb+p
-mq4JLI11AAHDSB5yfJXm+eECE2uVTdygDDrSK0e+zqRyy4MXMvkJ1rdqcwLootd4
-YQ2HaGDznr1DyAswfjgwJDut2gmast8GdKcCQZqk52VtRMs8zNY/O22HFRP1nQQZ
-o0vTGnn1y4Yw8r3psDrIK/lKoYSKgX3ljd1dP3B9SF7Nb/pxRgkeK/b21xJXQl+Y
-xcFOFe2pvGLCYyJXbdO6TyKAgNIMajmARrJ4/HLQ2QKBgQDErYQVb3urMcQYhuMF
-QedZ6rKJn8IhqXA41qnfV4yPS+UOwpi4IJh4SZkHfCFaqidoG9BDNAAWQYBTIrUo
-KLNMhWh5xcSPETN6LotdxbaAzkp3/vo6+Gkxhbk4S0nOD6TDbatXuaW412X2bHLP
-1qs1bYYDJ/zsyPTg2mPzJo9JAwKBgQD/Vfb49NOlnK51/oDULOIkJS0yB/DWLKxP
-Xjwt9ja5sgxRA3A69V3AhwcZh8nJ2n/EaoQB0WMI46q9rWFfJpktuT03xpGTT+bZ
-6+wTgjfng4rdWeYoA0PQj+7y2lU8WIFRQHucxjs1jz3qLN6/T8NuzwbfD7r5Ml5j
-TrQPhLY3hQKBgQCLaxj7fPikhXWlkVCytGIEimufRWF/LTZBBGKM0Onx1nH8QZOy
-ymBqvHk/Jg4a0A15LmY2jVEWdb46sJrMafWX4+YIlFnetOnRzda7VWEm85U0dMn7
-LYacNVf0AOLDsLEyW7afTBme6wn7YisNC/Z3vDjIWftf+qAkGIvLnGTr8wKBgBIW
-4gdjOPdbsVR0smXVxDOxWpFX1K0nvxFkaLkM33Wqcoruxm224mx4ZH1fjGE7lJ+y
-uCV00yJXFsqXVPWrw2Bk5jxkWf3oxD8eIryDFjjVreneq5qcGJrXB6O26iD7WDYM
-bnV96cXynv1PLny5Ruw7yI3XDHUJJ3y7n7AVw98NAoGAGH8vZfDKQxicfS3FuRs+
-Wt6ALNTJ/SQXLzg0/9G71YbI4Kxcr9g+OS01jShD5PUbBEc92YQJxFNpsYK5PeOF
-N0Wm3Y2qDANmI6OPN9G6YJq+JDPPLyAXMSYFIz8p8nZDF7WxJZGLe/2wl6oXf704
-iOPJDmLH53+a0xNA0vrtB3o=
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCrmhAfEgcfLpAN
+tHUf8p7wKXzP86KDB74LM4XW+yVjXl1rbNOzxOxhI2xSXhHkX1yPwiimP6DIB5Pr
+7/yNDBVexIcPsh29mMGxhiBWyPZRW0XZ1QnsgwhhELi/6T2feVpk1nhZ33vhG1XX
+0a9abWoIdjtiFVUJ6JTxfxQilSgdRrrPd+y7+8WLFCNd2kPkLgbsRxqH3D46siG6
+uCiQxwmHVxjDaTAfp9dxiDkdzP3BqF5vHjPD3Vx/Xo9Lp/D+ACgcrzksMAU1X+ew
+1uEN8iVDIBotYsChccZcNeJgDdaJNURLst77jFG/KwQSHIcnS2mmwPuh5vKA7mXr
+26WQVQvJAgMBAAECggEABw/aKmiBJUaoPD4mefalFTxZ2Ut9GcAYRrOmO4Uz93wf
+I1V+prBma27MIt128PNpNrZ+b9gLaiFLXxDDZOZqnI8BLBN6ue5G81hcwpbhhyfW
+ztqqSRgmi0BnSqji5bTBFEhcun3HW58BaCuGOEDA4IwFZdlmTw1J+uBtpVOG1kyH
+wksa8jG9Bt1opgMB8R0E+ujPv8MMRmA/H7VG+h3ms6eoRdfMK0F+TVSCF8C+Le0Y
+UZ6wr8LMNsxYFFlP0SCNewsWO2zfo3M2wMPJp7ZVGF2yHZXLxjPNGNHXiw7w/Ycs
+yOOhJjPkiApBKf+7cTfzwBycs6NNTtjCL2zbCU4TkQKBgQDjvdqVbMsHeAW2NVCv
+k6f+Q2FrVzqL4NtbJKncXYAFeSzt8VsZyqjKv6xJVAgmu8iUunISrIEVd3OvN5wn
+1TB7TEcNOW58kS++4zCS6kExUSA+8NpgSn9pXbZ40rN/IXbUSY1/9k2eCUVHT6fe
+uV+vLFFIFutypC9Q6oDNDLxdeQKBgQDA5PHIwaANqHPryJxw4vCEFa6cx9Y4CRWx
+7wotxecnN6lcg7NmKmDOd+/mknNm7XQ4vYjZhe0yd8snAwW7F++b5MO58xoWQtrg
+Fe4upGb+bERNcdB18xvUh2l6s87vyNSFHSOFQ9T92z6bAPYwKfwa2LAdEaLi0iED
+9TSQw4+c0QKBgBfqPePnEsLsBZ2Gp7xoQwHeTYKaHFnH+QDvLq8nWmQ4v1EVQT3K
+HEN+MTdaDakTmxKTKZtwZfW9H3bM3icIqhiof+WRnFqUXHEtJlKnKsVlAX/ahvQJ
+nquP3bN+XL8C4pmUR7miQbBQxOeiI7yttrCMdNSfI4ZcW2Oh3Hir17PxAoGBAJjN
+xGtQV0X6h7nkdWlHnVhFBMnV1HEXYURPJDUWbQK4KUXMXrU0JPPqNvTkVt7WhBbe
+riYC3d/43cnNryCC2aEZG6OWXLf9xf114fS4743knkbrPkPxjb5SdtBo2ClDYncA
+mj7beUKQB4wqutt0pu1tcjXU3r/nzZehCz8SbBXBAoGBAMl40ZQiBJGxQlE7iWlP
+yrgZKzQEZTPF49TI3Fz3hxLKaSfdQL9xnSClh6EJ7CXyhv1ZjSMCup4EteUIEi7L
+aPX6zDGXiFagH+gcgFxWilG4JwkfrQuK7In146CGjSDuOttwtls0FhG1ghOdEvpf
+KpZmyVGab0l9DzNFJdCd0TK/
 -----END PRIVATE KEY-----

package/certs/PowerBICustomVisualTest_public.crt

@@ -1,19 +1,19 @@
 -----BEGIN CERTIFICATE-----
-MIIDCTCCAfGgAwIBAgIUdiNbul8BmWrJiP6z3MbFof3u/6AwDQYJKoZIhvcNAQEL
-BQAwFDESMBAGA1UEAwwJbG9jYWxob3N0MB4XDTIzMDgyMTE4MTM1NVoXDTI0MDgy
-MDE4MTM1NVowFDESMBAGA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEF
-AAOCAQ8AMIIBCgKCAQEAxCrh7DZGvZ/B/dvFtQEb9JQZGWH0DMTSuyDklqKTafpd
-sNd57N/1M+iDAe4kakgkfIvKdL0B2rWT/tKPEGNjZDIGkYl5Uh+PBsZmkX4XU2j7
-9K9lkwe44m5d3OcRLp4y93LzthfKlYfvEksm6WNr+EQqhwgINqNmcgJFyZPkZIf0
-yDnJkM20JPEi5LhSDwQFzm0vEsWdN/1VycfuYmGKgtvEyQJB4fGUpJ6ZCEQg31eU
-c0ZMFl7z+9GmNDJtU+6xEwYfcg5U4WW4OfVlmHMqmVJ9D4DZjP1VsAGFg9ev1/N9
-gRWBTGxawDb/AhXIbWefGi3AHfYV2q6VU9lMRUKTjwIDAQABo1MwUTAdBgNVHQ4E
-FgQU3LMs3hmPwHpL5sqTzN2RWogd2/kwHwYDVR0jBBgwFoAU3LMs3hmPwHpL5sqT
-zN2RWogd2/kwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEARQpD
-lZRixXXot7qr1ygS1iSDm8CODWhQca8V1T80TPRFNlX3beQPkbCndsZBa/PoXN21
-D2QBScsXgMaVEBB5FVmKAVXf/e2KoOUZ9Au8Oko9sKrzUalirM2YlqYbgwiAI0wR
-1rTBm+aNsP8xFVDyYrbFe60rtuhduFDvAWi2p9ywQdRuW5I5DyLMBuqOVWo7vn0I
-3hJ4FM3r4Lb/8LUrFVjxtLVMEqC1nlpt5FgyjpuN/adYICBQFqtHCiirXRoyfdL8
-7TZts6ychG5yhoB0fixYnExQfwIMeaqIKiuwqcZoRB2EjTKBTNBeXfxISNR6HPnq
-a0Q0pHZGEGnT+S8mFA==
+MIIDCTCCAfGgAwIBAgIUVyYTM/kwgl4YG+Mo6bsxRO2GhZIwDQYJKoZIhvcNAQEL
+BQAwFDESMBAGA1UEAwwJbG9jYWxob3N0MB4XDTIzMDgyMjEwMTM1NFoXDTI0MDgy
+MTEwMTM1NFowFDESMBAGA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEF
+AAOCAQ8AMIIBCgKCAQEAq5oQHxIHHy6QDbR1H/Ke8Cl8z/Oigwe+CzOF1vslY15d
+a2zTs8TsYSNsUl4R5F9cj8Iopj+gyAeT6+/8jQwVXsSHD7IdvZjBsYYgVsj2UVtF
+2dUJ7IMIYRC4v+k9n3laZNZ4Wd974RtV19GvWm1qCHY7YhVVCeiU8X8UIpUoHUa6
+z3fsu/vFixQjXdpD5C4G7Ecah9w+OrIhurgokMcJh1cYw2kwH6fXcYg5Hcz9wahe
+bx4zw91cf16PS6fw/gAoHK85LDAFNV/nsNbhDfIlQyAaLWLAoXHGXDXiYA3WiTVE
+S7Le+4xRvysEEhyHJ0tppsD7oebygO5l69ulkFULyQIDAQABo1MwUTAdBgNVHQ4E
+FgQUSpFymv93oCm2Yr4jgjuqitOhgRIwHwYDVR0jBBgwFoAUSpFymv93oCm2Yr4j
+gjuqitOhgRIwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEALsY1
+NufIewwelamaUb/50cbPMKEQkTpOYnMP//DFWcw1yGzcPNuB4sPKgLhhX1ggknIr
+RWaj+6Oow4KVKcPDdG6r5P5IEl6hn+432KM4Gu9BQasg6seReO4uf9chV9sdV06z
+d4jgXIFxIw/1PVMEPn9qj079HNMJuRcpyxGwbzeeRhu3WZpO4qlIx2/MpucARtSU
+d1f0/IOo6A/yASrn9Y5fZ2rOxj3mk4Yu0z1+WpsUVLV/ES/mxgIIRwlxp9z6F5r2
+tpEyJxM+XoUOn4mTe6xIgfM8DVS910p6Yne+z0xSnXZpVU8sEg0RtZH6kfSCc9Vp
+JwtG3xq1/oB8KNDAXw==
 -----END CERTIFICATE-----

package/lib/CommandManager.js

@@ -18,6 +18,7 @@ export default class CommandManager {
         const visualManager = new VisualManager(rootPath);
         await visualManager
             .prepareVisual()
+            .validateVisual()
             .initializeWebpack(webpackOptions);
         visualManager.startWebpackServer(options.drop);
     }
@@ -39,6 +40,7 @@ export default class CommandManager {
         };
         new VisualManager(rootPath)
             .prepareVisual()
+            .validateVisual()
             .initializeWebpack(webpackOptions)
             .then(visualManager => visualManager.generatePackage());
     }

package/lib/FeatureManager.js

@@ -0,0 +1,43 @@
+import { Severity } from "./features/FeatureTypes.js";
+import * as features from "./features/index.js";
+export var Status;
+(function (Status) {
+    Status[Status["Success"] = 0] = "Success";
+    Status[Status["Error"] = 1] = "Error";
+})(Status || (Status = {}));
+export class FeatureManager {
+    features = Object.keys(features).map(key => features[key]);
+    validate(stage, sourceInstance) {
+        const result = {
+            status: Status.Success,
+            logs: {
+                errors: [],
+                warnings: [],
+                info: [],
+                deprecation: []
+            }
+        };
+        this.features
+            .filter(feature => feature.stage == stage)
+            .filter(feature => feature.visualFeatureType & sourceInstance.visualFeatureType)
+            .filter(feature => !feature.isSupported(sourceInstance))
+            .forEach(({ errorMessage, severity }) => {
+            switch (severity) {
+                case Severity.Error:
+                    result.status = Status.Error;
+                    result.logs.errors.push(errorMessage);
+                    break;
+                case Severity.Warning:
+                    result.logs.warnings.push(errorMessage);
+                    break;
+                case Severity.Info:
+                    result.logs.info.push(errorMessage);
+                    break;
+                case Severity.Deprecation:
+                    result.logs.deprecation.push(errorMessage);
+                    break;
+            }
+        });
+        return result;
+    }
+}

package/lib/Package.js

@@ -0,0 +1,46 @@
+/*
+ *  Power BI Visual CLI
+ *
+ *  Copyright (c) Microsoft Corporation
+ *  All rights reserved.
+ *  MIT License
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the ""Software""), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in
+ *  all copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ *  THE SOFTWARE.
+ */
+"use strict";
+import isMatch from "lodash.ismatch";
+/**
+ * Represents an instance of a visual package based on file path
+ */
+export default class Package {
+    sourceCode;
+    capabilities;
+    visualFeatureType;
+    constructor(sourceCode, capabilities, visualFeatureType) {
+        this.sourceCode = sourceCode;
+        this.capabilities = capabilities;
+        this.visualFeatureType = visualFeatureType;
+    }
+    contain(keyword) {
+        return this.sourceCode.includes(keyword);
+    }
+    isCapabilityEnabled(expectedObject) {
+        return isMatch(this.capabilities, expectedObject);
+    }
+}

package/lib/Visual.js

@@ -0,0 +1,34 @@
+import { compareVersions } from "compare-versions";
+import { VisualFeatureType } from "./features/FeatureTypes.js";
+export class Visual {
+    visualFeatureType;
+    capabilities;
+    config;
+    packageJSON;
+    visualVersion;
+    constructor(capabilities, config, packageJson) {
+        this.capabilities = capabilities;
+        this.config = config;
+        this.visualFeatureType = this.getVisualFeatureType();
+        this.packageJSON = packageJson;
+        this.visualVersion = config.visual.version;
+    }
+    doesAPIVersionMatch(minAPIversion) {
+        return compareVersions(this.config.apiVersion ?? minAPIversion, minAPIversion) !== -1;
+    }
+    doesESLlintSupported() {
+        return Object.entries(this.packageJSON.scripts).some(([, value]) => value.includes("eslint"));
+    }
+    isVisualVersionValid(length) {
+        return this.visualVersion.split(".").length === length;
+    }
+    getVisualFeatureType() {
+        const isMatrixSupported = this.capabilities?.dataViewMappings?.some(dataView => dataView.matrix);
+        const isSlicer = Boolean(this.capabilities?.objects?.general?.properties?.filter?.type?.filter);
+        let type = isSlicer ? VisualFeatureType.Slicer : VisualFeatureType.NonSlicer;
+        if (isMatrixSupported) {
+            type = type | VisualFeatureType.Matrix;
+        }
+        return type;
+    }
+}

package/lib/VisualManager.js

@@ -33,7 +33,12 @@ import ConsoleWriter from './ConsoleWriter.js';
 import VisualGenerator from './VisualGenerator.js';
 import { readJsonFromRoot, readJsonFromVisual } from './utils.js';
 import WebpackWrap from './WebPackWrap.js';
+import Package from './Package.js';
+import { Visual } from "./Visual.js";
+import { FeatureManager, Status } from "./FeatureManager.js";
+import { Severity, Stage } from "./features/FeatureTypes.js";
 import TemplateFetcher from "./TemplateFetcher.js";
+const globalConfig = readJsonFromRoot('config.json');
 const PBIVIZ_FILE = 'pbiviz.json';
 /**
  * Represents an instance of a visual package based on file path
@@ -41,7 +46,11 @@ const PBIVIZ_FILE = 'pbiviz.json';
 export default class VisualManager {
     basePath;
     pbivizConfig;
+    capabilities;
     webpackConfig;
+    visual;
+    package;
+    featureManager;
     compiler;
     webpackDevServer;
     constructor(rootPath) {
@@ -50,6 +59,7 @@ export default class VisualManager {
     prepareVisual() {
         if (this.doesPBIVIZExists()) {
             this.pbivizConfig = readJsonFromVisual(PBIVIZ_FILE, this.basePath);
+            this.createVisualInstance();
         }
         else {
             ConsoleWriter.error(PBIVIZ_FILE + ' not found. You must be in the root of a visual project to run this command.');
@@ -57,6 +67,11 @@ export default class VisualManager {
         }
         return this;
     }
+    createVisualInstance() {
+        this.capabilities = readJsonFromVisual("capabilities.json", this.basePath);
+        const packageJSON = readJsonFromVisual("package.json", this.basePath);
+        this.visual = new Visual(this.capabilities, this.pbivizConfig, packageJSON);
+    }
     async initializeWebpack(webpackOptions) {
         const webpackWrap = new WebpackWrap();
         this.webpackConfig = await webpackWrap.generateWebpackConfig(this, webpackOptions);
@@ -65,6 +80,9 @@ export default class VisualManager {
     }
     generatePackage() {
         const callback = (err, stats) => {
+            this.createPackageInstance();
+            const logs = this.validatePackage();
+            this.outputResults(logs);
             this.parseCompilationResults(err, stats);
         };
         this.compiler.run(callback);
@@ -96,6 +114,32 @@ export default class VisualManager {
             process.exit(1);
         }
     }
+    validateVisual() {
+        this.featureManager = new FeatureManager();
+        const { status, logs } = this.featureManager.validate(Stage.PreBuild, this.visual);
+        this.outputResults(logs);
+        if (status === Status.Error) {
+            process.exit(1);
+        }
+        return this;
+    }
+    validatePackage() {
+        const featureManager = new FeatureManager();
+        const { logs } = featureManager.validate(Stage.PostBuild, this.package);
+        return logs;
+    }
+    outputResults({ errors, deprecation, warnings, info }) {
+        const featuresTotalLog = {
+            errors: `Visual doesn't support some features required for all custom visuals:`,
+            deprecation: `Some features are going to be required soon, please update the visual:`,
+            warn: `Visual doesn't support some features recommended for all custom visuals:`,
+            info: `Visual can be improved by adding some features:`
+        };
+        this.outputLogsWithHeadMessage(featuresTotalLog.errors, errors, Severity.Error);
+        this.outputLogsWithHeadMessage(featuresTotalLog.deprecation, deprecation, Severity.Deprecation);
+        this.outputLogsWithHeadMessage(featuresTotalLog.warn, warnings, Severity.Warning);
+        this.outputLogsWithHeadMessage(featuresTotalLog.info, info, Severity.Info);
+    }
     displayInfo() {
         if (this.pbivizConfig) {
             ConsoleWriter.infoTable(this.pbivizConfig);
@@ -178,6 +222,11 @@ export default class VisualManager {
             this.webpackDevServer = null;
         }
     }
+    createPackageInstance() {
+        const pathToJSContent = path.join((this.pbivizConfig.build ?? globalConfig.build).dropFolder, "visual.js");
+        const sourceCode = fs.readFileSync(pathToJSContent, "utf8");
+        this.package = new Package(sourceCode, this.capabilities, this.visual.visualFeatureType);
+    }
     parseCompilationResults(err, stats) {
         ConsoleWriter.blank();
         if (err) {
@@ -191,4 +240,27 @@ export default class VisualManager {
             ConsoleWriter.done('Build completed successfully');
         }
     }
+    outputLogsWithHeadMessage(headMessage, logs, severity) {
+        if (!logs.length) {
+            return;
+        }
+        let outputLog;
+        switch (severity) {
+            case Severity.Error || Severity.Deprecation:
+                outputLog = ConsoleWriter.error;
+                break;
+            case Severity.Warning:
+                outputLog = ConsoleWriter.warning;
+                break;
+            default:
+                outputLog = ConsoleWriter.info;
+                break;
+        }
+        if (headMessage) {
+            outputLog(headMessage);
+            ConsoleWriter.blank();
+        }
+        logs.forEach(error => outputLog(error));
+        ConsoleWriter.blank();
+    }
 }

package/lib/features/APIVersion.js

@@ -0,0 +1,16 @@
+import { readJsonFromRoot } from "../utils.js";
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class APIVersion {
+    static featureName = "Api";
+    static severity = Severity.Error;
+    static stage = Stage.PreBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer;
+    static minAPIversion;
+    static errorMessage;
+    static isSupported(visual) {
+        const globalConfig = readJsonFromRoot('config.json');
+        this.minAPIversion = globalConfig.constants.minAPIversion;
+        this.errorMessage = `API version must be at least ${this.minAPIversion}.`;
+        return visual.doesAPIVersionMatch(this.minAPIversion);
+    }
+}

package/lib/features/AdvancedEditMode.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class AdvancedEditMode {
+    static featureName = "Advanced Edit Mode";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/advanced-edit-mode";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return !packageInstance.isCapabilityEnabled({ advancedEditMode: 0 }); // 0 - Advanced edit mode is disabled
+    }
+}

package/lib/features/AllowInteractions.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class AllowInteractions {
+    static featureName = "Allow Interactions";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/visuals-interactions";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain('.allowInteractions');
+    }
+}

package/lib/features/AnalyticsPane.js

@@ -0,0 +1,16 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class AnalyticsPane {
+    static featureName = "Analytics Pane";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/analytics-pane";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return (packageInstance.isCapabilityEnabled({
+            objects: {
+                objectCategory: 2
+            }
+        }) ||
+            packageInstance.contain("analyticsPane=true"));
+    }
+}

package/lib/features/BaseFeature.js

@@ -0,0 +1,11 @@
+export default class BaseFeature {
+    static severity;
+    static stage;
+    static visualFeatureType;
+    static featureName;
+    static documentationLink;
+    static get errorMessage() {
+        return `${this.featureName} - ${this.documentationLink}`;
+    }
+    static isSupported() { }
+}

package/lib/features/Bookmarks.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class Bookmarks {
+    static featureName = "Bookmarks";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/bookmarks-support";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain("applySelectionFromFilter") || packageInstance.contain("registerOnSelectCallback");
+    }
+}

package/lib/features/ColorPalette.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class ColorPalette {
+    static featureName = "Color Palette";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/add-colors-power-bi-visual";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".colorPalette");
+    }
+}

package/lib/features/ConditionalFormatting.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class ConditionalFormatting {
+    static featureName = "Conditional Formatting";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/conditional-format";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".createDataViewWildcardSelector");
+    }
+}

package/lib/features/ContextMenu.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class ContextMenu {
+    static featureName = "Context Menu";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/context-menu";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".showContextMenu");
+    }
+}

package/lib/features/DrillDown.js

@@ -0,0 +1,15 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class DrillDown {
+    static featureName = "Drill Down";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/drill-down-support";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({
+            drilldown: {
+                roles: []
+            }
+        });
+    }
+}

package/lib/features/ESLint.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class ESLint {
+    static featureName = "ESLint";
+    static documentationLink = "https://github.com/microsoft/eslint-plugin-powerbi-visuals";
+    static severity = Severity.Error;
+    static stage = Stage.PreBuild;
+    static visualFeatureType = VisualFeatureType.All;
+    static isSupported(visual) {
+        return visual.doesESLlintSupported();
+    }
+}

package/lib/features/FeatureTypes.js

@@ -0,0 +1,23 @@
+export var Severity;
+(function (Severity) {
+    Severity["Error"] = "error";
+    Severity["Deprecation"] = "deprecation";
+    Severity["Warning"] = "warning";
+    Severity["Info"] = "info";
+})(Severity || (Severity = {}));
+export var Stage;
+(function (Stage) {
+    Stage["PreBuild"] = "pre-build";
+    Stage["PostBuild"] = "post-build";
+})(Stage || (Stage = {}));
+export var VisualFeatureType;
+(function (VisualFeatureType) {
+    VisualFeatureType[VisualFeatureType["NonSlicer"] = 2] = "NonSlicer";
+    VisualFeatureType[VisualFeatureType["Slicer"] = 4] = "Slicer";
+    VisualFeatureType[VisualFeatureType["Matrix"] = 8] = "Matrix";
+    VisualFeatureType[VisualFeatureType["All"] = 14] = "All";
+})(VisualFeatureType || (VisualFeatureType = {}));
+// Interaction types: Selection or filter (slicer)
+// Slicer type: Basic, Advanced, Tuple filter, Identity filter
+// Visual Type: TS/JS or R-Visual or RHTML
+// Dataview Type: Single or Matrix or Table or Category or All

package/lib/features/FetchMoreData.js

@@ -0,0 +1,21 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class FetchMoreData {
+    static featureName = "Fetch More Data";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/fetch-more-data";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({
+            dataViewMappings: [
+                {
+                    table: {
+                        rows: {
+                            dataReductionAlgorithm: {}
+                        }
+                    }
+                }
+            ]
+        });
+    }
+}

package/lib/features/FileDownload.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class FileDownload {
+    static featureName = "File Download";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/file-download-api";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".downloadService") && packageInstance.contain(".exportVisualsContent");
+    }
+}

package/lib/features/FormatPane.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class FormatPane {
+    static featureName = "Format Pane";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/format-pane";
+    static severity = Severity.Deprecation;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.All;
+    static isSupported(packageInstance) {
+        return packageInstance.contain("getFormattingModel");
+    }
+}

package/lib/features/HighContrast.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class HighContrast {
+    static featureName = "High Contrast";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/high-contrast-support";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".isHighContrast");
+    }
+}

package/lib/features/HighlightData.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class HighlightData {
+    static featureName = "Highlight Data";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/highlight";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ supportsHighlight: true });
+    }
+}

package/lib/features/KeyboardNavigation.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class KeyboardNavigation {
+    static featureName = "Keyboard Navigation";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/supportskeyboardfocus-feature";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ supportsKeyboardFocus: true });
+    }
+}

package/lib/features/LandingPage.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class LandingPage {
+    static featureName = "Landing Page";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/landing-page";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ supportsLandingPage: true });
+    }
+}

package/lib/features/LaunchURL.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class LaunchURL {
+    static featureName = "Launch URL";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/launch-url";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".launchUrl");
+    }
+}

package/lib/features/LocalStorage.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class LocalStorage {
+    static featureName = "Local Storage";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/local-storage";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".storageService");
+    }
+}

package/lib/features/Localizations.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class Localizations {
+    static featureName = "Localizations";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/localization";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".createLocalizationManager");
+    }
+}

package/lib/features/ModalDialog.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class ModalDialog {
+    static featureName = "Modal Dialog";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/create-display-dialog-box";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".openModalDialog");
+    }
+}

package/lib/features/RenderingEvents.js

@@ -0,0 +1,12 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class RenderingEvents {
+    static featureName = "Rendering Events";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/event-service";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.All;
+    static isSupported(packageInstance) {
+        const keywords = [".eventService", ".renderingStarted", ".renderingFinished"];
+        return !keywords.some(keyword => !packageInstance.contain(keyword));
+    }
+}

package/lib/features/SelectionAcrossVisuals.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class SelectionAcrossVisuals {
+    static featureName = "Selection Across Visuals";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/supportsmultivisualselection-feature";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ supportsMultiVisualSelection: true });
+    }
+}

package/lib/features/SyncSlicer.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class SyncSlicer {
+    static featureName = "Sync Slicer";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/enable-sync-slicers";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ supportsSynchronizingFilterState: true });
+    }
+}

package/lib/features/Tooltips.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class Tooltips {
+    static featureName = "Tooltips";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/add-tooltips";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain("tooltipService") && packageInstance.isCapabilityEnabled({ tooltips: {} });
+    }
+}

package/lib/features/TotalSubTotal.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class TotalSubTotal {
+    static featureName = "Total SubTotal";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/total-subtotal-api";
+    static severity = Severity.Warning;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.Matrix | VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.isCapabilityEnabled({ subtotals: true });
+    }
+}

package/lib/features/VisualVersion.js

@@ -0,0 +1,12 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class VisualVersion {
+    static featureName = "Visual version";
+    static expectedVersionLength = 4;
+    static errorMessage = `${this.featureName} should consist of ${this.expectedVersionLength} parts. Update the pbiviz.json file`;
+    static severity = Severity.Error;
+    static stage = Stage.PreBuild;
+    static visualFeatureType = VisualFeatureType.All;
+    static isSupported(visual) {
+        return visual.isVisualVersionValid(this.expectedVersionLength);
+    }
+}

package/lib/features/WarningIcon.js

@@ -0,0 +1,11 @@
+import { Severity, Stage, VisualFeatureType } from "./FeatureTypes.js";
+export default class WarningIcon {
+    static featureName = "Warning Icon";
+    static documentationLink = "https://learn.microsoft.com/en-us/power-bi/developer/visuals/visual-display-warning-icon";
+    static severity = Severity.Info;
+    static stage = Stage.PostBuild;
+    static visualFeatureType = VisualFeatureType.NonSlicer | VisualFeatureType.Slicer;
+    static isSupported(packageInstance) {
+        return packageInstance.contain(".displayWarningIcon");
+    }
+}

package/lib/features/index.js

@@ -0,0 +1,29 @@
+import AdvancedEditMode from './AdvancedEditMode.js';
+import AllowInteractions from './AllowInteractions.js';
+import AnalyticsPane from './AnalyticsPane.js';
+import Bookmarks from './Bookmarks.js';
+import ColorPalette from './ColorPalette.js';
+import ConditionalFormatting from './ConditionalFormatting.js';
+import ContextMenu from './ContextMenu.js';
+import DrillDown from './DrillDown.js';
+import FetchMoreData from './FetchMoreData.js';
+import FileDownload from './FileDownload.js';
+import FormatPane from './FormatPane.js';
+import HighContrast from './HighContrast.js';
+import HighlightData from './HighlightData.js';
+import KeyboardNavigation from './KeyboardNavigation.js';
+import LandingPage from './LandingPage.js';
+import LaunchURL from './LaunchURL.js';
+import Localizations from './Localizations.js';
+import LocalStorage from './LocalStorage.js';
+import ModalDialog from './ModalDialog.js';
+import RenderingEvents from './RenderingEvents.js';
+import SelectionAcrossVisuals from './SelectionAcrossVisuals.js';
+import SyncSlicer from './SyncSlicer.js';
+import Tooltips from './Tooltips.js';
+import TotalSubTotal from './TotalSubTotal.js';
+import WarningIcon from './WarningIcon.js';
+import APIVersion from './APIVersion.js';
+import ESLint from './ESLint.js';
+import VisualVersion from './VisualVersion.js';
+export { AdvancedEditMode, AllowInteractions, AnalyticsPane, Bookmarks, ColorPalette, ConditionalFormatting, ContextMenu, DrillDown, FetchMoreData, FileDownload, FormatPane, HighContrast, HighlightData, KeyboardNavigation, LandingPage, LaunchURL, Localizations, LocalStorage, ModalDialog, RenderingEvents, SelectionAcrossVisuals, SyncSlicer, Tooltips, TotalSubTotal, WarningIcon, APIVersion, ESLint, VisualVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerbi-visuals-tools",
-  "version": "5.1.0",
+  "version": "5.2.0-beta.1",
   "description": "Command line tool for creating and publishing visuals for Power BI",
   "main": "./bin/pbiviz.js",
   "type": "module",
@@ -54,6 +54,7 @@
     "lodash.clonedeep": "4.5.0",
     "lodash.defaults": "4.2.0",
     "lodash.isequal": "4.5.0",
+    "lodash.ismatch": "^4.4.0",
     "mini-css-extract-plugin": "^2.7.6",
     "os-browserify": "^0.3.0",
     "path-browserify": "^1.0.1",