versioned-d.ts-tools 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alex Jerabek
+
+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.

package/README.md

@@ -0,0 +1,70 @@
+# Versioned D.TS Tools
+
+A collection of command-line tools for managing versioned TypeScript definition files, particularly useful for API documentation and version comparison.
+
+## Installation
+
+Install globally to use the CLI tools from anywhere:
+
+```bash
+npm install -g versioned-d.ts-tools
+```
+
+Or install locally in your project:
+
+```bash
+npm install versioned-d.ts-tools
+```
+
+## CLI Tools
+
+### version-remover
+
+Removes specific API versions from TypeScript definition files.
+
+```bash
+version-remover [source d.ts] [API set name] [output file name]
+```
+
+**Example:**
+```bash
+version-remover excel.d.ts "ExcelApi 1.8" excel_1_7.d.ts
+```
+
+This tool removes all declarations marked with the specified API set version from the source `.d.ts` file and creates a new file with the remaining declarations.
+
+### whats-new
+
+Compares two TypeScript definition files and generates a markdown report of the differences.
+
+```bash
+whats-new [host name] [new d.ts] [old d.ts] [output file name (minus extension)]
+```
+
+**Example:**
+```bash
+whats-new Excel excel_1_9.d.ts excel_1_8.d.ts excel_whats_new
+```
+
+This generates a `excel_whats_new.md` file containing a markdown table showing what's new between the two versions.
+
+## Programmatic Usage
+
+You can also use the utilities programmatically in your own Node.js applications:
+
+```javascript
+const { APISet, parseDTS } = require('versioned-d.ts-tools');
+
+// Parse a TypeScript definition file
+const apiSet = parseDTS('filename', fileContents);
+
+// Compare two API sets
+const diff = newApiSet.diff(oldApiSet);
+
+// Generate markdown output
+const markdown = diff.getAsMarkdown('javascript/api/excel/');
+```
+
+## License
+
+MIT

package/dist/dts-utilities.d.ts

@@ -0,0 +1,41 @@
+declare enum ClassType {
+    Class = "Class",
+    Interface = "Interface",
+    Enum = "Enum"
+}
+declare enum FieldType {
+    Property = "Property",
+    Method = "Method",
+    Event = "Event",
+    Enum = "Enum"
+}
+declare class FieldStruct {
+    declarationString: string;
+    comment: string;
+    type: FieldType;
+    name: string;
+    constructor(decString: string, commentString: string, fieldType: FieldType, fieldName: string);
+}
+declare class ClassStruct {
+    declarationString: string;
+    comment: string;
+    type: ClassType;
+    fields: FieldStruct[];
+    constructor(decString: any, commentString: string, classType: ClassType);
+    copyWithoutFields(): ClassStruct;
+    sortFields(): void;
+    getClassName(): string;
+}
+export declare class APISet {
+    api: ClassStruct[];
+    constructor();
+    addClass(clas: ClassStruct): void;
+    containsClass(clas: ClassStruct): boolean;
+    containsField(clas: ClassStruct, field: FieldStruct): boolean;
+    diff(other: APISet): APISet;
+    getAsDTS(): string;
+    getAsMarkdown(relativePath: string): string;
+    sort(): void;
+}
+export declare function parseDTS(fileName: string, fileContents: string): APISet;
+export {};

package/dist/dts-utilities.js

@@ -0,0 +1,306 @@
+"use strict";
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts = __importStar(require("typescript"));
+// capturing these because of eccentricities with the compiler ordering
+let topClass = null;
+let lastItem = null;
+var ClassType;
+(function (ClassType) {
+    ClassType["Class"] = "Class";
+    ClassType["Interface"] = "Interface";
+    ClassType["Enum"] = "Enum";
+})(ClassType || (ClassType = {}));
+var FieldType;
+(function (FieldType) {
+    FieldType["Property"] = "Property";
+    FieldType["Method"] = "Method";
+    FieldType["Event"] = "Event";
+    FieldType["Enum"] = "Enum";
+})(FieldType || (FieldType = {}));
+class FieldStruct {
+    constructor(decString, commentString, fieldType, fieldName) {
+        this.declarationString = decString;
+        this.comment = commentString;
+        this.type = fieldType;
+        this.name = fieldName;
+    }
+}
+class ClassStruct {
+    constructor(decString, commentString, classType) {
+        this.declarationString = decString;
+        this.comment = commentString;
+        this.type = classType;
+        this.fields = [];
+    }
+    copyWithoutFields() {
+        return new ClassStruct(this.declarationString, this.comment, this.type);
+    }
+    sortFields() {
+        this.fields.sort((a, b) => {
+            if (a.declarationString === b.declarationString) {
+                return 0;
+            }
+            else {
+                return a.declarationString.replace("readonly ", "") < b.declarationString.replace("readonly ", "") ? -1 : 1;
+            }
+        });
+    }
+    getClassName() {
+        return this.declarationString.substring(this.declarationString.lastIndexOf(" ") + 1);
+    }
+}
+class APISet {
+    constructor() {
+        this.api = [];
+    }
+    addClass(clas) {
+        this.api.push(clas);
+    }
+    containsClass(clas) {
+        let found = false;
+        this.api.forEach((element) => {
+            if (element.declarationString === clas.declarationString) {
+                found = true;
+            }
+        });
+        return found;
+    }
+    containsField(clas, field) {
+        let found = false;
+        this.api.forEach((element) => {
+            if (element.declarationString === clas.declarationString) {
+                element.fields.forEach((thisField) => {
+                    if (thisField.declarationString === field.declarationString) {
+                        found = true;
+                    }
+                });
+            }
+        });
+        return found;
+    }
+    // finds the new fields and classes
+    diff(other) {
+        const diffAPI = new APISet();
+        this.api.forEach((element) => {
+            if (other.containsClass(element)) {
+                let classShell = null;
+                element.fields.forEach((field) => {
+                    if (!other.containsField(element, field)) {
+                        if (classShell === null) {
+                            classShell = element.copyWithoutFields();
+                            diffAPI.addClass(classShell);
+                        }
+                        classShell.fields.push(field);
+                    }
+                });
+            }
+            else {
+                diffAPI.addClass(element);
+            }
+        });
+        return diffAPI;
+    }
+    getAsDTS() {
+        this.sort();
+        const output = [];
+        this.api.forEach((clas) => {
+            output.push(clas.comment.trim());
+            output.push(clas.declarationString + " {");
+            clas.fields.forEach((field) => {
+                output.push("    " + field.comment);
+                if (field.type === FieldType.Enum) {
+                    output.push("    " + field.declarationString + ",");
+                }
+                else {
+                    output.push("    " + field.declarationString);
+                }
+            });
+            output.push("}");
+        });
+        return output.join("\n");
+    }
+    getAsMarkdown(relativePath) {
+        this.sort();
+        // table header
+        let output = "| Class | Fields | Description |\n|:---|:---|:---|\n";
+        this.api.forEach((clas) => {
+            // Ignore the following:
+            // - Enums.
+            // - LoadOptions interfaces
+            // - *Data classes for set/load methods
+            if (clas.type !== ClassType.Enum &&
+                !clas.getClassName().endsWith("LoadOptions") &&
+                !clas.getClassName().endsWith("Data")) {
+                const className = clas.getClassName();
+                output += "|[" + className + "](/"
+                    + relativePath + className.toLowerCase() + ")|";
+                // Ignore the following:
+                // - String literal overloads.
+                // - `load`, `set`, `track`, `untrack`, and `toJSON` methods
+                // - The `context` property.
+                // - Static fields.
+                let filteredFields = clas.fields.filter((field) => {
+                    let isLiteral = field.declarationString.search(/([a-zA-Z]+)(\??:)([\n]?([ |]*\"[\w]*\"[|,\n]*)+?)([ ]*[\),])/g) >= 0;
+                    return (!isLiteral &&
+                        field.name !== "load" &&
+                        field.name !== "set" &&
+                        field.name !== "toJSON" &&
+                        field.name !== "context" &&
+                        field.name !== "track" &&
+                        field.name !== "untrack" &&
+                        !field.declarationString.includes("static "));
+                });
+                let first = true;
+                if (filteredFields.length > 0) {
+                    filteredFields.forEach((field) => {
+                        if (first) {
+                            first = false;
+                        }
+                        else {
+                            output += "||";
+                        }
+                        // remove unnecessary parts of the declaration string
+                        let newItemText = field.declarationString.replace(/;/g, "");
+                        if (field.type === FieldType.Property) {
+                            // Remove the optional modifier and type.
+                            newItemText = newItemText.replace(/\?/g, "");
+                            newItemText = newItemText.substring(0, newItemText.indexOf(":"));
+                        }
+                        else {
+                            // Remove the return type.
+                            newItemText = newItemText.substring(0, newItemText.lastIndexOf(":"));
+                        }
+                        newItemText = newItemText.replace("readonly ", "");
+                        newItemText = newItemText.replace(/\|/g, "\\|").replace(/\n|\t/gm, "");
+                        newItemText = newItemText.replace(/[\s][\s]+/g, " ").replace(/\( /g, "(").replace(/ \)/g, ")").replace(/,\)/g, ")").replace(/([\w]\??: )\\\| /g, "$1"); // dprint formatting quirks
+                        newItemText = newItemText.replace(/\<any\>/g, "");
+                        let tableLine = "[" + newItemText + "]("
+                            + buildFieldLink(relativePath, className, field) + ")|";
+                        tableLine += removeAtLink(extractFirstSentenceFromComment(field.comment));
+                        output += tableLine + "|\n";
+                    });
+                }
+                else {
+                    output += "||\n";
+                }
+            }
+        });
+        return output;
+    }
+    sort() {
+        this.api.forEach((element) => {
+            element.sortFields();
+        });
+        this.api.sort((a, b) => {
+            if (a.getClassName() === b.getClassName()) {
+                return 0;
+            }
+            else {
+                return a.getClassName() < b.getClassName() ? -1 : 1;
+            }
+        });
+    }
+}
+exports.APISet = APISet;
+function extractFirstSentenceFromComment(commentText) {
+    const firstSentenceIndex = commentText.indexOf("* ") + 2;
+    const multiSentenceEndIndex = commentText.indexOf(". ", firstSentenceIndex);
+    const lineBreakEndIndex = commentText.indexOf("\n", firstSentenceIndex);
+    const singleLineEndIndex = commentText.indexOf("\*/", firstSentenceIndex);
+    let endIndex;
+    if (multiSentenceEndIndex > 0 && lineBreakEndIndex > 0) {
+        endIndex = Math.min(multiSentenceEndIndex + 1, lineBreakEndIndex);
+    }
+    else if (multiSentenceEndIndex === -1 && lineBreakEndIndex === -1) {
+        endIndex = singleLineEndIndex;
+    }
+    else {
+        endIndex = Math.max(multiSentenceEndIndex + 1, lineBreakEndIndex);
+    }
+    return commentText.substring(firstSentenceIndex, endIndex).trim();
+}
+function removeAtLink(commentText) {
+    // Replace links with the format "{@link Foo}" with "Foo".
+    commentText = commentText.replace(/{@link ([^|]*?)}/gm, "$1");
+    // Replace links with the format "{@link Foo | URL}" with "[Foo](URL)".
+    commentText = commentText.replace(/{@link ([^}]*?) \| (http.*?)}/gm, "[$1]($2)");
+    return commentText;
+}
+function buildFieldLink(relativePath, className, field) {
+    // Build the standard link anchor format based on host.
+    let anchorPrefix = relativePath.substring(relativePath.lastIndexOf("/") + 1, relativePath.lastIndexOf("."));
+    anchorPrefix = (relativePath.indexOf("outlook") > 0 ? "outlook" : anchorPrefix) + "-" + anchorPrefix + "-";
+    let fieldLink = "/" + relativePath.replace("api/outlook/outlook", "api/outlook/office") + className.toLowerCase() + "#" + anchorPrefix + className.toLowerCase() + "-" + field.name.toLowerCase() + (field.type === FieldType.Method ? "-member(1)" : "-member");
+    return fieldLink;
+}
+function parseDTS(fileName, fileContents) {
+    const node = ts.createSourceFile(fileName, fileContents, ts.ScriptTarget.ES2015, true);
+    const allClasses = new APISet();
+    parseDTSInternal(node, allClasses);
+    return allClasses;
+}
+exports.parseDTS = parseDTS;
+function parseDTSInternal(node, allClasses) {
+    switch (node.kind) {
+        case ts.SyntaxKind.InterfaceDeclaration:
+            parseDTSTopLevelItem(node, allClasses, ClassType.Interface);
+            break;
+        case ts.SyntaxKind.ClassDeclaration:
+            parseDTSTopLevelItem(node, allClasses, ClassType.Class);
+            break;
+        case ts.SyntaxKind.EnumDeclaration:
+            parseDTSTopLevelItem(node, allClasses, ClassType.Enum);
+            break;
+        case ts.SyntaxKind.PropertySignature:
+            parseDTSFieldItem(node, FieldType.Property);
+            break;
+        case ts.SyntaxKind.PropertyDeclaration:
+            parseDTSFieldItem(node, FieldType.Property);
+            break;
+        case ts.SyntaxKind.EnumMember:
+            parseDTSFieldItem(node, FieldType.Enum);
+            break;
+        case ts.SyntaxKind.MethodSignature:
+            parseDTSFieldItem(node, FieldType.Method);
+            break;
+        case ts.SyntaxKind.MethodDeclaration:
+            parseDTSFieldItem(node, FieldType.Method);
+            break;
+        case ts.SyntaxKind.TypeLiteral:
+            return;
+        default:
+            // the compiler parses comments after the class/field, therefore this connects to the previous item
+            if (node.getText().indexOf("/**") >= 0 &&
+                node.getText().indexOf("*/") >= 0 &&
+                lastItem !== null &&
+                lastItem.comment === "") {
+                // clean up spacing as best we can for the diffed d.ts
+                lastItem.comment = node.getText().replace(/    \*/g, "*");
+                if (lastItem.comment.indexOf("@eventproperty") >= 0) {
+                    // events are indistinguishable from properties aside from this tag
+                    lastItem.type = FieldType.Event;
+                }
+            }
+    }
+    node.getChildren().forEach((element) => {
+        parseDTSInternal(element, allClasses);
+    });
+}
+function parseDTSTopLevelItem(node, allClasses, type) {
+    topClass = new ClassStruct("export " + type.toLowerCase() + " " + node.name.text, "", type);
+    allClasses.addClass(topClass);
+    lastItem = topClass;
+}
+function parseDTSFieldItem(node, type) {
+    const newField = new FieldStruct(node.getText(), "", type, node.name.getText());
+    topClass.fields.push(newField);
+    lastItem = newField;
+}
+//# sourceMappingURL=dts-utilities.js.map

package/dist/dts-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-utilities.js","sourceRoot":"","sources":["../src/dts-utilities.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { APISet, parseDTS } from './dts-utilities';

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var dts_utilities_1 = require("./dts-utilities");
+exports.APISet = dts_utilities_1.APISet;
+exports.parseDTS = dts_utilities_1.parseDTS;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,iDAAmD;AAA1C,iCAAA,MAAM,CAAA;AAAE,mCAAA,QAAQ,CAAA"}

package/dist/version-remover.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/version-remover.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+"use strict";
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fsx = __importStar(require("fs-extra"));
+if (process.argv.length !== 5 || process.argv.find((x) => { return x === "-?"; })) {
+    console.log("usage: node version-remover [source d.ts] [API set name] [output file name]");
+    console.log("example: node version-remover excel.d.ts \"ExcelApi 1.8\" excel_1_7.d.ts");
+    process.exit(0);
+}
+console.log("Version Remover - Creating " + process.argv[4]);
+let wholeDts = fsx.readFileSync(process.argv[2]).toString();
+let declarationString;
+// find the API tag
+let indexOfApiSetTag = wholeDts.indexOf("Api set: " + process.argv[3]);
+while (indexOfApiSetTag >= 0) {
+    // find the comment block around the API tag
+    let commentStart = wholeDts.lastIndexOf("/**", indexOfApiSetTag);
+    let commentEnd = wholeDts.indexOf("*/", indexOfApiSetTag);
+    commentEnd = wholeDts.indexOf("\n", commentEnd) + 1; // Account for newline and ending characters.
+    // the declaration string is the line following the comment
+    declarationString = wholeDts.substring(commentEnd, wholeDts.indexOf("\n", commentEnd));
+    let endPosition = commentEnd + declarationString.length;
+    if (declarationString.indexOf("class") >= 0 ||
+        declarationString.indexOf("enum") >= 0 ||
+        declarationString.indexOf("interface") >= 0) {
+        // Discount internal bracket pairs.
+        let nextStartBrace = wholeDts.indexOf("{", endPosition);
+        let nextEndBrace = wholeDts.indexOf("}", endPosition);
+        while (nextStartBrace < nextEndBrace && nextStartBrace >= 0) {
+            nextStartBrace = wholeDts.indexOf("{", nextStartBrace + 1);
+            nextEndBrace = wholeDts.indexOf("}", nextEndBrace + 1);
+        }
+        endPosition = wholeDts.indexOf("}", nextEndBrace - 1);
+    }
+    else {
+        endPosition = getDeclarationEnd(wholeDts, commentEnd);
+    }
+    if (endPosition === -1) {
+        endPosition = commentEnd;
+    }
+    wholeDts = wholeDts.substring(0, commentStart) + wholeDts.substring(endPosition + 1);
+    indexOfApiSetTag = wholeDts.indexOf("Api set: " + process.argv[3]);
+}
+/* Add necessary custom logic here*/
+if (process.argv[3] === "ExcelApi 1.19") {
+    console.log("Address CardLayoutTwoColumnSection reference for when removing ExcelApi 1.19");
+    wholeDts = wholeDts.replace(/type CardLayoutSection = CardLayoutListSection \| CardLayoutTableSection \| CardLayoutTwoColumnSection;/g, "type CardLayoutSection = CardLayoutListSection | CardLayoutTableSection;");
+    console.log("Address EntityCompactLayoutIcons reference for when removing ExcelApi 1.19");
+    wholeDts = wholeDts.replace(/icon\?: string \| EntityCompactLayoutIcons;/g, "icon?: string;");
+    console.log("Address EntityCompactLayoutIcons reference for when removing ExcelApi 1.19");
+    wholeDts = wholeDts.replace(/type CellValue = \(ArrayCellValue \| BooleanCellValue \| DoubleCellValue \| EntityCellValue \| EmptyCellValue \| ErrorCellValue \| FormattedNumberCellValue \| FunctionCellValue \| LinkedEntityCellValue \| ReferenceCellValue \| StringCellValue \| ValueTypeNotAvailableCellValue \| WebImageCellValue\) \& CellValueExtraProperties;/g, "type CellValue = (ArrayCellValue | BooleanCellValue | DoubleCellValue | EntityCellValue | EmptyCellValue | ErrorCellValue | LinkedEntityCellValue | ReferenceCellValue | StringCellValue | ValueTypeNotAvailableCellValue | WebImageCellValue) & CellValueExtraProperties;");
+}
+if (process.argv[3] === "ExcelApi 1.11") {
+    console.log("Address CommentRichContent reference for when removing ExcelApi 1.11");
+    wholeDts = wholeDts.replace(/content: CommentRichContent \| string,/g, "content: string,");
+}
+if (process.argv[3] === "Mailbox 1.14") {
+    console.log("Address SpamReportingEventCompletedOptions reference when removing Mailbox 1.14");
+    wholeDts = wholeDts.replace(/options\?: SmartAlertsEventCompletedOptions \| SpamReportingEventCompletedOptions/g, "options?: SmartAlertsEventCompletedOptions");
+}
+if (process.argv[3] === "Mailbox 1.12") {
+    console.log("Address SmartAlertsEventCompletedOptions reference when removing Mailbox 1.12");
+    wholeDts = wholeDts.replace(/options\?: SmartAlertsEventCompletedOptions/g, "");
+    wholeDts = wholeDts.replace(/@param options - Optional. An object that specifies the behavior of an event-based or spam-reporting add-in when it completes processing an event./g, "");
+}
+if (process.argv[3] === "WordApiDesktop 1.1") {
+    console.log("Address ImportedStylesConflictBehavior reference when removing WordApiDesktop 1.1");
+    wholeDts = wholeDts.replace(/@param importedStylesConflictBehavior - Optional. Specifies how to handle any imported styles with the same name as existing styles in the current document./g, "");
+    wholeDts = wholeDts.replace(/Note: The `importedStylesConflictBehavior` parameter was introduced in WordApiDesktop 1.1./g, "");
+    wholeDts = wholeDts.replace(/, importedStylesConflictBehavior\?: Word\.ImportedStylesConflictBehavior[\w\W]*importedStylesConflictBehaviorString\?: "Ignore" \| "Overwrite" \| "CreateNew"\): OfficeExtension.ClientResult<string\[\]>;/gm, "): OfficeExtension.ClientResult<string[]>;");
+}
+fsx.writeFileSync(process.argv[4], wholeDts);
+function getDeclarationEnd(wholeDts, startIndex) {
+    let nextSemicolon = wholeDts.indexOf(";", startIndex);
+    let nextNewLine = wholeDts.indexOf("\n", startIndex);
+    let nextStartBrace = wholeDts.indexOf("{", startIndex);
+    let nextEndBrace = wholeDts.indexOf("}", startIndex);
+    let nextComment = wholeDts.indexOf("/**", startIndex);
+    // Figure out if the declaration has an internal class.
+    if (nextSemicolon < nextNewLine) {
+        return nextSemicolon;
+    }
+    else if (nextStartBrace > nextEndBrace && nextEndBrace < nextComment) {
+        return wholeDts.lastIndexOf("\n", nextEndBrace);
+    }
+    else {
+        return wholeDts.lastIndexOf("\n", nextComment);
+    }
+}
+//# sourceMappingURL=version-remover.js.map

package/dist/version-remover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-remover.js","sourceRoot":"","sources":["../src/version-remover.ts"],"names":[],"mappings":"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"}

package/dist/whats-new.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/whats-new.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fsx = __importStar(require("fs-extra"));
+const dts_utilities_1 = require("./dts-utilities");
+if (process.argv.length !== 6 || process.argv.find((x) => { return x === "-?"; })) {
+    console.log("usage: node whats-new [host name] [new d.ts] [old d.ts] [output file name (minus extension)]");
+    console.log("example: node whats-new Excel excel_1_9.d.ts excel_1_8.d.ts excel_whats_new");
+    process.exit(0);
+}
+const hostName = process.argv[2];
+const newDtsPath = process.argv[3];
+const oldDtsPath = process.argv[4];
+const outputPath = process.argv[5];
+console.log(`What's New between ${newDtsPath} and ${oldDtsPath}?`);
+tryCatch(() => __awaiter(void 0, void 0, void 0, function* () {
+    // read whole files
+    let wholeRelease = fsx.readFileSync(oldDtsPath).toString();
+    let wholePreview = fsx.readFileSync(newDtsPath).toString();
+    const releaseAPI = dts_utilities_1.parseDTS("release", wholeRelease);
+    const previewAPI = dts_utilities_1.parseDTS("preview", wholePreview);
+    const diffAPI = previewAPI.diff(releaseAPI);
+    const relativePath = `javascript/api/${hostName.toLowerCase()}/${hostName.toLowerCase() === "outlook" ? "office" : hostName.toLowerCase()}.`;
+    if (!fsx.existsSync(outputPath + ".md")) {
+        fsx.createFileSync(outputPath + ".md");
+    }
+    fsx.writeFileSync(outputPath + ".md", diffAPI.getAsMarkdown(relativePath));
+}));
+function tryCatch(call) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield call();
+        }
+        catch (e) {
+            console.error(e);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=whats-new.js.map

package/dist/whats-new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whats-new.js","sourceRoot":"","sources":["../src/whats-new.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AACA,8CAAgC;AAChC,mDAAmD;AAGnD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,GAAE,OAAO,CAAC,KAAK,IAAI,CAAA,CAAA,CAAC,CAAC,EAAE;IACpF,OAAO,CAAC,GAAG,CAAC,8FAA8F,CAAC,CAAC;IAC5G,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACnB;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnC,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,QAAQ,UAAU,GAAG,CAAC,CAAC;AAEnE,QAAQ,CAAC,GAAS,EAAE;IAChB,mBAAmB;IACnB,IAAI,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,IAAI,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAE3D,MAAM,UAAU,GAAW,wBAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAW,wBAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAW,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,YAAY,GAAW,kBAAkB,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;IACrJ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE;QACrC,GAAG,CAAC,cAAc,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;KAC1C;IAED,GAAG,CAAC,aAAa,CAAC,UAAU,GAAG,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAA,CAAC,CAAC;AAEH,SAAe,QAAQ,CAAC,IAAyB;;QAC7C,IAAI;YACA,MAAM,IAAI,EAAE,CAAC;SAChB;QAAC,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnB;IACL,CAAC;CAAA"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "versioned-d.ts-tools",
+  "version": "0.1.0",
+  "description": "Tools for managing versioned TypeScript definition files",
+  "main": "dist/index.js",
+  "bin": {
+    "version-remover": "dist/version-remover.js",
+    "whats-new": "dist/whats-new.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "tsc -p tsconfig.json --watch",
+    "lint": "eslint -c .eslintrc.js --ext .ts",
+    "prepublishOnly": "npm run build",
+    "clean": "if exist dist rmdir /s /q dist",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "AlexJerabek",
+  "license": "MIT",
+  "keywords": ["typescript", "d.ts", "versioning", "api", "documentation"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlexJerabek/versioned-d.ts-tools.git"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/fs-extra": "3.0.1",
+    "@types/inquirer": "0.0.34",
+    "@types/js-yaml": "4.0.0",
+    "@types/lodash": "4.14.136",
+    "@types/node": "7.0.5",
+    "@typescript-eslint/eslint-plugin": "^6.16.0",
+    "@typescript-eslint/parser": "^6.16.0",
+    "del": "2.2.2",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prefer-arrow": "^1.2.3",
+    "ts-node": "2.1.0"
+  },
+  "dependencies": {
+    "typescript": "~3.7.0",
+    "deep-diff": "^1.0.2",
+    "fs-extra": "3.0.1",
+    "inquirer": "^8.2.0",
+    "isomorphic-fetch": "^3.0.0",
+    "lodash": "^4.17.21"
+  }
+}