@keymanapp/kmc 18.0.8-alpha → 18.0.9-alpha

package/build/src/commands/messageCommand.js

@@ -0,0 +1,239 @@
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{},n=(new Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4ce735ab-b2c1-585a-9814-d527ddc6281e")}catch(e){}}();
+import * as fs from 'fs';
+import * as path from 'path';
+import { CompilerError } from '@keymanapp/common-types';
+import { Option } from 'commander';
+import { messageNamespaceKeys, messageSources } from '../messages/messageNamespaces.js';
+import { NodeCompilerCallbacks } from '../util/NodeCompilerCallbacks.js';
+import { exitProcess } from '../util/sysexits.js';
+import { InfrastructureMessages } from '../messages/infrastructureMessages.js';
+import { findMessageDetails } from '../util/extendedCompilerOptions.js';
+import { escapeMarkdownChar } from '@keymanapp/developer-utils';
+;
+export function declareMessage(program) {
+    program
+        .command('message [messages...]')
+        .description(`Describe one or more compiler messages. Note: Markdown format is always written to files on disk.`)
+        .addOption(new Option('-f, --format <format>', 'Output format').choices(['text', 'markdown', 'json']).default('text'))
+        .option('-o, --out-path <out-path>', 'Output path for Markdown files; output filename for text and json formats')
+        .option('-a, --all-messages', 'Emit descriptions for all messages (text, json)')
+        .action(messageCommand);
+}
+async function messageCommand(messages, _options, commander) {
+    const commanderOptions = commander.optsWithGlobals();
+    const options = initialize(commanderOptions);
+    if (!options) {
+        await exitProcess(1);
+    }
+    const callbacks = new NodeCompilerCallbacks(options);
+    let result = false;
+    if (options.format == 'markdown') {
+        result = messageCommandMarkdown(messages, options, callbacks);
+    }
+    else { // json or text format
+        if (messages.length == 0 && !options.allMessages) {
+            console.error('Must specify at least one message code or -a for all messages');
+            callbacks.reportMessage(InfrastructureMessages.Error_MustSpecifyMessageCode());
+            await exitProcess(1);
+        }
+        const messageDetails = messages.length
+            ? messages.map(message => translateMessageInputToCode(message, callbacks))
+            : allMessageDetails();
+        if (callbacks.messageCount > 0) {
+            await exitProcess(1);
+        }
+        let text = null;
+        if (options.format == 'json') {
+            const data = getMessagesAsArrayForJson(messageDetails);
+            if (data) {
+                text = JSON.stringify(data, null, 2);
+            }
+        }
+        else {
+            text = getMessagesAsText(messageDetails);
+        }
+        result = text != null;
+        if (result) {
+            if (options.outPath) {
+                fs.writeFileSync(options.outPath, text, 'utf-8');
+            }
+            else {
+                process.stdout.write(text);
+            }
+        }
+    }
+    if (!result) {
+        await exitProcess(1);
+    }
+}
+// We have a redirect pattern for https://help.keyman.com/go/km<#####> to
+// the corresponding compiler message reference document in
+// /developer/latest-version/reference/errors/km<#####>
+const helpUrl = (code) => `https://help.keyman.com/go/${CompilerError.formatCode(code).toLowerCase()}`;
+const getModuleName = (ms) => `${ms.module}.${ms.class.name}`;
+function translateMessageInputToCode(message, callbacks) {
+    const pattern = /^(KM)?([0-9a-f]+)$/i;
+    const result = message.match(pattern);
+    if (!result) {
+        callbacks.reportMessage(InfrastructureMessages.Error_UnrecognizedMessageCode({ message }));
+        return null;
+    }
+    const code = Number.parseInt(result[2], 16);
+    return findMessageDetails(code, callbacks);
+}
+function initialize(options) {
+    // We don't want to rename command line options to match the precise
+    // properties that we have in CompilerOptions, but nor do we want to rename
+    // CompilerOptions properties...
+    return {
+        // CompilerBaseOptions
+        logLevel: options.logLevel,
+        logFormat: options.logFormat,
+        color: options.color,
+        // MessageOptions
+        format: options.format ?? 'text',
+        outPath: options.outPath
+    };
+}
+const getMessageIdentifiersSorted = (cls) => Object.keys(cls)
+    .filter(id => typeof cls[id] == 'number')
+    .sort((a, b) => CompilerError.error(cls[a]) - CompilerError.error(cls[b]));
+function allMessageDetails() {
+    let result = [];
+    messageNamespaceKeys.forEach((namespace) => {
+        const ms = messageSources[namespace];
+        const ids = getMessageIdentifiersSorted(ms.class);
+        for (const id of ids) {
+            const code = ms.class[id];
+            if (typeof code != 'number') {
+                continue;
+            }
+            result.push({
+                code,
+                id,
+                class: ms.class,
+                module: ms.module
+            });
+        }
+    });
+    return result;
+}
+const toTitleCase = (s) => s.substring(0, 1).toUpperCase() + s.substring(1).toLowerCase();
+function getMessageDetail(cls, id, escapeMarkdown) {
+    const o = /^(INFO|HINT|WARN|ERROR|FATAL)_([A-Za-z0-9_]+)$/.exec(id);
+    if (!o) {
+        throw new Error(`Unexpected compiler message ${id}, does not match message error format`);
+    }
+    const f = toTitleCase(o[1]) + '_' + o[2];
+    const event = cls[f]?.({} /* ignore arguments*/);
+    if (!event) {
+        throw new Error(`Call to ${cls.name}.${f} returned null`);
+    }
+    event.detail = (event.detail ?? '').replace(/^[ ]+/gm, ''); // TODO(lowpri): dedent may be too naive?
+    event.message = event.message ?? '';
+    event.message = event?.exceptionVar
+        ? 'This is an internal error; the message will vary'
+        : (escapeMarkdown ? `${escapeMarkdownChar(event.message, false)}` : event.message);
+    return event;
+}
+/*---------------------------------------------------------------------------
+ * Get messages in text format
+ *---------------------------------------------------------------------------*/
+function getMessagesAsText(messages) {
+    const result = messages.reduce((prev, message) => {
+        return prev + '\n' + formatMessageAsText(getModuleName({ class: message.class, module: message.module }), message.class, message.code, message.id);
+    }, '');
+    return result;
+}
+function formatMessageAsText(moduleName, cls, code, id) {
+    const message = getMessageDetail(cls, id, false);
+    return `${id}
+* Code:      ${CompilerError.formatCode(code)}
+* Module:    ${moduleName}
+* Message:   ${message.message}
+* Reference: ${helpUrl(code)}
+
+${message.detail}
+`;
+}
+/*---------------------------------------------------------------------------
+ * Get messages as array of objects, for export to JSON
+ *---------------------------------------------------------------------------*/
+function getMessagesAsArrayForJson(messages) {
+    return messages.map(message => ({
+        code: CompilerError.formatCode(message.code),
+        id: message.id,
+        class: message.class.name,
+        module: message.module,
+        detail: (() => getMessageDetail(message.class, message.id, false).detail)()
+    }));
+}
+/*---------------------------------------------------------------------------
+ * Export as Markdown
+ *---------------------------------------------------------------------------*/
+function messageCommandMarkdown(messages, options, callbacks) {
+    if (messages.length) {
+        callbacks.reportMessage(InfrastructureMessages.Error_MessagesCannotBeFilteredForMarkdownFormat());
+        return false;
+    }
+    if (!options.outPath) {
+        callbacks.reportMessage(InfrastructureMessages.Error_OutputPathMustBeSpecifiedForMarkdownFormat());
+        return false;
+    }
+    if (!fs.existsSync(options.outPath) || !fs.statSync(options.outPath)?.isDirectory()) {
+        callbacks.reportMessage(InfrastructureMessages.Error_OutputPathMustExistAndBeADirectory({ outPath: options.outPath }));
+        return false;
+    }
+    exportAllMessagesAsMarkdown(options.outPath);
+    return true;
+}
+function exportAllMessagesAsMarkdown(outPath) {
+    let index = `---
+title: Compiler Messages Reference
+---
+
+`;
+    messageNamespaceKeys.forEach((namespace) => {
+        const ms = messageSources[namespace];
+        const moduleName = getModuleName(ms);
+        index += `* [${moduleName}](${moduleName.toLowerCase()})\n`;
+        exportModuleMessagesAsMarkdown(moduleName, ms, outPath);
+    });
+    fs.writeFileSync(path.join(outPath, 'index.md'), index, 'utf-8');
+}
+function exportModuleMessagesAsMarkdown(moduleName, ms, outPath) {
+    const cls = ms.class;
+    let index = `---
+title: Compiler Messages Reference for @keymanapp/${ms.module}
+---
+
+ Code | Identifier | Message
+------|------------|---------
+`;
+    const ids = getMessageIdentifiersSorted(cls);
+    for (const id of ids) {
+        const code = cls[id];
+        const filename = CompilerError.formatCode(code).toLowerCase();
+        const message = getMessageDetail(cls, id, true);
+        const content = formatMessageAsMarkdown(moduleName, id, message);
+        index += `[${CompilerError.formatCode(code)}](${filename}) | \`${id}\` | ${message.message}\n`;
+        fs.writeFileSync(path.join(outPath, filename + '.md'), content, 'utf-8');
+    }
+    fs.writeFileSync(path.join(outPath, moduleName + '.md'), index, 'utf-8');
+}
+function formatMessageAsMarkdown(moduleName, id, message) {
+    return `---
+title: ${CompilerError.formatCode(message.code)}: ${id}
+---
+
+|            |           |
+|------------|---------- |
+| Message    | ${message.message} |
+| Module     | [${moduleName}](${moduleName.toLowerCase()}) |
+| Identifier | \`${id}\` |
+
+${message.detail}
+`;
+}
+//# debugId=4ce735ab-b2c1-585a-9814-d527ddc6281e
+//# sourceMappingURL=messageCommand.js.map

package/build/src/commands/messageCommand.js.map

@@ -0,0 +1 @@
+{"debug_id":"4ce735ab-b2c1-585a-9814-d527ddc6281e","file":"messageCommand.js","mappings":"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","names":[],"sourceRoot":"","sources":["../../../src/commands/messageCommand.ts"],"version":3}

package/build/src/kmc.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{},n=(new Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6669e390-dd00-5dae-a180-6fe9ca8ae7ec")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{},n=(new Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4542efb2-9630-55a9-800d-24e26362ae86")}catch(e){}}();
 /**
  * kmc - Keyman Next Generation Compiler
  */
@@ -10,6 +10,7 @@ import { KeymanSentry, loadOptions } from '@keymanapp/developer-utils';
 import KEYMAN_VERSION from "@keymanapp/keyman-version";
 import { TestKeymanSentry } from './util/TestKeymanSentry.js';
 import { exitProcess } from './util/sysexits.js';
+import { declareMessage } from './commands/messageCommand.js';
 await TestKeymanSentry.runTestIfCLRequested();
 if (KeymanSentry.isEnabled()) {
     KeymanSentry.init();
@@ -41,6 +42,7 @@ async function run() {
         .addOption(new Option('--error-reporting', 'Enable error reporting to keyman.com (overriding user settings)'));
     declareBuild(program);
     declareAnalyze(program);
+    declareMessage(program);
     /* Future commands:
     declareClean(program);
     declareCopy(program);
@@ -53,5 +55,5 @@ async function run() {
     await program.parseAsync(process.argv)
         .catch(reason => console.error(reason));
 }
-//# debugId=6669e390-dd00-5dae-a180-6fe9ca8ae7ec
+//# debugId=4542efb2-9630-55a9-800d-24e26362ae86
 //# sourceMappingURL=kmc.js.map

package/build/src/kmc.js.map

@@ -1 +1 @@
-{"debug_id":"6669e390-dd00-5dae-a180-6fe9ca8ae7ec","file":"kmc.js","mappings":";;AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,cAAc,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,gBAAgB,CAAC,oBAAoB,EAAE,CAAC;AAC9C,IAAG,YAAY,CAAC,SAAS,EAAE,EAAE;IAC3B,YAAY,CAAC,IAAI,EAAE,CAAC;CACrB;AACD,IAAI;IACF,MAAM,GAAG,EAAE,CAAC;CACb;AAAC,OAAM,CAAC,EAAE;IACT,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAClC;AAED,gFAAgF;AAChF,8EAA8E;AAC9E,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;AAErB,KAAK,UAAU,GAAG;IAChB,MAAM,WAAW,EAAE,CAAC;IAEpB,eAAe;IAEf,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,WAAW,CAAC,yCAAyC,CAAC;SACtD,aAAa,CAAC;QACb,iBAAiB,EAAE,IAAI;KACxB,CAAC;SACD,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;QAEzC,oEAAoE;QACpE,4EAA4E;QAC5E,0EAA0E;QAC1E,YAAY;SACX,SAAS,CAAC,IAAI,MAAM,CAAC,sBAAsB,EAAE,kEAAkE,CAAC,CAAC;SACjH,SAAS,CAAC,IAAI,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC,CAAC,CAAC;IAEjH,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,OAAO,CAAC,CAAC;IAExB;;;;;;;;MAQE;IAEF,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;SACnC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC","names":[],"sourceRoot":"","sources":["../../src/kmc.ts"],"version":3}
+{"debug_id":"4542efb2-9630-55a9-800d-24e26362ae86","file":"kmc.js","mappings":";;AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,cAAc,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,gBAAgB,CAAC,oBAAoB,EAAE,CAAC;AAC9C,IAAG,YAAY,CAAC,SAAS,EAAE,EAAE;IAC3B,YAAY,CAAC,IAAI,EAAE,CAAC;CACrB;AACD,IAAI;IACF,MAAM,GAAG,EAAE,CAAC;CACb;AAAC,OAAM,CAAC,EAAE;IACT,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAClC;AAED,gFAAgF;AAChF,8EAA8E;AAC9E,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;AAErB,KAAK,UAAU,GAAG;IAChB,MAAM,WAAW,EAAE,CAAC;IAEpB,eAAe;IAEf,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,WAAW,CAAC,yCAAyC,CAAC;SACtD,aAAa,CAAC;QACb,iBAAiB,EAAE,IAAI;KACxB,CAAC;SACD,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;QAEzC,oEAAoE;QACpE,4EAA4E;QAC5E,0EAA0E;QAC1E,YAAY;SACX,SAAS,CAAC,IAAI,MAAM,CAAC,sBAAsB,EAAE,kEAAkE,CAAC,CAAC;SACjH,SAAS,CAAC,IAAI,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC,CAAC,CAAC;IAEjH,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,cAAc,CAAC,OAAO,CAAC,CAAC;IAExB;;;;;;;;MAQE;IAEF,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;SACnC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC","names":[],"sourceRoot":"","sources":["../../src/kmc.ts"],"version":3}

package/build/src/messages/infrastructureMessages.d.ts

@@ -1,8 +1,9 @@
 export declare class InfrastructureMessages {
+    static FATAL_UnexpectedException: number;
     static Fatal_UnexpectedException: (o: {
         e: any;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static FATAL_UnexpectedException: number;
+    static INFO_BuildingFile: number;
     static Info_BuildingFile: (o: {
         filename: string;
         relativeFilename: string;
@@ -11,20 +12,21 @@ export declare class InfrastructureMessages {
         line?: number;
         code: number;
         message: string;
+        detail?: string;
         exceptionVar?: any;
     };
-    static INFO_BuildingFile: number;
+    static ERROR_FileDoesNotExist: number;
     static Error_FileDoesNotExist: (o: {
         filename: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_FileDoesNotExist: number;
+    static ERROR_FileTypeNotRecognized: number;
     static Error_FileTypeNotRecognized: (o: {
         filename: string;
         extensions: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_FileTypeNotRecognized: number;
-    static Error_OutFileNotValidForProjects: () => import("@keymanapp/common-types").CompilerEvent;
     static ERROR_OutFileNotValidForProjects: number;
+    static Error_OutFileNotValidForProjects: () => import("@keymanapp/common-types").CompilerEvent;
+    static INFO_FileBuiltSuccessfully: number;
     static Info_FileBuiltSuccessfully: (o: {
         filename: string;
         relativeFilename: string;
@@ -33,9 +35,10 @@ export declare class InfrastructureMessages {
         line?: number;
         code: number;
         message: string;
+        detail?: string;
         exceptionVar?: any;
     };
-    static INFO_FileBuiltSuccessfully: number;
+    static INFO_FileNotBuiltSuccessfully: number;
     static Info_FileNotBuiltSuccessfully: (o: {
         filename: string;
         relativeFilename: string;
@@ -44,22 +47,23 @@ export declare class InfrastructureMessages {
         line?: number;
         code: number;
         message: string;
+        detail?: string;
         exceptionVar?: any;
     };
-    static INFO_FileNotBuiltSuccessfully: number;
+    static ERROR_InvalidProjectFile: number;
     static Error_InvalidProjectFile: (o: {
         message: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_InvalidProjectFile: number;
+    static HINT_FilenameHasDifferingCase: number;
     static Hint_FilenameHasDifferingCase: (o: {
         reference: string;
         filename: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static HINT_FilenameHasDifferingCase: number;
+    static ERROR_UnknownFileFormat: number;
     static Error_UnknownFileFormat: (o: {
         format: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_UnknownFileFormat: number;
+    static INFO_ProjectBuiltSuccessfully: number;
     static Info_ProjectBuiltSuccessfully: (o: {
         filename: string;
         relativeFilename: string;
@@ -68,9 +72,10 @@ export declare class InfrastructureMessages {
         line?: number;
         code: number;
         message: string;
+        detail?: string;
         exceptionVar?: any;
     };
-    static INFO_ProjectBuiltSuccessfully: number;
+    static INFO_ProjectNotBuiltSuccessfully: number;
     static Info_ProjectNotBuiltSuccessfully: (o: {
         filename: string;
         relativeFilename: string;
@@ -79,55 +84,69 @@ export declare class InfrastructureMessages {
         line?: number;
         code: number;
         message: string;
+        detail?: string;
         exceptionVar?: any;
     };
-    static INFO_ProjectNotBuiltSuccessfully: number;
+    static INFO_TooManyMessages: number;
     static Info_TooManyMessages: (o: {
         count: number;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static INFO_TooManyMessages: number;
+    static ERROR_FileTypeNotFound: number;
     static Error_FileTypeNotFound: (o: {
         ext: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_FileTypeNotFound: number;
+    static ERROR_NotAProjectFile: number;
     static Error_NotAProjectFile: (o: {
         filename: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_NotAProjectFile: number;
-    static Info_WarningsHaveFailedBuild: () => import("@keymanapp/common-types").CompilerEvent;
     static INFO_WarningsHaveFailedBuild: number;
+    static Info_WarningsHaveFailedBuild: () => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_CannotCreateFolder: number;
     static Error_CannotCreateFolder: (o: {
         folderName: string;
         e: any;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_CannotCreateFolder: number;
+    static ERROR_InvalidProjectFolder: number;
     static Error_InvalidProjectFolder: (o: {
         folderName: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_InvalidProjectFolder: number;
+    static ERROR_UnsupportedProjectVersion: number;
     static Error_UnsupportedProjectVersion: (o: {
         version: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_UnsupportedProjectVersion: number;
-    static Hint_ProjectIsVersion10: () => import("@keymanapp/common-types").CompilerEvent;
     static HINT_ProjectIsVersion10: number;
-    static Error_OutFileCanOnlyBeSpecifiedWithSingleInfile: () => import("@keymanapp/common-types").CompilerEvent;
+    static Hint_ProjectIsVersion10: () => import("@keymanapp/common-types").CompilerEvent;
     static ERROR_OutFileCanOnlyBeSpecifiedWithSingleInfile: number;
+    static Error_OutFileCanOnlyBeSpecifiedWithSingleInfile: () => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_InvalidMessageFormat: number;
     static Error_InvalidMessageFormat: (o: {
         message: string;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_InvalidMessageFormat: number;
+    static ERROR_MessageNamespaceNotFound: number;
     static Error_MessageNamespaceNotFound: (o: {
         code: number;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_MessageNamespaceNotFound: number;
+    static ERROR_MessageCodeNotFound: number;
     static Error_MessageCodeNotFound: (o: {
         code: number;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_MessageCodeNotFound: number;
+    static ERROR_MessageCannotBeCoerced: number;
     static Error_MessageCannotBeCoerced: (o: {
         code: number;
     }) => import("@keymanapp/common-types").CompilerEvent;
-    static ERROR_MessageCannotBeCoerced: number;
+    static ERROR_UnrecognizedMessageCode: number;
+    static Error_UnrecognizedMessageCode: (o: {
+        message: string;
+    }) => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_MustSpecifyMessageCode: number;
+    static Error_MustSpecifyMessageCode: () => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_MessagesCannotBeFilteredForMarkdownFormat: number;
+    static Error_MessagesCannotBeFilteredForMarkdownFormat: () => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_OutputPathMustBeSpecifiedForMarkdownFormat: number;
+    static Error_OutputPathMustBeSpecifiedForMarkdownFormat: () => import("@keymanapp/common-types").CompilerEvent;
+    static ERROR_OutputPathMustExistAndBeADirectory: number;
+    static Error_OutputPathMustExistAndBeADirectory: (o: {
+        outPath: string;
+    }) => import("@keymanapp/common-types").CompilerEvent;
 }
 //# sourceMappingURL=infrastructureMessages.d.ts.map

package/build/src/messages/infrastructureMessages.d.ts.map

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

package/build/src/messages/infrastructureMessages.js

@@ -1,5 +1,5 @@
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{},n=(new Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e85b7300-d78d-5300-8e63-8876894a08c2")}catch(e){}}();
-import { CompilerErrorNamespace, CompilerErrorSeverity, CompilerMessageSpec as m } from "@keymanapp/common-types";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{},n=(new Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="20670923-6d88-5a0c-97aa-d77f25852eee")}catch(e){}}();
+import { CompilerError, CompilerErrorNamespace, CompilerErrorSeverity, CompilerMessageSpec as m, CompilerMessageDef as def, CompilerMessageSpecWithException } from "@keymanapp/common-types";
 const Namespace = CompilerErrorNamespace.Infrastructure;
 const SevInfo = CompilerErrorSeverity.Info | Namespace;
 const SevHint = CompilerErrorSeverity.Hint | Namespace;
@@ -7,61 +7,71 @@ const SevHint = CompilerErrorSeverity.Hint | Namespace;
 const SevError = CompilerErrorSeverity.Error | Namespace;
 const SevFatal = CompilerErrorSeverity.Fatal | Namespace;
 export class InfrastructureMessages {
-    static Fatal_UnexpectedException = (o) => m(this.FATAL_UnexpectedException, null, o.e ?? 'unknown error');
     static FATAL_UnexpectedException = SevFatal | 0x0001;
+    static Fatal_UnexpectedException = (o) => CompilerMessageSpecWithException(this.FATAL_UnexpectedException, null, o.e ?? 'unknown error');
     // For this message, we override the filename with the passed-in file. A bit of a hack but does the job
-    static Info_BuildingFile = (o) => ({ filename: o.filename, ...m(this.INFO_BuildingFile, `Building ${o.relativeFilename}`) });
     static INFO_BuildingFile = SevInfo | 0x0002;
-    static Error_FileDoesNotExist = (o) => m(this.ERROR_FileDoesNotExist, `File ${o.filename} does not exist`);
+    static Info_BuildingFile = (o) => ({ filename: o.filename, ...m(this.INFO_BuildingFile, `Building ${def(o.relativeFilename)}`) });
     static ERROR_FileDoesNotExist = SevError | 0x0003;
-    static Error_FileTypeNotRecognized = (o) => m(this.ERROR_FileTypeNotRecognized, `Unrecognised input file ${o.filename}, expecting ${o.extensions}, or project folder`);
+    static Error_FileDoesNotExist = (o) => m(this.ERROR_FileDoesNotExist, `File ${def(o.filename)} does not exist`);
     static ERROR_FileTypeNotRecognized = SevError | 0x0004;
-    static Error_OutFileNotValidForProjects = () => m(this.ERROR_OutFileNotValidForProjects, `--out-file should not be specified for project builds`);
+    static Error_FileTypeNotRecognized = (o) => m(this.ERROR_FileTypeNotRecognized, `Unrecognised input file ${def(o.filename)}, expecting ${def(o.extensions)}, or project folder`);
     static ERROR_OutFileNotValidForProjects = SevError | 0x0005;
+    static Error_OutFileNotValidForProjects = () => m(this.ERROR_OutFileNotValidForProjects, `--out-file should not be specified for project builds`);
     // For this message, we override the filename with the passed-in file. A bit of a hack but does the job
-    static Info_FileBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_FileBuiltSuccessfully, `${o.relativeFilename} built successfully.`) });
     static INFO_FileBuiltSuccessfully = SevInfo | 0x0006;
+    static Info_FileBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_FileBuiltSuccessfully, `${def(o.relativeFilename)} built successfully.`) });
     // For this message, we override the filename with the passed-in file. A bit of a hack but does the job
-    static Info_FileNotBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_FileNotBuiltSuccessfully, `${o.relativeFilename} failed to build.`) });
     static INFO_FileNotBuiltSuccessfully = SevInfo | 0x0007;
-    static Error_InvalidProjectFile = (o) => m(this.ERROR_InvalidProjectFile, `Project file is not valid: ${o.message}`);
+    static Info_FileNotBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_FileNotBuiltSuccessfully, `${def(o.relativeFilename)} failed to build.`) });
     static ERROR_InvalidProjectFile = SevError | 0x0008;
-    static Hint_FilenameHasDifferingCase = (o) => m(this.HINT_FilenameHasDifferingCase, `File on disk '${o.filename}' does not match case of '${o.reference}' in source file; this is an error on platforms with case-sensitive filesystems.`);
+    static Error_InvalidProjectFile = (o) => m(this.ERROR_InvalidProjectFile, `Project file is not valid: ${def(o.message)}`);
     static HINT_FilenameHasDifferingCase = SevHint | 0x0009;
-    static Error_UnknownFileFormat = (o) => m(this.ERROR_UnknownFileFormat, `Unknown file format ${o.format}; only Markdown (.md), JSON (.json), and Text (.txt) are supported.`);
+    static Hint_FilenameHasDifferingCase = (o) => m(this.HINT_FilenameHasDifferingCase, `File on disk '${def(o.filename)}' does not match case of '${def(o.reference)}' in source file; this is an error on platforms with case-sensitive filesystems.`);
     static ERROR_UnknownFileFormat = SevError | 0x000A;
+    static Error_UnknownFileFormat = (o) => m(this.ERROR_UnknownFileFormat, `Unknown file format ${def(o.format)}; only Markdown (.md), JSON (.json), and Text (.txt) are supported.`);
     // For this message, we override the filename with the passed-in file. A bit of a hack but does the job
-    static Info_ProjectBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_ProjectBuiltSuccessfully, `Project ${o.relativeFilename} built successfully.`) });
     static INFO_ProjectBuiltSuccessfully = SevInfo | 0x000B;
+    static Info_ProjectBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_ProjectBuiltSuccessfully, `Project ${def(o.relativeFilename)} built successfully.`) });
     // For this message, we override the filename with the passed-in file. A bit of a hack but does the job
-    static Info_ProjectNotBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_ProjectNotBuiltSuccessfully, `Project ${o.relativeFilename} failed to build.`) });
     static INFO_ProjectNotBuiltSuccessfully = SevInfo | 0x000C;
-    static Info_TooManyMessages = (o) => m(this.INFO_TooManyMessages, `More than ${o.count} warnings or errors received; suppressing further messages.`);
+    static Info_ProjectNotBuiltSuccessfully = (o) => ({ filename: o.filename, ...m(this.INFO_ProjectNotBuiltSuccessfully, `Project ${def(o.relativeFilename)} failed to build.`) });
     static INFO_TooManyMessages = SevInfo | 0x000D;
-    static Error_FileTypeNotFound = (o) => m(this.ERROR_FileTypeNotFound, `A file of type ${o.ext} was not found in the project.`);
+    static Info_TooManyMessages = (o) => m(this.INFO_TooManyMessages, `More than ${def(o.count)} warnings or errors received; suppressing further messages.`);
     static ERROR_FileTypeNotFound = SevError | 0x000E;
-    static Error_NotAProjectFile = (o) => m(this.ERROR_NotAProjectFile, `File ${o.filename} must have a .kpj extension to be treated as a project.`);
+    static Error_FileTypeNotFound = (o) => m(this.ERROR_FileTypeNotFound, `A file of type ${def(o.ext)} was not found in the project.`);
     static ERROR_NotAProjectFile = SevError | 0x000F;
-    static Info_WarningsHaveFailedBuild = () => m(this.INFO_WarningsHaveFailedBuild, `The build failed because option "treat warnings as errors" is enabled and there are one or more warnings.`);
+    static Error_NotAProjectFile = (o) => m(this.ERROR_NotAProjectFile, `File ${def(o.filename)} must have a .kpj extension to be treated as a project.`);
     static INFO_WarningsHaveFailedBuild = SevInfo | 0x0010;
-    static Error_CannotCreateFolder = (o) => m(this.ERROR_CannotCreateFolder, null, `Unable to create folder ${o.folderName}: ${o.e ?? 'unknown error'}`);
+    static Info_WarningsHaveFailedBuild = () => m(this.INFO_WarningsHaveFailedBuild, `The build failed because option "treat warnings as errors" is enabled and there are one or more warnings.`);
     static ERROR_CannotCreateFolder = SevError | 0x0011;
-    static Error_InvalidProjectFolder = (o) => m(this.ERROR_InvalidProjectFolder, `The folder ${o.folderName} does not appear to be a Keyman Developer project.`);
+    static Error_CannotCreateFolder = (o) => CompilerMessageSpecWithException(this.ERROR_CannotCreateFolder, null, `Unable to create folder ${def(o.folderName)}: ${o.e ?? 'unknown error'}`);
     static ERROR_InvalidProjectFolder = SevError | 0x0012;
-    static Error_UnsupportedProjectVersion = (o) => m(this.ERROR_UnsupportedProjectVersion, `Project version ${o.version} is not supported by this version of Keyman Developer.`);
+    static Error_InvalidProjectFolder = (o) => m(this.ERROR_InvalidProjectFolder, `The folder ${def(o.folderName)} does not appear to be a Keyman Developer project.`);
     static ERROR_UnsupportedProjectVersion = SevError | 0x0013;
-    static Hint_ProjectIsVersion10 = () => m(this.HINT_ProjectIsVersion10, `The project file is an older version and can be upgraded to version 17.0`);
+    static Error_UnsupportedProjectVersion = (o) => m(this.ERROR_UnsupportedProjectVersion, `Project version ${def(o.version)} is not supported by this version of Keyman Developer.`);
     static HINT_ProjectIsVersion10 = SevHint | 0x0014;
-    static Error_OutFileCanOnlyBeSpecifiedWithSingleInfile = () => m(this.ERROR_OutFileCanOnlyBeSpecifiedWithSingleInfile, `Parameter --out-file can only be used with a single input file.`);
+    static Hint_ProjectIsVersion10 = () => m(this.HINT_ProjectIsVersion10, `The project file is an older version and can be upgraded to version 17.0`);
     static ERROR_OutFileCanOnlyBeSpecifiedWithSingleInfile = SevError | 0x0015;
-    static Error_InvalidMessageFormat = (o) => m(this.ERROR_InvalidMessageFormat, `Invalid parameter: --message ${o.message} must match format '[KM]#####[:Disable|Info|Hint|Warn|Error]'`);
+    static Error_OutFileCanOnlyBeSpecifiedWithSingleInfile = () => m(this.ERROR_OutFileCanOnlyBeSpecifiedWithSingleInfile, `Parameter --out-file can only be used with a single input file.`);
     static ERROR_InvalidMessageFormat = SevError | 0x0016;
-    static Error_MessageNamespaceNotFound = (o) => m(this.ERROR_MessageNamespaceNotFound, `Invalid parameter: --message KM${o.code?.toString(16)} does not have a recognized namespace`);
+    static Error_InvalidMessageFormat = (o) => m(this.ERROR_InvalidMessageFormat, `Invalid parameter: --message ${def(o.message)} must match format '[KM]#####[:Disable|Info|Hint|Warn|Error]'`);
     static ERROR_MessageNamespaceNotFound = SevError | 0x0017;
-    static Error_MessageCodeNotFound = (o) => m(this.ERROR_MessageCodeNotFound, `Invalid parameter: --message KM${o.code?.toString(16)} is not a recognized code`);
+    static Error_MessageNamespaceNotFound = (o) => m(this.ERROR_MessageNamespaceNotFound, `Invalid parameter: --message ${def(o.code ? CompilerError.formatCode(o.code) : undefined)} does not have a recognized namespace`);
     static ERROR_MessageCodeNotFound = SevError | 0x0018;
-    static Error_MessageCannotBeCoerced = (o) => m(this.ERROR_MessageCannotBeCoerced, `Invalid parameter: --message KM${o.code?.toString(16)} is not a info, hint or warn message type and cannot be coerced`);
+    static Error_MessageCodeNotFound = (o) => m(this.ERROR_MessageCodeNotFound, `Invalid parameter: --message ${o.code ? CompilerError.formatCode(o.code) : undefined} is not a recognized code`);
     static ERROR_MessageCannotBeCoerced = SevError | 0x0019;
+    static Error_MessageCannotBeCoerced = (o) => m(this.ERROR_MessageCannotBeCoerced, `Invalid parameter: --message ${def(o.code ? CompilerError.formatCode(o.code) : undefined)} is not of type 'info', 'hint' or 'warn', and cannot be coerced`);
+    static ERROR_UnrecognizedMessageCode = SevError | 0x001a;
+    static Error_UnrecognizedMessageCode = (o) => m(this.ERROR_UnrecognizedMessageCode, `Invalid parameter: message identifier '${def(o.message)}' must match format '[KM]#####'`);
+    static ERROR_MustSpecifyMessageCode = SevError | 0x001b;
+    static Error_MustSpecifyMessageCode = () => m(this.ERROR_MustSpecifyMessageCode, `Must specify at least one message code or -a for all messages`);
+    static ERROR_MessagesCannotBeFilteredForMarkdownFormat = SevError | 0x001c;
+    static Error_MessagesCannotBeFilteredForMarkdownFormat = () => m(this.ERROR_MessagesCannotBeFilteredForMarkdownFormat, `Messages cannot be filtered for markdown format`);
+    static ERROR_OutputPathMustBeSpecifiedForMarkdownFormat = SevError | 0x001d;
+    static Error_OutputPathMustBeSpecifiedForMarkdownFormat = () => m(this.ERROR_OutputPathMustBeSpecifiedForMarkdownFormat, `Output path must be specified with -o for markdown output format`);
+    static ERROR_OutputPathMustExistAndBeADirectory = SevError | 0x001e;
+    static Error_OutputPathMustExistAndBeADirectory = (o) => m(this.ERROR_OutputPathMustExistAndBeADirectory, `Output path ${def(o.outPath)} must exist and must be a folder`);
 }
-//# debugId=e85b7300-d78d-5300-8e63-8876894a08c2
+//# debugId=20670923-6d88-5a0c-97aa-d77f25852eee
 //# sourceMappingURL=infrastructureMessages.js.map