powerbi-visuals-tools 7.0.2 → 7.1.0

package/lib/mcp/tools/vulnerabilities.js

@@ -0,0 +1,211 @@
+/*
+ *  Power BI Visual CLI - MCP Server - Vulnerabilities Check Tool
+ *
+ *  Copyright (c) Microsoft Corporation
+ *  All rights reserved.
+ *  MIT License
+ */
+"use strict";
+import fs from 'fs-extra';
+import path from 'path';
+import { getSourceFiles } from '../../utils.js';
+// Dangerous patterns in code
+const CODE_PATTERNS = [
+    { pattern: /eval\s*\(/, message: 'Use of eval() is a security risk', severity: 'critical' },
+    { pattern: /new\s+Function\s*\(/, message: 'Dynamic Function construction is a security risk', severity: 'critical' },
+    { pattern: /innerHTML\s*=/, message: 'Direct innerHTML assignment may cause XSS vulnerabilities', severity: 'medium' },
+    { pattern: /document\.write/, message: 'document.write is deprecated and can be dangerous', severity: 'medium' },
+    { pattern: /window\.location\s*=/, message: 'Direct location assignment might be a security concern', severity: 'low' },
+    { pattern: /\bfetch\s*\(/, message: 'Use of fetch() is not allowed in certified visuals (external network calls are prohibited)', severity: 'high' },
+    { pattern: /XMLHttpRequest/, message: 'XMLHttpRequest to external URLs is not allowed in certified visuals', severity: 'high' },
+];
+async function checkSourceCode(rootPath) {
+    const results = [];
+    const srcPath = path.join(rootPath, 'src');
+    if (!fs.existsSync(srcPath)) {
+        return results;
+    }
+    const files = await getSourceFiles(srcPath);
+    for (const file of files) {
+        const content = await fs.readFile(file, 'utf-8');
+        const lines = content.split('\n');
+        const relativePath = path.relative(rootPath, file);
+        let inBlockComment = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Split line into activeCode and commentedCode by walking
+            // left-to-right through /*, */, and // markers
+            let activeCode = '';
+            let commentedCode = '';
+            let pos = 0;
+            while (pos < line.length) {
+                if (inBlockComment) {
+                    const endIdx = line.indexOf('*/', pos);
+                    if (endIdx !== -1) {
+                        commentedCode += line.substring(pos, endIdx + 2);
+                        pos = endIdx + 2;
+                        inBlockComment = false;
+                    }
+                    else {
+                        commentedCode += line.substring(pos);
+                        break;
+                    }
+                }
+                else {
+                    const blockStart = line.indexOf('/*', pos);
+                    const lineComment = line.indexOf('//', pos);
+                    // Find which comment marker comes first
+                    let nextComment = -1;
+                    let isBlock = false;
+                    if (blockStart !== -1 && (lineComment === -1 || blockStart <= lineComment)) {
+                        nextComment = blockStart;
+                        isBlock = true;
+                    }
+                    else if (lineComment !== -1) {
+                        nextComment = lineComment;
+                    }
+                    if (nextComment === -1) {
+                        activeCode += line.substring(pos);
+                        break;
+                    }
+                    activeCode += line.substring(pos, nextComment);
+                    if (isBlock) {
+                        const endIdx = line.indexOf('*/', nextComment + 2);
+                        if (endIdx !== -1) {
+                            commentedCode += line.substring(nextComment, endIdx + 2);
+                            pos = endIdx + 2;
+                        }
+                        else {
+                            commentedCode += line.substring(nextComment);
+                            inBlockComment = true;
+                            break;
+                        }
+                    }
+                    else {
+                        // Line comment — rest of line is commented
+                        commentedCode += line.substring(nextComment);
+                        break;
+                    }
+                }
+            }
+            // Check all patterns against the appropriate segment
+            for (const codePattern of CODE_PATTERNS) {
+                const inActive = codePattern.pattern.test(activeCode);
+                const inComment = codePattern.pattern.test(commentedCode);
+                if (inActive) {
+                    results.push({
+                        severity: codePattern.severity,
+                        message: `${relativePath}:${i + 1}: ${codePattern.message}`
+                    });
+                }
+                else if (inComment) {
+                    results.push({
+                        severity: 'info',
+                        message: `${relativePath}:${i + 1}: ${codePattern.message} (commented out)`,
+                        recommendation: 'Remove commented-out dangerous code to keep the codebase clean'
+                    });
+                }
+            }
+        }
+    }
+    return results;
+}
+function formatResults(results) {
+    if (results.length === 0) {
+        return `✅ **No vulnerabilities detected!**
+
+Your visual project passed the security scan. Keep following best practices:
+- Regularly update dependencies
+- Run \`npm audit\` periodically
+- Avoid external network calls
+- Sanitize all user inputs
+`;
+    }
+    const grouped = {
+        critical: results.filter(r => r.severity === 'critical'),
+        high: results.filter(r => r.severity === 'high'),
+        medium: results.filter(r => r.severity === 'medium'),
+        low: results.filter(r => r.severity === 'low'),
+        info: results.filter(r => r.severity === 'info'),
+    };
+    let output = `# 🔍 Vulnerability Scan Results\n\n`;
+    output += `Found **${results.length}** issue(s)\n\n`;
+    if (grouped.critical.length > 0) {
+        output += `## 🔴 Critical (${grouped.critical.length})\n`;
+        grouped.critical.forEach(r => {
+            output += `- ${r.message}\n`;
+            if (r.recommendation)
+                output += `  💡 ${r.recommendation}\n`;
+        });
+        output += '\n';
+    }
+    if (grouped.high.length > 0) {
+        output += `## 🟠 High (${grouped.high.length})\n`;
+        grouped.high.forEach(r => {
+            output += `- ${r.message}\n`;
+            if (r.recommendation)
+                output += `  💡 ${r.recommendation}\n`;
+        });
+        output += '\n';
+    }
+    if (grouped.medium.length > 0) {
+        output += `## 🟡 Medium (${grouped.medium.length})\n`;
+        grouped.medium.forEach(r => {
+            output += `- ${r.message}\n`;
+            if (r.recommendation)
+                output += `  💡 ${r.recommendation}\n`;
+        });
+        output += '\n';
+    }
+    if (grouped.low.length > 0) {
+        output += `## 🟢 Low (${grouped.low.length})\n`;
+        grouped.low.forEach(r => {
+            output += `- ${r.message}\n`;
+            if (r.recommendation)
+                output += `  💡 ${r.recommendation}\n`;
+        });
+        output += '\n';
+    }
+    if (grouped.info.length > 0) {
+        output += `## ℹ️ Info (${grouped.info.length})\n`;
+        grouped.info.forEach(r => {
+            output += `- ${r.message}\n`;
+            if (r.recommendation)
+                output += `  💡 ${r.recommendation}\n`;
+        });
+        output += '\n';
+    }
+    output += `---\n`;
+    output += `Run \`npm audit\` for a more comprehensive dependency audit.\n`;
+    return output;
+}
+async function checkEslint(rootPath) {
+    const results = [];
+    const packageJsonPath = path.join(rootPath, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return results;
+    }
+    const packageJson = await fs.readJson(packageJsonPath);
+    const allDeps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+    };
+    if (!allDeps['eslint']) {
+        results.push({
+            severity: 'info',
+            message: 'ESLint is not configured',
+            recommendation: 'Add ESLint for code quality and security linting'
+        });
+    }
+    return results;
+}
+export async function checkVulnerabilities(rootPath) {
+    try {
+        const codeResults = await checkSourceCode(rootPath);
+        const eslintResults = await checkEslint(rootPath);
+        return formatResults([...codeResults, ...eslintResults]);
+    }
+    catch (error) {
+        return `❌ Error scanning project: ${(error instanceof Error) ? error.message : String(error)}`;
+    }
+}

package/lib/utils.js

@@ -25,6 +25,33 @@ export function getRootPath() {
 export function getJsPath(filePath) {
     return filePath.replace(/\.json$/, '.mjs');
 }
+export async function getSourceFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== '.tmp') {
+            files.push(...await getSourceFiles(fullPath));
+        }
+        else if (entry.isFile() && /\.(ts|js|tsx|jsx)$/.test(entry.name)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export function existsIgnoreCase(filePath) {
+    const dir = path.dirname(filePath);
+    const name = path.basename(filePath).toLowerCase();
+    try {
+        const entries = fs.readdirSync(dir);
+        return entries.some(entry => entry.toLowerCase() === name);
+    }
+    catch {
+        return false;
+    }
+}
 async function safelyImport(filePath) {
     return fs.existsSync(filePath) && (await import(`file://${filePath}`)).default;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerbi-visuals-tools",
-  "version": "7.0.2",
+  "version": "7.1.0",
   "description": "Command line tool for creating and publishing visuals for Power BI",
   "main": "./bin/pbiviz.js",
   "type": "module",
@@ -12,6 +12,7 @@
     "jasmine": "node spec/jasmine-runner.js",
     "jasmine-inspect": "node --inspect spec/jasmine-runner.js",
     "lint": "npx eslint .",
+    "lint:fix": "npx eslint . --fix",
     "debug-tests": "npm run lint && npm run jasmine-inspect"
   },
   "bin": {
@@ -28,39 +29,42 @@
   },
   "homepage": "https://github.com/Microsoft/PowerBI-visuals-tools#readme",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "@typescript-eslint/parser": "^8.50.0",
     "async": "^3.2.6",
     "chalk": "^5.4.1",
-    "commander": "^13.1.0",
+    "commander": "^14.0.3",
     "compare-versions": "^6.1.1",
-    "css-loader": "^7.1.2",
-    "eslint-plugin-powerbi-visuals": "1.1.0",
-    "extra-watch-webpack-plugin": "^1.0.3",
-    "fs-extra": "^11.3.3",
+    "css-loader": "^7.1.4",
+    "eslint-plugin-powerbi-visuals": "1.1.1",
+    "fs-extra": "^11.3.4",
     "inline-source-map": "^0.6.3",
     "json-loader": "0.5.7",
     "jszip": "^3.10.1",
-    "less": "^4.5.1",
-    "less-loader": "^12.3.0",
+    "less": "^4.6.4",
+    "less-loader": "^12.3.2",
     "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.9.4",
-    "powerbi-visuals-webpack-plugin": "^4.3.1",
-    "terser-webpack-plugin": "^5.3.16",
+    "mini-css-extract-plugin": "^2.10.2",
+    "powerbi-visuals-webpack-plugin": "^5.0.1",
+    "terser-webpack-plugin": "^5.4.0",
     "ts-loader": "^9.5.4",
     "typescript": "^5.9.3",
-    "webpack": "^5.104.1",
+    "webpack": "^5.105.4",
     "webpack-bundle-analyzer": "4.10.2",
-    "webpack-dev-server": "^5.2.2"
+    "webpack-dev-server": "^5.2.3",
+    "zod": "^4.3.6"
+
   },
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "eslint": "^9.39.2",
-    "jasmine": "5.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "jasmine": "^6.1.0",
     "jasmine-spec-reporter": "7.0.0",
-    "semver": "7.7.3",
+    "semver": "7.7.4",
     "tree-kill": "1.2.2",
     "webpack-cli": "^6.0.1"
   },
@@ -68,6 +72,6 @@
     "fsevents": "*"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.19.0"
   }
 }

package/templates/visuals/_global/.vscode/mcp.json

@@ -0,0 +1,8 @@
+{
+    "servers": {
+        "pbiviz": {
+            "command": "npx",
+            "args": ["-y", "powerbi-visuals-tools", "mcp"]
+        }
+    }
+}

package/templates/visuals/default/src/visual.ts

@@ -32,10 +32,12 @@ import "./../style/visual.less";
 import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
 import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
 import IVisual = powerbi.extensibility.visual.IVisual;
+import IVisualEventService = powerbi.extensibility.IVisualEventService;
 
 import { VisualFormattingSettingsModel } from "./settings";
 
 export class Visual implements IVisual {
+    private events: IVisualEventService;
     private target: HTMLElement;
     private updateCount: number;
     private textNode: Text;
@@ -44,6 +46,7 @@ export class Visual implements IVisual {
 
     constructor(options: VisualConstructorOptions) {
         console.log('Visual constructor', options);
+        this.events = options.host.eventService;
         this.formattingSettingsService = new FormattingSettingsService();
         this.target = options.element;
         this.updateCount = 0;
@@ -59,11 +62,21 @@ export class Visual implements IVisual {
     }
 
     public update(options: VisualUpdateOptions) {
-        this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
+        this.events.renderingStarted(options);
 
-        console.log('Visual update', options);
-        if (this.textNode) {
-            this.textNode.textContent = (this.updateCount++).toString();
+        try {
+            this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
+
+            console.log('Visual update', options);
+            if (this.textNode) {
+                this.textNode.textContent = (this.updateCount++).toString();
+            }
+
+            this.events.renderingFinished(options);
+        }
+        catch (error) {
+            console.log('Error in update method', error);
+            this.events.renderingFailed(options, String(error))
         }
     }
 

package/templates/visuals/rhtml/src/visual.ts

@@ -30,6 +30,8 @@ import { formattingSettings, FormattingSettingsService } from "powerbi-visuals-u
 import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
 import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
 import IVisual = powerbi.extensibility.visual.IVisual;
+import IVisualEventService = powerbi.extensibility.IVisualEventService;
+
 import DataView = powerbi.DataView;
 import IViewport = powerbi.IViewport;
 
@@ -85,6 +87,7 @@ const renderVisualUpdateType: number[] = [
 ];
 
 export class Visual implements IVisual {
+    private events: IVisualEventService;
     private rootElement: HTMLElement;
     private headNodes: Node[];
     private bodyNodes: Node[];
@@ -92,6 +95,8 @@ export class Visual implements IVisual {
     private formattingSettingsService: FormattingSettingsService;
 
     public constructor(options: VisualConstructorOptions) {
+        this.events = options.host.eventService;
+
         this.formattingSettingsService = new FormattingSettingsService();
         if (options && options.element) {
             this.rootElement = options.element;
@@ -101,29 +106,40 @@ export class Visual implements IVisual {
     }
 
     public update(options: VisualUpdateOptions): void {
+        this.events.renderingStarted(options);
+
         if (!options ||
             !options.type ||
             !options.viewport ||
             !options.dataViews ||
             options.dataViews.length === 0 ||
             !options.dataViews[0]) {
+            this.events.renderingFinished(options);
             return;
         }
 
-        const dataView: DataView = options.dataViews[0];
-        this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
+        try {
+            const dataView: DataView = options.dataViews[0];
+            this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
 
-        let payloadBase64: string = null;
-        if (dataView.scriptResult && dataView.scriptResult.payloadBase64) {
-            payloadBase64 = dataView.scriptResult.payloadBase64;
-        }
+            let payloadBase64: string = null;
+            if (dataView.scriptResult && dataView.scriptResult.payloadBase64) {
+                payloadBase64 = dataView.scriptResult.payloadBase64;
+            }
 
-        if (renderVisualUpdateType.indexOf(options.type) === -1) {
-            if (payloadBase64) {
-                this.injectCodeFromPayload(payloadBase64);
+            if (renderVisualUpdateType.indexOf(options.type) === -1) {
+                if (payloadBase64) {
+                    this.injectCodeFromPayload(payloadBase64);
+                }
+            } else {
+                this.onResizing(options.viewport);
             }
-        } else {
-            this.onResizing(options.viewport);
+
+            this.events.renderingFinished(options);
+        }
+        catch (error) {
+            console.log('Error in update method', error);
+            this.events.renderingFailed(options, String(error))
         }
     }
 

package/templates/visuals/rvisual/src/visual.ts

@@ -31,18 +31,22 @@ import { FormattingSettingsService } from "powerbi-visuals-utils-formattingmodel
 import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
 import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
 import IVisual = powerbi.extensibility.visual.IVisual;
+import IVisualEventService = powerbi.extensibility.IVisualEventService;
 import DataView = powerbi.DataView;
 import IViewport = powerbi.IViewport;
 
 import { VisualFormattingSettingsModel } from "./settings";
 
 export class Visual implements IVisual {
+    private events: IVisualEventService;
     private imageDiv: HTMLDivElement;
     private imageElement: HTMLImageElement;
     private formattingSettings: VisualFormattingSettingsModel;
     private formattingSettingsService: FormattingSettingsService;
 
     public constructor(options: VisualConstructorOptions) {
+        this.events = options.host.eventService;
+
         this.formattingSettingsService = new FormattingSettingsService();
         this.imageDiv = document.createElement("div");
         this.imageDiv.className = "rcv_autoScaleImageContainer";
@@ -53,30 +57,40 @@ export class Visual implements IVisual {
     }
 
     public update(options: VisualUpdateOptions): void {
-        if (!options ||
-            !options.type ||
-            !options.viewport ||
-            !options.dataViews ||
-            options.dataViews.length === 0 ||
-            !options.dataViews[0]) {
-            return;
-        }
+        this.events.renderingStarted(options);
 
-        const dataView: DataView = options.dataViews[0];
-        this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
+        try {
+            if (!options ||
+                !options.type ||
+                !options.viewport ||
+                !options.dataViews ||
+                options.dataViews.length === 0 ||
+                !options.dataViews[0]) {
+                this.events.renderingFinished(options);
+                return;
+            }
 
-        let imageUrl: string = null;
-        if (dataView.scriptResult && dataView.scriptResult.payloadBase64) {
-            imageUrl = "data:image/png;base64," + dataView.scriptResult.payloadBase64;
-        }
+            const dataView: DataView = options.dataViews[0];
+            this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
 
-        if (imageUrl) {
-            this.imageElement.src = imageUrl;
-        } else {
-            this.imageElement.src = null;
-        }
+            let imageUrl: string = null;
+            if (dataView.scriptResult && dataView.scriptResult.payloadBase64) {
+                imageUrl = "data:image/png;base64," + dataView.scriptResult.payloadBase64;
+            }
 
-        this.onResizing(options.viewport);
+            if (imageUrl) {
+                this.imageElement.src = imageUrl;
+            } else {
+                this.imageElement.src = null;
+            }
+
+            this.onResizing(options.viewport);
+            this.events.renderingFinished(options);
+        }
+        catch (error) {
+            console.log('Error in update method', error);
+            this.events.renderingFailed(options, String(error))
+        }
     }
 
     public onResizing(finalViewport: IViewport): void {

package/templates/visuals/slicer/src/visual.ts

@@ -32,10 +32,12 @@ import "./../style/visual.less";
 import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
 import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
 import IVisual = powerbi.extensibility.visual.IVisual;
+import IVisualEventService = powerbi.extensibility.IVisualEventService;
 
 import { VisualFormattingSettingsModel } from "./settings";
 
 export class Visual implements IVisual {
+    private events: IVisualEventService;
     private target: HTMLElement;
     private updateCount: number;
     private textNode: Text;
@@ -44,6 +46,7 @@ export class Visual implements IVisual {
 
     constructor(options: VisualConstructorOptions) {
         console.log("Visual constructor", options);
+        this.events = options.host.eventService;
         this.formattingSettingsService = new FormattingSettingsService();
         this.target = options.element;
         this.updateCount = 0;
@@ -59,10 +62,19 @@ export class Visual implements IVisual {
     }
 
     public update(options: VisualUpdateOptions) {
-        this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
-        console.log("Visual update", options);
-        if (this.textNode) {
-            this.textNode.textContent = (this.updateCount++).toString();
+        this.events.renderingStarted(options);
+
+        try {
+            this.formattingSettings = this.formattingSettingsService.populateFormattingSettingsModel(VisualFormattingSettingsModel, options.dataViews[0]);
+            console.log("Visual update", options);
+            if (this.textNode) {
+                this.textNode.textContent = (this.updateCount++).toString();
+            }
+            this.events.renderingFinished(options);
+        }
+        catch (error) {
+            console.log("Visual update error", error);
+            this.events.renderingFailed(options, String(error));
         }
     }
 

package/templates/visuals/table/src/visual.ts

@@ -37,6 +37,7 @@ import { FormattingSettingsService } from "powerbi-visuals-utils-formattingmodel
 import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
 import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
 import IVisual = powerbi.extensibility.visual.IVisual;
+import IVisualEventService = powerbi.extensibility.IVisualEventService;
 import DataView = powerbi.DataView;
 import IViewport = powerbi.IViewport;
 
@@ -46,6 +47,7 @@ import { CategoryViewModel, VisualViewModel } from "./visualViewModel";
 
 "use strict";
 export class Visual implements IVisual {
+    private events: IVisualEventService;
     private target: d3.Selection<any, any, any, any>;
     private table: d3.Selection<any, any, any, any>;
     private tHead: d3.Selection<any, any, any, any>;
@@ -54,6 +56,8 @@ export class Visual implements IVisual {
     private formattingSettingsService: FormattingSettingsService;
 
     constructor(options: VisualConstructorOptions) {
+        this.events = options.host.eventService;
+
         this.formattingSettingsService = new FormattingSettingsService();
 
         let target: d3.Selection<any, any, any, any> = this.target = select(options.element).append("div")
@@ -67,7 +71,16 @@ export class Visual implements IVisual {
     }
 
     public update(options: VisualUpdateOptions): void {
-        this.updateInternal(options, visualTransform(options.dataViews));
+        this.events.renderingStarted(options);
+
+        try {
+            this.updateInternal(options, visualTransform(options.dataViews[0]));
+            this.events.renderingFinished(options);
+        }
+        catch (error) {
+            console.log("Visual update error", error);
+            this.events.renderingFailed(options, String(error));
+        }
     }
 
     public updateInternal(options: VisualUpdateOptions, viewModel: VisualViewModel): void {

package/tsconfig.json

@@ -14,7 +14,8 @@
         "ES2022",
         "dom"
       ],
-      "outDir": "lib"
+      "outDir": "lib",
+      "skipLibCheck": true
     },
     "include": [
       "src/**/*.ts"